@saga-bus/store-sqlite 0.1.5

package/README.md

@@ -0,0 +1,67 @@
+# @saga-bus/store-sqlite
+
+SQLite saga store for saga-bus - perfect for local development and testing.
+
+## Installation
+
+```bash
+pnpm add @saga-bus/store-sqlite better-sqlite3
+```
+
+## Usage
+
+```typescript
+import Database from "better-sqlite3";
+import { SqliteSagaStore, createSchema } from "@saga-bus/store-sqlite";
+import { createBus } from "@saga-bus/core";
+
+// Create database (use ':memory:' for in-memory or a file path)
+const db = new Database(":memory:");
+
+// Initialize schema (run once)
+createSchema(db);
+
+// Create store
+const store = new SqliteSagaStore({ db });
+
+// Use with saga-bus
+const bus = createBus({
+  sagas: [{ definition: mySaga, store }],
+  transport,
+});
+
+await bus.start();
+```
+
+## Features
+
+- **Zero Docker required** - perfect for local development and testing
+- **In-memory mode** - use `':memory:'` for fast unit tests
+- **File-based** - persist to disk for development
+- **Synchronous operations** - uses better-sqlite3 for maximum performance
+- **Optimistic concurrency** - version-based conflict detection
+
+## API
+
+### `SqliteSagaStore`
+
+```typescript
+const store = new SqliteSagaStore({
+  db: Database,           // better-sqlite3 database instance
+  tableName?: string,     // Table name (default: 'saga_states')
+});
+```
+
+### `createSchema`
+
+Creates the required table in the database:
+
+```typescript
+createSchema(db);
+// Or with custom table name:
+createSchema(db, "my_saga_states");
+```
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,153 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  SqliteSagaStore: () => SqliteSagaStore,
+  createSchema: () => createSchema
+});
+module.exports = __toCommonJS(index_exports);
+var import_core = require("@saga-bus/core");
+var SqliteSagaStore = class {
+  db;
+  tableName;
+  statements;
+  constructor(options) {
+    this.db = options.db;
+    this.tableName = options.tableName ?? "saga_states";
+    this.statements = {
+      getById: this.db.prepare(`
+        SELECT saga_name, saga_id, correlation_id, state, version, created_at, updated_at
+        FROM ${this.tableName}
+        WHERE saga_name = ? AND saga_id = ?
+      `),
+      getByCorrelationId: this.db.prepare(`
+        SELECT saga_name, saga_id, correlation_id, state, version, created_at, updated_at
+        FROM ${this.tableName}
+        WHERE saga_name = ? AND correlation_id = ?
+      `),
+      insert: this.db.prepare(`
+        INSERT INTO ${this.tableName} (saga_name, saga_id, correlation_id, state, version, created_at, updated_at)
+        VALUES (?, ?, ?, ?, ?, ?, ?)
+      `),
+      update: this.db.prepare(`
+        UPDATE ${this.tableName}
+        SET state = ?, version = ?, updated_at = ?
+        WHERE saga_name = ? AND saga_id = ? AND version = ?
+      `),
+      delete: this.db.prepare(`
+        DELETE FROM ${this.tableName}
+        WHERE saga_name = ? AND saga_id = ?
+      `)
+    };
+  }
+  parseRow(row) {
+    return JSON.parse(row.state);
+  }
+  async getById(sagaName, sagaId) {
+    const row = this.statements.getById.get(sagaName, sagaId);
+    if (!row) {
+      return null;
+    }
+    return this.parseRow(row);
+  }
+  async getByCorrelationId(sagaName, correlationId) {
+    const row = this.statements.getByCorrelationId.get(
+      sagaName,
+      correlationId
+    );
+    if (!row) {
+      return null;
+    }
+    return this.parseRow(row);
+  }
+  async insert(sagaName, correlationId, state) {
+    const { sagaId, version, createdAt, updatedAt } = state.metadata;
+    const stateJson = JSON.stringify(state);
+    try {
+      this.statements.insert.run(
+        sagaName,
+        sagaId,
+        correlationId,
+        stateJson,
+        version,
+        createdAt.toISOString(),
+        updatedAt.toISOString()
+      );
+    } catch (error) {
+      if (error instanceof Error && error.message.includes("UNIQUE constraint failed")) {
+        throw new Error(`Saga ${sagaId} already exists`);
+      }
+      throw error;
+    }
+  }
+  async update(sagaName, state, expectedVersion) {
+    const { sagaId, version, updatedAt } = state.metadata;
+    const stateJson = JSON.stringify(state);
+    const result = this.statements.update.run(
+      stateJson,
+      version,
+      updatedAt.toISOString(),
+      sagaName,
+      sagaId,
+      expectedVersion
+    );
+    if (result.changes === 0) {
+      const existing = await this.getById(sagaName, sagaId);
+      if (!existing) {
+        throw new Error(`Saga ${sagaId} not found`);
+      }
+      throw new import_core.ConcurrencyError(
+        sagaId,
+        expectedVersion,
+        existing.metadata.version
+      );
+    }
+  }
+  async delete(sagaName, sagaId) {
+    this.statements.delete.run(sagaName, sagaId);
+  }
+};
+function createSchema(db, tableName = "saga_states") {
+  db.exec(`
+    CREATE TABLE IF NOT EXISTS ${tableName} (
+      saga_name TEXT NOT NULL,
+      saga_id TEXT NOT NULL,
+      correlation_id TEXT NOT NULL,
+      state TEXT NOT NULL,
+      version INTEGER NOT NULL,
+      created_at TEXT NOT NULL,
+      updated_at TEXT NOT NULL,
+      PRIMARY KEY (saga_name, saga_id)
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_${tableName}_correlation
+    ON ${tableName} (saga_name, correlation_id);
+
+    CREATE INDEX IF NOT EXISTS idx_${tableName}_updated_at
+    ON ${tableName} (updated_at);
+  `);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SqliteSagaStore,
+  createSchema
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import type { SagaStore, SagaState } from \"@saga-bus/core\";\nimport { ConcurrencyError } from \"@saga-bus/core\";\nimport type Database from \"better-sqlite3\";\n\nexport interface SqliteSagaStoreOptions {\n  /** better-sqlite3 database instance */\n  db: Database.Database;\n  /** Table name for saga states (default: 'saga_states') */\n  tableName?: string;\n}\n\ninterface StoredSaga {\n  saga_name: string;\n  saga_id: string;\n  correlation_id: string;\n  state: string;\n  version: number;\n  created_at: string;\n  updated_at: string;\n}\n\n/**\n * SQLite saga store - perfect for local development and testing.\n *\n * @example\n * ```typescript\n * import Database from 'better-sqlite3';\n * import { SqliteSagaStore, createSchema } from '@saga-bus/store-sqlite';\n *\n * const db = new Database(':memory:'); // or 'path/to/db.sqlite'\n * createSchema(db);\n *\n * const store = new SqliteSagaStore({ db });\n * ```\n */\nexport class SqliteSagaStore<TState extends SagaState>\n  implements SagaStore<TState>\n{\n  private readonly db: Database.Database;\n  private readonly tableName: string;\n  private readonly statements: {\n    getById: Database.Statement;\n    getByCorrelationId: Database.Statement;\n    insert: Database.Statement;\n    update: Database.Statement;\n    delete: Database.Statement;\n  };\n\n  constructor(options: SqliteSagaStoreOptions) {\n    this.db = options.db;\n    this.tableName = options.tableName ?? \"saga_states\";\n\n    // Prepare statements for better performance\n    this.statements = {\n      getById: this.db.prepare(`\n        SELECT saga_name, saga_id, correlation_id, state, version, created_at, updated_at\n        FROM ${this.tableName}\n        WHERE saga_name = ? AND saga_id = ?\n      `),\n      getByCorrelationId: this.db.prepare(`\n        SELECT saga_name, saga_id, correlation_id, state, version, created_at, updated_at\n        FROM ${this.tableName}\n        WHERE saga_name = ? AND correlation_id = ?\n      `),\n      insert: this.db.prepare(`\n        INSERT INTO ${this.tableName} (saga_name, saga_id, correlation_id, state, version, created_at, updated_at)\n        VALUES (?, ?, ?, ?, ?, ?, ?)\n      `),\n      update: this.db.prepare(`\n        UPDATE ${this.tableName}\n        SET state = ?, version = ?, updated_at = ?\n        WHERE saga_name = ? AND saga_id = ? AND version = ?\n      `),\n      delete: this.db.prepare(`\n        DELETE FROM ${this.tableName}\n        WHERE saga_name = ? AND saga_id = ?\n      `),\n    };\n  }\n\n  private parseRow(row: StoredSaga): TState {\n    return JSON.parse(row.state) as TState;\n  }\n\n  async getById(sagaName: string, sagaId: string): Promise<TState | null> {\n    const row = this.statements.getById.get(sagaName, sagaId) as\n      | StoredSaga\n      | undefined;\n\n    if (!row) {\n      return null;\n    }\n\n    return this.parseRow(row);\n  }\n\n  async getByCorrelationId(\n    sagaName: string,\n    correlationId: string\n  ): Promise<TState | null> {\n    const row = this.statements.getByCorrelationId.get(\n      sagaName,\n      correlationId\n    ) as StoredSaga | undefined;\n\n    if (!row) {\n      return null;\n    }\n\n    return this.parseRow(row);\n  }\n\n  async insert(\n    sagaName: string,\n    correlationId: string,\n    state: TState\n  ): Promise<void> {\n    const { sagaId, version, createdAt, updatedAt } = state.metadata;\n    const stateJson = JSON.stringify(state);\n\n    try {\n      this.statements.insert.run(\n        sagaName,\n        sagaId,\n        correlationId,\n        stateJson,\n        version,\n        createdAt.toISOString(),\n        updatedAt.toISOString()\n      );\n    } catch (error: unknown) {\n      if (\n        error instanceof Error &&\n        error.message.includes(\"UNIQUE constraint failed\")\n      ) {\n        throw new Error(`Saga ${sagaId} already exists`);\n      }\n      throw error;\n    }\n  }\n\n  async update(\n    sagaName: string,\n    state: TState,\n    expectedVersion: number\n  ): Promise<void> {\n    const { sagaId, version, updatedAt } = state.metadata;\n    const stateJson = JSON.stringify(state);\n\n    const result = this.statements.update.run(\n      stateJson,\n      version,\n      updatedAt.toISOString(),\n      sagaName,\n      sagaId,\n      expectedVersion\n    );\n\n    if (result.changes === 0) {\n      // Either saga doesn't exist or version mismatch\n      const existing = await this.getById(sagaName, sagaId);\n\n      if (!existing) {\n        throw new Error(`Saga ${sagaId} not found`);\n      }\n\n      throw new ConcurrencyError(\n        sagaId,\n        expectedVersion,\n        existing.metadata.version\n      );\n    }\n  }\n\n  async delete(sagaName: string, sagaId: string): Promise<void> {\n    this.statements.delete.run(sagaName, sagaId);\n  }\n}\n\n/**\n * Create the saga_states table in the SQLite database.\n *\n * @example\n * ```typescript\n * import Database from 'better-sqlite3';\n * import { createSchema } from '@saga-bus/store-sqlite';\n *\n * const db = new Database('sagas.db');\n * createSchema(db);\n * ```\n */\nexport function createSchema(\n  db: Database.Database,\n  tableName: string = \"saga_states\"\n): void {\n  db.exec(`\n    CREATE TABLE IF NOT EXISTS ${tableName} (\n      saga_name TEXT NOT NULL,\n      saga_id TEXT NOT NULL,\n      correlation_id TEXT NOT NULL,\n      state TEXT NOT NULL,\n      version INTEGER NOT NULL,\n      created_at TEXT NOT NULL,\n      updated_at TEXT NOT NULL,\n      PRIMARY KEY (saga_name, saga_id)\n    );\n\n    CREATE INDEX IF NOT EXISTS idx_${tableName}_correlation\n    ON ${tableName} (saga_name, correlation_id);\n\n    CREATE INDEX IF NOT EXISTS idx_${tableName}_updated_at\n    ON ${tableName} (updated_at);\n  `);\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,50 @@
+import { SagaState, SagaStore } from '@saga-bus/core';
+import Database from 'better-sqlite3';
+
+interface SqliteSagaStoreOptions {
+    /** better-sqlite3 database instance */
+    db: Database.Database;
+    /** Table name for saga states (default: 'saga_states') */
+    tableName?: string;
+}
+/**
+ * SQLite saga store - perfect for local development and testing.
+ *
+ * @example
+ * ```typescript
+ * import Database from 'better-sqlite3';
+ * import { SqliteSagaStore, createSchema } from '@saga-bus/store-sqlite';
+ *
+ * const db = new Database(':memory:'); // or 'path/to/db.sqlite'
+ * createSchema(db);
+ *
+ * const store = new SqliteSagaStore({ db });
+ * ```
+ */
+declare class SqliteSagaStore<TState extends SagaState> implements SagaStore<TState> {
+    private readonly db;
+    private readonly tableName;
+    private readonly statements;
+    constructor(options: SqliteSagaStoreOptions);
+    private parseRow;
+    getById(sagaName: string, sagaId: string): Promise<TState | null>;
+    getByCorrelationId(sagaName: string, correlationId: string): Promise<TState | null>;
+    insert(sagaName: string, correlationId: string, state: TState): Promise<void>;
+    update(sagaName: string, state: TState, expectedVersion: number): Promise<void>;
+    delete(sagaName: string, sagaId: string): Promise<void>;
+}
+/**
+ * Create the saga_states table in the SQLite database.
+ *
+ * @example
+ * ```typescript
+ * import Database from 'better-sqlite3';
+ * import { createSchema } from '@saga-bus/store-sqlite';
+ *
+ * const db = new Database('sagas.db');
+ * createSchema(db);
+ * ```
+ */
+declare function createSchema(db: Database.Database, tableName?: string): void;
+
+export { SqliteSagaStore, type SqliteSagaStoreOptions, createSchema };

package/dist/index.d.ts

@@ -0,0 +1,50 @@
+import { SagaState, SagaStore } from '@saga-bus/core';
+import Database from 'better-sqlite3';
+
+interface SqliteSagaStoreOptions {
+    /** better-sqlite3 database instance */
+    db: Database.Database;
+    /** Table name for saga states (default: 'saga_states') */
+    tableName?: string;
+}
+/**
+ * SQLite saga store - perfect for local development and testing.
+ *
+ * @example
+ * ```typescript
+ * import Database from 'better-sqlite3';
+ * import { SqliteSagaStore, createSchema } from '@saga-bus/store-sqlite';
+ *
+ * const db = new Database(':memory:'); // or 'path/to/db.sqlite'
+ * createSchema(db);
+ *
+ * const store = new SqliteSagaStore({ db });
+ * ```
+ */
+declare class SqliteSagaStore<TState extends SagaState> implements SagaStore<TState> {
+    private readonly db;
+    private readonly tableName;
+    private readonly statements;
+    constructor(options: SqliteSagaStoreOptions);
+    private parseRow;
+    getById(sagaName: string, sagaId: string): Promise<TState | null>;
+    getByCorrelationId(sagaName: string, correlationId: string): Promise<TState | null>;
+    insert(sagaName: string, correlationId: string, state: TState): Promise<void>;
+    update(sagaName: string, state: TState, expectedVersion: number): Promise<void>;
+    delete(sagaName: string, sagaId: string): Promise<void>;
+}
+/**
+ * Create the saga_states table in the SQLite database.
+ *
+ * @example
+ * ```typescript
+ * import Database from 'better-sqlite3';
+ * import { createSchema } from '@saga-bus/store-sqlite';
+ *
+ * const db = new Database('sagas.db');
+ * createSchema(db);
+ * ```
+ */
+declare function createSchema(db: Database.Database, tableName?: string): void;
+
+export { SqliteSagaStore, type SqliteSagaStoreOptions, createSchema };

package/dist/index.js

@@ -0,0 +1,127 @@
+// src/index.ts
+import { ConcurrencyError } from "@saga-bus/core";
+var SqliteSagaStore = class {
+  db;
+  tableName;
+  statements;
+  constructor(options) {
+    this.db = options.db;
+    this.tableName = options.tableName ?? "saga_states";
+    this.statements = {
+      getById: this.db.prepare(`
+        SELECT saga_name, saga_id, correlation_id, state, version, created_at, updated_at
+        FROM ${this.tableName}
+        WHERE saga_name = ? AND saga_id = ?
+      `),
+      getByCorrelationId: this.db.prepare(`
+        SELECT saga_name, saga_id, correlation_id, state, version, created_at, updated_at
+        FROM ${this.tableName}
+        WHERE saga_name = ? AND correlation_id = ?
+      `),
+      insert: this.db.prepare(`
+        INSERT INTO ${this.tableName} (saga_name, saga_id, correlation_id, state, version, created_at, updated_at)
+        VALUES (?, ?, ?, ?, ?, ?, ?)
+      `),
+      update: this.db.prepare(`
+        UPDATE ${this.tableName}
+        SET state = ?, version = ?, updated_at = ?
+        WHERE saga_name = ? AND saga_id = ? AND version = ?
+      `),
+      delete: this.db.prepare(`
+        DELETE FROM ${this.tableName}
+        WHERE saga_name = ? AND saga_id = ?
+      `)
+    };
+  }
+  parseRow(row) {
+    return JSON.parse(row.state);
+  }
+  async getById(sagaName, sagaId) {
+    const row = this.statements.getById.get(sagaName, sagaId);
+    if (!row) {
+      return null;
+    }
+    return this.parseRow(row);
+  }
+  async getByCorrelationId(sagaName, correlationId) {
+    const row = this.statements.getByCorrelationId.get(
+      sagaName,
+      correlationId
+    );
+    if (!row) {
+      return null;
+    }
+    return this.parseRow(row);
+  }
+  async insert(sagaName, correlationId, state) {
+    const { sagaId, version, createdAt, updatedAt } = state.metadata;
+    const stateJson = JSON.stringify(state);
+    try {
+      this.statements.insert.run(
+        sagaName,
+        sagaId,
+        correlationId,
+        stateJson,
+        version,
+        createdAt.toISOString(),
+        updatedAt.toISOString()
+      );
+    } catch (error) {
+      if (error instanceof Error && error.message.includes("UNIQUE constraint failed")) {
+        throw new Error(`Saga ${sagaId} already exists`);
+      }
+      throw error;
+    }
+  }
+  async update(sagaName, state, expectedVersion) {
+    const { sagaId, version, updatedAt } = state.metadata;
+    const stateJson = JSON.stringify(state);
+    const result = this.statements.update.run(
+      stateJson,
+      version,
+      updatedAt.toISOString(),
+      sagaName,
+      sagaId,
+      expectedVersion
+    );
+    if (result.changes === 0) {
+      const existing = await this.getById(sagaName, sagaId);
+      if (!existing) {
+        throw new Error(`Saga ${sagaId} not found`);
+      }
+      throw new ConcurrencyError(
+        sagaId,
+        expectedVersion,
+        existing.metadata.version
+      );
+    }
+  }
+  async delete(sagaName, sagaId) {
+    this.statements.delete.run(sagaName, sagaId);
+  }
+};
+function createSchema(db, tableName = "saga_states") {
+  db.exec(`
+    CREATE TABLE IF NOT EXISTS ${tableName} (
+      saga_name TEXT NOT NULL,
+      saga_id TEXT NOT NULL,
+      correlation_id TEXT NOT NULL,
+      state TEXT NOT NULL,
+      version INTEGER NOT NULL,
+      created_at TEXT NOT NULL,
+      updated_at TEXT NOT NULL,
+      PRIMARY KEY (saga_name, saga_id)
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_${tableName}_correlation
+    ON ${tableName} (saga_name, correlation_id);
+
+    CREATE INDEX IF NOT EXISTS idx_${tableName}_updated_at
+    ON ${tableName} (updated_at);
+  `);
+}
+export {
+  SqliteSagaStore,
+  createSchema
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import type { SagaStore, SagaState } from \"@saga-bus/core\";\nimport { ConcurrencyError } from \"@saga-bus/core\";\nimport type Database from \"better-sqlite3\";\n\nexport interface SqliteSagaStoreOptions {\n  /** better-sqlite3 database instance */\n  db: Database.Database;\n  /** Table name for saga states (default: 'saga_states') */\n  tableName?: string;\n}\n\ninterface StoredSaga {\n  saga_name: string;\n  saga_id: string;\n  correlation_id: string;\n  state: string;\n  version: number;\n  created_at: string;\n  updated_at: string;\n}\n\n/**\n * SQLite saga store - perfect for local development and testing.\n *\n * @example\n * ```typescript\n * import Database from 'better-sqlite3';\n * import { SqliteSagaStore, createSchema } from '@saga-bus/store-sqlite';\n *\n * const db = new Database(':memory:'); // or 'path/to/db.sqlite'\n * createSchema(db);\n *\n * const store = new SqliteSagaStore({ db });\n * ```\n */\nexport class SqliteSagaStore<TState extends SagaState>\n  implements SagaStore<TState>\n{\n  private readonly db: Database.Database;\n  private readonly tableName: string;\n  private readonly statements: {\n    getById: Database.Statement;\n    getByCorrelationId: Database.Statement;\n    insert: Database.Statement;\n    update: Database.Statement;\n    delete: Database.Statement;\n  };\n\n  constructor(options: SqliteSagaStoreOptions) {\n    this.db = options.db;\n    this.tableName = options.tableName ?? \"saga_states\";\n\n    // Prepare statements for better performance\n    this.statements = {\n      getById: this.db.prepare(`\n        SELECT saga_name, saga_id, correlation_id, state, version, created_at, updated_at\n        FROM ${this.tableName}\n        WHERE saga_name = ? AND saga_id = ?\n      `),\n      getByCorrelationId: this.db.prepare(`\n        SELECT saga_name, saga_id, correlation_id, state, version, created_at, updated_at\n        FROM ${this.tableName}\n        WHERE saga_name = ? AND correlation_id = ?\n      `),\n      insert: this.db.prepare(`\n        INSERT INTO ${this.tableName} (saga_name, saga_id, correlation_id, state, version, created_at, updated_at)\n        VALUES (?, ?, ?, ?, ?, ?, ?)\n      `),\n      update: this.db.prepare(`\n        UPDATE ${this.tableName}\n        SET state = ?, version = ?, updated_at = ?\n        WHERE saga_name = ? AND saga_id = ? AND version = ?\n      `),\n      delete: this.db.prepare(`\n        DELETE FROM ${this.tableName}\n        WHERE saga_name = ? AND saga_id = ?\n      `),\n    };\n  }\n\n  private parseRow(row: StoredSaga): TState {\n    return JSON.parse(row.state) as TState;\n  }\n\n  async getById(sagaName: string, sagaId: string): Promise<TState | null> {\n    const row = this.statements.getById.get(sagaName, sagaId) as\n      | StoredSaga\n      | undefined;\n\n    if (!row) {\n      return null;\n    }\n\n    return this.parseRow(row);\n  }\n\n  async getByCorrelationId(\n    sagaName: string,\n    correlationId: string\n  ): Promise<TState | null> {\n    const row = this.statements.getByCorrelationId.get(\n      sagaName,\n      correlationId\n    ) as StoredSaga | undefined;\n\n    if (!row) {\n      return null;\n    }\n\n    return this.parseRow(row);\n  }\n\n  async insert(\n    sagaName: string,\n    correlationId: string,\n    state: TState\n  ): Promise<void> {\n    const { sagaId, version, createdAt, updatedAt } = state.metadata;\n    const stateJson = JSON.stringify(state);\n\n    try {\n      this.statements.insert.run(\n        sagaName,\n        sagaId,\n        correlationId,\n        stateJson,\n        version,\n        createdAt.toISOString(),\n        updatedAt.toISOString()\n      );\n    } catch (error: unknown) {\n      if (\n        error instanceof Error &&\n        error.message.includes(\"UNIQUE constraint failed\")\n      ) {\n        throw new Error(`Saga ${sagaId} already exists`);\n      }\n      throw error;\n    }\n  }\n\n  async update(\n    sagaName: string,\n    state: TState,\n    expectedVersion: number\n  ): Promise<void> {\n    const { sagaId, version, updatedAt } = state.metadata;\n    const stateJson = JSON.stringify(state);\n\n    const result = this.statements.update.run(\n      stateJson,\n      version,\n      updatedAt.toISOString(),\n      sagaName,\n      sagaId,\n      expectedVersion\n    );\n\n    if (result.changes === 0) {\n      // Either saga doesn't exist or version mismatch\n      const existing = await this.getById(sagaName, sagaId);\n\n      if (!existing) {\n        throw new Error(`Saga ${sagaId} not found`);\n      }\n\n      throw new ConcurrencyError(\n        sagaId,\n        expectedVersion,\n        existing.metadata.version\n      );\n    }\n  }\n\n  async delete(sagaName: string, sagaId: string): Promise<void> {\n    this.statements.delete.run(sagaName, sagaId);\n  }\n}\n\n/**\n * Create the saga_states table in the SQLite database.\n *\n * @example\n * ```typescript\n * import Database from 'better-sqlite3';\n * import { createSchema } from '@saga-bus/store-sqlite';\n *\n * const db = new Database('sagas.db');\n * createSchema(db);\n * ```\n */\nexport function createSchema(\n  db: Database.Database,\n  tableName: string = \"saga_states\"\n): void {\n  db.exec(`\n    CREATE TABLE IF NOT EXISTS ${tableName} (\n      saga_name TEXT NOT NULL,\n      saga_id TEXT NOT NULL,\n      correlation_id TEXT NOT NULL,\n      state TEXT NOT NULL,\n      version INTEGER NOT NULL,\n      created_at TEXT NOT NULL,\n      updated_at TEXT NOT NULL,\n      PRIMARY KEY (saga_name, saga_id)\n    );\n\n    CREATE INDEX IF NOT EXISTS idx_${tableName}_correlation\n    ON ${tableName} (saga_name, correlation_id);\n\n    CREATE INDEX IF NOT EXISTS idx_${tableName}_updated_at\n    ON ${tableName} (updated_at);\n  `);\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@saga-bus/store-sqlite",
+  "version": "0.1.5",
+  "description": "SQLite saga store for saga-bus - perfect for local development and testing",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "eslint src/",
+    "check-types": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@saga-bus/core": "workspace:*"
+  },
+  "peerDependencies": {
+    "better-sqlite3": ">=9.0.0"
+  },
+  "devDependencies": {
+    "@repo/eslint-config": "workspace:*",
+    "@repo/typescript-config": "workspace:*",
+    "@types/better-sqlite3": "^7.6.8",
+    "@types/node": "^22.10.1",
+    "better-sqlite3": "^11.0.0",
+    "eslint": "^9.16.0",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "vitest": "^3.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/d-e-a-n-f/saga-bus.git",
+    "directory": "packages/store-sqlite"
+  },
+  "bugs": {
+    "url": "https://github.com/d-e-a-n-f/saga-bus/issues"
+  },
+  "homepage": "https://github.com/d-e-a-n-f/saga-bus#readme",
+  "keywords": [
+    "saga-bus",
+    "saga",
+    "sqlite",
+    "store",
+    "state-machine",
+    "local-development"
+  ]
+}