@navieo/core

Framework-agnostic SDK utilities for Navieo. Pulled in transitively by @navieo/react — you don't install it directly.

Internal package. The public surface is @navieo/react. Anything exposed here is shared between the React SDK and the (future) framework-agnostic wrappers.

What lives here

| Module | Purpose | |---|---| | api — normalizeBaseUrl, isValidEndpoint, sanitizeInput, fetch timeout constants | Backend API client + URL/input validation | | brokenSelectorReporter | Fire-and-forget broken-selector telemetry, debounced + deduplicated | | elementObserver | MutationObserver-based DOM waiting (observeElements, observeElementDisappears, observeLinkMatchingRoute) | | logger | Browser-side logger respecting logLevel prop | | routeUtils | Route normalization helpers (re-exported from @navieo/types for backward compat) | | selectorResolver | Resolve a TourStep.target to a real DOM element using all runtime strategies | | stepValidator — validateAndNormalizeTourSteps, isTourStep | LLM output → validated TourStep[] pipeline | | storage | localStorage wrapper that no-ops in SSR + private browsing |

Install

You don't install this directly. It comes via pnpm add @navieo/react.

For monorepo development:

pnpm install
pnpm --filter @navieo/core build
pnpm --filter @navieo/core test

Architecture

See navieo-sdk/ARCHITECTURE.md for the full module map and design rules (Driver.js constraints, memoization split, dormant Stage 3 boundaries). Full SDK guide: navieo/docs/05-sdk.md in the platform repo.

License

Proprietary.