@common-stack/store-redis 8.2.5-alpha.33 → 8.2.5-alpha.36

package/lib/services/RedisCacheManager.js

@@ -0,0 +1,177 @@
+import {__decorate,__param,__metadata}from'tslib';import {isHashLikeTenantId,sanitizeRedisKeyComponent}from'../core/keyBuilder/sanitize-redis-key.js';import {generateQueryCacheKey}from'../core/keyBuilder/generate-query-cache-key.js';import {print}from'graphql';import {injectable,inject}from'inversify';/**
+ * @file RedisCacheManager.ts
+ * @description Redis-based cache manager for GraphQL query caching
+ *
+ * This implementation provides sophisticated caching for GraphQL operations with:
+ * - Automatic query hashing for cache keys
+ * - Multi-tenant and user isolation
+ * - Wildcard-based cache invalidation
+ * - TTL-based expiration
+ * - Automatic key sanitization (handles Auth0 userIds with pipes)
+ *
+ * Migrated from @adminide-stack/platform-server to be shared across applications
+ */
+var RedisCacheManager_1;
+/**
+ * Redis Cache Manager implementation
+ *
+ * Provides GraphQL query caching with automatic key generation and invalidation
+ */
+let RedisCacheManager = RedisCacheManager_1 = class RedisCacheManager {
+    redisClient;
+    logger;
+    constructor(redisClient, logger) {
+        this.redisClient = redisClient;
+        if (logger) {
+            this.logger = logger.child ? logger.child({ className: RedisCacheManager_1.name }) : logger;
+        }
+    }
+    /**
+     * Delete cached data for a GraphQL query
+     *
+     * @param query - GraphQL query to invalidate
+     * @param variables - Optional variables (if omitted, clears all variants)
+     * @param ctx - Cache context for tenant/user isolation
+     * @param shouldRemoveAll - If true, removes all related cache keys
+     */
+    async del(query, variables, ctx, shouldRemoveAll = false) {
+        const cacheKey = this.getCacheKey(query, variables ?? {}, ctx);
+        // If variables provided, delete exact match
+        if (variables && Object.keys(variables).length > 0) {
+            this.log('debug', `Deleting ${cacheKey} from redis`);
+            await this.redisClient.del(cacheKey);
+            return;
+        }
+        // Build wildcard pattern
+        const keysWithWildCard = shouldRemoveAll
+            ? this.getWildCardQueryKey(query, ctx)
+            : `${cacheKey.substring(0, cacheKey.lastIndexOf(':'))}:*`;
+        const cacheKeys = await this.redisClient.keys(keysWithWildCard);
+        this.log('debug', `Found ${cacheKeys.length} keys against pattern ${keysWithWildCard}`);
+        if (cacheKeys.length) {
+            this.log('debug', `Deleting ${cacheKeys.length} keys from redis`);
+            await this.redisClient.del(...cacheKeys);
+        }
+    }
+    /**
+     * Get cached data for a GraphQL query
+     *
+     * @param query - GraphQL query
+     * @param variables - Query variables
+     * @param ctx - Cache context
+     * @returns Cached data or null if cache miss
+     */
+    async get(query, variables, ctx) {
+        const cacheKey = this.getCacheKey(query, variables, ctx);
+        const cacheResponse = await this.redisClient.get(cacheKey);
+        if (cacheResponse) {
+            try {
+                const { data } = JSON.parse(JSON.parse(cacheResponse)?.value) ?? {};
+                const queryName = this.getQueryName(query);
+                this.log('debug', `Found cache for ${cacheKey}`);
+                return data?.[queryName] ?? null;
+            }
+            catch (error) {
+                this.log('warn', `Failed to parse cache data for ${cacheKey}:`, error);
+                return null;
+            }
+        }
+        this.log('debug', `No cache found for key ${cacheKey}`);
+        return null;
+    }
+    /**
+     * Set cached data for a GraphQL query
+     *
+     * @param query - GraphQL query
+     * @param variables - Query variables
+     * @param data - Data to cache
+     * @param ctx - Cache context
+     * @param cachePolicy - Cache policy (TTL, scope)
+     */
+    async set(query, variables, data, ctx, cachePolicy = { maxAge: 86400, scope: 'PUBLIC' }) {
+        const cacheKey = this.getCacheKey(query, variables, ctx);
+        const cacheTime = Date.now();
+        // Ensure maxAge is not negative or zero
+        const maxAge = Math.max(1, cachePolicy.maxAge);
+        if (cachePolicy.maxAge <= 0) {
+            this.log('warn', `Invalid maxAge (${cachePolicy.maxAge}) for cache key ${cacheKey}, using minimum value of 1 second`);
+        }
+        this.log('debug', `Set cache for key ${cacheKey} with maxAge ${maxAge}`);
+        await this.redisClient.set(cacheKey, JSON.stringify({
+            value: JSON.stringify({
+                data: { [this.getQueryName(query)]: data },
+                cachePolicy: { ...cachePolicy, maxAge },
+                cacheTime,
+            }),
+            expires: cacheTime + maxAge * 1000,
+        }).trim(), 'EX', maxAge);
+    }
+    /**
+     * Extract query name from GraphQL query
+     */
+    getQueryName(query) {
+        const queryStr = typeof query === 'string' ? query : print(query);
+        const [, queryName] = queryStr?.match(/{\s*(\w+)/) ?? [];
+        return queryName;
+    }
+    /**
+     * Build wildcard pattern for query invalidation
+     */
+    getWildCardQueryKey(query, ctx) {
+        const queryStr = typeof query === 'string' ? query : print(query);
+        const [, queryName] = queryStr?.match(/{\s*(\w+)/) ?? [];
+        const { tenantId } = ctx || {};
+        // Build pattern without namespace - just APP_NAME:tenantId:segments
+        const appName = this.getAppName();
+        const sanitizedTenantId = tenantId || 'default';
+        return `${appName}:${sanitizedTenantId}:*:${queryName || '*'}:*`;
+    }
+    /**
+     * Generate cache key for a GraphQL query
+     *
+     * Format: APP_NAME:tenantId:userId:queryName:queryHash:variablesHash
+     */
+    getCacheKey(query, variables, ctx) {
+        // Generate the legacy key WITHOUT tenantId/userId since we'll add them via manual construction
+        const legacyKey = generateQueryCacheKey({
+            query,
+            variables,
+            logger: this.logger,
+        });
+        // Build key without namespace - format: APP_NAME:tenantId:userId:legacyKey
+        const appName = this.getAppName();
+        // Validate tenantId - if it looks like a hash (all hex, 24+ chars), use 'default'
+        let tenantId = ctx?.tenantId || 'default';
+        if (isHashLikeTenantId(tenantId)) {
+            this.log('warn', `TenantId appears to be a hash (${tenantId.substring(0, 16)}...), using "default" instead`);
+            tenantId = 'default';
+        }
+        const userId = ctx?.userId || 'anonymous';
+        // Sanitize components (handles Auth0 userIds like "auth0|123")
+        const sanitizedAppName = sanitizeRedisKeyComponent(appName);
+        const sanitizedTenantId = sanitizeRedisKeyComponent(tenantId);
+        const sanitizedUserId = sanitizeRedisKeyComponent(userId);
+        return `${sanitizedAppName}:${sanitizedTenantId}:${sanitizedUserId}:${legacyKey}`;
+    }
+    /**
+     * Get application name for key prefix
+     * Override this method to provide custom app name
+     */
+    getAppName() {
+        return process.env.APP_NAME || 'COMMON_STACK';
+    }
+    /**
+     * Log helper
+     */
+    log(level, message, ...args) {
+        if (this.logger && typeof this.logger[level] === 'function') {
+            this.logger[level](message, ...args);
+        }
+    }
+};
+RedisCacheManager = RedisCacheManager_1 = __decorate([
+    injectable(),
+    __param(0, inject('REDIS_CLIENT')),
+    __param(1, inject('LOGGER')),
+    __metadata("design:paramtypes", [Function, Object])
+], RedisCacheManager);export{RedisCacheManager};//# sourceMappingURL=RedisCacheManager.js.map

package/lib/services/RedisCacheManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RedisCacheManager.js","sources":["../../src/services/RedisCacheManager.ts"],"sourcesContent":["/**\n * @file RedisCacheManager.ts\n * @description Redis-based cache manager for GraphQL query caching\n *\n * This implementation provides sophisticated caching for GraphQL operations with:\n * - Automatic query hashing for cache keys\n * - Multi-tenant and user isolation\n * - Wildcard-based cache invalidation\n * - TTL-based expiration\n * - Automatic key sanitization (handles Auth0 userIds with pipes)\n *\n * Migrated from @adminide-stack/platform-server to be shared across applications\n */\n\nimport { generateQueryCacheKey, sanitizeRedisKeyComponent, isHashLikeTenantId } from '../core/keyBuilder';\nimport type { Redis } from 'ioredis';\nimport { print } from 'graphql';\nimport type { DocumentNode } from 'graphql';\nimport { injectable, inject } from 'inversify';\nimport type { ICacheContext, ICachePolicy, IRedisCacheManager } from 'common/server';\n\n/**\n * Redis Cache Manager implementation\n *\n * Provides GraphQL query caching with automatic key generation and invalidation\n */\n@injectable()\nexport class RedisCacheManager implements IRedisCacheManager {\n    protected logger?: any;\n\n    constructor(\n        @inject('REDIS_CLIENT')\n        protected readonly redisClient: Redis,\n        @inject('LOGGER')\n        logger?: any,\n    ) {\n        if (logger) {\n            this.logger = logger.child ? logger.child({ className: RedisCacheManager.name }) : logger;\n        }\n    }\n\n    /**\n     * Delete cached data for a GraphQL query\n     *\n     * @param query - GraphQL query to invalidate\n     * @param variables - Optional variables (if omitted, clears all variants)\n     * @param ctx - Cache context for tenant/user isolation\n     * @param shouldRemoveAll - If true, removes all related cache keys\n     */\n    async del(\n        query: string | DocumentNode,\n        variables?: Record<string, unknown>,\n        ctx?: ICacheContext,\n        shouldRemoveAll = false,\n    ): Promise<void> {\n        const cacheKey = this.getCacheKey(query, variables ?? {}, ctx);\n\n        // If variables provided, delete exact match\n        if (variables && Object.keys(variables).length > 0) {\n            this.log('debug', `Deleting ${cacheKey} from redis`);\n            await this.redisClient.del(cacheKey);\n            return;\n        }\n\n        // Build wildcard pattern\n        const keysWithWildCard = shouldRemoveAll\n            ? this.getWildCardQueryKey(query, ctx)\n            : `${cacheKey.substring(0, cacheKey.lastIndexOf(':'))}:*`;\n\n        const cacheKeys = await this.redisClient.keys(keysWithWildCard);\n        this.log('debug', `Found ${cacheKeys.length} keys against pattern ${keysWithWildCard}`);\n\n        if (cacheKeys.length) {\n            this.log('debug', `Deleting ${cacheKeys.length} keys from redis`);\n            await this.redisClient.del(...cacheKeys);\n        }\n    }\n\n    /**\n     * Get cached data for a GraphQL query\n     *\n     * @param query - GraphQL query\n     * @param variables - Query variables\n     * @param ctx - Cache context\n     * @returns Cached data or null if cache miss\n     */\n    async get<T>(\n        query: string | DocumentNode,\n        variables: Record<string, unknown>,\n        ctx: ICacheContext,\n    ): Promise<T | null> {\n        const cacheKey = this.getCacheKey(query, variables, ctx);\n        const cacheResponse = await this.redisClient.get(cacheKey);\n\n        if (cacheResponse) {\n            try {\n                const { data } = JSON.parse(JSON.parse(cacheResponse)?.value) ?? {};\n                const queryName = this.getQueryName(query);\n                this.log('debug', `Found cache for ${cacheKey}`);\n                return data?.[queryName] ?? null;\n            } catch (error) {\n                this.log('warn', `Failed to parse cache data for ${cacheKey}:`, error);\n                return null;\n            }\n        }\n\n        this.log('debug', `No cache found for key ${cacheKey}`);\n        return null;\n    }\n\n    /**\n     * Set cached data for a GraphQL query\n     *\n     * @param query - GraphQL query\n     * @param variables - Query variables\n     * @param data - Data to cache\n     * @param ctx - Cache context\n     * @param cachePolicy - Cache policy (TTL, scope)\n     */\n    async set<T>(\n        query: string | DocumentNode,\n        variables: Record<string, unknown>,\n        data: T,\n        ctx: ICacheContext,\n        cachePolicy: ICachePolicy = { maxAge: 86400, scope: 'PUBLIC' },\n    ): Promise<void> {\n        const cacheKey = this.getCacheKey(query, variables, ctx);\n        const cacheTime = Date.now();\n\n        // Ensure maxAge is not negative or zero\n        const maxAge = Math.max(1, cachePolicy.maxAge);\n\n        if (cachePolicy.maxAge <= 0) {\n            this.log(\n                'warn',\n                `Invalid maxAge (${cachePolicy.maxAge}) for cache key ${cacheKey}, using minimum value of 1 second`,\n            );\n        }\n\n        this.log('debug', `Set cache for key ${cacheKey} with maxAge ${maxAge}`);\n\n        await this.redisClient.set(\n            cacheKey,\n            JSON.stringify({\n                value: JSON.stringify({\n                    data: { [this.getQueryName(query)]: data },\n                    cachePolicy: { ...cachePolicy, maxAge },\n                    cacheTime,\n                }),\n                expires: cacheTime + maxAge * 1000,\n            }).trim(),\n            'EX',\n            maxAge,\n        );\n    }\n\n    /**\n     * Extract query name from GraphQL query\n     */\n    private getQueryName(query: string | DocumentNode): string {\n        const queryStr = typeof query === 'string' ? query : print(query);\n        const [, queryName] = queryStr?.match(/{\\s*(\\w+)/) ?? [];\n        return queryName;\n    }\n\n    /**\n     * Build wildcard pattern for query invalidation\n     */\n    private getWildCardQueryKey(query: string | DocumentNode, ctx?: ICacheContext): string {\n        const queryStr = typeof query === 'string' ? query : print(query);\n        const [, queryName] = queryStr?.match(/{\\s*(\\w+)/) ?? [];\n        const { tenantId } = ctx || {};\n\n        // Build pattern without namespace - just APP_NAME:tenantId:segments\n        const appName = this.getAppName();\n        const sanitizedTenantId = tenantId || 'default';\n        return `${appName}:${sanitizedTenantId}:*:${queryName || '*'}:*`;\n    }\n\n    /**\n     * Generate cache key for a GraphQL query\n     *\n     * Format: APP_NAME:tenantId:userId:queryName:queryHash:variablesHash\n     */\n    private getCacheKey(query: string | DocumentNode, variables: Record<string, unknown>, ctx?: ICacheContext): string {\n        // Generate the legacy key WITHOUT tenantId/userId since we'll add them via manual construction\n        const legacyKey = generateQueryCacheKey({\n            query,\n            variables,\n            logger: this.logger,\n        });\n\n        // Build key without namespace - format: APP_NAME:tenantId:userId:legacyKey\n        const appName = this.getAppName();\n\n        // Validate tenantId - if it looks like a hash (all hex, 24+ chars), use 'default'\n        let tenantId = ctx?.tenantId || 'default';\n        if (isHashLikeTenantId(tenantId)) {\n            this.log(\n                'warn',\n                `TenantId appears to be a hash (${tenantId.substring(0, 16)}...), using \"default\" instead`,\n            );\n            tenantId = 'default';\n        }\n\n        const userId = ctx?.userId || 'anonymous';\n\n        // Sanitize components (handles Auth0 userIds like \"auth0|123\")\n        const sanitizedAppName = sanitizeRedisKeyComponent(appName);\n        const sanitizedTenantId = sanitizeRedisKeyComponent(tenantId);\n        const sanitizedUserId = sanitizeRedisKeyComponent(userId);\n\n        return `${sanitizedAppName}:${sanitizedTenantId}:${sanitizedUserId}:${legacyKey}`;\n    }\n\n    /**\n     * Get application name for key prefix\n     * Override this method to provide custom app name\n     */\n    protected getAppName(): string {\n        return process.env.APP_NAME || 'COMMON_STACK';\n    }\n\n    /**\n     * Log helper\n     */\n    private log(level: string, message: string, ...args: any[]): void {\n        if (this.logger && typeof this.logger[level] === 'function') {\n            this.logger[level](message, ...args);\n        }\n    }\n}\n"],"names":[],"mappings":"+SAAA;;;;;;;;;;;;AAYG;;AASH;;;;AAIG;AAEU,IAAA,iBAAiB,GAAvB,mBAAA,GAAA,MAAM,iBAAiB,CAAA;AAKH,IAAA,WAAA,CAAA;AAJb,IAAA,MAAM,CAAO;IAEvB,WAEuB,CAAA,WAAkB,EAErC,MAAY,EAAA;QAFO,IAAW,CAAA,WAAA,GAAX,WAAW,CAAO;QAIrC,IAAI,MAAM,EAAE;YACR,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,mBAAiB,CAAC,IAAI,EAAE,CAAC,GAAG,MAAM,CAAC;SAC7F;KACJ;AAED;;;;;;;AAOG;IACH,MAAM,GAAG,CACL,KAA4B,EAC5B,SAAmC,EACnC,GAAmB,EACnB,eAAe,GAAG,KAAK,EAAA;AAEvB,QAAA,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,EAAE,GAAG,CAAC,CAAC;;AAG/D,QAAA,IAAI,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE;YAChD,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAY,SAAA,EAAA,QAAQ,CAAa,WAAA,CAAA,CAAC,CAAC;YACrD,MAAM,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACrC,OAAO;SACV;;QAGD,MAAM,gBAAgB,GAAG,eAAe;cAClC,IAAI,CAAC,mBAAmB,CAAC,KAAK,EAAE,GAAG,CAAC;AACtC,cAAE,CAAG,EAAA,QAAQ,CAAC,SAAS,CAAC,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;QAE9D,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;AAChE,QAAA,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAA,MAAA,EAAS,SAAS,CAAC,MAAM,CAAA,sBAAA,EAAyB,gBAAgB,CAAA,CAAE,CAAC,CAAC;AAExF,QAAA,IAAI,SAAS,CAAC,MAAM,EAAE;YAClB,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAY,SAAA,EAAA,SAAS,CAAC,MAAM,CAAkB,gBAAA,CAAA,CAAC,CAAC;YAClE,MAAM,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC;SAC5C;KACJ;AAED;;;;;;;AAOG;AACH,IAAA,MAAM,GAAG,CACL,KAA4B,EAC5B,SAAkC,EAClC,GAAkB,EAAA;AAElB,QAAA,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;QACzD,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAE3D,IAAI,aAAa,EAAE;AACf,YAAA,IAAI;AACA,gBAAA,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;gBACpE,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;gBAC3C,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAmB,gBAAA,EAAA,QAAQ,CAAE,CAAA,CAAC,CAAC;AACjD,gBAAA,OAAO,IAAI,GAAG,SAAS,CAAC,IAAI,IAAI,CAAC;aACpC;YAAC,OAAO,KAAK,EAAE;gBACZ,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAkC,+BAAA,EAAA,QAAQ,CAAG,CAAA,CAAA,EAAE,KAAK,CAAC,CAAC;AACvE,gBAAA,OAAO,IAAI,CAAC;aACf;SACJ;QAED,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAA0B,uBAAA,EAAA,QAAQ,CAAE,CAAA,CAAC,CAAC;AACxD,QAAA,OAAO,IAAI,CAAC;KACf;AAED;;;;;;;;AAQG;IACH,MAAM,GAAG,CACL,KAA4B,EAC5B,SAAkC,EAClC,IAAO,EACP,GAAkB,EAClB,WAA4B,GAAA,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAA;AAE9D,QAAA,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;AACzD,QAAA,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;;AAG7B,QAAA,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;AAE/C,QAAA,IAAI,WAAW,CAAC,MAAM,IAAI,CAAC,EAAE;AACzB,YAAA,IAAI,CAAC,GAAG,CACJ,MAAM,EACN,CAAA,gBAAA,EAAmB,WAAW,CAAC,MAAM,CAAA,gBAAA,EAAmB,QAAQ,CAAA,iCAAA,CAAmC,CACtG,CAAC;SACL;QAED,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAqB,kBAAA,EAAA,QAAQ,CAAgB,aAAA,EAAA,MAAM,CAAE,CAAA,CAAC,CAAC;QAEzE,MAAM,IAAI,CAAC,WAAW,CAAC,GAAG,CACtB,QAAQ,EACR,IAAI,CAAC,SAAS,CAAC;AACX,YAAA,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC;AAClB,gBAAA,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,IAAI,EAAE;AAC1C,gBAAA,WAAW,EAAE,EAAE,GAAG,WAAW,EAAE,MAAM,EAAE;gBACvC,SAAS;aACZ,CAAC;AACF,YAAA,OAAO,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI;SACrC,CAAC,CAAC,IAAI,EAAE,EACT,IAAI,EACJ,MAAM,CACT,CAAC;KACL;AAED;;AAEG;AACK,IAAA,YAAY,CAAC,KAA4B,EAAA;AAC7C,QAAA,MAAM,QAAQ,GAAG,OAAO,KAAK,KAAK,QAAQ,GAAG,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;AAClE,QAAA,MAAM,GAAG,SAAS,CAAC,GAAG,QAAQ,EAAE,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;AACzD,QAAA,OAAO,SAAS,CAAC;KACpB;AAED;;AAEG;IACK,mBAAmB,CAAC,KAA4B,EAAE,GAAmB,EAAA;AACzE,QAAA,MAAM,QAAQ,GAAG,OAAO,KAAK,KAAK,QAAQ,GAAG,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;AAClE,QAAA,MAAM,GAAG,SAAS,CAAC,GAAG,QAAQ,EAAE,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;AACzD,QAAA,MAAM,EAAE,QAAQ,EAAE,GAAG,GAAG,IAAI,EAAE,CAAC;;AAG/B,QAAA,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;AAClC,QAAA,MAAM,iBAAiB,GAAG,QAAQ,IAAI,SAAS,CAAC;QAChD,OAAO,CAAA,EAAG,OAAO,CAAI,CAAA,EAAA,iBAAiB,MAAM,SAAS,IAAI,GAAG,CAAA,EAAA,CAAI,CAAC;KACpE;AAED;;;;AAIG;AACK,IAAA,WAAW,CAAC,KAA4B,EAAE,SAAkC,EAAE,GAAmB,EAAA;;QAErG,MAAM,SAAS,GAAG,qBAAqB,CAAC;YACpC,KAAK;YACL,SAAS;YACT,MAAM,EAAE,IAAI,CAAC,MAAM;AACtB,SAAA,CAAC,CAAC;;AAGH,QAAA,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;;AAGlC,QAAA,IAAI,QAAQ,GAAG,GAAG,EAAE,QAAQ,IAAI,SAAS,CAAC;AAC1C,QAAA,IAAI,kBAAkB,CAAC,QAAQ,CAAC,EAAE;AAC9B,YAAA,IAAI,CAAC,GAAG,CACJ,MAAM,EACN,kCAAkC,QAAQ,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA,6BAAA,CAA+B,CAC7F,CAAC;YACF,QAAQ,GAAG,SAAS,CAAC;SACxB;AAED,QAAA,MAAM,MAAM,GAAG,GAAG,EAAE,MAAM,IAAI,WAAW,CAAC;;AAG1C,QAAA,MAAM,gBAAgB,GAAG,yBAAyB,CAAC,OAAO,CAAC,CAAC;AAC5D,QAAA,MAAM,iBAAiB,GAAG,yBAAyB,CAAC,QAAQ,CAAC,CAAC;AAC9D,QAAA,MAAM,eAAe,GAAG,yBAAyB,CAAC,MAAM,CAAC,CAAC;QAE1D,OAAO,CAAA,EAAG,gBAAgB,CAAI,CAAA,EAAA,iBAAiB,IAAI,eAAe,CAAA,CAAA,EAAI,SAAS,CAAA,CAAE,CAAC;KACrF;AAED;;;AAGG;IACO,UAAU,GAAA;AAChB,QAAA,OAAO,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,cAAc,CAAC;KACjD;AAED;;AAEG;AACK,IAAA,GAAG,CAAC,KAAa,EAAE,OAAe,EAAE,GAAG,IAAW,EAAA;AACtD,QAAA,IAAI,IAAI,CAAC,MAAM,IAAI,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,UAAU,EAAE;YACzD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;SACxC;KACJ;EACJ;AA5MY,iBAAiB,GAAA,mBAAA,GAAA,UAAA,CAAA;AAD7B,IAAA,UAAU,EAAE;AAKJ,IAAA,OAAA,CAAA,CAAA,EAAA,MAAM,CAAC,cAAc,CAAC,CAAA;AAEtB,IAAA,OAAA,CAAA,CAAA,EAAA,MAAM,CAAC,QAAQ,CAAC,CAAA;;AANZ,CAAA,EAAA,iBAAiB,CA4M7B"}

package/lib/services/index.d.ts

@@ -1,8 +1,4 @@
 /**
  * Redis service implementations
- *
- * Note: Actual implementations will be migrated from:
- * - @adminide-stack/platform-server/RedisCacheManager
- * - @adminide-stack/auth0-server-core/RedisStorageBackend
  */
-export {};
+export * from './RedisCacheManager';

package/lib/templates/constants/SERVER_TYPES.ts.template

@@ -1,7 +1,6 @@
 export const SERVER_TYPES = {
     RedisClient: Symbol.for('RedisClient'),
     RedisCacheManager: Symbol.for('RedisCacheManager'),
-    RedisStorageBackend: Symbol.for('RedisStorageBackend'),
     RedisConnectionPool: Symbol.for('RedisConnectionPool'),
     RedisKeyBuilder: Symbol.for('RedisKeyBuilder'),
 };

package/lib/templates/repositories/IRedisKeyBuilder.ts.template

@@ -22,11 +22,11 @@
  * This pattern helps prevent key collisions, makes debugging easier, and enables
  * efficient bulk operations through pattern matching.
  *
- * @see RedisKeyOptions - Configuration for key building
+ * @see IRedisKeyOptions - Configuration for key building
  * @see RedisNamespace - Standard namespaces for key organization
  */
 
-import { RedisKeyOptions } from './redisCommonTypes';
+import { IRedisKeyOptions } from 'common/server';
 
 export interface IRedisKeyBuilder {
     /**
@@ -56,7 +56,7 @@ export interface IRedisKeyBuilder {
      * });
      * // Result: "APP_NAME:tenant-123:user-456:session:session-789"
      */
-    buildKey(options: RedisKeyOptions): string;
+    buildKey(options: IRedisKeyOptions): string;
 
     /**
      * Build a Redis key pattern for wildcard matching
@@ -82,7 +82,7 @@ export interface IRedisKeyBuilder {
      *   segments: ['*']
      * });
      */
-    buildPattern(options: RedisKeyOptions): string;
+    buildPattern(options: IRedisKeyOptions): string;
 
     /**
      * Sanitize a key component to ensure it's valid and safe

package/lib/templates/repositories/redisCommonTypes.ts.template

@@ -5,109 +5,15 @@
  * These types provide a standardized approach to working with Redis operations, including
  * key management, caching, and storage patterns.
  *
- * Key components include:
- * - RedisKeyOptions: Configuration for building standardized Redis keys
- * - RedisNamespace: Enum for organizing keys into logical namespaces
- * - CacheContext: Context information for cache operations (tenant, user, org)
- * - CachePolicy: Configuration for cache TTL and scope
- * - RedisValue: Union type for values that can be stored in Redis
- * - RedisHashValue: Type for Redis hash field values
- * - RedisScanOptions: Options for scanning Redis keys
- *
- * These types ensure consistency across Redis operations, providing type safety and
- * clear contracts for data caching and storage throughout the application.
+ * Most types are generated from GraphQL schema via codegen.
+ * Additional runtime types (RedisValue, RedisHashValue) are defined here.
  *
  * @see IRedisCacheManager - Cache manager interface using these types
  * @see IRedisStorageBackend - Storage backend interface using these types
  * @see IRedisKeyBuilder - Key builder interface using these types
  */
 
-/**
- * Options for building Redis keys with standardized format
- * 
- * @property tenantId - Tenant ID for multi-tenant isolation (defaults to 'default')
- * @property namespace - Namespace to categorize keys (e.g., 'cache', 'session', 'storage')
- * @property segments - Additional key segments to append
- * @property userId - Optional user ID for user-specific keys
- * 
- * @example
- * const keyOptions: RedisKeyOptions = {
- *   tenantId: 'tenant-123',
- *   namespace: RedisNamespace.CACHE,
- *   segments: ['user', 'profile']
- * };
- * // Produces key: APP_NAME:tenant-123:cache:user:profile
- */
-export interface RedisKeyOptions {
-    tenantId?: string;
-    namespace: string;
-    segments: string[];
-    userId?: string;
-}
-
-/**
- * Standard Redis namespaces for organizing keys
- * Using namespaces helps prevent key collisions and makes bulk operations easier
- * 
- * @example
- * // Use namespaces to organize cache keys
- * const cacheKey = buildRedisKey({
- *   tenantId: 'tenant-123',
- *   namespace: RedisNamespace.CACHE,
- *   segments: ['query', 'users']
- * });
- */
-export enum RedisNamespace {
-    CACHE = 'cache',
-    SESSION = 'session',
-    TENANT = 'tenant',
-    CONFIG = 'config',
-    EXTENSION = 'extension',
-    CONTRIBUTION = 'contribution',
-    STORAGE = 'storage',
-    PERMISSION = 'permission',
-    TEMP = 'temp',
-    QUEUE = 'queue',
-    LOCK = 'lock',
-}
-
-/**
- * Context for cache operations
- * Provides tenant, user, and organization isolation for cached data
- * 
- * @property tenantId - Tenant identifier for multi-tenant applications
- * @property userId - User identifier for user-specific caching
- * @property orgId - Organization identifier for org-level caching
- * 
- * @example
- * const ctx: CacheContext = {
- *   tenantId: 'tenant-123',
- *   userId: 'user-456',
- *   orgId: 'org-789'
- * };
- */
-export interface CacheContext {
-    tenantId?: string;
-    userId?: string;
-    orgId?: string;
-}
 
-/**
- * Cache policy for controlling cache behavior
- * 
- * @property maxAge - Maximum age in seconds (TTL)
- * @property scope - Cache scope (PUBLIC, PRIVATE, etc.)
- * 
- * @example
- * const policy: CachePolicy = {
- *   maxAge: 3600, // 1 hour
- *   scope: 'PRIVATE'
- * };
- */
-export interface CachePolicy {
-    maxAge: number;
-    scope?: string;
-}
 
 /**
  * Union type for values that can be stored in Redis
@@ -120,70 +26,3 @@ export type RedisValue = string | number | Buffer | null;
  * Hashes in Redis store field-value pairs
  */
 export type RedisHashValue = Record<string, string>;
-
-/**
- * Options for scanning Redis keys
- * Used for iterating through keys matching a pattern
- * 
- * @property match - Pattern to match keys (supports wildcards)
- * @property count - Number of keys to return per iteration
- * @property type - Optional Redis data type to filter by
- * 
- * @example
- * const scanOptions: RedisScanOptions = {
- *   match: 'APP:tenant-*:cache:*',
- *   count: 100,
- *   type: 'string'
- * };
- */
-export interface RedisScanOptions {
-    match?: string;
-    count?: number;
-    type?: 'string' | 'list' | 'set' | 'zset' | 'hash' | 'stream';
-}
-
-/**
- * Result from a Redis SCAN operation
- * 
- * @property cursor - Next cursor position (0 means scan is complete)
- * @property keys - Array of keys matching the scan criteria
- */
-export interface RedisScanResult {
-    cursor: string;
-    keys: string[];
-}
-
-/**
- * Options for Redis bulk operations
- * Used when performing operations on multiple keys
- * 
- * @property pipeline - Whether to use Redis pipeline for batch operations
- * @property transaction - Whether to wrap operations in a MULTI/EXEC transaction
- */
-export interface RedisBulkOptions {
-    pipeline?: boolean;
-    transaction?: boolean;
-}
-
-/**
- * Redis connection configuration
- * 
- * @property host - Redis server host
- * @property port - Redis server port
- * @property password - Optional password for authentication
- * @property db - Database number to use
- * @property keyPrefix - Prefix to add to all keys
- * @property maxRetriesPerRequest - Maximum retry attempts
- * @property enableReadyCheck - Whether to check connection is ready
- * @property lazyConnect - Whether to delay connection until first command
- */
-export interface RedisConnectionConfig {
-    host?: string;
-    port?: number;
-    password?: string;
-    db?: number;
-    keyPrefix?: string;
-    maxRetriesPerRequest?: number;
-    enableReadyCheck?: boolean;
-    lazyConnect?: boolean;
-}

package/lib/templates/{repositories/IRedisCacheManager.ts.template → services/RedisCacheManager.ts.template}

@@ -24,12 +24,12 @@
  * while maintaining cache correctness through intelligent invalidation strategies.
  *
  * @see IRedisStorageBackend - For simpler key-value storage
- * @see CachePolicy - For cache TTL and scope configuration
- * @see CacheContext - For tenant/user isolation
+ * @see ICachePolicy - For cache TTL and scope configuration
+ * @see ICacheContext - For tenant/user isolation
  */
 
 import type { DocumentNode } from 'graphql';
-import { CacheContext, CachePolicy } from './redisCommonTypes';
+import { ICacheContext, ICachePolicy } from 'common/server';
 
 export interface IRedisCacheManager {
     /**
@@ -60,7 +60,7 @@ export interface IRedisCacheManager {
     get<T>(
         query: string | DocumentNode,
         variables: Record<string, any>,
-        ctx: CacheContext
+        ctx: ICacheContext
     ): Promise<T | null>;
 
     /**
@@ -97,8 +97,8 @@ export interface IRedisCacheManager {
         query: string | DocumentNode,
         variables: Record<string, any>,
         data: T,
-        ctx: CacheContext,
-        cachePolicy?: CachePolicy
+        ctx: ICacheContext,
+        cachePolicy?: ICachePolicy
     ): Promise<void>;
 
     /**
@@ -143,7 +143,7 @@ export interface IRedisCacheManager {
     del(
         query: string | DocumentNode,
         variables?: Record<string, unknown>,
-        ctx?: CacheContext,
+        ctx?: ICacheContext,
         shouldRemoveAll?: boolean
     ): Promise<void>;
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@common-stack/store-redis",
-    "version": "8.2.5-alpha.33",
+    "version": "8.2.5-alpha.36",
     "description": "Redis store utilities and services for common-stack",
     "license": "UNLICENSED",
     "author": "CDMBase LLC",
@@ -24,13 +24,14 @@
         "watch": "npm run build:lib:watch"
     },
     "dependencies": {
-        "@common-stack/core": "8.2.5-alpha.15"
+        "@common-stack/core": "8.2.5-alpha.35"
     },
     "devDependencies": {
-        "common": "8.2.5-alpha.15",
+        "common": "8.2.5-alpha.35",
         "ioredis": "^5.3.2"
     },
     "peerDependencies": {
+        "graphql": ">=16.0.0",
         "inversify": "*",
         "ioredis": ">=5.0.0"
     },
@@ -44,15 +45,15 @@
             ],
             "repositories": [
                 "./${libDir}/templates/repositories/IRedisKeyBuilder.ts.template",
-                "./${libDir}/templates/repositories/IRedisStorageBackend.ts.template",
-                "./${libDir}/templates/repositories/IRedisCacheManager.ts.template",
-                "./${libDir}/templates/repositories/IRedisService.ts.template",
                 "./${libDir}/templates/repositories/redisCommonTypes.ts.template"
+            ],
+            "services": [
+                "./${libDir}/templates/services/RedisCacheManager.ts.template"
             ]
         }
     },
     "typescript": {
         "definition": "lib/index.d.ts"
     },
-    "gitHead": "5745649eba49ac589b9ace8c55378b6cbe130096"
+    "gitHead": "073ba112d0d673927cca535e7805946fe30880d4"
 }

package/lib/interfaces/cache-manager.d.ts

@@ -1,28 +0,0 @@
-import type { DocumentNode } from 'graphql';
-import type { CacheContext } from './redis-key-options';
-/**
- * Cache policy for controlling cache behavior
- */
-export interface CachePolicy {
-    /** Maximum age in seconds */
-    maxAge: number;
-    /** Cache scope (PUBLIC, PRIVATE, etc.) */
-    scope?: string;
-}
-/**
- * Redis cache manager interface for GraphQL query caching
- */
-export interface IRedisCacheManager {
-    /**
-     * Get cached data for a query
-     */
-    get<T>(query: string | DocumentNode, variables: Record<string, any>, ctx: CacheContext): Promise<T | null>;
-    /**
-     * Set cached data for a query
-     */
-    set<T>(query: string | DocumentNode, variables: Record<string, any>, data: T, ctx: CacheContext, cachePolicy?: CachePolicy): Promise<void>;
-    /**
-     * Delete cached data for a query
-     */
-    del(query: string | DocumentNode, variables?: Record<string, unknown>, ctx?: CacheContext, shouldRemoveAll?: boolean): Promise<void>;
-}

package/lib/interfaces/redis-key-options.d.ts

@@ -1,35 +0,0 @@
-/**
- * Options for building Redis keys with standardized format
- */
-export interface RedisKeyOptions {
-    /** Tenant ID for multi-tenant isolation */
-    tenantId?: string;
-    /** Namespace to categorize keys (e.g., 'cache', 'session', 'storage') */
-    namespace: string;
-    /** Additional key segments to append */
-    segments: string[];
-    /** Optional user ID for user-specific keys */
-    userId?: string;
-}
-/**
- * Standard Redis namespaces for organizing keys
- */
-export declare enum RedisNamespace {
-    CACHE = "cache",
-    SESSION = "session",
-    TENANT = "tenant",
-    CONFIG = "config",
-    EXTENSION = "extension",
-    CONTRIBUTION = "contribution",
-    STORAGE = "storage",
-    PERMISSION = "permission",
-    TEMP = "temp"
-}
-/**
- * Context for cache operations
- */
-export interface CacheContext {
-    tenantId?: string;
-    userId?: string;
-    orgId?: string;
-}

package/lib/interfaces/redis-key-options.js

@@ -1,17 +0,0 @@
-/**
- * Standard Redis namespaces for organizing keys
- */
-var RedisNamespace;
-(function (RedisNamespace) {
-    RedisNamespace["CACHE"] = "cache";
-    RedisNamespace["SESSION"] = "session";
-    RedisNamespace["TENANT"] = "tenant";
-    RedisNamespace["CONFIG"] = "config";
-    RedisNamespace["EXTENSION"] = "extension";
-    RedisNamespace["CONTRIBUTION"] = "contribution";
-    RedisNamespace["STORAGE"] = "storage";
-    RedisNamespace["PERMISSION"] = "permission";
-    RedisNamespace["TEMP"] = "temp";
-})(RedisNamespace || (RedisNamespace = {}));
-
-export { RedisNamespace };

package/lib/interfaces/storage-backend.d.ts

@@ -1,17 +0,0 @@
-/**
- * Generic storage backend interface for simple key-value operations
- */
-export interface IStorageBackend {
-    /**
-     * Get a value by key
-     */
-    get(key: string): Promise<string | null>;
-    /**
-     * Set a value for a key
-     */
-    set(key: string, value: string): Promise<void>;
-    /**
-     * Clear all keys in this storage
-     */
-    clear(): Promise<void>;
-}