@temporal-contract/worker 0.1.0 → 1.0.0

package/dist/internal-BoNcEtYh.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal-BoNcEtYh.mjs","names":[],"sources":["../src/format.ts","../src/errors.ts","../src/internal.ts"],"sourcesContent":["/**\n * Issue / validation-message formatters.\n *\n * Lives in its own module (separate from `errors.ts` and `internal.ts`) so\n * both can import these helpers without forming a circular dependency:\n * `errors.ts` -> `format.ts` and `internal.ts` -> `format.ts` are both safe,\n * even when `internal.ts` later needs to import error classes from\n * `errors.ts` (as `createContinueAsNew` does).\n *\n * Not part of the package's public exports map.\n */\nimport type { StandardSchemaV1 } from \"@standard-schema/spec\";\n\n/**\n * Pattern for string keys safe to render with dot notation. A \"safe\" key is a\n * JavaScript identifier (letters/digits/underscore/$, not starting with a\n * digit). Anything else — keys containing dots, spaces, leading digits, the\n * empty string, the literal string `\"0\"` etc. — gets bracket-quoted so the\n * path is unambiguous. Reserved words are accepted: we are formatting a\n * diagnostic, not generating runnable code.\n */\nconst SAFE_IDENTIFIER = /^[A-Za-z_$][A-Za-z0-9_$]*$/;\n\n/**\n * Render a Standard Schema {@link StandardSchemaV1.Issue} into a human-readable\n * string that includes the failing field's path.\n */\nexport function formatIssue(issue: StandardSchemaV1.Issue): string {\n  if (issue.path === undefined || issue.path.length === 0) {\n    return issue.message;\n  }\n  let path = \"\";\n  for (let i = 0; i < issue.path.length; i++) {\n    const segment = issue.path[i];\n    const key =\n      segment !== null && typeof segment === \"object\" && \"key\" in segment ? segment.key : segment;\n    if (typeof key === \"number\") {\n      path += `[${key}]`;\n    } else if (typeof key === \"string\" && SAFE_IDENTIFIER.test(key)) {\n      path += i === 0 ? key : `.${key}`;\n    } else if (typeof key === \"string\") {\n      path += `[${JSON.stringify(key)}]`;\n    } else {\n      path += `[${String(key)}]`;\n    }\n  }\n  return `at ${path}: ${issue.message}`;\n}\n\n/**\n * Join a list of validation issues into a single message, with each issue\n * rendered via {@link formatIssue} so field paths surface in the error text.\n */\nexport function summarizeIssues(issues: ReadonlyArray<StandardSchemaV1.Issue>): string {\n  return issues.map(formatIssue).join(\"; \");\n}\n\n/**\n * Build the message attached to a `ChildWorkflowError` for input/output\n * validation failures. Centralized so the worker and any future call sites\n * format identically.\n */\nexport function formatChildWorkflowValidationMessage(\n  workflowName: string,\n  direction: \"input\" | \"output\",\n  issues: ReadonlyArray<StandardSchemaV1.Issue>,\n): string {\n  return `Child workflow \"${workflowName}\" ${direction} validation failed: ${summarizeIssues(issues)}`;\n}\n","import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport { summarizeIssues } from \"./format.js\";\n\n/**\n * Base error class for worker errors\n */\nabstract class WorkerError extends Error {\n  protected constructor(message: string, cause?: unknown) {\n    super(message, { cause });\n    this.name = \"WorkerError\";\n    // Maintains proper stack trace for where our error was thrown (only available on V8)\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, this.constructor);\n    }\n  }\n}\n\n/**\n * Error thrown when an activity definition is not found in the contract\n */\nexport class ActivityDefinitionNotFoundError extends WorkerError {\n  constructor(\n    public readonly activityName: string,\n    public readonly availableDefinitions: readonly string[] = [],\n  ) {\n    const available = availableDefinitions.length > 0 ? availableDefinitions.join(\", \") : \"none\";\n    super(\n      `Activity definition not found for: \"${activityName}\". Available activities: ${available}`,\n    );\n    this.name = \"ActivityDefinitionNotFoundError\";\n  }\n}\n\n/**\n * Error thrown when activity input validation fails\n */\nexport class ActivityInputValidationError extends WorkerError {\n  constructor(\n    public readonly activityName: string,\n    public readonly issues: ReadonlyArray<StandardSchemaV1.Issue>,\n  ) {\n    const message = summarizeIssues(issues);\n    super(`Activity \"${activityName}\" input validation failed: ${message}`);\n    this.name = \"ActivityInputValidationError\";\n  }\n}\n\n/**\n * Error thrown when activity output validation fails\n */\nexport class ActivityOutputValidationError extends WorkerError {\n  constructor(\n    public readonly activityName: string,\n    public readonly issues: ReadonlyArray<StandardSchemaV1.Issue>,\n  ) {\n    const message = summarizeIssues(issues);\n    super(`Activity \"${activityName}\" output validation failed: ${message}`);\n    this.name = \"ActivityOutputValidationError\";\n  }\n}\n\n/**\n * Error thrown when workflow input validation fails\n */\nexport class WorkflowInputValidationError extends WorkerError {\n  constructor(\n    public readonly workflowName: string,\n    public readonly issues: ReadonlyArray<StandardSchemaV1.Issue>,\n  ) {\n    const message = summarizeIssues(issues);\n    super(`Workflow \"${workflowName}\" input validation failed: ${message}`);\n    this.name = \"WorkflowInputValidationError\";\n  }\n}\n\n/**\n * Error thrown when workflow output validation fails\n */\nexport class WorkflowOutputValidationError extends WorkerError {\n  constructor(\n    public readonly workflowName: string,\n    public readonly issues: ReadonlyArray<StandardSchemaV1.Issue>,\n  ) {\n    const message = summarizeIssues(issues);\n    super(`Workflow \"${workflowName}\" output validation failed: ${message}`);\n    this.name = \"WorkflowOutputValidationError\";\n  }\n}\n\n/**\n * Error thrown when signal input validation fails\n */\nexport class SignalInputValidationError extends WorkerError {\n  constructor(\n    public readonly signalName: string,\n    public readonly issues: ReadonlyArray<StandardSchemaV1.Issue>,\n  ) {\n    const message = summarizeIssues(issues);\n    super(`Signal \"${signalName}\" input validation failed: ${message}`);\n    this.name = \"SignalInputValidationError\";\n  }\n}\n\n/**\n * Error thrown when query input validation fails\n */\nexport class QueryInputValidationError extends WorkerError {\n  constructor(\n    public readonly queryName: string,\n    public readonly issues: ReadonlyArray<StandardSchemaV1.Issue>,\n  ) {\n    const message = summarizeIssues(issues);\n    super(`Query \"${queryName}\" input validation failed: ${message}`);\n    this.name = \"QueryInputValidationError\";\n  }\n}\n\n/**\n * Error thrown when query output validation fails\n */\nexport class QueryOutputValidationError extends WorkerError {\n  constructor(\n    public readonly queryName: string,\n    public readonly issues: ReadonlyArray<StandardSchemaV1.Issue>,\n  ) {\n    const message = summarizeIssues(issues);\n    super(`Query \"${queryName}\" output validation failed: ${message}`);\n    this.name = \"QueryOutputValidationError\";\n  }\n}\n\n/**\n * Error thrown when update input validation fails\n */\nexport class UpdateInputValidationError extends WorkerError {\n  constructor(\n    public readonly updateName: string,\n    public readonly issues: ReadonlyArray<StandardSchemaV1.Issue>,\n  ) {\n    const message = summarizeIssues(issues);\n    super(`Update \"${updateName}\" input validation failed: ${message}`);\n    this.name = \"UpdateInputValidationError\";\n  }\n}\n\n/**\n * Error thrown when update output validation fails\n */\nexport class UpdateOutputValidationError extends WorkerError {\n  constructor(\n    public readonly updateName: string,\n    public readonly issues: ReadonlyArray<StandardSchemaV1.Issue>,\n  ) {\n    const message = summarizeIssues(issues);\n    super(`Update \"${updateName}\" output validation failed: ${message}`);\n    this.name = \"UpdateOutputValidationError\";\n  }\n}\n\n/**\n * Error thrown when a child workflow is not found in the contract\n */\nexport class ChildWorkflowNotFoundError extends WorkerError {\n  constructor(\n    public readonly workflowName: string,\n    public readonly availableWorkflows: readonly string[] = [],\n  ) {\n    const available = availableWorkflows.length > 0 ? availableWorkflows.join(\", \") : \"none\";\n    super(`Child workflow not found: \"${workflowName}\". Available workflows: ${available}`);\n    this.name = \"ChildWorkflowNotFoundError\";\n  }\n}\n\n/**\n * Generic error for child workflow operations\n */\nexport class ChildWorkflowError extends WorkerError {\n  constructor(message: string, cause?: unknown) {\n    super(message, cause);\n    this.name = \"ChildWorkflowError\";\n  }\n}\n\n/**\n * Error returned in the `Result.Error` branch when a typed cancellation\n * scope is cancelled via Temporal's cancellation propagation. Returned by\n * both `context.cancellableScope` (when the workflow or an ancestor scope\n * cancels) and `context.nonCancellableScope` (when cancellation is raised\n * from inside the scope). Distinct from arbitrary thrown errors so call\n * sites can branch on cancellation explicitly while still surfacing\n * non-cancellation errors as Future rejections.\n */\nexport class WorkflowCancelledError extends WorkerError {\n  constructor(cause?: unknown) {\n    super(\"Workflow cancellation scope was cancelled\", cause);\n    this.name = \"WorkflowCancelledError\";\n  }\n}\n","/**\n * Internal helpers shared across the worker package's entry points.\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/worker/internal`.\n * In-package tests import it directly via relative path.\n */\nimport { makeContinueAsNewFunc, proxyActivities } from \"@temporalio/workflow\";\nimport type { ActivityOptions, ContinueAsNewOptions } from \"@temporalio/workflow\";\nimport type { ActivityDefinition, ContractDefinition } from \"@temporal-contract/contract\";\nimport { WorkflowInputValidationError } from \"./errors.js\";\n\n// Re-export the formatters so workflow.ts and existing tests can keep\n// importing from `./internal.js`. Their canonical home is `./format.js`,\n// which both `errors.ts` and `internal.ts` import from to avoid a\n// circular dependency once `internal.ts` started importing error classes.\nexport { formatIssue, summarizeIssues, formatChildWorkflowValidationMessage } from \"./format.js\";\n\n/**\n * Extract the single payload from a Temporal handler's `...args` array.\n *\n * Temporal invokes handlers with whatever was passed via `args: [...]` at the\n * call site. The typed-contract layer always sends `args: [validatedInput]`,\n * so the common case is a one-element array containing the wrapped input.\n *\n * If a non-typed-contract caller passes multiple positional arguments\n * (`args: [a, b, c]`), we surface the whole array as the input — the schema\n * will then reject it unless the contract specifically modeled a tuple.\n */\nexport function extractHandlerInput(args: unknown[]): unknown {\n  return args.length === 1 ? args[0] : args;\n}\n\ntype ActivityFn = (...args: unknown[]) => Promise<unknown>;\n\n/**\n * Build the raw `Record<name, fn>` proxy of activities for a workflow,\n * applying per-activity `ActivityOptions` overrides where requested.\n *\n * **Fast path (no overrides):** a single `proxyActivities(defaultOptions)`\n * call is made and returned directly. The proxy synthesizes a function for\n * any property access by name, so downstream code that looks up\n * `proxy[activityName]` works identically to before.\n *\n * **Override path:** one extra `proxyActivities(merged)` call is made *only*\n * for each activity that has an override. Activities without an entry keep\n * using the single default proxy. The result is a `Proxy` that returns the\n * override-bound function for named keys and falls back to the default proxy\n * for everything else — so the per-execution overhead scales with the number\n * of overrides, not the number of activities.\n *\n * Per-override merge is shallow: the override's properties replace the\n * default's, including the entire nested `retry` block. This matches\n * Temporal's \"one ActivityOptions per `proxyActivities` call\" semantics.\n */\nexport function buildRawActivitiesProxy(\n  workflowActivities: Record<string, ActivityDefinition> | undefined,\n  contractActivities: Record<string, ActivityDefinition> | undefined,\n  defaultOptions: ActivityOptions,\n  overrides: Partial<Record<string, ActivityOptions>> | undefined,\n): Record<string, ActivityFn> {\n  const defaultProxy = proxyActivities<Record<string, ActivityFn>>(defaultOptions);\n\n  // Fast path: no overrides → use the single default proxy directly.\n  // (`createValidatedActivities` accesses by name, so the Proxy's get-trap\n  // suffices; we don't need an enumerable map.)\n  const overrideEntries = overrides\n    ? Object.entries(overrides).filter(\n        (entry): entry is [string, ActivityOptions] => entry[1] !== undefined,\n      )\n    : [];\n  if (overrideEntries.length === 0) {\n    return defaultProxy;\n  }\n\n  // Validate every override key corresponds to a declared activity.\n  // Without this, a typo at runtime (or a stale options bag from a renamed\n  // activity) silently builds a proxy for a non-existent activity.\n  const declared = new Set<string>([\n    ...Object.keys(workflowActivities ?? {}),\n    ...Object.keys(contractActivities ?? {}),\n  ]);\n  for (const [name] of overrideEntries) {\n    if (!declared.has(name)) {\n      throw new Error(\n        `activityOptionsByName entry \"${name}\" does not match any declared activity. Available: ${[...declared].join(\", \") || \"none\"}.`,\n      );\n    }\n  }\n\n  // Override path: build one proxy per override; combine with the default\n  // proxy via a get-trap so unmatched keys still get the default options.\n  const overriddenFns: Record<string, ActivityFn> = {};\n  for (const [name, override] of overrideEntries) {\n    const mergedOptions: ActivityOptions = { ...defaultOptions, ...override };\n    const overrideProxy = proxyActivities<Record<string, ActivityFn>>(mergedOptions);\n    const fn = overrideProxy[name];\n    if (fn !== undefined) {\n      overriddenFns[name] = fn;\n    }\n  }\n\n  return new Proxy(overriddenFns, {\n    get(target, prop) {\n      if (typeof prop !== \"string\") return undefined;\n      return target[prop] ?? defaultProxy[prop];\n    },\n  });\n}\n\n/**\n * Continue-as-new options the typed wrapper does not own. `workflowType` and\n * `taskQueue` are derived from the contract; everything else is forwarded to\n * Temporal's `makeContinueAsNewFunc`.\n */\nexport type TypedContinueAsNewOptions = Omit<ContinueAsNewOptions, \"workflowType\" | \"taskQueue\">;\n\n/**\n * Build the typed `continueAsNew` function bound to the running workflow's\n * contract. Two overloads — same-workflow and cross-contract — share one\n * implementation; the public type signature lives on `WorkflowContext` so\n * call sites are type-safe.\n *\n * Validation runs *before* Temporal's `makeContinueAsNewFunc(...)` is invoked.\n * On failure, throws a `WorkflowInputValidationError` (matching the behaviour\n * of `declareWorkflow`'s incoming-input validation), which surfaces back to\n * Temporal as a workflow failure rather than silently proceeding with an\n * invalid run.\n *\n * Temporal's `continueAsNew` never returns — it throws a `ContinueAsNew`\n * exception that the runtime intercepts. The returned function preserves\n * `Promise<never>` to encode that.\n *\n * @internal\n */\nexport function createContinueAsNew(\n  currentContract: ContractDefinition,\n  currentWorkflowName: string | number | symbol,\n) {\n  return async function continueAsNew(\n    arg1: unknown,\n    arg2?: unknown,\n    arg3?: unknown,\n    arg4?: TypedContinueAsNewOptions,\n  ): Promise<never> {\n    // Cross-contract dispatch is only triggered when the call signature\n    // unambiguously matches `(contract, workflowName, args, options?)`:\n    //\n    // 1. `arg1` is a non-null object that *looks like* a contract — it has a\n    //    string `taskQueue` and a non-null `workflows` object.\n    // 2. `arg2` is a string — the destination workflow name.\n    // 3. `arg2` resolves to a workflow definition on `arg1.workflows` with a\n    //    Standard Schema `input.~standard.validate` function.\n    //\n    // Without (2)+(3), a same-workflow input that happens to have `taskQueue`\n    // and `workflows` keys (or `workflows = null`, where `typeof === \"object\"`)\n    // would be silently misclassified. The full triple of structural checks\n    // makes the false-positive surface vanishingly small.\n    const isCrossContract = looksLikeCrossContractCall(arg1, arg2);\n\n    let targetContract: ContractDefinition;\n    let targetName: string;\n    let rawArgs: unknown;\n    let options: TypedContinueAsNewOptions | undefined;\n\n    if (isCrossContract) {\n      targetContract = arg1 as ContractDefinition;\n      targetName = arg2 as string;\n      rawArgs = arg3;\n      options = arg4;\n    } else {\n      targetContract = currentContract;\n      targetName = String(currentWorkflowName);\n      rawArgs = arg1;\n      options = arg2 as TypedContinueAsNewOptions | undefined;\n    }\n\n    const targetDef = targetContract.workflows[targetName];\n    if (!targetDef) {\n      throw new WorkflowInputValidationError(targetName, [\n        {\n          message: `continueAsNew target workflow \"${targetName}\" is not declared on the supplied contract.`,\n        },\n      ]);\n    }\n\n    const inputResult = await targetDef.input[\"~standard\"].validate(rawArgs);\n    if (inputResult.issues) {\n      throw new WorkflowInputValidationError(targetName, inputResult.issues);\n    }\n\n    // workflowType/taskQueue come from the destination contract; user\n    // options are spread last so power users can override (e.g. retry,\n    // memo). The public TypedContinueAsNewOptions type Omits workflowType\n    // and taskQueue so this isn't a footgun on the typed call path.\n    const fn = makeContinueAsNewFunc({\n      workflowType: targetName,\n      taskQueue: targetContract.taskQueue,\n      ...options,\n    });\n\n    await fn(inputResult.value);\n    // Unreachable — Temporal's continueAsNew throws to terminate the run.\n    /* c8 ignore next */\n    return undefined as never;\n  };\n}\n\n/**\n * Structural check: does `(arg1, arg2)` look like the\n * `(contract, workflowName, ...)` cross-contract overload of `continueAsNew`?\n *\n * Returns `true` only when:\n *   1. `arg1` is a non-null object with a string `taskQueue` and a non-null\n *      object `workflows` (handles `workflows: null`, where\n *      `typeof null === \"object\"`).\n *   2. `arg2` is a string.\n *\n * Both halves matter. A same-workflow input that happens to contain\n * `taskQueue` and `workflows` keys would otherwise be misclassified — but\n * none of the same-workflow signatures (`continueAsNew(args)`,\n * `continueAsNew(args, options)`) accept a string as `arg2`, so the\n * second check makes the false-positive surface vanishingly small.\n *\n * We deliberately do *not* check that `arg1.workflows[arg2]` is a valid\n * workflow definition. If it isn't, the dispatcher falls through to the\n * `targetContract.workflows[targetName]` lookup which throws a clear\n * \"target workflow X is not declared\" error — better than silently\n * misrouting a typo back to the current workflow.\n */\nfunction looksLikeCrossContractCall(arg1: unknown, arg2: unknown): boolean {\n  if (typeof arg1 !== \"object\" || arg1 === null) return false;\n  if (typeof arg2 !== \"string\") return false;\n  const candidate = arg1 as Record<string, unknown>;\n  if (typeof candidate[\"taskQueue\"] !== \"string\") return false;\n  const workflows = candidate[\"workflows\"];\n  return typeof workflows === \"object\" && workflows !== null;\n}\n"],"mappings":"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"}

package/dist/internal-Tj4m4f_K.cjs

@@ -0,0 +1,453 @@
+let _temporalio_workflow = require("@temporalio/workflow");
+//#region src/format.ts
+/**
+* Pattern for string keys safe to render with dot notation. A "safe" key is a
+* JavaScript identifier (letters/digits/underscore/$, not starting with a
+* digit). Anything else — keys containing dots, spaces, leading digits, the
+* empty string, the literal string `"0"` etc. — gets bracket-quoted so the
+* path is unambiguous. Reserved words are accepted: we are formatting a
+* diagnostic, not generating runnable code.
+*/
+const SAFE_IDENTIFIER = /^[A-Za-z_$][A-Za-z0-9_$]*$/;
+/**
+* Render a Standard Schema {@link StandardSchemaV1.Issue} into a human-readable
+* string that includes the failing field's path.
+*/
+function formatIssue(issue) {
+	if (issue.path === void 0 || issue.path.length === 0) return issue.message;
+	let path = "";
+	for (let i = 0; i < issue.path.length; i++) {
+		const segment = issue.path[i];
+		const key = segment !== null && typeof segment === "object" && "key" in segment ? segment.key : segment;
+		if (typeof key === "number") path += `[${key}]`;
+		else if (typeof key === "string" && SAFE_IDENTIFIER.test(key)) path += i === 0 ? key : `.${key}`;
+		else if (typeof key === "string") path += `[${JSON.stringify(key)}]`;
+		else path += `[${String(key)}]`;
+	}
+	return `at ${path}: ${issue.message}`;
+}
+/**
+* Join a list of validation issues into a single message, with each issue
+* rendered via {@link formatIssue} so field paths surface in the error text.
+*/
+function summarizeIssues(issues) {
+	return issues.map(formatIssue).join("; ");
+}
+/**
+* Build the message attached to a `ChildWorkflowError` for input/output
+* validation failures. Centralized so the worker and any future call sites
+* format identically.
+*/
+function formatChildWorkflowValidationMessage(workflowName, direction, issues) {
+	return `Child workflow "${workflowName}" ${direction} validation failed: ${summarizeIssues(issues)}`;
+}
+//#endregion
+//#region src/errors.ts
+/**
+* Base error class for worker errors
+*/
+var WorkerError = class extends Error {
+	constructor(message, cause) {
+		super(message, { cause });
+		this.name = "WorkerError";
+		if (Error.captureStackTrace) Error.captureStackTrace(this, this.constructor);
+	}
+};
+/**
+* Error thrown when an activity definition is not found in the contract
+*/
+var ActivityDefinitionNotFoundError = class extends WorkerError {
+	constructor(activityName, availableDefinitions = []) {
+		const available = availableDefinitions.length > 0 ? availableDefinitions.join(", ") : "none";
+		super(`Activity definition not found for: "${activityName}". Available activities: ${available}`);
+		this.activityName = activityName;
+		this.availableDefinitions = availableDefinitions;
+		this.name = "ActivityDefinitionNotFoundError";
+	}
+};
+/**
+* Error thrown when activity input validation fails
+*/
+var ActivityInputValidationError = class extends WorkerError {
+	constructor(activityName, issues) {
+		const message = summarizeIssues(issues);
+		super(`Activity "${activityName}" input validation failed: ${message}`);
+		this.activityName = activityName;
+		this.issues = issues;
+		this.name = "ActivityInputValidationError";
+	}
+};
+/**
+* Error thrown when activity output validation fails
+*/
+var ActivityOutputValidationError = class extends WorkerError {
+	constructor(activityName, issues) {
+		const message = summarizeIssues(issues);
+		super(`Activity "${activityName}" output validation failed: ${message}`);
+		this.activityName = activityName;
+		this.issues = issues;
+		this.name = "ActivityOutputValidationError";
+	}
+};
+/**
+* Error thrown when workflow input validation fails
+*/
+var WorkflowInputValidationError = class extends WorkerError {
+	constructor(workflowName, issues) {
+		const message = summarizeIssues(issues);
+		super(`Workflow "${workflowName}" input validation failed: ${message}`);
+		this.workflowName = workflowName;
+		this.issues = issues;
+		this.name = "WorkflowInputValidationError";
+	}
+};
+/**
+* Error thrown when workflow output validation fails
+*/
+var WorkflowOutputValidationError = class extends WorkerError {
+	constructor(workflowName, issues) {
+		const message = summarizeIssues(issues);
+		super(`Workflow "${workflowName}" output validation failed: ${message}`);
+		this.workflowName = workflowName;
+		this.issues = issues;
+		this.name = "WorkflowOutputValidationError";
+	}
+};
+/**
+* Error thrown when signal input validation fails
+*/
+var SignalInputValidationError = class extends WorkerError {
+	constructor(signalName, issues) {
+		const message = summarizeIssues(issues);
+		super(`Signal "${signalName}" input validation failed: ${message}`);
+		this.signalName = signalName;
+		this.issues = issues;
+		this.name = "SignalInputValidationError";
+	}
+};
+/**
+* Error thrown when query input validation fails
+*/
+var QueryInputValidationError = class extends WorkerError {
+	constructor(queryName, issues) {
+		const message = summarizeIssues(issues);
+		super(`Query "${queryName}" input validation failed: ${message}`);
+		this.queryName = queryName;
+		this.issues = issues;
+		this.name = "QueryInputValidationError";
+	}
+};
+/**
+* Error thrown when query output validation fails
+*/
+var QueryOutputValidationError = class extends WorkerError {
+	constructor(queryName, issues) {
+		const message = summarizeIssues(issues);
+		super(`Query "${queryName}" output validation failed: ${message}`);
+		this.queryName = queryName;
+		this.issues = issues;
+		this.name = "QueryOutputValidationError";
+	}
+};
+/**
+* Error thrown when update input validation fails
+*/
+var UpdateInputValidationError = class extends WorkerError {
+	constructor(updateName, issues) {
+		const message = summarizeIssues(issues);
+		super(`Update "${updateName}" input validation failed: ${message}`);
+		this.updateName = updateName;
+		this.issues = issues;
+		this.name = "UpdateInputValidationError";
+	}
+};
+/**
+* Error thrown when update output validation fails
+*/
+var UpdateOutputValidationError = class extends WorkerError {
+	constructor(updateName, issues) {
+		const message = summarizeIssues(issues);
+		super(`Update "${updateName}" output validation failed: ${message}`);
+		this.updateName = updateName;
+		this.issues = issues;
+		this.name = "UpdateOutputValidationError";
+	}
+};
+/**
+* Error thrown when a child workflow is not found in the contract
+*/
+var ChildWorkflowNotFoundError = class extends WorkerError {
+	constructor(workflowName, availableWorkflows = []) {
+		const available = availableWorkflows.length > 0 ? availableWorkflows.join(", ") : "none";
+		super(`Child workflow not found: "${workflowName}". Available workflows: ${available}`);
+		this.workflowName = workflowName;
+		this.availableWorkflows = availableWorkflows;
+		this.name = "ChildWorkflowNotFoundError";
+	}
+};
+/**
+* Generic error for child workflow operations
+*/
+var ChildWorkflowError = class extends WorkerError {
+	constructor(message, cause) {
+		super(message, cause);
+		this.name = "ChildWorkflowError";
+	}
+};
+/**
+* Error returned in the `Result.Error` branch when a typed cancellation
+* scope is cancelled via Temporal's cancellation propagation. Returned by
+* both `context.cancellableScope` (when the workflow or an ancestor scope
+* cancels) and `context.nonCancellableScope` (when cancellation is raised
+* from inside the scope). Distinct from arbitrary thrown errors so call
+* sites can branch on cancellation explicitly while still surfacing
+* non-cancellation errors as Future rejections.
+*/
+var WorkflowCancelledError = class extends WorkerError {
+	constructor(cause) {
+		super("Workflow cancellation scope was cancelled", cause);
+		this.name = "WorkflowCancelledError";
+	}
+};
+//#endregion
+//#region src/internal.ts
+/**
+* Internal helpers shared across the worker package's entry points.
+*
+* Not part of the public API — this module is not listed in the package's
+* `exports` map, so consumers can't import from `@temporal-contract/worker/internal`.
+* In-package tests import it directly via relative path.
+*/
+/**
+* Extract the single payload from a Temporal handler's `...args` array.
+*
+* Temporal invokes handlers with whatever was passed via `args: [...]` at the
+* call site. The typed-contract layer always sends `args: [validatedInput]`,
+* so the common case is a one-element array containing the wrapped input.
+*
+* If a non-typed-contract caller passes multiple positional arguments
+* (`args: [a, b, c]`), we surface the whole array as the input — the schema
+* will then reject it unless the contract specifically modeled a tuple.
+*/
+function extractHandlerInput(args) {
+	return args.length === 1 ? args[0] : args;
+}
+/**
+* Build the raw `Record<name, fn>` proxy of activities for a workflow,
+* applying per-activity `ActivityOptions` overrides where requested.
+*
+* **Fast path (no overrides):** a single `proxyActivities(defaultOptions)`
+* call is made and returned directly. The proxy synthesizes a function for
+* any property access by name, so downstream code that looks up
+* `proxy[activityName]` works identically to before.
+*
+* **Override path:** one extra `proxyActivities(merged)` call is made *only*
+* for each activity that has an override. Activities without an entry keep
+* using the single default proxy. The result is a `Proxy` that returns the
+* override-bound function for named keys and falls back to the default proxy
+* for everything else — so the per-execution overhead scales with the number
+* of overrides, not the number of activities.
+*
+* Per-override merge is shallow: the override's properties replace the
+* default's, including the entire nested `retry` block. This matches
+* Temporal's "one ActivityOptions per `proxyActivities` call" semantics.
+*/
+function buildRawActivitiesProxy(workflowActivities, contractActivities, defaultOptions, overrides) {
+	const defaultProxy = (0, _temporalio_workflow.proxyActivities)(defaultOptions);
+	const overrideEntries = overrides ? Object.entries(overrides).filter((entry) => entry[1] !== void 0) : [];
+	if (overrideEntries.length === 0) return defaultProxy;
+	const declared = new Set([...Object.keys(workflowActivities ?? {}), ...Object.keys(contractActivities ?? {})]);
+	for (const [name] of overrideEntries) if (!declared.has(name)) throw new Error(`activityOptionsByName entry "${name}" does not match any declared activity. Available: ${[...declared].join(", ") || "none"}.`);
+	const overriddenFns = {};
+	for (const [name, override] of overrideEntries) {
+		const fn = (0, _temporalio_workflow.proxyActivities)({
+			...defaultOptions,
+			...override
+		})[name];
+		if (fn !== void 0) overriddenFns[name] = fn;
+	}
+	return new Proxy(overriddenFns, { get(target, prop) {
+		if (typeof prop !== "string") return void 0;
+		return target[prop] ?? defaultProxy[prop];
+	} });
+}
+/**
+* Build the typed `continueAsNew` function bound to the running workflow's
+* contract. Two overloads — same-workflow and cross-contract — share one
+* implementation; the public type signature lives on `WorkflowContext` so
+* call sites are type-safe.
+*
+* Validation runs *before* Temporal's `makeContinueAsNewFunc(...)` is invoked.
+* On failure, throws a `WorkflowInputValidationError` (matching the behaviour
+* of `declareWorkflow`'s incoming-input validation), which surfaces back to
+* Temporal as a workflow failure rather than silently proceeding with an
+* invalid run.
+*
+* Temporal's `continueAsNew` never returns — it throws a `ContinueAsNew`
+* exception that the runtime intercepts. The returned function preserves
+* `Promise<never>` to encode that.
+*
+* @internal
+*/
+function createContinueAsNew(currentContract, currentWorkflowName) {
+	return async function continueAsNew(arg1, arg2, arg3, arg4) {
+		const isCrossContract = looksLikeCrossContractCall(arg1, arg2);
+		let targetContract;
+		let targetName;
+		let rawArgs;
+		let options;
+		if (isCrossContract) {
+			targetContract = arg1;
+			targetName = arg2;
+			rawArgs = arg3;
+			options = arg4;
+		} else {
+			targetContract = currentContract;
+			targetName = String(currentWorkflowName);
+			rawArgs = arg1;
+			options = arg2;
+		}
+		const targetDef = targetContract.workflows[targetName];
+		if (!targetDef) throw new WorkflowInputValidationError(targetName, [{ message: `continueAsNew target workflow "${targetName}" is not declared on the supplied contract.` }]);
+		const inputResult = await targetDef.input["~standard"].validate(rawArgs);
+		if (inputResult.issues) throw new WorkflowInputValidationError(targetName, inputResult.issues);
+		await (0, _temporalio_workflow.makeContinueAsNewFunc)({
+			workflowType: targetName,
+			taskQueue: targetContract.taskQueue,
+			...options
+		})(inputResult.value);
+	};
+}
+/**
+* Structural check: does `(arg1, arg2)` look like the
+* `(contract, workflowName, ...)` cross-contract overload of `continueAsNew`?
+*
+* Returns `true` only when:
+*   1. `arg1` is a non-null object with a string `taskQueue` and a non-null
+*      object `workflows` (handles `workflows: null`, where
+*      `typeof null === "object"`).
+*   2. `arg2` is a string.
+*
+* Both halves matter. A same-workflow input that happens to contain
+* `taskQueue` and `workflows` keys would otherwise be misclassified — but
+* none of the same-workflow signatures (`continueAsNew(args)`,
+* `continueAsNew(args, options)`) accept a string as `arg2`, so the
+* second check makes the false-positive surface vanishingly small.
+*
+* We deliberately do *not* check that `arg1.workflows[arg2]` is a valid
+* workflow definition. If it isn't, the dispatcher falls through to the
+* `targetContract.workflows[targetName]` lookup which throws a clear
+* "target workflow X is not declared" error — better than silently
+* misrouting a typo back to the current workflow.
+*/
+function looksLikeCrossContractCall(arg1, arg2) {
+	if (typeof arg1 !== "object" || arg1 === null) return false;
+	if (typeof arg2 !== "string") return false;
+	const candidate = arg1;
+	if (typeof candidate["taskQueue"] !== "string") return false;
+	const workflows = candidate["workflows"];
+	return typeof workflows === "object" && workflows !== null;
+}
+//#endregion
+Object.defineProperty(exports, "ActivityDefinitionNotFoundError", {
+	enumerable: true,
+	get: function() {
+		return ActivityDefinitionNotFoundError;
+	}
+});
+Object.defineProperty(exports, "ActivityInputValidationError", {
+	enumerable: true,
+	get: function() {
+		return ActivityInputValidationError;
+	}
+});
+Object.defineProperty(exports, "ActivityOutputValidationError", {
+	enumerable: true,
+	get: function() {
+		return ActivityOutputValidationError;
+	}
+});
+Object.defineProperty(exports, "ChildWorkflowError", {
+	enumerable: true,
+	get: function() {
+		return ChildWorkflowError;
+	}
+});
+Object.defineProperty(exports, "ChildWorkflowNotFoundError", {
+	enumerable: true,
+	get: function() {
+		return ChildWorkflowNotFoundError;
+	}
+});
+Object.defineProperty(exports, "QueryInputValidationError", {
+	enumerable: true,
+	get: function() {
+		return QueryInputValidationError;
+	}
+});
+Object.defineProperty(exports, "QueryOutputValidationError", {
+	enumerable: true,
+	get: function() {
+		return QueryOutputValidationError;
+	}
+});
+Object.defineProperty(exports, "SignalInputValidationError", {
+	enumerable: true,
+	get: function() {
+		return SignalInputValidationError;
+	}
+});
+Object.defineProperty(exports, "UpdateInputValidationError", {
+	enumerable: true,
+	get: function() {
+		return UpdateInputValidationError;
+	}
+});
+Object.defineProperty(exports, "UpdateOutputValidationError", {
+	enumerable: true,
+	get: function() {
+		return UpdateOutputValidationError;
+	}
+});
+Object.defineProperty(exports, "WorkflowCancelledError", {
+	enumerable: true,
+	get: function() {
+		return WorkflowCancelledError;
+	}
+});
+Object.defineProperty(exports, "WorkflowInputValidationError", {
+	enumerable: true,
+	get: function() {
+		return WorkflowInputValidationError;
+	}
+});
+Object.defineProperty(exports, "WorkflowOutputValidationError", {
+	enumerable: true,
+	get: function() {
+		return WorkflowOutputValidationError;
+	}
+});
+Object.defineProperty(exports, "buildRawActivitiesProxy", {
+	enumerable: true,
+	get: function() {
+		return buildRawActivitiesProxy;
+	}
+});
+Object.defineProperty(exports, "createContinueAsNew", {
+	enumerable: true,
+	get: function() {
+		return createContinueAsNew;
+	}
+});
+Object.defineProperty(exports, "extractHandlerInput", {
+	enumerable: true,
+	get: function() {
+		return extractHandlerInput;
+	}
+});
+Object.defineProperty(exports, "formatChildWorkflowValidationMessage", {
+	enumerable: true,
+	get: function() {
+		return formatChildWorkflowValidationMessage;
+	}
+});

package/dist/worker.cjs

@@ -1,7 +1,6 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 let _temporalio_worker = require("@temporalio/worker");
 let node_url = require("node:url");
-let node_path = require("node:path");
-
 //#region src/worker.ts
 /**
 * Create a typed Temporal worker with contract-based configuration
@@ -40,9 +39,14 @@ async function createWorker(options) {
 	});
 }
 /**
-* Helper to create a workflowsPath from a file URL
+* Helper to resolve a workflow file path relative to the current module's URL.
 *
-* Useful for creating the workflowsPath option when using ES modules
+* Useful when using ES modules (`import.meta.url`) to locate workflow files.
+* The `relativePath` should include the file extension explicitly (e.g. `./workflows.js`)
+* to ensure the resolved path is unambiguous in both source and built contexts.
+*
+* @param baseURL - The base URL to resolve from, typically `import.meta.url`
+* @param relativePath - Relative path to the workflows file, **including extension**
 *
 * @example
 * ```ts
@@ -51,15 +55,15 @@ async function createWorker(options) {
 * const worker = await createWorker({
 *   contract: myContract,
 *   connection,
-*   workflowsPath: workflowsPathFromURL(import.meta.url, './workflows'),
+*   // Include the extension explicitly to work in both source (.ts) and build (.js) contexts
+*   workflowsPath: workflowsPathFromURL(import.meta.url, './workflows.js'),
 *   activities,
 * });
 * ```
 */
 function workflowsPathFromURL(baseURL, relativePath) {
-	return (0, node_url.fileURLToPath)(new URL(`${relativePath}${(0, node_path.extname)(baseURL)}`, baseURL));
+	return (0, node_url.fileURLToPath)(new URL(relativePath, baseURL));
 }
-
 //#endregion
 exports.createWorker = createWorker;
-exports.workflowsPathFromURL = workflowsPathFromURL;
+exports.workflowsPathFromURL = workflowsPathFromURL;

package/dist/worker.d.cts

@@ -1,4 +1,4 @@
-import { t as ActivitiesHandler } from "./activity-5pVNjW7l.cjs";
+import { ActivitiesHandler } from "./activity.cjs";
 import { ContractDefinition } from "@temporal-contract/contract";
 import { Worker, WorkerOptions } from "@temporalio/worker";
 
@@ -6,7 +6,7 @@ import { Worker, WorkerOptions } from "@temporalio/worker";
 /**
  * Options for creating a Temporal worker
  */
-interface CreateWorkerOptions<TContract extends ContractDefinition> extends Omit<WorkerOptions, "activities" | "taskQueue"> {
+type CreateWorkerOptions<TContract extends ContractDefinition> = Omit<WorkerOptions, "activities" | "taskQueue"> & {
   /**
    * The contract definition for this worker
    */
@@ -15,7 +15,7 @@ interface CreateWorkerOptions<TContract extends ContractDefinition> extends Omit
    * Activities handler for this worker
    */
   activities: ActivitiesHandler<TContract>;
-}
+};
 /**
  * Create a typed Temporal worker with contract-based configuration
  *
@@ -46,9 +46,14 @@ interface CreateWorkerOptions<TContract extends ContractDefinition> extends Omit
  */
 declare function createWorker<TContract extends ContractDefinition>(options: CreateWorkerOptions<TContract>): Promise<Worker>;
 /**
- * Helper to create a workflowsPath from a file URL
+ * Helper to resolve a workflow file path relative to the current module's URL.
  *
- * Useful for creating the workflowsPath option when using ES modules
+ * Useful when using ES modules (`import.meta.url`) to locate workflow files.
+ * The `relativePath` should include the file extension explicitly (e.g. `./workflows.js`)
+ * to ensure the resolved path is unambiguous in both source and built contexts.
+ *
+ * @param baseURL - The base URL to resolve from, typically `import.meta.url`
+ * @param relativePath - Relative path to the workflows file, **including extension**
  *
  * @example
  * ```ts
@@ -57,11 +62,13 @@ declare function createWorker<TContract extends ContractDefinition>(options: Cre
  * const worker = await createWorker({
  *   contract: myContract,
  *   connection,
- *   workflowsPath: workflowsPathFromURL(import.meta.url, './workflows'),
+ *   // Include the extension explicitly to work in both source (.ts) and build (.js) contexts
+ *   workflowsPath: workflowsPathFromURL(import.meta.url, './workflows.js'),
  *   activities,
  * });
  * ```
  */
 declare function workflowsPathFromURL(baseURL: string, relativePath: string): string;
 //#endregion
-export { CreateWorkerOptions, createWorker, workflowsPathFromURL };
+export { CreateWorkerOptions, createWorker, workflowsPathFromURL };
+//# sourceMappingURL=worker.d.cts.map

package/dist/worker.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.cts","names":[],"sources":["../src/worker.ts"],"mappings":";;;;;;;AASA;KAAY,mBAAA,mBAAsC,kBAAA,IAAsB,IAAA,CACtE,aAAA;EAD6B;;;EAO7B,QAAA,EAAU,SAAA;EAAA;;;EAKV,UAAA,EAAY,iBAAA,CAAkB,SAAA;AAAA;;;;;;;;;;;;AA+BhC;;;;;;;;;;;;;;;;;iBAAsB,YAAA,mBAA+B,kBAAA,CAAA,CACnD,OAAA,EAAS,mBAAA,CAAoB,SAAA,IAC5B,OAAA,CAAQ,MAAA;;AAkCX;;;;;;;;;;;;;;;;;;;;;;iBAAgB,oBAAA,CAAqB,OAAA,UAAiB,YAAA"}

package/dist/worker.d.mts

@@ -1,4 +1,4 @@
-import { t as ActivitiesHandler } from "./activity-BUEBZ7SL.mjs";
+import { ActivitiesHandler } from "./activity.mjs";
 import { Worker, WorkerOptions } from "@temporalio/worker";
 import { ContractDefinition } from "@temporal-contract/contract";
 
@@ -6,7 +6,7 @@ import { ContractDefinition } from "@temporal-contract/contract";
 /**
  * Options for creating a Temporal worker
  */
-interface CreateWorkerOptions<TContract extends ContractDefinition> extends Omit<WorkerOptions, "activities" | "taskQueue"> {
+type CreateWorkerOptions<TContract extends ContractDefinition> = Omit<WorkerOptions, "activities" | "taskQueue"> & {
   /**
    * The contract definition for this worker
    */
@@ -15,7 +15,7 @@ interface CreateWorkerOptions<TContract extends ContractDefinition> extends Omit
    * Activities handler for this worker
    */
   activities: ActivitiesHandler<TContract>;
-}
+};
 /**
  * Create a typed Temporal worker with contract-based configuration
  *
@@ -46,9 +46,14 @@ interface CreateWorkerOptions<TContract extends ContractDefinition> extends Omit
  */
 declare function createWorker<TContract extends ContractDefinition>(options: CreateWorkerOptions<TContract>): Promise<Worker>;
 /**
- * Helper to create a workflowsPath from a file URL
+ * Helper to resolve a workflow file path relative to the current module's URL.
  *
- * Useful for creating the workflowsPath option when using ES modules
+ * Useful when using ES modules (`import.meta.url`) to locate workflow files.
+ * The `relativePath` should include the file extension explicitly (e.g. `./workflows.js`)
+ * to ensure the resolved path is unambiguous in both source and built contexts.
+ *
+ * @param baseURL - The base URL to resolve from, typically `import.meta.url`
+ * @param relativePath - Relative path to the workflows file, **including extension**
  *
  * @example
  * ```ts
@@ -57,11 +62,13 @@ declare function createWorker<TContract extends ContractDefinition>(options: Cre
  * const worker = await createWorker({
  *   contract: myContract,
  *   connection,
- *   workflowsPath: workflowsPathFromURL(import.meta.url, './workflows'),
+ *   // Include the extension explicitly to work in both source (.ts) and build (.js) contexts
+ *   workflowsPath: workflowsPathFromURL(import.meta.url, './workflows.js'),
  *   activities,
  * });
  * ```
  */
 declare function workflowsPathFromURL(baseURL: string, relativePath: string): string;
 //#endregion
-export { CreateWorkerOptions, createWorker, workflowsPathFromURL };
+export { CreateWorkerOptions, createWorker, workflowsPathFromURL };
+//# sourceMappingURL=worker.d.mts.map