@effect/platform-cloudflare 0.0.0-stage → 4.1.3

package/dist/CloudflareWorkflowEngine.d.ts

@@ -0,0 +1,72 @@
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import * as Schedule from "effect/Schedule";
+import * as Workflow from "effect/workflow/Workflow";
+import * as WorkflowEngine from "effect/workflow/WorkflowEngine";
+/**
+ * The workflow Durable Object namespace binding the engine is built from.
+ *
+ * @stability experimental
+ * @category layers
+ * @since 4.1.3
+ */
+export interface LayerOptions {
+    readonly workflowNamespace: DurableObjectNamespace;
+}
+/**
+ * Creates the `WorkflowEngine` service backed by the workflow Durable Object
+ * namespace binding.
+ *
+ * **Details**
+ *
+ * Inside a workflow Durable Object the engine operates on the local execution
+ * handle, so activities and deferred reads never leave the object. Everywhere
+ * else it resolves the target execution's object with `getByName` and drives
+ * it over the same-Worker binding.
+ *
+ * @stability experimental
+ * @category constructors
+ * @since 4.1.3
+ */
+export declare const make: (options: LayerOptions) => Effect.Effect<{
+    readonly register: <Name extends string, Payload extends Workflow.AnyStructSchema, Success extends import("effect/Schema").Top, Error extends import("effect/Schema").Top, R>(workflow: Workflow.Workflow<Name, Payload, Success, Error>, execute: (payload: Payload["Type"], executionId: string) => Effect.Effect<Success["Type"], Error["Type"], R>) => Effect.Effect<void, never, import("effect/Scope").Scope | Exclude<R, WorkflowEngine.WorkflowEngine | WorkflowEngine.WorkflowInstance | Workflow.Execution<Name> | import("effect/Scope").Scope> | Payload["DecodingServices"] | Payload["EncodingServices"] | Success["DecodingServices"] | Success["EncodingServices"] | Error["DecodingServices"] | Error["EncodingServices"]>;
+    readonly execute: <Name extends string, Payload extends Workflow.AnyStructSchema, Success extends import("effect/Schema").Top, Error extends import("effect/Schema").Top, const Discard extends boolean = false>(workflow: Workflow.Workflow<Name, Payload, Success, Error>, options: {
+        readonly executionId: string;
+        readonly payload: Payload["Type"];
+        readonly discard?: Discard | undefined;
+        readonly detached?: boolean | undefined;
+        readonly suspendedRetrySchedule?: Schedule.Schedule<any, unknown> | undefined;
+    }) => Effect.Effect<Discard extends true ? string : Success["Type"], Error["Type"], Payload["EncodingServices"] | Success["DecodingServices"] | Error["DecodingServices"]>;
+    readonly poll: <Name extends string, Payload extends Workflow.AnyStructSchema, Success extends import("effect/Schema").Top, Error extends import("effect/Schema").Top>(workflow: Workflow.Workflow<Name, Payload, Success, Error>, executionId: string) => Effect.Effect<Option.Option<Workflow.Result<Success["Type"], Error["Type"]>>, never, Success["DecodingServices"] | Error["DecodingServices"]>;
+    readonly interrupt: (workflow: Workflow.Any, executionId: string) => Effect.Effect<void>;
+    readonly interruptUnsafe: (workflow: Workflow.Any, executionId: string) => Effect.Effect<void>;
+    readonly resume: (workflow: Workflow.Any, executionId: string) => Effect.Effect<void>;
+    readonly activityExecute: <Success extends import("effect/Schema").Constraint, Error extends import("effect/Schema").Constraint, R>(activity: import("effect/workflow/Activity").Activity<Success, Error, R>, attempt: number) => Effect.Effect<Workflow.Result<Success["Type"], Error["Type"]>, never, Success["DecodingServices"] | Error["DecodingServices"] | R | WorkflowEngine.WorkflowInstance>;
+    readonly deferredResult: <Success extends import("effect/Schema").Constraint, Error extends import("effect/Schema").Constraint>(deferred: import("effect/workflow/DurableDeferred").DurableDeferred<Success, Error>) => Effect.Effect<Option.Option<import("effect/Exit").Exit<Success["Type"], Error["Type"]>>, never, WorkflowEngine.WorkflowInstance>;
+    readonly deferredDone: <Success extends import("effect/Schema").Constraint, Error extends import("effect/Schema").Constraint>(deferred: import("effect/workflow/DurableDeferred").DurableDeferred<Success, Error>, options: {
+        readonly workflowName: string;
+        readonly executionId: string;
+        readonly deferredName: string;
+        readonly exit: import("effect/Exit").Exit<Success["Type"], Error["Type"]>;
+    }) => Effect.Effect<void, never, Success["EncodingServices"] | Error["EncodingServices"]>;
+    readonly scheduleClock: (workflow: Workflow.Any, options: {
+        readonly executionId: string;
+        readonly clock: import("effect/workflow/DurableClock").DurableClock;
+    }) => Effect.Effect<void>;
+}, never, never>;
+/**
+ * Layer that provides the `WorkflowEngine` backed by the workflow Durable
+ * Object namespace binding.
+ *
+ * **Details**
+ *
+ * `CloudflareCluster.layer` already includes this layer; use it directly only
+ * when the workflow engine is needed without the rest of the cluster.
+ *
+ * @stability experimental
+ * @category layers
+ * @since 4.1.3
+ */
+export declare const layer: (options: LayerOptions) => Layer.Layer<WorkflowEngine.WorkflowEngine>;
+//# sourceMappingURL=CloudflareWorkflowEngine.d.ts.map

package/dist/CloudflareWorkflowEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CloudflareWorkflowEngine.d.ts","sourceRoot":"","sources":["../src/CloudflareWorkflowEngine.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAA;AAC3C,OAAO,KAAK,QAAQ,MAAM,0BAA0B,CAAA;AACpD,OAAO,KAAK,cAAc,MAAM,gCAAgC,CAAA;AAahE;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,iBAAiB,EAAE,sBAAsB,CAAA;CACnD;AAOD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;gBAsIf,CAAA;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,KAAK,YAAa,YAAY,KAAG,KAAK,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAC3B,CAAA"}

package/dist/CloudflareWorkflowEngine.js

@@ -0,0 +1,187 @@
+/**
+ * Runs durable workflows on the dedicated workflow Durable Object class.
+ *
+ * On this path one workflow execution is one Durable Object: the engine
+ * encodes `(workflowName, executionId)` into a Durable Object name with the
+ * same length-prefix scheme as entities and resolves the object through the
+ * workflow namespace binding. Execution state, activity results keyed
+ * `${name}/${attempt}`, durable deferred exits, and the clock due table all
+ * live on the object's SQLite storage behind its single alarm.
+ *
+ * Every `DurableClock` is durable on this engine: the in-memory short-sleep
+ * path is disabled, so even sub-minute sleeps persist a due row and arm the
+ * alarm.
+ *
+ * @stability experimental
+ * @since 4.1.3
+ */
+import { Clock } from "effect/Clock";
+import * as Context from "effect/Context";
+import * as Duration from "effect/Duration";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import * as Schedule from "effect/Schedule";
+import * as Workflow from "effect/workflow/Workflow";
+import * as WorkflowEngine from "effect/workflow/WorkflowEngine";
+import { encodeName } from "./internal/clusterName.js";
+import { callDurableObject } from "./internal/transport.js";
+import { CurrentExecutionHandle, registerWorkflow, unregisterWorkflow } from "./internal/workflowRegistry.js";
+import { InterruptSignalName } from "./internal/workflowRuntime.js";
+import { decodeExit, decodeResult, encodeExit, encodePayload } from "./internal/workflowWire.js";
+const retryPolicy = /*#__PURE__*/Schedule.min([/*#__PURE__*/Schedule.exponential(200, 1.5), /*#__PURE__*/Schedule.spaced("1 minute")]);
+/**
+ * Creates the `WorkflowEngine` service backed by the workflow Durable Object
+ * namespace binding.
+ *
+ * **Details**
+ *
+ * Inside a workflow Durable Object the engine operates on the local execution
+ * handle, so activities and deferred reads never leave the object. Everywhere
+ * else it resolves the target execution's object with `getByName` and drives
+ * it over the same-Worker binding.
+ *
+ * @stability experimental
+ * @category constructors
+ * @since 4.1.3
+ */
+export const make = /*#__PURE__*/Effect.fnUntraced(function* (options) {
+  const clock = yield* Clock;
+  // Inside a run the execution's own handle avoids a self-RPC; every other
+  // target resolves to its Durable Object stub through the namespace binding.
+  //
+  // As in `ClusterWorkflowEngine`, a transport failure is retried on an
+  // exponential schedule capped at one minute and only then becomes a defect:
+  // every call here is idempotent by key, and a permanently unreachable object
+  // stalls the caller instead of failing a workflow for good. The object never
+  // rejects for application reasons, so a child's own defect arrives as its
+  // stored `Complete` result and is never retried.
+  const callExecution = (workflowName, executionId, call) => Effect.flatMap(Effect.serviceOption(CurrentExecutionHandle), handle => {
+    if (Option.isSome(handle) && handle.value.executionId === executionId) {
+      const local = handle.value;
+      return Effect.promise(() => call(local));
+    }
+    const name = encodeName(workflowName, executionId);
+    return callDurableObject({
+      resolve: () => options.workflowNamespace.getByName(name),
+      call,
+      retry: retryPolicy
+    }).pipe(Effect.orDie);
+  });
+  const localHandle = Effect.fnUntraced(function* (operation) {
+    const instance = yield* WorkflowEngine.WorkflowInstance;
+    const handle = yield* Effect.serviceOption(CurrentExecutionHandle);
+    if (Option.isNone(handle)) {
+      return yield* Effect.die(`CloudflareWorkflowEngine: ${operation} is only available inside a workflow Durable Object execution`);
+    }
+    return {
+      instance,
+      handle: handle.value
+    };
+  });
+  return WorkflowEngine.makeUnsafe({
+    register: Effect.fnUntraced(function* (workflow, execute) {
+      const context = yield* Effect.context();
+      const registration = {
+        workflow,
+        execute,
+        context
+      };
+      if (!registerWorkflow(workflow._tag, registration)) return;
+      yield* Effect.addFinalizer(() => Effect.sync(() => {
+        unregisterWorkflow(workflow._tag, registration);
+      }));
+    }),
+    execute: Effect.fnUntraced(function* (workflow, opts) {
+      const context = yield* Effect.context();
+      const payload = yield* encodePayload(workflow, opts.payload, context);
+      // A detached child keeps no parent, so neither its completion nor a
+      // failed run wakes the parent.
+      const parent = opts.parent === undefined || opts.detached ? undefined : {
+        workflowName: opts.parent.workflow._tag,
+        executionId: opts.parent.executionId
+      };
+      const text = yield* callExecution(workflow._tag, opts.executionId, stub => stub.run(payload, {
+        discard: opts.discard,
+        parent
+      }));
+      if (opts.discard) return undefined;
+      return yield* decodeResult(workflow, text, context);
+    }),
+    poll: Effect.fnUntraced(function* (workflow, executionId) {
+      const context = yield* Effect.context();
+      const text = yield* callExecution(workflow._tag, executionId, stub => stub.poll());
+      if (text === undefined) return Option.none();
+      return Option.some(yield* decodeResult(workflow, text, context));
+    }),
+    interrupt: (workflow, executionId) => callExecution(workflow._tag, executionId, stub => stub.interrupt()),
+    interruptUnsafe: (workflow, executionId) => callExecution(workflow._tag, executionId, stub => stub.interruptUnsafe()),
+    resume: (workflow, executionId) => callExecution(workflow._tag, executionId, stub => stub.resume()),
+    activityExecute: Effect.fnUntraced(function* (activity, attempt) {
+      const {
+        handle,
+        instance
+      } = yield* localHandle("Activity execution");
+      const key = `${activity.name}/${attempt}`;
+      const stored = handle.loadActivity(key);
+      if (stored !== undefined) {
+        return new Workflow.Complete({
+          exit: yield* decodeExit(stored, Context.empty())
+        });
+      }
+      // A pending interrupt replays only to rebuild compensations, so it must
+      // not start new activities. Suspending lets the run apply the interrupt.
+      if (!instance.interrupted && handle.loadDeferred(InterruptSignalName) !== undefined) {
+        instance.suspended = true;
+        return new Workflow.Suspended({});
+      }
+      const activityInstance = WorkflowEngine.WorkflowInstance.initial(instance.workflow, instance.executionId);
+      activityInstance.interrupted = instance.interrupted;
+      const result = yield* activity.executeEncoded.pipe(Workflow.intoResult, Effect.provideService(WorkflowEngine.WorkflowInstance, activityInstance));
+      if (result._tag === "Complete") {
+        handle.saveActivity(key, yield* encodeExit(result.exit, Context.empty()));
+      }
+      return result;
+    }),
+    deferredResult: Effect.fnUntraced(function* (deferred) {
+      const {
+        handle
+      } = yield* localHandle("DurableDeferred reads");
+      const stored = handle.loadDeferred(deferred.name);
+      if (stored === undefined) return Option.none();
+      return Option.some(yield* decodeExit(stored, Context.empty()));
+    }),
+    deferredDone: Effect.fnUntraced(function* ({
+      deferredName,
+      executionId,
+      exit,
+      workflowName
+    }) {
+      const text = yield* encodeExit(exit, Context.empty());
+      const handle = yield* Effect.serviceOption(CurrentExecutionHandle);
+      if (Option.isSome(handle) && handle.value.executionId === executionId) {
+        return yield* handle.value.completeOwnDeferred(deferredName, text);
+      }
+      yield* callExecution(workflowName, executionId, stub => stub.deferredDone(deferredName, text));
+    }),
+    scheduleClock: Effect.fnUntraced(function* (workflow, opts) {
+      const wakeUp = clock.currentTimeMillisUnsafe() + Math.ceil(Duration.toMillis(opts.clock.duration));
+      yield* callExecution(workflow._tag, opts.executionId, stub => stub.scheduleClock(opts.clock.name, opts.clock.deferred.name, wakeUp));
+    })
+  });
+});
+/**
+ * Layer that provides the `WorkflowEngine` backed by the workflow Durable
+ * Object namespace binding.
+ *
+ * **Details**
+ *
+ * `CloudflareCluster.layer` already includes this layer; use it directly only
+ * when the workflow engine is needed without the rest of the cluster.
+ *
+ * @stability experimental
+ * @category layers
+ * @since 4.1.3
+ */
+export const layer = options => Layer.effect(WorkflowEngine.WorkflowEngine)(make(options));
+//# sourceMappingURL=CloudflareWorkflowEngine.js.map

package/dist/CloudflareWorkflowEngine.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @since 4.1.3
+ */
+/**
+ * @stability experimental
+ * @since 4.1.3
+ */
+export * as CloudflareCluster from "./CloudflareCluster.ts";
+/**
+ * @stability experimental
+ * @since 4.1.3
+ */
+export * as CloudflareDurableObjectPrograms from "./CloudflareDurableObjectPrograms.ts";
+/**
+ * @stability experimental
+ * @since 4.1.3
+ */
+export * as CloudflareDurableObjects from "./CloudflareDurableObjects.ts";
+/**
+ * @stability experimental
+ * @since 4.1.3
+ */
+export * as CloudflarePersistedQueue from "./CloudflarePersistedQueue.ts";
+/**
+ * @stability experimental
+ * @since 4.1.3
+ */
+export * as CloudflareWorkflowEngine from "./CloudflareWorkflowEngine.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH;;;GAGG;AACH,OAAO,KAAK,iBAAiB,MAAM,wBAAwB,CAAA;AAE3D;;;GAGG;AACH,OAAO,KAAK,+BAA+B,MAAM,sCAAsC,CAAA;AAEvF;;;GAGG;AACH,OAAO,KAAK,wBAAwB,MAAM,+BAA+B,CAAA;AAEzE;;;GAGG;AACH,OAAO,KAAK,wBAAwB,MAAM,+BAA+B,CAAA;AAEzE;;;GAGG;AACH,OAAO,KAAK,wBAAwB,MAAM,+BAA+B,CAAA"}

package/dist/index.js

@@ -0,0 +1,33 @@
+/**
+ * @since 4.1.3
+ */
+// The index stays free of the optional `alchemy` peer dependency, so the
+// Alchemy integration is exposed only through its own entrypoint:
+// `@effect/platform-cloudflare/AlchemyCloudflareCluster`.
+// @barrel(Cloudflare*.ts): Auto-generated exports. Do not edit manually.
+/**
+ * @stability experimental
+ * @since 4.1.3
+ */
+export * as CloudflareCluster from "./CloudflareCluster.js";
+/**
+ * @stability experimental
+ * @since 4.1.3
+ */
+export * as CloudflareDurableObjectPrograms from "./CloudflareDurableObjectPrograms.js";
+/**
+ * @stability experimental
+ * @since 4.1.3
+ */
+export * as CloudflareDurableObjects from "./CloudflareDurableObjects.js";
+/**
+ * @stability experimental
+ * @since 4.1.3
+ */
+export * as CloudflarePersistedQueue from "./CloudflarePersistedQueue.js";
+/**
+ * @stability experimental
+ * @since 4.1.3
+ */
+export * as CloudflareWorkflowEngine from "./CloudflareWorkflowEngine.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":[null],"mappings":"AAAA;;;AAIA;AACA;AACA;AACA;AAEA;;;;AAIA,OAAO,KAAK,iBAAiB,MAAM,wBAAwB;AAE3D;;;;AAIA,OAAO,KAAK,+BAA+B,MAAM,sCAAsC;AAEvF;;;;AAIA,OAAO,KAAK,wBAAwB,MAAM,+BAA+B;AAEzE;;;;AAIA,OAAO,KAAK,wBAAwB,MAAM,+BAA+B;AAEzE;;;;AAIA,OAAO,KAAK,wBAAwB,MAAM,+BAA+B","ignoreList":[]}

package/dist/internal/alchemyCluster.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=alchemyCluster.d.ts.map

package/dist/internal/alchemyCluster.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alchemyCluster.d.ts","sourceRoot":"","sources":["../../src/internal/alchemyCluster.ts"],"names":[],"mappings":""}

package/dist/internal/alchemyCluster.js

@@ -0,0 +1,75 @@
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Scope from "effect/Scope";
+import * as CloudflareCluster from "../CloudflareCluster.js";
+import { boundedRetry, callDurableObject } from "./transport.js";
+/** @internal */
+export const makeClusterHandle = /*#__PURE__*/Effect.fnUntraced(function* (options) {
+  const entityNamespace = options.env.ClusterEntity;
+  const workflowNamespace = options.env.ClusterWorkflow;
+  const queueNamespace = options.env.ClusterDurableQueue;
+  const singletonNamespace = options.env.ClusterSingleton;
+  // The isolate-lifetime scope. workerd has no isolate-teardown hook, so it
+  // is never closed; the built services live for the isolate, exactly like
+  // the Wrangler path's `setInitializer` build.
+  const scope = Scope.makeUnsafe();
+  const context = yield* Layer.buildWithScope(options.layer.pipe(Layer.provideMerge(CloudflareCluster.layer({
+    entities: options.entities,
+    entityNamespace,
+    workflowNamespace,
+    queueNamespace,
+    singletonNamespace,
+    keepAliveHeartbeat: options.keepAliveHeartbeat
+  }))), scope).pipe(
+  // Drop the build's memo map so a Layer the user provides inside a
+  // handler builds per event instead of sharing one instance pinned to
+  // the first request's IoContext.
+  Effect.map(Context.omit(Layer.CurrentMemoMap)));
+  const handle = {
+    provide: effect => Effect.provideContext(effect, context),
+    // Only a transport failure rejects `wake()`, so retrying never reruns a
+    // failed singleton. A failed run still fails the Cron Trigger.
+    wake: name => () => callDurableObject({
+      resolve: () => singletonNamespace.getByName(`Singleton/${name}`),
+      call: stub => stub.wake(),
+      retry: boundedRetry
+    }).pipe(Effect.orDie, Effect.flatMap(result => result?._tag === "Failure" ? Effect.die(new Error(`Singleton "${name}" failed: ${result.message}`)) : Effect.void)),
+    entityNamespace,
+    workflowNamespace,
+    queueNamespace,
+    singletonNamespace,
+    context
+  };
+  return handle;
+});
+/**
+ * The plan-time handle: the deploy-machine evaluation only discovers the
+ * Durable Object declarations, and nothing returned from the Worker init
+ * program runs outside the deployed isolate.
+ *
+ * @internal
+ */
+export const inertClusterHandle = () => ({
+  provide: effect => effect,
+  wake: () => () => Effect.void,
+  get entityNamespace() {
+    return planTimeOnly("entityNamespace");
+  },
+  get workflowNamespace() {
+    return planTimeOnly("workflowNamespace");
+  },
+  get queueNamespace() {
+    return planTimeOnly("queueNamespace");
+  },
+  get singletonNamespace() {
+    return planTimeOnly("singletonNamespace");
+  },
+  get context() {
+    return planTimeOnly("context");
+  }
+});
+const planTimeOnly = field => {
+  throw new Error(`AlchemyCloudflareCluster: '${field}' is only available at runtime, not during plan evaluation`);
+};
+//# sourceMappingURL=alchemyCluster.js.map

package/dist/internal/alchemyCluster.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alchemyCluster.js","names":[],"sources":["../../src/internal/alchemyCluster.ts"],"sourcesContent":[null],"mappings":"AASA,OAAO,KAAK,OAAO,MAAM,gBAAgB;AAEzC,OAAO,KAAK,MAAM,MAAM,eAAe;AACvC,OAAO,KAAK,KAAK,MAAM,cAAc;AACrC,OAAO,KAAK,KAAK,MAAM,cAAc;AACrC,OAAO,KAAK,iBAAiB,MAAM,yBAAyB;AAG5D,SAAS,YAAY,EAAE,iBAAiB,QAAQ,gBAAgB;AAehE;AACA,OAAO,MAAM,iBAAiB,gBAAG,MAAM,CAAC,UAAU,CAAC,WAAU,OAA6B;EACxF,MAAM,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,aAAuC;EAC3E,MAAM,iBAAiB,GAAG,OAAO,CAAC,GAAG,CAAC,eAAyC;EAC/E,MAAM,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,mBAA6C;EAChF,MAAM,kBAAkB,GAAG,OAAO,CAAC,GAAG,CAAC,gBAA0C;EAEjF;EACA;EACA;EACA,MAAM,KAAK,GAAG,KAAK,CAAC,UAAU,EAAE;EAChC,MAAM,OAAO,GAAG,OAAO,KAAK,CAAC,cAAc,CACzC,OAAO,CAAC,KAAK,CAAC,IAAI,CAChB,KAAK,CAAC,YAAY,CAAC,iBAAiB,CAAC,KAAK,CAAC;IACzC,QAAQ,EAAE,OAAO,CAAC,QAAQ;IAC1B,eAAe;IACf,iBAAiB;IACjB,cAAc;IACd,kBAAkB;IAClB,kBAAkB,EAAE,OAAO,CAAC;GAC7B,CAAC,CAAC,CACJ,EACD,KAAK,CACN,CAAC,IAAI;EACJ;EACA;EACA;EACA,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAC/C;EAED,MAAM,MAAM,GAAmB;IAC7B,OAAO,EAAG,MAAM,IAAK,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC;IAC3D;IACA;IACA,IAAI,EAAG,IAAI,IAAK,MACd,iBAAiB,CAAC;MAChB,OAAO,EAAE,MAAM,kBAAkB,CAAC,SAAS,CAAC,aAAa,IAAI,EAAE,CAA6B;MAC5F,IAAI,EAAG,IAAI,IAAK,IAAI,CAAC,IAAI,EAAE;MAC3B,KAAK,EAAE;KACR,CAAC,CAAC,IAAI,CACL,MAAM,CAAC,KAAK,EACZ,MAAM,CAAC,OAAO,CAAE,MAAM,IACpB,MAAM,EAAE,IAAI,KAAK,SAAS,GACtB,MAAM,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,cAAc,IAAI,aAAa,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,GACtE,MAAM,CAAC,IAAI,CAChB,CACF;IACH,eAAe;IACf,iBAAiB;IACjB,cAAc;IACd,kBAAkB;IAClB;GACD;EACD,OAAO,MAAM;AACf,CAAC,CAAC;AAEF;;;;;;;AAOA,OAAO,MAAM,kBAAkB,GAAG,OAAuB;EACvD,OAAO,EAAG,MAAM,IAAK,MAAM;EAC3B,IAAI,EAAE,MAAM,MAAM,MAAM,CAAC,IAAI;EAC7B,IAAI,eAAe;IACjB,OAAO,YAAY,CAAC,iBAAiB,CAAC;EACxC,CAAC;EACD,IAAI,iBAAiB;IACnB,OAAO,YAAY,CAAC,mBAAmB,CAAC;EAC1C,CAAC;EACD,IAAI,cAAc;IAChB,OAAO,YAAY,CAAC,gBAAgB,CAAC;EACvC,CAAC;EACD,IAAI,kBAAkB;IACpB,OAAO,YAAY,CAAC,oBAAoB,CAAC;EAC3C,CAAC;EACD,IAAI,OAAO;IACT,OAAO,YAAY,CAAC,SAAS,CAAC;EAChC;CACD,CAAC;AAEF,MAAM,YAAY,GAAI,KAAa,IAAW;EAC5C,MAAM,IAAI,KAAK,CACb,8BAA8B,KAAK,4DAA4D,CAChG;AACH,CAAC","ignoreList":[]}

package/dist/internal/boundedMap.d.ts

@@ -0,0 +1,3 @@
+/** @internal */
+export {};
+//# sourceMappingURL=boundedMap.d.ts.map

package/dist/internal/boundedMap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boundedMap.d.ts","sourceRoot":"","sources":["../../src/internal/boundedMap.ts"],"names":[],"mappings":"AAAA,gBAAgB"}

package/dist/internal/boundedMap.js

@@ -0,0 +1,15 @@
+/** @internal */
+/**
+ * Inserts refreshing the key's recency, then evicts the oldest entry once the
+ * map exceeds `capacity`.
+ *
+ * @internal
+ */
+export const setWithEviction = (map, key, value, capacity) => {
+  map.delete(key);
+  map.set(key, value);
+  if (map.size <= capacity) return;
+  const oldest = map.keys().next().value;
+  if (oldest !== undefined) map.delete(oldest);
+};
+//# sourceMappingURL=boundedMap.js.map

package/dist/internal/boundedMap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boundedMap.js","names":[],"sources":["../../src/internal/boundedMap.ts"],"sourcesContent":[null],"mappings":"AAAA;AAEA;;;;;;AAMA,OAAO,MAAM,eAAe,GAAG,CAAO,GAAc,EAAE,GAAM,EAAE,KAAQ,EAAE,QAAgB,KAAU;EAChG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC;EACf,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC;EACnB,IAAI,GAAG,CAAC,IAAI,IAAI,QAAQ,EAAE;EAC1B,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK;EACtC,IAAI,MAAM,KAAK,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC;AAC9C,CAAC","ignoreList":[]}

package/dist/internal/cluster.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Shared cluster handle types without the Alchemy dependency graph.
+ *
+ * @since 4.1.3
+ */
+import type * as Context from "effect/Context";
+import type * as Effect from "effect/Effect";
+/**
+ * The handle returned by `AlchemyCloudflareCluster.make`.
+ *
+ * **Gotchas**
+ *
+ * Namespace bindings and `context` are available only in the deployed runtime.
+ * Reading them during plan evaluation throws a diagnostic; `provide` and
+ * `wake` remain inert during planning.
+ *
+ * @category models
+ * @since 4.1.3
+ */
+export interface Cluster<in R = never> {
+    /**
+     * Attaches the built cluster context to a user Effect, for the Worker's
+     * `fetch` handler and other entrypoints. Only provides the already-built
+     * Context; it does not open a new Scope.
+     */
+    readonly provide: <A, E, R2>(effect: Effect.Effect<A, E, R2>) => Effect.Effect<A, E, Exclude<R2, R>>;
+    /**
+     * A handler that wakes the named singleton, for `Cloudflare.Workers.cron`.
+     * The name is the singleton name without the `Singleton/` prefix, and the
+     * returned handler is already context-provided. A `ClusterCron` fires only
+     * once its seed singleton is woken; get its name from
+     * `CloudflareCluster.clusterCronSingletonName`.
+     */
+    readonly wake: (name: string) => () => Effect.Effect<void>;
+    /**
+     * The native namespace binding of the cluster entity class.
+     */
+    readonly entityNamespace: DurableObjectNamespace;
+    /**
+     * The native namespace binding of the workflow class.
+     */
+    readonly workflowNamespace: DurableObjectNamespace;
+    /**
+     * The native namespace binding of the durable queue class.
+     */
+    readonly queueNamespace: DurableObjectNamespace;
+    /**
+     * The native namespace binding of the singleton class.
+     */
+    readonly singletonNamespace: DurableObjectNamespace;
+    /**
+     * The Context built from the cluster layer and the user layer into the
+     * isolate-lifetime Scope.
+     */
+    readonly context: Context.Context<R>;
+}
+//# sourceMappingURL=cluster.d.ts.map

package/dist/internal/cluster.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cluster.d.ts","sourceRoot":"","sources":["../../src/internal/cluster.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,KAAK,OAAO,MAAM,gBAAgB,CAAA;AAC9C,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAA;AAE5C;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,OAAO,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK;IACnC;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAA;IACpG;;;;;;OAMG;IACH,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IAC1D;;OAEG;IACH,QAAQ,CAAC,eAAe,EAAE,sBAAsB,CAAA;IAChD;;OAEG;IACH,QAAQ,CAAC,iBAAiB,EAAE,sBAAsB,CAAA;IAClD;;OAEG;IACH,QAAQ,CAAC,cAAc,EAAE,sBAAsB,CAAA;IAC/C;;OAEG;IACH,QAAQ,CAAC,kBAAkB,EAAE,sBAAsB,CAAA;IACnD;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;CACrC"}

package/dist/internal/cluster.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cluster.js.map

package/dist/internal/cluster.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cluster.js","names":[],"sources":["../../src/internal/cluster.ts"],"sourcesContent":[null],"mappings":"","ignoreList":[]}

package/dist/internal/clusterName.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=clusterName.d.ts.map

package/dist/internal/clusterName.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clusterName.d.ts","sourceRoot":"","sources":["../../src/internal/clusterName.ts"],"names":[],"mappings":""}

package/dist/internal/clusterName.js

@@ -0,0 +1,16 @@
+/** @internal */
+export const encodeName = (type, id) => `${type.length}:${type}${id}`;
+const lengthPrefix = /^([1-9]\d*):/;
+/** @internal */
+export const decodeName = name => {
+  const match = lengthPrefix.exec(name);
+  if (match === null) return undefined;
+  const typeLength = Number(match[1]);
+  const payload = name.slice(match[0].length);
+  if (typeLength > payload.length) return undefined;
+  return {
+    type: payload.slice(0, typeLength),
+    id: payload.slice(typeLength)
+  };
+};
+//# sourceMappingURL=clusterName.js.map

package/dist/internal/clusterName.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clusterName.js","names":[],"sources":["../../src/internal/clusterName.ts"],"sourcesContent":[null],"mappings":"AAEA;AACA,OAAO,MAAM,UAAU,GAAG,CAAC,IAAY,EAAE,EAAU,KAAa,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,GAAG,EAAE,EAAE;AAE7F,MAAM,YAAY,GAAG,cAAc;AAEnC;AACA,OAAO,MAAM,UAAU,GAAI,IAAY,IAA6B;EAClE,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC;EACrC,IAAI,KAAK,KAAK,IAAI,EAAE,OAAO,SAAS;EACpC,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;EACnC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;EAC3C,IAAI,UAAU,GAAG,OAAO,CAAC,MAAM,EAAE,OAAO,SAAS;EACjD,OAAO;IACL,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC;IAClC,EAAE,EAAE,OAAO,CAAC,KAAK,CAAC,UAAU;GAC7B;AACH,CAAC","ignoreList":[]}

package/dist/internal/entityKeepAlive.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=entityKeepAlive.d.ts.map

package/dist/internal/entityKeepAlive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entityKeepAlive.d.ts","sourceRoot":"","sources":["../../src/internal/entityKeepAlive.ts"],"names":[],"mappings":""}

package/dist/internal/entityKeepAlive.js

@@ -0,0 +1,73 @@
+/**
+ * Keep-alive for one entity Durable Object, in three separate pieces of
+ * state:
+ *
+ * - `wanted` mirrors the persisted `keep_alive` flag that a restart restores.
+ * - `hold` is the fiber running the self `hold()` RPC while one is in flight.
+ * - The holder count belongs to the current handler build only. Persisting it
+ *   would break on restart: an `EntityResource` re-acquired by the rebuild
+ *   adds a holder on top of the stored count, which then never returns to 0.
+ *
+ * @internal
+ */
+import * as Duration from "effect/Duration";
+import * as Effect from "effect/Effect";
+import * as Latch from "effect/Latch";
+import * as Schedule from "effect/Schedule";
+/** @internal */
+export const makeEntityKeepAlive = options => {
+  const latch = Latch.makeUnsafe(true);
+  let holders = 0;
+  let wanted = options.wanted;
+  let hold;
+  // A safeguard only: production probes never saw a rejected hold.
+  const runHold = Effect.tryPromise(() => options.startHold()).pipe(Effect.tapError(error => Effect.logWarning("Entity keep-alive hold failed, retrying", error)), Effect.retry(Schedule.exponential(100).pipe(Schedule.modifyDelay(({
+    duration
+  }) => Effect.succeed(Duration.min(duration, Duration.millis(options.retryCapMillis())))), Schedule.jittered)));
+  const restore = () => {
+    if (!wanted || hold !== undefined) return;
+    latch.closeUnsafe();
+    const fiber = Effect.runFork(runHold);
+    hold = fiber;
+    fiber.addObserver(() => {
+      if (hold === fiber) hold = undefined;
+    });
+  };
+  const release = () => {
+    if (hold === undefined) return;
+    hold.interruptUnsafe();
+    hold = undefined;
+    latch.openUnsafe();
+  };
+  const setWanted = next => {
+    if (wanted === next) return;
+    wanted = next;
+    // Mailbox writes wait for an open user transaction, so writing inline
+    // would deadlock `Entity.keepAlive` called inside `withTransaction`.
+    Effect.runFork(Effect.suspend(() => options.persist(next)).pipe(Effect.andThen(Effect.sync(() => {
+      if (!next && !wanted) release();
+    })), Effect.catchCause(cause => Effect.logError("Entity keep-alive persistence failed", cause))));
+  };
+  const update = enabled => Effect.sync(() => {
+    if (enabled) {
+      holders++;
+      setWanted(true);
+      // Also restarts a hold that ended without a release.
+      restore();
+      return;
+    }
+    // With no holders in memory the flag may still be set: a fresh object
+    // after a restart has count 0 while its stored row says 1.
+    if (holders > 0) holders--;
+    if (holders === 0) setWanted(false);
+  });
+  return {
+    update,
+    await: latch.await,
+    resetHolders: () => {
+      holders = 0;
+    },
+    restore
+  };
+};
+//# sourceMappingURL=entityKeepAlive.js.map