@engjts/nexus 0.1.0

package/README.md

@@ -0,0 +1,164 @@
+# Nexus Framework
+
+Modern async-first web framework with type-safety and security built-in.
+
+## Features
+
+✨ **Unified Context Pattern** - Single immutable context object replacing req/res  
+🚀 **Async-First** - Native async/await with automatic error handling  
+🔒 **Type-Safe** - Full TypeScript support with schema validation (Zod)  
+⚡ **High Performance** - Object pooling, zero-copy buffers, JIT compilation  
+🧩 **Extensible** - Adapter pattern for plugins and custom implementations  
+🛠️ **Developer Experience** - Intuitive API with excellent type inference  
+
+## Quick Start
+
+### Installation
+
+```bash
+npm install
+```
+
+### Basic Usage
+
+```typescript
+import { createApp, z } from './src';
+
+const app = createApp();
+
+// Simple route
+app.get('/hello', async (ctx) => {
+  return { message: 'Hello World!' };
+});
+
+// Route with validation
+app.post('/users', {
+  schema: {
+    body: z.object({
+      name: z.string().min(2),
+      email: z.string().email()
+    })
+  },
+  handler: async (ctx) => {
+    // ctx.body is typed and validated!
+    return { user: ctx.body };
+  }
+});
+
+app.listen(3000);
+```
+
+### Running the Example
+
+```bash
+npm run dev
+```
+
+Then visit:
+- http://localhost:3000/hello
+- http://localhost:3000/users/123
+- http://localhost:3000/profile (requires auth header)
+
+## Architecture
+
+### Core Components
+
+- **Context** - Unified request/response object with immutability
+- **Router** - Radix tree-based routing with O(log n) lookup
+- **Middleware** - Type-safe composable middleware chain
+- **Application** - Main orchestrator with lifecycle management
+
+### Performance Optimizations
+
+- **Context Pooling** - Reuses context objects to reduce GC pressure
+- **Buffer Pooling** - Zero-copy buffer handling for bodies
+- **JIT Compilation** - Optimizes hot paths at runtime
+
+### Adapter Pattern
+
+All core components use adapter interfaces for extensibility:
+- RouterAdapter
+- ContextAdapter
+- MiddlewareAdapter
+- ValidationAdapter
+- LoggerAdapter
+- CacheAdapter
+- SessionAdapter
+
+## API Reference
+
+### Application
+
+```typescript
+const app = createApp(config?: AppConfig);
+
+app.use(middleware: Middleware);
+app.get(path: string, handler: Handler | RouteConfig);
+app.post(path: string, handler: Handler | RouteConfig);
+app.put(path: string, handler: Handler | RouteConfig);
+app.delete(path: string, handler: Handler | RouteConfig);
+app.patch(path: string, handler: Handler | RouteConfig);
+app.onError(handler: ErrorHandler);
+app.listen(port: number, callback?: () => void);
+```
+
+### Context
+
+```typescript
+interface Context {
+  method: HTTPMethod;
+  path: string;
+  url: URL;
+  params: Record<string, string>;
+  query: Record<string, any>;
+  body: any;
+  headers: Headers;
+  cookies: Cookies;
+  
+  json<T>(data: T): Response;
+  html(content: string): Response;
+  text(content: string): Response;
+  redirect(url: string, status?: number): Response;
+  stream(readable: NodeJS.ReadableStream): Response;
+}
+```
+
+### Middleware
+
+```typescript
+type Middleware<TIn = Context, TOut = Context> = (
+  ctx: TIn,
+  next: Next<TOut>
+) => Promise<Response>;
+```
+
+### Route Configuration
+
+```typescript
+interface RouteConfig {
+  method: HTTPMethod;
+  path: string;
+  handler: Handler;
+  middlewares?: Middleware[];
+  schema?: SchemaConfig;
+  meta?: RouteMeta;
+}
+```
+
+## Development
+
+### Build
+
+```bash
+npm run build
+```
+
+### Test
+
+```bash
+npm test
+```
+
+## License
+
+MIT

package/dist/advanced/cache/InMemoryCacheStore.d.ts

@@ -0,0 +1,18 @@
+import { CacheStore, CacheEntry } from './types';
+/**
+ * Simple in-memory cache store with TTL support
+ */
+export declare class InMemoryCacheStore<Value = unknown> implements CacheStore<Value> {
+    readonly name: string;
+    private store;
+    private emitter;
+    private maxSize;
+    constructor(name: string, maxSize?: number);
+    get(key: string): Promise<CacheEntry<Value> | undefined>;
+    set(key: string, entry: CacheEntry<Value>): Promise<void>;
+    delete(key: string): Promise<void>;
+    clear(): Promise<void>;
+    keys(pattern?: RegExp): Promise<string[]>;
+    on(event: 'set' | 'delete' | 'clear', listener: (...args: any[]) => void): void;
+}
+//# sourceMappingURL=InMemoryCacheStore.d.ts.map

package/dist/advanced/cache/InMemoryCacheStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InMemoryCacheStore.d.ts","sourceRoot":"","sources":["../../../src/advanced/cache/InMemoryCacheStore.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEjD;;GAEG;AAEH,qBAAa,kBAAkB,CAAC,KAAK,GAAG,OAAO,CAAE,YAAW,UAAU,CAAC,KAAK,CAAC;IACzE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,KAAK,CAA6C;IAC1D,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,OAAO,CAAS;gBAEZ,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,MAAc;IAK3C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC;IAcxD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAYzD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOlC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAQ/C,EAAE,CAAC,KAAK,EAAE,KAAK,GAAG,QAAQ,GAAG,OAAO,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI;CAG3E"}

package/dist/advanced/cache/InMemoryCacheStore.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InMemoryCacheStore = void 0;
+const events_1 = require("events");
+/**
+ * Simple in-memory cache store with TTL support
+ */
+class InMemoryCacheStore {
+    name;
+    store = new Map();
+    emitter = new events_1.EventEmitter();
+    maxSize;
+    constructor(name, maxSize = 10000) {
+        this.name = name;
+        this.maxSize = maxSize;
+    }
+    async get(key) {
+        const entry = this.store.get(key);
+        if (!entry) {
+            return undefined;
+        }
+        if (entry.expiresAt && entry.expiresAt < Date.now()) {
+            await this.delete(key);
+            return undefined;
+        }
+        return entry;
+    }
+    async set(key, entry) {
+        if (this.store.size >= this.maxSize) {
+            const oldestKey = this.store.keys().next().value;
+            if (oldestKey) {
+                this.store.delete(oldestKey);
+            }
+        }
+        this.store.set(key, entry);
+        this.emitter.emit('set', key, entry);
+    }
+    async delete(key) {
+        if (this.store.has(key)) {
+            this.store.delete(key);
+            this.emitter.emit('delete', key);
+        }
+    }
+    async clear() {
+        this.store.clear();
+        this.emitter.emit('clear');
+    }
+    async keys(pattern) {
+        const allKeys = Array.from(this.store.keys());
+        if (!pattern) {
+            return allKeys;
+        }
+        return allKeys.filter(key => pattern.test(key));
+    }
+    on(event, listener) {
+        this.emitter.on(event, listener);
+    }
+}
+exports.InMemoryCacheStore = InMemoryCacheStore;
+//# sourceMappingURL=InMemoryCacheStore.js.map

package/dist/advanced/cache/InMemoryCacheStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InMemoryCacheStore.js","sourceRoot":"","sources":["../../../src/advanced/cache/InMemoryCacheStore.ts"],"names":[],"mappings":";;;AAAA,mCAAsC;AAGtC;;GAEG;AAEH,MAAa,kBAAkB;IAClB,IAAI,CAAS;IACd,KAAK,GAAmC,IAAI,GAAG,EAAE,CAAC;IAClD,OAAO,GAAG,IAAI,qBAAY,EAAE,CAAC;IAC7B,OAAO,CAAS;IAExB,YAAY,IAAY,EAAE,UAAkB,KAAK;QAC7C,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW;QACjB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,OAAO,SAAS,CAAC;QACrB,CAAC;QAED,IAAI,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;YAClD,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACvB,OAAO,SAAS,CAAC;QACrB,CAAC;QAED,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,KAAwB;QAC3C,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAClC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;YACjD,IAAI,SAAS,EAAE,CAAC;gBACZ,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YACjC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC3B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACpB,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACtB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACvB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QACrC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,KAAK;QACP,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACnB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,OAAgB;QACvB,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9C,IAAI,CAAC,OAAO,EAAE,CAAC;YACX,OAAO,OAAO,CAAC;QACnB,CAAC;QACD,OAAO,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACpD,CAAC;IAED,EAAE,CAAC,KAAiC,EAAE,QAAkC;QACpE,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACrC,CAAC;CACJ;AA5DD,gDA4DC"}

package/dist/advanced/cache/MultiTierCache.d.ts

@@ -0,0 +1,55 @@
+import { CacheTierConfig, CacheSetOptions, CacheWrapOptions, MemoizeOptions } from './types';
+/**
+ * Multi-tier cache orchestrator
+ */
+export declare class MultiTierCache<Value = unknown> {
+    private tiers;
+    private tagIndex;
+    private defaultTTL;
+    constructor(tiers: CacheTierConfig<Value>[], defaultTTL?: number);
+    /**
+     * Retrieve a value from the tiers starting from the fastest one
+     */
+    get(key: string): Promise<Value | undefined>;
+    /**
+     * Set a cache value across tiers
+     */
+    set(key: string, value: Value, options?: CacheSetOptions<Value>): Promise<void>;
+    /**
+     * Delete a cache key from all tiers
+     */
+    delete(key: string): Promise<void>;
+    /**
+     * Delete keys matching a wildcard pattern
+     */
+    deletePattern(pattern: string): Promise<void>;
+    /**
+     * Invalidate cache entries by tags
+     */
+    invalidateTags(tags: string[]): Promise<void>;
+    /**
+     * Wrap helper for cache-aside pattern
+     */
+    wrap(key: string, resolver: () => Promise<Value>, options?: CacheWrapOptions<Value>): Promise<Value>;
+    /**
+     * Memoize async functions
+     */
+    memoize<Func extends (...args: any[]) => Promise<Value>>(fn: Func, options?: MemoizeOptions<Value>): (...args: Parameters<Func>) => Promise<Value>;
+    /**
+     * Promote cache entry to higher tiers after a miss
+     */
+    private promoteToHigherTiers;
+    private calculateExpiry;
+    private indexTags;
+    /**
+     * Export current metrics for observability or admin UI
+     */
+    getStats(): {
+        tiers: {
+            name: string;
+        }[];
+        tags: string[];
+        defaultTTL: number;
+    };
+}
+//# sourceMappingURL=MultiTierCache.d.ts.map

package/dist/advanced/cache/MultiTierCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MultiTierCache.d.ts","sourceRoot":"","sources":["../../../src/advanced/cache/MultiTierCache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAiB,eAAe,EAAc,gBAAgB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAExH;;GAEG;AAEH,qBAAa,cAAc,CAAC,KAAK,GAAG,OAAO;IACvC,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,QAAQ,CAAyC;IACzD,OAAO,CAAC,UAAU,CAAS;gBAEf,KAAK,EAAE,eAAe,CAAC,KAAK,CAAC,EAAE,EAAE,UAAU,GAAE,MAAc;IAQvE;;OAEG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC;IAgBlD;;OAEG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,GAAE,eAAe,CAAC,KAAK,CAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBzF;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOxC;;OAEG;IACG,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBnD;;OAEG;IACG,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBnD;;OAEG;IACG,IAAI,CACN,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC,EAC9B,OAAO,GAAE,gBAAgB,CAAC,KAAK,CAAM,GACtC,OAAO,CAAC,KAAK,CAAC;IAajB;;OAEG;IACH,OAAO,CAAC,IAAI,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,KAAK,CAAC,EACnD,EAAE,EAAE,IAAI,EACR,OAAO,GAAE,cAAc,CAAC,KAAK,CAAM,GACpC,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,KAAK,CAAC;IAShD;;OAEG;YACW,oBAAoB;IAYlC,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,SAAS;IAWjB;;OAEG;IACH,QAAQ;;;;;;;CAOX"}

package/dist/advanced/cache/MultiTierCache.js

@@ -0,0 +1,159 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MultiTierCache = void 0;
+/**
+ * Multi-tier cache orchestrator
+ */
+class MultiTierCache {
+    tiers;
+    tagIndex = new Map();
+    defaultTTL;
+    constructor(tiers, defaultTTL = 60000) {
+        if (tiers.length === 0) {
+            throw new Error('MultiTierCache requires at least one tier');
+        }
+        this.tiers = tiers;
+        this.defaultTTL = defaultTTL;
+    }
+    /**
+     * Retrieve a value from the tiers starting from the fastest one
+     */
+    async get(key) {
+        for (let i = 0; i < this.tiers.length; i++) {
+            const tier = this.tiers[i];
+            const entry = await tier.store.get(key);
+            if (entry) {
+                if (i > 0) {
+                    // hydrate higher tiers for faster access next time
+                    await this.promoteToHigherTiers(key, entry, i);
+                }
+                return entry.value;
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Set a cache value across tiers
+     */
+    async set(key, value, options = {}) {
+        const expiresAt = this.calculateExpiry(options.ttl);
+        const entry = {
+            value,
+            expiresAt,
+            tags: options.tags,
+            meta: options.meta
+        };
+        await Promise.all(this.tiers.map(async (tier) => {
+            const ttl = tier.ttl ?? options.ttl ?? this.defaultTTL;
+            const tierEntry = {
+                ...entry,
+                expiresAt: this.calculateExpiry(ttl)
+            };
+            await tier.store.set(key, tierEntry);
+        }));
+        if (options.tags?.length) {
+            this.indexTags(key, options.tags, expiresAt);
+        }
+    }
+    /**
+     * Delete a cache key from all tiers
+     */
+    async delete(key) {
+        await Promise.all(this.tiers.map(tier => tier.store.delete(key)));
+        for (const entry of this.tagIndex.values()) {
+            entry.keys.delete(key);
+        }
+    }
+    /**
+     * Delete keys matching a wildcard pattern
+     */
+    async deletePattern(pattern) {
+        const regex = new RegExp('^' + pattern.replace(/\*/g, '.*').replace(/\?/g, '.') + '$');
+        for (const tier of this.tiers) {
+            const keys = tier.store.keys ? await tier.store.keys(regex) : [];
+            await Promise.all(keys.map(key => tier.store.delete(key)));
+        }
+        for (const entry of this.tagIndex.values()) {
+            for (const key of Array.from(entry.keys)) {
+                if (regex.test(key)) {
+                    entry.keys.delete(key);
+                }
+            }
+        }
+    }
+    /**
+     * Invalidate cache entries by tags
+     */
+    async invalidateTags(tags) {
+        const keysToDelete = new Set();
+        for (const tag of tags) {
+            const entry = this.tagIndex.get(tag);
+            if (!entry)
+                continue;
+            for (const key of entry.keys) {
+                keysToDelete.add(key);
+            }
+            this.tagIndex.delete(tag);
+        }
+        await Promise.all(Array.from(keysToDelete).map(key => this.delete(key)));
+    }
+    /**
+     * Wrap helper for cache-aside pattern
+     */
+    async wrap(key, resolver, options = {}) {
+        if (!options.refresh) {
+            const cached = await this.get(key);
+            if (cached !== undefined) {
+                return cached;
+            }
+        }
+        const value = await resolver();
+        await this.set(key, value, options);
+        return value;
+    }
+    /**
+     * Memoize async functions
+     */
+    memoize(fn, options = {}) {
+        const resolver = options.keyResolver || ((...args) => JSON.stringify(args));
+        return async (...args) => {
+            const key = resolver(...args);
+            return this.wrap(key, () => fn(...args), options);
+        };
+    }
+    /**
+     * Promote cache entry to higher tiers after a miss
+     */
+    async promoteToHigherTiers(key, entry, fromIndex) {
+        const tiersToHydrate = this.tiers.slice(0, fromIndex);
+        await Promise.all(tiersToHydrate.map(tier => tier.store.set(key, entry)));
+    }
+    calculateExpiry(ttl) {
+        if (!ttl) {
+            return undefined;
+        }
+        return Date.now() + ttl;
+    }
+    indexTags(key, tags, expiresAt) {
+        for (const tag of tags) {
+            const entry = this.tagIndex.get(tag) || { keys: new Set(), expiresAt };
+            entry.keys.add(key);
+            if (expiresAt) {
+                entry.expiresAt = expiresAt;
+            }
+            this.tagIndex.set(tag, entry);
+        }
+    }
+    /**
+     * Export current metrics for observability or admin UI
+     */
+    getStats() {
+        return {
+            tiers: this.tiers.map(tier => ({ name: tier.store.name })),
+            tags: Array.from(this.tagIndex.keys()),
+            defaultTTL: this.defaultTTL
+        };
+    }
+}
+exports.MultiTierCache = MultiTierCache;
+//# sourceMappingURL=MultiTierCache.js.map

package/dist/advanced/cache/MultiTierCache.js.map

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

package/dist/advanced/cache/RedisCacheStore.d.ts

@@ -0,0 +1,153 @@
+import { CacheStore, CacheEntry } from './types';
+/**
+ * Redis cache store configuration
+ */
+export interface RedisCacheConfig {
+    /**
+     * Redis connection URL
+     * @example 'redis://localhost:6379'
+     */
+    url?: string;
+    /**
+     * Redis host
+     * @default 'localhost'
+     */
+    host?: string;
+    /**
+     * Redis port
+     * @default 6379
+     */
+    port?: number;
+    /**
+     * Redis password
+     */
+    password?: string;
+    /**
+     * Redis database number
+     * @default 0
+     */
+    db?: number;
+    /**
+     * Key prefix for namespacing
+     * @default 'nexus:'
+     */
+    prefix?: string;
+    /**
+     * Connection timeout in milliseconds
+     * @default 5000
+     */
+    connectTimeout?: number;
+    /**
+     * Enable TLS/SSL
+     * @default false
+     */
+    tls?: boolean;
+    /**
+     * Lazy connect - don't connect immediately
+     * @default false
+     */
+    lazyConnect?: boolean;
+}
+/**
+ * Redis client interface
+ * Supports both 'redis' and 'ioredis' packages
+ */
+export interface RedisClientLike {
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string, options?: {
+        EX?: number;
+        PX?: number;
+    }): Promise<any>;
+    setex?(key: string, seconds: number, value: string): Promise<any>;
+    del(key: string | string[]): Promise<number>;
+    keys(pattern: string): Promise<string[]>;
+    flushdb?(): Promise<any>;
+    flushDb?(): Promise<any>;
+    quit?(): Promise<any>;
+    disconnect?(): Promise<any>;
+    on?(event: string, listener: (...args: any[]) => void): void;
+}
+/**
+ * Redis cache store with full feature support
+ *
+ * @example
+ * ```typescript
+ * // Using with ioredis
+ * import Redis from 'ioredis';
+ *
+ * const redis = new Redis({ host: 'localhost', port: 6379 });
+ * const cache = new RedisCacheStore('sessions', { client: redis });
+ *
+ * // Using with node-redis
+ * import { createClient } from 'redis';
+ *
+ * const client = createClient({ url: 'redis://localhost:6379' });
+ * await client.connect();
+ * const cache = new RedisCacheStore('sessions', { client });
+ * ```
+ */
+export declare class RedisCacheStore<Value = unknown> implements CacheStore<Value> {
+    readonly name: string;
+    private client;
+    private prefix;
+    private emitter;
+    private connected;
+    constructor(name: string, options: RedisCacheConfig & {
+        client: RedisClientLike;
+    });
+    /**
+     * Build the full Redis key with prefix
+     */
+    private buildKey;
+    /**
+     * Get a value from cache
+     */
+    get(key: string): Promise<CacheEntry<Value> | undefined>;
+    /**
+     * Set a value in cache
+     */
+    set(key: string, entry: CacheEntry<Value>): Promise<void>;
+    /**
+     * Delete a key from cache
+     */
+    delete(key: string): Promise<void>;
+    /**
+     * Clear all keys in this cache namespace
+     */
+    clear(): Promise<void>;
+    /**
+     * Get all keys matching a pattern
+     */
+    keys(pattern?: RegExp): Promise<string[]>;
+    /**
+     * Check if connected to Redis
+     */
+    isConnected(): boolean;
+    /**
+     * Subscribe to cache events
+     */
+    on(event: 'set' | 'delete' | 'clear' | 'connect' | 'disconnect' | 'error', listener: (...args: any[]) => void): void;
+    /**
+     * Disconnect from Redis
+     */
+    disconnect(): Promise<void>;
+}
+/**
+ * Create a Redis cache store with automatic client creation
+ * Requires 'ioredis' or 'redis' package to be installed
+ *
+ * @example
+ * ```typescript
+ * // Auto-create Redis client
+ * const cache = await createRedisCache('sessions', {
+ *   host: 'localhost',
+ *   port: 6379,
+ *   prefix: 'myapp:'
+ * });
+ *
+ * await cache.set('user:123', { value: { name: 'John' }, expiresAt: Date.now() + 3600000 });
+ * const user = await cache.get('user:123');
+ * ```
+ */
+export declare function createRedisCache<Value = unknown>(name: string, config?: RedisCacheConfig): Promise<RedisCacheStore<Value>>;
+//# sourceMappingURL=RedisCacheStore.d.ts.map

package/dist/advanced/cache/RedisCacheStore.d.ts.map

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