@farukada/aws-langgraph-dynamodb-ts 0.0.2

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

@@ -0,0 +1,212 @@
+"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 } = params;
+    const limit = op.limit;
+    const offset = op.offset;
+    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
+    const queryParams = {
+        TableName: memoryTableName,
+        KeyConditionExpression: 'user_id = :uid',
+        ExpressionAttributeValues: {
+            ':uid': userId,
+        },
+        ExpressionAttributeNames: {},
+        ProjectionExpression: 'namespace',
+    };
+    // Optimize a query with begins_with for prefix conditions
+    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}`;
+            queryParams.ExpressionAttributeNames[attrName] = 'namespace';
+            queryParams.ExpressionAttributeValues[valueName] = concreteSuffix;
+            filterExpressions.push(`contains(${attrName}, ${valueName})`);
+        }
+    });
+    if (filterExpressions.length > 0) {
+        queryParams.FilterExpression = filterExpressions.join(' AND ');
+    }
+    // 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);
+        });
+        // 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 (include userId)
+    const allNamespaces = Array.from(namespaceSet).map((ns) => {
+        const parts = ns ? ns.split('/') : [];
+        return [userId, ...parts];
+    });
+    // Apply all match conditions
+    const filteredNamespaces = allNamespaces.filter((namespacePath) => {
+        // Check all match conditions (must match ALL)
+        for (const condition of matchConditions) {
+            // Always check the condition, regardless of wildcards
+            // DynamoDB filtering is just an optimization, we verify all conditions here
+            if (!matchesCondition(namespacePath, condition)) {
+                return false;
+            }
+        }
+        // Check maxDepth if specified
+        if (maxDepth !== undefined) {
+            // Depth is measured from userId (first element)
+            const depth = namespacePath.length;
+            if (depth > maxDepth) {
+                return false;
+            }
+        }
+        return true;
+    });
+    // Sort namespaces for consistent ordering
+    filteredNamespaces.sort((a, b) => a.join('/').localeCompare(b.join('/')));
+    // Apply offset and limit
+    return filteredNamespaces.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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,9 @@
+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

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

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

@@ -0,0 +1,94 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.putOperationAction = void 0;
+const jsonpath_1 = __importDefault(require("jsonpath"));
+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 } = params;
+    // Validate inputs
+    (0, utils_1.validateUserId)(userId);
+    (0, utils_1.validateNamespace)(op.namespace);
+    (0, utils_1.validateKey)(op.key);
+    (0, utils_1.validateValue)(op.value);
+    (0, utils_1.validateTTL)(ttlDays);
+    const namespacePath = op.namespace.join('/');
+    const namespace_key = `${namespacePath}#${op.key}`;
+    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 = jsonpath_1.default.query(op.value, path);
+            for (const v of value) {
+                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
+    if (ttlDays && ttlDays > 0) {
+        updateExpressionParts.push('ttl = :ttl');
+        expressionAttributeValues[':ttl'] = Math.floor(Date.now() / 1000) + ttlDays * 24 * 60 * 60;
+    }
+    // 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,
+        });
+    });
+};
+exports.putOperationAction = putOperationAction;
+//# sourceMappingURL=put-operation.js.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,11 @@
+import type { SearchItem } from '@langchain/langgraph-checkpoint';
+import { SearchOperationActionParams } from '../types';
+/**
+ * Search for memory items in DynamoDB
+ *
+ * @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

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

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

@@ -0,0 +1,150 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.searchOperationAction = void 0;
+const utils_1 = require("../utils");
+/**
+ * Search for memory items in DynamoDB
+ *
+ * @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
+ */
+const searchOperationAction = async (params) => {
+    const { client, embedding, memoryTableName, userId, op } = params;
+    const limit = op.limit ?? 100;
+    const offset = op.offset ?? 0;
+    // Validate inputs
+    (0, utils_1.validateUserId)(userId);
+    // Allow empty namespace prefix to search all namespaces
+    if (op.namespacePrefix.length > 0) {
+        (0, utils_1.validateNamespace)(op.namespacePrefix);
+    }
+    (0, utils_1.validatePagination)(limit, offset);
+    const namespacePrefix = op.namespacePrefix.join('/');
+    const queryParams = {
+        TableName: memoryTableName,
+    };
+    // Build ExpressionAttributeValues and ExpressionAttributeNames
+    const expressionAttributeValues = {
+        ':uid': userId,
+    };
+    const expressionAttributeNames = {};
+    // Build KeyConditionExpression
+    let keyConditionExpression = 'user_id = :uid';
+    if (namespacePrefix) {
+        // Use begins_with on namespace_key for hierarchical search
+        expressionAttributeValues[':nsp'] = `${namespacePrefix}#`;
+        keyConditionExpression += ' AND begins_with(namespace_key, :nsp)';
+    }
+    queryParams.KeyConditionExpression = keyConditionExpression;
+    queryParams.ExpressionAttributeValues = expressionAttributeValues;
+    // Build filter expression if provided
+    if (op.filter && Object.keys(op.filter).length > 0) {
+        const filterResult = (0, utils_1.buildFilterExpression)(op.filter, expressionAttributeNames, expressionAttributeValues);
+        if (filterResult.filterExpression) {
+            queryParams.FilterExpression = filterResult.filterExpression;
+            queryParams.ExpressionAttributeNames = expressionAttributeNames;
+            queryParams.ExpressionAttributeValues = expressionAttributeValues;
+        }
+    }
+    const items = [];
+    let lastEvaluatedKey;
+    let scannedCount = 0;
+    let iterationCount = 0;
+    // Execute a query with retry logic and safety limits
+    do {
+        // Prevent infinite loops
+        iterationCount++;
+        if (iterationCount > utils_1.ValidationConstants.MAX_LOOP_ITERATIONS) {
+            throw new Error('Search operation exceeded maximum iteration limit');
+        }
+        queryParams.Limit = Math.max(1, limit + offset - scannedCount);
+        if (lastEvaluatedKey) {
+            queryParams.ExclusiveStartKey = lastEvaluatedKey;
+        }
+        const response = await (0, utils_1.withDynamoDBRetry)(async () => {
+            return await client.query(queryParams);
+        });
+        scannedCount += response.ScannedCount ?? 0;
+        if (response.Items && response.Items.length > 0) {
+            // Prevent memory exhaustion
+            if (items.length + response.Items.length > utils_1.ValidationConstants.MAX_TOTAL_ITEMS_IN_MEMORY) {
+                throw new Error('Search operation exceeded maximum items in memory limit');
+            }
+            items.push(...response.Items);
+        }
+        lastEvaluatedKey = response.LastEvaluatedKey;
+        if (!lastEvaluatedKey)
+            break;
+        if (items.length >= limit + offset)
+            break;
+        if (scannedCount >= limit + offset)
+            break;
+    } while (
+    // eslint-disable-next-line no-constant-condition
+    true);
+    if (items.length > 0) {
+        let paginatedItems = items.slice(offset, offset + limit);
+        if (op.query && embedding) {
+            paginatedItems = await applySemanticSearch(paginatedItems, op.query, embedding);
+        }
+        return paginatedItems.map((item) => ({
+            namespace: item.namespace.split('/'),
+            key: item.key,
+            value: item.value,
+            createdAt: item.createdAt,
+            updatedAt: item.updatedAt,
+            score: item.score,
+        }));
+    }
+    return [];
+};
+exports.searchOperationAction = searchOperationAction;
+/**
+ * Apply semantic search using vector embeddings and cosine similarity
+ * Falls back to returning original items if embedding generation fails
+ */
+async function applySemanticSearch(items, query, embedding) {
+    try {
+        const queryEmbedding = await embedding.embedQuery(query);
+        const itemsWithScores = items
+            .map((item) => {
+            if (!item.embedding || !Array.isArray(item.embedding) || item.embedding.length === 0) {
+                // Items without embeddings get score 0
+                return { item: { ...item, score: 0 }, score: 0 };
+            }
+            // Calculate similarity for each embedding (multiple fields can be embedded)
+            // Take the maximum similarity across all embeddings
+            const similarities = item.embedding.map((emb) => cosineSimilarity(queryEmbedding, emb));
+            const maxSimilarity = Math.max(...similarities);
+            return {
+                item: { ...item, score: maxSimilarity },
+                score: maxSimilarity,
+            };
+        })
+            .filter((result) => result.score > 0); // Only include items with embeddings
+        // Sort by similarity score (highest first)
+        itemsWithScores.sort((a, b) => b.score - a.score);
+        return itemsWithScores.map((result) => result.item);
+    }
+    catch {
+        // Fall back to returning original items if semantic search fails
+        return items;
+    }
+}
+/**
+ * Calculate cosine similarity between two vectors
+ */
+function cosineSimilarity(vecA, vecB) {
+    if (!vecA || !vecB || vecA.length !== vecB.length || vecA.length === 0) {
+        return 0;
+    }
+    const dotProduct = vecA.reduce((sum, a, i) => sum + a * vecB[i], 0);
+    const magnitudeA = Math.sqrt(vecA.reduce((sum, a) => sum + a * a, 0));
+    const magnitudeB = Math.sqrt(vecB.reduce((sum, b) => sum + b * b, 0));
+    if (magnitudeA === 0 || magnitudeB === 0) {
+        return 0;
+    }
+    return dotProduct / (magnitudeA * magnitudeB);
+}
+//# sourceMappingURL=search-operation.js.map

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

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

package/dist/store/index.d.ts

@@ -0,0 +1,73 @@
+import { BaseStore, type Operation, type OperationResults } from '@langchain/langgraph';
+import type { RunnableConfig } from '@langchain/core/runnables';
+import type { DynamoDBStoreOptions } from './types';
+/**
+ * DynamoDB-based store implementation for LangGraph
+ * Provides persistent storage for memory items with optional semantic search via embeddings
+ */
+export declare class DynamoDBStore extends BaseStore {
+    private readonly ddbClient;
+    private readonly client;
+    private readonly memoryTableName;
+    private readonly embedding?;
+    private readonly 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: DynamoDBStoreOptions);
+    /**
+     * 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
+     */
+    private getUserId;
+    /**
+     * 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
+     */
+    batch<Op extends Operation[]>(operations: Op, config?: RunnableConfig): Promise<OperationResults<Op>>;
+    /**
+     * 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
+     */
+    private getOperation;
+    /**
+     * Put an item into the store
+     *
+     * @param userId - User ID for the item
+     * @param op - Put operation parameters
+     */
+    private putOperation;
+    /**
+     * 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
+     */
+    private searchOperation;
+    /**
+     * List unique namespaces in the store
+     *
+     * @param userId - User ID for filtering namespaces
+     * @param op - List namespaces operation parameters
+     * @returns Array of namespace paths
+     */
+    private listNamespacesOperation;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/store/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EAMT,KAAK,SAAS,EACd,KAAK,gBAAgB,EACtB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEhE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAWpD;;;GAGG;AACH,qBAAa,aAAc,SAAQ,SAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiB;IAC3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAoB;IAC/C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAS;IAElC;;;;;;;;OAQG;gBACS,OAAO,EAAE,oBAAoB;IASzC;;;;;;OAMG;IACH,OAAO,CAAC,SAAS;IAQjB;;;;;;;OAOG;IACG,KAAK,CAAC,EAAE,SAAS,SAAS,EAAE,EAChC,UAAU,EAAE,EAAE,EACd,MAAM,CAAC,EAAE,cAAc,GACtB,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC;IA4BhC;;;;;;OAMG;YACW,YAAY;IAS1B;;;;;OAKG;YACW,YAAY;IAW1B;;;;;;OAMG;YACW,eAAe;IAU7B;;;;;;OAMG;YACW,uBAAuB;CAWtC"}