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

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

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

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

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

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

@@ -1,3 +0,0 @@
-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

@@ -1,3 +0,0 @@
-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

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

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

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

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

@@ -1,15 +0,0 @@
-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

@@ -1,15 +0,0 @@
-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

@@ -1,2 +0,0 @@
-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

@@ -1,2 +0,0 @@
-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

@@ -1,33 +0,0 @@
-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

@@ -1,33 +0,0 @@
-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

@@ -1,9 +0,0 @@
-import type { JourneyJsonObject, JourneyResolvedTransition, JourneySendEvent, JourneySendResult } 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 JourneyResolvedTransition<TContext, TStepId, TEventMap, THandlers>[], handlers: THandlers, requireExplicitCompletion: boolean, defaultTimeoutMs: number | undefined) => JourneyMachineSendController<TContext, TStepId, TEventMap>;

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

@@ -1,9 +0,0 @@
-import type { JourneyJsonObject, JourneyResolvedTransition, JourneySendEvent, JourneySendResult } 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 JourneyResolvedTransition<TContext, TStepId, TEventMap, THandlers>[], handlers: THandlers, requireExplicitCompletion: boolean, defaultTimeoutMs: number | undefined) => JourneyMachineSendController<TContext, TStepId, TEventMap>;

package/dist/plugins/analytics/index.cjs

@@ -1,2 +0,0 @@
-"use strict";var m=Object.defineProperty;var f=Object.getOwnPropertyDescriptor;var S=Object.getOwnPropertyNames;var x=Object.prototype.hasOwnProperty;var b=(n,t)=>{for(var i in t)m(n,i,{get:t[i],enumerable:!0})},I=(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=f(t,a))||c.enumerable});return n};var J=n=>I(m({},"__esModule",{value:!0}),n);var g={};b(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"},l=(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}l("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,...e.label!==void 0?{label:e.label}:{},...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,...e.label!==void 0?{label:e.label}:{},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

package/dist/plugins/analytics/index.cjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/plugins/analytics/index.ts", "../../../src/journey-machine/helpers.ts"],
-  "sourcesContent": ["import { warnInDevelopment } from \"../../journey-machine/helpers\";\n\nimport type {\n  JourneyAnalyticsPluginOptions,\n  JourneyAnalyticsTrackedEvent,\n  JourneyJsonObject,\n  JourneyMachine,\n  JourneyMachinePlugin,\n  JourneyObservationEvent,\n  JourneyTerminal\n} from \"../../types\";\n\nconst buildBasePayload = <TContext extends JourneyJsonObject>({\n  context\n}: {\n  context: TContext;\n}) => ({ context });\n\nexport type JourneyAnalyticsMachineExtension<\n  TContext extends JourneyJsonObject,\n  TStepId extends string,\n  TStepMeta\n> = {\n  trackAnalyticsEvent: (\n    name: string,\n    payload?: Record<string, unknown>\n  ) => JourneyAnalyticsTrackedEvent<TContext, TStepId, TStepMeta>;\n};\n\nexport type JourneyAnalyticsMachine<\n  TContext extends JourneyJsonObject,\n  TStepId extends string,\n  TEventMap extends Record<string, unknown> = Record<never, never>,\n  TStepMeta = unknown,\n  THandlers extends Record<string, unknown> = Record<never, never>\n> = JourneyMachine<TContext, TStepId, TEventMap, TStepMeta, THandlers> &\n  JourneyAnalyticsMachineExtension<TContext, TStepId, TStepMeta>;\n\n/** Creates a plugin that converts journey observation events into analytics envelopes. */\nexport const createAnalyticsPlugin = <\n  TContext extends JourneyJsonObject,\n  TStepId extends string,\n  TEventMap extends Record<string, unknown> = Record<never, never>,\n  TStepMeta = unknown\n>(\n  options: JourneyAnalyticsPluginOptions<TContext, TStepId, TEventMap, TStepMeta>\n) => {\n  let unsubscribe: (() => void) | undefined;\n  let startedAt: number | null = null;\n  let activeStepEnteredAt: number | null = null;\n\n  const trackSafely = (\n    event:\n      | JourneyObservationEvent<TStepId, TEventMap>\n      | JourneyAnalyticsTrackedEvent<TContext, TStepId, TStepMeta>,\n    tracked: JourneyAnalyticsTrackedEvent<TContext, TStepId, TStepMeta>\n  ) => {\n    try {\n      options.track(tracked);\n    } catch (error) {\n      if (options.onError) {\n        options.onError(error, event);\n        return;\n      }\n\n      warnInDevelopment(\"Journey analytics track() threw without an onError handler.\", error);\n    }\n  };\n\n  return {\n    name: \"analytics\",\n    setup: () => ({\n      augmentMachine: ({ machine }) => {\n        const typedMachine = machine as JourneyMachine<\n          TContext,\n          TStepId,\n          TEventMap,\n          TStepMeta,\n          Record<string, unknown>\n        >;\n\n        const emitTracked = (\n          sourceEvent: JourneyObservationEvent<TStepId, TEventMap>,\n          tracked: JourneyAnalyticsTrackedEvent<TContext, TStepId, TStepMeta>\n        ) => {\n          trackSafely(sourceEvent, tracked);\n        };\n\n        const buildStepMetaPayload = (stepId: TStepId) => {\n          if (!options.includeStepMeta) {\n            return {};\n          }\n\n          const stepMeta = typedMachine.getStepMeta(stepId) as TStepMeta | undefined;\n          return stepMeta === undefined ? {} : { stepMeta };\n        };\n\n        const buildTransitionMetaPayload = ({\n          from,\n          to\n        }: {\n          from: TStepId;\n          to: TStepId | JourneyTerminal;\n        }) => {\n          if (!options.includeStepMeta) {\n            return {};\n          }\n\n          const fromStepMeta = typedMachine.getStepMeta(from) as TStepMeta | undefined;\n          const toStepMeta =\n            to === \"COMPLETE\" || to === \"TERMINATED\"\n              ? undefined\n              : (typedMachine.getStepMeta(to) as TStepMeta | undefined);\n\n          return {\n            ...(fromStepMeta === undefined ? {} : { fromStepMeta }),\n            ...(toStepMeta === undefined ? {} : { toStepMeta })\n          };\n        };\n\n        unsubscribe = typedMachine.subscribeEvent((event) => {\n          const typedEvent = event as JourneyObservationEvent<TStepId, TEventMap>;\n          const snapshot = typedMachine.getSnapshot();\n          const basePayload = buildBasePayload({\n            context: snapshot.context as TContext\n          });\n\n          switch (typedEvent.type) {\n            case \"journey.start\":\n              startedAt = typedEvent.timestamp;\n              activeStepEnteredAt = typedEvent.timestamp;\n              emitTracked(typedEvent, {\n                name: \"journey_started\",\n                timestamp: typedEvent.timestamp,\n                ...(options.machineId ? { machineId: options.machineId } : {}),\n                payload: {\n                  stepId: typedEvent.stepId,\n                  ...buildStepMetaPayload(typedEvent.stepId),\n                  ...basePayload\n                }\n              });\n              return;\n            case \"step.enter\":\n              activeStepEnteredAt = typedEvent.timestamp;\n              emitTracked(typedEvent, {\n                name: \"step_viewed\",\n                timestamp: typedEvent.timestamp,\n                ...(options.machineId ? { machineId: options.machineId } : {}),\n                payload: {\n                  stepId: typedEvent.stepId,\n                  ...buildStepMetaPayload(typedEvent.stepId),\n                  ...basePayload\n                }\n              });\n              return;\n            case \"step.exit\":\n              emitTracked(typedEvent, {\n                name: \"step_exited\",\n                timestamp: typedEvent.timestamp,\n                ...(options.machineId ? { machineId: options.machineId } : {}),\n                payload: {\n                  stepId: typedEvent.stepId,\n                  ...(activeStepEnteredAt === null\n                    ? {}\n                    : { dwellMs: Math.max(0, typedEvent.timestamp - activeStepEnteredAt) }),\n                  ...buildStepMetaPayload(typedEvent.stepId),\n                  ...basePayload\n                }\n              });\n              return;\n            case \"transition.start\":\n              emitTracked(typedEvent, {\n                name: \"transition_started\",\n                timestamp: typedEvent.timestamp,\n                ...(options.machineId ? { machineId: options.machineId } : {}),\n                payload: {\n                  from: typedEvent.from,\n                  eventType: typedEvent.event.type,\n                  ...basePayload\n                }\n              });\n              return;\n            case \"transition.success\":\n              emitTracked(typedEvent, {\n                name: \"transition_succeeded\",\n                timestamp: typedEvent.timestamp,\n                ...(options.machineId ? { machineId: options.machineId } : {}),\n                payload: {\n                  from: typedEvent.from,\n                  to: typedEvent.to,\n                  eventType: typedEvent.eventType,\n                  transitionId: typedEvent.transitionId,\n                  ...(typedEvent.label !== undefined ? { label: typedEvent.label } : {}),\n                  ...buildTransitionMetaPayload({\n                    from: typedEvent.from,\n                    to: typedEvent.to as TStepId | JourneyTerminal\n                  }),\n                  ...basePayload\n                }\n              });\n              return;\n            case \"transition.error\":\n              emitTracked(typedEvent, {\n                name: \"transition_failed\",\n                timestamp: typedEvent.timestamp,\n                ...(options.machineId ? { machineId: options.machineId } : {}),\n                payload: {\n                  from: typedEvent.from,\n                  eventType: typedEvent.eventType,\n                  transitionId: typedEvent.transitionId,\n                  ...(typedEvent.label !== undefined ? { label: typedEvent.label } : {}),\n                  error: typedEvent.error,\n                  ...basePayload\n                }\n              });\n              return;\n            case \"journey.completed\":\n              emitTracked(typedEvent, {\n                name: \"journey_completed\",\n                timestamp: typedEvent.timestamp,\n                ...(options.machineId ? { machineId: options.machineId } : {}),\n                payload: {\n                  stepId: typedEvent.stepId,\n                  ...(startedAt === null\n                    ? {}\n                    : { durationMs: Math.max(0, typedEvent.timestamp - startedAt) }),\n                  ...buildStepMetaPayload(typedEvent.stepId),\n                  ...basePayload\n                }\n              });\n              return;\n            case \"journey.terminated\":\n              emitTracked(typedEvent, {\n                name: \"journey_terminated\",\n                timestamp: typedEvent.timestamp,\n                ...(options.machineId ? { machineId: options.machineId } : {}),\n                payload: {\n                  stepId: typedEvent.stepId,\n                  ...(startedAt === null\n                    ? {}\n                    : { durationMs: Math.max(0, typedEvent.timestamp - startedAt) }),\n                  ...buildStepMetaPayload(typedEvent.stepId),\n                  ...basePayload\n                }\n              });\n              return;\n            case \"navigation.previous\":\n              emitTracked(typedEvent, {\n                name: \"navigation_previous\",\n                timestamp: typedEvent.timestamp,\n                ...(options.machineId ? { machineId: options.machineId } : {}),\n                payload: {\n                  from: typedEvent.from,\n                  to: typedEvent.to,\n                  requestedSteps: typedEvent.requestedSteps,\n                  appliedSteps: typedEvent.appliedSteps,\n                  ...buildTransitionMetaPayload({\n                    from: typedEvent.from,\n                    to: typedEvent.to\n                  }),\n                  ...basePayload\n                }\n              });\n              return;\n            case \"navigation.lastVisited\":\n              emitTracked(typedEvent, {\n                name: \"navigation_last_visited\",\n                timestamp: typedEvent.timestamp,\n                ...(options.machineId ? { machineId: options.machineId } : {}),\n                payload: {\n                  from: typedEvent.from,\n                  to: typedEvent.to,\n                  ...buildTransitionMetaPayload({\n                    from: typedEvent.from,\n                    to: typedEvent.to\n                  }),\n                  ...basePayload\n                }\n              });\n              return;\n          }\n        });\n\n        return {\n          trackAnalyticsEvent: (name: string, payload: Record<string, unknown> = {}) => {\n            const tracked = {\n              name,\n              timestamp: Date.now(),\n              ...(options.machineId ? { machineId: options.machineId } : {}),\n              payload\n            } satisfies JourneyAnalyticsTrackedEvent<TContext, TStepId, TStepMeta>;\n            trackSafely(tracked, tracked);\n            return tracked;\n          }\n        };\n      },\n      dispose: () => {\n        unsubscribe?.();\n      }\n    })\n  } satisfies JourneyMachinePlugin;\n};\n\nexport type { JourneyAnalyticsPluginOptions, JourneyAnalyticsTrackedEvent } from \"../../types\";\n", "import type {\n  JourneyAsyncState,\n  JourneyEvent,\n  JourneyGoToEvent,\n  JourneyJsonObject,\n  JourneyJsonValue,\n  JourneyPayloadFor,\n  JourneyResolvedTransition,\n  JourneySendEvent,\n  JourneySendResult,\n  JourneySnapshot,\n  JourneyStatus,\n  JourneyStepAsyncState,\n  JourneyTerminal,\n  JourneyTransition,\n  JourneyTransitionArgs\n} from \"../types\";\n\nexport const assertStepExists = <TStepId extends string>(\n  steps: Record<TStepId, unknown>,\n  stepId: TStepId,\n  message: string\n) => {\n  if (!(stepId in steps)) {\n    throw new Error(message);\n  }\n};\n\nexport const isPlainObject = (value: unknown): value is Record<string, unknown> =>\n  typeof value === \"object\" &&\n  value !== null &&\n  !Array.isArray(value) &&\n  (Object.getPrototypeOf(value) === Object.prototype || Object.getPrototypeOf(value) === null);\n\nconst cloneSerializableValue = <T extends JourneyJsonValue>(value: T): T => {\n  if (Array.isArray(value)) {\n    return value.map((entry) => cloneSerializableValue(entry)) as T;\n  }\n\n  if (isPlainObject(value)) {\n    return Object.fromEntries(\n      Object.entries(value).map(([key, entryValue]) => [\n        key,\n        cloneSerializableValue(entryValue as JourneyJsonValue)\n      ])\n    ) as T;\n  }\n\n  return value;\n};\n\ntype SerializableCheckState = {\n  readonly seen: WeakSet<object>;\n};\n\nconst describeValue = (value: unknown): string => {\n  if (value === null) {\n    return \"null\";\n  }\n\n  if (Array.isArray(value)) {\n    return \"array\";\n  }\n\n  if (typeof value === \"object\") {\n    const constructorName = (value as { constructor?: { name?: string } }).constructor?.name;\n    return constructorName && constructorName !== \"Object\" ? constructorName : \"object\";\n  }\n\n  return typeof value;\n};\n\nfunction assertSerializableValue(\n  value: unknown,\n  label: string,\n  state: SerializableCheckState,\n  path: readonly string[] = []\n): asserts value is JourneyJsonValue {\n  if (\n    value === null ||\n    typeof value === \"string\" ||\n    typeof value === \"number\" ||\n    typeof value === \"boolean\"\n  ) {\n    return;\n  }\n\n  const pathLabel = path.length === 0 ? label : `${label}.${path.join(\".\")}`;\n\n  if (value === undefined) {\n    throw new Error(`${pathLabel} must be JSON-serializable. Received undefined.`);\n  }\n\n  if (typeof value === \"bigint\" || typeof value === \"symbol\" || typeof value === \"function\") {\n    throw new Error(`${pathLabel} must be JSON-serializable. Received ${typeof value}.`);\n  }\n\n  if (typeof value !== \"object\") {\n    throw new Error(`${pathLabel} must be JSON-serializable. Received ${describeValue(value)}.`);\n  }\n\n  if (state.seen.has(value)) {\n    throw new Error(\n      `${pathLabel} must be JSON-serializable. Circular references are not supported.`\n    );\n  }\n\n  state.seen.add(value);\n\n  if (Array.isArray(value)) {\n    for (const [index, entryValue] of value.entries()) {\n      assertSerializableValue(entryValue, label, state, [...path, String(index)]);\n    }\n    return;\n  }\n\n  if (!isPlainObject(value)) {\n    throw new Error(\n      `${pathLabel} must be JSON-serializable. Received non-plain ${describeValue(value)}.`\n    );\n  }\n\n  for (const [key, entryValue] of Object.entries(value)) {\n    assertSerializableValue(entryValue, label, state, [...path, key]);\n  }\n}\n\nexport function assertSerializableContext<TContext extends JourneyJsonObject>(\n  context: TContext,\n  label = \"Journey context\"\n): TContext {\n  assertSerializableValue(context, label, { seen: new WeakSet() });\n  return context;\n}\n\nexport const cloneContext = <TContext extends JourneyJsonObject>(context: TContext): TContext =>\n  cloneSerializableValue(assertSerializableContext(context));\n\nconst cloneDefinitionValueFallback = (value: unknown): unknown => {\n  if (Array.isArray(value)) {\n    return value.map((entry) => cloneDefinitionValueFallback(entry));\n  }\n\n  if (value instanceof Date) {\n    return new Date(value.getTime());\n  }\n\n  if (value instanceof Map) {\n    return new Map(\n      [...value.entries()].map(([key, entryValue]) => [\n        cloneDefinitionValueFallback(key),\n        cloneDefinitionValueFallback(entryValue)\n      ])\n    );\n  }\n\n  if (value instanceof Set) {\n    return new Set([...value].map((entry) => cloneDefinitionValueFallback(entry)));\n  }\n\n  if (isPlainObject(value)) {\n    return Object.fromEntries(\n      Object.entries(value).map(([key, entryValue]) => [\n        key,\n        cloneDefinitionValueFallback(entryValue)\n      ])\n    );\n  }\n\n  return value;\n};\n\nexport const cloneMetaValue = <T>(value: T): T => {\n  if ((typeof value !== \"object\" && typeof value !== \"function\") || value === null) {\n    return value;\n  }\n\n  if (typeof structuredClone === \"function\") {\n    try {\n      return structuredClone(value);\n    } catch {\n      return cloneDefinitionValueFallback(value) as T;\n    }\n  } else {\n    return cloneDefinitionValueFallback(value) as T;\n  }\n};\n\nconst freezeSnapshotValue = (value: unknown) => {\n  if (typeof value !== \"object\" || value === null || Object.isFrozen(value)) {\n    return;\n  }\n\n  if (Array.isArray(value)) {\n    for (const item of value) {\n      freezeSnapshotValue(item);\n    }\n    Object.freeze(value);\n    return;\n  }\n\n  if (!isPlainObject(value)) {\n    return;\n  }\n\n  for (const entryValue of Object.values(value)) {\n    freezeSnapshotValue(entryValue);\n  }\n  Object.freeze(value);\n};\n\nexport const normalizeStepCount = (steps?: number): number => {\n  if (typeof steps !== \"number\" || !Number.isFinite(steps)) {\n    return 1;\n  }\n  return Math.max(1, Math.trunc(steps));\n};\n\nexport const now = (): number => Date.now();\n\nconst unique = <T>(items: readonly T[]): T[] => [...new Set(items)];\n\nconst normalizeVisited = <TStepId extends string>(\n  visited: Record<TStepId, boolean>,\n  stepIds: readonly TStepId[]\n): Record<TStepId, boolean> =>\n  Object.fromEntries(stepIds.map((stepId) => [stepId, visited[stepId] === true])) as Record<\n    TStepId,\n    boolean\n  >;\n\nexport const buildVisitedFromTimeline = <TStepId extends string>(\n  timeline: readonly TStepId[],\n  stepIds?: readonly TStepId[]\n): Record<TStepId, boolean> => {\n  const resolvedStepIds = stepIds ?? unique(timeline);\n  const visited = Object.fromEntries(resolvedStepIds.map((stepId) => [stepId, false])) as Record<\n    TStepId,\n    boolean\n  >;\n\n  for (const stepId of timeline) {\n    visited[stepId] = true;\n  }\n\n  return visited;\n};\n\nexport const appendVisited = <TStepId extends string>(\n  visited: Record<TStepId, boolean>,\n  current: TStepId\n): Record<TStepId, boolean> => ({\n  ...visited,\n  [current]: true\n});\n\nexport const isPromiseLike = <T>(value: T | PromiseLike<T>): value is PromiseLike<T> =>\n  typeof value === \"object\" &&\n  value !== null &&\n  \"then\" in value &&\n  typeof (value as { then: unknown }).then === \"function\";\n\nconst isFiniteNumber = (value: unknown): value is number =>\n  typeof value === \"number\" && Number.isFinite(value);\n\nexport const validateFiniteTimeout = (timeoutMs: unknown, label: string) => {\n  if (timeoutMs !== undefined && !isFiniteNumber(timeoutMs)) {\n    throw new Error(`${label} must define a finite numeric \"timeoutMs\" when provided.`);\n  }\n};\n\nexport class JourneyTimeoutError extends Error {\n  override name = \"JourneyTimeoutError\";\n\n  constructor(message: string) {\n    super(message);\n  }\n}\n\nexport class JourneyDisposedError extends Error {\n  override name = \"JourneyDisposedError\";\n  readonly operation: string;\n\n  constructor(operation: string) {\n    super(`Journey machine has been disposed; \"${operation}\" can no longer be used.`);\n    this.operation = operation;\n  }\n}\n\ntype DiagnosticGlobal = typeof globalThis & {\n  __DEV__?: unknown;\n  process?: {\n    env?: {\n      NODE_ENV?: string;\n    };\n  };\n};\n\nexport const isDevelopmentEnvironment = (): boolean => {\n  const diagnosticGlobal = globalThis as DiagnosticGlobal;\n  if (typeof diagnosticGlobal.__DEV__ === \"boolean\") {\n    return diagnosticGlobal.__DEV__;\n  }\n\n  const nodeEnv = diagnosticGlobal.process?.env?.NODE_ENV;\n  return nodeEnv === undefined || nodeEnv === \"development\";\n};\n\nexport const warnInDevelopment = (message: string, detail?: unknown) => {\n  if (!isDevelopmentEnvironment() || typeof console === \"undefined\") {\n    return;\n  }\n\n  if (detail === undefined) {\n    console.warn(message);\n    return;\n  }\n\n  console.warn(message, detail);\n};\n\nexport const errorInDevelopment = (message: string, detail?: unknown) => {\n  if (!isDevelopmentEnvironment() || typeof console === \"undefined\") {\n    return;\n  }\n\n  if (detail === undefined) {\n    console.error(message);\n    return;\n  }\n\n  console.error(message, detail);\n};\n\nexport const withTimeout = async <T>(\n  promise: PromiseLike<T>,\n  timeoutMs: number | undefined,\n  buildError: () => Error\n): Promise<T> => {\n  if (!isFiniteNumber(timeoutMs) || timeoutMs <= 0) {\n    return await promise;\n  }\n\n  return await new Promise<T>((resolve, reject) => {\n    const timer = setTimeout(() => {\n      reject(buildError());\n    }, timeoutMs);\n\n    promise.then(\n      (value) => {\n        clearTimeout(timer);\n        resolve(value);\n      },\n      (error) => {\n        clearTimeout(timer);\n        reject(error);\n      }\n    );\n  });\n};\n\nexport const withAbortSignal = async <T>(\n  promise: PromiseLike<T>,\n  signal: AbortSignal\n): Promise<T> => {\n  if (signal.aborted) {\n    throw signal.reason;\n  }\n\n  return await new Promise<T>((resolve, reject) => {\n    const onAbort = () => {\n      signal.removeEventListener(\"abort\", onAbort);\n      reject(signal.reason);\n    };\n\n    signal.addEventListener(\"abort\", onAbort, { once: true });\n    promise.then(\n      (value) => {\n        signal.removeEventListener(\"abort\", onAbort);\n        resolve(value);\n      },\n      (error) => {\n        signal.removeEventListener(\"abort\", onAbort);\n        reject(error);\n      }\n    );\n  });\n};\n\nexport const buildIdleStepAsyncState = (): JourneyStepAsyncState => ({\n  phase: \"idle\",\n  eventType: null,\n  transitionId: null,\n  error: null\n});\n\nexport const buildInitialAsyncState = <TStepId extends string>(\n  steps: Record<TStepId, unknown>\n): JourneyAsyncState<TStepId> => {\n  const byStep = Object.fromEntries(\n    Object.keys(steps).map((stepId) => [stepId, buildIdleStepAsyncState()])\n  ) as Record<TStepId, JourneyStepAsyncState>;\n\n  return {\n    isLoading: false,\n    byStep\n  };\n};\n\nexport const isGoToStepByIdEvent = <\n  TStepId extends string,\n  TEventMap extends Record<string, unknown>\n>(\n  event: JourneySendEvent<TStepId, TEventMap>\n): event is JourneyGoToEvent<TStepId, JourneyPayloadFor<TEventMap, \"goToStepById\">> =>\n  event.type === \"goToStepById\" && \"stepId\" in event;\n\nexport const isTerminalTarget = <TStepId extends string>(\n  target: TStepId | JourneyTerminal\n): target is JourneyTerminal => target === \"COMPLETE\" || target === \"TERMINATED\";\n\nexport const resolveTransitionTarget = <\n  TContext extends JourneyJsonObject,\n  TStepId extends string,\n  TEventMap extends Record<string, unknown>,\n  THandlers extends Record<string, unknown>\n>(\n  transition: JourneyTransition<TContext, TStepId, TEventMap, THandlers>\n): TStepId | JourneyTerminal =>\n  transition.event === \"completeJourney\"\n    ? \"COMPLETE\"\n    : transition.event === \"terminateJourney\"\n      ? \"TERMINATED\"\n      : (transition.to as TStepId | JourneyTerminal);\n\nexport const validateJourneyTransitions = <\n  TContext extends JourneyJsonObject,\n  TStepId extends string,\n  TEventMap extends Record<string, unknown>,\n  THandlers extends Record<string, unknown>\n>(\n  transitions: readonly JourneyResolvedTransition<TContext, TStepId, TEventMap, THandlers>[],\n  steps: Record<TStepId, unknown>\n) => {\n  const stepRegistry = steps as Record<string, unknown>;\n  const allowedKeys = new Set([\n    \"from\",\n    \"event\",\n    \"to\",\n    \"when\",\n    \"updateContext\",\n    \"onEnter\",\n    \"onLeave\",\n    \"id\",\n    \"label\",\n    \"timeoutMs\"\n  ]);\n\n  for (const [index, transition] of transitions.entries()) {\n    if (!transition || typeof transition !== \"object\") {\n      throw new Error(`Journey transition at index ${index} must be an object.`);\n    }\n\n    for (const key of Object.keys(transition)) {\n      if (!allowedKeys.has(key)) {\n        throw new Error(\n          `Journey transition at index ${index} contains unsupported field \"${key}\".`\n        );\n      }\n    }\n\n    if (typeof transition.from !== \"string\" || typeof transition.event !== \"string\") {\n      throw new Error(\n        `Journey transition at index ${index} must define string \"from\" and \"event\".`\n      );\n    }\n\n    if (transition.from !== \"*\" && !(transition.from in stepRegistry)) {\n      throw new Error(\n        `Journey transition at index ${index} references unknown from step \"${transition.from}\".`\n      );\n    }\n\n    validateFiniteTimeout(transition.timeoutMs, `Journey transition at index ${index}`);\n\n    if (transition.when !== undefined && typeof transition.when !== \"function\") {\n      throw new Error(\n        `Journey transition at index ${index} must define \"when\" as a function when provided.`\n      );\n    }\n\n    if (transition.updateContext !== undefined && typeof transition.updateContext !== \"function\") {\n      throw new Error(\n        `Journey transition at index ${index} must define \"updateContext\" as a function when provided.`\n      );\n    }\n\n    if (transition.onEnter !== undefined && typeof transition.onEnter !== \"function\") {\n      throw new Error(\n        `Journey transition at index ${index} must define \"onEnter\" as a function when provided.`\n      );\n    }\n\n    if (transition.onLeave !== undefined && typeof transition.onLeave !== \"function\") {\n      throw new Error(\n        `Journey transition at index ${index} must define \"onLeave\" as a function when provided.`\n      );\n    }\n\n    if (transition.id !== undefined && typeof transition.id !== \"string\") {\n      throw new Error(\n        `Journey transition at index ${index} must define \"id\" as a string when provided.`\n      );\n    }\n\n    if (transition.label !== undefined && typeof transition.label !== \"string\") {\n      throw new Error(\n        `Journey transition at index ${index} must define \"label\" as a string when provided.`\n      );\n    }\n\n    if (transition.event === \"completeJourney\" || transition.event === \"terminateJourney\") {\n      if (\"to\" in transition && transition.to !== undefined) {\n        throw new Error(\n          `Journey transition at index ${index} with event \"${transition.event}\" cannot define \"to\".`\n        );\n      }\n      continue;\n    }\n\n    if (typeof transition.to !== \"string\") {\n      throw new Error(\n        `Journey transition at index ${index} with event \"${transition.event}\" must define string \"to\".`\n      );\n    }\n\n    if (!isTerminalTarget(transition.to) && !(transition.to in stepRegistry)) {\n      throw new Error(\n        `Journey transition at index ${index} points to unknown step \"${transition.to}\".`\n      );\n    }\n  }\n};\n\nexport const buildSendResult = <TContext extends JourneyJsonObject, TStepId extends string>(\n  snapshot: JourneySnapshot<TContext, TStepId>,\n  transitioned: boolean,\n  options: {\n    transitionId?: string;\n    label?: string;\n    error?: unknown;\n  } = {}\n): JourneySendResult<TContext, TStepId> => ({\n  transitioned,\n  ...(options.transitionId !== undefined ? { transitionId: options.transitionId } : {}),\n  ...(options.label !== undefined ? { label: options.label } : {}),\n  ...(\"error\" in options ? { error: options.error } : {}),\n  snapshot\n});\n\nexport const buildSnapshot = <TContext extends JourneyJsonObject, TStepId extends string>(\n  timeline: readonly TStepId[],\n  index: number,\n  context: TContext,\n  status: JourneyStatus,\n  asyncState: JourneyAsyncState<TStepId>,\n  visited?: Record<TStepId, boolean>\n): JourneySnapshot<TContext, TStepId> => {\n  if (timeline.length === 0) {\n    throw new Error(\"Journey timeline cannot be empty.\");\n  }\n\n  const safeIndex = Math.max(0, Math.min(Math.trunc(index), timeline.length - 1));\n  const currentStepId = timeline[safeIndex] as TStepId;\n  const stepIds = unique(\n    visited ? ([...(Object.keys(visited) as TStepId[]), ...timeline] as const) : timeline\n  );\n\n  return {\n    status,\n    currentStepId,\n    history: {\n      timeline: [...timeline],\n      index: safeIndex\n    },\n    context: cloneContext(context),\n    visited: visited\n      ? normalizeVisited(visited, stepIds)\n      : buildVisitedFromTimeline(timeline, stepIds),\n    async: cloneSerializableValue(\n      asyncState as unknown as JourneyJsonValue\n    ) as JourneyAsyncState<TStepId>\n  };\n};\n\nexport const stabilizeSnapshot = <TContext extends JourneyJsonObject, TStepId extends string>(\n  snapshot: JourneySnapshot<TContext, TStepId>\n): JourneySnapshot<TContext, TStepId> => {\n  const stableSnapshot: JourneySnapshot<TContext, TStepId> = {\n    ...snapshot,\n    history: {\n      timeline: [...snapshot.history.timeline],\n      index: snapshot.history.index\n    },\n    context: cloneContext(snapshot.context),\n    visited: { ...snapshot.visited },\n    async: cloneSerializableValue(\n      snapshot.async as unknown as JourneyJsonValue\n    ) as JourneyAsyncState<TStepId>\n  };\n\n  freezeSnapshotValue(stableSnapshot);\n  return stableSnapshot;\n};\n\nexport const selectTransition = async <\n  TContext extends JourneyJsonObject,\n  TStepId extends string,\n  TEventMap extends Record<string, unknown>,\n  THandlers extends Record<string, unknown>,\n  TTransition extends {\n    from: TStepId | \"*\";\n    event: string;\n    when?: (\n      args: JourneyTransitionArgs<TContext, TStepId, TEventMap, THandlers>\n    ) => boolean | Promise<boolean>;\n    timeoutMs?: number;\n    id?: string;\n    label?: string;\n  }\n>(\n  transitions: readonly TTransition[],\n  snapshot: JourneySnapshot<TContext, TStepId>,\n  event: JourneyEvent<TStepId, TEventMap>,\n  signal: AbortSignal,\n  handlers: THandlers,\n  hooks?: {\n    onAsyncGuardStart?: (transition: TTransition) => void;\n    onAsyncGuardSuccess?: (transition: TTransition) => void;\n    onAsyncGuardError?: (transition: TTransition, error: unknown) => void;\n  },\n  defaultTimeoutMs?: number\n): Promise<TTransition | null> => {\n  for (const transition of transitions) {\n    const fromMatches = transition.from === \"*\" || transition.from === snapshot.currentStepId;\n    const eventMatches = transition.event === event.type;\n\n    if (!fromMatches || !eventMatches) {\n      continue;\n    }\n\n    if (!transition.when) {\n      return transition;\n    }\n\n    let guardResult: boolean | Promise<boolean>;\n    if (signal.aborted) {\n      throw signal.reason;\n    }\n\n    guardResult = (\n      transition.when as (\n        args: JourneyTransitionArgs<TContext, TStepId, TEventMap, THandlers>\n      ) => boolean | Promise<boolean>\n    )({\n      snapshot,\n      context: snapshot.context,\n      from: snapshot.currentStepId,\n      timeline: snapshot.history.timeline,\n      index: snapshot.history.index,\n      event,\n      signal,\n      handlers\n    });\n\n    const asyncGuard = isPromiseLike(guardResult);\n    const asyncGuardPromise = asyncGuard ? (guardResult as PromiseLike<boolean>) : null;\n\n    let allowed: boolean;\n    try {\n      if (asyncGuard) {\n        hooks?.onAsyncGuardStart?.(transition);\n        allowed = await withTimeout(\n          withAbortSignal(asyncGuardPromise as PromiseLike<boolean>, signal),\n          transition.timeoutMs ?? defaultTimeoutMs,\n          () =>\n            new JourneyTimeoutError(\n              `Transition guard timed out after ${transition.timeoutMs ?? defaultTimeoutMs}ms (event: ${event.type}, transition: ${transition.id ?? \"<anonymous>\"}).`\n            )\n        );\n      } else {\n        allowed = guardResult as boolean;\n      }\n    } catch (error) {\n      if (asyncGuard) {\n        hooks?.onAsyncGuardError?.(transition, error);\n      }\n      throw error;\n    }\n\n    if (asyncGuard) {\n      hooks?.onAsyncGuardSuccess?.(transition);\n    }\n\n    if (allowed) {\n      return transition;\n    }\n  }\n\n  return null;\n};\n\nexport const transitionSnapshot = <TContext extends JourneyJsonObject, TStepId extends string>(\n  snapshot: JourneySnapshot<TContext, TStepId>,\n  nextCurrent: TStepId,\n  nextContext: TContext\n): JourneySnapshot<TContext, TStepId> => {\n  const baseTimeline = snapshot.history.timeline.slice(0, snapshot.history.index + 1);\n  let nextTimeline = baseTimeline;\n  if (nextCurrent !== snapshot.currentStepId) {\n    nextTimeline = [...baseTimeline, nextCurrent];\n  }\n\n  const nextIndex = nextTimeline.length - 1;\n  const visited = appendVisited(snapshot.visited, nextCurrent);\n\n  return buildSnapshot(\n    nextTimeline,\n    nextIndex,\n    nextContext,\n    snapshot.status,\n    snapshot.async,\n    visited\n  );\n};\n"],
-  "mappings": "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",
-  "names": ["analytics_exports", "__export", "createAnalyticsPlugin", "__toCommonJS", "isDevelopmentEnvironment", "diagnosticGlobal", "nodeEnv", "warnInDevelopment", "message", "detail", "buildBasePayload", "context", "createAnalyticsPlugin", "options", "unsubscribe", "startedAt", "activeStepEnteredAt", "trackSafely", "event", "tracked", "error", "warnInDevelopment", "machine", "typedMachine", "emitTracked", "sourceEvent", "buildStepMetaPayload", "stepId", "stepMeta", "buildTransitionMetaPayload", "from", "to", "fromStepMeta", "toStepMeta", "typedEvent", "snapshot", "basePayload", "name", "payload"]
-}

package/dist/plugins/analytics/index.d.cts

@@ -1,25 +0,0 @@
-import type { JourneyAnalyticsPluginOptions, JourneyAnalyticsTrackedEvent, JourneyJsonObject, JourneyMachine } from "../../types";
-export type JourneyAnalyticsMachineExtension<TContext extends JourneyJsonObject, TStepId extends string, TStepMeta> = {
-    trackAnalyticsEvent: (name: string, payload?: Record<string, unknown>) => JourneyAnalyticsTrackedEvent<TContext, TStepId, TStepMeta>;
-};
-export type JourneyAnalyticsMachine<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>, TStepMeta = unknown, THandlers extends Record<string, unknown> = Record<never, never>> = JourneyMachine<TContext, TStepId, TEventMap, TStepMeta, THandlers> & JourneyAnalyticsMachineExtension<TContext, TStepId, TStepMeta>;
-/** Creates a plugin that converts journey observation events into analytics envelopes. */
-export declare const createAnalyticsPlugin: <TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>, TStepMeta = unknown>(options: JourneyAnalyticsPluginOptions<TContext, TStepId, TEventMap, TStepMeta>) => {
-    name: string;
-    setup: <TContext_1 extends JourneyJsonObject, TStepId_1 extends string, TEventMap_1 extends Record<string, unknown> = Record<never, never>, TStepMeta_1 = unknown, THandlers extends Record<string, unknown> = Record<never, never>>() => {
-        augmentMachine: ({ machine }: {
-            machine: JourneyMachine<TContext_1, TStepId_1, TEventMap_1, TStepMeta_1, THandlers>;
-            journey: import("../..").JourneyDefinition<TContext_1, TStepId_1, TEventMap_1, TStepMeta_1, THandlers>;
-            resolvedJourney: import("../../types").JourneyResolvedDefinition<TContext_1, TStepId_1, TEventMap_1, TStepMeta_1, THandlers>;
-        }) => {
-            trackAnalyticsEvent: (name: string, payload?: Record<string, unknown>) => {
-                payload: Record<string, unknown>;
-                machineId?: string;
-                name: string;
-                timestamp: number;
-            };
-        };
-        dispose: () => void;
-    };
-};
-export type { JourneyAnalyticsPluginOptions, JourneyAnalyticsTrackedEvent } from "../../types";

package/dist/plugins/analytics/index.d.ts

@@ -1,25 +0,0 @@
-import type { JourneyAnalyticsPluginOptions, JourneyAnalyticsTrackedEvent, JourneyJsonObject, JourneyMachine } from "../../types";
-export type JourneyAnalyticsMachineExtension<TContext extends JourneyJsonObject, TStepId extends string, TStepMeta> = {
-    trackAnalyticsEvent: (name: string, payload?: Record<string, unknown>) => JourneyAnalyticsTrackedEvent<TContext, TStepId, TStepMeta>;
-};
-export type JourneyAnalyticsMachine<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>, TStepMeta = unknown, THandlers extends Record<string, unknown> = Record<never, never>> = JourneyMachine<TContext, TStepId, TEventMap, TStepMeta, THandlers> & JourneyAnalyticsMachineExtension<TContext, TStepId, TStepMeta>;
-/** Creates a plugin that converts journey observation events into analytics envelopes. */
-export declare const createAnalyticsPlugin: <TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>, TStepMeta = unknown>(options: JourneyAnalyticsPluginOptions<TContext, TStepId, TEventMap, TStepMeta>) => {
-    name: string;
-    setup: <TContext_1 extends JourneyJsonObject, TStepId_1 extends string, TEventMap_1 extends Record<string, unknown> = Record<never, never>, TStepMeta_1 = unknown, THandlers extends Record<string, unknown> = Record<never, never>>() => {
-        augmentMachine: ({ machine }: {
-            machine: JourneyMachine<TContext_1, TStepId_1, TEventMap_1, TStepMeta_1, THandlers>;
-            journey: import("../..").JourneyDefinition<TContext_1, TStepId_1, TEventMap_1, TStepMeta_1, THandlers>;
-            resolvedJourney: import("../../types").JourneyResolvedDefinition<TContext_1, TStepId_1, TEventMap_1, TStepMeta_1, THandlers>;
-        }) => {
-            trackAnalyticsEvent: (name: string, payload?: Record<string, unknown>) => {
-                payload: Record<string, unknown>;
-                machineId?: string;
-                name: string;
-                timestamp: number;
-            };
-        };
-        dispose: () => void;
-    };
-};
-export type { JourneyAnalyticsPluginOptions, JourneyAnalyticsTrackedEvent } from "../../types";

package/dist/plugins/analytics/index.js

@@ -1,2 +0,0 @@
-var l=()=>{let n=globalThis;if(typeof n.__DEV__=="boolean")return n.__DEV__;let i=n.process?.env?.NODE_ENV;return i===void 0||i==="development"},m=(n,i)=>{if(!(!l()||typeof console>"u")){if(i===void 0){console.warn(n);return}console.warn(n,i)}};var f=({context:n})=>({context:n}),b=n=>{let i,d=null,u=null,T=(p,a)=>{try{n.track(a)}catch(t){if(n.onError){n.onError(t,p);return}m("Journey analytics track() threw without an onError handler.",t)}};return{name:"analytics",setup:()=>({augmentMachine:({machine:p})=>{let a=p,t=(o,e)=>{T(o,e)},c=o=>{if(!n.includeStepMeta)return{};let e=a.getStepMeta(o);return e===void 0?{}:{stepMeta:e}},y=({from:o,to:e})=>{if(!n.includeStepMeta)return{};let s=a.getStepMeta(o),r=e==="COMPLETE"||e==="TERMINATED"?void 0:a.getStepMeta(e);return{...s===void 0?{}:{fromStepMeta:s},...r===void 0?{}:{toStepMeta:r}}};return i=a.subscribeEvent(o=>{let e=o,s=a.getSnapshot(),r=f({context:s.context});switch(e.type){case"journey.start":d=e.timestamp,u=e.timestamp,t(e,{name:"journey_started",timestamp:e.timestamp,...n.machineId?{machineId:n.machineId}:{},payload:{stepId:e.stepId,...c(e.stepId),...r}});return;case"step.enter":u=e.timestamp,t(e,{name:"step_viewed",timestamp:e.timestamp,...n.machineId?{machineId:n.machineId}:{},payload:{stepId:e.stepId,...c(e.stepId),...r}});return;case"step.exit":t(e,{name:"step_exited",timestamp:e.timestamp,...n.machineId?{machineId:n.machineId}:{},payload:{stepId:e.stepId,...u===null?{}:{dwellMs:Math.max(0,e.timestamp-u)},...c(e.stepId),...r}});return;case"transition.start":t(e,{name:"transition_started",timestamp:e.timestamp,...n.machineId?{machineId:n.machineId}:{},payload:{from:e.from,eventType:e.event.type,...r}});return;case"transition.success":t(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,...e.label!==void 0?{label:e.label}:{},...y({from:e.from,to:e.to}),...r}});return;case"transition.error":t(e,{name:"transition_failed",timestamp:e.timestamp,...n.machineId?{machineId:n.machineId}:{},payload:{from:e.from,eventType:e.eventType,transitionId:e.transitionId,...e.label!==void 0?{label:e.label}:{},error:e.error,...r}});return;case"journey.completed":t(e,{name:"journey_completed",timestamp:e.timestamp,...n.machineId?{machineId:n.machineId}:{},payload:{stepId:e.stepId,...d===null?{}:{durationMs:Math.max(0,e.timestamp-d)},...c(e.stepId),...r}});return;case"journey.terminated":t(e,{name:"journey_terminated",timestamp:e.timestamp,...n.machineId?{machineId:n.machineId}:{},payload:{stepId:e.stepId,...d===null?{}:{durationMs:Math.max(0,e.timestamp-d)},...c(e.stepId),...r}});return;case"navigation.previous":t(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,...y({from:e.from,to:e.to}),...r}});return;case"navigation.lastVisited":t(e,{name:"navigation_last_visited",timestamp:e.timestamp,...n.machineId?{machineId:n.machineId}:{},payload:{from:e.from,to:e.to,...y({from:e.from,to:e.to}),...r}});return}}),{trackAnalyticsEvent:(o,e={})=>{let s={name:o,timestamp:Date.now(),...n.machineId?{machineId:n.machineId}:{},payload:e};return T(s,s),s}}},dispose:()=>{i?.()}})}};export{b as createAnalyticsPlugin};
-//# sourceMappingURL=index.js.map