@saga-bus/store-dynamodb 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,102 @@
+# @saga-bus/store-dynamodb
+
+AWS DynamoDB saga store for saga-bus.
+
+## Installation
+
+```bash
+pnpm add @saga-bus/store-dynamodb @aws-sdk/client-dynamodb @aws-sdk/lib-dynamodb
+```
+
+## Usage
+
+```typescript
+import { DynamoDBClient } from "@aws-sdk/client-dynamodb";
+import { DynamoDBDocumentClient } from "@aws-sdk/lib-dynamodb";
+import { DynamoDBSagaStore, createTable } from "@saga-bus/store-dynamodb";
+import { createBus } from "@saga-bus/core";
+
+const dynamoClient = new DynamoDBClient({ region: "us-east-1" });
+const docClient = DynamoDBDocumentClient.from(dynamoClient);
+
+// Create table (run once, or use CloudFormation/CDK)
+await createTable(dynamoClient, { tableName: "saga-instances" });
+
+const store = new DynamoDBSagaStore({
+  client: docClient,
+  tableName: "saga-instances",
+});
+
+const bus = createBus({
+  sagas: [{ definition: mySaga, store }],
+  transport,
+});
+```
+
+## Table Schema
+
+The store uses a single-table design:
+
+| Key | Pattern | Description |
+|-----|---------|-------------|
+| `PK` | `SAGA#<sagaName>` | Partition key |
+| `SK` | `ID#<sagaId>` | Sort key |
+| `GSI1PK` | `SAGA#<sagaName>` | Correlation index PK |
+| `GSI1SK` | `CORR#<correlationId>` | Correlation index SK |
+| `GSI2PK` | `COMPLETED#<date>` | Cleanup index PK |
+| `GSI2SK` | `<sagaName>#<sagaId>` | Cleanup index SK |
+
+## Features
+
+- Single-table design for cost efficiency
+- Optimistic concurrency via conditional writes
+- GSI for correlation ID lookups
+- GSI for cleanup queries by completion date
+- Automatic GSI index management
+
+## Configuration
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `client` | `DynamoDBDocumentClient` | required | DynamoDB Document Client |
+| `tableName` | `string` | required | Table name |
+| `correlationIndexName` | `string` | `"GSI1"` | Correlation GSI name |
+| `cleanupIndexName` | `string` | `"GSI2"` | Cleanup GSI name |
+
+## Sharing Across Sagas
+
+A single store instance can be shared across multiple sagas:
+
+```typescript
+const store = new DynamoDBSagaStore({ client, tableName: "saga-instances" });
+
+const bus = createBus({
+  transport,
+  store, // shared by all sagas
+  sagas: [
+    { definition: orderSaga },
+    { definition: paymentSaga },
+  ],
+});
+```
+
+Data is isolated by `sagaName` in the partition key, so different saga types won't conflict.
+
+## Table Management
+
+```typescript
+import { createTable, deleteTable, getTableSchema } from "@saga-bus/store-dynamodb";
+
+// Create with defaults
+await createTable(dynamoClient, { tableName: "saga-instances" });
+
+// Get schema for CloudFormation/CDK
+const schema = getTableSchema("saga-instances");
+
+// Delete table
+await deleteTable(dynamoClient, "saga-instances");
+```
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,333 @@
+"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, {
+  DynamoDBSagaStore: () => DynamoDBSagaStore,
+  createTable: () => createTable,
+  deleteTable: () => deleteTable,
+  getTableSchema: () => getTableSchema
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/DynamoDBSagaStore.ts
+var import_lib_dynamodb = require("@aws-sdk/lib-dynamodb");
+var import_core = require("@saga-bus/core");
+var DynamoDBSagaStore = class {
+  client;
+  tableName;
+  correlationIndexName;
+  cleanupIndexName;
+  constructor(options) {
+    this.client = options.client;
+    this.tableName = options.tableName;
+    this.correlationIndexName = options.correlationIndexName ?? "GSI1";
+    this.cleanupIndexName = options.cleanupIndexName ?? "GSI2";
+  }
+  async getById(sagaName, sagaId) {
+    const result = await this.client.send(
+      new import_lib_dynamodb.GetCommand({
+        TableName: this.tableName,
+        Key: {
+          PK: sagaName,
+          SK: sagaId
+        }
+      })
+    );
+    if (!result.Item) {
+      return null;
+    }
+    return this.itemToState(result.Item);
+  }
+  async getByCorrelationId(sagaName, correlationId) {
+    const result = await this.client.send(
+      new import_lib_dynamodb.QueryCommand({
+        TableName: this.tableName,
+        IndexName: this.correlationIndexName,
+        KeyConditionExpression: "GSI1PK = :pk AND GSI1SK = :sk",
+        ExpressionAttributeValues: {
+          ":pk": sagaName,
+          ":sk": correlationId
+        },
+        Limit: 1
+      })
+    );
+    if (!result.Items || result.Items.length === 0) {
+      return null;
+    }
+    return this.itemToState(result.Items[0]);
+  }
+  async insert(sagaName, correlationId, state) {
+    const { sagaId, version, isCompleted, createdAt, updatedAt } = state.metadata;
+    const serializedState = this.serializeState(state);
+    const item = {
+      PK: sagaName,
+      SK: sagaId,
+      sagaName,
+      sagaId,
+      correlationId,
+      version,
+      isCompleted,
+      state: serializedState,
+      createdAt: createdAt.toISOString(),
+      updatedAt: updatedAt.toISOString(),
+      GSI1PK: sagaName,
+      GSI1SK: correlationId
+    };
+    if (isCompleted) {
+      item.GSI2PK = sagaName;
+      item.GSI2SK = updatedAt.toISOString();
+    }
+    await this.client.send(
+      new import_lib_dynamodb.PutCommand({
+        TableName: this.tableName,
+        Item: item,
+        ConditionExpression: "attribute_not_exists(PK)"
+      })
+    );
+  }
+  async update(sagaName, state, expectedVersion) {
+    const { sagaId, version, isCompleted, updatedAt } = state.metadata;
+    try {
+      const updateExpression = isCompleted ? "SET version = :version, isCompleted = :isCompleted, #state = :state, updatedAt = :updatedAt, GSI2PK = :gsi2pk, GSI2SK = :gsi2sk" : "SET version = :version, isCompleted = :isCompleted, #state = :state, updatedAt = :updatedAt REMOVE GSI2PK, GSI2SK";
+      const serializedState = this.serializeState(state);
+      const expressionValues = {
+        ":version": version,
+        ":isCompleted": isCompleted,
+        ":state": serializedState,
+        ":updatedAt": updatedAt.toISOString(),
+        ":expectedVersion": expectedVersion
+      };
+      if (isCompleted) {
+        expressionValues[":gsi2pk"] = sagaName;
+        expressionValues[":gsi2sk"] = updatedAt.toISOString();
+      }
+      await this.client.send(
+        new import_lib_dynamodb.UpdateCommand({
+          TableName: this.tableName,
+          Key: {
+            PK: sagaName,
+            SK: sagaId
+          },
+          UpdateExpression: updateExpression,
+          ConditionExpression: "version = :expectedVersion",
+          ExpressionAttributeNames: {
+            "#state": "state"
+          },
+          ExpressionAttributeValues: expressionValues
+        })
+      );
+    } catch (error) {
+      if (error instanceof Error && error.name === "ConditionalCheckFailedException") {
+        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`);
+        }
+      }
+      throw error;
+    }
+  }
+  async delete(sagaName, sagaId) {
+    await this.client.send(
+      new import_lib_dynamodb.DeleteCommand({
+        TableName: this.tableName,
+        Key: {
+          PK: sagaName,
+          SK: sagaId
+        }
+      })
+    );
+  }
+  itemToState(item) {
+    const state = item.state;
+    return {
+      ...state,
+      metadata: {
+        ...state.metadata,
+        sagaId: item.sagaId,
+        version: item.version,
+        isCompleted: item.isCompleted,
+        createdAt: new Date(item.createdAt),
+        updatedAt: new Date(item.updatedAt)
+      }
+    };
+  }
+  /**
+   * Serialize state for DynamoDB storage by converting Date objects to ISO strings.
+   */
+  serializeState(state) {
+    return JSON.parse(JSON.stringify(state, (_, value) => {
+      if (value instanceof Date) {
+        return value.toISOString();
+      }
+      return value;
+    }));
+  }
+  // ============ Query Helpers ============
+  /**
+   * Find sagas by name with pagination.
+   */
+  async findByName(sagaName, options) {
+    let filterExpression;
+    const expressionValues = { ":pk": sagaName };
+    if (options?.completed !== void 0) {
+      filterExpression = "isCompleted = :isCompleted";
+      expressionValues[":isCompleted"] = options.completed;
+    }
+    const result = await this.client.send(
+      new import_lib_dynamodb.QueryCommand({
+        TableName: this.tableName,
+        KeyConditionExpression: "PK = :pk",
+        FilterExpression: filterExpression,
+        ExpressionAttributeValues: expressionValues,
+        Limit: options?.limit ?? 100,
+        ExclusiveStartKey: options?.startKey,
+        ScanIndexForward: false
+      })
+    );
+    const items = (result.Items ?? []).map(
+      (item) => this.itemToState(item)
+    );
+    return {
+      items,
+      lastKey: result.LastEvaluatedKey
+    };
+  }
+  /**
+   * Delete completed sagas older than a given date.
+   * Note: This performs a query + batch delete which may require pagination.
+   */
+  async deleteCompletedBefore(sagaName, before) {
+    let deletedCount = 0;
+    let lastKey;
+    do {
+      const result = await this.client.send(
+        new import_lib_dynamodb.QueryCommand({
+          TableName: this.tableName,
+          IndexName: this.cleanupIndexName,
+          KeyConditionExpression: "GSI2PK = :pk AND GSI2SK < :before",
+          ExpressionAttributeValues: {
+            ":pk": sagaName,
+            ":before": before.toISOString()
+          },
+          Limit: 25,
+          ExclusiveStartKey: lastKey
+        })
+      );
+      if (result.Items && result.Items.length > 0) {
+        for (const item of result.Items) {
+          await this.delete(sagaName, item.SK);
+          deletedCount++;
+        }
+      }
+      lastKey = result.LastEvaluatedKey;
+    } while (lastKey);
+    return deletedCount;
+  }
+};
+
+// src/schema.ts
+var import_client_dynamodb = require("@aws-sdk/client-dynamodb");
+function getTableSchema(tableName, options) {
+  return {
+    tableName,
+    correlationIndexName: options?.correlationIndexName ?? "GSI1",
+    cleanupIndexName: options?.cleanupIndexName ?? "GSI2"
+  };
+}
+async function createTable(client, schema) {
+  const command = new import_client_dynamodb.CreateTableCommand({
+    TableName: schema.tableName,
+    KeySchema: [
+      { AttributeName: "PK", KeyType: "HASH" },
+      { AttributeName: "SK", KeyType: "RANGE" }
+    ],
+    AttributeDefinitions: [
+      { AttributeName: "PK", AttributeType: "S" },
+      { AttributeName: "SK", AttributeType: "S" },
+      { AttributeName: "GSI1PK", AttributeType: "S" },
+      { AttributeName: "GSI1SK", AttributeType: "S" },
+      { AttributeName: "GSI2PK", AttributeType: "S" },
+      { AttributeName: "GSI2SK", AttributeType: "S" }
+    ],
+    GlobalSecondaryIndexes: [
+      {
+        IndexName: schema.correlationIndexName,
+        KeySchema: [
+          { AttributeName: "GSI1PK", KeyType: "HASH" },
+          { AttributeName: "GSI1SK", KeyType: "RANGE" }
+        ],
+        Projection: { ProjectionType: "ALL" },
+        ProvisionedThroughput: {
+          ReadCapacityUnits: 5,
+          WriteCapacityUnits: 5
+        }
+      },
+      {
+        IndexName: schema.cleanupIndexName,
+        KeySchema: [
+          { AttributeName: "GSI2PK", KeyType: "HASH" },
+          { AttributeName: "GSI2SK", KeyType: "RANGE" }
+        ],
+        Projection: { ProjectionType: "KEYS_ONLY" },
+        ProvisionedThroughput: {
+          ReadCapacityUnits: 5,
+          WriteCapacityUnits: 5
+        }
+      }
+    ],
+    BillingMode: "PROVISIONED",
+    ProvisionedThroughput: {
+      ReadCapacityUnits: 5,
+      WriteCapacityUnits: 5
+    }
+  });
+  await client.send(command);
+  await waitForTableActive(client, schema.tableName);
+}
+async function deleteTable(client, tableName) {
+  await client.send(new import_client_dynamodb.DeleteTableCommand({ TableName: tableName }));
+}
+async function waitForTableActive(client, tableName) {
+  for (let i = 0; i < 30; i++) {
+    const response = await client.send(
+      new import_client_dynamodb.DescribeTableCommand({ TableName: tableName })
+    );
+    if (response.Table?.TableStatus === "ACTIVE") {
+      return;
+    }
+    await new Promise((resolve) => setTimeout(resolve, 1e3));
+  }
+  throw new Error(`Table ${tableName} did not become active`);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DynamoDBSagaStore,
+  createTable,
+  deleteTable,
+  getTableSchema
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/DynamoDBSagaStore.ts","../src/schema.ts"],"sourcesContent":["export { DynamoDBSagaStore } from \"./DynamoDBSagaStore.js\";\nexport { createTable, deleteTable, getTableSchema } from \"./schema.js\";\nexport type {\n  DynamoDBSagaStoreOptions,\n  SagaInstanceItem,\n  TableSchema,\n} from \"./types.js\";\n","import {\n  GetCommand,\n  PutCommand,\n  UpdateCommand,\n  DeleteCommand,\n  QueryCommand,\n} from \"@aws-sdk/lib-dynamodb\";\nimport type { DynamoDBDocumentClient } from \"@aws-sdk/lib-dynamodb\";\nimport type { SagaStore, SagaState } from \"@saga-bus/core\";\nimport { ConcurrencyError } from \"@saga-bus/core\";\nimport type { DynamoDBSagaStoreOptions, SagaInstanceItem } from \"./types.js\";\n\n/**\n * DynamoDB-backed saga store.\n *\n * @example\n * ```typescript\n * import { DynamoDBClient } from \"@aws-sdk/client-dynamodb\";\n * import { DynamoDBDocumentClient } from \"@aws-sdk/lib-dynamodb\";\n *\n * const client = DynamoDBDocumentClient.from(new DynamoDBClient({}));\n * const store = new DynamoDBSagaStore<OrderState>({\n *   client,\n *   tableName: \"saga_instances\",\n * });\n * ```\n */\nexport class DynamoDBSagaStore<TState extends SagaState>\n  implements SagaStore<TState>\n{\n  private readonly client: DynamoDBDocumentClient;\n  private readonly tableName: string;\n  private readonly correlationIndexName: string;\n  private readonly cleanupIndexName: string;\n\n  constructor(options: DynamoDBSagaStoreOptions) {\n    this.client = options.client;\n    this.tableName = options.tableName;\n    this.correlationIndexName = options.correlationIndexName ?? \"GSI1\";\n    this.cleanupIndexName = options.cleanupIndexName ?? \"GSI2\";\n  }\n\n  async getById(sagaName: string, sagaId: string): Promise<TState | null> {\n    const result = await this.client.send(\n      new GetCommand({\n        TableName: this.tableName,\n        Key: {\n          PK: sagaName,\n          SK: sagaId,\n        },\n      })\n    );\n\n    if (!result.Item) {\n      return null;\n    }\n\n    return this.itemToState(result.Item as SagaInstanceItem);\n  }\n\n  async getByCorrelationId(\n    sagaName: string,\n    correlationId: string\n  ): Promise<TState | null> {\n    const result = await this.client.send(\n      new QueryCommand({\n        TableName: this.tableName,\n        IndexName: this.correlationIndexName,\n        KeyConditionExpression: \"GSI1PK = :pk AND GSI1SK = :sk\",\n        ExpressionAttributeValues: {\n          \":pk\": sagaName,\n          \":sk\": correlationId,\n        },\n        Limit: 1,\n      })\n    );\n\n    if (!result.Items || result.Items.length === 0) {\n      return null;\n    }\n\n    return this.itemToState(result.Items[0] as SagaInstanceItem);\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    // Serialize state with dates converted to ISO strings for DynamoDB compatibility\n    const serializedState = this.serializeState(state);\n\n    const item: SagaInstanceItem = {\n      PK: sagaName,\n      SK: sagaId,\n      sagaName,\n      sagaId,\n      correlationId,\n      version,\n      isCompleted,\n      state: serializedState,\n      createdAt: createdAt.toISOString(),\n      updatedAt: updatedAt.toISOString(),\n      GSI1PK: sagaName,\n      GSI1SK: correlationId,\n    };\n\n    // Only add GSI2 keys for completed sagas (for cleanup queries)\n    if (isCompleted) {\n      item.GSI2PK = sagaName;\n      item.GSI2SK = updatedAt.toISOString();\n    }\n\n    await this.client.send(\n      new PutCommand({\n        TableName: this.tableName,\n        Item: item,\n        ConditionExpression: \"attribute_not_exists(PK)\",\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    try {\n      const updateExpression = isCompleted\n        ? \"SET version = :version, isCompleted = :isCompleted, #state = :state, updatedAt = :updatedAt, GSI2PK = :gsi2pk, GSI2SK = :gsi2sk\"\n        : \"SET version = :version, isCompleted = :isCompleted, #state = :state, updatedAt = :updatedAt REMOVE GSI2PK, GSI2SK\";\n\n      // Serialize state with dates converted to ISO strings for DynamoDB compatibility\n      const serializedState = this.serializeState(state);\n\n      const expressionValues: Record<string, unknown> = {\n        \":version\": version,\n        \":isCompleted\": isCompleted,\n        \":state\": serializedState,\n        \":updatedAt\": updatedAt.toISOString(),\n        \":expectedVersion\": expectedVersion,\n      };\n\n      if (isCompleted) {\n        expressionValues[\":gsi2pk\"] = sagaName;\n        expressionValues[\":gsi2sk\"] = updatedAt.toISOString();\n      }\n\n      await this.client.send(\n        new UpdateCommand({\n          TableName: this.tableName,\n          Key: {\n            PK: sagaName,\n            SK: sagaId,\n          },\n          UpdateExpression: updateExpression,\n          ConditionExpression: \"version = :expectedVersion\",\n          ExpressionAttributeNames: {\n            \"#state\": \"state\",\n          },\n          ExpressionAttributeValues: expressionValues,\n        })\n      );\n    } catch (error) {\n      if (\n        error instanceof Error &&\n        error.name === \"ConditionalCheckFailedException\"\n      ) {\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      throw error;\n    }\n  }\n\n  async delete(sagaName: string, sagaId: string): Promise<void> {\n    await this.client.send(\n      new DeleteCommand({\n        TableName: this.tableName,\n        Key: {\n          PK: sagaName,\n          SK: sagaId,\n        },\n      })\n    );\n  }\n\n  private itemToState(item: SagaInstanceItem): TState {\n    const state = item.state as TState;\n\n    return {\n      ...state,\n      metadata: {\n        ...state.metadata,\n        sagaId: item.sagaId,\n        version: item.version,\n        isCompleted: item.isCompleted,\n        createdAt: new Date(item.createdAt),\n        updatedAt: new Date(item.updatedAt),\n      },\n    };\n  }\n\n  /**\n   * Serialize state for DynamoDB storage by converting Date objects to ISO strings.\n   */\n  private serializeState(state: TState): Record<string, unknown> {\n    return JSON.parse(JSON.stringify(state, (_, value) => {\n      if (value instanceof Date) {\n        return value.toISOString();\n      }\n      return value;\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      startKey?: Record<string, unknown>;\n      completed?: boolean;\n    }\n  ): Promise<{ items: TState[]; lastKey?: Record<string, unknown> }> {\n    let filterExpression: string | undefined;\n    const expressionValues: Record<string, unknown> = { \":pk\": sagaName };\n\n    if (options?.completed !== undefined) {\n      filterExpression = \"isCompleted = :isCompleted\";\n      expressionValues[\":isCompleted\"] = options.completed;\n    }\n\n    const result = await this.client.send(\n      new QueryCommand({\n        TableName: this.tableName,\n        KeyConditionExpression: \"PK = :pk\",\n        FilterExpression: filterExpression,\n        ExpressionAttributeValues: expressionValues,\n        Limit: options?.limit ?? 100,\n        ExclusiveStartKey: options?.startKey,\n        ScanIndexForward: false,\n      })\n    );\n\n    const items = (result.Items ?? []).map((item) =>\n      this.itemToState(item as SagaInstanceItem)\n    );\n\n    return {\n      items,\n      lastKey: result.LastEvaluatedKey,\n    };\n  }\n\n  /**\n   * Delete completed sagas older than a given date.\n   * Note: This performs a query + batch delete which may require pagination.\n   */\n  async deleteCompletedBefore(\n    sagaName: string,\n    before: Date\n  ): Promise<number> {\n    let deletedCount = 0;\n    let lastKey: Record<string, unknown> | undefined;\n\n    do {\n      const result = await this.client.send(\n        new QueryCommand({\n          TableName: this.tableName,\n          IndexName: this.cleanupIndexName,\n          KeyConditionExpression: \"GSI2PK = :pk AND GSI2SK < :before\",\n          ExpressionAttributeValues: {\n            \":pk\": sagaName,\n            \":before\": before.toISOString(),\n          },\n          Limit: 25,\n          ExclusiveStartKey: lastKey,\n        })\n      );\n\n      if (result.Items && result.Items.length > 0) {\n        for (const item of result.Items) {\n          await this.delete(sagaName, item.SK as string);\n          deletedCount++;\n        }\n      }\n\n      lastKey = result.LastEvaluatedKey;\n    } while (lastKey);\n\n    return deletedCount;\n  }\n}\n","import {\n  CreateTableCommand,\n  DeleteTableCommand,\n  DescribeTableCommand,\n  type DynamoDBClient,\n} from \"@aws-sdk/client-dynamodb\";\nimport type { TableSchema } from \"./types.js\";\n\n/**\n * Get the table schema definition.\n */\nexport function getTableSchema(\n  tableName: string,\n  options?: {\n    correlationIndexName?: string;\n    cleanupIndexName?: string;\n  }\n): TableSchema {\n  return {\n    tableName,\n    correlationIndexName: options?.correlationIndexName ?? \"GSI1\",\n    cleanupIndexName: options?.cleanupIndexName ?? \"GSI2\",\n  };\n}\n\n/**\n * Create the saga instances table with required indexes.\n */\nexport async function createTable(\n  client: DynamoDBClient,\n  schema: TableSchema\n): Promise<void> {\n  const command = new CreateTableCommand({\n    TableName: schema.tableName,\n    KeySchema: [\n      { AttributeName: \"PK\", KeyType: \"HASH\" },\n      { AttributeName: \"SK\", KeyType: \"RANGE\" },\n    ],\n    AttributeDefinitions: [\n      { AttributeName: \"PK\", AttributeType: \"S\" },\n      { AttributeName: \"SK\", AttributeType: \"S\" },\n      { AttributeName: \"GSI1PK\", AttributeType: \"S\" },\n      { AttributeName: \"GSI1SK\", AttributeType: \"S\" },\n      { AttributeName: \"GSI2PK\", AttributeType: \"S\" },\n      { AttributeName: \"GSI2SK\", AttributeType: \"S\" },\n    ],\n    GlobalSecondaryIndexes: [\n      {\n        IndexName: schema.correlationIndexName,\n        KeySchema: [\n          { AttributeName: \"GSI1PK\", KeyType: \"HASH\" },\n          { AttributeName: \"GSI1SK\", KeyType: \"RANGE\" },\n        ],\n        Projection: { ProjectionType: \"ALL\" },\n        ProvisionedThroughput: {\n          ReadCapacityUnits: 5,\n          WriteCapacityUnits: 5,\n        },\n      },\n      {\n        IndexName: schema.cleanupIndexName,\n        KeySchema: [\n          { AttributeName: \"GSI2PK\", KeyType: \"HASH\" },\n          { AttributeName: \"GSI2SK\", KeyType: \"RANGE\" },\n        ],\n        Projection: { ProjectionType: \"KEYS_ONLY\" },\n        ProvisionedThroughput: {\n          ReadCapacityUnits: 5,\n          WriteCapacityUnits: 5,\n        },\n      },\n    ],\n    BillingMode: \"PROVISIONED\",\n    ProvisionedThroughput: {\n      ReadCapacityUnits: 5,\n      WriteCapacityUnits: 5,\n    },\n  });\n\n  await client.send(command);\n\n  // Wait for table to be active\n  await waitForTableActive(client, schema.tableName);\n}\n\n/**\n * Delete the saga instances table.\n */\nexport async function deleteTable(\n  client: DynamoDBClient,\n  tableName: string\n): Promise<void> {\n  await client.send(new DeleteTableCommand({ TableName: tableName }));\n}\n\n/**\n * Wait for table to be active.\n */\nasync function waitForTableActive(\n  client: DynamoDBClient,\n  tableName: string\n): Promise<void> {\n  for (let i = 0; i < 30; i++) {\n    const response = await client.send(\n      new DescribeTableCommand({ TableName: tableName })\n    );\n\n    if (response.Table?.TableStatus === \"ACTIVE\") {\n      return;\n    }\n\n    await new Promise((resolve) => setTimeout(resolve, 1000));\n  }\n\n  throw new Error(`Table ${tableName} did not become active`);\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,121 @@
+import { SagaState, SagaStore } from '@saga-bus/core';
+import { DynamoDBDocumentClient } from '@aws-sdk/lib-dynamodb';
+import { DynamoDBClient } from '@aws-sdk/client-dynamodb';
+
+/**
+ * DynamoDB saga store configuration options.
+ */
+interface DynamoDBSagaStoreOptions {
+    /**
+     * DynamoDB Document Client instance.
+     */
+    client: DynamoDBDocumentClient;
+    /**
+     * Table name for saga instances.
+     */
+    tableName: string;
+    /**
+     * Name of the correlation ID GSI.
+     * @default "GSI1"
+     */
+    correlationIndexName?: string;
+    /**
+     * Name of the cleanup GSI (for querying completed sagas by date).
+     * @default "GSI2"
+     */
+    cleanupIndexName?: string;
+}
+/**
+ * Shape of a saga instance item in DynamoDB.
+ */
+interface SagaInstanceItem {
+    PK: string;
+    SK: string;
+    sagaName: string;
+    sagaId: string;
+    correlationId: string;
+    version: number;
+    isCompleted: boolean;
+    state: Record<string, unknown>;
+    createdAt: string;
+    updatedAt: string;
+    GSI1PK: string;
+    GSI1SK: string;
+    GSI2PK?: string;
+    GSI2SK?: string;
+}
+/**
+ * Table schema definition for creating the table.
+ */
+interface TableSchema {
+    tableName: string;
+    correlationIndexName: string;
+    cleanupIndexName: string;
+}
+
+/**
+ * DynamoDB-backed saga store.
+ *
+ * @example
+ * ```typescript
+ * import { DynamoDBClient } from "@aws-sdk/client-dynamodb";
+ * import { DynamoDBDocumentClient } from "@aws-sdk/lib-dynamodb";
+ *
+ * const client = DynamoDBDocumentClient.from(new DynamoDBClient({}));
+ * const store = new DynamoDBSagaStore<OrderState>({
+ *   client,
+ *   tableName: "saga_instances",
+ * });
+ * ```
+ */
+declare class DynamoDBSagaStore<TState extends SagaState> implements SagaStore<TState> {
+    private readonly client;
+    private readonly tableName;
+    private readonly correlationIndexName;
+    private readonly cleanupIndexName;
+    constructor(options: DynamoDBSagaStoreOptions);
+    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>;
+    private itemToState;
+    /**
+     * Serialize state for DynamoDB storage by converting Date objects to ISO strings.
+     */
+    private serializeState;
+    /**
+     * Find sagas by name with pagination.
+     */
+    findByName(sagaName: string, options?: {
+        limit?: number;
+        startKey?: Record<string, unknown>;
+        completed?: boolean;
+    }): Promise<{
+        items: TState[];
+        lastKey?: Record<string, unknown>;
+    }>;
+    /**
+     * Delete completed sagas older than a given date.
+     * Note: This performs a query + batch delete which may require pagination.
+     */
+    deleteCompletedBefore(sagaName: string, before: Date): Promise<number>;
+}
+
+/**
+ * Get the table schema definition.
+ */
+declare function getTableSchema(tableName: string, options?: {
+    correlationIndexName?: string;
+    cleanupIndexName?: string;
+}): TableSchema;
+/**
+ * Create the saga instances table with required indexes.
+ */
+declare function createTable(client: DynamoDBClient, schema: TableSchema): Promise<void>;
+/**
+ * Delete the saga instances table.
+ */
+declare function deleteTable(client: DynamoDBClient, tableName: string): Promise<void>;
+
+export { DynamoDBSagaStore, type DynamoDBSagaStoreOptions, type SagaInstanceItem, type TableSchema, createTable, deleteTable, getTableSchema };

package/dist/index.d.ts

@@ -0,0 +1,121 @@
+import { SagaState, SagaStore } from '@saga-bus/core';
+import { DynamoDBDocumentClient } from '@aws-sdk/lib-dynamodb';
+import { DynamoDBClient } from '@aws-sdk/client-dynamodb';
+
+/**
+ * DynamoDB saga store configuration options.
+ */
+interface DynamoDBSagaStoreOptions {
+    /**
+     * DynamoDB Document Client instance.
+     */
+    client: DynamoDBDocumentClient;
+    /**
+     * Table name for saga instances.
+     */
+    tableName: string;
+    /**
+     * Name of the correlation ID GSI.
+     * @default "GSI1"
+     */
+    correlationIndexName?: string;
+    /**
+     * Name of the cleanup GSI (for querying completed sagas by date).
+     * @default "GSI2"
+     */
+    cleanupIndexName?: string;
+}
+/**
+ * Shape of a saga instance item in DynamoDB.
+ */
+interface SagaInstanceItem {
+    PK: string;
+    SK: string;
+    sagaName: string;
+    sagaId: string;
+    correlationId: string;
+    version: number;
+    isCompleted: boolean;
+    state: Record<string, unknown>;
+    createdAt: string;
+    updatedAt: string;
+    GSI1PK: string;
+    GSI1SK: string;
+    GSI2PK?: string;
+    GSI2SK?: string;
+}
+/**
+ * Table schema definition for creating the table.
+ */
+interface TableSchema {
+    tableName: string;
+    correlationIndexName: string;
+    cleanupIndexName: string;
+}
+
+/**
+ * DynamoDB-backed saga store.
+ *
+ * @example
+ * ```typescript
+ * import { DynamoDBClient } from "@aws-sdk/client-dynamodb";
+ * import { DynamoDBDocumentClient } from "@aws-sdk/lib-dynamodb";
+ *
+ * const client = DynamoDBDocumentClient.from(new DynamoDBClient({}));
+ * const store = new DynamoDBSagaStore<OrderState>({
+ *   client,
+ *   tableName: "saga_instances",
+ * });
+ * ```
+ */
+declare class DynamoDBSagaStore<TState extends SagaState> implements SagaStore<TState> {
+    private readonly client;
+    private readonly tableName;
+    private readonly correlationIndexName;
+    private readonly cleanupIndexName;
+    constructor(options: DynamoDBSagaStoreOptions);
+    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>;
+    private itemToState;
+    /**
+     * Serialize state for DynamoDB storage by converting Date objects to ISO strings.
+     */
+    private serializeState;
+    /**
+     * Find sagas by name with pagination.
+     */
+    findByName(sagaName: string, options?: {
+        limit?: number;
+        startKey?: Record<string, unknown>;
+        completed?: boolean;
+    }): Promise<{
+        items: TState[];
+        lastKey?: Record<string, unknown>;
+    }>;
+    /**
+     * Delete completed sagas older than a given date.
+     * Note: This performs a query + batch delete which may require pagination.
+     */
+    deleteCompletedBefore(sagaName: string, before: Date): Promise<number>;
+}
+
+/**
+ * Get the table schema definition.
+ */
+declare function getTableSchema(tableName: string, options?: {
+    correlationIndexName?: string;
+    cleanupIndexName?: string;
+}): TableSchema;
+/**
+ * Create the saga instances table with required indexes.
+ */
+declare function createTable(client: DynamoDBClient, schema: TableSchema): Promise<void>;
+/**
+ * Delete the saga instances table.
+ */
+declare function deleteTable(client: DynamoDBClient, tableName: string): Promise<void>;
+
+export { DynamoDBSagaStore, type DynamoDBSagaStoreOptions, type SagaInstanceItem, type TableSchema, createTable, deleteTable, getTableSchema };

package/dist/index.js

@@ -0,0 +1,313 @@
+// src/DynamoDBSagaStore.ts
+import {
+  GetCommand,
+  PutCommand,
+  UpdateCommand,
+  DeleteCommand,
+  QueryCommand
+} from "@aws-sdk/lib-dynamodb";
+import { ConcurrencyError } from "@saga-bus/core";
+var DynamoDBSagaStore = class {
+  client;
+  tableName;
+  correlationIndexName;
+  cleanupIndexName;
+  constructor(options) {
+    this.client = options.client;
+    this.tableName = options.tableName;
+    this.correlationIndexName = options.correlationIndexName ?? "GSI1";
+    this.cleanupIndexName = options.cleanupIndexName ?? "GSI2";
+  }
+  async getById(sagaName, sagaId) {
+    const result = await this.client.send(
+      new GetCommand({
+        TableName: this.tableName,
+        Key: {
+          PK: sagaName,
+          SK: sagaId
+        }
+      })
+    );
+    if (!result.Item) {
+      return null;
+    }
+    return this.itemToState(result.Item);
+  }
+  async getByCorrelationId(sagaName, correlationId) {
+    const result = await this.client.send(
+      new QueryCommand({
+        TableName: this.tableName,
+        IndexName: this.correlationIndexName,
+        KeyConditionExpression: "GSI1PK = :pk AND GSI1SK = :sk",
+        ExpressionAttributeValues: {
+          ":pk": sagaName,
+          ":sk": correlationId
+        },
+        Limit: 1
+      })
+    );
+    if (!result.Items || result.Items.length === 0) {
+      return null;
+    }
+    return this.itemToState(result.Items[0]);
+  }
+  async insert(sagaName, correlationId, state) {
+    const { sagaId, version, isCompleted, createdAt, updatedAt } = state.metadata;
+    const serializedState = this.serializeState(state);
+    const item = {
+      PK: sagaName,
+      SK: sagaId,
+      sagaName,
+      sagaId,
+      correlationId,
+      version,
+      isCompleted,
+      state: serializedState,
+      createdAt: createdAt.toISOString(),
+      updatedAt: updatedAt.toISOString(),
+      GSI1PK: sagaName,
+      GSI1SK: correlationId
+    };
+    if (isCompleted) {
+      item.GSI2PK = sagaName;
+      item.GSI2SK = updatedAt.toISOString();
+    }
+    await this.client.send(
+      new PutCommand({
+        TableName: this.tableName,
+        Item: item,
+        ConditionExpression: "attribute_not_exists(PK)"
+      })
+    );
+  }
+  async update(sagaName, state, expectedVersion) {
+    const { sagaId, version, isCompleted, updatedAt } = state.metadata;
+    try {
+      const updateExpression = isCompleted ? "SET version = :version, isCompleted = :isCompleted, #state = :state, updatedAt = :updatedAt, GSI2PK = :gsi2pk, GSI2SK = :gsi2sk" : "SET version = :version, isCompleted = :isCompleted, #state = :state, updatedAt = :updatedAt REMOVE GSI2PK, GSI2SK";
+      const serializedState = this.serializeState(state);
+      const expressionValues = {
+        ":version": version,
+        ":isCompleted": isCompleted,
+        ":state": serializedState,
+        ":updatedAt": updatedAt.toISOString(),
+        ":expectedVersion": expectedVersion
+      };
+      if (isCompleted) {
+        expressionValues[":gsi2pk"] = sagaName;
+        expressionValues[":gsi2sk"] = updatedAt.toISOString();
+      }
+      await this.client.send(
+        new UpdateCommand({
+          TableName: this.tableName,
+          Key: {
+            PK: sagaName,
+            SK: sagaId
+          },
+          UpdateExpression: updateExpression,
+          ConditionExpression: "version = :expectedVersion",
+          ExpressionAttributeNames: {
+            "#state": "state"
+          },
+          ExpressionAttributeValues: expressionValues
+        })
+      );
+    } catch (error) {
+      if (error instanceof Error && error.name === "ConditionalCheckFailedException") {
+        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`);
+        }
+      }
+      throw error;
+    }
+  }
+  async delete(sagaName, sagaId) {
+    await this.client.send(
+      new DeleteCommand({
+        TableName: this.tableName,
+        Key: {
+          PK: sagaName,
+          SK: sagaId
+        }
+      })
+    );
+  }
+  itemToState(item) {
+    const state = item.state;
+    return {
+      ...state,
+      metadata: {
+        ...state.metadata,
+        sagaId: item.sagaId,
+        version: item.version,
+        isCompleted: item.isCompleted,
+        createdAt: new Date(item.createdAt),
+        updatedAt: new Date(item.updatedAt)
+      }
+    };
+  }
+  /**
+   * Serialize state for DynamoDB storage by converting Date objects to ISO strings.
+   */
+  serializeState(state) {
+    return JSON.parse(JSON.stringify(state, (_, value) => {
+      if (value instanceof Date) {
+        return value.toISOString();
+      }
+      return value;
+    }));
+  }
+  // ============ Query Helpers ============
+  /**
+   * Find sagas by name with pagination.
+   */
+  async findByName(sagaName, options) {
+    let filterExpression;
+    const expressionValues = { ":pk": sagaName };
+    if (options?.completed !== void 0) {
+      filterExpression = "isCompleted = :isCompleted";
+      expressionValues[":isCompleted"] = options.completed;
+    }
+    const result = await this.client.send(
+      new QueryCommand({
+        TableName: this.tableName,
+        KeyConditionExpression: "PK = :pk",
+        FilterExpression: filterExpression,
+        ExpressionAttributeValues: expressionValues,
+        Limit: options?.limit ?? 100,
+        ExclusiveStartKey: options?.startKey,
+        ScanIndexForward: false
+      })
+    );
+    const items = (result.Items ?? []).map(
+      (item) => this.itemToState(item)
+    );
+    return {
+      items,
+      lastKey: result.LastEvaluatedKey
+    };
+  }
+  /**
+   * Delete completed sagas older than a given date.
+   * Note: This performs a query + batch delete which may require pagination.
+   */
+  async deleteCompletedBefore(sagaName, before) {
+    let deletedCount = 0;
+    let lastKey;
+    do {
+      const result = await this.client.send(
+        new QueryCommand({
+          TableName: this.tableName,
+          IndexName: this.cleanupIndexName,
+          KeyConditionExpression: "GSI2PK = :pk AND GSI2SK < :before",
+          ExpressionAttributeValues: {
+            ":pk": sagaName,
+            ":before": before.toISOString()
+          },
+          Limit: 25,
+          ExclusiveStartKey: lastKey
+        })
+      );
+      if (result.Items && result.Items.length > 0) {
+        for (const item of result.Items) {
+          await this.delete(sagaName, item.SK);
+          deletedCount++;
+        }
+      }
+      lastKey = result.LastEvaluatedKey;
+    } while (lastKey);
+    return deletedCount;
+  }
+};
+
+// src/schema.ts
+import {
+  CreateTableCommand,
+  DeleteTableCommand,
+  DescribeTableCommand
+} from "@aws-sdk/client-dynamodb";
+function getTableSchema(tableName, options) {
+  return {
+    tableName,
+    correlationIndexName: options?.correlationIndexName ?? "GSI1",
+    cleanupIndexName: options?.cleanupIndexName ?? "GSI2"
+  };
+}
+async function createTable(client, schema) {
+  const command = new CreateTableCommand({
+    TableName: schema.tableName,
+    KeySchema: [
+      { AttributeName: "PK", KeyType: "HASH" },
+      { AttributeName: "SK", KeyType: "RANGE" }
+    ],
+    AttributeDefinitions: [
+      { AttributeName: "PK", AttributeType: "S" },
+      { AttributeName: "SK", AttributeType: "S" },
+      { AttributeName: "GSI1PK", AttributeType: "S" },
+      { AttributeName: "GSI1SK", AttributeType: "S" },
+      { AttributeName: "GSI2PK", AttributeType: "S" },
+      { AttributeName: "GSI2SK", AttributeType: "S" }
+    ],
+    GlobalSecondaryIndexes: [
+      {
+        IndexName: schema.correlationIndexName,
+        KeySchema: [
+          { AttributeName: "GSI1PK", KeyType: "HASH" },
+          { AttributeName: "GSI1SK", KeyType: "RANGE" }
+        ],
+        Projection: { ProjectionType: "ALL" },
+        ProvisionedThroughput: {
+          ReadCapacityUnits: 5,
+          WriteCapacityUnits: 5
+        }
+      },
+      {
+        IndexName: schema.cleanupIndexName,
+        KeySchema: [
+          { AttributeName: "GSI2PK", KeyType: "HASH" },
+          { AttributeName: "GSI2SK", KeyType: "RANGE" }
+        ],
+        Projection: { ProjectionType: "KEYS_ONLY" },
+        ProvisionedThroughput: {
+          ReadCapacityUnits: 5,
+          WriteCapacityUnits: 5
+        }
+      }
+    ],
+    BillingMode: "PROVISIONED",
+    ProvisionedThroughput: {
+      ReadCapacityUnits: 5,
+      WriteCapacityUnits: 5
+    }
+  });
+  await client.send(command);
+  await waitForTableActive(client, schema.tableName);
+}
+async function deleteTable(client, tableName) {
+  await client.send(new DeleteTableCommand({ TableName: tableName }));
+}
+async function waitForTableActive(client, tableName) {
+  for (let i = 0; i < 30; i++) {
+    const response = await client.send(
+      new DescribeTableCommand({ TableName: tableName })
+    );
+    if (response.Table?.TableStatus === "ACTIVE") {
+      return;
+    }
+    await new Promise((resolve) => setTimeout(resolve, 1e3));
+  }
+  throw new Error(`Table ${tableName} did not become active`);
+}
+export {
+  DynamoDBSagaStore,
+  createTable,
+  deleteTable,
+  getTableSchema
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/DynamoDBSagaStore.ts","../src/schema.ts"],"sourcesContent":["import {\n  GetCommand,\n  PutCommand,\n  UpdateCommand,\n  DeleteCommand,\n  QueryCommand,\n} from \"@aws-sdk/lib-dynamodb\";\nimport type { DynamoDBDocumentClient } from \"@aws-sdk/lib-dynamodb\";\nimport type { SagaStore, SagaState } from \"@saga-bus/core\";\nimport { ConcurrencyError } from \"@saga-bus/core\";\nimport type { DynamoDBSagaStoreOptions, SagaInstanceItem } from \"./types.js\";\n\n/**\n * DynamoDB-backed saga store.\n *\n * @example\n * ```typescript\n * import { DynamoDBClient } from \"@aws-sdk/client-dynamodb\";\n * import { DynamoDBDocumentClient } from \"@aws-sdk/lib-dynamodb\";\n *\n * const client = DynamoDBDocumentClient.from(new DynamoDBClient({}));\n * const store = new DynamoDBSagaStore<OrderState>({\n *   client,\n *   tableName: \"saga_instances\",\n * });\n * ```\n */\nexport class DynamoDBSagaStore<TState extends SagaState>\n  implements SagaStore<TState>\n{\n  private readonly client: DynamoDBDocumentClient;\n  private readonly tableName: string;\n  private readonly correlationIndexName: string;\n  private readonly cleanupIndexName: string;\n\n  constructor(options: DynamoDBSagaStoreOptions) {\n    this.client = options.client;\n    this.tableName = options.tableName;\n    this.correlationIndexName = options.correlationIndexName ?? \"GSI1\";\n    this.cleanupIndexName = options.cleanupIndexName ?? \"GSI2\";\n  }\n\n  async getById(sagaName: string, sagaId: string): Promise<TState | null> {\n    const result = await this.client.send(\n      new GetCommand({\n        TableName: this.tableName,\n        Key: {\n          PK: sagaName,\n          SK: sagaId,\n        },\n      })\n    );\n\n    if (!result.Item) {\n      return null;\n    }\n\n    return this.itemToState(result.Item as SagaInstanceItem);\n  }\n\n  async getByCorrelationId(\n    sagaName: string,\n    correlationId: string\n  ): Promise<TState | null> {\n    const result = await this.client.send(\n      new QueryCommand({\n        TableName: this.tableName,\n        IndexName: this.correlationIndexName,\n        KeyConditionExpression: \"GSI1PK = :pk AND GSI1SK = :sk\",\n        ExpressionAttributeValues: {\n          \":pk\": sagaName,\n          \":sk\": correlationId,\n        },\n        Limit: 1,\n      })\n    );\n\n    if (!result.Items || result.Items.length === 0) {\n      return null;\n    }\n\n    return this.itemToState(result.Items[0] as SagaInstanceItem);\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    // Serialize state with dates converted to ISO strings for DynamoDB compatibility\n    const serializedState = this.serializeState(state);\n\n    const item: SagaInstanceItem = {\n      PK: sagaName,\n      SK: sagaId,\n      sagaName,\n      sagaId,\n      correlationId,\n      version,\n      isCompleted,\n      state: serializedState,\n      createdAt: createdAt.toISOString(),\n      updatedAt: updatedAt.toISOString(),\n      GSI1PK: sagaName,\n      GSI1SK: correlationId,\n    };\n\n    // Only add GSI2 keys for completed sagas (for cleanup queries)\n    if (isCompleted) {\n      item.GSI2PK = sagaName;\n      item.GSI2SK = updatedAt.toISOString();\n    }\n\n    await this.client.send(\n      new PutCommand({\n        TableName: this.tableName,\n        Item: item,\n        ConditionExpression: \"attribute_not_exists(PK)\",\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    try {\n      const updateExpression = isCompleted\n        ? \"SET version = :version, isCompleted = :isCompleted, #state = :state, updatedAt = :updatedAt, GSI2PK = :gsi2pk, GSI2SK = :gsi2sk\"\n        : \"SET version = :version, isCompleted = :isCompleted, #state = :state, updatedAt = :updatedAt REMOVE GSI2PK, GSI2SK\";\n\n      // Serialize state with dates converted to ISO strings for DynamoDB compatibility\n      const serializedState = this.serializeState(state);\n\n      const expressionValues: Record<string, unknown> = {\n        \":version\": version,\n        \":isCompleted\": isCompleted,\n        \":state\": serializedState,\n        \":updatedAt\": updatedAt.toISOString(),\n        \":expectedVersion\": expectedVersion,\n      };\n\n      if (isCompleted) {\n        expressionValues[\":gsi2pk\"] = sagaName;\n        expressionValues[\":gsi2sk\"] = updatedAt.toISOString();\n      }\n\n      await this.client.send(\n        new UpdateCommand({\n          TableName: this.tableName,\n          Key: {\n            PK: sagaName,\n            SK: sagaId,\n          },\n          UpdateExpression: updateExpression,\n          ConditionExpression: \"version = :expectedVersion\",\n          ExpressionAttributeNames: {\n            \"#state\": \"state\",\n          },\n          ExpressionAttributeValues: expressionValues,\n        })\n      );\n    } catch (error) {\n      if (\n        error instanceof Error &&\n        error.name === \"ConditionalCheckFailedException\"\n      ) {\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      throw error;\n    }\n  }\n\n  async delete(sagaName: string, sagaId: string): Promise<void> {\n    await this.client.send(\n      new DeleteCommand({\n        TableName: this.tableName,\n        Key: {\n          PK: sagaName,\n          SK: sagaId,\n        },\n      })\n    );\n  }\n\n  private itemToState(item: SagaInstanceItem): TState {\n    const state = item.state as TState;\n\n    return {\n      ...state,\n      metadata: {\n        ...state.metadata,\n        sagaId: item.sagaId,\n        version: item.version,\n        isCompleted: item.isCompleted,\n        createdAt: new Date(item.createdAt),\n        updatedAt: new Date(item.updatedAt),\n      },\n    };\n  }\n\n  /**\n   * Serialize state for DynamoDB storage by converting Date objects to ISO strings.\n   */\n  private serializeState(state: TState): Record<string, unknown> {\n    return JSON.parse(JSON.stringify(state, (_, value) => {\n      if (value instanceof Date) {\n        return value.toISOString();\n      }\n      return value;\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      startKey?: Record<string, unknown>;\n      completed?: boolean;\n    }\n  ): Promise<{ items: TState[]; lastKey?: Record<string, unknown> }> {\n    let filterExpression: string | undefined;\n    const expressionValues: Record<string, unknown> = { \":pk\": sagaName };\n\n    if (options?.completed !== undefined) {\n      filterExpression = \"isCompleted = :isCompleted\";\n      expressionValues[\":isCompleted\"] = options.completed;\n    }\n\n    const result = await this.client.send(\n      new QueryCommand({\n        TableName: this.tableName,\n        KeyConditionExpression: \"PK = :pk\",\n        FilterExpression: filterExpression,\n        ExpressionAttributeValues: expressionValues,\n        Limit: options?.limit ?? 100,\n        ExclusiveStartKey: options?.startKey,\n        ScanIndexForward: false,\n      })\n    );\n\n    const items = (result.Items ?? []).map((item) =>\n      this.itemToState(item as SagaInstanceItem)\n    );\n\n    return {\n      items,\n      lastKey: result.LastEvaluatedKey,\n    };\n  }\n\n  /**\n   * Delete completed sagas older than a given date.\n   * Note: This performs a query + batch delete which may require pagination.\n   */\n  async deleteCompletedBefore(\n    sagaName: string,\n    before: Date\n  ): Promise<number> {\n    let deletedCount = 0;\n    let lastKey: Record<string, unknown> | undefined;\n\n    do {\n      const result = await this.client.send(\n        new QueryCommand({\n          TableName: this.tableName,\n          IndexName: this.cleanupIndexName,\n          KeyConditionExpression: \"GSI2PK = :pk AND GSI2SK < :before\",\n          ExpressionAttributeValues: {\n            \":pk\": sagaName,\n            \":before\": before.toISOString(),\n          },\n          Limit: 25,\n          ExclusiveStartKey: lastKey,\n        })\n      );\n\n      if (result.Items && result.Items.length > 0) {\n        for (const item of result.Items) {\n          await this.delete(sagaName, item.SK as string);\n          deletedCount++;\n        }\n      }\n\n      lastKey = result.LastEvaluatedKey;\n    } while (lastKey);\n\n    return deletedCount;\n  }\n}\n","import {\n  CreateTableCommand,\n  DeleteTableCommand,\n  DescribeTableCommand,\n  type DynamoDBClient,\n} from \"@aws-sdk/client-dynamodb\";\nimport type { TableSchema } from \"./types.js\";\n\n/**\n * Get the table schema definition.\n */\nexport function getTableSchema(\n  tableName: string,\n  options?: {\n    correlationIndexName?: string;\n    cleanupIndexName?: string;\n  }\n): TableSchema {\n  return {\n    tableName,\n    correlationIndexName: options?.correlationIndexName ?? \"GSI1\",\n    cleanupIndexName: options?.cleanupIndexName ?? \"GSI2\",\n  };\n}\n\n/**\n * Create the saga instances table with required indexes.\n */\nexport async function createTable(\n  client: DynamoDBClient,\n  schema: TableSchema\n): Promise<void> {\n  const command = new CreateTableCommand({\n    TableName: schema.tableName,\n    KeySchema: [\n      { AttributeName: \"PK\", KeyType: \"HASH\" },\n      { AttributeName: \"SK\", KeyType: \"RANGE\" },\n    ],\n    AttributeDefinitions: [\n      { AttributeName: \"PK\", AttributeType: \"S\" },\n      { AttributeName: \"SK\", AttributeType: \"S\" },\n      { AttributeName: \"GSI1PK\", AttributeType: \"S\" },\n      { AttributeName: \"GSI1SK\", AttributeType: \"S\" },\n      { AttributeName: \"GSI2PK\", AttributeType: \"S\" },\n      { AttributeName: \"GSI2SK\", AttributeType: \"S\" },\n    ],\n    GlobalSecondaryIndexes: [\n      {\n        IndexName: schema.correlationIndexName,\n        KeySchema: [\n          { AttributeName: \"GSI1PK\", KeyType: \"HASH\" },\n          { AttributeName: \"GSI1SK\", KeyType: \"RANGE\" },\n        ],\n        Projection: { ProjectionType: \"ALL\" },\n        ProvisionedThroughput: {\n          ReadCapacityUnits: 5,\n          WriteCapacityUnits: 5,\n        },\n      },\n      {\n        IndexName: schema.cleanupIndexName,\n        KeySchema: [\n          { AttributeName: \"GSI2PK\", KeyType: \"HASH\" },\n          { AttributeName: \"GSI2SK\", KeyType: \"RANGE\" },\n        ],\n        Projection: { ProjectionType: \"KEYS_ONLY\" },\n        ProvisionedThroughput: {\n          ReadCapacityUnits: 5,\n          WriteCapacityUnits: 5,\n        },\n      },\n    ],\n    BillingMode: \"PROVISIONED\",\n    ProvisionedThroughput: {\n      ReadCapacityUnits: 5,\n      WriteCapacityUnits: 5,\n    },\n  });\n\n  await client.send(command);\n\n  // Wait for table to be active\n  await waitForTableActive(client, schema.tableName);\n}\n\n/**\n * Delete the saga instances table.\n */\nexport async function deleteTable(\n  client: DynamoDBClient,\n  tableName: string\n): Promise<void> {\n  await client.send(new DeleteTableCommand({ TableName: tableName }));\n}\n\n/**\n * Wait for table to be active.\n */\nasync function waitForTableActive(\n  client: DynamoDBClient,\n  tableName: string\n): Promise<void> {\n  for (let i = 0; i < 30; i++) {\n    const response = await client.send(\n      new DescribeTableCommand({ TableName: tableName })\n    );\n\n    if (response.Table?.TableStatus === \"ACTIVE\") {\n      return;\n    }\n\n    await new Promise((resolve) => setTimeout(resolve, 1000));\n  }\n\n  throw new Error(`Table ${tableName} did not become active`);\n}\n"],"mappings":";AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGP,SAAS,wBAAwB;AAkB1B,IAAM,oBAAN,MAEP;AAAA,EACmB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEjB,YAAY,SAAmC;AAC7C,SAAK,SAAS,QAAQ;AACtB,SAAK,YAAY,QAAQ;AACzB,SAAK,uBAAuB,QAAQ,wBAAwB;AAC5D,SAAK,mBAAmB,QAAQ,oBAAoB;AAAA,EACtD;AAAA,EAEA,MAAM,QAAQ,UAAkB,QAAwC;AACtE,UAAM,SAAS,MAAM,KAAK,OAAO;AAAA,MAC/B,IAAI,WAAW;AAAA,QACb,WAAW,KAAK;AAAA,QAChB,KAAK;AAAA,UACH,IAAI;AAAA,UACJ,IAAI;AAAA,QACN;AAAA,MACF,CAAC;AAAA,IACH;AAEA,QAAI,CAAC,OAAO,MAAM;AAChB,aAAO;AAAA,IACT;AAEA,WAAO,KAAK,YAAY,OAAO,IAAwB;AAAA,EACzD;AAAA,EAEA,MAAM,mBACJ,UACA,eACwB;AACxB,UAAM,SAAS,MAAM,KAAK,OAAO;AAAA,MAC/B,IAAI,aAAa;AAAA,QACf,WAAW,KAAK;AAAA,QAChB,WAAW,KAAK;AAAA,QAChB,wBAAwB;AAAA,QACxB,2BAA2B;AAAA,UACzB,OAAO;AAAA,UACP,OAAO;AAAA,QACT;AAAA,QACA,OAAO;AAAA,MACT,CAAC;AAAA,IACH;AAEA,QAAI,CAAC,OAAO,SAAS,OAAO,MAAM,WAAW,GAAG;AAC9C,aAAO;AAAA,IACT;AAEA,WAAO,KAAK,YAAY,OAAO,MAAM,CAAC,CAAqB;AAAA,EAC7D;AAAA,EAEA,MAAM,OAAO,UAAkB,eAAuB,OAA8B;AAClF,UAAM,EAAE,QAAQ,SAAS,aAAa,WAAW,UAAU,IACzD,MAAM;AAGR,UAAM,kBAAkB,KAAK,eAAe,KAAK;AAEjD,UAAM,OAAyB;AAAA,MAC7B,IAAI;AAAA,MACJ,IAAI;AAAA,MACJ;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,OAAO;AAAA,MACP,WAAW,UAAU,YAAY;AAAA,MACjC,WAAW,UAAU,YAAY;AAAA,MACjC,QAAQ;AAAA,MACR,QAAQ;AAAA,IACV;AAGA,QAAI,aAAa;AACf,WAAK,SAAS;AACd,WAAK,SAAS,UAAU,YAAY;AAAA,IACtC;AAEA,UAAM,KAAK,OAAO;AAAA,MAChB,IAAI,WAAW;AAAA,QACb,WAAW,KAAK;AAAA,QAChB,MAAM;AAAA,QACN,qBAAqB;AAAA,MACvB,CAAC;AAAA,IACH;AAAA,EACF;AAAA,EAEA,MAAM,OACJ,UACA,OACA,iBACe;AACf,UAAM,EAAE,QAAQ,SAAS,aAAa,UAAU,IAAI,MAAM;AAE1D,QAAI;AACF,YAAM,mBAAmB,cACrB,oIACA;AAGJ,YAAM,kBAAkB,KAAK,eAAe,KAAK;AAEjD,YAAM,mBAA4C;AAAA,QAChD,YAAY;AAAA,QACZ,gBAAgB;AAAA,QAChB,UAAU;AAAA,QACV,cAAc,UAAU,YAAY;AAAA,QACpC,oBAAoB;AAAA,MACtB;AAEA,UAAI,aAAa;AACf,yBAAiB,SAAS,IAAI;AAC9B,yBAAiB,SAAS,IAAI,UAAU,YAAY;AAAA,MACtD;AAEA,YAAM,KAAK,OAAO;AAAA,QAChB,IAAI,cAAc;AAAA,UAChB,WAAW,KAAK;AAAA,UAChB,KAAK;AAAA,YACH,IAAI;AAAA,YACJ,IAAI;AAAA,UACN;AAAA,UACA,kBAAkB;AAAA,UAClB,qBAAqB;AAAA,UACrB,0BAA0B;AAAA,YACxB,UAAU;AAAA,UACZ;AAAA,UACA,2BAA2B;AAAA,QAC7B,CAAC;AAAA,MACH;AAAA,IACF,SAAS,OAAO;AACd,UACE,iBAAiB,SACjB,MAAM,SAAS,mCACf;AACA,cAAM,WAAW,MAAM,KAAK,QAAQ,UAAU,MAAM;AACpD,YAAI,UAAU;AACZ,gBAAM,IAAI;AAAA,YACR;AAAA,YACA;AAAA,YACA,SAAS,SAAS;AAAA,UACpB;AAAA,QACF,OAAO;AACL,gBAAM,IAAI,MAAM,QAAQ,MAAM,YAAY;AAAA,QAC5C;AAAA,MACF;AACA,YAAM;AAAA,IACR;AAAA,EACF;AAAA,EAEA,MAAM,OAAO,UAAkB,QAA+B;AAC5D,UAAM,KAAK,OAAO;AAAA,MAChB,IAAI,cAAc;AAAA,QAChB,WAAW,KAAK;AAAA,QAChB,KAAK;AAAA,UACH,IAAI;AAAA,UACJ,IAAI;AAAA,QACN;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF;AAAA,EAEQ,YAAY,MAAgC;AAClD,UAAM,QAAQ,KAAK;AAEnB,WAAO;AAAA,MACL,GAAG;AAAA,MACH,UAAU;AAAA,QACR,GAAG,MAAM;AAAA,QACT,QAAQ,KAAK;AAAA,QACb,SAAS,KAAK;AAAA,QACd,aAAa,KAAK;AAAA,QAClB,WAAW,IAAI,KAAK,KAAK,SAAS;AAAA,QAClC,WAAW,IAAI,KAAK,KAAK,SAAS;AAAA,MACpC;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKQ,eAAe,OAAwC;AAC7D,WAAO,KAAK,MAAM,KAAK,UAAU,OAAO,CAAC,GAAG,UAAU;AACpD,UAAI,iBAAiB,MAAM;AACzB,eAAO,MAAM,YAAY;AAAA,MAC3B;AACA,aAAO;AAAA,IACT,CAAC,CAAC;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,WACJ,UACA,SAKiE;AACjE,QAAI;AACJ,UAAM,mBAA4C,EAAE,OAAO,SAAS;AAEpE,QAAI,SAAS,cAAc,QAAW;AACpC,yBAAmB;AACnB,uBAAiB,cAAc,IAAI,QAAQ;AAAA,IAC7C;AAEA,UAAM,SAAS,MAAM,KAAK,OAAO;AAAA,MAC/B,IAAI,aAAa;AAAA,QACf,WAAW,KAAK;AAAA,QAChB,wBAAwB;AAAA,QACxB,kBAAkB;AAAA,QAClB,2BAA2B;AAAA,QAC3B,OAAO,SAAS,SAAS;AAAA,QACzB,mBAAmB,SAAS;AAAA,QAC5B,kBAAkB;AAAA,MACpB,CAAC;AAAA,IACH;AAEA,UAAM,SAAS,OAAO,SAAS,CAAC,GAAG;AAAA,MAAI,CAAC,SACtC,KAAK,YAAY,IAAwB;AAAA,IAC3C;AAEA,WAAO;AAAA,MACL;AAAA,MACA,SAAS,OAAO;AAAA,IAClB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,sBACJ,UACA,QACiB;AACjB,QAAI,eAAe;AACnB,QAAI;AAEJ,OAAG;AACD,YAAM,SAAS,MAAM,KAAK,OAAO;AAAA,QAC/B,IAAI,aAAa;AAAA,UACf,WAAW,KAAK;AAAA,UAChB,WAAW,KAAK;AAAA,UAChB,wBAAwB;AAAA,UACxB,2BAA2B;AAAA,YACzB,OAAO;AAAA,YACP,WAAW,OAAO,YAAY;AAAA,UAChC;AAAA,UACA,OAAO;AAAA,UACP,mBAAmB;AAAA,QACrB,CAAC;AAAA,MACH;AAEA,UAAI,OAAO,SAAS,OAAO,MAAM,SAAS,GAAG;AAC3C,mBAAW,QAAQ,OAAO,OAAO;AAC/B,gBAAM,KAAK,OAAO,UAAU,KAAK,EAAY;AAC7C;AAAA,QACF;AAAA,MACF;AAEA,gBAAU,OAAO;AAAA,IACnB,SAAS;AAET,WAAO;AAAA,EACT;AACF;;;ACjTA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AAMA,SAAS,eACd,WACA,SAIa;AACb,SAAO;AAAA,IACL;AAAA,IACA,sBAAsB,SAAS,wBAAwB;AAAA,IACvD,kBAAkB,SAAS,oBAAoB;AAAA,EACjD;AACF;AAKA,eAAsB,YACpB,QACA,QACe;AACf,QAAM,UAAU,IAAI,mBAAmB;AAAA,IACrC,WAAW,OAAO;AAAA,IAClB,WAAW;AAAA,MACT,EAAE,eAAe,MAAM,SAAS,OAAO;AAAA,MACvC,EAAE,eAAe,MAAM,SAAS,QAAQ;AAAA,IAC1C;AAAA,IACA,sBAAsB;AAAA,MACpB,EAAE,eAAe,MAAM,eAAe,IAAI;AAAA,MAC1C,EAAE,eAAe,MAAM,eAAe,IAAI;AAAA,MAC1C,EAAE,eAAe,UAAU,eAAe,IAAI;AAAA,MAC9C,EAAE,eAAe,UAAU,eAAe,IAAI;AAAA,MAC9C,EAAE,eAAe,UAAU,eAAe,IAAI;AAAA,MAC9C,EAAE,eAAe,UAAU,eAAe,IAAI;AAAA,IAChD;AAAA,IACA,wBAAwB;AAAA,MACtB;AAAA,QACE,WAAW,OAAO;AAAA,QAClB,WAAW;AAAA,UACT,EAAE,eAAe,UAAU,SAAS,OAAO;AAAA,UAC3C,EAAE,eAAe,UAAU,SAAS,QAAQ;AAAA,QAC9C;AAAA,QACA,YAAY,EAAE,gBAAgB,MAAM;AAAA,QACpC,uBAAuB;AAAA,UACrB,mBAAmB;AAAA,UACnB,oBAAoB;AAAA,QACtB;AAAA,MACF;AAAA,MACA;AAAA,QACE,WAAW,OAAO;AAAA,QAClB,WAAW;AAAA,UACT,EAAE,eAAe,UAAU,SAAS,OAAO;AAAA,UAC3C,EAAE,eAAe,UAAU,SAAS,QAAQ;AAAA,QAC9C;AAAA,QACA,YAAY,EAAE,gBAAgB,YAAY;AAAA,QAC1C,uBAAuB;AAAA,UACrB,mBAAmB;AAAA,UACnB,oBAAoB;AAAA,QACtB;AAAA,MACF;AAAA,IACF;AAAA,IACA,aAAa;AAAA,IACb,uBAAuB;AAAA,MACrB,mBAAmB;AAAA,MACnB,oBAAoB;AAAA,IACtB;AAAA,EACF,CAAC;AAED,QAAM,OAAO,KAAK,OAAO;AAGzB,QAAM,mBAAmB,QAAQ,OAAO,SAAS;AACnD;AAKA,eAAsB,YACpB,QACA,WACe;AACf,QAAM,OAAO,KAAK,IAAI,mBAAmB,EAAE,WAAW,UAAU,CAAC,CAAC;AACpE;AAKA,eAAe,mBACb,QACA,WACe;AACf,WAAS,IAAI,GAAG,IAAI,IAAI,KAAK;AAC3B,UAAM,WAAW,MAAM,OAAO;AAAA,MAC5B,IAAI,qBAAqB,EAAE,WAAW,UAAU,CAAC;AAAA,IACnD;AAEA,QAAI,SAAS,OAAO,gBAAgB,UAAU;AAC5C;AAAA,IACF;AAEA,UAAM,IAAI,QAAQ,CAAC,YAAY,WAAW,SAAS,GAAI,CAAC;AAAA,EAC1D;AAEA,QAAM,IAAI,MAAM,SAAS,SAAS,wBAAwB;AAC5D;","names":[]}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@saga-bus/store-dynamodb",
+  "version": "0.1.0",
+  "description": "DynamoDB saga store for saga-bus",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/deanforan/saga-bus.git",
+    "directory": "packages/store-dynamodb"
+  },
+  "keywords": [
+    "saga",
+    "message-bus",
+    "store",
+    "dynamodb",
+    "aws"
+  ],
+  "dependencies": {
+    "@aws-sdk/client-dynamodb": "^3.600.0",
+    "@aws-sdk/lib-dynamodb": "^3.600.0",
+    "@saga-bus/core": "0.1.0"
+  },
+  "devDependencies": {
+    "@testcontainers/localstack": "^10.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": {
+    "@aws-sdk/client-dynamodb": ">=3.0.0",
+    "@aws-sdk/lib-dynamodb": ">=3.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "eslint src/",
+    "check-types": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}