@fluidgrids/workflows 2026.1028.2 → 2026.1029.1

package/dist/collect-CSyOg5XC.d.cts

@@ -0,0 +1,86 @@
+import { P as Position, a as JsonObject, d as ConnectionRef, i as WorkflowAuthoring, W as WorkflowDefinition, b as WorkflowInterface, k as WorkflowConfig } from './types-Bb2wRnJ5.cjs';
+import { T as Tier1Recording, x as Tier1Workflow } from './workflow-CZOXUlQ5.cjs';
+
+declare const LAYOUT_FORMAT = "fluidgrids.layout";
+declare const LAYOUT_FORMAT_VERSION = 1;
+/**
+ * The layout sidecar (`workflows/<key>.layout.json`): canvas positions, sticky
+ * notes and `meta.layout`, kept out of the code so it stays readable.
+ */
+interface LayoutSidecar {
+    format: typeof LAYOUT_FORMAT;
+    formatVersion: typeof LAYOUT_FORMAT_VERSION;
+    positions: Record<string, Position>;
+    stickyNotes?: JsonObject[];
+    metaLayout?: JsonObject;
+}
+/** How connection names in code resolve to connection references. */
+type ConnectionResolver = Readonly<Record<string, ConnectionRef>> | ((name: string) => ConnectionRef | undefined);
+interface AssembleOptions {
+    layout?: LayoutSidecar;
+    connections?: ConnectionResolver;
+    /** TEST-only pinned data (`workflows/<key>.pinned.json`). */
+    pinnedData?: JsonObject;
+    /** Provenance; defaults to `{ mode: 'canvas', generator: 'sdk-ts', generatorVersion }`. */
+    authoring?: WorkflowAuthoring;
+}
+/** Connection names used in code that the target workspace does not have. */
+declare class UnresolvedConnectionsError extends Error {
+    readonly names: string[];
+    constructor(names: string[]);
+}
+/** Validate a parsed layout sidecar. */
+declare function parseLayoutSidecar(value: unknown): LayoutSidecar;
+/** Assemble IR v2 from a recording. */
+declare function assembleRecording(recording: Tier1Recording, options?: AssembleOptions): WorkflowDefinition;
+/** Lower a tier-1 workflow to IR v2 (spec 10 §1 `toIR`). */
+declare function toIR(workflow: Tier1Workflow, options?: AssembleOptions): WorkflowDefinition;
+
+/**
+ * Runs inside the evaluation isolate at the end of a bundle: gathers the
+ * recordings of every exported `defineWorkflow` value and the declarations of
+ * every exported tier-2 `workflow()` as one JSON string, the only thing that
+ * leaves the isolate.
+ */
+
+declare const COLLECTION_FORMAT = "fluidgrids.tier1-collection";
+interface CollectedWorkflow {
+    module: string;
+    exportName: string;
+    recording: Tier1Recording;
+}
+/** The trigger a standalone tier-2 workflow declares. */
+interface CollectedTrigger {
+    nodeType: string;
+    version?: string;
+    operation?: string;
+    args?: JsonObject;
+    id?: string;
+}
+/** One exported tier-2 workflow (C-ABI `durable` entries of the collection). */
+interface CollectedDurableWorkflow {
+    module: string;
+    exportName: string;
+    /** The workflow key it gets when standalone. */
+    name: string;
+    title?: string;
+    description?: string;
+    taskQueue: string;
+    interface: WorkflowInterface;
+    standalone?: boolean;
+    trigger?: CollectedTrigger;
+    /** Run-level settings the declaration lowers into `config` (R2). */
+    config?: WorkflowConfig;
+    /** Runtime features its options use (C-FEATURES): `autoUpgrade`, `runRetry`, `timeouts`. */
+    features?: string[];
+}
+interface Tier1Collection {
+    format: typeof COLLECTION_FORMAT;
+    workflows: CollectedWorkflow[];
+    /** Tier-2 functions; absent when the bundle has none. */
+    durable?: CollectedDurableWorkflow[];
+}
+/** Collect the workflows exported by each module, as JSON. */
+declare function collectWorkflowExports(modules: ReadonlyArray<readonly [string, Record<string, unknown>]>): string;
+
+export { type AssembleOptions as A, COLLECTION_FORMAT as C, LAYOUT_FORMAT as L, type Tier1Collection as T, UnresolvedConnectionsError as U, type CollectedDurableWorkflow as a, type CollectedTrigger as b, type CollectedWorkflow as c, type ConnectionResolver as d, LAYOUT_FORMAT_VERSION as e, type LayoutSidecar as f, assembleRecording as g, collectWorkflowExports as h, parseLayoutSidecar as p, toIR as t };