@dasasian/firebase-structured-logger 0.9.0 → 1.1.0

package/README.md

@@ -70,7 +70,19 @@ cd functions && npm install @dasasian/firebase-structured-logger
 npm install @dasasian/firebase-structured-logger
 ```
 
-Ships ESM with three entry points — `/client`, `/functions`, `/tools` — plus the `fsl` CLI. `firebase`, `firebase-admin`, and `firebase-functions` are optional peer dependencies (bring your own versions). None of them is needed to load the package; each only switches on the part that uses it — see [Without Firebase](#without-firebase).
+Ships CommonJS with TypeScript types — works from `require` and from `import`, in Node and in any bundler — with three entry points, `/client`, `/functions` and `/tools`, plus the `fsl` CLI. `firebase`, `firebase-admin`, and `firebase-functions` are optional peer dependencies (bring your own versions). None of them is needed to load the package; each only switches on the part that uses it — see [Without Firebase](#without-firebase).
+
+Installing next to **firebase-admin 13** in one command can leave two copies of
+`@google-cloud/storage` (8 for this package, 7 for firebase-admin). Both work; run
+`npm dedupe` once and npm keeps the one they share. firebase-admin 14.5 and later use
+the same Storage as this package, so there is nothing to do.
+
+### Upgrading from 0.x
+
+Nothing breaks. Eight names were renamed for the 1.0 API — `minLogLevel` became
+`minSeverity`, `bucketName` became `bucket`, and so on — and each old name still works in
+1.x, with a one-time console warning naming its replacement. They are removed in 2.0.
+The full list is in [Renamed in 1.0](#client). Run `npx fsl doctor` after upgrading.
 
 ## Setup
 
@@ -113,7 +125,7 @@ import { initLogger, createClientLogFunction } from '@dasasian/firebase-structur
 initLogger({ appId: 'my-app' })
 
 export const logFrontendEvent = createClientLogFunction({
-  bucketName: 'my-app.firebasestorage.app', // holds source maps AND attachments
+  bucket: 'my-app.firebasestorage.app', // holds source maps AND attachments
 })
 ```
 
@@ -126,13 +138,13 @@ gs://my-app.firebasestorage.app/logAttachments/{logId}/{name}
 
 Both the bucket and the prefix can be changed per half — see [Source maps](#source-maps)
 for `sourceMaps: { bucket, prefix }`, and [Attachments](#attachments) for
-`configureAttachments({ bucket, prefix })`. Omit `bucketName` entirely and both fall back
+`configureAttachments({ bucket, prefix })`. Omit `bucket` entirely and both fall back
 to your project's default bucket.
 
 **3. Wire the deploy script** — upload source maps and strip them from the hosting bundle as part of deploy. Merge into your root `package.json` scripts, keeping any existing flags like `--project`:
 
 ```json
-"deploy": "export VITE_RELEASE_ID=$(git rev-parse --short HEAD) && npm run build && npx fsl upload-sourcemaps --functions=./functions --embed-sourcemaps && firebase deploy"
+"deploy": "export VITE_RELEASE_ID=$(git rev-parse --short HEAD) && npm run build && npx fsl upload-sourcemaps --backend=./functions --embed-sourcemaps && firebase deploy"
 ```
 
 `fsl upload-sourcemaps` reads the bucket from `VITE_FIREBASE_STORAGE_BUCKET` (or `FIREBASE_STORAGE_BUCKET`) after loading `.env.local`. It uploads source maps to Cloud Storage, embeds a copy in `functions/sourcemaps/current/` for fast lookup, and deletes them from `dist/` so they are **not** served to browsers.
@@ -142,9 +154,9 @@ to your project's default bucket.
 **4. Verify it works** — prove the round trip before you trust it:
 
 ```ts
-import { triggerTestLog } from '@dasasian/firebase-structured-logger/client'
+import { sendTestLog } from '@dasasian/firebase-structured-logger/client'
 
-triggerTestLog() // wire to a dev-only button; sends one error, one warning, one info
+sendTestLog() // wire to a dev-only button; sends one error, one warning, one info
 ```
 
 Look for `labels.errorType="fsl-verify"` — in Cloud Logging once deployed, or in `dev.jsonl`
@@ -215,7 +227,7 @@ const app = express()
 app.use(express.json({ limit: '10mb' }))   // attachments ride in the body
 
 app.post('/log', createHttpLogHandler({
-  bucketName: 'my-app.firebasestorage.app', // holds source maps AND attachments
+  bucket: 'my-app.firebasestorage.app', // holds source maps AND attachments
   authorize: async (req) => {
     const header = String(req.headers.authorization ?? '')
     if (!header.startsWith('Bearer ')) return false
@@ -286,7 +298,7 @@ Nothing here needs a Firebase project — only a Google Cloud one. What changes:
   whatever credential your app already uses.
 - **`authorize`** checks your own session instead of a Firebase ID token — for example
   `authorize: (req) => sessions.isValid(req.headers.cookie)`.
-- **Storage** has no Firebase default bucket to fall back to. Name one with `bucketName`
+- **Storage** has no Firebase default bucket to fall back to. Name one with `bucket`
   (it holds source maps and attachments), and give the service's account access to it.
   Or name none: embedded maps still resolve the current release, older releases stay
   minified, and attachments are dropped — the log says so once.
@@ -328,7 +340,7 @@ A gate that throws counts as a rejection, not an opening.
   the trace id is still written, but does not join the platform's request log.
 - **No `firebase-admin`? Also optional.** Storage is only needed for older releases'
   source maps and for attachments. With `firebase-admin` installed, its Storage and
-  default bucket are used. Without it, name the bucket — `bucketName` on the handler, or
+  default bucket are used. Without it, name the bucket — `bucket` on the handler, or
   `configureAttachments({ bucket })` — and the service's own credentials are used.
 - **No Storage bucket?** You do not need one. `fsl upload-sourcemaps --embed-sourcemaps`
   without `--bucket` embeds the current release's maps into your deploy and uploads
@@ -339,6 +351,75 @@ A gate that throws counts as a rejection, not an opening.
 - **Response codes:** `204` written, `400` malformed payload, `401` gate refused, `405`
   not a POST, `500` something else. The client treats a non-2xx as a throw.
 
+## Check your setup
+
+Most of what can go wrong here goes wrong silently: logs that never arrive, stacks that
+never resolve, source code published next to the app. `fsl doctor` reads the project from
+disk and says what it finds. It needs no network and no credentials, and it only reports
+facts it can read from a file — it never guesses from your source code, so a finding is
+never a false alarm.
+
+```bash
+npx fsl doctor                                     # Firebase: reads firebase.json
+npx fsl doctor --backend=./server --dist=./dist    # anything else: say where things are
+```
+
+It prints a summary of how your setup will behave, then any findings:
+
+```
+Setup: Firebase — functions in ./functions, web build in ./dist
+
+  Logging        firebase-functions write()
+  Trace ids      from each Cloud Functions trigger
+  Storage        firebase-admin, default bucket
+  Callable       createClientLogFunction available
+
+  ⚠ duplicate-storage    2 copies of @google-cloud/storage (8.2.0 at the top level, 7.22.0 inside firebase-admin)
+                        Fix: npm dedupe
+```
+
+| Id | Level | Means |
+|---|---|---|
+| `maps-published` | error | `.map` files are in the folder hosting serves — your source code is public |
+| `node-version` | error | the backend's Node is below 22 |
+| `callable-without-firebase-functions` | error | `firebase.json` has functions, but `firebase-functions` is not installed there |
+| `could-not-check` | error | doctor could not read something it needed — including "run `npm install` first" |
+| `duplicate-storage` | warning | two copies of `@google-cloud/storage`; fix with `npm dedupe` |
+| `unsupported-peer` | warning | an installed peer (`firebase-admin`, `firebase-functions`, `firebase`) is outside the supported range |
+| `embedded-maps-without-release` | warning | maps are embedded without a `.release` marker, so an older release can resolve against the wrong map |
+
+**Exit code:** `0` when there are no errors, `1` when there is one. `--strict` also fails on
+warnings, for teams that want a spotless setup; without it, a deliberate choice like
+running with no Storage does not break CI. A check doctor could not run is always an
+error, never a pass.
+
+**`--json`** prints the same result for scripts and agents:
+
+```json
+{
+  "setup": { "kind": "firebase", "backend": "./functions", "dist": "./dist",
+             "logging": "firebase-functions", "trace": "trigger", "storage": "firebase-admin",
+             "callable": true },
+  "findings": [
+    { "id": "duplicate-storage", "level": "warning",
+      "message": "2 copies of @google-cloud/storage (8.2.0 at the top level, 7.22.0 inside firebase-admin)",
+      "fix": "npm dedupe" }
+  ],
+  "exitCode": 0
+}
+```
+
+`setup.kind` is `firebase`, `node`, `browser-only` or `backend-only`; `logging` is
+`firebase-functions`, `stdout` or `none`; `trace` is `trigger`, `header` or `none`; and
+`storage` is `firebase-admin`, `google-cloud-storage` (which still needs a bucket named in
+your code — doctor cannot see it) or `none`. The ids and fields are part of the 1.0 API:
+scripts may depend on them.
+
+What doctor does not check: anything set in your own code — the release id you pass to
+`initLogger`, a bucket name passed to a handler. Its Storage line says so — "needs a bucket named in code (not checked)" — rather than
+guessing. [`fsl verify`](https://github.com/dasasian/firebase-structured-logger/issues/25),
+planned after 1.0, will check those by sending a real log.
+
 ## Local development
 
 The Functions emulator writes the same entries to a local JSONL file instead of Cloud
@@ -432,6 +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 |
 | `userId` | client | `setUser`, held for the session |
 | `platform` | client | user agent — `ios` / `android` / `macos` / `web` |
 | `browser` | client | user agent |
@@ -548,6 +630,51 @@ current screen, so `labels.screen` stays correct without a second call.
 > 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
+
+```ts
+import { enableNavigation } 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:
+
+| 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` 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.
+
+**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.
+
+**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:
+
+```ts
+enableNavigation({ cleanPath: (path) => path.replace(/[^/]+@[^/]+/g, ':email') })
+enableNavigation({ path: false })
+```
+
 ## User feedback
 
 ```ts
@@ -609,7 +736,7 @@ labels.hasAttachments="true"     # entries that have files
 labels.logId="01J..."            # the entry whose files you are looking for
 ```
 
-By default they share the bucket passed to `createClientLogFunction({ bucketName })` — the
+By default they share the bucket passed to `createClientLogFunction({ bucket })` — the
 same one the source maps live in, falling back to the project's default bucket.
 
 Send them somewhere else with `configureAttachments`, in your functions entry point:
@@ -656,9 +783,9 @@ hold things back — so this is worth reading before you conclude something is b
 
 | Gate | Default | Where |
 |---|---|---|
-| Log budget | **50 logs**, refilling **1 per minute**; the last **20%** for errors only | client, per browser tab |
+| Log limit | bursts of up to **50 logs**, then **one log recharges every 60 s**; the last **10** for errors only | client, per browser tab |
 | Duplicates | **3** full copies of the same error, then counted and sent as a summary | client, per browser tab |
-| Client severity floor | `WARNING` in production, `DEBUG` in dev | client, `minLogLevel` |
+| Client severity floor | `WARNING` in production, `DEBUG` in dev | client, `minSeverity` |
 | Server severity floor | `WARNING` in production, `DEBUG` in the emulator | function, `minSeverity` |
 | Function concurrency | `maxInstances: 1` on `createClientLogFunction` | function |
 
@@ -667,11 +794,11 @@ initLogger({
   appId: 'my-app',
   releaseId,
   logFunction,
-  minLogLevel: 'INFO',
+  minSeverity: 'INFO',
   rateLimitOptions: {
-    sessionLimit: 50,        // the budget: how many logs can go at once
-    refillPerMinute: 1,      // how fast it comes back
-    errorReserve: 0.2,       // share of the budget only ERROR and above may spend
+    burstLimit: 50,              // how many logs can go at once
+    rechargeSecondsPerLog: 60,   // after a burst, one log recharges every 60 seconds
+    reservedForErrors: 10,       // of the burst, how many only ERROR and above may use
     duplicateLimit: 3,       // full copies of one error before counting starts
     summaryIntervalMinutes: 60,
     summaryMaxAgeDays: 7,    // how long an unsent summary waits on the device
@@ -684,21 +811,24 @@ The client's production default comes from `process.env.NODE_ENV`, which Vite re
 build time. A `define: { 'process.env': {} }` in `vite.config` — common, to quiet a library
 that expects Node — replaces the whole object instead, `NODE_ENV` reads as undefined, and
 the floor is silently `DEBUG` in production. If your config has that line, pass
-`minLogLevel` explicitly. Stating it is the safe habit either way: it is the one default
+`minSeverity` explicitly. Stating it is the safe habit either way: it is the one default
 here whose failure mode is a bill rather than a missing log.
 
-### The budget refills
+### Bursts recharge
 
-Each browser tab starts with 50 logs. Every log spends one, and one comes back each minute,
-up to 50. A reload does not reset it — the tab keeps its budget in `sessionStorage`.
+Each browser tab can send a burst of up to `burstLimit` logs (50). After that, one log
+recharges every `rechargeSecondsPerLog` seconds (60) — one at a time, so a full burst takes
+50 minutes to come back. A reload does not reset it: the tab keeps its count in
+`sessionStorage`.
 
 So a burst at start-up is fine, and a user who works in the app all afternoon is never
 silenced for long. A bug that logs in a loop is still held to about 60 entries an hour per
 user: 1,000 users stuck in such a loop for a working month stays around the 50 GiB of
 Cloud Logging that each project gets free.
 
-The last 20% of the budget is reserved: warnings can spend it down to 10, and only
-`ERROR` and above can spend the rest. A noisy warning cannot use up the room a crash needs.
+The last `reservedForErrors` logs (10) are kept for errors: warnings can use the burst down
+to 10, and only `ERROR` and above can use the rest. A value over half of `burstLimit` is
+capped at half, with one warning, so warnings always have room. A noisy warning cannot use up the room a crash needs.
 
 ### Repeats are counted, not dropped
 
@@ -742,7 +872,7 @@ messages, and may hold personal data.
 A summary is a `WARNING` with no stack, so Cloud Error Reporting sees the 3 full copies and
 not the summary. For the true count, add up `labels.repeatCount` in Cloud Logging.
 
-Summaries do not spend the log budget. There is at most one per error, per release, per user,
+Summaries do not count against the burst. There is at most one per error, per release, per user,
 per hour.
 
 ### What a dropped log looks like
@@ -751,11 +881,11 @@ The two rate limits say so in the browser console:
 
 ```
 [fsl] Duplicate counted for the next summary: TypeError: cannot read 'id' | checkout
-[fsl] Log budget empty — next log in about a minute
-[fsl] Log budget: only errors can use the reserve now
+[fsl] Log limit reached — recharging, next log in about a minute
+[fsl] Log limit: only errors can use the reserved logs now
 ```
 
-**The severity floors are silent.** Both of them — the client's `minLogLevel` and the
+**The severity floors are silent.** Both of them — the client's `minSeverity` and the
 function's `minSeverity` — simply return, with nothing written and nothing logged about it.
 
 So if an entry never arrived and there is no `[fsl]` warning in the console, it was a floor,
@@ -764,7 +894,7 @@ not a limit. In production both default to `WARNING`, which drops `DEBUG`, `INFO
 `INFO` you expected to see has two places it can vanish.
 
 `maxInstances: 1` is a deliberate cost guard on what is usually the busiest function in the
-system. Raise it (`createClientLogFunction({ bucketName, maxInstances: 5 })`) if you are
+system. Raise it (`createClientLogFunction({ bucket, maxInstances: 5 })`) if you are
 dropping client logs under load — and watch your Cloud Logging bill when you do.
 
 Feedback is exempt from every one of these. See [User feedback](#user-feedback).
@@ -785,6 +915,8 @@ Narrow it when you need to:
 | `labels.functionName:*` | server entries only |
 | `labels.releaseId="<sha>"` | one build |
 | `labels.screen="checkout"` | one screen |
+| `labels.route="/orders/:id/items"` | one route, every id (with `enableNavigation`) |
+| `labels.path="/orders/1042/items"` | one real page — that order, that user (with `enableNavigation`) |
 | `labels.feedback="true"` | user-reported issues |
 | `labels.hasAttachments="true"` | entries with files in GCS |
 | `labels.truncated="true"` | entries shortened to fit — the full copy is `fsl-overflow.json` |
@@ -819,10 +951,32 @@ logger.setUser(uid, extraLabels?)
 logger.clearUser()
 logger.setScreen(screen)
 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"
 ```
 
 Also exported: `initLogger`, `getClientLogger`, `setupGlobalErrorHandler`, `handleReactError`,
-`sendFeedback`, `triggerTestLog`, `addBreadcrumb`, `bc`.
+`sendFeedback`, `sendTestLog`, `addBreadcrumb`, `bc`.
+
+**Renamed in 1.0.** The old names still work in 1.x, each with a one-time console warning,
+and are removed in 2.0:
+
+| Old | New |
+|---|---|
+| `minLogLevel` (client `initLogger`) | `minSeverity` |
+| `bucketName` (`createClientLogHandler`, `createClientLogFunction`, `createHttpLogHandler`) | `bucket` |
+| `rateLimitOptions.sessionLimit` | `rateLimitOptions.burstLimit` |
+| `rateLimitOptions.refillPerMinute` | `rateLimitOptions.rechargeSecondsPerLog` (seconds, not a rate: `60 / refillPerMinute`) |
+| `rateLimitOptions.errorReserve` (a share) | `rateLimitOptions.reservedForErrors` (a count: `errorReserve × burstLimit`) |
+| type `ClientLogRequest` | type `LogRequest` |
+| `triggerTestLog()` | `sendTestLog()` |
+| `fsl upload-sourcemaps --functions=<dir>` | `--backend=<dir>` (it is not only for Cloud Functions) |
 
 `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
@@ -841,7 +995,7 @@ logError / logWarn / logInfo / logDebug (message, labels?, context?, attachments
 configureAttachments({ bucket?, prefix? })    // once, at module load — see Attachments
 
 // Receiving client logs. All three take the same source-map config:
-//   { bucketName?, sourceMaps?: { bucket?, prefix? } }
+//   { bucket?, sourceMaps?: { bucket?, prefix? } }
 createClientLogFunction({ …, cors?, maxInstances? })   // a ready-to-export callable
 createHttpLogHandler({ …, authorize, allowOrigin? })   // an (req, res) handler for Express etc.
 createClientLogHandler({ … })                          // the bare handler, wrap it yourself
@@ -858,13 +1012,18 @@ bare handler only if you are wrapping it in something else yourself.
 
 ```bash
 # Upload source maps to Cloud Storage and strip local .map files (run in deploy)
-npx fsl upload-sourcemaps --functions=./functions --embed-sourcemaps
+npx fsl upload-sourcemaps --backend=./functions --embed-sourcemaps
 
 # Same, to a bucket and prefix of your choosing — tell the reader the same values
-npx fsl upload-sourcemaps --functions=./functions --embed-sourcemaps --bucket=my-maps --prefix=fsl-maps
+npx fsl upload-sourcemaps --backend=./functions --embed-sourcemaps --bucket=my-maps --prefix=fsl-maps
 
 # No bucket at all: embed the current release, upload nothing
-npx fsl upload-sourcemaps --functions=./backend --embed-sourcemaps
+npx fsl upload-sourcemaps --backend=./backend --embed-sourcemaps
+
+# Check the setup from disk — no network, no credentials (see "Check your setup")
+npx fsl doctor
+npx fsl doctor --backend=./server --dist=./dist   # no firebase.json to read
+npx fsl doctor --strict --json                   # CI: fail on warnings too, machine-readable
 
 # Install the Claude Code skills into the current project (or --global, --force)
 npx fsl install-skills

package/dist/client/breadcrumbs.d.ts

@@ -1,4 +1,4 @@
-import type { BreadcrumbEntry } from '../shared/types';
+import type { BreadcrumbEntry, NavigationLabels } from '../shared/types';
 /**
  * How many breadcrumbs are retained — and therefore how many are sent.
  *
@@ -15,6 +15,16 @@ import type { BreadcrumbEntry } from '../shared/types';
 export declare const MAX_BREADCRUMBS = 50;
 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 })`).
+ */
+export declare function setCurrentRoute(labels: NavigationLabels): void;
+/** The current page's navigation labels, or `undefined` when `enableNavigation()` was never called. */
+export declare function getCurrentRoute(): NavigationLabels | 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;

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,MAAM,iBAAiB,CAAA;AAEtD;;;;;;;;;;;;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;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;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"}

package/dist/client/breadcrumbs.js

@@ -3,6 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.bc = exports.MAX_BREADCRUMBS = void 0;
 exports.setCurrentScreen = setCurrentScreen;
 exports.getCurrentScreen = getCurrentScreen;
+exports.setCurrentRoute = setCurrentRoute;
+exports.getCurrentRoute = getCurrentRoute;
 exports.addBreadcrumb = addBreadcrumb;
 exports.getLastBreadcrumbs = getLastBreadcrumbs;
 exports.clearBreadcrumbs = clearBreadcrumbs;
@@ -30,6 +32,22 @@ function setCurrentScreen(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 })`).
+ */
+function setCurrentRoute(labels) {
+    currentRoute = labels;
+    addBreadcrumb('nav', labels.path ?? labels.route, labels.path !== undefined ? { route: labels.route } : undefined);
+}
+/** The current page's navigation labels, or `undefined` when `enableNavigation()` was never called. */
+function getCurrentRoute() {
+    return currentRoute;
+}
 /**
  * Drop anything past the age cutoff.
  *

package/dist/client/breadcrumbs.js.map

@@ -1 +1 @@
-{"version":3,"file":"breadcrumbs.js","sourceRoot":"","sources":["../../src/client/breadcrumbs.ts"],"names":[],"mappings":";;;AAqBA,4CAGC;AAED,4CAEC;AAoBD,sCAYC;AAED,gDAKC;AAED,4CAGC;AAtED;;;;;;;;;;;;GAYG;AACU,QAAA,eAAe,GAAG,EAAE,CAAA;AACjC,MAAM,UAAU,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAA,CAAC,YAAY;AAE7C,IAAI,aAAiC,CAAA;AACrC,IAAI,WAAW,GAAsB,EAAE,CAAA;AAEvC,SAAgB,gBAAgB,CAAC,MAAc;IAC7C,aAAa,GAAG,MAAM,CAAA;IACtB,aAAa,CAAC,KAAK,EAAE,YAAY,MAAM,EAAE,CAAC,CAAA;AAC5C,CAAC;AAED,SAAgB,gBAAgB;IAC9B,OAAO,aAAa,CAAA;AACtB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAS,SAAS,CAAC,OAA0B,EAAE,GAAW;IACxD,MAAM,MAAM,GAAG,GAAG,GAAG,UAAU,CAAA;IAC/B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,GAAG,MAAM;QAAE,OAAO,OAAO,CAAA;IACzE,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,SAAS,GAAG,MAAM,CAAC,CAAA;AACtD,CAAC;AAED,SAAgB,aAAa,CAC3B,IAA6B,EAC7B,IAAY,EACZ,IAA8B;IAE9B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;IACtB,WAAW,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;IACtD,WAAW,GAAG,SAAS,CAAC,WAAW,EAAE,GAAG,CAAC,CAAA;IAEzC,IAAI,WAAW,CAAC,MAAM,GAAG,uBAAe,EAAE,CAAC;QACzC,WAAW,GAAG,WAAW,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,GAAG,uBAAe,CAAC,CAAA;IACvE,CAAC;AACH,CAAC;AAED,SAAgB,kBAAkB,CAAC,KAAa;IAC9C,2EAA2E;IAC3E,8BAA8B;IAC9B,WAAW,GAAG,SAAS,CAAC,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAA;IAChD,OAAO,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAA;AACnE,CAAC;AAED,SAAgB,gBAAgB;IAC9B,WAAW,GAAG,EAAE,CAAA;IAChB,aAAa,GAAG,SAAS,CAAA;AAC3B,CAAC;AAEY,QAAA,EAAE,GAAG;IAChB,MAAM,EAAE,CAAC,IAAY,EAAE,IAA8B,EAAE,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC;IAC7F,KAAK,EAAG,CAAC,IAAY,EAAE,IAA8B,EAAE,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC;IAC5F,GAAG,EAAK,CAAC,MAAc,EAAE,EAAE,CAAC,gBAAgB,CAAC,MAAM,CAAC;IACpD,KAAK,EAAG,CAAC,IAAY,EAAE,IAA8B,EAAE,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC;CAC7F,CAAA"}
+{"version":3,"file":"breadcrumbs.js","sourceRoot":"","sources":["../../src/client/breadcrumbs.ts"],"names":[],"mappings":"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"}

package/dist/client/index.d.ts

@@ -1,4 +1,4 @@
-export { initLogger, getClientLogger, sendFeedback, triggerTestLog } from './logger';
+export { initLogger, getClientLogger, sendFeedback, sendTestLog, triggerTestLog } from './logger';
 export type { Logger, InitLoggerConfig, FeedbackOptions, RateLimitConfig } from './logger';
 export { setupGlobalErrorHandler, handleReactError } from './errorHandler';
 export { addBreadcrumb, bc } from './breadcrumbs';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAMpF,YAAY,EAAE,MAAM,EAAE,gBAAgB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAC1F,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAC1E,OAAO,EAAE,aAAa,EAAE,EAAE,EAAE,MAAM,eAAe,CAAA;AACjD,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAMjG,YAAY,EAAE,MAAM,EAAE,gBAAgB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAC1F,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAC1E,OAAO,EAAE,aAAa,EAAE,EAAE,EAAE,MAAM,eAAe,CAAA;AACjD,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/client/index.js

@@ -1,10 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.bc = exports.addBreadcrumb = exports.handleReactError = exports.setupGlobalErrorHandler = exports.triggerTestLog = exports.sendFeedback = exports.getClientLogger = exports.initLogger = void 0;
+exports.bc = exports.addBreadcrumb = exports.handleReactError = exports.setupGlobalErrorHandler = exports.triggerTestLog = exports.sendTestLog = exports.sendFeedback = exports.getClientLogger = exports.initLogger = void 0;
 var logger_1 = require("./logger");
 Object.defineProperty(exports, "initLogger", { enumerable: true, get: function () { return logger_1.initLogger; } });
 Object.defineProperty(exports, "getClientLogger", { enumerable: true, get: function () { return logger_1.getClientLogger; } });
 Object.defineProperty(exports, "sendFeedback", { enumerable: true, get: function () { return logger_1.sendFeedback; } });
+Object.defineProperty(exports, "sendTestLog", { enumerable: true, get: function () { return logger_1.sendTestLog; } });
 Object.defineProperty(exports, "triggerTestLog", { enumerable: true, get: function () { return logger_1.triggerTestLog; } });
 var errorHandler_1 = require("./errorHandler");
 Object.defineProperty(exports, "setupGlobalErrorHandler", { enumerable: true, get: function () { return errorHandler_1.setupGlobalErrorHandler; } });

package/dist/client/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":";;;AAAA,mCAAoF;AAA3E,oGAAA,UAAU,OAAA;AAAE,yGAAA,eAAe,OAAA;AAAE,sGAAA,YAAY,OAAA;AAAE,wGAAA,cAAc,OAAA;AAOlE,+CAA0E;AAAjE,uHAAA,uBAAuB,OAAA;AAAE,gHAAA,gBAAgB,OAAA;AAClD,6CAAiD;AAAxC,4GAAA,aAAa,OAAA;AAAE,iGAAA,EAAE,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":";;;AAAA,mCAAiG;AAAxF,oGAAA,UAAU,OAAA;AAAE,yGAAA,eAAe,OAAA;AAAE,sGAAA,YAAY,OAAA;AAAE,qGAAA,WAAW,OAAA;AAAE,wGAAA,cAAc,OAAA;AAO/E,+CAA0E;AAAjE,uHAAA,uBAAuB,OAAA;AAAE,gHAAA,gBAAgB,OAAA;AAClD,6CAAiD;AAAxC,4GAAA,aAAa,OAAA;AAAE,iGAAA,EAAE,OAAA"}

package/dist/client/logger.d.ts

@@ -12,8 +12,10 @@ export interface InitLoggerConfig<AppLabels extends Record<string, string | unde
     appId: string;
     releaseId: string;
     logFunction: LogCallable;
-    minLogLevel?: LogSeverity;
+    minSeverity?: LogSeverity;
     rateLimitOptions?: RateLimitConfig;
+    /** @deprecated Use `minSeverity`. */
+    minLogLevel?: LogSeverity;
 }
 export declare class Logger<AppLabels extends Record<string, string | undefined> = Record<string, string | undefined>> {
     private readonly config;
@@ -71,7 +73,7 @@ export declare class Logger<AppLabels extends Record<string, string | undefined>
  */
 export declare function sendFeedback<AppLabels extends Record<string, string | undefined> = Record<string, string | undefined>>(text: string, extras?: FeedbackOptions<AppLabels>): void;
 /**
- * Trigger a test log entry to verify the logging pipeline is working end-to-end.
+ * Send a test log entry to verify the logging pipeline is working end-to-end.
  * Logs at all severities with errorType: 'fsl-verify'. Safe to call in dev only.
  *
  * After clicking, check:
@@ -79,6 +81,8 @@ export declare function sendFeedback<AppLabels extends Record<string, string | u
  * 2. Stack trace is symbolicated (points to source file, not minified bundle)
  * 3. MCP query: source: local, where: [{ field: "labels.errorType", operator: "==", value: "fsl-verify" }]
  */
+export declare function sendTestLog(): void;
+/** @deprecated Use `sendTestLog()`. */
 export declare function triggerTestLog(): void;
 export declare function initLogger<AppLabels extends Record<string, string | undefined> = Record<string, string | undefined>>(config: InitLoggerConfig<AppLabels>): Logger<AppLabels>;
 export declare function getClientLogger<AppLabels extends Record<string, string | undefined> = Record<string, string | undefined>>(): Logger<AppLabels>;

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

@@ -2,11 +2,13 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Logger = void 0;
 exports.sendFeedback = sendFeedback;
+exports.sendTestLog = sendTestLog;
 exports.triggerTestLog = triggerTestLog;
 exports.initLogger = initLogger;
 exports.getClientLogger = getClientLogger;
 const severity_1 = require("../shared/severity");
 const error_1 = require("../shared/error");
+const deprecate_1 = require("../shared/deprecate");
 const breadcrumbs_1 = require("./breadcrumbs");
 const rateLimiter_1 = require("./rateLimiter");
 /**
@@ -75,7 +77,9 @@ class Logger {
     userLabels = {};
     constructor(config) {
         this.config = config;
-        this.minLevel = severity_1.SEVERITY_ORDER[config.minLogLevel ?? defaultMinLevel()];
+        if (config.minLogLevel !== undefined)
+            (0, deprecate_1.warnDeprecated)('minLogLevel', 'minSeverity');
+        this.minLevel = severity_1.SEVERITY_ORDER[config.minSeverity ?? config.minLogLevel ?? defaultMinLevel()];
         if (config.rateLimitOptions) {
             (0, rateLimiter_1.configureRateLimiter)(config.rateLimitOptions);
         }
@@ -142,10 +146,19 @@ 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,
-            screen: (0, breadcrumbs_1.getCurrentScreen)(),
+            // 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,
+            route: nav?.route,
+            path: nav?.path,
+            routeSource: nav?.routeSource,
             userId: this.userId,
             platform: PLATFORM,
             browser: BROWSER,
@@ -166,10 +179,10 @@ class Logger {
                 console.warn(`[fsl] Duplicate counted for the next summary: ${(0, rateLimiter_1.describeSignature)(decision.signature ?? '')}`);
             }
             else if (decision.reason === 'reserve') {
-                console.warn('[fsl] Log budget: only errors can use the reserve now');
+                console.warn('[fsl] Log limit: only errors can use the reserved logs now');
             }
             else {
-                console.warn('[fsl] Log budget empty — next log in about a minute');
+                console.warn('[fsl] Log limit reached — recharging, next log in about a minute');
             }
             return false;
         }
@@ -289,7 +302,7 @@ function sendFeedback(text, extras) {
     getClientLogger().sendFeedback(text, extras);
 }
 /**
- * Trigger a test log entry to verify the logging pipeline is working end-to-end.
+ * Send a test log entry to verify the logging pipeline is working end-to-end.
  * Logs at all severities with errorType: 'fsl-verify'. Safe to call in dev only.
  *
  * After clicking, check:
@@ -297,8 +310,8 @@ function sendFeedback(text, extras) {
  * 2. Stack trace is symbolicated (points to source file, not minified bundle)
  * 3. MCP query: source: local, where: [{ field: "labels.errorType", operator: "==", value: "fsl-verify" }]
  */
-function triggerTestLog() {
-    console.info('[fsl] triggerTestLog called');
+function sendTestLog() {
+    console.info('[fsl] sendTestLog called');
     const logger = getClientLogger();
     const testError = new Error('[fsl-verify] Test error — logging pipeline check');
     console.info('[fsl] sending error log...');
@@ -307,7 +320,12 @@ function triggerTestLog() {
     logger.warning('[fsl-verify] Test warning', { errorType: 'fsl-verify' });
     console.info('[fsl] sending info log...');
     logger.info('[fsl-verify] Test info', { errorType: 'fsl-verify' });
-    console.info('[fsl] triggerTestLog scheduled — sends are fire-and-forget; check dev.jsonl in ~1-2s');
+    console.info('[fsl] sendTestLog scheduled — sends are fire-and-forget; check dev.jsonl in ~1-2s');
+}
+/** @deprecated Use `sendTestLog()`. */
+function triggerTestLog() {
+    (0, deprecate_1.warnDeprecated)('triggerTestLog', 'sendTestLog');
+    sendTestLog();
 }
 // Module-level singleton
 let instance = null;