@temelj/workflow 0.0.0-alpha.3 → 0.0.0-alpha.4

package/dist/errors/records.mjs

@@ -1,280 +1,280 @@
-import { workflowErrorCodeSchema } from "../types/error-code.mjs";
+import { positiveSafeIntegerSchema } from "../schema/common.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 { 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 { WorkflowRuntimeError } from "./runtime.mjs";
+import { WorkflowChildWorkflowTimeoutError, WorkflowResultTimeoutError, WorkflowRunCanceledError, WorkflowRunCancellationError, WorkflowRunDeadlineExceededError, WorkflowRunMismatchError, WorkflowRunNotFoundError, WorkflowRunParentError, WorkflowRunTransitionError } from "./run.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";
+import { errorCodeSchema, errorDetailsSchema, errorRunStatusSchema, optionalErrorStringSchema, terminalErrorRunStatusSchema } from "../schema/error.mjs";
+import { ss } from "@temelj/standard-schema";
+import { isObject, isString } from "@temelj/value";
 //#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) });
+	const recordName = record.name.trim() === "" ? "WorkflowError" : record.name;
+	const recordMessage = record.message.trim() === "" ? recordName : record.message;
+	const error = typedErrorFromRecord(record, recordMessage) ?? new WorkflowError(recordMessage, { details: sanitizedErrorDetails(record.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;
+	const recordCode = ss.safeParseSync(errorCodeSchema, record.code);
+	if (recordCode.success) Object.defineProperty(error, "code", { value: recordCode.value });
+	const recordStack = record.stack !== void 0 && record.stack.trim() !== "" ? record.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);
+function typedErrorFromRecord(record, recordMessage) {
+	return (record.name === void 0 ? void 0 : workflowErrorRecordFactories().get(record.name))?.(record, recordMessage);
+}
+/**
+* Rebuilds an error from the detail fields its constructor needs. The record is not rebuilt as
+* this class when a field is missing or malformed.
+*/
+function fromFields(spec, build) {
+	return (record, recordMessage) => {
+		const fields = {};
+		for (const [key, kind] of Object.entries(spec)) {
+			const value = readField(record.details, key, kind);
+			if (value === void 0) return;
+			fields[key] = value;
+		}
+		return build(fields, recordMessage, record.details);
+	};
 }
-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 readField(details, key, kind) {
+	switch (kind) {
+		case "string": return workflowErrorDetailString(details, key);
+		case "integer": return workflowErrorDetailPositiveSafeInteger(details, key);
+		case "instant": return workflowErrorDetailTimestamp(details, key);
+		case "duration": return workflowErrorDetailDuration(details, key);
+		case "runStatus": return workflowErrorRunStatusOrUndefined(workflowErrorDetailString(details, key));
+		case "terminalStatus": return workflowTerminalErrorRunStatusOrUndefined(workflowErrorDetailString(details, key));
+		default: return kind;
 	}
-};
-function domainWorkflowErrorFactory(ErrorConstructor) {
+}
+let recordFactories;
+/** Built on first use, because the error modules import this one while they load. */
+function workflowErrorRecordFactories() {
+	recordFactories ??= new Map(Object.entries({
+		WorkflowHookError: domainErrorFactory(WorkflowHookError),
+		WorkflowLockError: domainErrorFactory(WorkflowLockError),
+		WorkflowLockStateError: domainErrorFactory(WorkflowLockStateError),
+		WorkflowScheduleError: domainErrorFactory(WorkflowScheduleError),
+		WorkflowStreamError: domainErrorFactory(WorkflowStreamError),
+		WorkflowScheduleAlreadyExistsError: fromFields({ scheduleId: "string" }, ({ scheduleId }) => new WorkflowScheduleAlreadyExistsError(scheduleId)),
+		WorkflowStreamNotFoundError: fromFields({ streamIdOrName: "string" }, ({ streamIdOrName }) => new WorkflowStreamNotFoundError(streamIdOrName)),
+		WorkflowImplementationNotFoundError: fromFields({ workflowName: "string" }, ({ workflowName }, _message, details) => new WorkflowImplementationNotFoundError(workflowName, workflowErrorDetailString(details, "workflowVersion"))),
+		WorkflowDefinitionError: (_record, recordMessage) => new WorkflowDefinitionError(recordMessage),
+		WorkflowOptionsError: (_record, recordMessage) => new WorkflowOptionsError(recordMessage),
+		WorkflowStateError: (_record, recordMessage) => new WorkflowStateError(recordMessage),
+		WorkflowDurationError: (_record, recordMessage) => new WorkflowDurationError(recordMessage),
+		WorkflowRunError: withDetails(WorkflowRunError),
+		WorkflowStepError: withDetails(WorkflowStepError),
+		WorkflowMessageError: withDetails(WorkflowMessageError),
+		WorkflowNonRetryableError: withDetails(WorkflowNonRetryableError),
+		WorkflowCapabilityError: fromFields({ capability: "string" }, ({ capability }) => new WorkflowCapabilityError(capability)),
+		WorkflowSerializationError: fromFields({
+			path: "string",
+			reason: "string"
+		}, ({ path, reason }) => new WorkflowSerializationError(path, reason)),
+		WorkflowPermanentFailureError: fromFields({
+			runId: "string",
+			reason: "string"
+		}, (fields) => new WorkflowPermanentFailureError(fields)),
+		WorkflowRetryableError(record, recordMessage) {
+			const details = record.details;
+			return new WorkflowRetryableError(recordMessage, {
+				details: sanitizedErrorDetails(details),
+				retryAt: workflowErrorDetailTimestamp(details, "retryAt"),
+				retryDelay: workflowErrorDetailDuration(details, "retryDelay")
+			});
+		},
+		WorkflowStepTimeoutError: fromFields({
+			runId: "string",
+			stepId: "string",
+			stepName: "string",
+			attempt: "integer",
+			timeoutAt: "instant"
+		}, (fields) => new WorkflowStepTimeoutError(fields)),
+		WorkflowResultTimeoutError: fromFields({
+			runId: "string",
+			timeout: "duration"
+		}, ({ runId, timeout }) => new WorkflowResultTimeoutError(runId, timeout)),
+		WorkflowRunNotFoundError: fromFields({ runId: "string" }, ({ runId }) => new WorkflowRunNotFoundError(runId)),
+		WorkflowRunCanceledError: fromFields({ runId: "string" }, ({ runId }) => new WorkflowRunCanceledError(runId)),
+		WorkflowRunCancellationError: fromFields({
+			runId: "string",
+			status: "terminalStatus"
+		}, ({ runId, status }) => new WorkflowRunCancellationError(runId, status)),
+		WorkflowRunDeadlineExceededError: fromFields({
+			runId: "string",
+			deadlineAt: "instant"
+		}, ({ runId, deadlineAt }) => new WorkflowRunDeadlineExceededError(runId, deadlineAt)),
+		WorkflowRunParentError: fromFields({
+			runId: "string",
+			reason: "string"
+		}, ({ runId, reason }) => new WorkflowRunParentError(runId, reason)),
+		WorkflowRunTransitionError: fromFields({
+			runId: "string",
+			from: "runStatus",
+			to: "runStatus"
+		}, ({ runId, from, to }) => new WorkflowRunTransitionError(runId, from, to)),
+		WorkflowMessageDeliveryError: fromFields({
+			runId: "string",
+			status: "terminalStatus",
+			messageId: "string"
+		}, (fields) => new WorkflowMessageDeliveryError(fields)),
+		WorkflowMessageIdempotencyConflictError: fromFields({
+			runId: "string",
+			messageId: "string",
+			idempotencyKey: "string"
+		}, (fields) => new WorkflowMessageIdempotencyConflictError(fields)),
+		WorkflowRunMismatchError: fromFields({
+			runId: "string",
+			expectedWorkflowName: "string",
+			actualWorkflowName: "string"
+		}, (fields) => new WorkflowRunMismatchError(fields)),
+		WorkflowChildWorkflowTimeoutError: fromFields({
+			runId: "string",
+			childRunId: "string",
+			stepId: "string",
+			timeoutAt: "instant"
+		}, (fields) => new WorkflowChildWorkflowTimeoutError(fields)),
+		WorkflowMessageWaitTimeoutError: fromFields({
+			runId: "string",
+			stepId: "string",
+			stepName: "string",
+			messageId: "string",
+			timeoutAt: "instant"
+		}, (fields) => new WorkflowMessageWaitTimeoutError(fields)),
+		WorkflowHookDisposedError: fromFields({
+			runId: "string",
+			stepId: "string",
+			stepName: "string",
+			messageId: "string"
+		}, (fields) => new WorkflowHookDisposedError(fields)),
+		WorkflowStepExecutionError: fromFields({
+			stepId: "string",
+			stepName: "string",
+			attempt: "integer"
+		}, (fields, recordMessage, details) => new WorkflowStepExecutionError({
+			...fields,
+			cause: details !== void 0 && hasErrorCauseDetails(details) ? workflowErrorFromRecord(unprefixErrorCauseDetails(details)) : new WorkflowError(recordMessage)
+		})),
+		WorkflowStepRetryLimitError: fromFields({
+			stepId: "string",
+			stepName: "string",
+			attempt: "integer"
+		}, (fields) => new WorkflowStepRetryLimitError(fields)),
+		WorkflowStepAttemptLimitError: fromFields({
+			runId: "string",
+			maximumAttempts: "integer"
+		}, ({ runId, maximumAttempts }) => new WorkflowStepAttemptLimitError(runId, maximumAttempts)),
+		WorkflowReplayDivergenceError(record) {
+			const details = record.details;
+			if (record.message === void 0 || record.message.trim() === "") return;
+			return new WorkflowReplayDivergenceError(record.message.replace(/^Workflow replay diverged: /, ""), {
+				expectedStepId: workflowErrorDetailString(details, "expectedStepId"),
+				actualStepId: workflowErrorDetailString(details, "actualStepId")
+			});
+		}
+	}));
+	return recordFactories;
+}
+function domainErrorFactory(ErrorConstructor) {
 	return (record, recordMessage) => {
-		const code = workflowErrorCodeSchema.safeParse(record.code);
-		return code.success ? new ErrorConstructor(recordMessage, code.data, sanitizedWorkflowErrorDetails(record.details)) : void 0;
+		const code = ss.safeParseSync(errorCodeSchema, record.code);
+		return code.success ? new ErrorConstructor(recordMessage, code.value, sanitizedErrorDetails(record.details)) : void 0;
+	};
+}
+function withDetails(ErrorConstructor) {
+	return (record, recordMessage) => new ErrorConstructor(recordMessage, { details: sanitizedErrorDetails(record.details) });
+}
+/** Safely exposes fields shared by live workflow errors and persisted workflow error records. */
+function workflowErrorRecordView(cause) {
+	if (!isObject(cause)) return;
+	const code = "code" in cause ? ss.safeParseSync(errorCodeSchema, cause.code) : void 0;
+	if (code === void 0 || !code.success) return;
+	if (!("details" in cause) || cause.details === void 0) return { code: code.value };
+	const details = ss.safeParseSync(errorDetailsSchema, cause.details);
+	return details.success ? {
+		code: code.value,
+		details: details.value
+	} : void 0;
+}
+/**
+* Whether `cause` is a workflow error, or a record of one, with `code` and every given detail value.
+* Detail values left `undefined` match anything.
+*/
+function matchesWorkflowError(cause, code, details = {}) {
+	const record = workflowErrorRecordView(cause);
+	return record?.code === code && Object.entries(details).every(([key, value]) => value === void 0 || record.details?.[key] === value);
+}
+function hasErrorCauseDetails(details) {
+	return workflowErrorDetailString(details, "causeName") !== void 0 || workflowErrorDetailString(details, "causeMessage") !== void 0;
+}
+function unprefixErrorCauseDetails(details) {
+	const unprefixed = Object.fromEntries(Object.entries(details).filter(([key]) => /^cause[A-Z]/.test(key)).map(([key, value]) => {
+		const unprefixedKey = key.slice(5);
+		return [`${unprefixedKey[0]?.toLowerCase() ?? ""}${unprefixedKey.slice(1)}`, value];
+	}));
+	const name = isString(unprefixed.name) && unprefixed.name.trim() !== "" ? unprefixed.name : "WorkflowError";
+	const message = isString(unprefixed.message) && unprefixed.message.trim() !== "" ? unprefixed.message : name;
+	const stack = isString(unprefixed.stack) && unprefixed.stack.trim() !== "" ? unprefixed.stack : void 0;
+	const code = ss.safeParseSync(errorCodeSchema, unprefixed.code);
+	const sanitizedDetails = sanitizedErrorDetails(Object.fromEntries(Object.entries(unprefixed).filter(([key]) => key !== "code" && key !== "name" && key !== "message" && key !== "stack")));
+	return {
+		name,
+		message,
+		code: code.success ? code.value : void 0,
+		stack,
+		details: sanitizedDetails
 	};
 }
+function workflowErrorDetailString(details, key) {
+	const parsed = ss.safeParseSync(errorDetailsSchema, details);
+	if (!parsed.success) return;
+	const result = ss.safeParseSync(optionalErrorStringSchema, parsed.value[key]);
+	return result.success ? result.value : void 0;
+}
+function workflowErrorDetailPositiveSafeInteger(details, key) {
+	const parsed = ss.safeParseSync(errorDetailsSchema, details);
+	if (!parsed.success) return;
+	const result = ss.safeParseSync(ss.optional(positiveSafeIntegerSchema), parsed.value[key]);
+	return result.success ? result.value : void 0;
+}
+function workflowErrorRunStatusOrUndefined(value) {
+	const result = ss.safeParseSync(errorRunStatusSchema, value);
+	return result.success ? result.value : void 0;
+}
+function workflowTerminalErrorRunStatusOrUndefined(value) {
+	const result = ss.safeParseSync(terminalErrorRunStatusSchema, value);
+	return result.success ? result.value : void 0;
+}
+function workflowErrorDetailTimestamp(details, key) {
+	return parseDetail(details, key, (value) => Temporal.Instant.from(value));
+}
+function workflowErrorDetailDuration(details, key) {
+	return parseDetail(details, key, (value) => Temporal.Duration.from(value));
+}
+function parseDetail(details, key, parse) {
+	const value = workflowErrorDetailString(details, key);
+	if (value === void 0) return;
+	try {
+		return parse(value);
+	} catch {
+		return;
+	}
+}
+function sanitizedErrorDetails(details) {
+	const parsed = ss.safeParseSync(errorDetailsSchema, details);
+	if (!parsed.success) return;
+	return Object.keys(parsed.value).length === 0 ? void 0 : parsed.value;
+}
 //#endregion
-export { workflowErrorFromRecord };
+export { matchesWorkflowError, sanitizedErrorDetails, workflowErrorFromRecord };