appium-remote-debugger 15.2.9 → 15.2.11

package/build/lib/mixins/events.d.ts

@@ -1,45 +1,46 @@
+import type { RemoteDebugger } from '../remote-debugger';
+import type { EventListener } from '../types';
+export declare const events: {
+    readonly EVENT_PAGE_CHANGE: "remote_debugger_page_change";
+    readonly EVENT_FRAMES_DETACHED: "remote_debugger_frames_detached";
+    readonly EVENT_DISCONNECT: "remote_debugger_disconnect";
+};
 /**
- * Keep track of the client event listeners so they can be removed
+ * Adds a client event listener to the RPC client and tracks it for later removal.
+ * The listener will be called when the specified event is emitted by the remote debugger.
  *
- * @this {RemoteDebugger}
- * @param {string} eventName
- * @param {import('../types').EventListener} listener
- * @returns {void}
+ * @param eventName - The name of the event to listen for.
+ * @param listener - The event listener function to call when the event is emitted.
  */
-export function addClientEventListener(this: import("../remote-debugger").RemoteDebugger, eventName: string, listener: import("../types").EventListener): void;
+export declare function addClientEventListener(this: RemoteDebugger, eventName: string, listener: EventListener): void;
 /**
- * @this {RemoteDebugger}
- * @param {string} eventName
- * @returns {void}
+ * Removes all client event listeners for the specified event name from the RPC client.
+ * This will stop listening for the event and clean up the tracked listeners.
+ *
+ * @param eventName - The name of the event to stop listening for.
  */
-export function removeClientEventListener(this: import("../remote-debugger").RemoteDebugger, eventName: string): void;
+export declare function removeClientEventListener(this: RemoteDebugger, eventName: string): void;
 /**
- * @this {RemoteDebugger}
- * @param {import('../types').EventListener} listener
- * @returns {void}
+ * Starts listening for JavaScript console messages by registering listeners
+ * for Console.messageAdded and Console.messageRepeatCountUpdated events.
+ *
+ * @param listener - The event listener function to call when console messages are received.
  */
-export function startConsole(this: import("../remote-debugger").RemoteDebugger, listener: import("../types").EventListener): void;
+export declare function startConsole(this: RemoteDebugger, listener: EventListener): void;
 /**
- * @this {RemoteDebugger}
- * @returns {void}
+ * Stops listening for JavaScript console messages by removing listeners
+ * for Console.messageAdded and Console.messageRepeatCountUpdated events.
  */
-export function stopConsole(this: import("../remote-debugger").RemoteDebugger): void;
+export declare function stopConsole(this: RemoteDebugger): void;
 /**
- * @this {RemoteDebugger}
- * @param {import('../types').EventListener} listener
- * @returns {void}
+ * Starts listening for network events by registering a listener for NetworkEvent.
+ * This aggregates all Network.* events into a single NetworkEvent.
+ *
+ * @param listener - The event listener function to call when network events are received.
  */
-export function startNetwork(this: import("../remote-debugger").RemoteDebugger, listener: import("../types").EventListener): void;
+export declare function startNetwork(this: RemoteDebugger, listener: EventListener): void;
 /**
- * @this {RemoteDebugger}
- * @returns {void}
+ * Stops listening for network events by removing the listener for NetworkEvent.
  */
-export function stopNetwork(this: import("../remote-debugger").RemoteDebugger): void;
-export namespace events {
-    let EVENT_PAGE_CHANGE: "remote_debugger_page_change";
-    let EVENT_FRAMES_DETACHED: "remote_debugger_frames_detached";
-    let EVENT_DISCONNECT: "remote_debugger_disconnect";
-}
-export default events;
-export type RemoteDebugger = import("../remote-debugger").RemoteDebugger;
+export declare function stopNetwork(this: RemoteDebugger): void;
 //# sourceMappingURL=events.d.ts.map

package/build/lib/mixins/events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../lib/mixins/events.js"],"names":[],"mappings":"AAWA;;;;;;;GAOG;AACH,qGAJW,MAAM,YACN,OAAO,UAAU,EAAE,aAAa,GAC9B,IAAI,CAMhB;AAED;;;;GAIG;AACH,wGAHW,MAAM,GACJ,IAAI,CAMhB;AAED;;;;GAIG;AACH,0FAHW,OAAO,UAAU,EAAE,aAAa,GAC9B,IAAI,CAMhB;AAED;;;GAGG;AACH,gFAFa,IAAI,CAMhB;AAED;;;;GAIG;AACH,0FAHW,OAAO,UAAU,EAAE,aAAa,GAC9B,IAAI,CAKhB;AAED;;;GAGG;AACH,gFAFa,IAAI,CAKhB;;;;;;;6BAKY,OAAO,oBAAoB,EAAE,cAAc"}
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../lib/mixins/events.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAG9C,eAAO,MAAM,MAAM;;;;CAIT,CAAC;AAEX;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,cAAc,EACpB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,aAAa,GACtB,IAAI,CAIN;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,cAAc,EACpB,SAAS,EAAE,MAAM,GAChB,IAAI,CAIN;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,cAAc,EACpB,QAAQ,EAAE,aAAa,GACtB,IAAI,CAIN;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAItD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,cAAc,EACpB,QAAQ,EAAE,aAAa,GACtB,IAAI,CAGN;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAGtD"}

package/build/lib/mixins/events.js

@@ -9,18 +9,17 @@ exports.startNetwork = startNetwork;
 exports.stopNetwork = stopNetwork;
 const property_accessors_1 = require("./property-accessors");
 // event emitted publically
-exports.events = ({
+exports.events = {
     EVENT_PAGE_CHANGE: 'remote_debugger_page_change',
     EVENT_FRAMES_DETACHED: 'remote_debugger_frames_detached',
     EVENT_DISCONNECT: 'remote_debugger_disconnect',
-});
+};
 /**
- * Keep track of the client event listeners so they can be removed
+ * Adds a client event listener to the RPC client and tracks it for later removal.
+ * The listener will be called when the specified event is emitted by the remote debugger.
  *
- * @this {RemoteDebugger}
- * @param {string} eventName
- * @param {import('../types').EventListener} listener
- * @returns {void}
+ * @param eventName - The name of the event to listen for.
+ * @param listener - The event listener function to call when the event is emitted.
  */
 function addClientEventListener(eventName, listener) {
     (0, property_accessors_1.getClientEventListeners)(this)[eventName] ??= [];
@@ -28,9 +27,10 @@ function addClientEventListener(eventName, listener) {
     this.requireRpcClient().on(eventName, listener);
 }
 /**
- * @this {RemoteDebugger}
- * @param {string} eventName
- * @returns {void}
+ * Removes all client event listeners for the specified event name from the RPC client.
+ * This will stop listening for the event and clean up the tracked listeners.
+ *
+ * @param eventName - The name of the event to stop listening for.
  */
 function removeClientEventListener(eventName) {
     for (const listener of ((0, property_accessors_1.getClientEventListeners)(this)[eventName] || [])) {
@@ -38,9 +38,10 @@ function removeClientEventListener(eventName) {
     }
 }
 /**
- * @this {RemoteDebugger}
- * @param {import('../types').EventListener} listener
- * @returns {void}
+ * Starts listening for JavaScript console messages by registering listeners
+ * for Console.messageAdded and Console.messageRepeatCountUpdated events.
+ *
+ * @param listener - The event listener function to call when console messages are received.
  */
 function startConsole(listener) {
     this.log.debug('Starting to listen for JavaScript console');
@@ -48,8 +49,8 @@ function startConsole(listener) {
     this.addClientEventListener('Console.messageRepeatCountUpdated', listener);
 }
 /**
- * @this {RemoteDebugger}
- * @returns {void}
+ * Stops listening for JavaScript console messages by removing listeners
+ * for Console.messageAdded and Console.messageRepeatCountUpdated events.
  */
 function stopConsole() {
     this.log.debug('Stopping to listen for JavaScript console');
@@ -57,24 +58,20 @@ function stopConsole() {
     this.removeClientEventListener('Console.messageRepeatCountUpdated');
 }
 /**
- * @this {RemoteDebugger}
- * @param {import('../types').EventListener} listener
- * @returns {void}
+ * Starts listening for network events by registering a listener for NetworkEvent.
+ * This aggregates all Network.* events into a single NetworkEvent.
+ *
+ * @param listener - The event listener function to call when network events are received.
  */
 function startNetwork(listener) {
     this.log.debug('Starting to listen for network events');
     this.addClientEventListener('NetworkEvent', listener);
 }
 /**
- * @this {RemoteDebugger}
- * @returns {void}
+ * Stops listening for network events by removing the listener for NetworkEvent.
  */
 function stopNetwork() {
     this.log.debug('Stopping to listen for network events');
     this.removeClientEventListener('NetworkEvent');
 }
-exports.default = exports.events;
-/**
- * @typedef {import('../remote-debugger').RemoteDebugger} RemoteDebugger
- */
 //# sourceMappingURL=events.js.map

package/build/lib/mixins/events.js.map

@@ -1 +1 @@
-{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../lib/mixins/events.js"],"names":[],"mappings":";;;AAmBA,wDAIC;AAOD,8DAIC;AAOD,oCAIC;AAMD,kCAIC;AAOD,oCAGC;AAMD,kCAGC;AA1ED,6DAE8B;AAE9B,2BAA2B;AACd,QAAA,MAAM,GAAwB,CAAC;IAC1C,iBAAiB,EAAE,6BAA6B;IAChD,qBAAqB,EAAE,iCAAiC;IACxD,gBAAgB,EAAE,4BAA4B;CAC/C,CAAC,CAAC;AAEH;;;;;;;GAOG;AACH,SAAgB,sBAAsB,CAAE,SAAS,EAAE,QAAQ;IACzD,IAAA,4CAAuB,EAAC,IAAI,CAAC,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IAChD,IAAA,4CAAuB,EAAC,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACxD,IAAI,CAAC,gBAAgB,EAAE,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;AAClD,CAAC;AAED;;;;GAIG;AACH,SAAgB,yBAAyB,CAAE,SAAS;IAClD,KAAK,MAAM,QAAQ,IAAI,CAAC,IAAA,4CAAuB,EAAC,IAAI,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;QACxE,IAAI,CAAC,gBAAgB,EAAE,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACnD,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAgB,YAAY,CAAE,QAAQ;IACpC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC5D,IAAI,CAAC,sBAAsB,CAAC,sBAAsB,EAAE,QAAQ,CAAC,CAAC;IAC9D,IAAI,CAAC,sBAAsB,CAAC,mCAAmC,EAAE,QAAQ,CAAC,CAAC;AAC7E,CAAC;AAED;;;GAGG;AACH,SAAgB,WAAW;IACzB,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC5D,IAAI,CAAC,yBAAyB,CAAC,sBAAsB,CAAC,CAAC;IACvD,IAAI,CAAC,yBAAyB,CAAC,mCAAmC,CAAC,CAAC;AACtE,CAAC;AAED;;;;GAIG;AACH,SAAgB,YAAY,CAAE,QAAQ;IACpC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;IACxD,IAAI,CAAC,sBAAsB,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;AACxD,CAAC;AAED;;;GAGG;AACH,SAAgB,WAAW;IACzB,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;IACxD,IAAI,CAAC,yBAAyB,CAAC,cAAc,CAAC,CAAC;AACjD,CAAC;AAED,kBAAe,cAAM,CAAC;AAEtB;;GAEG"}
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../lib/mixins/events.ts"],"names":[],"mappings":";;;AAoBA,wDAQC;AAQD,8DAOC;AAQD,oCAOC;AAMD,kCAIC;AAQD,oCAMC;AAKD,kCAGC;AA1FD,6DAE8B;AAI9B,2BAA2B;AACd,QAAA,MAAM,GAAG;IACpB,iBAAiB,EAAE,6BAA6B;IAChD,qBAAqB,EAAE,iCAAiC;IACxD,gBAAgB,EAAE,4BAA4B;CACtC,CAAC;AAEX;;;;;;GAMG;AACH,SAAgB,sBAAsB,CAEpC,SAAiB,EACjB,QAAuB;IAEvB,IAAA,4CAAuB,EAAC,IAAI,CAAC,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IAChD,IAAA,4CAAuB,EAAC,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACxD,IAAI,CAAC,gBAAgB,EAAE,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;AAClD,CAAC;AAED;;;;;GAKG;AACH,SAAgB,yBAAyB,CAEvC,SAAiB;IAEjB,KAAK,MAAM,QAAQ,IAAI,CAAC,IAAA,4CAAuB,EAAC,IAAI,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;QACxE,IAAI,CAAC,gBAAgB,EAAE,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACnD,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAgB,YAAY,CAE1B,QAAuB;IAEvB,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC5D,IAAI,CAAC,sBAAsB,CAAC,sBAAsB,EAAE,QAAQ,CAAC,CAAC;IAC9D,IAAI,CAAC,sBAAsB,CAAC,mCAAmC,EAAE,QAAQ,CAAC,CAAC;AAC7E,CAAC;AAED;;;GAGG;AACH,SAAgB,WAAW;IACzB,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC5D,IAAI,CAAC,yBAAyB,CAAC,sBAAsB,CAAC,CAAC;IACvD,IAAI,CAAC,yBAAyB,CAAC,mCAAmC,CAAC,CAAC;AACtE,CAAC;AAED;;;;;GAKG;AACH,SAAgB,YAAY,CAE1B,QAAuB;IAEvB,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;IACxD,IAAI,CAAC,sBAAsB,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;AACxD,CAAC;AAED;;GAEG;AACH,SAAgB,WAAW;IACzB,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;IACxD,IAAI,CAAC,yBAAyB,CAAC,cAAc,CAAC,CAAC;AACjD,CAAC"}

package/build/lib/mixins/execute.d.ts

@@ -1,34 +1,45 @@
+import type { RemoteDebugger } from '../remote-debugger';
 /**
- * Execute a Selenium atom in Safari
+ * Executes a Selenium atom in Safari by generating the atom script and
+ * executing it in the page context.
  *
- * @this {RemoteDebugger}
- * @param {string} atom Name of Selenium atom (see atoms/ directory)
- * @param {any[]} args Arguments passed to the atom
- * @param {string[]} frames
- * @returns {Promise<any>} The result received from the atom
+ * @param atom - Name of the Selenium atom to execute (see atoms/ directory).
+ * @param args - Arguments to pass to the atom function. Defaults to empty array.
+ * @param frames - Frame context array for frame-specific execution. Defaults to empty array.
+ * @returns A promise that resolves to the result received from the atom execution.
  */
-export function executeAtom(this: import("../remote-debugger").RemoteDebugger, atom: string, args?: any[], frames?: string[]): Promise<any>;
+export declare function executeAtom(this: RemoteDebugger, atom: string, args?: any[], frames?: string[]): Promise<any>;
 /**
- * @this {RemoteDebugger}
- * @param {string} atom
- * @param {any[]} [args]
- * @param {string[]} [frames]
- * @returns {Promise<any>}
+ * Executes a Selenium atom asynchronously by creating a Promise in the page context
+ * and waiting for the atom to resolve it. Falls back to polling if Runtime.awaitPromise
+ * is not available.
+ *
+ * @param atom - Name of the Selenium atom to execute (see atoms/ directory).
+ * @param args - Arguments to pass to the atom function. Defaults to empty array.
+ *               If args[2] is provided, it will be used as the timeout in milliseconds.
+ * @param frames - Frame context array for frame-specific execution. Defaults to empty array.
+ * @returns A promise that resolves to the result received from the atom execution.
  */
-export function executeAtomAsync(this: import("../remote-debugger").RemoteDebugger, atom: string, args?: any[], frames?: string[]): Promise<any>;
+export declare function executeAtomAsync(this: RemoteDebugger, atom: string, args?: any[], frames?: string[]): Promise<any>;
 /**
- * @this {RemoteDebugger}
- * @param {string} command
- * @param {boolean} [override] - Deprecated and unused
- * @returns {Promise<any>}
+ * Executes a JavaScript command in the page context and returns the result.
+ * Optionally performs garbage collection before execution if configured.
+ *
+ * @param command - The JavaScript command string to execute.
+ * @param override - Deprecated and unused parameter.
+ * @returns A promise that resolves to the result of the JavaScript evaluation,
+ *          converted to a usable format.
  */
-export function execute(this: import("../remote-debugger").RemoteDebugger, command: string, override?: boolean): Promise<any>;
+export declare function execute(this: RemoteDebugger, command: string, override?: boolean): Promise<any>;
 /**
- * @this {RemoteDebugger}
- * @param {string} objectId
- * @param {any} fn
- * @param {any[]} [args]
+ * Calls a JavaScript function on a remote object identified by objectId.
+ * Optionally performs garbage collection before execution if configured.
+ *
+ * @param objectId - The object identifier of the remote object to call the function on.
+ * @param fn - The function declaration string to execute on the object.
+ * @param args - Optional array of arguments to pass to the function.
+ * @returns A promise that resolves to the result of the function call,
+ *          converted to a usable format.
  */
-export function callFunction(this: import("../remote-debugger").RemoteDebugger, objectId: string, fn: any, args?: any[]): Promise<any>;
-export type RemoteDebugger = import("../remote-debugger").RemoteDebugger;
+export declare function callFunction(this: RemoteDebugger, objectId: string, fn: string, args?: any[]): Promise<any>;
 //# sourceMappingURL=execute.d.ts.map

package/build/lib/mixins/execute.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../../lib/mixins/execute.js"],"names":[],"mappings":"AAoBA;;;;;;;;GAQG;AACH,qFALW,MAAM,SACN,GAAG,EAAE,WACL,MAAM,EAAE,GACN,OAAO,CAAC,GAAG,CAAC,CAQxB;AAED;;;;;;GAMG;AACH,0FALW,MAAM,SACN,GAAG,EAAE,WACL,MAAM,EAAE,GACN,OAAO,CAAC,GAAG,CAAC,CAoFxB;AAED;;;;;GAKG;AAEH,oFALW,MAAM,aACN,OAAO,GACL,OAAO,CAAC,GAAG,CAAC,CA0BxB;AAED;;;;;GAKG;AACH,0FAJW,MAAM,MACN,GAAG,SACH,GAAG,EAAE,gBAuBf;6BAGY,OAAO,oBAAoB,EAAE,cAAc"}
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../../lib/mixins/execute.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAMzD;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,cAAc,EACpB,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,GAAG,EAAO,EAChB,MAAM,GAAE,MAAM,EAAO,GACpB,OAAO,CAAC,GAAG,CAAC,CAQd;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,cAAc,EACpB,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,GAAG,EAAO,EAChB,MAAM,GAAE,MAAM,EAAO,GACpB,OAAO,CAAC,GAAG,CAAC,CAkFd;AAED;;;;;;;;GAQG;AAEH,wBAAsB,OAAO,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAuBrG;AAED;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,cAAc,EACpB,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,MAAM,EACV,IAAI,CAAC,EAAE,GAAG,EAAE,GACX,OAAO,CAAC,GAAG,CAAC,CAqBd"}

package/build/lib/mixins/execute.js

@@ -17,27 +17,33 @@ const property_accessors_1 = require("./property-accessors");
 /* How many milliseconds to wait for webkit to return a response before timing out */
 const RPC_RESPONSE_TIMEOUT_MS = 5000;
 /**
- * Execute a Selenium atom in Safari
+ * Executes a Selenium atom in Safari by generating the atom script and
+ * executing it in the page context.
  *
- * @this {RemoteDebugger}
- * @param {string} atom Name of Selenium atom (see atoms/ directory)
- * @param {any[]} args Arguments passed to the atom
- * @param {string[]} frames
- * @returns {Promise<any>} The result received from the atom
+ * @param atom - Name of the Selenium atom to execute (see atoms/ directory).
+ * @param args - Arguments to pass to the atom function. Defaults to empty array.
+ * @param frames - Frame context array for frame-specific execution. Defaults to empty array.
+ * @returns A promise that resolves to the result received from the atom execution.
  */
 async function executeAtom(atom, args = [], frames = []) {
     this.log.debug(`Executing atom '${atom}' with 'args=${JSON.stringify(args)}; frames=${frames}'`);
     const script = await (0, atoms_1.getScriptForAtom)(atom, args, frames);
     const value = await this.execute(script);
-    this.log.debug(`Received result for atom '${atom}' execution: ${lodash_1.default.truncate((0, utils_1.simpleStringify)(value), { length: utils_1.RESPONSE_LOG_LENGTH })}`);
+    this.log.debug(`Received result for atom '${atom}' execution: ${lodash_1.default.truncate((0, utils_1.simpleStringify)(value), {
+        length: utils_1.RESPONSE_LOG_LENGTH
+    })}`);
     return value;
 }
 /**
- * @this {RemoteDebugger}
- * @param {string} atom
- * @param {any[]} [args]
- * @param {string[]} [frames]
- * @returns {Promise<any>}
+ * Executes a Selenium atom asynchronously by creating a Promise in the page context
+ * and waiting for the atom to resolve it. Falls back to polling if Runtime.awaitPromise
+ * is not available.
+ *
+ * @param atom - Name of the Selenium atom to execute (see atoms/ directory).
+ * @param args - Arguments to pass to the atom function. Defaults to empty array.
+ *               If args[2] is provided, it will be used as the timeout in milliseconds.
+ * @param frames - Frame context array for frame-specific execution. Defaults to empty array.
+ * @returns A promise that resolves to the result received from the atom execution.
  */
 async function executeAtomAsync(atom, args = [], frames = []) {
     // helper to send directly to the web inspector
@@ -119,10 +125,13 @@ async function executeAtomAsync(atom, args = [], frames = []) {
     return (0, utils_1.convertJavascriptEvaluationResult)(res);
 }
 /**
- * @this {RemoteDebugger}
- * @param {string} command
- * @param {boolean} [override] - Deprecated and unused
- * @returns {Promise<any>}
+ * Executes a JavaScript command in the page context and returns the result.
+ * Optionally performs garbage collection before execution if configured.
+ *
+ * @param command - The JavaScript command string to execute.
+ * @param override - Deprecated and unused parameter.
+ * @returns A promise that resolves to the result of the JavaScript evaluation,
+ *          converted to a usable format.
  */
 // eslint-disable-next-line @typescript-eslint/no-unused-vars
 async function execute(command, override) {
@@ -134,9 +143,7 @@ async function execute(command, override) {
         await this.garbageCollect();
     }
     const rpcClient = this.requireRpcClient(true);
-    await rpcClient.waitForPage(
-    /** @type {import('../types').AppIdKey} */ (appIdKey), 
-    /** @type {import('../types').PageIdKey} */ (pageIdKey));
+    await rpcClient.waitForPage(appIdKey, pageIdKey);
     this.log.debug(`Sending javascript command: '${lodash_1.default.truncate(command, { length: 50 })}'`);
     const res = await rpcClient.send('Runtime.evaluate', {
         expression: command,
@@ -147,10 +154,14 @@ async function execute(command, override) {
     return (0, utils_1.convertJavascriptEvaluationResult)(res);
 }
 /**
- * @this {RemoteDebugger}
- * @param {string} objectId
- * @param {any} fn
- * @param {any[]} [args]
+ * Calls a JavaScript function on a remote object identified by objectId.
+ * Optionally performs garbage collection before execution if configured.
+ *
+ * @param objectId - The object identifier of the remote object to call the function on.
+ * @param fn - The function declaration string to execute on the object.
+ * @param args - Optional array of arguments to pass to the function.
+ * @returns A promise that resolves to the result of the function call,
+ *          converted to a usable format.
  */
 async function callFunction(objectId, fn, args) {
     const { appIdKey, pageIdKey } = (0, utils_1.checkParams)({
@@ -171,7 +182,4 @@ async function callFunction(objectId, fn, args) {
     });
     return (0, utils_1.convertJavascriptEvaluationResult)(res);
 }
-/**
- * @typedef {import('../remote-debugger').RemoteDebugger} RemoteDebugger
- */
 //# sourceMappingURL=execute.js.map

package/build/lib/mixins/execute.js.map

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

package/build/lib/mixins/message-handlers.d.ts

@@ -1,61 +1,81 @@
+import type { RemoteDebugger } from '../remote-debugger';
+import type { StringRecord } from '@appium/types';
 /**
- * @this {RemoteDebugger}
- * @param {Error?} err
- * @param {string} appIdKey
- * @param {Record<string, any>} pageDict
- * @returns {Promise<void>}
+ * Handles page change notifications from the remote debugger.
+ * Updates the page array for the specified application and emits a page change
+ * event if the pages have actually changed and navigation is not in progress.
+ *
+ * @param err - Error object if an error occurred, null or undefined otherwise.
+ * @param appIdKey - The application identifier key for which pages have changed.
+ * @param pageDict - Dictionary containing the new page information.
  */
-export function onPageChange(this: import("../remote-debugger").RemoteDebugger, err: Error | null, appIdKey: string, pageDict: Record<string, any>): Promise<void>;
+export declare function onPageChange(this: RemoteDebugger, err: Error | null | undefined, appIdKey: string, pageDict: StringRecord): Promise<void>;
 /**
- * @this {RemoteDebugger}
- * @param {Error?} err
- * @param {Record<string, any>} dict
- * @returns {Promise<void>}
+ * Handles notifications when a new application connects to the remote debugger.
+ * Updates the application dictionary with the new application information.
+ *
+ * @param err - Error object if an error occurred, null or undefined otherwise.
+ * @param dict - Dictionary containing the new application information including
+ *               the WIRApplicationIdentifierKey.
  */
-export function onAppConnect(this: import("../remote-debugger").RemoteDebugger, err: Error | null, dict: Record<string, any>): Promise<void>;
+export declare function onAppConnect(this: RemoteDebugger, err: Error | null | undefined, dict: StringRecord): Promise<void>;
 /**
- * @this {RemoteDebugger}
- * @param {Error?} err
- * @param {import('@appium/types').StringRecord} dict
- * @returns {void}
+ * Handles notifications when an application disconnects from the remote debugger.
+ * Removes the application from the dictionary and attempts to find a replacement
+ * if the disconnected app was the currently selected one. Emits a disconnect event
+ * if no applications remain.
+ *
+ * @param err - Error object if an error occurred, null or undefined otherwise.
+ * @param dict - Dictionary containing the disconnected application information
+ *               including the WIRApplicationIdentifierKey.
  */
-export function onAppDisconnect(this: import("../remote-debugger").RemoteDebugger, err: Error | null, dict: import("@appium/types").StringRecord): void;
+export declare function onAppDisconnect(this: RemoteDebugger, err: Error | null | undefined, dict: StringRecord): void;
 /**
- * @this {RemoteDebugger}
- * @param {Error?} err
- * @param {Record<string, any>} dict
- * @returns {Promise<void>}
+ * Handles notifications when an application's information is updated.
+ * Updates the application dictionary with the new information while preserving
+ * any existing page array data.
+ *
+ * @param err - Error object if an error occurred, null or undefined otherwise.
+ * @param dict - Dictionary containing the updated application information.
  */
-export function onAppUpdate(this: import("../remote-debugger").RemoteDebugger, err: Error | null, dict: Record<string, any>): Promise<void>;
+export declare function onAppUpdate(this: RemoteDebugger, err: Error | null | undefined, dict: StringRecord): Promise<void>;
 /**
- * @this {RemoteDebugger}
- * @param {Error?} err
- * @param {Record<string, any>} drivers
- * @returns {void}
+ * Handles notifications containing the list of connected drivers.
+ * Updates the internal connected drivers list with the received information.
+ *
+ * @param err - Error object if an error occurred, null or undefined otherwise.
+ * @param drivers - Dictionary containing the connected driver list with
+ *                  WIRDriverDictionaryKey.
  */
-export function onConnectedDriverList(this: import("../remote-debugger").RemoteDebugger, err: Error | null, drivers: Record<string, any>): void;
+export declare function onConnectedDriverList(this: RemoteDebugger, err: Error | null | undefined, drivers: StringRecord): void;
 /**
- * @this {RemoteDebugger}
- * @param {Error?} err
- * @param {Record<string, any>} state
- * @returns {void}
+ * Handles notifications about the current automation availability state.
+ * This state changes when 'Remote Automation' setting in Safari's advanced settings
+ * is toggled. The state can be either WIRAutomationAvailabilityAvailable or
+ * WIRAutomationAvailabilityNotAvailable.
+ *
+ * @param err - Error object if an error occurred, null or undefined otherwise.
+ * @param state - Dictionary containing the automation availability state with
+ *                WIRAutomationAvailabilityKey.
  */
-export function onCurrentState(this: import("../remote-debugger").RemoteDebugger, err: Error | null, state: Record<string, any>): void;
+export declare function onCurrentState(this: RemoteDebugger, err: Error | null | undefined, state: StringRecord): void;
 /**
- * @this {RemoteDebugger}
- * @param {Error?} err
- * @param {Record<string, any>} apps
- * @returns {Promise<void>}
+ * Handles notifications containing the list of connected applications.
+ * Translates the received information into the application dictionary format,
+ * filtering out any applications that are in the skipped apps list.
+ *
+ * @param err - Error object if an error occurred, null or undefined otherwise.
+ * @param apps - Dictionary containing the connected applications list.
  */
-export function onConnectedApplicationList(this: import("../remote-debugger").RemoteDebugger, err: Error | null, apps: Record<string, any>): Promise<void>;
+export declare function onConnectedApplicationList(this: RemoteDebugger, err: Error | null | undefined, apps: StringRecord): Promise<void>;
 /**
- * Given a bundle id, finds the correct remote debugger app that is
- * connected.
+ * Given a bundle ID, finds the correct remote debugger app identifier key
+ * that is currently connected. Also handles proxy applications that may act
+ * on behalf of the requested bundle ID.
  *
- * @this {RemoteDebugger}
- * @param {string} bundleId
- * @returns {string|undefined}
+ * @param bundleId - The bundle identifier to search for.
+ * @returns The application identifier key if found, undefined otherwise.
+ *          If a proxy application is found, returns the proxy's app ID instead.
  */
-export function getDebuggerAppKey(this: import("../remote-debugger").RemoteDebugger, bundleId: string): string | undefined;
-export type RemoteDebugger = import("../remote-debugger").RemoteDebugger;
+export declare function getDebuggerAppKey(this: RemoteDebugger, bundleId: string): string | undefined;
 //# sourceMappingURL=message-handlers.d.ts.map

package/build/lib/mixins/message-handlers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"message-handlers.d.ts","sourceRoot":"","sources":["../../../lib/mixins/message-handlers.js"],"names":[],"mappings":"AAsBA;;;;;;GAMG;AACH,qFALW,KAAK,OAAC,YACN,MAAM,YACN,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACjB,OAAO,CAAC,IAAI,CAAC,CAmCzB;AAED;;;;;GAKG;AACH,qFAJW,KAAK,OAAC,QACN,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACjB,OAAO,CAAC,IAAI,CAAC,CAMzB;AAED;;;;;GAKG;AACH,wFAJW,KAAK,OAAC,QACN,OAAO,eAAe,EAAE,YAAY,GAClC,IAAI,CAsBhB;AAED;;;;;GAKG;AACH,oFAJW,KAAK,OAAC,QACN,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACjB,OAAO,CAAC,IAAI,CAAC,CAKzB;AAED;;;;;GAKG;AACH,8FAJW,KAAK,OAAC,WACN,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACjB,IAAI,CAKhB;AAED;;;;;GAKG;AACH,uFAJW,KAAK,OAAC,SACN,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACjB,IAAI,CAOhB;AAED;;;;;GAKG;AACH,mGAJW,KAAK,OAAC,QACN,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACjB,OAAO,CAAC,IAAI,CAAC,CAiBzB;AAwBD;;;;;;;GAOG;AACH,+FAHW,MAAM,GACJ,MAAM,GAAC,SAAS,CA6B5B;6BAGY,OAAO,oBAAoB,EAAE,cAAc"}
+{"version":3,"file":"message-handlers.d.ts","sourceRoot":"","sources":["../../../lib/mixins/message-handlers.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAQlD;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,cAAc,EACpB,GAAG,EAAE,KAAK,GAAG,IAAI,GAAG,SAAS,EAC7B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,YAAY,GACrB,OAAO,CAAC,IAAI,CAAC,CAiCf;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,cAAc,EACpB,GAAG,EAAE,KAAK,GAAG,IAAI,GAAG,SAAS,EAC7B,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,IAAI,CAAC,CAIf;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,cAAc,EACpB,GAAG,EAAE,KAAK,GAAG,IAAI,GAAG,SAAS,EAC7B,IAAI,EAAE,YAAY,GACjB,IAAI,CAoBN;AAED;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,cAAc,EACpB,GAAG,EAAE,KAAK,GAAG,IAAI,GAAG,SAAS,EAC7B,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,IAAI,CAAC,CAGf;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,cAAc,EACpB,GAAG,EAAE,KAAK,GAAG,IAAI,GAAG,SAAS,EAC7B,OAAO,EAAE,YAAY,GACpB,IAAI,CAGN;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,cAAc,EACpB,GAAG,EAAE,KAAK,GAAG,IAAI,GAAG,SAAS,EAC7B,KAAK,EAAE,YAAY,GAClB,IAAI,CAKN;AAED;;;;;;;GAOG;AACH,wBAAsB,0BAA0B,CAC9C,IAAI,EAAE,cAAc,EACpB,GAAG,EAAE,KAAK,GAAG,IAAI,GAAG,SAAS,EAC7B,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,IAAI,CAAC,CAef;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CA2B5F"}