@vforsh/argus-watcher 0.3.0 → 0.4.0

package/dist/cdp/connection.d.ts

@@ -1,7 +1,10 @@
+import type { CdpEvent, CdpEventPayload, CdpMethod, CdpParams, CdpResult } from './protocol.js';
 export type CdpEventMeta = {
-    sessionId?: string | null;
+    /** Child protocol session the event arrived on, or `null` for the root target. */
+    sessionId: string | null;
 };
-export type CdpEventHandler = (params: unknown, meta: CdpEventMeta) => void;
+/** Handler for one CDP event, typed by the event it is registered for. */
+export type CdpEventHandler<E extends CdpEvent = CdpEvent> = (params: CdpEventPayload<E>, meta: CdpEventMeta) => void;
 export type CdpSendOptions = {
     /** Optional timeout for this CDP command (ms). */
     timeoutMs?: number;
@@ -18,10 +21,26 @@ export type CdpTargetContext = {
 };
 export type CdpSessionHandle = {
     isAttached: () => boolean;
-    sendAndWait: (method: string, params?: Record<string, unknown>, options?: CdpSendOptions) => Promise<unknown>;
-    onEvent: (method: string, handler: CdpEventHandler) => () => void;
-    /** Active target context for commands that need frame-aware behavior. */
-    getTargetContext?: () => CdpTargetContext;
+    /**
+     * Send one CDP command and await its result.
+     *
+     * Parameters and result are looked up from {@link CdpCommandMap} by method name, so an
+     * unknown method or a mistyped payload fails to compile. Use {@link sendUntypedCommand}
+     * for the rare call whose method is genuinely computed at runtime.
+     */
+    sendAndWait: <M extends CdpMethod>(method: M, params?: CdpParams<M>, options?: CdpSendOptions) => Promise<CdpResult<M>>;
+    /** Subscribe to one CDP event. The handler receives that event's payload, not `unknown`. */
+    onEvent: <E extends CdpEvent>(method: E, handler: CdpEventHandler<E>) => () => void;
+    /**
+     * Active target context for commands that need frame-aware behavior.
+     *
+     * Required, not optional-by-capability: a direct-CDP session is always page-scoped and says so,
+     * which is what lets every frame-aware consumer just call it instead of writing the same
+     * ternary-plus-optional-chain dance.
+     */
+    getTargetContext: () => CdpTargetContext;
+    /** Resolve the selected target after recovery; rejects if a requested iframe is still not executable. */
+    getReadyTargetContext: () => Promise<CdpTargetContext>;
 };
 type CdpConnection = {
     sendAndWait: (method: string, params?: Record<string, unknown>, options?: CdpSendOptions) => Promise<unknown>;
@@ -35,5 +54,22 @@ export type CdpSessionController = {
 };
 export declare const createCdpSessionHandle: () => CdpSessionController;
 export declare const createCdpNotAttachedError: () => Error;
+/** A short-lived connection to one CDP endpoint, for commands that need no session. */
+export type OneShotCdpConnection = {
+    sendAndWait: <M extends CdpMethod>(method: M, params?: CdpParams<M>, options?: CdpSendOptions) => Promise<CdpResult<M>>;
+    close: () => void;
+};
+/**
+ * Open a CDP WebSocket and return a connection for issuing a few commands.
+ *
+ * `browserCookies.ts` used to carry a second, bespoke CDP-over-WebSocket transport
+ * alongside this one — its own duck-typed WebSocket types, its own pending/timeout/cleanup
+ * machinery, its own message parsing, and hardcoded per-call request ids that existed only
+ * because it had no id allocator. Two transports in one directory meant every transport
+ * fix had to be made twice.
+ *
+ * Callers must `close()`; nothing reconnects a one-shot connection.
+ */
+export declare const openCdpConnection: (wsUrl: string, connectTimeoutMs?: number) => Promise<OneShotCdpConnection>;
 export {};
 //# sourceMappingURL=connection.d.ts.map

package/dist/cdp/connection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/cdp/connection.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG;IAC1B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACzB,CAAA;AAED,MAAM,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,KAAK,IAAI,CAAA;AAE3E,MAAM,MAAM,cAAc,GAAG;IAC5B,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,gBAAgB,GACzB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IACA,IAAI,EAAE,OAAO,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACxB,CAAA;AAEJ,MAAM,MAAM,gBAAgB,GAAG;IAC9B,UAAU,EAAE,MAAM,OAAO,CAAA;IACzB,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,cAAc,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAC7G,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,KAAK,MAAM,IAAI,CAAA;IACjE,yEAAyE;IACzE,gBAAgB,CAAC,EAAE,MAAM,gBAAgB,CAAA;CACzC,CAAA;AAQD,KAAK,aAAa,GAAG;IACpB,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,cAAc,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAC7G,aAAa,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IACtC,KAAK,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;CAChC,CAAA;AAID,MAAM,MAAM,oBAAoB,GAAG;IAClC,OAAO,EAAE,gBAAgB,CAAA;IACzB,MAAM,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,aAAa,CAAA;IAC5C,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;CACjC,CAAA;AAED,eAAO,MAAM,sBAAsB,QAAO,oBA6HzC,CAAA;AAED,eAAO,MAAM,yBAAyB,QAAO,KAI5C,CAAA"}
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/cdp/connection.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAE/F,MAAM,MAAM,YAAY,GAAG;IAC1B,kFAAkF;IAClF,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CACxB,CAAA;AAED,0EAA0E;AAC1E,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,QAAQ,GAAG,QAAQ,IAAI,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,YAAY,KAAK,IAAI,CAAA;AAErH,MAAM,MAAM,cAAc,GAAG;IAC5B,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,gBAAgB,GACzB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IACA,IAAI,EAAE,OAAO,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACxB,CAAA;AAEJ,MAAM,MAAM,gBAAgB,GAAG;IAC9B,UAAU,EAAE,MAAM,OAAO,CAAA;IACzB;;;;;;OAMG;IACH,WAAW,EAAE,CAAC,CAAC,SAAS,SAAS,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,cAAc,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAA;IACvH,4FAA4F;IAC5F,OAAO,EAAE,CAAC,CAAC,SAAS,QAAQ,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,KAAK,MAAM,IAAI,CAAA;IACnF;;;;;;OAMG;IACH,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;IACxC,yGAAyG;IACzG,qBAAqB,EAAE,MAAM,OAAO,CAAC,gBAAgB,CAAC,CAAA;CACtD,CAAA;AAQD,KAAK,aAAa,GAAG;IACpB,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,cAAc,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAC7G,aAAa,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IACtC,KAAK,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;CAChC,CAAA;AAID,MAAM,MAAM,oBAAoB,GAAG;IAClC,OAAO,EAAE,gBAAgB,CAAA;IACzB,MAAM,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,aAAa,CAAA;IAC5C,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;CACjC,CAAA;AAED,eAAO,MAAM,sBAAsB,QAAO,oBAkIzC,CAAA;AAED,eAAO,MAAM,yBAAyB,QAAO,KAAuE,CAAA;AAkBpH,uFAAuF;AACvF,MAAM,MAAM,oBAAoB,GAAG;IAClC,WAAW,EAAE,CAAC,CAAC,SAAS,SAAS,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,cAAc,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAA;IACvH,KAAK,EAAE,MAAM,IAAI,CAAA;CACjB,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,iBAAiB,GAAU,OAAO,MAAM,EAAE,yBAAwB,KAAG,OAAO,CAAC,oBAAoB,CAwC7G,CAAA"}

package/dist/cdp/connection.js

@@ -1,3 +1,4 @@
+import { createNotAttachedError } from '../errors.js';
 let nextId = 1;
 export const createCdpSessionHandle = () => {
     let connection = null;
@@ -21,6 +22,9 @@ export const createCdpSessionHandle = () => {
                 bucket?.delete(handler);
             };
         },
+        // A direct CDP connection targets one page; frame scoping only exists on the extension transport.
+        getTargetContext: () => ({ kind: 'page' }),
+        getReadyTargetContext: async () => ({ kind: 'page' }),
     };
     const attach = (socket) => {
         const pendingRequests = new Map();
@@ -76,6 +80,9 @@ export const createCdpSessionHandle = () => {
                 }
                 for (const handler of bucket) {
                     try {
+                        // Dispatch is untyped by construction: the wire carries an arbitrary method
+                        // string, and the handler's payload type was checked at registration.
+                        ;
                         handler(payload.params, { sessionId: null });
                     }
                     catch {
@@ -109,11 +116,7 @@ export const createCdpSessionHandle = () => {
     };
     return { session, attach, detach };
 };
-export const createCdpNotAttachedError = () => {
-    const error = new Error('Watcher not attached to a CDP target');
-    error.code = 'cdp_not_attached';
-    return error;
-};
+export const createCdpNotAttachedError = () => createNotAttachedError('Watcher not attached to a CDP target');
 const parseMessage = (data) => {
     if (typeof data === 'string') {
         try {
@@ -128,4 +131,53 @@ const parseMessage = (data) => {
     }
     return null;
 };
+/**
+ * Open a CDP WebSocket and return a connection for issuing a few commands.
+ *
+ * `browserCookies.ts` used to carry a second, bespoke CDP-over-WebSocket transport
+ * alongside this one — its own duck-typed WebSocket types, its own pending/timeout/cleanup
+ * machinery, its own message parsing, and hardcoded per-call request ids that existed only
+ * because it had no id allocator. Two transports in one directory meant every transport
+ * fix had to be made twice.
+ *
+ * Callers must `close()`; nothing reconnects a one-shot connection.
+ */
+export const openCdpConnection = async (wsUrl, connectTimeoutMs = 5_000) => {
+    const WebSocketConstructor = globalThis.WebSocket;
+    if (!WebSocketConstructor) {
+        throw new Error('WebSocket unavailable. Node 18+ required.');
+    }
+    const socket = new WebSocketConstructor(wsUrl);
+    const controller = createCdpSessionHandle();
+    const connection = controller.attach(socket);
+    socket.addEventListener('message', (event) => {
+        connection.handleMessage(event.data);
+    });
+    socket.addEventListener('close', () => {
+        connection.close('socket_closed');
+    });
+    await new Promise((resolve, reject) => {
+        const timer = setTimeout(() => reject(new Error(`CDP connection timed out after ${connectTimeoutMs}ms`)), connectTimeoutMs);
+        socket.addEventListener('open', () => {
+            clearTimeout(timer);
+            resolve();
+        });
+        socket.addEventListener('error', () => {
+            clearTimeout(timer);
+            reject(new Error('WebSocket error'));
+        });
+    });
+    return {
+        sendAndWait: controller.session.sendAndWait,
+        close: () => {
+            controller.detach('closed');
+            try {
+                socket.close();
+            }
+            catch {
+                // Already closed; nothing to unwind.
+            }
+        },
+    };
+};
 //# sourceMappingURL=connection.js.map

package/dist/cdp/connection.js.map

@@ -1 +1 @@
-{"version":3,"file":"connection.js","sourceRoot":"","sources":["../../src/cdp/connection.ts"],"names":[],"mappings":"AA0CA,IAAI,MAAM,GAAG,CAAC,CAAA;AAQd,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAyB,EAAE;IAChE,IAAI,UAAU,GAAyB,IAAI,CAAA;IAC3C,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAgC,CAAA;IAExD,MAAM,OAAO,GAAqB;QACjC,UAAU,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC;QACrC,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE;YAC9C,IAAI,CAAC,UAAU,EAAE,CAAC;gBACjB,MAAM,yBAAyB,EAAE,CAAA;YAClC,CAAC;YACD,OAAO,UAAU,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAA;QACvD,CAAC;QACD,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE;YAC5B,IAAI,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;YACjC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACb,MAAM,GAAG,IAAI,GAAG,EAAE,CAAA;gBAClB,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;YAC7B,CAAC;YACD,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;YACnB,OAAO,GAAG,EAAE;gBACX,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAA;YACxB,CAAC,CAAA;QACF,CAAC;KACD,CAAA;IAED,MAAM,MAAM,GAAG,CAAC,MAAiB,EAAiB,EAAE;QACnD,MAAM,eAAe,GAAG,IAAI,GAAG,EAA0B,CAAA;QAEzD,MAAM,WAAW,GAAG,KAAK,EAAE,MAAc,EAAE,MAAgC,EAAE,OAAwB,EAAoB,EAAE;YAC1H,MAAM,EAAE,GAAG,MAAM,EAAE,CAAA;YACnB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBACtC,MAAM,OAAO,GAAmB,EAAE,OAAO,EAAE,MAAM,EAAE,CAAA;gBACnD,IAAI,OAAO,EAAE,SAAS,EAAE,CAAC;oBACxB,OAAO,CAAC,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;wBAC/B,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;wBAC1B,MAAM,CAAC,IAAI,KAAK,CAAC,+BAA+B,OAAO,CAAC,SAAS,IAAI,CAAC,CAAC,CAAA;oBACxE,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAA;gBACtB,CAAC;gBACD,eAAe,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;gBAChC,IAAI,CAAC;oBACJ,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAAA;gBACpD,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBAChB,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;oBAC1B,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;wBACnB,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;oBAC5B,CAAC;oBACD,MAAM,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;gBAClE,CAAC;YACF,CAAC,CAAC,CAAA;QACH,CAAC,CAAA;QAED,MAAM,aAAa,GAAG,CAAC,IAAa,EAAQ,EAAE;YAC7C,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,CAAA;YAClC,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;gBAC7C,OAAM;YACP,CAAC;YAED,MAAM,OAAO,GAAG,OAMf,CAAA;YAED,IAAI,OAAO,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC;gBACxB,MAAM,OAAO,GAAG,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;gBAC/C,IAAI,CAAC,OAAO,EAAE,CAAC;oBACd,OAAM;gBACP,CAAC;gBACD,eAAe,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;gBAClC,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;oBACnB,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;gBAC5B,CAAC;gBACD,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;oBACnB,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,IAAI,oBAAoB,CAAC,CAAC,CAAA;oBACxE,OAAM;gBACP,CAAC;gBACD,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;gBAC/B,OAAM;YACP,CAAC;YAED,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;gBACpB,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;gBAC3C,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;oBAClC,OAAM;gBACP,CAAC;gBACD,KAAK,MAAM,OAAO,IAAI,MAAM,EAAE,CAAC;oBAC9B,IAAI,CAAC;wBACJ,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;oBAC7C,CAAC;oBAAC,MAAM,CAAC;wBACR,oDAAoD;oBACrD,CAAC;gBACF,CAAC;YACF,CAAC;QACF,CAAC,CAAA;QAED,MAAM,KAAK,GAAG,CAAC,MAAe,EAAQ,EAAE;YACvC,KAAK,MAAM,OAAO,IAAI,eAAe,CAAC,MAAM,EAAE,EAAE,CAAC;gBAChD,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,MAAM,IAAI,uBAAuB,CAAC,CAAC,CAAA;gBAC5D,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;oBACnB,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;gBAC5B,CAAC;YACF,CAAC;YACD,eAAe,CAAC,KAAK,EAAE,CAAA;QACxB,CAAC,CAAA;QAED,MAAM,cAAc,GAAkB;YACrC,WAAW;YACX,aAAa;YACb,KAAK;SACL,CAAA;QAED,UAAU,GAAG,cAAc,CAAA;QAC3B,OAAO,cAAc,CAAA;IACtB,CAAC,CAAA;IAED,MAAM,MAAM,GAAG,CAAC,MAAe,EAAQ,EAAE;QACxC,IAAI,UAAU,EAAE,CAAC;YAChB,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;QACzB,CAAC;QACD,UAAU,GAAG,IAAI,CAAA;IAClB,CAAC,CAAA;IAED,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAA;AACnC,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,yBAAyB,GAAG,GAAU,EAAE;IACpD,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAC9D;IAAC,KAAmC,CAAC,IAAI,GAAG,kBAAkB,CAAA;IAC/D,OAAO,KAAK,CAAA;AACb,CAAC,CAAA;AAED,MAAM,YAAY,GAAG,CAAC,IAAa,EAAW,EAAE;IAC/C,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,CAAC;YACJ,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QACxB,CAAC;QAAC,MAAM,CAAC;YACR,OAAO,IAAI,CAAA;QACZ,CAAC;IACF,CAAC;IAED,IAAI,IAAI,YAAY,WAAW,EAAE,CAAC;QACjC,OAAO,YAAY,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAA;IACpD,CAAC;IAED,OAAO,IAAI,CAAA;AACZ,CAAC,CAAA"}
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../../src/cdp/connection.ts"],"names":[],"mappings":"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"}

package/dist/cdp/dom/info.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"info.d.ts","sourceRoot":"","sources":["../../../src/cdp/dom/info.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAW3D,yDAAyD;AACzD,MAAM,MAAM,mBAAmB,GAAG;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAA;CACb,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,GAClC,SAAS,gBAAgB,EACzB,aAAa,kBAAkB,EAC/B,SAAS,mBAAmB,KAC1B,OAAO,CAAC,eAAe,CA+DzB,CAAA"}
+{"version":3,"file":"info.d.ts","sourceRoot":"","sources":["../../../src/cdp/dom/info.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAM3D,yDAAyD;AACzD,MAAM,MAAM,mBAAmB,GAAG;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAA;CACb,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,GAClC,SAAS,gBAAgB,EACzB,aAAa,kBAAkB,EAC/B,SAAS,mBAAmB,KAC1B,OAAO,CAAC,eAAe,CA+DzB,CAAA"}

package/dist/cdp/dom/info.js

@@ -23,10 +23,10 @@ export const fetchDomInfoBySelector = async (session, elementRefs, options) => {
     const elements = [];
     for (const handle of handles) {
         const descriptor = toDomNodeDescriptor(handle);
-        const describeResult = (await session.sendAndWait('DOM.describeNode', {
+        const describeResult = await session.sendAndWait('DOM.describeNode', {
             ...descriptor,
             depth: 1, // Just enough to get child count
-        }));
+        });
         if (!describeResult.node) {
             continue;
         }
@@ -36,7 +36,7 @@ export const fetchDomInfoBySelector = async (session, elementRefs, options) => {
         let outerHTML = null;
         let outerHTMLTruncated = false;
         try {
-            const htmlResult = (await session.sendAndWait('DOM.getOuterHTML', descriptor));
+            const htmlResult = await session.sendAndWait('DOM.getOuterHTML', descriptor);
             outerHTML = htmlResult.outerHTML ?? null;
             if (outerHTML && outerHTML.length > maxChars) {
                 outerHTML = outerHTML.slice(0, maxChars);

package/dist/cdp/dom/info.js.map

@@ -1 +1 @@
-{"version":3,"file":"info.js","sourceRoot":"","sources":["../../../src/cdp/dom/info.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"info.js","sourceRoot":"","sources":["../../../src/cdp/dom/info.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AAE3H,MAAM,4BAA4B,GAAG,MAAM,CAAA;AAC3C,MAAM,oBAAoB,GAAG,OAAO,CAAA;AAWpC;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,KAAK,EAC1C,OAAyB,EACzB,WAA+B,EAC/B,OAA4B,EACD,EAAE;IAC7B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,KAAK,CAAA;IAChC,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,iBAAiB,IAAI,4BAA4B,EAAE,CAAC,EAAE,oBAAoB,CAAC,CAAA;IAE1G,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAAC,OAAO,EAAE,WAAW,EAAE;QAClE,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,GAAG;QACH,IAAI,EAAE,OAAO,CAAC,IAAI;KAClB,CAAC,CAAA;IACF,IAAI,QAAQ,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QACxC,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,iCAAiC,OAAO,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAA;IACxG,CAAC;IACD,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,QAAQ,CAAA;IAExC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAA;IAC9C,CAAC;IAED,MAAM,QAAQ,GAAqB,EAAE,CAAA;IAErC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC9B,MAAM,UAAU,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAA;QAC9C,MAAM,cAAc,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,kBAAkB,EAAE;YACpE,GAAG,UAAU;YACb,KAAK,EAAE,CAAC,EAAE,iCAAiC;SAC3C,CAAC,CAAA;QAEF,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;YAC1B,SAAQ;QACT,CAAC;QAED,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,CAAA;QAChC,MAAM,UAAU,GAAG,kBAAkB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;QACtD,MAAM,iBAAiB,GAAG,oBAAoB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QAE7D,IAAI,SAAS,GAAkB,IAAI,CAAA;QACnC,IAAI,kBAAkB,GAAG,KAAK,CAAA;QAE9B,IAAI,CAAC;YACJ,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,kBAAkB,EAAE,UAAU,CAAC,CAAA;YAC5E,SAAS,GAAG,UAAU,CAAC,SAAS,IAAI,IAAI,CAAA;YAExC,IAAI,SAAS,IAAI,SAAS,CAAC,MAAM,GAAG,QAAQ,EAAE,CAAC;gBAC9C,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAA;gBACxC,kBAAkB,GAAG,IAAI,CAAA;YAC1B,CAAC;QACF,CAAC;QAAC,MAAM,CAAC;YACR,yDAAyD;QAC1D,CAAC;QAED,QAAQ,CAAC,IAAI,CAAC;YACb,GAAG,EAAE,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,WAAW,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,SAAS;YACzF,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE;YACpD,UAAU;YACV,iBAAiB;YACjB,SAAS;YACT,kBAAkB;SAClB,CAAC,CAAA;IACH,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAA;AAC1D,CAAC,CAAA"}

package/dist/cdp/dom/mutate.d.ts

@@ -0,0 +1,109 @@
+import type { DomInsertPosition } from '@vforsh/argus-core';
+import type { CdpSessionHandle } from '../connection.js';
+import { type DomNodeHandle } from './selector.js';
+/**
+ * DOM mutations driven by a CSS selector.
+ *
+ * modify/remove/insert/fill/setFile were five files running the same program —
+ * `DOM.enable` → resolve the document root → resolve selector matches → apply one action
+ * per node → report `{ allNodeIds, count }` — differing only in the page-side function.
+ * They share {@link mutateMatchedElements} here, with the per-action code as the only
+ * thing each one still owns.
+ */
+/** The selector target every mutation accepts. */
+export type MutationTarget = {
+    selector: string;
+    all?: boolean;
+    text?: string;
+};
+/** Outcome of a selector-driven mutation. */
+export type MutationResult = {
+    /** Every node the selector matched, before the `all` filter. */
+    allNodeIds: number[];
+    /** How many nodes the action was applied to. */
+    mutatedCount: number;
+};
+/**
+ * Resolve a selector and apply an action to each matched node.
+ *
+ * @param apply Runs once per matched node. Nodes that detach between resolution and use
+ *   are still counted — matching the behavior every caller had before this was shared.
+ */
+export declare const mutateMatchedElements: (session: CdpSessionHandle, target: MutationTarget, apply: (nodeId: number) => Promise<unknown>) => Promise<MutationResult>;
+/** Remove element(s) matching a CSS selector from the DOM. */
+export declare const removeElements: (session: CdpSessionHandle, options: MutationTarget) => Promise<MutationResult>;
+/** Base options for modifying matched elements. */
+type ModifyElementsBaseOptions = {
+    selector: string;
+    all?: boolean;
+    text?: string;
+};
+/** Attribute modification options. */
+type ModifyAttrOptions = ModifyElementsBaseOptions & {
+    type: 'attr';
+    set?: Record<string, string | true>;
+    remove?: string[];
+};
+/** Class modification options. */
+type ModifyClassOptions = ModifyElementsBaseOptions & {
+    type: 'class';
+    add?: string[];
+    remove?: string[];
+    toggle?: string[];
+};
+/** Style modification options. */
+type ModifyStyleOptions = ModifyElementsBaseOptions & {
+    type: 'style';
+    set?: Record<string, string>;
+    remove?: string[];
+};
+/** Text content modification options. */
+type ModifyTextOptions = ModifyElementsBaseOptions & {
+    type: 'text';
+    value: string;
+};
+/** HTML content modification options. */
+type ModifyHtmlOptions = ModifyElementsBaseOptions & {
+    type: 'html';
+    value: string;
+};
+/** Options for modifying matched elements. */
+export type ModifyElementsOptions = ModifyAttrOptions | ModifyClassOptions | ModifyStyleOptions | ModifyTextOptions | ModifyHtmlOptions;
+/**
+ * Modify element(s) matching a CSS selector.
+ * Supports attribute, class, style, text, and HTML modifications.
+ */
+export declare const modifyElements: (session: CdpSessionHandle, options: ModifyElementsOptions) => Promise<MutationResult>;
+/** Fill pre-resolved nodes with a value. Skips selector resolution. */
+export declare const fillResolvedNodes: (session: CdpSessionHandle, handles: DomNodeHandle[], value: string) => Promise<number>;
+/** Fill input/textarea/contenteditable element(s) matching a CSS selector. */
+export declare const fillElements: (session: CdpSessionHandle, options: MutationTarget & {
+    value: string;
+}) => Promise<MutationResult>;
+/** Options for inserting HTML adjacent to already-resolved elements. */
+export type InsertAdjacentHtmlOptions = {
+    nodeIds: number[];
+    html: string;
+    position?: DomInsertPosition;
+    text?: boolean;
+};
+/**
+ * Insert HTML (or text) adjacent to already-resolved elements.
+ *
+ * Takes node ids rather than a selector because `/dom/add` resolves matches itself to
+ * honor its `nth` and `expect` guards before mutating anything.
+ */
+export declare const insertAdjacentHtml: (session: CdpSessionHandle, options: InsertAdjacentHtmlOptions) => Promise<number>;
+/**
+ * Set files on already-resolved `<input type="file">` nodes.
+ *
+ * Uses CDP's `DOM.setFileInputFiles`, which reads from disk on the watcher host — there
+ * is no page function for this one.
+ */
+export declare const setFileOnResolvedNodes: (session: CdpSessionHandle, nodeIds: number[], files: string[]) => Promise<number>;
+/** Set files on `<input type="file">` element(s) matching a CSS selector. */
+export declare const setFileInputFiles: (session: CdpSessionHandle, options: MutationTarget & {
+    files: string[];
+}) => Promise<MutationResult>;
+export {};
+//# sourceMappingURL=mutate.d.ts.map

package/dist/cdp/dom/mutate.d.ts.map

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

package/dist/cdp/dom/mutate.js

@@ -0,0 +1,174 @@
+import { callFunctionOnNode } from '../pageState.js';
+import { getDomRootId, resolveSelectorMatches, toDomNodeDescriptor } from './selector.js';
+/**
+ * Resolve a selector and apply an action to each matched node.
+ *
+ * @param apply Runs once per matched node. Nodes that detach between resolution and use
+ *   are still counted — matching the behavior every caller had before this was shared.
+ */
+export const mutateMatchedElements = async (session, target, apply) => {
+    await session.sendAndWait('DOM.enable');
+    const rootId = await getDomRootId(session);
+    const { allNodeIds, nodeIds } = await resolveSelectorMatches(session, rootId, target.selector, target.all ?? false, target.text);
+    for (const nodeId of nodeIds) {
+        await apply(nodeId);
+    }
+    return { allNodeIds, mutatedCount: nodeIds.length };
+};
+/** Apply a page function to each node matched by a selector. */
+const mutateWithPageFunction = (session, target, fn) => mutateMatchedElements(session, target, (nodeId) => callFunctionOnNode(session, { nodeId }, fn));
+// ─────────────────────────────────────────────────────────────────────────────
+// Remove
+// ─────────────────────────────────────────────────────────────────────────────
+/** Remove element(s) matching a CSS selector from the DOM. */
+export const removeElements = (session, options) => mutateWithPageFunction(session, options, { code: 'function() { this.remove(); }' });
+/**
+ * Modify element(s) matching a CSS selector.
+ * Supports attribute, class, style, text, and HTML modifications.
+ */
+export const modifyElements = (session, options) => mutateWithPageFunction(session, options, buildModifyFunction(options));
+// ─────────────────────────────────────────────────────────────────────────────
+// Fill
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Browser-context function that sets the element value using the native
+ * prototype setter (to bypass React/Vue/Angular property wrappers) and
+ * dispatches input + change events so framework change detection fires.
+ */
+const FILL_FUNCTION = `function(value) {
+	var el = this;
+	el.focus();
+	if (el.isContentEditable) {
+		el.textContent = value;
+		el.dispatchEvent(new Event('input', { bubbles: true }));
+		el.dispatchEvent(new Event('change', { bubbles: true }));
+		return;
+	}
+	var proto = el.tagName === 'TEXTAREA' ? HTMLTextAreaElement.prototype
+		: el.tagName === 'SELECT' ? HTMLSelectElement.prototype
+		: HTMLInputElement.prototype;
+	var nativeSetter = Object.getOwnPropertyDescriptor(proto, 'value');
+	if (nativeSetter && nativeSetter.set) {
+		nativeSetter.set.call(el, value);
+	} else {
+		el.value = value;
+	}
+	el.dispatchEvent(new Event('input', { bubbles: true }));
+	el.dispatchEvent(new Event('change', { bubbles: true }));
+}`;
+/** Fill pre-resolved nodes with a value. Skips selector resolution. */
+export const fillResolvedNodes = async (session, handles, value) => {
+    for (const handle of handles) {
+        await callFunctionOnNode(session, toDomNodeDescriptor(handle), { code: FILL_FUNCTION, args: [{ value }] });
+    }
+    return handles.length;
+};
+/** Fill input/textarea/contenteditable element(s) matching a CSS selector. */
+export const fillElements = (session, options) => mutateWithPageFunction(session, options, { code: FILL_FUNCTION, args: [{ value: options.value }] });
+/**
+ * Insert HTML (or text) adjacent to already-resolved elements.
+ *
+ * Takes node ids rather than a selector because `/dom/add` resolves matches itself to
+ * honor its `nth` and `expect` guards before mutating anything.
+ */
+export const insertAdjacentHtml = async (session, options) => {
+    if (options.nodeIds.length === 0) {
+        return 0;
+    }
+    await session.sendAndWait('DOM.enable');
+    const fn = {
+        code: options.text
+            ? 'function(pos, value) { this.insertAdjacentText(pos, value); }'
+            : 'function(pos, html) { this.insertAdjacentHTML(pos, html); }',
+        args: [{ value: options.position ?? 'beforeend' }, { value: options.html }],
+    };
+    for (const nodeId of options.nodeIds) {
+        await callFunctionOnNode(session, { nodeId }, fn);
+    }
+    return options.nodeIds.length;
+};
+// ─────────────────────────────────────────────────────────────────────────────
+// Set file
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Set files on already-resolved `<input type="file">` nodes.
+ *
+ * Uses CDP's `DOM.setFileInputFiles`, which reads from disk on the watcher host — there
+ * is no page function for this one.
+ */
+export const setFileOnResolvedNodes = async (session, nodeIds, files) => {
+    for (const nodeId of nodeIds) {
+        await session.sendAndWait('DOM.setFileInputFiles', { files, nodeId });
+    }
+    return nodeIds.length;
+};
+/** Set files on `<input type="file">` element(s) matching a CSS selector. */
+export const setFileInputFiles = (session, options) => mutateMatchedElements(session, options, (nodeId) => session.sendAndWait('DOM.setFileInputFiles', { files: options.files, nodeId }));
+const buildModifyFunction = (options) => {
+    switch (options.type) {
+        case 'attr':
+            return {
+                code: `function(toSet, toRemove) {
+					if (toSet) {
+						for (const [name, value] of Object.entries(toSet)) {
+							if (value === true) {
+								this.setAttribute(name, '');
+							} else {
+								this.setAttribute(name, value);
+							}
+						}
+					}
+					if (toRemove) {
+						for (const name of toRemove) {
+							this.removeAttribute(name);
+						}
+					}
+				}`,
+                args: [{ value: options.set ?? null }, { value: options.remove ?? null }],
+            };
+        case 'class':
+            return {
+                code: `function(toAdd, toRemove, toToggle) {
+					if (toAdd) {
+						this.classList.add(...toAdd);
+					}
+					if (toRemove) {
+						this.classList.remove(...toRemove);
+					}
+					if (toToggle) {
+						for (const cls of toToggle) {
+							this.classList.toggle(cls);
+						}
+					}
+				}`,
+                args: [{ value: options.add ?? null }, { value: options.remove ?? null }, { value: options.toggle ?? null }],
+            };
+        case 'style':
+            return {
+                code: `function(toSet, toRemove) {
+					if (toSet) {
+						for (const [prop, value] of Object.entries(toSet)) {
+							this.style.setProperty(prop, value);
+						}
+					}
+					if (toRemove) {
+						for (const prop of toRemove) {
+							this.style.removeProperty(prop);
+						}
+					}
+				}`,
+                args: [{ value: options.set ?? null }, { value: options.remove ?? null }],
+            };
+        case 'text':
+            return {
+                code: `function(value) { this.textContent = value; }`,
+                args: [{ value: options.value }],
+            };
+        case 'html':
+            return {
+                code: `function(value) { this.innerHTML = value; }`,
+                args: [{ value: options.value }],
+            };
+    }
+};
+//# sourceMappingURL=mutate.js.map

package/dist/cdp/dom/mutate.js.map

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

package/dist/cdp/dom/selector.d.ts

@@ -1,4 +1,4 @@
-import type { CdpNode } from './types.js';
+import type { CdpNode } from '../protocol.js';
 import type { CdpSessionHandle } from '../connection.js';
 import type { ElementRefRegistry } from '../elementRefs.js';
 export type SelectorMatchResult = {

package/dist/cdp/dom/selector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"selector.d.ts","sourceRoot":"","sources":["../../../src/cdp/dom/selector.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"selector.d.ts","sourceRoot":"","sources":["../../../src/cdp/dom/selector.ts"],"names":[],"mappings":"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"}

package/dist/cdp/dom/selector.js

@@ -1,6 +1,6 @@
 import { filterNodesByText } from '../text-filter.js';
 export const getDomRootId = async (session) => {
-    const targetContext = session.getTargetContext?.();
+    const targetContext = await session.getReadyTargetContext();
     if (targetContext?.kind === 'frame') {
         return getFrameDomRootId(session, targetContext);
     }
@@ -8,7 +8,7 @@ export const getDomRootId = async (session) => {
 };
 export const resolveSelectorMatches = async (session, rootId, selector, all, text) => {
     // Always use querySelectorAll to get the true match count
-    const result = (await session.sendAndWait('DOM.querySelectorAll', { nodeId: rootId, selector }));
+    const result = await session.sendAndWait('DOM.querySelectorAll', { nodeId: rootId, selector });
     let allNodeIds = result.nodeIds ?? [];
     if (text != null) {
         allNodeIds = await filterNodesByText(session, allNodeIds, text);
@@ -91,10 +91,10 @@ export const resolveFirstSelectorNodeId = async (session, selector, text) => {
     return nodeIds[0] ?? null;
 };
 export const describeNodeByBackendId = async (session, backendNodeId) => {
-    const described = (await session.sendAndWait('DOM.describeNode', {
+    const described = await session.sendAndWait('DOM.describeNode', {
         backendNodeId,
         depth: 0,
-    }));
+    });
     return described.node ?? null;
 };
 export const resolveNodeIdByBackendId = async (session, backendNodeId) => {
@@ -104,9 +104,9 @@ export const resolveNodeIdByBackendId = async (session, backendNodeId) => {
     }
     // Prime the document tree first so CDP can map backend ids back into frontend node ids.
     await getDomRootId(session);
-    const pushed = (await session.sendAndWait('DOM.pushNodesByBackendIdsToFrontend', {
+    const pushed = await session.sendAndWait('DOM.pushNodesByBackendIdsToFrontend', {
         backendNodeIds: [backendNodeId],
-    }));
+    });
     const nodeId = pushed.nodeIds?.[0];
     return typeof nodeId === 'number' && nodeId > 0 ? nodeId : null;
 };
@@ -139,23 +139,23 @@ const getFrameDomRootId = async (session, targetContext) => {
     if (targetContext.executionContextId == null) {
         throw new Error(`Selected frame is not ready yet: ${targetContext.frameId}`);
     }
-    const evaluated = (await session.sendAndWait('Runtime.evaluate', {
+    const evaluated = await session.sendAndWait('Runtime.evaluate', {
         expression: 'document',
         contextId: targetContext.executionContextId,
         returnByValue: false,
-    }));
+    });
     const objectId = evaluated.result?.objectId;
     if (!objectId) {
         throw new Error(`Unable to resolve DOM root for frame: ${targetContext.frameId}`);
     }
-    const requested = (await session.sendAndWait('DOM.requestNode', { objectId }));
+    const requested = await session.sendAndWait('DOM.requestNode', { objectId });
     if (!requested.nodeId) {
         throw new Error(`Unable to resolve DOM root for frame: ${targetContext.frameId}`);
     }
     return requested.nodeId;
 };
 const getDocumentRootId = async (session) => {
-    const result = (await session.sendAndWait('DOM.getDocument', { depth: 1 }));
+    const result = await session.sendAndWait('DOM.getDocument', { depth: 1 });
     const rootId = result.root?.nodeId;
     if (!rootId) {
         throw new Error('Unable to resolve DOM root');