@ironflow/node 0.1.0-test.2

package/dist/step.js

@@ -0,0 +1,325 @@
+/**
+ * Step Execution Client
+ *
+ * Implements durable step primitives: run, sleep, sleepUntil, waitForEvent, parallel, map
+ */
+import { StepError, isRetryable, parseDuration } from "@ironflow/core";
+import { BranchContext } from "./internal/context.js";
+import { YieldSignal, } from "./internal/errors.js";
+/**
+ * Create a step client for the given execution context
+ */
+export function createStepClient(ctx) {
+    return createStepClientInternal(ctx);
+}
+/**
+ * Internal step client creation that works with any StepContext
+ */
+function createStepClientInternal(ctx) {
+    return {
+        run: (name, fn) => executeStep(ctx, name, fn),
+        sleep: (name, duration) => executeSleep(ctx, name, duration),
+        sleepUntil: (name, until) => executeSleepUntil(ctx, name, until),
+        waitForEvent: (name, filter) => executeWaitForEvent(ctx, name, filter),
+        parallel: (name, branches, options) => executeParallel(ctx, name, branches, options),
+        map: (name, items, fn, options) => executeMap(ctx, name, items, fn, options),
+    };
+}
+/**
+ * Execute a step with memoization
+ */
+async function executeStep(ctx, name, fn) {
+    const stepId = ctx.generateStepId(name);
+    // Check if step is already completed (memoized)
+    if (ctx.shouldSkipStep(stepId)) {
+        ctx.logger.debug(`Step memoized: ${name}`, { stepId });
+        return ctx.getMemoizedOutput(stepId);
+    }
+    // Execute the step
+    const startedAt = new Date();
+    ctx.logger.debug(`Step starting: ${name}`, { stepId });
+    try {
+        const output = await fn();
+        const endedAt = new Date();
+        const durationMs = endedAt.getTime() - startedAt.getTime();
+        // Record successful step
+        const result = {
+            id: stepId,
+            name,
+            type: "invoke",
+            status: "completed",
+            started_at: startedAt.toISOString(),
+            ended_at: endedAt.toISOString(),
+            duration_ms: durationMs,
+            output,
+        };
+        ctx.recordStep(result);
+        ctx.logger.debug(`Step completed: ${name}`, { stepId, durationMs });
+        return output;
+    }
+    catch (error) {
+        const endedAt = new Date();
+        const durationMs = endedAt.getTime() - startedAt.getTime();
+        // Re-throw YieldSignal (it's not a real error)
+        if (error instanceof YieldSignal) {
+            throw error;
+        }
+        // Record failed step
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        const errorStack = error instanceof Error ? error.stack : undefined;
+        const result = {
+            id: stepId,
+            name,
+            type: "invoke",
+            status: "failed",
+            started_at: startedAt.toISOString(),
+            ended_at: endedAt.toISOString(),
+            duration_ms: durationMs,
+            error: {
+                message: errorMessage,
+                retryable: isRetryable(error),
+                stack: errorStack,
+            },
+        };
+        ctx.recordStep(result);
+        ctx.logger.error(`Step failed: ${name}`, {
+            stepId,
+            error: errorMessage,
+            durationMs,
+        });
+        // Wrap in StepError for better context
+        throw new StepError(errorMessage, {
+            stepId,
+            stepName: name,
+            retryable: isRetryable(error),
+            cause: error instanceof Error ? error : undefined,
+        });
+    }
+}
+/**
+ * Execute a durable sleep
+ */
+async function executeSleep(ctx, name, duration) {
+    const stepId = ctx.generateStepId(name);
+    // Check if resuming from this sleep
+    if (ctx.isResumingFrom(stepId, "sleep")) {
+        ctx.logger.debug(`Sleep resumed: ${name}`, { stepId });
+        ctx.markResumeProcessed();
+        return;
+    }
+    // Check if step is already completed (memoized)
+    if (ctx.shouldSkipStep(stepId)) {
+        ctx.logger.debug(`Sleep memoized: ${name}`, { stepId });
+        return;
+    }
+    // Calculate wake time
+    const ms = parseDuration(duration);
+    const wakeAt = new Date(Date.now() + ms);
+    ctx.logger.debug(`Sleep yielding: ${name}`, {
+        stepId,
+        duration,
+        wakeAt: wakeAt.toISOString(),
+    });
+    // Throw yield signal to pause execution
+    const yieldInfo = {
+        step_id: stepId,
+        type: "sleep",
+        until: wakeAt.toISOString(),
+    };
+    throw new YieldSignal(yieldInfo);
+}
+/**
+ * Execute a durable sleep until a specific time
+ */
+async function executeSleepUntil(ctx, name, until) {
+    const stepId = ctx.generateStepId(name);
+    // Check if resuming from this sleep
+    if (ctx.isResumingFrom(stepId, "sleep")) {
+        ctx.logger.debug(`SleepUntil resumed: ${name}`, { stepId });
+        ctx.markResumeProcessed();
+        return;
+    }
+    // Check if step is already completed (memoized)
+    if (ctx.shouldSkipStep(stepId)) {
+        ctx.logger.debug(`SleepUntil memoized: ${name}`, { stepId });
+        return;
+    }
+    // Parse the target time
+    const wakeAt = typeof until === "string" ? new Date(until) : until;
+    // Validate the date
+    if (isNaN(wakeAt.getTime())) {
+        throw new Error(`Invalid date for sleepUntil: ${until}`);
+    }
+    ctx.logger.debug(`SleepUntil yielding: ${name}`, {
+        stepId,
+        until: wakeAt.toISOString(),
+    });
+    // Throw yield signal to pause execution
+    const yieldInfo = {
+        step_id: stepId,
+        type: "sleep",
+        until: wakeAt.toISOString(),
+    };
+    throw new YieldSignal(yieldInfo);
+}
+/**
+ * Execute a durable wait for event
+ */
+async function executeWaitForEvent(ctx, name, filter) {
+    const stepId = ctx.generateStepId(name);
+    // Check if resuming from this wait with the event data
+    if (ctx.isResumingFrom(stepId, "wait_for_event")) {
+        ctx.logger.debug(`WaitForEvent resumed: ${name}`, { stepId });
+        ctx.markResumeProcessed();
+        // The resume data contains the event that matched
+        const resumeData = ctx.getResumeData();
+        if (resumeData) {
+            return resumeData;
+        }
+    }
+    // Check if step is already completed (memoized)
+    if (ctx.shouldSkipStep(stepId)) {
+        ctx.logger.debug(`WaitForEvent memoized: ${name}`, { stepId });
+        const output = ctx.getMemoizedOutput(stepId);
+        if (output) {
+            return output;
+        }
+    }
+    ctx.logger.debug(`WaitForEvent yielding: ${name}`, { stepId, filter });
+    // Convert duration to string
+    const timeout = filter.timeout
+        ? typeof filter.timeout === "string"
+            ? filter.timeout
+            : durationToString(filter.timeout)
+        : "7d";
+    // Throw yield signal to pause execution
+    const yieldInfo = {
+        step_id: stepId,
+        type: "wait_for_event",
+        event_filter: {
+            event: filter.event,
+            match: filter.match,
+            timeout,
+        },
+    };
+    throw new YieldSignal(yieldInfo);
+}
+/**
+ * Execute multiple branches in parallel
+ */
+async function executeParallel(ctx, name, branches, options = {}) {
+    const { concurrency, onError = "failFast" } = options;
+    ctx.logger.debug(`Starting parallel execution: ${name}`, {
+        branchCount: branches.length,
+        concurrency,
+        onError,
+    });
+    const results = new Array(branches.length);
+    let firstError = null;
+    let yieldSignal = null;
+    const cancelled = { value: false };
+    // Pre-create branch contexts and step clients for each branch
+    const branchStepClients = branches.map((_, index) => {
+        const branchCtx = ctx.createBranchContext(name, index);
+        return createStepClientInternal(branchCtx);
+    });
+    const executeBranch = async (index) => {
+        if (cancelled.value && onError === "failFast")
+            return;
+        try {
+            const scopedStep = branchStepClients[index];
+            const branchFn = branches[index];
+            const result = await branchFn(scopedStep);
+            results[index] = result;
+        }
+        catch (error) {
+            if (error instanceof YieldSignal) {
+                yieldSignal = error;
+                cancelled.value = true;
+            }
+            else {
+                const err = error instanceof Error ? error : new Error(String(error));
+                results[index] = err;
+                if (onError === "failFast" && !firstError) {
+                    firstError = err;
+                    cancelled.value = true;
+                }
+            }
+        }
+    };
+    // Execute with optional concurrency limit
+    if (concurrency && concurrency > 0) {
+        const pending = [];
+        for (let i = 0; i < branches.length; i++) {
+            if (cancelled.value && onError === "failFast")
+                break;
+            if (pending.length >= concurrency) {
+                await Promise.race(pending);
+            }
+            const promise = executeBranch(i).finally(() => {
+                const idx = pending.indexOf(promise);
+                if (idx !== -1)
+                    pending.splice(idx, 1);
+            });
+            pending.push(promise);
+        }
+        await Promise.all(pending);
+    }
+    else {
+        await Promise.all(branches.map((_, i) => executeBranch(i)));
+    }
+    // Handle yield signal
+    if (yieldSignal) {
+        throw yieldSignal;
+    }
+    // Handle errors based on mode
+    if (onError === "failFast" && firstError) {
+        throw firstError;
+    }
+    if (onError !== "allSettled") {
+        const errorIndex = results.findIndex((r) => r instanceof Error);
+        if (errorIndex !== -1) {
+            throw results[errorIndex];
+        }
+    }
+    ctx.logger.debug(`Parallel execution completed: ${name}`, {
+        successCount: results.filter((r) => !(r instanceof Error)).length,
+        errorCount: results.filter((r) => r instanceof Error).length,
+    });
+    return results;
+}
+/**
+ * Map over items with parallel execution
+ */
+async function executeMap(ctx, name, items, fn, options = {}) {
+    ctx.logger.debug(`Starting map execution: ${name}`, {
+        itemCount: items.length,
+        options,
+    });
+    const branches = items.map((item, index) => {
+        return async (step) => {
+            return await fn(item, step, index);
+        };
+    });
+    return executeParallel(ctx, name, branches, options);
+}
+/**
+ * Convert a duration to a string representation
+ */
+function durationToString(duration) {
+    const ms = duration;
+    const seconds = Math.floor(ms / 1000);
+    const minutes = Math.floor(seconds / 60);
+    const hours = Math.floor(minutes / 60);
+    const days = Math.floor(hours / 24);
+    if (days > 0)
+        return `${days}d`;
+    if (hours > 0)
+        return `${hours}h`;
+    if (minutes > 0)
+        return `${minutes}m`;
+    if (seconds > 0)
+        return `${seconds}s`;
+    return `${ms}ms`;
+}
+//# sourceMappingURL=step.js.map

package/dist/step.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Node.js-specific type definitions
+ */
+import type { IronflowFunction, Logger, FunctionConfig } from "@ironflow/core";
+/**
+ * Configuration for the serve handler
+ */
+export interface ServeConfig {
+    /** Functions to serve */
+    functions: IronflowFunction[];
+    /** Signing key for webhook verification */
+    signingKey?: string;
+    /** Skip signature verification (dev only) */
+    skipVerification?: boolean;
+    /** Logger instance (or false to disable) */
+    logger?: Logger | false;
+}
+/**
+ * Handler options for incoming requests
+ */
+export interface HandlerOptions {
+    /** Override signing key per-request */
+    signingKey?: string;
+}
+/**
+ * Context available in the handler
+ */
+export interface HandlerContext {
+    /** Raw request body */
+    rawBody: string;
+    /** Signature from headers */
+    signature?: string;
+}
+/**
+ * Configuration for pull mode worker
+ */
+export interface WorkerConfig {
+    /** Ironflow server URL */
+    serverUrl?: string;
+    /** Functions this worker handles */
+    functions: IronflowFunction[];
+    /** Maximum concurrent jobs (default: 10) */
+    maxConcurrentJobs?: number;
+    /** Heartbeat interval in ms (default: 30000) */
+    heartbeatInterval?: number;
+    /** Reconnect delay in ms (default: 5000) */
+    reconnectDelay?: number;
+    /** Worker labels for routing */
+    labels?: Record<string, string>;
+    /** Transport type: "polling" or "streaming" */
+    transport?: "polling" | "streaming";
+    /** Logger instance (or false to disable) */
+    logger?: Logger | false;
+}
+/**
+ * Worker instance interface
+ */
+export interface Worker {
+    /** Start the worker (blocks until stopped) */
+    start(): Promise<void>;
+    /** Gracefully drain and stop */
+    drain(): Promise<void>;
+    /** Force stop immediately */
+    stop(): void;
+}
+/**
+ * Create function configuration helper
+ */
+export interface CreateFunctionConfig<TEvent = unknown> extends Omit<FunctionConfig<import("zod").ZodType>, 'schema'> {
+    /** Schema for event validation */
+    schema?: import("zod").ZodType<TEvent>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAM/E;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,yBAAyB;IACzB,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6CAA6C;IAC7C,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,uCAAuC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAMD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,0BAA0B;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,4CAA4C;IAC5C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gDAAgD;IAChD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,4CAA4C;IAC5C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gCAAgC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,+CAA+C;IAC/C,SAAS,CAAC,EAAE,SAAS,GAAG,WAAW,CAAC;IACpC,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,8CAA8C;IAC9C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,gCAAgC;IAChC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,6BAA6B;IAC7B,IAAI,IAAI,IAAI,CAAC;CACd;AAMD;;GAEG;AACH,MAAM,WAAW,oBAAoB,CAAC,MAAM,GAAG,OAAO,CAAE,SAAQ,IAAI,CAAC,cAAc,CAAC,OAAO,KAAK,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC;IACnH,kCAAkC;IAClC,MAAM,CAAC,EAAE,OAAO,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;CACxC"}

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * Node.js-specific type definitions
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/worker-streaming.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Ironflow Streaming Worker
+ *
+ * ConnectRPC bidirectional streaming worker for low-latency pull mode.
+ */
+import type { WorkerConfig, Worker } from "./types.js";
+/**
+ * Create a streaming worker for Pull mode execution using ConnectRPC
+ *
+ * Uses bidirectional gRPC streaming for efficient job dispatch.
+ *
+ * @param config - Worker configuration
+ * @returns Worker instance
+ */
+export declare function createStreamingWorker(config: WorkerConfig): Worker;
+export default createStreamingWorker;
+//# sourceMappingURL=worker-streaming.d.ts.map

package/dist/worker-streaming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-streaming.d.ts","sourceRoot":"","sources":["../src/worker-streaming.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA8BH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AA8BvD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAElE;AA2gBD,eAAe,qBAAqB,CAAC"}