@protobase/workflows 0.0.0-stage → 0.68.0

package/dist/run/task.js

@@ -0,0 +1,39 @@
+import { limits } from "../limits.js";
+import { StepError, SupersededError } from "./errors.js";
+//#region src/run/task.ts
+const aborted = (signal) => new Promise((_, reject) => {
+	if (signal.aborted) return reject(signal.reason);
+	signal.addEventListener("abort", () => reject(signal.reason), { once: true });
+});
+/**
+* Runs a Task's step type with its arguments, within its `TimeoutSeconds`: its result, or a `StepError` naming why it
+* failed (`States.Timeout` when the time ran out, `States.TaskFailed` for an error of no name of its own). When the
+* worker stops, the abort is thrown as it is, so the step is not saved and runs again in the next segment.
+*/
+const runTask = async (context, state, args, idempotencyKey, logs) => {
+	const handler = context.tasks[state.Resource];
+	if (!handler) throw new StepError("States.Runtime", `"${state.Resource}" is not a step type of this app`);
+	const timeout = AbortSignal.timeout((state.TimeoutSeconds ?? limits.defaultTaskTimeoutSeconds) * 1e3);
+	const signal = AbortSignal.any([context.signal, timeout]);
+	const log = (message) => void logs.push({
+		at: context.now().toISOString(),
+		message
+	});
+	context.signal.throwIfAborted();
+	try {
+		return await Promise.race([handler(args, {
+			runId: context.runId,
+			signal,
+			idempotencyKey,
+			log,
+			redact: context.redactor.text
+		}), aborted(signal)]);
+	} catch (error) {
+		if (context.signal.aborted || error instanceof SupersededError) throw error;
+		if (timeout.aborted) throw new StepError("States.Timeout", `The step ran longer than ${state.TimeoutSeconds ?? limits.defaultTaskTimeoutSeconds} seconds`);
+		if (error instanceof StepError) throw error;
+		throw new StepError("States.TaskFailed", error instanceof Error ? error.message : String(error));
+	}
+};
+//#endregion
+export { runTask };

package/package.json

@@ -1,6 +1,36 @@
 {
   "name": "@protobase/workflows",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.68.0",
+  "description": "Workflows as state machines with JSONata expressions: their check, a runner that saves every step, and the plugin interface for trigger and step types.",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/PrototeamHQ/protobase.git",
+    "directory": "packages/workflows"
+  },
+  "homepage": "https://docs.protobase.net",
+  "type": "module",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "exports": {
+    ".": "./dist/index.js",
+    "./plugin": "./dist/plugin/index.js"
+  },
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsdown",
+    "prepack": "tsdown"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "jsonata": "^2.2.2",
+    "ajv": "^8.20.0"
+  }
+}

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.