@fluidgrids/workflows 2026.1028.2 → 2026.1030.1

package/dist/index.d.ts

@@ -1,54 +1,12 @@
-import { T as Tier1Recording } from './workflow-Bpr3vnA_.js';
-export { A as AfterInput, a as AnyRef, b as ApprovalRef, c as ArgValue, d as ArgsOf, B as BuilderError, C as CodeWorkflowOptions, e as CompareRef, f as ConditionGroup, g as ConditionRule, D as DurableRef, E as EdgeOptions, h as EdgeSource, i as EdgeSpec, H as HandleRef, I as IfOptions, j as IfRef, L as LoopOptions, k as LoopRef, M as MergeOptions, N as NodeOptions, l as NodeRef, m as NoteOptions, O as OnErrorOption, n as OutputRef, P as PREDICATE_OPERATORS, o as Predicate, p as PredicateMethods, R as RECORDING_FORMAT, q as RECORDING_FORMAT_VERSION, r as RecordedNode, s as RecordedNote, t as RuleValue, S as SignalWaitRef, u as SubworkflowOptions, v as SwitchOptions, w as SwitchRef, x as Tier1Workflow, V as ValidateRef, W as WaitForSignalOptions, y as WorkflowBuilder, z as WorkflowOptions, F as and, G as defaultEdgeId, J as defineWorkflow, K as edge, Q as expr, U as isTier1Workflow, X as or } from './workflow-Bpr3vnA_.js';
-export { C as CancellationScope, a as CancellationScopeFunction, b as CancellationScopeOptions, c as ChildHandle, d as ChildOptions, e as ChildTarget, f as ContinueAsNewOptions, D as DURABLE_MARKER, g as DefinitionOptions, h as DurableWorkflow, i as DurableWorkflowOptions, j as Duration, E as ExternalRunHandle, F as FileRef, O as Operation, Q as QueryDefinition, R as RunOptions, S as Saga, k as SchemaLike, l as SignalDefinition, T as TriggerOperation, m as TriggerSpec, U as UpdateDefinition, W as WorkflowContext, n as WorkflowInfo, o as WorkflowLogger, p as defineQuery, q as defineSignal, r as defineUpdate, s as interfaceOf, t as internalNodes, u as isDurableWorkflow, v as isOperation, w as jsonSchemaOf, x as nodes, y as op, z as toMs, A as trigger, B as triggers, G as workflow } from './workflow-C2a05WUJ.js';
-export { A as AssembleOptions, C as ConnectionResolver, L as LAYOUT_FORMAT, a as LAYOUT_FORMAT_VERSION, b as LayoutSidecar, U as UnresolvedConnectionsError, c as assembleRecording, p as parseLayoutSidecar, t as toIR } from './assemble-DWgaXHd-.js';
-import { W as WorkflowInterface, J as JsonObject, E as ErrorType, a as Json } from './types-BGoPzgcl.js';
-export { b as WorkflowDefinition } from './types-BGoPzgcl.js';
-import { F as Failure } from './types-DV-HX_Gt.js';
-export { P as ParentClosePolicy, R as RetryPolicy } from './types-DV-HX_Gt.js';
-
-/**
- * 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;
-}
-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 { A as AfterInput, a as AnyRef, b as ApprovalRef, c as ArgValue, d as ArgsOf, B as BuilderError, C as CodeWorkflowOptions, e as CompareRef, f as ConditionGroup, g as ConditionRule, D as DurableRef, E as EdgeOptions, h as EdgeSource, i as EdgeSpec, H as HandleRef, I as IfOptions, j as IfRef, L as LoopOptions, k as LoopRef, M as MergeOptions, N as NodeOptions, l as NodeRef, m as NoteOptions, O as OnErrorOption, n as OutputRef, P as PREDICATE_OPERATORS, o as Predicate, p as PredicateMethods, R as RECORDING_FORMAT, q as RECORDING_FORMAT_VERSION, r as RecordedNode, s as RecordedNote, t as RuleValue, S as SignalWaitRef, u as SubworkflowOptions, v as SwitchOptions, w as SwitchRef, T as Tier1Recording, x as Tier1Workflow, V as ValidateRef, W as WaitForSignalOptions, y as WorkflowBuilder, z as WorkflowOptions, F as and, G as defaultEdgeId, J as defineWorkflow, K as edge, Q as expr, U as isTier1Workflow, X as or } from './workflow-B18OeF7g.js';
+export { A as ACTIVITY_IMPL_MARKER, a as ACTIVITY_MARKER, b as AbortSignalLike, c as ActivityContext, d as ActivityDeclarationOptions, e as ActivityDefinition, f as ActivityExecuteInput, g as ActivityFunction, h as ActivityImplementation, i as ActivityInboundInterceptor, j as ActivityInfo, k as ActivityOptions, l as ActivityOutboundInterceptor, C as CancellationScope, m as CancellationScopeFunction, n as CancellationScopeOptions, o as ChildHandle, p as ChildOptions, q as ChildTarget, r as ContinueAsNewOptions, D as DURABLE_MARKER, s as DYNAMIC_ACTIVITY_NAME, t as DefaultUpdateHandlerOptions, u as DefinitionOptions, v as DurableWorkflow, w as DurableWorkflowOptions, x as Duration, E as ExternalRunHandle, y as ExternalRunTarget, F as FileRef, H as HandlerUnfinishedPolicy, L as LegacyContinueAsNewRetry, z as LocalActivityOptions, M as MAX_WORKFLOW_TASK_TIMEOUT_MS, O as Operation, Q as QueryDefinition, R as RunOptions, S as Saga, B as SchemaLike, G as SignalDefinition, I as SignalHandlerOptions, T as TriggerOperation, J as TriggerSpec, U as UpdateDefinition, K as UpdateHandlerOptions, W as WorkflowContext, N as WorkflowIdTarget, P as WorkflowInfo, V as WorkflowLogger, X as WorkflowRetryOptions, Y as WorkflowSinks, Z as checkActivityName, _ as checkTaskQueueName, $ as continueAsNewRetryOf, a0 as declareActivity, a1 as defineActivity, a2 as defineQuery, a3 as defineSignal, a4 as defineUpdate, a5 as dynamicActivity, a6 as dynamicWorkflow, a7 as executeActivity, a8 as findActivityImplementation, a9 as implementActivity, aa as interfaceOf, ab as internalNodes, ac as isActivityDefinition, ad as isActivityImplementation, ae as isDurableWorkflow, af as isOperation, ag as jsonSchemaOf, ah as nodes, ai as op, aj as runRetryPolicyOf, ak as toMs, al as trigger, am as triggers, an as workflow } from './workflow-BGnv8SS6.js';
+export { A as AssembleOptions, C as COLLECTION_FORMAT, a as CollectedDurableWorkflow, b as CollectedTrigger, c as CollectedWorkflow, d as ConnectionResolver, L as LAYOUT_FORMAT, e as LAYOUT_FORMAT_VERSION, f as LayoutSidecar, T as Tier1Collection, U as UnresolvedConnectionsError, g as assembleRecording, h as collectWorkflowExports, p as parseLayoutSidecar, t as toIR } from './collect-6NIEufHd.js';
+import { E as ErrorType, a as Json } from './types-V7jEEUaL.js';
+export { J as JsonObject, W as WorkflowDefinition } from './types-V7jEEUaL.js';
+import { F as Failure } from './types-DGx-b9eq.js';
+export { P as ParentClosePolicy, e as RetryPolicy, f as RunRetryPolicy, at as VersioningBehavior, ax as WorkflowIdConflictPolicy, ay as WorkflowIdReusePolicy } from './types-DGx-b9eq.js';
+export { C as CancelRunInput, a as ContinueAsNewInput, I as INTERCEPTORS_MARKER, M as MarkedInterceptorsFactory, Q as QueryInput, S as ScheduleActivityInput, b as ScheduleLocalActivityInput, c as SignalInput, d as SignalRunInput, e as StartChildInput, f as StartTimerInput, U as UpdateInput, g as UpsertContextInput, h as UpsertSearchAttributesInput, W as WorkflowExecuteInput, i as WorkflowInboundInterceptor, j as WorkflowInterceptors, k as WorkflowInterceptorsFactory, l as WorkflowOutboundInterceptor, m as composeInterceptors, n as interceptorsFactoryOf, r as resolveWorkflowInterceptors, w as workflowInterceptors } from './interceptors-CNcr2dlk.js';
+export { E as ENCODED_PAYLOAD_MARKER, c as EncodedPayload, i as isEncodedPayload } from './payload-fields-oOBWxDiG.js';
 
 /**
  * Failure classes of tier-2 workflow code (spec 02 §4, 11 §2.25).
@@ -91,12 +49,34 @@ declare class ApplicationError extends WorkflowFailure {
     readonly category: 'BENIGN' | undefined;
     constructor(message: string, options?: ApplicationErrorOptions);
 }
-/** The final failure of an activity, after its retries. `cause` is the last attempt's failure. */
+/**
+ * The final failure of an activity, after its retries. `cause` is the last
+ * attempt's failure. A user activity (Phase C) has an empty `nodeType`, its
+ * name as `operation` and as `activityName`.
+ */
 declare class ActivityFailure extends WorkflowFailure {
     readonly activityId: string;
     readonly nodeType: string;
     readonly operation: string;
-    constructor(message: string, activityId: string, nodeType: string, operation: string, cause: Error);
+    readonly activityName?: string | undefined;
+    constructor(message: string, activityId: string, nodeType: string, operation: string, cause: Error, activityName?: string | undefined);
+}
+/**
+ * Thrown by an activity whose attempt was paused (`pauseActivity`, 11 §2.28),
+ * after a heartbeat reported `paused`. The engine does not retry it while the
+ * activity is paused, and the workflow sees nothing: its awaitable stays
+ * pending until the activity is unpaused or reset.
+ */
+declare class ActivityPausedError extends ApplicationError {
+    constructor(message?: string, details?: Json);
+}
+/**
+ * A query handler or an update validator tried to change the run: issue a
+ * command (an activity, a timer, a child, a signal, a side effect, ...) or
+ * call a sink. Queries and validators are read-only (05 §5, 11 §2.39).
+ */
+declare class QueryHandlerSideEffect extends Error {
+    constructor(what: string);
 }
 /** A child run failed, timed out, was cancelled or terminated; `cause` says which. */
 declare class ChildRunFailure extends WorkflowFailure {
@@ -134,9 +114,9 @@ declare class HistoryLimitExceeded extends Error {
     constructor(message: string);
 }
 /**
- * A Phase C feature (user activities, custom queries and updates, search
- * attributes, sinks, interceptors) used in Phase B. Fails the workflow task
- * with `UNSUPPORTED_COMMAND`; `validate` reports `durable.phaseC` at push time.
+ * A feature this release does not run yet (from C-R1 only user local
+ * activities: `ctx.localActivity` with a function). Fails the workflow task
+ * with `UNSUPPORTED_COMMAND`; `lower()` reports `durable.phaseC` at push time.
  */
 declare class PhaseCFeatureError extends Error {
     readonly code = "durable.phaseC";
@@ -150,6 +130,6 @@ declare function errorToFailure(error: unknown, source?: string, depth?: number)
 declare function failureToError(failure: Failure, depth?: number): WorkflowFailure;
 
 /** The version of @fluidgrids/workflows. */
-declare const SDK_VERSION = "2026.1028.2";
+declare const SDK_VERSION = "2026.1030.1";
 
-export { ActivityFailure, ApplicationError, type ApplicationErrorOptions, COLLECTION_FORMAT, CancelledFailure, ChildRunFailure, type CollectedDurableWorkflow, type CollectedTrigger, type CollectedWorkflow, DeterminismViolation, Failure, HistoryLimitExceeded, Json, JsonObject, PhaseCFeatureError, SDK_VERSION, ServerFailure, TerminatedFailure, type Tier1Collection, Tier1Recording, TimeoutFailure, WorkflowFailure, collectWorkflowExports, errorToFailure, failureToError, isCancellation };
+export { ActivityFailure, ActivityPausedError, ApplicationError, type ApplicationErrorOptions, CancelledFailure, ChildRunFailure, DeterminismViolation, Failure, HistoryLimitExceeded, Json, PhaseCFeatureError, QueryHandlerSideEffect, SDK_VERSION, ServerFailure, TerminatedFailure, TimeoutFailure, WorkflowFailure, errorToFailure, failureToError, isCancellation };

package/dist/index.js

@@ -1,9 +1,11 @@
-export { COLLECTION_FORMAT, collectWorkflowExports } from './chunk-XKJA7KX3.js';
-export { LAYOUT_FORMAT, LAYOUT_FORMAT_VERSION, RECORDING_FORMAT, RECORDING_FORMAT_VERSION, UnresolvedConnectionsError, WorkflowBuilder, assembleRecording, defaultEdgeId, defineWorkflow, edge, internalNodes, isOperation, isTier1Workflow, nodes, op, parseLayoutSidecar, toIR, trigger, triggers } from './chunk-HWJZVOG7.js';
+export { COLLECTION_FORMAT, collectWorkflowExports } from './chunk-6OLN6BMB.js';
+export { LAYOUT_FORMAT, LAYOUT_FORMAT_VERSION, RECORDING_FORMAT, RECORDING_FORMAT_VERSION, UnresolvedConnectionsError, WorkflowBuilder, assembleRecording, defaultEdgeId, defineWorkflow, edge, internalNodes, isOperation, isTier1Workflow, nodes, op, parseLayoutSidecar, toIR, trigger, triggers } from './chunk-SR7TR5KX.js';
 import './chunk-5LUIDMF4.js';
 export { BuilderError, PREDICATE_OPERATORS, and, expr, or } from './chunk-JZ4TOOLN.js';
 import './chunk-7AAZGVKD.js';
+export { ENCODED_PAYLOAD_MARKER, isEncodedPayload } from './chunk-VU5S5A7V.js';
 import './chunk-PMCM2OH4.js';
-export { ActivityFailure, ApplicationError, CancelledFailure, ChildRunFailure, DeterminismViolation, HistoryLimitExceeded, PhaseCFeatureError, ServerFailure, TerminatedFailure, TimeoutFailure, WorkflowFailure, defineQuery, defineSignal, defineUpdate, errorToFailure, failureToError, isCancellation, toMs } from './chunk-C5OLWZ42.js';
+export { ActivityFailure, ActivityPausedError, ApplicationError, CancelledFailure, ChildRunFailure, DeterminismViolation, HistoryLimitExceeded, PhaseCFeatureError, QueryHandlerSideEffect, ServerFailure, TerminatedFailure, TimeoutFailure, WorkflowFailure, defineQuery, defineSignal, defineUpdate, errorToFailure, failureToError, isCancellation } from './chunk-6A2FGSUS.js';
+export { ACTIVITY_IMPL_MARKER, ACTIVITY_MARKER, DURABLE_MARKER, DYNAMIC_ACTIVITY_NAME, INTERCEPTORS_MARKER, MAX_WORKFLOW_TASK_TIMEOUT_MS, SDK_VERSION, checkActivityName, checkTaskQueueName, compose as composeInterceptors, continueAsNewRetryOf, declareActivity, defineActivity, dynamicActivity, dynamicWorkflow, executeActivity, findActivityImplementation, implementActivity, interceptorsFactoryOf, interfaceOf, isActivityDefinition, isActivityImplementation, isDurableWorkflow, jsonSchemaOf, resolveWorkflowInterceptors, runRetryPolicyOf, toMs, workflow, workflowInterceptors } from './chunk-C4F5KJTI.js';
 import './chunk-LNUQE6D6.js';
-export { DURABLE_MARKER, SDK_VERSION, interfaceOf, isDurableWorkflow, jsonSchemaOf, workflow } from './chunk-N23SKIG4.js';
+import './chunk-5HIVIV53.js';

package/dist/interceptors-CNcr2dlk.d.ts

@@ -0,0 +1,159 @@
+import { a as Json, J as JsonObject } from './types-V7jEEUaL.js';
+import { ad as RunTarget, M as Headers } from './types-DGx-b9eq.js';
+
+/**
+ * Interceptors (11 §2.10): middleware around what workflow code receives
+ * (inbound) and issues (outbound), and around activity execution. A `headers`
+ * map travels with starts, signals, updates, activities and children, so one
+ * interceptor can hand context (trace ids, tenant hints) to the next one in
+ * another run or on a worker.
+ *
+ * A managed bundle registers workflow interceptors by exporting
+ * `interceptors` (made with {@link workflowInterceptors}, or a plain factory
+ * function) from any module; the factory runs once per workflow task inside
+ * the isolate, so it must be deterministic. Self-hosted workers and clients
+ * register theirs on the worker or client (C-R2).
+ *
+ * Every chain is composed in list order: the first interceptor is the
+ * outermost and calls `next` to reach the second, the last one reaches the
+ * runtime. Outbound methods should call `next` synchronously, before any
+ * await, so the command is issued where the code issued it.
+ *
+ * Pure JavaScript; it runs inside the isolate.
+ */
+
+/** The workflow function is about to run. */
+interface WorkflowExecuteInput {
+    readonly workflowFn: string;
+    input: Json;
+    /** The start's headers (`WORKFLOW_STARTED.headers`). */
+    readonly headers: Headers;
+}
+/** A signal is about to reach its handler. */
+interface SignalInput {
+    readonly name: string;
+    payload: Json;
+    readonly headers: Headers;
+}
+/** A query is about to reach its handler. */
+interface QueryInput {
+    readonly queryId: string;
+    readonly name: string;
+    args: Json;
+}
+/** An update is about to be validated or handled. */
+interface UpdateInput {
+    readonly updateId: string;
+    readonly name: string;
+    args: Json;
+    readonly headers: Headers;
+}
+/** An activity (`ctx.run` or `ctx.activity`) is about to be scheduled. */
+interface ScheduleActivityInput {
+    readonly activityId: string;
+    readonly kind: 'node' | 'user';
+    /** The node type, or the user activity's name. */
+    readonly name: string;
+    /** The node operation; absent for a user activity. */
+    readonly operation?: string;
+    args: Json;
+    headers: Headers;
+}
+/** A local activity is about to be run. Its headers do not leave the task. */
+interface ScheduleLocalActivityInput {
+    readonly localActivityId: string;
+    readonly nodeType: string;
+    readonly operation: string;
+    args: Json;
+}
+/** A durable timer (`ctx.sleep`) is about to start. */
+interface StartTimerInput {
+    durationMs: number;
+    summary?: string;
+}
+/** A child run is about to start. */
+interface StartChildInput {
+    readonly workflowKey?: string;
+    readonly workflowFn?: string;
+    input: Json;
+    headers: Headers;
+}
+/** A signal to another run is about to be sent. */
+interface SignalRunInput {
+    readonly target: RunTarget;
+    readonly name: string;
+    payload: Json;
+    headers: Headers;
+}
+/** A cancel request to another run is about to be sent. */
+interface CancelRunInput {
+    readonly target: RunTarget;
+}
+/** The run is about to continue as new. */
+interface ContinueAsNewInput {
+    input: Json;
+    options: JsonObject;
+    headers: Headers;
+}
+/** Search attributes are about to be upserted. */
+interface UpsertSearchAttributesInput {
+    attributes: JsonObject;
+}
+/** Context (memo) entries are about to be upserted. */
+interface UpsertContextInput {
+    entries: JsonObject;
+}
+/** Interceptors of what reaches workflow code. */
+interface WorkflowInboundInterceptor {
+    execute?(input: WorkflowExecuteInput, next: (input: WorkflowExecuteInput) => Promise<unknown>): Promise<unknown>;
+    handleSignal?(input: SignalInput, next: (input: SignalInput) => unknown): unknown;
+    /** Synchronous: a query handler must not wait. */
+    handleQuery?(input: QueryInput, next: (input: QueryInput) => unknown): unknown;
+    /** Synchronous: throw to reject the update (nothing is written to history). */
+    validateUpdate?(input: UpdateInput, next: (input: UpdateInput) => void): void;
+    handleUpdate?(input: UpdateInput, next: (input: UpdateInput) => unknown): unknown;
+}
+/** Interceptors of what workflow code issues. */
+interface WorkflowOutboundInterceptor {
+    scheduleActivity?(input: ScheduleActivityInput, next: (input: ScheduleActivityInput) => Promise<unknown>): Promise<unknown>;
+    scheduleLocalActivity?(input: ScheduleLocalActivityInput, next: (input: ScheduleLocalActivityInput) => Promise<unknown>): Promise<unknown>;
+    startTimer?(input: StartTimerInput, next: (input: StartTimerInput) => Promise<void>): Promise<void>;
+    startChild?(input: StartChildInput, next: (input: StartChildInput) => Promise<unknown>): Promise<unknown>;
+    signalRun?(input: SignalRunInput, next: (input: SignalRunInput) => Promise<void>): Promise<void>;
+    cancelRun?(input: CancelRunInput, next: (input: CancelRunInput) => Promise<void>): Promise<void>;
+    sideEffect?(input: Record<string, never>, next: () => Json): Json;
+    continueAsNew?(input: ContinueAsNewInput, next: (input: ContinueAsNewInput) => Promise<never>): Promise<never>;
+    upsertSearchAttributes?(input: UpsertSearchAttributesInput, next: (input: UpsertSearchAttributesInput) => void): void;
+    upsertContext?(input: UpsertContextInput, next: (input: UpsertContextInput) => void): void;
+    /** Attributes added to every `ctx.log` line's data. */
+    getLogAttributes?(input: Record<string, Json>, next: (input: Record<string, Json>) => Record<string, Json>): Record<string, Json>;
+}
+/** The workflow interceptors of a bundle. */
+interface WorkflowInterceptors {
+    inbound?: WorkflowInboundInterceptor[];
+    outbound?: WorkflowOutboundInterceptor[];
+}
+/** Makes the interceptors of one workflow task. */
+type WorkflowInterceptorsFactory = () => WorkflowInterceptors;
+declare const INTERCEPTORS_MARKER = "fluidgrids.workflow-interceptors";
+/** A factory marked by {@link workflowInterceptors}. */
+interface MarkedInterceptorsFactory {
+    readonly __fluidgrids: typeof INTERCEPTORS_MARKER;
+    readonly factory: WorkflowInterceptorsFactory;
+}
+/**
+ * Declare the workflow interceptors of a bundle; export the value as
+ * `interceptors` from any module.
+ */
+declare function workflowInterceptors(factory: WorkflowInterceptorsFactory): MarkedInterceptorsFactory;
+/** The factory of an `interceptors` export, or undefined when the value is not one. */
+declare function interceptorsFactoryOf(value: unknown): WorkflowInterceptorsFactory | undefined;
+/** Run every factory and concatenate their lists, in factory order. */
+declare function resolveWorkflowInterceptors(factories: readonly WorkflowInterceptorsFactory[]): Required<WorkflowInterceptors>;
+/**
+ * Compose `method` of each interceptor around `terminal`, first interceptor
+ * outermost. Interceptors without the method are skipped.
+ */
+declare function compose<I, O, T extends object>(interceptors: readonly T[], method: keyof T, terminal: (input: I) => O): (input: I) => O;
+
+export { type CancelRunInput as C, INTERCEPTORS_MARKER as I, type MarkedInterceptorsFactory as M, type QueryInput as Q, type ScheduleActivityInput as S, type UpdateInput as U, type WorkflowExecuteInput as W, type ContinueAsNewInput as a, type ScheduleLocalActivityInput as b, type SignalInput as c, type SignalRunInput as d, type StartChildInput as e, type StartTimerInput as f, type UpsertContextInput as g, type UpsertSearchAttributesInput as h, type WorkflowInboundInterceptor as i, type WorkflowInterceptors as j, type WorkflowInterceptorsFactory as k, type WorkflowOutboundInterceptor as l, compose as m, interceptorsFactoryOf as n, resolveWorkflowInterceptors as r, workflowInterceptors as w };

package/dist/interceptors-CqkNZVfI.d.cts

@@ -0,0 +1,159 @@
+import { a as Json, J as JsonObject } from './types-V7jEEUaL.cjs';
+import { ad as RunTarget, M as Headers } from './types-Bv2i4cBX.cjs';
+
+/**
+ * Interceptors (11 §2.10): middleware around what workflow code receives
+ * (inbound) and issues (outbound), and around activity execution. A `headers`
+ * map travels with starts, signals, updates, activities and children, so one
+ * interceptor can hand context (trace ids, tenant hints) to the next one in
+ * another run or on a worker.
+ *
+ * A managed bundle registers workflow interceptors by exporting
+ * `interceptors` (made with {@link workflowInterceptors}, or a plain factory
+ * function) from any module; the factory runs once per workflow task inside
+ * the isolate, so it must be deterministic. Self-hosted workers and clients
+ * register theirs on the worker or client (C-R2).
+ *
+ * Every chain is composed in list order: the first interceptor is the
+ * outermost and calls `next` to reach the second, the last one reaches the
+ * runtime. Outbound methods should call `next` synchronously, before any
+ * await, so the command is issued where the code issued it.
+ *
+ * Pure JavaScript; it runs inside the isolate.
+ */
+
+/** The workflow function is about to run. */
+interface WorkflowExecuteInput {
+    readonly workflowFn: string;
+    input: Json;
+    /** The start's headers (`WORKFLOW_STARTED.headers`). */
+    readonly headers: Headers;
+}
+/** A signal is about to reach its handler. */
+interface SignalInput {
+    readonly name: string;
+    payload: Json;
+    readonly headers: Headers;
+}
+/** A query is about to reach its handler. */
+interface QueryInput {
+    readonly queryId: string;
+    readonly name: string;
+    args: Json;
+}
+/** An update is about to be validated or handled. */
+interface UpdateInput {
+    readonly updateId: string;
+    readonly name: string;
+    args: Json;
+    readonly headers: Headers;
+}
+/** An activity (`ctx.run` or `ctx.activity`) is about to be scheduled. */
+interface ScheduleActivityInput {
+    readonly activityId: string;
+    readonly kind: 'node' | 'user';
+    /** The node type, or the user activity's name. */
+    readonly name: string;
+    /** The node operation; absent for a user activity. */
+    readonly operation?: string;
+    args: Json;
+    headers: Headers;
+}
+/** A local activity is about to be run. Its headers do not leave the task. */
+interface ScheduleLocalActivityInput {
+    readonly localActivityId: string;
+    readonly nodeType: string;
+    readonly operation: string;
+    args: Json;
+}
+/** A durable timer (`ctx.sleep`) is about to start. */
+interface StartTimerInput {
+    durationMs: number;
+    summary?: string;
+}
+/** A child run is about to start. */
+interface StartChildInput {
+    readonly workflowKey?: string;
+    readonly workflowFn?: string;
+    input: Json;
+    headers: Headers;
+}
+/** A signal to another run is about to be sent. */
+interface SignalRunInput {
+    readonly target: RunTarget;
+    readonly name: string;
+    payload: Json;
+    headers: Headers;
+}
+/** A cancel request to another run is about to be sent. */
+interface CancelRunInput {
+    readonly target: RunTarget;
+}
+/** The run is about to continue as new. */
+interface ContinueAsNewInput {
+    input: Json;
+    options: JsonObject;
+    headers: Headers;
+}
+/** Search attributes are about to be upserted. */
+interface UpsertSearchAttributesInput {
+    attributes: JsonObject;
+}
+/** Context (memo) entries are about to be upserted. */
+interface UpsertContextInput {
+    entries: JsonObject;
+}
+/** Interceptors of what reaches workflow code. */
+interface WorkflowInboundInterceptor {
+    execute?(input: WorkflowExecuteInput, next: (input: WorkflowExecuteInput) => Promise<unknown>): Promise<unknown>;
+    handleSignal?(input: SignalInput, next: (input: SignalInput) => unknown): unknown;
+    /** Synchronous: a query handler must not wait. */
+    handleQuery?(input: QueryInput, next: (input: QueryInput) => unknown): unknown;
+    /** Synchronous: throw to reject the update (nothing is written to history). */
+    validateUpdate?(input: UpdateInput, next: (input: UpdateInput) => void): void;
+    handleUpdate?(input: UpdateInput, next: (input: UpdateInput) => unknown): unknown;
+}
+/** Interceptors of what workflow code issues. */
+interface WorkflowOutboundInterceptor {
+    scheduleActivity?(input: ScheduleActivityInput, next: (input: ScheduleActivityInput) => Promise<unknown>): Promise<unknown>;
+    scheduleLocalActivity?(input: ScheduleLocalActivityInput, next: (input: ScheduleLocalActivityInput) => Promise<unknown>): Promise<unknown>;
+    startTimer?(input: StartTimerInput, next: (input: StartTimerInput) => Promise<void>): Promise<void>;
+    startChild?(input: StartChildInput, next: (input: StartChildInput) => Promise<unknown>): Promise<unknown>;
+    signalRun?(input: SignalRunInput, next: (input: SignalRunInput) => Promise<void>): Promise<void>;
+    cancelRun?(input: CancelRunInput, next: (input: CancelRunInput) => Promise<void>): Promise<void>;
+    sideEffect?(input: Record<string, never>, next: () => Json): Json;
+    continueAsNew?(input: ContinueAsNewInput, next: (input: ContinueAsNewInput) => Promise<never>): Promise<never>;
+    upsertSearchAttributes?(input: UpsertSearchAttributesInput, next: (input: UpsertSearchAttributesInput) => void): void;
+    upsertContext?(input: UpsertContextInput, next: (input: UpsertContextInput) => void): void;
+    /** Attributes added to every `ctx.log` line's data. */
+    getLogAttributes?(input: Record<string, Json>, next: (input: Record<string, Json>) => Record<string, Json>): Record<string, Json>;
+}
+/** The workflow interceptors of a bundle. */
+interface WorkflowInterceptors {
+    inbound?: WorkflowInboundInterceptor[];
+    outbound?: WorkflowOutboundInterceptor[];
+}
+/** Makes the interceptors of one workflow task. */
+type WorkflowInterceptorsFactory = () => WorkflowInterceptors;
+declare const INTERCEPTORS_MARKER = "fluidgrids.workflow-interceptors";
+/** A factory marked by {@link workflowInterceptors}. */
+interface MarkedInterceptorsFactory {
+    readonly __fluidgrids: typeof INTERCEPTORS_MARKER;
+    readonly factory: WorkflowInterceptorsFactory;
+}
+/**
+ * Declare the workflow interceptors of a bundle; export the value as
+ * `interceptors` from any module.
+ */
+declare function workflowInterceptors(factory: WorkflowInterceptorsFactory): MarkedInterceptorsFactory;
+/** The factory of an `interceptors` export, or undefined when the value is not one. */
+declare function interceptorsFactoryOf(value: unknown): WorkflowInterceptorsFactory | undefined;
+/** Run every factory and concatenate their lists, in factory order. */
+declare function resolveWorkflowInterceptors(factories: readonly WorkflowInterceptorsFactory[]): Required<WorkflowInterceptors>;
+/**
+ * Compose `method` of each interceptor around `terminal`, first interceptor
+ * outermost. Interceptors without the method are skipped.
+ */
+declare function compose<I, O, T extends object>(interceptors: readonly T[], method: keyof T, terminal: (input: I) => O): (input: I) => O;
+
+export { type CancelRunInput as C, INTERCEPTORS_MARKER as I, type MarkedInterceptorsFactory as M, type QueryInput as Q, type ScheduleActivityInput as S, type UpdateInput as U, type WorkflowExecuteInput as W, type ContinueAsNewInput as a, type ScheduleLocalActivityInput as b, type SignalInput as c, type SignalRunInput as d, type StartChildInput as e, type StartTimerInput as f, type UpsertContextInput as g, type UpsertSearchAttributesInput as h, type WorkflowInboundInterceptor as i, type WorkflowInterceptors as j, type WorkflowInterceptorsFactory as k, type WorkflowOutboundInterceptor as l, compose as m, interceptorsFactoryOf as n, resolveWorkflowInterceptors as r, workflowInterceptors as w };