@vforsh/argus-watcher 0.3.0 → 0.4.0

package/dist/sourcemaps/sourcemapResolver.js

@@ -0,0 +1,152 @@
+import { TraceMap } from '@jridgewell/trace-mapping';
+import { readSourcemapReference } from './sourceMappingUrl.js';
+import { resolveSourcemappedLocationWithMap } from './resolveLocation.js';
+const DEFAULT_MAX_ENTRIES = 128;
+const DEFAULT_NEGATIVE_TTL_MS = 30_000;
+const DEFAULT_TAIL_BYTES = 64 * 1024;
+/**
+ * Build a sourcemap resolver.
+ *
+ * Map locations come from each bundle's own `//# sourceMappingURL=` annotation, never from a
+ * `<script>.map` guess, so query strings, CDN-hosted maps, and inline `data:` maps all work.
+ */
+export const createSourcemapResolver = (options = {}) => {
+    const maxEntries = options.maxEntries ?? DEFAULT_MAX_ENTRIES;
+    const negativeTtlMs = options.negativeTtlMs ?? DEFAULT_NEGATIVE_TTL_MS;
+    const tailBytes = options.tailBytes ?? DEFAULT_TAIL_BYTES;
+    const cache = new Map();
+    const pending = new Map();
+    /** Bumped by `clear()`; in-flight loads started before the bump don't get to populate the cache. */
+    let generation = 0;
+    const clear = () => {
+        generation += 1;
+        cache.clear();
+        pending.clear();
+    };
+    const readCache = (scriptUrl) => {
+        const entry = cache.get(scriptUrl);
+        if (!entry) {
+            return null;
+        }
+        if (entry.expiresAt <= Date.now()) {
+            cache.delete(scriptUrl);
+            return null;
+        }
+        // Re-insert so iteration order stays least-recently-used first.
+        cache.delete(scriptUrl);
+        cache.set(scriptUrl, entry);
+        return entry;
+    };
+    const writeCache = (scriptUrl, traceMap) => {
+        cache.set(scriptUrl, { traceMap, expiresAt: traceMap ? Infinity : Date.now() + negativeTtlMs });
+        while (cache.size > maxEntries) {
+            const oldest = cache.keys().next();
+            if (oldest.done) {
+                break;
+            }
+            cache.delete(oldest.value);
+        }
+    };
+    const getTraceMap = (scriptUrl) => {
+        const cached = readCache(scriptUrl);
+        if (cached) {
+            return Promise.resolve(cached.traceMap);
+        }
+        const inFlight = pending.get(scriptUrl);
+        if (inFlight) {
+            return inFlight;
+        }
+        const startedAt = generation;
+        const promise = loadTraceMap(scriptUrl, tailBytes)
+            .catch(() => null)
+            .then((traceMap) => {
+            if (startedAt === generation) {
+                writeCache(scriptUrl, traceMap);
+            }
+            return traceMap;
+        })
+            .finally(() => {
+            pending.delete(scriptUrl);
+        });
+        pending.set(scriptUrl, promise);
+        return promise;
+    };
+    const resolve = async (location) => {
+        if (!location.file || location.line == null || location.column == null) {
+            return null;
+        }
+        const scriptUrl = normalizeHttpUrl(location.file);
+        if (!scriptUrl) {
+            return null;
+        }
+        const traceMap = await getTraceMap(scriptUrl);
+        if (!traceMap) {
+            return null;
+        }
+        return resolveSourcemappedLocationWithMap(traceMap, { line: location.line, column: location.column });
+    };
+    return { resolve, clear };
+};
+const loadTraceMap = async (scriptUrl, tailBytes) => {
+    const tail = await fetchScript(scriptUrl, tailBytes);
+    if (!tail) {
+        return null;
+    }
+    let reference = readSourcemapReference(tail.text, scriptUrl);
+    if (!reference && tail.partial) {
+        // An inline `data:` map is longer than the tail window, so its annotation starts above it.
+        const full = await fetchScript(scriptUrl, null);
+        reference = full ? readSourcemapReference(full.text, scriptUrl) : null;
+    }
+    if (!reference) {
+        return null;
+    }
+    if (reference.kind === 'inline') {
+        return new TraceMap(reference.map, reference.baseUrl);
+    }
+    const rawMap = await fetchSourcemap(reference.url);
+    if (!rawMap) {
+        return null;
+    }
+    // Base against the map URL, not the script: `sources` are relative to wherever the map lives.
+    return new TraceMap(rawMap, reference.url);
+};
+/**
+ * Fetch a script, asking for only its tail when possible — the annotation is on the last line and
+ * bundles are large. Servers that ignore `Range` answer 200 with the whole body, which is fine.
+ */
+const fetchScript = async (scriptUrl, tailBytes) => {
+    const init = tailBytes ? { headers: { Range: `bytes=-${tailBytes}` } } : undefined;
+    const response = await fetch(scriptUrl, init);
+    if (!response.ok) {
+        return null;
+    }
+    return { text: await response.text(), partial: response.status === 206 };
+};
+/** Fetch and parse a sourcemap. A server answering 200-with-JavaScript fails the parse and yields null. */
+const fetchSourcemap = async (mapUrl) => {
+    const response = await fetch(mapUrl);
+    if (!response.ok) {
+        return null;
+    }
+    try {
+        return JSON.parse(await response.text());
+    }
+    catch {
+        return null;
+    }
+};
+const normalizeHttpUrl = (value) => {
+    let url;
+    try {
+        url = new URL(value);
+    }
+    catch {
+        return null;
+    }
+    if (url.protocol !== 'http:' && url.protocol !== 'https:') {
+        return null;
+    }
+    return url.toString();
+};
+//# sourceMappingURL=sourcemapResolver.js.map

package/dist/sourcemaps/sourcemapResolver.js.map

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

package/dist/sources/cdp-source.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cdp-source.d.ts","sourceRoot":"","sources":["../../src/sources/cdp-source.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAGrE,OAAO,EAA0B,KAAK,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAExF,OAAO,KAAK,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAEvE;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,oBAAoB,GAAG;IACrD,oDAAoD;IACpD,MAAM,EAAE,aAAa,CAAA;IACrB,wDAAwD;IACxD,KAAK,CAAC,EAAE,YAAY,CAAA;IACpB,sFAAsF;IACtF,aAAa,CAAC,EAAE,oBAAoB,CAAA;CACpC,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAI,SAAS,gBAAgB,KAAG,eAuD3D,CAAA"}
+{"version":3,"file":"cdp-source.d.ts","sourceRoot":"","sources":["../../src/sources/cdp-source.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAGrE,OAAO,EAA0B,KAAK,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAExF,OAAO,KAAK,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAEvE;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,oBAAoB,GAAG;IACrD,oDAAoD;IACpD,MAAM,EAAE,aAAa,CAAA;IACrB,wDAAwD;IACxD,KAAK,CAAC,EAAE,YAAY,CAAA;IACpB,sFAAsF;IACtF,aAAa,CAAC,EAAE,oBAAoB,CAAA;CACpC,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAI,SAAS,gBAAgB,KAAG,eAwD3D,CAAA"}

package/dist/sources/cdp-source.js

@@ -10,7 +10,7 @@ import { createCdpSessionHandle } from '../cdp/connection.js';
  * Returns a handle that can be used to control the source and access CDP session.
  */
 export const createCdpSource = (options) => {
-    const { events, ignoreMatcher, stripUrlPrefixes, chrome, match, sessionHandle } = options;
+    const { events, ignoreMatcher, stripUrlPrefixes, sourcemaps, chrome, match, sessionHandle } = options;
     // Create session handle if not provided
     const controller = sessionHandle ?? createCdpSessionHandle();
     // Convert ignoreMatcher function to IgnoreMatcher object if needed
@@ -22,6 +22,7 @@ export const createCdpSource = (options) => {
         sessionHandle: controller,
         ignoreMatcher: ignoreMatcherObj,
         stripUrlPrefixes,
+        sourcemaps,
         onLog: events.onLog,
         onStatus: events.onStatus,
         onPageNavigation: events.onPageNavigation,
@@ -45,7 +46,7 @@ export const createCdpSource = (options) => {
         readBrowserCookies: createCdpBrowserCookieReader(chrome, () => watcher.getTarget()?.id ?? null),
         getNetFilterContext: () => {
             const target = watcher.getTarget();
-            const context = watcher.session.getTargetContext?.();
+            const context = watcher.session.getTargetContext();
             return {
                 sourceMode: 'cdp',
                 selectedFrameId: context?.kind === 'frame' ? context.frameId : null,

package/dist/sources/cdp-source.js.map

@@ -1 +1 @@
-{"version":3,"file":"cdp-source.js","sourceRoot":"","sources":["../../src/sources/cdp-source.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,eAAe,EAA0B,MAAM,mBAAmB,CAAA;AAC3E,OAAO,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAA;AACvE,OAAO,EAAE,sBAAsB,EAA6B,MAAM,sBAAsB,CAAA;AAgBxF;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,OAAyB,EAAmB,EAAE;IAC7E,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,GAAG,OAAO,CAAA;IAEzF,wCAAwC;IACxC,MAAM,UAAU,GAAG,aAAa,IAAI,sBAAsB,EAAE,CAAA;IAE5D,mEAAmE;IACnE,MAAM,gBAAgB,GAAyB,aAAa,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;IAEhG,sCAAsC;IACtC,MAAM,cAAc,GAAsB;QACzC,MAAM;QACN,KAAK;QACL,aAAa,EAAE,UAAU;QACzB,aAAa,EAAE,gBAAgB;QAC/B,gBAAgB;QAChB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;QACzC,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACxB,CAAC,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CACpB,MAAM,CAAC,QAAS,CAAC,OAAO,EAAE;gBACzB,EAAE,EAAE,MAAM,CAAC,EAAE;gBACb,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,GAAG,EAAE,MAAM,CAAC,GAAG;gBACf,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ;aACzB,CAAC;YACJ,CAAC,CAAC,SAAS;QACZ,QAAQ,EAAE,MAAM,CAAC,QAAQ;KACzB,CAAA;IAED,MAAM,OAAO,GAAG,eAAe,CAAC,cAAc,CAAC,CAAA;IAE/C,OAAO;QACN,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,WAAW,EAAE,OAAO,CAAC,OAAO;QAC5B,kBAAkB,EAAE,4BAA4B,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,EAAE,IAAI,IAAI,CAAC;QAC/F,mBAAmB,EAAE,GAAG,EAAE;YACzB,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAA;YAClC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAA;YACpD,OAAO;gBACN,UAAU,EAAE,KAAK;gBACjB,eAAe,EAAE,OAAO,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI;gBACnE,UAAU,EAAE,IAAI;gBAChB,iBAAiB,EAAE,MAAM,EAAE,GAAG,IAAI,IAAI;gBACtC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,IAAI;aAC5B,CAAA;QACF,CAAC;QACD,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,iEAAiE;QACjE,0CAA0C;KAC1C,CAAA;AACF,CAAC,CAAA"}
+{"version":3,"file":"cdp-source.js","sourceRoot":"","sources":["../../src/sources/cdp-source.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,eAAe,EAA0B,MAAM,mBAAmB,CAAA;AAC3E,OAAO,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAA;AACvE,OAAO,EAAE,sBAAsB,EAA6B,MAAM,sBAAsB,CAAA;AAgBxF;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,OAAyB,EAAmB,EAAE;IAC7E,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,GAAG,OAAO,CAAA;IAErG,wCAAwC;IACxC,MAAM,UAAU,GAAG,aAAa,IAAI,sBAAsB,EAAE,CAAA;IAE5D,mEAAmE;IACnE,MAAM,gBAAgB,GAAyB,aAAa,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;IAEhG,sCAAsC;IACtC,MAAM,cAAc,GAAsB;QACzC,MAAM;QACN,KAAK;QACL,aAAa,EAAE,UAAU;QACzB,aAAa,EAAE,gBAAgB;QAC/B,gBAAgB;QAChB,UAAU;QACV,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;QACzC,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACxB,CAAC,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CACpB,MAAM,CAAC,QAAS,CAAC,OAAO,EAAE;gBACzB,EAAE,EAAE,MAAM,CAAC,EAAE;gBACb,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,GAAG,EAAE,MAAM,CAAC,GAAG;gBACf,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ;aACzB,CAAC;YACJ,CAAC,CAAC,SAAS;QACZ,QAAQ,EAAE,MAAM,CAAC,QAAQ;KACzB,CAAA;IAED,MAAM,OAAO,GAAG,eAAe,CAAC,cAAc,CAAC,CAAA;IAE/C,OAAO;QACN,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,WAAW,EAAE,OAAO,CAAC,OAAO;QAC5B,kBAAkB,EAAE,4BAA4B,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,EAAE,IAAI,IAAI,CAAC;QAC/F,mBAAmB,EAAE,GAAG,EAAE;YACzB,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAA;YAClC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAA;YAClD,OAAO;gBACN,UAAU,EAAE,KAAK;gBACjB,eAAe,EAAE,OAAO,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI;gBACnE,UAAU,EAAE,IAAI;gBAChB,iBAAiB,EAAE,MAAM,EAAE,GAAG,IAAI,IAAI;gBACtC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,IAAI;aAC5B,CAAA;QACF,CAAC;QACD,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,iEAAiE;QACjE,0CAA0C;KAC1C,CAAA;AACF,CAAC,CAAA"}

package/dist/sources/extension-control-source.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extension-control-source.d.ts","sourceRoot":"","sources":["../../src/sources/extension-control-source.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAIvE;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,GAAI,SAAS,oBAAoB,KAAG,eAiF5E,CAAA"}
+{"version":3,"file":"extension-control-source.d.ts","sourceRoot":"","sources":["../../src/sources/extension-control-source.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAIvE;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,GAAI,SAAS,oBAAoB,KAAG,eAkF5E,CAAA"}

package/dist/sources/extension-control-source.js

@@ -1,3 +1,5 @@
+import { createNotAttachedError } from '../errors.js';
+import { NATIVE_MESSAGING_PROTOCOL_VERSION } from '@vforsh/argus-core';
 import { createNativeMessaging } from '../native-messaging/messaging.js';
 import { ControlSessionManager } from '../native-messaging/control-session-manager.js';
 import { parseExtensionTargetId } from './extension-frame-state.js';
@@ -83,17 +85,21 @@ export const createControlExtensionSource = (options) => {
             watcherHost: hostInfo.watcherHost,
             watcherPort: hostInfo.watcherPort,
             pid: hostInfo.watcherPid,
+            protocolVersion: NATIVE_MESSAGING_PROTOCOL_VERSION,
         });
     }
 };
 const createDetachedSession = (message) => ({
     isAttached: () => false,
     sendAndWait: async () => {
-        const error = new Error(message);
-        error.code = 'cdp_not_attached';
-        throw error;
+        throw createNotAttachedError(message);
     },
     onEvent: () => () => { },
+    // A control watcher never attaches to a page, so there is no frame to scope to.
+    getTargetContext: () => ({ kind: 'page' }),
+    getReadyTargetContext: async () => {
+        throw createNotAttachedError(message);
+    },
 });
 /** Control watchers operate on whole tabs; iframe target ids are rejected with actionable errors. */
 const parseControlTabTarget = (targetId, action) => {

package/dist/sources/extension-control-source.js.map

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

package/dist/sources/extension-delegating-session.d.ts

@@ -1,5 +1,20 @@
 import type { ExtensionSession } from '../native-messaging/session-manager.js';
 import type { CdpSendOptions, CdpSessionHandle, CdpTargetContext } from '../cdp/connection.js';
+import type { CdpMethod, CdpParams } from '../cdp/protocol.js';
+/**
+ * A command about to be forwarded, discriminated by method.
+ *
+ * Written as a mapped union rather than `{ method: CdpMethod; params?: ... }` so that
+ * narrowing on `command.method` also narrows `command.params` to that method's shape.
+ */
+type PreparedCdpCommand = {
+    [M in CdpMethod]: {
+        method: M;
+        params?: CdpParams<M>;
+        commandOptions?: CdpSendOptions;
+        targetContext: CdpTargetContext;
+    };
+}[CdpMethod];
 export type DelegatingSessionController = {
     rebind: () => void;
     dispose: () => void;
@@ -8,17 +23,13 @@ type CreateDelegatingSessionOptions = {
     getCurrentSession: () => ExtensionSession | null;
     requireCurrentSession: () => ExtensionSession;
     getTargetContext: () => CdpTargetContext;
-    prepareCommand?: (command: {
-        method: string;
-        params?: Record<string, unknown>;
-        commandOptions?: CdpSendOptions;
-        targetContext: CdpTargetContext;
-    }) => {
-        params?: Record<string, unknown>;
+    getReadyTargetContext?: () => Promise<CdpTargetContext>;
+    prepareCommand?: (command: PreparedCdpCommand) => {
+        params?: CdpParams<CdpMethod>;
         commandOptions?: CdpSendOptions;
         targetContext?: CdpTargetContext;
     } | Promise<{
-        params?: Record<string, unknown>;
+        params?: CdpParams<CdpMethod>;
         commandOptions?: CdpSendOptions;
         targetContext?: CdpTargetContext;
     } | void> | void;

package/dist/sources/extension-delegating-session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extension-delegating-session.d.ts","sourceRoot":"","sources":["../../src/sources/extension-delegating-session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAA;AAC9E,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAS9F,MAAM,MAAM,2BAA2B,GAAG;IACzC,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,OAAO,EAAE,MAAM,IAAI,CAAA;CACnB,CAAA;AAED,KAAK,8BAA8B,GAAG;IACrC,iBAAiB,EAAE,MAAM,gBAAgB,GAAG,IAAI,CAAA;IAChD,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;IAC7C,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;IACxC,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE;QAC1B,MAAM,EAAE,MAAM,CAAA;QACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QAChC,cAAc,CAAC,EAAE,cAAc,CAAA;QAC/B,aAAa,EAAE,gBAAgB,CAAA;KAC/B,KACE;QACA,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QAChC,cAAc,CAAC,EAAE,cAAc,CAAA;QAC/B,aAAa,CAAC,EAAE,gBAAgB,CAAA;KAC/B,GACD,OAAO,CAAC;QACR,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QAChC,cAAc,CAAC,EAAE,cAAc,CAAA;QAC/B,aAAa,CAAC,EAAE,gBAAgB,CAAA;KAC/B,GAAG,IAAI,CAAC,GACT,IAAI,CAAA;CACP,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,uBAAuB,GACnC,SAAS,8BAA8B,KACrC;IAAE,OAAO,EAAE,gBAAgB,CAAC;IAAC,UAAU,EAAE,2BAA2B,CAAA;CAkEtE,CAAA"}
+{"version":3,"file":"extension-delegating-session.d.ts","sourceRoot":"","sources":["../../src/sources/extension-delegating-session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAA;AAC9E,OAAO,KAAK,EAAmB,cAAc,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAC/G,OAAO,KAAK,EAAY,SAAS,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAgBxE;;;;;GAKG;AACH,KAAK,kBAAkB,GAAG;KACxB,CAAC,IAAI,SAAS,GAAG;QACjB,MAAM,EAAE,CAAC,CAAA;QACT,MAAM,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAA;QACrB,cAAc,CAAC,EAAE,cAAc,CAAA;QAC/B,aAAa,EAAE,gBAAgB,CAAA;KAC/B;CACD,CAAC,SAAS,CAAC,CAAA;AAEZ,MAAM,MAAM,2BAA2B,GAAG;IACzC,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,OAAO,EAAE,MAAM,IAAI,CAAA;CACnB,CAAA;AAED,KAAK,8BAA8B,GAAG;IACrC,iBAAiB,EAAE,MAAM,gBAAgB,GAAG,IAAI,CAAA;IAChD,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;IAC7C,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;IACxC,qBAAqB,CAAC,EAAE,MAAM,OAAO,CAAC,gBAAgB,CAAC,CAAA;IACvD,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAC1C;QACA,MAAM,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAA;QAC7B,cAAc,CAAC,EAAE,cAAc,CAAA;QAC/B,aAAa,CAAC,EAAE,gBAAgB,CAAA;KAC/B,GACD,OAAO,CAAC;QACR,MAAM,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAA;QAC7B,cAAc,CAAC,EAAE,cAAc,CAAA;QAC/B,aAAa,CAAC,EAAE,gBAAgB,CAAA;KAC/B,GAAG,IAAI,CAAC,GACT,IAAI,CAAA;CACP,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,uBAAuB,GACnC,SAAS,8BAA8B,KACrC;IAAE,OAAO,EAAE,gBAAgB,CAAC;IAAC,UAAU,EAAE,2BAA2B,CAAA;CAsEtE,CAAA"}

package/dist/sources/extension-delegating-session.js

@@ -39,6 +39,8 @@ export const createDelegatingSession = (options) => {
                     commandOptions,
                     targetContext,
                 });
+                // prepareCommand returns params for whichever method it was handed, so the
+                // union it declares collapses back to this call's method.
                 nextParams = prepared?.params ?? params;
                 nextCommandOptions = prepared?.commandOptions ?? commandOptions;
                 targetContext = prepared?.targetContext ?? targetContext;
@@ -58,6 +60,8 @@ export const createDelegatingSession = (options) => {
             };
         },
         getTargetContext: options.getTargetContext,
+        // A session with no recovery step is ready as soon as its context resolves.
+        getReadyTargetContext: options.getReadyTargetContext ?? (async () => options.getTargetContext()),
     };
     controller.rebind();
     return { session, controller };

package/dist/sources/extension-delegating-session.js.map

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

package/dist/sources/extension-frame-runtime.d.ts

@@ -4,8 +4,9 @@ import { type ExtensionFrameState } from './extension-frame-state.js';
 export declare const seedExtensionFrameState: (session: ExtensionSession, state: ExtensionFrameState) => ExtensionFrameState;
 export declare const getSelectedExtensionTarget: (session: ExtensionSession, state: ExtensionFrameState | undefined) => CdpSourceTarget;
 export declare const setRequestedTargetSelection: (state: ExtensionFrameState, frameId: string | null) => void;
+/** List discovered targets plus a selected, pending placeholder when the requested iframe is missing. */
+export declare const listExtensionTargets: (session: ExtensionSession, state: ExtensionFrameState | undefined) => CdpSourceTarget[];
 export declare const reconcileExtensionTargetSelection: (session: ExtensionSession, state: ExtensionFrameState, onTargetChanged: () => void) => boolean;
-export declare const refreshExtensionFrameTree: (session: ExtensionSession, state: ExtensionFrameState, refreshFrameTitle: (frameId: string) => Promise<void>) => Promise<void>;
 export declare const removeExtensionFrame: (state: ExtensionFrameState, frameId: string) => void;
 export declare const refreshExtensionFrameTitle: (session: ExtensionSession, state: ExtensionFrameState, frameId: string, onActiveFrameUpdated: () => void, contextId?: number) => Promise<void>;
 //# sourceMappingURL=extension-frame-runtime.d.ts.map

package/dist/sources/extension-frame-runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extension-frame-runtime.d.ts","sourceRoot":"","sources":["../../src/sources/extension-frame-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAA;AAC9E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AACjD,OAAO,EASN,KAAK,mBAAmB,EACxB,MAAM,4BAA4B,CAAA;AAEnC,eAAO,MAAM,uBAAuB,GAAI,SAAS,gBAAgB,EAAE,OAAO,mBAAmB,KAAG,mBAiB/F,CAAA;AAED,eAAO,MAAM,0BAA0B,GAAI,SAAS,gBAAgB,EAAE,OAAO,mBAAmB,GAAG,SAAS,KAAG,eAW9G,CAAA;AAED,eAAO,MAAM,2BAA2B,GAAI,OAAO,mBAAmB,EAAE,SAAS,MAAM,GAAG,IAAI,KAAG,IAIhG,CAAA;AAED,eAAO,MAAM,iCAAiC,GAAI,SAAS,gBAAgB,EAAE,OAAO,mBAAmB,EAAE,iBAAiB,MAAM,IAAI,KAAG,OAmBtI,CAAA;AAED,eAAO,MAAM,yBAAyB,GACrC,SAAS,gBAAgB,EACzB,OAAO,mBAAmB,EAC1B,mBAAmB,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,KACnD,OAAO,CAAC,IAAI,CAId,CAAA;AAED,eAAO,MAAM,oBAAoB,GAAI,OAAO,mBAAmB,EAAE,SAAS,MAAM,KAAG,IAmBlF,CAAA;AAED,eAAO,MAAM,0BAA0B,GACtC,SAAS,gBAAgB,EACzB,OAAO,mBAAmB,EAC1B,SAAS,MAAM,EACf,sBAAsB,MAAM,IAAI,EAChC,YAAY,MAAM,KAChB,OAAO,CAAC,IAAI,CA2Cd,CAAA"}
+{"version":3,"file":"extension-frame-runtime.d.ts","sourceRoot":"","sources":["../../src/sources/extension-frame-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAA;AAC9E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AACjD,OAAO,EASN,KAAK,mBAAmB,EACxB,MAAM,4BAA4B,CAAA;AAEnC,eAAO,MAAM,uBAAuB,GAAI,SAAS,gBAAgB,EAAE,OAAO,mBAAmB,KAAG,mBAiB/F,CAAA;AAED,eAAO,MAAM,0BAA0B,GAAI,SAAS,gBAAgB,EAAE,OAAO,mBAAmB,GAAG,SAAS,KAAG,eAY9G,CAAA;AAED,eAAO,MAAM,2BAA2B,GAAI,OAAO,mBAAmB,EAAE,SAAS,MAAM,GAAG,IAAI,KAAG,IAOhG,CAAA;AAED,yGAAyG;AACzG,eAAO,MAAM,oBAAoB,GAAI,SAAS,gBAAgB,EAAE,OAAO,mBAAmB,GAAG,SAAS,KAAG,eAAe,EAevH,CAAA;AAED,eAAO,MAAM,iCAAiC,GAAI,SAAS,gBAAgB,EAAE,OAAO,mBAAmB,EAAE,iBAAiB,MAAM,IAAI,KAAG,OAuBtI,CAAA;AAED,eAAO,MAAM,oBAAoB,GAAI,OAAO,mBAAmB,EAAE,SAAS,MAAM,KAAG,IAkBlF,CAAA;AAED,eAAO,MAAM,0BAA0B,GACtC,SAAS,gBAAgB,EACzB,OAAO,mBAAmB,EAC1B,SAAS,MAAM,EACf,sBAAsB,MAAM,IAAI,EAChC,YAAY,MAAM,KAChB,OAAO,CAAC,IAAI,CA2Cd,CAAA"}

package/dist/sources/extension-frame-runtime.js

@@ -1,4 +1,4 @@
-import { buildPageTarget, collectFrameTree, createRequestedFrameHint, formatFrameTargetId, formatPageTargetId, frameToTarget, resolveRequestedTarget, } from './extension-frame-state.js';
+import { buildFrameTargets, buildPageTarget, createRequestedFrameHint, formatFrameTargetId, formatPageTargetId, frameToTarget, isSelectedTargetReady, resolveRequestedTarget, } from './extension-frame-state.js';
 export const seedExtensionFrameState = (session, state) => {
     if (state.frames.size > 0 || session.frames.length === 0) {
         return state;
@@ -16,41 +16,61 @@ export const seedExtensionFrameState = (session, state) => {
     return state;
 };
 export const getSelectedExtensionTarget = (session, state) => {
-    if (!state?.activeFrameId) {
+    const frameId = state?.requestedFrameId ?? state?.activeFrameId;
+    if (!state || !frameId) {
         return buildPageTarget(session, { attached: true });
     }
-    const frame = state.frames.get(state.activeFrameId);
+    const frame = state.frames.get(frameId);
     if (frame) {
         return frameToTarget(session.tabId, frame, { attached: true, faviconUrl: session.faviconUrl, topFrameId: state.topFrameId });
     }
     return buildSelectedIframeFallbackTarget(session, state);
 };
 export const setRequestedTargetSelection = (state, frameId) => {
+    if (state.requestedFrameId !== frameId) {
+        state.activeAttachedAt = null;
+    }
+    const previousHint = state.requestedFrameId === frameId ? state.requestedFrameHint : null;
     state.requestedFrameId = frameId;
-    state.requestedFrameHint = frameId ? createRequestedFrameHint(state.frames.get(frameId)) : null;
-    state.requestedFrameDetached = false;
+    state.requestedFrameHint = frameId ? (createRequestedFrameHint(state.frames.get(frameId)) ?? previousHint) : null;
+};
+/** List discovered targets plus a selected, pending placeholder when the requested iframe is missing. */
+export const listExtensionTargets = (session, state) => {
+    if (!state) {
+        return [buildPageTarget(session, { attached: true })];
+    }
+    const selected = getSelectedExtensionTarget(session, state);
+    selected.targetReady = isSelectedTargetReady(state);
+    const targets = [buildPageTarget(session, { attached: false }), ...buildFrameTargets(state, session.tabId, null, session.faviconUrl)];
+    const selectedIndex = targets.findIndex((target) => target.id === selected.id);
+    if (selectedIndex < 0) {
+        targets.push(selected);
+    }
+    else {
+        targets[selectedIndex] = selected;
+    }
+    return targets;
 };
 export const reconcileExtensionTargetSelection = (session, state, onTargetChanged) => {
     const resolution = resolveRequestedTarget(state);
     if (resolution.kind === 'page') {
-        state.requestedFrameDetached = false;
         return activatePageTarget(state, onTargetChanged);
     }
     if (resolution.kind === 'pending') {
-        return false;
+        if (state.activeFrameId == null && state.activeAttachedAt != null) {
+            return false;
+        }
+        state.activeFrameId = null;
+        state.activeAttachedAt = Date.now();
+        onTargetChanged();
+        return true;
     }
     syncRequestedFrameSelection(state, resolution.frameId);
-    state.requestedFrameDetached = false;
     if (state.activeFrameId === resolution.frameId) {
         return false;
     }
     return activateFrameTarget(state, resolution.frameId, onTargetChanged);
 };
-export const refreshExtensionFrameTree = async (session, state, refreshFrameTitle) => {
-    const frameTree = (await session.handle.sendAndWait('Page.getFrameTree'));
-    collectFrameTree(frameTree.frameTree, state);
-    await Promise.all([...state.executionContexts.keys()].map((frameId) => refreshFrameTitle(frameId)));
-};
 export const removeExtensionFrame = (state, frameId) => {
     const childIds = [...state.frames.values()].filter((frame) => frame.parentFrameId === frameId).map((frame) => frame.frameId);
     for (const childId of childIds) {
@@ -61,7 +81,6 @@ export const removeExtensionFrame = (state, frameId) => {
      * Frame ids are ephemeral, so the stored frame hint lets selection survive a fresh id after reload.
      */
     if (state.activeFrameId === frameId) {
-        state.requestedFrameDetached = state.requestedFrameId === frameId;
         state.activeFrameId = null;
         state.activeAttachedAt = null;
     }
@@ -83,12 +102,12 @@ export const refreshExtensionFrameTitle = async (session, state, frameId, onActi
     }
     state.pendingTitleLoads.add(frameId);
     try {
-        const evaluated = (await session.handle.sendAndWait('Runtime.evaluate', {
+        const evaluated = await session.handle.sendAndWait('Runtime.evaluate', {
             expression: 'document.title',
             contextId: executionContextId,
             returnByValue: true,
             silent: true,
-        }, frame.sessionId ? { sessionId: frame.sessionId } : undefined));
+        }, frame.sessionId ? { sessionId: frame.sessionId } : undefined);
         const title = typeof evaluated.result?.value === 'string' ? evaluated.result.value.trim() : '';
         const latestFrame = state.frames.get(frameId);
         if (!latestFrame) {
@@ -141,7 +160,7 @@ const syncRequestedFrameSelection = (state, frameId) => {
  */
 const buildSelectedIframeFallbackTarget = (session, state) => {
     const hint = state.requestedFrameHint;
-    const frameId = state.activeFrameId;
+    const frameId = state.requestedFrameId ?? state.activeFrameId;
     if (!frameId) {
         return buildPageTarget(session, { attached: true });
     }
@@ -153,6 +172,7 @@ const buildSelectedIframeFallbackTarget = (session, state) => {
         parentId: formatPageTargetId(session.tabId),
         faviconUrl: session.faviconUrl,
         attached: true,
+        targetReady: false,
     };
 };
 //# sourceMappingURL=extension-frame-runtime.js.map

package/dist/sources/extension-frame-runtime.js.map

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

package/dist/sources/extension-frame-snapshot.d.ts

@@ -0,0 +1,31 @@
+import type { ExtensionFrameSnapshot, ExtensionSession } from '../native-messaging/session-manager.js';
+import type { ExtensionFrameState } from './extension-frame-state.js';
+export type ApplyFrameSnapshotDeps = {
+    /** Removes a frame and its subtree from state, preserving the requested-frame hint. */
+    removeFrame: (tabId: number, frameId: string) => void;
+    /** Resolve an iframe's document title from its execution context (async, best effort). */
+    refreshFrameTitle: (session: ExtensionSession, frameId: string) => Promise<void>;
+    /** Re-resolve the requested target against the new table; returns true when selection changed. */
+    reconcileTargetSelection: (session: ExtensionSession) => boolean;
+    /** Refresh status/indicator when the active target's metadata changed without a selection change. */
+    emitTargetChanged: (session: ExtensionSession) => void;
+};
+/**
+ * Apply the extension's authoritative frame table to the watcher's frame state.
+ *
+ * This is the ONLY code path that reconciles state from a snapshot (pushed or pulled), and
+ * it is deliberately idempotent: `frames` is always the full table, so applying the same
+ * snapshot twice is a no-op. Three invariants define the contract:
+ *
+ * - `events.onPageNavigation` is NEVER fired here. Log rotation, sourcemap cache resets,
+ *   and the page indicator react only to the real top-frame `Page.frameNavigated` event
+ *   (see extension-session-events.ts); before C2 the extension replayed fabricated copies
+ *   of that event on every 150ms resync and each one re-triggered those side effects.
+ * - Title lookups are limited to frames that are new, whose URL changed, or that still
+ *   have no title — not every frame on every snapshot, which is what made the pre-C2
+ *   resync storm O(frames) in CDP round-trips.
+ * - Selection reconciliation runs exactly once per snapshot, after the table is updated,
+ *   so a removed-then-recreated iframe re-resolves through the requested-frame hint.
+ */
+export declare const applyExtensionFrameSnapshot: (session: ExtensionSession, state: ExtensionFrameState, snapshot: ExtensionFrameSnapshot, deps: ApplyFrameSnapshotDeps) => void;
+//# sourceMappingURL=extension-frame-snapshot.d.ts.map

package/dist/sources/extension-frame-snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-frame-snapshot.d.ts","sourceRoot":"","sources":["../../src/sources/extension-frame-snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAA;AACtG,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAErE,MAAM,MAAM,sBAAsB,GAAG;IACpC,uFAAuF;IACvF,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IACrD,0FAA0F;IAC1F,iBAAiB,EAAE,CAAC,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAChF,kGAAkG;IAClG,wBAAwB,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,OAAO,CAAA;IAChE,qGAAqG;IACrG,iBAAiB,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAA;CACtD,CAAA;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,2BAA2B,GACvC,SAAS,gBAAgB,EACzB,OAAO,mBAAmB,EAC1B,UAAU,sBAAsB,EAChC,MAAM,sBAAsB,KAC1B,IA2DF,CAAA"}