@fluidgrids/workflows 2026.1028.2 → 2026.1030.1

package/dist/{chunk-FMSW2HDF.cjs → chunk-ZCGKGDCL.cjs}

@@ -1,7 +1,5 @@
 'use strict';
 
-var chunkFR7KYWRO_cjs = require('./chunk-FR7KYWRO.cjs');
-
 // src/durable/definitions.ts
 function checkName(name, what) {
   if (typeof name !== "string" || name === "" || name.startsWith("__"))
@@ -86,16 +84,36 @@ var ApplicationError = class extends WorkflowFailure {
   }
 };
 var ActivityFailure = class extends WorkflowFailure {
-  constructor(message, activityId, nodeType, operation, cause) {
+  constructor(message, activityId, nodeType, operation, cause, activityName) {
     super(message, cause instanceof WorkflowFailure ? cause.errorType : "UNKNOWN", { cause });
     this.activityId = activityId;
     this.nodeType = nodeType;
     this.operation = operation;
+    this.activityName = activityName;
     this.name = "ActivityFailure";
   }
   activityId;
   nodeType;
   operation;
+  activityName;
+};
+var ActivityPausedError = class extends ApplicationError {
+  constructor(message = "The activity was paused", details) {
+    super(message, {
+      type: "ActivityPausedError",
+      errorType: "TRANSIENT",
+      ...details !== void 0 ? { details } : {}
+    });
+    this.name = "ActivityPausedError";
+  }
+};
+var QueryHandlerSideEffect = class extends Error {
+  constructor(what) {
+    super(
+      `${what} is not allowed in a query handler or an update validator; they must not change the run`
+    );
+    this.name = "QueryHandlerSideEffect";
+  }
 };
 var ChildRunFailure = class extends WorkflowFailure {
   constructor(message, childId, childRunId, cause) {
@@ -234,23 +252,15 @@ function failureToError(failure, depth = 0) {
   return error;
 }
 
-// src/durable/durations.ts
-function toMs(value, what = "duration") {
-  const ms = chunkFR7KYWRO_cjs.durationMs(value, "ms");
-  if (ms === void 0) throw new TypeError(`${what} "${String(value)}" is not a duration`);
-  return Math.round(ms);
-}
-function optionalMs(value, what) {
-  return value === void 0 ? void 0 : toMs(value, what);
-}
-
 exports.ActivityFailure = ActivityFailure;
+exports.ActivityPausedError = ActivityPausedError;
 exports.ApplicationError = ApplicationError;
 exports.CancelledFailure = CancelledFailure;
 exports.ChildRunFailure = ChildRunFailure;
 exports.DeterminismViolation = DeterminismViolation;
 exports.HistoryLimitExceeded = HistoryLimitExceeded;
 exports.PhaseCFeatureError = PhaseCFeatureError;
+exports.QueryHandlerSideEffect = QueryHandlerSideEffect;
 exports.ServerFailure = ServerFailure;
 exports.TerminatedFailure = TerminatedFailure;
 exports.TimeoutFailure = TimeoutFailure;
@@ -262,6 +272,4 @@ exports.errorToFailure = errorToFailure;
 exports.failureToError = failureToError;
 exports.isCancellation = isCancellation;
 exports.isRunFailure = isRunFailure;
-exports.optionalMs = optionalMs;
 exports.signalName = signalName;
-exports.toMs = toMs;

package/dist/codegen/index.d.cts

@@ -1,5 +1,5 @@
-import { N as NodeManifest } from '../manifest-0OLw0i7k.cjs';
-import '../types-BGoPzgcl.cjs';
+import { N as NodeManifest } from '../manifest-DahBQVM8.cjs';
+import '../types-V7jEEUaL.cjs';
 
 interface GeneratedClients {
     path: string;

package/dist/codegen/index.d.ts

@@ -1,5 +1,5 @@
-import { N as NodeManifest } from '../manifest-C8N6HDYl.js';
-import '../types-BGoPzgcl.js';
+import { N as NodeManifest } from '../manifest-D-I_twys.js';
+import '../types-V7jEEUaL.js';
 
 interface GeneratedClients {
     path: string;

package/dist/collect-6NIEufHd.d.ts

@@ -0,0 +1,103 @@
+import { P as Position, J as JsonObject, d as ConnectionRef, i as WorkflowAuthoring, W as WorkflowDefinition, b as WorkflowInterface, k as WorkflowConfig } from './types-V7jEEUaL.js';
+import { T as Tier1Recording, x as Tier1Workflow } from './workflow-B18OeF7g.js';
+
+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`, `dynamic`. */
+    features?: string[];
+    /** A dynamic workflow (Phase C): `lower()` writes it as `code.exports.workflows["*"]`. */
+    dynamic?: boolean;
+}
+/** An exported user-activity implementation found in the workflow bundle (Phase C). */
+interface CollectedActivityImplementation {
+    module: string;
+    exportName: string;
+    name: string;
+}
+interface Tier1Collection {
+    format: typeof COLLECTION_FORMAT;
+    workflows: CollectedWorkflow[];
+    /** Tier-2 functions; absent when the bundle has none. */
+    durable?: CollectedDurableWorkflow[];
+    /** User-activity implementations exported by bundle modules; they belong on a worker. */
+    activityImplementations?: CollectedActivityImplementation[];
+    /**
+     * Modules that export a binding named `interceptors`, whatever its value:
+     * the runtime registers those exports as workflow interceptors, so
+     * `lower()` reports the `interceptors` feature from the evaluated modules
+     * rather than from the source text (C-FEATURES).
+     */
+    interceptorModules?: string[];
+}
+/** 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 };

package/dist/collect-CcTCKqx6.d.cts

@@ -0,0 +1,103 @@
+import { P as Position, J as JsonObject, d as ConnectionRef, i as WorkflowAuthoring, W as WorkflowDefinition, b as WorkflowInterface, k as WorkflowConfig } from './types-V7jEEUaL.cjs';
+import { T as Tier1Recording, x as Tier1Workflow } from './workflow-BJPFv3cp.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`, `dynamic`. */
+    features?: string[];
+    /** A dynamic workflow (Phase C): `lower()` writes it as `code.exports.workflows["*"]`. */
+    dynamic?: boolean;
+}
+/** An exported user-activity implementation found in the workflow bundle (Phase C). */
+interface CollectedActivityImplementation {
+    module: string;
+    exportName: string;
+    name: string;
+}
+interface Tier1Collection {
+    format: typeof COLLECTION_FORMAT;
+    workflows: CollectedWorkflow[];
+    /** Tier-2 functions; absent when the bundle has none. */
+    durable?: CollectedDurableWorkflow[];
+    /** User-activity implementations exported by bundle modules; they belong on a worker. */
+    activityImplementations?: CollectedActivityImplementation[];
+    /**
+     * Modules that export a binding named `interceptors`, whatever its value:
+     * the runtime registers those exports as workflow interceptors, so
+     * `lower()` reports the `interceptors` feature from the evaluated modules
+     * rather than from the source text (C-FEATURES).
+     */
+    interceptorModules?: string[];
+}
+/** 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 };