@dasasian/firebase-structured-logger 1.1.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,65 +615,213 @@ 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.
 
-`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
+// 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" } }
+```
 
-**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
+seconds, and the logs say nothing — because nothing failed. Traces report exactly that
+case, and only that case: something took longer than you said it should, or never
+finished. A trace that finishes in time sends nothing at all.
+
+```ts
+import { trace, startTrace } from '@dasasian/firebase-structured-logger/client/timing'
+
+await trace('app_boot', async (boot) => {
+  const user = await boot.step('sign-in', () => signIn())
+  await Promise.all([
+    boot.step('products', () => loadProducts(user)),
+    boot.step('places', () => loadPlaces(user)),
+  ])
+})
+
+// A flow that spans functions — a screen that starts on mount and ends when its data is in
+const open = startTrace('order_open')
+await open.step('order', () => loadOrder(id))
+open.end()
+```
+
+Your code holds names only. The limits live in one place, set once at startup:
+
+```ts
+import { configureTraces } from '@dasasian/firebase-structured-logger/client/timing'
+
+configureTraces({
+  app_boot:   { warnAfterMs: 8000, steps: { products: 3000 } },
+  order_open: { warnAfterMs: 2000 },
+})
+```
+
+A trace with no limits configured is timed but never reported. Limits are read when a run
+starts, so configure before the first one.
+
+**What gets sent.** One `WARNING` per run, the moment the first limit is crossed — the
+trace's, or a step's own — while it is still running, so a step that never finishes is
+reported too. Nothing more is sent for that run afterwards.
+
 ```
+WARNING  app_boot slow: products passed 3000 ms, still waiting
+         labels.trace="app_boot"  labels.run="<id>"  labels.slow="step"  labels.step="products"
+         timing: { elapsedMs: 3000, limitMs: 3000,
+                   steps: { sign-in: 610, places: 410 }, waiting: ["products"] }
+```
+
+`labels.slow` is `"trace"` or `"step"`. Durations are in milliseconds, always in `timing`.
+`labels.run` tells two overlapping runs of the same trace apart.
+
+**What is never judged.** A browser pauses pages it is not showing: a hidden tab, a phone
+switching apps, a laptop going to sleep. Time spent paused is not your app being slow, so
+a run that was hidden at any point, or that was paused — a one-second check that arrives
+five or more seconds late — is not reported. Laptop sleep often fires no event at all,
+which is why the late check exists.
+
+**Underneath** each step is a standard `performance.mark` and `performance.measure`, so
+it shows in the browser's Performance panel and in other tools that read them. Ours are
+cleared when the run ends. A `step` after `end()`, or a second `end()`, is ignored.
+
+**On the server**, `trace` and `startTrace` come from `/functions`, with the same entry. A
+server run is judged when a step or the trace ends — there is no timer, because Cloud
+Functions and Cloud Run can throttle the CPU once a response is sent. A request that hangs
+outright is ended by the platform's timeout, which logs it. Inside `withLogging`, the entry
+carries that request's labels like any other.
+
+Traces explain the slow case; they do not measure what is normal. There are no
+percentiles here and no sampling — if you need those, that is a monitoring tool's job.
 
 ## User feedback
 
@@ -922,6 +1070,7 @@ Narrow it when you need to:
 | `labels.truncated="true"` | entries shortened to fit — the full copy is `fsl-overflow.json` |
 | `labels.repeatKey="<key>" OR labels.repeatOf="<key>"` | one repeating error: its full copies and its summaries |
 | `labels.sentLate="true"` | repeat summaries sent on a later visit |
+| `labels.trace="app_boot"` | slow runs of one trace — `labels.slow` says whether the trace or a step was late |
 
 Locally, the emulator's JSONL answers the same questions. Point
 **[firebase-mcp-server](https://github.com/dasasian/firebase-mcp-server)** at either and ask
@@ -949,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?)
 
 ```
@@ -957,8 +1106,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 { trace, startTrace, configureTraces } from '@dasasian/firebase-structured-logger/client/timing'
+configureTraces({ name: { warnAfterMs?, steps?: { step: ms } } })   // see "Timing"
 ```
 
 Also exported: `initLogger`, `getClientLogger`, `setupGlobalErrorHandler`, `handleReactError`,
@@ -978,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.
@@ -993,6 +1160,8 @@ getLogger()                       // the current request's writer, or an anonymo
 logError / logWarn / logInfo / logDebug (message, labels?, context?, attachments?)
 
 configureAttachments({ bucket?, prefix? })    // once, at module load — see Attachments
+configureTraces({ name: { warnAfterMs?, steps? } })   // once — see "Timing"
+trace(name, async (t) => { await t.step(name, fn) })   // or startTrace(name) … .end()
 
 // Receiving client logs. All three take the same source-map config:
 //   { bucket?, sourceMaps?: { bucket?, prefix? } }

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":"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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,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,