@outbox-event-bus/sqlite-better-sqlite3-outbox 1.0.0

package/dist/index.mjs

@@ -0,0 +1,228 @@
+import Database from "better-sqlite3";
+import { EventStatus, PollingService, formatErrorMessage, reportEventError } from "outbox-event-bus";
+import { AsyncLocalStorage } from "node:async_hooks";
+
+//#region src/sqlite-better-sqlite3-outbox.ts
+const DEFAULT_EXPIRE_IN_SECONDS = 300;
+const getOutboxSchema = (tableName, archiveTableName) => `
+  CREATE TABLE IF NOT EXISTS ${tableName} (
+    id TEXT PRIMARY KEY,
+    type TEXT NOT NULL,
+    payload TEXT NOT NULL,
+    occurred_at TEXT NOT NULL,
+    status TEXT NOT NULL DEFAULT '${EventStatus.CREATED}',
+    retry_count INTEGER NOT NULL DEFAULT 0,
+    last_error TEXT,
+    next_retry_at TEXT,
+    created_on TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ', 'now')),
+    started_on TEXT,
+    completed_on TEXT,
+    keep_alive TEXT,
+    expire_in_seconds INTEGER NOT NULL DEFAULT ${DEFAULT_EXPIRE_IN_SECONDS}
+  );
+
+  CREATE TABLE IF NOT EXISTS ${archiveTableName} (
+    id TEXT PRIMARY KEY,
+    type TEXT NOT NULL,
+    payload TEXT NOT NULL,
+    occurred_at TEXT NOT NULL,
+    status TEXT NOT NULL,
+    retry_count INTEGER NOT NULL,
+    last_error TEXT,
+    created_on TEXT NOT NULL,
+    started_on TEXT,
+    completed_on TEXT NOT NULL
+  );
+
+  CREATE INDEX IF NOT EXISTS idx_${tableName}_status_retry ON ${tableName} (status, next_retry_at);
+`;
+var SqliteBetterSqlite3Outbox = class {
+	config;
+	db;
+	poller;
+	constructor(config) {
+		if (config.db) this.db = config.db;
+		else {
+			if (!config.dbPath) throw new Error("dbPath is required if db is not provided");
+			this.db = new Database(config.dbPath);
+			this.db.pragma("journal_mode = WAL");
+		}
+		this.config = {
+			batchSize: config.batchSize ?? 50,
+			pollIntervalMs: config.pollIntervalMs ?? 1e3,
+			maxRetries: config.maxRetries ?? 5,
+			baseBackoffMs: config.baseBackoffMs ?? 1e3,
+			processingTimeoutMs: config.processingTimeoutMs ?? 3e4,
+			maxErrorBackoffMs: config.maxErrorBackoffMs ?? 3e4,
+			dbPath: config.dbPath ?? "",
+			db: this.db,
+			getTransaction: config.getTransaction,
+			tableName: config.tableName ?? "outbox_events",
+			archiveTableName: config.archiveTableName ?? "outbox_events_archive"
+		};
+		this.init();
+		this.poller = new PollingService({
+			pollIntervalMs: this.config.pollIntervalMs,
+			baseBackoffMs: this.config.baseBackoffMs,
+			maxErrorBackoffMs: this.config.maxErrorBackoffMs,
+			processBatch: (handler) => this.processBatch(handler)
+		});
+	}
+	init() {
+		this.db.exec(getOutboxSchema(this.config.tableName, this.config.archiveTableName));
+	}
+	async publish(events, transaction) {
+		if (events.length === 0) return;
+		const executor = transaction ?? this.config.getTransaction?.() ?? this.db;
+		const insert = executor.prepare(`
+      INSERT INTO ${this.config.tableName} (id, type, payload, occurred_at, status)
+      VALUES (?, ?, ?, ?, '${EventStatus.CREATED}')
+    `);
+		executor.transaction(() => {
+			for (const event of events) insert.run(event.id, event.type, JSON.stringify(event.payload), event.occurredAt.toISOString());
+		})();
+	}
+	async getFailedEvents() {
+		return this.db.prepare(`
+      SELECT * FROM ${this.config.tableName}
+      WHERE status = '${EventStatus.FAILED}'
+      ORDER BY occurred_at DESC
+      LIMIT 100
+    `).all().map((row) => {
+			const event = {
+				id: row.id,
+				type: row.type,
+				payload: JSON.parse(row.payload),
+				occurredAt: new Date(row.occurred_at),
+				retryCount: row.retry_count
+			};
+			if (row.last_error) event.error = row.last_error;
+			if (row.started_on) event.lastAttemptAt = new Date(row.started_on);
+			return event;
+		});
+	}
+	async retryEvents(eventIds) {
+		if (eventIds.length === 0) return;
+		const placeholders = eventIds.map(() => "?").join(",");
+		this.db.prepare(`
+      UPDATE ${this.config.tableName}
+      SET status = '${EventStatus.CREATED}',
+          retry_count = 0,
+          next_retry_at = NULL,
+          last_error = NULL
+      WHERE id IN (${placeholders})
+    `).run(...eventIds);
+	}
+	start(handler, onError) {
+		this.poller.start(handler, onError);
+	}
+	async stop() {
+		await this.poller.stop();
+	}
+	async processBatch(handler) {
+		const now = (/* @__PURE__ */ new Date()).toISOString();
+		const msNow = Date.now();
+		const lockedEvents = this.db.transaction(() => {
+			const rows = this.db.prepare(`
+        SELECT * FROM ${this.config.tableName}
+        WHERE status = '${EventStatus.CREATED}'
+        OR (status = '${EventStatus.FAILED}' AND retry_count < ? AND next_retry_at <= ?)
+        OR (status = '${EventStatus.ACTIVE}' AND datetime(keep_alive, '+' || expire_in_seconds || ' seconds') < datetime(?))
+        LIMIT ?
+      `).all(this.config.maxRetries, now, now, this.config.batchSize);
+			if (rows.length === 0) return [];
+			const ids = rows.map((r) => r.id);
+			const placeholders = ids.map(() => "?").join(",");
+			this.db.prepare(`
+        UPDATE ${this.config.tableName}
+        SET status = '${EventStatus.ACTIVE}',
+            started_on = ?,
+            keep_alive = ?
+        WHERE id IN (${placeholders})
+      `).run(now, now, ...ids);
+			return rows;
+		})();
+		if (lockedEvents.length === 0) return;
+		const busEvents = lockedEvents.map((row) => ({
+			id: row.id,
+			type: row.type,
+			payload: JSON.parse(row.payload),
+			occurredAt: new Date(row.occurred_at)
+		}));
+		const completedEvents = [];
+		for (let index = 0; index < busEvents.length; index++) {
+			const event = busEvents[index];
+			const lockedEvent = lockedEvents[index];
+			try {
+				await handler(event);
+				completedEvents.push({
+					event,
+					lockedEvent
+				});
+			} catch (error) {
+				const retryCount = lockedEvent.retry_count + 1;
+				reportEventError(this.poller.onError, error, event, retryCount, this.config.maxRetries);
+				const delay = this.poller.calculateBackoff(retryCount);
+				this.db.prepare(`
+          UPDATE ${this.config.tableName}
+          SET status = '${EventStatus.FAILED}',
+              retry_count = ?,
+              last_error = ?,
+              next_retry_at = ?
+          WHERE id = ?
+        `).run(retryCount, formatErrorMessage(error), new Date(msNow + delay).toISOString(), lockedEvent.id);
+			}
+		}
+		if (completedEvents.length > 0) this.db.transaction(() => {
+			const insertArchive = this.db.prepare(`
+          INSERT INTO ${this.config.archiveTableName} (
+            id, type, payload, occurred_at, status, retry_count, last_error, created_on, started_on, completed_on
+          ) VALUES (?, ?, ?, ?, '${EventStatus.COMPLETED}', ?, ?, ?, ?, ?)
+        `);
+			const deleteEvent = this.db.prepare(`DELETE FROM ${this.config.tableName} WHERE id = ?`);
+			const completionTime = (/* @__PURE__ */ new Date()).toISOString();
+			for (const { lockedEvent } of completedEvents) {
+				insertArchive.run(lockedEvent.id, lockedEvent.type, lockedEvent.payload, lockedEvent.occurred_at, lockedEvent.retry_count, lockedEvent.last_error, lockedEvent.created_on, now, completionTime);
+				deleteEvent.run(lockedEvent.id);
+			}
+		})();
+	}
+};
+
+//#endregion
+//#region src/transaction-storage.ts
+const betterSqlite3TransactionStorage = new AsyncLocalStorage();
+async function withBetterSqlite3Transaction(db, fn) {
+	return betterSqlite3TransactionStorage.run(db, async () => {
+		if (db.inTransaction) {
+			const savepointName = `sp_${Date.now()}_${Math.random().toString(36).slice(2)}`;
+			db.prepare(`SAVEPOINT ${savepointName}`).run();
+			try {
+				const result = await fn(db);
+				db.prepare(`RELEASE ${savepointName}`).run();
+				return result;
+			} catch (error) {
+				db.prepare(`ROLLBACK TO ${savepointName}`).run();
+				db.prepare(`RELEASE ${savepointName}`).run();
+				throw error;
+			}
+		} else {
+			db.prepare("BEGIN").run();
+			try {
+				const result = await fn(db);
+				db.prepare("COMMIT").run();
+				return result;
+			} catch (error) {
+				db.prepare("ROLLBACK").run();
+				throw error;
+			}
+		}
+	});
+}
+function getBetterSqlite3Transaction() {
+	return () => betterSqlite3TransactionStorage.getStore();
+}
+
+//#endregion
+export { SqliteBetterSqlite3Outbox, betterSqlite3TransactionStorage, getBetterSqlite3Transaction, withBetterSqlite3Transaction };
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["event: FailedBusEvent","busEvents: BusEvent[]","completedEvents: { event: BusEvent; lockedEvent: OutboxRow }[]","betterSqlite3TransactionStorage: AsyncLocalStorage<Database>"],"sources":["../src/sqlite-better-sqlite3-outbox.ts","../src/transaction-storage.ts"],"sourcesContent":["import Database from \"better-sqlite3\"\nimport {\n  type BusEvent,\n  type ErrorHandler,\n  EventStatus,\n  type FailedBusEvent,\n  formatErrorMessage,\n  type IOutbox,\n  type OutboxConfig,\n  PollingService,\n  reportEventError,\n} from \"outbox-event-bus\"\n\nconst DEFAULT_EXPIRE_IN_SECONDS = 300\n\nconst getOutboxSchema = (tableName: string, archiveTableName: string) => `\n  CREATE TABLE IF NOT EXISTS ${tableName} (\n    id TEXT PRIMARY KEY,\n    type TEXT NOT NULL,\n    payload TEXT NOT NULL,\n    occurred_at TEXT NOT NULL,\n    status TEXT NOT NULL DEFAULT '${EventStatus.CREATED}',\n    retry_count INTEGER NOT NULL DEFAULT 0,\n    last_error TEXT,\n    next_retry_at TEXT,\n    created_on TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ', 'now')),\n    started_on TEXT,\n    completed_on TEXT,\n    keep_alive TEXT,\n    expire_in_seconds INTEGER NOT NULL DEFAULT ${DEFAULT_EXPIRE_IN_SECONDS}\n  );\n\n  CREATE TABLE IF NOT EXISTS ${archiveTableName} (\n    id TEXT PRIMARY KEY,\n    type TEXT NOT NULL,\n    payload TEXT NOT NULL,\n    occurred_at TEXT NOT NULL,\n    status TEXT NOT NULL,\n    retry_count INTEGER NOT NULL,\n    last_error TEXT,\n    created_on TEXT NOT NULL,\n    started_on TEXT,\n    completed_on TEXT NOT NULL\n  );\n\n  CREATE INDEX IF NOT EXISTS idx_${tableName}_status_retry ON ${tableName} (status, next_retry_at);\n`\n\nexport interface SqliteBetterSqlite3OutboxConfig extends OutboxConfig {\n  dbPath?: string\n  db?: Database.Database\n  getTransaction?: (() => Database.Database | undefined) | undefined\n  tableName?: string\n  archiveTableName?: string\n}\n\ninterface OutboxRow {\n  id: string\n  type: string\n  payload: string\n  occurred_at: string\n  status: EventStatus\n  retry_count: number\n  next_retry_at: string | null\n  last_error: string | null\n  created_on: string\n  started_on: string | null\n  completed_on: string | null\n  keep_alive: string | null\n  expire_in_seconds: number\n}\n\nexport class SqliteBetterSqlite3Outbox implements IOutbox<Database.Database> {\n  private readonly config: Required<SqliteBetterSqlite3OutboxConfig>\n  private readonly db: Database.Database\n  private readonly poller: PollingService\n\n  constructor(config: SqliteBetterSqlite3OutboxConfig) {\n    if (config.db) {\n      this.db = config.db\n    } else {\n      if (!config.dbPath) throw new Error(\"dbPath is required if db is not provided\")\n      this.db = new Database(config.dbPath)\n      this.db.pragma(\"journal_mode = WAL\")\n    }\n\n    this.config = {\n      batchSize: config.batchSize ?? 50,\n      pollIntervalMs: config.pollIntervalMs ?? 1000,\n      maxRetries: config.maxRetries ?? 5,\n      baseBackoffMs: config.baseBackoffMs ?? 1000,\n      processingTimeoutMs: config.processingTimeoutMs ?? 30000,\n      maxErrorBackoffMs: config.maxErrorBackoffMs ?? 30000,\n      dbPath: config.dbPath ?? \"\",\n      db: this.db,\n      getTransaction: config.getTransaction,\n      tableName: config.tableName ?? \"outbox_events\",\n      archiveTableName: config.archiveTableName ?? \"outbox_events_archive\",\n    } as Required<SqliteBetterSqlite3OutboxConfig>\n\n    this.init()\n\n    this.poller = new PollingService({\n      pollIntervalMs: this.config.pollIntervalMs,\n      baseBackoffMs: this.config.baseBackoffMs,\n      maxErrorBackoffMs: this.config.maxErrorBackoffMs,\n      processBatch: (handler) => this.processBatch(handler),\n    })\n  }\n\n  private init() {\n    this.db.exec(getOutboxSchema(this.config.tableName, this.config.archiveTableName))\n  }\n\n  async publish(events: BusEvent[], transaction?: Database.Database): Promise<void> {\n    if (events.length === 0) return\n\n    const executor = transaction ?? this.config.getTransaction?.() ?? this.db\n\n    const insert = executor.prepare(`\n      INSERT INTO ${this.config.tableName} (id, type, payload, occurred_at, status)\n      VALUES (?, ?, ?, ?, '${EventStatus.CREATED}')\n    `)\n\n    executor.transaction(() => {\n      for (const event of events) {\n        insert.run(\n          event.id,\n          event.type,\n          JSON.stringify(event.payload),\n          event.occurredAt.toISOString()\n        )\n      }\n    })()\n  }\n\n  async getFailedEvents(): Promise<FailedBusEvent[]> {\n    const rows = this.db\n      .prepare(`\n      SELECT * FROM ${this.config.tableName}\n      WHERE status = '${EventStatus.FAILED}'\n      ORDER BY occurred_at DESC\n      LIMIT 100\n    `)\n      .all() as OutboxRow[]\n\n    return rows.map((row) => {\n      const event: FailedBusEvent = {\n        id: row.id,\n        type: row.type,\n        payload: JSON.parse(row.payload),\n        occurredAt: new Date(row.occurred_at),\n        retryCount: row.retry_count,\n      }\n      if (row.last_error) event.error = row.last_error\n      if (row.started_on) event.lastAttemptAt = new Date(row.started_on)\n      return event\n    })\n  }\n\n  async retryEvents(eventIds: string[]): Promise<void> {\n    if (eventIds.length === 0) return\n\n    const placeholders = eventIds.map(() => \"?\").join(\",\")\n    this.db\n      .prepare(`\n      UPDATE ${this.config.tableName}\n      SET status = '${EventStatus.CREATED}',\n          retry_count = 0,\n          next_retry_at = NULL,\n          last_error = NULL\n      WHERE id IN (${placeholders})\n    `)\n      .run(...eventIds)\n  }\n\n  start(handler: (event: BusEvent) => Promise<void>, onError: ErrorHandler): void {\n    this.poller.start(handler, onError)\n  }\n\n  async stop(): Promise<void> {\n    await this.poller.stop()\n  }\n\n  private async processBatch(handler: (event: BusEvent) => Promise<void>) {\n    const now = new Date().toISOString()\n    const msNow = Date.now()\n\n    const lockedEvents = this.db.transaction(() => {\n      // Select events that are ready to process:\n      // 1. New events (status = 'created')\n      // 2. Failed events that can be retried (retry_count < max AND next_retry_at has passed)\n      // 3. Stuck events (status = 'active' but keepAlive + expire_in_seconds < now)\n      const rows = this.db\n        .prepare(`\n        SELECT * FROM ${this.config.tableName}\n        WHERE status = '${EventStatus.CREATED}'\n        OR (status = '${EventStatus.FAILED}' AND retry_count < ? AND next_retry_at <= ?)\n        OR (status = '${EventStatus.ACTIVE}' AND datetime(keep_alive, '+' || expire_in_seconds || ' seconds') < datetime(?))\n        LIMIT ?\n      `)\n        .all(this.config.maxRetries, now, now, this.config.batchSize) as OutboxRow[]\n\n      if (rows.length === 0) return []\n\n      const ids = rows.map((r) => r.id)\n      const placeholders = ids.map(() => \"?\").join(\",\")\n\n      this.db\n        .prepare(`\n        UPDATE ${this.config.tableName}\n        SET status = '${EventStatus.ACTIVE}',\n            started_on = ?,\n            keep_alive = ?\n        WHERE id IN (${placeholders})\n      `)\n        .run(now, now, ...ids)\n\n      return rows\n    })()\n\n    if (lockedEvents.length === 0) return\n\n    const busEvents: BusEvent[] = lockedEvents.map((row) => ({\n      id: row.id,\n      type: row.type,\n      payload: JSON.parse(row.payload),\n      occurredAt: new Date(row.occurred_at),\n    }))\n\n    const completedEvents: { event: BusEvent; lockedEvent: OutboxRow }[] = []\n\n    for (let index = 0; index < busEvents.length; index++) {\n      const event = busEvents[index]!\n      const lockedEvent = lockedEvents[index]!\n\n      try {\n        await handler(event)\n        completedEvents.push({ event, lockedEvent })\n      } catch (error) {\n        const retryCount = lockedEvent.retry_count + 1\n        reportEventError(this.poller.onError, error, event, retryCount, this.config.maxRetries)\n\n        const delay = this.poller.calculateBackoff(retryCount)\n\n        this.db\n          .prepare(`\n          UPDATE ${this.config.tableName}\n          SET status = '${EventStatus.FAILED}',\n              retry_count = ?,\n              last_error = ?,\n              next_retry_at = ?\n          WHERE id = ?\n        `)\n          .run(\n            retryCount,\n            formatErrorMessage(error),\n            new Date(msNow + delay).toISOString(),\n            lockedEvent.id\n          )\n      }\n    }\n\n    if (completedEvents.length > 0) {\n      this.db.transaction(() => {\n        const insertArchive = this.db.prepare(`\n          INSERT INTO ${this.config.archiveTableName} (\n            id, type, payload, occurred_at, status, retry_count, last_error, created_on, started_on, completed_on\n          ) VALUES (?, ?, ?, ?, '${EventStatus.COMPLETED}', ?, ?, ?, ?, ?)\n        `)\n        const deleteEvent = this.db.prepare(`DELETE FROM ${this.config.tableName} WHERE id = ?`)\n\n        const completionTime = new Date().toISOString()\n        for (const { lockedEvent } of completedEvents) {\n          insertArchive.run(\n            lockedEvent.id,\n            lockedEvent.type,\n            lockedEvent.payload,\n            lockedEvent.occurred_at,\n            lockedEvent.retry_count,\n            lockedEvent.last_error,\n            lockedEvent.created_on,\n            now,\n            completionTime\n          )\n          deleteEvent.run(lockedEvent.id)\n        }\n      })()\n    }\n  }\n}\n","import { AsyncLocalStorage } from \"node:async_hooks\"\nimport type { Database } from \"better-sqlite3\"\n\nexport type { Database }\n\nexport const betterSqlite3TransactionStorage: AsyncLocalStorage<Database> =\n  new AsyncLocalStorage<Database>()\n\nexport async function withBetterSqlite3Transaction<T>(\n  db: Database,\n  fn: (tx: Database) => Promise<T>\n): Promise<T> {\n  return betterSqlite3TransactionStorage.run(db, async () => {\n    if (db.inTransaction) {\n      const savepointName = `sp_${Date.now()}_${Math.random().toString(36).slice(2)}`\n      db.prepare(`SAVEPOINT ${savepointName}`).run()\n      try {\n        const result = await fn(db)\n        db.prepare(`RELEASE ${savepointName}`).run()\n        return result\n      } catch (error) {\n        db.prepare(`ROLLBACK TO ${savepointName}`).run()\n        db.prepare(`RELEASE ${savepointName}`).run()\n        throw error\n      }\n    } else {\n      db.prepare(\"BEGIN\").run()\n      try {\n        const result = await fn(db)\n        db.prepare(\"COMMIT\").run()\n        return result\n      } catch (error) {\n        db.prepare(\"ROLLBACK\").run()\n        throw error\n      }\n    }\n  })\n}\n\nexport function getBetterSqlite3Transaction(): () => Database | undefined {\n  return () => betterSqlite3TransactionStorage.getStore()\n}\n"],"mappings":";;;;;AAaA,MAAM,4BAA4B;AAElC,MAAM,mBAAmB,WAAmB,qBAA6B;+BAC1C,UAAU;;;;;oCAKL,YAAY,QAAQ;;;;;;;;iDAQP,0BAA0B;;;+BAG5C,iBAAiB;;;;;;;;;;;;;mCAab,UAAU,mBAAmB,UAAU;;AA2B1E,IAAa,4BAAb,MAA6E;CAC3E,AAAiB;CACjB,AAAiB;CACjB,AAAiB;CAEjB,YAAY,QAAyC;AACnD,MAAI,OAAO,GACT,MAAK,KAAK,OAAO;OACZ;AACL,OAAI,CAAC,OAAO,OAAQ,OAAM,IAAI,MAAM,2CAA2C;AAC/E,QAAK,KAAK,IAAI,SAAS,OAAO,OAAO;AACrC,QAAK,GAAG,OAAO,qBAAqB;;AAGtC,OAAK,SAAS;GACZ,WAAW,OAAO,aAAa;GAC/B,gBAAgB,OAAO,kBAAkB;GACzC,YAAY,OAAO,cAAc;GACjC,eAAe,OAAO,iBAAiB;GACvC,qBAAqB,OAAO,uBAAuB;GACnD,mBAAmB,OAAO,qBAAqB;GAC/C,QAAQ,OAAO,UAAU;GACzB,IAAI,KAAK;GACT,gBAAgB,OAAO;GACvB,WAAW,OAAO,aAAa;GAC/B,kBAAkB,OAAO,oBAAoB;GAC9C;AAED,OAAK,MAAM;AAEX,OAAK,SAAS,IAAI,eAAe;GAC/B,gBAAgB,KAAK,OAAO;GAC5B,eAAe,KAAK,OAAO;GAC3B,mBAAmB,KAAK,OAAO;GAC/B,eAAe,YAAY,KAAK,aAAa,QAAQ;GACtD,CAAC;;CAGJ,AAAQ,OAAO;AACb,OAAK,GAAG,KAAK,gBAAgB,KAAK,OAAO,WAAW,KAAK,OAAO,iBAAiB,CAAC;;CAGpF,MAAM,QAAQ,QAAoB,aAAgD;AAChF,MAAI,OAAO,WAAW,EAAG;EAEzB,MAAM,WAAW,eAAe,KAAK,OAAO,kBAAkB,IAAI,KAAK;EAEvE,MAAM,SAAS,SAAS,QAAQ;oBAChB,KAAK,OAAO,UAAU;6BACb,YAAY,QAAQ;MAC3C;AAEF,WAAS,kBAAkB;AACzB,QAAK,MAAM,SAAS,OAClB,QAAO,IACL,MAAM,IACN,MAAM,MACN,KAAK,UAAU,MAAM,QAAQ,EAC7B,MAAM,WAAW,aAAa,CAC/B;IAEH,EAAE;;CAGN,MAAM,kBAA6C;AAUjD,SATa,KAAK,GACf,QAAQ;sBACO,KAAK,OAAO,UAAU;wBACpB,YAAY,OAAO;;;MAGrC,CACC,KAAK,CAEI,KAAK,QAAQ;GACvB,MAAMA,QAAwB;IAC5B,IAAI,IAAI;IACR,MAAM,IAAI;IACV,SAAS,KAAK,MAAM,IAAI,QAAQ;IAChC,YAAY,IAAI,KAAK,IAAI,YAAY;IACrC,YAAY,IAAI;IACjB;AACD,OAAI,IAAI,WAAY,OAAM,QAAQ,IAAI;AACtC,OAAI,IAAI,WAAY,OAAM,gBAAgB,IAAI,KAAK,IAAI,WAAW;AAClE,UAAO;IACP;;CAGJ,MAAM,YAAY,UAAmC;AACnD,MAAI,SAAS,WAAW,EAAG;EAE3B,MAAM,eAAe,SAAS,UAAU,IAAI,CAAC,KAAK,IAAI;AACtD,OAAK,GACF,QAAQ;eACA,KAAK,OAAO,UAAU;sBACf,YAAY,QAAQ;;;;qBAIrB,aAAa;MAC5B,CACC,IAAI,GAAG,SAAS;;CAGrB,MAAM,SAA6C,SAA6B;AAC9E,OAAK,OAAO,MAAM,SAAS,QAAQ;;CAGrC,MAAM,OAAsB;AAC1B,QAAM,KAAK,OAAO,MAAM;;CAG1B,MAAc,aAAa,SAA6C;EACtE,MAAM,uBAAM,IAAI,MAAM,EAAC,aAAa;EACpC,MAAM,QAAQ,KAAK,KAAK;EAExB,MAAM,eAAe,KAAK,GAAG,kBAAkB;GAK7C,MAAM,OAAO,KAAK,GACf,QAAQ;wBACO,KAAK,OAAO,UAAU;0BACpB,YAAY,QAAQ;wBACtB,YAAY,OAAO;wBACnB,YAAY,OAAO;;QAEnC,CACC,IAAI,KAAK,OAAO,YAAY,KAAK,KAAK,KAAK,OAAO,UAAU;AAE/D,OAAI,KAAK,WAAW,EAAG,QAAO,EAAE;GAEhC,MAAM,MAAM,KAAK,KAAK,MAAM,EAAE,GAAG;GACjC,MAAM,eAAe,IAAI,UAAU,IAAI,CAAC,KAAK,IAAI;AAEjD,QAAK,GACF,QAAQ;iBACA,KAAK,OAAO,UAAU;wBACf,YAAY,OAAO;;;uBAGpB,aAAa;QAC5B,CACC,IAAI,KAAK,KAAK,GAAG,IAAI;AAExB,UAAO;IACP,EAAE;AAEJ,MAAI,aAAa,WAAW,EAAG;EAE/B,MAAMC,YAAwB,aAAa,KAAK,SAAS;GACvD,IAAI,IAAI;GACR,MAAM,IAAI;GACV,SAAS,KAAK,MAAM,IAAI,QAAQ;GAChC,YAAY,IAAI,KAAK,IAAI,YAAY;GACtC,EAAE;EAEH,MAAMC,kBAAiE,EAAE;AAEzE,OAAK,IAAI,QAAQ,GAAG,QAAQ,UAAU,QAAQ,SAAS;GACrD,MAAM,QAAQ,UAAU;GACxB,MAAM,cAAc,aAAa;AAEjC,OAAI;AACF,UAAM,QAAQ,MAAM;AACpB,oBAAgB,KAAK;KAAE;KAAO;KAAa,CAAC;YACrC,OAAO;IACd,MAAM,aAAa,YAAY,cAAc;AAC7C,qBAAiB,KAAK,OAAO,SAAS,OAAO,OAAO,YAAY,KAAK,OAAO,WAAW;IAEvF,MAAM,QAAQ,KAAK,OAAO,iBAAiB,WAAW;AAEtD,SAAK,GACF,QAAQ;mBACA,KAAK,OAAO,UAAU;0BACf,YAAY,OAAO;;;;;UAKnC,CACC,IACC,YACA,mBAAmB,MAAM,EACzB,IAAI,KAAK,QAAQ,MAAM,CAAC,aAAa,EACrC,YAAY,GACb;;;AAIP,MAAI,gBAAgB,SAAS,EAC3B,MAAK,GAAG,kBAAkB;GACxB,MAAM,gBAAgB,KAAK,GAAG,QAAQ;wBACtB,KAAK,OAAO,iBAAiB;;mCAElB,YAAY,UAAU;UAC/C;GACF,MAAM,cAAc,KAAK,GAAG,QAAQ,eAAe,KAAK,OAAO,UAAU,eAAe;GAExF,MAAM,kCAAiB,IAAI,MAAM,EAAC,aAAa;AAC/C,QAAK,MAAM,EAAE,iBAAiB,iBAAiB;AAC7C,kBAAc,IACZ,YAAY,IACZ,YAAY,MACZ,YAAY,SACZ,YAAY,aACZ,YAAY,aACZ,YAAY,YACZ,YAAY,YACZ,KACA,eACD;AACD,gBAAY,IAAI,YAAY,GAAG;;IAEjC,EAAE;;;;;;AC1RV,MAAaC,kCACX,IAAI,mBAA6B;AAEnC,eAAsB,6BACpB,IACA,IACY;AACZ,QAAO,gCAAgC,IAAI,IAAI,YAAY;AACzD,MAAI,GAAG,eAAe;GACpB,MAAM,gBAAgB,MAAM,KAAK,KAAK,CAAC,GAAG,KAAK,QAAQ,CAAC,SAAS,GAAG,CAAC,MAAM,EAAE;AAC7E,MAAG,QAAQ,aAAa,gBAAgB,CAAC,KAAK;AAC9C,OAAI;IACF,MAAM,SAAS,MAAM,GAAG,GAAG;AAC3B,OAAG,QAAQ,WAAW,gBAAgB,CAAC,KAAK;AAC5C,WAAO;YACA,OAAO;AACd,OAAG,QAAQ,eAAe,gBAAgB,CAAC,KAAK;AAChD,OAAG,QAAQ,WAAW,gBAAgB,CAAC,KAAK;AAC5C,UAAM;;SAEH;AACL,MAAG,QAAQ,QAAQ,CAAC,KAAK;AACzB,OAAI;IACF,MAAM,SAAS,MAAM,GAAG,GAAG;AAC3B,OAAG,QAAQ,SAAS,CAAC,KAAK;AAC1B,WAAO;YACA,OAAO;AACd,OAAG,QAAQ,WAAW,CAAC,KAAK;AAC5B,UAAM;;;GAGV;;AAGJ,SAAgB,8BAA0D;AACxE,cAAa,gCAAgC,UAAU"}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@outbox-event-bus/sqlite-better-sqlite3-outbox",
+  "version": "1.0.0",
+  "private": false,
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dunika/outbox-event-bus.git",
+    "directory": "adapters/sqlite-better-sqlite3"
+  },
+  "homepage": "https://github.com/dunika/outbox-event-bus/tree/main/adapters/sqlite-better-sqlite3#readme",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest run",
+    "test:e2e": "vitest run -c vitest.e2e.config.ts"
+  },
+  "dependencies": {
+    "outbox-event-bus": "workspace:*"
+  },
+  "peerDependencies": {
+    "better-sqlite3": "^12.5.0"
+  },
+  "devDependencies": {
+    "@outbox-event-bus/config": "workspace:*",
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/node": "catalog:",
+    "better-sqlite3": "^12.5.0",
+    "tsdown": "catalog:",
+    "typescript": "catalog:",
+    "vitest": "catalog:"
+  }
+}

package/src/error-handling.test.ts

@@ -0,0 +1,145 @@
+import Database from "better-sqlite3"
+import { HandlerError, MaxRetriesExceededError } from "outbox-event-bus"
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest"
+import { OutboxEventBus } from "../../../core/src/bus/outbox-event-bus"
+import { SqliteBetterSqlite3Outbox } from "./sqlite-better-sqlite3-outbox"
+
+describe("Error Handling", () => {
+  let db: Database.Database
+  let outbox: SqliteBetterSqlite3Outbox
+  let bus: OutboxEventBus<any>
+
+  beforeEach(() => {
+    db = new Database(":memory:")
+
+    outbox = new SqliteBetterSqlite3Outbox({
+      db,
+      pollIntervalMs: 10,
+      maxRetries: 3,
+    })
+  })
+
+  afterEach(async () => {
+    await bus?.stop()
+    db.close()
+  })
+
+  it("should call onError with event and retry count when handler fails", async () => {
+    const onError = vi.fn()
+    bus = new OutboxEventBus(outbox, onError)
+    bus.start()
+
+    const eventType = "test-event"
+    const error = new Error("Handler failed")
+
+    // Register a handler that fails
+    bus.on(eventType, async () => {
+      throw error
+    })
+
+    await bus.emit({
+      type: eventType,
+      payload: { data: "test" },
+    })
+
+    await new Promise((resolve) => setTimeout(resolve, 100))
+
+    expect(onError).toHaveBeenCalled()
+    const call = onError.mock.calls[0]
+    expect(call).toBeDefined()
+    if (call) {
+      const calledError = call[0]
+
+      // Verify it's a HandlerError instance
+      expect(calledError).toBeInstanceOf(HandlerError)
+      expect(calledError.name).toBe("HandlerError")
+      expect(calledError.message).toContain("Handler failed")
+
+      // Verify cause is preserved
+      expect((calledError as HandlerError).cause).toEqual(error)
+
+      // Verify event is bundled in error.context.event
+      const calledEvent = (calledError as HandlerError).context?.event as any
+      expect(calledEvent).toBeDefined()
+      expect(calledEvent.type).toBe(eventType)
+      expect(calledEvent.id).toBeDefined()
+    }
+  })
+
+  it("should increment retry count on subsequent failures", async () => {
+    const onError = vi.fn()
+    bus = new OutboxEventBus(outbox, onError)
+    bus.start()
+
+    const eventType = "test-event-retry"
+
+    bus.on(eventType, async () => {
+      throw new Error("Fail again")
+    })
+
+    await bus.emit({
+      type: eventType,
+      payload: { data: "test" },
+    })
+    console.log("Events after emit:", db.prepare("SELECT * FROM outbox_events").all())
+
+    await new Promise((resolve) => setTimeout(resolve, 100))
+
+    expect(onError).toHaveBeenCalledTimes(1)
+
+    // Manually reset next_retry_at so it picks it up immediately (simulating time passing)
+    db.prepare("UPDATE outbox_events SET next_retry_at = '1970-01-01'").run()
+    console.log("Events after update:", db.prepare("SELECT * FROM outbox_events").all())
+    console.log("Archive after update:", db.prepare("SELECT * FROM outbox_events_archive").all())
+
+    await new Promise((resolve) => setTimeout(resolve, 100))
+
+    expect(onError).toHaveBeenCalledTimes(2)
+    const secondCall = onError.mock.calls[1]
+    if (secondCall) {
+      const secondCallEvent = (secondCall[0] as any).context?.event
+      expect(secondCallEvent).toBeDefined()
+      expect(secondCallEvent.type).toBe(eventType)
+    }
+  })
+
+  it("should call onError with MaxRetriesExceededError when max retries is reached", async () => {
+    const onError = vi.fn()
+    // Set maxRetries to 1 for quick test
+    outbox = new SqliteBetterSqlite3Outbox({
+      db,
+      pollIntervalMs: 10,
+      maxRetries: 0,
+    })
+    bus = new OutboxEventBus(outbox, onError)
+    bus.start()
+
+    const eventType = "test-event-max-retries"
+    bus.on(eventType, async () => {
+      throw new Error("Fatal")
+    })
+
+    await bus.emit({
+      type: eventType,
+      payload: { data: "test" },
+    })
+
+    await new Promise((resolve) => setTimeout(resolve, 100))
+
+    expect(onError).toHaveBeenCalled()
+    const error = onError.mock.calls[0]?.[0]
+
+    // Verify it's a MaxRetriesExceededError instance
+    expect(error).toBeInstanceOf(MaxRetriesExceededError)
+    expect(error.name).toBe("MaxRetriesExceededError")
+    expect(error.message).toContain("exceeded")
+
+    // Verify retryCount property (maxRetries is 0, so this should be 1)
+    expect((error as MaxRetriesExceededError).retryCount).toBe(1)
+
+    // Verify event is bundled in error.context.event
+    const event = (error as MaxRetriesExceededError).context?.event
+    expect(event).toBeDefined()
+    expect(event?.type).toBe(eventType)
+  })
+})

package/src/index.ts

@@ -0,0 +1,2 @@
+export * from "./sqlite-better-sqlite3-outbox"
+export * from "./transaction-storage"