@superdurable/dex 0.1.0

package/dist/src/persistence.js

@@ -0,0 +1,65 @@
+// Copyright (c) 2026 Super Durable, Inc.
+//
+// Licensed under the Super Durable Source License 1.0.
+// You may not use this file except in compliance with the License.
+// See the LICENSE file in the repository root.
+//
+// SPDX-License-Identifier: LicenseRef-Super-Durable-1.0
+import { requireName } from "./validation.js";
+export const IndexType = Object.freeze({
+    KEYWORD: "keyword",
+    FULL_TEXT: "fullText",
+    KEYWORD_ARRAY: "keywordArray",
+    INT: "int",
+    DOUBLE: "double",
+    BOOL: "bool",
+    DATETIME: "datetime",
+});
+export class Attribute {
+    name;
+    codec;
+    index;
+    constructor(name, codec, index) {
+        this.name = name;
+        this.codec = codec;
+        this.index = index;
+        requireName(name);
+    }
+    get(context) {
+        return context.getAttribute(this);
+    }
+    set(context, value) {
+        context.setAttribute(this, value);
+    }
+    delete(context) {
+        context.deleteAttribute(this);
+    }
+    lock() {
+        return { attribute: this };
+    }
+}
+export class AttributeMap {
+    name;
+    codec;
+    index;
+    constructor(name, codec, index) {
+        this.name = name;
+        this.codec = codec;
+        this.index = index;
+        requireName(name);
+    }
+    get(context, instance) {
+        return context.getAttribute(this, instance);
+    }
+    set(context, instance, value) {
+        context.setAttribute(this, value, instance);
+    }
+    delete(context, instance) {
+        context.deleteAttribute(this, instance);
+    }
+    lock(instance) {
+        requireName(instance);
+        return { attribute: this, instance };
+    }
+}
+//# sourceMappingURL=persistence.js.map

package/dist/src/persistence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.js","sourceRoot":"","sources":["../../src/persistence.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,EAAE;AACF,uDAAuD;AACvD,mEAAmE;AACnE,+CAA+C;AAC/C,EAAE;AACF,wDAAwD;AAKxD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C,MAAM,CAAC,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC;IACrC,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,UAAU;IACrB,aAAa,EAAE,cAAc;IAC7B,GAAG,EAAE,KAAK;IACV,MAAM,EAAE,QAAQ;IAChB,IAAI,EAAE,MAAM;IACZ,QAAQ,EAAE,UAAU;CACZ,CAAC,CAAC;AAcZ,MAAM,OAAO,SAAS;IAEF;IACA;IACA;IAHlB,YACkB,IAAY,EACZ,KAAe,EACf,KAAsB;QAFtB,SAAI,GAAJ,IAAI,CAAQ;QACZ,UAAK,GAAL,KAAK,CAAU;QACf,UAAK,GAAL,KAAK,CAAiB;QAEtC,WAAW,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC;IAEM,GAAG,CAAC,OAAgB;QACzB,OAAO,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAEM,GAAG,CAAC,OAAgB,EAAE,KAAQ;QACnC,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACpC,CAAC;IAEM,MAAM,CAAC,OAAgB;QAC5B,OAAO,CAAC,eAAe,CAAC,IAA0B,CAAC,CAAC;IACtD,CAAC;IAEM,IAAI;QACT,OAAO,EAAE,SAAS,EAAE,IAA0B,EAAE,CAAC;IACnD,CAAC;CACF;AAED,MAAM,OAAO,YAAY;IAEL;IACA;IACA;IAHlB,YACkB,IAAY,EACZ,KAAe,EACf,KAAsB;QAFtB,SAAI,GAAJ,IAAI,CAAQ;QACZ,UAAK,GAAL,KAAK,CAAU;QACf,UAAK,GAAL,KAAK,CAAiB;QAEtC,WAAW,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC;IAEM,GAAG,CAAC,OAAgB,EAAE,QAAgB;QAC3C,OAAO,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC9C,CAAC;IAEM,GAAG,CAAC,OAAgB,EAAE,QAAgB,EAAE,KAAQ;QACrD,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC9C,CAAC;IAEM,MAAM,CAAC,OAAgB,EAAE,QAAgB;QAC9C,OAAO,CAAC,eAAe,CAAC,IAA6B,EAAE,QAAQ,CAAC,CAAC;IACnE,CAAC;IAEM,IAAI,CAAC,QAAgB;QAC1B,WAAW,CAAC,QAAQ,CAAC,CAAC;QACtB,OAAO,EAAE,SAAS,EAAE,IAA6B,EAAE,QAAQ,EAAE,CAAC;IAChE,CAAC;CACF"}

package/dist/src/rpc.d.ts

@@ -0,0 +1,39 @@
+import type { Codec } from "./codec.js";
+import type { Context } from "./context.js";
+import type { Flow } from "./flow.js";
+import type { AttributeLock } from "./persistence.js";
+import type { StepMovement } from "./step.js";
+export interface RPCResult<Output> {
+    readonly output: Output;
+    readonly nextSteps?: readonly StepMovement<unknown>[];
+}
+export type RPC<Input, Output> = (context: Context, input: Input) => RPCResult<Output>;
+export interface RPCOptions<Input = unknown, Output = unknown> {
+    readonly name?: string;
+    readonly inputCodec?: Codec<Input>;
+    readonly outputCodec?: Codec<Output>;
+    readonly timeoutMs?: number;
+    readonly lockAttributes?: readonly AttributeLock[];
+}
+export interface RegisteredRPC {
+    readonly method: Function;
+    readonly name: string;
+    readonly options: RPCOptions<any, any>;
+}
+export declare function rpc<Input, Output>(options: RPCOptions<Input, Output> & {
+    readonly inputCodec: Codec<Input>;
+    readonly outputCodec: Codec<Output>;
+}): <This>(method: (this: This, context: Context, input: Input) => RPCResult<Output>, context: ClassMethodDecoratorContext<This, (this: This, context: Context, input: Input) => RPCResult<Output>>) => void;
+export declare function rpc<Output>(options: RPCOptions<never, Output> & {
+    readonly inputCodec?: never;
+    readonly outputCodec: Codec<Output>;
+}): <This>(method: (this: This, context: Context) => RPCResult<Output>, context: ClassMethodDecoratorContext<This, (this: This, context: Context) => RPCResult<Output>>) => void;
+export declare function rpc<Input>(options: RPCOptions<Input, never> & {
+    readonly inputCodec: Codec<Input>;
+    readonly outputCodec?: never;
+}): <This>(method: (this: This, context: Context, input: Input) => void, context: ClassMethodDecoratorContext<This, (this: This, context: Context, input: Input) => void>) => void;
+export declare function rpc(options?: RPCOptions<never, never> & {
+    readonly inputCodec?: never;
+    readonly outputCodec?: never;
+}): <This>(method: (this: This, context: Context) => void, context: ClassMethodDecoratorContext<This, (this: This, context: Context) => void>) => void;
+export declare function registeredRPCs(flow: Flow<unknown>): readonly RegisteredRPC[];

package/dist/src/rpc.js

@@ -0,0 +1,50 @@
+// Copyright (c) 2026 Super Durable, Inc.
+//
+// Licensed under the Super Durable Source License 1.0.
+// You may not use this file except in compliance with the License.
+// See the LICENSE file in the repository root.
+//
+// SPDX-License-Identifier: LicenseRef-Super-Durable-1.0
+import { requireName } from "./validation.js";
+const rpcOptions = new WeakMap();
+export function rpc(options = {}) {
+    if (options.name !== undefined) {
+        requireName(options.name);
+    }
+    if (options.timeoutMs !== undefined && options.timeoutMs < 0) {
+        throw new RangeError("RPC timeout must be non-negative");
+    }
+    const immutableOptions = Object.freeze({ ...options });
+    return function (method, _context) {
+        rpcOptions.set(method, immutableOptions);
+    };
+}
+export function registeredRPCs(flow) {
+    const registered = [];
+    const visitedNames = new Set();
+    let prototype = Object.getPrototypeOf(flow);
+    while (prototype !== null && prototype !== Object.prototype) {
+        for (const name of Object.getOwnPropertyNames(prototype)) {
+            if (name === "constructor" || visitedNames.has(name)) {
+                continue;
+            }
+            visitedNames.add(name);
+            const method = Object.getOwnPropertyDescriptor(prototype, name)?.value;
+            if (typeof method !== "function") {
+                continue;
+            }
+            const options = rpcOptions.get(method);
+            if (options === undefined) {
+                continue;
+            }
+            registered.push({
+                method,
+                name: options.name ?? name,
+                options,
+            });
+        }
+        prototype = Object.getPrototypeOf(prototype);
+    }
+    return registered;
+}
+//# sourceMappingURL=rpc.js.map

package/dist/src/rpc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.js","sourceRoot":"","sources":["../../src/rpc.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,EAAE;AACF,uDAAuD;AACvD,mEAAmE;AACnE,+CAA+C;AAC/C,EAAE;AACF,wDAAwD;AAOxD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAuB9C,MAAM,UAAU,GAAG,IAAI,OAAO,EAAkC,CAAC;AAwCjE,MAAM,UAAU,GAAG,CAAC,UAAgC,EAAE;IACpD,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC/B,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IACD,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,IAAI,OAAO,CAAC,SAAS,GAAG,CAAC,EAAE,CAAC;QAC7D,MAAM,IAAI,UAAU,CAAC,kCAAkC,CAAC,CAAC;IAC3D,CAAC;IACD,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACvD,OAAO,UACL,MAAc,EACd,QAAmD;QAEnD,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC3C,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAmB;IAChD,MAAM,UAAU,GAAoB,EAAE,CAAC;IACvC,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;IACvC,IAAI,SAAS,GAAkB,MAAM,CAAC,cAAc,CAAC,IAAI,CAAkB,CAAC;IAC5E,OAAO,SAAS,KAAK,IAAI,IAAI,SAAS,KAAK,MAAM,CAAC,SAAS,EAAE,CAAC;QAC5D,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,mBAAmB,CAAC,SAAS,CAAC,EAAE,CAAC;YACzD,IAAI,IAAI,KAAK,aAAa,IAAI,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACrD,SAAS;YACX,CAAC;YACD,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACvB,MAAM,MAAM,GAAG,MAAM,CAAC,wBAAwB,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,KAAgB,CAAC;YAClF,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;gBACjC,SAAS;YACX,CAAC;YACD,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACvC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;gBAC1B,SAAS;YACX,CAAC;YACD,UAAU,CAAC,IAAI,CAAC;gBACd,MAAM;gBACN,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,IAAI;gBAC1B,OAAO;aACR,CAAC,CAAC;QACL,CAAC;QACD,SAAS,GAAG,MAAM,CAAC,cAAc,CAAC,SAAS,CAAkB,CAAC;IAChE,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/src/step.d.ts

@@ -0,0 +1,92 @@
+import type { Codec } from "./codec.js";
+import type { Context } from "./context.js";
+import type { AttributeLock } from "./persistence.js";
+import type { Channel, ChannelMap, Wait } from "./wait.js";
+export type StepDurability = "sync" | "async";
+export type WaitForFailurePolicy = "failFlow" | "proceed";
+export interface RetryPolicy {
+    readonly initialIntervalMs?: number;
+    readonly backoffCoefficient?: number;
+    readonly maximumIntervalMs?: number;
+    readonly maximumAttempts?: number;
+    readonly totalDurationMs?: number;
+}
+export interface ExecuteFailure {
+    readonly step: Step<unknown>;
+    readonly options?: StepOptions;
+}
+export declare const ExecuteFailure: Readonly<{
+    proceedTo<Input>(step: Step<Input>, options?: StepOptions): ExecuteFailure;
+}>;
+export interface StepOptions {
+    readonly waitForMethodTimeoutMs?: number;
+    readonly executeMethodTimeoutMs?: number;
+    readonly waitForRetry?: RetryPolicy;
+    readonly executeRetry?: RetryPolicy;
+    readonly waitForFailure?: WaitForFailurePolicy;
+    readonly waitForDurability?: StepDurability;
+    readonly executeDurability?: StepDurability;
+    readonly waitForLockAttributes?: readonly AttributeLock[];
+    readonly executeLockAttributes?: readonly AttributeLock[];
+    readonly executeFailure?: ExecuteFailure;
+}
+export interface Step<Input> {
+    readonly inputCodec: Codec<Input>;
+    getStepType(): string;
+    getStepOptions?(): StepOptions | undefined;
+    waitFor?(context: Context, input: Input): Wait;
+    execute(context: Context, input: Input): StepDecision;
+}
+interface StartStepDefinition<StartInput> {
+    readonly step: Step<StartInput>;
+    readonly isStartStep: true;
+}
+interface NonStartStepDefinition {
+    readonly step: Step<unknown>;
+    readonly isStartStep: false;
+}
+type StepDefinition = StartStepDefinition<unknown> | NonStartStepDefinition;
+declare const startInputType: unique symbol;
+export declare class StepList<StartInput> {
+    readonly [startInputType]: (input: StartInput) => StartInput;
+    private readonly definitions;
+    private constructor();
+    static empty<StartInput = void>(): StepList<StartInput>;
+    static startStep<StartInput>(step: Step<StartInput>): StepList<StartInput>;
+    static withoutStartStep<StartInput = never>(...steps: readonly Step<any>[]): StepList<StartInput>;
+    otherSteps(...steps: readonly Step<any>[]): StepList<StartInput>;
+    [Symbol.iterator](): Iterator<StepDefinition>;
+}
+export interface StepMovement<Input> {
+    readonly step: Step<Input>;
+    readonly input: Input;
+    readonly options?: StepOptions;
+}
+export declare const StepMovement: Readonly<{
+    of<Input>(step: Step<Input>, input: Input, options?: StepOptions): StepMovement<Input>;
+}>;
+export type StepDecision = Readonly<{
+    kind: "next";
+    movements: readonly StepMovement<unknown>[];
+}> | Readonly<{
+    kind: "gracefulComplete" | "forceComplete";
+    output: unknown;
+}> | Readonly<{
+    kind: "forceCompleteIfChannelsEmpty";
+    output: unknown;
+    fallback: StepMovement<unknown>;
+    channels: readonly (Channel<unknown> | ChannelMap<unknown>)[];
+}> | Readonly<{
+    kind: "forceFail";
+    reason: string;
+}> | Readonly<{
+    kind: "deadEnd";
+}>;
+export declare const goTo: <Input>(step: Step<Input>, input: Input) => StepDecision;
+export declare const goToMulti: (...movements: readonly StepMovement<unknown>[]) => StepDecision;
+export declare const gracefulComplete: (output?: unknown) => StepDecision;
+export declare const forceComplete: (output?: unknown) => StepDecision;
+export declare const forceCompleteWhenChannelsEmpty: (output: unknown, fallback: StepMovement<unknown>, ...channels: readonly (Channel<unknown> | ChannelMap<unknown>)[]) => StepDecision;
+export declare const forceFail: (reason: string) => StepDecision;
+export declare const deadEnd: () => StepDecision;
+export {};

package/dist/src/step.js

@@ -0,0 +1,62 @@
+// Copyright (c) 2026 Super Durable, Inc.
+//
+// Licensed under the Super Durable Source License 1.0.
+// You may not use this file except in compliance with the License.
+// See the LICENSE file in the repository root.
+//
+// SPDX-License-Identifier: LicenseRef-Super-Durable-1.0
+export const ExecuteFailure = Object.freeze({
+    proceedTo(step, options) {
+        return {
+            step: step,
+            ...(options === undefined ? {} : { options }),
+        };
+    },
+});
+export class StepList {
+    definitions;
+    constructor(definitions) {
+        this.definitions = Object.freeze([...definitions]);
+    }
+    static empty() {
+        return new StepList([]);
+    }
+    static startStep(step) {
+        return new StepList([{ step: step, isStartStep: true }]);
+    }
+    static withoutStartStep(...steps) {
+        return new StepList(steps.map((step) => ({ step: step, isStartStep: false })));
+    }
+    otherSteps(...steps) {
+        return new StepList([
+            ...this.definitions,
+            ...steps.map((step) => ({ step: step, isStartStep: false })),
+        ]);
+    }
+    [Symbol.iterator]() {
+        return this.definitions[Symbol.iterator]();
+    }
+}
+export const StepMovement = Object.freeze({
+    of(step, input, options) {
+        return {
+            step,
+            input,
+            ...(options === undefined ? {} : { options }),
+        };
+    },
+});
+export const goTo = (step, input) => goToMulti(StepMovement.of(step, input));
+export const goToMulti = (...movements) => ({
+    kind: "next",
+    movements,
+});
+export const gracefulComplete = (output) => ({
+    kind: "gracefulComplete",
+    output,
+});
+export const forceComplete = (output) => ({ kind: "forceComplete", output });
+export const forceCompleteWhenChannelsEmpty = (output, fallback, ...channels) => ({ kind: "forceCompleteIfChannelsEmpty", output, fallback, channels });
+export const forceFail = (reason) => ({ kind: "forceFail", reason });
+export const deadEnd = () => ({ kind: "deadEnd" });
+//# sourceMappingURL=step.js.map

package/dist/src/step.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"step.js","sourceRoot":"","sources":["../../src/step.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,EAAE;AACF,uDAAuD;AACvD,mEAAmE;AACnE,+CAA+C;AAC/C,EAAE;AACF,wDAAwD;AAuBxD,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC;IAC1C,SAAS,CAAQ,IAAiB,EAAE,OAAqB;QACvD,OAAO;YACL,IAAI,EAAE,IAAqB;YAC3B,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC;SAC9C,CAAC;IACJ,CAAC;CACF,CAAC,CAAC;AAqCH,MAAM,OAAO,QAAQ;IAGF,WAAW,CAA4B;IAExD,YAAoB,WAAsC;QACxD,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC;IACrD,CAAC;IAEM,MAAM,CAAC,KAAK;QACjB,OAAO,IAAI,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC1B,CAAC;IAEM,MAAM,CAAC,SAAS,CAAa,IAAsB;QACxD,OAAO,IAAI,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,IAAqB,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC5E,CAAC;IAEM,MAAM,CAAC,gBAAgB,CAC5B,GAAG,KAA2B;QAE9B,OAAO,IAAI,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAqB,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;IAClG,CAAC;IAEM,UAAU,CAAC,GAAG,KAA2B;QAC9C,OAAO,IAAI,QAAQ,CAAC;YAClB,GAAG,IAAI,CAAC,WAAW;YACnB,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAqB,EAAE,WAAW,EAAE,KAAc,EAAE,CAAC,CAAC;SACvF,CAAC,CAAC;IACL,CAAC;IAEM,CAAC,MAAM,CAAC,QAAQ,CAAC;QACtB,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;IAC7C,CAAC;CACF;AAQD,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC;IACxC,EAAE,CAAQ,IAAiB,EAAE,KAAY,EAAE,OAAqB;QAC9D,OAAO;YACL,IAAI;YACJ,KAAK;YACL,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC;SAC9C,CAAC;IACJ,CAAC;CACF,CAAC,CAAC;AAcH,MAAM,CAAC,MAAM,IAAI,GAAG,CAAQ,IAAiB,EAAE,KAAY,EAAgB,EAAE,CAC3E,SAAS,CAAC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;AAE1C,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,GAAG,SAA2C,EAAgB,EAAE,CAAC,CAAC;IAC1F,IAAI,EAAE,MAAM;IACZ,SAAS;CACV,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,MAAgB,EAAgB,EAAE,CAAC,CAAC;IACnE,IAAI,EAAE,kBAAkB;IACxB,MAAM;CACP,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,MAAgB,EAAgB,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,CAAC,CAAC;AAErG,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAC5C,MAAe,EACf,QAA+B,EAC/B,GAAG,QAA6D,EAClD,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,8BAA8B,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;AAE1F,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,MAAc,EAAgB,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC;AAE3F,MAAM,CAAC,MAAM,OAAO,GAAG,GAAiB,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC"}

package/dist/src/validation.d.ts

@@ -0,0 +1,3 @@
+export declare function requireName(name: string): string;
+export declare function requireConditionId(conditionId: string | undefined): void;
+export declare function validateChannelBounds(atLeast: number | undefined, atMost: number | undefined): void;

package/dist/src/validation.js

@@ -0,0 +1,33 @@
+// Copyright (c) 2026 Super Durable, Inc.
+//
+// Licensed under the Super Durable Source License 1.0.
+// You may not use this file except in compliance with the License.
+// See the LICENSE file in the repository root.
+//
+// SPDX-License-Identifier: LicenseRef-Super-Durable-1.0
+export function requireName(name) {
+    if (name.trim().length === 0) {
+        throw new TypeError("durable name is required");
+    }
+    return name;
+}
+export function requireConditionId(conditionId) {
+    if (conditionId !== undefined && conditionId.length === 0) {
+        throw new TypeError("condition ID must not be empty");
+    }
+}
+export function validateChannelBounds(atLeast, atMost) {
+    if (atLeast === undefined && atMost === undefined) {
+        throw new RangeError("channel condition requires a bound");
+    }
+    if (atLeast !== undefined && atLeast < 0) {
+        throw new RangeError("atLeast must be non-negative");
+    }
+    if (atMost !== undefined && atMost < 0) {
+        throw new RangeError("atMost must be non-negative");
+    }
+    if (atLeast !== undefined && atMost !== undefined && atMost < atLeast) {
+        throw new RangeError("atMost must not be below atLeast");
+    }
+}
+//# sourceMappingURL=validation.js.map

package/dist/src/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/validation.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,EAAE;AACF,uDAAuD;AACvD,mEAAmE;AACnE,+CAA+C;AAC/C,EAAE;AACF,wDAAwD;AAExD,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,SAAS,CAAC,0BAA0B,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,WAA+B;IAChE,IAAI,WAAW,KAAK,SAAS,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,SAAS,CAAC,gCAAgC,CAAC,CAAC;IACxD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,OAA2B,EAC3B,MAA0B;IAE1B,IAAI,OAAO,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QAClD,MAAM,IAAI,UAAU,CAAC,oCAAoC,CAAC,CAAC;IAC7D,CAAC;IACD,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,UAAU,CAAC,8BAA8B,CAAC,CAAC;IACvD,CAAC;IACD,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,UAAU,CAAC,6BAA6B,CAAC,CAAC;IACtD,CAAC;IACD,IAAI,OAAO,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,GAAG,OAAO,EAAE,CAAC;QACtE,MAAM,IAAI,UAAU,CAAC,kCAAkC,CAAC,CAAC;IAC3D,CAAC;AACH,CAAC"}

package/dist/src/value-mapper.d.ts

@@ -0,0 +1,14 @@
+import type { BlobCache } from "./blob-cache.js";
+import type { Codec } from "./codec.js";
+import { Value as ProtoValue, type FlowServiceClient } from "./gen/dex.js";
+export declare function encodeValue<T>(codec: Codec<T>, value: T): ProtoValue;
+export declare function encodeUnknown(value: unknown): ProtoValue;
+export declare function decodeValue<T>(codec: Codec<T>, value: ProtoValue): T;
+export declare function deletionValue(): ProtoValue;
+export declare class ValueHydrator {
+    private readonly service;
+    private readonly blobCache;
+    constructor(service: FlowServiceClient, blobCache: BlobCache);
+    hydrate(value: ProtoValue | undefined): Promise<ProtoValue>;
+    hydrateAll(values: readonly (ProtoValue | undefined)[]): Promise<ProtoValue[]>;
+}

package/dist/src/value-mapper.js

@@ -0,0 +1,199 @@
+// Copyright (c) 2026 Super Durable, Inc.
+//
+// Licensed under the Super Durable Source License 1.0.
+// You may not use this file except in compliance with the License.
+// See the LICENSE file in the repository root.
+//
+// SPDX-License-Identifier: LicenseRef-Super-Durable-1.0
+import { NullValue } from "./gen/google/protobuf/struct.js";
+import { Value as ProtoValue, } from "./gen/dex.js";
+const textEncoder = new TextEncoder();
+const textDecoder = new TextDecoder();
+export function encodeValue(codec, value) {
+    if (value === undefined || value === null) {
+        return objectValue("json", textEncoder.encode("null"));
+    }
+    const encoded = codec.encode(value);
+    switch (encoded.kind) {
+        case "string":
+            return ProtoValue.create({ kind: { $case: "stringValue", value: encoded.data } });
+        case "bool":
+            return ProtoValue.create({ kind: { $case: "boolValue", value: encoded.data } });
+        case "int64":
+            return ProtoValue.create({ kind: { $case: "intValue", value: encoded.data } });
+        case "double":
+            return ProtoValue.create({ kind: { $case: "doubleValue", value: encoded.data } });
+        case "bytes":
+            return objectValue("rawbytes", encoded.data);
+        case "json":
+            return objectValue("json", textEncoder.encode(encoded.data));
+    }
+}
+export function encodeUnknown(value) {
+    if (value === undefined || value === null) {
+        return objectValue("json", textEncoder.encode("null"));
+    }
+    if (typeof value === "string") {
+        return ProtoValue.create({ kind: { $case: "stringValue", value } });
+    }
+    if (typeof value === "boolean") {
+        return ProtoValue.create({ kind: { $case: "boolValue", value } });
+    }
+    if (typeof value === "bigint") {
+        return ProtoValue.create({ kind: { $case: "intValue", value } });
+    }
+    if (typeof value === "number") {
+        if (!Number.isFinite(value)) {
+            throw new RangeError("non-finite numbers are unsupported");
+        }
+        return ProtoValue.create({ kind: { $case: "doubleValue", value } });
+    }
+    if (value instanceof Uint8Array) {
+        return objectValue("rawbytes", value);
+    }
+    const json = JSON.stringify(value);
+    if (json === undefined) {
+        throw new TypeError("value cannot be encoded as JSON");
+    }
+    return objectValue("json", textEncoder.encode(json));
+}
+export function decodeValue(codec, value) {
+    if (value.kind?.$case === "objValue" &&
+        value.kind.value.encoding === "json" &&
+        textDecoder.decode(value.kind.value.payload) === "null") {
+        return undefined;
+    }
+    return codec.decode(toCodecValue(value));
+}
+export function deletionValue() {
+    return ProtoValue.create({
+        kind: { $case: "nullValue", value: NullValue.NULL_VALUE },
+    });
+}
+export class ValueHydrator {
+    service;
+    blobCache;
+    constructor(service, blobCache) {
+        this.service = service;
+        this.blobCache = blobCache;
+    }
+    async hydrate(value) {
+        if (value?.kind === undefined) {
+            throw new TypeError("Value has no concrete kind");
+        }
+        const blobId = blobIdOf(value);
+        if (blobId === undefined) {
+            return value;
+        }
+        const cached = this.blobCache.get(blobId);
+        if (cached !== undefined) {
+            return ProtoValue.decode(cached);
+        }
+        const response = await unary((callback) => this.service.loadBlobs({ values: [value] }, callback));
+        const hydrated = response.values[blobId];
+        if (hydrated?.kind === undefined || blobIdOf(hydrated) !== undefined) {
+            throw new TypeError(`Dex did not hydrate blob ${blobId}`);
+        }
+        this.blobCache.put(blobId, ProtoValue.encode(hydrated).finish());
+        return hydrated;
+    }
+    async hydrateAll(values) {
+        const hydrated = new Array(values.length);
+        const missing = new Map();
+        for (let index = 0; index < values.length; index += 1) {
+            const value = values[index];
+            if (value?.kind === undefined) {
+                throw new TypeError("Value has no concrete kind");
+            }
+            const blobId = blobIdOf(value);
+            if (blobId === undefined) {
+                hydrated[index] = value;
+                continue;
+            }
+            const cached = this.blobCache.get(blobId);
+            if (cached !== undefined) {
+                hydrated[index] = ProtoValue.decode(cached);
+                continue;
+            }
+            const pending = missing.get(blobId);
+            if (pending === undefined) {
+                missing.set(blobId, { value, indexes: [index] });
+            }
+            else {
+                pending.indexes.push(index);
+            }
+        }
+        if (missing.size > 0) {
+            const response = await unary((callback) => this.service.loadBlobs({ values: [...missing.values()].map((pending) => pending.value) }, callback));
+            for (const [blobId, pending] of missing) {
+                const value = response.values[blobId];
+                if (value?.kind === undefined || blobIdOf(value) !== undefined) {
+                    throw new TypeError(`Dex did not hydrate blob ${blobId}`);
+                }
+                this.blobCache.put(blobId, ProtoValue.encode(value).finish());
+                for (const index of pending.indexes) {
+                    hydrated[index] = value;
+                }
+            }
+        }
+        return hydrated.map((value) => {
+            if (value === undefined) {
+                throw new TypeError("Value hydration left an unresolved entry");
+            }
+            return value;
+        });
+    }
+}
+function objectValue(encoding, payload) {
+    return ProtoValue.create({
+        kind: { $case: "objValue", value: { encoding, payload } },
+    });
+}
+function toCodecValue(value) {
+    const kind = value.kind;
+    if (kind === undefined) {
+        throw new TypeError("Value has no concrete kind");
+    }
+    switch (kind.$case) {
+        case "stringValue":
+            return { kind: "string", data: kind.value };
+        case "boolValue":
+            return { kind: "bool", data: kind.value };
+        case "intValue":
+            return { kind: "int64", data: kind.value };
+        case "doubleValue":
+            return { kind: "double", data: kind.value };
+        case "objValue":
+            if (kind.value.encoding === "rawbytes") {
+                return { kind: "bytes", data: kind.value.payload };
+            }
+            if (kind.value.encoding === "json") {
+                return { kind: "json", data: textDecoder.decode(kind.value.payload) };
+            }
+            throw new TypeError(`unsupported object encoding ${kind.value.encoding}`);
+        case "internalBlobIdForStringValue":
+        case "internalBlobIdForObjValue":
+            throw new TypeError("blob-backed Value was not hydrated");
+        case "nullValue":
+            throw new TypeError("attribute deletion marker cannot be decoded");
+    }
+}
+function blobIdOf(value) {
+    if (value.kind?.$case === "internalBlobIdForStringValue" ||
+        value.kind?.$case === "internalBlobIdForObjValue") {
+        return value.kind.value;
+    }
+    return undefined;
+}
+function unary(invoke) {
+    return new Promise((resolve, reject) => {
+        invoke((error, response) => {
+            if (error !== null) {
+                reject(error);
+                return;
+            }
+            resolve(response);
+        });
+    });
+}
+//# sourceMappingURL=value-mapper.js.map

package/dist/src/value-mapper.js.map

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

package/dist/src/wait.d.ts

@@ -0,0 +1,57 @@
+import type { Codec } from "./codec.js";
+import type { Context } from "./context.js";
+export interface Condition {
+    readonly kind: "timer" | "channel";
+    readonly conditionId?: string;
+    readonly durationMs?: number;
+    readonly channelName?: string;
+    readonly instance?: string;
+    readonly atLeast?: number;
+    readonly atMost?: number;
+}
+export interface ConditionCombination {
+    readonly conditions: readonly Condition[];
+}
+export declare const ConditionCombination: Readonly<{
+    of(...conditions: readonly Condition[]): ConditionCombination;
+}>;
+export declare const Timer: Readonly<{
+    byDuration(durationMs: number, conditionId?: string): Condition;
+}>;
+export declare class Channel<T> {
+    readonly name: string;
+    readonly codec: Codec<T>;
+    constructor(name: string, codec: Codec<T>);
+    publish(context: Context, value: T): void;
+    size(context: Context): number;
+    results(context: Context): readonly T[];
+    forOne(conditionId?: string): Condition;
+    forN(count: number, conditionId?: string): Condition;
+    atLeast(count: number, conditionId?: string): Condition;
+    atMost(count: number, conditionId?: string): Condition;
+    range(atLeast?: number, atMost?: number, conditionId?: string): Condition;
+}
+export declare class ChannelMap<T> {
+    readonly name: string;
+    readonly codec: Codec<T>;
+    constructor(name: string, codec: Codec<T>);
+    publish(context: Context, instance: string, value: T): void;
+    size(context: Context, instance: string): number;
+    results(context: Context, instance: string): readonly T[];
+    forOne(instance: string, conditionId?: string): Condition;
+    forN(instance: string, count: number, conditionId?: string): Condition;
+    atLeast(instance: string, count: number, conditionId?: string): Condition;
+    atMost(instance: string, count: number, conditionId?: string): Condition;
+    range(instance: string, atLeast?: number, atMost?: number, conditionId?: string): Condition;
+}
+export type Wait = Readonly<{
+    kind: "skipImmediately" | "allOf" | "anyOf" | "anyCombinationOf";
+    conditions: readonly Condition[];
+    combinations: readonly ConditionCombination[];
+}>;
+export declare const Wait: Readonly<{
+    skipImmediately(): Wait;
+    allOf(...conditions: readonly Condition[]): Wait;
+    anyOf(...conditions: readonly Condition[]): Wait;
+    anyCombinationOf(...combinations: readonly ConditionCombination[]): Wait;
+}>;