@qwickapps/server 1.7.0 → 1.7.2

package/dist/src/plugins/bans/stores/in-memory-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-store.js","sourceRoot":"","sources":["../../../../../src/plugins/bans/stores/in-memory-store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,UAAU,sBAAsB;IACpC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAe,CAAC;IACpC,IAAI,SAAS,GAAG,CAAC,CAAC;IAElB,SAAS,WAAW,CAAC,GAAQ;QAC3B,IAAI,CAAC,GAAG,CAAC,SAAS;YAAE,OAAO,KAAK,CAAC;QACjC,IAAI,GAAG,CAAC,UAAU,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,IAAI,IAAI,EAAE;YAAE,OAAO,KAAK,CAAC;QAC3E,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,IAAI,EAAE,WAAW;QAEjB,KAAK,CAAC,UAAU;YACd,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;QAChD,CAAC;QAED,KAAK,CAAC,QAAQ,CAAC,MAAc;YAC3B,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;gBAChC,IAAI,GAAG,CAAC,OAAO,KAAK,MAAM,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;oBAC/C,OAAO,IAAI,CAAC;gBACd,CAAC;YACH,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,KAAK,CAAC,YAAY,CAAC,MAAc;YAC/B,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;gBAChC,IAAI,GAAG,CAAC,OAAO,KAAK,MAAM,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;oBAC/C,OAAO,GAAG,CAAC;gBACb,CAAC;YACH,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QAED,KAAK,CAAC,SAAS,CAAC,KAAU;YACxB,MAAM,EAAE,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;YAC/B,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,GAAG,GAAG;gBACV,EAAE;gBACF,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,QAAQ;gBACtC,SAAS,EAAE,GAAG;gBACd,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI;gBACnF,SAAS,EAAE,IAAI;gBACf,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,EAAE;aAC/B,CAAC;YACF,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;YAClB,OAAO,GAAG,CAAC;QACb,CAAC;QAED,KAAK,CAAC,SAAS,CAAC,KAAU;YACxB,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;gBAChC,IAAI,GAAG,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;oBACtD,GAAG,CAAC,SAAS,GAAG,KAAK,CAAC;oBACtB,GAAG,CAAC,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC;oBAC5B,GAAG,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;oBAClC,OAAO,IAAI,CAAC;gBACd,CAAC;YACH,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,KAAK,CAAC,QAAQ,CAAC,MAAc;YAC3B,MAAM,QAAQ,GAAU,EAAE,CAAC;YAC3B,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;gBAChC,IAAI,GAAG,CAAC,OAAO,KAAK,MAAM,EAAE,CAAC;oBAC3B,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACrB,CAAC;YACH,CAAC;YACD,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,KAAK,CAAC,cAAc,CAAC,UAA+C,EAAE;YACpE,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;YACjE,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC;YAChC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC;YACnC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;YAClC,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC;YACxD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QACjC,CAAC;QAED,KAAK,CAAC,kBAAkB;YACtB,IAAI,OAAO,GAAG,CAAC,CAAC;YAChB,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;gBAChC,IAAI,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,UAAU,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,IAAI,IAAI,EAAE,EAAE,CAAC;oBAC9E,GAAG,CAAC,SAAS,GAAG,KAAK,CAAC;oBACtB,OAAO,EAAE,CAAC;gBACZ,CAAC;YACH,CAAC;YACD,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,KAAK,CAAC,QAAQ;YACZ,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;QAC7C,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/src/plugins/bans/stores/index.d.ts

@@ -4,4 +4,5 @@
  * Copyright (c) 2025 QwickApps.com. All rights reserved.
  */
 export { postgresBanStore } from './postgres-store.js';
+export { createInMemoryBanStore as inMemoryBanStore } from './in-memory-store.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/plugins/bans/stores/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/bans/stores/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/bans/stores/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,sBAAsB,IAAI,gBAAgB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/src/plugins/bans/stores/index.js

@@ -4,4 +4,5 @@
  * Copyright (c) 2025 QwickApps.com. All rights reserved.
  */
 export { postgresBanStore } from './postgres-store.js';
+export { createInMemoryBanStore as inMemoryBanStore } from './in-memory-store.js';
 //# sourceMappingURL=index.js.map

package/dist/src/plugins/bans/stores/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/plugins/bans/stores/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/plugins/bans/stores/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,sBAAsB,IAAI,gBAAgB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/src/plugins/bans/types.d.ts

@@ -94,22 +94,29 @@ export interface BanCallbacks {
 }
 /**
  * Bans plugin configuration
+ *
+ * All properties are optional - plugin will use smart defaults:
+ * - store: Postgres ban store using registry's postgres instance
+ * - supportTemporary: true
+ * - api.prefix: '/bans'
+ * - api.enabled: true
+ * - debug: false
  */
 export interface BansPluginConfig {
-    /** Ban storage backend */
-    store: BanStore;
-    /** Support temporary bans (with expiration) */
+    /** Ban storage backend (default: postgres ban store from registry) */
+    store?: BanStore;
+    /** Support temporary bans (with expiration) (default: true) */
     supportTemporary?: boolean;
     /** Callbacks */
     callbacks?: BanCallbacks;
     /** API configuration */
     api?: {
-        /** API route prefix (default: '/api/bans') */
+        /** API route prefix (default: '/bans') */
         prefix?: string;
-        /** Enable API endpoints */
+        /** Enable API endpoints (default: true) */
         enabled?: boolean;
     };
-    /** Enable debug logging */
+    /** Enable debug logging (default: false) */
     debug?: boolean;
 }
 /**

package/dist/src/plugins/bans/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/plugins/bans/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/plugins/bans/types.ts"],"names":[],"mappings":"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"}

package/dist/src/plugins/cache-plugin.d.ts

@@ -1,18 +1,20 @@
 /**
  * Cache Plugin
  *
- * Provides Redis caching capabilities with connection pooling and health checks.
- * Wraps the 'ioredis' library with a simple, reusable interface.
+ * Provides caching capabilities with Redis or in-memory storage.
+ * Supports Redis via 'ioredis' library or zero-dependency in-memory LRU cache.
  *
  * ## Features
- * - Connection management with automatic reconnection
+ * - Dual-mode: Redis (persistent, distributed) or Memory (fast, local)
+ * - Connection management with automatic reconnection (Redis)
+ * - LRU eviction with TTL expiration (Memory)
  * - Key prefixing for multi-tenant/multi-app scenarios
- * - TTL-based caching with setex/get operations
+ * - TTL-based caching with get/set operations
  * - Automatic health checks
  * - Multiple named instances support
  * - Graceful shutdown
  *
- * ## Usage
+ * ## Usage (Redis)
  *
  * ```typescript
  * import { createGateway, createCachePlugin, getCache } from '@qwickapps/server';
@@ -21,6 +23,7 @@
  *   // ... config
  *   plugins: [
  *     createCachePlugin({
+ *       type: 'redis',
  *       url: process.env.REDIS_URL,
  *       keyPrefix: 'myapp:',
  *     }),
@@ -33,12 +36,24 @@
  * const user = await cache.get<User>('user:123');
  * ```
  *
+ * ## Usage (In-Memory)
+ *
+ * ```typescript
+ * // Zero external dependencies - perfect for demos and testing
+ * createCachePlugin({
+ *   type: 'memory',
+ *   keyPrefix: 'demo:',
+ *   defaultTtl: 3600,
+ *   maxMemoryEntries: 5000,
+ * })
+ * ```
+ *
  * ## Multiple Caches
  *
  * ```typescript
  * // Register multiple caches with different names
  * createCachePlugin({ url: primaryUrl, keyPrefix: 'session:' }, 'sessions');
- * createCachePlugin({ url: cacheUrl, keyPrefix: 'cache:' }, 'content');
+ * createCachePlugin({ type: 'memory', keyPrefix: 'cache:' }, 'content');
  *
  * // Access by name
  * const sessions = getCache('sessions');
@@ -53,31 +68,35 @@ type Redis = import('ioredis').default;
  * Configuration for the cache plugin
  */
 export interface CachePluginConfig {
-    /** Redis connection URL (e.g., redis://localhost:6379) */
-    url: string;
+    /** Cache type: 'redis' or 'memory' (default: 'redis' if url provided, 'memory' otherwise) */
+    type?: 'redis' | 'memory';
+    /** Redis connection URL (required for type='redis', e.g., redis://localhost:6379) */
+    url?: string;
     /** Key prefix for all cache operations (default: '') */
     keyPrefix?: string;
     /** Default TTL in seconds for set operations (default: 3600 = 1 hour) */
     defaultTtl?: number;
-    /** Maximum number of retry attempts (default: 3) */
+    /** Maximum number of entries for memory cache (default: 10000, only used for type='memory') */
+    maxMemoryEntries?: number;
+    /** Maximum number of retry attempts (default: 3, only used for type='redis') */
     maxRetries?: number;
-    /** Retry delay in milliseconds (default: 1000) */
+    /** Retry delay in milliseconds (default: 1000, only used for type='redis') */
     retryDelayMs?: number;
-    /** Connection timeout in milliseconds (default: 5000) */
+    /** Connection timeout in milliseconds (default: 5000, only used for type='redis') */
     connectTimeoutMs?: number;
-    /** Command timeout in milliseconds (default: 5000) */
+    /** Command timeout in milliseconds (default: 5000, only used for type='redis') */
     commandTimeoutMs?: number;
     /** Register a health check for this cache (default: true) */
     healthCheck?: boolean;
-    /** Name for the health check (default: 'redis') */
+    /** Name for the health check (default: 'redis' or 'memory') */
     healthCheckName?: string;
     /** Health check interval in milliseconds (default: 30000) */
     healthCheckInterval?: number;
-    /** Called when connection is ready */
+    /** Called when connection is ready (only used for type='redis') */
     onConnect?: () => void;
-    /** Called on connection errors */
+    /** Called on connection errors (only used for type='redis') */
     onError?: (error: Error) => void;
-    /** Enable lazy connect - don't connect until first command (default: false) */
+    /** Enable lazy connect - don't connect until first command (default: false, only used for type='redis') */
     lazyConnect?: boolean;
 }
 /**

package/dist/src/plugins/cache-plugin.d.ts.map

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

package/dist/src/plugins/cache-plugin.js

@@ -1,18 +1,20 @@
 /**
  * Cache Plugin
  *
- * Provides Redis caching capabilities with connection pooling and health checks.
- * Wraps the 'ioredis' library with a simple, reusable interface.
+ * Provides caching capabilities with Redis or in-memory storage.
+ * Supports Redis via 'ioredis' library or zero-dependency in-memory LRU cache.
  *
  * ## Features
- * - Connection management with automatic reconnection
+ * - Dual-mode: Redis (persistent, distributed) or Memory (fast, local)
+ * - Connection management with automatic reconnection (Redis)
+ * - LRU eviction with TTL expiration (Memory)
  * - Key prefixing for multi-tenant/multi-app scenarios
- * - TTL-based caching with setex/get operations
+ * - TTL-based caching with get/set operations
  * - Automatic health checks
  * - Multiple named instances support
  * - Graceful shutdown
  *
- * ## Usage
+ * ## Usage (Redis)
  *
  * ```typescript
  * import { createGateway, createCachePlugin, getCache } from '@qwickapps/server';
@@ -21,6 +23,7 @@
  *   // ... config
  *   plugins: [
  *     createCachePlugin({
+ *       type: 'redis',
  *       url: process.env.REDIS_URL,
  *       keyPrefix: 'myapp:',
  *     }),
@@ -33,12 +36,24 @@
  * const user = await cache.get<User>('user:123');
  * ```
  *
+ * ## Usage (In-Memory)
+ *
+ * ```typescript
+ * // Zero external dependencies - perfect for demos and testing
+ * createCachePlugin({
+ *   type: 'memory',
+ *   keyPrefix: 'demo:',
+ *   defaultTtl: 3600,
+ *   maxMemoryEntries: 5000,
+ * })
+ * ```
+ *
  * ## Multiple Caches
  *
  * ```typescript
  * // Register multiple caches with different names
  * createCachePlugin({ url: primaryUrl, keyPrefix: 'session:' }, 'sessions');
- * createCachePlugin({ url: cacheUrl, keyPrefix: 'cache:' }, 'content');
+ * createCachePlugin({ type: 'memory', keyPrefix: 'cache:' }, 'content');
  *
  * // Access by name
  * const sessions = getCache('sessions');
@@ -47,6 +62,83 @@
  *
  * Copyright (c) 2025 QwickApps.com. All rights reserved.
  */
+/**
+ * Simple LRU Cache implementation for in-memory fallback
+ */
+class LRUCache {
+    constructor(maxSize) {
+        this.cache = new Map();
+        this.maxSize = maxSize;
+    }
+    get(key) {
+        const entry = this.cache.get(key);
+        if (!entry)
+            return null;
+        // Check expiration
+        if (entry.expiresAt <= Date.now()) {
+            this.cache.delete(key);
+            return null;
+        }
+        // Move to end (most recently used)
+        this.cache.delete(key);
+        this.cache.set(key, entry);
+        return entry.value;
+    }
+    set(key, value, ttlMs) {
+        // Remove oldest entries if at capacity
+        while (this.cache.size >= this.maxSize) {
+            const firstKey = this.cache.keys().next().value;
+            if (firstKey) {
+                this.cache.delete(firstKey);
+            }
+            else {
+                break;
+            }
+        }
+        this.cache.set(key, {
+            value,
+            expiresAt: Date.now() + ttlMs,
+        });
+    }
+    delete(key) {
+        return this.cache.delete(key);
+    }
+    has(key) {
+        const entry = this.cache.get(key);
+        if (!entry)
+            return false;
+        if (entry.expiresAt <= Date.now()) {
+            this.cache.delete(key);
+            return false;
+        }
+        return true;
+    }
+    keys(pattern) {
+        const regex = new RegExp(pattern.replace(/\*/g, '.*'));
+        const result = [];
+        for (const key of this.cache.keys()) {
+            if (regex.test(key)) {
+                const entry = this.cache.get(key);
+                if (entry && entry.expiresAt > Date.now()) {
+                    result.push(key);
+                }
+            }
+        }
+        return result;
+    }
+    size() {
+        // Clean up expired entries
+        for (const [key, entry] of this.cache.entries()) {
+            if (entry.expiresAt <= Date.now()) {
+                this.cache.delete(key);
+            }
+        }
+        return this.cache.size;
+    }
+    clear() {
+        this.cache.clear();
+    }
+}
 // Global registry of cache instances by name
 const instances = new Map();
 /**
@@ -96,13 +188,135 @@ export function hasCache(name = 'default') {
  * ```
  */
 export function createCachePlugin(config, instanceName = 'default') {
+    // Determine cache type
+    const cacheType = config.type || (config.url ? 'redis' : 'memory');
     let client = null;
+    let lru = null;
     const prefix = config.keyPrefix ?? '';
     const defaultTtl = config.defaultTtl ?? 3600;
     const pluginId = `cache:${instanceName}`;
     const prefixKey = (key) => `${prefix}${key}`;
     const unprefixKey = (key) => prefix && key.startsWith(prefix) ? key.slice(prefix.length) : key;
-    const createInstance = async () => {
+    const createMemoryInstance = () => {
+        const maxEntries = config.maxMemoryEntries || 10000;
+        lru = new LRUCache(maxEntries);
+        return {
+            async get(key) {
+                if (!lru)
+                    throw new Error('Cache not initialized');
+                const value = lru.get(prefixKey(key));
+                if (value === null)
+                    return null;
+                try {
+                    return JSON.parse(value);
+                }
+                catch {
+                    return value;
+                }
+            },
+            async getRaw(key) {
+                if (!lru)
+                    throw new Error('Cache not initialized');
+                return lru.get(prefixKey(key));
+            },
+            async set(key, value, ttlSeconds) {
+                if (!lru)
+                    throw new Error('Cache not initialized');
+                const ttl = (ttlSeconds ?? defaultTtl) * 1000; // Convert to ms
+                const serialized = typeof value === 'string' ? value : JSON.stringify(value);
+                lru.set(prefixKey(key), serialized, ttl);
+            },
+            async setRaw(key, value, ttlSeconds) {
+                if (!lru)
+                    throw new Error('Cache not initialized');
+                const ttl = (ttlSeconds ?? defaultTtl) * 1000;
+                lru.set(prefixKey(key), value, ttl);
+            },
+            async delete(key) {
+                if (!lru)
+                    throw new Error('Cache not initialized');
+                return lru.delete(prefixKey(key));
+            },
+            async deletePattern(pattern) {
+                if (!lru)
+                    throw new Error('Cache not initialized');
+                const keys = lru.keys(prefixKey(pattern));
+                keys.forEach(k => lru.delete(k));
+                return keys.length;
+            },
+            async exists(key) {
+                if (!lru)
+                    throw new Error('Cache not initialized');
+                return lru.has(prefixKey(key));
+            },
+            async expire(key, ttlSeconds) {
+                if (!lru)
+                    throw new Error('Cache not initialized');
+                const value = lru.get(prefixKey(key));
+                if (value === null)
+                    return false;
+                lru.set(prefixKey(key), value, ttlSeconds * 1000);
+                return true;
+            },
+            async ttl(key) {
+                if (!lru)
+                    throw new Error('Cache not initialized');
+                // Memory cache doesn't track TTL separately
+                return lru.has(prefixKey(key)) ? -1 : -2;
+            },
+            async incr(key, delta = 1) {
+                if (!lru)
+                    throw new Error('Cache not initialized');
+                const current = lru.get(prefixKey(key));
+                const value = current ? parseInt(current, 10) + delta : delta;
+                lru.set(prefixKey(key), value.toString(), defaultTtl * 1000);
+                return value;
+            },
+            async keys(pattern) {
+                if (!lru)
+                    throw new Error('Cache not initialized');
+                return lru.keys(prefixKey(pattern)).map(unprefixKey);
+            },
+            async scanKeys(pattern) {
+                // Memory cache can use same implementation as keys()
+                return this.keys(pattern);
+            },
+            async flush() {
+                if (!lru)
+                    throw new Error('Cache not initialized');
+                if (!prefix) {
+                    throw new Error('Cannot flush without a keyPrefix configured');
+                }
+                const keys = lru.keys(`${prefix}*`);
+                keys.forEach(k => lru.delete(k));
+                return keys.length;
+            },
+            async getStats() {
+                if (!lru) {
+                    return { connected: false, keyCount: 0 };
+                }
+                return {
+                    connected: true,
+                    keyCount: lru.size(),
+                    usedMemory: undefined,
+                };
+            },
+            getClient() {
+                throw new Error('Memory cache does not have a Redis client');
+            },
+            async close() {
+                if (lru) {
+                    lru.clear();
+                    lru = null;
+                }
+            },
+        };
+    };
+    const createRedisInstance = async () => {
+        // Validate Redis URL is provided
+        if (!config.url) {
+            throw new Error('Redis URL is required for Redis cache type');
+        }
         // Dynamic import of ioredis
         const { default: Redis } = await import('ioredis');
         const options = {
@@ -282,39 +496,48 @@ export function createCachePlugin(config, instanceName = 'default') {
     };
     return {
         id: pluginId,
-        name: `Redis Cache (${instanceName})`,
+        name: `${cacheType === 'memory' ? 'Memory' : 'Redis'} Cache (${instanceName})`,
         version: '1.0.0',
         async onStart(_pluginConfig, registry) {
             const logger = registry.getLogger(pluginId);
-            // Create and register the instance
-            const instance = await createInstance();
+            // Create and register the instance based on type
+            const instance = cacheType === 'memory'
+                ? createMemoryInstance()
+                : await createRedisInstance();
             instances.set(instanceName, instance);
-            // Test connection
-            try {
-                // Ping to verify connection
-                await instance.getClient().ping();
-                logger.debug(`Cache "${instanceName}" connected`);
+            // Test connection (skip for memory, test for Redis)
+            if (cacheType === 'redis') {
+                try {
+                    await instance.getClient().ping();
+                    logger.debug(`Cache "${instanceName}" connected`);
+                }
+                catch (err) {
+                    logger.error(`Cache "${instanceName}" connection failed: ${err instanceof Error ? err.message : String(err)}`);
+                    throw err;
+                }
             }
-            catch (err) {
-                logger.error(`Cache "${instanceName}" connection failed: ${err instanceof Error ? err.message : String(err)}`);
-                throw err;
+            else {
+                logger.debug(`Cache "${instanceName}" initialized (in-memory)`);
             }
             // Register health check if enabled
             if (config.healthCheck !== false) {
                 registry.registerHealthCheck({
-                    name: config.healthCheckName ?? 'redis',
+                    name: config.healthCheckName ?? (cacheType === 'memory' ? 'memory-cache' : 'redis'),
                     type: 'custom',
                     interval: config.healthCheckInterval ?? 30000,
                     timeout: 5000,
                     check: async () => {
                         const start = Date.now();
                         try {
-                            await instance.getClient().ping();
+                            if (cacheType === 'redis') {
+                                await instance.getClient().ping();
+                            }
                             const stats = await instance.getStats();
                             return {
                                 healthy: true,
                                 latency: Date.now() - start,
                                 details: {
+                                    type: cacheType,
                                     connected: stats.connected,
                                     keyCount: stats.keyCount,
                                     usedMemory: stats.usedMemory,
@@ -333,6 +556,62 @@ export function createCachePlugin(config, instanceName = 'default') {
                     },
                 });
             }
+            // Register maintenance routes (only for default instance to avoid conflicts)
+            if (instanceName === 'default') {
+                // GET /stats - Cache statistics
+                registry.addRoute({
+                    method: 'get',
+                    path: '/stats',
+                    pluginId: 'cache',
+                    handler: async (_req, res) => {
+                        try {
+                            const stats = await instance.getStats();
+                            return res.json(stats);
+                        }
+                        catch (error) {
+                            logger.error('Failed to get cache stats', { error });
+                            return res.status(500).json({
+                                error: 'Failed to get cache stats',
+                                message: error instanceof Error ? error.message : String(error),
+                            });
+                        }
+                    },
+                });
+                // POST /flush - Clear cache
+                registry.addRoute({
+                    method: 'post',
+                    path: '/flush',
+                    pluginId: 'cache',
+                    handler: async (_req, res) => {
+                        try {
+                            const deletedCount = await instance.flush();
+                            logger.info(`Flushed cache: ${deletedCount} keys deleted`);
+                            return res.json({
+                                success: true,
+                                message: `Cache flushed successfully`,
+                                deletedCount,
+                            });
+                        }
+                        catch (error) {
+                            logger.error('Failed to flush cache', { error });
+                            return res.status(500).json({
+                                error: 'Failed to flush cache',
+                                message: error instanceof Error ? error.message : String(error),
+                            });
+                        }
+                    },
+                });
+                // Register maintenance widget
+                registry.addWidget({
+                    id: 'cache-maintenance',
+                    title: 'Cache Management',
+                    component: 'CacheMaintenanceWidget',
+                    type: 'maintenance',
+                    priority: 60,
+                    showByDefault: true,
+                    pluginId: 'cache',
+                });
+            }
         },
         async onStop() {
             const instance = instances.get(instanceName);