@cross-deck/buckets 0.7.0 → 0.8.0

package/README.md

@@ -74,9 +74,24 @@ await bucket("pulse-map", async () => {
 });
 ```
 
-**3. That's it.** Open your Crossdeck dashboard and your operations are there —
-`pulse-map`, every other bucket you named, and an `unknown` row for anything you
-haven't named yet. Buckets counted them at the database driver, not in your code.
+**3. Read it back — right where you code.** Buckets writes a live readout to
+`.crossdeck/buckets.md` (biggest bucket first). Open it, or just ask your AI session
+**"read me my buckets"** — it's a plain file on disk, no dashboard required:
+
+```
+# Buckets — reads on this surface
+**32K reads** · 2026-06-19 (UTC)
+
+| bucket            | named | reads |
+| ----------------- | :---: | ----: |
+| headline-counters |   ✓   |   31K |
+| subscriptions     |   —   |  1.1K |
+```
+
+**No Crossdeck key needed for any of that.** `init()` with no `apiKey` meters locally
+and writes the readout — the free, no-account wedge. Add a key and it *also* reports
+up so the same numbers surface on your dashboard, with the drill-down, before/after,
+and read-spike alerts. (Set `mirror: false` to turn the local file off.)
 
 ---
 
@@ -332,6 +347,31 @@ primitive that the whole ecosystem can build on — so we open-sourced it, and w
 publish the rollup schema so you can consume it with any tool you like, including
 your own. **The best place to read Buckets data should be earned, never locked.**
 
+### Free with the collector — and what Crossdeck adds
+
+The collector is yours, free, forever: it meters every read on the surface you put
+it on, never costs you reads to *run*, and you can point it at your own sink and read
+the raw numbers yourself. That's a real tool on its own.
+
+Two honest limits come with going it alone — and they're exactly what Crossdeck is for:
+
+- **You see the surface you installed on.** Drop it in your server and you see server
+  reads — often the *minority*. Most apps read from the browser too (a separate
+  install), and the bill is the sum of both. **Crossdeck stitches server + browser +
+  every surface into one number**, so you stop reasoning from a slice.
+- **Reading the numbers back yourself costs a few reads** — querying your own stored
+  rollups is still a read. **Crossdeck maintains the summary and serves it to you free,
+  live, any time** — the cost tool never costs you to look.
+
+And because it's already wired in, Crossdeck turns the raw meter into the thing you
+*act* on: the **drill-down** (tag → see the next-biggest → tag again, down to the
+line), the **before/after fix verdict**, a **7-day baseline**, and **Slack alerts that
+page you before the invoice**. The numbers are identical on both sides — same counts,
+same source — Crossdeck just makes them whole, free to read, and impossible to miss.
+
+Getting there is one step you were taking anyway: **onboard, install the SDK once, and
+read-cost comes with it** — no second setup.
+
 ### Cost should page you like an exception — not surprise you like an invoice
 
 You already know what your code *should* do. You wrote the analytics pipeline; you

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { S as Sink } from './sink-DDQmzqm5.mjs';
-export { B as BucketsReport, O as OpCounts, R as ReportSink, a as ReportSinkConfig, b as ResourceCounts } from './sink-DDQmzqm5.mjs';
+import { S as Sink, B as BucketsReport } from './sink-B-i4E1fY.mjs';
+export { N as NullSink, O as OpCounts, R as ReportSink, a as ReportSinkConfig, b as ResourceCounts } from './sink-B-i4E1fY.mjs';
 
 /**
  * A resource unit — what an adapter counts. Firestore emits `read`/`write`/
@@ -112,6 +112,40 @@ declare function currentCostTag(): CostTag;
  */
 declare function bucket<T>(name: string, fn: () => T): T;
 
+declare const DEFAULT_MIRROR_DIR = ".crossdeck";
+/**
+ * Wraps an optional upstream sink. On each flush it writes the running day-total
+ * locally, THEN (if an upstream sink was given — i.e. a key) reports onward.
+ * With no upstream it is a pure local meter: the wedge, working with no account.
+ */
+declare class MirrorSink implements Sink {
+    private readonly upstream;
+    private readonly dir;
+    private acc;
+    private announced;
+    private seeded;
+    constructor(upstream: Sink | null, dir?: string);
+    private jsonPath;
+    /** Seed the running total once from an existing same-day file (survives restarts). */
+    private seed;
+    flush(report: BucketsReport): Promise<void>;
+}
+
+/**
+ * readout — renders the local file a developer (or their AI session) reads back with
+ * "read me my buckets". PURE string building: no I/O, no database reads. The node
+ * mirror (./mirror) writes this to `.crossdeck/buckets.md` on each flush, so the
+ * readout works offline, for free, with no account.
+ */
+
+/**
+ * The one line that closes every readout. Plain and factual: what the OSS shows you
+ * here, and what signing up adds — for free. No invented numbers, no urgency, no pitch.
+ */
+declare const READOUT_FOOTER: string;
+/** Render the day's coalesced report as a human/AI-readable markdown readout. */
+declare function renderReadout(report: BucketsReport): string;
+
 /**
  * @cross-deck/buckets — know exactly what every database read costs you, and who
  * caused it. A tiny, never-throws collector for Firestore.
@@ -123,8 +157,13 @@ declare function bucket<T>(name: string, fn: () => T): T;
  */
 
 interface InitOptions {
-    /** The project's `cd_sk_` SECRET key. Server-to-server only — never a browser key. */
-    apiKey: string;
+    /**
+     * The project's `cd_sk_` SECRET key. Server-to-server only — never a browser key.
+     * OPTIONAL: with no key, Buckets still meters locally and writes the readout to
+     * disk (`.crossdeck/buckets.md`) — the free, no-account wedge. Add a key and it
+     * also reports up to Crossdeck so the numbers surface on your dashboard.
+     */
+    apiKey?: string;
     /**
      * Pass the namespace from `firebase-admin/firestore` to auto-install the read
      * trap (recommended — this is what makes every read count with no per-call work).
@@ -138,14 +177,20 @@ interface InitOptions {
     flushIntervalMs?: number;
     /** Bring your own sink (self-host the rollups). Defaults to reporting up to Crossdeck. */
     sink?: Sink;
+    /**
+     * Where to write the local readout — the file "read me my buckets" reads back.
+     * Defaults to `.crossdeck`. Pass `false` to turn the local mirror off entirely.
+     */
+    mirror?: string | false;
     /** Notified when a flush fails, so a dropped window is never silent. Best-effort. */
     onError?: MeterConfig["onError"];
 }
 /**
- * Configure Buckets once, at process start. Points the meter at a sink (Crossdeck's
- * ingest by default) and — if you pass `firestore` — installs the universal read
- * trap so every read counts automatically.
+ * Configure Buckets once, at process start. Always meters locally and writes the
+ * readout to disk; if you pass `apiKey` (or your own `sink`) it ALSO reports up to
+ * Crossdeck. Pass `firestore` to install the universal read trap so every read counts
+ * automatically.
  */
-declare function init(options: InitOptions): void;
+declare function init(options?: InitOptions): void;
 
-export { type CostHint, type CostTag, type FirestoreClasses, type InitOptions, type MeterConfig, type OpType, type ResourceUnit, Sink, bucket, currentCostTag, enterCostTag, flush, init, init as initBuckets, installFirestoreMeter, record, recordDeletes, recordReads, recordWrites, refineCostTag, runWithCostTag };
+export { BucketsReport, type CostHint, type CostTag, DEFAULT_MIRROR_DIR, type FirestoreClasses, type InitOptions, type MeterConfig, MirrorSink, type OpType, READOUT_FOOTER, type ResourceUnit, Sink, bucket, currentCostTag, enterCostTag, flush, init, init as initBuckets, installFirestoreMeter, record, recordDeletes, recordReads, recordWrites, refineCostTag, renderReadout, runWithCostTag };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { S as Sink } from './sink-DDQmzqm5.js';
-export { B as BucketsReport, O as OpCounts, R as ReportSink, a as ReportSinkConfig, b as ResourceCounts } from './sink-DDQmzqm5.js';
+import { S as Sink, B as BucketsReport } from './sink-B-i4E1fY.js';
+export { N as NullSink, O as OpCounts, R as ReportSink, a as ReportSinkConfig, b as ResourceCounts } from './sink-B-i4E1fY.js';
 
 /**
  * A resource unit — what an adapter counts. Firestore emits `read`/`write`/
@@ -112,6 +112,40 @@ declare function currentCostTag(): CostTag;
  */
 declare function bucket<T>(name: string, fn: () => T): T;
 
+declare const DEFAULT_MIRROR_DIR = ".crossdeck";
+/**
+ * Wraps an optional upstream sink. On each flush it writes the running day-total
+ * locally, THEN (if an upstream sink was given — i.e. a key) reports onward.
+ * With no upstream it is a pure local meter: the wedge, working with no account.
+ */
+declare class MirrorSink implements Sink {
+    private readonly upstream;
+    private readonly dir;
+    private acc;
+    private announced;
+    private seeded;
+    constructor(upstream: Sink | null, dir?: string);
+    private jsonPath;
+    /** Seed the running total once from an existing same-day file (survives restarts). */
+    private seed;
+    flush(report: BucketsReport): Promise<void>;
+}
+
+/**
+ * readout — renders the local file a developer (or their AI session) reads back with
+ * "read me my buckets". PURE string building: no I/O, no database reads. The node
+ * mirror (./mirror) writes this to `.crossdeck/buckets.md` on each flush, so the
+ * readout works offline, for free, with no account.
+ */
+
+/**
+ * The one line that closes every readout. Plain and factual: what the OSS shows you
+ * here, and what signing up adds — for free. No invented numbers, no urgency, no pitch.
+ */
+declare const READOUT_FOOTER: string;
+/** Render the day's coalesced report as a human/AI-readable markdown readout. */
+declare function renderReadout(report: BucketsReport): string;
+
 /**
  * @cross-deck/buckets — know exactly what every database read costs you, and who
  * caused it. A tiny, never-throws collector for Firestore.
@@ -123,8 +157,13 @@ declare function bucket<T>(name: string, fn: () => T): T;
  */
 
 interface InitOptions {
-    /** The project's `cd_sk_` SECRET key. Server-to-server only — never a browser key. */
-    apiKey: string;
+    /**
+     * The project's `cd_sk_` SECRET key. Server-to-server only — never a browser key.
+     * OPTIONAL: with no key, Buckets still meters locally and writes the readout to
+     * disk (`.crossdeck/buckets.md`) — the free, no-account wedge. Add a key and it
+     * also reports up to Crossdeck so the numbers surface on your dashboard.
+     */
+    apiKey?: string;
     /**
      * Pass the namespace from `firebase-admin/firestore` to auto-install the read
      * trap (recommended — this is what makes every read count with no per-call work).
@@ -138,14 +177,20 @@ interface InitOptions {
     flushIntervalMs?: number;
     /** Bring your own sink (self-host the rollups). Defaults to reporting up to Crossdeck. */
     sink?: Sink;
+    /**
+     * Where to write the local readout — the file "read me my buckets" reads back.
+     * Defaults to `.crossdeck`. Pass `false` to turn the local mirror off entirely.
+     */
+    mirror?: string | false;
     /** Notified when a flush fails, so a dropped window is never silent. Best-effort. */
     onError?: MeterConfig["onError"];
 }
 /**
- * Configure Buckets once, at process start. Points the meter at a sink (Crossdeck's
- * ingest by default) and — if you pass `firestore` — installs the universal read
- * trap so every read counts automatically.
+ * Configure Buckets once, at process start. Always meters locally and writes the
+ * readout to disk; if you pass `apiKey` (or your own `sink`) it ALSO reports up to
+ * Crossdeck. Pass `firestore` to install the universal read trap so every read counts
+ * automatically.
  */
-declare function init(options: InitOptions): void;
+declare function init(options?: InitOptions): void;
 
-export { type CostHint, type CostTag, type FirestoreClasses, type InitOptions, type MeterConfig, type OpType, type ResourceUnit, Sink, bucket, currentCostTag, enterCostTag, flush, init, init as initBuckets, installFirestoreMeter, record, recordDeletes, recordReads, recordWrites, refineCostTag, runWithCostTag };
+export { BucketsReport, type CostHint, type CostTag, DEFAULT_MIRROR_DIR, type FirestoreClasses, type InitOptions, type MeterConfig, MirrorSink, type OpType, READOUT_FOOTER, type ResourceUnit, Sink, bucket, currentCostTag, enterCostTag, flush, init, init as initBuckets, installFirestoreMeter, record, recordDeletes, recordReads, recordWrites, refineCostTag, renderReadout, runWithCostTag };

package/dist/index.js

@@ -1,6 +1,8 @@
 'use strict';
 
 var async_hooks = require('async_hooks');
+var fs = require('fs');
+var path = require('path');
 
 // src/cost-context.ts
 var DEFAULT_TAG = {};
@@ -161,6 +163,107 @@ var ReportSink = class {
     }
   }
 };
+var NullSink = class {
+  async flush() {
+  }
+};
+
+// src/readout.ts
+var READOUT_FOOTER = "Buckets OSS shows the reads on this surface. Sign up to Crossdeck (free) to see every surface in one view, drill any bucket down to the exact query, track a fix before and after, and get paged when reads spike \u2014 cross-deck.com";
+function fmt(n) {
+  if (n >= 1e6) return (n / 1e6).toFixed(2) + "M";
+  if (n >= 1e4) return Math.round(n / 1e3) + "K";
+  if (n >= 1e3) return (n / 1e3).toFixed(1) + "K";
+  return String(Math.round(n));
+}
+function isUntagged(label) {
+  const root = label.split(">")[0];
+  return root.startsWith("col:") || root === "uncategorized" || root === "unknown";
+}
+function displayLabel(label) {
+  return label.split(">").map((s) => s.startsWith("col:") ? s.slice(4) : s).join(" \u203A ");
+}
+function renderReadout(report) {
+  const entries = Object.entries(report.byLabel ?? {}).map(([label, counts]) => ({ label, reads: counts.read ?? 0 })).filter((e) => e.reads > 0).sort((a, b) => b.reads - a.reads);
+  const total = entries.reduce((s, e) => s + e.reads, 0);
+  const out = [];
+  out.push(`# Buckets \u2014 reads on this surface`);
+  out.push(``);
+  out.push(`**${fmt(total)} reads** \xB7 ${report.date} (UTC)`);
+  out.push(``);
+  if (entries.length === 0) {
+    out.push(`No reads metered yet \u2014 install the collector and let your app serve some traffic.`);
+  } else {
+    out.push(`| bucket | named | reads |`);
+    out.push(`| --- | :---: | ---: |`);
+    for (const e of entries) {
+      out.push(`| ${displayLabel(e.label)} | ${isUntagged(e.label) ? "\u2014" : "\u2713"} | ${fmt(e.reads)} |`);
+    }
+  }
+  out.push(``);
+  out.push(`---`);
+  out.push(READOUT_FOOTER);
+  out.push(``);
+  return out.join("\n");
+}
+
+// src/mirror.ts
+var DEFAULT_MIRROR_DIR = ".crossdeck";
+function mergeInto(target, src) {
+  if (!src) return;
+  for (const [key, counts] of Object.entries(src)) {
+    const bag = target[key] ??= {};
+    for (const [res, n] of Object.entries(counts)) {
+      if (typeof n === "number") bag[res] = (bag[res] ?? 0) + n;
+    }
+  }
+}
+var MirrorSink = class {
+  constructor(upstream, dir = DEFAULT_MIRROR_DIR) {
+    this.upstream = upstream;
+    this.dir = dir;
+  }
+  upstream;
+  dir;
+  acc = null;
+  announced = false;
+  seeded = false;
+  jsonPath() {
+    return path.join(this.dir, "buckets.json");
+  }
+  /** Seed the running total once from an existing same-day file (survives restarts). */
+  seed(date) {
+    if (this.seeded) return;
+    this.seeded = true;
+    try {
+      const prior = JSON.parse(fs.readFileSync(this.jsonPath(), "utf8"));
+      if (prior?.date === date && prior.byLabel) this.acc = prior;
+    } catch {
+    }
+  }
+  async flush(report) {
+    try {
+      this.seed(report.date);
+      if (!this.acc || this.acc.date !== report.date) {
+        this.acc = { date: report.date, byLabel: {}, byHour: {}, byMinute: {} };
+      }
+      mergeInto(this.acc.byLabel, report.byLabel);
+      mergeInto(this.acc.byHour ??= {}, report.byHour);
+      mergeInto(this.acc.byMinute ??= {}, report.byMinute);
+      fs.mkdirSync(this.dir, { recursive: true });
+      fs.writeFileSync(path.join(this.dir, "buckets.md"), renderReadout(this.acc));
+      fs.writeFileSync(this.jsonPath(), JSON.stringify(this.acc, null, 2));
+      if (!this.announced) {
+        this.announced = true;
+        console.log(
+          `Buckets: readout at ${path.join(this.dir, "buckets.md")} \u2014 open it, or ask your AI session to "read me my buckets".`
+        );
+      }
+    } catch {
+    }
+    if (this.upstream) await this.upstream.flush(report);
+  }
+};
 
 // src/adapters/firestore.ts
 var installed = false;
@@ -282,12 +385,17 @@ function installFirestoreMeter(classes) {
 }
 
 // src/index.ts
-function init(options) {
-  const sink2 = options.sink ?? new ReportSink({ apiKey: options.apiKey, endpoint: options.endpoint });
+function init(options = {}) {
+  const upstream = options.sink ?? (options.apiKey ? new ReportSink({ apiKey: options.apiKey, endpoint: options.endpoint }) : null);
+  const sink2 = options.mirror === false ? upstream ?? new NullSink() : new MirrorSink(upstream, typeof options.mirror === "string" ? options.mirror : DEFAULT_MIRROR_DIR);
   configureMeter({ sink: sink2, flushIntervalMs: options.flushIntervalMs, onError: options.onError });
   if (options.firestore) installFirestoreMeter(options.firestore);
 }
 
+exports.DEFAULT_MIRROR_DIR = DEFAULT_MIRROR_DIR;
+exports.MirrorSink = MirrorSink;
+exports.NullSink = NullSink;
+exports.READOUT_FOOTER = READOUT_FOOTER;
 exports.ReportSink = ReportSink;
 exports.bucket = bucket;
 exports.currentCostTag = currentCostTag;
@@ -301,6 +409,7 @@ exports.recordDeletes = recordDeletes;
 exports.recordReads = recordReads;
 exports.recordWrites = recordWrites;
 exports.refineCostTag = refineCostTag;
+exports.renderReadout = renderReadout;
 exports.runWithCostTag = runWithCostTag;
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/cost-context.ts","../src/cost-meter.ts","../src/sink.ts","../src/adapters/firestore.ts","../src/index.ts"],"names":["AsyncLocalStorage","sink"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * cost-context — the request-scoped tag every counted operation attributes\n * itself to. Set it ONCE at a boundary (or wrap a path with `bucket()`); it\n * rides Node's AsyncLocalStorage down through every async fan-out, so one\n * handler that triggers 15 reads attributes all 15 to the same bucket — with\n * zero per-call-site work.\n *\n * Generic by design: unlike a hardcoded product taxonomy, the only meaningful\n * field a consumer sets is the free-form `label` (the bucket name). `feature`\n * is an optional coarse grouping if you want one; nothing here is\n * Crossdeck-specific.\n */\nimport { AsyncLocalStorage } from \"node:async_hooks\";\n\nexport interface CostTag {\n  /** Optional coarse grouping (a caller-defined surface name). */\n  feature?: string;\n  /** The bucket name — what `bucket()` sets. Drives the report's `byLabel`. */\n  label?: string;\n}\n\nconst DEFAULT_TAG: CostTag = {};\nconst store = new AsyncLocalStorage<CostTag>();\n\n/** Run `fn` with `tag` bound for its entire async subtree. */\nexport function runWithCostTag<T>(tag: CostTag, fn: () => T): T {\n  return store.run({ ...tag }, fn);\n}\n\n/** Bind a tag for the remainder of the current async context (no closure to wrap). */\nexport function enterCostTag(tag: CostTag): void {\n  store.enterWith({ ...tag });\n}\n\n/** Refine the live tag in place (e.g. stamp a feature after the boundary). */\nexport function refineCostTag(patch: Partial<CostTag>): void {\n  const cur = store.getStore();\n  if (cur) Object.assign(cur, patch);\n}\n\n/** The current tag, or a safe empty default outside any bound context. */\nexport function currentCostTag(): CostTag {\n  return store.getStore() ?? DEFAULT_TAG;\n}\n\n/** Hierarchy separator for bucket paths — Firestore-map-key-safe and distinct from\n *  the \"col:\" leaf prefix. `bucket(\"a\", () => bucket(\"b\", …))` → \"a>b\". */\nexport const BUCKET_SEP = \">\";\n\n/**\n * `bucket(name, fn)` — the headline verb, the `track()` of cost. Run `fn` with\n * every operation inside it attributed to the bucket `name`; the attribution rides\n * the async subtree automatically. NESTS: a `bucket()` inside another COMPOSES into\n * a path (`\"analytics\" > \"rollup\"` → `\"analytics>rollup\"`), so the dashboard can\n * drill from the coarse bucket down into its parts. The one verb most developers touch:\n *\n *   await bucket(\"analytics\", () =>\n *     bucket(\"rollup\", () => db.collection(\"events\").where(...).get())); // → \"analytics>rollup>col:events\"\n */\nexport function bucket<T>(name: string, fn: () => T): T {\n  const parent = currentCostTag().label;\n  const path = parent ? `${parent}${BUCKET_SEP}${name}` : name;\n  return runWithCostTag({ ...currentCostTag(), label: path }, fn);\n}\n","/**\n * cost-meter — counts operations against the ambient tag and flushes them to the\n * configured Sink cheaply.\n *\n * LOW-OVERHEAD CONTRACT (the thing that warns you about reads must not run them\n * up): counts accumulate in an in-memory buffer and flush periodically — NEVER one\n * network call per counted operation. A flush coalesces the whole window into one\n * report per UTC day and hands it to the Sink. At steady state that is ~1 small\n * request a minute, regardless of how many ops you served.\n *\n * BEST-EFFORT CONTRACT: metering must never throw into your code. Every recorder\n * swallows its own errors; a failed flush drops that window's counts (surfaced via\n * `onError` if you pass one) rather than disturbing the app.\n */\nimport { currentCostTag } from \"./cost-context\";\nimport type { Sink, BucketsReport, ResourceCounts } from \"./sink\";\n\n/**\n * A resource unit — what an adapter counts. Firestore emits `read`/`write`/\n * `delete`; other adapters emit their own (`clickhouse.query_ms`, `openai.tokens`).\n * It is a free identifier on purpose, BUT each one is kept entirely distinct: the\n * meter only ever sums quantities WITHIN a single resource, never across two.\n */\nexport type ResourceUnit = string;\n/** @deprecated — Firestore-era name; use {@link ResourceUnit}. */\nexport type OpType = ResourceUnit;\n\n/** Optional read-site hint — the collection touched, derived at the trap from the\n *  path. Lets an UNtagged read cascade to `col:<collection>` instead of vanishing. */\nexport interface CostHint {\n  collection?: string;\n  projectId?: string;\n}\n\n// NUL separator — a bucket/collection name can contain almost anything except\n// this, so the key never collides with a name that has a \"|\" or \":\" in it.\nconst SEP = \"\\u001f\"; // ASCII Unit Separator\n\n/** key = date <NUL> resource <NUL> label → count */\nconst labelBuffer = new Map<string, number>();\n/** key = date <NUL> resource <NUL> hour → count */\nconst hourBuffer = new Map<string, number>();\n/** key = date <NUL> resource <NUL> 5-min-slot (\"HHMM\") → count. The fine grain\n *  that lets a developer verify against the provider console's \"last hour\" within\n *  minutes of installing — not after a day. Still one maintained doc, zero reads. */\nconst minuteBuffer = new Map<string, number>();\n\nlet sink: Sink | null = null;\nlet flushIntervalMs = 60_000;\nlet onError: ((e: unknown) => void) | null = null;\nlet timer: ReturnType<typeof setInterval> | null = null;\nlet flushing = false;\n/** Safety valve — flush early if a burst fills the buffer between intervals. */\nconst MAX_BUFFER_KEYS = 5_000;\n\nexport interface MeterConfig {\n  sink: Sink;\n  flushIntervalMs?: number;\n  onError?: (e: unknown) => void;\n}\n\n/** Point the meter at a sink. Called by `init()`; pass your own sink to self-host. */\nexport function configureMeter(config: MeterConfig): void {\n  sink = config.sink;\n  if (config.flushIntervalMs && config.flushIntervalMs > 0) flushIntervalMs = config.flushIntervalMs;\n  onError = config.onError ?? null;\n}\n\nconst utcDate = (): string => new Date().toISOString().slice(0, 10);\nconst utcHour = (): string => new Date().toISOString().slice(11, 13);\n/** UTC 5-minute slot of the day as \"HHMM\" — the slot START (e.g. 08:47 → \"0845\"). */\nconst utcFiveMin = (): string => {\n  const iso = new Date().toISOString();\n  const hh = iso.slice(11, 13);\n  const mm = Math.floor(Number(iso.slice(14, 16)) / 5) * 5;\n  return hh + String(mm).padStart(2, \"0\");\n};\n\nfunction ensureFlushLoop(): void {\n  if (timer) return;\n  timer = setInterval(() => void flush(), flushIntervalMs);\n  // Don't keep the event loop alive just for metering.\n  (timer as { unref?: () => void }).unref?.();\n  // Flush the last window on shutdown.\n  process.once?.(\"SIGTERM\", () => void flush());\n  process.once?.(\"beforeExit\", () => void flush());\n}\n\n/**\n * Count `quantity` of a `resource` against the live tag. THE adapter primitive —\n * a Firestore adapter records \"read\"; a ClickHouse adapter records\n * \"clickhouse.query_ms\"; an OpenAI adapter records \"openai.tokens\". Each resource\n * is bucketed entirely on its own; nothing is ever added across resources. Never\n * throws.\n */\nexport function record(resource: ResourceUnit, quantity: number, hint?: CostHint): void {\n  try {\n    if (!Number.isFinite(quantity) || quantity <= 0) return;\n    const t = currentCostTag();\n    const date = utcDate();\n    // HIERARCHY — the bucket path is the trunk; the collection is the LEAF kept\n    // beneath it (so a tagged bucket still drills down to which collections it\n    // read). \"analytics\" + events → \"analytics>col:events\"; untagged → \"col:events\";\n    // nothing derivable → \"uncategorized\". A unit is never invisible, and a tagged\n    // one never loses where it actually went.\n    const coll = hint?.collection ? `col:${hint.collection}` : null;\n    const label = t.label\n      ? coll\n        ? `${t.label}>${coll}`\n        : t.label\n      : coll ?? \"uncategorized\";\n    // Key includes the resource, so each resource accumulates in its OWN slot.\n    const lk = date + SEP + resource + SEP + label;\n    labelBuffer.set(lk, (labelBuffer.get(lk) ?? 0) + quantity);\n    const hk = date + SEP + resource + SEP + utcHour();\n    hourBuffer.set(hk, (hourBuffer.get(hk) ?? 0) + quantity);\n    const mk = date + SEP + resource + SEP + utcFiveMin();\n    minuteBuffer.set(mk, (minuteBuffer.get(mk) ?? 0) + quantity);\n    ensureFlushLoop();\n    if (labelBuffer.size + hourBuffer.size + minuteBuffer.size > MAX_BUFFER_KEYS) void flush();\n  } catch {\n    /* metering is best-effort — never disturb the caller */\n  }\n}\n\n/** @deprecated — use {@link record}. Firestore-era alias. */\nexport const recordFirestore = record;\n\n/** Firestore bills a minimum of one read even for an empty result, so 0 counts as 1. */\nexport function recordReads(n: number, hint?: CostHint): void {\n  record(\"read\", Math.max(n, 1), hint);\n}\nexport function recordWrites(n = 1): void {\n  record(\"write\", n);\n}\nexport function recordDeletes(n = 1): void {\n  record(\"delete\", n);\n}\n\nfunction add(target: Record<string, ResourceCounts>, key: string, resource: ResourceUnit, n: number): void {\n  const bag = (target[key] ??= {});\n  // Accumulate WITHIN this resource only — never merge resources.\n  bag[resource] = (bag[resource] ?? 0) + n;\n}\n\n/**\n * Coalesce the buffer into one report per UTC day and hand each to the Sink.\n * Snapshots + clears up front so concurrent records land in the next window.\n * Never throws; a sink failure drops that window (surfaced via `onError`).\n */\nexport async function flush(): Promise<void> {\n  if (flushing) return;\n  // Not configured (init not called) — drop, don't grow unbounded.\n  if (!sink) {\n    labelBuffer.clear();\n    hourBuffer.clear();\n    minuteBuffer.clear();\n    return;\n  }\n  if (labelBuffer.size === 0 && hourBuffer.size === 0 && minuteBuffer.size === 0) return;\n  flushing = true;\n\n  const labels = new Map(labelBuffer);\n  const hours = new Map(hourBuffer);\n  const minutes = new Map(minuteBuffer);\n  labelBuffer.clear();\n  hourBuffer.clear();\n  minuteBuffer.clear();\n\n  try {\n    const byDate = new Map<string, BucketsReport>();\n    const reportFor = (date: string): BucketsReport => {\n      let r = byDate.get(date);\n      if (!r) {\n        r = { date, byLabel: {}, byHour: {}, byMinute: {} };\n        byDate.set(date, r);\n      }\n      return r;\n    };\n    for (const [k, n] of labels) {\n      const [date, op, label] = k.split(SEP) as [string, OpType, string];\n      add(reportFor(date).byLabel, label, op, n);\n    }\n    for (const [k, n] of hours) {\n      const [date, op, hour] = k.split(SEP) as [string, OpType, string];\n      add(reportFor(date).byHour!, hour, op, n);\n    }\n    for (const [k, n] of minutes) {\n      const [date, op, slot] = k.split(SEP) as [string, OpType, string];\n      add(reportFor(date).byMinute!, slot, op, n);\n    }\n    for (const report of byDate.values()) {\n      await sink.flush(report);\n    }\n  } catch (e) {\n    // Drop this window rather than risk a partial/double report on retry.\n    onError?.(e);\n  } finally {\n    flushing = false;\n  }\n}\n","/**\n * sink — where the meter sends a coalesced rollup, and the wire shape it sends.\n *\n * Abstracting the sink is what makes Buckets storage-agnostic: the meter never\n * knows where counts go. The DEFAULT sink (`ReportSink`) reports up to Crossdeck's\n * ingest endpoint so the numbers surface on your Crossdeck dashboard. A team that\n * wants to self-host can implement `Sink` against anything (Postgres, a file, your\n * own API) without touching the meter.\n */\n\n/**\n * Counts for ONE bucket, keyed by RESOURCE UNIT — the raw quantity of each unit,\n * nothing more (no money; you verify cost on your provider's bill).\n *\n * Firestore, the first adapter, emits `read` / `write` / `delete`. Other adapters\n * emit their own units (`clickhouse.query_ms`, `openai.tokens`, …). The rule that\n * keeps this honest: **each resource is its own line. Counts are only ever summed\n * WITHIN a resource, NEVER across one.** A read is not a query-millisecond; the two\n * never land in the same number. (There is deliberately no \"total units\" field.)\n */\nexport interface ResourceCounts {\n  read?: number;\n  write?: number;\n  delete?: number;\n  /** Any other resource unit an adapter emits — kept distinct, never merged. */\n  [resource: string]: number | undefined;\n}\n\n/** @deprecated name — kept for back-compat; use {@link ResourceCounts}. */\nexport type OpCounts = ResourceCounts;\n\n/**\n * One coalesced report — the wire contract (see docs/ROLLUP_SCHEMA.md). The meter\n * produces one of these per UTC day in a flush window (usually exactly one).\n */\nexport interface BucketsReport {\n  /** UTC day \"YYYY-MM-DD\". */\n  date: string;\n  /** bucket name → counts. The heart of the report. */\n  byLabel: Record<string, ResourceCounts>;\n  /** UTC hour \"HH\" → counts, for the hourly \"did my fix land this hour?\" view. */\n  byHour?: Record<string, ResourceCounts>;\n  /** UTC 5-minute slot \"HHMM\" (slot start) → counts. The fine grain for fast\n   *  verification against a provider console's \"last hour\" view. */\n  byMinute?: Record<string, ResourceCounts>;\n}\n\n/**\n * A destination for coalesced rollups. `flush` MAY throw on failure — the meter\n * catches it, drops that one window, and never lets it reach your app.\n */\nexport interface Sink {\n  flush(report: BucketsReport): Promise<void>;\n}\n\nexport interface ReportSinkConfig {\n  /** The project's `cd_sk_` secret key. Server-to-server only. */\n  apiKey: string;\n  /** Defaults to https://api.cross-deck.com/v1/buckets/report */\n  endpoint?: string;\n  /** Request timeout (ms); a slow Crossdeck must never stall your flush. */\n  timeoutMs?: number;\n}\n\nconst DEFAULT_ENDPOINT = \"https://api.cross-deck.com/v1/buckets/report\";\n\n/**\n * The default sink: POST one coalesced rollup to Crossdeck's ingest endpoint.\n * The ingest folds it into the day's maintained doc with `increment`, so many\n * reports a minute coalesce safely. This path does ZERO database reads — it sends\n * a summary, it does not read. Throws on a non-202 so the meter can log/drop the\n * window; the meter guarantees it never reaches your app.\n */\nexport class ReportSink implements Sink {\n  private readonly endpoint: string;\n  private readonly apiKey: string;\n  private readonly timeoutMs: number;\n\n  constructor(config: ReportSinkConfig) {\n    this.endpoint = config.endpoint ?? DEFAULT_ENDPOINT;\n    this.apiKey = config.apiKey;\n    this.timeoutMs = config.timeoutMs ?? 5000;\n  }\n\n  async flush(report: BucketsReport): Promise<void> {\n    const res = await fetch(this.endpoint, {\n      method: \"POST\",\n      signal: AbortSignal.timeout(this.timeoutMs),\n      headers: {\n        \"content-type\": \"application/json\",\n        authorization: `Bearer ${this.apiKey}`,\n      },\n      body: JSON.stringify(report),\n    });\n    if (res.status !== 202) {\n      throw new Error(`Buckets report rejected: HTTP ${res.status}`);\n    }\n  }\n}\n","/**\n * adapters/firestore — the universal Firestore read meter (the trap).\n *\n * THE LESSON (learned on a real product): per-call-site `recordReads()`\n * instrumentation MISSES paths. You meter the read sites you're looking at and\n * leave the cron / trigger / ingest path uncounted — often the majority of reads,\n * invisible. Humans tag what they see and miss the path that matters.\n *\n * THE FIX: patch the admin SDK's read methods ONCE. From install onward, EVERY\n * read — anywhere, on any code path — is counted under the ambient tag, with zero\n * per-call-site work and no blind spots.\n *\n * SAFETY CONTRACT — this sits on your production read path, so it is defensive by\n * construction. Each wrapper:\n *   1. calls the REAL method first and captures the result,\n *   2. counts in a try/catch that can never throw into the caller,\n *   3. ALWAYS returns the real result, untouched.\n * It cannot break a read, change a result, or add latency beyond one in-memory\n * counter increment. A wrong count is a measurement error, never a correctness or\n * availability one. Idempotent — calling it twice patches once.\n *\n * COUNTING MODEL — a query returning N docs = N reads (an empty result still bills\n * 1, which the meter enforces). A document get = 1. getAll(...) = the ref count.\n * CollectionReference.get IS Query.get (shared prototype method), so patching Query\n * covers collections with no double-count.\n */\nimport { recordReads, type CostHint } from \"../cost-meter\";\n\nlet installed = false;\n\n/* eslint-disable @typescript-eslint/no-explicit-any */\ntype AnyFn = (...args: any[]) => any;\n\n/**\n * The firebase-admin Firestore classes to patch. Pass the module namespace from\n * `firebase-admin/firestore` — only the prototypes present are patched.\n */\nexport interface FirestoreClasses {\n  Query?: { prototype: { get?: AnyFn; onSnapshot?: AnyFn } };\n  DocumentReference?: { prototype: { get?: AnyFn; onSnapshot?: AnyFn } };\n  Transaction?: { prototype: { get?: AnyFn; getAll?: AnyFn } };\n  Firestore?: { prototype: { getAll?: AnyFn } };\n  /** count() / sum() / average() — aggregation queries bill reads too. */\n  AggregateQuery?: { prototype: { get?: AnyFn } };\n}\n\n/** `projects/{id}/…` → the project id, else undefined. Pure string op. */\nfunction projectFromPath(path: string): string | undefined {\n  const parts = path.split(\"/\");\n  const i = parts.indexOf(\"projects\");\n  return i >= 0 && parts[i + 1] ? parts[i + 1] : undefined;\n}\n\n/**\n * Derive { collection, projectId } from the read target's path so an UNtagged read\n * cascades to `col:<collection>` instead of \"uncategorized\". PURE CPU; never reads,\n * never throws. Falls back to firebase-admin's internal `_queryOptions` for filtered\n * queries (which don't expose `.path`).\n */\nfunction hintFrom(target: any): CostHint | undefined {\n  try {\n    const p = typeof target?.path === \"string\" ? target.path : \"\";\n    if (p) {\n      const parts = p.split(\"/\").filter(Boolean);\n      const collection = parts.length % 2 === 0 ? parts[parts.length - 2] : parts[parts.length - 1];\n      return { collection, projectId: projectFromPath(p) };\n    }\n    const qo = target?._queryOptions;\n    if (qo) {\n      const collection = typeof qo.collectionId === \"string\" ? qo.collectionId : undefined;\n      const parent =\n        typeof qo.parentPath?.relativeName === \"string\"\n          ? qo.parentPath.relativeName\n          : typeof qo.parentPath?.toString === \"function\"\n            ? String(qo.parentPath.toString())\n            : \"\";\n      return { collection, projectId: parent ? projectFromPath(parent) : undefined };\n    }\n  } catch {\n    /* the meter must never throw */\n  }\n  return undefined;\n}\n\nfunction meterSnap(snap: unknown, hint?: CostHint): void {\n  try {\n    const size = (snap as { size?: number } | null)?.size;\n    recordReads(typeof size === \"number\" ? size : 1, hint);\n  } catch {\n    /* best-effort */\n  }\n}\nfunction meterCount(n: number, hint?: CostHint): void {\n  try {\n    recordReads(n, hint);\n  } catch {\n    /* best-effort */\n  }\n}\n\n/**\n * Install the universal read meter on the firebase-admin Firestore classes. Call\n * ONCE at process start, before any reads. Pass the namespace from\n * `firebase-admin/firestore` so the exact prototypes the SDK uses are patched:\n *\n *   import * as Firestore from \"firebase-admin/firestore\";\n *   installFirestoreMeter(Firestore);\n */\nexport function installFirestoreMeter(classes: FirestoreClasses): void {\n  if (installed) return;\n  installed = true;\n  const { Query, DocumentReference, Transaction, Firestore, AggregateQuery } = classes;\n\n  // Query.get — covers Query AND CollectionReference (shared prototype method).\n  const qGet = Query?.prototype?.get;\n  if (qGet) {\n    Query!.prototype.get = async function (this: unknown, ...args: any[]) {\n      const snap = await qGet.apply(this, args);\n      meterSnap(snap, hintFrom(this));\n      return snap;\n    };\n  }\n\n  // DocumentReference.get — a single doc = 1 read.\n  const dGet = DocumentReference?.prototype?.get;\n  if (dGet) {\n    DocumentReference!.prototype.get = async function (this: unknown, ...args: any[]) {\n      const snap = await dGet.apply(this, args);\n      meterCount(1, hintFrom(this));\n      return snap;\n    };\n  }\n\n  // Transaction.get — query or doc; size when present, else 1.\n  const tGet = Transaction?.prototype?.get;\n  if (tGet) {\n    Transaction!.prototype.get = async function (this: unknown, ...args: any[]) {\n      const res = await tGet.apply(this, args);\n      meterSnap(res, hintFrom(args[0]));\n      return res;\n    };\n  }\n\n  // Transaction.getAll(...refs) — one read per ref.\n  const tGetAll = Transaction?.prototype?.getAll;\n  if (tGetAll) {\n    Transaction!.prototype.getAll = async function (this: unknown, ...args: any[]) {\n      const res = await tGetAll.apply(this, args);\n      meterCount(Array.isArray(res) ? res.length : args.length || 1, hintFrom(args[0]));\n      return res;\n    };\n  }\n\n  // Firestore.getAll(...refs) — batched doc reads.\n  const fGetAll = Firestore?.prototype?.getAll;\n  if (fGetAll) {\n    Firestore!.prototype.getAll = async function (this: unknown, ...args: any[]) {\n      const res = await fGetAll.apply(this, args);\n      meterCount(Array.isArray(res) ? res.length : args.length || 1, hintFrom(args[0]));\n      return res;\n    };\n  }\n\n  // AggregateQuery.get — count() / sum() / average(). Firestore bills one read per\n  // up to 1000 index entries scanned, and the client never sees that entry count —\n  // so this is an HONEST ESTIMATE: for count() we derive it from the result\n  // (ceil(count / 1000)), else the billed minimum of 1. Observe-only: it reads the\n  // result you already got, adds zero reads. (Closes the aggregation blind spot.)\n  const aGet = AggregateQuery?.prototype?.get;\n  if (aGet) {\n    AggregateQuery!.prototype.get = async function (this: unknown, ...args: any[]) {\n      const snap = await aGet.apply(this, args);\n      try {\n        const data = (snap as { data?: () => { count?: number } } | null)?.data?.();\n        const count = typeof data?.count === \"number\" ? data.count : 0;\n        meterCount(Math.max(1, Math.ceil(count / 1000)), hintFrom(this));\n      } catch {\n        /* best-effort */\n      }\n      return snap;\n    };\n  }\n\n  // Query.onSnapshot / DocumentReference.onSnapshot — server-side realtime\n  // listeners. We OBSERVE: wrap onNext and count the docs each fire delivers (a\n  // query's changed docs — first fire = all matching; a doc = 1). We attach no\n  // listener and issue no read; the meter just sees what the listener is already\n  // billed. (Closes the server-listener blind spot.)\n  const patchOnSnapshot = (proto: { onSnapshot?: AnyFn } | undefined, perDoc: boolean): void => {\n    const real = proto?.onSnapshot;\n    if (!real) return;\n    proto!.onSnapshot = function (this: unknown, ...args: any[]) {\n      const hint = hintFrom(this);\n      const i = args.findIndex((a) => typeof a === \"function\");\n      if (i >= 0) {\n        const onNext = args[i];\n        args[i] = function (snap: any) {\n          try {\n            const n = perDoc\n              ? 1\n              : typeof snap?.docChanges === \"function\"\n                ? snap.docChanges().length\n                : typeof snap?.size === \"number\"\n                  ? snap.size\n                  : 1;\n            if (n > 0) meterCount(n, hint);\n          } catch {\n            /* best-effort */\n          }\n          return onNext(snap);\n        };\n      }\n      return real.apply(this, args);\n    };\n  };\n  patchOnSnapshot(Query?.prototype, false);\n  patchOnSnapshot(DocumentReference?.prototype, true);\n}\n\n/** Test-only: reset the install guard so a suite can re-patch fresh prototypes. */\nexport function __resetFirestoreMeterForTests(): void {\n  installed = false;\n}\n","/**\n * @cross-deck/buckets — know exactly what every database read costs you, and who\n * caused it. A tiny, never-throws collector for Firestore.\n *\n * The whole footprint a consumer sees:\n *   1. init({ apiKey, firestore })  — configure once, install the trap once\n *   2. bucket(name, fn)             — name the read paths that matter\n *   3. (the dashboard shows the rest — and names the ones you haven't yet)\n */\nimport { configureMeter, type MeterConfig } from \"./cost-meter\";\nimport { ReportSink, type Sink } from \"./sink\";\nimport { installFirestoreMeter, type FirestoreClasses } from \"./adapters/firestore\";\n\nexport interface InitOptions {\n  /** The project's `cd_sk_` SECRET key. Server-to-server only — never a browser key. */\n  apiKey: string;\n  /**\n   * Pass the namespace from `firebase-admin/firestore` to auto-install the read\n   * trap (recommended — this is what makes every read count with no per-call work).\n   * Omit it if you'd rather call `installFirestoreMeter()` yourself, or you only\n   * use the manual `recordReads()` recorders.\n   */\n  firestore?: FirestoreClasses;\n  /** Override the report endpoint (defaults to Crossdeck's ingest). */\n  endpoint?: string;\n  /** How often to flush coalesced counts (ms). Default 60_000. */\n  flushIntervalMs?: number;\n  /** Bring your own sink (self-host the rollups). Defaults to reporting up to Crossdeck. */\n  sink?: Sink;\n  /** Notified when a flush fails, so a dropped window is never silent. Best-effort. */\n  onError?: MeterConfig[\"onError\"];\n}\n\n/**\n * Configure Buckets once, at process start. Points the meter at a sink (Crossdeck's\n * ingest by default) and — if you pass `firestore` — installs the universal read\n * trap so every read counts automatically.\n */\nexport function init(options: InitOptions): void {\n  const sink = options.sink ?? new ReportSink({ apiKey: options.apiKey, endpoint: options.endpoint });\n  configureMeter({ sink, flushIntervalMs: options.flushIntervalMs, onError: options.onError });\n  if (options.firestore) installFirestoreMeter(options.firestore);\n}\n\n/** Alias — reads well next to `bucket()` at a call site. */\nexport { init as initBuckets };\n\n// The headline verb + the lower-level tag controls it is sugar over.\nexport {\n  bucket,\n  runWithCostTag,\n  enterCostTag,\n  refineCostTag,\n  currentCostTag,\n  type CostTag,\n} from \"./cost-context\";\n\n// Recorders. `record(resource, quantity)` is the generic adapter primitive — count\n// any resource unit (a future adapter records \"clickhouse.query_ms\"); recordReads/\n// Writes/Deletes are the Firestore conveniences over it.\nexport {\n  record,\n  recordReads,\n  recordWrites,\n  recordDeletes,\n  flush,\n  type CostHint,\n  type ResourceUnit,\n  type OpType,\n  type MeterConfig,\n} from \"./cost-meter\";\n\n// The trap (the only datastore adapter today) + its class shape.\nexport { installFirestoreMeter, type FirestoreClasses } from \"./adapters/firestore\";\n\n// The sink seam — for self-hosting rollups instead of reporting to Crossdeck.\nexport {\n  ReportSink,\n  type Sink,\n  type BucketsReport,\n  type ResourceCounts,\n  type OpCounts,\n  type ReportSinkConfig,\n} from \"./sink\";\n"]}
+{"version":3,"sources":["../src/cost-context.ts","../src/cost-meter.ts","../src/sink.ts","../src/readout.ts","../src/mirror.ts","../src/adapters/firestore.ts","../src/index.ts"],"names":["AsyncLocalStorage","join","readFileSync","mkdirSync","writeFileSync","sink"],"mappings":";;;;;;;AAqBA,IAAM,cAAuB,EAAC;AAC9B,IAAM,KAAA,GAAQ,IAAIA,6BAAA,EAA2B;AAGtC,SAAS,cAAA,CAAkB,KAAc,EAAA,EAAgB;AAC9D,EAAA,OAAO,MAAM,GAAA,CAAI,EAAE,GAAG,GAAA,IAAO,EAAE,CAAA;AACjC;AAGO,SAAS,aAAa,GAAA,EAAoB;AAC/C,EAAA,KAAA,CAAM,SAAA,CAAU,EAAE,GAAG,GAAA,EAAK,CAAA;AAC5B;AAGO,SAAS,cAAc,KAAA,EAA+B;AAC3D,EAAA,MAAM,GAAA,GAAM,MAAM,QAAA,EAAS;AAC3B,EAAA,IAAI,GAAA,EAAK,MAAA,CAAO,MAAA,CAAO,GAAA,EAAK,KAAK,CAAA;AACnC;AAGO,SAAS,cAAA,GAA0B;AACxC,EAAA,OAAO,KAAA,CAAM,UAAS,IAAK,WAAA;AAC7B;AAIO,IAAM,UAAA,GAAa,GAAA;AAYnB,SAAS,MAAA,CAAU,MAAc,EAAA,EAAgB;AACtD,EAAA,MAAM,MAAA,GAAS,gBAAe,CAAE,KAAA;AAChC,EAAA,MAAM,IAAA,GAAO,SAAS,CAAA,EAAG,MAAM,GAAG,UAAU,CAAA,EAAG,IAAI,CAAA,CAAA,GAAK,IAAA;AACxD,EAAA,OAAO,cAAA,CAAe,EAAE,GAAG,cAAA,IAAkB,KAAA,EAAO,IAAA,IAAQ,EAAE,CAAA;AAChE;;;AC3BA,IAAM,GAAA,GAAM,GAAA;AAGZ,IAAM,WAAA,uBAAkB,GAAA,EAAoB;AAE5C,IAAM,UAAA,uBAAiB,GAAA,EAAoB;AAI3C,IAAM,YAAA,uBAAmB,GAAA,EAAoB;AAE7C,IAAI,IAAA,GAAoB,IAAA;AACxB,IAAI,eAAA,GAAkB,GAAA;AACtB,IAAI,OAAA,GAAyC,IAAA;AAC7C,IAAI,KAAA,GAA+C,IAAA;AACnD,IAAI,QAAA,GAAW,KAAA;AAEf,IAAM,eAAA,GAAkB,GAAA;AASjB,SAAS,eAAe,MAAA,EAA2B;AACxD,EAAA,IAAA,GAAO,MAAA,CAAO,IAAA;AACd,EAAA,IAAI,OAAO,eAAA,IAAmB,MAAA,CAAO,eAAA,GAAkB,CAAA,oBAAqB,MAAA,CAAO,eAAA;AACnF,EAAA,OAAA,GAAU,OAAO,OAAA,IAAW,IAAA;AAC9B;AAEA,IAAM,OAAA,GAAU,uBAAc,IAAI,IAAA,IAAO,WAAA,EAAY,CAAE,KAAA,CAAM,CAAA,EAAG,EAAE,CAAA;AAClE,IAAM,OAAA,GAAU,uBAAc,IAAI,IAAA,IAAO,WAAA,EAAY,CAAE,KAAA,CAAM,EAAA,EAAI,EAAE,CAAA;AAEnE,IAAM,aAAa,MAAc;AAC/B,EAAA,MAAM,GAAA,GAAA,iBAAM,IAAI,IAAA,EAAK,EAAE,WAAA,EAAY;AACnC,EAAA,MAAM,EAAA,GAAK,GAAA,CAAI,KAAA,CAAM,EAAA,EAAI,EAAE,CAAA;AAC3B,EAAA,MAAM,EAAA,GAAK,IAAA,CAAK,KAAA,CAAM,MAAA,CAAO,GAAA,CAAI,KAAA,CAAM,EAAA,EAAI,EAAE,CAAC,CAAA,GAAI,CAAC,CAAA,GAAI,CAAA;AACvD,EAAA,OAAO,KAAK,MAAA,CAAO,EAAE,CAAA,CAAE,QAAA,CAAS,GAAG,GAAG,CAAA;AACxC,CAAA;AAEA,SAAS,eAAA,GAAwB;AAC/B,EAAA,IAAI,KAAA,EAAO;AACX,EAAA,KAAA,GAAQ,WAAA,CAAY,MAAM,KAAK,KAAA,IAAS,eAAe,CAAA;AAEvD,EAAC,MAAiC,KAAA,IAAQ;AAE1C,EAAA,OAAA,CAAQ,IAAA,GAAO,SAAA,EAAW,MAAM,KAAK,OAAO,CAAA;AAC5C,EAAA,OAAA,CAAQ,IAAA,GAAO,YAAA,EAAc,MAAM,KAAK,OAAO,CAAA;AACjD;AASO,SAAS,MAAA,CAAO,QAAA,EAAwB,QAAA,EAAkB,IAAA,EAAuB;AACtF,EAAA,IAAI;AACF,IAAA,IAAI,CAAC,MAAA,CAAO,QAAA,CAAS,QAAQ,CAAA,IAAK,YAAY,CAAA,EAAG;AACjD,IAAA,MAAM,IAAI,cAAA,EAAe;AACzB,IAAA,MAAM,OAAO,OAAA,EAAQ;AAMrB,IAAA,MAAM,OAAO,IAAA,EAAM,UAAA,GAAa,CAAA,IAAA,EAAO,IAAA,CAAK,UAAU,CAAA,CAAA,GAAK,IAAA;AAC3D,IAAA,MAAM,KAAA,GAAQ,CAAA,CAAE,KAAA,GACZ,IAAA,GACE,CAAA,EAAG,CAAA,CAAE,KAAK,CAAA,CAAA,EAAI,IAAI,CAAA,CAAA,GAClB,CAAA,CAAE,KAAA,GACJ,IAAA,IAAQ,eAAA;AAEZ,IAAA,MAAM,EAAA,GAAK,IAAA,GAAO,GAAA,GAAM,QAAA,GAAW,GAAA,GAAM,KAAA;AACzC,IAAA,WAAA,CAAY,IAAI,EAAA,EAAA,CAAK,WAAA,CAAY,IAAI,EAAE,CAAA,IAAK,KAAK,QAAQ,CAAA;AACzD,IAAA,MAAM,EAAA,GAAK,IAAA,GAAO,GAAA,GAAM,QAAA,GAAW,MAAM,OAAA,EAAQ;AACjD,IAAA,UAAA,CAAW,IAAI,EAAA,EAAA,CAAK,UAAA,CAAW,IAAI,EAAE,CAAA,IAAK,KAAK,QAAQ,CAAA;AACvD,IAAA,MAAM,EAAA,GAAK,IAAA,GAAO,GAAA,GAAM,QAAA,GAAW,MAAM,UAAA,EAAW;AACpD,IAAA,YAAA,CAAa,IAAI,EAAA,EAAA,CAAK,YAAA,CAAa,IAAI,EAAE,CAAA,IAAK,KAAK,QAAQ,CAAA;AAC3D,IAAA,eAAA,EAAgB;AAChB,IAAA,IAAI,WAAA,CAAY,OAAO,UAAA,CAAW,IAAA,GAAO,aAAa,IAAA,GAAO,eAAA,OAAsB,KAAA,EAAM;AAAA,EAC3F,CAAA,CAAA,MAAQ;AAAA,EAER;AACF;AAMO,SAAS,WAAA,CAAY,GAAW,IAAA,EAAuB;AAC5D,EAAA,MAAA,CAAO,QAAQ,IAAA,CAAK,GAAA,CAAI,CAAA,EAAG,CAAC,GAAG,IAAI,CAAA;AACrC;AACO,SAAS,YAAA,CAAa,IAAI,CAAA,EAAS;AACxC,EAAA,MAAA,CAAO,SAAS,CAAC,CAAA;AACnB;AACO,SAAS,aAAA,CAAc,IAAI,CAAA,EAAS;AACzC,EAAA,MAAA,CAAO,UAAU,CAAC,CAAA;AACpB;AAEA,SAAS,GAAA,CAAI,MAAA,EAAwC,GAAA,EAAa,QAAA,EAAwB,CAAA,EAAiB;AACzG,EAAA,MAAM,GAAA,GAAO,MAAA,CAAO,GAAG,CAAA,KAAM,EAAC;AAE9B,EAAA,GAAA,CAAI,QAAQ,CAAA,GAAA,CAAK,GAAA,CAAI,QAAQ,KAAK,CAAA,IAAK,CAAA;AACzC;AAOA,eAAsB,KAAA,GAAuB;AAC3C,EAAA,IAAI,QAAA,EAAU;AAEd,EAAA,IAAI,CAAC,IAAA,EAAM;AACT,IAAA,WAAA,CAAY,KAAA,EAAM;AAClB,IAAA,UAAA,CAAW,KAAA,EAAM;AACjB,IAAA,YAAA,CAAa,KAAA,EAAM;AACnB,IAAA;AAAA,EACF;AACA,EAAA,IAAI,WAAA,CAAY,SAAS,CAAA,IAAK,UAAA,CAAW,SAAS,CAAA,IAAK,YAAA,CAAa,SAAS,CAAA,EAAG;AAChF,EAAA,QAAA,GAAW,IAAA;AAEX,EAAA,MAAM,MAAA,GAAS,IAAI,GAAA,CAAI,WAAW,CAAA;AAClC,EAAA,MAAM,KAAA,GAAQ,IAAI,GAAA,CAAI,UAAU,CAAA;AAChC,EAAA,MAAM,OAAA,GAAU,IAAI,GAAA,CAAI,YAAY,CAAA;AACpC,EAAA,WAAA,CAAY,KAAA,EAAM;AAClB,EAAA,UAAA,CAAW,KAAA,EAAM;AACjB,EAAA,YAAA,CAAa,KAAA,EAAM;AAEnB,EAAA,IAAI;AACF,IAAA,MAAM,MAAA,uBAAa,GAAA,EAA2B;AAC9C,IAAA,MAAM,SAAA,GAAY,CAAC,IAAA,KAAgC;AACjD,MAAA,IAAI,CAAA,GAAI,MAAA,CAAO,GAAA,CAAI,IAAI,CAAA;AACvB,MAAA,IAAI,CAAC,CAAA,EAAG;AACN,QAAA,CAAA,GAAI,EAAE,IAAA,EAAM,OAAA,EAAS,EAAC,EAAG,QAAQ,EAAC,EAAG,QAAA,EAAU,EAAC,EAAE;AAClD,QAAA,MAAA,CAAO,GAAA,CAAI,MAAM,CAAC,CAAA;AAAA,MACpB;AACA,MAAA,OAAO,CAAA;AAAA,IACT,CAAA;AACA,IAAA,KAAA,MAAW,CAAC,CAAA,EAAG,CAAC,CAAA,IAAK,MAAA,EAAQ;AAC3B,MAAA,MAAM,CAAC,IAAA,EAAM,EAAA,EAAI,KAAK,CAAA,GAAI,CAAA,CAAE,MAAM,GAAG,CAAA;AACrC,MAAA,GAAA,CAAI,UAAU,IAAI,CAAA,CAAE,OAAA,EAAS,KAAA,EAAO,IAAI,CAAC,CAAA;AAAA,IAC3C;AACA,IAAA,KAAA,MAAW,CAAC,CAAA,EAAG,CAAC,CAAA,IAAK,KAAA,EAAO;AAC1B,MAAA,MAAM,CAAC,IAAA,EAAM,EAAA,EAAI,IAAI,CAAA,GAAI,CAAA,CAAE,MAAM,GAAG,CAAA;AACpC,MAAA,GAAA,CAAI,UAAU,IAAI,CAAA,CAAE,MAAA,EAAS,IAAA,EAAM,IAAI,CAAC,CAAA;AAAA,IAC1C;AACA,IAAA,KAAA,MAAW,CAAC,CAAA,EAAG,CAAC,CAAA,IAAK,OAAA,EAAS;AAC5B,MAAA,MAAM,CAAC,IAAA,EAAM,EAAA,EAAI,IAAI,CAAA,GAAI,CAAA,CAAE,MAAM,GAAG,CAAA;AACpC,MAAA,GAAA,CAAI,UAAU,IAAI,CAAA,CAAE,QAAA,EAAW,IAAA,EAAM,IAAI,CAAC,CAAA;AAAA,IAC5C;AACA,IAAA,KAAA,MAAW,MAAA,IAAU,MAAA,CAAO,MAAA,EAAO,EAAG;AACpC,MAAA,MAAM,IAAA,CAAK,MAAM,MAAM,CAAA;AAAA,IACzB;AAAA,EACF,SAAS,CAAA,EAAG;AAEV,IAAA,OAAA,GAAU,CAAC,CAAA;AAAA,EACb,CAAA,SAAE;AACA,IAAA,QAAA,GAAW,KAAA;AAAA,EACb;AACF;;;ACxIA,IAAM,gBAAA,GAAmB,8CAAA;AASlB,IAAM,aAAN,MAAiC;AAAA,EACrB,QAAA;AAAA,EACA,MAAA;AAAA,EACA,SAAA;AAAA,EAEjB,YAAY,MAAA,EAA0B;AACpC,IAAA,IAAA,CAAK,QAAA,GAAW,OAAO,QAAA,IAAY,gBAAA;AACnC,IAAA,IAAA,CAAK,SAAS,MAAA,CAAO,MAAA;AACrB,IAAA,IAAA,CAAK,SAAA,GAAY,OAAO,SAAA,IAAa,GAAA;AAAA,EACvC;AAAA,EAEA,MAAM,MAAM,MAAA,EAAsC;AAChD,IAAA,MAAM,GAAA,GAAM,MAAM,KAAA,CAAM,IAAA,CAAK,QAAA,EAAU;AAAA,MACrC,MAAA,EAAQ,MAAA;AAAA,MACR,MAAA,EAAQ,WAAA,CAAY,OAAA,CAAQ,IAAA,CAAK,SAAS,CAAA;AAAA,MAC1C,OAAA,EAAS;AAAA,QACP,cAAA,EAAgB,kBAAA;AAAA,QAChB,aAAA,EAAe,CAAA,OAAA,EAAU,IAAA,CAAK,MAAM,CAAA;AAAA,OACtC;AAAA,MACA,IAAA,EAAM,IAAA,CAAK,SAAA,CAAU,MAAM;AAAA,KAC5B,CAAA;AACD,IAAA,IAAI,GAAA,CAAI,WAAW,GAAA,EAAK;AACtB,MAAA,MAAM,IAAI,KAAA,CAAM,CAAA,8BAAA,EAAiC,GAAA,CAAI,MAAM,CAAA,CAAE,CAAA;AAAA,IAC/D;AAAA,EACF;AACF;AAOO,IAAM,WAAN,MAA+B;AAAA,EACpC,MAAM,KAAA,GAAuB;AAAA,EAE7B;AACF;;;ACjGO,IAAM,cAAA,GACX;AAIF,SAAS,IAAI,CAAA,EAAmB;AAC9B,EAAA,IAAI,KAAK,GAAA,EAAW,OAAA,CAAQ,IAAI,GAAA,EAAW,OAAA,CAAQ,CAAC,CAAA,GAAI,GAAA;AACxD,EAAA,IAAI,KAAK,GAAA,EAAQ,OAAO,KAAK,KAAA,CAAM,CAAA,GAAI,GAAI,CAAA,GAAI,GAAA;AAC/C,EAAA,IAAI,KAAK,GAAA,EAAM,OAAA,CAAQ,IAAI,GAAA,EAAM,OAAA,CAAQ,CAAC,CAAA,GAAI,GAAA;AAC9C,EAAA,OAAO,MAAA,CAAO,IAAA,CAAK,KAAA,CAAM,CAAC,CAAC,CAAA;AAC7B;AAGA,SAAS,WAAW,KAAA,EAAwB;AAC1C,EAAA,MAAM,IAAA,GAAO,KAAA,CAAM,KAAA,CAAM,GAAG,EAAE,CAAC,CAAA;AAC/B,EAAA,OAAO,KAAK,UAAA,CAAW,MAAM,CAAA,IAAK,IAAA,KAAS,mBAAmB,IAAA,KAAS,SAAA;AACzE;AAGA,SAAS,aAAa,KAAA,EAAuB;AAC3C,EAAA,OAAO,MACJ,KAAA,CAAM,GAAG,EACT,GAAA,CAAI,CAAC,MAAO,CAAA,CAAE,UAAA,CAAW,MAAM,CAAA,GAAI,EAAE,KAAA,CAAM,CAAC,IAAI,CAAE,CAAA,CAClD,KAAK,UAAK,CAAA;AACf;AAGO,SAAS,cAAc,MAAA,EAA+B;AAC3D,EAAA,MAAM,UAAU,MAAA,CAAO,OAAA,CAAQ,MAAA,CAAO,OAAA,IAAW,EAAE,CAAA,CAChD,GAAA,CAAI,CAAC,CAAC,KAAA,EAAO,MAAM,CAAA,MAAO,EAAE,OAAO,KAAA,EAAQ,MAAA,CAA0B,IAAA,IAAQ,CAAA,GAAI,CAAA,CACjF,MAAA,CAAO,CAAC,CAAA,KAAM,EAAE,KAAA,GAAQ,CAAC,CAAA,CACzB,IAAA,CAAK,CAAC,CAAA,EAAG,CAAA,KAAM,CAAA,CAAE,KAAA,GAAQ,EAAE,KAAK,CAAA;AAEnC,EAAA,MAAM,KAAA,GAAQ,QAAQ,MAAA,CAAO,CAAC,GAAG,CAAA,KAAM,CAAA,GAAI,CAAA,CAAE,KAAA,EAAO,CAAC,CAAA;AACrD,EAAA,MAAM,MAAgB,EAAC;AACvB,EAAA,GAAA,CAAI,KAAK,CAAA,sCAAA,CAAmC,CAAA;AAC5C,EAAA,GAAA,CAAI,KAAK,CAAA,CAAE,CAAA;AACX,EAAA,GAAA,CAAI,IAAA,CAAK,KAAK,GAAA,CAAI,KAAK,CAAC,CAAA,cAAA,EAAc,MAAA,CAAO,IAAI,CAAA,MAAA,CAAQ,CAAA;AACzD,EAAA,GAAA,CAAI,KAAK,CAAA,CAAE,CAAA;AAEX,EAAA,IAAI,OAAA,CAAQ,WAAW,CAAA,EAAG;AACxB,IAAA,GAAA,CAAI,KAAK,CAAA,sFAAA,CAAmF,CAAA;AAAA,EAC9F,CAAA,MAAO;AACL,IAAA,GAAA,CAAI,KAAK,CAAA,0BAAA,CAA4B,CAAA;AACrC,IAAA,GAAA,CAAI,KAAK,CAAA,sBAAA,CAAwB,CAAA;AACjC,IAAA,KAAA,MAAW,KAAK,OAAA,EAAS;AACvB,MAAA,GAAA,CAAI,KAAK,CAAA,EAAA,EAAK,YAAA,CAAa,EAAE,KAAK,CAAC,MAAM,UAAA,CAAW,CAAA,CAAE,KAAK,CAAA,GAAI,WAAM,QAAG,CAAA,GAAA,EAAM,IAAI,CAAA,CAAE,KAAK,CAAC,CAAA,EAAA,CAAI,CAAA;AAAA,IAChG;AAAA,EACF;AAEA,EAAA,GAAA,CAAI,KAAK,CAAA,CAAE,CAAA;AACX,EAAA,GAAA,CAAI,KAAK,CAAA,GAAA,CAAK,CAAA;AACd,EAAA,GAAA,CAAI,KAAK,cAAc,CAAA;AACvB,EAAA,GAAA,CAAI,KAAK,CAAA,CAAE,CAAA;AACX,EAAA,OAAO,GAAA,CAAI,KAAK,IAAI,CAAA;AACtB;;;AC7CO,IAAM,kBAAA,GAAqB;AAElC,SAAS,SAAA,CAAU,QAAwC,GAAA,EAA4C;AACrG,EAAA,IAAI,CAAC,GAAA,EAAK;AACV,EAAA,KAAA,MAAW,CAAC,GAAA,EAAK,MAAM,KAAK,MAAA,CAAO,OAAA,CAAQ,GAAG,CAAA,EAAG;AAC/C,IAAA,MAAM,GAAA,GAAO,MAAA,CAAO,GAAG,CAAA,KAAM,EAAC;AAC9B,IAAA,KAAA,MAAW,CAAC,GAAA,EAAK,CAAC,KAAK,MAAA,CAAO,OAAA,CAAQ,MAAM,CAAA,EAAG;AAC7C,MAAA,IAAI,OAAO,MAAM,QAAA,EAAU,GAAA,CAAI,GAAG,CAAA,GAAA,CAAK,GAAA,CAAI,GAAG,CAAA,IAAK,CAAA,IAAK,CAAA;AAAA,IAC1D;AAAA,EACF;AACF;AAOO,IAAM,aAAN,MAAiC;AAAA,EAKtC,WAAA,CACmB,QAAA,EACA,GAAA,GAAc,kBAAA,EAC/B;AAFiB,IAAA,IAAA,CAAA,QAAA,GAAA,QAAA;AACA,IAAA,IAAA,CAAA,GAAA,GAAA,GAAA;AAAA,EAChB;AAAA,EAFgB,QAAA;AAAA,EACA,GAAA;AAAA,EANX,GAAA,GAA4B,IAAA;AAAA,EAC5B,SAAA,GAAY,KAAA;AAAA,EACZ,MAAA,GAAS,KAAA;AAAA,EAOT,QAAA,GAAmB;AACzB,IAAA,OAAOC,SAAA,CAAK,IAAA,CAAK,GAAA,EAAK,cAAc,CAAA;AAAA,EACtC;AAAA;AAAA,EAGQ,KAAK,IAAA,EAAoB;AAC/B,IAAA,IAAI,KAAK,MAAA,EAAQ;AACjB,IAAA,IAAA,CAAK,MAAA,GAAS,IAAA;AACd,IAAA,IAAI;AACF,MAAA,MAAM,KAAA,GAAQ,KAAK,KAAA,CAAMC,eAAA,CAAa,KAAK,QAAA,EAAS,EAAG,MAAM,CAAC,CAAA;AAC9D,MAAA,IAAI,OAAO,IAAA,KAAS,IAAA,IAAQ,KAAA,CAAM,OAAA,OAAc,GAAA,GAAM,KAAA;AAAA,IACxD,CAAA,CAAA,MAAQ;AAAA,IAER;AAAA,EACF;AAAA,EAEA,MAAM,MAAM,MAAA,EAAsC;AAEhD,IAAA,IAAI;AACF,MAAA,IAAA,CAAK,IAAA,CAAK,OAAO,IAAI,CAAA;AACrB,MAAA,IAAI,CAAC,IAAA,CAAK,GAAA,IAAO,KAAK,GAAA,CAAI,IAAA,KAAS,OAAO,IAAA,EAAM;AAC9C,QAAA,IAAA,CAAK,GAAA,GAAM,EAAE,IAAA,EAAM,MAAA,CAAO,IAAA,EAAM,OAAA,EAAS,EAAC,EAAG,MAAA,EAAQ,EAAC,EAAG,QAAA,EAAU,EAAC,EAAE;AAAA,MACxE;AACA,MAAA,SAAA,CAAU,IAAA,CAAK,GAAA,CAAI,OAAA,EAAS,MAAA,CAAO,OAAO,CAAA;AAC1C,MAAA,SAAA,CAAW,KAAK,GAAA,CAAI,MAAA,KAAW,EAAC,EAAI,OAAO,MAAM,CAAA;AACjD,MAAA,SAAA,CAAW,KAAK,GAAA,CAAI,QAAA,KAAa,EAAC,EAAI,OAAO,QAAQ,CAAA;AAErD,MAAAC,YAAA,CAAU,IAAA,CAAK,GAAA,EAAK,EAAE,SAAA,EAAW,MAAM,CAAA;AACvC,MAAAC,gBAAA,CAAcH,SAAA,CAAK,KAAK,GAAA,EAAK,YAAY,GAAG,aAAA,CAAc,IAAA,CAAK,GAAG,CAAC,CAAA;AACnE,MAAAG,gBAAA,CAAc,IAAA,CAAK,UAAS,EAAG,IAAA,CAAK,UAAU,IAAA,CAAK,GAAA,EAAK,IAAA,EAAM,CAAC,CAAC,CAAA;AAEhE,MAAA,IAAI,CAAC,KAAK,SAAA,EAAW;AACnB,QAAA,IAAA,CAAK,SAAA,GAAY,IAAA;AAGjB,QAAA,OAAA,CAAQ,GAAA;AAAA,UACN,CAAA,oBAAA,EAAuBH,SAAA,CAAK,IAAA,CAAK,GAAA,EAAK,YAAY,CAAC,CAAA,gEAAA;AAAA,SACrD;AAAA,MACF;AAAA,IACF,CAAA,CAAA,MAAQ;AAAA,IAER;AAEA,IAAA,IAAI,KAAK,QAAA,EAAU,MAAM,IAAA,CAAK,QAAA,CAAS,MAAM,MAAM,CAAA;AAAA,EACrD;AACF;;;AClEA,IAAI,SAAA,GAAY,KAAA;AAmBhB,SAAS,gBAAgB,IAAA,EAAkC;AACzD,EAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,KAAA,CAAM,GAAG,CAAA;AAC5B,EAAA,MAAM,CAAA,GAAI,KAAA,CAAM,OAAA,CAAQ,UAAU,CAAA;AAClC,EAAA,OAAO,CAAA,IAAK,KAAK,KAAA,CAAM,CAAA,GAAI,CAAC,CAAA,GAAI,KAAA,CAAM,CAAA,GAAI,CAAC,CAAA,GAAI,MAAA;AACjD;AAQA,SAAS,SAAS,MAAA,EAAmC;AACnD,EAAA,IAAI;AACF,IAAA,MAAM,IAAI,OAAO,MAAA,EAAQ,IAAA,KAAS,QAAA,GAAW,OAAO,IAAA,GAAO,EAAA;AAC3D,IAAA,IAAI,CAAA,EAAG;AACL,MAAA,MAAM,QAAQ,CAAA,CAAE,KAAA,CAAM,GAAG,CAAA,CAAE,OAAO,OAAO,CAAA;AACzC,MAAA,MAAM,UAAA,GAAa,KAAA,CAAM,MAAA,GAAS,CAAA,KAAM,CAAA,GAAI,KAAA,CAAM,KAAA,CAAM,MAAA,GAAS,CAAC,CAAA,GAAI,KAAA,CAAM,KAAA,CAAM,SAAS,CAAC,CAAA;AAC5F,MAAA,OAAO,EAAE,UAAA,EAAY,SAAA,EAAW,eAAA,CAAgB,CAAC,CAAA,EAAE;AAAA,IACrD;AACA,IAAA,MAAM,KAAK,MAAA,EAAQ,aAAA;AACnB,IAAA,IAAI,EAAA,EAAI;AACN,MAAA,MAAM,aAAa,OAAO,EAAA,CAAG,YAAA,KAAiB,QAAA,GAAW,GAAG,YAAA,GAAe,KAAA,CAAA;AAC3E,MAAA,MAAM,SACJ,OAAO,EAAA,CAAG,YAAY,YAAA,KAAiB,QAAA,GACnC,GAAG,UAAA,CAAW,YAAA,GACd,OAAO,EAAA,CAAG,UAAA,EAAY,aAAa,UAAA,GACjC,MAAA,CAAO,GAAG,UAAA,CAAW,QAAA,EAAU,CAAA,GAC/B,EAAA;AACR,MAAA,OAAO,EAAE,UAAA,EAAY,SAAA,EAAW,SAAS,eAAA,CAAgB,MAAM,IAAI,KAAA,CAAA,EAAU;AAAA,IAC/E;AAAA,EACF,CAAA,CAAA,MAAQ;AAAA,EAER;AACA,EAAA,OAAO,MAAA;AACT;AAEA,SAAS,SAAA,CAAU,MAAe,IAAA,EAAuB;AACvD,EAAA,IAAI;AACF,IAAA,MAAM,OAAQ,IAAA,EAAmC,IAAA;AACjD,IAAA,WAAA,CAAY,OAAO,IAAA,KAAS,QAAA,GAAW,IAAA,GAAO,GAAG,IAAI,CAAA;AAAA,EACvD,CAAA,CAAA,MAAQ;AAAA,EAER;AACF;AACA,SAAS,UAAA,CAAW,GAAW,IAAA,EAAuB;AACpD,EAAA,IAAI;AACF,IAAA,WAAA,CAAY,GAAG,IAAI,CAAA;AAAA,EACrB,CAAA,CAAA,MAAQ;AAAA,EAER;AACF;AAUO,SAAS,sBAAsB,OAAA,EAAiC;AACrE,EAAA,IAAI,SAAA,EAAW;AACf,EAAA,SAAA,GAAY,IAAA;AACZ,EAAA,MAAM,EAAE,KAAA,EAAO,iBAAA,EAAmB,WAAA,EAAa,SAAA,EAAW,gBAAe,GAAI,OAAA;AAG7E,EAAA,MAAM,IAAA,GAAO,OAAO,SAAA,EAAW,GAAA;AAC/B,EAAA,IAAI,IAAA,EAAM;AACR,IAAA,KAAA,CAAO,SAAA,CAAU,GAAA,GAAM,eAAA,GAAkC,IAAA,EAAa;AACpE,MAAA,MAAM,IAAA,GAAO,MAAM,IAAA,CAAK,KAAA,CAAM,MAAM,IAAI,CAAA;AACxC,MAAA,SAAA,CAAU,IAAA,EAAM,QAAA,CAAS,IAAI,CAAC,CAAA;AAC9B,MAAA,OAAO,IAAA;AAAA,IACT,CAAA;AAAA,EACF;AAGA,EAAA,MAAM,IAAA,GAAO,mBAAmB,SAAA,EAAW,GAAA;AAC3C,EAAA,IAAI,IAAA,EAAM;AACR,IAAA,iBAAA,CAAmB,SAAA,CAAU,GAAA,GAAM,eAAA,GAAkC,IAAA,EAAa;AAChF,MAAA,MAAM,IAAA,GAAO,MAAM,IAAA,CAAK,KAAA,CAAM,MAAM,IAAI,CAAA;AACxC,MAAA,UAAA,CAAW,CAAA,EAAG,QAAA,CAAS,IAAI,CAAC,CAAA;AAC5B,MAAA,OAAO,IAAA;AAAA,IACT,CAAA;AAAA,EACF;AAGA,EAAA,MAAM,IAAA,GAAO,aAAa,SAAA,EAAW,GAAA;AACrC,EAAA,IAAI,IAAA,EAAM;AACR,IAAA,WAAA,CAAa,SAAA,CAAU,GAAA,GAAM,eAAA,GAAkC,IAAA,EAAa;AAC1E,MAAA,MAAM,GAAA,GAAM,MAAM,IAAA,CAAK,KAAA,CAAM,MAAM,IAAI,CAAA;AACvC,MAAA,SAAA,CAAU,GAAA,EAAK,QAAA,CAAS,IAAA,CAAK,CAAC,CAAC,CAAC,CAAA;AAChC,MAAA,OAAO,GAAA;AAAA,IACT,CAAA;AAAA,EACF;AAGA,EAAA,MAAM,OAAA,GAAU,aAAa,SAAA,EAAW,MAAA;AACxC,EAAA,IAAI,OAAA,EAAS;AACX,IAAA,WAAA,CAAa,SAAA,CAAU,MAAA,GAAS,eAAA,GAAkC,IAAA,EAAa;AAC7E,MAAA,MAAM,GAAA,GAAM,MAAM,OAAA,CAAQ,KAAA,CAAM,MAAM,IAAI,CAAA;AAC1C,MAAA,UAAA,CAAW,KAAA,CAAM,OAAA,CAAQ,GAAG,CAAA,GAAI,GAAA,CAAI,MAAA,GAAS,IAAA,CAAK,MAAA,IAAU,CAAA,EAAG,QAAA,CAAS,IAAA,CAAK,CAAC,CAAC,CAAC,CAAA;AAChF,MAAA,OAAO,GAAA;AAAA,IACT,CAAA;AAAA,EACF;AAGA,EAAA,MAAM,OAAA,GAAU,WAAW,SAAA,EAAW,MAAA;AACtC,EAAA,IAAI,OAAA,EAAS;AACX,IAAA,SAAA,CAAW,SAAA,CAAU,MAAA,GAAS,eAAA,GAAkC,IAAA,EAAa;AAC3E,MAAA,MAAM,GAAA,GAAM,MAAM,OAAA,CAAQ,KAAA,CAAM,MAAM,IAAI,CAAA;AAC1C,MAAA,UAAA,CAAW,KAAA,CAAM,OAAA,CAAQ,GAAG,CAAA,GAAI,GAAA,CAAI,MAAA,GAAS,IAAA,CAAK,MAAA,IAAU,CAAA,EAAG,QAAA,CAAS,IAAA,CAAK,CAAC,CAAC,CAAC,CAAA;AAChF,MAAA,OAAO,GAAA;AAAA,IACT,CAAA;AAAA,EACF;AAOA,EAAA,MAAM,IAAA,GAAO,gBAAgB,SAAA,EAAW,GAAA;AACxC,EAAA,IAAI,IAAA,EAAM;AACR,IAAA,cAAA,CAAgB,SAAA,CAAU,GAAA,GAAM,eAAA,GAAkC,IAAA,EAAa;AAC7E,MAAA,MAAM,IAAA,GAAO,MAAM,IAAA,CAAK,KAAA,CAAM,MAAM,IAAI,CAAA;AACxC,MAAA,IAAI;AACF,QAAA,MAAM,IAAA,GAAQ,MAAqD,IAAA,IAAO;AAC1E,QAAA,MAAM,QAAQ,OAAO,IAAA,EAAM,KAAA,KAAU,QAAA,GAAW,KAAK,KAAA,GAAQ,CAAA;AAC7D,QAAA,UAAA,CAAW,IAAA,CAAK,GAAA,CAAI,CAAA,EAAG,IAAA,CAAK,IAAA,CAAK,KAAA,GAAQ,GAAI,CAAC,CAAA,EAAG,QAAA,CAAS,IAAI,CAAC,CAAA;AAAA,MACjE,CAAA,CAAA,MAAQ;AAAA,MAER;AACA,MAAA,OAAO,IAAA;AAAA,IACT,CAAA;AAAA,EACF;AAOA,EAAA,MAAM,eAAA,GAAkB,CAAC,KAAA,EAA2C,MAAA,KAA0B;AAC5F,IAAA,MAAM,OAAO,KAAA,EAAO,UAAA;AACpB,IAAA,IAAI,CAAC,IAAA,EAAM;AACX,IAAA,KAAA,CAAO,UAAA,GAAa,YAA4B,IAAA,EAAa;AAC3D,MAAA,MAAM,IAAA,GAAO,SAAS,IAAI,CAAA;AAC1B,MAAA,MAAM,IAAI,IAAA,CAAK,SAAA,CAAU,CAAC,CAAA,KAAM,OAAO,MAAM,UAAU,CAAA;AACvD,MAAA,IAAI,KAAK,CAAA,EAAG;AACV,QAAA,MAAM,MAAA,GAAS,KAAK,CAAC,CAAA;AACrB,QAAA,IAAA,CAAK,CAAC,CAAA,GAAI,SAAU,IAAA,EAAW;AAC7B,UAAA,IAAI;AACF,YAAA,MAAM,IAAI,MAAA,GACN,CAAA,GACA,OAAO,IAAA,EAAM,eAAe,UAAA,GAC1B,IAAA,CAAK,UAAA,EAAW,CAAE,SAClB,OAAO,IAAA,EAAM,IAAA,KAAS,QAAA,GACpB,KAAK,IAAA,GACL,CAAA;AACR,YAAA,IAAI,CAAA,GAAI,CAAA,EAAG,UAAA,CAAW,CAAA,EAAG,IAAI,CAAA;AAAA,UAC/B,CAAA,CAAA,MAAQ;AAAA,UAER;AACA,UAAA,OAAO,OAAO,IAAI,CAAA;AAAA,QACpB,CAAA;AAAA,MACF;AACA,MAAA,OAAO,IAAA,CAAK,KAAA,CAAM,IAAA,EAAM,IAAI,CAAA;AAAA,IAC9B,CAAA;AAAA,EACF,CAAA;AACA,EAAA,eAAA,CAAgB,KAAA,EAAO,WAAW,KAAK,CAAA;AACvC,EAAA,eAAA,CAAgB,iBAAA,EAAmB,WAAW,IAAI,CAAA;AACpD;;;ACvKO,SAAS,IAAA,CAAK,OAAA,GAAuB,EAAC,EAAS;AAEpD,EAAA,MAAM,QAAA,GACJ,OAAA,CAAQ,IAAA,KAAS,OAAA,CAAQ,SAAS,IAAI,UAAA,CAAW,EAAE,MAAA,EAAQ,QAAQ,MAAA,EAAQ,QAAA,EAAU,OAAA,CAAQ,QAAA,EAAU,CAAA,GAAI,IAAA,CAAA;AAE7G,EAAA,MAAMI,QACJ,OAAA,CAAQ,MAAA,KAAW,KAAA,GACf,QAAA,IAAY,IAAI,QAAA,EAAS,GACzB,IAAI,UAAA,CAAW,UAAU,OAAO,OAAA,CAAQ,WAAW,QAAA,GAAW,OAAA,CAAQ,SAAS,kBAAkB,CAAA;AACvG,EAAA,cAAA,CAAe,EAAE,MAAAA,KAAAA,EAAM,eAAA,EAAiB,QAAQ,eAAA,EAAiB,OAAA,EAAS,OAAA,CAAQ,OAAA,EAAS,CAAA;AAC3F,EAAA,IAAI,OAAA,CAAQ,SAAA,EAAW,qBAAA,CAAsB,OAAA,CAAQ,SAAS,CAAA;AAChE","file":"index.js","sourcesContent":["/**\n * cost-context — the request-scoped tag every counted operation attributes\n * itself to. Set it ONCE at a boundary (or wrap a path with `bucket()`); it\n * rides Node's AsyncLocalStorage down through every async fan-out, so one\n * handler that triggers 15 reads attributes all 15 to the same bucket — with\n * zero per-call-site work.\n *\n * Generic by design: unlike a hardcoded product taxonomy, the only meaningful\n * field a consumer sets is the free-form `label` (the bucket name). `feature`\n * is an optional coarse grouping if you want one; nothing here is\n * Crossdeck-specific.\n */\nimport { AsyncLocalStorage } from \"node:async_hooks\";\n\nexport interface CostTag {\n  /** Optional coarse grouping (a caller-defined surface name). */\n  feature?: string;\n  /** The bucket name — what `bucket()` sets. Drives the report's `byLabel`. */\n  label?: string;\n}\n\nconst DEFAULT_TAG: CostTag = {};\nconst store = new AsyncLocalStorage<CostTag>();\n\n/** Run `fn` with `tag` bound for its entire async subtree. */\nexport function runWithCostTag<T>(tag: CostTag, fn: () => T): T {\n  return store.run({ ...tag }, fn);\n}\n\n/** Bind a tag for the remainder of the current async context (no closure to wrap). */\nexport function enterCostTag(tag: CostTag): void {\n  store.enterWith({ ...tag });\n}\n\n/** Refine the live tag in place (e.g. stamp a feature after the boundary). */\nexport function refineCostTag(patch: Partial<CostTag>): void {\n  const cur = store.getStore();\n  if (cur) Object.assign(cur, patch);\n}\n\n/** The current tag, or a safe empty default outside any bound context. */\nexport function currentCostTag(): CostTag {\n  return store.getStore() ?? DEFAULT_TAG;\n}\n\n/** Hierarchy separator for bucket paths — Firestore-map-key-safe and distinct from\n *  the \"col:\" leaf prefix. `bucket(\"a\", () => bucket(\"b\", …))` → \"a>b\". */\nexport const BUCKET_SEP = \">\";\n\n/**\n * `bucket(name, fn)` — the headline verb, the `track()` of cost. Run `fn` with\n * every operation inside it attributed to the bucket `name`; the attribution rides\n * the async subtree automatically. NESTS: a `bucket()` inside another COMPOSES into\n * a path (`\"analytics\" > \"rollup\"` → `\"analytics>rollup\"`), so the dashboard can\n * drill from the coarse bucket down into its parts. The one verb most developers touch:\n *\n *   await bucket(\"analytics\", () =>\n *     bucket(\"rollup\", () => db.collection(\"events\").where(...).get())); // → \"analytics>rollup>col:events\"\n */\nexport function bucket<T>(name: string, fn: () => T): T {\n  const parent = currentCostTag().label;\n  const path = parent ? `${parent}${BUCKET_SEP}${name}` : name;\n  return runWithCostTag({ ...currentCostTag(), label: path }, fn);\n}\n","/**\n * cost-meter — counts operations against the ambient tag and flushes them to the\n * configured Sink cheaply.\n *\n * LOW-OVERHEAD CONTRACT (the thing that warns you about reads must not run them\n * up): counts accumulate in an in-memory buffer and flush periodically — NEVER one\n * network call per counted operation. A flush coalesces the whole window into one\n * report per UTC day and hands it to the Sink. At steady state that is ~1 small\n * request a minute, regardless of how many ops you served.\n *\n * BEST-EFFORT CONTRACT: metering must never throw into your code. Every recorder\n * swallows its own errors; a failed flush drops that window's counts (surfaced via\n * `onError` if you pass one) rather than disturbing the app.\n */\nimport { currentCostTag } from \"./cost-context\";\nimport type { Sink, BucketsReport, ResourceCounts } from \"./sink\";\n\n/**\n * A resource unit — what an adapter counts. Firestore emits `read`/`write`/\n * `delete`; other adapters emit their own (`clickhouse.query_ms`, `openai.tokens`).\n * It is a free identifier on purpose, BUT each one is kept entirely distinct: the\n * meter only ever sums quantities WITHIN a single resource, never across two.\n */\nexport type ResourceUnit = string;\n/** @deprecated — Firestore-era name; use {@link ResourceUnit}. */\nexport type OpType = ResourceUnit;\n\n/** Optional read-site hint — the collection touched, derived at the trap from the\n *  path. Lets an UNtagged read cascade to `col:<collection>` instead of vanishing. */\nexport interface CostHint {\n  collection?: string;\n  projectId?: string;\n}\n\n// NUL separator — a bucket/collection name can contain almost anything except\n// this, so the key never collides with a name that has a \"|\" or \":\" in it.\nconst SEP = \"\\u001f\"; // ASCII Unit Separator\n\n/** key = date <NUL> resource <NUL> label → count */\nconst labelBuffer = new Map<string, number>();\n/** key = date <NUL> resource <NUL> hour → count */\nconst hourBuffer = new Map<string, number>();\n/** key = date <NUL> resource <NUL> 5-min-slot (\"HHMM\") → count. The fine grain\n *  that lets a developer verify against the provider console's \"last hour\" within\n *  minutes of installing — not after a day. Still one maintained doc, zero reads. */\nconst minuteBuffer = new Map<string, number>();\n\nlet sink: Sink | null = null;\nlet flushIntervalMs = 60_000;\nlet onError: ((e: unknown) => void) | null = null;\nlet timer: ReturnType<typeof setInterval> | null = null;\nlet flushing = false;\n/** Safety valve — flush early if a burst fills the buffer between intervals. */\nconst MAX_BUFFER_KEYS = 5_000;\n\nexport interface MeterConfig {\n  sink: Sink;\n  flushIntervalMs?: number;\n  onError?: (e: unknown) => void;\n}\n\n/** Point the meter at a sink. Called by `init()`; pass your own sink to self-host. */\nexport function configureMeter(config: MeterConfig): void {\n  sink = config.sink;\n  if (config.flushIntervalMs && config.flushIntervalMs > 0) flushIntervalMs = config.flushIntervalMs;\n  onError = config.onError ?? null;\n}\n\nconst utcDate = (): string => new Date().toISOString().slice(0, 10);\nconst utcHour = (): string => new Date().toISOString().slice(11, 13);\n/** UTC 5-minute slot of the day as \"HHMM\" — the slot START (e.g. 08:47 → \"0845\"). */\nconst utcFiveMin = (): string => {\n  const iso = new Date().toISOString();\n  const hh = iso.slice(11, 13);\n  const mm = Math.floor(Number(iso.slice(14, 16)) / 5) * 5;\n  return hh + String(mm).padStart(2, \"0\");\n};\n\nfunction ensureFlushLoop(): void {\n  if (timer) return;\n  timer = setInterval(() => void flush(), flushIntervalMs);\n  // Don't keep the event loop alive just for metering.\n  (timer as { unref?: () => void }).unref?.();\n  // Flush the last window on shutdown.\n  process.once?.(\"SIGTERM\", () => void flush());\n  process.once?.(\"beforeExit\", () => void flush());\n}\n\n/**\n * Count `quantity` of a `resource` against the live tag. THE adapter primitive —\n * a Firestore adapter records \"read\"; a ClickHouse adapter records\n * \"clickhouse.query_ms\"; an OpenAI adapter records \"openai.tokens\". Each resource\n * is bucketed entirely on its own; nothing is ever added across resources. Never\n * throws.\n */\nexport function record(resource: ResourceUnit, quantity: number, hint?: CostHint): void {\n  try {\n    if (!Number.isFinite(quantity) || quantity <= 0) return;\n    const t = currentCostTag();\n    const date = utcDate();\n    // HIERARCHY — the bucket path is the trunk; the collection is the LEAF kept\n    // beneath it (so a tagged bucket still drills down to which collections it\n    // read). \"analytics\" + events → \"analytics>col:events\"; untagged → \"col:events\";\n    // nothing derivable → \"uncategorized\". A unit is never invisible, and a tagged\n    // one never loses where it actually went.\n    const coll = hint?.collection ? `col:${hint.collection}` : null;\n    const label = t.label\n      ? coll\n        ? `${t.label}>${coll}`\n        : t.label\n      : coll ?? \"uncategorized\";\n    // Key includes the resource, so each resource accumulates in its OWN slot.\n    const lk = date + SEP + resource + SEP + label;\n    labelBuffer.set(lk, (labelBuffer.get(lk) ?? 0) + quantity);\n    const hk = date + SEP + resource + SEP + utcHour();\n    hourBuffer.set(hk, (hourBuffer.get(hk) ?? 0) + quantity);\n    const mk = date + SEP + resource + SEP + utcFiveMin();\n    minuteBuffer.set(mk, (minuteBuffer.get(mk) ?? 0) + quantity);\n    ensureFlushLoop();\n    if (labelBuffer.size + hourBuffer.size + minuteBuffer.size > MAX_BUFFER_KEYS) void flush();\n  } catch {\n    /* metering is best-effort — never disturb the caller */\n  }\n}\n\n/** @deprecated — use {@link record}. Firestore-era alias. */\nexport const recordFirestore = record;\n\n/** Firestore bills a minimum of one read even for an empty result, so 0 counts as 1. */\nexport function recordReads(n: number, hint?: CostHint): void {\n  record(\"read\", Math.max(n, 1), hint);\n}\nexport function recordWrites(n = 1): void {\n  record(\"write\", n);\n}\nexport function recordDeletes(n = 1): void {\n  record(\"delete\", n);\n}\n\nfunction add(target: Record<string, ResourceCounts>, key: string, resource: ResourceUnit, n: number): void {\n  const bag = (target[key] ??= {});\n  // Accumulate WITHIN this resource only — never merge resources.\n  bag[resource] = (bag[resource] ?? 0) + n;\n}\n\n/**\n * Coalesce the buffer into one report per UTC day and hand each to the Sink.\n * Snapshots + clears up front so concurrent records land in the next window.\n * Never throws; a sink failure drops that window (surfaced via `onError`).\n */\nexport async function flush(): Promise<void> {\n  if (flushing) return;\n  // Not configured (init not called) — drop, don't grow unbounded.\n  if (!sink) {\n    labelBuffer.clear();\n    hourBuffer.clear();\n    minuteBuffer.clear();\n    return;\n  }\n  if (labelBuffer.size === 0 && hourBuffer.size === 0 && minuteBuffer.size === 0) return;\n  flushing = true;\n\n  const labels = new Map(labelBuffer);\n  const hours = new Map(hourBuffer);\n  const minutes = new Map(minuteBuffer);\n  labelBuffer.clear();\n  hourBuffer.clear();\n  minuteBuffer.clear();\n\n  try {\n    const byDate = new Map<string, BucketsReport>();\n    const reportFor = (date: string): BucketsReport => {\n      let r = byDate.get(date);\n      if (!r) {\n        r = { date, byLabel: {}, byHour: {}, byMinute: {} };\n        byDate.set(date, r);\n      }\n      return r;\n    };\n    for (const [k, n] of labels) {\n      const [date, op, label] = k.split(SEP) as [string, OpType, string];\n      add(reportFor(date).byLabel, label, op, n);\n    }\n    for (const [k, n] of hours) {\n      const [date, op, hour] = k.split(SEP) as [string, OpType, string];\n      add(reportFor(date).byHour!, hour, op, n);\n    }\n    for (const [k, n] of minutes) {\n      const [date, op, slot] = k.split(SEP) as [string, OpType, string];\n      add(reportFor(date).byMinute!, slot, op, n);\n    }\n    for (const report of byDate.values()) {\n      await sink.flush(report);\n    }\n  } catch (e) {\n    // Drop this window rather than risk a partial/double report on retry.\n    onError?.(e);\n  } finally {\n    flushing = false;\n  }\n}\n","/**\n * sink — where the meter sends a coalesced rollup, and the wire shape it sends.\n *\n * Abstracting the sink is what makes Buckets storage-agnostic: the meter never\n * knows where counts go. The DEFAULT sink (`ReportSink`) reports up to Crossdeck's\n * ingest endpoint so the numbers surface on your Crossdeck dashboard. A team that\n * wants to self-host can implement `Sink` against anything (Postgres, a file, your\n * own API) without touching the meter.\n */\n\n/**\n * Counts for ONE bucket, keyed by RESOURCE UNIT — the raw quantity of each unit,\n * nothing more (no money; you verify cost on your provider's bill).\n *\n * Firestore, the first adapter, emits `read` / `write` / `delete`. Other adapters\n * emit their own units (`clickhouse.query_ms`, `openai.tokens`, …). The rule that\n * keeps this honest: **each resource is its own line. Counts are only ever summed\n * WITHIN a resource, NEVER across one.** A read is not a query-millisecond; the two\n * never land in the same number. (There is deliberately no \"total units\" field.)\n */\nexport interface ResourceCounts {\n  read?: number;\n  write?: number;\n  delete?: number;\n  /** Any other resource unit an adapter emits — kept distinct, never merged. */\n  [resource: string]: number | undefined;\n}\n\n/** @deprecated name — kept for back-compat; use {@link ResourceCounts}. */\nexport type OpCounts = ResourceCounts;\n\n/**\n * One coalesced report — the wire contract (see docs/ROLLUP_SCHEMA.md). The meter\n * produces one of these per UTC day in a flush window (usually exactly one).\n */\nexport interface BucketsReport {\n  /** UTC day \"YYYY-MM-DD\". */\n  date: string;\n  /** bucket name → counts. The heart of the report. */\n  byLabel: Record<string, ResourceCounts>;\n  /** UTC hour \"HH\" → counts, for the hourly \"did my fix land this hour?\" view. */\n  byHour?: Record<string, ResourceCounts>;\n  /** UTC 5-minute slot \"HHMM\" (slot start) → counts. The fine grain for fast\n   *  verification against a provider console's \"last hour\" view. */\n  byMinute?: Record<string, ResourceCounts>;\n}\n\n/**\n * A destination for coalesced rollups. `flush` MAY throw on failure — the meter\n * catches it, drops that one window, and never lets it reach your app.\n */\nexport interface Sink {\n  flush(report: BucketsReport): Promise<void>;\n}\n\nexport interface ReportSinkConfig {\n  /** The project's `cd_sk_` secret key. Server-to-server only. */\n  apiKey: string;\n  /** Defaults to https://api.cross-deck.com/v1/buckets/report */\n  endpoint?: string;\n  /** Request timeout (ms); a slow Crossdeck must never stall your flush. */\n  timeoutMs?: number;\n}\n\nconst DEFAULT_ENDPOINT = \"https://api.cross-deck.com/v1/buckets/report\";\n\n/**\n * The default sink: POST one coalesced rollup to Crossdeck's ingest endpoint.\n * The ingest folds it into the day's maintained doc with `increment`, so many\n * reports a minute coalesce safely. This path does ZERO database reads — it sends\n * a summary, it does not read. Throws on a non-202 so the meter can log/drop the\n * window; the meter guarantees it never reaches your app.\n */\nexport class ReportSink implements Sink {\n  private readonly endpoint: string;\n  private readonly apiKey: string;\n  private readonly timeoutMs: number;\n\n  constructor(config: ReportSinkConfig) {\n    this.endpoint = config.endpoint ?? DEFAULT_ENDPOINT;\n    this.apiKey = config.apiKey;\n    this.timeoutMs = config.timeoutMs ?? 5000;\n  }\n\n  async flush(report: BucketsReport): Promise<void> {\n    const res = await fetch(this.endpoint, {\n      method: \"POST\",\n      signal: AbortSignal.timeout(this.timeoutMs),\n      headers: {\n        \"content-type\": \"application/json\",\n        authorization: `Bearer ${this.apiKey}`,\n      },\n      body: JSON.stringify(report),\n    });\n    if (res.status !== 202) {\n      throw new Error(`Buckets report rejected: HTTP ${res.status}`);\n    }\n  }\n}\n\n/**\n * A sink that does nothing. Used when the local mirror is turned off AND no upstream\n * was configured — the meter still needs a sink to flush into, but there's nowhere to\n * send. Counts are dropped by the developer's explicit choice.\n */\nexport class NullSink implements Sink {\n  async flush(): Promise<void> {\n    /* intentionally empty */\n  }\n}\n","/**\n * readout — renders the local file a developer (or their AI session) reads back with\n * \"read me my buckets\". PURE string building: no I/O, no database reads. The node\n * mirror (./mirror) writes this to `.crossdeck/buckets.md` on each flush, so the\n * readout works offline, for free, with no account.\n */\nimport type { BucketsReport, ResourceCounts } from \"./sink\";\n\n/**\n * The one line that closes every readout. Plain and factual: what the OSS shows you\n * here, and what signing up adds — for free. No invented numbers, no urgency, no pitch.\n */\nexport const READOUT_FOOTER =\n  \"Buckets OSS shows the reads on this surface. Sign up to Crossdeck (free) to see \" +\n  \"every surface in one view, drill any bucket down to the exact query, track a fix \" +\n  \"before and after, and get paged when reads spike — cross-deck.com\";\n\nfunction fmt(n: number): string {\n  if (n >= 1_000_000) return (n / 1_000_000).toFixed(2) + \"M\";\n  if (n >= 10_000) return Math.round(n / 1000) + \"K\";\n  if (n >= 1000) return (n / 1000).toFixed(1) + \"K\";\n  return String(Math.round(n));\n}\n\n/** A bucket is untagged when its ROOT segment is a bare collection / catch-all. */\nfunction isUntagged(label: string): boolean {\n  const root = label.split(\">\")[0];\n  return root.startsWith(\"col:\") || root === \"uncategorized\" || root === \"unknown\";\n}\n\n/** Pretty path: strip the \"col:\" leaf prefix, join the hierarchy with \" › \". */\nfunction displayLabel(label: string): string {\n  return label\n    .split(\">\")\n    .map((s) => (s.startsWith(\"col:\") ? s.slice(4) : s))\n    .join(\" › \");\n}\n\n/** Render the day's coalesced report as a human/AI-readable markdown readout. */\nexport function renderReadout(report: BucketsReport): string {\n  const entries = Object.entries(report.byLabel ?? {})\n    .map(([label, counts]) => ({ label, reads: (counts as ResourceCounts).read ?? 0 }))\n    .filter((e) => e.reads > 0)\n    .sort((a, b) => b.reads - a.reads);\n\n  const total = entries.reduce((s, e) => s + e.reads, 0);\n  const out: string[] = [];\n  out.push(`# Buckets — reads on this surface`);\n  out.push(``);\n  out.push(`**${fmt(total)} reads** · ${report.date} (UTC)`);\n  out.push(``);\n\n  if (entries.length === 0) {\n    out.push(`No reads metered yet — install the collector and let your app serve some traffic.`);\n  } else {\n    out.push(`| bucket | named | reads |`);\n    out.push(`| --- | :---: | ---: |`);\n    for (const e of entries) {\n      out.push(`| ${displayLabel(e.label)} | ${isUntagged(e.label) ? \"—\" : \"✓\"} | ${fmt(e.reads)} |`);\n    }\n  }\n\n  out.push(``);\n  out.push(`---`);\n  out.push(READOUT_FOOTER);\n  out.push(``);\n  return out.join(\"\\n\");\n}\n","/**\n * mirror — tees every coalesced report to a local file so \"read me my buckets\" works\n * offline, free, with no account. Writes a human/AI-readable readout\n * (`.crossdeck/buckets.md`) plus the raw report (`.crossdeck/buckets.json`).\n *\n * NODE ONLY — never imported by the browser build (it touches the filesystem).\n *\n * Two contracts it keeps:\n *  - NO MONSTER: it only ever WRITES local files (~one small write a minute). It never\n *    reads your database; the report is already in hand.\n *  - BEST-EFFORT: a write error is swallowed — the local mirror must never disturb a\n *    flush or reach your app.\n *\n * The meter hands each flush a DELTA (the window's counts, then clears). To show the\n * day's running total, the mirror accumulates deltas in memory, seeded once from any\n * existing file so a process restart doesn't shrink the readout.\n */\nimport { mkdirSync, writeFileSync, readFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport type { Sink, BucketsReport, ResourceCounts } from \"./sink\";\nimport { renderReadout } from \"./readout\";\n\nexport const DEFAULT_MIRROR_DIR = \".crossdeck\";\n\nfunction mergeInto(target: Record<string, ResourceCounts>, src?: Record<string, ResourceCounts>): void {\n  if (!src) return;\n  for (const [key, counts] of Object.entries(src)) {\n    const bag = (target[key] ??= {});\n    for (const [res, n] of Object.entries(counts)) {\n      if (typeof n === \"number\") bag[res] = (bag[res] ?? 0) + n;\n    }\n  }\n}\n\n/**\n * Wraps an optional upstream sink. On each flush it writes the running day-total\n * locally, THEN (if an upstream sink was given — i.e. a key) reports onward.\n * With no upstream it is a pure local meter: the wedge, working with no account.\n */\nexport class MirrorSink implements Sink {\n  private acc: BucketsReport | null = null;\n  private announced = false;\n  private seeded = false;\n\n  constructor(\n    private readonly upstream: Sink | null,\n    private readonly dir: string = DEFAULT_MIRROR_DIR,\n  ) {}\n\n  private jsonPath(): string {\n    return join(this.dir, \"buckets.json\");\n  }\n\n  /** Seed the running total once from an existing same-day file (survives restarts). */\n  private seed(date: string): void {\n    if (this.seeded) return;\n    this.seeded = true;\n    try {\n      const prior = JSON.parse(readFileSync(this.jsonPath(), \"utf8\")) as BucketsReport;\n      if (prior?.date === date && prior.byLabel) this.acc = prior;\n    } catch {\n      /* no prior file (or unreadable) — start fresh */\n    }\n  }\n\n  async flush(report: BucketsReport): Promise<void> {\n    // Local first — the part that always works, key or no key.\n    try {\n      this.seed(report.date);\n      if (!this.acc || this.acc.date !== report.date) {\n        this.acc = { date: report.date, byLabel: {}, byHour: {}, byMinute: {} };\n      }\n      mergeInto(this.acc.byLabel, report.byLabel);\n      mergeInto((this.acc.byHour ??= {}), report.byHour);\n      mergeInto((this.acc.byMinute ??= {}), report.byMinute);\n\n      mkdirSync(this.dir, { recursive: true });\n      writeFileSync(join(this.dir, \"buckets.md\"), renderReadout(this.acc));\n      writeFileSync(this.jsonPath(), JSON.stringify(this.acc, null, 2));\n\n      if (!this.announced) {\n        this.announced = true;\n        // One quiet line, once, so a developer knows where to read it back.\n        // eslint-disable-next-line no-console\n        console.log(\n          `Buckets: readout at ${join(this.dir, \"buckets.md\")} — open it, or ask your AI session to \"read me my buckets\".`,\n        );\n      }\n    } catch {\n      /* local mirror is best-effort */\n    }\n\n    if (this.upstream) await this.upstream.flush(report);\n  }\n}\n","/**\n * adapters/firestore — the universal Firestore read meter (the trap).\n *\n * THE LESSON (learned on a real product): per-call-site `recordReads()`\n * instrumentation MISSES paths. You meter the read sites you're looking at and\n * leave the cron / trigger / ingest path uncounted — often the majority of reads,\n * invisible. Humans tag what they see and miss the path that matters.\n *\n * THE FIX: patch the admin SDK's read methods ONCE. From install onward, EVERY\n * read — anywhere, on any code path — is counted under the ambient tag, with zero\n * per-call-site work and no blind spots.\n *\n * SAFETY CONTRACT — this sits on your production read path, so it is defensive by\n * construction. Each wrapper:\n *   1. calls the REAL method first and captures the result,\n *   2. counts in a try/catch that can never throw into the caller,\n *   3. ALWAYS returns the real result, untouched.\n * It cannot break a read, change a result, or add latency beyond one in-memory\n * counter increment. A wrong count is a measurement error, never a correctness or\n * availability one. Idempotent — calling it twice patches once.\n *\n * COUNTING MODEL — a query returning N docs = N reads (an empty result still bills\n * 1, which the meter enforces). A document get = 1. getAll(...) = the ref count.\n * CollectionReference.get IS Query.get (shared prototype method), so patching Query\n * covers collections with no double-count.\n */\nimport { recordReads, type CostHint } from \"../cost-meter\";\n\nlet installed = false;\n\n/* eslint-disable @typescript-eslint/no-explicit-any */\ntype AnyFn = (...args: any[]) => any;\n\n/**\n * The firebase-admin Firestore classes to patch. Pass the module namespace from\n * `firebase-admin/firestore` — only the prototypes present are patched.\n */\nexport interface FirestoreClasses {\n  Query?: { prototype: { get?: AnyFn; onSnapshot?: AnyFn } };\n  DocumentReference?: { prototype: { get?: AnyFn; onSnapshot?: AnyFn } };\n  Transaction?: { prototype: { get?: AnyFn; getAll?: AnyFn } };\n  Firestore?: { prototype: { getAll?: AnyFn } };\n  /** count() / sum() / average() — aggregation queries bill reads too. */\n  AggregateQuery?: { prototype: { get?: AnyFn } };\n}\n\n/** `projects/{id}/…` → the project id, else undefined. Pure string op. */\nfunction projectFromPath(path: string): string | undefined {\n  const parts = path.split(\"/\");\n  const i = parts.indexOf(\"projects\");\n  return i >= 0 && parts[i + 1] ? parts[i + 1] : undefined;\n}\n\n/**\n * Derive { collection, projectId } from the read target's path so an UNtagged read\n * cascades to `col:<collection>` instead of \"uncategorized\". PURE CPU; never reads,\n * never throws. Falls back to firebase-admin's internal `_queryOptions` for filtered\n * queries (which don't expose `.path`).\n */\nfunction hintFrom(target: any): CostHint | undefined {\n  try {\n    const p = typeof target?.path === \"string\" ? target.path : \"\";\n    if (p) {\n      const parts = p.split(\"/\").filter(Boolean);\n      const collection = parts.length % 2 === 0 ? parts[parts.length - 2] : parts[parts.length - 1];\n      return { collection, projectId: projectFromPath(p) };\n    }\n    const qo = target?._queryOptions;\n    if (qo) {\n      const collection = typeof qo.collectionId === \"string\" ? qo.collectionId : undefined;\n      const parent =\n        typeof qo.parentPath?.relativeName === \"string\"\n          ? qo.parentPath.relativeName\n          : typeof qo.parentPath?.toString === \"function\"\n            ? String(qo.parentPath.toString())\n            : \"\";\n      return { collection, projectId: parent ? projectFromPath(parent) : undefined };\n    }\n  } catch {\n    /* the meter must never throw */\n  }\n  return undefined;\n}\n\nfunction meterSnap(snap: unknown, hint?: CostHint): void {\n  try {\n    const size = (snap as { size?: number } | null)?.size;\n    recordReads(typeof size === \"number\" ? size : 1, hint);\n  } catch {\n    /* best-effort */\n  }\n}\nfunction meterCount(n: number, hint?: CostHint): void {\n  try {\n    recordReads(n, hint);\n  } catch {\n    /* best-effort */\n  }\n}\n\n/**\n * Install the universal read meter on the firebase-admin Firestore classes. Call\n * ONCE at process start, before any reads. Pass the namespace from\n * `firebase-admin/firestore` so the exact prototypes the SDK uses are patched:\n *\n *   import * as Firestore from \"firebase-admin/firestore\";\n *   installFirestoreMeter(Firestore);\n */\nexport function installFirestoreMeter(classes: FirestoreClasses): void {\n  if (installed) return;\n  installed = true;\n  const { Query, DocumentReference, Transaction, Firestore, AggregateQuery } = classes;\n\n  // Query.get — covers Query AND CollectionReference (shared prototype method).\n  const qGet = Query?.prototype?.get;\n  if (qGet) {\n    Query!.prototype.get = async function (this: unknown, ...args: any[]) {\n      const snap = await qGet.apply(this, args);\n      meterSnap(snap, hintFrom(this));\n      return snap;\n    };\n  }\n\n  // DocumentReference.get — a single doc = 1 read.\n  const dGet = DocumentReference?.prototype?.get;\n  if (dGet) {\n    DocumentReference!.prototype.get = async function (this: unknown, ...args: any[]) {\n      const snap = await dGet.apply(this, args);\n      meterCount(1, hintFrom(this));\n      return snap;\n    };\n  }\n\n  // Transaction.get — query or doc; size when present, else 1.\n  const tGet = Transaction?.prototype?.get;\n  if (tGet) {\n    Transaction!.prototype.get = async function (this: unknown, ...args: any[]) {\n      const res = await tGet.apply(this, args);\n      meterSnap(res, hintFrom(args[0]));\n      return res;\n    };\n  }\n\n  // Transaction.getAll(...refs) — one read per ref.\n  const tGetAll = Transaction?.prototype?.getAll;\n  if (tGetAll) {\n    Transaction!.prototype.getAll = async function (this: unknown, ...args: any[]) {\n      const res = await tGetAll.apply(this, args);\n      meterCount(Array.isArray(res) ? res.length : args.length || 1, hintFrom(args[0]));\n      return res;\n    };\n  }\n\n  // Firestore.getAll(...refs) — batched doc reads.\n  const fGetAll = Firestore?.prototype?.getAll;\n  if (fGetAll) {\n    Firestore!.prototype.getAll = async function (this: unknown, ...args: any[]) {\n      const res = await fGetAll.apply(this, args);\n      meterCount(Array.isArray(res) ? res.length : args.length || 1, hintFrom(args[0]));\n      return res;\n    };\n  }\n\n  // AggregateQuery.get — count() / sum() / average(). Firestore bills one read per\n  // up to 1000 index entries scanned, and the client never sees that entry count —\n  // so this is an HONEST ESTIMATE: for count() we derive it from the result\n  // (ceil(count / 1000)), else the billed minimum of 1. Observe-only: it reads the\n  // result you already got, adds zero reads. (Closes the aggregation blind spot.)\n  const aGet = AggregateQuery?.prototype?.get;\n  if (aGet) {\n    AggregateQuery!.prototype.get = async function (this: unknown, ...args: any[]) {\n      const snap = await aGet.apply(this, args);\n      try {\n        const data = (snap as { data?: () => { count?: number } } | null)?.data?.();\n        const count = typeof data?.count === \"number\" ? data.count : 0;\n        meterCount(Math.max(1, Math.ceil(count / 1000)), hintFrom(this));\n      } catch {\n        /* best-effort */\n      }\n      return snap;\n    };\n  }\n\n  // Query.onSnapshot / DocumentReference.onSnapshot — server-side realtime\n  // listeners. We OBSERVE: wrap onNext and count the docs each fire delivers (a\n  // query's changed docs — first fire = all matching; a doc = 1). We attach no\n  // listener and issue no read; the meter just sees what the listener is already\n  // billed. (Closes the server-listener blind spot.)\n  const patchOnSnapshot = (proto: { onSnapshot?: AnyFn } | undefined, perDoc: boolean): void => {\n    const real = proto?.onSnapshot;\n    if (!real) return;\n    proto!.onSnapshot = function (this: unknown, ...args: any[]) {\n      const hint = hintFrom(this);\n      const i = args.findIndex((a) => typeof a === \"function\");\n      if (i >= 0) {\n        const onNext = args[i];\n        args[i] = function (snap: any) {\n          try {\n            const n = perDoc\n              ? 1\n              : typeof snap?.docChanges === \"function\"\n                ? snap.docChanges().length\n                : typeof snap?.size === \"number\"\n                  ? snap.size\n                  : 1;\n            if (n > 0) meterCount(n, hint);\n          } catch {\n            /* best-effort */\n          }\n          return onNext(snap);\n        };\n      }\n      return real.apply(this, args);\n    };\n  };\n  patchOnSnapshot(Query?.prototype, false);\n  patchOnSnapshot(DocumentReference?.prototype, true);\n}\n\n/** Test-only: reset the install guard so a suite can re-patch fresh prototypes. */\nexport function __resetFirestoreMeterForTests(): void {\n  installed = false;\n}\n","/**\n * @cross-deck/buckets — know exactly what every database read costs you, and who\n * caused it. A tiny, never-throws collector for Firestore.\n *\n * The whole footprint a consumer sees:\n *   1. init({ apiKey, firestore })  — configure once, install the trap once\n *   2. bucket(name, fn)             — name the read paths that matter\n *   3. (the dashboard shows the rest — and names the ones you haven't yet)\n */\nimport { configureMeter, type MeterConfig } from \"./cost-meter\";\nimport { ReportSink, NullSink, type Sink } from \"./sink\";\nimport { MirrorSink, DEFAULT_MIRROR_DIR } from \"./mirror\";\nimport { installFirestoreMeter, type FirestoreClasses } from \"./adapters/firestore\";\n\nexport interface InitOptions {\n  /**\n   * The project's `cd_sk_` SECRET key. Server-to-server only — never a browser key.\n   * OPTIONAL: with no key, Buckets still meters locally and writes the readout to\n   * disk (`.crossdeck/buckets.md`) — the free, no-account wedge. Add a key and it\n   * also reports up to Crossdeck so the numbers surface on your dashboard.\n   */\n  apiKey?: string;\n  /**\n   * Pass the namespace from `firebase-admin/firestore` to auto-install the read\n   * trap (recommended — this is what makes every read count with no per-call work).\n   * Omit it if you'd rather call `installFirestoreMeter()` yourself, or you only\n   * use the manual `recordReads()` recorders.\n   */\n  firestore?: FirestoreClasses;\n  /** Override the report endpoint (defaults to Crossdeck's ingest). */\n  endpoint?: string;\n  /** How often to flush coalesced counts (ms). Default 60_000. */\n  flushIntervalMs?: number;\n  /** Bring your own sink (self-host the rollups). Defaults to reporting up to Crossdeck. */\n  sink?: Sink;\n  /**\n   * Where to write the local readout — the file \"read me my buckets\" reads back.\n   * Defaults to `.crossdeck`. Pass `false` to turn the local mirror off entirely.\n   */\n  mirror?: string | false;\n  /** Notified when a flush fails, so a dropped window is never silent. Best-effort. */\n  onError?: MeterConfig[\"onError\"];\n}\n\n/**\n * Configure Buckets once, at process start. Always meters locally and writes the\n * readout to disk; if you pass `apiKey` (or your own `sink`) it ALSO reports up to\n * Crossdeck. Pass `firestore` to install the universal read trap so every read counts\n * automatically.\n */\nexport function init(options: InitOptions = {}): void {\n  // Upstream: your sink, else a Crossdeck reporter if a key was given, else nothing.\n  const upstream: Sink | null =\n    options.sink ?? (options.apiKey ? new ReportSink({ apiKey: options.apiKey, endpoint: options.endpoint }) : null);\n  // Default behaviour tees every flush to a local readout; `mirror:false` opts out.\n  const sink: Sink =\n    options.mirror === false\n      ? upstream ?? new NullSink()\n      : new MirrorSink(upstream, typeof options.mirror === \"string\" ? options.mirror : DEFAULT_MIRROR_DIR);\n  configureMeter({ sink, flushIntervalMs: options.flushIntervalMs, onError: options.onError });\n  if (options.firestore) installFirestoreMeter(options.firestore);\n}\n\n/** Alias — reads well next to `bucket()` at a call site. */\nexport { init as initBuckets };\n\n// The headline verb + the lower-level tag controls it is sugar over.\nexport {\n  bucket,\n  runWithCostTag,\n  enterCostTag,\n  refineCostTag,\n  currentCostTag,\n  type CostTag,\n} from \"./cost-context\";\n\n// Recorders. `record(resource, quantity)` is the generic adapter primitive — count\n// any resource unit (a future adapter records \"clickhouse.query_ms\"); recordReads/\n// Writes/Deletes are the Firestore conveniences over it.\nexport {\n  record,\n  recordReads,\n  recordWrites,\n  recordDeletes,\n  flush,\n  type CostHint,\n  type ResourceUnit,\n  type OpType,\n  type MeterConfig,\n} from \"./cost-meter\";\n\n// The trap (the only datastore adapter today) + its class shape.\nexport { installFirestoreMeter, type FirestoreClasses } from \"./adapters/firestore\";\n\n// The sink seam — for self-hosting rollups instead of reporting to Crossdeck.\nexport {\n  ReportSink,\n  NullSink,\n  type Sink,\n  type BucketsReport,\n  type ResourceCounts,\n  type OpCounts,\n  type ReportSinkConfig,\n} from \"./sink\";\n\n// The local readout — the file \"read me my buckets\" reads back, and its renderer.\nexport { MirrorSink, DEFAULT_MIRROR_DIR } from \"./mirror\";\nexport { renderReadout, READOUT_FOOTER } from \"./readout\";\n"]}

package/dist/index.mjs

@@ -1,4 +1,6 @@
 import { AsyncLocalStorage } from 'async_hooks';
+import { readFileSync, mkdirSync, writeFileSync } from 'fs';
+import { join } from 'path';
 
 // src/cost-context.ts
 var DEFAULT_TAG = {};
@@ -159,6 +161,107 @@ var ReportSink = class {
     }
   }
 };
+var NullSink = class {
+  async flush() {
+  }
+};
+
+// src/readout.ts
+var READOUT_FOOTER = "Buckets OSS shows the reads on this surface. Sign up to Crossdeck (free) to see every surface in one view, drill any bucket down to the exact query, track a fix before and after, and get paged when reads spike \u2014 cross-deck.com";
+function fmt(n) {
+  if (n >= 1e6) return (n / 1e6).toFixed(2) + "M";
+  if (n >= 1e4) return Math.round(n / 1e3) + "K";
+  if (n >= 1e3) return (n / 1e3).toFixed(1) + "K";
+  return String(Math.round(n));
+}
+function isUntagged(label) {
+  const root = label.split(">")[0];
+  return root.startsWith("col:") || root === "uncategorized" || root === "unknown";
+}
+function displayLabel(label) {
+  return label.split(">").map((s) => s.startsWith("col:") ? s.slice(4) : s).join(" \u203A ");
+}
+function renderReadout(report) {
+  const entries = Object.entries(report.byLabel ?? {}).map(([label, counts]) => ({ label, reads: counts.read ?? 0 })).filter((e) => e.reads > 0).sort((a, b) => b.reads - a.reads);
+  const total = entries.reduce((s, e) => s + e.reads, 0);
+  const out = [];
+  out.push(`# Buckets \u2014 reads on this surface`);
+  out.push(``);
+  out.push(`**${fmt(total)} reads** \xB7 ${report.date} (UTC)`);
+  out.push(``);
+  if (entries.length === 0) {
+    out.push(`No reads metered yet \u2014 install the collector and let your app serve some traffic.`);
+  } else {
+    out.push(`| bucket | named | reads |`);
+    out.push(`| --- | :---: | ---: |`);
+    for (const e of entries) {
+      out.push(`| ${displayLabel(e.label)} | ${isUntagged(e.label) ? "\u2014" : "\u2713"} | ${fmt(e.reads)} |`);
+    }
+  }
+  out.push(``);
+  out.push(`---`);
+  out.push(READOUT_FOOTER);
+  out.push(``);
+  return out.join("\n");
+}
+
+// src/mirror.ts
+var DEFAULT_MIRROR_DIR = ".crossdeck";
+function mergeInto(target, src) {
+  if (!src) return;
+  for (const [key, counts] of Object.entries(src)) {
+    const bag = target[key] ??= {};
+    for (const [res, n] of Object.entries(counts)) {
+      if (typeof n === "number") bag[res] = (bag[res] ?? 0) + n;
+    }
+  }
+}
+var MirrorSink = class {
+  constructor(upstream, dir = DEFAULT_MIRROR_DIR) {
+    this.upstream = upstream;
+    this.dir = dir;
+  }
+  upstream;
+  dir;
+  acc = null;
+  announced = false;
+  seeded = false;
+  jsonPath() {
+    return join(this.dir, "buckets.json");
+  }
+  /** Seed the running total once from an existing same-day file (survives restarts). */
+  seed(date) {
+    if (this.seeded) return;
+    this.seeded = true;
+    try {
+      const prior = JSON.parse(readFileSync(this.jsonPath(), "utf8"));
+      if (prior?.date === date && prior.byLabel) this.acc = prior;
+    } catch {
+    }
+  }
+  async flush(report) {
+    try {
+      this.seed(report.date);
+      if (!this.acc || this.acc.date !== report.date) {
+        this.acc = { date: report.date, byLabel: {}, byHour: {}, byMinute: {} };
+      }
+      mergeInto(this.acc.byLabel, report.byLabel);
+      mergeInto(this.acc.byHour ??= {}, report.byHour);
+      mergeInto(this.acc.byMinute ??= {}, report.byMinute);
+      mkdirSync(this.dir, { recursive: true });
+      writeFileSync(join(this.dir, "buckets.md"), renderReadout(this.acc));
+      writeFileSync(this.jsonPath(), JSON.stringify(this.acc, null, 2));
+      if (!this.announced) {
+        this.announced = true;
+        console.log(
+          `Buckets: readout at ${join(this.dir, "buckets.md")} \u2014 open it, or ask your AI session to "read me my buckets".`
+        );
+      }
+    } catch {
+    }
+    if (this.upstream) await this.upstream.flush(report);
+  }
+};
 
 // src/adapters/firestore.ts
 var installed = false;
@@ -280,12 +383,13 @@ function installFirestoreMeter(classes) {
 }
 
 // src/index.ts
-function init(options) {
-  const sink2 = options.sink ?? new ReportSink({ apiKey: options.apiKey, endpoint: options.endpoint });
+function init(options = {}) {
+  const upstream = options.sink ?? (options.apiKey ? new ReportSink({ apiKey: options.apiKey, endpoint: options.endpoint }) : null);
+  const sink2 = options.mirror === false ? upstream ?? new NullSink() : new MirrorSink(upstream, typeof options.mirror === "string" ? options.mirror : DEFAULT_MIRROR_DIR);
   configureMeter({ sink: sink2, flushIntervalMs: options.flushIntervalMs, onError: options.onError });
   if (options.firestore) installFirestoreMeter(options.firestore);
 }
 
-export { ReportSink, bucket, currentCostTag, enterCostTag, flush, init, init as initBuckets, installFirestoreMeter, record, recordDeletes, recordReads, recordWrites, refineCostTag, runWithCostTag };
+export { DEFAULT_MIRROR_DIR, MirrorSink, NullSink, READOUT_FOOTER, ReportSink, bucket, currentCostTag, enterCostTag, flush, init, init as initBuckets, installFirestoreMeter, record, recordDeletes, recordReads, recordWrites, refineCostTag, renderReadout, runWithCostTag };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/cost-context.ts","../src/cost-meter.ts","../src/sink.ts","../src/adapters/firestore.ts","../src/index.ts"],"names":["sink"],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * cost-context — the request-scoped tag every counted operation attributes\n * itself to. Set it ONCE at a boundary (or wrap a path with `bucket()`); it\n * rides Node's AsyncLocalStorage down through every async fan-out, so one\n * handler that triggers 15 reads attributes all 15 to the same bucket — with\n * zero per-call-site work.\n *\n * Generic by design: unlike a hardcoded product taxonomy, the only meaningful\n * field a consumer sets is the free-form `label` (the bucket name). `feature`\n * is an optional coarse grouping if you want one; nothing here is\n * Crossdeck-specific.\n */\nimport { AsyncLocalStorage } from \"node:async_hooks\";\n\nexport interface CostTag {\n  /** Optional coarse grouping (a caller-defined surface name). */\n  feature?: string;\n  /** The bucket name — what `bucket()` sets. Drives the report's `byLabel`. */\n  label?: string;\n}\n\nconst DEFAULT_TAG: CostTag = {};\nconst store = new AsyncLocalStorage<CostTag>();\n\n/** Run `fn` with `tag` bound for its entire async subtree. */\nexport function runWithCostTag<T>(tag: CostTag, fn: () => T): T {\n  return store.run({ ...tag }, fn);\n}\n\n/** Bind a tag for the remainder of the current async context (no closure to wrap). */\nexport function enterCostTag(tag: CostTag): void {\n  store.enterWith({ ...tag });\n}\n\n/** Refine the live tag in place (e.g. stamp a feature after the boundary). */\nexport function refineCostTag(patch: Partial<CostTag>): void {\n  const cur = store.getStore();\n  if (cur) Object.assign(cur, patch);\n}\n\n/** The current tag, or a safe empty default outside any bound context. */\nexport function currentCostTag(): CostTag {\n  return store.getStore() ?? DEFAULT_TAG;\n}\n\n/** Hierarchy separator for bucket paths — Firestore-map-key-safe and distinct from\n *  the \"col:\" leaf prefix. `bucket(\"a\", () => bucket(\"b\", …))` → \"a>b\". */\nexport const BUCKET_SEP = \">\";\n\n/**\n * `bucket(name, fn)` — the headline verb, the `track()` of cost. Run `fn` with\n * every operation inside it attributed to the bucket `name`; the attribution rides\n * the async subtree automatically. NESTS: a `bucket()` inside another COMPOSES into\n * a path (`\"analytics\" > \"rollup\"` → `\"analytics>rollup\"`), so the dashboard can\n * drill from the coarse bucket down into its parts. The one verb most developers touch:\n *\n *   await bucket(\"analytics\", () =>\n *     bucket(\"rollup\", () => db.collection(\"events\").where(...).get())); // → \"analytics>rollup>col:events\"\n */\nexport function bucket<T>(name: string, fn: () => T): T {\n  const parent = currentCostTag().label;\n  const path = parent ? `${parent}${BUCKET_SEP}${name}` : name;\n  return runWithCostTag({ ...currentCostTag(), label: path }, fn);\n}\n","/**\n * cost-meter — counts operations against the ambient tag and flushes them to the\n * configured Sink cheaply.\n *\n * LOW-OVERHEAD CONTRACT (the thing that warns you about reads must not run them\n * up): counts accumulate in an in-memory buffer and flush periodically — NEVER one\n * network call per counted operation. A flush coalesces the whole window into one\n * report per UTC day and hands it to the Sink. At steady state that is ~1 small\n * request a minute, regardless of how many ops you served.\n *\n * BEST-EFFORT CONTRACT: metering must never throw into your code. Every recorder\n * swallows its own errors; a failed flush drops that window's counts (surfaced via\n * `onError` if you pass one) rather than disturbing the app.\n */\nimport { currentCostTag } from \"./cost-context\";\nimport type { Sink, BucketsReport, ResourceCounts } from \"./sink\";\n\n/**\n * A resource unit — what an adapter counts. Firestore emits `read`/`write`/\n * `delete`; other adapters emit their own (`clickhouse.query_ms`, `openai.tokens`).\n * It is a free identifier on purpose, BUT each one is kept entirely distinct: the\n * meter only ever sums quantities WITHIN a single resource, never across two.\n */\nexport type ResourceUnit = string;\n/** @deprecated — Firestore-era name; use {@link ResourceUnit}. */\nexport type OpType = ResourceUnit;\n\n/** Optional read-site hint — the collection touched, derived at the trap from the\n *  path. Lets an UNtagged read cascade to `col:<collection>` instead of vanishing. */\nexport interface CostHint {\n  collection?: string;\n  projectId?: string;\n}\n\n// NUL separator — a bucket/collection name can contain almost anything except\n// this, so the key never collides with a name that has a \"|\" or \":\" in it.\nconst SEP = \"\\u001f\"; // ASCII Unit Separator\n\n/** key = date <NUL> resource <NUL> label → count */\nconst labelBuffer = new Map<string, number>();\n/** key = date <NUL> resource <NUL> hour → count */\nconst hourBuffer = new Map<string, number>();\n/** key = date <NUL> resource <NUL> 5-min-slot (\"HHMM\") → count. The fine grain\n *  that lets a developer verify against the provider console's \"last hour\" within\n *  minutes of installing — not after a day. Still one maintained doc, zero reads. */\nconst minuteBuffer = new Map<string, number>();\n\nlet sink: Sink | null = null;\nlet flushIntervalMs = 60_000;\nlet onError: ((e: unknown) => void) | null = null;\nlet timer: ReturnType<typeof setInterval> | null = null;\nlet flushing = false;\n/** Safety valve — flush early if a burst fills the buffer between intervals. */\nconst MAX_BUFFER_KEYS = 5_000;\n\nexport interface MeterConfig {\n  sink: Sink;\n  flushIntervalMs?: number;\n  onError?: (e: unknown) => void;\n}\n\n/** Point the meter at a sink. Called by `init()`; pass your own sink to self-host. */\nexport function configureMeter(config: MeterConfig): void {\n  sink = config.sink;\n  if (config.flushIntervalMs && config.flushIntervalMs > 0) flushIntervalMs = config.flushIntervalMs;\n  onError = config.onError ?? null;\n}\n\nconst utcDate = (): string => new Date().toISOString().slice(0, 10);\nconst utcHour = (): string => new Date().toISOString().slice(11, 13);\n/** UTC 5-minute slot of the day as \"HHMM\" — the slot START (e.g. 08:47 → \"0845\"). */\nconst utcFiveMin = (): string => {\n  const iso = new Date().toISOString();\n  const hh = iso.slice(11, 13);\n  const mm = Math.floor(Number(iso.slice(14, 16)) / 5) * 5;\n  return hh + String(mm).padStart(2, \"0\");\n};\n\nfunction ensureFlushLoop(): void {\n  if (timer) return;\n  timer = setInterval(() => void flush(), flushIntervalMs);\n  // Don't keep the event loop alive just for metering.\n  (timer as { unref?: () => void }).unref?.();\n  // Flush the last window on shutdown.\n  process.once?.(\"SIGTERM\", () => void flush());\n  process.once?.(\"beforeExit\", () => void flush());\n}\n\n/**\n * Count `quantity` of a `resource` against the live tag. THE adapter primitive —\n * a Firestore adapter records \"read\"; a ClickHouse adapter records\n * \"clickhouse.query_ms\"; an OpenAI adapter records \"openai.tokens\". Each resource\n * is bucketed entirely on its own; nothing is ever added across resources. Never\n * throws.\n */\nexport function record(resource: ResourceUnit, quantity: number, hint?: CostHint): void {\n  try {\n    if (!Number.isFinite(quantity) || quantity <= 0) return;\n    const t = currentCostTag();\n    const date = utcDate();\n    // HIERARCHY — the bucket path is the trunk; the collection is the LEAF kept\n    // beneath it (so a tagged bucket still drills down to which collections it\n    // read). \"analytics\" + events → \"analytics>col:events\"; untagged → \"col:events\";\n    // nothing derivable → \"uncategorized\". A unit is never invisible, and a tagged\n    // one never loses where it actually went.\n    const coll = hint?.collection ? `col:${hint.collection}` : null;\n    const label = t.label\n      ? coll\n        ? `${t.label}>${coll}`\n        : t.label\n      : coll ?? \"uncategorized\";\n    // Key includes the resource, so each resource accumulates in its OWN slot.\n    const lk = date + SEP + resource + SEP + label;\n    labelBuffer.set(lk, (labelBuffer.get(lk) ?? 0) + quantity);\n    const hk = date + SEP + resource + SEP + utcHour();\n    hourBuffer.set(hk, (hourBuffer.get(hk) ?? 0) + quantity);\n    const mk = date + SEP + resource + SEP + utcFiveMin();\n    minuteBuffer.set(mk, (minuteBuffer.get(mk) ?? 0) + quantity);\n    ensureFlushLoop();\n    if (labelBuffer.size + hourBuffer.size + minuteBuffer.size > MAX_BUFFER_KEYS) void flush();\n  } catch {\n    /* metering is best-effort — never disturb the caller */\n  }\n}\n\n/** @deprecated — use {@link record}. Firestore-era alias. */\nexport const recordFirestore = record;\n\n/** Firestore bills a minimum of one read even for an empty result, so 0 counts as 1. */\nexport function recordReads(n: number, hint?: CostHint): void {\n  record(\"read\", Math.max(n, 1), hint);\n}\nexport function recordWrites(n = 1): void {\n  record(\"write\", n);\n}\nexport function recordDeletes(n = 1): void {\n  record(\"delete\", n);\n}\n\nfunction add(target: Record<string, ResourceCounts>, key: string, resource: ResourceUnit, n: number): void {\n  const bag = (target[key] ??= {});\n  // Accumulate WITHIN this resource only — never merge resources.\n  bag[resource] = (bag[resource] ?? 0) + n;\n}\n\n/**\n * Coalesce the buffer into one report per UTC day and hand each to the Sink.\n * Snapshots + clears up front so concurrent records land in the next window.\n * Never throws; a sink failure drops that window (surfaced via `onError`).\n */\nexport async function flush(): Promise<void> {\n  if (flushing) return;\n  // Not configured (init not called) — drop, don't grow unbounded.\n  if (!sink) {\n    labelBuffer.clear();\n    hourBuffer.clear();\n    minuteBuffer.clear();\n    return;\n  }\n  if (labelBuffer.size === 0 && hourBuffer.size === 0 && minuteBuffer.size === 0) return;\n  flushing = true;\n\n  const labels = new Map(labelBuffer);\n  const hours = new Map(hourBuffer);\n  const minutes = new Map(minuteBuffer);\n  labelBuffer.clear();\n  hourBuffer.clear();\n  minuteBuffer.clear();\n\n  try {\n    const byDate = new Map<string, BucketsReport>();\n    const reportFor = (date: string): BucketsReport => {\n      let r = byDate.get(date);\n      if (!r) {\n        r = { date, byLabel: {}, byHour: {}, byMinute: {} };\n        byDate.set(date, r);\n      }\n      return r;\n    };\n    for (const [k, n] of labels) {\n      const [date, op, label] = k.split(SEP) as [string, OpType, string];\n      add(reportFor(date).byLabel, label, op, n);\n    }\n    for (const [k, n] of hours) {\n      const [date, op, hour] = k.split(SEP) as [string, OpType, string];\n      add(reportFor(date).byHour!, hour, op, n);\n    }\n    for (const [k, n] of minutes) {\n      const [date, op, slot] = k.split(SEP) as [string, OpType, string];\n      add(reportFor(date).byMinute!, slot, op, n);\n    }\n    for (const report of byDate.values()) {\n      await sink.flush(report);\n    }\n  } catch (e) {\n    // Drop this window rather than risk a partial/double report on retry.\n    onError?.(e);\n  } finally {\n    flushing = false;\n  }\n}\n","/**\n * sink — where the meter sends a coalesced rollup, and the wire shape it sends.\n *\n * Abstracting the sink is what makes Buckets storage-agnostic: the meter never\n * knows where counts go. The DEFAULT sink (`ReportSink`) reports up to Crossdeck's\n * ingest endpoint so the numbers surface on your Crossdeck dashboard. A team that\n * wants to self-host can implement `Sink` against anything (Postgres, a file, your\n * own API) without touching the meter.\n */\n\n/**\n * Counts for ONE bucket, keyed by RESOURCE UNIT — the raw quantity of each unit,\n * nothing more (no money; you verify cost on your provider's bill).\n *\n * Firestore, the first adapter, emits `read` / `write` / `delete`. Other adapters\n * emit their own units (`clickhouse.query_ms`, `openai.tokens`, …). The rule that\n * keeps this honest: **each resource is its own line. Counts are only ever summed\n * WITHIN a resource, NEVER across one.** A read is not a query-millisecond; the two\n * never land in the same number. (There is deliberately no \"total units\" field.)\n */\nexport interface ResourceCounts {\n  read?: number;\n  write?: number;\n  delete?: number;\n  /** Any other resource unit an adapter emits — kept distinct, never merged. */\n  [resource: string]: number | undefined;\n}\n\n/** @deprecated name — kept for back-compat; use {@link ResourceCounts}. */\nexport type OpCounts = ResourceCounts;\n\n/**\n * One coalesced report — the wire contract (see docs/ROLLUP_SCHEMA.md). The meter\n * produces one of these per UTC day in a flush window (usually exactly one).\n */\nexport interface BucketsReport {\n  /** UTC day \"YYYY-MM-DD\". */\n  date: string;\n  /** bucket name → counts. The heart of the report. */\n  byLabel: Record<string, ResourceCounts>;\n  /** UTC hour \"HH\" → counts, for the hourly \"did my fix land this hour?\" view. */\n  byHour?: Record<string, ResourceCounts>;\n  /** UTC 5-minute slot \"HHMM\" (slot start) → counts. The fine grain for fast\n   *  verification against a provider console's \"last hour\" view. */\n  byMinute?: Record<string, ResourceCounts>;\n}\n\n/**\n * A destination for coalesced rollups. `flush` MAY throw on failure — the meter\n * catches it, drops that one window, and never lets it reach your app.\n */\nexport interface Sink {\n  flush(report: BucketsReport): Promise<void>;\n}\n\nexport interface ReportSinkConfig {\n  /** The project's `cd_sk_` secret key. Server-to-server only. */\n  apiKey: string;\n  /** Defaults to https://api.cross-deck.com/v1/buckets/report */\n  endpoint?: string;\n  /** Request timeout (ms); a slow Crossdeck must never stall your flush. */\n  timeoutMs?: number;\n}\n\nconst DEFAULT_ENDPOINT = \"https://api.cross-deck.com/v1/buckets/report\";\n\n/**\n * The default sink: POST one coalesced rollup to Crossdeck's ingest endpoint.\n * The ingest folds it into the day's maintained doc with `increment`, so many\n * reports a minute coalesce safely. This path does ZERO database reads — it sends\n * a summary, it does not read. Throws on a non-202 so the meter can log/drop the\n * window; the meter guarantees it never reaches your app.\n */\nexport class ReportSink implements Sink {\n  private readonly endpoint: string;\n  private readonly apiKey: string;\n  private readonly timeoutMs: number;\n\n  constructor(config: ReportSinkConfig) {\n    this.endpoint = config.endpoint ?? DEFAULT_ENDPOINT;\n    this.apiKey = config.apiKey;\n    this.timeoutMs = config.timeoutMs ?? 5000;\n  }\n\n  async flush(report: BucketsReport): Promise<void> {\n    const res = await fetch(this.endpoint, {\n      method: \"POST\",\n      signal: AbortSignal.timeout(this.timeoutMs),\n      headers: {\n        \"content-type\": \"application/json\",\n        authorization: `Bearer ${this.apiKey}`,\n      },\n      body: JSON.stringify(report),\n    });\n    if (res.status !== 202) {\n      throw new Error(`Buckets report rejected: HTTP ${res.status}`);\n    }\n  }\n}\n","/**\n * adapters/firestore — the universal Firestore read meter (the trap).\n *\n * THE LESSON (learned on a real product): per-call-site `recordReads()`\n * instrumentation MISSES paths. You meter the read sites you're looking at and\n * leave the cron / trigger / ingest path uncounted — often the majority of reads,\n * invisible. Humans tag what they see and miss the path that matters.\n *\n * THE FIX: patch the admin SDK's read methods ONCE. From install onward, EVERY\n * read — anywhere, on any code path — is counted under the ambient tag, with zero\n * per-call-site work and no blind spots.\n *\n * SAFETY CONTRACT — this sits on your production read path, so it is defensive by\n * construction. Each wrapper:\n *   1. calls the REAL method first and captures the result,\n *   2. counts in a try/catch that can never throw into the caller,\n *   3. ALWAYS returns the real result, untouched.\n * It cannot break a read, change a result, or add latency beyond one in-memory\n * counter increment. A wrong count is a measurement error, never a correctness or\n * availability one. Idempotent — calling it twice patches once.\n *\n * COUNTING MODEL — a query returning N docs = N reads (an empty result still bills\n * 1, which the meter enforces). A document get = 1. getAll(...) = the ref count.\n * CollectionReference.get IS Query.get (shared prototype method), so patching Query\n * covers collections with no double-count.\n */\nimport { recordReads, type CostHint } from \"../cost-meter\";\n\nlet installed = false;\n\n/* eslint-disable @typescript-eslint/no-explicit-any */\ntype AnyFn = (...args: any[]) => any;\n\n/**\n * The firebase-admin Firestore classes to patch. Pass the module namespace from\n * `firebase-admin/firestore` — only the prototypes present are patched.\n */\nexport interface FirestoreClasses {\n  Query?: { prototype: { get?: AnyFn; onSnapshot?: AnyFn } };\n  DocumentReference?: { prototype: { get?: AnyFn; onSnapshot?: AnyFn } };\n  Transaction?: { prototype: { get?: AnyFn; getAll?: AnyFn } };\n  Firestore?: { prototype: { getAll?: AnyFn } };\n  /** count() / sum() / average() — aggregation queries bill reads too. */\n  AggregateQuery?: { prototype: { get?: AnyFn } };\n}\n\n/** `projects/{id}/…` → the project id, else undefined. Pure string op. */\nfunction projectFromPath(path: string): string | undefined {\n  const parts = path.split(\"/\");\n  const i = parts.indexOf(\"projects\");\n  return i >= 0 && parts[i + 1] ? parts[i + 1] : undefined;\n}\n\n/**\n * Derive { collection, projectId } from the read target's path so an UNtagged read\n * cascades to `col:<collection>` instead of \"uncategorized\". PURE CPU; never reads,\n * never throws. Falls back to firebase-admin's internal `_queryOptions` for filtered\n * queries (which don't expose `.path`).\n */\nfunction hintFrom(target: any): CostHint | undefined {\n  try {\n    const p = typeof target?.path === \"string\" ? target.path : \"\";\n    if (p) {\n      const parts = p.split(\"/\").filter(Boolean);\n      const collection = parts.length % 2 === 0 ? parts[parts.length - 2] : parts[parts.length - 1];\n      return { collection, projectId: projectFromPath(p) };\n    }\n    const qo = target?._queryOptions;\n    if (qo) {\n      const collection = typeof qo.collectionId === \"string\" ? qo.collectionId : undefined;\n      const parent =\n        typeof qo.parentPath?.relativeName === \"string\"\n          ? qo.parentPath.relativeName\n          : typeof qo.parentPath?.toString === \"function\"\n            ? String(qo.parentPath.toString())\n            : \"\";\n      return { collection, projectId: parent ? projectFromPath(parent) : undefined };\n    }\n  } catch {\n    /* the meter must never throw */\n  }\n  return undefined;\n}\n\nfunction meterSnap(snap: unknown, hint?: CostHint): void {\n  try {\n    const size = (snap as { size?: number } | null)?.size;\n    recordReads(typeof size === \"number\" ? size : 1, hint);\n  } catch {\n    /* best-effort */\n  }\n}\nfunction meterCount(n: number, hint?: CostHint): void {\n  try {\n    recordReads(n, hint);\n  } catch {\n    /* best-effort */\n  }\n}\n\n/**\n * Install the universal read meter on the firebase-admin Firestore classes. Call\n * ONCE at process start, before any reads. Pass the namespace from\n * `firebase-admin/firestore` so the exact prototypes the SDK uses are patched:\n *\n *   import * as Firestore from \"firebase-admin/firestore\";\n *   installFirestoreMeter(Firestore);\n */\nexport function installFirestoreMeter(classes: FirestoreClasses): void {\n  if (installed) return;\n  installed = true;\n  const { Query, DocumentReference, Transaction, Firestore, AggregateQuery } = classes;\n\n  // Query.get — covers Query AND CollectionReference (shared prototype method).\n  const qGet = Query?.prototype?.get;\n  if (qGet) {\n    Query!.prototype.get = async function (this: unknown, ...args: any[]) {\n      const snap = await qGet.apply(this, args);\n      meterSnap(snap, hintFrom(this));\n      return snap;\n    };\n  }\n\n  // DocumentReference.get — a single doc = 1 read.\n  const dGet = DocumentReference?.prototype?.get;\n  if (dGet) {\n    DocumentReference!.prototype.get = async function (this: unknown, ...args: any[]) {\n      const snap = await dGet.apply(this, args);\n      meterCount(1, hintFrom(this));\n      return snap;\n    };\n  }\n\n  // Transaction.get — query or doc; size when present, else 1.\n  const tGet = Transaction?.prototype?.get;\n  if (tGet) {\n    Transaction!.prototype.get = async function (this: unknown, ...args: any[]) {\n      const res = await tGet.apply(this, args);\n      meterSnap(res, hintFrom(args[0]));\n      return res;\n    };\n  }\n\n  // Transaction.getAll(...refs) — one read per ref.\n  const tGetAll = Transaction?.prototype?.getAll;\n  if (tGetAll) {\n    Transaction!.prototype.getAll = async function (this: unknown, ...args: any[]) {\n      const res = await tGetAll.apply(this, args);\n      meterCount(Array.isArray(res) ? res.length : args.length || 1, hintFrom(args[0]));\n      return res;\n    };\n  }\n\n  // Firestore.getAll(...refs) — batched doc reads.\n  const fGetAll = Firestore?.prototype?.getAll;\n  if (fGetAll) {\n    Firestore!.prototype.getAll = async function (this: unknown, ...args: any[]) {\n      const res = await fGetAll.apply(this, args);\n      meterCount(Array.isArray(res) ? res.length : args.length || 1, hintFrom(args[0]));\n      return res;\n    };\n  }\n\n  // AggregateQuery.get — count() / sum() / average(). Firestore bills one read per\n  // up to 1000 index entries scanned, and the client never sees that entry count —\n  // so this is an HONEST ESTIMATE: for count() we derive it from the result\n  // (ceil(count / 1000)), else the billed minimum of 1. Observe-only: it reads the\n  // result you already got, adds zero reads. (Closes the aggregation blind spot.)\n  const aGet = AggregateQuery?.prototype?.get;\n  if (aGet) {\n    AggregateQuery!.prototype.get = async function (this: unknown, ...args: any[]) {\n      const snap = await aGet.apply(this, args);\n      try {\n        const data = (snap as { data?: () => { count?: number } } | null)?.data?.();\n        const count = typeof data?.count === \"number\" ? data.count : 0;\n        meterCount(Math.max(1, Math.ceil(count / 1000)), hintFrom(this));\n      } catch {\n        /* best-effort */\n      }\n      return snap;\n    };\n  }\n\n  // Query.onSnapshot / DocumentReference.onSnapshot — server-side realtime\n  // listeners. We OBSERVE: wrap onNext and count the docs each fire delivers (a\n  // query's changed docs — first fire = all matching; a doc = 1). We attach no\n  // listener and issue no read; the meter just sees what the listener is already\n  // billed. (Closes the server-listener blind spot.)\n  const patchOnSnapshot = (proto: { onSnapshot?: AnyFn } | undefined, perDoc: boolean): void => {\n    const real = proto?.onSnapshot;\n    if (!real) return;\n    proto!.onSnapshot = function (this: unknown, ...args: any[]) {\n      const hint = hintFrom(this);\n      const i = args.findIndex((a) => typeof a === \"function\");\n      if (i >= 0) {\n        const onNext = args[i];\n        args[i] = function (snap: any) {\n          try {\n            const n = perDoc\n              ? 1\n              : typeof snap?.docChanges === \"function\"\n                ? snap.docChanges().length\n                : typeof snap?.size === \"number\"\n                  ? snap.size\n                  : 1;\n            if (n > 0) meterCount(n, hint);\n          } catch {\n            /* best-effort */\n          }\n          return onNext(snap);\n        };\n      }\n      return real.apply(this, args);\n    };\n  };\n  patchOnSnapshot(Query?.prototype, false);\n  patchOnSnapshot(DocumentReference?.prototype, true);\n}\n\n/** Test-only: reset the install guard so a suite can re-patch fresh prototypes. */\nexport function __resetFirestoreMeterForTests(): void {\n  installed = false;\n}\n","/**\n * @cross-deck/buckets — know exactly what every database read costs you, and who\n * caused it. A tiny, never-throws collector for Firestore.\n *\n * The whole footprint a consumer sees:\n *   1. init({ apiKey, firestore })  — configure once, install the trap once\n *   2. bucket(name, fn)             — name the read paths that matter\n *   3. (the dashboard shows the rest — and names the ones you haven't yet)\n */\nimport { configureMeter, type MeterConfig } from \"./cost-meter\";\nimport { ReportSink, type Sink } from \"./sink\";\nimport { installFirestoreMeter, type FirestoreClasses } from \"./adapters/firestore\";\n\nexport interface InitOptions {\n  /** The project's `cd_sk_` SECRET key. Server-to-server only — never a browser key. */\n  apiKey: string;\n  /**\n   * Pass the namespace from `firebase-admin/firestore` to auto-install the read\n   * trap (recommended — this is what makes every read count with no per-call work).\n   * Omit it if you'd rather call `installFirestoreMeter()` yourself, or you only\n   * use the manual `recordReads()` recorders.\n   */\n  firestore?: FirestoreClasses;\n  /** Override the report endpoint (defaults to Crossdeck's ingest). */\n  endpoint?: string;\n  /** How often to flush coalesced counts (ms). Default 60_000. */\n  flushIntervalMs?: number;\n  /** Bring your own sink (self-host the rollups). Defaults to reporting up to Crossdeck. */\n  sink?: Sink;\n  /** Notified when a flush fails, so a dropped window is never silent. Best-effort. */\n  onError?: MeterConfig[\"onError\"];\n}\n\n/**\n * Configure Buckets once, at process start. Points the meter at a sink (Crossdeck's\n * ingest by default) and — if you pass `firestore` — installs the universal read\n * trap so every read counts automatically.\n */\nexport function init(options: InitOptions): void {\n  const sink = options.sink ?? new ReportSink({ apiKey: options.apiKey, endpoint: options.endpoint });\n  configureMeter({ sink, flushIntervalMs: options.flushIntervalMs, onError: options.onError });\n  if (options.firestore) installFirestoreMeter(options.firestore);\n}\n\n/** Alias — reads well next to `bucket()` at a call site. */\nexport { init as initBuckets };\n\n// The headline verb + the lower-level tag controls it is sugar over.\nexport {\n  bucket,\n  runWithCostTag,\n  enterCostTag,\n  refineCostTag,\n  currentCostTag,\n  type CostTag,\n} from \"./cost-context\";\n\n// Recorders. `record(resource, quantity)` is the generic adapter primitive — count\n// any resource unit (a future adapter records \"clickhouse.query_ms\"); recordReads/\n// Writes/Deletes are the Firestore conveniences over it.\nexport {\n  record,\n  recordReads,\n  recordWrites,\n  recordDeletes,\n  flush,\n  type CostHint,\n  type ResourceUnit,\n  type OpType,\n  type MeterConfig,\n} from \"./cost-meter\";\n\n// The trap (the only datastore adapter today) + its class shape.\nexport { installFirestoreMeter, type FirestoreClasses } from \"./adapters/firestore\";\n\n// The sink seam — for self-hosting rollups instead of reporting to Crossdeck.\nexport {\n  ReportSink,\n  type Sink,\n  type BucketsReport,\n  type ResourceCounts,\n  type OpCounts,\n  type ReportSinkConfig,\n} from \"./sink\";\n"]}
+{"version":3,"sources":["../src/cost-context.ts","../src/cost-meter.ts","../src/sink.ts","../src/readout.ts","../src/mirror.ts","../src/adapters/firestore.ts","../src/index.ts"],"names":["sink"],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * cost-context — the request-scoped tag every counted operation attributes\n * itself to. Set it ONCE at a boundary (or wrap a path with `bucket()`); it\n * rides Node's AsyncLocalStorage down through every async fan-out, so one\n * handler that triggers 15 reads attributes all 15 to the same bucket — with\n * zero per-call-site work.\n *\n * Generic by design: unlike a hardcoded product taxonomy, the only meaningful\n * field a consumer sets is the free-form `label` (the bucket name). `feature`\n * is an optional coarse grouping if you want one; nothing here is\n * Crossdeck-specific.\n */\nimport { AsyncLocalStorage } from \"node:async_hooks\";\n\nexport interface CostTag {\n  /** Optional coarse grouping (a caller-defined surface name). */\n  feature?: string;\n  /** The bucket name — what `bucket()` sets. Drives the report's `byLabel`. */\n  label?: string;\n}\n\nconst DEFAULT_TAG: CostTag = {};\nconst store = new AsyncLocalStorage<CostTag>();\n\n/** Run `fn` with `tag` bound for its entire async subtree. */\nexport function runWithCostTag<T>(tag: CostTag, fn: () => T): T {\n  return store.run({ ...tag }, fn);\n}\n\n/** Bind a tag for the remainder of the current async context (no closure to wrap). */\nexport function enterCostTag(tag: CostTag): void {\n  store.enterWith({ ...tag });\n}\n\n/** Refine the live tag in place (e.g. stamp a feature after the boundary). */\nexport function refineCostTag(patch: Partial<CostTag>): void {\n  const cur = store.getStore();\n  if (cur) Object.assign(cur, patch);\n}\n\n/** The current tag, or a safe empty default outside any bound context. */\nexport function currentCostTag(): CostTag {\n  return store.getStore() ?? DEFAULT_TAG;\n}\n\n/** Hierarchy separator for bucket paths — Firestore-map-key-safe and distinct from\n *  the \"col:\" leaf prefix. `bucket(\"a\", () => bucket(\"b\", …))` → \"a>b\". */\nexport const BUCKET_SEP = \">\";\n\n/**\n * `bucket(name, fn)` — the headline verb, the `track()` of cost. Run `fn` with\n * every operation inside it attributed to the bucket `name`; the attribution rides\n * the async subtree automatically. NESTS: a `bucket()` inside another COMPOSES into\n * a path (`\"analytics\" > \"rollup\"` → `\"analytics>rollup\"`), so the dashboard can\n * drill from the coarse bucket down into its parts. The one verb most developers touch:\n *\n *   await bucket(\"analytics\", () =>\n *     bucket(\"rollup\", () => db.collection(\"events\").where(...).get())); // → \"analytics>rollup>col:events\"\n */\nexport function bucket<T>(name: string, fn: () => T): T {\n  const parent = currentCostTag().label;\n  const path = parent ? `${parent}${BUCKET_SEP}${name}` : name;\n  return runWithCostTag({ ...currentCostTag(), label: path }, fn);\n}\n","/**\n * cost-meter — counts operations against the ambient tag and flushes them to the\n * configured Sink cheaply.\n *\n * LOW-OVERHEAD CONTRACT (the thing that warns you about reads must not run them\n * up): counts accumulate in an in-memory buffer and flush periodically — NEVER one\n * network call per counted operation. A flush coalesces the whole window into one\n * report per UTC day and hands it to the Sink. At steady state that is ~1 small\n * request a minute, regardless of how many ops you served.\n *\n * BEST-EFFORT CONTRACT: metering must never throw into your code. Every recorder\n * swallows its own errors; a failed flush drops that window's counts (surfaced via\n * `onError` if you pass one) rather than disturbing the app.\n */\nimport { currentCostTag } from \"./cost-context\";\nimport type { Sink, BucketsReport, ResourceCounts } from \"./sink\";\n\n/**\n * A resource unit — what an adapter counts. Firestore emits `read`/`write`/\n * `delete`; other adapters emit their own (`clickhouse.query_ms`, `openai.tokens`).\n * It is a free identifier on purpose, BUT each one is kept entirely distinct: the\n * meter only ever sums quantities WITHIN a single resource, never across two.\n */\nexport type ResourceUnit = string;\n/** @deprecated — Firestore-era name; use {@link ResourceUnit}. */\nexport type OpType = ResourceUnit;\n\n/** Optional read-site hint — the collection touched, derived at the trap from the\n *  path. Lets an UNtagged read cascade to `col:<collection>` instead of vanishing. */\nexport interface CostHint {\n  collection?: string;\n  projectId?: string;\n}\n\n// NUL separator — a bucket/collection name can contain almost anything except\n// this, so the key never collides with a name that has a \"|\" or \":\" in it.\nconst SEP = \"\\u001f\"; // ASCII Unit Separator\n\n/** key = date <NUL> resource <NUL> label → count */\nconst labelBuffer = new Map<string, number>();\n/** key = date <NUL> resource <NUL> hour → count */\nconst hourBuffer = new Map<string, number>();\n/** key = date <NUL> resource <NUL> 5-min-slot (\"HHMM\") → count. The fine grain\n *  that lets a developer verify against the provider console's \"last hour\" within\n *  minutes of installing — not after a day. Still one maintained doc, zero reads. */\nconst minuteBuffer = new Map<string, number>();\n\nlet sink: Sink | null = null;\nlet flushIntervalMs = 60_000;\nlet onError: ((e: unknown) => void) | null = null;\nlet timer: ReturnType<typeof setInterval> | null = null;\nlet flushing = false;\n/** Safety valve — flush early if a burst fills the buffer between intervals. */\nconst MAX_BUFFER_KEYS = 5_000;\n\nexport interface MeterConfig {\n  sink: Sink;\n  flushIntervalMs?: number;\n  onError?: (e: unknown) => void;\n}\n\n/** Point the meter at a sink. Called by `init()`; pass your own sink to self-host. */\nexport function configureMeter(config: MeterConfig): void {\n  sink = config.sink;\n  if (config.flushIntervalMs && config.flushIntervalMs > 0) flushIntervalMs = config.flushIntervalMs;\n  onError = config.onError ?? null;\n}\n\nconst utcDate = (): string => new Date().toISOString().slice(0, 10);\nconst utcHour = (): string => new Date().toISOString().slice(11, 13);\n/** UTC 5-minute slot of the day as \"HHMM\" — the slot START (e.g. 08:47 → \"0845\"). */\nconst utcFiveMin = (): string => {\n  const iso = new Date().toISOString();\n  const hh = iso.slice(11, 13);\n  const mm = Math.floor(Number(iso.slice(14, 16)) / 5) * 5;\n  return hh + String(mm).padStart(2, \"0\");\n};\n\nfunction ensureFlushLoop(): void {\n  if (timer) return;\n  timer = setInterval(() => void flush(), flushIntervalMs);\n  // Don't keep the event loop alive just for metering.\n  (timer as { unref?: () => void }).unref?.();\n  // Flush the last window on shutdown.\n  process.once?.(\"SIGTERM\", () => void flush());\n  process.once?.(\"beforeExit\", () => void flush());\n}\n\n/**\n * Count `quantity` of a `resource` against the live tag. THE adapter primitive —\n * a Firestore adapter records \"read\"; a ClickHouse adapter records\n * \"clickhouse.query_ms\"; an OpenAI adapter records \"openai.tokens\". Each resource\n * is bucketed entirely on its own; nothing is ever added across resources. Never\n * throws.\n */\nexport function record(resource: ResourceUnit, quantity: number, hint?: CostHint): void {\n  try {\n    if (!Number.isFinite(quantity) || quantity <= 0) return;\n    const t = currentCostTag();\n    const date = utcDate();\n    // HIERARCHY — the bucket path is the trunk; the collection is the LEAF kept\n    // beneath it (so a tagged bucket still drills down to which collections it\n    // read). \"analytics\" + events → \"analytics>col:events\"; untagged → \"col:events\";\n    // nothing derivable → \"uncategorized\". A unit is never invisible, and a tagged\n    // one never loses where it actually went.\n    const coll = hint?.collection ? `col:${hint.collection}` : null;\n    const label = t.label\n      ? coll\n        ? `${t.label}>${coll}`\n        : t.label\n      : coll ?? \"uncategorized\";\n    // Key includes the resource, so each resource accumulates in its OWN slot.\n    const lk = date + SEP + resource + SEP + label;\n    labelBuffer.set(lk, (labelBuffer.get(lk) ?? 0) + quantity);\n    const hk = date + SEP + resource + SEP + utcHour();\n    hourBuffer.set(hk, (hourBuffer.get(hk) ?? 0) + quantity);\n    const mk = date + SEP + resource + SEP + utcFiveMin();\n    minuteBuffer.set(mk, (minuteBuffer.get(mk) ?? 0) + quantity);\n    ensureFlushLoop();\n    if (labelBuffer.size + hourBuffer.size + minuteBuffer.size > MAX_BUFFER_KEYS) void flush();\n  } catch {\n    /* metering is best-effort — never disturb the caller */\n  }\n}\n\n/** @deprecated — use {@link record}. Firestore-era alias. */\nexport const recordFirestore = record;\n\n/** Firestore bills a minimum of one read even for an empty result, so 0 counts as 1. */\nexport function recordReads(n: number, hint?: CostHint): void {\n  record(\"read\", Math.max(n, 1), hint);\n}\nexport function recordWrites(n = 1): void {\n  record(\"write\", n);\n}\nexport function recordDeletes(n = 1): void {\n  record(\"delete\", n);\n}\n\nfunction add(target: Record<string, ResourceCounts>, key: string, resource: ResourceUnit, n: number): void {\n  const bag = (target[key] ??= {});\n  // Accumulate WITHIN this resource only — never merge resources.\n  bag[resource] = (bag[resource] ?? 0) + n;\n}\n\n/**\n * Coalesce the buffer into one report per UTC day and hand each to the Sink.\n * Snapshots + clears up front so concurrent records land in the next window.\n * Never throws; a sink failure drops that window (surfaced via `onError`).\n */\nexport async function flush(): Promise<void> {\n  if (flushing) return;\n  // Not configured (init not called) — drop, don't grow unbounded.\n  if (!sink) {\n    labelBuffer.clear();\n    hourBuffer.clear();\n    minuteBuffer.clear();\n    return;\n  }\n  if (labelBuffer.size === 0 && hourBuffer.size === 0 && minuteBuffer.size === 0) return;\n  flushing = true;\n\n  const labels = new Map(labelBuffer);\n  const hours = new Map(hourBuffer);\n  const minutes = new Map(minuteBuffer);\n  labelBuffer.clear();\n  hourBuffer.clear();\n  minuteBuffer.clear();\n\n  try {\n    const byDate = new Map<string, BucketsReport>();\n    const reportFor = (date: string): BucketsReport => {\n      let r = byDate.get(date);\n      if (!r) {\n        r = { date, byLabel: {}, byHour: {}, byMinute: {} };\n        byDate.set(date, r);\n      }\n      return r;\n    };\n    for (const [k, n] of labels) {\n      const [date, op, label] = k.split(SEP) as [string, OpType, string];\n      add(reportFor(date).byLabel, label, op, n);\n    }\n    for (const [k, n] of hours) {\n      const [date, op, hour] = k.split(SEP) as [string, OpType, string];\n      add(reportFor(date).byHour!, hour, op, n);\n    }\n    for (const [k, n] of minutes) {\n      const [date, op, slot] = k.split(SEP) as [string, OpType, string];\n      add(reportFor(date).byMinute!, slot, op, n);\n    }\n    for (const report of byDate.values()) {\n      await sink.flush(report);\n    }\n  } catch (e) {\n    // Drop this window rather than risk a partial/double report on retry.\n    onError?.(e);\n  } finally {\n    flushing = false;\n  }\n}\n","/**\n * sink — where the meter sends a coalesced rollup, and the wire shape it sends.\n *\n * Abstracting the sink is what makes Buckets storage-agnostic: the meter never\n * knows where counts go. The DEFAULT sink (`ReportSink`) reports up to Crossdeck's\n * ingest endpoint so the numbers surface on your Crossdeck dashboard. A team that\n * wants to self-host can implement `Sink` against anything (Postgres, a file, your\n * own API) without touching the meter.\n */\n\n/**\n * Counts for ONE bucket, keyed by RESOURCE UNIT — the raw quantity of each unit,\n * nothing more (no money; you verify cost on your provider's bill).\n *\n * Firestore, the first adapter, emits `read` / `write` / `delete`. Other adapters\n * emit their own units (`clickhouse.query_ms`, `openai.tokens`, …). The rule that\n * keeps this honest: **each resource is its own line. Counts are only ever summed\n * WITHIN a resource, NEVER across one.** A read is not a query-millisecond; the two\n * never land in the same number. (There is deliberately no \"total units\" field.)\n */\nexport interface ResourceCounts {\n  read?: number;\n  write?: number;\n  delete?: number;\n  /** Any other resource unit an adapter emits — kept distinct, never merged. */\n  [resource: string]: number | undefined;\n}\n\n/** @deprecated name — kept for back-compat; use {@link ResourceCounts}. */\nexport type OpCounts = ResourceCounts;\n\n/**\n * One coalesced report — the wire contract (see docs/ROLLUP_SCHEMA.md). The meter\n * produces one of these per UTC day in a flush window (usually exactly one).\n */\nexport interface BucketsReport {\n  /** UTC day \"YYYY-MM-DD\". */\n  date: string;\n  /** bucket name → counts. The heart of the report. */\n  byLabel: Record<string, ResourceCounts>;\n  /** UTC hour \"HH\" → counts, for the hourly \"did my fix land this hour?\" view. */\n  byHour?: Record<string, ResourceCounts>;\n  /** UTC 5-minute slot \"HHMM\" (slot start) → counts. The fine grain for fast\n   *  verification against a provider console's \"last hour\" view. */\n  byMinute?: Record<string, ResourceCounts>;\n}\n\n/**\n * A destination for coalesced rollups. `flush` MAY throw on failure — the meter\n * catches it, drops that one window, and never lets it reach your app.\n */\nexport interface Sink {\n  flush(report: BucketsReport): Promise<void>;\n}\n\nexport interface ReportSinkConfig {\n  /** The project's `cd_sk_` secret key. Server-to-server only. */\n  apiKey: string;\n  /** Defaults to https://api.cross-deck.com/v1/buckets/report */\n  endpoint?: string;\n  /** Request timeout (ms); a slow Crossdeck must never stall your flush. */\n  timeoutMs?: number;\n}\n\nconst DEFAULT_ENDPOINT = \"https://api.cross-deck.com/v1/buckets/report\";\n\n/**\n * The default sink: POST one coalesced rollup to Crossdeck's ingest endpoint.\n * The ingest folds it into the day's maintained doc with `increment`, so many\n * reports a minute coalesce safely. This path does ZERO database reads — it sends\n * a summary, it does not read. Throws on a non-202 so the meter can log/drop the\n * window; the meter guarantees it never reaches your app.\n */\nexport class ReportSink implements Sink {\n  private readonly endpoint: string;\n  private readonly apiKey: string;\n  private readonly timeoutMs: number;\n\n  constructor(config: ReportSinkConfig) {\n    this.endpoint = config.endpoint ?? DEFAULT_ENDPOINT;\n    this.apiKey = config.apiKey;\n    this.timeoutMs = config.timeoutMs ?? 5000;\n  }\n\n  async flush(report: BucketsReport): Promise<void> {\n    const res = await fetch(this.endpoint, {\n      method: \"POST\",\n      signal: AbortSignal.timeout(this.timeoutMs),\n      headers: {\n        \"content-type\": \"application/json\",\n        authorization: `Bearer ${this.apiKey}`,\n      },\n      body: JSON.stringify(report),\n    });\n    if (res.status !== 202) {\n      throw new Error(`Buckets report rejected: HTTP ${res.status}`);\n    }\n  }\n}\n\n/**\n * A sink that does nothing. Used when the local mirror is turned off AND no upstream\n * was configured — the meter still needs a sink to flush into, but there's nowhere to\n * send. Counts are dropped by the developer's explicit choice.\n */\nexport class NullSink implements Sink {\n  async flush(): Promise<void> {\n    /* intentionally empty */\n  }\n}\n","/**\n * readout — renders the local file a developer (or their AI session) reads back with\n * \"read me my buckets\". PURE string building: no I/O, no database reads. The node\n * mirror (./mirror) writes this to `.crossdeck/buckets.md` on each flush, so the\n * readout works offline, for free, with no account.\n */\nimport type { BucketsReport, ResourceCounts } from \"./sink\";\n\n/**\n * The one line that closes every readout. Plain and factual: what the OSS shows you\n * here, and what signing up adds — for free. No invented numbers, no urgency, no pitch.\n */\nexport const READOUT_FOOTER =\n  \"Buckets OSS shows the reads on this surface. Sign up to Crossdeck (free) to see \" +\n  \"every surface in one view, drill any bucket down to the exact query, track a fix \" +\n  \"before and after, and get paged when reads spike — cross-deck.com\";\n\nfunction fmt(n: number): string {\n  if (n >= 1_000_000) return (n / 1_000_000).toFixed(2) + \"M\";\n  if (n >= 10_000) return Math.round(n / 1000) + \"K\";\n  if (n >= 1000) return (n / 1000).toFixed(1) + \"K\";\n  return String(Math.round(n));\n}\n\n/** A bucket is untagged when its ROOT segment is a bare collection / catch-all. */\nfunction isUntagged(label: string): boolean {\n  const root = label.split(\">\")[0];\n  return root.startsWith(\"col:\") || root === \"uncategorized\" || root === \"unknown\";\n}\n\n/** Pretty path: strip the \"col:\" leaf prefix, join the hierarchy with \" › \". */\nfunction displayLabel(label: string): string {\n  return label\n    .split(\">\")\n    .map((s) => (s.startsWith(\"col:\") ? s.slice(4) : s))\n    .join(\" › \");\n}\n\n/** Render the day's coalesced report as a human/AI-readable markdown readout. */\nexport function renderReadout(report: BucketsReport): string {\n  const entries = Object.entries(report.byLabel ?? {})\n    .map(([label, counts]) => ({ label, reads: (counts as ResourceCounts).read ?? 0 }))\n    .filter((e) => e.reads > 0)\n    .sort((a, b) => b.reads - a.reads);\n\n  const total = entries.reduce((s, e) => s + e.reads, 0);\n  const out: string[] = [];\n  out.push(`# Buckets — reads on this surface`);\n  out.push(``);\n  out.push(`**${fmt(total)} reads** · ${report.date} (UTC)`);\n  out.push(``);\n\n  if (entries.length === 0) {\n    out.push(`No reads metered yet — install the collector and let your app serve some traffic.`);\n  } else {\n    out.push(`| bucket | named | reads |`);\n    out.push(`| --- | :---: | ---: |`);\n    for (const e of entries) {\n      out.push(`| ${displayLabel(e.label)} | ${isUntagged(e.label) ? \"—\" : \"✓\"} | ${fmt(e.reads)} |`);\n    }\n  }\n\n  out.push(``);\n  out.push(`---`);\n  out.push(READOUT_FOOTER);\n  out.push(``);\n  return out.join(\"\\n\");\n}\n","/**\n * mirror — tees every coalesced report to a local file so \"read me my buckets\" works\n * offline, free, with no account. Writes a human/AI-readable readout\n * (`.crossdeck/buckets.md`) plus the raw report (`.crossdeck/buckets.json`).\n *\n * NODE ONLY — never imported by the browser build (it touches the filesystem).\n *\n * Two contracts it keeps:\n *  - NO MONSTER: it only ever WRITES local files (~one small write a minute). It never\n *    reads your database; the report is already in hand.\n *  - BEST-EFFORT: a write error is swallowed — the local mirror must never disturb a\n *    flush or reach your app.\n *\n * The meter hands each flush a DELTA (the window's counts, then clears). To show the\n * day's running total, the mirror accumulates deltas in memory, seeded once from any\n * existing file so a process restart doesn't shrink the readout.\n */\nimport { mkdirSync, writeFileSync, readFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport type { Sink, BucketsReport, ResourceCounts } from \"./sink\";\nimport { renderReadout } from \"./readout\";\n\nexport const DEFAULT_MIRROR_DIR = \".crossdeck\";\n\nfunction mergeInto(target: Record<string, ResourceCounts>, src?: Record<string, ResourceCounts>): void {\n  if (!src) return;\n  for (const [key, counts] of Object.entries(src)) {\n    const bag = (target[key] ??= {});\n    for (const [res, n] of Object.entries(counts)) {\n      if (typeof n === \"number\") bag[res] = (bag[res] ?? 0) + n;\n    }\n  }\n}\n\n/**\n * Wraps an optional upstream sink. On each flush it writes the running day-total\n * locally, THEN (if an upstream sink was given — i.e. a key) reports onward.\n * With no upstream it is a pure local meter: the wedge, working with no account.\n */\nexport class MirrorSink implements Sink {\n  private acc: BucketsReport | null = null;\n  private announced = false;\n  private seeded = false;\n\n  constructor(\n    private readonly upstream: Sink | null,\n    private readonly dir: string = DEFAULT_MIRROR_DIR,\n  ) {}\n\n  private jsonPath(): string {\n    return join(this.dir, \"buckets.json\");\n  }\n\n  /** Seed the running total once from an existing same-day file (survives restarts). */\n  private seed(date: string): void {\n    if (this.seeded) return;\n    this.seeded = true;\n    try {\n      const prior = JSON.parse(readFileSync(this.jsonPath(), \"utf8\")) as BucketsReport;\n      if (prior?.date === date && prior.byLabel) this.acc = prior;\n    } catch {\n      /* no prior file (or unreadable) — start fresh */\n    }\n  }\n\n  async flush(report: BucketsReport): Promise<void> {\n    // Local first — the part that always works, key or no key.\n    try {\n      this.seed(report.date);\n      if (!this.acc || this.acc.date !== report.date) {\n        this.acc = { date: report.date, byLabel: {}, byHour: {}, byMinute: {} };\n      }\n      mergeInto(this.acc.byLabel, report.byLabel);\n      mergeInto((this.acc.byHour ??= {}), report.byHour);\n      mergeInto((this.acc.byMinute ??= {}), report.byMinute);\n\n      mkdirSync(this.dir, { recursive: true });\n      writeFileSync(join(this.dir, \"buckets.md\"), renderReadout(this.acc));\n      writeFileSync(this.jsonPath(), JSON.stringify(this.acc, null, 2));\n\n      if (!this.announced) {\n        this.announced = true;\n        // One quiet line, once, so a developer knows where to read it back.\n        // eslint-disable-next-line no-console\n        console.log(\n          `Buckets: readout at ${join(this.dir, \"buckets.md\")} — open it, or ask your AI session to \"read me my buckets\".`,\n        );\n      }\n    } catch {\n      /* local mirror is best-effort */\n    }\n\n    if (this.upstream) await this.upstream.flush(report);\n  }\n}\n","/**\n * adapters/firestore — the universal Firestore read meter (the trap).\n *\n * THE LESSON (learned on a real product): per-call-site `recordReads()`\n * instrumentation MISSES paths. You meter the read sites you're looking at and\n * leave the cron / trigger / ingest path uncounted — often the majority of reads,\n * invisible. Humans tag what they see and miss the path that matters.\n *\n * THE FIX: patch the admin SDK's read methods ONCE. From install onward, EVERY\n * read — anywhere, on any code path — is counted under the ambient tag, with zero\n * per-call-site work and no blind spots.\n *\n * SAFETY CONTRACT — this sits on your production read path, so it is defensive by\n * construction. Each wrapper:\n *   1. calls the REAL method first and captures the result,\n *   2. counts in a try/catch that can never throw into the caller,\n *   3. ALWAYS returns the real result, untouched.\n * It cannot break a read, change a result, or add latency beyond one in-memory\n * counter increment. A wrong count is a measurement error, never a correctness or\n * availability one. Idempotent — calling it twice patches once.\n *\n * COUNTING MODEL — a query returning N docs = N reads (an empty result still bills\n * 1, which the meter enforces). A document get = 1. getAll(...) = the ref count.\n * CollectionReference.get IS Query.get (shared prototype method), so patching Query\n * covers collections with no double-count.\n */\nimport { recordReads, type CostHint } from \"../cost-meter\";\n\nlet installed = false;\n\n/* eslint-disable @typescript-eslint/no-explicit-any */\ntype AnyFn = (...args: any[]) => any;\n\n/**\n * The firebase-admin Firestore classes to patch. Pass the module namespace from\n * `firebase-admin/firestore` — only the prototypes present are patched.\n */\nexport interface FirestoreClasses {\n  Query?: { prototype: { get?: AnyFn; onSnapshot?: AnyFn } };\n  DocumentReference?: { prototype: { get?: AnyFn; onSnapshot?: AnyFn } };\n  Transaction?: { prototype: { get?: AnyFn; getAll?: AnyFn } };\n  Firestore?: { prototype: { getAll?: AnyFn } };\n  /** count() / sum() / average() — aggregation queries bill reads too. */\n  AggregateQuery?: { prototype: { get?: AnyFn } };\n}\n\n/** `projects/{id}/…` → the project id, else undefined. Pure string op. */\nfunction projectFromPath(path: string): string | undefined {\n  const parts = path.split(\"/\");\n  const i = parts.indexOf(\"projects\");\n  return i >= 0 && parts[i + 1] ? parts[i + 1] : undefined;\n}\n\n/**\n * Derive { collection, projectId } from the read target's path so an UNtagged read\n * cascades to `col:<collection>` instead of \"uncategorized\". PURE CPU; never reads,\n * never throws. Falls back to firebase-admin's internal `_queryOptions` for filtered\n * queries (which don't expose `.path`).\n */\nfunction hintFrom(target: any): CostHint | undefined {\n  try {\n    const p = typeof target?.path === \"string\" ? target.path : \"\";\n    if (p) {\n      const parts = p.split(\"/\").filter(Boolean);\n      const collection = parts.length % 2 === 0 ? parts[parts.length - 2] : parts[parts.length - 1];\n      return { collection, projectId: projectFromPath(p) };\n    }\n    const qo = target?._queryOptions;\n    if (qo) {\n      const collection = typeof qo.collectionId === \"string\" ? qo.collectionId : undefined;\n      const parent =\n        typeof qo.parentPath?.relativeName === \"string\"\n          ? qo.parentPath.relativeName\n          : typeof qo.parentPath?.toString === \"function\"\n            ? String(qo.parentPath.toString())\n            : \"\";\n      return { collection, projectId: parent ? projectFromPath(parent) : undefined };\n    }\n  } catch {\n    /* the meter must never throw */\n  }\n  return undefined;\n}\n\nfunction meterSnap(snap: unknown, hint?: CostHint): void {\n  try {\n    const size = (snap as { size?: number } | null)?.size;\n    recordReads(typeof size === \"number\" ? size : 1, hint);\n  } catch {\n    /* best-effort */\n  }\n}\nfunction meterCount(n: number, hint?: CostHint): void {\n  try {\n    recordReads(n, hint);\n  } catch {\n    /* best-effort */\n  }\n}\n\n/**\n * Install the universal read meter on the firebase-admin Firestore classes. Call\n * ONCE at process start, before any reads. Pass the namespace from\n * `firebase-admin/firestore` so the exact prototypes the SDK uses are patched:\n *\n *   import * as Firestore from \"firebase-admin/firestore\";\n *   installFirestoreMeter(Firestore);\n */\nexport function installFirestoreMeter(classes: FirestoreClasses): void {\n  if (installed) return;\n  installed = true;\n  const { Query, DocumentReference, Transaction, Firestore, AggregateQuery } = classes;\n\n  // Query.get — covers Query AND CollectionReference (shared prototype method).\n  const qGet = Query?.prototype?.get;\n  if (qGet) {\n    Query!.prototype.get = async function (this: unknown, ...args: any[]) {\n      const snap = await qGet.apply(this, args);\n      meterSnap(snap, hintFrom(this));\n      return snap;\n    };\n  }\n\n  // DocumentReference.get — a single doc = 1 read.\n  const dGet = DocumentReference?.prototype?.get;\n  if (dGet) {\n    DocumentReference!.prototype.get = async function (this: unknown, ...args: any[]) {\n      const snap = await dGet.apply(this, args);\n      meterCount(1, hintFrom(this));\n      return snap;\n    };\n  }\n\n  // Transaction.get — query or doc; size when present, else 1.\n  const tGet = Transaction?.prototype?.get;\n  if (tGet) {\n    Transaction!.prototype.get = async function (this: unknown, ...args: any[]) {\n      const res = await tGet.apply(this, args);\n      meterSnap(res, hintFrom(args[0]));\n      return res;\n    };\n  }\n\n  // Transaction.getAll(...refs) — one read per ref.\n  const tGetAll = Transaction?.prototype?.getAll;\n  if (tGetAll) {\n    Transaction!.prototype.getAll = async function (this: unknown, ...args: any[]) {\n      const res = await tGetAll.apply(this, args);\n      meterCount(Array.isArray(res) ? res.length : args.length || 1, hintFrom(args[0]));\n      return res;\n    };\n  }\n\n  // Firestore.getAll(...refs) — batched doc reads.\n  const fGetAll = Firestore?.prototype?.getAll;\n  if (fGetAll) {\n    Firestore!.prototype.getAll = async function (this: unknown, ...args: any[]) {\n      const res = await fGetAll.apply(this, args);\n      meterCount(Array.isArray(res) ? res.length : args.length || 1, hintFrom(args[0]));\n      return res;\n    };\n  }\n\n  // AggregateQuery.get — count() / sum() / average(). Firestore bills one read per\n  // up to 1000 index entries scanned, and the client never sees that entry count —\n  // so this is an HONEST ESTIMATE: for count() we derive it from the result\n  // (ceil(count / 1000)), else the billed minimum of 1. Observe-only: it reads the\n  // result you already got, adds zero reads. (Closes the aggregation blind spot.)\n  const aGet = AggregateQuery?.prototype?.get;\n  if (aGet) {\n    AggregateQuery!.prototype.get = async function (this: unknown, ...args: any[]) {\n      const snap = await aGet.apply(this, args);\n      try {\n        const data = (snap as { data?: () => { count?: number } } | null)?.data?.();\n        const count = typeof data?.count === \"number\" ? data.count : 0;\n        meterCount(Math.max(1, Math.ceil(count / 1000)), hintFrom(this));\n      } catch {\n        /* best-effort */\n      }\n      return snap;\n    };\n  }\n\n  // Query.onSnapshot / DocumentReference.onSnapshot — server-side realtime\n  // listeners. We OBSERVE: wrap onNext and count the docs each fire delivers (a\n  // query's changed docs — first fire = all matching; a doc = 1). We attach no\n  // listener and issue no read; the meter just sees what the listener is already\n  // billed. (Closes the server-listener blind spot.)\n  const patchOnSnapshot = (proto: { onSnapshot?: AnyFn } | undefined, perDoc: boolean): void => {\n    const real = proto?.onSnapshot;\n    if (!real) return;\n    proto!.onSnapshot = function (this: unknown, ...args: any[]) {\n      const hint = hintFrom(this);\n      const i = args.findIndex((a) => typeof a === \"function\");\n      if (i >= 0) {\n        const onNext = args[i];\n        args[i] = function (snap: any) {\n          try {\n            const n = perDoc\n              ? 1\n              : typeof snap?.docChanges === \"function\"\n                ? snap.docChanges().length\n                : typeof snap?.size === \"number\"\n                  ? snap.size\n                  : 1;\n            if (n > 0) meterCount(n, hint);\n          } catch {\n            /* best-effort */\n          }\n          return onNext(snap);\n        };\n      }\n      return real.apply(this, args);\n    };\n  };\n  patchOnSnapshot(Query?.prototype, false);\n  patchOnSnapshot(DocumentReference?.prototype, true);\n}\n\n/** Test-only: reset the install guard so a suite can re-patch fresh prototypes. */\nexport function __resetFirestoreMeterForTests(): void {\n  installed = false;\n}\n","/**\n * @cross-deck/buckets — know exactly what every database read costs you, and who\n * caused it. A tiny, never-throws collector for Firestore.\n *\n * The whole footprint a consumer sees:\n *   1. init({ apiKey, firestore })  — configure once, install the trap once\n *   2. bucket(name, fn)             — name the read paths that matter\n *   3. (the dashboard shows the rest — and names the ones you haven't yet)\n */\nimport { configureMeter, type MeterConfig } from \"./cost-meter\";\nimport { ReportSink, NullSink, type Sink } from \"./sink\";\nimport { MirrorSink, DEFAULT_MIRROR_DIR } from \"./mirror\";\nimport { installFirestoreMeter, type FirestoreClasses } from \"./adapters/firestore\";\n\nexport interface InitOptions {\n  /**\n   * The project's `cd_sk_` SECRET key. Server-to-server only — never a browser key.\n   * OPTIONAL: with no key, Buckets still meters locally and writes the readout to\n   * disk (`.crossdeck/buckets.md`) — the free, no-account wedge. Add a key and it\n   * also reports up to Crossdeck so the numbers surface on your dashboard.\n   */\n  apiKey?: string;\n  /**\n   * Pass the namespace from `firebase-admin/firestore` to auto-install the read\n   * trap (recommended — this is what makes every read count with no per-call work).\n   * Omit it if you'd rather call `installFirestoreMeter()` yourself, or you only\n   * use the manual `recordReads()` recorders.\n   */\n  firestore?: FirestoreClasses;\n  /** Override the report endpoint (defaults to Crossdeck's ingest). */\n  endpoint?: string;\n  /** How often to flush coalesced counts (ms). Default 60_000. */\n  flushIntervalMs?: number;\n  /** Bring your own sink (self-host the rollups). Defaults to reporting up to Crossdeck. */\n  sink?: Sink;\n  /**\n   * Where to write the local readout — the file \"read me my buckets\" reads back.\n   * Defaults to `.crossdeck`. Pass `false` to turn the local mirror off entirely.\n   */\n  mirror?: string | false;\n  /** Notified when a flush fails, so a dropped window is never silent. Best-effort. */\n  onError?: MeterConfig[\"onError\"];\n}\n\n/**\n * Configure Buckets once, at process start. Always meters locally and writes the\n * readout to disk; if you pass `apiKey` (or your own `sink`) it ALSO reports up to\n * Crossdeck. Pass `firestore` to install the universal read trap so every read counts\n * automatically.\n */\nexport function init(options: InitOptions = {}): void {\n  // Upstream: your sink, else a Crossdeck reporter if a key was given, else nothing.\n  const upstream: Sink | null =\n    options.sink ?? (options.apiKey ? new ReportSink({ apiKey: options.apiKey, endpoint: options.endpoint }) : null);\n  // Default behaviour tees every flush to a local readout; `mirror:false` opts out.\n  const sink: Sink =\n    options.mirror === false\n      ? upstream ?? new NullSink()\n      : new MirrorSink(upstream, typeof options.mirror === \"string\" ? options.mirror : DEFAULT_MIRROR_DIR);\n  configureMeter({ sink, flushIntervalMs: options.flushIntervalMs, onError: options.onError });\n  if (options.firestore) installFirestoreMeter(options.firestore);\n}\n\n/** Alias — reads well next to `bucket()` at a call site. */\nexport { init as initBuckets };\n\n// The headline verb + the lower-level tag controls it is sugar over.\nexport {\n  bucket,\n  runWithCostTag,\n  enterCostTag,\n  refineCostTag,\n  currentCostTag,\n  type CostTag,\n} from \"./cost-context\";\n\n// Recorders. `record(resource, quantity)` is the generic adapter primitive — count\n// any resource unit (a future adapter records \"clickhouse.query_ms\"); recordReads/\n// Writes/Deletes are the Firestore conveniences over it.\nexport {\n  record,\n  recordReads,\n  recordWrites,\n  recordDeletes,\n  flush,\n  type CostHint,\n  type ResourceUnit,\n  type OpType,\n  type MeterConfig,\n} from \"./cost-meter\";\n\n// The trap (the only datastore adapter today) + its class shape.\nexport { installFirestoreMeter, type FirestoreClasses } from \"./adapters/firestore\";\n\n// The sink seam — for self-hosting rollups instead of reporting to Crossdeck.\nexport {\n  ReportSink,\n  NullSink,\n  type Sink,\n  type BucketsReport,\n  type ResourceCounts,\n  type OpCounts,\n  type ReportSinkConfig,\n} from \"./sink\";\n\n// The local readout — the file \"read me my buckets\" reads back, and its renderer.\nexport { MirrorSink, DEFAULT_MIRROR_DIR } from \"./mirror\";\nexport { renderReadout, READOUT_FOOTER } from \"./readout\";\n"]}

package/dist/{sink-DDQmzqm5.d.mts → sink-B-i4E1fY.d.mts}

@@ -70,5 +70,13 @@ declare class ReportSink implements Sink {
     constructor(config: ReportSinkConfig);
     flush(report: BucketsReport): Promise<void>;
 }
+/**
+ * A sink that does nothing. Used when the local mirror is turned off AND no upstream
+ * was configured — the meter still needs a sink to flush into, but there's nowhere to
+ * send. Counts are dropped by the developer's explicit choice.
+ */
+declare class NullSink implements Sink {
+    flush(): Promise<void>;
+}
 
-export { type BucketsReport as B, type OpCounts as O, ReportSink as R, type Sink as S, type ReportSinkConfig as a, type ResourceCounts as b };
+export { type BucketsReport as B, NullSink as N, type OpCounts as O, ReportSink as R, type Sink as S, type ReportSinkConfig as a, type ResourceCounts as b };

package/dist/{sink-DDQmzqm5.d.ts → sink-B-i4E1fY.d.ts}

@@ -70,5 +70,13 @@ declare class ReportSink implements Sink {
     constructor(config: ReportSinkConfig);
     flush(report: BucketsReport): Promise<void>;
 }
+/**
+ * A sink that does nothing. Used when the local mirror is turned off AND no upstream
+ * was configured — the meter still needs a sink to flush into, but there's nowhere to
+ * send. Counts are dropped by the developer's explicit choice.
+ */
+declare class NullSink implements Sink {
+    flush(): Promise<void>;
+}
 
-export { type BucketsReport as B, type OpCounts as O, ReportSink as R, type Sink as S, type ReportSinkConfig as a, type ResourceCounts as b };
+export { type BucketsReport as B, NullSink as N, type OpCounts as O, ReportSink as R, type Sink as S, type ReportSinkConfig as a, type ResourceCounts as b };

package/dist/web.d.mts

@@ -1,5 +1,5 @@
-import { S as Sink, B as BucketsReport } from './sink-DDQmzqm5.mjs';
-export { O as OpCounts } from './sink-DDQmzqm5.mjs';
+import { S as Sink, B as BucketsReport } from './sink-B-i4E1fY.mjs';
+export { O as OpCounts } from './sink-B-i4E1fY.mjs';
 
 /**
  * web/meter — the browser read meter. Same contract as the Node meter (count in

package/dist/web.d.ts

@@ -1,5 +1,5 @@
-import { S as Sink, B as BucketsReport } from './sink-DDQmzqm5.js';
-export { O as OpCounts } from './sink-DDQmzqm5.js';
+import { S as Sink, B as BucketsReport } from './sink-B-i4E1fY.js';
+export { O as OpCounts } from './sink-B-i4E1fY.js';
 
 /**
  * web/meter — the browser read meter. Same contract as the Node meter (count in

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cross-deck/buckets",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Know exactly what every database read costs you — and who caused it. A tiny, never-throws read-cost collector for Firestore, server AND browser.",
   "license": "MIT",
   "author": "Crossdeck",