@lunora/workflow 1.0.0-alpha.4 → 1.0.0-alpha.5

package/dist/do/index.d.mts

@@ -1,5 +1,5 @@
 import { WorkflowEntrypoint, WorkflowEvent, WorkflowStep } from 'cloudflare:workers';
-import { W as WorkflowDefinition } from "../packem_shared/types.d-Fdeu2P2C.mjs";
+import { W as WorkflowDefinition } from "../packem_shared/types.d-C9W6rEWv.mjs";
 import '@lunora/values';
 /**
 * Base class for the generated `WorkflowEntrypoint` classes. Applies a

package/dist/do/index.d.ts

@@ -1,5 +1,5 @@
 import { WorkflowEntrypoint, WorkflowEvent, WorkflowStep } from 'cloudflare:workers';
-import { W as WorkflowDefinition } from "../packem_shared/types.d-Fdeu2P2C.js";
+import { W as WorkflowDefinition } from "../packem_shared/types.d-C9W6rEWv.js";
 import '@lunora/values';
 /**
 * Base class for the generated `WorkflowEntrypoint` classes. Applies a

package/dist/do/index.mjs

@@ -1,8 +1,8 @@
 import { WorkflowEntrypoint } from 'cloudflare:workers';
 import { NonRetryableError } from 'cloudflare:workflows';
 import { convertNonRetryableError } from '../packem_shared/NonRetryableError-Dn2dTyBS.mjs';
-import { stripBranchMarker, signalBranchParent, extractBranchMarker, errorOutcome, okOutcome } from '../packem_shared/MAX_BRANCHES-C9MJIFii.mjs';
-import { createWorkflowRunContext } from '../packem_shared/createWorkflowRunContext-BsMyGuMR.mjs';
+import { stripBranchMarker, signalBranchParent, extractBranchMarker, errorOutcome, okOutcome } from '../packem_shared/MAX_BRANCHES-D6cQabJ1.mjs';
+import { createWorkflowRunContext } from '../packem_shared/createWorkflowRunContext-CYI9SeI9.mjs';
 
 class LunoraWorkflow extends WorkflowEntrypoint {
   /** The `lunora/workflows.ts` export name, for log correlation. */

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { a as Workflows, L as LunoraWorkflowsOptions, S as StepArgsValidator, b as StepConfig, c as StepDefinition, d as WorkflowConfig, W as WorkflowDefinition, e as WorkflowBranch, f as WorkflowInstanceStatus, g as WorkflowEventLike, h as WorkflowStepLike, i as WorkflowRunContext, j as WorkflowLogger, k as WorkflowRunFunction, l as WorkflowRunStepFunction } from "./packem_shared/types.d-Fdeu2P2C.mjs";
-export type { A as ArgsOf, F as FunctionReference, I as InferStepArgs, R as RunFunctionOptions, m as RunStepOptions, n as StepHandler, o as StepRollbackContext, p as StepRollbackHandler, q as StepRunContext, r as WorkflowBindingLike, s as WorkflowBranchOutputs, t as WorkflowCreateOptions, u as WorkflowHandle, v as WorkflowHandler, w as WorkflowInstanceLike, x as WorkflowParallelFunction, y as WorkflowRollbackContextLike, z as WorkflowRollbackHandlerLike, B as WorkflowSpawnFunction, C as WorkflowSpawnOptions, D as WorkflowStatusResult, E as WorkflowStepConfigLike, G as WorkflowStepContextLike, H as WorkflowStepRollbackOptionsLike } from "./packem_shared/types.d-Fdeu2P2C.mjs";
+import { a as Workflows, L as LunoraWorkflowsOptions, S as StepArgsValidator, b as StepConfig, c as StepDefinition, d as WorkflowConfig, W as WorkflowDefinition, e as WorkflowBranch, f as WorkflowInstanceStatus, g as WorkflowEventLike, h as WorkflowStepLike, i as WorkflowRunContext, j as WorkflowLogger, k as WorkflowRunFunction, l as WorkflowRunStepFunction } from "./packem_shared/types.d-C9W6rEWv.mjs";
+export type { A as ArgsOf, B as BranchCompensationParams, F as FunctionReference, I as InferStepArgs, R as RunFunctionOptions, m as RunStepOptions, n as StepHandler, o as StepRollbackContext, p as StepRollbackHandler, q as StepRunContext, r as WorkflowBindingLike, s as WorkflowBranchOutputs, t as WorkflowCreateOptions, u as WorkflowHandle, v as WorkflowHandler, w as WorkflowInstanceLike, x as WorkflowParallelFunction, y as WorkflowRollbackContextLike, z as WorkflowRollbackHandlerLike, C as WorkflowSpawnFunction, D as WorkflowSpawnOptions, E as WorkflowStatusResult, G as WorkflowStepConfigLike, H as WorkflowStepContextLike, J as WorkflowStepRollbackOptionsLike } from "./packem_shared/types.d-C9W6rEWv.mjs";
 import '@lunora/values';
 /** Wiring info for one declared workflow, emitted by codegen into the generated shard. */
 interface WorkflowBindingSpec {
@@ -142,6 +142,7 @@ declare const MAX_BRANCHES = 100;
 * tuple — e.g. `branch("imageTag", { key })` typed as `branch` of `{ tags }`.
 */
 declare const branch: <Output = unknown>(workflow: string, params?: Record<string, unknown>, options?: {
+  compensateWith?: string;
   id?: string;
   timeout?: number | string;
 }) => WorkflowBranch<Output>;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { a as Workflows, L as LunoraWorkflowsOptions, S as StepArgsValidator, b as StepConfig, c as StepDefinition, d as WorkflowConfig, W as WorkflowDefinition, e as WorkflowBranch, f as WorkflowInstanceStatus, g as WorkflowEventLike, h as WorkflowStepLike, i as WorkflowRunContext, j as WorkflowLogger, k as WorkflowRunFunction, l as WorkflowRunStepFunction } from "./packem_shared/types.d-Fdeu2P2C.js";
-export type { A as ArgsOf, F as FunctionReference, I as InferStepArgs, R as RunFunctionOptions, m as RunStepOptions, n as StepHandler, o as StepRollbackContext, p as StepRollbackHandler, q as StepRunContext, r as WorkflowBindingLike, s as WorkflowBranchOutputs, t as WorkflowCreateOptions, u as WorkflowHandle, v as WorkflowHandler, w as WorkflowInstanceLike, x as WorkflowParallelFunction, y as WorkflowRollbackContextLike, z as WorkflowRollbackHandlerLike, B as WorkflowSpawnFunction, C as WorkflowSpawnOptions, D as WorkflowStatusResult, E as WorkflowStepConfigLike, G as WorkflowStepContextLike, H as WorkflowStepRollbackOptionsLike } from "./packem_shared/types.d-Fdeu2P2C.js";
+import { a as Workflows, L as LunoraWorkflowsOptions, S as StepArgsValidator, b as StepConfig, c as StepDefinition, d as WorkflowConfig, W as WorkflowDefinition, e as WorkflowBranch, f as WorkflowInstanceStatus, g as WorkflowEventLike, h as WorkflowStepLike, i as WorkflowRunContext, j as WorkflowLogger, k as WorkflowRunFunction, l as WorkflowRunStepFunction } from "./packem_shared/types.d-C9W6rEWv.js";
+export type { A as ArgsOf, B as BranchCompensationParams, F as FunctionReference, I as InferStepArgs, R as RunFunctionOptions, m as RunStepOptions, n as StepHandler, o as StepRollbackContext, p as StepRollbackHandler, q as StepRunContext, r as WorkflowBindingLike, s as WorkflowBranchOutputs, t as WorkflowCreateOptions, u as WorkflowHandle, v as WorkflowHandler, w as WorkflowInstanceLike, x as WorkflowParallelFunction, y as WorkflowRollbackContextLike, z as WorkflowRollbackHandlerLike, C as WorkflowSpawnFunction, D as WorkflowSpawnOptions, E as WorkflowStatusResult, G as WorkflowStepConfigLike, H as WorkflowStepContextLike, J as WorkflowStepRollbackOptionsLike } from "./packem_shared/types.d-C9W6rEWv.js";
 import '@lunora/values';
 /** Wiring info for one declared workflow, emitted by codegen into the generated shard. */
 interface WorkflowBindingSpec {
@@ -142,6 +142,7 @@ declare const MAX_BRANCHES = 100;
 * tuple — e.g. `branch("imageTag", { key })` typed as `branch` of `{ tags }`.
 */
 declare const branch: <Output = unknown>(workflow: string, params?: Record<string, unknown>, options?: {
+  compensateWith?: string;
   id?: string;
   timeout?: number | string;
 }) => WorkflowBranch<Output>;

package/dist/index.mjs

@@ -3,7 +3,7 @@ export { default as createWorkflows } from './packem_shared/createWorkflows-BoSY
 export { defineStep, isStepDefinition } from './packem_shared/defineStep-DJQtLw7g.mjs';
 export { defineWorkflow, isWorkflowDefinition, workflowBindingName, workflowClassName, workflowDefaultName } from './packem_shared/defineWorkflow-DbUC-oCN.mjs';
 export { NonRetryableError, convertNonRetryableError, isNonRetryableError, toNativeNonRetryableError } from './packem_shared/NonRetryableError-Dn2dTyBS.mjs';
-export { MAX_BRANCHES, branch } from './packem_shared/MAX_BRANCHES-C9MJIFii.mjs';
+export { MAX_BRANCHES, branch } from './packem_shared/MAX_BRANCHES-D6cQabJ1.mjs';
 export { WorkflowsRestError, createWorkflowsRestClient } from './packem_shared/WorkflowsRestError-b06i7K5j.mjs';
-export { createWorkflowRunContext } from './packem_shared/createWorkflowRunContext-BsMyGuMR.mjs';
+export { createWorkflowRunContext } from './packem_shared/createWorkflowRunContext-CYI9SeI9.mjs';
 export { createRunStep, validateStepArgs } from './packem_shared/createRunStep-8jOXxP2o.mjs';

package/dist/packem_shared/{MAX_BRANCHES-C9MJIFii.mjs → MAX_BRANCHES-D6cQabJ1.mjs}

@@ -5,9 +5,10 @@ const BRANCH_MARKER_KEY = "__lunoraBranch";
 const SPAWN_STEP_PREFIX = "lunora:spawn:";
 const AWAIT_STEP_PREFIX = "lunora:await:";
 const SIGNAL_STEP_PREFIX = "lunora:signal:";
+const COMPENSATE_STEP_PREFIX = "lunora:compensate:";
 const BRANCH_EVENT_PREFIX = "lunora:branch:";
 const branch = (workflow, params, options) => {
-  return { id: options?.id, params, timeout: options?.timeout, workflow };
+  return { compensateWith: options?.compensateWith, id: options?.id, params, timeout: options?.timeout, workflow };
 };
 const serializeError = (error) => {
   if (error instanceof Error) {
@@ -21,6 +22,26 @@ const okOutcome = (value) => {
 const errorOutcome = (error) => {
   return { error: serializeError(error), status: "error" };
 };
+const compensateCompleted = async (deps, completed, error) => {
+  for (let cursor = completed.length - 1; cursor >= 0; cursor -= 1) {
+    const done = completed[cursor];
+    const compensateWith = done?.plan.item.compensateWith;
+    if (done === void 0 || compensateWith === void 0) {
+      continue;
+    }
+    await deps.step.do(`${COMPENSATE_STEP_PREFIX}${done.plan.childId}`, async () => {
+      const compensateId = `${done.plan.childId}:compensate`;
+      const compensationParams = {
+        branch: done.plan.item.workflow,
+        error,
+        index: done.plan.index,
+        output: done.output
+      };
+      await deps.resolveBinding(compensateWith).create({ id: compensateId, params: compensationParams });
+      return compensateId;
+    });
+  }
+};
 const createParallel = (deps) => {
   const run = async (branches) => {
     if (branches.length === 0) {
@@ -46,6 +67,7 @@ const createParallel = (deps) => {
       )
     );
     const results = [];
+    const completed = [];
     for (const plan of planned) {
       const event = await deps.step.waitForEvent(`${AWAIT_STEP_PREFIX}${plan.childId}`, {
         timeout: plan.item.timeout,
@@ -53,8 +75,10 @@ const createParallel = (deps) => {
       });
       const outcome = event.payload;
       if (outcome.status === "error") {
+        await compensateCompleted(deps, completed, outcome.error);
         throw new NonRetryableError(`ctx.parallel: branch "${plan.item.workflow}" (#${String(plan.index)}) failed: ${outcome.error.message}`);
       }
+      completed.push({ output: outcome.value, plan });
       results.push(outcome.value);
     }
     return results;

package/dist/packem_shared/{createWorkflowRunContext-BsMyGuMR.mjs → createWorkflowRunContext-CYI9SeI9.mjs}

@@ -1,5 +1,5 @@
 import { workflowBindingName } from './defineWorkflow-DbUC-oCN.mjs';
-import { createSpawn, createParallel } from './MAX_BRANCHES-C9MJIFii.mjs';
+import { createSpawn, createParallel } from './MAX_BRANCHES-D6cQabJ1.mjs';
 import { createRunStep } from './createRunStep-8jOXxP2o.mjs';
 
 const createDispatchLogger = (prefix) => {

package/dist/packem_shared/{types.d-Fdeu2P2C.d.mts → types.d-C9W6rEWv.d.mts}

@@ -272,6 +272,16 @@ type WorkflowRunStepFunction = <A extends StepArgsValidator, Result>(step: StepD
 interface WorkflowBranch<Output = unknown> {
   /** Phantom marker for the branch output type — never present at runtime. */
   readonly __output?: Output;
+  /**
+  * Optional group-saga compensation (plan 075 Phase 3): the `lunora/workflows.ts`
+  * export name of a workflow to run if a **sibling** branch in the same
+  * `ctx.parallel(...)` group fails **after** this branch has already completed.
+  * It is spawned fire-and-forget (a durable, replay-safe idempotent create) with
+  * {@link BranchCompensationParams} as its `ctx.params`. Omit for no
+  * compensation — a group where no branch sets this behaves exactly as a plain
+  * fan-out (fail-fast, no rollback).
+  */
+  readonly compensateWith?: string;
   /** Optional explicit child instance id (defaults to a deterministic parent-derived id). */
   readonly id?: string;
   /** The params the child instance is created with — surfaced as the child's `ctx.params`. */
@@ -281,6 +291,27 @@ interface WorkflowBranch<Output = unknown> {
   /** The `lunora/workflows.ts` export name of the child workflow to run. */
   readonly workflow: string;
 }
+/**
+* The `ctx.params` a group-saga compensation workflow (a branch's
+* {@link WorkflowBranch.compensateWith}) receives when a sibling's failure rolls
+* back the group. Everything is plain-serialisable — the compensation is an
+* ordinary declared workflow, so it can `ctx.runStep(...)` its own undo logic.
+*/
+interface BranchCompensationParams {
+  /** Index signature: this is a workflow `params` bag, so it is a valid `Record&lt;string, unknown>` payload. */
+  [key: string]: unknown;
+  /** The export name of the completed branch being compensated. */
+  branch: string;
+  /** The serialised error of the sibling branch whose failure triggered the group rollback. */
+  error: {
+    message: string;
+    name: string;
+  };
+  /** Declaration-order index of the completed branch being compensated. */
+  index: number;
+  /** The completed branch's output value — what it returned before the group failed. */
+  output?: unknown;
+}
 /** Map a tuple of {@link WorkflowBranch}es to the tuple of their output types, preserving order. */
 type WorkflowBranchOutputs<B extends ReadonlyArray<WorkflowBranch>> = { -readonly [K in keyof B]: B[K] extends WorkflowBranch<infer Output> ? Output : never };
 /**
@@ -391,4 +422,4 @@ interface LunoraWorkflowsOptions {
   */
   bindings: Record<string, WorkflowBindingLike>;
 }
-export { ArgsOf as A, WorkflowSpawnFunction as B, WorkflowSpawnOptions as C, WorkflowStatusResult as D, WorkflowStepConfigLike as E, FunctionReference as F, WorkflowStepContextLike as G, WorkflowStepRollbackOptionsLike as H, InferStepArgs as I, LunoraWorkflowsOptions as L, RunFunctionOptions as R, StepArgsValidator as S, WorkflowDefinition as W, Workflows as a, StepConfig as b, StepDefinition as c, WorkflowConfig as d, WorkflowBranch as e, WorkflowInstanceStatus as f, WorkflowEventLike as g, WorkflowStepLike as h, WorkflowRunContext as i, WorkflowLogger as j, WorkflowRunFunction as k, WorkflowRunStepFunction as l, RunStepOptions as m, StepHandler as n, StepRollbackContext as o, StepRollbackHandler as p, StepRunContext as q, WorkflowBindingLike as r, WorkflowBranchOutputs as s, WorkflowCreateOptions as t, WorkflowHandle as u, WorkflowHandler as v, WorkflowInstanceLike as w, WorkflowParallelFunction as x, WorkflowRollbackContextLike as y, WorkflowRollbackHandlerLike as z };
+export { ArgsOf as A, BranchCompensationParams as B, WorkflowSpawnFunction as C, WorkflowSpawnOptions as D, WorkflowStatusResult as E, FunctionReference as F, WorkflowStepConfigLike as G, WorkflowStepContextLike as H, InferStepArgs as I, WorkflowStepRollbackOptionsLike as J, LunoraWorkflowsOptions as L, RunFunctionOptions as R, StepArgsValidator as S, WorkflowDefinition as W, Workflows as a, StepConfig as b, StepDefinition as c, WorkflowConfig as d, WorkflowBranch as e, WorkflowInstanceStatus as f, WorkflowEventLike as g, WorkflowStepLike as h, WorkflowRunContext as i, WorkflowLogger as j, WorkflowRunFunction as k, WorkflowRunStepFunction as l, RunStepOptions as m, StepHandler as n, StepRollbackContext as o, StepRollbackHandler as p, StepRunContext as q, WorkflowBindingLike as r, WorkflowBranchOutputs as s, WorkflowCreateOptions as t, WorkflowHandle as u, WorkflowHandler as v, WorkflowInstanceLike as w, WorkflowParallelFunction as x, WorkflowRollbackContextLike as y, WorkflowRollbackHandlerLike as z };

package/dist/packem_shared/{types.d-Fdeu2P2C.d.ts → types.d-C9W6rEWv.d.ts}

@@ -272,6 +272,16 @@ type WorkflowRunStepFunction = <A extends StepArgsValidator, Result>(step: StepD
 interface WorkflowBranch<Output = unknown> {
   /** Phantom marker for the branch output type — never present at runtime. */
   readonly __output?: Output;
+  /**
+  * Optional group-saga compensation (plan 075 Phase 3): the `lunora/workflows.ts`
+  * export name of a workflow to run if a **sibling** branch in the same
+  * `ctx.parallel(...)` group fails **after** this branch has already completed.
+  * It is spawned fire-and-forget (a durable, replay-safe idempotent create) with
+  * {@link BranchCompensationParams} as its `ctx.params`. Omit for no
+  * compensation — a group where no branch sets this behaves exactly as a plain
+  * fan-out (fail-fast, no rollback).
+  */
+  readonly compensateWith?: string;
   /** Optional explicit child instance id (defaults to a deterministic parent-derived id). */
   readonly id?: string;
   /** The params the child instance is created with — surfaced as the child's `ctx.params`. */
@@ -281,6 +291,27 @@ interface WorkflowBranch<Output = unknown> {
   /** The `lunora/workflows.ts` export name of the child workflow to run. */
   readonly workflow: string;
 }
+/**
+* The `ctx.params` a group-saga compensation workflow (a branch's
+* {@link WorkflowBranch.compensateWith}) receives when a sibling's failure rolls
+* back the group. Everything is plain-serialisable — the compensation is an
+* ordinary declared workflow, so it can `ctx.runStep(...)` its own undo logic.
+*/
+interface BranchCompensationParams {
+  /** Index signature: this is a workflow `params` bag, so it is a valid `Record&lt;string, unknown>` payload. */
+  [key: string]: unknown;
+  /** The export name of the completed branch being compensated. */
+  branch: string;
+  /** The serialised error of the sibling branch whose failure triggered the group rollback. */
+  error: {
+    message: string;
+    name: string;
+  };
+  /** Declaration-order index of the completed branch being compensated. */
+  index: number;
+  /** The completed branch's output value — what it returned before the group failed. */
+  output?: unknown;
+}
 /** Map a tuple of {@link WorkflowBranch}es to the tuple of their output types, preserving order. */
 type WorkflowBranchOutputs<B extends ReadonlyArray<WorkflowBranch>> = { -readonly [K in keyof B]: B[K] extends WorkflowBranch<infer Output> ? Output : never };
 /**
@@ -391,4 +422,4 @@ interface LunoraWorkflowsOptions {
   */
   bindings: Record<string, WorkflowBindingLike>;
 }
-export { ArgsOf as A, WorkflowSpawnFunction as B, WorkflowSpawnOptions as C, WorkflowStatusResult as D, WorkflowStepConfigLike as E, FunctionReference as F, WorkflowStepContextLike as G, WorkflowStepRollbackOptionsLike as H, InferStepArgs as I, LunoraWorkflowsOptions as L, RunFunctionOptions as R, StepArgsValidator as S, WorkflowDefinition as W, Workflows as a, StepConfig as b, StepDefinition as c, WorkflowConfig as d, WorkflowBranch as e, WorkflowInstanceStatus as f, WorkflowEventLike as g, WorkflowStepLike as h, WorkflowRunContext as i, WorkflowLogger as j, WorkflowRunFunction as k, WorkflowRunStepFunction as l, RunStepOptions as m, StepHandler as n, StepRollbackContext as o, StepRollbackHandler as p, StepRunContext as q, WorkflowBindingLike as r, WorkflowBranchOutputs as s, WorkflowCreateOptions as t, WorkflowHandle as u, WorkflowHandler as v, WorkflowInstanceLike as w, WorkflowParallelFunction as x, WorkflowRollbackContextLike as y, WorkflowRollbackHandlerLike as z };
+export { ArgsOf as A, BranchCompensationParams as B, WorkflowSpawnFunction as C, WorkflowSpawnOptions as D, WorkflowStatusResult as E, FunctionReference as F, WorkflowStepConfigLike as G, WorkflowStepContextLike as H, InferStepArgs as I, WorkflowStepRollbackOptionsLike as J, LunoraWorkflowsOptions as L, RunFunctionOptions as R, StepArgsValidator as S, WorkflowDefinition as W, Workflows as a, StepConfig as b, StepDefinition as c, WorkflowConfig as d, WorkflowBranch as e, WorkflowInstanceStatus as f, WorkflowEventLike as g, WorkflowStepLike as h, WorkflowRunContext as i, WorkflowLogger as j, WorkflowRunFunction as k, WorkflowRunStepFunction as l, RunStepOptions as m, StepHandler as n, StepRollbackContext as o, StepRollbackHandler as p, StepRunContext as q, WorkflowBindingLike as r, WorkflowBranchOutputs as s, WorkflowCreateOptions as t, WorkflowHandle as u, WorkflowHandler as v, WorkflowInstanceLike as w, WorkflowParallelFunction as x, WorkflowRollbackContextLike as y, WorkflowRollbackHandlerLike as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/workflow",
-  "version": "1.0.0-alpha.4",
+  "version": "1.0.0-alpha.5",
   "description": "Durable workflows for Lunora: defineWorkflow over Cloudflare Workflows, generated WorkflowEntrypoint classes, and the ctx.workflows surface",
   "keywords": [
     "cloudflare",