@pyric/ui 0.1.0-alpha.10

package/dist/traffic/components/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/traffic/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EACL,eAAe,EACf,KAAK,oBAAoB,GAC1B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,EACL,eAAe,EACf,KAAK,oBAAoB,GAC1B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EACL,kBAAkB,EAClB,KAAK,uBAAuB,GAC7B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,gBAAgB,EAChB,KAAK,qBAAqB,GAC3B,MAAM,uBAAuB,CAAC"}

package/dist/traffic/components/index.js

@@ -0,0 +1,11 @@
+export { TrafficRow } from './TrafficRow.js';
+export { TrafficLog } from './TrafficLog.js';
+export { TrafficGroupRow, } from './TrafficGroupRow.js';
+export { TrafficDetail } from './TrafficDetail.js';
+export { RuleHeatmap } from './RuleHeatmap.js';
+export { TrafficStats } from './TrafficStats.js';
+export { TrafficTimeline, } from './TrafficTimeline.js';
+export { defaultFormatTime, reasonVerdict } from './format.js';
+export { TrafficMetricCards, } from './TrafficMetricCards.js';
+export { TrafficLineChart, } from './TrafficLineChart.js';
+//# sourceMappingURL=index.js.map

package/dist/traffic/components/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/traffic/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAwB,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,UAAU,EAAwB,MAAM,iBAAiB,CAAC;AACnE,OAAO,EACL,eAAe,GAEhB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,aAAa,EAA2B,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAAE,WAAW,EAAyB,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,YAAY,EAA0B,MAAM,mBAAmB,CAAC;AACzE,OAAO,EACL,eAAe,GAEhB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EACL,kBAAkB,GAEnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,gBAAgB,GAEjB,MAAM,uBAAuB,CAAC"}

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

@@ -0,0 +1,8 @@
+export { useTrafficMonitor, type UseTrafficMonitorOptions, type UseTrafficMonitorResult, type TrafficCounts, } from './useTrafficMonitor.js';
+export { useTrafficFilter, type UseTrafficFilterOptions, type UseTrafficFilterResult, type TrafficFilterState, type TrafficOriginFilter, type TrafficResultFilter, } from './useTrafficFilter.js';
+export { useRuleHeatmap, type UseRuleHeatmapOptions, type UseRuleHeatmapResult, type RuleHeatmapEntry, } from './useRuleHeatmap.js';
+export { useTrafficStats, type UseTrafficStatsOptions, type TrafficStatsSummary, type TrafficStatBucket, } from './useTrafficStats.js';
+export { useTrafficGroups, type UseTrafficGroupsOptions, type UseTrafficGroupsResult, type TrafficLogItem, type TrafficGroup, type TrafficSingle, type TrafficGroupKind, } from './useTrafficGroups.js';
+export { useTrafficBuckets, bucketTraffic, type UseTrafficBucketsOptions, type UseTrafficBucketsResult, type TrafficBucket, type TimeWindow, } from './useTrafficBuckets.js';
+export { useBillableMetrics, useRulesMetrics, bucketBillableMetrics, bucketRulesMetrics, classifyBillable, classifyRules, isAdminEvent, BILLABLE_SERIES_DEFS, RULES_SERIES_DEFS, type UseTrafficMetricsOptions, type TrafficMetricsResult, type MetricPoint, type MetricSeries, type BillableSeriesKey, type RulesSeriesKey, } from './useTrafficMetrics.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/traffic/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC5B,KAAK,aAAa,GACnB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,gBAAgB,EAChB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,GACzB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,cAAc,EACd,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,GACtB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,eAAe,EACf,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,GACvB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,gBAAgB,EAChB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,gBAAgB,GACtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC5B,KAAK,aAAa,EAClB,KAAK,UAAU,GAChB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,qBAAqB,EACrB,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,oBAAoB,EACpB,iBAAiB,EACjB,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,cAAc,GACpB,MAAM,wBAAwB,CAAC"}

package/dist/traffic/hooks/index.js

@@ -0,0 +1,8 @@
+export { useTrafficMonitor, } from './useTrafficMonitor.js';
+export { useTrafficFilter, } from './useTrafficFilter.js';
+export { useRuleHeatmap, } from './useRuleHeatmap.js';
+export { useTrafficStats, } from './useTrafficStats.js';
+export { useTrafficGroups, } from './useTrafficGroups.js';
+export { useTrafficBuckets, bucketTraffic, } from './useTrafficBuckets.js';
+export { useBillableMetrics, useRulesMetrics, bucketBillableMetrics, bucketRulesMetrics, classifyBillable, classifyRules, isAdminEvent, BILLABLE_SERIES_DEFS, RULES_SERIES_DEFS, } from './useTrafficMetrics.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/traffic/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,GAIlB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,gBAAgB,GAMjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,cAAc,GAIf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,eAAe,GAIhB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,gBAAgB,GAOjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,iBAAiB,EACjB,aAAa,GAKd,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,qBAAqB,EACrB,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,oBAAoB,EACpB,iBAAiB,GAOlB,MAAM,wBAAwB,CAAC"}

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

@@ -0,0 +1,33 @@
+import type { TrafficEvent } from '../types.js';
+export interface RuleHeatmapEntry {
+    /** The rule's index in the rules file. */
+    ruleIndex: number;
+    /** Union of all operations seen matching this rule. */
+    operations: string[];
+    /** Total events that matched this rule. */
+    total: number;
+    allows: number;
+    denies: number;
+    unsupported: number;
+    /** `denies / total` — 0 when the rule never denied. */
+    denyRatio: number;
+}
+export interface UseRuleHeatmapOptions {
+    events: TrafficEvent[];
+}
+export interface UseRuleHeatmapResult {
+    /** Per-rule rollup, sorted by `total` descending (busiest first),
+     *  ties broken by `ruleIndex` ascending. */
+    entries: RuleHeatmapEntry[];
+    /** Events that matched no rule — counted here, not attributed to
+     *  any entry. */
+    unmatchedCount: number;
+}
+/**
+ * Rolls a traffic buffer up by `matchedRule.ruleIndex`: how often
+ * each rule fired, and how that split across allow / deny /
+ * unsupported. Pure derivation — feed it the filtered or full
+ * event list depending on what the heatmap should reflect.
+ */
+export declare function useRuleHeatmap({ events, }: UseRuleHeatmapOptions): UseRuleHeatmapResult;
+//# sourceMappingURL=useRuleHeatmap.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useRuleHeatmap.d.ts","sourceRoot":"","sources":["../../../src/traffic/hooks/useRuleHeatmap.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,WAAW,gBAAgB;IAC/B,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,YAAY,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC;gDAC4C;IAC5C,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B;qBACiB;IACjB,cAAc,EAAE,MAAM,CAAC;CACxB;AAWD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,EAC7B,MAAM,GACP,EAAE,qBAAqB,GAAG,oBAAoB,CA4C9C"}

package/dist/traffic/hooks/useRuleHeatmap.js

@@ -0,0 +1,54 @@
+import { useMemo } from 'react';
+/**
+ * Rolls a traffic buffer up by `matchedRule.ruleIndex`: how often
+ * each rule fired, and how that split across allow / deny /
+ * unsupported. Pure derivation — feed it the filtered or full
+ * event list depending on what the heatmap should reflect.
+ */
+export function useRuleHeatmap({ events, }) {
+    return useMemo(() => {
+        const byRule = new Map();
+        let unmatchedCount = 0;
+        for (const event of events) {
+            if (!event.matchedRule) {
+                unmatchedCount++;
+                continue;
+            }
+            const { ruleIndex, operations } = event.matchedRule;
+            let acc = byRule.get(ruleIndex);
+            if (!acc) {
+                acc = {
+                    ruleIndex,
+                    operations: new Set(),
+                    total: 0,
+                    allows: 0,
+                    denies: 0,
+                    unsupported: 0,
+                };
+                byRule.set(ruleIndex, acc);
+            }
+            for (const op of operations)
+                acc.operations.add(op);
+            acc.total++;
+            if (event.result === 'allow')
+                acc.allows++;
+            else if (event.result === 'deny')
+                acc.denies++;
+            else
+                acc.unsupported++;
+        }
+        const entries = [...byRule.values()]
+            .map((acc) => ({
+            ruleIndex: acc.ruleIndex,
+            operations: [...acc.operations],
+            total: acc.total,
+            allows: acc.allows,
+            denies: acc.denies,
+            unsupported: acc.unsupported,
+            denyRatio: acc.total === 0 ? 0 : acc.denies / acc.total,
+        }))
+            .sort((a, b) => b.total - a.total || a.ruleIndex - b.ruleIndex);
+        return { entries, unmatchedCount };
+    }, [events]);
+}
+//# sourceMappingURL=useRuleHeatmap.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useRuleHeatmap.js","sourceRoot":"","sources":["../../../src/traffic/hooks/useRuleHeatmap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAuChC;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,EAC7B,MAAM,GACgB;IACtB,OAAO,OAAO,CAAC,GAAG,EAAE;QAClB,MAAM,MAAM,GAAG,IAAI,GAAG,EAAuB,CAAC;QAC9C,IAAI,cAAc,GAAG,CAAC,CAAC;QAEvB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;gBACvB,cAAc,EAAE,CAAC;gBACjB,SAAS;YACX,CAAC;YACD,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,KAAK,CAAC,WAAW,CAAC;YACpD,IAAI,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAChC,IAAI,CAAC,GAAG,EAAE,CAAC;gBACT,GAAG,GAAG;oBACJ,SAAS;oBACT,UAAU,EAAE,IAAI,GAAG,EAAE;oBACrB,KAAK,EAAE,CAAC;oBACR,MAAM,EAAE,CAAC;oBACT,MAAM,EAAE,CAAC;oBACT,WAAW,EAAE,CAAC;iBACf,CAAC;gBACF,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;YAC7B,CAAC;YACD,KAAK,MAAM,EAAE,IAAI,UAAU;gBAAE,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACpD,GAAG,CAAC,KAAK,EAAE,CAAC;YACZ,IAAI,KAAK,CAAC,MAAM,KAAK,OAAO;gBAAE,GAAG,CAAC,MAAM,EAAE,CAAC;iBACtC,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM;gBAAE,GAAG,CAAC,MAAM,EAAE,CAAC;;gBAC1C,GAAG,CAAC,WAAW,EAAE,CAAC;QACzB,CAAC;QAED,MAAM,OAAO,GAAuB,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;aACrD,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YACb,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,UAAU,EAAE,CAAC,GAAG,GAAG,CAAC,UAAU,CAAC;YAC/B,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,SAAS,EAAE,GAAG,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,KAAK;SACxD,CAAC,CAAC;aACF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC;QAElE,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC;IACrC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;AACf,CAAC"}

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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"}