effect-cf 0.32.0 → 0.33.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # effect-cf
 
+## 0.33.0
+
+### Minor Changes
+
+- [#125](https://github.com/danieljvdm/effect-cf/pull/125) [`3821343`](https://github.com/danieljvdm/effect-cf/commit/3821343214de0ab2b05178001cf299488378760a) Thanks [@danieljvdm](https://github.com/danieljvdm)! - Expose `DurableObjectState.abort(reason, { retryAlarm: false })` so alarm handlers can reset the object without retrying the current alarm. The package now targets workerd `1.20260825.1` and recommends `compatibility_date` `2026-08-25`.
+
+## 0.32.1
+
+### Patch Changes
+
+- [#124](https://github.com/danieljvdm/effect-cf/pull/124) [`a37b2b9`](https://github.com/danieljvdm/effect-cf/commit/a37b2b955421d7f274985a4f93b8485fc1f99bbf) Thanks [@danieljvdm](https://github.com/danieljvdm)! - Close hibernatable Durable Object RPC WebSockets with code 1012 after protocol errors so pending calls fail instead of hanging.
+
 ## 0.32.0
 
 ### Minor Changes

package/README.md

@@ -4,8 +4,8 @@ Effect-native Cloudflare primitives for Workers, Durable Objects, Containers, bi
 
 ## Install
 
-`effect-cf` targets Effect `^4.0.0-beta.105` and Cloudflare workerd `1.20260820.1`
-(`@cloudflare/workers-types@5.20260820.1`, recommended `compatibility_date` `2026-08-20`).
+`effect-cf` targets Effect `^4.0.0-beta.105` and Cloudflare workerd `1.20260825.1`
+(`@cloudflare/workers-types@5.20260825.1`, recommended `compatibility_date` `2026-08-25`).
 
 ```bash
 bun add effect-cf "effect@^4.0.0-beta.105"
@@ -274,6 +274,10 @@ same failure modes as `WorkerContext.waitUntil`, so Durable Objects can
 schedule background Effects (for example a pump consuming an outbound
 WebSocket) without capturing a Context and calling `Effect.runPromiseWith`.
 
+`DurableObjectState.abort(reason, { retryAlarm: false })` resets the current
+Durable Object without retrying the alarm that triggered the reset. The option
+has no effect outside an alarm handler and defaults to retrying the alarm.
+
 ## Container Example
 
 Container entrypoints remain owned by `@cloudflare/containers`; `effect-cf`
@@ -729,16 +733,19 @@ export const resizeAvatar = (image: Images.ImageInputValue) =>
 `effect-cf` develops and tests against a fixed Cloudflare Workers runtime stack. Keep consumer
 `compatibility_date` and optional `@cloudflare/workers-types` peers at or above this pin:
 
-| Pin                                         | Version        |
-| ------------------------------------------- | -------------- |
-| workerd                                     | `1.20260820.1` |
-| `@cloudflare/workers-types` (optional peer) | `5.20260820.1` |
-| wrangler (repo catalog / examples)          | `4.125.0`      |
-| Recommended `compatibility_date`            | `2026-08-20`   |
+| Pin                                         | Version              |
+| ------------------------------------------- | -------------------- |
+| workerd                                     | `1.20260825.1`       |
+| `@cloudflare/workers-types` (optional peer) | `5.20260825.1`       |
+| miniflare (repo override / tests)           | `5.20260825.0-alpha` |
+| wrangler (repo catalog / examples)          | `4.126.0`            |
+| Recommended `compatibility_date`            | `2026-08-25`         |
 
 The date in the `workerd` / `@cloudflare/workers-types` version is the API surface this package wraps.
 Repo catalog pins live in the root `package.json` `catalog` field (`@cloudflare/workers-types`, `wrangler`).
-`wrangler@4.125.0` pulls `workerd@1.20260820.1` and peers `@cloudflare/workers-types@^5.20260820.1`.
+`wrangler@4.126.0` pulls `workerd@1.20260825.1` and peers `@cloudflare/workers-types@^5.20260825.1`.
+The Miniflare and Wrangler overrides keep worker tests on the same runtime when
+`@cloudflare/vitest-plugin` lags the repo catalog.
 
 ## Email Example
 

package/dist/ComputerWorkspace.d.mts

@@ -1,5 +1,5 @@
 import { ComputerArtifactsClient } from "./ComputerArtifacts.mjs";
-import { t as DurableObjectState } from "./DurableObjectState-B0A0Y1ef.mjs";
+import { t as DurableObjectState } from "./DurableObjectState-BpRjz6-q.mjs";
 import { Context, Effect, Layer, Schema, Scope, Stream } from "effect";
 import { CommitView, GitClient, GitCloneOptions, GitCommitOptions, GitDiffOptions, GitFetchOptions, GitLogOptions, GitUpdateRefOptions } from "@cloudflare/computer/git";
 import { ExecSyncResult, RuntimeExecOptions, RuntimeGetOptions, RuntimeKillOptions, ShellValue, SkippedEntry, ThinkWorkspaceCompatibility, WorkspaceClient, WorkspaceRuntimeResult, WorkspaceRuntimeValue as WorkspaceRuntimeValue$1 } from "@cloudflare/computer";

package/dist/ComputerWorkspace.mjs

@@ -1,4 +1,4 @@
-import { t as DurableObjectState } from "./DurableObjectState-D1Ibr6k0.mjs";
+import { t as DurableObjectState } from "./DurableObjectState-CVLLse69.mjs";
 import { fromClient } from "./ComputerArtifacts.mjs";
 import { t as lookup } from "./ComputerWorkspaceHostRegistry-CY5Fv4Ng.mjs";
 import { Context, Effect, Layer, Predicate, Schema, Stream } from "effect";

package/dist/{DurableObjectState-B0A0Y1ef.d.mts → DurableObjectState-BpRjz6-q.d.mts}

@@ -1026,9 +1026,11 @@ interface DurableObjectStateService {
   /**
    * Forcibly resets the Durable Object. Cloudflare logs an uncaught Error using
    * the optional reason, and the method is not available in `wrangler dev` local
-   * development according to the Durable Object State docs.
+   * development according to the Durable Object State docs. Set
+   * `retryAlarm: false` to prevent the current alarm invocation from retrying;
+   * this option has no effect outside an alarm handler.
    */
-  abort(reason?: string): Effect.Effect<void>;
+  abort(reason?: string, options?: globalThis.DurableObjectAbortOptions): Effect.Effect<void>;
 }
 declare const DurableObjectState_base: Context.ServiceClass<DurableObjectState, "effect-cf/DurableObjectState", DurableObjectStateService>;
 /**

package/dist/{DurableObjectState-D1Ibr6k0.mjs → DurableObjectState-CVLLse69.mjs}

@@ -343,7 +343,7 @@ const fromDurableObjectState = (state) => {
 		setHibernatableWebSocketEventTimeout: (timeoutMs) => Effect.sync(() => state.setHibernatableWebSocketEventTimeout(timeoutMs)),
 		getHibernatableWebSocketEventTimeout: Effect.sync(() => state.getHibernatableWebSocketEventTimeout()),
 		getTags: (ws) => Effect.sync(() => state.getTags(ws.raw)),
-		abort: (reason) => Effect.sync(() => state.abort(reason))
+		abort: (reason, options) => Effect.sync(() => state.abort(reason, options))
 	};
 };
 const runPromiseExitPreservingTypedFailures = async (context, effect) => {

package/dist/Vitest.d.mts

@@ -1,6 +1,6 @@
 import { c as WorkerEnvironment, s as WorkerEnv } from "./Binding-xJJJPmiD.mjs";
-import { n as DurableObjectStateService, t as DurableObjectState } from "./DurableObjectState-B0A0Y1ef.mjs";
-import { o as WorkflowInstanceStatusName } from "./WorkflowBinding-B9_S8tX2.mjs";
+import { n as DurableObjectStateService, t as DurableObjectState } from "./DurableObjectState-BpRjz6-q.mjs";
+import { o as WorkflowInstanceStatusName } from "./WorkflowBinding-lBR4_-op.mjs";
 import { Effect, Layer, Schema } from "effect";
 import { DurableObject } from "cloudflare:workers";
 import { adminSecretsStore as adminSecretsStore$1, getQueueResult, introspectWorkflow as introspectWorkflow$1, introspectWorkflowInstance as introspectWorkflowInstance$1 } from "cloudflare:test";

package/dist/Vitest.mjs

@@ -1,5 +1,5 @@
 import { a as WorkerEnvironment, i as WorkerConfig } from "./ErrorMessage-BM0K-Nik.mjs";
-import { r as fromDurableObjectState, t as DurableObjectState } from "./DurableObjectState-D1Ibr6k0.mjs";
+import { r as fromDurableObjectState, t as DurableObjectState } from "./DurableObjectState-CVLLse69.mjs";
 import { ConfigProvider, Effect, Exit, Layer } from "effect";
 import { env } from "cloudflare:workers";
 import { abortAllDurableObjects as abortAllDurableObjects$1, adminSecretsStore as adminSecretsStore$1, applyD1Migrations as applyD1Migrations$1, createExecutionContext, createMessageBatch, createPagesEventContext, createScheduledController, evictAllDurableObjects as evictAllDurableObjects$1, evictDurableObject as evictDurableObject$1, getQueueResult, introspectWorkflow as introspectWorkflow$1, introspectWorkflowInstance as introspectWorkflowInstance$1, listDurableObjectIds as listDurableObjectIds$1, reset as reset$1, runDurableObjectAlarm as runDurableObjectAlarm$1, runInDurableObject as runInDurableObject$1, waitOnExecutionContext } from "cloudflare:test";

package/dist/{WorkflowBinding-B9_S8tX2.d.mts → WorkflowBinding-lBR4_-op.d.mts}

@@ -1,5 +1,5 @@
 import { c as WorkerEnvironment, r as BindingValidationError, t as BindingNotFoundError } from "./Binding-xJJJPmiD.mjs";
-import { x as ServiceFreeSchema } from "./DurableObjectState-B0A0Y1ef.mjs";
+import { x as ServiceFreeSchema } from "./DurableObjectState-BpRjz6-q.mjs";
 import { Context, Effect, Option, Schema } from "effect";
 declare namespace WorkflowBinding_d_exports {
   export { WorkflowBindingClient, WorkflowBindingDefinition, WorkflowInstance, WorkflowInstanceCreateBatchOptions, WorkflowInstanceCreateOptions, WorkflowInstanceEvent, WorkflowInstanceLocationHint, WorkflowInstanceRestartOptions, WorkflowInstanceStatus, WorkflowInstanceStatusName, WorkflowInstanceTerminateOptions, WorkflowOperationError, WorkflowResultDecodeError, isWorkflow, layer, makeClient };

package/dist/index.d.mts

@@ -1,9 +1,9 @@
 import { a as Environment_d_exports, c as WorkerEnvironment, i as Binding_d_exports, n as BindingService, o as WorkerConfig, r as BindingValidationError, s as WorkerEnv, t as BindingNotFoundError } from "./Binding-xJJJPmiD.mjs";
 import { l as Artifacts_d_exports } from "./Artifacts-DnHQA-Ax.mjs";
-import { A as StorageOperationError, C as Rpc_d_exports, D as DurableWebSocket, E as DurableObjectWebSocket_d_exports, O as DurableWebSocketAttachmentError, S as Provider, T as AcceptedUpgrade, _ as Definition$4, a as NativeRequest, b as RpcDefinition_d_exports, c as WorkerDefinition_d_exports, d as AsyncMethodCloudflareReturn, f as AsyncMethodKey, g as QueueBinding_d_exports, h as QueueDefinition_d_exports, i as ExecutionContext, k as DurableObjectStorage_d_exports, l as ServiceBinding_d_exports, m as Queue_d_exports, o as WorkerContext, p as AsyncMethodSuccess, r as DurableObjectState_d_exports, s as Worker_d_exports, t as DurableObjectState, u as AsyncMethodArgs, v as Method$2, w as AcceptUpgradeOptions, x as ServiceFreeSchema$1, y as ReservedMethodName$2 } from "./DurableObjectState-B0A0Y1ef.mjs";
+import { A as StorageOperationError, C as Rpc_d_exports, D as DurableWebSocket, E as DurableObjectWebSocket_d_exports, O as DurableWebSocketAttachmentError, S as Provider, T as AcceptedUpgrade, _ as Definition$4, a as NativeRequest, b as RpcDefinition_d_exports, c as WorkerDefinition_d_exports, d as AsyncMethodCloudflareReturn, f as AsyncMethodKey, g as QueueBinding_d_exports, h as QueueDefinition_d_exports, i as ExecutionContext, k as DurableObjectStorage_d_exports, l as ServiceBinding_d_exports, m as Queue_d_exports, o as WorkerContext, p as AsyncMethodSuccess, r as DurableObjectState_d_exports, s as Worker_d_exports, t as DurableObjectState, u as AsyncMethodArgs, v as Method$2, w as AcceptUpgradeOptions, x as ServiceFreeSchema$1, y as ReservedMethodName$2 } from "./DurableObjectState-BpRjz6-q.mjs";
 import { t as Hyperdrive_d_exports } from "./Hyperdrive-z-9fFz15.mjs";
 import { t as ContainerNamespace_d_exports } from "./ContainerNamespace-CFjiLw8b.mjs";
-import { a as WorkflowInstanceCreateOptions, i as WorkflowInstanceCreateBatchOptions, n as WorkflowBinding_d_exports, r as WorkflowInstance, s as WorkflowOperationError, t as WorkflowBindingClient } from "./WorkflowBinding-B9_S8tX2.mjs";
+import { a as WorkflowInstanceCreateOptions, i as WorkflowInstanceCreateBatchOptions, n as WorkflowBinding_d_exports, r as WorkflowInstance, s as WorkflowOperationError, t as WorkflowBindingClient } from "./WorkflowBinding-lBR4_-op.mjs";
 import { Cause, Config, Context, Data, DateTime, Duration, Effect, Layer, Option, Predicate, Redacted, Schema, Scope } from "effect";
 import { Headers as Headers$1, HttpClient, HttpClientResponse } from "effect/unstable/http";
 import { OtlpExporter, OtlpResource } from "effect/unstable/observability";

package/dist/index.mjs

@@ -2,7 +2,7 @@ import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.mjs";
 import { a as WorkerEnvironment, i as WorkerConfig, n as violationsMessage, r as Environment_exports, t as causeMessage } from "./ErrorMessage-BM0K-Nik.mjs";
 import { n as Service$2, r as layer$19, t as Binding_exports } from "./Binding-pfilNJmP.mjs";
 import { n as Artifacts_exports } from "./Artifacts-CSIk1Oml.mjs";
-import { a as DurableObjectWebSocket_exports, c as DurableObjectStorage_exports, i as fromExecutionContext, n as DurableObjectState_exports, o as DurableWebSocketAttachmentError, r as fromDurableObjectState, s as fromWebSocket, t as DurableObjectState } from "./DurableObjectState-D1Ibr6k0.mjs";
+import { a as DurableObjectWebSocket_exports, c as DurableObjectStorage_exports, i as fromExecutionContext, n as DurableObjectState_exports, o as DurableWebSocketAttachmentError, r as fromDurableObjectState, s as fromWebSocket, t as DurableObjectState } from "./DurableObjectState-CVLLse69.mjs";
 import { Cause, Clock, Config, ConfigProvider, Context, Data, DateTime, Duration, Effect, Exit, Function as Function$1, Layer, ManagedRuntime, Option, Predicate, Queue, Result, Schema } from "effect";
 import { FetchHttpClient, HttpClient, HttpClientRequest, HttpEffect, HttpServerRequest, HttpServerResponse } from "effect/unstable/http";
 import { OtlpExporter, OtlpLogger, OtlpMetrics, OtlpSerialization, OtlpTracer } from "effect/unstable/observability";
@@ -2931,10 +2931,7 @@ const layer$8 = (options = {}) => Layer.effectContext(Effect.gen(function* () {
 			return Predicate.isTagged(cause, "MaxBufferSizeExceeded") ? Effect.ignore(connection.socket.close(1009, String(cause))) : send(connection, RpcMessage.ResponseDefectEncoded(cause));
 		})),
 		close: unregister,
-		error: (socket, cause) => Effect.gen(function* () {
-			yield* Effect.logDebug("Durable Object RPC websocket error", cause);
-			yield* unregister(socket);
-		}),
+		error: resetSocket,
 		checkpoint
 	});
 	return Context.mergeAll(Context.make(RpcServer.Protocol, protocol), Context.make(DurableObjectRpcWebSocket, service));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "effect-cf",
-  "version": "0.32.0",
+  "version": "0.33.0",
   "description": "Effect-native primitives for Cloudflare Workers and bindings.",
   "license": "MIT",
   "repository": {
@@ -85,7 +85,7 @@
     "@cloudflare/computer": "^0.2.0",
     "@cloudflare/sandbox": "^0.13.0-next.738.2",
     "@cloudflare/vitest-plugin": "^1.0.0",
-    "@cloudflare/workers-types": "^5.20260820.1",
+    "@cloudflare/workers-types": "^5.20260825.1",
     "@effect/sql-d1": "^4.0.0-rc.110",
     "@effect/sql-pg": "^4.0.0-rc.110",
     "@effect/sql-sqlite-do": "^4.0.0-rc.110",

package/src/DurableObjectRpcWebSocket.ts

@@ -1059,11 +1059,7 @@ export const layer = (
             }),
           ),
         close: unregister,
-        error: (socket, cause) =>
-          Effect.gen(function* () {
-            yield* Effect.logDebug("Durable Object RPC websocket error", cause);
-            yield* unregister(socket);
-          }),
+        error: resetSocket,
         checkpoint,
       });
 

package/src/DurableObjectState.ts

@@ -66,9 +66,11 @@ export interface DurableObjectStateService {
   /**
    * Forcibly resets the Durable Object. Cloudflare logs an uncaught Error using
    * the optional reason, and the method is not available in `wrangler dev` local
-   * development according to the Durable Object State docs.
+   * development according to the Durable Object State docs. Set
+   * `retryAlarm: false` to prevent the current alarm invocation from retrying;
+   * this option has no effect outside an alarm handler.
    */
-  abort(reason?: string): Effect.Effect<void>;
+  abort(reason?: string, options?: globalThis.DurableObjectAbortOptions): Effect.Effect<void>;
 }
 
 /**
@@ -136,7 +138,8 @@ export const fromDurableObjectState = (
       state.getHibernatableWebSocketEventTimeout(),
     ),
     getTags: (ws: DurableWebSocket) => Effect.sync(() => state.getTags(ws.raw)),
-    abort: (reason?: string) => Effect.sync(() => state.abort(reason)),
+    abort: (reason?: string, options?: globalThis.DurableObjectAbortOptions) =>
+      Effect.sync(() => state.abort(reason, options)),
   };
 };