@superdurable/dex 0.1.2 → 0.1.4

package/dist/src/wait.d.ts

@@ -1,57 +1,237 @@
 import type { Codec } from "./codec.js";
 import type { Context } from "./context.js";
+/** Describes one durable Timer or Channel readiness condition. */
 export interface Condition {
+    /** Condition family interpreted by Dex. */
     readonly kind: "timer" | "channel";
+    /** Optional stable ID unique within the Wait tree. */
     readonly conditionId?: string;
+    /** Timer delay in non-negative milliseconds. */
     readonly durationMs?: number;
+    /** Physical Channel name for a Channel condition. */
     readonly channelName?: string;
+    /** ChannelMap instance for a map condition. */
     readonly instance?: string;
+    /** Inclusive lower queued-value bound. */
     readonly atLeast?: number;
+    /** Inclusive upper queued-value bound. */
     readonly atMost?: number;
 }
+/** Groups Conditions that must become ready together. */
 export interface ConditionCombination {
+    /** Ordered Conditions in this all-of group. */
     readonly conditions: readonly Condition[];
 }
+/** Creates all-of Condition groups for `Wait.anyCombinationOf`. */
 export declare const ConditionCombination: Readonly<{
+    /**
+     * Groups conditions that must all become ready together.
+     * @param conditions - Conditions in stable evaluation order.
+     * @returns A group with the conditions.
+     */
     of(...conditions: readonly Condition[]): ConditionCombination;
 }>;
+/** Creates durable Timer conditions without blocking a worker thread. */
 export declare const Timer: Readonly<{
+    /**
+     * Creates a Timer ready after a non-negative delay.
+     * @param durationMs - Durable delay in milliseconds.
+     * @param conditionId - Optional stable ID used by skip-Timer APIs.
+     * @returns A Timer condition accepted by Wait factories.
+     */
     byDuration(durationMs: number, conditionId?: string): Condition;
 }>;
+/**
+ * Defines a typed, durable singleton message stream owned by a Flow.
+ * @typeParam T - Type of every published value.
+ */
 export declare class Channel<T> {
     readonly name: string;
     readonly codec: Codec<T>;
+    /**
+     * Creates a Channel definition.
+     * @param name - Non-empty name unique within the Flow.
+     * @param codec - Element codec.
+     */
     constructor(name: string, codec: Codec<T>);
+    /**
+     * Stages one value to append with the current decision.
+     * @param context - Current Step or RPC Context.
+     * @param value - Typed value to append.
+     */
     publish(context: Context, value: T): void;
+    /**
+     * Returns the current queued value count.
+     * @param context - Current Step or RPC Context.
+     * @returns Non-negative queued value count.
+     */
     size(context: Context): number;
+    /**
+     * Returns values selected by this Step's satisfied condition.
+     * @param context - Current Step Context.
+     * @returns Ordered values, or an empty array when this Channel was not selected.
+     */
     results(context: Context): readonly T[];
+    /**
+     * Creates a condition consuming exactly one value.
+     * @param conditionId - Optional stable condition identifier.
+     * @returns An exact-one Channel condition.
+     */
     forOne(conditionId?: string): Condition;
+    /**
+     * Creates a condition consuming exactly `count` values.
+     * @param count - Required non-negative count.
+     * @param conditionId - Optional stable condition identifier.
+     * @returns A condition with equal lower and upper bounds.
+     */
     forN(count: number, conditionId?: string): Condition;
+    /**
+     * Creates a condition requiring at least `count` values.
+     * @param count - Inclusive non-negative lower bound.
+     * @param conditionId - Optional stable condition identifier.
+     * @returns A condition without an upper bound.
+     */
     atLeast(count: number, conditionId?: string): Condition;
+    /**
+     * Creates a condition consuming at most `count` available values.
+     * @param count - Inclusive non-negative upper bound.
+     * @param conditionId - Optional stable condition identifier.
+     * @returns A condition without a positive lower bound.
+     */
     atMost(count: number, conditionId?: string): Condition;
+    /**
+     * Creates a bounded condition for queued Channel values.
+     * @param atLeast - Optional inclusive lower bound.
+     * @param atMost - Optional inclusive upper bound.
+     * @param conditionId - Optional stable condition identifier.
+     * @returns A validated Channel condition.
+     */
     range(atLeast?: number, atMost?: number, conditionId?: string): Condition;
 }
+/**
+ * Defines keyed Channel instances that share one typed schema.
+ * @typeParam T - Type of every published value.
+ */
 export declare class ChannelMap<T> {
     readonly name: string;
     readonly codec: Codec<T>;
+    /**
+     * Creates a ChannelMap definition.
+     * @param name - Non-empty name unique within the Flow.
+     * @param codec - Element codec shared by every instance.
+     */
     constructor(name: string, codec: Codec<T>);
+    /**
+     * Stages one value for a ChannelMap instance.
+     * @param context - Current Step or RPC Context.
+     * @param instance - Non-empty logical map key.
+     * @param value - Typed value to append.
+     */
     publish(context: Context, instance: string, value: T): void;
+    /**
+     * Returns one instance's queued value count.
+     * @param context - Current Step or RPC Context.
+     * @param instance - Non-empty logical map key.
+     * @returns Non-negative queued value count.
+     */
     size(context: Context, instance: string): number;
+    /**
+     * Returns values selected for one instance by the satisfied condition.
+     * @param context - Current Step Context.
+     * @param instance - Non-empty logical map key.
+     * @returns Ordered values for this Step execution.
+     */
     results(context: Context, instance: string): readonly T[];
+    /**
+     * Creates an instance condition consuming exactly one value.
+     * @param instance - Non-empty logical map key.
+     * @param conditionId - Optional stable condition identifier.
+     * @returns An exact-one instance condition.
+     */
     forOne(instance: string, conditionId?: string): Condition;
+    /**
+     * Creates an instance condition consuming exactly `count` values.
+     * @param instance - Non-empty logical map key.
+     * @param count - Required non-negative count.
+     * @param conditionId - Optional stable condition identifier.
+     * @returns A condition with equal bounds.
+     */
     forN(instance: string, count: number, conditionId?: string): Condition;
+    /**
+     * Creates an instance condition requiring at least `count` values.
+     * @param instance - Non-empty logical map key.
+     * @param count - Inclusive non-negative lower bound.
+     * @param conditionId - Optional stable condition identifier.
+     * @returns A condition without an upper bound.
+     */
     atLeast(instance: string, count: number, conditionId?: string): Condition;
+    /**
+     * Creates an instance condition consuming at most `count` values.
+     * @param instance - Non-empty logical map key.
+     * @param count - Inclusive non-negative upper bound.
+     * @param conditionId - Optional stable condition identifier.
+     * @returns A condition without a positive lower bound.
+     */
     atMost(instance: string, count: number, conditionId?: string): Condition;
+    /**
+     * Creates a bounded condition for one ChannelMap instance.
+     * @param instance - Non-empty logical map key.
+     * @param atLeast - Optional inclusive lower bound.
+     * @param atMost - Optional inclusive upper bound.
+     * @param conditionId - Optional stable condition identifier.
+     * @returns A validated instance condition.
+     */
     range(instance: string, atLeast?: number, atMost?: number, conditionId?: string): Condition;
 }
+/**
+ * Describes the durable readiness rule evaluated before a Step executes.
+ *
+ * @example
+ * ```ts
+ * const approvals = new Channel("approvals", stringCodec);
+ * const wait = Wait.anyOf(
+ *   approvals.forOne("approved"),
+ *   Timer.byDuration(5 * 60_000, "timeout"),
+ * );
+ * ```
+ */
 export type Wait = Readonly<{
+    /** Combination rule interpreted by Dex. */
     kind: "skipImmediately" | "allOf" | "anyOf" | "anyCombinationOf";
+    /** Direct conditions for all-of or any-of waits. */
     conditions: readonly Condition[];
+    /** Alternative all-of groups for any-combination waits. */
     combinations: readonly ConditionCombination[];
 }>;
+/** Creates durable Step Wait values. */
 export declare const Wait: Readonly<{
+    /**
+     * Creates an immediate Wait.
+     * @returns A Wait that proceeds to `execute` immediately.
+     */
     skipImmediately(): Wait;
+    /**
+     * Creates a Wait for one condition.
+     * @param condition - The only readiness condition.
+     * @returns An all-of Wait with the condition.
+     */
+    until(condition: Condition): Wait;
+    /**
+     * Creates a Wait requiring every condition.
+     * @param conditions - Conditions evaluated as one all-of group.
+     * @returns An all-of Wait.
+     */
     allOf(...conditions: readonly Condition[]): Wait;
+    /**
+     * Creates a Wait that continues when any condition is ready.
+     * @param conditions - Alternative readiness conditions.
+     * @returns An any-of Wait.
+     */
     anyOf(...conditions: readonly Condition[]): Wait;
+    /**
+     * Creates a Wait accepting any complete condition combination.
+     * @param combinations - Alternative all-of condition groups.
+     * @returns An any-combination Wait.
+     */
     anyCombinationOf(...combinations: readonly ConditionCombination[]): Wait;
 }>;

package/dist/src/wait.js

@@ -6,12 +6,25 @@
 //
 // SPDX-License-Identifier: LicenseRef-Super-Durable-1.0
 import { requireConditionId, requireName, validateChannelBounds, } from "./validation.js";
+/** Creates all-of Condition groups for `Wait.anyCombinationOf`. */
 export const ConditionCombination = Object.freeze({
+    /**
+     * Groups conditions that must all become ready together.
+     * @param conditions - Conditions in stable evaluation order.
+     * @returns A group with the conditions.
+     */
     of(...conditions) {
         return { conditions };
     },
 });
+/** Creates durable Timer conditions without blocking a worker thread. */
 export const Timer = Object.freeze({
+    /**
+     * Creates a Timer ready after a non-negative delay.
+     * @param durationMs - Durable delay in milliseconds.
+     * @param conditionId - Optional stable ID used by skip-Timer APIs.
+     * @returns A Timer condition accepted by Wait factories.
+     */
     byDuration(durationMs, conditionId) {
         if (durationMs < 0 || !Number.isFinite(durationMs)) {
             throw new RangeError("timer duration must be non-negative");
@@ -24,35 +37,89 @@ export const Timer = Object.freeze({
         };
     },
 });
+/**
+ * Defines a typed, durable singleton message stream owned by a Flow.
+ * @typeParam T - Type of every published value.
+ */
 export class Channel {
     name;
     codec;
+    /**
+     * Creates a Channel definition.
+     * @param name - Non-empty name unique within the Flow.
+     * @param codec - Element codec.
+     */
     constructor(name, codec) {
         this.name = name;
         this.codec = codec;
         requireName(name);
     }
+    /**
+     * Stages one value to append with the current decision.
+     * @param context - Current Step or RPC Context.
+     * @param value - Typed value to append.
+     */
     publish(context, value) {
         context.publish(this, value);
     }
+    /**
+     * Returns the current queued value count.
+     * @param context - Current Step or RPC Context.
+     * @returns Non-negative queued value count.
+     */
     size(context) {
         return context.channelSize(this);
     }
+    /**
+     * Returns values selected by this Step's satisfied condition.
+     * @param context - Current Step Context.
+     * @returns Ordered values, or an empty array when this Channel was not selected.
+     */
     results(context) {
         return context.channelResults(this);
     }
+    /**
+     * Creates a condition consuming exactly one value.
+     * @param conditionId - Optional stable condition identifier.
+     * @returns An exact-one Channel condition.
+     */
     forOne(conditionId) {
         return this.range(1, 1, conditionId);
     }
+    /**
+     * Creates a condition consuming exactly `count` values.
+     * @param count - Required non-negative count.
+     * @param conditionId - Optional stable condition identifier.
+     * @returns A condition with equal lower and upper bounds.
+     */
     forN(count, conditionId) {
         return this.range(count, count, conditionId);
     }
+    /**
+     * Creates a condition requiring at least `count` values.
+     * @param count - Inclusive non-negative lower bound.
+     * @param conditionId - Optional stable condition identifier.
+     * @returns A condition without an upper bound.
+     */
     atLeast(count, conditionId) {
         return this.range(count, undefined, conditionId);
     }
+    /**
+     * Creates a condition consuming at most `count` available values.
+     * @param count - Inclusive non-negative upper bound.
+     * @param conditionId - Optional stable condition identifier.
+     * @returns A condition without a positive lower bound.
+     */
     atMost(count, conditionId) {
         return this.range(undefined, count, conditionId);
     }
+    /**
+     * Creates a bounded condition for queued Channel values.
+     * @param atLeast - Optional inclusive lower bound.
+     * @param atMost - Optional inclusive upper bound.
+     * @param conditionId - Optional stable condition identifier.
+     * @returns A validated Channel condition.
+     */
     range(atLeast, atMost, conditionId) {
         validateChannelBounds(atLeast, atMost);
         requireConditionId(conditionId);
@@ -65,35 +132,97 @@ export class Channel {
         };
     }
 }
+/**
+ * Defines keyed Channel instances that share one typed schema.
+ * @typeParam T - Type of every published value.
+ */
 export class ChannelMap {
     name;
     codec;
+    /**
+     * Creates a ChannelMap definition.
+     * @param name - Non-empty name unique within the Flow.
+     * @param codec - Element codec shared by every instance.
+     */
     constructor(name, codec) {
         this.name = name;
         this.codec = codec;
         requireName(name);
     }
+    /**
+     * Stages one value for a ChannelMap instance.
+     * @param context - Current Step or RPC Context.
+     * @param instance - Non-empty logical map key.
+     * @param value - Typed value to append.
+     */
     publish(context, instance, value) {
         context.publish(this, value, instance);
     }
+    /**
+     * Returns one instance's queued value count.
+     * @param context - Current Step or RPC Context.
+     * @param instance - Non-empty logical map key.
+     * @returns Non-negative queued value count.
+     */
     size(context, instance) {
         return context.channelSize(this, instance);
     }
+    /**
+     * Returns values selected for one instance by the satisfied condition.
+     * @param context - Current Step Context.
+     * @param instance - Non-empty logical map key.
+     * @returns Ordered values for this Step execution.
+     */
     results(context, instance) {
         return context.channelResults(this, instance);
     }
+    /**
+     * Creates an instance condition consuming exactly one value.
+     * @param instance - Non-empty logical map key.
+     * @param conditionId - Optional stable condition identifier.
+     * @returns An exact-one instance condition.
+     */
     forOne(instance, conditionId) {
         return this.range(instance, 1, 1, conditionId);
     }
+    /**
+     * Creates an instance condition consuming exactly `count` values.
+     * @param instance - Non-empty logical map key.
+     * @param count - Required non-negative count.
+     * @param conditionId - Optional stable condition identifier.
+     * @returns A condition with equal bounds.
+     */
     forN(instance, count, conditionId) {
         return this.range(instance, count, count, conditionId);
     }
+    /**
+     * Creates an instance condition requiring at least `count` values.
+     * @param instance - Non-empty logical map key.
+     * @param count - Inclusive non-negative lower bound.
+     * @param conditionId - Optional stable condition identifier.
+     * @returns A condition without an upper bound.
+     */
     atLeast(instance, count, conditionId) {
         return this.range(instance, count, undefined, conditionId);
     }
+    /**
+     * Creates an instance condition consuming at most `count` values.
+     * @param instance - Non-empty logical map key.
+     * @param count - Inclusive non-negative upper bound.
+     * @param conditionId - Optional stable condition identifier.
+     * @returns A condition without a positive lower bound.
+     */
     atMost(instance, count, conditionId) {
         return this.range(instance, undefined, count, conditionId);
     }
+    /**
+     * Creates a bounded condition for one ChannelMap instance.
+     * @param instance - Non-empty logical map key.
+     * @param atLeast - Optional inclusive lower bound.
+     * @param atMost - Optional inclusive upper bound.
+     * @param conditionId - Optional stable condition identifier.
+     * @returns A validated instance condition.
+     */
     range(instance, atLeast, atMost, conditionId) {
         validateChannelBounds(atLeast, atMost);
         requireConditionId(conditionId);
@@ -107,16 +236,44 @@ export class ChannelMap {
         };
     }
 }
+/** Creates durable Step Wait values. */
 export const Wait = Object.freeze({
+    /**
+     * Creates an immediate Wait.
+     * @returns A Wait that proceeds to `execute` immediately.
+     */
     skipImmediately() {
         return { kind: "skipImmediately", conditions: [], combinations: [] };
     },
+    /**
+     * Creates a Wait for one condition.
+     * @param condition - The only readiness condition.
+     * @returns An all-of Wait with the condition.
+     */
+    until(condition) {
+        return Wait.allOf(condition);
+    },
+    /**
+     * Creates a Wait requiring every condition.
+     * @param conditions - Conditions evaluated as one all-of group.
+     * @returns An all-of Wait.
+     */
     allOf(...conditions) {
         return { kind: "allOf", conditions, combinations: [] };
     },
+    /**
+     * Creates a Wait that continues when any condition is ready.
+     * @param conditions - Alternative readiness conditions.
+     * @returns An any-of Wait.
+     */
     anyOf(...conditions) {
         return { kind: "anyOf", conditions, combinations: [] };
     },
+    /**
+     * Creates a Wait accepting any complete condition combination.
+     * @param combinations - Alternative all-of condition groups.
+     * @returns An any-combination Wait.
+     */
     anyCombinationOf(...combinations) {
         return { kind: "anyCombinationOf", conditions: [], combinations };
     },

package/dist/src/wait.js.map

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

package/dist/src/worker-dispatcher.js

@@ -6,6 +6,7 @@
 //
 // SPDX-License-Identifier: LicenseRef-Super-Durable-1.0
 import { ChannelCondition, CloseDecision, CloseDecisionType, ConditionCombination as ProtoConditionCombination, ExecuteMethodFailurePolicy, InvokeExecuteMethodResponse, InvokeWaitForMethodResponse, InvokeWorkerRPCResponse, StepDecision as ProtoStepDecision, StepMovement as ProtoStepMovement, StepOptions as ProtoStepOptions, TimerCondition, WaitForMethodFailurePolicy, WaitingCondition, WaitingConditionType, } from "./gen/dex.js";
+import { InvalidStepResultError, ValueMappingError } from "./errors.js";
 import { registeredFlowByName, registeredRPCByName, registeredStep, } from "./flow.js";
 import { InvocationContext } from "./invocation-context.js";
 import { decodeValue, encodeUnknown, encodeValue, } from "./value-mapper.js";
@@ -27,14 +28,19 @@ export class WorkerDispatcher {
         if (step.step.waitFor === undefined) {
             throw new TypeError(`Step ${step.name} does not implement waitFor`);
         }
-        const wait = step.step.waitFor(context, input);
-        return InvokeWaitForMethodResponse.create({
-            upsertAttributes: [...context.getAttributeWrites()],
-            waitingCondition: mapWait(flow, wait),
-            upsertStepExeLocals: [...context.getLocalWrites()],
-            recordEvents: [...context.getEvents()],
-            publishToChannel: [...context.getPublications()],
-        });
+        const wait = await step.step.waitFor(context, input);
+        try {
+            return InvokeWaitForMethodResponse.create({
+                upsertAttributes: [...context.getAttributeWrites()],
+                waitingCondition: mapWait(flow, wait),
+                upsertStepExeLocals: [...context.getLocalWrites()],
+                recordEvents: [...context.getEvents()],
+                publishToChannel: [...context.getPublications()],
+            });
+        }
+        catch (failure) {
+            throw invalidStepResult(flow.name, step.name, "waitFor", failure);
+        }
     }
     async invokeExecute(original) {
         const request = await this.hydrateExecute(original);
@@ -42,33 +48,43 @@ export class WorkerDispatcher {
         const step = registeredStep(flow, request.stepType);
         const context = new InvocationContext("execute", flow, request.context, request.attributes, request.stepExeLocals, request.conditionResults);
         const input = decodeValue(step.step.inputCodec, requireValue(request.stepInput, "Step input"));
-        const decision = step.step.execute(context, input);
-        return InvokeExecuteMethodResponse.create({
-            stepDecision: mapDecision(flow, decision),
-            upsertAttributes: [...context.getAttributeWrites()],
-            recordEvents: [...context.getEvents()],
-            upsertStepExeLocals: [...context.getLocalWrites()],
-            publishToChannel: [...context.getPublications()],
-        });
+        const decision = await step.step.execute(context, input);
+        try {
+            return InvokeExecuteMethodResponse.create({
+                stepDecision: mapDecision(flow, decision),
+                upsertAttributes: [...context.getAttributeWrites()],
+                recordEvents: [...context.getEvents()],
+                upsertStepExeLocals: [...context.getLocalWrites()],
+                publishToChannel: [...context.getPublications()],
+            });
+        }
+        catch (failure) {
+            throw invalidStepResult(flow.name, step.name, "execute", failure);
+        }
     }
     async invokeRPC(original) {
         const request = await this.hydrateRPC(original);
         const flow = registeredFlowByName(this.registry, request.flowType);
         const rpc = registeredRPCByName(flow, request.rpcName);
         const context = new InvocationContext("rpc", flow, request.context, request.attributes, [], undefined, request.channelInfos);
-        const returned = invokeRPC(flow, rpc, context, request.input);
-        const result = rpcResult(rpc, returned);
-        return InvokeWorkerRPCResponse.create({
-            output: rpc.options.outputCodec === undefined
-                ? encodeUnknown(undefined)
-                : encodeValue(rpc.options.outputCodec, result?.output),
-            stepDecision: result?.nextSteps === undefined || result.nextSteps.length === 0
-                ? undefined
-                : ProtoStepDecision.create({ nextSteps: mapMovements(flow, result.nextSteps) }),
-            upsertAttributes: [...context.getAttributeWrites()],
-            recordEvents: [...context.getEvents()],
-            publishToChannel: [...context.getPublications()],
-        });
+        const returned = await invokeRPC(flow, rpc, context, request.input);
+        try {
+            const result = rpcResult(rpc, returned);
+            return InvokeWorkerRPCResponse.create({
+                output: rpc.options.outputCodec === undefined
+                    ? encodeUnknown(undefined)
+                    : encodeValue(rpc.options.outputCodec, result?.output),
+                stepDecision: result?.nextSteps === undefined || result.nextSteps.length === 0
+                    ? undefined
+                    : ProtoStepDecision.create({ nextSteps: mapMovements(flow, result.nextSteps) }),
+                upsertAttributes: [...context.getAttributeWrites()],
+                recordEvents: [...context.getEvents()],
+                publishToChannel: [...context.getPublications()],
+            });
+        }
+        catch (failure) {
+            throw invalidStepResult(flow.name, undefined, "rpc", failure);
+        }
     }
     async hydrateWaitFor(request) {
         const values = await this.hydrator.hydrateAll([
@@ -371,4 +387,14 @@ function seconds(milliseconds) {
     }
     return milliseconds / 1_000;
 }
+function invalidStepResult(flowType, stepType, method, failure) {
+    if (failure instanceof ValueMappingError) {
+        return failure;
+    }
+    if (failure instanceof InvalidStepResultError) {
+        return failure;
+    }
+    const detail = failure instanceof Error ? failure.message : String(failure);
+    return new InvalidStepResultError(flowType, stepType, method, detail, { cause: failure });
+}
 //# sourceMappingURL=worker-dispatcher.js.map