@ductape/sdk 0.0.4-v9 → 0.0.4-v91

package/dist/cache/cache.manager.js

@@ -0,0 +1,460 @@
+"use strict";
+/**
+ * CacheManager - Shared caching utility for all executor services
+ *
+ * Provides a three-tier caching strategy:
+ * - Internal (in-memory): Fastest layer using Map with LRU eviction
+ * - Redis (local/fast): Secondary cache layer for distributed reads
+ * - Remote (persistent): Backing store synced on writes/deletes/cache misses
+ *
+ * Used by: StorageService, DatabaseService, GraphService, VectorService,
+ * QuotaService, FallbackService, AgentsService, SessionsService, BrokersService,
+ * NotificationsService, etc.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CacheManager = void 0;
+const crypto_js_1 = __importDefault(require("crypto-js"));
+const processorApi_service_1 = require("../api/services/processorApi.service");
+const processor_utils_1 = require("../processor/utils/processor.utils");
+/**
+ * CacheManager provides shared caching functionality for all executor services
+ *
+ * @example
+ * ```ts
+ * const cacheManager = new CacheManager({
+ *   workspace_id: 'ws-123',
+ *   public_key: 'pk-123',
+ *   user_id: 'user-123',
+ *   token: 'token',
+ *   env_type: 'prd',
+ *   redis_client: redisClient,
+ * });
+ *
+ * // Check cache before operation
+ * const cached = await cacheManager.fetch<MyData>({
+ *   cache_tag: 'my-cache',
+ *   product_tag: 'my-product',
+ *   component_tag: 'my-storage',
+ *   component_type: 'storage',
+ *   input: { fileName: 'test.pdf' },
+ *   privateKey: 'private-key',
+ *   expiry: 3600000, // 1 hour
+ * });
+ *
+ * if (cached.hit) {
+ *   return cached.data;
+ * }
+ *
+ * // Execute operation...
+ * const result = await doOperation();
+ *
+ * // Store in cache
+ * await cacheManager.store({
+ *   cache_tag: 'my-cache',
+ *   product_tag: 'my-product',
+ *   component_tag: 'my-storage',
+ *   component_type: 'storage',
+ *   input: { fileName: 'test.pdf' },
+ *   privateKey: 'private-key',
+ *   expiry: 3600000,
+ * }, result);
+ * ```
+ */
+class CacheManager {
+    constructor(config) {
+        /** Internal in-memory cache (Tier 1 - fastest) */
+        this.internalCache = new Map();
+        /** Maximum number of entries in internal cache before LRU eviction */
+        this.maxInternalCacheSize = 1000;
+        this.config = config;
+        this.redisClient = config.redis_client || null;
+        this.processorApiService = new processorApi_service_1.ProcessorApiService(config.env_type);
+    }
+    /**
+     * Set maximum size for internal cache
+     */
+    setMaxInternalCacheSize(size) {
+        this.maxInternalCacheSize = size;
+    }
+    /**
+     * Clear internal cache
+     */
+    clearInternalCache() {
+        this.internalCache.clear();
+    }
+    /**
+     * Set entry in internal cache with LRU eviction
+     */
+    setInternalCache(key, entry) {
+        // Evict oldest entries if at capacity
+        if (this.internalCache.size >= this.maxInternalCacheSize) {
+            const oldestKey = this.internalCache.keys().next().value;
+            if (oldestKey) {
+                this.internalCache.delete(oldestKey);
+            }
+        }
+        this.internalCache.set(key, entry);
+    }
+    /**
+     * Check if internal cache entry is still valid
+     */
+    isValidEntry(entry, expiry) {
+        if (!expiry)
+            return true;
+        return Date.now() < entry.lastUpdated + expiry;
+    }
+    /**
+     * Wrap value with type information for storage (auto-detect type)
+     */
+    wrapValue(data) {
+        if (typeof data === 'string') {
+            return { type: 'string', value: data };
+        }
+        return { type: 'json', value: JSON.stringify(data) };
+    }
+    /**
+     * Unwrap value based on stored type
+     */
+    unwrapValue(wrapper) {
+        if (wrapper.type === 'string') {
+            return wrapper.value;
+        }
+        return JSON.parse(wrapper.value);
+    }
+    /**
+     * Get user access credentials for API calls
+     */
+    getUserAccess() {
+        return {
+            workspace_id: this.config.workspace_id,
+            public_key: this.config.public_key,
+            user_id: this.config.user_id,
+            token: this.config.token,
+        };
+    }
+    /**
+     * Generate cache key from cache tag and input (legacy format)
+     */
+    generateKey(cache_tag, input) {
+        const inputStr = typeof input === 'string' ? input : JSON.stringify(input);
+        return `${cache_tag}-${crypto_js_1.default.SHA512(inputStr).toString()}`;
+    }
+    /**
+     * Generate cache key with new format: cache_tag:component_type:operation:sha256(input)
+     * Includes cache_tag for isolation between different cache configurations
+     */
+    generateKeyV2(options) {
+        const { cache_tag, component_type, operation, input } = options;
+        const inputStr = typeof input === 'string' ? input : JSON.stringify(input);
+        const hash = crypto_js_1.default.SHA256(inputStr).toString();
+        return `${cache_tag}:${component_type}:${operation}:${hash}`;
+    }
+    /**
+     * Generate cache key based on options (uses V2 format if operation provided)
+     */
+    generateCacheKey(options) {
+        if (options.operation) {
+            return this.generateKeyV2({
+                cache_tag: options.cache_tag,
+                component_type: options.component_type,
+                operation: options.operation,
+                input: options.input,
+            });
+        }
+        return this.generateKey(options.cache_tag, options.input);
+    }
+    /**
+     * Check if caching is available (Redis client connected)
+     */
+    isAvailable() {
+        return this.redisClient !== null;
+    }
+    /**
+     * Fetch data from cache (Internal first, then Redis, then remote on miss)
+     *
+     * @returns Cache result with hit status, data, and source
+     */
+    async fetch(options) {
+        const { privateKey, expiry } = options;
+        const key = this.generateCacheKey(options);
+        try {
+            // TIER 1: Check internal (in-memory) cache first
+            const internalEntry = this.internalCache.get(key);
+            if (internalEntry) {
+                if (this.isValidEntry(internalEntry, expiry)) {
+                    const decryptedData = (0, processor_utils_1.decrypt)(internalEntry.data, privateKey);
+                    const wrapper = JSON.parse(decryptedData);
+                    return {
+                        hit: true,
+                        data: this.unwrapValue(wrapper),
+                        key,
+                        source: 'internal',
+                    };
+                }
+                else {
+                    // Expired - remove from internal cache
+                    this.internalCache.delete(key);
+                }
+            }
+            // TIER 2: Check Redis cache
+            if (this.redisClient) {
+                const redisRecord = await this.redisClient.hGetAll(key);
+                if (redisRecord && redisRecord.data && redisRecord.lastUpdated) {
+                    const lastUpdated = Number(redisRecord.lastUpdated);
+                    if (expiry) {
+                        const expiryTime = lastUpdated + expiry;
+                        if (Date.now() > expiryTime) {
+                            // Expired - delete from Redis and continue to remote
+                            await this.redisClient.del(key);
+                        }
+                        else {
+                            // Valid cache hit from Redis - populate internal cache
+                            this.setInternalCache(key, {
+                                data: redisRecord.data,
+                                lastUpdated,
+                                expiry,
+                            });
+                            const decryptedData = (0, processor_utils_1.decrypt)(redisRecord.data, privateKey);
+                            // Try to parse as wrapper, fallback to direct parse for legacy data
+                            try {
+                                const wrapper = JSON.parse(decryptedData);
+                                if (wrapper.type && wrapper.value !== undefined) {
+                                    return {
+                                        hit: true,
+                                        data: this.unwrapValue(wrapper),
+                                        key,
+                                        source: 'redis',
+                                    };
+                                }
+                            }
+                            catch (_a) {
+                                // Legacy format - parse directly
+                            }
+                            return {
+                                hit: true,
+                                data: JSON.parse(decryptedData),
+                                key,
+                                source: 'redis',
+                            };
+                        }
+                    }
+                    else {
+                        // No expiry - valid cache hit, populate internal cache
+                        this.setInternalCache(key, {
+                            data: redisRecord.data,
+                            lastUpdated,
+                            expiry,
+                        });
+                        const decryptedData = (0, processor_utils_1.decrypt)(redisRecord.data, privateKey);
+                        try {
+                            const wrapper = JSON.parse(decryptedData);
+                            if (wrapper.type && wrapper.value !== undefined) {
+                                return {
+                                    hit: true,
+                                    data: this.unwrapValue(wrapper),
+                                    key,
+                                    source: 'redis',
+                                };
+                            }
+                        }
+                        catch (_b) {
+                            // Legacy format
+                        }
+                        return {
+                            hit: true,
+                            data: JSON.parse(decryptedData),
+                            key,
+                            source: 'redis',
+                        };
+                    }
+                }
+            }
+            // TIER 3: Check remote cache
+            const remoteRecord = await this.processorApiService.fetchRemoteCacheByKey(key, this.getUserAccess());
+            if (remoteRecord) {
+                const timestamp = Date.now();
+                // Populate internal cache
+                this.setInternalCache(key, {
+                    data: remoteRecord.value,
+                    lastUpdated: timestamp,
+                    expiry,
+                });
+                // Populate Redis cache for next time
+                if (this.redisClient) {
+                    await this.redisClient.hSet(key, 'data', remoteRecord.value);
+                    await this.redisClient.hSet(key, 'lastUpdated', timestamp.toString());
+                }
+                const decryptedData = (0, processor_utils_1.decrypt)(remoteRecord.value, privateKey);
+                try {
+                    const wrapper = JSON.parse(decryptedData);
+                    if (wrapper.type && wrapper.value !== undefined) {
+                        return {
+                            hit: true,
+                            data: this.unwrapValue(wrapper),
+                            key,
+                            source: 'remote',
+                        };
+                    }
+                }
+                catch (_c) {
+                    // Legacy format
+                }
+                return {
+                    hit: true,
+                    data: JSON.parse(decryptedData),
+                    key,
+                    source: 'remote',
+                };
+            }
+            // Cache miss in all tiers
+            return { hit: false, key, source: 'miss' };
+        }
+        catch (error) {
+            // On error, return miss and let the operation proceed
+            console.error('CacheManager fetch error:', error);
+            return { hit: false, key, source: 'miss' };
+        }
+    }
+    /**
+     * Store data in cache (all three tiers: internal, Redis, and remote)
+     */
+    async store(options, data) {
+        const { cache_tag, product_tag, component_tag, component_type, privateKey, expiry, } = options;
+        const key = this.generateCacheKey(options);
+        const timestamp = Date.now();
+        // Wrap value with type information and serialize
+        const wrapper = this.wrapValue(data);
+        const serializedData = JSON.stringify(wrapper);
+        const encryptedData = (0, processor_utils_1.encrypt)(serializedData, privateKey);
+        // Calculate expiry date if provided
+        let expiresAt;
+        if (expiry) {
+            expiresAt = new Date(timestamp + expiry);
+        }
+        try {
+            // TIER 1: Write to internal cache
+            this.setInternalCache(key, {
+                data: encryptedData,
+                lastUpdated: timestamp,
+                expiry,
+            });
+            // TIER 2: Write to Redis cache (if available)
+            if (this.redisClient) {
+                await this.redisClient.hSet(key, 'data', encryptedData);
+                await this.redisClient.hSet(key, 'lastUpdated', timestamp.toString());
+            }
+            // TIER 3: Write to remote cache (persistent store)
+            const remotePayload = {
+                key,
+                value: encryptedData,
+                cache_tag,
+                product_tag,
+                component_tag,
+                component_type,
+                expiry: expiresAt,
+            };
+            await this.processorApiService.addToRemoteCache(remotePayload, this.getUserAccess());
+        }
+        catch (error) {
+            // Log error but don't throw - cache failure shouldn't break the operation
+            console.error('CacheManager store error:', error);
+        }
+    }
+    /**
+     * Invalidate/delete data from cache (all three tiers)
+     */
+    async invalidate(cache_tag, input) {
+        const key = this.generateKey(cache_tag, input);
+        try {
+            // TIER 1: Delete from internal cache
+            this.internalCache.delete(key);
+            // TIER 2: Delete from Redis cache (if available)
+            if (this.redisClient) {
+                await this.redisClient.del(key);
+            }
+            // TIER 3: Delete from remote cache
+            await this.processorApiService.deleteCacheValue({ key }, this.getUserAccess());
+        }
+        catch (error) {
+            // Log error but don't throw
+            console.error('CacheManager invalidate error:', error);
+        }
+    }
+    /**
+     * Invalidate/delete data from cache using options (supports new key format)
+     */
+    async invalidateV2(options) {
+        const key = this.generateCacheKey(options);
+        try {
+            // TIER 1: Delete from internal cache
+            this.internalCache.delete(key);
+            // TIER 2: Delete from Redis cache (if available)
+            if (this.redisClient) {
+                await this.redisClient.del(key);
+            }
+            // TIER 3: Delete from remote cache
+            await this.processorApiService.deleteCacheValue({ key }, this.getUserAccess());
+        }
+        catch (error) {
+            // Log error but don't throw
+            console.error('CacheManager invalidateV2 error:', error);
+        }
+    }
+    /**
+     * Helper method to wrap an async operation with caching
+     *
+     * @example
+     * ```ts
+     * const result = await cacheManager.withCache(
+     *   {
+     *     cache_tag: 'my-cache',
+     *     product_tag: 'my-product',
+     *     component_tag: 'my-storage',
+     *     component_type: 'storage',
+     *     input: { fileName: 'test.pdf' },
+     *     privateKey: 'private-key',
+     *     expiry: 3600000,
+     *   },
+     *   async () => {
+     *     // Execute the actual operation
+     *     return await downloadFile('test.pdf');
+     *   }
+     * );
+     * ```
+     */
+    async withCache(options, operation) {
+        // Try to fetch from cache
+        const cached = await this.fetch(options);
+        if (cached.hit && cached.data !== undefined) {
+            return {
+                data: cached.data,
+                cached: true,
+                source: cached.source,
+            };
+        }
+        // Cache miss - execute the operation
+        const data = await operation();
+        // Store result in cache
+        await this.store(options, data);
+        return {
+            data,
+            cached: false,
+            source: 'fresh',
+        };
+    }
+    /**
+     * Get internal cache stats for debugging/monitoring
+     */
+    getInternalCacheStats() {
+        return {
+            size: this.internalCache.size,
+            maxSize: this.maxInternalCacheSize,
+        };
+    }
+}
+exports.CacheManager = CacheManager;
+exports.default = CacheManager;
+//# sourceMappingURL=cache.manager.js.map

package/dist/cache/cache.manager.js.map

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

package/dist/cache/cache.service.d.ts

@@ -0,0 +1,186 @@
+/**
+ * Ductape Cache Service
+ *
+ * Provides SDK methods for managing cache values including
+ * fetching, setting, and deleting cache entries.
+ *
+ * Supports a two-tier caching strategy:
+ * - Redis (local/fast): Primary cache layer for reads
+ * - Remote (persistent): Backing store synced on writes/deletes/cache misses
+ */
+import { ICacheServiceConfig, ICacheValue, IFetchCacheValuesOptions, IFetchCacheValuesResult, IFetchCacheDashboardOptions, ICacheDashboardMetrics, IClearCacheValueOptions, IClearCacheValuesOptions, IClearCacheValuesResult, ISetCacheValueOptions, IGetCacheValueOptions } from './types';
+/**
+ * Custom error class for cache operations
+ */
+export declare class CacheError extends Error {
+    code: string;
+    originalError?: unknown;
+    constructor(message: string, code: string, originalError?: unknown);
+}
+/**
+ * CacheService provides methods for managing remote cache values
+ *
+ * @example
+ * ```ts
+ * import { CacheService } from '@ductape/sdk';
+ *
+ * const cache = new CacheService({
+ *   workspace_id: 'your-workspace-id',
+ *   public_key: 'your-public-key',
+ *   user_id: 'your-user-id',
+ *   token: 'your-token',
+ *   env_type: 'prd',
+ * });
+ *
+ * // Fetch cache values
+ * const values = await cache.fetchValues({
+ *   product: 'my-product',
+ *   cache: 'user-cache',
+ *   page: 1,
+ *   limit: 20,
+ * });
+ *
+ * // Get a specific value
+ * const value = await cache.get({ key: 'user:123' });
+ *
+ * // Set a value
+ * await cache.set({
+ *   product: 'my-product',
+ *   cache: 'user-cache',
+ *   key: 'user:123',
+ *   value: JSON.stringify({ name: 'John' }),
+ * });
+ *
+ * // Clear a value
+ * await cache.clear({ key: 'user:123' });
+ * ```
+ */
+export declare class CacheService {
+    private productBuilderService;
+    private processorApiService;
+    private envType;
+    private workspaceId;
+    private publicKey;
+    private userId;
+    private token;
+    private productId;
+    /** Redis client for local caching */
+    private redisClient;
+    /** Whether Redis is connected */
+    private redisConnected;
+    constructor(config: ICacheServiceConfig);
+    /**
+     * Connect to Redis for local caching
+     * This enables the two-tier caching strategy where Redis is checked first
+     *
+     * @example
+     * ```ts
+     * await cache.connectRedis('redis://localhost:6379');
+     * ```
+     */
+    connectRedis(url: string): Promise<void>;
+    /**
+     * Disconnect from Redis
+     */
+    disconnectRedis(): Promise<void>;
+    /**
+     * Check if Redis is connected
+     */
+    isRedisConnected(): boolean;
+    /**
+     * Update service configuration (used after authentication)
+     */
+    updateConfig(config: Partial<ICacheServiceConfig>): void;
+    /**
+     * Get user access credentials for API calls
+     */
+    private getUserAccess;
+    /**
+     * Fetch paginated cache values
+     *
+     * @example
+     * ```ts
+     * const values = await cache.fetchValues({
+     *   product: 'my-product',
+     *   cache: 'user-cache',
+     *   env: 'production',
+     *   page: 1,
+     *   limit: 20,
+     * });
+     * ```
+     */
+    fetchValues(options: IFetchCacheValuesOptions): Promise<IFetchCacheValuesResult>;
+    /**
+     * Fetch cache dashboard metrics
+     *
+     * @example
+     * ```ts
+     * const dashboard = await cache.fetchDashboard({
+     *   product: 'my-product',
+     *   cache: 'user-cache',
+     *   env: 'production',
+     * });
+     * ```
+     */
+    fetchDashboard(options: IFetchCacheDashboardOptions): Promise<ICacheDashboardMetrics>;
+    /**
+     * Get a cache value by key
+     *
+     * Uses two-tier caching strategy:
+     * 1. Check Redis cache first (fast, local)
+     * 2. On cache miss, fetch from remote and populate Redis
+     *
+     * @example
+     * ```ts
+     * const value = await cache.get({ key: 'user:123' });
+     * if (value) {
+     *   console.log('Cached data:', JSON.parse(value.value));
+     * }
+     * ```
+     */
+    get(options: IGetCacheValueOptions): Promise<ICacheValue | null>;
+    /**
+     * Set a cache value
+     *
+     * Writes to both Redis (local) and remote (persistent) cache
+     *
+     * @example
+     * ```ts
+     * await cache.set({
+     *   product: 'my-product',
+     *   cache: 'user-cache',
+     *   key: 'user:123',
+     *   value: JSON.stringify({ name: 'John', email: 'john@example.com' }),
+     *   expiry: new Date(Date.now() + 3600000), // 1 hour from now
+     * });
+     * ```
+     */
+    set(options: ISetCacheValueOptions): Promise<boolean>;
+    /**
+     * Clear a cache value by key
+     *
+     * Deletes from both Redis (local) and remote (persistent) cache
+     *
+     * @example
+     * ```ts
+     * const cleared = await cache.clear({ key: 'user:123' });
+     * console.log('Cleared:', cleared);
+     * ```
+     */
+    clear(options: IClearCacheValueOptions): Promise<boolean>;
+    /**
+     * Clear all cache values for a product/cache combination
+     *
+     * @example
+     * ```ts
+     * const result = await cache.clearAll({
+     *   product: 'my-product',
+     *   cache: 'user-cache',
+     *   env: 'production',
+     * });
+     * console.log('Cleared:', result.cleared, 'values');
+     * ```
+     */
+    clearAll(options: IClearCacheValuesOptions): Promise<IClearCacheValuesResult>;
+}
+export default CacheService;