@buoy-gg/network 7.0.40 → 7.0.42

package/lib/commonjs/network/sync/networkSyncAdapter.js

@@ -1,882 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.networkSyncAdapter = exports.SNAPSHOT_HEADER_VALUE_LIMIT = exports.SNAPSHOT_EVENTS_BUDGET = exports.SNAPSHOT_BODY_INLINE_LIMIT = void 0;
-var _store = require("../conditions/store");
-var _networkEventStore = require("../utils/networkEventStore");
-var _networkSavedStore = require("../utils/networkSavedStore");
-var _overrideRulesStore = require("../overrides/overrideRulesStore");
-var _presets = require("../overrides/presets");
-var _engine = require("../overrides/engine");
-var _networkListener = require("../utils/networkListener");
-var _sharedUi = require("@buoy-gg/shared-ui");
-/**
- * Request/response bodies larger than this are NOT streamed in the list
- * snapshot. Prefer the cached size proxy already on the event (free); if that
- * field is missing or wrong (0 for a fat/cyclic body), fall back to an
- * O(limit) walk. Stripped bodies come back via `getEventBody` on detail open.
- */
-const SNAPSHOT_BODY_INLINE_LIMIT = exports.SNAPSHOT_BODY_INLINE_LIMIT = 16 * 1024;
-
-/**
- * Total inline budget for one snapshot's event list, held under the emit
- * layer's 2MB so a snapshot is never DROPPED (a drop leaves the whole panel
- * stale). Per-field caps alone don't get there: 500 requests with 9KB
- * responses are all individually legal and still add up to ~4.7MB. Newest
- * events keep their bodies inline (that's what a developer is looking at);
- * once the budget is spent, older events degrade to metadata + fetch-on-demand.
- */
-const SNAPSHOT_EVENTS_BUDGET = exports.SNAPSHOT_EVENTS_BUDGET = 1.25 * 1024 * 1024;
-function shouldStripBody(data, reportedSize) {
-  if (data === undefined) return false;
-  // The cached size proxy already on the event is free when it's right; the
-  // walk is the fallback for when it's missing or wrong (0 for a fat body).
-  if ((reportedSize ?? 0) > SNAPSHOT_BODY_INLINE_LIMIT) return true;
-  return (0, _sharedUi.isOverWireBudget)(data, SNAPSHOT_BODY_INLINE_LIMIT);
-}
-
-/** One event's wire form plus its measured cost, so the budget pass is free. */
-
-/**
- * Per-event wire cache. `networkEventStore` never mutates an event in place —
- * a response/override update replaces the object — so keying on identity is
- * correct and self-invalidating, and a completed request is converted once
- * instead of on all ~5 snapshots per second for as long as it stays in the
- * list. This is what keeps the guards off the hot path.
- */
-const wireCache = new WeakMap();
-const strippedCache = new WeakMap();
-
-/** Per-field guards: oversized bodies out, heavy headers/variables slimmed. */
-function toWireEvent(event) {
-  const cached = wireCache.get(event);
-  if (cached) return cached;
-  let entry;
-  try {
-    entry = buildWireEvent(event);
-  } catch {
-    // A body with a throwing getter or `toJSON` can blow up the size walk
-    // itself. Degrading this ONE event to metadata beats letting getSnapshot
-    // throw, which would take the whole panel down with it.
-    entry = buildMetadataOnly(event);
-  }
-  wireCache.set(event, entry);
-  return entry;
-}
-function buildMetadataOnly(event) {
-  const stripped = {
-    ...event,
-    requestData: undefined,
-    responseData: undefined,
-    graphqlVariables: undefined,
-    requestBodyOmitted: event.requestData !== undefined ? true : undefined,
-    responseBodyOmitted: event.responseData !== undefined ? true : undefined
-  };
-  // The payload fields are gone, so measuring this is safe even when measuring
-  // the original blew up. Fall back to a nominal cost only if even THIS throws
-  // (a hostile getter on the event itself rather than on its body).
-  let bytes = 1024;
-  try {
-    bytes = (0, _sharedUi.approxJsonSize)(stripped, SNAPSHOT_EVENTS_BUDGET).bytes;
-  } catch {
-    /* keep the nominal estimate */
-  }
-  return {
-    event: stripped,
-    bytes
-  };
-}
-function buildWireEvent(event) {
-  const stripRequest = shouldStripBody(event.requestData, event.requestSize);
-  const stripResponse = shouldStripBody(event.responseData, event.responseSize);
-  const graphqlVariables = toWireGraphqlVariables(event.graphqlVariables);
-  const requestHeaders = toWireHeaders(event.requestHeaders);
-  const responseHeaders = toWireHeaders(event.responseHeaders);
-  const changed = stripRequest || stripResponse || graphqlVariables !== event.graphqlVariables || requestHeaders !== event.requestHeaders || responseHeaders !== event.responseHeaders;
-  let wire = event;
-  if (changed) {
-    // `undefined` keys are omitted by JSON serialization, so dropping the data
-    // shrinks the wire payload. Sizes stay HONEST — the explicit
-    // request/responseBodyOmitted flags are what tell the dashboard to fetch,
-    // matching `OverrideRule.bodyOmitted`. Full values come from `getEventBody`.
-    wire = {
-      ...event
-    };
-    if (stripRequest) {
-      wire.requestData = undefined;
-      wire.requestBodyOmitted = true;
-    }
-    if (stripResponse) {
-      wire.responseData = undefined;
-      wire.responseBodyOmitted = true;
-    }
-    if (graphqlVariables !== event.graphqlVariables) {
-      wire.graphqlVariables = graphqlVariables;
-    }
-    if (requestHeaders !== event.requestHeaders) {
-      wire.requestHeaders = requestHeaders;
-      wire.headersOmitted = true;
-    }
-    if (responseHeaders !== event.responseHeaders) {
-      wire.responseHeaders = responseHeaders;
-      wire.headersOmitted = true;
-    }
-  }
-  return {
-    event: wire,
-    bytes: (0, _sharedUi.approxJsonSize)(wire, SNAPSHOT_EVENTS_BUDGET).bytes
-  };
-}
-
-/**
- * Metadata-only form, used for the tail of the list once the snapshot budget
- * is spent. Method/url/status/timing all stay — only the payloads go.
- */
-function toStrippedEvent(event) {
-  const cached = strippedCache.get(event);
-  if (cached) return cached;
-  const {
-    event: wire
-  } = toWireEvent(event);
-  const stripped = {
-    ...wire
-  };
-  if (stripped.requestData !== undefined) {
-    stripped.requestData = undefined;
-    stripped.requestBodyOmitted = true;
-  }
-  if (stripped.responseData !== undefined) {
-    stripped.responseData = undefined;
-    stripped.responseBodyOmitted = true;
-  }
-  if (stripped.graphqlVariables !== undefined) {
-    stripped.graphqlVariables = toWireGraphqlVariables(stripped.graphqlVariables, /* force */true);
-  }
-  const entry = {
-    event: stripped,
-    bytes: (0, _sharedUi.approxJsonSize)(stripped, SNAPSHOT_EVENTS_BUDGET).bytes
-  };
-  strippedCache.set(event, entry);
-  return entry;
-}
-
-/**
- * Spend the snapshot budget newest-first. The store keeps events newest-first
- * already, so this hands the developer full detail on what they are actually
- * looking at and degrades the tail rather than dropping the whole panel.
- */
-function fitEventsToBudget(events) {
-  const out = new Array(events.length);
-  let spent = 0;
-  for (let i = 0; i < events.length; i++) {
-    const full = toWireEvent(events[i]);
-    if (spent + full.bytes <= SNAPSHOT_EVENTS_BUDGET) {
-      out[i] = full.event;
-      spent += full.bytes;
-    } else {
-      const lean = toStrippedEvent(events[i]);
-      out[i] = lean.event;
-      spent += lean.bytes;
-    }
-  }
-  return out;
-}
-
-/**
- * GraphQL variables are copied off `request.data.variables` onto their own
- * field for the list subtitle (`GetPokemon › Sandshrew`). Capping requestData
- * still left that copy on the wire. Keep short primitives for the subtitle;
- * drop nested/fat values (file uploads, base64). Full variables stay in
- * `requestData` on-device and come back via `getEventBody`.
- */
-function toWireGraphqlVariables(vars, force = false) {
-  if (!vars) return vars;
-  if (!force && !shouldStripBody(vars, undefined)) return vars;
-  const slim = {};
-  for (const [key, value] of Object.entries(vars)) {
-    if (typeof value === "string" && value.length <= 64) slim[key] = value;else if (typeof value === "number" || typeof value === "boolean") {
-      slim[key] = value;
-    }
-  }
-  return Object.keys(slim).length > 0 ? slim : undefined;
-}
-
-/**
- * Header values (Cookie, Authorization, custom JSON) still rode every
- * snapshot after bodies were stripped. 500 events × a 4KB session cookie
- * is a 2MB drop of the whole Network panel. Keep short values inline
- * (content-type, accept); truncate the rest. Full maps stay on-device
- * and come back via `getEventBody`.
- *
- * Returns the SAME object when nothing was truncated: callers use identity to
- * decide whether anything was omitted, so a fresh `{}` here would flag every
- * header-less event as truncated (and defeat the no-copy fast path).
- */
-const SNAPSHOT_HEADER_VALUE_LIMIT = exports.SNAPSHOT_HEADER_VALUE_LIMIT = 64;
-function toWireHeaders(headers) {
-  if (!headers) return headers;
-  let changed = false;
-  const slim = {};
-  for (const [key, value] of Object.entries(headers)) {
-    if (typeof value !== "string") continue;
-    if (value.length <= SNAPSHOT_HEADER_VALUE_LIMIT) {
-      slim[key] = value;
-    } else {
-      slim[key] = `${value.slice(0, SNAPSHOT_HEADER_VALUE_LIMIT)}… [${value.length - SNAPSHOT_HEADER_VALUE_LIMIT} more]`;
-      changed = true;
-    }
-  }
-  return changed ? slim : headers;
-}
-
-/**
- * Drop oversized rule bodies from the snapshot, flagging what was dropped.
- *
- * Same limit and same reasoning as `stripLargeBodies` above — and the same
- * hazard, only worse: an override body is authored once and then rides EVERY
- * snapshot for as long as the rule exists, whereas an event ages out of the
- * list. `draftFromEvent` seeds a rule with the real response, so 500KB is an
- * ordinary size here, not a pathological one.
- */
-const stripLargeRuleBodies = state => {
-  let changed = false;
-  const rules = state.rules.map(rule => {
-    if (!rule.body || rule.body.length <= SNAPSHOT_BODY_INLINE_LIMIT) {
-      return rule;
-    }
-    changed = true;
-    return {
-      ...rule,
-      body: undefined,
-      bodyOmitted: true
-    };
-  });
-  // Identity is preserved when nothing was stripped: the desktop mirror feeds
-  // this straight into a `useEffect` dependency, and a fresh object every
-  // snapshot would re-run it several times a second.
-  return changed ? {
-    ...state,
-    rules
-  } : state;
-};
-const resolveEvent = id => _networkEventStore.networkEventStore.getEventById(id) ?? _networkSavedStore.networkSavedStore.getEventById(id);
-const readId = params => params && typeof params === "object" ? params.id : undefined;
-const readBool = (params, key) => !!(params && typeof params === "object" && params[key]);
-
-/**
- * Stamp an override write receipt with whether the rule can actually fire.
- *
- * Omitted entirely when overrides work, so a dev build's receipts are
- * unchanged and no existing consumer sees a new field it has to reason about.
- * Present only when the answer is "saved, but inert" — which is exactly when a
- * caller relaying success to a person would otherwise be wrong.
- */
-const inactiveStamp = () => (0, _engine.overridesCanApply)() ? {} : {
-  active: false,
-  inactiveReason: _engine.OVERRIDES_INACTIVE_REASON
-};
-const VALID_KINDS = ["respond", "fail", "delay"];
-
-/**
- * Turn an override rule sent over the wire into a draft the store will accept.
- *
- * Validated rather than trusted: these params arrive from the dashboard and
- * from MCP clients, and a malformed rule doesn't just fail — it gets PERSISTED
- * and then re-applied to real traffic on every launch. `urlPattern` is the one
- * field with no sane default, so its absence rejects the whole call.
- */
-function readRuleDraft(params,
-/**
- * Prefill from a captured request, as the UI's Override button does. Any
- * field the caller sent explicitly still wins over it.
- */
-base) {
-  if (!params || typeof params !== "object") return null;
-  const raw = params.rule ?? params;
-  if (!raw || typeof raw !== "object") return null;
-  const rule = raw;
-  const urlPattern = typeof rule.urlPattern === "string" && rule.urlPattern.trim() ? rule.urlPattern.trim() : base?.urlPattern ?? "";
-  if (!urlPattern) return null;
-  const kind = VALID_KINDS.includes(rule.kind) ? rule.kind : base?.kind ?? "respond";
-  return {
-    id: typeof rule.id === "string" ? rule.id : undefined,
-    enabled: rule.enabled !== false,
-    name: typeof rule.name === "string" ? rule.name : base?.name,
-    urlPattern,
-    methods: Array.isArray(rule.methods) ? rule.methods.filter(m => typeof m === "string").map(m => m.toUpperCase()) : base?.methods,
-    kind,
-    status: typeof rule.status === "number" ? rule.status : base?.status,
-    statusText: typeof rule.statusText === "string" ? rule.statusText : base?.statusText,
-    headers: rule.headers && typeof rule.headers === "object" ? rule.headers : base?.headers,
-    // Objects are accepted and serialized so a caller can send JSON directly
-    // instead of pre-stringifying it, which is the mistake everyone makes once.
-    body: patchedBody(rule, base),
-    failKind: rule.failKind === "timeout" ? "timeout" : undefined,
-    delayMs: typeof rule.delayMs === "number" ? rule.delayMs : undefined,
-    times: typeof rule.times === "number" ? rule.times : null,
-    alternate: rule.alternate === true
-  };
-}
-const isPlainObject = v => !!v && typeof v === "object" && !Array.isArray(v);
-/**
- * Objects merge key by key; arrays and primitives are replaced. Collects two
- * dangers instead of writing them: `shrunk` (a non-empty array shorter than
- * the one it replaces) and `breaks` (an array/object field overwritten by null
- * or a primitive — the shape the app renders, changed out from under it). The
- * handler refuses either unless forced.
- *
- * This stays local while the typed-edit RULE is shared: it is the merge itself,
- * not the check, and it reports network-specific dangers the store surfaces do
- * not have. `shapeKind` comes from the shared module so both agree on what
- * counts as an array.
- */
-function deepMerge(base, patch, path = "", issues = {
-  shrunk: [],
-  breaks: []
-}) {
-  if (Array.isArray(base) && Array.isArray(patch)) {
-    if (patch.length > 0 && patch.length < base.length) {
-      issues.shrunk.push({
-        path: path || "(root)",
-        have: base.length,
-        sent: patch.length
-      });
-    }
-    return patch;
-  }
-  if (!isPlainObject(base) || !isPlainObject(patch)) return patch;
-  const out = {
-    ...base
-  };
-  for (const [k, v] of Object.entries(patch)) {
-    const p = path ? `${path}.${k}` : k;
-    if (k in base) {
-      const from = (0, _sharedUi.shapeKind)(base[k]);
-      const to = (0, _sharedUi.shapeKind)(v);
-      if ((from === "array" || from === "object") && from !== to) {
-        issues.breaks.push({
-          path: p,
-          from,
-          to
-        });
-      }
-      out[k] = deepMerge(base[k], v, p, issues);
-    } else {
-      out[k] = v;
-    }
-  }
-  return out;
-}
-
-/** Typed-edit violations a bodyPatch would cause against the seed body, or []. */
-function patchViolations(rule, seed) {
-  if (rule.body != null || !isPlainObject(rule.bodyPatch) || typeof seed !== "string") return [];
-  try {
-    return (0, _sharedUi.typedEditViolations)(JSON.parse(seed), rule.bodyPatch, {
-      noun: "response body"
-    });
-  } catch {
-    return [];
-  }
-}
-
-/**
- * The rule's body: explicit `body` wins, else `bodyPatch` deep-merged into the
- * seeded body (from `fromRequestId`, or the rule being replaced), else the seed.
- *
- * `bodyPatch` exists for the same reason `setQueryData` has `merge`: a remote
- * caller reads the real response through a wire that truncates big payloads,
- * edits one field, and pastes the torn object back as `body`. The app then
- * renders a response missing half its fields. With a patch the caller sends
- * `{ stats: [...] }` and the other 30KB stay exactly as the server sent them.
- */
-function patchedBody(rule, base) {
-  if (typeof rule.body === "string") return rule.body;
-  if (rule.body != null) return JSON.stringify(rule.body, null, 2);
-  const seed = base?.body ?? (typeof rule.id === "string" ? _overrideRulesStore.overrideRulesStore.getState().rules.find(r => r.id === rule.id)?.body : undefined);
-  if (isPlainObject(rule.bodyPatch) && typeof seed === "string") {
-    try {
-      return JSON.stringify(deepMerge(JSON.parse(seed), rule.bodyPatch), null, 2);
-    } catch {
-      return seed;
-    }
-  }
-  return seed;
-}
-
-/**
- * Replacing a rule by id inherits every field the caller did not send, so a
- * remote driver can flip one thing — `{ id, bodyPatch }`, `{ id, status: 500 }`
- * — without re-sending the urlPattern it never had to know.
- */
-function existingRule(params) {
-  if (!params || typeof params !== "object") return null;
-  const raw = params.rule ?? params;
-  if (!raw || typeof raw !== "object") return null;
-  const id = raw.id;
-  if (typeof id !== "string") return null;
-  const existing = _overrideRulesStore.overrideRulesStore.getState().rules.find(r => r.id === id);
-  return existing ? {
-    ...existing
-  } : null;
-}
-
-/**
- * The body a remote surface never received, when it says so.
- *
- * A dashboard editing a rule whose body was stripped from the snapshot has
- * nothing to send back for it. Without this the save would write `body:
- * undefined` and silently destroy the payload — the one field a rule exists for.
- */
-function preservedBody(params) {
-  if (!params || typeof params !== "object") return null;
-  const raw = params.rule ?? params;
-  if (!raw || typeof raw !== "object") return null;
-  const rule = raw;
-  if (rule.bodyOmitted !== true || typeof rule.id !== "string") return null;
-  const existing = _overrideRulesStore.overrideRulesStore.getState().rules.find(candidate => candidate.id === rule.id);
-  return existing ? {
-    body: existing.body
-  } : null;
-}
-
-/**
- * Resolve `fromRequestId` into the same draft the UI's Override button builds.
- *
- * Worth routing through `draftFromEvent` rather than letting a caller paste the
- * URL: it drops the query string to `*`, which is the difference between a rule
- * that fires and one that sits at 0 hits against a cache-busting client.
- */
-function baseFromRequest(params) {
-  if (!params || typeof params !== "object") return null;
-  const id = params.fromRequestId;
-  if (typeof id !== "string" || !id) return null;
-  const event = resolveEvent(id);
-  return event ? (0, _presets.draftFromEvent)(event) : null;
-}
-
-/**
- * Sync adapter for the network tool, consumed by @buoy-gg/external-sync's
- * `useExternalSync` (structurally matches its ToolSyncAdapter interface so
- * this package doesn't need a dependency on it).
- *
- * Subscribing starts the network interceptor, so requests are only captured
- * while a dashboard is watching the network panel — or while an MCP
- * client holds a capture-mode watch (`devtool-watch` with `stream:false`),
- * which records without asking the device to push snapshots.
- *
- * v2: large bodies are stripped from the snapshot and fetched lazily via
- * `getEventBody` (see SNAPSHOT_BODY_INLINE_LIMIT).
- *
- * v3: the payload became an OBJECT — `{ events, saved }` — so pinned/saved
- * requests reach the dashboard. They can't ride as flags on the events: a pin
- * outlives the event that produced it (that is its whole purpose), so it has
- * to be its own list. Dashboards that predate v3 read `payload` as an array;
- * `NetworkPanel`/`NetworkInline` accept either shape.
- */
-const networkSyncAdapter = exports.networkSyncAdapter = {
-  dispose: () => {
-    _overrideRulesStore.overrideRulesStore.setEnabled(false);
-  },
-  // v5: honest request/responseSize + explicit request/responseBodyOmitted
-  // flags, and a total snapshot budget so the list degrades instead of the
-  // whole panel being dropped at the emit layer.
-  version: 6,
-  getSnapshot: () => {
-    // Piggyback the interception health check on the watch loop: while a
-    // dashboard/MCP watch is open this runs continuously, so a clobbered
-    // fetch/XHR patch (see networkListener.startListening) heals within one
-    // snapshot tick instead of staying dead for the session. Two property
-    // reads when healthy.
-    _networkEventStore.networkEventStore.ensureInterception();
-    return {
-      conditions: {
-        version: 1,
-        runtimeId: _store.networkConditionsRuntimeId,
-        profile: (0, _store.getNetworkCondition)(),
-        available: (0, _store.conditionsCanApply)()
-      },
-      events: fitEventsToBudget(_networkEventStore.networkEventStore.getEvents()),
-      /**
-       * Response-override rules live on the DEVICE — that's the only place they
-       * can run, since a rule is applied inside the app's own XMLHttpRequest.
-       * Remote surfaces mirror this and forward their edits back as actions.
-       */
-      overrides: stripLargeRuleBodies(_overrideRulesStore.overrideRulesStore.getState()),
-      // Saved snapshots go through the same body strip. They are few (capped in
-      // the store) but they ride on EVERY snapshot, so a fat one would land in
-      // the same 200ms loop that the body-stripping exists to protect.
-      saved: _networkSavedStore.networkSavedStore.getRecords().map(record => ({
-        ...record,
-        event: toWireEvent(record.event).event
-      }))
-    };
-  },
-  subscribe: onChange => {
-    // Pinning with no traffic in flight still has to reach the dashboard, so
-    // both stores drive the snapshot.
-    const unsubscribeEvents = _networkEventStore.networkEventStore.subscribeToEvents(onChange);
-    const unsubscribeConditions = (0, _store.subscribeNetworkConditions)(onChange);
-    const unsubscribeSaved = _networkSavedStore.networkSavedStore.subscribe(onChange);
-    // Same reasoning for rules: editing one with no traffic in flight must
-    // still reach the dashboard. Subscribing also hydrates the rule list.
-    const unsubscribeOverrides = _overrideRulesStore.overrideRulesStore.subscribe(onChange);
-    return () => {
-      unsubscribeConditions();
-      unsubscribeEvents();
-      unsubscribeSaved();
-      unsubscribeOverrides();
-    };
-  },
-  actions: {
-    getNetworkConditions: () => ({
-      runtimeId: _store.networkConditionsRuntimeId,
-      profile: (0, _store.getNetworkCondition)(),
-      available: (0, _store.conditionsCanApply)()
-    }),
-    setNetworkConditions: params => {
-      const profile = params && typeof params === "object" ? params.profile : undefined;
-      return {
-        runtimeId: _store.networkConditionsRuntimeId,
-        profile: (0, _store.setNetworkCondition)(profile),
-        available: (0, _store.conditionsCanApply)()
-      };
-    },
-    clearEvents: () => {
-      _networkEventStore.networkEventStore.clearEvents();
-    },
-    /**
-     * Return the full (un-stripped) request/response bodies for one event,
-     * fetched on demand by the dashboard when its detail view opens. Falls
-     * back to the saved store, which may hold the only remaining copy of a
-     * request that has since been cleared. Returns null if neither has it.
-     */
-    getEventBody: params => {
-      const id = readId(params);
-      if (!id) return null;
-      const event = resolveEvent(id);
-      if (!event) return null;
-      return {
-        // Identity + the override mark ride along so a caller (Ask Buoy's
-        // receipt, an MCP session) can say WHOSE body this is and whether an
-        // override rule produced it — a mocked response rendered as "live"
-        // is the fabrication problem wearing a chrome suit.
-        url: event.url ?? null,
-        method: event.method ?? null,
-        status: event.status ?? null,
-        override: event.override ?? null,
-        requestData: event.requestData ?? null,
-        responseData: event.responseData ?? null,
-        requestHeaders: event.requestHeaders ?? null,
-        responseHeaders: event.responseHeaders ?? null
-      };
-    },
-    /** Pin/unpin a request from the dashboard. */
-    setPinned: params => {
-      const id = readId(params);
-      if (!id) return null;
-      const event = resolveEvent(id);
-      if (!event) return null;
-      const wanted = readBool(params, "pinned");
-      // `flagsForEventId`, not `isPinned` — the id may be a `saved:<key>`
-      // snapshot, which the live-id Sets deliberately don't carry.
-      const current = (0, _networkSavedStore.flagsForEventId)(_networkSavedStore.networkSavedStore.getState(), id).pinned;
-      if (current === wanted) return {
-        ok: true
-      };
-      return _networkSavedStore.networkSavedStore.togglePin(event);
-    },
-    /** Save/unsave a request from the dashboard. */
-    setSaved: params => {
-      const id = readId(params);
-      if (!id) return null;
-      const event = resolveEvent(id);
-      if (!event) return null;
-      const wanted = readBool(params, "saved");
-      const current = (0, _networkSavedStore.flagsForEventId)(_networkSavedStore.networkSavedStore.getState(), id).saved;
-      if (current === wanted) return {
-        ok: true
-      };
-      return _networkSavedStore.networkSavedStore.toggleSave(event);
-    },
-    /** Drop one pinned/saved record by its stable key. */
-    removeSavedRecord: params => {
-      const key = params && typeof params === "object" ? params.key : undefined;
-      if (!key) return null;
-      _networkSavedStore.networkSavedStore.remove(key);
-      return {
-        ok: true
-      };
-    },
-    clearSavedRequests: () => {
-      _networkSavedStore.networkSavedStore.clearSaved();
-      return {
-        ok: true
-      };
-    },
-    clearPinnedRequests: () => {
-      _networkSavedStore.networkSavedStore.clearPinned();
-      return {
-        ok: true
-      };
-    },
-    // =========================================================================
-    // RESPONSE OVERRIDES
-    // =========================================================================
-
-    /** Master switch — turns every rule off without losing any of them. */
-    setOverridesEnabled: params => {
-      _overrideRulesStore.overrideRulesStore.setEnabled(readBool(params, "enabled"));
-      return {
-        ok: true,
-        enabled: _overrideRulesStore.overrideRulesStore.getState().enabled,
-        // `active` is the difference between "we saved it" and "it is doing
-        // something". A remote driver reads this and tells the user the truth.
-        ...inactiveStamp()
-      };
-    },
-    /** Create a rule, or replace one by id. */
-    upsertOverrideRule: params => {
-      const base = baseFromRequest(params) ?? preservedBody(params) ?? existingRule(params);
-      const rawRule = params?.rule ?? params;
-      // `bodyPath` + `bodyValue` are sugar over `bodyPatch`, resolved against the
-      // real response before anything else looks at the rule — so the keyed
-      // expansion, the typed-edit guard and the merge below all run on an
-      // ordinary patch and gain no special cases. This is the same form the
-      // state tools take; it exists here because a response body is the surface
-      // where the caller is LEAST likely to have seen the shape (it read the
-      // body over a wire that truncates at 24,000 characters), and therefore
-      // most likely to get the nesting wrong.
-      if (rawRule && typeof rawRule.bodyPath === "string" && rawRule.body == null) {
-        const seed = base?.body ?? (typeof rawRule.id === "string" ? _overrideRulesStore.overrideRulesStore.getState().rules.find(r => r.id === rawRule.id)?.body : undefined);
-        if (typeof seed !== "string") {
-          return {
-            ok: false,
-            error: "bodyPath needs something to patch: send fromRequestId (the captured request whose real response it addresses) or the id of an existing rule."
-          };
-        }
-        if (rawRule.bodyValue === undefined) {
-          return {
-            ok: false,
-            error: `Refused: sent \`bodyPath\` without \`bodyValue\`. Say what to set "${rawRule.bodyPath}" to.`
-          };
-        }
-        let parsed;
-        try {
-          parsed = JSON.parse(seed);
-        } catch {
-          return {
-            ok: false,
-            error: "The captured response body is not JSON, so it cannot be addressed by path. Send a whole `body` instead."
-          };
-        }
-        const built = (0, _sharedUi.patchFromPath)(parsed, rawRule.bodyPath, rawRule.bodyValue);
-        if (!built.ok) return {
-          ok: false,
-          error: `Refused: ${built.error}`
-        };
-        rawRule.bodyPatch = built.patch;
-        delete rawRule.bodyPath;
-        delete rawRule.bodyValue;
-      }
-      if (rawRule && isPlainObject(rawRule.bodyPatch) && rawRule.body == null) {
-        const seed = base?.body ?? (typeof rawRule.id === "string" ? _overrideRulesStore.overrideRulesStore.getState().rules.find(r => r.id === rawRule.id)?.body : undefined);
-        if (typeof seed !== "string") {
-          return {
-            ok: false,
-            error: "bodyPatch needs something to patch: send fromRequestId (the captured request whose real response the patch is merged into) or the id of an existing rule."
-          };
-        }
-        if (rawRule.force !== true) {
-          // Address list items in the real response by their own id rather than
-          // resending the array: {results:{pikachu:{name:"test123"}}}. Expanded
-          // against the seed BEFORE the guard and before the merge, so the
-          // typed-edit rule still holds over the result. This is the only form
-          // that is correct when the caller read the response through a wire
-          // that truncated it — see packages/shared/src/sync/keyedArrays.ts.
-          let keyedError;
-          try {
-            const expanded = (0, _sharedUi.expandKeyedArrays)(JSON.parse(seed), rawRule.bodyPatch);
-            keyedError = expanded.error;
-            if (expanded.notes.length) rawRule.bodyPatch = expanded.patch;
-          } catch {
-            /* a non-JSON seed has no lists to address; leave the patch alone */
-          }
-          // See keyedArrays.ts: an added item whose id disagrees with the key
-          // it was sent under is ambiguous, and only this layer can say so.
-          if (keyedError) {
-            return {
-              ok: false,
-              error: `Refused: ${keyedError}`
-            };
-          }
-          const violations = patchViolations(rawRule, seed);
-          if (violations.length > 0) {
-            return {
-              ok: false,
-              error: (0, _sharedUi.refusalText)(violations, "response body", (0, _sharedUi.suggestedPatch)(rawRule.bodyPatch, violations)),
-              violations
-            };
-          }
-        }
-      }
-      const draft = readRuleDraft(params, base);
-      if (!draft) {
-        const wanted = params?.fromRequestId;
-        return {
-          ok: false,
-          error: wanted ? `No captured request \`${wanted}\` — it may have been cleared. Send a urlPattern instead.` : "A rule needs a non-empty urlPattern."
-        };
-      }
-      const rule = _overrideRulesStore.overrideRulesStore.upsertRule(draft);
-      if (!rule) return {
-        ok: false,
-        error: "Override rule limit reached."
-      };
-      // A rule pushed from a remote surface is meant to take effect now;
-      // leaving it dark under an OFF master switch reads as a silent failure.
-      if (rule.enabled) _overrideRulesStore.overrideRulesStore.setEnabled(true);
-      // A RECEIPT, not the rule. `fromRequestId` seeds the real response as the
-      // body, so echoing the whole rule sent 380KB back down the socket for a
-      // Pokémon payload — and no caller reads it: the desktop mirror gets the
-      // rule from the next snapshot, and MCP only needs the id to report and
-      // remove it.
-      return {
-        ok: true,
-        rule: {
-          id: rule.id,
-          urlPattern: rule.urlPattern,
-          enabled: rule.enabled,
-          kind: rule.kind,
-          status: rule.status,
-          times: rule.times,
-          bodySize: rule.body ? rule.body.length : 0
-        },
-        // A rule with no budget overrides EVERY matching request until someone
-        // deletes it, and that is rarely what a one-off ask meant. Measured on
-        // `api-sim/next-call-fails-once` ("just the next one, then let it work
-        // again"): ten of fourteen attempts left the budget off and got a rule
-        // that never expires. Saying so is not a nag — it is the difference
-        // between a caller that adds `times` on its next turn and one that walks
-        // away leaving the app permanently broken.
-        ...(rule.times === undefined || rule.times === null ? {
-          lingers: `This rule has no \`times\` budget, so it overrides EVERY matching request until it is disabled or deleted (id \`${rule.id}\`). If you meant only the next one, set times:1.`
-        } : {}),
-        ...inactiveStamp()
-      };
-    },
-    setOverrideRuleEnabled: params => {
-      const id = readId(params);
-      if (!id) return {
-        ok: false,
-        error: "Missing rule id."
-      };
-      _overrideRulesStore.overrideRulesStore.setRuleEnabled(id, readBool(params, "enabled"));
-      return {
-        ok: true,
-        ...inactiveStamp()
-      };
-    },
-    deleteOverrideRule: params => {
-      const id = readId(params);
-      if (!id) return {
-        ok: false,
-        error: "Missing rule id."
-      };
-      _overrideRulesStore.overrideRulesStore.removeRule(id);
-      return {
-        ok: true
-      };
-    },
-    clearOverrideRules: () => {
-      _overrideRulesStore.overrideRulesStore.clearRules();
-      return {
-        ok: true
-      };
-    },
-    /** Read the rules back — hit counts included, which the snapshot coalesces. */
-    listOverrideRules: () => _overrideRulesStore.overrideRulesStore.getState(),
-    /**
-     * The full body of one rule, for the surfaces the snapshot withheld it from
-     * (see `stripLargeRuleBodies`). Fetched when the user opens the rule, which
-     * is the only moment it's needed.
-     */
-    getOverrideRuleBody: params => {
-      const id = readId(params);
-      if (!id) return null;
-      // `getState().rules`, not `getRules()` — the latter reports nothing while
-      // the master switch is off, and a rule is perfectly editable then.
-      const rule = _overrideRulesStore.overrideRulesStore.getState().rules.find(candidate => candidate.id === id);
-      if (!rule) return null;
-      return {
-        body: rule.body ?? null
-      };
-    },
-    /** Why isn't my rule firing? Reports the engine's own view of the world. */
-    /**
-     * Is the device actually recording right now, and why not?
-     *
-     * The honest answer to an empty request list. Without this a caller can
-     * only guess, and the plausible guesses ("interception is broken on this
-     * runtime") are all wrong — the usual answer is simply that nothing is
-     * holding capture open.
-     */
-    getCaptureStatus: () => {
-      // RECORDING is what the caller actually wants to know, and it is driven
-      // by the store's subscriber count — not by whether the interceptor is
-      // installed. Those genuinely differ: an enabled override rule pins the
-      // interceptor (`overrideRulesStore.syncKeepAlive`) without anything
-      // writing to the event store, so reporting `isNetworkListening()` as
-      // "capturing" would answer "yes" to a device recording nothing. That is
-      // the same species of misleading answer this action exists to replace.
-      const subscribers = _networkEventStore.networkEventStore.getSubscriberCounts().total;
-
-      // `isNetworkListening()` lazily CONSTRUCTS the listener, which reaches
-      // for XMLHttpRequest — absent in Node and in any headless host. A
-      // diagnostic that throws is worse than no diagnostic, so probe
-      // defensively and report what we do know either way.
-      let interceptorInstalled = null;
-      let listenerCount = null;
-      try {
-        interceptorInstalled = (0, _networkListener.isNetworkListening)();
-        listenerCount = (0, _networkListener.getNetworkListenerCount)();
-      } catch {
-        /* no interceptable runtime here */
-      }
-      // `interceptorInstalled` is the listener's own flag; `interceptorLive`
-      // is whether the interceptors are actually reachable through the global
-      // chain. installed:true + live:false = something re-assigned fetch/XHR
-      // over the interceptor (it self-heals on the next subscribe/snapshot —
-      // see ensureInterception).
-      let interceptorLive = null;
-      try {
-        interceptorLive = (0, _networkListener.isNetworkInterceptionLive)();
-      } catch {
-        /* no interceptable runtime here */
-      }
-      return {
-        capturing: subscribers > 0,
-        subscribers,
-        interceptorInstalled,
-        interceptorLive,
-        listenerCount,
-        eventCount: _networkEventStore.networkEventStore.getEvents().length
-      };
-    },
-    debugOverrides: params => {
-      const url = (params && typeof params === "object" ? params.url : undefined) ?? "https://example.com/";
-      return {
-        interceptorInstalled: (0, _networkListener.isNetworkListening)(),
-        listenerCount: (0, _networkListener.getNetworkListenerCount)(),
-        engine: (0, _engine.inspectEngine)(url, "GET"),
-        store: {
-          enabled: _overrideRulesStore.overrideRulesStore.getState().enabled,
-          ruleCount: _overrideRulesStore.overrideRulesStore.getState().rules.length,
-          rulesVisibleToEngine: _overrideRulesStore.overrideRulesStore.getRules().length
-        }
-      };
-    }
-  }
-};
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.networkSyncAdapter=exports.SNAPSHOT_HEADER_VALUE_LIMIT=exports.SNAPSHOT_EVENTS_BUDGET=exports.SNAPSHOT_BODY_INLINE_LIMIT=void 0;var _store=require("../conditions/store");var _networkEventStore=require("../utils/networkEventStore");var _networkSavedStore=require("../utils/networkSavedStore");var _overrideRulesStore=require("../overrides/overrideRulesStore");var _presets=require("../overrides/presets");var _engine=require("../overrides/engine");var _networkListener=require("../utils/networkListener");var _sharedUi=require("@buoy-gg/shared-ui");const SNAPSHOT_BODY_INLINE_LIMIT=exports.SNAPSHOT_BODY_INLINE_LIMIT=16*1024;const SNAPSHOT_EVENTS_BUDGET=exports.SNAPSHOT_EVENTS_BUDGET=1.25*1024*1024;function shouldStripBody(e,t){if(e===void 0)return false;if((t??0)>SNAPSHOT_BODY_INLINE_LIMIT)return true;return(0,_sharedUi.isOverWireBudget)(e,SNAPSHOT_BODY_INLINE_LIMIT)}const wireCache=new WeakMap;const strippedCache=new WeakMap;function toWireEvent(e){const t=wireCache.get(e);if(t)return t;let r;try{r=buildWireEvent(e)}catch{r=buildMetadataOnly(e)}wireCache.set(e,r);return r}function buildMetadataOnly(e){const t={...e,requestData:void 0,responseData:void 0,graphqlVariables:void 0,requestBodyOmitted:e.requestData!==void 0?true:void 0,responseBodyOmitted:e.responseData!==void 0?true:void 0};let r=1024;try{r=(0,_sharedUi.approxJsonSize)(t,SNAPSHOT_EVENTS_BUDGET).bytes}catch{}return{event:t,bytes:r}}function buildWireEvent(e){const t=shouldStripBody(e.requestData,e.requestSize);const r=shouldStripBody(e.responseData,e.responseSize);const n=toWireGraphqlVariables(e.graphqlVariables);const o=toWireHeaders(e.requestHeaders);const s=toWireHeaders(e.responseHeaders);const d=t||r||n!==e.graphqlVariables||o!==e.requestHeaders||s!==e.responseHeaders;let i=e;if(d){i={...e};if(t){i.requestData=void 0;i.requestBodyOmitted=true}if(r){i.responseData=void 0;i.responseBodyOmitted=true}if(n!==e.graphqlVariables){i.graphqlVariables=n}if(o!==e.requestHeaders){i.requestHeaders=o;i.headersOmitted=true}if(s!==e.responseHeaders){i.responseHeaders=s;i.headersOmitted=true}}return{event:i,bytes:(0,_sharedUi.approxJsonSize)(i,SNAPSHOT_EVENTS_BUDGET).bytes}}function toStrippedEvent(e){const t=strippedCache.get(e);if(t)return t;const{event:r}=toWireEvent(e);const n={...r};if(n.requestData!==void 0){n.requestData=void 0;n.requestBodyOmitted=true}if(n.responseData!==void 0){n.responseData=void 0;n.responseBodyOmitted=true}if(n.graphqlVariables!==void 0){n.graphqlVariables=toWireGraphqlVariables(n.graphqlVariables,true)}const o={event:n,bytes:(0,_sharedUi.approxJsonSize)(n,SNAPSHOT_EVENTS_BUDGET).bytes};strippedCache.set(e,o);return o}function fitEventsToBudget(e){const t=new Array(e.length);let r=0;for(let n=0;n<e.length;n++){const o=toWireEvent(e[n]);if(r+o.bytes<=SNAPSHOT_EVENTS_BUDGET){t[n]=o.event;r+=o.bytes}else{const s=toStrippedEvent(e[n]);t[n]=s.event;r+=s.bytes}}return t}function toWireGraphqlVariables(e,t=false){if(!e)return e;if(!t&&!shouldStripBody(e,void 0))return e;const r={};for(const[n,o]of Object.entries(e)){if(typeof o==="string"&&o.length<=64)r[n]=o;else if(typeof o==="number"||typeof o==="boolean"){r[n]=o}}return Object.keys(r).length>0?r:void 0}const SNAPSHOT_HEADER_VALUE_LIMIT=exports.SNAPSHOT_HEADER_VALUE_LIMIT=64;function toWireHeaders(e){if(!e)return e;let t=false;const r={};for(const[n,o]of Object.entries(e)){if(typeof o!=="string")continue;if(o.length<=SNAPSHOT_HEADER_VALUE_LIMIT){r[n]=o}else{r[n]=`${o.slice(0,SNAPSHOT_HEADER_VALUE_LIMIT)}\u2026 [${o.length-SNAPSHOT_HEADER_VALUE_LIMIT} more]`;t=true}}return t?r:e}const stripLargeRuleBodies=e=>{let t=false;const r=e.rules.map(n=>{if(!n.body||n.body.length<=SNAPSHOT_BODY_INLINE_LIMIT){return n}t=true;return{...n,body:void 0,bodyOmitted:true}});return t?{...e,rules:r}:e};const resolveEvent=e=>_networkEventStore.networkEventStore.getEventById(e)??_networkSavedStore.networkSavedStore.getEventById(e);const readId=e=>e&&typeof e==="object"?e.id:void 0;const readBool=(e,t)=>!!(e&&typeof e==="object"&&e[t]);const inactiveStamp=()=>(0,_engine.overridesCanApply)()?{}:{active:false,inactiveReason:_engine.OVERRIDES_INACTIVE_REASON};const VALID_KINDS=["respond","fail","delay"];function readRuleDraft(e,t){if(!e||typeof e!=="object")return null;const r=e.rule??e;if(!r||typeof r!=="object")return null;const n=r;const o=typeof n.urlPattern==="string"&&n.urlPattern.trim()?n.urlPattern.trim():t?.urlPattern??"";if(!o)return null;const s=VALID_KINDS.includes(n.kind)?n.kind:t?.kind??"respond";return{id:typeof n.id==="string"?n.id:void 0,enabled:n.enabled!==false,name:typeof n.name==="string"?n.name:t?.name,urlPattern:o,methods:Array.isArray(n.methods)?n.methods.filter(d=>typeof d==="string").map(d=>d.toUpperCase()):t?.methods,requireHeader:typeof n.requireHeader==="string"&&n.requireHeader.trim()?n.requireHeader.trim():void 0,kind:s,status:typeof n.status==="number"?n.status:t?.status,statusText:typeof n.statusText==="string"?n.statusText:t?.statusText,headers:n.headers&&typeof n.headers==="object"?n.headers:t?.headers,body:patchedBody(n,t),failKind:n.failKind==="timeout"?"timeout":void 0,delayMs:typeof n.delayMs==="number"?n.delayMs:void 0,times:typeof n.times==="number"?n.times:null,alternate:n.alternate===true}}const isPlainObject=e=>!!e&&typeof e==="object"&&!Array.isArray(e);function deepMerge(e,t,r="",n={shrunk:[],breaks:[]}){if(Array.isArray(e)&&Array.isArray(t)){if(t.length>0&&t.length<e.length){n.shrunk.push({path:r||"(root)",have:e.length,sent:t.length})}return t}if(!isPlainObject(e)||!isPlainObject(t))return t;const o={...e};for(const[s,d]of Object.entries(t)){const i=r?`${r}.${s}`:s;if(s in e){const u=(0,_sharedUi.shapeKind)(e[s]);const l=(0,_sharedUi.shapeKind)(d);if((u==="array"||u==="object")&&u!==l){n.breaks.push({path:i,from:u,to:l})}o[s]=deepMerge(e[s],d,i,n)}else{o[s]=d}}return o}function patchViolations(e,t){if(e.body!=null||!isPlainObject(e.bodyPatch)||typeof t!=="string")return[];try{return(0,_sharedUi.typedEditViolations)(JSON.parse(t),e.bodyPatch,{noun:"response body"})}catch{return[]}}function patchedBody(e,t){if(typeof e.body==="string")return e.body;if(e.body!=null)return JSON.stringify(e.body,null,2);const r=t?.body??(typeof e.id==="string"?_overrideRulesStore.overrideRulesStore.getState().rules.find(n=>n.id===e.id)?.body:void 0);if(isPlainObject(e.bodyPatch)&&typeof r==="string"){try{return JSON.stringify(deepMerge(JSON.parse(r),e.bodyPatch),null,2)}catch{return r}}return r}function existingRule(e){if(!e||typeof e!=="object")return null;const t=e.rule??e;if(!t||typeof t!=="object")return null;const r=t.id;if(typeof r!=="string")return null;const n=_overrideRulesStore.overrideRulesStore.getState().rules.find(o=>o.id===r);return n?{...n}:null}function preservedBody(e){if(!e||typeof e!=="object")return null;const t=e.rule??e;if(!t||typeof t!=="object")return null;const r=t;if(r.bodyOmitted!==true||typeof r.id!=="string")return null;const n=_overrideRulesStore.overrideRulesStore.getState().rules.find(o=>o.id===r.id);return n?{body:n.body}:null}function baseFromRequest(e){if(!e||typeof e!=="object")return null;const t=e.fromRequestId;if(typeof t!=="string"||!t)return null;const r=resolveEvent(t);return r?(0,_presets.draftFromEvent)(r):null}const networkSyncAdapter=exports.networkSyncAdapter={dispose:()=>{_overrideRulesStore.overrideRulesStore.setEnabled(false)},version:6,getSnapshot:()=>{_networkEventStore.networkEventStore.ensureInterception();return{conditions:{version:1,runtimeId:_store.networkConditionsRuntimeId,profile:(0,_store.getNetworkCondition)(),available:(0,_store.conditionsCanApply)()},events:fitEventsToBudget(_networkEventStore.networkEventStore.getEvents()),overrides:stripLargeRuleBodies(_overrideRulesStore.overrideRulesStore.getState()),saved:_networkSavedStore.networkSavedStore.getRecords().map(e=>({...e,event:toWireEvent(e.event).event}))}},subscribe:e=>{const t=_networkEventStore.networkEventStore.subscribeToEvents(e);const r=(0,_store.subscribeNetworkConditions)(e);const n=_networkSavedStore.networkSavedStore.subscribe(e);const o=_overrideRulesStore.overrideRulesStore.subscribe(e);return()=>{r();t();n();o()}},actions:{getNetworkConditions:()=>({runtimeId:_store.networkConditionsRuntimeId,profile:(0,_store.getNetworkCondition)(),available:(0,_store.conditionsCanApply)()}),setNetworkConditions:e=>{const t=e&&typeof e==="object"?e.profile:void 0;return{runtimeId:_store.networkConditionsRuntimeId,profile:(0,_store.setNetworkCondition)(t),available:(0,_store.conditionsCanApply)()}},clearEvents:()=>{_networkEventStore.networkEventStore.clearEvents()},getEventBody:e=>{const t=readId(e);if(!t)return null;const r=resolveEvent(t);if(!r)return null;return{url:r.url??null,method:r.method??null,status:r.status??null,override:r.override??null,requestData:r.requestData??null,responseData:r.responseData??null,requestHeaders:r.requestHeaders??null,responseHeaders:r.responseHeaders??null}},setPinned:e=>{const t=readId(e);if(!t)return null;const r=resolveEvent(t);if(!r)return null;const n=readBool(e,"pinned");const o=(0,_networkSavedStore.flagsForEventId)(_networkSavedStore.networkSavedStore.getState(),t).pinned;if(o===n)return{ok:true};return _networkSavedStore.networkSavedStore.togglePin(r)},setSaved:e=>{const t=readId(e);if(!t)return null;const r=resolveEvent(t);if(!r)return null;const n=readBool(e,"saved");const o=(0,_networkSavedStore.flagsForEventId)(_networkSavedStore.networkSavedStore.getState(),t).saved;if(o===n)return{ok:true};return _networkSavedStore.networkSavedStore.toggleSave(r)},removeSavedRecord:e=>{const t=e&&typeof e==="object"?e.key:void 0;if(!t)return null;_networkSavedStore.networkSavedStore.remove(t);return{ok:true}},clearSavedRequests:()=>{_networkSavedStore.networkSavedStore.clearSaved();return{ok:true}},clearPinnedRequests:()=>{_networkSavedStore.networkSavedStore.clearPinned();return{ok:true}},setOverridesEnabled:e=>{_overrideRulesStore.overrideRulesStore.setEnabled(readBool(e,"enabled"));return{ok:true,enabled:_overrideRulesStore.overrideRulesStore.getState().enabled,...inactiveStamp()}},upsertOverrideRule:e=>{const t=baseFromRequest(e)??preservedBody(e)??existingRule(e);const r=e?.rule??e;if(r&&typeof r.bodyPath==="string"&&r.body==null){const s=t?.body??(typeof r.id==="string"?_overrideRulesStore.overrideRulesStore.getState().rules.find(u=>u.id===r.id)?.body:void 0);if(typeof s!=="string"){return{ok:false,error:"bodyPath needs something to patch: send fromRequestId (the captured request whose real response it addresses) or the id of an existing rule."}}if(r.bodyValue===void 0){return{ok:false,error:`Refused: sent \`bodyPath\` without \`bodyValue\`. Say what to set "${r.bodyPath}" to.`}}let d;try{d=JSON.parse(s)}catch{return{ok:false,error:"The captured response body is not JSON, so it cannot be addressed by path. Send a whole `body` instead."}}const i=(0,_sharedUi.patchFromPath)(d,r.bodyPath,r.bodyValue);if(!i.ok)return{ok:false,error:`Refused: ${i.error}`};r.bodyPatch=i.patch;delete r.bodyPath;delete r.bodyValue}if(r&&isPlainObject(r.bodyPatch)&&r.body==null){const s=t?.body??(typeof r.id==="string"?_overrideRulesStore.overrideRulesStore.getState().rules.find(d=>d.id===r.id)?.body:void 0);if(typeof s!=="string"){return{ok:false,error:"bodyPatch needs something to patch: send fromRequestId (the captured request whose real response the patch is merged into) or the id of an existing rule."}}if(r.force!==true){let d;try{const u=(0,_sharedUi.expandKeyedArrays)(JSON.parse(s),r.bodyPatch);d=u.error;if(u.notes.length)r.bodyPatch=u.patch}catch{}if(d){return{ok:false,error:`Refused: ${d}`}}const i=patchViolations(r,s);if(i.length>0){return{ok:false,error:(0,_sharedUi.refusalText)(i,"response body",(0,_sharedUi.suggestedPatch)(r.bodyPatch,i)),violations:i}}}}const n=readRuleDraft(e,t);if(!n){const s=e?.fromRequestId;return{ok:false,error:s?`No captured request \`${s}\` \u2014 it may have been cleared. Send a urlPattern instead.`:"A rule needs a non-empty urlPattern."}}const o=_overrideRulesStore.overrideRulesStore.upsertRule(n);if(!o)return{ok:false,error:"Override rule limit reached."};if(o.enabled)_overrideRulesStore.overrideRulesStore.setEnabled(true);return{ok:true,rule:{id:o.id,urlPattern:o.urlPattern,enabled:o.enabled,kind:o.kind,status:o.status,times:o.times,bodySize:o.body?o.body.length:0},...o.times===void 0||o.times===null?{lingers:`This rule has no \`times\` budget, so it overrides EVERY matching request until it is disabled or deleted (id \`${o.id}\`). If you meant only the next one, set times:1.`}:{},...inactiveStamp()}},setOverrideRuleEnabled:e=>{const t=readId(e);if(!t)return{ok:false,error:"Missing rule id."};_overrideRulesStore.overrideRulesStore.setRuleEnabled(t,readBool(e,"enabled"));return{ok:true,...inactiveStamp()}},deleteOverrideRule:e=>{const t=readId(e);if(!t)return{ok:false,error:"Missing rule id."};_overrideRulesStore.overrideRulesStore.removeRule(t);return{ok:true}},clearOverrideRules:()=>{_overrideRulesStore.overrideRulesStore.clearRules();return{ok:true}},listOverrideRules:()=>_overrideRulesStore.overrideRulesStore.getState(),getOverrideRuleBody:e=>{const t=readId(e);if(!t)return null;const r=_overrideRulesStore.overrideRulesStore.getState().rules.find(n=>n.id===t);if(!r)return null;return{body:r.body??null}},getCaptureStatus:()=>{const e=_networkEventStore.networkEventStore.getSubscriberCounts().total;let t=null;let r=null;try{t=(0,_networkListener.isNetworkListening)();r=(0,_networkListener.getNetworkListenerCount)()}catch{}let n=null;try{n=(0,_networkListener.isNetworkInterceptionLive)()}catch{}return{capturing:e>0,subscribers:e,interceptorInstalled:t,interceptorLive:n,listenerCount:r,eventCount:_networkEventStore.networkEventStore.getEvents().length}},debugOverrides:e=>{const t=(e&&typeof e==="object"?e.url:void 0)??"https://example.com/";return{interceptorInstalled:(0,_networkListener.isNetworkListening)(),listenerCount:(0,_networkListener.getNetworkListenerCount)(),engine:(0,_engine.inspectEngine)(t,"GET"),store:{enabled:_overrideRulesStore.overrideRulesStore.getState().enabled,ruleCount:_overrideRulesStore.overrideRulesStore.getState().rules.length,rulesVisibleToEngine:_overrideRulesStore.overrideRulesStore.getRules().length}}}}};