effect-cf 0.50.0 → 0.52.0

package/dist/DurableObjectStorage.d.mts

@@ -2,7 +2,6 @@ import * as Effect from "effect/Effect";
 import * as S from "effect/Schema";
 import * as Option from "effect/Option";
 import * as Cause from "effect/Cause";
-import * as Duration from "effect/Duration";
 declare namespace DurableObjectStorage_d_exports {
   export { DurableObjectStorage, DurableObjectTransaction, SchemaBackedSyncKvStorage, SqlCursor, SqlStorage, SqlStorageValue, StorageOperationError, SyncKvDefinition, SyncKvStorage, fromDurableObjectStorage };
 }
@@ -69,23 +68,17 @@ interface DurableObjectTransaction {
   delete(keys: Array<string>, options?: globalThis.DurableObjectPutOptions): StorageEffect<number>;
   rollback(): StorageEffect<void>;
   getAlarm(options?: globalThis.DurableObjectGetAlarmOptions): StorageEffect<number | null>;
-  setAlarm(scheduledTime: number | Date, options?: globalThis.DurableObjectSetAlarmOptions): StorageEffect<void>;
-  setAlarmAfter(delay: Duration.Input, options?: globalThis.DurableObjectSetAlarmOptions): StorageEffect<void>;
-  deleteAlarm(options?: globalThis.DurableObjectSetAlarmOptions): StorageEffect<void>;
 }
 interface DurableObjectStorage {
   get<T = unknown>(key: string, options?: globalThis.DurableObjectGetOptions): StorageEffect<T | undefined>;
   put<T>(key: string, value: T, options?: globalThis.DurableObjectPutOptions): StorageEffect<void>;
   delete(key: string, options?: globalThis.DurableObjectPutOptions): StorageEffect<boolean>;
   /**
-   * Deletes all stored data. On compatibility dates before 2026-02-24, Cloudflare
-   * documents that active alarms must be deleted separately with `deleteAlarm()`.
+   * Deletes all stored data, including logical schedules. Use the alarm scheduler
+   * to cancel individual alarms without deleting application data.
    */
   deleteAll(options?: globalThis.DurableObjectPutOptions): StorageEffect<void>;
   getAlarm(options?: globalThis.DurableObjectGetAlarmOptions): StorageEffect<number | null>;
-  setAlarm(scheduledTime: number | Date, options?: globalThis.DurableObjectSetAlarmOptions): StorageEffect<void>;
-  setAlarmAfter(delay: Duration.Input, options?: globalThis.DurableObjectSetAlarmOptions): StorageEffect<void>;
-  deleteAlarm(options?: globalThis.DurableObjectSetAlarmOptions): StorageEffect<void>;
   /**
    * SQLite-backed Durable Object storage only.
    *

package/dist/DurableObjectStorage.mjs

@@ -9,8 +9,6 @@ import * as Option from "effect/Option";
 import * as Result from "effect/Result";
 import * as Cause from "effect/Cause";
 import * as Exit from "effect/Exit";
-import * as Clock from "effect/Clock";
-import * as Duration from "effect/Duration";
 import * as Fiber from "effect/Fiber";
 //#region src/DurableObjectStorage.ts
 var DurableObjectStorage_exports = /* @__PURE__ */ __exportAll({
@@ -34,11 +32,6 @@ const tryStoragePromise = (operation, evaluate) => Effect.tryPromise({
 	try: evaluate,
 	catch: (cause) => storageError(operation, cause)
 });
-const setAlarmAfter = Effect.fn("DurableObjectStorage.setAlarmAfter")(function* (operation, setAlarm, delay, options) {
-	const now = yield* Clock.currentTimeMillis;
-	const delayMillis = Math.ceil(Duration.toMillis(delay));
-	yield* tryStoragePromise(operation, () => setAlarm(now + delayMillis, options));
-});
 const fromSqlCursor = (cursor) => ({
 	next: () => tryStorageSync("sql.next", () => cursor.next()),
 	toArray: () => tryStorageSync("sql.toArray", () => cursor.toArray()),
@@ -98,10 +91,7 @@ const fromDurableObjectTransaction = (txn) => ({
 	put: (keyOrEntries, valueOrOptions, maybeOptions) => tryStoragePromise("transaction.put", () => Predicate.isString(keyOrEntries) ? txn.put(keyOrEntries, valueOrOptions, maybeOptions) : txn.put(keyOrEntries, valueOrOptions)),
 	delete: (keyOrKeys, options) => Array.isArray(keyOrKeys) ? tryStoragePromise("transaction.delete", () => txn.delete(keyOrKeys, options)) : tryStoragePromise("transaction.delete", () => txn.delete(keyOrKeys, options)),
 	rollback: () => tryStorageSync("transaction.rollback", () => txn.rollback()),
-	getAlarm: (options) => tryStoragePromise("transaction.getAlarm", () => txn.getAlarm(options)),
-	setAlarm: (scheduledTime, options) => tryStoragePromise("transaction.setAlarm", () => txn.setAlarm(scheduledTime, options)),
-	setAlarmAfter: (delay, options) => setAlarmAfter("transaction.setAlarm", (scheduledTime, options) => txn.setAlarm(scheduledTime, options), delay, options),
-	deleteAlarm: (options) => tryStoragePromise("transaction.deleteAlarm", () => txn.deleteAlarm(options))
+	getAlarm: (options) => tryStoragePromise("transaction.getAlarm", () => txn.getAlarm(options))
 });
 const fromDurableObjectStorage = (storage) => ({
 	get: (key, options) => tryStoragePromise("get", () => storage.get(key, options)),
@@ -109,9 +99,6 @@ const fromDurableObjectStorage = (storage) => ({
 	delete: (key, options) => tryStoragePromise("delete", () => storage.delete(key, options)),
 	deleteAll: (options) => tryStoragePromise("deleteAll", () => storage.deleteAll(options)),
 	getAlarm: (options) => tryStoragePromise("getAlarm", () => storage.getAlarm(options)),
-	setAlarm: (scheduledTime, options) => tryStoragePromise("setAlarm", () => storage.setAlarm(scheduledTime, options)),
-	setAlarmAfter: (delay, options) => setAlarmAfter("setAlarm", (scheduledTime, options) => storage.setAlarm(scheduledTime, options), delay, options),
-	deleteAlarm: (options) => tryStoragePromise("deleteAlarm", () => storage.deleteAlarm(options)),
 	transactionSync: (closure) => Effect.context().pipe(Effect.flatMap((context) => Effect.suspend(() => {
 		let aborted;
 		let escapedFiber;

package/dist/DurableObjectWebSocket.d.mts

@@ -3,8 +3,16 @@ import * as Effect from "effect/Effect";
 import * as S from "effect/Schema";
 import * as Option from "effect/Option";
 declare namespace DurableObjectWebSocket_d_exports {
-  export { AcceptUpgradeOptions, AcceptedUpgrade, AttachmentInvalidPolicy, AttachmentRehydrateOptions, DurableWebSocket, DurableWebSocketAttachment, DurableWebSocketAttachmentError, DurableWebSocketCloseError, DurableWebSocketHandlers, DurableWebSocketSendData, DurableWebSocketSendError, RehydratedDurableWebSocket, acceptUpgrade, attachment, fromWebSocket, handlers };
+  export { AcceptUpgradeOptions, AcceptedUpgrade, AttachmentInvalidPolicy, AttachmentRehydrateOptions, DEFAULT_KEEPALIVE_REQUEST, DEFAULT_KEEPALIVE_RESPONSE, DurableWebSocket, DurableWebSocketAttachment, DurableWebSocketAttachmentError, DurableWebSocketCloseError, DurableWebSocketHandlers, DurableWebSocketSendData, DurableWebSocketSendError, RehydratedDurableWebSocket, acceptUpgrade, attachment, fromWebSocket, handlers, installKeepalive };
 }
+declare const DEFAULT_KEEPALIVE_REQUEST = "effect-cf:ping";
+declare const DEFAULT_KEEPALIVE_RESPONSE = "effect-cf:pong";
+/**
+ * Registers exact text keepalives with Cloudflare so they never invoke the object.
+ * The pair applies to all hibernating sockets on this object; install in its constructor.
+ * Clients send the request text and consume the response outside their application protocol.
+ */
+declare const installKeepalive: (request?: any, response?: any) => Effect.Effect<undefined, never, DurableObjectState>;
 type DurableWebSocketSendData = string | ArrayBuffer | ArrayBufferView;
 declare const DurableWebSocketSendError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
   readonly _tag: "DurableWebSocketSendError";
@@ -80,4 +88,4 @@ declare const handlers: <R = never, E = unknown>(options: DurableWebSocketHandle
   webSocketError: ((socket: DurableWebSocket, cause: unknown) => Effect.Effect<void, E, R>) | undefined;
 };
 //#endregion
-export { AcceptUpgradeOptions, AcceptedUpgrade, AttachmentInvalidPolicy, AttachmentRehydrateOptions, DurableObjectWebSocket_d_exports, DurableWebSocket, DurableWebSocketAttachment, DurableWebSocketAttachmentError, DurableWebSocketCloseError, DurableWebSocketHandlers, DurableWebSocketSendData, DurableWebSocketSendError, RehydratedDurableWebSocket, acceptUpgrade, attachment, fromWebSocket, handlers };
+export { AcceptUpgradeOptions, AcceptedUpgrade, AttachmentInvalidPolicy, AttachmentRehydrateOptions, DEFAULT_KEEPALIVE_REQUEST, DEFAULT_KEEPALIVE_RESPONSE, DurableObjectWebSocket_d_exports, DurableWebSocket, DurableWebSocketAttachment, DurableWebSocketAttachmentError, DurableWebSocketCloseError, DurableWebSocketHandlers, DurableWebSocketSendData, DurableWebSocketSendError, RehydratedDurableWebSocket, acceptUpgrade, attachment, fromWebSocket, handlers, installKeepalive };

package/dist/DurableObjectWebSocket.mjs

@@ -8,13 +8,29 @@ import * as Option from "effect/Option";
 import * as Result from "effect/Result";
 //#region src/DurableObjectWebSocket.ts
 var DurableObjectWebSocket_exports = /* @__PURE__ */ __exportAll({
+	DEFAULT_KEEPALIVE_REQUEST: () => DEFAULT_KEEPALIVE_REQUEST,
+	DEFAULT_KEEPALIVE_RESPONSE: () => DEFAULT_KEEPALIVE_RESPONSE,
 	DurableWebSocketAttachmentError: () => DurableWebSocketAttachmentError,
 	DurableWebSocketCloseError: () => DurableWebSocketCloseError,
 	DurableWebSocketSendError: () => DurableWebSocketSendError,
 	acceptUpgrade: () => acceptUpgrade,
 	attachment: () => attachment,
 	fromWebSocket: () => fromWebSocket,
-	handlers: () => handlers
+	handlers: () => handlers,
+	installKeepalive: () => installKeepalive
+});
+const DEFAULT_KEEPALIVE_REQUEST = "effect-cf:ping";
+const DEFAULT_KEEPALIVE_RESPONSE = "effect-cf:pong";
+/**
+* Registers exact text keepalives with Cloudflare so they never invoke the object.
+* The pair applies to all hibernating sockets on this object; install in its constructor.
+* Clients send the request text and consume the response outside their application protocol.
+*/
+const installKeepalive = Effect.fn("DurableObjectWebSocket.installKeepalive")(function* (request = DEFAULT_KEEPALIVE_REQUEST, response = DEFAULT_KEEPALIVE_RESPONSE) {
+	const state = yield* DurableObjectState;
+	const configured = yield* state.getWebSocketAutoResponse;
+	if (configured !== null && (configured.request !== request || configured.response !== response)) return yield* Effect.die(/* @__PURE__ */ new Error("Durable Object already has a different keepalive protocol"));
+	yield* state.setWebSocketAutoResponse(new WebSocketRequestResponsePair(request, response));
 });
 var DurableWebSocketSendError = class extends Data.TaggedError("DurableWebSocketSendError") {
 	get message() {
@@ -117,4 +133,4 @@ const handlers = (options) => ({
 	webSocketError: options.error
 });
 //#endregion
-export { DurableObjectWebSocket_exports, DurableWebSocketAttachmentError, DurableWebSocketCloseError, DurableWebSocketSendError, acceptUpgrade, attachment, fromWebSocket, handlers };
+export { DEFAULT_KEEPALIVE_REQUEST, DEFAULT_KEEPALIVE_RESPONSE, DurableObjectWebSocket_exports, DurableWebSocketAttachmentError, DurableWebSocketCloseError, DurableWebSocketSendError, acceptUpgrade, attachment, fromWebSocket, handlers, installKeepalive };

package/dist/RpcTracing.mjs

@@ -5,9 +5,9 @@ import * as Schema from "effect/Schema";
 import * as Option from "effect/Option";
 import * as Cause from "effect/Cause";
 import * as Exit from "effect/Exit";
-import * as Clock from "effect/Clock";
 import * as Tracer from "effect/Tracer";
 import * as References from "effect/References";
+import * as Clock from "effect/Clock";
 //#region src/RpcTracing.ts
 var RpcTracing_exports = /* @__PURE__ */ __exportAll({
 	RpcTraceContext: () => RpcTraceContext,

package/package.json

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