@mastra/dynamodb 1.4.4 → 1.4.5-alpha.1

package/dist/docs/SKILL.md

@@ -3,7 +3,7 @@ name: mastra-dynamodb
 description: Documentation for @mastra/dynamodb. Use when working with @mastra/dynamodb APIs, configuration, or implementation.
 metadata:
   package: "@mastra/dynamodb"
-  version: "1.4.4"
+  version: "1.4.5-alpha.1"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.4.4",
+  "version": "1.4.5-alpha.1",
   "package": "@mastra/dynamodb",
   "exports": {},
   "modules": {}

package/dist/docs/references/integrations-databases-dynamodb.md

@@ -50,7 +50,7 @@ bun add @mastra/dynamodb@latest
 
 Before using this package, you **must** create a DynamoDB table with a specific structure, including primary keys and Global Secondary Indexes (GSIs). This adapter expects the DynamoDB table and its GSIs to be provisioned externally.
 
-Detailed instructions for setting up the table using AWS CloudFormation or AWS CDK are available in [TABLE\_SETUP.md](https://github.com/mastra-ai/mastra/blob/main/stores/dynamodb/TABLE_SETUP.md). Please ensure your table is configured according to those instructions before proceeding.
+Detailed instructions for setting up the table using AWS CloudFormation or AWS CDK are available in [TABLE_SETUP.md](https://github.com/mastra-ai/mastra/blob/main/stores/dynamodb/TABLE_SETUP.md). Please ensure your table is configured according to those instructions before proceeding.
 
 ## Usage
 
@@ -122,7 +122,7 @@ For local development, you can use [DynamoDB Local](https://docs.aws.amazon.com/
 
 **config.credentials** (`object`): AWS credentials object with accessKeyId and secretAccessKey. If not provided, the AWS SDK will attempt to source credentials from environment variables, IAM roles (e.g., for EC2/Lambda), or the shared AWS credentials file.
 
-**config.ttl** (`object`): TTL (Time To Live) configuration for automatic data expiration. Configure per entity type: thread, message, trace, eval, workflow\_snapshot, resource, score. Each entity config includes: enabled (boolean), attributeName (string, default: 'ttl'), defaultTtlSeconds (number).
+**config.ttl** (`object`): TTL (Time To Live) configuration for automatic data expiration. Configure per entity type: thread, message, trace, eval, workflow_snapshot, resource, score. Each entity config includes: enabled (boolean), attributeName (string, default: 'ttl'), defaultTtlSeconds (number).
 
 ## TTL (time to live) configuration
 
@@ -254,7 +254,7 @@ The IAM role or user executing the code needs appropriate permissions to interac
 
 Before diving into the architectural details, keep these key points in mind when working with the DynamoDB storage adapter:
 
-- **External Table Provisioning:** This adapter _requires_ you to create and configure the DynamoDB table and its Global Secondary Indexes (GSIs) yourself, prior to using the adapter. Follow the guide in [TABLE\_SETUP.md](https://github.com/mastra-ai/mastra/blob/main/stores/dynamodb/TABLE_SETUP.md).
+- **External Table Provisioning:** This adapter _requires_ you to create and configure the DynamoDB table and its Global Secondary Indexes (GSIs) yourself, prior to using the adapter. Follow the guide in [TABLE_SETUP.md](https://github.com/mastra-ai/mastra/blob/main/stores/dynamodb/TABLE_SETUP.md).
 - **Single-Table Design:** All Mastra data (threads, messages, etc.) is stored in one DynamoDB table. This is a deliberate design choice optimized for DynamoDB, differing from relational database approaches.
 - **Understanding GSIs:** Familiarity with how the GSIs are structured (as per `TABLE_SETUP.md`) is important for understanding data retrieval and potential query patterns.
 - **ElectroDB:** The adapter uses ElectroDB to manage interactions with DynamoDB, providing a layer of abstraction and type safety over raw DynamoDB operations.
@@ -266,7 +266,7 @@ This storage adapter utilizes a **single-table design pattern** with [ElectroDB]
 Key aspects of this approach:
 
 - **DynamoDB Native:** The single-table design is optimized for DynamoDB's key-value and query capabilities, often leading to better performance and capacity compared to mimicking relational models.
-- **External Table Management:** Unlike some adapters that might offer helper functions to create tables via code, this adapter **expects the DynamoDB table and its associated Global Secondary Indexes (GSIs) to be provisioned externally** before use. Please refer to [TABLE\_SETUP.md](https://github.com/mastra-ai/mastra/blob/main/stores/dynamodb/TABLE_SETUP.md) for detailed instructions using tools like AWS CloudFormation or CDK. The adapter focuses solely on interacting with the pre-existing table structure.
+- **External Table Management:** Unlike some adapters that might offer helper functions to create tables via code, this adapter **expects the DynamoDB table and its associated Global Secondary Indexes (GSIs) to be provisioned externally** before use. Please refer to [TABLE_SETUP.md](https://github.com/mastra-ai/mastra/blob/main/stores/dynamodb/TABLE_SETUP.md) for detailed instructions using tools like AWS CloudFormation or CDK. The adapter focuses solely on interacting with the pre-existing table structure.
 - **Consistency via Interface:** While the underlying storage model differs, this adapter adheres to the same `MastraStorage` interface as other adapters, ensuring it can be used interchangeably within the Mastra `Memory` component.
 
 ### Mastra Data in the Single Table

package/dist/index.cjs

@@ -6,7 +6,7 @@ let _mastra_core_storage = require("@mastra/core/storage");
 let electrodb = require("electrodb");
 let _mastra_core_agent = require("@mastra/core/agent");
 let _mastra_core_evals = require("@mastra/core/evals");
-//#region src/entities/utils.ts
+// src/entities/utils.ts
 const baseAttributes = {
 	createdAt: {
 		type: "string",
@@ -62,8 +62,7 @@ const baseAttributes = {
 		required: false
 	}
 };
-//#endregion
-//#region src/entities/background-task.ts
+// src/entities/background-task.ts
 /**
 * JSON field helpers — DynamoDB stores JSON as stringified strings,
 * and parses them on get.
@@ -226,8 +225,7 @@ const backgroundTaskEntity = new electrodb.Entity({
 		}
 	}
 });
-//#endregion
-//#region src/entities/eval.ts
+// src/entities/eval.ts
 const evalEntity = new electrodb.Entity({
 	model: {
 		entity: "eval",
@@ -325,8 +323,7 @@ const evalEntity = new electrodb.Entity({
 		}
 	}
 });
-//#endregion
-//#region src/entities/message.ts
+// src/entities/message.ts
 const messageEntity = new electrodb.Entity({
 	model: {
 		entity: "message",
@@ -448,8 +445,7 @@ const messageEntity = new electrodb.Entity({
 		}
 	}
 });
-//#endregion
-//#region src/entities/resource.ts
+// src/entities/resource.ts
 const resourceEntity = new electrodb.Entity({
 	model: {
 		entity: "resource",
@@ -498,8 +494,7 @@ const resourceEntity = new electrodb.Entity({
 		}
 	} }
 });
-//#endregion
-//#region src/entities/run-fencing.ts
+// src/entities/run-fencing.ts
 /**
 * The current claim on a durable workflow run. `leaseExpiresAt` holds the
 * lease's expiry in epoch milliseconds and is removed when the owner releases
@@ -572,8 +567,7 @@ const memoryRunFenceEntity = new electrodb.Entity({
 		}
 	} }
 });
-//#endregion
-//#region src/entities/score.ts
+// src/entities/score.ts
 const scoreEntity = new electrodb.Entity({
 	model: {
 		entity: "score",
@@ -933,8 +927,7 @@ const scoreEntity = new electrodb.Entity({
 		}
 	}
 });
-//#endregion
-//#region src/entities/thread.ts
+// src/entities/thread.ts
 const threadEntity = new electrodb.Entity({
 	model: {
 		entity: "thread",
@@ -1000,8 +993,7 @@ const threadEntity = new electrodb.Entity({
 		}
 	}
 });
-//#endregion
-//#region src/entities/trace.ts
+// src/entities/trace.ts
 const traceEntity = new electrodb.Entity({
 	model: {
 		entity: "trace",
@@ -1130,8 +1122,7 @@ const traceEntity = new electrodb.Entity({
 		}
 	}
 });
-//#endregion
-//#region src/entities/workflow-snapshot.ts
+// src/entities/workflow-snapshot.ts
 const workflowSnapshotEntity = new electrodb.Entity({
 	model: {
 		entity: "workflow_snapshot",
@@ -1192,8 +1183,7 @@ const workflowSnapshotEntity = new electrodb.Entity({
 		}
 	}
 });
-//#endregion
-//#region src/entities/index.ts
+// src/entities/index.ts
 function getElectroDbService(client, tableName) {
 	return new electrodb.Service({
 		thread: threadEntity,
@@ -1211,8 +1201,7 @@ function getElectroDbService(client, tableName) {
 		table: tableName
 	});
 }
-//#endregion
-//#region src/storage/db/index.ts
+// src/storage/db/index.ts
 /**
 * Resolves DynamoDBDomainConfig to an ElectroDB service and TTL config.
 * Handles creating a new service if config is provided.
@@ -1232,8 +1221,7 @@ function resolveDynamoDBConfig(config) {
 		ttl: config.ttl
 	};
 }
-//#endregion
-//#region src/storage/domains/utils.ts
+// src/storage/domains/utils.ts
 /**
 * Maps table names to ElectroDB entity names
 */
@@ -1287,8 +1275,7 @@ async function deleteTableData(service, tableName) {
 		await entity.delete(keysToDelete).go();
 	}
 }
-//#endregion
-//#region src/storage/domains/background-tasks/index.ts
+// src/storage/domains/background-tasks/index.ts
 const ENTITY = "background_task";
 function serializeJson(v) {
 	if (typeof v === "object" && v != null) return JSON.stringify(v);
@@ -1563,8 +1550,7 @@ var BackgroundTasksStorageDynamoDB = class extends _mastra_core_storage.Backgrou
 		return total;
 	}
 };
-//#endregion
-//#region src/storage/ttl.ts
+// src/storage/ttl.ts
 /**
 * Calculate TTL value for a given entity type.
 *
@@ -1618,8 +1604,7 @@ function getTtlProps(entityName, ttlConfig, customTtlSeconds) {
 	if (ttlValue === void 0) return {};
 	return { [getTtlAttributeName(entityName, ttlConfig)]: ttlValue };
 }
-//#endregion
-//#region src/storage/domains/run-fencing.ts
+// src/storage/domains/run-fencing.ts
 const MAX_CONFLICT_RETRIES = 8;
 const BASE_DELAY_MS$1 = 20;
 async function backoff(attempt) {
@@ -1735,8 +1720,7 @@ async function pruneRunClaims(service, entityName, attribute, cutoff, limit) {
 	} while (cursor);
 	return deleted;
 }
-//#endregion
-//#region src/storage/domains/memory/index.ts
+// src/storage/domains/memory/index.ts
 var MemoryStorageDynamoDB = class MemoryStorageDynamoDB extends _mastra_core_storage.MemoryStorage {
 	/**
 	* Tables `prune()` can clean up. Run fences anchor on `retiredAt` (epoch ms), which stays unset until the
@@ -2583,8 +2567,7 @@ var MemoryStorageDynamoDB = class MemoryStorageDynamoDB extends _mastra_core_sto
 		}
 	}
 };
-//#endregion
-//#region src/storage/domains/scores/index.ts
+// src/storage/domains/scores/index.ts
 /** Returns true when a score matches the multi-tenant scope filters (or none provided). */
 function matchesTenancy(score, filters) {
 	if (filters?.organizationId !== void 0 && score.organizationId !== filters.organizationId) return false;
@@ -2883,8 +2866,7 @@ var ScoresStorageDynamoDB = class extends _mastra_core_storage.ScoresStorage {
 		}
 	}
 };
-//#endregion
-//#region src/storage/domains/workflows/index.ts
+// src/storage/domains/workflows/index.ts
 function formatWorkflowRun(snapshotData) {
 	return {
 		workflowName: snapshotData.workflow_name,
@@ -3094,7 +3076,7 @@ var WorkflowStorageDynamoDB = class WorkflowStorageDynamoDB extends _mastra_core
 				entity: "workflow_snapshot",
 				workflow_name: workflowName,
 				run_id: runId
-			}).go();
+			}).go({ consistent: true });
 			const now = /* @__PURE__ */ new Date();
 			let snapshot;
 			let previousUpdatedAt;
@@ -3172,7 +3154,7 @@ var WorkflowStorageDynamoDB = class WorkflowStorageDynamoDB extends _mastra_core
 				entity: "workflow_snapshot",
 				workflow_name: workflowName,
 				run_id: runId
-			}).go();
+			}).go({ consistent: true });
 			const existingSnapshot = existingRecord.data?.snapshot;
 			const { expectedStatus, ...state } = opts;
 			if (!existingSnapshot?.context || !(0, _mastra_core_storage.matchesExpectedWorkflowStatus)(existingSnapshot.status, expectedStatus)) {
@@ -3284,7 +3266,7 @@ var WorkflowStorageDynamoDB = class WorkflowStorageDynamoDB extends _mastra_core
 				entity: "workflow_snapshot",
 				workflow_name: workflowName,
 				run_id: runId
-			}).go();
+			}).go({ consistent: true });
 			if (!result.data?.snapshot) return null;
 			return result.data.snapshot;
 		} catch (error) {
@@ -3381,7 +3363,7 @@ var WorkflowStorageDynamoDB = class WorkflowStorageDynamoDB extends _mastra_core
 					entity: "workflow_snapshot",
 					workflow_name: workflowName,
 					run_id: runId
-				}).go();
+				}).go({ consistent: true });
 				if (!result.data) return null;
 				const snapshot = result.data.snapshot;
 				return {
@@ -3446,8 +3428,7 @@ var WorkflowStorageDynamoDB = class WorkflowStorageDynamoDB extends _mastra_core
 		}
 	}
 };
-//#endregion
-//#region src/storage/index.ts
+// src/storage/index.ts
 /**
 * Type guard for pre-configured client config
 */
@@ -3592,7 +3573,6 @@ var DynamoDBStore = class extends _mastra_core_storage.MastraCompositeStore {
 		}
 	}
 };
-//#endregion
 exports.BackgroundTasksStorageDynamoDB = BackgroundTasksStorageDynamoDB;
 exports.DynamoDBStore = DynamoDBStore;
 exports.MemoryStorageDynamoDB = MemoryStorageDynamoDB;