litedbmodel 2.2.2 → 2.2.4

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AA4VH;;;;GAIG;AACH,MAAa,kBAAmB,SAAQ,KAAK;IAEzB;IAKA;IACA;IACA;IACA;IATlB,YACkB,KAAa;IAC7B;;;OAGG;IACa,WAAmB,EACnB,OAA4B,EAC5B,SAAkB,EAClB,YAAqB;QAErC,MAAM,UAAU,GAAG,OAAO,KAAK,MAAM;YACnC,CAAC,CAAC,aAAa,SAAS,IAAI,SAAS,EAAE;YACvC,CAAC,CAAC,aAAa,YAAY,QAAQ,SAAS,IAAI,SAAS,EAAE,CAAC;QAC9D,MAAM,QAAQ,GAAG,OAAO,KAAK,MAAM;YACjC,CAAC,CAAC,aAAa,KAAK,EAAE,CAAE,qDAAqD;YAC7E,CAAC,CAAC,GAAG,WAAW,EAAE,CAAC,CAAK,8DAA8D;QACxF,KAAK,CACH,yBAAyB,UAAU,aAAa,QAAQ,YAAY;YACpE,gBAAgB,KAAK,qDAAqD;YAC1E,6DAA6D,CAC9D,CAAC;QApBc,UAAK,GAAL,KAAK,CAAQ;QAKb,gBAAW,GAAX,WAAW,CAAQ;QACnB,YAAO,GAAP,OAAO,CAAqB;QAC5B,cAAS,GAAT,SAAS,CAAS;QAClB,iBAAY,GAAZ,YAAY,CAAS;QAarC,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAzBD,gDAyBC;AAED;;;;GAIG;AACH,MAAa,4BAA6B,SAAQ,KAAK;IAEnC;IACA;IAFlB,YACkB,SAAiB,EACjB,SAAkB;QAElC,KAAK,CACH,oBAAoB,SAAS,IAAI,SAAS,CAAC,CAAC,CAAC,OAAO,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,2BAA2B;YAC/F,qDAAqD,CACtD,CAAC;QANc,cAAS,GAAT,SAAS,CAAQ;QACjB,cAAS,GAAT,SAAS,CAAS;QAMlC,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;IAC7C,CAAC;CACF;AAXD,oEAWC;AAED;;;;GAIG;AACH,MAAa,2BAA4B,SAAQ,KAAK;IAElC;IACA;IAFlB,YACkB,SAAiB,EACjB,SAAkB;QAElC,KAAK,CACH,oBAAoB,SAAS,IAAI,SAAS,CAAC,CAAC,CAAC,OAAO,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,2CAA2C;YAC/G,iDAAiD,CAClD,CAAC;QANc,cAAS,GAAT,SAAS,CAAQ;QACjB,cAAS,GAAT,SAAS,CAAS;QAMlC,IAAI,CAAC,IAAI,GAAG,6BAA6B,CAAC;IAC5C,CAAC;CACF;AAXD,kEAWC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAyWH;;;;GAIG;AACH,MAAa,kBAAmB,SAAQ,KAAK;IAEzB;IAKA;IACA;IACA;IACA;IATlB,YACkB,KAAa;IAC7B;;;OAGG;IACa,WAAmB,EACnB,OAA4B,EAC5B,SAAkB,EAClB,YAAqB;QAErC,MAAM,UAAU,GAAG,OAAO,KAAK,MAAM;YACnC,CAAC,CAAC,aAAa,SAAS,IAAI,SAAS,EAAE;YACvC,CAAC,CAAC,aAAa,YAAY,QAAQ,SAAS,IAAI,SAAS,EAAE,CAAC;QAC9D,MAAM,QAAQ,GAAG,OAAO,KAAK,MAAM;YACjC,CAAC,CAAC,aAAa,KAAK,EAAE,CAAE,qDAAqD;YAC7E,CAAC,CAAC,GAAG,WAAW,EAAE,CAAC,CAAK,8DAA8D;QACxF,KAAK,CACH,yBAAyB,UAAU,aAAa,QAAQ,YAAY;YACpE,gBAAgB,KAAK,qDAAqD;YAC1E,6DAA6D,CAC9D,CAAC;QApBc,UAAK,GAAL,KAAK,CAAQ;QAKb,gBAAW,GAAX,WAAW,CAAQ;QACnB,YAAO,GAAP,OAAO,CAAqB;QAC5B,cAAS,GAAT,SAAS,CAAS;QAClB,iBAAY,GAAZ,YAAY,CAAS;QAarC,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAzBD,gDAyBC;AAED;;;;GAIG;AACH,MAAa,4BAA6B,SAAQ,KAAK;IAEnC;IACA;IAFlB,YACkB,SAAiB,EACjB,SAAkB;QAElC,KAAK,CACH,oBAAoB,SAAS,IAAI,SAAS,CAAC,CAAC,CAAC,OAAO,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,2BAA2B;YAC/F,qDAAqD,CACtD,CAAC;QANc,cAAS,GAAT,SAAS,CAAQ;QACjB,cAAS,GAAT,SAAS,CAAS;QAMlC,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;IAC7C,CAAC;CACF;AAXD,oEAWC;AAED;;;;GAIG;AACH,MAAa,2BAA4B,SAAQ,KAAK;IAElC;IACA;IAFlB,YACkB,SAAiB,EACjB,SAAkB;QAElC,KAAK,CACH,oBAAoB,SAAS,IAAI,SAAS,CAAC,CAAC,CAAC,OAAO,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,2CAA2C;YAC/G,iDAAiD,CAClD,CAAC;QANc,cAAS,GAAT,SAAS,CAAQ;QACjB,cAAS,GAAT,SAAS,CAAS;QAMlC,IAAI,CAAC,IAAI,GAAG,6BAA6B,CAAC;IAC5C,CAAC;CACF;AAXD,kEAWC"}

package/docs/BENCHMARK.md

@@ -2,7 +2,11 @@
 
 Benchmark comparing litedbmodel with Prisma, Kysely, Drizzle, and TypeORM on PostgreSQL.
 
-> **Version:** litedbmodel **2.2.0** · PostgreSQL 16 · Apple Silicon (arm64).
+<!--@embedoc:package_version-->
+**Version:** litedbmodel **2.2.4**
+<!--@embedoc:end-->
+
+> Measured on PostgreSQL 16 · Apple Silicon (arm64).
 > Every table and the chart on this page are **regenerated from `benchmark/results/benchmark-results.csv`**
 > (`npx embedoc build` for the tables, `npm run chart` for the SVG) — the numbers here are machine-derived,
 > never hand-edited. litedbmodel's two v2 execution modes (`runtime`, `codegen`) are shown as separate series.
@@ -32,25 +36,25 @@ Reference: [Kysely performance comparison article](https://izanami.dev/post/1e3f
 <!--@embedoc:benchmark_table-->
 | Operation | litedbmodel (runtime) | litedbmodel (codegen) | Kysely | Drizzle | TypeORM | Prisma |
 | --- | --- | --- | --- | --- | --- | --- |
-| Find all (limit 100) | **0.42ms** 🏆 | 0.63ms | 0.58ms | 0.55ms | 0.66ms | 1.13ms |
-| Filter, paginate & sort | 0.65ms | **0.57ms** 🏆 | **0.57ms** 🏆 | 0.82ms | 0.90ms | 0.86ms |
-| Nested find all (include posts) | 2.39ms | **2.22ms** 🏆 | 3.10ms | 2.98ms | 6.28ms | 9.62ms |
-| Find first | 0.35ms | 0.33ms | **0.30ms** 🏆 | 0.37ms | 0.36ms | 0.52ms |
-| Nested find first (include posts) | 0.61ms | 0.69ms | 0.62ms | 0.70ms | **0.51ms** 🏆 | 1.00ms |
-| Find unique (by email) | 0.52ms | 0.33ms | **0.29ms** 🏆 | 0.40ms | 0.44ms | 0.51ms |
-| Nested find unique (include posts) | 0.76ms | 0.81ms | **0.68ms** 🏆 | 1.07ms | 1.04ms | 0.94ms |
-| Create | 0.77ms | **0.39ms** 🏆 | 0.80ms | 0.93ms | 0.85ms | 1.14ms |
-| Nested create (with post) | 1.09ms | **0.98ms** 🏆 | 1.04ms | 1.17ms | 1.26ms | 1.70ms |
-| Update | 0.82ms | **0.52ms** 🏆 | 0.67ms | 0.73ms | 0.73ms | 1.15ms |
-| Nested update (update user + post) | 0.95ms | 0.96ms | **0.90ms** 🏆 | 1.05ms | 0.99ms | 2.15ms |
-| Upsert | 0.76ms | **0.44ms** 🏆 | 0.72ms | 0.74ms | 0.93ms | 1.75ms |
-| Nested upsert (user + post) | 1.29ms | **0.99ms** 🏆 | 1.12ms | 1.24ms | 1.32ms | 2.02ms |
-| Delete | 1.04ms | **1.01ms** 🏆 | 1.04ms | 1.09ms | 1.29ms | 1.52ms |
-| Create Many (10 records) | 0.85ms | **0.41ms** 🏆 | 0.88ms | 1.20ms | 1.02ms | 1.20ms |
-| Upsert Many (10 records) | 1.28ms | **0.46ms** 🏆 | 0.77ms | 1.38ms | 1.10ms | 9.75ms |
-| Update Many (10 different values) | 1.12ms | **0.47ms** 🏆 | 2.42ms | 2.42ms | 2.49ms | 4.91ms |
-| Nested relations (100→1000→10000) | **14.43ms** 🏆 | 18.46ms | 21.11ms | 20.33ms | 74.04ms | 79.61ms |
-| Nested relations (composite key) | 27.52ms | **23.97ms** 🏆 | N/A | 74.39ms | 57.46ms | 83.78ms |
+| Find all (limit 100) | **0.48ms** 🏆 | 0.69ms | 0.92ms | 0.58ms | 0.74ms | 1.16ms |
+| Filter, paginate & sort | **0.68ms** 🏆 | **0.69ms** 🏆 | 0.75ms | 0.93ms | 1.00ms | 0.97ms |
+| Nested find all (include posts) | 2.39ms | **2.25ms** 🏆 | 3.09ms | 3.01ms | 6.41ms | 9.61ms |
+| Find first | 0.38ms | 0.39ms | **0.33ms** 🏆 | 0.52ms | 0.52ms | 0.53ms |
+| Nested find first (include posts) | **0.68ms** 🏆 | 0.88ms | 0.86ms | 0.85ms | 0.80ms | 0.98ms |
+| Find unique (by email) | 0.41ms | **0.35ms** 🏆 | 0.43ms | 0.47ms | 0.58ms | 0.61ms |
+| Nested find unique (include posts) | 0.89ms | 0.92ms | **0.81ms** 🏆 | 0.85ms | 1.36ms | 0.92ms |
+| Create | 0.80ms | **0.40ms** 🏆 | 0.89ms | 1.07ms | 0.84ms | 1.03ms |
+| Nested create (with post) | **1.00ms** 🏆 | 1.17ms | 1.01ms | 1.22ms | 1.40ms | 1.77ms |
+| Update | 0.84ms | **0.40ms** 🏆 | 0.89ms | 0.76ms | 0.75ms | 1.20ms |
+| Nested update (update user + post) | 1.22ms | 1.21ms | 1.22ms | 1.16ms | **1.14ms** 🏆 | 2.26ms |
+| Upsert | 1.03ms | **0.42ms** 🏆 | 0.84ms | 1.05ms | 1.15ms | 1.92ms |
+| Nested upsert (user + post) | 1.49ms | 1.23ms | **1.10ms** 🏆 | 1.39ms | 1.29ms | 2.09ms |
+| Delete | 1.24ms | **1.06ms** 🏆 | 1.22ms | 1.28ms | 1.27ms | 1.49ms |
+| Create Many (10 records) | 1.10ms | **0.57ms** 🏆 | 0.94ms | 1.03ms | 1.36ms | 1.19ms |
+| Upsert Many (10 records) | 1.45ms | **0.66ms** 🏆 | 1.07ms | 1.51ms | 1.57ms | 9.64ms |
+| Update Many (10 different values) | 1.20ms | **0.44ms** 🏆 | 2.42ms | 2.42ms | 2.60ms | 4.83ms |
+| Nested relations (100→1000→10000) | **14.83ms** 🏆 | 18.11ms | 20.86ms | 20.51ms | 72.09ms | 82.82ms |
+| Nested relations (composite key) | 29.00ms | **23.26ms** 🏆 | N/A | 78.53ms | 58.94ms | 82.63ms |
 <!--@embedoc:end-->
 
 *All write operations wrapped in transactions for fair comparison across all ORMs.*
@@ -58,7 +62,7 @@ Reference: [Kysely performance comparison article](https://izanami.dev/post/1e3f
 ### Analysis
 
 <!--@embedoc:benchmark_summary-->
-litedbmodel is the fastest ORM in **14 of 19** benchmarked operations.
+litedbmodel is the fastest ORM in **15 of 19** benchmarked operations.
 <!--@embedoc:end-->
 
 Every number below comes from the machine-generated table above (regenerated from
@@ -528,6 +532,6 @@ WHERE (tenant_id, user_id) IN (($1,$2),($3,$4),...,($1999,$2000))
 
 ---
 
-*Last updated: July 2026 (litedbmodel v2.0.2)*  
+*Last updated: July 2026*  
 *Benchmark methodology: Based on [Prisma orm-benchmarks](https://github.com/prisma/orm-benchmarks)*
 

package/docs/COMPARISON.md

@@ -2,9 +2,13 @@
 
 A detailed comparison of litedbmodel with popular TypeScript/JavaScript ORMs.
 
-> **Benchmark figures:** litedbmodel **2.2.0**. The only performance number on this page is the
-> machine-computed win count below; the full per-operation table lives in
-> [BENCHMARK.md](./BENCHMARK.md) (regenerated from `benchmark/results/benchmark-results.csv`).
+<!--@embedoc:package_version label="Benchmark figures"-->
+**Benchmark figures:** litedbmodel **2.2.4**
+<!--@embedoc:end-->
+
+> The only performance number on this page is the machine-computed win count below; the full
+> per-operation table lives in [BENCHMARK.md](./BENCHMARK.md) (regenerated from
+> `benchmark/results/benchmark-results.csv`).
 
 ## Quick Comparison Matrix
 
@@ -1082,7 +1086,7 @@ For detailed benchmark results comparing litedbmodel with Prisma, Kysely, Drizzl
 ### Summary
 
 <!--@embedoc:benchmark_summary-->
-litedbmodel is the fastest ORM in **14 of 19** benchmarked operations.
+litedbmodel is the fastest ORM in **15 of 19** benchmarked operations.
 <!--@embedoc:end-->
 
 | Aspect | litedbmodel |

package/docs/api/README.md

@@ -1,4 +1,4 @@
-**litedbmodel v1.0.1**
+**litedbmodel v2.2.4**
 
 ***
 

package/docs/api/classes/Conditions.md

@@ -1,4 +1,4 @@
-[**litedbmodel v1.0.1**](../README.md)
+[**litedbmodel v2.2.4**](../README.md)
 
 ***
 
@@ -6,7 +6,7 @@
 
 # Class: Conditions\<Model\>
 
-Defined in: Column.ts:628
+Defined in: [Column.ts:628](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L628)
 
 Type-safe builder for query conditions.
 Use array literals for static conditions, builder for dynamic construction.
@@ -47,7 +47,7 @@ if (query.active) where.add(User.is_active, true);
 new Conditions<Model>(initial?: Conds): Conditions<Model>;
 ```
 
-Defined in: Column.ts:634
+Defined in: [Column.ts:634](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L634)
 
 Create a Conditions builder, optionally with initial conditions.
 
@@ -71,7 +71,7 @@ Create a Conditions builder, optionally with initial conditions.
 get length(): number;
 ```
 
-Defined in: Column.ts:700
+Defined in: [Column.ts:700](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L700)
 
 Get the number of conditions.
 
@@ -87,7 +87,7 @@ Get the number of conditions.
 add<V>(column: Column<V, Model>, value: V | null | undefined): this;
 ```
 
-Defined in: Column.ts:643
+Defined in: [Column.ts:643](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L643)
 
 Add a type-safe column equality condition.
 
@@ -116,7 +116,7 @@ Add a type-safe column equality condition.
 addRaw(condition: string, value?: unknown): this;
 ```
 
-Defined in: Column.ts:651
+Defined in: [Column.ts:651](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L651)
 
 Add a raw condition with template literal (e.g., `${User.age} > ?`).
 
@@ -141,7 +141,7 @@ Add a raw condition with template literal (e.g., `${User.age} > ?`).
 addSql<V>(fragment: SqlTypedFragment<V, Model>, value: V): this;
 ```
 
-Defined in: Column.ts:670
+Defined in: [Column.ts:670](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L670)
 
 Add a type-safe sql-tagged condition.
 
@@ -176,7 +176,7 @@ where.addSql(sql`${User.deleted_at} IS NULL`);
 addSql(fragment: SqlTypedFragment<any, Model>): this;
 ```
 
-Defined in: Column.ts:671
+Defined in: [Column.ts:671](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L671)
 
 Add a type-safe sql-tagged condition.
 
@@ -206,7 +206,7 @@ where.addSql(sql`${User.deleted_at} IS NULL`);
 or(...condGroups: readonly Conds[]): this;
 ```
 
-Defined in: Column.ts:685
+Defined in: [Column.ts:685](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L685)
 
 Add an OR condition group.
 
@@ -228,7 +228,7 @@ Add an OR condition group.
 build(): Conds;
 ```
 
-Defined in: Column.ts:693
+Defined in: [Column.ts:693](https://github.com/foo-ogawa/litedbmodel/blob/main/src/Column.ts#L693)
 
 Build the final array for use with find/count/delete.
 

package/docs/api/classes/DBHandler.md

@@ -1,4 +1,4 @@
-[**litedbmodel v1.0.1**](../README.md)
+[**litedbmodel v2.2.4**](../README.md)
 
 ***
 
@@ -6,7 +6,7 @@
 
 # Class: DBHandler
 
-Defined in: DBHandler.ts:174
+Defined in: [DBHandler.ts:179](https://github.com/foo-ogawa/litedbmodel/blob/main/src/DBHandler.ts#L179)
 
 Database handler - wraps a driver and provides a unified interface.
 
@@ -30,7 +30,7 @@ const result = await handler.execute('SELECT * FROM users WHERE id = $1', [1]);
 new DBHandler(config: DBConfig, options?: DBHandlerOptions): DBHandler;
 ```
 
-Defined in: DBHandler.ts:180
+Defined in: [DBHandler.ts:185](https://github.com/foo-ogawa/litedbmodel/blob/main/src/DBHandler.ts#L185)
 
 #### Parameters
 
@@ -51,7 +51,7 @@ Defined in: DBHandler.ts:180
 getDriverType(): "postgres" | "mysql" | "sqlite";
 ```
 
-Defined in: DBHandler.ts:198
+Defined in: [DBHandler.ts:203](https://github.com/foo-ogawa/litedbmodel/blob/main/src/DBHandler.ts#L203)
 
 Get the driver type
 
@@ -67,7 +67,7 @@ Get the driver type
 getDriver(): DBDriver;
 ```
 
-Defined in: DBHandler.ts:205
+Defined in: [DBHandler.ts:210](https://github.com/foo-ogawa/litedbmodel/blob/main/src/DBHandler.ts#L210)
 
 Get the underlying driver
 
@@ -80,10 +80,10 @@ Get the underlying driver
 ### execute()
 
 ```ts
-execute(sql: string, params: unknown[]): Promise<QueryResult>;
+execute(sql: string, params?: unknown[]): Promise<QueryResult>;
 ```
 
-Defined in: DBHandler.ts:212
+Defined in: [DBHandler.ts:217](https://github.com/foo-ogawa/litedbmodel/blob/main/src/DBHandler.ts#L217)
 
 Execute a SQL query
 
@@ -103,10 +103,10 @@ Execute a SQL query
 ### executeWrite()
 
 ```ts
-executeWrite(sql: string, params: unknown[]): Promise<QueryResult>;
+executeWrite(sql: string, params?: unknown[]): Promise<QueryResult>;
 ```
 
-Defined in: DBHandler.ts:222
+Defined in: [DBHandler.ts:227](https://github.com/foo-ogawa/litedbmodel/blob/main/src/DBHandler.ts#L227)
 
 Execute a write query (INSERT/UPDATE/DELETE)
 
@@ -126,10 +126,10 @@ Execute a write query (INSERT/UPDATE/DELETE)
 ### executeOnWriter()
 
 ```ts
-executeOnWriter(sql: string, params: unknown[]): Promise<QueryResult>;
+executeOnWriter(sql: string, params?: unknown[]): Promise<QueryResult>;
 ```
 
-Defined in: DBHandler.ts:232
+Defined in: [DBHandler.ts:237](https://github.com/foo-ogawa/litedbmodel/blob/main/src/DBHandler.ts#L237)
 
 Execute a query on writer pool (for withWriter context)
 
@@ -152,7 +152,7 @@ Execute a query on writer pool (for withWriter context)
 hasWriterPool(): boolean;
 ```
 
-Defined in: DBHandler.ts:242
+Defined in: [DBHandler.ts:247](https://github.com/foo-ogawa/litedbmodel/blob/main/src/DBHandler.ts#L247)
 
 Check if writer pool is configured
 
@@ -168,7 +168,7 @@ Check if writer pool is configured
 getConnection(): Promise<DBConnection>;
 ```
 
-Defined in: DBHandler.ts:249
+Defined in: [DBHandler.ts:254](https://github.com/foo-ogawa/litedbmodel/blob/main/src/DBHandler.ts#L254)
 
 Get a connection from the pool (for transactions)
 
@@ -184,7 +184,7 @@ Get a connection from the pool (for transactions)
 withConnection(connection: DBConnection): DBHandler;
 ```
 
-Defined in: DBHandler.ts:256
+Defined in: [DBHandler.ts:261](https://github.com/foo-ogawa/litedbmodel/blob/main/src/DBHandler.ts#L261)
 
 Create handler with specific connection (for transaction)
 
@@ -206,7 +206,7 @@ Create handler with specific connection (for transaction)
 close(): Promise<void>;
 ```
 
-Defined in: DBHandler.ts:268
+Defined in: [DBHandler.ts:273](https://github.com/foo-ogawa/litedbmodel/blob/main/src/DBHandler.ts#L273)
 
 Close all connections
 
@@ -222,7 +222,7 @@ Close all connections
 setLogger(logger: Logger): void;
 ```
 
-Defined in: DBHandler.ts:275
+Defined in: [DBHandler.ts:280](https://github.com/foo-ogawa/litedbmodel/blob/main/src/DBHandler.ts#L280)
 
 Set logger
 
@@ -244,7 +244,7 @@ Set logger
 getPool(): unknown;
 ```
 
-Defined in: DBHandler.ts:284
+Defined in: [DBHandler.ts:289](https://github.com/foo-ogawa/litedbmodel/blob/main/src/DBHandler.ts#L289)
 
 Get the underlying PostgreSQL pool (for backward compatibility)