lightflow-engine 0.1.0

package/dist/test/workflow-def.js

@@ -0,0 +1,54 @@
+import { registerWorkflow } from "../src/index.js";
+export async function parityWorkflow(opts) {
+    "use workflow";
+    const { step, sleep, getWritable, FatalError, getWorkflowMetadata } = await import("../src/index.js");
+    const { runId } = getWorkflowMetadata();
+    const writable = getWritable();
+    const started = Date.now();
+    let fatalCaught = false;
+    await writable.write("stage:start;");
+    try {
+        await step(async () => { throw new Error("transient"); });
+    }
+    catch {
+        fatalCaught = true;
+    }
+    const lease = `lrun-${runId}`;
+    const claimed = await step(async () => {
+        const pg = (await import("pg")).default;
+        const pool = new pg.Pool({ connectionString: process.env.APP_PG_URL, max: 4 });
+        const r = await pool.query(`UPDATE sessions SET lifecycle_run_id=$2 WHERE id=$1 AND lifecycle_run_id IS NULL`, [opts.sessionId, lease]);
+        await pool.end();
+        return (r.rowCount ?? 0) > 0;
+    });
+    await writable.write(`stage:lease:${claimed};`);
+    for (let i = 0; i < opts.ticks; i += 1) {
+        await sleep(new Date(Date.now() + 1000));
+        await writable.write(`stage:tick:${i + 1};`);
+    }
+    const persisted = await step(async () => {
+        const pg = (await import("pg")).default;
+        const pool = new pg.Pool({ connectionString: process.env.APP_PG_URL, max: 4 });
+        await pool.query(`INSERT INTO workflow_runs (id, chat_id, session_id, user_id, status, started_at, finished_at, total_duration_ms)
+       VALUES ($1,$2,'selftest-session','selftest-user','completed',now(),now(),$3)
+       ON CONFLICT (id) DO NOTHING`, [runId, opts.chatId, Math.round(Date.now() - started)]);
+        await pool.end();
+        return true;
+    });
+    await step(async () => {
+        const pg = (await import("pg")).default;
+        const pool = new pg.Pool({ connectionString: process.env.APP_PG_URL, max: 4 });
+        await pool.query(`UPDATE sessions SET lifecycle_run_id=NULL WHERE id=$1`, [opts.sessionId]);
+        await pool.end();
+    });
+    await writable.write("stage:done;");
+    await writable.close();
+    return {
+        ok: true, runId, ticks: opts.ticks,
+        leaseValue: claimed ? lease : null,
+        persisted, fatalCaught,
+    };
+}
+export function registerAll() {
+    registerWorkflow("entry-parity", parityWorkflow);
+}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "lightflow-engine",
+  "version": "0.1.0",
+  "description": "A tiny durable workflow engine for Node.js and Postgres: steps that run at most once, timers that survive crashes, streams that replay exactly once.",
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js",
+    "./pg": "./dist/pg-store.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "workflow",
+    "durable-execution",
+    "postgres",
+    "background-jobs",
+    "queue",
+    "temporal"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "node --test dist/test/smoke.js",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "pg": "^8.13.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/pg": "^8.11.0",
+    "typescript": "^5.6.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/thirdbase1/lightflow.git"
+  },
+  "bugs": {
+    "url": "https://github.com/thirdbase1/lightflow/issues"
+  },
+  "homepage": "https://github.com/thirdbase1/lightflow#readme"
+}