@beignet/provider-cache-redis 0.0.34 → 0.0.36

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # @beignet/provider-redis
 
+## 0.0.36
+
+## 0.0.35
+
+### Patch Changes
+
+- 397f106: Standardize framework-owned operational errors, degrade opaque OpenAPI path parameters safely, and add direct Redis, Pino, and Upstash adapters.
+- 7d0c795: Expose stable named provider types while keeping private config schemas out of package declarations and preserving validated config and contributed-port inference. Drizzle's Postgres and MySQL config schema constants are now internal; use the exported config interfaces for validated shapes.
+
 ## 0.0.34
 
 ### Patch Changes

package/README.md

@@ -10,6 +10,9 @@ The provider installs `ctx.ports.cache` using
 [ioredis](https://github.com/redis/ioredis) and exposes the raw Redis client
 separately as `ctx.ports.redis` for Redis-specific features.
 
+`createRedisCacheProvider(...)` returns the stable `RedisCacheProvider` type.
+`RedisConfig` describes its validated config; the Zod schema remains internal.
+
 ## Install
 
 ```bash
@@ -110,6 +113,24 @@ const provider = createRedisCacheProvider({
 Calling `createRedisCacheProvider()` with no options uses the env-backed
 defaults above.
 
+### Direct adapter
+
+Use `createRedisCache(...)` when the app already owns an ioredis client. The
+factory adapts the client to `CachePort` without connecting, disconnecting, or
+reading environment variables:
+
+```typescript
+import { createRedisCache } from "@beignet/provider-cache-redis";
+import { Redis } from "ioredis";
+
+const client = new Redis(process.env.APP_REDIS_URL!);
+const cache = createRedisCache({ client });
+```
+
+Pass `instrumentation` when direct cache operations should appear in Beignet
+provider instrumentation. The caller remains responsible for client startup,
+retry policy, health checks, and shutdown.
+
 ### Connection behavior
 
 During startup the provider connects eagerly and fails fast: the initial
@@ -222,6 +243,9 @@ type AppPorts = typeof basePorts & RedisCacheProviderPorts;
 // { cache: CachePort; redis: { client: Redis } }
 ```
 
+Direct wiring can use the exported `RedisCacheClient` and
+`CreateRedisCacheOptions` types without adopting the lifecycle provider ports.
+
 ## Lifecycle
 
 The Redis provider:

package/dist/index.d.ts

@@ -32,23 +32,18 @@
  * ```
  */
 import type { CachePort } from "@beignet/core/ports";
+import { type AnyProviderConfigSchema, type ProviderInstrumentationTarget, type ServiceProvider } from "@beignet/core/providers";
 import { Redis } from "ioredis";
-import { z } from "zod";
 /**
- * Configuration schema for the Redis provider.
- * Validates environment variables with REDIS_ prefix.
+ * Validated configuration for the Redis provider.
  */
-declare const RedisConfigSchema: z.ZodObject<{
-    URL: z.ZodString;
-    DB: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>>;
-    CONNECT_TIMEOUT_MS: z.ZodDefault<z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>>;
-    MAX_RETRIES_PER_REQUEST: z.ZodDefault<z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>>;
-    CONNECT_MAX_ATTEMPTS: z.ZodDefault<z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>>;
-}, z.core.$strip>;
-/**
- * Inferred configuration type for Redis provider.
- */
-export type RedisConfig = z.infer<typeof RedisConfigSchema>;
+export interface RedisConfig {
+    URL: string;
+    DB?: number;
+    CONNECT_TIMEOUT_MS: number;
+    MAX_RETRIES_PER_REQUEST: number;
+    CONNECT_MAX_ATTEMPTS: number;
+}
 /**
  * Options for {@link createRedisCacheProvider}.
  *
@@ -116,6 +111,31 @@ export interface RedisCacheProviderPorts {
      */
     redis: RedisEscapeHatch;
 }
+/**
+ * Redis cache lifecycle provider with stable contributed-port typing.
+ */
+export type RedisCacheProvider = ServiceProvider<unknown, AnyProviderConfigSchema<RedisConfig>, Pick<RedisCacheProviderPorts, keyof RedisCacheProviderPorts>>;
+/**
+ * Minimal ioredis client shape required by the direct cache adapter.
+ */
+export type RedisCacheClient = Pick<Redis, "get" | "set" | "del" | "exists">;
+/**
+ * Options for adapting an app-owned ioredis client directly.
+ */
+export interface CreateRedisCacheOptions {
+    /**
+     * Connected ioredis client. The caller owns connection and shutdown.
+     */
+    client: RedisCacheClient;
+    /**
+     * Optional provider instrumentation target.
+     */
+    instrumentation?: ProviderInstrumentationTarget;
+}
+/**
+ * Adapt an app-owned ioredis client to Beignet's stable CachePort.
+ */
+export declare function createRedisCache(options: CreateRedisCacheOptions): CachePort;
 /**
  * Create an env-backed Redis cache provider.
  *
@@ -127,18 +147,5 @@ export interface RedisCacheProviderPorts {
  * const provider = createRedisCacheProvider({ connectTimeoutMs: 2000 });
  * ```
  */
-export declare function createRedisCacheProvider(options?: RedisCacheProviderOptions): import("@beignet/core/providers").ServiceProvider<unknown, z.ZodObject<{
-    URL: z.ZodString;
-    CONNECT_MAX_ATTEMPTS: z.ZodDefault<z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>>;
-    DB: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>> | z.ZodDefault<z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>>;
-    CONNECT_TIMEOUT_MS: z.ZodDefault<z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>>;
-    MAX_RETRIES_PER_REQUEST: z.ZodDefault<z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>>;
-}, z.core.$strip>, {
-    cache: CachePort;
-    redis: {
-        client: Redis;
-        checkHealth: () => Promise<RedisHealth>;
-    };
-}, unknown, void>;
-export {};
+export declare function createRedisCacheProvider(options?: RedisCacheProviderOptions): RedisCacheProvider;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAKrD,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAYxB;;;GAGG;AACH,QAAA,MAAM,iBAAiB;;;;;;iBAgCrB,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D;;;;;GAKG;AACH,MAAM,WAAW,yBAAyB;IACxC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IAEjD;;;;OAIG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE;QACR,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,MAAM,EAAE,KAAK,CAAC;IACd;;OAEG;IACH,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,KAAK,EAAE,SAAS,CAAC;IACjB;;OAEG;IACH,KAAK,EAAE,gBAAgB,CAAC;CACzB;AAuCD;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,yBAA8B;;;;;;;;;;;;kBAwSxC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EACL,KAAK,uBAAuB,EAG5B,KAAK,6BAA6B,EAClC,KAAK,eAAe,EACrB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAmDhC;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,kBAAkB,EAAE,MAAM,CAAC;IAC3B,uBAAuB,EAAE,MAAM,CAAC;IAChC,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;GAKG;AACH,MAAM,WAAW,yBAAyB;IACxC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IAEjD;;;;OAIG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE;QACR,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,MAAM,EAAE,KAAK,CAAC;IACd;;OAEG;IACH,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,KAAK,EAAE,SAAS,CAAC;IACjB;;OAEG;IACH,KAAK,EAAE,gBAAgB,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,eAAe,CAC9C,OAAO,EACP,uBAAuB,CAAC,WAAW,CAAC,EACpC,IAAI,CAAC,uBAAuB,EAAE,MAAM,uBAAuB,CAAC,CAC7D,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,QAAQ,CAAC,CAAC;AAE7E;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,MAAM,EAAE,gBAAgB,CAAC;IACzB;;OAEG;IACH,eAAe,CAAC,EAAE,6BAA6B,CAAC;CACjD;AAuCD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,SAAS,CAsM5E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,yBAA8B,GACtC,kBAAkB,CAsGpB"}

package/dist/index.js

@@ -111,6 +111,198 @@ async function checkRedisHealth(client) {
         };
     }
 }
+/**
+ * Adapt an app-owned ioredis client to Beignet's stable CachePort.
+ */
+export function createRedisCache(options) {
+    const client = options.client;
+    const instrumentation = createProviderInstrumentation(options.instrumentation, {
+        providerName: "cache-redis",
+        watcher: "cache",
+    });
+    const recordCacheEvent = (event) => {
+        instrumentation.custom({
+            name: `cache.${event.operation}`,
+            label: `Cache ${event.operation}`,
+            summary: event.summary,
+            details: {
+                operation: event.operation,
+                key: event.key,
+                ...event.details,
+            },
+        });
+    };
+    return {
+        get: async (key) => {
+            const startedAt = Date.now();
+            try {
+                const value = await client.get(key);
+                recordCacheEvent({
+                    operation: "get",
+                    key,
+                    summary: value == null ? "Cache miss" : "Cache hit",
+                    details: {
+                        hit: value != null,
+                        durationMs: Date.now() - startedAt,
+                    },
+                });
+                return value;
+            }
+            catch (error) {
+                recordCacheEvent({
+                    operation: "get.failed",
+                    key,
+                    summary: "Cache get failed",
+                    details: {
+                        durationMs: Date.now() - startedAt,
+                        error: errorMessage(error),
+                    },
+                });
+                throw error;
+            }
+        },
+        set: async (key, value, cacheOptions) => {
+            const startedAt = Date.now();
+            try {
+                if (cacheOptions?.ttlSeconds != null && cacheOptions.ttlSeconds > 0) {
+                    await client.set(key, value, "EX", cacheOptions.ttlSeconds);
+                }
+                else {
+                    await client.set(key, value);
+                }
+                recordCacheEvent({
+                    operation: "set",
+                    key,
+                    summary: "Cache set",
+                    details: {
+                        ttlSeconds: cacheOptions?.ttlSeconds ?? null,
+                        durationMs: Date.now() - startedAt,
+                    },
+                });
+            }
+            catch (error) {
+                recordCacheEvent({
+                    operation: "set.failed",
+                    key,
+                    summary: "Cache set failed",
+                    details: {
+                        ttlSeconds: cacheOptions?.ttlSeconds ?? null,
+                        durationMs: Date.now() - startedAt,
+                        error: errorMessage(error),
+                    },
+                });
+                throw error;
+            }
+        },
+        delete: async (key) => {
+            const startedAt = Date.now();
+            try {
+                const deleted = (await client.del(key)) > 0;
+                recordCacheEvent({
+                    operation: "delete",
+                    key,
+                    summary: deleted ? "Cache key deleted" : "Cache key missing",
+                    details: {
+                        deleted,
+                        durationMs: Date.now() - startedAt,
+                    },
+                });
+                return deleted;
+            }
+            catch (error) {
+                recordCacheEvent({
+                    operation: "delete.failed",
+                    key,
+                    summary: "Cache delete failed",
+                    details: {
+                        durationMs: Date.now() - startedAt,
+                        error: errorMessage(error),
+                    },
+                });
+                throw error;
+            }
+        },
+        has: async (key) => {
+            const startedAt = Date.now();
+            try {
+                const result = await client.exists(key);
+                const exists = result === 1;
+                recordCacheEvent({
+                    operation: "has",
+                    key,
+                    summary: exists ? "Cache key exists" : "Cache key missing",
+                    details: {
+                        exists,
+                        durationMs: Date.now() - startedAt,
+                    },
+                });
+                return exists;
+            }
+            catch (error) {
+                recordCacheEvent({
+                    operation: "has.failed",
+                    key,
+                    summary: "Cache has failed",
+                    details: {
+                        durationMs: Date.now() - startedAt,
+                        error: errorMessage(error),
+                    },
+                });
+                throw error;
+            }
+        },
+        remember: async (key, factory, cacheOptions) => {
+            const startedAt = Date.now();
+            try {
+                const cached = await client.get(key);
+                if (cached != null) {
+                    recordCacheEvent({
+                        operation: "remember",
+                        key,
+                        summary: "Cache remember hit",
+                        details: {
+                            hit: true,
+                            ttlSeconds: cacheOptions?.ttlSeconds ?? null,
+                            durationMs: Date.now() - startedAt,
+                        },
+                    });
+                    return cached;
+                }
+                const value = await factory();
+                if (cacheOptions?.ttlSeconds != null && cacheOptions.ttlSeconds > 0) {
+                    await client.set(key, value, "EX", cacheOptions.ttlSeconds);
+                }
+                else {
+                    await client.set(key, value);
+                }
+                recordCacheEvent({
+                    operation: "remember",
+                    key,
+                    summary: "Cache remember miss",
+                    details: {
+                        hit: false,
+                        ttlSeconds: cacheOptions?.ttlSeconds ?? null,
+                        durationMs: Date.now() - startedAt,
+                    },
+                });
+                return value;
+            }
+            catch (error) {
+                recordCacheEvent({
+                    operation: "remember.failed",
+                    key,
+                    summary: "Cache remember failed",
+                    details: {
+                        ttlSeconds: cacheOptions?.ttlSeconds ?? null,
+                        durationMs: Date.now() - startedAt,
+                        error: errorMessage(error),
+                    },
+                });
+                throw error;
+            }
+        },
+    };
+}
 /**
  * Create an env-backed Redis cache provider.
  *
@@ -184,193 +376,7 @@ export function createRedisCacheProvider(options = {}) {
                 client.disconnect();
                 throw new Error(`[createRedisCacheProvider] Failed to connect to Redis at ${redactConnectionUrl(config.URL)}: ${errorMessage(error)}`);
             }
-            const instrumentation = createProviderInstrumentation(ports, {
-                providerName: "cache-redis",
-                watcher: "cache",
-            });
-            const recordCacheEvent = (event) => {
-                instrumentation.custom({
-                    name: `cache.${event.operation}`,
-                    label: `Cache ${event.operation}`,
-                    summary: event.summary,
-                    details: {
-                        operation: event.operation,
-                        key: event.key,
-                        ...event.details,
-                    },
-                });
-            };
-            // Extend ports with cache API
-            const cache = {
-                get: async (key) => {
-                    const startedAt = Date.now();
-                    try {
-                        const value = await client.get(key);
-                        recordCacheEvent({
-                            operation: "get",
-                            key,
-                            summary: value == null ? "Cache miss" : "Cache hit",
-                            details: {
-                                hit: value != null,
-                                durationMs: Date.now() - startedAt,
-                            },
-                        });
-                        return value;
-                    }
-                    catch (error) {
-                        recordCacheEvent({
-                            operation: "get.failed",
-                            key,
-                            summary: "Cache get failed",
-                            details: {
-                                durationMs: Date.now() - startedAt,
-                                error: errorMessage(error),
-                            },
-                        });
-                        throw error;
-                    }
-                },
-                set: async (key, value, options) => {
-                    const startedAt = Date.now();
-                    try {
-                        if (options?.ttlSeconds != null && options.ttlSeconds > 0) {
-                            await client.set(key, value, "EX", options.ttlSeconds);
-                        }
-                        else {
-                            await client.set(key, value);
-                        }
-                        recordCacheEvent({
-                            operation: "set",
-                            key,
-                            summary: "Cache set",
-                            details: {
-                                ttlSeconds: options?.ttlSeconds ?? null,
-                                durationMs: Date.now() - startedAt,
-                            },
-                        });
-                    }
-                    catch (error) {
-                        recordCacheEvent({
-                            operation: "set.failed",
-                            key,
-                            summary: "Cache set failed",
-                            details: {
-                                ttlSeconds: options?.ttlSeconds ?? null,
-                                durationMs: Date.now() - startedAt,
-                                error: errorMessage(error),
-                            },
-                        });
-                        throw error;
-                    }
-                },
-                delete: async (key) => {
-                    const startedAt = Date.now();
-                    try {
-                        const deleted = (await client.del(key)) > 0;
-                        recordCacheEvent({
-                            operation: "delete",
-                            key,
-                            summary: deleted ? "Cache key deleted" : "Cache key missing",
-                            details: {
-                                deleted,
-                                durationMs: Date.now() - startedAt,
-                            },
-                        });
-                        return deleted;
-                    }
-                    catch (error) {
-                        recordCacheEvent({
-                            operation: "delete.failed",
-                            key,
-                            summary: "Cache delete failed",
-                            details: {
-                                durationMs: Date.now() - startedAt,
-                                error: errorMessage(error),
-                            },
-                        });
-                        throw error;
-                    }
-                },
-                has: async (key) => {
-                    const startedAt = Date.now();
-                    try {
-                        const result = await client.exists(key);
-                        const exists = result === 1;
-                        recordCacheEvent({
-                            operation: "has",
-                            key,
-                            summary: exists ? "Cache key exists" : "Cache key missing",
-                            details: {
-                                exists,
-                                durationMs: Date.now() - startedAt,
-                            },
-                        });
-                        return exists;
-                    }
-                    catch (error) {
-                        recordCacheEvent({
-                            operation: "has.failed",
-                            key,
-                            summary: "Cache has failed",
-                            details: {
-                                durationMs: Date.now() - startedAt,
-                                error: errorMessage(error),
-                            },
-                        });
-                        throw error;
-                    }
-                },
-                remember: async (key, factory, options) => {
-                    const startedAt = Date.now();
-                    try {
-                        const cached = await client.get(key);
-                        if (cached != null) {
-                            recordCacheEvent({
-                                operation: "remember",
-                                key,
-                                summary: "Cache remember hit",
-                                details: {
-                                    hit: true,
-                                    ttlSeconds: options?.ttlSeconds ?? null,
-                                    durationMs: Date.now() - startedAt,
-                                },
-                            });
-                            return cached;
-                        }
-                        const value = await factory();
-                        if (options?.ttlSeconds != null && options.ttlSeconds > 0) {
-                            await client.set(key, value, "EX", options.ttlSeconds);
-                        }
-                        else {
-                            await client.set(key, value);
-                        }
-                        recordCacheEvent({
-                            operation: "remember",
-                            key,
-                            summary: "Cache remember miss",
-                            details: {
-                                hit: false,
-                                ttlSeconds: options?.ttlSeconds ?? null,
-                                durationMs: Date.now() - startedAt,
-                            },
-                        });
-                        return value;
-                    }
-                    catch (error) {
-                        recordCacheEvent({
-                            operation: "remember.failed",
-                            key,
-                            summary: "Cache remember failed",
-                            details: {
-                                ttlSeconds: options?.ttlSeconds ?? null,
-                                durationMs: Date.now() - startedAt,
-                                error: errorMessage(error),
-                            },
-                        });
-                        throw error;
-                    }
-                },
-            };
+            const cache = createRedisCache({ client, instrumentation: ports });
             return {
                 ports: {
                     cache,

package/dist/index.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@beignet/provider-cache-redis",
-  "version": "0.0.34",
+  "version": "0.0.36",
   "type": "module",
   "description": "Redis provider for Beignet - adds cache port using ioredis",
   "main": "./dist/index.js",

package/src/index.ts

@@ -34,8 +34,11 @@
 
 import type { CachePort } from "@beignet/core/ports";
 import {
+  type AnyProviderConfigSchema,
   createProvider,
   createProviderInstrumentation,
+  type ProviderInstrumentationTarget,
+  type ServiceProvider,
 } from "@beignet/core/providers";
 import { Redis } from "ioredis";
 import { z } from "zod";
@@ -86,12 +89,18 @@ const RedisConfigSchema = z.object({
    * Defaults to 3.
    */
   CONNECT_MAX_ATTEMPTS: NumberString.default(DEFAULT_CONNECT_MAX_ATTEMPTS),
-});
+}) satisfies z.ZodType<RedisConfig>;
 
 /**
- * Inferred configuration type for Redis provider.
+ * Validated configuration for the Redis provider.
  */
-export type RedisConfig = z.infer<typeof RedisConfigSchema>;
+export interface RedisConfig {
+  URL: string;
+  DB?: number;
+  CONNECT_TIMEOUT_MS: number;
+  MAX_RETRIES_PER_REQUEST: number;
+  CONNECT_MAX_ATTEMPTS: number;
+}
 
 /**
  * Options for {@link createRedisCacheProvider}.
@@ -167,6 +176,34 @@ export interface RedisCacheProviderPorts {
   redis: RedisEscapeHatch;
 }
 
+/**
+ * Redis cache lifecycle provider with stable contributed-port typing.
+ */
+export type RedisCacheProvider = ServiceProvider<
+  unknown,
+  AnyProviderConfigSchema<RedisConfig>,
+  Pick<RedisCacheProviderPorts, keyof RedisCacheProviderPorts>
+>;
+
+/**
+ * Minimal ioredis client shape required by the direct cache adapter.
+ */
+export type RedisCacheClient = Pick<Redis, "get" | "set" | "del" | "exists">;
+
+/**
+ * Options for adapting an app-owned ioredis client directly.
+ */
+export interface CreateRedisCacheOptions {
+  /**
+   * Connected ioredis client. The caller owns connection and shutdown.
+   */
+  client: RedisCacheClient;
+  /**
+   * Optional provider instrumentation target.
+   */
+  instrumentation?: ProviderInstrumentationTarget;
+}
+
 function errorMessage(error: unknown): string {
   return error instanceof Error ? error.message : String(error);
 }
@@ -204,6 +241,209 @@ async function checkRedisHealth(client: Redis): Promise<RedisHealth> {
   }
 }
 
+/**
+ * Adapt an app-owned ioredis client to Beignet's stable CachePort.
+ */
+export function createRedisCache(options: CreateRedisCacheOptions): CachePort {
+  const client = options.client;
+  const instrumentation = createProviderInstrumentation(
+    options.instrumentation,
+    {
+      providerName: "cache-redis",
+      watcher: "cache",
+    },
+  );
+
+  const recordCacheEvent = (event: {
+    operation: string;
+    key: string;
+    summary: string;
+    details?: Record<string, unknown>;
+  }) => {
+    instrumentation.custom({
+      name: `cache.${event.operation}`,
+      label: `Cache ${event.operation}`,
+      summary: event.summary,
+      details: {
+        operation: event.operation,
+        key: event.key,
+        ...event.details,
+      },
+    });
+  };
+
+  return {
+    get: async (key: string) => {
+      const startedAt = Date.now();
+      try {
+        const value = await client.get(key);
+        recordCacheEvent({
+          operation: "get",
+          key,
+          summary: value == null ? "Cache miss" : "Cache hit",
+          details: {
+            hit: value != null,
+            durationMs: Date.now() - startedAt,
+          },
+        });
+        return value;
+      } catch (error) {
+        recordCacheEvent({
+          operation: "get.failed",
+          key,
+          summary: "Cache get failed",
+          details: {
+            durationMs: Date.now() - startedAt,
+            error: errorMessage(error),
+          },
+        });
+        throw error;
+      }
+    },
+
+    set: async (key, value, cacheOptions) => {
+      const startedAt = Date.now();
+      try {
+        if (cacheOptions?.ttlSeconds != null && cacheOptions.ttlSeconds > 0) {
+          await client.set(key, value, "EX", cacheOptions.ttlSeconds);
+        } else {
+          await client.set(key, value);
+        }
+        recordCacheEvent({
+          operation: "set",
+          key,
+          summary: "Cache set",
+          details: {
+            ttlSeconds: cacheOptions?.ttlSeconds ?? null,
+            durationMs: Date.now() - startedAt,
+          },
+        });
+      } catch (error) {
+        recordCacheEvent({
+          operation: "set.failed",
+          key,
+          summary: "Cache set failed",
+          details: {
+            ttlSeconds: cacheOptions?.ttlSeconds ?? null,
+            durationMs: Date.now() - startedAt,
+            error: errorMessage(error),
+          },
+        });
+        throw error;
+      }
+    },
+
+    delete: async (key) => {
+      const startedAt = Date.now();
+      try {
+        const deleted = (await client.del(key)) > 0;
+        recordCacheEvent({
+          operation: "delete",
+          key,
+          summary: deleted ? "Cache key deleted" : "Cache key missing",
+          details: {
+            deleted,
+            durationMs: Date.now() - startedAt,
+          },
+        });
+        return deleted;
+      } catch (error) {
+        recordCacheEvent({
+          operation: "delete.failed",
+          key,
+          summary: "Cache delete failed",
+          details: {
+            durationMs: Date.now() - startedAt,
+            error: errorMessage(error),
+          },
+        });
+        throw error;
+      }
+    },
+
+    has: async (key) => {
+      const startedAt = Date.now();
+      try {
+        const result = await client.exists(key);
+        const exists = result === 1;
+        recordCacheEvent({
+          operation: "has",
+          key,
+          summary: exists ? "Cache key exists" : "Cache key missing",
+          details: {
+            exists,
+            durationMs: Date.now() - startedAt,
+          },
+        });
+        return exists;
+      } catch (error) {
+        recordCacheEvent({
+          operation: "has.failed",
+          key,
+          summary: "Cache has failed",
+          details: {
+            durationMs: Date.now() - startedAt,
+            error: errorMessage(error),
+          },
+        });
+        throw error;
+      }
+    },
+
+    remember: async (key, factory, cacheOptions) => {
+      const startedAt = Date.now();
+      try {
+        const cached = await client.get(key);
+        if (cached != null) {
+          recordCacheEvent({
+            operation: "remember",
+            key,
+            summary: "Cache remember hit",
+            details: {
+              hit: true,
+              ttlSeconds: cacheOptions?.ttlSeconds ?? null,
+              durationMs: Date.now() - startedAt,
+            },
+          });
+          return cached;
+        }
+
+        const value = await factory();
+        if (cacheOptions?.ttlSeconds != null && cacheOptions.ttlSeconds > 0) {
+          await client.set(key, value, "EX", cacheOptions.ttlSeconds);
+        } else {
+          await client.set(key, value);
+        }
+
+        recordCacheEvent({
+          operation: "remember",
+          key,
+          summary: "Cache remember miss",
+          details: {
+            hit: false,
+            ttlSeconds: cacheOptions?.ttlSeconds ?? null,
+            durationMs: Date.now() - startedAt,
+          },
+        });
+
+        return value;
+      } catch (error) {
+        recordCacheEvent({
+          operation: "remember.failed",
+          key,
+          summary: "Cache remember failed",
+          details: {
+            ttlSeconds: cacheOptions?.ttlSeconds ?? null,
+            durationMs: Date.now() - startedAt,
+            error: errorMessage(error),
+          },
+        });
+        throw error;
+      }
+    },
+  };
+}
+
 /**
  * Create an env-backed Redis cache provider.
  *
@@ -217,7 +457,7 @@ async function checkRedisHealth(client: Redis): Promise<RedisHealth> {
  */
 export function createRedisCacheProvider(
   options: RedisCacheProviderOptions = {},
-) {
+): RedisCacheProvider {
   const ConfigSchema = RedisConfigSchema.extend({
     DB:
       options.db !== undefined
@@ -299,200 +539,7 @@ export function createRedisCacheProvider(
         );
       }
 
-      const instrumentation = createProviderInstrumentation(ports, {
-        providerName: "cache-redis",
-        watcher: "cache",
-      });
-
-      const recordCacheEvent = (event: {
-        operation: string;
-        key: string;
-        summary: string;
-        details?: Record<string, unknown>;
-      }) => {
-        instrumentation.custom({
-          name: `cache.${event.operation}`,
-          label: `Cache ${event.operation}`,
-          summary: event.summary,
-          details: {
-            operation: event.operation,
-            key: event.key,
-            ...event.details,
-          },
-        });
-      };
-
-      // Extend ports with cache API
-      const cache: CachePort = {
-        get: async (key: string) => {
-          const startedAt = Date.now();
-          try {
-            const value = await client.get(key);
-            recordCacheEvent({
-              operation: "get",
-              key,
-              summary: value == null ? "Cache miss" : "Cache hit",
-              details: {
-                hit: value != null,
-                durationMs: Date.now() - startedAt,
-              },
-            });
-            return value;
-          } catch (error) {
-            recordCacheEvent({
-              operation: "get.failed",
-              key,
-              summary: "Cache get failed",
-              details: {
-                durationMs: Date.now() - startedAt,
-                error: errorMessage(error),
-              },
-            });
-            throw error;
-          }
-        },
-
-        set: async (key, value, options) => {
-          const startedAt = Date.now();
-          try {
-            if (options?.ttlSeconds != null && options.ttlSeconds > 0) {
-              await client.set(key, value, "EX", options.ttlSeconds);
-            } else {
-              await client.set(key, value);
-            }
-            recordCacheEvent({
-              operation: "set",
-              key,
-              summary: "Cache set",
-              details: {
-                ttlSeconds: options?.ttlSeconds ?? null,
-                durationMs: Date.now() - startedAt,
-              },
-            });
-          } catch (error) {
-            recordCacheEvent({
-              operation: "set.failed",
-              key,
-              summary: "Cache set failed",
-              details: {
-                ttlSeconds: options?.ttlSeconds ?? null,
-                durationMs: Date.now() - startedAt,
-                error: errorMessage(error),
-              },
-            });
-            throw error;
-          }
-        },
-
-        delete: async (key) => {
-          const startedAt = Date.now();
-          try {
-            const deleted = (await client.del(key)) > 0;
-            recordCacheEvent({
-              operation: "delete",
-              key,
-              summary: deleted ? "Cache key deleted" : "Cache key missing",
-              details: {
-                deleted,
-                durationMs: Date.now() - startedAt,
-              },
-            });
-            return deleted;
-          } catch (error) {
-            recordCacheEvent({
-              operation: "delete.failed",
-              key,
-              summary: "Cache delete failed",
-              details: {
-                durationMs: Date.now() - startedAt,
-                error: errorMessage(error),
-              },
-            });
-            throw error;
-          }
-        },
-
-        has: async (key) => {
-          const startedAt = Date.now();
-          try {
-            const result = await client.exists(key);
-            const exists = result === 1;
-            recordCacheEvent({
-              operation: "has",
-              key,
-              summary: exists ? "Cache key exists" : "Cache key missing",
-              details: {
-                exists,
-                durationMs: Date.now() - startedAt,
-              },
-            });
-            return exists;
-          } catch (error) {
-            recordCacheEvent({
-              operation: "has.failed",
-              key,
-              summary: "Cache has failed",
-              details: {
-                durationMs: Date.now() - startedAt,
-                error: errorMessage(error),
-              },
-            });
-            throw error;
-          }
-        },
-
-        remember: async (key, factory, options) => {
-          const startedAt = Date.now();
-          try {
-            const cached = await client.get(key);
-            if (cached != null) {
-              recordCacheEvent({
-                operation: "remember",
-                key,
-                summary: "Cache remember hit",
-                details: {
-                  hit: true,
-                  ttlSeconds: options?.ttlSeconds ?? null,
-                  durationMs: Date.now() - startedAt,
-                },
-              });
-              return cached;
-            }
-
-            const value = await factory();
-            if (options?.ttlSeconds != null && options.ttlSeconds > 0) {
-              await client.set(key, value, "EX", options.ttlSeconds);
-            } else {
-              await client.set(key, value);
-            }
-
-            recordCacheEvent({
-              operation: "remember",
-              key,
-              summary: "Cache remember miss",
-              details: {
-                hit: false,
-                ttlSeconds: options?.ttlSeconds ?? null,
-                durationMs: Date.now() - startedAt,
-              },
-            });
-
-            return value;
-          } catch (error) {
-            recordCacheEvent({
-              operation: "remember.failed",
-              key,
-              summary: "Cache remember failed",
-              details: {
-                ttlSeconds: options?.ttlSeconds ?? null,
-                durationMs: Date.now() - startedAt,
-                error: errorMessage(error),
-              },
-            });
-            throw error;
-          }
-        },
-      };
+      const cache = createRedisCache({ client, instrumentation: ports });
 
       return {
         ports: {