appium-remote-debugger 15.9.1 → 15.10.0

package/build/lib/utils.d.ts

@@ -1,167 +0,0 @@
-import type { StringRecord } from '@appium/types';
-import type { AppInfo, AppDict, Page } from './types';
-export declare const WEB_CONTENT_BUNDLE_ID = "com.apple.WebKit.WebContent";
-export declare const RESPONSE_LOG_LENGTH = 100;
-export type CancellableDelay = Promise<void> & {
-    cancel: () => void;
-};
-/**
- * Thrown when a cancellable delay is cancelled.
- */
-export declare class DelayCancellation extends Error {
-    constructor(message?: string);
-}
-/**
- * Error thrown when an async operation exceeds the configured timeout.
- */
-export declare class TimeoutError extends Error {
-    constructor(message?: string);
-}
-/**
- * Truncates a string to the requested length and appends ellipsis when needed.
- *
- * @param value - The input string.
- * @param length - Maximum output length.
- * @returns The original string when short enough, otherwise a truncated variant.
- */
-export declare function truncateString(value: string, length: number): string;
-/**
- * Creates a shallow object where undefined keys from `target` are filled
- * from `defaultsObj`.
- *
- * @param target - The object with priority values.
- * @param defaultsObj - The object providing fallback values.
- * @returns A new object containing merged defaulted values.
- */
-export declare function defaults<T extends Record<string, any>, U extends Record<string, any>>(target: T, defaultsObj: U): T & U;
-/**
- * Determines whether a value is a plain object.
- *
- * @param value - The value to check.
- * @returns True when the value is a non-null non-array object.
- */
-export declare function isPlainObject(value: unknown): value is Record<string, any>;
-/**
- * Checks whether a value should be treated as empty.
- *
- * @param value - The value to evaluate.
- * @returns True for nullish values, empty arrays/strings/maps/sets, or empty objects.
- */
-export declare function isEmpty(value: unknown): boolean;
-/**
- * Deduplicates array entries while preserving order.
- *
- * @param items - Items to deduplicate.
- * @returns The input items without duplicates.
- */
-export declare function uniq<T>(items: T[]): T[];
-/**
- * Performs deep strict equality comparison.
- *
- * @param a - First value.
- * @param b - Second value.
- * @returns True when both values are deeply equal.
- */
-export declare function deepEqual(a: unknown, b: unknown): boolean;
-/**
- * Returns a promise that resolves after the specified delay.
- *
- * @param ms - Delay in milliseconds.
- * @returns A promise that resolves when the delay expires.
- */
-export declare function delay(ms: number): Promise<void>;
-/**
- * Returns a delay promise with a `cancel` method that rejects the promise.
- *
- * @param ms - Delay in milliseconds.
- * @returns A cancellable delay promise.
- */
-export declare function cancellableDelay(ms: number): CancellableDelay;
-/**
- * Wraps a promise with a timeout.
- *
- * @param promise - The promise to resolve.
- * @param timeoutMs - Maximum time to wait in milliseconds.
- * @param message - Optional timeout message.
- * @returns A promise that resolves/rejects with the original promise result, or rejects on timeout.
- */
-export declare function withTimeout<T>(promise: Promise<T>, timeoutMs: number, message?: string): Promise<T>;
-/**
- * Takes a dictionary from the remote debugger and converts it into a more
- * manageable AppInfo object with understandable keys.
- *
- * @param dict - Dictionary from the remote debugger containing application information.
- * @returns A tuple containing the application ID and the AppInfo object.
- */
-export declare function appInfoFromDict(dict: Record<string, any>): [string, AppInfo];
-/**
- * Takes a dictionary from the remote debugger and converts it into an array
- * of Page objects with understandable keys. Filters out non-web pages.
- *
- * @param pageDict - Dictionary from the remote debugger containing page information.
- * @returns An array of Page objects representing the available pages.
- */
-export declare function pageArrayFromDict(pageDict: StringRecord): Page[];
-/**
- * Finds all application identifier keys that match the given bundle ID.
- * If no matches are found and the bundle ID is not WEB_CONTENT_BUNDLE_ID,
- * falls back to searching for WEB_CONTENT_BUNDLE_ID.
- *
- * @param bundleId - The bundle identifier to search for.
- * @param appDict - The application dictionary to search in.
- * @returns An array of unique application identifier keys matching the bundle ID.
- */
-export declare function appIdsForBundle(bundleId: string, appDict: AppDict): string[];
-/**
- * Validates that all parameters in the provided object have non-nil values.
- * Throws an error if any parameters are missing (null or undefined).
- *
- * @template T - The type of the parameters object.
- * @param params - An object containing parameters to validate.
- * @returns The same parameters object if all values are valid.
- * @throws Error if any parameters are missing, listing all missing parameter names.
- */
-export declare function checkParams<T extends StringRecord>(params: T): T;
-/**
- * Converts a value to a best-effort JSON string for logging, removing noisy
- * function properties from cloneable objects when possible.
- *
- * Falls back to `String(value)` when JSON serialization returns `undefined`
- * or throws (for example, for functions, symbols, or circular structures).
- *
- * @param value - The value to stringify.
- * @param multiline - If true, formats JSON output with indentation. Defaults to false.
- * @returns A string representation suitable for logging.
- */
-export declare function simpleStringify(value: any, multiline?: boolean): string;
-/**
- * Converts the result from a JavaScript evaluation in the remote debugger
- * into a usable format. Handles errors, serialization, and cleans up noisy
- * function properties.
- *
- * @param res - The raw result from the remote debugger's JavaScript evaluation.
- * @returns The cleaned and converted result value.
- * @throws Error if the result is undefined, has an unexpected type, or contains
- *               an error status code.
- */
-export declare function convertJavascriptEvaluationResult(res: any): any;
-/**
- * Calculates and memoizes the path to the current module root.
- *
- * @returns The full path to the module root directory.
- * @throws Error if the module root folder cannot be determined.
- */
-export declare function getModuleRoot(): string;
-/**
- * Reads and parses the package.json file from the module root.
- *
- * @returns The parsed package.json contents as a StringRecord.
- */
-export declare function getModuleProperties(): StringRecord;
-/**
- * Determines if the WebInspector shim can be used based on the provided iOS platform version.
- * @param platformVersion - The iOS platform version string (e.g., "18.0", "17.5.1")
- * @returns true if the WebInspector shim can be used, false otherwise
- */
-export declare function canUseWebInspectorShim(platformVersion: string): boolean;
-//# sourceMappingURL=utils.d.ts.map

package/build/lib/utils.d.ts.map

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

package/build/lib/utils.js

@@ -1,422 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TimeoutError = exports.DelayCancellation = exports.RESPONSE_LOG_LENGTH = exports.WEB_CONTENT_BUNDLE_ID = void 0;
-exports.truncateString = truncateString;
-exports.defaults = defaults;
-exports.isPlainObject = isPlainObject;
-exports.isEmpty = isEmpty;
-exports.uniq = uniq;
-exports.deepEqual = deepEqual;
-exports.delay = delay;
-exports.cancellableDelay = cancellableDelay;
-exports.withTimeout = withTimeout;
-exports.appInfoFromDict = appInfoFromDict;
-exports.pageArrayFromDict = pageArrayFromDict;
-exports.appIdsForBundle = appIdsForBundle;
-exports.checkParams = checkParams;
-exports.simpleStringify = simpleStringify;
-exports.convertJavascriptEvaluationResult = convertJavascriptEvaluationResult;
-exports.getModuleRoot = getModuleRoot;
-exports.getModuleProperties = getModuleProperties;
-exports.canUseWebInspectorShim = canUseWebInspectorShim;
-const base_driver_1 = require("@appium/base-driver");
-const support_1 = require("@appium/support");
-const node_util_1 = require("node:util");
-const node_fs_1 = __importDefault(require("node:fs"));
-const node_path_1 = __importDefault(require("node:path"));
-const MODULE_NAME = 'appium-remote-debugger';
-exports.WEB_CONTENT_BUNDLE_ID = 'com.apple.WebKit.WebContent';
-const INACTIVE_APP_CODE = 0;
-// values for the page `WIRTypeKey` entry
-const ACCEPTED_PAGE_TYPES = [
-    'WIRTypeWeb', // up to iOS 11.3
-    'WIRTypeWebPage', // iOS 11.4
-    'WIRTypePage', // iOS 11.4 webview
-];
-exports.RESPONSE_LOG_LENGTH = 100;
-/**
- * Thrown when a cancellable delay is cancelled.
- */
-class DelayCancellation extends Error {
-    constructor(message = 'Delay cancelled') {
-        super(message);
-        this.name = 'DelayCancellation';
-    }
-}
-exports.DelayCancellation = DelayCancellation;
-/**
- * Error thrown when an async operation exceeds the configured timeout.
- */
-class TimeoutError extends Error {
-    constructor(message = 'Operation timed out') {
-        super(message);
-        this.name = 'TimeoutError';
-    }
-}
-exports.TimeoutError = TimeoutError;
-/**
- * Truncates a string to the requested length and appends ellipsis when needed.
- *
- * @param value - The input string.
- * @param length - Maximum output length.
- * @returns The original string when short enough, otherwise a truncated variant.
- */
-function truncateString(value, length) {
-    if (value.length <= length) {
-        return value;
-    }
-    return `${value.slice(0, Math.max(0, length - 1))}…`;
-}
-/**
- * Creates a shallow object where undefined keys from `target` are filled
- * from `defaultsObj`.
- *
- * @param target - The object with priority values.
- * @param defaultsObj - The object providing fallback values.
- * @returns A new object containing merged defaulted values.
- */
-function defaults(target, defaultsObj) {
-    const result = { ...target };
-    for (const [key, value] of Object.entries(defaultsObj)) {
-        if (result[key] === undefined) {
-            result[key] = value;
-        }
-    }
-    return result;
-}
-/**
- * Determines whether a value is a plain object.
- *
- * @param value - The value to check.
- * @returns True when the value is a non-null non-array object.
- */
-function isPlainObject(value) {
-    if (value == null || typeof value !== 'object' || Array.isArray(value)) {
-        return false;
-    }
-    const prototype = Object.getPrototypeOf(value);
-    return prototype === Object.prototype || prototype === null;
-}
-/**
- * Checks whether a value should be treated as empty.
- *
- * @param value - The value to evaluate.
- * @returns True for nullish values, empty arrays/strings/maps/sets, or empty objects.
- */
-function isEmpty(value) {
-    if (value == null) {
-        return true;
-    }
-    if (Array.isArray(value) || typeof value === 'string') {
-        return value.length === 0;
-    }
-    if (value instanceof Map || value instanceof Set) {
-        return value.size === 0;
-    }
-    if (isPlainObject(value)) {
-        return Object.keys(value).length === 0;
-    }
-    return false;
-}
-/**
- * Deduplicates array entries while preserving order.
- *
- * @param items - Items to deduplicate.
- * @returns The input items without duplicates.
- */
-function uniq(items) {
-    return [...new Set(items)];
-}
-/**
- * Performs deep strict equality comparison.
- *
- * @param a - First value.
- * @param b - Second value.
- * @returns True when both values are deeply equal.
- */
-function deepEqual(a, b) {
-    return (0, node_util_1.isDeepStrictEqual)(a, b);
-}
-/**
- * Returns a promise that resolves after the specified delay.
- *
- * @param ms - Delay in milliseconds.
- * @returns A promise that resolves when the delay expires.
- */
-function delay(ms) {
-    return new Promise((resolve) => setTimeout(resolve, ms));
-}
-/**
- * Returns a delay promise with a `cancel` method that rejects the promise.
- *
- * @param ms - Delay in milliseconds.
- * @returns A cancellable delay promise.
- */
-function cancellableDelay(ms) {
-    let timeoutId;
-    let rejectFn;
-    const promise = new Promise((resolve, reject) => {
-        rejectFn = reject;
-        timeoutId = setTimeout(resolve, ms);
-    });
-    promise.cancel = () => {
-        if (timeoutId) {
-            clearTimeout(timeoutId);
-            timeoutId = undefined;
-        }
-        rejectFn?.(new DelayCancellation());
-        rejectFn = undefined;
-    };
-    return promise;
-}
-/**
- * Wraps a promise with a timeout.
- *
- * @param promise - The promise to resolve.
- * @param timeoutMs - Maximum time to wait in milliseconds.
- * @param message - Optional timeout message.
- * @returns A promise that resolves/rejects with the original promise result, or rejects on timeout.
- */
-async function withTimeout(promise, timeoutMs, message) {
-    let timeoutId;
-    try {
-        return await Promise.race([
-            promise,
-            new Promise((_resolve, reject) => {
-                timeoutId = setTimeout(() => reject(new TimeoutError(message ?? `Operation timed out after ${timeoutMs}ms`)), timeoutMs);
-            }),
-        ]);
-    }
-    finally {
-        if (timeoutId) {
-            clearTimeout(timeoutId);
-        }
-    }
-}
-/**
- * Takes a dictionary from the remote debugger and converts it into a more
- * manageable AppInfo object with understandable keys.
- *
- * @param dict - Dictionary from the remote debugger containing application information.
- * @returns A tuple containing the application ID and the AppInfo object.
- */
-function appInfoFromDict(dict) {
-    const id = dict.WIRApplicationIdentifierKey;
-    const isProxy = typeof dict.WIRIsApplicationProxyKey === 'string'
-        ? dict.WIRIsApplicationProxyKey.toLowerCase() === 'true'
-        : dict.WIRIsApplicationProxyKey;
-    // automation enabled can be either from the keys
-    //   - WIRRemoteAutomationEnabledKey (boolean)
-    //   - WIRAutomationAvailabilityKey (string or boolean)
-    let isAutomationEnabled = !!dict.WIRRemoteAutomationEnabledKey;
-    if (Object.hasOwn(dict, 'WIRAutomationAvailabilityKey')) {
-        if (typeof dict.WIRAutomationAvailabilityKey === 'string') {
-            isAutomationEnabled =
-                dict.WIRAutomationAvailabilityKey === 'WIRAutomationAvailabilityUnknown'
-                    ? 'Unknown'
-                    : dict.WIRAutomationAvailabilityKey === 'WIRAutomationAvailabilityAvailable';
-        }
-        else {
-            isAutomationEnabled = !!dict.WIRAutomationAvailabilityKey;
-        }
-    }
-    const entry = {
-        id,
-        isProxy,
-        name: dict.WIRApplicationNameKey,
-        bundleId: dict.WIRApplicationBundleIdentifierKey,
-        hostId: dict.WIRHostApplicationIdentifierKey,
-        isActive: dict.WIRIsApplicationActiveKey !== INACTIVE_APP_CODE,
-        isAutomationEnabled,
-    };
-    return [id, entry];
-}
-/**
- * Takes a dictionary from the remote debugger and converts it into an array
- * of Page objects with understandable keys. Filters out non-web pages.
- *
- * @param pageDict - Dictionary from the remote debugger containing page information.
- * @returns An array of Page objects representing the available pages.
- */
-function pageArrayFromDict(pageDict) {
-    return (Object.values(pageDict)
-        // count only WIRTypeWeb pages and ignore all others (WIRTypeJavaScript etc)
-        .filter((dict) => dict.WIRTypeKey === undefined || ACCEPTED_PAGE_TYPES.includes(dict.WIRTypeKey))
-        .map((dict) => ({
-        id: dict.WIRPageIdentifierKey,
-        title: dict.WIRTitleKey,
-        url: dict.WIRURLKey,
-        isKey: dict.WIRConnectionIdentifierKey !== undefined,
-    })));
-}
-/**
- * Finds all application identifier keys that match the given bundle ID.
- * If no matches are found and the bundle ID is not WEB_CONTENT_BUNDLE_ID,
- * falls back to searching for WEB_CONTENT_BUNDLE_ID.
- *
- * @param bundleId - The bundle identifier to search for.
- * @param appDict - The application dictionary to search in.
- * @returns An array of unique application identifier keys matching the bundle ID.
- */
-function appIdsForBundle(bundleId, appDict) {
-    const appIds = Object.entries(appDict)
-        .filter(([, data]) => data.bundleId === bundleId)
-        .map(([key]) => key);
-    // if nothing is found, try to get the generic app
-    if (appIds.length === 0 && bundleId !== exports.WEB_CONTENT_BUNDLE_ID) {
-        return appIdsForBundle(exports.WEB_CONTENT_BUNDLE_ID, appDict);
-    }
-    return uniq(appIds);
-}
-/**
- * Validates that all parameters in the provided object have non-nil values.
- * Throws an error if any parameters are missing (null or undefined).
- *
- * @template T - The type of the parameters object.
- * @param params - An object containing parameters to validate.
- * @returns The same parameters object if all values are valid.
- * @throws Error if any parameters are missing, listing all missing parameter names.
- */
-function checkParams(params) {
-    // check if all parameters have a value
-    const errors = Object.entries(params)
-        .filter(([, value]) => value == null)
-        .map(([param]) => param);
-    if (errors.length) {
-        throw new Error(`Missing ${support_1.util.pluralize('parameter', errors.length)}: ${errors.join(', ')}`);
-    }
-    return params;
-}
-/**
- * Converts a value to a best-effort JSON string for logging, removing noisy
- * function properties from cloneable objects when possible.
- *
- * Falls back to `String(value)` when JSON serialization returns `undefined`
- * or throws (for example, for functions, symbols, or circular structures).
- *
- * @param value - The value to stringify.
- * @param multiline - If true, formats JSON output with indentation. Defaults to false.
- * @returns A string representation suitable for logging.
- */
-function simpleStringify(value, multiline = false) {
-    const stringify = (val) => {
-        try {
-            return multiline
-                ? (JSON.stringify(val, null, 2) ?? String(val))
-                : (JSON.stringify(val) ?? String(val));
-        }
-        catch {
-            return String(val);
-        }
-    };
-    if (!value) {
-        return stringify(value);
-    }
-    let cleanValue = value;
-    if (typeof value === 'object' && value !== null) {
-        try {
-            cleanValue = removeNoisyProperties(structuredClone(value));
-        }
-        catch {
-            // Fall back to the original value when cloning fails (e.g., non-cloneable graph entries).
-            cleanValue = value;
-        }
-    }
-    return stringify(cleanValue);
-}
-/**
- * Converts the result from a JavaScript evaluation in the remote debugger
- * into a usable format. Handles errors, serialization, and cleans up noisy
- * function properties.
- *
- * @param res - The raw result from the remote debugger's JavaScript evaluation.
- * @returns The cleaned and converted result value.
- * @throws Error if the result is undefined, has an unexpected type, or contains
- *               an error status code.
- */
-function convertJavascriptEvaluationResult(res) {
-    if (res === undefined) {
-        throw new Error(`Did not get OK result from remote debugger. Result was: ${truncateString(simpleStringify(res), exports.RESPONSE_LOG_LENGTH)}`);
-    }
-    else if (typeof res === 'string') {
-        try {
-            res = JSON.parse(res);
-        }
-        catch {
-            // we might get a serialized object, but we might not
-            // if we get here, it is just a value
-        }
-    }
-    else if ((typeof res !== 'object' && typeof res !== 'function') || res === null) {
-        throw new Error(`Result has unexpected type: (${typeof res}).`);
-    }
-    if (Object.hasOwn(res, 'status') && res.status !== 0) {
-        // we got some form of error.
-        throw (0, base_driver_1.errorFromMJSONWPStatusCode)(res.status, res.value.message || res.value);
-    }
-    // with either have an object with a `value` property (even if `null`),
-    // or a plain object
-    const value = Object.hasOwn(res, 'value') ? res.value : res;
-    return removeNoisyProperties(value);
-}
-/**
- * Calculates the path to the current module's root folder.
- * The result is memoized for performance.
- *
- * @returns The full path to the module root directory.
- * @throws Error if the module root folder cannot be determined.
- */
-let cachedModuleRoot;
-/**
- * Calculates and memoizes the path to the current module root.
- *
- * @returns The full path to the module root directory.
- * @throws Error if the module root folder cannot be determined.
- */
-function getModuleRoot() {
-    if (cachedModuleRoot) {
-        return cachedModuleRoot;
-    }
-    const root = support_1.node.getModuleRootSync(MODULE_NAME, __filename);
-    if (!root) {
-        throw new Error(`Cannot find the root folder of the ${MODULE_NAME} Node.js module`);
-    }
-    cachedModuleRoot = root;
-    return root;
-}
-/**
- * Reads and parses the package.json file from the module root.
- *
- * @returns The parsed package.json contents as a StringRecord.
- */
-function getModuleProperties() {
-    const fullPath = node_path_1.default.resolve(getModuleRoot(), 'package.json');
-    return JSON.parse(node_fs_1.default.readFileSync(fullPath, 'utf8'));
-}
-/**
- * Determines if the WebInspector shim can be used based on the provided iOS platform version.
- * @param platformVersion - The iOS platform version string (e.g., "18.0", "17.5.1")
- * @returns true if the WebInspector shim can be used, false otherwise
- */
-function canUseWebInspectorShim(platformVersion) {
-    return !!platformVersion && support_1.util.compareVersions(platformVersion, '>=', '18.0');
-}
-/**
- * Removes noisy function properties from an object that can muddy the logs.
- * These properties are often added by JavaScript number objects and similar.
- *
- * @param obj - The object to clean.
- * @returns The cleaned object.
- */
-function removeNoisyProperties(obj) {
-    if (obj && typeof obj === 'object') {
-        for (const property of ['ceil', 'clone', 'floor', 'round', 'scale', 'toString']) {
-            delete obj[property];
-        }
-    }
-    return obj;
-}
-//# sourceMappingURL=utils.js.map

package/build/lib/utils.js.map

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