@ironflow/node 0.20.2 → 0.21.0

package/dist/test/index.d.ts

@@ -0,0 +1,22 @@
+import type { AnyIronflowFunction } from "@ironflow/core";
+import { type TestStep } from "./test-step.js";
+export interface TestClientConfig {
+    functions: AnyIronflowFunction[];
+}
+export interface TestRun {
+    status: "completed" | "failed";
+    steps: TestStep[];
+    output: unknown;
+    error?: Error;
+    compensationsRan: string[];
+    stepOutput(name: string): unknown;
+}
+export interface TestClient {
+    mockStep(name: string, fn: () => unknown): void;
+    mockInvoke(functionId: string, fn: (data: unknown) => unknown): void;
+    sendEvent(eventName: string, data: unknown): void;
+    emit(eventName: string, data: unknown): Promise<TestRun>;
+}
+export declare function createTestClient(config: TestClientConfig): TestClient;
+export type { TestStep };
+//# sourceMappingURL=index.d.ts.map

package/dist/test/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/test/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,mBAAmB,EAKpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAEL,KAAK,QAAQ,EAGd,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,mBAAmB,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,WAAW,GAAG,QAAQ,CAAC;IAC/B,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CACnC;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,GAAG,IAAI,CAAC;IAChD,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,GAAG,IAAI,CAAC;IACrE,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAClD,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1D;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,UAAU,CA6GrE;AAsBD,YAAY,EAAE,QAAQ,EAAE,CAAC"}

package/dist/test/index.js

@@ -0,0 +1,112 @@
+import { createTestStepClient, } from "./test-step.js";
+export function createTestClient(config) {
+    const stepMocks = new Map();
+    const invokeMocks = new Map();
+    const eventQueue = new Map();
+    // Index functions by trigger event
+    const functionsByEvent = new Map();
+    for (const fn of config.functions) {
+        for (const trigger of fn.config.triggers) {
+            const existing = functionsByEvent.get(trigger.event) ?? [];
+            existing.push(fn);
+            functionsByEvent.set(trigger.event, existing);
+        }
+    }
+    return {
+        mockStep(name, fn) {
+            stepMocks.set(name, fn);
+        },
+        mockInvoke(functionId, fn) {
+            invokeMocks.set(functionId, fn);
+        },
+        sendEvent(eventName, data) {
+            const existing = eventQueue.get(eventName) ?? [];
+            existing.push(data);
+            eventQueue.set(eventName, existing);
+        },
+        async emit(eventName, data) {
+            const fns = functionsByEvent.get(eventName);
+            if (!fns || fns.length === 0) {
+                throw new Error(`No function registered for event "${eventName}". ` +
+                    `Check that your function has a trigger for this event.`);
+            }
+            const fn = fns[0];
+            const registries = { stepMocks, invokeMocks, eventQueue };
+            const state = { steps: [], compensations: [] };
+            const step = createTestStepClient(registries, state);
+            const event = {
+                id: `test-evt-${Date.now()}`,
+                name: eventName,
+                version: 1,
+                data,
+                timestamp: new Date(),
+            };
+            const noopLogger = {
+                debug: () => { },
+                info: () => { },
+                warn: () => { },
+                error: () => { },
+            };
+            const noopSecrets = {
+                get(name) {
+                    throw new Error(`Secret "${name}" not available in test mode`);
+                },
+                has() {
+                    return false;
+                },
+            };
+            const ctx = {
+                event,
+                step,
+                run: {
+                    id: `test-run-${Date.now()}`,
+                    functionId: fn.config.id,
+                    attempt: 1,
+                    startedAt: new Date(),
+                },
+                logger: noopLogger,
+                secrets: noopSecrets,
+            };
+            try {
+                const output = await fn.handler(ctx);
+                return buildTestRun("completed", state.steps, output, undefined, []);
+            }
+            catch (error) {
+                const err = error instanceof Error ? error : new Error(String(error));
+                // Run compensations in reverse order
+                const compensationsRan = [];
+                const reversed = [...state.compensations].reverse();
+                for (const { stepName, fn: compFn } of reversed) {
+                    try {
+                        await compFn();
+                        compensationsRan.push(stepName);
+                        state.steps.push({ name: `compensate:${stepName}`, type: "compensate" });
+                    }
+                    catch (compErr) {
+                        compensationsRan.push(stepName);
+                        state.steps.push({
+                            name: `compensate:${stepName}`,
+                            type: "compensate",
+                            error: compErr instanceof Error ? compErr : new Error(String(compErr)),
+                        });
+                    }
+                }
+                return buildTestRun("failed", state.steps, undefined, err, compensationsRan);
+            }
+        },
+    };
+}
+function buildTestRun(status, steps, output, error, compensationsRan) {
+    return {
+        status,
+        steps,
+        output,
+        error,
+        compensationsRan,
+        stepOutput(name) {
+            const s = steps.find((step) => step.name === name);
+            return s?.output;
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/test/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/test/index.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,oBAAoB,GAIrB,MAAM,gBAAgB,CAAC;AAsBxB,MAAM,UAAU,gBAAgB,CAAC,MAAwB;IACvD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAyB,CAAC;IACnD,MAAM,WAAW,GAAG,IAAI,GAAG,EAAsC,CAAC;IAClE,MAAM,UAAU,GAAG,IAAI,GAAG,EAAqB,CAAC;IAEhD,mCAAmC;IACnC,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAA8B,CAAC;IAC/D,KAAK,MAAM,EAAE,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QAClC,KAAK,MAAM,OAAO,IAAI,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YACzC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YAC3D,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAClB,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IAED,OAAO;QACL,QAAQ,CAAC,IAAY,EAAE,EAAiB;YACtC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC1B,CAAC;QAED,UAAU,CAAC,UAAkB,EAAE,EAA8B;YAC3D,WAAW,CAAC,GAAG,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QAClC,CAAC;QAED,SAAS,CAAC,SAAiB,EAAE,IAAa;YACxC,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;YACjD,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpB,UAAU,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QACtC,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,SAAiB,EAAE,IAAa;YACzC,MAAM,GAAG,GAAG,gBAAgB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAC5C,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC7B,MAAM,IAAI,KAAK,CACb,qCAAqC,SAAS,KAAK;oBACjD,wDAAwD,CAC3D,CAAC;YACJ,CAAC;YAED,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC,CAAE,CAAC;YACnB,MAAM,UAAU,GAAuB,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC;YAC9E,MAAM,KAAK,GAAkB,EAAE,KAAK,EAAE,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC;YAC9D,MAAM,IAAI,GAAG,oBAAoB,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;YAErD,MAAM,KAAK,GAAkB;gBAC3B,EAAE,EAAE,YAAY,IAAI,CAAC,GAAG,EAAE,EAAE;gBAC5B,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC;gBACV,IAAI;gBACJ,SAAS,EAAE,IAAI,IAAI,EAAE;aACtB,CAAC;YAEF,MAAM,UAAU,GAAW;gBACzB,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;gBACf,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;gBACd,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;gBACd,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;aAChB,CAAC;YAEF,MAAM,WAAW,GAAkB;gBACjC,GAAG,CAAC,IAAY;oBACd,MAAM,IAAI,KAAK,CAAC,WAAW,IAAI,8BAA8B,CAAC,CAAC;gBACjE,CAAC;gBACD,GAAG;oBACD,OAAO,KAAK,CAAC;gBACf,CAAC;aACF,CAAC;YAEF,MAAM,GAAG,GAAoB;gBAC3B,KAAK;gBACL,IAAI;gBACJ,GAAG,EAAE;oBACH,EAAE,EAAE,YAAY,IAAI,CAAC,GAAG,EAAE,EAAE;oBAC5B,UAAU,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE;oBACxB,OAAO,EAAE,CAAC;oBACV,SAAS,EAAE,IAAI,IAAI,EAAE;iBACtB;gBACD,MAAM,EAAE,UAAU;gBAClB,OAAO,EAAE,WAAW;aACrB,CAAC;YAEF,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;gBACrC,OAAO,YAAY,CAAC,WAAW,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;YACvE,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;gBAEtE,qCAAqC;gBACrC,MAAM,gBAAgB,GAAa,EAAE,CAAC;gBACtC,MAAM,QAAQ,GAAG,CAAC,GAAG,KAAK,CAAC,aAAa,CAAC,CAAC,OAAO,EAAE,CAAC;gBACpD,KAAK,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;oBAChD,IAAI,CAAC;wBACH,MAAM,MAAM,EAAE,CAAC;wBACf,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;wBAChC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,cAAc,QAAQ,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;oBAC3E,CAAC;oBAAC,OAAO,OAAO,EAAE,CAAC;wBACjB,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;wBAChC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC;4BACf,IAAI,EAAE,cAAc,QAAQ,EAAE;4BAC9B,IAAI,EAAE,YAAY;4BAClB,KAAK,EAAE,OAAO,YAAY,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;yBACvE,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;gBAED,OAAO,YAAY,CAAC,QAAQ,EAAE,KAAK,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,gBAAgB,CAAC,CAAC;YAC/E,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CACnB,MAA8B,EAC9B,KAAiB,EACjB,MAAe,EACf,KAAwB,EACxB,gBAA0B;IAE1B,OAAO;QACL,MAAM;QACN,KAAK;QACL,MAAM;QACN,KAAK;QACL,gBAAgB;QAChB,UAAU,CAAC,IAAY;YACrB,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;YACnD,OAAO,CAAC,EAAE,MAAM,CAAC;QACnB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/test/test-step.d.ts

@@ -0,0 +1,21 @@
+import type { StepClient } from "@ironflow/core";
+export interface TestStep {
+    name: string;
+    type: "run" | "invoke" | "sleep" | "waitForEvent" | "compensate";
+    output?: unknown;
+    error?: Error;
+}
+export interface TestStepRegistries {
+    stepMocks: Map<string, () => unknown>;
+    invokeMocks: Map<string, (data: unknown) => unknown>;
+    eventQueue: Map<string, unknown[]>;
+}
+export interface TestStepState {
+    steps: TestStep[];
+    compensations: Array<{
+        stepName: string;
+        fn: () => Promise<void>;
+    }>;
+}
+export declare function createTestStepClient(registries: TestStepRegistries, state: TestStepState): StepClient;
+//# sourceMappingURL=test-step.d.ts.map

package/dist/test/test-step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-step.d.ts","sourceRoot":"","sources":["../../src/test/test-step.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EAMX,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,OAAO,GAAG,cAAc,GAAG,YAAY,CAAC;IACjE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC;IACtC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC;IACrD,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,aAAa,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,CAAC,CAAC;CACrE;AAED,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,kBAAkB,EAC9B,KAAK,EAAE,aAAa,GACnB,UAAU,CAsHZ"}

package/dist/test/test-step.js

@@ -0,0 +1,83 @@
+export function createTestStepClient(registries, state) {
+    const stepClient = {
+        async run(name, _fn) {
+            const mock = registries.stepMocks.get(name);
+            if (!mock) {
+                throw new Error(`Step "${name}" was called but has no mock. ` +
+                    `Use t.mockStep("${name}", fn) to provide one.`);
+            }
+            const output = await Promise.resolve(mock());
+            state.steps.push({ name, type: "run", output });
+            return output;
+        },
+        async sleep(name, _duration) {
+            state.steps.push({ name, type: "sleep" });
+        },
+        async sleepUntil(name, _until) {
+            state.steps.push({ name, type: "sleep" });
+        },
+        async waitForEvent(name, filter) {
+            const events = registries.eventQueue.get(filter.event);
+            if (!events || events.length === 0) {
+                throw new Error(`step.waitForEvent("${name}") is waiting for "${filter.event}" ` +
+                    `but no events were pre-registered. ` +
+                    `Use t.sendEvent("${filter.event}", data) before calling t.emit().`);
+            }
+            const data = events.shift();
+            const event = {
+                id: `test-evt-${Date.now()}`,
+                name: filter.event,
+                version: 1,
+                data: data,
+                timestamp: new Date(),
+            };
+            state.steps.push({ name, type: "waitForEvent", output: event });
+            return event;
+        },
+        async parallel(_name, branches, _options) {
+            const results = [];
+            for (const branch of branches) {
+                const result = await branch(stepClient);
+                results.push(result);
+            }
+            return results;
+        },
+        async map(_name, items, fn, _options) {
+            const results = [];
+            for (let i = 0; i < items.length; i++) {
+                const result = await fn(items[i], stepClient, i);
+                results.push(result);
+            }
+            return results;
+        },
+        compensate(stepName, fn) {
+            state.compensations.push({ stepName, fn });
+        },
+        async invoke(functionId, input, _options) {
+            const mock = registries.invokeMocks.get(functionId);
+            if (!mock) {
+                throw new Error(`step.invoke("${functionId}") was called but has no mock. ` +
+                    `Use t.mockInvoke("${functionId}", fn) to provide one.`);
+            }
+            const output = await Promise.resolve(mock(input));
+            state.steps.push({ name: functionId, type: "invoke", output });
+            return output;
+        },
+        async invokeAsync(functionId, input) {
+            const mock = registries.invokeMocks.get(functionId);
+            if (!mock) {
+                throw new Error(`step.invokeAsync("${functionId}") was called but has no mock. ` +
+                    `Use t.mockInvoke("${functionId}", fn) to provide one.`);
+            }
+            await Promise.resolve(mock(input));
+            const runId = `test-run-${Date.now()}`;
+            state.steps.push({ name: functionId, type: "invoke", output: { runId } });
+            return { runId };
+        },
+        async publish(_topic, _data) {
+            return { eventId: `test-msg-${Date.now()}`, sequence: 0 };
+        },
+    };
+    return stepClient;
+}
+//# sourceMappingURL=test-step.js.map

package/dist/test/test-step.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Node.js-specific type definitions
+ */
+import type { AnyIronflowFunction, IronflowProjection, IronflowWebhook, Logger, FunctionConfig, EventDefinitionRegistry } from "@ironflow/core";
+/**
+ * Configuration for the serve handler
+ */
+export interface ServeConfig {
+    /** Functions to serve */
+    functions: AnyIronflowFunction[];
+    /** Projections to register */
+    projections?: IronflowProjection[];
+    /** Signing key for webhook verification */
+    signingKey?: string;
+    /** Skip signature verification (dev only) */
+    skipVerification?: boolean;
+    /** Logger instance (or false to disable) */
+    logger?: Logger | false;
+    /** Target environment (default: IRONFLOW_ENV or "default") */
+    environment?: string;
+    /** Event definition registry for automatic upcasting of event data */
+    eventDefinitions?: EventDefinitionRegistry;
+    /** Ironflow server URL for emitting webhook events */
+    serverUrl?: string;
+    /** Webhook sources to handle */
+    webhooks?: IronflowWebhook[];
+}
+/**
+ * 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: AnyIronflowFunction[];
+    /** Projections to register */
+    projections?: IronflowProjection[];
+    /** 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;
+    /** Target environment (default: IRONFLOW_ENV or "default") */
+    environment?: string;
+    /** Event definition registry for automatic upcasting of event data */
+    eventDefinitions?: EventDefinitionRegistry;
+    /** API key for authentication (default: IRONFLOW_API_KEY env var) */
+    apiKey?: string;
+}
+/**
+ * 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>;
+}
+/**
+ * Context passed to the global onError handler when a client operation fails.
+ */
+export interface ErrorContext {
+    /** Client method name (e.g. "emit", "streams.append", "apiKeys.create") */
+    method: string;
+    /** ConnectRPC or REST endpoint path (e.g. "/ironflow.v1.IronflowService/Trigger") */
+    endpoint: string;
+    /** HTTP status code (undefined for connection/timeout errors) */
+    statusCode?: number;
+}
+/**
+ * Global error handler callback type.
+ * Return value is awaited; if the callback throws, the error is swallowed
+ * and logged to stderr — the original error is always re-thrown.
+ */
+export type OnErrorHandler = (error: Error, context: ErrorContext) => void | Promise<void>;
+//# 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":"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"}

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/version.d.ts

@@ -0,0 +1,2 @@
+export declare const SDK_VERSION = "0.21.0";
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,WAAW,WAAW,CAAC"}

package/dist/version.js

@@ -0,0 +1,4 @@
+// Auto-generated from package.json by scripts/sync-version.mjs
+// Do not edit manually; run `pnpm build` (or the prebuild hook) to regenerate.
+export const SDK_VERSION = "0.21.0";
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+EAA+E;AAC/E,MAAM,CAAC,MAAM,WAAW,GAAG,QAAQ,CAAC"}

package/dist/webhook.d.ts

@@ -0,0 +1,22 @@
+import type { WebhookConfig, IronflowWebhook } from "@ironflow/core";
+/**
+ * Create a webhook source definition.
+ *
+ * @example
+ * ```typescript
+ * const stripeWebhook = createWebhook({
+ *   id: "stripe",
+ *   verify: (req) => {
+ *     const sig = req.headers["stripe-signature"];
+ *     return stripe.webhooks.constructEvent(req.body, sig, secret);
+ *   },
+ *   transform: (payload) => ({
+ *     name: `stripe.${payload.type}`,
+ *     data: payload.data.object,
+ *     idempotencyKey: payload.id,
+ *   }),
+ * });
+ * ```
+ */
+export declare function createWebhook(config: WebhookConfig): IronflowWebhook;
+//# sourceMappingURL=webhook.d.ts.map

package/dist/webhook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.d.ts","sourceRoot":"","sources":["../src/webhook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAErE;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,eAAe,CAEpE"}

package/dist/webhook.js

@@ -0,0 +1,23 @@
+/**
+ * Create a webhook source definition.
+ *
+ * @example
+ * ```typescript
+ * const stripeWebhook = createWebhook({
+ *   id: "stripe",
+ *   verify: (req) => {
+ *     const sig = req.headers["stripe-signature"];
+ *     return stripe.webhooks.constructEvent(req.body, sig, secret);
+ *   },
+ *   transform: (payload) => ({
+ *     name: `stripe.${payload.type}`,
+ *     data: payload.data.object,
+ *     idempotencyKey: payload.id,
+ *   }),
+ * });
+ * ```
+ */
+export function createWebhook(config) {
+    return { config };
+}
+//# sourceMappingURL=webhook.js.map

package/dist/webhook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.js","sourceRoot":"","sources":["../src/webhook.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,aAAa,CAAC,MAAqB;IACjD,OAAO,EAAE,MAAM,EAAE,CAAC;AACpB,CAAC"}

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;AAgCH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAiCvD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAElE;AA8jBD,eAAe,qBAAqB,CAAC"}