@saga-bus/store-inmemory 0.1.1

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,74 @@
+# @saga-bus/store-inmemory
+
+In-memory saga store for testing and development.
+
+## Installation
+
+```bash
+pnpm add @saga-bus/store-inmemory
+```
+
+## Usage
+
+```typescript
+import { InMemorySagaStore } from "@saga-bus/store-inmemory";
+import { createBus } from "@saga-bus/core";
+
+const store = new InMemorySagaStore();
+
+const bus = createBus({
+  sagas: [{ definition: mySaga, store }],
+  transport,
+});
+```
+
+## Features
+
+- Optimistic concurrency control
+- Correlation ID indexing
+- State versioning
+- Zero configuration
+- Instant operations
+
+## When to Use
+
+**Use for:**
+- Unit and integration tests
+- Local development
+- Prototyping
+
+**Do not use for:**
+- Production deployments
+- Multi-instance applications
+- Data that needs to survive restarts
+
+## Limitations
+
+- **No persistence**: All data is lost when the process exits
+- **Single process only**: State is not shared between Node.js processes
+- **Memory bound**: Large numbers of sagas may consume significant memory
+
+For production, use a persistent store like [@saga-bus/store-postgres](../store-postgres), [@saga-bus/store-mongo](../store-mongo), or [@saga-bus/store-dynamodb](../store-dynamodb).
+
+## Sharing Across Sagas
+
+A single store instance can be shared across multiple sagas within the same process:
+
+```typescript
+const store = new InMemorySagaStore();
+
+const bus = createBus({
+  transport,
+  store, // shared by all sagas
+  sagas: [
+    { definition: orderSaga },
+    { definition: paymentSaga },
+  ],
+});
+```
+
+Data is isolated by `sagaName`, so different saga types won't conflict.
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,131 @@
+"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, {
+  InMemorySagaStore: () => InMemorySagaStore
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/InMemorySagaStore.ts
+var import_core = require("@saga-bus/core");
+var InMemorySagaStore = class {
+  /** Primary store: sagaName:sagaId -> state */
+  store = /* @__PURE__ */ new Map();
+  /** Correlation index: "sagaName:correlationId" -> sagaId */
+  correlationIndex = /* @__PURE__ */ new Map();
+  /**
+   * Build the correlation index key.
+   */
+  getCorrelationKey(sagaName, correlationId) {
+    return `${sagaName}:${correlationId}`;
+  }
+  /**
+   * Build the store key (sagaName:sagaId for isolation).
+   */
+  getStoreKey(sagaName, sagaId) {
+    return `${sagaName}:${sagaId}`;
+  }
+  async getById(sagaName, sagaId) {
+    const key = this.getStoreKey(sagaName, sagaId);
+    const state = this.store.get(key);
+    return state ? this.clone(state) : null;
+  }
+  async getByCorrelationId(sagaName, correlationId) {
+    const correlationKey = this.getCorrelationKey(sagaName, correlationId);
+    const sagaId = this.correlationIndex.get(correlationKey);
+    if (!sagaId) {
+      return null;
+    }
+    return this.getById(sagaName, sagaId);
+  }
+  async insert(sagaName, correlationId, state) {
+    const { sagaId } = state.metadata;
+    const storeKey = this.getStoreKey(sagaName, sagaId);
+    if (this.store.has(storeKey)) {
+      throw new Error(`Saga ${sagaId} already exists`);
+    }
+    this.store.set(storeKey, this.clone(state));
+    const correlationKey = this.getCorrelationKey(sagaName, correlationId);
+    this.correlationIndex.set(correlationKey, sagaId);
+  }
+  async update(sagaName, state, expectedVersion) {
+    const { sagaId, version } = state.metadata;
+    const storeKey = this.getStoreKey(sagaName, sagaId);
+    const existing = this.store.get(storeKey);
+    if (!existing) {
+      throw new Error(`Saga ${sagaId} not found`);
+    }
+    if (existing.metadata.version !== expectedVersion) {
+      throw new import_core.ConcurrencyError(
+        sagaId,
+        expectedVersion,
+        existing.metadata.version
+      );
+    }
+    if (version !== expectedVersion + 1) {
+      throw new Error(
+        `Invalid version: expected ${expectedVersion + 1}, got ${version}`
+      );
+    }
+    this.store.set(storeKey, this.clone(state));
+  }
+  async delete(sagaName, sagaId) {
+    const storeKey = this.getStoreKey(sagaName, sagaId);
+    this.store.delete(storeKey);
+  }
+  /**
+   * Deep clone a state object to prevent external mutations.
+   */
+  clone(state) {
+    return JSON.parse(JSON.stringify(state));
+  }
+  // ============ Testing Utilities ============
+  /**
+   * Get the total number of stored sagas.
+   */
+  get size() {
+    return this.store.size;
+  }
+  /**
+   * Clear all stored data.
+   */
+  clear() {
+    this.store.clear();
+    this.correlationIndex.clear();
+  }
+  /**
+   * Get all stored states (for testing/debugging).
+   */
+  getAll() {
+    return Array.from(this.store.values()).map((s) => this.clone(s));
+  }
+  /**
+   * Check if a saga exists by ID.
+   */
+  has(sagaName, sagaId) {
+    return this.store.has(this.getStoreKey(sagaName, sagaId));
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  InMemorySagaStore
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/InMemorySagaStore.ts"],"sourcesContent":["export { InMemorySagaStore } from \"./InMemorySagaStore.js\";\n","import type { SagaStore, SagaState } from \"@saga-bus/core\";\nimport { ConcurrencyError } from \"@saga-bus/core\";\n\n/**\n * In-memory saga store implementation for testing and development.\n * Uses Maps for O(1) lookups by both sagaId and correlationId.\n */\nexport class InMemorySagaStore<TState extends SagaState>\n  implements SagaStore<TState>\n{\n  /** Primary store: sagaName:sagaId -> state */\n  private readonly store = new Map<string, TState>();\n\n  /** Correlation index: \"sagaName:correlationId\" -> sagaId */\n  private readonly correlationIndex = new Map<string, string>();\n\n  /**\n   * Build the correlation index key.\n   */\n  private getCorrelationKey(sagaName: string, correlationId: string): string {\n    return `${sagaName}:${correlationId}`;\n  }\n\n  /**\n   * Build the store key (sagaName:sagaId for isolation).\n   */\n  private getStoreKey(sagaName: string, sagaId: string): string {\n    return `${sagaName}:${sagaId}`;\n  }\n\n  async getById(sagaName: string, sagaId: string): Promise<TState | null> {\n    const key = this.getStoreKey(sagaName, sagaId);\n    const state = this.store.get(key);\n    return state ? this.clone(state) : null;\n  }\n\n  async getByCorrelationId(\n    sagaName: string,\n    correlationId: string\n  ): Promise<TState | null> {\n    const correlationKey = this.getCorrelationKey(sagaName, correlationId);\n    const sagaId = this.correlationIndex.get(correlationKey);\n\n    if (!sagaId) {\n      return null;\n    }\n\n    return this.getById(sagaName, sagaId);\n  }\n\n  async insert(sagaName: string, correlationId: string, state: TState): Promise<void> {\n    const { sagaId } = state.metadata;\n    const storeKey = this.getStoreKey(sagaName, sagaId);\n\n    if (this.store.has(storeKey)) {\n      throw new Error(`Saga ${sagaId} already exists`);\n    }\n\n    // Store the state (deep clone to prevent mutation)\n    this.store.set(storeKey, this.clone(state));\n\n    // Index by correlation ID\n    const correlationKey = this.getCorrelationKey(sagaName, correlationId);\n    this.correlationIndex.set(correlationKey, sagaId);\n  }\n\n  async update(\n    sagaName: string,\n    state: TState,\n    expectedVersion: number\n  ): Promise<void> {\n    const { sagaId, version } = state.metadata;\n    const storeKey = this.getStoreKey(sagaName, sagaId);\n\n    const existing = this.store.get(storeKey);\n\n    if (!existing) {\n      throw new Error(`Saga ${sagaId} not found`);\n    }\n\n    if (existing.metadata.version !== expectedVersion) {\n      throw new ConcurrencyError(\n        sagaId,\n        expectedVersion,\n        existing.metadata.version\n      );\n    }\n\n    // Verify the new version is incremented\n    if (version !== expectedVersion + 1) {\n      throw new Error(\n        `Invalid version: expected ${expectedVersion + 1}, got ${version}`\n      );\n    }\n\n    // Store the updated state (deep clone to prevent mutation)\n    this.store.set(storeKey, this.clone(state));\n  }\n\n  async delete(sagaName: string, sagaId: string): Promise<void> {\n    const storeKey = this.getStoreKey(sagaName, sagaId);\n    this.store.delete(storeKey);\n  }\n\n  /**\n   * Deep clone a state object to prevent external mutations.\n   */\n  private clone(state: TState): TState {\n    return JSON.parse(JSON.stringify(state)) as TState;\n  }\n\n  // ============ Testing Utilities ============\n\n  /**\n   * Get the total number of stored sagas.\n   */\n  get size(): number {\n    return this.store.size;\n  }\n\n  /**\n   * Clear all stored data.\n   */\n  clear(): void {\n    this.store.clear();\n    this.correlationIndex.clear();\n  }\n\n  /**\n   * Get all stored states (for testing/debugging).\n   */\n  getAll(): TState[] {\n    return Array.from(this.store.values()).map((s) => this.clone(s));\n  }\n\n  /**\n   * Check if a saga exists by ID.\n   */\n  has(sagaName: string, sagaId: string): boolean {\n    return this.store.has(this.getStoreKey(sagaName, sagaId));\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,47 @@
+import { SagaState, SagaStore } from '@saga-bus/core';
+
+/**
+ * In-memory saga store implementation for testing and development.
+ * Uses Maps for O(1) lookups by both sagaId and correlationId.
+ */
+declare class InMemorySagaStore<TState extends SagaState> implements SagaStore<TState> {
+    /** Primary store: sagaName:sagaId -> state */
+    private readonly store;
+    /** Correlation index: "sagaName:correlationId" -> sagaId */
+    private readonly correlationIndex;
+    /**
+     * Build the correlation index key.
+     */
+    private getCorrelationKey;
+    /**
+     * Build the store key (sagaName:sagaId for isolation).
+     */
+    private getStoreKey;
+    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>;
+    /**
+     * Deep clone a state object to prevent external mutations.
+     */
+    private clone;
+    /**
+     * Get the total number of stored sagas.
+     */
+    get size(): number;
+    /**
+     * Clear all stored data.
+     */
+    clear(): void;
+    /**
+     * Get all stored states (for testing/debugging).
+     */
+    getAll(): TState[];
+    /**
+     * Check if a saga exists by ID.
+     */
+    has(sagaName: string, sagaId: string): boolean;
+}
+
+export { InMemorySagaStore };

package/dist/index.d.ts

@@ -0,0 +1,47 @@
+import { SagaState, SagaStore } from '@saga-bus/core';
+
+/**
+ * In-memory saga store implementation for testing and development.
+ * Uses Maps for O(1) lookups by both sagaId and correlationId.
+ */
+declare class InMemorySagaStore<TState extends SagaState> implements SagaStore<TState> {
+    /** Primary store: sagaName:sagaId -> state */
+    private readonly store;
+    /** Correlation index: "sagaName:correlationId" -> sagaId */
+    private readonly correlationIndex;
+    /**
+     * Build the correlation index key.
+     */
+    private getCorrelationKey;
+    /**
+     * Build the store key (sagaName:sagaId for isolation).
+     */
+    private getStoreKey;
+    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>;
+    /**
+     * Deep clone a state object to prevent external mutations.
+     */
+    private clone;
+    /**
+     * Get the total number of stored sagas.
+     */
+    get size(): number;
+    /**
+     * Clear all stored data.
+     */
+    clear(): void;
+    /**
+     * Get all stored states (for testing/debugging).
+     */
+    getAll(): TState[];
+    /**
+     * Check if a saga exists by ID.
+     */
+    has(sagaName: string, sagaId: string): boolean;
+}
+
+export { InMemorySagaStore };

package/dist/index.js

@@ -0,0 +1,104 @@
+// src/InMemorySagaStore.ts
+import { ConcurrencyError } from "@saga-bus/core";
+var InMemorySagaStore = class {
+  /** Primary store: sagaName:sagaId -> state */
+  store = /* @__PURE__ */ new Map();
+  /** Correlation index: "sagaName:correlationId" -> sagaId */
+  correlationIndex = /* @__PURE__ */ new Map();
+  /**
+   * Build the correlation index key.
+   */
+  getCorrelationKey(sagaName, correlationId) {
+    return `${sagaName}:${correlationId}`;
+  }
+  /**
+   * Build the store key (sagaName:sagaId for isolation).
+   */
+  getStoreKey(sagaName, sagaId) {
+    return `${sagaName}:${sagaId}`;
+  }
+  async getById(sagaName, sagaId) {
+    const key = this.getStoreKey(sagaName, sagaId);
+    const state = this.store.get(key);
+    return state ? this.clone(state) : null;
+  }
+  async getByCorrelationId(sagaName, correlationId) {
+    const correlationKey = this.getCorrelationKey(sagaName, correlationId);
+    const sagaId = this.correlationIndex.get(correlationKey);
+    if (!sagaId) {
+      return null;
+    }
+    return this.getById(sagaName, sagaId);
+  }
+  async insert(sagaName, correlationId, state) {
+    const { sagaId } = state.metadata;
+    const storeKey = this.getStoreKey(sagaName, sagaId);
+    if (this.store.has(storeKey)) {
+      throw new Error(`Saga ${sagaId} already exists`);
+    }
+    this.store.set(storeKey, this.clone(state));
+    const correlationKey = this.getCorrelationKey(sagaName, correlationId);
+    this.correlationIndex.set(correlationKey, sagaId);
+  }
+  async update(sagaName, state, expectedVersion) {
+    const { sagaId, version } = state.metadata;
+    const storeKey = this.getStoreKey(sagaName, sagaId);
+    const existing = this.store.get(storeKey);
+    if (!existing) {
+      throw new Error(`Saga ${sagaId} not found`);
+    }
+    if (existing.metadata.version !== expectedVersion) {
+      throw new ConcurrencyError(
+        sagaId,
+        expectedVersion,
+        existing.metadata.version
+      );
+    }
+    if (version !== expectedVersion + 1) {
+      throw new Error(
+        `Invalid version: expected ${expectedVersion + 1}, got ${version}`
+      );
+    }
+    this.store.set(storeKey, this.clone(state));
+  }
+  async delete(sagaName, sagaId) {
+    const storeKey = this.getStoreKey(sagaName, sagaId);
+    this.store.delete(storeKey);
+  }
+  /**
+   * Deep clone a state object to prevent external mutations.
+   */
+  clone(state) {
+    return JSON.parse(JSON.stringify(state));
+  }
+  // ============ Testing Utilities ============
+  /**
+   * Get the total number of stored sagas.
+   */
+  get size() {
+    return this.store.size;
+  }
+  /**
+   * Clear all stored data.
+   */
+  clear() {
+    this.store.clear();
+    this.correlationIndex.clear();
+  }
+  /**
+   * Get all stored states (for testing/debugging).
+   */
+  getAll() {
+    return Array.from(this.store.values()).map((s) => this.clone(s));
+  }
+  /**
+   * Check if a saga exists by ID.
+   */
+  has(sagaName, sagaId) {
+    return this.store.has(this.getStoreKey(sagaName, sagaId));
+  }
+};
+export {
+  InMemorySagaStore
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/InMemorySagaStore.ts"],"sourcesContent":["import type { SagaStore, SagaState } from \"@saga-bus/core\";\nimport { ConcurrencyError } from \"@saga-bus/core\";\n\n/**\n * In-memory saga store implementation for testing and development.\n * Uses Maps for O(1) lookups by both sagaId and correlationId.\n */\nexport class InMemorySagaStore<TState extends SagaState>\n  implements SagaStore<TState>\n{\n  /** Primary store: sagaName:sagaId -> state */\n  private readonly store = new Map<string, TState>();\n\n  /** Correlation index: \"sagaName:correlationId\" -> sagaId */\n  private readonly correlationIndex = new Map<string, string>();\n\n  /**\n   * Build the correlation index key.\n   */\n  private getCorrelationKey(sagaName: string, correlationId: string): string {\n    return `${sagaName}:${correlationId}`;\n  }\n\n  /**\n   * Build the store key (sagaName:sagaId for isolation).\n   */\n  private getStoreKey(sagaName: string, sagaId: string): string {\n    return `${sagaName}:${sagaId}`;\n  }\n\n  async getById(sagaName: string, sagaId: string): Promise<TState | null> {\n    const key = this.getStoreKey(sagaName, sagaId);\n    const state = this.store.get(key);\n    return state ? this.clone(state) : null;\n  }\n\n  async getByCorrelationId(\n    sagaName: string,\n    correlationId: string\n  ): Promise<TState | null> {\n    const correlationKey = this.getCorrelationKey(sagaName, correlationId);\n    const sagaId = this.correlationIndex.get(correlationKey);\n\n    if (!sagaId) {\n      return null;\n    }\n\n    return this.getById(sagaName, sagaId);\n  }\n\n  async insert(sagaName: string, correlationId: string, state: TState): Promise<void> {\n    const { sagaId } = state.metadata;\n    const storeKey = this.getStoreKey(sagaName, sagaId);\n\n    if (this.store.has(storeKey)) {\n      throw new Error(`Saga ${sagaId} already exists`);\n    }\n\n    // Store the state (deep clone to prevent mutation)\n    this.store.set(storeKey, this.clone(state));\n\n    // Index by correlation ID\n    const correlationKey = this.getCorrelationKey(sagaName, correlationId);\n    this.correlationIndex.set(correlationKey, sagaId);\n  }\n\n  async update(\n    sagaName: string,\n    state: TState,\n    expectedVersion: number\n  ): Promise<void> {\n    const { sagaId, version } = state.metadata;\n    const storeKey = this.getStoreKey(sagaName, sagaId);\n\n    const existing = this.store.get(storeKey);\n\n    if (!existing) {\n      throw new Error(`Saga ${sagaId} not found`);\n    }\n\n    if (existing.metadata.version !== expectedVersion) {\n      throw new ConcurrencyError(\n        sagaId,\n        expectedVersion,\n        existing.metadata.version\n      );\n    }\n\n    // Verify the new version is incremented\n    if (version !== expectedVersion + 1) {\n      throw new Error(\n        `Invalid version: expected ${expectedVersion + 1}, got ${version}`\n      );\n    }\n\n    // Store the updated state (deep clone to prevent mutation)\n    this.store.set(storeKey, this.clone(state));\n  }\n\n  async delete(sagaName: string, sagaId: string): Promise<void> {\n    const storeKey = this.getStoreKey(sagaName, sagaId);\n    this.store.delete(storeKey);\n  }\n\n  /**\n   * Deep clone a state object to prevent external mutations.\n   */\n  private clone(state: TState): TState {\n    return JSON.parse(JSON.stringify(state)) as TState;\n  }\n\n  // ============ Testing Utilities ============\n\n  /**\n   * Get the total number of stored sagas.\n   */\n  get size(): number {\n    return this.store.size;\n  }\n\n  /**\n   * Clear all stored data.\n   */\n  clear(): void {\n    this.store.clear();\n    this.correlationIndex.clear();\n  }\n\n  /**\n   * Get all stored states (for testing/debugging).\n   */\n  getAll(): TState[] {\n    return Array.from(this.store.values()).map((s) => this.clone(s));\n  }\n\n  /**\n   * Check if a saga exists by ID.\n   */\n  has(sagaName: string, sagaId: string): boolean {\n    return this.store.has(this.getStoreKey(sagaName, sagaId));\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@saga-bus/store-inmemory",
+  "version": "0.1.1",
+  "description": "In-memory saga store for saga-bus testing and development",
+  "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/d-e-a-n-f/saga-bus.git",
+    "directory": "packages/store-inmemory"
+  },
+  "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",
+    "message-bus",
+    "store",
+    "inmemory",
+    "testing"
+  ],
+  "dependencies": {
+    "@saga-bus/core": "0.1.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.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.1"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "eslint src/",
+    "check-types": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}