@rxova/journey-core 0.1.0

package/dist/index.cjs

@@ -0,0 +1,2 @@
+"use strict";var U=Object.defineProperty;var W=Object.getOwnPropertyDescriptor;var q=Object.getOwnPropertyNames;var Q=Object.prototype.hasOwnProperty;var K=(e,o)=>{for(var r in o)U(e,r,{get:o[r],enumerable:!0})},X=(e,o,r,a)=>{if(o&&typeof o=="object"||typeof o=="function")for(let s of q(o))!Q.call(e,s)&&s!==r&&U(e,s,{get:()=>o[s],enumerable:!(a=W(o,s))||a.enumerable});return e};var Z=e=>X(U({},"__esModule",{value:!0}),e);var oe={};K(oe,{HISTORY_TARGET:()=>_,JOURNEY_ASYNC_PHASE:()=>I,JOURNEY_EVENT:()=>N,JOURNEY_STATUS:()=>c,JOURNEY_TERMINAL:()=>P,JOURNEY_WILDCARD:()=>m,createJourneyMachine:()=>B,createPersistenceController:()=>k});module.exports=Z(oe);var P={COMPLETE:"COMPLETE",CLOSE:"CLOSE"},c={RUNNING:"running",COMPLETE:"complete",CLOSED:"closed"},_="__HISTORY__",m="*",N={GO_TO:"goTo"},I={IDLE:"idle",EVALUATING_WHEN:"evaluating-when",RUNNING_EFFECT:"running-effect",ERROR:"error"};var w=(e,o,r)=>{if(!(o in e))throw new Error(r)},j=e=>[...new Set(e)],Y=e=>typeof e=="object"&&e!==null&&"then"in e&&typeof e.then=="function",b=()=>({phase:I.IDLE,eventType:null,transitionId:null,error:null}),O=e=>({isLoading:!1,byStep:Object.fromEntries(Object.keys(e).map(r=>[r,b()]))}),V=e=>e.type===N.GO_TO&&"to"in e,G=e=>e===P.COMPLETE||e===P.CLOSE,A=(e,o,r)=>r?{transitioned:o,transitionId:r,snapshot:e}:{transitioned:o,snapshot:e},R=(e,o,r,a,s)=>({status:a,current:e,context:o,history:r,visited:j([...r,e]),async:s}),H=(e,o)=>{let r=[...e.history];for(;r.length>0;){let a=r.pop();if(!a)break;if(a in o)return{target:a,history:r}}return{target:e.current,history:[...e.history]}},F=async(e,o,r,a)=>{for(let s of e){let p=s.from===m||s.from===o.current,t=s.event===r.type;if(!p||!t)continue;if(!s.when)return s;let l=s.when({context:o.context,from:o.current,history:o.history,event:r}),f=Y(l);f&&a?.onAsyncGuardStart?.(s);let x;try{x=await l}catch(y){throw f&&a?.onAsyncGuardError?.(s,y),y}if(f&&a?.onAsyncGuardSuccess?.(s),x)return s}return null},L=(e,o,r)=>{let a=o===e.current?[...e.history]:[...e.history,e.current];return R(o,r,a,e.status,e.async)};var $=e=>typeof e=="object"&&e!==null,ee=e=>e===c.RUNNING||e===c.COMPLETE||e===c.CLOSED,te=()=>{let e=globalThis.localStorage;return!e||typeof e.getItem!="function"||typeof e.setItem!="function"||typeof e.removeItem!="function"?null:e},ne=e=>{if(!e)return null;let o=e.storage??te();return o?{key:e.key,storage:o,version:e.version??1,clearOnReset:e.clearOnReset??!0,serialize:e.serialize??JSON.stringify,deserialize:e.deserialize??JSON.parse,...e.migrate?{migrate:e.migrate}:{},...e.onError?{onError:e.onError}:{}}:null},z=(e,o,r)=>{if(!$(e))return null;let a=e.current;if(typeof a!="string"||!(a in o))return null;let s=a,p=Array.isArray(e.history)?e.history.filter(l=>typeof l=="string"&&l in o):[],t=ee(e.status)?e.status:c.RUNNING;return{current:s,context:"context"in e?e.context:r,history:p,status:t}},k=e=>{let{initial:o,context:r,steps:a,options:s}=e,p=ne(s?.persistence),t=y=>{p?.onError?.(y)},l=y=>{if(p)try{let E={version:p.version,snapshot:{current:y.current,context:y.context,history:[...y.history],status:y.status}};p.storage.setItem(p.key,p.serialize(E))}catch(E){t(E)}},f=()=>{if(p)try{p.storage.removeItem(p.key)}catch(y){t(y)}},x=()=>{let y=R(o,r,[],c.RUNNING,O(a));if(!p)return y;try{let E=p.storage.getItem(p.key);if(!E)return y;let v=p.deserialize(E);if(!$(v))return y;let g=v.version;if(typeof g!="number")return y;let J=null,n=!1;if(g===p.version)J=z(v.snapshot,a,r);else if(p.migrate){let u=p.migrate(v.snapshot,g);J=z(u,a,r),n=J!==null}if(!J)return y;let i=R(J.current,J.context,J.history,J.status,O(a));return n&&l(i),i}catch(E){return t(E),y}};return{clearOnReset:p?.clearOnReset??!0,hydrateSnapshot:x,persistSnapshot:l,removePersistedSnapshot:f}};var B=(e,o)=>{if(!e.steps||typeof e.steps!="object")throw new Error("Journey steps must be a record object.");if(!Array.isArray(e.transitions))throw new Error("Journey transitions must be an array.");w(e.steps,e.initial,`Journey initial step "${e.initial}" does not exist in steps registry.`);for(let[n,i]of e.transitions.entries()){if(!i||typeof i!="object")throw new Error(`Journey transition at index ${n} must be an object.`);if(typeof i.from!="string"||typeof i.event!="string")throw new Error(`Journey transition at index ${n} must define string "from" and "event".`);if(i.from!==m&&!(i.from in e.steps))throw new Error(`Journey transition at index ${n} references unknown from step "${i.from}".`);if(i.to!==_&&!G(i.to)&&!(i.to in e.steps))throw new Error(`Journey transition at index ${n} points to unknown step "${i.to}".`)}let{clearOnReset:r,hydrateSnapshot:a,persistSnapshot:s,removePersistedSnapshot:p}=k({initial:e.initial,context:e.context,steps:e.steps,...o?{options:o}:{}}),t=a(),l=new Set,f=Promise.resolve();t={...t,async:O(e.steps)};let x=()=>{for(let n of l)n()},y=n=>n===I.EVALUATING_WHEN||n===I.RUNNING_EFFECT,E=(n,i)=>{let u=t.async.byStep[n]??b(),T=i(u);if(u.phase===T.phase&&u.eventType===T.eventType&&u.transitionId===T.transitionId&&u.error===T.error)return;let d={...t.async.byStep,[n]:T},C=Object.values(d).some(M=>y(M.phase));t={...t,async:{isLoading:C,byStep:d}},x()},v=(n,i,u,T)=>{E(n,()=>({phase:i,eventType:u,transitionId:T??null,error:null}))},g=n=>{E(n,()=>b())},J=(n,i,u,T)=>{E(n,()=>({phase:I.ERROR,eventType:i,transitionId:T??null,error:u}))};return{getSnapshot:()=>t,subscribe:n=>(l.add(n),()=>{l.delete(n)}),reset:()=>(t=R(e.initial,e.context,[],c.RUNNING,O(e.steps)),r?p():s(t),x(),t),updateContext:n=>(t={...t,context:n(t.context)},s(t),x(),t),clearStepError:n=>{let i=n??t.current;return i in e.steps&&g(i),t},send:n=>{let i=async()=>{if(t.status!==c.RUNNING)return{transitioned:!1,snapshot:t};let T=t.current;if(V(n))return w(e.steps,n.to,`Cannot goTo unknown step "${n.to}".`),g(T),t=L(t,n.to,t.context),s(t),x(),A(t,!0,N.GO_TO);let d;try{d=await F(e.transitions,t,n,{onAsyncGuardStart:S=>{v(T,I.EVALUATING_WHEN,n.type,S.id)},onAsyncGuardSuccess:()=>{g(T)},onAsyncGuardError:(S,h)=>{J(T,n.type,h,S.id)}})}catch(S){throw J(T,n.type,S),S}if(!d)return A(t,!1);let C=t.context;if(d.effect){let S=d.effect({context:t.context,from:t.current,history:t.history,event:n});Y(S)&&v(T,I.RUNNING_EFFECT,n.type,d.id);let h;try{h=await S}catch(D){throw J(T,n.type,D,d.id),D}h!==void 0&&(C=h)}if(g(T),G(d.to))return t={...t,context:C,status:d.to===P.COMPLETE?c.COMPLETE:c.CLOSED},s(t),x(),A(t,!0,d.id);if(d.to===_){let{target:S,history:h}=H(t,e.steps);return w(e.steps,S,`Transition points to unknown step "${S}".`),t=R(S,C,h,t.status,t.async),s(t),x(),A(t,!0,d.id)}let M=d.to;return w(e.steps,M,`Transition points to unknown step "${M}".`),t=L(t,M,C),s(t),x(),A(t,!0,d.id)},u=f.then(i,i);return f=u.then(()=>{},()=>{}),u}}};0&&(module.exports={HISTORY_TARGET,JOURNEY_ASYNC_PHASE,JOURNEY_EVENT,JOURNEY_STATUS,JOURNEY_TERMINAL,JOURNEY_WILDCARD,createJourneyMachine,createPersistenceController});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/index.ts", "../src/types.ts", "../src/machine-helpers.ts", "../src/persistence.ts", "../src/machine.ts"],
+  "sourcesContent": ["export { createJourneyMachine } from \"./machine\";\nexport { createPersistenceController } from \"./persistence\";\nexport {\n  JOURNEY_EVENT,\n  JOURNEY_ASYNC_PHASE,\n  JOURNEY_STATUS,\n  JOURNEY_WILDCARD,\n  HISTORY_TARGET,\n  JOURNEY_TERMINAL,\n  type JourneyBuiltInEvent,\n  type JourneyBuiltInFrom,\n  type JourneyAsyncPhase,\n  type JourneyStatus,\n  type JourneyAsyncState,\n  type JourneyStepAsyncState,\n  type JourneyEvent,\n  type JourneyEventPayloadMap,\n  type JourneyDefinition,\n  type JourneyMachineOptions,\n  type JourneyGoToEvent,\n  type JourneyMachine,\n  type JourneyPayloadFor,\n  type JourneyPersistedSnapshot,\n  type JourneyPersistedState,\n  type JourneyPersistenceOptions,\n  type JourneyStorage,\n  type JourneySendResult,\n  type JourneySnapshot,\n  type JourneyTerminal,\n  type JourneyTransition,\n  type JourneyTransitionArgs,\n  type JourneyTransitionTarget\n} from \"./types\";\n", "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};\n\nexport type JourneyPersistedState<TContext, TStepId extends string> = {\n  version: number;\n  snapshot: JourneyPersistedSnapshot<TContext, TStepId>;\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};\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  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 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): JourneySnapshot<TContext, TStepId> => ({\n  status,\n  current,\n  context,\n  history,\n  visited: unique([...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  return buildSnapshot(nextCurrent, nextContext, history, snapshot.status, snapshot.async);\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 } 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): JourneyPersistedSnapshot<TContext, TStepId> | 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  return {\n    current,\n    context: (\"context\" in value ? value.context : fallbackContext) as TContext,\n    history,\n    status\n  };\n};\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        }\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        persistedSnapshot = coercePersistedSnapshot(parsed.snapshot, steps, context);\n      } else if (persistence.migrate) {\n        const migrated = persistence.migrate(parsed.snapshot, persistedVersion);\n        persistedSnapshot = coercePersistedSnapshot(migrated, steps, context);\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      );\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  JourneyMachine,\n  JourneyMachineOptions,\n  JourneySendResult\n} from \"./types\";\nimport {\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\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  let snapshot = hydrateSnapshot();\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    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          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          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          snapshot = buildSnapshot(target, nextContext, history, snapshot.status, snapshot.async);\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\n        snapshot = nextSnapshot;\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": ["index_exports", "__export", "HISTORY_TARGET", "JOURNEY_ASYNC_PHASE", "JOURNEY_EVENT", "JOURNEY_STATUS", "JOURNEY_TERMINAL", "JOURNEY_WILDCARD", "createJourneyMachine", "createPersistenceController", "__toCommonJS", "JOURNEY_TERMINAL", "JOURNEY_STATUS", "HISTORY_TARGET", "JOURNEY_WILDCARD", "JOURNEY_EVENT", "JOURNEY_ASYNC_PHASE", "assertStepExists", "steps", "stepId", "message", "unique", "items", "isPromiseLike", "value", "buildIdleStepAsyncState", "JOURNEY_ASYNC_PHASE", "buildInitialAsyncState", "isGoToEvent", "event", "JOURNEY_EVENT", "isTerminalTarget", "target", "JOURNEY_TERMINAL", "buildSendResult", "snapshot", "transitioned", "transitionId", "buildSnapshot", "current", "context", "history", "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", "createPersistenceController", "args", "initial", "context", "persistence", "reportPersistenceError", "error", "persistSnapshot", "snapshot", "persistedState", "removePersistedSnapshot", "hydrateSnapshot", "initialSnapshot", "buildSnapshot", "buildInitialAsyncState", "rawPersisted", "parsed", "persistedVersion", "persistedSnapshot", "shouldRewritePersisted", "migrated", "hydratedSnapshot", "createJourneyMachine", "journey", "options", "assertStepExists", "index", "transition", "JOURNEY_WILDCARD", "HISTORY_TARGET", "isTerminalTarget", "clearOnReset", "hydrateSnapshot", "persistSnapshot", "removePersistedSnapshot", "createPersistenceController", "snapshot", "listeners", "sendQueue", "buildInitialAsyncState", "notify", "listener", "isAsyncLoadingPhase", "phase", "JOURNEY_ASYNC_PHASE", "updateStepAsync", "stepId", "updater", "current", "buildIdleStepAsyncState", "next", "nextByStep", "isLoading", "state", "setStepLoading", "eventType", "transitionId", "setStepIdle", "setStepError", "error", "buildSnapshot", "JOURNEY_STATUS", "resolvedStep", "event", "run", "fromStep", "isGoToEvent", "transitionSnapshot", "buildSendResult", "JOURNEY_EVENT", "selectTransition", "currentTransition", "nextContext", "effectResultPromise", "isPromiseLike", "effectResult", "JOURNEY_TERMINAL", "target", "history", "resolveHistoryTarget", "resolvedTarget", "resultPromise"]
+}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { createJourneyMachine } from "./machine";
+export { createPersistenceController } from "./persistence";
+export { JOURNEY_EVENT, JOURNEY_ASYNC_PHASE, JOURNEY_STATUS, JOURNEY_WILDCARD, HISTORY_TARGET, JOURNEY_TERMINAL, type JourneyBuiltInEvent, type JourneyBuiltInFrom, type JourneyAsyncPhase, type JourneyStatus, type JourneyAsyncState, type JourneyStepAsyncState, type JourneyEvent, type JourneyEventPayloadMap, type JourneyDefinition, type JourneyMachineOptions, type JourneyGoToEvent, type JourneyMachine, type JourneyPayloadFor, type JourneyPersistedSnapshot, type JourneyPersistedState, type JourneyPersistenceOptions, type JourneyStorage, type JourneySendResult, type JourneySnapshot, type JourneyTerminal, type JourneyTransition, type JourneyTransitionArgs, type JourneyTransitionTarget } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,2BAA2B,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,YAAY,EACjB,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC7B,KAAK,qBAAqB,EAC1B,KAAK,yBAAyB,EAC9B,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC7B,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+var C={COMPLETE:"COMPLETE",CLOSE:"CLOSE"},J={RUNNING:"running",COMPLETE:"complete",CLOSED:"closed"},w="__HISTORY__",A="*",M={GO_TO:"goTo"},I={IDLE:"idle",EVALUATING_WHEN:"evaluating-when",RUNNING_EFFECT:"running-effect",ERROR:"error"};var _=(e,o,r)=>{if(!(o in e))throw new Error(r)},$=e=>[...new Set(e)],k=e=>typeof e=="object"&&e!==null&&"then"in e&&typeof e.then=="function",b=()=>({phase:I.IDLE,eventType:null,transitionId:null,error:null}),m=e=>({isLoading:!1,byStep:Object.fromEntries(Object.keys(e).map(r=>[r,b()]))}),D=e=>e.type===M.GO_TO&&"to"in e,U=e=>e===C.COMPLETE||e===C.CLOSE,N=(e,o,r)=>r?{transitioned:o,transitionId:r,snapshot:e}:{transitioned:o,snapshot:e},P=(e,o,r,p,i)=>({status:p,current:e,context:o,history:r,visited:$([...r,e]),async:i}),V=(e,o)=>{let r=[...e.history];for(;r.length>0;){let p=r.pop();if(!p)break;if(p in o)return{target:p,history:r}}return{target:e.current,history:[...e.history]}},H=async(e,o,r,p)=>{for(let i of e){let a=i.from===A||i.from===o.current,t=i.event===r.type;if(!a||!t)continue;if(!i.when)return i;let c=i.when({context:o.context,from:o.current,history:o.history,event:r}),f=k(c);f&&p?.onAsyncGuardStart?.(i);let l;try{l=await c}catch(y){throw f&&p?.onAsyncGuardError?.(i,y),y}if(f&&p?.onAsyncGuardSuccess?.(i),l)return i}return null},Y=(e,o,r)=>{let p=o===e.current?[...e.history]:[...e.history,e.current];return P(o,r,p,e.status,e.async)};var z=e=>typeof e=="object"&&e!==null,B=e=>e===J.RUNNING||e===J.COMPLETE||e===J.CLOSED,W=()=>{let e=globalThis.localStorage;return!e||typeof e.getItem!="function"||typeof e.setItem!="function"||typeof e.removeItem!="function"?null:e},q=e=>{if(!e)return null;let o=e.storage??W();return o?{key:e.key,storage:o,version:e.version??1,clearOnReset:e.clearOnReset??!0,serialize:e.serialize??JSON.stringify,deserialize:e.deserialize??JSON.parse,...e.migrate?{migrate:e.migrate}:{},...e.onError?{onError:e.onError}:{}}:null},F=(e,o,r)=>{if(!z(e))return null;let p=e.current;if(typeof p!="string"||!(p in o))return null;let i=p,a=Array.isArray(e.history)?e.history.filter(c=>typeof c=="string"&&c in o):[],t=B(e.status)?e.status:J.RUNNING;return{current:i,context:"context"in e?e.context:r,history:a,status:t}},G=e=>{let{initial:o,context:r,steps:p,options:i}=e,a=q(i?.persistence),t=y=>{a?.onError?.(y)},c=y=>{if(a)try{let x={version:a.version,snapshot:{current:y.current,context:y.context,history:[...y.history],status:y.status}};a.storage.setItem(a.key,a.serialize(x))}catch(x){t(x)}},f=()=>{if(a)try{a.storage.removeItem(a.key)}catch(y){t(y)}},l=()=>{let y=P(o,r,[],J.RUNNING,m(p));if(!a)return y;try{let x=a.storage.getItem(a.key);if(!x)return y;let v=a.deserialize(x);if(!z(v))return y;let g=v.version;if(typeof g!="number")return y;let E=null,n=!1;if(g===a.version)E=F(v.snapshot,p,r);else if(a.migrate){let u=a.migrate(v.snapshot,g);E=F(u,p,r),n=E!==null}if(!E)return y;let s=P(E.current,E.context,E.history,E.status,m(p));return n&&c(s),s}catch(x){return t(x),y}};return{clearOnReset:a?.clearOnReset??!0,hydrateSnapshot:l,persistSnapshot:c,removePersistedSnapshot:f}};var Q=(e,o)=>{if(!e.steps||typeof e.steps!="object")throw new Error("Journey steps must be a record object.");if(!Array.isArray(e.transitions))throw new Error("Journey transitions must be an array.");_(e.steps,e.initial,`Journey initial step "${e.initial}" does not exist in steps registry.`);for(let[n,s]of e.transitions.entries()){if(!s||typeof s!="object")throw new Error(`Journey transition at index ${n} must be an object.`);if(typeof s.from!="string"||typeof s.event!="string")throw new Error(`Journey transition at index ${n} must define string "from" and "event".`);if(s.from!==A&&!(s.from in e.steps))throw new Error(`Journey transition at index ${n} references unknown from step "${s.from}".`);if(s.to!==w&&!U(s.to)&&!(s.to in e.steps))throw new Error(`Journey transition at index ${n} points to unknown step "${s.to}".`)}let{clearOnReset:r,hydrateSnapshot:p,persistSnapshot:i,removePersistedSnapshot:a}=G({initial:e.initial,context:e.context,steps:e.steps,...o?{options:o}:{}}),t=p(),c=new Set,f=Promise.resolve();t={...t,async:m(e.steps)};let l=()=>{for(let n of c)n()},y=n=>n===I.EVALUATING_WHEN||n===I.RUNNING_EFFECT,x=(n,s)=>{let u=t.async.byStep[n]??b(),T=s(u);if(u.phase===T.phase&&u.eventType===T.eventType&&u.transitionId===T.transitionId&&u.error===T.error)return;let d={...t.async.byStep,[n]:T},R=Object.values(d).some(O=>y(O.phase));t={...t,async:{isLoading:R,byStep:d}},l()},v=(n,s,u,T)=>{x(n,()=>({phase:s,eventType:u,transitionId:T??null,error:null}))},g=n=>{x(n,()=>b())},E=(n,s,u,T)=>{x(n,()=>({phase:I.ERROR,eventType:s,transitionId:T??null,error:u}))};return{getSnapshot:()=>t,subscribe:n=>(c.add(n),()=>{c.delete(n)}),reset:()=>(t=P(e.initial,e.context,[],J.RUNNING,m(e.steps)),r?a():i(t),l(),t),updateContext:n=>(t={...t,context:n(t.context)},i(t),l(),t),clearStepError:n=>{let s=n??t.current;return s in e.steps&&g(s),t},send:n=>{let s=async()=>{if(t.status!==J.RUNNING)return{transitioned:!1,snapshot:t};let T=t.current;if(D(n))return _(e.steps,n.to,`Cannot goTo unknown step "${n.to}".`),g(T),t=Y(t,n.to,t.context),i(t),l(),N(t,!0,M.GO_TO);let d;try{d=await H(e.transitions,t,n,{onAsyncGuardStart:S=>{v(T,I.EVALUATING_WHEN,n.type,S.id)},onAsyncGuardSuccess:()=>{g(T)},onAsyncGuardError:(S,h)=>{E(T,n.type,h,S.id)}})}catch(S){throw E(T,n.type,S),S}if(!d)return N(t,!1);let R=t.context;if(d.effect){let S=d.effect({context:t.context,from:t.current,history:t.history,event:n});k(S)&&v(T,I.RUNNING_EFFECT,n.type,d.id);let h;try{h=await S}catch(L){throw E(T,n.type,L,d.id),L}h!==void 0&&(R=h)}if(g(T),U(d.to))return t={...t,context:R,status:d.to===C.COMPLETE?J.COMPLETE:J.CLOSED},i(t),l(),N(t,!0,d.id);if(d.to===w){let{target:S,history:h}=V(t,e.steps);return _(e.steps,S,`Transition points to unknown step "${S}".`),t=P(S,R,h,t.status,t.async),i(t),l(),N(t,!0,d.id)}let O=d.to;return _(e.steps,O,`Transition points to unknown step "${O}".`),t=Y(t,O,R),i(t),l(),N(t,!0,d.id)},u=f.then(s,s);return f=u.then(()=>{},()=>{}),u}}};export{w as HISTORY_TARGET,I as JOURNEY_ASYNC_PHASE,M as JOURNEY_EVENT,J as JOURNEY_STATUS,C as JOURNEY_TERMINAL,A as JOURNEY_WILDCARD,Q as createJourneyMachine,G as createPersistenceController};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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};\n\nexport type JourneyPersistedState<TContext, TStepId extends string> = {\n  version: number;\n  snapshot: JourneyPersistedSnapshot<TContext, TStepId>;\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};\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  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 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): JourneySnapshot<TContext, TStepId> => ({\n  status,\n  current,\n  context,\n  history,\n  visited: unique([...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  return buildSnapshot(nextCurrent, nextContext, history, snapshot.status, snapshot.async);\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 } 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): JourneyPersistedSnapshot<TContext, TStepId> | 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  return {\n    current,\n    context: (\"context\" in value ? value.context : fallbackContext) as TContext,\n    history,\n    status\n  };\n};\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        }\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        persistedSnapshot = coercePersistedSnapshot(parsed.snapshot, steps, context);\n      } else if (persistence.migrate) {\n        const migrated = persistence.migrate(parsed.snapshot, persistedVersion);\n        persistedSnapshot = coercePersistedSnapshot(migrated, steps, context);\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      );\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  JourneyMachine,\n  JourneyMachineOptions,\n  JourneySendResult\n} from \"./types\";\nimport {\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\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  let snapshot = hydrateSnapshot();\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    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          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          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          snapshot = buildSnapshot(target, nextContext, history, snapshot.status, snapshot.async);\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\n        snapshot = nextSnapshot;\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", "isPromiseLike", "value", "buildIdleStepAsyncState", "JOURNEY_ASYNC_PHASE", "buildInitialAsyncState", "isGoToEvent", "event", "JOURNEY_EVENT", "isTerminalTarget", "target", "JOURNEY_TERMINAL", "buildSendResult", "snapshot", "transitioned", "transitionId", "buildSnapshot", "current", "context", "history", "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", "createPersistenceController", "args", "initial", "context", "persistence", "reportPersistenceError", "error", "persistSnapshot", "snapshot", "persistedState", "removePersistedSnapshot", "hydrateSnapshot", "initialSnapshot", "buildSnapshot", "buildInitialAsyncState", "rawPersisted", "parsed", "persistedVersion", "persistedSnapshot", "shouldRewritePersisted", "migrated", "hydratedSnapshot", "createJourneyMachine", "journey", "options", "assertStepExists", "index", "transition", "JOURNEY_WILDCARD", "HISTORY_TARGET", "isTerminalTarget", "clearOnReset", "hydrateSnapshot", "persistSnapshot", "removePersistedSnapshot", "createPersistenceController", "snapshot", "listeners", "sendQueue", "buildInitialAsyncState", "notify", "listener", "isAsyncLoadingPhase", "phase", "JOURNEY_ASYNC_PHASE", "updateStepAsync", "stepId", "updater", "current", "buildIdleStepAsyncState", "next", "nextByStep", "isLoading", "state", "setStepLoading", "eventType", "transitionId", "setStepIdle", "setStepError", "error", "buildSnapshot", "JOURNEY_STATUS", "resolvedStep", "event", "run", "fromStep", "isGoToEvent", "transitionSnapshot", "buildSendResult", "JOURNEY_EVENT", "selectTransition", "currentTransition", "nextContext", "effectResultPromise", "isPromiseLike", "effectResult", "JOURNEY_TERMINAL", "target", "history", "resolveHistoryTarget", "resolvedTarget", "resultPromise"]
+}

package/dist/machine-helpers.d.ts

@@ -0,0 +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 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>) => 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?: {
+    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

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

@@ -0,0 +1 @@
+{"version":3,"file":"machine-helpers.d.ts","sourceRoot":"","sources":["../src/machine-helpers.ts"],"names":[],"mappings":"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"}

package/dist/machine.d.ts

@@ -0,0 +1,3 @@
+import type { JourneyEventPayloadMap, JourneyDefinition, JourneyMachine, JourneyMachineOptions } from "./types";
+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

package/dist/machine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"machine.d.ts","sourceRoot":"","sources":["../src/machine.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAGV,sBAAsB,EACtB,iBAAiB,EACjB,cAAc,EACd,qBAAqB,EAEtB,MAAM,SAAS,CAAC;AAgBjB,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,EACR,OAAO,SAAS,MAAM,EACtB,UAAU,SAAS,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,EAChE,WAAW,SAAS,sBAAsB,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,EAE7E,SAAS,iBAAiB,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,CAAC,EACtE,UAAU,qBAAqB,CAAC,QAAQ,EAAE,OAAO,CAAC,KACjD,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,CA4S3D,CAAC"}

package/dist/persistence.d.ts

@@ -0,0 +1,13 @@
+import type { JourneyMachineOptions, JourneySnapshot } from "./types";
+export declare const createPersistenceController: <TContext, TStepId extends string>(args: {
+    initial: TStepId;
+    context: TContext;
+    steps: Record<TStepId, unknown>;
+    options?: JourneyMachineOptions<TContext, TStepId>;
+}) => {
+    clearOnReset: boolean;
+    hydrateSnapshot: () => JourneySnapshot<TContext, TStepId>;
+    persistSnapshot: (snapshot: JourneySnapshot<TContext, TStepId>) => void;
+    removePersistedSnapshot: () => void;
+};
+//# sourceMappingURL=persistence.d.ts.map

package/dist/persistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.d.ts","sourceRoot":"","sources":["../src/persistence.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,qBAAqB,EAIrB,eAAe,EAEhB,MAAM,SAAS,CAAC;AAgGjB,eAAO,MAAM,2BAA2B,GAAI,QAAQ,EAAE,OAAO,SAAS,MAAM,EAAE,MAAM;IAClF,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,QAAQ,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAChC,OAAO,CAAC,EAAE,qBAAqB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;CACpD;;2BAyC6B,eAAe,CAAC,QAAQ,EAAE,OAAO,CAAC;gCAjC3B,eAAe,CAAC,QAAQ,EAAE,OAAO,CAAC;;CAqGtE,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,123 @@
+export declare const JOURNEY_TERMINAL: {
+    readonly COMPLETE: "COMPLETE";
+    readonly CLOSE: "CLOSE";
+};
+export type JourneyTerminal = (typeof JOURNEY_TERMINAL)[keyof typeof JOURNEY_TERMINAL];
+export declare const JOURNEY_STATUS: {
+    readonly RUNNING: "running";
+    readonly COMPLETE: "complete";
+    readonly CLOSED: "closed";
+};
+export type JourneyStatus = (typeof JOURNEY_STATUS)[keyof typeof JOURNEY_STATUS];
+export declare const HISTORY_TARGET: "__HISTORY__";
+export declare const JOURNEY_WILDCARD: "*";
+export declare const JOURNEY_EVENT: {
+    readonly GO_TO: "goTo";
+};
+export type JourneyBuiltInEvent = (typeof JOURNEY_EVENT)[keyof typeof JOURNEY_EVENT];
+export type JourneyBuiltInFrom = typeof JOURNEY_WILDCARD;
+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;
+export type JourneyGoToEvent<TStepId extends string, TPayload = unknown> = {
+    type: (typeof JOURNEY_EVENT)["GO_TO"];
+    to: 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"]>> | {
+    [TType in TEventType]: {
+        type: TType;
+        payload?: JourneyPayloadFor<TEventType, TPayloadMap, TType>;
+    };
+}[TEventType];
+export type JourneyTransitionArgs<TContext, TStepId extends string, TEventType extends string, TPayloadMap extends JourneyEventPayloadMap<TEventType> = Record<never, never>> = {
+    context: TContext;
+    from: TStepId;
+    history: readonly TStepId[];
+    event: JourneyEvent<TStepId, TEventType, TPayloadMap>;
+};
+export type JourneyTransitionTarget<TStepId extends string> = TStepId | JourneyTerminal | typeof HISTORY_TARGET;
+export type JourneyTransition<TContext, TStepId extends string, TEventType extends string, TPayloadMap extends JourneyEventPayloadMap<TEventType> = Record<never, never>> = {
+    id?: string;
+    from: TStepId | JourneyBuiltInFrom;
+    event: TEventType | (typeof JOURNEY_EVENT)["GO_TO"];
+    to: JourneyTransitionTarget<TStepId>;
+    when?: (args: JourneyTransitionArgs<TContext, TStepId, TEventType, TPayloadMap>) => boolean | Promise<boolean>;
+    effect?: (args: JourneyTransitionArgs<TContext, TStepId, TEventType, TPayloadMap>) => TContext | void | Promise<TContext | void>;
+};
+export type JourneySnapshot<TContext, TStepId extends string> = {
+    current: TStepId;
+    context: TContext;
+    history: readonly TStepId[];
+    visited: readonly TStepId[];
+    status: JourneyStatus;
+    async: JourneyAsyncState<TStepId>;
+};
+export type JourneyPersistedSnapshot<TContext, TStepId extends string> = {
+    current: TStepId;
+    context: TContext;
+    history: readonly TStepId[];
+    status: JourneyStatus;
+};
+export type JourneyPersistedState<TContext, TStepId extends string> = {
+    version: number;
+    snapshot: JourneyPersistedSnapshot<TContext, TStepId>;
+};
+export type JourneyStorage = {
+    getItem: (key: string) => string | null;
+    setItem: (key: string, value: string) => void;
+    removeItem: (key: string) => void;
+};
+export type JourneyPersistenceOptions<TContext, TStepId extends string> = {
+    key: string;
+    storage?: JourneyStorage;
+    version?: number;
+    clearOnReset?: boolean;
+    serialize?: (value: JourneyPersistedState<TContext, TStepId>) => string;
+    deserialize?: (value: string) => unknown;
+    migrate?: (value: unknown, persistedVersion: number) => JourneyPersistedSnapshot<TContext, TStepId>;
+    onError?: (error: unknown) => void;
+};
+export type JourneyDefinition<TContext, TStepId extends string, TEventType extends string, TPayloadMap extends JourneyEventPayloadMap<TEventType> = Record<never, never>> = {
+    initial: TStepId;
+    context: TContext;
+    steps: Record<TStepId, unknown>;
+    transitions: readonly JourneyTransition<TContext, TStepId, TEventType, TPayloadMap>[];
+};
+export type JourneyMachineOptions<TContext, TStepId extends string> = {
+    persistence?: JourneyPersistenceOptions<TContext, TStepId>;
+};
+export type JourneySendResult<TContext, TStepId extends string> = {
+    transitioned: boolean;
+    transitionId?: string;
+    snapshot: JourneySnapshot<TContext, TStepId>;
+};
+export type JourneyMachine<TContext, TStepId extends string, TEventType extends string, TPayloadMap extends JourneyEventPayloadMap<TEventType> = Record<never, never>> = {
+    getSnapshot: () => JourneySnapshot<TContext, TStepId>;
+    send: (event: JourneyEvent<TStepId, TEventType, TPayloadMap>) => Promise<JourneySendResult<TContext, TStepId>>;
+    updateContext: (updater: (context: TContext) => TContext) => JourneySnapshot<TContext, TStepId>;
+    clearStepError: (stepId?: TStepId) => JourneySnapshot<TContext, TStepId>;
+    reset: () => JourneySnapshot<TContext, TStepId>;
+    subscribe: (listener: () => void) => () => void;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@rxova/journey-core",
+  "version": "0.1.0",
+  "description": "Journey core state machine.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "pnpm run clean && node ./scripts/build.mjs && tsc -p tsconfig.build.json",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "size": "pnpm run size:check",
+    "size:check": "pnpm run build && size-limit"
+  },
+  "size-limit": [
+    {
+      "name": "core/createJourneyMachine",
+      "path": "dist/index.js",
+      "import": "{ createJourneyMachine }",
+      "limit": "2.2 kB"
+    }
+  ]
+}