@rxova/journey-core 0.7.0 → 1.0.0-rc.2

package/dist/journey-builder/index.d.cts

@@ -0,0 +1,5 @@
+import type { JourneyJsonObject } from "../types";
+import type { JourneyBuilder } from "./types";
+export type { JourneyBuilder, JourneyBuilderCustomEventKey, JourneyBuilderDefinition, JourneyBuilderDefinitionMetadata, JourneyBuilderGuard, JourneyBuilderLifecycle, JourneyBuilderOnEntry, JourneyBuilderTerminalCandidate, JourneyBuilderTerminalEntry, JourneyBuilderUpdateContext, JourneyStepBuilder, JourneyToBuilder } from "./types";
+/** Creates a typed builder for authoring journey definitions with `createStep`, `to`, and `build` helpers. */
+export declare function createJourneyBuilder<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>, TStepMeta = unknown, THandlers extends Record<string, unknown> = Record<never, never>>(): JourneyBuilder<TContext, TStepId, TEventMap, TStepMeta, THandlers>;

package/dist/journey-builder/index.d.ts

@@ -0,0 +1,5 @@
+import type { JourneyJsonObject } from "../types";
+import type { JourneyBuilder } from "./types";
+export type { JourneyBuilder, JourneyBuilderCustomEventKey, JourneyBuilderDefinition, JourneyBuilderDefinitionMetadata, JourneyBuilderGuard, JourneyBuilderLifecycle, JourneyBuilderOnEntry, JourneyBuilderTerminalCandidate, JourneyBuilderTerminalEntry, JourneyBuilderUpdateContext, JourneyStepBuilder, JourneyToBuilder } from "./types";
+/** Creates a typed builder for authoring journey definitions with `createStep`, `to`, and `build` helpers. */
+export declare function createJourneyBuilder<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>, TStepMeta = unknown, THandlers extends Record<string, unknown> = Record<never, never>>(): JourneyBuilder<TContext, TStepId, TEventMap, TStepMeta, THandlers>;

package/dist/journey-builder/types.d.cts

@@ -0,0 +1,126 @@
+import type { JourneyDefaultEventType, JourneyDefinition, JourneyFullEventType, JourneyJsonObject } from "../types";
+import type { JourneyStepLifecycleCallback, JourneyTransitionArgsForEvent, JourneyTransitionUpdateContextArgsForEvent } from "../types";
+export type JourneyBuilderStepEventKey<TEventMap extends Record<string, unknown>> = Exclude<JourneyFullEventType<TEventMap>, "completeJourney" | "terminateJourney">;
+export type JourneyBuilderTerminalEventKey<TEventMap extends Record<string, unknown>> = Extract<JourneyFullEventType<TEventMap>, "completeJourney" | "terminateJourney">;
+export type JourneyBuilderCustomEventKey<TEventMap extends Record<string, unknown>> = Exclude<keyof TEventMap & string, JourneyDefaultEventType>;
+export type JourneyBuilderGuard<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>, TEventType extends JourneyFullEventType<TEventMap> = JourneyFullEventType<TEventMap>> = (args: JourneyTransitionArgsForEvent<TContext, TStepId, TEventMap, THandlers, TEventType>) => boolean | Promise<boolean>;
+export type JourneyBuilderUpdateContext<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, TEventType extends JourneyFullEventType<TEventMap> = JourneyFullEventType<TEventMap>> = (args: JourneyTransitionUpdateContextArgsForEvent<TContext, TStepId, TEventMap, TEventType>) => TContext;
+export type JourneyBuilderLifecycle<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>> = JourneyStepLifecycleCallback<TContext, TStepId, TEventMap, THandlers>;
+export type JourneyBuilderCandidate<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>, TEventType extends JourneyFullEventType<TEventMap> = JourneyFullEventType<TEventMap>> = {
+    readonly _to: TStepId;
+    readonly _when: JourneyBuilderGuard<TContext, TStepId, TEventMap, THandlers, TEventType> | undefined;
+    readonly _updateContext: JourneyBuilderUpdateContext<TContext, TStepId, TEventMap, TEventType> | undefined;
+    readonly _onEnter: JourneyBuilderLifecycle<TContext, TStepId, TEventMap, THandlers> | undefined;
+    readonly _onLeave: JourneyBuilderLifecycle<TContext, TStepId, TEventMap, THandlers> | undefined;
+    readonly _label: string | undefined;
+    readonly _timeoutMs: number | undefined;
+};
+export type JourneyToBuilderUsage = {
+    readonly when: boolean;
+    readonly updateContext: boolean;
+    readonly onEnter: boolean;
+    readonly onLeave: boolean;
+    readonly label: boolean;
+    readonly timeoutMs: boolean;
+};
+export type JourneyToBuilderUnused = {
+    readonly when: false;
+    readonly updateContext: false;
+    readonly onEnter: false;
+    readonly onLeave: false;
+    readonly label: false;
+    readonly timeoutMs: false;
+};
+type JourneyDuplicateModifierCall<TName extends string> = (...args: [
+    `Duplicate transition modifier ${TName}() is invalid. If several are present, the last one wins at runtime.`
+]) => never;
+export type JourneyToBuilder<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>, TEventType extends JourneyFullEventType<TEventMap> = JourneyFullEventType<TEventMap>, TUsed extends JourneyToBuilderUsage = JourneyToBuilderUnused> = {
+    readonly _candidate: JourneyBuilderCandidate<TContext, TStepId, TEventMap, THandlers, TEventType>;
+    when: TUsed["when"] extends true ? JourneyDuplicateModifierCall<"when"> : (guard: JourneyBuilderGuard<TContext, TStepId, TEventMap, THandlers, TEventType>) => JourneyToBuilder<TContext, TStepId, TEventMap, THandlers, TEventType, Omit<TUsed, "when"> & {
+        readonly when: true;
+    }>;
+    updateContext: TUsed["updateContext"] extends true ? JourneyDuplicateModifierCall<"updateContext"> : (fn: JourneyBuilderUpdateContext<TContext, TStepId, TEventMap, TEventType>) => JourneyToBuilder<TContext, TStepId, TEventMap, THandlers, TEventType, Omit<TUsed, "updateContext"> & {
+        readonly updateContext: true;
+    }>;
+    onEnter: TUsed["onEnter"] extends true ? JourneyDuplicateModifierCall<"onEnter"> : (fn: JourneyBuilderLifecycle<TContext, TStepId, TEventMap, THandlers>) => JourneyToBuilder<TContext, TStepId, TEventMap, THandlers, TEventType, Omit<TUsed, "onEnter"> & {
+        readonly onEnter: true;
+    }>;
+    onLeave: TUsed["onLeave"] extends true ? JourneyDuplicateModifierCall<"onLeave"> : (fn: JourneyBuilderLifecycle<TContext, TStepId, TEventMap, THandlers>) => JourneyToBuilder<TContext, TStepId, TEventMap, THandlers, TEventType, Omit<TUsed, "onLeave"> & {
+        readonly onLeave: true;
+    }>;
+    label: TUsed["label"] extends true ? JourneyDuplicateModifierCall<"label"> : (label: string) => JourneyToBuilder<TContext, TStepId, TEventMap, THandlers, TEventType, Omit<TUsed, "label"> & {
+        readonly label: true;
+    }>;
+    timeoutMs: TUsed["timeoutMs"] extends true ? JourneyDuplicateModifierCall<"timeoutMs"> : (ms: number) => JourneyToBuilder<TContext, TStepId, TEventMap, THandlers, TEventType, Omit<TUsed, "timeoutMs"> & {
+        readonly timeoutMs: true;
+    }>;
+};
+type JourneyBuiltTransitionCandidate<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>, TEventType extends JourneyFullEventType<TEventMap> = JourneyFullEventType<TEventMap>> = {
+    readonly _candidate: JourneyBuilderCandidate<TContext, TStepId, TEventMap, THandlers, TEventType>;
+};
+export type JourneyBuilderOnEntry<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>, TEventType extends JourneyBuilderStepEventKey<TEventMap>> = readonly JourneyBuiltTransitionCandidate<TContext, TStepId, TEventMap, THandlers>[] | ((helpers: {
+    to: (stepId: TStepId) => JourneyToBuilder<TContext, TStepId, TEventMap, THandlers, TEventType>;
+}) => readonly JourneyBuiltTransitionCandidate<TContext, TStepId, TEventMap, THandlers, TEventType>[]);
+export type JourneyBuilderTerminalCandidate<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>, TEventType extends JourneyBuilderTerminalEventKey<TEventMap>> = {
+    when?: JourneyBuilderGuard<TContext, TStepId, TEventMap, THandlers, TEventType>;
+    updateContext?: JourneyBuilderUpdateContext<TContext, TStepId, TEventMap, TEventType>;
+    onEnter?: JourneyBuilderLifecycle<TContext, TStepId, TEventMap, THandlers>;
+    onLeave?: JourneyBuilderLifecycle<TContext, TStepId, TEventMap, THandlers>;
+    label?: string;
+    timeoutMs?: number;
+};
+export type JourneyBuilderTerminalEntry<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>, TEventType extends JourneyBuilderTerminalEventKey<TEventMap>> = true | readonly [] | readonly JourneyBuilderTerminalCandidate<TContext, TStepId, TEventMap, THandlers, TEventType>[];
+type JourneyBuilderEventEntry<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>, TEventType extends JourneyFullEventType<TEventMap>> = TEventType extends JourneyBuilderTerminalEventKey<TEventMap> ? JourneyBuilderTerminalEntry<TContext, TStepId, TEventMap, THandlers, TEventType> : JourneyBuilderOnEntry<TContext, TStepId, TEventMap, THandlers, Extract<TEventType, JourneyBuilderStepEventKey<TEventMap>>>;
+type JourneyStepBuilderOnConfig<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>> = Partial<{
+    [TEventType in JourneyFullEventType<TEventMap>]: JourneyBuilderEventEntry<TContext, TStepId, TEventMap, THandlers, TEventType>;
+}>;
+type JourneyStepBuilderHandledCustomEventKey<TEventMap extends Record<string, unknown>, TOn> = Extract<keyof NonNullable<TOn>, JourneyBuilderCustomEventKey<TEventMap>>;
+type JourneyStepBuilderConfig<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, TStepMeta, THandlers extends Record<string, unknown>, TOn extends JourneyStepBuilderOnConfig<TContext, TStepId, TEventMap, THandlers> | undefined = JourneyStepBuilderOnConfig<TContext, TStepId, TEventMap, THandlers> | undefined> = {
+    meta?: TStepMeta;
+    onEnter?: JourneyStepLifecycleCallback<TContext, TStepId, TEventMap, THandlers>;
+    onLeave?: JourneyStepLifecycleCallback<TContext, TStepId, TEventMap, THandlers>;
+    on?: TOn;
+};
+export type JourneyStepBuilder<TContext extends JourneyJsonObject, TStepId extends string, TStepKey extends TStepId, TEventMap extends Record<string, unknown>, TStepMeta, THandlers extends Record<string, unknown>, THandledCustomEventType extends JourneyBuilderCustomEventKey<TEventMap> = never> = {
+    readonly id: TStepKey;
+    readonly _meta: TStepMeta | undefined;
+    readonly _onEnter: JourneyStepLifecycleCallback<TContext, TStepId, TEventMap, THandlers> | undefined;
+    readonly _onLeave: JourneyStepLifecycleCallback<TContext, TStepId, TEventMap, THandlers> | undefined;
+    readonly _on: Record<string, JourneyBuilderEventEntry<TContext, TStepId, TEventMap, THandlers, JourneyFullEventType<TEventMap>>> | undefined;
+    readonly _handledCustomEventType?: THandledCustomEventType;
+};
+type JourneyStepBuilderHandledCustomEventMap<TStepId extends string, TEventMap extends Record<string, unknown>, TSteps extends readonly {
+    readonly id: TStepId;
+    readonly _handledCustomEventType?: JourneyBuilderCustomEventKey<TEventMap>;
+}[]> = {
+    [TCurrentStepId in TStepId]: Extract<Extract<TSteps[number], {
+        readonly id: TCurrentStepId;
+    }> extends {
+        readonly _handledCustomEventType?: infer THandledCustomEventType;
+    } ? THandledCustomEventType : never, JourneyBuilderCustomEventKey<TEventMap>>;
+};
+type JourneyBuilderGlobalHandledCustomEventKey<TEventMap extends Record<string, unknown>, TGlobal> = Extract<keyof NonNullable<TGlobal>, JourneyBuilderCustomEventKey<TEventMap>>;
+declare const journeyBuilderDefinitionBrand: unique symbol;
+export type JourneyBuilderDefinitionMetadata<TStepId extends string, TEventMap extends Record<string, unknown>, TStepHandledCustomEventMap extends Record<TStepId, JourneyBuilderCustomEventKey<TEventMap>> = Record<TStepId, never>, TGlobalHandledCustomEventType extends JourneyBuilderCustomEventKey<TEventMap> = never> = {
+    readonly [journeyBuilderDefinitionBrand]?: {
+        readonly stepHandledCustomEvents: TStepHandledCustomEventMap;
+        readonly globalHandledCustomEvents: TGlobalHandledCustomEventType;
+    };
+};
+export type JourneyBuilderDefinition<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, TStepMeta = unknown, THandlers extends Record<string, unknown> = Record<never, never>, TStepHandledCustomEventMap extends Record<TStepId, JourneyBuilderCustomEventKey<TEventMap>> = Record<TStepId, never>, TGlobalHandledCustomEventType extends JourneyBuilderCustomEventKey<TEventMap> = never> = JourneyDefinition<TContext, TStepId, TEventMap, TStepMeta, THandlers> & JourneyBuilderDefinitionMetadata<TStepId, TEventMap, TStepHandledCustomEventMap, TGlobalHandledCustomEventType>;
+type JourneyBuilderGlobalConfig<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>> = Partial<{
+    [TEventType in JourneyFullEventType<TEventMap>]: TEventType extends JourneyBuilderTerminalEventKey<TEventMap> ? JourneyBuilderTerminalEntry<TContext, TStepId, TEventMap, THandlers, TEventType> : readonly JourneyBuiltTransitionCandidate<TContext, TStepId, TEventMap, THandlers>[];
+}>;
+type JourneyBuilderBuildInput<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, TStepMeta, THandlers extends Record<string, unknown>, TSteps extends readonly JourneyStepBuilder<TContext, TStepId, TStepId, TEventMap, TStepMeta, THandlers, JourneyBuilderCustomEventKey<TEventMap>>[], TGlobal extends JourneyBuilderGlobalConfig<TContext, TStepId, TEventMap, THandlers> | undefined = JourneyBuilderGlobalConfig<TContext, TStepId, TEventMap, THandlers> | undefined> = {
+    initial: TStepId;
+    context: TContext;
+    handlers?: THandlers;
+    steps: TSteps;
+    global?: TGlobal;
+};
+export type JourneyBuilder<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>, TStepMeta = unknown, THandlers extends Record<string, unknown> = Record<never, never>> = {
+    createStep: <TStepKey extends TStepId, TOn extends JourneyStepBuilderOnConfig<TContext, TStepId, TEventMap, THandlers> | undefined = JourneyStepBuilderOnConfig<TContext, TStepId, TEventMap, THandlers> | undefined>(id: TStepKey, config?: JourneyStepBuilderConfig<TContext, TStepId, TEventMap, TStepMeta, THandlers, TOn>) => JourneyStepBuilder<TContext, TStepId, TStepKey, TEventMap, TStepMeta, THandlers, JourneyStepBuilderHandledCustomEventKey<TEventMap, TOn>>;
+    to: (stepId: TStepId) => JourneyToBuilder<TContext, TStepId, TEventMap, THandlers>;
+    build: <TSteps extends readonly JourneyStepBuilder<TContext, TStepId, TStepId, TEventMap, TStepMeta, THandlers, JourneyBuilderCustomEventKey<TEventMap>>[], TGlobal extends JourneyBuilderGlobalConfig<TContext, TStepId, TEventMap, THandlers> | undefined = JourneyBuilderGlobalConfig<TContext, TStepId, TEventMap, THandlers> | undefined>(input: JourneyBuilderBuildInput<TContext, TStepId, TEventMap, TStepMeta, THandlers, TSteps, TGlobal>) => JourneyBuilderDefinition<TContext, TStepId, TEventMap, TStepMeta, THandlers, JourneyStepBuilderHandledCustomEventMap<TStepId, TEventMap, TSteps>, JourneyBuilderGlobalHandledCustomEventKey<TEventMap, TGlobal>>;
+};
+export type { JourneyStepBuilderConfig as _JourneyStepBuilderConfig, JourneyBuilderBuildInput as _JourneyBuilderBuildInput, JourneyBuilderEventEntry as _JourneyBuilderEventEntry };

package/dist/journey-builder/types.d.ts

@@ -0,0 +1,126 @@
+import type { JourneyDefaultEventType, JourneyDefinition, JourneyFullEventType, JourneyJsonObject } from "../types";
+import type { JourneyStepLifecycleCallback, JourneyTransitionArgsForEvent, JourneyTransitionUpdateContextArgsForEvent } from "../types";
+export type JourneyBuilderStepEventKey<TEventMap extends Record<string, unknown>> = Exclude<JourneyFullEventType<TEventMap>, "completeJourney" | "terminateJourney">;
+export type JourneyBuilderTerminalEventKey<TEventMap extends Record<string, unknown>> = Extract<JourneyFullEventType<TEventMap>, "completeJourney" | "terminateJourney">;
+export type JourneyBuilderCustomEventKey<TEventMap extends Record<string, unknown>> = Exclude<keyof TEventMap & string, JourneyDefaultEventType>;
+export type JourneyBuilderGuard<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>, TEventType extends JourneyFullEventType<TEventMap> = JourneyFullEventType<TEventMap>> = (args: JourneyTransitionArgsForEvent<TContext, TStepId, TEventMap, THandlers, TEventType>) => boolean | Promise<boolean>;
+export type JourneyBuilderUpdateContext<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, TEventType extends JourneyFullEventType<TEventMap> = JourneyFullEventType<TEventMap>> = (args: JourneyTransitionUpdateContextArgsForEvent<TContext, TStepId, TEventMap, TEventType>) => TContext;
+export type JourneyBuilderLifecycle<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>> = JourneyStepLifecycleCallback<TContext, TStepId, TEventMap, THandlers>;
+export type JourneyBuilderCandidate<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>, TEventType extends JourneyFullEventType<TEventMap> = JourneyFullEventType<TEventMap>> = {
+    readonly _to: TStepId;
+    readonly _when: JourneyBuilderGuard<TContext, TStepId, TEventMap, THandlers, TEventType> | undefined;
+    readonly _updateContext: JourneyBuilderUpdateContext<TContext, TStepId, TEventMap, TEventType> | undefined;
+    readonly _onEnter: JourneyBuilderLifecycle<TContext, TStepId, TEventMap, THandlers> | undefined;
+    readonly _onLeave: JourneyBuilderLifecycle<TContext, TStepId, TEventMap, THandlers> | undefined;
+    readonly _label: string | undefined;
+    readonly _timeoutMs: number | undefined;
+};
+export type JourneyToBuilderUsage = {
+    readonly when: boolean;
+    readonly updateContext: boolean;
+    readonly onEnter: boolean;
+    readonly onLeave: boolean;
+    readonly label: boolean;
+    readonly timeoutMs: boolean;
+};
+export type JourneyToBuilderUnused = {
+    readonly when: false;
+    readonly updateContext: false;
+    readonly onEnter: false;
+    readonly onLeave: false;
+    readonly label: false;
+    readonly timeoutMs: false;
+};
+type JourneyDuplicateModifierCall<TName extends string> = (...args: [
+    `Duplicate transition modifier ${TName}() is invalid. If several are present, the last one wins at runtime.`
+]) => never;
+export type JourneyToBuilder<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>, TEventType extends JourneyFullEventType<TEventMap> = JourneyFullEventType<TEventMap>, TUsed extends JourneyToBuilderUsage = JourneyToBuilderUnused> = {
+    readonly _candidate: JourneyBuilderCandidate<TContext, TStepId, TEventMap, THandlers, TEventType>;
+    when: TUsed["when"] extends true ? JourneyDuplicateModifierCall<"when"> : (guard: JourneyBuilderGuard<TContext, TStepId, TEventMap, THandlers, TEventType>) => JourneyToBuilder<TContext, TStepId, TEventMap, THandlers, TEventType, Omit<TUsed, "when"> & {
+        readonly when: true;
+    }>;
+    updateContext: TUsed["updateContext"] extends true ? JourneyDuplicateModifierCall<"updateContext"> : (fn: JourneyBuilderUpdateContext<TContext, TStepId, TEventMap, TEventType>) => JourneyToBuilder<TContext, TStepId, TEventMap, THandlers, TEventType, Omit<TUsed, "updateContext"> & {
+        readonly updateContext: true;
+    }>;
+    onEnter: TUsed["onEnter"] extends true ? JourneyDuplicateModifierCall<"onEnter"> : (fn: JourneyBuilderLifecycle<TContext, TStepId, TEventMap, THandlers>) => JourneyToBuilder<TContext, TStepId, TEventMap, THandlers, TEventType, Omit<TUsed, "onEnter"> & {
+        readonly onEnter: true;
+    }>;
+    onLeave: TUsed["onLeave"] extends true ? JourneyDuplicateModifierCall<"onLeave"> : (fn: JourneyBuilderLifecycle<TContext, TStepId, TEventMap, THandlers>) => JourneyToBuilder<TContext, TStepId, TEventMap, THandlers, TEventType, Omit<TUsed, "onLeave"> & {
+        readonly onLeave: true;
+    }>;
+    label: TUsed["label"] extends true ? JourneyDuplicateModifierCall<"label"> : (label: string) => JourneyToBuilder<TContext, TStepId, TEventMap, THandlers, TEventType, Omit<TUsed, "label"> & {
+        readonly label: true;
+    }>;
+    timeoutMs: TUsed["timeoutMs"] extends true ? JourneyDuplicateModifierCall<"timeoutMs"> : (ms: number) => JourneyToBuilder<TContext, TStepId, TEventMap, THandlers, TEventType, Omit<TUsed, "timeoutMs"> & {
+        readonly timeoutMs: true;
+    }>;
+};
+type JourneyBuiltTransitionCandidate<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>, TEventType extends JourneyFullEventType<TEventMap> = JourneyFullEventType<TEventMap>> = {
+    readonly _candidate: JourneyBuilderCandidate<TContext, TStepId, TEventMap, THandlers, TEventType>;
+};
+export type JourneyBuilderOnEntry<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>, TEventType extends JourneyBuilderStepEventKey<TEventMap>> = readonly JourneyBuiltTransitionCandidate<TContext, TStepId, TEventMap, THandlers>[] | ((helpers: {
+    to: (stepId: TStepId) => JourneyToBuilder<TContext, TStepId, TEventMap, THandlers, TEventType>;
+}) => readonly JourneyBuiltTransitionCandidate<TContext, TStepId, TEventMap, THandlers, TEventType>[]);
+export type JourneyBuilderTerminalCandidate<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>, TEventType extends JourneyBuilderTerminalEventKey<TEventMap>> = {
+    when?: JourneyBuilderGuard<TContext, TStepId, TEventMap, THandlers, TEventType>;
+    updateContext?: JourneyBuilderUpdateContext<TContext, TStepId, TEventMap, TEventType>;
+    onEnter?: JourneyBuilderLifecycle<TContext, TStepId, TEventMap, THandlers>;
+    onLeave?: JourneyBuilderLifecycle<TContext, TStepId, TEventMap, THandlers>;
+    label?: string;
+    timeoutMs?: number;
+};
+export type JourneyBuilderTerminalEntry<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>, TEventType extends JourneyBuilderTerminalEventKey<TEventMap>> = true | readonly [] | readonly JourneyBuilderTerminalCandidate<TContext, TStepId, TEventMap, THandlers, TEventType>[];
+type JourneyBuilderEventEntry<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>, TEventType extends JourneyFullEventType<TEventMap>> = TEventType extends JourneyBuilderTerminalEventKey<TEventMap> ? JourneyBuilderTerminalEntry<TContext, TStepId, TEventMap, THandlers, TEventType> : JourneyBuilderOnEntry<TContext, TStepId, TEventMap, THandlers, Extract<TEventType, JourneyBuilderStepEventKey<TEventMap>>>;
+type JourneyStepBuilderOnConfig<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>> = Partial<{
+    [TEventType in JourneyFullEventType<TEventMap>]: JourneyBuilderEventEntry<TContext, TStepId, TEventMap, THandlers, TEventType>;
+}>;
+type JourneyStepBuilderHandledCustomEventKey<TEventMap extends Record<string, unknown>, TOn> = Extract<keyof NonNullable<TOn>, JourneyBuilderCustomEventKey<TEventMap>>;
+type JourneyStepBuilderConfig<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, TStepMeta, THandlers extends Record<string, unknown>, TOn extends JourneyStepBuilderOnConfig<TContext, TStepId, TEventMap, THandlers> | undefined = JourneyStepBuilderOnConfig<TContext, TStepId, TEventMap, THandlers> | undefined> = {
+    meta?: TStepMeta;
+    onEnter?: JourneyStepLifecycleCallback<TContext, TStepId, TEventMap, THandlers>;
+    onLeave?: JourneyStepLifecycleCallback<TContext, TStepId, TEventMap, THandlers>;
+    on?: TOn;
+};
+export type JourneyStepBuilder<TContext extends JourneyJsonObject, TStepId extends string, TStepKey extends TStepId, TEventMap extends Record<string, unknown>, TStepMeta, THandlers extends Record<string, unknown>, THandledCustomEventType extends JourneyBuilderCustomEventKey<TEventMap> = never> = {
+    readonly id: TStepKey;
+    readonly _meta: TStepMeta | undefined;
+    readonly _onEnter: JourneyStepLifecycleCallback<TContext, TStepId, TEventMap, THandlers> | undefined;
+    readonly _onLeave: JourneyStepLifecycleCallback<TContext, TStepId, TEventMap, THandlers> | undefined;
+    readonly _on: Record<string, JourneyBuilderEventEntry<TContext, TStepId, TEventMap, THandlers, JourneyFullEventType<TEventMap>>> | undefined;
+    readonly _handledCustomEventType?: THandledCustomEventType;
+};
+type JourneyStepBuilderHandledCustomEventMap<TStepId extends string, TEventMap extends Record<string, unknown>, TSteps extends readonly {
+    readonly id: TStepId;
+    readonly _handledCustomEventType?: JourneyBuilderCustomEventKey<TEventMap>;
+}[]> = {
+    [TCurrentStepId in TStepId]: Extract<Extract<TSteps[number], {
+        readonly id: TCurrentStepId;
+    }> extends {
+        readonly _handledCustomEventType?: infer THandledCustomEventType;
+    } ? THandledCustomEventType : never, JourneyBuilderCustomEventKey<TEventMap>>;
+};
+type JourneyBuilderGlobalHandledCustomEventKey<TEventMap extends Record<string, unknown>, TGlobal> = Extract<keyof NonNullable<TGlobal>, JourneyBuilderCustomEventKey<TEventMap>>;
+declare const journeyBuilderDefinitionBrand: unique symbol;
+export type JourneyBuilderDefinitionMetadata<TStepId extends string, TEventMap extends Record<string, unknown>, TStepHandledCustomEventMap extends Record<TStepId, JourneyBuilderCustomEventKey<TEventMap>> = Record<TStepId, never>, TGlobalHandledCustomEventType extends JourneyBuilderCustomEventKey<TEventMap> = never> = {
+    readonly [journeyBuilderDefinitionBrand]?: {
+        readonly stepHandledCustomEvents: TStepHandledCustomEventMap;
+        readonly globalHandledCustomEvents: TGlobalHandledCustomEventType;
+    };
+};
+export type JourneyBuilderDefinition<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, TStepMeta = unknown, THandlers extends Record<string, unknown> = Record<never, never>, TStepHandledCustomEventMap extends Record<TStepId, JourneyBuilderCustomEventKey<TEventMap>> = Record<TStepId, never>, TGlobalHandledCustomEventType extends JourneyBuilderCustomEventKey<TEventMap> = never> = JourneyDefinition<TContext, TStepId, TEventMap, TStepMeta, THandlers> & JourneyBuilderDefinitionMetadata<TStepId, TEventMap, TStepHandledCustomEventMap, TGlobalHandledCustomEventType>;
+type JourneyBuilderGlobalConfig<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>> = Partial<{
+    [TEventType in JourneyFullEventType<TEventMap>]: TEventType extends JourneyBuilderTerminalEventKey<TEventMap> ? JourneyBuilderTerminalEntry<TContext, TStepId, TEventMap, THandlers, TEventType> : readonly JourneyBuiltTransitionCandidate<TContext, TStepId, TEventMap, THandlers>[];
+}>;
+type JourneyBuilderBuildInput<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, TStepMeta, THandlers extends Record<string, unknown>, TSteps extends readonly JourneyStepBuilder<TContext, TStepId, TStepId, TEventMap, TStepMeta, THandlers, JourneyBuilderCustomEventKey<TEventMap>>[], TGlobal extends JourneyBuilderGlobalConfig<TContext, TStepId, TEventMap, THandlers> | undefined = JourneyBuilderGlobalConfig<TContext, TStepId, TEventMap, THandlers> | undefined> = {
+    initial: TStepId;
+    context: TContext;
+    handlers?: THandlers;
+    steps: TSteps;
+    global?: TGlobal;
+};
+export type JourneyBuilder<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>, TStepMeta = unknown, THandlers extends Record<string, unknown> = Record<never, never>> = {
+    createStep: <TStepKey extends TStepId, TOn extends JourneyStepBuilderOnConfig<TContext, TStepId, TEventMap, THandlers> | undefined = JourneyStepBuilderOnConfig<TContext, TStepId, TEventMap, THandlers> | undefined>(id: TStepKey, config?: JourneyStepBuilderConfig<TContext, TStepId, TEventMap, TStepMeta, THandlers, TOn>) => JourneyStepBuilder<TContext, TStepId, TStepKey, TEventMap, TStepMeta, THandlers, JourneyStepBuilderHandledCustomEventKey<TEventMap, TOn>>;
+    to: (stepId: TStepId) => JourneyToBuilder<TContext, TStepId, TEventMap, THandlers>;
+    build: <TSteps extends readonly JourneyStepBuilder<TContext, TStepId, TStepId, TEventMap, TStepMeta, THandlers, JourneyBuilderCustomEventKey<TEventMap>>[], TGlobal extends JourneyBuilderGlobalConfig<TContext, TStepId, TEventMap, THandlers> | undefined = JourneyBuilderGlobalConfig<TContext, TStepId, TEventMap, THandlers> | undefined>(input: JourneyBuilderBuildInput<TContext, TStepId, TEventMap, TStepMeta, THandlers, TSteps, TGlobal>) => JourneyBuilderDefinition<TContext, TStepId, TEventMap, TStepMeta, THandlers, JourneyStepBuilderHandledCustomEventMap<TStepId, TEventMap, TSteps>, JourneyBuilderGlobalHandledCustomEventKey<TEventMap, TGlobal>>;
+};
+export type { JourneyStepBuilderConfig as _JourneyStepBuilderConfig, JourneyBuilderBuildInput as _JourneyBuilderBuildInput, JourneyBuilderEventEntry as _JourneyBuilderEventEntry };

package/dist/journey-machine/async-state.d.cts

@@ -0,0 +1,12 @@
+import type { JourneyAsyncPhase, JourneyAsyncState, JourneyJsonObject } from "../types";
+import type { JourneyMachineRuntime } from "./runtime";
+export type JourneyMachineAsyncStateController<TStepId extends string> = {
+    syncState: (asyncState: JourneyAsyncState<TStepId>) => void;
+    updateStepAsync: (stepId: TStepId, updater: (current: JourneyAsyncState<TStepId>["byStep"][TStepId]) => JourneyAsyncState<TStepId>["byStep"][TStepId], runVersion?: number) => void;
+    setStepLoading: (stepId: TStepId, phase: JourneyAsyncPhase, eventType: string, transitionId?: string, runVersion?: number) => void;
+    setStepIdle: (stepId: TStepId, runVersion?: number) => void;
+    setStepError: (stepId: TStepId, eventType: string, error: unknown, transitionId?: string, runVersion?: number) => void;
+};
+export declare const createJourneyMachineAsyncStateController: <TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>>({ runtime }: {
+    runtime: JourneyMachineRuntime<TContext, TStepId, TEventMap>;
+}) => JourneyMachineAsyncStateController<TStepId>;

package/dist/journey-machine/async-state.d.ts

@@ -0,0 +1,12 @@
+import type { JourneyAsyncPhase, JourneyAsyncState, JourneyJsonObject } from "../types";
+import type { JourneyMachineRuntime } from "./runtime";
+export type JourneyMachineAsyncStateController<TStepId extends string> = {
+    syncState: (asyncState: JourneyAsyncState<TStepId>) => void;
+    updateStepAsync: (stepId: TStepId, updater: (current: JourneyAsyncState<TStepId>["byStep"][TStepId]) => JourneyAsyncState<TStepId>["byStep"][TStepId], runVersion?: number) => void;
+    setStepLoading: (stepId: TStepId, phase: JourneyAsyncPhase, eventType: string, transitionId?: string, runVersion?: number) => void;
+    setStepIdle: (stepId: TStepId, runVersion?: number) => void;
+    setStepError: (stepId: TStepId, eventType: string, error: unknown, transitionId?: string, runVersion?: number) => void;
+};
+export declare const createJourneyMachineAsyncStateController: <TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>>({ runtime }: {
+    runtime: JourneyMachineRuntime<TContext, TStepId, TEventMap>;
+}) => JourneyMachineAsyncStateController<TStepId>;

package/dist/journey-machine/computed.d.cts

@@ -0,0 +1,2 @@
+import type { JourneyComputed, JourneyDefinition, JourneyJsonObject, JourneyResolvedDefinition, JourneySnapshot } from "../types";
+export declare const createJourneyMachineComputedGetter: <TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, TStepMeta, THandlers extends Record<string, unknown>>(journey: JourneyDefinition<TContext, TStepId, TEventMap, TStepMeta, THandlers>, resolvedJourney: JourneyResolvedDefinition<TContext, TStepId, TEventMap, TStepMeta, THandlers>, getSnapshot: () => JourneySnapshot<TContext, TStepId>) => (() => JourneyComputed<TStepId>);

package/dist/journey-machine/computed.d.ts

@@ -0,0 +1,2 @@
+import type { JourneyComputed, JourneyDefinition, JourneyJsonObject, JourneyResolvedDefinition, JourneySnapshot } from "../types";
+export declare const createJourneyMachineComputedGetter: <TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, TStepMeta, THandlers extends Record<string, unknown>>(journey: JourneyDefinition<TContext, TStepId, TEventMap, TStepMeta, THandlers>, resolvedJourney: JourneyResolvedDefinition<TContext, TStepId, TEventMap, TStepMeta, THandlers>, getSnapshot: () => JourneySnapshot<TContext, TStepId>) => (() => JourneyComputed<TStepId>);

package/dist/journey-machine/controls.d.cts

@@ -0,0 +1,17 @@
+import type { JourneyJsonObject, JourneySnapshot } from "../types";
+import type { JourneyMachineAsyncStateController } from "./async-state";
+import type { JourneyMachineRuntime } from "./runtime";
+export type JourneyMachineControls<TContext extends JourneyJsonObject, TStepId extends string> = {
+    startJourney: () => Promise<JourneySnapshot<TContext, TStepId>>;
+    resetJourney: () => Promise<JourneySnapshot<TContext, TStepId>>;
+    updateContext: (updater: (context: TContext) => TContext) => Promise<JourneySnapshot<TContext, TStepId>>;
+    clearStepError: (stepId?: TStepId) => Promise<JourneySnapshot<TContext, TStepId>>;
+    dispose: () => void;
+};
+export declare const createJourneyMachineControls: <TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>>({ runtime, asyncState, initial, initialContext, steps }: {
+    runtime: JourneyMachineRuntime<TContext, TStepId, TEventMap>;
+    asyncState: JourneyMachineAsyncStateController<TStepId>;
+    initial: TStepId;
+    initialContext: TContext;
+    steps: Record<TStepId, unknown>;
+}) => JourneyMachineControls<TContext, TStepId>;

package/dist/journey-machine/controls.d.ts

@@ -0,0 +1,17 @@
+import type { JourneyJsonObject, JourneySnapshot } from "../types";
+import type { JourneyMachineAsyncStateController } from "./async-state";
+import type { JourneyMachineRuntime } from "./runtime";
+export type JourneyMachineControls<TContext extends JourneyJsonObject, TStepId extends string> = {
+    startJourney: () => Promise<JourneySnapshot<TContext, TStepId>>;
+    resetJourney: () => Promise<JourneySnapshot<TContext, TStepId>>;
+    updateContext: (updater: (context: TContext) => TContext) => Promise<JourneySnapshot<TContext, TStepId>>;
+    clearStepError: (stepId?: TStepId) => Promise<JourneySnapshot<TContext, TStepId>>;
+    dispose: () => void;
+};
+export declare const createJourneyMachineControls: <TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>>({ runtime, asyncState, initial, initialContext, steps }: {
+    runtime: JourneyMachineRuntime<TContext, TStepId, TEventMap>;
+    asyncState: JourneyMachineAsyncStateController<TStepId>;
+    initial: TStepId;
+    initialContext: TContext;
+    steps: Record<TStepId, unknown>;
+}) => JourneyMachineControls<TContext, TStepId>;

package/dist/journey-machine/helpers.d.cts

@@ -0,0 +1,52 @@
+import type { JourneyAsyncState, JourneyEvent, JourneyGoToEvent, JourneyJsonObject, JourneyPayloadFor, JourneyResolvedTransition, JourneySendEvent, JourneySendResult, JourneySnapshot, JourneyStatus, JourneyStepAsyncState, JourneyTerminal, JourneyTransition, JourneyTransitionArgs } from "../types";
+export declare const assertStepExists: <TStepId extends string>(steps: Record<TStepId, unknown>, stepId: TStepId, message: string) => void;
+export declare const isPlainObject: (value: unknown) => value is Record<string, unknown>;
+export declare function assertSerializableContext<TContext extends JourneyJsonObject>(context: TContext, label?: string): TContext;
+export declare const cloneContext: <TContext extends JourneyJsonObject>(context: TContext) => TContext;
+export declare const cloneMetaValue: <T>(value: T) => T;
+export declare const normalizeStepCount: (steps?: number) => number;
+export declare const now: () => number;
+export declare const buildVisitedFromTimeline: <TStepId extends string>(timeline: readonly TStepId[], stepIds?: readonly TStepId[]) => Record<TStepId, boolean>;
+export declare const appendVisited: <TStepId extends string>(visited: Record<TStepId, boolean>, current: TStepId) => Record<TStepId, boolean>;
+export declare const isPromiseLike: <T>(value: T | PromiseLike<T>) => value is PromiseLike<T>;
+export declare const validateFiniteTimeout: (timeoutMs: unknown, label: string) => void;
+export declare class JourneyTimeoutError extends Error {
+    name: string;
+    constructor(message: string);
+}
+export declare class JourneyDisposedError extends Error {
+    name: string;
+    readonly operation: string;
+    constructor(operation: string);
+}
+export declare const isDevelopmentEnvironment: () => boolean;
+export declare const warnInDevelopment: (message: string, detail?: unknown) => void;
+export declare const errorInDevelopment: (message: string, detail?: unknown) => void;
+export declare const withTimeout: <T>(promise: PromiseLike<T>, timeoutMs: number | undefined, buildError: () => Error) => Promise<T>;
+export declare const withAbortSignal: <T>(promise: PromiseLike<T>, signal: AbortSignal) => Promise<T>;
+export declare const buildIdleStepAsyncState: () => JourneyStepAsyncState;
+export declare const buildInitialAsyncState: <TStepId extends string>(steps: Record<TStepId, unknown>) => JourneyAsyncState<TStepId>;
+export declare const isGoToStepByIdEvent: <TStepId extends string, TEventMap extends Record<string, unknown>>(event: JourneySendEvent<TStepId, TEventMap>) => event is JourneyGoToEvent<TStepId, JourneyPayloadFor<TEventMap, "goToStepById">>;
+export declare const isTerminalTarget: <TStepId extends string>(target: TStepId | JourneyTerminal) => target is JourneyTerminal;
+export declare const resolveTransitionTarget: <TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>>(transition: JourneyTransition<TContext, TStepId, TEventMap, THandlers>) => TStepId | JourneyTerminal;
+export declare const validateJourneyTransitions: <TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>>(transitions: readonly JourneyResolvedTransition<TContext, TStepId, TEventMap, THandlers>[], steps: Record<TStepId, unknown>) => void;
+export declare const buildSendResult: <TContext extends JourneyJsonObject, TStepId extends string>(snapshot: JourneySnapshot<TContext, TStepId>, transitioned: boolean, options?: {
+    transitionId?: string;
+    label?: string;
+    error?: unknown;
+}) => JourneySendResult<TContext, TStepId>;
+export declare const buildSnapshot: <TContext extends JourneyJsonObject, TStepId extends string>(timeline: readonly TStepId[], index: number, context: TContext, status: JourneyStatus, asyncState: JourneyAsyncState<TStepId>, visited?: Record<TStepId, boolean>) => JourneySnapshot<TContext, TStepId>;
+export declare const stabilizeSnapshot: <TContext extends JourneyJsonObject, TStepId extends string>(snapshot: JourneySnapshot<TContext, TStepId>) => JourneySnapshot<TContext, TStepId>;
+export declare const selectTransition: <TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>, TTransition extends {
+    from: TStepId | "*";
+    event: string;
+    when?: (args: JourneyTransitionArgs<TContext, TStepId, TEventMap, THandlers>) => boolean | Promise<boolean>;
+    timeoutMs?: number;
+    id?: string;
+    label?: string;
+}>(transitions: readonly TTransition[], snapshot: JourneySnapshot<TContext, TStepId>, event: JourneyEvent<TStepId, TEventMap>, signal: AbortSignal, handlers: THandlers, hooks?: {
+    onAsyncGuardStart?: (transition: TTransition) => void;
+    onAsyncGuardSuccess?: (transition: TTransition) => void;
+    onAsyncGuardError?: (transition: TTransition, error: unknown) => void;
+}, defaultTimeoutMs?: number) => Promise<TTransition | null>;
+export declare const transitionSnapshot: <TContext extends JourneyJsonObject, TStepId extends string>(snapshot: JourneySnapshot<TContext, TStepId>, nextCurrent: TStepId, nextContext: TContext) => JourneySnapshot<TContext, TStepId>;

package/dist/journey-machine/helpers.d.ts

@@ -0,0 +1,52 @@
+import type { JourneyAsyncState, JourneyEvent, JourneyGoToEvent, JourneyJsonObject, JourneyPayloadFor, JourneyResolvedTransition, JourneySendEvent, JourneySendResult, JourneySnapshot, JourneyStatus, JourneyStepAsyncState, JourneyTerminal, JourneyTransition, JourneyTransitionArgs } from "../types";
+export declare const assertStepExists: <TStepId extends string>(steps: Record<TStepId, unknown>, stepId: TStepId, message: string) => void;
+export declare const isPlainObject: (value: unknown) => value is Record<string, unknown>;
+export declare function assertSerializableContext<TContext extends JourneyJsonObject>(context: TContext, label?: string): TContext;
+export declare const cloneContext: <TContext extends JourneyJsonObject>(context: TContext) => TContext;
+export declare const cloneMetaValue: <T>(value: T) => T;
+export declare const normalizeStepCount: (steps?: number) => number;
+export declare const now: () => number;
+export declare const buildVisitedFromTimeline: <TStepId extends string>(timeline: readonly TStepId[], stepIds?: readonly TStepId[]) => Record<TStepId, boolean>;
+export declare const appendVisited: <TStepId extends string>(visited: Record<TStepId, boolean>, current: TStepId) => Record<TStepId, boolean>;
+export declare const isPromiseLike: <T>(value: T | PromiseLike<T>) => value is PromiseLike<T>;
+export declare const validateFiniteTimeout: (timeoutMs: unknown, label: string) => void;
+export declare class JourneyTimeoutError extends Error {
+    name: string;
+    constructor(message: string);
+}
+export declare class JourneyDisposedError extends Error {
+    name: string;
+    readonly operation: string;
+    constructor(operation: string);
+}
+export declare const isDevelopmentEnvironment: () => boolean;
+export declare const warnInDevelopment: (message: string, detail?: unknown) => void;
+export declare const errorInDevelopment: (message: string, detail?: unknown) => void;
+export declare const withTimeout: <T>(promise: PromiseLike<T>, timeoutMs: number | undefined, buildError: () => Error) => Promise<T>;
+export declare const withAbortSignal: <T>(promise: PromiseLike<T>, signal: AbortSignal) => Promise<T>;
+export declare const buildIdleStepAsyncState: () => JourneyStepAsyncState;
+export declare const buildInitialAsyncState: <TStepId extends string>(steps: Record<TStepId, unknown>) => JourneyAsyncState<TStepId>;
+export declare const isGoToStepByIdEvent: <TStepId extends string, TEventMap extends Record<string, unknown>>(event: JourneySendEvent<TStepId, TEventMap>) => event is JourneyGoToEvent<TStepId, JourneyPayloadFor<TEventMap, "goToStepById">>;
+export declare const isTerminalTarget: <TStepId extends string>(target: TStepId | JourneyTerminal) => target is JourneyTerminal;
+export declare const resolveTransitionTarget: <TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>>(transition: JourneyTransition<TContext, TStepId, TEventMap, THandlers>) => TStepId | JourneyTerminal;
+export declare const validateJourneyTransitions: <TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>>(transitions: readonly JourneyResolvedTransition<TContext, TStepId, TEventMap, THandlers>[], steps: Record<TStepId, unknown>) => void;
+export declare const buildSendResult: <TContext extends JourneyJsonObject, TStepId extends string>(snapshot: JourneySnapshot<TContext, TStepId>, transitioned: boolean, options?: {
+    transitionId?: string;
+    label?: string;
+    error?: unknown;
+}) => JourneySendResult<TContext, TStepId>;
+export declare const buildSnapshot: <TContext extends JourneyJsonObject, TStepId extends string>(timeline: readonly TStepId[], index: number, context: TContext, status: JourneyStatus, asyncState: JourneyAsyncState<TStepId>, visited?: Record<TStepId, boolean>) => JourneySnapshot<TContext, TStepId>;
+export declare const stabilizeSnapshot: <TContext extends JourneyJsonObject, TStepId extends string>(snapshot: JourneySnapshot<TContext, TStepId>) => JourneySnapshot<TContext, TStepId>;
+export declare const selectTransition: <TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>, TTransition extends {
+    from: TStepId | "*";
+    event: string;
+    when?: (args: JourneyTransitionArgs<TContext, TStepId, TEventMap, THandlers>) => boolean | Promise<boolean>;
+    timeoutMs?: number;
+    id?: string;
+    label?: string;
+}>(transitions: readonly TTransition[], snapshot: JourneySnapshot<TContext, TStepId>, event: JourneyEvent<TStepId, TEventMap>, signal: AbortSignal, handlers: THandlers, hooks?: {
+    onAsyncGuardStart?: (transition: TTransition) => void;
+    onAsyncGuardSuccess?: (transition: TTransition) => void;
+    onAsyncGuardError?: (transition: TTransition, error: unknown) => void;
+}, defaultTimeoutMs?: number) => Promise<TTransition | null>;
+export declare const transitionSnapshot: <TContext extends JourneyJsonObject, TStepId extends string>(snapshot: JourneySnapshot<TContext, TStepId>, nextCurrent: TStepId, nextContext: TContext) => JourneySnapshot<TContext, TStepId>;

package/dist/journey-machine/index.d.cts

@@ -0,0 +1,3 @@
+import type { JourneyDefinition, JourneyJsonObject, JourneyMachinePlugin, JourneyMachineOptions, JourneyMachineWithPlugins } from "../types";
+/** Creates a journey machine from a definition and optional runtime/plugin options. */
+export declare function createJourneyMachine<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>, TStepMeta = unknown, THandlers extends Record<string, unknown> = Record<never, never>, TPlugins extends readonly JourneyMachinePlugin[] = []>(journey: JourneyDefinition<TContext, TStepId, TEventMap, TStepMeta, THandlers>, options?: JourneyMachineOptions<TPlugins>): JourneyMachineWithPlugins<TContext, TStepId, TEventMap, TStepMeta, THandlers, TPlugins>;

package/dist/journey-machine/index.d.ts

@@ -0,0 +1,3 @@
+import type { JourneyDefinition, JourneyJsonObject, JourneyMachinePlugin, JourneyMachineOptions, JourneyMachineWithPlugins } from "../types";
+/** Creates a journey machine from a definition and optional runtime/plugin options. */
+export declare function createJourneyMachine<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>, TStepMeta = unknown, THandlers extends Record<string, unknown> = Record<never, never>, TPlugins extends readonly JourneyMachinePlugin[] = []>(journey: JourneyDefinition<TContext, TStepId, TEventMap, TStepMeta, THandlers>, options?: JourneyMachineOptions<TPlugins>): JourneyMachineWithPlugins<TContext, TStepId, TEventMap, TStepMeta, THandlers, TPlugins>;

package/dist/journey-machine/navigation.d.cts

@@ -0,0 +1,32 @@
+import type { JourneyEvent, JourneyJsonObject, JourneyResolvedTransition, JourneySendResult, JourneySnapshot, JourneyTerminal } from "../types";
+import type { JourneyMachineRuntime } from "./runtime";
+export type JourneyLifecycleScheduler<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>> = (args: {
+    previousSnapshot: JourneySnapshot<TContext, TStepId>;
+    snapshot: JourneySnapshot<TContext, TStepId>;
+    from: TStepId;
+    to: TStepId | JourneyTerminal;
+    event: JourneyEvent<TStepId, TEventMap> | {
+        type: "goToLastVisitedStep";
+    } | {
+        type: "goToPreviousStep";
+    };
+    transitionId: string | null;
+    label?: string;
+    runVersion: number;
+    transition?: JourneyResolvedTransition<TContext, TStepId, TEventMap, THandlers>;
+}) => void;
+export type JourneyMachineNavigationController<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>> = {
+    applyPreviousNavigation: (requestedSteps?: number, transitionId?: string, runVersion?: number) => JourneySendResult<TContext, TStepId>;
+    applyLastVisitedNavigation: (transitionId?: string, runVersion?: number) => JourneySendResult<TContext, TStepId>;
+    hasDeclaredTransitionForEvent: (fromStep: TStepId, eventType: string) => boolean;
+    commitTerminalTransition: (fromStep: TStepId, target: JourneyTerminal, transitionEvent: {
+        type: string;
+    }, transitionId: string | null, transition: JourneyResolvedTransition<TContext, TStepId, TEventMap, THandlers> | undefined, nextContext: TContext, runVersion?: number) => JourneySendResult<TContext, TStepId>;
+    commitStepTransition: (fromStep: TStepId, target: TStepId, transitionEvent: JourneyEvent<TStepId, TEventMap>, transition: JourneyResolvedTransition<TContext, TStepId, TEventMap, THandlers>, nextContext: TContext, runVersion?: number) => JourneySendResult<TContext, TStepId>;
+};
+export declare const createJourneyMachineNavigationController: <TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>>({ runtime, steps, transitions, scheduleLifecycle }: {
+    runtime: JourneyMachineRuntime<TContext, TStepId, TEventMap>;
+    steps: Record<TStepId, unknown>;
+    transitions: readonly JourneyResolvedTransition<TContext, TStepId, TEventMap, THandlers>[];
+    scheduleLifecycle: JourneyLifecycleScheduler<TContext, TStepId, TEventMap, THandlers>;
+}) => JourneyMachineNavigationController<TContext, TStepId, TEventMap, THandlers>;

package/dist/journey-machine/navigation.d.ts

@@ -0,0 +1,32 @@
+import type { JourneyEvent, JourneyJsonObject, JourneyResolvedTransition, JourneySendResult, JourneySnapshot, JourneyTerminal } from "../types";
+import type { JourneyMachineRuntime } from "./runtime";
+export type JourneyLifecycleScheduler<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>> = (args: {
+    previousSnapshot: JourneySnapshot<TContext, TStepId>;
+    snapshot: JourneySnapshot<TContext, TStepId>;
+    from: TStepId;
+    to: TStepId | JourneyTerminal;
+    event: JourneyEvent<TStepId, TEventMap> | {
+        type: "goToLastVisitedStep";
+    } | {
+        type: "goToPreviousStep";
+    };
+    transitionId: string | null;
+    label?: string;
+    runVersion: number;
+    transition?: JourneyResolvedTransition<TContext, TStepId, TEventMap, THandlers>;
+}) => void;
+export type JourneyMachineNavigationController<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>> = {
+    applyPreviousNavigation: (requestedSteps?: number, transitionId?: string, runVersion?: number) => JourneySendResult<TContext, TStepId>;
+    applyLastVisitedNavigation: (transitionId?: string, runVersion?: number) => JourneySendResult<TContext, TStepId>;
+    hasDeclaredTransitionForEvent: (fromStep: TStepId, eventType: string) => boolean;
+    commitTerminalTransition: (fromStep: TStepId, target: JourneyTerminal, transitionEvent: {
+        type: string;
+    }, transitionId: string | null, transition: JourneyResolvedTransition<TContext, TStepId, TEventMap, THandlers> | undefined, nextContext: TContext, runVersion?: number) => JourneySendResult<TContext, TStepId>;
+    commitStepTransition: (fromStep: TStepId, target: TStepId, transitionEvent: JourneyEvent<TStepId, TEventMap>, transition: JourneyResolvedTransition<TContext, TStepId, TEventMap, THandlers>, nextContext: TContext, runVersion?: number) => JourneySendResult<TContext, TStepId>;
+};
+export declare const createJourneyMachineNavigationController: <TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>>({ runtime, steps, transitions, scheduleLifecycle }: {
+    runtime: JourneyMachineRuntime<TContext, TStepId, TEventMap>;
+    steps: Record<TStepId, unknown>;
+    transitions: readonly JourneyResolvedTransition<TContext, TStepId, TEventMap, THandlers>[];
+    scheduleLifecycle: JourneyLifecycleScheduler<TContext, TStepId, TEventMap, THandlers>;
+}) => JourneyMachineNavigationController<TContext, TStepId, TEventMap, THandlers>;

package/dist/journey-machine/plugin-controller.d.cts

@@ -0,0 +1,15 @@
+import type { JourneyJsonObject, JourneyMachine, JourneyMachinePlugin, JourneyMachinePluginSetupContext, JourneyMachineSnapshotReason, JourneySnapshot } from "../types";
+export type JourneyMachinePluginController<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, TStepMeta, THandlers extends Record<string, unknown>> = {
+    hydrateSnapshot: (snapshot: JourneySnapshot<TContext, TStepId>) => JourneySnapshot<TContext, TStepId>;
+    onSnapshotChange: (args: {
+        previousSnapshot: JourneySnapshot<TContext, TStepId>;
+        snapshot: JourneySnapshot<TContext, TStepId>;
+        reason: JourneyMachineSnapshotReason;
+    }) => void;
+    extendMachine: (machine: JourneyMachine<TContext, TStepId, TEventMap, TStepMeta, THandlers>) => JourneyMachine<TContext, TStepId, TEventMap, TStepMeta, THandlers>;
+    dispose: () => void;
+};
+export declare const createJourneyMachinePluginController: <TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, TStepMeta, THandlers extends Record<string, unknown> = Record<never, never>>({ plugins, setupContext }: {
+    plugins: readonly JourneyMachinePlugin[];
+    setupContext: JourneyMachinePluginSetupContext<TContext, TStepId, TEventMap, TStepMeta, THandlers>;
+}) => JourneyMachinePluginController<TContext, TStepId, TEventMap, TStepMeta, THandlers>;

package/dist/journey-machine/plugin-controller.d.ts

@@ -0,0 +1,15 @@
+import type { JourneyJsonObject, JourneyMachine, JourneyMachinePlugin, JourneyMachinePluginSetupContext, JourneyMachineSnapshotReason, JourneySnapshot } from "../types";
+export type JourneyMachinePluginController<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, TStepMeta, THandlers extends Record<string, unknown>> = {
+    hydrateSnapshot: (snapshot: JourneySnapshot<TContext, TStepId>) => JourneySnapshot<TContext, TStepId>;
+    onSnapshotChange: (args: {
+        previousSnapshot: JourneySnapshot<TContext, TStepId>;
+        snapshot: JourneySnapshot<TContext, TStepId>;
+        reason: JourneyMachineSnapshotReason;
+    }) => void;
+    extendMachine: (machine: JourneyMachine<TContext, TStepId, TEventMap, TStepMeta, THandlers>) => JourneyMachine<TContext, TStepId, TEventMap, TStepMeta, THandlers>;
+    dispose: () => void;
+};
+export declare const createJourneyMachinePluginController: <TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, TStepMeta, THandlers extends Record<string, unknown> = Record<never, never>>({ plugins, setupContext }: {
+    plugins: readonly JourneyMachinePlugin[];
+    setupContext: JourneyMachinePluginSetupContext<TContext, TStepId, TEventMap, TStepMeta, THandlers>;
+}) => JourneyMachinePluginController<TContext, TStepId, TEventMap, TStepMeta, THandlers>;

package/dist/journey-machine/resolve-journey-definition.d.cts

@@ -0,0 +1,2 @@
+import type { JourneyDefinition, JourneyJsonObject, JourneyResolvedDefinition } from "../types";
+export declare const resolveJourneyDefinition: <TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, TStepMeta = unknown, THandlers extends Record<string, unknown> = Record<never, never>>(journey: JourneyDefinition<TContext, TStepId, TEventMap, TStepMeta, THandlers>) => JourneyResolvedDefinition<TContext, TStepId, TEventMap, TStepMeta, THandlers>;

package/dist/journey-machine/resolve-journey-definition.d.ts

@@ -0,0 +1,2 @@
+import type { JourneyDefinition, JourneyJsonObject, JourneyResolvedDefinition } from "../types";
+export declare const resolveJourneyDefinition: <TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, TStepMeta = unknown, THandlers extends Record<string, unknown> = Record<never, never>>(journey: JourneyDefinition<TContext, TStepId, TEventMap, TStepMeta, THandlers>) => JourneyResolvedDefinition<TContext, TStepId, TEventMap, TStepMeta, THandlers>;