@ductape/sdk 0.0.4-v51 → 0.0.4-v53

package/dist/cache/cache.service.js

@@ -0,0 +1,437 @@
+"use strict";
+/**
+ * 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
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CacheService = exports.CacheError = void 0;
+const redis_1 = require("redis");
+const products_service_1 = __importDefault(require("../products/services/products.service"));
+const processorApi_service_1 = require("../api/services/processorApi.service");
+/**
+ * Custom error class for cache operations
+ */
+class CacheError extends Error {
+    constructor(message, code, originalError) {
+        super(message);
+        this.code = code;
+        this.originalError = originalError;
+        this.name = 'CacheError';
+    }
+}
+exports.CacheError = CacheError;
+/**
+ * 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' });
+ * ```
+ */
+class CacheService {
+    constructor(config) {
+        this.productId = '';
+        /** Redis client for local caching */
+        this.redisClient = null;
+        /** Whether Redis is connected */
+        this.redisConnected = false;
+        this.workspaceId = config.workspace_id;
+        this.publicKey = config.public_key;
+        this.userId = config.user_id;
+        this.token = config.token;
+        this.envType = config.env_type;
+        this.productBuilderService = new products_service_1.default({
+            workspace_id: this.workspaceId,
+            public_key: this.publicKey,
+            user_id: this.userId,
+            token: this.token,
+            env_type: this.envType,
+        });
+        this.processorApiService = new processorApi_service_1.ProcessorApiService(this.envType);
+    }
+    /**
+     * 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');
+     * ```
+     */
+    async connectRedis(url) {
+        try {
+            this.redisClient = (0, redis_1.createClient)({ url });
+            await this.redisClient.connect();
+            this.redisConnected = true;
+        }
+        catch (error) {
+            this.redisClient = null;
+            this.redisConnected = false;
+            throw new CacheError(`Failed to connect to Redis: ${error}`, 'REDIS_CONNECTION_FAILED', error);
+        }
+    }
+    /**
+     * Disconnect from Redis
+     */
+    async disconnectRedis() {
+        if (this.redisClient && this.redisConnected) {
+            await this.redisClient.quit();
+            this.redisClient = null;
+            this.redisConnected = false;
+        }
+    }
+    /**
+     * Check if Redis is connected
+     */
+    isRedisConnected() {
+        return this.redisConnected;
+    }
+    /**
+     * Update service configuration (used after authentication)
+     */
+    updateConfig(config) {
+        if (config.workspace_id)
+            this.workspaceId = config.workspace_id;
+        if (config.public_key)
+            this.publicKey = config.public_key;
+        if (config.user_id)
+            this.userId = config.user_id;
+        if (config.token)
+            this.token = config.token;
+        if (config.env_type)
+            this.envType = config.env_type;
+        // Re-initialize ProductBuilderService with updated credentials
+        this.productBuilderService = new products_service_1.default({
+            workspace_id: this.workspaceId,
+            public_key: this.publicKey,
+            user_id: this.userId,
+            token: this.token,
+            env_type: this.envType,
+        });
+    }
+    /**
+     * Get user access credentials for API calls
+     */
+    getUserAccess() {
+        return {
+            workspace_id: this.workspaceId,
+            public_key: this.publicKey,
+            user_id: this.userId,
+            token: this.token,
+        };
+    }
+    /**
+     * Fetch paginated cache values
+     *
+     * @example
+     * ```ts
+     * const values = await cache.fetchValues({
+     *   product: 'my-product',
+     *   cache: 'user-cache',
+     *   env: 'production',
+     *   page: 1,
+     *   limit: 20,
+     * });
+     * ```
+     */
+    async fetchValues(options) {
+        const { product, cache: cacheTag, env, page = 1, limit = 20 } = options;
+        try {
+            await this.productBuilderService.initializeProductByTag(product);
+            this.productId = this.productBuilderService.fetchProductId() || '';
+            const result = await this.processorApiService.fetchCacheValues({
+                product_tag: product,
+                cache_tag: cacheTag,
+                env,
+                page,
+                limit,
+            }, this.getUserAccess());
+            return {
+                values: result.values || [],
+                total: result.total || 0,
+                page: result.page || page,
+                limit: result.limit || limit,
+                totalPages: result.totalPages || 0,
+            };
+        }
+        catch (error) {
+            throw new CacheError(`Failed to fetch cache values: ${error}`, 'FETCH_VALUES_FAILED', error);
+        }
+    }
+    /**
+     * Fetch cache dashboard metrics
+     *
+     * @example
+     * ```ts
+     * const dashboard = await cache.fetchDashboard({
+     *   product: 'my-product',
+     *   cache: 'user-cache',
+     *   env: 'production',
+     * });
+     * ```
+     */
+    async fetchDashboard(options) {
+        const { product, cache: cacheTag, env } = options;
+        try {
+            await this.productBuilderService.initializeProductByTag(product);
+            this.productId = this.productBuilderService.fetchProductId() || '';
+            const result = await this.processorApiService.fetchCacheValuesDashboard({
+                product_tag: product,
+                cache_tag: cacheTag,
+                env,
+            }, this.getUserAccess());
+            return {
+                totalValues: result.totalValues || 0,
+                activeValues: result.activeValues || 0,
+                expiredValues: result.expiredValues || 0,
+                totalSize: result.totalSize || 0,
+            };
+        }
+        catch (error) {
+            throw new CacheError(`Failed to fetch cache dashboard: ${error}`, 'FETCH_DASHBOARD_FAILED', error);
+        }
+    }
+    /**
+     * 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));
+     * }
+     * ```
+     */
+    async get(options) {
+        const { key } = options;
+        try {
+            // Step 1: Check Redis cache first (if connected)
+            if (this.redisClient && this.redisConnected) {
+                const redisData = await this.redisClient.hGetAll(key);
+                if (redisData && redisData.value) {
+                    // Check if expired
+                    if (redisData.expiry) {
+                        const expiryTime = new Date(redisData.expiry).getTime();
+                        if (Date.now() > expiryTime) {
+                            // Expired - delete from Redis and continue to remote
+                            await this.redisClient.del(key);
+                        }
+                        else {
+                            // Valid cache hit from Redis
+                            return {
+                                key,
+                                value: redisData.value,
+                                cache_tag: redisData.cache_tag || '',
+                                product_tag: redisData.product_tag || '',
+                                component_tag: redisData.component_tag || '',
+                                component_type: redisData.component_type || '',
+                                expiry: redisData.expiry ? new Date(redisData.expiry) : undefined,
+                            };
+                        }
+                    }
+                    else {
+                        // No expiry set - valid cache hit
+                        return {
+                            key,
+                            value: redisData.value,
+                            cache_tag: redisData.cache_tag || '',
+                            product_tag: redisData.product_tag || '',
+                            component_tag: redisData.component_tag || '',
+                            component_type: redisData.component_type || '',
+                        };
+                    }
+                }
+            }
+            // Step 2: Cache miss - fetch from remote
+            const result = await this.processorApiService.fetchRemoteCacheByKey(key, this.getUserAccess());
+            if (!result) {
+                return null;
+            }
+            // Step 3: Populate Redis cache with remote data (if Redis connected)
+            if (this.redisClient && this.redisConnected) {
+                const hashData = {
+                    value: result.value,
+                    cache_tag: result.cache_tag || '',
+                    product_tag: result.product_tag || '',
+                    component_tag: result.component_tag || '',
+                    component_type: result.component_type || '',
+                };
+                if (result.expiry) {
+                    hashData.expiry = result.expiry.toISOString();
+                }
+                await this.redisClient.hSet(key, hashData);
+                // Set TTL if expiry is defined
+                if (result.expiry) {
+                    const ttlMs = new Date(result.expiry).getTime() - Date.now();
+                    if (ttlMs > 0) {
+                        await this.redisClient.expire(key, Math.ceil(ttlMs / 1000));
+                    }
+                }
+            }
+            return result;
+        }
+        catch (error) {
+            throw new CacheError(`Failed to get cache value: ${error}`, 'GET_VALUE_FAILED', error);
+        }
+    }
+    /**
+     * 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
+     * });
+     * ```
+     */
+    async set(options) {
+        const { product, cache: cacheTag, key, value, componentTag, componentType, expiry } = options;
+        try {
+            // Step 1: Write to Redis cache (if connected)
+            if (this.redisClient && this.redisConnected) {
+                const hashData = {
+                    value,
+                    cache_tag: cacheTag,
+                    product_tag: product,
+                    component_tag: componentTag || cacheTag,
+                    component_type: componentType || 'cache',
+                };
+                if (expiry) {
+                    hashData.expiry = expiry.toISOString();
+                }
+                await this.redisClient.hSet(key, hashData);
+                // Set TTL if expiry is defined
+                if (expiry) {
+                    const ttlMs = expiry.getTime() - Date.now();
+                    if (ttlMs > 0) {
+                        await this.redisClient.expire(key, Math.ceil(ttlMs / 1000));
+                    }
+                }
+            }
+            // Step 2: Write to remote cache (persistent store)
+            const payload = {
+                key,
+                value,
+                cache_tag: cacheTag,
+                product_tag: product,
+                component_tag: componentTag || cacheTag,
+                component_type: componentType || 'cache',
+                expiry,
+            };
+            const result = await this.processorApiService.addToRemoteCache(payload, this.getUserAccess());
+            return result;
+        }
+        catch (error) {
+            throw new CacheError(`Failed to set cache value: ${error}`, 'SET_VALUE_FAILED', error);
+        }
+    }
+    /**
+     * 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);
+     * ```
+     */
+    async clear(options) {
+        const { key } = options;
+        try {
+            // Step 1: Delete from Redis cache (if connected)
+            if (this.redisClient && this.redisConnected) {
+                await this.redisClient.del(key);
+            }
+            // Step 2: Delete from remote cache (persistent store)
+            const result = await this.processorApiService.deleteCacheValue({ key }, this.getUserAccess());
+            return result;
+        }
+        catch (error) {
+            throw new CacheError(`Failed to clear cache value: ${error}`, 'CLEAR_VALUE_FAILED', error);
+        }
+    }
+    /**
+     * 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');
+     * ```
+     */
+    async clearAll(options) {
+        const { product, cache: cacheTag, env } = options;
+        try {
+            await this.productBuilderService.initializeProductByTag(product);
+            this.productId = this.productBuilderService.fetchProductId() || '';
+            const result = await this.processorApiService.deleteCacheValues({
+                product_tag: product,
+                cache_tag: cacheTag,
+                env,
+            }, this.getUserAccess());
+            return {
+                cleared: result.deleted || 0,
+            };
+        }
+        catch (error) {
+            throw new CacheError(`Failed to clear cache values: ${error}`, 'CLEAR_VALUES_FAILED', error);
+        }
+    }
+}
+exports.CacheService = CacheService;
+exports.default = CacheService;
+//# sourceMappingURL=cache.service.js.map

package/dist/cache/cache.service.js.map

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

package/dist/cache/index.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Ductape Cache Module
+ *
+ * Provides a unified API for managing remote cache values including
+ * fetching, setting, and deleting cache entries.
+ *
+ * @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 dashboard metrics
+ * const dashboard = await cache.fetchDashboard({
+ *   product: 'my-product',
+ *   cache: 'user-cache',
+ * });
+ *
+ * // 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' }),
+ * });
+ *
+ * // Delete a value
+ * await cache.delete({ key: 'user:123' });
+ * ```
+ */
+export { CacheService, CacheError } from './cache.service';
+export { default as CacheServiceDefault } from './cache.service';
+export { CacheManager } from './cache.manager';
+export type { ICacheManagerConfig, ICacheOperationOptions, ICacheFetchResult } from './cache.manager';
+export * from './types';

package/dist/cache/index.js

@@ -0,0 +1,79 @@
+"use strict";
+/**
+ * Ductape Cache Module
+ *
+ * Provides a unified API for managing remote cache values including
+ * fetching, setting, and deleting cache entries.
+ *
+ * @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 dashboard metrics
+ * const dashboard = await cache.fetchDashboard({
+ *   product: 'my-product',
+ *   cache: 'user-cache',
+ * });
+ *
+ * // 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' }),
+ * });
+ *
+ * // Delete a value
+ * await cache.delete({ key: 'user:123' });
+ * ```
+ */
+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);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CacheManager = exports.CacheServiceDefault = exports.CacheError = exports.CacheService = void 0;
+// Main service
+var cache_service_1 = require("./cache.service");
+Object.defineProperty(exports, "CacheService", { enumerable: true, get: function () { return cache_service_1.CacheService; } });
+Object.defineProperty(exports, "CacheError", { enumerable: true, get: function () { return cache_service_1.CacheError; } });
+var cache_service_2 = require("./cache.service");
+Object.defineProperty(exports, "CacheServiceDefault", { enumerable: true, get: function () { return __importDefault(cache_service_2).default; } });
+// Cache Manager for executor services
+var cache_manager_1 = require("./cache.manager");
+Object.defineProperty(exports, "CacheManager", { enumerable: true, get: function () { return cache_manager_1.CacheManager; } });
+// Types
+__exportStar(require("./types"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cache/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;;;;;;;;;;;;;;;;;;;;AAEH,eAAe;AACf,iDAA2D;AAAlD,6GAAA,YAAY,OAAA;AAAE,2GAAA,UAAU,OAAA;AACjC,iDAAiE;AAAxD,qIAAA,OAAO,OAAuB;AAEvC,sCAAsC;AACtC,iDAA+C;AAAtC,6GAAA,YAAY,OAAA;AAGrB,QAAQ;AACR,0CAAwB"}

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

@@ -0,0 +1,106 @@
+/**
+ * Cache Types
+ */
+/**
+ * Cache service configuration
+ */
+export interface ICacheServiceConfig {
+    workspace_id: string;
+    public_key: string;
+    user_id: string;
+    token: string;
+    env_type: string;
+}
+/**
+ * Cache value entry
+ */
+export interface ICacheValue {
+    _id?: string;
+    key: string;
+    value: string;
+    cache_tag: string;
+    product_tag: string;
+    component_tag: string;
+    component_type: string;
+    expiry?: Date;
+    createdAt?: Date;
+    updatedAt?: Date;
+}
+/**
+ * Options for fetching paginated cache values
+ */
+export interface IFetchCacheValuesOptions {
+    product: string;
+    cache: string;
+    env?: string;
+    page?: number;
+    limit?: number;
+}
+/**
+ * Result for paginated cache values
+ */
+export interface IFetchCacheValuesResult {
+    values: ICacheValue[];
+    total: number;
+    page: number;
+    limit: number;
+    totalPages: number;
+}
+/**
+ * Options for fetching cache dashboard
+ */
+export interface IFetchCacheDashboardOptions {
+    product: string;
+    cache: string;
+    env?: string;
+}
+/**
+ * Cache dashboard metrics
+ */
+export interface ICacheDashboardMetrics {
+    totalValues: number;
+    activeValues: number;
+    expiredValues: number;
+    totalSize: number;
+}
+/**
+ * Options for clearing a cache value
+ */
+export interface IClearCacheValueOptions {
+    key: string;
+}
+/**
+ * Options for clearing multiple cache values
+ */
+export interface IClearCacheValuesOptions {
+    product: string;
+    cache: string;
+    env?: string;
+}
+/**
+ * Result for clearing multiple cache values
+ */
+export interface IClearCacheValuesResult {
+    cleared: number;
+}
+export type IDeleteCacheValueOptions = IClearCacheValueOptions;
+export type IDeleteCacheValuesOptions = IClearCacheValuesOptions;
+export type IDeleteCacheValuesResult = IClearCacheValuesResult;
+/**
+ * Options for setting a cache value
+ */
+export interface ISetCacheValueOptions {
+    product: string;
+    cache: string;
+    key: string;
+    value: string;
+    componentTag?: string;
+    componentType?: string;
+    expiry?: Date;
+}
+/**
+ * Options for getting a cache value
+ */
+export interface IGetCacheValueOptions {
+    key: string;
+}