@rxova/journey-core 1.0.0-rc.3 → 1.0.1

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;
-};

package/dist/types/replay.types.d.cts

@@ -1,35 +0,0 @@
-import type { JourneyMachineSnapshotReason } from "./machine.types";
-import type { JourneyJsonObject, JourneySnapshot } from "./journey.types";
-import type { JourneyObservationEvent } from "./observation.types";
-/** Snapshot entry captured by the replay plugin. */
-export type JourneyReplaySnapshotEntry<TContext extends JourneyJsonObject, TStepId extends string> = {
-    kind: "snapshot";
-    timestamp: number;
-    reason: JourneyMachineSnapshotReason;
-    snapshot: JourneySnapshot<TContext, TStepId>;
-};
-/** Observation event entry captured by the replay plugin. */
-export type JourneyReplayEventEntry<TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>> = {
-    kind: "event";
-    timestamp: number;
-    event: JourneyObservationEvent<TStepId, TEventMap>;
-};
-/** Ordered replay entry captured from a live machine session. */
-export type JourneyReplayEntry<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>> = JourneyReplaySnapshotEntry<TContext, TStepId> | JourneyReplayEventEntry<TStepId, TEventMap>;
-/** Full replay session captured from a journey machine. */
-export type JourneyReplaySession<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>> = {
-    version: 1;
-    initialSnapshot: JourneySnapshot<TContext, TStepId> | null;
-    entries: JourneyReplayEntry<TContext, TStepId, TEventMap>[];
-    truncated: boolean;
-};
-/** Runtime options for the replay plugin. */
-export type JourneyReplayPluginOptions = {
-    maxEntries?: number;
-    captureEvents?: boolean;
-    captureSnapshots?: boolean;
-};
-/** Serialization options for `exportReplaySession()`. */
-export type JourneyReplayExportOptions = {
-    pretty?: boolean;
-};

package/dist/types/replay.types.d.ts

@@ -1,35 +0,0 @@
-import type { JourneyMachineSnapshotReason } from "./machine.types";
-import type { JourneyJsonObject, JourneySnapshot } from "./journey.types";
-import type { JourneyObservationEvent } from "./observation.types";
-/** Snapshot entry captured by the replay plugin. */
-export type JourneyReplaySnapshotEntry<TContext extends JourneyJsonObject, TStepId extends string> = {
-    kind: "snapshot";
-    timestamp: number;
-    reason: JourneyMachineSnapshotReason;
-    snapshot: JourneySnapshot<TContext, TStepId>;
-};
-/** Observation event entry captured by the replay plugin. */
-export type JourneyReplayEventEntry<TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>> = {
-    kind: "event";
-    timestamp: number;
-    event: JourneyObservationEvent<TStepId, TEventMap>;
-};
-/** Ordered replay entry captured from a live machine session. */
-export type JourneyReplayEntry<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>> = JourneyReplaySnapshotEntry<TContext, TStepId> | JourneyReplayEventEntry<TStepId, TEventMap>;
-/** Full replay session captured from a journey machine. */
-export type JourneyReplaySession<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>> = {
-    version: 1;
-    initialSnapshot: JourneySnapshot<TContext, TStepId> | null;
-    entries: JourneyReplayEntry<TContext, TStepId, TEventMap>[];
-    truncated: boolean;
-};
-/** Runtime options for the replay plugin. */
-export type JourneyReplayPluginOptions = {
-    maxEntries?: number;
-    captureEvents?: boolean;
-    captureSnapshots?: boolean;
-};
-/** Serialization options for `exportReplaySession()`. */
-export type JourneyReplayExportOptions = {
-    pretty?: boolean;
-};

package/dist/types/transitions.types.d.cts

@@ -1,122 +0,0 @@
-import type { JourneyBuiltInFrom, JourneyEvent, JourneyFullEventType, JourneyGoToEvent, JourneyHistory, JourneyJsonObject, JourneyPayloadFor, JourneySendEvent, JourneySendResult, JourneySnapshot, JourneyTerminal } from "./journey.types";
-type JourneyTransitionArgsBase<TContext extends JourneyJsonObject, TStepId extends string, THandlers extends Record<string, unknown>> = {
-    snapshot: JourneySnapshot<TContext, TStepId>;
-    context: Readonly<TContext>;
-    from: TStepId;
-    timeline: JourneyHistory<TStepId>["timeline"];
-    index: number;
-    signal: AbortSignal;
-    handlers: THandlers;
-};
-type JourneyTransitionEventOfType<TStepId extends string, TEventMap extends Record<string, unknown>, TEventType extends JourneyFullEventType<TEventMap>> = TEventType extends "goToStepById" ? JourneyGoToEvent<TStepId, JourneyPayloadFor<TEventMap, "goToStepById">> : {
-    type: TEventType;
-    payload?: JourneyPayloadFor<TEventMap, TEventType>;
-};
-export type JourneyDispatch<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>> = (event: JourneySendEvent<TStepId, TEventMap>) => Promise<JourneySendResult<TContext, TStepId>>;
-export type JourneyLifecycleArgs<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>> = {
-    snapshot: JourneySnapshot<TContext, TStepId>;
-    context: Readonly<TContext>;
-    from: TStepId;
-    to: TStepId | JourneyTerminal;
-    event: {
-        type: string;
-        payload?: unknown;
-    };
-    transitionId: string | null;
-    label?: string;
-    handlers: THandlers;
-    signal: AbortSignal;
-    dispatch: JourneyDispatch<TContext, TStepId, TEventMap>;
-};
-/**
- * Wrap callback signatures to opt into TypeScript's bivariant parameter checking.
- * This keeps narrow event payload handlers assignable to wider transition slots.
- */
-type JourneyBivariantCallback<TArgs, TResult> = {
-    bivarianceHack(args: TArgs): TResult;
-}["bivarianceHack"];
-export type JourneyStepLifecycleCallback<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>> = JourneyBivariantCallback<JourneyLifecycleArgs<TContext, TStepId, TEventMap, THandlers>, void | Promise<void>>;
-export type JourneyTransitionArgs<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>, THandlers extends Record<string, unknown> = Record<never, never>> = JourneyTransitionArgsBase<TContext, TStepId, THandlers> & {
-    event: JourneyEvent<TStepId, TEventMap>;
-};
-export type JourneyTransitionArgsForEvent<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>, TEventType extends JourneyFullEventType<TEventMap>> = JourneyTransitionArgsBase<TContext, TStepId, THandlers> & {
-    event: JourneyTransitionEventOfType<TStepId, TEventMap, TEventType>;
-};
-export type JourneyTransitionUpdateContextArgsForEvent<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, TEventType extends JourneyFullEventType<TEventMap>> = {
-    snapshot: JourneySnapshot<TContext, TStepId>;
-    context: Readonly<TContext>;
-    from: TStepId;
-    timeline: JourneyHistory<TStepId>["timeline"];
-    index: number;
-    event: JourneyTransitionEventOfType<TStepId, TEventMap, TEventType>;
-};
-type JourneyStepTransitionEventType<TEventMap extends Record<string, unknown>> = Exclude<JourneyFullEventType<TEventMap>, "completeJourney" | "terminateJourney" | "goToStepById">;
-type JourneyTerminalTransitionEventType<TEventMap extends Record<string, unknown>> = Extract<JourneyFullEventType<TEventMap>, "completeJourney" | "terminateJourney">;
-export type JourneyTransitionTarget<TStepId extends string> = TStepId | JourneyTerminal;
-type JourneyTransitionBehavior<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>, TEventType extends JourneyFullEventType<TEventMap>> = {
-    label?: string;
-    timeoutMs?: number;
-    when?: JourneyBivariantCallback<JourneyTransitionArgsForEvent<TContext, TStepId, TEventMap, THandlers, TEventType>, boolean | Promise<boolean>>;
-    updateContext?: JourneyBivariantCallback<JourneyTransitionUpdateContextArgsForEvent<TContext, TStepId, TEventMap, TEventType>, TContext>;
-    onEnter?: JourneyStepLifecycleCallback<TContext, TStepId, TEventMap, THandlers>;
-    onLeave?: JourneyStepLifecycleCallback<TContext, TStepId, TEventMap, THandlers>;
-};
-type JourneyTransitionConfig<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>, TEventType extends JourneyFullEventType<TEventMap>> = JourneyTransitionBehavior<TContext, TStepId, TEventMap, THandlers, TEventType> & {
-    from: TStepId | JourneyBuiltInFrom;
-};
-export type JourneyStepEventTransition<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>, THandlers extends Record<string, unknown> = Record<never, never>, TEventType extends JourneyStepTransitionEventType<TEventMap> = JourneyStepTransitionEventType<TEventMap>> = {
-    [TSelectedEvent in TEventType]: JourneyTransitionConfig<TContext, TStepId, TEventMap, THandlers, TSelectedEvent> & {
-        event: TSelectedEvent;
-        to: JourneyTransitionTarget<TStepId>;
-    };
-}[TEventType];
-export type JourneyTerminalTransition<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>, THandlers extends Record<string, unknown> = Record<never, never>, TEventType extends JourneyTerminalTransitionEventType<TEventMap> = JourneyTerminalTransitionEventType<TEventMap>> = {
-    [TSelectedEvent in TEventType]: JourneyTransitionConfig<TContext, TStepId, TEventMap, THandlers, TSelectedEvent> & {
-        event: TSelectedEvent;
-        to?: never;
-    };
-}[TEventType];
-export type JourneyGoToStepTransition<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>, THandlers extends Record<string, unknown> = Record<never, never>> = JourneyTransitionConfig<TContext, TStepId, TEventMap, THandlers, "goToStepById"> & {
-    event: "goToStepById";
-    to: TStepId;
-};
-export type JourneyTransition<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>, THandlers extends Record<string, unknown> = Record<never, never>> = JourneyStepEventTransition<TContext, TStepId, TEventMap, THandlers> | JourneyTerminalTransition<TContext, TStepId, TEventMap, THandlers> | JourneyGoToStepTransition<TContext, TStepId, TEventMap, THandlers>;
-export type JourneyResolvedTransition<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>, THandlers extends Record<string, unknown> = Record<never, never>> = JourneyTransition<TContext, TStepId, TEventMap, THandlers> & {
-    id: string;
-    label?: string;
-};
-export type JourneyGlobalTransition<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>, THandlers extends Record<string, unknown> = Record<never, never>> = JourneyTransition<TContext, TStepId, TEventMap, THandlers> & {
-    from: JourneyBuiltInFrom;
-};
-export type JourneyStepEventGraphEdge<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>, THandlers extends Record<string, unknown> = Record<never, never>, TEventType extends JourneyStepTransitionEventType<TEventMap> = JourneyStepTransitionEventType<TEventMap>> = {
-    [TSelectedEvent in TEventType]: JourneyTransitionBehavior<TContext, TStepId, TEventMap, THandlers, TSelectedEvent> & {
-        to: JourneyTransitionTarget<TStepId>;
-    };
-}[TEventType];
-export type JourneyTerminalGraphEdge<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>, THandlers extends Record<string, unknown> = Record<never, never>, TEventType extends JourneyTerminalTransitionEventType<TEventMap> = JourneyTerminalTransitionEventType<TEventMap>> = {
-    [TSelectedEvent in TEventType]: JourneyTransitionBehavior<TContext, TStepId, TEventMap, THandlers, TSelectedEvent> & {
-        to?: never;
-    };
-}[TEventType];
-export type JourneyGoToStepGraphEdge<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>, THandlers extends Record<string, unknown> = Record<never, never>> = JourneyTransitionBehavior<TContext, TStepId, TEventMap, THandlers, "goToStepById"> & {
-    to: TStepId;
-};
-export type JourneyGraphEdge<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>, THandlers extends Record<string, unknown> = Record<never, never>, TEventType extends JourneyFullEventType<TEventMap> = JourneyFullEventType<TEventMap>> = JourneyStepEventGraphEdge<TContext, TStepId, TEventMap, THandlers, Extract<TEventType, JourneyStepTransitionEventType<TEventMap>>> | JourneyTerminalGraphEdge<TContext, TStepId, TEventMap, THandlers, Extract<TEventType, JourneyTerminalTransitionEventType<TEventMap>>> | (Extract<TEventType, "goToStepById"> extends never ? never : JourneyGoToStepGraphEdge<TContext, TStepId, TEventMap, THandlers>);
-export type JourneyTerminalTransitionShorthand<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown>, THandlers extends Record<string, unknown>, TEventType extends JourneyTerminalTransitionEventType<TEventMap>> = true | readonly [] | readonly JourneyGraphEdge<TContext, TStepId, TEventMap, THandlers, TEventType>[];
-export type JourneyStepTransitions<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>, THandlers extends Record<string, unknown> = Record<never, never>> = Partial<{
-    [TSelectedEvent in JourneyFullEventType<TEventMap>]: TSelectedEvent extends "completeJourney" | "terminateJourney" ? JourneyTerminalTransitionShorthand<TContext, TStepId, TEventMap, THandlers, Extract<TSelectedEvent, JourneyTerminalTransitionEventType<TEventMap>>> : readonly JourneyGraphEdge<TContext, TStepId, TEventMap, THandlers, TSelectedEvent>[];
-}>;
-export type JourneyGlobalKey = "global";
-export type JourneyTransitionGraph<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>, THandlers extends Record<string, unknown> = Record<never, never>> = Partial<Record<TStepId, JourneyStepTransitions<TContext, TStepId, TEventMap, THandlers>>> & {
-    global?: JourneyStepTransitions<TContext, TStepId, TEventMap, THandlers>;
-};
-export type JourneyLinearStep<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>, THandlers extends Record<string, unknown> = Record<never, never>> = JourneyTransitionBehavior<TContext, TStepId, TEventMap, THandlers, "goToNextStep"> & {
-    step: TStepId;
-    when?: never;
-    to?: never;
-    from?: never;
-    event?: never;
-};
-export type JourneyLinearTransitions<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>, THandlers extends Record<string, unknown> = Record<never, never>> = readonly [TStepId, ...(TStepId | JourneyLinearStep<TContext, TStepId, TEventMap, THandlers>)[]];
-export type JourneyTransitionsDefinition<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>, THandlers extends Record<string, unknown> = Record<never, never>> = JourneyLinearTransitions<TContext, TStepId, TEventMap, THandlers> | JourneyTransitionGraph<TContext, TStepId, TEventMap, THandlers>;
-export {};