@saga-bus/store-prisma 0.1.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,78 @@
+# @saga-bus/store-prisma
+
+Prisma ORM adapter for saga-bus state storage.
+
+## Installation
+
+```bash
+pnpm add @saga-bus/store-prisma @prisma/client
+```
+
+## Prisma Schema
+
+Add to your `schema.prisma`:
+
+```prisma
+model SagaInstance {
+  id            String   @db.VarChar(128)
+  sagaName      String   @map("saga_name") @db.VarChar(128)
+  correlationId String   @map("correlation_id") @db.VarChar(256)
+  version       Int
+  isCompleted   Boolean  @default(false) @map("is_completed")
+  state         Json
+
+  createdAt     DateTime @default(now()) @map("created_at")
+  updatedAt     DateTime @updatedAt @map("updated_at")
+
+  @@id([sagaName, id])
+  @@unique([sagaName, correlationId])
+  @@index([sagaName, isCompleted])
+  @@map("saga_instances")
+}
+```
+
+## Usage
+
+```typescript
+import { PrismaClient } from "@prisma/client";
+import { PrismaSagaStore } from "@saga-bus/store-prisma";
+import { createBus } from "@saga-bus/core";
+
+const prisma = new PrismaClient();
+const store = new PrismaSagaStore({ prisma });
+
+const bus = createBus({
+  sagas: [{ definition: mySaga, store }],
+  transport,
+});
+```
+
+## Features
+
+- Uses your existing PrismaClient
+- Optimistic concurrency control
+- Type-safe state serialization
+- Works with any Prisma-supported database
+
+## Sharing Across Sagas
+
+A single store instance can be shared across multiple sagas:
+
+```typescript
+const store = new PrismaSagaStore({ prisma });
+
+const bus = createBus({
+  transport,
+  store, // shared by all sagas
+  sagas: [
+    { definition: orderSaga },
+    { definition: paymentSaga },
+  ],
+});
+```
+
+Data is isolated by `sagaName` in the database, so different saga types won't conflict.
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,186 @@
+"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, {
+  PrismaSagaStore: () => PrismaSagaStore
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/PrismaSagaStore.ts
+var import_core = require("@saga-bus/core");
+var PrismaSagaStore = class {
+  prisma;
+  constructor(options) {
+    this.prisma = options.prisma;
+  }
+  async getById(sagaName, sagaId) {
+    const record = await this.prisma.sagaInstance.findUnique({
+      where: { sagaName_id: { sagaName, id: sagaId } }
+    });
+    if (!record) {
+      return null;
+    }
+    return this.recordToState(record);
+  }
+  async getByCorrelationId(sagaName, correlationId) {
+    const record = await this.prisma.sagaInstance.findFirst({
+      where: {
+        sagaName,
+        correlationId
+      }
+    });
+    if (!record) {
+      return null;
+    }
+    return this.recordToState(record);
+  }
+  async insert(sagaName, correlationId, state) {
+    const { sagaId, version, isCompleted, createdAt, updatedAt } = state.metadata;
+    await this.prisma.sagaInstance.create({
+      data: {
+        id: sagaId,
+        sagaName,
+        correlationId,
+        version,
+        isCompleted,
+        state,
+        createdAt,
+        updatedAt
+      }
+    });
+  }
+  /**
+   * Insert a saga with explicit correlation ID.
+   */
+  async insertWithCorrelation(sagaName, correlationId, state) {
+    const { sagaId, version, isCompleted, createdAt, updatedAt } = state.metadata;
+    await this.prisma.sagaInstance.create({
+      data: {
+        id: sagaId,
+        sagaName,
+        correlationId,
+        version,
+        isCompleted,
+        state,
+        createdAt,
+        updatedAt
+      }
+    });
+  }
+  async update(sagaName, state, expectedVersion) {
+    const { sagaId, version, isCompleted, updatedAt } = state.metadata;
+    const result = await this.prisma.sagaInstance.updateMany({
+      where: {
+        sagaName,
+        id: sagaId,
+        version: expectedVersion
+      },
+      data: {
+        version,
+        isCompleted,
+        state,
+        updatedAt
+      }
+    });
+    if (result.count === 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) {
+    try {
+      await this.prisma.sagaInstance.delete({
+        where: { sagaName_id: { sagaName, id: sagaId } }
+      });
+    } catch {
+    }
+  }
+  /**
+   * Convert a Prisma record to saga state.
+   */
+  recordToState(record) {
+    const state = record.state;
+    return {
+      ...state,
+      metadata: {
+        ...state.metadata,
+        sagaId: record.id,
+        version: record.version,
+        isCompleted: record.isCompleted,
+        createdAt: record.createdAt,
+        updatedAt: record.updatedAt
+      }
+    };
+  }
+  // ============ Query Helpers ============
+  /**
+   * Find sagas by name with pagination.
+   */
+  async findByName(sagaName, options) {
+    const records = await this.prisma.sagaInstance.findMany({
+      where: {
+        sagaName,
+        ...options?.completed !== void 0 ? { isCompleted: options.completed } : {}
+      },
+      orderBy: { createdAt: "desc" },
+      take: options?.limit,
+      skip: options?.offset
+    });
+    return records.map((record) => this.recordToState(record));
+  }
+  /**
+   * Count sagas by name.
+   */
+  async countByName(sagaName, options) {
+    return this.prisma.sagaInstance.count({
+      where: {
+        sagaName,
+        ...options?.completed !== void 0 ? { isCompleted: options.completed } : {}
+      }
+    });
+  }
+  /**
+   * Delete completed sagas older than a given date.
+   */
+  async deleteCompletedBefore(sagaName, before) {
+    const result = await this.prisma.sagaInstance.deleteMany({
+      where: {
+        sagaName,
+        isCompleted: true,
+        updatedAt: { lt: before }
+      }
+    });
+    return result.count;
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  PrismaSagaStore
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/PrismaSagaStore.ts"],"sourcesContent":["export { PrismaSagaStore } from \"./PrismaSagaStore.js\";\nexport type {\n  PrismaSagaStoreOptions,\n  PrismaClientLike,\n  SagaInstanceRecord,\n} from \"./types.js\";\n","import type { SagaStore, SagaState } from \"@saga-bus/core\";\nimport { ConcurrencyError } from \"@saga-bus/core\";\nimport type {\n  PrismaSagaStoreOptions,\n  PrismaClientLike,\n  SagaInstanceRecord,\n} from \"./types.js\";\n\n/**\n * Prisma-backed saga store.\n *\n * @example\n * ```typescript\n * import { PrismaClient } from \"@prisma/client\";\n *\n * const prisma = new PrismaClient();\n * const store = new PrismaSagaStore<OrderState>({ prisma });\n *\n * const bus = await createBus({\n *   transport,\n *   sagas: [{ definition: orderSaga, store }],\n * });\n * ```\n */\nexport class PrismaSagaStore<TState extends SagaState>\n  implements SagaStore<TState>\n{\n  private readonly prisma: PrismaClientLike;\n\n  constructor(options: PrismaSagaStoreOptions) {\n    this.prisma = options.prisma;\n  }\n\n  async getById(sagaName: string, sagaId: string): Promise<TState | null> {\n    const record = await this.prisma.sagaInstance.findUnique({\n      where: { sagaName_id: { sagaName, id: sagaId } },\n    });\n\n    if (!record) {\n      return null;\n    }\n\n    return this.recordToState(record);\n  }\n\n  async getByCorrelationId(\n    sagaName: string,\n    correlationId: string\n  ): Promise<TState | null> {\n    const record = await this.prisma.sagaInstance.findFirst({\n      where: {\n        sagaName,\n        correlationId,\n      },\n    });\n\n    if (!record) {\n      return null;\n    }\n\n    return this.recordToState(record);\n  }\n\n  async insert(sagaName: string, correlationId: string, state: TState): Promise<void> {\n    const { sagaId, version, isCompleted, createdAt, updatedAt } =\n      state.metadata;\n\n    await this.prisma.sagaInstance.create({\n      data: {\n        id: sagaId,\n        sagaName,\n        correlationId,\n        version,\n        isCompleted,\n        state: state as unknown,\n        createdAt,\n        updatedAt,\n      },\n    });\n  }\n\n  /**\n   * Insert a saga with explicit correlation ID.\n   */\n  async insertWithCorrelation(\n    sagaName: string,\n    correlationId: string,\n    state: TState\n  ): Promise<void> {\n    const { sagaId, version, isCompleted, createdAt, updatedAt } =\n      state.metadata;\n\n    await this.prisma.sagaInstance.create({\n      data: {\n        id: sagaId,\n        sagaName,\n        correlationId,\n        version,\n        isCompleted,\n        state: state as unknown,\n        createdAt,\n        updatedAt,\n      },\n    });\n  }\n\n  async update(\n    sagaName: string,\n    state: TState,\n    expectedVersion: number\n  ): Promise<void> {\n    const { sagaId, version, isCompleted, updatedAt } = state.metadata;\n\n    // Use updateMany with version check for optimistic concurrency\n    const result = await this.prisma.sagaInstance.updateMany({\n      where: {\n        sagaName,\n        id: sagaId,\n        version: expectedVersion,\n      },\n      data: {\n        version,\n        isCompleted,\n        state: state as unknown,\n        updatedAt,\n      },\n    });\n\n    if (result.count === 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    try {\n      await this.prisma.sagaInstance.delete({\n        where: { sagaName_id: { sagaName, id: sagaId } },\n      });\n    } catch {\n      // Ignore if not found\n    }\n  }\n\n  /**\n   * Convert a Prisma record to saga state.\n   */\n  private recordToState(record: SagaInstanceRecord): TState {\n    const state = record.state as TState;\n\n    // Ensure metadata is consistent with database values\n    return {\n      ...state,\n      metadata: {\n        ...state.metadata,\n        sagaId: record.id,\n        version: record.version,\n        isCompleted: record.isCompleted,\n        createdAt: record.createdAt,\n        updatedAt: record.updatedAt,\n      },\n    };\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    const records = await this.prisma.sagaInstance.findMany({\n      where: {\n        sagaName,\n        ...(options?.completed !== undefined\n          ? { isCompleted: options.completed }\n          : {}),\n      },\n      orderBy: { createdAt: \"desc\" },\n      take: options?.limit,\n      skip: options?.offset,\n    });\n\n    return records.map((record) => this.recordToState(record));\n  }\n\n  /**\n   * Count sagas by name.\n   */\n  async countByName(\n    sagaName: string,\n    options?: { completed?: boolean }\n  ): Promise<number> {\n    return this.prisma.sagaInstance.count({\n      where: {\n        sagaName,\n        ...(options?.completed !== undefined\n          ? { isCompleted: options.completed }\n          : {}),\n      },\n    });\n  }\n\n  /**\n   * Delete completed sagas older than a given date.\n   */\n  async deleteCompletedBefore(sagaName: string, before: Date): Promise<number> {\n    const result = await this.prisma.sagaInstance.deleteMany({\n      where: {\n        sagaName,\n        isCompleted: true,\n        updatedAt: { lt: before },\n      },\n    });\n\n    return result.count;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,180 @@
+import { SagaState, SagaStore } from '@saga-bus/core';
+
+/**
+ * Minimal Prisma client interface required by the store.
+ * This avoids a hard dependency on a specific Prisma version.
+ */
+interface PrismaClientLike {
+    sagaInstance: {
+        findUnique: (args: {
+            where: {
+                sagaName_id: {
+                    sagaName: string;
+                    id: string;
+                };
+            };
+        }) => Promise<SagaInstanceRecord | null>;
+        findFirst: (args: {
+            where: {
+                sagaName: string;
+                correlationId: string;
+            };
+        }) => Promise<SagaInstanceRecord | null>;
+        findMany: (args: {
+            where: {
+                sagaName: string;
+                isCompleted?: boolean;
+            };
+            orderBy?: {
+                createdAt: "asc" | "desc";
+            };
+            take?: number;
+            skip?: number;
+        }) => Promise<SagaInstanceRecord[]>;
+        create: (args: {
+            data: SagaInstanceCreateInput;
+        }) => Promise<SagaInstanceRecord>;
+        update: (args: {
+            where: {
+                sagaName_id: {
+                    sagaName: string;
+                    id: string;
+                };
+            };
+            data: SagaInstanceUpdateInput;
+        }) => Promise<SagaInstanceRecord>;
+        updateMany: (args: {
+            where: {
+                sagaName: string;
+                id: string;
+                version: number;
+            };
+            data: SagaInstanceUpdateInput;
+        }) => Promise<{
+            count: number;
+        }>;
+        delete: (args: {
+            where: {
+                sagaName_id: {
+                    sagaName: string;
+                    id: string;
+                };
+            };
+        }) => Promise<SagaInstanceRecord>;
+        deleteMany: (args: {
+            where: {
+                sagaName: string;
+                isCompleted?: boolean;
+                updatedAt?: {
+                    lt: Date;
+                };
+            };
+        }) => Promise<{
+            count: number;
+        }>;
+        count: (args: {
+            where: {
+                sagaName: string;
+                isCompleted?: boolean;
+            };
+        }) => Promise<number>;
+    };
+}
+/**
+ * Shape of a SagaInstance record from Prisma.
+ */
+interface SagaInstanceRecord {
+    id: string;
+    sagaName: string;
+    correlationId: string;
+    version: number;
+    isCompleted: boolean;
+    state: unknown;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/**
+ * Input for creating a SagaInstance.
+ */
+interface SagaInstanceCreateInput {
+    id: string;
+    sagaName: string;
+    correlationId: string;
+    version: number;
+    isCompleted: boolean;
+    state: unknown;
+    createdAt?: Date;
+    updatedAt?: Date;
+}
+/**
+ * Input for updating a SagaInstance.
+ */
+interface SagaInstanceUpdateInput {
+    version?: number;
+    isCompleted?: boolean;
+    state?: unknown;
+    updatedAt?: Date;
+}
+/**
+ * Options for creating a PrismaSagaStore.
+ */
+interface PrismaSagaStoreOptions {
+    /**
+     * Prisma client instance.
+     */
+    prisma: PrismaClientLike;
+}
+
+/**
+ * Prisma-backed saga store.
+ *
+ * @example
+ * ```typescript
+ * import { PrismaClient } from "@prisma/client";
+ *
+ * const prisma = new PrismaClient();
+ * const store = new PrismaSagaStore<OrderState>({ prisma });
+ *
+ * const bus = await createBus({
+ *   transport,
+ *   sagas: [{ definition: orderSaga, store }],
+ * });
+ * ```
+ */
+declare class PrismaSagaStore<TState extends SagaState> implements SagaStore<TState> {
+    private readonly prisma;
+    constructor(options: PrismaSagaStoreOptions);
+    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>;
+    /**
+     * Insert a saga with explicit correlation ID.
+     */
+    insertWithCorrelation(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 Prisma record to saga state.
+     */
+    private recordToState;
+    /**
+     * 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 { type PrismaClientLike, PrismaSagaStore, type PrismaSagaStoreOptions, type SagaInstanceRecord };

package/dist/index.d.ts

@@ -0,0 +1,180 @@
+import { SagaState, SagaStore } from '@saga-bus/core';
+
+/**
+ * Minimal Prisma client interface required by the store.
+ * This avoids a hard dependency on a specific Prisma version.
+ */
+interface PrismaClientLike {
+    sagaInstance: {
+        findUnique: (args: {
+            where: {
+                sagaName_id: {
+                    sagaName: string;
+                    id: string;
+                };
+            };
+        }) => Promise<SagaInstanceRecord | null>;
+        findFirst: (args: {
+            where: {
+                sagaName: string;
+                correlationId: string;
+            };
+        }) => Promise<SagaInstanceRecord | null>;
+        findMany: (args: {
+            where: {
+                sagaName: string;
+                isCompleted?: boolean;
+            };
+            orderBy?: {
+                createdAt: "asc" | "desc";
+            };
+            take?: number;
+            skip?: number;
+        }) => Promise<SagaInstanceRecord[]>;
+        create: (args: {
+            data: SagaInstanceCreateInput;
+        }) => Promise<SagaInstanceRecord>;
+        update: (args: {
+            where: {
+                sagaName_id: {
+                    sagaName: string;
+                    id: string;
+                };
+            };
+            data: SagaInstanceUpdateInput;
+        }) => Promise<SagaInstanceRecord>;
+        updateMany: (args: {
+            where: {
+                sagaName: string;
+                id: string;
+                version: number;
+            };
+            data: SagaInstanceUpdateInput;
+        }) => Promise<{
+            count: number;
+        }>;
+        delete: (args: {
+            where: {
+                sagaName_id: {
+                    sagaName: string;
+                    id: string;
+                };
+            };
+        }) => Promise<SagaInstanceRecord>;
+        deleteMany: (args: {
+            where: {
+                sagaName: string;
+                isCompleted?: boolean;
+                updatedAt?: {
+                    lt: Date;
+                };
+            };
+        }) => Promise<{
+            count: number;
+        }>;
+        count: (args: {
+            where: {
+                sagaName: string;
+                isCompleted?: boolean;
+            };
+        }) => Promise<number>;
+    };
+}
+/**
+ * Shape of a SagaInstance record from Prisma.
+ */
+interface SagaInstanceRecord {
+    id: string;
+    sagaName: string;
+    correlationId: string;
+    version: number;
+    isCompleted: boolean;
+    state: unknown;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/**
+ * Input for creating a SagaInstance.
+ */
+interface SagaInstanceCreateInput {
+    id: string;
+    sagaName: string;
+    correlationId: string;
+    version: number;
+    isCompleted: boolean;
+    state: unknown;
+    createdAt?: Date;
+    updatedAt?: Date;
+}
+/**
+ * Input for updating a SagaInstance.
+ */
+interface SagaInstanceUpdateInput {
+    version?: number;
+    isCompleted?: boolean;
+    state?: unknown;
+    updatedAt?: Date;
+}
+/**
+ * Options for creating a PrismaSagaStore.
+ */
+interface PrismaSagaStoreOptions {
+    /**
+     * Prisma client instance.
+     */
+    prisma: PrismaClientLike;
+}
+
+/**
+ * Prisma-backed saga store.
+ *
+ * @example
+ * ```typescript
+ * import { PrismaClient } from "@prisma/client";
+ *
+ * const prisma = new PrismaClient();
+ * const store = new PrismaSagaStore<OrderState>({ prisma });
+ *
+ * const bus = await createBus({
+ *   transport,
+ *   sagas: [{ definition: orderSaga, store }],
+ * });
+ * ```
+ */
+declare class PrismaSagaStore<TState extends SagaState> implements SagaStore<TState> {
+    private readonly prisma;
+    constructor(options: PrismaSagaStoreOptions);
+    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>;
+    /**
+     * Insert a saga with explicit correlation ID.
+     */
+    insertWithCorrelation(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 Prisma record to saga state.
+     */
+    private recordToState;
+    /**
+     * 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 { type PrismaClientLike, PrismaSagaStore, type PrismaSagaStoreOptions, type SagaInstanceRecord };

package/dist/index.js

@@ -0,0 +1,159 @@
+// src/PrismaSagaStore.ts
+import { ConcurrencyError } from "@saga-bus/core";
+var PrismaSagaStore = class {
+  prisma;
+  constructor(options) {
+    this.prisma = options.prisma;
+  }
+  async getById(sagaName, sagaId) {
+    const record = await this.prisma.sagaInstance.findUnique({
+      where: { sagaName_id: { sagaName, id: sagaId } }
+    });
+    if (!record) {
+      return null;
+    }
+    return this.recordToState(record);
+  }
+  async getByCorrelationId(sagaName, correlationId) {
+    const record = await this.prisma.sagaInstance.findFirst({
+      where: {
+        sagaName,
+        correlationId
+      }
+    });
+    if (!record) {
+      return null;
+    }
+    return this.recordToState(record);
+  }
+  async insert(sagaName, correlationId, state) {
+    const { sagaId, version, isCompleted, createdAt, updatedAt } = state.metadata;
+    await this.prisma.sagaInstance.create({
+      data: {
+        id: sagaId,
+        sagaName,
+        correlationId,
+        version,
+        isCompleted,
+        state,
+        createdAt,
+        updatedAt
+      }
+    });
+  }
+  /**
+   * Insert a saga with explicit correlation ID.
+   */
+  async insertWithCorrelation(sagaName, correlationId, state) {
+    const { sagaId, version, isCompleted, createdAt, updatedAt } = state.metadata;
+    await this.prisma.sagaInstance.create({
+      data: {
+        id: sagaId,
+        sagaName,
+        correlationId,
+        version,
+        isCompleted,
+        state,
+        createdAt,
+        updatedAt
+      }
+    });
+  }
+  async update(sagaName, state, expectedVersion) {
+    const { sagaId, version, isCompleted, updatedAt } = state.metadata;
+    const result = await this.prisma.sagaInstance.updateMany({
+      where: {
+        sagaName,
+        id: sagaId,
+        version: expectedVersion
+      },
+      data: {
+        version,
+        isCompleted,
+        state,
+        updatedAt
+      }
+    });
+    if (result.count === 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) {
+    try {
+      await this.prisma.sagaInstance.delete({
+        where: { sagaName_id: { sagaName, id: sagaId } }
+      });
+    } catch {
+    }
+  }
+  /**
+   * Convert a Prisma record to saga state.
+   */
+  recordToState(record) {
+    const state = record.state;
+    return {
+      ...state,
+      metadata: {
+        ...state.metadata,
+        sagaId: record.id,
+        version: record.version,
+        isCompleted: record.isCompleted,
+        createdAt: record.createdAt,
+        updatedAt: record.updatedAt
+      }
+    };
+  }
+  // ============ Query Helpers ============
+  /**
+   * Find sagas by name with pagination.
+   */
+  async findByName(sagaName, options) {
+    const records = await this.prisma.sagaInstance.findMany({
+      where: {
+        sagaName,
+        ...options?.completed !== void 0 ? { isCompleted: options.completed } : {}
+      },
+      orderBy: { createdAt: "desc" },
+      take: options?.limit,
+      skip: options?.offset
+    });
+    return records.map((record) => this.recordToState(record));
+  }
+  /**
+   * Count sagas by name.
+   */
+  async countByName(sagaName, options) {
+    return this.prisma.sagaInstance.count({
+      where: {
+        sagaName,
+        ...options?.completed !== void 0 ? { isCompleted: options.completed } : {}
+      }
+    });
+  }
+  /**
+   * Delete completed sagas older than a given date.
+   */
+  async deleteCompletedBefore(sagaName, before) {
+    const result = await this.prisma.sagaInstance.deleteMany({
+      where: {
+        sagaName,
+        isCompleted: true,
+        updatedAt: { lt: before }
+      }
+    });
+    return result.count;
+  }
+};
+export {
+  PrismaSagaStore
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/PrismaSagaStore.ts"],"sourcesContent":["import type { SagaStore, SagaState } from \"@saga-bus/core\";\nimport { ConcurrencyError } from \"@saga-bus/core\";\nimport type {\n  PrismaSagaStoreOptions,\n  PrismaClientLike,\n  SagaInstanceRecord,\n} from \"./types.js\";\n\n/**\n * Prisma-backed saga store.\n *\n * @example\n * ```typescript\n * import { PrismaClient } from \"@prisma/client\";\n *\n * const prisma = new PrismaClient();\n * const store = new PrismaSagaStore<OrderState>({ prisma });\n *\n * const bus = await createBus({\n *   transport,\n *   sagas: [{ definition: orderSaga, store }],\n * });\n * ```\n */\nexport class PrismaSagaStore<TState extends SagaState>\n  implements SagaStore<TState>\n{\n  private readonly prisma: PrismaClientLike;\n\n  constructor(options: PrismaSagaStoreOptions) {\n    this.prisma = options.prisma;\n  }\n\n  async getById(sagaName: string, sagaId: string): Promise<TState | null> {\n    const record = await this.prisma.sagaInstance.findUnique({\n      where: { sagaName_id: { sagaName, id: sagaId } },\n    });\n\n    if (!record) {\n      return null;\n    }\n\n    return this.recordToState(record);\n  }\n\n  async getByCorrelationId(\n    sagaName: string,\n    correlationId: string\n  ): Promise<TState | null> {\n    const record = await this.prisma.sagaInstance.findFirst({\n      where: {\n        sagaName,\n        correlationId,\n      },\n    });\n\n    if (!record) {\n      return null;\n    }\n\n    return this.recordToState(record);\n  }\n\n  async insert(sagaName: string, correlationId: string, state: TState): Promise<void> {\n    const { sagaId, version, isCompleted, createdAt, updatedAt } =\n      state.metadata;\n\n    await this.prisma.sagaInstance.create({\n      data: {\n        id: sagaId,\n        sagaName,\n        correlationId,\n        version,\n        isCompleted,\n        state: state as unknown,\n        createdAt,\n        updatedAt,\n      },\n    });\n  }\n\n  /**\n   * Insert a saga with explicit correlation ID.\n   */\n  async insertWithCorrelation(\n    sagaName: string,\n    correlationId: string,\n    state: TState\n  ): Promise<void> {\n    const { sagaId, version, isCompleted, createdAt, updatedAt } =\n      state.metadata;\n\n    await this.prisma.sagaInstance.create({\n      data: {\n        id: sagaId,\n        sagaName,\n        correlationId,\n        version,\n        isCompleted,\n        state: state as unknown,\n        createdAt,\n        updatedAt,\n      },\n    });\n  }\n\n  async update(\n    sagaName: string,\n    state: TState,\n    expectedVersion: number\n  ): Promise<void> {\n    const { sagaId, version, isCompleted, updatedAt } = state.metadata;\n\n    // Use updateMany with version check for optimistic concurrency\n    const result = await this.prisma.sagaInstance.updateMany({\n      where: {\n        sagaName,\n        id: sagaId,\n        version: expectedVersion,\n      },\n      data: {\n        version,\n        isCompleted,\n        state: state as unknown,\n        updatedAt,\n      },\n    });\n\n    if (result.count === 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    try {\n      await this.prisma.sagaInstance.delete({\n        where: { sagaName_id: { sagaName, id: sagaId } },\n      });\n    } catch {\n      // Ignore if not found\n    }\n  }\n\n  /**\n   * Convert a Prisma record to saga state.\n   */\n  private recordToState(record: SagaInstanceRecord): TState {\n    const state = record.state as TState;\n\n    // Ensure metadata is consistent with database values\n    return {\n      ...state,\n      metadata: {\n        ...state.metadata,\n        sagaId: record.id,\n        version: record.version,\n        isCompleted: record.isCompleted,\n        createdAt: record.createdAt,\n        updatedAt: record.updatedAt,\n      },\n    };\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    const records = await this.prisma.sagaInstance.findMany({\n      where: {\n        sagaName,\n        ...(options?.completed !== undefined\n          ? { isCompleted: options.completed }\n          : {}),\n      },\n      orderBy: { createdAt: \"desc\" },\n      take: options?.limit,\n      skip: options?.offset,\n    });\n\n    return records.map((record) => this.recordToState(record));\n  }\n\n  /**\n   * Count sagas by name.\n   */\n  async countByName(\n    sagaName: string,\n    options?: { completed?: boolean }\n  ): Promise<number> {\n    return this.prisma.sagaInstance.count({\n      where: {\n        sagaName,\n        ...(options?.completed !== undefined\n          ? { isCompleted: options.completed }\n          : {}),\n      },\n    });\n  }\n\n  /**\n   * Delete completed sagas older than a given date.\n   */\n  async deleteCompletedBefore(sagaName: string, before: Date): Promise<number> {\n    const result = await this.prisma.sagaInstance.deleteMany({\n      where: {\n        sagaName,\n        isCompleted: true,\n        updatedAt: { lt: before },\n      },\n    });\n\n    return result.count;\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@saga-bus/store-prisma",
+  "version": "0.1.0",
+  "description": "Prisma ORM adapter for saga-bus state storage",
+  "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",
+    "prisma",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/deanforan/saga-bus.git",
+    "directory": "packages/store-prisma"
+  },
+  "bugs": {
+    "url": "https://github.com/deanforan/saga-bus/issues"
+  },
+  "homepage": "https://github.com/deanforan/saga-bus#readme",
+  "keywords": [
+    "saga",
+    "message-bus",
+    "store",
+    "prisma",
+    "orm"
+  ],
+  "dependencies": {
+    "@saga-bus/core": "0.1.0"
+  },
+  "devDependencies": {
+    "@prisma/client": "^6.8.0",
+    "prisma": "^6.8.0",
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.2",
+    "vitest": "^3.2.4",
+    "@repo/eslint-config": "0.0.0",
+    "@repo/typescript-config": "0.0.0"
+  },
+  "peerDependencies": {
+    "@prisma/client": ">=5.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "eslint src/",
+    "check-types": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}

package/prisma/schema.prisma.example

@@ -0,0 +1,37 @@
+// This is an example schema for saga-bus.
+// Copy this to your project's schema.prisma and run `prisma migrate`.
+
+generator client {
+  provider = "prisma-client-js"
+}
+
+datasource db {
+  provider = "postgresql"
+  url      = env("DATABASE_URL")
+}
+
+model SagaInstance {
+  id            String   @db.VarChar(128)
+  sagaName      String   @map("saga_name") @db.VarChar(128)
+  correlationId String   @map("correlation_id") @db.VarChar(256)
+  version       Int
+  isCompleted   Boolean  @default(false) @map("is_completed")
+  state         Json
+
+  createdAt     DateTime @default(now()) @map("created_at")
+  updatedAt     DateTime @updatedAt @map("updated_at")
+
+  // Composite primary key for isolation between saga types
+  @@id([sagaName, id])
+
+  // Index for correlation ID lookups
+  @@unique([sagaName, correlationId])
+
+  // Index for finding incomplete sagas
+  @@index([sagaName, isCompleted])
+
+  // Index for cleanup queries
+  @@index([sagaName, isCompleted, updatedAt])
+
+  @@map("saga_instances")
+}