@temporal-contract/client 2.1.0 → 2.2.0

package/dist/index.cjs

@@ -154,6 +154,37 @@ var UpdateValidationError = class extends TypedClientError {
 * In-package modules and tests import it directly via relative path.
 */
 /**
+* Translate the contract's typed `searchAttributes` map (declared
+* name → value) into a Temporal `TypedSearchAttributes` instance, so the
+* Temporal client honours indexing when starting the workflow.
+*
+* Workflows without a `searchAttributes` block (or callers passing no
+* values) resolve to `ok(undefined)`, matching the Temporal SDK's
+* "absent ≠ empty" semantics.
+*
+* Returns `err(RuntimeClientError)` on unknown keys. The TypeScript
+* surface already gates the happy path; the runtime check catches typed
+* escape hatches (`as never`, `as any`, raw-call interop) where a typo
+* would otherwise silently drop the attribute, leaving the workflow
+* unindexed without any signal to the caller.
+*/
+function toTypedSearchAttributes(workflowDef, workflowName, values) {
+	if (!values) return (0, neverthrow.ok)(void 0);
+	const declared = workflowDef.searchAttributes ?? {};
+	const pairs = [];
+	for (const [name, value] of Object.entries(values)) {
+		if (value === void 0) continue;
+		const def = declared[name];
+		if (!def) return (0, neverthrow.err)(new RuntimeClientError("searchAttributes", /* @__PURE__ */ new Error(`Search attribute "${name}" is not declared on workflow "${workflowName}". Declared attributes: ${Object.keys(declared).join(", ") || "none"}.`)));
+		const key = (0, _temporalio_common.defineSearchAttributeKey)(name, def.kind);
+		pairs.push({
+			key,
+			value
+		});
+	}
+	return (0, neverthrow.ok)(pairs.length > 0 ? new _temporalio_common.TypedSearchAttributes(pairs) : void 0);
+}
+/**
 * Wrap an async result-producing function in a `ResultAsync`, catching any
 * unhandled rejection as a `RuntimeClientError("unexpected", error)`.
 *
@@ -240,6 +271,9 @@ var TypedScheduleClient = class {
 			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 (0, neverthrow.err)(new WorkflowValidationError(workflowName, "input", inputResult.issues));
+			const searchAttributesResult = toTypedSearchAttributes(definition, workflowName, options.searchAttributes);
+			if (searchAttributesResult.isErr()) return (0, neverthrow.err)(searchAttributesResult.error);
+			const typedSearchAttributes = searchAttributesResult.value;
 			try {
 				const overrides = options.action ?? {};
 				const action = {
@@ -247,6 +281,7 @@ var TypedScheduleClient = class {
 					workflowType: workflowName,
 					taskQueue: this.contract.taskQueue,
 					args: [inputResult.value],
+					...typedSearchAttributes ? { typedSearchAttributes } : {},
 					...overrides.workflowId !== void 0 ? { workflowId: overrides.workflowId } : {},
 					...overrides.workflowExecutionTimeout !== void 0 ? { workflowExecutionTimeout: overrides.workflowExecutionTimeout } : {},
 					...overrides.workflowRunTimeout !== void 0 ? { workflowRunTimeout: overrides.workflowRunTimeout } : {},
@@ -292,28 +327,44 @@ function wrapScheduleHandle(handle) {
 //#endregion
 //#region src/client.ts
 /**
-* Translate the contract's typed `searchAttributes` map (declared
-* name → value) into a Temporal `TypedSearchAttributes` instance, so the
-* Temporal client honours indexing when starting the workflow.
+* Read declared search attributes off a `TypedSearchAttributes` instance —
+* the read-side counterpart to the write-side `searchAttributes` option on
+* `startWorkflow` / `signalWithStart` / `executeWorkflow` /
+* `schedule.create`.
 *
-* Workflows without a `searchAttributes` block (or callers passing no
-* values) skip the conversion entirely and return `undefined`, matching
-* the Temporal SDK's "absent ≠ empty" semantics.
+* Use it on the result of `handle.describe()` (or a schedule's describe) to
+* recover the typed shape of indexed attributes. The Temporal SDK only
+* exposes a `.get(key)` accessor on `TypedSearchAttributes` and requires
+* the caller to reconstruct each `SearchAttributeKey` from the contract's
+* declared `kind` — this helper does that lookup once for every declared
+* attribute, returning a `Partial<TypedSearchAttributeMap<TWorkflow>>`
+* (each declared key may or may not have been set on the workflow).
+*
+* Workflows without declared `searchAttributes` get an empty object back.
+*
+* @example
+* ```ts
+* const description = await handle.describe();
+* if (description.isOk()) {
+*   const attrs = readTypedSearchAttributes(
+*     myContract.workflows.processOrder,
+*     description.value.typedSearchAttributes,
+*   );
+*   // attrs.customerId: string | undefined
+*   // attrs.priority:   number | undefined
+* }
+* ```
 */
-function toTypedSearchAttributes(workflowDef, values) {
-	if (!values || !workflowDef.searchAttributes) return void 0;
-	const pairs = [];
-	for (const [name, value] of Object.entries(values)) {
-		if (value === void 0) continue;
-		const def = workflowDef.searchAttributes[name];
-		if (!def) continue;
+function readTypedSearchAttributes(workflowDef, instance) {
+	const declared = workflowDef.searchAttributes;
+	if (!declared) return {};
+	const result = {};
+	for (const [name, def] of Object.entries(declared)) {
 		const key = (0, _temporalio_common.defineSearchAttributeKey)(name, def.kind);
-		pairs.push({
-			key,
-			value
-		});
+		const value = instance.get(key);
+		if (value !== void 0) result[name] = value;
 	}
-	return pairs.length > 0 ? new _temporalio_common.TypedSearchAttributes(pairs) : void 0;
+	return result;
 }
 /**
 * Shared pre-call ritual for the three contract-driven entry points that
@@ -338,7 +389,9 @@ async function resolveDefinitionAndValidateInput(contract, workflowName, args, s
 	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);
+	const searchAttributesResult = toTypedSearchAttributes(definition, workflowName, searchAttributes);
+	if (searchAttributesResult.isErr()) return (0, neverthrow.err)(searchAttributesResult.error);
+	const typedSearchAttributes = searchAttributesResult.value;
 	return (0, neverthrow.ok)({
 		definition,
 		validatedInput: inputResult.value,
@@ -672,3 +725,4 @@ exports.WorkflowExecutionNotFoundError = WorkflowExecutionNotFoundError;
 exports.WorkflowFailedError = WorkflowFailedError;
 exports.WorkflowNotFoundError = WorkflowNotFoundError;
 exports.WorkflowValidationError = WorkflowValidationError;
+exports.readTypedSearchAttributes = readTypedSearchAttributes;

package/dist/index.d.cts

@@ -1,8 +1,8 @@
 import { Client, ScheduleClient, ScheduleDescription, ScheduleOptions, ScheduleOptionsStartWorkflowAction, ScheduleOverlapPolicy, ScheduleSpec, WorkflowHandle, WorkflowSignalWithStartOptions, WorkflowStartOptions } from "@temporalio/client";
+import { ActivityFailure, ApplicationFailure, CancelledFailure, ChildWorkflowFailure, ServerFailure, TerminatedFailure, TimeoutFailure, TypedSearchAttributes } from "@temporalio/common";
 import { ActivityDefinition, AnySchema, AnyWorkflowDefinition, ContractDefinition, QueryDefinition, SearchAttributeDefinition, SearchAttributeKindToType, SignalDefinition, SignalNamesOf, UpdateDefinition } from "@temporal-contract/contract";
 import { StandardSchemaV1 } from "@standard-schema/spec";
 import { ResultAsync } from "neverthrow";
-import { ActivityFailure, ApplicationFailure, CancelledFailure, ChildWorkflowFailure, ServerFailure, TerminatedFailure, TimeoutFailure } from "@temporalio/common";
 
 //#region src/types.d.ts
 /**
@@ -234,7 +234,16 @@ type TypedScheduleActionOverrides = Pick<ScheduleOptionsStartWorkflowAction<neve
 type TypedScheduleCreateOptions<TContract extends ContractDefinition, TWorkflowName extends keyof TContract["workflows"] & string> = {
   /** Schedule ID. Recommended to use a meaningful business identifier. */scheduleId: string; /** When the schedule should fire (cron, interval, calendar). */
   spec: ScheduleSpec; /** Workflow input — validated against the contract's input schema. */
-  args: ClientInferInput<TContract["workflows"][TWorkflowName]>; /** Temporal schedule policies (overlap, catchupWindow, pauseOnFailure, etc.). */
+  args: ClientInferInput<TContract["workflows"][TWorkflowName]>;
+  /**
+   * Indexed search attributes for each workflow run spawned by this
+   * schedule. Keys and value types are constrained to those declared on
+   * the destination workflow's contract via `defineSearchAttribute`.
+   * Translated to Temporal's `typedSearchAttributes` and attached to the
+   * schedule's `startWorkflow` action so each spawned run is indexed
+   * identically to one started directly via `client.startWorkflow`.
+   */
+  searchAttributes?: TypedSearchAttributeMap<TContract["workflows"][TWorkflowName]>; /** Temporal schedule policies (overlap, catchupWindow, pauseOnFailure, etc.). */
   policies?: ScheduleOptions["policies"]; /** Temporal schedule state (paused, note, limited, etc.). */
   state?: ScheduleOptions["state"]; /** Schedule-level memo (non-indexed metadata on the schedule itself). */
   memo?: ScheduleOptions["memo"];
@@ -301,6 +310,36 @@ declare class TypedScheduleClient<TContract extends ContractDefinition> {
  * options for that workflow.
  */
 type TypedSearchAttributeMap<TWorkflow extends AnyWorkflowDefinition> = TWorkflow["searchAttributes"] extends Record<string, SearchAttributeDefinition> ? { [K in keyof TWorkflow["searchAttributes"]]?: SearchAttributeKindToType<TWorkflow["searchAttributes"][K]["kind"]> } : never;
+/**
+ * Read declared search attributes off a `TypedSearchAttributes` instance —
+ * the read-side counterpart to the write-side `searchAttributes` option on
+ * `startWorkflow` / `signalWithStart` / `executeWorkflow` /
+ * `schedule.create`.
+ *
+ * Use it on the result of `handle.describe()` (or a schedule's describe) to
+ * recover the typed shape of indexed attributes. The Temporal SDK only
+ * exposes a `.get(key)` accessor on `TypedSearchAttributes` and requires
+ * the caller to reconstruct each `SearchAttributeKey` from the contract's
+ * declared `kind` — this helper does that lookup once for every declared
+ * attribute, returning a `Partial<TypedSearchAttributeMap<TWorkflow>>`
+ * (each declared key may or may not have been set on the workflow).
+ *
+ * Workflows without declared `searchAttributes` get an empty object back.
+ *
+ * @example
+ * ```ts
+ * const description = await handle.describe();
+ * if (description.isOk()) {
+ *   const attrs = readTypedSearchAttributes(
+ *     myContract.workflows.processOrder,
+ *     description.value.typedSearchAttributes,
+ *   );
+ *   // attrs.customerId: string | undefined
+ *   // attrs.priority:   number | undefined
+ * }
+ * ```
+ */
+declare function readTypedSearchAttributes<TWorkflow extends AnyWorkflowDefinition>(workflowDef: TWorkflow, instance: TypedSearchAttributes): Partial<TypedSearchAttributeMap<TWorkflow>>;
 type TypedWorkflowStartOptions<TContract extends ContractDefinition, TWorkflowName extends keyof TContract["workflows"] & string> = Omit<WorkflowStartOptions, "taskQueue" | "args" | "searchAttributes" | "typedSearchAttributes"> & {
   args: ClientInferInput<TContract["workflows"][TWorkflowName]>;
   /**
@@ -538,5 +577,5 @@ declare class TypedClient<TContract extends ContractDefinition> {
   private createTypedHandle;
 }
 //#endregion
-export { type ClientInferActivities, type ClientInferActivity, type ClientInferInput, type ClientInferOutput, type ClientInferQuery, type ClientInferSignal, type ClientInferUpdate, type ClientInferWorkflow, type ClientInferWorkflowActivities, type ClientInferWorkflowContextActivities, type ClientInferWorkflowQueries, type ClientInferWorkflowSignals, type ClientInferWorkflowUpdates, type ClientInferWorkflows, QueryValidationError, RuntimeClientError, SignalValidationError, type TemporalFailure, TypedClient, type TypedScheduleActionOverrides, TypedScheduleClient, type TypedScheduleCreateOptions, type TypedScheduleHandle, type TypedSignalWithStartOptions, type TypedWorkflowHandle, type TypedWorkflowHandleWithSignaledRunId, type TypedWorkflowStartOptions, UpdateValidationError, WorkflowAlreadyStartedError, WorkflowExecutionNotFoundError, WorkflowFailedError, WorkflowNotFoundError, WorkflowValidationError };
+export { type ClientInferActivities, type ClientInferActivity, type ClientInferInput, type ClientInferOutput, type ClientInferQuery, type ClientInferSignal, type ClientInferUpdate, type ClientInferWorkflow, type ClientInferWorkflowActivities, type ClientInferWorkflowContextActivities, type ClientInferWorkflowQueries, type ClientInferWorkflowSignals, type ClientInferWorkflowUpdates, type ClientInferWorkflows, QueryValidationError, RuntimeClientError, SignalValidationError, type TemporalFailure, TypedClient, type TypedScheduleActionOverrides, TypedScheduleClient, type TypedScheduleCreateOptions, type TypedScheduleHandle, type TypedSearchAttributeMap, type TypedSignalWithStartOptions, type TypedWorkflowHandle, type TypedWorkflowHandleWithSignaledRunId, type TypedWorkflowStartOptions, UpdateValidationError, WorkflowAlreadyStartedError, WorkflowExecutionNotFoundError, WorkflowFailedError, WorkflowNotFoundError, WorkflowValidationError, readTypedSearchAttributes };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/types.ts","../src/errors.ts","../src/schedule.ts","../src/client.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/types.ts","../src/errors.ts","../src/schedule.ts","../src/client.ts"],"mappings":"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"}

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { ActivityFailure, ApplicationFailure, CancelledFailure, ChildWorkflowFailure, ServerFailure, TerminatedFailure, TimeoutFailure } from "@temporalio/common";
+import { ActivityFailure, ApplicationFailure, CancelledFailure, ChildWorkflowFailure, ServerFailure, TerminatedFailure, TimeoutFailure, TypedSearchAttributes } from "@temporalio/common";
 import { ResultAsync } from "neverthrow";
 import { ActivityDefinition, AnySchema, AnyWorkflowDefinition, ContractDefinition, QueryDefinition, SearchAttributeDefinition, SearchAttributeKindToType, SignalDefinition, SignalNamesOf, UpdateDefinition } from "@temporal-contract/contract";
 import { Client, ScheduleClient, ScheduleDescription, ScheduleOptions, ScheduleOptionsStartWorkflowAction, ScheduleOverlapPolicy, ScheduleSpec, WorkflowHandle, WorkflowSignalWithStartOptions, WorkflowStartOptions } from "@temporalio/client";
@@ -234,7 +234,16 @@ type TypedScheduleActionOverrides = Pick<ScheduleOptionsStartWorkflowAction<neve
 type TypedScheduleCreateOptions<TContract extends ContractDefinition, TWorkflowName extends keyof TContract["workflows"] & string> = {
   /** Schedule ID. Recommended to use a meaningful business identifier. */scheduleId: string; /** When the schedule should fire (cron, interval, calendar). */
   spec: ScheduleSpec; /** Workflow input — validated against the contract's input schema. */
-  args: ClientInferInput<TContract["workflows"][TWorkflowName]>; /** Temporal schedule policies (overlap, catchupWindow, pauseOnFailure, etc.). */
+  args: ClientInferInput<TContract["workflows"][TWorkflowName]>;
+  /**
+   * Indexed search attributes for each workflow run spawned by this
+   * schedule. Keys and value types are constrained to those declared on
+   * the destination workflow's contract via `defineSearchAttribute`.
+   * Translated to Temporal's `typedSearchAttributes` and attached to the
+   * schedule's `startWorkflow` action so each spawned run is indexed
+   * identically to one started directly via `client.startWorkflow`.
+   */
+  searchAttributes?: TypedSearchAttributeMap<TContract["workflows"][TWorkflowName]>; /** Temporal schedule policies (overlap, catchupWindow, pauseOnFailure, etc.). */
   policies?: ScheduleOptions["policies"]; /** Temporal schedule state (paused, note, limited, etc.). */
   state?: ScheduleOptions["state"]; /** Schedule-level memo (non-indexed metadata on the schedule itself). */
   memo?: ScheduleOptions["memo"];
@@ -301,6 +310,36 @@ declare class TypedScheduleClient<TContract extends ContractDefinition> {
  * options for that workflow.
  */
 type TypedSearchAttributeMap<TWorkflow extends AnyWorkflowDefinition> = TWorkflow["searchAttributes"] extends Record<string, SearchAttributeDefinition> ? { [K in keyof TWorkflow["searchAttributes"]]?: SearchAttributeKindToType<TWorkflow["searchAttributes"][K]["kind"]> } : never;
+/**
+ * Read declared search attributes off a `TypedSearchAttributes` instance —
+ * the read-side counterpart to the write-side `searchAttributes` option on
+ * `startWorkflow` / `signalWithStart` / `executeWorkflow` /
+ * `schedule.create`.
+ *
+ * Use it on the result of `handle.describe()` (or a schedule's describe) to
+ * recover the typed shape of indexed attributes. The Temporal SDK only
+ * exposes a `.get(key)` accessor on `TypedSearchAttributes` and requires
+ * the caller to reconstruct each `SearchAttributeKey` from the contract's
+ * declared `kind` — this helper does that lookup once for every declared
+ * attribute, returning a `Partial<TypedSearchAttributeMap<TWorkflow>>`
+ * (each declared key may or may not have been set on the workflow).
+ *
+ * Workflows without declared `searchAttributes` get an empty object back.
+ *
+ * @example
+ * ```ts
+ * const description = await handle.describe();
+ * if (description.isOk()) {
+ *   const attrs = readTypedSearchAttributes(
+ *     myContract.workflows.processOrder,
+ *     description.value.typedSearchAttributes,
+ *   );
+ *   // attrs.customerId: string | undefined
+ *   // attrs.priority:   number | undefined
+ * }
+ * ```
+ */
+declare function readTypedSearchAttributes<TWorkflow extends AnyWorkflowDefinition>(workflowDef: TWorkflow, instance: TypedSearchAttributes): Partial<TypedSearchAttributeMap<TWorkflow>>;
 type TypedWorkflowStartOptions<TContract extends ContractDefinition, TWorkflowName extends keyof TContract["workflows"] & string> = Omit<WorkflowStartOptions, "taskQueue" | "args" | "searchAttributes" | "typedSearchAttributes"> & {
   args: ClientInferInput<TContract["workflows"][TWorkflowName]>;
   /**
@@ -538,5 +577,5 @@ declare class TypedClient<TContract extends ContractDefinition> {
   private createTypedHandle;
 }
 //#endregion
-export { type ClientInferActivities, type ClientInferActivity, type ClientInferInput, type ClientInferOutput, type ClientInferQuery, type ClientInferSignal, type ClientInferUpdate, type ClientInferWorkflow, type ClientInferWorkflowActivities, type ClientInferWorkflowContextActivities, type ClientInferWorkflowQueries, type ClientInferWorkflowSignals, type ClientInferWorkflowUpdates, type ClientInferWorkflows, QueryValidationError, RuntimeClientError, SignalValidationError, type TemporalFailure, TypedClient, type TypedScheduleActionOverrides, TypedScheduleClient, type TypedScheduleCreateOptions, type TypedScheduleHandle, type TypedSignalWithStartOptions, type TypedWorkflowHandle, type TypedWorkflowHandleWithSignaledRunId, type TypedWorkflowStartOptions, UpdateValidationError, WorkflowAlreadyStartedError, WorkflowExecutionNotFoundError, WorkflowFailedError, WorkflowNotFoundError, WorkflowValidationError };
+export { type ClientInferActivities, type ClientInferActivity, type ClientInferInput, type ClientInferOutput, type ClientInferQuery, type ClientInferSignal, type ClientInferUpdate, type ClientInferWorkflow, type ClientInferWorkflowActivities, type ClientInferWorkflowContextActivities, type ClientInferWorkflowQueries, type ClientInferWorkflowSignals, type ClientInferWorkflowUpdates, type ClientInferWorkflows, QueryValidationError, RuntimeClientError, SignalValidationError, type TemporalFailure, TypedClient, type TypedScheduleActionOverrides, TypedScheduleClient, type TypedScheduleCreateOptions, type TypedScheduleHandle, type TypedSearchAttributeMap, type TypedSignalWithStartOptions, type TypedWorkflowHandle, type TypedWorkflowHandleWithSignaledRunId, type TypedWorkflowStartOptions, UpdateValidationError, WorkflowAlreadyStartedError, WorkflowExecutionNotFoundError, WorkflowFailedError, WorkflowNotFoundError, WorkflowValidationError, readTypedSearchAttributes };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types.ts","../src/errors.ts","../src/schedule.ts","../src/client.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types.ts","../src/errors.ts","../src/schedule.ts","../src/client.ts"],"mappings":"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"}

package/dist/index.mjs

@@ -153,6 +153,37 @@ var UpdateValidationError = class extends TypedClientError {
 * In-package modules and tests import it directly via relative path.
 */
 /**
+* Translate the contract's typed `searchAttributes` map (declared
+* name → value) into a Temporal `TypedSearchAttributes` instance, so the
+* Temporal client honours indexing when starting the workflow.
+*
+* Workflows without a `searchAttributes` block (or callers passing no
+* values) resolve to `ok(undefined)`, matching the Temporal SDK's
+* "absent ≠ empty" semantics.
+*
+* Returns `err(RuntimeClientError)` on unknown keys. The TypeScript
+* surface already gates the happy path; the runtime check catches typed
+* escape hatches (`as never`, `as any`, raw-call interop) where a typo
+* would otherwise silently drop the attribute, leaving the workflow
+* unindexed without any signal to the caller.
+*/
+function toTypedSearchAttributes(workflowDef, workflowName, values) {
+	if (!values) return ok(void 0);
+	const declared = workflowDef.searchAttributes ?? {};
+	const pairs = [];
+	for (const [name, value] of Object.entries(values)) {
+		if (value === void 0) continue;
+		const def = declared[name];
+		if (!def) return err(new RuntimeClientError("searchAttributes", /* @__PURE__ */ new Error(`Search attribute "${name}" is not declared on workflow "${workflowName}". Declared attributes: ${Object.keys(declared).join(", ") || "none"}.`)));
+		const key = defineSearchAttributeKey(name, def.kind);
+		pairs.push({
+			key,
+			value
+		});
+	}
+	return ok(pairs.length > 0 ? new TypedSearchAttributes(pairs) : void 0);
+}
+/**
 * Wrap an async result-producing function in a `ResultAsync`, catching any
 * unhandled rejection as a `RuntimeClientError("unexpected", error)`.
 *
@@ -239,6 +270,9 @@ var TypedScheduleClient = class {
 			if (!definition) return err(new WorkflowNotFoundError(workflowName, Object.keys(this.contract.workflows)));
 			const inputResult = await definition.input["~standard"].validate(options.args);
 			if (inputResult.issues) return err(new WorkflowValidationError(workflowName, "input", inputResult.issues));
+			const searchAttributesResult = toTypedSearchAttributes(definition, workflowName, options.searchAttributes);
+			if (searchAttributesResult.isErr()) return err(searchAttributesResult.error);
+			const typedSearchAttributes = searchAttributesResult.value;
 			try {
 				const overrides = options.action ?? {};
 				const action = {
@@ -246,6 +280,7 @@ var TypedScheduleClient = class {
 					workflowType: workflowName,
 					taskQueue: this.contract.taskQueue,
 					args: [inputResult.value],
+					...typedSearchAttributes ? { typedSearchAttributes } : {},
 					...overrides.workflowId !== void 0 ? { workflowId: overrides.workflowId } : {},
 					...overrides.workflowExecutionTimeout !== void 0 ? { workflowExecutionTimeout: overrides.workflowExecutionTimeout } : {},
 					...overrides.workflowRunTimeout !== void 0 ? { workflowRunTimeout: overrides.workflowRunTimeout } : {},
@@ -291,28 +326,44 @@ function wrapScheduleHandle(handle) {
 //#endregion
 //#region src/client.ts
 /**
-* Translate the contract's typed `searchAttributes` map (declared
-* name → value) into a Temporal `TypedSearchAttributes` instance, so the
-* Temporal client honours indexing when starting the workflow.
+* Read declared search attributes off a `TypedSearchAttributes` instance —
+* the read-side counterpart to the write-side `searchAttributes` option on
+* `startWorkflow` / `signalWithStart` / `executeWorkflow` /
+* `schedule.create`.
 *
-* Workflows without a `searchAttributes` block (or callers passing no
-* values) skip the conversion entirely and return `undefined`, matching
-* the Temporal SDK's "absent ≠ empty" semantics.
+* Use it on the result of `handle.describe()` (or a schedule's describe) to
+* recover the typed shape of indexed attributes. The Temporal SDK only
+* exposes a `.get(key)` accessor on `TypedSearchAttributes` and requires
+* the caller to reconstruct each `SearchAttributeKey` from the contract's
+* declared `kind` — this helper does that lookup once for every declared
+* attribute, returning a `Partial<TypedSearchAttributeMap<TWorkflow>>`
+* (each declared key may or may not have been set on the workflow).
+*
+* Workflows without declared `searchAttributes` get an empty object back.
+*
+* @example
+* ```ts
+* const description = await handle.describe();
+* if (description.isOk()) {
+*   const attrs = readTypedSearchAttributes(
+*     myContract.workflows.processOrder,
+*     description.value.typedSearchAttributes,
+*   );
+*   // attrs.customerId: string | undefined
+*   // attrs.priority:   number | undefined
+* }
+* ```
 */
-function toTypedSearchAttributes(workflowDef, values) {
-	if (!values || !workflowDef.searchAttributes) return void 0;
-	const pairs = [];
-	for (const [name, value] of Object.entries(values)) {
-		if (value === void 0) continue;
-		const def = workflowDef.searchAttributes[name];
-		if (!def) continue;
+function readTypedSearchAttributes(workflowDef, instance) {
+	const declared = workflowDef.searchAttributes;
+	if (!declared) return {};
+	const result = {};
+	for (const [name, def] of Object.entries(declared)) {
 		const key = defineSearchAttributeKey(name, def.kind);
-		pairs.push({
-			key,
-			value
-		});
+		const value = instance.get(key);
+		if (value !== void 0) result[name] = value;
 	}
-	return pairs.length > 0 ? new TypedSearchAttributes(pairs) : void 0;
+	return result;
 }
 /**
 * Shared pre-call ritual for the three contract-driven entry points that
@@ -337,7 +388,9 @@ async function resolveDefinitionAndValidateInput(contract, workflowName, args, s
 	if (!definition) return err(createWorkflowNotFoundError(workflowName, contract));
 	const inputResult = await definition.input["~standard"].validate(args);
 	if (inputResult.issues) return err(createWorkflowValidationError(workflowName, "input", inputResult.issues));
-	const typedSearchAttributes = toTypedSearchAttributes(definition, searchAttributes);
+	const searchAttributesResult = toTypedSearchAttributes(definition, workflowName, searchAttributes);
+	if (searchAttributesResult.isErr()) return err(searchAttributesResult.error);
+	const typedSearchAttributes = searchAttributesResult.value;
 	return ok({
 		definition,
 		validatedInput: inputResult.value,
@@ -660,6 +713,6 @@ function buildValidatedProxy({ defs, operation, workflowId, makeValidationError,
 	return proxy;
 }
 //#endregion
-export { QueryValidationError, RuntimeClientError, SignalValidationError, TypedClient, TypedScheduleClient, UpdateValidationError, WorkflowAlreadyStartedError, WorkflowExecutionNotFoundError, WorkflowFailedError, WorkflowNotFoundError, WorkflowValidationError };
+export { QueryValidationError, RuntimeClientError, SignalValidationError, TypedClient, TypedScheduleClient, UpdateValidationError, WorkflowAlreadyStartedError, WorkflowExecutionNotFoundError, WorkflowFailedError, WorkflowNotFoundError, WorkflowValidationError, readTypedSearchAttributes };
 
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["TemporalWorkflowNotFoundError","TemporalWorkflowFailedError","TemporalWorkflowFailedError","TemporalWorkflowNotFoundError"],"sources":["../src/errors.ts","../src/internal.ts","../src/schedule.ts","../src/client.ts"],"sourcesContent":["import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport { summarizeIssues } from \"@temporal-contract/contract\";\nimport type {\n  ActivityFailure,\n  ApplicationFailure,\n  CancelledFailure,\n  ChildWorkflowFailure,\n  ServerFailure,\n  TerminatedFailure,\n  TimeoutFailure,\n} from \"@temporalio/common\";\n\n/**\n * Union of the actionable Temporal failure types that can surface as the\n * `cause` of a `WorkflowFailedError`. These all extend Temporal's internal\n * `TemporalFailure` base class — we list them by leaf type rather than by\n * the base class so consumer code can use a single `switch (true)` over\n * `instanceof` discriminants without an exhaustiveness escape hatch.\n *\n * Re-exported from the package entry point so consumers can import it\n * directly: `import type { TemporalFailure } from \"@temporal-contract/client\"`.\n */\nexport type TemporalFailure =\n  | ApplicationFailure\n  | CancelledFailure\n  | TerminatedFailure\n  | TimeoutFailure\n  | ChildWorkflowFailure\n  | ServerFailure\n  | ActivityFailure;\n\n/**\n * Base class for all typed client errors with boxed pattern\n */\nabstract class TypedClientError extends Error {\n  protected constructor(message: string) {\n    super(message);\n    this.name = this.constructor.name;\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, this.constructor);\n    }\n  }\n}\n\n/**\n * Generic runtime failure wrapper when no specific error type applies\n */\nexport class RuntimeClientError extends TypedClientError {\n  constructor(\n    public readonly operation: string,\n    public override readonly cause?: unknown,\n  ) {\n    super(\n      `Operation \"${operation}\" failed: ${\n        cause instanceof Error ? cause.message : String(cause ?? \"unknown error\")\n      }`,\n    );\n  }\n}\n\n/**\n * Thrown when a workflow is not found in the contract\n */\nexport class WorkflowNotFoundError extends TypedClientError {\n  constructor(\n    public readonly workflowName: string,\n    public readonly availableWorkflows: string[],\n  ) {\n    super(\n      `Workflow \"${workflowName}\" not found in contract. Available workflows: ${availableWorkflows.join(\", \")}`,\n    );\n  }\n}\n\n/**\n * Discriminated variant of {@link RuntimeClientError} surfaced when starting\n * a workflow collides with an existing execution — Temporal's\n * `WorkflowExecutionAlreadyStartedError`. The most common cause is a\n * workflowId reuse policy that rejects duplicates while a previous run is\n * still in retention.\n *\n * Distinguishing this from `RuntimeClientError` lets idempotent callers\n * branch on it explicitly (e.g. fetch the existing handle and continue)\n * without inspecting `error.cause` against a Temporal SDK class.\n */\nexport class WorkflowAlreadyStartedError extends TypedClientError {\n  constructor(\n    public readonly workflowType: string,\n    public readonly workflowId: string,\n    public override readonly cause?: unknown,\n  ) {\n    super(`Workflow \"${workflowType}\" with ID \"${workflowId}\" is already started or in retention.`);\n  }\n}\n\n/**\n * Discriminated variant of {@link RuntimeClientError} surfaced when an\n * operation targets a workflow execution that doesn't exist in the\n * namespace — Temporal's `WorkflowNotFoundError` (distinct from this\n * package's contract-level {@link WorkflowNotFoundError}).\n *\n * Returned from:\n * - handle methods: `signal`, `query`, `executeUpdate`, `result`,\n *   `terminate`, `cancel`, `describe`, `fetchHistory`\n * - `executeWorkflow` (when the underlying execute call hits a missing\n *   execution mid-flight)\n */\nexport class WorkflowExecutionNotFoundError extends TypedClientError {\n  constructor(\n    public readonly workflowId: string,\n    public readonly runId?: string,\n    public override readonly cause?: unknown,\n  ) {\n    super(\n      `Workflow execution \"${workflowId}\"${runId ? ` (run \"${runId}\")` : \"\"} not found in namespace.`,\n    );\n  }\n}\n\n/**\n * Discriminated variant of {@link RuntimeClientError} surfaced when waiting\n * on a workflow's result and the workflow completes with a failure —\n * Temporal's `WorkflowFailedError`.\n *\n * `cause` is the *unwrapped* underlying {@link TemporalFailure} (typically an\n * `ApplicationFailure`, `CancelledFailure`, `TerminatedFailure`, or\n * `TimeoutFailure`) lifted from Temporal's wrapper, so callers can branch\n * on the failure category in one step (`err.cause instanceof\n * ApplicationFailure`) instead of unwrapping twice via the SDK wrapper. The\n * SDK declares `WorkflowFailedError.cause` as the wider `Error | undefined`\n * (since `cause` lives on `Error`), but the runtime guarantee — driven by\n * Temporal's wire format — is that it is always a `TemporalFailure` subclass\n * when the wrapper is surfaced. `classifyResultError` narrows that wider\n * static type to the public {@link TemporalFailure} union with a cast, so\n * consumers see the precise leaf-failure typing instead of a bare `Error`.\n *\n * Returned from `executeWorkflow` and `handle.result()`.\n */\nexport class WorkflowFailedError extends TypedClientError {\n  constructor(\n    public readonly workflowId: string,\n    public override readonly cause?: TemporalFailure,\n  ) {\n    const causeMessage =\n      cause instanceof Error ? cause.message : String(cause ?? \"unknown failure\");\n    super(`Workflow \"${workflowId}\" completed with failure: ${causeMessage}`);\n  }\n}\n\n// Validation-message formatters live in `@temporal-contract/contract` so\n// client and worker share a single source of truth. The previous local\n// copies have been removed in favor of the shared `summarizeIssues` import\n// at the top of this module.\n\n/**\n * Thrown when workflow input or output validation fails\n */\nexport class WorkflowValidationError extends TypedClientError {\n  constructor(\n    public readonly workflowName: string,\n    public readonly direction: \"input\" | \"output\",\n    public readonly issues: ReadonlyArray<StandardSchemaV1.Issue>,\n  ) {\n    super(\n      `Validation failed for workflow \"${workflowName}\" ${direction}: ${summarizeIssues(issues)}`,\n    );\n  }\n}\n\n/**\n * Thrown when query input or output validation fails\n */\nexport class QueryValidationError extends TypedClientError {\n  constructor(\n    public readonly queryName: string,\n    public readonly direction: \"input\" | \"output\",\n    public readonly issues: ReadonlyArray<StandardSchemaV1.Issue>,\n  ) {\n    super(`Validation failed for query \"${queryName}\" ${direction}: ${summarizeIssues(issues)}`);\n  }\n}\n\n/**\n * Thrown when signal input validation fails\n */\nexport class SignalValidationError extends TypedClientError {\n  constructor(\n    public readonly signalName: string,\n    public readonly issues: ReadonlyArray<StandardSchemaV1.Issue>,\n  ) {\n    super(`Validation failed for signal \"${signalName}\": ${summarizeIssues(issues)}`);\n  }\n}\n\n/**\n * Thrown when update input or output validation fails\n */\nexport class UpdateValidationError extends TypedClientError {\n  constructor(\n    public readonly updateName: string,\n    public readonly direction: \"input\" | \"output\",\n    public readonly issues: ReadonlyArray<StandardSchemaV1.Issue>,\n  ) {\n    super(`Validation failed for update \"${updateName}\" ${direction}: ${summarizeIssues(issues)}`);\n  }\n}\n","/**\n * Internal helpers shared across the client package's modules.\n *\n * Not part of the public API — this module is not listed in the package's\n * `exports` map, so consumers can't import from `@temporal-contract/client/internal`.\n * In-package modules and tests import it directly via relative path.\n */\nimport { WorkflowExecutionAlreadyStartedError } from \"@temporalio/client\";\nimport { WorkflowFailedError as TemporalWorkflowFailedError } from \"@temporalio/client\";\nimport { WorkflowNotFoundError as TemporalWorkflowNotFoundError } from \"@temporalio/common\";\nimport { _internal_makeResultAsync } from \"@temporal-contract/contract/result-async\";\nimport type { ResultAsync, Result } from \"neverthrow\";\nimport {\n  RuntimeClientError,\n  type TemporalFailure,\n  WorkflowAlreadyStartedError,\n  WorkflowExecutionNotFoundError,\n  WorkflowFailedError,\n} from \"./errors.js\";\n\n/**\n * Wrap an async result-producing function in a `ResultAsync`, catching any\n * unhandled rejection as a `RuntimeClientError(\"unexpected\", error)`.\n *\n * The work function is expected to handle its own domain errors and return\n * an `err(...)` for them; the catch here is a safety net for thrown\n * exceptions the work didn't anticipate.\n *\n * Used by `client.ts` (workflow operations) and `schedule.ts` (schedule\n * operations) so the unexpected-rejection shape is identical across the\n * typed client surface. Delegates to `_internal_makeResultAsync` from\n * `@temporal-contract/contract` so the same wrapper is shared between the\n * client and worker packages.\n */\nexport function makeResultAsync<T, E>(\n  work: () => Promise<Result<T, E>>,\n): ResultAsync<T, E | RuntimeClientError> {\n  return _internal_makeResultAsync<T, E | RuntimeClientError>(\n    work,\n    (e) => new RuntimeClientError(\"unexpected\", e),\n  );\n}\n\n/**\n * Map a thrown error from `client.workflow.start` / `signalWithStart` into\n * the discriminated union surfaced by the typed client. Specifically\n * recognizes Temporal's `WorkflowExecutionAlreadyStartedError`; everything\n * else falls through to {@link RuntimeClientError}.\n */\nexport function classifyStartError(\n  operation: string,\n  error: unknown,\n): WorkflowAlreadyStartedError | RuntimeClientError {\n  if (error instanceof WorkflowExecutionAlreadyStartedError) {\n    return new WorkflowAlreadyStartedError(error.workflowType, error.workflowId, error);\n  }\n  return new RuntimeClientError(operation, error);\n}\n\n/**\n * Map a thrown error from a workflow handle method (signal, query,\n * executeUpdate, terminate, cancel, describe, fetchHistory) into the\n * discriminated union surfaced by the typed client. Recognizes Temporal's\n * `WorkflowNotFoundError`; everything else falls through to\n * {@link RuntimeClientError}.\n *\n * `fallbackWorkflowId` is used when Temporal's error carries an empty\n * `workflowId` (it normalizes missing IDs to the empty string), so the\n * surfaced error always identifies the targeted execution.\n */\nexport function classifyHandleError(\n  operation: string,\n  error: unknown,\n  fallbackWorkflowId: string,\n): WorkflowExecutionNotFoundError | RuntimeClientError {\n  if (error instanceof TemporalWorkflowNotFoundError) {\n    return new WorkflowExecutionNotFoundError(\n      error.workflowId || fallbackWorkflowId,\n      error.runId,\n      error,\n    );\n  }\n  return new RuntimeClientError(operation, error);\n}\n\n/**\n * Map a thrown error from `handle.result()` / `client.workflow.execute()`\n * (the latter when waiting on the result phase). Recognizes Temporal's\n * `WorkflowFailedError` and `WorkflowNotFoundError`; everything else falls\n * through to {@link RuntimeClientError}.\n *\n * Temporal's `WorkflowFailedError` is itself a wrapper — the actionable\n * failure (ApplicationFailure, CancelledFailure, TerminatedFailure, etc.)\n * lives on its `cause` field. We forward that inner cause directly so\n * consumers can match `err.cause` against the underlying failure class\n * without an extra unwrap step. (If Temporal's cause is `undefined`, our\n * `cause` is too — same shape as before.)\n */\nexport function classifyResultError(\n  operation: string,\n  error: unknown,\n  workflowId: string,\n): WorkflowFailedError | WorkflowExecutionNotFoundError | RuntimeClientError {\n  if (error instanceof TemporalWorkflowFailedError) {\n    // Temporal types `cause` as `Error | undefined`, but the SDK only ever\n    // populates it with a `TemporalFailure` subclass when surfacing a\n    // workflow result failure. Narrow with the public union so consumers\n    // can branch on the leaf failure types without an extra cast.\n    return new WorkflowFailedError(workflowId, error.cause as TemporalFailure | undefined);\n  }\n  if (error instanceof TemporalWorkflowNotFoundError) {\n    return new WorkflowExecutionNotFoundError(error.workflowId || workflowId, error.runId, error);\n  }\n  return new RuntimeClientError(operation, error);\n}\n","import type {\n  ScheduleClient,\n  ScheduleDescription,\n  ScheduleHandle,\n  ScheduleOptions,\n  ScheduleOptionsStartWorkflowAction,\n  ScheduleOverlapPolicy,\n  ScheduleSpec,\n} from \"@temporalio/client\";\nimport type { ContractDefinition } from \"@temporal-contract/contract\";\nimport { ResultAsync, type Result, ok, err } from \"neverthrow\";\nimport type { ClientInferInput } from \"./types.js\";\nimport { RuntimeClientError, WorkflowNotFoundError, WorkflowValidationError } from \"./errors.js\";\nimport { makeResultAsync } from \"./internal.js\";\n\n/**\n * Workflow-action–level overrides forwarded to Temporal's\n * `ScheduleOptionsStartWorkflowAction`. These live under a nested `action`\n * field so the workflow-level `memo` (per-action workflow metadata) can be\n * set independently from the schedule-level `memo` (metadata on the\n * schedule itself) — Temporal honours both, and they have separate\n * lifecycles.\n *\n * `workflowType` and `taskQueue` are owned by the contract and not exposed.\n */\nexport type TypedScheduleActionOverrides = Pick<\n  ScheduleOptionsStartWorkflowAction<never>,\n  | \"workflowId\"\n  | \"workflowExecutionTimeout\"\n  | \"workflowRunTimeout\"\n  | \"workflowTaskTimeout\"\n  | \"retry\"\n  | \"memo\"\n  | \"staticDetails\"\n  | \"staticSummary\"\n>;\n\n/**\n * Options for {@link TypedScheduleClient.create}.\n *\n * `scheduleId` and `spec` come from Temporal's `ScheduleOptions`. `args` is\n * typed against the destination workflow's input schema. `policies`,\n * `state`, and `memo` mirror Temporal's own schedule-level options.\n * Workflow-action–level overrides nest under {@link action} so memo and\n * other fields with the same name don't collide between the two scopes.\n */\nexport type TypedScheduleCreateOptions<\n  TContract extends ContractDefinition,\n  TWorkflowName extends keyof TContract[\"workflows\"] & string,\n> = {\n  /** Schedule ID. Recommended to use a meaningful business identifier. */\n  scheduleId: string;\n  /** When the schedule should fire (cron, interval, calendar). */\n  spec: ScheduleSpec;\n  /** Workflow input — validated against the contract's input schema. */\n  args: ClientInferInput<TContract[\"workflows\"][TWorkflowName]>;\n  /** Temporal schedule policies (overlap, catchupWindow, pauseOnFailure, etc.). */\n  policies?: ScheduleOptions[\"policies\"];\n  /** Temporal schedule state (paused, note, limited, etc.). */\n  state?: ScheduleOptions[\"state\"];\n  /** Schedule-level memo (non-indexed metadata on the schedule itself). */\n  memo?: ScheduleOptions[\"memo\"];\n  /**\n   * Workflow-action–level overrides. `workflowType` and `taskQueue` are\n   * derived from the contract, so they don't appear here. Note that\n   * `action.memo` is a *workflow-level* memo applied to each spawned run,\n   * distinct from the top-level `memo` (which is metadata on the schedule\n   * itself).\n   */\n  action?: TypedScheduleActionOverrides;\n};\n\n/**\n * Typed handle to a schedule. Mirrors Temporal's `ScheduleHandle` lifecycle\n * methods (`pause`, `unpause`, `trigger`, `describe`, `delete`) wrapped in\n * the neverthrow ResultAsync pattern so call sites match the rest of the\n * typed client.\n */\nexport type TypedScheduleHandle = {\n  /** This schedule's identifier. */\n  readonly scheduleId: string;\n  /** Pause the schedule. Optional note becomes part of the audit trail. */\n  pause: (note?: string) => ResultAsync<void, RuntimeClientError>;\n  /** Resume a paused schedule. */\n  unpause: (note?: string) => ResultAsync<void, RuntimeClientError>;\n  /** Fire the schedule's action immediately. */\n  trigger: (overlap?: ScheduleOverlapPolicy) => ResultAsync<void, RuntimeClientError>;\n  /** Delete the schedule. */\n  delete: () => ResultAsync<void, RuntimeClientError>;\n  /** Fetch the schedule's current description from the server. */\n  describe: () => ResultAsync<ScheduleDescription, RuntimeClientError>;\n};\n\n/**\n * Typed wrapper around Temporal's `ScheduleClient`. Exposed as\n * `typedClient.schedule` — keeps the typed-client surface organized the\n * same way Temporal's own `Client.schedule` does.\n */\nexport class TypedScheduleClient<TContract extends ContractDefinition> {\n  constructor(\n    private readonly contract: TContract,\n    private readonly scheduleClient: ScheduleClient,\n  ) {}\n\n  /**\n   * Create a new schedule that, on each fire, starts the named contract\n   * workflow with validated args.\n   *\n   * Validates `args` against the workflow's input schema before dispatching\n   * the create request to Temporal. The workflow's `taskQueue` and\n   * `workflowType` are pulled from the contract automatically; the typed\n   * options shape omits them so call sites don't have to repeat themselves.\n   */\n  create<TWorkflowName extends keyof TContract[\"workflows\"] & string>(\n    workflowName: TWorkflowName,\n    options: TypedScheduleCreateOptions<TContract, TWorkflowName>,\n  ): ResultAsync<\n    TypedScheduleHandle,\n    WorkflowNotFoundError | WorkflowValidationError | RuntimeClientError\n  > {\n    type Ok = TypedScheduleHandle;\n    type Err = WorkflowNotFoundError | WorkflowValidationError | RuntimeClientError;\n    const work = async (): Promise<Result<Ok, Err>> => {\n      const definition = this.contract.workflows[workflowName];\n      if (!definition) {\n        return err(new WorkflowNotFoundError(workflowName, Object.keys(this.contract.workflows)));\n      }\n\n      const inputResult = await definition.input[\"~standard\"].validate(options.args);\n      if (inputResult.issues) {\n        return err(new WorkflowValidationError(workflowName, \"input\", inputResult.issues));\n      }\n\n      try {\n        const overrides = options.action ?? {};\n        const action: ScheduleOptionsStartWorkflowAction<never> = {\n          type: \"startWorkflow\",\n          workflowType: workflowName,\n          taskQueue: this.contract.taskQueue,\n          args: [inputResult.value] as never,\n          ...(overrides.workflowId !== undefined ? { workflowId: overrides.workflowId } : {}),\n          ...(overrides.workflowExecutionTimeout !== undefined\n            ? { workflowExecutionTimeout: overrides.workflowExecutionTimeout }\n            : {}),\n          ...(overrides.workflowRunTimeout !== undefined\n            ? { workflowRunTimeout: overrides.workflowRunTimeout }\n            : {}),\n          ...(overrides.workflowTaskTimeout !== undefined\n            ? { workflowTaskTimeout: overrides.workflowTaskTimeout }\n            : {}),\n          ...(overrides.retry !== undefined ? { retry: overrides.retry } : {}),\n          ...(overrides.memo !== undefined ? { memo: overrides.memo } : {}),\n          ...(overrides.staticDetails !== undefined\n            ? { staticDetails: overrides.staticDetails }\n            : {}),\n          ...(overrides.staticSummary !== undefined\n            ? { staticSummary: overrides.staticSummary }\n            : {}),\n        };\n\n        const handle = await this.scheduleClient.create({\n          scheduleId: options.scheduleId,\n          spec: options.spec,\n          action,\n          ...(options.policies !== undefined ? { policies: options.policies } : {}),\n          ...(options.state !== undefined ? { state: options.state } : {}),\n          ...(options.memo !== undefined ? { memo: options.memo } : {}),\n        });\n        return ok(wrapScheduleHandle(handle));\n      } catch (error) {\n        return err(new RuntimeClientError(\"schedule.create\", error));\n      }\n    };\n    return makeResultAsync(work);\n  }\n\n  /**\n   * Get a typed handle to an existing schedule. Does not validate that the\n   * schedule exists — handle methods (`describe`, `pause`, etc.) will\n   * surface a `RuntimeClientError` if the underlying ID is unknown.\n   */\n  getHandle(scheduleId: string): TypedScheduleHandle {\n    return wrapScheduleHandle(this.scheduleClient.getHandle(scheduleId));\n  }\n}\n\nfunction wrapScheduleHandle(handle: ScheduleHandle): TypedScheduleHandle {\n  return {\n    scheduleId: handle.scheduleId,\n    pause: (note) =>\n      ResultAsync.fromPromise(\n        handle.pause(note),\n        (error) => new RuntimeClientError(\"schedule.pause\", error),\n      ).map(() => undefined),\n    unpause: (note) =>\n      ResultAsync.fromPromise(\n        handle.unpause(note),\n        (error) => new RuntimeClientError(\"schedule.unpause\", error),\n      ).map(() => undefined),\n    trigger: (overlap) =>\n      ResultAsync.fromPromise(\n        handle.trigger(overlap),\n        (error) => new RuntimeClientError(\"schedule.trigger\", error),\n      ).map(() => undefined),\n    delete: () =>\n      ResultAsync.fromPromise(\n        handle.delete(),\n        (error) => new RuntimeClientError(\"schedule.delete\", error),\n      ).map(() => undefined),\n    describe: () =>\n      ResultAsync.fromPromise(\n        handle.describe(),\n        (error) => new RuntimeClientError(\"schedule.describe\", error),\n      ),\n  };\n}\n","import { Client, WorkflowHandle } from \"@temporalio/client\";\nimport type { WorkflowSignalWithStartOptions, WorkflowStartOptions } from \"@temporalio/client\";\nimport {\n  defineSearchAttributeKey,\n  type SearchAttributePair,\n  TypedSearchAttributes,\n} from \"@temporalio/common\";\nimport type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport type {\n  AnyWorkflowDefinition,\n  ContractDefinition,\n  SearchAttributeDefinition,\n  SearchAttributeKindToType,\n  SignalDefinition,\n  SignalNamesOf,\n} from \"@temporal-contract/contract\";\nimport type {\n  ClientInferInput,\n  ClientInferOutput,\n  ClientInferWorkflowQueries,\n  ClientInferWorkflowSignals,\n  ClientInferWorkflowUpdates,\n} from \"./types.js\";\nimport { ResultAsync, type Result, ok, err } from \"neverthrow\";\nimport {\n  type TemporalFailure,\n  WorkflowAlreadyStartedError,\n  WorkflowExecutionNotFoundError,\n  WorkflowFailedError,\n  WorkflowNotFoundError,\n  WorkflowValidationError,\n  QueryValidationError,\n  SignalValidationError,\n  UpdateValidationError,\n  RuntimeClientError,\n} from \"./errors.js\";\nimport { TypedScheduleClient } from \"./schedule.js\";\nimport {\n  classifyHandleError,\n  classifyResultError,\n  classifyStartError,\n  makeResultAsync,\n} from \"./internal.js\";\nimport { WorkflowExecutionAlreadyStartedError } from \"@temporalio/client\";\nimport { WorkflowFailedError as TemporalWorkflowFailedError } from \"@temporalio/client\";\nimport { WorkflowNotFoundError as TemporalWorkflowNotFoundError } from \"@temporalio/common\";\n\n/**\n * Typed `searchAttributes` map for a workflow, derived from the workflow's\n * declared `searchAttributes`. Each key is constrained to a declared\n * attribute name; each value's type is determined by the attribute's `kind`\n * (e.g. `KEYWORD` → `string`, `INT` → `number`, `DATETIME` → `Date`,\n * `KEYWORD_LIST` → `string[]`).\n *\n * If the workflow declares no search attributes, this resolves to `never`,\n * meaning the `searchAttributes` field is effectively absent from the start\n * options for that workflow.\n */\nexport type TypedSearchAttributeMap<TWorkflow extends AnyWorkflowDefinition> =\n  TWorkflow[\"searchAttributes\"] extends Record<string, SearchAttributeDefinition>\n    ? {\n        [K in keyof TWorkflow[\"searchAttributes\"]]?: SearchAttributeKindToType<\n          TWorkflow[\"searchAttributes\"][K][\"kind\"]\n        >;\n      }\n    : never;\n\nexport type TypedWorkflowStartOptions<\n  TContract extends ContractDefinition,\n  TWorkflowName extends keyof TContract[\"workflows\"] & string,\n> = Omit<\n  WorkflowStartOptions,\n  \"taskQueue\" | \"args\" | \"searchAttributes\" | \"typedSearchAttributes\"\n> & {\n  args: ClientInferInput<TContract[\"workflows\"][TWorkflowName]>;\n  /**\n   * Indexed search attributes for the started workflow. Keys and value types\n   * are constrained to those declared on the workflow's contract via\n   * `defineSearchAttribute`. Translated to Temporal's `typedSearchAttributes`\n   * before the start request is dispatched.\n   */\n  searchAttributes?: TypedSearchAttributeMap<TContract[\"workflows\"][TWorkflowName]>;\n};\n\n/**\n * Options for {@link TypedClient.signalWithStart} — typed against both the\n * workflow's input schema and the named signal's input schema.\n */\nexport type TypedSignalWithStartOptions<\n  TContract extends ContractDefinition,\n  TWorkflowName extends keyof TContract[\"workflows\"] & string,\n  TSignalName extends SignalNamesOf<TContract[\"workflows\"][TWorkflowName]>,\n> = Omit<\n  WorkflowSignalWithStartOptions,\n  \"taskQueue\" | \"args\" | \"signal\" | \"signalArgs\" | \"searchAttributes\" | \"typedSearchAttributes\"\n> & {\n  args: ClientInferInput<TContract[\"workflows\"][TWorkflowName]>;\n  signalName: TSignalName;\n  signalArgs: TContract[\"workflows\"][TWorkflowName][\"signals\"][TSignalName] extends SignalDefinition\n    ? ClientInferInput<TContract[\"workflows\"][TWorkflowName][\"signals\"][TSignalName]>\n    : never;\n  /**\n   * Indexed search attributes for the started workflow. Keys and value types\n   * are constrained to those declared on the workflow's contract via\n   * `defineSearchAttribute`. Translated to Temporal's `typedSearchAttributes`\n   * before the signalWithStart request is dispatched.\n   */\n  searchAttributes?: TypedSearchAttributeMap<TContract[\"workflows\"][TWorkflowName]>;\n};\n\n/**\n * Typed workflow handle returned by `signalWithStart`. Adds `signaledRunId`\n * to the standard handle so callers can correlate the signal with the\n * (possibly pre-existing) workflow execution chain.\n */\nexport type TypedWorkflowHandleWithSignaledRunId<TWorkflow extends AnyWorkflowDefinition> =\n  TypedWorkflowHandle<TWorkflow> & {\n    /**\n     * The Run Id of the bound Workflow at the time of `signalWithStart`. Since\n     * `signalWithStart` may have signaled an existing Workflow Chain, this is\n     * not necessarily the `firstExecutionRunId`.\n     */\n    readonly signaledRunId: string;\n  };\n\n/**\n * Translate the contract's typed `searchAttributes` map (declared\n * name → value) into a Temporal `TypedSearchAttributes` instance, so the\n * Temporal client honours indexing when starting the workflow.\n *\n * Workflows without a `searchAttributes` block (or callers passing no\n * values) skip the conversion entirely and return `undefined`, matching\n * the Temporal SDK's \"absent ≠ empty\" semantics.\n */\nfunction toTypedSearchAttributes(\n  workflowDef: AnyWorkflowDefinition,\n  values: Record<string, unknown> | undefined,\n): TypedSearchAttributes | undefined {\n  if (!values || !workflowDef.searchAttributes) return undefined;\n  const pairs: SearchAttributePair[] = [];\n  for (const [name, value] of Object.entries(values)) {\n    if (value === undefined) continue;\n    const def = (workflowDef.searchAttributes as Record<string, SearchAttributeDefinition>)[name];\n    if (!def) continue;\n    const key = defineSearchAttributeKey(name, def.kind);\n    pairs.push({ key, value } as SearchAttributePair);\n  }\n  return pairs.length > 0 ? new TypedSearchAttributes(pairs) : undefined;\n}\n\n/**\n * Typed workflow handle with validated results using neverthrow Result/ResultAsync\n */\nexport type TypedWorkflowHandle<TWorkflow extends AnyWorkflowDefinition> = {\n  workflowId: string;\n\n  /**\n   * Type-safe queries based on workflow definition with Result pattern\n   * Each query returns ResultAsync<T, Error> instead of Promise<T>\n   */\n  queries: {\n    [K in keyof ClientInferWorkflowQueries<TWorkflow>]: ClientInferWorkflowQueries<TWorkflow>[K] extends (\n      ...args: infer Args\n    ) => ResultAsync<infer R, Error>\n      ? (\n          ...args: Args\n        ) => ResultAsync<\n          R,\n          QueryValidationError | WorkflowExecutionNotFoundError | RuntimeClientError\n        >\n      : never;\n  };\n\n  /**\n   * Type-safe signals based on workflow definition with Result pattern\n   * Each signal returns ResultAsync<void, Error> instead of Promise<void>\n   */\n  signals: {\n    [K in keyof ClientInferWorkflowSignals<TWorkflow>]: ClientInferWorkflowSignals<TWorkflow>[K] extends (\n      ...args: infer Args\n    ) => ResultAsync<void, Error>\n      ? (\n          ...args: Args\n        ) => ResultAsync<\n          void,\n          SignalValidationError | WorkflowExecutionNotFoundError | RuntimeClientError\n        >\n      : never;\n  };\n\n  /**\n   * Type-safe updates based on workflow definition with Result pattern\n   * Each update returns ResultAsync<T, Error> instead of Promise<T>\n   */\n  updates: {\n    [K in keyof ClientInferWorkflowUpdates<TWorkflow>]: ClientInferWorkflowUpdates<TWorkflow>[K] extends (\n      ...args: infer Args\n    ) => ResultAsync<infer R, Error>\n      ? (\n          ...args: Args\n        ) => ResultAsync<\n          R,\n          UpdateValidationError | WorkflowExecutionNotFoundError | RuntimeClientError\n        >\n      : never;\n  };\n\n  /**\n   * Get workflow result with Result pattern\n   */\n  result: () => ResultAsync<\n    ClientInferOutput<TWorkflow>,\n    | WorkflowValidationError\n    | WorkflowFailedError\n    | WorkflowExecutionNotFoundError\n    | RuntimeClientError\n  >;\n\n  /**\n   * Terminate workflow with Result pattern\n   */\n  terminate: (\n    reason?: string,\n  ) => ResultAsync<void, WorkflowExecutionNotFoundError | RuntimeClientError>;\n\n  /**\n   * Cancel workflow with Result pattern\n   */\n  cancel: () => ResultAsync<void, WorkflowExecutionNotFoundError | RuntimeClientError>;\n\n  /**\n   * Get workflow execution description including status and metadata\n   */\n  describe: () => ResultAsync<\n    Awaited<ReturnType<WorkflowHandle[\"describe\"]>>,\n    WorkflowExecutionNotFoundError | RuntimeClientError\n  >;\n\n  /**\n   * Fetch the workflow execution history\n   */\n  fetchHistory: () => ResultAsync<\n    Awaited<ReturnType<WorkflowHandle[\"fetchHistory\"]>>,\n    WorkflowExecutionNotFoundError | RuntimeClientError\n  >;\n};\n\n/**\n * Result of {@link resolveDefinitionAndValidateInput} — the contract-side\n * pre-call ritual the start/signal-with-start/execute methods share. Holds\n * the resolved workflow definition, the schema-validated input, and the\n * translated typed search attributes (or `undefined` when the workflow\n * declared none / the caller passed none).\n */\ntype ResolvedWorkflow<TWorkflow extends AnyWorkflowDefinition> = {\n  definition: TWorkflow;\n  validatedInput: unknown;\n  typedSearchAttributes: TypedSearchAttributes | undefined;\n};\n\n/**\n * Shared pre-call ritual for the three contract-driven entry points that\n * actually start a workflow (`startWorkflow`, `signalWithStart`,\n * `executeWorkflow`):\n *\n *   1. Look up the workflow definition on the contract.\n *   2. Surface a `WorkflowNotFoundError` if absent.\n *   3. Validate `args` against the workflow's input schema.\n *   4. Surface a `WorkflowValidationError` if validation fails.\n *   5. Translate any caller-supplied `searchAttributes` into Temporal's\n *      `TypedSearchAttributes` shape (or `undefined`).\n *\n * `getHandle` deliberately keeps its own three-line lookup — it doesn't\n * accept `args` or `searchAttributes`, so it can't share this helper. The\n * call-specific extras (signal validation, post-call output validation,\n * extended error classification) stay at the call site — those are the\n * differentiators that make each method distinct.\n */\nasync function resolveDefinitionAndValidateInput<\n  TContract extends ContractDefinition,\n  TWorkflowName extends keyof TContract[\"workflows\"] & string,\n>(\n  contract: TContract,\n  workflowName: TWorkflowName,\n  args: unknown,\n  searchAttributes: Record<string, unknown> | undefined,\n): Promise<\n  Result<\n    ResolvedWorkflow<TContract[\"workflows\"][TWorkflowName]>,\n    WorkflowNotFoundError | WorkflowValidationError\n  >\n> {\n  const definition = contract.workflows[workflowName];\n  if (!definition) {\n    return err(createWorkflowNotFoundError(workflowName, contract));\n  }\n\n  const inputResult = await definition.input[\"~standard\"].validate(args);\n  if (inputResult.issues) {\n    return err(createWorkflowValidationError(workflowName, \"input\", inputResult.issues));\n  }\n\n  const typedSearchAttributes = toTypedSearchAttributes(definition, searchAttributes);\n\n  return ok({\n    definition: definition as TContract[\"workflows\"][TWorkflowName],\n    validatedInput: inputResult.value,\n    typedSearchAttributes,\n  });\n}\n\n/**\n * Typed Temporal client with neverthrow Result/ResultAsync pattern based on a contract\n *\n * Provides type-safe methods to start and execute workflows\n * defined in the contract, with explicit error handling using Result pattern.\n */\nexport class TypedClient<TContract extends ContractDefinition> {\n  /**\n   * Typed wrapper around Temporal's `client.schedule.create(...)` and\n   * related lifecycle methods. Fires the underlying `startWorkflow` action\n   * with args validated against the contract's input schema.\n   *\n   * **Requires `@temporalio/client` 1.16+.** The Schedule API was added in\n   * 1.16; on older versions this property is unset and any access throws.\n   * The package's peer dep is pinned to `^1.16.0` so the standard install\n   * paths surface a peer-dependency warning rather than a runtime crash.\n   *\n   * @example\n   * ```ts\n   * const result = await client.schedule.create(\"processOrder\", {\n   *   scheduleId: \"daily-sweep\",\n   *   spec: { cronExpressions: [\"0 2 * * *\"] },\n   *   args: { orderId: \"sweep\" },\n   * });\n   *\n   * result.match(\n   *   async (handle) => { await handle.pause(\"maintenance\"); },\n   *   (error) => console.error(\"schedule create failed\", error),\n   * );\n   * ```\n   */\n  readonly schedule: TypedScheduleClient<TContract>;\n\n  private constructor(\n    private readonly contract: TContract,\n    private readonly client: Client,\n  ) {\n    // `client.schedule` is the ScheduleClient wired into Temporal's\n    // top-level `Client` since 1.16. Fail early with a clear message if a\n    // consumer is on an older version (peer dep is pinned to ^1.16, but\n    // installs that ignore peer-dep warnings shouldn't crash with a\n    // confusing `Cannot read properties of undefined`).\n    if (!client.schedule) {\n      throw new Error(\n        \"TypedClient requires @temporalio/client >= 1.16 (the Schedule API was added in 1.16). \" +\n          \"Found a Client instance without a `schedule` property — please upgrade.\",\n      );\n    }\n    this.schedule = new TypedScheduleClient(contract, client.schedule);\n  }\n\n  /**\n   * Create a typed Temporal client with neverthrow pattern from a contract\n   *\n   * @example\n   * ```ts\n   * const connection = await Connection.connect();\n   * const temporalClient = new Client({ connection });\n   * const client = TypedClient.create(myContract, temporalClient);\n   *\n   * const result = await client.executeWorkflow('processOrder', {\n   *   workflowId: 'order-123',\n   *   args: { ... },\n   * });\n   *\n   * result.match(\n   *   (output) => console.log('Success:', output),\n   *   (error) => console.error('Failed:', error),\n   * );\n   * ```\n   */\n  static create<TContract extends ContractDefinition>(\n    contract: TContract,\n    client: Client,\n  ): TypedClient<TContract> {\n    return new TypedClient(contract, client);\n  }\n\n  /**\n   * Start a workflow and return a typed handle with ResultAsync pattern\n   *\n   * @example\n   * ```ts\n   * const handleResult = await client.startWorkflow('processOrder', {\n   *   workflowId: 'order-123',\n   *   args: { orderId: 'ORD-123' },\n   *   workflowExecutionTimeout: '1 day',\n   *   retry: { maximumAttempts: 3 },\n   * });\n   *\n   * handleResult.match(\n   *   async (handle) => {\n   *     const result = await handle.result();\n   *     // ... handle result\n   *   },\n   *   (error) => console.error('Failed to start:', error),\n   * );\n   * ```\n   */\n  startWorkflow<TWorkflowName extends keyof TContract[\"workflows\"] & string>(\n    workflowName: TWorkflowName,\n    {\n      args,\n      searchAttributes,\n      ...temporalOptions\n    }: TypedWorkflowStartOptions<TContract, TWorkflowName>,\n  ): ResultAsync<\n    TypedWorkflowHandle<TContract[\"workflows\"][TWorkflowName]>,\n    | WorkflowNotFoundError\n    | WorkflowValidationError\n    | WorkflowAlreadyStartedError\n    | RuntimeClientError\n  > {\n    type Ok = TypedWorkflowHandle<TContract[\"workflows\"][TWorkflowName]>;\n    type Err =\n      | WorkflowNotFoundError\n      | WorkflowValidationError\n      | WorkflowAlreadyStartedError\n      | RuntimeClientError;\n    const work = async (): Promise<Result<Ok, Err>> => {\n      const resolved = await resolveDefinitionAndValidateInput(\n        this.contract,\n        workflowName,\n        args,\n        searchAttributes as Record<string, unknown> | undefined,\n      );\n      if (resolved.isErr()) return err(resolved.error);\n      const { definition, validatedInput, typedSearchAttributes } = resolved.value;\n\n      try {\n        const handle = await this.client.workflow.start(workflowName, {\n          ...temporalOptions,\n          taskQueue: this.contract.taskQueue,\n          args: [validatedInput],\n          ...(typedSearchAttributes ? { typedSearchAttributes } : {}),\n        });\n        return ok(this.createTypedHandle(handle, definition) as Ok);\n      } catch (error) {\n        return err(classifyStartError(\"startWorkflow\", error));\n      }\n    };\n    return makeResultAsync(work);\n  }\n\n  /**\n   * Send a signal to a workflow, starting it first if it doesn't already exist.\n   *\n   * Validates both halves of the call against the contract:\n   * - `args` against the workflow's input schema\n   * - `signalArgs` against the named signal's input schema\n   *\n   * Returns a `TypedWorkflowHandleWithSignaledRunId` — the same shape as\n   * `startWorkflow`'s handle, plus a `signaledRunId` field for correlating\n   * the signal with the (possibly pre-existing) workflow execution chain.\n   *\n   * @example\n   * ```ts\n   * const result = await client.signalWithStart('processOrder', {\n   *   workflowId: 'order-123',\n   *   args: { orderId: 'ORD-123', customerId: 'CUST-1' },\n   *   signalName: 'cancel',\n   *   signalArgs: { reason: 'duplicate' },\n   * });\n   *\n   * result.match(\n   *   (handle) => console.log('signaled run', handle.signaledRunId),\n   *   (error) => console.error('signalWithStart failed', error),\n   * );\n   * ```\n   */\n  signalWithStart<\n    TWorkflowName extends keyof TContract[\"workflows\"] & string,\n    TSignalName extends SignalNamesOf<TContract[\"workflows\"][TWorkflowName]>,\n  >(\n    workflowName: TWorkflowName,\n    {\n      args,\n      signalName,\n      signalArgs,\n      searchAttributes,\n      ...temporalOptions\n    }: TypedSignalWithStartOptions<TContract, TWorkflowName, TSignalName>,\n  ): ResultAsync<\n    TypedWorkflowHandleWithSignaledRunId<TContract[\"workflows\"][TWorkflowName]>,\n    | WorkflowNotFoundError\n    | WorkflowValidationError\n    | SignalValidationError\n    | WorkflowAlreadyStartedError\n    | RuntimeClientError\n  > {\n    type Ok = TypedWorkflowHandleWithSignaledRunId<TContract[\"workflows\"][TWorkflowName]>;\n    type Err =\n      | WorkflowNotFoundError\n      | WorkflowValidationError\n      | SignalValidationError\n      | WorkflowAlreadyStartedError\n      | RuntimeClientError;\n\n    const work = async (): Promise<Result<Ok, Err>> => {\n      const resolved = await resolveDefinitionAndValidateInput(\n        this.contract,\n        workflowName,\n        args,\n        searchAttributes as Record<string, unknown> | undefined,\n      );\n      if (resolved.isErr()) return err(resolved.error);\n      const { definition, validatedInput, typedSearchAttributes } = resolved.value;\n\n      // Validate signal input — call-site-specific, kept inline.\n      const signalDef = (definition.signals as Record<string, SignalDefinition> | undefined)?.[\n        signalName\n      ];\n      if (!signalDef) {\n        // Type-level constraint should already prevent this; defensive for\n        // raw-call / union-typed-name corner cases.\n        return err(\n          new SignalValidationError(signalName, [\n            {\n              message: `Signal \"${signalName}\" is not declared on workflow \"${workflowName}\".`,\n            },\n          ]),\n        );\n      }\n      const signalInputResult = await signalDef.input[\"~standard\"].validate(signalArgs);\n      if (signalInputResult.issues) {\n        return err(new SignalValidationError(signalName, signalInputResult.issues));\n      }\n\n      try {\n        const handle = await this.client.workflow.signalWithStart(workflowName, {\n          ...temporalOptions,\n          taskQueue: this.contract.taskQueue,\n          args: [validatedInput],\n          signal: signalName,\n          signalArgs: [signalInputResult.value],\n          ...(typedSearchAttributes ? { typedSearchAttributes } : {}),\n        });\n        const typed = this.createTypedHandle(handle, definition) as TypedWorkflowHandle<\n          TContract[\"workflows\"][TWorkflowName]\n        >;\n        return ok({ ...typed, signaledRunId: handle.signaledRunId } as Ok);\n      } catch (error) {\n        return err(classifyStartError(\"signalWithStart\", error));\n      }\n    };\n    return makeResultAsync(work);\n  }\n\n  /**\n   * Execute a workflow (start and wait for result) with ResultAsync pattern\n   *\n   * @example\n   * ```ts\n   * const result = await client.executeWorkflow('processOrder', {\n   *   workflowId: 'order-123',\n   *   args: { orderId: 'ORD-123' },\n   *   workflowExecutionTimeout: '1 day',\n   *   retry: { maximumAttempts: 3 },\n   * });\n   *\n   * result.match(\n   *   (output) => console.log('Order processed:', output.status),\n   *   (error) => console.error('Processing failed:', error),\n   * );\n   * ```\n   */\n  executeWorkflow<TWorkflowName extends keyof TContract[\"workflows\"] & string>(\n    workflowName: TWorkflowName,\n    {\n      args,\n      searchAttributes,\n      ...temporalOptions\n    }: TypedWorkflowStartOptions<TContract, TWorkflowName>,\n  ): ResultAsync<\n    ClientInferOutput<TContract[\"workflows\"][TWorkflowName]>,\n    | WorkflowNotFoundError\n    | WorkflowValidationError\n    | WorkflowAlreadyStartedError\n    | WorkflowFailedError\n    | WorkflowExecutionNotFoundError\n    | RuntimeClientError\n  > {\n    type Ok = ClientInferOutput<TContract[\"workflows\"][TWorkflowName]>;\n    type Err =\n      | WorkflowNotFoundError\n      | WorkflowValidationError\n      | WorkflowAlreadyStartedError\n      | WorkflowFailedError\n      | WorkflowExecutionNotFoundError\n      | RuntimeClientError;\n    const work = async (): Promise<Result<Ok, Err>> => {\n      const resolved = await resolveDefinitionAndValidateInput(\n        this.contract,\n        workflowName,\n        args,\n        searchAttributes as Record<string, unknown> | undefined,\n      );\n      if (resolved.isErr()) return err(resolved.error);\n      const { definition, validatedInput, typedSearchAttributes } = resolved.value;\n\n      try {\n        const result = await this.client.workflow.execute(workflowName, {\n          ...temporalOptions,\n          taskQueue: this.contract.taskQueue,\n          args: [validatedInput],\n          ...(typedSearchAttributes ? { typedSearchAttributes } : {}),\n        });\n\n        // Output validation runs *after* the Temporal call returns — kept\n        // inline because it's specific to executeWorkflow's start-and-wait\n        // shape; the helper only handles pre-call concerns.\n        const outputResult = await definition.output[\"~standard\"].validate(result);\n        if (outputResult.issues) {\n          return err(createWorkflowValidationError(workflowName, \"output\", outputResult.issues));\n        }\n\n        return ok(outputResult.value as Ok);\n      } catch (error) {\n        // executeWorkflow combines start + result, so it can surface any of\n        // the discriminated kinds. Inline the three checks rather than\n        // routing through a dedicated helper — this is the only call site\n        // that needs the full union.\n        if (error instanceof WorkflowExecutionAlreadyStartedError) {\n          return err(new WorkflowAlreadyStartedError(error.workflowType, error.workflowId, error));\n        }\n        if (error instanceof TemporalWorkflowFailedError) {\n          // Forward Temporal's nested cause directly — see\n          // {@link classifyResultError} for the same rationale: Temporal's\n          // `WorkflowFailedError` is a wrapper, and the actionable failure\n          // (ApplicationFailure, CancelledFailure, etc.) lives on `.cause`.\n          // Temporal types `cause` as `Error | undefined`, but the SDK only\n          // ever populates it with a `TemporalFailure` subclass here; narrow\n          // with the public union so the typed `cause` lines up with the\n          // surfaced `WorkflowFailedError`.\n          return err(\n            new WorkflowFailedError(\n              temporalOptions.workflowId,\n              error.cause as TemporalFailure | undefined,\n            ),\n          );\n        }\n        if (error instanceof TemporalWorkflowNotFoundError) {\n          return err(\n            new WorkflowExecutionNotFoundError(\n              error.workflowId || temporalOptions.workflowId,\n              error.runId,\n              error,\n            ),\n          );\n        }\n        return err(createRuntimeClientError(\"executeWorkflow\", error));\n      }\n    };\n    return makeResultAsync(work);\n  }\n\n  /**\n   * Get a handle to an existing workflow with ResultAsync pattern\n   *\n   * @example\n   * ```ts\n   * const handleResult = await client.getHandle('processOrder', 'order-123');\n   * handleResult.match(\n   *   async (handle) => {\n   *     const result = await handle.result();\n   *     // ... handle result\n   *   },\n   *   (error) => console.error('Failed to get handle:', error),\n   * );\n   * ```\n   */\n  getHandle<TWorkflowName extends keyof TContract[\"workflows\"] & string>(\n    workflowName: TWorkflowName,\n    workflowId: string,\n  ): ResultAsync<\n    TypedWorkflowHandle<TContract[\"workflows\"][TWorkflowName]>,\n    WorkflowNotFoundError | RuntimeClientError\n  > {\n    type Ok = TypedWorkflowHandle<TContract[\"workflows\"][TWorkflowName]>;\n    type Err = WorkflowNotFoundError | RuntimeClientError;\n    const work = async (): Promise<Result<Ok, Err>> => {\n      const definition = this.contract.workflows[workflowName];\n      if (!definition) {\n        return err(createWorkflowNotFoundError(workflowName, this.contract));\n      }\n\n      try {\n        const handle = this.client.workflow.getHandle(workflowId);\n        return ok(this.createTypedHandle(handle, definition) as Ok);\n      } catch (error) {\n        return err(createRuntimeClientError(\"getHandle\", error));\n      }\n    };\n    return makeResultAsync(work);\n  }\n\n  private createTypedHandle<TWorkflow extends AnyWorkflowDefinition>(\n    workflowHandle: WorkflowHandle,\n    definition: TWorkflow,\n  ): TypedWorkflowHandle<TWorkflow> {\n    const queries = buildValidatedProxy({\n      defs: definition.queries,\n      operation: \"query\",\n      workflowId: workflowHandle.workflowId,\n      makeValidationError: (name, direction, issues) =>\n        new QueryValidationError(name, direction, issues),\n      invoke: (name, validated) => workflowHandle.query(name, validated),\n      validateOutput: (def) => def.output,\n    }) as TypedWorkflowHandle<TWorkflow>[\"queries\"];\n\n    const signals = buildValidatedProxy({\n      defs: definition.signals,\n      operation: \"signal\",\n      workflowId: workflowHandle.workflowId,\n      makeValidationError: (name, _direction, issues) => new SignalValidationError(name, issues),\n      invoke: async (name, validated) => {\n        await workflowHandle.signal(name, validated);\n        return undefined;\n      },\n      validateOutput: () => null,\n    }) as TypedWorkflowHandle<TWorkflow>[\"signals\"];\n\n    const updates = buildValidatedProxy({\n      defs: definition.updates,\n      operation: \"update\",\n      workflowId: workflowHandle.workflowId,\n      makeValidationError: (name, direction, issues) =>\n        new UpdateValidationError(name, direction, issues),\n      invoke: (name, validated) => workflowHandle.executeUpdate(name, { args: [validated] }),\n      validateOutput: (def) => def.output,\n    }) as TypedWorkflowHandle<TWorkflow>[\"updates\"];\n\n    return {\n      workflowId: workflowHandle.workflowId,\n      queries,\n      signals,\n      updates,\n      result: (): ResultAsync<\n        ClientInferOutput<TWorkflow>,\n        | WorkflowValidationError\n        | WorkflowFailedError\n        | WorkflowExecutionNotFoundError\n        | RuntimeClientError\n      > => {\n        type Ok = ClientInferOutput<TWorkflow>;\n        type Err =\n          | WorkflowValidationError\n          | WorkflowFailedError\n          | WorkflowExecutionNotFoundError\n          | RuntimeClientError;\n        const work = async (): Promise<Result<Ok, Err>> => {\n          try {\n            const result = await workflowHandle.result();\n            const outputResult = await definition.output[\"~standard\"].validate(result);\n            if (outputResult.issues) {\n              return err(\n                new WorkflowValidationError(\n                  workflowHandle.workflowId,\n                  \"output\",\n                  outputResult.issues,\n                ),\n              );\n            }\n            return ok(outputResult.value as Ok);\n          } catch (error) {\n            return err(classifyResultError(\"result\", error, workflowHandle.workflowId));\n          }\n        };\n        return makeResultAsync(work);\n      },\n      terminate: (\n        reason?: string,\n      ): ResultAsync<void, WorkflowExecutionNotFoundError | RuntimeClientError> =>\n        ResultAsync.fromPromise(workflowHandle.terminate(reason), (error) =>\n          classifyHandleError(\"terminate\", error, workflowHandle.workflowId),\n        ).map(() => undefined),\n      cancel: (): ResultAsync<void, WorkflowExecutionNotFoundError | RuntimeClientError> =>\n        ResultAsync.fromPromise(workflowHandle.cancel(), (error) =>\n          classifyHandleError(\"cancel\", error, workflowHandle.workflowId),\n        ).map(() => undefined),\n      describe: (): ResultAsync<\n        Awaited<ReturnType<WorkflowHandle[\"describe\"]>>,\n        WorkflowExecutionNotFoundError | RuntimeClientError\n      > =>\n        ResultAsync.fromPromise(workflowHandle.describe(), (error) =>\n          classifyHandleError(\"describe\", error, workflowHandle.workflowId),\n        ),\n      fetchHistory: (): ResultAsync<\n        Awaited<ReturnType<WorkflowHandle[\"fetchHistory\"]>>,\n        WorkflowExecutionNotFoundError | RuntimeClientError\n      > =>\n        ResultAsync.fromPromise(workflowHandle.fetchHistory(), (error) =>\n          classifyHandleError(\"fetchHistory\", error, workflowHandle.workflowId),\n        ),\n    };\n  }\n}\n\nfunction createRuntimeClientError(operation: string, error: unknown): RuntimeClientError {\n  return new RuntimeClientError(operation, error);\n}\n\nfunction createWorkflowNotFoundError(\n  workflowName: string | number | symbol,\n  contract: ContractDefinition,\n): WorkflowNotFoundError {\n  return new WorkflowNotFoundError(String(workflowName), Object.keys(contract.workflows));\n}\n\nfunction createWorkflowValidationError(\n  workflowName: string | number | symbol,\n  direction: \"input\" | \"output\",\n  issues: ReadonlyArray<StandardSchemaV1.Issue>,\n): WorkflowValidationError {\n  return new WorkflowValidationError(String(workflowName), direction, issues);\n}\n\ntype DefWithInput = { readonly input: StandardSchemaV1 };\n\ntype ProxyOptions<TDef extends DefWithInput, TValidationError extends Error> = {\n  readonly defs: Record<string, TDef> | undefined;\n  readonly operation: string;\n  /**\n   * Workflow ID of the handle these proxies bind to. Used by\n   * {@link classifyHandleError} to surface\n   * {@link WorkflowExecutionNotFoundError} with the targeted ID even when\n   * Temporal's error doesn't carry it.\n   */\n  readonly workflowId: string;\n  readonly makeValidationError: (\n    name: string,\n    direction: \"input\" | \"output\",\n    issues: ReadonlyArray<StandardSchemaV1.Issue>,\n  ) => TValidationError;\n  readonly invoke: (name: string, validatedInput: unknown) => Promise<unknown>;\n  /**\n   * Returns the schema to validate the invoke result against, or `null` to skip\n   * output validation (used by signals, which don't return a value).\n   */\n  readonly validateOutput: (def: TDef) => StandardSchemaV1 | null;\n};\n\n/**\n * Build a `{ name: (args) => ResultAsync<...> }` proxy for a contract's\n * queries/signals/updates. The three call sites differ only in how they\n * invoke Temporal and whether they validate output, so the shared\n * input-validate → invoke → output-validate → wrap-Result pipeline lives\n * here once.\n */\nfunction buildValidatedProxy<TDef extends DefWithInput, TValidationError extends Error>({\n  defs,\n  operation,\n  workflowId,\n  makeValidationError,\n  invoke,\n  validateOutput,\n}: ProxyOptions<TDef, TValidationError>): Record<\n  string,\n  (\n    args: unknown,\n  ) => ResultAsync<unknown, TValidationError | WorkflowExecutionNotFoundError | RuntimeClientError>\n> {\n  const proxy: Record<\n    string,\n    (\n      args: unknown,\n    ) => ResultAsync<\n      unknown,\n      TValidationError | WorkflowExecutionNotFoundError | RuntimeClientError\n    >\n  > = {};\n  if (!defs) return proxy;\n\n  for (const [name, def] of Object.entries(defs)) {\n    proxy[name] = (args) => {\n      const work = async (): Promise<\n        Result<unknown, TValidationError | WorkflowExecutionNotFoundError | RuntimeClientError>\n      > => {\n        const inputResult = await def.input[\"~standard\"].validate(args);\n        if (inputResult.issues) {\n          return err(makeValidationError(name, \"input\", inputResult.issues));\n        }\n\n        try {\n          const result = await invoke(name, inputResult.value);\n          const outputSchema = validateOutput(def);\n          if (!outputSchema) {\n            return ok(result);\n          }\n          const outputResult = await outputSchema[\"~standard\"].validate(result);\n          if (outputResult.issues) {\n            return err(makeValidationError(name, \"output\", outputResult.issues));\n          }\n          return ok(outputResult.value);\n        } catch (error) {\n          return err(classifyHandleError(operation, error, workflowId));\n        }\n      };\n      return makeResultAsync(work);\n    };\n  }\n\n  return proxy;\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":["TemporalWorkflowNotFoundError","TemporalWorkflowFailedError","TemporalWorkflowFailedError","TemporalWorkflowNotFoundError"],"sources":["../src/errors.ts","../src/internal.ts","../src/schedule.ts","../src/client.ts"],"sourcesContent":["import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport { summarizeIssues } from \"@temporal-contract/contract\";\nimport type {\n  ActivityFailure,\n  ApplicationFailure,\n  CancelledFailure,\n  ChildWorkflowFailure,\n  ServerFailure,\n  TerminatedFailure,\n  TimeoutFailure,\n} from \"@temporalio/common\";\n\n/**\n * Union of the actionable Temporal failure types that can surface as the\n * `cause` of a `WorkflowFailedError`. These all extend Temporal's internal\n * `TemporalFailure` base class — we list them by leaf type rather than by\n * the base class so consumer code can use a single `switch (true)` over\n * `instanceof` discriminants without an exhaustiveness escape hatch.\n *\n * Re-exported from the package entry point so consumers can import it\n * directly: `import type { TemporalFailure } from \"@temporal-contract/client\"`.\n */\nexport type TemporalFailure =\n  | ApplicationFailure\n  | CancelledFailure\n  | TerminatedFailure\n  | TimeoutFailure\n  | ChildWorkflowFailure\n  | ServerFailure\n  | ActivityFailure;\n\n/**\n * Base class for all typed client errors with boxed pattern\n */\nabstract class TypedClientError extends Error {\n  protected constructor(message: string) {\n    super(message);\n    this.name = this.constructor.name;\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, this.constructor);\n    }\n  }\n}\n\n/**\n * Generic runtime failure wrapper when no specific error type applies\n */\nexport class RuntimeClientError extends TypedClientError {\n  constructor(\n    public readonly operation: string,\n    public override readonly cause?: unknown,\n  ) {\n    super(\n      `Operation \"${operation}\" failed: ${\n        cause instanceof Error ? cause.message : String(cause ?? \"unknown error\")\n      }`,\n    );\n  }\n}\n\n/**\n * Thrown when a workflow is not found in the contract\n */\nexport class WorkflowNotFoundError extends TypedClientError {\n  constructor(\n    public readonly workflowName: string,\n    public readonly availableWorkflows: string[],\n  ) {\n    super(\n      `Workflow \"${workflowName}\" not found in contract. Available workflows: ${availableWorkflows.join(\", \")}`,\n    );\n  }\n}\n\n/**\n * Discriminated variant of {@link RuntimeClientError} surfaced when starting\n * a workflow collides with an existing execution — Temporal's\n * `WorkflowExecutionAlreadyStartedError`. The most common cause is a\n * workflowId reuse policy that rejects duplicates while a previous run is\n * still in retention.\n *\n * Distinguishing this from `RuntimeClientError` lets idempotent callers\n * branch on it explicitly (e.g. fetch the existing handle and continue)\n * without inspecting `error.cause` against a Temporal SDK class.\n */\nexport class WorkflowAlreadyStartedError extends TypedClientError {\n  constructor(\n    public readonly workflowType: string,\n    public readonly workflowId: string,\n    public override readonly cause?: unknown,\n  ) {\n    super(`Workflow \"${workflowType}\" with ID \"${workflowId}\" is already started or in retention.`);\n  }\n}\n\n/**\n * Discriminated variant of {@link RuntimeClientError} surfaced when an\n * operation targets a workflow execution that doesn't exist in the\n * namespace — Temporal's `WorkflowNotFoundError` (distinct from this\n * package's contract-level {@link WorkflowNotFoundError}).\n *\n * Returned from:\n * - handle methods: `signal`, `query`, `executeUpdate`, `result`,\n *   `terminate`, `cancel`, `describe`, `fetchHistory`\n * - `executeWorkflow` (when the underlying execute call hits a missing\n *   execution mid-flight)\n */\nexport class WorkflowExecutionNotFoundError extends TypedClientError {\n  constructor(\n    public readonly workflowId: string,\n    public readonly runId?: string,\n    public override readonly cause?: unknown,\n  ) {\n    super(\n      `Workflow execution \"${workflowId}\"${runId ? ` (run \"${runId}\")` : \"\"} not found in namespace.`,\n    );\n  }\n}\n\n/**\n * Discriminated variant of {@link RuntimeClientError} surfaced when waiting\n * on a workflow's result and the workflow completes with a failure —\n * Temporal's `WorkflowFailedError`.\n *\n * `cause` is the *unwrapped* underlying {@link TemporalFailure} (typically an\n * `ApplicationFailure`, `CancelledFailure`, `TerminatedFailure`, or\n * `TimeoutFailure`) lifted from Temporal's wrapper, so callers can branch\n * on the failure category in one step (`err.cause instanceof\n * ApplicationFailure`) instead of unwrapping twice via the SDK wrapper. The\n * SDK declares `WorkflowFailedError.cause` as the wider `Error | undefined`\n * (since `cause` lives on `Error`), but the runtime guarantee — driven by\n * Temporal's wire format — is that it is always a `TemporalFailure` subclass\n * when the wrapper is surfaced. `classifyResultError` narrows that wider\n * static type to the public {@link TemporalFailure} union with a cast, so\n * consumers see the precise leaf-failure typing instead of a bare `Error`.\n *\n * Returned from `executeWorkflow` and `handle.result()`.\n */\nexport class WorkflowFailedError extends TypedClientError {\n  constructor(\n    public readonly workflowId: string,\n    public override readonly cause?: TemporalFailure,\n  ) {\n    const causeMessage =\n      cause instanceof Error ? cause.message : String(cause ?? \"unknown failure\");\n    super(`Workflow \"${workflowId}\" completed with failure: ${causeMessage}`);\n  }\n}\n\n// Validation-message formatters live in `@temporal-contract/contract` so\n// client and worker share a single source of truth. The previous local\n// copies have been removed in favor of the shared `summarizeIssues` import\n// at the top of this module.\n\n/**\n * Thrown when workflow input or output validation fails\n */\nexport class WorkflowValidationError extends TypedClientError {\n  constructor(\n    public readonly workflowName: string,\n    public readonly direction: \"input\" | \"output\",\n    public readonly issues: ReadonlyArray<StandardSchemaV1.Issue>,\n  ) {\n    super(\n      `Validation failed for workflow \"${workflowName}\" ${direction}: ${summarizeIssues(issues)}`,\n    );\n  }\n}\n\n/**\n * Thrown when query input or output validation fails\n */\nexport class QueryValidationError extends TypedClientError {\n  constructor(\n    public readonly queryName: string,\n    public readonly direction: \"input\" | \"output\",\n    public readonly issues: ReadonlyArray<StandardSchemaV1.Issue>,\n  ) {\n    super(`Validation failed for query \"${queryName}\" ${direction}: ${summarizeIssues(issues)}`);\n  }\n}\n\n/**\n * Thrown when signal input validation fails\n */\nexport class SignalValidationError extends TypedClientError {\n  constructor(\n    public readonly signalName: string,\n    public readonly issues: ReadonlyArray<StandardSchemaV1.Issue>,\n  ) {\n    super(`Validation failed for signal \"${signalName}\": ${summarizeIssues(issues)}`);\n  }\n}\n\n/**\n * Thrown when update input or output validation fails\n */\nexport class UpdateValidationError extends TypedClientError {\n  constructor(\n    public readonly updateName: string,\n    public readonly direction: \"input\" | \"output\",\n    public readonly issues: ReadonlyArray<StandardSchemaV1.Issue>,\n  ) {\n    super(`Validation failed for update \"${updateName}\" ${direction}: ${summarizeIssues(issues)}`);\n  }\n}\n","/**\n * Internal helpers shared across the client package's modules.\n *\n * Not part of the public API — this module is not listed in the package's\n * `exports` map, so consumers can't import from `@temporal-contract/client/internal`.\n * In-package modules and tests import it directly via relative path.\n */\nimport { WorkflowExecutionAlreadyStartedError } from \"@temporalio/client\";\nimport { WorkflowFailedError as TemporalWorkflowFailedError } from \"@temporalio/client\";\nimport {\n  defineSearchAttributeKey,\n  type SearchAttributePair,\n  TypedSearchAttributes,\n  WorkflowNotFoundError as TemporalWorkflowNotFoundError,\n} from \"@temporalio/common\";\nimport type { AnyWorkflowDefinition, SearchAttributeDefinition } from \"@temporal-contract/contract\";\nimport { _internal_makeResultAsync } from \"@temporal-contract/contract/result-async\";\nimport { ok, err, type ResultAsync, type Result } from \"neverthrow\";\nimport {\n  RuntimeClientError,\n  type TemporalFailure,\n  WorkflowAlreadyStartedError,\n  WorkflowExecutionNotFoundError,\n  WorkflowFailedError,\n} from \"./errors.js\";\n\n/**\n * Translate the contract's typed `searchAttributes` map (declared\n * name → value) into a Temporal `TypedSearchAttributes` instance, so the\n * Temporal client honours indexing when starting the workflow.\n *\n * Workflows without a `searchAttributes` block (or callers passing no\n * values) resolve to `ok(undefined)`, matching the Temporal SDK's\n * \"absent ≠ empty\" semantics.\n *\n * Returns `err(RuntimeClientError)` on unknown keys. The TypeScript\n * surface already gates the happy path; the runtime check catches typed\n * escape hatches (`as never`, `as any`, raw-call interop) where a typo\n * would otherwise silently drop the attribute, leaving the workflow\n * unindexed without any signal to the caller.\n */\nexport function toTypedSearchAttributes(\n  workflowDef: AnyWorkflowDefinition,\n  workflowName: string,\n  values: Record<string, unknown> | undefined,\n): Result<TypedSearchAttributes | undefined, RuntimeClientError> {\n  if (!values) return ok(undefined);\n  // Workflows that omit the `searchAttributes` block declare none. Treat\n  // that as an empty declared map so a caller passing values still hits\n  // the per-key \"undeclared\" check below — silently dropping them would\n  // re-introduce the escape-hatch gap this helper was designed to close.\n  const declared = (workflowDef.searchAttributes ?? {}) as Record<\n    string,\n    SearchAttributeDefinition\n  >;\n  const pairs: SearchAttributePair[] = [];\n  for (const [name, value] of Object.entries(values)) {\n    if (value === undefined) continue;\n    const def = declared[name];\n    if (!def) {\n      return err(\n        new RuntimeClientError(\n          \"searchAttributes\",\n          new Error(\n            `Search attribute \"${name}\" is not declared on workflow \"${workflowName}\". ` +\n              `Declared attributes: ${Object.keys(declared).join(\", \") || \"none\"}.`,\n          ),\n        ),\n      );\n    }\n    const key = defineSearchAttributeKey(name, def.kind);\n    pairs.push({ key, value } as SearchAttributePair);\n  }\n  return ok(pairs.length > 0 ? new TypedSearchAttributes(pairs) : undefined);\n}\n\n/**\n * Wrap an async result-producing function in a `ResultAsync`, catching any\n * unhandled rejection as a `RuntimeClientError(\"unexpected\", error)`.\n *\n * The work function is expected to handle its own domain errors and return\n * an `err(...)` for them; the catch here is a safety net for thrown\n * exceptions the work didn't anticipate.\n *\n * Used by `client.ts` (workflow operations) and `schedule.ts` (schedule\n * operations) so the unexpected-rejection shape is identical across the\n * typed client surface. Delegates to `_internal_makeResultAsync` from\n * `@temporal-contract/contract` so the same wrapper is shared between the\n * client and worker packages.\n */\nexport function makeResultAsync<T, E>(\n  work: () => Promise<Result<T, E>>,\n): ResultAsync<T, E | RuntimeClientError> {\n  return _internal_makeResultAsync<T, E | RuntimeClientError>(\n    work,\n    (e) => new RuntimeClientError(\"unexpected\", e),\n  );\n}\n\n/**\n * Map a thrown error from `client.workflow.start` / `signalWithStart` into\n * the discriminated union surfaced by the typed client. Specifically\n * recognizes Temporal's `WorkflowExecutionAlreadyStartedError`; everything\n * else falls through to {@link RuntimeClientError}.\n */\nexport function classifyStartError(\n  operation: string,\n  error: unknown,\n): WorkflowAlreadyStartedError | RuntimeClientError {\n  if (error instanceof WorkflowExecutionAlreadyStartedError) {\n    return new WorkflowAlreadyStartedError(error.workflowType, error.workflowId, error);\n  }\n  return new RuntimeClientError(operation, error);\n}\n\n/**\n * Map a thrown error from a workflow handle method (signal, query,\n * executeUpdate, terminate, cancel, describe, fetchHistory) into the\n * discriminated union surfaced by the typed client. Recognizes Temporal's\n * `WorkflowNotFoundError`; everything else falls through to\n * {@link RuntimeClientError}.\n *\n * `fallbackWorkflowId` is used when Temporal's error carries an empty\n * `workflowId` (it normalizes missing IDs to the empty string), so the\n * surfaced error always identifies the targeted execution.\n */\nexport function classifyHandleError(\n  operation: string,\n  error: unknown,\n  fallbackWorkflowId: string,\n): WorkflowExecutionNotFoundError | RuntimeClientError {\n  if (error instanceof TemporalWorkflowNotFoundError) {\n    return new WorkflowExecutionNotFoundError(\n      error.workflowId || fallbackWorkflowId,\n      error.runId,\n      error,\n    );\n  }\n  return new RuntimeClientError(operation, error);\n}\n\n/**\n * Map a thrown error from `handle.result()` / `client.workflow.execute()`\n * (the latter when waiting on the result phase). Recognizes Temporal's\n * `WorkflowFailedError` and `WorkflowNotFoundError`; everything else falls\n * through to {@link RuntimeClientError}.\n *\n * Temporal's `WorkflowFailedError` is itself a wrapper — the actionable\n * failure (ApplicationFailure, CancelledFailure, TerminatedFailure, etc.)\n * lives on its `cause` field. We forward that inner cause directly so\n * consumers can match `err.cause` against the underlying failure class\n * without an extra unwrap step. (If Temporal's cause is `undefined`, our\n * `cause` is too — same shape as before.)\n */\nexport function classifyResultError(\n  operation: string,\n  error: unknown,\n  workflowId: string,\n): WorkflowFailedError | WorkflowExecutionNotFoundError | RuntimeClientError {\n  if (error instanceof TemporalWorkflowFailedError) {\n    // Temporal types `cause` as `Error | undefined`, but the SDK only ever\n    // populates it with a `TemporalFailure` subclass when surfacing a\n    // workflow result failure. Narrow with the public union so consumers\n    // can branch on the leaf failure types without an extra cast.\n    return new WorkflowFailedError(workflowId, error.cause as TemporalFailure | undefined);\n  }\n  if (error instanceof TemporalWorkflowNotFoundError) {\n    return new WorkflowExecutionNotFoundError(error.workflowId || workflowId, error.runId, error);\n  }\n  return new RuntimeClientError(operation, error);\n}\n","import type {\n  ScheduleClient,\n  ScheduleDescription,\n  ScheduleHandle,\n  ScheduleOptions,\n  ScheduleOptionsStartWorkflowAction,\n  ScheduleOverlapPolicy,\n  ScheduleSpec,\n} from \"@temporalio/client\";\nimport type { ContractDefinition } from \"@temporal-contract/contract\";\nimport { ResultAsync, type Result, ok, err } from \"neverthrow\";\nimport type { TypedSearchAttributeMap } from \"./client.js\";\nimport type { ClientInferInput } from \"./types.js\";\nimport { RuntimeClientError, WorkflowNotFoundError, WorkflowValidationError } from \"./errors.js\";\nimport { makeResultAsync, toTypedSearchAttributes } from \"./internal.js\";\n\n/**\n * Workflow-action–level overrides forwarded to Temporal's\n * `ScheduleOptionsStartWorkflowAction`. These live under a nested `action`\n * field so the workflow-level `memo` (per-action workflow metadata) can be\n * set independently from the schedule-level `memo` (metadata on the\n * schedule itself) — Temporal honours both, and they have separate\n * lifecycles.\n *\n * `workflowType` and `taskQueue` are owned by the contract and not exposed.\n */\nexport type TypedScheduleActionOverrides = Pick<\n  ScheduleOptionsStartWorkflowAction<never>,\n  | \"workflowId\"\n  | \"workflowExecutionTimeout\"\n  | \"workflowRunTimeout\"\n  | \"workflowTaskTimeout\"\n  | \"retry\"\n  | \"memo\"\n  | \"staticDetails\"\n  | \"staticSummary\"\n>;\n\n/**\n * Options for {@link TypedScheduleClient.create}.\n *\n * `scheduleId` and `spec` come from Temporal's `ScheduleOptions`. `args` is\n * typed against the destination workflow's input schema. `policies`,\n * `state`, and `memo` mirror Temporal's own schedule-level options.\n * Workflow-action–level overrides nest under {@link action} so memo and\n * other fields with the same name don't collide between the two scopes.\n */\nexport type TypedScheduleCreateOptions<\n  TContract extends ContractDefinition,\n  TWorkflowName extends keyof TContract[\"workflows\"] & string,\n> = {\n  /** Schedule ID. Recommended to use a meaningful business identifier. */\n  scheduleId: string;\n  /** When the schedule should fire (cron, interval, calendar). */\n  spec: ScheduleSpec;\n  /** Workflow input — validated against the contract's input schema. */\n  args: ClientInferInput<TContract[\"workflows\"][TWorkflowName]>;\n  /**\n   * Indexed search attributes for each workflow run spawned by this\n   * schedule. Keys and value types are constrained to those declared on\n   * the destination workflow's contract via `defineSearchAttribute`.\n   * Translated to Temporal's `typedSearchAttributes` and attached to the\n   * schedule's `startWorkflow` action so each spawned run is indexed\n   * identically to one started directly via `client.startWorkflow`.\n   */\n  searchAttributes?: TypedSearchAttributeMap<TContract[\"workflows\"][TWorkflowName]>;\n  /** Temporal schedule policies (overlap, catchupWindow, pauseOnFailure, etc.). */\n  policies?: ScheduleOptions[\"policies\"];\n  /** Temporal schedule state (paused, note, limited, etc.). */\n  state?: ScheduleOptions[\"state\"];\n  /** Schedule-level memo (non-indexed metadata on the schedule itself). */\n  memo?: ScheduleOptions[\"memo\"];\n  /**\n   * Workflow-action–level overrides. `workflowType` and `taskQueue` are\n   * derived from the contract, so they don't appear here. Note that\n   * `action.memo` is a *workflow-level* memo applied to each spawned run,\n   * distinct from the top-level `memo` (which is metadata on the schedule\n   * itself).\n   */\n  action?: TypedScheduleActionOverrides;\n};\n\n/**\n * Typed handle to a schedule. Mirrors Temporal's `ScheduleHandle` lifecycle\n * methods (`pause`, `unpause`, `trigger`, `describe`, `delete`) wrapped in\n * the neverthrow ResultAsync pattern so call sites match the rest of the\n * typed client.\n */\nexport type TypedScheduleHandle = {\n  /** This schedule's identifier. */\n  readonly scheduleId: string;\n  /** Pause the schedule. Optional note becomes part of the audit trail. */\n  pause: (note?: string) => ResultAsync<void, RuntimeClientError>;\n  /** Resume a paused schedule. */\n  unpause: (note?: string) => ResultAsync<void, RuntimeClientError>;\n  /** Fire the schedule's action immediately. */\n  trigger: (overlap?: ScheduleOverlapPolicy) => ResultAsync<void, RuntimeClientError>;\n  /** Delete the schedule. */\n  delete: () => ResultAsync<void, RuntimeClientError>;\n  /** Fetch the schedule's current description from the server. */\n  describe: () => ResultAsync<ScheduleDescription, RuntimeClientError>;\n};\n\n/**\n * Typed wrapper around Temporal's `ScheduleClient`. Exposed as\n * `typedClient.schedule` — keeps the typed-client surface organized the\n * same way Temporal's own `Client.schedule` does.\n */\nexport class TypedScheduleClient<TContract extends ContractDefinition> {\n  constructor(\n    private readonly contract: TContract,\n    private readonly scheduleClient: ScheduleClient,\n  ) {}\n\n  /**\n   * Create a new schedule that, on each fire, starts the named contract\n   * workflow with validated args.\n   *\n   * Validates `args` against the workflow's input schema before dispatching\n   * the create request to Temporal. The workflow's `taskQueue` and\n   * `workflowType` are pulled from the contract automatically; the typed\n   * options shape omits them so call sites don't have to repeat themselves.\n   */\n  create<TWorkflowName extends keyof TContract[\"workflows\"] & string>(\n    workflowName: TWorkflowName,\n    options: TypedScheduleCreateOptions<TContract, TWorkflowName>,\n  ): ResultAsync<\n    TypedScheduleHandle,\n    WorkflowNotFoundError | WorkflowValidationError | RuntimeClientError\n  > {\n    type Ok = TypedScheduleHandle;\n    type Err = WorkflowNotFoundError | WorkflowValidationError | RuntimeClientError;\n    const work = async (): Promise<Result<Ok, Err>> => {\n      const definition = this.contract.workflows[workflowName];\n      if (!definition) {\n        return err(new WorkflowNotFoundError(workflowName, Object.keys(this.contract.workflows)));\n      }\n\n      const inputResult = await definition.input[\"~standard\"].validate(options.args);\n      if (inputResult.issues) {\n        return err(new WorkflowValidationError(workflowName, \"input\", inputResult.issues));\n      }\n\n      // Translate typed search attributes for the spawned workflow runs.\n      // Lives on the schedule's `startWorkflow` action (workflow-level\n      // indexing), not on the schedule itself. Mirrors what\n      // `client.startWorkflow` does for direct starts so schedule-spawned\n      // runs share visibility with their direct-start counterparts.\n      const searchAttributesResult = toTypedSearchAttributes(\n        definition,\n        workflowName,\n        options.searchAttributes as Record<string, unknown> | undefined,\n      );\n      if (searchAttributesResult.isErr()) return err(searchAttributesResult.error);\n      const typedSearchAttributes = searchAttributesResult.value;\n\n      try {\n        const overrides = options.action ?? {};\n        const action: ScheduleOptionsStartWorkflowAction<never> = {\n          type: \"startWorkflow\",\n          workflowType: workflowName,\n          taskQueue: this.contract.taskQueue,\n          args: [inputResult.value] as never,\n          ...(typedSearchAttributes ? { typedSearchAttributes } : {}),\n          ...(overrides.workflowId !== undefined ? { workflowId: overrides.workflowId } : {}),\n          ...(overrides.workflowExecutionTimeout !== undefined\n            ? { workflowExecutionTimeout: overrides.workflowExecutionTimeout }\n            : {}),\n          ...(overrides.workflowRunTimeout !== undefined\n            ? { workflowRunTimeout: overrides.workflowRunTimeout }\n            : {}),\n          ...(overrides.workflowTaskTimeout !== undefined\n            ? { workflowTaskTimeout: overrides.workflowTaskTimeout }\n            : {}),\n          ...(overrides.retry !== undefined ? { retry: overrides.retry } : {}),\n          ...(overrides.memo !== undefined ? { memo: overrides.memo } : {}),\n          ...(overrides.staticDetails !== undefined\n            ? { staticDetails: overrides.staticDetails }\n            : {}),\n          ...(overrides.staticSummary !== undefined\n            ? { staticSummary: overrides.staticSummary }\n            : {}),\n        };\n\n        const handle = await this.scheduleClient.create({\n          scheduleId: options.scheduleId,\n          spec: options.spec,\n          action,\n          ...(options.policies !== undefined ? { policies: options.policies } : {}),\n          ...(options.state !== undefined ? { state: options.state } : {}),\n          ...(options.memo !== undefined ? { memo: options.memo } : {}),\n        });\n        return ok(wrapScheduleHandle(handle));\n      } catch (error) {\n        return err(new RuntimeClientError(\"schedule.create\", error));\n      }\n    };\n    return makeResultAsync(work);\n  }\n\n  /**\n   * Get a typed handle to an existing schedule. Does not validate that the\n   * schedule exists — handle methods (`describe`, `pause`, etc.) will\n   * surface a `RuntimeClientError` if the underlying ID is unknown.\n   */\n  getHandle(scheduleId: string): TypedScheduleHandle {\n    return wrapScheduleHandle(this.scheduleClient.getHandle(scheduleId));\n  }\n}\n\nfunction wrapScheduleHandle(handle: ScheduleHandle): TypedScheduleHandle {\n  return {\n    scheduleId: handle.scheduleId,\n    pause: (note) =>\n      ResultAsync.fromPromise(\n        handle.pause(note),\n        (error) => new RuntimeClientError(\"schedule.pause\", error),\n      ).map(() => undefined),\n    unpause: (note) =>\n      ResultAsync.fromPromise(\n        handle.unpause(note),\n        (error) => new RuntimeClientError(\"schedule.unpause\", error),\n      ).map(() => undefined),\n    trigger: (overlap) =>\n      ResultAsync.fromPromise(\n        handle.trigger(overlap),\n        (error) => new RuntimeClientError(\"schedule.trigger\", error),\n      ).map(() => undefined),\n    delete: () =>\n      ResultAsync.fromPromise(\n        handle.delete(),\n        (error) => new RuntimeClientError(\"schedule.delete\", error),\n      ).map(() => undefined),\n    describe: () =>\n      ResultAsync.fromPromise(\n        handle.describe(),\n        (error) => new RuntimeClientError(\"schedule.describe\", error),\n      ),\n  };\n}\n","import { Client, WorkflowHandle } from \"@temporalio/client\";\nimport type { WorkflowSignalWithStartOptions, WorkflowStartOptions } from \"@temporalio/client\";\nimport { defineSearchAttributeKey, TypedSearchAttributes } from \"@temporalio/common\";\nimport type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport type {\n  AnyWorkflowDefinition,\n  ContractDefinition,\n  SearchAttributeDefinition,\n  SearchAttributeKindToType,\n  SignalDefinition,\n  SignalNamesOf,\n} from \"@temporal-contract/contract\";\nimport type {\n  ClientInferInput,\n  ClientInferOutput,\n  ClientInferWorkflowQueries,\n  ClientInferWorkflowSignals,\n  ClientInferWorkflowUpdates,\n} from \"./types.js\";\nimport { ResultAsync, type Result, ok, err } from \"neverthrow\";\nimport {\n  type TemporalFailure,\n  WorkflowAlreadyStartedError,\n  WorkflowExecutionNotFoundError,\n  WorkflowFailedError,\n  WorkflowNotFoundError,\n  WorkflowValidationError,\n  QueryValidationError,\n  SignalValidationError,\n  UpdateValidationError,\n  RuntimeClientError,\n} from \"./errors.js\";\nimport { TypedScheduleClient } from \"./schedule.js\";\nimport {\n  classifyHandleError,\n  classifyResultError,\n  classifyStartError,\n  makeResultAsync,\n  toTypedSearchAttributes,\n} from \"./internal.js\";\nimport { WorkflowExecutionAlreadyStartedError } from \"@temporalio/client\";\nimport { WorkflowFailedError as TemporalWorkflowFailedError } from \"@temporalio/client\";\nimport { WorkflowNotFoundError as TemporalWorkflowNotFoundError } from \"@temporalio/common\";\n\n/**\n * Typed `searchAttributes` map for a workflow, derived from the workflow's\n * declared `searchAttributes`. Each key is constrained to a declared\n * attribute name; each value's type is determined by the attribute's `kind`\n * (e.g. `KEYWORD` → `string`, `INT` → `number`, `DATETIME` → `Date`,\n * `KEYWORD_LIST` → `string[]`).\n *\n * If the workflow declares no search attributes, this resolves to `never`,\n * meaning the `searchAttributes` field is effectively absent from the start\n * options for that workflow.\n */\nexport type TypedSearchAttributeMap<TWorkflow extends AnyWorkflowDefinition> =\n  TWorkflow[\"searchAttributes\"] extends Record<string, SearchAttributeDefinition>\n    ? {\n        [K in keyof TWorkflow[\"searchAttributes\"]]?: SearchAttributeKindToType<\n          TWorkflow[\"searchAttributes\"][K][\"kind\"]\n        >;\n      }\n    : never;\n\n/**\n * Read declared search attributes off a `TypedSearchAttributes` instance —\n * the read-side counterpart to the write-side `searchAttributes` option on\n * `startWorkflow` / `signalWithStart` / `executeWorkflow` /\n * `schedule.create`.\n *\n * Use it on the result of `handle.describe()` (or a schedule's describe) to\n * recover the typed shape of indexed attributes. The Temporal SDK only\n * exposes a `.get(key)` accessor on `TypedSearchAttributes` and requires\n * the caller to reconstruct each `SearchAttributeKey` from the contract's\n * declared `kind` — this helper does that lookup once for every declared\n * attribute, returning a `Partial<TypedSearchAttributeMap<TWorkflow>>`\n * (each declared key may or may not have been set on the workflow).\n *\n * Workflows without declared `searchAttributes` get an empty object back.\n *\n * @example\n * ```ts\n * const description = await handle.describe();\n * if (description.isOk()) {\n *   const attrs = readTypedSearchAttributes(\n *     myContract.workflows.processOrder,\n *     description.value.typedSearchAttributes,\n *   );\n *   // attrs.customerId: string | undefined\n *   // attrs.priority:   number | undefined\n * }\n * ```\n */\nexport function readTypedSearchAttributes<TWorkflow extends AnyWorkflowDefinition>(\n  workflowDef: TWorkflow,\n  instance: TypedSearchAttributes,\n): Partial<TypedSearchAttributeMap<TWorkflow>> {\n  const declared = workflowDef.searchAttributes as\n    | Record<string, SearchAttributeDefinition>\n    | undefined;\n  if (!declared) return {} as Partial<TypedSearchAttributeMap<TWorkflow>>;\n\n  const result: Record<string, unknown> = {};\n  for (const [name, def] of Object.entries(declared)) {\n    const key = defineSearchAttributeKey(name, def.kind);\n    const value = instance.get(key);\n    if (value !== undefined) {\n      result[name] = value;\n    }\n  }\n  return result as Partial<TypedSearchAttributeMap<TWorkflow>>;\n}\n\nexport type TypedWorkflowStartOptions<\n  TContract extends ContractDefinition,\n  TWorkflowName extends keyof TContract[\"workflows\"] & string,\n> = Omit<\n  WorkflowStartOptions,\n  \"taskQueue\" | \"args\" | \"searchAttributes\" | \"typedSearchAttributes\"\n> & {\n  args: ClientInferInput<TContract[\"workflows\"][TWorkflowName]>;\n  /**\n   * Indexed search attributes for the started workflow. Keys and value types\n   * are constrained to those declared on the workflow's contract via\n   * `defineSearchAttribute`. Translated to Temporal's `typedSearchAttributes`\n   * before the start request is dispatched.\n   */\n  searchAttributes?: TypedSearchAttributeMap<TContract[\"workflows\"][TWorkflowName]>;\n};\n\n/**\n * Options for {@link TypedClient.signalWithStart} — typed against both the\n * workflow's input schema and the named signal's input schema.\n */\nexport type TypedSignalWithStartOptions<\n  TContract extends ContractDefinition,\n  TWorkflowName extends keyof TContract[\"workflows\"] & string,\n  TSignalName extends SignalNamesOf<TContract[\"workflows\"][TWorkflowName]>,\n> = Omit<\n  WorkflowSignalWithStartOptions,\n  \"taskQueue\" | \"args\" | \"signal\" | \"signalArgs\" | \"searchAttributes\" | \"typedSearchAttributes\"\n> & {\n  args: ClientInferInput<TContract[\"workflows\"][TWorkflowName]>;\n  signalName: TSignalName;\n  signalArgs: TContract[\"workflows\"][TWorkflowName][\"signals\"][TSignalName] extends SignalDefinition\n    ? ClientInferInput<TContract[\"workflows\"][TWorkflowName][\"signals\"][TSignalName]>\n    : never;\n  /**\n   * Indexed search attributes for the started workflow. Keys and value types\n   * are constrained to those declared on the workflow's contract via\n   * `defineSearchAttribute`. Translated to Temporal's `typedSearchAttributes`\n   * before the signalWithStart request is dispatched.\n   */\n  searchAttributes?: TypedSearchAttributeMap<TContract[\"workflows\"][TWorkflowName]>;\n};\n\n/**\n * Typed workflow handle returned by `signalWithStart`. Adds `signaledRunId`\n * to the standard handle so callers can correlate the signal with the\n * (possibly pre-existing) workflow execution chain.\n */\nexport type TypedWorkflowHandleWithSignaledRunId<TWorkflow extends AnyWorkflowDefinition> =\n  TypedWorkflowHandle<TWorkflow> & {\n    /**\n     * The Run Id of the bound Workflow at the time of `signalWithStart`. Since\n     * `signalWithStart` may have signaled an existing Workflow Chain, this is\n     * not necessarily the `firstExecutionRunId`.\n     */\n    readonly signaledRunId: string;\n  };\n\n/**\n * Typed workflow handle with validated results using neverthrow Result/ResultAsync\n */\nexport type TypedWorkflowHandle<TWorkflow extends AnyWorkflowDefinition> = {\n  workflowId: string;\n\n  /**\n   * Type-safe queries based on workflow definition with Result pattern\n   * Each query returns ResultAsync<T, Error> instead of Promise<T>\n   */\n  queries: {\n    [K in keyof ClientInferWorkflowQueries<TWorkflow>]: ClientInferWorkflowQueries<TWorkflow>[K] extends (\n      ...args: infer Args\n    ) => ResultAsync<infer R, Error>\n      ? (\n          ...args: Args\n        ) => ResultAsync<\n          R,\n          QueryValidationError | WorkflowExecutionNotFoundError | RuntimeClientError\n        >\n      : never;\n  };\n\n  /**\n   * Type-safe signals based on workflow definition with Result pattern\n   * Each signal returns ResultAsync<void, Error> instead of Promise<void>\n   */\n  signals: {\n    [K in keyof ClientInferWorkflowSignals<TWorkflow>]: ClientInferWorkflowSignals<TWorkflow>[K] extends (\n      ...args: infer Args\n    ) => ResultAsync<void, Error>\n      ? (\n          ...args: Args\n        ) => ResultAsync<\n          void,\n          SignalValidationError | WorkflowExecutionNotFoundError | RuntimeClientError\n        >\n      : never;\n  };\n\n  /**\n   * Type-safe updates based on workflow definition with Result pattern\n   * Each update returns ResultAsync<T, Error> instead of Promise<T>\n   */\n  updates: {\n    [K in keyof ClientInferWorkflowUpdates<TWorkflow>]: ClientInferWorkflowUpdates<TWorkflow>[K] extends (\n      ...args: infer Args\n    ) => ResultAsync<infer R, Error>\n      ? (\n          ...args: Args\n        ) => ResultAsync<\n          R,\n          UpdateValidationError | WorkflowExecutionNotFoundError | RuntimeClientError\n        >\n      : never;\n  };\n\n  /**\n   * Get workflow result with Result pattern\n   */\n  result: () => ResultAsync<\n    ClientInferOutput<TWorkflow>,\n    | WorkflowValidationError\n    | WorkflowFailedError\n    | WorkflowExecutionNotFoundError\n    | RuntimeClientError\n  >;\n\n  /**\n   * Terminate workflow with Result pattern\n   */\n  terminate: (\n    reason?: string,\n  ) => ResultAsync<void, WorkflowExecutionNotFoundError | RuntimeClientError>;\n\n  /**\n   * Cancel workflow with Result pattern\n   */\n  cancel: () => ResultAsync<void, WorkflowExecutionNotFoundError | RuntimeClientError>;\n\n  /**\n   * Get workflow execution description including status and metadata\n   */\n  describe: () => ResultAsync<\n    Awaited<ReturnType<WorkflowHandle[\"describe\"]>>,\n    WorkflowExecutionNotFoundError | RuntimeClientError\n  >;\n\n  /**\n   * Fetch the workflow execution history\n   */\n  fetchHistory: () => ResultAsync<\n    Awaited<ReturnType<WorkflowHandle[\"fetchHistory\"]>>,\n    WorkflowExecutionNotFoundError | RuntimeClientError\n  >;\n};\n\n/**\n * Result of {@link resolveDefinitionAndValidateInput} — the contract-side\n * pre-call ritual the start/signal-with-start/execute methods share. Holds\n * the resolved workflow definition, the schema-validated input, and the\n * translated typed search attributes (or `undefined` when the workflow\n * declared none / the caller passed none).\n */\ntype ResolvedWorkflow<TWorkflow extends AnyWorkflowDefinition> = {\n  definition: TWorkflow;\n  validatedInput: unknown;\n  typedSearchAttributes: TypedSearchAttributes | undefined;\n};\n\n/**\n * Shared pre-call ritual for the three contract-driven entry points that\n * actually start a workflow (`startWorkflow`, `signalWithStart`,\n * `executeWorkflow`):\n *\n *   1. Look up the workflow definition on the contract.\n *   2. Surface a `WorkflowNotFoundError` if absent.\n *   3. Validate `args` against the workflow's input schema.\n *   4. Surface a `WorkflowValidationError` if validation fails.\n *   5. Translate any caller-supplied `searchAttributes` into Temporal's\n *      `TypedSearchAttributes` shape (or `undefined`).\n *\n * `getHandle` deliberately keeps its own three-line lookup — it doesn't\n * accept `args` or `searchAttributes`, so it can't share this helper. The\n * call-specific extras (signal validation, post-call output validation,\n * extended error classification) stay at the call site — those are the\n * differentiators that make each method distinct.\n */\nasync function resolveDefinitionAndValidateInput<\n  TContract extends ContractDefinition,\n  TWorkflowName extends keyof TContract[\"workflows\"] & string,\n>(\n  contract: TContract,\n  workflowName: TWorkflowName,\n  args: unknown,\n  searchAttributes: Record<string, unknown> | undefined,\n): Promise<\n  Result<\n    ResolvedWorkflow<TContract[\"workflows\"][TWorkflowName]>,\n    WorkflowNotFoundError | WorkflowValidationError | RuntimeClientError\n  >\n> {\n  const definition = contract.workflows[workflowName];\n  if (!definition) {\n    return err(createWorkflowNotFoundError(workflowName, contract));\n  }\n\n  const inputResult = await definition.input[\"~standard\"].validate(args);\n  if (inputResult.issues) {\n    return err(createWorkflowValidationError(workflowName, \"input\", inputResult.issues));\n  }\n\n  const searchAttributesResult = toTypedSearchAttributes(\n    definition,\n    workflowName,\n    searchAttributes,\n  );\n  if (searchAttributesResult.isErr()) return err(searchAttributesResult.error);\n  const typedSearchAttributes = searchAttributesResult.value;\n\n  return ok({\n    definition: definition as TContract[\"workflows\"][TWorkflowName],\n    validatedInput: inputResult.value,\n    typedSearchAttributes,\n  });\n}\n\n/**\n * Typed Temporal client with neverthrow Result/ResultAsync pattern based on a contract\n *\n * Provides type-safe methods to start and execute workflows\n * defined in the contract, with explicit error handling using Result pattern.\n */\nexport class TypedClient<TContract extends ContractDefinition> {\n  /**\n   * Typed wrapper around Temporal's `client.schedule.create(...)` and\n   * related lifecycle methods. Fires the underlying `startWorkflow` action\n   * with args validated against the contract's input schema.\n   *\n   * **Requires `@temporalio/client` 1.16+.** The Schedule API was added in\n   * 1.16; on older versions this property is unset and any access throws.\n   * The package's peer dep is pinned to `^1.16.0` so the standard install\n   * paths surface a peer-dependency warning rather than a runtime crash.\n   *\n   * @example\n   * ```ts\n   * const result = await client.schedule.create(\"processOrder\", {\n   *   scheduleId: \"daily-sweep\",\n   *   spec: { cronExpressions: [\"0 2 * * *\"] },\n   *   args: { orderId: \"sweep\" },\n   * });\n   *\n   * result.match(\n   *   async (handle) => { await handle.pause(\"maintenance\"); },\n   *   (error) => console.error(\"schedule create failed\", error),\n   * );\n   * ```\n   */\n  readonly schedule: TypedScheduleClient<TContract>;\n\n  private constructor(\n    private readonly contract: TContract,\n    private readonly client: Client,\n  ) {\n    // `client.schedule` is the ScheduleClient wired into Temporal's\n    // top-level `Client` since 1.16. Fail early with a clear message if a\n    // consumer is on an older version (peer dep is pinned to ^1.16, but\n    // installs that ignore peer-dep warnings shouldn't crash with a\n    // confusing `Cannot read properties of undefined`).\n    if (!client.schedule) {\n      throw new Error(\n        \"TypedClient requires @temporalio/client >= 1.16 (the Schedule API was added in 1.16). \" +\n          \"Found a Client instance without a `schedule` property — please upgrade.\",\n      );\n    }\n    this.schedule = new TypedScheduleClient(contract, client.schedule);\n  }\n\n  /**\n   * Create a typed Temporal client with neverthrow pattern from a contract\n   *\n   * @example\n   * ```ts\n   * const connection = await Connection.connect();\n   * const temporalClient = new Client({ connection });\n   * const client = TypedClient.create(myContract, temporalClient);\n   *\n   * const result = await client.executeWorkflow('processOrder', {\n   *   workflowId: 'order-123',\n   *   args: { ... },\n   * });\n   *\n   * result.match(\n   *   (output) => console.log('Success:', output),\n   *   (error) => console.error('Failed:', error),\n   * );\n   * ```\n   */\n  static create<TContract extends ContractDefinition>(\n    contract: TContract,\n    client: Client,\n  ): TypedClient<TContract> {\n    return new TypedClient(contract, client);\n  }\n\n  /**\n   * Start a workflow and return a typed handle with ResultAsync pattern\n   *\n   * @example\n   * ```ts\n   * const handleResult = await client.startWorkflow('processOrder', {\n   *   workflowId: 'order-123',\n   *   args: { orderId: 'ORD-123' },\n   *   workflowExecutionTimeout: '1 day',\n   *   retry: { maximumAttempts: 3 },\n   * });\n   *\n   * handleResult.match(\n   *   async (handle) => {\n   *     const result = await handle.result();\n   *     // ... handle result\n   *   },\n   *   (error) => console.error('Failed to start:', error),\n   * );\n   * ```\n   */\n  startWorkflow<TWorkflowName extends keyof TContract[\"workflows\"] & string>(\n    workflowName: TWorkflowName,\n    {\n      args,\n      searchAttributes,\n      ...temporalOptions\n    }: TypedWorkflowStartOptions<TContract, TWorkflowName>,\n  ): ResultAsync<\n    TypedWorkflowHandle<TContract[\"workflows\"][TWorkflowName]>,\n    | WorkflowNotFoundError\n    | WorkflowValidationError\n    | WorkflowAlreadyStartedError\n    | RuntimeClientError\n  > {\n    type Ok = TypedWorkflowHandle<TContract[\"workflows\"][TWorkflowName]>;\n    type Err =\n      | WorkflowNotFoundError\n      | WorkflowValidationError\n      | WorkflowAlreadyStartedError\n      | RuntimeClientError;\n    const work = async (): Promise<Result<Ok, Err>> => {\n      const resolved = await resolveDefinitionAndValidateInput(\n        this.contract,\n        workflowName,\n        args,\n        searchAttributes as Record<string, unknown> | undefined,\n      );\n      if (resolved.isErr()) return err(resolved.error);\n      const { definition, validatedInput, typedSearchAttributes } = resolved.value;\n\n      try {\n        const handle = await this.client.workflow.start(workflowName, {\n          ...temporalOptions,\n          taskQueue: this.contract.taskQueue,\n          args: [validatedInput],\n          ...(typedSearchAttributes ? { typedSearchAttributes } : {}),\n        });\n        return ok(this.createTypedHandle(handle, definition) as Ok);\n      } catch (error) {\n        return err(classifyStartError(\"startWorkflow\", error));\n      }\n    };\n    return makeResultAsync(work);\n  }\n\n  /**\n   * Send a signal to a workflow, starting it first if it doesn't already exist.\n   *\n   * Validates both halves of the call against the contract:\n   * - `args` against the workflow's input schema\n   * - `signalArgs` against the named signal's input schema\n   *\n   * Returns a `TypedWorkflowHandleWithSignaledRunId` — the same shape as\n   * `startWorkflow`'s handle, plus a `signaledRunId` field for correlating\n   * the signal with the (possibly pre-existing) workflow execution chain.\n   *\n   * @example\n   * ```ts\n   * const result = await client.signalWithStart('processOrder', {\n   *   workflowId: 'order-123',\n   *   args: { orderId: 'ORD-123', customerId: 'CUST-1' },\n   *   signalName: 'cancel',\n   *   signalArgs: { reason: 'duplicate' },\n   * });\n   *\n   * result.match(\n   *   (handle) => console.log('signaled run', handle.signaledRunId),\n   *   (error) => console.error('signalWithStart failed', error),\n   * );\n   * ```\n   */\n  signalWithStart<\n    TWorkflowName extends keyof TContract[\"workflows\"] & string,\n    TSignalName extends SignalNamesOf<TContract[\"workflows\"][TWorkflowName]>,\n  >(\n    workflowName: TWorkflowName,\n    {\n      args,\n      signalName,\n      signalArgs,\n      searchAttributes,\n      ...temporalOptions\n    }: TypedSignalWithStartOptions<TContract, TWorkflowName, TSignalName>,\n  ): ResultAsync<\n    TypedWorkflowHandleWithSignaledRunId<TContract[\"workflows\"][TWorkflowName]>,\n    | WorkflowNotFoundError\n    | WorkflowValidationError\n    | SignalValidationError\n    | WorkflowAlreadyStartedError\n    | RuntimeClientError\n  > {\n    type Ok = TypedWorkflowHandleWithSignaledRunId<TContract[\"workflows\"][TWorkflowName]>;\n    type Err =\n      | WorkflowNotFoundError\n      | WorkflowValidationError\n      | SignalValidationError\n      | WorkflowAlreadyStartedError\n      | RuntimeClientError;\n\n    const work = async (): Promise<Result<Ok, Err>> => {\n      const resolved = await resolveDefinitionAndValidateInput(\n        this.contract,\n        workflowName,\n        args,\n        searchAttributes as Record<string, unknown> | undefined,\n      );\n      if (resolved.isErr()) return err(resolved.error);\n      const { definition, validatedInput, typedSearchAttributes } = resolved.value;\n\n      // Validate signal input — call-site-specific, kept inline.\n      const signalDef = (definition.signals as Record<string, SignalDefinition> | undefined)?.[\n        signalName\n      ];\n      if (!signalDef) {\n        // Type-level constraint should already prevent this; defensive for\n        // raw-call / union-typed-name corner cases.\n        return err(\n          new SignalValidationError(signalName, [\n            {\n              message: `Signal \"${signalName}\" is not declared on workflow \"${workflowName}\".`,\n            },\n          ]),\n        );\n      }\n      const signalInputResult = await signalDef.input[\"~standard\"].validate(signalArgs);\n      if (signalInputResult.issues) {\n        return err(new SignalValidationError(signalName, signalInputResult.issues));\n      }\n\n      try {\n        const handle = await this.client.workflow.signalWithStart(workflowName, {\n          ...temporalOptions,\n          taskQueue: this.contract.taskQueue,\n          args: [validatedInput],\n          signal: signalName,\n          signalArgs: [signalInputResult.value],\n          ...(typedSearchAttributes ? { typedSearchAttributes } : {}),\n        });\n        const typed = this.createTypedHandle(handle, definition) as TypedWorkflowHandle<\n          TContract[\"workflows\"][TWorkflowName]\n        >;\n        return ok({ ...typed, signaledRunId: handle.signaledRunId } as Ok);\n      } catch (error) {\n        return err(classifyStartError(\"signalWithStart\", error));\n      }\n    };\n    return makeResultAsync(work);\n  }\n\n  /**\n   * Execute a workflow (start and wait for result) with ResultAsync pattern\n   *\n   * @example\n   * ```ts\n   * const result = await client.executeWorkflow('processOrder', {\n   *   workflowId: 'order-123',\n   *   args: { orderId: 'ORD-123' },\n   *   workflowExecutionTimeout: '1 day',\n   *   retry: { maximumAttempts: 3 },\n   * });\n   *\n   * result.match(\n   *   (output) => console.log('Order processed:', output.status),\n   *   (error) => console.error('Processing failed:', error),\n   * );\n   * ```\n   */\n  executeWorkflow<TWorkflowName extends keyof TContract[\"workflows\"] & string>(\n    workflowName: TWorkflowName,\n    {\n      args,\n      searchAttributes,\n      ...temporalOptions\n    }: TypedWorkflowStartOptions<TContract, TWorkflowName>,\n  ): ResultAsync<\n    ClientInferOutput<TContract[\"workflows\"][TWorkflowName]>,\n    | WorkflowNotFoundError\n    | WorkflowValidationError\n    | WorkflowAlreadyStartedError\n    | WorkflowFailedError\n    | WorkflowExecutionNotFoundError\n    | RuntimeClientError\n  > {\n    type Ok = ClientInferOutput<TContract[\"workflows\"][TWorkflowName]>;\n    type Err =\n      | WorkflowNotFoundError\n      | WorkflowValidationError\n      | WorkflowAlreadyStartedError\n      | WorkflowFailedError\n      | WorkflowExecutionNotFoundError\n      | RuntimeClientError;\n    const work = async (): Promise<Result<Ok, Err>> => {\n      const resolved = await resolveDefinitionAndValidateInput(\n        this.contract,\n        workflowName,\n        args,\n        searchAttributes as Record<string, unknown> | undefined,\n      );\n      if (resolved.isErr()) return err(resolved.error);\n      const { definition, validatedInput, typedSearchAttributes } = resolved.value;\n\n      try {\n        const result = await this.client.workflow.execute(workflowName, {\n          ...temporalOptions,\n          taskQueue: this.contract.taskQueue,\n          args: [validatedInput],\n          ...(typedSearchAttributes ? { typedSearchAttributes } : {}),\n        });\n\n        // Output validation runs *after* the Temporal call returns — kept\n        // inline because it's specific to executeWorkflow's start-and-wait\n        // shape; the helper only handles pre-call concerns.\n        const outputResult = await definition.output[\"~standard\"].validate(result);\n        if (outputResult.issues) {\n          return err(createWorkflowValidationError(workflowName, \"output\", outputResult.issues));\n        }\n\n        return ok(outputResult.value as Ok);\n      } catch (error) {\n        // executeWorkflow combines start + result, so it can surface any of\n        // the discriminated kinds. Inline the three checks rather than\n        // routing through a dedicated helper — this is the only call site\n        // that needs the full union.\n        if (error instanceof WorkflowExecutionAlreadyStartedError) {\n          return err(new WorkflowAlreadyStartedError(error.workflowType, error.workflowId, error));\n        }\n        if (error instanceof TemporalWorkflowFailedError) {\n          // Forward Temporal's nested cause directly — see\n          // {@link classifyResultError} for the same rationale: Temporal's\n          // `WorkflowFailedError` is a wrapper, and the actionable failure\n          // (ApplicationFailure, CancelledFailure, etc.) lives on `.cause`.\n          // Temporal types `cause` as `Error | undefined`, but the SDK only\n          // ever populates it with a `TemporalFailure` subclass here; narrow\n          // with the public union so the typed `cause` lines up with the\n          // surfaced `WorkflowFailedError`.\n          return err(\n            new WorkflowFailedError(\n              temporalOptions.workflowId,\n              error.cause as TemporalFailure | undefined,\n            ),\n          );\n        }\n        if (error instanceof TemporalWorkflowNotFoundError) {\n          return err(\n            new WorkflowExecutionNotFoundError(\n              error.workflowId || temporalOptions.workflowId,\n              error.runId,\n              error,\n            ),\n          );\n        }\n        return err(createRuntimeClientError(\"executeWorkflow\", error));\n      }\n    };\n    return makeResultAsync(work);\n  }\n\n  /**\n   * Get a handle to an existing workflow with ResultAsync pattern\n   *\n   * @example\n   * ```ts\n   * const handleResult = await client.getHandle('processOrder', 'order-123');\n   * handleResult.match(\n   *   async (handle) => {\n   *     const result = await handle.result();\n   *     // ... handle result\n   *   },\n   *   (error) => console.error('Failed to get handle:', error),\n   * );\n   * ```\n   */\n  getHandle<TWorkflowName extends keyof TContract[\"workflows\"] & string>(\n    workflowName: TWorkflowName,\n    workflowId: string,\n  ): ResultAsync<\n    TypedWorkflowHandle<TContract[\"workflows\"][TWorkflowName]>,\n    WorkflowNotFoundError | RuntimeClientError\n  > {\n    type Ok = TypedWorkflowHandle<TContract[\"workflows\"][TWorkflowName]>;\n    type Err = WorkflowNotFoundError | RuntimeClientError;\n    const work = async (): Promise<Result<Ok, Err>> => {\n      const definition = this.contract.workflows[workflowName];\n      if (!definition) {\n        return err(createWorkflowNotFoundError(workflowName, this.contract));\n      }\n\n      try {\n        const handle = this.client.workflow.getHandle(workflowId);\n        return ok(this.createTypedHandle(handle, definition) as Ok);\n      } catch (error) {\n        return err(createRuntimeClientError(\"getHandle\", error));\n      }\n    };\n    return makeResultAsync(work);\n  }\n\n  private createTypedHandle<TWorkflow extends AnyWorkflowDefinition>(\n    workflowHandle: WorkflowHandle,\n    definition: TWorkflow,\n  ): TypedWorkflowHandle<TWorkflow> {\n    const queries = buildValidatedProxy({\n      defs: definition.queries,\n      operation: \"query\",\n      workflowId: workflowHandle.workflowId,\n      makeValidationError: (name, direction, issues) =>\n        new QueryValidationError(name, direction, issues),\n      invoke: (name, validated) => workflowHandle.query(name, validated),\n      validateOutput: (def) => def.output,\n    }) as TypedWorkflowHandle<TWorkflow>[\"queries\"];\n\n    const signals = buildValidatedProxy({\n      defs: definition.signals,\n      operation: \"signal\",\n      workflowId: workflowHandle.workflowId,\n      makeValidationError: (name, _direction, issues) => new SignalValidationError(name, issues),\n      invoke: async (name, validated) => {\n        await workflowHandle.signal(name, validated);\n        return undefined;\n      },\n      validateOutput: () => null,\n    }) as TypedWorkflowHandle<TWorkflow>[\"signals\"];\n\n    const updates = buildValidatedProxy({\n      defs: definition.updates,\n      operation: \"update\",\n      workflowId: workflowHandle.workflowId,\n      makeValidationError: (name, direction, issues) =>\n        new UpdateValidationError(name, direction, issues),\n      invoke: (name, validated) => workflowHandle.executeUpdate(name, { args: [validated] }),\n      validateOutput: (def) => def.output,\n    }) as TypedWorkflowHandle<TWorkflow>[\"updates\"];\n\n    return {\n      workflowId: workflowHandle.workflowId,\n      queries,\n      signals,\n      updates,\n      result: (): ResultAsync<\n        ClientInferOutput<TWorkflow>,\n        | WorkflowValidationError\n        | WorkflowFailedError\n        | WorkflowExecutionNotFoundError\n        | RuntimeClientError\n      > => {\n        type Ok = ClientInferOutput<TWorkflow>;\n        type Err =\n          | WorkflowValidationError\n          | WorkflowFailedError\n          | WorkflowExecutionNotFoundError\n          | RuntimeClientError;\n        const work = async (): Promise<Result<Ok, Err>> => {\n          try {\n            const result = await workflowHandle.result();\n            const outputResult = await definition.output[\"~standard\"].validate(result);\n            if (outputResult.issues) {\n              return err(\n                new WorkflowValidationError(\n                  workflowHandle.workflowId,\n                  \"output\",\n                  outputResult.issues,\n                ),\n              );\n            }\n            return ok(outputResult.value as Ok);\n          } catch (error) {\n            return err(classifyResultError(\"result\", error, workflowHandle.workflowId));\n          }\n        };\n        return makeResultAsync(work);\n      },\n      terminate: (\n        reason?: string,\n      ): ResultAsync<void, WorkflowExecutionNotFoundError | RuntimeClientError> =>\n        ResultAsync.fromPromise(workflowHandle.terminate(reason), (error) =>\n          classifyHandleError(\"terminate\", error, workflowHandle.workflowId),\n        ).map(() => undefined),\n      cancel: (): ResultAsync<void, WorkflowExecutionNotFoundError | RuntimeClientError> =>\n        ResultAsync.fromPromise(workflowHandle.cancel(), (error) =>\n          classifyHandleError(\"cancel\", error, workflowHandle.workflowId),\n        ).map(() => undefined),\n      describe: (): ResultAsync<\n        Awaited<ReturnType<WorkflowHandle[\"describe\"]>>,\n        WorkflowExecutionNotFoundError | RuntimeClientError\n      > =>\n        ResultAsync.fromPromise(workflowHandle.describe(), (error) =>\n          classifyHandleError(\"describe\", error, workflowHandle.workflowId),\n        ),\n      fetchHistory: (): ResultAsync<\n        Awaited<ReturnType<WorkflowHandle[\"fetchHistory\"]>>,\n        WorkflowExecutionNotFoundError | RuntimeClientError\n      > =>\n        ResultAsync.fromPromise(workflowHandle.fetchHistory(), (error) =>\n          classifyHandleError(\"fetchHistory\", error, workflowHandle.workflowId),\n        ),\n    };\n  }\n}\n\nfunction createRuntimeClientError(operation: string, error: unknown): RuntimeClientError {\n  return new RuntimeClientError(operation, error);\n}\n\nfunction createWorkflowNotFoundError(\n  workflowName: string | number | symbol,\n  contract: ContractDefinition,\n): WorkflowNotFoundError {\n  return new WorkflowNotFoundError(String(workflowName), Object.keys(contract.workflows));\n}\n\nfunction createWorkflowValidationError(\n  workflowName: string | number | symbol,\n  direction: \"input\" | \"output\",\n  issues: ReadonlyArray<StandardSchemaV1.Issue>,\n): WorkflowValidationError {\n  return new WorkflowValidationError(String(workflowName), direction, issues);\n}\n\ntype DefWithInput = { readonly input: StandardSchemaV1 };\n\ntype ProxyOptions<TDef extends DefWithInput, TValidationError extends Error> = {\n  readonly defs: Record<string, TDef> | undefined;\n  readonly operation: string;\n  /**\n   * Workflow ID of the handle these proxies bind to. Used by\n   * {@link classifyHandleError} to surface\n   * {@link WorkflowExecutionNotFoundError} with the targeted ID even when\n   * Temporal's error doesn't carry it.\n   */\n  readonly workflowId: string;\n  readonly makeValidationError: (\n    name: string,\n    direction: \"input\" | \"output\",\n    issues: ReadonlyArray<StandardSchemaV1.Issue>,\n  ) => TValidationError;\n  readonly invoke: (name: string, validatedInput: unknown) => Promise<unknown>;\n  /**\n   * Returns the schema to validate the invoke result against, or `null` to skip\n   * output validation (used by signals, which don't return a value).\n   */\n  readonly validateOutput: (def: TDef) => StandardSchemaV1 | null;\n};\n\n/**\n * Build a `{ name: (args) => ResultAsync<...> }` proxy for a contract's\n * queries/signals/updates. The three call sites differ only in how they\n * invoke Temporal and whether they validate output, so the shared\n * input-validate → invoke → output-validate → wrap-Result pipeline lives\n * here once.\n */\nfunction buildValidatedProxy<TDef extends DefWithInput, TValidationError extends Error>({\n  defs,\n  operation,\n  workflowId,\n  makeValidationError,\n  invoke,\n  validateOutput,\n}: ProxyOptions<TDef, TValidationError>): Record<\n  string,\n  (\n    args: unknown,\n  ) => ResultAsync<unknown, TValidationError | WorkflowExecutionNotFoundError | RuntimeClientError>\n> {\n  const proxy: Record<\n    string,\n    (\n      args: unknown,\n    ) => ResultAsync<\n      unknown,\n      TValidationError | WorkflowExecutionNotFoundError | RuntimeClientError\n    >\n  > = {};\n  if (!defs) return proxy;\n\n  for (const [name, def] of Object.entries(defs)) {\n    proxy[name] = (args) => {\n      const work = async (): Promise<\n        Result<unknown, TValidationError | WorkflowExecutionNotFoundError | RuntimeClientError>\n      > => {\n        const inputResult = await def.input[\"~standard\"].validate(args);\n        if (inputResult.issues) {\n          return err(makeValidationError(name, \"input\", inputResult.issues));\n        }\n\n        try {\n          const result = await invoke(name, inputResult.value);\n          const outputSchema = validateOutput(def);\n          if (!outputSchema) {\n            return ok(result);\n          }\n          const outputResult = await outputSchema[\"~standard\"].validate(result);\n          if (outputResult.issues) {\n            return err(makeValidationError(name, \"output\", outputResult.issues));\n          }\n          return ok(outputResult.value);\n        } catch (error) {\n          return err(classifyHandleError(operation, error, workflowId));\n        }\n      };\n      return makeResultAsync(work);\n    };\n  }\n\n  return proxy;\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@temporal-contract/client",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "Client utilities with neverthrow Result/ResultAsync for consuming temporal-contract workflows",
   "keywords": [
     "client",
@@ -43,7 +43,7 @@
   },
   "dependencies": {
     "@standard-schema/spec": "1.1.0",
-    "@temporal-contract/contract": "2.1.0"
+    "@temporal-contract/contract": "2.2.0"
   },
   "devDependencies": {
     "@temporalio/client": "1.17.0",
@@ -59,9 +59,9 @@
     "typescript": "6.0.3",
     "vitest": "4.1.5",
     "zod": "4.4.3",
-    "@temporal-contract/testing": "2.1.0",
-    "@temporal-contract/typedoc": "0.1.0",
-    "@temporal-contract/tsconfig": "1.0.0"
+    "@temporal-contract/testing": "2.2.0",
+    "@temporal-contract/tsconfig": "1.0.0",
+    "@temporal-contract/typedoc": "0.1.0"
   },
   "peerDependencies": {
     "@temporalio/client": "^1.16.0",