@sayiir/flow-js 0.5.0-rc1

package/dist/flow.js

@@ -0,0 +1,410 @@
+"use strict";
+/**
+ * Type-safe flow builder for constructing workflows.
+ *
+ * The builder tracks input/output types through the chain using generics,
+ * providing full type inference without manual annotations.
+ *
+ * ```ts
+ * const wf = flow<number>("welcome")
+ *   .then("load", (id) => getUser(id))         // id: number -> User
+ *   .then("greet", (user) => `Hi ${user.name}`) // user: User -> string
+ *   .build();                                    // Workflow<number, string>
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RouteBuilder = exports.ForkBuilder = exports.Flow = exports.Workflow = void 0;
+exports.branch = branch;
+exports.createFlowFactory = createFlowFactory;
+const duration_js_1 = require("./duration.js");
+/**
+ * Suffix convention for branch key-function task IDs.
+ * Must match `sayiir_core::workflow::key_fn_id`.
+ */
+const KEY_FN_SUFFIX = "::key_fn";
+/** A compiled workflow ready for execution. */
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+class Workflow {
+    /** @internal */
+    _inner;
+    /** @internal */
+    _taskRegistry;
+    /** @internal — kept for child workflow composition via `thenFlow`. */
+    _builder;
+    constructor(inner, taskRegistry, builder) {
+        this._inner = inner;
+        this._taskRegistry = taskRegistry;
+        this._builder = builder;
+    }
+    get workflowId() {
+        return this._inner.workflowId;
+    }
+    get definitionHash() {
+        return this._inner.definitionHash;
+    }
+    /** Workflow-level metadata, or `undefined` if none was provided. */
+    get metadata() {
+        const json = this._inner.metadataJson;
+        return json != null ? JSON.parse(json) : undefined;
+    }
+    /**
+     * Return all nodes in topological (execution) order.
+     *
+     * Each {@link NodeInfo} carries the node's ID, kind, predecessor,
+     * and any configured timeout / retry / priority metadata.
+     * Useful for introspection, UI visualisation, and documentation.
+     */
+    iterNodes() {
+        return this._inner.iterNodes();
+    }
+}
+exports.Workflow = Workflow;
+/**
+ * Create a branch for use with `.fork()`.
+ *
+ * ```ts
+ * flow<Order>("process")
+ *   .then(chargePayment)
+ *   .fork([
+ *     branch("email", sendConfirmation),
+ *     branch("ship", shipOrder),
+ *   ])
+ *   .join("finalize", ([email, ship]) => ({ email, ship }))
+ *   .build();
+ * ```
+ */
+function branch(name, fn) {
+    const taskId = isTaskFn(fn) ? fn._taskId : name;
+    const metadata = isTaskFn(fn) ? fn._metadata : undefined;
+    return {
+        name,
+        steps: [{ taskId, fn: fn, metadata }],
+    };
+}
+/**
+ * Create a `flow()` factory function bound to a specific builder backend.
+ *
+ * Each binding package (sayiir-nodejs, sayiir-cloudflare, etc.) calls this
+ * once with their native builder constructor.
+ */
+function createFlowFactory(factory) {
+    return (name, opts) => {
+        return new Flow(factory(name), opts);
+    };
+}
+/** Type-safe workflow builder. */
+class Flow {
+    /** @internal */
+    _builder;
+    /** @internal */
+    _taskRegistry = {};
+    /** @internal */
+    _childCounter = 0;
+    constructor(builder, opts) {
+        this._builder = builder;
+        if (opts?.metadata != null) {
+            this._builder.setMetadataJson(JSON.stringify(opts.metadata));
+        }
+    }
+    then(idOrFn, fnOrOpts, maybeOpts) {
+        let taskId;
+        let taskFn;
+        let metadata;
+        if (typeof idOrFn === "string") {
+            // .then("id", fn, opts?)
+            taskId = idOrFn;
+            taskFn = fnOrOpts;
+            const opts = maybeOpts;
+            if (isTaskFn(taskFn)) {
+                metadata = taskFn._metadata;
+                // Keep the wrapped TaskFn (preserves Zod validation); only override the id.
+            }
+            if (opts) {
+                metadata = { ...metadata, ...buildStepMetadata(taskId, opts) };
+            }
+        }
+        else if (isTaskFn(idOrFn)) {
+            // .then(taskFn)
+            taskId = idOrFn._taskId;
+            taskFn = idOrFn;
+            metadata = idOrFn._metadata;
+        }
+        else {
+            // .then(lambda) — auto-generate id
+            taskId = this._builder.nextLambdaId();
+            taskFn = idOrFn;
+        }
+        this._taskRegistry[taskId] = taskFn;
+        this._builder.then(taskId, metadata);
+        return this;
+    }
+    /**
+     * Start a fork for parallel execution.
+     *
+     * ```ts
+     * .fork([
+     *   branch("email", sendEmail),
+     *   branch("sms", sendSms),
+     * ])
+     * .join("merge", ([email, sms]) => ({ email, sms }))
+     * ```
+     */
+    fork(branches) {
+        return new ForkBuilder(this, branches);
+    }
+    /**
+     * Add a durable delay. No workers are held during the delay.
+     *
+     * Duration can be a number (ms) or a string like "30s", "5m", "1h".
+     */
+    delay(id, duration) {
+        const ms = (0, duration_js_1.parseDuration)(duration);
+        this._builder.delay(id, ms / 1000);
+        return this;
+    }
+    /**
+     * Wait for an external signal before continuing.
+     *
+     * The workflow parks and releases the worker until the signal arrives.
+     */
+    waitForSignal(id, signalName, opts) {
+        const timeoutSecs = opts?.timeout != null ? (0, duration_js_1.parseDuration)(opts.timeout) / 1000 : undefined;
+        this._builder.waitForSignal(id, signalName, timeoutSecs);
+        return this;
+    }
+    /**
+     * Start a conditional branch based on a routing key.
+     *
+     * The `keys` array declares all valid routing keys up front, providing
+     * type-level safety: the key function's return type and `.branch()` key
+     * parameter are constrained to the declared set.
+     *
+     * ```ts
+     * flow<Ticket>("classify")
+     *   .then("classify", classify)
+     *   .route((result) => result.intent, ["billing", "tech"] as const)
+     *     .branch("billing", handleBilling)
+     *     .branch("tech", handleTech)
+     *     .done()
+     *   .then("finalize", finalizeStep)
+     *   .build();
+     * ```
+     */
+    route(keyFn, keys) {
+        return new RouteBuilder(this, keyFn, [
+            ...keys,
+        ]);
+    }
+    loop(idOrFn, fnOrOpts, maybeOpts) {
+        let taskId;
+        let taskFn;
+        let metadata;
+        let opts;
+        if (typeof idOrFn === "string") {
+            taskId = idOrFn;
+            taskFn = fnOrOpts;
+            opts = maybeOpts;
+            if (isTaskFn(taskFn)) {
+                metadata = taskFn._metadata;
+            }
+        }
+        else if (isTaskFn(idOrFn)) {
+            taskId = idOrFn._taskId;
+            taskFn = idOrFn;
+            metadata = idOrFn._metadata;
+            opts = fnOrOpts;
+        }
+        else {
+            taskId = this._builder.nextLambdaId();
+            taskFn = idOrFn;
+            opts = fnOrOpts;
+        }
+        this._taskRegistry[taskId] = taskFn;
+        const maxIterations = opts?.maxIterations ?? 10;
+        if (maxIterations < 1) {
+            throw new Error("maxIterations must be at least 1");
+        }
+        const onMax = opts?.onMax ?? "fail";
+        this._builder.addLoop(taskId, metadata, maxIterations, onMax);
+        return this;
+    }
+    /**
+     * Compose another workflow inline as a child.
+     *
+     * The child workflow's tasks execute as a sub-pipeline: the current
+     * step's output feeds into the child's first task, and the child's
+     * final output continues to the next step.
+     *
+     * ```ts
+     * const child = flow<number>("double").then("x2", (n) => n * 2).build();
+     * const parent = flow<number>("pipeline").then("inc", (n) => n + 1).thenFlow(child).build();
+     * ```
+     */
+    thenFlow(workflow) {
+        const childId = `child_${this._childCounter++}`;
+        // Merge child task registry into parent (parent takes precedence)
+        for (const [key, value] of Object.entries(workflow._taskRegistry)) {
+            this._taskRegistry[key] ??= value;
+        }
+        // Tell native builder about the child
+        this._builder.addChildWorkflow(childId, workflow._builder);
+        return this;
+    }
+    /** Build the workflow definition. */
+    build() {
+        const inner = this._builder.build();
+        return new Workflow(inner, this._taskRegistry, this._builder);
+    }
+}
+exports.Flow = Flow;
+/** Builder for fork/join parallel branches. */
+class ForkBuilder {
+    flow;
+    branches;
+    constructor(flow, branches) {
+        this.flow = flow;
+        this.branches = branches;
+    }
+    /**
+     * Join branches with a combining function.
+     *
+     * The join function receives a tuple of branch outputs.
+     */
+    join(id, fn) {
+        // Register all branch tasks
+        const backendBranches = this.branches.map((b) => {
+            return b.steps.map((step) => {
+                this.flow._taskRegistry[step.taskId] = step.fn;
+                return { taskId: step.taskId, metadata: step.metadata };
+            });
+        });
+        // The join function receives a Record (from Rust codec) keyed by the
+        // first task ID of each branch. We wrap to convert to a tuple.
+        const branchNames = this.branches.map((b) => b.steps[0].taskId);
+        const joinWrapper = (branchResults) => {
+            const tuple = branchNames.map((name) => branchResults[name]);
+            return fn(tuple);
+        };
+        this.flow._taskRegistry[id] = joinWrapper;
+        this.flow._builder.addFork(backendBranches, id);
+        return this.flow;
+    }
+}
+exports.ForkBuilder = ForkBuilder;
+/** Builder for conditional branching (route). */
+class RouteBuilder {
+    flow;
+    keyFn;
+    declaredKeys;
+    branches = [];
+    defaultSteps;
+    constructor(flow, keyFn, declaredKeys) {
+        this.flow = flow;
+        this.keyFn = keyFn;
+        this.declaredKeys = declaredKeys;
+    }
+    branch(key, idOrFn, maybeFn) {
+        const { taskId, taskFn, metadata } = resolveBranchTask(key, idOrFn, maybeFn, this.flow);
+        this.branches.push({
+            key,
+            steps: [{ taskId, fn: taskFn, metadata }],
+        });
+        return this;
+    }
+    defaultBranch(idOrFn, maybeFn) {
+        const { taskId, taskFn, metadata } = resolveBranchTask("_default", idOrFn, maybeFn, this.flow);
+        this.defaultSteps = [{ taskId, fn: taskFn, metadata }];
+        return this;
+    }
+    /**
+     * Finish the route and return to the Flow builder.
+     *
+     * Performs exhaustiveness checks:
+     * - Throws if a declared key has no `.branch()` call and no `.defaultBranch()`.
+     * - Throws if a `.branch()` key is not in the declared set.
+     */
+    done() {
+        const branchedKeys = new Set(this.branches.map((b) => b.key));
+        const declaredSet = new Set(this.declaredKeys);
+        // Check for orphan branches
+        const orphans = [...branchedKeys].filter((k) => !declaredSet.has(k));
+        if (orphans.length > 0) {
+            throw new Error(`Route: orphan branches for keys: ${orphans.join(", ")}`);
+        }
+        // Check for missing branches (no default)
+        if (!this.defaultSteps) {
+            const missing = this.declaredKeys.filter((k) => !branchedKeys.has(k));
+            if (missing.length > 0) {
+                throw new Error(`Route: missing branches for keys: ${missing.join(", ")}`);
+            }
+        }
+        // Build backend branch entries
+        const backendBranches = this.branches.map((b) => ({
+            key: b.key,
+            tasks: b.steps.map((step) => {
+                this.flow._taskRegistry[step.taskId] = step.fn;
+                return { taskId: step.taskId, metadata: step.metadata };
+            }),
+        }));
+        const backendDefault = this.defaultSteps?.map((step) => {
+            this.flow._taskRegistry[step.taskId] = step.fn;
+            return { taskId: step.taskId, metadata: step.metadata };
+        });
+        // addBranch returns the generated branch ID
+        const branchId = this.flow._builder.addBranch(backendBranches, backendDefault);
+        // Register key function using the generated branch ID
+        const keyFnId = `${branchId}${KEY_FN_SUFFIX}`;
+        this.flow._taskRegistry[keyFnId] = this.keyFn;
+        return this.flow;
+    }
+}
+exports.RouteBuilder = RouteBuilder;
+function isTaskFn(fn) {
+    return typeof fn === "function" && "_taskId" in fn;
+}
+/** Resolve task id/fn/metadata from branch-style overloaded args. */
+function resolveBranchTask(fallbackId, idOrFn, maybeFn, flow) {
+    if (typeof idOrFn === "string") {
+        const fn = maybeFn;
+        const metadata = isTaskFn(fn)
+            ? fn._metadata
+            : undefined;
+        return { taskId: idOrFn, taskFn: fn, metadata };
+    }
+    else if (isTaskFn(idOrFn)) {
+        return {
+            taskId: idOrFn._taskId,
+            taskFn: idOrFn,
+            metadata: idOrFn._metadata,
+        };
+    }
+    else {
+        const taskId = `${fallbackId}_${flow._builder.nextLambdaId()}`;
+        return { taskId, taskFn: idOrFn };
+    }
+}
+function buildStepMetadata(id, opts) {
+    const metadata = { displayName: id };
+    if (opts.timeout != null) {
+        metadata.timeoutSecs = (0, duration_js_1.parseDuration)(opts.timeout) / 1000;
+    }
+    if (opts.retry) {
+        metadata.retries = {
+            maxRetries: opts.retry.maxAttempts,
+            initialDelaySecs: (0, duration_js_1.parseDuration)(opts.retry.initialDelay) / 1000,
+            backoffMultiplier: opts.retry.backoffMultiplier ?? 2.0,
+            maxDelaySecs: opts.retry.maxDelay != null
+                ? (0, duration_js_1.parseDuration)(opts.retry.maxDelay) / 1000
+                : undefined,
+        };
+    }
+    else if (opts.retries != null) {
+        metadata.retries = {
+            maxRetries: opts.retries,
+            initialDelaySecs: 1.0,
+            backoffMultiplier: 2.0,
+        };
+    }
+    return metadata;
+}
+//# sourceMappingURL=flow.js.map

package/dist/flow.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @sayiir/flow-js — Pure TypeScript workflow builder DSL for Sayiir.
+ *
+ * This package contains only the builder logic with no native dependencies.
+ * It is used by binding packages (sayiir-nodejs, sayiir-cloudflare, etc.)
+ * that provide the concrete FlowBuilderBackend implementation.
+ */
+export type { FlowBuilderBackend, CompiledWorkflow, NodeKind, NodeInfo, TaskMetadata, RetryPolicyConfig, BranchTask, BranchEntry, } from "./interfaces.js";
+export type { Duration, LoopOptions, RetryPolicy, TaskCallback, TaskOptions, StepOptions, WorkflowStatus, ZodLike, MaxIterationsPolicy, } from "./types.js";
+export { LoopResult, WorkflowError, TaskError, BackendError } from "./types.js";
+export { task } from "./task.js";
+export type { TaskFn } from "./task.js";
+export { branch, Flow, ForkBuilder, RouteBuilder, Workflow, createFlowFactory, } from "./flow.js";
+export type { BranchDef, BranchEnvelope, FlowOptions, InferBranchOutputs, BuilderFactory, } from "./flow.js";
+export { parseDuration } from "./duration.js";
+//# 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;;;;;;GAMG;AAGH,YAAY,EACV,kBAAkB,EAClB,gBAAgB,EAChB,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,iBAAiB,EACjB,UAAU,EACV,WAAW,GACZ,MAAM,iBAAiB,CAAC;AAGzB,YAAY,EACV,QAAQ,EACR,WAAW,EACX,WAAW,EACX,YAAY,EACZ,WAAW,EACX,WAAW,EACX,cAAc,EACd,OAAO,EACP,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAGhF,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,YAAY,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGxC,OAAO,EACL,MAAM,EACN,IAAI,EACJ,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,iBAAiB,GAClB,MAAM,WAAW,CAAC;AACnB,YAAY,EACV,SAAS,EACT,cAAc,EACd,WAAW,EACX,kBAAkB,EAClB,cAAc,GACf,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,30 @@
+"use strict";
+/**
+ * @sayiir/flow-js — Pure TypeScript workflow builder DSL for Sayiir.
+ *
+ * This package contains only the builder logic with no native dependencies.
+ * It is used by binding packages (sayiir-nodejs, sayiir-cloudflare, etc.)
+ * that provide the concrete FlowBuilderBackend implementation.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseDuration = exports.createFlowFactory = exports.Workflow = exports.RouteBuilder = exports.ForkBuilder = exports.Flow = exports.branch = exports.task = exports.BackendError = exports.TaskError = exports.WorkflowError = exports.LoopResult = void 0;
+var types_js_1 = require("./types.js");
+Object.defineProperty(exports, "LoopResult", { enumerable: true, get: function () { return types_js_1.LoopResult; } });
+Object.defineProperty(exports, "WorkflowError", { enumerable: true, get: function () { return types_js_1.WorkflowError; } });
+Object.defineProperty(exports, "TaskError", { enumerable: true, get: function () { return types_js_1.TaskError; } });
+Object.defineProperty(exports, "BackendError", { enumerable: true, get: function () { return types_js_1.BackendError; } });
+// Task
+var task_js_1 = require("./task.js");
+Object.defineProperty(exports, "task", { enumerable: true, get: function () { return task_js_1.task; } });
+// Flow
+var flow_js_1 = require("./flow.js");
+Object.defineProperty(exports, "branch", { enumerable: true, get: function () { return flow_js_1.branch; } });
+Object.defineProperty(exports, "Flow", { enumerable: true, get: function () { return flow_js_1.Flow; } });
+Object.defineProperty(exports, "ForkBuilder", { enumerable: true, get: function () { return flow_js_1.ForkBuilder; } });
+Object.defineProperty(exports, "RouteBuilder", { enumerable: true, get: function () { return flow_js_1.RouteBuilder; } });
+Object.defineProperty(exports, "Workflow", { enumerable: true, get: function () { return flow_js_1.Workflow; } });
+Object.defineProperty(exports, "createFlowFactory", { enumerable: true, get: function () { return flow_js_1.createFlowFactory; } });
+// Duration utility
+var duration_js_1 = require("./duration.js");
+Object.defineProperty(exports, "parseDuration", { enumerable: true, get: function () { return duration_js_1.parseDuration; } });
+//# 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;;;;;;GAMG;;;AA2BH,uCAAgF;AAAvE,sGAAA,UAAU,OAAA;AAAE,yGAAA,aAAa,OAAA;AAAE,qGAAA,SAAS,OAAA;AAAE,wGAAA,YAAY,OAAA;AAE3D,OAAO;AACP,qCAAiC;AAAxB,+FAAA,IAAI,OAAA;AAGb,OAAO;AACP,qCAOmB;AANjB,iGAAA,MAAM,OAAA;AACN,+FAAA,IAAI,OAAA;AACJ,sGAAA,WAAW,OAAA;AACX,uGAAA,YAAY,OAAA;AACZ,mGAAA,QAAQ,OAAA;AACR,4GAAA,iBAAiB,OAAA;AAUnB,mBAAmB;AACnB,6CAA8C;AAArC,4GAAA,aAAa,OAAA"}

package/dist/interfaces.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Backend interfaces for the Sayiir flow builder.
+ *
+ * These abstract over the concrete builder implementation (NAPI-RS, WASM, etc.)
+ * so the pure-TypeScript DSL can be used without native dependencies.
+ */
+export interface RetryPolicyConfig {
+    maxRetries: number;
+    initialDelaySecs: number;
+    backoffMultiplier: number;
+    maxDelaySecs?: number;
+}
+export interface TaskMetadata {
+    displayName?: string;
+    description?: string;
+    timeoutSecs?: number;
+    retries?: RetryPolicyConfig;
+    tags?: string[];
+    version?: string;
+    priority?: number;
+}
+export interface BranchTask {
+    taskId: string;
+    metadata?: TaskMetadata;
+}
+export interface BranchEntry {
+    key: string;
+    tasks: BranchTask[];
+}
+/** The kind of node in a workflow DAG. */
+export type NodeKind = "task" | "fork" | "delay" | "await_signal" | "branch" | "loop" | "child_workflow";
+/** Metadata about a single node in the workflow DAG. */
+export interface NodeInfo {
+    /** Unique node identifier. */
+    id: string;
+    /** Node kind. */
+    kind: NodeKind;
+    /** ID of the preceding node, or `undefined` for the root. */
+    predecessorId?: string;
+    /** Timeout in seconds (task timeout, delay duration, or signal timeout). */
+    timeoutSecs?: number;
+    /** Retry policy (tasks only). */
+    retryPolicy?: RetryPolicyConfig;
+    /** Execution priority 1–5 (tasks only). */
+    priority?: number;
+}
+export interface CompiledWorkflow {
+    workflowId: string;
+    definitionHash: string;
+    metadataJson?: string;
+    /** Return all nodes in topological (execution) order. */
+    iterNodes(): NodeInfo[];
+}
+export interface FlowBuilderBackend {
+    nextLambdaId(): string;
+    then(taskId: string, metadata?: TaskMetadata): void;
+    addFork(branches: BranchTask[][], joinId: string, joinMetadata?: TaskMetadata): void;
+    addBranch(branches: BranchEntry[], defaultBranch?: BranchTask[]): string;
+    waitForSignal(signalId: string, signalName: string, timeoutSecs?: number): void;
+    delay(delayId: string, seconds: number): void;
+    addLoop(bodyTaskId: string, bodyMetadata?: TaskMetadata, maxIterations?: number, onMax?: string): string;
+    addChildWorkflow(childId: string, childBuilder: FlowBuilderBackend): void;
+    setMetadataJson(json: string): void;
+    build(): CompiledWorkflow;
+}
+//# sourceMappingURL=interfaces.d.ts.map

package/dist/interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../src/interfaces.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,YAAY,CAAC;CACzB;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB;AAED,0CAA0C;AAC1C,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,cAAc,GAAG,QAAQ,GAAG,MAAM,GAAG,gBAAgB,CAAC;AAEzG,wDAAwD;AACxD,MAAM,WAAW,QAAQ;IACvB,8BAA8B;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,iBAAiB;IACjB,IAAI,EAAE,QAAQ,CAAC;IACf,6DAA6D;IAC7D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iCAAiC;IACjC,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yDAAyD;IACzD,SAAS,IAAI,QAAQ,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,YAAY,IAAI,MAAM,CAAC;IACvB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IACpD,OAAO,CACL,QAAQ,EAAE,UAAU,EAAE,EAAE,EACxB,MAAM,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,YAAY,GAC1B,IAAI,CAAC;IACR,SAAS,CACP,QAAQ,EAAE,WAAW,EAAE,EACvB,aAAa,CAAC,EAAE,UAAU,EAAE,GAC3B,MAAM,CAAC;IACV,aAAa,CACX,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,MAAM,GACnB,IAAI,CAAC;IACR,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9C,OAAO,CACL,UAAU,EAAE,MAAM,EAClB,YAAY,CAAC,EAAE,YAAY,EAC3B,aAAa,CAAC,EAAE,MAAM,EACtB,KAAK,CAAC,EAAE,MAAM,GACb,MAAM,CAAC;IACV,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAC1E,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,KAAK,IAAI,gBAAgB,CAAC;CAC3B"}

package/dist/interfaces.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Backend interfaces for the Sayiir flow builder.
+ *
+ * These abstract over the concrete builder implementation (NAPI-RS, WASM, etc.)
+ * so the pure-TypeScript DSL can be used without native dependencies.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=interfaces.js.map

package/dist/interfaces.js.map

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

package/dist/task.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Task definition for workflow steps.
+ *
+ * The `task()` function wraps a function with metadata (id, timeout, retries)
+ * and optionally Zod schemas for input/output validation. The Flow builder
+ * reads these properties when constructing workflows.
+ */
+import type { TaskOptions, ZodLike } from "./types.js";
+import type { TaskMetadata } from "./interfaces.js";
+/** Branded type for a registered task function. */
+export interface TaskFn<TIn, TOut> {
+    (input: TIn): TOut | Promise<TOut>;
+    readonly _taskId: string;
+    readonly _metadata: TaskMetadata;
+    readonly _inputSchema?: ZodLike<TIn>;
+    readonly _outputSchema?: ZodLike<TOut>;
+    readonly _rawFn: (input: TIn) => TOut | Promise<TOut>;
+}
+/**
+ * Define a named task with optional configuration.
+ *
+ * ```ts
+ * const getUser = task("get-user", async (id: number) => {
+ *   return await db.getUser(id);
+ * }, { timeout: "30s", retries: 3 });
+ * ```
+ */
+export declare function task<TIn, TOut>(id: string, fn: (input: TIn) => TOut | Promise<TOut>, opts?: TaskOptions<TIn>): TaskFn<TIn, TOut>;
+//# sourceMappingURL=task.d.ts.map

package/dist/task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../src/task.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAe,WAAW,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAEpE,OAAO,KAAK,EAAqB,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEvE,mDAAmD;AACnD,MAAM,WAAW,MAAM,CAAC,GAAG,EAAE,IAAI;IAC/B,CAAC,KAAK,EAAE,GAAG,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;IACjC,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IACrC,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvD;AAED;;;;;;;;GAQG;AACH,wBAAgB,IAAI,CAAC,GAAG,EAAE,IAAI,EAC5B,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,EACxC,IAAI,CAAC,EAAE,WAAW,CAAC,GAAG,CAAC,GACtB,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAiBnB"}