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

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

@@ -1,191 +0,0 @@
-import type { JourneyResolvedTransition, JourneyStepLifecycleCallback, JourneyTransitionsDefinition } from "./transitions.types";
-/** Terminal outcomes reached when a journey completes or is explicitly terminated. */
-export type JourneyTerminal = "COMPLETE" | "TERMINATED";
-/** Union of possible runtime machine statuses. */
-export type JourneyStatus = "idled" | "running" | "completed" | "terminated";
-/** Mode inferred from the journey transition syntax. */
-export type JourneyMode = "linear" | "graph" | "headless";
-/** Wildcard step identifier, exposed as a type-only literal. */
-export type JourneyBuiltInFrom = "*";
-/** Default transition event names supported by machine convenience APIs. */
-export type JourneyDefaultEventType = "goToNextStep" | "goToPreviousStep" | "terminateJourney" | "completeJourney" | "goToStepById";
-/** JSON primitive values accepted inside runtime context. */
-export type JourneyJsonPrimitive = string | number | boolean | null;
-/** JSON-compatible value accepted inside runtime context. */
-export type JourneyJsonValue = JourneyJsonPrimitive | {
-    [key: string]: JourneyJsonValue;
-} | JourneyJsonValue[];
-/** JSON-compatible object accepted as the machine context root. */
-export type JourneyJsonObject = {
-    [key: string]: JourneyJsonValue;
-};
-/** Derives the full event type union from a user-supplied event map. */
-export type JourneyFullEventType<TEventMap extends Record<string, unknown>> = (keyof TEventMap & string) | JourneyDefaultEventType;
-type JourneyBuiltInSendEventType = Exclude<JourneyDefaultEventType, "goToStepById">;
-type JourneyCustomSendEventType<TEventMap extends Record<string, unknown>> = Exclude<keyof TEventMap & string, JourneyDefaultEventType>;
-/** Union of supported async lifecycle phases. */
-export type JourneyAsyncPhase = "idle" | "evaluating-when" | "error";
-/** Async execution state for a single step. */
-export type JourneyStepAsyncState = {
-    phase: JourneyAsyncPhase;
-    eventType: string | null;
-    transitionId: string | null;
-    /** Captured error from a failed guard or lifecycle handler. `null` when no error is present. */
-    error: unknown;
-};
-/** Aggregated async state for the machine, keyed by step id. */
-export type JourneyAsyncState<TStepId extends string> = {
-    isLoading: boolean;
-    byStep: Record<TStepId, JourneyStepAsyncState>;
-};
-/** Minimal event shape used across runtime boundaries. */
-export type JourneyBaseEvent = {
-    type: string;
-    payload?: unknown;
-};
-/** Resolves payload type for a specific event type from the provided event map. */
-export type JourneyPayloadFor<TEventMap extends Record<string, unknown>, TEvent extends string> = TEvent extends keyof TEventMap ? TEventMap[TEvent] : unknown;
-/** Built-in direct-navigation event that targets a specific step id. */
-export type JourneyGoToEvent<TStepId extends string, TPayload = unknown> = {
-    type: "goToStepById";
-    stepId: TStepId;
-    payload?: TPayload;
-};
-/** Built-in send events supported by machine convenience APIs. */
-export type JourneyBuiltInSendEvent<TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>> = JourneyGoToEvent<TStepId, JourneyPayloadFor<TEventMap, "goToStepById">> | {
-    [TType in JourneyBuiltInSendEventType]: {
-        type: TType;
-        payload?: JourneyPayloadFor<TEventMap, TType>;
-    };
-}[JourneyBuiltInSendEventType];
-/** Custom send events derived from a user-supplied event map. */
-export type JourneyCustomSendEvent<TEventMap extends Record<string, unknown> = Record<never, never>> = {
-    [TType in JourneyCustomSendEventType<TEventMap>]: {
-        type: TType;
-        payload?: JourneyPayloadFor<TEventMap, TType>;
-    };
-}[JourneyCustomSendEventType<TEventMap>];
-/** Event union accepted by `JourneyMachine.send`. */
-export type JourneySendEvent<TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>> = JourneyBuiltInSendEvent<TStepId, TEventMap> | JourneyCustomSendEvent<TEventMap>;
-/** Event union available to transitions and guards for the declared event type set. */
-export type JourneyEvent<TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>> = JourneySendEvent<TStepId, TEventMap>;
-/** Step definition with optional metadata and lifecycle callbacks. */
-export type JourneyStepDefinition<TContext extends JourneyJsonObject = JourneyJsonObject, TStepId extends string = string, TEventMap extends Record<string, unknown> = Record<never, never>, TStepMeta = unknown, THandlers extends Record<string, unknown> = Record<never, never>> = {
-    meta?: TStepMeta;
-    /** Called when the machine enters this step. */
-    onEnter?: JourneyStepLifecycleCallback<TContext, TStepId, TEventMap, THandlers>;
-    /** Called when the machine leaves this step. */
-    onLeave?: JourneyStepLifecycleCallback<TContext, TStepId, TEventMap, THandlers>;
-};
-/** Timeline of visited steps and current history index. */
-export type JourneyHistory<TStepId extends string> = {
-    timeline: readonly TStepId[];
-    index: number;
-};
-/** Core snapshot state without async execution details. */
-export type JourneySnapshotStateBase<TContext extends JourneyJsonObject, TStepId extends string> = {
-    currentStepId: TStepId;
-    history: JourneyHistory<TStepId>;
-    context: TContext;
-    visited: Record<TStepId, boolean>;
-    status: JourneyStatus;
-};
-/** Serializable runtime snapshot of the journey state. */
-export type JourneySnapshot<TContext extends JourneyJsonObject, TStepId extends string> = JourneySnapshotStateBase<TContext, TStepId> & {
-    async: JourneyAsyncState<TStepId>;
-};
-/** Common read-only computed state exposed by a machine instance. */
-export type JourneyComputedBase<TStepId extends string> = {
-    mode: JourneyMode;
-    activeStepId: TStepId;
-    activeStepIndex: number;
-    visitedStepCount: number;
-    isLoading: boolean;
-    isIdle: boolean;
-    isRunning: boolean;
-    isComplete: boolean;
-    isTerminated: boolean;
-    isInitialStep: boolean;
-};
-/** Wizard-style computed state available when transitions use linear array syntax. */
-export type JourneyLinearComputed<TStepId extends string> = JourneyComputedBase<TStepId> & {
-    mode: "linear";
-    stepCount: number;
-    journeyLength: number;
-    isFirstStep: boolean;
-    isLastStep: boolean;
-    stepOrder: readonly TStepId[];
-};
-/** Computed state available when transitions use graph object syntax. */
-export type JourneyGraphComputed<TStepId extends string> = JourneyComputedBase<TStepId> & {
-    mode: "graph";
-    stepCount?: undefined;
-    journeyLength?: undefined;
-    isFirstStep?: undefined;
-    isLastStep?: undefined;
-    stepOrder?: undefined;
-};
-/** Computed state available when transitions are omitted and navigation is headless. */
-export type JourneyHeadlessComputed<TStepId extends string> = JourneyComputedBase<TStepId> & {
-    mode: "headless";
-    stepCount?: undefined;
-    journeyLength?: undefined;
-    isFirstStep?: undefined;
-    isLastStep?: undefined;
-    stepOrder?: undefined;
-};
-/** Mode-aware computed state returned by `JourneyMachine.getComputed()`. */
-export type JourneyComputed<TStepId extends string> = JourneyLinearComputed<TStepId> | JourneyGraphComputed<TStepId> | JourneyHeadlessComputed<TStepId>;
-/** Selector function that derives a value from a machine snapshot. */
-export type JourneySelector<TContext extends JourneyJsonObject, TStepId extends string, TSelected = unknown> = (snapshot: JourneySnapshot<TContext, TStepId>) => TSelected;
-/** Equality function used to compare selected values between snapshot updates. */
-export type JourneyEqualityFn<TValue> = (previous: TValue, next: TValue) => boolean;
-/** Shared definition fields without transition configuration. */
-export type JourneyDefinitionBase<TContext extends JourneyJsonObject, TStepId extends string, TStepMeta = unknown, THandlers extends Record<string, unknown> = Record<never, never>> = {
-    /**
-     * The step the machine starts on.
-     * - **Linear transitions**: optional — defaults to the first element of the
-     *   transitions array. When provided, must exist in the array and the machine
-     *   starts from that step (useful for resuming mid-flow).
-     * - **Graph / headless**: required.
-     */
-    initial?: TStepId;
-    context: TContext;
-    handlers?: THandlers;
-    steps: Record<TStepId, JourneyStepDefinition<TContext, TStepId, Record<never, never>, TStepMeta, THandlers>>;
-};
-/** Full machine definition used to create a journey machine instance. */
-export type JourneyDefinition<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>, TStepMeta = unknown, THandlers extends Record<string, unknown> = Record<never, never>> = Omit<JourneyDefinitionBase<TContext, TStepId, TStepMeta, THandlers>, "steps"> & {
-    steps: Record<TStepId, JourneyStepDefinition<TContext, TStepId, TEventMap, TStepMeta, THandlers>>;
-    transitions?: JourneyTransitionsDefinition<TContext, TStepId, TEventMap, THandlers>;
-};
-export type JourneyResolvedDefinition<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>, TStepMeta = unknown, THandlers extends Record<string, unknown> = Record<never, never>> = Required<Pick<JourneyDefinitionBase<TContext, TStepId, TStepMeta, THandlers>, "initial">> & Omit<JourneyDefinition<TContext, TStepId, TEventMap, TStepMeta, THandlers>, "transitions"> & {
-    transitions: readonly JourneyResolvedTransition<TContext, TStepId, TEventMap, THandlers>[];
-};
-export type JourneyExecutionPathEventType<TEventType extends string> = TEventType | JourneyDefaultEventType;
-/** Structural execution path returned by `getExecutionPaths()`. */
-export type JourneyExecutionPath<TStepId extends string, TEventType extends string> = {
-    steps: TStepId[];
-    events: JourneyExecutionPathEventType<TEventType>[];
-    terminated: "final" | "depth" | "cycle" | "limit";
-};
-/** Result returned by structural path enumeration. */
-export type JourneyExecutionPathsResult<TStepId extends string, TEventType extends string> = {
-    paths: JourneyExecutionPath<TStepId, TEventType>[];
-    truncated: boolean;
-    cyclesDetected: boolean;
-};
-/** Options for structural path enumeration from the initial step. */
-export type JourneyExecutionPathOptions = {
-    maxDepth?: number;
-    maxPaths?: number;
-};
-/** Result returned from send/navigation APIs. */
-export type JourneySendResult<TContext extends JourneyJsonObject, TStepId extends string> = {
-    transitioned: boolean;
-    transitionId?: string;
-    label?: string;
-    error?: unknown;
-    snapshot: JourneySnapshot<TContext, TStepId>;
-};
-export {};

package/dist/types/machine.types.d.cts

@@ -1,104 +0,0 @@
-import type { JourneyComputed, JourneyDefaultEventType, JourneyDefinition, JourneyEqualityFn, JourneyJsonObject, JourneyPayloadFor, JourneyResolvedDefinition, JourneySelector, JourneySendEvent, JourneySendResult, JourneySnapshot, JourneyTerminal } from "./journey.types";
-import type { JourneyCompleteObservationEvent, JourneyLifecycleErrorPhase, JourneyObservationEvent, JourneyResetObservationEvent, JourneyStartObservationEvent, JourneyTerminateObservationEvent } from "./observation.types";
-/** Reasons why a machine snapshot changed. */
-export type JourneyMachineSnapshotReason = "async" | "context" | "navigation" | "reset" | "start" | "transition";
-export type JourneyLifecycleErrorContext<TStepId extends string> = {
-    phase: JourneyLifecycleErrorPhase;
-    from: TStepId;
-    to: TStepId | JourneyTerminal;
-    eventType: string;
-    transitionId: string | null;
-    label?: string;
-};
-/** Setup context passed to journey plugins when a machine is created. */
-export type JourneyMachinePluginSetupContext<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>, TStepMeta = unknown, THandlers extends Record<string, unknown> = Record<never, never>> = {
-    journey: JourneyDefinition<TContext, TStepId, TEventMap, TStepMeta, THandlers>;
-    resolvedJourney: JourneyResolvedDefinition<TContext, TStepId, TEventMap, TStepMeta, THandlers>;
-    options: {
-        requireExplicitCompletion: boolean;
-        defaultTimeoutMs: number | undefined;
-    };
-    buildInitialSnapshot: () => JourneySnapshot<TContext, TStepId>;
-};
-/** Snapshot-change details exposed to plugins. */
-export type JourneyMachinePluginSnapshotChange<TContext extends JourneyJsonObject, TStepId extends string> = {
-    previousSnapshot: JourneySnapshot<TContext, TStepId>;
-    snapshot: JourneySnapshot<TContext, TStepId>;
-    reason: JourneyMachineSnapshotReason;
-};
-/** Hooks returned from a journey plugin setup call. */
-export type JourneyMachinePluginHooks<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>, TStepMeta = unknown, THandlers extends Record<string, unknown> = Record<never, never>, TExtension extends object = Record<never, never>> = {
-    hydrateSnapshot?: (snapshot: JourneySnapshot<TContext, TStepId>) => JourneySnapshot<TContext, TStepId>;
-    onSnapshotChange?: (change: JourneyMachinePluginSnapshotChange<TContext, TStepId>) => void;
-    augmentMachine?: (context: {
-        machine: JourneyMachine<TContext, TStepId, TEventMap, TStepMeta, THandlers>;
-        journey: JourneyDefinition<TContext, TStepId, TEventMap, TStepMeta, THandlers>;
-        resolvedJourney: JourneyResolvedDefinition<TContext, TStepId, TEventMap, TStepMeta, THandlers>;
-    }) => TExtension;
-    dispose?: () => void;
-};
-/** Plugin contract for extending journey machines without bloating the base entrypoint. */
-export type JourneyMachinePlugin = {
-    name: string;
-    __extension__?: object;
-    setup: <TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>, TStepMeta = unknown, THandlers extends Record<string, unknown> = Record<never, never>>(context: JourneyMachinePluginSetupContext<TContext, TStepId, TEventMap, TStepMeta, THandlers>) => JourneyMachinePluginHooks<TContext, TStepId, TEventMap, TStepMeta, THandlers>;
-};
-type JourneyMachinePluginHooksFor<TPlugin, TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, TStepMeta, THandlers extends Record<string, unknown>> = TPlugin extends {
-    setup: (context: JourneyMachinePluginSetupContext<TContext, TStepId, TEventMap, TStepMeta, THandlers>) => infer THooks;
-} ? THooks : never;
-type JourneyMachinePluginExtensionFor<TPlugin, TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, TStepMeta, THandlers extends Record<string, unknown>> = TPlugin extends {
-    __extension__?: infer TExtension;
-} ? Exclude<TExtension, undefined> extends never ? JourneyMachinePluginHooksFor<TPlugin, TContext, TStepId, TEventMap, TStepMeta, THandlers> extends {
-    augmentMachine?: (...args: never[]) => infer THookExtension;
-} ? THookExtension : Record<never, never> : Exclude<TExtension, undefined> : JourneyMachinePluginHooksFor<TPlugin, TContext, TStepId, TEventMap, TStepMeta, THandlers> extends {
-    augmentMachine?: (...args: never[]) => infer THookExtension;
-} ? THookExtension : Record<never, never>;
-type UnionToIntersection<TValue> = [TValue] extends [never] ? Record<never, never> : (TValue extends unknown ? (value: TValue) => void : never) extends (value: infer TIntersection) => void ? TIntersection : Record<never, never>;
-type JourneyTypeParam<TValue> = TValue extends unknown ? unknown : never;
-/** Optional machine features and plugin registration. */
-export type JourneyMachineOptions<TPlugins extends readonly JourneyMachinePlugin[] = readonly JourneyMachinePlugin[]> = {
-    requireExplicitCompletion?: boolean;
-    defaultTimeoutMs?: number;
-    plugins?: TPlugins;
-    /**
-     * Called when a snapshot or event listener throws an unhandled error.
-     * Listener failures are isolated so they never block other listeners or
-     * the machine itself — use this hook to report them to your error
-     * monitoring system (e.g. Sentry, Datadog).
-     *
-     * @param error - The thrown value (may not be an `Error` instance).
-     * @param context - `"snapshot"` for `subscribe()` listeners,
-     *   `"event"` for `subscribeEvent()` listeners.
-     */
-    onListenerError?: (error: unknown, context: "snapshot" | "event") => void;
-    onLifecycleError?: (error: unknown, context: JourneyLifecycleErrorContext<string>) => void;
-};
-type JourneyPayloadForDefaultEvent<TEventMap extends Record<string, unknown>, TDefaultEvent extends JourneyDefaultEventType> = JourneyPayloadFor<TEventMap, TDefaultEvent>;
-/** Runtime machine API for reading snapshots, sending events, and controlling flow. */
-export type JourneyMachine<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>, TStepMeta = unknown, THandlers extends Record<string, unknown> = Record<never, never>> = JourneyTypeParam<THandlers> & {
-    getSnapshot: () => JourneySnapshot<TContext, TStepId>;
-    getStepMeta: (stepId: TStepId) => TStepMeta | undefined;
-    getComputed: () => JourneyComputed<TStepId>;
-    startJourney: () => Promise<JourneySnapshot<TContext, TStepId>>;
-    send: (event: JourneySendEvent<TStepId, TEventMap>) => Promise<JourneySendResult<TContext, TStepId>>;
-    goToNextStep: () => Promise<JourneySendResult<TContext, TStepId>>;
-    goToStepById: (stepId: TStepId) => Promise<JourneySendResult<TContext, TStepId>>;
-    terminateJourney: (payload?: JourneyPayloadForDefaultEvent<TEventMap, "terminateJourney">) => Promise<JourneySendResult<TContext, TStepId>>;
-    completeJourney: (payload?: JourneyPayloadForDefaultEvent<TEventMap, "completeJourney">) => Promise<JourneySendResult<TContext, TStepId>>;
-    goToPreviousStep: (steps?: number) => Promise<JourneySendResult<TContext, TStepId>>;
-    goToLastVisitedStep: () => Promise<JourneySendResult<TContext, TStepId>>;
-    updateContext: (updater: (context: TContext) => TContext) => Promise<JourneySnapshot<TContext, TStepId>>;
-    clearStepError: (stepId?: TStepId) => Promise<JourneySnapshot<TContext, TStepId>>;
-    resetJourney: () => Promise<JourneySnapshot<TContext, TStepId>>;
-    dispose: () => 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;
-    subscribeStart: (listener: (event: JourneyStartObservationEvent<TStepId>) => void) => () => void;
-    subscribeReset: (listener: (event: JourneyResetObservationEvent<TStepId>) => void) => () => void;
-    subscribeComplete: (listener: (event: JourneyCompleteObservationEvent<TStepId>) => void) => () => void;
-    subscribeTerminate: (listener: (event: JourneyTerminateObservationEvent<TStepId>) => void) => () => void;
-};
-/** Journey machine API augmented by plugin-provided extensions. */
-export type JourneyMachineWithPlugins<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[] = readonly JourneyMachinePlugin[]> = JourneyMachine<TContext, TStepId, TEventMap, TStepMeta, THandlers> & UnionToIntersection<JourneyMachinePluginExtensionFor<TPlugins[number], TContext, TStepId, TEventMap, TStepMeta, THandlers>>;
-export {};

package/dist/types/machine.types.d.ts

@@ -1,104 +0,0 @@
-import type { JourneyComputed, JourneyDefaultEventType, JourneyDefinition, JourneyEqualityFn, JourneyJsonObject, JourneyPayloadFor, JourneyResolvedDefinition, JourneySelector, JourneySendEvent, JourneySendResult, JourneySnapshot, JourneyTerminal } from "./journey.types";
-import type { JourneyCompleteObservationEvent, JourneyLifecycleErrorPhase, JourneyObservationEvent, JourneyResetObservationEvent, JourneyStartObservationEvent, JourneyTerminateObservationEvent } from "./observation.types";
-/** Reasons why a machine snapshot changed. */
-export type JourneyMachineSnapshotReason = "async" | "context" | "navigation" | "reset" | "start" | "transition";
-export type JourneyLifecycleErrorContext<TStepId extends string> = {
-    phase: JourneyLifecycleErrorPhase;
-    from: TStepId;
-    to: TStepId | JourneyTerminal;
-    eventType: string;
-    transitionId: string | null;
-    label?: string;
-};
-/** Setup context passed to journey plugins when a machine is created. */
-export type JourneyMachinePluginSetupContext<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>, TStepMeta = unknown, THandlers extends Record<string, unknown> = Record<never, never>> = {
-    journey: JourneyDefinition<TContext, TStepId, TEventMap, TStepMeta, THandlers>;
-    resolvedJourney: JourneyResolvedDefinition<TContext, TStepId, TEventMap, TStepMeta, THandlers>;
-    options: {
-        requireExplicitCompletion: boolean;
-        defaultTimeoutMs: number | undefined;
-    };
-    buildInitialSnapshot: () => JourneySnapshot<TContext, TStepId>;
-};
-/** Snapshot-change details exposed to plugins. */
-export type JourneyMachinePluginSnapshotChange<TContext extends JourneyJsonObject, TStepId extends string> = {
-    previousSnapshot: JourneySnapshot<TContext, TStepId>;
-    snapshot: JourneySnapshot<TContext, TStepId>;
-    reason: JourneyMachineSnapshotReason;
-};
-/** Hooks returned from a journey plugin setup call. */
-export type JourneyMachinePluginHooks<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>, TStepMeta = unknown, THandlers extends Record<string, unknown> = Record<never, never>, TExtension extends object = Record<never, never>> = {
-    hydrateSnapshot?: (snapshot: JourneySnapshot<TContext, TStepId>) => JourneySnapshot<TContext, TStepId>;
-    onSnapshotChange?: (change: JourneyMachinePluginSnapshotChange<TContext, TStepId>) => void;
-    augmentMachine?: (context: {
-        machine: JourneyMachine<TContext, TStepId, TEventMap, TStepMeta, THandlers>;
-        journey: JourneyDefinition<TContext, TStepId, TEventMap, TStepMeta, THandlers>;
-        resolvedJourney: JourneyResolvedDefinition<TContext, TStepId, TEventMap, TStepMeta, THandlers>;
-    }) => TExtension;
-    dispose?: () => void;
-};
-/** Plugin contract for extending journey machines without bloating the base entrypoint. */
-export type JourneyMachinePlugin = {
-    name: string;
-    __extension__?: object;
-    setup: <TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>, TStepMeta = unknown, THandlers extends Record<string, unknown> = Record<never, never>>(context: JourneyMachinePluginSetupContext<TContext, TStepId, TEventMap, TStepMeta, THandlers>) => JourneyMachinePluginHooks<TContext, TStepId, TEventMap, TStepMeta, THandlers>;
-};
-type JourneyMachinePluginHooksFor<TPlugin, TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, TStepMeta, THandlers extends Record<string, unknown>> = TPlugin extends {
-    setup: (context: JourneyMachinePluginSetupContext<TContext, TStepId, TEventMap, TStepMeta, THandlers>) => infer THooks;
-} ? THooks : never;
-type JourneyMachinePluginExtensionFor<TPlugin, TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, TStepMeta, THandlers extends Record<string, unknown>> = TPlugin extends {
-    __extension__?: infer TExtension;
-} ? Exclude<TExtension, undefined> extends never ? JourneyMachinePluginHooksFor<TPlugin, TContext, TStepId, TEventMap, TStepMeta, THandlers> extends {
-    augmentMachine?: (...args: never[]) => infer THookExtension;
-} ? THookExtension : Record<never, never> : Exclude<TExtension, undefined> : JourneyMachinePluginHooksFor<TPlugin, TContext, TStepId, TEventMap, TStepMeta, THandlers> extends {
-    augmentMachine?: (...args: never[]) => infer THookExtension;
-} ? THookExtension : Record<never, never>;
-type UnionToIntersection<TValue> = [TValue] extends [never] ? Record<never, never> : (TValue extends unknown ? (value: TValue) => void : never) extends (value: infer TIntersection) => void ? TIntersection : Record<never, never>;
-type JourneyTypeParam<TValue> = TValue extends unknown ? unknown : never;
-/** Optional machine features and plugin registration. */
-export type JourneyMachineOptions<TPlugins extends readonly JourneyMachinePlugin[] = readonly JourneyMachinePlugin[]> = {
-    requireExplicitCompletion?: boolean;
-    defaultTimeoutMs?: number;
-    plugins?: TPlugins;
-    /**
-     * Called when a snapshot or event listener throws an unhandled error.
-     * Listener failures are isolated so they never block other listeners or
-     * the machine itself — use this hook to report them to your error
-     * monitoring system (e.g. Sentry, Datadog).
-     *
-     * @param error - The thrown value (may not be an `Error` instance).
-     * @param context - `"snapshot"` for `subscribe()` listeners,
-     *   `"event"` for `subscribeEvent()` listeners.
-     */
-    onListenerError?: (error: unknown, context: "snapshot" | "event") => void;
-    onLifecycleError?: (error: unknown, context: JourneyLifecycleErrorContext<string>) => void;
-};
-type JourneyPayloadForDefaultEvent<TEventMap extends Record<string, unknown>, TDefaultEvent extends JourneyDefaultEventType> = JourneyPayloadFor<TEventMap, TDefaultEvent>;
-/** Runtime machine API for reading snapshots, sending events, and controlling flow. */
-export type JourneyMachine<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>, TStepMeta = unknown, THandlers extends Record<string, unknown> = Record<never, never>> = JourneyTypeParam<THandlers> & {
-    getSnapshot: () => JourneySnapshot<TContext, TStepId>;
-    getStepMeta: (stepId: TStepId) => TStepMeta | undefined;
-    getComputed: () => JourneyComputed<TStepId>;
-    startJourney: () => Promise<JourneySnapshot<TContext, TStepId>>;
-    send: (event: JourneySendEvent<TStepId, TEventMap>) => Promise<JourneySendResult<TContext, TStepId>>;
-    goToNextStep: () => Promise<JourneySendResult<TContext, TStepId>>;
-    goToStepById: (stepId: TStepId) => Promise<JourneySendResult<TContext, TStepId>>;
-    terminateJourney: (payload?: JourneyPayloadForDefaultEvent<TEventMap, "terminateJourney">) => Promise<JourneySendResult<TContext, TStepId>>;
-    completeJourney: (payload?: JourneyPayloadForDefaultEvent<TEventMap, "completeJourney">) => Promise<JourneySendResult<TContext, TStepId>>;
-    goToPreviousStep: (steps?: number) => Promise<JourneySendResult<TContext, TStepId>>;
-    goToLastVisitedStep: () => Promise<JourneySendResult<TContext, TStepId>>;
-    updateContext: (updater: (context: TContext) => TContext) => Promise<JourneySnapshot<TContext, TStepId>>;
-    clearStepError: (stepId?: TStepId) => Promise<JourneySnapshot<TContext, TStepId>>;
-    resetJourney: () => Promise<JourneySnapshot<TContext, TStepId>>;
-    dispose: () => 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;
-    subscribeStart: (listener: (event: JourneyStartObservationEvent<TStepId>) => void) => () => void;
-    subscribeReset: (listener: (event: JourneyResetObservationEvent<TStepId>) => void) => () => void;
-    subscribeComplete: (listener: (event: JourneyCompleteObservationEvent<TStepId>) => void) => () => void;
-    subscribeTerminate: (listener: (event: JourneyTerminateObservationEvent<TStepId>) => void) => () => void;
-};
-/** Journey machine API augmented by plugin-provided extensions. */
-export type JourneyMachineWithPlugins<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[] = readonly JourneyMachinePlugin[]> = JourneyMachine<TContext, TStepId, TEventMap, TStepMeta, THandlers> & UnionToIntersection<JourneyMachinePluginExtensionFor<TPlugins[number], TContext, TStepId, TEventMap, TStepMeta, THandlers>>;
-export {};

package/dist/types/observation.types.d.cts

@@ -1,83 +0,0 @@
-import type { JourneySendEvent, JourneyTerminal } from "./journey.types";
-export type JourneyLifecycleErrorPhase = "step.onLeave" | "transition.onLeave" | "step.onEnter" | "transition.onEnter";
-export type JourneyStartObservationEvent<TStepId extends string> = {
-    type: "journey.start";
-    stepId: TStepId;
-    timestamp: number;
-};
-export type JourneyResetObservationEvent<TStepId extends string> = {
-    type: "journey.reset";
-    stepId: TStepId;
-    timestamp: number;
-};
-export type JourneyTransitionStartObservationEvent<TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>> = {
-    type: "transition.start";
-    from: TStepId;
-    event: JourneySendEvent<TStepId, TEventMap>;
-    timestamp: number;
-};
-export type JourneyTransitionSuccessObservationEvent<TStepId extends string> = {
-    type: "transition.success";
-    from: TStepId;
-    to: TStepId | JourneyTerminal;
-    eventType: string;
-    transitionId: string | null;
-    label?: string;
-    timestamp: number;
-};
-export type JourneyTransitionErrorObservationEvent<TStepId extends string> = {
-    type: "transition.error";
-    from: TStepId;
-    eventType: string;
-    transitionId: string | null;
-    label?: string;
-    error: unknown;
-    timestamp: number;
-};
-export type JourneyLifecycleErrorObservationEvent<TStepId extends string> = {
-    type: "lifecycle.error";
-    phase: JourneyLifecycleErrorPhase;
-    from: TStepId;
-    to: TStepId | JourneyTerminal;
-    eventType: string;
-    transitionId: string | null;
-    label?: string;
-    error: unknown;
-    timestamp: number;
-};
-export type JourneyStepExitObservationEvent<TStepId extends string> = {
-    type: "step.exit";
-    stepId: TStepId;
-    timestamp: number;
-};
-export type JourneyStepEnterObservationEvent<TStepId extends string> = {
-    type: "step.enter";
-    stepId: TStepId;
-    timestamp: number;
-};
-export type JourneyCompleteObservationEvent<TStepId extends string> = {
-    type: "journey.completed";
-    stepId: TStepId;
-    timestamp: number;
-};
-export type JourneyTerminateObservationEvent<TStepId extends string> = {
-    type: "journey.terminated";
-    stepId: TStepId;
-    timestamp: number;
-};
-export type JourneyPreviousNavigationObservationEvent<TStepId extends string> = {
-    type: "navigation.previous";
-    from: TStepId;
-    to: TStepId;
-    requestedSteps: number;
-    appliedSteps: number;
-    timestamp: number;
-};
-export type JourneyLastVisitedNavigationObservationEvent<TStepId extends string> = {
-    type: "navigation.lastVisited";
-    from: TStepId;
-    to: TStepId;
-    timestamp: number;
-};
-/** Observation events emitted by the machine lifecycle/event stream. */
-export type JourneyObservationEvent<TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>> = JourneyStartObservationEvent<TStepId> | JourneyResetObservationEvent<TStepId> | JourneyTransitionStartObservationEvent<TStepId, TEventMap> | JourneyTransitionSuccessObservationEvent<TStepId> | JourneyTransitionErrorObservationEvent<TStepId> | JourneyLifecycleErrorObservationEvent<TStepId> | JourneyStepExitObservationEvent<TStepId> | JourneyStepEnterObservationEvent<TStepId> | JourneyCompleteObservationEvent<TStepId> | JourneyTerminateObservationEvent<TStepId> | JourneyPreviousNavigationObservationEvent<TStepId> | JourneyLastVisitedNavigationObservationEvent<TStepId>;

package/dist/types/observation.types.d.ts

@@ -1,83 +0,0 @@
-import type { JourneySendEvent, JourneyTerminal } from "./journey.types";
-export type JourneyLifecycleErrorPhase = "step.onLeave" | "transition.onLeave" | "step.onEnter" | "transition.onEnter";
-export type JourneyStartObservationEvent<TStepId extends string> = {
-    type: "journey.start";
-    stepId: TStepId;
-    timestamp: number;
-};
-export type JourneyResetObservationEvent<TStepId extends string> = {
-    type: "journey.reset";
-    stepId: TStepId;
-    timestamp: number;
-};
-export type JourneyTransitionStartObservationEvent<TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>> = {
-    type: "transition.start";
-    from: TStepId;
-    event: JourneySendEvent<TStepId, TEventMap>;
-    timestamp: number;
-};
-export type JourneyTransitionSuccessObservationEvent<TStepId extends string> = {
-    type: "transition.success";
-    from: TStepId;
-    to: TStepId | JourneyTerminal;
-    eventType: string;
-    transitionId: string | null;
-    label?: string;
-    timestamp: number;
-};
-export type JourneyTransitionErrorObservationEvent<TStepId extends string> = {
-    type: "transition.error";
-    from: TStepId;
-    eventType: string;
-    transitionId: string | null;
-    label?: string;
-    error: unknown;
-    timestamp: number;
-};
-export type JourneyLifecycleErrorObservationEvent<TStepId extends string> = {
-    type: "lifecycle.error";
-    phase: JourneyLifecycleErrorPhase;
-    from: TStepId;
-    to: TStepId | JourneyTerminal;
-    eventType: string;
-    transitionId: string | null;
-    label?: string;
-    error: unknown;
-    timestamp: number;
-};
-export type JourneyStepExitObservationEvent<TStepId extends string> = {
-    type: "step.exit";
-    stepId: TStepId;
-    timestamp: number;
-};
-export type JourneyStepEnterObservationEvent<TStepId extends string> = {
-    type: "step.enter";
-    stepId: TStepId;
-    timestamp: number;
-};
-export type JourneyCompleteObservationEvent<TStepId extends string> = {
-    type: "journey.completed";
-    stepId: TStepId;
-    timestamp: number;
-};
-export type JourneyTerminateObservationEvent<TStepId extends string> = {
-    type: "journey.terminated";
-    stepId: TStepId;
-    timestamp: number;
-};
-export type JourneyPreviousNavigationObservationEvent<TStepId extends string> = {
-    type: "navigation.previous";
-    from: TStepId;
-    to: TStepId;
-    requestedSteps: number;
-    appliedSteps: number;
-    timestamp: number;
-};
-export type JourneyLastVisitedNavigationObservationEvent<TStepId extends string> = {
-    type: "navigation.lastVisited";
-    from: TStepId;
-    to: TStepId;
-    timestamp: number;
-};
-/** Observation events emitted by the machine lifecycle/event stream. */
-export type JourneyObservationEvent<TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>> = JourneyStartObservationEvent<TStepId> | JourneyResetObservationEvent<TStepId> | JourneyTransitionStartObservationEvent<TStepId, TEventMap> | JourneyTransitionSuccessObservationEvent<TStepId> | JourneyTransitionErrorObservationEvent<TStepId> | JourneyLifecycleErrorObservationEvent<TStepId> | JourneyStepExitObservationEvent<TStepId> | JourneyStepEnterObservationEvent<TStepId> | JourneyCompleteObservationEvent<TStepId> | JourneyTerminateObservationEvent<TStepId> | JourneyPreviousNavigationObservationEvent<TStepId> | JourneyLastVisitedNavigationObservationEvent<TStepId>;

package/dist/types/persistence.types.d.cts

@@ -1,34 +0,0 @@
-import type { JourneyJsonObject, JourneySnapshotStateBase } from "./journey.types";
-export type JourneyPersistedState<TContext extends JourneyJsonObject, TStepId extends string> = {
-    version: number;
-    snapshot: JourneySnapshotStateBase<TContext, TStepId>;
-};
-export type JourneyStorage = {
-    getItem: (key: string) => string | null;
-    setItem: (key: string, value: string) => void;
-    removeItem: (key: string) => void;
-};
-export type JourneyPersistenceOptions<TContext extends JourneyJsonObject, TStepId extends string> = {
-    key: string;
-    storage?: JourneyStorage;
-    version?: number;
-    clearOnReset?: boolean;
-    allowList?: readonly string[];
-    blockList?: readonly string[];
-    serialize?: (value: JourneyPersistedState<TContext, TStepId>) => string;
-    deserialize?: (value: string) => unknown;
-    migrate?: (value: unknown, persistedVersion: number) => JourneySnapshotStateBase<TContext, TStepId>;
-    onError?: (error: unknown) => void;
-};
-export type ResolvedPersistence<TContext extends JourneyJsonObject, TStepId extends string> = {
-    key: string;
-    storage: JourneyStorage;
-    version: number;
-    clearOnReset: boolean;
-    allowList?: readonly string[];
-    blockList: readonly string[];
-    serialize: (value: JourneyPersistedState<TContext, TStepId>) => string;
-    deserialize: (value: string) => unknown;
-    migrate?: (value: unknown, persistedVersion: number) => JourneySnapshotStateBase<TContext, TStepId>;
-    onError?: (error: unknown) => void;
-};

package/dist/types/persistence.types.d.ts

@@ -1,34 +0,0 @@
-import type { JourneyJsonObject, JourneySnapshotStateBase } from "./journey.types";
-export type JourneyPersistedState<TContext extends JourneyJsonObject, TStepId extends string> = {
-    version: number;
-    snapshot: JourneySnapshotStateBase<TContext, TStepId>;
-};
-export type JourneyStorage = {
-    getItem: (key: string) => string | null;
-    setItem: (key: string, value: string) => void;
-    removeItem: (key: string) => void;
-};
-export type JourneyPersistenceOptions<TContext extends JourneyJsonObject, TStepId extends string> = {
-    key: string;
-    storage?: JourneyStorage;
-    version?: number;
-    clearOnReset?: boolean;
-    allowList?: readonly string[];
-    blockList?: readonly string[];
-    serialize?: (value: JourneyPersistedState<TContext, TStepId>) => string;
-    deserialize?: (value: string) => unknown;
-    migrate?: (value: unknown, persistedVersion: number) => JourneySnapshotStateBase<TContext, TStepId>;
-    onError?: (error: unknown) => void;
-};
-export type ResolvedPersistence<TContext extends JourneyJsonObject, TStepId extends string> = {
-    key: string;
-    storage: JourneyStorage;
-    version: number;
-    clearOnReset: boolean;
-    allowList?: readonly string[];
-    blockList: readonly string[];
-    serialize: (value: JourneyPersistedState<TContext, TStepId>) => string;
-    deserialize: (value: string) => unknown;
-    migrate?: (value: unknown, persistedVersion: number) => JourneySnapshotStateBase<TContext, TStepId>;
-    onError?: (error: unknown) => void;
-};