@ductape/sdk 0.0.4-v99 → 0.0.5

package/dist/database/databases.service.js

@@ -94,20 +94,22 @@ class DatabaseService {
         this.cacheManager = null;
         /** Private keys cache for products (keyed by product tag) */
         this.privateKeys = new Map();
+        /** Local cache for cache configurations to avoid repeated API calls (5 minute TTL) */
+        this.cacheConfigCache = new Map();
         this.config = config || null;
         this.adapterFactory = new adapter_factory_1.AdapterFactory();
         this.transactionManager = new transaction_manager_1.TransactionManager();
         this.actionManager = new action_manager_1.ActionManager(this);
         this._privateKey = (config === null || config === void 0 ? void 0 : config.private_key) || '';
-        // Initialize CacheManager if Redis client is provided
-        if (config === null || config === void 0 ? void 0 : config.redis_client) {
+        // Initialize CacheManager (Redis is optional - Tier 1 internal cache and Tier 3 remote cache always work)
+        if ((config === null || config === void 0 ? void 0 : config.workspace_id) && (config === null || config === void 0 ? void 0 : config.public_key) && (config === null || config === void 0 ? void 0 : config.user_id) && (config === null || config === void 0 ? void 0 : config.token)) {
             this.cacheManager = new cache_manager_1.CacheManager({
                 workspace_id: config.workspace_id,
                 public_key: config.public_key,
                 user_id: config.user_id,
                 token: config.token,
                 env_type: config.env_type,
-                redis_client: config.redis_client,
+                redis_client: config.redis_client, // Optional - Tier 2 cache
             });
         }
     }
@@ -352,6 +354,28 @@ class DatabaseService {
     getConfig() {
         return this.config;
     }
+    /**
+     * Validate cache tag exists in product and return cache configuration
+     * Uses local in-memory cache to avoid repeated API calls (5 minute TTL)
+     */
+    async validateCache(productTag, cacheTag) {
+        const cacheKey = `${productTag}:${cacheTag}`;
+        const cached = this.cacheConfigCache.get(cacheKey);
+        const now = Date.now();
+        const CACHE_TTL = 5 * 60 * 1000; // 5 minutes
+        // Return cached config if still valid
+        if (cached && (now - cached.fetchedAt) < CACHE_TTL) {
+            return { expiry: cached.expiry };
+        }
+        // Fetch from API and cache the result
+        const builder = await this.getProductBuilder(productTag);
+        const cache = await builder.fetchCache(cacheTag);
+        if (!cache) {
+            throw new database_error_1.DatabaseError(`Cache configuration '${cacheTag}' does not exist`, enums_1.DatabaseErrorType.NOT_FOUND);
+        }
+        this.cacheConfigCache.set(cacheKey, { expiry: cache.expiry, fetchedAt: now });
+        return { expiry: cache.expiry };
+    }
     /**
      * Update the service configuration (used after auth is complete)
      */
@@ -829,7 +853,7 @@ class DatabaseService {
      * });
      */
     async query(options) {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q;
         const process_id = (0, processor_utils_1.generateObjectId)();
         const start = Date.now();
         this.initializeLogService();
@@ -842,7 +866,12 @@ class DatabaseService {
             const privateKey = builder.fetchPrivateKey();
             if (privateKey) {
                 const { processSessionForExecution } = await Promise.resolve().then(() => __importStar(require('../sessions')));
-                const sessionResult = await processSessionForExecution(options.session, privateKey, options, options.env);
+                const sessionResult = await processSessionForExecution(options.session, privateKey, options, options.env, {
+                    fetchSessionSelector: async (sessionTag) => {
+                        const sessionConfig = await builder.fetchSession(sessionTag);
+                        return sessionConfig === null || sessionConfig === void 0 ? void 0 : sessionConfig.selector;
+                    },
+                });
                 if (sessionResult.error) {
                     throw new Error(`Session validation failed: ${sessionResult.error}`);
                 }
@@ -864,24 +893,28 @@ class DatabaseService {
                 include: options.include,
             } }, sessionLogFields);
         (_f = this.logService) === null || _f === void 0 ? void 0 : _f.add(Object.assign(Object.assign({}, baseLogs), { start, message: 'Database query - initiated', status: logs_types_1.LogEventStatus.PROCESSING }));
+        // Check cache if cache tag is provided
+        // Use product from options or from current context (set during connect)
+        const productTag = options.product || ((_g = this.currentContext) === null || _g === void 0 ? void 0 : _g.product);
+        const privateKey = productTag ? this.privateKeys.get(productTag) : undefined;
+        let queryCacheKey;
         try {
-            // Check cache if cache tag is provided
-            const privateKey = options.product ? this.privateKeys.get(options.product) : undefined;
             if (options.cache && this.cacheManager && privateKey) {
                 const cacheOptions = {
                     cache_tag: options.cache,
-                    product_tag: options.product || '',
-                    component_tag: options.database || '',
+                    product_tag: productTag || '',
+                    component_tag: options.database || ((_h = this.currentContext) === null || _h === void 0 ? void 0 : _h.database) || '',
                     component_type: 'database',
                     input: { table: options.table, where: options.where, select: options.select, orderBy: options.orderBy, limit: options.limit, offset: options.offset },
                     privateKey,
                 };
                 const cached = await this.cacheManager.fetch(cacheOptions);
+                queryCacheKey = cached.key;
                 if (cached.hit && cached.data) {
                     const end = Date.now();
-                    (_g = this.logService) === null || _g === void 0 ? void 0 : _g.add(Object.assign(Object.assign({}, baseLogs), { start,
-                        end, message: `Database query - cache hit (${cached.source})`, successful_execution: true, status: logs_types_1.LogEventStatus.SUCCESS }));
-                    (_h = this.logService) === null || _h === void 0 ? void 0 : _h.publish();
+                    (_j = this.logService) === null || _j === void 0 ? void 0 : _j.add(Object.assign(Object.assign({}, baseLogs), { start,
+                        end, message: `Database query - cache hit (${cached.source})`, successful_execution: true, status: logs_types_1.LogEventStatus.SUCCESS, cache_tag: options.cache, cache_key: cached.key, cache_status: true }));
+                    (_k = this.logService) === null || _k === void 0 ? void 0 : _k.publish();
                     return cached.data;
                 }
             }
@@ -890,28 +923,30 @@ class DatabaseService {
             const builtQuery = queryBuilder.buildQuery(resolvedOptions);
             const result = await adapter.query(builtQuery);
             // Store in cache if cache tag is provided
-            if (options.cache && this.cacheManager && privateKey) {
+            if (options.cache && this.cacheManager && privateKey && productTag) {
+                const cacheConfig = await this.validateCache(productTag, options.cache);
                 const cacheOptions = {
                     cache_tag: options.cache,
-                    product_tag: options.product || '',
-                    component_tag: options.database || '',
+                    product_tag: productTag,
+                    component_tag: options.database || ((_l = this.currentContext) === null || _l === void 0 ? void 0 : _l.database) || '',
                     component_type: 'database',
                     input: { table: options.table, where: options.where, select: options.select, orderBy: options.orderBy, limit: options.limit, offset: options.offset },
                     privateKey,
+                    expiry: cacheConfig.expiry,
                 };
-                await this.cacheManager.store(cacheOptions, result);
+                this.cacheManager.store(cacheOptions, result); // Fire-and-forget
             }
             const end = Date.now();
-            (_j = this.logService) === null || _j === void 0 ? void 0 : _j.add(Object.assign(Object.assign({}, baseLogs), { start,
-                end, message: 'Database query - success', successful_execution: true, status: logs_types_1.LogEventStatus.SUCCESS }));
-            (_k = this.logService) === null || _k === void 0 ? void 0 : _k.publish();
+            (_m = this.logService) === null || _m === void 0 ? void 0 : _m.add(Object.assign(Object.assign({}, baseLogs), { start,
+                end, message: options.cache ? 'Database query - cache miss' : 'Database query - success', successful_execution: true, status: logs_types_1.LogEventStatus.SUCCESS, cache_tag: options.cache, cache_key: queryCacheKey }));
+            (_o = this.logService) === null || _o === void 0 ? void 0 : _o.publish();
             return result;
         }
         catch (error) {
             const end = Date.now();
-            (_l = this.logService) === null || _l === void 0 ? void 0 : _l.add(Object.assign(Object.assign({}, baseLogs), { start,
-                end, message: 'Database query - failed', failed_execution: true, data: { table: options.table, operation: 'query', error: String(error) }, status: logs_types_1.LogEventStatus.FAIL }));
-            await ((_m = this.logService) === null || _m === void 0 ? void 0 : _m.publish());
+            (_p = this.logService) === null || _p === void 0 ? void 0 : _p.add(Object.assign(Object.assign({}, baseLogs), { start,
+                end, message: 'Database query - failed', failed_execution: true, data: { table: options.table, operation: 'query', error: String(error) }, status: logs_types_1.LogEventStatus.FAIL, cache_tag: options.cache, cache_key: queryCacheKey }));
+            await ((_q = this.logService) === null || _q === void 0 ? void 0 : _q.publish());
             throw error;
         }
     }
@@ -963,9 +998,10 @@ class DatabaseService {
             },
         };
         (_e = this.logService) === null || _e === void 0 ? void 0 : _e.add(Object.assign(Object.assign({}, baseLogs), { start, message: 'Database raw query - initiated', status: logs_types_1.LogEventStatus.PROCESSING }));
+        // Check cache if cache tag is provided
+        const privateKey = options.product ? this.privateKeys.get(options.product) : undefined;
+        let rawQueryCacheKey;
         try {
-            // Check cache if cache tag is provided
-            const privateKey = options.product ? this.privateKeys.get(options.product) : undefined;
             if (options.cache && this.cacheManager && privateKey) {
                 const cacheOptions = {
                     cache_tag: options.cache,
@@ -976,10 +1012,11 @@ class DatabaseService {
                     privateKey,
                 };
                 const cached = await this.cacheManager.fetch(cacheOptions);
+                rawQueryCacheKey = cached.key;
                 if (cached.hit && cached.data) {
                     const end = Date.now();
                     (_f = this.logService) === null || _f === void 0 ? void 0 : _f.add(Object.assign(Object.assign({}, baseLogs), { start,
-                        end, message: `Database raw query - cache hit (${cached.source})`, successful_execution: true, status: logs_types_1.LogEventStatus.SUCCESS }));
+                        end, message: `Database raw query - cache hit (${cached.source})`, successful_execution: true, status: logs_types_1.LogEventStatus.SUCCESS, cache_tag: options.cache, cache_key: cached.key, cache_status: true }));
                     (_g = this.logService) === null || _g === void 0 ? void 0 : _g.publish();
                     return cached.data;
                 }
@@ -987,27 +1024,29 @@ class DatabaseService {
             const adapter = this.getAdapter(options);
             const result = await adapter.raw(options);
             // Store in cache if cache tag is provided
-            if (options.cache && this.cacheManager && privateKey) {
+            if (options.cache && this.cacheManager && privateKey && options.product) {
+                const cacheConfig = await this.validateCache(options.product, options.cache);
                 const cacheOptions = {
                     cache_tag: options.cache,
-                    product_tag: options.product || '',
+                    product_tag: options.product,
                     component_tag: options.database || '',
                     component_type: 'database',
                     input: { query: options.query, params: options.params, collection: options.collection },
                     privateKey,
+                    expiry: cacheConfig.expiry,
                 };
-                await this.cacheManager.store(cacheOptions, result);
+                this.cacheManager.store(cacheOptions, result); // Fire-and-forget
             }
             const end = Date.now();
             (_h = this.logService) === null || _h === void 0 ? void 0 : _h.add(Object.assign(Object.assign({}, baseLogs), { start,
-                end, message: 'Database raw query - success', successful_execution: true, status: logs_types_1.LogEventStatus.SUCCESS }));
+                end, message: options.cache ? 'Database raw query - cache miss' : 'Database raw query - success', successful_execution: true, status: logs_types_1.LogEventStatus.SUCCESS, cache_tag: options.cache, cache_key: rawQueryCacheKey }));
             (_j = this.logService) === null || _j === void 0 ? void 0 : _j.publish();
             return result;
         }
         catch (error) {
             const end = Date.now();
             (_k = this.logService) === null || _k === void 0 ? void 0 : _k.add(Object.assign(Object.assign({}, baseLogs), { start,
-                end, message: 'Database raw query - failed', failed_execution: true, data: { operation: 'raw', error: String(error) }, status: logs_types_1.LogEventStatus.FAIL }));
+                end, message: 'Database raw query - failed', failed_execution: true, data: { operation: 'raw', error: String(error) }, status: logs_types_1.LogEventStatus.FAIL, cache_tag: options.cache, cache_key: rawQueryCacheKey }));
             await ((_l = this.logService) === null || _l === void 0 ? void 0 : _l.publish());
             throw error;
         }
@@ -1062,7 +1101,12 @@ class DatabaseService {
             const privateKey = builder.fetchPrivateKey();
             if (privateKey) {
                 const { processSessionForExecution } = await Promise.resolve().then(() => __importStar(require('../sessions')));
-                const sessionResult = await processSessionForExecution(options.session, privateKey, options, options.env);
+                const sessionResult = await processSessionForExecution(options.session, privateKey, options, options.env, {
+                    fetchSessionSelector: async (sessionTag) => {
+                        const sessionConfig = await builder.fetchSession(sessionTag);
+                        return sessionConfig === null || sessionConfig === void 0 ? void 0 : sessionConfig.selector;
+                    },
+                });
                 if (sessionResult.error) {
                     throw new Error(`Session validation failed: ${sessionResult.error}`);
                 }
@@ -1138,7 +1182,12 @@ class DatabaseService {
             const privateKey = builder.fetchPrivateKey();
             if (privateKey) {
                 const { processSessionForExecution } = await Promise.resolve().then(() => __importStar(require('../sessions')));
-                const sessionResult = await processSessionForExecution(options.session, privateKey, options, options.env);
+                const sessionResult = await processSessionForExecution(options.session, privateKey, options, options.env, {
+                    fetchSessionSelector: async (sessionTag) => {
+                        const sessionConfig = await builder.fetchSession(sessionTag);
+                        return sessionConfig === null || sessionConfig === void 0 ? void 0 : sessionConfig.selector;
+                    },
+                });
                 if (sessionResult.error) {
                     throw new Error(`Session validation failed: ${sessionResult.error}`);
                 }
@@ -1206,7 +1255,12 @@ class DatabaseService {
             const privateKey = builder.fetchPrivateKey();
             if (privateKey) {
                 const { processSessionForExecution } = await Promise.resolve().then(() => __importStar(require('../sessions')));
-                const sessionResult = await processSessionForExecution(options.session, privateKey, options, options.env);
+                const sessionResult = await processSessionForExecution(options.session, privateKey, options, options.env, {
+                    fetchSessionSelector: async (sessionTag) => {
+                        const sessionConfig = await builder.fetchSession(sessionTag);
+                        return sessionConfig === null || sessionConfig === void 0 ? void 0 : sessionConfig.selector;
+                    },
+                });
                 if (sessionResult.error) {
                     throw new Error(`Session validation failed: ${sessionResult.error}`);
                 }
@@ -1270,7 +1324,12 @@ class DatabaseService {
             const privateKey = builder.fetchPrivateKey();
             if (privateKey) {
                 const { processSessionForExecution } = await Promise.resolve().then(() => __importStar(require('../sessions')));
-                const sessionResult = await processSessionForExecution(options.session, privateKey, options, options.env);
+                const sessionResult = await processSessionForExecution(options.session, privateKey, options, options.env, {
+                    fetchSessionSelector: async (sessionTag) => {
+                        const sessionConfig = await builder.fetchSession(sessionTag);
+                        return sessionConfig === null || sessionConfig === void 0 ? void 0 : sessionConfig.selector;
+                    },
+                });
                 if (sessionResult.error) {
                     throw new Error(`Session validation failed: ${sessionResult.error}`);
                 }
@@ -2037,7 +2096,12 @@ class DatabaseService {
                 const privateKey = builder.fetchPrivateKey();
                 if (privateKey) {
                     const { processSessionForExecution } = await Promise.resolve().then(() => __importStar(require('../sessions')));
-                    const sessionResult = await processSessionForExecution(options.session, privateKey, options, options.env);
+                    const sessionResult = await processSessionForExecution(options.session, privateKey, options, options.env, {
+                        fetchSessionSelector: async (sessionTag) => {
+                            const sessionConfig = await builder.fetchSession(sessionTag);
+                            return sessionConfig === null || sessionConfig === void 0 ? void 0 : sessionConfig.selector;
+                        },
+                    });
                     if (sessionResult.error) {
                         throw new Error(`Session validation failed: ${sessionResult.error}`);
                     }
@@ -2584,6 +2648,57 @@ class DatabaseService {
         }
         return adapter;
     }
+    // ==================== DASHBOARD ====================
+    /**
+     * Fetch database dashboard metrics from logs
+     *
+     * @example
+     * ```ts
+     * const dashboard = await databases.fetchDashboard({
+     *   product: 'my-product',
+     *   database: 'my-database',
+     *   env: 'production',
+     * });
+     * console.log(dashboard.dau, dashboard.activityTimeline);
+     * ```
+     */
+    async fetchDashboard(options) {
+        if (!this.config) {
+            throw new database_error_1.DatabaseError('DatabaseService not configured. Please provide config when initializing.', enums_1.DatabaseErrorType.CONFIGURATION_ERROR);
+        }
+        const { product, database, env } = options;
+        const { LogApiService } = await Promise.resolve().then(() => __importStar(require('../api/services/logsApi.service')));
+        const logsApi = new LogApiService(this.config.env_type);
+        try {
+            const dashboard = await logsApi.fetchDatabaseDashboard({
+                product_tag: product,
+                database_tag: database,
+                env,
+            }, {
+                workspace_id: this.config.workspace_id,
+                user_id: this.config.user_id,
+                public_key: this.config.public_key,
+                token: this.config.token,
+            });
+            return {
+                dau: dashboard.dau || { current: 0, previous: 0, change: 0 },
+                wau: dashboard.wau || { current: 0, previous: 0, change: 0 },
+                mau: dashboard.mau || { current: 0, previous: 0, change: 0 },
+                totalOperations: dashboard.totalOperations || 0,
+                successfulOperations: dashboard.successfulOperations || 0,
+                failedOperations: dashboard.failedOperations || 0,
+                newOperationsThisWeek: dashboard.newOperationsThisWeek || 0,
+                avgExecutionTime: dashboard.avgExecutionTime || { current: '0ms', previous: '0ms', change: 0 },
+                activityTimeline: dashboard.activityTimeline || [],
+                peakHours: dashboard.peakHours || [],
+                environmentBreakdown: dashboard.environmentBreakdown || [],
+                methodBreakdown: dashboard.methodBreakdown || [],
+            };
+        }
+        catch (error) {
+            throw new database_error_1.DatabaseError(`Failed to fetch database dashboard: ${error}`, enums_1.DatabaseErrorType.QUERY_ERROR);
+        }
+    }
 }
 exports.DatabaseService = DatabaseService;
 /**