@superdurable/dex 0.2.8 → 0.2.9

package/dist/src/wait.d.ts

@@ -2,6 +2,13 @@ import type { Codec } from "./codec.js";
 import type { Context } from "./context.js";
 import type { Flow } from "./flow.js";
 import type { SubFlowOptions } from "./subflow.js";
+/** Selects one ChannelMap instance's pending messages for an RPC snapshot. */
+export interface ChannelMapLoad {
+    /** Exact ChannelMap definition registered with the Flow. */
+    readonly channelMap: ChannelMap<unknown>;
+    /** One slash-free logical instance key. */
+    readonly instance: string;
+}
 /** Describes one durable Timer, Channel, or SubFlow readiness condition. */
 export interface Condition {
     /** Condition family interpreted by Dex. */
@@ -12,7 +19,7 @@ export interface Condition {
     readonly durationMs?: number;
     /** Physical Channel name for a Channel condition. */
     readonly channelName?: string;
-    /** ChannelMap instance for a map condition. */
+    /** The ChannelMap instance for a map condition. Slash is prohibited because it is a reserved character. */
     readonly instance?: string;
     /** Inclusive lower queued-value bound. */
     readonly atLeast?: number;
@@ -90,6 +97,20 @@ export declare class Channel<T> {
      * @returns Non-negative queued value count.
      */
     size(context: Context): number;
+    /**
+     * Returns the loaded pending-message snapshot in FIFO order.
+     * @param context - Current RPC Context.
+     * @returns Immutable pending message IDs and decoded values.
+     * @throws {@link StateNotLoadedError} when the RPC did not load this Channel.
+     */
+    pendingMessages(context: Context): readonly ChannelMessage<T>[];
+    /**
+     * Finds one message in the loaded pending snapshot.
+     * @param context - Current RPC Context.
+     * @param messageId - Server-assigned message ID.
+     * @returns The matching message, or `undefined` when absent from the snapshot.
+     */
+    findPendingMessage(context: Context, messageId: string): ChannelMessage<T> | undefined;
     /**
      * Returns values selected by this Step's satisfied condition.
      * @param context - Current Step Context.
@@ -117,7 +138,8 @@ export declare class Channel<T> {
      */
     atLeast(count: number, conditionId?: string): Condition;
     /**
-     * Creates a condition consuming at most `count` available values.
+     * Creates a non-blocking condition consuming up to `count` queued values.
+     * When its surrounding Wait completes, it consumes values queued then; an empty queue yields none.
      * @param count - Inclusive non-negative upper bound.
      * @param conditionId - Optional stable condition identifier.
      * @returns A condition without a positive lower bound.
@@ -125,6 +147,8 @@ export declare class Channel<T> {
     atMost(count: number, conditionId?: string): Condition;
     /**
      * Creates a bounded condition for queued Channel values.
+     * Dex waits only for `atLeast`, then consumes currently queued values up to `atMost`.
+     * Omitting `atLeast` makes the condition complete immediately.
      * @param atLeast - Optional inclusive lower bound.
      * @param atMost - Optional inclusive upper bound.
      * @param conditionId - Optional stable condition identifier.
@@ -134,6 +158,7 @@ export declare class Channel<T> {
 }
 /**
  * Defines keyed Channel instances that share one typed schema.
+ * Instance keys must be non-empty and must not contain `/`.
  * @typeParam T - Type of every published value.
  */
 export declare class ChannelMap<T> {
@@ -148,24 +173,46 @@ export declare class ChannelMap<T> {
     /**
      * Stages one value for a ChannelMap instance.
      * @param context - Current Step or RPC Context.
-     * @param instance - Non-empty logical map key.
+     * @param instance - The map instance. Slash is prohibited because it is a reserved character.
      * @param value - Typed value to append.
      */
     publish(context: Context, instance: string, value: T): void;
     /**
      * Stages deletion of one pending message from a ChannelMap instance in an RPC.
      * @param context - Current RPC Context.
-     * @param instance - Non-empty ChannelMap instance.
+     * @param instance - The ChannelMap instance. Slash is prohibited because it is a reserved character.
      * @param messageId - Non-empty server-assigned message ID.
      */
     delete(context: Context, instance: string, messageId: string): void;
     /**
      * Returns one instance's queued value count.
      * @param context - Current Step or RPC Context.
-     * @param instance - Non-empty logical map key.
+     * @param instance - The map instance. Slash is prohibited because it is a reserved character.
      * @returns Non-negative queued value count.
      */
     size(context: Context, instance: string): number;
+    /**
+     * Selects one instance's pending messages for an RPC snapshot.
+     * @param instance - Non-empty logical instance key. The SDK escapes it for the protocol.
+     * @returns An exact instance load for {@link RPCOptions.loadChannelMapInstances}.
+     */
+    loadMessages(instance: string): ChannelMapLoad;
+    /**
+     * Returns one loaded instance snapshot in FIFO order.
+     * @param context - Current RPC Context.
+     * @param instance - Logical ChannelMap instance.
+     * @returns Immutable pending message IDs and decoded values.
+     * @throws {@link StateNotLoadedError} when the RPC did not load this instance or map.
+     */
+    pendingMessages(context: Context, instance: string): readonly ChannelMessage<T>[];
+    /**
+     * Finds one instance message in the loaded pending snapshot.
+     * @param context - Current RPC Context.
+     * @param instance - Logical ChannelMap instance.
+     * @param messageId - Server-assigned message ID.
+     * @returns The matching message, or `undefined` when absent from the snapshot.
+     */
+    findPendingMessage(context: Context, instance: string, messageId: string): ChannelMessage<T> | undefined;
     /**
      * Returns the number of non-empty instances visible to the current RPC.
      * @param context - Current RPC Context.
@@ -181,20 +228,20 @@ export declare class ChannelMap<T> {
     /**
      * Returns values selected for one instance by the satisfied condition.
      * @param context - Current Step Context.
-     * @param instance - Non-empty logical map key.
+     * @param instance - The map instance. Slash is prohibited because it is a reserved character.
      * @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 instance - The map instance. Slash is prohibited because it is a reserved character.
      * @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 instance - The map instance. Slash is prohibited because it is a reserved character.
      * @param count - Required non-negative count.
      * @param conditionId - Optional stable condition identifier.
      * @returns A condition with equal bounds.
@@ -202,15 +249,16 @@ export declare class ChannelMap<T> {
     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 instance - The map instance. Slash is prohibited because it is a reserved character.
      * @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.
+     * Creates a non-blocking instance condition consuming up to `count` queued values.
+     * When its surrounding Wait completes, it consumes values queued then; an empty queue yields none.
+     * @param instance - The map instance. Slash is prohibited because it is a reserved character.
      * @param count - Inclusive non-negative upper bound.
      * @param conditionId - Optional stable condition identifier.
      * @returns A condition without a positive lower bound.
@@ -218,7 +266,9 @@ export declare class ChannelMap<T> {
     atMost(instance: string, count: number, conditionId?: string): Condition;
     /**
      * Creates a bounded condition for one ChannelMap instance.
-     * @param instance - Non-empty logical map key.
+     * Dex waits only for `atLeast`, then consumes currently queued values up to `atMost`.
+     * Omitting `atLeast` makes the condition complete immediately.
+     * @param instance - The map instance. Slash is prohibited because it is a reserved character.
      * @param atLeast - Optional inclusive lower bound.
      * @param atMost - Optional inclusive upper bound.
      * @param conditionId - Optional stable condition identifier.
@@ -233,8 +283,8 @@ export declare class ChannelMap<T> {
  * ```ts
  * const approvals = new Channel("approvals", stringCodec);
  * const wait = Wait.anyOf(
- *   approvals.forOne("approved"),
- *   Timer.byDuration(5 * 60_000, "timeout"),
+ *   approvals.forOne(),
+ *   Timer.byDuration(5 * 60_000),
  * );
  * ```
  */
@@ -255,24 +305,34 @@ export declare const Wait: Readonly<{
     skipImmediately(): Wait;
     /**
      * Creates a Wait for one condition.
+     * The Condition does not need a condition ID.
      * @param condition - The only readiness condition.
      * @returns An all-of Wait with the condition.
      */
     until(condition: Condition): Wait;
     /**
      * Creates a Wait requiring every condition.
+     * This combinator does not require condition IDs. Every Condition in
+     * `anyCombinationOf` does require one.
      * @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.
+     * Conditions do not need condition IDs. Read Channel results from the Channel
+     * definition and inspect Timer outcomes through `Context`.
+     *
+     * Channel consumption is not greedy across alternatives: only the selected condition consumes.
+     * Other ready Channel conditions consume nothing.
      * @param conditions - Alternative readiness conditions.
      * @returns An any-of Wait.
      */
     anyOf(...conditions: readonly Condition[]): Wait;
     /**
      * Creates a Wait accepting any complete condition combination.
+     * Channel consumption is limited to conditions in the selected combination.
+     * Conditions belonging only to other ready combinations consume nothing.
      * Every Condition requires a non-empty user ID; the same instance may be reused.
      * @param combinations - Alternative all-of condition groups.
      * @returns An any-combination Wait.

package/dist/src/wait.js

@@ -5,7 +5,7 @@
 // See the LICENSE file in the repository root.
 //
 // SPDX-License-Identifier: LicenseRef-Super-Durable-1.0
-import { requireConditionId, requirePersistenceDefinitionName, validateChannelBounds, } from "./validation.js";
+import { requireConditionId, requireMapInstance, requireName, requirePersistenceDefinitionName, validateChannelBounds, } from "./validation.js";
 /** Creates all-of Condition groups for `Wait.anyCombinationOf`. */
 export const ConditionCombination = Object.freeze({
     /**
@@ -78,6 +78,25 @@ export class Channel {
     size(context) {
         return context.channelSize(this);
     }
+    /**
+     * Returns the loaded pending-message snapshot in FIFO order.
+     * @param context - Current RPC Context.
+     * @returns Immutable pending message IDs and decoded values.
+     * @throws {@link StateNotLoadedError} when the RPC did not load this Channel.
+     */
+    pendingMessages(context) {
+        return context.pendingChannelMessages(this);
+    }
+    /**
+     * Finds one message in the loaded pending snapshot.
+     * @param context - Current RPC Context.
+     * @param messageId - Server-assigned message ID.
+     * @returns The matching message, or `undefined` when absent from the snapshot.
+     */
+    findPendingMessage(context, messageId) {
+        const requiredId = requireName(messageId);
+        return this.pendingMessages(context).find((message) => message.messageId === requiredId);
+    }
     /**
      * Returns values selected by this Step's satisfied condition.
      * @param context - Current Step Context.
@@ -113,7 +132,8 @@ export class Channel {
         return this.range(count, undefined, conditionId);
     }
     /**
-     * Creates a condition consuming at most `count` available values.
+     * Creates a non-blocking condition consuming up to `count` queued values.
+     * When its surrounding Wait completes, it consumes values queued then; an empty queue yields none.
      * @param count - Inclusive non-negative upper bound.
      * @param conditionId - Optional stable condition identifier.
      * @returns A condition without a positive lower bound.
@@ -123,6 +143,8 @@ export class Channel {
     }
     /**
      * Creates a bounded condition for queued Channel values.
+     * Dex waits only for `atLeast`, then consumes currently queued values up to `atMost`.
+     * Omitting `atLeast` makes the condition complete immediately.
      * @param atLeast - Optional inclusive lower bound.
      * @param atMost - Optional inclusive upper bound.
      * @param conditionId - Optional stable condition identifier.
@@ -142,6 +164,7 @@ export class Channel {
 }
 /**
  * Defines keyed Channel instances that share one typed schema.
+ * Instance keys must be non-empty and must not contain `/`.
  * @typeParam T - Type of every published value.
  */
 export class ChannelMap {
@@ -160,7 +183,7 @@ export class ChannelMap {
     /**
      * Stages one value for a ChannelMap instance.
      * @param context - Current Step or RPC Context.
-     * @param instance - Non-empty logical map key.
+     * @param instance - The map instance. Slash is prohibited because it is a reserved character.
      * @param value - Typed value to append.
      */
     publish(context, instance, value) {
@@ -169,7 +192,7 @@ export class ChannelMap {
     /**
      * Stages deletion of one pending message from a ChannelMap instance in an RPC.
      * @param context - Current RPC Context.
-     * @param instance - Non-empty ChannelMap instance.
+     * @param instance - The ChannelMap instance. Slash is prohibited because it is a reserved character.
      * @param messageId - Non-empty server-assigned message ID.
      */
     delete(context, instance, messageId) {
@@ -178,12 +201,42 @@ export class ChannelMap {
     /**
      * Returns one instance's queued value count.
      * @param context - Current Step or RPC Context.
-     * @param instance - Non-empty logical map key.
+     * @param instance - The map instance. Slash is prohibited because it is a reserved character.
      * @returns Non-negative queued value count.
      */
     size(context, instance) {
         return context.channelSize(this, instance);
     }
+    /**
+     * Selects one instance's pending messages for an RPC snapshot.
+     * @param instance - Non-empty logical instance key. The SDK escapes it for the protocol.
+     * @returns An exact instance load for {@link RPCOptions.loadChannelMapInstances}.
+     */
+    loadMessages(instance) {
+        requireMapInstance(instance);
+        return { channelMap: this, instance };
+    }
+    /**
+     * Returns one loaded instance snapshot in FIFO order.
+     * @param context - Current RPC Context.
+     * @param instance - Logical ChannelMap instance.
+     * @returns Immutable pending message IDs and decoded values.
+     * @throws {@link StateNotLoadedError} when the RPC did not load this instance or map.
+     */
+    pendingMessages(context, instance) {
+        return context.pendingChannelMessages(this, instance);
+    }
+    /**
+     * Finds one instance message in the loaded pending snapshot.
+     * @param context - Current RPC Context.
+     * @param instance - Logical ChannelMap instance.
+     * @param messageId - Server-assigned message ID.
+     * @returns The matching message, or `undefined` when absent from the snapshot.
+     */
+    findPendingMessage(context, instance, messageId) {
+        const requiredId = requireName(messageId);
+        return this.pendingMessages(context, instance).find((message) => message.messageId === requiredId);
+    }
     /**
      * Returns the number of non-empty instances visible to the current RPC.
      * @param context - Current RPC Context.
@@ -203,7 +256,7 @@ export class ChannelMap {
     /**
      * Returns values selected for one instance by the satisfied condition.
      * @param context - Current Step Context.
-     * @param instance - Non-empty logical map key.
+     * @param instance - The map instance. Slash is prohibited because it is a reserved character.
      * @returns Ordered values for this Step execution.
      */
     results(context, instance) {
@@ -211,7 +264,7 @@ export class ChannelMap {
     }
     /**
      * Creates an instance condition consuming exactly one value.
-     * @param instance - Non-empty logical map key.
+     * @param instance - The map instance. Slash is prohibited because it is a reserved character.
      * @param conditionId - Optional stable condition identifier.
      * @returns An exact-one instance condition.
      */
@@ -220,7 +273,7 @@ export class ChannelMap {
     }
     /**
      * Creates an instance condition consuming exactly `count` values.
-     * @param instance - Non-empty logical map key.
+     * @param instance - The map instance. Slash is prohibited because it is a reserved character.
      * @param count - Required non-negative count.
      * @param conditionId - Optional stable condition identifier.
      * @returns A condition with equal bounds.
@@ -230,7 +283,7 @@ export class ChannelMap {
     }
     /**
      * Creates an instance condition requiring at least `count` values.
-     * @param instance - Non-empty logical map key.
+     * @param instance - The map instance. Slash is prohibited because it is a reserved character.
      * @param count - Inclusive non-negative lower bound.
      * @param conditionId - Optional stable condition identifier.
      * @returns A condition without an upper bound.
@@ -239,8 +292,9 @@ export class ChannelMap {
         return this.range(instance, count, undefined, conditionId);
     }
     /**
-     * Creates an instance condition consuming at most `count` values.
-     * @param instance - Non-empty logical map key.
+     * Creates a non-blocking instance condition consuming up to `count` queued values.
+     * When its surrounding Wait completes, it consumes values queued then; an empty queue yields none.
+     * @param instance - The map instance. Slash is prohibited because it is a reserved character.
      * @param count - Inclusive non-negative upper bound.
      * @param conditionId - Optional stable condition identifier.
      * @returns A condition without a positive lower bound.
@@ -250,7 +304,9 @@ export class ChannelMap {
     }
     /**
      * Creates a bounded condition for one ChannelMap instance.
-     * @param instance - Non-empty logical map key.
+     * Dex waits only for `atLeast`, then consumes currently queued values up to `atMost`.
+     * Omitting `atLeast` makes the condition complete immediately.
+     * @param instance - The map instance. Slash is prohibited because it is a reserved character.
      * @param atLeast - Optional inclusive lower bound.
      * @param atMost - Optional inclusive upper bound.
      * @param conditionId - Optional stable condition identifier.
@@ -259,6 +315,7 @@ export class ChannelMap {
     range(instance, atLeast, atMost, conditionId) {
         validateChannelBounds(atLeast, atMost);
         requireConditionId(conditionId);
+        requireMapInstance(instance);
         return {
             kind: "channel",
             channelName: this.name,
@@ -280,6 +337,7 @@ export const Wait = Object.freeze({
     },
     /**
      * Creates a Wait for one condition.
+     * The Condition does not need a condition ID.
      * @param condition - The only readiness condition.
      * @returns An all-of Wait with the condition.
      */
@@ -288,6 +346,8 @@ export const Wait = Object.freeze({
     },
     /**
      * Creates a Wait requiring every condition.
+     * This combinator does not require condition IDs. Every Condition in
+     * `anyCombinationOf` does require one.
      * @param conditions - Conditions evaluated as one all-of group.
      * @returns An all-of Wait.
      */
@@ -296,6 +356,11 @@ export const Wait = Object.freeze({
     },
     /**
      * Creates a Wait that continues when any condition is ready.
+     * Conditions do not need condition IDs. Read Channel results from the Channel
+     * definition and inspect Timer outcomes through `Context`.
+     *
+     * Channel consumption is not greedy across alternatives: only the selected condition consumes.
+     * Other ready Channel conditions consume nothing.
      * @param conditions - Alternative readiness conditions.
      * @returns An any-of Wait.
      */
@@ -304,6 +369,8 @@ export const Wait = Object.freeze({
     },
     /**
      * Creates a Wait accepting any complete condition combination.
+     * Channel consumption is limited to conditions in the selected combination.
+     * Conditions belonging only to other ready combinations consume nothing.
      * Every Condition requires a non-empty user ID; the same instance may be reused.
      * @param combinations - Alternative all-of condition groups.
      * @returns An any-combination Wait.

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

@@ -15,6 +15,7 @@ import { ActiveStepSearchMode, FlowTimeoutPolicy } from "./options.js";
 import { SubFlowReusePolicy } from "./subflow.js";
 import { codecOrJson, decodeValue, encodeUnknown, encodeValue, } from "./value-mapper.js";
 import { Channel, ChannelMap } from "./wait.js";
+import { requireMapInstance } from "./validation.js";
 const timeoutHandlerStepType = "sys:timeout_handler";
 export class WorkerDispatcher {
     registry;
@@ -120,7 +121,7 @@ export class WorkerDispatcher {
         cancellationSignal.throwIfAborted();
         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, cancellationSignal);
+        const context = new InvocationContext("rpc", flow, request.context, request.attributes, [], undefined, request.channelInfos, cancellationSignal, undefined, request.loadedChannelMessages, request.loadedAttributeMapInstances, request.loadedChannelNames, request.loadedChannelMapInstances);
         const returned = await invokeRPC(flow, rpc, context, request.input);
         try {
             const result = rpcResult(rpc, returned);
@@ -189,14 +190,29 @@ export class WorkerDispatcher {
     }
     async hydrateRPC(request) {
         const hasInput = request.input !== undefined;
+        const channelMessages = Object.values(request.loadedChannelMessages)
+            .flatMap((values) => values.messages);
         const values = await this.hydrator.hydrateAll([
             ...(hasInput ? [request.input] : []),
             ...request.attributes.map((entry) => entry.value),
+            ...channelMessages.map((message) => message.value),
         ]);
+        let offset = hasInput ? 1 : 0;
+        const attributes = replaceEntryValues(request.attributes, values.slice(offset, (offset += request.attributes.length)));
+        const loadedChannelMessages = Object.fromEntries(Object.entries(request.loadedChannelMessages).map(([name, channelValues]) => [
+            name,
+            {
+                messages: channelValues.messages.map((message) => ({
+                    ...message,
+                    value: values[offset++],
+                })),
+            },
+        ]));
         return {
             ...request,
             input: hasInput ? values[0] : undefined,
-            attributes: replaceEntryValues(request.attributes, values.slice(hasInput ? 1 : 0)),
+            attributes,
+            loadedChannelMessages,
         };
     }
 }
@@ -639,9 +655,10 @@ function requireValue(value, kind) {
     return value;
 }
 function physicalName(name, instance) {
-    if (instance === undefined || instance === "") {
+    if (instance === undefined) {
         throw new TypeError(`map definition ${name} requires an instance`);
     }
+    requireMapInstance(instance);
     return `${name}/${encodeURIComponent(instance).replace(/[!'()*]/g, (character) => `%${character.charCodeAt(0).toString(16).toUpperCase()}`)}`;
 }
 function seconds(milliseconds) {