appium-desktop-driver 1.2.0

package/build/lib/commands/extension.js

@@ -0,0 +1,715 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.execute = execute;
+exports.pushCacheRequest = pushCacheRequest;
+exports.patternInvoke = patternInvoke;
+exports.patternExpand = patternExpand;
+exports.patternCollapse = patternCollapse;
+exports.patternScrollIntoView = patternScrollIntoView;
+exports.patternIsMultiple = patternIsMultiple;
+exports.patternGetSelectedItem = patternGetSelectedItem;
+exports.patternGetAllSelectedItems = patternGetAllSelectedItems;
+exports.patternAddToSelection = patternAddToSelection;
+exports.patternRemoveFromSelection = patternRemoveFromSelection;
+exports.patternSelect = patternSelect;
+exports.patternToggle = patternToggle;
+exports.patternSetValue = patternSetValue;
+exports.patternGetValue = patternGetValue;
+exports.patternMaximize = patternMaximize;
+exports.patternMinimize = patternMinimize;
+exports.patternRestore = patternRestore;
+exports.patternClose = patternClose;
+exports.windowsCloseApp = windowsCloseApp;
+exports.windowsLaunchApp = windowsLaunchApp;
+exports.focusElement = focusElement;
+exports.getClipboardBase64 = getClipboardBase64;
+exports.setClipboardFromBase64 = setClipboardFromBase64;
+exports.executePowerShellScript = executePowerShellScript;
+exports.executeKeys = executeKeys;
+exports.executeClick = executeClick;
+exports.executeHover = executeHover;
+exports.executeScroll = executeScroll;
+exports.startRecordingScreen = startRecordingScreen;
+exports.stopRecordingScreen = stopRecordingScreen;
+exports.deleteFile = deleteFile;
+exports.deleteFolder = deleteFolder;
+exports.executeClickAndDrag = executeClickAndDrag;
+exports.windowsGetDeviceTime = windowsGetDeviceTime;
+exports.getWindowElement = getWindowElement;
+const base_driver_1 = require("@appium/base-driver");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+const constants_1 = require("../constants");
+const enums_1 = require("../enums");
+const powershell_1 = require("../powershell");
+const util_1 = require("../util");
+const screen_recorder_1 = require("./screen-recorder");
+const types_1 = require("../winapi/types");
+const user32_1 = require("../winapi/user32");
+const PLATFORM_COMMAND_PREFIX = 'windows:';
+const EXTENSION_COMMANDS = Object.freeze({
+    cacheRequest: 'pushCacheRequest',
+    invoke: 'patternInvoke',
+    expand: 'patternExpand',
+    collapse: 'patternCollapse',
+    isMultiple: 'patternIsMultiple',
+    scrollIntoView: 'patternScrollIntoView',
+    selectedItem: 'patternGetSelectedItem',
+    allSelectedItems: 'patternGetAllSelectedItems',
+    addToSelection: 'patternAddToSelection',
+    removeFromSelection: 'patternRemoveFromSelection',
+    select: 'patternSelect',
+    toggle: 'patternToggle',
+    setValue: 'patternSetValue',
+    getValue: 'patternGetValue',
+    maximize: 'patternMaximize',
+    minimize: 'patternMinimize',
+    restore: 'patternRestore',
+    close: 'patternClose',
+    closeApp: 'windowsCloseApp',
+    launchApp: 'windowsLaunchApp',
+    keys: 'executeKeys',
+    click: 'executeClick',
+    hover: 'executeHover',
+    scroll: 'executeScroll',
+    setFocus: 'focusElement',
+    getClipboard: 'getClipboardBase64',
+    setClipboard: 'setClipboardFromBase64',
+    startRecordingScreen: 'startRecordingScreen',
+    stopRecordingScreen: 'stopRecordingScreen',
+    deleteFile: 'deleteFile',
+    deleteFolder: 'deleteFolder',
+    clickAndDrag: 'executeClickAndDrag',
+    getDeviceTime: 'windowsGetDeviceTime',
+    getWindowElement: 'getWindowElement',
+});
+const ContentType = Object.freeze({
+    PLAINTEXT: 'plaintext',
+    IMAGE: 'image',
+});
+const TREE_FILTER_COMMAND = (0, util_1.$ /* ps1 */) `$cacheRequest.Pop(); $cacheRequest.TreeFilter = ${0}; $cacheRequest.Push()`;
+const TREE_SCOPE_COMMAND = (0, util_1.$ /* ps1 */) `$cacheRequest.Pop(); $cacheRequest.TreeScope = ${0}; $cacheRequest.Push()`;
+const AUTOMATION_ELEMENT_MODE = (0, util_1.$ /* ps1 */) `$cacheRequest.Pop(); $cacheRequest.AutomationElementMode = ${0}; $cacheRequest.Push()`;
+const SET_PLAINTEXT_CLIPBOARD_FROM_BASE64 = (0, util_1.$ /* ps1 */) `Set-Clipboard -Value ([System.Text.Encoding]::UTF8.GetString([Convert]::FromBase64String(${0})))`;
+const GET_PLAINTEXT_CLIPBOARD_BASE64 = /* ps1 */ `[Convert]::ToBase64String([System.Text.Encoding]::UTF8.GetBytes((Get-Clipboard)))`;
+const SET_IMAGE_CLIPBOARD_FROM_BASE64 = (0, util_1.$ /* ps1 */) `$b = [Convert]::FromBase64String(${0}); $s = New-Object IO.MemoryStream; $s.Write($b, 0, $b.Length); $s.Position = 0; $i = [System.Windows.Media.Imaging.BitmapFrame]::Create($s); [Windows.Clipboard]::SetImage($i); $s.Close()`;
+const GET_IMAGE_CLIPBOARD_BASE64 = (0, powershell_1.pwsh /* ps1 */) `
+    [Windows.Clipboard]::GetImage() | ForEach-Object {
+            if ($_ -ne $null) {
+                $stream = New-Object IO.MemoryStream
+            $encoder = New-Object Windows.Media.Imaging.PngBitmapEncoder
+            $encoder.Frames.Add([Windows.Media.Imaging.BitmapFrame]::Create($_))
+            $encoder.Save($stream)
+            $stream.Position = 0
+            $bytes = $stream.ToArray()
+            $base64String = [Convert]::ToBase64String($bytes)
+            $stream.Close()
+            Write-Output $base64String
+        }
+    }
+`;
+async function execute(script, args) {
+    if (script.startsWith(PLATFORM_COMMAND_PREFIX)) {
+        script = script.replace(PLATFORM_COMMAND_PREFIX, '').trim();
+        this.log.info(`Executing command '${PLATFORM_COMMAND_PREFIX} ${script}'...`);
+        if (!Object.hasOwn(EXTENSION_COMMANDS, script)) {
+            throw new base_driver_1.errors.UnknownCommandError(`Unknown command '${PLATFORM_COMMAND_PREFIX} ${script}'.`);
+        }
+        return await this[EXTENSION_COMMANDS[script]](...args);
+    }
+    if (script === 'powerShell') {
+        this.assertFeatureEnabled(constants_1.POWER_SHELL_FEATURE);
+        return await this.executePowerShellScript(args[0]);
+    }
+    if (script === 'return window.name') {
+        return await this.sendPowerShellCommand(powershell_1.AutomationElement.automationRoot.buildGetPropertyCommand(powershell_1.Property.NAME));
+    }
+    throw new base_driver_1.errors.NotImplementedError();
+}
+;
+const TREE_SCOPE_REGEX = new powershell_1.PropertyRegexMatcher('System.Windows.Automation.TreeScope', ...Object.values(powershell_1.TreeScope)).toRegex('i');
+const AUTOMATION_ELEMENT_MODE_REGEX = new powershell_1.PropertyRegexMatcher('System.Windows.Automation.AutomationElementMode', ...Object.values(powershell_1.AutomationElementMode)).toRegex('i');
+async function pushCacheRequest(cacheRequest) {
+    if (Object.keys(cacheRequest).every((key) => cacheRequest[key] === undefined)) {
+        throw new base_driver_1.errors.InvalidArgumentError('At least one property of the cache request must be set.');
+    }
+    if (cacheRequest.treeFilter) {
+        await this.sendPowerShellCommand(TREE_FILTER_COMMAND.format((0, powershell_1.convertStringToCondition)(cacheRequest.treeFilter)));
+    }
+    if (cacheRequest.treeScope) {
+        const treeScope = TREE_SCOPE_REGEX.exec(cacheRequest.treeScope)?.[1];
+        if (!treeScope || (Number(cacheRequest.treeScope) < 1 && Number(cacheRequest.treeScope) > 16)) {
+            throw new base_driver_1.errors.InvalidArgumentError(`Invalid value '${cacheRequest.treeScope}' passed to TreeScope for cache request.`);
+        }
+        await this.sendPowerShellCommand(TREE_SCOPE_COMMAND.format(isNaN(Number(cacheRequest.treeScope)) ? /* ps1 */ `[TreeScope]::${cacheRequest.treeScope}` : cacheRequest.treeScope));
+    }
+    if (cacheRequest.automationElementMode) {
+        const treeScope = AUTOMATION_ELEMENT_MODE_REGEX.exec(cacheRequest.automationElementMode)?.[1];
+        if (!treeScope || (Number(cacheRequest.automationElementMode) < 0 && Number(cacheRequest.automationElementMode) > 1)) {
+            throw new base_driver_1.errors.InvalidArgumentError(`Invalid value '${cacheRequest.automationElementMode}' passed to AutomationElementMode for cache request.`);
+        }
+        let automationElementMode;
+        if (isNaN(Number(cacheRequest.automationElementMode))) {
+            automationElementMode = /* ps1 */ `[AutomationElementMode]::${cacheRequest.automationElementMode}`;
+        }
+        else {
+            automationElementMode = cacheRequest.automationElementMode;
+        }
+        await this.sendPowerShellCommand(AUTOMATION_ELEMENT_MODE.format(automationElementMode));
+    }
+}
+async function patternInvoke(element) {
+    await this.sendPowerShellCommand(new powershell_1.FoundAutomationElement(element[base_driver_1.W3C_ELEMENT_KEY]).buildInvokeCommand());
+}
+async function patternExpand(element) {
+    await this.sendPowerShellCommand(new powershell_1.FoundAutomationElement(element[base_driver_1.W3C_ELEMENT_KEY]).buildExpandCommand());
+}
+async function patternCollapse(element) {
+    await this.sendPowerShellCommand(new powershell_1.FoundAutomationElement(element[base_driver_1.W3C_ELEMENT_KEY]).buildCollapseCommand());
+}
+async function patternScrollIntoView(element) {
+    await this.sendPowerShellCommand(new powershell_1.FoundAutomationElement(element[base_driver_1.W3C_ELEMENT_KEY]).buildScrollIntoViewCommand());
+}
+async function patternIsMultiple(element) {
+    const result = await this.sendPowerShellCommand(new powershell_1.FoundAutomationElement(element[base_driver_1.W3C_ELEMENT_KEY]).buildIsMultipleSelectCommand());
+    return result.toLowerCase() === 'true' ? true : false;
+}
+async function patternGetSelectedItem(element) {
+    const result = await this.sendPowerShellCommand(new powershell_1.FoundAutomationElement(element[base_driver_1.W3C_ELEMENT_KEY]).buildGetSelectionCommand());
+    const elId = result.split('\n').filter(Boolean)[0];
+    if (!elId) {
+        throw new base_driver_1.errors.NoSuchElementError();
+    }
+    return { [base_driver_1.W3C_ELEMENT_KEY]: elId };
+}
+async function patternGetAllSelectedItems(element) {
+    const result = await this.sendPowerShellCommand(new powershell_1.FoundAutomationElement(element[base_driver_1.W3C_ELEMENT_KEY]).buildGetSelectionCommand());
+    return result.split('\n').filter(Boolean).map((elId) => ({ [base_driver_1.W3C_ELEMENT_KEY]: elId }));
+}
+async function patternAddToSelection(element) {
+    await this.sendPowerShellCommand(new powershell_1.FoundAutomationElement(element[base_driver_1.W3C_ELEMENT_KEY]).buildAddToSelectionCommand());
+}
+async function patternRemoveFromSelection(element) {
+    await this.sendPowerShellCommand(new powershell_1.FoundAutomationElement(element[base_driver_1.W3C_ELEMENT_KEY]).buildRemoveFromSelectionCommand());
+}
+async function patternSelect(element) {
+    await this.sendPowerShellCommand(new powershell_1.FoundAutomationElement(element[base_driver_1.W3C_ELEMENT_KEY]).buildSelectCommand());
+}
+async function patternToggle(element) {
+    await this.sendPowerShellCommand(new powershell_1.FoundAutomationElement(element[base_driver_1.W3C_ELEMENT_KEY]).buildToggleCommand());
+}
+async function patternSetValue(element, value) {
+    try {
+        await this.sendPowerShellCommand(new powershell_1.FoundAutomationElement(element[base_driver_1.W3C_ELEMENT_KEY]).buildSetValueCommand(value));
+    }
+    catch {
+        await this.sendPowerShellCommand(new powershell_1.FoundAutomationElement(element[base_driver_1.W3C_ELEMENT_KEY]).buildSetRangeValueCommand(value));
+    }
+}
+async function patternGetValue(element) {
+    return await this.sendPowerShellCommand(new powershell_1.FoundAutomationElement(element[base_driver_1.W3C_ELEMENT_KEY]).buildGetValueCommand());
+}
+async function patternMaximize(element) {
+    await this.sendPowerShellCommand(new powershell_1.FoundAutomationElement(element[base_driver_1.W3C_ELEMENT_KEY]).buildMaximizeCommand());
+}
+async function patternMinimize(element) {
+    await this.sendPowerShellCommand(new powershell_1.FoundAutomationElement(element[base_driver_1.W3C_ELEMENT_KEY]).buildMinimizeCommand());
+}
+async function patternRestore(element) {
+    await this.sendPowerShellCommand(new powershell_1.FoundAutomationElement(element[base_driver_1.W3C_ELEMENT_KEY]).buildRestoreCommand());
+}
+async function patternClose(element) {
+    await this.sendPowerShellCommand(new powershell_1.FoundAutomationElement(element[base_driver_1.W3C_ELEMENT_KEY]).buildCloseCommand());
+}
+async function windowsCloseApp() {
+    return await this.closeApp();
+}
+async function windowsLaunchApp() {
+    return await this.launchApp();
+}
+async function focusElement(element) {
+    await this.sendPowerShellCommand(new powershell_1.FoundAutomationElement(element[base_driver_1.W3C_ELEMENT_KEY]).buildSetFocusCommand());
+}
+async function getClipboardBase64(contentType) {
+    if (!contentType || (contentType && typeof contentType === 'object')) {
+        contentType = contentType?.contentType ?? ContentType.PLAINTEXT;
+    }
+    switch (contentType.toLowerCase()) {
+        case ContentType.PLAINTEXT:
+            return await this.sendPowerShellCommand(GET_PLAINTEXT_CLIPBOARD_BASE64);
+        case ContentType.IMAGE:
+            return await this.sendPowerShellCommand(GET_IMAGE_CLIPBOARD_BASE64);
+        default:
+            throw new base_driver_1.errors.InvalidArgumentError(`Unsupported content type '${contentType}'.`);
+    }
+}
+async function setClipboardFromBase64(args) {
+    if (!args || typeof args !== 'object' || !args.b64Content) {
+        throw new base_driver_1.errors.InvalidArgumentError(`'b64Content' must be provided.`);
+    }
+    const contentType = args.contentType ?? ContentType.PLAINTEXT;
+    switch (contentType.toLowerCase()) {
+        case ContentType.PLAINTEXT:
+            return await this.sendPowerShellCommand(SET_PLAINTEXT_CLIPBOARD_FROM_BASE64.format(`'${args.b64Content}'`));
+        case ContentType.IMAGE:
+            return await this.sendPowerShellCommand(SET_IMAGE_CLIPBOARD_FROM_BASE64.format(`'${args.b64Content}'`));
+        default:
+            throw new base_driver_1.errors.InvalidArgumentError(`Unsupported content type '${contentType}'.`);
+    }
+}
+async function executePowerShellScript(script) {
+    if (script && typeof script === 'object') {
+        if (script.script) {
+            script = script.script;
+        }
+        else if (script.command) {
+            script = script.command;
+        }
+        else {
+            throw new base_driver_1.errors.InvalidArgumentError('Either script or command must be provided.');
+        }
+    }
+    const scriptToExecute = (0, powershell_1.pwsh) `${script}`;
+    if (this.caps.isolatedScriptExecution) {
+        return await this.sendIsolatedPowerShellCommand(scriptToExecute);
+    }
+    else {
+        return await this.sendPowerShellCommand(scriptToExecute);
+    }
+}
+async function executeKeys(keyActions) {
+    if (!Array.isArray(keyActions.actions)) {
+        keyActions.actions = [keyActions.actions];
+    }
+    keyActions.forceUnicode ??= false;
+    for (const action of keyActions.actions) {
+        if (Number(!!action.pause) + Number(!!action.text) + Number(!!action.virtualKeyCode) !== 1) {
+            throw new base_driver_1.errors.InvalidArgumentError('Either pause, text or virtualKeyCode should be set.');
+        }
+        if (action.pause) {
+            await (0, util_1.sleep)(action.pause);
+            continue;
+        }
+        if (action.virtualKeyCode) {
+            if (action.down === undefined) {
+                (0, user32_1.sendKeyboardEvents)([{
+                        wVk: action.virtualKeyCode,
+                        wScan: 0,
+                        dwFlags: 0,
+                        time: 0,
+                        dwExtraInfo: 0,
+                    }, {
+                        wVk: action.virtualKeyCode,
+                        wScan: 0,
+                        dwFlags: types_1.KeyEventFlags.KEYEVENTF_KEYUP,
+                        time: 0,
+                        dwExtraInfo: 0,
+                    }]);
+            }
+            else {
+                (0, user32_1.sendKeyboardEvents)([{
+                        wVk: action.virtualKeyCode,
+                        wScan: 0,
+                        dwFlags: action.down ? 0 : types_1.KeyEventFlags.KEYEVENTF_KEYUP,
+                        time: 0,
+                        dwExtraInfo: 0,
+                    }]);
+            }
+            continue;
+        }
+        for (const key of action.text ?? []) {
+            if (action.down !== undefined) {
+                if (action.down) {
+                    (0, user32_1.keyDown)(key, keyActions.forceUnicode);
+                }
+                else {
+                    (0, user32_1.keyUp)(key, keyActions.forceUnicode);
+                }
+            }
+            else {
+                (0, user32_1.keyDown)(key, keyActions.forceUnicode);
+                (0, user32_1.keyUp)(key, keyActions.forceUnicode);
+            }
+        }
+    }
+}
+async function executeClick(clickArgs) {
+    const { elementId, x, y, button = enums_1.ClickType.LEFT, modifierKeys = [], durationMs = 0, times = 1, interClickDelayMs = 100, } = clickArgs;
+    if ((x != null) !== (y != null)) {
+        throw new base_driver_1.errors.InvalidArgumentError('Both x and y must be provided if either is set.');
+    }
+    let pos;
+    if (elementId) {
+        if (await this.sendPowerShellCommand(/* ps1 */ `$null -eq ${new powershell_1.FoundAutomationElement(elementId).toString()}`)) {
+            const condition = new powershell_1.PropertyCondition(powershell_1.Property.RUNTIME_ID, new powershell_1.PSInt32Array(elementId.split('.').map(Number)));
+            const elId = await this.sendPowerShellCommand(powershell_1.AutomationElement.automationRoot.findFirst(powershell_1.TreeScope.SUBTREE, condition).buildCommand());
+            if (elId.trim() === '') {
+                throw new base_driver_1.errors.NoSuchElementError();
+            }
+        }
+        const rectJson = await this.sendPowerShellCommand(new powershell_1.FoundAutomationElement(elementId).buildGetElementRectCommand());
+        const rect = JSON.parse(rectJson.replaceAll(/(?:infinity)/gi, 0x7FFFFFFF.toString()));
+        pos = [
+            rect.x + (x ?? Math.trunc(rect.width / 2)),
+            rect.y + (y ?? Math.trunc(rect.height / 2)),
+        ];
+    }
+    else {
+        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+        pos = [x, y];
+    }
+    const clickTypeToButtonMapping = {
+        [enums_1.ClickType.LEFT]: 0,
+        [enums_1.ClickType.MIDDLE]: 1,
+        [enums_1.ClickType.RIGHT]: 2,
+        [enums_1.ClickType.BACK]: 3,
+        [enums_1.ClickType.FORWARD]: 4
+    };
+    const mouseButton = clickTypeToButtonMapping[button];
+    const processesModifierKeys = Array.isArray(modifierKeys) ? modifierKeys : [modifierKeys];
+    await (0, user32_1.mouseMoveAbsolute)(pos[0], pos[1], 0);
+    for (let i = 0; i < times; i++) {
+        if (i !== 0) {
+            await (0, util_1.sleep)(interClickDelayMs);
+        }
+        if (processesModifierKeys.some((key) => key.toLowerCase() === 'ctrl')) {
+            (0, user32_1.keyDown)(enums_1.Key.CONTROL);
+        }
+        if (processesModifierKeys.some((key) => key.toLowerCase() === 'alt')) {
+            (0, user32_1.keyDown)(enums_1.Key.ALT);
+        }
+        if (processesModifierKeys.some((key) => key.toLowerCase() === 'shift')) {
+            (0, user32_1.keyDown)(enums_1.Key.SHIFT);
+        }
+        if (processesModifierKeys.some((key) => key.toLowerCase() === 'win')) {
+            (0, user32_1.keyDown)(enums_1.Key.META);
+        }
+        (0, user32_1.mouseDown)(mouseButton);
+        if (durationMs > 0) {
+            await (0, util_1.sleep)(durationMs);
+        }
+        (0, user32_1.mouseUp)(mouseButton);
+        if (processesModifierKeys.some((key) => key.toLowerCase() === 'ctrl')) {
+            (0, user32_1.keyUp)(enums_1.Key.CONTROL);
+        }
+        if (processesModifierKeys.some((key) => key.toLowerCase() === 'alt')) {
+            (0, user32_1.keyUp)(enums_1.Key.ALT);
+        }
+        if (processesModifierKeys.some((key) => key.toLowerCase() === 'shift')) {
+            (0, user32_1.keyUp)(enums_1.Key.SHIFT);
+        }
+        if (processesModifierKeys.some((key) => key.toLowerCase() === 'win')) {
+            (0, user32_1.keyUp)(enums_1.Key.META);
+        }
+    }
+    if (this.caps.delayAfterClick) {
+        await (0, util_1.sleep)(this.caps.delayAfterClick ?? 0);
+    }
+}
+async function executeHover(hoverArgs) {
+    const { startElementId, startX, startY, endElementId, endX, endY, modifierKeys = [], durationMs = 500, } = hoverArgs;
+    if ((startX != null) !== (startY != null)) {
+        throw new base_driver_1.errors.InvalidArgumentError('Both startX and startY must be provided if either is set.');
+    }
+    if ((endX != null) !== (endY != null)) {
+        throw new base_driver_1.errors.InvalidArgumentError('Both endX and endY must be provided if either is set.');
+    }
+    const processesModifierKeys = Array.isArray(modifierKeys) ? modifierKeys : [modifierKeys];
+    let startPos;
+    if (startElementId) {
+        if (await this.sendPowerShellCommand(/* ps1 */ `$null -eq ${new powershell_1.FoundAutomationElement(startElementId).toString()}`)) {
+            const condition = new powershell_1.PropertyCondition(powershell_1.Property.RUNTIME_ID, new powershell_1.PSInt32Array(startElementId.split('.').map(Number)));
+            const elId = await this.sendPowerShellCommand(powershell_1.AutomationElement.automationRoot.findFirst(powershell_1.TreeScope.SUBTREE, condition).buildCommand());
+            if (elId.trim() === '') {
+                throw new base_driver_1.errors.NoSuchElementError();
+            }
+        }
+        const rectJson = await this.sendPowerShellCommand(new powershell_1.FoundAutomationElement(startElementId).buildGetElementRectCommand());
+        const rect = JSON.parse(rectJson.replaceAll(/(?:infinity)/gi, 0x7FFFFFFF.toString()));
+        startPos = [
+            rect.x + (startX ?? rect.width / 2),
+            rect.y + (startY ?? rect.height / 2)
+        ];
+    }
+    else {
+        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+        startPos = [startX, startY];
+    }
+    let endPos;
+    if (endElementId) {
+        if (await this.sendPowerShellCommand(/* ps1 */ `$null -eq ${new powershell_1.FoundAutomationElement(endElementId).toString()}`)) {
+            const condition = new powershell_1.PropertyCondition(powershell_1.Property.RUNTIME_ID, new powershell_1.PSInt32Array(endElementId.split('.').map(Number)));
+            const elId = await this.sendPowerShellCommand(powershell_1.AutomationElement.automationRoot.findFirst(powershell_1.TreeScope.SUBTREE, condition).buildCommand());
+            if (elId.trim() === '') {
+                throw new base_driver_1.errors.NoSuchElementError();
+            }
+        }
+        const rectJson = await this.sendPowerShellCommand(new powershell_1.FoundAutomationElement(endElementId).buildGetElementRectCommand());
+        const rect = JSON.parse(rectJson.replaceAll(/(?:infinity)/gi, 0x7FFFFFFF.toString()));
+        endPos = [
+            rect.x + (endX ?? rect.width / 2),
+            rect.y + (endY ?? rect.height / 2)
+        ];
+    }
+    else {
+        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+        endPos = [endX, endY];
+    }
+    await (0, user32_1.mouseMoveAbsolute)(startPos[0], startPos[1], 0);
+    if (processesModifierKeys.some((key) => key.toLowerCase() === 'ctrl')) {
+        (0, user32_1.keyDown)(enums_1.Key.CONTROL);
+    }
+    if (processesModifierKeys.some((key) => key.toLowerCase() === 'alt')) {
+        (0, user32_1.keyDown)(enums_1.Key.ALT);
+    }
+    if (processesModifierKeys.some((key) => key.toLowerCase() === 'shift')) {
+        (0, user32_1.keyDown)(enums_1.Key.SHIFT);
+    }
+    if (processesModifierKeys.some((key) => key.toLowerCase() === 'win')) {
+        (0, user32_1.keyDown)(enums_1.Key.META);
+    }
+    await (0, user32_1.mouseMoveAbsolute)(endPos[0], endPos[1], durationMs, this.caps.smoothPointerMove);
+    if (processesModifierKeys.some((key) => key.toLowerCase() === 'ctrl')) {
+        (0, user32_1.keyUp)(enums_1.Key.CONTROL);
+    }
+    if (processesModifierKeys.some((key) => key.toLowerCase() === 'alt')) {
+        (0, user32_1.keyUp)(enums_1.Key.ALT);
+    }
+    if (processesModifierKeys.some((key) => key.toLowerCase() === 'shift')) {
+        (0, user32_1.keyUp)(enums_1.Key.SHIFT);
+    }
+    if (processesModifierKeys.some((key) => key.toLowerCase() === 'win')) {
+        (0, user32_1.keyUp)(enums_1.Key.META);
+    }
+}
+async function executeScroll(scrollArgs) {
+    const { elementId, x, y, deltaX, deltaY, modifierKeys = [], } = scrollArgs;
+    if (!!elementId && ((x !== null && x !== undefined) || (y !== null && y !== undefined))) {
+        throw new base_driver_1.errors.InvalidArgumentError('Either elementId or x and y must be provided.');
+    }
+    if ((x !== null && x !== undefined) !== (y !== null && y !== undefined)) {
+        throw new base_driver_1.errors.InvalidArgumentError('Both x and y must be provided.');
+    }
+    const processesModifierKeys = Array.isArray(modifierKeys) ? modifierKeys : [modifierKeys];
+    let pos;
+    if (elementId) {
+        if (await this.sendPowerShellCommand(/* ps1 */ `$null -eq ${new powershell_1.FoundAutomationElement(elementId).toString()}`)) {
+            const condition = new powershell_1.PropertyCondition(powershell_1.Property.RUNTIME_ID, new powershell_1.PSInt32Array(elementId.split('.').map(Number)));
+            const elId = await this.sendPowerShellCommand(powershell_1.AutomationElement.automationRoot.findFirst(powershell_1.TreeScope.SUBTREE, condition).buildCommand());
+            if (elId.trim() === '') {
+                throw new base_driver_1.errors.NoSuchElementError();
+            }
+        }
+        const rectJson = await this.sendPowerShellCommand(new powershell_1.FoundAutomationElement(elementId).buildGetElementRectCommand());
+        const rect = JSON.parse(rectJson.replaceAll(/(?:infinity)/gi, 0x7FFFFFFF.toString()));
+        pos = [rect.x + (rect.width / 2), rect.y + (rect.height / 2)];
+    }
+    else {
+        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+        pos = [x, y];
+    }
+    await (0, user32_1.mouseMoveAbsolute)(pos[0], pos[1], 0);
+    if (processesModifierKeys.some((key) => key.toLowerCase() === 'ctrl')) {
+        (0, user32_1.keyDown)(enums_1.Key.CONTROL);
+    }
+    if (processesModifierKeys.some((key) => key.toLowerCase() === 'alt')) {
+        (0, user32_1.keyDown)(enums_1.Key.ALT);
+    }
+    if (processesModifierKeys.some((key) => key.toLowerCase() === 'shift')) {
+        (0, user32_1.keyDown)(enums_1.Key.SHIFT);
+    }
+    if (processesModifierKeys.some((key) => key.toLowerCase() === 'win')) {
+        (0, user32_1.keyDown)(enums_1.Key.META);
+    }
+    (0, user32_1.mouseScroll)(deltaX ?? 0, deltaY ?? 0);
+    if (processesModifierKeys.some((key) => key.toLowerCase() === 'ctrl')) {
+        (0, user32_1.keyUp)(enums_1.Key.CONTROL);
+    }
+    if (processesModifierKeys.some((key) => key.toLowerCase() === 'alt')) {
+        (0, user32_1.keyUp)(enums_1.Key.ALT);
+    }
+    if (processesModifierKeys.some((key) => key.toLowerCase() === 'shift')) {
+        (0, user32_1.keyUp)(enums_1.Key.SHIFT);
+    }
+    if (processesModifierKeys.some((key) => key.toLowerCase() === 'win')) {
+        (0, user32_1.keyUp)(enums_1.Key.META);
+    }
+}
+async function startRecordingScreen(args) {
+    const { outputPath, timeLimit, videoFps: fps, videoFilter, preset, captureCursor, captureClicks, audioInput, forceRestart = true, } = args ?? {};
+    if (this._screenRecorder?.isRunning()) {
+        this.log.debug('The screen recording is already running');
+        if (!forceRestart) {
+            this.log.debug('Doing nothing');
+            return;
+        }
+        this.log.debug('Forcing the active screen recording to stop');
+        await this._screenRecorder.stop(true);
+    }
+    else if (this._screenRecorder) {
+        this.log.debug('Clearing the recent screen recording');
+        await this._screenRecorder.stop(true);
+    }
+    this._screenRecorder = null;
+    if (outputPath) {
+        const ext = (0, node_path_1.extname)(outputPath).toLowerCase();
+        if (ext !== `.${screen_recorder_1.DEFAULT_EXT}`) {
+            throw new base_driver_1.errors.InvalidArgumentError(`outputPath must be a path to a .${screen_recorder_1.DEFAULT_EXT} file, got: '${outputPath}'`);
+        }
+    }
+    const videoPath = outputPath ?? (0, node_path_1.join)((0, node_os_1.tmpdir)(), `novawindows-recording-${Date.now()}.${screen_recorder_1.DEFAULT_EXT}`);
+    this._screenRecorder = new screen_recorder_1.ScreenRecorder(videoPath, this.log, {
+        fps: fps !== undefined ? parseInt(String(fps), 10) : undefined,
+        timeLimit: timeLimit !== undefined ? parseInt(String(timeLimit), 10) : undefined,
+        preset,
+        captureCursor,
+        captureClicks,
+        videoFilter,
+        audioInput,
+    });
+    try {
+        await this._screenRecorder.start();
+    }
+    catch (e) {
+        this._screenRecorder = null;
+        throw e;
+    }
+}
+async function stopRecordingScreen(args) {
+    if (!this._screenRecorder) {
+        this.log.debug('No screen recording has been started. Doing nothing');
+        return '';
+    }
+    this.log.debug('Retrieving the resulting video data');
+    const videoPath = await this._screenRecorder.stop();
+    if (!videoPath) {
+        this.log.debug('No video data is found. Returning an empty string');
+        return '';
+    }
+    const { remotePath, ...uploadOpts } = args ?? {};
+    return await (0, screen_recorder_1.uploadRecordedMedia)(videoPath, remotePath, uploadOpts);
+}
+async function deleteFile(args) {
+    this.assertFeatureEnabled(constants_1.MODIFY_FS_FEATURE);
+    if (!args || typeof args !== 'object' || !args.path) {
+        throw new base_driver_1.errors.InvalidArgumentError("'path' must be provided.");
+    }
+    const escapedPath = args.path.replace(/'/g, "''");
+    const useLiteralPath = /[[\][]?]/.test(args.path);
+    const pathParam = useLiteralPath ? `-LiteralPath '${escapedPath}'` : `-Path '${escapedPath}'`;
+    await this.sendPowerShellCommand(`Remove-Item ${pathParam} -Force -ErrorAction Stop`);
+}
+async function deleteFolder(args) {
+    this.assertFeatureEnabled(constants_1.MODIFY_FS_FEATURE);
+    if (!args || typeof args !== 'object' || !args.path) {
+        throw new base_driver_1.errors.InvalidArgumentError("'path' must be provided.");
+    }
+    const { path: pathArg, recursive = true } = args;
+    const escapedPath = pathArg.replace(/'/g, "''");
+    const useLiteralPath = /[[\][]?]/.test(pathArg);
+    const pathParam = useLiteralPath ? `-LiteralPath '${escapedPath}'` : `-Path '${escapedPath}'`;
+    const recurseFlag = recursive ? ' -Recurse' : '';
+    await this.sendPowerShellCommand(`Remove-Item ${pathParam} -Force${recurseFlag} -ErrorAction Stop`);
+}
+async function executeClickAndDrag(dragArgs) {
+    const { startElementId, startX, startY, endElementId, endX, endY, modifierKeys = [], durationMs = 500, button = enums_1.ClickType.LEFT, } = dragArgs ?? {};
+    if ((startX != null) !== (startY != null)) {
+        throw new base_driver_1.errors.InvalidArgumentError('Both startX and startY must be provided if either is set.');
+    }
+    if ((endX != null) !== (endY != null)) {
+        throw new base_driver_1.errors.InvalidArgumentError('Both endX and endY must be provided if either is set.');
+    }
+    const processesModifierKeys = Array.isArray(modifierKeys) ? modifierKeys : [modifierKeys];
+    const clickTypeToButtonMapping = {
+        [enums_1.ClickType.LEFT]: 0,
+        [enums_1.ClickType.MIDDLE]: 1,
+        [enums_1.ClickType.RIGHT]: 2,
+        [enums_1.ClickType.BACK]: 3,
+        [enums_1.ClickType.FORWARD]: 4,
+    };
+    const mouseButton = clickTypeToButtonMapping[button];
+    let startPos;
+    if (startElementId) {
+        if (await this.sendPowerShellCommand(/* ps1 */ `$null -eq ${new powershell_1.FoundAutomationElement(startElementId).toString()}`)) {
+            const condition = new powershell_1.PropertyCondition(powershell_1.Property.RUNTIME_ID, new powershell_1.PSInt32Array(startElementId.split('.').map(Number)));
+            const elId = await this.sendPowerShellCommand(powershell_1.AutomationElement.automationRoot.findFirst(powershell_1.TreeScope.SUBTREE, condition).buildCommand());
+            if (elId.trim() === '') {
+                throw new base_driver_1.errors.NoSuchElementError();
+            }
+        }
+        const rectJson = await this.sendPowerShellCommand(new powershell_1.FoundAutomationElement(startElementId).buildGetElementRectCommand());
+        const rect = JSON.parse(rectJson.replaceAll(/(?:infinity)/gi, 0x7FFFFFFF.toString()));
+        startPos = [
+            rect.x + (startX ?? rect.width / 2),
+            rect.y + (startY ?? rect.height / 2)
+        ];
+    }
+    else {
+        if (startX == null || startY == null) {
+            throw new base_driver_1.errors.InvalidArgumentError('Either startElementId or startX and startY must be provided.');
+        }
+        startPos = [startX, startY];
+    }
+    let endPos;
+    if (endElementId) {
+        if (await this.sendPowerShellCommand(/* ps1 */ `$null -eq ${new powershell_1.FoundAutomationElement(endElementId).toString()}`)) {
+            const condition = new powershell_1.PropertyCondition(powershell_1.Property.RUNTIME_ID, new powershell_1.PSInt32Array(endElementId.split('.').map(Number)));
+            const elId = await this.sendPowerShellCommand(powershell_1.AutomationElement.automationRoot.findFirst(powershell_1.TreeScope.SUBTREE, condition).buildCommand());
+            if (elId.trim() === '') {
+                throw new base_driver_1.errors.NoSuchElementError();
+            }
+        }
+        const rectJson = await this.sendPowerShellCommand(new powershell_1.FoundAutomationElement(endElementId).buildGetElementRectCommand());
+        const rect = JSON.parse(rectJson.replaceAll(/(?:infinity)/gi, 0x7FFFFFFF.toString()));
+        endPos = [
+            rect.x + (endX ?? rect.width / 2),
+            rect.y + (endY ?? rect.height / 2)
+        ];
+    }
+    else {
+        if (endX == null || endY == null) {
+            throw new base_driver_1.errors.InvalidArgumentError('Either endElementId or endX and endY must be provided.');
+        }
+        endPos = [endX, endY];
+    }
+    await (0, user32_1.mouseMoveAbsolute)(startPos[0], startPos[1], 0);
+    if (processesModifierKeys.some((key) => key.toLowerCase() === 'ctrl')) {
+        (0, user32_1.keyDown)(enums_1.Key.CONTROL);
+    }
+    if (processesModifierKeys.some((key) => key.toLowerCase() === 'alt')) {
+        (0, user32_1.keyDown)(enums_1.Key.ALT);
+    }
+    if (processesModifierKeys.some((key) => key.toLowerCase() === 'shift')) {
+        (0, user32_1.keyDown)(enums_1.Key.SHIFT);
+    }
+    if (processesModifierKeys.some((key) => key.toLowerCase() === 'win')) {
+        (0, user32_1.keyDown)(enums_1.Key.META);
+    }
+    (0, user32_1.mouseDown)(mouseButton);
+    await (0, user32_1.mouseMoveAbsolute)(endPos[0], endPos[1], durationMs, this.caps.smoothPointerMove);
+    (0, user32_1.mouseUp)(mouseButton);
+    if (processesModifierKeys.some((key) => key.toLowerCase() === 'ctrl')) {
+        (0, user32_1.keyUp)(enums_1.Key.CONTROL);
+    }
+    if (processesModifierKeys.some((key) => key.toLowerCase() === 'alt')) {
+        (0, user32_1.keyUp)(enums_1.Key.ALT);
+    }
+    if (processesModifierKeys.some((key) => key.toLowerCase() === 'shift')) {
+        (0, user32_1.keyUp)(enums_1.Key.SHIFT);
+    }
+    if (processesModifierKeys.some((key) => key.toLowerCase() === 'win')) {
+        (0, user32_1.keyUp)(enums_1.Key.META);
+    }
+}
+async function windowsGetDeviceTime(args) {
+    return this.getDeviceTime(undefined, args?.format);
+}
+async function getWindowElement() {
+    const result = await this.sendPowerShellCommand(powershell_1.AutomationElement.automationRoot.buildCommand());
+    const elementId = result.split('\n').map((id) => id.trim()).filter(Boolean)[0];
+    if (!elementId) {
+        throw new base_driver_1.errors.NoSuchWindowError('No active app window is found for this session.');
+    }
+    return { [base_driver_1.W3C_ELEMENT_KEY]: elementId };
+}
+//# sourceMappingURL=extension.js.map