@ironflow/node 0.1.0-test.2

package/README.md

@@ -0,0 +1,104 @@
+# @ironflow/node
+
+Node.js SDK for [Ironflow](https://github.com/anthropics/ironflow) workflow engine. Provides workers, serve handlers, and step execution for serverless and long-running functions.
+
+## Installation
+
+```bash
+npm install @ironflow/node
+```
+
+## Quick Start
+
+### Define a Function
+
+```typescript
+import { ironflow } from '@ironflow/node';
+
+const processOrder = ironflow.createFunction(
+  {
+    id: 'process-order',
+    triggers: [{ event: 'order.placed' }],
+  },
+  async ({ event, step }) => {
+    const validated = await step.run('validate', async () => {
+      return validateOrder(event.data);
+    });
+
+    await step.sleep('wait', '5m');
+
+    const result = await step.run('process', async () => {
+      return processPayment(validated);
+    });
+
+    return { success: true, receiptId: result.id };
+  }
+);
+```
+
+### Push Mode (Serverless)
+
+```typescript
+// app/api/ironflow/route.ts (Next.js App Router)
+import { serve } from '@ironflow/node';
+
+export const POST = serve({
+  functions: [processOrder],
+  signingKey: process.env.IRONFLOW_SIGNING_KEY,
+});
+```
+
+### Pull Mode (Worker)
+
+```typescript
+import { createWorker } from '@ironflow/node';
+
+const worker = createWorker({
+  serverUrl: 'http://localhost:9123',
+  functions: [processOrder],
+  maxConcurrentJobs: 4,
+});
+
+await worker.start();
+```
+
+## Features
+
+- **Durable step execution** with automatic memoization
+- **Push mode** for serverless (Next.js, Lambda, Vercel)
+- **Pull mode** for long-running workers (no timeout limits)
+- **Step primitives**: `run`, `sleep`, `sleepUntil`, `waitForEvent`, `parallel`, `map`
+- **Type-safe** API with full TypeScript support
+
+## Key APIs
+
+| API | Description |
+|-----|-------------|
+| `ironflow.createFunction(config, handler)` | Define a workflow function |
+| `serve({ functions })` | Create HTTP handler for push mode |
+| `createWorker({ functions })` | Create pull mode worker |
+| `step.run(id, fn)` | Execute memoized step |
+| `step.sleep(id, duration)` | Durable sleep |
+| `step.waitForEvent(id, options)` | Wait for external event |
+| `step.parallel(steps)` | Execute steps in parallel |
+| `step.map(id, items, fn)` | Map over items in parallel |
+
+## Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `IRONFLOW_SERVER_URL` | Server URL | `http://localhost:9123` |
+| `IRONFLOW_SIGNING_KEY` | Request signing key | - |
+| `IRONFLOW_LOG_LEVEL` | Log level | `info` |
+
+## Requirements
+
+- Node.js 22+
+
+## Documentation
+
+For the full API reference, see the [Node Package Documentation](https://ironflow.dev/docs/api-reference/js-sdk/node).
+
+## License
+
+MIT

package/dist/function.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Function definition helper for Ironflow workflows
+ */
+import type { FunctionConfig, FunctionHandler, IronflowFunction } from "@ironflow/core";
+import type { z } from "zod";
+/**
+ * Function definition helper with full type inference
+ *
+ * @example
+ * ```typescript
+ * import { ironflow } from "@ironflow/node";
+ * import { z } from "zod";
+ *
+ * const processOrder = ironflow.createFunction(
+ *   {
+ *     id: "process-order",
+ *     triggers: [{ event: "order.placed" }],
+ *     schema: z.object({
+ *       orderId: z.string(),
+ *       amount: z.number(),
+ *     }),
+ *   },
+ *   async ({ event, step }) => {
+ *     // event.data is typed as { orderId: string, amount: number }
+ *     const result = await step.run("process", async () => {
+ *       return { processed: true };
+ *     });
+ *     return result;
+ *   }
+ * );
+ * ```
+ */
+export declare function createFunction<TEventSchema extends z.ZodType = z.ZodType<unknown>, TResult = unknown>(config: FunctionConfig<TEventSchema>, handler: FunctionHandler<z.infer<TEventSchema>, TResult>): IronflowFunction<z.infer<TEventSchema>, TResult>;
+/**
+ * Ironflow function factory singleton
+ *
+ * @example
+ * ```typescript
+ * import { ironflow } from "@ironflow/node";
+ *
+ * const myFunction = ironflow.createFunction(
+ *   { id: "my-function", triggers: [{ event: "my.event" }] },
+ *   async ({ event, step }) => {
+ *     // ...
+ *   }
+ * );
+ * ```
+ */
+export declare const ironflow: {
+    createFunction: typeof createFunction;
+};
+export default ironflow;
+//# sourceMappingURL=function.d.ts.map

package/dist/function.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"function.d.ts","sourceRoot":"","sources":["../src/function.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EACf,gBAAgB,EACjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,cAAc,CAC5B,YAAY,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,EACnD,OAAO,GAAG,OAAO,EAEjB,MAAM,EAAE,cAAc,CAAC,YAAY,CAAC,EACpC,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC,GACvD,gBAAgB,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC,CAKlD;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,QAAQ;;CAEpB,CAAC;AAEF,eAAe,QAAQ,CAAC"}

package/dist/function.js

@@ -0,0 +1,56 @@
+/**
+ * Function definition helper for Ironflow workflows
+ */
+/**
+ * Function definition helper with full type inference
+ *
+ * @example
+ * ```typescript
+ * import { ironflow } from "@ironflow/node";
+ * import { z } from "zod";
+ *
+ * const processOrder = ironflow.createFunction(
+ *   {
+ *     id: "process-order",
+ *     triggers: [{ event: "order.placed" }],
+ *     schema: z.object({
+ *       orderId: z.string(),
+ *       amount: z.number(),
+ *     }),
+ *   },
+ *   async ({ event, step }) => {
+ *     // event.data is typed as { orderId: string, amount: number }
+ *     const result = await step.run("process", async () => {
+ *       return { processed: true };
+ *     });
+ *     return result;
+ *   }
+ * );
+ * ```
+ */
+export function createFunction(config, handler) {
+    return {
+        config,
+        handler,
+    };
+}
+/**
+ * Ironflow function factory singleton
+ *
+ * @example
+ * ```typescript
+ * import { ironflow } from "@ironflow/node";
+ *
+ * const myFunction = ironflow.createFunction(
+ *   { id: "my-function", triggers: [{ event: "my.event" }] },
+ *   async ({ event, step }) => {
+ *     // ...
+ *   }
+ * );
+ * ```
+ */
+export const ironflow = {
+    createFunction,
+};
+export default ironflow;
+//# sourceMappingURL=function.js.map

package/dist/function.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"function.js","sourceRoot":"","sources":["../src/function.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,cAAc,CAI5B,MAAoC,EACpC,OAAwD;IAExD,OAAO;QACL,MAAM;QACN,OAAO;KAC4C,CAAC;AACxD,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,cAAc;CACf,CAAC;AAEF,eAAe,QAAQ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,56 @@
+/**
+ * @ironflow/node
+ *
+ * Node.js SDK for Ironflow workflow engine.
+ * Provides workers, serve handlers, and step execution for serverless and long-running functions.
+ *
+ * @example
+ * ```typescript
+ * // Define a workflow function
+ * import { ironflow } from "@ironflow/node";
+ *
+ * const processOrder = ironflow.createFunction(
+ *   {
+ *     id: "process-order",
+ *     triggers: [{ event: "order.placed" }],
+ *   },
+ *   async ({ event, step }) => {
+ *     const result = await step.run("process", async () => {
+ *       return { processed: true };
+ *     });
+ *     return result;
+ *   }
+ * );
+ *
+ * // Push mode (serverless)
+ * import { serve } from "@ironflow/node/serve";
+ * export const POST = serve({ functions: [processOrder] });
+ *
+ * // Pull mode (worker)
+ * import { createWorker } from "@ironflow/node/worker";
+ * const worker = createWorker({
+ *   serverUrl: "http://localhost:9123",
+ *   functions: [processOrder],
+ * });
+ * await worker.start();
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { ironflow, createFunction } from "./function.js";
+export { serve, createHandler } from "./serve.js";
+export { createWorker, createStreamingWorker } from "./worker.js";
+export type { ServeConfig, HandlerOptions, HandlerContext, WorkerConfig, Worker, CreateFunctionConfig, } from "./types.js";
+export type { Branded, RunId, FunctionId, StepId, EventId, JobId, WorkerId, SubscriptionId, FunctionConfig, FunctionContext, FunctionHandler, IronflowFunction, Trigger, RetryConfig, ConcurrencyConfig, ExecutionMode, IronflowEvent, EventFilter, StepClient, Duration, ParallelOptions, RunInfo, Run, RunStatus, ListRunsOptions, ListRunsResult, TriggerResult, TriggerSyncOptions, TriggerSyncResult, EmitOptions, EmitResult, Logger, PushRequest, PushResponse, CompletedStep, ResumeContext, StepResult, YieldInfo, SleepYield, WaitEventYield, } from "@ironflow/core";
+export { createRunId, createFunctionId, createStepId, createEventId, createJobId, createWorkerId, createSubscriptionId, } from "@ironflow/core";
+export { IronflowError, StepError, TimeoutError, ValidationError, SchemaValidationError, SignatureError, FunctionNotFoundError, RunNotFoundError, NonRetryableError, isRetryable, isIronflowError, } from "@ironflow/core";
+export { parseDuration, calculateBackoff, sleep, generateId, createLogger, createNoopLogger, type LogLevel, type LoggerConfig, } from "@ironflow/core";
+export { DEFAULT_PORT, DEFAULT_HOST, DEFAULT_SERVER_URL, DEFAULT_TIMEOUTS, DEFAULT_RETRY, DEFAULT_WORKER, ENV_VARS, getServerUrl, } from "@ironflow/core";
+export { PushRequestSchema, RunStatusSchema, parseAndValidate, validate, } from "@ironflow/core";
+declare const _default: {
+    ironflow: {
+        createFunction: typeof import("./function.js").createFunction;
+    };
+};
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAIH,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAGlE,YAAY,EACV,WAAW,EACX,cAAc,EACd,cAAc,EACd,YAAY,EACZ,MAAM,EACN,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAGpB,YAAY,EAEV,OAAO,EACP,KAAK,EACL,UAAU,EACV,MAAM,EACN,OAAO,EACP,KAAK,EACL,QAAQ,EACR,cAAc,EAGd,cAAc,EACd,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,OAAO,EACP,WAAW,EACX,iBAAiB,EACjB,aAAa,EAGb,aAAa,EACb,WAAW,EAGX,UAAU,EACV,QAAQ,EACR,eAAe,EAGf,OAAO,EACP,GAAG,EACH,SAAS,EACT,eAAe,EACf,cAAc,EAGd,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EAGjB,WAAW,EACX,UAAU,EAGV,MAAM,EAGN,WAAW,EACX,YAAY,EACZ,aAAa,EACb,aAAa,EACb,UAAU,EACV,SAAS,EACT,UAAU,EACV,cAAc,GACf,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,WAAW,EACX,cAAc,EACd,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,aAAa,EACb,SAAS,EACT,YAAY,EACZ,eAAe,EACf,qBAAqB,EACrB,cAAc,EACd,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACX,eAAe,GAChB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,KAAK,EACL,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,KAAK,QAAQ,EACb,KAAK,YAAY,GAClB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,QAAQ,EACR,YAAY,GACb,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,QAAQ,GACT,MAAM,gBAAgB,CAAC;;;;;;AAGxB,wBAA4B"}

package/dist/index.js

@@ -0,0 +1,57 @@
+/**
+ * @ironflow/node
+ *
+ * Node.js SDK for Ironflow workflow engine.
+ * Provides workers, serve handlers, and step execution for serverless and long-running functions.
+ *
+ * @example
+ * ```typescript
+ * // Define a workflow function
+ * import { ironflow } from "@ironflow/node";
+ *
+ * const processOrder = ironflow.createFunction(
+ *   {
+ *     id: "process-order",
+ *     triggers: [{ event: "order.placed" }],
+ *   },
+ *   async ({ event, step }) => {
+ *     const result = await step.run("process", async () => {
+ *       return { processed: true };
+ *     });
+ *     return result;
+ *   }
+ * );
+ *
+ * // Push mode (serverless)
+ * import { serve } from "@ironflow/node/serve";
+ * export const POST = serve({ functions: [processOrder] });
+ *
+ * // Pull mode (worker)
+ * import { createWorker } from "@ironflow/node/worker";
+ * const worker = createWorker({
+ *   serverUrl: "http://localhost:9123",
+ *   functions: [processOrder],
+ * });
+ * await worker.start();
+ * ```
+ *
+ * @packageDocumentation
+ */
+// Main exports
+import { ironflow } from "./function.js";
+export { ironflow, createFunction } from "./function.js";
+export { serve, createHandler } from "./serve.js";
+export { createWorker, createStreamingWorker } from "./worker.js";
+// Re-export branded ID creators
+export { createRunId, createFunctionId, createStepId, createEventId, createJobId, createWorkerId, createSubscriptionId, } from "@ironflow/core";
+// Re-export errors
+export { IronflowError, StepError, TimeoutError, ValidationError, SchemaValidationError, SignatureError, FunctionNotFoundError, RunNotFoundError, NonRetryableError, isRetryable, isIronflowError, } from "@ironflow/core";
+// Re-export utilities
+export { parseDuration, calculateBackoff, sleep, generateId, createLogger, createNoopLogger, } from "@ironflow/core";
+// Re-export constants
+export { DEFAULT_PORT, DEFAULT_HOST, DEFAULT_SERVER_URL, DEFAULT_TIMEOUTS, DEFAULT_RETRY, DEFAULT_WORKER, ENV_VARS, getServerUrl, } from "@ironflow/core";
+// Re-export schemas for advanced usage
+export { PushRequestSchema, RunStatusSchema, parseAndValidate, validate, } from "@ironflow/core";
+// Default export
+export default { ironflow };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,eAAe;AACf,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAyElE,gCAAgC;AAChC,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,WAAW,EACX,cAAc,EACd,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AAExB,mBAAmB;AACnB,OAAO,EACL,aAAa,EACb,SAAS,EACT,YAAY,EACZ,eAAe,EACf,qBAAqB,EACrB,cAAc,EACd,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACX,eAAe,GAChB,MAAM,gBAAgB,CAAC;AAExB,sBAAsB;AACtB,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,KAAK,EACL,UAAU,EACV,YAAY,EACZ,gBAAgB,GAGjB,MAAM,gBAAgB,CAAC;AAExB,sBAAsB;AACtB,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,QAAQ,EACR,YAAY,GACb,MAAM,gBAAgB,CAAC;AAExB,uCAAuC;AACvC,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,QAAQ,GACT,MAAM,gBAAgB,CAAC;AAExB,iBAAiB;AACjB,eAAe,EAAE,QAAQ,EAAE,CAAC"}

package/dist/internal/context.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Internal Execution Context
+ *
+ * Manages step memoization and resume state during function execution.
+ */
+import type { IronflowEvent, Logger, RunInfo, PushRequest, CompletedStep, StepResult } from "@ironflow/core";
+/**
+ * Execution context for a function invocation
+ */
+export declare class ExecutionContext {
+    /** The run ID */
+    readonly runId: string;
+    /** The function ID */
+    readonly functionId: string;
+    /** Current attempt number */
+    readonly attempt: number;
+    /** The triggering event */
+    readonly event: IronflowEvent;
+    /** Run information */
+    readonly runInfo: RunInfo;
+    /** Logger instance */
+    readonly logger: Logger;
+    /** Step counters for generating unique step IDs */
+    private stepCounters;
+    /** Completed steps from previous execution (memoized) */
+    private completedSteps;
+    /** Steps executed in this invocation */
+    private executedSteps;
+    /** Resume context for sleep/waitForEvent */
+    private resumeContext?;
+    /** Whether we've processed the resume */
+    private resumeProcessed;
+    constructor(request: PushRequest, logger?: Logger);
+    /**
+     * Generate a unique step ID
+     */
+    generateStepId(name: string): string;
+    /**
+     * Create a scoped context for a parallel branch
+     */
+    createBranchContext(parallelName: string, branchIndex: number): BranchContext;
+    /**
+     * Check if a step is already completed (memoized)
+     */
+    getCompletedStep(stepId: string): CompletedStep | undefined;
+    /**
+     * Check if we should skip step execution due to memoization
+     */
+    shouldSkipStep(stepId: string): boolean;
+    /**
+     * Get the memoized output for a step
+     */
+    getMemoizedOutput<T>(stepId: string): T | undefined;
+    /**
+     * Check if we're resuming from a specific step
+     */
+    isResumingFrom(stepId: string, type: "sleep" | "wait_for_event"): boolean;
+    /**
+     * Get the resume data (for waitForEvent)
+     */
+    getResumeData<T>(): T | undefined;
+    /**
+     * Mark the resume as processed
+     */
+    markResumeProcessed(): void;
+    /**
+     * Check if the resume has been processed
+     */
+    hasResumeBeenProcessed(): boolean;
+    /**
+     * Record a step execution result
+     */
+    recordStep(step: StepResult): void;
+    /**
+     * Get all steps executed in this invocation
+     */
+    getExecutedSteps(): StepResult[];
+}
+/**
+ * A scoped context for parallel branch execution
+ */
+export declare class BranchContext {
+    private readonly parent;
+    private readonly scopePrefix;
+    private stepCounters;
+    get logger(): Logger;
+    get runId(): string;
+    constructor(parent: ExecutionContext, scopePrefix: string);
+    generateStepId(name: string): string;
+    shouldSkipStep(stepId: string): boolean;
+    getMemoizedOutput<T>(stepId: string): T | undefined;
+    isResumingFrom(stepId: string, type: "sleep" | "wait_for_event"): boolean;
+    getResumeData<T>(): T | undefined;
+    markResumeProcessed(): void;
+    recordStep(step: StepResult): void;
+    createBranchContext(parallelName: string, branchIndex: number): BranchContext;
+}
+//# sourceMappingURL=context.d.ts.map

package/dist/internal/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/internal/context.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,MAAM,EACN,OAAO,EACP,WAAW,EACX,aAAa,EAEb,UAAU,EACX,MAAM,gBAAgB,CAAC;AAExB;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,iBAAiB;IACjB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,sBAAsB;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,6BAA6B;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,2BAA2B;IAC3B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,sBAAsB;IACtB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,sBAAsB;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,mDAAmD;IACnD,OAAO,CAAC,YAAY,CAAkC;IACtD,yDAAyD;IACzD,OAAO,CAAC,cAAc,CAAyC;IAC/D,wCAAwC;IACxC,OAAO,CAAC,aAAa,CAAoB;IACzC,4CAA4C;IAC5C,OAAO,CAAC,aAAa,CAAC,CAAgB;IACtC,yCAAyC;IACzC,OAAO,CAAC,eAAe,CAAS;gBAEpB,OAAO,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,MAAM;IAoCjD;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAMpC;;OAEG;IACH,mBAAmB,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,aAAa;IAK7E;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAI3D;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAKvC;;OAEG;IACH,iBAAiB,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAQnD;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,gBAAgB,GAAG,OAAO;IASzE;;OAEG;IACH,aAAa,CAAC,CAAC,KAAK,CAAC,GAAG,SAAS;IAIjC;;OAEG;IACH,mBAAmB,IAAI,IAAI;IAI3B;;OAEG;IACH,sBAAsB,IAAI,OAAO;IAIjC;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAIlC;;OAEG;IACH,gBAAgB,IAAI,UAAU,EAAE;CAGjC;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,YAAY,CAAkC;IAEtD,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,KAAK,IAAI,MAAM,CAElB;gBAEW,MAAM,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM;IAKzD,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAMpC,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAIvC,iBAAiB,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAInD,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,gBAAgB,GAAG,OAAO;IAIzE,aAAa,CAAC,CAAC,KAAK,CAAC,GAAG,SAAS;IAIjC,mBAAmB,IAAI,IAAI;IAI3B,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAIlC,mBAAmB,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,aAAa;CAI9E"}

package/dist/internal/context.js

@@ -0,0 +1,211 @@
+/**
+ * Internal Execution Context
+ *
+ * Manages step memoization and resume state during function execution.
+ */
+/**
+ * Execution context for a function invocation
+ */
+export class ExecutionContext {
+    /** The run ID */
+    runId;
+    /** The function ID */
+    functionId;
+    /** Current attempt number */
+    attempt;
+    /** The triggering event */
+    event;
+    /** Run information */
+    runInfo;
+    /** Logger instance */
+    logger;
+    /** Step counters for generating unique step IDs */
+    stepCounters = new Map();
+    /** Completed steps from previous execution (memoized) */
+    completedSteps = new Map();
+    /** Steps executed in this invocation */
+    executedSteps = [];
+    /** Resume context for sleep/waitForEvent */
+    resumeContext;
+    /** Whether we've processed the resume */
+    resumeProcessed = false;
+    constructor(request, logger) {
+        this.runId = request.run_id;
+        this.functionId = request.function_id;
+        this.attempt = request.attempt;
+        // Parse event
+        this.event = {
+            id: request.event.id,
+            name: request.event.name,
+            data: request.event.data,
+            timestamp: new Date(request.event.timestamp),
+            idempotencyKey: request.event.idempotency_key,
+            source: request.event.source,
+            metadata: request.event.metadata,
+        };
+        // Build run info
+        this.runInfo = {
+            id: this.runId,
+            functionId: this.functionId,
+            attempt: this.attempt,
+            startedAt: new Date(),
+        };
+        // Store completed steps for memoization
+        for (const step of request.steps) {
+            this.completedSteps.set(step.id, step);
+        }
+        // Store resume context
+        this.resumeContext = request.resume;
+        // Use provided logger or create default
+        this.logger = logger ?? createDefaultLogger(this.runId);
+    }
+    /**
+     * Generate a unique step ID
+     */
+    generateStepId(name) {
+        const index = this.stepCounters.get(name) ?? 0;
+        this.stepCounters.set(name, index + 1);
+        return `${this.runId}:${name}:${index}`;
+    }
+    /**
+     * Create a scoped context for a parallel branch
+     */
+    createBranchContext(parallelName, branchIndex) {
+        const scopePrefix = `${this.runId}:${parallelName}:${branchIndex}`;
+        return new BranchContext(this, scopePrefix);
+    }
+    /**
+     * Check if a step is already completed (memoized)
+     */
+    getCompletedStep(stepId) {
+        return this.completedSteps.get(stepId);
+    }
+    /**
+     * Check if we should skip step execution due to memoization
+     */
+    shouldSkipStep(stepId) {
+        const completed = this.completedSteps.get(stepId);
+        return completed?.status === "completed";
+    }
+    /**
+     * Get the memoized output for a step
+     */
+    getMemoizedOutput(stepId) {
+        const completed = this.completedSteps.get(stepId);
+        if (completed?.status === "completed") {
+            return completed.output;
+        }
+        return undefined;
+    }
+    /**
+     * Check if we're resuming from a specific step
+     */
+    isResumingFrom(stepId, type) {
+        if (!this.resumeContext) {
+            return false;
+        }
+        return (this.resumeContext.step_id === stepId && this.resumeContext.type === type);
+    }
+    /**
+     * Get the resume data (for waitForEvent)
+     */
+    getResumeData() {
+        return this.resumeContext?.data;
+    }
+    /**
+     * Mark the resume as processed
+     */
+    markResumeProcessed() {
+        this.resumeProcessed = true;
+    }
+    /**
+     * Check if the resume has been processed
+     */
+    hasResumeBeenProcessed() {
+        return this.resumeProcessed;
+    }
+    /**
+     * Record a step execution result
+     */
+    recordStep(step) {
+        this.executedSteps.push(step);
+    }
+    /**
+     * Get all steps executed in this invocation
+     */
+    getExecutedSteps() {
+        return [...this.executedSteps];
+    }
+}
+/**
+ * A scoped context for parallel branch execution
+ */
+export class BranchContext {
+    parent;
+    scopePrefix;
+    stepCounters = new Map();
+    get logger() {
+        return this.parent.logger;
+    }
+    get runId() {
+        return this.parent.runId;
+    }
+    constructor(parent, scopePrefix) {
+        this.parent = parent;
+        this.scopePrefix = scopePrefix;
+    }
+    generateStepId(name) {
+        const index = this.stepCounters.get(name) ?? 0;
+        this.stepCounters.set(name, index + 1);
+        return `${this.scopePrefix}:${name}:${index}`;
+    }
+    shouldSkipStep(stepId) {
+        return this.parent.shouldSkipStep(stepId);
+    }
+    getMemoizedOutput(stepId) {
+        return this.parent.getMemoizedOutput(stepId);
+    }
+    isResumingFrom(stepId, type) {
+        return this.parent.isResumingFrom(stepId, type);
+    }
+    getResumeData() {
+        return this.parent.getResumeData();
+    }
+    markResumeProcessed() {
+        this.parent.markResumeProcessed();
+    }
+    recordStep(step) {
+        this.parent.recordStep(step);
+    }
+    createBranchContext(parallelName, branchIndex) {
+        const nestedPrefix = `${this.scopePrefix}:${parallelName}:${branchIndex}`;
+        return new BranchContext(this.parent, nestedPrefix);
+    }
+}
+/**
+ * Create a default logger that logs to console
+ */
+function createDefaultLogger(runId) {
+    const prefix = `[ironflow:${runId.slice(-8)}]`;
+    return {
+        debug(message, data) {
+            if (process.env["IRONFLOW_DEBUG"]) {
+                // eslint-disable-next-line no-console
+                console.debug(prefix, message, data ?? "");
+            }
+        },
+        info(message, data) {
+            // eslint-disable-next-line no-console
+            console.info(prefix, message, data ?? "");
+        },
+        warn(message, data) {
+            // eslint-disable-next-line no-console
+            console.warn(prefix, message, data ?? "");
+        },
+        error(message, data) {
+            // eslint-disable-next-line no-console
+            console.error(prefix, message, data ?? "");
+        },
+    };
+}
+//# sourceMappingURL=context.js.map

package/dist/internal/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/internal/context.ts"],"names":[],"mappings":"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"}