@rxova/journey-react 0.6.0 → 0.6.2

package/README.md

@@ -12,10 +12,12 @@ npm i @rxova/journey-react
 
 `@rxova/journey-react` is bindings-first:
 
-- `createJourneyBindings(journey)` returns a typed bundle:
-- `Provider`
-- `StepRenderer`
-- `useJourneyApi`, `useJourneySnapshot`, `useJourneyMachine`
+- `createJourneyBindings(journey)` returns a typed bundle that contains:
+  - `Provider`
+  - `StepRenderer`
+  - `useJourneyApi`
+  - `useJourneySnapshot`
+  - `useJourneyMachine`
 
 No per-hook generic arguments are needed at callsites.
 
@@ -67,6 +69,42 @@ export const App = () => {
 };
 ```
 
+## Split Files Pattern (Hooks In Steps)
+
+If step components live in separate files and call Journey hooks, export bindings as `let`:
+
+```tsx
+// journey-bindings.ts
+import { createJourneyBindings, type JourneyReactDefinition } from "@rxova/journey-react";
+import { Start, Review } from "./steps";
+
+type StepId = "start" | "review";
+type Ctx = { name: string };
+
+export let bindings: ReturnType<typeof createJourneyBindings<Ctx, StepId>>;
+
+const journey: JourneyReactDefinition<Ctx, StepId> = {
+  initial: "start",
+  context: { name: "" },
+  steps: {
+    start: { component: Start },
+    review: { component: Review }
+  },
+  transitions: [
+    { from: "start", event: "goToNextStep", to: "review" },
+    { from: "review", event: "completeJourney" }
+  ]
+};
+
+bindings = createJourneyBindings(journey);
+```
+
+## Hooks
+
+- `useJourneySnapshot()` subscribes to the machine and rerenders on changes.
+- `useJourneyApi()` returns typed commands.
+- `useJourneyMachine()` returns the underlying core machine instance.
+
 ## Journey API Helpers
 
 From `bindings.useJourneyApi()`:
@@ -86,3 +124,77 @@ Imperative jump is available through `send`:
 ```ts
 await api.send({ type: "goToStepById", stepId: "review" });
 ```
+
+## Provider Behavior
+
+- `<Provider />` creates an internal core machine from the bound journey.
+- `<Provider journey={...} />` lets you pass a different journey definition at runtime.
+- Internal machine is preserved across `journey` prop changes by default.
+- Set `resetOnJourneyChange` to rebuild internal machine when `journey` identity changes.
+- `<Provider machine={externalMachine} />` uses your machine directly.
+- `persistence` applies only when Provider owns the internal machine.
+
+```tsx
+<bindings.Provider journey={dynamicJourney} resetOnJourneyChange>
+  <bindings.StepRenderer />
+</bindings.Provider>
+```
+
+## Async and Error UI
+
+Core async state is exposed via snapshot:
+
+```tsx
+const api = bindings.useJourneyApi();
+const snapshot = bindings.useJourneySnapshot();
+
+if (snapshot.async.isLoading) return <p>Working...</p>;
+
+const currentAsync = snapshot.async.byStep[snapshot.currentStepId];
+if (currentAsync.phase === "error") {
+  return (
+    <div>
+      <p>Something failed.</p>
+      <button onClick={() => api.clearStepError()}>Dismiss</button>
+    </div>
+  );
+}
+```
+
+## Devtools Bridge
+
+Use `useJourneyMachine()` and attach the devtools bridge from an effect:
+
+```tsx
+import React from "react";
+import { attachJourneyDevtools } from "@rxova/journey-devtools-bridge";
+
+const JourneyDevtoolsBridge = () => {
+  const machine = bindings.useJourneyMachine();
+
+  React.useEffect(() => {
+    return attachJourneyDevtools(machine, { label: "Signup" });
+  }, [machine]);
+
+  return null;
+};
+```
+
+## Transition Ergonomics
+
+`@rxova/journey-react` re-exports core transition builders:
+
+```ts
+import { createTransitions, tx } from "@rxova/journey-react";
+
+const transitions = createTransitions(
+  tx.from("start").on("goToNextStep").to("review"),
+  tx.from("review").toComplete()
+);
+```
+
+## SSR and RSC Notes
+
+- This package is a client entry (`"use client"`).
+- In React Server Components environments, call bindings/hooks from client components.
+- Server-side rendering is supported (Provider + StepRenderer render safely on the server).

package/dist/bindings/useJourneyApi.d.ts

@@ -1,8 +1,8 @@
-import type { JourneyEvent, JourneyPayloadFor } from "@rxova/journey-core";
+import type { JourneyPayloadFor, JourneySendEvent } from "@rxova/journey-core";
 import type { JourneyEventType, JourneyReactEventPayloadMap, JourneyStoreValue } from "../types";
 type UseJourneyStore<TContext, TStepId extends string, TCustomEvent extends string = never, TEventPayloadMap extends JourneyReactEventPayloadMap<TCustomEvent> = Record<never, never>, TStepMeta = unknown> = (hookName?: string) => JourneyStoreValue<TContext, TStepId, TCustomEvent, TEventPayloadMap, TStepMeta>;
 export declare const createUseJourneyApi: <TContext, TStepId extends string, TCustomEvent extends string = never, TEventPayloadMap extends JourneyReactEventPayloadMap<TCustomEvent> = Record<never, never>, TStepMeta = unknown>(useJourneyStore: UseJourneyStore<TContext, TStepId, TCustomEvent, TEventPayloadMap, TStepMeta>) => () => {
-    send: (event: JourneyEvent<TStepId, JourneyEventType<TCustomEvent>, TEventPayloadMap>) => Promise<void>;
+    send: (event: JourneySendEvent<TStepId, JourneyEventType<TCustomEvent>, TEventPayloadMap>) => Promise<void>;
     goToNextStep: () => Promise<void>;
     terminateJourney: (payload?: JourneyPayloadFor<JourneyEventType<TCustomEvent>, TEventPayloadMap, "terminateJourney">) => Promise<void>;
     completeJourney: (payload?: JourneyPayloadFor<JourneyEventType<TCustomEvent>, TEventPayloadMap, "completeJourney">) => Promise<void>;

package/dist/index.cjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/index.ts", "../src/bindings/index.tsx", "../src/bindings/Provider.tsx", "../src/bindings/StepRenderer.tsx", "../src/bindings/useJourneyApi.ts", "../src/bindings/useJourneyMachine.ts", "../src/bindings/useJourneySnapshot.ts"],
-  "sourcesContent": ["\"use client\";\n\nexport { createJourneyBindings } from \"./bindings\";\nexport {\n  createTransitions,\n  tx,\n  JOURNEY_STATUS,\n  JOURNEY_EVENT,\n  JOURNEY_ASYNC_PHASE,\n  JOURNEY_WILDCARD\n} from \"@rxova/journey-core\";\nexport type { JourneyDefinition } from \"@rxova/journey-core\";\nexport type {\n  JourneyApi,\n  JourneyBindings,\n  JourneyBindingsProviderProps,\n  JourneyEventType,\n  JourneyReactDefinition,\n  JourneyReactEventPayloadMap,\n  JourneyReactStep,\n  JourneyStoreValue\n} from \"./types\";\n", "import React from \"react\";\n\nimport type {\n  JourneyBindings,\n  JourneyReactDefinition,\n  JourneyReactEventPayloadMap,\n  JourneyStoreValue\n} from \"../types\";\nimport { createProvider } from \"./Provider\";\nimport { createStepRenderer } from \"./StepRenderer\";\nimport { createUseJourneyApi } from \"./useJourneyApi\";\nimport { createUseJourneyMachine } from \"./useJourneyMachine\";\nimport { createUseJourneySnapshot } from \"./useJourneySnapshot\";\n\nexport const createJourneyBindings = <\n  TContext,\n  TStepId extends string,\n  TCustomEvent extends string = never,\n  TEventPayloadMap extends JourneyReactEventPayloadMap<TCustomEvent> = Record<never, never>,\n  TStepMeta = unknown\n>(\n  boundJourney: JourneyReactDefinition<TContext, TStepId, TCustomEvent, TEventPayloadMap, TStepMeta>\n): JourneyBindings<TContext, TStepId, TCustomEvent, TEventPayloadMap, TStepMeta> => {\n  const JourneyContext = React.createContext<JourneyStoreValue<\n    TContext,\n    TStepId,\n    TCustomEvent,\n    TEventPayloadMap,\n    TStepMeta\n  > | null>(null);\n\n  const useJourneyStore = (hookName = \"hook\") => {\n    const value = React.useContext(JourneyContext);\n    if (!value) {\n      throw new Error(`${hookName} must be used within bindings.Provider.`);\n    }\n    return value;\n  };\n\n  const useJourneySnapshot = createUseJourneySnapshot(useJourneyStore);\n  const useJourneyMachine = createUseJourneyMachine(useJourneyStore);\n  const useJourneyApi = createUseJourneyApi(useJourneyStore);\n\n  const Provider = createProvider({\n    JourneyContext,\n    boundJourney\n  });\n\n  const StepRenderer = createStepRenderer({\n    useJourneySnapshot,\n    useJourneyStore\n  });\n\n  return {\n    Provider,\n    StepRenderer,\n    useJourneyApi,\n    useJourneyMachine,\n    useJourneySnapshot\n  };\n};\n", "import React from \"react\";\n\nimport { createJourneyMachine } from \"@rxova/journey-core\";\nimport type {\n  JourneyBindingsProviderProps,\n  JourneyReactDefinition,\n  JourneyReactEventPayloadMap,\n  JourneyStoreValue\n} from \"../types\";\n\ntype ProviderFactoryProps<\n  TContext,\n  TStepId extends string,\n  TCustomEvent extends string = never,\n  TEventPayloadMap extends JourneyReactEventPayloadMap<TCustomEvent> = Record<never, never>,\n  TStepMeta = unknown\n> = {\n  JourneyContext: React.Context<JourneyStoreValue<\n    TContext,\n    TStepId,\n    TCustomEvent,\n    TEventPayloadMap,\n    TStepMeta\n  > | null>;\n  boundJourney: JourneyReactDefinition<\n    TContext,\n    TStepId,\n    TCustomEvent,\n    TEventPayloadMap,\n    TStepMeta\n  >;\n};\n\nexport const createProvider = <\n  TContext,\n  TStepId extends string,\n  TCustomEvent extends string = never,\n  TEventPayloadMap extends JourneyReactEventPayloadMap<TCustomEvent> = Record<never, never>,\n  TStepMeta = unknown\n>({\n  JourneyContext,\n  boundJourney\n}: ProviderFactoryProps<TContext, TStepId, TCustomEvent, TEventPayloadMap, TStepMeta>) => {\n  const Provider = ({\n    journey,\n    machine,\n    persistence,\n    resetOnJourneyChange = false,\n    children\n  }: JourneyBindingsProviderProps<\n    TContext,\n    TStepId,\n    TCustomEvent,\n    TEventPayloadMap,\n    TStepMeta\n  >) => {\n    const incomingJourney = journey ?? boundJourney;\n    const internalMachineRef = React.useRef<\n      | JourneyStoreValue<TContext, TStepId, TCustomEvent, TEventPayloadMap, TStepMeta>[\"machine\"]\n      | null\n    >(null);\n    const journeyRef = React.useRef(incomingJourney);\n    const persistenceRef = React.useRef(persistence);\n\n    const shouldResetInternal = resetOnJourneyChange && journeyRef.current !== incomingJourney;\n    const shouldResetPersistence = persistenceRef.current !== persistence;\n\n    if (\n      !machine &&\n      (!internalMachineRef.current || shouldResetInternal || shouldResetPersistence)\n    ) {\n      const options = persistence ? { persistence } : undefined;\n      internalMachineRef.current = createJourneyMachine(incomingJourney, options);\n      journeyRef.current = incomingJourney;\n      persistenceRef.current = persistence;\n    }\n\n    const resolvedMachine = machine ?? internalMachineRef.current!;\n    const resolvedJourney = machine ? incomingJourney : journeyRef.current;\n    const value: JourneyStoreValue<TContext, TStepId, TCustomEvent, TEventPayloadMap, TStepMeta> = {\n      machine: resolvedMachine,\n      journey: resolvedJourney\n    };\n\n    return <JourneyContext.Provider value={value}>{children}</JourneyContext.Provider>;\n  };\n\n  return Provider;\n};\n", "import React from \"react\";\n\nimport type { JourneySnapshot } from \"@rxova/journey-core\";\nimport type { JourneyReactEventPayloadMap, JourneyStoreValue } from \"../types\";\n\ntype UseJourneyStore<\n  TContext,\n  TStepId extends string,\n  TCustomEvent extends string = never,\n  TEventPayloadMap extends JourneyReactEventPayloadMap<TCustomEvent> = Record<never, never>,\n  TStepMeta = unknown\n> = (\n  hookName?: string\n) => JourneyStoreValue<TContext, TStepId, TCustomEvent, TEventPayloadMap, TStepMeta>;\n\ntype UseJourneySnapshot<\n  TContext,\n  TStepId extends string,\n  TStepMeta = unknown\n> = () => JourneySnapshot<TContext, TStepId, TStepMeta>;\n\ntype StepRendererFactoryProps<\n  TContext,\n  TStepId extends string,\n  TCustomEvent extends string = never,\n  TEventPayloadMap extends JourneyReactEventPayloadMap<TCustomEvent> = Record<never, never>,\n  TStepMeta = unknown\n> = {\n  useJourneySnapshot: UseJourneySnapshot<TContext, TStepId, TStepMeta>;\n  useJourneyStore: UseJourneyStore<TContext, TStepId, TCustomEvent, TEventPayloadMap, TStepMeta>;\n};\n\nexport const createStepRenderer = <\n  TContext,\n  TStepId extends string,\n  TCustomEvent extends string = never,\n  TEventPayloadMap extends JourneyReactEventPayloadMap<TCustomEvent> = Record<never, never>,\n  TStepMeta = unknown\n>({\n  useJourneySnapshot,\n  useJourneyStore\n}: StepRendererFactoryProps<TContext, TStepId, TCustomEvent, TEventPayloadMap, TStepMeta>) => {\n  const StepRenderer = ({ fallback = null }: { fallback?: React.ReactNode }) => {\n    const snapshot = useJourneySnapshot();\n    const { journey } = useJourneyStore(\"StepRenderer\");\n\n    const StepComponent = journey.steps[snapshot.currentStepId]?.component;\n\n    if (!StepComponent) {\n      return <>{fallback}</>;\n    }\n\n    return <StepComponent />;\n  };\n\n  return StepRenderer;\n};\n", "import React from \"react\";\n\nimport type { JourneyEvent, JourneyPayloadFor } from \"@rxova/journey-core\";\nimport type { JourneyEventType, JourneyReactEventPayloadMap, JourneyStoreValue } from \"../types\";\n\ntype UseJourneyStore<\n  TContext,\n  TStepId extends string,\n  TCustomEvent extends string = never,\n  TEventPayloadMap extends JourneyReactEventPayloadMap<TCustomEvent> = Record<never, never>,\n  TStepMeta = unknown\n> = (\n  hookName?: string\n) => JourneyStoreValue<TContext, TStepId, TCustomEvent, TEventPayloadMap, TStepMeta>;\n\nexport const createUseJourneyApi = <\n  TContext,\n  TStepId extends string,\n  TCustomEvent extends string = never,\n  TEventPayloadMap extends JourneyReactEventPayloadMap<TCustomEvent> = Record<never, never>,\n  TStepMeta = unknown\n>(\n  useJourneyStore: UseJourneyStore<TContext, TStepId, TCustomEvent, TEventPayloadMap, TStepMeta>\n) => {\n  return () => {\n    const machine = useJourneyStore(\"useJourneyApi\").machine;\n\n    const send = React.useCallback(\n      async (event: JourneyEvent<TStepId, JourneyEventType<TCustomEvent>, TEventPayloadMap>) => {\n        await machine.send(event);\n      },\n      [machine]\n    );\n\n    const goToNextStep = React.useCallback(async () => {\n      await machine.goToNextStep();\n    }, [machine]);\n\n    const terminateJourney = React.useCallback(\n      async (\n        payload?: JourneyPayloadFor<\n          JourneyEventType<TCustomEvent>,\n          TEventPayloadMap,\n          \"terminateJourney\"\n        >\n      ) => {\n        await machine.terminateJourney(payload);\n      },\n      [machine]\n    );\n\n    const completeJourney = React.useCallback(\n      async (\n        payload?: JourneyPayloadFor<\n          JourneyEventType<TCustomEvent>,\n          TEventPayloadMap,\n          \"completeJourney\"\n        >\n      ) => {\n        await machine.completeJourney(payload);\n      },\n      [machine]\n    );\n\n    const goToPreviousStep = React.useCallback(\n      async (steps?: number) => {\n        await machine.goToPreviousStep(steps);\n      },\n      [machine]\n    );\n\n    const goToLastVisitedStep = React.useCallback(async () => {\n      await machine.goToLastVisitedStep();\n    }, [machine]);\n\n    const updateContext = React.useCallback(\n      (updater: (context: TContext) => TContext) => {\n        machine.updateContext(updater);\n      },\n      [machine]\n    );\n\n    const updateStepMetadata = React.useCallback(\n      (stepId: TStepId, updater: (metadata: TStepMeta) => TStepMeta) => {\n        machine.updateStepMetadata(stepId, updater);\n      },\n      [machine]\n    );\n\n    const clearStepError = React.useCallback(\n      (stepId?: TStepId) => {\n        machine.clearStepError(stepId);\n      },\n      [machine]\n    );\n\n    const resetJourney = React.useCallback(() => {\n      machine.resetMachine();\n    }, [machine]);\n\n    return {\n      send,\n      goToNextStep,\n      terminateJourney,\n      completeJourney,\n      goToPreviousStep,\n      goToLastVisitedStep,\n      clearStepError,\n      updateContext,\n      updateStepMetadata,\n      updateComponentMetadata: updateStepMetadata,\n      resetJourney\n    };\n  };\n};\n", "import type { JourneyReactEventPayloadMap, JourneyStoreValue } from \"../types\";\n\ntype UseJourneyStore<\n  TContext,\n  TStepId extends string,\n  TCustomEvent extends string = never,\n  TEventPayloadMap extends JourneyReactEventPayloadMap<TCustomEvent> = Record<never, never>,\n  TStepMeta = unknown\n> = (\n  hookName?: string\n) => JourneyStoreValue<TContext, TStepId, TCustomEvent, TEventPayloadMap, TStepMeta>;\n\nexport const createUseJourneyMachine = <\n  TContext,\n  TStepId extends string,\n  TCustomEvent extends string = never,\n  TEventPayloadMap extends JourneyReactEventPayloadMap<TCustomEvent> = Record<never, never>,\n  TStepMeta = unknown\n>(\n  useJourneyStore: UseJourneyStore<TContext, TStepId, TCustomEvent, TEventPayloadMap, TStepMeta>\n) => {\n  return () => {\n    return useJourneyStore(\"useJourneyMachine\").machine;\n  };\n};\n", "import React from \"react\";\n\nimport type { JourneySnapshot } from \"@rxova/journey-core\";\nimport type { JourneyReactEventPayloadMap, JourneyStoreValue } from \"../types\";\n\ntype UseJourneyStore<\n  TContext,\n  TStepId extends string,\n  TCustomEvent extends string = never,\n  TEventPayloadMap extends JourneyReactEventPayloadMap<TCustomEvent> = Record<never, never>,\n  TStepMeta = unknown\n> = (\n  hookName?: string\n) => JourneyStoreValue<TContext, TStepId, TCustomEvent, TEventPayloadMap, TStepMeta>;\n\nexport const createUseJourneySnapshot = <\n  TContext,\n  TStepId extends string,\n  TCustomEvent extends string = never,\n  TEventPayloadMap extends JourneyReactEventPayloadMap<TCustomEvent> = Record<never, never>,\n  TStepMeta = unknown\n>(\n  useJourneyStore: UseJourneyStore<TContext, TStepId, TCustomEvent, TEventPayloadMap, TStepMeta>\n) => {\n  return (): JourneySnapshot<TContext, TStepId, TStepMeta> => {\n    const { machine } = useJourneyStore(\"useJourneySnapshot\");\n    return React.useSyncExternalStore(machine.subscribe, machine.getSnapshot, machine.getSnapshot);\n  };\n};\n"],
-  "mappings": "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",
+  "sourcesContent": ["// Mark this entry point as a Next.js App Router client module so it can be used in client components.\n\"use client\";\n\nexport { createJourneyBindings } from \"./bindings\";\nexport {\n  createTransitions,\n  tx,\n  JOURNEY_STATUS,\n  JOURNEY_EVENT,\n  JOURNEY_ASYNC_PHASE,\n  JOURNEY_WILDCARD\n} from \"@rxova/journey-core\";\nexport type { JourneyDefinition } from \"@rxova/journey-core\";\nexport type {\n  JourneyApi,\n  JourneyBindings,\n  JourneyBindingsProviderProps,\n  JourneyEventType,\n  JourneyReactDefinition,\n  JourneyReactEventPayloadMap,\n  JourneyReactStep,\n  JourneyStoreValue\n} from \"./types\";\n", "import React from \"react\";\n\nimport type {\n  JourneyBindings,\n  JourneyReactDefinition,\n  JourneyReactEventPayloadMap,\n  JourneyStoreValue\n} from \"../types\";\nimport { createProvider } from \"./Provider\";\nimport { createStepRenderer } from \"./StepRenderer\";\nimport { createUseJourneyApi } from \"./useJourneyApi\";\nimport { createUseJourneyMachine } from \"./useJourneyMachine\";\nimport { createUseJourneySnapshot } from \"./useJourneySnapshot\";\n\nexport const createJourneyBindings = <\n  TContext,\n  TStepId extends string,\n  TCustomEvent extends string = never,\n  TEventPayloadMap extends JourneyReactEventPayloadMap<TCustomEvent> = Record<never, never>,\n  TStepMeta = unknown\n>(\n  boundJourney: JourneyReactDefinition<TContext, TStepId, TCustomEvent, TEventPayloadMap, TStepMeta>\n): JourneyBindings<TContext, TStepId, TCustomEvent, TEventPayloadMap, TStepMeta> => {\n  const JourneyContext = React.createContext<JourneyStoreValue<\n    TContext,\n    TStepId,\n    TCustomEvent,\n    TEventPayloadMap,\n    TStepMeta\n  > | null>(null);\n\n  const useJourneyStore = (hookName = \"hook\") => {\n    const value = React.useContext(JourneyContext);\n    if (!value) {\n      throw new Error(`${hookName} must be used within bindings.Provider.`);\n    }\n    return value;\n  };\n\n  const useJourneySnapshot = createUseJourneySnapshot(useJourneyStore);\n  const useJourneyMachine = createUseJourneyMachine(useJourneyStore);\n  const useJourneyApi = createUseJourneyApi(useJourneyStore);\n\n  const Provider = createProvider({\n    JourneyContext,\n    boundJourney\n  });\n\n  const StepRenderer = createStepRenderer({\n    useJourneySnapshot,\n    useJourneyStore\n  });\n\n  return {\n    Provider,\n    StepRenderer,\n    useJourneyApi,\n    useJourneyMachine,\n    useJourneySnapshot\n  };\n};\n", "import React from \"react\";\n\nimport { createJourneyMachine } from \"@rxova/journey-core\";\nimport type {\n  JourneyBindingsProviderProps,\n  JourneyReactDefinition,\n  JourneyReactEventPayloadMap,\n  JourneyStoreValue\n} from \"../types\";\n\ntype ProviderFactoryProps<\n  TContext,\n  TStepId extends string,\n  TCustomEvent extends string = never,\n  TEventPayloadMap extends JourneyReactEventPayloadMap<TCustomEvent> = Record<never, never>,\n  TStepMeta = unknown\n> = {\n  JourneyContext: React.Context<JourneyStoreValue<\n    TContext,\n    TStepId,\n    TCustomEvent,\n    TEventPayloadMap,\n    TStepMeta\n  > | null>;\n  boundJourney: JourneyReactDefinition<\n    TContext,\n    TStepId,\n    TCustomEvent,\n    TEventPayloadMap,\n    TStepMeta\n  >;\n};\n\nexport const createProvider = <\n  TContext,\n  TStepId extends string,\n  TCustomEvent extends string = never,\n  TEventPayloadMap extends JourneyReactEventPayloadMap<TCustomEvent> = Record<never, never>,\n  TStepMeta = unknown\n>({\n  JourneyContext,\n  boundJourney\n}: ProviderFactoryProps<TContext, TStepId, TCustomEvent, TEventPayloadMap, TStepMeta>) => {\n  const Provider = ({\n    journey,\n    machine,\n    persistence,\n    resetOnJourneyChange = false,\n    children\n  }: JourneyBindingsProviderProps<\n    TContext,\n    TStepId,\n    TCustomEvent,\n    TEventPayloadMap,\n    TStepMeta\n  >) => {\n    const incomingJourney = journey ?? boundJourney;\n    const internalMachineRef = React.useRef<\n      | JourneyStoreValue<TContext, TStepId, TCustomEvent, TEventPayloadMap, TStepMeta>[\"machine\"]\n      | null\n    >(null);\n    const journeyRef = React.useRef(incomingJourney);\n    const persistenceRef = React.useRef(persistence);\n\n    const shouldResetInternal = resetOnJourneyChange && journeyRef.current !== incomingJourney;\n    const shouldResetPersistence = persistenceRef.current !== persistence;\n\n    if (\n      !machine &&\n      (!internalMachineRef.current || shouldResetInternal || shouldResetPersistence)\n    ) {\n      const options = persistence ? { persistence } : undefined;\n      internalMachineRef.current = createJourneyMachine(incomingJourney, options);\n      journeyRef.current = incomingJourney;\n      persistenceRef.current = persistence;\n    }\n\n    const resolvedMachine = machine ?? internalMachineRef.current!;\n    const resolvedJourney = machine ? incomingJourney : journeyRef.current;\n    const value: JourneyStoreValue<TContext, TStepId, TCustomEvent, TEventPayloadMap, TStepMeta> = {\n      machine: resolvedMachine,\n      journey: resolvedJourney\n    };\n\n    return <JourneyContext.Provider value={value}>{children}</JourneyContext.Provider>;\n  };\n\n  return Provider;\n};\n", "import React from \"react\";\n\nimport type { JourneySnapshot } from \"@rxova/journey-core\";\nimport type { JourneyReactEventPayloadMap, JourneyStoreValue } from \"../types\";\n\ntype UseJourneyStore<\n  TContext,\n  TStepId extends string,\n  TCustomEvent extends string = never,\n  TEventPayloadMap extends JourneyReactEventPayloadMap<TCustomEvent> = Record<never, never>,\n  TStepMeta = unknown\n> = (\n  hookName?: string\n) => JourneyStoreValue<TContext, TStepId, TCustomEvent, TEventPayloadMap, TStepMeta>;\n\ntype UseJourneySnapshot<\n  TContext,\n  TStepId extends string,\n  TStepMeta = unknown\n> = () => JourneySnapshot<TContext, TStepId, TStepMeta>;\n\ntype StepRendererFactoryProps<\n  TContext,\n  TStepId extends string,\n  TCustomEvent extends string = never,\n  TEventPayloadMap extends JourneyReactEventPayloadMap<TCustomEvent> = Record<never, never>,\n  TStepMeta = unknown\n> = {\n  useJourneySnapshot: UseJourneySnapshot<TContext, TStepId, TStepMeta>;\n  useJourneyStore: UseJourneyStore<TContext, TStepId, TCustomEvent, TEventPayloadMap, TStepMeta>;\n};\n\nexport const createStepRenderer = <\n  TContext,\n  TStepId extends string,\n  TCustomEvent extends string = never,\n  TEventPayloadMap extends JourneyReactEventPayloadMap<TCustomEvent> = Record<never, never>,\n  TStepMeta = unknown\n>({\n  useJourneySnapshot,\n  useJourneyStore\n}: StepRendererFactoryProps<TContext, TStepId, TCustomEvent, TEventPayloadMap, TStepMeta>) => {\n  const StepRenderer = ({ fallback = null }: { fallback?: React.ReactNode }) => {\n    const snapshot = useJourneySnapshot();\n    const { journey } = useJourneyStore(\"StepRenderer\");\n\n    const StepComponent = journey.steps[snapshot.currentStepId]?.component;\n\n    if (!StepComponent) {\n      return <>{fallback}</>;\n    }\n\n    return <StepComponent />;\n  };\n\n  return StepRenderer;\n};\n", "import React from \"react\";\n\nimport type { JourneyPayloadFor, JourneySendEvent } from \"@rxova/journey-core\";\nimport type { JourneyEventType, JourneyReactEventPayloadMap, JourneyStoreValue } from \"../types\";\n\ntype UseJourneyStore<\n  TContext,\n  TStepId extends string,\n  TCustomEvent extends string = never,\n  TEventPayloadMap extends JourneyReactEventPayloadMap<TCustomEvent> = Record<never, never>,\n  TStepMeta = unknown\n> = (\n  hookName?: string\n) => JourneyStoreValue<TContext, TStepId, TCustomEvent, TEventPayloadMap, TStepMeta>;\n\nexport const createUseJourneyApi = <\n  TContext,\n  TStepId extends string,\n  TCustomEvent extends string = never,\n  TEventPayloadMap extends JourneyReactEventPayloadMap<TCustomEvent> = Record<never, never>,\n  TStepMeta = unknown\n>(\n  useJourneyStore: UseJourneyStore<TContext, TStepId, TCustomEvent, TEventPayloadMap, TStepMeta>\n) => {\n  return () => {\n    const machine = useJourneyStore(\"useJourneyApi\").machine;\n\n    const send = React.useCallback(\n      async (\n        event: JourneySendEvent<TStepId, JourneyEventType<TCustomEvent>, TEventPayloadMap>\n      ) => {\n        await machine.send(event);\n      },\n      [machine]\n    );\n\n    const goToNextStep = React.useCallback(async () => {\n      await machine.goToNextStep();\n    }, [machine]);\n\n    const terminateJourney = React.useCallback(\n      async (\n        payload?: JourneyPayloadFor<\n          JourneyEventType<TCustomEvent>,\n          TEventPayloadMap,\n          \"terminateJourney\"\n        >\n      ) => {\n        await machine.terminateJourney(payload);\n      },\n      [machine]\n    );\n\n    const completeJourney = React.useCallback(\n      async (\n        payload?: JourneyPayloadFor<\n          JourneyEventType<TCustomEvent>,\n          TEventPayloadMap,\n          \"completeJourney\"\n        >\n      ) => {\n        await machine.completeJourney(payload);\n      },\n      [machine]\n    );\n\n    const goToPreviousStep = React.useCallback(\n      async (steps?: number) => {\n        await machine.goToPreviousStep(steps);\n      },\n      [machine]\n    );\n\n    const goToLastVisitedStep = React.useCallback(async () => {\n      await machine.goToLastVisitedStep();\n    }, [machine]);\n\n    const updateContext = React.useCallback(\n      (updater: (context: TContext) => TContext) => {\n        machine.updateContext(updater);\n      },\n      [machine]\n    );\n\n    const updateStepMetadata = React.useCallback(\n      (stepId: TStepId, updater: (metadata: TStepMeta) => TStepMeta) => {\n        machine.updateStepMetadata(stepId, updater);\n      },\n      [machine]\n    );\n\n    const clearStepError = React.useCallback(\n      (stepId?: TStepId) => {\n        machine.clearStepError(stepId);\n      },\n      [machine]\n    );\n\n    const resetJourney = React.useCallback(() => {\n      machine.resetMachine();\n    }, [machine]);\n\n    return {\n      send,\n      goToNextStep,\n      terminateJourney,\n      completeJourney,\n      goToPreviousStep,\n      goToLastVisitedStep,\n      clearStepError,\n      updateContext,\n      updateStepMetadata,\n      updateComponentMetadata: updateStepMetadata,\n      resetJourney\n    };\n  };\n};\n", "import type { JourneyReactEventPayloadMap, JourneyStoreValue } from \"../types\";\n\ntype UseJourneyStore<\n  TContext,\n  TStepId extends string,\n  TCustomEvent extends string = never,\n  TEventPayloadMap extends JourneyReactEventPayloadMap<TCustomEvent> = Record<never, never>,\n  TStepMeta = unknown\n> = (\n  hookName?: string\n) => JourneyStoreValue<TContext, TStepId, TCustomEvent, TEventPayloadMap, TStepMeta>;\n\nexport const createUseJourneyMachine = <\n  TContext,\n  TStepId extends string,\n  TCustomEvent extends string = never,\n  TEventPayloadMap extends JourneyReactEventPayloadMap<TCustomEvent> = Record<never, never>,\n  TStepMeta = unknown\n>(\n  useJourneyStore: UseJourneyStore<TContext, TStepId, TCustomEvent, TEventPayloadMap, TStepMeta>\n) => {\n  return () => {\n    return useJourneyStore(\"useJourneyMachine\").machine;\n  };\n};\n", "import React from \"react\";\n\nimport type { JourneySnapshot } from \"@rxova/journey-core\";\nimport type { JourneyReactEventPayloadMap, JourneyStoreValue } from \"../types\";\n\ntype UseJourneyStore<\n  TContext,\n  TStepId extends string,\n  TCustomEvent extends string = never,\n  TEventPayloadMap extends JourneyReactEventPayloadMap<TCustomEvent> = Record<never, never>,\n  TStepMeta = unknown\n> = (\n  hookName?: string\n) => JourneyStoreValue<TContext, TStepId, TCustomEvent, TEventPayloadMap, TStepMeta>;\n\nexport const createUseJourneySnapshot = <\n  TContext,\n  TStepId extends string,\n  TCustomEvent extends string = never,\n  TEventPayloadMap extends JourneyReactEventPayloadMap<TCustomEvent> = Record<never, never>,\n  TStepMeta = unknown\n>(\n  useJourneyStore: UseJourneyStore<TContext, TStepId, TCustomEvent, TEventPayloadMap, TStepMeta>\n) => {\n  return (): JourneySnapshot<TContext, TStepId, TStepMeta> => {\n    const { machine } = useJourneyStore(\"useJourneySnapshot\");\n    return React.useSyncExternalStore(machine.subscribe, machine.getSnapshot, machine.getSnapshot);\n  };\n};\n"],
+  "mappings": "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",
   "names": ["index_exports", "__export", "createJourneyBindings", "__toCommonJS", "import_react", "import_react", "import_journey_core", "import_jsx_runtime", "createProvider", "JourneyContext", "boundJourney", "journey", "machine", "persistence", "resetOnJourneyChange", "children", "incomingJourney", "internalMachineRef", "React", "journeyRef", "persistenceRef", "shouldResetInternal", "shouldResetPersistence", "options", "resolvedMachine", "resolvedJourney", "value", "import_jsx_runtime", "createStepRenderer", "useJourneySnapshot", "useJourneyStore", "fallback", "snapshot", "journey", "StepComponent", "import_react", "createUseJourneyApi", "useJourneyStore", "machine", "send", "React", "event", "goToNextStep", "terminateJourney", "payload", "completeJourney", "goToPreviousStep", "steps", "goToLastVisitedStep", "updateContext", "updater", "updateStepMetadata", "stepId", "clearStepError", "resetJourney", "createUseJourneyMachine", "useJourneyStore", "import_react", "createUseJourneySnapshot", "useJourneyStore", "machine", "React", "createJourneyBindings", "boundJourney", "JourneyContext", "React", "useJourneyStore", "hookName", "value", "useJourneySnapshot", "createUseJourneySnapshot", "useJourneyMachine", "createUseJourneyMachine", "useJourneyApi", "createUseJourneyApi", "Provider", "createProvider", "StepRenderer", "createStepRenderer", "import_journey_core"]
 }

package/dist/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/bindings/index.tsx", "../src/bindings/Provider.tsx", "../src/bindings/StepRenderer.tsx", "../src/bindings/useJourneyApi.ts", "../src/bindings/useJourneyMachine.ts", "../src/bindings/useJourneySnapshot.ts", "../src/index.ts"],
-  "sourcesContent": ["import React from \"react\";\n\nimport type {\n  JourneyBindings,\n  JourneyReactDefinition,\n  JourneyReactEventPayloadMap,\n  JourneyStoreValue\n} from \"../types\";\nimport { createProvider } from \"./Provider\";\nimport { createStepRenderer } from \"./StepRenderer\";\nimport { createUseJourneyApi } from \"./useJourneyApi\";\nimport { createUseJourneyMachine } from \"./useJourneyMachine\";\nimport { createUseJourneySnapshot } from \"./useJourneySnapshot\";\n\nexport const createJourneyBindings = <\n  TContext,\n  TStepId extends string,\n  TCustomEvent extends string = never,\n  TEventPayloadMap extends JourneyReactEventPayloadMap<TCustomEvent> = Record<never, never>,\n  TStepMeta = unknown\n>(\n  boundJourney: JourneyReactDefinition<TContext, TStepId, TCustomEvent, TEventPayloadMap, TStepMeta>\n): JourneyBindings<TContext, TStepId, TCustomEvent, TEventPayloadMap, TStepMeta> => {\n  const JourneyContext = React.createContext<JourneyStoreValue<\n    TContext,\n    TStepId,\n    TCustomEvent,\n    TEventPayloadMap,\n    TStepMeta\n  > | null>(null);\n\n  const useJourneyStore = (hookName = \"hook\") => {\n    const value = React.useContext(JourneyContext);\n    if (!value) {\n      throw new Error(`${hookName} must be used within bindings.Provider.`);\n    }\n    return value;\n  };\n\n  const useJourneySnapshot = createUseJourneySnapshot(useJourneyStore);\n  const useJourneyMachine = createUseJourneyMachine(useJourneyStore);\n  const useJourneyApi = createUseJourneyApi(useJourneyStore);\n\n  const Provider = createProvider({\n    JourneyContext,\n    boundJourney\n  });\n\n  const StepRenderer = createStepRenderer({\n    useJourneySnapshot,\n    useJourneyStore\n  });\n\n  return {\n    Provider,\n    StepRenderer,\n    useJourneyApi,\n    useJourneyMachine,\n    useJourneySnapshot\n  };\n};\n", "import React from \"react\";\n\nimport { createJourneyMachine } from \"@rxova/journey-core\";\nimport type {\n  JourneyBindingsProviderProps,\n  JourneyReactDefinition,\n  JourneyReactEventPayloadMap,\n  JourneyStoreValue\n} from \"../types\";\n\ntype ProviderFactoryProps<\n  TContext,\n  TStepId extends string,\n  TCustomEvent extends string = never,\n  TEventPayloadMap extends JourneyReactEventPayloadMap<TCustomEvent> = Record<never, never>,\n  TStepMeta = unknown\n> = {\n  JourneyContext: React.Context<JourneyStoreValue<\n    TContext,\n    TStepId,\n    TCustomEvent,\n    TEventPayloadMap,\n    TStepMeta\n  > | null>;\n  boundJourney: JourneyReactDefinition<\n    TContext,\n    TStepId,\n    TCustomEvent,\n    TEventPayloadMap,\n    TStepMeta\n  >;\n};\n\nexport const createProvider = <\n  TContext,\n  TStepId extends string,\n  TCustomEvent extends string = never,\n  TEventPayloadMap extends JourneyReactEventPayloadMap<TCustomEvent> = Record<never, never>,\n  TStepMeta = unknown\n>({\n  JourneyContext,\n  boundJourney\n}: ProviderFactoryProps<TContext, TStepId, TCustomEvent, TEventPayloadMap, TStepMeta>) => {\n  const Provider = ({\n    journey,\n    machine,\n    persistence,\n    resetOnJourneyChange = false,\n    children\n  }: JourneyBindingsProviderProps<\n    TContext,\n    TStepId,\n    TCustomEvent,\n    TEventPayloadMap,\n    TStepMeta\n  >) => {\n    const incomingJourney = journey ?? boundJourney;\n    const internalMachineRef = React.useRef<\n      | JourneyStoreValue<TContext, TStepId, TCustomEvent, TEventPayloadMap, TStepMeta>[\"machine\"]\n      | null\n    >(null);\n    const journeyRef = React.useRef(incomingJourney);\n    const persistenceRef = React.useRef(persistence);\n\n    const shouldResetInternal = resetOnJourneyChange && journeyRef.current !== incomingJourney;\n    const shouldResetPersistence = persistenceRef.current !== persistence;\n\n    if (\n      !machine &&\n      (!internalMachineRef.current || shouldResetInternal || shouldResetPersistence)\n    ) {\n      const options = persistence ? { persistence } : undefined;\n      internalMachineRef.current = createJourneyMachine(incomingJourney, options);\n      journeyRef.current = incomingJourney;\n      persistenceRef.current = persistence;\n    }\n\n    const resolvedMachine = machine ?? internalMachineRef.current!;\n    const resolvedJourney = machine ? incomingJourney : journeyRef.current;\n    const value: JourneyStoreValue<TContext, TStepId, TCustomEvent, TEventPayloadMap, TStepMeta> = {\n      machine: resolvedMachine,\n      journey: resolvedJourney\n    };\n\n    return <JourneyContext.Provider value={value}>{children}</JourneyContext.Provider>;\n  };\n\n  return Provider;\n};\n", "import React from \"react\";\n\nimport type { JourneySnapshot } from \"@rxova/journey-core\";\nimport type { JourneyReactEventPayloadMap, JourneyStoreValue } from \"../types\";\n\ntype UseJourneyStore<\n  TContext,\n  TStepId extends string,\n  TCustomEvent extends string = never,\n  TEventPayloadMap extends JourneyReactEventPayloadMap<TCustomEvent> = Record<never, never>,\n  TStepMeta = unknown\n> = (\n  hookName?: string\n) => JourneyStoreValue<TContext, TStepId, TCustomEvent, TEventPayloadMap, TStepMeta>;\n\ntype UseJourneySnapshot<\n  TContext,\n  TStepId extends string,\n  TStepMeta = unknown\n> = () => JourneySnapshot<TContext, TStepId, TStepMeta>;\n\ntype StepRendererFactoryProps<\n  TContext,\n  TStepId extends string,\n  TCustomEvent extends string = never,\n  TEventPayloadMap extends JourneyReactEventPayloadMap<TCustomEvent> = Record<never, never>,\n  TStepMeta = unknown\n> = {\n  useJourneySnapshot: UseJourneySnapshot<TContext, TStepId, TStepMeta>;\n  useJourneyStore: UseJourneyStore<TContext, TStepId, TCustomEvent, TEventPayloadMap, TStepMeta>;\n};\n\nexport const createStepRenderer = <\n  TContext,\n  TStepId extends string,\n  TCustomEvent extends string = never,\n  TEventPayloadMap extends JourneyReactEventPayloadMap<TCustomEvent> = Record<never, never>,\n  TStepMeta = unknown\n>({\n  useJourneySnapshot,\n  useJourneyStore\n}: StepRendererFactoryProps<TContext, TStepId, TCustomEvent, TEventPayloadMap, TStepMeta>) => {\n  const StepRenderer = ({ fallback = null }: { fallback?: React.ReactNode }) => {\n    const snapshot = useJourneySnapshot();\n    const { journey } = useJourneyStore(\"StepRenderer\");\n\n    const StepComponent = journey.steps[snapshot.currentStepId]?.component;\n\n    if (!StepComponent) {\n      return <>{fallback}</>;\n    }\n\n    return <StepComponent />;\n  };\n\n  return StepRenderer;\n};\n", "import React from \"react\";\n\nimport type { JourneyEvent, JourneyPayloadFor } from \"@rxova/journey-core\";\nimport type { JourneyEventType, JourneyReactEventPayloadMap, JourneyStoreValue } from \"../types\";\n\ntype UseJourneyStore<\n  TContext,\n  TStepId extends string,\n  TCustomEvent extends string = never,\n  TEventPayloadMap extends JourneyReactEventPayloadMap<TCustomEvent> = Record<never, never>,\n  TStepMeta = unknown\n> = (\n  hookName?: string\n) => JourneyStoreValue<TContext, TStepId, TCustomEvent, TEventPayloadMap, TStepMeta>;\n\nexport const createUseJourneyApi = <\n  TContext,\n  TStepId extends string,\n  TCustomEvent extends string = never,\n  TEventPayloadMap extends JourneyReactEventPayloadMap<TCustomEvent> = Record<never, never>,\n  TStepMeta = unknown\n>(\n  useJourneyStore: UseJourneyStore<TContext, TStepId, TCustomEvent, TEventPayloadMap, TStepMeta>\n) => {\n  return () => {\n    const machine = useJourneyStore(\"useJourneyApi\").machine;\n\n    const send = React.useCallback(\n      async (event: JourneyEvent<TStepId, JourneyEventType<TCustomEvent>, TEventPayloadMap>) => {\n        await machine.send(event);\n      },\n      [machine]\n    );\n\n    const goToNextStep = React.useCallback(async () => {\n      await machine.goToNextStep();\n    }, [machine]);\n\n    const terminateJourney = React.useCallback(\n      async (\n        payload?: JourneyPayloadFor<\n          JourneyEventType<TCustomEvent>,\n          TEventPayloadMap,\n          \"terminateJourney\"\n        >\n      ) => {\n        await machine.terminateJourney(payload);\n      },\n      [machine]\n    );\n\n    const completeJourney = React.useCallback(\n      async (\n        payload?: JourneyPayloadFor<\n          JourneyEventType<TCustomEvent>,\n          TEventPayloadMap,\n          \"completeJourney\"\n        >\n      ) => {\n        await machine.completeJourney(payload);\n      },\n      [machine]\n    );\n\n    const goToPreviousStep = React.useCallback(\n      async (steps?: number) => {\n        await machine.goToPreviousStep(steps);\n      },\n      [machine]\n    );\n\n    const goToLastVisitedStep = React.useCallback(async () => {\n      await machine.goToLastVisitedStep();\n    }, [machine]);\n\n    const updateContext = React.useCallback(\n      (updater: (context: TContext) => TContext) => {\n        machine.updateContext(updater);\n      },\n      [machine]\n    );\n\n    const updateStepMetadata = React.useCallback(\n      (stepId: TStepId, updater: (metadata: TStepMeta) => TStepMeta) => {\n        machine.updateStepMetadata(stepId, updater);\n      },\n      [machine]\n    );\n\n    const clearStepError = React.useCallback(\n      (stepId?: TStepId) => {\n        machine.clearStepError(stepId);\n      },\n      [machine]\n    );\n\n    const resetJourney = React.useCallback(() => {\n      machine.resetMachine();\n    }, [machine]);\n\n    return {\n      send,\n      goToNextStep,\n      terminateJourney,\n      completeJourney,\n      goToPreviousStep,\n      goToLastVisitedStep,\n      clearStepError,\n      updateContext,\n      updateStepMetadata,\n      updateComponentMetadata: updateStepMetadata,\n      resetJourney\n    };\n  };\n};\n", "import type { JourneyReactEventPayloadMap, JourneyStoreValue } from \"../types\";\n\ntype UseJourneyStore<\n  TContext,\n  TStepId extends string,\n  TCustomEvent extends string = never,\n  TEventPayloadMap extends JourneyReactEventPayloadMap<TCustomEvent> = Record<never, never>,\n  TStepMeta = unknown\n> = (\n  hookName?: string\n) => JourneyStoreValue<TContext, TStepId, TCustomEvent, TEventPayloadMap, TStepMeta>;\n\nexport const createUseJourneyMachine = <\n  TContext,\n  TStepId extends string,\n  TCustomEvent extends string = never,\n  TEventPayloadMap extends JourneyReactEventPayloadMap<TCustomEvent> = Record<never, never>,\n  TStepMeta = unknown\n>(\n  useJourneyStore: UseJourneyStore<TContext, TStepId, TCustomEvent, TEventPayloadMap, TStepMeta>\n) => {\n  return () => {\n    return useJourneyStore(\"useJourneyMachine\").machine;\n  };\n};\n", "import React from \"react\";\n\nimport type { JourneySnapshot } from \"@rxova/journey-core\";\nimport type { JourneyReactEventPayloadMap, JourneyStoreValue } from \"../types\";\n\ntype UseJourneyStore<\n  TContext,\n  TStepId extends string,\n  TCustomEvent extends string = never,\n  TEventPayloadMap extends JourneyReactEventPayloadMap<TCustomEvent> = Record<never, never>,\n  TStepMeta = unknown\n> = (\n  hookName?: string\n) => JourneyStoreValue<TContext, TStepId, TCustomEvent, TEventPayloadMap, TStepMeta>;\n\nexport const createUseJourneySnapshot = <\n  TContext,\n  TStepId extends string,\n  TCustomEvent extends string = never,\n  TEventPayloadMap extends JourneyReactEventPayloadMap<TCustomEvent> = Record<never, never>,\n  TStepMeta = unknown\n>(\n  useJourneyStore: UseJourneyStore<TContext, TStepId, TCustomEvent, TEventPayloadMap, TStepMeta>\n) => {\n  return (): JourneySnapshot<TContext, TStepId, TStepMeta> => {\n    const { machine } = useJourneyStore(\"useJourneySnapshot\");\n    return React.useSyncExternalStore(machine.subscribe, machine.getSnapshot, machine.getSnapshot);\n  };\n};\n", "\"use client\";\n\nexport { createJourneyBindings } from \"./bindings\";\nexport {\n  createTransitions,\n  tx,\n  JOURNEY_STATUS,\n  JOURNEY_EVENT,\n  JOURNEY_ASYNC_PHASE,\n  JOURNEY_WILDCARD\n} from \"@rxova/journey-core\";\nexport type { JourneyDefinition } from \"@rxova/journey-core\";\nexport type {\n  JourneyApi,\n  JourneyBindings,\n  JourneyBindingsProviderProps,\n  JourneyEventType,\n  JourneyReactDefinition,\n  JourneyReactEventPayloadMap,\n  JourneyReactStep,\n  JourneyStoreValue\n} from \"./types\";\n"],
-  "mappings": "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",
+  "sourcesContent": ["import React from \"react\";\n\nimport type {\n  JourneyBindings,\n  JourneyReactDefinition,\n  JourneyReactEventPayloadMap,\n  JourneyStoreValue\n} from \"../types\";\nimport { createProvider } from \"./Provider\";\nimport { createStepRenderer } from \"./StepRenderer\";\nimport { createUseJourneyApi } from \"./useJourneyApi\";\nimport { createUseJourneyMachine } from \"./useJourneyMachine\";\nimport { createUseJourneySnapshot } from \"./useJourneySnapshot\";\n\nexport const createJourneyBindings = <\n  TContext,\n  TStepId extends string,\n  TCustomEvent extends string = never,\n  TEventPayloadMap extends JourneyReactEventPayloadMap<TCustomEvent> = Record<never, never>,\n  TStepMeta = unknown\n>(\n  boundJourney: JourneyReactDefinition<TContext, TStepId, TCustomEvent, TEventPayloadMap, TStepMeta>\n): JourneyBindings<TContext, TStepId, TCustomEvent, TEventPayloadMap, TStepMeta> => {\n  const JourneyContext = React.createContext<JourneyStoreValue<\n    TContext,\n    TStepId,\n    TCustomEvent,\n    TEventPayloadMap,\n    TStepMeta\n  > | null>(null);\n\n  const useJourneyStore = (hookName = \"hook\") => {\n    const value = React.useContext(JourneyContext);\n    if (!value) {\n      throw new Error(`${hookName} must be used within bindings.Provider.`);\n    }\n    return value;\n  };\n\n  const useJourneySnapshot = createUseJourneySnapshot(useJourneyStore);\n  const useJourneyMachine = createUseJourneyMachine(useJourneyStore);\n  const useJourneyApi = createUseJourneyApi(useJourneyStore);\n\n  const Provider = createProvider({\n    JourneyContext,\n    boundJourney\n  });\n\n  const StepRenderer = createStepRenderer({\n    useJourneySnapshot,\n    useJourneyStore\n  });\n\n  return {\n    Provider,\n    StepRenderer,\n    useJourneyApi,\n    useJourneyMachine,\n    useJourneySnapshot\n  };\n};\n", "import React from \"react\";\n\nimport { createJourneyMachine } from \"@rxova/journey-core\";\nimport type {\n  JourneyBindingsProviderProps,\n  JourneyReactDefinition,\n  JourneyReactEventPayloadMap,\n  JourneyStoreValue\n} from \"../types\";\n\ntype ProviderFactoryProps<\n  TContext,\n  TStepId extends string,\n  TCustomEvent extends string = never,\n  TEventPayloadMap extends JourneyReactEventPayloadMap<TCustomEvent> = Record<never, never>,\n  TStepMeta = unknown\n> = {\n  JourneyContext: React.Context<JourneyStoreValue<\n    TContext,\n    TStepId,\n    TCustomEvent,\n    TEventPayloadMap,\n    TStepMeta\n  > | null>;\n  boundJourney: JourneyReactDefinition<\n    TContext,\n    TStepId,\n    TCustomEvent,\n    TEventPayloadMap,\n    TStepMeta\n  >;\n};\n\nexport const createProvider = <\n  TContext,\n  TStepId extends string,\n  TCustomEvent extends string = never,\n  TEventPayloadMap extends JourneyReactEventPayloadMap<TCustomEvent> = Record<never, never>,\n  TStepMeta = unknown\n>({\n  JourneyContext,\n  boundJourney\n}: ProviderFactoryProps<TContext, TStepId, TCustomEvent, TEventPayloadMap, TStepMeta>) => {\n  const Provider = ({\n    journey,\n    machine,\n    persistence,\n    resetOnJourneyChange = false,\n    children\n  }: JourneyBindingsProviderProps<\n    TContext,\n    TStepId,\n    TCustomEvent,\n    TEventPayloadMap,\n    TStepMeta\n  >) => {\n    const incomingJourney = journey ?? boundJourney;\n    const internalMachineRef = React.useRef<\n      | JourneyStoreValue<TContext, TStepId, TCustomEvent, TEventPayloadMap, TStepMeta>[\"machine\"]\n      | null\n    >(null);\n    const journeyRef = React.useRef(incomingJourney);\n    const persistenceRef = React.useRef(persistence);\n\n    const shouldResetInternal = resetOnJourneyChange && journeyRef.current !== incomingJourney;\n    const shouldResetPersistence = persistenceRef.current !== persistence;\n\n    if (\n      !machine &&\n      (!internalMachineRef.current || shouldResetInternal || shouldResetPersistence)\n    ) {\n      const options = persistence ? { persistence } : undefined;\n      internalMachineRef.current = createJourneyMachine(incomingJourney, options);\n      journeyRef.current = incomingJourney;\n      persistenceRef.current = persistence;\n    }\n\n    const resolvedMachine = machine ?? internalMachineRef.current!;\n    const resolvedJourney = machine ? incomingJourney : journeyRef.current;\n    const value: JourneyStoreValue<TContext, TStepId, TCustomEvent, TEventPayloadMap, TStepMeta> = {\n      machine: resolvedMachine,\n      journey: resolvedJourney\n    };\n\n    return <JourneyContext.Provider value={value}>{children}</JourneyContext.Provider>;\n  };\n\n  return Provider;\n};\n", "import React from \"react\";\n\nimport type { JourneySnapshot } from \"@rxova/journey-core\";\nimport type { JourneyReactEventPayloadMap, JourneyStoreValue } from \"../types\";\n\ntype UseJourneyStore<\n  TContext,\n  TStepId extends string,\n  TCustomEvent extends string = never,\n  TEventPayloadMap extends JourneyReactEventPayloadMap<TCustomEvent> = Record<never, never>,\n  TStepMeta = unknown\n> = (\n  hookName?: string\n) => JourneyStoreValue<TContext, TStepId, TCustomEvent, TEventPayloadMap, TStepMeta>;\n\ntype UseJourneySnapshot<\n  TContext,\n  TStepId extends string,\n  TStepMeta = unknown\n> = () => JourneySnapshot<TContext, TStepId, TStepMeta>;\n\ntype StepRendererFactoryProps<\n  TContext,\n  TStepId extends string,\n  TCustomEvent extends string = never,\n  TEventPayloadMap extends JourneyReactEventPayloadMap<TCustomEvent> = Record<never, never>,\n  TStepMeta = unknown\n> = {\n  useJourneySnapshot: UseJourneySnapshot<TContext, TStepId, TStepMeta>;\n  useJourneyStore: UseJourneyStore<TContext, TStepId, TCustomEvent, TEventPayloadMap, TStepMeta>;\n};\n\nexport const createStepRenderer = <\n  TContext,\n  TStepId extends string,\n  TCustomEvent extends string = never,\n  TEventPayloadMap extends JourneyReactEventPayloadMap<TCustomEvent> = Record<never, never>,\n  TStepMeta = unknown\n>({\n  useJourneySnapshot,\n  useJourneyStore\n}: StepRendererFactoryProps<TContext, TStepId, TCustomEvent, TEventPayloadMap, TStepMeta>) => {\n  const StepRenderer = ({ fallback = null }: { fallback?: React.ReactNode }) => {\n    const snapshot = useJourneySnapshot();\n    const { journey } = useJourneyStore(\"StepRenderer\");\n\n    const StepComponent = journey.steps[snapshot.currentStepId]?.component;\n\n    if (!StepComponent) {\n      return <>{fallback}</>;\n    }\n\n    return <StepComponent />;\n  };\n\n  return StepRenderer;\n};\n", "import React from \"react\";\n\nimport type { JourneyPayloadFor, JourneySendEvent } from \"@rxova/journey-core\";\nimport type { JourneyEventType, JourneyReactEventPayloadMap, JourneyStoreValue } from \"../types\";\n\ntype UseJourneyStore<\n  TContext,\n  TStepId extends string,\n  TCustomEvent extends string = never,\n  TEventPayloadMap extends JourneyReactEventPayloadMap<TCustomEvent> = Record<never, never>,\n  TStepMeta = unknown\n> = (\n  hookName?: string\n) => JourneyStoreValue<TContext, TStepId, TCustomEvent, TEventPayloadMap, TStepMeta>;\n\nexport const createUseJourneyApi = <\n  TContext,\n  TStepId extends string,\n  TCustomEvent extends string = never,\n  TEventPayloadMap extends JourneyReactEventPayloadMap<TCustomEvent> = Record<never, never>,\n  TStepMeta = unknown\n>(\n  useJourneyStore: UseJourneyStore<TContext, TStepId, TCustomEvent, TEventPayloadMap, TStepMeta>\n) => {\n  return () => {\n    const machine = useJourneyStore(\"useJourneyApi\").machine;\n\n    const send = React.useCallback(\n      async (\n        event: JourneySendEvent<TStepId, JourneyEventType<TCustomEvent>, TEventPayloadMap>\n      ) => {\n        await machine.send(event);\n      },\n      [machine]\n    );\n\n    const goToNextStep = React.useCallback(async () => {\n      await machine.goToNextStep();\n    }, [machine]);\n\n    const terminateJourney = React.useCallback(\n      async (\n        payload?: JourneyPayloadFor<\n          JourneyEventType<TCustomEvent>,\n          TEventPayloadMap,\n          \"terminateJourney\"\n        >\n      ) => {\n        await machine.terminateJourney(payload);\n      },\n      [machine]\n    );\n\n    const completeJourney = React.useCallback(\n      async (\n        payload?: JourneyPayloadFor<\n          JourneyEventType<TCustomEvent>,\n          TEventPayloadMap,\n          \"completeJourney\"\n        >\n      ) => {\n        await machine.completeJourney(payload);\n      },\n      [machine]\n    );\n\n    const goToPreviousStep = React.useCallback(\n      async (steps?: number) => {\n        await machine.goToPreviousStep(steps);\n      },\n      [machine]\n    );\n\n    const goToLastVisitedStep = React.useCallback(async () => {\n      await machine.goToLastVisitedStep();\n    }, [machine]);\n\n    const updateContext = React.useCallback(\n      (updater: (context: TContext) => TContext) => {\n        machine.updateContext(updater);\n      },\n      [machine]\n    );\n\n    const updateStepMetadata = React.useCallback(\n      (stepId: TStepId, updater: (metadata: TStepMeta) => TStepMeta) => {\n        machine.updateStepMetadata(stepId, updater);\n      },\n      [machine]\n    );\n\n    const clearStepError = React.useCallback(\n      (stepId?: TStepId) => {\n        machine.clearStepError(stepId);\n      },\n      [machine]\n    );\n\n    const resetJourney = React.useCallback(() => {\n      machine.resetMachine();\n    }, [machine]);\n\n    return {\n      send,\n      goToNextStep,\n      terminateJourney,\n      completeJourney,\n      goToPreviousStep,\n      goToLastVisitedStep,\n      clearStepError,\n      updateContext,\n      updateStepMetadata,\n      updateComponentMetadata: updateStepMetadata,\n      resetJourney\n    };\n  };\n};\n", "import type { JourneyReactEventPayloadMap, JourneyStoreValue } from \"../types\";\n\ntype UseJourneyStore<\n  TContext,\n  TStepId extends string,\n  TCustomEvent extends string = never,\n  TEventPayloadMap extends JourneyReactEventPayloadMap<TCustomEvent> = Record<never, never>,\n  TStepMeta = unknown\n> = (\n  hookName?: string\n) => JourneyStoreValue<TContext, TStepId, TCustomEvent, TEventPayloadMap, TStepMeta>;\n\nexport const createUseJourneyMachine = <\n  TContext,\n  TStepId extends string,\n  TCustomEvent extends string = never,\n  TEventPayloadMap extends JourneyReactEventPayloadMap<TCustomEvent> = Record<never, never>,\n  TStepMeta = unknown\n>(\n  useJourneyStore: UseJourneyStore<TContext, TStepId, TCustomEvent, TEventPayloadMap, TStepMeta>\n) => {\n  return () => {\n    return useJourneyStore(\"useJourneyMachine\").machine;\n  };\n};\n", "import React from \"react\";\n\nimport type { JourneySnapshot } from \"@rxova/journey-core\";\nimport type { JourneyReactEventPayloadMap, JourneyStoreValue } from \"../types\";\n\ntype UseJourneyStore<\n  TContext,\n  TStepId extends string,\n  TCustomEvent extends string = never,\n  TEventPayloadMap extends JourneyReactEventPayloadMap<TCustomEvent> = Record<never, never>,\n  TStepMeta = unknown\n> = (\n  hookName?: string\n) => JourneyStoreValue<TContext, TStepId, TCustomEvent, TEventPayloadMap, TStepMeta>;\n\nexport const createUseJourneySnapshot = <\n  TContext,\n  TStepId extends string,\n  TCustomEvent extends string = never,\n  TEventPayloadMap extends JourneyReactEventPayloadMap<TCustomEvent> = Record<never, never>,\n  TStepMeta = unknown\n>(\n  useJourneyStore: UseJourneyStore<TContext, TStepId, TCustomEvent, TEventPayloadMap, TStepMeta>\n) => {\n  return (): JourneySnapshot<TContext, TStepId, TStepMeta> => {\n    const { machine } = useJourneyStore(\"useJourneySnapshot\");\n    return React.useSyncExternalStore(machine.subscribe, machine.getSnapshot, machine.getSnapshot);\n  };\n};\n", "// Mark this entry point as a Next.js App Router client module so it can be used in client components.\n\"use client\";\n\nexport { createJourneyBindings } from \"./bindings\";\nexport {\n  createTransitions,\n  tx,\n  JOURNEY_STATUS,\n  JOURNEY_EVENT,\n  JOURNEY_ASYNC_PHASE,\n  JOURNEY_WILDCARD\n} from \"@rxova/journey-core\";\nexport type { JourneyDefinition } from \"@rxova/journey-core\";\nexport type {\n  JourneyApi,\n  JourneyBindings,\n  JourneyBindingsProviderProps,\n  JourneyEventType,\n  JourneyReactDefinition,\n  JourneyReactEventPayloadMap,\n  JourneyReactStep,\n  JourneyStoreValue\n} from \"./types\";\n"],
+  "mappings": "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",
   "names": ["React", "React", "createJourneyMachine", "jsx", "createProvider", "JourneyContext", "boundJourney", "journey", "machine", "persistence", "resetOnJourneyChange", "children", "incomingJourney", "internalMachineRef", "journeyRef", "persistenceRef", "shouldResetInternal", "shouldResetPersistence", "options", "resolvedMachine", "resolvedJourney", "value", "Fragment", "jsx", "createStepRenderer", "useJourneySnapshot", "useJourneyStore", "fallback", "snapshot", "journey", "StepComponent", "React", "createUseJourneyApi", "useJourneyStore", "machine", "send", "event", "goToNextStep", "terminateJourney", "payload", "completeJourney", "goToPreviousStep", "steps", "goToLastVisitedStep", "updateContext", "updater", "updateStepMetadata", "stepId", "clearStepError", "resetJourney", "createUseJourneyMachine", "useJourneyStore", "React", "createUseJourneySnapshot", "useJourneyStore", "machine", "createJourneyBindings", "boundJourney", "JourneyContext", "React", "useJourneyStore", "hookName", "value", "useJourneySnapshot", "createUseJourneySnapshot", "useJourneyMachine", "createUseJourneyMachine", "useJourneyApi", "createUseJourneyApi", "Provider", "createProvider", "StepRenderer", "createStepRenderer", "createTransitions", "tx", "JOURNEY_STATUS", "JOURNEY_EVENT", "JOURNEY_ASYNC_PHASE", "JOURNEY_WILDCARD"]
 }

package/dist/types.d.ts

@@ -1,5 +1,5 @@
 import type React from "react";
-import type { JourneyDefinition, JourneyEvent, JourneyEventPayloadMap as JourneyCoreEventPayloadMap, JourneyMachine, JourneyPayloadFor, JourneyPersistenceOptions, JourneySnapshot, JourneyStepDefinition } from "@rxova/journey-core";
+import type { JourneyDefinition, JourneyEventPayloadMap as JourneyCoreEventPayloadMap, JourneyMachine, JourneyPayloadFor, JourneyPersistenceOptions, JourneySendEvent, JourneySnapshot, JourneyStepDefinition } from "@rxova/journey-core";
 export type JourneyDefaultEvent = "goToNextStep" | "goToPreviousStep" | "terminateJourney" | "completeJourney";
 export type JourneyEventType<TCustomEvent extends string = never> = JourneyDefaultEvent | TCustomEvent;
 export type JourneyReactEventPayloadMap<TCustomEvent extends string = never> = JourneyCoreEventPayloadMap<JourneyEventType<TCustomEvent>>;
@@ -10,7 +10,7 @@ export type JourneyReactDefinition<TContext, TStepId extends string, TCustomEven
     steps: Record<TStepId, JourneyReactStep<TStepMeta>>;
 };
 export type JourneyApi<TContext, TStepId extends string, TCustomEvent extends string = never, TEventPayloadMap extends JourneyReactEventPayloadMap<TCustomEvent> = Record<never, never>, TStepMeta = unknown> = {
-    send: (event: JourneyEvent<TStepId, JourneyEventType<TCustomEvent>, TEventPayloadMap>) => Promise<void>;
+    send: (event: JourneySendEvent<TStepId, JourneyEventType<TCustomEvent>, TEventPayloadMap>) => Promise<void>;
     goToNextStep: () => Promise<void>;
     terminateJourney: (payload?: JourneyPayloadFor<JourneyEventType<TCustomEvent>, TEventPayloadMap, "terminateJourney">) => Promise<void>;
     completeJourney: (payload?: JourneyPayloadFor<JourneyEventType<TCustomEvent>, TEventPayloadMap, "completeJourney">) => Promise<void>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rxova/journey-react",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "description": "React bindings for journey.",
   "keywords": [
     "react",
@@ -47,7 +47,7 @@
   ],
   "sideEffects": false,
   "dependencies": {
-    "@rxova/journey-core": "^0.6.0"
+    "@rxova/journey-core": "^0.6.2"
   },
   "peerDependencies": {
     "react": ">=18.2.0"
@@ -66,15 +66,15 @@
     }
   ],
   "devDependencies": {
-    "@testing-library/react": "^16.1.0",
-    "@types/react": "^19.0.8",
-    "@types/react-dom": "^19.0.3",
-    "react": "^19.0.0",
-    "react-dom": "^19.0.0"
+    "@testing-library/react": "^16.3.2",
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.2.3",
+    "react": "^19.2.4",
+    "react-dom": "^19.2.4"
   },
   "scripts": {
     "build": "pnpm run clean && node ./scripts/build.mjs && tsc -p tsconfig.build.json && node ../../scripts/copy-types.mjs dist",
-    "clean": "rm -rf dist tsconfig.build.tsbuildinfo",
+    "clean": "node ../../scripts/clean-paths.mjs dist tsconfig.build.tsbuildinfo",
     "coverage": "pnpm --workspace-root vitest run --coverage --coverage.include=packages/react/src/** --coverage.reporter=text-summary",
     "typecheck": "tsc --noEmit -p tsconfig.json",
     "publint": "publint",