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

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

@@ -1,27 +0,0 @@
-import type { JourneyJsonObject, JourneyMachine, JourneyReplayExportOptions, JourneyReplayPluginOptions, JourneyReplaySession, JourneySnapshot } from "../../types";
-/** Serializes a replay session into a JSON string safe for logging or export. */
-export declare const serializeReplaySession: <TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>>(session: JourneyReplaySession<TContext, TStepId, TEventMap>, options?: JourneyReplayExportOptions) => string;
-export type JourneyReplayMachineExtension<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>> = {
-    getReplaySession: () => JourneyReplaySession<TContext, TStepId, TEventMap>;
-    clearReplaySession: () => void;
-    exportReplaySession: (options?: JourneyReplayExportOptions) => string;
-};
-export type JourneyReplayMachine<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>, TStepMeta = unknown, THandlers extends Record<string, unknown> = Record<never, never>> = JourneyMachine<TContext, TStepId, TEventMap, TStepMeta, THandlers> & JourneyReplayMachineExtension<TContext, TStepId, TEventMap>;
-/** Creates a plugin that records snapshot and lifecycle activity into a replay session. */
-export declare const createReplayPlugin: (options?: JourneyReplayPluginOptions) => {
-    name: string;
-    setup: <TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>, TStepMeta = unknown, THandlers extends Record<string, unknown> = Record<never, never>>() => {
-        hydrateSnapshot: (snapshot: JourneySnapshot<TContext, TStepId>) => JourneySnapshot<TContext, TStepId>;
-        onSnapshotChange: ({ snapshot, reason }: import("../../types").JourneyMachinePluginSnapshotChange<TContext, TStepId>) => void;
-        augmentMachine: ({ machine }: {
-            machine: JourneyMachine<TContext, TStepId, TEventMap, TStepMeta, THandlers>;
-            journey: import("../..").JourneyDefinition<TContext, TStepId, TEventMap, TStepMeta, THandlers>;
-            resolvedJourney: import("../../types").JourneyResolvedDefinition<TContext, TStepId, TEventMap, TStepMeta, THandlers>;
-        }) => {
-            getReplaySession: () => JourneyReplaySession<JourneyJsonObject, string, Record<string, unknown>>;
-            clearReplaySession: () => void;
-            exportReplaySession: (exportOptions?: JourneyReplayExportOptions) => string;
-        };
-        dispose: () => void;
-    };
-};

package/dist/plugins/replay/index.js

@@ -1,2 +0,0 @@
-var J=n=>typeof n!="number"||!Number.isFinite(n)?500:Math.max(1,Math.trunc(n)),a=(n,e=new WeakSet)=>{if(n===null||typeof n=="string"||typeof n=="number"||typeof n=="boolean")return n;if(typeof n=="bigint")return n.toString();if(typeof n>"u")return null;if(typeof n=="function"||typeof n=="symbol")return`[unsupported:${typeof n}]`;if(n instanceof Error)return{name:n.name,message:n.message,...n.stack?{stack:n.stack}:{}};if(n instanceof Date)return n.toISOString();if(Array.isArray(n))return n.map(r=>a(r,e));if(typeof n=="object"){if(e.has(n))return"[circular]";e.add(n);let r={};for(let[p,s]of Object.entries(n))r[p]=a(s,e);return e.delete(n),r}return String(n)},g=(n,e)=>JSON.stringify(a(n),null,e?.pretty?2:void 0),S=(n={})=>{let e=n.captureEvents??!0,r=n.captureSnapshots??!0,p=J(n.maxEntries),s=null,i=[],y=!1,u,c=t=>{i.length>=p&&(i.shift(),y=!0),i.push(t)},d=()=>({version:1,initialSnapshot:s,entries:[...i],truncated:y});return{name:"replay",setup:()=>({hydrateSnapshot:t=>(s=t,t),onSnapshotChange:({snapshot:t,reason:o})=>{r&&c({kind:"snapshot",timestamp:Date.now(),reason:o,snapshot:t})},augmentMachine:({machine:t})=>(e&&(u=t.subscribeEvent(o=>{c({kind:"event",timestamp:o.timestamp,event:o})})),{getReplaySession:()=>d(),clearReplaySession:()=>{s=t.getSnapshot(),i.length=0,y=!1},exportReplaySession:o=>g(d(),o)}),dispose:()=>{u?.()}})}};export{S as createReplayPlugin,g as serializeReplaySession};
-//# sourceMappingURL=index.js.map

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

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/plugins/replay/index.ts"],
-  "sourcesContent": ["import type {\n  JourneyJsonObject,\n  JourneyMachine,\n  JourneyMachinePlugin,\n  JourneyObservationEvent,\n  JourneyReplayEntry,\n  JourneyReplayExportOptions,\n  JourneyReplayPluginOptions,\n  JourneyReplaySession,\n  JourneySnapshot\n} from \"../../types\";\n\nconst normalizeMaxEntries = (value: number | undefined) => {\n  if (typeof value !== \"number\" || !Number.isFinite(value)) {\n    return 500;\n  }\n\n  return Math.max(1, Math.trunc(value));\n};\n\nconst toSerializable = (value: unknown, seen = new WeakSet<object>()): unknown => {\n  if (\n    value === null ||\n    typeof value === \"string\" ||\n    typeof value === \"number\" ||\n    typeof value === \"boolean\"\n  ) {\n    return value;\n  }\n\n  if (typeof value === \"bigint\") {\n    return value.toString();\n  }\n\n  if (typeof value === \"undefined\") {\n    return null;\n  }\n\n  if (typeof value === \"function\" || typeof value === \"symbol\") {\n    return `[unsupported:${typeof value}]`;\n  }\n\n  if (value instanceof Error) {\n    return {\n      name: value.name,\n      message: value.message,\n      ...(value.stack ? { stack: value.stack } : {})\n    };\n  }\n\n  if (value instanceof Date) {\n    return value.toISOString();\n  }\n\n  if (Array.isArray(value)) {\n    return value.map((item) => toSerializable(item, seen));\n  }\n\n  if (typeof value === \"object\") {\n    if (seen.has(value)) {\n      return \"[circular]\";\n    }\n\n    seen.add(value);\n    const output: Record<string, unknown> = {};\n    for (const [key, item] of Object.entries(value)) {\n      output[key] = toSerializable(item, seen);\n    }\n    seen.delete(value);\n    return output;\n  }\n\n  return String(value);\n};\n\n/** Serializes a replay session into a JSON string safe for logging or export. */\nexport const serializeReplaySession = <\n  TContext extends JourneyJsonObject,\n  TStepId extends string,\n  TEventMap extends Record<string, unknown> = Record<never, never>\n>(\n  session: JourneyReplaySession<TContext, TStepId, TEventMap>,\n  options?: JourneyReplayExportOptions\n) => JSON.stringify(toSerializable(session), null, options?.pretty ? 2 : undefined);\n\nexport type JourneyReplayMachineExtension<\n  TContext extends JourneyJsonObject,\n  TStepId extends string,\n  TEventMap extends Record<string, unknown> = Record<never, never>\n> = {\n  getReplaySession: () => JourneyReplaySession<TContext, TStepId, TEventMap>;\n  clearReplaySession: () => void;\n  exportReplaySession: (options?: JourneyReplayExportOptions) => string;\n};\n\nexport type JourneyReplayMachine<\n  TContext extends JourneyJsonObject,\n  TStepId extends string,\n  TEventMap extends Record<string, unknown> = Record<never, never>,\n  TStepMeta = unknown,\n  THandlers extends Record<string, unknown> = Record<never, never>\n> = JourneyMachine<TContext, TStepId, TEventMap, TStepMeta, THandlers> &\n  JourneyReplayMachineExtension<TContext, TStepId, TEventMap>;\n\n/** Creates a plugin that records snapshot and lifecycle activity into a replay session. */\nexport const createReplayPlugin = (options: JourneyReplayPluginOptions = {}) => {\n  const captureEvents = options.captureEvents ?? true;\n  const captureSnapshots = options.captureSnapshots ?? true;\n  const maxEntries = normalizeMaxEntries(options.maxEntries);\n\n  let initialSnapshot: JourneySnapshot<JourneyJsonObject, string> | null = null;\n  const entries: JourneyReplayEntry<JourneyJsonObject, string, Record<string, unknown>>[] = [];\n  let truncated = false;\n  let unsubscribeEvents: (() => void) | undefined;\n\n  const pushEntry = (\n    entry: JourneyReplayEntry<JourneyJsonObject, string, Record<string, unknown>>\n  ) => {\n    if (entries.length >= maxEntries) {\n      entries.shift();\n      truncated = true;\n    }\n\n    entries.push(entry);\n  };\n\n  const buildSession = () =>\n    ({\n      version: 1 as const,\n      initialSnapshot,\n      entries: [...entries],\n      truncated\n    }) satisfies JourneyReplaySession<JourneyJsonObject, string, Record<string, unknown>>;\n\n  return {\n    name: \"replay\",\n    setup: () => ({\n      hydrateSnapshot: (snapshot) => {\n        initialSnapshot = snapshot as JourneySnapshot<JourneyJsonObject, string>;\n        return snapshot;\n      },\n      onSnapshotChange: ({ snapshot, reason }) => {\n        if (!captureSnapshots) {\n          return;\n        }\n\n        pushEntry({\n          kind: \"snapshot\",\n          timestamp: Date.now(),\n          reason,\n          snapshot: snapshot as JourneySnapshot<JourneyJsonObject, string>\n        });\n      },\n      augmentMachine: ({ machine }) => {\n        if (captureEvents) {\n          unsubscribeEvents = machine.subscribeEvent((event) => {\n            pushEntry({\n              kind: \"event\",\n              timestamp: event.timestamp,\n              event: event as JourneyObservationEvent<string, Record<string, unknown>>\n            });\n          });\n        }\n\n        return {\n          getReplaySession: () =>\n            buildSession() as JourneyReplaySession<\n              JourneyJsonObject,\n              string,\n              Record<string, unknown>\n            >,\n          clearReplaySession: () => {\n            initialSnapshot = machine.getSnapshot() as JourneySnapshot<JourneyJsonObject, string>;\n            entries.length = 0;\n            truncated = false;\n          },\n          exportReplaySession: (exportOptions?: JourneyReplayExportOptions) =>\n            serializeReplaySession(buildSession(), exportOptions)\n        };\n      },\n      dispose: () => {\n        unsubscribeEvents?.();\n      }\n    })\n  } satisfies JourneyMachinePlugin;\n};\n"],
-  "mappings": "AAYA,IAAMA,EAAuBC,GACvB,OAAOA,GAAU,UAAY,CAAC,OAAO,SAASA,CAAK,EAC9C,IAGF,KAAK,IAAI,EAAG,KAAK,MAAMA,CAAK,CAAC,EAGhCC,EAAiB,CAACD,EAAgBE,EAAO,IAAI,UAA+B,CAChF,GACEF,IAAU,MACV,OAAOA,GAAU,UACjB,OAAOA,GAAU,UACjB,OAAOA,GAAU,UAEjB,OAAOA,EAGT,GAAI,OAAOA,GAAU,SACnB,OAAOA,EAAM,SAAS,EAGxB,GAAI,OAAOA,EAAU,IACnB,OAAO,KAGT,GAAI,OAAOA,GAAU,YAAc,OAAOA,GAAU,SAClD,MAAO,gBAAgB,OAAOA,CAAK,IAGrC,GAAIA,aAAiB,MACnB,MAAO,CACL,KAAMA,EAAM,KACZ,QAASA,EAAM,QACf,GAAIA,EAAM,MAAQ,CAAE,MAAOA,EAAM,KAAM,EAAI,CAAC,CAC9C,EAGF,GAAIA,aAAiB,KACnB,OAAOA,EAAM,YAAY,EAG3B,GAAI,MAAM,QAAQA,CAAK,EACrB,OAAOA,EAAM,IAAKG,GAASF,EAAeE,EAAMD,CAAI,CAAC,EAGvD,GAAI,OAAOF,GAAU,SAAU,CAC7B,GAAIE,EAAK,IAAIF,CAAK,EAChB,MAAO,aAGTE,EAAK,IAAIF,CAAK,EACd,IAAMI,EAAkC,CAAC,EACzC,OAAW,CAACC,EAAKF,CAAI,IAAK,OAAO,QAAQH,CAAK,EAC5CI,EAAOC,CAAG,EAAIJ,EAAeE,EAAMD,CAAI,EAEzC,OAAAA,EAAK,OAAOF,CAAK,EACVI,CACT,CAEA,OAAO,OAAOJ,CAAK,CACrB,EAGaM,EAAyB,CAKpCC,EACAC,IACG,KAAK,UAAUP,EAAeM,CAAO,EAAG,KAAMC,GAAS,OAAS,EAAI,MAAS,EAsBrEC,EAAqB,CAACD,EAAsC,CAAC,IAAM,CAC9E,IAAME,EAAgBF,EAAQ,eAAiB,GACzCG,EAAmBH,EAAQ,kBAAoB,GAC/CI,EAAab,EAAoBS,EAAQ,UAAU,EAErDK,EAAqE,KACnEC,EAAoF,CAAC,EACvFC,EAAY,GACZC,EAEEC,EACJC,GACG,CACCJ,EAAQ,QAAUF,IACpBE,EAAQ,MAAM,EACdC,EAAY,IAGdD,EAAQ,KAAKI,CAAK,CACpB,EAEMC,EAAe,KAClB,CACC,QAAS,EACT,gBAAAN,EACA,QAAS,CAAC,GAAGC,CAAO,EACpB,UAAAC,CACF,GAEF,MAAO,CACL,KAAM,SACN,MAAO,KAAO,CACZ,gBAAkBK,IAChBP,EAAkBO,EACXA,GAET,iBAAkB,CAAC,CAAE,SAAAA,EAAU,OAAAC,CAAO,IAAM,CACrCV,GAILM,EAAU,CACR,KAAM,WACN,UAAW,KAAK,IAAI,EACpB,OAAAI,EACA,SAAUD,CACZ,CAAC,CACH,EACA,eAAgB,CAAC,CAAE,QAAAE,CAAQ,KACrBZ,IACFM,EAAoBM,EAAQ,eAAgBC,GAAU,CACpDN,EAAU,CACR,KAAM,QACN,UAAWM,EAAM,UACjB,MAAOA,CACT,CAAC,CACH,CAAC,GAGI,CACL,iBAAkB,IAChBJ,EAAa,EAKf,mBAAoB,IAAM,CACxBN,EAAkBS,EAAQ,YAAY,EACtCR,EAAQ,OAAS,EACjBC,EAAY,EACd,EACA,oBAAsBS,GACpBlB,EAAuBa,EAAa,EAAGK,CAAa,CACxD,GAEF,QAAS,IAAM,CACbR,IAAoB,CACtB,CACF,EACF,CACF",
-  "names": ["normalizeMaxEntries", "value", "toSerializable", "seen", "item", "output", "key", "serializeReplaySession", "session", "options", "createReplayPlugin", "captureEvents", "captureSnapshots", "maxEntries", "initialSnapshot", "entries", "truncated", "unsubscribeEvents", "pushEntry", "entry", "buildSession", "snapshot", "reason", "machine", "event", "exportOptions"]
-}

package/dist/types/analytics.types.d.cts

@@ -1,33 +0,0 @@
-import type { JourneyObservationEvent, JourneyTransitionSuccessObservationEvent } from "./observation.types";
-import type { JourneyJsonObject, JourneyTerminal } from "./journey.types";
-/** Standard analytics event names emitted by the analytics plugin. */
-export type JourneyAnalyticsEventName = "journey_started" | "step_viewed" | "step_exited" | "transition_started" | "transition_succeeded" | "transition_failed" | "journey_completed" | "journey_terminated" | "navigation_previous" | "navigation_last_visited" | (string & {});
-/** Analytics payload emitted by the analytics plugin. */
-export type JourneyAnalyticsEventPayload<TContext extends JourneyJsonObject, TStepId extends string, TStepMeta> = Record<string, unknown> & {
-    context?: TContext;
-    stepId?: TStepId;
-    stepMeta?: TStepMeta;
-    from?: TStepId;
-    to?: TStepId | JourneyTerminal;
-    fromStepMeta?: TStepMeta;
-    toStepMeta?: TStepMeta;
-    durationMs?: number;
-    dwellMs?: number;
-    eventType?: string;
-    transitionId?: JourneyTransitionSuccessObservationEvent<TStepId>["transitionId"];
-    label?: JourneyTransitionSuccessObservationEvent<TStepId>["label"];
-};
-/** Event envelope passed to analytics trackers. */
-export type JourneyAnalyticsTrackedEvent<TContext extends JourneyJsonObject, TStepId extends string, TStepMeta> = {
-    name: JourneyAnalyticsEventName;
-    timestamp: number;
-    machineId?: string;
-    payload: JourneyAnalyticsEventPayload<TContext, TStepId, TStepMeta>;
-};
-/** Options for the analytics plugin. */
-export type JourneyAnalyticsPluginOptions<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>, TStepMeta = unknown> = {
-    track: (event: JourneyAnalyticsTrackedEvent<TContext, TStepId, TStepMeta>) => void;
-    machineId?: string;
-    includeStepMeta?: boolean;
-    onError?: (error: unknown, event?: JourneyObservationEvent<TStepId, TEventMap> | JourneyAnalyticsTrackedEvent<TContext, TStepId, TStepMeta>) => void;
-};

package/dist/types/analytics.types.d.ts

@@ -1,33 +0,0 @@
-import type { JourneyObservationEvent, JourneyTransitionSuccessObservationEvent } from "./observation.types";
-import type { JourneyJsonObject, JourneyTerminal } from "./journey.types";
-/** Standard analytics event names emitted by the analytics plugin. */
-export type JourneyAnalyticsEventName = "journey_started" | "step_viewed" | "step_exited" | "transition_started" | "transition_succeeded" | "transition_failed" | "journey_completed" | "journey_terminated" | "navigation_previous" | "navigation_last_visited" | (string & {});
-/** Analytics payload emitted by the analytics plugin. */
-export type JourneyAnalyticsEventPayload<TContext extends JourneyJsonObject, TStepId extends string, TStepMeta> = Record<string, unknown> & {
-    context?: TContext;
-    stepId?: TStepId;
-    stepMeta?: TStepMeta;
-    from?: TStepId;
-    to?: TStepId | JourneyTerminal;
-    fromStepMeta?: TStepMeta;
-    toStepMeta?: TStepMeta;
-    durationMs?: number;
-    dwellMs?: number;
-    eventType?: string;
-    transitionId?: JourneyTransitionSuccessObservationEvent<TStepId>["transitionId"];
-    label?: JourneyTransitionSuccessObservationEvent<TStepId>["label"];
-};
-/** Event envelope passed to analytics trackers. */
-export type JourneyAnalyticsTrackedEvent<TContext extends JourneyJsonObject, TStepId extends string, TStepMeta> = {
-    name: JourneyAnalyticsEventName;
-    timestamp: number;
-    machineId?: string;
-    payload: JourneyAnalyticsEventPayload<TContext, TStepId, TStepMeta>;
-};
-/** Options for the analytics plugin. */
-export type JourneyAnalyticsPluginOptions<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>, TStepMeta = unknown> = {
-    track: (event: JourneyAnalyticsTrackedEvent<TContext, TStepId, TStepMeta>) => void;
-    machineId?: string;
-    includeStepMeta?: boolean;
-    onError?: (error: unknown, event?: JourneyObservationEvent<TStepId, TEventMap> | JourneyAnalyticsTrackedEvent<TContext, TStepId, TStepMeta>) => void;
-};

package/dist/types/autosave.types.d.cts

@@ -1,23 +0,0 @@
-import type { JourneyMachineSnapshotReason } from "./machine.types";
-import type { JourneyPersistenceOptions } from "./persistence.types";
-import type { JourneyJsonObject, JourneySnapshot } from "./journey.types";
-/** Autosave lifecycle status reported by the autosave plugin. */
-export type JourneyAutosaveStatus = "idle" | "pending" | "saved" | "error";
-/** Runtime autosave state exposed through the autosave plugin extension. */
-export type JourneyAutosaveState = {
-    status: JourneyAutosaveStatus;
-    lastSavedAt?: number;
-    pendingReason?: JourneyMachineSnapshotReason;
-    error?: unknown;
-};
-/** Options for the autosave plugin. */
-export type JourneyAutosavePluginOptions<TContext extends JourneyJsonObject, TStepId extends string> = JourneyPersistenceOptions<TContext, TStepId> & {
-    debounceMs?: number;
-    hydrate?: boolean;
-    saveOn?: readonly JourneyMachineSnapshotReason[];
-    onSaved?: (details: {
-        snapshot: JourneySnapshot<TContext, TStepId>;
-        reason: JourneyMachineSnapshotReason;
-        timestamp: number;
-    }) => void;
-};

package/dist/types/autosave.types.d.ts

@@ -1,23 +0,0 @@
-import type { JourneyMachineSnapshotReason } from "./machine.types";
-import type { JourneyPersistenceOptions } from "./persistence.types";
-import type { JourneyJsonObject, JourneySnapshot } from "./journey.types";
-/** Autosave lifecycle status reported by the autosave plugin. */
-export type JourneyAutosaveStatus = "idle" | "pending" | "saved" | "error";
-/** Runtime autosave state exposed through the autosave plugin extension. */
-export type JourneyAutosaveState = {
-    status: JourneyAutosaveStatus;
-    lastSavedAt?: number;
-    pendingReason?: JourneyMachineSnapshotReason;
-    error?: unknown;
-};
-/** Options for the autosave plugin. */
-export type JourneyAutosavePluginOptions<TContext extends JourneyJsonObject, TStepId extends string> = JourneyPersistenceOptions<TContext, TStepId> & {
-    debounceMs?: number;
-    hydrate?: boolean;
-    saveOn?: readonly JourneyMachineSnapshotReason[];
-    onSaved?: (details: {
-        snapshot: JourneySnapshot<TContext, TStepId>;
-        reason: JourneyMachineSnapshotReason;
-        timestamp: number;
-    }) => void;
-};

package/dist/types/diagnostics.types.d.cts

@@ -1,38 +0,0 @@
-import type { JourneyBuiltInFrom, JourneyMode } from "./journey.types";
-/** Structural diagnostic issue codes returned by journey diagnostics. */
-export type JourneyDiagnosticsIssueCode = "cycle-detected" | "dead-end-step" | "no-terminal-path" | "shadowed-transition" | "unreachable-step";
-/** Severity assigned to a diagnostics issue. */
-export type JourneyDiagnosticsIssueSeverity = "warning" | "error";
-/** Options that affect structural journey diagnostics. */
-export type JourneyDiagnosticsOptions = {
-    requireExplicitCompletion?: boolean;
-};
-/** A single diagnostics issue discovered while analyzing a journey definition. */
-export type JourneyDiagnosticsIssue<TStepId extends string, TEventType extends string> = {
-    code: JourneyDiagnosticsIssueCode;
-    severity: JourneyDiagnosticsIssueSeverity;
-    message: string;
-    stepId?: TStepId;
-    from?: TStepId | JourneyBuiltInFrom;
-    eventType?: TEventType;
-    transitionId?: string;
-    label?: string;
-    steps?: readonly TStepId[];
-};
-/** Aggregate diagnostics summary for a journey definition. */
-export type JourneyDiagnosticsSummary = {
-    mode: JourneyMode;
-    stepCount: number;
-    reachableStepCount: number;
-    unreachableStepCount: number;
-    deadEndCount: number;
-    cycleCount: number;
-    shadowedTransitionCount: number;
-    graphChecksSkipped: boolean;
-    terminalPathExists: boolean;
-};
-/** Result returned by `getJourneyDiagnostics()`. */
-export type JourneyDiagnosticsResult<TStepId extends string, TEventType extends string> = {
-    issues: JourneyDiagnosticsIssue<TStepId, TEventType>[];
-    summary: JourneyDiagnosticsSummary;
-};

package/dist/types/diagnostics.types.d.ts

@@ -1,38 +0,0 @@
-import type { JourneyBuiltInFrom, JourneyMode } from "./journey.types";
-/** Structural diagnostic issue codes returned by journey diagnostics. */
-export type JourneyDiagnosticsIssueCode = "cycle-detected" | "dead-end-step" | "no-terminal-path" | "shadowed-transition" | "unreachable-step";
-/** Severity assigned to a diagnostics issue. */
-export type JourneyDiagnosticsIssueSeverity = "warning" | "error";
-/** Options that affect structural journey diagnostics. */
-export type JourneyDiagnosticsOptions = {
-    requireExplicitCompletion?: boolean;
-};
-/** A single diagnostics issue discovered while analyzing a journey definition. */
-export type JourneyDiagnosticsIssue<TStepId extends string, TEventType extends string> = {
-    code: JourneyDiagnosticsIssueCode;
-    severity: JourneyDiagnosticsIssueSeverity;
-    message: string;
-    stepId?: TStepId;
-    from?: TStepId | JourneyBuiltInFrom;
-    eventType?: TEventType;
-    transitionId?: string;
-    label?: string;
-    steps?: readonly TStepId[];
-};
-/** Aggregate diagnostics summary for a journey definition. */
-export type JourneyDiagnosticsSummary = {
-    mode: JourneyMode;
-    stepCount: number;
-    reachableStepCount: number;
-    unreachableStepCount: number;
-    deadEndCount: number;
-    cycleCount: number;
-    shadowedTransitionCount: number;
-    graphChecksSkipped: boolean;
-    terminalPathExists: boolean;
-};
-/** Result returned by `getJourneyDiagnostics()`. */
-export type JourneyDiagnosticsResult<TStepId extends string, TEventType extends string> = {
-    issues: JourneyDiagnosticsIssue<TStepId, TEventType>[];
-    summary: JourneyDiagnosticsSummary;
-};

package/dist/types/index.d.cts

@@ -1,9 +0,0 @@
-export type { JourneyAnalyticsEventName, JourneyAnalyticsEventPayload, JourneyAnalyticsPluginOptions, JourneyAnalyticsTrackedEvent } from "./analytics.types";
-export type { JourneyAutosavePluginOptions, JourneyAutosaveState, JourneyAutosaveStatus } from "./autosave.types";
-export type { JourneyDiagnosticsIssue, JourneyDiagnosticsIssueCode, JourneyDiagnosticsIssueSeverity, JourneyDiagnosticsOptions, JourneyDiagnosticsResult, JourneyDiagnosticsSummary } from "./diagnostics.types";
-export type { JourneyAsyncPhase, JourneyAsyncState, JourneyBaseEvent, JourneyBuiltInFrom, JourneyBuiltInSendEvent, JourneyCustomSendEvent, JourneyComputed, JourneyComputedBase, JourneyDefaultEventType, JourneyDefinition, JourneyDefinitionBase, JourneyEqualityFn, JourneyEvent, JourneyJsonObject, JourneyJsonPrimitive, JourneyJsonValue, JourneyExecutionPath, JourneyExecutionPathEventType, JourneyExecutionPathOptions, JourneyExecutionPathsResult, JourneyFullEventType, JourneyGoToEvent, JourneyGraphComputed, JourneyHeadlessComputed, JourneyHistory, JourneyLinearComputed, JourneyMode, JourneyPayloadFor, JourneyResolvedDefinition, JourneySelector, JourneySendEvent, JourneySendResult, JourneySnapshot, JourneySnapshotStateBase, JourneyStatus, JourneyStepAsyncState, JourneyStepDefinition, JourneyTerminal } from "./journey.types";
-export type { JourneyCompleteObservationEvent, JourneyLifecycleErrorObservationEvent, JourneyLifecycleErrorPhase, JourneyLastVisitedNavigationObservationEvent, JourneyObservationEvent, JourneyPreviousNavigationObservationEvent, JourneyResetObservationEvent, JourneyStartObservationEvent, JourneyStepEnterObservationEvent, JourneyStepExitObservationEvent, JourneyTerminateObservationEvent, JourneyTransitionErrorObservationEvent, JourneyTransitionStartObservationEvent, JourneyTransitionSuccessObservationEvent } from "./observation.types";
-export type { JourneyLifecycleErrorContext, JourneyMachine, JourneyMachineOptions, JourneyMachinePlugin, JourneyMachinePluginHooks, JourneyMachinePluginSetupContext, JourneyMachinePluginSnapshotChange, JourneyMachineSnapshotReason, JourneyMachineWithPlugins } from "./machine.types";
-export type { JourneyDispatch, JourneyGlobalKey, JourneyLifecycleArgs, JourneyGlobalTransition, JourneyGoToStepGraphEdge, JourneyTransitionArgsForEvent, JourneyTransitionUpdateContextArgsForEvent, JourneyGoToStepTransition, JourneyGraphEdge, JourneyLinearStep, JourneyLinearTransitions, JourneyStepEventGraphEdge, JourneyStepEventTransition, JourneyStepLifecycleCallback, JourneyStepTransitions, JourneyTerminalGraphEdge, JourneyTerminalTransition, JourneyResolvedTransition, JourneyTransition, JourneyTransitionArgs, JourneyTransitionGraph, JourneyTransitionTarget, JourneyTransitionsDefinition } from "./transitions.types";
-export type { JourneyPersistedState, JourneyPersistenceOptions, JourneyStorage } from "./persistence.types";
-export type { JourneyReplayEntry, JourneyReplayEventEntry, JourneyReplayExportOptions, JourneyReplayPluginOptions, JourneyReplaySession, JourneyReplaySnapshotEntry } from "./replay.types";

package/dist/types/index.d.ts

@@ -1,9 +0,0 @@
-export type { JourneyAnalyticsEventName, JourneyAnalyticsEventPayload, JourneyAnalyticsPluginOptions, JourneyAnalyticsTrackedEvent } from "./analytics.types";
-export type { JourneyAutosavePluginOptions, JourneyAutosaveState, JourneyAutosaveStatus } from "./autosave.types";
-export type { JourneyDiagnosticsIssue, JourneyDiagnosticsIssueCode, JourneyDiagnosticsIssueSeverity, JourneyDiagnosticsOptions, JourneyDiagnosticsResult, JourneyDiagnosticsSummary } from "./diagnostics.types";
-export type { JourneyAsyncPhase, JourneyAsyncState, JourneyBaseEvent, JourneyBuiltInFrom, JourneyBuiltInSendEvent, JourneyCustomSendEvent, JourneyComputed, JourneyComputedBase, JourneyDefaultEventType, JourneyDefinition, JourneyDefinitionBase, JourneyEqualityFn, JourneyEvent, JourneyJsonObject, JourneyJsonPrimitive, JourneyJsonValue, JourneyExecutionPath, JourneyExecutionPathEventType, JourneyExecutionPathOptions, JourneyExecutionPathsResult, JourneyFullEventType, JourneyGoToEvent, JourneyGraphComputed, JourneyHeadlessComputed, JourneyHistory, JourneyLinearComputed, JourneyMode, JourneyPayloadFor, JourneyResolvedDefinition, JourneySelector, JourneySendEvent, JourneySendResult, JourneySnapshot, JourneySnapshotStateBase, JourneyStatus, JourneyStepAsyncState, JourneyStepDefinition, JourneyTerminal } from "./journey.types";
-export type { JourneyCompleteObservationEvent, JourneyLifecycleErrorObservationEvent, JourneyLifecycleErrorPhase, JourneyLastVisitedNavigationObservationEvent, JourneyObservationEvent, JourneyPreviousNavigationObservationEvent, JourneyResetObservationEvent, JourneyStartObservationEvent, JourneyStepEnterObservationEvent, JourneyStepExitObservationEvent, JourneyTerminateObservationEvent, JourneyTransitionErrorObservationEvent, JourneyTransitionStartObservationEvent, JourneyTransitionSuccessObservationEvent } from "./observation.types";
-export type { JourneyLifecycleErrorContext, JourneyMachine, JourneyMachineOptions, JourneyMachinePlugin, JourneyMachinePluginHooks, JourneyMachinePluginSetupContext, JourneyMachinePluginSnapshotChange, JourneyMachineSnapshotReason, JourneyMachineWithPlugins } from "./machine.types";
-export type { JourneyDispatch, JourneyGlobalKey, JourneyLifecycleArgs, JourneyGlobalTransition, JourneyGoToStepGraphEdge, JourneyTransitionArgsForEvent, JourneyTransitionUpdateContextArgsForEvent, JourneyGoToStepTransition, JourneyGraphEdge, JourneyLinearStep, JourneyLinearTransitions, JourneyStepEventGraphEdge, JourneyStepEventTransition, JourneyStepLifecycleCallback, JourneyStepTransitions, JourneyTerminalGraphEdge, JourneyTerminalTransition, JourneyResolvedTransition, JourneyTransition, JourneyTransitionArgs, JourneyTransitionGraph, JourneyTransitionTarget, JourneyTransitionsDefinition } from "./transitions.types";
-export type { JourneyPersistedState, JourneyPersistenceOptions, JourneyStorage } from "./persistence.types";
-export type { JourneyReplayEntry, JourneyReplayEventEntry, JourneyReplayExportOptions, JourneyReplayPluginOptions, JourneyReplaySession, JourneyReplaySnapshotEntry } from "./replay.types";

package/dist/types/journey.types.d.cts

@@ -1,191 +0,0 @@
-import type { JourneyResolvedTransition, JourneyStepLifecycleCallback, JourneyTransitionsDefinition } from "./transitions.types";
-/** Terminal outcomes reached when a journey completes or is explicitly terminated. */
-export type JourneyTerminal = "COMPLETE" | "TERMINATED";
-/** Union of possible runtime machine statuses. */
-export type JourneyStatus = "idled" | "running" | "completed" | "terminated";
-/** Mode inferred from the journey transition syntax. */
-export type JourneyMode = "linear" | "graph" | "headless";
-/** Wildcard step identifier, exposed as a type-only literal. */
-export type JourneyBuiltInFrom = "*";
-/** Default transition event names supported by machine convenience APIs. */
-export type JourneyDefaultEventType = "goToNextStep" | "goToPreviousStep" | "terminateJourney" | "completeJourney" | "goToStepById";
-/** JSON primitive values accepted inside runtime context. */
-export type JourneyJsonPrimitive = string | number | boolean | null;
-/** JSON-compatible value accepted inside runtime context. */
-export type JourneyJsonValue = JourneyJsonPrimitive | {
-    [key: string]: JourneyJsonValue;
-} | JourneyJsonValue[];
-/** JSON-compatible object accepted as the machine context root. */
-export type JourneyJsonObject = {
-    [key: string]: JourneyJsonValue;
-};
-/** Derives the full event type union from a user-supplied event map. */
-export type JourneyFullEventType<TEventMap extends Record<string, unknown>> = (keyof TEventMap & string) | JourneyDefaultEventType;
-type JourneyBuiltInSendEventType = Exclude<JourneyDefaultEventType, "goToStepById">;
-type JourneyCustomSendEventType<TEventMap extends Record<string, unknown>> = Exclude<keyof TEventMap & string, JourneyDefaultEventType>;
-/** Union of supported async lifecycle phases. */
-export type JourneyAsyncPhase = "idle" | "evaluating-when" | "error";
-/** Async execution state for a single step. */
-export type JourneyStepAsyncState = {
-    phase: JourneyAsyncPhase;
-    eventType: string | null;
-    transitionId: string | null;
-    /** Captured error from a failed guard or lifecycle handler. `null` when no error is present. */
-    error: unknown;
-};
-/** Aggregated async state for the machine, keyed by step id. */
-export type JourneyAsyncState<TStepId extends string> = {
-    isLoading: boolean;
-    byStep: Record<TStepId, JourneyStepAsyncState>;
-};
-/** Minimal event shape used across runtime boundaries. */
-export type JourneyBaseEvent = {
-    type: string;
-    payload?: unknown;
-};
-/** Resolves payload type for a specific event type from the provided event map. */
-export type JourneyPayloadFor<TEventMap extends Record<string, unknown>, TEvent extends string> = TEvent extends keyof TEventMap ? TEventMap[TEvent] : unknown;
-/** Built-in direct-navigation event that targets a specific step id. */
-export type JourneyGoToEvent<TStepId extends string, TPayload = unknown> = {
-    type: "goToStepById";
-    stepId: TStepId;
-    payload?: TPayload;
-};
-/** Built-in send events supported by machine convenience APIs. */
-export type JourneyBuiltInSendEvent<TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>> = JourneyGoToEvent<TStepId, JourneyPayloadFor<TEventMap, "goToStepById">> | {
-    [TType in JourneyBuiltInSendEventType]: {
-        type: TType;
-        payload?: JourneyPayloadFor<TEventMap, TType>;
-    };
-}[JourneyBuiltInSendEventType];
-/** Custom send events derived from a user-supplied event map. */
-export type JourneyCustomSendEvent<TEventMap extends Record<string, unknown> = Record<never, never>> = {
-    [TType in JourneyCustomSendEventType<TEventMap>]: {
-        type: TType;
-        payload?: JourneyPayloadFor<TEventMap, TType>;
-    };
-}[JourneyCustomSendEventType<TEventMap>];
-/** Event union accepted by `JourneyMachine.send`. */
-export type JourneySendEvent<TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>> = JourneyBuiltInSendEvent<TStepId, TEventMap> | JourneyCustomSendEvent<TEventMap>;
-/** Event union available to transitions and guards for the declared event type set. */
-export type JourneyEvent<TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>> = JourneySendEvent<TStepId, TEventMap>;
-/** Step definition with optional metadata and lifecycle callbacks. */
-export type JourneyStepDefinition<TContext extends JourneyJsonObject = JourneyJsonObject, TStepId extends string = string, TEventMap extends Record<string, unknown> = Record<never, never>, TStepMeta = unknown, THandlers extends Record<string, unknown> = Record<never, never>> = {
-    meta?: TStepMeta;
-    /** Called when the machine enters this step. */
-    onEnter?: JourneyStepLifecycleCallback<TContext, TStepId, TEventMap, THandlers>;
-    /** Called when the machine leaves this step. */
-    onLeave?: JourneyStepLifecycleCallback<TContext, TStepId, TEventMap, THandlers>;
-};
-/** Timeline of visited steps and current history index. */
-export type JourneyHistory<TStepId extends string> = {
-    timeline: readonly TStepId[];
-    index: number;
-};
-/** Core snapshot state without async execution details. */
-export type JourneySnapshotStateBase<TContext extends JourneyJsonObject, TStepId extends string> = {
-    currentStepId: TStepId;
-    history: JourneyHistory<TStepId>;
-    context: TContext;
-    visited: Record<TStepId, boolean>;
-    status: JourneyStatus;
-};
-/** Serializable runtime snapshot of the journey state. */
-export type JourneySnapshot<TContext extends JourneyJsonObject, TStepId extends string> = JourneySnapshotStateBase<TContext, TStepId> & {
-    async: JourneyAsyncState<TStepId>;
-};
-/** Common read-only computed state exposed by a machine instance. */
-export type JourneyComputedBase<TStepId extends string> = {
-    mode: JourneyMode;
-    activeStepId: TStepId;
-    activeStepIndex: number;
-    visitedStepCount: number;
-    isLoading: boolean;
-    isIdle: boolean;
-    isRunning: boolean;
-    isComplete: boolean;
-    isTerminated: boolean;
-    isInitialStep: boolean;
-};
-/** Wizard-style computed state available when transitions use linear array syntax. */
-export type JourneyLinearComputed<TStepId extends string> = JourneyComputedBase<TStepId> & {
-    mode: "linear";
-    stepCount: number;
-    journeyLength: number;
-    isFirstStep: boolean;
-    isLastStep: boolean;
-    stepOrder: readonly TStepId[];
-};
-/** Computed state available when transitions use graph object syntax. */
-export type JourneyGraphComputed<TStepId extends string> = JourneyComputedBase<TStepId> & {
-    mode: "graph";
-    stepCount?: undefined;
-    journeyLength?: undefined;
-    isFirstStep?: undefined;
-    isLastStep?: undefined;
-    stepOrder?: undefined;
-};
-/** Computed state available when transitions are omitted and navigation is headless. */
-export type JourneyHeadlessComputed<TStepId extends string> = JourneyComputedBase<TStepId> & {
-    mode: "headless";
-    stepCount?: undefined;
-    journeyLength?: undefined;
-    isFirstStep?: undefined;
-    isLastStep?: undefined;
-    stepOrder?: undefined;
-};
-/** Mode-aware computed state returned by `JourneyMachine.getComputed()`. */
-export type JourneyComputed<TStepId extends string> = JourneyLinearComputed<TStepId> | JourneyGraphComputed<TStepId> | JourneyHeadlessComputed<TStepId>;
-/** Selector function that derives a value from a machine snapshot. */
-export type JourneySelector<TContext extends JourneyJsonObject, TStepId extends string, TSelected = unknown> = (snapshot: JourneySnapshot<TContext, TStepId>) => TSelected;
-/** Equality function used to compare selected values between snapshot updates. */
-export type JourneyEqualityFn<TValue> = (previous: TValue, next: TValue) => boolean;
-/** Shared definition fields without transition configuration. */
-export type JourneyDefinitionBase<TContext extends JourneyJsonObject, TStepId extends string, TStepMeta = unknown, THandlers extends Record<string, unknown> = Record<never, never>> = {
-    /**
-     * The step the machine starts on.
-     * - **Linear transitions**: optional — defaults to the first element of the
-     *   transitions array. When provided, must exist in the array and the machine
-     *   starts from that step (useful for resuming mid-flow).
-     * - **Graph / headless**: required.
-     */
-    initial?: TStepId;
-    context: TContext;
-    handlers?: THandlers;
-    steps: Record<TStepId, JourneyStepDefinition<TContext, TStepId, Record<never, never>, TStepMeta, THandlers>>;
-};
-/** Full machine definition used to create a journey machine instance. */
-export type JourneyDefinition<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>, TStepMeta = unknown, THandlers extends Record<string, unknown> = Record<never, never>> = Omit<JourneyDefinitionBase<TContext, TStepId, TStepMeta, THandlers>, "steps"> & {
-    steps: Record<TStepId, JourneyStepDefinition<TContext, TStepId, TEventMap, TStepMeta, THandlers>>;
-    transitions?: JourneyTransitionsDefinition<TContext, TStepId, TEventMap, THandlers>;
-};
-export type JourneyResolvedDefinition<TContext extends JourneyJsonObject, TStepId extends string, TEventMap extends Record<string, unknown> = Record<never, never>, TStepMeta = unknown, THandlers extends Record<string, unknown> = Record<never, never>> = Required<Pick<JourneyDefinitionBase<TContext, TStepId, TStepMeta, THandlers>, "initial">> & Omit<JourneyDefinition<TContext, TStepId, TEventMap, TStepMeta, THandlers>, "transitions"> & {
-    transitions: readonly JourneyResolvedTransition<TContext, TStepId, TEventMap, THandlers>[];
-};
-export type JourneyExecutionPathEventType<TEventType extends string> = TEventType | JourneyDefaultEventType;
-/** Structural execution path returned by `getExecutionPaths()`. */
-export type JourneyExecutionPath<TStepId extends string, TEventType extends string> = {
-    steps: TStepId[];
-    events: JourneyExecutionPathEventType<TEventType>[];
-    terminated: "final" | "depth" | "cycle" | "limit";
-};
-/** Result returned by structural path enumeration. */
-export type JourneyExecutionPathsResult<TStepId extends string, TEventType extends string> = {
-    paths: JourneyExecutionPath<TStepId, TEventType>[];
-    truncated: boolean;
-    cyclesDetected: boolean;
-};
-/** Options for structural path enumeration from the initial step. */
-export type JourneyExecutionPathOptions = {
-    maxDepth?: number;
-    maxPaths?: number;
-};
-/** Result returned from send/navigation APIs. */
-export type JourneySendResult<TContext extends JourneyJsonObject, TStepId extends string> = {
-    transitioned: boolean;
-    transitionId?: string;
-    label?: string;
-    error?: unknown;
-    snapshot: JourneySnapshot<TContext, TStepId>;
-};
-export {};