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

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

@@ -0,0 +1,5 @@
+import type { JourneyJsonObject } from "../types";
+import type { JourneyBuilder } from "./types";
+export type { JourneyBuilder, 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, 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,69 @@
+import type { 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 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 _id: string | undefined;
+    readonly _timeoutMs: number | undefined;
+};
+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>> = {
+    readonly _candidate: JourneyBuilderCandidate<TContext, TStepId, TEventMap, THandlers, TEventType>;
+    when(guard: JourneyBuilderGuard<TContext, TStepId, TEventMap, THandlers, TEventType>): JourneyToBuilder<TContext, TStepId, TEventMap, THandlers, TEventType>;
+    updateContext(fn: JourneyBuilderUpdateContext<TContext, TStepId, TEventMap, TEventType>): JourneyToBuilder<TContext, TStepId, TEventMap, THandlers, TEventType>;
+    onEnter(fn: JourneyBuilderLifecycle<TContext, TStepId, TEventMap, THandlers>): JourneyToBuilder<TContext, TStepId, TEventMap, THandlers, TEventType>;
+    onLeave(fn: JourneyBuilderLifecycle<TContext, TStepId, TEventMap, THandlers>): JourneyToBuilder<TContext, TStepId, TEventMap, THandlers, TEventType>;
+    id(id: string): JourneyToBuilder<TContext, TStepId, TEventMap, THandlers, TEventType>;
+    timeoutMs(ms: number): JourneyToBuilder<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 JourneyToBuilder<TContext, TStepId, TEventMap, THandlers>[] | ((helpers: {
+    to: (stepId: TStepId) => JourneyToBuilder<TContext, TStepId, TEventMap, THandlers, TEventType>;
+}) => readonly JourneyToBuilder<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>;
+    id?: 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 JourneyStepBuilderConfig<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, TStepMeta, THandlers extends Record<string, unknown>> = {
+    meta?: TStepMeta;
+    onEnter?: JourneyStepLifecycleCallback<TContext, TStepId, TEventMap, THandlers>;
+    onLeave?: JourneyStepLifecycleCallback<TContext, TStepId, TEventMap, THandlers>;
+    on?: Partial<{
+        [TEventType in JourneyFullEventType<TEventMap>]: JourneyBuilderEventEntry<TContext, TStepId, TEventMap, THandlers, TEventType>;
+    }>;
+};
+export type JourneyStepBuilder<TContext extends JourneyJsonObject, TStepId extends string, TStepKey extends TStepId, TEventMap extends Record<string, unknown>, TStepMeta, THandlers extends Record<string, unknown>> = {
+    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;
+};
+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 JourneyToBuilder<TContext, TStepId, TEventMap, THandlers>[];
+}>;
+type JourneyBuilderBuildInput<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, TStepMeta, THandlers extends Record<string, unknown>> = {
+    initial: TStepId;
+    context: TContext;
+    handlers?: THandlers;
+    steps: readonly JourneyStepBuilder<TContext, TStepId, TStepId, TEventMap, TStepMeta, THandlers>[];
+    global?: JourneyBuilderGlobalConfig<TContext, TStepId, TEventMap, THandlers>;
+};
+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>(id: TStepKey, config?: JourneyStepBuilderConfig<TContext, TStepId, TEventMap, TStepMeta, THandlers>) => JourneyStepBuilder<TContext, TStepId, TStepKey, TEventMap, TStepMeta, THandlers>;
+    to: (stepId: TStepId) => JourneyToBuilder<TContext, TStepId, TEventMap, THandlers>;
+    build: (input: JourneyBuilderBuildInput<TContext, TStepId, TEventMap, TStepMeta, THandlers>) => JourneyDefinition<TContext, TStepId, TEventMap, TStepMeta, THandlers>;
+};
+export type { JourneyStepBuilderConfig as _JourneyStepBuilderConfig, JourneyBuilderBuildInput as _JourneyBuilderBuildInput, JourneyBuilderEventEntry as _JourneyBuilderEventEntry };

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

@@ -0,0 +1,69 @@
+import type { 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 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 _id: string | undefined;
+    readonly _timeoutMs: number | undefined;
+};
+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>> = {
+    readonly _candidate: JourneyBuilderCandidate<TContext, TStepId, TEventMap, THandlers, TEventType>;
+    when(guard: JourneyBuilderGuard<TContext, TStepId, TEventMap, THandlers, TEventType>): JourneyToBuilder<TContext, TStepId, TEventMap, THandlers, TEventType>;
+    updateContext(fn: JourneyBuilderUpdateContext<TContext, TStepId, TEventMap, TEventType>): JourneyToBuilder<TContext, TStepId, TEventMap, THandlers, TEventType>;
+    onEnter(fn: JourneyBuilderLifecycle<TContext, TStepId, TEventMap, THandlers>): JourneyToBuilder<TContext, TStepId, TEventMap, THandlers, TEventType>;
+    onLeave(fn: JourneyBuilderLifecycle<TContext, TStepId, TEventMap, THandlers>): JourneyToBuilder<TContext, TStepId, TEventMap, THandlers, TEventType>;
+    id(id: string): JourneyToBuilder<TContext, TStepId, TEventMap, THandlers, TEventType>;
+    timeoutMs(ms: number): JourneyToBuilder<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 JourneyToBuilder<TContext, TStepId, TEventMap, THandlers>[] | ((helpers: {
+    to: (stepId: TStepId) => JourneyToBuilder<TContext, TStepId, TEventMap, THandlers, TEventType>;
+}) => readonly JourneyToBuilder<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>;
+    id?: 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 JourneyStepBuilderConfig<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, TStepMeta, THandlers extends Record<string, unknown>> = {
+    meta?: TStepMeta;
+    onEnter?: JourneyStepLifecycleCallback<TContext, TStepId, TEventMap, THandlers>;
+    onLeave?: JourneyStepLifecycleCallback<TContext, TStepId, TEventMap, THandlers>;
+    on?: Partial<{
+        [TEventType in JourneyFullEventType<TEventMap>]: JourneyBuilderEventEntry<TContext, TStepId, TEventMap, THandlers, TEventType>;
+    }>;
+};
+export type JourneyStepBuilder<TContext extends JourneyJsonObject, TStepId extends string, TStepKey extends TStepId, TEventMap extends Record<string, unknown>, TStepMeta, THandlers extends Record<string, unknown>> = {
+    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;
+};
+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 JourneyToBuilder<TContext, TStepId, TEventMap, THandlers>[];
+}>;
+type JourneyBuilderBuildInput<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, TStepMeta, THandlers extends Record<string, unknown>> = {
+    initial: TStepId;
+    context: TContext;
+    handlers?: THandlers;
+    steps: readonly JourneyStepBuilder<TContext, TStepId, TStepId, TEventMap, TStepMeta, THandlers>[];
+    global?: JourneyBuilderGlobalConfig<TContext, TStepId, TEventMap, THandlers>;
+};
+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>(id: TStepKey, config?: JourneyStepBuilderConfig<TContext, TStepId, TEventMap, TStepMeta, THandlers>) => JourneyStepBuilder<TContext, TStepId, TStepKey, TEventMap, TStepMeta, THandlers>;
+    to: (stepId: TStepId) => JourneyToBuilder<TContext, TStepId, TEventMap, THandlers>;
+    build: (input: JourneyBuilderBuildInput<TContext, TStepId, TEventMap, TStepMeta, THandlers>) => JourneyDefinition<TContext, TStepId, TEventMap, TStepMeta, THandlers>;
+};
+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> = {
+    start: () => 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> = {
+    start: () => 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,44 @@
+import type { JourneyAsyncState, JourneyEvent, JourneyGoToEvent, JourneyJsonObject, JourneyPayloadFor, JourneySendEvent, JourneySendResult, JourneySnapshot, JourneyStatus, JourneyStepAsyncState, JourneyTerminal, JourneyTransition } 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 JourneyTransition<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;
+    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>>(transitions: readonly JourneyTransition<TContext, TStepId, TEventMap, THandlers>[], snapshot: JourneySnapshot<TContext, TStepId>, event: JourneyEvent<TStepId, TEventMap>, signal: AbortSignal, handlers: THandlers, hooks?: {
+    onAsyncGuardStart?: (transition: JourneyTransition<TContext, TStepId, TEventMap, THandlers>) => void;
+    onAsyncGuardSuccess?: (transition: JourneyTransition<TContext, TStepId, TEventMap, THandlers>) => void;
+    onAsyncGuardError?: (transition: JourneyTransition<TContext, TStepId, TEventMap, THandlers>, error: unknown) => void;
+}, defaultTimeoutMs?: number) => Promise<JourneyTransition<TContext, TStepId, TEventMap, THandlers> | 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,44 @@
+import type { JourneyAsyncState, JourneyEvent, JourneyGoToEvent, JourneyJsonObject, JourneyPayloadFor, JourneySendEvent, JourneySendResult, JourneySnapshot, JourneyStatus, JourneyStepAsyncState, JourneyTerminal, JourneyTransition } 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 JourneyTransition<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;
+    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>>(transitions: readonly JourneyTransition<TContext, TStepId, TEventMap, THandlers>[], snapshot: JourneySnapshot<TContext, TStepId>, event: JourneyEvent<TStepId, TEventMap>, signal: AbortSignal, handlers: THandlers, hooks?: {
+    onAsyncGuardStart?: (transition: JourneyTransition<TContext, TStepId, TEventMap, THandlers>) => void;
+    onAsyncGuardSuccess?: (transition: JourneyTransition<TContext, TStepId, TEventMap, THandlers>) => void;
+    onAsyncGuardError?: (transition: JourneyTransition<TContext, TStepId, TEventMap, THandlers>, error: unknown) => void;
+}, defaultTimeoutMs?: number) => Promise<JourneyTransition<TContext, TStepId, TEventMap, THandlers> | 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,31 @@
+import type { JourneyEvent, JourneyJsonObject, JourneySendResult, JourneySnapshot, JourneyTerminal, JourneyTransition } 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;
+    runVersion: number;
+    transition?: JourneyTransition<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, nextContext: TContext, runVersion?: number) => JourneySendResult<TContext, TStepId>;
+    commitStepTransition: (fromStep: TStepId, target: TStepId, transitionEvent: JourneyEvent<TStepId, TEventMap>, transition: JourneyTransition<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 JourneyTransition<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,31 @@
+import type { JourneyEvent, JourneyJsonObject, JourneySendResult, JourneySnapshot, JourneyTerminal, JourneyTransition } 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;
+    runVersion: number;
+    transition?: JourneyTransition<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, nextContext: TContext, runVersion?: number) => JourneySendResult<TContext, TStepId>;
+    commitStepTransition: (fromStep: TStepId, target: TStepId, transitionEvent: JourneyEvent<TStepId, TEventMap>, transition: JourneyTransition<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 JourneyTransition<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>;

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

@@ -0,0 +1,33 @@
+import type { JourneyEqualityFn, JourneyJsonObject, JourneyMachineSnapshotReason, JourneyObservationEvent, JourneySelector, JourneySnapshot } from "../types";
+type SnapshotOptions = {
+    notify?: boolean;
+    reason?: JourneyMachineSnapshotReason;
+};
+export type JourneyMachineRuntime<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>> = {
+    getSnapshot: () => JourneySnapshot<TContext, TStepId>;
+    peekSnapshot: () => JourneySnapshot<TContext, TStepId>;
+    setSnapshot: (nextSnapshot: JourneySnapshot<TContext, TStepId>, options?: SnapshotOptions) => JourneySnapshot<TContext, TStepId>;
+    isDisposed: () => boolean;
+    isRunActive: (runVersion: number) => boolean;
+    cancelInFlight: () => void;
+    openLifecycle: (runVersion: number) => AbortController | null;
+    closeLifecycle: (controller: AbortController) => void;
+    queue: <T>(runner: (runVersion: number, signal: AbortSignal) => Promise<T>, onCanceled: () => T) => Promise<T>;
+    notify: () => void;
+    emit: (event: JourneyObservationEvent<TStepId, TEventMap>) => void;
+    subscribe: (listener: () => void) => () => void;
+    subscribeSelector: <TSelected>(selector: JourneySelector<TContext, TStepId, TSelected>, listener: (next: TSelected, previous: TSelected) => void, equalityFn?: JourneyEqualityFn<TSelected>) => () => void;
+    subscribeEvent: (listener: (event: JourneyObservationEvent<TStepId, TEventMap>) => void) => () => void;
+    dispose: () => void;
+};
+export declare const createJourneyMachineRuntime: <TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>>({ snapshot: initialSnapshot, onSnapshotChange, onDispose, onListenerError }: {
+    snapshot: JourneySnapshot<TContext, TStepId>;
+    onSnapshotChange?: (args: {
+        previousSnapshot: JourneySnapshot<TContext, TStepId>;
+        snapshot: JourneySnapshot<TContext, TStepId>;
+        reason: JourneyMachineSnapshotReason;
+    }) => void;
+    onDispose?: () => void;
+    onListenerError?: (error: unknown, context: "snapshot" | "event") => void;
+}) => JourneyMachineRuntime<TContext, TStepId, TEventMap>;
+export {};

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

@@ -0,0 +1,33 @@
+import type { JourneyEqualityFn, JourneyJsonObject, JourneyMachineSnapshotReason, JourneyObservationEvent, JourneySelector, JourneySnapshot } from "../types";
+type SnapshotOptions = {
+    notify?: boolean;
+    reason?: JourneyMachineSnapshotReason;
+};
+export type JourneyMachineRuntime<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>> = {
+    getSnapshot: () => JourneySnapshot<TContext, TStepId>;
+    peekSnapshot: () => JourneySnapshot<TContext, TStepId>;
+    setSnapshot: (nextSnapshot: JourneySnapshot<TContext, TStepId>, options?: SnapshotOptions) => JourneySnapshot<TContext, TStepId>;
+    isDisposed: () => boolean;
+    isRunActive: (runVersion: number) => boolean;
+    cancelInFlight: () => void;
+    openLifecycle: (runVersion: number) => AbortController | null;
+    closeLifecycle: (controller: AbortController) => void;
+    queue: <T>(runner: (runVersion: number, signal: AbortSignal) => Promise<T>, onCanceled: () => T) => Promise<T>;
+    notify: () => void;
+    emit: (event: JourneyObservationEvent<TStepId, TEventMap>) => void;
+    subscribe: (listener: () => void) => () => void;
+    subscribeSelector: <TSelected>(selector: JourneySelector<TContext, TStepId, TSelected>, listener: (next: TSelected, previous: TSelected) => void, equalityFn?: JourneyEqualityFn<TSelected>) => () => void;
+    subscribeEvent: (listener: (event: JourneyObservationEvent<TStepId, TEventMap>) => void) => () => void;
+    dispose: () => void;
+};
+export declare const createJourneyMachineRuntime: <TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>>({ snapshot: initialSnapshot, onSnapshotChange, onDispose, onListenerError }: {
+    snapshot: JourneySnapshot<TContext, TStepId>;
+    onSnapshotChange?: (args: {
+        previousSnapshot: JourneySnapshot<TContext, TStepId>;
+        snapshot: JourneySnapshot<TContext, TStepId>;
+        reason: JourneyMachineSnapshotReason;
+    }) => void;
+    onDispose?: () => void;
+    onListenerError?: (error: unknown, context: "snapshot" | "event") => void;
+}) => JourneyMachineRuntime<TContext, TStepId, TEventMap>;
+export {};

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

@@ -0,0 +1,9 @@
+import type { JourneyJsonObject, JourneySendEvent, JourneySendResult, JourneyTransition } from "../types";
+import type { JourneyMachineAsyncStateController } from "./async-state";
+import type { JourneyMachineNavigationController } from "./navigation";
+import type { JourneyMachineRuntime } from "./runtime";
+export type JourneyMachineSendController<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>> = {
+    executeSend: (event: JourneySendEvent<TStepId, TEventMap>, runVersion: number, signal: AbortSignal) => Promise<JourneySendResult<TContext, TStepId>>;
+    buildCanceledSendResult: (operation?: string) => JourneySendResult<TContext, TStepId>;
+};
+export declare const createJourneyMachineSendController: <TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>>(runtime: JourneyMachineRuntime<TContext, TStepId, TEventMap>, asyncState: JourneyMachineAsyncStateController<TStepId>, navigation: JourneyMachineNavigationController<TContext, TStepId, TEventMap, THandlers>, headless: boolean, steps: Record<TStepId, unknown>, transitions: readonly JourneyTransition<TContext, TStepId, TEventMap, THandlers>[], handlers: THandlers, requireExplicitCompletion: boolean, defaultTimeoutMs: number | undefined) => JourneyMachineSendController<TContext, TStepId, TEventMap>;

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

@@ -0,0 +1,9 @@
+import type { JourneyJsonObject, JourneySendEvent, JourneySendResult, JourneyTransition } from "../types";
+import type { JourneyMachineAsyncStateController } from "./async-state";
+import type { JourneyMachineNavigationController } from "./navigation";
+import type { JourneyMachineRuntime } from "./runtime";
+export type JourneyMachineSendController<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>> = {
+    executeSend: (event: JourneySendEvent<TStepId, TEventMap>, runVersion: number, signal: AbortSignal) => Promise<JourneySendResult<TContext, TStepId>>;
+    buildCanceledSendResult: (operation?: string) => JourneySendResult<TContext, TStepId>;
+};
+export declare const createJourneyMachineSendController: <TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>>(runtime: JourneyMachineRuntime<TContext, TStepId, TEventMap>, asyncState: JourneyMachineAsyncStateController<TStepId>, navigation: JourneyMachineNavigationController<TContext, TStepId, TEventMap, THandlers>, headless: boolean, steps: Record<TStepId, unknown>, transitions: readonly JourneyTransition<TContext, TStepId, TEventMap, THandlers>[], handlers: THandlers, requireExplicitCompletion: boolean, defaultTimeoutMs: number | undefined) => JourneyMachineSendController<TContext, TStepId, TEventMap>;

package/dist/plugins/analytics/index.cjs

@@ -0,0 +1,2 @@
+"use strict";var m=Object.defineProperty;var l=Object.getOwnPropertyDescriptor;var S=Object.getOwnPropertyNames;var x=Object.prototype.hasOwnProperty;var I=(n,t)=>{for(var i in t)m(n,i,{get:t[i],enumerable:!0})},b=(n,t,i,c)=>{if(t&&typeof t=="object"||typeof t=="function")for(let a of S(t))!x.call(n,a)&&a!==i&&m(n,a,{get:()=>t[a],enumerable:!(c=l(t,a))||c.enumerable});return n};var J=n=>b(m({},"__esModule",{value:!0}),n);var g={};I(g,{createAnalyticsPlugin:()=>E});module.exports=J(g);var w=()=>{let n=globalThis;if(typeof n.__DEV__=="boolean")return n.__DEV__;let t=n.process?.env?.NODE_ENV;return t===void 0||t==="development"},f=(n,t)=>{if(!(!w()||typeof console>"u")){if(t===void 0){console.warn(n);return}console.warn(n,t)}};var h=({context:n})=>({context:n}),E=n=>{let t,i=null,c=null,a=(y,u)=>{try{n.track(u)}catch(r){if(n.onError){n.onError(r,y);return}f("Journey analytics track() threw without an onError handler.",r)}};return{name:"analytics",setup:()=>({augmentMachine:({machine:y})=>{let u=y,r=(s,e)=>{a(s,e)},p=s=>{if(!n.includeStepMeta)return{};let e=u.getStepMeta(s);return e===void 0?{}:{stepMeta:e}},T=({from:s,to:e})=>{if(!n.includeStepMeta)return{};let d=u.getStepMeta(s),o=e==="COMPLETE"||e==="TERMINATED"?void 0:u.getStepMeta(e);return{...d===void 0?{}:{fromStepMeta:d},...o===void 0?{}:{toStepMeta:o}}};return t=u.subscribeEvent(s=>{let e=s,d=u.getSnapshot(),o=h({context:d.context});switch(e.type){case"journey.start":i=e.timestamp,c=e.timestamp,r(e,{name:"journey_started",timestamp:e.timestamp,...n.machineId?{machineId:n.machineId}:{},payload:{stepId:e.stepId,...p(e.stepId),...o}});return;case"step.enter":c=e.timestamp,r(e,{name:"step_viewed",timestamp:e.timestamp,...n.machineId?{machineId:n.machineId}:{},payload:{stepId:e.stepId,...p(e.stepId),...o}});return;case"step.exit":r(e,{name:"step_exited",timestamp:e.timestamp,...n.machineId?{machineId:n.machineId}:{},payload:{stepId:e.stepId,...c===null?{}:{dwellMs:Math.max(0,e.timestamp-c)},...p(e.stepId),...o}});return;case"transition.start":r(e,{name:"transition_started",timestamp:e.timestamp,...n.machineId?{machineId:n.machineId}:{},payload:{from:e.from,eventType:e.event.type,...o}});return;case"transition.success":r(e,{name:"transition_succeeded",timestamp:e.timestamp,...n.machineId?{machineId:n.machineId}:{},payload:{from:e.from,to:e.to,eventType:e.eventType,transitionId:e.transitionId,...T({from:e.from,to:e.to}),...o}});return;case"transition.error":r(e,{name:"transition_failed",timestamp:e.timestamp,...n.machineId?{machineId:n.machineId}:{},payload:{from:e.from,eventType:e.eventType,transitionId:e.transitionId,error:e.error,...o}});return;case"journey.completed":r(e,{name:"journey_completed",timestamp:e.timestamp,...n.machineId?{machineId:n.machineId}:{},payload:{stepId:e.stepId,...i===null?{}:{durationMs:Math.max(0,e.timestamp-i)},...p(e.stepId),...o}});return;case"journey.terminated":r(e,{name:"journey_terminated",timestamp:e.timestamp,...n.machineId?{machineId:n.machineId}:{},payload:{stepId:e.stepId,...i===null?{}:{durationMs:Math.max(0,e.timestamp-i)},...p(e.stepId),...o}});return;case"navigation.previous":r(e,{name:"navigation_previous",timestamp:e.timestamp,...n.machineId?{machineId:n.machineId}:{},payload:{from:e.from,to:e.to,requestedSteps:e.requestedSteps,appliedSteps:e.appliedSteps,...T({from:e.from,to:e.to}),...o}});return;case"navigation.lastVisited":r(e,{name:"navigation_last_visited",timestamp:e.timestamp,...n.machineId?{machineId:n.machineId}:{},payload:{from:e.from,to:e.to,...T({from:e.from,to:e.to}),...o}});return}}),{trackAnalyticsEvent:(s,e={})=>{let d={name:s,timestamp:Date.now(),...n.machineId?{machineId:n.machineId}:{},payload:e};return a(d,d),d}}},dispose:()=>{t?.()}})}};0&&(module.exports={createAnalyticsPlugin});
+//# sourceMappingURL=index.cjs.map