@ductape/sdk 0.0.4 → 0.0.6

package/dist/brokers/utils/providers/rabbitmq.service.js

@@ -0,0 +1,138 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RabbitMQService = void 0;
+const amqp = __importStar(require("amqplib"));
+function buildAmqpUrl(config) {
+    var _a, _b, _c, _d;
+    if ('url' in config && typeof config.url === 'string' && config.url.trim()) {
+        const u = config.url.trim();
+        if (u.startsWith('amqp://') || u.startsWith('amqps://'))
+            return u;
+        if (u.startsWith('amqp:') || u.startsWith('amqps:'))
+            return u;
+        return `amqp://${u.startsWith('//') ? u.slice(2) : u}`;
+    }
+    const c = config;
+    const protocol = c.protocol === 'amqps' ? 'amqps' : 'amqp';
+    const host = (_a = c.host) !== null && _a !== void 0 ? _a : 'localhost';
+    const port = (_b = c.port) !== null && _b !== void 0 ? _b : (protocol === 'amqps' ? 5671 : 5672);
+    const vhost = c.vhost != null && c.vhost !== '' ? encodeURIComponent(c.vhost) : '';
+    const auth = c.username != null || c.password != null
+        ? `${encodeURIComponent((_c = c.username) !== null && _c !== void 0 ? _c : '')}:${encodeURIComponent((_d = c.password) !== null && _d !== void 0 ? _d : '')}@`
+        : '';
+    return `${protocol}://${auth}${host}:${port}${vhost ? '/' + vhost : ''}`;
+}
+class RabbitMQService {
+    constructor(config) {
+        this.logPrefix = '[RabbitMQ]';
+        this.connectionUrl = buildAmqpUrl(config);
+    }
+    maskUrl(url) {
+        try {
+            const parsed = new URL(url);
+            if (parsed.password) {
+                parsed.password = '***';
+            }
+            return parsed.toString();
+        }
+        catch (_a) {
+            return '***masked***';
+        }
+    }
+    async connect() {
+        if (!this.connection) {
+            try {
+                this.connection = await amqp.connect(this.connectionUrl);
+                this.channel = await this.connection.createChannel();
+            }
+            catch (error) {
+                throw error;
+            }
+        }
+    }
+    async publish(topic, message) {
+        if (!this.channel) {
+            await this.connect();
+        }
+        try {
+            await this.channel.assertQueue(topic, { durable: true });
+            const messageBuffer = Buffer.from(JSON.stringify(message));
+            this.channel.sendToQueue(topic, messageBuffer, { persistent: true });
+        }
+        catch (error) {
+            throw error;
+        }
+    }
+    async subscribe(topic, callback) {
+        if (!this.channel) {
+            await this.connect();
+        }
+        try {
+            await this.channel.assertQueue(topic, { durable: true });
+            this.channel.consume(topic, async (msg) => {
+                if (msg) {
+                    try {
+                        const content = JSON.parse(msg.content.toString());
+                        await callback(content);
+                        this.channel.ack(msg);
+                    }
+                    catch (error) {
+                        // Note: Message will not be acked, allowing redelivery
+                        throw error;
+                    }
+                }
+            });
+        }
+        catch (error) {
+            throw error;
+        }
+    }
+    async disconnect() {
+        try {
+            if (this.channel) {
+                await this.channel.close();
+            }
+            if (this.connection) {
+                await this.connection.close();
+            }
+        }
+        catch (error) {
+            throw error;
+        }
+    }
+}
+exports.RabbitMQService = RabbitMQService;
+//# sourceMappingURL=rabbitmq.service.js.map

package/dist/brokers/utils/providers/rabbitmq.service.js.map

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

package/dist/{processor/services/messagebrokers → brokers/utils/providers}/redis.service.d.ts

@@ -1,4 +1,4 @@
-import type { IMessageBrokerService } from "./messagebrokers.type";
+import { IMessageBrokerService } from '../../types';
 export declare class RedisService implements IMessageBrokerService {
     private config;
     private client;
@@ -8,11 +8,11 @@ export declare class RedisService implements IMessageBrokerService {
         host: string;
         port: number;
         password?: string;
-        channel: string;
+        channel?: string;
     });
     private loadRedis;
     connect(): Promise<void>;
     publish(topic: string, message: object): Promise<void>;
-    subscribe(topic: string, callback: (message: object) => void): Promise<void>;
+    subscribe(topic: string, callback: (message: object) => Promise<void>): Promise<void>;
     disconnect(): Promise<void>;
 }

package/dist/{processor/services/messagebrokers → brokers/utils/providers}/redis.service.js

@@ -37,12 +37,13 @@ exports.RedisService = void 0;
 class RedisService {
     constructor(config) {
         this.config = config;
-        this.isServer = typeof window === "undefined";
+        this.isServer = typeof window === 'undefined';
     }
     async loadRedis() {
-        if (!this.isServer)
-            throw new Error("RedisService can only be used in a server environment.");
-        const redis = await Promise.resolve().then(() => __importStar(require("redis")));
+        if (!this.isServer) {
+            throw new Error('RedisService can only be used in a server environment');
+        }
+        const redis = await Promise.resolve().then(() => __importStar(require('redis')));
         return redis;
     }
     async connect() {
@@ -58,24 +59,34 @@ class RedisService {
         await this.subscriber.connect();
     }
     async publish(topic, message) {
-        if (!this.isServer)
-            return;
-        await this.connect();
+        if (!this.isServer) {
+            throw new Error('RedisService can only be used in a server environment');
+        }
+        if (!this.client) {
+            await this.connect();
+        }
         await this.client.publish(topic, JSON.stringify(message));
     }
     async subscribe(topic, callback) {
-        if (!this.isServer)
-            return;
-        await this.connect();
-        await this.subscriber.subscribe(topic, (message) => {
-            callback(JSON.parse(message));
+        if (!this.isServer) {
+            throw new Error('RedisService can only be used in a server environment');
+        }
+        if (!this.subscriber) {
+            await this.connect();
+        }
+        await this.subscriber.subscribe(topic, async (message) => {
+            await callback(JSON.parse(message));
         });
     }
     async disconnect() {
         if (!this.isServer)
             return;
-        await this.client.quit();
-        await this.subscriber.quit();
+        if (this.client) {
+            await this.client.quit();
+        }
+        if (this.subscriber) {
+            await this.subscriber.quit();
+        }
     }
 }
 exports.RedisService = RedisService;

package/dist/brokers/utils/providers/redis.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis.service.js","sourceRoot":"","sources":["../../../../src/brokers/utils/providers/redis.service.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEA,MAAa,YAAY;IAKvB,YAAoB,MAA2E;QAA3E,WAAM,GAAN,MAAM,CAAqE;QAC7F,IAAI,CAAC,QAAQ,GAAG,OAAO,MAAM,KAAK,WAAW,CAAC;IAChD,CAAC;IAEO,KAAK,CAAC,SAAS;QACrB,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;QAC3E,CAAC;QACD,MAAM,KAAK,GAAG,wDAAa,OAAO,GAAC,CAAC;QACpC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO;QAE3B,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QAEhD,IAAI,CAAC,MAAM,GAAG,YAAY,CAAC;YACzB,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE;YAC1D,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;SAC/B,CAAC,CAAC;QAEH,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;QAC1C,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QAC5B,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAAa,EAAE,OAAe;QAC1C,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;QAC3E,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACvB,CAAC;QACD,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,SAAS,CACb,KAAa,EACb,QAA4C;QAE5C,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;QAC3E,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACrB,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACvB,CAAC;QACD,MAAM,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,OAAe,EAAE,EAAE;YAC/D,MAAM,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QACtC,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,UAAU;QACd,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO;QAE3B,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAC3B,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;QAC/B,CAAC;IACH,CAAC;CACF;AArED,oCAqEC"}

package/dist/cache/cache.manager.d.ts

@@ -0,0 +1,308 @@
+/**
+ * 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.
+ */
+import type { Redis as IORedisClient } from 'ioredis';
+import { EnvType } from '../types';
+/**
+ * Cache log levels
+ */
+type CacheLogLevel = 'debug' | 'info' | 'warn' | 'error';
+/**
+ * Cache logger configuration
+ */
+interface ICacheLoggerConfig {
+    /** Enable logging */
+    enabled: boolean;
+    /** Minimum log level to display */
+    level: CacheLogLevel;
+    /** Include timestamps */
+    timestamps: boolean;
+    /** Include stack traces for errors */
+    stackTraces: boolean;
+}
+/**
+ * Cache logger for detailed operation tracking
+ */
+export declare class CacheLogger {
+    private config;
+    private readonly levelPriority;
+    constructor(config?: Partial<ICacheLoggerConfig>);
+    setConfig(config: Partial<ICacheLoggerConfig>): void;
+    enable(): void;
+    disable(): void;
+    private shouldLog;
+    private formatMessage;
+    debug(component: string, message: string, data?: Record<string, unknown>): void;
+    info(component: string, message: string, data?: Record<string, unknown>): void;
+    warn(component: string, message: string, data?: Record<string, unknown>): void;
+    error(component: string, message: string, error?: Error, data?: Record<string, unknown>): void;
+    /** Log cache operation with timing */
+    operation(op: string, key: string, startTime: number, result: 'hit' | 'miss' | 'stored' | 'deleted' | 'error', tier: string, data?: Record<string, unknown>): void;
+}
+/** Global cache logger instance */
+export declare const cacheLogger: CacheLogger;
+/**
+ * Cache value wrapper with type information for auto-detection
+ */
+export interface ICacheValueWrapper {
+    /** Type of the cached value */
+    type: 'json' | 'string';
+    /** Serialized value */
+    value: string;
+}
+/**
+ * Cache manager configuration
+ */
+export interface ICacheManagerConfig {
+    workspace_id: string;
+    public_key: string;
+    user_id: string;
+    token: string;
+    env_type: EnvType | string;
+    redis_client?: IORedisClient;
+}
+/**
+ * Component types for cache operations
+ */
+export type CacheComponentType = 'storage' | 'database' | 'graph' | 'vector' | 'session' | 'broker' | 'notification';
+/**
+ * Options for cache operations
+ */
+export interface ICacheOperationOptions {
+    /** Cache tag identifying the cache configuration */
+    cache_tag: string;
+    /** Product tag */
+    product_tag: string;
+    /** Component tag (e.g., storage tag, database tag, session tag) */
+    component_tag: string;
+    /** Component type for reporting and key generation */
+    component_type: CacheComponentType | string;
+    /** Operation name for key generation (e.g., 'create', 'verify', 'publish') */
+    operation?: string;
+    /** Input data to generate cache key from */
+    input: unknown;
+    /** Private key for encryption/decryption */
+    privateKey: string;
+    /** Cache expiry in milliseconds */
+    expiry?: number;
+}
+/**
+ * Cache fetch result
+ */
+export interface ICacheFetchResult<T> {
+    /** Whether cache hit occurred */
+    hit: boolean;
+    /** Cached data (if hit) */
+    data?: T;
+    /** Cache key used */
+    key: string;
+    /** Source of data: 'internal', 'redis', 'remote', or 'miss' */
+    source: 'internal' | 'redis' | 'remote' | 'miss';
+}
+/**
+ * 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 (fire-and-forget - no await needed)
+ * 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);
+ * ```
+ */
+export declare class CacheManager {
+    private config;
+    private redisClient;
+    private processorApiService;
+    /** Internal in-memory cache (Tier 1 - fastest) */
+    private internalCache;
+    /** Maximum number of entries in internal cache before LRU eviction */
+    private maxInternalCacheSize;
+    constructor(config: ICacheManagerConfig);
+    /**
+     * Enable cache logging
+     */
+    enableLogging(config?: {
+        level?: CacheLogLevel;
+        timestamps?: boolean;
+        stackTraces?: boolean;
+    }): void;
+    /**
+     * Disable cache logging
+     */
+    disableLogging(): void;
+    /**
+     * Set maximum size for internal cache
+     */
+    setMaxInternalCacheSize(size: number): void;
+    /**
+     * Clear internal cache
+     */
+    clearInternalCache(): void;
+    /**
+     * Set entry in internal cache with LRU eviction
+     */
+    private setInternalCache;
+    /**
+     * Check if internal cache entry is still valid
+     */
+    private isValidEntry;
+    /**
+     * Wrap value with type information for storage (auto-detect type)
+     */
+    private wrapValue;
+    /**
+     * Unwrap value based on stored type
+     */
+    private unwrapValue;
+    /**
+     * Get user access credentials for API calls
+     */
+    private getUserAccess;
+    /**
+     * Generate cache key from cache tag and input (legacy format)
+     */
+    generateKey(cache_tag: string, input: unknown): string;
+    /**
+     * Generate cache key with new format: cache_tag:component_type:operation:sha256(input)
+     * Includes cache_tag for isolation between different cache configurations
+     */
+    generateKeyV2(options: {
+        cache_tag: string;
+        component_type: string;
+        operation: string;
+        input: unknown;
+    }): string;
+    /**
+     * Generate cache key based on options (uses V2 format if operation provided)
+     */
+    private generateCacheKey;
+    /**
+     * Check if caching is available (Redis client connected)
+     */
+    isAvailable(): boolean;
+    /**
+     * Fetch data from cache (Internal first, then Redis, then remote on miss)
+     *
+     * @returns Cache result with hit status, data, and source
+     */
+    fetch<T>(options: ICacheOperationOptions): Promise<ICacheFetchResult<T>>;
+    /**
+     * Store data in cache (all three tiers: internal, Redis, and remote)
+     */
+    /**
+     * Store data in cache - fire-and-forget pattern.
+     * Internal cache is written synchronously for immediate availability.
+     * Redis and remote cache writes happen asynchronously without blocking.
+     */
+    store<T>(options: ICacheOperationOptions, data: T): void;
+    /**
+     * Internal method to store to Redis and remote cache asynchronously
+     */
+    private storeToExternalTiers;
+    /**
+     * Invalidate/delete data from cache (all three tiers)
+     */
+    invalidate(cache_tag: string, input: unknown): Promise<void>;
+    /**
+     * Invalidate/delete data from cache using options (supports new key format)
+     */
+    invalidateV2(options: ICacheOperationOptions): Promise<void>;
+    /**
+     * 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');
+     *   }
+     * );
+     * ```
+     */
+    withCache<T>(options: ICacheOperationOptions, operation: () => Promise<T>): Promise<{
+        data: T;
+        cached: boolean;
+        source: 'internal' | 'redis' | 'remote' | 'fresh';
+    }>;
+    /**
+     * Get internal cache stats for debugging/monitoring
+     */
+    getInternalCacheStats(): {
+        size: number;
+        maxSize: number;
+        utilizationPercent: number;
+        redisAvailable: boolean;
+    };
+    /**
+     * Get detailed cache statistics including entry ages
+     */
+    getDetailedStats(): {
+        internal: {
+            size: number;
+            maxSize: number;
+            utilizationPercent: number;
+            oldestEntryAge: number | null;
+            newestEntryAge: number | null;
+        };
+        redis: {
+            available: boolean;
+        };
+        remote: {
+            available: boolean;
+        };
+    };
+}
+export default CacheManager;