@hexaijs/sqlite 0.3.0 → 0.4.0

package/README.md

@@ -104,6 +104,39 @@ await db.run("UPDATE orders SET status = ? WHERE id = ?", ["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(async () => {
+        // Validate before committing
+    });
+
+    unitOfWork.afterCommit(async () => {
+        // Notify after successful commit
+    });
+
+    unitOfWork.afterRollback(async () => {
+        // Clean up on failure
+    });
+
+    const db = unitOfWork.getClient();
+    await db.run("INSERT INTO orders (id, status) VALUES (?, ?)", [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:

package/dist/index.d.ts

@@ -1,13 +1,17 @@
 import { Database } from 'sqlite';
-import { UnitOfWork } from '@hexaijs/core';
+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,6 +20,18 @@ 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);
   }
@@ -25,23 +40,50 @@ var SqliteUnitOfWork = class _SqliteUnitOfWork {
     if (++current.level === 1) {
       await this.db.run("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 () => {
+              await this.db.run("ROLLBACK");
+            },
+            abortError
+          );
         } else {
-          await this.db.run("COMMIT");
+          await hooks.executeCommit(
+            async () => {
+              await this.db.run("COMMIT");
+            },
+            async () => {
+              await this.db.run("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":"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","file":"index.js","sourcesContent":["import type { Database } from \"sqlite\";\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            await this.db.run(\"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 () => { await this.db.run(\"ROLLBACK\"); },\n                        abortError\n                    );\n                } else {\n                    await hooks.executeCommit(\n                        async () => { await this.db.run(\"COMMIT\"); },\n                        async () => { await this.db.run(\"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/package.json

@@ -1,63 +1,63 @@
 {
-    "name": "@hexaijs/sqlite",
-    "publishConfig": {
-        "access": "public"
+  "name": "@hexaijs/sqlite",
+  "publishConfig": {
+    "access": "public"
+  },
+  "version": "0.4.0",
+  "type": "module",
+  "description": "SQLite support for hexai",
+  "license": "MIT",
+  "author": "Sangwoo Hyun <wkdny.hyun@gmail.com>",
+  "contributors": [
+    "Seungcheol Baek <victoryiron.baek@gmail.com>",
+    "Donghyun Lee <edonghyun@naver.com>"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/workingdanny911/hexai.git",
+    "directory": "packages/sqlite"
+  },
+  "homepage": "https://github.com/workingdanny911/hexai#readme",
+  "bugs": {
+    "url": "https://github.com/workingdanny911/hexai/issues"
+  },
+  "keywords": [
+    "hexai",
+    "hexagonal",
+    "clean-architecture",
+    "sqlite",
+    "database",
+    "typescript"
+  ],
+  "files": [
+    "dist",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
     },
-    "version": "0.3.0",
-    "type": "module",
-    "description": "SQLite support for hexai",
-    "license": "MIT",
-    "author": "Sangwoo Hyun <wkdny.hyun@gmail.com>",
-    "contributors": [
-        "Seungcheol Baek <victoryiron.baek@gmail.com>",
-        "Donghyun Lee <edonghyun@naver.com>"
-    ],
-    "repository": {
-        "type": "git",
-        "url": "git+https://github.com/workingdanny911/hexai.git",
-        "directory": "packages/sqlite"
+    "./test": {
+      "types": "./dist/test/index.d.ts",
+      "import": "./dist/test/index.js"
     },
-    "homepage": "https://github.com/workingdanny911/hexai#readme",
-    "bugs": {
-        "url": "https://github.com/workingdanny911/hexai/issues"
-    },
-    "keywords": [
-        "hexai",
-        "hexagonal",
-        "clean-architecture",
-        "sqlite",
-        "database",
-        "typescript"
-    ],
-    "files": [
-        "dist",
-        "LICENSE"
-    ],
-    "exports": {
-        ".": {
-            "types": "./dist/index.d.ts",
-            "import": "./dist/index.js"
-        },
-        "./test": {
-            "types": "./dist/test/index.d.ts",
-            "import": "./dist/test/index.js"
-        },
-        "./package.json": "./package.json"
-    },
-    "scripts": {
-        "test": "vitest run",
-        "build": "tsup"
-    },
-    "dependencies": {},
-    "peerDependencies": {
-        "@hexaijs/core": "^0.7.0",
-        "sqlite": "^5.1.1",
-        "sqlite3": "^5.1.7"
-    },
-    "devDependencies": {
-        "@hexaijs/core": "workspace:^",
-        "@hexaijs/tooling": "workspace:*",
-        "sqlite": "^5.1.1",
-        "sqlite3": "^5.1.7"
-    }
-}
+    "./package.json": "./package.json"
+  },
+  "dependencies": {},
+  "peerDependencies": {
+    "@hexaijs/core": "^0.8.0",
+    "sqlite": "^5.1.1",
+    "sqlite3": "^5.1.7"
+  },
+  "devDependencies": {
+    "sqlite": "^5.1.1",
+    "sqlite3": "^5.1.7",
+    "@hexaijs/core": "^0.8.0",
+    "@hexaijs/tooling": "0.1.0"
+  },
+  "scripts": {
+    "test": "vitest run",
+    "build": "tsup"
+  }
+}