appium-mac2-driver 4.5.1 → 4.6.0

package/node_modules/appium-chromedriver/build/lib/storage-client/chromelabs.js

@@ -0,0 +1,136 @@
+import path from 'node:path';
+import { logger } from '@appium/support';
+import * as semver from 'semver';
+import { ARCH, CPU } from '../constants.js';
+const log = logger.getLogger('ChromedriverChromelabsStorageClient');
+/**
+ * Parses the output of the JSON API that retrieves Chromedriver versions
+ *
+ * See https://github.com/GoogleChromeLabs/chrome-for-testing#json-api-endpoints for more details.
+ *
+ * @param jsonStr - The JSON string from the known-good-versions-with-downloads API
+ * @returns A mapping of chromedriver entry keys to their details
+ * @throws {Error} if the JSON cannot be parsed or has an unsupported format
+ */
+export function parseKnownGoodVersionsWithDownloadsJson(jsonStr) {
+    let json;
+    try {
+        json = JSON.parse(jsonStr);
+    }
+    catch (e) {
+        throw new Error(`Storage JSON cannot be parsed. Original error: ${e instanceof Error ? e.message : String(e)}`, {
+            cause: e,
+        });
+    }
+    /**
+     * Example output:
+     * {
+     * "timestamp":"2023-07-28T13:09:17.042Z",
+     * "versions":[
+     *    {
+     *       "version":"113.0.5672.0",
+     *       "revision":"1121455",
+     *       "downloads":{
+     *          "chromedriver":[
+     *             {
+     *                "platform":"linux64",
+     *                "url":"https://edgedl.me.gvt1.com/edgedl/chrome/chrome-for-testing/113.0.5672.0/linux64/chrome-linux64.zip"
+     *             },
+     *             {
+     *                "platform":"mac-arm64",
+     *                "url":"https://edgedl.me.gvt1.com/edgedl/chrome/chrome-for-testing/113.0.5672.0/mac-arm64/chrome-mac-arm64.zip"
+     *             },
+     *             {
+     *                "platform":"mac-x64",
+     *                "url":"https://edgedl.me.gvt1.com/edgedl/chrome/chrome-for-testing/113.0.5672.0/mac-x64/chrome-mac-x64.zip"
+     *             },
+     *             {
+     *                "platform":"win32",
+     *                "url":"https://edgedl.me.gvt1.com/edgedl/chrome/chrome-for-testing/113.0.5672.0/win32/chrome-win32.zip"
+     *             },
+     *             {
+     *                "platform":"win64",
+     *                "url":"https://edgedl.me.gvt1.com/edgedl/chrome/chrome-for-testing/113.0.5672.0/win64/chrome-win64.zip"
+     *             }
+     *          ]
+     *       }
+     *    },
+     *    {
+     *       "version":"113.0.5672.35",
+     *       ...
+     */
+    const mapping = {};
+    if (!Array.isArray(json?.versions)) {
+        log.debug(jsonStr);
+        throw new Error('The format of the storage JSON is not supported');
+    }
+    for (const { version, downloads } of json.versions) {
+        if (!Array.isArray(downloads?.chromedriver)) {
+            continue;
+        }
+        const versionObj = semver.parse(version, { loose: true });
+        if (!versionObj) {
+            continue;
+        }
+        for (const downloadEntry of downloads.chromedriver) {
+            if (!downloadEntry?.url || !downloadEntry?.platform) {
+                continue;
+            }
+            const osNameMatch = /^[a-z]+/i.exec(downloadEntry.platform);
+            if (!osNameMatch) {
+                log.debug(`The entry '${downloadEntry.url}' does not contain valid platform name. Skipping it`);
+                continue;
+            }
+            const key = `${path.basename(path.dirname(path.dirname(downloadEntry.url)))}/` + `${path.basename(downloadEntry.url)}`;
+            mapping[key] = {
+                url: downloadEntry.url,
+                etag: null,
+                version,
+                minBrowserVersion: `${versionObj.major}`,
+                os: {
+                    name: osNameMatch[0],
+                    arch: downloadEntry.platform.includes(ARCH.X64) ? ARCH.X64 : ARCH.X86,
+                    cpu: downloadEntry.platform.includes(CPU.ARM) ? CPU.ARM : CPU.INTEL,
+                },
+            };
+        }
+    }
+    log.info(`The total count of entries in the mapping: ${Object.keys(mapping).length}`);
+    return mapping;
+}
+/**
+ * Parses the output of the JSON API that retrieves the most recent stable Chromedriver version
+ *
+ * See https://github.com/GoogleChromeLabs/chrome-for-testing#json-api-endpoints for more details.
+ *
+ * @param jsonStr - The JSON string from the last-known-good-versions API
+ * @returns The most recent available chromedriver version string
+ * @throws {Error} if the JSON cannot be parsed or has an unsupported format
+ */
+export function parseLatestKnownGoodVersionsJson(jsonStr) {
+    let json;
+    try {
+        json = JSON.parse(jsonStr);
+    }
+    catch (e) {
+        throw new Error(`Storage JSON cannot be parsed. Original error: ${e instanceof Error ? e.message : String(e)}`, {
+            cause: e,
+        });
+    }
+    /**
+     * Example output:
+     * "timestamp":"2023-07-28T13:09:17.036Z",
+     * "channels":{
+     *    "Stable":{
+     *       "channel":"Stable",
+     *       "version":"115.0.5790.102",
+     *       "revision":"1148114"
+     * ...
+     */
+    if (!json?.channels?.Stable?.version) {
+        log.debug(jsonStr);
+        throw new Error('The format of the storage JSON is not supported');
+    }
+    return json.channels.Stable.version;
+}
+//# sourceMappingURL=chromelabs.js.map

package/node_modules/appium-chromedriver/build/lib/storage-client/chromelabs.js.map

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

package/node_modules/appium-chromedriver/build/lib/storage-client/googleapis.d.ts

@@ -0,0 +1,30 @@
+import type { AdditionalDriverDetails, ChromedriverDetailsMapping } from '../types.js';
+/**
+ * Finds a child node in an XML node by name and/or text content
+ *
+ * @param parent - The parent XML node to search in
+ * @param childName - Optional child node name to match
+ * @param text - Optional text content to match
+ * @returns The matching child node or null if not found
+ */
+export declare function findChildNode(parent: Node | Attr, childName?: string | null, text?: string | null): Node | Attr | null;
+/**
+ * Gets additional chromedriver details from chromedriver
+ * release notes
+ *
+ * @param content - Release notes of the corresponding chromedriver
+ * @returns AdditionalDriverDetails
+ */
+export declare function parseNotes(content: string): AdditionalDriverDetails;
+/**
+ * Parses chromedriver storage XML and returns
+ * the parsed results
+ *
+ * @param xml - The chromedriver storage XML
+ * @param shouldParseNotes [true] - If set to `true`
+ * then additional drivers information is going to be parsed
+ * and assigned to `this.mapping`
+ * @returns Promise<ChromedriverDetailsMapping>
+ */
+export declare function parseGoogleapiStorageXml(xml: string, shouldParseNotes?: boolean): Promise<ChromedriverDetailsMapping>;
+//# sourceMappingURL=googleapis.d.ts.map

package/node_modules/appium-chromedriver/build/lib/storage-client/googleapis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"googleapis.d.ts","sourceRoot":"","sources":["../../../lib/storage-client/googleapis.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAC,uBAAuB,EAAuB,0BAA0B,EAAC,MAAM,aAAa,CAAC;AAM1G;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,IAAI,GAAG,IAAI,EACnB,SAAS,GAAE,MAAM,GAAG,IAAW,EAC/B,IAAI,GAAE,MAAM,GAAG,IAAW,GACzB,IAAI,GAAG,IAAI,GAAG,IAAI,CA2BpB;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,uBAAuB,CAWnE;AAED;;;;;;;;;GASG;AACH,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,MAAM,EACX,gBAAgB,UAAO,GACtB,OAAO,CAAC,0BAA0B,CAAC,CA2ErC"}

package/node_modules/appium-chromedriver/build/lib/storage-client/googleapis.js

@@ -0,0 +1,162 @@
+import path from 'node:path';
+import { util, logger } from '@appium/support';
+import { DOMParser } from '@xmldom/xmldom';
+import { asyncmap } from 'asyncbox';
+import { select as xpathSelect } from 'xpath';
+import { STORAGE_REQ_TIMEOUT_MS, GOOGLEAPIS_CDN, ARCH, CPU, APPLE_ARM_SUFFIXES } from '../constants.js';
+import { retrieveData } from '../utils.js';
+const log = logger.getLogger('ChromedriverGoogleapisStorageClient');
+const MAX_PARALLEL_DOWNLOADS = 5;
+/**
+ * Finds a child node in an XML node by name and/or text content
+ *
+ * @param parent - The parent XML node to search in
+ * @param childName - Optional child node name to match
+ * @param text - Optional text content to match
+ * @returns The matching child node or null if not found
+ */
+export function findChildNode(parent, childName = null, text = null) {
+    if (!childName && !text) {
+        return null;
+    }
+    if (!parent.hasChildNodes()) {
+        return null;
+    }
+    for (let childNodeIdx = 0; childNodeIdx < parent.childNodes.length; childNodeIdx++) {
+        const childNode = parent.childNodes[childNodeIdx];
+        if (childName && !text && childName === childNode.localName) {
+            return childNode;
+        }
+        if (text) {
+            const childText = extractNodeText(childNode);
+            if (!childText) {
+                continue;
+            }
+            if (childName && childName === childNode.localName && text === childText) {
+                return childNode;
+            }
+            if (!childName && text === childText) {
+                return childNode;
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Gets additional chromedriver details from chromedriver
+ * release notes
+ *
+ * @param content - Release notes of the corresponding chromedriver
+ * @returns AdditionalDriverDetails
+ */
+export function parseNotes(content) {
+    const result = {};
+    const versionMatch = /^\s*[-]+ChromeDriver[\D]+([\d.]+)/im.exec(content);
+    if (versionMatch) {
+        result.version = versionMatch[1];
+    }
+    const minBrowserVersionMatch = /^\s*Supports Chrome[\D]+(\d+)/im.exec(content);
+    if (minBrowserVersionMatch) {
+        result.minBrowserVersion = minBrowserVersionMatch[1];
+    }
+    return result;
+}
+/**
+ * Parses chromedriver storage XML and returns
+ * the parsed results
+ *
+ * @param xml - The chromedriver storage XML
+ * @param shouldParseNotes [true] - If set to `true`
+ * then additional drivers information is going to be parsed
+ * and assigned to `this.mapping`
+ * @returns Promise<ChromedriverDetailsMapping>
+ */
+export async function parseGoogleapiStorageXml(xml, shouldParseNotes = true) {
+    const doc = new DOMParser().parseFromString(xml, 'text/xml');
+    const driverNodes = xpathSelect(`//*[local-name(.)='Contents']`, doc);
+    log.debug(`Parsed ${driverNodes.length} entries from storage XML`);
+    if (driverNodes.length === 0) {
+        throw new Error('Cannot retrieve any valid Chromedriver entries from the storage config');
+    }
+    const infoParsers = [];
+    const mapping = {};
+    for (const driverNode of driverNodes) {
+        const k = extractNodeText(findChildNode(driverNode, 'Key'));
+        if (!String(k).includes('/chromedriver_')) {
+            continue;
+        }
+        const key = String(k);
+        const versionSegment = key.split('/')[0];
+        if (!versionSegment) {
+            continue;
+        }
+        const etag = extractNodeText(findChildNode(driverNode, 'ETag'));
+        if (!etag) {
+            log.debug(`The entry '${key}' does not contain the checksum. Skipping it`);
+            continue;
+        }
+        const filename = path.basename(key);
+        const osNameMatch = /_([a-z]+)/i.exec(filename);
+        if (!osNameMatch) {
+            log.debug(`The entry '${key}' does not contain valid OS name. Skipping it`);
+            continue;
+        }
+        const cdInfo = {
+            url: `${GOOGLEAPIS_CDN}/${key}`,
+            etag: etag.replace(/^"+|"+$/g, ''),
+            version: versionSegment,
+            minBrowserVersion: null,
+            os: {
+                name: osNameMatch[1],
+                arch: filename.includes(ARCH.X64) ? ARCH.X64 : ARCH.X86,
+                cpu: APPLE_ARM_SUFFIXES.some((suffix) => filename.includes(suffix)) ? CPU.ARM : CPU.INTEL,
+            },
+        };
+        mapping[key] = cdInfo;
+        const notesPath = `${cdInfo.version}/notes.txt`;
+        const isNotesPresent = !!driverNodes.reduce((acc, node) => Boolean(acc || findChildNode(node, 'Key', notesPath)), false);
+        if (!isNotesPresent) {
+            cdInfo.minBrowserVersion = null;
+            if (shouldParseNotes) {
+                log.info(`The entry '${key}' does not contain any notes. Skipping it`);
+            }
+            continue;
+        }
+        else if (!shouldParseNotes) {
+            continue;
+        }
+        infoParsers.push(async () => {
+            await retrieveAdditionalDriverInfo(key, `${GOOGLEAPIS_CDN}/${notesPath}`, cdInfo);
+        });
+    }
+    await asyncmap(infoParsers, async (parseInfo) => {
+        await parseInfo();
+    }, { concurrency: MAX_PARALLEL_DOWNLOADS });
+    log.info(`The total count of entries in the mapping: ${Object.keys(mapping).length}`);
+    return mapping;
+}
+/**
+ * Downloads chromedriver release notes and updates the driver info dictionary
+ *
+ * Mutates `infoDict` by setting `minBrowserVersion` if found in notes
+ * @param driverKey - Driver version plus archive name
+ * @param notesUrl - The URL of chromedriver notes
+ * @param infoDict - The dictionary containing driver info (will be mutated)
+ * @param timeout - Request timeout in milliseconds
+ */
+async function retrieveAdditionalDriverInfo(driverKey, notesUrl, infoDict, timeout = STORAGE_REQ_TIMEOUT_MS) {
+    const notes = await retrieveData(notesUrl, {
+        'user-agent': 'appium',
+        accept: '*/*',
+    }, { timeout });
+    const { minBrowserVersion } = parseNotes(notes);
+    if (!minBrowserVersion) {
+        log.debug(`The driver '${driverKey}' does not contain valid release notes at ${notesUrl}. Skipping it`);
+        return;
+    }
+    infoDict.minBrowserVersion = minBrowserVersion;
+}
+function extractNodeText(node) {
+    return !node?.firstChild || !util.hasValue(node.firstChild.nodeValue) ? null : node.firstChild.nodeValue;
+}
+//# sourceMappingURL=googleapis.js.map

package/node_modules/appium-chromedriver/build/lib/storage-client/googleapis.js.map

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

package/node_modules/appium-chromedriver/build/lib/storage-client/storage-client.d.ts

@@ -0,0 +1,73 @@
+import type { ChromedriverStorageClientOpts, SyncOptions, ChromedriverDetailsMapping } from '../types.js';
+export declare class ChromedriverStorageClient {
+    readonly chromedriverDir: string;
+    readonly timeout: number;
+    private mapping;
+    constructor(args?: ChromedriverStorageClientOpts);
+    /**
+     * Retrieves chromedriver mapping from the storage
+     *
+     * @param shouldParseNotes [true] - if set to `true`
+     * then additional chromedrivers info is going to be retrieved and
+     * parsed from release notes
+     * @returns Promise<ChromedriverDetailsMapping>
+     */
+    retrieveMapping(shouldParseNotes?: boolean): Promise<ChromedriverDetailsMapping>;
+    /**
+     * Retrieves chromedrivers from the remote storage to the local file system
+     *
+     * @param opts - Synchronization options (versions, minBrowserVersion, osInfo)
+     * @throws {Error} if there was a problem while retrieving the drivers
+     * @returns The list of successfully synchronized driver keys
+     */
+    syncDrivers(opts?: SyncOptions): Promise<string[]>;
+    /**
+     * Returns the latest chromedriver version for Chrome for Testing
+     *
+     * @returns The latest stable chromedriver version string
+     * @throws {Error} if the version cannot be fetched from the remote API
+     */
+    getLatestKnownGoodVersion(): Promise<string>;
+    /**
+     * Filters `this.mapping` to only select matching chromedriver entries
+     * by operating system information and/or additional synchronization options
+     *
+     * @param osInfo - Operating system information to match against
+     * @param opts - Synchronization options (versions, minBrowserVersion)
+     * @returns The list of filtered chromedriver entry names (version/archive name)
+     */
+    private selectMatchingDrivers;
+    /**
+     * Checks whether the given chromedriver matches the operating system to run on
+     *
+     * @param cdName - The chromedriver entry key in the mapping
+     * @param osInfo - Operating system information to match against
+     * @returns True if the chromedriver matches the OS info
+     */
+    private doesMatchForOsInfo;
+    /**
+     * Retrieves the given chromedriver from the storage
+     * and unpacks it into `this.chromedriverDir` folder
+     *
+     * @param index - The unique driver index
+     * @param driverKey - The driver key in `this.mapping`
+     * @param archivesRoot - The temporary folder path to extract
+     * downloaded archives to
+     * @param isStrict [true] - Whether to throw an error (`true`)
+     * or return a boolean result if the driver retrieval process fails
+     * @throws {Error} if there was a failure while retrieving the driver
+     * and `isStrict` is set to `true`
+     * @returns if `true` then the chromedriver is successfully
+     * downloaded and extracted.
+     */
+    private retrieveDriver;
+    /**
+     * Extracts downloaded chromedriver archive
+     * into the given destination
+     *
+     * @param src - The source archive path
+     * @param dst - The destination chromedriver path
+     */
+    private unzipDriver;
+}
+//# sourceMappingURL=storage-client.d.ts.map

package/node_modules/appium-chromedriver/build/lib/storage-client/storage-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-client.d.ts","sourceRoot":"","sources":["../../../lib/storage-client/storage-client.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAC,6BAA6B,EAAE,WAAW,EAAU,0BAA0B,EAAC,MAAM,aAAa,CAAC;AA2BhH,qBAAa,yBAAyB;IACpC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,OAAO,CAA6B;gBAEhC,IAAI,GAAE,6BAAkC;IAOpD;;;;;;;OAOG;IACG,eAAe,CAAC,gBAAgB,UAAO,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAuCnF;;;;;;OAMG;IACG,WAAW,CAAC,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAwC5D;;;;;OAKG;IACG,yBAAyB,IAAI,OAAO,CAAC,MAAM,CAAC;IAuBlD;;;;;;;OAOG;IACH,OAAO,CAAC,qBAAqB;IAqH7B;;;;;;OAMG;IACH,OAAO,CAAC,kBAAkB;IAgB1B;;;;;;;;;;;;;;OAcG;YACW,cAAc;IAgD5B;;;;;;OAMG;YACW,WAAW;CAoB1B"}