@fluidgrids/workflows 0.0.0-stage → 2026.1027.1

package/dist/expressions-DhHaqyar.d.ts

@@ -0,0 +1,62 @@
+/**
+ * The `{{ … }}` forms that typed references lower to, and their parser.
+ *
+ * Typed references lower to the expression language the workers evaluate
+ * (`fluidgrids-workers/src/executor/expression-language.service.ts`). A node's
+ * output is `$node["<id>"].item` there: the builtin exposes `item`, `all()`,
+ * `first()` and `last()`, and has no `.json` property, so the
+ * `$node["id"].json.…` form written in parts of the spec would evaluate to
+ * `undefined`. The canonical form is therefore `{{ $node["<id>"].item.<path> }}`,
+ * with exactly one space inside each brace pair.
+ *
+ * Parsing is strict: a string is read back as a reference only if formatting
+ * the parsed reference reproduces the string exactly, so lifting never changes
+ * the text of an expression.
+ */
+/** One path step: a property name or an array index. */
+type PathSegment = {
+    kind: 'key';
+    key: string;
+} | {
+    kind: 'index';
+    index: number;
+};
+/** The roots a typed reference can start from. */
+type RefRoot = {
+    kind: 'node';
+    nodeId: string;
+} | {
+    kind: 'json';
+} | {
+    kind: 'vars';
+} | {
+    kind: 'now';
+} | {
+    kind: 'execution';
+};
+interface ValueRefModel {
+    root: RefRoot;
+    path: PathSegment[];
+}
+/** The bare expression for a reference (no braces). */
+declare function formatRefExpression(ref: ValueRefModel): string;
+/** `{{ <expression> }}` for a reference. */
+declare function formatRefTemplate(ref: ValueRefModel): string;
+/** Parse a bare reference expression; undefined unless it formats back identically. */
+declare function parseRefExpression(expression: string): ValueRefModel | undefined;
+/** One part of a template string: literal text or a reference. */
+type TemplatePart = {
+    kind: 'text';
+    text: string;
+} | {
+    kind: 'ref';
+    ref: ValueRefModel;
+};
+/**
+ * Split a string into literal text and `{{ ref }}` parts. Returns undefined when
+ * the string contains a `{{ … }}` that is not a canonical reference, or no
+ * reference at all.
+ */
+declare function parseTemplate(text: string): TemplatePart[] | undefined;
+
+export { type PathSegment as P, type RefRoot as R, type TemplatePart as T, type ValueRefModel as V, formatRefTemplate as a, parseTemplate as b, formatRefExpression as f, parseRefExpression as p };

package/dist/hash-CZkTXPCX.d.cts

@@ -0,0 +1,15 @@
+/** The projection of a definition that `irHash` covers. */
+declare function hashedProjection(definition: unknown): unknown;
+/** `sha256:<hex>` over the canonical, normalised definition without `authoring`. */
+declare function irHash(definition: unknown): string;
+/** One authoring source file. */
+interface SourceFile {
+    path: string;
+    content: string;
+}
+/** `sha256:<hex>` over the source files, independent of their order. */
+declare function sourceHash(files: readonly SourceFile[]): string;
+/** `sha256:<hex>` of a bundle. */
+declare function buildIdOf(bundle: string): string;
+
+export { type SourceFile as S, buildIdOf as b, hashedProjection as h, irHash as i, sourceHash as s };

package/dist/hash-CZkTXPCX.d.ts

@@ -0,0 +1,15 @@
+/** The projection of a definition that `irHash` covers. */
+declare function hashedProjection(definition: unknown): unknown;
+/** `sha256:<hex>` over the canonical, normalised definition without `authoring`. */
+declare function irHash(definition: unknown): string;
+/** One authoring source file. */
+interface SourceFile {
+    path: string;
+    content: string;
+}
+/** `sha256:<hex>` over the source files, independent of their order. */
+declare function sourceHash(files: readonly SourceFile[]): string;
+/** `sha256:<hex>` of a bundle. */
+declare function buildIdOf(bundle: string): string;
+
+export { type SourceFile as S, buildIdOf as b, hashedProjection as h, irHash as i, sourceHash as s };

package/dist/index.cjs

@@ -0,0 +1,117 @@
+'use strict';
+
+var chunkTQF7MYEN_cjs = require('./chunk-TQF7MYEN.cjs');
+require('./chunk-G4UEPUGO.cjs');
+var chunk6AIAC2FP_cjs = require('./chunk-6AIAC2FP.cjs');
+require('./chunk-E3APHA6O.cjs');
+
+
+
+Object.defineProperty(exports, "COLLECTION_FORMAT", {
+  enumerable: true,
+  get: function () { return chunkTQF7MYEN_cjs.COLLECTION_FORMAT; }
+});
+Object.defineProperty(exports, "LAYOUT_FORMAT", {
+  enumerable: true,
+  get: function () { return chunkTQF7MYEN_cjs.LAYOUT_FORMAT; }
+});
+Object.defineProperty(exports, "LAYOUT_FORMAT_VERSION", {
+  enumerable: true,
+  get: function () { return chunkTQF7MYEN_cjs.LAYOUT_FORMAT_VERSION; }
+});
+Object.defineProperty(exports, "RECORDING_FORMAT", {
+  enumerable: true,
+  get: function () { return chunkTQF7MYEN_cjs.RECORDING_FORMAT; }
+});
+Object.defineProperty(exports, "RECORDING_FORMAT_VERSION", {
+  enumerable: true,
+  get: function () { return chunkTQF7MYEN_cjs.RECORDING_FORMAT_VERSION; }
+});
+Object.defineProperty(exports, "SDK_VERSION", {
+  enumerable: true,
+  get: function () { return chunkTQF7MYEN_cjs.SDK_VERSION; }
+});
+Object.defineProperty(exports, "UnresolvedConnectionsError", {
+  enumerable: true,
+  get: function () { return chunkTQF7MYEN_cjs.UnresolvedConnectionsError; }
+});
+Object.defineProperty(exports, "WorkflowBuilder", {
+  enumerable: true,
+  get: function () { return chunkTQF7MYEN_cjs.WorkflowBuilder; }
+});
+Object.defineProperty(exports, "assembleRecording", {
+  enumerable: true,
+  get: function () { return chunkTQF7MYEN_cjs.assembleRecording; }
+});
+Object.defineProperty(exports, "collectWorkflowExports", {
+  enumerable: true,
+  get: function () { return chunkTQF7MYEN_cjs.collectWorkflowExports; }
+});
+Object.defineProperty(exports, "defaultEdgeId", {
+  enumerable: true,
+  get: function () { return chunkTQF7MYEN_cjs.defaultEdgeId; }
+});
+Object.defineProperty(exports, "defineWorkflow", {
+  enumerable: true,
+  get: function () { return chunkTQF7MYEN_cjs.defineWorkflow; }
+});
+Object.defineProperty(exports, "edge", {
+  enumerable: true,
+  get: function () { return chunkTQF7MYEN_cjs.edge; }
+});
+Object.defineProperty(exports, "internalNodes", {
+  enumerable: true,
+  get: function () { return chunkTQF7MYEN_cjs.internalNodes; }
+});
+Object.defineProperty(exports, "isOperation", {
+  enumerable: true,
+  get: function () { return chunkTQF7MYEN_cjs.isOperation; }
+});
+Object.defineProperty(exports, "isTier1Workflow", {
+  enumerable: true,
+  get: function () { return chunkTQF7MYEN_cjs.isTier1Workflow; }
+});
+Object.defineProperty(exports, "nodes", {
+  enumerable: true,
+  get: function () { return chunkTQF7MYEN_cjs.nodes; }
+});
+Object.defineProperty(exports, "op", {
+  enumerable: true,
+  get: function () { return chunkTQF7MYEN_cjs.op; }
+});
+Object.defineProperty(exports, "parseLayoutSidecar", {
+  enumerable: true,
+  get: function () { return chunkTQF7MYEN_cjs.parseLayoutSidecar; }
+});
+Object.defineProperty(exports, "toIR", {
+  enumerable: true,
+  get: function () { return chunkTQF7MYEN_cjs.toIR; }
+});
+Object.defineProperty(exports, "trigger", {
+  enumerable: true,
+  get: function () { return chunkTQF7MYEN_cjs.trigger; }
+});
+Object.defineProperty(exports, "triggers", {
+  enumerable: true,
+  get: function () { return chunkTQF7MYEN_cjs.triggers; }
+});
+Object.defineProperty(exports, "BuilderError", {
+  enumerable: true,
+  get: function () { return chunk6AIAC2FP_cjs.BuilderError; }
+});
+Object.defineProperty(exports, "PREDICATE_OPERATORS", {
+  enumerable: true,
+  get: function () { return chunk6AIAC2FP_cjs.PREDICATE_OPERATORS; }
+});
+Object.defineProperty(exports, "and", {
+  enumerable: true,
+  get: function () { return chunk6AIAC2FP_cjs.and; }
+});
+Object.defineProperty(exports, "expr", {
+  enumerable: true,
+  get: function () { return chunk6AIAC2FP_cjs.expr; }
+});
+Object.defineProperty(exports, "or", {
+  enumerable: true,
+  get: function () { return chunk6AIAC2FP_cjs.or; }
+});

package/dist/index.d.cts

@@ -0,0 +1,27 @@
+import { T as Tier1Recording } from './assemble-DEf3znGD.cjs';
+export { A as AfterInput, a as AnyRef, b as ApprovalRef, c as ArgValue, d as ArgsOf, e as AssembleOptions, B as BuilderError, C as CompareRef, f as ConditionGroup, g as ConditionRule, h as ConnectionResolver, E as EdgeOptions, i as EdgeSource, j as EdgeSpec, F as FileRef, H as HandleRef, I as IfOptions, k as IfRef, L as LAYOUT_FORMAT, l as LAYOUT_FORMAT_VERSION, m as LayoutSidecar, n as LoopOptions, o as LoopRef, M as MergeOptions, N as NodeOptions, p as NodeRef, q as NoteOptions, O as OnErrorOption, r as Operation, s as OutputRef, P as PREDICATE_OPERATORS, t as Predicate, u as PredicateMethods, R as RECORDING_FORMAT, v as RECORDING_FORMAT_VERSION, w as RecordedNode, x as RecordedNote, y as RuleValue, S as SignalWaitRef, z as SubworkflowOptions, D as SwitchOptions, G as SwitchRef, J as Tier1Workflow, K as TriggerOperation, U as UnresolvedConnectionsError, V as ValidateRef, W as WaitForSignalOptions, Q as WorkflowBuilder, X as WorkflowOptions, Y as and, Z as assembleRecording, _ as defaultEdgeId, $ as defineWorkflow, a0 as edge, a1 as expr, a2 as internalNodes, a3 as isOperation, a4 as isTier1Workflow, a5 as nodes, a6 as op, a7 as or, a8 as parseLayoutSidecar, a9 as toIR, aa as trigger, ab as triggers } from './assemble-DEf3znGD.cjs';
+export { J as Json, a as JsonObject, W as WorkflowDefinition } from './types-Dr2Fn1Ax.cjs';
+
+/**
+ * Runs inside the evaluation isolate at the end of a tier-1 bundle: gathers the
+ * recordings of every exported `defineWorkflow` value 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;
+}
+interface Tier1Collection {
+    format: typeof COLLECTION_FORMAT;
+    workflows: CollectedWorkflow[];
+}
+/** Collect the tier-1 workflows exported by each module, as JSON. */
+declare function collectWorkflowExports(modules: ReadonlyArray<readonly [string, Record<string, unknown>]>): string;
+
+/** The version of @fluidgrids/workflows. */
+declare const SDK_VERSION = "2026.1027.1";
+
+export { COLLECTION_FORMAT, type CollectedWorkflow, SDK_VERSION, type Tier1Collection, Tier1Recording, collectWorkflowExports };

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+import { T as Tier1Recording } from './assemble-CrpUyd_3.js';
+export { A as AfterInput, a as AnyRef, b as ApprovalRef, c as ArgValue, d as ArgsOf, e as AssembleOptions, B as BuilderError, C as CompareRef, f as ConditionGroup, g as ConditionRule, h as ConnectionResolver, E as EdgeOptions, i as EdgeSource, j as EdgeSpec, F as FileRef, H as HandleRef, I as IfOptions, k as IfRef, L as LAYOUT_FORMAT, l as LAYOUT_FORMAT_VERSION, m as LayoutSidecar, n as LoopOptions, o as LoopRef, M as MergeOptions, N as NodeOptions, p as NodeRef, q as NoteOptions, O as OnErrorOption, r as Operation, s as OutputRef, P as PREDICATE_OPERATORS, t as Predicate, u as PredicateMethods, R as RECORDING_FORMAT, v as RECORDING_FORMAT_VERSION, w as RecordedNode, x as RecordedNote, y as RuleValue, S as SignalWaitRef, z as SubworkflowOptions, D as SwitchOptions, G as SwitchRef, J as Tier1Workflow, K as TriggerOperation, U as UnresolvedConnectionsError, V as ValidateRef, W as WaitForSignalOptions, Q as WorkflowBuilder, X as WorkflowOptions, Y as and, Z as assembleRecording, _ as defaultEdgeId, $ as defineWorkflow, a0 as edge, a1 as expr, a2 as internalNodes, a3 as isOperation, a4 as isTier1Workflow, a5 as nodes, a6 as op, a7 as or, a8 as parseLayoutSidecar, a9 as toIR, aa as trigger, ab as triggers } from './assemble-CrpUyd_3.js';
+export { J as Json, a as JsonObject, W as WorkflowDefinition } from './types-Dr2Fn1Ax.js';
+
+/**
+ * Runs inside the evaluation isolate at the end of a tier-1 bundle: gathers the
+ * recordings of every exported `defineWorkflow` value 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;
+}
+interface Tier1Collection {
+    format: typeof COLLECTION_FORMAT;
+    workflows: CollectedWorkflow[];
+}
+/** Collect the tier-1 workflows exported by each module, as JSON. */
+declare function collectWorkflowExports(modules: ReadonlyArray<readonly [string, Record<string, unknown>]>): string;
+
+/** The version of @fluidgrids/workflows. */
+declare const SDK_VERSION = "2026.1027.1";
+
+export { COLLECTION_FORMAT, type CollectedWorkflow, SDK_VERSION, type Tier1Collection, Tier1Recording, collectWorkflowExports };

package/dist/index.js

@@ -0,0 +1,4 @@
+export { COLLECTION_FORMAT, LAYOUT_FORMAT, LAYOUT_FORMAT_VERSION, RECORDING_FORMAT, RECORDING_FORMAT_VERSION, SDK_VERSION, UnresolvedConnectionsError, WorkflowBuilder, assembleRecording, collectWorkflowExports, defaultEdgeId, defineWorkflow, edge, internalNodes, isOperation, isTier1Workflow, nodes, op, parseLayoutSidecar, toIR, trigger, triggers } from './chunk-EEAIM35V.js';
+import './chunk-5LUIDMF4.js';
+export { BuilderError, PREDICATE_OPERATORS, and, expr, or } from './chunk-UB2BHU2M.js';
+import './chunk-UJNHTS6D.js';