effect-cf 0.17.0 → 0.18.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # effect-cf
 
+## 0.18.0
+
+### Minor Changes
+
+- [#58](https://github.com/danieljvdm/effect-cf/pull/58) [`c5bac36`](https://github.com/danieljvdm/effect-cf/commit/c5bac367587c314a17b32e984faee546a488f1ff) Thanks [@danieljvdm](https://github.com/danieljvdm)! - Add Effect-native support for Cloudflare's default and named Cache API instances, including typed operation errors and `Option`-based cache misses.
+
+## 0.17.1
+
+### Patch Changes
+
+- [#56](https://github.com/danieljvdm/effect-cf/pull/56) [`38df8ed`](https://github.com/danieljvdm/effect-cf/commit/38df8ed3153a77df117810e67a34cf039871c08c) Thanks [@danieljvdm](https://github.com/danieljvdm)! - Treat Cloudflare Workflow status responses with a null error as having no error.
+
 ## 0.17.0
 
 ### Minor Changes

package/README.md

@@ -1,6 +1,6 @@
 # effect-cf
 
-Effect-native Cloudflare primitives for Workers, Durable Objects, Containers, bindings, KV, D1, Queues, Email, Analytics Engine, Workflows, and Durable Object storage.
+Effect-native Cloudflare primitives for Workers, Durable Objects, Containers, bindings, Cache, KV, D1, Queues, Email, Analytics Engine, Workflows, and Durable Object storage.
 
 ## Install
 
@@ -31,6 +31,7 @@ Runtime creation belongs at Cloudflare entrypoints, not inside binding helpers.
 - `DurableObjectState` / `DurableObjectStorage` - Effect wrappers for state, alarms, SQL, and embedded KV
 - `DurableObjectWebSocket` - WebSocket upgrade helpers for Durable Objects
 - `ContainerNamespace` - named Cloudflare Container instances with Effect-wrapped request and lifecycle operations
+- `Cache` - Effect wrapper for Cloudflare's default and named Cache API instances
 - `Kv` - typed KV namespace helper
 - `D1` - typed D1 database binding helper with an `@effect/sql-d1` backed SQL layer
 - `R2` - typed R2 bucket binding helper with Effect-wrapped object and multipart operations
@@ -161,6 +162,38 @@ Producers should usually use `const queue = yield* AvatarQueue` and then call `q
 
 Queue handlers run inline failures through Cloudflare's normal retry path. If background work scheduled with `WorkerContext.waitUntil(...)` should also make the batch retry, use `WorkerContext.waitUntilPropagating(...)` or `waitUntil(..., { mode: "propagate" })`; the default `waitUntil` mode observes and logs failures without rejecting the native `waitUntil` promise.
 
+## Cache Example
+
+`Cache.layer` exposes Cloudflare's global Cache API as an Effect service. Cache misses are represented by `Option.none()`, and named caches are available through `open(...)`.
+
+```ts
+import { Effect, Option } from "effect";
+import { Cache, Worker } from "effect-cf";
+
+export default Worker.make(Cache.layer, {
+  fetch: Effect.gen(function* () {
+    const request = yield* Worker.NativeRequest;
+    const storage = yield* Cache.CacheStorage;
+    const cached = yield* storage.default.match(request);
+
+    if (Option.isSome(cached)) {
+      return cached.value;
+    }
+
+    const response = new Response("fresh", {
+      headers: { "Cache-Control": "public, max-age=300" },
+    });
+
+    const context = yield* Worker.WorkerContext;
+    yield* context.waitUntil(storage.default.put(request, response.clone()));
+
+    return response;
+  }),
+});
+```
+
+Use `const cache = yield* storage.open("api-cache")` for a named cache. `match`, `put`, `delete`, and `open` failures are reported as `CacheOperationError` values.
+
 ## R2 Example
 
 R2 bucket tags expose Cloudflare object operations as Effects and map nullable reads to `Option`.

package/dist/index.d.mts

@@ -16,7 +16,7 @@ import * as _$effect_Config0 from "effect/Config";
 
 //#region src/WorkersAi.d.ts
 declare namespace WorkersAi_d_exports {
-  export { LayerOptions$19 as LayerOptions, Tag$18 as Tag, TagClass$17 as TagClass, WorkersAiAsyncBatchResponse, WorkersAiBinding, WorkersAiClient, WorkersAiDefinition, WorkersAiEmbeddingInput, WorkersAiEmbeddingResponse, WorkersAiModelsSearchObject, WorkersAiModelsSearchParams, WorkersAiOperationError, WorkersAiOptions, WorkersAiService, embeddingResponse, isWorkersAiBinding, layer$16 as layer, make$17 as make, makeClient$13 as makeClient };
+  export { LayerOptions$19 as LayerOptions, Tag$18 as Tag, TagClass$17 as TagClass, WorkersAiAsyncBatchResponse, WorkersAiBinding, WorkersAiClient, WorkersAiDefinition, WorkersAiEmbeddingInput, WorkersAiEmbeddingResponse, WorkersAiModelsSearchObject, WorkersAiModelsSearchParams, WorkersAiOperationError, WorkersAiOptions, WorkersAiService, embeddingResponse, isWorkersAiBinding, layer$17 as layer, make$17 as make, makeClient$14 as makeClient };
 }
 declare const WorkersAiOperationError_base: new <A extends Record<string, any> = {}>(args: _$effect_Types0.VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => _$effect_Cause0.YieldableError & {
   readonly _tag: "WorkersAiOperationError";
@@ -87,12 +87,12 @@ declare const embeddingResponse: (value: {
   readonly data?: ReadonlyArray<ReadonlyArray<number>>;
   readonly shape?: ReadonlyArray<number>;
 }) => WorkersAiEmbeddingResponse;
-declare const makeClient$13: <ModelList extends AiModelListType = AiModels>(definition: WorkersAiDefinition) => (ai: WorkersAiBinding<ModelList>) => WorkersAiClient<ModelList>;
-declare const layer$16: <Self, ModelList extends AiModelListType = AiModels>(tag: Context.Service<Self, WorkersAiClient<ModelList>>, definition: WorkersAiDefinition) => Layer.Layer<Self, BindingNotFoundError | BindingValidationError, WorkerEnvironment>;
+declare const makeClient$14: <ModelList extends AiModelListType = AiModels>(definition: WorkersAiDefinition) => (ai: WorkersAiBinding<ModelList>) => WorkersAiClient<ModelList>;
+declare const layer$17: <Self, ModelList extends AiModelListType = AiModels>(tag: Context.Service<Self, WorkersAiClient<ModelList>>, definition: WorkersAiDefinition) => Layer.Layer<Self, BindingNotFoundError | BindingValidationError, WorkerEnvironment>;
 declare const make$17: <Id extends string>(id: Id) => TagClass$17<WorkersAiService<Id>, Id, AiModels>;
 declare const Tag$18: <Self>() => <Id extends string, ModelList extends AiModelListType = AiModels>(id: Id) => TagClass$17<Self, Id, ModelList>;
 declare namespace AiGateway_d_exports {
-  export { AiGatewayBinding, AiGatewayClient, AiGatewayDefinition, AiGatewayFetchOptions, AiGatewayHeaders, AiGatewayLog, AiGatewayOperationError, AiGatewayPatchLog, AiGatewayProvider, AiGatewayRunOptions, AiGatewayService, AiGatewayUniversalRequest, LayerOptions$18 as LayerOptions, Tag$17 as Tag, TagClass$16 as TagClass, isAiGatewayBinding, layer$15 as layer, make$16 as make, makeClient$12 as makeClient, makeClientFromAi, makeHttpClient };
+  export { AiGatewayBinding, AiGatewayClient, AiGatewayDefinition, AiGatewayFetchOptions, AiGatewayHeaders, AiGatewayLog, AiGatewayOperationError, AiGatewayPatchLog, AiGatewayProvider, AiGatewayRunOptions, AiGatewayService, AiGatewayUniversalRequest, LayerOptions$18 as LayerOptions, Tag$17 as Tag, TagClass$16 as TagClass, isAiGatewayBinding, layer$16 as layer, make$16 as make, makeClient$13 as makeClient, makeClientFromAi, makeHttpClient };
 }
 declare const AiGatewayOperationError_base: new <A extends Record<string, any> = {}>(args: _$effect_Types0.VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => _$effect_Cause0.YieldableError & {
   readonly _tag: "AiGatewayOperationError";
@@ -151,7 +151,7 @@ interface TagClass$16<Self, Id extends string> extends Context.ServiceClass<Self
   readonly layer: (options: LayerOptions$18) => Layer.Layer<Self, BindingNotFoundError | BindingValidationError | AiGatewayOperationError, WorkerEnvironment>;
 }
 declare const isAiGatewayBinding: (value: unknown) => value is WorkersAiBinding;
-declare const makeClient$12: (definition: AiGatewayDefinition, gateway: AiGatewayBinding) => {
+declare const makeClient$13: (definition: AiGatewayDefinition, gateway: AiGatewayBinding) => {
   definition: AiGatewayDefinition;
   run: (data: _$_cloudflare_workers_types0.AIGatewayUniversalRequest | readonly _$_cloudflare_workers_types0.AIGatewayUniversalRequest[], options: {
     gateway?: _$_cloudflare_workers_types0.UniversalGatewayOptions;
@@ -169,11 +169,11 @@ declare const makeHttpClient: (definition: Omit<AiGatewayDefinition, "binding">
   readonly accountId: string;
   readonly binding?: string;
 }, request?: typeof fetch) => AiGatewayClient;
-declare const layer$15: <Self>(tag: Context.Service<Self, AiGatewayClient>, definition: AiGatewayDefinition) => Layer.Layer<Self, BindingNotFoundError | BindingValidationError, WorkerEnvironment>;
+declare const layer$16: <Self>(tag: Context.Service<Self, AiGatewayClient>, definition: AiGatewayDefinition) => Layer.Layer<Self, BindingNotFoundError | BindingValidationError, WorkerEnvironment>;
 declare const make$16: <Id extends string>(id: Id) => TagClass$16<AiGatewayService<Id>, Id>;
 declare const Tag$17: <Self>() => <Id extends string>(id: Id) => TagClass$16<Self, Id>;
 declare namespace AnalyticsEngine_d_exports {
-  export { AnalyticsEngineBinding, AnalyticsEngineClient, AnalyticsEngineDataPoint, AnalyticsEngineDataPointSchema, AnalyticsEngineDefinition, AnalyticsEngineFieldValue, AnalyticsEngineFieldValueSchema, AnalyticsEngineInvalidWritePolicy, AnalyticsEngineOperationError, AnalyticsEngineQueryClient, AnalyticsEngineQueryColumn, AnalyticsEngineQueryDefinition, AnalyticsEngineQueryError, AnalyticsEngineQueryOptions, AnalyticsEngineQueryResult, AnalyticsEngineQueryRow, AnalyticsEngineQueryService, AnalyticsEngineService, AnalyticsEngineWriteBatchOptions, AnalyticsEngineWriteError, AnalyticsEngineWriteOptions, AnalyticsEngineWritePolicy, AnalyticsEngineWriteValidationError, AnalyticsEngineWriteViolation, LayerOptions$17 as LayerOptions, QueryConfigOptions, QueryTag, QueryTagClass, Tag$16 as Tag, TagClass$15 as TagClass, isAnalyticsEngineDataset, layer$14 as layer, make$15 as make, makeClient$11 as makeClient, makeQuery, makeQueryClient, queryConfig, queryFetchLayer, queryFetchLayerConfig, queryLayer, queryLayerConfig, writeLimits };
+  export { AnalyticsEngineBinding, AnalyticsEngineClient, AnalyticsEngineDataPoint, AnalyticsEngineDataPointSchema, AnalyticsEngineDefinition, AnalyticsEngineFieldValue, AnalyticsEngineFieldValueSchema, AnalyticsEngineInvalidWritePolicy, AnalyticsEngineOperationError, AnalyticsEngineQueryClient, AnalyticsEngineQueryColumn, AnalyticsEngineQueryDefinition, AnalyticsEngineQueryError, AnalyticsEngineQueryOptions, AnalyticsEngineQueryResult, AnalyticsEngineQueryRow, AnalyticsEngineQueryService, AnalyticsEngineService, AnalyticsEngineWriteBatchOptions, AnalyticsEngineWriteError, AnalyticsEngineWriteOptions, AnalyticsEngineWritePolicy, AnalyticsEngineWriteValidationError, AnalyticsEngineWriteViolation, LayerOptions$17 as LayerOptions, QueryConfigOptions, QueryTag, QueryTagClass, Tag$16 as Tag, TagClass$15 as TagClass, isAnalyticsEngineDataset, layer$15 as layer, make$15 as make, makeClient$12 as makeClient, makeQuery, makeQueryClient, queryConfig, queryFetchLayer, queryFetchLayerConfig, queryLayer, queryLayerConfig, writeLimits };
 }
 declare const writeLimits: {
   readonly maxBlobs: 20;
@@ -328,7 +328,7 @@ interface QueryTagClass<Self, Id extends string> extends Context.ServiceClass<Se
 }
 declare const makeQueryClient: (definition: AnalyticsEngineQueryDefinition) => Effect.Effect<AnalyticsEngineQueryClient, never, HttpClient.HttpClient>;
 declare const isAnalyticsEngineDataset: (value: unknown) => value is AnalyticsEngineBinding;
-declare const makeClient$11: (definition: AnalyticsEngineDefinition, defaults?: AnalyticsEngineWritePolicy) => (dataset: AnalyticsEngineBinding) => AnalyticsEngineClient;
+declare const makeClient$12: (definition: AnalyticsEngineDefinition, defaults?: AnalyticsEngineWritePolicy) => (dataset: AnalyticsEngineBinding) => AnalyticsEngineClient;
 declare const queryConfig: (options?: QueryConfigOptions) => Config.Config<{
   accountId: string;
   apiToken: Redacted.Redacted<string>;
@@ -338,13 +338,13 @@ declare const queryLayer: <Self>(tag: Context.Service<Self, AnalyticsEngineQuery
 declare const queryFetchLayer: <Self>(tag: Context.Service<Self, AnalyticsEngineQueryClient>, definition: AnalyticsEngineQueryDefinition) => Layer.Layer<Self, never, never>;
 declare const queryLayerConfig: <Self>(tag: Context.Service<Self, AnalyticsEngineQueryClient>, config?: Config.Config<AnalyticsEngineQueryDefinition>) => Layer.Layer<Self, Config.ConfigError, HttpClient.HttpClient>;
 declare const queryFetchLayerConfig: <Self>(tag: Context.Service<Self, AnalyticsEngineQueryClient>, config?: Config.Config<AnalyticsEngineQueryDefinition>) => Layer.Layer<Self, Config.ConfigError, never>;
-declare const layer$14: <Self>(tag: Context.Service<Self, AnalyticsEngineClient>, definition: LayerOptions$17) => Layer.Layer<Self, BindingNotFoundError | BindingValidationError, WorkerEnvironment>;
+declare const layer$15: <Self>(tag: Context.Service<Self, AnalyticsEngineClient>, definition: LayerOptions$17) => Layer.Layer<Self, BindingNotFoundError | BindingValidationError, WorkerEnvironment>;
 declare const make$15: <Id extends string>(id: Id) => TagClass$15<AnalyticsEngineService<Id>, Id>;
 declare const makeQuery: <Id extends string>(id: Id) => QueryTagClass<AnalyticsEngineQueryService<Id>, Id>;
 declare const Tag$16: <Self>() => <Id extends string>(id: Id) => TagClass$15<Self, Id>;
 declare const QueryTag: <Self>() => <Id extends string>(id: Id) => QueryTagClass<Self, Id>;
 declare namespace BrowserRendering_d_exports {
-  export { BrowserRenderingBinding, BrowserRenderingBrowserClient, BrowserRenderingBrowserLike, BrowserRenderingClient, BrowserRenderingConnect, BrowserRenderingDefinition, BrowserRenderingLaunch, BrowserRenderingOperationError, BrowserRenderingPageClient, BrowserRenderingPageLike, BrowserRenderingService, LayerOptions$16 as LayerOptions, Tag$15 as Tag, TagClass$14 as TagClass, isBrowserRenderingBinding, layer$13 as layer, make$14 as make, makeClient$10 as makeClient };
+  export { BrowserRenderingBinding, BrowserRenderingBrowserClient, BrowserRenderingBrowserLike, BrowserRenderingClient, BrowserRenderingConnect, BrowserRenderingDefinition, BrowserRenderingLaunch, BrowserRenderingOperationError, BrowserRenderingPageClient, BrowserRenderingPageLike, BrowserRenderingService, LayerOptions$16 as LayerOptions, Tag$15 as Tag, TagClass$14 as TagClass, isBrowserRenderingBinding, layer$14 as layer, make$14 as make, makeClient$11 as makeClient };
 }
 declare const BrowserRenderingOperationError_base: new <A extends Record<string, any> = {}>(args: _$effect_Types0.VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => _$effect_Cause0.YieldableError & {
   readonly _tag: "BrowserRenderingOperationError";
@@ -416,10 +416,61 @@ interface TagClass$14<Self, Id extends string> extends Context.ServiceClass<Self
   readonly layer: (options: LayerOptions$16) => Layer.Layer<Self, BindingNotFoundError | BindingValidationError, WorkerEnvironment>;
 }
 declare const isBrowserRenderingBinding: (value: unknown) => value is BrowserRenderingBinding;
-declare const makeClient$10: <RawBinding extends BrowserRenderingBinding = BrowserRenderingBinding>(definition: BrowserRenderingDefinition) => (binding: RawBinding) => BrowserRenderingClient<RawBinding>;
-declare const layer$13: <Self>(tag: Context.Service<Self, BrowserRenderingClient>, definition: BrowserRenderingDefinition) => Layer.Layer<Self, BindingNotFoundError | BindingValidationError, WorkerEnvironment>;
+declare const makeClient$11: <RawBinding extends BrowserRenderingBinding = BrowserRenderingBinding>(definition: BrowserRenderingDefinition) => (binding: RawBinding) => BrowserRenderingClient<RawBinding>;
+declare const layer$14: <Self>(tag: Context.Service<Self, BrowserRenderingClient>, definition: BrowserRenderingDefinition) => Layer.Layer<Self, BindingNotFoundError | BindingValidationError, WorkerEnvironment>;
 declare const make$14: <Id extends string>(id: Id) => TagClass$14<BrowserRenderingService<Id>, Id>;
 declare const Tag$15: <Self>() => <Id extends string>(id: Id) => TagClass$14<Self, Id>;
+declare namespace Cache_d_exports {
+  export { CacheClient, CacheOperation, CacheOperationError, CacheQueryOptions, CacheRequest, CacheStorage, CacheStorageClient, layer$13 as layer, layerFrom, makeCacheClient, makeClient$10 as makeClient };
+}
+/** Request key accepted by Cloudflare's Cache API. */
+type CacheRequest = CloudflareRequestInfo | URL;
+/** Query options supported by Cloudflare's Cache API. */
+type CacheQueryOptions = CloudflareCacheQueryOptions;
+/** Cache operation represented by {@link CacheOperationError}. */
+type CacheOperation = "open" | "match" | "put" | "delete";
+declare const CacheOperationError_base: new <A extends Record<string, any> = {}>(args: _$effect_Types0.VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => _$effect_Cause0.YieldableError & {
+  readonly _tag: "CacheOperationError";
+} & Readonly<A>;
+/** Error raised when a Cloudflare Cache API operation fails. */
+declare class CacheOperationError extends CacheOperationError_base<{
+  readonly cache: string;
+  readonly operation: CacheOperation;
+  readonly cause: unknown;
+}> {}
+/** Effect wrapper around one Cloudflare `Cache` instance. */
+interface CacheClient {
+  /** Cache name (`default` for `caches.default`). */
+  readonly name: string;
+  /** Finds a cached response, mapping cache misses to `Option.none()`. */
+  readonly match: (request: CacheRequest, options?: CacheQueryOptions) => Effect.Effect<Option.Option<Response>, CacheOperationError>;
+  /** Stores a response under the request key. */
+  readonly put: (request: CacheRequest, response: Response) => Effect.Effect<void, CacheOperationError>;
+  /** Deletes a cached response and reports whether it existed. */
+  readonly delete: (request: CacheRequest, options?: CacheQueryOptions) => Effect.Effect<boolean, CacheOperationError>;
+  /** Access to the native Cloudflare `Cache` instance. */
+  readonly unsafeRaw: Effect.Effect<CloudflareCache>;
+}
+/** Effect wrapper around Cloudflare's global `caches` object. */
+interface CacheStorageClient {
+  /** Cloudflare's shared default cache. */
+  readonly default: CacheClient;
+  /** Opens a named cache. */
+  readonly open: (name: string) => Effect.Effect<CacheClient, CacheOperationError>;
+  /** Access to the native Cloudflare `CacheStorage` instance. */
+  readonly unsafeRaw: Effect.Effect<CloudflareCacheStorage>;
+}
+declare const CacheStorage_base: Context.ServiceClass<CacheStorage, "effect-cf/CacheStorage", CacheStorageClient>;
+/** Service for Cloudflare's global Cache API. */
+declare class CacheStorage extends CacheStorage_base {}
+/** Wraps a native Cloudflare `Cache` instance. */
+declare const makeCacheClient: (cache: CloudflareCache, name?: string) => CacheClient;
+/** Wraps a native Cloudflare `CacheStorage` instance. */
+declare const makeClient$10: (storage: CloudflareCacheStorage) => CacheStorageClient;
+/** Provides Cache API services from an explicit native `CacheStorage` instance. */
+declare const layerFrom: (storage: CloudflareCacheStorage) => Layer.Layer<CacheStorage>;
+/** Provides Cache API services from Cloudflare's global `caches` object. */
+declare const layer$13: Layer.Layer<CacheStorage>;
 declare namespace DurableObjectStorage_d_exports {
   export { DurableObjectStorage, DurableObjectTransaction, SchemaBackedSyncKvStorage, SqlCursor, SqlStorage, SqlStorageValue, StorageOperationError, SyncKvDefinition, SyncKvStorage, fromDurableObjectStorage };
 }
@@ -2933,4 +2984,4 @@ declare const layer: <Self>(tag: Context.Service<Self, VectorizeClient>, definit
 declare const make: <Id extends string>(id: Id) => TagClass<VectorizeService<Id>, Id>;
 declare const Tag$1: <Self>() => <Id extends string>(id: Id) => TagClass<Self, Id>;
 //#endregion
-export { AiGateway_d_exports as AiGateway, AnalyticsEngine_d_exports as AnalyticsEngine, Binding_d_exports as Binding, BrowserRendering_d_exports as BrowserRendering, CloudflareOtlp_d_exports as CloudflareOtlp, ContainerNamespace_d_exports as ContainerNamespace, D1_d_exports as D1, DurableObject_d_exports as DurableObject, DurableObjectAlarm_d_exports as DurableObjectAlarm, DurableObjectDefinition_d_exports as DurableObjectDefinition, DurableObjectNamespace_d_exports as DurableObjectNamespace, DurableObjectRpcWebSocket_d_exports as DurableObjectRpcWebSocket, DurableObjectSqlite_d_exports as DurableObjectSqlite, DurableObjectState_d_exports as DurableObjectState, DurableObjectStorage_d_exports as DurableObjectStorage, DurableObjectWebSocket_d_exports as DurableObjectWebSocket, Email_d_exports as Email, Hyperdrive_d_exports as Hyperdrive, Images_d_exports as Images, Kv_d_exports as Kv, Queue_d_exports as Queue, QueueBinding_d_exports as QueueBinding, QueueDefinition_d_exports as QueueDefinition, R2_d_exports as R2, Rpc_d_exports as Rpc, RpcDefinition_d_exports as RpcDefinition, ServiceBinding_d_exports as ServiceBinding, Vectorize_d_exports as Vectorize, Worker_d_exports as Worker, WorkerConfig, WorkerDefinition_d_exports as WorkerDefinition, type WorkerEnv, WorkerEnvironment, WorkersAi_d_exports as WorkersAi, Workflow_d_exports as Workflow, WorkflowBinding_d_exports as WorkflowBinding, WorkflowDefinition_d_exports as WorkflowDefinition };
+export { AiGateway_d_exports as AiGateway, AnalyticsEngine_d_exports as AnalyticsEngine, Binding_d_exports as Binding, BrowserRendering_d_exports as BrowserRendering, Cache_d_exports as Cache, CloudflareOtlp_d_exports as CloudflareOtlp, ContainerNamespace_d_exports as ContainerNamespace, D1_d_exports as D1, DurableObject_d_exports as DurableObject, DurableObjectAlarm_d_exports as DurableObjectAlarm, DurableObjectDefinition_d_exports as DurableObjectDefinition, DurableObjectNamespace_d_exports as DurableObjectNamespace, DurableObjectRpcWebSocket_d_exports as DurableObjectRpcWebSocket, DurableObjectSqlite_d_exports as DurableObjectSqlite, DurableObjectState_d_exports as DurableObjectState, DurableObjectStorage_d_exports as DurableObjectStorage, DurableObjectWebSocket_d_exports as DurableObjectWebSocket, Email_d_exports as Email, Hyperdrive_d_exports as Hyperdrive, Images_d_exports as Images, Kv_d_exports as Kv, Queue_d_exports as Queue, QueueBinding_d_exports as QueueBinding, QueueDefinition_d_exports as QueueDefinition, R2_d_exports as R2, Rpc_d_exports as Rpc, RpcDefinition_d_exports as RpcDefinition, ServiceBinding_d_exports as ServiceBinding, Vectorize_d_exports as Vectorize, Worker_d_exports as Worker, WorkerConfig, WorkerDefinition_d_exports as WorkerDefinition, type WorkerEnv, WorkerEnvironment, WorkersAi_d_exports as WorkersAi, Workflow_d_exports as Workflow, WorkflowBinding_d_exports as WorkflowBinding, WorkflowDefinition_d_exports as WorkflowDefinition };

package/dist/index.mjs

@@ -1,5 +1,5 @@
 import { t as __exportAll } from "./chunk-CfYAbeIz.mjs";
-import { a as WorkerConfig, i as layer$18, n as Binding_exports, o as WorkerEnvironment, r as Service$2, t as Hyperdrive_exports } from "./Hyperdrive-89hg_Fck.mjs";
+import { a as WorkerConfig, i as layer$19, n as Binding_exports, o as WorkerEnvironment, r as Service$2, t as Hyperdrive_exports } from "./Hyperdrive-89hg_Fck.mjs";
 import { Cause, Clock, Config, ConfigProvider, Context, Data, DateTime, Duration, Effect, Exit, Layer, ManagedRuntime, Option, Queue, Result, Schema } from "effect";
 import { FetchHttpClient, HttpClient, HttpClientRequest, HttpServerRequest, HttpServerResponse } from "effect/unstable/http";
 import { OtlpLogger, OtlpMetrics, OtlpSerialization, OtlpTracer } from "effect/unstable/observability";
@@ -15,9 +15,9 @@ var WorkersAi_exports = /* @__PURE__ */ __exportAll({
 	WorkersAiOperationError: () => WorkersAiOperationError,
 	embeddingResponse: () => embeddingResponse,
 	isWorkersAiBinding: () => isWorkersAiBinding,
-	layer: () => layer$17,
+	layer: () => layer$18,
 	make: () => make$17,
-	makeClient: () => makeClient$13
+	makeClient: () => makeClient$14
 });
 const expectedWorkersAiBinding = "Workers AI binding with run(), gateway(), and models()";
 /** Error raised when a Workers AI operation fails. */
@@ -41,7 +41,7 @@ const embeddingResponse = (value) => ({
 	data: value.data ?? [],
 	shape: value.shape ?? []
 });
-const makeClient$13 = (definition) => (ai) => {
+const makeClient$14 = (definition) => (ai) => {
 	const run = ((model, input, options) => tryWorkersAiPromise(definition.binding, "run", () => ai.run(model, input, options)));
 	return {
 		definition,
@@ -53,11 +53,11 @@ const makeClient$13 = (definition) => (ai) => {
 		unsafeRaw: Effect.succeed(ai)
 	};
 };
-const layer$17 = (tag, definition) => layer$18(tag, definition.binding, (value) => isWorkersAiBinding(value), makeClient$13(definition), { expected: expectedWorkersAiBinding });
+const layer$18 = (tag, definition) => layer$19(tag, definition.binding, (value) => isWorkersAiBinding(value), makeClient$14(definition), { expected: expectedWorkersAiBinding });
 const make$17 = (id) => Tag$17()(id);
 const Tag$17 = () => (id) => {
 	const tag = Context.Service()(id);
-	const makeLayer = (definition) => layer$17(tag, definition);
+	const makeLayer = (definition) => layer$18(tag, definition);
 	return Object.assign(tag, {
 		id,
 		layer: makeLayer
@@ -69,9 +69,9 @@ var AiGateway_exports = /* @__PURE__ */ __exportAll({
 	AiGatewayOperationError: () => AiGatewayOperationError,
 	Tag: () => Tag$16,
 	isAiGatewayBinding: () => isAiGatewayBinding,
-	layer: () => layer$16,
+	layer: () => layer$17,
 	make: () => make$16,
-	makeClient: () => makeClient$12,
+	makeClient: () => makeClient$13,
 	makeClientFromAi: () => makeClientFromAi,
 	makeHttpClient: () => makeHttpClient
 });
@@ -98,7 +98,7 @@ const providerUrl = (baseUrl, path = "") => {
 };
 const gatewayUrl = (definition) => `https://gateway.ai.cloudflare.com/v1/${definition.accountId}/${definition.gatewayId}/`;
 const isAiGatewayBinding = (value) => isWorkersAiBinding(value);
-const makeClient$12 = (definition, gateway) => ({
+const makeClient$13 = (definition, gateway) => ({
 	definition,
 	run: (data, options) => tryAiGatewayPromise(definition.binding, "run", () => gateway.run(Array.isArray(data) ? [...data] : data, options)),
 	getUrl: (provider) => tryAiGatewayPromise(definition.binding, "getUrl", () => gateway.getUrl(provider)),
@@ -115,11 +115,11 @@ const makeClientFromAi = (definition, ai) => {
 	const withGateway = (operation) => gateway.pipe(Effect.flatMap(operation));
 	return {
 		definition,
-		run: (data, options) => withGateway((raw) => makeClient$12(definition, raw).run(data, options)),
-		getUrl: (provider) => withGateway((raw) => makeClient$12(definition, raw).getUrl(provider)),
-		fetch: (options) => withGateway((raw) => makeClient$12(definition, raw).fetch(options)),
-		patchLog: (logId, data) => withGateway((raw) => makeClient$12(definition, raw).patchLog(logId, data)),
-		getLog: (logId) => withGateway((raw) => makeClient$12(definition, raw).getLog(logId)),
+		run: (data, options) => withGateway((raw) => makeClient$13(definition, raw).run(data, options)),
+		getUrl: (provider) => withGateway((raw) => makeClient$13(definition, raw).getUrl(provider)),
+		fetch: (options) => withGateway((raw) => makeClient$13(definition, raw).fetch(options)),
+		patchLog: (logId, data) => withGateway((raw) => makeClient$13(definition, raw).patchLog(logId, data)),
+		getLog: (logId) => withGateway((raw) => makeClient$13(definition, raw).getLog(logId)),
 		unsafeRaw: gateway
 	};
 };
@@ -159,11 +159,11 @@ const makeHttpClient = (definition, request = fetch) => {
 		unsafeRaw: Effect.fail(aiGatewayError(binding, "unsafeRaw", /* @__PURE__ */ new TypeError("HTTP AI Gateway clients have no raw binding")))
 	};
 };
-const layer$16 = (tag, definition) => layer$18(tag, definition.binding, isAiGatewayBinding, (ai) => makeClientFromAi(definition, ai), { expected: expectedAiGatewayBinding });
+const layer$17 = (tag, definition) => layer$19(tag, definition.binding, isAiGatewayBinding, (ai) => makeClientFromAi(definition, ai), { expected: expectedAiGatewayBinding });
 const make$16 = (id) => Tag$16()(id);
 const Tag$16 = () => (id) => {
 	const tag = Context.Service()(id);
-	const makeLayer = (definition) => layer$16(tag, definition);
+	const makeLayer = (definition) => layer$17(tag, definition);
 	return Object.assign(tag, {
 		id,
 		layer: makeLayer
@@ -180,9 +180,9 @@ var AnalyticsEngine_exports = /* @__PURE__ */ __exportAll({
 	QueryTag: () => QueryTag,
 	Tag: () => Tag$15,
 	isAnalyticsEngineDataset: () => isAnalyticsEngineDataset,
-	layer: () => layer$15,
+	layer: () => layer$16,
 	make: () => make$15,
-	makeClient: () => makeClient$11,
+	makeClient: () => makeClient$12,
 	makeQuery: () => makeQuery,
 	makeQueryClient: () => makeQueryClient,
 	queryConfig: () => queryConfig,
@@ -375,7 +375,7 @@ const isAnalyticsEngineDataset = (value) => {
 	if (typeof value !== "object" || value === null) return false;
 	return typeof Reflect.get(value, "writeDataPoint") === "function";
 };
-const makeClient$11 = (definition, defaults) => (dataset) => {
+const makeClient$12 = (definition, defaults) => (dataset) => {
 	const writeDataPoint = (dataPoint, options) => {
 		const policy = resolveWritePolicy(defaults, options);
 		return validateOptionalDataPoint(definition.binding, "writeDataPoint", dataPoint).pipe(Effect.matchEffect({
@@ -410,12 +410,12 @@ const queryLayerConfig = (tag, config = queryConfig()) => Layer.effect(tag, Effe
 	return yield* makeQueryClient(yield* config);
 }));
 const queryFetchLayerConfig = (tag, config = queryConfig()) => queryLayerConfig(tag, config).pipe(Layer.provide(FetchHttpClient.layer));
-const layer$15 = (tag, definition) => layer$18(tag, definition.binding, isAnalyticsEngineDataset, makeClient$11(definition, definition.write), { expected: expectedAnalyticsEngineDataset });
+const layer$16 = (tag, definition) => layer$19(tag, definition.binding, isAnalyticsEngineDataset, makeClient$12(definition, definition.write), { expected: expectedAnalyticsEngineDataset });
 const make$15 = (id) => Tag$15()(id);
 const makeQuery = (id) => QueryTag()(id);
 const Tag$15 = () => (id) => {
 	const tag = Context.Service()(id);
-	const makeLayer = (definition) => layer$15(tag, definition);
+	const makeLayer = (definition) => layer$16(tag, definition);
 	return Object.assign(tag, {
 		id,
 		layer: makeLayer
@@ -441,9 +441,9 @@ var BrowserRendering_exports = /* @__PURE__ */ __exportAll({
 	BrowserRenderingOperationError: () => BrowserRenderingOperationError,
 	Tag: () => Tag$14,
 	isBrowserRenderingBinding: () => isBrowserRenderingBinding,
-	layer: () => layer$14,
+	layer: () => layer$15,
 	make: () => make$14,
-	makeClient: () => makeClient$10
+	makeClient: () => makeClient$11
 });
 const expectedBrowserRenderingBinding = "Browser Rendering binding resource";
 /** Error raised when a Browser Rendering operation fails. */
@@ -480,23 +480,64 @@ const wrapBrowser = (binding, browser) => ({
 	disconnect: browser.disconnect === void 0 ? Effect.void : tryBrowserRenderingSync(binding, "disconnect", () => browser.disconnect())
 });
 const isBrowserRenderingBinding = (value) => (typeof value === "object" || typeof value === "function") && value !== null;
-const makeClient$10 = (definition) => (binding) => ({
+const makeClient$11 = (definition) => (binding) => ({
 	definition,
 	launchWith: (launch, options) => tryBrowserRenderingPromise(definition.binding, "launch", () => launch(binding, options)).pipe(Effect.map((browser) => wrapBrowser(definition.binding, browser))),
 	connectWith: (connect, options) => tryBrowserRenderingPromise(definition.binding, "connect", () => connect(binding, options)).pipe(Effect.map((browser) => wrapBrowser(definition.binding, browser))),
 	unsafeRaw: Effect.succeed(binding)
 });
-const layer$14 = (tag, definition) => layer$18(tag, definition.binding, isBrowserRenderingBinding, makeClient$10(definition), { expected: expectedBrowserRenderingBinding });
+const layer$15 = (tag, definition) => layer$19(tag, definition.binding, isBrowserRenderingBinding, makeClient$11(definition), { expected: expectedBrowserRenderingBinding });
 const make$14 = (id) => Tag$14()(id);
 const Tag$14 = () => (id) => {
 	const tag = Context.Service()(id);
-	const makeLayer = (definition) => layer$14(tag, definition);
+	const makeLayer = (definition) => layer$15(tag, definition);
 	return Object.assign(tag, {
 		id,
 		layer: makeLayer
 	});
 };
 //#endregion
+//#region src/Cache.ts
+var Cache_exports = /* @__PURE__ */ __exportAll({
+	CacheOperationError: () => CacheOperationError,
+	CacheStorage: () => CacheStorage,
+	layer: () => layer$14,
+	layerFrom: () => layerFrom,
+	makeCacheClient: () => makeCacheClient,
+	makeClient: () => makeClient$10
+});
+/** Error raised when a Cloudflare Cache API operation fails. */
+var CacheOperationError = class extends Data.TaggedError("CacheOperationError") {};
+/** Service for Cloudflare's global Cache API. */
+var CacheStorage = class extends Context.Service()("effect-cf/CacheStorage") {};
+const cacheError = (cache, operation, cause) => new CacheOperationError({
+	cache,
+	operation,
+	cause
+});
+const tryCachePromise = (cache, operation, evaluate) => Effect.tryPromise({
+	try: evaluate,
+	catch: (cause) => cacheError(cache, operation, cause)
+});
+/** Wraps a native Cloudflare `Cache` instance. */
+const makeCacheClient = (cache, name = "default") => ({
+	name,
+	match: (request, options) => tryCachePromise(name, "match", () => cache.match(request, options)).pipe(Effect.map(Option.fromUndefinedOr)),
+	put: (request, response) => tryCachePromise(name, "put", () => cache.put(request, response)),
+	delete: (request, options) => tryCachePromise(name, "delete", () => cache.delete(request, options)),
+	unsafeRaw: Effect.succeed(cache)
+});
+/** Wraps a native Cloudflare `CacheStorage` instance. */
+const makeClient$10 = (storage) => ({
+	default: makeCacheClient(storage.default),
+	open: (name) => tryCachePromise(name, "open", () => storage.open(name)).pipe(Effect.map((cache) => makeCacheClient(cache, name))),
+	unsafeRaw: Effect.succeed(storage)
+});
+/** Provides Cache API services from an explicit native `CacheStorage` instance. */
+const layerFrom = (storage) => Layer.succeed(CacheStorage, makeClient$10(storage));
+/** Provides Cache API services from Cloudflare's global `caches` object. */
+const layer$14 = Layer.sync(CacheStorage, () => makeClient$10(caches));
+//#endregion
 //#region src/DurableObjectStorage.ts
 var DurableObjectStorage_exports = /* @__PURE__ */ __exportAll({
 	StorageOperationError: () => StorageOperationError,
@@ -966,7 +1007,7 @@ const makeClient$9 = (definition) => (namespace) => {
 		unsafeRaw: Effect.succeed(namespace)
 	};
 };
-const layer$12 = (tag, definition) => layer$18(tag, definition.binding, isContainerNamespaceResource, makeClient$9(definition), { expected: expectedContainerNamespace });
+const layer$12 = (tag, definition) => layer$19(tag, definition.binding, isContainerNamespaceResource, makeClient$9(definition), { expected: expectedContainerNamespace });
 const make$13 = (id) => Tag$13()(id);
 /** Creates a typed Effect service for a Cloudflare Container namespace. */
 const Tag$13 = () => (id) => {
@@ -1104,7 +1145,7 @@ const makeClient$8 = (definition) => {
 		unsafeRaw: Effect.succeed(queue)
 	});
 };
-const layer$11 = (tag, definition) => layer$18(tag, definition.binding, (value) => isQueue(value), makeClient$8(definition), { expected: expectedQueueProducer });
+const layer$11 = (tag, definition) => layer$19(tag, definition.binding, (value) => isQueue(value), makeClient$8(definition), { expected: expectedQueueProducer });
 //#endregion
 //#region src/QueueDefinition.ts
 var QueueDefinition_exports = /* @__PURE__ */ __exportAll({
@@ -1447,7 +1488,7 @@ const makeClient$7 = (definition) => {
 		});
 	};
 };
-const layer$10 = (tag, definition) => layer$18(tag, definition.binding, (value) => isServiceBindingClient(value), makeClient$7(definition), { expected: expectedServiceBinding });
+const layer$10 = (tag, definition) => layer$19(tag, definition.binding, (value) => isServiceBindingClient(value), makeClient$7(definition), { expected: expectedServiceBinding });
 /**
 * Creates a typed Effect service for a Worker service binding.
 *
@@ -1824,7 +1865,7 @@ const makeClient$6 = (definition) => {
 		});
 	};
 };
-const layer$8 = (tag, definition) => layer$18(tag, definition.binding, (value) => isDurableObjectNamespaceClient(value), makeClient$6(definition), { expected: expectedDurableObjectNamespace });
+const layer$8 = (tag, definition) => layer$19(tag, definition.binding, (value) => isDurableObjectNamespaceClient(value), makeClient$6(definition), { expected: expectedDurableObjectNamespace });
 const makeDirectMethods = (rpcDefinition, helpers) => {
 	const methods = {};
 	if (rpcDefinition !== void 0) {
@@ -2539,7 +2580,7 @@ const makeClient$5 = (definition) => (email) => {
 		unsafeRaw: Effect.succeed(email)
 	};
 };
-const layer$5 = (tag, definition) => layer$18(tag, definition.binding, isEmailBinding, makeClient$5(definition), { expected: expectedSendEmailBinding });
+const layer$5 = (tag, definition) => layer$19(tag, definition.binding, isEmailBinding, makeClient$5(definition), { expected: expectedSendEmailBinding });
 const make$5 = (id) => Tag$6()(id);
 const Tag$6 = () => (id) => {
 	const tag = Context.Service()(id);
@@ -2646,7 +2687,7 @@ const makeClient$4 = (definition) => (images) => {
 		unsafeRaw: Effect.succeed(images)
 	};
 };
-const layer$4 = (tag, definition) => layer$18(tag, definition.binding, isImagesBinding, makeClient$4(definition), { expected: expectedImagesBinding });
+const layer$4 = (tag, definition) => layer$19(tag, definition.binding, isImagesBinding, makeClient$4(definition), { expected: expectedImagesBinding });
 const make$4 = (id) => Tag$5()(id);
 const Tag$5 = () => (id) => {
 	const tag = Context.Service()(id);
@@ -2741,7 +2782,7 @@ const makeClient$3 = (definition) => {
 		unsafeRaw: Effect.succeed(kv)
 	});
 };
-const layer$3 = (tag, definition) => layer$18(tag, definition.binding, isKvNamespace, makeClient$3(definition), { expected: expectedKvNamespace });
+const layer$3 = (tag, definition) => layer$19(tag, definition.binding, isKvNamespace, makeClient$3(definition), { expected: expectedKvNamespace });
 const makeDefinition$1 = (id, definition) => {
 	const kvDefinition = {
 		id,
@@ -2858,7 +2899,7 @@ const makeClient$2 = (definition) => {
 		};
 	};
 };
-const layer$2 = (tag, definition) => layer$18(tag, definition.binding, isR2Bucket, makeClient$2(definition), { expected: expectedR2Bucket });
+const layer$2 = (tag, definition) => layer$19(tag, definition.binding, isR2Bucket, makeClient$2(definition), { expected: expectedR2Bucket });
 const make$3 = (id) => Tag$3()(id);
 const Tag$3 = () => (id) => {
 	const tag = Context.Service()(id);
@@ -2915,7 +2956,7 @@ const makeClient$1 = (definition) => {
 				return {
 					status: status.status,
 					output,
-					error: status.error === void 0 ? Option.none() : Option.some(status.error)
+					error: status.error == null ? Option.none() : Option.some(status.error)
 				};
 			}))),
 			sendEvent: (event) => operation("sendEvent", () => raw.sendEvent(event))
@@ -2944,7 +2985,7 @@ const makeClient$1 = (definition) => {
 		unsafeRaw: Effect.succeed(workflow)
 	});
 };
-const layer$1 = (tag, definition) => layer$18(tag, definition.binding, (value) => isWorkflow(value), makeClient$1(definition), { expected: expectedWorkflow });
+const layer$1 = (tag, definition) => layer$19(tag, definition.binding, (value) => isWorkflow(value), makeClient$1(definition), { expected: expectedWorkflow });
 //#endregion
 //#region src/WorkflowDefinition.ts
 var WorkflowDefinition_exports = /* @__PURE__ */ __exportAll({
@@ -3118,7 +3159,7 @@ const makeClient = (definition) => (index) => {
 		unsafeRaw: Effect.succeed(index)
 	};
 };
-const layer = (tag, definition) => layer$18(tag, definition.binding, isVectorizeBinding, makeClient(definition), { expected: expectedVectorizeBinding });
+const layer = (tag, definition) => layer$19(tag, definition.binding, isVectorizeBinding, makeClient(definition), { expected: expectedVectorizeBinding });
 const make = (id) => Tag()(id);
 const Tag = () => (id) => {
 	const tag = Context.Service()(id);
@@ -3129,4 +3170,4 @@ const Tag = () => (id) => {
 	});
 };
 //#endregion
-export { AiGateway_exports as AiGateway, AnalyticsEngine_exports as AnalyticsEngine, Binding_exports as Binding, BrowserRendering_exports as BrowserRendering, CloudflareOtlp_exports as CloudflareOtlp, ContainerNamespace_exports as ContainerNamespace, D1_exports as D1, DurableObject_exports as DurableObject, DurableObjectAlarm_exports as DurableObjectAlarm, DurableObjectDefinition_exports as DurableObjectDefinition, DurableObjectNamespace_exports as DurableObjectNamespace, DurableObjectRpcWebSocket_exports as DurableObjectRpcWebSocket, DurableObjectSqlite_exports as DurableObjectSqlite, DurableObjectState_exports as DurableObjectState, DurableObjectStorage_exports as DurableObjectStorage, DurableObjectWebSocket_exports as DurableObjectWebSocket, Email_exports as Email, Hyperdrive_exports as Hyperdrive, Images_exports as Images, Kv_exports as Kv, Queue_exports as Queue, QueueBinding_exports as QueueBinding, QueueDefinition_exports as QueueDefinition, R2_exports as R2, Rpc_exports as Rpc, RpcDefinition_exports as RpcDefinition, ServiceBinding_exports as ServiceBinding, Vectorize_exports as Vectorize, Worker_exports as Worker, WorkerConfig, WorkerDefinition_exports as WorkerDefinition, WorkerEnvironment, WorkersAi_exports as WorkersAi, Workflow_exports as Workflow, WorkflowBinding_exports as WorkflowBinding, WorkflowDefinition_exports as WorkflowDefinition };
+export { AiGateway_exports as AiGateway, AnalyticsEngine_exports as AnalyticsEngine, Binding_exports as Binding, BrowserRendering_exports as BrowserRendering, Cache_exports as Cache, CloudflareOtlp_exports as CloudflareOtlp, ContainerNamespace_exports as ContainerNamespace, D1_exports as D1, DurableObject_exports as DurableObject, DurableObjectAlarm_exports as DurableObjectAlarm, DurableObjectDefinition_exports as DurableObjectDefinition, DurableObjectNamespace_exports as DurableObjectNamespace, DurableObjectRpcWebSocket_exports as DurableObjectRpcWebSocket, DurableObjectSqlite_exports as DurableObjectSqlite, DurableObjectState_exports as DurableObjectState, DurableObjectStorage_exports as DurableObjectStorage, DurableObjectWebSocket_exports as DurableObjectWebSocket, Email_exports as Email, Hyperdrive_exports as Hyperdrive, Images_exports as Images, Kv_exports as Kv, Queue_exports as Queue, QueueBinding_exports as QueueBinding, QueueDefinition_exports as QueueDefinition, R2_exports as R2, Rpc_exports as Rpc, RpcDefinition_exports as RpcDefinition, ServiceBinding_exports as ServiceBinding, Vectorize_exports as Vectorize, Worker_exports as Worker, WorkerConfig, WorkerDefinition_exports as WorkerDefinition, WorkerEnvironment, WorkersAi_exports as WorkersAi, Workflow_exports as Workflow, WorkflowBinding_exports as WorkflowBinding, WorkflowDefinition_exports as WorkflowDefinition };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "effect-cf",
-  "version": "0.17.0",
+  "version": "0.18.0",
   "description": "Effect-native primitives for Cloudflare Workers and bindings.",
   "license": "MIT",
   "repository": {

package/src/Cache.ts

@@ -0,0 +1,104 @@
+import type {
+  Cache as CloudflareCache,
+  CacheQueryOptions as CloudflareCacheQueryOptions,
+  CacheStorage as CloudflareCacheStorage,
+  RequestInfo as CloudflareRequestInfo,
+} from "@cloudflare/workers-types";
+import { Context, Data, Effect, Layer, Option } from "effect";
+
+/** Request key accepted by Cloudflare's Cache API. */
+export type CacheRequest = CloudflareRequestInfo | URL;
+
+/** Query options supported by Cloudflare's Cache API. */
+export type CacheQueryOptions = CloudflareCacheQueryOptions;
+
+/** Cache operation represented by {@link CacheOperationError}. */
+export type CacheOperation = "open" | "match" | "put" | "delete";
+
+/** Error raised when a Cloudflare Cache API operation fails. */
+export class CacheOperationError extends Data.TaggedError("CacheOperationError")<{
+  readonly cache: string;
+  readonly operation: CacheOperation;
+  readonly cause: unknown;
+}> {}
+
+/** Effect wrapper around one Cloudflare `Cache` instance. */
+export interface CacheClient {
+  /** Cache name (`default` for `caches.default`). */
+  readonly name: string;
+  /** Finds a cached response, mapping cache misses to `Option.none()`. */
+  readonly match: (
+    request: CacheRequest,
+    options?: CacheQueryOptions,
+  ) => Effect.Effect<Option.Option<Response>, CacheOperationError>;
+  /** Stores a response under the request key. */
+  readonly put: (
+    request: CacheRequest,
+    response: Response,
+  ) => Effect.Effect<void, CacheOperationError>;
+  /** Deletes a cached response and reports whether it existed. */
+  readonly delete: (
+    request: CacheRequest,
+    options?: CacheQueryOptions,
+  ) => Effect.Effect<boolean, CacheOperationError>;
+  /** Access to the native Cloudflare `Cache` instance. */
+  readonly unsafeRaw: Effect.Effect<CloudflareCache>;
+}
+
+/** Effect wrapper around Cloudflare's global `caches` object. */
+export interface CacheStorageClient {
+  /** Cloudflare's shared default cache. */
+  readonly default: CacheClient;
+  /** Opens a named cache. */
+  readonly open: (name: string) => Effect.Effect<CacheClient, CacheOperationError>;
+  /** Access to the native Cloudflare `CacheStorage` instance. */
+  readonly unsafeRaw: Effect.Effect<CloudflareCacheStorage>;
+}
+
+/** Service for Cloudflare's global Cache API. */
+export class CacheStorage extends Context.Service<CacheStorage, CacheStorageClient>()(
+  "effect-cf/CacheStorage",
+) {}
+
+const cacheError = (cache: string, operation: CacheOperation, cause: unknown) =>
+  new CacheOperationError({ cache, operation, cause });
+
+const tryCachePromise = <A>(
+  cache: string,
+  operation: CacheOperation,
+  evaluate: () => Promise<A>,
+): Effect.Effect<A, CacheOperationError> =>
+  Effect.tryPromise({
+    try: evaluate,
+    catch: (cause) => cacheError(cache, operation, cause),
+  });
+
+/** Wraps a native Cloudflare `Cache` instance. */
+export const makeCacheClient = (cache: CloudflareCache, name = "default"): CacheClient => ({
+  name,
+  match: (request, options) =>
+    tryCachePromise(name, "match", () => cache.match(request, options)).pipe(
+      Effect.map(Option.fromUndefinedOr),
+    ),
+  put: (request, response) => tryCachePromise(name, "put", () => cache.put(request, response)),
+  delete: (request, options) =>
+    tryCachePromise(name, "delete", () => cache.delete(request, options)),
+  unsafeRaw: Effect.succeed(cache),
+});
+
+/** Wraps a native Cloudflare `CacheStorage` instance. */
+export const makeClient = (storage: CloudflareCacheStorage): CacheStorageClient => ({
+  default: makeCacheClient(storage.default),
+  open: (name) =>
+    tryCachePromise(name, "open", () => storage.open(name)).pipe(
+      Effect.map((cache) => makeCacheClient(cache, name)),
+    ),
+  unsafeRaw: Effect.succeed(storage),
+});
+
+/** Provides Cache API services from an explicit native `CacheStorage` instance. */
+export const layerFrom = (storage: CloudflareCacheStorage): Layer.Layer<CacheStorage> =>
+  Layer.succeed(CacheStorage, makeClient(storage));
+
+/** Provides Cache API services from Cloudflare's global `caches` object. */
+export const layer: Layer.Layer<CacheStorage> = Layer.sync(CacheStorage, () => makeClient(caches));

package/src/WorkflowBinding.ts

@@ -187,7 +187,7 @@ export const makeClient = <
             return {
               status: status.status,
               output,
-              error: status.error === undefined ? Option.none() : Option.some(status.error),
+              error: status.error == null ? Option.none() : Option.some(status.error),
             };
           }),
         ),

package/src/index.ts

@@ -2,6 +2,7 @@ export * as AiGateway from "./AiGateway";
 export * as AnalyticsEngine from "./AnalyticsEngine";
 export * as Binding from "./Binding";
 export * as BrowserRendering from "./BrowserRendering";
+export * as Cache from "./Cache";
 export * as CloudflareOtlp from "./CloudflareOtlp";
 export * as ContainerNamespace from "./ContainerNamespace";
 export * as D1 from "./D1";