ff-serv 0.1.10 → 0.1.11

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/http/basic.ts","../src/http/fetch-handler.ts","../src/logger.ts","../src/port.ts"],"sourcesContent":["import { Effect } from 'effect';\nimport { type AnyResponse, Handler } from './fetch-handler.js';\n\nexport namespace Path {\n\texport type Type = `/${string}` | ((url: URL) => boolean);\n\texport function matched(path: Type, url: URL) {\n\t\treturn typeof path === 'function' ? path(url) : path === url.pathname;\n\t}\n}\n\nexport namespace Fn {\n\ttype Input = [request: Request];\n\n\ttype OutputSync = AnyResponse;\n\ttype OutputEffect<R> = Effect.Effect<AnyResponse, unknown, R>;\n\n\texport type FnSync = (...input: Input) => OutputSync;\n\texport type FnEffect<R> = (...input: Input) => OutputEffect<R>;\n\texport type FnAny<R> = (...input: Input) => OutputSync | OutputEffect<R>;\n\n\texport function exec<R>(fn: FnAny<R>, ...[request]: Input) {\n\t\tconst response = fn(request);\n\t\tif (!Effect.isEffect(response)) return Effect.succeed(response);\n\t\treturn response;\n\t}\n}\n\nexport function basicHandler(\n\tpath: Path.Type,\n\tfn: Fn.FnSync,\n): Handler<'basicHandler', never>;\nexport function basicHandler<R>(\n\tpath: Path.Type,\n\tfn: Fn.FnEffect<R>,\n): Handler<'basicHandler', R>;\nexport function basicHandler<R>(path: Path.Type, fn: Fn.FnAny<R>) {\n\treturn new Handler('basicHandler', ({ url, request }) => {\n\t\tif (!Path.matched(path, url))\n\t\t\treturn Effect.succeed({ matched: false, response: undefined });\n\n\t\treturn Effect.gen(function* () {\n\t\t\treturn {\n\t\t\t\tmatched: true,\n\t\t\t\tresponse: yield* Fn.exec(fn, request),\n\t\t\t};\n\t\t});\n\t});\n}\n","import { Effect, FiberSet } from 'effect';\nimport type { Cause } from 'effect/Cause';\nimport { nanoid } from 'nanoid';\nimport { Logger } from '../logger.js';\n\n// #region Handler\n\nexport type AnyResponse = Response | Promise<Response>;\n\nexport type HandlerResult =\n\t| {\n\t\t\tmatched: true;\n\t\t\tresponse: AnyResponse;\n\t  }\n\t| {\n\t\t\tmatched: false;\n\t\t\tresponse: undefined;\n\t  };\n\nexport class Handler<NAME extends string, R> {\n\tconstructor(\n\t\treadonly _tag: NAME,\n\t\treadonly handle: (opt: {\n\t\t\turl: URL;\n\t\t\trequest: Request;\n\t\t}) => Effect.Effect<HandlerResult, unknown, R>,\n\t) {}\n}\n\n// #endregion\n\ntype ExtractRequirements<T> = T extends Handler<string, infer R> ? R : never;\n\nexport const createFetchHandler = <\n\tconst HANDLERS extends [\n\t\tHandler<string, unknown>,\n\t\t...Array<Handler<string, unknown>>,\n\t],\n\tR = ExtractRequirements<HANDLERS[number]>,\n>(\n\thandlers: HANDLERS,\n\topts?: {\n\t\tdebug?: boolean;\n\t\tonError?: (ctx: {\n\t\t\terror: Cause<unknown>;\n\t\t}) => Effect.Effect<unknown, unknown>;\n\t},\n) =>\n\tEffect.gen(function* () {\n\t\tconst runFork = yield* FiberSet.makeRuntimePromise<R>();\n\t\treturn async (request: Request) => {\n\t\t\tconst urlObj = new URL(request.url);\n\t\t\tconst requestId = nanoid(6);\n\n\t\t\tconst effect = Effect.gen(function* () {\n\t\t\t\tyield* Logger.info(\n\t\t\t\t\t{ request: { pathname: urlObj.pathname } },\n\t\t\t\t\t'Request started',\n\t\t\t\t);\n\n\t\t\t\tfor (const handler of handlers) {\n\t\t\t\t\tif (!handler) continue;\n\n\t\t\t\t\tconst result = yield* handler.handle({ url: urlObj, request }).pipe(\n\t\t\t\t\t\tEffect.flatMap(({ matched, response }) =>\n\t\t\t\t\t\t\tEffect.gen(function* () {\n\t\t\t\t\t\t\t\tif (matched) {\n\t\t\t\t\t\t\t\t\treturn {\n\t\t\t\t\t\t\t\t\t\tmatched: true,\n\t\t\t\t\t\t\t\t\t\tresponse:\n\t\t\t\t\t\t\t\t\t\t\tresponse instanceof Promise\n\t\t\t\t\t\t\t\t\t\t\t\t? yield* Effect.tryPromise(() => response)\n\t\t\t\t\t\t\t\t\t\t\t\t: response,\n\t\t\t\t\t\t\t\t\t} as const;\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\treturn { matched: false, response: undefined } as const;\n\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t),\n\t\t\t\t\t\tEffect.catchAllCause((error) =>\n\t\t\t\t\t\t\tEffect.gen(function* () {\n\t\t\t\t\t\t\t\tyield* Logger.error(\n\t\t\t\t\t\t\t\t\t{ error },\n\t\t\t\t\t\t\t\t\t`Unhandled exception in HTTP handler '${handler._tag}'`,\n\t\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\t\tif (opts?.onError) yield* opts.onError({ error });\n\t\t\t\t\t\t\t\treturn {\n\t\t\t\t\t\t\t\t\tmatched: true,\n\t\t\t\t\t\t\t\t\tresponse: new Response('Internal Server Error', {\n\t\t\t\t\t\t\t\t\t\tstatus: 500,\n\t\t\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t\t\t} as const;\n\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t),\n\t\t\t\t\t);\n\n\t\t\t\t\tif (opts?.debug)\n\t\t\t\t\t\tyield* Logger.debug(\n\t\t\t\t\t\t\t{ handler: handler._tag, request, result },\n\t\t\t\t\t\t\t'Processed handler',\n\t\t\t\t\t\t);\n\n\t\t\t\t\tif (!result.matched) continue;\n\t\t\t\t\treturn result.response;\n\t\t\t\t}\n\n\t\t\t\treturn new Response('Not Found', { status: 404 });\n\t\t\t}).pipe(\n\t\t\t\tEffect.tap((response) =>\n\t\t\t\t\tresponse.ok\n\t\t\t\t\t\t? Logger.info(`Request completed with status ${response.status}`)\n\t\t\t\t\t\t: Logger.warn(`Request completed with status ${response.status}`),\n\t\t\t\t),\n\t\t\t\tEffect.withSpan('http'),\n\t\t\t\tEffect.annotateLogs({ requestId }),\n\t\t\t\tEffect.scoped,\n\t\t\t) as Effect.Effect<Response, never, R>;\n\n\t\t\treturn runFork(effect);\n\t\t};\n\t});\n","import { Effect, FiberSet, Runtime } from 'effect';\n\ntype LogParams = [obj: unknown, msg?: string];\nfunction extractParams(...[obj, msg]: LogParams) {\n\tif (typeof obj === 'string') {\n\t\treturn { message: obj };\n\t}\n\treturn { message: msg, attributes: obj as Record<string, any> };\n}\n\nexport namespace Logger {\n\texport const sync = () =>\n\t\tEffect.gen(function* () {\n\t\t\tconst runtime = yield* Effect.runtime();\n\n\t\t\tconst run = (e: Effect.Effect<void, never, never>) => {\n\t\t\t\t// Intentionally ignoring the await here\n\t\t\t\t// void runPromise(e);\n\t\t\t\tvoid Runtime.runPromise(runtime)(e);\n\t\t\t};\n\n\t\t\treturn {\n\t\t\t\tinfo: (...params: Parameters<typeof Logger.info>) =>\n\t\t\t\t\trun(Logger.info(...params)),\n\t\t\t\tdebug: (...params: Parameters<typeof Logger.debug>) =>\n\t\t\t\t\trun(Logger.debug(...params)),\n\t\t\t\twarn: (...params: Parameters<typeof Logger.warn>) =>\n\t\t\t\t\trun(Logger.warn(...params)),\n\t\t\t\terror: (...params: Parameters<typeof Logger.error>) =>\n\t\t\t\t\trun(Logger.error(...params)),\n\t\t\t};\n\t\t});\n\n\t// --\n\n\texport const info = (...params: LogParams) =>\n\t\tEffect.gen(function* () {\n\t\t\tconst { message, attributes } = extractParams(...params);\n\t\t\tyield* Effect.logInfo(message).pipe(\n\t\t\t\tattributes ? Effect.annotateLogs(attributes) : (e) => e,\n\t\t\t);\n\t\t});\n\n\texport const debug = (...params: LogParams) =>\n\t\tEffect.gen(function* () {\n\t\t\tconst { message, attributes } = extractParams(...params);\n\t\t\tyield* Effect.logDebug(message).pipe(\n\t\t\t\tattributes ? Effect.annotateLogs(attributes) : (e) => e,\n\t\t\t);\n\t\t});\n\n\texport const warn = (...params: LogParams) =>\n\t\tEffect.gen(function* () {\n\t\t\tconst { message, attributes } = extractParams(...params);\n\t\t\tyield* Effect.logWarning(message).pipe(\n\t\t\t\tattributes ? Effect.annotateLogs(attributes) : (e) => e,\n\t\t\t);\n\t\t});\n\n\texport const error = (...params: LogParams) =>\n\t\tEffect.gen(function* () {\n\t\t\tconst { message, attributes } = extractParams(...params);\n\t\t\tyield* Effect.logError(message).pipe(\n\t\t\t\tattributes ? Effect.annotateLogs(attributes) : (e) => e,\n\t\t\t);\n\t\t});\n}\n","import { Effect } from 'effect';\nimport * as GetPort from 'get-port';\n\nexport const getPort = (options?: GetPort.Options) =>\n\tEffect.tryPromise(() => GetPort.default(options));\n"],"mappings":"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","names":["Effect","Effect","FiberSet","Logger","Effect","FiberSet","Path","Fn","Effect","Effect"]}
+{"version":3,"sources":["../src/http/basic.ts","../src/http/fetch-handler.ts","../src/logger.ts","../src/port.ts"],"sourcesContent":["import { Effect } from 'effect';\nimport { type AnyResponse, Handler } from './fetch-handler.js';\n\nexport namespace Path {\n\texport type Type = `/${string}` | ((url: URL) => boolean);\n\texport function matched(path: Type, url: URL) {\n\t\treturn typeof path === 'function' ? path(url) : path === url.pathname;\n\t}\n}\n\nexport namespace Fn {\n\ttype Input = [request: Request];\n\n\ttype OutputSync = AnyResponse;\n\ttype OutputEffect<R> = Effect.Effect<AnyResponse, unknown, R>;\n\n\texport type FnSync = (...input: Input) => OutputSync;\n\texport type FnEffect<R> = (...input: Input) => OutputEffect<R>;\n\texport type FnAny<R> = (...input: Input) => OutputSync | OutputEffect<R>;\n\n\texport function exec<R>(fn: FnAny<R>, ...[request]: Input) {\n\t\tconst response = fn(request);\n\t\tif (!Effect.isEffect(response)) return Effect.succeed(response);\n\t\treturn response;\n\t}\n}\n\nexport function basicHandler(\n\tpath: Path.Type,\n\tfn: Fn.FnSync,\n): Handler<'basicHandler', never>;\nexport function basicHandler<R>(\n\tpath: Path.Type,\n\tfn: Fn.FnEffect<R>,\n): Handler<'basicHandler', R>;\nexport function basicHandler<R>(path: Path.Type, fn: Fn.FnAny<R>) {\n\treturn new Handler('basicHandler', ({ url, request }) => {\n\t\tif (!Path.matched(path, url))\n\t\t\treturn Effect.succeed({ matched: false, response: undefined });\n\n\t\treturn Effect.gen(function* () {\n\t\t\treturn {\n\t\t\t\tmatched: true,\n\t\t\t\tresponse: yield* Fn.exec(fn, request),\n\t\t\t};\n\t\t});\n\t});\n}\n","import { Effect, FiberSet } from 'effect';\nimport type { Cause } from 'effect/Cause';\nimport { nanoid } from 'nanoid';\nimport { Logger } from '../logger.js';\n\n// #region Handler\n\nexport type AnyResponse = Response | Promise<Response>;\n\nexport type HandlerResult =\n\t| {\n\t\t\tmatched: true;\n\t\t\tresponse: AnyResponse;\n\t  }\n\t| {\n\t\t\tmatched: false;\n\t\t\tresponse: undefined;\n\t  };\n\nexport class Handler<NAME extends string, R> {\n\tconstructor(\n\t\treadonly _tag: NAME,\n\t\treadonly handle: (opt: {\n\t\t\turl: URL;\n\t\t\trequest: Request;\n\t\t}) => Effect.Effect<HandlerResult, unknown, R>,\n\t) {}\n}\n\n// #endregion\n\ntype ExtractRequirements<T> = T extends Handler<string, infer R> ? R : never;\n\nexport const createFetchHandler = <\n\tconst HANDLERS extends [\n\t\tHandler<string, unknown>,\n\t\t...Array<Handler<string, unknown>>,\n\t],\n\tR = ExtractRequirements<HANDLERS[number]>,\n>(\n\thandlers: HANDLERS,\n\topts?: {\n\t\tdebug?: boolean;\n\t\tonError?: (ctx: {\n\t\t\terror: Cause<unknown>;\n\t\t}) => Effect.Effect<unknown, unknown>;\n\t},\n) =>\n\tEffect.gen(function* () {\n\t\tconst runFork = yield* FiberSet.makeRuntimePromise<R>();\n\t\treturn async (request: Request) => {\n\t\t\tconst urlObj = new URL(request.url);\n\t\t\tconst requestId = nanoid(6);\n\n\t\t\tconst effect = Effect.gen(function* () {\n\t\t\t\tyield* Logger.info(\n\t\t\t\t\t{ request: { pathname: urlObj.pathname } },\n\t\t\t\t\t'Request started',\n\t\t\t\t);\n\n\t\t\t\tfor (const handler of handlers) {\n\t\t\t\t\tif (!handler) continue;\n\n\t\t\t\t\tconst result = yield* handler.handle({ url: urlObj, request }).pipe(\n\t\t\t\t\t\tEffect.flatMap(({ matched, response }) =>\n\t\t\t\t\t\t\tEffect.gen(function* () {\n\t\t\t\t\t\t\t\tif (matched) {\n\t\t\t\t\t\t\t\t\treturn {\n\t\t\t\t\t\t\t\t\t\tmatched: true,\n\t\t\t\t\t\t\t\t\t\tresponse:\n\t\t\t\t\t\t\t\t\t\t\tresponse instanceof Promise\n\t\t\t\t\t\t\t\t\t\t\t\t? yield* Effect.tryPromise(() => response)\n\t\t\t\t\t\t\t\t\t\t\t\t: response,\n\t\t\t\t\t\t\t\t\t} as const;\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\treturn { matched: false, response: undefined } as const;\n\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t),\n\t\t\t\t\t\tEffect.catchAllCause((error) =>\n\t\t\t\t\t\t\tEffect.gen(function* () {\n\t\t\t\t\t\t\t\tyield* Logger.error(\n\t\t\t\t\t\t\t\t\t{ error },\n\t\t\t\t\t\t\t\t\t`Unhandled exception in HTTP handler '${handler._tag}'`,\n\t\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\t\tif (opts?.onError) yield* opts.onError({ error });\n\t\t\t\t\t\t\t\treturn {\n\t\t\t\t\t\t\t\t\tmatched: true,\n\t\t\t\t\t\t\t\t\tresponse: new Response('Internal Server Error', {\n\t\t\t\t\t\t\t\t\t\tstatus: 500,\n\t\t\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t\t\t} as const;\n\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t),\n\t\t\t\t\t);\n\n\t\t\t\t\tif (opts?.debug)\n\t\t\t\t\t\tyield* Logger.debug(\n\t\t\t\t\t\t\t{ handler: handler._tag, request, result },\n\t\t\t\t\t\t\t'Processed handler',\n\t\t\t\t\t\t);\n\n\t\t\t\t\tif (!result.matched) continue;\n\t\t\t\t\treturn result.response;\n\t\t\t\t}\n\n\t\t\t\treturn new Response('Not Found', { status: 404 });\n\t\t\t}).pipe(\n\t\t\t\tEffect.tap((response) =>\n\t\t\t\t\tresponse.ok\n\t\t\t\t\t\t? Logger.info(`Request completed with status ${response.status}`)\n\t\t\t\t\t\t: Logger.warn(`Request completed with status ${response.status}`),\n\t\t\t\t),\n\t\t\t\tEffect.withSpan('http'),\n\t\t\t\tEffect.annotateLogs({ requestId }),\n\t\t\t\tEffect.scoped,\n\t\t\t) as Effect.Effect<Response, never, R>;\n\n\t\t\treturn runFork(effect);\n\t\t};\n\t});\n","import { Effect, Runtime } from 'effect';\n\ntype LogParams = [obj: unknown, msg?: string];\nfunction extractParams(...[obj, msg]: LogParams) {\n\tif (typeof obj === 'string') {\n\t\treturn { message: obj };\n\t}\n\t// biome-ignore lint/suspicious/noExplicitAny: log attributes are unstructured\n\treturn { message: msg, attributes: obj as Record<string, any> };\n}\n\n// biome-ignore lint/suspicious/noExplicitAny: log annotations are unstructured\ntype LogAnnotations = Record<string, any>;\n\nexport type SyncLogger = {\n\tinfo: (...params: Parameters<typeof Logger.info>) => void;\n\tdebug: (...params: Parameters<typeof Logger.debug>) => void;\n\twarn: (...params: Parameters<typeof Logger.warn>) => void;\n\terror: (...params: Parameters<typeof Logger.error>) => void;\n\tchild: (annotations: LogAnnotations) => SyncLogger;\n};\n\nfunction makeSyncLogger(\n\truntime: Runtime.Runtime<never>,\n\tannotations: LogAnnotations,\n): SyncLogger {\n\tconst run = (e: Effect.Effect<void, never, never>) => {\n\t\tconst annotated =\n\t\t\tObject.keys(annotations).length > 0\n\t\t\t\t? e.pipe(Effect.annotateLogs(annotations))\n\t\t\t\t: e;\n\t\tvoid Runtime.runPromise(runtime)(annotated);\n\t};\n\n\treturn {\n\t\tinfo: (...params: Parameters<typeof Logger.info>) =>\n\t\t\trun(Logger.info(...params)),\n\t\tdebug: (...params: Parameters<typeof Logger.debug>) =>\n\t\t\trun(Logger.debug(...params)),\n\t\twarn: (...params: Parameters<typeof Logger.warn>) =>\n\t\t\trun(Logger.warn(...params)),\n\t\terror: (...params: Parameters<typeof Logger.error>) =>\n\t\t\trun(Logger.error(...params)),\n\t\tchild: (childAnnotations: LogAnnotations) =>\n\t\t\tmakeSyncLogger(runtime, { ...annotations, ...childAnnotations }),\n\t};\n}\n\nexport namespace Logger {\n\texport const sync = (annotations?: LogAnnotations) =>\n\t\tEffect.gen(function* () {\n\t\t\tconst runtime = yield* Effect.runtime();\n\t\t\treturn makeSyncLogger(runtime, annotations ?? {});\n\t\t});\n\n\t// --\n\n\texport const info = (...params: LogParams) =>\n\t\tEffect.gen(function* () {\n\t\t\tconst { message, attributes } = extractParams(...params);\n\t\t\tyield* Effect.logInfo(message).pipe(\n\t\t\t\tattributes ? Effect.annotateLogs(attributes) : (e) => e,\n\t\t\t);\n\t\t});\n\n\texport const debug = (...params: LogParams) =>\n\t\tEffect.gen(function* () {\n\t\t\tconst { message, attributes } = extractParams(...params);\n\t\t\tyield* Effect.logDebug(message).pipe(\n\t\t\t\tattributes ? Effect.annotateLogs(attributes) : (e) => e,\n\t\t\t);\n\t\t});\n\n\texport const warn = (...params: LogParams) =>\n\t\tEffect.gen(function* () {\n\t\t\tconst { message, attributes } = extractParams(...params);\n\t\t\tyield* Effect.logWarning(message).pipe(\n\t\t\t\tattributes ? Effect.annotateLogs(attributes) : (e) => e,\n\t\t\t);\n\t\t});\n\n\texport const error = (...params: LogParams) =>\n\t\tEffect.gen(function* () {\n\t\t\tconst { message, attributes } = extractParams(...params);\n\t\t\tyield* Effect.logError(message).pipe(\n\t\t\t\tattributes ? Effect.annotateLogs(attributes) : (e) => e,\n\t\t\t);\n\t\t});\n}\n","import { Effect } from 'effect';\nimport * as GetPort from 'get-port';\n\nexport const getPort = (options?: GetPort.Options) =>\n\tEffect.tryPromise(() => GetPort.default(options));\n"],"mappings":"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","names":["Effect","Effect","Logger","Effect","Path","Fn","Effect","Effect"]}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "ff-serv",
-	"version": "0.1.10",
+	"version": "0.1.11",
 	"type": "module",
 	"bin": {
 		"ff-serv": "./dist/cli.js"
@@ -15,6 +15,21 @@
 			"types": "./dist/exports/orpc.d.ts",
 			"import": "./dist/exports/orpc.js",
 			"require": "./dist/exports/orpc.cjs"
+		},
+		"./cache": {
+			"types": "./dist/exports/cache.d.ts",
+			"import": "./dist/exports/cache.js",
+			"require": "./dist/exports/cache.cjs"
+		},
+		"./cache/ioredis": {
+			"types": "./dist/exports/cache-ioredis.d.ts",
+			"import": "./dist/exports/cache-ioredis.js",
+			"require": "./dist/exports/cache-ioredis.cjs"
+		},
+		"./cache/bun-redis": {
+			"types": "./dist/exports/cache-bun-redis.d.ts",
+			"import": "./dist/exports/cache-bun-redis.js",
+			"require": "./dist/exports/cache-bun-redis.cjs"
 		}
 	},
 	"files": [
@@ -24,6 +39,8 @@
 	"scripts": {
 		"build": "tsup && bun run build:cli",
 		"build:cli": "bun build src/cli/index.ts --production --target=bun --outfile dist/cli.js",
+		"check:tsc": "tsgo --noEmit",
+		"check:lint": "biome check",
 		"test": "bun -b vitest run",
 		"dev": "tsup --watch"
 	},
@@ -34,6 +51,7 @@
 		"@orpc/client": "^1.13.2",
 		"@types/bun": "^1.3.2",
 		"@types/cli-progress": "^3.11.6",
+		"@typescript/native-preview": "^7.0.0-dev.20260216.1",
 		"cli-progress": "^3.12.0",
 		"ff-effect": "^0.0.10",
 		"inquirer": "^12.10.0",
@@ -46,7 +64,13 @@
 		"effect": "^3",
 		"@effect/opentelemetry": "^0.60.0",
 		"get-port": "^7",
-		"@orpc/server": "^1"
+		"@orpc/server": "^1",
+		"ioredis": "^5"
+	},
+	"peerDependenciesMeta": {
+		"ioredis": {
+			"optional": true
+		}
 	},
 	"publishConfig": {
 		"access": "public"

package/src/cache/AGENTS.md

@@ -0,0 +1,8 @@
+# Cache Module
+
+In-memory caching with SWR (stale-while-revalidate) and pluggable persistence adapters, built on Effect's `Cache`.
+
+- `cache.ts` — `Cache.make()`, SWR logic, `Cache.entry()` for per-entry TTL overrides
+- `adapter.ts` — `CacheAdapter` interface with `memory()`, `redis()`, `tiered()`
+- `adapters/` — Redis client adapters (ioredis, bun-redis) that wrap clients to `RedisClient` interface
+- User-facing docs: `docs/cache.md`

package/src/cache/adapter.test.ts

@@ -0,0 +1,181 @@
+import { it } from '@effect/vitest';
+import { Duration, Effect, Option } from 'effect';
+import { describe, expect } from 'vitest';
+import { CacheAdapter } from './adapter.js';
+
+describe('CacheAdapter', () => {
+	describe('memory', () => {
+		it.effect('get returns None', () =>
+			Effect.gen(function* () {
+				const adapter = CacheAdapter.memory();
+				const result = yield* adapter.get('key');
+				expect(Option.isNone(result)).toBe(true);
+			}),
+		);
+
+		it.effect('set and remove are no-ops', () =>
+			Effect.gen(function* () {
+				const adapter = CacheAdapter.memory();
+				yield* adapter.set(
+					'key',
+					{ value: 'val', storedAt: 0 },
+					Duration.minutes(5),
+				);
+				yield* adapter.remove('key');
+				yield* adapter.removeAll;
+				// Should not throw
+				const result = yield* adapter.get('key');
+				expect(Option.isNone(result)).toBe(true);
+			}),
+		);
+
+		it.effect('carries capacity', () =>
+			Effect.sync(() => {
+				const adapter = CacheAdapter.memory({ capacity: 100 });
+				expect(adapter.capacity).toBe(100);
+			}),
+		);
+	});
+
+	describe('redis', () => {
+		const makeInMemoryRedisClient = () => {
+			const store = new Map<string, { value: string; expiresAt: number }>();
+			return {
+				client: {
+					get: (key: string) =>
+						Effect.sync(() => {
+							const entry = store.get(key);
+							if (!entry) return Option.none<string>();
+							if (Date.now() > entry.expiresAt) {
+								store.delete(key);
+								return Option.none<string>();
+							}
+							return Option.some(entry.value);
+						}),
+					set: (key: string, value: string, ttlMs: number) =>
+						Effect.sync(() => {
+							store.set(key, { value, expiresAt: Date.now() + ttlMs });
+						}),
+					del: (key: string) =>
+						Effect.sync(() => {
+							store.delete(key);
+						}),
+				},
+				store,
+			};
+		};
+
+		it.effect('prefixes keys', () =>
+			Effect.gen(function* () {
+				const redis = makeInMemoryRedisClient();
+				const adapter = CacheAdapter.redis<number, string>({
+					client: redis.client,
+					keyPrefix: 'user',
+				});
+				yield* adapter.set(
+					123,
+					{ value: 'alice', storedAt: 1000 },
+					Duration.minutes(5),
+				);
+				expect(redis.store.has('user:123')).toBe(true);
+			}),
+		);
+
+		it.effect('roundtrips entries', () =>
+			Effect.gen(function* () {
+				const redis = makeInMemoryRedisClient();
+				const adapter = CacheAdapter.redis<number, string>({
+					client: redis.client,
+					keyPrefix: 'user',
+				});
+				yield* adapter.set(
+					1,
+					{ value: 'alice', storedAt: 1000 },
+					Duration.minutes(5),
+				);
+				const result = yield* adapter.get(1);
+				expect(Option.isSome(result)).toBe(true);
+				if (Option.isSome(result)) {
+					expect(result.value.value).toBe('alice');
+					expect(result.value.storedAt).toBe(1000);
+				}
+			}),
+		);
+
+		it.effect('removes entries', () =>
+			Effect.gen(function* () {
+				const redis = makeInMemoryRedisClient();
+				const adapter = CacheAdapter.redis<number, string>({
+					client: redis.client,
+					keyPrefix: 'user',
+				});
+				yield* adapter.set(
+					1,
+					{ value: 'alice', storedAt: 1000 },
+					Duration.minutes(5),
+				);
+				yield* adapter.remove(1);
+				const result = yield* adapter.get(1);
+				expect(Option.isNone(result)).toBe(true);
+			}),
+		);
+	});
+
+	describe('tiered', () => {
+		it.effect('falls through L1 to L2', () =>
+			Effect.gen(function* () {
+				const l1 = CacheAdapter.memory<string, string>();
+				const l2Store = new Map<string, { value: string; storedAt: number }>();
+				const l2: typeof l1 = {
+					get: (key) => {
+						const entry = l2Store.get(key);
+						return Effect.succeed(
+							entry !== undefined ? Option.some(entry) : Option.none(),
+						);
+					},
+					set: (key, entry) =>
+						Effect.sync(() => {
+							l2Store.set(key, entry);
+						}),
+					remove: (key) =>
+						Effect.sync(() => {
+							l2Store.delete(key);
+						}),
+					removeAll: Effect.sync(() => {
+						l2Store.clear();
+					}),
+				};
+
+				const tiered = CacheAdapter.tiered(l1, l2);
+
+				// Set in tiered (should write to both)
+				yield* tiered.set(
+					'k',
+					{ value: 'v', storedAt: 1000 },
+					Duration.minutes(5),
+				);
+				expect(l2Store.has('k')).toBe(true);
+
+				// Get from tiered (L1 memory is no-op, so falls through to L2)
+				const result = yield* tiered.get('k');
+				expect(Option.isSome(result)).toBe(true);
+				if (Option.isSome(result)) {
+					expect(result.value.value).toBe('v');
+				}
+
+				// Remove from tiered
+				yield* tiered.remove('k');
+				expect(l2Store.has('k')).toBe(false);
+			}),
+		);
+
+		it.effect('uses L1 capacity', () =>
+			Effect.sync(() => {
+				const l1 = CacheAdapter.memory<string, string>({ capacity: 50 });
+				const l2 = CacheAdapter.memory<string, string>({ capacity: 1000 });
+				const tiered = CacheAdapter.tiered(l1, l2);
+				expect(tiered.capacity).toBe(50);
+			}),
+		);
+	});
+});

package/src/cache/adapter.ts

@@ -0,0 +1,120 @@
+import { Duration, Effect, Option, Schema } from 'effect';
+
+export type CacheEntry<Value> = {
+	readonly value: Value;
+	readonly storedAt: number;
+};
+
+export type RedisClient = {
+	readonly get: (key: string) => Effect.Effect<Option.Option<string>>;
+	readonly set: (
+		key: string,
+		value: string,
+		ttlMs: number,
+	) => Effect.Effect<void>;
+	readonly del: (key: string) => Effect.Effect<void>;
+};
+
+export type CacheAdapter<Key, Value> = {
+	readonly get: (key: Key) => Effect.Effect<Option.Option<CacheEntry<Value>>>;
+	readonly set: (
+		key: Key,
+		entry: CacheEntry<Value>,
+		ttl: Duration.Duration,
+	) => Effect.Effect<void>;
+	readonly remove: (key: Key) => Effect.Effect<void>;
+	readonly removeAll: Effect.Effect<void>;
+	readonly capacity?: number;
+};
+
+export namespace CacheAdapter {
+	// No-op adapter — Effect Cache IS the in-memory store. This only carries `capacity`.
+	export function memory<Key, Value>(opts?: {
+		capacity?: number;
+	}): CacheAdapter<Key, Value> {
+		return {
+			get: () => Effect.succeed(Option.none()),
+			set: () => Effect.void,
+			remove: () => Effect.void,
+			removeAll: Effect.void,
+			capacity: opts?.capacity,
+		};
+	}
+
+	export function redis<Key, Value>(opts: {
+		client: RedisClient;
+		keyPrefix: string;
+		schema?: Schema.Schema<Value, string>;
+	}): CacheAdapter<Key, Value> {
+		const encodeKey = (key: Key) => `${opts.keyPrefix}:${JSON.stringify(key)}`;
+
+		const encodeEntry = (entry: CacheEntry<Value>): Effect.Effect<string> => {
+			if (opts.schema) {
+				return Schema.encode(opts.schema)(entry.value).pipe(
+					Effect.map((encoded) =>
+						JSON.stringify({ value: encoded, storedAt: entry.storedAt }),
+					),
+					Effect.orDie,
+				);
+			}
+			return Effect.succeed(JSON.stringify(entry));
+		};
+
+		const decodeEntry = (raw: string): Effect.Effect<CacheEntry<Value>> => {
+			const parsed = JSON.parse(raw);
+			if (opts.schema) {
+				return Schema.decode(opts.schema)(parsed.value).pipe(
+					Effect.map((value) => ({
+						value,
+						storedAt: parsed.storedAt as number,
+					})),
+					Effect.orDie,
+				);
+			}
+			return Effect.succeed(parsed as CacheEntry<Value>);
+		};
+
+		return {
+			get: (key) =>
+				Effect.gen(function* () {
+					const raw = yield* opts.client.get(encodeKey(key));
+					if (Option.isNone(raw)) return Option.none<CacheEntry<Value>>();
+					const entry = yield* decodeEntry(raw.value);
+					return Option.some(entry);
+				}),
+			set: (key, entry, ttl) =>
+				Effect.gen(function* () {
+					const encoded = yield* encodeEntry(entry);
+					yield* opts.client.set(
+						encodeKey(key),
+						encoded,
+						Duration.toMillis(ttl),
+					);
+				}),
+			remove: (key) => opts.client.del(encodeKey(key)),
+			removeAll: Effect.void,
+		};
+	}
+
+	export function tiered<Key, Value>(
+		l1: CacheAdapter<Key, Value>,
+		l2: CacheAdapter<Key, Value>,
+	): CacheAdapter<Key, Value> {
+		return {
+			get: (key) =>
+				Effect.gen(function* () {
+					const fromL1 = yield* l1.get(key);
+					if (Option.isSome(fromL1)) return fromL1;
+					return yield* l2.get(key);
+				}),
+			set: (key, entry, ttl) =>
+				Effect.all([l1.set(key, entry, ttl), l2.set(key, entry, ttl)], {
+					discard: true,
+				}),
+			remove: (key) =>
+				Effect.all([l1.remove(key), l2.remove(key)], { discard: true }),
+			removeAll: Effect.all([l1.removeAll, l2.removeAll], { discard: true }),
+			capacity: l1.capacity,
+		};
+	}
+}

package/src/cache/adapters/bun-redis.ts

@@ -0,0 +1,29 @@
+import { Effect, Option } from 'effect';
+import type { RedisClient } from '../adapter.js';
+
+type BunRedisClient = {
+	get(key: string): Promise<string | null>;
+	send(command: string, args: string[]): Promise<unknown>;
+	del(key: string): Promise<number>;
+};
+
+export function bunRedis(client: BunRedisClient): RedisClient {
+	return {
+		get: (key) =>
+			Effect.tryPromise(() => client.get(key)).pipe(
+				Effect.map((value) =>
+					value !== null ? Option.some(value) : Option.none(),
+				),
+				Effect.orDie,
+			),
+		set: (key, value, ttlMs) =>
+			Effect.tryPromise(() =>
+				client.send('SET', [key, value, 'PX', String(ttlMs)]),
+			).pipe(Effect.asVoid, Effect.orDie),
+		del: (key) =>
+			Effect.tryPromise(() => client.del(key)).pipe(
+				Effect.asVoid,
+				Effect.orDie,
+			),
+	};
+}

package/src/cache/adapters/ioredis.ts

@@ -0,0 +1,30 @@
+import { Effect, Option } from 'effect';
+import type { RedisClient } from '../adapter.js';
+
+type IORedisClient = {
+	get(key: string): Promise<string | null>;
+	set(key: string, value: string, px: 'PX', ttlMs: number): Promise<unknown>;
+	del(key: string): Promise<number>;
+};
+
+export function ioredis(client: IORedisClient): RedisClient {
+	return {
+		get: (key) =>
+			Effect.tryPromise(() => client.get(key)).pipe(
+				Effect.map((value) =>
+					value !== null ? Option.some(value) : Option.none(),
+				),
+				Effect.orDie,
+			),
+		set: (key, value, ttlMs) =>
+			Effect.tryPromise(() => client.set(key, value, 'PX', ttlMs)).pipe(
+				Effect.asVoid,
+				Effect.orDie,
+			),
+		del: (key) =>
+			Effect.tryPromise(() => client.del(key)).pipe(
+				Effect.asVoid,
+				Effect.orDie,
+			),
+	};
+}