module Prostore::Types

Overview

Portable type taxonomy (ADR-0014).

Each Crystal type used in a field declaration maps to one of these portable tags. The adapter layer translates a tag plus a nullable flag into backend-specific column DDL.

Coerced types (UUID, BigDecimal, JSON::Any, Array(T)) move through crystal-db as String values regardless of backend, with conversion at the model boundary (see __prostore_load_from_rs and save). This keeps the runtime IO surface uniform — only the column DDL differs per backend (UUID on PG, TEXT on SQLite, etc.).

Defined in:

prostore/types.cr

Constant Summary

COERCED = ["uuid", "decimal", "json"]

Coerced portable types — values that need conversion to/from String at the model boundary. The adapter still uses native column types for these (NUMERIC for decimal on PG, etc.); the wire format is just String.

ENUM_TAGS = ["enum_string", "enum_int"]

Enum portable tags (ADR-0016). Enum values move through the wire as String (member name) or Int64 (underlying integer); the model boundary reconstructs the Crystal enum via EnumClass.parse / EnumClass.from_value.

PORTABLE = {"Int32" => "int32", "Int64" => "int64", "Float32" => "float32", "Float64" => "float64", "String" => "string", "Bool" => "bool", "Time" => "time", "Bytes" => "bytes", "Slice(UInt8)" => "bytes", "UUID" => "uuid", "BigDecimal" => "decimal", "JSON::Any" => "json"}

Primitive types whose Crystal representation is the same as crystal-db accepts directly. Values are passed through to the driver verbatim.

Class Method Summary

• .array?(portable_type : String) : Bool
• .array_inner(portable_type : String) : String

  Inner portable type of an array tag.

• .coerced?(portable_type : String) : Bool
• .enum?(portable_type : String) : Bool

Class Method Detail