@saga-bus/store-mysql 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Dean Foran
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,260 @@
+# @saga-bus/store-mysql
+
+MySQL / MariaDB saga store for saga-bus.
+
+## Installation
+
+```bash
+npm install @saga-bus/store-mysql mysql2
+# or
+pnpm add @saga-bus/store-mysql mysql2
+```
+
+## Features
+
+- **MySQL 5.7+**: Native JSON column support
+- **MariaDB 10.2+**: Compatible with MariaDB
+- **Cloud Databases**: Works with PlanetScale, Vitess, AWS Aurora
+- **Optimistic Concurrency**: Version-based conflict detection
+- **Connection Pooling**: Built-in pool management
+- **Query Helpers**: Find, count, and cleanup methods
+
+## Quick Start
+
+```typescript
+import { createBus } from "@saga-bus/core";
+import { MySqlSagaStore } from "@saga-bus/store-mysql";
+
+const store = new MySqlSagaStore({
+  pool: {
+    host: "localhost",
+    user: "root",
+    password: "password",
+    database: "sagas",
+  },
+});
+
+await store.initialize();
+
+const bus = createBus({
+  store,
+  // ... other config
+});
+
+await bus.start();
+```
+
+## Configuration
+
+```typescript
+interface MySqlSagaStoreOptions {
+  /** Connection pool or pool configuration */
+  pool: Pool | PoolOptions;
+
+  /** Table name for saga instances (default: "saga_instances") */
+  tableName?: string;
+}
+```
+
+## Database Schema
+
+Create the required table:
+
+```sql
+CREATE TABLE saga_instances (
+  id             VARCHAR(128) NOT NULL,
+  saga_name      VARCHAR(128) NOT NULL,
+  correlation_id VARCHAR(256) NOT NULL,
+  version        INT NOT NULL,
+  is_completed   BOOLEAN NOT NULL DEFAULT FALSE,
+  state          JSON NOT NULL,
+  created_at     TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  updated_at     TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+
+  PRIMARY KEY (saga_name, id),
+  UNIQUE KEY idx_correlation (saga_name, correlation_id),
+  KEY idx_cleanup (saga_name, is_completed, updated_at)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
+```
+
+## Examples
+
+### Basic Usage
+
+```typescript
+import { MySqlSagaStore } from "@saga-bus/store-mysql";
+
+const store = new MySqlSagaStore({
+  pool: {
+    host: "localhost",
+    user: "root",
+    password: "password",
+    database: "sagas",
+  },
+});
+
+await store.initialize();
+
+// Find by saga ID
+const state = await store.getById("OrderSaga", "saga-123");
+
+// Find by correlation ID
+const stateByCorr = await store.getByCorrelationId("OrderSaga", "order-456");
+
+// Insert new saga
+await store.insert("OrderSaga", "order-789", {
+  orderId: "order-789",
+  status: "pending",
+  metadata: {
+    sagaId: "saga-new",
+    version: 1,
+    isCompleted: false,
+    createdAt: new Date(),
+    updatedAt: new Date(),
+    archivedAt: null,
+    timeoutMs: null,
+    timeoutExpiresAt: null,
+  },
+});
+
+// Update with concurrency check
+await store.update("OrderSaga", updatedState, expectedVersion);
+
+// Delete
+await store.delete("OrderSaga", "saga-123");
+```
+
+### With PlanetScale
+
+```typescript
+const store = new MySqlSagaStore({
+  pool: {
+    host: "aws.connect.psdb.cloud",
+    user: "your-username",
+    password: "your-password",
+    database: "your-database",
+    ssl: { rejectUnauthorized: true },
+  },
+});
+```
+
+### With Existing Connection Pool
+
+```typescript
+import { createPool } from "mysql2/promise";
+
+const pool = createPool({
+  host: "localhost",
+  user: "root",
+  password: "password",
+  database: "sagas",
+  connectionLimit: 10,
+});
+
+const store = new MySqlSagaStore({
+  pool, // Use existing pool
+});
+
+await store.initialize();
+```
+
+### Query Helpers
+
+```typescript
+// Find sagas by name with pagination
+const sagas = await store.findByName("OrderSaga", {
+  limit: 10,
+  offset: 0,
+  completed: false,
+});
+
+// Count sagas
+const total = await store.countByName("OrderSaga");
+const completed = await store.countByName("OrderSaga", { completed: true });
+
+// Cleanup old completed sagas
+const oneWeekAgo = new Date(Date.now() - 7 * 24 * 60 * 60 * 1000);
+const deleted = await store.deleteCompletedBefore("OrderSaga", oneWeekAgo);
+console.log(`Deleted ${deleted} completed sagas`);
+```
+
+## Optimistic Concurrency
+
+The store uses version-based optimistic concurrency control:
+
+```typescript
+// Read current state
+const state = await store.getById("OrderSaga", "saga-123");
+const expectedVersion = state.metadata.version;
+
+// Make changes
+state.status = "completed";
+state.metadata.version += 1;
+state.metadata.updatedAt = new Date();
+
+try {
+  // Update with version check
+  await store.update("OrderSaga", state, expectedVersion);
+} catch (error) {
+  if (error instanceof ConcurrencyError) {
+    // State was modified by another process
+    // Reload and retry
+  }
+}
+```
+
+## Error Handling
+
+```typescript
+import { ConcurrencyError } from "@saga-bus/core";
+
+try {
+  await store.update("OrderSaga", state, expectedVersion);
+} catch (error) {
+  if (error instanceof ConcurrencyError) {
+    console.log(`Concurrency conflict: expected v${error.expectedVersion}, actual v${error.actualVersion}`);
+  }
+}
+```
+
+## Testing
+
+For local development, you can run MySQL in Docker:
+
+```bash
+docker run -e MYSQL_ROOT_PASSWORD=password -e MYSQL_DATABASE=sagas \
+  -p 3306:3306 --name mysql \
+  mysql:8
+```
+
+Then create the table:
+
+```bash
+docker exec -it mysql mysql -uroot -ppassword sagas -e "
+CREATE TABLE saga_instances (
+  id VARCHAR(128) NOT NULL,
+  saga_name VARCHAR(128) NOT NULL,
+  correlation_id VARCHAR(256) NOT NULL,
+  version INT NOT NULL,
+  is_completed BOOLEAN NOT NULL DEFAULT FALSE,
+  state JSON NOT NULL,
+  created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  updated_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+  PRIMARY KEY (saga_name, id),
+  UNIQUE KEY idx_correlation (saga_name, correlation_id),
+  KEY idx_cleanup (saga_name, is_completed, updated_at)
+) ENGINE=InnoDB;
+"
+```
+
+For unit tests, use an in-memory store:
+
+```typescript
+import { InMemorySagaStore } from "@saga-bus/core";
+
+const testStore = new InMemorySagaStore();
+```
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,235 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  MySqlSagaStore: () => MySqlSagaStore
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/MySqlSagaStore.ts
+var mysql = __toESM(require("mysql2/promise"), 1);
+var import_core = require("@saga-bus/core");
+var MySqlSagaStore = class {
+  pool = null;
+  poolOptions;
+  tableName;
+  ownsPool;
+  constructor(options) {
+    if (typeof options.pool.query === "function") {
+      this.pool = options.pool;
+      this.poolOptions = null;
+      this.ownsPool = false;
+    } else {
+      this.poolOptions = options.pool;
+      this.ownsPool = true;
+    }
+    this.tableName = options.tableName ?? "saga_instances";
+  }
+  /**
+   * Initialize the connection pool if using config.
+   */
+  async initialize() {
+    if (this.poolOptions && !this.pool) {
+      this.pool = mysql.createPool(this.poolOptions);
+    }
+  }
+  async getById(sagaName, sagaId) {
+    if (!this.pool) throw new Error("Store not initialized");
+    const [rows] = await this.pool.query(
+      `SELECT * FROM \`${this.tableName}\` WHERE id = ? AND saga_name = ?`,
+      [sagaId, sagaName]
+    );
+    if (rows.length === 0) {
+      return null;
+    }
+    return this.rowToState(rows[0]);
+  }
+  async getByCorrelationId(sagaName, correlationId) {
+    if (!this.pool) throw new Error("Store not initialized");
+    const [rows] = await this.pool.query(
+      `SELECT * FROM \`${this.tableName}\` WHERE saga_name = ? AND correlation_id = ?`,
+      [sagaName, correlationId]
+    );
+    if (rows.length === 0) {
+      return null;
+    }
+    return this.rowToState(rows[0]);
+  }
+  async insert(sagaName, correlationId, state) {
+    if (!this.pool) throw new Error("Store not initialized");
+    const { sagaId, version, isCompleted, createdAt, updatedAt } = state.metadata;
+    await this.pool.query(
+      `INSERT INTO \`${this.tableName}\`
+       (id, saga_name, correlation_id, version, is_completed, state, created_at, updated_at)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?)`,
+      [
+        sagaId,
+        sagaName,
+        correlationId,
+        version,
+        isCompleted ? 1 : 0,
+        JSON.stringify(state),
+        createdAt,
+        updatedAt
+      ]
+    );
+  }
+  async update(sagaName, state, expectedVersion) {
+    if (!this.pool) throw new Error("Store not initialized");
+    const { sagaId, version, isCompleted, updatedAt } = state.metadata;
+    const [result] = await this.pool.query(
+      `UPDATE \`${this.tableName}\`
+       SET version = ?, is_completed = ?, state = ?, updated_at = ?
+       WHERE id = ? AND saga_name = ? AND version = ?`,
+      [
+        version,
+        isCompleted ? 1 : 0,
+        JSON.stringify(state),
+        updatedAt,
+        sagaId,
+        sagaName,
+        expectedVersion
+      ]
+    );
+    if (result.affectedRows === 0) {
+      const existing = await this.getById(sagaName, sagaId);
+      if (existing) {
+        throw new import_core.ConcurrencyError(
+          sagaId,
+          expectedVersion,
+          existing.metadata.version
+        );
+      } else {
+        throw new Error(`Saga ${sagaId} not found`);
+      }
+    }
+  }
+  async delete(sagaName, sagaId) {
+    if (!this.pool) throw new Error("Store not initialized");
+    await this.pool.query(
+      `DELETE FROM \`${this.tableName}\` WHERE id = ? AND saga_name = ?`,
+      [sagaId, sagaName]
+    );
+  }
+  /**
+   * Convert a database row to saga state.
+   */
+  rowToState(row) {
+    const state = JSON.parse(row.state);
+    return {
+      ...state,
+      metadata: {
+        ...state.metadata,
+        sagaId: row.id,
+        version: row.version,
+        isCompleted: row.is_completed === 1,
+        createdAt: new Date(row.created_at),
+        updatedAt: new Date(row.updated_at)
+      }
+    };
+  }
+  /**
+   * Close the connection pool (if owned by this store).
+   */
+  async close() {
+    if (this.ownsPool && this.pool) {
+      await this.pool.end();
+    }
+    this.pool = null;
+  }
+  /**
+   * Get the underlying pool for advanced operations.
+   */
+  getPool() {
+    return this.pool;
+  }
+  // ============ Query Helpers ============
+  /**
+   * Find sagas by name with pagination.
+   */
+  async findByName(sagaName, options) {
+    if (!this.pool) throw new Error("Store not initialized");
+    let query = `SELECT * FROM \`${this.tableName}\` WHERE saga_name = ?`;
+    const params = [sagaName];
+    if (options?.completed !== void 0) {
+      query += ` AND is_completed = ?`;
+      params.push(options.completed ? 1 : 0);
+    }
+    query += ` ORDER BY created_at DESC`;
+    if (options?.limit !== void 0) {
+      query += ` LIMIT ?`;
+      params.push(options.limit);
+    }
+    if (options?.offset !== void 0) {
+      query += ` OFFSET ?`;
+      params.push(options.offset);
+    }
+    const [rows] = await this.pool.query(
+      query,
+      params
+    );
+    return rows.map((row) => this.rowToState(row));
+  }
+  /**
+   * Count sagas by name.
+   */
+  async countByName(sagaName, options) {
+    if (!this.pool) throw new Error("Store not initialized");
+    let query = `SELECT COUNT(*) as count FROM \`${this.tableName}\` WHERE saga_name = ?`;
+    const params = [sagaName];
+    if (options?.completed !== void 0) {
+      query += ` AND is_completed = ?`;
+      params.push(options.completed ? 1 : 0);
+    }
+    const [rows] = await this.pool.query(
+      query,
+      params
+    );
+    return rows[0]?.count ?? 0;
+  }
+  /**
+   * Delete completed sagas older than a given date.
+   */
+  async deleteCompletedBefore(sagaName, before) {
+    if (!this.pool) throw new Error("Store not initialized");
+    const [result] = await this.pool.query(
+      `DELETE FROM \`${this.tableName}\`
+       WHERE saga_name = ? AND is_completed = 1 AND updated_at < ?`,
+      [sagaName, before]
+    );
+    return result.affectedRows;
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  MySqlSagaStore
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/MySqlSagaStore.ts"],"sourcesContent":["export { MySqlSagaStore } from \"./MySqlSagaStore.js\";\nexport type { MySqlSagaStoreOptions, SagaInstanceRow } from \"./types.js\";\n","import * as mysql from \"mysql2/promise\";\nimport type { SagaStore, SagaState } from \"@saga-bus/core\";\nimport { ConcurrencyError } from \"@saga-bus/core\";\nimport type { MySqlSagaStoreOptions, SagaInstanceRow } from \"./types.js\";\n\ntype RowDataPacket = mysql.RowDataPacket;\ntype ResultSetHeader = mysql.ResultSetHeader;\ntype PoolOptions = mysql.PoolOptions;\ntype FieldPacket = mysql.FieldPacket;\n\n// mysql2 types have issues with the mixin pattern, so we define our own interface\ninterface QueryablePool {\n  query<T extends mysql.RowDataPacket[][] | mysql.RowDataPacket[] | mysql.OkPacket | mysql.OkPacket[] | mysql.ResultSetHeader>(\n    sql: string,\n    values?: unknown[]\n  ): Promise<[T, FieldPacket[]]>;\n  end(): Promise<void>;\n  getConnection(): Promise<mysql.PoolConnection>;\n}\n\n/**\n * MySQL-backed saga store for saga-bus.\n *\n * @example\n * ```typescript\n * const store = new MySqlSagaStore<OrderState>({\n *   pool: {\n *     host: \"localhost\",\n *     user: \"root\",\n *     password: \"password\",\n *     database: \"sagas\",\n *   },\n * });\n *\n * await store.initialize();\n * ```\n */\nexport class MySqlSagaStore<TState extends SagaState>\n  implements SagaStore<TState>\n{\n  private pool: QueryablePool | null = null;\n  private readonly poolOptions: PoolOptions | null;\n  private readonly tableName: string;\n  private readonly ownsPool: boolean;\n\n  constructor(options: MySqlSagaStoreOptions) {\n    // Check if it's a Pool by looking for query method\n    if (typeof (options.pool as QueryablePool).query === \"function\") {\n      this.pool = options.pool as QueryablePool;\n      this.poolOptions = null;\n      this.ownsPool = false;\n    } else {\n      this.poolOptions = options.pool as PoolOptions;\n      this.ownsPool = true;\n    }\n\n    this.tableName = options.tableName ?? \"saga_instances\";\n  }\n\n  /**\n   * Initialize the connection pool if using config.\n   */\n  async initialize(): Promise<void> {\n    if (this.poolOptions && !this.pool) {\n      this.pool = mysql.createPool(this.poolOptions) as unknown as QueryablePool;\n    }\n  }\n\n  async getById(sagaName: string, sagaId: string): Promise<TState | null> {\n    if (!this.pool) throw new Error(\"Store not initialized\");\n\n    const [rows] = await this.pool.query<(SagaInstanceRow & RowDataPacket)[]>(\n      `SELECT * FROM \\`${this.tableName}\\` WHERE id = ? AND saga_name = ?`,\n      [sagaId, sagaName]\n    );\n\n    if (rows.length === 0) {\n      return null;\n    }\n\n    return this.rowToState(rows[0]!);\n  }\n\n  async getByCorrelationId(\n    sagaName: string,\n    correlationId: string\n  ): Promise<TState | null> {\n    if (!this.pool) throw new Error(\"Store not initialized\");\n\n    const [rows] = await this.pool.query<(SagaInstanceRow & RowDataPacket)[]>(\n      `SELECT * FROM \\`${this.tableName}\\` WHERE saga_name = ? AND correlation_id = ?`,\n      [sagaName, correlationId]\n    );\n\n    if (rows.length === 0) {\n      return null;\n    }\n\n    return this.rowToState(rows[0]!);\n  }\n\n  async insert(\n    sagaName: string,\n    correlationId: string,\n    state: TState\n  ): Promise<void> {\n    if (!this.pool) throw new Error(\"Store not initialized\");\n\n    const { sagaId, version, isCompleted, createdAt, updatedAt } =\n      state.metadata;\n\n    await this.pool.query(\n      `INSERT INTO \\`${this.tableName}\\`\n       (id, saga_name, correlation_id, version, is_completed, state, created_at, updated_at)\n       VALUES (?, ?, ?, ?, ?, ?, ?, ?)`,\n      [\n        sagaId,\n        sagaName,\n        correlationId,\n        version,\n        isCompleted ? 1 : 0,\n        JSON.stringify(state),\n        createdAt,\n        updatedAt,\n      ]\n    );\n  }\n\n  async update(\n    sagaName: string,\n    state: TState,\n    expectedVersion: number\n  ): Promise<void> {\n    if (!this.pool) throw new Error(\"Store not initialized\");\n\n    const { sagaId, version, isCompleted, updatedAt } = state.metadata;\n\n    const [result] = await this.pool.query<ResultSetHeader>(\n      `UPDATE \\`${this.tableName}\\`\n       SET version = ?, is_completed = ?, state = ?, updated_at = ?\n       WHERE id = ? AND saga_name = ? AND version = ?`,\n      [\n        version,\n        isCompleted ? 1 : 0,\n        JSON.stringify(state),\n        updatedAt,\n        sagaId,\n        sagaName,\n        expectedVersion,\n      ]\n    );\n\n    if (result.affectedRows === 0) {\n      // Either saga doesn't exist or version mismatch\n      const existing = await this.getById(sagaName, sagaId);\n      if (existing) {\n        throw new ConcurrencyError(\n          sagaId,\n          expectedVersion,\n          existing.metadata.version\n        );\n      } else {\n        throw new Error(`Saga ${sagaId} not found`);\n      }\n    }\n  }\n\n  async delete(sagaName: string, sagaId: string): Promise<void> {\n    if (!this.pool) throw new Error(\"Store not initialized\");\n\n    await this.pool.query(\n      `DELETE FROM \\`${this.tableName}\\` WHERE id = ? AND saga_name = ?`,\n      [sagaId, sagaName]\n    );\n  }\n\n  /**\n   * Convert a database row to saga state.\n   */\n  private rowToState(row: SagaInstanceRow): TState {\n    const state = JSON.parse(row.state) as TState;\n\n    // Ensure metadata dates are Date objects\n    return {\n      ...state,\n      metadata: {\n        ...state.metadata,\n        sagaId: row.id,\n        version: row.version,\n        isCompleted: row.is_completed === 1,\n        createdAt: new Date(row.created_at),\n        updatedAt: new Date(row.updated_at),\n      },\n    };\n  }\n\n  /**\n   * Close the connection pool (if owned by this store).\n   */\n  async close(): Promise<void> {\n    if (this.ownsPool && this.pool) {\n      await this.pool.end();\n    }\n    this.pool = null;\n  }\n\n  /**\n   * Get the underlying pool for advanced operations.\n   */\n  getPool(): QueryablePool | null {\n    return this.pool;\n  }\n\n  // ============ Query Helpers ============\n\n  /**\n   * Find sagas by name with pagination.\n   */\n  async findByName(\n    sagaName: string,\n    options?: {\n      limit?: number;\n      offset?: number;\n      completed?: boolean;\n    }\n  ): Promise<TState[]> {\n    if (!this.pool) throw new Error(\"Store not initialized\");\n\n    let query = `SELECT * FROM \\`${this.tableName}\\` WHERE saga_name = ?`;\n    const params: (string | number | boolean)[] = [sagaName];\n\n    if (options?.completed !== undefined) {\n      query += ` AND is_completed = ?`;\n      params.push(options.completed ? 1 : 0);\n    }\n\n    query += ` ORDER BY created_at DESC`;\n\n    if (options?.limit !== undefined) {\n      query += ` LIMIT ?`;\n      params.push(options.limit);\n    }\n\n    if (options?.offset !== undefined) {\n      query += ` OFFSET ?`;\n      params.push(options.offset);\n    }\n\n    const [rows] = await this.pool.query<(SagaInstanceRow & RowDataPacket)[]>(\n      query,\n      params\n    );\n\n    return rows.map((row) => this.rowToState(row));\n  }\n\n  /**\n   * Count sagas by name.\n   */\n  async countByName(\n    sagaName: string,\n    options?: { completed?: boolean }\n  ): Promise<number> {\n    if (!this.pool) throw new Error(\"Store not initialized\");\n\n    let query = `SELECT COUNT(*) as count FROM \\`${this.tableName}\\` WHERE saga_name = ?`;\n    const params: (string | number)[] = [sagaName];\n\n    if (options?.completed !== undefined) {\n      query += ` AND is_completed = ?`;\n      params.push(options.completed ? 1 : 0);\n    }\n\n    const [rows] = await this.pool.query<({ count: number } & RowDataPacket)[]>(\n      query,\n      params\n    );\n\n    return rows[0]?.count ?? 0;\n  }\n\n  /**\n   * Delete completed sagas older than a given date.\n   */\n  async deleteCompletedBefore(\n    sagaName: string,\n    before: Date\n  ): Promise<number> {\n    if (!this.pool) throw new Error(\"Store not initialized\");\n\n    const [result] = await this.pool.query<ResultSetHeader>(\n      `DELETE FROM \\`${this.tableName}\\`\n       WHERE saga_name = ? AND is_completed = 1 AND updated_at < ?`,\n      [sagaName, before]\n    );\n\n    return result.affectedRows;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,103 @@
+import * as mysql from 'mysql2/promise';
+import { SagaState, SagaStore } from '@saga-bus/core';
+
+type Pool = mysql.Pool;
+type PoolOptions = mysql.PoolOptions;
+/**
+ * Options for creating a MySqlSagaStore.
+ */
+interface MySqlSagaStoreOptions {
+    /**
+     * MySQL connection pool or pool configuration.
+     */
+    pool: Pool | PoolOptions;
+    /**
+     * Table name for saga instances. Default: "saga_instances"
+     */
+    tableName?: string;
+}
+/**
+ * Row structure in the saga_instances table.
+ */
+interface SagaInstanceRow {
+    id: string;
+    saga_name: string;
+    correlation_id: string;
+    version: number;
+    is_completed: number;
+    state: string;
+    created_at: Date;
+    updated_at: Date;
+}
+
+type FieldPacket = mysql.FieldPacket;
+interface QueryablePool {
+    query<T extends mysql.RowDataPacket[][] | mysql.RowDataPacket[] | mysql.OkPacket | mysql.OkPacket[] | mysql.ResultSetHeader>(sql: string, values?: unknown[]): Promise<[T, FieldPacket[]]>;
+    end(): Promise<void>;
+    getConnection(): Promise<mysql.PoolConnection>;
+}
+/**
+ * MySQL-backed saga store for saga-bus.
+ *
+ * @example
+ * ```typescript
+ * const store = new MySqlSagaStore<OrderState>({
+ *   pool: {
+ *     host: "localhost",
+ *     user: "root",
+ *     password: "password",
+ *     database: "sagas",
+ *   },
+ * });
+ *
+ * await store.initialize();
+ * ```
+ */
+declare class MySqlSagaStore<TState extends SagaState> implements SagaStore<TState> {
+    private pool;
+    private readonly poolOptions;
+    private readonly tableName;
+    private readonly ownsPool;
+    constructor(options: MySqlSagaStoreOptions);
+    /**
+     * Initialize the connection pool if using config.
+     */
+    initialize(): Promise<void>;
+    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>;
+    /**
+     * Convert a database row to saga state.
+     */
+    private rowToState;
+    /**
+     * Close the connection pool (if owned by this store).
+     */
+    close(): Promise<void>;
+    /**
+     * Get the underlying pool for advanced operations.
+     */
+    getPool(): QueryablePool | null;
+    /**
+     * Find sagas by name with pagination.
+     */
+    findByName(sagaName: string, options?: {
+        limit?: number;
+        offset?: number;
+        completed?: boolean;
+    }): Promise<TState[]>;
+    /**
+     * Count sagas by name.
+     */
+    countByName(sagaName: string, options?: {
+        completed?: boolean;
+    }): Promise<number>;
+    /**
+     * Delete completed sagas older than a given date.
+     */
+    deleteCompletedBefore(sagaName: string, before: Date): Promise<number>;
+}
+
+export { MySqlSagaStore, type MySqlSagaStoreOptions, type SagaInstanceRow };

package/dist/index.d.ts

@@ -0,0 +1,103 @@
+import * as mysql from 'mysql2/promise';
+import { SagaState, SagaStore } from '@saga-bus/core';
+
+type Pool = mysql.Pool;
+type PoolOptions = mysql.PoolOptions;
+/**
+ * Options for creating a MySqlSagaStore.
+ */
+interface MySqlSagaStoreOptions {
+    /**
+     * MySQL connection pool or pool configuration.
+     */
+    pool: Pool | PoolOptions;
+    /**
+     * Table name for saga instances. Default: "saga_instances"
+     */
+    tableName?: string;
+}
+/**
+ * Row structure in the saga_instances table.
+ */
+interface SagaInstanceRow {
+    id: string;
+    saga_name: string;
+    correlation_id: string;
+    version: number;
+    is_completed: number;
+    state: string;
+    created_at: Date;
+    updated_at: Date;
+}
+
+type FieldPacket = mysql.FieldPacket;
+interface QueryablePool {
+    query<T extends mysql.RowDataPacket[][] | mysql.RowDataPacket[] | mysql.OkPacket | mysql.OkPacket[] | mysql.ResultSetHeader>(sql: string, values?: unknown[]): Promise<[T, FieldPacket[]]>;
+    end(): Promise<void>;
+    getConnection(): Promise<mysql.PoolConnection>;
+}
+/**
+ * MySQL-backed saga store for saga-bus.
+ *
+ * @example
+ * ```typescript
+ * const store = new MySqlSagaStore<OrderState>({
+ *   pool: {
+ *     host: "localhost",
+ *     user: "root",
+ *     password: "password",
+ *     database: "sagas",
+ *   },
+ * });
+ *
+ * await store.initialize();
+ * ```
+ */
+declare class MySqlSagaStore<TState extends SagaState> implements SagaStore<TState> {
+    private pool;
+    private readonly poolOptions;
+    private readonly tableName;
+    private readonly ownsPool;
+    constructor(options: MySqlSagaStoreOptions);
+    /**
+     * Initialize the connection pool if using config.
+     */
+    initialize(): Promise<void>;
+    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>;
+    /**
+     * Convert a database row to saga state.
+     */
+    private rowToState;
+    /**
+     * Close the connection pool (if owned by this store).
+     */
+    close(): Promise<void>;
+    /**
+     * Get the underlying pool for advanced operations.
+     */
+    getPool(): QueryablePool | null;
+    /**
+     * Find sagas by name with pagination.
+     */
+    findByName(sagaName: string, options?: {
+        limit?: number;
+        offset?: number;
+        completed?: boolean;
+    }): Promise<TState[]>;
+    /**
+     * Count sagas by name.
+     */
+    countByName(sagaName: string, options?: {
+        completed?: boolean;
+    }): Promise<number>;
+    /**
+     * Delete completed sagas older than a given date.
+     */
+    deleteCompletedBefore(sagaName: string, before: Date): Promise<number>;
+}
+
+export { MySqlSagaStore, type MySqlSagaStoreOptions, type SagaInstanceRow };

package/dist/index.js

@@ -0,0 +1,198 @@
+// src/MySqlSagaStore.ts
+import * as mysql from "mysql2/promise";
+import { ConcurrencyError } from "@saga-bus/core";
+var MySqlSagaStore = class {
+  pool = null;
+  poolOptions;
+  tableName;
+  ownsPool;
+  constructor(options) {
+    if (typeof options.pool.query === "function") {
+      this.pool = options.pool;
+      this.poolOptions = null;
+      this.ownsPool = false;
+    } else {
+      this.poolOptions = options.pool;
+      this.ownsPool = true;
+    }
+    this.tableName = options.tableName ?? "saga_instances";
+  }
+  /**
+   * Initialize the connection pool if using config.
+   */
+  async initialize() {
+    if (this.poolOptions && !this.pool) {
+      this.pool = mysql.createPool(this.poolOptions);
+    }
+  }
+  async getById(sagaName, sagaId) {
+    if (!this.pool) throw new Error("Store not initialized");
+    const [rows] = await this.pool.query(
+      `SELECT * FROM \`${this.tableName}\` WHERE id = ? AND saga_name = ?`,
+      [sagaId, sagaName]
+    );
+    if (rows.length === 0) {
+      return null;
+    }
+    return this.rowToState(rows[0]);
+  }
+  async getByCorrelationId(sagaName, correlationId) {
+    if (!this.pool) throw new Error("Store not initialized");
+    const [rows] = await this.pool.query(
+      `SELECT * FROM \`${this.tableName}\` WHERE saga_name = ? AND correlation_id = ?`,
+      [sagaName, correlationId]
+    );
+    if (rows.length === 0) {
+      return null;
+    }
+    return this.rowToState(rows[0]);
+  }
+  async insert(sagaName, correlationId, state) {
+    if (!this.pool) throw new Error("Store not initialized");
+    const { sagaId, version, isCompleted, createdAt, updatedAt } = state.metadata;
+    await this.pool.query(
+      `INSERT INTO \`${this.tableName}\`
+       (id, saga_name, correlation_id, version, is_completed, state, created_at, updated_at)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?)`,
+      [
+        sagaId,
+        sagaName,
+        correlationId,
+        version,
+        isCompleted ? 1 : 0,
+        JSON.stringify(state),
+        createdAt,
+        updatedAt
+      ]
+    );
+  }
+  async update(sagaName, state, expectedVersion) {
+    if (!this.pool) throw new Error("Store not initialized");
+    const { sagaId, version, isCompleted, updatedAt } = state.metadata;
+    const [result] = await this.pool.query(
+      `UPDATE \`${this.tableName}\`
+       SET version = ?, is_completed = ?, state = ?, updated_at = ?
+       WHERE id = ? AND saga_name = ? AND version = ?`,
+      [
+        version,
+        isCompleted ? 1 : 0,
+        JSON.stringify(state),
+        updatedAt,
+        sagaId,
+        sagaName,
+        expectedVersion
+      ]
+    );
+    if (result.affectedRows === 0) {
+      const existing = await this.getById(sagaName, sagaId);
+      if (existing) {
+        throw new ConcurrencyError(
+          sagaId,
+          expectedVersion,
+          existing.metadata.version
+        );
+      } else {
+        throw new Error(`Saga ${sagaId} not found`);
+      }
+    }
+  }
+  async delete(sagaName, sagaId) {
+    if (!this.pool) throw new Error("Store not initialized");
+    await this.pool.query(
+      `DELETE FROM \`${this.tableName}\` WHERE id = ? AND saga_name = ?`,
+      [sagaId, sagaName]
+    );
+  }
+  /**
+   * Convert a database row to saga state.
+   */
+  rowToState(row) {
+    const state = JSON.parse(row.state);
+    return {
+      ...state,
+      metadata: {
+        ...state.metadata,
+        sagaId: row.id,
+        version: row.version,
+        isCompleted: row.is_completed === 1,
+        createdAt: new Date(row.created_at),
+        updatedAt: new Date(row.updated_at)
+      }
+    };
+  }
+  /**
+   * Close the connection pool (if owned by this store).
+   */
+  async close() {
+    if (this.ownsPool && this.pool) {
+      await this.pool.end();
+    }
+    this.pool = null;
+  }
+  /**
+   * Get the underlying pool for advanced operations.
+   */
+  getPool() {
+    return this.pool;
+  }
+  // ============ Query Helpers ============
+  /**
+   * Find sagas by name with pagination.
+   */
+  async findByName(sagaName, options) {
+    if (!this.pool) throw new Error("Store not initialized");
+    let query = `SELECT * FROM \`${this.tableName}\` WHERE saga_name = ?`;
+    const params = [sagaName];
+    if (options?.completed !== void 0) {
+      query += ` AND is_completed = ?`;
+      params.push(options.completed ? 1 : 0);
+    }
+    query += ` ORDER BY created_at DESC`;
+    if (options?.limit !== void 0) {
+      query += ` LIMIT ?`;
+      params.push(options.limit);
+    }
+    if (options?.offset !== void 0) {
+      query += ` OFFSET ?`;
+      params.push(options.offset);
+    }
+    const [rows] = await this.pool.query(
+      query,
+      params
+    );
+    return rows.map((row) => this.rowToState(row));
+  }
+  /**
+   * Count sagas by name.
+   */
+  async countByName(sagaName, options) {
+    if (!this.pool) throw new Error("Store not initialized");
+    let query = `SELECT COUNT(*) as count FROM \`${this.tableName}\` WHERE saga_name = ?`;
+    const params = [sagaName];
+    if (options?.completed !== void 0) {
+      query += ` AND is_completed = ?`;
+      params.push(options.completed ? 1 : 0);
+    }
+    const [rows] = await this.pool.query(
+      query,
+      params
+    );
+    return rows[0]?.count ?? 0;
+  }
+  /**
+   * Delete completed sagas older than a given date.
+   */
+  async deleteCompletedBefore(sagaName, before) {
+    if (!this.pool) throw new Error("Store not initialized");
+    const [result] = await this.pool.query(
+      `DELETE FROM \`${this.tableName}\`
+       WHERE saga_name = ? AND is_completed = 1 AND updated_at < ?`,
+      [sagaName, before]
+    );
+    return result.affectedRows;
+  }
+};
+export {
+  MySqlSagaStore
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/MySqlSagaStore.ts"],"sourcesContent":["import * as mysql from \"mysql2/promise\";\nimport type { SagaStore, SagaState } from \"@saga-bus/core\";\nimport { ConcurrencyError } from \"@saga-bus/core\";\nimport type { MySqlSagaStoreOptions, SagaInstanceRow } from \"./types.js\";\n\ntype RowDataPacket = mysql.RowDataPacket;\ntype ResultSetHeader = mysql.ResultSetHeader;\ntype PoolOptions = mysql.PoolOptions;\ntype FieldPacket = mysql.FieldPacket;\n\n// mysql2 types have issues with the mixin pattern, so we define our own interface\ninterface QueryablePool {\n  query<T extends mysql.RowDataPacket[][] | mysql.RowDataPacket[] | mysql.OkPacket | mysql.OkPacket[] | mysql.ResultSetHeader>(\n    sql: string,\n    values?: unknown[]\n  ): Promise<[T, FieldPacket[]]>;\n  end(): Promise<void>;\n  getConnection(): Promise<mysql.PoolConnection>;\n}\n\n/**\n * MySQL-backed saga store for saga-bus.\n *\n * @example\n * ```typescript\n * const store = new MySqlSagaStore<OrderState>({\n *   pool: {\n *     host: \"localhost\",\n *     user: \"root\",\n *     password: \"password\",\n *     database: \"sagas\",\n *   },\n * });\n *\n * await store.initialize();\n * ```\n */\nexport class MySqlSagaStore<TState extends SagaState>\n  implements SagaStore<TState>\n{\n  private pool: QueryablePool | null = null;\n  private readonly poolOptions: PoolOptions | null;\n  private readonly tableName: string;\n  private readonly ownsPool: boolean;\n\n  constructor(options: MySqlSagaStoreOptions) {\n    // Check if it's a Pool by looking for query method\n    if (typeof (options.pool as QueryablePool).query === \"function\") {\n      this.pool = options.pool as QueryablePool;\n      this.poolOptions = null;\n      this.ownsPool = false;\n    } else {\n      this.poolOptions = options.pool as PoolOptions;\n      this.ownsPool = true;\n    }\n\n    this.tableName = options.tableName ?? \"saga_instances\";\n  }\n\n  /**\n   * Initialize the connection pool if using config.\n   */\n  async initialize(): Promise<void> {\n    if (this.poolOptions && !this.pool) {\n      this.pool = mysql.createPool(this.poolOptions) as unknown as QueryablePool;\n    }\n  }\n\n  async getById(sagaName: string, sagaId: string): Promise<TState | null> {\n    if (!this.pool) throw new Error(\"Store not initialized\");\n\n    const [rows] = await this.pool.query<(SagaInstanceRow & RowDataPacket)[]>(\n      `SELECT * FROM \\`${this.tableName}\\` WHERE id = ? AND saga_name = ?`,\n      [sagaId, sagaName]\n    );\n\n    if (rows.length === 0) {\n      return null;\n    }\n\n    return this.rowToState(rows[0]!);\n  }\n\n  async getByCorrelationId(\n    sagaName: string,\n    correlationId: string\n  ): Promise<TState | null> {\n    if (!this.pool) throw new Error(\"Store not initialized\");\n\n    const [rows] = await this.pool.query<(SagaInstanceRow & RowDataPacket)[]>(\n      `SELECT * FROM \\`${this.tableName}\\` WHERE saga_name = ? AND correlation_id = ?`,\n      [sagaName, correlationId]\n    );\n\n    if (rows.length === 0) {\n      return null;\n    }\n\n    return this.rowToState(rows[0]!);\n  }\n\n  async insert(\n    sagaName: string,\n    correlationId: string,\n    state: TState\n  ): Promise<void> {\n    if (!this.pool) throw new Error(\"Store not initialized\");\n\n    const { sagaId, version, isCompleted, createdAt, updatedAt } =\n      state.metadata;\n\n    await this.pool.query(\n      `INSERT INTO \\`${this.tableName}\\`\n       (id, saga_name, correlation_id, version, is_completed, state, created_at, updated_at)\n       VALUES (?, ?, ?, ?, ?, ?, ?, ?)`,\n      [\n        sagaId,\n        sagaName,\n        correlationId,\n        version,\n        isCompleted ? 1 : 0,\n        JSON.stringify(state),\n        createdAt,\n        updatedAt,\n      ]\n    );\n  }\n\n  async update(\n    sagaName: string,\n    state: TState,\n    expectedVersion: number\n  ): Promise<void> {\n    if (!this.pool) throw new Error(\"Store not initialized\");\n\n    const { sagaId, version, isCompleted, updatedAt } = state.metadata;\n\n    const [result] = await this.pool.query<ResultSetHeader>(\n      `UPDATE \\`${this.tableName}\\`\n       SET version = ?, is_completed = ?, state = ?, updated_at = ?\n       WHERE id = ? AND saga_name = ? AND version = ?`,\n      [\n        version,\n        isCompleted ? 1 : 0,\n        JSON.stringify(state),\n        updatedAt,\n        sagaId,\n        sagaName,\n        expectedVersion,\n      ]\n    );\n\n    if (result.affectedRows === 0) {\n      // Either saga doesn't exist or version mismatch\n      const existing = await this.getById(sagaName, sagaId);\n      if (existing) {\n        throw new ConcurrencyError(\n          sagaId,\n          expectedVersion,\n          existing.metadata.version\n        );\n      } else {\n        throw new Error(`Saga ${sagaId} not found`);\n      }\n    }\n  }\n\n  async delete(sagaName: string, sagaId: string): Promise<void> {\n    if (!this.pool) throw new Error(\"Store not initialized\");\n\n    await this.pool.query(\n      `DELETE FROM \\`${this.tableName}\\` WHERE id = ? AND saga_name = ?`,\n      [sagaId, sagaName]\n    );\n  }\n\n  /**\n   * Convert a database row to saga state.\n   */\n  private rowToState(row: SagaInstanceRow): TState {\n    const state = JSON.parse(row.state) as TState;\n\n    // Ensure metadata dates are Date objects\n    return {\n      ...state,\n      metadata: {\n        ...state.metadata,\n        sagaId: row.id,\n        version: row.version,\n        isCompleted: row.is_completed === 1,\n        createdAt: new Date(row.created_at),\n        updatedAt: new Date(row.updated_at),\n      },\n    };\n  }\n\n  /**\n   * Close the connection pool (if owned by this store).\n   */\n  async close(): Promise<void> {\n    if (this.ownsPool && this.pool) {\n      await this.pool.end();\n    }\n    this.pool = null;\n  }\n\n  /**\n   * Get the underlying pool for advanced operations.\n   */\n  getPool(): QueryablePool | null {\n    return this.pool;\n  }\n\n  // ============ Query Helpers ============\n\n  /**\n   * Find sagas by name with pagination.\n   */\n  async findByName(\n    sagaName: string,\n    options?: {\n      limit?: number;\n      offset?: number;\n      completed?: boolean;\n    }\n  ): Promise<TState[]> {\n    if (!this.pool) throw new Error(\"Store not initialized\");\n\n    let query = `SELECT * FROM \\`${this.tableName}\\` WHERE saga_name = ?`;\n    const params: (string | number | boolean)[] = [sagaName];\n\n    if (options?.completed !== undefined) {\n      query += ` AND is_completed = ?`;\n      params.push(options.completed ? 1 : 0);\n    }\n\n    query += ` ORDER BY created_at DESC`;\n\n    if (options?.limit !== undefined) {\n      query += ` LIMIT ?`;\n      params.push(options.limit);\n    }\n\n    if (options?.offset !== undefined) {\n      query += ` OFFSET ?`;\n      params.push(options.offset);\n    }\n\n    const [rows] = await this.pool.query<(SagaInstanceRow & RowDataPacket)[]>(\n      query,\n      params\n    );\n\n    return rows.map((row) => this.rowToState(row));\n  }\n\n  /**\n   * Count sagas by name.\n   */\n  async countByName(\n    sagaName: string,\n    options?: { completed?: boolean }\n  ): Promise<number> {\n    if (!this.pool) throw new Error(\"Store not initialized\");\n\n    let query = `SELECT COUNT(*) as count FROM \\`${this.tableName}\\` WHERE saga_name = ?`;\n    const params: (string | number)[] = [sagaName];\n\n    if (options?.completed !== undefined) {\n      query += ` AND is_completed = ?`;\n      params.push(options.completed ? 1 : 0);\n    }\n\n    const [rows] = await this.pool.query<({ count: number } & RowDataPacket)[]>(\n      query,\n      params\n    );\n\n    return rows[0]?.count ?? 0;\n  }\n\n  /**\n   * Delete completed sagas older than a given date.\n   */\n  async deleteCompletedBefore(\n    sagaName: string,\n    before: Date\n  ): Promise<number> {\n    if (!this.pool) throw new Error(\"Store not initialized\");\n\n    const [result] = await this.pool.query<ResultSetHeader>(\n      `DELETE FROM \\`${this.tableName}\\`\n       WHERE saga_name = ? AND is_completed = 1 AND updated_at < ?`,\n      [sagaName, before]\n    );\n\n    return result.affectedRows;\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@saga-bus/store-mysql",
+  "version": "1.0.0",
+  "description": "MySQL saga store for saga-bus",
+  "type": "module",
+  "main": "./dist/index.js",
+  "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"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/deanforan/saga-bus.git",
+    "directory": "packages/store-mysql"
+  },
+  "bugs": {
+    "url": "https://github.com/deanforan/saga-bus/issues"
+  },
+  "homepage": "https://github.com/deanforan/saga-bus#readme",
+  "keywords": [
+    "saga",
+    "message-bus",
+    "store",
+    "mysql",
+    "mariadb",
+    "planetscale"
+  ],
+  "dependencies": {
+    "@saga-bus/core": "0.1.0"
+  },
+  "devDependencies": {
+    "mysql2": "^3.11.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.9.2",
+    "vitest": "^3.0.0",
+    "@repo/eslint-config": "0.0.0",
+    "@repo/typescript-config": "0.0.0"
+  },
+  "peerDependencies": {
+    "@saga-bus/core": ">=0.1.0",
+    "mysql2": ">=3.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "eslint src/",
+    "check-types": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}