@ironflow/node 0.1.0-test.2 → 0.2.0

package/dist/client.js

@@ -0,0 +1,449 @@
+/**
+ * Ironflow Node.js Client
+ *
+ * HTTP client for interacting with the Ironflow server.
+ * Provides methods for registering functions, triggering events, and managing runs.
+ */
+import { API_ENDPOINTS, DEFAULT_SERVER_URL, getServerUrl, } from "@ironflow/core";
+import { KVClient } from "./kv.js";
+import { ConfigClient } from "./config-client.js";
+// ============================================================================
+// Client Implementation
+// ============================================================================
+/**
+ * Ironflow client for server-side operations
+ *
+ * @example
+ * ```typescript
+ * import { createClient } from "@ironflow/node";
+ *
+ * const client = createClient({
+ *   serverUrl: "http://localhost:9123",
+ * });
+ *
+ * // Register a function
+ * await client.registerFunction({
+ *   id: "my-function",
+ *   name: "My Function",
+ *   triggers: [{ event: "my.event" }],
+ *   endpointUrl: "http://localhost:3000/api/ironflow",
+ *   preferredMode: "push",
+ * });
+ *
+ * // Emit an event
+ * const result = await client.emit("my.event", { data: "value" });
+ * console.log("Created runs:", result.runIds);
+ * ```
+ */
+export class IronflowClient {
+    serverUrl;
+    apiKey;
+    timeout;
+    constructor(config = {}) {
+        this.serverUrl = config.serverUrl || getServerUrl() || DEFAULT_SERVER_URL;
+        this.apiKey = config.apiKey;
+        this.timeout = config.timeout ?? 30000;
+    }
+    /**
+     * Register a function with the Ironflow server
+     */
+    async registerFunction(request) {
+        const body = {
+            id: request.id,
+        };
+        if (request.name)
+            body.name = request.name;
+        if (request.description)
+            body.description = request.description;
+        if (request.triggers)
+            body.triggers = request.triggers;
+        if (request.retry)
+            body.retry = request.retry;
+        if (request.timeoutMs)
+            body.timeoutMs = request.timeoutMs;
+        if (request.concurrency)
+            body.concurrency = request.concurrency;
+        if (request.preferredMode)
+            body.preferredMode = request.preferredMode;
+        if (request.endpointUrl)
+            body.endpointUrl = request.endpointUrl;
+        if (request.actorKey)
+            body.actorKey = request.actorKey;
+        const response = await this.request(API_ENDPOINTS.REGISTER_FUNCTION, body);
+        return { created: response.created };
+    }
+    /**
+     * Emit an event to trigger workflows
+     *
+     * @example
+     * ```typescript
+     * const result = await client.emit("order.placed", {
+     *   orderId: "123",
+     *   total: 99.99,
+     * });
+     * console.log("Created runs:", result.runIds);
+     * ```
+     */
+    async emit(eventName, data, options) {
+        const body = {
+            event: eventName,
+            data,
+        };
+        if (options?.version)
+            body.version = options.version;
+        if (options?.idempotencyKey)
+            body.idempotencyKey = options.idempotencyKey;
+        if (options?.metadata)
+            body.metadata = options.metadata;
+        const response = await this.request(API_ENDPOINTS.TRIGGER, body);
+        return {
+            runIds: response.runIds || [],
+            eventId: response.eventId,
+        };
+    }
+    /**
+     * Trigger an event (alias for emit)
+     * @deprecated Use emit() instead
+     */
+    async trigger(eventName, data, options) {
+        return this.emit(eventName, data, options);
+    }
+    /**
+     * Get a run by ID
+     */
+    async getRun(runId) {
+        return this.request(API_ENDPOINTS.GET_RUN, { id: runId });
+    }
+    /**
+     * List runs with optional filtering
+     */
+    async listRuns(options) {
+        const body = {};
+        if (options?.functionId)
+            body.functionId = options.functionId;
+        if (options?.status)
+            body.status = options.status;
+        if (options?.limit)
+            body.limit = options.limit;
+        if (options?.cursor)
+            body.cursor = options.cursor;
+        return this.request(API_ENDPOINTS.LIST_RUNS, body);
+    }
+    /**
+     * Cancel a running workflow
+     */
+    async cancelRun(runId, reason) {
+        return this.request(API_ENDPOINTS.CANCEL_RUN, {
+            id: runId,
+            reason: reason || "",
+        });
+    }
+    /**
+     * Retry a failed run
+     */
+    async retryRun(runId, fromStep) {
+        const body = { id: runId };
+        if (fromStep)
+            body.fromStep = fromStep;
+        return this.request(API_ENDPOINTS.RETRY_RUN, body);
+    }
+    /**
+     * Health check
+     */
+    async health() {
+        const response = await this.request(API_ENDPOINTS.HEALTH, {});
+        return response.status;
+    }
+    /**
+     * Entity stream operations
+     *
+     * @example
+     * ```typescript
+     * // Append an event to a stream
+     * const result = await client.streams.append("order-123", {
+     *   name: "order.created",
+     *   data: { total: 100 },
+     *   entityType: "order",
+     * });
+     *
+     * // Read events from a stream
+     * const { events } = await client.streams.read("order-123", { limit: 10 });
+     *
+     * // Get stream info
+     * const info = await client.streams.getInfo("order-123");
+     * ```
+     */
+    streams = {
+        /**
+         * Append an event to an entity stream
+         */
+        append: async (entityId, input, options) => {
+            const response = await this.request("/ironflow.v1.EntityStreamService/AppendEvent", {
+                entity_id: entityId,
+                entity_type: input.entityType,
+                event_name: input.name,
+                data: input.data,
+                expected_version: options?.expectedVersion ?? -1,
+                idempotency_key: options?.idempotencyKey ?? "",
+                version: options?.version ?? 1,
+            });
+            return {
+                entityVersion: response.entity_version,
+                eventId: response.event_id,
+            };
+        },
+        /**
+         * Read events from an entity stream
+         */
+        read: async (entityId, options) => {
+            const response = await this.request("/ironflow.v1.EntityStreamService/ReadStream", {
+                entity_id: entityId,
+                from_version: options?.fromVersion ?? 0,
+                limit: options?.limit ?? 0,
+                direction: options?.direction ?? "forward",
+            });
+            return {
+                events: (response.events ?? []).map((e) => ({
+                    id: e.id,
+                    name: e.name,
+                    data: e.data ?? {},
+                    entityVersion: e.entity_version,
+                    version: e.version,
+                    timestamp: e.timestamp,
+                    source: e.source,
+                    metadata: e.metadata,
+                })),
+                totalCount: response.total_count ?? 0,
+            };
+        },
+        /**
+         * Get information about an entity stream
+         */
+        getInfo: async (entityId) => {
+            const response = await this.request("/ironflow.v1.EntityStreamService/GetStreamInfo", {
+                entity_id: entityId,
+            });
+            return {
+                entityId: response.entity_id,
+                entityType: response.entity_type,
+                version: response.version,
+                eventCount: response.event_count,
+                createdAt: response.created_at,
+                updatedAt: response.updated_at,
+            };
+        },
+    };
+    /**
+     * KV store operations
+     *
+     * @example
+     * ```typescript
+     * const kv = client.kv();
+     * const bucket = await kv.createBucket({ name: "sessions", ttlSeconds: 3600 });
+     * const handle = kv.bucket("sessions");
+     * const { revision } = await handle.put("user.123", { token: "abc" });
+     * const entry = await handle.get("user.123");
+     * ```
+     */
+    kv() {
+        return new KVClient({
+            serverUrl: this.serverUrl,
+            apiKey: this.apiKey,
+            timeout: this.timeout,
+        });
+    }
+    /**
+     * Config management operations
+     *
+     * @example
+     * ```typescript
+     * const config = client.config();
+     * await config.set("app", { featureX: true });
+     * const { data } = await config.get("app");
+     * await config.patch("app", { maxRetries: 5 });
+     * const configs = await config.list();
+     * await config.delete("app");
+     * ```
+     */
+    config() {
+        return new ConfigClient({
+            serverUrl: this.serverUrl,
+            apiKey: this.apiKey,
+            timeout: this.timeout,
+        });
+    }
+    /**
+     * Patch a step's output (hot patching)
+     */
+    async patchStep(stepId, output, reason) {
+        const url = `${this.serverUrl}/api/v1/steps/patch`;
+        const headers = {
+            "Content-Type": "application/json",
+        };
+        if (this.apiKey) {
+            headers["Authorization"] = `Bearer ${this.apiKey}`;
+        }
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            const response = await fetch(url, {
+                method: "POST",
+                headers,
+                body: JSON.stringify({ step_id: stepId, output, reason: reason || "" }),
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                const errorBody = await response.text();
+                throw new Error(errorBody || `Patch step failed: ${response.status}`);
+            }
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    /**
+     * Resume a paused or failed run
+     */
+    async resumeRun(runId, fromStep) {
+        const url = `${this.serverUrl}/api/v1/runs/resume`;
+        const headers = {
+            "Content-Type": "application/json",
+        };
+        if (this.apiKey) {
+            headers["Authorization"] = `Bearer ${this.apiKey}`;
+        }
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            const response = await fetch(url, {
+                method: "POST",
+                headers,
+                body: JSON.stringify({ run_id: runId, from_step: fromStep || "" }),
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                const errorBody = await response.text();
+                throw new Error(errorBody || `Resume run failed: ${response.status}`);
+            }
+            return response.json();
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    /**
+     * List registered functions
+     */
+    async listFunctions() {
+        const url = `${this.serverUrl}/api/v1/functions`;
+        const headers = {};
+        if (this.apiKey) {
+            headers["Authorization"] = `Bearer ${this.apiKey}`;
+        }
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            const response = await fetch(url, {
+                method: "GET",
+                headers,
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                throw new Error(`List functions failed: ${response.status}`);
+            }
+            const data = (await response.json());
+            return data.functions || [];
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    /**
+     * List connected workers
+     */
+    async listWorkers() {
+        const url = `${this.serverUrl}/api/v1/workers`;
+        const headers = {};
+        if (this.apiKey) {
+            headers["Authorization"] = `Bearer ${this.apiKey}`;
+        }
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            const response = await fetch(url, {
+                method: "GET",
+                headers,
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                throw new Error(`List workers failed: ${response.status}`);
+            }
+            const data = (await response.json());
+            return data.workers || [];
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    /**
+     * Make an HTTP request to the server
+     */
+    async request(endpoint, body) {
+        const url = `${this.serverUrl}${endpoint}`;
+        const headers = {
+            "Content-Type": "application/json",
+        };
+        if (this.apiKey) {
+            headers["Authorization"] = `Bearer ${this.apiKey}`;
+        }
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            const response = await fetch(url, {
+                method: "POST",
+                headers,
+                body: JSON.stringify(body),
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                const errorBody = await response.text();
+                let errorMessage = `Request failed with status ${response.status}`;
+                if (errorBody) {
+                    try {
+                        const errorJson = JSON.parse(errorBody);
+                        if (errorJson.message) {
+                            errorMessage = errorJson.message;
+                        }
+                        else if (errorJson.code) {
+                            errorMessage = `Error code: ${errorJson.code}`;
+                        }
+                        else {
+                            errorMessage = errorBody;
+                        }
+                    }
+                    catch {
+                        // Not a JSON response, use raw text.
+                        errorMessage = errorBody;
+                    }
+                }
+                throw new Error(errorMessage);
+            }
+            return response.json();
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+}
+/**
+ * Create a new Ironflow client
+ *
+ * @example
+ * ```typescript
+ * const client = createClient({ serverUrl: "http://localhost:9123" });
+ * ```
+ */
+export function createClient(config) {
+    return new IronflowClient(config);
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/config-client.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Ironflow Node.js Config Client
+ *
+ * Config management operations for the Ironflow server.
+ */
+import type { ConfigResponse, ConfigEntry, ConfigSetResult } from "@ironflow/core";
+/**
+ * Configuration for the config client (inherited from parent client).
+ */
+export interface ConfigClientConfig {
+    serverUrl: string;
+    apiKey?: string;
+    timeout: number;
+}
+/**
+ * Node.js config client for config management operations.
+ */
+export declare class ConfigClient {
+    private readonly config;
+    constructor(config: ConfigClientConfig);
+    /**
+     * Set a config (full document replacement).
+     */
+    set(name: string, data: Record<string, unknown>): Promise<ConfigSetResult>;
+    /**
+     * Get a config by name.
+     */
+    get(name: string): Promise<ConfigResponse>;
+    /**
+     * Patch a config (shallow merge).
+     */
+    patch(name: string, data: Record<string, unknown>): Promise<ConfigSetResult>;
+    /**
+     * List all configs.
+     */
+    list(): Promise<ConfigEntry[]>;
+    /**
+     * Delete a config. Idempotent — succeeds silently if the config does not exist.
+     */
+    delete(name: string): Promise<void>;
+    private restRequest;
+}
+//# sourceMappingURL=config-client.d.ts.map

package/dist/config-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-client.d.ts","sourceRoot":"","sources":["../src/config-client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,WAAW,EACX,eAAe,EAChB,MAAM,gBAAgB,CAAC;AAExB;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,qBAAa,YAAY;IACX,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,kBAAkB;IAEvD;;OAEG;IACG,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC;IAIhF;;OAEG;IACG,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAIhD;;OAEG;IACG,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC;IAIlF;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAKpC;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAI3B,WAAW;CAgD1B"}

package/dist/config-client.js

@@ -0,0 +1,90 @@
+/**
+ * Ironflow Node.js Config Client
+ *
+ * Config management operations for the Ironflow server.
+ */
+/**
+ * Node.js config client for config management operations.
+ */
+export class ConfigClient {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Set a config (full document replacement).
+     */
+    async set(name, data) {
+        return this.restRequest("POST", `/api/v1/config/${enc(name)}`, data);
+    }
+    /**
+     * Get a config by name.
+     */
+    async get(name) {
+        return this.restRequest("GET", `/api/v1/config/${enc(name)}`);
+    }
+    /**
+     * Patch a config (shallow merge).
+     */
+    async patch(name, data) {
+        return this.restRequest("PATCH", `/api/v1/config/${enc(name)}`, data);
+    }
+    /**
+     * List all configs.
+     */
+    async list() {
+        const result = await this.restRequest("GET", "/api/v1/config");
+        return result.configs;
+    }
+    /**
+     * Delete a config. Idempotent — succeeds silently if the config does not exist.
+     */
+    async delete(name) {
+        await this.restRequest("DELETE", `/api/v1/config/${enc(name)}`);
+    }
+    async restRequest(method, path, body) {
+        const url = `${this.config.serverUrl}${path}`;
+        const headers = {};
+        if (body !== undefined) {
+            headers["Content-Type"] = "application/json";
+        }
+        if (this.config.apiKey) {
+            headers["Authorization"] = `Bearer ${this.config.apiKey}`;
+        }
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);
+        try {
+            const response = await fetch(url, {
+                method,
+                headers,
+                body: body !== undefined ? JSON.stringify(body) : undefined,
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                const errorBody = await response.text();
+                let errorMessage = `Config request failed with status ${response.status}`;
+                try {
+                    const errorJson = JSON.parse(errorBody);
+                    if (errorJson.error)
+                        errorMessage = errorJson.error;
+                }
+                catch {
+                    if (errorBody)
+                        errorMessage = errorBody;
+                }
+                throw new Error(errorMessage);
+            }
+            if (response.status === 204) {
+                return undefined;
+            }
+            return response.json();
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+}
+function enc(s) {
+    return encodeURIComponent(s);
+}
+//# sourceMappingURL=config-client.js.map

package/dist/config-client.js.map

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

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 /**
  * @ironflow/node
  *
- * Node.js SDK for Ironflow workflow engine.
+ * Node.js SDK for Ironflow, an event-driven backend platform.
  * Provides workers, serve handlers, and step execution for serverless and long-running functions.
  *
  * @example
@@ -39,9 +39,17 @@
  */
 export { ironflow, createFunction } from "./function.js";
 export { serve, createHandler } from "./serve.js";
-export { createWorker, createStreamingWorker } from "./worker.js";
+export { createWorker } from "./worker.js";
+export { createProjection } from "./projection.js";
+export { createProjectionRunner, type ProjectionRunnerConfig } from "./projection-runner.js";
+export { createClient } from "./client.js";
+export type { IronflowClientConfig, RegisterFunctionRequest, RegisterFunctionResult, } from "./client.js";
+export { KVClient, KVBucketHandle } from "./kv.js";
+export type { KVClientConfig } from "./kv.js";
+export { ConfigClient } from "./config-client.js";
+export type { ConfigClientConfig } from "./config-client.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 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, AppendEventInput, AppendOptions, AppendResult, ReadStreamOptions, StreamEvent, StreamInfo, Logger, PushRequest, PushResponse, CompletedStep, ResumeContext, StepResult, YieldInfo, SleepYield, WaitEventYield, KVBucketConfig, KVBucketInfo, KVEntry, KVPutResult, KVListKeysResult, KVListBucketsResult, KVWatchEvent, KVWatchCallbacks, KVWatchOptions, KVWatcher, ConfigResponse, ConfigEntry, ConfigSetResult, ConfigWatchCallbacks, ProjectionMode, ProjectionStatus, ProjectionContext, ManagedProjectionHandler, ExternalProjectionHandler, ProjectionConfig, IronflowProjection, ProjectionStatusInfo, ProjectionStateResult, GetProjectionOptions, RebuildProjectionOptions, ProjectionSubscriptionCallbacks, } 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";

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -1,7 +1,7 @@
 /**
  * @ironflow/node
  *
- * Node.js SDK for Ironflow workflow engine.
+ * Node.js SDK for Ironflow, an event-driven backend platform.
  * Provides workers, serve handlers, and step execution for serverless and long-running functions.
  *
  * @example
@@ -41,7 +41,14 @@
 import { ironflow } from "./function.js";
 export { ironflow, createFunction } from "./function.js";
 export { serve, createHandler } from "./serve.js";
-export { createWorker, createStreamingWorker } from "./worker.js";
+export { createWorker } from "./worker.js";
+export { createProjection } from "./projection.js";
+export { createProjectionRunner } from "./projection-runner.js";
+// NOTE: createStreamingWorker is NOT exported here to avoid loading protobuf
+// dependencies. Import from "@ironflow/node/worker-streaming" if you need it.
+export { createClient } from "./client.js";
+export { KVClient, KVBucketHandle } from "./kv.js";
+export { ConfigClient } from "./config-client.js";
 // Re-export branded ID creators
 export { createRunId, createFunctionId, createStepId, createEventId, createJobId, createWorkerId, createSubscriptionId, } from "@ironflow/core";
 // Re-export errors