litedbmodel 2.2.2 → 2.2.4

package/docs/api/functions/dbUuid.md

@@ -1,4 +1,4 @@
-[**litedbmodel v1.0.1**](../README.md)
+[**litedbmodel v2.2.4**](../README.md)
 
 ***
 
@@ -7,10 +7,10 @@
 # Function: dbUuid()
 
 ```ts
-function dbUuid(value: string, operator: string): DBCast;
+function dbUuid(value: string, operator?: string): DBCast;
 ```
 
-Defined in: DBValues.ts:519
+Defined in: [DBValues.ts:519](https://github.com/foo-ogawa/litedbmodel/blob/main/src/DBValues.ts#L519)
 
 Create a type-cast UUID value
 

package/docs/api/functions/dbUuidIn.md

@@ -1,4 +1,4 @@
-[**litedbmodel v1.0.1**](../README.md)
+[**litedbmodel v2.2.4**](../README.md)
 
 ***
 
@@ -10,7 +10,7 @@
 function dbUuidIn(values: string[]): DBCastArray;
 ```
 
-Defined in: DBValues.ts:544
+Defined in: [DBValues.ts:544](https://github.com/foo-ogawa/litedbmodel/blob/main/src/DBValues.ts#L544)
 
 Create a type-cast UUID array for IN clause
 

package/docs/api/functions/formatLocalDate.md

@@ -0,0 +1,25 @@
+[**litedbmodel v2.2.4**](../README.md)
+
+***
+
+[litedbmodel](../globals.md) / formatLocalDate
+
+# Function: formatLocalDate()
+
+```ts
+function formatLocalDate(d: Date): string;
+```
+
+Defined in: [TypeCast.ts:310](https://github.com/foo-ogawa/litedbmodel/blob/main/src/TypeCast.ts#L310)
+
+Format Date as YYYY-MM-DD using local time components
+
+## Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `d` | `Date` |
+
+## Returns
+
+`string`

package/docs/api/functions/formatUTCDate.md

@@ -0,0 +1,25 @@
+[**litedbmodel v2.2.4**](../README.md)
+
+***
+
+[litedbmodel](../globals.md) / formatUTCDate
+
+# Function: formatUTCDate()
+
+```ts
+function formatUTCDate(d: Date): string;
+```
+
+Defined in: [TypeCast.ts:318](https://github.com/foo-ogawa/litedbmodel/blob/main/src/TypeCast.ts#L318)
+
+Format Date as YYYY-MM-DD using UTC components
+
+## Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `d` | `Date` |
+
+## Returns
+
+`string`

package/docs/api/functions/getDBConfig.md

@@ -1,4 +1,4 @@
-[**litedbmodel v1.0.1**](../README.md)
+[**litedbmodel v2.2.4**](../README.md)
 
 ***
 
@@ -10,7 +10,7 @@
 function getDBConfig(): DBConfig | null;
 ```
 
-Defined in: DBHandler.ts:322
+Defined in: [DBHandler.ts:327](https://github.com/foo-ogawa/litedbmodel/blob/main/src/DBHandler.ts#L327)
 
 Get global config
 

package/docs/api/functions/getDBHandler.md

@@ -1,4 +1,4 @@
-[**litedbmodel v1.0.1**](../README.md)
+[**litedbmodel v2.2.4**](../README.md)
 
 ***
 
@@ -10,7 +10,7 @@
 function getDBHandler(): DBHandler;
 ```
 
-Defined in: DBHandler.ts:312
+Defined in: [DBHandler.ts:317](https://github.com/foo-ogawa/litedbmodel/blob/main/src/DBHandler.ts#L317)
 
 Get global handler
 

package/docs/api/functions/getTransactionConnection.md

@@ -1,4 +1,4 @@
-[**litedbmodel v1.0.1**](../README.md)
+[**litedbmodel v2.2.4**](../README.md)
 
 ***
 
@@ -10,7 +10,7 @@
 function getTransactionConnection(): DBConnection | undefined;
 ```
 
-Defined in: DBModel.ts:48
+Defined in: [DBModel.ts:74](https://github.com/foo-ogawa/litedbmodel/blob/main/src/DBModel.ts#L74)
 
 Get current transaction connection (if in a transaction)
 

package/docs/api/functions/getTransactionContext.md

@@ -1,4 +1,4 @@
-[**litedbmodel v1.0.1**](../README.md)
+[**litedbmodel v2.2.4**](../README.md)
 
 ***
 
@@ -10,7 +10,7 @@
 function getTransactionContext(): TransactionContext | undefined;
 ```
 
-Defined in: DBModel.ts:41
+Defined in: [DBModel.ts:67](https://github.com/foo-ogawa/litedbmodel/blob/main/src/DBModel.ts#L67)
 
 Get current transaction context (if in a transaction)
 

package/docs/api/functions/hasMany.md

@@ -1,4 +1,4 @@
-[**litedbmodel v1.0.1**](../README.md)
+[**litedbmodel v2.2.4**](../README.md)
 
 ***
 
@@ -10,7 +10,7 @@
 function hasMany(keys: KeysFactory, options?: RelationDecoratorOptions): PropertyDecorator;
 ```
 
-Defined in: decorators.ts:798
+Defined in: [decorators.ts:877](https://github.com/foo-ogawa/litedbmodel/blob/main/src/decorators.ts#L877)
 
 HasMany relation decorator (1:N).
 Defines a one-to-many relationship where this model has many related records.

package/docs/api/functions/hasOne.md

@@ -1,4 +1,4 @@
-[**litedbmodel v1.0.1**](../README.md)
+[**litedbmodel v2.2.4**](../README.md)
 
 ***
 
@@ -10,7 +10,7 @@
 function hasOne(keys: KeysFactory, options?: RelationDecoratorOptions): PropertyDecorator;
 ```
 
-Defined in: decorators.ts:862
+Defined in: [decorators.ts:941](https://github.com/foo-ogawa/litedbmodel/blob/main/src/decorators.ts#L941)
 
 HasOne relation decorator (1:1).
 Defines a one-to-one relationship where this model has one related record.

package/docs/api/functions/initDBHandler.md

@@ -1,4 +1,4 @@
-[**litedbmodel v1.0.1**](../README.md)
+[**litedbmodel v2.2.4**](../README.md)
 
 ***
 
@@ -10,7 +10,7 @@
 function initDBHandler(config: DBConfig, options?: DBHandlerOptions): DBHandler;
 ```
 
-Defined in: DBHandler.ts:302
+Defined in: [DBHandler.ts:307](https://github.com/foo-ogawa/litedbmodel/blob/main/src/DBHandler.ts#L307)
 
 Initialize global handler with config
 

package/docs/api/functions/isAnySqlFragment.md

@@ -1,4 +1,4 @@
-[**litedbmodel v1.0.1**](../README.md)
+[**litedbmodel v2.2.4**](../README.md)
 
 ***
 
@@ -10,7 +10,7 @@
 function isAnySqlFragment(value: unknown): value is SqlFragment | SqlTypedFragment<unknown, unknown> | SqlCondition<unknown>;
 ```
 
-Defined in: SqlFragment.ts:148
+Defined in: [SqlFragment.ts:149](https://github.com/foo-ogawa/litedbmodel/blob/main/src/SqlFragment.ts#L149)
 
 Matches any of SqlFragment, SqlTypedFragment, or SqlCondition.
 

package/docs/api/functions/isConnectionError.md

@@ -0,0 +1,26 @@
+[**litedbmodel v2.2.4**](../README.md)
+
+***
+
+[litedbmodel](../globals.md) / isConnectionError
+
+# Function: isConnectionError()
+
+```ts
+function isConnectionError(error: Error): boolean;
+```
+
+Defined in: [connection-errors.ts:5](https://github.com/foo-ogawa/litedbmodel/blob/main/src/connection-errors.ts#L5)
+
+Check if an error indicates a broken/stale connection.
+Used by both transaction retry (DBModel) and execute-level retry (drivers).
+
+## Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `error` | `Error` |
+
+## Returns
+
+`boolean`

package/docs/api/functions/isSqlCondition.md

@@ -1,4 +1,4 @@
-[**litedbmodel v1.0.1**](../README.md)
+[**litedbmodel v2.2.4**](../README.md)
 
 ***
 
@@ -10,7 +10,7 @@
 function isSqlCondition(value: unknown): value is SqlCondition<unknown>;
 ```
 
-Defined in: SqlFragment.ts:136
+Defined in: [SqlFragment.ts:137](https://github.com/foo-ogawa/litedbmodel/blob/main/src/SqlFragment.ts#L137)
 
 ## Parameters
 

package/docs/api/functions/isSqlFragment.md

@@ -1,4 +1,4 @@
-[**litedbmodel v1.0.1**](../README.md)
+[**litedbmodel v2.2.4**](../README.md)
 
 ***
 
@@ -10,7 +10,7 @@
 function isSqlFragment(value: unknown): value is SqlFragment;
 ```
 
-Defined in: SqlFragment.ts:118
+Defined in: [SqlFragment.ts:119](https://github.com/foo-ogawa/litedbmodel/blob/main/src/SqlFragment.ts#L119)
 
 ## Parameters
 

package/docs/api/functions/isSqlRaw.md

@@ -1,4 +1,4 @@
-[**litedbmodel v1.0.1**](../README.md)
+[**litedbmodel v2.2.4**](../README.md)
 
 ***
 
@@ -10,7 +10,7 @@
 function isSqlRaw(value: unknown): value is SqlRaw;
 ```
 
-Defined in: SqlFragment.ts:154
+Defined in: [SqlFragment.ts:155](https://github.com/foo-ogawa/litedbmodel/blob/main/src/SqlFragment.ts#L155)
 
 ## Parameters
 

package/docs/api/functions/isSqlRef.md

@@ -1,4 +1,4 @@
-[**litedbmodel v1.0.1**](../README.md)
+[**litedbmodel v2.2.4**](../README.md)
 
 ***
 
@@ -10,7 +10,7 @@
 function isSqlRef(value: unknown): value is SqlRef;
 ```
 
-Defined in: SqlFragment.ts:158
+Defined in: [SqlFragment.ts:159](https://github.com/foo-ogawa/litedbmodel/blob/main/src/SqlFragment.ts#L159)
 
 ## Parameters
 

package/docs/api/functions/isSqlTypedFragment.md

@@ -1,4 +1,4 @@
-[**litedbmodel v1.0.1**](../README.md)
+[**litedbmodel v2.2.4**](../README.md)
 
 ***
 
@@ -10,7 +10,7 @@
 function isSqlTypedFragment(value: unknown): value is SqlTypedFragment<unknown, unknown>;
 ```
 
-Defined in: SqlFragment.ts:127
+Defined in: [SqlFragment.ts:128](https://github.com/foo-ogawa/litedbmodel/blob/main/src/SqlFragment.ts#L128)
 
 ## Parameters
 

package/docs/api/functions/model.md

@@ -1,4 +1,4 @@
-[**litedbmodel v1.0.1**](../README.md)
+[**litedbmodel v2.2.4**](../README.md)
 
 ***
 
@@ -12,7 +12,7 @@
 function model<T>(constructor: T): T;
 ```
 
-Defined in: decorators.ts:927
+Defined in: [decorators.ts:1006](https://github.com/foo-ogawa/litedbmodel/blob/main/src/decorators.ts#L1006)
 
 Model class decorator.
 
@@ -85,7 +85,7 @@ const posts = await user.posts;  // Batch loads with other users in context
 function model(tableName: string): <T>(constructor: T) => T;
 ```
 
-Defined in: decorators.ts:931
+Defined in: [decorators.ts:1010](https://github.com/foo-ogawa/litedbmodel/blob/main/src/decorators.ts#L1010)
 
 Model class decorator.
 
@@ -105,25 +105,7 @@ Automatically:
 
 ### Returns
 
-```ts
-<T>(constructor: T): T;
-```
-
-#### Type Parameters
-
-| Type Parameter |
-| ------ |
-| `T` *extends* (...`args`: `unknown`[]) => `object` |
-
-#### Parameters
-
-| Parameter | Type |
-| ------ | ------ |
-| `constructor` | `T` |
-
-#### Returns
-
-`T`
+\<`T`\>(`constructor`: `T`) => `T`
 
 ### Column
 
@@ -170,7 +152,7 @@ const posts = await user.posts;  // Batch loads with other users in context
 function model(tableName: string, options: ModelOptions): <T>(constructor: T) => T;
 ```
 
-Defined in: decorators.ts:935
+Defined in: [decorators.ts:1014](https://github.com/foo-ogawa/litedbmodel/blob/main/src/decorators.ts#L1014)
 
 Model class decorator.
 
@@ -191,25 +173,7 @@ Automatically:
 
 ### Returns
 
-```ts
-<T>(constructor: T): T;
-```
-
-#### Type Parameters
-
-| Type Parameter |
-| ------ |
-| `T` *extends* (...`args`: `unknown`[]) => `object` |
-
-#### Parameters
-
-| Parameter | Type |
-| ------ | ------ |
-| `constructor` | `T` |
-
-#### Returns
-
-`T`
+\<`T`\>(`constructor`: `T`) => `T`
 
 ### Column
 

package/docs/api/functions/parentRef.md

@@ -1,4 +1,4 @@
-[**litedbmodel v1.0.1**](../README.md)
+[**litedbmodel v2.2.4**](../README.md)
 
 ***
 
@@ -10,7 +10,7 @@
 function parentRef(column: ColumnRef): DBParentRef;
 ```
 
-Defined in: DBValues.ts:643
+Defined in: [DBValues.ts:643](https://github.com/foo-ogawa/litedbmodel/blob/main/src/DBValues.ts#L643)
 
 Create a parent table column reference for correlated subqueries.
 

package/docs/api/functions/sql.md

@@ -1,4 +1,4 @@
-[**litedbmodel v1.0.1**](../README.md)
+[**litedbmodel v2.2.4**](../README.md)
 
 ***
 
@@ -12,7 +12,7 @@
 function sql<V, M>(strings: TemplateStringsArray, col: Column<V, M>): SqlTypedFragment<V, M>;
 ```
 
-Defined in: SqlFragment.ts:234
+Defined in: [SqlFragment.ts:235](https://github.com/foo-ogawa/litedbmodel/blob/main/src/SqlFragment.ts#L235)
 
 Single Column interpolation → SqlTypedFragment (for Pattern A tuples or IS NULL conditions).
 
@@ -43,7 +43,7 @@ function sql<V, M>(
 value: V): SqlCondition<M>;
 ```
 
-Defined in: SqlFragment.ts:242
+Defined in: [SqlFragment.ts:243](https://github.com/foo-ogawa/litedbmodel/blob/main/src/SqlFragment.ts#L243)
 
 Single Column + 1 value → SqlCondition (Pattern B: `sql\`${Col} > ${value}\``).
 
@@ -76,7 +76,7 @@ function sql<V, M>(
 v2: V): SqlCondition<M>;
 ```
 
-Defined in: SqlFragment.ts:251
+Defined in: [SqlFragment.ts:252](https://github.com/foo-ogawa/litedbmodel/blob/main/src/SqlFragment.ts#L252)
 
 Single Column + 2 values → SqlCondition (Pattern B: BETWEEN).
 
@@ -109,7 +109,7 @@ function sql<V, M>(
 values: readonly V[]): SqlCondition<M>;
 ```
 
-Defined in: SqlFragment.ts:261
+Defined in: [SqlFragment.ts:262](https://github.com/foo-ogawa/litedbmodel/blob/main/src/SqlFragment.ts#L262)
 
 Single Column + array → SqlCondition (Pattern B: IN).
 
@@ -145,7 +145,7 @@ function sql(strings: TemplateStringsArray, ...values: (
 })[]): SqlFragment;
 ```
 
-Defined in: SqlFragment.ts:270
+Defined in: [SqlFragment.ts:271](https://github.com/foo-ogawa/litedbmodel/blob/main/src/SqlFragment.ts#L271)
 
 Multiple Columns / TABLE_NAME only → SqlFragment (for QUERY).
 
@@ -166,7 +166,7 @@ Multiple Columns / TABLE_NAME only → SqlFragment (for QUERY).
 function sql(strings: TemplateStringsArray, ...values: SqlInterpolation[]): SqlFragment;
 ```
 
-Defined in: SqlFragment.ts:278
+Defined in: [SqlFragment.ts:279](https://github.com/foo-ogawa/litedbmodel/blob/main/src/SqlFragment.ts#L279)
 
 General: mixed interpolation → SqlFragment (for withQuery / execute).
 

package/docs/api/globals.md

@@ -1,8 +1,8 @@
-[**litedbmodel v1.0.1**](README.md)
+[**litedbmodel v2.2.4**](README.md)
 
 ***
 
-# litedbmodel v1.0.1
+# litedbmodel v2.2.4
 
 litedbmodel - A lightweight TypeScript data access layer
 
@@ -69,19 +69,48 @@ Supports PostgreSQL and SQLite databases.
 type SkipType = typeof SKIP;
 ```
 
-Defined in: Column.ts:780
+Defined in: [Column.ts:780](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L780)
 
 ***
 
 ### MiddlewareClass
 
 ```ts
-type MiddlewareClass = typeof Middleware & () => Middleware;
+type MiddlewareClass = {
+  getCurrentContext: object;
+};
+```
+
+Defined in: [Middleware.ts:310](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Middleware.ts#L310)
+
+Type for middleware class (not instance) — what [DBModel.use](classes/DBModel.md#use) registers.
+
+The requirement is exactly what the registry's ONE consumer uses: a registered class is only ever
+constructed and asked for the current request's instance (`MWClass.getCurrentContext()`), whose hook
+is then looked up BY NAME and invoked (`DBModel._applyMiddleware` — the lookup is already a cast,
+because which hooks a middleware implements is its own choice).
+
+Naming `typeof Middleware` here instead demanded the whole static side — `_storage` / `getStorage`
+included — and a `getCurrentContext()` returning a full `Middleware`. The class produced by
+[createMiddleware](functions/createMiddleware.md) advertises neither: its state is its own shape, and a state key may
+deliberately SHADOW a hook of the same name (`state: { count: 0 }` vs. the `count` hook — at runtime
+the assigned own property wins over the prototype method). So the DOCUMENTED pairing
+(`DBModel.use(DBModel.createMiddleware(…))`, README) did not typecheck even though it is the
+runtime-correct call, and every stateful middleware in the README was affected.
+
+#### Methods
+
+##### getCurrentContext()
+
+```ts
+getCurrentContext(): object;
 ```
 
-Defined in: Middleware.ts:295
+Defined in: [Middleware.ts:310](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Middleware.ts#L310)
+
+###### Returns
 
-Type for middleware class (not instance)
+`object`
 
 ***
 
@@ -109,10 +138,13 @@ type SqlInterpolation =
   | readonly Date[]
   | {
   TABLE_NAME: string;
+}
+  | {
+  getTableName: string;
 };
 ```
 
-Defined in: SqlFragment.ts:93
+Defined in: [SqlFragment.ts:93](https://github.com/foo-ogawa/litedbmodel/blob/main/src/SqlFragment.ts#L93)
 
 Union of all types allowed as interpolated values in `sql` tagged templates.
 
@@ -140,7 +172,7 @@ const column: (columnNameOrOptions?: string | ColumnOptions) => PropertyDecorato
 };
 ```
 
-Defined in: decorators.ts:427
+Defined in: [decorators.ts:516](https://github.com/foo-ogawa/litedbmodel/blob/main/src/decorators.ts#L516)
 
 Column decorator for defining model properties.
 
@@ -173,19 +205,19 @@ still work and can be used when you want to be explicit about the conversion.
 
 | Name | Type | Description | Defined in |
 | ------ | ------ | ------ | ------ |
-| `boolean()` | (`columnName?`: `string`) => `PropertyDecorator` | Boolean type conversion Converts 't'/'f', 'true'/'false', 1/0 to boolean Preserves null for nullable columns, undefined stays undefined **Example** `@column.boolean() is_active?: boolean;` | decorators.ts:441 |
-| `number()` | (`columnName?`: `string`) => `PropertyDecorator` | Number type conversion (from string) Preserves null for nullable columns, undefined stays undefined **Example** `@column.number() amount?: number;` | decorators.ts:457 |
-| `bigint()` | (`columnName?`: `string`) => `PropertyDecorator` | BigInt type conversion Preserves null for nullable columns, undefined stays undefined **Example** `@column.bigint() large_id?: bigint;` | decorators.ts:470 |
-| `datetime()` | (`columnName?`: `string`) => `PropertyDecorator` | DateTime type conversion (timestamp, timestamptz) Preserves null for nullable columns, undefined stays undefined Timezone handling: - PostgreSQL: Serializes to ISO 8601 UTC string with 'Z' suffix for explicit timezone - MySQL/SQLite: Passes Date object to driver (driver-dependent timezone handling) **Example** `@column.datetime() created_at?: Date;` | decorators.ts:500 |
-| `date()` | (`columnName?`: `string`) => `PropertyDecorator` | Date type conversion — returns YYYY-MM-DD string. Preserves null for nullable columns, undefined stays undefined. DB values (Date object or string) are normalized to 'YYYY-MM-DD' string. On write, string values are passed through; Date objects are formatted as 'YYYY-MM-DD'. **Example** `@column.date() birth_date?: string;` | decorators.ts:527 |
-| `stringArray()` | (`columnName?`: `string`) => `PropertyDecorator` | String array type conversion (text[]) Preserves null for nullable columns, undefined stays undefined **Example** `@column.stringArray() tags?: string[];` | decorators.ts:578 |
-| `intArray()` | (`columnName?`: `string`) => `PropertyDecorator` | Integer array type conversion (integer[]) Preserves null for nullable columns, undefined stays undefined **Example** `@column.intArray() scores?: number[];` | decorators.ts:595 |
-| `numericArray()` | (`columnName?`: `string`) => `PropertyDecorator` | Numeric array type conversion (numeric[], allows null elements) Preserves null for nullable columns, undefined stays undefined **Example** `@column.numericArray() values?: (number | null)[];` | decorators.ts:612 |
-| `booleanArray()` | (`columnName?`: `string`) => `PropertyDecorator` | Boolean array type conversion (boolean[]) Preserves null for nullable columns, undefined stays undefined **Example** `@column.booleanArray() flags?: (boolean | null)[];` | decorators.ts:629 |
-| `datetimeArray()` | (`columnName?`: `string`) => `PropertyDecorator` | DateTime array type conversion (timestamp[]) Preserves null for nullable columns, undefined stays undefined **Example** `@column.datetimeArray() event_dates?: (Date | null)[];` | decorators.ts:646 |
-| `json()` | \<`T`\>(`columnName?`: `string`) => `PropertyDecorator` | JSON/JSONB type conversion Preserves null for nullable columns, undefined stays undefined **Examples** `@column.json() metadata?: Record<string, unknown>;` `@column.json<UserSettings>() settings?: UserSettings;` | decorators.ts:672 |
-| `uuid()` | (`columnNameOrOptions?`: `string` \| [`ColumnOptions`](interfaces/ColumnOptions.md)) => `PropertyDecorator` | UUID type with automatic casting for PostgreSQL. Automatically adds ::uuid cast to conditions and INSERT/UPDATE values. Preserves null for nullable columns, undefined stays undefined. **Example** `@column.uuid() id?: string; @column.uuid({ primaryKey: true }) id?: string; // Conditions automatically cast to UUID: await User.find([[User.id, 'uuid-string']]); // → WHERE id = ?::uuid // IN clauses also cast: await User.find([[User.id, ['uuid1', 'uuid2']]]); // → WHERE id IN (?::uuid, ?::uuid)` | decorators.ts:707 |
-| `custom()` | \<`T`\>(`castFn`: (`value`: `unknown`) => `T`, `serializeFn?`: `SerializeFn`, `columnName?`: `string`) => `PropertyDecorator` | Custom type conversion with user-provided function **Examples** `@column.custom((v) => String(v).toUpperCase()) status?: string;` `@column.custom((v) => v, (v) => JSON.stringify(v)) data?: MyType; // with serializer` | decorators.ts:729 |
+| `boolean()` | (`columnName?`: `string`) => `PropertyDecorator` | Boolean type conversion Converts 't'/'f', 'true'/'false', 1/0 to boolean Preserves null for nullable columns, undefined stays undefined **Example** `@column.boolean() is_active?: boolean;` | [decorators.ts:530](https://github.com/foo-ogawa/litedbmodel/blob/main/src/decorators.ts#L530) |
+| `number()` | (`columnName?`: `string`) => `PropertyDecorator` | Number type conversion (from string) Preserves null for nullable columns, undefined stays undefined **Example** `@column.number() amount?: number;` | [decorators.ts:547](https://github.com/foo-ogawa/litedbmodel/blob/main/src/decorators.ts#L547) |
+| `bigint()` | (`columnName?`: `string`) => `PropertyDecorator` | BigInt type conversion Preserves null for nullable columns, undefined stays undefined **Example** `@column.bigint() large_id?: bigint;` | [decorators.ts:560](https://github.com/foo-ogawa/litedbmodel/blob/main/src/decorators.ts#L560) |
+| `datetime()` | (`columnName?`: `string`) => `PropertyDecorator` | DateTime type conversion (timestamp, timestamptz) Preserves null for nullable columns, undefined stays undefined Timezone handling: - PostgreSQL: Serializes to ISO 8601 UTC string with 'Z' suffix for explicit timezone - MySQL/SQLite: Passes Date object to driver (driver-dependent timezone handling) **Example** `@column.datetime() created_at?: Date;` | [decorators.ts:588](https://github.com/foo-ogawa/litedbmodel/blob/main/src/decorators.ts#L588) |
+| `date()` | (`columnName?`: `string`) => `PropertyDecorator` | Date type conversion — returns YYYY-MM-DD string. Preserves null for nullable columns, undefined stays undefined. DB values (Date object or string) are normalized to 'YYYY-MM-DD' string. On write, string values are passed through; Date objects are formatted as 'YYYY-MM-DD'. **Example** `@column.date() birth_date?: string;` | [decorators.ts:618](https://github.com/foo-ogawa/litedbmodel/blob/main/src/decorators.ts#L618) |
+| `stringArray()` | (`columnName?`: `string`) => `PropertyDecorator` | String array type conversion (text[]) Preserves null for nullable columns, undefined stays undefined **Example** `@column.stringArray() tags?: string[];` | [decorators.ts:657](https://github.com/foo-ogawa/litedbmodel/blob/main/src/decorators.ts#L657) |
+| `intArray()` | (`columnName?`: `string`) => `PropertyDecorator` | Integer array type conversion (integer[]) Preserves null for nullable columns, undefined stays undefined **Example** `@column.intArray() scores?: number[];` | [decorators.ts:674](https://github.com/foo-ogawa/litedbmodel/blob/main/src/decorators.ts#L674) |
+| `numericArray()` | (`columnName?`: `string`) => `PropertyDecorator` | Numeric array type conversion (numeric[], allows null elements) Preserves null for nullable columns, undefined stays undefined **Example** `@column.numericArray() values?: (number | null)[];` | [decorators.ts:691](https://github.com/foo-ogawa/litedbmodel/blob/main/src/decorators.ts#L691) |
+| `booleanArray()` | (`columnName?`: `string`) => `PropertyDecorator` | Boolean array type conversion (boolean[]) Preserves null for nullable columns, undefined stays undefined **Example** `@column.booleanArray() flags?: (boolean | null)[];` | [decorators.ts:708](https://github.com/foo-ogawa/litedbmodel/blob/main/src/decorators.ts#L708) |
+| `datetimeArray()` | (`columnName?`: `string`) => `PropertyDecorator` | DateTime array type conversion (timestamp[]) Preserves null for nullable columns, undefined stays undefined **Example** `@column.datetimeArray() event_dates?: (Date | null)[];` | [decorators.ts:725](https://github.com/foo-ogawa/litedbmodel/blob/main/src/decorators.ts#L725) |
+| `json()` | \<`T`\>(`columnName?`: `string`) => `PropertyDecorator` | JSON/JSONB type conversion Preserves null for nullable columns, undefined stays undefined **Examples** `@column.json() metadata?: Record<string, unknown>;` `@column.json<UserSettings>() settings?: UserSettings;` | [decorators.ts:751](https://github.com/foo-ogawa/litedbmodel/blob/main/src/decorators.ts#L751) |
+| `uuid()` | (`columnNameOrOptions?`: `string` \| [`ColumnOptions`](interfaces/ColumnOptions.md)) => `PropertyDecorator` | UUID type with automatic casting for PostgreSQL. Automatically adds ::uuid cast to conditions and INSERT/UPDATE values. Preserves null for nullable columns, undefined stays undefined. **Example** `@column.uuid() id?: string; @column.uuid({ primaryKey: true }) id?: string; // Conditions automatically cast to UUID: await User.find([[User.id, 'uuid-string']]); // → WHERE id = ?::uuid // IN clauses also cast: await User.find([[User.id, ['uuid1', 'uuid2']]]); // → WHERE id IN (?::uuid, ?::uuid)` | [decorators.ts:786](https://github.com/foo-ogawa/litedbmodel/blob/main/src/decorators.ts#L786) |
+| `custom()` | \<`T`\>(`castFn`: (`value`: `unknown`) => `T`, `serializeFn?`: `SerializeFn`, `columnName?`: `string`) => `PropertyDecorator` | Custom type conversion with user-provided function **Examples** `@column.custom((v) => String(v).toUpperCase()) status?: string;` `@column.custom((v) => v, (v) => JSON.stringify(v)) data?: MyType; // with serializer` | [decorators.ts:808](https://github.com/foo-ogawa/litedbmodel/blob/main/src/decorators.ts#L808) |
 
 ### Other
 
@@ -195,7 +227,7 @@ still work and can be used when you want to be explicit about the conversion.
 const SKIP: typeof SKIP;
 ```
 
-Defined in: Column.ts:779
+Defined in: [Column.ts:779](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L779)
 
 Sentinel value to skip a field in create/update operations.
 Use with conditional expressions to keep code as expressions instead of statements.
@@ -258,6 +290,9 @@ await User.update(conds, [
 - [isSqlRaw](functions/isSqlRaw.md)
 - [isSqlRef](functions/isSqlRef.md)
 - [sql](functions/sql.md)
+- [formatLocalDate](functions/formatLocalDate.md)
+- [formatUTCDate](functions/formatUTCDate.md)
+- [isConnectionError](functions/isConnectionError.md)
 - [createPostgresDriver](functions/createPostgresDriver.md)
 - [createSqliteDriver](functions/createSqliteDriver.md)