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

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,188 @@ 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 | `enableViews()` and markup, `data-fsl-view` | 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.
 
-`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.
+**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.
 
-**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.
+```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:
+
+```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" } }
+```
+
+`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).
+
+### Views: what was on screen
+
+A page is navigation. A tab, a checkout step or a dialog inside it is a view. Mark the
+ones that matter in your markup, and turn views on once at startup:
+
+```ts
+import { enableViews } from '@dasasian/firebase-structured-logger/client/views'
+
+enableViews()
+```
+
+```html
+<section data-fsl-view="payment">…</section>
+<div class="modal" data-fsl-view="Attachment">…</div>
+```
+
+An entry written while both are visible carries `view: "payment › Attachment"`. With
+nothing marked visible, there is no `view` label.
+
+- **Read when the entry is written.** The logger finds the visible marks at that moment,
+  in page order, and joins their names with ` › `. There are no open or close calls to
+  make and nothing to keep in sync: a closed dialog is simply not visible any more.
+- **Visible means what the browser says:** `checkVisibility()`, counting
+  `display: none`, `visibility: hidden` and `opacity: 0` on the mark or any parent.
+  Browsers without it (Safari before 17.4) count only `display: none`.
+- **Page order.** A modal rendered at the end of `<body>` (a React portal, a Vue
+  `<Teleport>`) comes after the page, so it reads `payment › Attachment`. If an order
+  reads wrong, move the mark.
+- **A label, never a breadcrumb.** A view is where the user is, not a step they took.
+  The click that opened the dialog is `bc.action`.
+- **What was on screen when the entry was written,** not when the trouble started. An
+  error that surfaces after a request finishes carries whatever is open then.
+- **Not part of the repeat count.** The same error in two dialogs on one screen is
+  counted as one error. Repeat summaries carry no `view`.
+- **Names are fixed words, never values.** `data-fsl-view="order"`, not
+  `"order-1042"`. The logger never reads the page's text, so a fixed name never carries
+  personal data. Mark places, not items: a mark on every row of a list gives
+  `row › row › row …`.
+- **Browser entries only.** Entries your Cloud Functions write never carry `view`; follow
+  the trace id to the browser entry. Browser entries sent through your log function keep
+  it.
+- **Not inside shadow DOM** — marks inside a web component's shadow root are not found.
+
+Calling `enableViews()` again does nothing more.
+
 ## Timing: when something is too slow
 
 Some failures never throw. A loading screen waits on eight pieces, one of them takes 30
@@ -1021,7 +1143,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 +1151,16 @@ 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 { enableViews } from '@dasasian/firebase-structured-logger/client/views'
+enableViews()                                                    // see "Views: what was on screen"
 
 import { trace, startTrace, configureTraces } from '@dasasian/firebase-structured-logger/client/timing'
 configureTraces({ name: { warnAfterMs?, steps?: { step: ms } } })   // see "Timing"
@@ -1053,6 +1183,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,58 @@ 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;
+/** Set by `enableViews()`, never by the core itself. A later call replaces the reader. */
+export declare function setViewReader(reader: () => string | undefined): void;
+/** What was on screen right now, or `undefined` when `enableViews()` was never called. */
+export declare function getActiveView(): string | 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;AAID,0FAA0F;AAC1F,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,MAAM,GAAG,SAAS,GAAG,IAAI,CAEpE;AAED,0FAA0F;AAC1F,wBAAgB,aAAa,IAAI,MAAM,GAAG,SAAS,CAElD;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,21 @@
 "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.setViewReader = setViewReader;
+exports.getActiveView = getActiveView;
+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 +33,97 @@ 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;
 }
+let viewReader;
+/** Set by `enableViews()`, never by the core itself. A later call replaces the reader. */
+function setViewReader(reader) {
+    viewReader = reader;
+}
+/** What was on screen right now, or `undefined` when `enableViews()` was never called. */
+function getActiveView() {
+    return viewReader?.();
+}
+/**
+ * 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 +160,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":"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"}
+{"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,12 @@ 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)(),
+            view: (0, breadcrumbs_1.getActiveView)(),
             route: nav?.route,
             path: nav?.path,
             routeSource: nav?.routeSource,
@@ -274,6 +270,7 @@ class Logger {
             releaseId: summary.releaseId ?? this.config.releaseId,
             userId: summary.userId,
             screen: summary.screen,
+            view: undefined,
             errorType: summary.errorType,
             repeatOf: summary.repeatOf,
             repeatCount: String(summary.repeatCount),