@voyant-travel/workflows 0.107.10

package/dist/types.d.ts

@@ -0,0 +1,63 @@
+export type Duration = number | `${number}${"ms" | "s" | "m" | "h" | "d" | "w"}`;
+/**
+ * Cloudflare Container instance types — the set Voyant Cloud honors
+ * for `runtime: "node"` steps. Match the sizes published at
+ * https://developers.cloudflare.com/containers/ (as of
+ * compat-date 2026-04-01).
+ *
+ * | name        | vCPU  | memory  | disk  |
+ * | ----------- | ----- | ------- | ----- |
+ * | lite        | 1/16  | 256 MiB | 2 GB  |
+ * | basic       | 1/4   | 1 GiB   | 4 GB  |
+ * | standard-1  | 1/2   | 4 GiB   | 8 GB  |
+ * | standard-2  | 1     | 6 GiB   | 12 GB |
+ * | standard-3  | 2     | 8 GiB   | 16 GB |
+ * | standard-4  | 4     | 12 GiB  | 20 GB |
+ *
+ * The open `(string & {})` escape hatch accepts CF custom instance
+ * types (up to 4 vCPU / 12 GiB / 20 GB, min 3 GiB RAM per vCPU) —
+ * rendered as `"custom-<vcpu>-<ramGiB>"` by convention.
+ */
+export type MachineType = "lite" | "basic" | "standard-1" | "standard-2" | "standard-3" | "standard-4" | (string & {});
+export type EnvironmentName = "production" | "preview" | "development";
+export type RunStatus = "pending" | "queued" | "running" | "waiting" | "completed" | "failed" | "cancelled" | "cancelled_by_dev_reload" | "cancelled_by_version_sunset" | "compensated" | "compensation_failed" | "timed_out";
+export type ExecutionStatus = "CREATED" | "QUEUED" | "EXECUTING" | "EXECUTING_WITH_WAITPOINTS" | "SUSPENDED" | "PENDING_CANCEL" | "FINISHED";
+export type WaitpointKind = "DATETIME" | "EVENT" | "SIGNAL" | "RUN" | "MANUAL";
+export interface RetryPolicy {
+    max?: number;
+    backoff?: "exponential" | "linear" | "fixed";
+    initial?: Duration;
+    maxDelay?: Duration;
+}
+export interface RateLimitSpec {
+    key: string | ((input: unknown, ctx: {
+        run: {
+            id: string;
+        };
+        project: {
+            id: string;
+        };
+    }) => string);
+    limit: number | ((input: unknown) => number);
+    units?: number | ((input: unknown) => number);
+    window: Duration;
+    onLimit?: "queue" | "fail";
+}
+export type RunTrigger = {
+    kind: "api";
+    actor?: string;
+    accessTokenId?: string;
+} | {
+    kind: "schedule";
+    scheduleId: string;
+} | {
+    kind: "event";
+    eventId: string;
+    eventType: string;
+    filterId: string;
+} | {
+    kind: "parent";
+    parentRunId: string;
+    parentStepId: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,GAAG,MAAM,GAAG,IAAI,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,EAAE,CAAA;AAEhF;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,WAAW,GACnB,MAAM,GACN,OAAO,GACP,YAAY,GACZ,YAAY,GACZ,YAAY,GACZ,YAAY,GACZ,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;AAEjB,MAAM,MAAM,eAAe,GAAG,YAAY,GAAG,SAAS,GAAG,aAAa,CAAA;AAEtE,MAAM,MAAM,SAAS,GACjB,SAAS,GACT,QAAQ,GACR,SAAS,GACT,SAAS,GACT,WAAW,GACX,QAAQ,GACR,WAAW,GACX,yBAAyB,GACzB,6BAA6B,GAC7B,aAAa,GACb,qBAAqB,GACrB,WAAW,CAAA;AAEf,MAAM,MAAM,eAAe,GACvB,SAAS,GACT,QAAQ,GACR,WAAW,GACX,2BAA2B,GAC3B,WAAW,GACX,gBAAgB,GAChB,UAAU,CAAA;AAEd,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,GAAG,QAAQ,CAAA;AAE9E,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,aAAa,GAAG,QAAQ,GAAG,OAAO,CAAA;IAC5C,OAAO,CAAC,EAAE,QAAQ,CAAA;IAClB,QAAQ,CAAC,EAAE,QAAQ,CAAA;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE;QAAE,GAAG,EAAE;YAAE,EAAE,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,OAAO,EAAE;YAAE,EAAE,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,KAAK,MAAM,CAAC,CAAA;IACjG,KAAK,EAAE,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAAC,CAAA;IAC5C,KAAK,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAAC,CAAA;IAC7C,MAAM,EAAE,QAAQ,CAAA;IAChB,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;CAC3B;AAED,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GACvD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACvE;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAA"}

package/dist/types.js

@@ -0,0 +1,3 @@
+// Core type aliases used across the SDK.
+// Authoritative definitions in docs/sdk-surface.md §0 and §2.
+export {};

package/dist/workflow.d.ts

@@ -0,0 +1,222 @@
+import type { Condition } from "./conditions.js";
+import type { ServiceResolver } from "./driver.js";
+import type { Duration, EnvironmentName, MachineType, RateLimitSpec, RetryPolicy, RunStatus, RunTrigger } from "./types.js";
+export interface WorkflowHandle<TInput = unknown, TOutput = unknown> {
+    readonly id: string;
+    /** Phantom; used only for TypeScript inference of `workflows.trigger(...)`. */
+    readonly __input?: TInput;
+    readonly __output?: TOutput;
+}
+export interface WorkflowConfig<TInput, TOutput> {
+    id: string;
+    input?: unknown;
+    output?: unknown;
+    description?: string;
+    schedule?: ScheduleDeclaration | ScheduleDeclaration[];
+    concurrency?: ConcurrencyPolicy<TInput>;
+    retry?: RetryPolicy;
+    timeout?: Duration;
+    defaultRuntime?: "edge" | "node";
+    tags?: string[];
+    run: (input: TInput, ctx: WorkflowContext<TInput>) => Promise<TOutput>;
+}
+/**
+ * Internal registered form of a workflow. The executor takes this
+ * plus a request and drives the body.
+ */
+export interface WorkflowDefinition<TInput = unknown, TOutput = unknown> extends WorkflowHandle<TInput, TOutput> {
+    readonly config: WorkflowConfig<TInput, TOutput>;
+}
+export type ScheduleDeclaration = ({
+    cron: string;
+} | {
+    every: Duration;
+} | {
+    at: string | Date;
+}) & {
+    timezone?: string;
+    input?: unknown | (() => unknown | Promise<unknown>);
+    enabled?: boolean;
+    overlap?: "skip" | "queue" | "allow";
+    environments?: EnvironmentName[];
+    name?: string;
+};
+export interface ConcurrencyPolicy<TInput> {
+    key?: string | ((input: TInput) => string);
+    limit?: number;
+    strategy?: "queue" | "cancel-in-progress" | "cancel-newest" | "round-robin";
+}
+/** Declare a workflow. See docs/sdk-surface.md §2.1. */
+export declare function workflow<TInput = unknown, TOutput = unknown>(config: WorkflowConfig<TInput, TOutput>): WorkflowDefinition<TInput, TOutput>;
+/** Internal: look up a registered workflow by id. */
+export declare function getWorkflow(id: string): WorkflowDefinition | undefined;
+/**
+ * Internal: enumerate every registered workflow. Used by the CLI to list
+ * workflows discovered from a loaded entry file. Not part of the stable
+ * public API — implementation detail of the SDK/CLI pair.
+ */
+export declare function __listRegisteredWorkflows(): WorkflowDefinition[];
+/**
+ * Internal: clear the workflow registry. Called by the CLI between
+ * builds / hot-reloads to drop stale workflows before re-importing
+ * the tenant bundle, and by test suites in beforeEach to isolate
+ * runs. Not part of the stable public API.
+ */
+export declare function __resetRegistry(): void;
+export interface RunContext {
+    id: string;
+    number: number;
+    attempt: number;
+    triggeredBy: RunTrigger;
+    tags: readonly string[];
+    startedAt: number;
+}
+export interface EnvironmentContext {
+    name: EnvironmentName;
+    git?: {
+        commit: string;
+        branch: string;
+        pr?: {
+            number: number;
+            url: string;
+        };
+    };
+}
+export interface WorkflowContext<_TInput = unknown> {
+    readonly run: RunContext;
+    readonly workflow: {
+        id: string;
+        version: string;
+    };
+    readonly environment: EnvironmentContext;
+    readonly project: {
+        id: string;
+        slug: string;
+    };
+    readonly organization: {
+        id: string;
+        slug: string;
+    };
+    readonly invocationCount: number;
+    readonly signal: AbortSignal;
+    /**
+     * Read-only view of the framework's service container. Step bodies resolve
+     * shared services (db, indexer, etc.) via `ctx.services.resolve("name")`.
+     * The framework wires this from `createApp()`'s `ModuleContainer` through
+     * `StepHandlerDeps.services`. When no container is plumbed (driver not
+     * configured with `services`, or in raw orchestrator tests), `resolve(...)`
+     * throws with a clear message and `has(...)` returns `false`.
+     */
+    readonly services: ServiceResolver;
+    step: StepApi;
+    sleep: (duration: Duration) => Promise<void>;
+    waitForEvent: WaitForEventApi;
+    waitForSignal: WaitForSignalApi;
+    waitForToken: WaitForTokenApi;
+    invoke: InvokeApi;
+    parallel: ParallelApi;
+    stream: StreamApi;
+    group: GroupApi;
+    compensate: () => Promise<never>;
+    metadata: MetadataApi;
+    now: () => number;
+    random: () => number;
+    randomUUID: () => string;
+    setRetry: (policy: RetryPolicy) => void;
+}
+export interface StepApi {
+    <T>(id: string, fn: StepFn<T>): Promise<T>;
+    <T>(id: string, opts: StepOptions<T>, fn: StepFn<T>): Promise<T>;
+}
+export type StepFn<T> = (stepCtx: StepContext) => Promise<T>;
+export interface StepContext {
+    signal: AbortSignal;
+    attempt: number;
+    log: (level: "info" | "warn" | "error", msg: string, data?: object) => void;
+}
+export interface StepOptions<T = unknown> {
+    runtime?: "edge" | "node";
+    machine?: MachineType;
+    timeout?: Duration;
+    retry?: RetryPolicy | {
+        max: 0;
+    };
+    idempotencyKey?: string;
+    compensate?: (output: T) => Promise<void>;
+    rateLimit?: RateLimitSpec;
+    waitFor?: Condition;
+    cancelIf?: Condition;
+    skipIf?: Condition;
+}
+export interface Waitable<T> extends PromiseLike<T | null> {
+    [Symbol.asyncIterator](): AsyncIterableIterator<T>;
+    close(): void;
+}
+export type WaitForEventApi = <T = unknown>(eventType: string, opts?: WaitForEventOptions<T>) => Waitable<T>;
+export interface WaitForEventOptions<T> {
+    match?: Partial<T> | ((payload: T) => boolean);
+    timeout?: Duration;
+    lookback?: Duration;
+    bufferSize?: number;
+    onTimeout?: "null" | "throw";
+}
+export type WaitForSignalApi = <T = unknown>(name: string, opts?: WaitForSignalOptions<T>) => Waitable<T>;
+export interface WaitForSignalOptions<T> extends WaitForEventOptions<T> {
+}
+export type WaitForTokenApi = <T = unknown>(opts?: WaitForTokenOptions<T>) => Promise<TokenWait<T>>;
+export interface WaitForTokenOptions<_T> {
+    tokenId?: string;
+    timeout?: Duration;
+    onTimeout?: "null" | "throw";
+    schema?: unknown;
+}
+export interface TokenWait<T> {
+    tokenId: string;
+    url: string;
+    wait: () => Promise<T | null>;
+}
+export type InvokeApi = <TIn, TOut>(workflow: WorkflowHandle<TIn, TOut>, input: TIn, opts?: InvokeOptions) => Promise<TOut>;
+export interface InvokeOptions {
+    idempotencyKey?: string;
+    tags?: string[];
+    lockToVersion?: string;
+    /**
+     * Fire-and-forget child run. The child is still triggered and
+     * persisted, but the parent does not wait for its output or error.
+     * The awaited result resolves to `undefined`; callers should not use
+     * detached invokes for control flow.
+     */
+    detach?: boolean;
+}
+export type ParallelApi = <T, R>(items: readonly T[], fn: (item: T, index: number) => Promise<R>, opts?: ParallelOptions) => Promise<R[]>;
+export interface ParallelOptions {
+    concurrency?: number;
+    settle?: boolean;
+}
+export interface StreamApi {
+    text(streamId: string, source: AsyncIterable<string>): Promise<void>;
+    json<T>(streamId: string, source: AsyncIterable<T>): Promise<void>;
+    bytes(streamId: string, source: AsyncIterable<Uint8Array>): Promise<void>;
+    <T>(streamId: string, fn: () => AsyncGenerator<T>): Promise<void>;
+}
+export type GroupApi = <T>(name: string, fn: (scope: GroupScope) => Promise<T>) => Promise<T>;
+export interface GroupScope {
+    step: StepApi;
+    compensate: () => Promise<never>;
+}
+export type MetadataValue = string | number | boolean | null | MetadataValue[] | {
+    [key: string]: MetadataValue;
+};
+export interface MetadataMutatorSubset {
+    set(key: string, value: MetadataValue): void;
+    increment(key: string, by?: number): void;
+    append<T>(key: string, value: T): void;
+    remove(key: string): void;
+}
+export interface MetadataApi extends MetadataMutatorSubset {
+    flush(): Promise<void>;
+    parent?: MetadataMutatorSubset;
+    root?: MetadataMutatorSubset;
+}
+export type { RunStatus };
+//# sourceMappingURL=workflow.d.ts.map

package/dist/workflow.d.ts.map

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

package/dist/workflow.js

@@ -0,0 +1,55 @@
+// Workflow declaration and the `ctx` object.
+// Authoritative contract in docs/sdk-surface.md §2–§3.
+/**
+ * Process-local registry. Backed by globalThis so bundles that inline
+ * their own copy of @voyant-travel/workflows still share the registry with
+ * the loader's copy (voyant build relies on this to extract the
+ * manifest from a user bundle at load-time). Module-local `const`
+ * would create a private map per bundle copy.
+ */
+const REGISTRY_KEY = "__voyantWorkflowRegistry";
+const globalRef = globalThis;
+const REGISTRY = globalRef[REGISTRY_KEY] ?? new Map();
+globalRef[REGISTRY_KEY] = REGISTRY;
+/** Declare a workflow. See docs/sdk-surface.md §2.1. */
+export function workflow(config) {
+    // Vite / Cloudflare workerd HMR re-evaluates modules in place, so a
+    // workflow file that registers ids at import-time will be re-imported
+    // on every save. Throwing on duplicate ids would surface real
+    // collisions but also kills the entire dev loop. The CLI's pre-flight
+    // (`voyant workflows build`) is the right place to catch genuine
+    // duplicates across files; here we replace + warn so HMR keeps
+    // working. Production bundles run this once at startup, so the
+    // duplicate path is effectively dev-only.
+    if (REGISTRY.has(config.id)) {
+        console.warn(`[workflows] workflow id "${config.id}" re-registered — assuming HMR re-import. ` +
+            `If this is a real duplicate, \`voyant workflows build\` will reject the bundle.`);
+    }
+    const def = {
+        id: config.id,
+        config,
+    };
+    REGISTRY.set(config.id, def);
+    return def;
+}
+/** Internal: look up a registered workflow by id. */
+export function getWorkflow(id) {
+    return REGISTRY.get(id);
+}
+/**
+ * Internal: enumerate every registered workflow. Used by the CLI to list
+ * workflows discovered from a loaded entry file. Not part of the stable
+ * public API — implementation detail of the SDK/CLI pair.
+ */
+export function __listRegisteredWorkflows() {
+    return [...REGISTRY.values()];
+}
+/**
+ * Internal: clear the workflow registry. Called by the CLI between
+ * builds / hot-reloads to drop stale workflows before re-importing
+ * the tenant bundle, and by test suites in beforeEach to isolate
+ * runs. Not part of the stable public API.
+ */
+export function __resetRegistry() {
+    REGISTRY.clear();
+}

package/package.json

@@ -0,0 +1,120 @@
+{
+  "name": "@voyant-travel/workflows",
+  "version": "0.107.10",
+  "description": "Authoring SDK for Voyant Workflows — durable, step-based orchestrations for Voyant Cloud.",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/voyant-travel/voyant.git",
+    "directory": "packages/workflows"
+  },
+  "homepage": "https://voyant.cloud/workflows",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./testing": {
+      "types": "./dist/testing/index.d.ts",
+      "import": "./dist/testing/index.js",
+      "default": "./dist/testing/index.js"
+    },
+    "./protocol": {
+      "types": "./dist/protocol/index.d.ts",
+      "import": "./dist/protocol/index.js",
+      "default": "./dist/protocol/index.js"
+    },
+    "./handler": {
+      "types": "./dist/handler/index.d.ts",
+      "import": "./dist/handler/index.js",
+      "default": "./dist/handler/index.js"
+    },
+    "./auth": {
+      "types": "./dist/auth/index.d.ts",
+      "import": "./dist/auth/index.js",
+      "default": "./dist/auth/index.js"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "import": "./dist/client.js",
+      "default": "./dist/client.js"
+    },
+    "./bindings": {
+      "types": "./dist/bindings.d.ts",
+      "import": "./dist/bindings.js",
+      "default": "./dist/bindings.js"
+    },
+    "./config": {
+      "types": "./dist/config.d.ts",
+      "import": "./dist/config.js",
+      "default": "./dist/config.js"
+    },
+    "./errors": {
+      "types": "./dist/errors.d.ts",
+      "import": "./dist/errors.js",
+      "default": "./dist/errors.js"
+    },
+    "./rate-limit": {
+      "types": "./dist/rate-limit/index.d.ts",
+      "import": "./dist/rate-limit/index.js",
+      "default": "./dist/rate-limit/index.js"
+    },
+    "./driver": {
+      "types": "./dist/driver.d.ts",
+      "import": "./dist/driver.js",
+      "default": "./dist/driver.js"
+    },
+    "./events": {
+      "types": "./dist/events/index.d.ts",
+      "import": "./dist/events/index.js",
+      "default": "./dist/events/index.js"
+    },
+    "./http-ingest": {
+      "types": "./dist/http-ingest.d.ts",
+      "import": "./dist/http-ingest.js",
+      "default": "./dist/http-ingest.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "src",
+    "!**/*.test.*",
+    "!**/*.spec.*",
+    "NOTICE"
+  ],
+  "dependencies": {
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^20.12.0",
+    "esbuild": "0.28.1",
+    "typescript": "^5.9.2",
+    "vitest": "^3.2.6",
+    "@voyant-travel/voyant-typescript-config": "^0.1.0"
+  },
+  "peerDependencies": {
+    "zod": "^3.23.0 || ^4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "zod": {
+      "optional": true
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "build:examples": "tsc -p tsconfig.examples.json",
+    "spike": "pnpm build && pnpm build:examples && node examples-dist/drive.js",
+    "check-types": "tsc --noEmit",
+    "dev": "tsc -w -p tsconfig.json",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "test:watch": "vitest"
+  }
+}