@rytejs/core 0.5.0 → 0.7.0

package/dist/reactor/index.cjs

@@ -0,0 +1,69 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/reactor/index.ts
+var reactor_exports = {};
+__export(reactor_exports, {
+  Reactors: () => Reactors,
+  createReactors: () => createReactors
+});
+module.exports = __toCommonJS(reactor_exports);
+
+// src/reactor/reactors.ts
+var Reactors = class {
+  registrations = [];
+  on(router, event, handler) {
+    this.registrations.push({
+      definitionName: router.definition.name,
+      eventType: event,
+      handler
+    });
+    return this;
+  }
+  resolve(router, workflowId, events) {
+    const definitionName = router.definition.name;
+    const commands = [];
+    for (const event of events) {
+      for (const reg of this.registrations) {
+        if (reg.definitionName !== definitionName) continue;
+        if (reg.eventType !== event.type) continue;
+        const result = reg.handler({
+          event: { type: event.type, data: event.data },
+          workflowId
+        });
+        if (result === null) continue;
+        if (Array.isArray(result)) {
+          commands.push(...result);
+        } else {
+          commands.push(result);
+        }
+      }
+    }
+    return commands;
+  }
+};
+function createReactors() {
+  return new Reactors();
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Reactors,
+  createReactors
+});
+//# sourceMappingURL=index.cjs.map

package/dist/reactor/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/reactor/index.ts","../../src/reactor/reactors.ts"],"sourcesContent":["export { createReactors, Reactors } from \"./reactors.js\";\nexport type { ReactorCommand, ReactorContext } from \"./types.js\";\n","import type { WorkflowRouter } from \"../router.js\";\nimport type { EventNames, WorkflowConfig } from \"../types.js\";\nimport type { ReactorCommand, ReactorContext } from \"./types.js\";\n\ntype AnyHandler = (ctx: {\n\t// biome-ignore lint/suspicious/noExplicitAny: internal type erasure for heterogeneous handler storage\n\tevent: { type: string; data: any };\n\tworkflowId: string;\n}) => ReactorCommand | ReactorCommand[] | null;\n\ninterface Registration {\n\tdefinitionName: string;\n\teventType: string;\n\thandler: AnyHandler;\n}\n\nexport class Reactors {\n\tprivate readonly registrations: Registration[] = [];\n\n\ton<TConfig extends WorkflowConfig, TEvent extends EventNames<TConfig>>(\n\t\trouter: WorkflowRouter<TConfig>,\n\t\tevent: TEvent,\n\t\thandler: (ctx: ReactorContext<TConfig, TEvent>) => ReactorCommand | ReactorCommand[] | null,\n\t): this {\n\t\tthis.registrations.push({\n\t\t\tdefinitionName: router.definition.name,\n\t\t\teventType: event as string,\n\t\t\thandler: handler as AnyHandler,\n\t\t});\n\t\treturn this;\n\t}\n\n\tresolve(\n\t\t// biome-ignore lint/suspicious/noExplicitAny: accepts any router for type-erased resolution\n\t\trouter: WorkflowRouter<any>,\n\t\tworkflowId: string,\n\t\tevents: Array<{ type: string; data: unknown }>,\n\t): ReactorCommand[] {\n\t\tconst definitionName = router.definition.name;\n\t\tconst commands: ReactorCommand[] = [];\n\n\t\tfor (const event of events) {\n\t\t\tfor (const reg of this.registrations) {\n\t\t\t\tif (reg.definitionName !== definitionName) continue;\n\t\t\t\tif (reg.eventType !== event.type) continue;\n\n\t\t\t\tconst result = reg.handler({\n\t\t\t\t\tevent: { type: event.type, data: event.data },\n\t\t\t\t\tworkflowId,\n\t\t\t\t});\n\n\t\t\t\tif (result === null) continue;\n\t\t\t\tif (Array.isArray(result)) {\n\t\t\t\t\tcommands.push(...result);\n\t\t\t\t} else {\n\t\t\t\t\tcommands.push(result);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\treturn commands;\n\t}\n}\n\nexport function createReactors(): Reactors {\n\treturn new Reactors();\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACgBO,IAAM,WAAN,MAAe;AAAA,EACJ,gBAAgC,CAAC;AAAA,EAElD,GACC,QACA,OACA,SACO;AACP,SAAK,cAAc,KAAK;AAAA,MACvB,gBAAgB,OAAO,WAAW;AAAA,MAClC,WAAW;AAAA,MACX;AAAA,IACD,CAAC;AACD,WAAO;AAAA,EACR;AAAA,EAEA,QAEC,QACA,YACA,QACmB;AACnB,UAAM,iBAAiB,OAAO,WAAW;AACzC,UAAM,WAA6B,CAAC;AAEpC,eAAW,SAAS,QAAQ;AAC3B,iBAAW,OAAO,KAAK,eAAe;AACrC,YAAI,IAAI,mBAAmB,eAAgB;AAC3C,YAAI,IAAI,cAAc,MAAM,KAAM;AAElC,cAAM,SAAS,IAAI,QAAQ;AAAA,UAC1B,OAAO,EAAE,MAAM,MAAM,MAAM,MAAM,MAAM,KAAK;AAAA,UAC5C;AAAA,QACD,CAAC;AAED,YAAI,WAAW,KAAM;AACrB,YAAI,MAAM,QAAQ,MAAM,GAAG;AAC1B,mBAAS,KAAK,GAAG,MAAM;AAAA,QACxB,OAAO;AACN,mBAAS,KAAK,MAAM;AAAA,QACrB;AAAA,MACD;AAAA,IACD;AAEA,WAAO;AAAA,EACR;AACD;AAEO,SAAS,iBAA2B;AAC1C,SAAO,IAAI,SAAS;AACrB;","names":[]}

package/dist/reactor/index.d.cts

@@ -0,0 +1,31 @@
+import { c as WorkflowRouter } from '../plugin-DHS8yUmS.cjs';
+import { W as WorkflowConfig, g as EventNames, f as EventData } from '../snapshot-D5iZubCz.cjs';
+import 'zod';
+
+interface ReactorCommand {
+    workflowId: string;
+    routerName: string;
+    command: {
+        type: string;
+        payload: unknown;
+    };
+}
+interface ReactorContext<TConfig extends WorkflowConfig, TEvent extends EventNames<TConfig>> {
+    event: {
+        type: TEvent;
+        data: EventData<TConfig, TEvent>;
+    };
+    workflowId: string;
+}
+
+declare class Reactors {
+    private readonly registrations;
+    on<TConfig extends WorkflowConfig, TEvent extends EventNames<TConfig>>(router: WorkflowRouter<TConfig>, event: TEvent, handler: (ctx: ReactorContext<TConfig, TEvent>) => ReactorCommand | ReactorCommand[] | null): this;
+    resolve(router: WorkflowRouter<any>, workflowId: string, events: Array<{
+        type: string;
+        data: unknown;
+    }>): ReactorCommand[];
+}
+declare function createReactors(): Reactors;
+
+export { type ReactorCommand, type ReactorContext, Reactors, createReactors };

package/dist/reactor/index.d.ts

@@ -0,0 +1,31 @@
+import { c as WorkflowRouter } from '../plugin-DHN3Pk52.js';
+import { W as WorkflowConfig, g as EventNames, f as EventData } from '../snapshot-D5iZubCz.js';
+import 'zod';
+
+interface ReactorCommand {
+    workflowId: string;
+    routerName: string;
+    command: {
+        type: string;
+        payload: unknown;
+    };
+}
+interface ReactorContext<TConfig extends WorkflowConfig, TEvent extends EventNames<TConfig>> {
+    event: {
+        type: TEvent;
+        data: EventData<TConfig, TEvent>;
+    };
+    workflowId: string;
+}
+
+declare class Reactors {
+    private readonly registrations;
+    on<TConfig extends WorkflowConfig, TEvent extends EventNames<TConfig>>(router: WorkflowRouter<TConfig>, event: TEvent, handler: (ctx: ReactorContext<TConfig, TEvent>) => ReactorCommand | ReactorCommand[] | null): this;
+    resolve(router: WorkflowRouter<any>, workflowId: string, events: Array<{
+        type: string;
+        data: unknown;
+    }>): ReactorCommand[];
+}
+declare function createReactors(): Reactors;
+
+export { type ReactorCommand, type ReactorContext, Reactors, createReactors };

package/dist/reactor/index.js

@@ -0,0 +1,41 @@
+// src/reactor/reactors.ts
+var Reactors = class {
+  registrations = [];
+  on(router, event, handler) {
+    this.registrations.push({
+      definitionName: router.definition.name,
+      eventType: event,
+      handler
+    });
+    return this;
+  }
+  resolve(router, workflowId, events) {
+    const definitionName = router.definition.name;
+    const commands = [];
+    for (const event of events) {
+      for (const reg of this.registrations) {
+        if (reg.definitionName !== definitionName) continue;
+        if (reg.eventType !== event.type) continue;
+        const result = reg.handler({
+          event: { type: event.type, data: event.data },
+          workflowId
+        });
+        if (result === null) continue;
+        if (Array.isArray(result)) {
+          commands.push(...result);
+        } else {
+          commands.push(result);
+        }
+      }
+    }
+    return commands;
+  }
+};
+function createReactors() {
+  return new Reactors();
+}
+export {
+  Reactors,
+  createReactors
+};
+//# sourceMappingURL=index.js.map

package/dist/reactor/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/reactor/reactors.ts"],"sourcesContent":["import type { WorkflowRouter } from \"../router.js\";\nimport type { EventNames, WorkflowConfig } from \"../types.js\";\nimport type { ReactorCommand, ReactorContext } from \"./types.js\";\n\ntype AnyHandler = (ctx: {\n\t// biome-ignore lint/suspicious/noExplicitAny: internal type erasure for heterogeneous handler storage\n\tevent: { type: string; data: any };\n\tworkflowId: string;\n}) => ReactorCommand | ReactorCommand[] | null;\n\ninterface Registration {\n\tdefinitionName: string;\n\teventType: string;\n\thandler: AnyHandler;\n}\n\nexport class Reactors {\n\tprivate readonly registrations: Registration[] = [];\n\n\ton<TConfig extends WorkflowConfig, TEvent extends EventNames<TConfig>>(\n\t\trouter: WorkflowRouter<TConfig>,\n\t\tevent: TEvent,\n\t\thandler: (ctx: ReactorContext<TConfig, TEvent>) => ReactorCommand | ReactorCommand[] | null,\n\t): this {\n\t\tthis.registrations.push({\n\t\t\tdefinitionName: router.definition.name,\n\t\t\teventType: event as string,\n\t\t\thandler: handler as AnyHandler,\n\t\t});\n\t\treturn this;\n\t}\n\n\tresolve(\n\t\t// biome-ignore lint/suspicious/noExplicitAny: accepts any router for type-erased resolution\n\t\trouter: WorkflowRouter<any>,\n\t\tworkflowId: string,\n\t\tevents: Array<{ type: string; data: unknown }>,\n\t): ReactorCommand[] {\n\t\tconst definitionName = router.definition.name;\n\t\tconst commands: ReactorCommand[] = [];\n\n\t\tfor (const event of events) {\n\t\t\tfor (const reg of this.registrations) {\n\t\t\t\tif (reg.definitionName !== definitionName) continue;\n\t\t\t\tif (reg.eventType !== event.type) continue;\n\n\t\t\t\tconst result = reg.handler({\n\t\t\t\t\tevent: { type: event.type, data: event.data },\n\t\t\t\t\tworkflowId,\n\t\t\t\t});\n\n\t\t\t\tif (result === null) continue;\n\t\t\t\tif (Array.isArray(result)) {\n\t\t\t\t\tcommands.push(...result);\n\t\t\t\t} else {\n\t\t\t\t\tcommands.push(result);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\treturn commands;\n\t}\n}\n\nexport function createReactors(): Reactors {\n\treturn new Reactors();\n}\n"],"mappings":";AAgBO,IAAM,WAAN,MAAe;AAAA,EACJ,gBAAgC,CAAC;AAAA,EAElD,GACC,QACA,OACA,SACO;AACP,SAAK,cAAc,KAAK;AAAA,MACvB,gBAAgB,OAAO,WAAW;AAAA,MAClC,WAAW;AAAA,MACX;AAAA,IACD,CAAC;AACD,WAAO;AAAA,EACR;AAAA,EAEA,QAEC,QACA,YACA,QACmB;AACnB,UAAM,iBAAiB,OAAO,WAAW;AACzC,UAAM,WAA6B,CAAC;AAEpC,eAAW,SAAS,QAAQ;AAC3B,iBAAW,OAAO,KAAK,eAAe;AACrC,YAAI,IAAI,mBAAmB,eAAgB;AAC3C,YAAI,IAAI,cAAc,MAAM,KAAM;AAElC,cAAM,SAAS,IAAI,QAAQ;AAAA,UAC1B,OAAO,EAAE,MAAM,MAAM,MAAM,MAAM,MAAM,KAAK;AAAA,UAC5C;AAAA,QACD,CAAC;AAED,YAAI,WAAW,KAAM;AACrB,YAAI,MAAM,QAAQ,MAAM,GAAG;AAC1B,mBAAS,KAAK,GAAG,MAAM;AAAA,QACxB,OAAO;AACN,mBAAS,KAAK,MAAM;AAAA,QACrB;AAAA,MACD;AAAA,IACD;AAEA,WAAO;AAAA,EACR;AACD;AAEO,SAAS,iBAA2B;AAC1C,SAAO,IAAI,SAAS;AACrB;","names":[]}

package/dist/snapshot-D5iZubCz.d.cts

@@ -0,0 +1,165 @@
+import { ZodType, z } from 'zod';
+
+/**
+ * Shape of the configuration object passed to {@link defineWorkflow}.
+ * Exported for internal package use only — not re-exported from index.ts.
+ */
+interface WorkflowConfigInput {
+    /** Optional version number for schema migrations. Defaults to 1. */
+    modelVersion?: number;
+    /** Record of state names to Zod schemas defining their data shape. */
+    states: Record<string, ZodType>;
+    /** Record of command names to Zod schemas defining their payload shape. */
+    commands: Record<string, ZodType>;
+    /** Record of event names to Zod schemas defining their data shape. */
+    events: Record<string, ZodType>;
+    /** Record of error codes to Zod schemas defining their data shape. */
+    errors: Record<string, ZodType>;
+}
+/**
+ * Workflow configuration with pre-resolved types for IDE completion.
+ *
+ * Extends {@link WorkflowConfigInput} with a `_resolved` phantom type that
+ * caches `z.infer` results. This exists because Zod v4's `z.infer` uses
+ * conditional types that TypeScript defers in deep generic chains, breaking
+ * IDE autocomplete. The `_resolved` property is never set at runtime — it is
+ * populated at the type level by {@link defineWorkflow}'s return type.
+ */
+interface WorkflowConfig extends WorkflowConfigInput {
+    _resolved: {
+        states: Record<string, unknown>;
+        commands: Record<string, unknown>;
+        events: Record<string, unknown>;
+        errors: Record<string, unknown>;
+    };
+}
+type StateNames<T extends WorkflowConfig> = keyof T["states"] & string;
+type CommandNames<T extends WorkflowConfig> = keyof T["commands"] & string;
+type EventNames<T extends WorkflowConfig> = keyof T["events"] & string;
+type ErrorCodes<T extends WorkflowConfig> = keyof T["errors"] & string;
+/** Forces TypeScript to flatten a type for better IDE autocomplete. */
+type Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+/** Resolves the data type for a given state from pre-computed types. */
+type StateData<T extends WorkflowConfig, S extends StateNames<T>> = Prettify<T["_resolved"]["states"][S]>;
+/** Resolves the payload type for a given command from pre-computed types. */
+type CommandPayload<T extends WorkflowConfig, C extends CommandNames<T>> = Prettify<T["_resolved"]["commands"][C]>;
+/** Resolves the data type for a given event from pre-computed types. */
+type EventData<T extends WorkflowConfig, E extends EventNames<T>> = Prettify<T["_resolved"]["events"][E]>;
+/** Resolves the data type for a given error code from pre-computed types. */
+type ErrorData<T extends WorkflowConfig, C extends ErrorCodes<T>> = Prettify<T["_resolved"]["errors"][C]>;
+/** Workflow narrowed to a specific known state. */
+interface WorkflowOf<TConfig extends WorkflowConfig, S extends StateNames<TConfig>> {
+    /** Unique workflow instance identifier. */
+    readonly id: string;
+    /** Name of the workflow definition this instance belongs to. */
+    readonly definitionName: string;
+    /** Current state name. */
+    readonly state: S;
+    /** State data, typed according to the state's Zod schema. */
+    readonly data: StateData<TConfig, S>;
+    /** Timestamp of workflow creation. */
+    readonly createdAt: Date;
+    /** Timestamp of last state change. */
+    readonly updatedAt: Date;
+}
+/** Discriminated union of all possible workflow states — checking .state narrows .data. */
+type Workflow<TConfig extends WorkflowConfig = WorkflowConfig> = {
+    [S in StateNames<TConfig>]: WorkflowOf<TConfig, S>;
+}[StateNames<TConfig>];
+/** Discriminated union of all pipeline error types on `category`. */
+type PipelineError<TConfig extends WorkflowConfig = WorkflowConfig> = {
+    category: "validation";
+    source: "command" | "state" | "event" | "transition" | "restore";
+    issues: z.core.$ZodIssue[];
+    message: string;
+} | {
+    category: "domain";
+    code: ErrorCodes<TConfig>;
+    data: ErrorData<TConfig, ErrorCodes<TConfig>>;
+} | {
+    category: "router";
+    code: "NO_HANDLER" | "UNKNOWN_STATE";
+    message: string;
+} | {
+    category: "unexpected";
+    error: unknown;
+    message: string;
+} | {
+    category: "dependency";
+    name: string;
+    error: unknown;
+    message: string;
+};
+/** Return type of {@link WorkflowRouter.dispatch}. Discriminated union on `ok`. */
+type DispatchResult<TConfig extends WorkflowConfig = WorkflowConfig> = {
+    ok: true;
+    workflow: Workflow<TConfig>;
+    events: Array<{
+        type: EventNames<TConfig>;
+        data: unknown;
+    }>;
+} | {
+    ok: false;
+    error: PipelineError<TConfig>;
+};
+/**
+ * Thrown internally when Zod validation fails during dispatch.
+ * Caught by the router and returned as a validation error in {@link DispatchResult}.
+ *
+ * @param source - Which validation stage failed
+ * @param issues - Array of Zod validation issues
+ */
+declare class ValidationError extends Error {
+    readonly source: "command" | "state" | "event" | "transition" | "restore";
+    readonly issues: z.core.$ZodIssue[];
+    constructor(source: "command" | "state" | "event" | "transition" | "restore", issues: z.core.$ZodIssue[]);
+}
+/**
+ * Thrown internally when a handler calls `ctx.error()`.
+ * Caught by the router and returned as a domain error in {@link DispatchResult}.
+ *
+ * @param code - The error code string
+ * @param data - The error data payload
+ */
+declare class DomainErrorSignal extends Error {
+    readonly code: string;
+    readonly data: unknown;
+    constructor(code: string, data: unknown);
+}
+/**
+ * Thrown internally when a proxied dependency call fails.
+ * Caught by the router and returned as a dependency error in {@link DispatchResult}.
+ *
+ * @param depName - The top-level dependency key (e.g. "db", "stripe")
+ * @param error - The original error thrown by the dependency
+ */
+/** Extracts the WorkflowConfig type from a WorkflowRouter instance. */
+type ConfigOf<R> = R extends {
+    definition: {
+        config: infer C;
+    };
+} ? C : never;
+
+/** A plain, JSON-safe representation of a workflow's state for serialization and storage. */
+interface WorkflowSnapshot<TConfig extends WorkflowConfig = WorkflowConfig> {
+    /** Unique workflow instance identifier. */
+    readonly id: string;
+    /** Name of the workflow definition. */
+    readonly definitionName: string;
+    /** Current state name. */
+    readonly state: StateNames<TConfig>;
+    /** State data (untyped — validated on {@link WorkflowDefinition.deserialize}). */
+    readonly data: unknown;
+    /** ISO 8601 timestamp of workflow creation. */
+    readonly createdAt: string;
+    /** ISO 8601 timestamp of last state change. */
+    readonly updatedAt: string;
+    /** Schema version number for migration support. */
+    readonly modelVersion: number;
+    /** Optimistic concurrency version. Starts at 1, increments on each successful save. */
+    readonly version: number;
+}
+
+export { type CommandNames as C, type DispatchResult as D, type ErrorCodes as E, type PipelineError as P, type StateNames as S, ValidationError as V, type WorkflowConfig as W, type WorkflowSnapshot as a, type CommandPayload as b, type ConfigOf as c, DomainErrorSignal as d, type ErrorData as e, type EventData as f, type EventNames as g, type StateData as h, type Workflow as i, type WorkflowOf as j, type WorkflowConfigInput as k };

package/dist/snapshot-D5iZubCz.d.ts

@@ -0,0 +1,165 @@
+import { ZodType, z } from 'zod';
+
+/**
+ * Shape of the configuration object passed to {@link defineWorkflow}.
+ * Exported for internal package use only — not re-exported from index.ts.
+ */
+interface WorkflowConfigInput {
+    /** Optional version number for schema migrations. Defaults to 1. */
+    modelVersion?: number;
+    /** Record of state names to Zod schemas defining their data shape. */
+    states: Record<string, ZodType>;
+    /** Record of command names to Zod schemas defining their payload shape. */
+    commands: Record<string, ZodType>;
+    /** Record of event names to Zod schemas defining their data shape. */
+    events: Record<string, ZodType>;
+    /** Record of error codes to Zod schemas defining their data shape. */
+    errors: Record<string, ZodType>;
+}
+/**
+ * Workflow configuration with pre-resolved types for IDE completion.
+ *
+ * Extends {@link WorkflowConfigInput} with a `_resolved` phantom type that
+ * caches `z.infer` results. This exists because Zod v4's `z.infer` uses
+ * conditional types that TypeScript defers in deep generic chains, breaking
+ * IDE autocomplete. The `_resolved` property is never set at runtime — it is
+ * populated at the type level by {@link defineWorkflow}'s return type.
+ */
+interface WorkflowConfig extends WorkflowConfigInput {
+    _resolved: {
+        states: Record<string, unknown>;
+        commands: Record<string, unknown>;
+        events: Record<string, unknown>;
+        errors: Record<string, unknown>;
+    };
+}
+type StateNames<T extends WorkflowConfig> = keyof T["states"] & string;
+type CommandNames<T extends WorkflowConfig> = keyof T["commands"] & string;
+type EventNames<T extends WorkflowConfig> = keyof T["events"] & string;
+type ErrorCodes<T extends WorkflowConfig> = keyof T["errors"] & string;
+/** Forces TypeScript to flatten a type for better IDE autocomplete. */
+type Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+/** Resolves the data type for a given state from pre-computed types. */
+type StateData<T extends WorkflowConfig, S extends StateNames<T>> = Prettify<T["_resolved"]["states"][S]>;
+/** Resolves the payload type for a given command from pre-computed types. */
+type CommandPayload<T extends WorkflowConfig, C extends CommandNames<T>> = Prettify<T["_resolved"]["commands"][C]>;
+/** Resolves the data type for a given event from pre-computed types. */
+type EventData<T extends WorkflowConfig, E extends EventNames<T>> = Prettify<T["_resolved"]["events"][E]>;
+/** Resolves the data type for a given error code from pre-computed types. */
+type ErrorData<T extends WorkflowConfig, C extends ErrorCodes<T>> = Prettify<T["_resolved"]["errors"][C]>;
+/** Workflow narrowed to a specific known state. */
+interface WorkflowOf<TConfig extends WorkflowConfig, S extends StateNames<TConfig>> {
+    /** Unique workflow instance identifier. */
+    readonly id: string;
+    /** Name of the workflow definition this instance belongs to. */
+    readonly definitionName: string;
+    /** Current state name. */
+    readonly state: S;
+    /** State data, typed according to the state's Zod schema. */
+    readonly data: StateData<TConfig, S>;
+    /** Timestamp of workflow creation. */
+    readonly createdAt: Date;
+    /** Timestamp of last state change. */
+    readonly updatedAt: Date;
+}
+/** Discriminated union of all possible workflow states — checking .state narrows .data. */
+type Workflow<TConfig extends WorkflowConfig = WorkflowConfig> = {
+    [S in StateNames<TConfig>]: WorkflowOf<TConfig, S>;
+}[StateNames<TConfig>];
+/** Discriminated union of all pipeline error types on `category`. */
+type PipelineError<TConfig extends WorkflowConfig = WorkflowConfig> = {
+    category: "validation";
+    source: "command" | "state" | "event" | "transition" | "restore";
+    issues: z.core.$ZodIssue[];
+    message: string;
+} | {
+    category: "domain";
+    code: ErrorCodes<TConfig>;
+    data: ErrorData<TConfig, ErrorCodes<TConfig>>;
+} | {
+    category: "router";
+    code: "NO_HANDLER" | "UNKNOWN_STATE";
+    message: string;
+} | {
+    category: "unexpected";
+    error: unknown;
+    message: string;
+} | {
+    category: "dependency";
+    name: string;
+    error: unknown;
+    message: string;
+};
+/** Return type of {@link WorkflowRouter.dispatch}. Discriminated union on `ok`. */
+type DispatchResult<TConfig extends WorkflowConfig = WorkflowConfig> = {
+    ok: true;
+    workflow: Workflow<TConfig>;
+    events: Array<{
+        type: EventNames<TConfig>;
+        data: unknown;
+    }>;
+} | {
+    ok: false;
+    error: PipelineError<TConfig>;
+};
+/**
+ * Thrown internally when Zod validation fails during dispatch.
+ * Caught by the router and returned as a validation error in {@link DispatchResult}.
+ *
+ * @param source - Which validation stage failed
+ * @param issues - Array of Zod validation issues
+ */
+declare class ValidationError extends Error {
+    readonly source: "command" | "state" | "event" | "transition" | "restore";
+    readonly issues: z.core.$ZodIssue[];
+    constructor(source: "command" | "state" | "event" | "transition" | "restore", issues: z.core.$ZodIssue[]);
+}
+/**
+ * Thrown internally when a handler calls `ctx.error()`.
+ * Caught by the router and returned as a domain error in {@link DispatchResult}.
+ *
+ * @param code - The error code string
+ * @param data - The error data payload
+ */
+declare class DomainErrorSignal extends Error {
+    readonly code: string;
+    readonly data: unknown;
+    constructor(code: string, data: unknown);
+}
+/**
+ * Thrown internally when a proxied dependency call fails.
+ * Caught by the router and returned as a dependency error in {@link DispatchResult}.
+ *
+ * @param depName - The top-level dependency key (e.g. "db", "stripe")
+ * @param error - The original error thrown by the dependency
+ */
+/** Extracts the WorkflowConfig type from a WorkflowRouter instance. */
+type ConfigOf<R> = R extends {
+    definition: {
+        config: infer C;
+    };
+} ? C : never;
+
+/** A plain, JSON-safe representation of a workflow's state for serialization and storage. */
+interface WorkflowSnapshot<TConfig extends WorkflowConfig = WorkflowConfig> {
+    /** Unique workflow instance identifier. */
+    readonly id: string;
+    /** Name of the workflow definition. */
+    readonly definitionName: string;
+    /** Current state name. */
+    readonly state: StateNames<TConfig>;
+    /** State data (untyped — validated on {@link WorkflowDefinition.deserialize}). */
+    readonly data: unknown;
+    /** ISO 8601 timestamp of workflow creation. */
+    readonly createdAt: string;
+    /** ISO 8601 timestamp of last state change. */
+    readonly updatedAt: string;
+    /** Schema version number for migration support. */
+    readonly modelVersion: number;
+    /** Optimistic concurrency version. Starts at 1, increments on each successful save. */
+    readonly version: number;
+}
+
+export { type CommandNames as C, type DispatchResult as D, type ErrorCodes as E, type PipelineError as P, type StateNames as S, ValidationError as V, type WorkflowConfig as W, type WorkflowSnapshot as a, type CommandPayload as b, type ConfigOf as c, DomainErrorSignal as d, type ErrorData as e, type EventData as f, type EventNames as g, type StateData as h, type Workflow as i, type WorkflowOf as j, type WorkflowConfigInput as k };

package/dist/store/index.cjs

@@ -0,0 +1,68 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/store/index.ts
+var store_exports = {};
+__export(store_exports, {
+  ConcurrencyConflictError: () => ConcurrencyConflictError,
+  memoryStore: () => memoryStore
+});
+module.exports = __toCommonJS(store_exports);
+
+// src/store/errors.ts
+var ConcurrencyConflictError = class extends Error {
+  constructor(workflowId, expectedVersion, actualVersion) {
+    super(
+      `Concurrency conflict for workflow "${workflowId}": expected version ${expectedVersion}, actual ${actualVersion}`
+    );
+    this.workflowId = workflowId;
+    this.expectedVersion = expectedVersion;
+    this.actualVersion = actualVersion;
+  }
+  name = "ConcurrencyConflictError";
+};
+
+// src/store/memory-store.ts
+function memoryStore() {
+  const data = /* @__PURE__ */ new Map();
+  return {
+    async load(id) {
+      return data.get(id) ?? null;
+    },
+    async save(options) {
+      const { id, snapshot, expectedVersion } = options;
+      const existing = data.get(id);
+      const currentVersion = existing?.version ?? 0;
+      if (currentVersion !== expectedVersion) {
+        throw new ConcurrencyConflictError(id, expectedVersion, currentVersion);
+      }
+      const newVersion = currentVersion + 1;
+      data.set(id, {
+        snapshot: { ...snapshot, version: newVersion },
+        version: newVersion
+      });
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ConcurrencyConflictError,
+  memoryStore
+});
+//# sourceMappingURL=index.cjs.map

package/dist/store/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/store/index.ts","../../src/store/errors.ts","../../src/store/memory-store.ts"],"sourcesContent":["export { ConcurrencyConflictError } from \"./errors.js\";\nexport { memoryStore } from \"./memory-store.js\";\nexport type {\n\tSaveOptions,\n\tStoreAdapter,\n\tStoredWorkflow,\n} from \"./types.js\";\n","export class ConcurrencyConflictError extends Error {\n\treadonly name = \"ConcurrencyConflictError\";\n\n\tconstructor(\n\t\treadonly workflowId: string,\n\t\treadonly expectedVersion: number,\n\t\treadonly actualVersion: number,\n\t) {\n\t\tsuper(\n\t\t\t`Concurrency conflict for workflow \"${workflowId}\": expected version ${expectedVersion}, actual ${actualVersion}`,\n\t\t);\n\t}\n}\n","import { ConcurrencyConflictError } from \"./errors.js\";\nimport type { SaveOptions, StoreAdapter, StoredWorkflow } from \"./types.js\";\n\nexport function memoryStore(): StoreAdapter {\n\tconst data = new Map<string, StoredWorkflow>();\n\n\treturn {\n\t\tasync load(id) {\n\t\t\treturn data.get(id) ?? null;\n\t\t},\n\n\t\tasync save(options: SaveOptions) {\n\t\t\tconst { id, snapshot, expectedVersion } = options;\n\t\t\tconst existing = data.get(id);\n\t\t\tconst currentVersion = existing?.version ?? 0;\n\n\t\t\tif (currentVersion !== expectedVersion) {\n\t\t\t\tthrow new ConcurrencyConflictError(id, expectedVersion, currentVersion);\n\t\t\t}\n\n\t\t\tconst newVersion = currentVersion + 1;\n\t\t\tdata.set(id, {\n\t\t\t\tsnapshot: { ...snapshot, version: newVersion },\n\t\t\t\tversion: newVersion,\n\t\t\t});\n\t\t},\n\t};\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAO,IAAM,2BAAN,cAAuC,MAAM;AAAA,EAGnD,YACU,YACA,iBACA,eACR;AACD;AAAA,MACC,sCAAsC,UAAU,uBAAuB,eAAe,YAAY,aAAa;AAAA,IAChH;AANS;AACA;AACA;AAAA,EAKV;AAAA,EAVS,OAAO;AAWjB;;;ACTO,SAAS,cAA4B;AAC3C,QAAM,OAAO,oBAAI,IAA4B;AAE7C,SAAO;AAAA,IACN,MAAM,KAAK,IAAI;AACd,aAAO,KAAK,IAAI,EAAE,KAAK;AAAA,IACxB;AAAA,IAEA,MAAM,KAAK,SAAsB;AAChC,YAAM,EAAE,IAAI,UAAU,gBAAgB,IAAI;AAC1C,YAAM,WAAW,KAAK,IAAI,EAAE;AAC5B,YAAM,iBAAiB,UAAU,WAAW;AAE5C,UAAI,mBAAmB,iBAAiB;AACvC,cAAM,IAAI,yBAAyB,IAAI,iBAAiB,cAAc;AAAA,MACvE;AAEA,YAAM,aAAa,iBAAiB;AACpC,WAAK,IAAI,IAAI;AAAA,QACZ,UAAU,EAAE,GAAG,UAAU,SAAS,WAAW;AAAA,QAC7C,SAAS;AAAA,MACV,CAAC;AAAA,IACF;AAAA,EACD;AACD;","names":[]}

package/dist/store/index.d.cts

@@ -0,0 +1,16 @@
+import { a as StoreAdapter } from '../types-BtMTMoOZ.cjs';
+export { b as SaveOptions, S as StoredWorkflow } from '../types-BtMTMoOZ.cjs';
+import '../snapshot-D5iZubCz.cjs';
+import 'zod';
+
+declare class ConcurrencyConflictError extends Error {
+    readonly workflowId: string;
+    readonly expectedVersion: number;
+    readonly actualVersion: number;
+    readonly name = "ConcurrencyConflictError";
+    constructor(workflowId: string, expectedVersion: number, actualVersion: number);
+}
+
+declare function memoryStore(): StoreAdapter;
+
+export { ConcurrencyConflictError, StoreAdapter, memoryStore };

package/dist/store/index.d.ts

@@ -0,0 +1,16 @@
+import { a as StoreAdapter } from '../types-C0nlrs5c.js';
+export { b as SaveOptions, S as StoredWorkflow } from '../types-C0nlrs5c.js';
+import '../snapshot-D5iZubCz.js';
+import 'zod';
+
+declare class ConcurrencyConflictError extends Error {
+    readonly workflowId: string;
+    readonly expectedVersion: number;
+    readonly actualVersion: number;
+    readonly name = "ConcurrencyConflictError";
+    constructor(workflowId: string, expectedVersion: number, actualVersion: number);
+}
+
+declare function memoryStore(): StoreAdapter;
+
+export { ConcurrencyConflictError, StoreAdapter, memoryStore };

package/dist/store/index.js

@@ -0,0 +1,31 @@
+import {
+  ConcurrencyConflictError
+} from "../chunk-ZFRIE42B.js";
+
+// src/store/memory-store.ts
+function memoryStore() {
+  const data = /* @__PURE__ */ new Map();
+  return {
+    async load(id) {
+      return data.get(id) ?? null;
+    },
+    async save(options) {
+      const { id, snapshot, expectedVersion } = options;
+      const existing = data.get(id);
+      const currentVersion = existing?.version ?? 0;
+      if (currentVersion !== expectedVersion) {
+        throw new ConcurrencyConflictError(id, expectedVersion, currentVersion);
+      }
+      const newVersion = currentVersion + 1;
+      data.set(id, {
+        snapshot: { ...snapshot, version: newVersion },
+        version: newVersion
+      });
+    }
+  };
+}
+export {
+  ConcurrencyConflictError,
+  memoryStore
+};
+//# sourceMappingURL=index.js.map

package/dist/store/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/store/memory-store.ts"],"sourcesContent":["import { ConcurrencyConflictError } from \"./errors.js\";\nimport type { SaveOptions, StoreAdapter, StoredWorkflow } from \"./types.js\";\n\nexport function memoryStore(): StoreAdapter {\n\tconst data = new Map<string, StoredWorkflow>();\n\n\treturn {\n\t\tasync load(id) {\n\t\t\treturn data.get(id) ?? null;\n\t\t},\n\n\t\tasync save(options: SaveOptions) {\n\t\t\tconst { id, snapshot, expectedVersion } = options;\n\t\t\tconst existing = data.get(id);\n\t\t\tconst currentVersion = existing?.version ?? 0;\n\n\t\t\tif (currentVersion !== expectedVersion) {\n\t\t\t\tthrow new ConcurrencyConflictError(id, expectedVersion, currentVersion);\n\t\t\t}\n\n\t\t\tconst newVersion = currentVersion + 1;\n\t\t\tdata.set(id, {\n\t\t\t\tsnapshot: { ...snapshot, version: newVersion },\n\t\t\t\tversion: newVersion,\n\t\t\t});\n\t\t},\n\t};\n}\n"],"mappings":";;;;;AAGO,SAAS,cAA4B;AAC3C,QAAM,OAAO,oBAAI,IAA4B;AAE7C,SAAO;AAAA,IACN,MAAM,KAAK,IAAI;AACd,aAAO,KAAK,IAAI,EAAE,KAAK;AAAA,IACxB;AAAA,IAEA,MAAM,KAAK,SAAsB;AAChC,YAAM,EAAE,IAAI,UAAU,gBAAgB,IAAI;AAC1C,YAAM,WAAW,KAAK,IAAI,EAAE;AAC5B,YAAM,iBAAiB,UAAU,WAAW;AAE5C,UAAI,mBAAmB,iBAAiB;AACvC,cAAM,IAAI,yBAAyB,IAAI,iBAAiB,cAAc;AAAA,MACvE;AAEA,YAAM,aAAa,iBAAiB;AACpC,WAAK,IAAI,IAAI;AAAA,QACZ,UAAU,EAAE,GAAG,UAAU,SAAS,WAAW;AAAA,QAC7C,SAAS;AAAA,MACV,CAAC;AAAA,IACF;AAAA,EACD;AACD;","names":[]}