appium-novawindows2-driver 0.1.3 → 0.1.5

package/.github/workflows/lint-build.yml

@@ -1,30 +0,0 @@
-name: Lint & Build
-
-on:
-  pull_request:
-    branches:
-      - main
-      - develop
-
-jobs:
-  build:
-
-    runs-on: ubuntu-latest
-
-    steps:
-    - name: Checkout repository
-      uses: actions/checkout@v5
-
-    - name: Set up Node.js
-      uses: actions/setup-node@v6
-      with:
-        node-version: 24.x
-
-    - name: Install dependencies
-      run: npm install --no-package-lock
-
-    - name: Lint
-      run: npm run lint
-
-    - name: Build
-      run: npm run build

package/.github/workflows/release.yml

@@ -1,39 +0,0 @@
-name: Release
-
-on:
-  workflow_dispatch:
-  push:
-    branches:
-      - main
-      - develop
-
-jobs:
-  build:
-    runs-on: ubuntu-latest
-    environment: Release
-    steps:
-    - uses: actions/checkout@v5
-    - name: Use Node.js
-      uses: actions/setup-node@v6
-      with:
-        node-version: 24.x
-    - run: npm install --no-package-lock
-      name: Install dependencies
-    - run: npm run build
-      name: Run NPM Build
-    - run: npm run lint
-      name: Run NPM Lint
-    - run: |
-        rm -rf package-lock.json node_modules
-        # Remove dev and peer dependencies from node_modules
-        npm prune --omit=dev --omit=peer --no-package-lock
-      name: Remove dev dependencies and appium peer dependencies
-    - run: npm shrinkwrap --omit=dev --omit=peer
-      name: Create shrinkwrap
-    - run: npm install --only=dev --no-package-lock
-      name: Install dev dependencies for the release
-    - run: npx semantic-release
-      env:
-        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
-      name: Release

package/.releaserc

@@ -1,41 +0,0 @@
-{
-  "branches": [
-    "main",
-    { "name": "develop", "prerelease": "preview" }
-  ],
-  "plugins": [
-    ["@semantic-release/commit-analyzer", {
-      "preset": "angular",
-      "releaseRules": [
-        { "type": "chore", "release": "patch" }
-      ]
-    }],
-    ["@semantic-release/release-notes-generator", {
-      "preset": "conventionalcommits",
-      "presetConfig": {
-        "types": [
-          { "type": "feat", "section": "Features" },
-          { "type": "fix", "section": "Bug Fixes" },
-          { "type": "perf", "section": "Performance Improvements" },
-          { "type": "revert", "section": "Reverts" },
-          { "type": "chore", "section": "Miscellaneous Chores" },
-          { "type": "refactor", "section": "Code Refactoring" },
-          { "type": "docs", "section": "Documentation", "hidden": true },
-          { "type": "style", "section": "Styles", "hidden": true },
-          { "type": "test", "section": "Tests", "hidden": true },
-          { "type": "build", "section": "Build System", "hidden": true },
-          { "type": "ci", "section": "Continuous Integration", "hidden": true }
-        ]
-      }
-    }],
-    ["@semantic-release/changelog", {
-      "changelogFile": "CHANGELOG.md"
-    }],
-    "@semantic-release/npm",
-    ["@semantic-release/git", {
-      "assets": ["docs", "package.json", "CHANGELOG.md"],
-      "message": "chore(release): ${nextRelease.version} [skip ci]\n\n${nextRelease.notes}"
-    }],
-    "@semantic-release/github"
-  ]
-}

package/CHANGELOG.md

@@ -1,33 +0,0 @@
-## [1.1.0](https://github.com/nguyenvanhuy0612/appium-novawindows-driver/compare/v1.0.1...v1.1.0) (2025-08-06)
-
-### Features
-
-* adding appArguments option ([#26](https://github.com/nguyenvanhuy0612/appium-novawindows-driver/issues/26)) ([ded917b](https://github.com/nguyenvanhuy0612/appium-novawindows-driver/commit/ded917bdf2f8d224cc9cf917958177ed0e97078b))
-
-## [1.0.1](https://github.com/nguyenvanhuy0612/appium-novawindows-driver/compare/v1.0.0...v1.0.1) (2025-04-25)
-
-### Bug Fixes
-
-* fixed crash in Node 22+ by using Buffer instead of {} with EnumDisplaySettingsA ([#17](https://github.com/nguyenvanhuy0612/appium-novawindows-driver/issues/17)) ([08e4907](https://github.com/nguyenvanhuy0612/appium-novawindows-driver/commit/08e49070020f071f3983fcb00c30e9a3ae16b9dc))
-* set shouldCloseApp's default value to true ([#18](https://github.com/nguyenvanhuy0612/appium-novawindows-driver/issues/18)) ([28dc1d4](https://github.com/nguyenvanhuy0612/appium-novawindows-driver/commit/28dc1d443d416e9a44f4ddcd2fb31828e0b92bcb))
-
-### Code Refactoring
-
-* remove unnecessary debug logging for name locator ([#19](https://github.com/nguyenvanhuy0612/appium-novawindows-driver/issues/19)) ([ad50be9](https://github.com/nguyenvanhuy0612/appium-novawindows-driver/commit/ad50be9f9b60145a2f203f294d326eb9499339fb))
-
-## 1.0.0 (2025-04-23)
-
-### Miscellaneous Chores
-
-* add .gitignore ([631fa0a](https://github.com/nguyenvanhuy0612/appium-novawindows-driver/commit/631fa0a72f5cda861215ff4d98ccc41c44d357f6))
-* adding eslint ([c05602d](https://github.com/nguyenvanhuy0612/appium-novawindows-driver/commit/c05602d1aaa7fa003394ec663302017a3027db82))
-* **ci:** add semantic-release workflow ([a9c39fd](https://github.com/nguyenvanhuy0612/appium-novawindows-driver/commit/a9c39fdab2d361678445a523a2830ea9925c4f1f))
-* **lint:** fix linting issue ([6c2cb42](https://github.com/nguyenvanhuy0612/appium-novawindows-driver/commit/6c2cb42388a7f51842a1a5bd11905a9fe0e86ce9))
-* **npm:** disable package-lock generation ([5a648ac](https://github.com/nguyenvanhuy0612/appium-novawindows-driver/commit/5a648ac7f65fcfef66afd6bf76ce2188b10d4ce9))
-* **package:** add keywords and repository info ([fa165d0](https://github.com/nguyenvanhuy0612/appium-novawindows-driver/commit/fa165d007f6a424c0f11340b59ac73e1185091d8))
-* **release:** rollback version to 0.0.1 for testing ([#11](https://github.com/nguyenvanhuy0612/appium-novawindows-driver/issues/11)) ([c4dd2c2](https://github.com/nguyenvanhuy0612/appium-novawindows-driver/commit/c4dd2c21e3067f70a11d72206fbc7f5da79380b6))
-* updated dependencies [skip ci] ([08528fb](https://github.com/nguyenvanhuy0612/appium-novawindows-driver/commit/08528fb06727df50c087940fe541730a2a13483f))
-
-### Code Refactoring
-
-* adding enums for click and updating ([89dcebf](https://github.com/nguyenvanhuy0612/appium-novawindows-driver/commit/89dcebfd026f7a68b4052f33fa2c928ba42162bf))

package/eslint.config.mjs

@@ -1,11 +0,0 @@
-// @ts-check
-
-import { defineConfig } from 'eslint/config';
-import eslint from '@eslint/js';
-import appiumConfig from '@appium/eslint-config-appium-ts';
-
-
-export default defineConfig(
-  eslint.configs.recommended,
-  ...appiumConfig,
-);

package/examples/api_test.js

@@ -1,69 +0,0 @@
-const axios = require('axios');
-
-// Configuration
-// Appium 2.x defaults to no base path. If you are using Appium 1.x or have configured a base path, add it here (e.g., http://.../wd/hub)
-const hubUrl = 'http://192.168.196.155:4723';
-
-const capabilities = {
-    "capabilities": {
-        "alwaysMatch": {
-            "platformName": "Windows",
-            "appium:automationName": "NovaWindows2",
-            "appium:app": "Root"
-        }
-    }
-};
-                   
-async function runTest() {
-    let sessionId;
-    try {
-        // 1. Create Session
-        console.log(`Sending POST to ${hubUrl}/session to create session...`);
-        const sessionRes = await axios.post(`${hubUrl}/session`, capabilities);
-
-        // Appium sends sessionId in `value.sessionId` (W3C) or just `sessionId` (JSONWP)
-        if (sessionRes.data.value && sessionRes.data.value.sessionId) {
-            sessionId = sessionRes.data.value.sessionId;
-        } else if (sessionRes.data.sessionId) {
-            sessionId = sessionRes.data.sessionId;
-        } else {
-            throw new Error('Failed to parse sessionId from response: ' + JSON.stringify(sessionRes.data));
-        }
-
-        console.log(`Session created with ID: ${sessionId}`);
-
-        // 2. Get Page Source
-        console.log(`Sending GET to ${hubUrl}/session/${sessionId}/source to get page source...`);
-        const sourceRes = await axios.get(`${hubUrl}/session/${sessionId}/source`);
-        const source = sourceRes.data.value; // W3C standard response structure { value: ... }
-
-        console.log('--- Page Source Start ---');
-        console.log(source);
-        console.log('--- Page Source End ---');
-
-    } catch (error) {
-        console.error('Error occurred:');
-        if (error.response) {
-            console.error(`Status: ${error.response.status}`);
-            console.error('Data:', JSON.stringify(error.response.data, null, 2));
-            if (error.response.status === 404) {
-                console.error('Hint: The Appium server might be using a different base path (e.g., /wd/hub). Check your server configuration.');
-            }
-        } else {
-            console.error(error.message);
-        }
-    } finally {
-        if (sessionId) {
-            // 3. Delete Session
-            try {
-                console.log(`Deleting session ${sessionId}...`);
-                await axios.delete(`${hubUrl}/session/${sessionId}`);
-                console.log('Session deleted.');
-            } catch (delErr) {
-                console.error('Failed to delete session:', delErr.message);
-            }
-        }
-    }
-}
-
-runTest();

package/examples/concurrency_test.js

@@ -1,82 +0,0 @@
-const axios = require('axios');
-
-// Configuration
-const hubUrl = 'http://192.168.196.155:4723';
-
-const capabilities = {
-    "capabilities": {
-        "alwaysMatch": {
-            "platformName": "Windows",
-            "appium:automationName": "NovaWindows2",
-            "appium:app": "Root"
-        }
-    }
-};
-
-async function runTest() {
-    let sessionId;
-    try {
-        console.log(`Sending POST to ${hubUrl}/session to create session...`);
-        const sessionRes = await axios.post(`${hubUrl}/session`, capabilities);
-
-        if (sessionRes.data.value && sessionRes.data.value.sessionId) {
-            sessionId = sessionRes.data.value.sessionId;
-        } else if (sessionRes.data.sessionId) {
-            sessionId = sessionRes.data.sessionId;
-        } else {
-            throw new Error('Failed to parse sessionId');
-        }
-
-        console.log(`Session created with ID: ${sessionId}`);
-
-        // Send 100 concurrent requests
-        const startTime = Date.now();
-        console.log('Sending 100 concurrent getPageSource requests...');
-        const promises = [];
-        for (let i = 0; i < 100; i++) {
-            const startRequestTime = Date.now();
-            promises.push(
-                axios.get(`${hubUrl}/session/${sessionId}/source`)
-                    .then(() => console.log(`Request ${i + 1} completed in ${Date.now() - startRequestTime} ms`))
-                    .catch((err) => console.error(`Request ${i + 1} failed: ${err.message}`))
-            );
-        }
-
-        await Promise.all(promises);
-        console.log('All requests finished.');
-        const endTime = Date.now();
-        console.log(`Total time taken: ${endTime - startTime} ms`);
-
-        // Send 100 sequential requests
-        const startTime2 = Date.now();
-        console.log('Sending 100 sequential getPageSource requests...');
-        for (let i = 0; i < 100; i++) {
-            const startRequestTime = Date.now();
-            await axios.get(`${hubUrl}/session/${sessionId}/source`)
-                .then(() => console.log(`Request ${i + 1} completed in ${Date.now() - startRequestTime} ms`))
-                .catch((err) => console.error(`Request ${i + 1} failed: ${err.message}`));
-        }
-        const endTime2 = Date.now();
-        console.log(`Total time taken: ${endTime2 - startTime2} ms`);
-
-        // Verify session is still alive by sending one more request
-        console.log('Sending final verification request...');
-        await axios.get(`${hubUrl}/session/${sessionId}/source`);
-        console.log('Final request succeeded.');
-
-    } catch (error) {
-        console.error('Test failed:', error.message);
-    } finally {
-        if (sessionId) {
-            try {
-                console.log(`Deleting session ${sessionId}...`);
-                await axios.delete(`${hubUrl}/session/${sessionId}`);
-                console.log('Session deleted.');
-            } catch (delErr) {
-                console.error('Failed to delete session:', delErr.message);
-            }
-        }
-    }
-}
-
-runTest();

package/examples/debug_test.js

@@ -1,36 +0,0 @@
-const { remote } = require('webdriverio');
-
-async function main() {
-    const opts = {
-        hostname: '127.0.0.1',
-        port: 4723,
-        path: '/',
-        capabilities: {
-            "platformName": "Windows",
-            "appium:automationName": "NovaWindows2",
-            "appium:app": "Root",
-            "appium:newCommandTimeout": 60
-        },
-        logLevel: 'error'
-    };
-
-    let client;
-    try {
-        console.log('Connecting...');
-        client = await remote(opts);
-        console.log('Connected.');
-        console.log('Sending Get-Date...');
-        const res = await client.executeScript('powerShell', ['Get-Date']);
-        console.log('Result:', res);
-    } catch (e) {
-        console.error('Error:', e);
-    } finally {
-        if (client) {
-            console.log('Deleting session...');
-            await client.deleteSession();
-            console.log('Session deleted.');
-        }
-    }
-}
-
-main();

package/examples/stress_test.js

@@ -1,94 +0,0 @@
-const { remote } = require('webdriverio');
-const fs = require('fs');
-const path = require('path');
-
-async function main() {
-    const opts = {
-        hostname: '192.168.196.155',
-        // hostname: '127.0.0.1',
-        port: 4723,
-        path: '/',
-        capabilities: {
-            "appium:automationName": "NovaWindows2",
-            "platformName": "Windows",
-            "appium:app": "Root",
-            "appium:newCommandTimeout": 60
-        },
-        logLevel: 'error'
-    };
-
-    console.log('Initializing session...');
-    let client;
-    try {
-        client = await remote(opts);
-        console.log('Session created successfully.');
-
-        // create function for each action in loop
-        const actions = {
-            getPageSource: async () => {
-                const startTime = Date.now();
-                try  {
-                    const source = await client.getPageSource();
-                    console.log(`Page Source retrieval successful (Length: ${source.length} chars)`);
-                } catch (e) {
-                    console.log(`Expected error: ${e}`);
-                }
-                const endTime = Date.now();
-                console.log(`getPageSource - Time taken: ${endTime - startTime} ms`);
-            },
-            getButtons: async () => {
-                const startTime = Date.now();
-                try {
-                    const buttons = await client.findElements('xpath', '//Button');
-                    console.log(`Buttons found: ${buttons.length}`);
-                } catch (e) {
-                    console.log(`Expected error: ${e}`);
-                }
-                const endTime = Date.now();
-                console.log(`getButtons - Time taken: ${endTime - startTime} ms`);
-            },
-            getProcess: async () => {
-                const startTime = Date.now();
-                try {
-                    const process = await client.executeScript('powerShell', ["Get-Process; exit 1"]);
-                    console.log(`Process retrieval successful (Length: ${process.length} chars)`);
-                } catch (e) {
-                    console.log(`Expected error: ${e}`);
-                }
-                const endTime = Date.now();
-                console.log(`getProcess - Time taken: ${endTime - startTime} ms`);
-            },
-            getWindows: async () => {
-                const startTime = Date.now();
-                try {
-                    const windows = await client.findElements('xpath', '//Window');
-                    console.log(`Windows found: ${windows.length}`);
-                } catch (e) {
-                    console.log(`Expected error: ${e}`);
-                }
-                const endTime = Date.now();
-                console.log(`getWindows - Time taken: ${endTime - startTime} ms`);
-            }
-        };
-
-        // for 100 times
-        const startTime = Date.now();
-        for (let i = 0; i < 100; i++) {
-            const startCurTime = Date.now();
-            console.log(`Start Action: ${i + 1}`);
-            for (const action in actions) {
-                await actions[action]();
-            }
-            console.log(`Total time taken for action ${i + 1}: ${Date.now() - startCurTime} ms`);
-        }
-        console.log(`Total time taken: ${Date.now() - startTime} ms`);
-    } catch (err) {
-        console.error('Failed to create session:', err);
-    } finally {
-        if (client) {
-            await client.deleteSession();
-        }
-    }
-}
-
-main();

package/examples/verify_driver.js

@@ -1,142 +0,0 @@
-const { remote } = require('webdriverio');
-const fs = require('fs');
-const path = require('path');
-
-async function main() {
-    const opts = {
-        hostname: '127.0.0.1',
-        port: 4723,
-        path: '/',
-        capabilities: {
-            "appium:automationName": "NovaWindows2",
-            "platformName": "Windows",
-            "appium:app": "Root", // Using Root to attach to desktop, verify this is supported
-            "appium:newCommandTimeout": 60
-        },
-        logLevel: 'error'
-    };
-
-    console.log('Initializing session...');
-    let client;
-    try {
-        client = await remote(opts);
-        console.log('Session created successfully.');
-    } catch (err) {
-        console.error('Failed to create session:', err);
-        return;
-    }
-
-    try {
-        // 1. Get Page Source
-        console.log('Test 1: Get Page Source (SKIPPED - too slow for Root)');
-        //const source = await client.getPageSource();
-        //console.log(`Page Source retrieval successful (Length: ${source.length} chars)`);
-
-        // 2. Maximize Window
-        // Note: For Root, maximize might not be applicable to the "desktop" window itself in the same way, 
-        // but we can try getting window size or finding a window to maximize. 
-        // For simplicity, we just log window size.
-        console.log('Test 2: Get Window Rect');
-        const rect = await client.getWindowRect();
-        console.log(`Window Rect: ${JSON.stringify(rect)}`);
-
-        // 3. Take Screenshot
-        console.log('Test 3: Take Screenshot');
-        const screenshotPath = path.resolve(__dirname, 'screenshot.png');
-        await client.saveScreenshot(screenshotPath);
-        if (fs.existsSync(screenshotPath)) {
-            console.log(`Screenshot saved to: ${screenshotPath}`);
-        } else {
-            console.error('Screenshot failed to save.');
-        }
-
-        // 4. Find Element
-        console.log('Test 4: Find Element (XPath)');
-        // Try to find the Taskbar or Start button. 
-        // Common on Windows 10/11: "Starry" or name="Start"
-        // Let's try a generic find first
-        const element = await client.$('//*');
-        if (element.error) {
-            console.error('Failed to find root element');
-        } else {
-            console.log(`Found root element with ID: ${element.elementId}`);
-        }
-
-
-
-        // 5. Get Window Handle
-        console.log('Test 5: Get Window Handle');
-        const handle = await client.getWindowHandle();
-        console.log(`Window Handle: ${handle}`);
-
-        // 6. Execute powershell command
-        console.log('Test 6: Execute powershell command');
-        const result = await client.executeScript('powerShell', [{ 'command': 'Get-Process' }]);
-        // console.log(`Result: ${JSON.stringify(result)}`); // Output can be huge, maybe truncate
-        console.log(`Result length: ${JSON.stringify(result).length} chars`);
-
-        // 7. Execute powershell command with exit
-        console.log('Test 7: Execute powershell command with exit');
-        try {
-            const resultExit = await client.executeScript('powerShell', [{ 'command': 'Get-Process; exit 0' }]);
-            console.log(`Result exit length: ${JSON.stringify(resultExit).length}`);
-        } catch (e) {
-            console.log(`Test 7 encountered error as expected (or unexpected): ${e.message}`);
-        }
-
-        // 7.5 Recovery Check
-        console.log('Test 7.5: Recovery Check with simple command');
-        console.log('Waiting 2 seconds...');
-        await new Promise(resolve => setTimeout(resolve, 2000));
-        try {
-            const output = await client.executeScript('powerShell', [{ command: 'Get-Process | Select-Object -First 1' }]);
-            console.log('Test 7.5 passed. Recovery seems to work for simple commands.');
-        } catch (e) {
-            console.error('Test 7.5 failed:', e.message);
-        }
-
-        // 8. Click on Start button (Safe Locator)
-        console.log('Test 8: Click on Start button (Safe Locator)');
-        console.log('Waiting 3 seconds before Test 8...');
-        await new Promise(resolve => setTimeout(resolve, 3000));
-
-        // Use direct child path to avoid deep recursion on Root
-        let startButton;
-        try {
-            // Try to find Taskbar by class name (direct child of Root usually)
-            // Then find Start button inside it.
-            // Note: XPath `//` is recursive. We want direct child.
-            // But client.$ calls `xpathToElIdOrIds`.
-            // If we use `xpath`, we can force direct children?
-            // `/Pane[@ClassName="Shell_TrayWnd"]` is absolute path from Root?
-            // No, `xpath-analyzer` treats `/` as absolute from root.
-            // Let's try finding Taskbar first using absolute path.
-
-            // However, client.$ prefixing is tricky if we don't start with /
-            // If we start with /, it's absolute.
-
-            const taskbar = await client.$('/Pane[@ClassName="Shell_TrayWnd"]');
-            startButton = await taskbar.$('Button[@Name="Start"]');
-        } catch (e) {
-            console.log('Safe locator failed: ' + e.message);
-        }
-
-        if (!startButton || startButton.error) {
-            console.log('Could not find Start button with safe locator. Skipping click.');
-        } else {
-            await startButton.click();
-            console.log('Clicked Start button (Test 8 passed).');
-        }
-
-    } catch (err) {
-        console.error('Test execution failed:', err);
-    } finally {
-        if (client) {
-            console.log('Deleting session...');
-            await client.deleteSession();
-            console.log('Session deleted.');
-        }
-    }
-}
-
-main();