@iworkflow/dbos 0.4.0 → 0.6.0

package/dist/index.js

@@ -1,13 +1,24 @@
 // src/index.ts
 import { DBOS, DBOSClient, Error as DBOSErrors } from "@dbos-inc/dbos-sdk";
 import {
-  bindStepRuntime,
+  stepScope,
+  checkPriority,
+  DEFAULT_PRIORITY,
   exitSignal,
   Failure,
   FlowError,
   isFlowError
 } from "@iworkflow/core";
 import { Pool } from "pg";
+
+// src/scope.ts
+import { AsyncLocalStorage } from "node:async_hooks";
+var alsScope = () => {
+  const als = new AsyncLocalStorage;
+  return { run: (rt, fn) => als.run(rt, fn), current: () => als.getStore() };
+};
+
+// src/index.ts
 var resultPoll = () => ({ pollingIntervalMs: Number(process.env.DBOS_RESULT_POLL_MS) || undefined });
 var sysDb = () => process.env.DBOS_SYSTEM_DATABASE_URL ?? "postgres://iworkflow:iworkflow@localhost:55432/iworkflow";
 var HEARTBEAT_DDL = [
@@ -93,17 +104,20 @@ class Semaphore {
   constructor(free) {
     this.free = free;
   }
-  async run(fn) {
+  async run(fn, priority = DEFAULT_PRIORITY) {
     if (this.free > 0)
       this.free--;
     else
-      await new Promise((r) => this.queue.push(r));
+      await new Promise((go) => {
+        const i = this.queue.findIndex((w) => w.priority > priority);
+        this.queue.splice(i < 0 ? this.queue.length : i, 0, { priority, go });
+      });
     try {
       return await fn();
     } finally {
       const next = this.queue.shift();
       if (next)
-        next();
+        next.go();
       else
         this.free++;
     }
@@ -113,6 +127,7 @@ class Semaphore {
 class AttemptTimeout extends Error {
 }
 var sleepMs = (ms) => new Promise((r) => setTimeout(r, ms));
+var scope = stepScope(alsScope);
 async function withTimeout(p, ms) {
   let timer;
   try {
@@ -124,14 +139,14 @@ async function withTimeout(p, ms) {
     clearTimeout(timer);
   }
 }
-async function attempts(fn, args, opts, pool, alive) {
+async function attempts(fn, args, opts, pool, alive, priority, runtime) {
   const max = opts.attempts ?? 3;
   const started = Date.now();
   let interval = opts.retryIntervalMs ?? 200;
   for (let n = 1;; n++) {
     try {
-      const attempt = () => withTimeout(fn(...args), opts.timeoutMs ?? 60000);
-      return await (pool ? pool.run(attempt) : attempt());
+      const attempt = () => scope.run(runtime(n), () => withTimeout(fn(...args), opts.timeoutMs ?? 60000));
+      return await (pool ? pool.run(attempt, priority) : attempt());
     } catch (e) {
       const stop = e instanceof Failure && e.nonRetryable || (opts.nonRetryableTypes ?? []).includes(typeOf(e));
       if (stop || n >= max) {
@@ -145,15 +160,20 @@ async function attempts(fn, args, opts, pool, alive) {
           exhausted
         });
       }
-      if (opts.totalTimeoutMs !== undefined && Date.now() - started + interval >= opts.totalTimeoutMs)
+      const wait = e instanceof Failure && e.retryAfterMs !== undefined ? e.retryAfterMs : interval;
+      if (opts.totalTimeoutMs !== undefined && Date.now() - started + wait >= opts.totalTimeoutMs)
         throw new FlowError(e instanceof Error ? e.message : String(e), {
           reason: "timeout",
           type: typeOf(e),
           details: e instanceof Failure ? e.details : undefined
         });
-      await sleepMs(interval);
-      if (!await alive().catch(() => true))
-        throw new FlowError("процесс прерван — повторы шага остановлены", { reason: "terminated" });
+      let left = wait;
+      do {
+        await sleepMs(Math.min(Math.max(left, 0), 5000));
+        if (!await alive().catch(() => true))
+          throw new FlowError("процесс прерван — повторы шага остановлены", { reason: "terminated" });
+        left -= 5000;
+      } while (left > 0);
       interval = Math.min(interval * (opts.backoff ?? 1), opts.maxRetryIntervalMs ?? Infinity);
     }
   }
@@ -172,7 +192,7 @@ function dbosRuntime() {
     pool = new Pool({ connectionString: sysDb(), max: 2 });
     const db = pool;
     const patches = patchBook(db, def.app, def.patches ?? []);
-    bindStepRuntime({
+    const stepRuntime = (n) => ({
       async heartbeat(details) {
         await db.query(`INSERT INTO iwf.heartbeat (workflow_id, step_id, details) VALUES ($1, $2, $3)
            ON CONFLICT (workflow_id, step_id) DO UPDATE SET details = EXCLUDED.details, at = now()`, [...stepKey(), JSON.stringify(details ?? null)]);
@@ -180,16 +200,18 @@ function dbosRuntime() {
       async lastHeartbeat() {
         const r = await db.query("SELECT details FROM iwf.heartbeat WHERE workflow_id = $1 AND step_id = $2", stepKey());
         return r.rows[0]?.details ?? undefined;
-      }
+      },
+      attempt: () => n
     });
     const pools = Object.fromEntries(Object.entries(def.pools ?? {}).map(([p, n]) => [p, new Semaphore(n)]));
-    const enqueue = (target, args, opts, reject) => DBOS.enqueueWorkflowWithOptions({
+    const enqueue = (target, args, opts, reject, priority) => DBOS.enqueueWorkflowWithOptions({
       queueName: target.app,
       workflowName: target.flow,
       workflowID: opts.id,
       applicationName: target.app,
       ...opts.timeoutMs ? { workflowTimeoutMS: opts.timeoutMs } : {},
-      ...reject ? { workflowIDReusePolicy: "reject" } : {}
+      ...reject ? { workflowIDReusePolicy: "reject" } : {},
+      priority: priority ?? DEFAULT_PRIORITY
     }, ...args).catch(alreadyStarted(opts.id));
     const waitChild = async (h, id) => {
       try {
@@ -202,13 +224,15 @@ function dbosRuntime() {
       const run = async (...args) => {
         const workflowId = DBOS.workflowID;
         await patches.born(workflowId);
-        const row = (await db.query("SELECT created_at, parent_workflow_id FROM dbos.workflow_status WHERE workflow_uuid = $1", [
+        const row = (await db.query("SELECT created_at, parent_workflow_id, priority FROM dbos.workflow_status WHERE workflow_uuid = $1", [
           workflowId
         ])).rows[0];
         const ctx = {
           workflowId,
           parentId: row?.parent_workflow_id ?? undefined,
           startedAt: new Date(Number(row?.created_at)),
+          priority: row?.priority || DEFAULT_PRIORITY,
+          now: () => DBOS.now(),
           step: (step, stepArgs, opts = {}) => {
             const pool = opts.pool ? pools[opts.pool] : undefined;
             if (opts.pool && !pool)
@@ -225,16 +249,16 @@ function dbosRuntime() {
                 await sleepMs(100);
               }
             };
-            return DBOS.runStep(() => attempts(def.activities[step], stepArgs, opts, pool, alive), {
+            return DBOS.runStep(() => attempts(def.activities[step], stepArgs, opts, pool, alive, checkPriority(opts.priority) ?? ctx.priority, stepRuntime), {
               name: step,
               retriesAllowed: false
             }).catch((e) => {
               throw revive(e);
             });
           },
-          child: async (target, childArgs, opts) => waitChild(await enqueue(target, childArgs, opts, opts.onExisting === "reject"), opts.id),
+          child: async (target, childArgs, opts) => waitChild(await enqueue(target, childArgs, opts, opts.onExisting === "reject", ctx.priority), opts.id),
           async startChild(target, childArgs, opts) {
-            const h = await enqueue(target, childArgs, opts, true);
+            const h = await enqueue(target, childArgs, opts, true, ctx.priority);
             return { id: opts.id, result: () => waitChild(h, opts.id) };
           },
           sleep: (ms) => DBOS.sleep(ms),
@@ -311,20 +335,29 @@ async function dbosClient() {
       await client.cancelWorkflow(id);
     }
   });
-  return {
+  const self = {
     async start(target, args, opts) {
       const h = await client.enqueue({
         queueName: target.app,
         workflowName: target.flow,
         workflowID: opts.id,
         applicationName: target.app,
-        ...opts.timeoutMs ? { workflowTimeoutMS: opts.timeoutMs } : {}
+        ...opts.timeoutMs ? { workflowTimeoutMS: opts.timeoutMs } : {},
+        priority: checkPriority(opts.priority) ?? DEFAULT_PRIORITY
       }, ...args);
       return wrap(h.workflowID);
     },
+    async signalWithStart(target, args, opts, topic, value) {
+      const h = await self.start(target, args, opts);
+      if (FINISHED.has((await status(h.id))?.status ?? ""))
+        throw new FlowError(`процесс ${h.id} уже завершён — id не переиспользуется`, { reason: "already-started" });
+      await client.send(h.id, value, topic);
+      return h;
+    },
     handle: (id) => wrap(id),
     close: () => client.destroy()
   };
+  return self;
 }
 export {
   dbosClient,

package/dist/scope.d.ts

@@ -0,0 +1,2 @@
+import type { StepScope } from "@iworkflow/core";
+export declare const alsScope: () => StepScope;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iworkflow/dbos",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "description": "DBOS adapter for @iworkflow/core",
   "keywords": [
     "workflow",
@@ -37,7 +37,7 @@
     "prepack": "bun run build"
   },
   "dependencies": {
-    "@iworkflow/core": "^0.4.0",
+    "@iworkflow/core": "^0.6.0",
     "pg": "^8.0.0"
   },
   "peerDependencies": {

package/src/index.ts

@@ -2,7 +2,10 @@
 // Дочерний процесс в чужом модуле — enqueueWorkflowWithOptions по имени, без ссылки на функцию.
 import { DBOS, DBOSClient, Error as DBOSErrors, type WorkflowStatus } from "@dbos-inc/dbos-sdk";
 import {
-  bindStepRuntime,
+  stepScope,
+  type StepRuntime,
+  checkPriority,
+  DEFAULT_PRIORITY,
   exitSignal,
   Failure,
   FlowError,
@@ -14,10 +17,13 @@ import {
   type EngineRuntime,
   type FlowContext,
   type FlowHandle,
+  type FlowRef,
   type FlowStatus,
+  type StartOptions,
   type StepOptions,
 } from "@iworkflow/core";
 import { Pool } from "pg";
+import { alsScope } from "./scope";
 
 // Ожидание результата дочернего процесса — опрос базы, по умолчанию раз в секунду: это и есть
 // задержка каждого перехода между модулями. DBOS_RESULT_POLL_MS уменьшает её ценой запросов к базе.
@@ -135,17 +141,22 @@ const alreadyStarted = (id: string) => (e: unknown): never => {
 // Повторы — свои, внутри одного шага DBOS: в историю пишется уже FlowError с причиной, как у Temporal.
 // Цена: отмена процесса не прерывает повторы шага, а ждёт его конца.
 
+/** Предел одновременных шагов пула; ждущие выходят по приоритету (1 — первым), внутри — по очереди. */
 class Semaphore {
-  private queue: (() => void)[] = [];
+  private queue: { priority: number; go: () => void }[] = [];
   constructor(private free: number) {}
-  async run<T>(fn: () => Promise<T>): Promise<T> {
+  async run<T>(fn: () => Promise<T>, priority = DEFAULT_PRIORITY): Promise<T> {
     if (this.free > 0) this.free--;
-    else await new Promise<void>((r) => this.queue.push(r));
+    else
+      await new Promise<void>((go) => {
+        const i = this.queue.findIndex((w) => w.priority > priority);
+        this.queue.splice(i < 0 ? this.queue.length : i, 0, { priority, go });
+      });
     try {
       return await fn();
     } finally {
       const next = this.queue.shift();
-      if (next) next();
+      if (next) next.go();
       else this.free++;
     }
   }
@@ -155,6 +166,8 @@ class AttemptTimeout extends Error {}
 
 const sleepMs = (ms: number) => new Promise((r) => setTimeout(r, ms));
 
+const scope = stepScope(alsScope);
+
 /** Попытка, урезанная по сроку: брошенная продолжает идти в фоне, её итог отбрасывается. */
 async function withTimeout<T>(p: Promise<T>, ms: number): Promise<T> {
   let timer: ReturnType<typeof setTimeout> | undefined;
@@ -175,14 +188,16 @@ async function attempts(
   opts: StepOptions,
   pool: Semaphore | undefined,
   alive: () => Promise<boolean>,
+  priority: number | undefined,
+  runtime: (n: number) => StepRuntime,
 ) {
   const max = opts.attempts ?? 3;
   const started = Date.now();
   let interval = opts.retryIntervalMs ?? 200;
   for (let n = 1; ; n++) {
     try {
-      const attempt = () => withTimeout(fn(...args), opts.timeoutMs ?? 60_000);
-      return await (pool ? pool.run(attempt) : attempt());
+      const attempt = () => scope.run(runtime(n), () => withTimeout(fn(...args), opts.timeoutMs ?? 60_000));
+      return await (pool ? pool.run(attempt, priority) : attempt());
     } catch (e) {
       const stop = (e instanceof Failure && e.nonRetryable) || (opts.nonRetryableTypes ?? []).includes(typeOf(e));
       if (stop || n >= max) {
@@ -195,16 +210,24 @@ async function attempts(
           exhausted,
         });
       }
-      if (opts.totalTimeoutMs !== undefined && Date.now() - started + interval >= opts.totalTimeoutMs)
+      // Отказ сам назвал срок (FLOOD_WAIT) — ждём его, а не паузу из opts.
+      const wait = e instanceof Failure && e.retryAfterMs !== undefined ? e.retryAfterMs : interval;
+      if (opts.totalTimeoutMs !== undefined && Date.now() - started + wait >= opts.totalTimeoutMs)
         throw new FlowError(e instanceof Error ? e.message : String(e), {
           reason: "timeout",
           type: typeOf(e),
           details: e instanceof Failure ? e.details : undefined,
         });
-      await sleepMs(interval);
-      // После паузы: за неё процесс мог выйти по сроку или быть отменён.
+      // Пауза кусками: срок или отмена процесса видны не позже чем через 5 с, а не после всей паузы.
       // Сбой чтения статуса — не повод бросать шаг: повторяем дальше.
-      if (!(await alive().catch(() => true))) throw new FlowError("процесс прерван — повторы шага остановлены", { reason: "terminated" });
+      // do…while: и при нулевой паузе статус процесса проверяется перед каждой попыткой.
+      let left = wait;
+      do {
+        await sleepMs(Math.min(Math.max(left, 0), 5_000));
+        if (!(await alive().catch(() => true)))
+          throw new FlowError("процесс прерван — повторы шага остановлены", { reason: "terminated" });
+        left -= 5_000;
+      } while (left > 0);
       interval = Math.min(interval * (opts.backoff ?? 1), opts.maxRetryIntervalMs ?? Infinity);
     }
   }
@@ -229,7 +252,8 @@ export function dbosRuntime(): EngineRuntime {
     pool = new Pool({ connectionString: sysDb(), max: 2 });
     const db = pool;
     const patches = patchBook(db, def.app, def.patches ?? []);
-    bindStepRuntime({
+    // Рантайм попытки шага: прогресс — в iwf.heartbeat по (процесс, шаг), номер — из цикла повторов.
+    const stepRuntime = (n: number): StepRuntime => ({
       async heartbeat(details) {
         await db.query(
           `INSERT INTO iwf.heartbeat (workflow_id, step_id, details) VALUES ($1, $2, $3)
@@ -241,9 +265,16 @@ export function dbosRuntime(): EngineRuntime {
         const r = await db.query("SELECT details FROM iwf.heartbeat WHERE workflow_id = $1 AND step_id = $2", stepKey());
         return r.rows[0]?.details ?? undefined;
       },
+      attempt: () => n,
     });
     const pools = Object.fromEntries(Object.entries(def.pools ?? {}).map(([p, n]) => [p, new Semaphore(n)]));
-    const enqueue = (target: { app: string; flow: string }, args: unknown[], opts: ChildOptions, reject: boolean) =>
+    const enqueue = (
+      target: { app: string; flow: string },
+      args: unknown[],
+      opts: ChildOptions,
+      reject: boolean,
+      priority: number | undefined,
+    ) =>
       DBOS.enqueueWorkflowWithOptions(
         {
           queueName: target.app,
@@ -252,6 +283,8 @@ export function dbosRuntime(): EngineRuntime {
           applicationName: target.app,
           ...(opts.timeoutMs ? { workflowTimeoutMS: opts.timeoutMs } : {}),
           ...(reject ? { workflowIDReusePolicy: "reject" as const } : {}),
+          // Ребёнок наследует приоритет родителя, как у Temporal.
+          priority: priority ?? DEFAULT_PRIORITY,
         },
         ...args,
       ).catch(alreadyStarted(opts.id));
@@ -268,7 +301,7 @@ export function dbosRuntime(): EngineRuntime {
         await patches.born(workflowId);
         // Строка статуса не меняется после создания: чтение вне шага детерминировано.
         const row = (
-          await db.query("SELECT created_at, parent_workflow_id FROM dbos.workflow_status WHERE workflow_uuid = $1", [
+          await db.query("SELECT created_at, parent_workflow_id, priority FROM dbos.workflow_status WHERE workflow_uuid = $1", [
             workflowId,
           ])
         ).rows[0];
@@ -276,6 +309,8 @@ export function dbosRuntime(): EngineRuntime {
           workflowId,
           parentId: row?.parent_workflow_id ?? undefined,
           startedAt: new Date(Number(row?.created_at)),
+          priority: row?.priority || DEFAULT_PRIORITY,
+          now: () => DBOS.now(),
           step: (step, stepArgs, opts = {}) => {
             const pool = opts.pool ? pools[opts.pool] : undefined;
             if (opts.pool && !pool) throw new Error(`пул "${opts.pool}" не объявлен в AppDefinition.pools модуля ${def.app}`);
@@ -296,7 +331,7 @@ export function dbosRuntime(): EngineRuntime {
                 await sleepMs(100);
               }
             };
-            return DBOS.runStep(() => attempts(def.activities[step]!, stepArgs, opts, pool, alive), {
+            return DBOS.runStep(() => attempts(def.activities[step]!, stepArgs, opts, pool, alive, checkPriority(opts.priority) ?? ctx.priority, stepRuntime), {
               name: step,
               retriesAllowed: false,
             }).catch((e) => {
@@ -304,10 +339,10 @@ export function dbosRuntime(): EngineRuntime {
             }) as Promise<never>;
           },
           child: async (target, childArgs, opts) =>
-            waitChild(await enqueue(target, childArgs, opts, opts.onExisting === "reject"), opts.id),
+            waitChild(await enqueue(target, childArgs, opts, opts.onExisting === "reject", ctx.priority), opts.id),
           async startChild(target, childArgs, opts) {
             // Процесс DBOS не привязан к родителю: живёт сам, как ABANDON у Temporal.
-            const h = await enqueue(target, childArgs, opts, true);
+            const h = await enqueue(target, childArgs, opts, true, ctx.priority);
             return { id: opts.id, result: () => waitChild(h, opts.id) };
           },
           sleep: (ms) => DBOS.sleep(ms),
@@ -398,7 +433,7 @@ export async function dbosClient(): Promise<EngineClient> {
       await client.cancelWorkflow(id);
     },
   });
-  return {
+  const self: EngineClient = {
     async start(target, args, opts) {
       const h = await client.enqueue(
         {
@@ -407,12 +442,24 @@ export async function dbosClient(): Promise<EngineClient> {
           workflowID: opts.id,
           applicationName: target.app,
           ...(opts.timeoutMs ? { workflowTimeoutMS: opts.timeoutMs } : {}),
+          // Без приоритета DBOS ставит 0 — впереди всех; порт по умолчанию 3, как Temporal.
+          priority: checkPriority(opts.priority) ?? DEFAULT_PRIORITY,
         },
         ...args,
       );
       return wrap(h.workflowID);
     },
+    async signalWithStart<T>(target: FlowRef, args: unknown[], opts: StartOptions, topic: string, value: unknown) {
+      // Не атомарно, но без потерь: сигнал ждёт в очереди темы, пока процесс до него дойдёт.
+      const h = await self.start<T>(target, args, opts);
+      // id завершённого DBOS не переиспользует: сигнал ушёл бы в никуда.
+      if (FINISHED.has((await status(h.id))?.status ?? ""))
+        throw new FlowError(`процесс ${h.id} уже завершён — id не переиспользуется`, { reason: "already-started" });
+      await client.send(h.id, value, topic);
+      return h;
+    },
     handle: (id) => wrap(id),
     close: () => client.destroy(),
   };
+  return self;
 }

package/src/scope.ts

@@ -0,0 +1,8 @@
+// Область шага на AsyncLocalStorage: stepScope ядра берёт её у первого адаптера процесса.
+import { AsyncLocalStorage } from "node:async_hooks";
+import type { StepRuntime, StepScope } from "@iworkflow/core";
+
+export const alsScope = (): StepScope => {
+  const als = new AsyncLocalStorage<StepRuntime>();
+  return { run: (rt, fn) => als.run(rt, fn), current: () => als.getStore() };
+};