@hyperfixation/workflows 0.1.0

package/dist/worker-runtime.d.ts

@@ -0,0 +1,18 @@
+import type { StepPool } from "@hyperfixation/db";
+import type { ApprovalNotifier } from "./approvals.js";
+import type { ControlPool } from "./control-pool.js";
+/** What a running flow needs from the worker that launched it. */
+export interface WorkerRuntime {
+    appName: string;
+    applicationVersion: string;
+    steps: StepPool;
+    control: ControlPool;
+    /** What `waitForApproval` notifies through when the call passes no `notify` of its own. */
+    approvalNotifier?: ApprovalNotifier;
+}
+export declare class WorkerNotStarted extends Error {
+    readonly operation: string;
+    constructor(operation: string);
+}
+export declare function setWorkerRuntime(runtime: WorkerRuntime): void;
+export declare function workerRuntime(operation: string): WorkerRuntime;

package/dist/worker-runtime.js

@@ -0,0 +1,22 @@
+export class WorkerNotStarted extends Error {
+    operation;
+    constructor(operation) {
+        super(`WorkerNotStarted: ${operation} needs the pools startWorker() builds`);
+        this.name = "WorkerNotStarted";
+        this.operation = operation;
+    }
+}
+/**
+ * Process-wide because `DBOS.launch()` is: one worker per process is already enforced by the
+ * advisory lock, and a flow function reached by DBOS recovery is handed nothing but its own
+ * arguments — there is no call site to thread the pools through.
+ */
+let current;
+export function setWorkerRuntime(runtime) {
+    current = runtime;
+}
+export function workerRuntime(operation) {
+    if (current === undefined)
+        throw new WorkerNotStarted(operation);
+    return current;
+}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@hyperfixation/workflows",
+  "version": "0.1.0",
+  "license": "MIT",
+  "description": "startWorker, defineFlow and the run lifecycle, the step wrapper, approvals, actions, queues, and the reconciler",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/grahamlutz/hyperfixation-core.git",
+    "directory": "packages/workflows"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "!dist/**/*.test.*",
+    "!dist/test-support/**"
+  ],
+  "dependencies": {
+    "@dbos-inc/dbos-sdk": "4.27.6",
+    "@hyperfixation/db": "0.1.0",
+    "@langfuse/otel": "5.11.1",
+    "@opentelemetry/api": "1.9.1",
+    "@opentelemetry/context-async-hooks": "2.11.0",
+    "@opentelemetry/core": "2.11.0",
+    "@opentelemetry/exporter-trace-otlp-http": "0.220.0",
+    "@opentelemetry/sdk-trace-base": "2.11.0",
+    "@opentelemetry/sdk-trace-node": "2.11.0",
+    "drizzle-orm": "^0.45.2",
+    "pg": "^8.23.0",
+    "zod": "4.6.5"
+  },
+  "devDependencies": {
+    "@hyperfixation/eslint-config": "0.1.0",
+    "@hyperfixation/testing": "0.1.0",
+    "@microsoft/api-extractor": "^7.59.1",
+    "@sentry/node": "^10.74.0",
+    "@types/pg": "^8.23.1",
+    "eslint": "^10.10.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "lint": "eslint src",
+    "api-extractor": "api-extractor run",
+    "api-extractor:update": "api-extractor run --local",
+    "test": "vitest run --passWithNoTests"
+  }
+}