litedbmodel 1.0.0 → 1.1.0

package/docs/api/functions/model.md

@@ -1,4 +1,4 @@
-[**litedbmodel v0.20.1**](../README.md)
+[**litedbmodel v1.0.1**](../README.md)
 
 ***
 
@@ -12,7 +12,7 @@
 function model<T>(constructor: T): T;
 ```
 
-Defined in: decorators.ts:784
+Defined in: decorators.ts:927
 
 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:788
+Defined in: decorators.ts:931
 
 Model class decorator.
 
@@ -170,7 +170,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:792
+Defined in: decorators.ts:935
 
 Model class decorator.
 

package/docs/api/functions/parentRef.md

@@ -1,4 +1,4 @@
-[**litedbmodel v0.20.1**](../README.md)
+[**litedbmodel v1.0.1**](../README.md)
 
 ***
 

package/docs/api/functions/sql.md

@@ -0,0 +1,182 @@
+[**litedbmodel v1.0.1**](../README.md)
+
+***
+
+[litedbmodel](../globals.md) / sql
+
+# Function: sql()
+
+## Call Signature
+
+```ts
+function sql<V, M>(strings: TemplateStringsArray, col: Column<V, M>): SqlTypedFragment<V, M>;
+```
+
+Defined in: SqlFragment.ts:234
+
+Single Column interpolation → SqlTypedFragment (for Pattern A tuples or IS NULL conditions).
+
+### Type Parameters
+
+| Type Parameter |
+| ------ |
+| `V` |
+| `M` |
+
+### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `strings` | `TemplateStringsArray` |
+| `col` | [`Column`](../interfaces/Column.md)\<`V`, `M`\> |
+
+### Returns
+
+[`SqlTypedFragment`](../interfaces/SqlTypedFragment.md)\<`V`, `M`\>
+
+## Call Signature
+
+```ts
+function sql<V, M>(
+   strings: TemplateStringsArray, 
+   col: Column<V, M>, 
+value: V): SqlCondition<M>;
+```
+
+Defined in: SqlFragment.ts:242
+
+Single Column + 1 value → SqlCondition (Pattern B: `sql\`${Col} > ${value}\``).
+
+### Type Parameters
+
+| Type Parameter |
+| ------ |
+| `V` |
+| `M` |
+
+### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `strings` | `TemplateStringsArray` |
+| `col` | [`Column`](../interfaces/Column.md)\<`V`, `M`\> |
+| `value` | `V` |
+
+### Returns
+
+[`SqlCondition`](../interfaces/SqlCondition.md)\<`M`\>
+
+## Call Signature
+
+```ts
+function sql<V, M>(
+   strings: TemplateStringsArray, 
+   col: Column<V, M>, 
+   v1: V, 
+v2: V): SqlCondition<M>;
+```
+
+Defined in: SqlFragment.ts:251
+
+Single Column + 2 values → SqlCondition (Pattern B: BETWEEN).
+
+### Type Parameters
+
+| Type Parameter |
+| ------ |
+| `V` |
+| `M` |
+
+### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `strings` | `TemplateStringsArray` |
+| `col` | [`Column`](../interfaces/Column.md)\<`V`, `M`\> |
+| `v1` | `V` |
+| `v2` | `V` |
+
+### Returns
+
+[`SqlCondition`](../interfaces/SqlCondition.md)\<`M`\>
+
+## Call Signature
+
+```ts
+function sql<V, M>(
+   strings: TemplateStringsArray, 
+   col: Column<V, M>, 
+values: readonly V[]): SqlCondition<M>;
+```
+
+Defined in: SqlFragment.ts:261
+
+Single Column + array → SqlCondition (Pattern B: IN).
+
+### Type Parameters
+
+| Type Parameter |
+| ------ |
+| `V` |
+| `M` |
+
+### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `strings` | `TemplateStringsArray` |
+| `col` | [`Column`](../interfaces/Column.md)\<`V`, `M`\> |
+| `values` | readonly `V`[] |
+
+### Returns
+
+[`SqlCondition`](../interfaces/SqlCondition.md)\<`M`\>
+
+## Call Signature
+
+```ts
+function sql(strings: TemplateStringsArray, ...values: (
+  | DBParentRef
+  | SqlRaw
+  | SqlRef
+  | Column<any, any>
+  | {
+  TABLE_NAME: string;
+})[]): SqlFragment;
+```
+
+Defined in: SqlFragment.ts:270
+
+Multiple Columns / TABLE_NAME only → SqlFragment (for QUERY).
+
+### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `strings` | `TemplateStringsArray` |
+| ...`values` | ( \| `DBParentRef` \| [`SqlRaw`](../classes/SqlRaw.md) \| [`SqlRef`](../classes/SqlRef.md) \| [`Column`](../interfaces/Column.md)\<`any`, `any`\> \| \{ `TABLE_NAME`: `string`; \})[] |
+
+### Returns
+
+[`SqlFragment`](../interfaces/SqlFragment.md)
+
+## Call Signature
+
+```ts
+function sql(strings: TemplateStringsArray, ...values: SqlInterpolation[]): SqlFragment;
+```
+
+Defined in: SqlFragment.ts:278
+
+General: mixed interpolation → SqlFragment (for withQuery / execute).
+
+### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `strings` | `TemplateStringsArray` |
+| ...`values` | [`SqlInterpolation`](../globals.md#sqlinterpolation)[] |
+
+### Returns
+
+[`SqlFragment`](../interfaces/SqlFragment.md)

package/docs/api/globals.md

@@ -1,8 +1,8 @@
-[**litedbmodel v0.20.1**](README.md)
+[**litedbmodel v1.0.1**](README.md)
 
 ***
 
-# litedbmodel v0.20.1
+# litedbmodel v1.0.1
 
 litedbmodel - A lightweight TypeScript data access layer
 
@@ -32,6 +32,8 @@ Supports PostgreSQL and SQLite databases.
 ### Other
 
 - [DBHandler](classes/DBHandler.md)
+- [SqlRaw](classes/SqlRaw.md)
+- [SqlRef](classes/SqlRef.md)
 
 ## Interfaces
 
@@ -46,6 +48,11 @@ Supports PostgreSQL and SQLite databases.
 
 - [Column](interfaces/Column.md)
 - [DBConfig](interfaces/DBConfig.md)
+- [MiddlewareConfig](interfaces/MiddlewareConfig.md)
+- [CreatedMiddlewareClass](interfaces/CreatedMiddlewareClass.md)
+- [SqlFragment](interfaces/SqlFragment.md)
+- [SqlTypedFragment](interfaces/SqlTypedFragment.md)
+- [SqlCondition](interfaces/SqlCondition.md)
 - [ColumnOptions](interfaces/ColumnOptions.md)
 - [SelectOptions](interfaces/SelectOptions.md)
 - [InsertOptions](interfaces/InsertOptions.md)
@@ -62,7 +69,7 @@ Supports PostgreSQL and SQLite databases.
 type SkipType = typeof SKIP;
 ```
 
-Defined in: Column.ts:757
+Defined in: Column.ts:780
 
 ***
 
@@ -76,6 +83,39 @@ Defined in: Middleware.ts:295
 
 Type for middleware class (not instance)
 
+***
+
+### SqlInterpolation
+
+```ts
+type SqlInterpolation = 
+  | Column<any, any>
+  | SqlRaw
+  | SqlRef
+  | DBParentRef
+  | SqlFragment
+  | SqlCondition<any>
+  | SqlTypedFragment<any, any>
+  | number
+  | string
+  | boolean
+  | Date
+  | bigint
+  | null
+  | undefined
+  | readonly number[]
+  | readonly string[]
+  | readonly boolean[]
+  | readonly Date[]
+  | {
+  TABLE_NAME: string;
+};
+```
+
+Defined in: SqlFragment.ts:93
+
+Union of all types allowed as interpolated values in `sql` tagged templates.
+
 ## Variables
 
 ### Decorators
@@ -100,7 +140,7 @@ const column: (columnNameOrOptions?: string | ColumnOptions) => PropertyDecorato
 };
 ```
 
-Defined in: decorators.ts:356
+Defined in: decorators.ts:427
 
 Column decorator for defining model properties.
 
@@ -123,7 +163,7 @@ Explicit type conversion required (cannot be auto-inferred):
 @column.stringArray() tags?: string[];           // Array element type unknown
 @column.intArray() scores?: number[];            // Array element type unknown
 @column.json<MyType>() data?: MyType;            // Generic type unknown
-@column.date() birth_date?: Date;                // date vs datetime distinction
+@column.date() birth_date?: string;              // date vs datetime distinction
 ```
 
 Note: The explicit variants (`@column.boolean()`, `@column.datetime()`, etc.)
@@ -133,19 +173,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:370 |
-| `number()` | (`columnName?`: `string`) => `PropertyDecorator` | Number type conversion (from string) Preserves null for nullable columns, undefined stays undefined **Example** `@column.number() amount?: number;` | decorators.ts:381 |
-| `bigint()` | (`columnName?`: `string`) => `PropertyDecorator` | BigInt type conversion Preserves null for nullable columns, undefined stays undefined **Example** `@column.bigint() large_id?: bigint;` | decorators.ts:394 |
-| `datetime()` | (`columnName?`: `string`) => `PropertyDecorator` | DateTime type conversion (timestamp, timestamptz) Preserves null for nullable columns, undefined stays undefined **Example** `@column.datetime() created_at?: Date;` | decorators.ts:414 |
-| `date()` | (`columnName?`: `string`) => `PropertyDecorator` | Date type conversion (date only, time set to 00:00:00) Preserves null for nullable columns, undefined stays undefined **Example** `@column.date() birth_date?: Date;` | decorators.ts:425 |
-| `stringArray()` | (`columnName?`: `string`) => `PropertyDecorator` | String array type conversion (text[]) Preserves null for nullable columns, undefined stays undefined **Example** `@column.stringArray() tags?: string[];` | decorators.ts:445 |
-| `intArray()` | (`columnName?`: `string`) => `PropertyDecorator` | Integer array type conversion (integer[]) Preserves null for nullable columns, undefined stays undefined **Example** `@column.intArray() scores?: number[];` | decorators.ts:460 |
-| `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:475 |
-| `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:490 |
-| `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:505 |
-| `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:531 |
-| `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:564 |
-| `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:586 |
+| `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 |
 
 ### Other
 
@@ -155,7 +195,7 @@ still work and can be used when you want to be explicit about the conversion.
 const SKIP: typeof SKIP;
 ```
 
-Defined in: Column.ts:756
+Defined in: Column.ts:779
 
 Sentinel value to skip a field in create/update operations.
 Use with conditional expressions to keep code as expressions instead of statements.
@@ -184,8 +224,13 @@ await User.update(conds, [
 - [hasOne](functions/hasOne.md)
 - [model](functions/model.md)
 
+### Middleware
+
+- [createMiddleware](functions/createMiddleware.md)
+
 ### Other
 
+- [condsToRecord](functions/condsToRecord.md)
 - [initDBHandler](functions/initDBHandler.md)
 - [getDBHandler](functions/getDBHandler.md)
 - [getDBConfig](functions/getDBConfig.md)
@@ -206,6 +251,13 @@ await User.update(conds, [
 - [dbCastIn](functions/dbCastIn.md)
 - [dbUuidIn](functions/dbUuidIn.md)
 - [parentRef](functions/parentRef.md)
+- [isSqlFragment](functions/isSqlFragment.md)
+- [isSqlTypedFragment](functions/isSqlTypedFragment.md)
+- [isSqlCondition](functions/isSqlCondition.md)
+- [isAnySqlFragment](functions/isAnySqlFragment.md)
+- [isSqlRaw](functions/isSqlRaw.md)
+- [isSqlRef](functions/isSqlRef.md)
+- [sql](functions/sql.md)
 - [createPostgresDriver](functions/createPostgresDriver.md)
 - [createSqliteDriver](functions/createSqliteDriver.md)
 

package/docs/api/interfaces/Column.md

@@ -1,4 +1,4 @@
-[**litedbmodel v0.20.1**](../README.md)
+[**litedbmodel v1.0.1**](../README.md)
 
 ***
 
@@ -6,7 +6,7 @@
 
 # Interface: Column()\<ValueType, ModelType\>
 
-Defined in: Column.ts:143
+Defined in: Column.ts:144
 
 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:145
+Defined in: Column.ts:146
 
 Call to get column name as string (for computed property keys)
 
@@ -33,13 +33,13 @@ 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:148 |
-| <a id="propertyname"></a> `propertyName` | `readonly` | `string` | The property name on the model class (may differ from columnName) | Column.ts:151 |
-| <a id="tablename"></a> `tableName` | `readonly` | `string` | The database table name | Column.ts:154 |
-| <a id="modelname"></a> `modelName` | `readonly` | `string` | The model class name (for debugging and static analysis) | Column.ts:157 |
-| <a id="_brand"></a> `_brand` | `readonly` | `"Column"` | Brand for type discrimination - enables static analysis to distinguish from regular variables | Column.ts:160 |
-| <a id="sqlcast"></a> `sqlCast?` | `readonly` | `string` | SQL type for automatic casting in conditions (e.g., 'uuid') | Column.ts:163 |
-| <a id="__model"></a> `__model?` | `readonly` | `ModelType` | Phantom type for model association (compile-time only, not used at runtime) | Column.ts:166 |
+| <a id="columnname"></a> `columnName` | `readonly` | `string` | The database column name | Column.ts:149 |
+| <a id="propertyname"></a> `propertyName` | `readonly` | `string` | The property name on the model class (may differ from columnName) | Column.ts:152 |
+| <a id="tablename"></a> `tableName` | `readonly` | `string` | The database table name | Column.ts:155 |
+| <a id="modelname"></a> `modelName` | `readonly` | `string` | The model class name (for debugging and static analysis) | Column.ts:158 |
+| <a id="_brand"></a> `_brand` | `readonly` | `"Column"` | Brand for type discrimination - enables static analysis to distinguish from regular variables | Column.ts:161 |
+| <a id="sqlcast"></a> `sqlCast?` | `readonly` | `string` | SQL type for automatic casting in conditions (e.g., 'uuid') | Column.ts:164 |
+| <a id="__model"></a> `__model?` | `readonly` | `ModelType` | Phantom type for model association (compile-time only, not used at runtime) | Column.ts:167 |
 
 ## Methods
 
@@ -49,7 +49,7 @@ Call to get column name as string (for computed property keys)
 eq(value: ValueType): Record<string, ValueType | DBCast>;
 ```
 
-Defined in: Column.ts:176
+Defined in: Column.ts:177
 
 Equal condition (column = value)
 
@@ -77,7 +77,7 @@ User.id.eq(1) → { id: 1 }
 ne(value: ValueType): Record<string, ValueType | DBCast>;
 ```
 
-Defined in: Column.ts:182
+Defined in: Column.ts:183
 
 Not equal condition (column != value)
 
@@ -105,7 +105,7 @@ User.status.ne('deleted') → { 'status != ?': 'deleted' }
 gt(value: ValueType): Record<string, ValueType | DBCast>;
 ```
 
-Defined in: Column.ts:188
+Defined in: Column.ts:189
 
 Greater than condition (column > value)
 
@@ -133,7 +133,7 @@ User.age.gt(18) → { 'age > ?': 18 }
 gte(value: ValueType): Record<string, ValueType | DBCast>;
 ```
 
-Defined in: Column.ts:194
+Defined in: Column.ts:195
 
 Greater than or equal condition (column >= value)
 
@@ -161,7 +161,7 @@ User.age.gte(18) → { 'age >= ?': 18 }
 lt(value: ValueType): Record<string, ValueType | DBCast>;
 ```
 
-Defined in: Column.ts:200
+Defined in: Column.ts:201
 
 Less than condition (column < value)
 
@@ -189,7 +189,7 @@ User.age.lt(65) → { 'age < ?': 65 }
 lte(value: ValueType): Record<string, ValueType | DBCast>;
 ```
 
-Defined in: Column.ts:206
+Defined in: Column.ts:207
 
 Less than or equal condition (column <= value)
 
@@ -217,7 +217,7 @@ User.age.lte(65) → { 'age <= ?': 65 }
 like(pattern: string): Record<string, string>;
 ```
 
-Defined in: Column.ts:212
+Defined in: Column.ts:213
 
 LIKE condition (column LIKE pattern)
 
@@ -245,7 +245,7 @@ User.name.like('%test%') → { 'name LIKE ?': '%test%' }
 notLike(pattern: string): Record<string, string>;
 ```
 
-Defined in: Column.ts:218
+Defined in: Column.ts:219
 
 NOT LIKE condition (column NOT LIKE pattern)
 
@@ -273,7 +273,7 @@ User.name.notLike('%test%') → { 'name NOT LIKE ?': '%test%' }
 ilike(pattern: string): Record<string, string>;
 ```
 
-Defined in: Column.ts:224
+Defined in: Column.ts:225
 
 ILIKE condition (case-insensitive LIKE, PostgreSQL specific)
 
@@ -301,7 +301,7 @@ User.name.ilike('%TEST%') → { 'name ILIKE ?': '%TEST%' }
 between(from: ValueType, to: ValueType): Record<string, [ValueType, ValueType]>;
 ```
 
-Defined in: Column.ts:230
+Defined in: Column.ts:231
 
 BETWEEN condition (column BETWEEN from AND to)
 
@@ -330,7 +330,7 @@ User.age.between(18, 65) → { 'age BETWEEN ? AND ?': [18, 65] }
 in(values: ValueType[]): Record<string, ValueType[] | DBCastArray>;
 ```
 
-Defined in: Column.ts:237
+Defined in: Column.ts:238
 
 IN condition (column IN (values))
 Note: Arrays are automatically converted to IN clause by litedbmodel
@@ -359,7 +359,7 @@ User.status.in(['active', 'pending']) → { status: ['active', 'pending'] }
 notIn(values: ValueType[]): Record<string, ValueType[] | DBCastArray>;
 ```
 
-Defined in: Column.ts:243
+Defined in: Column.ts:244
 
 NOT IN condition (column NOT IN (values))
 
@@ -387,7 +387,7 @@ User.status.notIn(['deleted', 'banned'])
 isNull(): Record<string, null>;
 ```
 
-Defined in: Column.ts:249
+Defined in: Column.ts:250
 
 IS NULL condition
 
@@ -409,7 +409,7 @@ User.deleted_at.isNull() → { deleted_at: null }
 isNotNull(): Record<string, DBNotNullValue>;
 ```
 
-Defined in: Column.ts:255
+Defined in: Column.ts:256
 
 IS NOT NULL condition
 
@@ -431,7 +431,7 @@ User.email.isNotNull() → { email: DBNotNullValue }
 asc(): OrderColumn<ModelType>;
 ```
 
-Defined in: Column.ts:265
+Defined in: Column.ts:266
 
 Ascending order
 
@@ -453,7 +453,7 @@ User.created_at.asc() → OrderColumn('created_at', 'ASC')
 desc(): OrderColumn<ModelType>;
 ```
 
-Defined in: Column.ts:271
+Defined in: Column.ts:272
 
 Descending order
 
@@ -475,7 +475,7 @@ User.created_at.desc() → OrderColumn('created_at', 'DESC')
 ascNullsFirst(): OrderColumn<ModelType>;
 ```
 
-Defined in: Column.ts:277
+Defined in: Column.ts:278
 
 Ascending order with NULLS FIRST
 
@@ -497,7 +497,7 @@ User.updated_at.ascNullsFirst() → OrderColumn with NULLS FIRST
 ascNullsLast(): OrderColumn<ModelType>;
 ```
 
-Defined in: Column.ts:283
+Defined in: Column.ts:284
 
 Ascending order with NULLS LAST
 
@@ -519,7 +519,7 @@ User.updated_at.ascNullsLast() → OrderColumn with NULLS LAST
 descNullsFirst(): OrderColumn<ModelType>;
 ```
 
-Defined in: Column.ts:289
+Defined in: Column.ts:290
 
 Descending order with NULLS FIRST
 
@@ -541,7 +541,7 @@ User.updated_at.descNullsFirst() → OrderColumn with NULLS FIRST
 descNullsLast(): OrderColumn<ModelType>;
 ```
 
-Defined in: Column.ts:295
+Defined in: Column.ts:296
 
 Descending order with NULLS LAST
 
@@ -563,7 +563,7 @@ User.updated_at.descNullsLast() → OrderColumn with NULLS LAST
 toString(): string;
 ```
 
-Defined in: Column.ts:305
+Defined in: Column.ts:306
 
 Returns column name (for template literals)
 

package/docs/api/interfaces/ColumnOptions.md

@@ -1,4 +1,4 @@
-[**litedbmodel v0.20.1**](../README.md)
+[**litedbmodel v1.0.1**](../README.md)
 
 ***
 
@@ -6,7 +6,7 @@
 
 # Interface: ColumnOptions
 
-Defined in: decorators.ts:231
+Defined in: decorators.ts:268
 
 Options that can be passed to
 
@@ -18,5 +18,5 @@ decorator
 
 | Property | Type | Description | Defined in |
 | ------ | ------ | ------ | ------ |
-| <a id="columnname"></a> `columnName?` | `string` | Custom column name (defaults to property name) | decorators.ts:233 |
-| <a id="primarykey"></a> `primaryKey?` | `boolean` | Mark this column as part of the primary key | decorators.ts:235 |
+| <a id="columnname"></a> `columnName?` | `string` | Custom column name (defaults to property name) | decorators.ts:270 |
+| <a id="primarykey"></a> `primaryKey?` | `boolean` | Mark this column as part of the primary key | decorators.ts:272 |