@hexaijs/sqlite 0.3.0 → 0.5.0

package/README.md

@@ -28,7 +28,7 @@ npm install @hexaijs/sqlite
 **Peer dependencies:**
 
 ```bash
-npm install @hexaijs/core sqlite sqlite3
+npm install @hexaijs/core better-sqlite3
 ```
 
 ## Core Concepts
@@ -38,15 +38,11 @@ npm install @hexaijs/core sqlite sqlite3
 The `SqliteUnitOfWork` implements `UnitOfWork<Database>` from `@hexaijs/core`. It manages transaction lifecycle for a given SQLite database connection.
 
 ```typescript
-import { open } from "sqlite";
-import sqlite3 from "sqlite3";
+import Database from "better-sqlite3";
 import { SqliteUnitOfWork } from "@hexaijs/sqlite";
 
 // Create an in-memory database
-const db = await open({
-    filename: ":memory:",
-    driver: sqlite3.Database,
-});
+const db = new Database(":memory:");
 
 // Create unit of work
 const unitOfWork = new SqliteUnitOfWork(db);
@@ -61,8 +57,8 @@ Use `scope()` to define a transaction boundary:
 ```typescript
 const result = await unitOfWork.scope(async () => {
     const db = unitOfWork.getClient();
-    await db.run("INSERT INTO orders (id, status) VALUES (?, ?)", [orderId, "pending"]);
-    await db.run("INSERT INTO order_items (order_id, product_id) VALUES (?, ?)", [orderId, productId]);
+    db.prepare("INSERT INTO orders (id, status) VALUES (?, ?)").run(orderId, "pending");
+    db.prepare("INSERT INTO order_items (order_id, product_id) VALUES (?, ?)").run(orderId, productId);
     return { orderId };
 });
 // Transaction commits if successful
@@ -73,7 +69,7 @@ const result = await unitOfWork.scope(async () => {
 ```typescript
 /** @deprecated Use scope() instead. */
 const result = await unitOfWork.wrap(async (db) => {
-    await db.run("INSERT INTO orders (id, status) VALUES (?, ?)", [orderId, "pending"]);
+    db.prepare("INSERT INTO orders (id, status) VALUES (?, ?)").run(orderId, "pending");
     return { orderId };
 });
 ```
@@ -84,7 +80,7 @@ If an error is thrown, the transaction rolls back:
 try {
     await unitOfWork.scope(async () => {
         const db = unitOfWork.getClient();
-        await db.run("INSERT INTO orders (id, status) VALUES (?, ?)", [orderId, "pending"]);
+        db.prepare("INSERT INTO orders (id, status) VALUES (?, ?)").run(orderId, "pending");
         throw new Error("Something went wrong");
     });
 } catch (error) {
@@ -99,11 +95,44 @@ Within a transaction, access the database through `getClient()`:
 ```typescript
 // Inside a command handler
 const db = ctx.getUnitOfWork().getClient();
-await db.run("UPDATE orders SET status = ? WHERE id = ?", ["confirmed", orderId]);
+db.prepare("UPDATE orders SET status = ? WHERE id = ?").run("confirmed", orderId);
 ```
 
 Note: `getClient()` throws an error if called outside of a `scope()` or `wrap()` call.
 
+### Transaction Lifecycle Hooks
+
+Register callbacks that execute at specific points in the transaction lifecycle:
+
+```typescript
+await unitOfWork.scope(async () => {
+    unitOfWork.beforeCommit(() => {
+        // Validate before committing
+    });
+
+    unitOfWork.afterCommit(() => {
+        // Notify after successful commit
+    });
+
+    unitOfWork.afterRollback(() => {
+        // Clean up on failure
+    });
+
+    const db = unitOfWork.getClient();
+    db.prepare("INSERT INTO orders (id, status) VALUES (?, ?)").run(orderId, "pending");
+});
+```
+
+Hooks follow the same semantics as `@hexaijs/postgres`:
+
+| Hook | When | On failure |
+|------|------|------------|
+| `beforeCommit` | Before COMMIT | Transaction rolls back instead |
+| `afterCommit` | After COMMIT | Best-effort (errors → `AggregateError`) |
+| `afterRollback` | After ROLLBACK | Best-effort (errors → `AggregateError`) |
+
+Hooks are scope-local and can only be registered inside an active `scope()`.
+
 ### Nested Transactions
 
 Nested `scope()` calls participate in the same transaction:
@@ -111,11 +140,11 @@ Nested `scope()` calls participate in the same transaction:
 ```typescript
 await unitOfWork.scope(async () => {
     const db = unitOfWork.getClient();
-    await db.run("INSERT INTO orders (id) VALUES (?)", ["order-1"]);
+    db.prepare("INSERT INTO orders (id) VALUES (?)").run("order-1");
 
     await unitOfWork.scope(async () => {
         const db = unitOfWork.getClient();
-        await db.run("INSERT INTO order_items (order_id) VALUES (?)", ["order-1"]);
+        db.prepare("INSERT INTO order_items (order_id) VALUES (?)").run("order-1");
     });
     // Both inserts are in the same transaction
 });
@@ -128,11 +157,11 @@ If any nested call throws, the entire transaction rolls back:
 try {
     await unitOfWork.scope(async () => {
         const db = unitOfWork.getClient();
-        await db.run("INSERT INTO orders (id) VALUES (?)", ["order-1"]);
+        db.prepare("INSERT INTO orders (id) VALUES (?)").run("order-1");
 
         await unitOfWork.scope(async () => {
             const db = unitOfWork.getClient();
-            await db.run("INSERT INTO order_items (order_id) VALUES (?)", ["order-1"]);
+            db.prepare("INSERT INTO order_items (order_id) VALUES (?)").run("order-1");
             throw new Error("Nested failure");
         });
     });
@@ -148,7 +177,7 @@ try {
 Use the test utilities for fast, isolated integration tests:
 
 ```typescript
-import type { Database } from "sqlite";
+import type { Database } from "better-sqlite3";
 import { SqliteUnitOfWork } from "@hexaijs/sqlite";
 import { getSqliteConnection } from "@hexaijs/sqlite/test";
 
@@ -156,12 +185,12 @@ describe("OrderRepository", () => {
     let db: Database;
     let unitOfWork: SqliteUnitOfWork;
 
-    beforeEach(async () => {
+    beforeEach(() => {
         // Create fresh in-memory database
-        db = await getSqliteConnection();
+        db = getSqliteConnection();
 
         // Create schema
-        await db.run(`
+        db.exec(`
             CREATE TABLE orders (
                 id TEXT PRIMARY KEY,
                 status TEXT NOT NULL
@@ -171,17 +200,17 @@ describe("OrderRepository", () => {
         unitOfWork = new SqliteUnitOfWork(db);
     });
 
-    afterEach(async () => {
-        await db.close();
+    afterEach(() => {
+        db.close();
     });
 
     it("should persist orders", async () => {
         await unitOfWork.scope(async () => {
             const db = unitOfWork.getClient();
-            await db.run("INSERT INTO orders (id, status) VALUES (?, ?)", ["order-1", "pending"]);
+            db.prepare("INSERT INTO orders (id, status) VALUES (?, ?)").run("order-1", "pending");
         });
 
-        const result = await db.get("SELECT * FROM orders WHERE id = ?", ["order-1"]);
+        const result = db.prepare("SELECT * FROM orders WHERE id = ?").get("order-1") as any;
         expect(result.status).toBe("pending");
     });
 });
@@ -218,7 +247,7 @@ interface OrderMemento {
 }
 
 // Create repository
-const db = await getSqliteConnection();
+const db = getSqliteConnection();
 const orderRepository = new SqliteRepositoryForTest<Order, OrderMemento>(db, {
     namespace: "orders",
     hydrate: (m) => new Order(new OrderId(m.id), m.status),
@@ -242,7 +271,7 @@ For scenarios requiring persistence across test runs or debugging:
 import { getSqliteConnection } from "@hexaijs/sqlite/test";
 
 // File-based database instead of in-memory
-const db = await getSqliteConnection("./test-database.sqlite");
+const db = getSqliteConnection("./test-database.sqlite");
 ```
 
 ## API Highlights

package/dist/index.d.ts

@@ -1,13 +1,17 @@
-import { Database } from 'sqlite';
-import { UnitOfWork } from '@hexaijs/core';
+import { Database } from 'better-sqlite3';
+import { UnitOfWork, TransactionHook } from '@hexaijs/core';
 
 declare class SqliteUnitOfWork implements UnitOfWork<Database> {
     private db;
     private static transactions;
     constructor(db: Database);
     getClient(): Database;
+    beforeCommit(hook: TransactionHook): void;
+    afterCommit(hook: TransactionHook): void;
+    afterRollback(hook: TransactionHook): void;
     scope<T>(fn: () => Promise<T>): Promise<T>;
     wrap<T>(fn: (client: Database) => Promise<T>): Promise<T>;
+    private getRequiredState;
 }
 
 export { SqliteUnitOfWork };

package/dist/index.js

@@ -1,3 +1,5 @@
+import { TransactionHooks } from '@hexaijs/core';
+
 // src/sqlite-unit-of-work.ts
 var SqliteUnitOfWork = class _SqliteUnitOfWork {
   constructor(db) {
@@ -5,7 +7,8 @@ var SqliteUnitOfWork = class _SqliteUnitOfWork {
     if (!_SqliteUnitOfWork.transactions.has(db)) {
       _SqliteUnitOfWork.transactions.set(db, {
         level: 0,
-        aborted: false
+        aborted: false,
+        hooks: new TransactionHooks()
       });
     }
   }
@@ -17,31 +20,70 @@ var SqliteUnitOfWork = class _SqliteUnitOfWork {
     }
     return this.db;
   }
+  beforeCommit(hook) {
+    const current = this.getRequiredState("beforeCommit");
+    current.hooks.addBeforeCommit(hook);
+  }
+  afterCommit(hook) {
+    const current = this.getRequiredState("afterCommit");
+    current.hooks.addAfterCommit(hook);
+  }
+  afterRollback(hook) {
+    const current = this.getRequiredState("afterRollback");
+    current.hooks.addAfterRollback(hook);
+  }
   async scope(fn) {
     return this.wrap(fn);
   }
   async wrap(fn) {
     const current = _SqliteUnitOfWork.transactions.get(this.db);
     if (++current.level === 1) {
-      await this.db.run("BEGIN TRANSACTION");
+      this.db.exec("BEGIN TRANSACTION");
     }
+    let abortError;
     try {
       return await fn(this.db);
     } catch (e) {
       if (!current.aborted) {
         current.aborted = true;
       }
+      abortError = e;
       throw e;
     } finally {
       if (--current.level === 0) {
-        if (current.aborted) {
-          await this.db.run("ROLLBACK");
+        const hooks = current.hooks;
+        const wasAborted = current.aborted;
+        current.hooks = new TransactionHooks();
+        current.aborted = false;
+        if (wasAborted) {
+          await hooks.executeRollback(
+            async () => {
+              this.db.exec("ROLLBACK");
+            },
+            abortError
+          );
         } else {
-          await this.db.run("COMMIT");
+          await hooks.executeCommit(
+            async () => {
+              this.db.exec("COMMIT");
+            },
+            async () => {
+              this.db.exec("ROLLBACK");
+            }
+          );
         }
       }
     }
   }
+  getRequiredState(hookName) {
+    const current = _SqliteUnitOfWork.transactions.get(this.db);
+    if (!current || current.level === 0) {
+      throw new Error(
+        `Cannot register ${hookName} hook outside of a transaction scope`
+      );
+    }
+    return current;
+  }
 };
 
 export { SqliteUnitOfWork };

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/sqlite-unit-of-work.ts"],"names":[],"mappings":";AAIO,IAAM,gBAAA,GAAN,MAAM,iBAAA,CAAiD;AAAA,EAS1D,YAAoB,EAAA,EAAc;AAAd,IAAA,IAAA,CAAA,EAAA,GAAA,EAAA;AAChB,IAAA,IAAI,CAAC,iBAAA,CAAiB,YAAA,CAAa,GAAA,CAAI,EAAE,CAAA,EAAG;AACxC,MAAA,iBAAA,CAAiB,YAAA,CAAa,IAAI,EAAA,EAAI;AAAA,QAClC,KAAA,EAAO,CAAA;AAAA,QACP,OAAA,EAAS;AAAA,OACZ,CAAA;AAAA,IACL;AAAA,EACJ;AAAA,EAfA,OAAe,YAAA,mBAAe,IAAI,OAAA,EAMhC;AAAA,EAWF,SAAA,GAAsB;AAClB,IAAA,MAAM,OAAA,GAAU,iBAAA,CAAiB,YAAA,CAAa,GAAA,CAAI,KAAK,EAAE,CAAA;AACzD,IAAA,IAAI,CAAC,OAAA,IAAW,OAAA,CAAQ,KAAA,KAAU,CAAA,EAAG;AACjC,MAAA,MAAM,IAAI,MAAM,0BAA0B,CAAA;AAAA,IAC9C;AACA,IAAA,OAAO,IAAA,CAAK,EAAA;AAAA,EAChB;AAAA,EAEA,MAAM,MAAS,EAAA,EAAkC;AAC7C,IAAA,OAAO,IAAA,CAAK,KAAK,EAAE,CAAA;AAAA,EACvB;AAAA,EAEA,MAAM,KAAQ,EAAA,EAAkD;AAC5D,IAAA,MAAM,OAAA,GAAU,iBAAA,CAAiB,YAAA,CAAa,GAAA,CAAI,KAAK,EAAE,CAAA;AACzD,IAAA,IAAI,EAAE,OAAA,CAAQ,KAAA,KAAU,CAAA,EAAG;AACvB,MAAA,MAAM,IAAA,CAAK,EAAA,CAAG,GAAA,CAAI,mBAAmB,CAAA;AAAA,IACzC;AAEA,IAAA,IAAI;AACA,MAAA,OAAO,MAAM,EAAA,CAAG,IAAA,CAAK,EAAE,CAAA;AAAA,IAC3B,SAAS,CAAA,EAAG;AACR,MAAA,IAAI,CAAC,QAAQ,OAAA,EAAS;AAClB,QAAA,OAAA,CAAQ,OAAA,GAAU,IAAA;AAAA,MACtB;AAEA,MAAA,MAAM,CAAA;AAAA,IACV,CAAA,SAAE;AACE,MAAA,IAAI,EAAE,OAAA,CAAQ,KAAA,KAAU,CAAA,EAAG;AACvB,QAAA,IAAI,QAAQ,OAAA,EAAS;AACjB,UAAA,MAAM,IAAA,CAAK,EAAA,CAAG,GAAA,CAAI,UAAU,CAAA;AAAA,QAChC,CAAA,MAAO;AACH,UAAA,MAAM,IAAA,CAAK,EAAA,CAAG,GAAA,CAAI,QAAQ,CAAA;AAAA,QAC9B;AAAA,MACJ;AAAA,IACJ;AAAA,EACJ;AACJ","file":"index.js","sourcesContent":["import type { Database } from \"sqlite\";\n\nimport { UnitOfWork } from \"@hexaijs/core\";\n\nexport class SqliteUnitOfWork implements UnitOfWork<Database> {\n    private static transactions = new WeakMap<\n        Database,\n        {\n            level: number;\n            aborted: boolean;\n        }\n    >();\n\n    constructor(private db: Database) {\n        if (!SqliteUnitOfWork.transactions.has(db)) {\n            SqliteUnitOfWork.transactions.set(db, {\n                level: 0,\n                aborted: false,\n            });\n        }\n    }\n\n    getClient(): Database {\n        const current = SqliteUnitOfWork.transactions.get(this.db);\n        if (!current || current.level === 0) {\n            throw new Error(\"No transaction is active\");\n        }\n        return this.db;\n    }\n\n    async scope<T>(fn: () => Promise<T>): Promise<T> {\n        return this.wrap(fn);\n    }\n\n    async wrap<T>(fn: (client: Database) => Promise<T>): Promise<T> {\n        const current = SqliteUnitOfWork.transactions.get(this.db)!;\n        if (++current.level === 1) {\n            await this.db.run(\"BEGIN TRANSACTION\");\n        }\n\n        try {\n            return await fn(this.db);\n        } catch (e) {\n            if (!current.aborted) {\n                current.aborted = true;\n            }\n\n            throw e;\n        } finally {\n            if (--current.level === 0) {\n                if (current.aborted) {\n                    await this.db.run(\"ROLLBACK\");\n                } else {\n                    await this.db.run(\"COMMIT\");\n                }\n            }\n        }\n    }\n}\n"]}
+{"version":3,"sources":["../src/sqlite-unit-of-work.ts"],"names":[],"mappings":";;;AAKO,IAAM,gBAAA,GAAN,MAAM,iBAAA,CAAiD;AAAA,EAU1D,YAAoB,EAAA,EAAc;AAAd,IAAA,IAAA,CAAA,EAAA,GAAA,EAAA;AAChB,IAAA,IAAI,CAAC,iBAAA,CAAiB,YAAA,CAAa,GAAA,CAAI,EAAE,CAAA,EAAG;AACxC,MAAA,iBAAA,CAAiB,YAAA,CAAa,IAAI,EAAA,EAAI;AAAA,QAClC,KAAA,EAAO,CAAA;AAAA,QACP,OAAA,EAAS,KAAA;AAAA,QACT,KAAA,EAAO,IAAI,gBAAA;AAAiB,OAC/B,CAAA;AAAA,IACL;AAAA,EACJ;AAAA,EAjBA,OAAe,YAAA,mBAAe,IAAI,OAAA,EAOhC;AAAA,EAYF,SAAA,GAAsB;AAClB,IAAA,MAAM,OAAA,GAAU,iBAAA,CAAiB,YAAA,CAAa,GAAA,CAAI,KAAK,EAAE,CAAA;AACzD,IAAA,IAAI,CAAC,OAAA,IAAW,OAAA,CAAQ,KAAA,KAAU,CAAA,EAAG;AACjC,MAAA,MAAM,IAAI,MAAM,0BAA0B,CAAA;AAAA,IAC9C;AACA,IAAA,OAAO,IAAA,CAAK,EAAA;AAAA,EAChB;AAAA,EAEA,aAAa,IAAA,EAA6B;AACtC,IAAA,MAAM,OAAA,GAAU,IAAA,CAAK,gBAAA,CAAiB,cAAc,CAAA;AACpD,IAAA,OAAA,CAAQ,KAAA,CAAM,gBAAgB,IAAI,CAAA;AAAA,EACtC;AAAA,EAEA,YAAY,IAAA,EAA6B;AACrC,IAAA,MAAM,OAAA,GAAU,IAAA,CAAK,gBAAA,CAAiB,aAAa,CAAA;AACnD,IAAA,OAAA,CAAQ,KAAA,CAAM,eAAe,IAAI,CAAA;AAAA,EACrC;AAAA,EAEA,cAAc,IAAA,EAA6B;AACvC,IAAA,MAAM,OAAA,GAAU,IAAA,CAAK,gBAAA,CAAiB,eAAe,CAAA;AACrD,IAAA,OAAA,CAAQ,KAAA,CAAM,iBAAiB,IAAI,CAAA;AAAA,EACvC;AAAA,EAEA,MAAM,MAAS,EAAA,EAAkC;AAC7C,IAAA,OAAO,IAAA,CAAK,KAAK,EAAE,CAAA;AAAA,EACvB;AAAA,EAEA,MAAM,KAAQ,EAAA,EAAkD;AAC5D,IAAA,MAAM,OAAA,GAAU,iBAAA,CAAiB,YAAA,CAAa,GAAA,CAAI,KAAK,EAAE,CAAA;AACzD,IAAA,IAAI,EAAE,OAAA,CAAQ,KAAA,KAAU,CAAA,EAAG;AACvB,MAAA,IAAA,CAAK,EAAA,CAAG,KAAK,mBAAmB,CAAA;AAAA,IACpC;AAEA,IAAA,IAAI,UAAA;AACJ,IAAA,IAAI;AACA,MAAA,OAAO,MAAM,EAAA,CAAG,IAAA,CAAK,EAAE,CAAA;AAAA,IAC3B,SAAS,CAAA,EAAG;AACR,MAAA,IAAI,CAAC,QAAQ,OAAA,EAAS;AAClB,QAAA,OAAA,CAAQ,OAAA,GAAU,IAAA;AAAA,MACtB;AACA,MAAA,UAAA,GAAa,CAAA;AAEb,MAAA,MAAM,CAAA;AAAA,IACV,CAAA,SAAE;AACE,MAAA,IAAI,EAAE,OAAA,CAAQ,KAAA,KAAU,CAAA,EAAG;AACvB,QAAA,MAAM,QAAQ,OAAA,CAAQ,KAAA;AACtB,QAAA,MAAM,aAAa,OAAA,CAAQ,OAAA;AAE3B,QAAA,OAAA,CAAQ,KAAA,GAAQ,IAAI,gBAAA,EAAiB;AACrC,QAAA,OAAA,CAAQ,OAAA,GAAU,KAAA;AAElB,QAAA,IAAI,UAAA,EAAY;AACZ,UAAA,MAAM,KAAA,CAAM,eAAA;AAAA,YACR,YAAY;AAAE,cAAA,IAAA,CAAK,EAAA,CAAG,KAAK,UAAU,CAAA;AAAA,YAAG,CAAA;AAAA,YACxC;AAAA,WACJ;AAAA,QACJ,CAAA,MAAO;AACH,UAAA,MAAM,KAAA,CAAM,aAAA;AAAA,YACR,YAAY;AAAE,cAAA,IAAA,CAAK,EAAA,CAAG,KAAK,QAAQ,CAAA;AAAA,YAAG,CAAA;AAAA,YACtC,YAAY;AAAE,cAAA,IAAA,CAAK,EAAA,CAAG,KAAK,UAAU,CAAA;AAAA,YAAG;AAAA,WAC5C;AAAA,QACJ;AAAA,MACJ;AAAA,IACJ;AAAA,EACJ;AAAA,EAEQ,iBAAiB,QAAA,EAAkB;AACvC,IAAA,MAAM,OAAA,GAAU,iBAAA,CAAiB,YAAA,CAAa,GAAA,CAAI,KAAK,EAAE,CAAA;AACzD,IAAA,IAAI,CAAC,OAAA,IAAW,OAAA,CAAQ,KAAA,KAAU,CAAA,EAAG;AACjC,MAAA,MAAM,IAAI,KAAA;AAAA,QACN,mBAAmB,QAAQ,CAAA,oCAAA;AAAA,OAC/B;AAAA,IACJ;AACA,IAAA,OAAO,OAAA;AAAA,EACX;AACJ","file":"index.js","sourcesContent":["import type { Database } from \"better-sqlite3\";\n\nimport { TransactionHooks, UnitOfWork } from \"@hexaijs/core\";\nimport type { TransactionHook } from \"@hexaijs/core\";\n\nexport class SqliteUnitOfWork implements UnitOfWork<Database> {\n    private static transactions = new WeakMap<\n        Database,\n        {\n            level: number;\n            aborted: boolean;\n            hooks: TransactionHooks;\n        }\n    >();\n\n    constructor(private db: Database) {\n        if (!SqliteUnitOfWork.transactions.has(db)) {\n            SqliteUnitOfWork.transactions.set(db, {\n                level: 0,\n                aborted: false,\n                hooks: new TransactionHooks(),\n            });\n        }\n    }\n\n    getClient(): Database {\n        const current = SqliteUnitOfWork.transactions.get(this.db);\n        if (!current || current.level === 0) {\n            throw new Error(\"No transaction is active\");\n        }\n        return this.db;\n    }\n\n    beforeCommit(hook: TransactionHook): void {\n        const current = this.getRequiredState(\"beforeCommit\");\n        current.hooks.addBeforeCommit(hook);\n    }\n\n    afterCommit(hook: TransactionHook): void {\n        const current = this.getRequiredState(\"afterCommit\");\n        current.hooks.addAfterCommit(hook);\n    }\n\n    afterRollback(hook: TransactionHook): void {\n        const current = this.getRequiredState(\"afterRollback\");\n        current.hooks.addAfterRollback(hook);\n    }\n\n    async scope<T>(fn: () => Promise<T>): Promise<T> {\n        return this.wrap(fn);\n    }\n\n    async wrap<T>(fn: (client: Database) => Promise<T>): Promise<T> {\n        const current = SqliteUnitOfWork.transactions.get(this.db)!;\n        if (++current.level === 1) {\n            this.db.exec(\"BEGIN TRANSACTION\");\n        }\n\n        let abortError: unknown;\n        try {\n            return await fn(this.db);\n        } catch (e) {\n            if (!current.aborted) {\n                current.aborted = true;\n            }\n            abortError = e;\n\n            throw e;\n        } finally {\n            if (--current.level === 0) {\n                const hooks = current.hooks;\n                const wasAborted = current.aborted;\n\n                current.hooks = new TransactionHooks();\n                current.aborted = false;\n\n                if (wasAborted) {\n                    await hooks.executeRollback(\n                        async () => { this.db.exec(\"ROLLBACK\"); },\n                        abortError\n                    );\n                } else {\n                    await hooks.executeCommit(\n                        async () => { this.db.exec(\"COMMIT\"); },\n                        async () => { this.db.exec(\"ROLLBACK\"); }\n                    );\n                }\n            }\n        }\n    }\n\n    private getRequiredState(hookName: string) {\n        const current = SqliteUnitOfWork.transactions.get(this.db);\n        if (!current || current.level === 0) {\n            throw new Error(\n                `Cannot register ${hookName} hook outside of a transaction scope`\n            );\n        }\n        return current;\n    }\n}\n"]}

package/dist/test/index.d.ts

@@ -1,4 +1,4 @@
-import { Database } from 'sqlite';
+import { Database } from 'better-sqlite3';
 import { Identifiable, Repository, IdOf } from '@hexaijs/core';
 
 declare class SqliteRepositoryForTest<E extends Identifiable<any>, M> implements Repository<E> {
@@ -15,9 +15,9 @@ declare class SqliteRepositoryForTest<E extends Identifiable<any>, M> implements
     add(entity: E): Promise<void>;
     update(entity: E): Promise<void>;
     count(): Promise<number>;
-    protected ensureTableExists(): Promise<void>;
+    protected ensureTableExists(): void;
 }
 
-declare function getSqliteConnection(filename?: string): Promise<Database>;
+declare function getSqliteConnection(filename?: string): Database;
 
 export { SqliteRepositoryForTest, getSqliteConnection };

package/dist/test/index.js

@@ -1,4 +1,5 @@
 import { ObjectNotFoundError, DuplicateObjectError } from '@hexaijs/core';
+import Database from 'better-sqlite3';
 
 // src/test/sqlite-repository-for-test.ts
 var SqliteRepositoryForTest = class {
@@ -16,11 +17,10 @@ var SqliteRepositoryForTest = class {
   hydrate;
   dehydrate;
   async get(id) {
-    await this.ensureTableExists();
-    const row = await this.db.get(
-      `SELECT * FROM ${this.namespace} WHERE id = ?`,
-      id.getValue()
-    );
+    this.ensureTableExists();
+    const row = this.db.prepare(
+      `SELECT * FROM ${this.namespace} WHERE id = ?`
+    ).get(id.getValue());
     if (!row) {
       throw new ObjectNotFoundError(
         `entity with id '${id.getValue()}' not found`
@@ -29,11 +29,12 @@ var SqliteRepositoryForTest = class {
     return this.hydrate(JSON.parse(row.data));
   }
   async add(entity) {
-    await this.ensureTableExists();
+    this.ensureTableExists();
     try {
-      await this.db.run(
+      this.db.prepare(
         `INSERT INTO ${this.namespace} (id, data)
-                 VALUES (?, ?)`,
+                 VALUES (?, ?)`
+      ).run(
         entity.getId().getValue(),
         JSON.stringify(this.dehydrate(entity))
       );
@@ -47,11 +48,12 @@ var SqliteRepositoryForTest = class {
     }
   }
   async update(entity) {
-    await this.ensureTableExists();
-    const result = await this.db.run(
+    this.ensureTableExists();
+    const result = this.db.prepare(
       `UPDATE ${this.namespace}
                  SET data = ?
-                 WHERE id = ?`,
+                 WHERE id = ?`
+    ).run(
       JSON.stringify(this.dehydrate(entity)),
       entity.getId().getValue()
     );
@@ -62,14 +64,14 @@ var SqliteRepositoryForTest = class {
     }
   }
   async count() {
-    await this.ensureTableExists();
-    const result = await this.db.get(
+    this.ensureTableExists();
+    const result = this.db.prepare(
       `SELECT COUNT(*) AS count FROM ${this.namespace}`
-    );
+    ).get();
     return result.count;
   }
-  async ensureTableExists() {
-    await this.db.run(`
+  ensureTableExists() {
+    this.db.exec(`
             CREATE TABLE IF NOT EXISTS ${this.namespace} (
                 id TEXT NOT NULL PRIMARY KEY UNIQUE,
                 data TEXT NOT NULL
@@ -77,15 +79,8 @@ var SqliteRepositoryForTest = class {
         `);
   }
 };
-
-// src/test/utils.ts
-async function getSqliteConnection(filename = ":memory:") {
-  const sqlite = await import('sqlite');
-  const sqlite3 = await import('sqlite3');
-  return await sqlite.open({
-    filename,
-    driver: sqlite3.default.Database
-  });
+function getSqliteConnection(filename = ":memory:") {
+  return new Database(filename);
 }
 
 export { SqliteRepositoryForTest, getSqliteConnection };

package/dist/test/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/test/sqlite-repository-for-test.ts","../../src/test/utils.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type { Database } from \"sqlite\";\n\nimport {\n    DuplicateObjectError,\n    Identifiable,\n    IdOf,\n    ObjectNotFoundError,\n    Repository,\n} from \"@hexaijs/core\";\n\nexport class SqliteRepositoryForTest<\n    E extends Identifiable<any>,\n    M,\n> implements Repository<E> {\n    protected namespace: string;\n    protected hydrate: (memento: M) => E;\n    protected dehydrate: (entity: E) => M;\n\n    constructor(\n        protected db: Database,\n        {\n            namespace,\n            hydrate,\n            dehydrate,\n        }: {\n            namespace: string;\n            hydrate: (memento: M) => E;\n            dehydrate: (entity: E) => M;\n        }\n    ) {\n        this.namespace = namespace;\n        this.hydrate = hydrate;\n        this.dehydrate = dehydrate;\n    }\n\n    async get(id: IdOf<E>): Promise<E> {\n        await this.ensureTableExists();\n\n        const row = await this.db.get(\n            `SELECT * FROM ${this.namespace} WHERE id = ?`,\n            id.getValue()\n        );\n        if (!row) {\n            throw new ObjectNotFoundError(\n                `entity with id '${id.getValue()}' not found`\n            );\n        }\n\n        return this.hydrate(JSON.parse(row.data));\n    }\n\n    async add(entity: E): Promise<void> {\n        await this.ensureTableExists();\n\n        try {\n            await this.db.run(\n                `INSERT INTO ${this.namespace} (id, data)\n                 VALUES (?, ?)`,\n                entity.getId().getValue(),\n                JSON.stringify(this.dehydrate(entity))\n            );\n        } catch (e) {\n            if ((e as Error).message.includes(\"UNIQUE constraint failed\")) {\n                throw new DuplicateObjectError(\n                    `entity with id '${entity\n                        .getId()\n                        .getValue()}' already exists`\n                );\n            }\n\n            throw e;\n        }\n    }\n\n    async update(entity: E): Promise<void> {\n        await this.ensureTableExists();\n\n        const result = await this.db.run(\n            `UPDATE ${this.namespace}\n                 SET data = ?\n                 WHERE id = ?`,\n            JSON.stringify(this.dehydrate(entity)),\n            entity.getId().getValue()\n        );\n\n        if (result.changes === 0) {\n            throw new ObjectNotFoundError(\n                `entity with id '${entity.getId().getValue()}' not found`\n            );\n        }\n    }\n\n    async count(): Promise<number> {\n        await this.ensureTableExists();\n\n        const result = await this.db.get(\n            `SELECT COUNT(*) AS count FROM ${this.namespace}`\n        );\n\n        return result.count;\n    }\n\n    protected async ensureTableExists(): Promise<void> {\n        await this.db.run(`\n            CREATE TABLE IF NOT EXISTS ${this.namespace} (\n                id TEXT NOT NULL PRIMARY KEY UNIQUE,\n                data TEXT NOT NULL\n            )\n        `);\n    }\n}\n","import type { Database } from \"sqlite\";\n\nexport async function getSqliteConnection(\n    filename = \":memory:\"\n): Promise<Database> {\n    const sqlite = await import(\"sqlite\");\n    const sqlite3 = await import(\"sqlite3\");\n    return await sqlite.open({\n        filename,\n        driver: sqlite3.default.Database,\n    });\n}\n"]}
+{"version":3,"sources":["../../src/test/sqlite-repository-for-test.ts","../../src/test/utils.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type { Database } from \"better-sqlite3\";\n\nimport {\n    DuplicateObjectError,\n    Identifiable,\n    IdOf,\n    ObjectNotFoundError,\n    Repository,\n} from \"@hexaijs/core\";\n\nexport class SqliteRepositoryForTest<\n    E extends Identifiable<any>,\n    M,\n> implements Repository<E> {\n    protected namespace: string;\n    protected hydrate: (memento: M) => E;\n    protected dehydrate: (entity: E) => M;\n\n    constructor(\n        protected db: Database,\n        {\n            namespace,\n            hydrate,\n            dehydrate,\n        }: {\n            namespace: string;\n            hydrate: (memento: M) => E;\n            dehydrate: (entity: E) => M;\n        }\n    ) {\n        this.namespace = namespace;\n        this.hydrate = hydrate;\n        this.dehydrate = dehydrate;\n    }\n\n    async get(id: IdOf<E>): Promise<E> {\n        this.ensureTableExists();\n\n        const row = this.db.prepare(\n            `SELECT * FROM ${this.namespace} WHERE id = ?`\n        ).get(id.getValue()) as { data: string } | undefined;\n        if (!row) {\n            throw new ObjectNotFoundError(\n                `entity with id '${id.getValue()}' not found`\n            );\n        }\n\n        return this.hydrate(JSON.parse(row.data));\n    }\n\n    async add(entity: E): Promise<void> {\n        this.ensureTableExists();\n\n        try {\n            this.db.prepare(\n                `INSERT INTO ${this.namespace} (id, data)\n                 VALUES (?, ?)`\n            ).run(\n                entity.getId().getValue(),\n                JSON.stringify(this.dehydrate(entity))\n            );\n        } catch (e) {\n            if ((e as Error).message.includes(\"UNIQUE constraint failed\")) {\n                throw new DuplicateObjectError(\n                    `entity with id '${entity\n                        .getId()\n                        .getValue()}' already exists`\n                );\n            }\n\n            throw e;\n        }\n    }\n\n    async update(entity: E): Promise<void> {\n        this.ensureTableExists();\n\n        const result = this.db.prepare(\n            `UPDATE ${this.namespace}\n                 SET data = ?\n                 WHERE id = ?`\n        ).run(\n            JSON.stringify(this.dehydrate(entity)),\n            entity.getId().getValue()\n        );\n\n        if (result.changes === 0) {\n            throw new ObjectNotFoundError(\n                `entity with id '${entity.getId().getValue()}' not found`\n            );\n        }\n    }\n\n    async count(): Promise<number> {\n        this.ensureTableExists();\n\n        const result = this.db.prepare(\n            `SELECT COUNT(*) AS count FROM ${this.namespace}`\n        ).get() as { count: number };\n\n        return result.count;\n    }\n\n    protected ensureTableExists(): void {\n        this.db.exec(`\n            CREATE TABLE IF NOT EXISTS ${this.namespace} (\n                id TEXT NOT NULL PRIMARY KEY UNIQUE,\n                data TEXT NOT NULL\n            )\n        `);\n    }\n}\n","import Database from \"better-sqlite3\";\nimport type { Database as DatabaseInstance } from \"better-sqlite3\";\n\nexport function getSqliteConnection(\n    filename = \":memory:\"\n): DatabaseInstance {\n    return new Database(filename);\n}\n"]}

package/package.json

@@ -3,7 +3,7 @@
     "publishConfig": {
         "access": "public"
     },
-    "version": "0.3.0",
+    "version": "0.5.0",
     "type": "module",
     "description": "SQLite support for hexai",
     "license": "MIT",
@@ -50,14 +50,13 @@
     },
     "dependencies": {},
     "peerDependencies": {
-        "@hexaijs/core": "^0.7.0",
-        "sqlite": "^5.1.1",
-        "sqlite3": "^5.1.7"
+        "@hexaijs/core": "^0.9.0",
+        "better-sqlite3": "^12.5.0"
     },
     "devDependencies": {
         "@hexaijs/core": "workspace:^",
         "@hexaijs/tooling": "workspace:*",
-        "sqlite": "^5.1.1",
-        "sqlite3": "^5.1.7"
+        "@types/better-sqlite3": "^7.6.13",
+        "better-sqlite3": "^12.5.0"
     }
 }