@shware/workflow 2.0.0 → 3.0.0

package/dist/aws/instances.mjs

@@ -0,0 +1,172 @@
+import { murmur3 } from "../engine/bucket.mjs";
+import { InstanceNotFoundError } from "../cloudflare/bindings.mjs";
+//#region src/aws/instances.ts
+/**
+* The router's instance port over Lambda durable executions: an instance is one execution of
+* this same function, started by an asynchronous self-invoke under a stable execution name;
+* a wake completes the callback its current wait parks on; stopping stops the execution.
+*/
+/** The top-level shape of an internal run: what the self-invoke sends, never an HTTP body. */
+const RUN_EVENT_TYPE = "$workflow.run";
+function isRunInput(event) {
+	if (typeof event !== "object" || event === null) return false;
+	const candidate = event;
+	return candidate.type === "$workflow.run" && candidate.requestContext === void 0 && typeof candidate.instanceId === "string" && typeof candidate.enteredAtMs === "number" && typeof candidate.params === "object" && candidate.params !== null;
+}
+const utf8 = new TextEncoder();
+const NAME = /^[a-zA-Z0-9_-]{1,64}$/;
+/**
+* The durable execution name for an instance: the instance id itself when it fits, otherwise a
+* prefix of it with a fingerprint of the whole — stable, so every retry of the start reuses it.
+*/
+function executionName(instanceId) {
+	if (NAME.test(instanceId)) return instanceId;
+	const safe = instanceId.replace(/[^a-zA-Z0-9_-]/g, "-");
+	const fingerprint = `${murmur3(utf8.encode(instanceId)).toString(36)}${murmur3(utf8.encode(instanceId), 2538058380).toString(36)}`;
+	return `${safe.slice(0, 63 - fingerprint.length)}-${fingerprint}`;
+}
+const MINUTE = 6e4;
+var AwsInstances = class {
+	options;
+	now;
+	startRetryMs;
+	reconcileEveryMs;
+	constructor(options) {
+		this.options = options;
+		this.now = options.now ?? Date.now;
+		this.startRetryMs = options.startRetryMs ?? 720 * MINUTE;
+		this.reconcileEveryMs = options.reconcileEveryMs ?? 15 * MINUTE;
+	}
+	async plan(options) {
+		const input = {
+			type: RUN_EVENT_TYPE,
+			instanceId: options.id,
+			params: options.params,
+			enteredAtMs: this.now()
+		};
+		return {
+			name: executionName(options.id),
+			target: await this.options.target(options.params.contentHash),
+			input: JSON.stringify(input)
+		};
+	}
+	async create(options) {
+		const record = await this.options.executions.get(options.id);
+		if (record === void 0) throw new Error(`no start is recorded for ${options.id}: the entry must be planned first`);
+		await this.submit(record);
+		return this.instance(options.id);
+	}
+	async get(id) {
+		if (await this.options.executions.get(id) === void 0) throw new InstanceNotFoundError(id);
+		return this.instance(id);
+	}
+	async resume(entry) {
+		for (const record of await this.options.executions.pendingStarts({
+			...entry,
+			limit: 1
+		})) if (!await this.giveUpIfStale(record)) await this.submit(record);
+	}
+	async maintain() {
+		const now = this.now();
+		const failures = [];
+		for (const record of await this.options.executions.pendingStarts({
+			createdBefore: now - MINUTE,
+			limit: 25
+		})) try {
+			if (!await this.giveUpIfStale(record)) await this.submit(record);
+		} catch (error) {
+			failures.push(error);
+		}
+		for (const record of await this.options.executions.toReconcile(25, now - this.reconcileEveryMs)) try {
+			await this.reconcile(record, now);
+		} catch (error) {
+			failures.push(error);
+		}
+		if (failures.length > 0) throw failures[0];
+	}
+	async submit(record) {
+		const { arn } = await this.options.lambda.startExecution({
+			target: record.target,
+			name: record.name,
+			payload: record.input
+		});
+		await this.options.executions.markSubmitted(record.instanceId, arn, this.now());
+	}
+	/** Past the retry budget a start is unresolved for good: no retry could tell a duplicate apart. */
+	async giveUpIfStale(record) {
+		if (this.now() - record.createdAt <= this.startRetryMs) return false;
+		await this.options.executions.markUnresolved(record.instanceId, this.now());
+		console.error(`[workflow] the start of ${record.instanceId} (${record.name}) was never confirmed: left unresolved`);
+		return true;
+	}
+	async arnOf(record) {
+		if (record.arn !== void 0) return record.arn;
+		const arn = await this.options.lambda.findExecution(record.target, record.name);
+		if (arn !== void 0) await this.options.executions.setArn(record.instanceId, arn);
+		return arn;
+	}
+	/**
+	* Past the start retry budget, an execution still nowhere to be seen never started: any queued
+	* invoke has expired by then. Before that, not finding it says nothing.
+	*/
+	vanished(record) {
+		return this.now() - record.createdAt > this.startRetryMs;
+	}
+	async reconcile(record, now) {
+		const arn = await this.arnOf(record);
+		const state = arn === void 0 ? void 0 : await this.options.lambda.executionState(arn);
+		if (state === "failed" || state === "stopped" || state === "timed_out" || state === void 0 && this.vanished(record)) {
+			const { store } = this.options;
+			await store.setEntryStatus(record.instanceId, "failed");
+			await store.reporting?.instanceFinished({
+				workflow: record.workflow,
+				instanceId: record.instanceId,
+				userId: record.userId,
+				status: "failed",
+				at: now
+			});
+			console.warn(`[workflow] ${record.instanceId} ended on the platform (${state ?? "unknown"}) without finishing: recorded as failed`);
+		}
+		await this.options.executions.markChecked(record.instanceId, now);
+	}
+	instance(id) {
+		const { executions, lambda } = this.options;
+		const current = async () => {
+			const record = await executions.get(id);
+			if (record === void 0) throw new InstanceNotFoundError(id);
+			return record;
+		};
+		return {
+			id,
+			sendEvent: async (event) => {
+				const { callbackId } = await current();
+				if (callbackId === void 0) return;
+				await lambda.completeCallback(callbackId, JSON.stringify(event.payload ?? {}));
+			},
+			terminate: async () => {
+				const record = await current();
+				if (record.submittedAt === void 0 && record.unresolvedAt === void 0) await executions.markUnresolved(id, this.now());
+				const arn = await this.arnOf(record);
+				if (arn === void 0) {
+					if (this.vanished(record)) return;
+					throw new Error(`cannot stop ${id} yet: its execution is not visible`);
+				}
+				if (!await lambda.stopExecution(arn)) throw new Error(`stopping ${id} failed`);
+			},
+			status: async () => {
+				const record = await current();
+				const arn = await this.arnOf(record);
+				if (arn === void 0) return { status: this.vanished(record) ? "terminated" : "running" };
+				const state = await lambda.executionState(arn);
+				if (state === "succeeded") return { status: "complete" };
+				if (state === "failed") return { status: "errored" };
+				if (state === "running") return { status: "running" };
+				return { status: "terminated" };
+			}
+		};
+	}
+};
+//#endregion
+export { AwsInstances, RUN_EVENT_TYPE, executionName, isRunInput };
+
+//# sourceMappingURL=instances.mjs.map

package/dist/aws/instances.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"instances.mjs","names":[],"sources":["../../src/aws/instances.ts"],"sourcesContent":["import {\n  InstanceNotFoundError,\n  type JourneyParams,\n  type WorkflowBindingLike,\n  type WorkflowInstanceLike,\n} from '../cloudflare/bindings';\nimport { murmur3 } from '../engine/bucket';\nimport type {\n  ExecutionRecord,\n  ExecutionRegistry,\n  ExecutionStart,\n  JourneyStore,\n} from '../store/index';\nimport type { LambdaApi } from './lambda-api';\n\n/**\n * The router's instance port over Lambda durable executions: an instance is one execution of\n * this same function, started by an asynchronous self-invoke under a stable execution name;\n * a wake completes the callback its current wait parks on; stopping stops the execution.\n */\n\n/** The top-level shape of an internal run: what the self-invoke sends, never an HTTP body. */\nexport const RUN_EVENT_TYPE = '$workflow.run';\n\nexport interface RunInput {\n  type: typeof RUN_EVENT_TYPE;\n  instanceId: string;\n  params: JourneyParams;\n  /** When the instance was created (as Cloudflare's event timestamp): its entry anchor, fixed with the start. */\n  enteredAtMs: number;\n}\n\nexport function isRunInput(event: unknown): event is RunInput {\n  if (typeof event !== 'object' || event === null) return false;\n  const candidate = event as {\n    type?: unknown;\n    instanceId?: unknown;\n    enteredAtMs?: unknown;\n    params?: unknown;\n    requestContext?: unknown;\n  };\n  return (\n    candidate.type === RUN_EVENT_TYPE &&\n    candidate.requestContext === undefined &&\n    typeof candidate.instanceId === 'string' &&\n    typeof candidate.enteredAtMs === 'number' &&\n    typeof candidate.params === 'object' &&\n    candidate.params !== null\n  );\n}\n\nconst utf8 = new TextEncoder();\nconst NAME = /^[a-zA-Z0-9_-]{1,64}$/;\n\n/**\n * The durable execution name for an instance: the instance id itself when it fits, otherwise a\n * prefix of it with a fingerprint of the whole — stable, so every retry of the start reuses it.\n */\nexport function executionName(instanceId: string): string {\n  if (NAME.test(instanceId)) return instanceId;\n  const safe = instanceId.replace(/[^a-zA-Z0-9_-]/g, '-');\n  const fingerprint = `${murmur3(utf8.encode(instanceId)).toString(36)}${murmur3(utf8.encode(instanceId), 0x9747b28c).toString(36)}`;\n  return `${safe.slice(0, 63 - fingerprint.length)}-${fingerprint}`;\n}\n\nexport interface AwsInstancesOptions {\n  store: JourneyStore;\n  executions: ExecutionRegistry;\n  lambda: LambdaApi;\n  /** The qualified function ARN an execution pinned to `contentHash` must run on. */\n  target(contentHash: string): Promise<string>;\n  /**\n   * How long an unconfirmed start keeps being retried. It must stay shorter than the durable\n   * execution retention: past that the platform forgets the name, and a retry would start a\n   * second execution. Twelve hours by default.\n   */\n  startRetryMs?: number;\n  /** How stale a running instance's last check must be before maintenance looks again. */\n  reconcileEveryMs?: number;\n  now?: () => number;\n}\n\nconst MINUTE = 60_000;\n\nexport class AwsInstances implements WorkflowBindingLike {\n  private readonly now: () => number;\n  private readonly startRetryMs: number;\n  private readonly reconcileEveryMs: number;\n\n  constructor(private readonly options: AwsInstancesOptions) {\n    this.now = options.now ?? Date.now;\n    this.startRetryMs = options.startRetryMs ?? 12 * 60 * MINUTE;\n    this.reconcileEveryMs = options.reconcileEveryMs ?? 15 * MINUTE;\n  }\n\n  async plan(options: { id: string; params: JourneyParams; ts: number }): Promise<ExecutionStart> {\n    const input: RunInput = {\n      type: RUN_EVENT_TYPE,\n      instanceId: options.id,\n      params: options.params,\n      // The moment the instance is created, like Cloudflare's: an event's own ts may be long past\n      enteredAtMs: this.now(),\n    };\n    return {\n      name: executionName(options.id),\n      target: await this.options.target(options.params.contentHash),\n      input: JSON.stringify(input),\n    };\n  }\n\n  async create(options: { id: string; params: unknown }): Promise<WorkflowInstanceLike> {\n    const record = await this.options.executions.get(options.id);\n    if (record === undefined) {\n      throw new Error(`no start is recorded for ${options.id}: the entry must be planned first`);\n    }\n    await this.submit(record);\n    return this.instance(options.id);\n  }\n\n  async get(id: string): Promise<WorkflowInstanceLike> {\n    // A read of the registry alone: a Lambda failure must never read as \"no such instance\"\n    if ((await this.options.executions.get(id)) === undefined) {\n      throw new InstanceNotFoundError(id);\n    }\n    return this.instance(id);\n  }\n\n  async resume(entry: { workflow: string; userId: string }): Promise<void> {\n    for (const record of await this.options.executions.pendingStarts({ ...entry, limit: 1 })) {\n      if (!(await this.giveUpIfStale(record))) await this.submit(record);\n    }\n  }\n\n  async maintain(): Promise<void> {\n    const now = this.now();\n    const failures: unknown[] = [];\n    // Starts whose submit never confirmed: retried with the recorded name and payload\n    for (const record of await this.options.executions.pendingStarts({\n      createdBefore: now - MINUTE,\n      limit: 25,\n    })) {\n      try {\n        if (!(await this.giveUpIfStale(record))) await this.submit(record);\n      } catch (error) {\n        failures.push(error);\n      }\n    }\n    // Executions the platform ended without the run finalizing (a timeout, a stop, a crash)\n    for (const record of await this.options.executions.toReconcile(\n      25,\n      now - this.reconcileEveryMs\n    )) {\n      try {\n        await this.reconcile(record, now);\n      } catch (error) {\n        failures.push(error);\n      }\n    }\n    if (failures.length > 0) throw failures[0];\n  }\n\n  private async submit(record: ExecutionRecord): Promise<void> {\n    const { arn } = await this.options.lambda.startExecution({\n      target: record.target,\n      name: record.name,\n      payload: record.input,\n    });\n    await this.options.executions.markSubmitted(record.instanceId, arn, this.now());\n  }\n\n  /** Past the retry budget a start is unresolved for good: no retry could tell a duplicate apart. */\n  private async giveUpIfStale(record: ExecutionRecord): Promise<boolean> {\n    if (this.now() - record.createdAt <= this.startRetryMs) return false;\n    await this.options.executions.markUnresolved(record.instanceId, this.now());\n    console.error(\n      `[workflow] the start of ${record.instanceId} (${record.name}) was never confirmed: left unresolved`\n    );\n    return true;\n  }\n\n  private async arnOf(record: ExecutionRecord): Promise<string | undefined> {\n    if (record.arn !== undefined) return record.arn;\n    const arn = await this.options.lambda.findExecution(record.target, record.name);\n    if (arn !== undefined) await this.options.executions.setArn(record.instanceId, arn);\n    return arn;\n  }\n\n  /**\n   * Past the start retry budget, an execution still nowhere to be seen never started: any queued\n   * invoke has expired by then. Before that, not finding it says nothing.\n   */\n  private vanished(record: ExecutionRecord): boolean {\n    return this.now() - record.createdAt > this.startRetryMs;\n  }\n\n  private async reconcile(record: ExecutionRecord, now: number): Promise<void> {\n    const arn = await this.arnOf(record);\n    const state = arn === undefined ? undefined : await this.options.lambda.executionState(arn);\n    // Only a state that will never run another step — or one missing for good — ends the entry;\n    // a run still queued, or not visible yet, is left alone\n    const ended =\n      state === 'failed' ||\n      state === 'stopped' ||\n      state === 'timed_out' ||\n      (state === undefined && this.vanished(record));\n    if (ended) {\n      // Ended without its finalize step: the ledger must not show it running forever\n      const { store } = this.options;\n      await store.setEntryStatus(record.instanceId, 'failed');\n      await store.reporting?.instanceFinished({\n        workflow: record.workflow,\n        instanceId: record.instanceId,\n        userId: record.userId,\n        status: 'failed',\n        at: now,\n      });\n      console.warn(\n        `[workflow] ${record.instanceId} ended on the platform (${state ?? 'unknown'}) without finishing: recorded as failed`\n      );\n    }\n    await this.options.executions.markChecked(record.instanceId, now);\n  }\n\n  private instance(id: string): WorkflowInstanceLike {\n    const { executions, lambda } = this.options;\n    const current = async () => {\n      const record = await executions.get(id);\n      if (record === undefined) throw new InstanceNotFoundError(id);\n      return record;\n    };\n    return {\n      id,\n      sendEvent: async (event) => {\n        // The wait parked now, read at the moment of the wake: a newer wait's callback replaces\n        // an older one, and a wake for none (the instance is between waits) is nothing to do —\n        // its next wait re-reads the facts before parking\n        const { callbackId } = await current();\n        if (callbackId === undefined) return;\n        await lambda.completeCallback(callbackId, JSON.stringify(event.payload ?? {}));\n      },\n      terminate: async () => {\n        const record = await current();\n        if (record.submittedAt === undefined && record.unresolvedAt === undefined) {\n          // No retry may start it after this\n          await executions.markUnresolved(id, this.now());\n        }\n        const arn = await this.arnOf(record);\n        if (arn === undefined) {\n          // Not visible yet is not stopped: the erasure stays pending, and the sweep retries\n          if (this.vanished(record)) return;\n          throw new Error(`cannot stop ${id} yet: its execution is not visible`);\n        }\n        if (!(await lambda.stopExecution(arn))) throw new Error(`stopping ${id} failed`);\n      },\n      status: async () => {\n        const record = await current();\n        const arn = await this.arnOf(record);\n        // Not visible yet may still run: only one missing past the budget is gone\n        if (arn === undefined) return { status: this.vanished(record) ? 'terminated' : 'running' };\n        const state = await lambda.executionState(arn);\n        // In the router's vocabulary (Cloudflare's): what will never run another step\n        if (state === 'succeeded') return { status: 'complete' };\n        if (state === 'failed') return { status: 'errored' };\n        if (state === 'running') return { status: 'running' };\n        return { status: 'terminated' };\n      },\n    };\n  }\n}\n"],"mappings":"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"}

package/dist/aws/lambda-api.cjs

@@ -0,0 +1,89 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/aws/lambda-api.ts
+const STATES = {
+	RUNNING: "running",
+	SUCCEEDED: "succeeded",
+	FAILED: "failed",
+	STOPPED: "stopped",
+	TIMED_OUT: "timed_out"
+};
+function errorName(error) {
+	return typeof error === "object" && error !== null ? String(error.name) : void 0;
+}
+const utf8 = new TextEncoder();
+const fromUtf8 = new TextDecoder();
+/** The default port, over `@aws-sdk/client-lambda` with the execution role's credentials. */
+function sdkLambdaApi(options = {}) {
+	let loaded;
+	const load = () => loaded ??= import("@aws-sdk/client-lambda").then((sdk) => ({
+		sdk,
+		client: options.client ?? new sdk.LambdaClient(options.region === void 0 ? {} : { region: options.region })
+	}));
+	const executionState = async (arn) => {
+		const { sdk, client } = await load();
+		try {
+			const response = await client.send(new sdk.GetDurableExecutionCommand({ DurableExecutionArn: arn }));
+			return response.Status === void 0 ? void 0 : STATES[response.Status];
+		} catch (error) {
+			if (errorName(error) === "ResourceNotFoundException") return void 0;
+			throw error;
+		}
+	};
+	return {
+		executionState,
+		async startExecution({ target, name, payload }) {
+			const { sdk, client } = await load();
+			const response = await client.send(new sdk.InvokeCommand({
+				FunctionName: target,
+				InvocationType: "Event",
+				DurableExecutionName: name,
+				Payload: utf8.encode(payload)
+			}));
+			if (response.FunctionError !== void 0) {
+				const detail = response.Payload === void 0 ? "" : fromUtf8.decode(response.Payload);
+				throw new Error(`starting ${name} failed: ${response.FunctionError} ${detail}`.trim());
+			}
+			return { arn: response.DurableExecutionArn };
+		},
+		async completeCallback(callbackId, result) {
+			const { sdk, client } = await load();
+			try {
+				await client.send(new sdk.SendDurableExecutionCallbackSuccessCommand({
+					CallbackId: callbackId,
+					Result: utf8.encode(result)
+				}));
+				return true;
+			} catch (error) {
+				if (errorName(error) === "CallbackTimeoutException") return false;
+				throw error;
+			}
+		},
+		async findExecution(target, name) {
+			const { sdk, client } = await load();
+			const qualifier = target.split(":").at(7);
+			const functionName = target.split(":").slice(0, 7).join(":");
+			return ((await client.send(new sdk.ListDurableExecutionsByFunctionCommand({
+				FunctionName: functionName,
+				...qualifier === void 0 ? {} : { Qualifier: qualifier },
+				DurableExecutionName: name,
+				MaxItems: 10
+			}))).DurableExecutions?.find((execution) => execution.DurableExecutionName === name))?.DurableExecutionArn;
+		},
+		async stopExecution(arn) {
+			const { sdk, client } = await load();
+			try {
+				await client.send(new sdk.StopDurableExecutionCommand({ DurableExecutionArn: arn }));
+				return true;
+			} catch (error) {
+				if (errorName(error) === "ResourceNotFoundException") return true;
+				const state = await executionState(arn).catch(() => void 0);
+				if (state !== void 0 && state !== "running") return true;
+				throw error;
+			}
+		}
+	};
+}
+//#endregion
+exports.sdkLambdaApi = sdkLambdaApi;
+
+//# sourceMappingURL=lambda-api.cjs.map

package/dist/aws/lambda-api.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"lambda-api.cjs","names":[],"sources":["../../src/aws/lambda-api.ts"],"sourcesContent":["import type * as LambdaSdk from '@aws-sdk/client-lambda';\n\n/**\n * The Lambda control-plane calls the adapter makes, as a port: starting an execution of this\n * function, completing a wake callback, and looking at or stopping an execution. The default\n * goes through `@aws-sdk/client-lambda` (loaded on first use); tests pass a fake.\n */\n\n/** A durable execution's state as the adapter reads it. */\nexport type ExecutionState = 'running' | 'succeeded' | 'failed' | 'stopped' | 'timed_out';\n\nexport interface LambdaApi {\n  /**\n   * Asynchronous (`Event`) invoke of a qualified function ARN under a durable execution name:\n   * idempotent — the same name and payload return the execution already started.\n   */\n  startExecution(input: {\n    target: string;\n    name: string;\n    payload: string;\n  }): Promise<{ arn?: string | undefined }>;\n  /**\n   * Complete a callback. `false` when it is already closed (completed, or timed out): the wait\n   * it belonged to has moved on, which a wake-up treats as nothing to do.\n   */\n  completeCallback(callbackId: string, result: string): Promise<boolean>;\n  /** The execution's state; undefined when the platform no longer knows it. */\n  executionState(arn: string): Promise<ExecutionState | undefined>;\n  /** The ARN of the execution started under `name`, if there is one. */\n  findExecution(target: string, name: string): Promise<string | undefined>;\n  /** Stop an execution for good; `true` also when it had already ended. */\n  stopExecution(arn: string): Promise<boolean>;\n}\n\nconst STATES: Record<string, ExecutionState> = {\n  RUNNING: 'running',\n  SUCCEEDED: 'succeeded',\n  FAILED: 'failed',\n  STOPPED: 'stopped',\n  TIMED_OUT: 'timed_out',\n};\n\nfunction errorName(error: unknown): string | undefined {\n  return typeof error === 'object' && error !== null\n    ? String((error as { name?: unknown }).name)\n    : undefined;\n}\n\nconst utf8 = new TextEncoder();\nconst fromUtf8 = new TextDecoder();\n\ntype Sdk = typeof LambdaSdk;\n\n/** The default port, over `@aws-sdk/client-lambda` with the execution role's credentials. */\nexport function sdkLambdaApi(\n  options: {\n    region?: string;\n    /** A configured client (endpoint, retries) instead of the default one. */\n    client?: Pick<InstanceType<Sdk['LambdaClient']>, 'send'>;\n  } = {}\n): LambdaApi {\n  let loaded:\n    | Promise<{ sdk: Sdk; client: Pick<InstanceType<Sdk['LambdaClient']>, 'send'> }>\n    | undefined;\n  const load = () =>\n    (loaded ??= import('@aws-sdk/client-lambda').then((sdk) => ({\n      sdk,\n      client:\n        options.client ??\n        new sdk.LambdaClient(options.region === undefined ? {} : { region: options.region }),\n    })));\n\n  const executionState = async (arn: string): Promise<ExecutionState | undefined> => {\n    const { sdk, client } = await load();\n    try {\n      const response = await client.send(\n        new sdk.GetDurableExecutionCommand({ DurableExecutionArn: arn })\n      );\n      return response.Status === undefined ? undefined : STATES[response.Status];\n    } catch (error) {\n      if (errorName(error) === 'ResourceNotFoundException') return undefined;\n      throw error;\n    }\n  };\n\n  return {\n    executionState,\n\n    async startExecution({ target, name, payload }) {\n      const { sdk, client } = await load();\n      const response = await client.send(\n        new sdk.InvokeCommand({\n          FunctionName: target,\n          InvocationType: 'Event',\n          DurableExecutionName: name,\n          Payload: utf8.encode(payload),\n        })\n      );\n      if (response.FunctionError !== undefined) {\n        const detail = response.Payload === undefined ? '' : fromUtf8.decode(response.Payload);\n        throw new Error(`starting ${name} failed: ${response.FunctionError} ${detail}`.trim());\n      }\n      return { arn: response.DurableExecutionArn };\n    },\n\n    async completeCallback(callbackId, result) {\n      const { sdk, client } = await load();\n      try {\n        await client.send(\n          new sdk.SendDurableExecutionCallbackSuccessCommand({\n            CallbackId: callbackId,\n            Result: utf8.encode(result),\n          })\n        );\n        return true;\n      } catch (error) {\n        // \"expired, or already closed\": the wait moved on. Anything else (throttling, a\n        // permission) is a real failure — it must not pass for a wait that ended\n        if (errorName(error) === 'CallbackTimeoutException') return false;\n        throw error;\n      }\n    },\n\n    async findExecution(target, name) {\n      const { sdk, client } = await load();\n      // The name is unique per function; the version is part of the target ARN\n      const qualifier = target.split(':').at(7);\n      const functionName = target.split(':').slice(0, 7).join(':');\n      const response = await client.send(\n        new sdk.ListDurableExecutionsByFunctionCommand({\n          FunctionName: functionName,\n          ...(qualifier === undefined ? {} : { Qualifier: qualifier }),\n          DurableExecutionName: name,\n          MaxItems: 10,\n        })\n      );\n      const match = response.DurableExecutions?.find(\n        (execution) => execution.DurableExecutionName === name\n      );\n      return match?.DurableExecutionArn;\n    },\n\n    async stopExecution(arn) {\n      const { sdk, client } = await load();\n      try {\n        await client.send(new sdk.StopDurableExecutionCommand({ DurableExecutionArn: arn }));\n        return true;\n      } catch (error) {\n        if (errorName(error) === 'ResourceNotFoundException') return true;\n        // Stopping one that already ended is refused: it will not run again either way\n        const state = await executionState(arn).catch(() => undefined);\n        if (state !== undefined && state !== 'running') return true;\n        throw error;\n      }\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/aws/lambda-api.d.cts

@@ -0,0 +1,43 @@
+import * as LambdaSdk from "@aws-sdk/client-lambda";
+//#region src/aws/lambda-api.d.ts
+/**
+ * The Lambda control-plane calls the adapter makes, as a port: starting an execution of this
+ * function, completing a wake callback, and looking at or stopping an execution. The default
+ * goes through `@aws-sdk/client-lambda` (loaded on first use); tests pass a fake.
+ */
+/** A durable execution's state as the adapter reads it. */
+export type ExecutionState = 'running' | 'succeeded' | 'failed' | 'stopped' | 'timed_out';
+export interface LambdaApi {
+  /**
+   * Asynchronous (`Event`) invoke of a qualified function ARN under a durable execution name:
+   * idempotent — the same name and payload return the execution already started.
+   */
+  startExecution(input: {
+    target: string;
+    name: string;
+    payload: string;
+  }): Promise<{
+    arn?: string | undefined;
+  }>;
+  /**
+   * Complete a callback. `false` when it is already closed (completed, or timed out): the wait
+   * it belonged to has moved on, which a wake-up treats as nothing to do.
+   */
+  completeCallback(callbackId: string, result: string): Promise<boolean>;
+  /** The execution's state; undefined when the platform no longer knows it. */
+  executionState(arn: string): Promise<ExecutionState | undefined>;
+  /** The ARN of the execution started under `name`, if there is one. */
+  findExecution(target: string, name: string): Promise<string | undefined>;
+  /** Stop an execution for good; `true` also when it had already ended. */
+  stopExecution(arn: string): Promise<boolean>;
+}
+type Sdk = typeof LambdaSdk;
+/** The default port, over `@aws-sdk/client-lambda` with the execution role's credentials. */
+export declare function sdkLambdaApi(options?: {
+  region?: string;
+  /** A configured client (endpoint, retries) instead of the default one. */
+  client?: Pick<InstanceType<Sdk['LambdaClient']>, 'send'>;
+}): LambdaApi;
+//#endregion
+export {};
+//# sourceMappingURL=lambda-api.d.cts.map

package/dist/aws/lambda-api.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lambda-api.d.cts","names":[],"sources":["../../src/aws/lambda-api.ts"],"mappings":";;;;;;;;YASY;iBAEK;;;;;EAKf,eAAe;IACb;IACA;IACA;MACE;IAAU;;;;;;EAKd,iBAAiB,oBAAoB,iBAAiB;;EAEtD,eAAe,cAAc,QAAQ;;EAErC,cAAc,gBAAgB,eAAe;;EAE7C,cAAc,cAAc;;KAoBzB,aAAa;;wBAGF,aACd;EACE;;EAEA,SAAS,KAAK,aAAa;IAE5B"}

package/dist/aws/lambda-api.d.mts

@@ -0,0 +1,43 @@
+import * as LambdaSdk from "@aws-sdk/client-lambda";
+//#region src/aws/lambda-api.d.ts
+/**
+ * The Lambda control-plane calls the adapter makes, as a port: starting an execution of this
+ * function, completing a wake callback, and looking at or stopping an execution. The default
+ * goes through `@aws-sdk/client-lambda` (loaded on first use); tests pass a fake.
+ */
+/** A durable execution's state as the adapter reads it. */
+export type ExecutionState = 'running' | 'succeeded' | 'failed' | 'stopped' | 'timed_out';
+export interface LambdaApi {
+  /**
+   * Asynchronous (`Event`) invoke of a qualified function ARN under a durable execution name:
+   * idempotent — the same name and payload return the execution already started.
+   */
+  startExecution(input: {
+    target: string;
+    name: string;
+    payload: string;
+  }): Promise<{
+    arn?: string | undefined;
+  }>;
+  /**
+   * Complete a callback. `false` when it is already closed (completed, or timed out): the wait
+   * it belonged to has moved on, which a wake-up treats as nothing to do.
+   */
+  completeCallback(callbackId: string, result: string): Promise<boolean>;
+  /** The execution's state; undefined when the platform no longer knows it. */
+  executionState(arn: string): Promise<ExecutionState | undefined>;
+  /** The ARN of the execution started under `name`, if there is one. */
+  findExecution(target: string, name: string): Promise<string | undefined>;
+  /** Stop an execution for good; `true` also when it had already ended. */
+  stopExecution(arn: string): Promise<boolean>;
+}
+type Sdk = typeof LambdaSdk;
+/** The default port, over `@aws-sdk/client-lambda` with the execution role's credentials. */
+export declare function sdkLambdaApi(options?: {
+  region?: string;
+  /** A configured client (endpoint, retries) instead of the default one. */
+  client?: Pick<InstanceType<Sdk['LambdaClient']>, 'send'>;
+}): LambdaApi;
+//#endregion
+export {};
+//# sourceMappingURL=lambda-api.d.mts.map

package/dist/aws/lambda-api.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lambda-api.d.mts","names":[],"sources":["../../src/aws/lambda-api.ts"],"mappings":";;;;;;;;YASY;iBAEK;;;;;EAKf,eAAe;IACb;IACA;IACA;MACE;IAAU;;;;;;EAKd,iBAAiB,oBAAoB,iBAAiB;;EAEtD,eAAe,cAAc,QAAQ;;EAErC,cAAc,gBAAgB,eAAe;;EAE7C,cAAc,cAAc;;KAoBzB,aAAa;;wBAGF,aACd;EACE;;EAEA,SAAS,KAAK,aAAa;IAE5B"}

package/dist/aws/lambda-api.mjs

@@ -0,0 +1,88 @@
+//#region src/aws/lambda-api.ts
+const STATES = {
+	RUNNING: "running",
+	SUCCEEDED: "succeeded",
+	FAILED: "failed",
+	STOPPED: "stopped",
+	TIMED_OUT: "timed_out"
+};
+function errorName(error) {
+	return typeof error === "object" && error !== null ? String(error.name) : void 0;
+}
+const utf8 = new TextEncoder();
+const fromUtf8 = new TextDecoder();
+/** The default port, over `@aws-sdk/client-lambda` with the execution role's credentials. */
+function sdkLambdaApi(options = {}) {
+	let loaded;
+	const load = () => loaded ??= import("@aws-sdk/client-lambda").then((sdk) => ({
+		sdk,
+		client: options.client ?? new sdk.LambdaClient(options.region === void 0 ? {} : { region: options.region })
+	}));
+	const executionState = async (arn) => {
+		const { sdk, client } = await load();
+		try {
+			const response = await client.send(new sdk.GetDurableExecutionCommand({ DurableExecutionArn: arn }));
+			return response.Status === void 0 ? void 0 : STATES[response.Status];
+		} catch (error) {
+			if (errorName(error) === "ResourceNotFoundException") return void 0;
+			throw error;
+		}
+	};
+	return {
+		executionState,
+		async startExecution({ target, name, payload }) {
+			const { sdk, client } = await load();
+			const response = await client.send(new sdk.InvokeCommand({
+				FunctionName: target,
+				InvocationType: "Event",
+				DurableExecutionName: name,
+				Payload: utf8.encode(payload)
+			}));
+			if (response.FunctionError !== void 0) {
+				const detail = response.Payload === void 0 ? "" : fromUtf8.decode(response.Payload);
+				throw new Error(`starting ${name} failed: ${response.FunctionError} ${detail}`.trim());
+			}
+			return { arn: response.DurableExecutionArn };
+		},
+		async completeCallback(callbackId, result) {
+			const { sdk, client } = await load();
+			try {
+				await client.send(new sdk.SendDurableExecutionCallbackSuccessCommand({
+					CallbackId: callbackId,
+					Result: utf8.encode(result)
+				}));
+				return true;
+			} catch (error) {
+				if (errorName(error) === "CallbackTimeoutException") return false;
+				throw error;
+			}
+		},
+		async findExecution(target, name) {
+			const { sdk, client } = await load();
+			const qualifier = target.split(":").at(7);
+			const functionName = target.split(":").slice(0, 7).join(":");
+			return ((await client.send(new sdk.ListDurableExecutionsByFunctionCommand({
+				FunctionName: functionName,
+				...qualifier === void 0 ? {} : { Qualifier: qualifier },
+				DurableExecutionName: name,
+				MaxItems: 10
+			}))).DurableExecutions?.find((execution) => execution.DurableExecutionName === name))?.DurableExecutionArn;
+		},
+		async stopExecution(arn) {
+			const { sdk, client } = await load();
+			try {
+				await client.send(new sdk.StopDurableExecutionCommand({ DurableExecutionArn: arn }));
+				return true;
+			} catch (error) {
+				if (errorName(error) === "ResourceNotFoundException") return true;
+				const state = await executionState(arn).catch(() => void 0);
+				if (state !== void 0 && state !== "running") return true;
+				throw error;
+			}
+		}
+	};
+}
+//#endregion
+export { sdkLambdaApi };
+
+//# sourceMappingURL=lambda-api.mjs.map

package/dist/aws/lambda-api.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"lambda-api.mjs","names":[],"sources":["../../src/aws/lambda-api.ts"],"sourcesContent":["import type * as LambdaSdk from '@aws-sdk/client-lambda';\n\n/**\n * The Lambda control-plane calls the adapter makes, as a port: starting an execution of this\n * function, completing a wake callback, and looking at or stopping an execution. The default\n * goes through `@aws-sdk/client-lambda` (loaded on first use); tests pass a fake.\n */\n\n/** A durable execution's state as the adapter reads it. */\nexport type ExecutionState = 'running' | 'succeeded' | 'failed' | 'stopped' | 'timed_out';\n\nexport interface LambdaApi {\n  /**\n   * Asynchronous (`Event`) invoke of a qualified function ARN under a durable execution name:\n   * idempotent — the same name and payload return the execution already started.\n   */\n  startExecution(input: {\n    target: string;\n    name: string;\n    payload: string;\n  }): Promise<{ arn?: string | undefined }>;\n  /**\n   * Complete a callback. `false` when it is already closed (completed, or timed out): the wait\n   * it belonged to has moved on, which a wake-up treats as nothing to do.\n   */\n  completeCallback(callbackId: string, result: string): Promise<boolean>;\n  /** The execution's state; undefined when the platform no longer knows it. */\n  executionState(arn: string): Promise<ExecutionState | undefined>;\n  /** The ARN of the execution started under `name`, if there is one. */\n  findExecution(target: string, name: string): Promise<string | undefined>;\n  /** Stop an execution for good; `true` also when it had already ended. */\n  stopExecution(arn: string): Promise<boolean>;\n}\n\nconst STATES: Record<string, ExecutionState> = {\n  RUNNING: 'running',\n  SUCCEEDED: 'succeeded',\n  FAILED: 'failed',\n  STOPPED: 'stopped',\n  TIMED_OUT: 'timed_out',\n};\n\nfunction errorName(error: unknown): string | undefined {\n  return typeof error === 'object' && error !== null\n    ? String((error as { name?: unknown }).name)\n    : undefined;\n}\n\nconst utf8 = new TextEncoder();\nconst fromUtf8 = new TextDecoder();\n\ntype Sdk = typeof LambdaSdk;\n\n/** The default port, over `@aws-sdk/client-lambda` with the execution role's credentials. */\nexport function sdkLambdaApi(\n  options: {\n    region?: string;\n    /** A configured client (endpoint, retries) instead of the default one. */\n    client?: Pick<InstanceType<Sdk['LambdaClient']>, 'send'>;\n  } = {}\n): LambdaApi {\n  let loaded:\n    | Promise<{ sdk: Sdk; client: Pick<InstanceType<Sdk['LambdaClient']>, 'send'> }>\n    | undefined;\n  const load = () =>\n    (loaded ??= import('@aws-sdk/client-lambda').then((sdk) => ({\n      sdk,\n      client:\n        options.client ??\n        new sdk.LambdaClient(options.region === undefined ? {} : { region: options.region }),\n    })));\n\n  const executionState = async (arn: string): Promise<ExecutionState | undefined> => {\n    const { sdk, client } = await load();\n    try {\n      const response = await client.send(\n        new sdk.GetDurableExecutionCommand({ DurableExecutionArn: arn })\n      );\n      return response.Status === undefined ? undefined : STATES[response.Status];\n    } catch (error) {\n      if (errorName(error) === 'ResourceNotFoundException') return undefined;\n      throw error;\n    }\n  };\n\n  return {\n    executionState,\n\n    async startExecution({ target, name, payload }) {\n      const { sdk, client } = await load();\n      const response = await client.send(\n        new sdk.InvokeCommand({\n          FunctionName: target,\n          InvocationType: 'Event',\n          DurableExecutionName: name,\n          Payload: utf8.encode(payload),\n        })\n      );\n      if (response.FunctionError !== undefined) {\n        const detail = response.Payload === undefined ? '' : fromUtf8.decode(response.Payload);\n        throw new Error(`starting ${name} failed: ${response.FunctionError} ${detail}`.trim());\n      }\n      return { arn: response.DurableExecutionArn };\n    },\n\n    async completeCallback(callbackId, result) {\n      const { sdk, client } = await load();\n      try {\n        await client.send(\n          new sdk.SendDurableExecutionCallbackSuccessCommand({\n            CallbackId: callbackId,\n            Result: utf8.encode(result),\n          })\n        );\n        return true;\n      } catch (error) {\n        // \"expired, or already closed\": the wait moved on. Anything else (throttling, a\n        // permission) is a real failure — it must not pass for a wait that ended\n        if (errorName(error) === 'CallbackTimeoutException') return false;\n        throw error;\n      }\n    },\n\n    async findExecution(target, name) {\n      const { sdk, client } = await load();\n      // The name is unique per function; the version is part of the target ARN\n      const qualifier = target.split(':').at(7);\n      const functionName = target.split(':').slice(0, 7).join(':');\n      const response = await client.send(\n        new sdk.ListDurableExecutionsByFunctionCommand({\n          FunctionName: functionName,\n          ...(qualifier === undefined ? {} : { Qualifier: qualifier }),\n          DurableExecutionName: name,\n          MaxItems: 10,\n        })\n      );\n      const match = response.DurableExecutions?.find(\n        (execution) => execution.DurableExecutionName === name\n      );\n      return match?.DurableExecutionArn;\n    },\n\n    async stopExecution(arn) {\n      const { sdk, client } = await load();\n      try {\n        await client.send(new sdk.StopDurableExecutionCommand({ DurableExecutionArn: arn }));\n        return true;\n      } catch (error) {\n        if (errorName(error) === 'ResourceNotFoundException') return true;\n        // Stopping one that already ended is refused: it will not run again either way\n        const state = await executionState(arn).catch(() => undefined);\n        if (state !== undefined && state !== 'running') return true;\n        throw error;\n      }\n    },\n  };\n}\n"],"mappings":";AAkCA,MAAM,SAAyC;CAC7C,SAAS;CACT,WAAW;CACX,QAAQ;CACR,SAAS;CACT,WAAW;AACb;AAEA,SAAS,UAAU,OAAoC;CACrD,OAAO,OAAO,UAAU,YAAY,UAAU,OAC1C,OAAQ,MAA6B,IAAI,IACzC,KAAA;AACN;AAEA,MAAM,OAAO,IAAI,YAAY;AAC7B,MAAM,WAAW,IAAI,YAAY;;AAKjC,SAAgB,aACd,UAII,CAAC,GACM;CACX,IAAI;CAGJ,MAAM,aACH,WAAW,OAAO,yBAAyB,CAAC,MAAM,SAAS;EAC1D;EACA,QACE,QAAQ,UACR,IAAI,IAAI,aAAa,QAAQ,WAAW,KAAA,IAAY,CAAC,IAAI,EAAE,QAAQ,QAAQ,OAAO,CAAC;CACvF,EAAE;CAEJ,MAAM,iBAAiB,OAAO,QAAqD;EACjF,MAAM,EAAE,KAAK,WAAW,MAAM,KAAK;EACnC,IAAI;GACF,MAAM,WAAW,MAAM,OAAO,KAC5B,IAAI,IAAI,2BAA2B,EAAE,qBAAqB,IAAI,CAAC,CACjE;GACA,OAAO,SAAS,WAAW,KAAA,IAAY,KAAA,IAAY,OAAO,SAAS;EACrE,SAAS,OAAO;GACd,IAAI,UAAU,KAAK,MAAM,6BAA6B,OAAO,KAAA;GAC7D,MAAM;EACR;CACF;CAEA,OAAO;EACL;EAEA,MAAM,eAAe,EAAE,QAAQ,MAAM,WAAW;GAC9C,MAAM,EAAE,KAAK,WAAW,MAAM,KAAK;GACnC,MAAM,WAAW,MAAM,OAAO,KAC5B,IAAI,IAAI,cAAc;IACpB,cAAc;IACd,gBAAgB;IAChB,sBAAsB;IACtB,SAAS,KAAK,OAAO,OAAO;GAC9B,CAAC,CACH;GACA,IAAI,SAAS,kBAAkB,KAAA,GAAW;IACxC,MAAM,SAAS,SAAS,YAAY,KAAA,IAAY,KAAK,SAAS,OAAO,SAAS,OAAO;IACrF,MAAM,IAAI,MAAM,YAAY,KAAK,WAAW,SAAS,cAAc,GAAG,SAAS,KAAK,CAAC;GACvF;GACA,OAAO,EAAE,KAAK,SAAS,oBAAoB;EAC7C;EAEA,MAAM,iBAAiB,YAAY,QAAQ;GACzC,MAAM,EAAE,KAAK,WAAW,MAAM,KAAK;GACnC,IAAI;IACF,MAAM,OAAO,KACX,IAAI,IAAI,2CAA2C;KACjD,YAAY;KACZ,QAAQ,KAAK,OAAO,MAAM;IAC5B,CAAC,CACH;IACA,OAAO;GACT,SAAS,OAAO;IAGd,IAAI,UAAU,KAAK,MAAM,4BAA4B,OAAO;IAC5D,MAAM;GACR;EACF;EAEA,MAAM,cAAc,QAAQ,MAAM;GAChC,MAAM,EAAE,KAAK,WAAW,MAAM,KAAK;GAEnC,MAAM,YAAY,OAAO,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC;GACxC,MAAM,eAAe,OAAO,MAAM,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG;GAY3D,SAHc,MARS,OAAO,KAC5B,IAAI,IAAI,uCAAuC;IAC7C,cAAc;IACd,GAAI,cAAc,KAAA,IAAY,CAAC,IAAI,EAAE,WAAW,UAAU;IAC1D,sBAAsB;IACtB,UAAU;GACZ,CAAC,CACH,EAAA,CACuB,mBAAmB,MACvC,cAAc,UAAU,yBAAyB,IACpD,EAAA,EACc;EAChB;EAEA,MAAM,cAAc,KAAK;GACvB,MAAM,EAAE,KAAK,WAAW,MAAM,KAAK;GACnC,IAAI;IACF,MAAM,OAAO,KAAK,IAAI,IAAI,4BAA4B,EAAE,qBAAqB,IAAI,CAAC,CAAC;IACnF,OAAO;GACT,SAAS,OAAO;IACd,IAAI,UAAU,KAAK,MAAM,6BAA6B,OAAO;IAE7D,MAAM,QAAQ,MAAM,eAAe,GAAG,CAAC,CAAC,YAAY,KAAA,CAAS;IAC7D,IAAI,UAAU,KAAA,KAAa,UAAU,WAAW,OAAO;IACvD,MAAM;GACR;EACF;CACF;AACF"}

package/dist/client.d.cts

@@ -1,6 +1,6 @@
 import { ProfileProps } from "./store/index.cjs";
 import { Contract, ContractIssue, ProfilePatch } from "./contract.cjs";
-import { DeployResult, IdentifyResult, IngestResult } from "./cloudflare/router.cjs";
+import { DeployResult, IdentifyResult, IngestResult } from "./host/router.cjs";
 import "./cloudflare/index.cjs";
 import * as core from "zod/v4/core";
 //#region src/client.d.ts

package/dist/client.d.mts

@@ -1,6 +1,6 @@
 import { ProfileProps } from "./store/index.mjs";
 import { Contract, ContractIssue, ProfilePatch } from "./contract.mjs";
-import { DeployResult, IdentifyResult, IngestResult } from "./cloudflare/router.mjs";
+import { DeployResult, IdentifyResult, IngestResult } from "./host/router.mjs";
 import "./cloudflare/index.mjs";
 import * as core from "zod/v4/core";
 //#region src/client.d.ts

package/dist/cloudflare/bindings.cjs

@@ -1,5 +1,22 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 //#region src/cloudflare/bindings.ts
+/** The runtime does not know the instance: the only failure that lets the router drop its wakes. */
+var InstanceNotFoundError = class extends Error {
+	instanceId;
+	name = "InstanceNotFoundError";
+	constructor(instanceId) {
+		super(`no such instance: ${instanceId}`);
+		this.instanceId = instanceId;
+	}
+};
+/**
+* Does this lookup failure say the instance is gone, rather than that the lookup failed?
+* Cloudflare reports an unknown id as `instance.not_found`.
+*/
+function isInstanceNotFound(error) {
+	if (error instanceof InstanceNotFoundError) return true;
+	return /not[_ ]found|no such instance/i.test(String(error));
+}
 /** The event type the router uses to wake waiting instances (sendEvent's `type`). */
 const WAKE_EVENT_TYPE = "wake";
 /**
@@ -21,8 +38,10 @@ function wakeExpired(startedAt, timeoutMs, now) {
 	return now - startedAt >= Math.max(0, timeoutMs - WAKE_TIMEOUT_TOLERANCE_MS);
 }
 //#endregion
+exports.InstanceNotFoundError = InstanceNotFoundError;
 exports.WAKE_EVENT_TYPE = WAKE_EVENT_TYPE;
 exports.WAKE_TIMEOUT_TOLERANCE_MS = WAKE_TIMEOUT_TOLERANCE_MS;
+exports.isInstanceNotFound = isInstanceNotFound;
 exports.wakeExpired = wakeExpired;
 
 //# sourceMappingURL=bindings.cjs.map

package/dist/cloudflare/bindings.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"bindings.cjs","names":[],"sources":["../../src/cloudflare/bindings.ts"],"sourcesContent":["import type { EmailAddress } from '../email';\n\n/**\n * A minimal structural interface over the Cloudflare bindings.\n *\n * @cloudflare/workers-types is deliberately not used: the global types it\n * injects clash with the DOM lib this package's react side needs. A structural\n * subset plus the ambient cloudflare:workers declaration is enough to compile,\n * and the real bindings satisfy it structurally at runtime.\n */\n\nexport interface KVNamespaceLike {\n  get(key: string): Promise<string | null>;\n  put(key: string, value: string): Promise<void>;\n}\n\n/** Structural subset of D1Result: `meta.changes` is how INSERT OR IGNORE reports whether it inserted. */\nexport interface D1RunResultLike {\n  meta?: { changes?: number };\n}\n\nexport interface D1PreparedStatementLike {\n  bind(...values: unknown[]): D1PreparedStatementLike;\n  first<T = Record<string, unknown>>(): Promise<T | null>;\n  all<T = Record<string, unknown>>(): Promise<{ results: T[] }>;\n  run(): Promise<D1RunResultLike>;\n}\n\nexport interface D1DatabaseLike {\n  prepare(sql: string): D1PreparedStatementLike;\n  /** Statements run in order inside one transaction (real D1 semantics) — deploy relies on the atomicity. */\n  batch(statements: D1PreparedStatementLike[]): Promise<unknown>;\n}\n\nexport interface WorkflowInstanceLike {\n  id: string;\n  sendEvent(event: { type: string; payload?: unknown }): Promise<void>;\n  /** Stop the instance for good (Cloudflare Workflows' `terminate`). */\n  terminate?(): Promise<void>;\n  /** Where it stands (`complete`, `errored`, `terminated`, `running`, …). */\n  status?(): Promise<{ status: string }>;\n}\n\nexport interface WorkflowBindingLike {\n  create(options: { id: string; params: unknown }): Promise<WorkflowInstanceLike>;\n  get(id: string): Promise<WorkflowInstanceLike>;\n}\n\n/**\n * Cloudflare Email Service's send_email binding (structural subset).\n *\n * `idempotencyKey` is part of the call because the send happens inside a\n * `step.do`: a step body re-runs after its fn resolved but before the\n * checkpoint committed, so a binding that drops the key mails the user twice.\n * The binding is app-supplied glue (nothing here can de-duplicate — there is\n * no state between two runs of the same step), which is why the port makes the\n * key impossible to miss rather than merely available.\n */\nexport interface EmailBindingLike {\n  send(message: {\n    from: EmailAddress;\n    to: EmailAddress;\n    replyTo?: EmailAddress;\n    subject: string;\n    html: string;\n    /** `${instanceId}:${nodeId}`: stable across replays and retries — drop a send whose key was already delivered. */\n    idempotencyKey: string;\n  }): Promise<unknown>;\n}\n\n/** Every binding the journey engine needs (names match the wrangler config). */\nexport interface JourneyEnv {\n  /**\n   * BundleIR storage for the default D1 store (`wf:${contentHash}` → WorkflowIR JSON). Optional:\n   * a Worker on another JourneyStore (Postgres, say) does not declare it.\n   */\n  WORKFLOW_KV?: KVNamespaceLike;\n  /** Tables of the default D1 store (events / profiles / segments / triggers / entries / subscriptions). Optional, as above. */\n  DB?: D1DatabaseLike;\n  /** JourneyRunner's workflow binding (creating instances and waking them). */\n  JOURNEY: WorkflowBindingLike;\n  /** Optional message-delivery webhook (defaults to the console logging sender). */\n  MESSAGE_WEBHOOK_URL?: string;\n  /**\n   * Bearer token required on every mutating HTTP endpoint (`Authorization:\n   * Bearer <token>`). Unset = open — acceptable only for local dev; /deploy in\n   * particular rewrites the whole routing table, so production must set this.\n   */\n  API_TOKEN?: string;\n  /**\n   * This Worker's public origin. With a store that keeps reporting (Postgres), journey emails'\n   * links and open pixel point at its `/t/...` routes; without it emails go out untracked.\n   */\n  WORKFLOW_ORIGIN?: string;\n  /** Which `workflow.config.ts` entry applies (`development`, `production`, …); production when unset. */\n  ENVIRONMENT?: string;\n  /** Cloudflare Email Sending, when the config has `emails`. */\n  EMAIL?: EmailBindingLike;\n  /** The APNs auth key (`.p8`, base64) named by the config's `apns.keyId`. */\n  APNS_PRIVATE_KEY_BASE64?: string;\n  /** The Firebase service account (base64 JSON) the config's `fcm` sends with. */\n  GOOGLE_APPLICATION_CREDENTIALS_BASE64?: string;\n  /** The VAPID key pair web pushes are signed with (`generateVapidKeys`); the config's `webPush` turns the channel on. */\n  VAPID_PUBLIC_KEY?: string;\n  VAPID_PRIVATE_KEY?: string;\n  /**\n   * Cloudflare's version metadata binding (wrangler `\"version_metadata\": { \"binding\":\n   * \"CF_VERSION_METADATA\" }`). With it, and a store that records the live version (Postgres),\n   * journeyWorker makes the bundle compiled into each new version live by itself: `wrangler\n   * deploy` is the whole deploy.\n   */\n  CF_VERSION_METADATA?: { id: string; tag?: string; timestamp: string };\n  /** Development only: the HTTP/2 relay `wrangler dev` sends APNs requests through (see `@shware/workflow/apns-relay`). */\n  APNS_RELAY_ORIGIN?: string;\n}\n\n/** The event type the router uses to wake waiting instances (sendEvent's `type`). */\nexport const WAKE_EVENT_TYPE = 'wake';\n\n/** Journey instance parameters, passed by the ingest router when it creates one. */\nexport interface JourneyParams {\n  workflowId: string;\n  /** The IR version pinned at entry. */\n  contentHash: string;\n  userId: string;\n  trigger: { event: string; payload: Record<string, unknown> };\n  [key: string]: unknown;\n}\n\n/**\n * Slack on the deadline when deciding whether a thrown wait was a timeout: the\n * platform may surface the expiry a moment early, and a wait shorter than this\n * has no room to tell the two apart anyway.\n */\nexport const WAKE_TIMEOUT_TOLERANCE_MS = 5_000;\n\n/**\n * Did a wait that threw actually reach its deadline?\n *\n * CF signals a wait timeout by throwing, and so does every other failure in\n * there — a broken binding, an evicted instance, a malformed timeout. The\n * adapter used to read them all as timeouts, which made an infrastructure\n * fault indistinguishable from \"the user never did it\": the journey took its\n * onTimeout branch, early and silently. Only the clock can tell them apart.\n */\nexport function wakeExpired(startedAt: number, timeoutMs: number, now: number): boolean {\n  return now - startedAt >= Math.max(0, timeoutMs - WAKE_TIMEOUT_TOLERANCE_MS);\n}\n"],"mappings":";;;AAqHA,MAAa,kBAAkB;;;;;;AAiB/B,MAAa,4BAA4B;;;;;;;;;;AAWzC,SAAgB,YAAY,WAAmB,WAAmB,KAAsB;CACtF,OAAO,MAAM,aAAa,KAAK,IAAI,GAAG,YAAY,yBAAyB;AAC7E"}
+{"version":3,"file":"bindings.cjs","names":[],"sources":["../../src/cloudflare/bindings.ts"],"sourcesContent":["import type { EmailAddress } from '../email';\nimport type { ExecutionStart } from '../store/index';\n\n/**\n * A minimal structural interface over the Cloudflare bindings.\n *\n * @cloudflare/workers-types is deliberately not used: the global types it\n * injects clash with the DOM lib this package's react side needs. A structural\n * subset plus the ambient cloudflare:workers declaration is enough to compile,\n * and the real bindings satisfy it structurally at runtime.\n */\n\nexport interface KVNamespaceLike {\n  get(key: string): Promise<string | null>;\n  put(key: string, value: string): Promise<void>;\n}\n\n/** Structural subset of D1Result: `meta.changes` is how INSERT OR IGNORE reports whether it inserted. */\nexport interface D1RunResultLike {\n  meta?: { changes?: number };\n}\n\nexport interface D1PreparedStatementLike {\n  bind(...values: unknown[]): D1PreparedStatementLike;\n  first<T = Record<string, unknown>>(): Promise<T | null>;\n  all<T = Record<string, unknown>>(): Promise<{ results: T[] }>;\n  run(): Promise<D1RunResultLike>;\n}\n\nexport interface D1DatabaseLike {\n  prepare(sql: string): D1PreparedStatementLike;\n  /** Statements run in order inside one transaction (real D1 semantics) — deploy relies on the atomicity. */\n  batch(statements: D1PreparedStatementLike[]): Promise<unknown>;\n}\n\nexport interface WorkflowInstanceLike {\n  id: string;\n  sendEvent(event: { type: string; payload?: unknown }): Promise<void>;\n  /** Stop the instance for good (Cloudflare Workflows' `terminate`). */\n  terminate?(): Promise<void>;\n  /** Where it stands (`complete`, `errored`, `terminated`, `running`, …). */\n  status?(): Promise<{ status: string }>;\n}\n\n/**\n * How the router starts, wakes and stops instances: Cloudflare's workflow binding, or the AWS\n * adapter's equivalent over durable executions.\n */\nexport interface WorkflowBindingLike {\n  create(options: { id: string; params: unknown }): Promise<WorkflowInstanceLike>;\n  get(id: string): Promise<WorkflowInstanceLike>;\n  /**\n   * For a runtime whose start is a submit that can be lost in flight (AWS): the start to record\n   * with the entry, in one transaction. A failed `create` then keeps the entry — its recorded\n   * start is retried by the next ingest for the pair (`resume`) or by maintenance, never rolled\n   * back and re-entered as a second execution.\n   */\n  plan?(options: { id: string; params: JourneyParams; ts: number }): Promise<ExecutionStart>;\n  /** Retry the recorded, unconfirmed start of the (workflow, user) entry still running, if any. */\n  resume?(entry: { workflow: string; userId: string }): Promise<void>;\n  /**\n   * Maintenance the sweep runs first: old unconfirmed starts retried (or given up on), and\n   * executions the platform ended on its own (timeout, stop, crash) reconciled into the ledger.\n   */\n  maintain?(): Promise<void>;\n}\n\n/**\n * Cloudflare Email Service's send_email binding (structural subset).\n *\n * `idempotencyKey` is part of the call because the send happens inside a\n * `step.do`: a step body re-runs after its fn resolved but before the\n * checkpoint committed, so a binding that drops the key mails the user twice.\n * The binding is app-supplied glue (nothing here can de-duplicate — there is\n * no state between two runs of the same step), which is why the port makes the\n * key impossible to miss rather than merely available.\n */\nexport interface EmailBindingLike {\n  send(message: {\n    from: EmailAddress;\n    to: EmailAddress;\n    replyTo?: EmailAddress;\n    subject: string;\n    html: string;\n    /** `${instanceId}:${nodeId}`: stable across replays and retries — drop a send whose key was already delivered. */\n    idempotencyKey: string;\n  }): Promise<unknown>;\n}\n\n/** Every binding the journey engine needs (names match the wrangler config). */\nexport interface JourneyEnv {\n  /**\n   * BundleIR storage for the default D1 store (`wf:${contentHash}` → WorkflowIR JSON). Optional:\n   * a Worker on another JourneyStore (Postgres, say) does not declare it.\n   */\n  WORKFLOW_KV?: KVNamespaceLike;\n  /** Tables of the default D1 store (events / profiles / segments / triggers / entries / subscriptions). Optional, as above. */\n  DB?: D1DatabaseLike;\n  /** JourneyRunner's workflow binding (creating instances and waking them). */\n  JOURNEY: WorkflowBindingLike;\n  /** Optional message-delivery webhook (defaults to the console logging sender). */\n  MESSAGE_WEBHOOK_URL?: string;\n  /**\n   * Bearer token required on every mutating HTTP endpoint (`Authorization:\n   * Bearer <token>`). Unset = open — acceptable only for local dev; /deploy in\n   * particular rewrites the whole routing table, so production must set this.\n   */\n  API_TOKEN?: string;\n  /**\n   * This Worker's public origin. With a store that keeps reporting (Postgres), journey emails'\n   * links and open pixel point at its `/t/...` routes; without it emails go out untracked.\n   */\n  WORKFLOW_ORIGIN?: string;\n  /** Which `workflow.config.ts` entry applies (`development`, `production`, …); production when unset. */\n  ENVIRONMENT?: string;\n  /** Cloudflare Email Sending, when the config has `emails`. */\n  EMAIL?: EmailBindingLike;\n  /** The APNs auth key (`.p8`, base64) named by the config's `apns.keyId`. */\n  APNS_PRIVATE_KEY_BASE64?: string;\n  /** The Firebase service account (base64 JSON) the config's `fcm` sends with. */\n  GOOGLE_APPLICATION_CREDENTIALS_BASE64?: string;\n  /** The VAPID key pair web pushes are signed with (`generateVapidKeys`); the config's `webPush` turns the channel on. */\n  VAPID_PUBLIC_KEY?: string;\n  VAPID_PRIVATE_KEY?: string;\n  /**\n   * Cloudflare's version metadata binding (wrangler `\"version_metadata\": { \"binding\":\n   * \"CF_VERSION_METADATA\" }`). With it, and a store that records the live version (Postgres),\n   * journeyWorker makes the bundle compiled into each new version live by itself: `wrangler\n   * deploy` is the whole deploy.\n   */\n  CF_VERSION_METADATA?: { id: string; tag?: string; timestamp: string };\n  /** Development only: the HTTP/2 relay `wrangler dev` sends APNs requests through (see `@shware/workflow/apns-relay`). */\n  APNS_RELAY_ORIGIN?: string;\n}\n\n/** The runtime does not know the instance: the only failure that lets the router drop its wakes. */\nexport class InstanceNotFoundError extends Error {\n  override readonly name = 'InstanceNotFoundError';\n  constructor(readonly instanceId: string) {\n    super(`no such instance: ${instanceId}`);\n  }\n}\n\n/**\n * Does this lookup failure say the instance is gone, rather than that the lookup failed?\n * Cloudflare reports an unknown id as `instance.not_found`.\n */\nexport function isInstanceNotFound(error: unknown): boolean {\n  if (error instanceof InstanceNotFoundError) return true;\n  return /not[_ ]found|no such instance/i.test(String(error));\n}\n\n/** The event type the router uses to wake waiting instances (sendEvent's `type`). */\nexport const WAKE_EVENT_TYPE = 'wake';\n\n/** Journey instance parameters, passed by the ingest router when it creates one. */\nexport interface JourneyParams {\n  workflowId: string;\n  /** The IR version pinned at entry. */\n  contentHash: string;\n  userId: string;\n  trigger: { event: string; payload: Record<string, unknown> };\n  [key: string]: unknown;\n}\n\n/**\n * Slack on the deadline when deciding whether a thrown wait was a timeout: the\n * platform may surface the expiry a moment early, and a wait shorter than this\n * has no room to tell the two apart anyway.\n */\nexport const WAKE_TIMEOUT_TOLERANCE_MS = 5_000;\n\n/**\n * Did a wait that threw actually reach its deadline?\n *\n * CF signals a wait timeout by throwing, and so does every other failure in\n * there — a broken binding, an evicted instance, a malformed timeout. The\n * adapter used to read them all as timeouts, which made an infrastructure\n * fault indistinguishable from \"the user never did it\": the journey took its\n * onTimeout branch, early and silently. Only the clock can tell them apart.\n */\nexport function wakeExpired(startedAt: number, timeoutMs: number, now: number): boolean {\n  return now - startedAt >= Math.max(0, timeoutMs - WAKE_TIMEOUT_TOLERANCE_MS);\n}\n"],"mappings":";;;AAwIA,IAAa,wBAAb,cAA2C,MAAM;CAE1B;CADrB,OAAyB;CACzB,YAAY,YAA6B;EACvC,MAAM,qBAAqB,YAAY;EADpB,KAAA,aAAA;CAErB;AACF;;;;;AAMA,SAAgB,mBAAmB,OAAyB;CAC1D,IAAI,iBAAiB,uBAAuB,OAAO;CACnD,OAAO,iCAAiC,KAAK,OAAO,KAAK,CAAC;AAC5D;;AAGA,MAAa,kBAAkB;;;;;;AAiB/B,MAAa,4BAA4B;;;;;;;;;;AAWzC,SAAgB,YAAY,WAAmB,WAAmB,KAAsB;CACtF,OAAO,MAAM,aAAa,KAAK,IAAI,GAAG,YAAY,yBAAyB;AAC7E"}