@vforsh/argus-watcher 0.1.6 → 0.1.8

package/dist/index.js

@@ -1,22 +1,6 @@
-import os from 'node:os';
-import path from 'node:path';
 import Emittery from 'emittery';
-import { LogBuffer } from './buffer/LogBuffer.js';
-import { NetBuffer } from './buffer/NetBuffer.js';
-import { startHttpServer } from './http/server.js';
-import { announceWatcher, removeWatcher, startRegistryHeartbeat, resolveUniqueWatcherId } from './registry/registry.js';
-import { WatcherFileLogger } from './fileLogs/WatcherFileLogger.js';
-import { buildIgnoreMatcher } from './cdp/ignoreList.js';
-import { createNetworkCapture } from './cdp/networkCapture.js';
-import { createTraceRecorder } from './cdp/tracing.js';
-import { createScreenshotter } from './cdp/screenshot.js';
-import { createRuntimeEditor } from './cdp/editor.js';
-import { createCdpSessionHandle } from './cdp/connection.js';
-import { createPageIndicatorController, validatePageIndicatorOptions, } from './cdp/pageIndicator.js';
-import { createEmulationController } from './emulation/EmulationController.js';
-import { createThrottleController } from './throttle/ThrottleController.js';
-import { createCdpSource } from './sources/cdp-source.js';
-import { createExtensionSource } from './sources/extension-source.js';
+import { resolveUniqueWatcherId } from './registry/registry.js';
+import { createWatcherHandle } from './startWatcherRuntime.js';
 /**
  * Start a watcher that connects to Chrome (via CDP or extension), buffers console logs, and exposes the HTTP API.
  * @param options - Configuration for binding, source mode, and buffering.
@@ -27,382 +11,6 @@ export const startWatcher = async (options) => {
         throw new Error('Watcher id is required');
     }
     const watcherId = await resolveUniqueWatcherId(options.id);
-    const sourceMode = options.source ?? 'cdp';
-    const host = options.host ?? '127.0.0.1';
-    const port = options.port ?? 0;
-    const chrome = options.chrome ?? { host: '127.0.0.1', port: 9222 };
-    const bufferSize = options.bufferSize ?? 50_000;
-    const netBufferSize = options.bufferSize ?? 50_000;
-    const startedAt = Date.now();
-    const ignoreMatcher = buildIgnoreMatcher(options.ignoreList);
-    const stripUrlPrefixes = options.location?.stripUrlPrefixes;
-    // Resolve artifacts configuration
-    const artifactsBaseDir = resolveArtifactsBaseDir(options.artifacts?.base, watcherId);
-    const logsEnabled = options.artifacts?.logs?.enabled === true;
-    const logsDir = path.join(artifactsBaseDir, 'logs');
-    const includeTimestamps = options.artifacts?.logs?.includeTimestamps ?? false;
-    const maxFiles = resolveMaxFiles(options.artifacts?.logs?.maxFiles);
-    // Network capture is opt-in (disabled by default) and supported in both direct CDP and extension mode.
-    const netEnabled = options.net?.enabled === true;
-    // Page console logging (default: minimal)
-    const pageConsoleLogging = options.pageConsoleLogging ?? 'minimal';
-    const events = new Emittery();
-    const buffer = new LogBuffer(bufferSize);
-    const netBuffer = netEnabled ? new NetBuffer(netBufferSize) : null;
-    let closing = false;
-    let readyForShutdown = false;
-    let shutdownRequested = false;
-    let closeOnce = null;
-    let cdpStatus = { attached: false, target: null };
-    const fileLogger = logsEnabled
-        ? new WatcherFileLogger({
-            watcherId,
-            startedAt,
-            logsDir,
-            chrome: sourceMode === 'cdp' ? chrome : undefined,
-            match: options.match,
-            maxFiles,
-            includeTimestamps,
-            buildFilename: options.artifacts?.logs?.buildFilename,
-        })
-        : null;
-    const record = {
-        id: watcherId,
-        host,
-        port,
-        pid: process.pid,
-        cwd: process.cwd(),
-        startedAt,
-        updatedAt: Date.now(),
-        match: sourceMode === 'cdp' ? options.match : undefined,
-        chrome: sourceMode === 'cdp' ? chrome : undefined,
-        includeTimestamps,
-        source: sourceMode,
-    };
-    // Create session handle for CDP mode (used by network capture, tracing, etc.)
-    const sessionHandle = createCdpSessionHandle();
-    // Emulation controller (shared across CDP and extension modes)
-    const emulationController = createEmulationController();
-    // Throttle controller (CPU, network, cache — shared across CDP and extension modes)
-    const throttleController = createThrottleController();
-    const logToPageConsole = (message) => {
-        if (pageConsoleLogging === 'none') {
-            return;
-        }
-        if (!sourceHandle?.session.isAttached()) {
-            return;
-        }
-        const fullMessage = `[ARGUS] ${watcherId} :: ${message}`;
-        queueMicrotask(() => {
-            sourceHandle?.session
-                .sendAndWait('Runtime.evaluate', {
-                expression: `console.log(${JSON.stringify(fullMessage)})`,
-                silent: true,
-            })
-                .catch(() => { });
-        });
-    };
-    validatePageIndicatorOptions(options.pageIndicator);
-    const indicatorEnabled = options.pageIndicator?.enabled === true;
-    let indicatorController = null;
-    let indicatorAttachedAt = null;
-    if (indicatorEnabled) {
-        indicatorController = createPageIndicatorController(options.pageIndicator);
-    }
-    const updateCdpStatus = (status) => {
-        const prevAttached = cdpStatus.attached;
-        cdpStatus = status;
-        if (status.attached && !prevAttached) {
-            const url = status.target?.url ?? 'unknown';
-            logToPageConsole(`attached (url=${url})`);
-            void events.emit('cdpAttached', {
-                ts: Date.now(),
-                watcherId,
-                target: status.target,
-            });
-            return;
-        }
-        if (!status.attached && prevAttached) {
-            void events.emit('cdpDetached', {
-                ts: Date.now(),
-                watcherId,
-                target: status.target,
-                reason: status.reason ?? 'unknown',
-            });
-        }
-    };
-    const buildIndicatorInfo = (target) => ({
-        watcherId,
-        watcherHost: host,
-        watcherPort: record.port,
-        watcherPid: process.pid,
-        targetTitle: target?.title ?? null,
-        targetUrl: target?.url ?? null,
-        attachedAt: indicatorAttachedAt ?? Date.now(),
-    });
-    const onIndicatorNavigation = (session, info) => {
-        if (!indicatorController) {
-            return;
-        }
-        indicatorController.onNavigation(session, buildIndicatorInfo({ title: null, url: info.url }));
-    };
-    const onIndicatorLoad = () => {
-        indicatorController?.reinstall();
-    };
-    const getIndicatorSession = () => sourceHandle.pageSession ?? sourceHandle.session;
-    const onIndicatorAttach = (session, target) => {
-        if (!indicatorController) {
-            return;
-        }
-        indicatorAttachedAt = Date.now();
-        indicatorController.onAttach(session, {
-            id: target.id,
-            title: target.title,
-            url: target.url,
-            type: target.type ?? 'page',
-            parentId: target.parentId ?? null,
-            webSocketDebuggerUrl: '',
-        }, buildIndicatorInfo({ title: target.title, url: target.url }));
-    };
-    const maybeInjectOnAttach = async (session, target) => {
-        if (!options.inject?.script) {
-            return;
-        }
-        if (!session.isAttached()) {
-            return;
-        }
-        const trimmedScript = options.inject.script.trim();
-        if (trimmedScript === '') {
-            console.warn(`[Watcher] Inject script is empty for watcher ${record.id}. Skipping.`);
-            return;
-        }
-        const attachedAt = Date.now();
-        const exposeArgus = options.inject.exposeArgus ?? true;
-        const argusPayload = exposeArgus
-            ? {
-                watcherId: record.id,
-                watcherHost: record.host,
-                watcherPort: record.port,
-                watcherPid: record.pid,
-                attachedAt,
-                target: {
-                    title: target.title ?? null,
-                    url: target.url ?? null,
-                    type: target.type ?? 'page',
-                    parentId: target.parentId ?? null,
-                },
-            }
-            : null;
-        const expression = buildInjectExpression(trimmedScript, argusPayload);
-        try {
-            await session.sendAndWait('Page.addScriptToEvaluateOnNewDocument', { source: expression });
-        }
-        catch (error) {
-            console.warn(`[Watcher] Failed to register inject script for watcher ${record.id}: ${formatError(error)}`);
-        }
-        try {
-            await session.sendAndWait('Runtime.evaluate', { expression, silent: true });
-        }
-        catch (error) {
-            console.warn(`[Watcher] Failed to run inject script for watcher ${record.id}: ${formatError(error)}`);
-        }
-    };
-    const handleSourceLog = (event) => {
-        buffer.add(event);
-        fileLogger?.writeEvent(event);
-    };
-    const handlePageNavigation = (info) => {
-        fileLogger?.rotate(info);
-        onIndicatorNavigation(getIndicatorSession(), info);
-        runtimeEditor?.reset();
-    };
-    const handlePageIntl = (info) => {
-        fileLogger?.setPageIntl(info);
-    };
-    const handleSourceAttach = async (session, target) => {
-        runtimeEditor?.rebind();
-        await emulationController.onAttach(session);
-        await throttleController.onAttach(session);
-        await networkCapture?.onAttached();
-        onIndicatorAttach(session, target);
-        await maybeInjectOnAttach(session, target);
-    };
-    const handleTargetChanged = (session, target) => {
-        onIndicatorAttach(session, target);
-    };
-    const handleSourceDetach = (reason) => {
-        runtimeEditor?.rebind();
-        networkCapture?.onDetached();
-        indicatorController?.onDetach();
-        if (reason != null) {
-            traceRecorder.onDetached(reason);
-        }
-    };
-    // Create the appropriate source based on mode
-    let sourceHandle;
-    let networkCapture = null;
-    let traceRecorder;
-    let screenshotter;
-    let runtimeEditor;
-    if (sourceMode === 'extension') {
-        // Extension mode
-        sourceHandle = createExtensionSource({
-            events: {
-                onLog: handleSourceLog,
-                onStatus: updateCdpStatus,
-                onPageNavigation: handlePageNavigation,
-                onPageLoad: onIndicatorLoad,
-                onPageIntl: handlePageIntl,
-                onAttach: handleSourceAttach,
-                onTargetChanged: handleTargetChanged,
-                onDetach: () => {
-                    handleSourceDetach();
-                },
-            },
-            watcherId,
-            watcherHost: host,
-            watcherPort: record.port,
-            ignoreMatcher: ignoreMatcher ? (url) => ignoreMatcher.matches(url) : null,
-            stripUrlPrefixes,
-        });
-        networkCapture = netBuffer ? createNetworkCapture({ session: sourceHandle.pageSession ?? sourceHandle.session, buffer: netBuffer }) : null;
-        // Create trace/screenshot with proxy session
-        traceRecorder = createTraceRecorder({ session: sourceHandle.session, artifactsDir: artifactsBaseDir });
-        screenshotter = createScreenshotter({ session: sourceHandle.session, artifactsDir: artifactsBaseDir });
-        runtimeEditor = createRuntimeEditor(sourceHandle.session);
-    }
-    else {
-        // CDP mode
-        networkCapture = netBuffer ? createNetworkCapture({ session: sessionHandle.session, buffer: netBuffer }) : null;
-        traceRecorder = createTraceRecorder({ session: sessionHandle.session, artifactsDir: artifactsBaseDir });
-        screenshotter = createScreenshotter({ session: sessionHandle.session, artifactsDir: artifactsBaseDir });
-        runtimeEditor = createRuntimeEditor(sessionHandle.session);
-        sourceHandle = createCdpSource({
-            chrome,
-            match: options.match,
-            sessionHandle,
-            events: {
-                onLog: handleSourceLog,
-                onStatus: updateCdpStatus,
-                onPageNavigation: handlePageNavigation,
-                onPageLoad: onIndicatorLoad,
-                onPageIntl: handlePageIntl,
-                onAttach: handleSourceAttach,
-                onDetach: (reason) => {
-                    handleSourceDetach(reason);
-                },
-            },
-            watcherId,
-            ignoreMatcher: ignoreMatcher ? (url) => ignoreMatcher.matches(url) : null,
-            stripUrlPrefixes,
-        });
-    }
-    const server = await startHttpServer({
-        host,
-        port,
-        buffer,
-        netBuffer,
-        getWatcher: () => record,
-        getCdpStatus: () => cdpStatus,
-        cdpSession: sourceHandle.session,
-        traceRecorder,
-        screenshotter,
-        runtimeEditor,
-        emulationController,
-        throttleController,
-        // Extension mode endpoints
-        sourceHandle: sourceMode === 'extension' ? sourceHandle : undefined,
-        onRequest: (event) => {
-            if (pageConsoleLogging === 'full') {
-                logToPageConsole(`http ${event.endpoint}`);
-            }
-            void events.emit('httpRequested', {
-                ...event,
-                watcherId,
-            });
-        },
-        onShutdown: () => {
-            if (!readyForShutdown || !closeOnce) {
-                shutdownRequested = true;
-                return;
-            }
-            void closeOnce();
-        },
-    });
-    record.port = server.port;
-    sourceHandle.syncWatcherInfo?.({
-        watcherId,
-        watcherHost: host,
-        watcherPort: record.port,
-        watcherPid: process.pid,
-    });
-    await announceWatcher(record);
-    const heartbeat = startRegistryHeartbeat(() => record, options.heartbeatMs ?? 15_000);
-    closeOnce = async () => {
-        if (closing) {
-            return;
-        }
-        closing = true;
-        heartbeat.stop();
-        indicatorController?.stop();
-        if (cdpStatus.attached) {
-            logToPageConsole('detached (reason=watcher_stopped)');
-        }
-        await sourceHandle.stop();
-        await fileLogger?.close();
-        traceRecorder.onDetached('watcher_stopped');
-        await server.close();
-        await removeWatcher(record.id);
-        events.clearListeners();
-    };
-    readyForShutdown = true;
-    if (shutdownRequested) {
-        void closeOnce();
-    }
-    return {
-        watcher: record,
-        events,
-        close: async () => {
-            await closeOnce?.();
-        },
-    };
-};
-const resolveArtifactsBaseDir = (base, watcherId) => {
-    if (base !== undefined && base !== null) {
-        if (typeof base !== 'string' || base.trim() === '') {
-            throw new Error('artifacts.base must be a non-empty string when provided');
-        }
-        return path.resolve(base);
-    }
-    return path.join(os.tmpdir(), 'argus', watcherId);
-};
-const resolveMaxFiles = (maxFiles) => {
-    if (maxFiles === undefined) {
-        return 5;
-    }
-    if (!Number.isInteger(maxFiles) || maxFiles < 1) {
-        throw new Error('artifacts.logs.maxFiles must be an integer >= 1');
-    }
-    return maxFiles;
-};
-const buildInjectExpression = (script, argusPayload) => {
-    const lines = ['(() => {'];
-    if (argusPayload) {
-        lines.push(`window.__ARGUS__ = ${JSON.stringify(argusPayload)};`);
-    }
-    lines.push(`const __argusScript = ${JSON.stringify(script)};`);
-    lines.push('const __argusFn = new Function(__argusScript);');
-    lines.push('__argusFn();');
-    lines.push('})();');
-    return lines.join('\n');
-};
-const formatError = (error) => {
-    if (!error) {
-        return 'Unknown error';
-    }
-    if (error instanceof Error) {
-        return error.message;
-    }
-    return String(error);
+    return createWatcherHandle(options, watcherId);
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,QAAQ,MAAM,UAAU,CAAA;AAC/B,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAA;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AA6J9D;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,EAAE,OAA4B,EAA0B,EAAE;IAC1F,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAA;IAC1C,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,sBAAsB,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;IAC1D,OAAO,mBAAmB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAA;AAC/C,CAAC,CAAA"}

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

@@ -0,0 +1,21 @@
+import type { ExtensionSession } from '../native-messaging/session-manager.js';
+import type { CdpSessionHandle, CdpTargetContext } from '../cdp/connection.js';
+export type DelegatingSessionController = {
+    rebind: () => void;
+    dispose: () => void;
+};
+type CreateDelegatingSessionOptions = {
+    getCurrentSession: () => ExtensionSession | null;
+    requireCurrentSession: () => ExtensionSession;
+    getTargetContext: () => CdpTargetContext;
+    mapParams?: (method: string, params?: Record<string, unknown>) => Record<string, unknown> | undefined;
+};
+/**
+ * Keep a stable session handle while the underlying extension tab attachment changes over time.
+ */
+export declare const createDelegatingSession: (options: CreateDelegatingSessionOptions) => {
+    session: CdpSessionHandle;
+    controller: DelegatingSessionController;
+};
+export {};
+//# sourceMappingURL=extension-delegating-session.d.ts.map

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

@@ -0,0 +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,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAS9E,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,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAA;CACrG,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,uBAAuB,GACnC,SAAS,8BAA8B,KACrC;IAAE,OAAO,EAAE,gBAAgB,CAAC;IAAC,UAAU,EAAE,2BAA2B,CAAA;CAsDtE,CAAA"}

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

@@ -0,0 +1,62 @@
+/**
+ * Keep a stable session handle while the underlying extension tab attachment changes over time.
+ */
+export const createDelegatingSession = (options) => {
+    const subscriptions = new Set();
+    const rebindSubscriptions = () => {
+        // Delegating sessions are created before a tab may be attached, so event listeners
+        // must follow the active extension session instead of binding once and going stale.
+        for (const subscription of subscriptions) {
+            subscription.unbind();
+            const currentSession = options.getCurrentSession();
+            if (!currentSession) {
+                continue;
+            }
+            subscription.off = currentSession.handle.onEvent(subscription.method, subscription.handler);
+        }
+    };
+    const disposeSubscriptions = () => {
+        for (const subscription of subscriptions) {
+            subscription.unbind();
+        }
+        subscriptions.clear();
+    };
+    const controller = {
+        rebind: rebindSubscriptions,
+        dispose: disposeSubscriptions,
+    };
+    const session = {
+        isAttached: () => options.getCurrentSession()?.handle.isAttached() ?? false,
+        sendAndWait: async (method, params, commandOptions) => {
+            const currentSession = options.requireCurrentSession();
+            const targetContext = options.getTargetContext();
+            const nextParams = options.mapParams ? options.mapParams(method, params) : params;
+            const nextOptions = targetContext.kind === 'frame' && targetContext.sessionId
+                ? { ...(commandOptions ?? {}), sessionId: targetContext.sessionId }
+                : commandOptions;
+            return currentSession.handle.sendAndWait(method, nextParams, nextOptions);
+        },
+        onEvent: (method, handler) => {
+            const subscription = createDelegatingEventSubscription(method, handler);
+            subscriptions.add(subscription);
+            controller.rebind();
+            return () => {
+                subscription.unbind();
+                subscriptions.delete(subscription);
+            };
+        },
+        getTargetContext: options.getTargetContext,
+    };
+    controller.rebind();
+    return { session, controller };
+};
+const createDelegatingEventSubscription = (method, handler) => ({
+    method,
+    handler,
+    off: null,
+    unbind() {
+        this.off?.();
+        this.off = null;
+    },
+});
+//# sourceMappingURL=extension-delegating-session.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extension-delegating-session.js","sourceRoot":"","sources":["../../src/sources/extension-delegating-session.ts"],"names":[],"mappings":"AAsBA;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CACtC,OAAuC,EACkC,EAAE;IAC3E,MAAM,aAAa,GAAG,IAAI,GAAG,EAA+B,CAAA;IAC5D,MAAM,mBAAmB,GAAG,GAAS,EAAE;QACtC,mFAAmF;QACnF,oFAAoF;QACpF,KAAK,MAAM,YAAY,IAAI,aAAa,EAAE,CAAC;YAC1C,YAAY,CAAC,MAAM,EAAE,CAAA;YACrB,MAAM,cAAc,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAA;YAClD,IAAI,CAAC,cAAc,EAAE,CAAC;gBACrB,SAAQ;YACT,CAAC;YACD,YAAY,CAAC,GAAG,GAAG,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,MAAM,EAAE,YAAY,CAAC,OAAO,CAAC,CAAA;QAC5F,CAAC;IACF,CAAC,CAAA;IAED,MAAM,oBAAoB,GAAG,GAAS,EAAE;QACvC,KAAK,MAAM,YAAY,IAAI,aAAa,EAAE,CAAC;YAC1C,YAAY,CAAC,MAAM,EAAE,CAAA;QACtB,CAAC;QACD,aAAa,CAAC,KAAK,EAAE,CAAA;IACtB,CAAC,CAAA;IAED,MAAM,UAAU,GAAgC;QAC/C,MAAM,EAAE,mBAAmB;QAC3B,OAAO,EAAE,oBAAoB;KAC7B,CAAA;IAED,MAAM,OAAO,GAAqB;QACjC,UAAU,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,MAAM,CAAC,UAAU,EAAE,IAAI,KAAK;QAC3E,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,EAAE;YACrD,MAAM,cAAc,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAA;YACtD,MAAM,aAAa,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAA;YAChD,MAAM,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAA;YACjF,MAAM,WAAW,GAChB,aAAa,CAAC,IAAI,KAAK,OAAO,IAAI,aAAa,CAAC,SAAS;gBACxD,CAAC,CAAC,EAAE,GAAG,CAAC,cAAc,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,aAAa,CAAC,SAAS,EAAE;gBACnE,CAAC,CAAC,cAAc,CAAA;YAClB,OAAO,cAAc,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,WAAW,CAAC,CAAA;QAC1E,CAAC;QACD,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE;YAC5B,MAAM,YAAY,GAAG,iCAAiC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;YACvE,aAAa,CAAC,GAAG,CAAC,YAAY,CAAC,CAAA;YAC/B,UAAU,CAAC,MAAM,EAAE,CAAA;YAEnB,OAAO,GAAG,EAAE;gBACX,YAAY,CAAC,MAAM,EAAE,CAAA;gBACrB,aAAa,CAAC,MAAM,CAAC,YAAY,CAAC,CAAA;YACnC,CAAC,CAAA;QACF,CAAC;QACD,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;KAC1C,CAAA;IAED,UAAU,CAAC,MAAM,EAAE,CAAA;IACnB,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,CAAA;AAC/B,CAAC,CAAA;AAED,MAAM,iCAAiC,GAAG,CAAC,MAAc,EAAE,OAAmD,EAA+B,EAAE,CAAC,CAAC;IAChJ,MAAM;IACN,OAAO;IACP,GAAG,EAAE,IAAI;IACT,MAAM;QACL,IAAI,CAAC,GAAG,EAAE,EAAE,CAAA;QACZ,IAAI,CAAC,GAAG,GAAG,IAAI,CAAA;IAChB,CAAC;CACD,CAAC,CAAA"}

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

@@ -8,6 +8,9 @@ type SessionSummary = {
 export type ExtensionFrameState = {
     topFrameId: string | null;
     requestedFrameId: string | null;
+    requestedFrameHint: RequestedFrameHint | null;
+    /** True once an active iframe disappears and we should report the page while waiting to rematch it safely. */
+    requestedFrameDetached: boolean;
     activeFrameId: string | null;
     activeAttachedAt: number | null;
     frames: Map<string, ExtensionFrame>;
@@ -21,6 +24,23 @@ export type ExtensionFrame = {
     title: string | null;
     sessionId: string | null;
 };
+export type RequestedFrameHint = {
+    /**
+     * Exact iframe URL at the moment the user selected it.
+     * We intentionally fail closed if the next frame does not report the same URL,
+     * because rematching the wrong sibling iframe is worse than requiring a reselect.
+     */
+    url: string | null;
+    title: string | null;
+};
+export type RequestedTargetResolution = {
+    kind: 'page';
+} | {
+    kind: 'pending';
+} | {
+    kind: 'frame';
+    frameId: string;
+};
 export type CdpFrameTreeNode = {
     frame?: {
         id?: string;
@@ -54,11 +74,18 @@ export declare const parseExecutionContext: (params: unknown) => {
     frameId: string | null;
     isDefault: boolean;
 } | null;
+export declare const createRequestedFrameHint: (frame: ExtensionFrame | null | undefined) => RequestedFrameHint | null;
 /**
  * Selection is about the user's intended target, not whether every frame-scoped command is ready.
  * Once the watcher knows the frame exists we can switch the active target; commands that require
  * an execution context still guard that separately at execution time.
  */
-export declare const resolveRequestedFrameId: (state: ExtensionFrameState, requestedFrameId: string | null) => string | null;
+export declare const resolveRequestedFrameId: (state: ExtensionFrameState, requestedFrameId: string | null, requestedFrameHint: RequestedFrameHint | null) => string | null;
+/**
+ * Pending iframe selections have two valid states:
+ * - `pending`: the iframe has never become active in this attachment yet, so keep waiting silently.
+ * - `page`: the iframe was active and then disappeared, so report the page while we wait for a safe rematch.
+ */
+export declare const resolveRequestedTarget: (state: ExtensionFrameState) => RequestedTargetResolution;
 export {};
 //# sourceMappingURL=extension-frame-state.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"extension-frame-state.d.ts","sourceRoot":"","sources":["../../src/sources/extension-frame-state.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"extension-frame-state.d.ts","sourceRoot":"","sources":["../../src/sources/extension-frame-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEjD,KAAK,cAAc,GAAG;IACrB,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG;IACjC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,kBAAkB,EAAE,kBAAkB,GAAG,IAAI,CAAA;IAC7C,8GAA8G;IAC9G,sBAAsB,EAAE,OAAO,CAAA;IAC/B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;IACnC,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACtC,iBAAiB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CAC9B,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CACxB,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAChC;;;;OAIG;IACH,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CACpB,CAAA;AAED,MAAM,MAAM,yBAAyB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAEnH,MAAM,MAAM,gBAAgB,GAAG;IAC9B,KAAK,CAAC,EAAE;QACP,EAAE,CAAC,EAAE,MAAM,CAAA;QACX,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,GAAG,CAAC,EAAE,MAAM,CAAA;QACZ,IAAI,CAAC,EAAE,MAAM,CAAA;KACb,CAAA;IACD,WAAW,CAAC,EAAE,gBAAgB,EAAE,CAAA;CAChC,CAAA;AAED,eAAO,MAAM,qBAAqB,QAAO,mBAUvC,CAAA;AAEF,eAAO,MAAM,sBAAsB,QAAO,KAIzC,CAAA;AAED,eAAO,MAAM,kBAAkB,GAAI,OAAO,MAAM,KAAG,MAAwB,CAAA;AAE3E,eAAO,MAAM,mBAAmB,GAAI,OAAO,MAAM,EAAE,SAAS,MAAM,KAAG,MAAqC,CAAA;AAE1G,eAAO,MAAM,sBAAsB,GAAI,UAAU,MAAM,KAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CAuBhG,CAAA;AAED,eAAO,MAAM,eAAe,GAAI,SAAS,cAAc,EAAE,SAAS;IAAE,QAAQ,EAAE,OAAO,CAAA;CAAE,KAAG,eAQxF,CAAA;AAEF,eAAO,MAAM,aAAa,GACzB,OAAO,MAAM,EACb,OAAO,cAAc,EACrB,SAAS;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,KAC5E,eAWD,CAAA;AAEF,eAAO,MAAM,iBAAiB,GAAI,OAAO,mBAAmB,EAAE,OAAO,MAAM,EAAE,eAAe,MAAM,GAAG,IAAI,EAAE,aAAa,MAAM,KAAG,eAAe,EAGT,CAAA;AAEvI,eAAO,MAAM,gBAAgB,GAAI,MAAM,gBAAgB,GAAG,SAAS,EAAE,OAAO,mBAAmB,KAAG,IAoBjG,CAAA;AAED,eAAO,MAAM,UAAU,GAAI,QAAQ,OAAO,KAAG,cAAc,GAAG,IAc7D,CAAA;AAED,eAAO,MAAM,qBAAqB,GAAI,QAAQ,OAAO,KAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,GAAG,IAgBpH,CAAA;AAED,eAAO,MAAM,wBAAwB,GAAI,OAAO,cAAc,GAAG,IAAI,GAAG,SAAS,KAAG,kBAAkB,GAAG,IASxG,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,GACnC,OAAO,mBAAmB,EAC1B,kBAAkB,MAAM,GAAG,IAAI,EAC/B,oBAAoB,kBAAkB,GAAG,IAAI,KAC3C,MAAM,GAAG,IAuBX,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,GAAI,OAAO,mBAAmB,KAAG,yBAWnE,CAAA"}