@temelj/workflow 0.0.0-alpha.1

package/dist/errors/mod.d.mts

@@ -0,0 +1,17 @@
+import { WorkflowErrorCode, workflowErrorCodeSchema } from "../types/error-code.mjs";
+import { WorkflowErrorOptions, WorkflowErrorRecord, WorkflowNonRetryableErrorOptions, WorkflowRetryableErrorOptions, workflowErrorRecordSchema } from "../types/error.mjs";
+import { WorkflowError, WorkflowMessageError, WorkflowOptionsError, WorkflowRunError, WorkflowStateError, WorkflowStepError } from "./base.mjs";
+import { WorkflowCapabilityError } from "./capability.mjs";
+import { WorkflowDefinitionError } from "./definition.mjs";
+import { WorkflowDurationError, WorkflowNonRetryableError, WorkflowPermanentFailureError, WorkflowReplayDivergenceError, WorkflowRetryableError, WorkflowSerializationError } from "./failures.mjs";
+import { WorkflowHookError } from "./hook.mjs";
+import { WorkflowImplementationNotFoundError } from "./implementation.mjs";
+import { WorkflowLockError, WorkflowLockStateError } from "./lock.mjs";
+import { WorkflowHookDisposedError, WorkflowMessageDeliveryError, WorkflowMessageIdempotencyConflictError, WorkflowMessageWaitTimeoutError } from "./message.mjs";
+import { WorkflowChildWorkflowTimeoutError, WorkflowResultTimeoutError, WorkflowRunCanceledError, WorkflowRunCancellationError, WorkflowRunDeadlineExceededError, WorkflowRunInvalidError, WorkflowRunMismatchError, WorkflowRunNotFoundError, WorkflowRunParentError, WorkflowRunTransitionError } from "./run.mjs";
+import { WorkflowRuntimeError } from "./runtime.mjs";
+import { WorkflowScheduleAlreadyExistsError, WorkflowScheduleError } from "./schedule.mjs";
+import { WorkflowStepAttemptLimitError, WorkflowStepExecutionError, WorkflowStepRetryLimitError, WorkflowStepTimeoutError } from "./step.mjs";
+import { WorkflowStreamError, WorkflowStreamNotFoundError } from "./stream.mjs";
+import { workflowErrorRecordView } from "./record-view.mjs";
+export { WorkflowCapabilityError, WorkflowChildWorkflowTimeoutError, WorkflowDefinitionError, WorkflowDurationError, WorkflowError, WorkflowErrorCode, type WorkflowErrorCode as WorkflowErrorCodeType, type WorkflowErrorOptions, type WorkflowErrorRecord, WorkflowHookDisposedError, WorkflowHookError, WorkflowImplementationNotFoundError, WorkflowLockError, WorkflowLockStateError, WorkflowMessageDeliveryError, WorkflowMessageError, WorkflowMessageIdempotencyConflictError, WorkflowMessageWaitTimeoutError, WorkflowNonRetryableError, type WorkflowNonRetryableErrorOptions, WorkflowOptionsError, WorkflowPermanentFailureError, WorkflowReplayDivergenceError, WorkflowResultTimeoutError, WorkflowRetryableError, type WorkflowRetryableErrorOptions, WorkflowRunCanceledError, WorkflowRunCancellationError, WorkflowRunDeadlineExceededError, WorkflowRunError, WorkflowRunInvalidError, WorkflowRunMismatchError, WorkflowRunNotFoundError, WorkflowRunParentError, WorkflowRunTransitionError, WorkflowRuntimeError, WorkflowScheduleAlreadyExistsError, WorkflowScheduleError, WorkflowSerializationError, WorkflowStateError, WorkflowStepAttemptLimitError, WorkflowStepError, WorkflowStepExecutionError, WorkflowStepRetryLimitError, WorkflowStepTimeoutError, WorkflowStreamError, WorkflowStreamNotFoundError, workflowErrorCodeSchema, workflowErrorRecordSchema, workflowErrorRecordView };

package/dist/errors/mod.mjs

@@ -0,0 +1,17 @@
+import { WorkflowErrorCode, workflowErrorCodeSchema } from "../types/error-code.mjs";
+import { WorkflowError, WorkflowMessageError, WorkflowOptionsError, WorkflowRunError, WorkflowStateError, WorkflowStepError } from "./base.mjs";
+import { workflowErrorRecordView } from "./record-view.mjs";
+import { WorkflowDurationError, WorkflowNonRetryableError, WorkflowPermanentFailureError, WorkflowReplayDivergenceError, WorkflowRetryableError, WorkflowSerializationError } from "./failures.mjs";
+import { WorkflowChildWorkflowTimeoutError, WorkflowResultTimeoutError, WorkflowRunCanceledError, WorkflowRunCancellationError, WorkflowRunDeadlineExceededError, WorkflowRunInvalidError, WorkflowRunMismatchError, WorkflowRunNotFoundError, WorkflowRunParentError, WorkflowRunTransitionError } from "./run.mjs";
+import { workflowErrorRecordSchema } from "../types/error.mjs";
+import { WorkflowCapabilityError } from "./capability.mjs";
+import { WorkflowDefinitionError } from "./definition.mjs";
+import { WorkflowHookError } from "./hook.mjs";
+import { WorkflowImplementationNotFoundError } from "./implementation.mjs";
+import { WorkflowLockError, WorkflowLockStateError } from "./lock.mjs";
+import { WorkflowHookDisposedError, WorkflowMessageDeliveryError, WorkflowMessageIdempotencyConflictError, WorkflowMessageWaitTimeoutError } from "./message.mjs";
+import { WorkflowRuntimeError } from "./runtime.mjs";
+import { WorkflowScheduleAlreadyExistsError, WorkflowScheduleError } from "./schedule.mjs";
+import { WorkflowStepAttemptLimitError, WorkflowStepExecutionError, WorkflowStepRetryLimitError, WorkflowStepTimeoutError } from "./step.mjs";
+import { WorkflowStreamError, WorkflowStreamNotFoundError } from "./stream.mjs";
+export { WorkflowCapabilityError, WorkflowChildWorkflowTimeoutError, WorkflowDefinitionError, WorkflowDurationError, WorkflowError, WorkflowErrorCode, WorkflowHookDisposedError, WorkflowHookError, WorkflowImplementationNotFoundError, WorkflowLockError, WorkflowLockStateError, WorkflowMessageDeliveryError, WorkflowMessageError, WorkflowMessageIdempotencyConflictError, WorkflowMessageWaitTimeoutError, WorkflowNonRetryableError, WorkflowOptionsError, WorkflowPermanentFailureError, WorkflowReplayDivergenceError, WorkflowResultTimeoutError, WorkflowRetryableError, WorkflowRunCanceledError, WorkflowRunCancellationError, WorkflowRunDeadlineExceededError, WorkflowRunError, WorkflowRunInvalidError, WorkflowRunMismatchError, WorkflowRunNotFoundError, WorkflowRunParentError, WorkflowRunTransitionError, WorkflowRuntimeError, WorkflowScheduleAlreadyExistsError, WorkflowScheduleError, WorkflowSerializationError, WorkflowStateError, WorkflowStepAttemptLimitError, WorkflowStepError, WorkflowStepExecutionError, WorkflowStepRetryLimitError, WorkflowStepTimeoutError, WorkflowStreamError, WorkflowStreamNotFoundError, workflowErrorCodeSchema, workflowErrorRecordSchema, workflowErrorRecordView };

package/dist/errors/record-view.d.mts

@@ -0,0 +1,11 @@
+import { WorkflowErrorCode } from "../types/error-code.mjs";
+import { WorkflowErrorDetails } from "../types/error.mjs";
+//#region src/errors/record-view.d.ts
+interface WorkflowErrorRecordView {
+  readonly code: WorkflowErrorCode;
+  readonly details?: WorkflowErrorDetails;
+}
+/** Safely exposes fields shared by live workflow errors and persisted workflow error records. */
+declare function workflowErrorRecordView(error: unknown): WorkflowErrorRecordView | undefined;
+//#endregion
+export { WorkflowErrorRecordView, workflowErrorRecordView };

package/dist/errors/record-view.mjs

@@ -0,0 +1,24 @@
+import { workflowErrorCodeSchema } from "../types/error-code.mjs";
+//#region src/errors/record-view.ts
+/** Safely exposes fields shared by live workflow errors and persisted workflow error records. */
+function workflowErrorRecordView(error) {
+	if (typeof error !== "object" || error === null) return;
+	const code = "code" in error ? workflowErrorCodeSchema.safeParse(error.code) : void 0;
+	if (code === void 0 || !code.success) return;
+	if (!("details" in error) || error.details === void 0) return { code: code.data };
+	const details = workflowErrorDetailsView(error.details);
+	return details === void 0 ? void 0 : {
+		code: code.data,
+		details
+	};
+}
+function workflowErrorDetailsView(details) {
+	if (typeof details !== "object" || details === null || Array.isArray(details)) return;
+	const prototype = Object.getPrototypeOf(details);
+	if (prototype !== Object.prototype && prototype !== null) return;
+	const entries = Object.entries(details);
+	if (entries.some(([key, value]) => key.trim() === "" || !(typeof value === "string" || typeof value === "number" || typeof value === "boolean" || value === null))) return;
+	return Object.fromEntries(entries);
+}
+//#endregion
+export { workflowErrorRecordView };

package/dist/errors/records.d.mts

@@ -0,0 +1,7 @@
+import { WorkflowErrorRecord } from "../types/error.mjs";
+import { WorkflowError } from "./base.mjs";
+//#region src/errors/records.d.ts
+/** Reconstructs a workflow error instance from a persisted error record. */
+declare function workflowErrorFromRecord(record: WorkflowErrorRecord): WorkflowError;
+//#endregion
+export { workflowErrorFromRecord };

package/dist/errors/records.mjs

@@ -0,0 +1,280 @@
+import { workflowErrorCodeSchema } from "../types/error-code.mjs";
+import { WorkflowError, WorkflowMessageError, WorkflowOptionsError, WorkflowRunError, WorkflowStateError, WorkflowStepError } from "./base.mjs";
+import { WorkflowDurationError, WorkflowNonRetryableError, WorkflowPermanentFailureError, WorkflowReplayDivergenceError, WorkflowRetryableError, WorkflowSerializationError } from "./failures.mjs";
+import { WorkflowChildWorkflowTimeoutError, WorkflowResultTimeoutError, WorkflowRunCanceledError, WorkflowRunCancellationError, WorkflowRunDeadlineExceededError, WorkflowRunMismatchError, WorkflowRunNotFoundError, WorkflowRunParentError, WorkflowRunTransitionError } from "./run.mjs";
+import { sanitizedWorkflowErrorDetails } from "../types/error.mjs";
+import { WorkflowCapabilityError } from "./capability.mjs";
+import { WorkflowDefinitionError } from "./definition.mjs";
+import { WorkflowHookError } from "./hook.mjs";
+import { WorkflowImplementationNotFoundError } from "./implementation.mjs";
+import { WorkflowLockError, WorkflowLockStateError } from "./lock.mjs";
+import { WorkflowHookDisposedError, WorkflowMessageDeliveryError, WorkflowMessageIdempotencyConflictError, WorkflowMessageWaitTimeoutError } from "./message.mjs";
+import { WorkflowRuntimeError } from "./runtime.mjs";
+import { WorkflowScheduleAlreadyExistsError, WorkflowScheduleError } from "./schedule.mjs";
+import { WorkflowStepAttemptLimitError, WorkflowStepExecutionError, WorkflowStepRetryLimitError, WorkflowStepTimeoutError } from "./step.mjs";
+import { WorkflowStreamError, WorkflowStreamNotFoundError } from "./stream.mjs";
+import { hasWorkflowErrorCauseDetails, unprefixWorkflowErrorCauseDetails, workflowErrorDetailDuration, workflowErrorDetailPositiveSafeInteger, workflowErrorDetailString, workflowErrorDetailTimestamp, workflowErrorRunStatusOrUndefined, workflowTerminalErrorRunStatusOrUndefined } from "./details.mjs";
+//#region src/errors/records.ts
+/** Reconstructs a workflow error instance from a persisted error record. */
+function workflowErrorFromRecord(record) {
+	const normalizedRecord = typeof record === "object" && record !== null && !Array.isArray(record) && (Object.getPrototypeOf(record) === Object.prototype || Object.getPrototypeOf(record) === null) ? record : {};
+	const recordName = typeof normalizedRecord.name === "string" && normalizedRecord.name.trim() !== "" ? normalizedRecord.name : "WorkflowError";
+	const recordMessage = typeof normalizedRecord.message === "string" && normalizedRecord.message.trim() !== "" ? normalizedRecord.message : recordName;
+	const error = typedWorkflowErrorFromRecord(normalizedRecord, recordMessage) ?? WorkflowError.fromMessage(recordMessage, { details: sanitizedWorkflowErrorDetails(normalizedRecord.details) });
+	error.name = recordName;
+	error.message = recordMessage;
+	const recordCode = workflowErrorCodeSchema.safeParse(normalizedRecord.code);
+	if (recordCode.success) Object.defineProperty(error, "code", { value: recordCode.data });
+	const recordStack = typeof normalizedRecord.stack === "string" && normalizedRecord.stack.trim() !== "" ? normalizedRecord.stack : void 0;
+	if (recordStack !== void 0) error.stack = recordStack;
+	return error;
+}
+function typedWorkflowErrorFromRecord(record, recordMessage) {
+	return (record.name === void 0 ? void 0 : workflowErrorRecordFactories[record.name])?.(record, recordMessage);
+}
+const workflowErrorRecordFactories = {
+	WorkflowHookError: domainWorkflowErrorFactory(WorkflowHookError),
+	WorkflowLockError: domainWorkflowErrorFactory(WorkflowLockError),
+	WorkflowLockStateError: domainWorkflowErrorFactory(WorkflowLockStateError),
+	WorkflowScheduleError: domainWorkflowErrorFactory(WorkflowScheduleError),
+	WorkflowStreamError: domainWorkflowErrorFactory(WorkflowStreamError),
+	WorkflowScheduleAlreadyExistsError(record) {
+		const scheduleId = workflowErrorDetailString(record.details, "scheduleId");
+		return scheduleId === void 0 ? void 0 : WorkflowScheduleAlreadyExistsError.create(scheduleId);
+	},
+	WorkflowStreamNotFoundError(record) {
+		const streamIdOrName = workflowErrorDetailString(record.details, "streamIdOrName");
+		return streamIdOrName === void 0 ? void 0 : WorkflowStreamNotFoundError.create(streamIdOrName);
+	},
+	WorkflowImplementationNotFoundError(record) {
+		const details = record.details;
+		const workflowName = workflowErrorDetailString(details, "workflowName");
+		if (workflowName === void 0) return;
+		return WorkflowImplementationNotFoundError.create(workflowName, workflowErrorDetailString(details, "workflowVersion"));
+	},
+	WorkflowDefinitionError: (_record, recordMessage) => WorkflowDefinitionError.create(recordMessage),
+	WorkflowOptionsError: (_record, recordMessage) => WorkflowOptionsError.create(recordMessage),
+	WorkflowStateError: (_record, recordMessage) => WorkflowStateError.create(recordMessage),
+	WorkflowRuntimeError: (_record, recordMessage) => WorkflowRuntimeError.create(recordMessage),
+	WorkflowRunError(record, recordMessage) {
+		return WorkflowRunError.fromMessage(recordMessage, { details: sanitizedWorkflowErrorDetails(record.details) });
+	},
+	WorkflowStepError(record, recordMessage) {
+		return WorkflowStepError.fromMessage(recordMessage, { details: sanitizedWorkflowErrorDetails(record.details) });
+	},
+	WorkflowMessageError(record, recordMessage) {
+		return WorkflowMessageError.fromMessage(recordMessage, { details: sanitizedWorkflowErrorDetails(record.details) });
+	},
+	WorkflowCapabilityError(record) {
+		const details = record.details;
+		const capability = workflowErrorDetailString(details, "capability");
+		return capability === void 0 ? void 0 : WorkflowCapabilityError.create(capability);
+	},
+	WorkflowDurationError: (_record, recordMessage) => WorkflowDurationError.create(recordMessage),
+	WorkflowSerializationError(record) {
+		const details = record.details;
+		const path = workflowErrorDetailString(details, "path");
+		const reason = workflowErrorDetailString(details, "reason");
+		return path === void 0 || reason === void 0 ? void 0 : WorkflowSerializationError.create(path, reason);
+	},
+	WorkflowNonRetryableError(record, recordMessage) {
+		return WorkflowNonRetryableError.create(recordMessage, { details: sanitizedWorkflowErrorDetails(record.details) });
+	},
+	WorkflowPermanentFailureError(record) {
+		const details = record.details;
+		const runId = workflowErrorDetailString(details, "runId");
+		const reason = workflowErrorDetailString(details, "reason");
+		return runId === void 0 || reason === void 0 ? void 0 : WorkflowPermanentFailureError.create({
+			runId,
+			reason
+		});
+	},
+	WorkflowRetryableError(record, recordMessage) {
+		const details = record.details;
+		const retryAt = workflowErrorDetailTimestamp(details, "retryAt");
+		const retryDelay = workflowErrorDetailDuration(details, "retryDelay");
+		return WorkflowRetryableError.create(recordMessage, {
+			...retryAt === void 0 ? {} : { retryAt },
+			...retryDelay === void 0 ? {} : { retryDelay },
+			details: sanitizedWorkflowErrorDetails(details)
+		});
+	},
+	WorkflowStepTimeoutError(record) {
+		const details = record.details;
+		const runId = workflowErrorDetailString(details, "runId");
+		const stepId = workflowErrorDetailString(details, "stepId");
+		const stepName = workflowErrorDetailString(details, "stepName");
+		const attempt = workflowErrorDetailPositiveSafeInteger(details, "attempt");
+		const timeoutAt = workflowErrorDetailTimestamp(details, "timeoutAt");
+		return runId === void 0 || stepId === void 0 || stepName === void 0 || attempt === void 0 || timeoutAt === void 0 ? void 0 : WorkflowStepTimeoutError.create({
+			runId,
+			stepId,
+			stepName,
+			attempt,
+			timeoutAt
+		});
+	},
+	WorkflowResultTimeoutError(record) {
+		const details = record.details;
+		const runId = workflowErrorDetailString(details, "runId");
+		const timeout = workflowErrorDetailDuration(details, "timeout");
+		return runId === void 0 || timeout === void 0 ? void 0 : WorkflowResultTimeoutError.create(runId, timeout);
+	},
+	WorkflowRunNotFoundError(record) {
+		const details = record.details;
+		const runId = workflowErrorDetailString(details, "runId");
+		return runId === void 0 ? void 0 : WorkflowRunNotFoundError.create(runId);
+	},
+	WorkflowRunCanceledError(record) {
+		const details = record.details;
+		const runId = workflowErrorDetailString(details, "runId");
+		return runId === void 0 ? void 0 : WorkflowRunCanceledError.create(runId);
+	},
+	WorkflowRunCancellationError(record) {
+		const details = record.details;
+		const runId = workflowErrorDetailString(details, "runId");
+		const status = workflowTerminalErrorRunStatusOrUndefined(workflowErrorDetailString(details, "status"));
+		return runId === void 0 || status === void 0 ? void 0 : WorkflowRunCancellationError.create(runId, status);
+	},
+	WorkflowRunDeadlineExceededError(record) {
+		const details = record.details;
+		const runId = workflowErrorDetailString(details, "runId");
+		const deadlineAt = workflowErrorDetailTimestamp(details, "deadlineAt");
+		return runId === void 0 || deadlineAt === void 0 ? void 0 : WorkflowRunDeadlineExceededError.create(runId, deadlineAt);
+	},
+	WorkflowRunParentError(record) {
+		const details = record.details;
+		const runId = workflowErrorDetailString(details, "runId");
+		const reason = workflowErrorDetailString(details, "reason");
+		return runId === void 0 || reason === void 0 ? void 0 : WorkflowRunParentError.create(runId, reason);
+	},
+	WorkflowRunTransitionError(record) {
+		const details = record.details;
+		const runId = workflowErrorDetailString(details, "runId");
+		const valueFrom = workflowErrorDetailString(details, "from");
+		const from = valueFrom === void 0 ? void 0 : workflowErrorRunStatusOrUndefined(valueFrom);
+		const valueTo = workflowErrorDetailString(details, "to");
+		const to = valueTo === void 0 ? void 0 : workflowErrorRunStatusOrUndefined(valueTo);
+		return runId === void 0 || from === void 0 || to === void 0 ? void 0 : WorkflowRunTransitionError.create(runId, from, to);
+	},
+	WorkflowMessageDeliveryError(record) {
+		const details = record.details;
+		const runId = workflowErrorDetailString(details, "runId");
+		const status = workflowTerminalErrorRunStatusOrUndefined(workflowErrorDetailString(details, "status"));
+		const messageId = workflowErrorDetailString(details, "messageId");
+		return runId === void 0 || status === void 0 || messageId === void 0 ? void 0 : WorkflowMessageDeliveryError.create({
+			runId,
+			status,
+			messageId
+		});
+	},
+	WorkflowMessageIdempotencyConflictError(record) {
+		const details = record.details;
+		const runId = workflowErrorDetailString(details, "runId");
+		const messageId = workflowErrorDetailString(details, "messageId");
+		const idempotencyKey = workflowErrorDetailString(details, "idempotencyKey");
+		return runId === void 0 || messageId === void 0 || idempotencyKey === void 0 ? void 0 : WorkflowMessageIdempotencyConflictError.create({
+			runId,
+			messageId,
+			idempotencyKey
+		});
+	},
+	WorkflowRunMismatchError(record) {
+		const details = record.details;
+		const runId = workflowErrorDetailString(details, "runId");
+		const expectedWorkflowName = workflowErrorDetailString(details, "expectedWorkflowName");
+		const actualWorkflowName = workflowErrorDetailString(details, "actualWorkflowName");
+		return runId === void 0 || expectedWorkflowName === void 0 || actualWorkflowName === void 0 ? void 0 : WorkflowRunMismatchError.create({
+			runId,
+			expectedWorkflowName,
+			actualWorkflowName
+		});
+	},
+	WorkflowChildWorkflowTimeoutError(record) {
+		const details = record.details;
+		const runId = workflowErrorDetailString(details, "runId");
+		const childRunId = workflowErrorDetailString(details, "childRunId");
+		const stepId = workflowErrorDetailString(details, "stepId");
+		const timeoutAt = workflowErrorDetailTimestamp(details, "timeoutAt");
+		return runId === void 0 || childRunId === void 0 || stepId === void 0 || timeoutAt === void 0 ? void 0 : WorkflowChildWorkflowTimeoutError.create({
+			runId,
+			childRunId,
+			stepId,
+			timeoutAt
+		});
+	},
+	WorkflowMessageWaitTimeoutError(record) {
+		const details = record.details;
+		const runId = workflowErrorDetailString(details, "runId");
+		const stepId = workflowErrorDetailString(details, "stepId");
+		const stepName = workflowErrorDetailString(details, "stepName");
+		const messageId = workflowErrorDetailString(details, "messageId");
+		const timeoutAt = workflowErrorDetailTimestamp(details, "timeoutAt");
+		return runId === void 0 || stepId === void 0 || stepName === void 0 || messageId === void 0 || timeoutAt === void 0 ? void 0 : WorkflowMessageWaitTimeoutError.create({
+			runId,
+			stepId,
+			stepName,
+			messageId,
+			timeoutAt
+		});
+	},
+	WorkflowHookDisposedError(record) {
+		const details = record.details;
+		const runId = workflowErrorDetailString(details, "runId");
+		const stepId = workflowErrorDetailString(details, "stepId");
+		const stepName = workflowErrorDetailString(details, "stepName");
+		const messageId = workflowErrorDetailString(details, "messageId");
+		return runId === void 0 || stepId === void 0 || stepName === void 0 || messageId === void 0 ? void 0 : WorkflowHookDisposedError.create({
+			runId,
+			stepId,
+			stepName,
+			messageId
+		});
+	},
+	WorkflowStepExecutionError(record, recordMessage) {
+		const details = record.details;
+		const stepId = workflowErrorDetailString(details, "stepId");
+		const stepName = workflowErrorDetailString(details, "stepName");
+		const attempt = workflowErrorDetailPositiveSafeInteger(details, "attempt");
+		const cause = details !== void 0 && hasWorkflowErrorCauseDetails(details) ? workflowErrorFromRecord(unprefixWorkflowErrorCauseDetails(details)) : WorkflowError.fromMessage(recordMessage);
+		return stepId === void 0 || stepName === void 0 || attempt === void 0 ? void 0 : WorkflowStepExecutionError.create({
+			stepId,
+			stepName,
+			attempt,
+			cause
+		});
+	},
+	WorkflowStepRetryLimitError(record) {
+		const details = record.details;
+		const stepId = workflowErrorDetailString(details, "stepId");
+		const stepName = workflowErrorDetailString(details, "stepName");
+		const attempt = workflowErrorDetailPositiveSafeInteger(details, "attempt");
+		return stepId === void 0 || stepName === void 0 || attempt === void 0 ? void 0 : WorkflowStepRetryLimitError.create({
+			stepId,
+			stepName,
+			attempt
+		});
+	},
+	WorkflowStepAttemptLimitError(record) {
+		const details = record.details;
+		const runId = workflowErrorDetailString(details, "runId");
+		const maximumAttempts = workflowErrorDetailPositiveSafeInteger(details, "maximumAttempts");
+		return runId === void 0 || maximumAttempts === void 0 ? void 0 : WorkflowStepAttemptLimitError.create(runId, maximumAttempts);
+	},
+	WorkflowReplayDivergenceError(record) {
+		const details = record.details;
+		if (typeof record.message !== "string" || record.message.trim() === "") return;
+		return WorkflowReplayDivergenceError.create(record.message.replace(/^Workflow replay diverged: /, ""), {
+			expectedStepId: workflowErrorDetailString(details, "expectedStepId"),
+			actualStepId: workflowErrorDetailString(details, "actualStepId")
+		});
+	}
+};
+function domainWorkflowErrorFactory(ErrorConstructor) {
+	return (record, recordMessage) => {
+		const code = workflowErrorCodeSchema.safeParse(record.code);
+		return code.success ? new ErrorConstructor(recordMessage, code.data, sanitizedWorkflowErrorDetails(record.details)) : void 0;
+	};
+}
+//#endregion
+export { workflowErrorFromRecord };

package/dist/errors/run.d.mts

@@ -0,0 +1,116 @@
+import { RunId } from "../types/run-id.mjs";
+import { StepId } from "../types/step-id.mjs";
+import "../types/step.mjs";
+import { WorkflowRunStatus, WorkflowTerminalRunStatus } from "../types/run.mjs";
+import { WorkflowRunError } from "./base.mjs";
+//#region src/errors/run.d.ts
+/** Error thrown for run not found failures. */
+declare class WorkflowRunNotFoundError extends WorkflowRunError {
+  readonly runId: RunId;
+  constructor(runId: RunId, context?: Function);
+  static notFound(this: void, runId: RunId): never;
+  static create(this: void, runId: RunId): WorkflowRunNotFoundError;
+}
+/** Error thrown for run not found failures. */
+declare class WorkflowRunInvalidError extends WorkflowRunError {
+  readonly runId: RunId;
+  constructor(runId: RunId, message: string, context?: Function);
+  static invalid(this: void, runId: RunId, message: string): never;
+  static create(this: void, runId: RunId, message: string): WorkflowRunInvalidError;
+}
+/** Error thrown for run mismatch failures. */
+declare class WorkflowRunMismatchError extends WorkflowRunError {
+  readonly runId: RunId;
+  readonly expectedWorkflowName: string;
+  readonly actualWorkflowName: string;
+  constructor(options: {
+    readonly runId: RunId;
+    readonly expectedWorkflowName: string;
+    readonly actualWorkflowName: string;
+  }, context?: Function);
+  static mismatch(this: void, options: {
+    readonly runId: RunId;
+    readonly expectedWorkflowName: string;
+    readonly actualWorkflowName: string;
+  }): never;
+  static create(this: void, options: {
+    readonly runId: RunId;
+    readonly expectedWorkflowName: string;
+    readonly actualWorkflowName: string;
+  }): WorkflowRunMismatchError;
+}
+/** Error thrown for result timeout failures. */
+declare class WorkflowResultTimeoutError extends WorkflowRunError {
+  readonly runId: RunId;
+  readonly timeout: Temporal.Duration;
+  constructor(runId: RunId, timeout: Temporal.Duration, context?: Function);
+  static timedOut(this: void, runId: RunId, timeout: Temporal.Duration): never;
+  static create(this: void, runId: RunId, timeout: Temporal.Duration): WorkflowResultTimeoutError;
+}
+/** Error thrown for run canceled failures. */
+declare class WorkflowRunCanceledError extends WorkflowRunError {
+  readonly runId: RunId;
+  constructor(runId: RunId, context?: Function);
+  static canceled(this: void, runId: RunId): never;
+  static create(this: void, runId: RunId): WorkflowRunCanceledError;
+}
+/** Error thrown for run cancellation failures. */
+declare class WorkflowRunCancellationError extends WorkflowRunError {
+  readonly runId: RunId;
+  readonly status: WorkflowTerminalRunStatus;
+  constructor(runId: RunId, status: WorkflowTerminalRunStatus, context?: Function);
+  static cannotCancel(this: void, runId: RunId, status: WorkflowTerminalRunStatus): never;
+  static create(this: void, runId: RunId, status: WorkflowTerminalRunStatus): WorkflowRunCancellationError;
+}
+/** Error thrown for run transition failures. */
+declare class WorkflowRunTransitionError extends WorkflowRunError {
+  readonly runId: RunId;
+  readonly from: WorkflowRunStatus;
+  readonly to: WorkflowRunStatus;
+  constructor(runId: RunId, from: WorkflowRunStatus, to: WorkflowRunStatus, context?: Function);
+  static invalidTransition(this: void, runId: RunId, from: WorkflowRunStatus, to: WorkflowRunStatus): never;
+  static create(this: void, runId: RunId, from: WorkflowRunStatus, to: WorkflowRunStatus): WorkflowRunTransitionError;
+}
+/** Error thrown for run parent failures. */
+declare class WorkflowRunParentError extends WorkflowRunError {
+  readonly runId: RunId;
+  readonly reason: string;
+  constructor(runId: RunId, message: string, context?: Function);
+  static invalidParent(this: void, runId: RunId, message: string): never;
+  static create(this: void, runId: RunId, message: string): WorkflowRunParentError;
+}
+/** Error thrown for run deadline exceeded failures. */
+declare class WorkflowRunDeadlineExceededError extends WorkflowRunError {
+  readonly runId: RunId;
+  readonly deadlineAt: Temporal.Instant;
+  constructor(runId: RunId, deadlineAt: Temporal.Instant, context?: Function);
+  static deadlineExceeded(this: void, runId: RunId, deadlineAt: Temporal.Instant): never;
+  static create(this: void, runId: RunId, deadlineAt: Temporal.Instant): WorkflowRunDeadlineExceededError;
+}
+/** Error thrown for child workflow timeout failures. */
+declare class WorkflowChildWorkflowTimeoutError extends WorkflowRunError {
+  readonly runId: RunId;
+  readonly childRunId: RunId;
+  readonly stepId: StepId;
+  readonly timeoutAt: Temporal.Instant;
+  constructor(options: {
+    readonly runId: RunId;
+    readonly childRunId: RunId;
+    readonly stepId: StepId;
+    readonly timeoutAt: Temporal.Instant;
+  }, context?: Function);
+  static timedOut(this: void, options: {
+    readonly runId: RunId;
+    readonly childRunId: RunId;
+    readonly stepId: StepId;
+    readonly timeoutAt: Temporal.Instant;
+  }): never;
+  static create(this: void, options: {
+    readonly runId: RunId;
+    readonly childRunId: RunId;
+    readonly stepId: StepId;
+    readonly timeoutAt: Temporal.Instant;
+  }): WorkflowChildWorkflowTimeoutError;
+}
+//#endregion
+export { WorkflowChildWorkflowTimeoutError, WorkflowResultTimeoutError, WorkflowRunCanceledError, WorkflowRunCancellationError, WorkflowRunDeadlineExceededError, WorkflowRunInvalidError, WorkflowRunMismatchError, WorkflowRunNotFoundError, WorkflowRunParentError, WorkflowRunTransitionError };