litedbmodel 2.2.7 → 2.2.8

package/docs/api/interfaces/Column.md

@@ -1,4 +1,4 @@
-[**litedbmodel v2.2.7**](../README.md)
+[**litedbmodel v2.2.8**](../README.md)
 
 ***
 
@@ -6,7 +6,7 @@
 
 # Interface: Column()\<ValueType, ModelType\>
 
-Defined in: [Column.ts:144](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L144)
+Defined in: [Column.ts:145](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L145)
 
 Type-safe column reference as a callable function.
 
@@ -21,7 +21,7 @@ Type-safe column reference as a callable function.
 Column(): string;
 ```
 
-Defined in: [Column.ts:146](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L146)
+Defined in: [Column.ts:147](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L147)
 
 Call to get column name as string (for computed property keys)
 
@@ -33,13 +33,14 @@ Call to get column name as string (for computed property keys)
 
 | Property | Modifier | Type | Description | Defined in |
 | ------ | ------ | ------ | ------ | ------ |
-| <a id="columnname"></a> `columnName` | `readonly` | `string` | The database column name | [Column.ts:149](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L149) |
-| <a id="propertyname"></a> `propertyName` | `readonly` | `string` | The property name on the model class (may differ from columnName) | [Column.ts:152](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L152) |
-| <a id="tablename"></a> `tableName` | `readonly` | `string` | The database table name | [Column.ts:155](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L155) |
-| <a id="modelname"></a> `modelName` | `readonly` | `string` | The model class name (for debugging and static analysis) | [Column.ts:158](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L158) |
-| <a id="_brand"></a> `_brand` | `readonly` | `"Column"` | Brand for type discrimination - enables static analysis to distinguish from regular variables | [Column.ts:161](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L161) |
-| <a id="sqlcast"></a> `sqlCast?` | `readonly` | `string` | SQL type for automatic casting in conditions (e.g., 'uuid') | [Column.ts:164](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L164) |
-| <a id="__model"></a> `__model?` | `readonly` | `ModelType` | Phantom type for model association (compile-time only, not used at runtime) | [Column.ts:167](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L167) |
+| <a id="columnname"></a> `columnName` | `readonly` | `string` | The database column name | [Column.ts:150](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L150) |
+| <a id="propertyname"></a> `propertyName` | `readonly` | `string` | The property name on the model class (may differ from columnName) | [Column.ts:153](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L153) |
+| <a id="tablename"></a> `tableName` | `readonly` | `string` | The database table name | [Column.ts:156](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L156) |
+| <a id="modelname"></a> `modelName` | `readonly` | `string` | The model class name (for debugging and static analysis) | [Column.ts:159](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L159) |
+| <a id="_brand"></a> `_brand` | `readonly` | `"Column"` | Brand for type discrimination - enables static analysis to distinguish from regular variables | [Column.ts:162](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L162) |
+| <a id="sqlcast"></a> `sqlCast?` | `readonly` | `string` | SQL type for automatic casting in conditions (e.g., 'uuid') | [Column.ts:165](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L165) |
+| <a id="serialize"></a> `serialize?` | `readonly` | (`value`: `unknown`, `typeCast?`: `DriverTypeCast`) => `unknown` | The column family's serializer: a condition value binds exactly as a written value does | [Column.ts:168](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L168) |
+| <a id="__model"></a> `__model?` | `readonly` | `ModelType` | Phantom type for model association (compile-time only, not used at runtime) | [Column.ts:171](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L171) |
 
 ## Methods
 
@@ -49,7 +50,7 @@ Call to get column name as string (for computed property keys)
 eq(value: ValueType): Record<string, ValueType | DBCast>;
 ```
 
-Defined in: [Column.ts:177](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L177)
+Defined in: [Column.ts:181](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L181)
 
 Equal condition (column = value)
 
@@ -77,7 +78,7 @@ User.id.eq(1) → { id: 1 }
 ne(value: ValueType): Record<string, ValueType | DBCast>;
 ```
 
-Defined in: [Column.ts:183](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L183)
+Defined in: [Column.ts:187](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L187)
 
 Not equal condition (column != value)
 
@@ -105,7 +106,7 @@ User.status.ne('deleted') → { 'status != ?': 'deleted' }
 gt(value: ValueType): Record<string, ValueType | DBCast>;
 ```
 
-Defined in: [Column.ts:189](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L189)
+Defined in: [Column.ts:193](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L193)
 
 Greater than condition (column > value)
 
@@ -133,7 +134,7 @@ User.age.gt(18) → { 'age > ?': 18 }
 gte(value: ValueType): Record<string, ValueType | DBCast>;
 ```
 
-Defined in: [Column.ts:195](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L195)
+Defined in: [Column.ts:199](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L199)
 
 Greater than or equal condition (column >= value)
 
@@ -161,7 +162,7 @@ User.age.gte(18) → { 'age >= ?': 18 }
 lt(value: ValueType): Record<string, ValueType | DBCast>;
 ```
 
-Defined in: [Column.ts:201](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L201)
+Defined in: [Column.ts:205](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L205)
 
 Less than condition (column < value)
 
@@ -189,7 +190,7 @@ User.age.lt(65) → { 'age < ?': 65 }
 lte(value: ValueType): Record<string, ValueType | DBCast>;
 ```
 
-Defined in: [Column.ts:207](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L207)
+Defined in: [Column.ts:211](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L211)
 
 Less than or equal condition (column <= value)
 
@@ -217,7 +218,7 @@ User.age.lte(65) → { 'age <= ?': 65 }
 like(pattern: string): Record<string, string>;
 ```
 
-Defined in: [Column.ts:213](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L213)
+Defined in: [Column.ts:217](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L217)
 
 LIKE condition (column LIKE pattern)
 
@@ -245,7 +246,7 @@ User.name.like('%test%') → { 'name LIKE ?': '%test%' }
 notLike(pattern: string): Record<string, string>;
 ```
 
-Defined in: [Column.ts:219](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L219)
+Defined in: [Column.ts:223](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L223)
 
 NOT LIKE condition (column NOT LIKE pattern)
 
@@ -273,7 +274,7 @@ User.name.notLike('%test%') → { 'name NOT LIKE ?': '%test%' }
 ilike(pattern: string): Record<string, string>;
 ```
 
-Defined in: [Column.ts:225](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L225)
+Defined in: [Column.ts:229](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L229)
 
 ILIKE condition (case-insensitive LIKE, PostgreSQL specific)
 
@@ -301,7 +302,7 @@ User.name.ilike('%TEST%') → { 'name ILIKE ?': '%TEST%' }
 between(from: ValueType, to: ValueType): Record<string, [ValueType, ValueType]>;
 ```
 
-Defined in: [Column.ts:231](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L231)
+Defined in: [Column.ts:235](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L235)
 
 BETWEEN condition (column BETWEEN from AND to)
 
@@ -330,7 +331,7 @@ User.age.between(18, 65) → { 'age BETWEEN ? AND ?': [18, 65] }
 in(values: ValueType[]): Record<string, ValueType[] | DBCastArray>;
 ```
 
-Defined in: [Column.ts:238](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L238)
+Defined in: [Column.ts:242](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L242)
 
 IN condition (column IN (values))
 Note: Arrays are automatically converted to IN clause by litedbmodel
@@ -359,7 +360,7 @@ User.status.in(['active', 'pending']) → { status: ['active', 'pending'] }
 notIn(values: ValueType[]): Record<string, ValueType[] | DBCastArray>;
 ```
 
-Defined in: [Column.ts:244](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L244)
+Defined in: [Column.ts:248](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L248)
 
 NOT IN condition (column NOT IN (values))
 
@@ -387,7 +388,7 @@ User.status.notIn(['deleted', 'banned'])
 isNull(): Record<string, null>;
 ```
 
-Defined in: [Column.ts:250](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L250)
+Defined in: [Column.ts:254](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L254)
 
 IS NULL condition
 
@@ -409,7 +410,7 @@ User.deleted_at.isNull() → { deleted_at: null }
 isNotNull(): Record<string, DBNotNullValue>;
 ```
 
-Defined in: [Column.ts:256](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L256)
+Defined in: [Column.ts:260](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L260)
 
 IS NOT NULL condition
 
@@ -431,7 +432,7 @@ User.email.isNotNull() → { email: DBNotNullValue }
 asc(): OrderColumn<ModelType>;
 ```
 
-Defined in: [Column.ts:266](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L266)
+Defined in: [Column.ts:270](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L270)
 
 Ascending order
 
@@ -453,7 +454,7 @@ User.created_at.asc() → OrderColumn('created_at', 'ASC')
 desc(): OrderColumn<ModelType>;
 ```
 
-Defined in: [Column.ts:272](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L272)
+Defined in: [Column.ts:276](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L276)
 
 Descending order
 
@@ -475,7 +476,7 @@ User.created_at.desc() → OrderColumn('created_at', 'DESC')
 ascNullsFirst(): OrderColumn<ModelType>;
 ```
 
-Defined in: [Column.ts:278](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L278)
+Defined in: [Column.ts:282](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L282)
 
 Ascending order with NULLS FIRST
 
@@ -497,7 +498,7 @@ User.updated_at.ascNullsFirst() → OrderColumn with NULLS FIRST
 ascNullsLast(): OrderColumn<ModelType>;
 ```
 
-Defined in: [Column.ts:284](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L284)
+Defined in: [Column.ts:288](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L288)
 
 Ascending order with NULLS LAST
 
@@ -519,7 +520,7 @@ User.updated_at.ascNullsLast() → OrderColumn with NULLS LAST
 descNullsFirst(): OrderColumn<ModelType>;
 ```
 
-Defined in: [Column.ts:290](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L290)
+Defined in: [Column.ts:294](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L294)
 
 Descending order with NULLS FIRST
 
@@ -541,7 +542,7 @@ User.updated_at.descNullsFirst() → OrderColumn with NULLS FIRST
 descNullsLast(): OrderColumn<ModelType>;
 ```
 
-Defined in: [Column.ts:296](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L296)
+Defined in: [Column.ts:300](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L300)
 
 Descending order with NULLS LAST
 
@@ -563,7 +564,7 @@ User.updated_at.descNullsLast() → OrderColumn with NULLS LAST
 toString(): string;
 ```
 
-Defined in: [Column.ts:306](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L306)
+Defined in: [Column.ts:310](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L310)
 
 Returns column name (for template literals)
 

package/docs/api/interfaces/ColumnDecorator.md

@@ -1,4 +1,4 @@
-[**litedbmodel v2.2.7**](../README.md)
+[**litedbmodel v2.2.8**](../README.md)
 
 ***
 

package/docs/api/interfaces/ColumnOptions.md

@@ -1,4 +1,4 @@
-[**litedbmodel v2.2.7**](../README.md)
+[**litedbmodel v2.2.8**](../README.md)
 
 ***
 

package/docs/api/interfaces/CreatedMiddlewareClass.md

@@ -1,4 +1,4 @@
-[**litedbmodel v2.2.7**](../README.md)
+[**litedbmodel v2.2.8**](../README.md)
 
 ***
 

package/docs/api/interfaces/DBConfig.md

@@ -1,4 +1,4 @@
-[**litedbmodel v2.2.7**](../README.md)
+[**litedbmodel v2.2.8**](../README.md)
 
 ***
 

package/docs/api/interfaces/DBConfigOptions.md

@@ -1,4 +1,4 @@
-[**litedbmodel v2.2.7**](../README.md)
+[**litedbmodel v2.2.8**](../README.md)
 
 ***
 

package/docs/api/interfaces/DeleteOptions.md

@@ -1,4 +1,4 @@
-[**litedbmodel v2.2.7**](../README.md)
+[**litedbmodel v2.2.8**](../README.md)
 
 ***
 

package/docs/api/interfaces/InsertOptions.md

@@ -1,4 +1,4 @@
-[**litedbmodel v2.2.7**](../README.md)
+[**litedbmodel v2.2.8**](../README.md)
 
 ***
 

package/docs/api/interfaces/LimitConfig.md

@@ -1,4 +1,4 @@
-[**litedbmodel v2.2.7**](../README.md)
+[**litedbmodel v2.2.8**](../README.md)
 
 ***
 

package/docs/api/interfaces/MiddlewareConfig.md

@@ -1,4 +1,4 @@
-[**litedbmodel v2.2.7**](../README.md)
+[**litedbmodel v2.2.8**](../README.md)
 
 ***
 

package/docs/api/interfaces/ModelClassDecorator.md

@@ -1,4 +1,4 @@
-[**litedbmodel v2.2.7**](../README.md)
+[**litedbmodel v2.2.8**](../README.md)
 
 ***
 
@@ -6,7 +6,7 @@
 
 # Interface: ModelClassDecorator()
 
-Defined in: [decorators.ts:1125](https://github.com/foo-ogawa/litedbmodel/blob/main/src/decorators.ts#L1125)
+Defined in: [decorators.ts:1143](https://github.com/foo-ogawa/litedbmodel/blob/main/src/decorators.ts#L1143)
 
 A class decorator that works under both protocols.
 
@@ -16,7 +16,7 @@ A class decorator that works under both protocols.
 ModelClassDecorator<T>(constructor: T): T;
 ```
 
-Defined in: [decorators.ts:1126](https://github.com/foo-ogawa/litedbmodel/blob/main/src/decorators.ts#L1126)
+Defined in: [decorators.ts:1144](https://github.com/foo-ogawa/litedbmodel/blob/main/src/decorators.ts#L1144)
 
 A class decorator that works under both protocols.
 
@@ -42,7 +42,7 @@ A class decorator that works under both protocols.
 ModelClassDecorator<T>(value: T, context: ClassDecoratorContext): T;
 ```
 
-Defined in: [decorators.ts:1127](https://github.com/foo-ogawa/litedbmodel/blob/main/src/decorators.ts#L1127)
+Defined in: [decorators.ts:1145](https://github.com/foo-ogawa/litedbmodel/blob/main/src/decorators.ts#L1145)
 
 A class decorator that works under both protocols.
 

package/docs/api/interfaces/ModelOptions.md

@@ -1,4 +1,4 @@
-[**litedbmodel v2.2.7**](../README.md)
+[**litedbmodel v2.2.8**](../README.md)
 
 ***
 

package/docs/api/interfaces/PkeyResult.md

@@ -1,4 +1,4 @@
-[**litedbmodel v2.2.7**](../README.md)
+[**litedbmodel v2.2.8**](../README.md)
 
 ***
 

package/docs/api/interfaces/RelationDecorator.md

@@ -1,4 +1,4 @@
-[**litedbmodel v2.2.7**](../README.md)
+[**litedbmodel v2.2.8**](../README.md)
 
 ***
 

package/docs/api/interfaces/SelectOptions.md

@@ -1,4 +1,4 @@
-[**litedbmodel v2.2.7**](../README.md)
+[**litedbmodel v2.2.8**](../README.md)
 
 ***
 

package/docs/api/interfaces/SqlCondition.md

@@ -1,4 +1,4 @@
-[**litedbmodel v2.2.7**](../README.md)
+[**litedbmodel v2.2.8**](../README.md)
 
 ***
 

package/docs/api/interfaces/SqlFragment.md

@@ -1,4 +1,4 @@
-[**litedbmodel v2.2.7**](../README.md)
+[**litedbmodel v2.2.8**](../README.md)
 
 ***
 

package/docs/api/interfaces/SqlTypedFragment.md

@@ -1,4 +1,4 @@
-[**litedbmodel v2.2.7**](../README.md)
+[**litedbmodel v2.2.8**](../README.md)
 
 ***
 

package/docs/api/interfaces/TransactionOptions.md

@@ -1,4 +1,4 @@
-[**litedbmodel v2.2.7**](../README.md)
+[**litedbmodel v2.2.8**](../README.md)
 
 ***
 

package/docs/api/interfaces/UpdateManyOptions.md

@@ -1,4 +1,4 @@
-[**litedbmodel v2.2.7**](../README.md)
+[**litedbmodel v2.2.8**](../README.md)
 
 ***
 

package/docs/api/interfaces/UpdateOptions.md

@@ -1,4 +1,4 @@
-[**litedbmodel v2.2.7**](../README.md)
+[**litedbmodel v2.2.8**](../README.md)
 
 ***
 

package/docs/architecture.md

@@ -207,15 +207,19 @@ nullability は基底スカラと直交する（`` `sqlTypeIsNotNull` (`src/scp/
 
 **TS 読み出しの materialization（`sqlTypeToMaterializeClass` / `materializeCell`）**
 
-bc outType（可搬型）に加え、TS/driver の読み経路では `int` スカラを SQL 幅で分割し、`date`/`bool` を
-正確な JS 形へ矯正する（JS `number` は i64 を保持できず、driver は `string` outType に反する `Date`/`0|1`
-を返し得るため）。クラスは `` `MaterializeClass` (`src/scp/coltype.ts`) ``:
-
-- `int32`（INT/INTEGER/SMALLINT/…）→ JS `number`（範囲が収まる）。
-- `int64`（BIGINT/INT8/BIGSERIAL）→ **値保存の10進文字列**（JS number は 2^53 超で丸む・JSON 安全）。
-- `date`（DATE/TIMESTAMP/…）→ **TZ 付き文字列**（`string` outType に整合。全言語同一、TS も Date にしない）。
+bc outType（可搬型）に加え、TS/driver の読み経路では `int`/`date`/`bool` を正確な JS 形へ矯正する
+（JS `number` は i64 を保持できず、driver は `string` outType に反する `Date`/`0|1` を返し得るため）。
+クラスは `` `MaterializeClass` (`src/scp/coltype.ts`) ``:
+
+- `int`（INTEGER / INT / SMALLINT / TINYINT / MEDIUMINT / BIGINT / INT2 / INT4 / INT8 / SERIAL 系）→
+  **JS `bigint`**（checked i64）。bc の整数型は `int` 1 つなので幅で分けない（幅は列制約であって別の読み型
+  ではない）。driver が返す `bigint`・整数の10進文字列・安全な整数の `number` を受け、2^53 を超える
+  `number`（読み出しの前に精度が失われている）は throw する。
+- `date`（DATE / TIMESTAMP / TIMESTAMPTZ / DATETIME / TIME）→ **TZ 付き文字列**（`string` outType に整合。
+  全言語同一、TS も Date にしない）。
 - `bool` → JS `boolean`。
-- `passthrough`（float / text / decimal→string / json / uuid / 配列列）→ 無変換。
+- `passthrough`（float / decimal→string / text / json / uuid / 配列列）→ 無変換。配列列は driver の配列
+  typeCast が要素を宣言型どおりに解いた JS 配列をそのまま返す（要素の基底型は検証する）。
 
 読み出しは fail-closed の resolver（`` `failClosedMaterializeResolverFromColumnMap` (`src/scp/coltype.ts`) ``）
 で常時 de-box され、宣言されていない列は throw する（未型付き列を silent に box しない）。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "litedbmodel",
-  "version": "2.2.7",
+  "version": "2.2.8",
   "description": "A lightweight TypeScript ORM for PostgreSQL, MySQL, and SQLite with Active Record pattern",
   "main": "dist/index.cjs",
   "types": "dist/index.d.ts",