appium-xcuitest-driver 10.14.12 → 10.15.0

package/build/scripts/image-mounter.mjs

@@ -0,0 +1,189 @@
+#!/usr/bin/env node
+/**
+ * Image mounter script for mounting and unmounting Personalized Developer Disk Image on iOS devices
+ * This script provides a CLI interface to mount/unmount DDI via remote XPC services
+ */
+import { logger } from 'appium/support.js';
+import { promises as fs } from 'fs';
+import path from 'path';
+import { Command } from 'commander';
+const log = logger.getLogger('ImageMounter');
+/**
+ * ImageMounter class for managing image mounting and unmounting operations
+ */
+class ImageMounter {
+    constructor() {
+        this.remoteXPCModule = null;
+    }
+    async initializeRemoteXPC() {
+        if (this.remoteXPCModule) {
+            return this.remoteXPCModule;
+        }
+        try {
+            this.remoteXPCModule = await import('appium-ios-remotexpc');
+            return this.remoteXPCModule;
+        }
+        catch {
+            throw new Error('appium-ios-remotexpc is not installed. Please install it using:\n' +
+                'npm install appium-ios-remotexpc\n\n' +
+                'Note: This is an optional dependency required for image mounting functionality.');
+        }
+    }
+    async validateFile(filePath, fileType) {
+        const absolutePath = path.resolve(filePath);
+        try {
+            const stat = await fs.stat(absolutePath);
+            if (!stat.isFile()) {
+                throw new Error(`${fileType} path is not a file: ${absolutePath}`);
+            }
+            return absolutePath;
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                throw new Error(`${fileType} file not found: ${absolutePath}`);
+            }
+            throw error;
+        }
+    }
+    async getTargetDevice(udid) {
+        const { createUsbmux } = await this.initializeRemoteXPC();
+        log.info('Connecting to usbmuxd...');
+        const usbmux = await createUsbmux();
+        const devices = await usbmux.listDevices();
+        if (devices.length === 0) {
+            await usbmux.close();
+            throw new Error('No iOS devices found. Ensure a device is connected, unlocked, and trusted. ' +
+                'See https://appium.github.io/appium-xcuitest-driver/latest/preparation/real-device-config/ for details.');
+        }
+        let targetDevice;
+        if (udid) {
+            targetDevice = devices.find((device) => device.Properties.SerialNumber === udid);
+            if (!targetDevice) {
+                await usbmux.close();
+                throw new Error(`Device with UDID ${udid} not found. Available devices:\n` +
+                    devices.map((d) => `  - ${d.Properties.SerialNumber}`).join('\n'));
+            }
+        }
+        else {
+            if (devices.length > 1) {
+                log.warn(`Multiple devices found. Using first device: ${devices[0].Properties.SerialNumber}`);
+                log.warn('Available devices:');
+                devices.forEach((device) => log.warn(`  - ${device.Properties.SerialNumber}`));
+                log.warn('Use --udid flag to specify a particular device.');
+            }
+            targetDevice = devices[0];
+        }
+        return { usbmux, targetDevice };
+    }
+    async withImageMounterService(udid, fn) {
+        const { usbmux, targetDevice } = await this.getTargetDevice(udid);
+        const deviceUdid = targetDevice.Properties.SerialNumber;
+        try {
+            const remoteXPCModule = await this.initializeRemoteXPC();
+            const { Services } = remoteXPCModule;
+            log.info('Starting mobile image mounter service...');
+            const { mobileImageMounterService: imageMounterService, remoteXPC } = await Services.startMobileImageMounterService(deviceUdid);
+            try {
+                return await fn(imageMounterService, deviceUdid);
+            }
+            finally {
+                await imageMounterService.cleanup();
+                if (remoteXPC) {
+                    log.info(`Closing remoteXPC connection for device ${deviceUdid}`);
+                    await remoteXPC.close();
+                }
+            }
+        }
+        finally {
+            await usbmux.close();
+        }
+    }
+    /**
+     * Mount Personalized Developer Disk Image on device
+     * @param {string} imagePath - Path to the .dmg file
+     * @param {string} manifestPath - Path to the BuildManifest.plist file
+     * @param {string} trustCachePath - Path to the .trustcache file
+     * @param {string} [udid] - Device UDID
+     */
+    async mount(imagePath, manifestPath, trustCachePath, udid) {
+        const [validatedImagePath, validatedManifestPath, validatedTrustCachePath] = await Promise.all([
+            this.validateFile(imagePath, 'Image (.dmg)'),
+            this.validateFile(manifestPath, 'Build Manifest (.plist)'),
+            this.validateFile(trustCachePath, 'Trust Cache (.trustcache)')
+        ]);
+        await this.withImageMounterService(udid, async (imageMounterService, deviceUdid) => {
+            log.info(`Mounting image on device: ${deviceUdid}`);
+            if (await imageMounterService.isPersonalizedImageMounted()) {
+                log.info('✅ Personalized image is already mounted on the device');
+                return;
+            }
+            await imageMounterService.mount(validatedImagePath, validatedManifestPath, validatedTrustCachePath);
+            log.info('✅ Image mounted successfully!');
+        });
+    }
+    /**
+     * Unmount image from device
+     * @param {string} [udid] - Device UDID
+     * @param {string} [mountPath='/System/Developer'] - Mount path to unmount
+     */
+    async unmount(udid, mountPath = '/System/Developer') {
+        await this.withImageMounterService(udid, async (imageMounterService, deviceUdid) => {
+            log.info(`Unmounting image from device: ${deviceUdid}`);
+            log.info(`Mount path: ${mountPath}`);
+            await imageMounterService.unmountImage(mountPath);
+            log.info('✅ Image unmounted successfully!');
+        });
+    }
+}
+/**
+ * CLI with Commander.js
+ */
+async function main() {
+    const program = new Command();
+    const imageMounter = new ImageMounter();
+    program
+        .name('appium driver run xcuitest image-mounter')
+        .description('Mount and unmount Developer Disk Images on iOS devices')
+        .version('1.0.0')
+        .addHelpText('after', `
+NOTE:
+  This script requires the 'appium-ios-remotexpc' package to be installed.
+  Install it using: npm install appium-ios-remotexpc`);
+    // Mount command
+    program
+        .command('mount')
+        .description('Mount a Developer Disk Image on iOS device')
+        .requiredOption('-i, --image <path>', 'Path to the .dmg image file')
+        .requiredOption('-m, --manifest <path>', 'Path to the BuildManifest.plist file')
+        .requiredOption('-t, --trustcache <path>', 'Path to the .trustcache file')
+        .option('-u, --udid <udid>', 'Target device UDID (optional, uses first device if not specified)')
+        .addHelpText('after', `
+EXAMPLES:
+  # Mount Developer Disk Image
+  appium driver run xcuitest image-mounter mount --image DeveloperDiskImage.dmg --manifest BuildManifest.plist --trustcache DeveloperDiskImage.trustcache
+
+  # Mount on specific device
+  appium driver run xcuitest image-mounter mount --image DeveloperDiskImage.dmg --manifest BuildManifest.plist --trustcache DeveloperDiskImage.trustcache --udid <udid>`)
+        .action(async (options) => {
+        await imageMounter.mount(options.image, options.manifest, options.trustcache, options.udid);
+    });
+    // Unmount command
+    program
+        .command('unmount')
+        .description('Unmount a Developer Disk Image from iOS device')
+        .option('-u, --udid <udid>', 'Target device UDID (optional, uses first device if not specified)')
+        .option('-p, --mount-path <path>', 'Mount path to unmount', '/System/Developer')
+        .addHelpText('after', `
+EXAMPLES:
+  # Unmount from default path
+  appium driver run xcuitest image-mounter unmount
+
+  # Unmount from specific device
+  appium driver run xcuitest image-mounter unmount --udid <udid>`)
+        .action(async (options) => {
+        await imageMounter.unmount(options.udid, options.mountPath);
+    });
+    await program.parseAsync(process.argv);
+}
+(async () => await main())();
+//# sourceMappingURL=image-mounter.mjs.map

package/build/scripts/image-mounter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-mounter.mjs","sourceRoot":"","sources":["../../scripts/image-mounter.mjs"],"names":[],"mappings":"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"}

package/build/scripts/open-wda.d.mts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=open-wda.d.mts.map

package/build/scripts/open-wda.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-wda.d.mts","sourceRoot":"","sources":["../../scripts/open-wda.mjs"],"names":[],"mappings":""}

package/build/scripts/open-wda.mjs

@@ -0,0 +1,13 @@
+import path from 'node:path';
+import { exec } from 'teen_process';
+import { logger } from 'appium/support.js';
+import { BOOTSTRAP_PATH } from 'appium-webdriveragent';
+const log = logger.getLogger('WDA');
+const XCODEPROJ_NAME = 'WebDriverAgent.xcodeproj';
+async function openWda() {
+    const dstPath = path.resolve(BOOTSTRAP_PATH, XCODEPROJ_NAME);
+    log.info(`Opening '${dstPath}'`);
+    await exec('open', [dstPath]);
+}
+(async () => await openWda())();
+//# sourceMappingURL=open-wda.mjs.map

package/build/scripts/open-wda.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-wda.mjs","sourceRoot":"","sources":["../../scripts/open-wda.mjs"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,MAAM,GAAG,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AACpC,MAAM,cAAc,GAAG,0BAA0B,CAAC;AAElD,KAAK,UAAU,OAAO;IACpB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC;IAC7D,GAAG,CAAC,IAAI,CAAC,YAAY,OAAO,GAAG,CAAC,CAAC;IACjC,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;AAChC,CAAC;AAED,CAAC,KAAK,IAAI,EAAE,CAAC,MAAM,OAAO,EAAE,CAAC,EAAE,CAAC"}

package/build/scripts/tunnel-creation.d.mts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=tunnel-creation.d.mts.map

package/build/scripts/tunnel-creation.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tunnel-creation.d.mts","sourceRoot":"","sources":["../../scripts/tunnel-creation.mjs"],"names":[],"mappings":""}

package/build/scripts/tunnel-creation.mjs

@@ -0,0 +1,297 @@
+#!/usr/bin/env node
+/**
+ * Test script for creating lockdown service, starting CoreDeviceProxy, and creating tunnel
+ * This script demonstrates the tunnel creation workflow for all connected devices
+ */
+import { logger, node } from 'appium/support.js';
+import _ from 'lodash';
+import { PacketStreamServer, TunnelManager, createLockdownServiceByUDID, createUsbmux, startCoreDeviceProxy, startTunnelRegistryServer, } from 'appium-ios-remotexpc';
+import { strongbox } from '@appium/strongbox';
+import path from 'path';
+import fs from 'fs';
+const log = logger.getLogger('TunnelCreation');
+const TUNNEL_REGISTRY_PORT = 'tunnelRegistryPort';
+/**
+ * TunnelCreator class for managing tunnel creation and related operations
+ */
+class TunnelCreator {
+    constructor() {
+        this._packetStreamServers = new Map();
+        // Default port value, will be updated in main() if --packet-stream-base-port is provided
+        this._packetStreamBasePort = 50000;
+        // Default port value, will be updated in main() if --tunnel-registry-port is provided
+        this._tunnelRegistryPort = 42314;
+    }
+    get packetStreamBasePort() {
+        return this._packetStreamBasePort;
+    }
+    set packetStreamBasePort(port) {
+        this._packetStreamBasePort = port;
+    }
+    get tunnelRegistryPort() {
+        return this._tunnelRegistryPort;
+    }
+    set tunnelRegistryPort(port) {
+        this._tunnelRegistryPort = port;
+    }
+    /**
+     * Update tunnel registry with new tunnel information
+     * @param {import('appium-ios-remotexpc').TunnelResult[]} results - Array of tunnel results
+     * @returns {Promise<import('appium-ios-remotexpc').TunnelRegistry>} Updated tunnel registry
+     */
+    async updateTunnelRegistry(results) {
+        const now = Date.now();
+        const nowISOString = new Date().toISOString();
+        // Initialize registry if it doesn't exist
+        const registry = {
+            tunnels: {},
+            metadata: {
+                lastUpdated: nowISOString,
+                totalTunnels: 0,
+                activeTunnels: 0,
+            },
+        };
+        // Update tunnels
+        for (const result of results) {
+            if (result.success) {
+                const udid = result.device.Properties.SerialNumber;
+                registry.tunnels[udid] = {
+                    udid,
+                    deviceId: result.device.DeviceID,
+                    address: result.tunnel.Address,
+                    rsdPort: result.tunnel.RsdPort ?? 0,
+                    packetStreamPort: result.packetStreamPort,
+                    connectionType: result.device.Properties.ConnectionType,
+                    productId: result.device.Properties.ProductID,
+                    createdAt: registry.tunnels[udid]?.createdAt ?? now,
+                    lastUpdated: now,
+                };
+            }
+        }
+        // Update metadata
+        registry.metadata = {
+            lastUpdated: nowISOString,
+            totalTunnels: Object.keys(registry.tunnels).length,
+            activeTunnels: Object.keys(registry.tunnels).length, // Assuming all are active for now
+        };
+        return registry;
+    }
+    /**
+     * Setup cleanup handlers for graceful shutdown
+     */
+    setupCleanupHandlers() {
+        const cleanup = async (signal) => {
+            log.warn(`\nReceived ${signal}. Cleaning up...`);
+            // Close all packet stream servers
+            if (this._packetStreamServers.size > 0) {
+                log.info(`Closing ${this._packetStreamServers.size} packet stream server(s)...`);
+                for (const [udid, server] of this._packetStreamServers) {
+                    try {
+                        await server.stop();
+                        log.info(`Closed packet stream server for device ${udid}`);
+                    }
+                    catch (err) {
+                        log.warn(`Failed to close packet stream server for device ${udid}: ${err}`);
+                    }
+                }
+                this._packetStreamServers.clear();
+            }
+            log.info('Cleanup completed. Exiting...');
+            process.exit(0);
+        };
+        // Handle various termination signals
+        process.on('SIGINT', () => cleanup('SIGINT (Ctrl+C)'));
+        process.on('SIGTERM', () => cleanup('SIGTERM'));
+        process.on('SIGHUP', () => cleanup('SIGHUP'));
+        // Handle uncaught exceptions and unhandled rejections
+        process.on('uncaughtException', async (error) => {
+            log.error('Uncaught Exception:', error);
+            await cleanup('Uncaught Exception');
+        });
+        process.on('unhandledRejection', async (reason, promise) => {
+            log.error('Unhandled Rejection at:', promise, 'reason:', reason);
+            await cleanup('Unhandled Rejection');
+        });
+    }
+    /**
+     * Create tunnel for a single device
+     * @param {import('appium-ios-remotexpc').UsbmuxDevice} device - Device object
+     * @param {import('tls').ConnectionOptions} tlsOptions - TLS options
+     * @returns {Promise<import('appium-ios-remotexpc').TunnelResult & { socket?: any; socketInfo?: import('appium-ios-remotexpc').SocketInfo }>} Tunnel result
+     */
+    async createTunnelForDevice(device, tlsOptions) {
+        const udid = device.Properties.SerialNumber;
+        log.info(`\n--- Processing device: ${udid} ---`);
+        log.info(`Device ID: ${device.DeviceID}`);
+        log.info(`Connection Type: ${device.Properties.ConnectionType}`);
+        log.info(`Product ID: ${device.Properties.ProductID}`);
+        log.info('Creating lockdown service...');
+        const { lockdownService, device: lockdownDevice } = await createLockdownServiceByUDID(udid);
+        log.info(`Lockdown service created for device: ${lockdownDevice.Properties.SerialNumber}`);
+        log.info('Starting CoreDeviceProxy...');
+        const { socket } = await startCoreDeviceProxy(lockdownService, lockdownDevice.DeviceID, lockdownDevice.Properties.SerialNumber, tlsOptions);
+        log.info('CoreDeviceProxy started successfully');
+        log.info('Creating tunnel...');
+        const tunnel = await TunnelManager.getTunnel(socket);
+        log.info(`Tunnel created for address: ${tunnel.Address} with RsdPort: ${tunnel.RsdPort}`);
+        let packetStreamPort;
+        packetStreamPort = this._packetStreamBasePort++;
+        const packetStreamServer = new PacketStreamServer(packetStreamPort);
+        await packetStreamServer.start();
+        const consumer = packetStreamServer.getPacketConsumer();
+        if (consumer) {
+            tunnel.addPacketConsumer(consumer);
+        }
+        this._packetStreamServers.set(udid, packetStreamServer);
+        log.info(`Packet stream server started on port ${packetStreamPort}`);
+        log.info(`✅ Tunnel creation completed successfully for device: ${udid}`);
+        log.info(`   Tunnel Address: ${tunnel.Address}`);
+        log.info(`   Tunnel RsdPort: ${tunnel.RsdPort}`);
+        if (packetStreamPort) {
+            log.info(`   Packet Stream Port: ${packetStreamPort}`);
+        }
+        if (_.isFunction(socket?.setNoDelay)) {
+            socket.setNoDelay(true);
+        }
+        return {
+            device,
+            tunnel: {
+                Address: tunnel.Address,
+                RsdPort: tunnel.RsdPort,
+            },
+            packetStreamPort,
+            success: true,
+            socket,
+        };
+    }
+    /**
+     * Sets up tunnels for all connected devices.
+     * @param {import('appium-ios-remotexpc').Usbmux} usbmux - The usbmux object.
+     * @param {string|undefined} specificUdid - A specific UDID to process, or undefined for all devices.
+     * @param {import('tls').ConnectionOptions} tlsOptions - TLS options.
+     */
+    async setupTunnels(usbmux, specificUdid, tlsOptions) {
+        log.info('Listing all connected devices...');
+        const devices = await usbmux.listDevices();
+        if (devices.length === 0) {
+            log.warn('No devices found. Make sure iOS devices are connected and trusted.');
+            return;
+        }
+        log.info(`Found ${devices.length} connected device(s):`);
+        devices.forEach((device, index) => {
+            log.info(`  ${index + 1}. UDID: ${device.Properties.SerialNumber}`);
+            log.info(`     Device ID: ${device.DeviceID}`);
+            log.info(`     Connection: ${device.Properties.ConnectionType}`);
+            log.info(`     Product ID: ${device.Properties.ProductID}`);
+        });
+        let devicesToProcess = devices;
+        if (specificUdid) {
+            devicesToProcess = devices.filter((device) => device.Properties.SerialNumber === specificUdid);
+            if (devicesToProcess.length === 0) {
+                log.error(`Device with UDID ${specificUdid} not found in connected devices.`);
+                log.error('Available devices:');
+                devices.forEach((device) => {
+                    log.error(`  - ${device.Properties.SerialNumber}`);
+                });
+                process.exit(1);
+            }
+        }
+        log.info(`\nProcessing ${devicesToProcess.length} device(s)...`);
+        /** @type {import('appium-ios-remotexpc').TunnelResult[]} */
+        const results = [];
+        for (const device of devicesToProcess) {
+            const result = await this.createTunnelForDevice(device, tlsOptions);
+            results.push(result);
+        }
+        log.info('\n=== TUNNEL CREATION SUMMARY ===');
+        const successful = results.filter((r) => r.success);
+        const failed = results.filter((r) => !r.success);
+        log.info(`Total devices processed: ${results.length}`);
+        log.info(`Successful tunnels: ${successful.length}`);
+        log.info(`Failed tunnels: ${failed.length}`);
+        if (successful.length > 0) {
+            log.info('\n✅ Successful tunnels:');
+            const registry = await this.updateTunnelRegistry(results);
+            await startTunnelRegistryServer(registry, this._tunnelRegistryPort);
+            log.info('\n📁 Tunnel registry API:');
+            log.info('   The tunnel registry is now available through the API at:');
+            log.info(`   http://localhost:${this._tunnelRegistryPort}/remotexpc/tunnels`);
+            log.info('\n   Available endpoints:');
+            log.info('   - GET /remotexpc/tunnels - List all tunnels');
+            log.info('   - GET /remotexpc/tunnels/:udid - Get tunnel by UDID');
+            log.info('   - GET /remotexpc/tunnels/metadata - Get registry metadata');
+            if (successful.length > 0) {
+                const firstUdid = successful[0].device.Properties.SerialNumber;
+                log.info(`   curl http://localhost:4723/remotexpc/tunnels/${firstUdid}`);
+            }
+        }
+    }
+}
+/**
+ * Helper function to parse string arguments
+ * @param {string[]} args - Array of command line arguments
+ * @param {string} flagName - Name of the flag to parse (e.g. '--udid')
+ * @returns {string|undefined} The value of the flag if found, undefined otherwise
+ */
+function parseArg(args, flagName) {
+    const equalsArg = args.find((arg) => arg.startsWith(`${flagName}=`));
+    if (equalsArg) {
+        const value = equalsArg.split('=')[1];
+        log.info(`Using ${flagName.slice(2)}: ${value}`);
+        return value;
+    }
+    else {
+        const flagIndex = args.indexOf(flagName);
+        if (flagIndex !== -1 && flagIndex + 1 < args.length) {
+            const value = args[flagIndex + 1];
+            log.info(`Using ${flagName.slice(2)}: ${value}`);
+            return value;
+        }
+    }
+    return undefined;
+}
+;
+const BOOTSTRAP_PATH = node.getModuleRootSync('appium-xcuitest-driver', import.meta.url);
+/**
+ */
+async function main() {
+    // Create an instance of TunnelCreator
+    const tunnelCreator = new TunnelCreator();
+    tunnelCreator.setupCleanupHandlers();
+    const args = process.argv.slice(2);
+    const specificUdid = parseArg(args, '--udid');
+    const packetStreamBasePort = parseArg(args, '--packet-stream-base-port');
+    if (packetStreamBasePort !== undefined) {
+        tunnelCreator.packetStreamBasePort = parseInt(packetStreamBasePort, 10);
+    }
+    const tunnelRegistryPort = parseArg(args, '--tunnel-registry-port');
+    if (tunnelRegistryPort !== undefined) {
+        tunnelCreator.tunnelRegistryPort = parseInt(tunnelRegistryPort, 10);
+    }
+    if (!BOOTSTRAP_PATH) {
+        throw new Error(`BOOTSTRAP_PATH is null`);
+    }
+    const packageInfo = JSON.parse(fs.readFileSync(path.join(BOOTSTRAP_PATH, 'package.json'), 'utf8'));
+    const box = strongbox(packageInfo.name);
+    try {
+        await box.createItemWithValue(TUNNEL_REGISTRY_PORT, String(tunnelCreator.tunnelRegistryPort));
+    }
+    catch (error) {
+        throw new Error(`Tunnel registry port cannot be persisted: ${error.message}`);
+    }
+    /** @type {import('tls').ConnectionOptions} */
+    const tlsOptions = {
+        rejectUnauthorized: false,
+        minVersion: 'TLSv1.2',
+    };
+    log.info('Connecting to usbmuxd...');
+    const usbmux = await createUsbmux();
+    try {
+        await tunnelCreator.setupTunnels(usbmux, specificUdid, tlsOptions);
+    }
+    finally {
+        await usbmux.close();
+    }
+}
+(async () => await main())();
+//# sourceMappingURL=tunnel-creation.mjs.map

package/build/scripts/tunnel-creation.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"tunnel-creation.mjs","sourceRoot":"","sources":["../../scripts/tunnel-creation.mjs"],"names":[],"mappings":"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"}

package/build/scripts/utils.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Get the value of the given argument name.
+ *
+ * @param {string} argName
+ * @returns {string?} The value of the given 'argName'.
+ */
+export function parseArgValue(argName: string): string | null;
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../scripts/utils.js"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,uCAHW,MAAM,GACJ,MAAM,OAAC,CAWnB"}

package/build/scripts/utils.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseArgValue = parseArgValue;
+/**
+ * Get the value of the given argument name.
+ *
+ * @param {string} argName
+ * @returns {string?} The value of the given 'argName'.
+ */
+function parseArgValue(argName) {
+    const argNamePattern = new RegExp(`^--${argName}\\b`);
+    for (let i = 1; i < process.argv.length; ++i) {
+        const arg = process.argv[i];
+        if (argNamePattern.test(arg)) {
+            return arg.includes('=') ? arg.split('=')[1] : process.argv[i + 1];
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=utils.js.map

package/build/scripts/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../scripts/utils.js"],"names":[],"mappings":";;AAMA,sCASC;AAfD;;;;;GAKG;AACH,SAAgB,aAAa,CAAC,OAAO;IACnC,MAAM,cAAc,GAAG,IAAI,MAAM,CAAC,MAAM,OAAO,KAAK,CAAC,CAAC;IACtD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC;QAC7C,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC5B,IAAI,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7B,OAAO,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}