@pyric/ui 0.1.0-alpha.7

package/dist/traffic/hooks/useTrafficBuckets.d.ts

@@ -0,0 +1,71 @@
+import type { TrafficEvent } from '../types.js';
+/**
+ * A half-open time window `[start, end)` in epoch-ms. The timeline
+ * buckets events whose `at` falls inside it; events outside are
+ * dropped from the histogram (but still counted in `outOfWindow`).
+ */
+export interface TimeWindow {
+    start: number;
+    end: number;
+}
+export interface TrafficBucket {
+    /** 0-based bucket index, left (oldest) to right (newest). */
+    index: number;
+    /** Half-open bounds of this bucket `[start, end)` in epoch-ms. */
+    start: number;
+    end: number;
+    /** Total events that fell in this bucket. */
+    count: number;
+    /** How many of `count` were denied. */
+    denies: number;
+    /** `count - denies` — allowed + unsupported. The "non-deny" stack. */
+    allows: number;
+    /**
+     * `count / maxCount` across all buckets — 0..1. The full bar
+     * height as a fraction of the tallest bucket. Drives
+     * `--pyric-bucket-h`.
+     */
+    heightRatio: number;
+    /**
+     * `denies / maxCount` — 0..1. The deny sub-stack height as a
+     * fraction of the tallest bucket, so the deny segment is drawn to
+     * the same scale as the full bar. Drives `--pyric-bucket-deny-h`.
+     */
+    denyHeightRatio: number;
+}
+export interface UseTrafficBucketsOptions {
+    events: TrafficEvent[];
+    /** The time range to bucket over. */
+    window: TimeWindow;
+    /** Number of buckets to divide the window into. Default 30. */
+    bucketCount?: number;
+}
+export interface UseTrafficBucketsResult {
+    buckets: TrafficBucket[];
+    /** Sum of `count` across buckets (events inside the window). */
+    total: number;
+    /** Sum of `denies` across buckets. */
+    denies: number;
+    /** The largest single-bucket `count` — the height-ratio divisor. */
+    maxCount: number;
+    /** Events whose `at` fell outside `[window.start, window.end)`. */
+    outOfWindow: number;
+}
+/**
+ * Buckets a traffic buffer into `bucketCount` equal time slices over
+ * `window`, counting total + denied events per slice. Pure
+ * derivation — the histogram component renders the result, this hook
+ * (and `bucketTraffic` under it) owns the math.
+ *
+ * Each bucket carries a `heightRatio` and `denyHeightRatio`
+ * (0..1, scaled to the tallest bucket) so the consumer can map them
+ * straight onto a bar height without re-finding the max.
+ */
+export declare function useTrafficBuckets({ events, window, bucketCount, }: UseTrafficBucketsOptions): UseTrafficBucketsResult;
+/**
+ * The pure bucketing kernel behind {@link useTrafficBuckets} — usable
+ * outside React. Returns an empty result for a non-positive
+ * `bucketCount` or a zero/negative-width window.
+ */
+export declare function bucketTraffic(events: TrafficEvent[], window: TimeWindow, bucketCount?: number): UseTrafficBucketsResult;
+//# sourceMappingURL=useTrafficBuckets.d.ts.map

package/dist/traffic/hooks/useTrafficBuckets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTrafficBuckets.d.ts","sourceRoot":"","sources":["../../../src/traffic/hooks/useTrafficBuckets.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,aAAa;IAC5B,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAC;IACd,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,qCAAqC;IACrC,MAAM,EAAE,UAAU,CAAC;IACnB,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,QAAQ,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,WAAW,EAAE,MAAM,CAAC;CACrB;AAUD;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,MAAM,EACN,MAAM,EACN,WAAgB,GACjB,EAAE,wBAAwB,GAAG,uBAAuB,CAKpD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,YAAY,EAAE,EACtB,MAAM,EAAE,UAAU,EAClB,WAAW,SAAK,GACf,uBAAuB,CAgDzB"}

package/dist/traffic/hooks/useTrafficBuckets.js

@@ -0,0 +1,74 @@
+import { useMemo } from 'react';
+const EMPTY_RESULT = {
+    buckets: [],
+    total: 0,
+    denies: 0,
+    maxCount: 0,
+    outOfWindow: 0,
+};
+/**
+ * Buckets a traffic buffer into `bucketCount` equal time slices over
+ * `window`, counting total + denied events per slice. Pure
+ * derivation — the histogram component renders the result, this hook
+ * (and `bucketTraffic` under it) owns the math.
+ *
+ * Each bucket carries a `heightRatio` and `denyHeightRatio`
+ * (0..1, scaled to the tallest bucket) so the consumer can map them
+ * straight onto a bar height without re-finding the max.
+ */
+export function useTrafficBuckets({ events, window, bucketCount = 30, }) {
+    return useMemo(() => bucketTraffic(events, window, bucketCount), [events, window.start, window.end, bucketCount]);
+}
+/**
+ * The pure bucketing kernel behind {@link useTrafficBuckets} — usable
+ * outside React. Returns an empty result for a non-positive
+ * `bucketCount` or a zero/negative-width window.
+ */
+export function bucketTraffic(events, window, bucketCount = 30) {
+    const span = window.end - window.start;
+    if (bucketCount <= 0 || span <= 0)
+        return EMPTY_RESULT;
+    const width = span / bucketCount;
+    const counts = new Array(bucketCount).fill(0);
+    const denyCounts = new Array(bucketCount).fill(0);
+    let total = 0;
+    let denies = 0;
+    let outOfWindow = 0;
+    for (const event of events) {
+        const at = event.at;
+        if (at < window.start || at >= window.end) {
+            outOfWindow++;
+            continue;
+        }
+        // Floor into a bucket; clamp the right edge so an `at` exactly at
+        // `window.end - epsilon` never spills past the last bucket.
+        let i = Math.floor((at - window.start) / width);
+        if (i >= bucketCount)
+            i = bucketCount - 1;
+        counts[i]++;
+        total++;
+        if (event.result === 'deny') {
+            denyCounts[i]++;
+            denies++;
+        }
+    }
+    let maxCount = 0;
+    for (const c of counts)
+        if (c > maxCount)
+            maxCount = c;
+    const buckets = counts.map((count, index) => {
+        const denyCount = denyCounts[index];
+        return {
+            index,
+            start: window.start + index * width,
+            end: window.start + (index + 1) * width,
+            count,
+            denies: denyCount,
+            allows: count - denyCount,
+            heightRatio: maxCount === 0 ? 0 : count / maxCount,
+            denyHeightRatio: maxCount === 0 ? 0 : denyCount / maxCount,
+        };
+    });
+    return { buckets, total, denies, maxCount, outOfWindow };
+}
+//# sourceMappingURL=useTrafficBuckets.js.map

package/dist/traffic/hooks/useTrafficBuckets.js.map

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

package/dist/traffic/hooks/useTrafficFilter.d.ts

@@ -0,0 +1,40 @@
+import type { TrafficEvent } from '../types.js';
+/**
+ * `user` keeps everything that isn't a listener re-eval (user ops
+ * plus their transaction/batch sub-ops); `listener` keeps only
+ * listener re-evals; `all` keeps everything.
+ */
+export type TrafficOriginFilter = 'user' | 'all' | 'listener';
+export type TrafficResultFilter = 'all' | 'allow' | 'deny';
+export interface UseTrafficFilterOptions {
+    events: TrafficEvent[];
+    /**
+     * Default `user` — the probe found listener traffic is 94–99.6%
+     * of events, so it's hidden until explicitly asked for.
+     */
+    initialOrigin?: TrafficOriginFilter;
+    /** Default `all` — the probe found ~75–80% allow in realistic
+     *  sessions, so hiding either side loses diagnostic signal. */
+    initialResult?: TrafficResultFilter;
+    initialPathQuery?: string;
+}
+export interface TrafficFilterState {
+    origin: TrafficOriginFilter;
+    result: TrafficResultFilter;
+    pathQuery: string;
+}
+export interface UseTrafficFilterResult {
+    /** Events passing all three filters, in the input order. */
+    filtered: TrafficEvent[];
+    filter: TrafficFilterState;
+    setOrigin: (origin: TrafficOriginFilter) => void;
+    setResult: (result: TrafficResultFilter) => void;
+    setPathQuery: (pathQuery: string) => void;
+}
+/**
+ * Derives a filtered view over a traffic buffer along three
+ * dimensions: origin, result, and a case-insensitive path substring.
+ * Owns the filter state; pure derivation otherwise.
+ */
+export declare function useTrafficFilter({ events, initialOrigin, initialResult, initialPathQuery, }: UseTrafficFilterOptions): UseTrafficFilterResult;
+//# sourceMappingURL=useTrafficFilter.d.ts.map

package/dist/traffic/hooks/useTrafficFilter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTrafficFilter.d.ts","sourceRoot":"","sources":["../../../src/traffic/hooks/useTrafficFilter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,KAAK,GAAG,UAAU,CAAC;AAE9D,MAAM,MAAM,mBAAmB,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,CAAC;AAE3D,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB;;;OAGG;IACH,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC;mEAC+D;IAC/D,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,MAAM,EAAE,mBAAmB,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,4DAA4D;IAC5D,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,SAAS,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,CAAC;IACjD,SAAS,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,CAAC;IACjD,YAAY,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3C;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,MAAM,EACN,aAAsB,EACtB,aAAqB,EACrB,gBAAqB,GACtB,EAAE,uBAAuB,GAAG,sBAAsB,CAuBlD"}

package/dist/traffic/hooks/useTrafficFilter.js

@@ -0,0 +1,33 @@
+import { useMemo, useState } from 'react';
+/**
+ * Derives a filtered view over a traffic buffer along three
+ * dimensions: origin, result, and a case-insensitive path substring.
+ * Owns the filter state; pure derivation otherwise.
+ */
+export function useTrafficFilter({ events, initialOrigin = 'user', initialResult = 'all', initialPathQuery = '', }) {
+    const [origin, setOrigin] = useState(initialOrigin);
+    const [result, setResult] = useState(initialResult);
+    const [pathQuery, setPathQuery] = useState(initialPathQuery);
+    const filtered = useMemo(() => {
+        const needle = pathQuery.trim().toLowerCase();
+        return events.filter((e) => {
+            if (origin === 'user' && e.origin === 'listener')
+                return false;
+            if (origin === 'listener' && e.origin !== 'listener')
+                return false;
+            if (result !== 'all' && e.result !== result)
+                return false;
+            if (needle && !e.path.toLowerCase().includes(needle))
+                return false;
+            return true;
+        });
+    }, [events, origin, result, pathQuery]);
+    return {
+        filtered,
+        filter: { origin, result, pathQuery },
+        setOrigin,
+        setResult,
+        setPathQuery,
+    };
+}
+//# sourceMappingURL=useTrafficFilter.js.map

package/dist/traffic/hooks/useTrafficFilter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTrafficFilter.js","sourceRoot":"","sources":["../../../src/traffic/hooks/useTrafficFilter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAwC1C;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,EAC/B,MAAM,EACN,aAAa,GAAG,MAAM,EACtB,aAAa,GAAG,KAAK,EACrB,gBAAgB,GAAG,EAAE,GACG;IACxB,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAsB,aAAa,CAAC,CAAC;IACzE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAsB,aAAa,CAAC,CAAC;IACzE,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,gBAAgB,CAAC,CAAC;IAE7D,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE;QAC5B,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC9C,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;YACzB,IAAI,MAAM,KAAK,MAAM,IAAI,CAAC,CAAC,MAAM,KAAK,UAAU;gBAAE,OAAO,KAAK,CAAC;YAC/D,IAAI,MAAM,KAAK,UAAU,IAAI,CAAC,CAAC,MAAM,KAAK,UAAU;gBAAE,OAAO,KAAK,CAAC;YACnE,IAAI,MAAM,KAAK,KAAK,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM;gBAAE,OAAO,KAAK,CAAC;YAC1D,IAAI,MAAM,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC;gBAAE,OAAO,KAAK,CAAC;YACnE,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;IAExC,OAAO;QACL,QAAQ;QACR,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE;QACrC,SAAS;QACT,SAAS;QACT,YAAY;KACb,CAAC;AACJ,CAAC"}

package/dist/traffic/hooks/useTrafficGroups.d.ts

@@ -0,0 +1,47 @@
+import type { TrafficEvent } from '../types.js';
+export type TrafficGroupKind = 'batch' | 'transaction' | 'listener-run';
+export interface TrafficGroup {
+    type: 'group';
+    kind: TrafficGroupKind;
+    /** `groupId` for batch/transaction; a synthetic key for listener
+     *  runs. Stable enough for a React key. */
+    key: string;
+    events: TrafficEvent[];
+    count: number;
+    denies: number;
+}
+export interface TrafficSingle {
+    type: 'single';
+    event: TrafficEvent;
+}
+export type TrafficLogItem = TrafficGroup | TrafficSingle;
+export interface UseTrafficGroupsOptions {
+    events: TrafficEvent[];
+    /** Collapse consecutive ops sharing a `groupId`. Default true. */
+    groupBatches?: boolean;
+    /**
+     * Collapse a consecutive run of listener re-evals from the same
+     * originating op into one group — the probe found a single write
+     * can trigger 250+ re-evals. Default true.
+     */
+    groupListenerRuns?: boolean;
+}
+export interface UseTrafficGroupsResult {
+    /** Events folded into a flat list of singles and groups, in the
+     *  input order. */
+    items: TrafficLogItem[];
+}
+/**
+ * Folds a traffic buffer into a list of singles and collapsible
+ * groups. Two grouping modes, both over *consecutive* events:
+ *
+ * - `groupId` — batch/transaction sub-ops sharing an id collapse
+ *   into one `batch` / `transaction` group.
+ * - listener runs — a consecutive run of listener re-evals from the
+ *   same originating op collapses into one `listener-run` group.
+ *   A run of length 1 stays a single (no point collapsing one row).
+ *
+ * Pure derivation; the input order is preserved.
+ */
+export declare function useTrafficGroups({ events, groupBatches, groupListenerRuns, }: UseTrafficGroupsOptions): UseTrafficGroupsResult;
+//# sourceMappingURL=useTrafficGroups.d.ts.map

package/dist/traffic/hooks/useTrafficGroups.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTrafficGroups.d.ts","sourceRoot":"","sources":["../../../src/traffic/hooks/useTrafficGroups.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,aAAa,GAAG,cAAc,CAAC;AAExE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,gBAAgB,CAAC;IACvB;+CAC2C;IAC3C,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,YAAY,CAAC;CACrB;AAED,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,aAAa,CAAC;AAE1D,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,kEAAkE;IAClE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,sBAAsB;IACrC;uBACmB;IACnB,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB;AAoBD;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,MAAM,EACN,YAAmB,EACnB,iBAAwB,GACzB,EAAE,uBAAuB,GAAG,sBAAsB,CAkDlD"}

package/dist/traffic/hooks/useTrafficGroups.js

@@ -0,0 +1,73 @@
+import { useMemo } from 'react';
+function sameTrigger(a, b) {
+    const ta = a.triggeredBy;
+    const tb = b.triggeredBy;
+    if (!ta && !tb)
+        return true;
+    if (!ta || !tb)
+        return false;
+    return ta.method === tb.method && ta.path === tb.path;
+}
+function makeGroup(kind, key, events) {
+    let denies = 0;
+    for (const e of events)
+        if (e.result === 'deny')
+            denies++;
+    return { type: 'group', kind, key, events, count: events.length, denies };
+}
+/**
+ * Folds a traffic buffer into a list of singles and collapsible
+ * groups. Two grouping modes, both over *consecutive* events:
+ *
+ * - `groupId` — batch/transaction sub-ops sharing an id collapse
+ *   into one `batch` / `transaction` group.
+ * - listener runs — a consecutive run of listener re-evals from the
+ *   same originating op collapses into one `listener-run` group.
+ *   A run of length 1 stays a single (no point collapsing one row).
+ *
+ * Pure derivation; the input order is preserved.
+ */
+export function useTrafficGroups({ events, groupBatches = true, groupListenerRuns = true, }) {
+    return useMemo(() => {
+        const items = [];
+        let i = 0;
+        while (i < events.length) {
+            const event = events[i];
+            if (groupBatches && event.groupId) {
+                let j = i + 1;
+                while (j < events.length && events[j].groupId === event.groupId)
+                    j++;
+                const run = events.slice(i, j);
+                const kind = event.origin === 'transaction' ? 'transaction' : 'batch';
+                items.push(makeGroup(kind, event.groupId, run));
+                i = j;
+                continue;
+            }
+            if (groupListenerRuns && event.origin === 'listener') {
+                let j = i + 1;
+                while (j < events.length &&
+                    events[j].origin === 'listener' &&
+                    !events[j].groupId &&
+                    sameTrigger(events[j], event)) {
+                    j++;
+                }
+                const run = events.slice(i, j);
+                if (run.length > 1) {
+                    const trigger = event.triggeredBy
+                        ? `${event.triggeredBy.method}:${event.triggeredBy.path}`
+                        : 'unknown';
+                    items.push(makeGroup('listener-run', `listener-run:${trigger}:${i}`, run));
+                }
+                else {
+                    items.push({ type: 'single', event });
+                }
+                i = j;
+                continue;
+            }
+            items.push({ type: 'single', event });
+            i++;
+        }
+        return { items };
+    }, [events, groupBatches, groupListenerRuns]);
+}
+//# sourceMappingURL=useTrafficGroups.js.map

package/dist/traffic/hooks/useTrafficGroups.js.map

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

package/dist/traffic/hooks/useTrafficMetrics.d.ts

@@ -0,0 +1,66 @@
+import type { TimeWindow } from './useTrafficBuckets.js';
+import type { TrafficEvent } from '../types.js';
+export type BillableSeriesKey = 'reads' | 'writes' | 'deletes';
+export type RulesSeriesKey = 'allows' | 'denies' | 'errors';
+export declare const BILLABLE_SERIES_DEFS: ReadonlyArray<{
+    key: BillableSeriesKey;
+    label: string;
+}>;
+export declare const RULES_SERIES_DEFS: ReadonlyArray<{
+    key: RulesSeriesKey;
+    label: string;
+}>;
+/** Default admin predicate: the one signal the public `TrafficEvent`
+ *  type declares. See the module doc for the known Firestore gap. */
+export declare function isAdminEvent(event: Pick<TrafficEvent, 'origin'>): boolean;
+/** Classify a billable op, or `null` if it isn't one / never ran. */
+export declare function classifyBillable(event: Pick<TrafficEvent, 'method' | 'result' | 'origin'>, isAdmin?: (event: Pick<TrafficEvent, 'origin'>) => boolean): BillableSeriesKey | null;
+/** Classify a rules-engine verdict, or `null` if it isn't one (bypassed,
+ *  unsupported, or not-applicable). */
+export declare function classifyRules(event: Pick<TrafficEvent, 'result' | 'origin'>, isAdmin?: (event: Pick<TrafficEvent, 'origin'>) => boolean): RulesSeriesKey | null;
+export interface MetricPoint {
+    /** 0-based bucket index, left (oldest) to right (newest). */
+    index: number;
+    /** Half-open bounds of this bucket `[start, end)` in epoch-ms. */
+    start: number;
+    end: number;
+}
+export interface MetricSeries {
+    key: string;
+    label: string;
+    /** One count per bucket, aligned with `points`. */
+    values: number[];
+    /** Sum of `values` — the period total (the legend/card number). */
+    total: number;
+}
+export interface TrafficMetricsResult {
+    points: MetricPoint[];
+    series: MetricSeries[];
+    /** The largest single-bucket value across every series — the shared
+     *  y-scale divisor a chart would use by default. */
+    maxValue: number;
+}
+/** Pure kernel behind {@link useBillableMetrics} — usable outside React. */
+export declare function bucketBillableMetrics(events: readonly TrafficEvent[], window: TimeWindow, bucketCount?: number, isAdmin?: (event: Pick<TrafficEvent, 'origin'>) => boolean): TrafficMetricsResult;
+/** Pure kernel behind {@link useRulesMetrics} — usable outside React. */
+export declare function bucketRulesMetrics(events: readonly TrafficEvent[], window: TimeWindow, bucketCount?: number, isAdmin?: (event: Pick<TrafficEvent, 'origin'>) => boolean): TrafficMetricsResult;
+export interface UseTrafficMetricsOptions {
+    events: TrafficEvent[];
+    window: TimeWindow;
+    /** Number of buckets to divide the window into. The window itself
+     *  should already be sized to the session (sandbox sessions run
+     *  minutes, not days) — bucket count doesn't need to change, only the
+     *  window a caller passes in. Default 24. */
+    bucketCount?: number;
+    /** Override admin classification (e.g. a Studio caller with
+     *  `authLens` provenance available — see the module doc). Defaults to
+     *  `origin === 'admin'`. */
+    isAdmin?: (event: Pick<TrafficEvent, 'origin'>) => boolean;
+}
+/** Reads / writes / deletes, bucketed over `window`. See the module doc
+ *  for the billable mapping + the "read ops, not billable reads" caveat. */
+export declare function useBillableMetrics({ events, window, bucketCount, isAdmin, }: UseTrafficMetricsOptions): TrafficMetricsResult;
+/** Allows / denies / errors, bucketed over `window`. Excludes
+ *  rules-bypassed (admin) ops — see the module doc. */
+export declare function useRulesMetrics({ events, window, bucketCount, isAdmin, }: UseTrafficMetricsOptions): TrafficMetricsResult;
+//# sourceMappingURL=useTrafficMetrics.d.ts.map

package/dist/traffic/hooks/useTrafficMetrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTrafficMetrics.d.ts","sourceRoot":"","sources":["../../../src/traffic/hooks/useTrafficMetrics.ts"],"names":[],"mappings":"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"}

package/dist/traffic/hooks/useTrafficMetrics.js

@@ -0,0 +1,156 @@
+import { useMemo } from 'react';
+/**
+ * Billable-metrics + rules-metrics aggregation (Traffic tab: "Billable
+ * metrics" and "Subscriptions & Rules"). Mirrors the Firebase Console
+ * Usage tab's shape (per-series totals + a bucketed time series), built
+ * on top of the same half-open `[window.start, window.end)` bucketing
+ * kernel {@link bucketTraffic} already uses.
+ *
+ * ── Billable mapping (documented; verified against the sandbox source) ──
+ *   reads    = get + list
+ *   writes   = create + update + set
+ *   deletes  = delete + remove
+ *
+ * A `list` event does NOT carry the number of documents the query
+ * returned — `local-environment.ts` emits ONE `allow` event per query
+ * before it computes/constrains the doc set, and the returned doc array
+ * never rides back onto the event. Real Firestore bills a list as one
+ * read PER RETURNED DOCUMENT; this stream can only honestly count list
+ * OPERATIONS, not documents. So this series is "read ops", not "billable
+ * reads" — an op-count proxy, not a byte-accurate bill. See the gap note
+ * in the Traffic feature's tracking issue.
+ *
+ * An op only bills if it actually ran against data: a `deny`/`error`/
+ * `unsupported`/`not-applicable` result means nothing was read or
+ * written, so those never count toward billable totals. An `admin`
+ * (rules-bypassed) op DOES run — admin reads/writes still bill in real
+ * Firestore — so admin ops count toward billable totals even though they
+ * never touch the rules-metrics series below.
+ *
+ * ── Rules metrics ──
+ * Allows / denies / errors are rules-ENGINE verdicts: how many times the
+ * rules engine actually ran and what it decided. An admin (bypassed) op
+ * never reaches rules, so it must never inflate "allows" — that would
+ * misrepresent the rules engine as having evaluated something it never
+ * saw. `unsupported` / `not-applicable` results aren't rules verdicts
+ * either (the simulator declined to evaluate) and are excluded too.
+ *
+ * ── Admin classification ──
+ * The base `TrafficEvent` carries only `origin` (no `detail` field — the
+ * sandbox-layer `RequestEvent.detail.admin` doesn't survive the
+ * `operation`-kind adapter path, and rides untyped through the
+ * `request`-kind cast). `origin === 'admin'` is the one signal declared
+ * on the public type, so it's the default `isAdmin` predicate here.
+ * Firestore's admin-lens ops don't currently set `origin: 'admin'`
+ * (RTDB's do) — callers that can see the richer Studio provenance
+ * (`authLens.mode === 'admin'`, as `verdict.ts#verdictFor` already
+ * checks) should pass their own `isAdmin` predicate to close that gap.
+ */
+const READ_METHODS = new Set(['get', 'list']);
+const WRITE_METHODS = new Set(['create', 'update', 'set']);
+const DELETE_METHODS = new Set(['delete', 'remove']);
+export const BILLABLE_SERIES_DEFS = [
+    { key: 'reads', label: 'Read ops' },
+    { key: 'writes', label: 'Writes' },
+    { key: 'deletes', label: 'Deletes' },
+];
+export const RULES_SERIES_DEFS = [
+    { key: 'allows', label: 'Allows' },
+    { key: 'denies', label: 'Denies' },
+    { key: 'errors', label: 'Errors' },
+];
+/** Default admin predicate: the one signal the public `TrafficEvent`
+ *  type declares. See the module doc for the known Firestore gap. */
+export function isAdminEvent(event) {
+    return event.origin === 'admin';
+}
+/** Classify a billable op, or `null` if it isn't one / never ran. */
+export function classifyBillable(event, isAdmin = isAdminEvent) {
+    const executed = event.result === 'allow' || isAdmin(event);
+    if (!executed)
+        return null;
+    if (READ_METHODS.has(event.method))
+        return 'reads';
+    if (WRITE_METHODS.has(event.method))
+        return 'writes';
+    if (DELETE_METHODS.has(event.method))
+        return 'deletes';
+    return null;
+}
+/** Classify a rules-engine verdict, or `null` if it isn't one (bypassed,
+ *  unsupported, or not-applicable). */
+export function classifyRules(event, isAdmin = isAdminEvent) {
+    if (isAdmin(event))
+        return null;
+    if (event.result === 'allow')
+        return 'allows';
+    if (event.result === 'deny')
+        return 'denies';
+    if (event.result === 'error')
+        return 'errors';
+    return null;
+}
+const EMPTY = (seriesDefs) => ({
+    points: [],
+    series: seriesDefs.map((d) => ({ key: d.key, label: d.label, values: [], total: 0 })),
+    maxValue: 0,
+});
+/** The shared bucketing kernel behind both metric hooks below. */
+function bucketMetrics(events, window, bucketCount, seriesDefs, classify) {
+    const span = window.end - window.start;
+    if (bucketCount <= 0 || span <= 0)
+        return EMPTY(seriesDefs);
+    const width = span / bucketCount;
+    const valuesByKey = new Map(seriesDefs.map((d) => [d.key, new Array(bucketCount).fill(0)]));
+    const totals = new Map(seriesDefs.map((d) => [d.key, 0]));
+    for (const event of events) {
+        const at = event.at;
+        if (at < window.start || at >= window.end)
+            continue;
+        const key = classify(event);
+        if (key == null)
+            continue;
+        let i = Math.floor((at - window.start) / width);
+        if (i >= bucketCount)
+            i = bucketCount - 1;
+        const bucketValues = valuesByKey.get(key);
+        bucketValues[i]++;
+        totals.set(key, (totals.get(key) ?? 0) + 1);
+    }
+    let maxValue = 0;
+    for (const values of valuesByKey.values()) {
+        for (const v of values)
+            if (v > maxValue)
+                maxValue = v;
+    }
+    const points = new Array(bucketCount);
+    for (let i = 0; i < bucketCount; i++) {
+        points[i] = { index: i, start: window.start + i * width, end: window.start + (i + 1) * width };
+    }
+    const series = seriesDefs.map((d) => ({
+        key: d.key,
+        label: d.label,
+        values: valuesByKey.get(d.key),
+        total: totals.get(d.key) ?? 0,
+    }));
+    return { points, series, maxValue };
+}
+/** Pure kernel behind {@link useBillableMetrics} — usable outside React. */
+export function bucketBillableMetrics(events, window, bucketCount = 24, isAdmin = isAdminEvent) {
+    return bucketMetrics(events, window, bucketCount, BILLABLE_SERIES_DEFS, (e) => classifyBillable(e, isAdmin));
+}
+/** Pure kernel behind {@link useRulesMetrics} — usable outside React. */
+export function bucketRulesMetrics(events, window, bucketCount = 24, isAdmin = isAdminEvent) {
+    return bucketMetrics(events, window, bucketCount, RULES_SERIES_DEFS, (e) => classifyRules(e, isAdmin));
+}
+/** Reads / writes / deletes, bucketed over `window`. See the module doc
+ *  for the billable mapping + the "read ops, not billable reads" caveat. */
+export function useBillableMetrics({ events, window, bucketCount = 24, isAdmin, }) {
+    return useMemo(() => bucketBillableMetrics(events, window, bucketCount, isAdmin), [events, window.start, window.end, bucketCount, isAdmin]);
+}
+/** Allows / denies / errors, bucketed over `window`. Excludes
+ *  rules-bypassed (admin) ops — see the module doc. */
+export function useRulesMetrics({ events, window, bucketCount = 24, isAdmin, }) {
+    return useMemo(() => bucketRulesMetrics(events, window, bucketCount, isAdmin), [events, window.start, window.end, bucketCount, isAdmin]);
+}
+//# sourceMappingURL=useTrafficMetrics.js.map

package/dist/traffic/hooks/useTrafficMetrics.js.map

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