@iworkflow/core 0.6.0 → 0.7.0

package/README.md

@@ -33,8 +33,8 @@ try {
 }
 ```
 
-Ещё: `ctx.startChild` (без ожидания), `ChildOptions.timeoutMs` и `onExisting`, `ctx.startedAt`,
-`ctx.parentId`, `AppDefinition.pools`, `handle.describe()` и `handle.terminate()`.
+Ещё: `ctx.startChild` (без ожидания, `reuseClosedId`), `ChildOptions.timeoutMs` и `onExisting`, `ctx.startedAt`,
+`ctx.parentId`, `AppDefinition.pools` и `maxConcurrentSteps`, `StartOptions.onExisting`, `handle.describe()` и `handle.terminate()`.
 
 Приоритет: `client.start(..., { priority })` (1 — первым, 5 — последним) → `ctx.priority`; шаги и
 дети его наследуют, `StepOptions.priority` — свой. Срок повтора из отказа: `new Failure(msg, { type,

package/dist/errors.d.ts

@@ -1,3 +1,4 @@
+import type { AppDefinition } from "./types";
 /**
  * Отказ, который бросает код шага или процесса. `type` — код для разбора (`FlowError.type`),
  * `nonRetryable` — шаг не повторять. Отказ процесса не повторяется никогда.
@@ -47,3 +48,5 @@ export declare const isFlowError: (e: unknown) => e is FlowError;
 /** Приоритет порта — целое 1…5 (1 — первым); иное отвергается одинаково на обоих движках. */
 export declare function checkPriority(p: number | undefined): number | undefined;
 export declare const DEFAULT_PRIORITY = 3;
+/** Пределы модуля — целые ≥ 1: иначе DBOS молча вешает шаги, а Temporal падает на старте. */
+export declare function checkLimits(def: AppDefinition): void;

package/dist/index.js

@@ -55,6 +55,15 @@ function checkPriority(p) {
   return p;
 }
 var DEFAULT_PRIORITY = 3;
+function checkLimits(def) {
+  const check = (name, n) => {
+    if (n !== undefined && (!Number.isInteger(n) || n < 1))
+      throw new Error(`${def.app}: ${name} = ${n}, нужно целое ≥ 1`);
+  };
+  check("maxConcurrentSteps", def.maxConcurrentSteps);
+  for (const [p, n] of Object.entries(def.pools ?? {}))
+    check(`pools.${p}`, n);
+}
 // src/exit.ts
 function exitSignal() {
   let d = Promise.withResolvers();
@@ -83,6 +92,7 @@ export {
   DEFAULT_PRIORITY,
   Failure,
   FlowError,
+  checkLimits,
   checkPriority,
   exitSignal,
   heartbeat,

package/dist/types.d.ts

@@ -34,6 +34,13 @@ export interface ChildOptions {
      */
     onExisting?: "reject";
 }
+export interface StartChildOptions extends Omit<ChildOptions, "onExisting"> {
+    /**
+     * Id завершённого процесса — новый запуск под ним (окно сбора на чат). Только Temporal: DBOS id не
+     * переиспользует — already-started. Идущий процесс с этим id — already-started всегда.
+     */
+    reuseClosedId?: boolean;
+}
 /** Дочерний процесс, запущенный без ожидания. */
 export interface ChildHandle<T> {
     id: string;
@@ -58,7 +65,7 @@ export interface FlowContext {
      * Дочерний процесс без ожидания: живёт и после завершения родителя. Id уже идёт или занят —
      * FlowError reason "already-started".
      */
-    startChild<T>(target: FlowRef, args: unknown[], opts: Omit<ChildOptions, "onExisting">): Promise<ChildHandle<T>>;
+    startChild<T>(target: FlowRef, args: unknown[], opts: StartChildOptions): Promise<ChildHandle<T>>;
     sleep(ms: number): Promise<void>;
     /** Ждать сигнал по теме; null — вышло время. Сигнал, пришедший раньше, не теряется. */
     recv<T>(topic: string, timeoutMs: number): Promise<T | null>;
@@ -92,6 +99,8 @@ export interface AppDefinition {
     patches?: string[];
     /** Пулы шагов: имя → сколько шагов пула идёт одновременно в этом процессе. */
     pools?: Record<string, number>;
+    /** Сколько шагов вне пулов идёт одновременно в этом процессе (бережёт пул БД). Не задано — у DBOS без предела, у Temporal 100. */
+    maxConcurrentSteps?: number;
 }
 export type FlowStatus = "running" | "completed" | "failed" | "terminated" | "timed-out";
 export interface FlowDescription {
@@ -124,16 +133,18 @@ export interface StartOptions {
     timeoutMs?: number;
     /** 1 — первым, 5 — последним; шаги процесса наследуют его. */
     priority?: number;
+    /** Id уже занят (идёт или завершён; Temporal помнит завершённый в пределах хранения namespace) — FlowError "already-started". */
+    onExisting?: "reject";
 }
 /** Сторона вызывающего вне процесса (HTTP, CLI, тест). */
 export interface EngineClient {
-    /** Id уже идёт — handle к нему. timeoutMs — срок процесса. */
+    /** Id уже идёт — handle к нему (с onExisting "reject" — already-started). timeoutMs — срок процесса. */
     start<T>(target: FlowRef, args: unknown[], opts: StartOptions): Promise<FlowHandle<T>>;
     /**
      * Сигнал процессу; нет идущего с этим id — запустить и отдать сигнал ему. Temporal заводит новый
      * запуск и под id завершённого; DBOS id не переиспользует — сигнал уйдёт завершённому и пропадёт.
      */
-    signalWithStart<T>(target: FlowRef, args: unknown[], opts: StartOptions, topic: string, value: unknown): Promise<FlowHandle<T>>;
+    signalWithStart<T>(target: FlowRef, args: unknown[], opts: Omit<StartOptions, "onExisting">, topic: string, value: unknown): Promise<FlowHandle<T>>;
     /** Уже запущенный процесс по id. */
     handle<T>(id: string): FlowHandle<T>;
     close(): Promise<void>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iworkflow/core",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "Engine-neutral durable workflow port: flows, steps, child workflows, signals, queries, patches, heartbeat",
   "keywords": [
     "workflow",

package/src/errors.ts

@@ -1,4 +1,5 @@
 // Ошибки порта: одинаковые на обоих движках. Без импортов рантайма — их читает песочница Temporal.
+import type { AppDefinition } from "./types";
 
 /**
  * Отказ, который бросает код шага или процесса. `type` — код для разбора (`FlowError.type`),
@@ -75,3 +76,12 @@ export function checkPriority(p: number | undefined): number | undefined {
 }
 
 export const DEFAULT_PRIORITY = 3;
+
+/** Пределы модуля — целые ≥ 1: иначе DBOS молча вешает шаги, а Temporal падает на старте. */
+export function checkLimits(def: AppDefinition): void {
+  const check = (name: string, n: number | undefined) => {
+    if (n !== undefined && (!Number.isInteger(n) || n < 1)) throw new Error(`${def.app}: ${name} = ${n}, нужно целое ≥ 1`);
+  };
+  check("maxConcurrentSteps", def.maxConcurrentSteps);
+  for (const [p, n] of Object.entries(def.pools ?? {})) check(`pools.${p}`, n);
+}

package/src/types.ts

@@ -40,6 +40,14 @@ export interface ChildOptions {
   onExisting?: "reject";
 }
 
+export interface StartChildOptions extends Omit<ChildOptions, "onExisting"> {
+  /**
+   * Id завершённого процесса — новый запуск под ним (окно сбора на чат). Только Temporal: DBOS id не
+   * переиспользует — already-started. Идущий процесс с этим id — already-started всегда.
+   */
+  reuseClosedId?: boolean;
+}
+
 /** Дочерний процесс, запущенный без ожидания. */
 export interface ChildHandle<T> {
   id: string;
@@ -65,7 +73,7 @@ export interface FlowContext {
    * Дочерний процесс без ожидания: живёт и после завершения родителя. Id уже идёт или занят —
    * FlowError reason "already-started".
    */
-  startChild<T>(target: FlowRef, args: unknown[], opts: Omit<ChildOptions, "onExisting">): Promise<ChildHandle<T>>;
+  startChild<T>(target: FlowRef, args: unknown[], opts: StartChildOptions): Promise<ChildHandle<T>>;
   sleep(ms: number): Promise<void>;
   /** Ждать сигнал по теме; null — вышло время. Сигнал, пришедший раньше, не теряется. */
   recv<T>(topic: string, timeoutMs: number): Promise<T | null>;
@@ -102,6 +110,8 @@ export interface AppDefinition {
   patches?: string[];
   /** Пулы шагов: имя → сколько шагов пула идёт одновременно в этом процессе. */
   pools?: Record<string, number>;
+  /** Сколько шагов вне пулов идёт одновременно в этом процессе (бережёт пул БД). Не задано — у DBOS без предела, у Temporal 100. */
+  maxConcurrentSteps?: number;
 }
 
 export type FlowStatus = "running" | "completed" | "failed" | "terminated" | "timed-out";
@@ -139,17 +149,19 @@ export interface StartOptions {
   timeoutMs?: number;
   /** 1 — первым, 5 — последним; шаги процесса наследуют его. */
   priority?: number;
+  /** Id уже занят (идёт или завершён; Temporal помнит завершённый в пределах хранения namespace) — FlowError "already-started". */
+  onExisting?: "reject";
 }
 
 /** Сторона вызывающего вне процесса (HTTP, CLI, тест). */
 export interface EngineClient {
-  /** Id уже идёт — handle к нему. timeoutMs — срок процесса. */
+  /** Id уже идёт — handle к нему (с onExisting "reject" — already-started). timeoutMs — срок процесса. */
   start<T>(target: FlowRef, args: unknown[], opts: StartOptions): Promise<FlowHandle<T>>;
   /**
    * Сигнал процессу; нет идущего с этим id — запустить и отдать сигнал ему. Temporal заводит новый
    * запуск и под id завершённого; DBOS id не переиспользует — сигнал уйдёт завершённому и пропадёт.
    */
-  signalWithStart<T>(target: FlowRef, args: unknown[], opts: StartOptions, topic: string, value: unknown): Promise<FlowHandle<T>>;
+  signalWithStart<T>(target: FlowRef, args: unknown[], opts: Omit<StartOptions, "onExisting">, topic: string, value: unknown): Promise<FlowHandle<T>>;
   /** Уже запущенный процесс по id. */
   handle<T>(id: string): FlowHandle<T>;
   close(): Promise<void>;