@temporal-contract/worker 2.0.0 → 2.1.0

package/dist/workflow.mjs

@@ -1,6 +1,6 @@
-import { _ as formatChildWorkflowValidationMessage, a as ActivityInputValidationError, c as ChildWorkflowNotFoundError, d as SignalInputValidationError, f as UpdateInputValidationError, g as WorkflowOutputValidationError, h as WorkflowInputValidationError, l as QueryInputValidationError, m as WorkflowCancelledError, n as createContinueAsNew, o as ActivityOutputValidationError, p as UpdateOutputValidationError, r as extractHandlerInput, s as ChildWorkflowError, t as buildRawActivitiesProxy, u as QueryOutputValidationError } from "./internal--45IXCxX.mjs";
+import { _ as UpdateOutputValidationError, a as formatChildWorkflowValidationMessage, b as WorkflowOutputValidationError, c as ActivityInputValidationError, d as ChildWorkflowError, f as ChildWorkflowNotFoundError, g as UpdateInputValidationError, h as SignalInputValidationError, i as extractHandlerInput, l as ActivityOutputValidationError, m as QueryOutputValidationError, n as classifyChildWorkflowError, o as makeResultAsync, p as QueryInputValidationError, r as createContinueAsNew, t as buildRawActivitiesProxy, u as ChildWorkflowCancelledError, v as WorkflowCancelledError, x as WorkflowScopeError, y as WorkflowInputValidationError } from "./internal-BzG1KhEK.mjs";
 import { CancellationScope, defineQuery, defineSignal, defineUpdate, executeChild, isCancellation, setHandler, startChild, workflowInfo } from "@temporalio/workflow";
-import { ResultAsync, err, ok } from "neverthrow";
+import { err, ok } from "neverthrow";
 //#region src/cancellation.ts
 /**
 * Typed wrappers around Temporal's `CancellationScope` so workflows can
@@ -10,9 +10,11 @@ import { ResultAsync, err, ok } from "neverthrow";
 * context — callers branch on `err(WorkflowCancelledError)` instead of
 * catching `CancelledFailure`.
 *
-* Non-cancellation errors thrown inside the scope are *not* swallowed:
-* the ResultAsync rejects with the original error so user-domain failures
-* keep their identity.
+* Non-cancellation errors thrown inside the scope are wrapped in a
+* {@link WorkflowScopeError} (with the original error preserved on
+* `cause`) and surfaced on the same `err(...)` channel. Together with
+* `WorkflowCancelledError` this makes the failure modes exhaustive on
+* `result.match(...)` — nothing escapes as an unhandled rejection.
 */
 /**
 * Run `fn` inside a cancellable Temporal scope. If the workflow (or an
@@ -21,6 +23,11 @@ import { ResultAsync, err, ok } from "neverthrow";
 * letting callers handle cancellation explicitly — typically to perform
 * a graceful exit from the current step.
 *
+* Non-cancellation errors thrown by `fn` resolve to
+* `err(WorkflowScopeError)` (with the original error on `cause`) so
+* domain failures surface on the same typed error channel rather than
+* leaking as unhandled rejections.
+*
 * @example
 * ```ts
 * const result = await context.cancellableScope(async () => {
@@ -29,8 +36,12 @@ import { ResultAsync, err, ok } from "neverthrow";
 *
 * result.match(
 *   (output) => { ... },
-*   (cancelled) => {
-*     // cancelled instanceof WorkflowCancelledError — graceful exit
+*   (error) => {
+*     if (error instanceof WorkflowCancelledError) {
+*       // graceful exit
+*     } else {
+*       // error instanceof WorkflowScopeError — domain failure on `cause`
+*     }
 *   },
 * );
 * ```
@@ -41,10 +52,10 @@ function cancellableScope(fn) {
 			return ok(await CancellationScope.cancellable(async () => fn()));
 		} catch (error) {
 			if (isCancellation(error)) return err(new WorkflowCancelledError(error));
-			throw error;
+			return err(new WorkflowScopeError(error));
 		}
 	};
-	return new ResultAsync(work());
+	return makeResultAsync(work, (e) => new WorkflowScopeError(e));
 }
 /**
 * Run `fn` inside a non-cancellable Temporal scope. Cancellation requests
@@ -52,9 +63,10 @@ function cancellableScope(fn) {
 * to perform cleanup that must not be interrupted (e.g. releasing a
 * resource after a graceful shutdown).
 *
-* Mirrors `cancellableScope`'s `ResultAsync<...>` shape for symmetry;
-* the `err(...)` branch only triggers when cancellation is raised from
-* inside the scope (rare).
+* Mirrors `cancellableScope`'s `ResultAsync<...>` shape for symmetry; the
+* `err(WorkflowCancelledError)` branch only triggers when cancellation is
+* raised from inside the scope (rare). Non-cancellation errors surface as
+* `err(WorkflowScopeError)`.
 *
 * @example
 * ```ts
@@ -69,10 +81,10 @@ function nonCancellableScope(fn) {
 			return ok(await CancellationScope.nonCancellable(async () => fn()));
 		} catch (error) {
 			if (isCancellation(error)) return err(new WorkflowCancelledError(error));
-			throw error;
+			return err(new WorkflowScopeError(error));
 		}
 	};
-	return new ResultAsync(work());
+	return makeResultAsync(work, (e) => new WorkflowScopeError(e));
 }
 //#endregion
 //#region src/handlers.ts
@@ -124,8 +136,30 @@ function bindQueryHandler(workflowDefinition, workflowName, queryName, handler)
 	});
 }
 /**
-* Bind a typed update handler to the running workflow. Validates both
-* input and output (asynchronously, like signals).
+* Bind a typed update handler to the running workflow.
+*
+* Input validation runs in Temporal's `validator` slot — a synchronous
+* pre-admission hook. If it throws, Temporal rejects the update *before*
+* appending a workflow history event: clients see
+* `WorkflowUpdateValidationRejectedError` and the workflow's history is
+* unaffected. This is the documented contract for `setHandler`'s
+* `validator` option, and it is strictly better than running validation
+* inside the handler body — which forces Temporal to admit the update,
+* write a history event, and surface a `WorkflowUpdateFailedError` to
+* the client only after the fact.
+*
+* Because the validator slot is synchronous, the input schema must also
+* validate synchronously. Standard Schema is allowed to be async (Zod's
+* `.refine(async)` is the typical case), but we trip a clear error when
+* that happens rather than silently breaking admission semantics — same
+* approach as `bindQueryHandler`. Users who need async input checks
+* should run them inside the handler body and accept the post-admission
+* failure mode, or restructure their schema.
+*
+* Output validation continues to run inside the handler body. Update
+* outputs are *not* admission-gated — the handler must execute to
+* produce a value to validate against — so the async-allowed shape is
+* preserved.
 */
 function bindUpdateHandler(workflowDefinition, workflowName, updateName, handler) {
 	if (!workflowDefinition.updates) throw new Error(`Update "${updateName}" cannot be defined: workflow "${workflowName}" has no updates in its contract`);
@@ -133,14 +167,120 @@ function bindUpdateHandler(workflowDefinition, workflowName, updateName, handler
 	if (!updateDef) throw new Error(`Update "${updateName}" not found in workflow "${workflowName}" contract`);
 	setHandler(defineUpdate(updateName), async (...args) => {
 		const input = extractHandlerInput(args);
-		const inputResult = await updateDef.input["~standard"].validate(input);
+		const inputResult = updateDef.input["~standard"].validate(input);
+		if (inputResult instanceof Promise) throw new Error(`Update "${updateName}" input validation must be synchronous. Use a schema library that supports synchronous validation for update inputs (Temporal's update validator slot is synchronous).`);
 		if (inputResult.issues) throw new UpdateInputValidationError(updateName, inputResult.issues);
 		const result = await handler(inputResult.value);
 		const outputResult = await updateDef.output["~standard"].validate(result);
 		if (outputResult.issues) throw new UpdateOutputValidationError(updateName, outputResult.issues);
 		return outputResult.value;
+	}, { validator: (...args) => {
+		const input = extractHandlerInput(args);
+		const inputResult = updateDef.input["~standard"].validate(input);
+		if (inputResult instanceof Promise) throw new Error(`Update "${updateName}" input validation must be synchronous. Use a schema library that supports synchronous validation for update inputs (Temporal's update validator slot is synchronous).`);
+		if (inputResult.issues) throw new UpdateInputValidationError(updateName, inputResult.issues);
+	} });
+}
+//#endregion
+//#region src/child-workflow.ts
+async function validateChildWorkflowOutput(childDefinition, result, childWorkflowName) {
+	const outputResult = await childDefinition.output["~standard"].validate(result);
+	if (outputResult.issues) return err(new ChildWorkflowError(formatChildWorkflowValidationMessage(childWorkflowName, "output", outputResult.issues)));
+	return ok(outputResult.value);
+}
+async function getAndValidateChildWorkflow(childContract, childWorkflowName, args) {
+	const childDefinition = childContract.workflows[childWorkflowName];
+	if (!childDefinition) return err(new ChildWorkflowNotFoundError(childWorkflowName, Object.keys(childContract.workflows)));
+	const inputResult = await childDefinition.input["~standard"].validate(args);
+	if (inputResult.issues) return err(new ChildWorkflowError(formatChildWorkflowValidationMessage(childWorkflowName, "input", inputResult.issues)));
+	const validatedInput = inputResult.value;
+	return ok({
+		definition: childDefinition,
+		validatedInput,
+		taskQueue: childContract.taskQueue
 	});
 }
+function createTypedChildHandle(handle, childDefinition, childWorkflowName) {
+	return {
+		workflowId: handle.workflowId,
+		result: () => {
+			const work = async () => {
+				try {
+					return validateChildWorkflowOutput(childDefinition, await handle.result(), childWorkflowName);
+				} catch (error) {
+					return err(classifyChildWorkflowError("result", error, childWorkflowName));
+				}
+			};
+			return makeResultAsync(work, (error) => new ChildWorkflowError(`Child workflow execution failed: ${error instanceof Error ? error.message : String(error)}`, error));
+		}
+	};
+}
+function createStartChildWorkflow(childContract, childWorkflowName, options) {
+	const work = async () => {
+		const validationResult = await getAndValidateChildWorkflow(childContract, childWorkflowName, options.args);
+		if (validationResult.isErr()) return err(validationResult.error);
+		const { definition: childDefinition, validatedInput, taskQueue } = validationResult.value;
+		try {
+			const { args: _args, ...temporalOptions } = options;
+			return ok(createTypedChildHandle(await startChild(childWorkflowName, {
+				...temporalOptions,
+				taskQueue,
+				args: [validatedInput]
+			}), childDefinition, childWorkflowName));
+		} catch (error) {
+			return err(classifyChildWorkflowError("startChild", error, String(childWorkflowName)));
+		}
+	};
+	return makeResultAsync(work, (error) => new ChildWorkflowError(`Failed to start child workflow: ${error instanceof Error ? error.message : String(error)}`, error));
+}
+function createExecuteChildWorkflow(childContract, childWorkflowName, options) {
+	const work = async () => {
+		const validationResult = await getAndValidateChildWorkflow(childContract, childWorkflowName, options.args);
+		if (validationResult.isErr()) return err(validationResult.error);
+		const { definition: childDefinition, validatedInput, taskQueue } = validationResult.value;
+		try {
+			const { args: _args, ...temporalOptions } = options;
+			const outputValidationResult = await validateChildWorkflowOutput(childDefinition, await executeChild(childWorkflowName, {
+				...temporalOptions,
+				taskQueue,
+				args: [validatedInput]
+			}), childWorkflowName);
+			if (outputValidationResult.isErr()) return err(outputValidationResult.error);
+			return ok(outputValidationResult.value);
+		} catch (error) {
+			return err(classifyChildWorkflowError("executeChild", error, String(childWorkflowName)));
+		}
+	};
+	return makeResultAsync(work, (error) => new ChildWorkflowError(`Failed to execute child workflow: ${error instanceof Error ? error.message : String(error)}`, error));
+}
+//#endregion
+//#region src/activities-proxy.ts
+/**
+* Wrap the raw activities proxy with input/output validation against the
+* Standard Schema definitions on the contract. The wrapper enforces data
+* integrity at the workflow → activity boundary in addition to the
+* activity-side validation that `declareActivitiesHandler` already runs.
+*/
+function createValidatedActivities(rawActivities, workflowActivitiesDefinition, contractActivitiesDefinition) {
+	const validatedActivities = {};
+	const allActivitiesDefinition = {
+		...contractActivitiesDefinition,
+		...workflowActivitiesDefinition
+	};
+	for (const [activityName, activityDef] of Object.entries(allActivitiesDefinition)) {
+		const rawActivity = rawActivities[activityName];
+		if (!rawActivity) throw new Error(`Activity implementation not found for: "${activityName}". Available activities: ${Object.keys(rawActivities).length > 0 ? Object.keys(rawActivities).join(", ") : "none"}`);
+		validatedActivities[activityName] = async (input) => {
+			const inputResult = await activityDef.input["~standard"].validate(input);
+			if (inputResult.issues) throw new ActivityInputValidationError(activityName, inputResult.issues);
+			const result = await rawActivity(inputResult.value);
+			const outputResult = await activityDef.output["~standard"].validate(result);
+			if (outputResult.issues) throw new ActivityOutputValidationError(activityName, outputResult.issues);
+			return outputResult.value;
+		};
+	}
+	return validatedActivities;
+}
 //#endregion
 //#region src/workflow.ts
 /**
@@ -218,13 +358,16 @@ function bindUpdateHandler(workflowDefinition, workflowName, updateName, handler
 */
 function declareWorkflow({ workflowName, contract, implementation, activityOptions, activityOptionsByName }) {
 	const definition = contract.workflows[workflowName];
+	let contextActivities = {};
+	if (definition.activities || contract.activities) {
+		contextActivities = createValidatedActivities(buildRawActivitiesProxy(definition.activities, contract.activities, activityOptions, activityOptionsByName), definition.activities, contract.activities);
+		Object.freeze(contextActivities);
+	}
 	return async (...args) => {
 		const input = extractHandlerInput(args);
 		const inputResult = await definition.input["~standard"].validate(input);
-		if (inputResult.issues) throw new WorkflowInputValidationError(String(workflowName), inputResult.issues);
+		if (inputResult.issues) throw new WorkflowInputValidationError(workflowName, inputResult.issues);
 		const validatedInput = inputResult.value;
-		let contextActivities = {};
-		if (definition.activities || contract.activities) contextActivities = createValidatedActivities(buildRawActivitiesProxy(definition.activities, contract.activities, activityOptions, activityOptionsByName), definition.activities, contract.activities);
 		const result = await implementation({
 			activities: contextActivities,
 			info: workflowInfo(),
@@ -232,113 +375,17 @@ function declareWorkflow({ workflowName, contract, implementation, activityOptio
 			executeChildWorkflow: createExecuteChildWorkflow,
 			cancellableScope,
 			nonCancellableScope,
-			defineSignal: ((signalName, handler) => bindSignalHandler(definition, String(workflowName), signalName, handler)),
-			defineQuery: ((queryName, handler) => bindQueryHandler(definition, String(workflowName), queryName, handler)),
-			defineUpdate: ((updateName, handler) => bindUpdateHandler(definition, String(workflowName), updateName, handler)),
+			defineSignal: ((signalName, handler) => bindSignalHandler(definition, workflowName, signalName, handler)),
+			defineQuery: ((queryName, handler) => bindQueryHandler(definition, workflowName, queryName, handler)),
+			defineUpdate: ((updateName, handler) => bindUpdateHandler(definition, workflowName, updateName, handler)),
 			continueAsNew: createContinueAsNew(contract, workflowName)
 		}, validatedInput);
 		const outputResult = await definition.output["~standard"].validate(result);
-		if (outputResult.issues) throw new WorkflowOutputValidationError(String(workflowName), outputResult.issues);
+		if (outputResult.issues) throw new WorkflowOutputValidationError(workflowName, outputResult.issues);
 		return outputResult.value;
 	};
 }
-/**
-* Create a validated activities proxy that parses inputs and outputs
-*
-* This wrapper ensures data integrity across the network boundary between
-* workflow and activity execution.
-*/
-function createValidatedActivities(rawActivities, workflowActivitiesDefinition, contractActivitiesDefinition) {
-	const validatedActivities = {};
-	const allActivitiesDefinition = {
-		...contractActivitiesDefinition,
-		...workflowActivitiesDefinition
-	};
-	for (const [activityName, activityDef] of Object.entries(allActivitiesDefinition)) {
-		const rawActivity = rawActivities[activityName];
-		if (!rawActivity) throw new Error(`Activity implementation not found for: "${activityName}". Available activities: ${Object.keys(rawActivities).length > 0 ? Object.keys(rawActivities).join(", ") : "none"}`);
-		validatedActivities[activityName] = async (input) => {
-			const inputResult = await activityDef.input["~standard"].validate(input);
-			if (inputResult.issues) throw new ActivityInputValidationError(activityName, inputResult.issues);
-			const result = await rawActivity(inputResult.value);
-			const outputResult = await activityDef.output["~standard"].validate(result);
-			if (outputResult.issues) throw new ActivityOutputValidationError(activityName, outputResult.issues);
-			return outputResult.value;
-		};
-	}
-	return validatedActivities;
-}
-async function validateChildWorkflowOutput(childDefinition, result, childWorkflowName) {
-	const outputResult = await childDefinition.output["~standard"].validate(result);
-	if (outputResult.issues) return err(new ChildWorkflowError(formatChildWorkflowValidationMessage(childWorkflowName, "output", outputResult.issues)));
-	return ok(outputResult.value);
-}
-async function getAndValidateChildWorkflow(childContract, childWorkflowName, args) {
-	const childDefinition = childContract.workflows[childWorkflowName];
-	if (!childDefinition) return err(new ChildWorkflowNotFoundError(String(childWorkflowName), Object.keys(childContract.workflows)));
-	const inputResult = await childDefinition.input["~standard"].validate(args);
-	if (inputResult.issues) return err(new ChildWorkflowError(formatChildWorkflowValidationMessage(String(childWorkflowName), "input", inputResult.issues)));
-	const validatedInput = inputResult.value;
-	return ok({
-		definition: childDefinition,
-		validatedInput,
-		taskQueue: childContract.taskQueue
-	});
-}
-function createTypedChildHandle(handle, childDefinition, childWorkflowName) {
-	return {
-		workflowId: handle.workflowId,
-		result: () => {
-			const work = async () => {
-				try {
-					return validateChildWorkflowOutput(childDefinition, await handle.result(), childWorkflowName);
-				} catch (error) {
-					return err(new ChildWorkflowError(`Child workflow execution failed: ${error instanceof Error ? error.message : String(error)}`, error));
-				}
-			};
-			return new ResultAsync(work());
-		}
-	};
-}
-function createStartChildWorkflow(childContract, childWorkflowName, options) {
-	const work = async () => {
-		const validationResult = await getAndValidateChildWorkflow(childContract, childWorkflowName, options.args);
-		if (validationResult.isErr()) return err(validationResult.error);
-		const { definition: childDefinition, validatedInput, taskQueue } = validationResult.value;
-		try {
-			const { args: _args, ...temporalOptions } = options;
-			return ok(createTypedChildHandle(await startChild(childWorkflowName, {
-				...temporalOptions,
-				taskQueue,
-				args: [validatedInput]
-			}), childDefinition, String(childWorkflowName)));
-		} catch (error) {
-			return err(new ChildWorkflowError(`Failed to start child workflow: ${error instanceof Error ? error.message : String(error)}`, error));
-		}
-	};
-	return new ResultAsync(work());
-}
-function createExecuteChildWorkflow(childContract, childWorkflowName, options) {
-	const work = async () => {
-		const validationResult = await getAndValidateChildWorkflow(childContract, childWorkflowName, options.args);
-		if (validationResult.isErr()) return err(validationResult.error);
-		const { definition: childDefinition, validatedInput, taskQueue } = validationResult.value;
-		try {
-			const { args: _args, ...temporalOptions } = options;
-			const outputValidationResult = await validateChildWorkflowOutput(childDefinition, await executeChild(childWorkflowName, {
-				...temporalOptions,
-				taskQueue,
-				args: [validatedInput]
-			}), String(childWorkflowName));
-			if (outputValidationResult.isErr()) return err(outputValidationResult.error);
-			return ok(outputValidationResult.value);
-		} catch (error) {
-			return err(new ChildWorkflowError(`Failed to execute child workflow: ${error instanceof Error ? error.message : String(error)}`, error));
-		}
-	};
-	return new ResultAsync(work());
-}
 //#endregion
-export { ActivityInputValidationError, ActivityOutputValidationError, ChildWorkflowError, ChildWorkflowNotFoundError, QueryInputValidationError, QueryOutputValidationError, SignalInputValidationError, UpdateInputValidationError, UpdateOutputValidationError, WorkflowCancelledError, WorkflowInputValidationError, WorkflowOutputValidationError, declareWorkflow };
+export { ActivityInputValidationError, ActivityOutputValidationError, ChildWorkflowCancelledError, ChildWorkflowError, ChildWorkflowNotFoundError, QueryInputValidationError, QueryOutputValidationError, SignalInputValidationError, UpdateInputValidationError, UpdateOutputValidationError, WorkflowCancelledError, WorkflowInputValidationError, WorkflowOutputValidationError, WorkflowScopeError, declareWorkflow };
 
 //# sourceMappingURL=workflow.mjs.map