@qapilot/appium-module 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 QAPilot
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,269 @@
+# @qapilot/appium-module
+
+Appium W3C WebDriver module for interacting with devices across **BrowserStack**, **LambdaTest**, and **local Appium** servers. Exposes a unified `invokeCommand` API that normalizes provider-specific differences (URLs, auth headers, capability formats) behind a single interface.
+
+## Installation
+
+```bash
+npm install @qapilot/appium-module
+```
+
+If you plan to use the built-in HTTP server mode, also install `express`:
+
+```bash
+npm install express
+```
+
+## Usage
+
+### Programmatic (library mode)
+
+Import `invokeCommand` and call any W3C WebDriver command against any supported provider.
+
+```typescript
+import { invokeCommand } from '@qapilot/appium-module';
+
+// Create a session on BrowserStack
+const session = await invokeCommand({
+  commandName: 'createSession',
+  provider: 'browserstack',
+  credentials: {
+    username: process.env.BS_USER,
+    accessKey: process.env.BS_KEY,
+  },
+  params: {
+    capabilities: {
+      platformName: 'Android',
+      'appium:deviceName': 'Google Pixel 6',
+      'appium:platformVersion': '12.0',
+      'appium:app': 'bs://<app-id>',
+    },
+  },
+});
+
+if (!session.success) {
+  throw new Error(session.error?.message);
+}
+
+const { sessionId } = session.data;
+
+// Find an element
+const element = await invokeCommand({
+  commandName: 'findElement',
+  provider: 'browserstack',
+  credentials: { username: process.env.BS_USER, accessKey: process.env.BS_KEY },
+  params: { sessionId, using: 'accessibility id', value: 'loginButton' },
+});
+
+// Click it
+await invokeCommand({
+  commandName: 'clickElement',
+  provider: 'browserstack',
+  credentials: { username: process.env.BS_USER, accessKey: process.env.BS_KEY },
+  params: { sessionId, elementId: element.data.elementId },
+});
+
+// Take a screenshot
+const screenshot = await invokeCommand({
+  commandName: 'getScreenshot',
+  provider: 'browserstack',
+  credentials: { username: process.env.BS_USER, accessKey: process.env.BS_KEY },
+  params: { sessionId },
+});
+
+// Delete the session
+await invokeCommand({
+  commandName: 'deleteSession',
+  provider: 'browserstack',
+  credentials: { username: process.env.BS_USER, accessKey: process.env.BS_KEY },
+  params: { sessionId },
+});
+```
+
+### Local Appium
+
+```typescript
+import { invokeCommand } from '@qapilot/appium-module';
+
+const session = await invokeCommand({
+  commandName: 'createSession',
+  provider: 'local',
+  credentials: {
+    hubUrl: 'http://localhost:4723',
+  },
+  params: {
+    capabilities: {
+      platformName: 'Android',
+      'appium:automationName': 'UiAutomator2',
+      'appium:deviceName': 'emulator-5554',
+    },
+  },
+});
+```
+
+### LambdaTest
+
+```typescript
+import { invokeCommand } from '@qapilot/appium-module';
+
+const session = await invokeCommand({
+  commandName: 'createSession',
+  provider: 'lambdatest',
+  credentials: {
+    username: process.env.LT_USER,
+    accessKey: process.env.LT_KEY,
+  },
+  params: {
+    capabilities: {
+      platformName: 'Android',
+      'appium:deviceName': 'Galaxy S21',
+      'appium:app': 'lt://<app-id>',
+    },
+  },
+});
+```
+
+## Supported Commands
+
+| Category | Commands |
+|----------|----------|
+| Session  | `createSession`, `getSession`, `deleteSession` |
+| Element  | `findElement`, `findElements`, `clickElement`, `setValue`, `clearElement`, `getElementText`, `getElementAttribute`, `getElementDisplayed`, `getElementRect`, `getElementLocation`, `getElementSize` |
+| Page     | `getScreenshot`, `getSource` |
+| Actions  | `performActions`, `touchPerform` |
+| Context  | `getContext`, `setContext`, `getContexts` |
+| Window   | `getWindow`, `getWindowHandles`, `switchWindow` |
+| Device   | `hideKeyboard`, `isKeyboardShown`, `pressKeycode`, `activateApp`, `terminateApp`, `setOrientation`, `setLocation` |
+| Script   | `executeScript`, `executeScriptSync` |
+
+Get the full list at runtime:
+
+```typescript
+import { getSupportedCommands } from '@qapilot/appium-module';
+console.log(getSupportedCommands());
+```
+
+## Extending
+
+### Custom Providers
+
+```typescript
+import { registerProvider, BaseProvider } from '@qapilot/appium-module';
+import type { IAppiumProvider, ProviderCredentials, AppiumServiceError } from '@qapilot/appium-module';
+
+class SauceLabsProvider extends BaseProvider implements IAppiumProvider {
+  readonly name = 'saucelabs' as any;
+  protected readonly hubBaseUrl = 'https://ondemand.us-west-1.saucelabs.com';
+  protected readonly wdHubPath = '/wd/hub';
+
+  buildUrl(_sessionId: string | null, path: string, credentials: ProviderCredentials): string {
+    return `${this.buildBaseUrl(credentials)}${path}`;
+  }
+
+  buildHeaders(credentials: ProviderCredentials): Record<string, string> {
+    return {
+      'Content-Type': 'application/json',
+      Authorization: this.buildBasicAuthHeader(credentials),
+    };
+  }
+
+  normalizeCapabilities(caps: Record<string, unknown>): Record<string, unknown> {
+    return caps;
+  }
+
+  normalizeError(statusCode: number, body: unknown): AppiumServiceError {
+    return this.mapW3CError(statusCode, body);
+  }
+
+  getDefaultCapabilities(): Record<string, unknown> {
+    return {};
+  }
+}
+
+registerProvider(new SauceLabsProvider());
+```
+
+### Custom Commands
+
+```typescript
+import { registerCommand, BaseCommand } from '@qapilot/appium-module';
+
+class ShakeDeviceCommand extends BaseCommand<{ sessionId: string }, void> {
+  readonly name = 'shakeDevice';
+  readonly method = 'POST' as const;
+  readonly pathTemplate = '/session/{sessionId}/appium/device/shake';
+
+  buildBody(_params: { sessionId: string }) {
+    return {};
+  }
+
+  parseResponse(_raw: unknown): void {
+    return;
+  }
+}
+
+registerCommand(new ShakeDeviceCommand());
+```
+
+## HTTP Server Mode
+
+The package also ships a standalone Express HTTP server that exposes the command invoker over REST. This is useful when you want to call Appium from a language other than Node.js, or from a microservice over HTTP.
+
+```bash
+# Run the server directly
+npx @qapilot/appium-module/server
+
+# Or in your own project (after installing express):
+node node_modules/@qapilot/appium-module/dist/server.js
+```
+
+### `POST /api/v1/execute`
+
+```json
+{
+  "commandName": "findElement",
+  "provider": "browserstack",
+  "credentials": { "username": "...", "accessKey": "..." },
+  "params": { "sessionId": "abc123", "using": "xpath", "value": "//button" }
+}
+```
+
+### `GET /api/v1/commands` — list all registered commands
+### `GET /api/v1/providers` — list all registered providers
+### `GET /api/v1/health` — liveness probe
+
+Environment variables for server mode:
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `PORT` | `8000` | HTTP port to listen on |
+| `NODE_ENV` | `development` | Set to `production` for JSON logging |
+| `LOG_LEVEL` | `info` | Pino log level |
+| `LOCAL_APPIUM_URL` | `http://localhost:4723` | Default URL for the `local` provider |
+
+## TypeScript
+
+All types are exported from the main entry point:
+
+```typescript
+import type {
+  ExecuteRequest,
+  ExecuteResponse,
+  ProviderName,
+  ProviderCredentials,
+  AppiumServiceError,
+  IAppiumProvider,
+} from '@qapilot/appium-module';
+```
+
+## Publishing
+
+```bash
+npm run build        # compile TypeScript to dist/
+npm login            # authenticate with npm
+npm publish --access public
+```
+
+## License
+
+MIT

package/dist/commands/actions/perform-actions.command.d.ts

@@ -0,0 +1,16 @@
+import type { W3CAction } from '../../types/webdriver.types.js';
+import { BaseCommand } from '../base.command.js';
+interface PerformActionsParams extends Record<string, unknown> {
+    sessionId: string;
+    actions: W3CAction[];
+}
+export declare class PerformActionsCommand extends BaseCommand<PerformActionsParams, null> {
+    readonly name = "performActions";
+    readonly method: "POST";
+    readonly pathTemplate = "/session/{sessionId}/actions";
+    validate(params: PerformActionsParams): void;
+    buildBody(params: PerformActionsParams): unknown;
+    parseResponse(_raw: unknown): null;
+}
+export {};
+//# sourceMappingURL=perform-actions.command.d.ts.map

package/dist/commands/actions/perform-actions.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"perform-actions.command.d.ts","sourceRoot":"","sources":["../../../src/commands/actions/perform-actions.command.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,UAAU,oBAAqB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC5D,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,SAAS,EAAE,CAAC;CACtB;AAED,qBAAa,qBAAsB,SAAQ,WAAW,CAAC,oBAAoB,EAAE,IAAI,CAAC;IAChF,QAAQ,CAAC,IAAI,oBAAoB;IACjC,QAAQ,CAAC,MAAM,EAAG,MAAM,CAAU;IAClC,QAAQ,CAAC,YAAY,kCAAkC;IAE9C,QAAQ,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI;IAUrD,SAAS,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO;IAIhD,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;CAGnC"}

package/dist/commands/actions/perform-actions.command.js

@@ -0,0 +1,23 @@
+import { AppiumError, AppiumErrorCode } from '../../types/error.types.js';
+import { BaseCommand } from '../base.command.js';
+export class PerformActionsCommand extends BaseCommand {
+    name = 'performActions';
+    method = 'POST';
+    pathTemplate = '/session/{sessionId}/actions';
+    validate(params) {
+        if (!Array.isArray(params.actions) || params.actions.length === 0) {
+            throw new AppiumError({
+                code: AppiumErrorCode.VALIDATION_ERROR,
+                message: '"actions" must be a non-empty array of W3C action sequences',
+                httpStatus: 400,
+            });
+        }
+    }
+    buildBody(params) {
+        return { actions: params.actions };
+    }
+    parseResponse(_raw) {
+        return null;
+    }
+}
+//# sourceMappingURL=perform-actions.command.js.map

package/dist/commands/actions/perform-actions.command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"perform-actions.command.js","sourceRoot":"","sources":["../../../src/commands/actions/perform-actions.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE1E,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAOjD,MAAM,OAAO,qBAAsB,SAAQ,WAAuC;IACvE,IAAI,GAAG,gBAAgB,CAAC;IACxB,MAAM,GAAG,MAAe,CAAC;IACzB,YAAY,GAAG,8BAA8B,CAAC;IAE9C,QAAQ,CAAC,MAA4B;QAC5C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClE,MAAM,IAAI,WAAW,CAAC;gBACpB,IAAI,EAAE,eAAe,CAAC,gBAAgB;gBACtC,OAAO,EAAE,6DAA6D;gBACtE,UAAU,EAAE,GAAG;aAChB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,SAAS,CAAC,MAA4B;QACpC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;IACrC,CAAC;IAED,aAAa,CAAC,IAAa;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/commands/actions/touch-perform.command.d.ts

@@ -0,0 +1,21 @@
+import type { TouchAction } from '../../types/webdriver.types.js';
+import { BaseCommand } from '../base.command.js';
+interface TouchPerformParams extends Record<string, unknown> {
+    sessionId: string;
+    actions: TouchAction[];
+}
+/**
+ * Legacy touch actions endpoint.
+ * Prefer PerformActionsCommand (W3C) for new implementations.
+ * Kept for compatibility with older Appium servers.
+ */
+export declare class TouchPerformCommand extends BaseCommand<TouchPerformParams, null> {
+    readonly name = "touchPerform";
+    readonly method: "POST";
+    readonly pathTemplate = "/session/{sessionId}/touch/perform";
+    validate(params: TouchPerformParams): void;
+    buildBody(params: TouchPerformParams): unknown;
+    parseResponse(_raw: unknown): null;
+}
+export {};
+//# sourceMappingURL=touch-perform.command.d.ts.map

package/dist/commands/actions/touch-perform.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"touch-perform.command.d.ts","sourceRoot":"","sources":["../../../src/commands/actions/touch-perform.command.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,UAAU,kBAAmB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC1D,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AAED;;;;GAIG;AACH,qBAAa,mBAAoB,SAAQ,WAAW,CAAC,kBAAkB,EAAE,IAAI,CAAC;IAC5E,QAAQ,CAAC,IAAI,kBAAkB;IAC/B,QAAQ,CAAC,MAAM,EAAG,MAAM,CAAU;IAClC,QAAQ,CAAC,YAAY,wCAAwC;IAEpD,QAAQ,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI;IAUnD,SAAS,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO;IAI9C,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;CAGnC"}

package/dist/commands/actions/touch-perform.command.js

@@ -0,0 +1,28 @@
+import { AppiumError, AppiumErrorCode } from '../../types/error.types.js';
+import { BaseCommand } from '../base.command.js';
+/**
+ * Legacy touch actions endpoint.
+ * Prefer PerformActionsCommand (W3C) for new implementations.
+ * Kept for compatibility with older Appium servers.
+ */
+export class TouchPerformCommand extends BaseCommand {
+    name = 'touchPerform';
+    method = 'POST';
+    pathTemplate = '/session/{sessionId}/touch/perform';
+    validate(params) {
+        if (!Array.isArray(params.actions) || params.actions.length === 0) {
+            throw new AppiumError({
+                code: AppiumErrorCode.VALIDATION_ERROR,
+                message: '"actions" must be a non-empty array of touch action objects',
+                httpStatus: 400,
+            });
+        }
+    }
+    buildBody(params) {
+        return { actions: params.actions };
+    }
+    parseResponse(_raw) {
+        return null;
+    }
+}
+//# sourceMappingURL=touch-perform.command.js.map

package/dist/commands/actions/touch-perform.command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"touch-perform.command.js","sourceRoot":"","sources":["../../../src/commands/actions/touch-perform.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE1E,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAOjD;;;;GAIG;AACH,MAAM,OAAO,mBAAoB,SAAQ,WAAqC;IACnE,IAAI,GAAG,cAAc,CAAC;IACtB,MAAM,GAAG,MAAe,CAAC;IACzB,YAAY,GAAG,oCAAoC,CAAC;IAEpD,QAAQ,CAAC,MAA0B;QAC1C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClE,MAAM,IAAI,WAAW,CAAC;gBACpB,IAAI,EAAE,eAAe,CAAC,gBAAgB;gBACtC,OAAO,EAAE,6DAA6D;gBACtE,UAAU,EAAE,GAAG;aAChB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,SAAS,CAAC,MAA0B;QAClC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;IACrC,CAAC;IAED,aAAa,CAAC,IAAa;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/commands/base.command.d.ts

@@ -0,0 +1,36 @@
+import type { CommandRequestConfig } from '../types/command.types.js';
+import type { HttpMethod } from '../types/webdriver.types.js';
+export declare abstract class BaseCommand<TParams extends Record<string, unknown>, TResult> {
+    abstract readonly name: string;
+    abstract readonly method: HttpMethod;
+    /**
+     * W3C path template with {placeholder} tokens.
+     * e.g. '/session/{sessionId}/element/{elementId}/click'
+     * The full URL prefix (/wd/hub) is handled by the provider.
+     */
+    abstract readonly pathTemplate: string;
+    /**
+     * Validate incoming params. Throw AppiumError with VALIDATION_ERROR on failure.
+     * Default implementation is a no-op; override to add validation.
+     */
+    validate(_params: TParams): void;
+    /**
+     * Build the JSON body to send. Return undefined for GET/DELETE requests.
+     */
+    abstract buildBody(params: TParams): unknown | undefined;
+    /**
+     * Parse the raw Appium/W3C response body into a typed result.
+     */
+    abstract parseResponse(raw: unknown): TResult;
+    /**
+     * Resolve the path template to an actual path by substituting {tokens} with values from params.
+     * Override for non-standard path resolution logic.
+     */
+    resolvePath(params: TParams): string;
+    /**
+     * Build the complete request config (method, resolved path, body) from params.
+     * Called by CommandInvoker.
+     */
+    buildRequestConfig(params: TParams): CommandRequestConfig;
+}
+//# sourceMappingURL=base.command.d.ts.map

package/dist/commands/base.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.command.d.ts","sourceRoot":"","sources":["../../src/commands/base.command.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAE9D,8BAAsB,WAAW,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;IAChF,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAErC;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAEvC;;;OAGG;IAEH,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAIhC;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS;IAExD;;OAEG;IACH,QAAQ,CAAC,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO;IAE7C;;;OAGG;IACH,WAAW,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM;IAcpC;;;OAGG;IACH,kBAAkB,CAAC,MAAM,EAAE,OAAO,GAAG,oBAAoB;CAQ1D"}

package/dist/commands/base.command.js

@@ -0,0 +1,41 @@
+import { AppiumError, AppiumErrorCode } from '../types/error.types.js';
+export class BaseCommand {
+    /**
+     * Validate incoming params. Throw AppiumError with VALIDATION_ERROR on failure.
+     * Default implementation is a no-op; override to add validation.
+     */
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    validate(_params) {
+        // no-op by default
+    }
+    /**
+     * Resolve the path template to an actual path by substituting {tokens} with values from params.
+     * Override for non-standard path resolution logic.
+     */
+    resolvePath(params) {
+        return this.pathTemplate.replace(/\{(\w+)\}/g, (_, key) => {
+            const value = params[key];
+            if (value === undefined || value === null) {
+                throw new AppiumError({
+                    code: AppiumErrorCode.VALIDATION_ERROR,
+                    message: `Missing required path parameter: "${key}" for command "${this.name}"`,
+                    httpStatus: 400,
+                });
+            }
+            return String(value);
+        });
+    }
+    /**
+     * Build the complete request config (method, resolved path, body) from params.
+     * Called by CommandInvoker.
+     */
+    buildRequestConfig(params) {
+        this.validate(params);
+        return {
+            method: this.method,
+            path: this.resolvePath(params),
+            body: this.buildBody(params),
+        };
+    }
+}
+//# sourceMappingURL=base.command.js.map

package/dist/commands/base.command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.command.js","sourceRoot":"","sources":["../../src/commands/base.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAIvE,MAAM,OAAgB,WAAW;IAW/B;;;OAGG;IACH,6DAA6D;IAC7D,QAAQ,CAAC,OAAgB;QACvB,mBAAmB;IACrB,CAAC;IAYD;;;OAGG;IACH,WAAW,CAAC,MAAe;QACzB,OAAO,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,EAAE,GAAW,EAAE,EAAE;YAChE,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YAC1B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBAC1C,MAAM,IAAI,WAAW,CAAC;oBACpB,IAAI,EAAE,eAAe,CAAC,gBAAgB;oBACtC,OAAO,EAAE,qCAAqC,GAAG,kBAAkB,IAAI,CAAC,IAAI,GAAG;oBAC/E,UAAU,EAAE,GAAG;iBAChB,CAAC,CAAC;YACL,CAAC;YACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,kBAAkB,CAAC,MAAe;QAChC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACtB,OAAO;YACL,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC;YAC9B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;SAC7B,CAAC;IACJ,CAAC;CACF"}

package/dist/commands/command.registry.d.ts

@@ -0,0 +1,12 @@
+import { BaseCommand } from './base.command.js';
+type AnyCommand = BaseCommand<Record<string, unknown>, any>;
+export declare function getCommand(name: string): AnyCommand;
+export declare function hasCommand(name: string): boolean;
+export declare function getSupportedCommands(): string[];
+/**
+ * Register a custom command at runtime.
+ * Use this to extend the registry without modifying source.
+ */
+export declare function registerCommand(command: AnyCommand): void;
+export {};
+//# sourceMappingURL=command.registry.d.ts.map

package/dist/commands/command.registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.registry.d.ts","sourceRoot":"","sources":["../../src/commands/command.registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAoDhD,KAAK,UAAU,GAAG,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,CAAC;AAyD5D,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAUnD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED,wBAAgB,oBAAoB,IAAI,MAAM,EAAE,CAE/C;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAEzD"}

package/dist/commands/command.registry.js

@@ -0,0 +1,111 @@
+import { AppiumError, AppiumErrorCode } from '../types/error.types.js';
+// Session
+import { CreateSessionCommand } from './session/create-session.command.js';
+import { GetSessionCommand } from './session/get-session.command.js';
+import { DeleteSessionCommand } from './session/delete-session.command.js';
+// Element
+import { FindElementCommand } from './element/find-element.command.js';
+import { FindElementsCommand } from './element/find-elements.command.js';
+import { ClickElementCommand } from './element/click-element.command.js';
+import { SetValueCommand } from './element/set-value.command.js';
+import { ClearElementCommand } from './element/clear-element.command.js';
+import { GetElementDisplayedCommand } from './element/get-element-displayed.command.js';
+import { GetElementRectCommand } from './element/get-element-rect.command.js';
+import { GetElementAttributeCommand } from './element/get-element-attribute.command.js';
+import { GetElementLocationCommand } from './element/get-element-location.command.js';
+import { GetElementSizeCommand } from './element/get-element-size.command.js';
+import { GetElementTextCommand } from './element/get-element-text.command.js';
+// Page
+import { GetSourceCommand } from './page/get-source.command.js';
+import { GetScreenshotCommand } from './page/get-screenshot.command.js';
+// Actions
+import { PerformActionsCommand } from './actions/perform-actions.command.js';
+import { TouchPerformCommand } from './actions/touch-perform.command.js';
+// Context
+import { GetContextCommand } from './context/get-context.command.js';
+import { SetContextCommand } from './context/set-context.command.js';
+import { GetContextsCommand } from './context/get-contexts.command.js';
+// Window
+import { GetWindowHandlesCommand } from './window/get-window-handles.command.js';
+import { GetWindowCommand } from './window/get-window.command.js';
+import { SwitchWindowCommand } from './window/switch-window.command.js';
+// Device
+import { HideKeyboardCommand } from './device/hide-keyboard.command.js';
+import { IsKeyboardShownCommand } from './device/is-keyboard-shown.command.js';
+import { PressKeycodeCommand } from './device/press-keycode.command.js';
+import { ActivateAppCommand } from './device/activate-app.command.js';
+import { TerminateAppCommand } from './device/terminate-app.command.js';
+import { SetOrientationCommand } from './device/set-orientation.command.js';
+import { SetLocationCommand } from './device/set-location.command.js';
+// Script
+import { ExecuteScriptCommand } from './script/execute-script.command.js';
+import { ExecuteScriptSyncCommand } from './script/execute-script-sync.command.js';
+const commands = [
+    // Session (3)
+    new CreateSessionCommand(),
+    new GetSessionCommand(),
+    new DeleteSessionCommand(),
+    // Element (11)
+    new FindElementCommand(),
+    new FindElementsCommand(),
+    new ClickElementCommand(),
+    new SetValueCommand(),
+    new ClearElementCommand(),
+    new GetElementDisplayedCommand(),
+    new GetElementRectCommand(),
+    new GetElementAttributeCommand(),
+    new GetElementLocationCommand(),
+    new GetElementSizeCommand(),
+    new GetElementTextCommand(),
+    // Page (2)
+    new GetSourceCommand(),
+    new GetScreenshotCommand(),
+    // Actions (2)
+    new PerformActionsCommand(),
+    new TouchPerformCommand(),
+    // Context (3)
+    new GetContextCommand(),
+    new SetContextCommand(),
+    new GetContextsCommand(),
+    // Window (3)
+    new GetWindowHandlesCommand(),
+    new GetWindowCommand(),
+    new SwitchWindowCommand(),
+    // Device (7)
+    new HideKeyboardCommand(),
+    new IsKeyboardShownCommand(),
+    new PressKeycodeCommand(),
+    new ActivateAppCommand(),
+    new TerminateAppCommand(),
+    new SetOrientationCommand(),
+    new SetLocationCommand(),
+    // Script (2)
+    new ExecuteScriptCommand(),
+    new ExecuteScriptSyncCommand(),
+];
+const registry = new Map(commands.map((cmd) => [cmd.name, cmd]));
+export function getCommand(name) {
+    const command = registry.get(name);
+    if (!command) {
+        throw new AppiumError({
+            code: AppiumErrorCode.UNKNOWN_COMMAND,
+            message: `Unknown command: "${name}". Supported commands: ${[...registry.keys()].join(', ')}`,
+            httpStatus: 400,
+        });
+    }
+    return command;
+}
+export function hasCommand(name) {
+    return registry.has(name);
+}
+export function getSupportedCommands() {
+    return [...registry.keys()];
+}
+/**
+ * Register a custom command at runtime.
+ * Use this to extend the registry without modifying source.
+ */
+export function registerCommand(command) {
+    registry.set(command.name, command);
+}
+//# sourceMappingURL=command.registry.js.map

package/dist/commands/command.registry.js.map

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

package/dist/commands/context/get-context.command.d.ts

@@ -0,0 +1,13 @@
+import { BaseCommand } from '../base.command.js';
+interface GetContextParams extends Record<string, unknown> {
+    sessionId: string;
+}
+export declare class GetContextCommand extends BaseCommand<GetContextParams, string> {
+    readonly name = "getContext";
+    readonly method: "GET";
+    readonly pathTemplate = "/session/{sessionId}/context";
+    buildBody(_params: GetContextParams): undefined;
+    parseResponse(raw: unknown): string;
+}
+export {};
+//# sourceMappingURL=get-context.command.d.ts.map

package/dist/commands/context/get-context.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-context.command.d.ts","sourceRoot":"","sources":["../../../src/commands/context/get-context.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,UAAU,gBAAiB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACxD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,iBAAkB,SAAQ,WAAW,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAC1E,QAAQ,CAAC,IAAI,gBAAgB;IAC7B,QAAQ,CAAC,MAAM,EAAG,KAAK,CAAU;IACjC,QAAQ,CAAC,YAAY,kCAAkC;IAEvD,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS;IAI/C,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM;CAIpC"}

package/dist/commands/context/get-context.command.js

@@ -0,0 +1,14 @@
+import { BaseCommand } from '../base.command.js';
+export class GetContextCommand extends BaseCommand {
+    name = 'getContext';
+    method = 'GET';
+    pathTemplate = '/session/{sessionId}/context';
+    buildBody(_params) {
+        return undefined;
+    }
+    parseResponse(raw) {
+        const body = raw;
+        return String(body['value'] ?? 'NATIVE_APP');
+    }
+}
+//# sourceMappingURL=get-context.command.js.map

package/dist/commands/context/get-context.command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-context.command.js","sourceRoot":"","sources":["../../../src/commands/context/get-context.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAMjD,MAAM,OAAO,iBAAkB,SAAQ,WAAqC;IACjE,IAAI,GAAG,YAAY,CAAC;IACpB,MAAM,GAAG,KAAc,CAAC;IACxB,YAAY,GAAG,8BAA8B,CAAC;IAEvD,SAAS,CAAC,OAAyB;QACjC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,aAAa,CAAC,GAAY;QACxB,MAAM,IAAI,GAAG,GAA8B,CAAC;QAC5C,OAAO,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,YAAY,CAAC,CAAC;IAC/C,CAAC;CACF"}