@rytejs/core 0.7.1 → 0.9.0

package/dist/{plugin-DHN3Pk52.d.ts → plugin-ByX9Eoe-.d.ts}

@@ -1,6 +1,33 @@
-import { W as WorkflowConfig, S as StateNames, h as StateData, j as WorkflowOf, i as Workflow, a as WorkflowSnapshot, V as ValidationError, k as WorkflowConfigInput, C as CommandNames, b as CommandPayload, g as EventNames, f as EventData, E as ErrorCodes, e as ErrorData, D as DispatchResult, P as PipelineError } from './snapshot-D5iZubCz.js';
+import { W as WorkflowConfig, a as WorkflowSnapshot, c as ClientWorkflow, V as ValidationError, S as StateNames, l as StateData, n as WorkflowOf, m as Workflow, o as WorkflowConfigInput, C as CommandNames, f as CommandPayload, k as EventNames, j as EventData, E as ErrorCodes, i as ErrorData, e as Command, D as DispatchResult, P as PipelineError } from './snapshot-6pxxtOjB.js';
 import { ZodType, z } from 'zod';
 
+declare const SERVER_BRAND: unique symbol;
+/** Brands a Zod schema type as server-only at the TypeScript level. */
+type Server<T extends ZodType> = T & {
+    readonly [SERVER_BRAND]: true;
+};
+/**
+ * Marks a Zod schema as server-only. Fields wrapped in `server()` are stripped
+ * from client snapshots and excluded from client TypeScript types.
+ *
+ * Returns a new schema reference — the original is not mutated, so shared
+ * schemas can safely be used in both server and non-server positions.
+ */
+declare function server<T extends ZodType>(schema: T): Server<T>;
+/** Returns `true` if the schema was wrapped with `server()`. */
+declare function isServerField(schema: ZodType): boolean;
+type ServerBranded = {
+    readonly [SERVER_BRAND]: true;
+};
+/** Computes the client-safe inferred type from a Zod schema by filtering out server-branded fields. */
+type ClientInfer<T extends ZodType> = T extends {
+    shape: infer Shape extends Record<string, ZodType>;
+} ? {
+    [K in keyof Shape as Shape[K] extends ServerBranded ? never : K]: Shape[K] extends {
+        shape: Record<string, ZodType>;
+    } ? ClientInfer<Shape[K]> : z.infer<Shape[K]>;
+} : z.infer<T>;
+
 /**
  * The result of {@link defineWorkflow} — holds schemas and creates workflow instances.
  */
@@ -82,6 +109,36 @@ interface WorkflowDefinition<TConfig extends WorkflowConfig = WorkflowConfig> {
         ok: false;
         error: ValidationError;
     };
+    /**
+     * Serializes a workflow into a client-safe snapshot with server-only fields stripped.
+     *
+     * @param workflow - The workflow instance to serialize
+     * @returns A {@link WorkflowSnapshot} with server-only fields removed from `data`
+     */
+    serializeForClient(workflow: Workflow<TConfig>): WorkflowSnapshot<TConfig>;
+    /**
+     * Returns a client-safe projection of this definition.
+     * Memoized — returns the same instance on repeated calls.
+     */
+    forClient(): ClientWorkflowDefinition<TConfig>;
+}
+/**
+ * A client-safe projection of a workflow definition.
+ * State schemas have server-only fields removed. Returned by {@link WorkflowDefinition.forClient}.
+ */
+interface ClientWorkflowDefinition<TConfig extends WorkflowConfig = WorkflowConfig> {
+    /** The raw Zod schema configuration. */
+    readonly config: TConfig;
+    readonly name: string;
+    getStateSchema(stateName: string): ZodType;
+    hasState(stateName: string): boolean;
+    deserialize(snapshot: WorkflowSnapshot<TConfig>): {
+        ok: true;
+        workflow: ClientWorkflow<TConfig>;
+    } | {
+        ok: false;
+        error: ValidationError;
+    };
 }
 /**
  * Creates a workflow definition from a name and Zod schema configuration.
@@ -105,6 +162,11 @@ declare function defineWorkflow<const TConfig extends WorkflowConfigInput>(name:
             [K in keyof TConfig["errors"]]: z.infer<TConfig["errors"][K]>;
         };
     };
+    _clientResolved: {
+        states: {
+            [K in keyof TConfig["states"]]: ClientInfer<TConfig["states"][K]>;
+        };
+    };
 }>;
 
 /** A phantom-typed key for type-safe middleware state storage via {@link Context.set} and {@link Context.get}. */
@@ -146,14 +208,14 @@ interface Context<TConfig extends WorkflowConfig, TDeps, TState extends StateNam
      * @param data - Data for the target state
      */
     transition<Target extends StateNames<TConfig>>(target: Target, data: StateData<TConfig, Target>): void;
+    /** Current state name (reflects mutations from {@link transition}). */
+    readonly state: TState;
     /**
      * Emits a domain event. Validates event data against the event's Zod schema.
-     * @param event - Event with type and data
+     * @param type - Event type name
+     * @param data - Event data matching the event's schema
      */
-    emit<E extends EventNames<TConfig>>(event: {
-        type: E;
-        data: EventData<TConfig, E>;
-    }): void;
+    emit<E extends EventNames<TConfig>>(type: E, data: EventData<TConfig, E>): void;
     /** Accumulated events emitted during this dispatch. */
     readonly events: ReadonlyArray<{
         type: EventNames<TConfig>;
@@ -161,12 +223,23 @@ interface Context<TConfig extends WorkflowConfig, TDeps, TState extends StateNam
     }>;
     /**
      * Signals a domain error. Validates error data and throws internally (caught by the router).
-     * @param err - Error with code and data
+     * @param code - Error code
+     * @param data - Error data matching the error code's schema
+     */
+    error<C extends ErrorCodes<TConfig>>(code: C, data: ErrorData<TConfig, C>): never;
+    /**
+     * Pattern-matches on the current state, calling the matching callback with narrowed data.
+     * All states must be handled (exhaustive).
+     */
+    match<R>(matchers: {
+        [S in StateNames<TConfig>]: (data: StateData<TConfig, S>, workflow: WorkflowOf<TConfig, S>) => R;
+    }): R;
+    /**
+     * Pattern-matches on the current state with a fallback for unhandled states.
      */
-    error<C extends ErrorCodes<TConfig>>(err: {
-        code: C;
-        data: ErrorData<TConfig, C>;
-    }): never;
+    match<R>(matchers: Partial<{
+        [S in StateNames<TConfig>]: (data: StateData<TConfig, S>, workflow: WorkflowOf<TConfig, S>) => R;
+    }>, fallback: () => R): R;
     /**
      * Stores a value in context-scoped middleware state.
      * @param key - A {@link ContextKey} created via {@link createKey}
@@ -253,14 +326,8 @@ declare class WorkflowRouter<TConfig extends WorkflowConfig, TDeps = {}> {
      * @param event - The lifecycle event name
      * @param callback - The callback to invoke when the event fires
      */
-    on(event: "dispatch:start", callback: (workflow: Workflow<TConfig>, command: {
-        type: CommandNames<TConfig>;
-        payload: unknown;
-    }) => void | Promise<void>): this;
-    on(event: "dispatch:end", callback: (workflow: Workflow<TConfig>, command: {
-        type: CommandNames<TConfig>;
-        payload: unknown;
-    }, result: DispatchResult<TConfig>) => void | Promise<void>): this;
+    on(event: "dispatch:start", callback: (workflow: Workflow<TConfig>, command: Command<TConfig>) => void | Promise<void>): this;
+    on(event: "dispatch:end", callback: (workflow: Workflow<TConfig>, command: Command<TConfig>, result: DispatchResult<TConfig>) => void | Promise<void>): this;
     on(event: "pipeline:start", callback: (ctx: ReadonlyContext<TConfig, TDeps>) => void | Promise<void>): this;
     on(event: "pipeline:end", callback: (ctx: ReadonlyContext<TConfig, TDeps>, result: DispatchResult<TConfig>) => void | Promise<void>): this;
     on(event: "transition", callback: (from: StateNames<TConfig>, to: StateNames<TConfig>, workflow: Workflow<TConfig>) => void | Promise<void>): this;
@@ -292,10 +359,7 @@ declare class WorkflowRouter<TConfig extends WorkflowConfig, TDeps = {}> {
      * @param command - The command with its type and payload
      * @returns A {@link DispatchResult} indicating success or failure with the updated workflow and events
      */
-    dispatch(workflow: Workflow<TConfig>, command: {
-        type: CommandNames<TConfig>;
-        payload: unknown;
-    }): Promise<DispatchResult<TConfig>>;
+    dispatch<C extends CommandNames<TConfig>>(workflow: Workflow<TConfig>, type: C, payload: CommandPayload<TConfig, C>): Promise<DispatchResult<TConfig>>;
     private executePipeline;
 }
 
@@ -336,4 +400,4 @@ declare function defineGenericPlugin(fn: (router: WorkflowRouter<any, any>) => v
  */
 declare function isPlugin(value: unknown): value is Plugin<WorkflowConfig, unknown>;
 
-export { type Context as C, type GenericPlugin as G, type Plugin as P, type ReadonlyContext as R, type WorkflowDefinition as W, type ContextKey as a, type RouterOptions as b, WorkflowRouter as c, createKey as d, defineGenericPlugin as e, definePlugin as f, defineWorkflow as g, isPlugin as i };
+export { type Context as C, type GenericPlugin as G, type Plugin as P, type ReadonlyContext as R, type Server as S, type WorkflowDefinition as W, type ClientWorkflowDefinition as a, type ContextKey as b, type RouterOptions as c, WorkflowRouter as d, createKey as e, defineGenericPlugin as f, definePlugin as g, defineWorkflow as h, isPlugin as i, isServerField as j, server as s };

package/dist/{plugin-DHS8yUmS.d.cts → plugin-CGikcWDu.d.cts}

@@ -1,6 +1,33 @@
-import { W as WorkflowConfig, S as StateNames, h as StateData, j as WorkflowOf, i as Workflow, a as WorkflowSnapshot, V as ValidationError, k as WorkflowConfigInput, C as CommandNames, b as CommandPayload, g as EventNames, f as EventData, E as ErrorCodes, e as ErrorData, D as DispatchResult, P as PipelineError } from './snapshot-D5iZubCz.cjs';
+import { W as WorkflowConfig, a as WorkflowSnapshot, c as ClientWorkflow, V as ValidationError, S as StateNames, l as StateData, n as WorkflowOf, m as Workflow, o as WorkflowConfigInput, C as CommandNames, f as CommandPayload, k as EventNames, j as EventData, E as ErrorCodes, i as ErrorData, e as Command, D as DispatchResult, P as PipelineError } from './snapshot-6pxxtOjB.cjs';
 import { ZodType, z } from 'zod';
 
+declare const SERVER_BRAND: unique symbol;
+/** Brands a Zod schema type as server-only at the TypeScript level. */
+type Server<T extends ZodType> = T & {
+    readonly [SERVER_BRAND]: true;
+};
+/**
+ * Marks a Zod schema as server-only. Fields wrapped in `server()` are stripped
+ * from client snapshots and excluded from client TypeScript types.
+ *
+ * Returns a new schema reference — the original is not mutated, so shared
+ * schemas can safely be used in both server and non-server positions.
+ */
+declare function server<T extends ZodType>(schema: T): Server<T>;
+/** Returns `true` if the schema was wrapped with `server()`. */
+declare function isServerField(schema: ZodType): boolean;
+type ServerBranded = {
+    readonly [SERVER_BRAND]: true;
+};
+/** Computes the client-safe inferred type from a Zod schema by filtering out server-branded fields. */
+type ClientInfer<T extends ZodType> = T extends {
+    shape: infer Shape extends Record<string, ZodType>;
+} ? {
+    [K in keyof Shape as Shape[K] extends ServerBranded ? never : K]: Shape[K] extends {
+        shape: Record<string, ZodType>;
+    } ? ClientInfer<Shape[K]> : z.infer<Shape[K]>;
+} : z.infer<T>;
+
 /**
  * The result of {@link defineWorkflow} — holds schemas and creates workflow instances.
  */
@@ -82,6 +109,36 @@ interface WorkflowDefinition<TConfig extends WorkflowConfig = WorkflowConfig> {
         ok: false;
         error: ValidationError;
     };
+    /**
+     * Serializes a workflow into a client-safe snapshot with server-only fields stripped.
+     *
+     * @param workflow - The workflow instance to serialize
+     * @returns A {@link WorkflowSnapshot} with server-only fields removed from `data`
+     */
+    serializeForClient(workflow: Workflow<TConfig>): WorkflowSnapshot<TConfig>;
+    /**
+     * Returns a client-safe projection of this definition.
+     * Memoized — returns the same instance on repeated calls.
+     */
+    forClient(): ClientWorkflowDefinition<TConfig>;
+}
+/**
+ * A client-safe projection of a workflow definition.
+ * State schemas have server-only fields removed. Returned by {@link WorkflowDefinition.forClient}.
+ */
+interface ClientWorkflowDefinition<TConfig extends WorkflowConfig = WorkflowConfig> {
+    /** The raw Zod schema configuration. */
+    readonly config: TConfig;
+    readonly name: string;
+    getStateSchema(stateName: string): ZodType;
+    hasState(stateName: string): boolean;
+    deserialize(snapshot: WorkflowSnapshot<TConfig>): {
+        ok: true;
+        workflow: ClientWorkflow<TConfig>;
+    } | {
+        ok: false;
+        error: ValidationError;
+    };
 }
 /**
  * Creates a workflow definition from a name and Zod schema configuration.
@@ -105,6 +162,11 @@ declare function defineWorkflow<const TConfig extends WorkflowConfigInput>(name:
             [K in keyof TConfig["errors"]]: z.infer<TConfig["errors"][K]>;
         };
     };
+    _clientResolved: {
+        states: {
+            [K in keyof TConfig["states"]]: ClientInfer<TConfig["states"][K]>;
+        };
+    };
 }>;
 
 /** A phantom-typed key for type-safe middleware state storage via {@link Context.set} and {@link Context.get}. */
@@ -146,14 +208,14 @@ interface Context<TConfig extends WorkflowConfig, TDeps, TState extends StateNam
      * @param data - Data for the target state
      */
     transition<Target extends StateNames<TConfig>>(target: Target, data: StateData<TConfig, Target>): void;
+    /** Current state name (reflects mutations from {@link transition}). */
+    readonly state: TState;
     /**
      * Emits a domain event. Validates event data against the event's Zod schema.
-     * @param event - Event with type and data
+     * @param type - Event type name
+     * @param data - Event data matching the event's schema
      */
-    emit<E extends EventNames<TConfig>>(event: {
-        type: E;
-        data: EventData<TConfig, E>;
-    }): void;
+    emit<E extends EventNames<TConfig>>(type: E, data: EventData<TConfig, E>): void;
     /** Accumulated events emitted during this dispatch. */
     readonly events: ReadonlyArray<{
         type: EventNames<TConfig>;
@@ -161,12 +223,23 @@ interface Context<TConfig extends WorkflowConfig, TDeps, TState extends StateNam
     }>;
     /**
      * Signals a domain error. Validates error data and throws internally (caught by the router).
-     * @param err - Error with code and data
+     * @param code - Error code
+     * @param data - Error data matching the error code's schema
+     */
+    error<C extends ErrorCodes<TConfig>>(code: C, data: ErrorData<TConfig, C>): never;
+    /**
+     * Pattern-matches on the current state, calling the matching callback with narrowed data.
+     * All states must be handled (exhaustive).
+     */
+    match<R>(matchers: {
+        [S in StateNames<TConfig>]: (data: StateData<TConfig, S>, workflow: WorkflowOf<TConfig, S>) => R;
+    }): R;
+    /**
+     * Pattern-matches on the current state with a fallback for unhandled states.
      */
-    error<C extends ErrorCodes<TConfig>>(err: {
-        code: C;
-        data: ErrorData<TConfig, C>;
-    }): never;
+    match<R>(matchers: Partial<{
+        [S in StateNames<TConfig>]: (data: StateData<TConfig, S>, workflow: WorkflowOf<TConfig, S>) => R;
+    }>, fallback: () => R): R;
     /**
      * Stores a value in context-scoped middleware state.
      * @param key - A {@link ContextKey} created via {@link createKey}
@@ -253,14 +326,8 @@ declare class WorkflowRouter<TConfig extends WorkflowConfig, TDeps = {}> {
      * @param event - The lifecycle event name
      * @param callback - The callback to invoke when the event fires
      */
-    on(event: "dispatch:start", callback: (workflow: Workflow<TConfig>, command: {
-        type: CommandNames<TConfig>;
-        payload: unknown;
-    }) => void | Promise<void>): this;
-    on(event: "dispatch:end", callback: (workflow: Workflow<TConfig>, command: {
-        type: CommandNames<TConfig>;
-        payload: unknown;
-    }, result: DispatchResult<TConfig>) => void | Promise<void>): this;
+    on(event: "dispatch:start", callback: (workflow: Workflow<TConfig>, command: Command<TConfig>) => void | Promise<void>): this;
+    on(event: "dispatch:end", callback: (workflow: Workflow<TConfig>, command: Command<TConfig>, result: DispatchResult<TConfig>) => void | Promise<void>): this;
     on(event: "pipeline:start", callback: (ctx: ReadonlyContext<TConfig, TDeps>) => void | Promise<void>): this;
     on(event: "pipeline:end", callback: (ctx: ReadonlyContext<TConfig, TDeps>, result: DispatchResult<TConfig>) => void | Promise<void>): this;
     on(event: "transition", callback: (from: StateNames<TConfig>, to: StateNames<TConfig>, workflow: Workflow<TConfig>) => void | Promise<void>): this;
@@ -292,10 +359,7 @@ declare class WorkflowRouter<TConfig extends WorkflowConfig, TDeps = {}> {
      * @param command - The command with its type and payload
      * @returns A {@link DispatchResult} indicating success or failure with the updated workflow and events
      */
-    dispatch(workflow: Workflow<TConfig>, command: {
-        type: CommandNames<TConfig>;
-        payload: unknown;
-    }): Promise<DispatchResult<TConfig>>;
+    dispatch<C extends CommandNames<TConfig>>(workflow: Workflow<TConfig>, type: C, payload: CommandPayload<TConfig, C>): Promise<DispatchResult<TConfig>>;
     private executePipeline;
 }
 
@@ -336,4 +400,4 @@ declare function defineGenericPlugin(fn: (router: WorkflowRouter<any, any>) => v
  */
 declare function isPlugin(value: unknown): value is Plugin<WorkflowConfig, unknown>;
 
-export { type Context as C, type GenericPlugin as G, type Plugin as P, type ReadonlyContext as R, type WorkflowDefinition as W, type ContextKey as a, type RouterOptions as b, WorkflowRouter as c, createKey as d, defineGenericPlugin as e, definePlugin as f, defineWorkflow as g, isPlugin as i };
+export { type Context as C, type GenericPlugin as G, type Plugin as P, type ReadonlyContext as R, type Server as S, type WorkflowDefinition as W, type ClientWorkflowDefinition as a, type ContextKey as b, type RouterOptions as c, WorkflowRouter as d, createKey as e, defineGenericPlugin as f, definePlugin as g, defineWorkflow as h, isPlugin as i, isServerField as j, server as s };

package/dist/reactor/index.d.cts

@@ -1,5 +1,5 @@
-import { c as WorkflowRouter } from '../plugin-DHS8yUmS.cjs';
-import { W as WorkflowConfig, g as EventNames, f as EventData } from '../snapshot-D5iZubCz.cjs';
+import { d as WorkflowRouter } from '../plugin-CGikcWDu.cjs';
+import { W as WorkflowConfig, k as EventNames, j as EventData } from '../snapshot-6pxxtOjB.cjs';
 import 'zod';
 
 interface ReactorCommand {

package/dist/reactor/index.d.ts

@@ -1,5 +1,5 @@
-import { c as WorkflowRouter } from '../plugin-DHN3Pk52.js';
-import { W as WorkflowConfig, g as EventNames, f as EventData } from '../snapshot-D5iZubCz.js';
+import { d as WorkflowRouter } from '../plugin-ByX9Eoe-.js';
+import { W as WorkflowConfig, k as EventNames, j as EventData } from '../snapshot-6pxxtOjB.js';
 import 'zod';
 
 interface ReactorCommand {

package/dist/{snapshot-D5iZubCz.d.cts → snapshot-6pxxtOjB.d.cts}

@@ -32,6 +32,9 @@ interface WorkflowConfig extends WorkflowConfigInput {
         events: Record<string, unknown>;
         errors: Record<string, unknown>;
     };
+    _clientResolved: {
+        states: Record<string, unknown>;
+    };
 }
 type StateNames<T extends WorkflowConfig> = keyof T["states"] & string;
 type CommandNames<T extends WorkflowConfig> = keyof T["commands"] & string;
@@ -41,8 +44,30 @@ type ErrorCodes<T extends WorkflowConfig> = keyof T["errors"] & string;
 type Prettify<T> = {
     [K in keyof T]: T[K];
 } & {};
+/** Discriminated union of all commands with typed payloads — narrows payload when checking type. */
+type Command<T extends WorkflowConfig> = {
+    [C in CommandNames<T>]: {
+        type: C;
+        payload: CommandPayload<T, C>;
+    };
+}[CommandNames<T>];
 /** 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 client-safe data type for a given state (server fields stripped). */
+type ClientStateData<T extends WorkflowConfig, S extends StateNames<T>> = Prettify<T["_clientResolved"]["states"][S]>;
+/** Client-side workflow narrowed to a specific known state. */
+interface ClientWorkflowOf<TConfig extends WorkflowConfig, S extends StateNames<TConfig>> {
+    readonly id: string;
+    readonly definitionName: string;
+    readonly state: S;
+    readonly data: ClientStateData<TConfig, S>;
+    readonly createdAt: Date;
+    readonly updatedAt: Date;
+}
+/** Discriminated union of all possible client-side workflow states. */
+type ClientWorkflow<TConfig extends WorkflowConfig = WorkflowConfig> = {
+    [S in StateNames<TConfig>]: ClientWorkflowOf<TConfig, S>;
+}[StateNames<TConfig>];
 /** 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. */
@@ -162,4 +187,4 @@ interface WorkflowSnapshot<TConfig extends WorkflowConfig = WorkflowConfig> {
     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 };
+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 ClientStateData as b, type ClientWorkflow as c, type ClientWorkflowOf as d, type Command as e, type CommandPayload as f, type ConfigOf as g, DomainErrorSignal as h, type ErrorData as i, type EventData as j, type EventNames as k, type StateData as l, type Workflow as m, type WorkflowOf as n, type WorkflowConfigInput as o };

package/dist/{snapshot-D5iZubCz.d.ts → snapshot-6pxxtOjB.d.ts}

@@ -32,6 +32,9 @@ interface WorkflowConfig extends WorkflowConfigInput {
         events: Record<string, unknown>;
         errors: Record<string, unknown>;
     };
+    _clientResolved: {
+        states: Record<string, unknown>;
+    };
 }
 type StateNames<T extends WorkflowConfig> = keyof T["states"] & string;
 type CommandNames<T extends WorkflowConfig> = keyof T["commands"] & string;
@@ -41,8 +44,30 @@ type ErrorCodes<T extends WorkflowConfig> = keyof T["errors"] & string;
 type Prettify<T> = {
     [K in keyof T]: T[K];
 } & {};
+/** Discriminated union of all commands with typed payloads — narrows payload when checking type. */
+type Command<T extends WorkflowConfig> = {
+    [C in CommandNames<T>]: {
+        type: C;
+        payload: CommandPayload<T, C>;
+    };
+}[CommandNames<T>];
 /** 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 client-safe data type for a given state (server fields stripped). */
+type ClientStateData<T extends WorkflowConfig, S extends StateNames<T>> = Prettify<T["_clientResolved"]["states"][S]>;
+/** Client-side workflow narrowed to a specific known state. */
+interface ClientWorkflowOf<TConfig extends WorkflowConfig, S extends StateNames<TConfig>> {
+    readonly id: string;
+    readonly definitionName: string;
+    readonly state: S;
+    readonly data: ClientStateData<TConfig, S>;
+    readonly createdAt: Date;
+    readonly updatedAt: Date;
+}
+/** Discriminated union of all possible client-side workflow states. */
+type ClientWorkflow<TConfig extends WorkflowConfig = WorkflowConfig> = {
+    [S in StateNames<TConfig>]: ClientWorkflowOf<TConfig, S>;
+}[StateNames<TConfig>];
 /** 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. */
@@ -162,4 +187,4 @@ interface WorkflowSnapshot<TConfig extends WorkflowConfig = WorkflowConfig> {
     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 };
+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 ClientStateData as b, type ClientWorkflow as c, type ClientWorkflowOf as d, type Command as e, type CommandPayload as f, type ConfigOf as g, DomainErrorSignal as h, type ErrorData as i, type EventData as j, type EventNames as k, type StateData as l, type Workflow as m, type WorkflowOf as n, type WorkflowConfigInput as o };

package/dist/store/index.d.cts

@@ -1,6 +1,6 @@
-import { a as StoreAdapter } from '../types-BtMTMoOZ.cjs';
-export { b as SaveOptions, S as StoredWorkflow } from '../types-BtMTMoOZ.cjs';
-import '../snapshot-D5iZubCz.cjs';
+import { a as StoreAdapter } from '../types-BuFyzP66.cjs';
+export { b as SaveOptions, S as StoredWorkflow } from '../types-BuFyzP66.cjs';
+import '../snapshot-6pxxtOjB.cjs';
 import 'zod';
 
 declare class ConcurrencyConflictError extends Error {

package/dist/store/index.d.ts

@@ -1,6 +1,6 @@
-import { a as StoreAdapter } from '../types-C0nlrs5c.js';
-export { b as SaveOptions, S as StoredWorkflow } from '../types-C0nlrs5c.js';
-import '../snapshot-D5iZubCz.js';
+import { a as StoreAdapter } from '../types-D41DR3xh.js';
+export { b as SaveOptions, S as StoredWorkflow } from '../types-D41DR3xh.js';
+import '../snapshot-6pxxtOjB.js';
 import 'zod';
 
 declare class ConcurrencyConflictError extends Error {

package/dist/{types-BtMTMoOZ.d.cts → types-BuFyzP66.d.cts}

@@ -1,4 +1,4 @@
-import { a as WorkflowSnapshot } from './snapshot-D5iZubCz.cjs';
+import { a as WorkflowSnapshot } from './snapshot-6pxxtOjB.cjs';
 
 interface StoredWorkflow {
     snapshot: WorkflowSnapshot;

package/dist/{types-C0nlrs5c.d.ts → types-D41DR3xh.d.ts}

@@ -1,4 +1,4 @@
-import { a as WorkflowSnapshot } from './snapshot-D5iZubCz.js';
+import { a as WorkflowSnapshot } from './snapshot-6pxxtOjB.js';
 
 interface StoredWorkflow {
     snapshot: WorkflowSnapshot;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rytejs/core",
-  "version": "0.7.1",
+  "version": "0.9.0",
   "description": "Type-safe workflow engine with Zod validation and middleware pipelines",
   "license": "MIT",
   "type": "module",