@orkestrel/workflow 0.0.18 → 0.0.19

package/dist/src/core/index.js

@@ -1,5 +1,5 @@
+import { arrayShape, attempt, cloneJSONRecord, cloneJSONValue, compileGuard, createContract, integerShape, isArray, isBoolean, isContractError, isError, isFiniteNumber, isFunction, isInstance, isInteger, isJSONValue, isNonEmptyString, isObject, isRecord, isString, literalShape, objectShape, optionalShape, rawShape, stringShape } from "@orkestrel/contract";
 import { createAbort, isAbortSignal, linkSignal } from "@orkestrel/abort";
-import { arrayShape, attempt, cloneJSONRecord, cloneJSONValue, compileGuard, createContract, integerShape, isArray, isBoolean, isContractError, isFiniteNumber, isFunction, isInteger, isJSONValue, isNonEmptyString, isObject, isRecord, literalShape, objectShape, optionalShape, rawShape, stringShape } from "@orkestrel/contract";
 import { createDatabase, createMemoryDriver } from "@orkestrel/database";
 import { Emitter } from "@orkestrel/emitter";
 import { createTimeout } from "@orkestrel/timeout";
@@ -44,11 +44,7 @@ var WorkflowError = class extends Error {
 * ```
 */
 function isWorkflowError(value) {
-	try {
-		return value instanceof WorkflowError;
-	} catch {
-		return false;
-	}
+	return isInstance(value, WorkflowError);
 }
 //#endregion
 //#region src/core/constants.ts
@@ -277,14 +273,14 @@ function isWorkflowInterface(value) {
 */
 function isOwnedWorkflowSnapshot(value) {
 	try {
-		if (!isRecord(value) || !Object.keys(value).every((key) => key === "id" || key === "name" || key === "description" || key === "status" || key === "override" || key === "bail" || key === "phases" || key === "created" || key === "updated") || !isNonEmptyString(value.id) || !isNonEmptyString(value.name) || value.description !== void 0 && typeof value.description !== "string" || !isLifecycleStatus(value.status) || value.override !== void 0 && value.override !== "completed" && value.override !== "skipped" && value.override !== "stopped" || !isBoolean(value.bail) || !isArray(value.phases) || !isFiniteNumber(value.created) || value.created < 0 || !isFiniteNumber(value.updated) || value.updated < value.created) return false;
+		if (!isRecord(value) || !Object.keys(value).every((key) => key === "id" || key === "name" || key === "description" || key === "status" || key === "override" || key === "bail" || key === "phases" || key === "created" || key === "updated") || !isNonEmptyString(value.id) || !isNonEmptyString(value.name) || value.description !== void 0 && !isString(value.description) || !isLifecycleStatus(value.status) || value.override !== void 0 && value.override !== "completed" && value.override !== "skipped" && value.override !== "stopped" || !isBoolean(value.bail) || !isArray(value.phases) || !isFiniteNumber(value.created) || value.created < 0 || !isFiniteNumber(value.updated) || value.updated < value.created) return false;
 		const phaseIds = /* @__PURE__ */ new Set();
 		const derivations = [];
 		let frontier = false;
 		let running = false;
 		let vacuous = true;
 		for (const phase of value.phases) {
-			if (!isRecord(phase) || !Object.keys(phase).every((key) => key === "id" || key === "name" || key === "description" || key === "status" || key === "override" || key === "bail" || key === "concurrency" || key === "tasks") || !isNonEmptyString(phase.id) || phaseIds.has(phase.id) || !isNonEmptyString(phase.name) || phase.description !== void 0 && typeof phase.description !== "string" || !isLifecycleStatus(phase.status) || phase.override !== void 0 && phase.override !== "skipped" && phase.override !== "stopped" || !isBoolean(phase.bail) || phase.concurrency !== void 0 && (!isInteger(phase.concurrency) || phase.concurrency < 1) || !isArray(phase.tasks)) return false;
+			if (!isRecord(phase) || !Object.keys(phase).every((key) => key === "id" || key === "name" || key === "description" || key === "status" || key === "override" || key === "bail" || key === "concurrency" || key === "tasks") || !isNonEmptyString(phase.id) || phaseIds.has(phase.id) || !isNonEmptyString(phase.name) || phase.description !== void 0 && !isString(phase.description) || !isLifecycleStatus(phase.status) || phase.override !== void 0 && phase.override !== "skipped" && phase.override !== "stopped" || !isBoolean(phase.bail) || phase.concurrency !== void 0 && (!isInteger(phase.concurrency) || phase.concurrency < 1) || !isArray(phase.tasks)) return false;
 			const forced = phase.override === "skipped" || phase.override === "stopped";
 			const started = phase.status === "running" || phase.status === "completed" || phase.status === "failed";
 			if (!forced && frontier && started || phase.status === "running" && running) return false;
@@ -295,7 +291,7 @@ function isOwnedWorkflowSnapshot(value) {
 			const statuses = [];
 			if (phase.tasks.length > 0) vacuous = false;
 			for (const task of phase.tasks) {
-				if (!isRecord(task) || !Object.keys(task).every((key) => key === "id" || key === "name" || key === "description" || key === "status" || key === "result" || key === "metadata" || key === "attempts" || key === "behavior" || key === "retries" || key === "timeout" || key === "activity") || !isNonEmptyString(task.id) || taskIds.has(task.id) || !isNonEmptyString(task.name) || task.description !== void 0 && typeof task.description !== "string" || !isLifecycleStatus(task.status) || !isRecord(task.metadata) || !isJSONValue(task.metadata) || !isInteger(task.attempts) || task.attempts < 0 || task.behavior !== void 0 && !isNonEmptyString(task.behavior) || task.retries !== void 0 && (!isInteger(task.retries) || task.retries < 0) || task.timeout !== void 0 && (!isInteger(task.timeout) || task.timeout < 0 || task.timeout > 2147483647)) return false;
+				if (!isRecord(task) || !Object.keys(task).every((key) => key === "id" || key === "name" || key === "description" || key === "status" || key === "result" || key === "metadata" || key === "attempts" || key === "behavior" || key === "retries" || key === "timeout" || key === "activity") || !isNonEmptyString(task.id) || taskIds.has(task.id) || !isNonEmptyString(task.name) || task.description !== void 0 && !isString(task.description) || !isLifecycleStatus(task.status) || !isRecord(task.metadata) || !isJSONValue(task.metadata) || !isInteger(task.attempts) || task.attempts < 0 || task.behavior !== void 0 && !isNonEmptyString(task.behavior) || task.retries !== void 0 && (!isInteger(task.retries) || task.retries < 0) || task.timeout !== void 0 && (!isInteger(task.timeout) || task.timeout < 0 || task.timeout > 2147483647)) return false;
 				const budget = (task.retries ?? 0) + 1;
 				if (task.attempts > budget || task.status === "pending" && task.attempts >= budget) return false;
 				if (!(task.activity === void 0 || isTaskActivity(task.activity))) return false;
@@ -771,8 +767,8 @@ function canTransitionTask(from, to) {
 * @returns A host-safe effective window (`1..MAX_TIMER_MS`), or `undefined`
 */
 function resolveTaskSilence(value, fallback) {
-	if (value !== void 0) return Number.isFinite(value) && value > 0 && value <= 2147483647 ? value : void 0;
-	return fallback !== void 0 && Number.isFinite(fallback) && fallback > 0 && fallback <= 2147483647 ? fallback : void 0;
+	if (value !== void 0) return isFiniteNumber(value) && value > 0 && value <= 2147483647 ? value : void 0;
+	return fallback !== void 0 && isFiniteNumber(fallback) && fallback > 0 && fallback <= 2147483647 ? fallback : void 0;
 }
 /**
 * Boxes a value as a {@link Success} — the graceful outcome half of a {@link Result}.
@@ -818,8 +814,8 @@ function failure(error) {
 */
 function errorToMessage(error) {
 	try {
-		const message = error instanceof Error ? error.message : String(error);
-		return typeof message === "string" && message.length > 0 ? message : "unknown failure";
+		const message = isError(error) ? error.message : String(error);
+		return isString(message) && message.length > 0 ? message : "unknown failure";
 	} catch {
 		return "unknown failure";
 	}
@@ -1089,7 +1085,7 @@ function recoverWorkflowSnapshot(snapshot) {
 * ```
 */
 function matchesDescription(left, right) {
-	return left === right && (left === void 0 || typeof left === "string");
+	return left === right && (left === void 0 || isString(left));
 }
 /**
 * Tests a result's lineage against its containing snapshot nodes.
@@ -2087,7 +2083,7 @@ var Task = class {
 	}
 	fail(error) {
 		const origin = error.origin === "handler" || error.origin === "timeout" || error.origin === "recovery" ? error.origin : "handler";
-		const message = typeof error.message === "string" && error.message.length > 0 ? error.message : "unknown failure";
+		const message = isString(error.message) && error.message.length > 0 ? error.message : "unknown failure";
 		this.#transition("failed");
 		this.#finish();
 		const result = this.#record("failed", Object.freeze({
@@ -2126,7 +2122,7 @@ var Task = class {
 			this.#emitter.emit("report", activity);
 			return success(activity);
 		} catch (error) {
-			return failure(error instanceof WorkflowError ? error : new WorkflowError("MUTATION", "task activity report was refused", { task: this.id }));
+			return failure(isWorkflowError(error) ? error : new WorkflowError("MUTATION", "task activity report was refused", { task: this.id }));
 		}
 	}
 	pulse() {
@@ -4024,7 +4020,7 @@ var WorkflowRunner = class WorkflowRunner {
 		let runSignal;
 		let onCancel;
 		try {
-			timeout = ms !== void 0 && Number.isFinite(ms) && ms > 0 && ms <= 2147483647 ? createTimeout({ ms }) : void 0;
+			timeout = ms !== void 0 && isFiniteNumber(ms) && ms > 0 && ms <= 2147483647 ? createTimeout({ ms }) : void 0;
 			timeout?.start();
 			budget?.start();
 			runSignal = this.#fold(workflow, signal, budget, timeout);
@@ -4157,7 +4153,7 @@ var WorkflowRunner = class WorkflowRunner {
 			return;
 		}
 		const ms = task.timeout;
-		const deadline = ms !== void 0 && Number.isFinite(ms) && ms > 0 && ms <= 2147483647 ? createTimeout({ ms }) : void 0;
+		const deadline = ms !== void 0 && isFiniteNumber(ms) && ms > 0 && ms <= 2147483647 ? createTimeout({ ms }) : void 0;
 		const signal = this.#taskSignal(task, controller.signal, runSignal, deadline);
 		try {
 			task.start();
@@ -4311,7 +4307,7 @@ var WorkflowRunner = class WorkflowRunner {
 		try {
 			if (workflow !== void 0 && isHalted(workflow, phase)) deferred.resolve(void 0);
 			const outcome = await Promise.race([wait, deferred.promise]);
-			return typeof outcome === "boolean" ? outcome : void 0;
+			return isBoolean(outcome) ? outcome : void 0;
 		} finally {
 			signal.removeEventListener("abort", onAbort);
 			workflow?.emitter.off("skip", onTerminal);