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

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

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

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

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

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

@@ -0,0 +1,9 @@
+import type { JourneyJsonObject, 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

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

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

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

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

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

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

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/journey-machine/helpers.ts", "../../../src/plugins/analytics/index.ts"],
+  "sourcesContent": ["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", "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"],
+  "mappings": "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",
+  "names": ["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/autosave/index.cjs

@@ -0,0 +1,2 @@
+"use strict";var P=Object.defineProperty;var q=Object.getOwnPropertyDescriptor;var K=Object.getOwnPropertyNames;var U=Object.prototype.hasOwnProperty;var Q=(e,n)=>{for(var t in n)P(e,t,{get:n[t],enumerable:!0})},X=(e,n,t,o)=>{if(n&&typeof n=="object"||typeof n=="function")for(let r of K(n))!U.call(e,r)&&r!==t&&P(e,r,{get:()=>n[r],enumerable:!(o=q(n,r))||o.enumerable});return e};var Y=e=>X(P({},"__esModule",{value:!0}),e);var ye={};Q(ye,{createAutosavePlugin:()=>le});module.exports=Y(ye);var x=e=>typeof e=="object"&&e!==null&&!Array.isArray(e)&&(Object.getPrototypeOf(e)===Object.prototype||Object.getPrototypeOf(e)===null),J=e=>Array.isArray(e)?e.map(n=>J(n)):x(e)?Object.fromEntries(Object.entries(e).map(([n,t])=>[n,J(t)])):e,R=e=>{if(e===null)return"null";if(Array.isArray(e))return"array";if(typeof e=="object"){let n=e.constructor?.name;return n&&n!=="Object"?n:"object"}return typeof e};function C(e,n,t,o=[]){if(e===null||typeof e=="string"||typeof e=="number"||typeof e=="boolean")return;let r=o.length===0?n:`${n}.${o.join(".")}`;if(e===void 0)throw new Error(`${r} must be JSON-serializable. Received undefined.`);if(typeof e=="bigint"||typeof e=="symbol"||typeof e=="function")throw new Error(`${r} must be JSON-serializable. Received ${typeof e}.`);if(typeof e!="object")throw new Error(`${r} must be JSON-serializable. Received ${R(e)}.`);if(t.seen.has(e))throw new Error(`${r} must be JSON-serializable. Circular references are not supported.`);if(t.seen.add(e),Array.isArray(e)){for(let[s,i]of e.entries())C(i,n,t,[...o,String(s)]);return}if(!x(e))throw new Error(`${r} must be JSON-serializable. Received non-plain ${R(e)}.`);for(let[s,i]of Object.entries(e))C(i,n,t,[...o,s])}function g(e,n="Journey context"){return C(e,n,{seen:new WeakSet}),e}var Z=e=>J(g(e));var j=e=>[...new Set(e)],ee=(e,n)=>Object.fromEntries(n.map(t=>[t,e[t]===!0])),I=(e,n)=>{let t=n??j(e),o=Object.fromEntries(t.map(r=>[r,!1]));for(let r of e)o[r]=!0;return o};var ne=()=>{let e=globalThis;if(typeof e.__DEV__=="boolean")return e.__DEV__;let n=e.process?.env?.NODE_ENV;return n===void 0||n==="development"},M=(e,n)=>{if(!(!ne()||typeof console>"u")){if(n===void 0){console.warn(e);return}console.warn(e,n)}};var te=()=>({phase:"idle",eventType:null,transitionId:null,error:null}),$=e=>({isLoading:!1,byStep:Object.fromEntries(Object.keys(e).map(t=>[t,te()]))});var E=(e,n,t,o,r,s)=>{if(e.length===0)throw new Error("Journey timeline cannot be empty.");let i=Math.max(0,Math.min(Math.trunc(n),e.length-1)),u=e[i],c=j(s?[...Object.keys(s),...e]:e);return{status:o,currentStepId:u,history:{timeline:[...e],index:i},context:Z(t),visited:s?ee(s,c):I(e,c),async:J(r)}};var k=e=>typeof e=="object"&&e!==null,V=e=>e==="idled"||e==="running"||e==="completed"||e==="terminated",re=(e,n)=>{if(typeof e!="string")throw new Error(`Persistence ${n} entries must be strings.`);let t=e.trim();if(!t)throw new Error(`Persistence ${n} entries must not be empty.`);if(t.includes("[")||t.includes("]")||t.includes("*")||t.startsWith(".")||t.endsWith(".")||t.includes(".."))throw new Error(`Persistence ${n} entry "${t}" must use exact dot-separated object keys.`);let o=t.split(".");if(o.some(r=>!r||r.trim()!==r||/^[0-9]+$/.test(r)))throw new Error(`Persistence ${n} entry "${t}" must use exact dot-separated object keys.`);return o},L=(e,n)=>{if(e===void 0)return null;if(!Array.isArray(e))throw new Error(`Persistence ${n} must be an array of dot-separated strings.`);let t=new Map;for(let o of e){let r=re(o,n);t.set(r.join("."),r)}return[...t.values()]},_=(e,n)=>n.length<=e.length&&n.every((t,o)=>e[o]===t),z=(e,n)=>e.some(t=>_(n,t)),oe=(e,n)=>e.some(t=>_(t,n)),F=(e,n,t,o=[])=>{if(z(t,o))return{value:void 0,changed:!0,included:!1};let r=n===null,s=r||z(n,o),i=r||oe(n,o);if(!s&&!i)return{value:void 0,changed:!0,included:!1};if(!x(e))return{value:e,changed:!s,included:s};let u=!1,c={};for(let[y,T]of Object.entries(e)){let p=F(T,n,t,[...o,y]);if(!p.included){u=!0;continue}c[y]=p.value,p.changed&&(u=!0)}return{value:c,changed:u||Object.keys(c).length!==Object.keys(e).length,included:!0}},N=(e,n)=>{if(x(e)&&x(n)){let t=new Map;for(let[o,r]of Object.entries(e))t.set(o,r);for(let[o,r]of Object.entries(n))t.set(o,N(e[o],r));return Object.fromEntries(t)}return n===void 0?e??null:n},se=(e,n)=>N(e,n),ie=()=>{let e=globalThis.localStorage;return!e||typeof e.getItem!="function"||typeof e.setItem!="function"||typeof e.removeItem!="function"?null:e},A=(e,n)=>{if(n){n(e);return}M("Journey persistence encountered an error without an onError handler.",e)},ae=e=>{if(!e)return null;let n=e.storage;if(n==null)try{n=ie()}catch(r){return A(r,e.onError),null}if(!n)return null;let t,o;try{let r=L(e.allowList,"allowList"),s=L(e.blockList,"blockList");t=r?r.map(i=>i.join(".")):void 0,o=s?s.map(i=>i.join(".")):[]}catch(r){return A(r,e.onError),null}return{key:e.key,storage:n,version:e.version??1,clearOnReset:e.clearOnReset??!0,...t?{allowList:t}:{},blockList:o,serialize:e.serialize??JSON.stringify,deserialize:e.deserialize??JSON.parse,...e.migrate?{migrate:e.migrate}:{},...e.onError?{onError:e.onError}:{}}},de=(e,n,t)=>{let o=I(n,t);if(k(e)){let r=!1,s={...o};for(let i of t){let u=e[i];if(u===!0){s[i]=!0;continue}if(u===!1){o[i]&&(r=!0);continue}r=!0}return{visited:s,needsRewrite:r}}if(Array.isArray(e)){let r=I(e.filter(i=>typeof i=="string"&&t.includes(i)),t);return{visited:Object.fromEntries(t.map(i=>[i,o[i]||r[i]])),needsRewrite:!0}}return{visited:o,needsRewrite:!0}},D=(e,n,t)=>{if(!k(e))return null;let o=!1,r=k(e.history)?e.history:null;r||(o=!0);let s=r?.timeline??e.timeline,i=Array.isArray(s)?s.filter(a=>typeof a=="string"&&a in n):[],u=typeof e.currentStepId=="string"&&e.currentStepId in n?e.currentStepId:typeof e.current=="string"&&e.current in n?e.current:null;if(i.length===0){if(!u)return null;i.push(u),o=!0}let c=i.length-1,y=r?.index??e.index;if(typeof y=="number"&&Number.isFinite(y))c=Math.max(0,Math.min(Math.trunc(y),i.length-1)),c!==y&&(o=!0);else if(u){let a=i.lastIndexOf(u);a>=0&&(c=a,o=!0)}let T=V(e.status)?e.status:"idled";V(e.status)||(o=!0);let p=Object.keys(n),{visited:S,needsRewrite:m}=de(e.visited,i,p);return m&&(o=!0),{snapshot:{currentStepId:i[c],history:{timeline:i,index:c},context:g("context"in e?e.context:t,"Persisted journey context"),status:T,visited:S},needsRewrite:o}},H=e=>{let{initial:n,context:t,steps:o,options:r}=e,s=ae(r),i=s?.allowList?s.allowList.map(a=>a.split(".")):null,u=s?s.blockList.map(a=>a.split(".")):[],c=a=>{A(a,s?.onError)},y=a=>{if(!s||i===null&&u.length===0)return{context:a,changed:!1};if(!x(a))return{context:a,changed:!1};let d=F(a,i,u);return{context:d.included&&x(d.value)?d.value:{},changed:d.changed}},T=a=>{if(s)try{let{context:d}=y(a.context),l={version:s.version,snapshot:{currentStepId:a.currentStepId,history:{timeline:[...a.history.timeline],index:a.history.index},context:d,status:a.status,visited:{...a.visited}}};s.storage.setItem(s.key,s.serialize(l))}catch(d){c(d)}},p=()=>{if(s)try{s.storage.removeItem(s.key)}catch(a){c(a)}},S=()=>E([n],0,t,"idled",$(o)),m=(a=S())=>{let d=E(a.history.timeline,a.history.index,a.context,a.status,a.async,a.visited);if(!s)return d;try{let l=s.storage.getItem(s.key);if(!l)return d;let h=s.deserialize(l);if(!k(h))return d;let b=h.version;if(typeof b!="number")return d;let f=null,v=!1;if(b===s.version){let w=D(h.snapshot,o,t);f=w?.snapshot??null,v=!!w?.needsRewrite}else if(s.migrate){let w=s.migrate(h.snapshot,b);f=D(w,o,t)?.snapshot??null,v=f!==null,f||c(new Error(`Journey persistence migrate() returned data that could not be coerced into a valid snapshot. Falling back to the initial snapshot (persisted version: ${b}, current version: ${s.version}).`))}if(!f)return d;let{context:G,changed:B}=y(f.context),W=se(d.context,G),O=E(f.history.timeline,f.history.index,g(W,"Hydrated journey context"),f.status==="running"?"idled":f.status,d.async,f.visited);return(v||B)&&T(O),O}catch(l){return c(l),d}};return{clearOnReset:s?.clearOnReset??!0,hydrateSnapshot:m,persistSnapshot:T,removePersistedSnapshot:p}};var ue=["context","navigation","reset","start","transition"],ce=e=>typeof e!="number"||!Number.isFinite(e)?300:Math.max(0,Math.trunc(e)),le=e=>{let n=ce(e.debounceMs),t=e.hydrate??!0,o=new Set(e.saveOn??ue),r={status:"idle"},s=null,i=null,u=!1;return{name:"autosave",__extension__:void 0,setup:(({resolvedJourney:y})=>{let T=e,p=H({initial:y.initial,context:y.context,steps:y.steps,options:{...T,onError:d=>{u=!0,r={status:"error",...r.lastSavedAt!==void 0?{lastSavedAt:r.lastSavedAt}:{},...r.pendingReason!==void 0?{pendingReason:r.pendingReason}:{},error:d},T.onError?.(d)}}}),S=()=>{s!==null&&(clearTimeout(s),s=null)},m=()=>{if(S(),!i)return;let d=i;if(i=null,u=!1,p.persistSnapshot(d.snapshot),u)return;let l=Date.now();r={status:"saved",lastSavedAt:l},T.onSaved?.({snapshot:d.snapshot,reason:d.reason,timestamp:l})},a=(d,l)=>{if(i={snapshot:d,reason:l},r={status:"pending",...r.lastSavedAt!==void 0?{lastSavedAt:r.lastSavedAt}:{},pendingReason:l},n===0){m();return}S(),s=setTimeout(()=>{m()},n)};return{hydrateSnapshot:d=>t?p.hydrateSnapshot(d):d,onSnapshotChange:({snapshot:d,reason:l})=>{if(l!=="async"){if(l==="reset"&&p.clearOnReset){S(),i=null,p.removePersistedSnapshot(),r={status:"idle"};return}o.has(l)&&a(d,l)}},augmentMachine:()=>({getAutosaveState:()=>({...r}),flushAutosave:async()=>{m()},clearAutosave:()=>{S(),i=null,p.removePersistedSnapshot(),r={status:"idle"}}}),dispose:()=>{S()}}})}};0&&(module.exports={createAutosavePlugin});
+//# sourceMappingURL=index.cjs.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/plugins/autosave/index.ts", "../../../src/journey-machine/helpers.ts", "../../../src/plugins/persistence/controller.ts"],
+  "sourcesContent": ["import { createPersistenceController } from \"../persistence/controller\";\n\nimport type {\n  JourneyAutosavePluginOptions,\n  JourneyAutosaveState,\n  JourneyJsonObject,\n  JourneyMachine,\n  JourneyMachinePlugin,\n  JourneyMachineSnapshotReason,\n  JourneySnapshot\n} from \"../../types\";\n\nconst DEFAULT_SAVE_REASONS = [\"context\", \"navigation\", \"reset\", \"start\", \"transition\"] as const;\n\nconst normalizeDebounceMs = (value: number | undefined) => {\n  if (typeof value !== \"number\" || !Number.isFinite(value)) {\n    return 300;\n  }\n\n  return Math.max(0, Math.trunc(value));\n};\n\nexport type JourneyAutosaveMachineExtension = {\n  getAutosaveState: () => JourneyAutosaveState;\n  flushAutosave: () => Promise<void>;\n  clearAutosave: () => void;\n};\n\nexport type JourneyAutosaveMachine<\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  JourneyAutosaveMachineExtension;\n\n/**\n * Creates a plugin that debounces snapshot persistence and exposes autosave\n * runtime state without requiring the persistence plugin as a public dependency.\n */\nexport const createAutosavePlugin = <TContext extends JourneyJsonObject, TStepId extends string>(\n  options: JourneyAutosavePluginOptions<TContext, TStepId>\n) => {\n  const debounceMs = normalizeDebounceMs(options.debounceMs);\n  const hydrate = options.hydrate ?? true;\n  const saveReasons = new Set(options.saveOn ?? DEFAULT_SAVE_REASONS);\n  let autosaveState: JourneyAutosaveState = { status: \"idle\" };\n  let timeoutId: ReturnType<typeof setTimeout> | null = null;\n  let pending: {\n    snapshot: JourneySnapshot<JourneyJsonObject, string>;\n    reason: JourneyMachineSnapshotReason;\n  } | null = null;\n  let lastSaveErrored = false;\n\n  const setup = (({ resolvedJourney }) => {\n    const resolvedOptions = options as unknown as JourneyAutosavePluginOptions<TContext, TStepId>;\n    const controller = createPersistenceController({\n      initial: resolvedJourney.initial as unknown as TStepId,\n      context: resolvedJourney.context as unknown as TContext,\n      steps: resolvedJourney.steps as unknown as Record<TStepId, unknown>,\n      options: {\n        ...resolvedOptions,\n        onError: (error) => {\n          lastSaveErrored = true;\n          autosaveState = {\n            status: \"error\",\n            ...(autosaveState.lastSavedAt !== undefined\n              ? { lastSavedAt: autosaveState.lastSavedAt }\n              : {}),\n            ...(autosaveState.pendingReason !== undefined\n              ? { pendingReason: autosaveState.pendingReason }\n              : {}),\n            error\n          };\n          resolvedOptions.onError?.(error);\n        }\n      } as JourneyAutosavePluginOptions<TContext, TStepId>\n    });\n\n    const clearTimer = () => {\n      if (timeoutId !== null) {\n        clearTimeout(timeoutId);\n        timeoutId = null;\n      }\n    };\n\n    const commitPending = () => {\n      clearTimer();\n      if (!pending) {\n        return;\n      }\n\n      const current = pending;\n      pending = null;\n      lastSaveErrored = false;\n      controller.persistSnapshot(\n        current.snapshot as unknown as Parameters<typeof controller.persistSnapshot>[0]\n      );\n      if (lastSaveErrored) {\n        return;\n      }\n\n      const timestamp = Date.now();\n      autosaveState = {\n        status: \"saved\",\n        lastSavedAt: timestamp\n      };\n      resolvedOptions.onSaved?.({\n        snapshot: current.snapshot as unknown as JourneySnapshot<TContext, TStepId>,\n        reason: current.reason,\n        timestamp\n      });\n    };\n\n    const scheduleSave = (\n      snapshot: Parameters<typeof controller.persistSnapshot>[0],\n      reason: JourneyMachineSnapshotReason\n    ) => {\n      pending = {\n        snapshot: snapshot as unknown as JourneySnapshot<JourneyJsonObject, string>,\n        reason\n      };\n      autosaveState = {\n        status: \"pending\",\n        ...(autosaveState.lastSavedAt !== undefined\n          ? { lastSavedAt: autosaveState.lastSavedAt }\n          : {}),\n        pendingReason: reason\n      };\n\n      if (debounceMs === 0) {\n        commitPending();\n        return;\n      }\n\n      clearTimer();\n      timeoutId = setTimeout(() => {\n        commitPending();\n      }, debounceMs);\n    };\n\n    return {\n      hydrateSnapshot: (snapshot) =>\n        hydrate\n          ? (controller.hydrateSnapshot(snapshot as never) as unknown as typeof snapshot)\n          : snapshot,\n      onSnapshotChange: ({ snapshot, reason }) => {\n        if (reason === \"async\") {\n          return;\n        }\n\n        if (reason === \"reset\" && controller.clearOnReset) {\n          clearTimer();\n          pending = null;\n          controller.removePersistedSnapshot();\n          autosaveState = { status: \"idle\" };\n          return;\n        }\n\n        if (!saveReasons.has(reason)) {\n          return;\n        }\n\n        scheduleSave(\n          snapshot as unknown as Parameters<typeof controller.persistSnapshot>[0],\n          reason\n        );\n      },\n      augmentMachine: () => ({\n        getAutosaveState: () => ({ ...autosaveState }),\n        flushAutosave: async () => {\n          commitPending();\n        },\n        clearAutosave: () => {\n          clearTimer();\n          pending = null;\n          controller.removePersistedSnapshot();\n          autosaveState = { status: \"idle\" };\n        }\n      }),\n      dispose: () => {\n        clearTimer();\n      }\n    };\n  }) as JourneyMachinePlugin[\"setup\"];\n\n  return {\n    name: \"autosave\",\n    __extension__: undefined as unknown as JourneyAutosaveMachineExtension,\n    setup\n  } satisfies JourneyMachinePlugin;\n};\n\nexport type { JourneyAutosavePluginOptions, JourneyAutosaveState } 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", "import type {\n  JourneyPersistedState,\n  JourneyPersistenceOptions,\n  JourneyStorage,\n  ResolvedPersistence\n} from \"../../types/persistence.types\";\nimport type {\n  JourneyJsonValue,\n  JourneyJsonObject,\n  JourneySnapshot,\n  JourneySnapshotStateBase,\n  JourneyStatus\n} from \"../../types/journey.types\";\nimport {\n  assertSerializableContext,\n  buildInitialAsyncState,\n  buildSnapshot,\n  buildVisitedFromTimeline,\n  isPlainObject,\n  warnInDevelopment\n} from \"../../journey-machine/helpers\";\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === \"object\" && value !== null;\n\nconst isStatusValue = (value: unknown): value is JourneyStatus =>\n  value === \"idled\" || value === \"running\" || value === \"completed\" || value === \"terminated\";\n\ntype PersistencePath = readonly string[];\n\nconst normalizePersistencePath = (\n  path: unknown,\n  optionName: \"allowList\" | \"blockList\"\n): PersistencePath => {\n  if (typeof path !== \"string\") {\n    throw new Error(`Persistence ${optionName} entries must be strings.`);\n  }\n\n  const trimmedPath = path.trim();\n  if (!trimmedPath) {\n    throw new Error(`Persistence ${optionName} entries must not be empty.`);\n  }\n\n  if (\n    trimmedPath.includes(\"[\") ||\n    trimmedPath.includes(\"]\") ||\n    trimmedPath.includes(\"*\") ||\n    trimmedPath.startsWith(\".\") ||\n    trimmedPath.endsWith(\".\") ||\n    trimmedPath.includes(\"..\")\n  ) {\n    throw new Error(\n      `Persistence ${optionName} entry \"${trimmedPath}\" must use exact dot-separated object keys.`\n    );\n  }\n\n  const segments = trimmedPath.split(\".\");\n  if (\n    segments.some((segment) => !segment || segment.trim() !== segment || /^[0-9]+$/.test(segment))\n  ) {\n    throw new Error(\n      `Persistence ${optionName} entry \"${trimmedPath}\" must use exact dot-separated object keys.`\n    );\n  }\n\n  return segments;\n};\n\nconst normalizePersistencePaths = (\n  paths: unknown,\n  optionName: \"allowList\" | \"blockList\"\n): readonly PersistencePath[] | null => {\n  if (paths === undefined) {\n    return null;\n  }\n\n  if (!Array.isArray(paths)) {\n    throw new Error(`Persistence ${optionName} must be an array of dot-separated strings.`);\n  }\n\n  const normalized = new Map<string, PersistencePath>();\n  for (const path of paths) {\n    const resolvedPath = normalizePersistencePath(path, optionName);\n    normalized.set(resolvedPath.join(\".\"), resolvedPath);\n  }\n\n  return [...normalized.values()];\n};\n\nconst pathStartsWith = (path: readonly string[], prefix: readonly string[]): boolean =>\n  prefix.length <= path.length && prefix.every((segment, index) => path[index] === segment);\n\nconst pathHasAncestorMatch = (\n  candidates: readonly PersistencePath[],\n  path: readonly string[]\n): boolean => candidates.some((candidate) => pathStartsWith(path, candidate));\n\nconst pathHasDescendantMatch = (\n  candidates: readonly PersistencePath[],\n  path: readonly string[]\n): boolean => candidates.some((candidate) => pathStartsWith(candidate, path));\n\nconst filterContextValue = (\n  value: unknown,\n  allowList: readonly PersistencePath[] | null,\n  blockList: readonly PersistencePath[],\n  path: readonly string[] = []\n): { value: unknown; changed: boolean; included: boolean } => {\n  if (pathHasAncestorMatch(blockList, path)) {\n    return { value: undefined, changed: true, included: false };\n  }\n\n  const allowAll = allowList === null;\n  const pathIsAllowed = allowAll || pathHasAncestorMatch(allowList, path);\n  const pathHasAllowedDescendants = allowAll || pathHasDescendantMatch(allowList, path);\n\n  if (!pathIsAllowed && !pathHasAllowedDescendants) {\n    return { value: undefined, changed: true, included: false };\n  }\n\n  if (!isPlainObject(value)) {\n    return {\n      value,\n      changed: !pathIsAllowed,\n      included: pathIsAllowed\n    };\n  }\n\n  let changed = false;\n  const nextValue: Record<string, unknown> = {};\n\n  for (const [key, childValue] of Object.entries(value)) {\n    const result = filterContextValue(childValue, allowList, blockList, [...path, key]);\n    if (!result.included) {\n      changed = true;\n      continue;\n    }\n\n    nextValue[key] = result.value;\n    if (result.changed) {\n      changed = true;\n    }\n  }\n\n  return {\n    value: nextValue,\n    changed: changed || Object.keys(nextValue).length !== Object.keys(value).length,\n    included: true\n  };\n};\n\nconst mergePersistedValue = (\n  initialValue: JourneyJsonValue | undefined,\n  persistedValue: unknown\n): JourneyJsonValue => {\n  if (isPlainObject(initialValue) && isPlainObject(persistedValue)) {\n    const mergedEntries = new Map<string, JourneyJsonValue>();\n\n    for (const [key, value] of Object.entries(initialValue)) {\n      mergedEntries.set(key, value as JourneyJsonValue);\n    }\n\n    for (const [key, value] of Object.entries(persistedValue)) {\n      mergedEntries.set(\n        key,\n        mergePersistedValue(initialValue[key] as JourneyJsonValue | undefined, value)\n      );\n    }\n\n    return Object.fromEntries(mergedEntries) as JourneyJsonValue;\n  }\n\n  return persistedValue === undefined\n    ? (initialValue ?? null)\n    : (persistedValue as JourneyJsonValue);\n};\n\nconst mergePersistedContext = <TContext extends JourneyJsonObject>(\n  initialContext: TContext,\n  persistedContext: unknown\n): TContext => mergePersistedValue(initialContext, persistedContext) as TContext;\n\nconst resolveDefaultStorage = (): JourneyStorage | null => {\n  const localStorageCandidate = (globalThis as { localStorage?: Partial<JourneyStorage> })\n    .localStorage;\n\n  if (\n    !localStorageCandidate ||\n    typeof localStorageCandidate.getItem !== \"function\" ||\n    typeof localStorageCandidate.setItem !== \"function\" ||\n    typeof localStorageCandidate.removeItem !== \"function\"\n  ) {\n    return null;\n  }\n\n  return localStorageCandidate as JourneyStorage;\n};\n\nconst reportPersistenceError = (error: unknown, onError?: (error: unknown) => void) => {\n  if (onError) {\n    onError(error);\n    return;\n  }\n\n  warnInDevelopment(\"Journey persistence encountered an error without an onError handler.\", error);\n};\n\nconst resolvePersistence = <TContext extends JourneyJsonObject, TStepId extends string>(\n  options?: JourneyPersistenceOptions<TContext, TStepId>\n): ResolvedPersistence<TContext, TStepId> | null => {\n  if (!options) {\n    return null;\n  }\n\n  let storage: JourneyStorage | null | undefined = options.storage;\n  if (storage == null) {\n    try {\n      storage = resolveDefaultStorage();\n    } catch (error) {\n      reportPersistenceError(error, options.onError);\n      return null;\n    }\n  }\n\n  if (!storage) {\n    return null;\n  }\n\n  let allowList: readonly string[] | undefined;\n  let blockList: readonly string[];\n\n  try {\n    const normalizedAllowList = normalizePersistencePaths(options.allowList, \"allowList\");\n    const normalizedBlockList = normalizePersistencePaths(options.blockList, \"blockList\");\n\n    allowList = normalizedAllowList ? normalizedAllowList.map((path) => path.join(\".\")) : undefined;\n    blockList = normalizedBlockList ? normalizedBlockList.map((path) => path.join(\".\")) : [];\n  } catch (error) {\n    reportPersistenceError(error, options.onError);\n    return null;\n  }\n\n  return {\n    key: options.key,\n    storage,\n    version: options.version ?? 1,\n    clearOnReset: options.clearOnReset ?? true,\n    ...(allowList ? { allowList } : {}),\n    blockList,\n    serialize: options.serialize ?? JSON.stringify,\n    deserialize: options.deserialize ?? JSON.parse,\n    ...(options.migrate ? { migrate: options.migrate } : {}),\n    ...(options.onError ? { onError: options.onError } : {})\n  };\n};\n\nconst resolveVisitedFromPersistence = <TStepId extends string>(\n  visitedSource: unknown,\n  timeline: readonly TStepId[],\n  stepIds: readonly TStepId[]\n): {\n  visited: Record<TStepId, boolean>;\n  needsRewrite: boolean;\n} => {\n  const visitedFromTimeline = buildVisitedFromTimeline(timeline, stepIds);\n\n  if (isRecord(visitedSource)) {\n    let needsRewrite = false;\n    const visited = { ...visitedFromTimeline };\n\n    for (const stepId of stepIds) {\n      const persistedValue = visitedSource[stepId];\n\n      if (persistedValue === true) {\n        visited[stepId] = true;\n        continue;\n      }\n\n      if (persistedValue === false) {\n        if (visitedFromTimeline[stepId]) {\n          needsRewrite = true;\n        }\n        continue;\n      }\n\n      needsRewrite = true;\n    }\n\n    return { visited, needsRewrite };\n  }\n\n  if (Array.isArray(visitedSource)) {\n    const visitedFromArray = buildVisitedFromTimeline(\n      visitedSource.filter(\n        (step): step is TStepId => typeof step === \"string\" && stepIds.includes(step as TStepId)\n      ) as TStepId[],\n      stepIds\n    );\n    const visited = Object.fromEntries(\n      stepIds.map((stepId) => [stepId, visitedFromTimeline[stepId] || visitedFromArray[stepId]])\n    ) as Record<TStepId, boolean>;\n\n    return { visited, needsRewrite: true };\n  }\n\n  return { visited: visitedFromTimeline, needsRewrite: true };\n};\n\nconst coercePersistedSnapshot = <TContext extends JourneyJsonObject, TStepId extends string>(\n  value: unknown,\n  steps: Record<TStepId, unknown>,\n  fallbackContext: TContext\n): {\n  snapshot: JourneySnapshotStateBase<TContext, TStepId>;\n  needsRewrite: boolean;\n} | null => {\n  if (!isRecord(value)) {\n    return null;\n  }\n\n  let needsRewrite = false;\n\n  const rawHistory = isRecord(value.history) ? value.history : null;\n  if (!rawHistory) {\n    needsRewrite = true;\n  }\n\n  const rawTimeline = rawHistory?.timeline ?? value.timeline;\n  const timeline = Array.isArray(rawTimeline)\n    ? (rawTimeline.filter(\n        (step): step is TStepId => typeof step === \"string\" && step in steps\n      ) as TStepId[])\n    : [];\n\n  const currentStepIdValue =\n    typeof value.currentStepId === \"string\" && value.currentStepId in steps\n      ? (value.currentStepId as TStepId)\n      : typeof value.current === \"string\" && value.current in steps\n        ? (value.current as TStepId)\n        : null;\n\n  if (timeline.length === 0) {\n    if (!currentStepIdValue) {\n      return null;\n    }\n    timeline.push(currentStepIdValue);\n    needsRewrite = true;\n  }\n\n  let index = timeline.length - 1;\n  const rawIndex = rawHistory?.index ?? value.index;\n  if (typeof rawIndex === \"number\" && Number.isFinite(rawIndex)) {\n    index = Math.max(0, Math.min(Math.trunc(rawIndex), timeline.length - 1));\n    if (index !== rawIndex) {\n      needsRewrite = true;\n    }\n  } else if (currentStepIdValue) {\n    const inferredIndex = timeline.lastIndexOf(currentStepIdValue);\n    if (inferredIndex >= 0) {\n      index = inferredIndex;\n      needsRewrite = true;\n    }\n  }\n\n  const status = isStatusValue(value.status) ? value.status : \"idled\";\n  if (!isStatusValue(value.status)) {\n    needsRewrite = true;\n  }\n\n  const stepIds = Object.keys(steps) as TStepId[];\n  const { visited, needsRewrite: visitedNeedsRewrite } = resolveVisitedFromPersistence(\n    value.visited,\n    timeline,\n    stepIds\n  );\n  if (visitedNeedsRewrite) {\n    needsRewrite = true;\n  }\n\n  return {\n    snapshot: {\n      currentStepId: timeline[index] as TStepId,\n      history: {\n        timeline,\n        index\n      },\n      context: assertSerializableContext(\n        (\"context\" in value ? value.context : fallbackContext) as TContext,\n        \"Persisted journey context\"\n      ),\n      status,\n      visited\n    },\n    needsRewrite\n  };\n};\n\n/**\n * Creates a persistence controller for snapshots, including hydration,\n * serialization, and storage error handling.\n */\nexport const createPersistenceController = <\n  TContext extends JourneyJsonObject,\n  TStepId extends string\n>(args: {\n  initial: TStepId;\n  context: TContext;\n  steps: Record<TStepId, unknown>;\n  options?: JourneyPersistenceOptions<TContext, TStepId>;\n}) => {\n  const { initial, context, steps, options } = args;\n  const persistence = resolvePersistence(options);\n  const allowList = persistence?.allowList\n    ? persistence.allowList.map((path) => path.split(\".\"))\n    : null;\n  const blockList = persistence ? persistence.blockList.map((path) => path.split(\".\")) : [];\n\n  const reportResolvedPersistenceError = (error: unknown) => {\n    reportPersistenceError(error, persistence?.onError);\n  };\n\n  const filterPersistedContext = (value: TContext): { context: TContext; changed: boolean } => {\n    if (!persistence || (allowList === null && blockList.length === 0)) {\n      return { context: value, changed: false };\n    }\n\n    if (!isPlainObject(value)) {\n      return { context: value, changed: false };\n    }\n\n    const filtered = filterContextValue(value, allowList, blockList);\n    const filteredContext =\n      filtered.included && isPlainObject(filtered.value) ? filtered.value : {};\n\n    return {\n      context: filteredContext as TContext,\n      changed: filtered.changed\n    };\n  };\n\n  const persistSnapshot = (snapshot: JourneySnapshot<TContext, TStepId>) => {\n    if (!persistence) {\n      return;\n    }\n\n    try {\n      const { context: persistedContext } = filterPersistedContext(snapshot.context);\n      const persistedState: JourneyPersistedState<TContext, TStepId> = {\n        version: persistence.version,\n        snapshot: {\n          currentStepId: snapshot.currentStepId,\n          history: {\n            timeline: [...snapshot.history.timeline],\n            index: snapshot.history.index\n          },\n          context: persistedContext,\n          status: snapshot.status,\n          visited: { ...snapshot.visited }\n        }\n      };\n      persistence.storage.setItem(persistence.key, persistence.serialize(persistedState));\n    } catch (error) {\n      reportResolvedPersistenceError(error);\n    }\n  };\n\n  const removePersistedSnapshot = () => {\n    if (!persistence) {\n      return;\n    }\n\n    try {\n      persistence.storage.removeItem(persistence.key);\n    } catch (error) {\n      reportResolvedPersistenceError(error);\n    }\n  };\n\n  const buildBaseSnapshot = () =>\n    buildSnapshot([initial], 0, context, \"idled\", buildInitialAsyncState(steps));\n  const hydrateSnapshot = (\n    baseSnapshot: JourneySnapshot<TContext, TStepId> = buildBaseSnapshot()\n  ): JourneySnapshot<TContext, TStepId> => {\n    const resolvedBaseSnapshot = buildSnapshot(\n      baseSnapshot.history.timeline,\n      baseSnapshot.history.index,\n      baseSnapshot.context,\n      baseSnapshot.status,\n      baseSnapshot.async,\n      baseSnapshot.visited\n    );\n    if (!persistence) {\n      return resolvedBaseSnapshot;\n    }\n\n    try {\n      const rawPersisted = persistence.storage.getItem(persistence.key);\n      if (!rawPersisted) {\n        return resolvedBaseSnapshot;\n      }\n\n      const parsed = persistence.deserialize(rawPersisted);\n      if (!isRecord(parsed)) {\n        return resolvedBaseSnapshot;\n      }\n\n      const persistedVersion = parsed.version;\n      if (typeof persistedVersion !== \"number\") {\n        return resolvedBaseSnapshot;\n      }\n\n      let persistedSnapshot: JourneySnapshotStateBase<TContext, TStepId> | null = null;\n      let shouldRewritePersisted = false;\n\n      if (persistedVersion === persistence.version) {\n        const coerced = coercePersistedSnapshot(parsed.snapshot, steps, context);\n        persistedSnapshot = coerced?.snapshot ?? null;\n        shouldRewritePersisted = Boolean(coerced?.needsRewrite);\n      } else if (persistence.migrate) {\n        const migrated = persistence.migrate(parsed.snapshot, persistedVersion);\n        const coerced = coercePersistedSnapshot(migrated, steps, context);\n        persistedSnapshot = coerced?.snapshot ?? null;\n        shouldRewritePersisted = persistedSnapshot !== null;\n\n        if (!persistedSnapshot) {\n          reportResolvedPersistenceError(\n            new Error(\n              \"Journey persistence migrate() returned data that could not be coerced into a valid snapshot. \" +\n                `Falling back to the initial snapshot (persisted version: ${persistedVersion}, current version: ${persistence.version}).`\n            )\n          );\n        }\n      }\n\n      if (!persistedSnapshot) {\n        return resolvedBaseSnapshot;\n      }\n\n      const { context: filteredContext, changed: contextWasFiltered } = filterPersistedContext(\n        persistedSnapshot.context\n      );\n      const hydratedContext = mergePersistedContext(resolvedBaseSnapshot.context, filteredContext);\n\n      const hydratedSnapshot = buildSnapshot(\n        persistedSnapshot.history.timeline,\n        persistedSnapshot.history.index,\n        assertSerializableContext(hydratedContext, \"Hydrated journey context\"),\n        persistedSnapshot.status === \"running\" ? \"idled\" : persistedSnapshot.status,\n        resolvedBaseSnapshot.async,\n        persistedSnapshot.visited\n      );\n\n      if (shouldRewritePersisted || contextWasFiltered) {\n        persistSnapshot(hydratedSnapshot);\n      }\n\n      return hydratedSnapshot;\n    } catch (error) {\n      reportResolvedPersistenceError(error);\n      return resolvedBaseSnapshot;\n    }\n  };\n\n  return {\n    clearOnReset: persistence?.clearOnReset ?? true,\n    hydrateSnapshot,\n    persistSnapshot,\n    removePersistedSnapshot\n  };\n};\n"],
+  "mappings": "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",
+  "names": ["autosave_exports", "__export", "createAutosavePlugin", "__toCommonJS", "isPlainObject", "value", "cloneSerializableValue", "entry", "key", "entryValue", "describeValue", "constructorName", "assertSerializableValue", "label", "state", "path", "pathLabel", "index", "assertSerializableContext", "context", "cloneContext", "unique", "items", "normalizeVisited", "visited", "stepIds", "stepId", "buildVisitedFromTimeline", "timeline", "resolvedStepIds", "isDevelopmentEnvironment", "diagnosticGlobal", "nodeEnv", "warnInDevelopment", "message", "detail", "buildIdleStepAsyncState", "buildInitialAsyncState", "steps", "stepId", "buildSnapshot", "timeline", "index", "context", "status", "asyncState", "visited", "safeIndex", "currentStepId", "stepIds", "unique", "cloneContext", "normalizeVisited", "buildVisitedFromTimeline", "cloneSerializableValue", "isRecord", "value", "isStatusValue", "normalizePersistencePath", "path", "optionName", "trimmedPath", "segments", "segment", "normalizePersistencePaths", "paths", "normalized", "resolvedPath", "pathStartsWith", "prefix", "index", "pathHasAncestorMatch", "candidates", "candidate", "pathHasDescendantMatch", "filterContextValue", "allowList", "blockList", "allowAll", "pathIsAllowed", "pathHasAllowedDescendants", "isPlainObject", "changed", "nextValue", "key", "childValue", "result", "mergePersistedValue", "initialValue", "persistedValue", "mergedEntries", "mergePersistedContext", "initialContext", "persistedContext", "resolveDefaultStorage", "localStorageCandidate", "reportPersistenceError", "error", "onError", "warnInDevelopment", "resolvePersistence", "options", "storage", "normalizedAllowList", "normalizedBlockList", "resolveVisitedFromPersistence", "visitedSource", "timeline", "stepIds", "visitedFromTimeline", "buildVisitedFromTimeline", "needsRewrite", "visited", "stepId", "visitedFromArray", "step", "coercePersistedSnapshot", "steps", "fallbackContext", "rawHistory", "rawTimeline", "currentStepIdValue", "rawIndex", "inferredIndex", "status", "visitedNeedsRewrite", "assertSerializableContext", "createPersistenceController", "args", "initial", "context", "persistence", "reportResolvedPersistenceError", "filterPersistedContext", "filtered", "persistSnapshot", "snapshot", "persistedState", "removePersistedSnapshot", "buildBaseSnapshot", "buildSnapshot", "buildInitialAsyncState", "hydrateSnapshot", "baseSnapshot", "resolvedBaseSnapshot", "rawPersisted", "parsed", "persistedVersion", "persistedSnapshot", "shouldRewritePersisted", "coerced", "migrated", "filteredContext", "contextWasFiltered", "hydratedContext", "hydratedSnapshot", "DEFAULT_SAVE_REASONS", "normalizeDebounceMs", "value", "createAutosavePlugin", "options", "debounceMs", "hydrate", "saveReasons", "autosaveState", "timeoutId", "pending", "lastSaveErrored", "resolvedJourney", "resolvedOptions", "controller", "createPersistenceController", "error", "clearTimer", "commitPending", "current", "timestamp", "scheduleSave", "snapshot", "reason"]
+}

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

@@ -0,0 +1,17 @@
+import type { JourneyAutosavePluginOptions, JourneyAutosaveState, JourneyJsonObject, JourneyMachine } from "../../types";
+export type JourneyAutosaveMachineExtension = {
+    getAutosaveState: () => JourneyAutosaveState;
+    flushAutosave: () => Promise<void>;
+    clearAutosave: () => void;
+};
+export type JourneyAutosaveMachine<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> & JourneyAutosaveMachineExtension;
+/**
+ * Creates a plugin that debounces snapshot persistence and exposes autosave
+ * runtime state without requiring the persistence plugin as a public dependency.
+ */
+export declare const createAutosavePlugin: <TContext extends JourneyJsonObject, TStepId extends string>(options: JourneyAutosavePluginOptions<TContext, TStepId>) => {
+    name: string;
+    __extension__: JourneyAutosaveMachineExtension;
+    setup: <TContext_1 extends JourneyJsonObject, TStepId_1 extends string, TEventMap extends Record<string, unknown> = Record<never, never>, TStepMeta = unknown, THandlers extends Record<string, unknown> = Record<never, never>>(context: import("../../types").JourneyMachinePluginSetupContext<TContext_1, TStepId_1, TEventMap, TStepMeta, THandlers>) => import("../../types").JourneyMachinePluginHooks<TContext_1, TStepId_1, TEventMap, TStepMeta, THandlers>;
+};
+export type { JourneyAutosavePluginOptions, JourneyAutosaveState } from "../../types";

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

@@ -0,0 +1,17 @@
+import type { JourneyAutosavePluginOptions, JourneyAutosaveState, JourneyJsonObject, JourneyMachine } from "../../types";
+export type JourneyAutosaveMachineExtension = {
+    getAutosaveState: () => JourneyAutosaveState;
+    flushAutosave: () => Promise<void>;
+    clearAutosave: () => void;
+};
+export type JourneyAutosaveMachine<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> & JourneyAutosaveMachineExtension;
+/**
+ * Creates a plugin that debounces snapshot persistence and exposes autosave
+ * runtime state without requiring the persistence plugin as a public dependency.
+ */
+export declare const createAutosavePlugin: <TContext extends JourneyJsonObject, TStepId extends string>(options: JourneyAutosavePluginOptions<TContext, TStepId>) => {
+    name: string;
+    __extension__: JourneyAutosaveMachineExtension;
+    setup: <TContext_1 extends JourneyJsonObject, TStepId_1 extends string, TEventMap extends Record<string, unknown> = Record<never, never>, TStepMeta = unknown, THandlers extends Record<string, unknown> = Record<never, never>>(context: import("../../types").JourneyMachinePluginSetupContext<TContext_1, TStepId_1, TEventMap, TStepMeta, THandlers>) => import("../../types").JourneyMachinePluginHooks<TContext_1, TStepId_1, TEventMap, TStepMeta, THandlers>;
+};
+export type { JourneyAutosavePluginOptions, JourneyAutosaveState } from "../../types";