semola 0.5.2 → 0.5.3

package/dist/lib/workflow/index.mjs

@@ -0,0 +1,535 @@
+import { err, mightThrow, mightThrowSync, ok } from "../errors/index.mjs";
+//#region src/lib/workflow/index.ts
+const DEFAULT_LOCK_TTL = 300 * 1e3;
+const now = () => Date.now();
+const toErrorMessage = (error) => {
+	if (error instanceof Error) return error.message;
+	return String(error);
+};
+const envelopeSerialize = (value) => {
+	return JSON.stringify({ value });
+};
+const envelopeDeserialize = (raw) => {
+	const [parseError, parsed] = mightThrowSync(() => JSON.parse(raw));
+	if (parseError) throw parseError;
+	if (parsed === null) return;
+	if (typeof parsed !== "object") return;
+	if ("value" in parsed) return parsed.value;
+};
+const knownStatuses = [
+	"pending",
+	"running",
+	"completed",
+	"failed",
+	"cancelled"
+];
+var WorkflowDefinition = class {
+	options;
+	lockTTL;
+	constructor(options) {
+		this.options = options;
+		this.lockTTL = options.lockTTL ?? DEFAULT_LOCK_TTL;
+	}
+	async start(input, options) {
+		const executionId = options?.executionId ?? crypto.randomUUID();
+		const [createError] = await this.createExecution(executionId, input);
+		if (createError) return err(createError.type, createError.message);
+		return this.execute(executionId, input);
+	}
+	async run(input, options) {
+		const [startError, startData] = await this.start(input, options);
+		if (startError) return err(startError.type, startError.message);
+		if (!startData) return err("WorkflowError", "Unexpected empty start result");
+		if (startData.status === "cancelled") return err("WorkflowCancelledError", `Workflow execution ${startData.executionId} was cancelled`);
+		if (startData.status !== "completed") return err("WorkflowExecutionError", `Workflow execution ${startData.executionId} did not complete`);
+		const [getError, execution] = await this.get(startData.executionId);
+		if (getError) return err(getError.type, getError.message);
+		if (!execution) return err("WorkflowError", "Unexpected empty execution");
+		return ok(execution.result);
+	}
+	async resume(executionId) {
+		const [getError, execution] = await this.get(executionId);
+		if (getError) return err(getError.type, getError.message);
+		if (!execution) return err("WorkflowNotFoundError", `Workflow execution ${executionId} not found`);
+		if (execution.status === "completed") return ok({
+			executionId,
+			status: execution.status
+		});
+		if (execution.status === "cancelled") return ok({
+			executionId,
+			status: execution.status
+		});
+		return this.execute(executionId, execution.input);
+	}
+	async get(executionId) {
+		const [statusError, status] = await this.getMeta(executionId, "status");
+		if (statusError) return err(statusError.type, statusError.message);
+		if (!status) return err("WorkflowNotFoundError", `Workflow execution ${executionId} not found`);
+		const normalizedStatus = this.normalizeStatus(status);
+		if (!normalizedStatus) return err("WorkflowStateError", `Workflow execution ${executionId} has invalid status ${status}`);
+		const [inputError, input] = await this.readInput(executionId);
+		if (inputError) return err(inputError.type, inputError.message);
+		if (input === null) return err("WorkflowStateError", `Workflow execution ${executionId} has invalid input`);
+		const [resultError, result] = await this.readResult(executionId);
+		if (resultError) return err(resultError.type, resultError.message);
+		const [stepsError, steps] = await this.readStepSnapshots(executionId);
+		if (stepsError) return err(stepsError.type, stepsError.message);
+		const [createdAtError, createdAt] = await this.readNumberMeta(executionId, "createdAt");
+		if (createdAtError) return err(createdAtError.type, createdAtError.message);
+		if (createdAt === null) return err("WorkflowStateError", `Workflow execution ${executionId} is missing createdAt`);
+		const [updatedAtError, updatedAt] = await this.readNumberMeta(executionId, "updatedAt");
+		if (updatedAtError) return err(updatedAtError.type, updatedAtError.message);
+		if (updatedAt === null) return err("WorkflowStateError", `Workflow execution ${executionId} is missing updatedAt`);
+		const [metaError, errorMessage] = await this.getMeta(executionId, "error");
+		if (metaError) return err(metaError.type, metaError.message);
+		const [completedAtError, completedAt] = await this.readNumberMeta(executionId, "completedAt");
+		if (completedAtError) return err(completedAtError.type, completedAtError.message);
+		const [failedAtError, failedAt] = await this.readNumberMeta(executionId, "failedAt");
+		if (failedAtError) return err(failedAtError.type, failedAtError.message);
+		const [cancelledAtError, cancelledAt] = await this.readNumberMeta(executionId, "cancelledAt");
+		if (cancelledAtError) return err(cancelledAtError.type, cancelledAtError.message);
+		return ok({
+			id: executionId,
+			name: this.options.name,
+			status: normalizedStatus,
+			input,
+			result,
+			error: errorMessage,
+			createdAt,
+			updatedAt,
+			completedAt,
+			failedAt,
+			cancelledAt,
+			steps
+		});
+	}
+	async cancel(executionId) {
+		const [getError, execution] = await this.get(executionId);
+		if (getError) return err(getError.type, getError.message);
+		if (!execution) return err("WorkflowNotFoundError", `Workflow execution ${executionId} not found`);
+		if (execution.status === "completed") return err("WorkflowStateError", `Workflow execution ${executionId} is already completed`);
+		const timestamp = now();
+		const [statusError] = await this.setMeta(executionId, "status", "cancelled");
+		if (statusError) return err(statusError.type, statusError.message);
+		const [updatedAtError] = await this.setMeta(executionId, "updatedAt", String(timestamp));
+		if (updatedAtError) return err(updatedAtError.type, updatedAtError.message);
+		const [cancelledAtError] = await this.setMeta(executionId, "cancelledAt", String(timestamp));
+		if (cancelledAtError) return err(cancelledAtError.type, cancelledAtError.message);
+		const [clearErrorError] = await this.setMeta(executionId, "error", "");
+		if (clearErrorError) return err(clearErrorError.type, clearErrorError.message);
+		const [clearFailedAtError] = await this.setMeta(executionId, "failedAt", "");
+		if (clearFailedAtError) return err(clearFailedAtError.type, clearFailedAtError.message);
+		return ok({
+			executionId,
+			createdAt: execution.createdAt,
+			cancelledAt: timestamp,
+			updatedAt: timestamp,
+			status: "cancelled"
+		});
+	}
+	executionKey(executionId) {
+		return `workflow:${this.options.name}:execution:${executionId}`;
+	}
+	metaKey(executionId) {
+		return `${this.executionKey(executionId)}:meta`;
+	}
+	stepsKey(executionId) {
+		return `${this.executionKey(executionId)}:steps`;
+	}
+	lockKey(executionId) {
+		return `${this.executionKey(executionId)}:lock`;
+	}
+	async createExecution(executionId, input) {
+		const [serializeError, serializedInput] = this.serializeInput(input);
+		if (serializeError) return err("WorkflowSerializationError", `Unable to serialize workflow input for ${executionId}`);
+		const timestamp = now();
+		const [statusReadError, existingStatus] = await this.getMeta(executionId, "status");
+		if (statusReadError) return err(statusReadError.type, statusReadError.message);
+		if (existingStatus) return err("WorkflowStateError", `Workflow execution ${executionId} already exists`);
+		const metadata = {
+			status: "pending",
+			input: serializedInput,
+			result: "",
+			error: "",
+			createdAt: String(timestamp),
+			updatedAt: String(timestamp),
+			completedAt: "",
+			failedAt: "",
+			cancelledAt: "",
+			steps: "[]"
+		};
+		const [writeError] = await mightThrow(this.options.redis.hset(this.metaKey(executionId), metadata));
+		if (writeError) return err("WorkflowError", `Unable to persist metadata for execution ${executionId}`);
+		return ok(null);
+	}
+	async execute(executionId, input) {
+		const token = crypto.randomUUID();
+		const [lockError] = await this.acquireLock(executionId, token);
+		if (lockError) return err(lockError.type, lockError.message);
+		const [statusCheckError, currentStatus] = await this.getMeta(executionId, "status");
+		if (statusCheckError) {
+			await this.releaseLock(executionId, token);
+			return err(statusCheckError.type, statusCheckError.message);
+		}
+		if (currentStatus === "cancelled") {
+			await this.releaseLock(executionId, token);
+			return err("WorkflowStateError", `Workflow execution ${executionId} was cancelled`);
+		}
+		const timestamp = now();
+		const [runningStatusError] = await this.setMeta(executionId, "status", "running");
+		if (runningStatusError) {
+			await this.releaseLock(executionId, token);
+			return err(runningStatusError.type, runningStatusError.message);
+		}
+		const [runningUpdatedAtError] = await this.setMeta(executionId, "updatedAt", String(timestamp));
+		if (runningUpdatedAtError) {
+			await this.releaseLock(executionId, token);
+			return err(runningUpdatedAtError.type, runningUpdatedAtError.message);
+		}
+		const controller = new AbortController();
+		const renewInterval = Math.floor(this.lockTTL / 3);
+		let lockLost = false;
+		const renewTimer = setInterval(async () => {
+			const [renewError] = await this.extendLock(executionId, token);
+			if (renewError) {
+				lockLost = true;
+				controller.abort();
+				clearInterval(renewTimer);
+			}
+		}, renewInterval);
+		const step = async (name, handler) => {
+			const [cancelledError, cancelled] = await this.isCancelled(executionId);
+			if (cancelledError) return Promise.reject(new Error(cancelledError.message));
+			if (cancelled) {
+				controller.abort();
+				return Promise.reject(/* @__PURE__ */ new Error("Workflow cancelled"));
+			}
+			const [readError, cachedStep] = await this.readStepOutput(executionId, name);
+			if (readError) return Promise.reject(new Error(readError.message));
+			if (cachedStep.found) return cachedStep.value;
+			const [stepError, output] = await mightThrow(Promise.resolve(handler(input, controller.signal)));
+			if (stepError) return Promise.reject(stepError);
+			const [writeError] = await this.writeStepOutput(executionId, name, output);
+			if (writeError) return Promise.reject(new Error(writeError.message));
+			return output;
+		};
+		const [handlerError, result] = await mightThrow(Promise.resolve(this.options.handler({
+			input,
+			executionId,
+			signal: controller.signal,
+			step
+		})));
+		clearInterval(renewTimer);
+		if (lockLost) {
+			await this.releaseLock(executionId, token);
+			return err("WorkflowLockError", `Lock expired during execution ${executionId}`);
+		}
+		const [cancelledError, cancelled] = await this.isCancelled(executionId);
+		if (cancelledError) {
+			await this.releaseLock(executionId, token);
+			return err(cancelledError.type, cancelledError.message);
+		}
+		if (cancelled) {
+			const cancelledAt = now();
+			const [cancelledStatusError] = await this.setMeta(executionId, "status", "cancelled");
+			if (cancelledStatusError) {
+				await this.releaseLock(executionId, token);
+				return err(cancelledStatusError.type, cancelledStatusError.message);
+			}
+			const [cancelledUpdatedAtError] = await this.setMeta(executionId, "updatedAt", String(cancelledAt));
+			if (cancelledUpdatedAtError) {
+				await this.releaseLock(executionId, token);
+				return err(cancelledUpdatedAtError.type, cancelledUpdatedAtError.message);
+			}
+			const [cancelledAtError] = await this.setMeta(executionId, "cancelledAt", String(cancelledAt));
+			if (cancelledAtError) {
+				await this.releaseLock(executionId, token);
+				return err(cancelledAtError.type, cancelledAtError.message);
+			}
+			await this.releaseLock(executionId, token);
+			return ok({
+				executionId,
+				status: "cancelled"
+			});
+		}
+		if (handlerError) {
+			const failedAt = now();
+			const [failedStatusError] = await this.setMeta(executionId, "status", "failed");
+			if (failedStatusError) {
+				await this.releaseLock(executionId, token);
+				return err(failedStatusError.type, failedStatusError.message);
+			}
+			const [failedMessageError] = await this.setMeta(executionId, "error", toErrorMessage(handlerError));
+			if (failedMessageError) {
+				await this.releaseLock(executionId, token);
+				return err(failedMessageError.type, failedMessageError.message);
+			}
+			const [failedUpdatedAtError] = await this.setMeta(executionId, "updatedAt", String(failedAt));
+			if (failedUpdatedAtError) {
+				await this.releaseLock(executionId, token);
+				return err(failedUpdatedAtError.type, failedUpdatedAtError.message);
+			}
+			const [failedAtError] = await this.setMeta(executionId, "failedAt", String(failedAt));
+			if (failedAtError) {
+				await this.releaseLock(executionId, token);
+				return err(failedAtError.type, failedAtError.message);
+			}
+			await this.releaseLock(executionId, token);
+			return err("WorkflowExecutionError", `Workflow execution ${executionId} failed: ${toErrorMessage(handlerError)}`);
+		}
+		const [serializeResultError, serializedResult] = this.serializeResult(result);
+		if (serializeResultError) {
+			const failedAt = now();
+			const [failedStatusError] = await this.setMeta(executionId, "status", "failed");
+			if (failedStatusError) {
+				await this.releaseLock(executionId, token);
+				return err(failedStatusError.type, failedStatusError.message);
+			}
+			const [failedMessageError] = await this.setMeta(executionId, "error", serializeResultError.message);
+			if (failedMessageError) {
+				await this.releaseLock(executionId, token);
+				return err(failedMessageError.type, failedMessageError.message);
+			}
+			const [failedUpdatedAtError] = await this.setMeta(executionId, "updatedAt", String(failedAt));
+			if (failedUpdatedAtError) {
+				await this.releaseLock(executionId, token);
+				return err(failedUpdatedAtError.type, failedUpdatedAtError.message);
+			}
+			const [failedAtError] = await this.setMeta(executionId, "failedAt", String(failedAt));
+			if (failedAtError) {
+				await this.releaseLock(executionId, token);
+				return err(failedAtError.type, failedAtError.message);
+			}
+			await this.releaseLock(executionId, token);
+			return err("WorkflowSerializationError", `Unable to serialize workflow result for ${executionId}`);
+		}
+		const completedAt = now();
+		const [completedResultError] = await this.setMeta(executionId, "result", serializedResult);
+		if (completedResultError) {
+			await this.releaseLock(executionId, token);
+			return err(completedResultError.type, completedResultError.message);
+		}
+		const [completedStatusError] = await this.setMeta(executionId, "status", "completed");
+		if (completedStatusError) {
+			await this.releaseLock(executionId, token);
+			return err(completedStatusError.type, completedStatusError.message);
+		}
+		const [completedClearErrorError] = await this.setMeta(executionId, "error", "");
+		if (completedClearErrorError) {
+			await this.releaseLock(executionId, token);
+			return err(completedClearErrorError.type, completedClearErrorError.message);
+		}
+		const [completedClearFailedAtError] = await this.setMeta(executionId, "failedAt", "");
+		if (completedClearFailedAtError) {
+			await this.releaseLock(executionId, token);
+			return err(completedClearFailedAtError.type, completedClearFailedAtError.message);
+		}
+		const [completedUpdatedAtError] = await this.setMeta(executionId, "updatedAt", String(completedAt));
+		if (completedUpdatedAtError) {
+			await this.releaseLock(executionId, token);
+			return err(completedUpdatedAtError.type, completedUpdatedAtError.message);
+		}
+		const [completedAtError] = await this.setMeta(executionId, "completedAt", String(completedAt));
+		if (completedAtError) {
+			await this.releaseLock(executionId, token);
+			return err(completedAtError.type, completedAtError.message);
+		}
+		await this.releaseLock(executionId, token);
+		return ok({
+			executionId,
+			status: "completed"
+		});
+	}
+	async acquireLock(executionId, token) {
+		const [lockError, lockResult] = await mightThrow(this.options.redis.set(this.lockKey(executionId), token, "PX", String(this.lockTTL), "NX"));
+		if (lockError) return err("WorkflowLockError", `Unable to acquire lock for execution ${executionId}`);
+		if (lockResult !== "OK") return err("WorkflowLockError", `Workflow execution ${executionId} is already running`);
+		return ok(null);
+	}
+	async releaseLock(executionId, token) {
+		const [evalError] = await mightThrow(this.options.redis.send("EVAL", [
+			"if redis.call('GET', KEYS[1]) == ARGV[1] then return redis.call('DEL', KEYS[1]) else return 0 end",
+			"1",
+			this.lockKey(executionId),
+			token
+		]));
+		if (evalError) return err("WorkflowLockError", `Unable to release lock for execution ${executionId}`);
+		return ok(null);
+	}
+	async extendLock(executionId, token) {
+		const [evalError, result] = await mightThrow(this.options.redis.send("EVAL", [
+			"if redis.call('GET', KEYS[1]) == ARGV[1] then return redis.call('PEXPIRE', KEYS[1], ARGV[2]) else return 0 end",
+			"1",
+			this.lockKey(executionId),
+			token,
+			String(this.lockTTL)
+		]));
+		if (evalError) return err("WorkflowLockError", `Unable to extend lock for execution ${executionId}`);
+		if (result === 0) return err("WorkflowLockError", `Lock ownership lost for execution ${executionId}`);
+		return ok(null);
+	}
+	async isCancelled(executionId) {
+		const [statusError, status] = await this.getMeta(executionId, "status");
+		if (statusError) return err(statusError.type, statusError.message);
+		return ok(status === "cancelled");
+	}
+	async setMeta(executionId, field, value) {
+		const [writeError] = await mightThrow(this.options.redis.hset(this.metaKey(executionId), field, value));
+		if (writeError) return err("WorkflowError", `Unable to persist ${field} for execution ${executionId}`);
+		return ok(null);
+	}
+	async getMeta(executionId, field) {
+		const [readError, value] = await mightThrow(this.options.redis.hget(this.metaKey(executionId), field));
+		if (readError) return err("WorkflowError", `Unable to read ${field} for execution ${executionId}`);
+		if (value === null || value === void 0) return ok(null);
+		if (typeof value !== "string") return err("WorkflowStateError", `Invalid ${field} value for execution ${executionId}`);
+		if (value.length === 0) return ok(null);
+		return ok(value);
+	}
+	async readNumberMeta(executionId, field) {
+		const [readError, value] = await this.getMeta(executionId, field);
+		if (readError) return err(readError.type, readError.message);
+		if (!value) return ok(null);
+		const parsed = Number(value);
+		if (!Number.isFinite(parsed)) return err("WorkflowStateError", `Invalid ${field} value for execution ${executionId}`);
+		return ok(parsed);
+	}
+	runSerializer(value, serializer, label) {
+		const [serializeError, serialized] = mightThrowSync(() => serializer(value));
+		if (serializeError) return err("WorkflowSerializationError", `Unable to serialize ${label}: ${toErrorMessage(serializeError)}`);
+		if (typeof serialized !== "string") return err("WorkflowSerializationError", `${label} serializer must return a string`);
+		return ok(serialized);
+	}
+	runDeserializer(raw, deserializer, label) {
+		const [deserializeError, value] = mightThrowSync(() => deserializer(raw));
+		if (deserializeError) return err("WorkflowSerializationError", `Unable to deserialize ${label}: ${toErrorMessage(deserializeError)}`);
+		return ok(value);
+	}
+	serializeInput(input) {
+		return this.runSerializer(input, this.options.serializeInput ?? envelopeSerialize, "workflow input");
+	}
+	deserializeInput(raw) {
+		const deserializer = this.options.deserializeInput ?? ((value) => envelopeDeserialize(value));
+		return this.runDeserializer(raw, deserializer, "workflow input");
+	}
+	serializeResult(result) {
+		if (result === null) return ok(envelopeSerialize(null));
+		return this.runSerializer(result, this.options.serializeResult ?? envelopeSerialize, "workflow result");
+	}
+	deserializeResult(raw) {
+		const deserializer = this.options.deserializeResult ?? ((value) => envelopeDeserialize(value));
+		return this.runDeserializer(raw, deserializer, "workflow result");
+	}
+	serializeStepOutput(output) {
+		return this.runSerializer(output, this.options.serializeStepOutput ?? envelopeSerialize, "step output");
+	}
+	deserializeStepOutput(raw) {
+		const deserializer = this.options.deserializeStepOutput ?? ((value) => envelopeDeserialize(value));
+		return this.runDeserializer(raw, deserializer, "step output");
+	}
+	async readInput(executionId) {
+		const [readError, raw] = await this.getMeta(executionId, "input");
+		if (readError) return err(readError.type, readError.message);
+		if (!raw) return err("WorkflowStateError", `Workflow execution ${executionId} input not found`);
+		return this.deserializeInput(raw);
+	}
+	async readResult(executionId) {
+		const [readError, raw] = await this.getMeta(executionId, "result");
+		if (readError) return err(readError.type, readError.message);
+		if (!raw) return ok(null);
+		const [deserializeError, result] = this.deserializeResult(raw);
+		if (deserializeError) return err(deserializeError.type, deserializeError.message);
+		return ok(result);
+	}
+	async writeStepOutput(executionId, stepName, output) {
+		const [serializeError, serializedOutput] = this.serializeStepOutput(output);
+		if (serializeError) return err("WorkflowSerializationError", `Unable to serialize step ${stepName} output`);
+		const payload = {
+			output: serializedOutput,
+			completedAt: now()
+		};
+		const [payloadError, payloadRaw] = mightThrowSync(() => JSON.stringify(payload));
+		if (payloadError || typeof payloadRaw !== "string") return err("WorkflowSerializationError", `Unable to persist step ${stepName} output`);
+		const [writeError] = await mightThrow(this.options.redis.hset(this.stepsKey(executionId), stepName, payloadRaw));
+		if (writeError) return err("WorkflowError", `Unable to persist step ${stepName} for execution ${executionId}`);
+		const [stepNamesError, stepNames] = await this.readStepNames(executionId);
+		if (stepNamesError) return err(stepNamesError.type, stepNamesError.message);
+		if (!stepNames.includes(stepName)) {
+			const nextStepNames = [...stepNames, stepName];
+			const [serializeStepsError, serializedSteps] = mightThrowSync(() => JSON.stringify(nextStepNames));
+			if (serializeStepsError || typeof serializedSteps !== "string") return err("WorkflowSerializationError", `Unable to persist step history for execution ${executionId}`);
+			const [updateStepsError] = await this.setMeta(executionId, "steps", serializedSteps);
+			if (updateStepsError) return err(updateStepsError.type, updateStepsError.message);
+		}
+		const [updatedError] = await this.setMeta(executionId, "updatedAt", String(now()));
+		if (updatedError) return err(updatedError.type, updatedError.message);
+		return ok(null);
+	}
+	async readStepOutput(executionId, stepName) {
+		const [readError, payloadRaw] = await mightThrow(this.options.redis.hget(this.stepsKey(executionId), stepName));
+		if (readError) return err("WorkflowError", `Unable to read step ${stepName} for execution ${executionId}`);
+		if (!payloadRaw) return ok({
+			found: false,
+			value: null
+		});
+		if (typeof payloadRaw !== "string") return err("WorkflowStateError", `Invalid step payload for ${stepName} in execution ${executionId}`);
+		const [parseError, parsed] = mightThrowSync(() => JSON.parse(payloadRaw));
+		if (parseError || parsed === null || typeof parsed !== "object") return err("WorkflowStateError", `Invalid step payload for ${stepName} in execution ${executionId}`);
+		if (typeof parsed.output !== "string") return err("WorkflowStateError", `Invalid step output for ${stepName} in execution ${executionId}`);
+		const outputRaw = parsed.output;
+		const [deserializeError, value] = this.deserializeStepOutput(outputRaw);
+		if (deserializeError) return err(deserializeError.type, deserializeError.message);
+		return ok({
+			found: true,
+			value
+		});
+	}
+	async readStepNames(executionId) {
+		const [readError, stepsRaw] = await this.getMeta(executionId, "steps");
+		if (readError) return [readError, []];
+		if (!stepsRaw) return ok([]);
+		const [parseError, values] = mightThrowSync(() => JSON.parse(stepsRaw));
+		if (parseError || !Array.isArray(values)) return err("WorkflowStateError", `Invalid step index for execution ${executionId}`);
+		const stepNames = [];
+		for (const value of values) if (typeof value === "string") stepNames.push(value);
+		return ok(stepNames);
+	}
+	async readStepSnapshots(executionId) {
+		const [stepNamesError, stepNames] = await this.readStepNames(executionId);
+		if (stepNamesError) return [stepNamesError, []];
+		const steps = [];
+		for (const stepName of stepNames) {
+			const [readError, payloadRaw] = await mightThrow(this.options.redis.hget(this.stepsKey(executionId), stepName));
+			if (readError) return err("WorkflowError", `Unable to read step ${stepName} for execution ${executionId}`);
+			if (!payloadRaw) continue;
+			if (typeof payloadRaw !== "string") return err("WorkflowStateError", `Invalid step payload for ${stepName} in execution ${executionId}`);
+			const [parseError, parsed] = mightThrowSync(() => JSON.parse(payloadRaw));
+			if (parseError || parsed === null || typeof parsed !== "object") return err("WorkflowStateError", `Invalid step payload for ${stepName} in execution ${executionId}`);
+			if (typeof parsed.completedAt !== "number") return err("WorkflowStateError", `Invalid step payload for ${stepName} in execution ${executionId}`);
+			const completedAt = parsed.completedAt;
+			steps.push({
+				name: stepName,
+				completedAt
+			});
+		}
+		return ok(steps);
+	}
+	normalizeStatus(value) {
+		for (const status of knownStatuses) if (status === value) return status;
+		return null;
+	}
+};
+const defineWorkflow = (options) => {
+	const workflow = new WorkflowDefinition(options);
+	return {
+		start: (input, startOptions) => workflow.start(input, startOptions),
+		run: (input, startOptions) => workflow.run(input, startOptions),
+		resume: (executionId) => workflow.resume(executionId),
+		get: (executionId) => workflow.get(executionId),
+		cancel: (executionId) => workflow.cancel(executionId)
+	};
+};
+//#endregion
+export { defineWorkflow };
+
+//# sourceMappingURL=index.mjs.map

package/dist/lib/workflow/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/lib/workflow/index.ts"],"sourcesContent":["import { err, mightThrow, mightThrowSync, ok } from \"../errors/index.js\";\nimport type {\n  StepSnapshot,\n  Workflow,\n  WorkflowCancelResult,\n  WorkflowExecution,\n  WorkflowMeta,\n  WorkflowMetaField,\n  WorkflowOptions,\n  WorkflowStartOptions,\n  WorkflowStartResult,\n  WorkflowStatus,\n} from \"./types.js\";\n\nconst DEFAULT_LOCK_TTL = 5 * 60 * 1000;\n\nconst now = () => Date.now();\n\nconst toErrorMessage = (error: unknown) => {\n  if (error instanceof Error) {\n    return error.message;\n  }\n\n  return String(error);\n};\n\nconst envelopeSerialize = (value: unknown) => {\n  return JSON.stringify({ value });\n};\n\nconst envelopeDeserialize = (raw: string) => {\n  const [parseError, parsed] = mightThrowSync(() => JSON.parse(raw));\n\n  if (parseError) {\n    throw parseError;\n  }\n\n  if (parsed === null) {\n    return undefined;\n  }\n\n  if (typeof parsed !== \"object\") {\n    return undefined;\n  }\n\n  if (\"value\" in parsed) {\n    return parsed.value;\n  }\n\n  return undefined;\n};\n\nconst knownStatuses: WorkflowStatus[] = [\n  \"pending\",\n  \"running\",\n  \"completed\",\n  \"failed\",\n  \"cancelled\",\n];\n\nclass WorkflowDefinition<TInput, TResult> {\n  private options: WorkflowOptions<TInput, TResult>;\n  private lockTTL: number;\n\n  public constructor(options: WorkflowOptions<TInput, TResult>) {\n    this.options = options;\n    this.lockTTL = options.lockTTL ?? DEFAULT_LOCK_TTL;\n  }\n\n  public async start(input: TInput, options?: WorkflowStartOptions) {\n    const executionId = options?.executionId ?? crypto.randomUUID();\n\n    const [createError] = await this.createExecution(executionId, input);\n\n    if (createError) {\n      return err(createError.type, createError.message);\n    }\n\n    return this.execute(executionId, input);\n  }\n\n  public async run(input: TInput, options?: WorkflowStartOptions) {\n    const [startError, startData] = await this.start(input, options);\n\n    if (startError) {\n      return err(startError.type, startError.message);\n    }\n\n    if (!startData) {\n      return err(\"WorkflowError\", \"Unexpected empty start result\");\n    }\n\n    if (startData.status === \"cancelled\") {\n      return err(\n        \"WorkflowCancelledError\",\n        `Workflow execution ${startData.executionId} was cancelled`,\n      );\n    }\n\n    if (startData.status !== \"completed\") {\n      return err(\n        \"WorkflowExecutionError\",\n        `Workflow execution ${startData.executionId} did not complete`,\n      );\n    }\n\n    const [getError, execution] = await this.get(startData.executionId);\n\n    if (getError) {\n      return err(getError.type, getError.message);\n    }\n\n    if (!execution) {\n      return err(\"WorkflowError\", \"Unexpected empty execution\");\n    }\n\n    return ok(execution.result);\n  }\n\n  public async resume(executionId: string) {\n    const [getError, execution] = await this.get(executionId);\n\n    if (getError) {\n      return err(getError.type, getError.message);\n    }\n\n    if (!execution) {\n      return err(\n        \"WorkflowNotFoundError\",\n        `Workflow execution ${executionId} not found`,\n      );\n    }\n\n    if (execution.status === \"completed\") {\n      return ok({ executionId, status: execution.status });\n    }\n\n    if (execution.status === \"cancelled\") {\n      return ok({ executionId, status: execution.status });\n    }\n\n    return this.execute(executionId, execution.input);\n  }\n\n  public async get(executionId: string) {\n    const [statusError, status] = await this.getMeta(executionId, \"status\");\n\n    if (statusError) {\n      return err(statusError.type, statusError.message);\n    }\n\n    if (!status) {\n      return err(\n        \"WorkflowNotFoundError\",\n        `Workflow execution ${executionId} not found`,\n      );\n    }\n\n    const normalizedStatus = this.normalizeStatus(status);\n\n    if (!normalizedStatus) {\n      return err(\n        \"WorkflowStateError\",\n        `Workflow execution ${executionId} has invalid status ${status}`,\n      );\n    }\n\n    const [inputError, input] = await this.readInput(executionId);\n\n    if (inputError) {\n      return err(inputError.type, inputError.message);\n    }\n\n    if (input === null) {\n      return err(\n        \"WorkflowStateError\",\n        `Workflow execution ${executionId} has invalid input`,\n      );\n    }\n\n    const [resultError, result] = await this.readResult(executionId);\n\n    if (resultError) {\n      return err(resultError.type, resultError.message);\n    }\n\n    const [stepsError, steps] = await this.readStepSnapshots(executionId);\n\n    if (stepsError) {\n      return err(stepsError.type, stepsError.message);\n    }\n\n    const [createdAtError, createdAt] = await this.readNumberMeta(\n      executionId,\n      \"createdAt\",\n    );\n\n    if (createdAtError) {\n      return err(createdAtError.type, createdAtError.message);\n    }\n\n    if (createdAt === null) {\n      return err(\n        \"WorkflowStateError\",\n        `Workflow execution ${executionId} is missing createdAt`,\n      );\n    }\n\n    const [updatedAtError, updatedAt] = await this.readNumberMeta(\n      executionId,\n      \"updatedAt\",\n    );\n\n    if (updatedAtError) {\n      return err(updatedAtError.type, updatedAtError.message);\n    }\n\n    if (updatedAt === null) {\n      return err(\n        \"WorkflowStateError\",\n        `Workflow execution ${executionId} is missing updatedAt`,\n      );\n    }\n\n    const [metaError, errorMessage] = await this.getMeta(executionId, \"error\");\n\n    if (metaError) {\n      return err(metaError.type, metaError.message);\n    }\n\n    const [completedAtError, completedAt] = await this.readNumberMeta(\n      executionId,\n      \"completedAt\",\n    );\n\n    if (completedAtError) {\n      return err(completedAtError.type, completedAtError.message);\n    }\n\n    const [failedAtError, failedAt] = await this.readNumberMeta(\n      executionId,\n      \"failedAt\",\n    );\n\n    if (failedAtError) {\n      return err(failedAtError.type, failedAtError.message);\n    }\n\n    const [cancelledAtError, cancelledAt] = await this.readNumberMeta(\n      executionId,\n      \"cancelledAt\",\n    );\n\n    if (cancelledAtError) {\n      return err(cancelledAtError.type, cancelledAtError.message);\n    }\n\n    const data: WorkflowExecution<TInput, TResult> = {\n      id: executionId,\n      name: this.options.name,\n      status: normalizedStatus,\n      input,\n      result,\n      error: errorMessage,\n      createdAt,\n      updatedAt,\n      completedAt,\n      failedAt,\n      cancelledAt,\n      steps,\n    };\n\n    return ok(data);\n  }\n\n  public async cancel(executionId: string) {\n    const [getError, execution] = await this.get(executionId);\n\n    if (getError) {\n      return err(getError.type, getError.message);\n    }\n\n    if (!execution) {\n      return err(\n        \"WorkflowNotFoundError\",\n        `Workflow execution ${executionId} not found`,\n      );\n    }\n\n    if (execution.status === \"completed\") {\n      return err(\n        \"WorkflowStateError\",\n        `Workflow execution ${executionId} is already completed`,\n      );\n    }\n\n    const timestamp = now();\n\n    const [statusError] = await this.setMeta(\n      executionId,\n      \"status\",\n      \"cancelled\",\n    );\n    if (statusError) {\n      return err(statusError.type, statusError.message);\n    }\n\n    const [updatedAtError] = await this.setMeta(\n      executionId,\n      \"updatedAt\",\n      String(timestamp),\n    );\n    if (updatedAtError) {\n      return err(updatedAtError.type, updatedAtError.message);\n    }\n\n    const [cancelledAtError] = await this.setMeta(\n      executionId,\n      \"cancelledAt\",\n      String(timestamp),\n    );\n    if (cancelledAtError) {\n      return err(cancelledAtError.type, cancelledAtError.message);\n    }\n\n    const [clearErrorError] = await this.setMeta(executionId, \"error\", \"\");\n\n    if (clearErrorError) {\n      return err(clearErrorError.type, clearErrorError.message);\n    }\n\n    const [clearFailedAtError] = await this.setMeta(\n      executionId,\n      \"failedAt\",\n      \"\",\n    );\n\n    if (clearFailedAtError) {\n      return err(clearFailedAtError.type, clearFailedAtError.message);\n    }\n\n    const response: WorkflowCancelResult = {\n      executionId,\n      createdAt: execution.createdAt,\n      cancelledAt: timestamp,\n      updatedAt: timestamp,\n      status: \"cancelled\",\n    };\n\n    return ok(response);\n  }\n\n  private executionKey(executionId: string) {\n    return `workflow:${this.options.name}:execution:${executionId}`;\n  }\n\n  private metaKey(executionId: string) {\n    return `${this.executionKey(executionId)}:meta`;\n  }\n\n  private stepsKey(executionId: string) {\n    return `${this.executionKey(executionId)}:steps`;\n  }\n\n  private lockKey(executionId: string) {\n    return `${this.executionKey(executionId)}:lock`;\n  }\n\n  private async createExecution(executionId: string, input: TInput) {\n    const [serializeError, serializedInput] = this.serializeInput(input);\n\n    if (serializeError) {\n      return err(\n        \"WorkflowSerializationError\",\n        `Unable to serialize workflow input for ${executionId}`,\n      );\n    }\n\n    const timestamp = now();\n\n    const [statusReadError, existingStatus] = await this.getMeta(\n      executionId,\n      \"status\",\n    );\n\n    if (statusReadError) {\n      return err(statusReadError.type, statusReadError.message);\n    }\n\n    if (existingStatus) {\n      return err(\n        \"WorkflowStateError\",\n        `Workflow execution ${executionId} already exists`,\n      );\n    }\n\n    const metadata: WorkflowMeta = {\n      status: \"pending\",\n      input: serializedInput,\n      result: \"\",\n      error: \"\",\n      createdAt: String(timestamp),\n      updatedAt: String(timestamp),\n      completedAt: \"\",\n      failedAt: \"\",\n      cancelledAt: \"\",\n      steps: \"[]\",\n    };\n\n    const [writeError] = await mightThrow(\n      this.options.redis.hset(this.metaKey(executionId), metadata),\n    );\n\n    if (writeError) {\n      return err(\n        \"WorkflowError\",\n        `Unable to persist metadata for execution ${executionId}`,\n      );\n    }\n\n    return ok(null);\n  }\n\n  private async execute(executionId: string, input: TInput) {\n    const token = crypto.randomUUID();\n\n    const [lockError] = await this.acquireLock(executionId, token);\n\n    if (lockError) {\n      return err(lockError.type, lockError.message);\n    }\n\n    const [statusCheckError, currentStatus] = await this.getMeta(\n      executionId,\n      \"status\",\n    );\n\n    if (statusCheckError) {\n      await this.releaseLock(executionId, token);\n      return err(statusCheckError.type, statusCheckError.message);\n    }\n\n    if (currentStatus === \"cancelled\") {\n      await this.releaseLock(executionId, token);\n      return err(\n        \"WorkflowStateError\",\n        `Workflow execution ${executionId} was cancelled`,\n      );\n    }\n\n    const timestamp = now();\n\n    const [runningStatusError] = await this.setMeta(\n      executionId,\n      \"status\",\n      \"running\",\n    );\n\n    if (runningStatusError) {\n      await this.releaseLock(executionId, token);\n      return err(runningStatusError.type, runningStatusError.message);\n    }\n\n    const [runningUpdatedAtError] = await this.setMeta(\n      executionId,\n      \"updatedAt\",\n      String(timestamp),\n    );\n\n    if (runningUpdatedAtError) {\n      await this.releaseLock(executionId, token);\n      return err(runningUpdatedAtError.type, runningUpdatedAtError.message);\n    }\n\n    const controller = new AbortController();\n\n    const renewInterval = Math.floor(this.lockTTL / 3);\n\n    let lockLost = false;\n\n    const renewTimer = setInterval(async () => {\n      const [renewError] = await this.extendLock(executionId, token);\n\n      if (renewError) {\n        lockLost = true;\n        controller.abort();\n        clearInterval(renewTimer);\n      }\n    }, renewInterval);\n\n    const step = async <TStep>(\n      name: string,\n      handler: (\n        inputValue: TInput,\n        signal: AbortSignal,\n      ) => TStep | Promise<TStep>,\n    ) => {\n      const [cancelledError, cancelled] = await this.isCancelled(executionId);\n\n      if (cancelledError) {\n        return Promise.reject(new Error(cancelledError.message));\n      }\n\n      if (cancelled) {\n        controller.abort();\n        return Promise.reject(new Error(\"Workflow cancelled\"));\n      }\n\n      const [readError, cachedStep] = await this.readStepOutput<TStep>(\n        executionId,\n        name,\n      );\n\n      if (readError) {\n        return Promise.reject(new Error(readError.message));\n      }\n\n      if (cachedStep.found) {\n        return cachedStep.value as TStep;\n      }\n\n      const [stepError, output] = await mightThrow(\n        Promise.resolve(handler(input, controller.signal)),\n      );\n\n      if (stepError) {\n        return Promise.reject(stepError);\n      }\n\n      const [writeError] = await this.writeStepOutput(\n        executionId,\n        name,\n        output,\n      );\n\n      if (writeError) {\n        return Promise.reject(new Error(writeError.message));\n      }\n\n      return output as TStep;\n    };\n\n    const [handlerError, result] = await mightThrow(\n      Promise.resolve(\n        this.options.handler({\n          input,\n          executionId,\n          signal: controller.signal,\n          step,\n        }),\n      ),\n    );\n\n    clearInterval(renewTimer);\n\n    if (lockLost) {\n      await this.releaseLock(executionId, token);\n\n      return err(\n        \"WorkflowLockError\",\n        `Lock expired during execution ${executionId}`,\n      );\n    }\n\n    const [cancelledError, cancelled] = await this.isCancelled(executionId);\n\n    if (cancelledError) {\n      await this.releaseLock(executionId, token);\n      return err(cancelledError.type, cancelledError.message);\n    }\n\n    if (cancelled) {\n      const cancelledAt = now();\n\n      const [cancelledStatusError] = await this.setMeta(\n        executionId,\n        \"status\",\n        \"cancelled\",\n      );\n\n      if (cancelledStatusError) {\n        await this.releaseLock(executionId, token);\n        return err(cancelledStatusError.type, cancelledStatusError.message);\n      }\n\n      const [cancelledUpdatedAtError] = await this.setMeta(\n        executionId,\n        \"updatedAt\",\n        String(cancelledAt),\n      );\n\n      if (cancelledUpdatedAtError) {\n        await this.releaseLock(executionId, token);\n        return err(\n          cancelledUpdatedAtError.type,\n          cancelledUpdatedAtError.message,\n        );\n      }\n\n      const [cancelledAtError] = await this.setMeta(\n        executionId,\n        \"cancelledAt\",\n        String(cancelledAt),\n      );\n\n      if (cancelledAtError) {\n        await this.releaseLock(executionId, token);\n        return err(cancelledAtError.type, cancelledAtError.message);\n      }\n\n      await this.releaseLock(executionId, token);\n\n      const response: WorkflowStartResult = {\n        executionId,\n        status: \"cancelled\",\n      };\n\n      return ok(response);\n    }\n\n    if (handlerError) {\n      const failedAt = now();\n\n      const [failedStatusError] = await this.setMeta(\n        executionId,\n        \"status\",\n        \"failed\",\n      );\n\n      if (failedStatusError) {\n        await this.releaseLock(executionId, token);\n        return err(failedStatusError.type, failedStatusError.message);\n      }\n\n      const [failedMessageError] = await this.setMeta(\n        executionId,\n        \"error\",\n        toErrorMessage(handlerError),\n      );\n\n      if (failedMessageError) {\n        await this.releaseLock(executionId, token);\n        return err(failedMessageError.type, failedMessageError.message);\n      }\n\n      const [failedUpdatedAtError] = await this.setMeta(\n        executionId,\n        \"updatedAt\",\n        String(failedAt),\n      );\n\n      if (failedUpdatedAtError) {\n        await this.releaseLock(executionId, token);\n        return err(failedUpdatedAtError.type, failedUpdatedAtError.message);\n      }\n\n      const [failedAtError] = await this.setMeta(\n        executionId,\n        \"failedAt\",\n        String(failedAt),\n      );\n\n      if (failedAtError) {\n        await this.releaseLock(executionId, token);\n        return err(failedAtError.type, failedAtError.message);\n      }\n\n      await this.releaseLock(executionId, token);\n\n      return err(\n        \"WorkflowExecutionError\",\n        `Workflow execution ${executionId} failed: ${toErrorMessage(handlerError)}`,\n      );\n    }\n\n    const [serializeResultError, serializedResult] =\n      this.serializeResult(result);\n\n    if (serializeResultError) {\n      const failedAt = now();\n\n      const [failedStatusError] = await this.setMeta(\n        executionId,\n        \"status\",\n        \"failed\",\n      );\n\n      if (failedStatusError) {\n        await this.releaseLock(executionId, token);\n        return err(failedStatusError.type, failedStatusError.message);\n      }\n\n      const [failedMessageError] = await this.setMeta(\n        executionId,\n        \"error\",\n        serializeResultError.message,\n      );\n\n      if (failedMessageError) {\n        await this.releaseLock(executionId, token);\n        return err(failedMessageError.type, failedMessageError.message);\n      }\n\n      const [failedUpdatedAtError] = await this.setMeta(\n        executionId,\n        \"updatedAt\",\n        String(failedAt),\n      );\n\n      if (failedUpdatedAtError) {\n        await this.releaseLock(executionId, token);\n        return err(failedUpdatedAtError.type, failedUpdatedAtError.message);\n      }\n\n      const [failedAtError] = await this.setMeta(\n        executionId,\n        \"failedAt\",\n        String(failedAt),\n      );\n\n      if (failedAtError) {\n        await this.releaseLock(executionId, token);\n        return err(failedAtError.type, failedAtError.message);\n      }\n\n      await this.releaseLock(executionId, token);\n\n      return err(\n        \"WorkflowSerializationError\",\n        `Unable to serialize workflow result for ${executionId}`,\n      );\n    }\n\n    const completedAt = now();\n\n    const [completedResultError] = await this.setMeta(\n      executionId,\n      \"result\",\n      serializedResult,\n    );\n\n    if (completedResultError) {\n      await this.releaseLock(executionId, token);\n      return err(completedResultError.type, completedResultError.message);\n    }\n\n    const [completedStatusError] = await this.setMeta(\n      executionId,\n      \"status\",\n      \"completed\",\n    );\n\n    if (completedStatusError) {\n      await this.releaseLock(executionId, token);\n      return err(completedStatusError.type, completedStatusError.message);\n    }\n\n    const [completedClearErrorError] = await this.setMeta(\n      executionId,\n      \"error\",\n      \"\",\n    );\n\n    if (completedClearErrorError) {\n      await this.releaseLock(executionId, token);\n      return err(\n        completedClearErrorError.type,\n        completedClearErrorError.message,\n      );\n    }\n\n    const [completedClearFailedAtError] = await this.setMeta(\n      executionId,\n      \"failedAt\",\n      \"\",\n    );\n\n    if (completedClearFailedAtError) {\n      await this.releaseLock(executionId, token);\n      return err(\n        completedClearFailedAtError.type,\n        completedClearFailedAtError.message,\n      );\n    }\n\n    const [completedUpdatedAtError] = await this.setMeta(\n      executionId,\n      \"updatedAt\",\n      String(completedAt),\n    );\n\n    if (completedUpdatedAtError) {\n      await this.releaseLock(executionId, token);\n      return err(completedUpdatedAtError.type, completedUpdatedAtError.message);\n    }\n\n    const [completedAtError] = await this.setMeta(\n      executionId,\n      \"completedAt\",\n      String(completedAt),\n    );\n\n    if (completedAtError) {\n      await this.releaseLock(executionId, token);\n      return err(completedAtError.type, completedAtError.message);\n    }\n\n    await this.releaseLock(executionId, token);\n\n    const response: WorkflowStartResult = {\n      executionId,\n      status: \"completed\",\n    };\n\n    return ok(response);\n  }\n\n  private async acquireLock(executionId: string, token: string) {\n    const [lockError, lockResult] = await mightThrow(\n      this.options.redis.set(\n        this.lockKey(executionId),\n        token,\n        \"PX\",\n        String(this.lockTTL),\n        \"NX\",\n      ),\n    );\n\n    if (lockError) {\n      return err(\n        \"WorkflowLockError\",\n        `Unable to acquire lock for execution ${executionId}`,\n      );\n    }\n\n    if (lockResult !== \"OK\") {\n      return err(\n        \"WorkflowLockError\",\n        `Workflow execution ${executionId} is already running`,\n      );\n    }\n\n    return ok(null);\n  }\n\n  private async releaseLock(executionId: string, token: string) {\n    const script =\n      \"if redis.call('GET', KEYS[1]) == ARGV[1] then return redis.call('DEL', KEYS[1]) else return 0 end\";\n\n    const [evalError] = await mightThrow(\n      this.options.redis.send(\"EVAL\", [\n        script,\n        \"1\",\n        this.lockKey(executionId),\n        token,\n      ]),\n    );\n\n    if (evalError) {\n      return err(\n        \"WorkflowLockError\",\n        `Unable to release lock for execution ${executionId}`,\n      );\n    }\n\n    return ok(null);\n  }\n\n  private async extendLock(executionId: string, token: string) {\n    const script =\n      \"if redis.call('GET', KEYS[1]) == ARGV[1] then return redis.call('PEXPIRE', KEYS[1], ARGV[2]) else return 0 end\";\n\n    const [evalError, result] = await mightThrow(\n      this.options.redis.send(\"EVAL\", [\n        script,\n        \"1\",\n        this.lockKey(executionId),\n        token,\n        String(this.lockTTL),\n      ]),\n    );\n\n    if (evalError) {\n      return err(\n        \"WorkflowLockError\",\n        `Unable to extend lock for execution ${executionId}`,\n      );\n    }\n\n    if (result === 0) {\n      return err(\n        \"WorkflowLockError\",\n        `Lock ownership lost for execution ${executionId}`,\n      );\n    }\n\n    return ok(null);\n  }\n\n  private async isCancelled(executionId: string) {\n    const [statusError, status] = await this.getMeta(executionId, \"status\");\n\n    if (statusError) {\n      return err(statusError.type, statusError.message);\n    }\n\n    return ok(status === \"cancelled\");\n  }\n\n  private async setMeta(\n    executionId: string,\n    field: WorkflowMetaField,\n    value: string,\n  ) {\n    const [writeError] = await mightThrow(\n      this.options.redis.hset(this.metaKey(executionId), field, value),\n    );\n\n    if (writeError) {\n      return err(\n        \"WorkflowError\",\n        `Unable to persist ${field} for execution ${executionId}`,\n      );\n    }\n\n    return ok(null);\n  }\n\n  private async getMeta(executionId: string, field: WorkflowMetaField) {\n    const [readError, value] = await mightThrow(\n      this.options.redis.hget(this.metaKey(executionId), field),\n    );\n\n    if (readError) {\n      return err(\n        \"WorkflowError\",\n        `Unable to read ${field} for execution ${executionId}`,\n      );\n    }\n\n    if (value === null || value === undefined) {\n      return ok(null);\n    }\n\n    if (typeof value !== \"string\") {\n      return err(\n        \"WorkflowStateError\",\n        `Invalid ${field} value for execution ${executionId}`,\n      );\n    }\n\n    if (value.length === 0) {\n      return ok(null);\n    }\n\n    return ok(value);\n  }\n\n  private async readNumberMeta(executionId: string, field: WorkflowMetaField) {\n    const [readError, value] = await this.getMeta(executionId, field);\n\n    if (readError) {\n      return err(readError.type, readError.message);\n    }\n\n    if (!value) {\n      return ok(null);\n    }\n\n    const parsed = Number(value);\n\n    if (!Number.isFinite(parsed)) {\n      return err(\n        \"WorkflowStateError\",\n        `Invalid ${field} value for execution ${executionId}`,\n      );\n    }\n\n    return ok(parsed);\n  }\n\n  private runSerializer<T>(\n    value: T,\n    serializer: (v: T) => string,\n    label: string,\n  ) {\n    const [serializeError, serialized] = mightThrowSync(() =>\n      serializer(value),\n    );\n\n    if (serializeError) {\n      return err(\n        \"WorkflowSerializationError\",\n        `Unable to serialize ${label}: ${toErrorMessage(serializeError)}`,\n      );\n    }\n\n    if (typeof serialized !== \"string\") {\n      return err(\n        \"WorkflowSerializationError\",\n        `${label} serializer must return a string`,\n      );\n    }\n\n    return ok(serialized);\n  }\n\n  private runDeserializer<T>(\n    raw: string,\n    deserializer: (v: string) => T,\n    label: string,\n  ) {\n    const [deserializeError, value] = mightThrowSync(() => deserializer(raw));\n\n    if (deserializeError) {\n      return err(\n        \"WorkflowSerializationError\",\n        `Unable to deserialize ${label}: ${toErrorMessage(deserializeError)}`,\n      );\n    }\n\n    return ok(value);\n  }\n\n  private serializeInput(input: TInput) {\n    return this.runSerializer(\n      input,\n      this.options.serializeInput ?? envelopeSerialize,\n      \"workflow input\",\n    );\n  }\n\n  private deserializeInput(raw: string) {\n    const deserializer =\n      this.options.deserializeInput ??\n      ((value: string) => envelopeDeserialize(value) as TInput);\n\n    return this.runDeserializer(raw, deserializer, \"workflow input\");\n  }\n\n  private serializeResult(result: TResult | null) {\n    if (result === null) {\n      return ok(envelopeSerialize(null));\n    }\n\n    return this.runSerializer(\n      result,\n      this.options.serializeResult ?? envelopeSerialize,\n      \"workflow result\",\n    );\n  }\n\n  private deserializeResult(raw: string) {\n    const deserializer =\n      this.options.deserializeResult ??\n      ((value: string) => envelopeDeserialize(value) as TResult);\n\n    return this.runDeserializer(raw, deserializer, \"workflow result\");\n  }\n\n  private serializeStepOutput(output: unknown) {\n    return this.runSerializer(\n      output,\n      this.options.serializeStepOutput ?? envelopeSerialize,\n      \"step output\",\n    );\n  }\n\n  private deserializeStepOutput(raw: string) {\n    const deserializer =\n      this.options.deserializeStepOutput ??\n      ((value: string) => envelopeDeserialize(value));\n\n    return this.runDeserializer(raw, deserializer, \"step output\");\n  }\n\n  private async readInput(executionId: string) {\n    const [readError, raw] = await this.getMeta(executionId, \"input\");\n\n    if (readError) {\n      return err(readError.type, readError.message);\n    }\n\n    if (!raw) {\n      return err(\n        \"WorkflowStateError\",\n        `Workflow execution ${executionId} input not found`,\n      );\n    }\n\n    return this.deserializeInput(raw);\n  }\n\n  private async readResult(executionId: string) {\n    const [readError, raw] = await this.getMeta(executionId, \"result\");\n\n    if (readError) {\n      return err(readError.type, readError.message);\n    }\n\n    if (!raw) {\n      return ok(null);\n    }\n\n    const [deserializeError, result] = this.deserializeResult(raw);\n\n    if (deserializeError) {\n      return err(deserializeError.type, deserializeError.message);\n    }\n\n    return ok(result);\n  }\n\n  private async writeStepOutput(\n    executionId: string,\n    stepName: string,\n    output: unknown,\n  ) {\n    const [serializeError, serializedOutput] = this.serializeStepOutput(output);\n\n    if (serializeError) {\n      return err(\n        \"WorkflowSerializationError\",\n        `Unable to serialize step ${stepName} output`,\n      );\n    }\n\n    const payload = {\n      output: serializedOutput,\n      completedAt: now(),\n    };\n\n    const [payloadError, payloadRaw] = mightThrowSync(() =>\n      JSON.stringify(payload),\n    );\n\n    if (payloadError || typeof payloadRaw !== \"string\") {\n      return err(\n        \"WorkflowSerializationError\",\n        `Unable to persist step ${stepName} output`,\n      );\n    }\n\n    const [writeError] = await mightThrow(\n      this.options.redis.hset(this.stepsKey(executionId), stepName, payloadRaw),\n    );\n\n    if (writeError) {\n      return err(\n        \"WorkflowError\",\n        `Unable to persist step ${stepName} for execution ${executionId}`,\n      );\n    }\n\n    const [stepNamesError, stepNames] = await this.readStepNames(executionId);\n\n    if (stepNamesError) {\n      return err(stepNamesError.type, stepNamesError.message);\n    }\n\n    if (!stepNames.includes(stepName)) {\n      const nextStepNames = [...stepNames, stepName];\n\n      const [serializeStepsError, serializedSteps] = mightThrowSync(() =>\n        JSON.stringify(nextStepNames),\n      );\n\n      if (serializeStepsError || typeof serializedSteps !== \"string\") {\n        return err(\n          \"WorkflowSerializationError\",\n          `Unable to persist step history for execution ${executionId}`,\n        );\n      }\n\n      const [updateStepsError] = await this.setMeta(\n        executionId,\n        \"steps\",\n        serializedSteps,\n      );\n\n      if (updateStepsError) {\n        return err(updateStepsError.type, updateStepsError.message);\n      }\n    }\n\n    const [updatedError] = await this.setMeta(\n      executionId,\n      \"updatedAt\",\n      String(now()),\n    );\n\n    if (updatedError) {\n      return err(updatedError.type, updatedError.message);\n    }\n\n    return ok(null);\n  }\n\n  private async readStepOutput<TStep>(executionId: string, stepName: string) {\n    const [readError, payloadRaw] = await mightThrow(\n      this.options.redis.hget(this.stepsKey(executionId), stepName),\n    );\n\n    if (readError) {\n      return err(\n        \"WorkflowError\",\n        `Unable to read step ${stepName} for execution ${executionId}`,\n      );\n    }\n\n    if (!payloadRaw) {\n      return ok({ found: false, value: null });\n    }\n\n    if (typeof payloadRaw !== \"string\") {\n      return err(\n        \"WorkflowStateError\",\n        `Invalid step payload for ${stepName} in execution ${executionId}`,\n      );\n    }\n\n    const [parseError, parsed] = mightThrowSync(() => JSON.parse(payloadRaw));\n\n    if (parseError || parsed === null || typeof parsed !== \"object\") {\n      return err(\n        \"WorkflowStateError\",\n        `Invalid step payload for ${stepName} in execution ${executionId}`,\n      );\n    }\n\n    if (typeof parsed.output !== \"string\") {\n      return err(\n        \"WorkflowStateError\",\n        `Invalid step output for ${stepName} in execution ${executionId}`,\n      );\n    }\n\n    const outputRaw = parsed.output;\n\n    const [deserializeError, value] = this.deserializeStepOutput(outputRaw);\n\n    if (deserializeError) {\n      return err(deserializeError.type, deserializeError.message);\n    }\n\n    return ok({ found: true, value: value as TStep });\n  }\n\n  private async readStepNames(executionId: string) {\n    const [readError, stepsRaw] = await this.getMeta(executionId, \"steps\");\n\n    if (readError) {\n      return [readError, []] as const;\n    }\n\n    if (!stepsRaw) {\n      return ok([] as string[]);\n    }\n\n    const [parseError, values] = mightThrowSync(() => JSON.parse(stepsRaw));\n\n    if (parseError || !Array.isArray(values)) {\n      return err(\n        \"WorkflowStateError\",\n        `Invalid step index for execution ${executionId}`,\n      );\n    }\n\n    const stepNames: string[] = [];\n\n    for (const value of values) {\n      if (typeof value === \"string\") {\n        stepNames.push(value);\n      }\n    }\n\n    return ok(stepNames);\n  }\n\n  private async readStepSnapshots(executionId: string) {\n    const [stepNamesError, stepNames] = await this.readStepNames(executionId);\n\n    if (stepNamesError) {\n      return [stepNamesError, []] as const;\n    }\n\n    const steps: StepSnapshot[] = [];\n\n    for (const stepName of stepNames) {\n      const [readError, payloadRaw] = await mightThrow(\n        this.options.redis.hget(this.stepsKey(executionId), stepName),\n      );\n\n      if (readError) {\n        return err(\n          \"WorkflowError\",\n          `Unable to read step ${stepName} for execution ${executionId}`,\n        );\n      }\n\n      if (!payloadRaw) {\n        continue;\n      }\n\n      if (typeof payloadRaw !== \"string\") {\n        return err(\n          \"WorkflowStateError\",\n          `Invalid step payload for ${stepName} in execution ${executionId}`,\n        );\n      }\n\n      const [parseError, parsed] = mightThrowSync(() => JSON.parse(payloadRaw));\n\n      if (parseError || parsed === null || typeof parsed !== \"object\") {\n        return err(\n          \"WorkflowStateError\",\n          `Invalid step payload for ${stepName} in execution ${executionId}`,\n        );\n      }\n\n      if (typeof parsed.completedAt !== \"number\") {\n        return err(\n          \"WorkflowStateError\",\n          `Invalid step payload for ${stepName} in execution ${executionId}`,\n        );\n      }\n\n      const completedAt = parsed.completedAt;\n\n      steps.push({\n        name: stepName,\n        completedAt,\n      });\n    }\n\n    return ok(steps);\n  }\n\n  private normalizeStatus(value: string) {\n    for (const status of knownStatuses) {\n      if (status === value) {\n        return status;\n      }\n    }\n\n    return null;\n  }\n}\n\nexport const defineWorkflow = <TInput, TResult = void>(\n  options: WorkflowOptions<TInput, TResult>,\n): Workflow<TInput, TResult> => {\n  const workflow = new WorkflowDefinition(options);\n\n  return {\n    start: (input, startOptions) => workflow.start(input, startOptions),\n    run: (input, startOptions) => workflow.run(input, startOptions),\n    resume: (executionId) => workflow.resume(executionId),\n    get: (executionId) => workflow.get(executionId),\n    cancel: (executionId) => workflow.cancel(executionId),\n  };\n};\n\nexport type {\n  StepHandler,\n  Workflow,\n  WorkflowError,\n  WorkflowExecution,\n  WorkflowHandlerContext,\n  WorkflowMeta,\n  WorkflowMetaField,\n  WorkflowOptions,\n  WorkflowStartOptions,\n  WorkflowStartResult,\n  WorkflowStatus,\n} from \"./types.js\";\n"],"mappings":"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"}