@rxova/journey-core 0.4.0 → 0.5.0

package/dist/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../src/types.ts", "../src/machine-helpers.ts", "../src/persistence.ts", "../src/machine.ts"],
-  "sourcesContent": ["export const JOURNEY_TERMINAL = {\n  COMPLETE: \"COMPLETE\",\n  CLOSE: \"CLOSE\"\n} as const;\n\nexport type JourneyTerminal = (typeof JOURNEY_TERMINAL)[keyof typeof JOURNEY_TERMINAL];\n\nexport const JOURNEY_STATUS = {\n  RUNNING: \"running\",\n  COMPLETE: \"complete\",\n  CLOSED: \"closed\"\n} as const;\n\nexport type JourneyStatus = (typeof JOURNEY_STATUS)[keyof typeof JOURNEY_STATUS];\n\nexport const HISTORY_TARGET = \"__HISTORY__\" as const;\nexport const JOURNEY_WILDCARD = \"*\" as const;\n\nexport const JOURNEY_EVENT = {\n  GO_TO: \"goTo\"\n} as const;\n\nexport type JourneyBuiltInEvent = (typeof JOURNEY_EVENT)[keyof typeof JOURNEY_EVENT];\nexport type JourneyBuiltInFrom = typeof JOURNEY_WILDCARD;\n\nexport const JOURNEY_ASYNC_PHASE = {\n  IDLE: \"idle\",\n  EVALUATING_WHEN: \"evaluating-when\",\n  RUNNING_EFFECT: \"running-effect\",\n  ERROR: \"error\"\n} as const;\n\nexport type JourneyAsyncPhase = (typeof JOURNEY_ASYNC_PHASE)[keyof typeof JOURNEY_ASYNC_PHASE];\n\nexport type JourneyStepAsyncState = {\n  phase: JourneyAsyncPhase;\n  eventType: string | null;\n  transitionId: string | null;\n  error: unknown | null;\n};\n\nexport type JourneyAsyncState<TStepId extends string> = {\n  isLoading: boolean;\n  byStep: Record<TStepId, JourneyStepAsyncState>;\n};\n\nexport type JourneyBaseEvent = {\n  type: string;\n  payload?: unknown;\n};\n\nexport type JourneyEventPayloadMap<TEventType extends string> = Partial<\n  Record<TEventType | JourneyBuiltInEvent, unknown>\n>;\n\nexport type JourneyPayloadFor<\n  TEventType extends string,\n  TPayloadMap extends JourneyEventPayloadMap<TEventType>,\n  TEvent extends TEventType | JourneyBuiltInEvent\n> = TEvent extends keyof TPayloadMap ? TPayloadMap[TEvent] : unknown;\n\nexport type JourneyGoToEvent<TStepId extends string, TPayload = unknown> = {\n  type: (typeof JOURNEY_EVENT)[\"GO_TO\"];\n  to: TStepId;\n  payload?: TPayload;\n};\n\nexport type JourneyEvent<\n  TStepId extends string,\n  TEventType extends string,\n  TPayloadMap extends JourneyEventPayloadMap<TEventType> = Record<never, never>\n> =\n  | JourneyGoToEvent<\n      TStepId,\n      JourneyPayloadFor<TEventType, TPayloadMap, (typeof JOURNEY_EVENT)[\"GO_TO\"]>\n    >\n  | {\n      [TType in TEventType]: {\n        type: TType;\n        payload?: JourneyPayloadFor<TEventType, TPayloadMap, TType>;\n      };\n    }[TEventType];\n\nexport type JourneyTransitionArgs<\n  TContext,\n  TStepId extends string,\n  TEventType extends string,\n  TPayloadMap extends JourneyEventPayloadMap<TEventType> = Record<never, never>\n> = {\n  context: TContext;\n  from: TStepId;\n  history: readonly TStepId[];\n  event: JourneyEvent<TStepId, TEventType, TPayloadMap>;\n};\n\nexport type JourneyTransitionTarget<TStepId extends string> =\n  | TStepId\n  | JourneyTerminal\n  | typeof HISTORY_TARGET;\n\nexport type JourneyTransition<\n  TContext,\n  TStepId extends string,\n  TEventType extends string,\n  TPayloadMap extends JourneyEventPayloadMap<TEventType> = Record<never, never>\n> = {\n  id?: string;\n  from: TStepId | JourneyBuiltInFrom;\n  event: TEventType | (typeof JOURNEY_EVENT)[\"GO_TO\"];\n  to: JourneyTransitionTarget<TStepId>;\n  when?: (\n    args: JourneyTransitionArgs<TContext, TStepId, TEventType, TPayloadMap>\n  ) => boolean | Promise<boolean>;\n  effect?: (\n    args: JourneyTransitionArgs<TContext, TStepId, TEventType, TPayloadMap>\n  ) => TContext | void | Promise<TContext | void>;\n};\n\nexport type JourneySnapshot<TContext, TStepId extends string> = {\n  current: TStepId;\n  context: TContext;\n  history: readonly TStepId[];\n  visited: readonly TStepId[];\n  status: JourneyStatus;\n  async: JourneyAsyncState<TStepId>;\n};\n\nexport type JourneyPersistedSnapshot<TContext, TStepId extends string> = {\n  current: TStepId;\n  context: TContext;\n  history: readonly TStepId[];\n  status: JourneyStatus;\n  visited: readonly TStepId[];\n};\n\nexport type JourneyPersistedState<TContext, TStepId extends string> = {\n  version: number;\n  snapshot: JourneyPersistedSnapshot<TContext, TStepId>;\n};\n\nexport type JourneyHistoryOverflowReason = \"auto\" | \"hydrate\" | \"manual\";\n\nexport type JourneyHistoryOverflow<TStepId extends string> = {\n  previous: readonly TStepId[];\n  next: readonly TStepId[];\n  trimmed: readonly TStepId[];\n  maxHistory: number | null;\n  reason: JourneyHistoryOverflowReason;\n};\n\nexport type JourneyHistoryOptions<TStepId extends string> = {\n  maxHistory?: number | null;\n  onOverflow?: (info: JourneyHistoryOverflow<TStepId>) => void;\n};\n\nexport type JourneyStorage = {\n  getItem: (key: string) => string | null;\n  setItem: (key: string, value: string) => void;\n  removeItem: (key: string) => void;\n};\n\nexport type JourneyPersistenceOptions<TContext, TStepId extends string> = {\n  key: string;\n  storage?: JourneyStorage;\n  version?: number;\n  clearOnReset?: boolean;\n  serialize?: (value: JourneyPersistedState<TContext, TStepId>) => string;\n  deserialize?: (value: string) => unknown;\n  migrate?: (\n    value: unknown,\n    persistedVersion: number\n  ) => JourneyPersistedSnapshot<TContext, TStepId>;\n  onError?: (error: unknown) => void;\n};\n\nexport type JourneyDefinition<\n  TContext,\n  TStepId extends string,\n  TEventType extends string,\n  TPayloadMap extends JourneyEventPayloadMap<TEventType> = Record<never, never>\n> = {\n  initial: TStepId;\n  context: TContext;\n  steps: Record<TStepId, unknown>;\n  transitions: readonly JourneyTransition<TContext, TStepId, TEventType, TPayloadMap>[];\n};\n\nexport type JourneyMachineOptions<TContext, TStepId extends string> = {\n  persistence?: JourneyPersistenceOptions<TContext, TStepId>;\n  history?: JourneyHistoryOptions<TStepId>;\n};\n\nexport type JourneySendResult<TContext, TStepId extends string> = {\n  transitioned: boolean;\n  transitionId?: string;\n  snapshot: JourneySnapshot<TContext, TStepId>;\n};\n\nexport type JourneyMachine<\n  TContext,\n  TStepId extends string,\n  TEventType extends string,\n  TPayloadMap extends JourneyEventPayloadMap<TEventType> = Record<never, never>\n> = {\n  getSnapshot: () => JourneySnapshot<TContext, TStepId>;\n  send: (\n    event: JourneyEvent<TStepId, TEventType, TPayloadMap>\n  ) => Promise<JourneySendResult<TContext, TStepId>>;\n  updateContext: (updater: (context: TContext) => TContext) => JourneySnapshot<TContext, TStepId>;\n  clearStepError: (stepId?: TStepId) => JourneySnapshot<TContext, TStepId>;\n  reset: () => JourneySnapshot<TContext, TStepId>;\n  trimHistory: (maxHistory?: number | null) => JourneySnapshot<TContext, TStepId>;\n  clearHistory: () => JourneySnapshot<TContext, TStepId>;\n  subscribe: (listener: () => void) => () => void;\n};\n", "import { JOURNEY_ASYNC_PHASE, JOURNEY_EVENT, JOURNEY_TERMINAL, JOURNEY_WILDCARD } from \"./types\";\nimport type {\n  JourneyAsyncState,\n  JourneyEvent,\n  JourneyEventPayloadMap,\n  JourneyGoToEvent,\n  JourneyPayloadFor,\n  JourneySendResult,\n  JourneySnapshot,\n  JourneyStatus,\n  JourneyStepAsyncState,\n  JourneyTerminal,\n  JourneyTransition\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\nconst unique = <T>(items: readonly T[]): T[] => [...new Set(items)];\n\nexport const buildVisited = <TStepId extends string>(\n  history: readonly TStepId[],\n  current: TStepId\n): TStepId[] => unique([...history, current]);\n\nexport const appendVisited = <TStepId extends string>(\n  visited: readonly TStepId[],\n  current: TStepId\n): TStepId[] => (visited.includes(current) ? [...visited] : [...visited, current]);\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\nexport const buildIdleStepAsyncState = (): JourneyStepAsyncState => ({\n  phase: JOURNEY_ASYNC_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 isGoToEvent = <\n  TStepId extends string,\n  TEventType extends string,\n  TPayloadMap extends JourneyEventPayloadMap<TEventType>\n>(\n  event: JourneyEvent<TStepId, TEventType, TPayloadMap>\n): event is JourneyGoToEvent<\n  TStepId,\n  JourneyPayloadFor<TEventType, TPayloadMap, (typeof JOURNEY_EVENT)[\"GO_TO\"]>\n> => event.type === JOURNEY_EVENT.GO_TO && \"to\" in event;\n\nexport const isTerminalTarget = <TStepId extends string>(\n  target: TStepId | JourneyTerminal | \"__HISTORY__\"\n): target is JourneyTerminal =>\n  target === JOURNEY_TERMINAL.COMPLETE || target === JOURNEY_TERMINAL.CLOSE;\n\nexport const buildSendResult = <TContext, TStepId extends string>(\n  snapshot: JourneySnapshot<TContext, TStepId>,\n  transitioned: boolean,\n  transitionId?: string\n): JourneySendResult<TContext, TStepId> =>\n  transitionId ? { transitioned, transitionId, snapshot } : { transitioned, snapshot };\n\nexport const buildSnapshot = <TContext, TStepId extends string>(\n  current: TStepId,\n  context: TContext,\n  history: readonly TStepId[],\n  status: JourneyStatus,\n  asyncState: JourneyAsyncState<TStepId>,\n  visited?: readonly TStepId[]\n): JourneySnapshot<TContext, TStepId> => ({\n  status,\n  current,\n  context,\n  history,\n  visited: visited ? [...visited] : buildVisited(history, current),\n  async: asyncState\n});\n\nexport const resolveHistoryTarget = <TContext, TStepId extends string>(\n  snapshot: JourneySnapshot<TContext, TStepId>,\n  steps: Record<TStepId, unknown>\n): { target: TStepId; history: TStepId[] } => {\n  const cloned = [...snapshot.history];\n\n  while (cloned.length > 0) {\n    const candidate = cloned.pop();\n    if (!candidate) {\n      break;\n    }\n    if (candidate in steps) {\n      return {\n        target: candidate,\n        history: cloned\n      };\n    }\n  }\n\n  return {\n    target: snapshot.current,\n    history: [...snapshot.history]\n  };\n};\n\nexport const selectTransition = async <\n  TContext,\n  TStepId extends string,\n  TEventType extends string,\n  TPayloadMap extends JourneyEventPayloadMap<TEventType>\n>(\n  transitions: readonly JourneyTransition<TContext, TStepId, TEventType, TPayloadMap>[],\n  snapshot: JourneySnapshot<TContext, TStepId>,\n  event: JourneyEvent<TStepId, TEventType, TPayloadMap>,\n  hooks?: {\n    onAsyncGuardStart?: (\n      transition: JourneyTransition<TContext, TStepId, TEventType, TPayloadMap>\n    ) => void;\n    onAsyncGuardSuccess?: (\n      transition: JourneyTransition<TContext, TStepId, TEventType, TPayloadMap>\n    ) => void;\n    onAsyncGuardError?: (\n      transition: JourneyTransition<TContext, TStepId, TEventType, TPayloadMap>,\n      error: unknown\n    ) => void;\n  }\n): Promise<JourneyTransition<TContext, TStepId, TEventType, TPayloadMap> | null> => {\n  for (const transition of transitions) {\n    const fromMatches =\n      transition.from === JOURNEY_WILDCARD || transition.from === snapshot.current;\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    const guardResult = transition.when({\n      context: snapshot.context,\n      from: snapshot.current,\n      history: snapshot.history,\n      event\n    });\n    const asyncGuard = isPromiseLike(guardResult);\n    if (asyncGuard) {\n      hooks?.onAsyncGuardStart?.(transition);\n    }\n\n    let allowed: boolean;\n    try {\n      allowed = await guardResult;\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, TStepId extends string>(\n  snapshot: JourneySnapshot<TContext, TStepId>,\n  nextCurrent: TStepId,\n  nextContext: TContext\n): JourneySnapshot<TContext, TStepId> => {\n  const history =\n    nextCurrent === snapshot.current\n      ? [...snapshot.history]\n      : [...snapshot.history, snapshot.current];\n\n  const visited = appendVisited(snapshot.visited, nextCurrent);\n\n  return buildSnapshot(nextCurrent, nextContext, history, snapshot.status, snapshot.async, visited);\n};\n", "import { JOURNEY_STATUS } from \"./types\";\nimport type {\n  JourneyMachineOptions,\n  JourneyPersistedSnapshot,\n  JourneyPersistedState,\n  JourneyStatus,\n  JourneySnapshot,\n  JourneyStorage\n} from \"./types\";\nimport { buildInitialAsyncState, buildSnapshot, buildVisited } from \"./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 === JOURNEY_STATUS.RUNNING ||\n  value === JOURNEY_STATUS.COMPLETE ||\n  value === JOURNEY_STATUS.CLOSED;\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\ntype ResolvedPersistence<TContext, TStepId extends string> = {\n  key: string;\n  storage: JourneyStorage;\n  version: number;\n  clearOnReset: boolean;\n  serialize: (value: JourneyPersistedState<TContext, TStepId>) => string;\n  deserialize: (value: string) => unknown;\n  migrate?: (\n    value: unknown,\n    persistedVersion: number\n  ) => JourneyPersistedSnapshot<TContext, TStepId>;\n  onError?: (error: unknown) => void;\n};\n\nconst resolvePersistence = <TContext, TStepId extends string>(\n  options?: JourneyMachineOptions<TContext, TStepId>[\"persistence\"]\n): ResolvedPersistence<TContext, TStepId> | null => {\n  if (!options) {\n    return null;\n  }\n\n  const storage = options.storage ?? resolveDefaultStorage();\n  if (!storage) {\n    return null;\n  }\n\n  return {\n    key: options.key,\n    storage,\n    version: options.version ?? 1,\n    clearOnReset: options.clearOnReset ?? true,\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 coercePersistedSnapshot = <TContext, TStepId extends string>(\n  value: unknown,\n  steps: Record<TStepId, unknown>,\n  fallbackContext: TContext\n): { snapshot: JourneyPersistedSnapshot<TContext, TStepId>; needsRewrite: boolean } | null => {\n  if (!isRecord(value)) {\n    return null;\n  }\n\n  const currentValue = value.current;\n  if (typeof currentValue !== \"string\" || !(currentValue in steps)) {\n    return null;\n  }\n  const current = currentValue as TStepId;\n\n  const history = Array.isArray(value.history)\n    ? (value.history.filter(\n        (step): step is TStepId => typeof step === \"string\" && step in steps\n      ) as TStepId[])\n    : [];\n\n  const status = isStatusValue(value.status) ? value.status : JOURNEY_STATUS.RUNNING;\n\n  const visitedRaw = Array.isArray(value.visited)\n    ? (value.visited.filter(\n        (step): step is TStepId => typeof step === \"string\" && step in steps\n      ) as TStepId[])\n    : null;\n  const visited = visitedRaw && visitedRaw.length > 0 ? visitedRaw : buildVisited(history, current);\n  const needsRewrite = !visitedRaw || visitedRaw.length === 0;\n\n  return {\n    snapshot: {\n      current,\n      context: (\"context\" in value ? value.context : fallbackContext) as TContext,\n      history,\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 = <TContext, TStepId extends string>(args: {\n  initial: TStepId;\n  context: TContext;\n  steps: Record<TStepId, unknown>;\n  options?: JourneyMachineOptions<TContext, TStepId>;\n}) => {\n  const { initial, context, steps, options } = args;\n  const persistence = resolvePersistence(options?.persistence);\n\n  const reportPersistenceError = (error: unknown) => {\n    persistence?.onError?.(error);\n  };\n\n  const persistSnapshot = (snapshot: JourneySnapshot<TContext, TStepId>) => {\n    if (!persistence) {\n      return;\n    }\n\n    try {\n      const persistedState: JourneyPersistedState<TContext, TStepId> = {\n        version: persistence.version,\n        snapshot: {\n          current: snapshot.current,\n          context: snapshot.context,\n          history: [...snapshot.history],\n          status: snapshot.status,\n          visited: [...snapshot.visited]\n        }\n      };\n      persistence.storage.setItem(persistence.key, persistence.serialize(persistedState));\n    } catch (error) {\n      reportPersistenceError(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      reportPersistenceError(error);\n    }\n  };\n\n  const hydrateSnapshot = (): JourneySnapshot<TContext, TStepId> => {\n    const initialSnapshot = buildSnapshot(\n      initial,\n      context,\n      [],\n      JOURNEY_STATUS.RUNNING,\n      buildInitialAsyncState(steps)\n    );\n    if (!persistence) {\n      return initialSnapshot;\n    }\n\n    try {\n      const rawPersisted = persistence.storage.getItem(persistence.key);\n      if (!rawPersisted) {\n        return initialSnapshot;\n      }\n\n      const parsed = persistence.deserialize(rawPersisted);\n      if (!isRecord(parsed)) {\n        return initialSnapshot;\n      }\n\n      const persistedVersion = parsed.version;\n      if (typeof persistedVersion !== \"number\") {\n        return initialSnapshot;\n      }\n\n      let persistedSnapshot: JourneyPersistedSnapshot<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\n      if (!persistedSnapshot) {\n        return initialSnapshot;\n      }\n\n      const hydratedSnapshot = buildSnapshot(\n        persistedSnapshot.current,\n        persistedSnapshot.context,\n        persistedSnapshot.history,\n        persistedSnapshot.status,\n        buildInitialAsyncState(steps),\n        persistedSnapshot.visited\n      );\n\n      if (shouldRewritePersisted) {\n        persistSnapshot(hydratedSnapshot);\n      }\n\n      return hydratedSnapshot;\n    } catch (error) {\n      reportPersistenceError(error);\n      return initialSnapshot;\n    }\n  };\n\n  return {\n    clearOnReset: persistence?.clearOnReset ?? true,\n    hydrateSnapshot,\n    persistSnapshot,\n    removePersistedSnapshot\n  };\n};\n", "import {\n  JOURNEY_ASYNC_PHASE,\n  JOURNEY_EVENT,\n  JOURNEY_STATUS,\n  JOURNEY_TERMINAL,\n  JOURNEY_WILDCARD,\n  HISTORY_TARGET\n} from \"./types\";\nimport type {\n  JourneyAsyncState,\n  JourneyAsyncPhase,\n  JourneyEventPayloadMap,\n  JourneyDefinition,\n  JourneyHistoryOverflowReason,\n  JourneyHistoryOptions,\n  JourneyMachine,\n  JourneyMachineOptions,\n  JourneySendResult,\n  JourneySnapshot\n} from \"./types\";\nimport {\n  appendVisited,\n  assertStepExists,\n  buildIdleStepAsyncState,\n  buildInitialAsyncState,\n  buildSendResult,\n  isGoToEvent,\n  isPromiseLike,\n  isTerminalTarget,\n  resolveHistoryTarget,\n  selectTransition,\n  transitionSnapshot,\n  buildSnapshot\n} from \"./machine-helpers\";\nimport { createPersistenceController } from \"./persistence\";\n\nconst DEFAULT_MAX_HISTORY = 50;\n\nconst resolveMaxHistory = (value: number | null | undefined): number | null => {\n  if (value === null) {\n    return null;\n  }\n  if (typeof value === \"number\" && Number.isFinite(value)) {\n    return Math.max(0, Math.trunc(value));\n  }\n  return DEFAULT_MAX_HISTORY;\n};\n\nconst applyHistoryLimit = <TStepId extends string>(\n  history: readonly TStepId[],\n  maxHistory: number | null\n): { next: TStepId[]; trimmed: TStepId[] } => {\n  if (maxHistory === null || history.length <= maxHistory) {\n    return { next: [...history], trimmed: [] };\n  }\n\n  const trimCount = history.length - maxHistory;\n  return {\n    next: history.slice(trimCount),\n    trimmed: history.slice(0, trimCount)\n  };\n};\n\n/**\n * Creates a journey machine from a journey definition.\n * Validates steps/transitions, hydrates persisted state (if configured),\n * and returns an API for sending events and reading snapshots.\n */\nexport const createJourneyMachine = <\n  TContext,\n  TStepId extends string,\n  TEventType extends string = \"next\" | \"back\" | \"close\" | \"submit\",\n  TPayloadMap extends JourneyEventPayloadMap<TEventType> = Record<never, never>\n>(\n  journey: JourneyDefinition<TContext, TStepId, TEventType, TPayloadMap>,\n  options?: JourneyMachineOptions<TContext, TStepId>\n): JourneyMachine<TContext, TStepId, TEventType, TPayloadMap> => {\n  if (!journey.steps || typeof journey.steps !== \"object\") {\n    throw new Error(\"Journey steps must be a record object.\");\n  }\n\n  if (!Array.isArray(journey.transitions)) {\n    throw new Error(\"Journey transitions must be an array.\");\n  }\n\n  assertStepExists(\n    journey.steps,\n    journey.initial,\n    `Journey initial step \"${journey.initial}\" does not exist in steps registry.`\n  );\n\n  for (const [index, transition] of journey.transitions.entries()) {\n    if (!transition || typeof transition !== \"object\") {\n      throw new Error(`Journey transition at index ${index} must be an object.`);\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 (\n      transition.from !== JOURNEY_WILDCARD &&\n      !((transition.from as string) in (journey.steps as Record<string, unknown>))\n    ) {\n      throw new Error(\n        `Journey transition at index ${index} references unknown from step \"${transition.from}\".`\n      );\n    }\n\n    if (\n      transition.to !== HISTORY_TARGET &&\n      !isTerminalTarget(transition.to) &&\n      !((transition.to as string) in (journey.steps as Record<string, unknown>))\n    ) {\n      throw new Error(\n        `Journey transition at index ${index} points to unknown step \"${transition.to}\".`\n      );\n    }\n  }\n\n  const { clearOnReset, hydrateSnapshot, persistSnapshot, removePersistedSnapshot } =\n    createPersistenceController({\n      initial: journey.initial,\n      context: journey.context,\n      steps: journey.steps,\n      ...(options ? { options } : {})\n    });\n\n  const historyOptions: JourneyHistoryOptions<TStepId> | undefined = options?.history;\n\n  const runHistoryTrim = (\n    nextSnapshot: JourneySnapshot<TContext, TStepId>,\n    reason: JourneyHistoryOverflowReason,\n    overrideMaxHistory?: number | null\n  ): {\n    snapshot: JourneySnapshot<TContext, TStepId>;\n    trimmed: TStepId[];\n    maxHistory: number | null;\n  } => {\n    const resolvedMaxHistory = resolveMaxHistory(overrideMaxHistory ?? historyOptions?.maxHistory);\n    const { next, trimmed } = applyHistoryLimit(nextSnapshot.history, resolvedMaxHistory);\n    if (trimmed.length === 0) {\n      return {\n        snapshot: nextSnapshot,\n        trimmed,\n        maxHistory: resolvedMaxHistory\n      };\n    }\n\n    const rebuilt = buildSnapshot(\n      nextSnapshot.current,\n      nextSnapshot.context,\n      next,\n      nextSnapshot.status,\n      nextSnapshot.async,\n      nextSnapshot.visited\n    );\n\n    historyOptions?.onOverflow?.({\n      previous: nextSnapshot.history,\n      next,\n      trimmed,\n      maxHistory: resolvedMaxHistory,\n      reason\n    });\n\n    return {\n      snapshot: rebuilt,\n      trimmed,\n      maxHistory: resolvedMaxHistory\n    };\n  };\n\n  let snapshot = hydrateSnapshot();\n  const hydratedTrim = runHistoryTrim(snapshot, \"hydrate\");\n  snapshot = hydratedTrim.snapshot;\n  if (hydratedTrim.trimmed.length > 0) {\n    persistSnapshot(snapshot);\n  }\n  const listeners = new Set<() => void>();\n  let sendQueue: Promise<void> = Promise.resolve();\n  snapshot = {\n    ...snapshot,\n    async: buildInitialAsyncState(journey.steps)\n  };\n\n  const notify = () => {\n    for (const listener of listeners) {\n      listener();\n    }\n  };\n\n  const isAsyncLoadingPhase = (phase: JourneyAsyncPhase): boolean =>\n    phase === JOURNEY_ASYNC_PHASE.EVALUATING_WHEN || phase === JOURNEY_ASYNC_PHASE.RUNNING_EFFECT;\n\n  const updateStepAsync = (\n    stepId: TStepId,\n    updater: (\n      current: JourneyAsyncState<TStepId>[\"byStep\"][TStepId]\n    ) => JourneyAsyncState<TStepId>[\"byStep\"][TStepId]\n  ) => {\n    const current = snapshot.async.byStep[stepId] ?? buildIdleStepAsyncState();\n    const next = updater(current);\n    if (\n      current.phase === next.phase &&\n      current.eventType === next.eventType &&\n      current.transitionId === next.transitionId &&\n      current.error === next.error\n    ) {\n      return;\n    }\n    const nextByStep = {\n      ...snapshot.async.byStep,\n      [stepId]: next\n    };\n    const isLoading = Object.values(nextByStep).some((state) => isAsyncLoadingPhase(state.phase));\n    snapshot = {\n      ...snapshot,\n      async: {\n        isLoading,\n        byStep: nextByStep\n      }\n    };\n    notify();\n  };\n\n  const setStepLoading = (\n    stepId: TStepId,\n    phase: JourneyAsyncPhase,\n    eventType: string,\n    transitionId?: string\n  ) => {\n    updateStepAsync(stepId, () => ({\n      phase,\n      eventType,\n      transitionId: transitionId ?? null,\n      error: null\n    }));\n  };\n\n  const setStepIdle = (stepId: TStepId) => {\n    updateStepAsync(stepId, () => buildIdleStepAsyncState());\n  };\n\n  const setStepError = (\n    stepId: TStepId,\n    eventType: string,\n    error: unknown,\n    transitionId?: string\n  ) => {\n    updateStepAsync(stepId, () => ({\n      phase: JOURNEY_ASYNC_PHASE.ERROR,\n      eventType,\n      transitionId: transitionId ?? null,\n      error\n    }));\n  };\n\n  return {\n    getSnapshot: () => snapshot,\n    subscribe: (listener) => {\n      listeners.add(listener);\n      return () => {\n        listeners.delete(listener);\n      };\n    },\n    reset: () => {\n      snapshot = buildSnapshot(\n        journey.initial,\n        journey.context,\n        [],\n        JOURNEY_STATUS.RUNNING,\n        buildInitialAsyncState(journey.steps)\n      );\n      if (clearOnReset) {\n        removePersistedSnapshot();\n      } else {\n        persistSnapshot(snapshot);\n      }\n      notify();\n      return snapshot;\n    },\n    updateContext: (updater) => {\n      snapshot = {\n        ...snapshot,\n        context: updater(snapshot.context)\n      };\n      persistSnapshot(snapshot);\n      notify();\n      return snapshot;\n    },\n    clearStepError: (stepId) => {\n      const resolvedStep = stepId ?? snapshot.current;\n      if (!(resolvedStep in journey.steps)) {\n        return snapshot;\n      }\n\n      setStepIdle(resolvedStep);\n      return snapshot;\n    },\n    trimHistory: (maxHistory) => {\n      const result = runHistoryTrim(snapshot, \"manual\", maxHistory);\n      if (result.trimmed.length === 0) {\n        return snapshot;\n      }\n      snapshot = result.snapshot;\n      persistSnapshot(snapshot);\n      notify();\n      return snapshot;\n    },\n    clearHistory: () => {\n      if (snapshot.history.length === 0) {\n        return snapshot;\n      }\n      snapshot = buildSnapshot(\n        snapshot.current,\n        snapshot.context,\n        [],\n        snapshot.status,\n        snapshot.async,\n        snapshot.visited\n      );\n      persistSnapshot(snapshot);\n      notify();\n      return snapshot;\n    },\n    send: (event) => {\n      const run = async (): Promise<JourneySendResult<TContext, TStepId>> => {\n        if (snapshot.status !== JOURNEY_STATUS.RUNNING) {\n          return { transitioned: false, snapshot };\n        }\n\n        const fromStep = snapshot.current;\n\n        if (isGoToEvent(event)) {\n          assertStepExists(journey.steps, event.to, `Cannot goTo unknown step \"${event.to}\".`);\n          setStepIdle(fromStep);\n          snapshot = transitionSnapshot(snapshot, event.to, snapshot.context);\n          snapshot = runHistoryTrim(snapshot, \"auto\").snapshot;\n          persistSnapshot(snapshot);\n          notify();\n          return buildSendResult(snapshot, true, JOURNEY_EVENT.GO_TO);\n        }\n\n        let transition;\n        try {\n          transition = await selectTransition(journey.transitions, snapshot, event, {\n            onAsyncGuardStart: (currentTransition) => {\n              setStepLoading(\n                fromStep,\n                JOURNEY_ASYNC_PHASE.EVALUATING_WHEN,\n                event.type,\n                currentTransition.id\n              );\n            },\n            onAsyncGuardSuccess: () => {\n              setStepIdle(fromStep);\n            },\n            onAsyncGuardError: (currentTransition, error) => {\n              setStepError(fromStep, event.type, error, currentTransition.id);\n            }\n          });\n        } catch (error) {\n          setStepError(fromStep, event.type, error);\n          throw error;\n        }\n\n        if (!transition) {\n          return buildSendResult(snapshot, false);\n        }\n\n        let nextContext = snapshot.context;\n        if (transition.effect) {\n          const effectResultPromise = transition.effect({\n            context: snapshot.context,\n            from: snapshot.current,\n            history: snapshot.history,\n            event\n          });\n          if (isPromiseLike(effectResultPromise)) {\n            setStepLoading(\n              fromStep,\n              JOURNEY_ASYNC_PHASE.RUNNING_EFFECT,\n              event.type as string,\n              transition.id\n            );\n          }\n\n          let effectResult: TContext | void;\n          try {\n            effectResult = await effectResultPromise;\n          } catch (error) {\n            setStepError(fromStep, event.type, error, transition.id);\n            throw error;\n          }\n\n          if (effectResult !== undefined) {\n            nextContext = effectResult;\n          }\n        }\n\n        setStepIdle(fromStep);\n\n        if (isTerminalTarget(transition.to)) {\n          snapshot = {\n            ...snapshot,\n            context: nextContext,\n            status:\n              transition.to === JOURNEY_TERMINAL.COMPLETE\n                ? JOURNEY_STATUS.COMPLETE\n                : JOURNEY_STATUS.CLOSED\n          };\n          snapshot = runHistoryTrim(snapshot, \"auto\").snapshot;\n          persistSnapshot(snapshot);\n          notify();\n          return buildSendResult(snapshot, true, transition.id);\n        }\n\n        if (transition.to === HISTORY_TARGET) {\n          const { target, history } = resolveHistoryTarget(snapshot, journey.steps);\n          assertStepExists(journey.steps, target, `Transition points to unknown step \"${target}\".`);\n          const visited = appendVisited(snapshot.visited, target);\n          snapshot = buildSnapshot(\n            target,\n            nextContext,\n            history,\n            snapshot.status,\n            snapshot.async,\n            visited\n          );\n          snapshot = runHistoryTrim(snapshot, \"auto\").snapshot;\n          persistSnapshot(snapshot);\n          notify();\n          return buildSendResult(snapshot, true, transition.id);\n        }\n\n        const resolvedTarget = transition.to;\n\n        assertStepExists(\n          journey.steps,\n          resolvedTarget,\n          `Transition points to unknown step \"${resolvedTarget}\".`\n        );\n\n        const nextSnapshot = transitionSnapshot(snapshot, resolvedTarget, nextContext);\n        snapshot = runHistoryTrim(nextSnapshot, \"auto\").snapshot;\n        persistSnapshot(snapshot);\n        notify();\n\n        return buildSendResult(snapshot, true, transition.id);\n      };\n\n      const resultPromise = sendQueue.then(run, run);\n      sendQueue = resultPromise.then(\n        () => undefined,\n        () => undefined\n      );\n      return resultPromise;\n    }\n  };\n};\n"],
-  "mappings": "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",
-  "names": ["JOURNEY_TERMINAL", "JOURNEY_STATUS", "HISTORY_TARGET", "JOURNEY_WILDCARD", "JOURNEY_EVENT", "JOURNEY_ASYNC_PHASE", "assertStepExists", "steps", "stepId", "message", "unique", "items", "buildVisited", "history", "current", "appendVisited", "visited", "isPromiseLike", "value", "buildIdleStepAsyncState", "JOURNEY_ASYNC_PHASE", "buildInitialAsyncState", "isGoToEvent", "event", "JOURNEY_EVENT", "isTerminalTarget", "target", "JOURNEY_TERMINAL", "buildSendResult", "snapshot", "transitioned", "transitionId", "buildSnapshot", "context", "status", "asyncState", "resolveHistoryTarget", "cloned", "candidate", "selectTransition", "transitions", "hooks", "transition", "fromMatches", "JOURNEY_WILDCARD", "eventMatches", "guardResult", "asyncGuard", "allowed", "error", "transitionSnapshot", "nextCurrent", "nextContext", "isRecord", "value", "isStatusValue", "JOURNEY_STATUS", "resolveDefaultStorage", "localStorageCandidate", "resolvePersistence", "options", "storage", "coercePersistedSnapshot", "steps", "fallbackContext", "currentValue", "current", "history", "step", "status", "visitedRaw", "visited", "buildVisited", "needsRewrite", "createPersistenceController", "args", "initial", "context", "persistence", "reportPersistenceError", "error", "persistSnapshot", "snapshot", "persistedState", "removePersistedSnapshot", "hydrateSnapshot", "initialSnapshot", "buildSnapshot", "buildInitialAsyncState", "rawPersisted", "parsed", "persistedVersion", "persistedSnapshot", "shouldRewritePersisted", "coerced", "migrated", "hydratedSnapshot", "DEFAULT_MAX_HISTORY", "resolveMaxHistory", "value", "applyHistoryLimit", "history", "maxHistory", "trimCount", "createJourneyMachine", "journey", "options", "assertStepExists", "index", "transition", "JOURNEY_WILDCARD", "HISTORY_TARGET", "isTerminalTarget", "clearOnReset", "hydrateSnapshot", "persistSnapshot", "removePersistedSnapshot", "createPersistenceController", "historyOptions", "runHistoryTrim", "nextSnapshot", "reason", "overrideMaxHistory", "resolvedMaxHistory", "next", "trimmed", "rebuilt", "buildSnapshot", "snapshot", "hydratedTrim", "listeners", "sendQueue", "buildInitialAsyncState", "notify", "listener", "isAsyncLoadingPhase", "phase", "JOURNEY_ASYNC_PHASE", "updateStepAsync", "stepId", "updater", "current", "buildIdleStepAsyncState", "nextByStep", "isLoading", "state", "setStepLoading", "eventType", "transitionId", "setStepIdle", "setStepError", "error", "JOURNEY_STATUS", "resolvedStep", "result", "event", "run", "fromStep", "isGoToEvent", "transitionSnapshot", "buildSendResult", "JOURNEY_EVENT", "selectTransition", "currentTransition", "nextContext", "effectResultPromise", "isPromiseLike", "effectResult", "JOURNEY_TERMINAL", "target", "resolveHistoryTarget", "visited", "appendVisited", "resolvedTarget", "resultPromise"]
+  "sources": ["../src/types/journey.types.ts", "../src/machine-helpers.ts", "../src/persistence.ts", "../src/machine.ts", "../src/transitions.ts"],
+  "sourcesContent": ["import type { JourneyPersistenceOptions } from \"./persistence.types\";\nimport type { JourneyTransition } from \"./transitions.types\";\n\nexport type JourneyTerminal = \"COMPLETE\" | \"TERMINATED\";\n\nexport const JOURNEY_STATUS = {\n  RUNNING: \"running\",\n  COMPLETE: \"complete\",\n  TERMINATED: \"terminated\"\n} as const;\n\nexport type JourneyStatus = (typeof JOURNEY_STATUS)[keyof typeof JOURNEY_STATUS];\n\nexport const JOURNEY_WILDCARD = \"*\" as const;\n\nexport const JOURNEY_EVENT = {\n  GO_TO_STEP_BY_ID: \"goToStepById\"\n} as const;\n\nexport type JourneyBuiltInEvent = (typeof JOURNEY_EVENT)[keyof typeof JOURNEY_EVENT];\nexport type JourneyBuiltInFrom = typeof JOURNEY_WILDCARD;\nexport type JourneyDefaultEventType =\n  | \"goToNextStep\"\n  | \"goToPreviousStep\"\n  | \"terminateJourney\"\n  | \"completeJourney\";\n\nexport const JOURNEY_ASYNC_PHASE = {\n  IDLE: \"idle\",\n  EVALUATING_WHEN: \"evaluating-when\",\n  RUNNING_EFFECT: \"running-effect\",\n  ERROR: \"error\"\n} as const;\n\nexport type JourneyAsyncPhase = (typeof JOURNEY_ASYNC_PHASE)[keyof typeof JOURNEY_ASYNC_PHASE];\n\nexport type JourneyStepAsyncState = {\n  phase: JourneyAsyncPhase;\n  eventType: string | null;\n  transitionId: string | null;\n  error: unknown | null;\n};\n\nexport type JourneyAsyncState<TStepId extends string> = {\n  isLoading: boolean;\n  byStep: Record<TStepId, JourneyStepAsyncState>;\n};\n\nexport type JourneyBaseEvent = {\n  type: string;\n  payload?: unknown;\n};\n\nexport type JourneyEventPayloadMap<TEventType extends string> = Partial<\n  Record<TEventType | JourneyBuiltInEvent, unknown>\n>;\n\nexport type JourneyPayloadFor<\n  TEventType extends string,\n  TPayloadMap extends JourneyEventPayloadMap<TEventType>,\n  TEvent extends TEventType | JourneyBuiltInEvent\n> = TEvent extends keyof TPayloadMap ? TPayloadMap[TEvent] : unknown;\n\ntype JourneyPayloadForDefaultEvent<\n  TEventType extends string,\n  TPayloadMap extends JourneyEventPayloadMap<TEventType>,\n  TDefaultEvent extends JourneyDefaultEventType\n> = JourneyPayloadFor<\n  TEventType | TDefaultEvent,\n  TPayloadMap & JourneyEventPayloadMap<TDefaultEvent>,\n  TDefaultEvent\n>;\n\nexport type JourneyGoToEvent<TStepId extends string, TPayload = unknown> = {\n  type: (typeof JOURNEY_EVENT)[\"GO_TO_STEP_BY_ID\"];\n  stepId: TStepId;\n  payload?: TPayload;\n};\n\nexport type JourneyEvent<\n  TStepId extends string,\n  TEventType extends string,\n  TPayloadMap extends JourneyEventPayloadMap<TEventType> = Record<never, never>\n> =\n  | JourneyGoToEvent<\n      TStepId,\n      JourneyPayloadFor<TEventType, TPayloadMap, (typeof JOURNEY_EVENT)[\"GO_TO_STEP_BY_ID\"]>\n    >\n  | {\n      [TType in TEventType]: {\n        type: TType;\n        payload?: JourneyPayloadFor<TEventType, TPayloadMap, TType>;\n      };\n    }[TEventType];\n\nexport type JourneyStepDefinition<TStepMeta = unknown> = {\n  meta?: TStepMeta;\n} & Record<string, unknown>;\n\nexport type JourneySnapshot<TContext, TStepId extends string, TStepMeta = unknown> = {\n  currentStepId: TStepId;\n  history: {\n    timeline: readonly TStepId[];\n    index: number;\n  };\n  context: TContext;\n  visited: Record<TStepId, boolean>;\n  stepMeta: Record<TStepId, TStepMeta>;\n  status: JourneyStatus;\n  async: JourneyAsyncState<TStepId>;\n};\n\nexport type JourneyDefinition<\n  TContext,\n  TStepId extends string = string,\n  TEventType extends string = JourneyDefaultEventType,\n  TPayloadMap extends JourneyEventPayloadMap<TEventType> = Record<never, never>,\n  TStepMeta = unknown\n> = {\n  initial: TStepId;\n  context: TContext;\n  steps: Record<TStepId, JourneyStepDefinition<TStepMeta>>;\n  transitions: readonly JourneyTransition<TContext, TStepId, TEventType, TPayloadMap>[];\n};\n\nexport type JourneyMachineOptions<TContext, TStepId extends string, TStepMeta = unknown> = {\n  persistence?: JourneyPersistenceOptions<TContext, TStepId, TStepMeta>;\n};\n\nexport type JourneySendResult<TContext, TStepId extends string, TStepMeta = unknown> = {\n  transitioned: boolean;\n  transitionId?: string;\n  snapshot: JourneySnapshot<TContext, TStepId, TStepMeta>;\n};\n\nexport type JourneyObservationEvent<\n  TStepId extends string,\n  TEventType extends string,\n  TPayloadMap extends JourneyEventPayloadMap<TEventType> = Record<never, never>,\n  TStepMeta = unknown\n> =\n  | {\n      type: \"transition.start\";\n      from: TStepId;\n      event: JourneyEvent<TStepId, TEventType, TPayloadMap>;\n      timestamp: number;\n    }\n  | {\n      type: \"transition.success\";\n      from: TStepId;\n      to: TStepId | JourneyTerminal;\n      eventType: string;\n      transitionId: string | null;\n      timestamp: number;\n    }\n  | {\n      type: \"transition.error\";\n      from: TStepId;\n      eventType: string;\n      transitionId: string | null;\n      error: unknown;\n      timestamp: number;\n    }\n  | {\n      type: \"step.exit\";\n      stepId: TStepId;\n      timestamp: number;\n    }\n  | {\n      type: \"step.enter\";\n      stepId: TStepId;\n      timestamp: number;\n    }\n  | {\n      type: \"journey.complete\";\n      stepId: TStepId;\n      timestamp: number;\n    }\n  | {\n      type: \"journey.close\";\n      stepId: TStepId;\n      timestamp: number;\n    }\n  | {\n      type: \"navigation.previous\";\n      from: TStepId;\n      to: TStepId;\n      requestedSteps: number;\n      appliedSteps: number;\n      timestamp: number;\n    }\n  | {\n      type: \"navigation.lastVisited\";\n      from: TStepId;\n      to: TStepId;\n      timestamp: number;\n    }\n  | {\n      type: \"metadata.updated\";\n      stepId: TStepId;\n      previous: TStepMeta;\n      next: TStepMeta;\n      timestamp: number;\n    };\n\nexport type JourneyMachine<\n  TContext,\n  TStepId extends string,\n  TEventType extends string,\n  TPayloadMap extends JourneyEventPayloadMap<TEventType> = Record<never, never>,\n  TStepMeta = unknown\n> = {\n  getSnapshot: () => JourneySnapshot<TContext, TStepId, TStepMeta>;\n  send: (\n    event: JourneyEvent<TStepId, TEventType, TPayloadMap>\n  ) => Promise<JourneySendResult<TContext, TStepId, TStepMeta>>;\n  goToNextStep: () => Promise<JourneySendResult<TContext, TStepId, TStepMeta>>;\n  terminateJourney: (\n    payload?: JourneyPayloadForDefaultEvent<TEventType, TPayloadMap, \"terminateJourney\">\n  ) => Promise<JourneySendResult<TContext, TStepId, TStepMeta>>;\n  completeJourney: (\n    payload?: JourneyPayloadForDefaultEvent<TEventType, TPayloadMap, \"completeJourney\">\n  ) => Promise<JourneySendResult<TContext, TStepId, TStepMeta>>;\n  goToPreviousStep: (steps?: number) => Promise<JourneySendResult<TContext, TStepId, TStepMeta>>;\n  goToLastVisitedStep: () => Promise<JourneySendResult<TContext, TStepId, TStepMeta>>;\n  updateContext: (\n    updater: (context: TContext) => TContext\n  ) => JourneySnapshot<TContext, TStepId, TStepMeta>;\n  updateStepMetadata: (\n    stepId: TStepId,\n    updater: (metadata: TStepMeta) => TStepMeta\n  ) => JourneySnapshot<TContext, TStepId, TStepMeta>;\n  clearStepError: (stepId?: TStepId) => JourneySnapshot<TContext, TStepId, TStepMeta>;\n  resetMachine: () => JourneySnapshot<TContext, TStepId, TStepMeta>;\n  subscribe: (listener: () => void) => () => void;\n  subscribeEvent: (\n    listener: (event: JourneyObservationEvent<TStepId, TEventType, TPayloadMap, TStepMeta>) => void\n  ) => () => void;\n};\n", "import { JOURNEY_ASYNC_PHASE, JOURNEY_EVENT, JOURNEY_WILDCARD } from \"./types\";\nimport type {\n  JourneyAsyncState,\n  JourneyEvent,\n  JourneyEventPayloadMap,\n  JourneyGoToEvent,\n  JourneyPayloadFor,\n  JourneySendResult,\n  JourneySnapshot,\n  JourneyStatus,\n  JourneyStepAsyncState,\n  JourneyTerminal,\n  JourneyTransition\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 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\nexport const buildIdleStepAsyncState = (): JourneyStepAsyncState => ({\n  phase: JOURNEY_ASYNC_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  TEventType extends string,\n  TPayloadMap extends JourneyEventPayloadMap<TEventType>\n>(\n  event: JourneyEvent<TStepId, TEventType, TPayloadMap>\n): event is JourneyGoToEvent<\n  TStepId,\n  JourneyPayloadFor<TEventType, TPayloadMap, (typeof JOURNEY_EVENT)[\"GO_TO_STEP_BY_ID\"]>\n> => event.type === JOURNEY_EVENT.GO_TO_STEP_BY_ID && \"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 validateJourneyTransitions = <\n  TContext,\n  TStepId extends string,\n  TEventType extends string,\n  TPayloadMap extends JourneyEventPayloadMap<TEventType>\n>(\n  transitions: readonly JourneyTransition<TContext, TStepId, TEventType, TPayloadMap>[],\n  steps: Record<TStepId, unknown>\n) => {\n  const stepRegistry = steps as Record<string, unknown>;\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    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 !== JOURNEY_WILDCARD && !(transition.from in stepRegistry)) {\n      throw new Error(\n        `Journey transition at index ${index} references unknown from step \"${transition.from}\".`\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, TStepId extends string, TStepMeta>(\n  snapshot: JourneySnapshot<TContext, TStepId, TStepMeta>,\n  transitioned: boolean,\n  transitionId?: string\n): JourneySendResult<TContext, TStepId, TStepMeta> =>\n  transitionId ? { transitioned, transitionId, snapshot } : { transitioned, snapshot };\n\nexport const buildSnapshot = <TContext, TStepId extends string, TStepMeta>(\n  timeline: readonly TStepId[],\n  index: number,\n  context: TContext,\n  status: JourneyStatus,\n  asyncState: JourneyAsyncState<TStepId>,\n  stepMeta: Record<TStepId, TStepMeta>,\n  visited?: Record<TStepId, boolean>\n): JourneySnapshot<TContext, TStepId, TStepMeta> => {\n  if (timeline.length === 0) {\n    throw new Error(\"Journey timeline cannot be empty.\");\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 = Object.keys(stepMeta) as TStepId[];\n  return {\n    status,\n    currentStepId,\n    history: {\n      timeline: [...timeline],\n      index: safeIndex\n    },\n    context,\n    visited: visited\n      ? normalizeVisited(visited, stepIds)\n      : buildVisitedFromTimeline(timeline, stepIds),\n    stepMeta: { ...stepMeta },\n    async: asyncState\n  };\n};\n\nexport const selectTransition = async <\n  TContext,\n  TStepId extends string,\n  TEventType extends string,\n  TPayloadMap extends JourneyEventPayloadMap<TEventType>,\n  TStepMeta\n>(\n  transitions: readonly JourneyTransition<TContext, TStepId, TEventType, TPayloadMap>[],\n  snapshot: JourneySnapshot<TContext, TStepId, TStepMeta>,\n  event: JourneyEvent<TStepId, TEventType, TPayloadMap>,\n  hooks?: {\n    onAsyncGuardStart?: (\n      transition: JourneyTransition<TContext, TStepId, TEventType, TPayloadMap>\n    ) => void;\n    onAsyncGuardSuccess?: (\n      transition: JourneyTransition<TContext, TStepId, TEventType, TPayloadMap>\n    ) => void;\n    onAsyncGuardError?: (\n      transition: JourneyTransition<TContext, TStepId, TEventType, TPayloadMap>,\n      error: unknown\n    ) => void;\n  }\n): Promise<JourneyTransition<TContext, TStepId, TEventType, TPayloadMap> | null> => {\n  for (const transition of transitions) {\n    const fromMatches =\n      transition.from === JOURNEY_WILDCARD || 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    const guardResult = transition.when({\n      context: snapshot.context,\n      from: snapshot.currentStepId,\n      timeline: snapshot.history.timeline,\n      index: snapshot.history.index,\n      event\n    });\n    const asyncGuard = isPromiseLike(guardResult);\n    if (asyncGuard) {\n      hooks?.onAsyncGuardStart?.(transition);\n    }\n\n    let allowed: boolean;\n    try {\n      allowed = await guardResult;\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, TStepId extends string, TStepMeta>(\n  snapshot: JourneySnapshot<TContext, TStepId, TStepMeta>,\n  nextCurrent: TStepId,\n  nextContext: TContext\n): JourneySnapshot<TContext, TStepId, TStepMeta> => {\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    snapshot.stepMeta,\n    visited\n  );\n};\n", "import { JOURNEY_STATUS } from \"./types/journey.types\";\nimport type {\n  JourneyPersistedSnapshot,\n  JourneyPersistedState,\n  JourneyStorage,\n  ResolvedPersistence\n} from \"./types/persistence.types\";\nimport type { JourneyMachineOptions, JourneySnapshot, JourneyStatus } from \"./types/journey.types\";\nimport { buildInitialAsyncState, buildSnapshot, buildVisitedFromTimeline } from \"./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 === JOURNEY_STATUS.RUNNING ||\n  value === JOURNEY_STATUS.COMPLETE ||\n  value === JOURNEY_STATUS.TERMINATED;\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 resolvePersistence = <TContext, TStepId extends string, TStepMeta>(\n  options?: JourneyMachineOptions<TContext, TStepId, TStepMeta>[\"persistence\"]\n): ResolvedPersistence<TContext, TStepId, TStepMeta> | null => {\n  if (!options) {\n    return null;\n  }\n\n  const storage = options.storage ?? resolveDefaultStorage();\n  if (!storage) {\n    return null;\n  }\n\n  return {\n    key: options.key,\n    storage,\n    version: options.version ?? 1,\n    clearOnReset: options.clearOnReset ?? true,\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 coercePersistedSnapshot = <TContext, TStepId extends string, TStepMeta>(\n  value: unknown,\n  steps: Record<TStepId, unknown>,\n  fallbackContext: TContext,\n  fallbackStepMeta: Record<TStepId, TStepMeta>\n): {\n  snapshot: JourneyPersistedSnapshot<TContext, TStepId, TStepMeta>;\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 : JOURNEY_STATUS.RUNNING;\n  if (!isStatusValue(value.status)) {\n    needsRewrite = true;\n  }\n\n  const stepIds = Object.keys(steps) as TStepId[];\n  const visitedSource = value.visited;\n  const visitedFromRecord = isRecord(visitedSource)\n    ? (Object.fromEntries(\n        stepIds.map((stepId) => [stepId, visitedSource[stepId] === true])\n      ) as Record<TStepId, boolean>)\n    : null;\n  const visitedFromArray = Array.isArray(visitedSource)\n    ? buildVisitedFromTimeline(\n        visitedSource.filter(\n          (step): step is TStepId => typeof step === \"string\" && step in steps\n        ) as TStepId[],\n        stepIds\n      )\n    : null;\n\n  let visited = buildVisitedFromTimeline(timeline, stepIds);\n  if (visitedFromRecord) {\n    const visitedRecord = visitedSource as Record<string, unknown>;\n    visited = visitedFromRecord;\n    const hasMissingOrInvalidStep = stepIds.some(\n      (stepId) => typeof visitedRecord[stepId] !== \"boolean\"\n    );\n    if (hasMissingOrInvalidStep) {\n      needsRewrite = true;\n    }\n  } else if (visitedFromArray) {\n    visited = visitedFromArray;\n    needsRewrite = true;\n  } else {\n    needsRewrite = true;\n  }\n\n  const rawStepMeta = isRecord(value.stepMeta) ? value.stepMeta : null;\n  if (!rawStepMeta) {\n    needsRewrite = true;\n  }\n\n  const stepMeta = Object.fromEntries(\n    Object.keys(steps).map((stepId) => {\n      const typedStepId = stepId as TStepId;\n      const rawValue = rawStepMeta ? rawStepMeta[stepId] : undefined;\n      if (rawValue === undefined) {\n        return [typedStepId, fallbackStepMeta[typedStepId]];\n      }\n      return [typedStepId, rawValue as TStepMeta];\n    })\n  ) as Record<TStepId, TStepMeta>;\n\n  return {\n    snapshot: {\n      currentStepId: timeline[index] as TStepId,\n      history: {\n        timeline,\n        index\n      },\n      context: (\"context\" in value ? value.context : fallbackContext) as TContext,\n      status,\n      visited,\n      stepMeta\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 = <TContext, TStepId extends string, TStepMeta>(args: {\n  initial: TStepId;\n  context: TContext;\n  stepMeta: Record<TStepId, TStepMeta>;\n  steps: Record<TStepId, unknown>;\n  options?: JourneyMachineOptions<TContext, TStepId, TStepMeta>;\n}) => {\n  const { initial, context, stepMeta, steps, options } = args;\n  const persistence = resolvePersistence(options?.persistence);\n\n  const reportPersistenceError = (error: unknown) => {\n    persistence?.onError?.(error);\n  };\n\n  const persistSnapshot = (snapshot: JourneySnapshot<TContext, TStepId, TStepMeta>) => {\n    if (!persistence) {\n      return;\n    }\n\n    try {\n      const persistedState: JourneyPersistedState<TContext, TStepId, TStepMeta> = {\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: snapshot.context,\n          status: snapshot.status,\n          visited: { ...snapshot.visited },\n          stepMeta: { ...snapshot.stepMeta }\n        }\n      };\n      persistence.storage.setItem(persistence.key, persistence.serialize(persistedState));\n    } catch (error) {\n      reportPersistenceError(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      reportPersistenceError(error);\n    }\n  };\n\n  const hydrateSnapshot = (): JourneySnapshot<TContext, TStepId, TStepMeta> => {\n    const initialSnapshot = buildSnapshot(\n      [initial],\n      0,\n      context,\n      JOURNEY_STATUS.RUNNING,\n      buildInitialAsyncState(steps),\n      stepMeta\n    );\n    if (!persistence) {\n      return initialSnapshot;\n    }\n\n    try {\n      const rawPersisted = persistence.storage.getItem(persistence.key);\n      if (!rawPersisted) {\n        return initialSnapshot;\n      }\n\n      const parsed = persistence.deserialize(rawPersisted);\n      if (!isRecord(parsed)) {\n        return initialSnapshot;\n      }\n\n      const persistedVersion = parsed.version;\n      if (typeof persistedVersion !== \"number\") {\n        return initialSnapshot;\n      }\n\n      let persistedSnapshot: JourneyPersistedSnapshot<TContext, TStepId, TStepMeta> | null = null;\n      let shouldRewritePersisted = false;\n\n      if (persistedVersion === persistence.version) {\n        const coerced = coercePersistedSnapshot(parsed.snapshot, steps, context, stepMeta);\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, stepMeta);\n        persistedSnapshot = coerced?.snapshot ?? null;\n        shouldRewritePersisted = persistedSnapshot !== null;\n      }\n\n      if (!persistedSnapshot) {\n        return initialSnapshot;\n      }\n\n      const hydratedSnapshot = buildSnapshot(\n        persistedSnapshot.history.timeline,\n        persistedSnapshot.history.index,\n        persistedSnapshot.context,\n        persistedSnapshot.status,\n        buildInitialAsyncState(steps),\n        persistedSnapshot.stepMeta,\n        persistedSnapshot.visited\n      );\n\n      if (shouldRewritePersisted) {\n        persistSnapshot(hydratedSnapshot);\n      }\n\n      return hydratedSnapshot;\n    } catch (error) {\n      reportPersistenceError(error);\n      return initialSnapshot;\n    }\n  };\n\n  return {\n    clearOnReset: persistence?.clearOnReset ?? true,\n    hydrateSnapshot,\n    persistSnapshot,\n    removePersistedSnapshot\n  };\n};\n", "import { JOURNEY_ASYNC_PHASE, JOURNEY_EVENT, JOURNEY_STATUS } from \"./types\";\nimport type {\n  JourneyAsyncState,\n  JourneyAsyncPhase,\n  JourneyDefaultEventType,\n  JourneyDefinition,\n  JourneyEventPayloadMap,\n  JourneyMachine,\n  JourneyMachineOptions,\n  JourneyObservationEvent,\n  JourneySendResult,\n  JourneyStepDefinition,\n  JourneyTransition,\n  JourneyTerminal\n} from \"./types\";\nimport {\n  assertStepExists,\n  buildIdleStepAsyncState,\n  buildInitialAsyncState,\n  buildSendResult,\n  buildSnapshot,\n  isGoToStepByIdEvent,\n  isPromiseLike,\n  isTerminalTarget,\n  normalizeStepCount,\n  now,\n  selectTransition,\n  transitionSnapshot,\n  validateJourneyTransitions\n} from \"./machine-helpers\";\nimport { createPersistenceController } from \"./persistence\";\n\n/**\n * Creates a journey machine from a journey definition.\n * Validates steps/transitions, hydrates persisted state (if configured),\n * and returns an API for sending events and reading snapshots.\n */\nexport function createJourneyMachine<\n  TContext,\n  TStepMeta = unknown,\n  TSteps extends Record<string, JourneyStepDefinition<TStepMeta>> = Record<\n    string,\n    JourneyStepDefinition<TStepMeta>\n  >,\n  TPayloadMap extends JourneyEventPayloadMap<JourneyDefaultEventType> = Record<never, never>\n>(\n  journey: {\n    initial: Extract<keyof TSteps, string>;\n    context: TContext;\n    steps: TSteps;\n    transitions: readonly JourneyTransition<\n      TContext,\n      Extract<keyof TSteps, string>,\n      JourneyDefaultEventType,\n      TPayloadMap\n    >[];\n  },\n  options?: JourneyMachineOptions<TContext, Extract<keyof TSteps, string>, TStepMeta>\n): JourneyMachine<\n  TContext,\n  Extract<keyof TSteps, string>,\n  JourneyDefaultEventType,\n  TPayloadMap,\n  TStepMeta\n>;\n// eslint-disable-next-line no-redeclare\nexport function createJourneyMachine<\n  TContext,\n  TStepId extends string,\n  TEventType extends string = JourneyDefaultEventType,\n  TPayloadMap extends JourneyEventPayloadMap<TEventType> = Record<never, never>,\n  TStepMeta = unknown\n>(\n  journey: JourneyDefinition<TContext, TStepId, TEventType, TPayloadMap, TStepMeta>,\n  options?: JourneyMachineOptions<TContext, TStepId, TStepMeta>\n): JourneyMachine<TContext, TStepId, TEventType, TPayloadMap, TStepMeta>;\n// eslint-disable-next-line no-redeclare\nexport function createJourneyMachine<\n  TContext,\n  TStepId extends string,\n  TEventType extends string = JourneyDefaultEventType,\n  TPayloadMap extends JourneyEventPayloadMap<TEventType> = Record<never, never>,\n  TStepMeta = unknown\n>(\n  journey: JourneyDefinition<TContext, TStepId, TEventType, TPayloadMap, TStepMeta>,\n  options?: JourneyMachineOptions<TContext, TStepId, TStepMeta>\n): JourneyMachine<TContext, TStepId, TEventType, TPayloadMap, TStepMeta> {\n  if (!journey.steps || typeof journey.steps !== \"object\") {\n    throw new Error(\"Journey steps must be a record object.\");\n  }\n\n  if (!Array.isArray(journey.transitions)) {\n    throw new Error(\"Journey transitions must be an array.\");\n  }\n\n  assertStepExists(\n    journey.steps,\n    journey.initial,\n    `Journey initial step \"${journey.initial}\" does not exist in steps registry.`\n  );\n\n  validateJourneyTransitions(journey.transitions, journey.steps);\n\n  const buildStepMeta = (): Record<TStepId, TStepMeta> =>\n    Object.fromEntries(\n      Object.entries(journey.steps).map(([stepId, definition]) => [\n        stepId,\n        (definition as JourneyStepDefinition<TStepMeta>).meta as TStepMeta\n      ])\n    ) as Record<TStepId, TStepMeta>;\n\n  const { clearOnReset, hydrateSnapshot, persistSnapshot, removePersistedSnapshot } =\n    createPersistenceController({\n      initial: journey.initial,\n      context: journey.context,\n      stepMeta: buildStepMeta(),\n      steps: journey.steps,\n      ...(options ? { options } : {})\n    });\n\n  let snapshot = hydrateSnapshot();\n  snapshot = {\n    ...snapshot,\n    async: buildInitialAsyncState(journey.steps)\n  };\n\n  const listeners = new Set<() => void>();\n  const eventListeners = new Set<\n    (event: JourneyObservationEvent<TStepId, TEventType, TPayloadMap, TStepMeta>) => void\n  >();\n  let actionQueue: Promise<void> = Promise.resolve();\n\n  const notify = () => {\n    for (const listener of listeners) {\n      listener();\n    }\n  };\n\n  const emit = (event: JourneyObservationEvent<TStepId, TEventType, TPayloadMap, TStepMeta>) => {\n    for (const listener of eventListeners) {\n      listener(event);\n    }\n  };\n\n  const queue = <T>(runner: () => Promise<T>): Promise<T> => {\n    const resultPromise = actionQueue.then(runner, runner);\n    actionQueue = resultPromise.then(\n      () => undefined,\n      () => undefined\n    );\n    return resultPromise;\n  };\n\n  const isAsyncLoadingPhase = (phase: JourneyAsyncPhase): boolean =>\n    phase === JOURNEY_ASYNC_PHASE.EVALUATING_WHEN || phase === JOURNEY_ASYNC_PHASE.RUNNING_EFFECT;\n\n  const updateStepAsync = (\n    stepId: TStepId,\n    updater: (\n      current: JourneyAsyncState<TStepId>[\"byStep\"][TStepId]\n    ) => JourneyAsyncState<TStepId>[\"byStep\"][TStepId]\n  ) => {\n    const current = snapshot.async.byStep[stepId] ?? buildIdleStepAsyncState();\n    const next = updater(current);\n    if (\n      current.phase === next.phase &&\n      current.eventType === next.eventType &&\n      current.transitionId === next.transitionId &&\n      current.error === next.error\n    ) {\n      return;\n    }\n\n    const nextByStep = {\n      ...snapshot.async.byStep,\n      [stepId]: next\n    };\n    const isLoading = Object.values(nextByStep).some((state) => isAsyncLoadingPhase(state.phase));\n    snapshot = {\n      ...snapshot,\n      async: {\n        isLoading,\n        byStep: nextByStep\n      }\n    };\n    notify();\n  };\n\n  const setStepLoading = (\n    stepId: TStepId,\n    phase: JourneyAsyncPhase,\n    eventType: string,\n    transitionId?: string\n  ) => {\n    updateStepAsync(stepId, () => ({\n      phase,\n      eventType,\n      transitionId: transitionId ?? null,\n      error: null\n    }));\n  };\n\n  const setStepIdle = (stepId: TStepId) => {\n    updateStepAsync(stepId, () => buildIdleStepAsyncState());\n  };\n\n  const setStepError = (\n    stepId: TStepId,\n    eventType: string,\n    error: unknown,\n    transitionId?: string\n  ) => {\n    updateStepAsync(stepId, () => ({\n      phase: JOURNEY_ASYNC_PHASE.ERROR,\n      eventType,\n      transitionId: transitionId ?? null,\n      error\n    }));\n  };\n\n  const applyPreviousNavigation = (\n    requestedSteps?: number,\n    transitionId?: string\n  ): JourneySendResult<TContext, TStepId, TStepMeta> => {\n    if (snapshot.status !== JOURNEY_STATUS.RUNNING) {\n      return buildSendResult(snapshot, false);\n    }\n\n    const steps = normalizeStepCount(requestedSteps);\n    if (snapshot.history.index === 0) {\n      return buildSendResult(snapshot, false);\n    }\n\n    const from = snapshot.currentStepId;\n    const nextIndex = Math.max(0, snapshot.history.index - steps);\n    const appliedSteps = snapshot.history.index - nextIndex;\n    if (appliedSteps <= 0) {\n      return buildSendResult(snapshot, false);\n    }\n\n    emit({ type: \"step.exit\", stepId: from, timestamp: now() });\n    snapshot = buildSnapshot(\n      snapshot.history.timeline,\n      nextIndex,\n      snapshot.context,\n      snapshot.status,\n      snapshot.async,\n      snapshot.stepMeta,\n      snapshot.visited\n    );\n    persistSnapshot(snapshot);\n    notify();\n\n    emit({\n      type: \"navigation.previous\",\n      from,\n      to: snapshot.currentStepId,\n      requestedSteps: steps,\n      appliedSteps,\n      timestamp: now()\n    });\n    emit({ type: \"step.enter\", stepId: snapshot.currentStepId, timestamp: now() });\n    return buildSendResult(snapshot, true, transitionId);\n  };\n\n  const applyLastVisitedNavigation = (\n    transitionId?: string\n  ): JourneySendResult<TContext, TStepId, TStepMeta> => {\n    if (snapshot.status !== JOURNEY_STATUS.RUNNING) {\n      return buildSendResult(snapshot, false);\n    }\n\n    const targetIndex = snapshot.history.timeline.length - 1;\n    if (snapshot.history.index >= targetIndex) {\n      return buildSendResult(snapshot, false);\n    }\n\n    const from = snapshot.currentStepId;\n    emit({ type: \"step.exit\", stepId: from, timestamp: now() });\n    snapshot = buildSnapshot(\n      snapshot.history.timeline,\n      targetIndex,\n      snapshot.context,\n      snapshot.status,\n      snapshot.async,\n      snapshot.stepMeta,\n      snapshot.visited\n    );\n    persistSnapshot(snapshot);\n    notify();\n\n    emit({ type: \"navigation.lastVisited\", from, to: snapshot.currentStepId, timestamp: now() });\n    emit({ type: \"step.enter\", stepId: snapshot.currentStepId, timestamp: now() });\n    return buildSendResult(snapshot, true, transitionId);\n  };\n\n  const machine: JourneyMachine<TContext, TStepId, TEventType, TPayloadMap, TStepMeta> = {\n    getSnapshot: () => snapshot,\n    subscribe: (listener) => {\n      listeners.add(listener);\n      return () => {\n        listeners.delete(listener);\n      };\n    },\n    subscribeEvent: (listener) => {\n      eventListeners.add(listener);\n      return () => {\n        eventListeners.delete(listener);\n      };\n    },\n    resetMachine: () => {\n      snapshot = buildSnapshot(\n        [journey.initial],\n        0,\n        journey.context,\n        JOURNEY_STATUS.RUNNING,\n        buildInitialAsyncState(journey.steps),\n        buildStepMeta()\n      );\n      if (clearOnReset) {\n        removePersistedSnapshot();\n      } else {\n        persistSnapshot(snapshot);\n      }\n      notify();\n      return snapshot;\n    },\n    updateContext: (updater) => {\n      snapshot = {\n        ...snapshot,\n        context: updater(snapshot.context)\n      };\n      persistSnapshot(snapshot);\n      notify();\n      return snapshot;\n    },\n    updateStepMetadata: (stepId, updater) => {\n      if (!(stepId in journey.steps)) {\n        return snapshot;\n      }\n\n      const previousMeta = snapshot.stepMeta[stepId];\n      const nextMeta = updater(previousMeta);\n      if (Object.is(previousMeta, nextMeta)) {\n        return snapshot;\n      }\n\n      snapshot = {\n        ...snapshot,\n        stepMeta: {\n          ...snapshot.stepMeta,\n          [stepId]: nextMeta\n        }\n      };\n      persistSnapshot(snapshot);\n      notify();\n      emit({\n        type: \"metadata.updated\",\n        stepId,\n        previous: previousMeta,\n        next: nextMeta,\n        timestamp: now()\n      });\n      return snapshot;\n    },\n    clearStepError: (stepId) => {\n      const resolvedStep = stepId ?? snapshot.currentStepId;\n      if (!(resolvedStep in journey.steps)) {\n        return snapshot;\n      }\n\n      setStepIdle(resolvedStep);\n      return snapshot;\n    },\n    goToPreviousStep: (steps) =>\n      queue(async () => {\n        const result = applyPreviousNavigation(steps, \"goToPreviousStep\");\n        return result;\n      }),\n    goToLastVisitedStep: () =>\n      queue(async () => {\n        const result = applyLastVisitedNavigation(\"goToLastVisitedStep\");\n        return result;\n      }),\n    goToNextStep: () =>\n      machine.send({ type: \"goToNextStep\" } as Extract<\n        Parameters<typeof machine.send>[0],\n        { type: \"goToNextStep\" }\n      >),\n    terminateJourney: (payload) =>\n      machine.send(\n        (payload === undefined\n          ? ({ type: \"terminateJourney\" } as unknown)\n          : ({ type: \"terminateJourney\", payload } as unknown)) as Extract<\n          Parameters<typeof machine.send>[0],\n          { type: \"terminateJourney\" }\n        >\n      ),\n    completeJourney: (payload) =>\n      machine.send(\n        (payload === undefined\n          ? ({ type: \"completeJourney\" } as unknown)\n          : ({ type: \"completeJourney\", payload } as unknown)) as Extract<\n          Parameters<typeof machine.send>[0],\n          { type: \"completeJourney\" }\n        >\n      ),\n    send: (event) =>\n      queue(async () => {\n        if (snapshot.status !== JOURNEY_STATUS.RUNNING) {\n          return buildSendResult(snapshot, false);\n        }\n\n        const fromStep = snapshot.currentStepId;\n\n        if (isGoToStepByIdEvent(event)) {\n          assertStepExists(\n            journey.steps,\n            event.stepId,\n            `Cannot goToStepById unknown step \"${event.stepId}\".`\n          );\n          emit({ type: \"transition.start\", from: fromStep, event, timestamp: now() });\n          setStepIdle(fromStep);\n\n          const beforeCurrent = snapshot.currentStepId;\n          const nextSnapshot = transitionSnapshot(snapshot, event.stepId, snapshot.context);\n          if (nextSnapshot.currentStepId !== beforeCurrent) {\n            emit({ type: \"step.exit\", stepId: beforeCurrent, timestamp: now() });\n          }\n\n          snapshot = nextSnapshot;\n          persistSnapshot(snapshot);\n          notify();\n\n          emit({\n            type: \"transition.success\",\n            from: fromStep,\n            to: snapshot.currentStepId,\n            eventType: JOURNEY_EVENT.GO_TO_STEP_BY_ID,\n            transitionId: JOURNEY_EVENT.GO_TO_STEP_BY_ID,\n            timestamp: now()\n          });\n\n          if (nextSnapshot.currentStepId !== beforeCurrent) {\n            emit({ type: \"step.enter\", stepId: snapshot.currentStepId, timestamp: now() });\n          }\n\n          return buildSendResult(snapshot, true, JOURNEY_EVENT.GO_TO_STEP_BY_ID);\n        }\n\n        emit({ type: \"transition.start\", from: fromStep, event, timestamp: now() });\n\n        let transition;\n        try {\n          transition = await selectTransition(journey.transitions, snapshot, event, {\n            onAsyncGuardStart: (currentTransition) => {\n              setStepLoading(\n                fromStep,\n                JOURNEY_ASYNC_PHASE.EVALUATING_WHEN,\n                event.type,\n                currentTransition.id\n              );\n            },\n            onAsyncGuardSuccess: () => {\n              setStepIdle(fromStep);\n            },\n            onAsyncGuardError: (currentTransition, error) => {\n              setStepError(fromStep, event.type, error, currentTransition.id);\n            }\n          });\n        } catch (error) {\n          setStepError(fromStep, event.type, error);\n          emit({\n            type: \"transition.error\",\n            from: fromStep,\n            eventType: event.type,\n            transitionId: null,\n            error,\n            timestamp: now()\n          });\n          throw error;\n        }\n\n        if (!transition) {\n          if (event.type === \"goToPreviousStep\" || event.type === \"back\") {\n            const fallbackResult = applyPreviousNavigation(1, event.type);\n            if (fallbackResult.transitioned) {\n              emit({\n                type: \"transition.success\",\n                from: fromStep,\n                to: fallbackResult.snapshot.currentStepId,\n                eventType: event.type,\n                transitionId: null,\n                timestamp: now()\n              });\n            }\n            return fallbackResult;\n          }\n\n          return buildSendResult(snapshot, false);\n        }\n\n        let nextContext = snapshot.context;\n        if (transition.effect) {\n          const effectResultPromise = transition.effect({\n            context: snapshot.context,\n            from: snapshot.currentStepId,\n            timeline: snapshot.history.timeline,\n            index: snapshot.history.index,\n            event\n          });\n          if (isPromiseLike(effectResultPromise)) {\n            setStepLoading(\n              fromStep,\n              JOURNEY_ASYNC_PHASE.RUNNING_EFFECT,\n              event.type as string,\n              transition.id\n            );\n          }\n\n          let effectResult: TContext | void;\n          try {\n            effectResult = await effectResultPromise;\n          } catch (error) {\n            setStepError(fromStep, event.type, error, transition.id);\n            emit({\n              type: \"transition.error\",\n              from: fromStep,\n              eventType: event.type,\n              transitionId: transition.id ?? null,\n              error,\n              timestamp: now()\n            });\n            throw error;\n          }\n\n          if (effectResult !== undefined) {\n            nextContext = effectResult;\n          }\n        }\n\n        setStepIdle(fromStep);\n\n        const target: TStepId | JourneyTerminal =\n          transition.event === \"completeJourney\"\n            ? \"COMPLETE\"\n            : transition.event === \"terminateJourney\"\n              ? \"TERMINATED\"\n              : (transition.to as TStepId | JourneyTerminal);\n\n        if (isTerminalTarget(target)) {\n          const normalizedTimeline = snapshot.history.timeline.slice(0, snapshot.history.index + 1);\n          snapshot = {\n            ...snapshot,\n            history: {\n              timeline: normalizedTimeline,\n              index: normalizedTimeline.length - 1\n            },\n            context: nextContext,\n            status: target === \"COMPLETE\" ? JOURNEY_STATUS.COMPLETE : JOURNEY_STATUS.TERMINATED\n          };\n          persistSnapshot(snapshot);\n          notify();\n\n          emit({\n            type: \"transition.success\",\n            from: fromStep,\n            to: target,\n            eventType: event.type,\n            transitionId: transition.id ?? null,\n            timestamp: now()\n          });\n          emit({\n            type: target === \"COMPLETE\" ? \"journey.complete\" : \"journey.close\",\n            stepId: snapshot.currentStepId,\n            timestamp: now()\n          });\n\n          return buildSendResult(snapshot, true, transition.id);\n        }\n\n        const resolvedTarget = target;\n\n        assertStepExists(\n          journey.steps,\n          resolvedTarget,\n          `Transition points to unknown step \"${resolvedTarget}\".`\n        );\n\n        const beforeCurrent = snapshot.currentStepId;\n        if (beforeCurrent !== resolvedTarget) {\n          emit({ type: \"step.exit\", stepId: beforeCurrent, timestamp: now() });\n        }\n        snapshot = transitionSnapshot(snapshot, resolvedTarget, nextContext);\n        persistSnapshot(snapshot);\n        notify();\n\n        emit({\n          type: \"transition.success\",\n          from: fromStep,\n          to: snapshot.currentStepId,\n          eventType: event.type,\n          transitionId: transition.id ?? null,\n          timestamp: now()\n        });\n        if (beforeCurrent !== snapshot.currentStepId) {\n          emit({ type: \"step.enter\", stepId: snapshot.currentStepId, timestamp: now() });\n        }\n\n        return buildSendResult(snapshot, true, transition.id);\n      })\n  };\n\n  return machine;\n}\n", "import { JOURNEY_WILDCARD } from \"./types/journey.types\";\nimport type { JourneyEventPayloadMap } from \"./types/journey.types\";\nimport type {\n  EventBuilder,\n  JourneyEventTransition,\n  JourneyTransition,\n  JourneyTransitionArgs,\n  JourneyTransitionTarget,\n  TransitionBranch,\n  TransitionConfig\n} from \"./types/transitions.types\";\n\nconst createEventBuilder = <\n  TContext,\n  TStepId extends string,\n  TEventType extends string,\n  TPayloadMap extends JourneyEventPayloadMap<TEventType>\n>(\n  from: TStepId | typeof JOURNEY_WILDCARD,\n  event: TEventType\n): EventBuilder<TContext, TStepId, TEventType, TPayloadMap> => {\n  if (event === \"completeJourney\") {\n    return {\n      complete: (\n        config: TransitionConfig<TContext, TStepId, TEventType, TPayloadMap> = {}\n      ): JourneyTransition<TContext, TStepId, TEventType, TPayloadMap> =>\n        ({\n          ...config,\n          from,\n          event: event as Extract<TEventType, \"completeJourney\">\n        }) as JourneyTransition<TContext, TStepId, TEventType, TPayloadMap>\n    } as EventBuilder<TContext, TStepId, TEventType, TPayloadMap>;\n  }\n\n  if (event === \"terminateJourney\") {\n    return {\n      terminate: (\n        config: TransitionConfig<TContext, TStepId, TEventType, TPayloadMap> = {}\n      ): JourneyTransition<TContext, TStepId, TEventType, TPayloadMap> =>\n        ({\n          ...config,\n          from,\n          event: event as Extract<TEventType, \"terminateJourney\">\n        }) as JourneyTransition<TContext, TStepId, TEventType, TPayloadMap>\n    } as EventBuilder<TContext, TStepId, TEventType, TPayloadMap>;\n  }\n\n  return {\n    to: (\n      to: JourneyTransitionTarget<TStepId>,\n      config: TransitionConfig<TContext, TStepId, TEventType, TPayloadMap> = {}\n    ): JourneyTransition<TContext, TStepId, TEventType, TPayloadMap> =>\n      ({\n        ...config,\n        from,\n        event: event as Exclude<TEventType, \"completeJourney\" | \"terminateJourney\">,\n        to\n      }) as JourneyTransition<TContext, TStepId, TEventType, TPayloadMap>,\n    choose: (\n      ...branches: Array<TransitionBranch<TContext, TStepId, TEventType, TPayloadMap>>\n    ): JourneyTransition<TContext, TStepId, TEventType, TPayloadMap>[] =>\n      branches.map(\n        (branch) =>\n          ({\n            ...branch,\n            from,\n            event: event as Exclude<TEventType, \"completeJourney\" | \"terminateJourney\">\n          }) as JourneyTransition<TContext, TStepId, TEventType, TPayloadMap>\n      )\n  } as EventBuilder<TContext, TStepId, TEventType, TPayloadMap>;\n};\n\nconst buildTerminalTransition = <\n  TContext,\n  TStepId extends string,\n  TEventType extends \"completeJourney\" | \"terminateJourney\"\n>(\n  from: TStepId | typeof JOURNEY_WILDCARD,\n  event: TEventType,\n  config: TransitionConfig<TContext, TStepId, TEventType, Record<never, never>> = {}\n): JourneyEventTransition<TContext, TStepId, TEventType, Record<never, never>> =>\n  ({\n    ...config,\n    from,\n    event\n  }) as JourneyEventTransition<TContext, TStepId, TEventType, Record<never, never>>;\n\nexport const tx = {\n  from: <TStepId extends string, TContext = unknown>(from: TStepId) => ({\n    on: <TEventType extends string>(event: TEventType) =>\n      createEventBuilder<TContext, TStepId, TEventType, Record<never, never>>(from, event),\n    toComplete: (\n      config: TransitionConfig<TContext, TStepId, \"completeJourney\", Record<never, never>> = {}\n    ) => buildTerminalTransition(from, \"completeJourney\", config),\n    toTerminate: (\n      config: TransitionConfig<TContext, TStepId, \"terminateJourney\", Record<never, never>> = {}\n    ) => buildTerminalTransition(from, \"terminateJourney\", config)\n  }),\n  any: <TContext = unknown, TStepId extends string = string>() => ({\n    on: <TEventType extends string>(event: TEventType) =>\n      createEventBuilder<TContext, TStepId, TEventType, Record<never, never>>(\n        JOURNEY_WILDCARD,\n        event\n      ),\n    toComplete: (\n      config: TransitionConfig<TContext, TStepId, \"completeJourney\", Record<never, never>> = {}\n    ) => buildTerminalTransition(JOURNEY_WILDCARD, \"completeJourney\", config),\n    toTerminate: (\n      config: TransitionConfig<TContext, TStepId, \"terminateJourney\", Record<never, never>> = {}\n    ) => buildTerminalTransition(JOURNEY_WILDCARD, \"terminateJourney\", config)\n  }),\n  when: <\n    TContext,\n    TStepId extends string,\n    TEventType extends string,\n    TPayloadMap extends JourneyEventPayloadMap<TEventType>\n  >(\n    predicate: (\n      args: JourneyTransitionArgs<TContext, TStepId, TEventType, TPayloadMap>\n    ) => boolean | Promise<boolean>\n  ) => ({\n    to: (\n      to: JourneyTransitionTarget<TStepId>,\n      config: TransitionConfig<TContext, TStepId, TEventType, TPayloadMap> = {}\n    ): TransitionBranch<TContext, TStepId, TEventType, TPayloadMap> => ({\n      ...config,\n      to,\n      when: predicate\n    })\n  }),\n  otherwise: <\n    TContext,\n    TStepId extends string,\n    TEventType extends string,\n    TPayloadMap extends JourneyEventPayloadMap<TEventType>\n  >() => ({\n    to: (\n      to: JourneyTransitionTarget<TStepId>,\n      config: TransitionConfig<TContext, TStepId, TEventType, TPayloadMap> = {}\n    ): TransitionBranch<TContext, TStepId, TEventType, TPayloadMap> => ({\n      ...config,\n      to\n    })\n  })\n};\n\nexport const createTransitions = <\n  TContext,\n  TStepId extends string,\n  TEventType extends string,\n  TPayloadMap extends JourneyEventPayloadMap<TEventType>\n>(\n  ...items: Array<\n    | JourneyTransition<TContext, TStepId, TEventType, TPayloadMap>\n    | readonly JourneyTransition<TContext, TStepId, TEventType, TPayloadMap>[]\n  >\n): JourneyTransition<TContext, TStepId, TEventType, TPayloadMap>[] =>\n  items.flatMap((item) => (Array.isArray(item) ? [...item] : [item]));\n"],
+  "mappings": "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",
+  "names": ["JOURNEY_STATUS", "JOURNEY_WILDCARD", "JOURNEY_EVENT", "JOURNEY_ASYNC_PHASE", "assertStepExists", "steps", "stepId", "message", "normalizeStepCount", "now", "unique", "items", "normalizeVisited", "visited", "stepIds", "buildVisitedFromTimeline", "timeline", "resolvedStepIds", "appendVisited", "current", "isPromiseLike", "value", "buildIdleStepAsyncState", "JOURNEY_ASYNC_PHASE", "buildInitialAsyncState", "isGoToStepByIdEvent", "event", "JOURNEY_EVENT", "isTerminalTarget", "target", "validateJourneyTransitions", "transitions", "stepRegistry", "index", "transition", "JOURNEY_WILDCARD", "buildSendResult", "snapshot", "transitioned", "transitionId", "buildSnapshot", "context", "status", "asyncState", "stepMeta", "safeIndex", "currentStepId", "selectTransition", "hooks", "fromMatches", "eventMatches", "guardResult", "asyncGuard", "allowed", "error", "transitionSnapshot", "nextCurrent", "nextContext", "baseTimeline", "nextTimeline", "nextIndex", "isRecord", "value", "isStatusValue", "JOURNEY_STATUS", "resolveDefaultStorage", "localStorageCandidate", "resolvePersistence", "options", "storage", "coercePersistedSnapshot", "steps", "fallbackContext", "fallbackStepMeta", "needsRewrite", "rawHistory", "rawTimeline", "timeline", "step", "currentStepIdValue", "index", "rawIndex", "inferredIndex", "status", "stepIds", "visitedSource", "visitedFromRecord", "stepId", "visitedFromArray", "buildVisitedFromTimeline", "visited", "visitedRecord", "rawStepMeta", "stepMeta", "typedStepId", "rawValue", "createPersistenceController", "args", "initial", "context", "persistence", "reportPersistenceError", "error", "persistSnapshot", "snapshot", "persistedState", "removePersistedSnapshot", "hydrateSnapshot", "initialSnapshot", "buildSnapshot", "buildInitialAsyncState", "rawPersisted", "parsed", "persistedVersion", "persistedSnapshot", "shouldRewritePersisted", "coerced", "migrated", "hydratedSnapshot", "createJourneyMachine", "journey", "options", "assertStepExists", "validateJourneyTransitions", "buildStepMeta", "stepId", "definition", "clearOnReset", "hydrateSnapshot", "persistSnapshot", "removePersistedSnapshot", "createPersistenceController", "snapshot", "buildInitialAsyncState", "listeners", "eventListeners", "actionQueue", "notify", "listener", "emit", "event", "queue", "runner", "resultPromise", "isAsyncLoadingPhase", "phase", "JOURNEY_ASYNC_PHASE", "updateStepAsync", "updater", "current", "buildIdleStepAsyncState", "next", "nextByStep", "isLoading", "state", "setStepLoading", "eventType", "transitionId", "setStepIdle", "setStepError", "error", "applyPreviousNavigation", "requestedSteps", "JOURNEY_STATUS", "buildSendResult", "steps", "normalizeStepCount", "from", "nextIndex", "appliedSteps", "now", "buildSnapshot", "applyLastVisitedNavigation", "targetIndex", "machine", "previousMeta", "nextMeta", "resolvedStep", "payload", "fromStep", "isGoToStepByIdEvent", "beforeCurrent", "nextSnapshot", "transitionSnapshot", "JOURNEY_EVENT", "transition", "selectTransition", "currentTransition", "fallbackResult", "nextContext", "effectResultPromise", "isPromiseLike", "effectResult", "target", "isTerminalTarget", "normalizedTimeline", "resolvedTarget", "createEventBuilder", "from", "event", "config", "to", "branches", "branch", "buildTerminalTransition", "tx", "JOURNEY_WILDCARD", "predicate", "createTransitions", "items", "item"]
 }

package/dist/machine-helpers.d.ts

@@ -1,23 +1,21 @@
 import { JOURNEY_EVENT } from "./types";
 import type { JourneyAsyncState, JourneyEvent, JourneyEventPayloadMap, JourneyGoToEvent, JourneyPayloadFor, JourneySendResult, JourneySnapshot, JourneyStatus, JourneyStepAsyncState, JourneyTerminal, JourneyTransition } from "./types";
 export declare const assertStepExists: <TStepId extends string>(steps: Record<TStepId, unknown>, stepId: TStepId, message: string) => void;
-export declare const buildVisited: <TStepId extends string>(history: readonly TStepId[], current: TStepId) => TStepId[];
-export declare const appendVisited: <TStepId extends string>(visited: readonly TStepId[], current: TStepId) => TStepId[];
+export declare const normalizeStepCount: (steps?: number) => number;
+export declare const now: () => number;
+export declare const buildVisitedFromTimeline: <TStepId extends string>(timeline: readonly TStepId[], stepIds?: readonly TStepId[]) => Record<TStepId, boolean>;
+export declare const appendVisited: <TStepId extends string>(visited: Record<TStepId, boolean>, current: TStepId) => Record<TStepId, boolean>;
 export declare const isPromiseLike: <T>(value: T | PromiseLike<T>) => value is PromiseLike<T>;
 export declare const buildIdleStepAsyncState: () => JourneyStepAsyncState;
 export declare const buildInitialAsyncState: <TStepId extends string>(steps: Record<TStepId, unknown>) => JourneyAsyncState<TStepId>;
-export declare const isGoToEvent: <TStepId extends string, TEventType extends string, TPayloadMap extends JourneyEventPayloadMap<TEventType>>(event: JourneyEvent<TStepId, TEventType, TPayloadMap>) => event is JourneyGoToEvent<TStepId, JourneyPayloadFor<TEventType, TPayloadMap, (typeof JOURNEY_EVENT)["GO_TO"]>>;
-export declare const isTerminalTarget: <TStepId extends string>(target: TStepId | JourneyTerminal | "__HISTORY__") => target is JourneyTerminal;
-export declare const buildSendResult: <TContext, TStepId extends string>(snapshot: JourneySnapshot<TContext, TStepId>, transitioned: boolean, transitionId?: string) => JourneySendResult<TContext, TStepId>;
-export declare const buildSnapshot: <TContext, TStepId extends string>(current: TStepId, context: TContext, history: readonly TStepId[], status: JourneyStatus, asyncState: JourneyAsyncState<TStepId>, visited?: readonly TStepId[]) => JourneySnapshot<TContext, TStepId>;
-export declare const resolveHistoryTarget: <TContext, TStepId extends string>(snapshot: JourneySnapshot<TContext, TStepId>, steps: Record<TStepId, unknown>) => {
-    target: TStepId;
-    history: TStepId[];
-};
-export declare const selectTransition: <TContext, TStepId extends string, TEventType extends string, TPayloadMap extends JourneyEventPayloadMap<TEventType>>(transitions: readonly JourneyTransition<TContext, TStepId, TEventType, TPayloadMap>[], snapshot: JourneySnapshot<TContext, TStepId>, event: JourneyEvent<TStepId, TEventType, TPayloadMap>, hooks?: {
+export declare const isGoToStepByIdEvent: <TStepId extends string, TEventType extends string, TPayloadMap extends JourneyEventPayloadMap<TEventType>>(event: JourneyEvent<TStepId, TEventType, TPayloadMap>) => event is JourneyGoToEvent<TStepId, JourneyPayloadFor<TEventType, TPayloadMap, (typeof JOURNEY_EVENT)["GO_TO_STEP_BY_ID"]>>;
+export declare const isTerminalTarget: <TStepId extends string>(target: TStepId | JourneyTerminal) => target is JourneyTerminal;
+export declare const validateJourneyTransitions: <TContext, TStepId extends string, TEventType extends string, TPayloadMap extends JourneyEventPayloadMap<TEventType>>(transitions: readonly JourneyTransition<TContext, TStepId, TEventType, TPayloadMap>[], steps: Record<TStepId, unknown>) => void;
+export declare const buildSendResult: <TContext, TStepId extends string, TStepMeta>(snapshot: JourneySnapshot<TContext, TStepId, TStepMeta>, transitioned: boolean, transitionId?: string) => JourneySendResult<TContext, TStepId, TStepMeta>;
+export declare const buildSnapshot: <TContext, TStepId extends string, TStepMeta>(timeline: readonly TStepId[], index: number, context: TContext, status: JourneyStatus, asyncState: JourneyAsyncState<TStepId>, stepMeta: Record<TStepId, TStepMeta>, visited?: Record<TStepId, boolean>) => JourneySnapshot<TContext, TStepId, TStepMeta>;
+export declare const selectTransition: <TContext, TStepId extends string, TEventType extends string, TPayloadMap extends JourneyEventPayloadMap<TEventType>, TStepMeta>(transitions: readonly JourneyTransition<TContext, TStepId, TEventType, TPayloadMap>[], snapshot: JourneySnapshot<TContext, TStepId, TStepMeta>, event: JourneyEvent<TStepId, TEventType, TPayloadMap>, hooks?: {
     onAsyncGuardStart?: (transition: JourneyTransition<TContext, TStepId, TEventType, TPayloadMap>) => void;
     onAsyncGuardSuccess?: (transition: JourneyTransition<TContext, TStepId, TEventType, TPayloadMap>) => void;
     onAsyncGuardError?: (transition: JourneyTransition<TContext, TStepId, TEventType, TPayloadMap>, error: unknown) => void;
 }) => Promise<JourneyTransition<TContext, TStepId, TEventType, TPayloadMap> | null>;
-export declare const transitionSnapshot: <TContext, TStepId extends string>(snapshot: JourneySnapshot<TContext, TStepId>, nextCurrent: TStepId, nextContext: TContext) => JourneySnapshot<TContext, TStepId>;
-//# sourceMappingURL=machine-helpers.d.ts.map
+export declare const transitionSnapshot: <TContext, TStepId extends string, TStepMeta>(snapshot: JourneySnapshot<TContext, TStepId, TStepMeta>, nextCurrent: TStepId, nextContext: TContext) => JourneySnapshot<TContext, TStepId, TStepMeta>;

package/dist/machine.d.ts

@@ -1,8 +1,13 @@
-import type { JourneyEventPayloadMap, JourneyDefinition, JourneyMachine, JourneyMachineOptions } from "./types";
+import type { JourneyDefaultEventType, JourneyDefinition, JourneyEventPayloadMap, JourneyMachine, JourneyMachineOptions, JourneyStepDefinition, JourneyTransition } from "./types";
 /**
  * Creates a journey machine from a journey definition.
  * Validates steps/transitions, hydrates persisted state (if configured),
  * and returns an API for sending events and reading snapshots.
  */
-export declare const createJourneyMachine: <TContext, TStepId extends string, TEventType extends string = "next" | "back" | "close" | "submit", TPayloadMap extends JourneyEventPayloadMap<TEventType> = Record<never, never>>(journey: JourneyDefinition<TContext, TStepId, TEventType, TPayloadMap>, options?: JourneyMachineOptions<TContext, TStepId>) => JourneyMachine<TContext, TStepId, TEventType, TPayloadMap>;
-//# sourceMappingURL=machine.d.ts.map
+export declare function createJourneyMachine<TContext, TStepMeta = unknown, TSteps extends Record<string, JourneyStepDefinition<TStepMeta>> = Record<string, JourneyStepDefinition<TStepMeta>>, TPayloadMap extends JourneyEventPayloadMap<JourneyDefaultEventType> = Record<never, never>>(journey: {
+    initial: Extract<keyof TSteps, string>;
+    context: TContext;
+    steps: TSteps;
+    transitions: readonly JourneyTransition<TContext, Extract<keyof TSteps, string>, JourneyDefaultEventType, TPayloadMap>[];
+}, options?: JourneyMachineOptions<TContext, Extract<keyof TSteps, string>, TStepMeta>): JourneyMachine<TContext, Extract<keyof TSteps, string>, JourneyDefaultEventType, TPayloadMap, TStepMeta>;
+export declare function createJourneyMachine<TContext, TStepId extends string, TEventType extends string = JourneyDefaultEventType, TPayloadMap extends JourneyEventPayloadMap<TEventType> = Record<never, never>, TStepMeta = unknown>(journey: JourneyDefinition<TContext, TStepId, TEventType, TPayloadMap, TStepMeta>, options?: JourneyMachineOptions<TContext, TStepId, TStepMeta>): JourneyMachine<TContext, TStepId, TEventType, TPayloadMap, TStepMeta>;

package/dist/persistence.d.ts

@@ -1,17 +1,17 @@
-import type { JourneyMachineOptions, JourneySnapshot } from "./types";
+import type { JourneyMachineOptions, JourneySnapshot } from "./types/journey.types";
 /**
  * Creates a persistence controller for snapshots, including hydration,
  * serialization, and storage error handling.
  */
-export declare const createPersistenceController: <TContext, TStepId extends string>(args: {
+export declare const createPersistenceController: <TContext, TStepId extends string, TStepMeta>(args: {
     initial: TStepId;
     context: TContext;
+    stepMeta: Record<TStepId, TStepMeta>;
     steps: Record<TStepId, unknown>;
-    options?: JourneyMachineOptions<TContext, TStepId>;
+    options?: JourneyMachineOptions<TContext, TStepId, TStepMeta>;
 }) => {
     clearOnReset: boolean;
-    hydrateSnapshot: () => JourneySnapshot<TContext, TStepId>;
-    persistSnapshot: (snapshot: JourneySnapshot<TContext, TStepId>) => void;
+    hydrateSnapshot: () => JourneySnapshot<TContext, TStepId, TStepMeta>;
+    persistSnapshot: (snapshot: JourneySnapshot<TContext, TStepId, TStepMeta>) => void;
     removePersistedSnapshot: () => void;
 };
-//# sourceMappingURL=persistence.d.ts.map

package/dist/transitions.d.ts

@@ -0,0 +1,21 @@
+import type { JourneyEventPayloadMap } from "./types/journey.types";
+import type { EventBuilder, JourneyEventTransition, JourneyTransition, JourneyTransitionArgs, JourneyTransitionTarget, TransitionBranch, TransitionConfig } from "./types/transitions.types";
+export declare const tx: {
+    from: <TStepId extends string, TContext = unknown>(from: TStepId) => {
+        on: <TEventType extends string>(event: TEventType) => EventBuilder<TContext, TStepId, TEventType, Record<never, never>>;
+        toComplete: (config?: TransitionConfig<TContext, TStepId, "completeJourney", Record<never, never>>) => JourneyEventTransition<TContext, TStepId, "completeJourney", Record<never, never>>;
+        toTerminate: (config?: TransitionConfig<TContext, TStepId, "terminateJourney", Record<never, never>>) => JourneyEventTransition<TContext, TStepId, "terminateJourney", Record<never, never>>;
+    };
+    any: <TContext = unknown, TStepId extends string = string>() => {
+        on: <TEventType extends string>(event: TEventType) => EventBuilder<TContext, TStepId, TEventType, Record<never, never>>;
+        toComplete: (config?: TransitionConfig<TContext, TStepId, "completeJourney", Record<never, never>>) => JourneyEventTransition<TContext, TStepId, "completeJourney", Record<never, never>>;
+        toTerminate: (config?: TransitionConfig<TContext, TStepId, "terminateJourney", Record<never, never>>) => JourneyEventTransition<TContext, TStepId, "terminateJourney", Record<never, never>>;
+    };
+    when: <TContext, TStepId extends string, TEventType extends string, TPayloadMap extends JourneyEventPayloadMap<TEventType>>(predicate: (args: JourneyTransitionArgs<TContext, TStepId, TEventType, TPayloadMap>) => boolean | Promise<boolean>) => {
+        to: (to: JourneyTransitionTarget<TStepId>, config?: TransitionConfig<TContext, TStepId, TEventType, TPayloadMap>) => TransitionBranch<TContext, TStepId, TEventType, TPayloadMap>;
+    };
+    otherwise: <TContext, TStepId extends string, TEventType extends string, TPayloadMap extends JourneyEventPayloadMap<TEventType>>() => {
+        to: (to: JourneyTransitionTarget<TStepId>, config?: TransitionConfig<TContext, TStepId, TEventType, TPayloadMap>) => TransitionBranch<TContext, TStepId, TEventType, TPayloadMap>;
+    };
+};
+export declare const createTransitions: <TContext, TStepId extends string, TEventType extends string, TPayloadMap extends JourneyEventPayloadMap<TEventType>>(...items: Array<JourneyTransition<TContext, TStepId, TEventType, TPayloadMap> | readonly JourneyTransition<TContext, TStepId, TEventType, TPayloadMap>[]>) => JourneyTransition<TContext, TStepId, TEventType, TPayloadMap>[];

package/dist/types/index.d.ts

@@ -0,0 +1,4 @@
+export { JOURNEY_ASYNC_PHASE, JOURNEY_EVENT, JOURNEY_STATUS, JOURNEY_WILDCARD } from "./journey.types";
+export type { JourneyAsyncPhase, JourneyAsyncState, JourneyBaseEvent, JourneyBuiltInEvent, JourneyBuiltInFrom, JourneyDefaultEventType, JourneyDefinition, JourneyEvent, JourneyEventPayloadMap, JourneyGoToEvent, JourneyMachine, JourneyMachineOptions, JourneyObservationEvent, JourneyPayloadFor, JourneySendResult, JourneySnapshot, JourneyStatus, JourneyStepAsyncState, JourneyStepDefinition, JourneyTerminal } from "./journey.types";
+export type { JourneyEventTransition, JourneyGoToStepTransition, JourneyTransition, JourneyTransitionArgs, JourneyTransitionTarget } from "./transitions.types";
+export type { JourneyPersistedSnapshot, JourneyPersistedState, JourneyPersistenceOptions, JourneyStorage } from "./persistence.types";

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

@@ -0,0 +1,150 @@
+import type { JourneyPersistenceOptions } from "./persistence.types";
+import type { JourneyTransition } from "./transitions.types";
+export type JourneyTerminal = "COMPLETE" | "TERMINATED";
+export declare const JOURNEY_STATUS: {
+    readonly RUNNING: "running";
+    readonly COMPLETE: "complete";
+    readonly TERMINATED: "terminated";
+};
+export type JourneyStatus = (typeof JOURNEY_STATUS)[keyof typeof JOURNEY_STATUS];
+export declare const JOURNEY_WILDCARD: "*";
+export declare const JOURNEY_EVENT: {
+    readonly GO_TO_STEP_BY_ID: "goToStepById";
+};
+export type JourneyBuiltInEvent = (typeof JOURNEY_EVENT)[keyof typeof JOURNEY_EVENT];
+export type JourneyBuiltInFrom = typeof JOURNEY_WILDCARD;
+export type JourneyDefaultEventType = "goToNextStep" | "goToPreviousStep" | "terminateJourney" | "completeJourney";
+export declare const JOURNEY_ASYNC_PHASE: {
+    readonly IDLE: "idle";
+    readonly EVALUATING_WHEN: "evaluating-when";
+    readonly RUNNING_EFFECT: "running-effect";
+    readonly ERROR: "error";
+};
+export type JourneyAsyncPhase = (typeof JOURNEY_ASYNC_PHASE)[keyof typeof JOURNEY_ASYNC_PHASE];
+export type JourneyStepAsyncState = {
+    phase: JourneyAsyncPhase;
+    eventType: string | null;
+    transitionId: string | null;
+    error: unknown | null;
+};
+export type JourneyAsyncState<TStepId extends string> = {
+    isLoading: boolean;
+    byStep: Record<TStepId, JourneyStepAsyncState>;
+};
+export type JourneyBaseEvent = {
+    type: string;
+    payload?: unknown;
+};
+export type JourneyEventPayloadMap<TEventType extends string> = Partial<Record<TEventType | JourneyBuiltInEvent, unknown>>;
+export type JourneyPayloadFor<TEventType extends string, TPayloadMap extends JourneyEventPayloadMap<TEventType>, TEvent extends TEventType | JourneyBuiltInEvent> = TEvent extends keyof TPayloadMap ? TPayloadMap[TEvent] : unknown;
+type JourneyPayloadForDefaultEvent<TEventType extends string, TPayloadMap extends JourneyEventPayloadMap<TEventType>, TDefaultEvent extends JourneyDefaultEventType> = JourneyPayloadFor<TEventType | TDefaultEvent, TPayloadMap & JourneyEventPayloadMap<TDefaultEvent>, TDefaultEvent>;
+export type JourneyGoToEvent<TStepId extends string, TPayload = unknown> = {
+    type: (typeof JOURNEY_EVENT)["GO_TO_STEP_BY_ID"];
+    stepId: TStepId;
+    payload?: TPayload;
+};
+export type JourneyEvent<TStepId extends string, TEventType extends string, TPayloadMap extends JourneyEventPayloadMap<TEventType> = Record<never, never>> = JourneyGoToEvent<TStepId, JourneyPayloadFor<TEventType, TPayloadMap, (typeof JOURNEY_EVENT)["GO_TO_STEP_BY_ID"]>> | {
+    [TType in TEventType]: {
+        type: TType;
+        payload?: JourneyPayloadFor<TEventType, TPayloadMap, TType>;
+    };
+}[TEventType];
+export type JourneyStepDefinition<TStepMeta = unknown> = {
+    meta?: TStepMeta;
+} & Record<string, unknown>;
+export type JourneySnapshot<TContext, TStepId extends string, TStepMeta = unknown> = {
+    currentStepId: TStepId;
+    history: {
+        timeline: readonly TStepId[];
+        index: number;
+    };
+    context: TContext;
+    visited: Record<TStepId, boolean>;
+    stepMeta: Record<TStepId, TStepMeta>;
+    status: JourneyStatus;
+    async: JourneyAsyncState<TStepId>;
+};
+export type JourneyDefinition<TContext, TStepId extends string = string, TEventType extends string = JourneyDefaultEventType, TPayloadMap extends JourneyEventPayloadMap<TEventType> = Record<never, never>, TStepMeta = unknown> = {
+    initial: TStepId;
+    context: TContext;
+    steps: Record<TStepId, JourneyStepDefinition<TStepMeta>>;
+    transitions: readonly JourneyTransition<TContext, TStepId, TEventType, TPayloadMap>[];
+};
+export type JourneyMachineOptions<TContext, TStepId extends string, TStepMeta = unknown> = {
+    persistence?: JourneyPersistenceOptions<TContext, TStepId, TStepMeta>;
+};
+export type JourneySendResult<TContext, TStepId extends string, TStepMeta = unknown> = {
+    transitioned: boolean;
+    transitionId?: string;
+    snapshot: JourneySnapshot<TContext, TStepId, TStepMeta>;
+};
+export type JourneyObservationEvent<TStepId extends string, TEventType extends string, TPayloadMap extends JourneyEventPayloadMap<TEventType> = Record<never, never>, TStepMeta = unknown> = {
+    type: "transition.start";
+    from: TStepId;
+    event: JourneyEvent<TStepId, TEventType, TPayloadMap>;
+    timestamp: number;
+} | {
+    type: "transition.success";
+    from: TStepId;
+    to: TStepId | JourneyTerminal;
+    eventType: string;
+    transitionId: string | null;
+    timestamp: number;
+} | {
+    type: "transition.error";
+    from: TStepId;
+    eventType: string;
+    transitionId: string | null;
+    error: unknown;
+    timestamp: number;
+} | {
+    type: "step.exit";
+    stepId: TStepId;
+    timestamp: number;
+} | {
+    type: "step.enter";
+    stepId: TStepId;
+    timestamp: number;
+} | {
+    type: "journey.complete";
+    stepId: TStepId;
+    timestamp: number;
+} | {
+    type: "journey.close";
+    stepId: TStepId;
+    timestamp: number;
+} | {
+    type: "navigation.previous";
+    from: TStepId;
+    to: TStepId;
+    requestedSteps: number;
+    appliedSteps: number;
+    timestamp: number;
+} | {
+    type: "navigation.lastVisited";
+    from: TStepId;
+    to: TStepId;
+    timestamp: number;
+} | {
+    type: "metadata.updated";
+    stepId: TStepId;
+    previous: TStepMeta;
+    next: TStepMeta;
+    timestamp: number;
+};
+export type JourneyMachine<TContext, TStepId extends string, TEventType extends string, TPayloadMap extends JourneyEventPayloadMap<TEventType> = Record<never, never>, TStepMeta = unknown> = {
+    getSnapshot: () => JourneySnapshot<TContext, TStepId, TStepMeta>;
+    send: (event: JourneyEvent<TStepId, TEventType, TPayloadMap>) => Promise<JourneySendResult<TContext, TStepId, TStepMeta>>;
+    goToNextStep: () => Promise<JourneySendResult<TContext, TStepId, TStepMeta>>;
+    terminateJourney: (payload?: JourneyPayloadForDefaultEvent<TEventType, TPayloadMap, "terminateJourney">) => Promise<JourneySendResult<TContext, TStepId, TStepMeta>>;
+    completeJourney: (payload?: JourneyPayloadForDefaultEvent<TEventType, TPayloadMap, "completeJourney">) => Promise<JourneySendResult<TContext, TStepId, TStepMeta>>;
+    goToPreviousStep: (steps?: number) => Promise<JourneySendResult<TContext, TStepId, TStepMeta>>;
+    goToLastVisitedStep: () => Promise<JourneySendResult<TContext, TStepId, TStepMeta>>;
+    updateContext: (updater: (context: TContext) => TContext) => JourneySnapshot<TContext, TStepId, TStepMeta>;
+    updateStepMetadata: (stepId: TStepId, updater: (metadata: TStepMeta) => TStepMeta) => JourneySnapshot<TContext, TStepId, TStepMeta>;
+    clearStepError: (stepId?: TStepId) => JourneySnapshot<TContext, TStepId, TStepMeta>;
+    resetMachine: () => JourneySnapshot<TContext, TStepId, TStepMeta>;
+    subscribe: (listener: () => void) => () => void;
+    subscribeEvent: (listener: (event: JourneyObservationEvent<TStepId, TEventType, TPayloadMap, TStepMeta>) => void) => () => void;
+};
+export {};