@farukada/aws-langgraph-dynamodb-ts 0.2.0 → 0.3.0

package/dist/store/actions/get-operation.js

@@ -1,42 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getOperationAction = void 0;
-const utils_1 = require("../utils");
-/**
- * Get a memory item from DynamoDB
- *
- * @param params - Parameters for the get operation
- * @returns The item if found, null if not found
- * @throws Error if the operation fails or validation fails
- */
-const getOperationAction = async (params) => {
-    const { client, memoryTableName, userId, op, signal } = params;
-    // Validate inputs
-    (0, utils_1.validateUserId)(userId);
-    (0, utils_1.validateNamespace)(op.namespace);
-    (0, utils_1.validateKey)(op.key);
-    const namespacePath = op.namespace.join('/');
-    const sortKey = `${namespacePath}#${op.key}`;
-    // Execute with retry logic
-    const ddbItem = await (0, utils_1.withDynamoDBRetry)(async () => {
-        return await client.get({
-            TableName: memoryTableName,
-            Key: {
-                user_id: userId,
-                namespace_key: sortKey,
-            },
-        });
-    }, { signal });
-    if (!ddbItem.Item) {
-        return null;
-    }
-    return {
-        key: ddbItem.Item.key,
-        namespace: op.namespace,
-        value: ddbItem.Item.value,
-        createdAt: new Date(ddbItem.Item.createdAt),
-        updatedAt: new Date(ddbItem.Item.updatedAt),
-    };
-};
-exports.getOperationAction = getOperationAction;
-//# sourceMappingURL=get-operation.js.map

package/dist/store/actions/get-operation.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"get-operation.js","sourceRoot":"","sources":["../../../src/store/actions/get-operation.ts"],"names":[],"mappings":";;;AAGA,oCAA6F;AAE7F;;;;;;GAMG;AACI,MAAM,kBAAkB,GAAG,KAAK,EACrC,MAAgC,EACV,EAAE;IACxB,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAE/D,kBAAkB;IAClB,IAAA,sBAAc,EAAC,MAAM,CAAC,CAAC;IACvB,IAAA,yBAAiB,EAAC,EAAE,CAAC,SAAS,CAAC,CAAC;IAChC,IAAA,mBAAW,EAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IAEpB,MAAM,aAAa,GAAG,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7C,MAAM,OAAO,GAAG,GAAG,aAAa,IAAI,EAAE,CAAC,GAAG,EAAE,CAAC;IAE7C,2BAA2B;IAC3B,MAAM,OAAO,GAAG,MAAM,IAAA,yBAAiB,EACrC,KAAK,IAAI,EAAE;QACT,OAAO,MAAM,MAAM,CAAC,GAAG,CAAC;YACtB,SAAS,EAAE,eAAe;YAC1B,GAAG,EAAE;gBACH,OAAO,EAAE,MAAM;gBACf,aAAa,EAAE,OAAO;aACvB;SACF,CAAC,CAAC;IACL,CAAC,EACD,EAAE,MAAM,EAAE,CACX,CAAC;IAEF,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,GAAG,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG;QACrB,SAAS,EAAE,EAAE,CAAC,SAAS;QACvB,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK;QACzB,SAAS,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC;QAC3C,SAAS,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC;KAC5C,CAAC;AACJ,CAAC,CAAC;AAtCW,QAAA,kBAAkB,sBAsC7B"}

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

@@ -1,5 +0,0 @@
-export * from './get-operation';
-export * from './put-operation';
-export * from './search-operation';
-export * from './list-namespaces-operation';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/store/actions/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,6BAA6B,CAAC"}

package/dist/store/actions/index.js

@@ -1,21 +0,0 @@
-"use strict";
-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 });
-__exportStar(require("./get-operation"), exports);
-__exportStar(require("./put-operation"), exports);
-__exportStar(require("./search-operation"), exports);
-__exportStar(require("./list-namespaces-operation"), exports);
-//# sourceMappingURL=index.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/store/actions/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kDAAgC;AAChC,kDAAgC;AAChC,qDAAmC;AACnC,8DAA4C"}

package/dist/store/actions/list-namespaces-operation.d.ts

@@ -1,10 +0,0 @@
-import type { ListNamespacesOperationActionParams } from '../types';
-/**
- * List unique namespaces from DynamoDB with filtering and pagination
- *
- * @param params - Parameters for the list namespaces operation
- * @returns Array of namespace paths (each path is an array of strings including userId)
- * @throws Error if the operation fails or validation fails
- */
-export declare const listNamespacesOperationAction: (params: ListNamespacesOperationActionParams) => Promise<string[][]>;
-//# sourceMappingURL=list-namespaces-operation.d.ts.map

package/dist/store/actions/list-namespaces-operation.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"list-namespaces-operation.d.ts","sourceRoot":"","sources":["../../../src/store/actions/list-namespaces-operation.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mCAAmC,EAAiB,MAAM,UAAU,CAAC;AASnF;;;;;;GAMG;AACH,eAAO,MAAM,6BAA6B,GACxC,QAAQ,mCAAmC,KAC1C,OAAO,CAAC,MAAM,EAAE,EAAE,CAwJpB,CAAC"}

package/dist/store/actions/list-namespaces-operation.js

@@ -1,227 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.listNamespacesOperationAction = void 0;
-const utils_1 = require("../utils");
-/**
- * List unique namespaces from DynamoDB with filtering and pagination
- *
- * @param params - Parameters for the list namespaces operation
- * @returns Array of namespace paths (each path is an array of strings including userId)
- * @throws Error if the operation fails or validation fails
- */
-const listNamespacesOperationAction = async (params) => {
-    const { client, memoryTableName, userId, op, signal } = params;
-    // LangGraph's BaseStore.listNamespaces defaults these to 100 and 0 before dispatching
-    // through batch(), but nothing guarantees the caller went via that path. Fall back
-    // to the same defaults so `(limit + offset) * CANDIDATE_MULTIPLIER` below stays finite.
-    const limit = op.limit ?? 100;
-    const offset = op.offset ?? 0;
-    const matchConditions = op.matchConditions ?? [];
-    const maxDepth = op.maxDepth;
-    // Validate inputs
-    (0, utils_1.validateUserId)(userId);
-    (0, utils_1.validatePagination)(limit, offset);
-    (0, utils_1.validateMaxDepth)(maxDepth);
-    // Determine if we can optimize with KeyConditionExpression
-    const prefixCondition = matchConditions.find((c) => c.matchType === 'prefix');
-    const namespacePrefix = prefixCondition ? extractConcretePrefix(prefixCondition.path) : '';
-    // Build query parameters.
-    //
-    // IMPORTANT: ExpressionAttributeNames starts as a local accumulator rather
-    // than an always-present `{}` on the QueryInput — DynamoDB rejects requests
-    // that carry an empty ExpressionAttributeNames object with
-    // `ValidationException: ExpressionAttributeNames must not be empty`. We
-    // attach it to the input only when at least one entry has been added.
-    const expressionAttributeNames = {};
-    const queryParams = {
-        TableName: memoryTableName,
-        KeyConditionExpression: 'user_id = :uid',
-        ExpressionAttributeValues: {
-            ':uid': userId,
-        },
-        ProjectionExpression: 'namespace',
-    };
-    // Optimize a query with begins_with for prefix conditions.
-    // NOTE: we do NOT append a separator — the SK is `<nsPath>#<key>`; appending
-    // "#" misses sub-namespaces (`"users/alice#x"` would not begin with `"users#"`).
-    // Raw prefix is over-inclusive (`users` also matches `users_v2`) but the
-    // in-memory match filter eliminates false positives.
-    if (namespacePrefix) {
-        queryParams.KeyConditionExpression += ' AND begins_with(namespace_key, :nsPrefix)';
-        queryParams.ExpressionAttributeValues[':nsPrefix'] = namespacePrefix;
-    }
-    // Build FilterExpression for suffix conditions using contains()
-    const filterExpressions = [];
-    const suffixConditions = matchConditions.filter((c) => c.matchType === 'suffix');
-    suffixConditions.forEach((condition, index) => {
-        const concreteSuffix = extractConcreteSuffix(condition.path);
-        if (concreteSuffix) {
-            const attrName = `#ns${index}`;
-            const valueName = `:suffix${index}`;
-            expressionAttributeNames[attrName] = 'namespace';
-            queryParams.ExpressionAttributeValues[valueName] = concreteSuffix;
-            filterExpressions.push(`contains(${attrName}, ${valueName})`);
-        }
-    });
-    if (filterExpressions.length > 0) {
-        queryParams.FilterExpression = filterExpressions.join(' AND ');
-    }
-    // Only attach ExpressionAttributeNames when non-empty — DDB rejects {}.
-    if (Object.keys(expressionAttributeNames).length > 0) {
-        queryParams.ExpressionAttributeNames = expressionAttributeNames;
-    }
-    // Use a Set to track unique namespaces
-    const namespaceSet = new Set();
-    let lastEvaluatedKey;
-    let iterationCount = 0;
-    // Fetch all matching items with retry logic and safety limits
-    const CANDIDATE_MULTIPLIER = 10; // Fetch 10x more candidates to account for filtering
-    // Cap the target size to prevent excessive memory usage
-    const targetSize = Math.min((limit + offset) * CANDIDATE_MULTIPLIER, utils_1.ValidationConstants.MAX_TOTAL_ITEMS_IN_MEMORY);
-    do {
-        // Prevent infinite loops
-        iterationCount++;
-        if (iterationCount > utils_1.ValidationConstants.MAX_LOOP_ITERATIONS) {
-            throw new Error('List namespaces operation exceeded maximum iteration limit');
-        }
-        if (lastEvaluatedKey) {
-            queryParams.ExclusiveStartKey = lastEvaluatedKey;
-        }
-        const response = await (0, utils_1.withDynamoDBRetry)(async () => {
-            return await client.query(queryParams);
-        }, { signal });
-        // Extract and deduplicate namespaces
-        response.Items?.forEach((item) => {
-            if (item.namespace !== undefined && item.namespace !== null) {
-                // Prevent memory exhaustion
-                if (namespaceSet.size >= utils_1.ValidationConstants.MAX_TOTAL_ITEMS_IN_MEMORY) {
-                    return; // Stop adding more items
-                }
-                namespaceSet.add(item.namespace);
-            }
-        });
-        lastEvaluatedKey = response.LastEvaluatedKey;
-        // Stop after collecting enough candidates
-        if (namespaceSet.size >= targetSize) {
-            break;
-        }
-    } while (lastEvaluatedKey);
-    // Convert Set to an array of namespace arrays.
-    // userId is the partition key and is NOT part of the namespace path, so it is
-    // excluded here to match the shape returned by other store methods and the
-    // LangGraph reference InMemoryStore implementation.
-    const allNamespaces = Array.from(namespaceSet).map((ns) => (ns ? ns.split('/') : []));
-    // Apply all match conditions (reference: memory.js:122-138)
-    const matchedNamespaces = allNamespaces.filter((namespacePath) => {
-        for (const condition of matchConditions) {
-            if (!matchesCondition(namespacePath, condition)) {
-                return false;
-            }
-        }
-        return true;
-    });
-    // Apply maxDepth: truncate each namespace to its first N segments, then dedupe.
-    // This matches the reference impl (memory.js:115-121) where deeper namespaces
-    // collapse into their parent paths rather than being filtered out entirely.
-    const truncatedSet = new Set();
-    for (const path of matchedNamespaces) {
-        const truncated = maxDepth !== undefined ? path.slice(0, maxDepth) : path;
-        truncatedSet.add(truncated.join('/'));
-    }
-    const dedupedNamespaces = Array.from(truncatedSet).map((ns) => (ns ? ns.split('/') : []));
-    // Sort namespaces for consistent ordering
-    dedupedNamespaces.sort((a, b) => a.join('/').localeCompare(b.join('/')));
-    // Apply offset and limit
-    return dedupedNamespaces.slice(offset, offset + limit);
-};
-exports.listNamespacesOperationAction = listNamespacesOperationAction;
-/**
- * Extract a concrete prefix (before any wildcards) from a path for DynamoDB optimization
- */
-function extractConcretePrefix(path) {
-    const concreteParts = [];
-    for (let i = 0; i < path.length; i++) {
-        if (path[i] === '*') {
-            break;
-        }
-        concreteParts.push(path[i]);
-    }
-    return concreteParts.join('/');
-}
-/**
- * Extract concrete suffix (after any wildcards) from a path for DynamoDB contains()
- * Returns the suffix pattern for contains() matching
- */
-function extractConcreteSuffix(path) {
-    const concreteParts = [];
-    // Collect concrete parts from the end, working backwards until we hit a wildcard
-    for (let i = path.length - 1; i >= 0; i--) {
-        if (path[i] === '*') {
-            break;
-        }
-        concreteParts.unshift(path[i]);
-    }
-    // Return as a path string (e.g., "reports/2024")
-    return concreteParts.join('/');
-}
-/**
- * Check if a namespace matches a single condition
- */
-function matchesCondition(namespacePath, condition) {
-    const { matchType, path } = condition;
-    if (matchType === 'prefix') {
-        return matchesPrefix(namespacePath, path);
-    }
-    else if (matchType === 'suffix') {
-        return matchesSuffix(namespacePath, path);
-    }
-    return false;
-}
-/**
- * Check if a namespace matches a prefix pattern (supports wildcards)
- */
-function matchesPrefix(namespacePath, pattern) {
-    // Pattern must not be longer than the namespace
-    if (pattern.length > namespacePath.length) {
-        return false;
-    }
-    // Check each position in the pattern
-    for (let i = 0; i < pattern.length; i++) {
-        const patternPart = pattern[i];
-        const namespacePart = namespacePath[i];
-        // Wildcard matches anything
-        if (patternPart === '*') {
-            continue;
-        }
-        // Concrete value must match exactly
-        if (patternPart !== namespacePart) {
-            return false;
-        }
-    }
-    return true;
-}
-/**
- * Check if a namespace matches a suffix pattern (supports wildcards)
- */
-function matchesSuffix(namespacePath, pattern) {
-    // Pattern must not be longer than the namespace
-    if (pattern.length > namespacePath.length) {
-        return false;
-    }
-    // Check from the end
-    const offset = namespacePath.length - pattern.length;
-    for (let i = 0; i < pattern.length; i++) {
-        const patternPart = pattern[i];
-        const namespacePart = namespacePath[offset + i];
-        // Wildcard matches anything
-        if (patternPart === '*') {
-            continue;
-        }
-        // Concrete value must match exactly
-        if (patternPart !== namespacePart) {
-            return false;
-        }
-    }
-    return true;
-}
-//# sourceMappingURL=list-namespaces-operation.js.map

package/dist/store/actions/list-namespaces-operation.js.map

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

package/dist/store/actions/put-operation.d.ts

@@ -1,9 +0,0 @@
-import { PutOperationActionParams } from '../types';
-/**
- * Put a memory item into DynamoDB
- *
- * @param params - Parameters for the put operation
- * @throws Error if the operation fails or validation fails
- */
-export declare const putOperationAction: (params: PutOperationActionParams) => Promise<void>;
-//# sourceMappingURL=put-operation.d.ts.map

package/dist/store/actions/put-operation.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"put-operation.d.ts","sourceRoot":"","sources":["../../../src/store/actions/put-operation.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAC;AAYpD;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAAU,QAAQ,wBAAwB,KAAG,OAAO,CAAC,IAAI,CA4GvF,CAAC"}

package/dist/store/actions/put-operation.js

@@ -1,107 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.putOperationAction = void 0;
-const jsonpath_plus_1 = require("jsonpath-plus");
-const shared_1 = require("../../shared");
-const utils_1 = require("../utils");
-/**
- * Put a memory item into DynamoDB
- *
- * @param params - Parameters for the put operation
- * @throws Error if the operation fails or validation fails
- */
-const putOperationAction = async (params) => {
-    const { client, embedding, memoryTableName, userId, op, ttlDays, signal } = params;
-    // Validate inputs
-    (0, utils_1.validateUserId)(userId);
-    (0, utils_1.validateNamespace)(op.namespace);
-    (0, utils_1.validateKey)(op.key);
-    (0, utils_1.validateTTL)(ttlDays);
-    const namespacePath = op.namespace.join('/');
-    const namespace_key = `${namespacePath}#${op.key}`;
-    // LangGraph convention: PutOperation with value === null means delete the item.
-    // BaseStore.delete(ns, key) routes through batch([{namespace, key, value: null}]).
-    if (op.value === null) {
-        await (0, utils_1.withDynamoDBRetry)(async () => {
-            await client.delete({
-                TableName: memoryTableName,
-                Key: {
-                    user_id: userId,
-                    namespace_key: namespace_key,
-                },
-            });
-        }, { signal });
-        return;
-    }
-    (0, utils_1.validateValue)(op.value);
-    const now = Date.now();
-    // Generate embeddings if requested
-    let embeddings;
-    if (embedding && op.index && op.index.length > 0) {
-        // Validate JSONPath expressions before use
-        (0, utils_1.validateJSONPath)(op.index);
-        const textToEmbed = [];
-        for (const path of op.index) {
-            const value = (0, jsonpath_plus_1.JSONPath)({ path, json: op.value, wrap: false });
-            const values = Array.isArray(value) ? value : [value];
-            for (const v of values) {
-                if (typeof v === 'string') {
-                    textToEmbed.push(v);
-                }
-                else if (typeof v === 'number' || typeof v === 'boolean') {
-                    textToEmbed.push(v.toString());
-                }
-                else if (v !== null && v !== undefined) {
-                    textToEmbed.push(JSON.stringify(v));
-                }
-            }
-        }
-        if (textToEmbed.length > 0) {
-            embeddings = await embedding.embedDocuments(textToEmbed);
-            (0, utils_1.validateEmbeddings)(embeddings);
-        }
-    }
-    // Build update expression
-    const updateExpressionParts = [
-        'namespace = :namespace',
-        '#key = :key',
-        '#value = :value',
-        'updatedAt = :updatedAt',
-    ];
-    const expressionAttributeNames = {
-        '#key': 'key',
-        '#value': 'value',
-    };
-    const expressionAttributeValues = {
-        ':namespace': namespacePath,
-        ':key': op.key,
-        ':value': op.value,
-        ':updatedAt': now,
-        ':createdAt': now,
-    };
-    // Add embedding if generated
-    if (embeddings) {
-        updateExpressionParts.push('embedding = :embedding');
-        expressionAttributeValues[':embedding'] = embeddings;
-    }
-    // Add TTL if configured (validateTTL already rejected non-positive or non-integer values)
-    if (ttlDays !== undefined) {
-        updateExpressionParts.push('ttl = :ttl');
-        expressionAttributeValues[':ttl'] = (0, shared_1.calculateTTLTimestamp)(ttlDays);
-    }
-    // Execute with retry logic
-    await (0, utils_1.withDynamoDBRetry)(async () => {
-        await client.update({
-            TableName: memoryTableName,
-            Key: {
-                user_id: userId,
-                namespace_key: namespace_key,
-            },
-            UpdateExpression: `SET ${updateExpressionParts.join(', ')}, createdAt = if_not_exists(createdAt, :createdAt)`,
-            ExpressionAttributeNames: expressionAttributeNames,
-            ExpressionAttributeValues: expressionAttributeValues,
-        });
-    }, { signal });
-};
-exports.putOperationAction = putOperationAction;
-//# sourceMappingURL=put-operation.js.map

package/dist/store/actions/put-operation.js.map

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

package/dist/store/actions/search-operation.d.ts

@@ -1,17 +0,0 @@
-import type { SearchItem } from '@langchain/langgraph-checkpoint';
-import { SearchOperationActionParams } from '../types';
-/**
- * Search for memory items in DynamoDB
- *
- * @remarks
- * **Pagination trade-off:** DynamoDB does not support native offset-based pagination.
- * When `offset` is used, `limit + offset` items are loaded into memory and sliced.
- * For large offsets (up to 10,000), this can be memory-intensive.
- * Consider cursor-based pagination for high-offset use cases.
- *
- * @param params - Parameters for the search operation
- * @returns Array of matching items with optional similarity scores
- * @throws Error if the operation fails or validation fails
- */
-export declare const searchOperationAction: (params: SearchOperationActionParams) => Promise<SearchItem[]>;
-//# sourceMappingURL=search-operation.d.ts.map

package/dist/store/actions/search-operation.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"search-operation.d.ts","sourceRoot":"","sources":["../../../src/store/actions/search-operation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAGlE,OAAO,EAAE,2BAA2B,EAAE,MAAM,UAAU,CAAC;AAUvD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,qBAAqB,GAChC,QAAQ,2BAA2B,KAClC,OAAO,CAAC,UAAU,EAAE,CAiKtB,CAAC"}