@farukada/aws-langgraph-dynamodb-ts 0.0.2

package/dist/store/index.js

@@ -0,0 +1,145 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DynamoDBStore = void 0;
+const langgraph_1 = require("@langchain/langgraph");
+const client_dynamodb_1 = require("@aws-sdk/client-dynamodb");
+const lib_dynamodb_1 = require("@aws-sdk/lib-dynamodb");
+const actions_1 = require("./actions");
+const utils_1 = require("./utils");
+/**
+ * DynamoDB-based store implementation for LangGraph
+ * Provides persistent storage for memory items with optional semantic search via embeddings
+ */
+class DynamoDBStore extends langgraph_1.BaseStore {
+    ddbClient;
+    client;
+    memoryTableName;
+    embedding;
+    ttlDays;
+    /**
+     * Create a new DynamoDB store instance
+     *
+     * @param options - Configuration options for the store
+     * @param options.memoryTableName - Name of the DynamoDB table to use
+     * @param options.embedding - Optional Bedrock embeddings for semantic search
+     * @param options.clientConfig - Optional DynamoDB client configuration
+     * @param options.ttlDays - Optional TTL in days for stored items
+     */
+    constructor(options) {
+        super();
+        this.memoryTableName = options.memoryTableName;
+        this.ddbClient = new client_dynamodb_1.DynamoDBClient(options.clientConfig || {});
+        this.client = lib_dynamodb_1.DynamoDBDocument.from(this.ddbClient);
+        this.embedding = options.embedding;
+        this.ttlDays = options.ttlDays;
+    }
+    /**
+     * Extract and validate user ID from config
+     *
+     * @param config - Runnable configuration
+     * @returns User ID string
+     * @throws Error if user_id is not provided or invalid
+     */
+    getUserId(config) {
+        const userId = config?.configurable?.user_id;
+        if (!userId || typeof userId !== 'string') {
+            throw new Error('Field user_id is required in the RunnableConfig for DynamoDBStore.');
+        }
+        return userId;
+    }
+    /**
+     * Execute a batch of operations in parallel
+     *
+     * @param operations - Array of operations to execute
+     * @param config - Runnable configuration containing user_id
+     * @returns Array of results corresponding to each operation
+     * @throws Error if user_id is not provided in config or if any operation fails
+     */
+    async batch(operations, config) {
+        const userId = this.getUserId(config);
+        // Validate batch size to prevent resource exhaustion
+        (0, utils_1.validateBatchSize)(operations.length);
+        // Execute all operations in parallel for better performance
+        const promises = operations.map(async (op, index) => {
+            if ('key' in op && !('value' in op)) {
+                return await this.getOperation(userId, op);
+            }
+            if ('key' in op && 'value' in op) {
+                return await this.putOperation(userId, op);
+            }
+            if ('namespacePrefix' in op) {
+                return await this.searchOperation(userId, op);
+            }
+            if (!('namespacePrefix' in op) && 'limit' in op && 'offset' in op) {
+                return await this.listNamespacesOperation(userId, op);
+            }
+            // Unrecognized operation - sanitized error message to prevent information disclosure
+            throw new Error(`Unrecognized operation type at index ${index}`);
+        });
+        return (await Promise.all(promises));
+    }
+    /**
+     * Get a single item from the store
+     *
+     * @param userId - User ID for the item
+     * @param op - Get operation parameters
+     * @returns The item if found, null otherwise
+     */
+    async getOperation(userId, op) {
+        return await (0, actions_1.getOperationAction)({
+            client: this.client,
+            memoryTableName: this.memoryTableName,
+            userId,
+            op,
+        });
+    }
+    /**
+     * Put an item into the store
+     *
+     * @param userId - User ID for the item
+     * @param op - Put operation parameters
+     */
+    async putOperation(userId, op) {
+        await (0, actions_1.putOperationAction)({
+            client: this.client,
+            memoryTableName: this.memoryTableName,
+            userId,
+            op,
+            embedding: this.embedding,
+            ttlDays: this.ttlDays,
+        });
+    }
+    /**
+     * Search for items in the store with optional semantic search
+     *
+     * @param userId - User ID for filtering items
+     * @param op - Search operation parameters
+     * @returns Array of matching items with optional similarity scores
+     */
+    async searchOperation(userId, op) {
+        return await (0, actions_1.searchOperationAction)({
+            client: this.client,
+            memoryTableName: this.memoryTableName,
+            userId,
+            op,
+            embedding: this.embedding,
+        });
+    }
+    /**
+     * List unique namespaces in the store
+     *
+     * @param userId - User ID for filtering namespaces
+     * @param op - List namespaces operation parameters
+     * @returns Array of namespace paths
+     */
+    async listNamespacesOperation(userId, op) {
+        return await (0, actions_1.listNamespacesOperationAction)({
+            client: this.client,
+            memoryTableName: this.memoryTableName,
+            userId,
+            op,
+        });
+    }
+}
+exports.DynamoDBStore = DynamoDBStore;
+//# sourceMappingURL=index.js.map

package/dist/store/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/store/index.ts"],"names":[],"mappings":";;;AAAA,oDAS8B;AAK9B,8DAA0D;AAC1D,wDAAyD;AACzD,uCAKmB;AACnB,mCAA4C;AAE5C;;;GAGG;AACH,MAAa,aAAc,SAAQ,qBAAS;IACzB,SAAS,CAAiB;IAC1B,MAAM,CAAmB;IACzB,eAAe,CAAS;IACxB,SAAS,CAAqB;IAC9B,OAAO,CAAU;IAElC;;;;;;;;OAQG;IACH,YAAY,OAA6B;QACvC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;QAC/C,IAAI,CAAC,SAAS,GAAG,IAAI,gCAAc,CAAC,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC;QAChE,IAAI,CAAC,MAAM,GAAG,+BAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACpD,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACnC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IACjC,CAAC;IAED;;;;;;OAMG;IACK,SAAS,CAAC,MAAuB;QACvC,MAAM,MAAM,GAAG,MAAM,EAAE,YAAY,EAAE,OAAO,CAAC;QAC7C,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC1C,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;QACxF,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,KAAK,CACT,UAAc,EACd,MAAuB;QAEvB,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAEtC,qDAAqD;QACrD,IAAA,yBAAiB,EAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAErC,4DAA4D;QAC5D,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE;YAClD,IAAI,KAAK,IAAI,EAAE,IAAI,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,CAAC;gBACpC,OAAO,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,EAAkB,CAAC,CAAC;YAC7D,CAAC;YACD,IAAI,KAAK,IAAI,EAAE,IAAI,OAAO,IAAI,EAAE,EAAE,CAAC;gBACjC,OAAO,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,EAAkB,CAAC,CAAC;YAC7D,CAAC;YACD,IAAI,iBAAiB,IAAI,EAAE,EAAE,CAAC;gBAC5B,OAAO,MAAM,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,EAAqB,CAAC,CAAC;YACnE,CAAC;YACD,IAAI,CAAC,CAAC,iBAAiB,IAAI,EAAE,CAAC,IAAI,OAAO,IAAI,EAAE,IAAI,QAAQ,IAAI,EAAE,EAAE,CAAC;gBAClE,OAAO,MAAM,IAAI,CAAC,uBAAuB,CAAC,MAAM,EAAE,EAA6B,CAAC,CAAC;YACnF,CAAC;YAED,qFAAqF;YACrF,MAAM,IAAI,KAAK,CAAC,wCAAwC,KAAK,EAAE,CAAC,CAAC;QACnE,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAyB,CAAC;IAC/D,CAAC;IAED;;;;;;OAMG;IACK,KAAK,CAAC,YAAY,CAAC,MAAc,EAAE,EAAgB;QACzD,OAAO,MAAM,IAAA,4BAAkB,EAAC;YAC9B,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,eAAe,EAAE,IAAI,CAAC,eAAe;YACrC,MAAM;YACN,EAAE;SACH,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACK,KAAK,CAAC,YAAY,CAAC,MAAc,EAAE,EAAgB;QACzD,MAAM,IAAA,4BAAkB,EAAC;YACvB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,eAAe,EAAE,IAAI,CAAC,eAAe;YACrC,MAAM;YACN,EAAE;YACF,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACK,KAAK,CAAC,eAAe,CAAC,MAAc,EAAE,EAAmB;QAC/D,OAAO,MAAM,IAAA,+BAAqB,EAAC;YACjC,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,eAAe,EAAE,IAAI,CAAC,eAAe;YACrC,MAAM;YACN,EAAE;YACF,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACK,KAAK,CAAC,uBAAuB,CACnC,MAAc,EACd,EAA2B;QAE3B,OAAO,MAAM,IAAA,uCAA6B,EAAC;YACzC,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,eAAe,EAAE,IAAI,CAAC,eAAe;YACrC,MAAM;YACN,EAAE;SACH,CAAC,CAAC;IACL,CAAC;CACF;AAnJD,sCAmJC"}

package/dist/store/types/index.d.ts

@@ -0,0 +1,97 @@
+import { BedrockEmbeddings } from '@langchain/aws';
+import { DynamoDBClientConfig } from '@aws-sdk/client-dynamodb';
+import { DynamoDBDocument } from '@aws-sdk/lib-dynamodb';
+import { GetOperation, type ListNamespacesOperation, type PutOperation, type SearchOperation } from '@langchain/langgraph';
+/**
+ * Namespace path - array of strings with optional wildcards
+ */
+export type NamespacePath = (string | '*')[];
+/**
+ * Configuration options for DynamoDBStore
+ */
+export interface DynamoDBStoreOptions {
+    /** Name of the DynamoDB table to use for storage */
+    memoryTableName: string;
+    /** Optional Bedrock embeddings for semantic search */
+    embedding?: BedrockEmbeddings;
+    /** Optional DynamoDB client configuration */
+    clientConfig?: DynamoDBClientConfig;
+    /** Optional TTL in days for stored items (1-1825 days) */
+    ttlDays?: number;
+}
+/**
+ * Parameters for put operation action
+ */
+export interface PutOperationActionParams {
+    /** DynamoDB document client */
+    client: DynamoDBDocument;
+    /** Name of the memory table */
+    memoryTableName: string;
+    /** User ID for the operation */
+    userId: string;
+    /** Put operation parameters */
+    op: PutOperation;
+    /** Optional embeddings for semantic search */
+    embedding?: BedrockEmbeddings;
+    /** Optional TTL in days */
+    ttlDays?: number;
+}
+/**
+ * Parameters for get operation action
+ */
+export interface GetOperationActionParams {
+    /** DynamoDB document client */
+    client: DynamoDBDocument;
+    /** Name of the memory table */
+    memoryTableName: string;
+    /** User ID for the operation */
+    userId: string;
+    /** Get operation parameters */
+    op: GetOperation;
+}
+/**
+ * Parameters for search operation action
+ */
+export interface SearchOperationActionParams {
+    /** DynamoDB document client */
+    client: DynamoDBDocument;
+    /** Name of the memory table */
+    memoryTableName: string;
+    /** User ID for the operation */
+    userId: string;
+    /** Search operation parameters */
+    op: SearchOperation;
+    /** Optional embeddings for semantic search */
+    embedding?: BedrockEmbeddings;
+}
+/**
+ * Parameters for list namespaces operation action
+ */
+export interface ListNamespacesOperationActionParams {
+    /** DynamoDB document client */
+    client: DynamoDBDocument;
+    /** Name of the memory table */
+    memoryTableName: string;
+    /** User ID for the operation */
+    userId: string;
+    /** List namespaces operation parameters */
+    op: ListNamespacesOperation;
+}
+/**
+ * Filter value with comparison operators
+ */
+export type FilterValue = {
+    /** Equal to */
+    $eq?: any;
+    /** Not equal to */
+    $ne?: any;
+    /** Greater than */
+    $gt?: number;
+    /** Greater than or equal to */
+    $gte?: number;
+    /** Less than */
+    $lt?: number;
+    /** Less than or equal to */
+    $lte?: number;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/store/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/store/types/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EACL,YAAY,EACZ,KAAK,uBAAuB,EAC5B,KAAK,YAAY,EACjB,KAAK,eAAe,EACrB,MAAM,sBAAsB,CAAC;AAE9B;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,EAAE,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,oDAAoD;IACpD,eAAe,EAAE,MAAM,CAAC;IACxB,sDAAsD;IACtD,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,6CAA6C;IAC7C,YAAY,CAAC,EAAE,oBAAoB,CAAC;IACpC,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,+BAA+B;IAC/B,MAAM,EAAE,gBAAgB,CAAC;IACzB,+BAA+B;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,EAAE,EAAE,YAAY,CAAC;IACjB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,2BAA2B;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,+BAA+B;IAC/B,MAAM,EAAE,gBAAgB,CAAC;IACzB,+BAA+B;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,EAAE,EAAE,YAAY,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,+BAA+B;IAC/B,MAAM,EAAE,gBAAgB,CAAC;IACzB,+BAA+B;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,EAAE,EAAE,eAAe,CAAC;IACpB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,iBAAiB,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,mCAAmC;IAClD,+BAA+B;IAC/B,MAAM,EAAE,gBAAgB,CAAC;IACzB,+BAA+B;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,EAAE,EAAE,uBAAuB,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,eAAe;IACf,GAAG,CAAC,EAAE,GAAG,CAAC;IACV,mBAAmB;IACnB,GAAG,CAAC,EAAE,GAAG,CAAC;IACV,mBAAmB;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC"}

package/dist/store/types/index.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/dist/store/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/store/types/index.ts"],"names":[],"mappings":""}

package/dist/store/utils/filter.d.ts

@@ -0,0 +1,16 @@
+/**
+ * DynamoDB filter expression builder utilities
+ */
+import { FilterValue } from '../types';
+/**
+ * Build DynamoDB filter expression from a filter object
+ *
+ * @param filter - Filter criteria object with field names and values
+ * @param expressionAttributeNames - Object to populate with attribute name mappings
+ * @param expressionAttributeValues - Object to populate with attribute value mappings
+ * @returns Object containing the constructed filter expression
+ */
+export declare function buildFilterExpression(filter: Record<string, FilterValue | any>, expressionAttributeNames: Record<string, string>, expressionAttributeValues: Record<string, any>): {
+    filterExpression: string;
+};
+//# sourceMappingURL=filter.d.ts.map

package/dist/store/utils/filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../../../src/store/utils/filter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,GAAG,CAAC,EACzC,wBAAwB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAChD,yBAAyB,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC7C;IACD,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CA+DA"}

package/dist/store/utils/filter.js

@@ -0,0 +1,71 @@
+"use strict";
+/**
+ * DynamoDB filter expression builder utilities
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildFilterExpression = buildFilterExpression;
+/**
+ * Build DynamoDB filter expression from a filter object
+ *
+ * @param filter - Filter criteria object with field names and values
+ * @param expressionAttributeNames - Object to populate with attribute name mappings
+ * @param expressionAttributeValues - Object to populate with attribute value mappings
+ * @returns Object containing the constructed filter expression
+ */
+function buildFilterExpression(filter, expressionAttributeNames, expressionAttributeValues) {
+    const filterExpressions = [];
+    let nameCounter = Object.keys(expressionAttributeNames).length;
+    let valueCounter = Object.keys(expressionAttributeValues).length;
+    // Add #value for nested access if not present
+    if (!expressionAttributeNames['#value']) {
+        expressionAttributeNames['#value'] = 'value';
+    }
+    for (const [fieldKey, fieldValue] of Object.entries(filter)) {
+        const attrName = `#attr${nameCounter++}`;
+        const valuePath = `#value.${attrName}`;
+        expressionAttributeNames[attrName] = fieldKey;
+        // Handle operator-based filtering
+        if (typeof fieldValue === 'object' && fieldValue !== null && !Array.isArray(fieldValue)) {
+            if (fieldValue.$eq !== undefined) {
+                const valueKey = `:val${valueCounter++}`;
+                expressionAttributeValues[valueKey] = fieldValue.$eq;
+                filterExpressions.push(`${valuePath} = ${valueKey}`);
+            }
+            if (fieldValue.$ne !== undefined) {
+                const valueKey = `:val${valueCounter++}`;
+                expressionAttributeValues[valueKey] = fieldValue.$ne;
+                filterExpressions.push(`${valuePath} <> ${valueKey}`);
+            }
+            if (fieldValue.$gt !== undefined) {
+                const valueKey = `:val${valueCounter++}`;
+                expressionAttributeValues[valueKey] = fieldValue.$gt;
+                filterExpressions.push(`${valuePath} > ${valueKey}`);
+            }
+            if (fieldValue.$gte !== undefined) {
+                const valueKey = `:val${valueCounter++}`;
+                expressionAttributeValues[valueKey] = fieldValue.$gte;
+                filterExpressions.push(`${valuePath} >= ${valueKey}`);
+            }
+            if (fieldValue.$lt !== undefined) {
+                const valueKey = `:val${valueCounter++}`;
+                expressionAttributeValues[valueKey] = fieldValue.$lt;
+                filterExpressions.push(`${valuePath} < ${valueKey}`);
+            }
+            if (fieldValue.$lte !== undefined) {
+                const valueKey = `:val${valueCounter++}`;
+                expressionAttributeValues[valueKey] = fieldValue.$lte;
+                filterExpressions.push(`${valuePath} <= ${valueKey}`);
+            }
+        }
+        else {
+            // Direct equality comparison
+            const valueKey = `:val${valueCounter++}`;
+            expressionAttributeValues[valueKey] = fieldValue;
+            filterExpressions.push(`${valuePath} = ${valueKey}`);
+        }
+    }
+    return {
+        filterExpression: filterExpressions.length > 0 ? filterExpressions.join(' AND ') : '',
+    };
+}
+//# sourceMappingURL=filter.js.map

package/dist/store/utils/filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.js","sourceRoot":"","sources":["../../../src/store/utils/filter.ts"],"names":[],"mappings":"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"}

package/dist/store/utils/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Store utilities
+ */
+export * from './result';
+export * from './validation';
+export * from './filter';
+export { withDynamoDBRetry, withRetry, type RetryOptions } from '../../shared/utils';
+//# sourceMappingURL=index.d.ts.map

package/dist/store/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/store/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AAEzB,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/store/utils/index.js

@@ -0,0 +1,28 @@
+"use strict";
+/**
+ * Store utilities
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withRetry = exports.withDynamoDBRetry = void 0;
+__exportStar(require("./result"), exports);
+__exportStar(require("./validation"), exports);
+__exportStar(require("./filter"), exports);
+// Retry utilities re-exported from shared
+var utils_1 = require("../../shared/utils");
+Object.defineProperty(exports, "withDynamoDBRetry", { enumerable: true, get: function () { return utils_1.withDynamoDBRetry; } });
+Object.defineProperty(exports, "withRetry", { enumerable: true, get: function () { return utils_1.withRetry; } });
+//# sourceMappingURL=index.js.map

package/dist/store/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/store/utils/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;;AAEH,2CAAyB;AACzB,+CAA6B;AAC7B,2CAAyB;AACzB,0CAA0C;AAC1C,4CAAqF;AAA5E,0GAAA,iBAAiB,OAAA;AAAE,kGAAA,SAAS,OAAA"}

package/dist/store/utils/result.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Result type for better error handling
+ * Allows functions to return either a success value or an error
+ */
+export type Result<T, E = Error> = {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    error: E;
+};
+/**
+ * Create a successful result
+ */
+export declare function Ok<T>(data: T): Result<T, never>;
+/**
+ * Create an error result
+ */
+export declare function Err<E = Error>(error: E): Result<never, E>;
+/**
+ * Check if a result is successful
+ */
+export declare function isOk<T, E>(result: Result<T, E>): result is {
+    success: true;
+    data: T;
+};
+/**
+ * Check if a result is an error
+ */
+export declare function isErr<T, E>(result: Result<T, E>): result is {
+    success: false;
+    error: E;
+};
+/**
+ * Unwrap a result or throw if it's an error
+ */
+export declare function unwrap<T, E>(result: Result<T, E>): T;
+/**
+ * Unwrap a result or return a default value if it's an error
+ */
+export declare function unwrapOr<T, E>(result: Result<T, E>, defaultValue: T): T;
+//# sourceMappingURL=result.d.ts.map

package/dist/store/utils/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../../src/store/utils/result.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,IAAI;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAAC;AAE7F;;GAEG;AACH,wBAAgB,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,CAE/C;AAED;;GAEG;AACH,wBAAgB,GAAG,CAAC,CAAC,GAAG,KAAK,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAEzD;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,IAAI;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,CAErF;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,IAAI;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAExF;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAKpD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,GAAG,CAAC,CAKvE"}

package/dist/store/utils/result.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Ok = Ok;
+exports.Err = Err;
+exports.isOk = isOk;
+exports.isErr = isErr;
+exports.unwrap = unwrap;
+exports.unwrapOr = unwrapOr;
+/**
+ * Create a successful result
+ */
+function Ok(data) {
+    return { success: true, data };
+}
+/**
+ * Create an error result
+ */
+function Err(error) {
+    return { success: false, error };
+}
+/**
+ * Check if a result is successful
+ */
+function isOk(result) {
+    return result.success === true;
+}
+/**
+ * Check if a result is an error
+ */
+function isErr(result) {
+    return result.success === false;
+}
+/**
+ * Unwrap a result or throw if it's an error
+ */
+function unwrap(result) {
+    if (isOk(result)) {
+        return result.data;
+    }
+    throw result.error;
+}
+/**
+ * Unwrap a result or return a default value if it's an error
+ */
+function unwrapOr(result, defaultValue) {
+    if (isOk(result)) {
+        return result.data;
+    }
+    return defaultValue;
+}
+//# sourceMappingURL=result.js.map

package/dist/store/utils/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../../src/store/utils/result.ts"],"names":[],"mappings":";;AASA,gBAEC;AAKD,kBAEC;AAKD,oBAEC;AAKD,sBAEC;AAKD,wBAKC;AAKD,4BAKC;AA9CD;;GAEG;AACH,SAAgB,EAAE,CAAI,IAAO;IAC3B,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,SAAgB,GAAG,CAAY,KAAQ;IACrC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,SAAgB,IAAI,CAAO,MAAoB;IAC7C,OAAO,MAAM,CAAC,OAAO,KAAK,IAAI,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,SAAgB,KAAK,CAAO,MAAoB;IAC9C,OAAO,MAAM,CAAC,OAAO,KAAK,KAAK,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,SAAgB,MAAM,CAAO,MAAoB;IAC/C,IAAI,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACjB,OAAO,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC;IACD,MAAM,MAAM,CAAC,KAAK,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,SAAgB,QAAQ,CAAO,MAAoB,EAAE,YAAe;IAClE,IAAI,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACjB,OAAO,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC"}

package/dist/store/utils/validation.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Validation utilities for store operations
+ */
+export declare class ValidationError extends Error {
+    constructor(message: string);
+}
+/**
+ * Validate namespace array
+ */
+export declare function validateNamespace(namespace: string[]): void;
+/**
+ * Validate key string
+ */
+export declare function validateKey(key: string): void;
+/**
+ * Validate value size
+ */
+export declare function validateValue(value: any): void;
+/**
+ * Validate pagination parameters
+ */
+export declare function validatePagination(limit?: number, offset?: number): void;
+/**
+ * Validate TTL days (wraps shared validation with store-specific error type)
+ */
+export declare function validateTTL(ttlDays?: number): void;
+/**
+ * Validate embeddings
+ */
+export declare function validateEmbeddings(embeddings?: number[][]): void;
+/**
+ * Validate user ID
+ */
+export declare function validateUserId(userId: string): void;
+/**
+ * Validate JSONPath expressions to prevent injection attacks
+ */
+export declare function validateJSONPath(paths: string[]): void;
+/**
+ * Validate maxDepth parameter
+ */
+export declare function validateMaxDepth(maxDepth?: number): void;
+/**
+ * Validate batch operations count
+ */
+export declare function validateBatchSize(operationsCount: number): void;
+/**
+ * Export constants for use in other modules
+ */
+export declare const ValidationConstants: {
+    readonly MAX_LOOP_ITERATIONS: 100;
+    readonly MAX_TOTAL_ITEMS_IN_MEMORY: 10000;
+    readonly MAX_OFFSET: 10000;
+    readonly MAX_DEPTH: 100;
+    readonly MAX_BATCH_SIZE: 100;
+};
+//# sourceMappingURL=validation.d.ts.map

package/dist/store/utils/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/store/utils/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAkBH,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI,CA8B3D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAgB7C;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,GAAG,GAAG,IAAI,CAW9C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CA4BxE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAMlD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,EAAE,GAAG,IAAI,CAoChE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAYnD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAiCtD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAgBxD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAc/D;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;CAMtB,CAAC"}