blendsdk 5.33.0

package/dist/webafx-cache/cache-plugin.d.ts

@@ -0,0 +1,114 @@
+/**
+ * WebAFX plugin integration for cache providers.
+ *
+ * Provides convenience factory functions that wire a CacheProvider instance
+ * into a WebAFX application as a singleton service with health check and
+ * graceful shutdown support.
+ *
+ * This is the ONLY file in @blendsdk/webafx-cache that imports from @blendsdk/webafx,
+ * which is why webafx is a peer dependency (not a hard dependency).
+ *
+ * @packageDocumentation
+ */
+import type { PluginDefinition } from "../webafx/index.js";
+import { CacheProvider } from "./abstract-cache-provider.js";
+import type { CacheFactoryConfig, MemoryCacheConfig, RedisCacheConfig } from "./types.js";
+/**
+ * Create a WebAFX PluginDefinition from any CacheProvider instance.
+ *
+ * This is the core function that wires a cache provider into WebAFX:
+ * 1. Registers the provider as a singleton service in the service container
+ * 2. Hooks the provider's health() into the /health endpoint
+ * 3. Hooks the provider's shutdown() into graceful shutdown
+ *
+ * The service name is read from `provider.serviceName` (defaults to 'cache').
+ *
+ * @param provider - Any CacheProvider instance (Redis, Memory, or custom)
+ * @param options - Optional overrides for plugin priority
+ * @returns A WebAFX PluginDefinition ready to pass to app.use()
+ *
+ * @example
+ * ```typescript
+ * const cache = new RedisCacheProvider({ rootKey: 'MyApp', host: 'localhost' });
+ * app.use(createCachePlugin(cache));
+ * ```
+ */
+export declare function createCachePlugin(provider: CacheProvider, options?: {
+    priority?: number;
+}): PluginDefinition;
+/**
+ * Create a WebAFX cache plugin with a Redis backend. One-liner registration.
+ *
+ * Creates a RedisCacheProvider internally and returns a PluginDefinition.
+ * The user never needs to instantiate the provider manually.
+ *
+ * @param config - Redis cache configuration (rootKey, host, port, etc.)
+ * @returns A WebAFX PluginDefinition ready to pass to app.use()
+ *
+ * @example
+ * ```typescript
+ * app.use(redisCachePlugin({
+ *     rootKey: 'MyApp',
+ *     host: 'localhost',
+ *     port: 6379,
+ *     defaultTTL: 300,
+ * }));
+ * ```
+ *
+ * @example Multi-cache with different service names
+ * ```typescript
+ * app.use(redisCachePlugin({
+ *     rootKey: 'Sessions',
+ *     host: 'redis-sessions',
+ *     serviceName: 'session-cache',
+ * }));
+ * app.use(redisCachePlugin({
+ *     rootKey: 'Products',
+ *     host: 'redis-products',
+ *     serviceName: 'product-cache',
+ * }));
+ * ```
+ */
+export declare function redisCachePlugin(config: RedisCacheConfig): PluginDefinition;
+/**
+ * Create a WebAFX cache plugin with an In-Memory backend. One-liner registration.
+ *
+ * Creates a MemoryCacheProvider internally and returns a PluginDefinition.
+ * Ideal for development, testing, and single-instance applications.
+ *
+ * @param config - Memory cache configuration (rootKey, defaultTTL, etc.)
+ * @returns A WebAFX PluginDefinition ready to pass to app.use()
+ *
+ * @example
+ * ```typescript
+ * app.use(memoryCachePlugin({
+ *     rootKey: 'MyApp',
+ *     defaultTTL: 60,
+ * }));
+ * ```
+ */
+export declare function memoryCachePlugin(config: MemoryCacheConfig): PluginDefinition;
+/**
+ * Create a CacheProvider based on configuration type.
+ *
+ * Factory function for environment-based backend switching.
+ * Returns the appropriate provider based on `config.type`.
+ * Use with `createCachePlugin()` to register in WebAFX.
+ *
+ * @param config - Cache factory configuration with type discriminator
+ * @returns A CacheProvider instance (Redis or Memory)
+ * @throws Error if config.type is not 'redis' or 'memory'
+ *
+ * @example
+ * ```typescript
+ * const cache = createCache({
+ *     type: process.env.NODE_ENV === 'production' ? 'redis' : 'memory',
+ *     rootKey: 'MyApp',
+ *     host: process.env.REDIS_HOST,
+ *     port: Number(process.env.REDIS_PORT),
+ * });
+ * app.use(createCachePlugin(cache));
+ * ```
+ */
+export declare function createCache(config: CacheFactoryConfig): CacheProvider;
+//# sourceMappingURL=cache-plugin.d.ts.map

package/dist/webafx-cache/cache-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-plugin.d.ts","sourceRoot":"","sources":["../src/cache-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAG7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAa1F;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,iBAAiB,CAC7B,QAAQ,EAAE,aAAa,EACvB,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAChC,gBAAgB,CA6BlB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,gBAAgB,CAG3E;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,gBAAgB,CAG7E;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,kBAAkB,GAAG,aAAa,CA+BrE"}

package/dist/webafx-cache/cache-plugin.js

@@ -0,0 +1,176 @@
+/**
+ * WebAFX plugin integration for cache providers.
+ *
+ * Provides convenience factory functions that wire a CacheProvider instance
+ * into a WebAFX application as a singleton service with health check and
+ * graceful shutdown support.
+ *
+ * This is the ONLY file in @blendsdk/webafx-cache that imports from @blendsdk/webafx,
+ * which is why webafx is a peer dependency (not a hard dependency).
+ *
+ * @packageDocumentation
+ */
+import { MemoryCacheProvider } from "./memory-cache-provider.js";
+import { RedisCacheProvider } from "./redis-cache-provider.js";
+// ---------------------------------------------------------------------------
+// Default Constants
+// ---------------------------------------------------------------------------
+/** Default plugin priority — installs after most core plugins */
+const DEFAULT_PLUGIN_PRIORITY = 30;
+// ---------------------------------------------------------------------------
+// Plugin Factory Functions
+// ---------------------------------------------------------------------------
+/**
+ * Create a WebAFX PluginDefinition from any CacheProvider instance.
+ *
+ * This is the core function that wires a cache provider into WebAFX:
+ * 1. Registers the provider as a singleton service in the service container
+ * 2. Hooks the provider's health() into the /health endpoint
+ * 3. Hooks the provider's shutdown() into graceful shutdown
+ *
+ * The service name is read from `provider.serviceName` (defaults to 'cache').
+ *
+ * @param provider - Any CacheProvider instance (Redis, Memory, or custom)
+ * @param options - Optional overrides for plugin priority
+ * @returns A WebAFX PluginDefinition ready to pass to app.use()
+ *
+ * @example
+ * ```typescript
+ * const cache = new RedisCacheProvider({ rootKey: 'MyApp', host: 'localhost' });
+ * app.use(createCachePlugin(cache));
+ * ```
+ */
+export function createCachePlugin(provider, options) {
+    return {
+        name: provider.serviceName,
+        priority: options?.priority ?? DEFAULT_PLUGIN_PRIORITY,
+        factory: async ({ app, logger }) => {
+            // Register the cache provider as an application-wide singleton service.
+            // The factory ignores container/settings since the provider is pre-created.
+            app.registerService({
+                name: provider.serviceName,
+                type: "singleton",
+                factory: () => provider,
+                dispose: async () => {
+                    await provider.shutdown();
+                },
+            });
+            await logger.info(`Cache plugin "${provider.serviceName}" initialized ` +
+                `(${provider.constructor.name})`);
+            // Return Plugin hooks for health monitoring and graceful shutdown
+            return {
+                health: () => provider.health(),
+                shutdown: () => provider.shutdown(),
+            };
+        },
+    };
+}
+/**
+ * Create a WebAFX cache plugin with a Redis backend. One-liner registration.
+ *
+ * Creates a RedisCacheProvider internally and returns a PluginDefinition.
+ * The user never needs to instantiate the provider manually.
+ *
+ * @param config - Redis cache configuration (rootKey, host, port, etc.)
+ * @returns A WebAFX PluginDefinition ready to pass to app.use()
+ *
+ * @example
+ * ```typescript
+ * app.use(redisCachePlugin({
+ *     rootKey: 'MyApp',
+ *     host: 'localhost',
+ *     port: 6379,
+ *     defaultTTL: 300,
+ * }));
+ * ```
+ *
+ * @example Multi-cache with different service names
+ * ```typescript
+ * app.use(redisCachePlugin({
+ *     rootKey: 'Sessions',
+ *     host: 'redis-sessions',
+ *     serviceName: 'session-cache',
+ * }));
+ * app.use(redisCachePlugin({
+ *     rootKey: 'Products',
+ *     host: 'redis-products',
+ *     serviceName: 'product-cache',
+ * }));
+ * ```
+ */
+export function redisCachePlugin(config) {
+    const provider = new RedisCacheProvider(config);
+    return createCachePlugin(provider);
+}
+/**
+ * Create a WebAFX cache plugin with an In-Memory backend. One-liner registration.
+ *
+ * Creates a MemoryCacheProvider internally and returns a PluginDefinition.
+ * Ideal for development, testing, and single-instance applications.
+ *
+ * @param config - Memory cache configuration (rootKey, defaultTTL, etc.)
+ * @returns A WebAFX PluginDefinition ready to pass to app.use()
+ *
+ * @example
+ * ```typescript
+ * app.use(memoryCachePlugin({
+ *     rootKey: 'MyApp',
+ *     defaultTTL: 60,
+ * }));
+ * ```
+ */
+export function memoryCachePlugin(config) {
+    const provider = new MemoryCacheProvider(config);
+    return createCachePlugin(provider);
+}
+/**
+ * Create a CacheProvider based on configuration type.
+ *
+ * Factory function for environment-based backend switching.
+ * Returns the appropriate provider based on `config.type`.
+ * Use with `createCachePlugin()` to register in WebAFX.
+ *
+ * @param config - Cache factory configuration with type discriminator
+ * @returns A CacheProvider instance (Redis or Memory)
+ * @throws Error if config.type is not 'redis' or 'memory'
+ *
+ * @example
+ * ```typescript
+ * const cache = createCache({
+ *     type: process.env.NODE_ENV === 'production' ? 'redis' : 'memory',
+ *     rootKey: 'MyApp',
+ *     host: process.env.REDIS_HOST,
+ *     port: Number(process.env.REDIS_PORT),
+ * });
+ * app.use(createCachePlugin(cache));
+ * ```
+ */
+export function createCache(config) {
+    switch (config.type) {
+        case "redis":
+            return new RedisCacheProvider({
+                rootKey: config.rootKey,
+                serviceName: config.serviceName,
+                defaultTTL: config.defaultTTL,
+                host: config.host,
+                port: config.port,
+                password: config.password,
+                db: config.db,
+                url: config.url,
+            });
+        case "memory":
+            return new MemoryCacheProvider({
+                rootKey: config.rootKey,
+                serviceName: config.serviceName,
+                defaultTTL: config.defaultTTL,
+                cleanupIntervalMs: config.cleanupIntervalMs,
+            });
+        default:
+            // Exhaustive check — this should never happen with correct TypeScript usage,
+            // but provides a clear runtime error if called with an invalid type
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const unknownType = config.type;
+            throw new Error(`Unknown cache type: "${unknownType}". Supported types: "redis", "memory".`);
+    }
+}
+//# sourceMappingURL=cache-plugin.js.map

package/dist/webafx-cache/cache-plugin.js.map

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

package/dist/webafx-cache/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @blendsdk/webafx-cache — Application-wide caching and pub/sub plugin for WebAFX
+ *
+ * Provides two independent abstraction hierarchies:
+ *
+ * **Caching:**
+ * - CacheProvider (abstract) → RedisCacheProvider, MemoryCacheProvider
+ * - Plugin factories: createCachePlugin(), redisCachePlugin(), memoryCachePlugin(), createCache()
+ *
+ * **Pub/Sub Messaging:**
+ * - PubSubProvider (abstract) → RedisPubSubProvider, MemoryPubSubProvider
+ * - Plugin factories: createPubSubPlugin(), redisPubSubPlugin(), memoryPubSubPlugin(), createPubSub()
+ *
+ * Both integrate with WebAFX via convenience plugin factory functions that
+ * register providers as application-wide singleton services.
+ *
+ * @packageDocumentation
+ */
+export type { RedisConnectionConfig } from "./types.js";
+export type { CacheProviderConfig, RedisCacheConfig, MemoryCacheConfig, CacheFactoryConfig, } from "./types.js";
+export { DEFAULT_SERVICE_NAME, DEFAULT_TTL, KEY_SEPARATOR } from "./types.js";
+export type { PubSubProviderConfig, RedisPubSubConfig, MemoryPubSubConfig, PubSubFactoryConfig, PubSubMessage, MessageHandler, SubscriptionDefinition, } from "./types.js";
+export { DEFAULT_PUBSUB_SERVICE_NAME, CHANNEL_SEPARATOR } from "./types.js";
+export { CacheProvider } from "./abstract-cache-provider.js";
+export { PubSubProvider } from "./abstract-pubsub-provider.js";
+export { MemoryCacheProvider } from "./memory-cache-provider.js";
+export { RedisCacheProvider } from "./redis-cache-provider.js";
+export { MemoryPubSubProvider } from "./memory-pubsub-provider.js";
+export { RedisPubSubProvider } from "./redis-pubsub-provider.js";
+export { createCachePlugin, redisCachePlugin, memoryCachePlugin, createCache } from "./cache-plugin.js";
+export type { PubSubPluginOptions } from "./pubsub-plugin.js";
+export { createPubSubPlugin, redisPubSubPlugin, memoryPubSubPlugin, createPubSub, } from "./pubsub-plugin.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/webafx-cache/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAKH,YAAY,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAKxD,YAAY,EACR,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,GACrB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAK9E,YAAY,EACR,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,sBAAsB,GACzB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,2BAA2B,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAK5E,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAK7D,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAK/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAK/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAKjE,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAKxG,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EACH,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,YAAY,GACf,MAAM,oBAAoB,CAAC"}

package/dist/webafx-cache/index.js

@@ -0,0 +1,44 @@
+/**
+ * @blendsdk/webafx-cache — Application-wide caching and pub/sub plugin for WebAFX
+ *
+ * Provides two independent abstraction hierarchies:
+ *
+ * **Caching:**
+ * - CacheProvider (abstract) → RedisCacheProvider, MemoryCacheProvider
+ * - Plugin factories: createCachePlugin(), redisCachePlugin(), memoryCachePlugin(), createCache()
+ *
+ * **Pub/Sub Messaging:**
+ * - PubSubProvider (abstract) → RedisPubSubProvider, MemoryPubSubProvider
+ * - Plugin factories: createPubSubPlugin(), redisPubSubPlugin(), memoryPubSubPlugin(), createPubSub()
+ *
+ * Both integrate with WebAFX via convenience plugin factory functions that
+ * register providers as application-wide singleton services.
+ *
+ * @packageDocumentation
+ */
+export { DEFAULT_SERVICE_NAME, DEFAULT_TTL, KEY_SEPARATOR } from "./types.js";
+export { DEFAULT_PUBSUB_SERVICE_NAME, CHANNEL_SEPARATOR } from "./types.js";
+// ---------------------------------------------------------------------------
+// Cache Abstract Base Class
+// ---------------------------------------------------------------------------
+export { CacheProvider } from "./abstract-cache-provider.js";
+// ---------------------------------------------------------------------------
+// Pub/Sub Abstract Base Class
+// ---------------------------------------------------------------------------
+export { PubSubProvider } from "./abstract-pubsub-provider.js";
+// ---------------------------------------------------------------------------
+// Cache Provider Implementations
+// ---------------------------------------------------------------------------
+export { MemoryCacheProvider } from "./memory-cache-provider.js";
+export { RedisCacheProvider } from "./redis-cache-provider.js";
+// ---------------------------------------------------------------------------
+// Pub/Sub Provider Implementations
+// ---------------------------------------------------------------------------
+export { MemoryPubSubProvider } from "./memory-pubsub-provider.js";
+export { RedisPubSubProvider } from "./redis-pubsub-provider.js";
+// ---------------------------------------------------------------------------
+// Cache Plugin Integration (WebAFX)
+// ---------------------------------------------------------------------------
+export { createCachePlugin, redisCachePlugin, memoryCachePlugin, createCache } from "./cache-plugin.js";
+export { createPubSubPlugin, redisPubSubPlugin, memoryPubSubPlugin, createPubSub, } from "./pubsub-plugin.js";
+//# sourceMappingURL=index.js.map

package/dist/webafx-cache/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAiBH,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAe9E,OAAO,EAAE,2BAA2B,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE5E,8EAA8E;AAC9E,4BAA4B;AAC5B,8EAA8E;AAC9E,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAE7D,8EAA8E;AAC9E,8BAA8B;AAC9B,8EAA8E;AAC9E,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D,8EAA8E;AAC9E,iCAAiC;AACjC,8EAA8E;AAC9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,8EAA8E;AAC9E,mCAAmC;AACnC,8EAA8E;AAC9E,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE,8EAA8E;AAC9E,oCAAoC;AACpC,8EAA8E;AAC9E,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAMxG,OAAO,EACH,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,YAAY,GACf,MAAM,oBAAoB,CAAC"}

package/dist/webafx-cache/memory-cache-provider.d.ts

@@ -0,0 +1,99 @@
+/**
+ * In-memory cache provider with TTL support.
+ *
+ * Zero external dependencies — suitable for development, testing,
+ * and single-instance applications. Mimics Redis behavior:
+ * - TTL in seconds (stored as expiration timestamps)
+ * - Returns -1 for no expiry, -2 for missing key (ttl method)
+ * - Pattern matching with * wildcard
+ * - Periodic cleanup of expired entries
+ *
+ * Values are JSON-serialized/deserialized to match Redis behavior,
+ * ensuring what goes in is what comes out with no reference sharing.
+ *
+ * @packageDocumentation
+ */
+import { CacheProvider } from "./abstract-cache-provider.js";
+import type { MemoryCacheConfig } from "./types.js";
+/**
+ * Internal structure for a cache entry in the memory store.
+ * Stores the JSON-serialized value alongside an optional expiration timestamp.
+ */
+interface MemoryCacheEntry {
+    /** JSON-serialized value */
+    value: string;
+    /** Expiration timestamp in milliseconds, or undefined for no expiry */
+    expiresAt: number | undefined;
+}
+/**
+ * In-memory cache provider with TTL support.
+ *
+ * Uses a `Map<string, MemoryCacheEntry>` for storage with JSON serialization
+ * to match Redis behavior. Expired entries are lazily evicted on access and
+ * periodically cleaned up via a configurable interval timer.
+ *
+ * @example
+ * ```typescript
+ * const cache = new MemoryCacheProvider({
+ *     rootKey: 'TestApp',
+ *     defaultTTL: 60,
+ *     cleanupIntervalMs: 5000,
+ * });
+ *
+ * await cache.set('key', { data: true });
+ * const value = await cache.get<{ data: boolean }>('key');
+ * ```
+ */
+export declare class MemoryCacheProvider extends CacheProvider {
+    /** Internal storage map: prefixed key → cache entry */
+    protected store: Map<string, MemoryCacheEntry>;
+    /** Handle for the periodic cleanup interval (undefined if stopped) */
+    protected cleanupInterval: ReturnType<typeof setInterval> | undefined;
+    /** Cleanup interval in milliseconds */
+    protected cleanupIntervalMs: number;
+    /**
+     * Create a new in-memory cache provider.
+     *
+     * @param config - Memory cache configuration with rootKey and optional cleanup interval
+     */
+    constructor(config: MemoryCacheConfig);
+    /** @inheritDoc */
+    set<T>(key: string, value: T, ttlSeconds?: number): Promise<void>;
+    /** @inheritDoc */
+    get<T>(key: string): Promise<T | undefined>;
+    /** @inheritDoc */
+    delete(key: string): Promise<boolean>;
+    /** @inheritDoc */
+    exists(key: string): Promise<boolean>;
+    /** @inheritDoc */
+    expire(key: string, ttlSeconds: number): Promise<boolean>;
+    /** @inheritDoc */
+    ttl(key: string): Promise<number>;
+    /** @inheritDoc */
+    deletePattern(pattern: string): Promise<number>;
+    /** @inheritDoc */
+    clear(): Promise<void>;
+    /** @inheritDoc */
+    health(): Promise<boolean>;
+    /** @inheritDoc */
+    shutdown(): Promise<void>;
+    /**
+     * Convert a glob-style pattern (with * wildcards) to a RegExp.
+     *
+     * Escapes all regex special characters except *, which becomes .* to
+     * match any sequence of characters (mimicking Redis SCAN MATCH behavior).
+     *
+     * @param pattern - Glob pattern (e.g., 'MyApp:user:*')
+     * @returns RegExp that matches the pattern
+     */
+    protected patternToRegex(pattern: string): RegExp;
+    /**
+     * Start periodic cleanup of expired entries.
+     *
+     * Prevents unbounded memory growth from expired-but-not-accessed entries.
+     * The interval timer is unref'd so it doesn't prevent Node.js from exiting.
+     */
+    protected startCleanup(): void;
+}
+export {};
+//# sourceMappingURL=memory-cache-provider.d.ts.map

package/dist/webafx-cache/memory-cache-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-cache-provider.d.ts","sourceRoot":"","sources":["../src/memory-cache-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAMpD;;;GAGG;AACH,UAAU,gBAAgB;IACtB,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IAEd,uEAAuE;IACvE,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC;AAaD;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,mBAAoB,SAAQ,aAAa;IAClD,uDAAuD;IACvD,SAAS,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAE/C,sEAAsE;IACtE,SAAS,CAAC,eAAe,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,GAAG,SAAS,CAAC;IAEtE,uCAAuC;IACvC,SAAS,CAAC,iBAAiB,EAAE,MAAM,CAAC;IAEpC;;;;OAIG;gBACS,MAAM,EAAE,iBAAiB;IAarC,kBAAkB;IACZ,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAcvE,kBAAkB;IACZ,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAsBjD,kBAAkB;IACZ,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK3C,kBAAkB;IACZ,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAiB3C,kBAAkB;IACZ,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAmB/D,kBAAkB;IACZ,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA6BvC,kBAAkB;IACZ,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAqBrD,kBAAkB;IACZ,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB5B,kBAAkB;IACZ,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAKhC,kBAAkB;IACZ,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAe/B;;;;;;;;OAQG;IACH,SAAS,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAOjD;;;;;OAKG;IACH,SAAS,CAAC,YAAY,IAAI,IAAI;CAoBjC"}