@iworkflow/temporal 0.8.0 → 0.9.0

package/README.md

@@ -14,7 +14,10 @@ Temporal для `@iworkflow/core`. Peer: `@temporalio/{client,common,worker,work
 - `temporalStep(fn)` — тест шага без воркера: `new MockActivityEnvironment().run(() => temporalStep(() => acts.send(x)))`;
   `acts` — сырые шаги (не результат `temporalActivities`), отказ остаётся `Failure`; `@temporalio/testing` ставит сам модуль.
 - `@iworkflow/temporal/workflow` — только для входа песочницы модуля:
-  `export const outreach = temporalFlow(flows.outreach, ["send-twice"])`.
+  `export const outreach = temporalFlow(flows.outreach, ["send-twice"])`. Внешний контракт по именам Temporal (соседи
+  шлют сигнал и query без порта): `temporalFlow(flow, { patches, signals: ["interviewFinished"], queries: ["link"] })`.
+  Новое имя в `signals` у процесса, который уже идёт, меняет переигрывание (сигнал, лежавший без обработчика, дойдёт до recv) —
+  добавлять вместе с первым кодом процесса или когда идущих нет.
 
 `opts` (`TemporalOptions`): `address`, `namespace`, `tls`, `apiKey` — источник токена, меняется каждые `apiKeyRenewMs`;
 `plugins` — плагины SDK воркерам и клиенту; `temporalClient({ lazy: true })` — соединение при первом вызове.

package/dist/workflow.d.ts

@@ -3,5 +3,15 @@ export declare const SIGNAL = "iwf.signal";
 export declare const QUERY = "iwf.query";
 /** Очередь пула шагов модуля; воркер пула поднимает temporalRuntime. */
 export declare const poolQueue: (app: string, pool: string) => string;
-/** patches — как AppDefinition.patches: необъявленный id — ошибка, как у DBOS. */
-export declare function temporalFlow(flow: Flow, patches?: string[]): (...args: unknown[]) => Promise<unknown>;
+export interface TemporalFlowOptions {
+    /** Как AppDefinition.patches: необъявленный id — ошибка, как у DBOS. */
+    patches?: string[];
+    /** Сигналы Temporal по имени (внешний контракт): тема X, значение recv — signalValue(аргументы). */
+    signals?: string[];
+    /** Query Temporal по имени: query X — setState(X); не публиковалось — null. */
+    queries?: string[];
+}
+/** Аргументы именованного сигнала — значение recv: нет или null — true (не спутать с null срока), несколько — массив. */
+export declare const signalValue: (a: unknown[]) => unknown;
+/** Второй аргумент — patches списком или TemporalFlowOptions. */
+export declare function temporalFlow(flow: Flow, opts?: string[] | TemporalFlowOptions): (...args: unknown[]) => Promise<unknown>;

package/dist/workflow.js

@@ -107,16 +107,34 @@ var childOptions = (app, args, opts) => ({
 var rethrow = (e) => {
   throw fromTemporal(e);
 };
-function temporalFlow(flow, patches = []) {
+var checkName = (name, seen) => {
+  if (!name.trim() || name !== name.trim() || name.startsWith("iwf.") || name.startsWith("__") || seen.has(name))
+    throw new Error(`имя "${name}" пустое, повторено или занято портом/Temporal`);
+  seen.add(name);
+  return name;
+};
+var signalValue = (a) => a.length === 0 || a.length === 1 && a[0] == null ? true : a.length === 1 ? a[0] : a;
+function temporalFlow(flow, opts = []) {
+  const { patches = [], signals = [], queries = [] } = Array.isArray(opts) ? { patches: opts } : opts;
+  const [sigSeen, qSeen] = [new Set, new Set];
+  const named = {
+    signals: signals.map((n) => [n, defineSignal(checkName(n, sigSeen))]),
+    queries: queries.map((n) => [n, defineQuery(checkName(n, qSeen))])
+  };
   return async (...args) => {
     const inbox = new Map;
     const state = new Map;
-    setHandler(signalDef, ({ topic, value }) => {
+    const push = (topic, value) => {
       const q = inbox.get(topic) ?? [];
       q.push(value);
       inbox.set(topic, q);
-    });
+    };
+    setHandler(signalDef, ({ topic, value }) => push(topic, value));
     setHandler(queryDef, (key) => state.get(key));
+    for (const [name, def] of named.signals)
+      setHandler(def, (...a) => push(name, signalValue(a)));
+    for (const [name, def] of named.queries)
+      setHandler(def, () => state.get(name) ?? null);
     const info = workflowInfo();
     const ctx = {
       workflowId: info.workflowId,
@@ -167,5 +185,6 @@ export {
   QUERY,
   SIGNAL,
   poolQueue,
+  signalValue,
   temporalFlow
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iworkflow/temporal",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "Temporal adapter for @iworkflow/core",
   "keywords": [
     "workflow",
@@ -41,7 +41,7 @@
     "prepack": "bun run build"
   },
   "dependencies": {
-    "@iworkflow/core": "^0.8.0"
+    "@iworkflow/core": "^0.9.0"
   },
   "peerDependencies": {
     "@temporalio/activity": "^1.24.0",

package/src/workflow.ts

@@ -1,5 +1,5 @@
 // Обёртка процесса для песочницы Temporal: FlowContext поверх proxyActivities и executeChild.
-// Сигналы и query — по одному обработчику на всё: тема и ключ едут в данных.
+// Сигналы и query порта — по одному обработчику (тема и ключ в данных); внешний контракт — по именам (signals/queries).
 // Импортируется только из входа песочницы модуля: `@iworkflow/temporal/workflow`.
 import {
   condition,
@@ -70,18 +70,49 @@ const rethrow = (e: unknown): never => {
   throw fromTemporal(e);
 };
 
-/** patches — как AppDefinition.patches: необъявленный id — ошибка, как у DBOS. */
-export function temporalFlow(flow: Flow, patches: string[] = []) {
+export interface TemporalFlowOptions {
+  /** Как AppDefinition.patches: необъявленный id — ошибка, как у DBOS. */
+  patches?: string[];
+  /** Сигналы Temporal по имени (внешний контракт): тема X, значение recv — signalValue(аргументы). */
+  signals?: string[];
+  /** Query Temporal по имени: query X — setState(X); не публиковалось — null. */
+  queries?: string[];
+}
+
+/** iwf.* — имена порта, __* — служебные Temporal: заняли бы чужой обработчик — отказ при объявлении. */
+const checkName = (name: string, seen: Set<string>) => {
+  if (!name.trim() || name !== name.trim() || name.startsWith("iwf.") || name.startsWith("__") || seen.has(name))
+    throw new Error(`имя "${name}" пустое, повторено или занято портом/Temporal`);
+  seen.add(name);
+  return name;
+};
+
+/** Аргументы именованного сигнала — значение recv: нет или null — true (не спутать с null срока), несколько — массив. */
+export const signalValue = (a: unknown[]): unknown => (a.length === 0 || (a.length === 1 && a[0] == null) ? true : a.length === 1 ? a[0] : a);
+
+/** Второй аргумент — patches списком или TemporalFlowOptions. */
+export function temporalFlow(flow: Flow, opts: string[] | TemporalFlowOptions = []) {
+  const { patches = [], signals = [], queries = [] } = Array.isArray(opts) ? { patches: opts } : opts;
+  // Имена сигналов и query — разные пространства Temporal: повтор ищется в каждом своём.
+  const [sigSeen, qSeen] = [new Set<string>(), new Set<string>()];
+  const named = {
+    signals: signals.map((n) => [n, defineSignal<unknown[]>(checkName(n, sigSeen))] as const),
+    queries: queries.map((n) => [n, defineQuery<unknown>(checkName(n, qSeen))] as const),
+  };
   return async (...args: unknown[]) => {
     // Буфер по темам: сигнал до recv ждёт в очереди, как в DBOS.
     const inbox = new Map<string, unknown[]>();
     const state = new Map<string, unknown>();
-    setHandler(signalDef, ({ topic, value }) => {
+    const push = (topic: string, value: unknown) => {
       const q = inbox.get(topic) ?? [];
       q.push(value);
       inbox.set(topic, q);
-    });
+    };
+    setHandler(signalDef, ({ topic, value }) => push(topic, value));
     setHandler(queryDef, (key) => state.get(key));
+    for (const [name, def] of named.signals)
+      setHandler(def, (...a: unknown[]) => push(name, signalValue(a)));
+    for (const [name, def] of named.queries) setHandler(def, () => state.get(name) ?? null);
 
     const info = workflowInfo();
     const ctx: FlowContext = {