@dasasian/firebase-structured-logger 1.2.0 → 1.3.0-rc.0

package/README.md

@@ -513,7 +513,7 @@ logger.error(err, { orderId })
 |---|---|---|
 | `appId`, `releaseId` | client | your `initLogger` config |
 | `screen` | client | tracked as the user moves |
-| `route`, `path`, `routeSource` | client | with `enableNavigation()` — the route pattern, the real path, and where the pattern came from |
+| `route`, `path` | client | with navigation on — the route pattern and the real path (`routeSource` too, deprecated) |
 | `userId` | client | `setUser`, held for the session |
 | `platform` | client | user agent — `ios` / `android` / `macos` / `web` |
 | `browser` | client | user agent |
@@ -578,9 +578,10 @@ export const logger = initLogger<MyAppLabels>({ /* … */ })
 
 logger.setUser(uid, { organizationId })   // on sign in — rides every log until cleared
 logger.clearUser()                        // on sign out
-logger.setScreen('checkout')              // on navigation
 ```
 
+The screen comes from navigation — see "Navigation, automatically".
+
 **Backend** — scoped to the request:
 
 ```ts
@@ -604,10 +605,9 @@ from [setup](#logging-from-your-cloud-functions) is the same thing without that.
 ```ts
 import { bc } from '@dasasian/firebase-structured-logger/client'
 
-bc.nav('Checkout')                              // also sets labels.screen
 bc.action('apply_discount', { code: 'SAVE10' })
 bc.state('total_recalculated', { total: 42.00 })
-bc.error('ValidationError', { field: 'price' })
+bc.handledError('draft_save_failed', { attempt: 1 })   // an error you handled and did not log
 ```
 
 A stack trace tells you where the code broke. It cannot tell you what the person did to
@@ -615,66 +615,143 @@ get there, which is usually the part you need to reproduce it. Breadcrumbs are t
 a rolling record of the last steps, attached automatically to every error and every piece
 of feedback, with no correlation work on your side.
 
-Drop a `bc.action` before anything that can fail and a `bc.nav` on every screen change, and
-`total is wrong` arrives as `navigate_Checkout · apply_discount · total_recalculated ·
-tap_place_order`.
+Turn on navigation, drop a `bc.action` before anything that can fail, and `total is wrong`
+arrives as `Checkout · apply_discount · total_recalculated · tap_place_order`.
 
 The trail is capped at **50 entries** and **5 minutes** — old enough to cover the steps that
 led here, short enough that it stays the current attempt rather than the whole session, and
 bounded so a long-lived tab cannot grow it without limit. It lives in memory only, so it
 never touches storage and never leaves the device except attached to a log you send.
 
-Breadcrumbs are session-global by design: one user, one path. `bc.nav()` also sets the
-current screen, so `labels.screen` stays correct without a second call.
+Breadcrumbs are session-global by design: one user, one path.
+
+**Errors and breadcrumbs.** An error you log is already in the logs, in time order with
+everything else the user did — it needs no breadcrumb too. `bc.handledError` is for the
+other kind: an error your code handled and chose not to log, like a save that failed and
+then worked on retry. It costs nothing unless something else goes wrong, and then the
+trail shows it as a clue. (`bc.error`, its old name, warns once and is removed in 2.0.)
 
 > Record the step, not the data. Breadcrumb `data` is written to your logs verbatim — keep
 > PII, tokens and card numbers out of it, the same as you would for any label.
 
 ### Navigation, automatically
 
+Where the user is has one way in for each kind of place:
+
+| What changed | Record it with | Gives |
+|---|---|---|
+| a page, and the URL changed | `enableNavigation()`, or a router adapter — automatic | one `nav` breadcrumb; `screen`, `route` and `path` labels |
+| a page, but the URL did not | `navigatedTo('Checkout')` | the same breadcrumb and labels |
+| something inside or on top of a page | markup (`data-fsl-view`, planned in #58) | a `view` label |
+
 ```ts
-import { enableNavigation } from '@dasasian/firebase-structured-logger/client/navigation'
+import { enableNavigation, navigatedTo, defaultLabelsFor } from '@dasasian/firebase-structured-logger/client/navigation'
 
 enableNavigation()
-
-// or name routes the way your router does
-enableNavigation({
-  routeFor: (path) => router.match(path)?.name,   // undefined falls back to the id rule
-})
 ```
 
 Its own entry point, so an app that never imports it ships none of it, whatever its
 bundler — and the import says plainly that it wraps `history.pushState` and
 `replaceState`, the only way to notice a single-page app changing route. Call it once,
-before or after `initLogger`. It records the current page at once and every route change
-after it, back and forward included, as a `nav` breadcrumb, and every entry carries three
-labels:
+before or after `initLogger`. It records the current page at once and every page change
+after it, back and forward included, and every entry carries:
 
 | Label | Example | Means |
 |---|---|---|
 | `route` | `/orders/:id/items` | the pattern — for grouping and counting |
 | `path` | `/orders/1042/items` | the real path — for "what went wrong for order 1042?" |
-| `routeSource` | `router` or `pattern` | whether `route` came from your `routeFor`, or from the id rule |
+| `screen` | `OrderItems`, or the route when there is no name | the page's name |
+| `routeSource` | `pattern` | **deprecated, removed in 2.0** — set only by the default labels |
+
+**The default — the id rule.** A path segment that is all digits, a UUID, a long hex
+string or a ULID becomes `:id`; anything else is kept as written, so a slug like
+`/blog/my-post` stays as it is. `screen` is the route.
+
+**Your own labels — `labelsFor`.** One function: it gets the real path and returns the
+labels for it. Whatever it returns is used exactly as returned, and a field it leaves out
+is not logged.
+
+```ts
+enableNavigation({
+  labelsFor: (path) => ({ ...defaultLabelsFor(path), screen: path.startsWith('/admin') ? 'Admin' : undefined }),
+})
+```
+
+It must be synchronous — it runs inside your router's own `pushState` — and if it throws,
+that page gets `defaultLabelsFor(path)` and the console says so once.
+
+**With React Router or Vue Router — an adapter.** Your router already knows each page's
+pattern and name, so the adapter asks it instead of guessing from the path. It listens to
+the router's own events and does not wrap `history`; `labelsFor` does not apply to it.
+
+```ts
+// Vue Router 4
+import { enableVueRouterNavigation } from '@dasasian/firebase-structured-logger/client/navigation/vue-router'
+enableVueRouterNavigation(router)
+
+// React Router 6.4+ or 7, data router (createBrowserRouter and friends)
+import { enableReactRouterNavigation } from '@dasasian/firebase-structured-logger/client/navigation/react-router'
+enableReactRouterNavigation(router)
+```
+
+| Label | Vue Router | React Router |
+|---|---|---|
+| `route` | the full pattern of the deepest match, `/orders/:id/items` | the same, joined from each match's `path`, without the `basename` |
+| `screen` | the `name` of the deepest matched route that has one | `handle.screen` of the deepest match that has one |
+| `path` | `to.path` — never the query or hash | `location.pathname` |
+
+No name anywhere in the match → `screen` is the route. Vue names that are symbols are
+skipped. One page change is one breadcrumb: a React Router redirect records only the page
+it ends on, and a Vue navigation that was blocked or cancelled records nothing.
+
+One option, `adjust`, takes the router's labels and returns the ones to log — for
+cleaning personal data out of a path:
 
-`screen` keeps its meaning — the name you give with `bc.nav` or `setScreen` — and falls
-back to `route` when you never set one, so an app that does nothing still gets a useful
-screen.
+```ts
+enableVueRouterNavigation(router, {
+  adjust: (labels) => ({ ...labels, path: labels.path?.replace(/[^/]+@[^/]+/g, ':email') }),
+})
+```
+
+Each adapter returns a function that stops it. Calling an adapter again stops the first
+one. If you call both an adapter and `enableNavigation()`, the adapter wins and the
+console says so once. Neither router is a dependency of this package: the adapter only
+reads the router you pass in.
+
+**Without URL routing** — screens that switch without the address changing — call
+`navigatedTo(screen, { route?, path? })` on each change. It records the same breadcrumb and
+labels as automatic navigation.
+
+**One breadcrumb per page change**, structured so it reads without parsing:
+
+```
+{ type: "nav", name: "OrderItems", data: { route: "/orders/:id/items", path: "/orders/1042/items" } }
+```
 
-**The id rule**, when there is no `routeFor` or it returns `undefined`: a path segment that
-is all digits, a UUID, a long hex string or a ULID becomes `:id`. Anything else is kept as
-written, so a slug like `/blog/my-post` stays as it is — no rule tells a slug from a page
-name reliably, which is what `routeFor` is for.
+`name` is the screen, else the route, else the path; `data.path` is absent when your
+`labelsFor` leaves `path` out.
 
 **What never leaves the browser:** the query string, always — it is where tokens and
 emails usually ride. The fragment too, unless it is a route: `#/orders/1042` is read as the
-path, `#section-3` or `#access_token=…` is dropped. If your paths themselves can hold
-personal data (`/users/jane@example.com`), clean them or switch `path` off:
+path, `#section-3` or `#access_token=…` is dropped. `labelsFor` receives the path already
+stripped. If your paths themselves can hold personal data, clean them there:
 
 ```ts
-enableNavigation({ cleanPath: (path) => path.replace(/[^/]+@[^/]+/g, ':email') })
-enableNavigation({ path: false })
+enableNavigation({
+  labelsFor: (path) => {
+    const labels = defaultLabelsFor(path)
+    return { ...labels, path: labels.path?.replace(/[^/]+@[^/]+/g, ':email') }
+  },
+})
 ```
 
+**With navigation on, `bc.nav` and `setScreen` are ignored** — they would record the same
+page change twice — and the console says so once.
+
+**Deprecated in 1.3, removed in 2.0:** `routeFor`, `cleanPath` and `path: false` (each
+warns once; use `labelsFor`), the `routeSource` label, and `bc.nav` / `setScreen` (use
+`enableNavigation`, or `navigatedTo` without URL routing).
+
 ## Timing: when something is too slow
 
 Some failures never throw. A loading screen waits on eight pieces, one of them takes 30
@@ -1021,7 +1098,7 @@ logger.debug(message, labels?, context?, attachments?) // suppressed in producti
 
 logger.setUser(uid, extraLabels?)
 logger.clearUser()
-logger.setScreen(screen)
+logger.setScreen(screen)                  // deprecated in 1.3 — use navigation
 logger.addBreadcrumb(type, name, data?)
 
 ```
@@ -1029,8 +1106,13 @@ logger.addBreadcrumb(type, name, data?)
 Optional helpers are separate entry points, so an app ships only what it imports:
 
 ```ts
-import { enableNavigation } from '@dasasian/firebase-structured-logger/client/navigation'
-enableNavigation({ routeFor?, cleanPath?, path? })   // see "Navigation, automatically"
+import { enableNavigation, navigatedTo, defaultLabelsFor } from '@dasasian/firebase-structured-logger/client/navigation'
+enableNavigation({ labelsFor?: (path) => ({ route?, screen?, path? }) })   // see "Navigation, automatically"
+navigatedTo(screen, { route?, path? })                                      // a page change with no URL change
+
+import { enableVueRouterNavigation } from '@dasasian/firebase-structured-logger/client/navigation/vue-router'
+import { enableReactRouterNavigation } from '@dasasian/firebase-structured-logger/client/navigation/react-router'
+const stop = enableVueRouterNavigation(router, { adjust?: (labels) => labels })      // the same for React Router
 
 import { trace, startTrace, configureTraces } from '@dasasian/firebase-structured-logger/client/timing'
 configureTraces({ name: { warnAfterMs?, steps?: { step: ms } } })   // see "Timing"
@@ -1053,6 +1135,16 @@ and are removed in 2.0:
 | `triggerTestLog()` | `sendTestLog()` |
 | `fsl upload-sourcemaps --functions=<dir>` | `--backend=<dir>` (it is not only for Cloud Functions) |
 
+**Deprecated in 1.3.** Still working in 1.x, each with a one-time console warning where
+code can warn; removed in 2.0:
+
+| Old | New |
+|---|---|
+| `enableNavigation({ routeFor })`, `({ cleanPath })`, `({ path: false })` | `enableNavigation({ labelsFor })` |
+| label `routeSource` | none — `labelsFor`'s answer is final |
+| `bc.nav(screen)`, `logger.setScreen(screen)` | `enableNavigation()`, or `navigatedTo(screen)` without URL routing |
+| `bc.error(type, data?)` | `bc.handledError(type, data?)` — only for errors you handled and did not log |
+
 `Logger` is exported as a **type only** — the client logger is a session singleton, so
 annotate with `Logger<MyAppLabels>` and construct with `initLogger()`. A second instance
 would silently share breadcrumbs, screen and the rate-limit budget while looking independent.

package/dist/client/breadcrumbs.d.ts

@@ -13,25 +13,54 @@ import type { BreadcrumbEntry, NavigationLabels } from '../shared/types';
  * would have reproduced the bug.
  */
 export declare const MAX_BREADCRUMBS = 50;
+/**
+ * Set by `enableNavigation()` and `navigatedTo()` (`client/navigation.ts`), never by
+ * the core itself — the setter a helper hands data through, mirroring `setCurrentRoute`.
+ * Once true, the legacy `bc.nav`/`setScreen` path is ignored: one page change must give
+ * exactly one `nav` breadcrumb, never two for the same event.
+ */
+export declare function setNavigationEnabled(enabled: boolean): void;
+/** Called by a router adapter's own registration/`stop()` — never by the core itself. */
+export declare function setAdapterActive(active: boolean): void;
+export declare function isAdapterActive(): boolean;
+/** Called once, by `enableNavigation()`, the first time it wraps `history`. */
+export declare function noteHistoryWrapperWired(): void;
+/** @deprecated Use `enableNavigation()`, or `navigatedTo()` without URL routing. */
 export declare function setCurrentScreen(screen: string): void;
 export declare function getCurrentScreen(): string | undefined;
 /**
- * Called by `enableNavigation()` (`client/navigation.ts`) on the current page and on
- * every route change after it — never by the core itself. Mirrors `setCurrentScreen`:
- * the one-way setter a helper hands data through, rather than the core reaching out to
- * the helper. Adds a `nav` breadcrumb named after the real path, or the route pattern
- * when `path` was omitted (`enableNavigation({ path: false })`).
+ * Called by `enableNavigation()` and `navigatedTo()` (`client/navigation.ts`) on every
+ * page change — never by the core itself. Mirrors `setNavigationEnabled`: the one-way
+ * setter a helper hands data through, rather than the core reaching out to the helper.
+ * Adds one `nav` breadcrumb named after `labels.screen`, else `labels.route`, else
+ * `labels.path`; `labels` itself is stored exactly as given, so a field left out of it
+ * stays absent from the entry labels built from `getCurrentRoute()`.
  */
 export declare function setCurrentRoute(labels: NavigationLabels): void;
-/** The current page's navigation labels, or `undefined` when `enableNavigation()` was never called. */
+/** The current page's navigation labels, or `undefined` when navigation was never turned on. */
 export declare function getCurrentRoute(): NavigationLabels | undefined;
+/**
+ * The screen to label an entry with right now — navigation's, when it has one,
+ * else the legacy `setScreen`/`bc.nav` value. Written once so the label and the
+ * repeat signature can never read two different answers to the same question.
+ */
+export declare function getActiveScreen(): string | undefined;
 export declare function addBreadcrumb(type: BreadcrumbEntry['type'], name: string, data?: Record<string, unknown>): void;
 export declare function getLastBreadcrumbs(count: number): BreadcrumbEntry[];
 export declare function clearBreadcrumbs(): void;
+/**
+ * One way in for each kind of breadcrumb (CLAUDE.md, "Where the user is"). `nav` and
+ * `error` are deprecated — `enableNavigation()`/`navigatedTo()` and `handledError`
+ * replace them — and each still works, warning once.
+ */
 export declare const bc: {
     action: (name: string, data?: Record<string, unknown>) => void;
     state: (name: string, data?: Record<string, unknown>) => void;
+    /** @deprecated Use `enableNavigation()`, or `navigatedTo()` without URL routing. */
     nav: (screen: string) => void;
+    /** @deprecated Use `bc.handledError` — only for an error your code handled and did not log. */
     error: (type: string, data?: Record<string, unknown>) => void;
+    /** An error your code handled and chose not to log — a clue if something else goes wrong. */
+    handledError: (type: string, data?: Record<string, unknown>) => void;
 };
 //# sourceMappingURL=breadcrumbs.d.ts.map

package/dist/client/breadcrumbs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"breadcrumbs.d.ts","sourceRoot":"","sources":["../../src/client/breadcrumbs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAExE;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,eAAe,KAAK,CAAA;AAMjC,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAGrD;AAED,wBAAgB,gBAAgB,IAAI,MAAM,GAAG,SAAS,CAErD;AAID;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAG9D;AAED,uGAAuG;AACvG,wBAAgB,eAAe,IAAI,gBAAgB,GAAG,SAAS,CAE9D;AAoBD,wBAAgB,aAAa,CAC3B,IAAI,EAAE,eAAe,CAAC,MAAM,CAAC,EAC7B,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,IAAI,CAQN;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,EAAE,CAKnE;AAED,wBAAgB,gBAAgB,IAAI,IAAI,CAGvC;AAED,eAAO,MAAM,EAAE;mBACE,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;kBACtC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;kBACpC,MAAM;kBACR,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CACtD,CAAA"}
+{"version":3,"file":"breadcrumbs.d.ts","sourceRoot":"","sources":["../../src/client/breadcrumbs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAGxE;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,eAAe,KAAK,CAAA;AAMjC;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAE3D;AAgBD,yFAAyF;AACzF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAGtD;AAED,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAED,+EAA+E;AAC/E,wBAAgB,uBAAuB,IAAI,IAAI,CAG9C;AAQD,oFAAoF;AACpF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAGrD;AAOD,wBAAgB,gBAAgB,IAAI,MAAM,GAAG,SAAS,CAErD;AAID;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAM9D;AAED,gGAAgG;AAChG,wBAAgB,eAAe,IAAI,gBAAgB,GAAG,SAAS,CAE9D;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,MAAM,GAAG,SAAS,CAEpD;AAoBD,wBAAgB,aAAa,CAC3B,IAAI,EAAE,eAAe,CAAC,MAAM,CAAC,EAC7B,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,IAAI,CAQN;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,EAAE,CAKnE;AAED,wBAAgB,gBAAgB,IAAI,IAAI,CAGvC;AAED;;;;GAIG;AACH,eAAO,MAAM,EAAE;mBACE,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;kBACvC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACpD,oFAAoF;kBACtE,MAAM;IACpB,+FAA+F;kBACjF,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAIpD,6FAA6F;yBACxE,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAC5D,CAAA"}

package/dist/client/breadcrumbs.js

@@ -1,13 +1,19 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.bc = exports.MAX_BREADCRUMBS = void 0;
+exports.setNavigationEnabled = setNavigationEnabled;
+exports.setAdapterActive = setAdapterActive;
+exports.isAdapterActive = isAdapterActive;
+exports.noteHistoryWrapperWired = noteHistoryWrapperWired;
 exports.setCurrentScreen = setCurrentScreen;
 exports.getCurrentScreen = getCurrentScreen;
 exports.setCurrentRoute = setCurrentRoute;
 exports.getCurrentRoute = getCurrentRoute;
+exports.getActiveScreen = getActiveScreen;
 exports.addBreadcrumb = addBreadcrumb;
 exports.getLastBreadcrumbs = getLastBreadcrumbs;
 exports.clearBreadcrumbs = clearBreadcrumbs;
+const deprecate_1 = require("../shared/deprecate");
 /**
  * How many breadcrumbs are retained — and therefore how many are sent.
  *
@@ -25,29 +31,88 @@ exports.MAX_BREADCRUMBS = 50;
 const MAX_AGE_MS = 5 * 60 * 1000; // 5 minutes
 let currentScreen;
 let breadcrumbs = [];
-function setCurrentScreen(screen) {
+/**
+ * Set by `enableNavigation()` and `navigatedTo()` (`client/navigation.ts`), never by
+ * the core itself — the setter a helper hands data through, mirroring `setCurrentRoute`.
+ * Once true, the legacy `bc.nav`/`setScreen` path is ignored: one page change must give
+ * exactly one `nav` breadcrumb, never two for the same event.
+ */
+function setNavigationEnabled(enabled) {
+    navigationEnabled = enabled;
+}
+let navigationEnabled = false;
+let adapterActive = false;
+let historyWrapperWired = false;
+let adapterWinsWarned = false;
+function warnAdapterWins() {
+    if (adapterWinsWarned)
+        return;
+    adapterWinsWarned = true;
+    console.warn('[fsl] a router adapter and enableNavigation() are both active — the adapter wins, and the history wrapper stops recording.');
+}
+/** Called by a router adapter's own registration/`stop()` — never by the core itself. */
+function setAdapterActive(active) {
+    if (active && historyWrapperWired)
+        warnAdapterWins();
+    adapterActive = active;
+}
+function isAdapterActive() {
+    return adapterActive;
+}
+/** Called once, by `enableNavigation()`, the first time it wraps `history`. */
+function noteHistoryWrapperWired() {
+    if (adapterActive)
+        warnAdapterWins();
+    historyWrapperWired = true;
+}
+function recordScreenChange(screen) {
+    if (navigationEnabled)
+        return;
     currentScreen = screen;
     addBreadcrumb('nav', `navigate_${screen}`);
 }
+/** @deprecated Use `enableNavigation()`, or `navigatedTo()` without URL routing. */
+function setCurrentScreen(screen) {
+    (0, deprecate_1.warnDeprecated)('setScreen', 'enableNavigation(), or navigatedTo() without URL routing');
+    recordScreenChange(screen);
+}
+function legacyNav(screen) {
+    (0, deprecate_1.warnDeprecated)('bc.nav', 'enableNavigation(), or navigatedTo() without URL routing');
+    recordScreenChange(screen);
+}
 function getCurrentScreen() {
     return currentScreen;
 }
 let currentRoute;
 /**
- * Called by `enableNavigation()` (`client/navigation.ts`) on the current page and on
- * every route change after it — never by the core itself. Mirrors `setCurrentScreen`:
- * the one-way setter a helper hands data through, rather than the core reaching out to
- * the helper. Adds a `nav` breadcrumb named after the real path, or the route pattern
- * when `path` was omitted (`enableNavigation({ path: false })`).
+ * Called by `enableNavigation()` and `navigatedTo()` (`client/navigation.ts`) on every
+ * page change — never by the core itself. Mirrors `setNavigationEnabled`: the one-way
+ * setter a helper hands data through, rather than the core reaching out to the helper.
+ * Adds one `nav` breadcrumb named after `labels.screen`, else `labels.route`, else
+ * `labels.path`; `labels` itself is stored exactly as given, so a field left out of it
+ * stays absent from the entry labels built from `getCurrentRoute()`.
  */
 function setCurrentRoute(labels) {
     currentRoute = labels;
-    addBreadcrumb('nav', labels.path ?? labels.route, labels.path !== undefined ? { route: labels.route } : undefined);
+    const data = {};
+    if (labels.route !== undefined)
+        data.route = labels.route;
+    if (labels.path !== undefined)
+        data.path = labels.path;
+    addBreadcrumb('nav', labels.screen ?? labels.route ?? labels.path ?? '', Object.keys(data).length > 0 ? data : undefined);
 }
-/** The current page's navigation labels, or `undefined` when `enableNavigation()` was never called. */
+/** The current page's navigation labels, or `undefined` when navigation was never turned on. */
 function getCurrentRoute() {
     return currentRoute;
 }
+/**
+ * The screen to label an entry with right now — navigation's, when it has one,
+ * else the legacy `setScreen`/`bc.nav` value. Written once so the label and the
+ * repeat signature can never read two different answers to the same question.
+ */
+function getActiveScreen() {
+    return currentRoute?.screen ?? currentScreen;
+}
 /**
  * Drop anything past the age cutoff.
  *
@@ -84,10 +149,22 @@ function clearBreadcrumbs() {
     breadcrumbs = [];
     currentScreen = undefined;
 }
+/**
+ * One way in for each kind of breadcrumb (CLAUDE.md, "Where the user is"). `nav` and
+ * `error` are deprecated — `enableNavigation()`/`navigatedTo()` and `handledError`
+ * replace them — and each still works, warning once.
+ */
 exports.bc = {
     action: (name, data) => addBreadcrumb('action', name, data),
     state: (name, data) => addBreadcrumb('state', name, data),
-    nav: (screen) => setCurrentScreen(screen),
-    error: (type, data) => addBreadcrumb('error', type, data),
+    /** @deprecated Use `enableNavigation()`, or `navigatedTo()` without URL routing. */
+    nav: (screen) => legacyNav(screen),
+    /** @deprecated Use `bc.handledError` — only for an error your code handled and did not log. */
+    error: (type, data) => {
+        (0, deprecate_1.warnDeprecated)('bc.error', 'bc.handledError');
+        addBreadcrumb('error', type, data);
+    },
+    /** An error your code handled and chose not to log — a clue if something else goes wrong. */
+    handledError: (type, data) => addBreadcrumb('error', type, data),
 };
 //# sourceMappingURL=breadcrumbs.js.map

package/dist/client/breadcrumbs.js.map

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

package/dist/client/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/client/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAgB,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAaxF,OAAO,EAQL,KAAK,eAAe,EAErB,MAAM,eAAe,CAAA;AAEtB,YAAY,EAAE,eAAe,EAAE,CAAA;AAE/B,KAAK,WAAW,GAAG,CAAC,IAAI,EAAE,UAAU,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;AAEzD,MAAM,WAAW,eAAe,CAC9B,SAAS,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAEzF,8EAA8E;IAC9E,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC,CAAA;IAClD,mFAAmF;IACnF,MAAM,CAAC,EAAE,OAAO,CAAC,SAAS,GAAG,UAAU,CAAC,CAAA;CACzC;AAED,MAAM,WAAW,gBAAgB,CAC/B,SAAS,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAEzF,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,WAAW,CAAA;IACxB,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,gBAAgB,CAAC,EAAE,eAAe,CAAA;IAClC,qCAAqC;IACrC,WAAW,CAAC,EAAE,WAAW,CAAA;CAC1B;AAgED,qBAAa,MAAM,CACjB,SAAS,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAEzF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IACpD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAQ;IACjC,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,UAAU,CAAyB;gBAE/B,MAAM,EAAE,gBAAgB,CAAC,SAAS,CAAC;IAS/C,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,IAAI;IAK5D,SAAS,IAAI,IAAI;IAMjB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI/B,aAAa,CACX,IAAI,EAAE,QAAQ,GAAG,OAAO,GAAG,KAAK,GAAG,OAAO,EAC1C,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,IAAI;IAIP,KAAK,CACH,GAAG,EAAE,OAAO,EACZ,MAAM,CAAC,EAAE,OAAO,CAAC,SAAS,GAAG,UAAU,CAAC,EACxC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC,GACjD,IAAI;IAmBP,IAAI,CACF,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,OAAO,CAAC,SAAS,GAAG,UAAU,CAAC,EACxC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC,GACjD,IAAI;IAIP,OAAO,CACL,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,OAAO,CAAC,SAAS,GAAG,UAAU,CAAC,EACxC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC,GACjD,IAAI;IAIP,KAAK,CACH,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,OAAO,CAAC,SAAS,GAAG,UAAU,CAAC,EACxC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC,GACjD,IAAI;IAIP;;;;;;;;;;;;;;OAcG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,eAAe,CAAC,SAAS,CAAC,GAAG,IAAI;YAavD,IAAI;IAoIlB,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAoB;IAEtD,iFAAiF;IACjF,oBAAoB,IAAI,IAAI;IAQ5B;;;;;;;;;;;OAWG;YACW,iBAAiB;CAgChC;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,SAAS,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EACzF,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,eAAe,CAAC,SAAS,CAAC,GAAG,IAAI,CAEzD;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAWlC;AAED,uCAAuC;AACvC,wBAAgB,cAAc,IAAI,IAAI,CAGrC;AAKD,wBAAgB,UAAU,CACxB,SAAS,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EACzF,MAAM,EAAE,gBAAgB,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC,SAAS,CAAC,CAYxD;AAED,wBAAgB,eAAe,CAC7B,SAAS,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,KACtF,MAAM,CAAC,SAAS,CAAC,CAGrB"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/client/logger.ts"],"names":[],"mappings":"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"}

package/dist/client/logger.js

@@ -105,7 +105,7 @@ class Logger {
             errorType: error.name || 'UnknownError',
             ...labels,
         };
-        void this.send(error.message, 'ERROR', errorLabels, context, attachments, (0, error_1.toErrorPayload)(error), (0, rateLimiter_1.signatureFor)(error, (0, breadcrumbs_1.getCurrentScreen)()));
+        void this.send(error.message, 'ERROR', errorLabels, context, attachments, (0, error_1.toErrorPayload)(error), (0, rateLimiter_1.signatureFor)(error, (0, breadcrumbs_1.getActiveScreen)()));
     }
     info(message, labels, context, attachments) {
         void this.send(message, 'INFO', labels, context, attachments);
@@ -146,16 +146,11 @@ class Logger {
     skipBudget = false, timestamp) {
         if (!bypassVolumeControls && severity_1.SEVERITY_ORDER[severity] > this.minLevel)
             return false;
-        // Set only by enableNavigation() (@dasasian/firebase-structured-logger/client/navigation),
-        // through the setter it calls in breadcrumbs.ts — undefined for an app that never
-        // imports that entry point.
         const nav = (0, breadcrumbs_1.getCurrentRoute)();
         const allLabels = {
             appId: this.config.appId,
             releaseId: this.config.releaseId,
-            // Falls back to the route pattern so an app that never calls setScreen/bc.nav
-            // still gets a useful screen label once navigation is enabled.
-            screen: (0, breadcrumbs_1.getCurrentScreen)() ?? nav?.route,
+            screen: (0, breadcrumbs_1.getActiveScreen)(),
             route: nav?.route,
             path: nav?.path,
             routeSource: nav?.routeSource,

package/dist/client/logger.js.map

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

package/dist/client/navigation/adapterShared.d.ts

@@ -0,0 +1,18 @@
+import type { NavigationLabels } from '../../shared/types';
+type Stop = () => void;
+/**
+ * Registers a new adapter as the one in force. The previous adapter's own `stop` runs
+ * after `activeStop` already points at the new one, so its call back into
+ * `clearAdapterStop` — guarded by identity — is a no-op rather than undoing this call.
+ */
+export declare function registerAdapterStop(stop: Stop): void;
+/** Called by an adapter's own `stop()`. Only clears state it still owns. */
+export declare function clearAdapterStop(stop: Stop): void;
+/**
+ * Wraps a router adapter's `adjust` option: its answer is used as returned, and a
+ * throwing `adjust` falls back to the router's own labels with one console warning
+ * — however many times it throws for this adapter instance.
+ */
+export declare function createAdjuster(adjust: ((labels: NavigationLabels) => NavigationLabels) | undefined): (labels: NavigationLabels) => NavigationLabels;
+export {};
+//# sourceMappingURL=adapterShared.d.ts.map

package/dist/client/navigation/adapterShared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapterShared.d.ts","sourceRoot":"","sources":["../../../src/client/navigation/adapterShared.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAE1D,KAAK,IAAI,GAAG,MAAM,IAAI,CAAA;AAItB;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAMpD;AAED,4EAA4E;AAC5E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAIjD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,gBAAgB,KAAK,gBAAgB,CAAC,GAAG,SAAS,GACnE,CAAC,MAAM,EAAE,gBAAgB,KAAK,gBAAgB,CAchD"}

package/dist/client/navigation/adapterShared.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerAdapterStop = registerAdapterStop;
+exports.clearAdapterStop = clearAdapterStop;
+exports.createAdjuster = createAdjuster;
+const breadcrumbs_1 = require("../breadcrumbs");
+let activeStop;
+/**
+ * Registers a new adapter as the one in force. The previous adapter's own `stop` runs
+ * after `activeStop` already points at the new one, so its call back into
+ * `clearAdapterStop` — guarded by identity — is a no-op rather than undoing this call.
+ */
+function registerAdapterStop(stop) {
+    const previous = activeStop;
+    activeStop = stop;
+    (0, breadcrumbs_1.setNavigationEnabled)(true);
+    (0, breadcrumbs_1.setAdapterActive)(true);
+    previous?.();
+}
+/** Called by an adapter's own `stop()`. Only clears state it still owns. */
+function clearAdapterStop(stop) {
+    if (activeStop !== stop)
+        return;
+    activeStop = undefined;
+    (0, breadcrumbs_1.setAdapterActive)(false);
+}
+/**
+ * Wraps a router adapter's `adjust` option: its answer is used as returned, and a
+ * throwing `adjust` falls back to the router's own labels with one console warning
+ * — however many times it throws for this adapter instance.
+ */
+function createAdjuster(adjust) {
+    let warned = false;
+    return (labels) => {
+        if (!adjust)
+            return labels;
+        try {
+            return adjust(labels);
+        }
+        catch (err) {
+            if (!warned) {
+                warned = true;
+                console.warn('[fsl] adjust threw — using the router\'s own labels for this page:', err instanceof Error ? err.message : err);
+            }
+            return labels;
+        }
+    };
+}
+//# sourceMappingURL=adapterShared.js.map

package/dist/client/navigation/adapterShared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapterShared.js","sourceRoot":"","sources":["../../../src/client/navigation/adapterShared.ts"],"names":[],"mappings":";;AAYA,kDAMC;AAGD,4CAIC;AAOD,wCAgBC;AAhDD,gDAAuE;AAKvE,IAAI,UAA4B,CAAA;AAEhC;;;;GAIG;AACH,SAAgB,mBAAmB,CAAC,IAAU;IAC5C,MAAM,QAAQ,GAAG,UAAU,CAAA;IAC3B,UAAU,GAAG,IAAI,CAAA;IACjB,IAAA,kCAAoB,EAAC,IAAI,CAAC,CAAA;IAC1B,IAAA,8BAAgB,EAAC,IAAI,CAAC,CAAA;IACtB,QAAQ,EAAE,EAAE,CAAA;AACd,CAAC;AAED,4EAA4E;AAC5E,SAAgB,gBAAgB,CAAC,IAAU;IACzC,IAAI,UAAU,KAAK,IAAI;QAAE,OAAM;IAC/B,UAAU,GAAG,SAAS,CAAA;IACtB,IAAA,8BAAgB,EAAC,KAAK,CAAC,CAAA;AACzB,CAAC;AAED;;;;GAIG;AACH,SAAgB,cAAc,CAC5B,MAAoE;IAEpE,IAAI,MAAM,GAAG,KAAK,CAAA;IAClB,OAAO,CAAC,MAAwB,EAAoB,EAAE;QACpD,IAAI,CAAC,MAAM;YAAE,OAAO,MAAM,CAAA;QAC1B,IAAI,CAAC;YACH,OAAO,MAAM,CAAC,MAAM,CAAC,CAAA;QACvB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,GAAG,IAAI,CAAA;gBACb,OAAO,CAAC,IAAI,CAAC,oEAAoE,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;YAC9H,CAAC;YACD,OAAO,MAAM,CAAA;QACf,CAAC;IACH,CAAC,CAAA;AACH,CAAC"}

package/dist/client/navigation/react-router.d.ts

@@ -0,0 +1,30 @@
+import type { NavigationLabels } from '../../shared/types';
+export interface ReactRouteLike {
+    path?: string;
+    handle?: unknown;
+}
+export interface ReactRouteMatchLike {
+    route: ReactRouteLike;
+}
+export interface ReactRouterStateLike {
+    location: {
+        pathname: string;
+        key: string;
+    };
+    matches: ReactRouteMatchLike[];
+}
+export interface ReactRouterLike {
+    subscribe(listener: (state: ReactRouterStateLike) => void): () => void;
+    state: ReactRouterStateLike;
+}
+export interface ReactRouterNavigationOptions {
+    /** A throwing `adjust` falls back to the router's own labels, warning once. */
+    adjust?: (labels: NavigationLabels) => NavigationLabels;
+}
+/**
+ * Needs a data router (`createBrowserRouter`, `createHashRouter`, `createMemoryRouter`).
+ * One crumb per `location.key`, so a redirect records only the page it ends on. `path`
+ * keeps the `basename`; `route` never has it. A second call stops the first.
+ */
+export declare function enableReactRouterNavigation(router: ReactRouterLike, options?: ReactRouterNavigationOptions): () => void;
+//# sourceMappingURL=react-router.d.ts.map

package/dist/client/navigation/react-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-router.d.ts","sourceRoot":"","sources":["../../../src/client/navigation/react-router.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAE1D,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,cAAc,CAAA;CACtB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAA;IAC3C,OAAO,EAAE,mBAAmB,EAAE,CAAA;CAC/B;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAA;IACtE,KAAK,EAAE,oBAAoB,CAAA;CAC5B;AAED,MAAM,WAAW,4BAA4B;IAC3C,+EAA+E;IAC/E,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,gBAAgB,CAAA;CACxD;AA2BD;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,eAAe,EACvB,OAAO,GAAE,4BAAiC,GACzC,MAAM,IAAI,CAyBZ"}

package/dist/client/navigation/react-router.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.enableReactRouterNavigation = enableReactRouterNavigation;
+const breadcrumbs_1 = require("../breadcrumbs");
+const adapterShared_1 = require("./adapterShared");
+function joinRoutePath(matches) {
+    let joined = '';
+    for (const match of matches) {
+        const path = match.route.path;
+        if (path === undefined)
+            continue;
+        joined = path.startsWith('/') ? path : `${joined}/${path}`;
+    }
+    return joined.replace(/\/{2,}/g, '/');
+}
+function deepestHandleScreen(matches) {
+    for (let i = matches.length - 1; i >= 0; i--) {
+        const handle = matches[i].route.handle;
+        if (handle && typeof handle === 'object' && typeof handle.screen === 'string') {
+            return handle.screen;
+        }
+    }
+    return undefined;
+}
+function labelsFromState(state) {
+    const route = joinRoutePath(state.matches);
+    return { route, screen: deepestHandleScreen(state.matches) ?? route, path: state.location.pathname };
+}
+/**
+ * Needs a data router (`createBrowserRouter`, `createHashRouter`, `createMemoryRouter`).
+ * One crumb per `location.key`, so a redirect records only the page it ends on. `path`
+ * keeps the `basename`; `route` never has it. A second call stops the first.
+ */
+function enableReactRouterNavigation(router, options = {}) {
+    const adjustLabels = (0, adapterShared_1.createAdjuster)(options.adjust);
+    let stopped = false;
+    let lastKey = router.state.location.key;
+    const unsubscribe = router.subscribe((state) => {
+        if (state.location.key === lastKey)
+            return;
+        lastKey = state.location.key;
+        (0, breadcrumbs_1.setCurrentRoute)(adjustLabels(labelsFromState(state)));
+    });
+    function stop() {
+        if (stopped)
+            return;
+        stopped = true;
+        unsubscribe();
+        (0, adapterShared_1.clearAdapterStop)(stop);
+    }
+    (0, adapterShared_1.registerAdapterStop)(stop);
+    if (router.state.matches.length > 0) {
+        (0, breadcrumbs_1.setCurrentRoute)(adjustLabels(labelsFromState(router.state)));
+    }
+    return stop;
+}
+//# sourceMappingURL=react-router.js.map

package/dist/client/navigation/react-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-router.js","sourceRoot":"","sources":["../../../src/client/navigation/react-router.ts"],"names":[],"mappings":";;AA0DA,kEA4BC;AAtFD,gDAAgD;AAChD,mDAAuF;AA2BvF,SAAS,aAAa,CAAC,OAA8B;IACnD,IAAI,MAAM,GAAG,EAAE,CAAA;IACf,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAA;QAC7B,IAAI,IAAI,KAAK,SAAS;YAAE,SAAQ;QAChC,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,IAAI,EAAE,CAAA;IAC5D,CAAC;IACD,OAAO,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAA;AACvC,CAAC;AAED,SAAS,mBAAmB,CAAC,OAA8B;IACzD,KAAK,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7C,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAA;QACtC,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,OAAQ,MAA+B,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YACxG,OAAQ,MAA6B,CAAC,MAAM,CAAA;QAC9C,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,SAAS,eAAe,CAAC,KAA2B;IAClD,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IAC1C,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,mBAAmB,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAA;AACtG,CAAC;AAED;;;;GAIG;AACH,SAAgB,2BAA2B,CACzC,MAAuB,EACvB,UAAwC,EAAE;IAE1C,MAAM,YAAY,GAAG,IAAA,8BAAc,EAAC,OAAO,CAAC,MAAM,CAAC,CAAA;IACnD,IAAI,OAAO,GAAG,KAAK,CAAA;IACnB,IAAI,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAA;IAEvC,MAAM,WAAW,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE;QAC7C,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,KAAK,OAAO;YAAE,OAAM;QAC1C,OAAO,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAA;QAC5B,IAAA,6BAAe,EAAC,YAAY,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IACvD,CAAC,CAAC,CAAA;IAEF,SAAS,IAAI;QACX,IAAI,OAAO;YAAE,OAAM;QACnB,OAAO,GAAG,IAAI,CAAA;QACd,WAAW,EAAE,CAAA;QACb,IAAA,gCAAgB,EAAC,IAAI,CAAC,CAAA;IACxB,CAAC;IAED,IAAA,mCAAmB,EAAC,IAAI,CAAC,CAAA;IAEzB,IAAI,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpC,IAAA,6BAAe,EAAC,YAAY,CAAC,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IAC9D,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/client/navigation/vue-router.d.ts

@@ -0,0 +1,28 @@
+import type { NavigationLabels } from '../../shared/types';
+/** `path` is already the deepest match's full resolved pattern, e.g. `/orders/:id/items`. */
+export interface VueRouteRecordLike {
+    path: string;
+    name?: string | symbol;
+}
+export interface VueRouteLocationLike {
+    path: string;
+    matched: VueRouteRecordLike[];
+}
+export interface VueRouterLike {
+    afterEach(guard: (to: VueRouteLocationLike, from: VueRouteLocationLike, failure: unknown) => void): () => void;
+    currentRoute: {
+        value: VueRouteLocationLike;
+    };
+}
+export interface VueRouterNavigationOptions {
+    /** A throwing `adjust` falls back to the router's own labels, warning once. */
+    adjust?: (labels: NavigationLabels) => NavigationLabels;
+}
+/**
+ * Listens with `router.afterEach`; never wraps `history`. Skips a navigation that
+ * failed (`failure` truthy) — a blocked or cancelled one records no crumb. `path` is
+ * always `to.path`, never `fullPath`, so a query string or hash never reaches a label.
+ * A second call stops the first.
+ */
+export declare function enableVueRouterNavigation(router: VueRouterLike, options?: VueRouterNavigationOptions): () => void;
+//# sourceMappingURL=vue-router.d.ts.map

package/dist/client/navigation/vue-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vue-router.d.ts","sourceRoot":"","sources":["../../../src/client/navigation/vue-router.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAE1D,6FAA6F;AAC7F,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,kBAAkB,EAAE,CAAA;CAC9B;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,CACP,KAAK,EAAE,CAAC,EAAE,EAAE,oBAAoB,EAAE,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,GACtF,MAAM,IAAI,CAAA;IACb,YAAY,EAAE;QAAE,KAAK,EAAE,oBAAoB,CAAA;KAAE,CAAA;CAC9C;AAED,MAAM,WAAW,0BAA0B;IACzC,+EAA+E;IAC/E,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,gBAAgB,CAAA;CACxD;AAgBD;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,aAAa,EACrB,OAAO,GAAE,0BAA+B,GACvC,MAAM,IAAI,CAwBZ"}

package/dist/client/navigation/vue-router.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.enableVueRouterNavigation = enableVueRouterNavigation;
+const breadcrumbs_1 = require("../breadcrumbs");
+const adapterShared_1 = require("./adapterShared");
+function deepestNamedScreen(matched) {
+    for (let i = matched.length - 1; i >= 0; i--) {
+        const name = matched[i].name;
+        if (typeof name === 'string')
+            return name;
+    }
+    return undefined;
+}
+function labelsFromRoute(to) {
+    const deepest = to.matched[to.matched.length - 1];
+    const route = deepest ? deepest.path : to.path;
+    return { route, screen: deepestNamedScreen(to.matched) ?? route, path: to.path };
+}
+/**
+ * Listens with `router.afterEach`; never wraps `history`. Skips a navigation that
+ * failed (`failure` truthy) — a blocked or cancelled one records no crumb. `path` is
+ * always `to.path`, never `fullPath`, so a query string or hash never reaches a label.
+ * A second call stops the first.
+ */
+function enableVueRouterNavigation(router, options = {}) {
+    const adjustLabels = (0, adapterShared_1.createAdjuster)(options.adjust);
+    let stopped = false;
+    const unregister = router.afterEach((to, _from, failure) => {
+        if (failure)
+            return;
+        (0, breadcrumbs_1.setCurrentRoute)(adjustLabels(labelsFromRoute(to)));
+    });
+    function stop() {
+        if (stopped)
+            return;
+        stopped = true;
+        unregister();
+        (0, adapterShared_1.clearAdapterStop)(stop);
+    }
+    (0, adapterShared_1.registerAdapterStop)(stop);
+    const startingRoute = router.currentRoute.value;
+    if (startingRoute.matched.length > 0) {
+        (0, breadcrumbs_1.setCurrentRoute)(adjustLabels(labelsFromRoute(startingRoute)));
+    }
+    return stop;
+}
+//# sourceMappingURL=vue-router.js.map

package/dist/client/navigation/vue-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vue-router.js","sourceRoot":"","sources":["../../../src/client/navigation/vue-router.ts"],"names":[],"mappings":";;AA+CA,8DA2BC;AA1ED,gDAAgD;AAChD,mDAAuF;AA0BvF,SAAS,kBAAkB,CAAC,OAA6B;IACvD,KAAK,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7C,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;QAC5B,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAA;IAC3C,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,SAAS,eAAe,CAAC,EAAwB;IAC/C,MAAM,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IACjD,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAA;IAC9C,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,kBAAkB,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,CAAA;AAClF,CAAC;AAED;;;;;GAKG;AACH,SAAgB,yBAAyB,CACvC,MAAqB,EACrB,UAAsC,EAAE;IAExC,MAAM,YAAY,GAAG,IAAA,8BAAc,EAAC,OAAO,CAAC,MAAM,CAAC,CAAA;IACnD,IAAI,OAAO,GAAG,KAAK,CAAA;IAEnB,MAAM,UAAU,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QACzD,IAAI,OAAO;YAAE,OAAM;QACnB,IAAA,6BAAe,EAAC,YAAY,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;IACpD,CAAC,CAAC,CAAA;IAEF,SAAS,IAAI;QACX,IAAI,OAAO;YAAE,OAAM;QACnB,OAAO,GAAG,IAAI,CAAA;QACd,UAAU,EAAE,CAAA;QACZ,IAAA,gCAAgB,EAAC,IAAI,CAAC,CAAA;IACxB,CAAC;IAED,IAAA,mCAAmB,EAAC,IAAI,CAAC,CAAA;IAEzB,MAAM,aAAa,GAAG,MAAM,CAAC,YAAY,CAAC,KAAK,CAAA;IAC/C,IAAI,aAAa,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrC,IAAA,6BAAe,EAAC,YAAY,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC,CAAC,CAAA;IAC/D,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/client/navigation.d.ts

@@ -1,3 +1,4 @@
+import type { NavigationLabels } from '../shared/types';
 /**
  * `@dasasian/firebase-structured-logger/client/navigation` — its own entry point
  * (see CLAUDE.md, "Optional client helpers are separate entry points") so an app
@@ -5,14 +6,23 @@
  * once, before or after `initLogger`. See README, "Navigation, automatically".
  */
 export interface NavigationOptions {
-    /** Names the route the way your router does. Returning `undefined` falls back to the id rule. */
+    /**
+     * The single customisation point. Receives the real path, already stripped of its
+     * query string and any non-route fragment, and returns the labels for that page —
+     * used exactly as returned; a field left out is not logged. Must be synchronous: it
+     * runs inside your router's own `pushState`. If it throws, that page gets
+     * `defaultLabelsFor(path)` and the console warns once, however often it throws.
+     */
+    labelsFor?: (path: string) => NavigationLabels;
+    /** @deprecated Use `labelsFor`. Names the route the way your router does. Returning `undefined` falls back to the id rule. */
     routeFor?: (path: string) => string | undefined;
     /**
-     * Runs on the real path before it is stored and before `routeFor`/the id rule sees it —
-     * for paths that can themselves hold personal data, e.g. `/users/jane@example.com`.
+     * @deprecated Use `labelsFor`. Runs on the real path before it is stored and before
+     * `routeFor`/the id rule sees it — for paths that can themselves hold personal data,
+     * e.g. `/users/jane@example.com`.
      */
     cleanPath?: (path: string) => string;
-    /** `false` omits the `path` label, and keeps the real path out of breadcrumbs too. */
+    /** @deprecated Use `labelsFor`. `false` omits the `path` label, and keeps the real path out of breadcrumbs too. */
     path?: false;
 }
 /**
@@ -23,6 +33,21 @@ export interface NavigationOptions {
  * no rule tells those from a page name reliably, which is what `routeFor` is for.
  */
 export declare function routePattern(path: string): string;
+/**
+ * The labels `enableNavigation()` gives when no `labelsFor` is passed: the id-rule
+ * `route`, `screen` equal to `route`, the stripped `path`, and the deprecated
+ * `routeSource: 'pattern'`.
+ */
+export declare function defaultLabelsFor(path: string): NavigationLabels;
+/**
+ * The same breadcrumb and labels as automatic navigation (`enableNavigation()`), for a
+ * screen that changes without the URL changing. Counts as navigation being on, the same
+ * as `enableNavigation()` — the legacy `bc.nav`/`setScreen` path is ignored from then on.
+ */
+export declare function navigatedTo(screen: string, extra?: {
+    route?: string;
+    path?: string;
+}): void;
 /**
  * Turns on automatic navigation tracking for the session. The first call wraps
  * `history.pushState`/`replaceState` and listens for `popstate`, then records the

package/dist/client/navigation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../../src/client/navigation.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,iGAAiG;IACjG,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAA;IAC/C;;;OAGG;IACH,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;IACpC,sFAAsF;IACtF,IAAI,CAAC,EAAE,KAAK,CAAA;CACb;AAWD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKjD;AA4DD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,GAAE,iBAAsB,GAAG,IAAI,CASzE"}
+{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../../src/client/navigation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAEvD;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,gBAAgB,CAAA;IAC9C,8HAA8H;IAC9H,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAA;IAC/C;;;;OAIG;IACH,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;IACpC,mHAAmH;IACnH,IAAI,CAAC,EAAE,KAAK,CAAA;CACb;AAWD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKjD;AAiBD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAG/D;AAqCD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,IAAI,CAM/F;AA8BD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,GAAE,iBAAsB,GAAG,IAAI,CAezE"}

package/dist/client/navigation.js

@@ -1,8 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.routePattern = routePattern;
+exports.defaultLabelsFor = defaultLabelsFor;
+exports.navigatedTo = navigatedTo;
 exports.enableNavigation = enableNavigation;
 const breadcrumbs_1 = require("./breadcrumbs");
+const deprecate_1 = require("../shared/deprecate");
 const ALL_DIGITS = /^\d+$/;
 const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 const LONG_HEX = /^[0-9a-f]{16,}$/i;
@@ -32,17 +35,61 @@ function realPath(location) {
     const raw = location.hash.startsWith('#/') ? location.hash.slice(1) : location.pathname;
     return raw.split('?')[0] ?? raw;
 }
-let options = {};
-let wired = false;
-function labelsFor(path) {
+/**
+ * The labels `enableNavigation()` gives when no `labelsFor` is passed: the id-rule
+ * `route`, `screen` equal to `route`, the stripped `path`, and the deprecated
+ * `routeSource: 'pattern'`.
+ */
+function defaultLabelsFor(path) {
+    const route = routePattern(path);
+    return { route, screen: route, path, routeSource: 'pattern' };
+}
+function legacyLabelsFor(path) {
     const cleaned = options.cleanPath ? options.cleanPath(path) : path;
     const fromRouter = options.routeFor?.(cleaned);
     const route = fromRouter ?? routePattern(cleaned);
     const routeSource = fromRouter !== undefined ? 'router' : 'pattern';
     return options.path === false ? { route, routeSource } : { route, path: cleaned, routeSource };
 }
+let options = {};
+let wired = false;
+let labelsForThrew = false;
+function resolveLabelsFor(path) {
+    if (options.labelsFor) {
+        try {
+            return options.labelsFor(path);
+        }
+        catch (err) {
+            if (!labelsForThrew) {
+                labelsForThrew = true;
+                console.warn('[fsl] labelsFor threw — using the default labels for this page:', err instanceof Error ? err.message : err);
+            }
+            return defaultLabelsFor(path);
+        }
+    }
+    if (options.routeFor !== undefined || options.cleanPath !== undefined || options.path === false) {
+        return legacyLabelsFor(path);
+    }
+    return defaultLabelsFor(path);
+}
 function recordNavigation() {
-    (0, breadcrumbs_1.setCurrentRoute)(labelsFor(realPath(location)));
+    if ((0, breadcrumbs_1.isAdapterActive)())
+        return;
+    (0, breadcrumbs_1.setCurrentRoute)(resolveLabelsFor(realPath(location)));
+}
+/**
+ * The same breadcrumb and labels as automatic navigation (`enableNavigation()`), for a
+ * screen that changes without the URL changing. Counts as navigation being on, the same
+ * as `enableNavigation()` — the legacy `bc.nav`/`setScreen` path is ignored from then on.
+ */
+function navigatedTo(screen, extra = {}) {
+    (0, breadcrumbs_1.setNavigationEnabled)(true);
+    const labels = { screen };
+    if (extra.route !== undefined)
+        labels.route = extra.route;
+    if (extra.path !== undefined)
+        labels.path = extra.path;
+    (0, breadcrumbs_1.setCurrentRoute)(labels);
 }
 // A Symbol.for registration, not a module-local Symbol — a second copy of this module
 // (two bundles on one page) must still recognize the first copy's wrapper as "ours".
@@ -76,11 +123,20 @@ function wrapHistoryMethod(name) {
  */
 function enableNavigation(newOptions = {}) {
     options = newOptions;
+    labelsForThrew = false;
+    (0, breadcrumbs_1.setNavigationEnabled)(true);
+    if (newOptions.routeFor !== undefined)
+        (0, deprecate_1.warnDeprecated)('routeFor', 'labelsFor');
+    if (newOptions.cleanPath !== undefined)
+        (0, deprecate_1.warnDeprecated)('cleanPath', 'labelsFor');
+    if (newOptions.path === false)
+        (0, deprecate_1.warnDeprecated)('path: false', 'labelsFor');
     if (typeof window === 'undefined')
         return;
     if (wired)
         return;
     wired = true;
+    (0, breadcrumbs_1.noteHistoryWrapperWired)();
     wrapHistoryMethod('pushState');
     wrapHistoryMethod('replaceState');
     window.addEventListener('popstate', recordNavigation);

package/dist/client/navigation.js.map

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

package/dist/shared/types.d.ts

@@ -8,23 +8,28 @@ export interface BaseLabels {
     releaseId?: string;
     errorType?: string;
     errorCategory?: string;
-    /** The route pattern, e.g. `/orders/:id/items`. Set by `enableNavigation()`. */
+    /** The route pattern, e.g. `/orders/:id/items`. Set by `enableNavigation()` or `navigatedTo()`. */
     route?: string;
-    /** The real path, e.g. `/orders/1042/items`. Omitted when `enableNavigation({ path: false })`. */
+    /** The real path, e.g. `/orders/1042/items`. Set by `enableNavigation()` or `navigatedTo()`. */
     path?: string;
-    /** Whether `route` came from `routeFor` or the id rule. Set by `enableNavigation()`. */
+    /**
+     * Whether `route` came from the deprecated `routeFor` or the id rule.
+     * @deprecated Removed in 2.0 — a `labelsFor` answer is final and carries no source.
+     */
     routeSource?: 'router' | 'pattern';
 }
 /**
- * What `enableNavigation()` (`@dasasian/firebase-structured-logger/client/navigation`)
- * hands to the core logger for the current page, through `setCurrentRoute` in
- * `client/breadcrumbs.ts`. `path` is absent exactly when `enableNavigation` was
- * given `{ path: false }`.
+ * What `enableNavigation()` and `navigatedTo()` (both
+ * `@dasasian/firebase-structured-logger/client/navigation`) hand to the core logger for
+ * the current page, through `setCurrentRoute` in `client/breadcrumbs.ts`. Used exactly
+ * as given — a field left out is not logged — so every field is optional.
  */
 export interface NavigationLabels {
-    route: string;
+    route?: string;
+    screen?: string;
     path?: string;
-    routeSource: 'router' | 'pattern';
+    /** @deprecated Removed in 2.0. Set only by `defaultLabelsFor()` and the deprecated `routeFor`/`cleanPath`/`path: false`. */
+    routeSource?: 'router' | 'pattern';
 }
 export interface ErrorPayload {
     message: string;

package/dist/shared/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/shared/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAA;AAE3E,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,gFAAgF;IAChF,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,kGAAkG;IAClG,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,wFAAwF;IACxF,WAAW,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAA;CACnC;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,QAAQ,GAAG,SAAS,CAAA;CAClC;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,WAAW,CAAA;IACrB,MAAM,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;IACvD,WAAW,CAAC,EAAE;QACZ,WAAW,CAAC,EAAE,eAAe,EAAE,CAAA;QAC/B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QACjC,KAAK,CAAC,EAAE,YAAY,CAAA;KACrB,CAAA;IACD,2GAA2G;IAC3G,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACpC;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,QAAQ,GAAG,OAAO,GAAG,KAAK,GAAG,OAAO,CAAA;IAC1C,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC/B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/shared/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAA;AAE3E,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,mGAAmG;IACnG,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,gGAAgG;IAChG,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;;OAGG;IACH,WAAW,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAA;CACnC;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,4HAA4H;IAC5H,WAAW,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAA;CACnC;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,WAAW,CAAA;IACrB,MAAM,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;IACvD,WAAW,CAAC,EAAE;QACZ,WAAW,CAAC,EAAE,eAAe,EAAE,CAAA;QAC/B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QACjC,KAAK,CAAC,EAAE,YAAY,CAAA;KACrB,CAAA;IACD,2GAA2G;IAC3G,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACpC;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,QAAQ,GAAG,OAAO,GAAG,KAAK,GAAG,OAAO,CAAA;IAC1C,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC/B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dasasian/firebase-structured-logger",
-  "version": "1.2.0",
+  "version": "1.3.0-rc.0",
   "description": "Structured logging for Firebase and Google Cloud web apps — browser, backend, and tools",
   "license": "MIT",
   "author": "Dasasian",
@@ -38,6 +38,14 @@
       "types": "./dist/client/navigation.d.ts",
       "default": "./dist/client/navigation.js"
     },
+    "./client/navigation/vue-router": {
+      "types": "./dist/client/navigation/vue-router.d.ts",
+      "default": "./dist/client/navigation/vue-router.js"
+    },
+    "./client/navigation/react-router": {
+      "types": "./dist/client/navigation/react-router.d.ts",
+      "default": "./dist/client/navigation/react-router.js"
+    },
     "./client/timing": {
       "types": "./dist/client/timing.d.ts",
       "default": "./dist/client/timing.js"
@@ -59,6 +67,12 @@
       "client/navigation": [
         "dist/client/navigation.d.ts"
       ],
+      "client/navigation/vue-router": [
+        "dist/client/navigation/vue-router.d.ts"
+      ],
+      "client/navigation/react-router": [
+        "dist/client/navigation/react-router.d.ts"
+      ],
       "client/timing": [
         "dist/client/timing.d.ts"
       ],
@@ -82,7 +96,7 @@
     "build:watch": "tsc --watch",
     "clean": "rm -rf dist",
     "typecheck": "tsc --noEmit && tsc --noEmit -p tsconfig.check.json",
-    "test": "tsx tests/logger.ts && tsx tests/browserBundle.ts && tsx tests/breadcrumbs.ts && tsx tests/navigation.ts && tsx tests/timing.ts && tsx tests/rateLimiter.ts && tsx tests/errorHandler.ts && tsx tests/attachments.ts && tsx tests/feedback.ts && tsx tests/paths.ts && tsx tests/loadsWithoutOptionalPeers.ts && tsx tests/sourceMapStripping.ts && FUNCTIONS_EMULATOR=true tsx tests/errorPayload.ts && FUNCTIONS_EMULATOR=true tsx tests/requestLogger.ts && FUNCTIONS_EMULATOR=true tsx tests/serverTrace.ts && FUNCTIONS_EMULATOR=true tsx tests/handler.ts && FUNCTIONS_EMULATOR=true tsx tests/httpHandler.ts && FUNCTIONS_EMULATOR=true tsx tests/symbolication.ts && FUNCTIONS_EMULATOR=true tsx tests/publicApi.ts && FUNCTIONS_EMULATOR=true tsx tests/configureTwice.ts && FUNCTIONS_EMULATOR=true tsx tests/deprecatedNames.ts && tsx tests/productionOutput.ts && tsx tests/storageChain.ts && tsx tests/entrySize.ts && tsx tests/handlerSymbolication.ts && tsx tests/releaseResolution.ts && tsx tests/sourceMapCacheBounds.ts && tsx tests/doctor.ts && tsx tests/doctorProcess.ts && tsx tests/uploadSourcemapsBackend.ts",
+    "test": "tsx tests/logger.ts && tsx tests/browserBundle.ts && tsx tests/breadcrumbs.ts && tsx tests/navigation.ts && tsx tests/vueRouterNavigation.ts && tsx tests/reactRouterNavigation.ts && tsx tests/timing.ts && tsx tests/rateLimiter.ts && tsx tests/errorHandler.ts && tsx tests/attachments.ts && tsx tests/feedback.ts && tsx tests/paths.ts && tsx tests/loadsWithoutOptionalPeers.ts && tsx tests/sourceMapStripping.ts && FUNCTIONS_EMULATOR=true tsx tests/errorPayload.ts && FUNCTIONS_EMULATOR=true tsx tests/requestLogger.ts && FUNCTIONS_EMULATOR=true tsx tests/serverTrace.ts && FUNCTIONS_EMULATOR=true tsx tests/handler.ts && FUNCTIONS_EMULATOR=true tsx tests/httpHandler.ts && FUNCTIONS_EMULATOR=true tsx tests/symbolication.ts && FUNCTIONS_EMULATOR=true tsx tests/publicApi.ts && FUNCTIONS_EMULATOR=true tsx tests/configureTwice.ts && FUNCTIONS_EMULATOR=true tsx tests/deprecatedNames.ts && tsx tests/productionOutput.ts && tsx tests/storageChain.ts && tsx tests/entrySize.ts && tsx tests/handlerSymbolication.ts && tsx tests/releaseResolution.ts && tsx tests/sourceMapCacheBounds.ts && tsx tests/doctor.ts && tsx tests/doctorProcess.ts && tsx tests/uploadSourcemapsBackend.ts",
     "prepublishOnly": "npm run clean && npm run build",
     "smoke:deploy": "cd smoke/functions && npm install && npm run build && cd .. && firebase deploy --only functions --project $(grep '^FSL_SMOKE_PROJECT=' .env.local | cut -d= -f2)",
     "smoke:deploy:run": "bash smoke/cloudrun/deploy.sh",
@@ -119,8 +133,14 @@
     "firebase-admin": "^14.5.0",
     "firebase-functions": "^7.4.0",
     "jsdom": "^30.1.1",
+    "react": "^19.3.0",
+    "react-dom": "^19.3.0",
+    "react-router-6": "npm:react-router@^6.30",
+    "react-router-7": "npm:react-router@^7.18",
     "tsx": "^4.23.15",
-    "typescript": "~6.0.3"
+    "typescript": "~6.0.3",
+    "vue": "^3.5.43",
+    "vue-router": "^4.6.4"
   },
   "engines": {
     "node": ">=22"

package/skills/logs/SKILL.md

@@ -58,23 +58,22 @@ Using the Explore agent's output, check the target file against the rules below.
 Breadcrumbs reconstruct what the user was doing before an error — a session timeline, not just a wrapper around service calls. They belong primarily in components and screens, not service files.
 
 UX-layer breadcrumbs to check for (flag if missing):
-- Screen/route changes → `bc.nav('ScreenName')`
-- Modal open/close → `bc.action('open_item_modal', { itemId })`
-- Tab switches → `bc.action('switch_tab', { tab })`
+- Page changes → `enableNavigation()` once at startup (or `navigatedTo('ScreenName')` when the URL does not change). Flag hand-written `bc.nav` / `setScreen` — deprecated, and ignored once navigation is on
+- Opening a modal or switching a tab → `bc.action('open_item_modal', { itemId })`, `bc.action('switch_tab', { tab })` — the step the user took
 - Explicit user decisions → `bc.action('merge_chosen')`, `bc.action('discard_changes')`
 - Scan/camera events → `bc.action('barcode_scanned', { barcode })`
 
 Service-layer breadcrumbs (secondary — useful but not sufficient on their own):
 - Before a Firestore/API call → `bc.action('save_item', { itemId })`
-- On error → `bc.error('save_failed', { itemId })`
+- An error the code handled and did not log (a retry that worked) → `bc.handledError('save_failed', { itemId })`. An error that is logged needs no breadcrumb — flag `bc.handledError` next to a `logger.error` for the same failure as redundant
 
 **A component file with no UX-layer breadcrumbs is almost certainly missing them. A service file with only service-layer breadcrumbs may be fine.**
 
 API:
 - `bc.action(name: string, data?)` — user-initiated operations and decisions
 - `bc.state(name: string, data?)` — significant state changes
-- `bc.nav(screen: string)` — screen/route changes
-- `bc.error(type: string, data?)` — when an error occurs
+- `bc.handledError(type: string, data?)` — an error handled and not logged (`bc.error` is its deprecated old name)
+- Page changes are not a `bc.*` call — see navigation below
 
 **Label completeness**
 - For each function, check which `AppLabels` fields are in scope as variables
@@ -166,18 +165,26 @@ Import `bc` from `firebase-structured-logger/client`:
 ```ts
 bc.action(name: string, data?: Record<string, unknown>): void  // before operations
 bc.state(name: string, data?: Record<string, unknown>): void   // on state changes
-bc.nav(screen: string): void                                   // on navigation
-bc.error(type: string, data?: Record<string, unknown>): void   // on errors
+bc.handledError(type: string, data?: Record<string, unknown>): void   // an error handled, not logged
 ```
+`bc.nav` and `bc.error` are deprecated in 1.3 and removed in 2.0 — flag them.
 
 Import `enableNavigation` from `firebase-structured-logger/client/navigation`:
 ```ts
-enableNavigation(options?: { routeFor?: (path: string) => string | undefined; cleanPath?: (path: string) => string; path?: false }): void
+enableNavigation(options?: { labelsFor?: (path: string) => { route?: string; screen?: string; path?: string } }): void
+navigatedTo(screen: string, labels?: { route?: string; path?: string }): void
+defaultLabelsFor(path: string): { route: string; screen: string; path: string }
 ```
-- Call once at startup. Every route change becomes a `nav` breadcrumb, and every entry
-  gets `route` (the pattern, `/orders/:id`), `path` (the real path) and `routeSource`.
-- When an app has called it, do not flag a missing `bc.nav` on route changes — it is
-  automatic. Suggest it for a single-page app that hand-writes `bc.nav` everywhere.
+- Call `enableNavigation` once at startup. Every page change becomes one `nav` breadcrumb, and
+  every entry gets `route` (the pattern, `/orders/:id`), `path` (the real path) and `screen`.
+- `labelsFor` names routes the app's own way; it must be synchronous. Flag the deprecated
+  `routeFor`, `cleanPath` and `path: false` options — `labelsFor` replaces all three.
+- Suggest `navigatedTo` only for apps whose screens change without the URL changing.
+- An app on Vue Router 4 or a React Router data router (6.4+, 7) should use the adapter
+  instead: `enableVueRouterNavigation(router)` from `/client/navigation/vue-router`, or
+  `enableReactRouterNavigation(router)` from `/client/navigation/react-router`. It takes
+  names from the router (Vue route `name`, React `handle.screen`). Flag a `labelsFor` that
+  re-lists the app's routes by hand in such an app.
 - A separate import on purpose: apps that do not use it ship none of it.
 
 Import `sendFeedback` from `firebase-structured-logger/client`:

package/skills/query-logs/SKILL.md

@@ -33,7 +33,7 @@ All entries written by firebase-structured-logger include these labels:
 | `screen` | Current screen name (falls back to `route` when the app never set one) |
 | `route` | Route pattern, e.g. `/orders/:id/items` — group by this (apps using `enableNavigation`) |
 | `path` | Real path, e.g. `/orders/1042/items` — one specific page or record; query string never stored |
-| `routeSource` | `router` (the app named the route) or `pattern` (ids replaced by rule) |
+| `routeSource` | **Deprecated, removed in 2.0.** `pattern` when the default id rule made the route |
 | `trace` | On a slow-trace WARNING: the trace's name, e.g. `app_boot` |
 | `run` | On a slow-trace WARNING: tells overlapping runs of one trace apart |
 | `slow` | `trace` (the whole run passed its limit) or `step` (one step passed its own) |