@kraken-e2e/driver-ios 1.0.0

package/dist/wdio-session.js

@@ -0,0 +1,126 @@
+import { randomUUID } from 'node:crypto';
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { CORE_OPERATIONS, KrakenError, } from '@kraken-e2e/contracts';
+import { IOS_HID_KEY_USAGES, toIosSelector } from './locators.js';
+const DEFAULT_WAIT_MS = 10_000;
+/**
+ * UserSession adapter for XCUITest. All 11 core operations are supported —
+ * pressKey included, via device-level HID keyboard events (contract 2.0):
+ * the M1 gate first BLOCKED on a pressKey asymmetry, the mandated research
+ * found the faithful mechanism, and SemanticKey was redefined (back removed —
+ * an Android-only concept). Governance working as designed (ADR-0001 §5.4).
+ */
+export class IosUserSession {
+    browser;
+    services;
+    actorId;
+    driverId = 'ios';
+    platform;
+    capabilities;
+    #disposed = false;
+    #screenshots = 0;
+    /** Distinguishes artifacts across the run's many sessions (one per scenario). */
+    #sessionTag = randomUUID().slice(0, 8);
+    constructor(browser, actor, services) {
+        this.browser = browser;
+        this.services = services;
+        this.actorId = actor.id;
+        this.platform = actor.platform;
+        this.capabilities = Object.fromEntries(CORE_OPERATIONS.map((op) => [op, 'supported']));
+    }
+    async #element(target) {
+        const selector = toIosSelector(target);
+        const element = await this.browser.$(selector);
+        if (element.error || (element.elementId === undefined && !(await element.isExisting()))) {
+            throw new KrakenError('KRK-SESSION-ELEMENT-NOT-FOUND', `Actor "${this.actorId}" (ios) found no element for ${target.by}="${target.value}".`, {
+                data: { selector, target: { ...target } },
+                fix: target.by === 'testId'
+                    ? 'Check the accessibility identifier in the app (Appium Inspector helps), or use { by: "native" } with a class chain/predicate.'
+                    : undefined,
+            });
+        }
+        return element;
+    }
+    async tap(target) {
+        await (await this.#element(target)).click();
+    }
+    async typeText(target, text) {
+        await (await this.#element(target)).setValue(text);
+    }
+    async readText(target) {
+        return (await this.#element(target)).getText();
+    }
+    async waitFor(target, state, opts) {
+        const selector = toIosSelector(target);
+        const element = await this.browser.$(selector);
+        const timeout = opts?.timeoutMs ?? DEFAULT_WAIT_MS;
+        const interval = opts?.pollMs ?? 100;
+        try {
+            if (state === 'attached') {
+                await element.waitForExist({ timeout, interval });
+            }
+            else {
+                await element.waitForDisplayed({ timeout, interval, reverse: state === 'hidden' });
+            }
+        }
+        catch (cause) {
+            throw new KrakenError('KRK-SESSION-WAIT-TIMEOUT', `Actor "${this.actorId}" (ios) waited ${timeout}ms for ${target.by}="${target.value}" to be ${state}.`, { cause, data: { selector } });
+        }
+    }
+    async isDisplayed(target) {
+        const element = await this.browser.$(toIosSelector(target));
+        if (element.error || (element.elementId === undefined && !(await element.isExisting()))) {
+            return false;
+        }
+        return element.isDisplayed();
+    }
+    async scrollIntoView(target) {
+        const element = await this.#element(target);
+        await this.browser.execute('mobile: scroll', {
+            elementId: element.elementId,
+            toVisible: true,
+        });
+    }
+    async pressKey(key) {
+        // FAITHFUL system-key semantics via device-level HID keyboard events
+        // (contract 2.0; live-verified on iOS 18.6 — ADR-0008 amendment).
+        await this.browser.execute('mobile: performIoHidEvent', {
+            page: 0x07,
+            usage: IOS_HID_KEY_USAGES[key],
+            durationSeconds: 0.005,
+        });
+    }
+    async navigate(destination) {
+        await this.browser.execute('mobile: deepLink', { url: destination });
+    }
+    async screenshot() {
+        this.#screenshots += 1;
+        const base64 = await this.browser.takeScreenshot();
+        const dir = join(this.services.artifactsDir, this.actorId);
+        mkdirSync(dir, { recursive: true });
+        const path = join(dir, `ios-${this.#sessionTag}-${this.#screenshots}.png`);
+        writeFileSync(path, Buffer.from(base64, 'base64'));
+        return { kind: 'screenshot', path };
+    }
+    async source() {
+        return this.browser.getPageSource();
+    }
+    async dispose() {
+        if (this.#disposed)
+            return;
+        this.#disposed = true;
+        try {
+            await this.browser.deleteSession();
+        }
+        catch (cause) {
+            this.services.logger.debug('deleteSession failed during dispose (ignored)', {
+                cause: cause instanceof Error ? cause.message : String(cause),
+            });
+        }
+    }
+    native(kind) {
+        throw new KrakenError('KRK-SESSION-OP-UNSUPPORTED', `native("${String(kind)}") is not exposed by driver-ios yet (planned: ADR-0008).`);
+    }
+}
+//# sourceMappingURL=wdio-session.js.map

package/dist/wdio-session.js.map

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

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@kraken-e2e/driver-ios",
+  "version": "1.0.0",
+  "description": "iOS driver: Appium 3 + appium-xcuitest-driver (hostRequirements: darwin — macOS only, Apple platform restriction)",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./manifest": {
+      "types": "./dist/manifest.d.ts",
+      "default": "./dist/manifest.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=22.13.0"
+  },
+  "peerDependencies": {
+    "@kraken-e2e/contracts": "^0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.0",
+    "typescript": "~6.0.3",
+    "vitest": "^4.1.9",
+    "@kraken-e2e/contracts": "0.1.0",
+    "@kraken-e2e/core": "0.1.0"
+  },
+  "dependencies": {
+    "appium": "3.5.2",
+    "appium-xcuitest-driver": "11.17.1",
+    "webdriverio": "9.29.1"
+  },
+  "license": "GPL-3.0-only",
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  }
+}