@iworkflow/temporal 0.7.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/index.js

@@ -141,7 +141,15 @@ var wrap = (h, ready = async () => {}) => ({
 var TEMPORAL_STEP = {
   heartbeat: async (details) => Context.current().heartbeat(details),
   lastHeartbeat: async () => Context.current().info.heartbeatDetails,
-  attempt: () => Context.current().info.attempt
+  attempt: () => Context.current().info.attempt,
+  info: () => {
+    const { workflowExecution, activityId } = Context.current().info;
+    const { workflowId, runId } = workflowExecution ?? {};
+    if (!workflowId || !runId)
+      throw new Error("stepInfo: шаг вне процесса Temporal");
+    return { workflowId, runId, stepId: activityId };
+  },
+  signal: () => Context.current().cancellationSignal
 };
 var temporalStep = (fn) => stepScope(alsScope).run(TEMPORAL_STEP, fn);
 function temporalActivities(activities) {
@@ -284,7 +292,10 @@ async function temporalClient(opts = {}) {
       await ready();
       const h = await client.workflow.start(target.flow, {
         ...startOptions(target, args, o),
-        ...o.onExisting === "reject" ? { workflowIdConflictPolicy: "FAIL", workflowIdReusePolicy: "REJECT_DUPLICATE" } : { workflowIdConflictPolicy: "USE_EXISTING" }
+        ...o.onExisting === "reject" || o.reuseClosedId ? {
+          workflowIdConflictPolicy: "FAIL",
+          workflowIdReusePolicy: o.reuseClosedId ? "ALLOW_DUPLICATE" : "REJECT_DUPLICATE"
+        } : { workflowIdConflictPolicy: "USE_EXISTING" }
       }).catch((e) => {
         throw fromTemporal(e);
       });

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

@@ -6,6 +6,7 @@ import {
   deprecatePatch,
   executeChild,
   getExternalWorkflowHandle,
+  log,
   ParentClosePolicy,
   patched,
   proxyActivities,
@@ -15,7 +16,7 @@ import {
   TemporalFailure,
   workflowInfo
 } from "@temporalio/workflow";
-import { checkPriority, DEFAULT_PRIORITY, FlowError as FlowError2 } from "@iworkflow/core";
+import { checkPriority, DEFAULT_PRIORITY, FlowError as FlowError2, plainAttrs } from "@iworkflow/core";
 
 // src/failure.ts
 import {
@@ -106,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,
@@ -144,6 +163,7 @@ function temporalFlow(flow, patches = []) {
           throw e;
         throw new FlowError2(`процесса ${workflowId} нет или он завершён`, { reason: "not-found" });
       }),
+      log: async (level, message, attrs) => log[level](message, plainAttrs(attrs)),
       async setState(key, value) {
         state.set(key, value);
       },
@@ -165,5 +185,6 @@ export {
   QUERY,
   SIGNAL,
   poolQueue,
+  signalValue,
   temporalFlow
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iworkflow/temporal",
-  "version": "0.7.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.7.0"
+    "@iworkflow/core": "^0.9.0"
   },
   "peerDependencies": {
     "@temporalio/activity": "^1.24.0",

package/src/index.ts

@@ -78,6 +78,14 @@ const TEMPORAL_STEP: StepRuntime = {
   heartbeat: async (details) => Context.current().heartbeat(details),
   lastHeartbeat: async () => Context.current().info.heartbeatDetails,
   attempt: () => Context.current().info.attempt,
+  info: () => {
+    // Пустой id как ключ идемпотентности склеил бы записи разных процессов — отказ.
+    const { workflowExecution, activityId } = Context.current().info;
+    const { workflowId, runId } = workflowExecution ?? {};
+    if (!workflowId || !runId) throw new Error("stepInfo: шаг вне процесса Temporal");
+    return { workflowId, runId, stepId: activityId };
+  },
+  signal: () => Context.current().cancellationSignal,
 };
 
 /** Один вызов шага в рантайме Temporal без обёртки отказов — для тестов в MockActivityEnvironment. */
@@ -250,8 +258,11 @@ export async function temporalClient(opts: TemporalOptions & { lazy?: boolean }
       const h = await client.workflow
         .start(target.flow, {
           ...startOptions(target, args, o),
-          ...(o.onExisting === "reject"
-            ? { workflowIdConflictPolicy: "FAIL" as const, workflowIdReusePolicy: "REJECT_DUPLICATE" as const }
+          ...(o.onExisting === "reject" || o.reuseClosedId
+            ? {
+                workflowIdConflictPolicy: "FAIL" as const,
+                workflowIdReusePolicy: o.reuseClosedId ? ("ALLOW_DUPLICATE" as const) : ("REJECT_DUPLICATE" as const),
+              }
             : { workflowIdConflictPolicy: "USE_EXISTING" as const }),
         })
         .catch((e) => {

package/src/workflow.ts

@@ -1,5 +1,5 @@
 // Обёртка процесса для песочницы Temporal: FlowContext поверх proxyActivities и executeChild.
-// Сигналы и query — по одному обработчику на всё: тема и ключ едут в данных.
+// Сигналы и query порта — по одному обработчику (тема и ключ в данных); внешний контракт — по именам (signals/queries).
 // Импортируется только из входа песочницы модуля: `@iworkflow/temporal/workflow`.
 import {
   condition,
@@ -8,6 +8,7 @@ import {
   deprecatePatch,
   executeChild,
   getExternalWorkflowHandle,
+  log,
   ParentClosePolicy,
   patched,
   proxyActivities,
@@ -18,7 +19,7 @@ import {
   workflowInfo,
 } from "@temporalio/workflow";
 
-import { checkPriority, DEFAULT_PRIORITY, FlowError, type ChildOptions, type Flow, type FlowContext, type StepOptions } from "@iworkflow/core";
+import { checkPriority, DEFAULT_PRIORITY, FlowError, plainAttrs, type ChildOptions, type Flow, type FlowContext, type StepOptions } from "@iworkflow/core";
 import { fromTemporal, toTemporal } from "./failure";
 
 export const SIGNAL = "iwf.signal";
@@ -69,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 = {
@@ -105,6 +137,7 @@ export function temporalFlow(flow: Flow, patches: string[] = []) {
       },
       sleep: (ms) => sleep(ms),
       async recv<T>(topic: string, timeoutMs: number) {
+        // 0 и меньше — таймер 1 мс (так было и до 0.8): отдаёт активацию, цикл опроса не виснет.
         const ready = await condition(() => (inbox.get(topic)?.length ?? 0) > 0, timeoutMs);
         return ready ? (inbox.get(topic)!.shift() as T) : null;
       },
@@ -115,6 +148,9 @@ export function temporalFlow(flow: Flow, patches: string[] = []) {
             if (!(e instanceof TemporalFailure)) throw e;
             throw new FlowError(`процесса ${workflowId} нет или он завершён`, { reason: "not-found" });
           }),
+      // log песочницы молчит при переигрывании.
+      // Неклонируемые attrs (функция, BigInt) уронили бы активацию при отправке из песочницы.
+      log: async (level, message, attrs) => log[level](message, plainAttrs(attrs)),
       async setState(key, value) {
         state.set(key, value);
       },