@temporal-contract/client 1.0.0 → 2.1.0

package/dist/index.cjs

@@ -1,7 +1,9 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 let _temporalio_common = require("@temporalio/common");
-let _swan_io_boxed = require("@swan-io/boxed");
+let neverthrow = require("neverthrow");
+let _temporal_contract_contract = require("@temporal-contract/contract");
 let _temporalio_client = require("@temporalio/client");
+let _temporal_contract_contract_result_async = require("@temporal-contract/contract/result-async");
 //#region src/errors.ts
 /**
 * Base class for all typed client errors with boxed pattern
@@ -77,11 +79,17 @@ var WorkflowExecutionNotFoundError = class extends TypedClientError {
 * on a workflow's result and the workflow completes with a failure —
 * Temporal's `WorkflowFailedError`.
 *
-* `cause` is the *unwrapped* underlying failure (typically an
+* `cause` is the *unwrapped* underlying {@link TemporalFailure} (typically an
 * `ApplicationFailure`, `CancelledFailure`, `TerminatedFailure`, or
 * `TimeoutFailure`) lifted from Temporal's wrapper, so callers can branch
 * on the failure category in one step (`err.cause instanceof
-* ApplicationFailure`) instead of unwrapping twice via the SDK wrapper.
+* ApplicationFailure`) instead of unwrapping twice via the SDK wrapper. The
+* SDK declares `WorkflowFailedError.cause` as the wider `Error | undefined`
+* (since `cause` lives on `Error`), but the runtime guarantee — driven by
+* Temporal's wire format — is that it is always a `TemporalFailure` subclass
+* when the wrapper is surfaced. `classifyResultError` narrows that wider
+* static type to the public {@link TemporalFailure} union with a cast, so
+* consumers see the precise leaf-failure typing instead of a bare `Error`.
 *
 * Returned from `executeWorkflow` and `handle.result()`.
 */
@@ -94,57 +102,11 @@ var WorkflowFailedError = class extends TypedClientError {
 	}
 };
 /**
-* Pattern for string keys safe to render with dot notation. A "safe" key is a
-* JavaScript identifier (letters/digits/underscore/$, not starting with a
-* digit). Anything else — keys containing dots, spaces, leading digits, the
-* empty string, the literal string `"0"` etc. — gets bracket-quoted so the
-* path is unambiguous.
-*
-* This helper is intentionally duplicated with the worker package so each
-* entry point is self-contained; keep the two copies in sync.
-*/
-const SAFE_IDENTIFIER = /^[A-Za-z_$][A-Za-z0-9_$]*$/;
-/**
-* Render a Standard Schema {@link StandardSchemaV1.Issue} into a human-readable
-* string that includes the failing field's path.
-*
-* Example output:
-* - `at items[0].quantity: Expected number, received undefined`
-* - `at customerId: Expected string, received undefined`
-* - `at user["first name"]: Expected string, received undefined`
-* - `Validation error` *(no path)*
-*
-* Path segments come either as bare `PropertyKey` values or as
-* `{ key: PropertyKey }` objects (per the spec); both are normalized.
-* - Numeric keys → `[N]`
-* - String keys that are valid JS identifiers → bare (first) or `.key`
-* - String keys that aren't valid identifiers → `["..."]` with JSON-style
-*   escaping (handles dots, spaces, leading digits, the empty string, the
-*   literal string `"0"`, embedded quotes, etc.)
-* - Symbol / other `PropertyKey` → `[Symbol(name)]`
-*/
-function formatIssue(issue) {
-	if (issue.path === void 0 || issue.path.length === 0) return issue.message;
-	let path = "";
-	for (let i = 0; i < issue.path.length; i++) {
-		const segment = issue.path[i];
-		const key = segment !== null && typeof segment === "object" && "key" in segment ? segment.key : segment;
-		if (typeof key === "number") path += `[${key}]`;
-		else if (typeof key === "string" && SAFE_IDENTIFIER.test(key)) path += i === 0 ? key : `.${key}`;
-		else if (typeof key === "string") path += `[${JSON.stringify(key)}]`;
-		else path += `[${String(key)}]`;
-	}
-	return `at ${path}: ${issue.message}`;
-}
-function summarizeIssues(issues) {
-	return issues.map(formatIssue).join("; ");
-}
-/**
 * Thrown when workflow input or output validation fails
 */
 var WorkflowValidationError = class extends TypedClientError {
 	constructor(workflowName, direction, issues) {
-		super(`Validation failed for workflow "${workflowName}" ${direction}: ${summarizeIssues(issues)}`);
+		super(`Validation failed for workflow "${workflowName}" ${direction}: ${(0, _temporal_contract_contract.summarizeIssues)(issues)}`);
 		this.workflowName = workflowName;
 		this.direction = direction;
 		this.issues = issues;
@@ -155,7 +117,7 @@ var WorkflowValidationError = class extends TypedClientError {
 */
 var QueryValidationError = class extends TypedClientError {
 	constructor(queryName, direction, issues) {
-		super(`Validation failed for query "${queryName}" ${direction}: ${summarizeIssues(issues)}`);
+		super(`Validation failed for query "${queryName}" ${direction}: ${(0, _temporal_contract_contract.summarizeIssues)(issues)}`);
 		this.queryName = queryName;
 		this.direction = direction;
 		this.issues = issues;
@@ -166,7 +128,7 @@ var QueryValidationError = class extends TypedClientError {
 */
 var SignalValidationError = class extends TypedClientError {
 	constructor(signalName, issues) {
-		super(`Validation failed for signal "${signalName}": ${summarizeIssues(issues)}`);
+		super(`Validation failed for signal "${signalName}": ${(0, _temporal_contract_contract.summarizeIssues)(issues)}`);
 		this.signalName = signalName;
 		this.issues = issues;
 	}
@@ -176,7 +138,7 @@ var SignalValidationError = class extends TypedClientError {
 */
 var UpdateValidationError = class extends TypedClientError {
 	constructor(updateName, direction, issues) {
-		super(`Validation failed for update "${updateName}" ${direction}: ${summarizeIssues(issues)}`);
+		super(`Validation failed for update "${updateName}" ${direction}: ${(0, _temporal_contract_contract.summarizeIssues)(issues)}`);
 		this.updateName = updateName;
 		this.direction = direction;
 		this.issues = issues;
@@ -192,21 +154,21 @@ var UpdateValidationError = class extends TypedClientError {
 * In-package modules and tests import it directly via relative path.
 */
 /**
-* Wrap an async result-producing function in a `Future`, catching any
+* Wrap an async result-producing function in a `ResultAsync`, catching any
 * unhandled rejection as a `RuntimeClientError("unexpected", error)`.
 *
 * The work function is expected to handle its own domain errors and return
-* a `Result.Error(...)` for them; the catch here is a safety net for
-* thrown exceptions the work didn't anticipate.
+* an `err(...)` for them; the catch here is a safety net for thrown
+* exceptions the work didn't anticipate.
 *
 * Used by `client.ts` (workflow operations) and `schedule.ts` (schedule
 * operations) so the unexpected-rejection shape is identical across the
-* typed client surface.
+* typed client surface. Delegates to `_internal_makeResultAsync` from
+* `@temporal-contract/contract` so the same wrapper is shared between the
+* client and worker packages.
 */
-function makeFuture(work) {
-	return _swan_io_boxed.Future.make((resolve) => {
-		work().then(resolve).catch((e) => resolve(_swan_io_boxed.Result.Error(new RuntimeClientError("unexpected", e))));
-	});
+function makeResultAsync(work) {
+	return (0, _temporal_contract_contract_result_async._internal_makeResultAsync)(work, (e) => new RuntimeClientError("unexpected", e));
 }
 /**
 * Map a thrown error from `client.workflow.start` / `signalWithStart` into
@@ -275,9 +237,9 @@ var TypedScheduleClient = class {
 	create(workflowName, options) {
 		const work = async () => {
 			const definition = this.contract.workflows[workflowName];
-			if (!definition) return _swan_io_boxed.Result.Error(new WorkflowNotFoundError(String(workflowName), Object.keys(this.contract.workflows)));
+			if (!definition) return (0, neverthrow.err)(new WorkflowNotFoundError(workflowName, Object.keys(this.contract.workflows)));
 			const inputResult = await definition.input["~standard"].validate(options.args);
-			if (inputResult.issues) return _swan_io_boxed.Result.Error(new WorkflowValidationError(String(workflowName), "input", inputResult.issues));
+			if (inputResult.issues) return (0, neverthrow.err)(new WorkflowValidationError(workflowName, "input", inputResult.issues));
 			try {
 				const overrides = options.action ?? {};
 				const action = {
@@ -294,20 +256,19 @@ var TypedScheduleClient = class {
 					...overrides.staticDetails !== void 0 ? { staticDetails: overrides.staticDetails } : {},
 					...overrides.staticSummary !== void 0 ? { staticSummary: overrides.staticSummary } : {}
 				};
-				const handle = await this.scheduleClient.create({
+				return (0, neverthrow.ok)(wrapScheduleHandle(await this.scheduleClient.create({
 					scheduleId: options.scheduleId,
 					spec: options.spec,
 					action,
 					...options.policies !== void 0 ? { policies: options.policies } : {},
 					...options.state !== void 0 ? { state: options.state } : {},
 					...options.memo !== void 0 ? { memo: options.memo } : {}
-				});
-				return _swan_io_boxed.Result.Ok(wrapScheduleHandle(handle));
+				})));
 			} catch (error) {
-				return _swan_io_boxed.Result.Error(new RuntimeClientError("schedule.create", error));
+				return (0, neverthrow.err)(new RuntimeClientError("schedule.create", error));
 			}
 		};
-		return makeFuture(work);
+		return makeResultAsync(work);
 	}
 	/**
 	* Get a typed handle to an existing schedule. Does not validate that the
@@ -321,11 +282,11 @@ var TypedScheduleClient = class {
 function wrapScheduleHandle(handle) {
 	return {
 		scheduleId: handle.scheduleId,
-		pause: (note) => _swan_io_boxed.Future.fromPromise(handle.pause(note)).mapError((error) => new RuntimeClientError("schedule.pause", error)).mapOk(() => void 0),
-		unpause: (note) => _swan_io_boxed.Future.fromPromise(handle.unpause(note)).mapError((error) => new RuntimeClientError("schedule.unpause", error)).mapOk(() => void 0),
-		trigger: (overlap) => _swan_io_boxed.Future.fromPromise(handle.trigger(overlap)).mapError((error) => new RuntimeClientError("schedule.trigger", error)).mapOk(() => void 0),
-		delete: () => _swan_io_boxed.Future.fromPromise(handle.delete()).mapError((error) => new RuntimeClientError("schedule.delete", error)).mapOk(() => void 0),
-		describe: () => _swan_io_boxed.Future.fromPromise(handle.describe()).mapError((error) => new RuntimeClientError("schedule.describe", error))
+		pause: (note) => neverthrow.ResultAsync.fromPromise(handle.pause(note), (error) => new RuntimeClientError("schedule.pause", error)).map(() => void 0),
+		unpause: (note) => neverthrow.ResultAsync.fromPromise(handle.unpause(note), (error) => new RuntimeClientError("schedule.unpause", error)).map(() => void 0),
+		trigger: (overlap) => neverthrow.ResultAsync.fromPromise(handle.trigger(overlap), (error) => new RuntimeClientError("schedule.trigger", error)).map(() => void 0),
+		delete: () => neverthrow.ResultAsync.fromPromise(handle.delete(), (error) => new RuntimeClientError("schedule.delete", error)).map(() => void 0),
+		describe: () => neverthrow.ResultAsync.fromPromise(handle.describe(), (error) => new RuntimeClientError("schedule.describe", error))
 	};
 }
 //#endregion
@@ -355,7 +316,37 @@ function toTypedSearchAttributes(workflowDef, values) {
 	return pairs.length > 0 ? new _temporalio_common.TypedSearchAttributes(pairs) : void 0;
 }
 /**
-* Typed Temporal client with Result/Future pattern based on a contract
+* Shared pre-call ritual for the three contract-driven entry points that
+* actually start a workflow (`startWorkflow`, `signalWithStart`,
+* `executeWorkflow`):
+*
+*   1. Look up the workflow definition on the contract.
+*   2. Surface a `WorkflowNotFoundError` if absent.
+*   3. Validate `args` against the workflow's input schema.
+*   4. Surface a `WorkflowValidationError` if validation fails.
+*   5. Translate any caller-supplied `searchAttributes` into Temporal's
+*      `TypedSearchAttributes` shape (or `undefined`).
+*
+* `getHandle` deliberately keeps its own three-line lookup — it doesn't
+* accept `args` or `searchAttributes`, so it can't share this helper. The
+* call-specific extras (signal validation, post-call output validation,
+* extended error classification) stay at the call site — those are the
+* differentiators that make each method distinct.
+*/
+async function resolveDefinitionAndValidateInput(contract, workflowName, args, searchAttributes) {
+	const definition = contract.workflows[workflowName];
+	if (!definition) return (0, neverthrow.err)(createWorkflowNotFoundError(workflowName, contract));
+	const inputResult = await definition.input["~standard"].validate(args);
+	if (inputResult.issues) return (0, neverthrow.err)(createWorkflowValidationError(workflowName, "input", inputResult.issues));
+	const typedSearchAttributes = toTypedSearchAttributes(definition, searchAttributes);
+	return (0, neverthrow.ok)({
+		definition,
+		validatedInput: inputResult.value,
+		typedSearchAttributes
+	});
+}
+/**
+* Typed Temporal client with neverthrow Result/ResultAsync pattern based on a contract
 *
 * Provides type-safe methods to start and execute workflows
 * defined in the contract, with explicit error handling using Result pattern.
@@ -379,10 +370,10 @@ var TypedClient = class TypedClient {
 	*   args: { orderId: "sweep" },
 	* });
 	*
-	* result.match({
-	*   Ok: async (handle) => { await handle.pause("maintenance"); },
-	*   Error: (error) => console.error("schedule create failed", error),
-	* });
+	* result.match(
+	*   async (handle) => { await handle.pause("maintenance"); },
+	*   (error) => console.error("schedule create failed", error),
+	* );
 	* ```
 	*/
 	schedule;
@@ -393,7 +384,7 @@ var TypedClient = class TypedClient {
 		this.schedule = new TypedScheduleClient(contract, client.schedule);
 	}
 	/**
-	* Create a typed Temporal client with boxed pattern from a contract
+	* Create a typed Temporal client with neverthrow pattern from a contract
 	*
 	* @example
 	* ```ts
@@ -406,17 +397,17 @@ var TypedClient = class TypedClient {
 	*   args: { ... },
 	* });
 	*
-	* result.match({
-	*   Ok: (output) => console.log('Success:', output),
-	*   Error: (error) => console.error('Failed:', error),
-	* });
+	* result.match(
+	*   (output) => console.log('Success:', output),
+	*   (error) => console.error('Failed:', error),
+	* );
 	* ```
 	*/
 	static create(contract, client) {
 		return new TypedClient(contract, client);
 	}
 	/**
-	* Start a workflow and return a typed handle with Future pattern
+	* Start a workflow and return a typed handle with ResultAsync pattern
 	*
 	* @example
 	* ```ts
@@ -427,35 +418,33 @@ var TypedClient = class TypedClient {
 	*   retry: { maximumAttempts: 3 },
 	* });
 	*
-	* handleResult.match({
-	*   Ok: async (handle) => {
+	* handleResult.match(
+	*   async (handle) => {
 	*     const result = await handle.result();
 	*     // ... handle result
 	*   },
-	*   Error: (error) => console.error('Failed to start:', error),
-	* });
+	*   (error) => console.error('Failed to start:', error),
+	* );
 	* ```
 	*/
 	startWorkflow(workflowName, { args, searchAttributes, ...temporalOptions }) {
 		const work = async () => {
-			const definition = this.contract.workflows[workflowName];
-			if (!definition) return _swan_io_boxed.Result.Error(createWorkflowNotFoundError(workflowName, this.contract));
-			const inputResult = await definition.input["~standard"].validate(args);
-			if (inputResult.issues) return _swan_io_boxed.Result.Error(createWorkflowValidationError(workflowName, "input", inputResult.issues));
-			const typedSearchAttributes = toTypedSearchAttributes(definition, searchAttributes);
+			const resolved = await resolveDefinitionAndValidateInput(this.contract, workflowName, args, searchAttributes);
+			if (resolved.isErr()) return (0, neverthrow.err)(resolved.error);
+			const { definition, validatedInput, typedSearchAttributes } = resolved.value;
 			try {
 				const handle = await this.client.workflow.start(workflowName, {
 					...temporalOptions,
 					taskQueue: this.contract.taskQueue,
-					args: [inputResult.value],
+					args: [validatedInput],
 					...typedSearchAttributes ? { typedSearchAttributes } : {}
 				});
-				return _swan_io_boxed.Result.Ok(this.createTypedHandle(handle, definition));
+				return (0, neverthrow.ok)(this.createTypedHandle(handle, definition));
 			} catch (error) {
-				return _swan_io_boxed.Result.Error(classifyStartError("startWorkflow", error));
+				return (0, neverthrow.err)(classifyStartError("startWorkflow", error));
 			}
 		};
-		return makeFuture(work);
+		return makeResultAsync(work);
 	}
 	/**
 	* Send a signal to a workflow, starting it first if it doesn't already exist.
@@ -477,45 +466,42 @@ var TypedClient = class TypedClient {
 	*   signalArgs: { reason: 'duplicate' },
 	* });
 	*
-	* result.match({
-	*   Ok: (handle) => console.log('signaled run', handle.signaledRunId),
-	*   Error: (error) => console.error('signalWithStart failed', error),
-	* });
+	* result.match(
+	*   (handle) => console.log('signaled run', handle.signaledRunId),
+	*   (error) => console.error('signalWithStart failed', error),
+	* );
 	* ```
 	*/
 	signalWithStart(workflowName, { args, signalName, signalArgs, searchAttributes, ...temporalOptions }) {
 		const work = async () => {
-			const definition = this.contract.workflows[workflowName];
-			if (!definition) return _swan_io_boxed.Result.Error(createWorkflowNotFoundError(workflowName, this.contract));
-			const inputResult = await definition.input["~standard"].validate(args);
-			if (inputResult.issues) return _swan_io_boxed.Result.Error(createWorkflowValidationError(workflowName, "input", inputResult.issues));
+			const resolved = await resolveDefinitionAndValidateInput(this.contract, workflowName, args, searchAttributes);
+			if (resolved.isErr()) return (0, neverthrow.err)(resolved.error);
+			const { definition, validatedInput, typedSearchAttributes } = resolved.value;
 			const signalDef = definition.signals?.[signalName];
-			if (!signalDef) return _swan_io_boxed.Result.Error(new SignalValidationError(signalName, [{ message: `Signal "${signalName}" is not declared on workflow "${String(workflowName)}".` }]));
+			if (!signalDef) return (0, neverthrow.err)(new SignalValidationError(signalName, [{ message: `Signal "${signalName}" is not declared on workflow "${workflowName}".` }]));
 			const signalInputResult = await signalDef.input["~standard"].validate(signalArgs);
-			if (signalInputResult.issues) return _swan_io_boxed.Result.Error(new SignalValidationError(signalName, signalInputResult.issues));
-			const typedSearchAttributes = toTypedSearchAttributes(definition, searchAttributes);
+			if (signalInputResult.issues) return (0, neverthrow.err)(new SignalValidationError(signalName, signalInputResult.issues));
 			try {
 				const handle = await this.client.workflow.signalWithStart(workflowName, {
 					...temporalOptions,
 					taskQueue: this.contract.taskQueue,
-					args: [inputResult.value],
+					args: [validatedInput],
 					signal: signalName,
 					signalArgs: [signalInputResult.value],
 					...typedSearchAttributes ? { typedSearchAttributes } : {}
 				});
-				const typed = this.createTypedHandle(handle, definition);
-				return _swan_io_boxed.Result.Ok({
-					...typed,
+				return (0, neverthrow.ok)({
+					...this.createTypedHandle(handle, definition),
 					signaledRunId: handle.signaledRunId
 				});
 			} catch (error) {
-				return _swan_io_boxed.Result.Error(classifyStartError("signalWithStart", error));
+				return (0, neverthrow.err)(classifyStartError("signalWithStart", error));
 			}
 		};
-		return makeFuture(work);
+		return makeResultAsync(work);
 	}
 	/**
-	* Execute a workflow (start and wait for result) with Future/Result pattern
+	* Execute a workflow (start and wait for result) with ResultAsync pattern
 	*
 	* @example
 	* ```ts
@@ -526,65 +512,63 @@ var TypedClient = class TypedClient {
 	*   retry: { maximumAttempts: 3 },
 	* });
 	*
-	* result.match({
-	*   Ok: (output) => console.log('Order processed:', output.status),
-	*   Error: (error) => console.error('Processing failed:', error),
-	* });
+	* result.match(
+	*   (output) => console.log('Order processed:', output.status),
+	*   (error) => console.error('Processing failed:', error),
+	* );
 	* ```
 	*/
 	executeWorkflow(workflowName, { args, searchAttributes, ...temporalOptions }) {
 		const work = async () => {
-			const definition = this.contract.workflows[workflowName];
-			if (!definition) return _swan_io_boxed.Result.Error(createWorkflowNotFoundError(workflowName, this.contract));
-			const inputResult = await definition.input["~standard"].validate(args);
-			if (inputResult.issues) return _swan_io_boxed.Result.Error(createWorkflowValidationError(workflowName, "input", inputResult.issues));
-			const typedSearchAttributes = toTypedSearchAttributes(definition, searchAttributes);
+			const resolved = await resolveDefinitionAndValidateInput(this.contract, workflowName, args, searchAttributes);
+			if (resolved.isErr()) return (0, neverthrow.err)(resolved.error);
+			const { definition, validatedInput, typedSearchAttributes } = resolved.value;
 			try {
 				const result = await this.client.workflow.execute(workflowName, {
 					...temporalOptions,
 					taskQueue: this.contract.taskQueue,
-					args: [inputResult.value],
+					args: [validatedInput],
 					...typedSearchAttributes ? { typedSearchAttributes } : {}
 				});
 				const outputResult = await definition.output["~standard"].validate(result);
-				if (outputResult.issues) return _swan_io_boxed.Result.Error(createWorkflowValidationError(workflowName, "output", outputResult.issues));
-				return _swan_io_boxed.Result.Ok(outputResult.value);
+				if (outputResult.issues) return (0, neverthrow.err)(createWorkflowValidationError(workflowName, "output", outputResult.issues));
+				return (0, neverthrow.ok)(outputResult.value);
 			} catch (error) {
-				if (error instanceof _temporalio_client.WorkflowExecutionAlreadyStartedError) return _swan_io_boxed.Result.Error(new WorkflowAlreadyStartedError(error.workflowType, error.workflowId, error));
-				if (error instanceof _temporalio_client.WorkflowFailedError) return _swan_io_boxed.Result.Error(new WorkflowFailedError(temporalOptions.workflowId, error.cause));
-				if (error instanceof _temporalio_common.WorkflowNotFoundError) return _swan_io_boxed.Result.Error(new WorkflowExecutionNotFoundError(error.workflowId || temporalOptions.workflowId, error.runId, error));
-				return _swan_io_boxed.Result.Error(createRuntimeClientError("executeWorkflow", error));
+				if (error instanceof _temporalio_client.WorkflowExecutionAlreadyStartedError) return (0, neverthrow.err)(new WorkflowAlreadyStartedError(error.workflowType, error.workflowId, error));
+				if (error instanceof _temporalio_client.WorkflowFailedError) return (0, neverthrow.err)(new WorkflowFailedError(temporalOptions.workflowId, error.cause));
+				if (error instanceof _temporalio_common.WorkflowNotFoundError) return (0, neverthrow.err)(new WorkflowExecutionNotFoundError(error.workflowId || temporalOptions.workflowId, error.runId, error));
+				return (0, neverthrow.err)(createRuntimeClientError("executeWorkflow", error));
 			}
 		};
-		return makeFuture(work);
+		return makeResultAsync(work);
 	}
 	/**
-	* Get a handle to an existing workflow with Future/Result pattern
+	* Get a handle to an existing workflow with ResultAsync pattern
 	*
 	* @example
 	* ```ts
 	* const handleResult = await client.getHandle('processOrder', 'order-123');
-	* handleResult.match({
-	*   Ok: async (handle) => {
+	* handleResult.match(
+	*   async (handle) => {
 	*     const result = await handle.result();
 	*     // ... handle result
 	*   },
-	*   Error: (error) => console.error('Failed to get handle:', error),
-	* });
+	*   (error) => console.error('Failed to get handle:', error),
+	* );
 	* ```
 	*/
 	getHandle(workflowName, workflowId) {
 		const work = async () => {
 			const definition = this.contract.workflows[workflowName];
-			if (!definition) return _swan_io_boxed.Result.Error(createWorkflowNotFoundError(workflowName, this.contract));
+			if (!definition) return (0, neverthrow.err)(createWorkflowNotFoundError(workflowName, this.contract));
 			try {
 				const handle = this.client.workflow.getHandle(workflowId);
-				return _swan_io_boxed.Result.Ok(this.createTypedHandle(handle, definition));
+				return (0, neverthrow.ok)(this.createTypedHandle(handle, definition));
 			} catch (error) {
-				return _swan_io_boxed.Result.Error(createRuntimeClientError("getHandle", error));
+				return (0, neverthrow.err)(createRuntimeClientError("getHandle", error));
 			}
 		};
-		return makeFuture(work);
+		return makeResultAsync(work);
 	}
 	createTypedHandle(workflowHandle, definition) {
 		const queries = buildValidatedProxy({
@@ -623,18 +607,18 @@ var TypedClient = class TypedClient {
 					try {
 						const result = await workflowHandle.result();
 						const outputResult = await definition.output["~standard"].validate(result);
-						if (outputResult.issues) return _swan_io_boxed.Result.Error(new WorkflowValidationError(workflowHandle.workflowId, "output", outputResult.issues));
-						return _swan_io_boxed.Result.Ok(outputResult.value);
+						if (outputResult.issues) return (0, neverthrow.err)(new WorkflowValidationError(workflowHandle.workflowId, "output", outputResult.issues));
+						return (0, neverthrow.ok)(outputResult.value);
 					} catch (error) {
-						return _swan_io_boxed.Result.Error(classifyResultError("result", error, workflowHandle.workflowId));
+						return (0, neverthrow.err)(classifyResultError("result", error, workflowHandle.workflowId));
 					}
 				};
-				return makeFuture(work);
+				return makeResultAsync(work);
 			},
-			terminate: (reason) => _swan_io_boxed.Future.fromPromise(workflowHandle.terminate(reason)).mapError((error) => classifyHandleError("terminate", error, workflowHandle.workflowId)).mapOk(() => void 0),
-			cancel: () => _swan_io_boxed.Future.fromPromise(workflowHandle.cancel()).mapError((error) => classifyHandleError("cancel", error, workflowHandle.workflowId)).mapOk(() => void 0),
-			describe: () => _swan_io_boxed.Future.fromPromise(workflowHandle.describe()).mapError((error) => classifyHandleError("describe", error, workflowHandle.workflowId)),
-			fetchHistory: () => _swan_io_boxed.Future.fromPromise(workflowHandle.fetchHistory()).mapError((error) => classifyHandleError("fetchHistory", error, workflowHandle.workflowId))
+			terminate: (reason) => neverthrow.ResultAsync.fromPromise(workflowHandle.terminate(reason), (error) => classifyHandleError("terminate", error, workflowHandle.workflowId)).map(() => void 0),
+			cancel: () => neverthrow.ResultAsync.fromPromise(workflowHandle.cancel(), (error) => classifyHandleError("cancel", error, workflowHandle.workflowId)).map(() => void 0),
+			describe: () => neverthrow.ResultAsync.fromPromise(workflowHandle.describe(), (error) => classifyHandleError("describe", error, workflowHandle.workflowId)),
+			fetchHistory: () => neverthrow.ResultAsync.fromPromise(workflowHandle.fetchHistory(), (error) => classifyHandleError("fetchHistory", error, workflowHandle.workflowId))
 		};
 	}
 };
@@ -648,7 +632,7 @@ function createWorkflowValidationError(workflowName, direction, issues) {
 	return new WorkflowValidationError(String(workflowName), direction, issues);
 }
 /**
-* Build a `{ name: (args) => Future<Result<...>> }` proxy for a contract's
+* Build a `{ name: (args) => ResultAsync<...> }` proxy for a contract's
 * queries/signals/updates. The three call sites differ only in how they
 * invoke Temporal and whether they validate output, so the shared
 * input-validate → invoke → output-validate → wrap-Result pipeline lives
@@ -660,19 +644,19 @@ function buildValidatedProxy({ defs, operation, workflowId, makeValidationError,
 	for (const [name, def] of Object.entries(defs)) proxy[name] = (args) => {
 		const work = async () => {
 			const inputResult = await def.input["~standard"].validate(args);
-			if (inputResult.issues) return _swan_io_boxed.Result.Error(makeValidationError(name, "input", inputResult.issues));
+			if (inputResult.issues) return (0, neverthrow.err)(makeValidationError(name, "input", inputResult.issues));
 			try {
 				const result = await invoke(name, inputResult.value);
 				const outputSchema = validateOutput(def);
-				if (!outputSchema) return _swan_io_boxed.Result.Ok(result);
+				if (!outputSchema) return (0, neverthrow.ok)(result);
 				const outputResult = await outputSchema["~standard"].validate(result);
-				if (outputResult.issues) return _swan_io_boxed.Result.Error(makeValidationError(name, "output", outputResult.issues));
-				return _swan_io_boxed.Result.Ok(outputResult.value);
+				if (outputResult.issues) return (0, neverthrow.err)(makeValidationError(name, "output", outputResult.issues));
+				return (0, neverthrow.ok)(outputResult.value);
 			} catch (error) {
-				return _swan_io_boxed.Result.Error(classifyHandleError(operation, error, workflowId));
+				return (0, neverthrow.err)(classifyHandleError(operation, error, workflowId));
 			}
 		};
-		return makeFuture(work);
+		return makeResultAsync(work);
 	};
 	return proxy;
 }