@buoy-gg/network 7.0.40 → 7.0.42

package/lib/module/network/utils/networkSelectionStore.js

@@ -1,188 +1 @@
-"use strict";
-
-/**
- * Which request the detail view is showing, and where it sits in the list —
- * the prev/next CURSOR.
- *
- * ## Why this is a store and not `useState` in the modal
- *
- * It used to be `useState` in `NetworkModalInner`. Every tap on Previous/Next
- * therefore dirtied the modal ROOT, which re-rendered `JsModal` (1833 lines,
- * nine useStates, animations/gestures/persistence — and it can never bail out,
- * because its `header` prop is a fresh object literal every render), the whole
- * header, and all five screens. None of them care which request is selected;
- * they only care THAT one is.
- *
- * This is the same argument `NetworkModal`'s own header comment already makes
- * about network events ("with the subscription here, 15 events re-rendered
- * JsModal + every header button 15×"). Stepping is that same class of
- * high-frequency churn, and it was sitting in the same wrong place. Now the
- * root subscribes to `hasSelection` — a boolean that flips twice a session —
- * while the footer, the body and the header's pin actions subscribe to the
- * parts they actually render.
- *
- * ## The three cursors
- *
- * `selectedId` is where the USER is. It moves on the tap, synchronously.
- *
- * `bodyId` is what the detail body is allowed to render, and it deliberately
- * LAGS: drawing a request means handing its payload to the virtualized data
- * viewer to flatten, and that has no business blocking the next tap. It
- * catches up only once the selection has held still for `settleMs`, so a
- * burst of taps renders the request you land on and none of the ones you flew
- * past. (`useDeferredValue` was tried here first and is the wrong tool — it
- * lowers the priority of that work without preventing it, so every settled
- * step still queued a flatten and each one delayed the touch behind it.)
- *
- * `renderedId` is what actually made it to the screen, reported by the detail
- * screen after commit. Nothing in the product reads it; it exists so the
- * benchmark harness can measure "time until request N was really painted"
- * separately from "time until the cursor reached N".
- */
-
-/**
- * How long the selection must hold still before the body renders it. Short
- * enough that a single step reads as immediate (the footer and header have
- * already moved), long enough that a burst collapses to one render.
- */
-export const DEFAULT_SETTLE_MS = 120;
-class NetworkSelectionStore {
-  ids = [];
-  index = -1;
-  selectedId = null;
-  bodyId = null;
-  renderedId = null;
-  settleMs = DEFAULT_SETTLE_MS;
-  settleTimer = null;
-  subscribers = new Set();
-  snapshot = this.buildSnapshot();
-  buildSnapshot() {
-    return {
-      ids: this.ids,
-      index: this.index,
-      selectedId: this.selectedId,
-      bodyId: this.bodyId,
-      renderedId: this.renderedId
-    };
-  }
-
-  /**
-   * One immutable snapshot per mutation, so subscribers can identity-compare
-   * and `useSyncExternalStore` stays happy.
-   */
-  emit() {
-    this.snapshot = this.buildSnapshot();
-    for (const subscriber of this.subscribers) subscriber(this.snapshot);
-  }
-  getState() {
-    return this.snapshot;
-  }
-  subscribe(subscriber) {
-    this.subscribers.add(subscriber);
-    return () => {
-      this.subscribers.delete(subscriber);
-    };
-  }
-
-  /**
-   * Publish the navigable order. Called by the stepper whenever its derived
-   * list changes (filter, search, pins, new requests arriving).
-   *
-   * The cursor is re-anchored BY ID, not by position: the live list is
-   * newest-first and new requests are prepended, so holding an index would
-   * silently slide the selection onto a different request every time one
-   * landed.
-   */
-  setIds(ids) {
-    const sameIds = ids.length === this.ids.length && ids.every((id, i) => id === this.ids[i]);
-    if (sameIds) return;
-    this.ids = ids;
-    this.index = this.selectedId == null ? -1 : ids.indexOf(this.selectedId);
-    this.emit();
-  }
-  select(id) {
-    if (id === this.selectedId) return;
-    this.selectedId = id;
-    this.index = id == null ? -1 : this.ids.indexOf(id);
-    this.scheduleBody(id);
-    this.emit();
-  }
-  clear() {
-    this.select(null);
-  }
-
-  /**
-   * Move the cursor. O(1) — the whole reason `index` is stored rather than
-   * re-derived with a `findIndex` on every render.
-   *
-   * Returns the id it landed on, or null if the move was out of bounds (the
-   * footer disables its arrows at the ends, but the benchmark driver calls
-   * this directly and needs to know when it has run off the end).
-   */
-  step(delta) {
-    if (this.index < 0) return null;
-    const next = this.index + delta;
-    if (next < 0 || next >= this.ids.length) return null;
-    const id = this.ids[next];
-    this.selectedId = id;
-    this.index = next;
-    this.scheduleBody(id);
-    this.emit();
-    return id;
-  }
-
-  /**
-   * Opening and closing skip the settle delay: there is no in-flight render to
-   * protect on a null↔id transition, and waiting there just reads as a hang.
-   * Only id → id steps debounce.
-   */
-  scheduleBody(id) {
-    if (this.settleTimer != null) {
-      clearTimeout(this.settleTimer);
-      this.settleTimer = null;
-    }
-    if (id == null || this.bodyId == null || this.settleMs <= 0) {
-      this.bodyId = id;
-      return;
-    }
-    this.settleTimer = setTimeout(() => {
-      this.settleTimer = null;
-      if (this.bodyId === this.selectedId) return;
-      this.bodyId = this.selectedId;
-      this.emit();
-    }, this.settleMs);
-  }
-
-  /** Benchmark toggle — `?settle=0` measures the gate's contribution. */
-  setSettleMs(ms) {
-    this.settleMs = Math.max(0, ms);
-  }
-  getSettleMs() {
-    return this.settleMs;
-  }
-
-  /** Reported by the detail screen after commit. Instrumentation only. */
-  reportRendered(id) {
-    if (id === this.renderedId) return;
-    this.renderedId = id;
-    this.emit();
-  }
-
-  /** Test/bench helper — drop all cursor state without touching the events. */
-  reset() {
-    if (this.settleTimer != null) clearTimeout(this.settleTimer);
-    this.settleTimer = null;
-    this.ids = [];
-    this.index = -1;
-    this.selectedId = null;
-    this.bodyId = null;
-    this.renderedId = null;
-    this.emit();
-  }
-}
-export const networkSelectionStore = new NetworkSelectionStore();
-
-/** Convenience for publishing an event list as the navigable order. */
-export function toSelectionIds(events) {
-  return events.map(event => event.id);
-}
+"use strict";export const DEFAULT_SETTLE_MS=120;class l{ids=[];index=-1;selectedId=null;bodyId=null;renderedId=null;settleMs=DEFAULT_SETTLE_MS;settleTimer=null;subscribers=new Set;snapshot=this.buildSnapshot();buildSnapshot(){return{ids:this.ids,index:this.index,selectedId:this.selectedId,bodyId:this.bodyId,renderedId:this.renderedId}}emit(){this.snapshot=this.buildSnapshot();for(const e of this.subscribers)e(this.snapshot)}getState(){return this.snapshot}subscribe(e){this.subscribers.add(e);return()=>{this.subscribers.delete(e)}}setIds(e){const t=e.length===this.ids.length&&e.every((s,d)=>s===this.ids[d]);if(t)return;this.ids=e;this.index=this.selectedId==null?-1:e.indexOf(this.selectedId);this.emit()}select(e){if(e===this.selectedId)return;this.selectedId=e;this.index=e==null?-1:this.ids.indexOf(e);this.scheduleBody(e);this.emit()}clear(){this.select(null)}step(e){if(this.index<0)return null;const t=this.index+e;if(t<0||t>=this.ids.length)return null;const s=this.ids[t];this.selectedId=s;this.index=t;this.scheduleBody(s);this.emit();return s}scheduleBody(e){if(this.settleTimer!=null){clearTimeout(this.settleTimer);this.settleTimer=null}if(e==null||this.bodyId==null||this.settleMs<=0){this.bodyId=e;return}this.settleTimer=setTimeout(()=>{this.settleTimer=null;if(this.bodyId===this.selectedId)return;this.bodyId=this.selectedId;this.emit()},this.settleMs)}setSettleMs(e){this.settleMs=Math.max(0,e)}getSettleMs(){return this.settleMs}reportRendered(e){if(e===this.renderedId)return;this.renderedId=e;this.emit()}reset(){if(this.settleTimer!=null)clearTimeout(this.settleTimer);this.settleTimer=null;this.ids=[];this.index=-1;this.selectedId=null;this.bodyId=null;this.renderedId=null;this.emit()}}export const networkSelectionStore=new l;export function toSelectionIds(i){return i.map(e=>e.id)}

package/lib/module/network/utils/realNow.js

@@ -0,0 +1 @@
+"use strict";export function realNow(){const e=globalThis.__buoyRealNow;return typeof e==="function"?e():Date.now()}function t(){const e=globalThis.__buoyRealTimers;return e??globalThis}export function realSetTimeout(e,o){return t().setTimeout(e,o)}export function realClearTimeout(e){t().clearTimeout(e)}

package/lib/module/network/utils/requestId.js

@@ -0,0 +1 @@
+"use strict";const n=globalThis;export function nextRequestId(e){const t=n.__BUOY_NETWORK_REQUEST_SEQUENCE__??={session:`${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`,next:0};return`${e}_${t.session}_${++t.next}`}

package/lib/module/network/utils/resolveRequestUrl.js

@@ -0,0 +1 @@
+"use strict";export function resolveRequestUrl(e){if(typeof document==="undefined")return e;try{return new URL(e,document.baseURI).href}catch{return e}}

package/lib/module/network/utils/selectSavedEvents.js

@@ -1,35 +1 @@
-"use strict";
-
-/**
- * The SAVED screen's visible list, as a pure function.
- *
- * Two places need the exact same list: the screen that renders it
- * (`NetworkSavedScreen`) and the detail footer that steps through it
- * (`NetworkDetailStepper`). If they derived it independently, "Next" would
- * eventually disagree with the row below — the same drift `withPinnedFirst`
- * exists to prevent for the live list.
- */
-
-import { filterNetworkEvents } from "./filterNetworkEvents";
-import { MAX_SAVED } from "./networkSavedStore";
-export function selectSavedEvents(savedRecords,
-/**
- * How many saves this tier may see — `useLimit("network.saved")`. Takes a
- * number rather than `isPro` because Pro's cap is 50, not unlimited, and a
- * boolean cannot express that.
- */
-limit, search) {
-  /**
-   * A downgrade (or a limit change) can leave a user holding more saves than
-   * their tier allows. Rather than deleting their data, the overflow is
-   * LOCKED — oldest first, so the newest saves stay reachable.
-   */
-  const unlocked = savedRecords.slice(0, Math.min(limit, MAX_SAVED));
-  const events = unlocked.map(record => record.event);
-  return {
-    events: search ? filterNetworkEvents(events, {
-      searchText: search
-    }) : events,
-    lockedCount: savedRecords.length - unlocked.length
-  };
-}
+"use strict";import{filterNetworkEvents as c}from"./filterNetworkEvents";import{MAX_SAVED as i}from"./networkSavedStore";export function selectSavedEvents(t,r,e){const n=t.slice(0,Math.min(r,i));const o=n.map(s=>s.event);return{events:e?c(o,{searchText:e}):o,lockedCount:t.length-n.length}}

package/lib/module/network/utils/startNetworkCapture.js

@@ -0,0 +1 @@
+"use strict";import{networkEventStore as o}from"./networkEventStore";import{overrideRulesStore as n}from"../overrides/overrideRulesStore";export function startNetworkCapture(){const t=typeof navigator!=="undefined"&&navigator.product==="ReactNative";if(!t&&(typeof window==="undefined"||typeof document==="undefined"))return()=>{};void n.ensureLoaded();const r=o.subscribeToEvents(()=>{});let e=false;return()=>{if(e)return;e=true;r()}}

package/lib/module/network/utils/withPinnedFirst.js

@@ -1,28 +1 @@
-"use strict";
-
-/**
- * Split a filtered event list into its PINNED section and the rest.
- *
- * Lives as a pure function because there are TWO list implementations — the
- * mobile modal's `NetworkListScreen` and the desktop dashboard's hand-mirrored
- * `NetworkInline` — and pin ordering silently diverging between them is
- * exactly the drift `buoy.tools.json` exists to prevent.
- *
- * Pins are deliberately NOT filtered: they come straight from the saved store,
- * so a pinned request stays visible no matter what the search box or the
- * status chips say. The only thing the filtered list contributes is the
- * dedupe — a pinned request that is still live must not render twice.
- */
-
-const EMPTY = [];
-export function splitPinned(filtered, pinnedEvents, /** Live IDs pinned in THIS session — from `networkSavedStore.getState()`. */
-pinnedLiveIds) {
-  if (pinnedEvents.length === 0) return {
-    pinned: EMPTY,
-    rest: filtered
-  };
-  return {
-    pinned: pinnedEvents,
-    rest: pinnedLiveIds.size === 0 ? filtered : filtered.filter(event => !pinnedLiveIds.has(event.id))
-  };
-}
+"use strict";const i=[];export function splitPinned(t,n,r){if(n.length===0)return{pinned:i,rest:t};return{pinned:n,rest:r.size===0?t:t.filter(s=>!r.has(s.id))}}

package/lib/module/preset.js

@@ -1,100 +1 @@
-"use strict";
-
-import { NetworkConditionsIcon } from "./network/conditions/NetworkConditionsIcon";
-/**
- * Pre-configured network monitoring tool for FloatingDevTools
- *
- * This preset provides a zero-config way to add network request monitoring to your dev tools.
- * Just import and add it to your apps array!
- *
- * @example
- * ```tsx
- * import { networkToolPreset } from '@buoy-gg/network';
- *
- * const installedApps = [
- *   networkToolPreset, // That's it!
- *   // ...other tools
- * ];
- * ```
- */
-
-import { createToolFactory, defineToolPreset } from "@buoy-gg/shared-ui";
-import { NetworkModal } from "./network/components/NetworkModal";
-import { overrideRulesStore } from "./network/overrides/overrideRulesStore";
-import { networkEventStore } from "./network/utils/networkEventStore";
-
-/**
- * Load persisted response-override rules as soon as the tool is registered.
- *
- * Deliberately at import time rather than when the Network modal mounts: an
- * override has to fire from app boot, with the tool closed and nothing
- * capturing — that is the whole point of persisting rules ("force this endpoint
- * to 500, then restart and watch the boot path"). Hydrating also re-installs
- * the interceptor if any rule is still active. One storage read, dev-only.
- */
-import { jsx as _jsx } from "react/jsx-runtime";
-void overrideRulesStore.ensureLoaded();
-
-/**
- * Install interception at IMPORT time and buffer boot traffic.
- *
- * Capture used to start with the first subscriber (Network modal open,
- * dashboard/MCP watch) — long after the app's startup requests (module-scope
- * fetches, session bootstrap, the first query) had fired, so boot traffic was
- * permanently invisible. The boot buffer holds those raw events until the
- * first consumer subscribes, then flushes them into the store; if nothing
- * ever subscribes, nothing is flushed (see startBootCapture).
- *
- * Guards:
- * - `navigator.product === "ReactNative"` — a real RN runtime only. The
- *   desktop dashboard and web mirrors also evaluate this module and must
- *   never intercept their OWN process's traffic.
- * - Dev-only, like the rest of the automatic capture behavior.
- */
-const isReactNativeRuntime = typeof navigator !== "undefined" && navigator.product === "ReactNative";
-if (isReactNativeRuntime && typeof __DEV__ !== "undefined" && __DEV__) {
-  networkEventStore.startBootCapture();
-}
-
-/**
- * Pre-configured network monitoring tool for FloatingDevTools.
- * Includes:
- * - Live network request monitoring
- * - Request/response inspection
- * - Filter by status, method, URL
- * - Timing information
- */
-export const networkToolPreset = defineToolPreset({
-  id: "network",
-  name: "NET",
-  description: "Network request logger",
-  slot: "both",
-  icon: ({
-    size
-  }) => /*#__PURE__*/_jsx(NetworkConditionsIcon, {
-    size: size
-  }),
-  component: NetworkModal,
-  props: {
-    enableSharedModalDimensions: false
-  }
-});
-
-/**
- * Create a custom network monitoring tool configuration.
- * Use this if you want to override default settings.
- *
- * @example
- * ```tsx
- * import { createNetworkTool } from '@buoy-gg/network';
- *
- * const myNetworkTool = createNetworkTool({
- *   name: "REQUESTS",
- *   iconColor: "#9945FF", // Purple color
- *   enableSharedModalDimensions: true,
- * });
- * ```
- */
-export const createNetworkTool = createToolFactory(networkToolPreset, options => ({
-  enableSharedModalDimensions: options.enableSharedModalDimensions ?? false
-}));
+"use strict";import{NetworkConditionsIcon as t}from"./network/conditions/NetworkConditionsIcon";import{createToolFactory as r,defineToolPreset as i}from"@buoy-gg/shared-ui";import{NetworkModal as n}from"./network/components/NetworkModal";import{overrideRulesStore as a}from"./network/overrides/overrideRulesStore";import{networkEventStore as s}from"./network/utils/networkEventStore";import{jsx as d}from"react/jsx-runtime";const e=typeof navigator!=="undefined"&&navigator.product==="ReactNative";if(e)void a.ensureLoaded();if(e&&typeof __DEV__!=="undefined"&&__DEV__){s.startBootCapture()}export const networkToolPreset=i({id:"network",name:"NET",description:"Network request logger",slot:"both",icon:({size:o})=>d(t,{size:o}),component:n,props:{enableSharedModalDimensions:false}});export const createNetworkTool=r(networkToolPreset,o=>({enableSharedModalDimensions:o.enableSharedModalDimensions??false}));

package/lib/typescript/index.d.ts

@@ -8,6 +8,7 @@
  * bypassing the tool's intended usage patterns.
  */
 export { networkToolPreset, createNetworkTool } from "./preset";
+export { startNetworkCapture } from "./network/utils/startNetworkCapture";
 export { NetworkModal, NetworkToolView } from "./network/components/NetworkModal";
 export type { NetworkToolViewProps } from "./network/components/NetworkModal";
 export { NetworkEventDetailView } from "./network/components/NetworkEventDetailView";

package/lib/typescript/network/overrides/applyToXhr.d.ts

@@ -57,6 +57,7 @@ export declare function canSynthesize(xhr: XMLHttpRequest): boolean;
  * rules out half-mocks that could take the branch and then leak listeners.
  */
 export declare function canSynthesizeStandard(xhr: XMLHttpRequest): boolean;
+export declare function hasPendingStandardRequest(xhr: XMLHttpRequest): boolean;
 /**
  * Apply an outcome to a request that has NOT been sent yet.
  *

package/lib/typescript/network/overrides/engine.d.ts

@@ -50,5 +50,5 @@ export declare function inspectEngine(url: string, method: string): {
  * broken dev tool, so the gate is here — at the single entry point — rather
  * than trusted to every call site.
  */
-export declare function overrideForRequest(url: string, method: string): OverrideOutcome | null;
+export declare function overrideForRequest(url: string, method: string, headers?: Record<string, string>): OverrideOutcome | null;
 //# sourceMappingURL=engine.d.ts.map

package/lib/typescript/network/overrides/matchRule.d.ts

@@ -18,5 +18,5 @@ import type { OverrideRule } from "./types";
 export declare function escapeRegex(pattern: string): string;
 export declare function compilePattern(pattern: string): RegExp;
 /** Does this rule apply to this request? Ignores `enabled` — callers check it. */
-export declare function ruleMatches(rule: OverrideRule, url: string, method: string): boolean;
+export declare function ruleMatches(rule: OverrideRule, url: string, method: string, headers?: Record<string, string>): boolean;
 //# sourceMappingURL=matchRule.d.ts.map

package/lib/typescript/network/overrides/overriddenRows.d.ts

@@ -0,0 +1,16 @@
+import type { NetworkEvent } from "../types";
+import type { OverrideRule } from "./types";
+/**
+ * Which captured requests belong in the list's OVERRIDDEN strip.
+ *
+ * A row belongs there when an active rule actually changed it (it carries the
+ * rule's override mark) or matched it after the rule existed (while overrides
+ * are paused those pass through, and the strip is how you find the rule again).
+ * Before a rule existed nothing overrode anything, so older matching requests
+ * are real server responses and stay in the list, with one exception: the
+ * newest of them, which is the request the rule was built from. That one hoists
+ * right away, so creating a rule shows where it points without waiting for the
+ * endpoint to be called again.
+ */
+export declare function overriddenEvents(events: NetworkEvent[], activeRules: OverrideRule[]): NetworkEvent[];
+//# sourceMappingURL=overriddenRows.d.ts.map

package/lib/typescript/network/overrides/resolveOverride.d.ts

@@ -28,7 +28,7 @@ export declare function shouldApply(rule: OverrideRule): boolean;
  * its phase on the requests it deliberately skips — the caller needs the rule
  * back even when the answer is "not this time".
  */
-export declare function findMatchingRule(url: string, method: string, rules: readonly OverrideRule[]): OverrideRule | null;
+export declare function findMatchingRule(url: string, method: string, rules: readonly OverrideRule[], headers?: Record<string, string>): OverrideRule | null;
 /**
  * First ENABLED matching rule wins outright — no merging across rules.
  *
@@ -41,6 +41,6 @@ export declare function findMatchingRule(url: string, method: string, rules: rea
  * @param method HTTP method as the caller sent it (case-insensitive).
  * @param rules  Ordered rule list; earlier entries win.
  */
-export declare function resolveOverride(url: string, method: string, rules: readonly OverrideRule[]): OverrideOutcome | null;
+export declare function resolveOverride(url: string, method: string, rules: readonly OverrideRule[], headers?: Record<string, string>): OverrideOutcome | null;
 export { toOutcome };
 //# sourceMappingURL=resolveOverride.d.ts.map

package/lib/typescript/network/overrides/types.d.ts

@@ -72,6 +72,15 @@ export interface OverrideRule {
     urlPattern: string;
     /** Uppercase methods. Absent or empty means "any method". */
     methods?: string[];
+    /**
+     * Only requests that SEND this header (name, case-insensitive). Absent
+     * means any request.
+     *
+     * For failures aimed at an authenticated call: the Clock tool's "fail the
+     * next request" sets `authorization`, so the 401 lands on a request that
+     * carried the token and never on the app's own token request.
+     */
+    requireHeader?: string;
     kind: OverrideRuleKind;
     /** `respond` only. Clamped to [STATUS_MIN, STATUS_MAX]. Defaults to 200. */
     status?: number;

package/lib/typescript/network/utils/networkListener.d.ts

@@ -6,7 +6,7 @@ import { type NetworkConditionStamp } from "../conditions/store";
 import type { NetworkTimings } from "../types";
 import { type NetworkOverrideMark } from "../overrides/types";
 export interface NetworkingEvent {
-    type: "request" | "response" | "error";
+    type: "request" | "request-body" | "response" | "error";
     timestamp: Date;
     /** Total: request start → body fully received. */
     duration?: number;
@@ -52,7 +52,6 @@ export declare const BUOY_XHR_INTERCEPTOR_FLAG = "__buoyNetworkXhrIntercepted";
 declare class NetworkListener {
     private listeners;
     private isListening;
-    private requestCounter;
     private originalFetch;
     private originalXHROpen;
     private originalXHRSend;
@@ -164,6 +163,17 @@ declare class NetworkListener {
      * effectively disabling network monitoring.
      */
     stopListening(): void;
+    /**
+     * Take over the requests `@buoy-gg/core/web/register` recorded before this
+     * listener existed, so the page's startup traffic shows up. Finished requests
+     * are emitted now, with their real start time and duration. Requests still
+     * in flight are emitted when they finish. The recorder stops recording on
+     * the first call, so each request is reported once. See
+     * core/src/earlyNetwork.ts for the record shapes.
+     */
+    adoptEarlyRequests(): void;
+    private adoptEarlyFetch;
+    private adoptEarlyXhr;
     /**
      * Add a listener for network events
      *
@@ -194,7 +204,7 @@ export declare const startNetworkListener: () => void;
 /**
  * Stop network traffic monitoring
  */
-export declare const stopNetworkListener: () => void;
+export declare const stopNetworkListener: () => void | undefined;
 /**
  * Add a listener for network events
  *
@@ -215,7 +225,7 @@ export declare const addNetworkListener: (listener: NetworkingEventListener) =>
 /**
  * Remove all registered network event listeners
  */
-export declare const removeAllNetworkListeners: () => void;
+export declare const removeAllNetworkListeners: () => void | undefined;
 /**
  * Check if network monitoring is currently active
  *

package/lib/typescript/network/utils/networkSavedStore.d.ts

@@ -13,10 +13,10 @@
  * A record exists while either flag is true and is dropped when both go false,
  * so all four states fall out without special cases.
  *
- * IDENTITY WARNING: `networkListener` mints request IDs from a per-runtime
- * counter (`fetch_1`, `xhr_2`), so after an app reload `fetch_1` is a
- * DIFFERENT request. Records are therefore keyed on a generated `key`, carry
- * the `sessionId` that captured them, and only trust `liveId` while that
+ * Request IDs include a runtime session and a counter. Saved records also
+ * track their owning session because live rows disappear on app reload.
+ * Records use a generated `key`, carry the `sessionId` that captured them,
+ * and only trust `liveId` while that
  * session is the current one. Snapshots restored from an earlier session get
  * their event `id` rewritten to `saved:<key>` so a restored pin can never
  * resolve to (or dedupe against) an unrelated live request.

package/lib/typescript/network/utils/realNow.d.ts

@@ -0,0 +1,18 @@
+/**
+ * The device's real clock.
+ *
+ * @buoy-gg/clock can override the APP's clock (Date.now, new Date). Buoy's
+ * own bookkeeping must keep real time regardless: license expiry, sync
+ * throttles and request deadlines would otherwise lock tools or stall when
+ * someone travels a month ahead. The clock package publishes the real clock
+ * on `globalThis.__buoyRealNow`; without it, Date.now is already real.
+ */
+export declare function realNow(): number;
+/**
+ * setTimeout that a clock jump never fires early. @buoy-gg/clock tracks the
+ * app's timers so a jump ahead can run the ones that come due; Buoy's own
+ * deadlines and heartbeats must not be among them.
+ */
+export declare function realSetTimeout(callback: () => void, ms: number): ReturnType<typeof setTimeout>;
+export declare function realClearTimeout(handle: unknown): void;
+//# sourceMappingURL=realNow.d.ts.map

package/lib/typescript/network/utils/requestId.d.ts

@@ -0,0 +1,2 @@
+export declare function nextRequestId(client: "fetch" | "xhr"): string;
+//# sourceMappingURL=requestId.d.ts.map

package/lib/typescript/network/utils/resolveRequestUrl.d.ts

@@ -0,0 +1,3 @@
+/** Resolve browser-relative URLs for capture without changing the request arguments. */
+export declare function resolveRequestUrl(url: string): string;
+//# sourceMappingURL=resolveRequestUrl.d.ts.map

package/lib/typescript/network/utils/startNetworkCapture.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Keep local capture active while the Network panel is closed.
+ * Call in the app being inspected and dispose during unmount or HMR cleanup.
+ */
+export declare function startNetworkCapture(): () => void;
+//# sourceMappingURL=startNetworkCapture.d.ts.map