appium-desktop-driver 1.2.0

package/build/lib/commands/powershell.js

@@ -0,0 +1,202 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startPowerShellSession = startPowerShellSession;
+exports.sendIsolatedPowerShellCommand = sendIsolatedPowerShellCommand;
+exports.sendPowerShellCommand = sendPowerShellCommand;
+exports.terminatePowerShellSession = terminatePowerShellSession;
+const node_child_process_1 = require("node:child_process");
+const base_driver_1 = require("@appium/base-driver");
+const functions_1 = require("./functions");
+const SET_UTF8_ENCODING = /* ps1 */ `$OutputEncoding = [Console]::OutputEncoding = [Text.Encoding]::UTF8`;
+const ADD_NECESSARY_ASSEMBLIES = /* ps1 */ `Add-Type -AssemblyName UIAutomationClient; Add-Type -AssemblyName System.Drawing; Add-Type -AssemblyName PresentationCore; Add-Type -AssemblyName System.Windows.Forms`;
+const USE_UI_AUTOMATION_CLIENT = /* ps1 */ `using namespace System.Windows.Automation`;
+const INIT_CACHE_REQUEST = /* ps1 */ `($cacheRequest = New-Object System.Windows.Automation.CacheRequest).TreeFilter = [AndCondition]::new([Automation]::ControlViewCondition, [NotCondition]::new([PropertyCondition]::new([AutomationElement]::FrameworkIdProperty, 'Chrome'))); $cacheRequest.Push()`;
+const INIT_ROOT_ELEMENT = /* ps1 */ `$rootElement = [AutomationElement]::RootElement`;
+const NULL_ROOT_ELEMENT = /* ps1 */ `$rootElement = $null`;
+const INIT_ELEMENT_TABLE = /* ps1 */ `$elementTable = New-Object System.Collections.Generic.Dictionary[[string]\`,[AutomationElement]]`;
+async function startPowerShellSession() {
+    const spawnEnv = this.caps.appEnvironment
+        ? { ...process.env, ...this.caps.appEnvironment }
+        : process.env;
+    if (this.caps.appEnvironment) {
+        const keys = Object.keys(this.caps.appEnvironment);
+        this.log.info(`Applying appEnvironment variables to PowerShell session: ${keys.join(', ')}`);
+    }
+    const powerShell = (0, node_child_process_1.spawn)('powershell.exe', ['-NoExit', '-Command', '-'], { env: spawnEnv });
+    powerShell.stdout.setEncoding('utf8');
+    powerShell.stderr.setEncoding('utf8');
+    powerShell.stdout.on('data', (chunk) => {
+        this.powerShellStdOut += chunk.toString();
+    });
+    powerShell.stderr.on('data', (chunk) => {
+        this.powerShellStdErr += chunk.toString();
+    });
+    this.powerShell = powerShell;
+    if (this.caps.appWorkingDir) {
+        const envVarsSet = new Set();
+        const matches = this.caps.appWorkingDir.matchAll(/%([^%]+)%/g);
+        for (const match of matches) {
+            envVarsSet.add(match[1]);
+        }
+        const envVars = Array.from(envVarsSet);
+        for (const envVar of envVars) {
+            this.caps.appWorkingDir = this.caps.appWorkingDir.replaceAll(`%${envVar}%`, spawnEnv[envVar.toUpperCase()] ?? '');
+        }
+        this.sendPowerShellCommand(`Set-Location -Path '${this.caps.appWorkingDir}'`);
+    }
+    await this.sendPowerShellCommand(SET_UTF8_ENCODING);
+    await this.sendPowerShellCommand(ADD_NECESSARY_ASSEMBLIES);
+    await this.sendPowerShellCommand(USE_UI_AUTOMATION_CLIENT);
+    await this.sendPowerShellCommand(INIT_CACHE_REQUEST);
+    await this.sendPowerShellCommand(INIT_ELEMENT_TABLE);
+    // initialize functions
+    await this.sendPowerShellCommand(functions_1.PAGE_SOURCE);
+    await this.sendPowerShellCommand(functions_1.FIND_CHILDREN_RECURSIVELY);
+    if ((!this.caps.app && !this.caps.appTopLevelWindow) || (!this.caps.app || this.caps.app.toLowerCase() === 'none')) {
+        this.log.info(`No app or top-level window specified in capabilities. Setting root element to null.`);
+        await this.sendPowerShellCommand(NULL_ROOT_ELEMENT);
+    }
+    if (this.caps.app && this.caps.app.toLowerCase() === 'root') {
+        this.log.info(`'root' specified as app in capabilities. Setting root element to desktop root.`);
+        await this.sendPowerShellCommand(INIT_ROOT_ELEMENT);
+    }
+    if (this.caps.app && this.caps.app.toLowerCase() !== 'none' && this.caps.app.toLowerCase() !== 'root') {
+        this.log.info(`Application path specified in capabilities: ${this.caps.app}`);
+        const envVarsSet = new Set();
+        const matches = this.caps.app.matchAll(/%([^%]+)%/g);
+        for (const match of matches) {
+            envVarsSet.add(match[1]);
+        }
+        const envVars = Array.from(envVarsSet);
+        this.log.info(`Detected the following environment variables in app path: ${envVars.map((envVar) => `%${envVar}%`).join(', ')}`);
+        for (const envVar of envVars) {
+            this.caps.app = this.caps.app.replaceAll(`%${envVar}%`, spawnEnv[envVar.toUpperCase()] ?? '');
+        }
+        await this.changeRootElement(this.caps.app);
+    }
+    if (this.caps.appTopLevelWindow) {
+        const nativeWindowHandle = Number(this.caps.appTopLevelWindow);
+        if (isNaN(nativeWindowHandle)) {
+            throw new base_driver_1.errors.InvalidArgumentError(`Invalid capabilities. Capability 'appTopLevelWindow' is not a valid native window handle.`);
+        }
+        await this.changeRootElement(nativeWindowHandle);
+    }
+}
+async function sendIsolatedPowerShellCommand(command) {
+    const magicNumber = 0xF2EE;
+    const spawnEnv = this.caps.appEnvironment
+        ? { ...process.env, ...this.caps.appEnvironment }
+        : process.env;
+    const powerShell = (0, node_child_process_1.spawn)('powershell.exe', ['-NoExit', '-Command', '-'], { env: spawnEnv });
+    try {
+        powerShell.stdout.setEncoding('utf8');
+        let localStdOut = '';
+        let localStdErr = '';
+        powerShell.stdout.on('data', (chunk) => {
+            localStdOut += chunk.toString();
+        });
+        powerShell.stderr.on('data', (chunk) => {
+            localStdErr += chunk.toString();
+        });
+        const result = await new Promise((resolve, reject) => {
+            localStdOut = '';
+            localStdErr = '';
+            powerShell.stdin.write(`${SET_UTF8_ENCODING}\n`);
+            if (this.caps.appWorkingDir) {
+                const envVarsSet = new Set();
+                const matches = this.caps.appWorkingDir.matchAll(/%([^%]+)%/g);
+                for (const match of matches) {
+                    envVarsSet.add(match[1]);
+                }
+                const envVars = Array.from(envVarsSet);
+                for (const envVar of envVars) {
+                    this.caps.appWorkingDir = this.caps.appWorkingDir.replaceAll(`%${envVar}%`, spawnEnv[envVar.toUpperCase()] ?? '');
+                }
+                powerShell.stdin.write(`Set-Location -Path '${this.caps.appWorkingDir}'\n`);
+            }
+            powerShell.stdin.write(`${command}\n`);
+            powerShell.stdin.write(/* ps1 */ `Write-Output $([char]0x${magicNumber.toString(16)})\n`);
+            const onData = (chunk) => {
+                const magicChar = String.fromCharCode(magicNumber);
+                if (chunk.toString().includes(magicChar)) {
+                    powerShell.stdout.off('data', onData);
+                    if (localStdErr) {
+                        reject(new base_driver_1.errors.UnknownError(localStdErr));
+                    }
+                    else {
+                        resolve(localStdOut.replace(`${magicChar}`, '').trim());
+                    }
+                }
+            };
+            powerShell.stdout.on('data', onData);
+        });
+        // commented out for now to avoid cluttering the logs with long command outputs
+        // this.log.debug(`PowerShell command executed:\n${command}\n\nCommand output below:\n${result}\n   --------`);
+        return result;
+    }
+    finally {
+        // Ensure the isolated PowerShell process is terminated
+        try {
+            powerShell.kill();
+        }
+        catch (e) {
+            this.log.warn(`Failed to terminate isolated PowerShell process: ${e}`);
+        }
+    }
+}
+async function sendPowerShellCommand(command) {
+    const magicNumber = 0xF2EE;
+    if (!this.powerShell) {
+        this.log.warn('PowerShell session not running. It was either closed or has crashed. Attempting to start a new session...');
+        await this.startPowerShellSession();
+    }
+    const result = await new Promise((resolve, reject) => {
+        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+        const powerShell = this.powerShell;
+        this.powerShellStdOut = '';
+        this.powerShellStdErr = '';
+        powerShell.stdin.write(`${command}\n`);
+        powerShell.stdin.write(/* ps1 */ `Write-Output $([char]0x${magicNumber.toString(16)})\n`);
+        const onData = ((chunk) => {
+            const magicChar = String.fromCharCode(magicNumber);
+            if (chunk.toString().includes(magicChar)) {
+                powerShell.stdout.off('data', onData);
+                if (this.powerShellStdErr) {
+                    reject(new base_driver_1.errors.UnknownError(this.powerShellStdErr));
+                }
+                else {
+                    resolve(this.powerShellStdOut.replace(`${magicChar}`, '').trim());
+                }
+            }
+        }).bind(this);
+        powerShell.stdout.on('data', onData);
+    });
+    // commented out for now to avoid cluttering the logs with long command outputs
+    // this.log.debug(`PowerShell command executed:\n${command}\n\nCommand output below:\n${result}\n   --------`);
+    return result;
+}
+async function terminatePowerShellSession() {
+    if (!this.powerShell) {
+        return;
+    }
+    if (this.powerShell.exitCode !== null) {
+        this.log.debug(`PowerShell session already terminated.`);
+        return;
+    }
+    this.log.debug(`Terminating PowerShell session...`);
+    const waitForClose = new Promise((resolve, reject) => {
+        if (!this.powerShell) {
+            resolve();
+        }
+        this.powerShell?.once('close', () => {
+            resolve();
+        });
+        this.powerShell?.once('error', (err) => {
+            reject(err);
+        });
+    });
+    this.powerShell.kill();
+    await waitForClose;
+    this.log.debug(`PowerShell session terminated successfully.`);
+}
+//# sourceMappingURL=powershell.js.map

package/build/lib/commands/powershell.js.map

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

package/build/lib/commands/screen-recorder.d.ts

@@ -0,0 +1,40 @@
+import type { AppiumLogger } from '@appium/types';
+export declare const DEFAULT_EXT = "mp4";
+export interface ScreenRecorderOptions {
+    fps?: number;
+    timeLimit?: number;
+    preset?: string;
+    captureCursor?: boolean;
+    captureClicks?: boolean;
+    audioInput?: string;
+    videoFilter?: string;
+}
+export interface UploadOptions {
+    remotePath?: string;
+    user?: string;
+    pass?: string;
+    method?: string;
+    headers?: Record<string, string>;
+    fileFieldName?: string;
+    formFields?: Array<[string, string]> | Record<string, string>;
+}
+export declare function uploadRecordedMedia(localFile: string, remotePath?: string, uploadOptions?: Omit<UploadOptions, 'remotePath'>): Promise<string>;
+export declare class ScreenRecorder {
+    private log;
+    private _videoPath;
+    private _process;
+    private _fps;
+    private _audioInput?;
+    private _captureCursor;
+    private _captureClicks;
+    private _preset;
+    private _videoFilter?;
+    private _timeLimit;
+    constructor(videoPath: string, log: AppiumLogger, opts?: ScreenRecorderOptions);
+    getVideoPath(): Promise<string>;
+    isRunning(): boolean;
+    _enforceTermination(): Promise<string>;
+    start(): Promise<void>;
+    stop(force?: boolean): Promise<string>;
+}
+//# sourceMappingURL=screen-recorder.d.ts.map

package/build/lib/commands/screen-recorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screen-recorder.d.ts","sourceRoot":"","sources":["../../../lib/commands/screen-recorder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAUlD,eAAO,MAAM,WAAW,QAAQ,CAAC;AAIjC,MAAM,WAAW,qBAAqB;IAClC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjE;AAkBD,wBAAsB,mBAAmB,CACrC,SAAS,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,MAAM,EACnB,aAAa,GAAE,IAAI,CAAC,aAAa,EAAE,YAAY,CAAM,GACtD,OAAO,CAAC,MAAM,CAAC,CAgBjB;AAED,qBAAa,cAAc;IACvB,OAAO,CAAC,GAAG,CAAe;IAC1B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAA2B;IAC3C,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,WAAW,CAAC,CAAS;IAC7B,OAAO,CAAC,cAAc,CAAU;IAChC,OAAO,CAAC,cAAc,CAAU;IAChC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,YAAY,CAAC,CAAS;IAC9B,OAAO,CAAC,UAAU,CAAS;gBAEf,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,EAAE,IAAI,GAAE,qBAA0B;IAY5E,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IAarC,SAAS,IAAI,OAAO;IAId,mBAAmB,IAAI,OAAO,CAAC,MAAM,CAAC;IAetC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAuEtB,IAAI,CAAC,KAAK,UAAQ,GAAG,OAAO,CAAC,MAAM,CAAC;CA6B7C"}

package/build/lib/commands/screen-recorder.js

@@ -0,0 +1,183 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScreenRecorder = exports.DEFAULT_EXT = void 0;
+exports.uploadRecordedMedia = uploadRecordedMedia;
+const support_1 = require("appium/support");
+const asyncbox_1 = require("asyncbox");
+const teen_process_1 = require("teen_process");
+const util_1 = require("../util");
+const RETRY_PAUSE = 300;
+const RETRY_TIMEOUT = 5000;
+const DEFAULT_TIME_LIMIT = 60 * 10; // 10 minutes
+const PROCESS_SHUTDOWN_TIMEOUT = 10 * 1000;
+exports.DEFAULT_EXT = 'mp4';
+const DEFAULT_FPS = 15;
+const DEFAULT_PRESET = 'veryfast';
+async function requireFfmpegPath() {
+    const bundled = (0, util_1.getBundledFfmpegPath)();
+    if (bundled) {
+        return bundled;
+    }
+    const ffmpegBinary = `ffmpeg${support_1.system.isWindows() ? '.exe' : ''}`;
+    try {
+        return await support_1.fs.which(ffmpegBinary);
+    }
+    catch {
+        throw new Error(`${ffmpegBinary} has not been found in PATH and the bundled ffmpeg is missing. ` +
+            'Please reinstall the driver or install ffmpeg manually.');
+    }
+}
+async function uploadRecordedMedia(localFile, remotePath, uploadOptions = {}) {
+    if (!remotePath) {
+        return (await support_1.util.toInMemoryBase64(localFile)).toString();
+    }
+    const { user, pass, method, headers, fileFieldName, formFields } = uploadOptions;
+    const options = {
+        method: method ?? 'PUT',
+        headers,
+        fileFieldName,
+        formFields,
+    };
+    if (user && pass) {
+        options.auth = { user, pass };
+    }
+    await support_1.net.uploadFile(localFile, remotePath, options);
+    return '';
+}
+class ScreenRecorder {
+    log;
+    _videoPath;
+    _process = null;
+    _fps;
+    _audioInput;
+    _captureCursor;
+    _captureClicks;
+    _preset;
+    _videoFilter;
+    _timeLimit;
+    constructor(videoPath, log, opts = {}) {
+        this.log = log;
+        this._videoPath = videoPath;
+        this._fps = opts.fps && opts.fps > 0 ? opts.fps : DEFAULT_FPS;
+        this._audioInput = opts.audioInput;
+        this._captureCursor = opts.captureCursor ?? false;
+        this._captureClicks = opts.captureClicks ?? false;
+        this._preset = opts.preset ?? DEFAULT_PRESET;
+        this._videoFilter = opts.videoFilter;
+        this._timeLimit = opts.timeLimit && opts.timeLimit > 0 ? opts.timeLimit : DEFAULT_TIME_LIMIT;
+    }
+    async getVideoPath() {
+        if (!(await support_1.fs.exists(this._videoPath))) {
+            return '';
+        }
+        const stat = await support_1.fs.stat(this._videoPath);
+        if (!stat.isFile()) {
+            throw new Error(`The video path '${this._videoPath}' does not point to a regular file and will not be deleted`);
+        }
+        return this._videoPath;
+    }
+    isRunning() {
+        return !!this._process?.isRunning;
+    }
+    async _enforceTermination() {
+        if (this._process && this.isRunning()) {
+            this.log.debug('Force-stopping the currently running video recording');
+            try {
+                await this._process.stop('SIGKILL');
+            }
+            catch { }
+        }
+        this._process = null;
+        const videoPath = await this.getVideoPath();
+        if (videoPath) {
+            await support_1.fs.rimraf(videoPath);
+        }
+        return '';
+    }
+    async start() {
+        const ffmpegPath = await requireFfmpegPath();
+        const args = [
+            '-loglevel', 'error',
+            '-t', String(this._timeLimit),
+            '-f', 'gdigrab',
+            ...(this._captureCursor ? ['-capture_cursor', '1'] : []),
+            ...(this._captureClicks ? ['-capture_mouse_clicks', '1'] : []),
+            '-framerate', String(this._fps),
+            '-i', 'desktop',
+            ...(this._audioInput ? ['-f', 'dshow', '-i', `audio=${this._audioInput}`] : []),
+            '-vcodec', 'libx264',
+            '-preset', this._preset,
+            '-tune', 'zerolatency',
+            '-pix_fmt', 'yuv420p',
+            '-movflags', '+faststart',
+            '-fflags', 'nobuffer',
+            '-vf', 'pad=ceil(iw/2)*2:ceil(ih/2)*2',
+            ...(this._videoFilter ? ['-filter:v', this._videoFilter] : []),
+            this._videoPath,
+        ];
+        this._process = new teen_process_1.SubProcess(ffmpegPath, args, { windowsHide: true });
+        this.log.debug(`Starting ffmpeg: ${support_1.util.quote([ffmpegPath, ...args])}`);
+        this._process.on('output', (stdout, stderr) => {
+            const out = stdout || stderr;
+            if (out?.trim()) {
+                this.log.debug(`[ffmpeg] ${out}`);
+            }
+        });
+        this._process.once('exit', async (code, signal) => {
+            this._process = null;
+            if (code === 0) {
+                this.log.debug('Screen recording exited without errors');
+            }
+            else {
+                await this._enforceTermination();
+                this.log.warn(`Screen recording exited with error code ${code}, signal ${signal}`);
+            }
+        });
+        await this._process.start(0);
+        try {
+            await (0, asyncbox_1.waitForCondition)(async () => {
+                if (await this.getVideoPath()) {
+                    return true;
+                }
+                if (!this._process) {
+                    throw new Error('ffmpeg process died unexpectedly');
+                }
+                return false;
+            }, { waitMs: RETRY_TIMEOUT, intervalMs: RETRY_PAUSE });
+        }
+        catch {
+            await this._enforceTermination();
+            throw new Error(`The expected screen record file '${this._videoPath}' does not exist. ` +
+                'Check the server log for more details');
+        }
+        this.log.info(`The video recording has started. Will timeout in ${support_1.util.pluralize('second', this._timeLimit, true)}`);
+    }
+    async stop(force = false) {
+        if (force) {
+            return await this._enforceTermination();
+        }
+        if (!this.isRunning()) {
+            this.log.debug('Screen recording is not running. Returning the recent result');
+            return await this.getVideoPath();
+        }
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(async () => {
+                await this._enforceTermination();
+                reject(new Error(`Screen recording has failed to exit after ${PROCESS_SHUTDOWN_TIMEOUT}ms`));
+            }, PROCESS_SHUTDOWN_TIMEOUT);
+            this._process?.once('exit', async (code, signal) => {
+                clearTimeout(timer);
+                if (code === 0) {
+                    resolve(await this.getVideoPath());
+                }
+                else {
+                    reject(new Error(`Screen recording exited with error code ${code}, signal ${signal}`));
+                }
+            });
+            this._process?.proc?.stdin?.write('q');
+            this._process?.proc?.stdin?.end();
+        });
+    }
+}
+exports.ScreenRecorder = ScreenRecorder;
+//# sourceMappingURL=screen-recorder.js.map

package/build/lib/commands/screen-recorder.js.map

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

package/build/lib/commands/system.d.ts

@@ -0,0 +1,4 @@
+import { Orientation } from '@appium/types';
+import { NovaWindowsDriver } from '../driver';
+export declare function getOrientation(this: NovaWindowsDriver): Orientation;
+//# sourceMappingURL=system.d.ts.map

package/build/lib/commands/system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../../lib/commands/system.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAG9C,wBAAgB,cAAc,CAAC,IAAI,EAAE,iBAAiB,GAAG,WAAW,CAEnE"}

package/build/lib/commands/system.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getOrientation = getOrientation;
+const user32_1 = require("../winapi/user32");
+function getOrientation() {
+    return (0, user32_1.getDisplayOrientation)();
+}
+//# sourceMappingURL=system.js.map

package/build/lib/commands/system.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system.js","sourceRoot":"","sources":["../../../lib/commands/system.ts"],"names":[],"mappings":";;AAIA,wCAEC;AAJD,6CAAyD;AAEzD,SAAgB,cAAc;IAC1B,OAAO,IAAA,8BAAqB,GAAE,CAAC;AACnC,CAAC"}

package/build/lib/constants.d.ts

@@ -0,0 +1,3 @@
+export declare const POWER_SHELL_FEATURE = "power_shell";
+export declare const MODIFY_FS_FEATURE = "modify_fs";
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../lib/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,gBAAgB,CAAC;AACjD,eAAO,MAAM,iBAAiB,cAAc,CAAC"}

package/build/lib/constants.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MODIFY_FS_FEATURE = exports.POWER_SHELL_FEATURE = void 0;
+exports.POWER_SHELL_FEATURE = 'power_shell';
+exports.MODIFY_FS_FEATURE = 'modify_fs';
+//# sourceMappingURL=constants.js.map

package/build/lib/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../lib/constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,mBAAmB,GAAG,aAAa,CAAC;AACpC,QAAA,iBAAiB,GAAG,WAAW,CAAC"}

package/build/lib/constraints.d.ts

@@ -0,0 +1,58 @@
+export declare const UI_AUTOMATION_DRIVER_CONSTRAINTS: {
+    readonly platformName: {
+        readonly isString: true;
+        readonly inclusionCaseInsensitive: readonly ["Windows"];
+        readonly presence: true;
+    };
+    readonly smoothPointerMove: {
+        readonly isString: true;
+    };
+    readonly delayBeforeClick: {
+        readonly isNumber: true;
+    };
+    readonly delayAfterClick: {
+        readonly isNumber: true;
+    };
+    readonly appTopLevelWindow: {
+        readonly isString: true;
+    };
+    readonly shouldCloseApp: {
+        readonly isBoolean: true;
+    };
+    readonly appArguments: {
+        readonly isString: true;
+    };
+    readonly appWorkingDir: {
+        readonly isString: true;
+    };
+    readonly prerun: {
+        readonly isObject: true;
+    };
+    readonly postrun: {
+        readonly isObject: true;
+    };
+    readonly isolatedScriptExecution: {
+        readonly isBoolean: true;
+    };
+    readonly appEnvironment: {
+        readonly isObject: true;
+    };
+    readonly 'ms:waitForAppLaunch': {
+        readonly isNumber: true;
+    };
+    readonly 'ms:forcequit': {
+        readonly isBoolean: true;
+    };
+    readonly returnAllWindowHandles: {
+        readonly isBoolean: true;
+    };
+    readonly 'ms:windowSwitchRetries': {
+        readonly isNumber: true;
+    };
+    readonly 'ms:windowSwitchInterval': {
+        readonly isNumber: true;
+    };
+};
+export default UI_AUTOMATION_DRIVER_CONSTRAINTS;
+export type NovaWindowsDriverConstraints = typeof UI_AUTOMATION_DRIVER_CONSTRAINTS;
+//# sourceMappingURL=constraints.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constraints.d.ts","sourceRoot":"","sources":["../../lib/constraints.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsDb,CAAC;AAEjC,eAAe,gCAAgC,CAAC;AAEhD,MAAM,MAAM,4BAA4B,GAAG,OAAO,gCAAgC,CAAC"}

package/build/lib/constraints.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UI_AUTOMATION_DRIVER_CONSTRAINTS = void 0;
+exports.UI_AUTOMATION_DRIVER_CONSTRAINTS = {
+    platformName: {
+        isString: true,
+        inclusionCaseInsensitive: ['Windows'],
+        presence: true,
+    },
+    smoothPointerMove: {
+        isString: true,
+    },
+    delayBeforeClick: {
+        isNumber: true,
+    },
+    delayAfterClick: {
+        isNumber: true,
+    },
+    appTopLevelWindow: {
+        isString: true,
+    },
+    shouldCloseApp: {
+        isBoolean: true,
+    },
+    appArguments: {
+        isString: true,
+    },
+    appWorkingDir: {
+        isString: true,
+    },
+    prerun: {
+        isObject: true,
+    },
+    postrun: {
+        isObject: true,
+    },
+    isolatedScriptExecution: {
+        isBoolean: true,
+    },
+    appEnvironment: {
+        isObject: true,
+    },
+    'ms:waitForAppLaunch': {
+        isNumber: true,
+    },
+    'ms:forcequit': {
+        isBoolean: true,
+    },
+    returnAllWindowHandles: {
+        isBoolean: true,
+    },
+    'ms:windowSwitchRetries': {
+        isNumber: true,
+    },
+    'ms:windowSwitchInterval': {
+        isNumber: true,
+    },
+};
+exports.default = exports.UI_AUTOMATION_DRIVER_CONSTRAINTS;
+//# sourceMappingURL=constraints.js.map

package/build/lib/constraints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constraints.js","sourceRoot":"","sources":["../../lib/constraints.ts"],"names":[],"mappings":";;;AAEa,QAAA,gCAAgC,GAAG;IAC5C,YAAY,EAAE;QACV,QAAQ,EAAE,IAAI;QACd,wBAAwB,EAAE,CAAC,SAAS,CAAC;QACrC,QAAQ,EAAE,IAAI;KACjB;IACD,iBAAiB,EAAE;QACf,QAAQ,EAAE,IAAI;KACjB;IACD,gBAAgB,EAAE;QACd,QAAQ,EAAE,IAAI;KACjB;IACD,eAAe,EAAE;QACb,QAAQ,EAAE,IAAI;KACjB;IACD,iBAAiB,EAAE;QACf,QAAQ,EAAE,IAAI;KACjB;IACD,cAAc,EAAE;QACZ,SAAS,EAAE,IAAI;KAClB;IACD,YAAY,EAAE;QACV,QAAQ,EAAE,IAAI;KACjB;IACD,aAAa,EAAE;QACX,QAAQ,EAAE,IAAI;KACjB;IACD,MAAM,EAAE;QACJ,QAAQ,EAAE,IAAI;KACjB;IACD,OAAO,EAAE;QACL,QAAQ,EAAE,IAAI;KACjB;IACD,uBAAuB,EAAE;QACrB,SAAS,EAAE,IAAI;KAClB;IACD,cAAc,EAAE;QACZ,QAAQ,EAAE,IAAI;KACjB;IACD,qBAAqB,EAAE;QACnB,QAAQ,EAAE,IAAI;KACjB;IACD,cAAc,EAAE;QACZ,SAAS,EAAE,IAAI;KAClB;IACD,sBAAsB,EAAE;QACpB,SAAS,EAAE,IAAI;KAClB;IACD,wBAAwB,EAAE;QACtB,QAAQ,EAAE,IAAI;KACjB;IACD,yBAAyB,EAAE;QACvB,QAAQ,EAAE,IAAI;KACjB;CAC2B,CAAC;AAEjC,kBAAe,wCAAgC,CAAC"}