appium-remote-debugger 15.2.10 → 15.2.11

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [15.2.11](https://github.com/appium/appium-remote-debugger/compare/v15.2.10...v15.2.11) (2026-01-21)
+
+### Miscellaneous Chores
+
+* Migrate the rest of mixins to typescript ([#465](https://github.com/appium/appium-remote-debugger/issues/465)) ([1588bf9](https://github.com/appium/appium-remote-debugger/commit/1588bf90c85ac165f563353cacd03e6b85efd66b))
+
 ## [15.2.10](https://github.com/appium/appium-remote-debugger/compare/v15.2.9...v15.2.10) (2026-01-20)
 
 ### Miscellaneous Chores

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

@@ -1,23 +1,27 @@
+import type { RemoteDebugger } from '../remote-debugger';
+import type { StringRecord } from '@appium/types';
 /**
+ * Retrieves all cookies for the current page by sending a Page.getCookies
+ * command to the remote debugger.
  *
- * @this {RemoteDebugger}
- * @returns {Promise<import('@appium/types').StringRecord>}
+ * @returns A promise that resolves to a dictionary containing the cookies.
  */
-export function getCookies(this: import("../remote-debugger").RemoteDebugger): Promise<import("@appium/types").StringRecord>;
+export declare function getCookies(this: RemoteDebugger): Promise<StringRecord>;
 /**
+ * Sets a cookie on the current page by sending a Page.setCookie command
+ * to the remote debugger.
  *
- * @this {RemoteDebugger}
- * @param {import('@appium/types').StringRecord} cookie
- * @returns {Promise<any>}
+ * @param cookie - Dictionary containing the cookie properties to set.
+ * @returns A promise that resolves when the cookie has been set.
  */
-export function setCookie(this: import("../remote-debugger").RemoteDebugger, cookie: import("@appium/types").StringRecord): Promise<any>;
+export declare function setCookie(this: RemoteDebugger, cookie: StringRecord): Promise<any>;
 /**
+ * Deletes a cookie from the current page by sending a Page.deleteCookie
+ * command to the remote debugger.
  *
- * @this {RemoteDebugger}
- * @param {string} cookieName
- * @param {string} url
- * @returns {Promise<any>}
+ * @param cookieName - The name of the cookie to delete.
+ * @param url - The URL associated with the cookie to delete.
+ * @returns A promise that resolves when the cookie has been deleted.
  */
-export function deleteCookie(this: import("../remote-debugger").RemoteDebugger, cookieName: string, url: string): Promise<any>;
-export type RemoteDebugger = import("../remote-debugger").RemoteDebugger;
+export declare function deleteCookie(this: RemoteDebugger, cookieName: string, url: string): Promise<any>;
 //# sourceMappingURL=cookies.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"cookies.d.ts","sourceRoot":"","sources":["../../../lib/mixins/cookies.js"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,+EAFa,OAAO,CAAC,OAAO,eAAe,EAAE,YAAY,CAAC,CAQzD;AAED;;;;;GAKG;AACH,qFAHW,OAAO,eAAe,EAAE,YAAY,GAClC,OAAO,CAAC,GAAG,CAAC,CASxB;AAED;;;;;;GAMG;AACH,4FAJW,MAAM,OACN,MAAM,GACJ,OAAO,CAAC,GAAG,CAAC,CAUxB;6BAGY,OAAO,oBAAoB,EAAE,cAAc"}
+{"version":3,"file":"cookies.d.ts","sourceRoot":"","sources":["../../../lib/mixins/cookies.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC,CAM5E;AAED;;;;;;GAMG;AACH,wBAAsB,SAAS,CAC7B,IAAI,EAAE,cAAc,EACpB,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,GAAG,CAAC,CAOd;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,cAAc,EACpB,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,GAAG,CAAC,CAQd"}

package/build/lib/mixins/cookies.js

@@ -5,9 +5,10 @@ exports.setCookie = setCookie;
 exports.deleteCookie = deleteCookie;
 const property_accessors_1 = require("./property-accessors");
 /**
+ * Retrieves all cookies for the current page by sending a Page.getCookies
+ * command to the remote debugger.
  *
- * @this {RemoteDebugger}
- * @returns {Promise<import('@appium/types').StringRecord>}
+ * @returns A promise that resolves to a dictionary containing the cookies.
  */
 async function getCookies() {
     this.log.debug('Getting cookies');
@@ -17,10 +18,11 @@ async function getCookies() {
     });
 }
 /**
+ * Sets a cookie on the current page by sending a Page.setCookie command
+ * to the remote debugger.
  *
- * @this {RemoteDebugger}
- * @param {import('@appium/types').StringRecord} cookie
- * @returns {Promise<any>}
+ * @param cookie - Dictionary containing the cookie properties to set.
+ * @returns A promise that resolves when the cookie has been set.
  */
 async function setCookie(cookie) {
     this.log.debug('Setting cookie');
@@ -31,11 +33,12 @@ async function setCookie(cookie) {
     });
 }
 /**
+ * Deletes a cookie from the current page by sending a Page.deleteCookie
+ * command to the remote debugger.
  *
- * @this {RemoteDebugger}
- * @param {string} cookieName
- * @param {string} url
- * @returns {Promise<any>}
+ * @param cookieName - The name of the cookie to delete.
+ * @param url - The URL associated with the cookie to delete.
+ * @returns A promise that resolves when the cookie has been deleted.
  */
 async function deleteCookie(cookieName, url) {
     this.log.debug(`Deleting cookie '${cookieName}' on '${url}'`);
@@ -46,7 +49,4 @@ async function deleteCookie(cookieName, url) {
         url,
     });
 }
-/**
- * @typedef {import('../remote-debugger').RemoteDebugger} RemoteDebugger
- */
 //# sourceMappingURL=cookies.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"cookies.js","sourceRoot":"","sources":["../../../lib/mixins/cookies.js"],"names":[],"mappings":";;AAUA,gCAMC;AAQD,8BAOC;AASD,oCAQC;AAhDD,6DAG8B;AAE9B;;;;GAIG;AACI,KAAK,UAAU,UAAU;IAC9B,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;IAClC,OAAO,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC,IAAI,CAAC,iBAAiB,EAAE;QAC3D,QAAQ,EAAE,IAAA,gCAAW,EAAC,IAAI,CAAC;QAC3B,SAAS,EAAE,IAAA,iCAAY,EAAC,IAAI,CAAC;KAC9B,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACI,KAAK,UAAU,SAAS,CAAE,MAAM;IACrC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IACjC,OAAO,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC,IAAI,CAAC,gBAAgB,EAAE;QAC1D,QAAQ,EAAE,IAAA,gCAAW,EAAC,IAAI,CAAC;QAC3B,SAAS,EAAE,IAAA,iCAAY,EAAC,IAAI,CAAC;QAC7B,MAAM;KACP,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACI,KAAK,UAAU,YAAY,CAAE,UAAU,EAAE,GAAG;IACjD,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,oBAAoB,UAAU,SAAS,GAAG,GAAG,CAAC,CAAC;IAC9D,OAAO,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC,IAAI,CAAC,mBAAmB,EAAE;QAC7D,QAAQ,EAAE,IAAA,gCAAW,EAAC,IAAI,CAAC;QAC3B,SAAS,EAAE,IAAA,iCAAY,EAAC,IAAI,CAAC;QAC7B,UAAU;QACV,GAAG;KACJ,CAAC,CAAC;AACL,CAAC;AAED;;GAEG"}
+{"version":3,"file":"cookies.js","sourceRoot":"","sources":["../../../lib/mixins/cookies.ts"],"names":[],"mappings":";;AAaA,gCAMC;AASD,8BAUC;AAUD,oCAYC;AA5DD,6DAG8B;AAI9B;;;;;GAKG;AACI,KAAK,UAAU,UAAU;IAC9B,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;IAClC,OAAO,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC,IAAI,CAAC,iBAAiB,EAAE;QAC3D,QAAQ,EAAE,IAAA,gCAAW,EAAC,IAAI,CAAC;QAC3B,SAAS,EAAE,IAAA,iCAAY,EAAC,IAAI,CAAC;KAC9B,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACI,KAAK,UAAU,SAAS,CAE7B,MAAoB;IAEpB,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IACjC,OAAO,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC,IAAI,CAAC,gBAAgB,EAAE;QAC1D,QAAQ,EAAE,IAAA,gCAAW,EAAC,IAAI,CAAC;QAC3B,SAAS,EAAE,IAAA,iCAAY,EAAC,IAAI,CAAC;QAC7B,MAAM;KACP,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;GAOG;AACI,KAAK,UAAU,YAAY,CAEhC,UAAkB,EAClB,GAAW;IAEX,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,oBAAoB,UAAU,SAAS,GAAG,GAAG,CAAC,CAAC;IAC9D,OAAO,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC,IAAI,CAAC,mBAAmB,EAAE;QAC7D,QAAQ,EAAE,IAAA,gCAAW,EAAC,IAAI,CAAC;QAC3B,SAAS,EAAE,IAAA,iCAAY,EAAC,IAAI,CAAC;QAC7B,UAAU;QACV,GAAG;KACJ,CAAC,CAAC;AACL,CAAC"}

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/misc.d.ts

@@ -1,37 +1,47 @@
+import type { RemoteDebugger } from '../remote-debugger';
 /**
- * @this {RemoteDebugger}
- * @returns {Promise<void>}
+ * Launches Safari application on the device by sending a launch command
+ * to the remote debugger.
  */
-export function launchSafari(this: import("../remote-debugger").RemoteDebugger): Promise<void>;
+export declare function launchSafari(this: RemoteDebugger): Promise<void>;
 /**
- * @this {RemoteDebugger}
- * @param {import('../types').EventListener} fn
- * @returns {Promise<any>}
+ * Starts recording the timeline by registering an event listener and
+ * sending the Timeline.start command to the remote debugger.
+ *
+ * @param fn - Event listener function that will be called when timeline events are recorded.
+ * @returns A promise that resolves when the timeline recording has started.
  */
-export function startTimeline(this: import("../remote-debugger").RemoteDebugger, fn: import("../types").EventListener): Promise<any>;
+export declare function startTimeline(this: RemoteDebugger, fn: import('../types').EventListener): Promise<any>;
 /**
- * @this {RemoteDebugger}
- * @returns {Promise<any>}
+ * Stops recording the timeline by sending the Timeline.stop command
+ * to the remote debugger.
  */
-export function stopTimeline(this: import("../remote-debugger").RemoteDebugger): Promise<any>;
+export declare function stopTimeline(this: RemoteDebugger): Promise<any>;
 /**
- * @this {RemoteDebugger}
- * @param {string} value
- * @returns {Promise<any>}
+ * Overrides the user agent string for the current page.
+ * Note: This may not work for mobile Safari.
+ *
+ * @param value - The user agent string to set.
+ * @returns A promise that resolves when the user agent has been overridden.
  */
-export function overrideUserAgent(this: import("../remote-debugger").RemoteDebugger, value: string): Promise<any>;
+export declare function overrideUserAgent(this: RemoteDebugger, value: string): Promise<any>;
 /**
- * @this {RemoteDebugger}
- * @param {number} [timeoutMs=1000] The maximum amount of milliseconds to wait for
- * a javascript command response
- * @returns {Promise<boolean>} Whether the current page responds to javascript commands
+ * Checks whether JavaScript execution is currently blocked on the page
+ * by attempting to execute a simple JavaScript command with a timeout.
+ *
+ * @param timeoutMs - The maximum amount of milliseconds to wait for a JavaScript
+ *                    command response. Defaults to 1000ms.
+ * @returns A promise that resolves to true if JavaScript execution is blocked,
+ *          false if it is not blocked.
  */
-export function isJavascriptExecutionBlocked(this: import("../remote-debugger").RemoteDebugger, timeoutMs?: number): Promise<boolean>;
+export declare function isJavascriptExecutionBlocked(this: RemoteDebugger, timeoutMs?: number): Promise<boolean>;
 /**
- * @this {RemoteDebugger}
- * @param {number} [timeoutMs=GARBAGE_COLLECT_TIMEOUT_MS]
- * @returns {Promise<void>}
+ * Triggers garbage collection on the page's JavaScript heap.
+ * This method will gracefully handle cases where garbage collection cannot
+ * be performed (e.g., when not connected to a page).
+ *
+ * @param timeoutMs - Maximum time in milliseconds to wait for garbage collection
+ *                    to complete. Defaults to GARBAGE_COLLECT_TIMEOUT_MS (5000ms).
  */
-export function garbageCollect(this: import("../remote-debugger").RemoteDebugger, timeoutMs?: number): Promise<void>;
-export type RemoteDebugger = import("../remote-debugger").RemoteDebugger;
+export declare function garbageCollect(this: RemoteDebugger, timeoutMs?: number): Promise<void>;
 //# sourceMappingURL=misc.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"misc.d.ts","sourceRoot":"","sources":["../../../lib/mixins/misc.js"],"names":[],"mappings":"AAUA;;;GAGG;AACH,iFAFa,OAAO,CAAC,IAAI,CAAC,CAMzB;AAED;;;;GAIG;AACH,qFAHW,OAAO,UAAU,EAAE,aAAa,GAC9B,OAAO,CAAC,GAAG,CAAC,CASxB;AAED;;;GAGG;AACH,iFAFa,OAAO,CAAC,GAAG,CAAC,CAQxB;AAGD;;;;GAIG;AACH,4FAHW,MAAM,GACJ,OAAO,CAAC,GAAG,CAAC,CASxB;AAED;;;;;GAKG;AACH,4GAJW,MAAM,GAEJ,OAAO,CAAC,OAAO,CAAC,CAgB5B;AAED;;;;GAIG;AACH,8FAHW,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CA8BzB;6BAGY,OAAO,oBAAoB,EAAE,cAAc"}
+{"version":3,"file":"misc.d.ts","sourceRoot":"","sources":["../../../lib/mixins/misc.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAKzD;;;GAGG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAItE;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,cAAc,EACpB,EAAE,EAAE,OAAO,UAAU,EAAE,aAAa,GACnC,OAAO,CAAC,GAAG,CAAC,CAOd;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,CAMrE;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAOzF;AAED;;;;;;;;GAQG;AACH,wBAAsB,4BAA4B,CAChD,IAAI,EAAE,cAAc,EACpB,SAAS,GAAE,MAAa,GACvB,OAAO,CAAC,OAAO,CAAC,CAclB;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,cAAc,EACpB,SAAS,GAAE,MAAmC,GAC7C,OAAO,CAAC,IAAI,CAAC,CA4Bf"}