@lunora/workflow 1.0.0-alpha.13 → 1.0.0-alpha.14

package/dist/do/index.mjs

@@ -1,44 +1 @@
-import { WorkflowEntrypoint } from 'cloudflare:workers';
-import { NonRetryableError } from 'cloudflare:workflows';
-import { convertNonRetryableError } from '../packem_shared/NonRetryableError-Dn2dTyBS.mjs';
-import { extractBranchMarker, stripBranchMarker, signalBranchParentSafe, errorOutcome, okOutcome } from '../packem_shared/MAX_BRANCHES-EO5xYS_3.mjs';
-import { createWorkflowRunContext } from '../packem_shared/createWorkflowRunContext-D62MbkFK.mjs';
-
-class LunoraWorkflow extends WorkflowEntrypoint {
-  /** The `lunora/workflows.ts` export name, for log correlation. */
-  #lunoraName;
-  /** The `defineWorkflow` result this entrypoint runs. */
-  #definition;
-  constructor(context, env, definition, exportName) {
-    super(context, env);
-    this.#definition = definition;
-    this.#lunoraName = exportName ?? "workflow";
-  }
-  async run(event, step) {
-    const nativeStep = step;
-    const marker = extractBranchMarker(event.payload);
-    const handlerEvent = marker ? { ...event, payload: stripBranchMarker(event.payload) } : event;
-    const context = createWorkflowRunContext({
-      env: this.env,
-      event: handlerEvent,
-      exportName: this.#lunoraName,
-      nonRetryableErrorClass: NonRetryableError,
-      step: nativeStep
-    });
-    let output;
-    try {
-      output = await this.#definition.handler(context);
-    } catch (error) {
-      if (marker) {
-        await signalBranchParentSafe({ env: this.env, log: context.log, step: nativeStep }, marker, errorOutcome(error));
-      }
-      return convertNonRetryableError(error, NonRetryableError);
-    }
-    if (marker) {
-      await signalBranchParentSafe({ env: this.env, log: context.log, step: nativeStep }, marker, okOutcome(output));
-    }
-    return output;
-  }
-}
-
-export { LunoraWorkflow as default };
+import{WorkflowEntrypoint as c}from"cloudflare:workers";import{NonRetryableError as i}from"cloudflare:workflows";import{convertNonRetryableError as m}from"../packem_shared/NonRetryableError-CXD-mZe4.mjs";import{extractBranchMarker as h,stripBranchMarker as f,signalBranchParentSafe as l,errorOutcome as u,okOutcome as v}from"../packem_shared/MAX_BRANCHES-DC-bbfah.mjs";import{createWorkflowRunContext as y}from"../packem_shared/createWorkflowRunContext-BTtqNIwl.mjs";class R extends c{#r;#t;constructor(t,e,a,r){super(t,e),this.#t=a,this.#r=r??"workflow"}async run(t,e){const a=e,r=h(t.payload),p=r?{...t,payload:f(t.payload)}:t,o=y({env:this.env,event:p,exportName:this.#r,nonRetryableErrorClass:i,step:a});let n;try{n=await this.#t.handler(o)}catch(s){return r&&await l({env:this.env,log:o.log,step:a},r,u(s)),m(s,i)}return r&&await l({env:this.env,log:o.log,step:a},r,v(n)),n}}export{R as default};

package/dist/index.mjs

@@ -1,9 +1 @@
-export { createWorkflowContext } from './packem_shared/createWorkflowContext-oxZ5zj3x.mjs';
-export { default as createWorkflows } from './packem_shared/createWorkflows-wq4fs72q.mjs';
-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-EO5xYS_3.mjs';
-export { WorkflowsRestError, createWorkflowsRestClient } from './packem_shared/WorkflowsRestError-zmjOxTR1.mjs';
-export { createWorkflowRunContext } from './packem_shared/createWorkflowRunContext-D62MbkFK.mjs';
-export { createRunStep, validateStepArgs } from './packem_shared/createRunStep-8jOXxP2o.mjs';
+import{createWorkflowContext as e}from"./packem_shared/createWorkflowContext-Dc-ECx9X.mjs";import{default as f}from"./packem_shared/createWorkflows-UPBTcUJt.mjs";import{defineStep as l,isStepDefinition as n}from"./packem_shared/defineStep-rJ0XPdAx.mjs";import{defineWorkflow as p,isWorkflowDefinition as w,workflowBindingName as m,workflowClassName as s,workflowDefaultName as x}from"./packem_shared/defineWorkflow-fBuCDkGT.mjs";import{NonRetryableError as N,convertNonRetryableError as R,isNonRetryableError as c,toNativeNonRetryableError as W}from"./packem_shared/NonRetryableError-CXD-mZe4.mjs";import{MAX_BRANCHES as b,branch as d}from"./packem_shared/MAX_BRANCHES-DC-bbfah.mjs";import{WorkflowsRestError as S,createWorkflowsRestClient as u}from"./packem_shared/WorkflowsRestError--PIoe9uw.mjs";import{createWorkflowRunContext as v}from"./packem_shared/createWorkflowRunContext-BTtqNIwl.mjs";import{createRunStep as D,validateStepArgs as g}from"./packem_shared/createRunStep-CzGKC1eZ.mjs";export{b as MAX_BRANCHES,N as NonRetryableError,S as WorkflowsRestError,d as branch,R as convertNonRetryableError,D as createRunStep,e as createWorkflowContext,v as createWorkflowRunContext,f as createWorkflows,u as createWorkflowsRestClient,l as defineStep,p as defineWorkflow,c as isNonRetryableError,n as isStepDefinition,w as isWorkflowDefinition,W as toNativeNonRetryableError,g as validateStepArgs,m as workflowBindingName,s as workflowClassName,x as workflowDefaultName};

package/dist/packem_shared/MAX_BRANCHES-DC-bbfah.mjs

@@ -0,0 +1 @@
+import{LunoraError as g}from"@lunora/errors";import{NonRetryableError as p}from"./NonRetryableError-CXD-mZe4.mjs";const h=100,c="__lunoraBranch",w="lunora:spawn:",y="lunora:await:",$="lunora:signal:",v="lunora:compensate:",f="lunora:branch:",b=(e,t,a)=>({compensateWith:a?.compensateWith,id:a?.id,params:t,timeout:a?.timeout,workflow:e}),m=e=>e instanceof Error?{message:e.message,name:e.name}:{message:String(e),name:"Error"},k=e=>({status:"ok",value:e}),S=e=>({error:m(e),status:"error"}),u=async(e,t,a)=>{for(let i=t.length-1;i>=0;i-=1){const n=t[i],l=n?.plan.item.compensateWith;if(!(n===void 0||l===void 0))try{const r=e.resolveBinding(l);await e.step.do(`${v}${n.plan.childId}`,async()=>{const o=`${n.plan.childId}:compensate`,s={branch:n.plan.item.workflow,error:a,index:n.plan.index,output:n.output};return await r.create({id:o,params:s}),o})}catch(r){e.log?.error(`ctx.parallel: group-saga compensation "${l}" for branch "${n.plan.item.workflow}" (#${String(n.plan.index)}) failed`,r)}}},E=e=>async t=>{if(t.length===0)return[];if(t.length>h)throw new p(`ctx.parallel: ${String(t.length)} branches exceeds the cap of ${String(h)} — split the fan-out or raise the work into fewer child workflows`);const a=t.map((r,o)=>{const s=e.nextChildId(r.id);return{childId:s,eventType:`${f}${s}`,index:o,item:r}}),i=new Set;for(const r of a){if(i.has(r.childId))throw new p(`ctx.parallel: duplicate branch id "${r.childId}" — each branch in a group must resolve to a unique child instance id (check explicit \`id\` options)`);i.add(r.childId)}await Promise.all(a.map(r=>e.step.do(`${w}${r.childId}`,async()=>{const o=e.resolveBinding(r.item.workflow),s={eventType:r.eventType,index:r.index,parentBinding:e.parentBinding,parentId:e.instanceId};return await o.create({id:r.childId,params:{...r.item.params,[c]:s}}),r.childId})));const n=[],l=[];for(const r of a){let o;try{o=(await e.step.waitForEvent(`${y}${r.childId}`,{timeout:r.item.timeout,type:r.eventType})).payload}catch(s){const d=m(s);throw await u(e,l,d),new p(`ctx.parallel: branch "${r.item.workflow}" (#${String(r.index)}) join failed: ${d.message}`)}if(o.status==="error")throw await u(e,l,o.error),new p(`ctx.parallel: branch "${r.item.workflow}" (#${String(r.index)}) failed: ${o.error.message}`);l.push({output:o.value,plan:r}),n.push(o.value)}return n},T=e=>async(t,a,i)=>{if(a!==void 0&&Object.hasOwn(a,c))throw new g("BAD_REQUEST",`@lunora/workflow: params may not contain the reserved key "${c}"`);const n=e.nextChildId(i?.id);return await e.step.do(`${w}${n}`,async()=>(await e.resolveBinding(t).create({id:n,params:a}),n)),e.resolveBinding(t).get(n)},R=e=>{if(typeof e!="object"||e===null)return;const t=e[c];if(typeof t!="object"||t===null)return;const a=t;if(!(typeof a.eventType!="string"||typeof a.parentBinding!="string"||typeof a.parentId!="string"||typeof a.index!="number")&&!(!a.parentBinding.startsWith("WORKFLOW_")||!a.eventType.startsWith(f)))return{eventType:a.eventType,index:a.index,parentBinding:a.parentBinding,parentId:a.parentId}},W=e=>{if(typeof e!="object"||e===null)return e;const t={...e};return Reflect.deleteProperty(t,c),t},x=async(e,t,a)=>{const i=e.env[t.parentBinding];if(!i||typeof i.get!="function")return;const n=i.get.bind(i);await e.step.do(`${$}${String(t.index)}`,async()=>(await(await n(t.parentId)).sendEvent({payload:a,type:t.eventType}),t.eventType))},O=async(e,t,a)=>{try{await x(e,t,a)}catch(i){e.log?.error(`@lunora/workflow: failed to signal branch parent "${t.parentId}" (event "${t.eventType}")`,i)}};export{c as BRANCH_MARKER_KEY,h as MAX_BRANCHES,b as branch,E as createParallel,T as createSpawn,S as errorOutcome,R as extractBranchMarker,k as okOutcome,x as signalBranchParent,O as signalBranchParentSafe,W as stripBranchMarker};

package/dist/packem_shared/NonRetryableError-CXD-mZe4.mjs

@@ -0,0 +1 @@
+const t="__lunoraNonRetryable";class c extends Error{constructor(e,o="NonRetryableError"){super(e),this.name=o,this[t]=!0}}const s=r=>r instanceof Error&&r[t]===!0,a=(r,e)=>{const o=new e(r.message,r.name);return r.stack!==void 0&&(o.stack=r.stack),r.cause!==void 0&&o.cause===void 0&&(o.cause=r.cause),o},n=(r,e)=>{throw e!==void 0&&s(r)?a(r,e):r};export{c as NonRetryableError,n as convertNonRetryableError,s as isNonRetryableError,a as toNativeNonRetryableError};

package/dist/packem_shared/WorkflowsRestError--PIoe9uw.mjs

@@ -0,0 +1 @@
+import{LunoraError as h}from"@lunora/errors";const $="https://api.cloudflare.com/client/v4/accounts",I={complete:!0,errored:!0,paused:!0,queued:!0,running:!0,terminated:!0,unknown:!0,waiting:!0,waitingForPause:!0},w=e=>typeof e=="string"&&Object.hasOwn(I,e)?e:"unknown",c=e=>typeof e=="string"&&e!==""?e:void 0,f=(e,a)=>typeof e=="string"?e:a,S=e=>typeof e=="boolean"?e:void 0,k=e=>Array.isArray(e)?e.length:typeof e=="number"?e:void 0,m=e=>({createdOn:c(e.created_on),endedOn:c(e.ended_on),id:f(e.id,""),startedOn:c(e.started_on),status:w(e.status)}),b=e=>({attempts:k(e.attempts),end:c(e.end),error:e.error,name:f(e.name,""),output:e.output,start:c(e.start),success:S(e.success),type:c(e.type)});class g extends h{constructor(a,i){super("WORKFLOWS_REST_ERROR",`Cloudflare Workflows REST API returned ${String(a)}: ${i}`,{name:"WorkflowsRestError",status:a})}}const C=e=>{const a=e.fetch??globalThis.fetch.bind(globalThis),i=`${$}/${e.accountId}/workflows`,p=async(r,s)=>{const t=await a(`${i}${r}`,{...s,headers:{Authorization:`Bearer ${e.apiToken}`,"Content-Type":"application/json"}}),o=await t.text();let n;try{n=JSON.parse(o)}catch{throw new g(t.status,o)}if(!t.ok||n.success===!1)throw new g(t.status,o);return n};return{getInstance:async({instanceId:r,workflowName:s})=>{const t=(await p(`/${encodeURIComponent(s)}/instances/${encodeURIComponent(r)}`)).result??{},o=Array.isArray(t.steps)?t.steps:[];return{...m(t),error:t.error,output:t.output,params:t.params,steps:o.map(n=>b(n))}},listInstances:async({page:r,perPage:s,status:t,workflowName:o})=>{const n=new URLSearchParams;t!==void 0&&n.set("status",t),r!==void 0&&n.set("page",String(r)),s!==void 0&&n.set("per_page",String(s));const y=n.toString()===""?"":`?${n.toString()}`,d=await p(`/${encodeURIComponent(o)}/instances${y}`),l=Array.isArray(d.result)?d.result:[],u=d.result_info??{};return{instances:l.map(R=>m(R)),page:typeof u.page=="number"?u.page:r??1,perPage:typeof u.per_page=="number"?u.per_page:s??l.length,totalCount:typeof u.total_count=="number"?u.total_count:void 0}},setInstanceStatus:async({action:r,instanceId:s,workflowName:t})=>{const o=(await p(`/${encodeURIComponent(t)}/instances/${encodeURIComponent(s)}`,{body:JSON.stringify({status:r}),method:"PATCH"})).result??{};return{status:w(o.status)}}}};export{g as WorkflowsRestError,C as createWorkflowsRestClient};

package/dist/packem_shared/createRunStep-CzGKC1eZ.mjs

@@ -0,0 +1 @@
+import{parseValidatorMap as v}from"@lunora/values";import{convertNonRetryableError as p,NonRetryableError as y}from"./NonRetryableError-CXD-mZe4.mjs";const b=(r,t)=>v(r,t,"step args"),E=r=>async(t,g,f)=>{const o=f?.config??t.config,s=b(t.args,g),l=async n=>{const m={attempt:n.attempt,config:n.config,env:r.env,log:r.log,run:r.run,step:n.step};let e;try{e=await t.handler(m,s)}catch(a){return p(a,r.nonRetryableErrorClass)}if(!t.returns)return e;try{return t.returns.parse(e)}catch(a){const d=a instanceof Error?a.message:String(a),u=new y(`step "${t.name}" returns validation failed: ${d}`);return a!==void 0&&(u.cause=a),p(u,r.nonRetryableErrorClass)}},c=t.rollback,i=c?{rollback:async n=>{await c({args:s,env:r.env,error:n.error,log:r.log,output:n.output,run:r.run})},rollbackConfig:t.rollbackConfig}:void 0;return o===void 0?r.step.do(t.name,l,i):r.step.do(t.name,o,l,i)};export{E as createRunStep,b as validateStepArgs};

package/dist/packem_shared/createWorkflowContext-Dc-ECx9X.mjs

@@ -0,0 +1 @@
+import r from"./createWorkflows-UPBTcUJt.mjs";const i=(e,c)=>{const o={};for(const n of c){const t=e[n.binding];t&&typeof t.create=="function"&&typeof t.createBatch=="function"&&typeof t.get=="function"&&(o[n.exportName]=t)}return r({bindings:o})};export{i as createWorkflowContext};

package/dist/packem_shared/createWorkflowRunContext-BTtqNIwl.mjs

@@ -0,0 +1 @@
+import{LunoraError as f}from"@lunora/errors";import{workflowBindingName as h}from"./defineWorkflow-fBuCDkGT.mjs";import{createSpawn as w,createParallel as g}from"./MAX_BRANCHES-DC-bbfah.mjs";import{createRunStep as y}from"./createRunStep-CzGKC1eZ.mjs";const N=t=>({debug:(n,...e)=>{console.debug(t,n,...e)},error:(n,...e)=>{console.error(t,n,...e)},info:(n,...e)=>{console.info(t,n,...e)},warn:(n,...e)=>{console.warn(t,n,...e)}}),v="/_lunora/scheduler/dispatch",m=t=>{let n=t.length;for(;n>0&&t[n-1]==="/";)n-=1;return t.slice(0,n)},I=(t,n,e)=>{try{const o=JSON.parse(e)?.error;if(typeof o=="object"&&o!==null&&typeof o.code=="string"){const{code:i,data:u,message:s}=o;return new f(i,typeof s=="string"?s:void 0,{data:u,status:n})}}catch{}return new f("INTERNAL",`${t}: function dispatch failed (${String(n)}): ${e}`,{status:n})},R=t=>{const{label:n}=t,e=globalThis.fetch,o=t.fetchImpl??(typeof e=="function"?e.bind(globalThis):void 0);return async(i,u,s={})=>{if(typeof o!="function")throw new TypeError(`${n}: no fetch implementation available — pass fetchImpl or run on a platform with global fetch`);const r=t.env.LUNORA_ORIGIN_URL;if(typeof r!="string"||r.length===0)throw new f("INTERNAL",`${n}: \`LUNORA_ORIGIN_URL\` must be set on the Worker env so a handler can call back into Lunora functions`);const a=t.env.LUNORA_ADMIN_TOKEN;if(typeof a!="string"||a.length===0)throw new f("INTERNAL",`${n}: \`LUNORA_ADMIN_TOKEN\` must be set on the Worker env to authenticate function dispatch`);const l=`${m(r)}${v}`,p={authorization:`Bearer ${a}`,"content-type":"application/json"};t.identity?.userId!==void 0&&(p["x-lunora-userid"]=t.identity.userId),t.identity?.claims!==void 0&&(p["x-lunora-identity"]=JSON.stringify(t.identity.claims));const c=await o(l,{body:JSON.stringify({args:u??{},functionPath:i.__lunoraRef,shardKey:s.shardKey}),headers:p,method:"POST"});if(!c.ok)throw I(n,c.status,await c.text());const d=await c.text();if(d.length!==0)try{return JSON.parse(d)}catch{throw new f("INTERNAL",`${n}: function dispatch returned a non-JSON body (${String(c.status)}): ${d}`,{status:c.status})}}},S=t=>{const n=N(`[workflow:${t.exportName}]`),e=R({env:t.env,fetchImpl:t.fetchImpl,label:"@lunora/workflow"}),o=r=>{const a=h(r),l=t.env[a];if(!l||typeof l.create!="function"||typeof l.get!="function")throw new f("INTERNAL",`@lunora/workflow: cannot spawn child workflow "${r}" — no Workflow binding "${a}" on env (is it declared in lunora/workflows.ts?)`);return l};let i=0;const u=r=>{if(r!==void 0)return r;const a=`${t.event.instanceId}-c${String(i)}`;return i+=1,a},s={env:t.env,instanceId:t.event.instanceId,log:n,nextChildId:u,parentBinding:h(t.exportName),resolveBinding:o,step:t.step};return{env:t.env,event:t.event,log:n,parallel:g(s),params:t.event.payload,run:e,runStep:y({env:t.env,log:n,nonRetryableErrorClass:t.nonRetryableErrorClass,run:e,step:t.step}),spawn:w(s),step:t.step}};export{S as createWorkflowRunContext};

package/dist/packem_shared/createWorkflows-UPBTcUJt.mjs

@@ -0,0 +1 @@
+import{LunoraError as s}from"@lunora/errors";import{BRANCH_MARKER_KEY as a}from"./MAX_BRANCHES-DC-bbfah.mjs";const c=r=>{const{params:o}=r??{};if(o!==void 0&&Object.hasOwn(o,a))throw new s("BAD_REQUEST",`@lunora/workflow: params may not contain the reserved key "${a}"`)},f=r=>({create:async o=>(c(o),r.create(o)),createBatch:async o=>{for(const e of o)c(e);return r.createBatch(o)},get:async o=>r.get(o)}),k=r=>{const o=r.bindings??{};return{get:e=>{const n=o[e];if(n===void 0){const t=Object.keys(o),w=t.length===0?"no workflows are declared":`known workflows: ${t.join(", ")}`;throw new s("INTERNAL",`@lunora/workflow: no workflow named "${e}" (${w})`)}return f(n)}}};export{k as default};

package/dist/packem_shared/defineStep-rJ0XPdAx.mjs

@@ -0,0 +1 @@
+const o=(r,e)=>{if(typeof r!="string"||r.length===0)throw new TypeError("defineStep: `name` must be a non-empty string (the durable step label)");const n=e.args;if(typeof n!="object"||n===null)throw new TypeError("defineStep: `args` must be a validator map (e.g. `{ id: v.string() }`)");if(typeof e.handler!="function")throw new TypeError("defineStep: `handler` must be a function (the step body)");if(e.rollback!==void 0&&typeof e.rollback!="function")throw new TypeError("defineStep: `rollback` must be a function when provided");return{args:e.args,config:e.config,handler:e.handler,isLunoraStep:!0,name:r,returns:e.returns,rollback:e.rollback,rollbackConfig:e.rollbackConfig}},t=r=>typeof r=="object"&&r!==null&&r.isLunoraStep===!0;export{o as defineStep,t as isStepDefinition};

package/dist/packem_shared/defineWorkflow-fBuCDkGT.mjs

@@ -0,0 +1 @@
+const o=e=>`${e.charAt(0).toUpperCase()}${e.slice(1)}Workflow`,r=e=>`WORKFLOW_${e.replaceAll(/(?<=[a-z0-9])(?=[A-Z])/g,"_").toUpperCase()}`,n=e=>e.replaceAll(/(?<=[a-z0-9])(?=[A-Z])/g,"-").toLowerCase(),a=e=>{if(typeof e.handler!="function")throw new TypeError("defineWorkflow: `handler` must be a function (the workflow body)");if(e.name!==void 0&&(typeof e.name!="string"||e.name.length===0))throw new TypeError("defineWorkflow: `name` must be a non-empty string when provided");return{...e,isLunoraWorkflow:!0}},t=e=>typeof e=="object"&&e!==null&&e.isLunoraWorkflow===!0;export{a as defineWorkflow,t as isWorkflowDefinition,r as workflowBindingName,o as workflowClassName,n as workflowDefaultName};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/workflow",
-  "version": "1.0.0-alpha.13",
+  "version": "1.0.0-alpha.14",
   "description": "Durable workflows for Lunora: defineWorkflow over Cloudflare Workflows, generated WorkflowEntrypoint classes, and the ctx.workflows surface",
   "keywords": [
     "cloudflare",
@@ -48,8 +48,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@lunora/errors": "1.0.0-alpha.8",
-    "@lunora/values": "1.0.0-alpha.11"
+    "@lunora/errors": "1.0.0-alpha.9",
+    "@lunora/values": "1.0.0-alpha.12"
   },
   "engines": {
     "node": "^22.15.0 || >=24.11.0"

package/dist/packem_shared/MAX_BRANCHES-EO5xYS_3.mjs

@@ -1,170 +0,0 @@
-import { LunoraError } from '@lunora/errors';
-import { NonRetryableError } from './NonRetryableError-Dn2dTyBS.mjs';
-
-const MAX_BRANCHES = 100;
-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 { compensateWith: options?.compensateWith, id: options?.id, params, timeout: options?.timeout, workflow };
-};
-const serializeError = (error) => {
-  if (error instanceof Error) {
-    return { message: error.message, name: error.name };
-  }
-  return { message: String(error), name: "Error" };
-};
-const okOutcome = (value) => {
-  return { status: "ok", 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;
-    }
-    try {
-      const compensation = deps.resolveBinding(compensateWith);
-      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 compensation.create({ id: compensateId, params: compensationParams });
-        return compensateId;
-      });
-    } catch (compensationError) {
-      deps.log?.error(
-        `ctx.parallel: group-saga compensation "${compensateWith}" for branch "${done.plan.item.workflow}" (#${String(done.plan.index)}) failed`,
-        compensationError
-      );
-    }
-  }
-};
-const createParallel = (deps) => {
-  const run = async (branches) => {
-    if (branches.length === 0) {
-      return [];
-    }
-    if (branches.length > MAX_BRANCHES) {
-      throw new NonRetryableError(
-        `ctx.parallel: ${String(branches.length)} branches exceeds the cap of ${String(MAX_BRANCHES)} — split the fan-out or raise the work into fewer child workflows`
-      );
-    }
-    const planned = branches.map((item, index) => {
-      const childId = deps.nextChildId(item.id);
-      return { childId, eventType: `${BRANCH_EVENT_PREFIX}${childId}`, index, item };
-    });
-    const seenIds = /* @__PURE__ */ new Set();
-    for (const plan of planned) {
-      if (seenIds.has(plan.childId)) {
-        throw new NonRetryableError(
-          `ctx.parallel: duplicate branch id "${plan.childId}" — each branch in a group must resolve to a unique child instance id (check explicit \`id\` options)`
-        );
-      }
-      seenIds.add(plan.childId);
-    }
-    await Promise.all(
-      planned.map(
-        (plan) => deps.step.do(`${SPAWN_STEP_PREFIX}${plan.childId}`, async () => {
-          const binding = deps.resolveBinding(plan.item.workflow);
-          const marker = { eventType: plan.eventType, index: plan.index, parentBinding: deps.parentBinding, parentId: deps.instanceId };
-          await binding.create({ id: plan.childId, params: { ...plan.item.params, [BRANCH_MARKER_KEY]: marker } });
-          return plan.childId;
-        })
-      )
-    );
-    const results = [];
-    const completed = [];
-    for (const plan of planned) {
-      let outcome;
-      try {
-        const event = await deps.step.waitForEvent(`${AWAIT_STEP_PREFIX}${plan.childId}`, {
-          timeout: plan.item.timeout,
-          type: plan.eventType
-        });
-        outcome = event.payload;
-      } catch (joinError) {
-        const joinFailure = serializeError(joinError);
-        await compensateCompleted(deps, completed, joinFailure);
-        throw new NonRetryableError(`ctx.parallel: branch "${plan.item.workflow}" (#${String(plan.index)}) join failed: ${joinFailure.message}`);
-      }
-      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;
-  };
-  return run;
-};
-const createSpawn = (deps) => async (workflow, params, options) => {
-  if (params !== void 0 && Object.hasOwn(params, BRANCH_MARKER_KEY)) {
-    throw new LunoraError("BAD_REQUEST", `@lunora/workflow: params may not contain the reserved key "${BRANCH_MARKER_KEY}"`);
-  }
-  const childId = deps.nextChildId(options?.id);
-  await deps.step.do(`${SPAWN_STEP_PREFIX}${childId}`, async () => {
-    const binding = deps.resolveBinding(workflow);
-    await binding.create({ id: childId, params });
-    return childId;
-  });
-  return deps.resolveBinding(workflow).get(childId);
-};
-const extractBranchMarker = (payload) => {
-  if (typeof payload !== "object" || payload === null) {
-    return void 0;
-  }
-  const marker = payload[BRANCH_MARKER_KEY];
-  if (typeof marker !== "object" || marker === null) {
-    return void 0;
-  }
-  const candidate = marker;
-  if (typeof candidate.eventType !== "string" || typeof candidate.parentBinding !== "string" || typeof candidate.parentId !== "string" || typeof candidate.index !== "number") {
-    return void 0;
-  }
-  if (!candidate.parentBinding.startsWith("WORKFLOW_") || !candidate.eventType.startsWith(BRANCH_EVENT_PREFIX)) {
-    return void 0;
-  }
-  return { eventType: candidate.eventType, index: candidate.index, parentBinding: candidate.parentBinding, parentId: candidate.parentId };
-};
-const stripBranchMarker = (payload) => {
-  if (typeof payload !== "object" || payload === null) {
-    return payload;
-  }
-  const rest = { ...payload };
-  Reflect.deleteProperty(rest, BRANCH_MARKER_KEY);
-  return rest;
-};
-const signalBranchParent = async (deps, marker, outcome) => {
-  const binding = deps.env[marker.parentBinding];
-  if (!binding || typeof binding.get !== "function") {
-    return;
-  }
-  const getParent = binding.get.bind(binding);
-  await deps.step.do(`${SIGNAL_STEP_PREFIX}${String(marker.index)}`, async () => {
-    const parent = await getParent(marker.parentId);
-    await parent.sendEvent({ payload: outcome, type: marker.eventType });
-    return marker.eventType;
-  });
-};
-const signalBranchParentSafe = async (deps, marker, outcome) => {
-  try {
-    await signalBranchParent(deps, marker, outcome);
-  } catch (signalError) {
-    deps.log?.error(`@lunora/workflow: failed to signal branch parent "${marker.parentId}" (event "${marker.eventType}")`, signalError);
-  }
-};
-
-export { BRANCH_MARKER_KEY, MAX_BRANCHES, branch, createParallel, createSpawn, errorOutcome, extractBranchMarker, okOutcome, signalBranchParent, signalBranchParentSafe, stripBranchMarker };

package/dist/packem_shared/NonRetryableError-Dn2dTyBS.mjs

@@ -1,27 +0,0 @@
-const NON_RETRYABLE_BRAND = "__lunoraNonRetryable";
-class NonRetryableError extends Error {
-  constructor(message, name = "NonRetryableError") {
-    super(message);
-    this.name = name;
-    this[NON_RETRYABLE_BRAND] = true;
-  }
-}
-const isNonRetryableError = (value) => value instanceof Error && value[NON_RETRYABLE_BRAND] === true;
-const toNativeNonRetryableError = (error, NativeNonRetryableError) => {
-  const native = new NativeNonRetryableError(error.message, error.name);
-  if (error.stack !== void 0) {
-    native.stack = error.stack;
-  }
-  if (error.cause !== void 0 && native.cause === void 0) {
-    native.cause = error.cause;
-  }
-  return native;
-};
-const convertNonRetryableError = (error, NativeNonRetryableError) => {
-  if (NativeNonRetryableError !== void 0 && isNonRetryableError(error)) {
-    throw toNativeNonRetryableError(error, NativeNonRetryableError);
-  }
-  throw error;
-};
-
-export { NonRetryableError, convertNonRetryableError, isNonRetryableError, toNativeNonRetryableError };

package/dist/packem_shared/WorkflowsRestError-zmjOxTR1.mjs

@@ -1,117 +0,0 @@
-import { LunoraError } from '@lunora/errors';
-
-const API_BASE = "https://api.cloudflare.com/client/v4/accounts";
-const KNOWN_STATUSES = {
-  complete: true,
-  errored: true,
-  paused: true,
-  queued: true,
-  running: true,
-  terminated: true,
-  unknown: true,
-  waiting: true,
-  waitingForPause: true
-};
-const toStatus = (value) => typeof value === "string" && Object.hasOwn(KNOWN_STATUSES, value) ? value : "unknown";
-const asString = (value) => typeof value === "string" && value !== "" ? value : void 0;
-const stringOr = (value, fallback) => typeof value === "string" ? value : fallback;
-const asBoolean = (value) => typeof value === "boolean" ? value : void 0;
-const countAttempts = (value) => {
-  if (Array.isArray(value)) {
-    return value.length;
-  }
-  return typeof value === "number" ? value : void 0;
-};
-const toSummary = (raw) => {
-  return {
-    createdOn: asString(raw["created_on"]),
-    endedOn: asString(raw["ended_on"]),
-    id: stringOr(raw["id"], ""),
-    startedOn: asString(raw["started_on"]),
-    status: toStatus(raw["status"])
-  };
-};
-const toStep = (raw) => {
-  return {
-    attempts: countAttempts(raw["attempts"]),
-    end: asString(raw["end"]),
-    error: raw["error"],
-    name: stringOr(raw["name"], ""),
-    output: raw["output"],
-    start: asString(raw["start"]),
-    success: asBoolean(raw["success"]),
-    type: asString(raw["type"])
-  };
-};
-class WorkflowsRestError extends LunoraError {
-  constructor(status, body) {
-    super("WORKFLOWS_REST_ERROR", `Cloudflare Workflows REST API returned ${String(status)}: ${body}`, { name: "WorkflowsRestError", status });
-  }
-}
-const createWorkflowsRestClient = (config) => {
-  const fetchImpl = config.fetch ?? globalThis.fetch.bind(globalThis);
-  const base = `${API_BASE}/${config.accountId}/workflows`;
-  const request = async (path, init) => {
-    const response = await fetchImpl(`${base}${path}`, {
-      ...init,
-      headers: { Authorization: `Bearer ${config.apiToken}`, "Content-Type": "application/json" }
-    });
-    const text = await response.text();
-    let body;
-    try {
-      body = JSON.parse(text);
-    } catch {
-      throw new WorkflowsRestError(response.status, text);
-    }
-    if (!response.ok || body["success"] === false) {
-      throw new WorkflowsRestError(response.status, text);
-    }
-    return body;
-  };
-  return {
-    getInstance: async ({ instanceId, workflowName }) => {
-      const body = await request(`/${encodeURIComponent(workflowName)}/instances/${encodeURIComponent(instanceId)}`);
-      const result = body["result"] ?? {};
-      const steps = Array.isArray(result["steps"]) ? result["steps"] : [];
-      return {
-        ...toSummary(result),
-        error: result["error"],
-        output: result["output"],
-        params: result["params"],
-        steps: steps.map((step) => toStep(step))
-      };
-    },
-    listInstances: async ({ page, perPage, status, workflowName }) => {
-      const query = new URLSearchParams();
-      if (status !== void 0) {
-        query.set("status", status);
-      }
-      if (page !== void 0) {
-        query.set("page", String(page));
-      }
-      if (perPage !== void 0) {
-        query.set("per_page", String(perPage));
-      }
-      const suffix = query.toString() === "" ? "" : `?${query.toString()}`;
-      const body = await request(`/${encodeURIComponent(workflowName)}/instances${suffix}`);
-      const result = Array.isArray(body["result"]) ? body["result"] : [];
-      const info = body["result_info"] ?? {};
-      return {
-        instances: result.map((instance) => toSummary(instance)),
-        page: typeof info["page"] === "number" ? info["page"] : page ?? 1,
-        perPage: typeof info["per_page"] === "number" ? info["per_page"] : perPage ?? result.length,
-        totalCount: typeof info["total_count"] === "number" ? info["total_count"] : void 0
-      };
-    },
-    setInstanceStatus: async ({ action, instanceId, workflowName }) => {
-      const body = await request(`/${encodeURIComponent(workflowName)}/instances/${encodeURIComponent(instanceId)}`, {
-        body: JSON.stringify({ status: action }),
-        method: "PATCH"
-      });
-      const result = body["result"] ?? {};
-      return { status: toStatus(result["status"]) };
-    }
-  };
-};
-
-export { WorkflowsRestError, createWorkflowsRestClient };

package/dist/packem_shared/createRunStep-8jOXxP2o.mjs

@@ -1,54 +0,0 @@
-import { parseValidatorMap } from '@lunora/values';
-import { convertNonRetryableError, NonRetryableError } from './NonRetryableError-Dn2dTyBS.mjs';
-
-const validateStepArgs = (validators, source) => parseValidatorMap(validators, source, "step args");
-const createRunStep = (deps) => async (step, args, options) => {
-  const config = options?.config ?? step.config;
-  const validatedArgs = validateStepArgs(step.args, args);
-  const callback = async (nativeContext) => {
-    const stepContext = {
-      attempt: nativeContext.attempt,
-      config: nativeContext.config,
-      env: deps.env,
-      log: deps.log,
-      run: deps.run,
-      step: nativeContext.step
-    };
-    let result;
-    try {
-      result = await step.handler(stepContext, validatedArgs);
-    } catch (error) {
-      return convertNonRetryableError(error, deps.nonRetryableErrorClass);
-    }
-    if (!step.returns) {
-      return result;
-    }
-    try {
-      return step.returns.parse(result);
-    } catch (error) {
-      const message = error instanceof Error ? error.message : String(error);
-      const nonRetryable = new NonRetryableError(`step "${step.name}" returns validation failed: ${message}`);
-      if (error !== void 0) {
-        nonRetryable.cause = error;
-      }
-      return convertNonRetryableError(nonRetryable, deps.nonRetryableErrorClass);
-    }
-  };
-  const rollbackHandler = step.rollback;
-  const rollbackOptions = rollbackHandler ? {
-    rollback: async (rollbackContext) => {
-      await rollbackHandler({
-        args: validatedArgs,
-        env: deps.env,
-        error: rollbackContext.error,
-        log: deps.log,
-        output: rollbackContext.output,
-        run: deps.run
-      });
-    },
-    rollbackConfig: step.rollbackConfig
-  } : void 0;
-  return config === void 0 ? deps.step.do(step.name, callback, rollbackOptions) : deps.step.do(step.name, config, callback, rollbackOptions);
-};
-
-export { createRunStep, validateStepArgs };

package/dist/packem_shared/createWorkflowContext-oxZ5zj3x.mjs

@@ -1,14 +0,0 @@
-import createWorkflows from './createWorkflows-wq4fs72q.mjs';
-
-const createWorkflowContext = (env, specs) => {
-  const bindings = {};
-  for (const spec of specs) {
-    const binding = env[spec.binding];
-    if (binding && typeof binding.create === "function" && typeof binding.createBatch === "function" && typeof binding.get === "function") {
-      bindings[spec.exportName] = binding;
-    }
-  }
-  return createWorkflows({ bindings });
-};
-
-export { createWorkflowContext };

package/dist/packem_shared/createWorkflowRunContext-D62MbkFK.mjs

@@ -1,134 +0,0 @@
-import { LunoraError } from '@lunora/errors';
-import { workflowBindingName } from './defineWorkflow-DbUC-oCN.mjs';
-import { createSpawn, createParallel } from './MAX_BRANCHES-EO5xYS_3.mjs';
-import { createRunStep } from './createRunStep-8jOXxP2o.mjs';
-
-const createDispatchLogger = (prefix) => {
-  return {
-    debug: (message, ...rest) => {
-      console.debug(prefix, message, ...rest);
-    },
-    error: (message, ...rest) => {
-      console.error(prefix, message, ...rest);
-    },
-    info: (message, ...rest) => {
-      console.info(prefix, message, ...rest);
-    },
-    warn: (message, ...rest) => {
-      console.warn(prefix, message, ...rest);
-    }
-  };
-};
-
-const SCHEDULER_DISPATCH_PATH = "/_lunora/scheduler/dispatch";
-const trimTrailingSlashes = (value) => {
-  let end = value.length;
-  while (end > 0 && value[end - 1] === "/") {
-    end -= 1;
-  }
-  return value.slice(0, end);
-};
-const toDispatchError = (label, status, rawBody) => {
-  try {
-    const parsed = JSON.parse(rawBody);
-    const errorBody = parsed?.error;
-    if (typeof errorBody === "object" && errorBody !== null && typeof errorBody.code === "string") {
-      const { code, data, message } = errorBody;
-      return new LunoraError(code, typeof message === "string" ? message : void 0, { data, status });
-    }
-  } catch {
-  }
-  return new LunoraError("INTERNAL", `${label}: function dispatch failed (${String(status)}): ${rawBody}`, { status });
-};
-const createDispatchRunner = (options) => {
-  const { label } = options;
-  const globalFetch = globalThis.fetch;
-  const fetchImpl = options.fetchImpl ?? (typeof globalFetch === "function" ? globalFetch.bind(globalThis) : void 0);
-  return async (function_, args, runOptions = {}) => {
-    if (typeof fetchImpl !== "function") {
-      throw new TypeError(`${label}: no fetch implementation available — pass fetchImpl or run on a platform with global fetch`);
-    }
-    const origin = options.env.LUNORA_ORIGIN_URL;
-    if (typeof origin !== "string" || origin.length === 0) {
-      throw new LunoraError("INTERNAL", `${label}: \`LUNORA_ORIGIN_URL\` must be set on the Worker env so a handler can call back into Lunora functions`);
-    }
-    const token = options.env.LUNORA_ADMIN_TOKEN;
-    if (typeof token !== "string" || token.length === 0) {
-      throw new LunoraError("INTERNAL", `${label}: \`LUNORA_ADMIN_TOKEN\` must be set on the Worker env to authenticate function dispatch`);
-    }
-    const url = `${trimTrailingSlashes(origin)}${SCHEDULER_DISPATCH_PATH}`;
-    const headers = { authorization: `Bearer ${token}`, "content-type": "application/json" };
-    if (options.identity?.userId !== void 0) {
-      headers["x-lunora-userid"] = options.identity.userId;
-    }
-    if (options.identity?.claims !== void 0) {
-      headers["x-lunora-identity"] = JSON.stringify(options.identity.claims);
-    }
-    const response = await fetchImpl(url, {
-      body: JSON.stringify({ args: args ?? {}, functionPath: function_.__lunoraRef, shardKey: runOptions.shardKey }),
-      headers,
-      method: "POST"
-    });
-    if (!response.ok) {
-      throw toDispatchError(label, response.status, await response.text());
-    }
-    const text = await response.text();
-    if (text.length === 0) {
-      return void 0;
-    }
-    try {
-      return JSON.parse(text);
-    } catch {
-      throw new LunoraError("INTERNAL", `${label}: function dispatch returned a non-JSON body (${String(response.status)}): ${text}`, {
-        status: response.status
-      });
-    }
-  };
-};
-
-const createWorkflowRunContext = (options) => {
-  const log = createDispatchLogger(`[workflow:${options.exportName}]`);
-  const run = createDispatchRunner({ env: options.env, fetchImpl: options.fetchImpl, label: "@lunora/workflow" });
-  const resolveBinding = (workflow) => {
-    const bindingName = workflowBindingName(workflow);
-    const binding = options.env[bindingName];
-    if (!binding || typeof binding.create !== "function" || typeof binding.get !== "function") {
-      throw new LunoraError(
-        "INTERNAL",
-        `@lunora/workflow: cannot spawn child workflow "${workflow}" — no Workflow binding "${bindingName}" on env (is it declared in lunora/workflows.ts?)`
-      );
-    }
-    return binding;
-  };
-  let childCounter = 0;
-  const nextChildId = (explicit) => {
-    if (explicit !== void 0) {
-      return explicit;
-    }
-    const id = `${options.event.instanceId}-c${String(childCounter)}`;
-    childCounter += 1;
-    return id;
-  };
-  const fanOutDeps = {
-    env: options.env,
-    instanceId: options.event.instanceId,
-    log,
-    nextChildId,
-    parentBinding: workflowBindingName(options.exportName),
-    resolveBinding,
-    step: options.step
-  };
-  return {
-    env: options.env,
-    event: options.event,
-    log,
-    parallel: createParallel(fanOutDeps),
-    params: options.event.payload,
-    run,
-    runStep: createRunStep({ env: options.env, log, nonRetryableErrorClass: options.nonRetryableErrorClass, run, step: options.step }),
-    spawn: createSpawn(fanOutDeps),
-    step: options.step
-  };
-};
-
-export { createWorkflowRunContext };

package/dist/packem_shared/createWorkflows-wq4fs72q.mjs

@@ -1,40 +0,0 @@
-import { LunoraError } from '@lunora/errors';
-import { BRANCH_MARKER_KEY } from './MAX_BRANCHES-EO5xYS_3.mjs';
-
-const rejectReservedParams = (options) => {
-  const { params } = options ?? {};
-  if (params !== void 0 && Object.hasOwn(params, BRANCH_MARKER_KEY)) {
-    throw new LunoraError("BAD_REQUEST", `@lunora/workflow: params may not contain the reserved key "${BRANCH_MARKER_KEY}"`);
-  }
-};
-const handleFor = (binding) => {
-  return {
-    create: async (options) => {
-      rejectReservedParams(options);
-      return binding.create(options);
-    },
-    createBatch: async (batch) => {
-      for (const options of batch) {
-        rejectReservedParams(options);
-      }
-      return binding.createBatch(batch);
-    },
-    get: async (id) => binding.get(id)
-  };
-};
-const createWorkflows = (options) => {
-  const bindings = options.bindings ?? {};
-  return {
-    get: (name) => {
-      const binding = bindings[name];
-      if (binding === void 0) {
-        const known = Object.keys(bindings);
-        const suffix = known.length === 0 ? "no workflows are declared" : `known workflows: ${known.join(", ")}`;
-        throw new LunoraError("INTERNAL", `@lunora/workflow: no workflow named "${name}" (${suffix})`);
-      }
-      return handleFor(binding);
-    }
-  };
-};
-
-export { createWorkflows as default };

package/dist/packem_shared/defineStep-DJQtLw7g.mjs

@@ -1,28 +0,0 @@
-const defineStep = (name, config) => {
-  if (typeof name !== "string" || name.length === 0) {
-    throw new TypeError("defineStep: `name` must be a non-empty string (the durable step label)");
-  }
-  const declaredArgs = config.args;
-  if (typeof declaredArgs !== "object" || declaredArgs === null) {
-    throw new TypeError("defineStep: `args` must be a validator map (e.g. `{ id: v.string() }`)");
-  }
-  if (typeof config.handler !== "function") {
-    throw new TypeError("defineStep: `handler` must be a function (the step body)");
-  }
-  if (config.rollback !== void 0 && typeof config.rollback !== "function") {
-    throw new TypeError("defineStep: `rollback` must be a function when provided");
-  }
-  return {
-    args: config.args,
-    config: config.config,
-    handler: config.handler,
-    isLunoraStep: true,
-    name,
-    returns: config.returns,
-    rollback: config.rollback,
-    rollbackConfig: config.rollbackConfig
-  };
-};
-const isStepDefinition = (value) => typeof value === "object" && value !== null && value.isLunoraStep === true;
-
-export { defineStep, isStepDefinition };

package/dist/packem_shared/defineWorkflow-DbUC-oCN.mjs

@@ -1,15 +0,0 @@
-const workflowClassName = (exportName) => `${exportName.charAt(0).toUpperCase()}${exportName.slice(1)}Workflow`;
-const workflowBindingName = (exportName) => `WORKFLOW_${exportName.replaceAll(/(?<=[a-z0-9])(?=[A-Z])/g, "_").toUpperCase()}`;
-const workflowDefaultName = (exportName) => exportName.replaceAll(/(?<=[a-z0-9])(?=[A-Z])/g, "-").toLowerCase();
-const defineWorkflow = (config) => {
-  if (typeof config.handler !== "function") {
-    throw new TypeError("defineWorkflow: `handler` must be a function (the workflow body)");
-  }
-  if (config.name !== void 0 && (typeof config.name !== "string" || config.name.length === 0)) {
-    throw new TypeError("defineWorkflow: `name` must be a non-empty string when provided");
-  }
-  return { ...config, isLunoraWorkflow: true };
-};
-const isWorkflowDefinition = (value) => typeof value === "object" && value !== null && value.isLunoraWorkflow === true;
-
-export { defineWorkflow, isWorkflowDefinition, workflowBindingName, workflowClassName, workflowDefaultName };