swipium 1.0.0

package/dist/lib/simctl.js

@@ -0,0 +1,149 @@
+// iOS Simulator helpers (PHASE3-PLAN Phase 11) via `xcrun simctl` — local, macOS host only. Covers
+// the lifecycle + screenshot + deep links + privacy/erase that simctl supports natively. UI-tree
+// reads and input injection are NOT available through simctl (they need an XCUITest backend, a
+// attach WebDriverAgent for structured iOS automation, so SimctlDriver reports those as
+// unsupported rather than faking them.
+// All spawns use arg arrays (injection-safe). Tool/binary names (xcrun/simctl/plutil) are CLI
+// invocations, not configuration to surface.
+import { readFileSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { run } from './spawn.js';
+const X = 'xcrun';
+/** Is the simulator toolchain usable on this host (macOS + the `xcrun simctl` command-line tools)? */
+export async function simctlAvailable() {
+    if (process.platform !== 'darwin')
+        return false;
+    try {
+        const r = await run(X, ['simctl', 'help'], { timeoutMs: 8000 });
+        return r.code === 0;
+    }
+    catch {
+        return false;
+    }
+}
+function prettyRuntime(key) {
+    // runtime key '<reverse-dns>.SimRuntime.iOS-18-0' → 'iOS 18.0'
+    const m = key.match(/SimRuntime\.([A-Za-z]+)-([\d-]+)$/);
+    return m ? `${m[1]} ${m[2].replace(/-/g, '.')}` : key;
+}
+export async function listSimulators() {
+    const r = await run(X, ['simctl', 'list', 'devices', 'available', '--json'], { timeoutMs: 15000 });
+    const out = [];
+    try {
+        const j = JSON.parse(r.stdout);
+        for (const [rt, list] of Object.entries(j.devices)) {
+            for (const d of list)
+                out.push({ udid: d.udid, name: d.name, state: d.state, runtime: prettyRuntime(rt) });
+        }
+    }
+    catch {
+        /* malformed */
+    }
+    return out;
+}
+export async function boot(udid) {
+    // 'Unable to boot ... current state: Booted' is fine — treat already-booted as success.
+    const r = await run(X, ['simctl', 'boot', udid], { timeoutMs: 120000 });
+    if (r.code !== 0 && !/current state: Booted/i.test(r.stderr)) {
+        throw new Error(`boot failed: ${r.stderr.trim() || r.stdout.trim()}`);
+    }
+    const ready = await run(X, ['simctl', 'bootstatus', udid, '-b'], { timeoutMs: 120000 });
+    if (ready.code !== 0) {
+        throw new Error(`bootstatus failed: ${ready.stderr.trim() || ready.stdout.trim()}`);
+    }
+}
+export async function shutdown(udid) {
+    const r = await run(X, ['simctl', 'shutdown', udid], { timeoutMs: 60000 });
+    if (r.code !== 0 && !/current state: Shutdown/i.test(r.stderr))
+        throw new Error(`shutdown failed: ${r.stderr.trim()}`);
+}
+export async function installApp(udid, appPath) {
+    await run(X, ['simctl', 'install', udid, appPath], { timeoutMs: 120000, rejectOnNonZero: true });
+}
+export async function uninstallApp(udid, bundleId) {
+    await run(X, ['simctl', 'uninstall', udid, bundleId], { timeoutMs: 60000 });
+}
+export function classifyIosInstallFailure(message) {
+    if (/wrong architecture|unsupported architecture|missing required architecture|mach-o/i.test(message) ||
+        /not built .*simulator|built for .*device|built for iOS(?! Simulator)|iphoneos/i.test(message)) {
+        return 'WRONG_ARCH';
+    }
+    return 'INSTALL_FAILED';
+}
+export async function launchApp(udid, bundleId) {
+    await run(X, ['simctl', 'launch', udid, bundleId], { timeoutMs: 30000, rejectOnNonZero: true });
+}
+export async function launchAppWithArgs(udid, bundleId, args) {
+    const argv = Object.entries(args).flatMap(([key, value]) => [`--${key}`, String(value)]);
+    await run(X, ['simctl', 'launch', '--terminate-running-process', udid, bundleId, ...argv], { timeoutMs: 30000, rejectOnNonZero: true });
+}
+export async function terminateApp(udid, bundleId) {
+    // Not-running is not an error for our purposes.
+    await run(X, ['simctl', 'terminate', udid, bundleId], { timeoutMs: 15000 });
+}
+export async function isInstalled(udid, bundleId) {
+    const r = await run(X, ['simctl', 'get_app_container', udid, bundleId], { timeoutMs: 10000 });
+    return r.code === 0 && r.stdout.trim().length > 0;
+}
+/** Erase requires the device be shut down first. */
+export async function erase(udid) {
+    await shutdown(udid).catch(() => { });
+    await run(X, ['simctl', 'erase', udid], { timeoutMs: 60000, rejectOnNonZero: true });
+}
+export async function screenshot(udid) {
+    // NOTE: `simctl io screenshot -` (stdout) is unreliable across toolchain versions (it can try to
+    // "save" to a file literally named "-" on a read-only volume). Write to a temp file + read back.
+    const tmp = join(tmpdir(), `swipium-ios-${udid}-${Date.now()}.png`);
+    try {
+        await run(X, ['simctl', 'io', udid, 'screenshot', '--type', 'png', tmp], { timeoutMs: 20000, rejectOnNonZero: true });
+        return readFileSync(tmp);
+    }
+    finally {
+        try {
+            rmSync(tmp, { force: true });
+        }
+        catch {
+            /* best-effort cleanup */
+        }
+    }
+}
+export async function openUrl(udid, url) {
+    await run(X, ['simctl', 'openurl', udid, url], { timeoutMs: 15000, rejectOnNonZero: true });
+}
+export function simulatorLogArgs(udid, opts = {}) {
+    const args = ['simctl', 'spawn', udid, 'log', 'show', '--style', 'compact', '--last', opts.last ?? '5m'];
+    if (opts.bundleId) {
+        args.push('--predicate', `eventMessage CONTAINS[c] "${opts.bundleId}" OR processImagePath CONTAINS[c] "${opts.bundleId}" OR subsystem CONTAINS[c] "${opts.bundleId}"`);
+    }
+    return args;
+}
+export async function simulatorLogs(udid, opts = {}) {
+    const r = await run(X, simulatorLogArgs(udid, opts), { timeoutMs: 20000, rejectOnNonZero: true });
+    return [r.stdout, r.stderr].filter(Boolean).join('\n');
+}
+/** Reset a privacy permission (service e.g. location, photos, camera, contacts, all). */
+export async function privacyReset(udid, service, bundleId) {
+    const args = ['simctl', 'privacy', udid, 'reset', service];
+    if (bundleId)
+        args.push(bundleId);
+    await run(X, args, { timeoutMs: 15000, rejectOnNonZero: true });
+}
+export async function privacySet(udid, action, service, bundleId) {
+    const args = ['simctl', 'privacy', udid, action, service];
+    if (bundleId)
+        args.push(bundleId);
+    await run(X, args, { timeoutMs: 15000, rejectOnNonZero: true });
+}
+/** Read CFBundleIdentifier from a built .app via plutil. */
+export async function bundleIdFromApp(appPath) {
+    try {
+        const r = await run('plutil', ['-extract', 'CFBundleIdentifier', 'raw', '-o', '-', `${appPath}/Info.plist`], { timeoutMs: 8000 });
+        const id = r.stdout.trim();
+        return id && r.code === 0 ? id : null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=simctl.js.map

package/dist/lib/simctl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"simctl.js","sourceRoot":"","sources":["../../src/lib/simctl.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,iGAAiG;AACjG,+FAA+F;AAC/F,wFAAwF;AACxF,uCAAuC;AACvC,8FAA8F;AAC9F,6CAA6C;AAE7C,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAUjC,MAAM,CAAC,GAAG,OAAO,CAAC;AAElB,sGAAsG;AACtG,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAChD,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAChE,OAAO,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC;IACtB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,GAAW;IAChC,+DAA+D;IAC/D,MAAM,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACzD,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;AACxD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,MAAM,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;IACnG,MAAM,GAAG,GAAgB,EAAE,CAAC;IAC5B,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAsF,CAAC;QACpH,KAAK,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;YACnD,KAAK,MAAM,CAAC,IAAI,IAAI;gBAAE,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,aAAa,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QAC7G,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,eAAe;IACjB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,IAAY;IACrC,wFAAwF;IACxF,MAAM,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;IACxE,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7D,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACxE,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;IACxF,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,sBAAsB,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACtF,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IAAY;IACzC,MAAM,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3E,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;AACzH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY,EAAE,OAAe;IAC5D,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,CAAC;AACnG,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAY,EAAE,QAAgB;IAC/D,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,OAAe;IACvD,IACE,mFAAmF,CAAC,IAAI,CAAC,OAAO,CAAC;QACjG,gFAAgF,CAAC,IAAI,CAAC,OAAO,CAAC,EAC9F,CAAC;QACD,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAY,EAAE,QAAgB;IAC5D,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,CAAC;AAClG,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAY,EAAE,QAAgB,EAAE,IAA6B;IACnG,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,GAAG,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACzF,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,6BAA6B,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,CAAC;AAC1I,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAY,EAAE,QAAgB;IAC/D,gDAAgD;IAChD,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAY,EAAE,QAAgB;IAC9D,MAAM,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC,QAAQ,EAAE,mBAAmB,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;IAC9F,OAAO,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;AACpD,CAAC;AAED,oDAAoD;AACpD,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,IAAY;IACtC,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACrC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,CAAC;AACvF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY;IAC3C,iGAAiG;IACjG,iGAAiG;IACjG,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,eAAe,IAAI,IAAI,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACpE,IAAI,CAAC;QACH,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,CAAC;QACtH,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;YAAS,CAAC;QACT,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,yBAAyB;QAC3B,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAY,EAAE,GAAW;IACrD,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,CAAC;AAC9F,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,OAA6C,EAAE;IAC5F,MAAM,IAAI,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC;IACzG,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClB,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,6BAA6B,IAAI,CAAC,QAAQ,sCAAsC,IAAI,CAAC,QAAQ,+BAA+B,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC;IACzK,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAY,EAAE,OAA6C,EAAE;IAC/F,MAAM,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC,EAAE,gBAAgB,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,CAAC;IAClG,OAAO,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzD,CAAC;AAED,yFAAyF;AACzF,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAY,EAAE,OAAe,EAAE,QAAiB;IACjF,MAAM,IAAI,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC3D,IAAI,QAAQ;QAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAClC,MAAM,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY,EAAE,MAAoC,EAAE,OAAe,EAAE,QAAiB;IACrH,MAAM,IAAI,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1D,IAAI,QAAQ;QAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAClC,MAAM,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,CAAC;AAClE,CAAC;AAED,4DAA4D;AAC5D,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAAe;IACnD,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,MAAM,GAAG,CAAC,QAAQ,EAAE,CAAC,UAAU,EAAE,oBAAoB,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,OAAO,aAAa,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAClI,MAAM,EAAE,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAC3B,OAAO,EAAE,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/lib/spawn.js

@@ -0,0 +1,144 @@
+// Safe process execution: arg arrays only (never shell strings → injection-safe,
+// DESIGN §10.1), with timeout + AbortSignal threading.
+import { spawn } from 'node:child_process';
+import { basename } from 'node:path';
+export class GitScopeForbiddenError extends Error {
+    code = 'GIT_SCOPE_FORBIDDEN';
+    constructor(command) {
+        super(`Git is outside Swipium's QA scope; refused command "${command}"`);
+        this.name = 'GitScopeForbiddenError';
+    }
+}
+function executableName(command) {
+    const base = basename(command).toLowerCase();
+    return base.replace(/\.(exe|cmd|bat)$/i, '');
+}
+function isShell(command) {
+    return ['sh', 'bash', 'zsh', 'fish', 'cmd', 'powershell', 'pwsh'].includes(executableName(command));
+}
+function shellCommandPayload(command, args) {
+    if (!isShell(command))
+        return null;
+    const shell = executableName(command);
+    const cIndex = args.findIndex((arg) => (arg === '-c'
+        || arg === '/c'
+        || arg === '/C'
+        || arg.toLowerCase() === '-command'
+        || (['sh', 'bash', 'zsh', 'fish'].includes(shell) && /^-[A-Za-z]*c[A-Za-z]*$/.test(arg))));
+    return cIndex >= 0 && typeof args[cIndex + 1] === 'string' ? args[cIndex + 1] : null;
+}
+function stripTokenQuotes(token) {
+    let out = token.trim();
+    while ((out.startsWith('"') && out.endsWith('"')) || (out.startsWith("'") && out.endsWith("'"))) {
+        out = out.slice(1, -1).trim();
+    }
+    return out;
+}
+function shellPayloadGitToken(payload) {
+    for (const raw of payload.split(/[\s;&|(){}<>]+/)) {
+        const token = stripTokenQuotes(raw);
+        if (!token || /^[A-Za-z_][A-Za-z0-9_]*=/.test(token))
+            continue;
+        if (executableName(token) === 'git')
+            return token;
+    }
+    return null;
+}
+export function gitScopeViolation(argv) {
+    const command = Array.isArray(argv) ? argv[0] : argv;
+    if (!command)
+        return null;
+    if (executableName(command) === 'git')
+        return command;
+    if (Array.isArray(argv)) {
+        const payload = shellCommandPayload(command, argv.slice(1));
+        const shellGit = payload ? shellPayloadGitToken(payload) : null;
+        if (shellGit)
+            return shellGit;
+    }
+    return null;
+}
+export function assertNoGitScope(command, args = []) {
+    const bad = gitScopeViolation([command, ...args]);
+    if (bad)
+        throw new GitScopeForbiddenError(bad);
+}
+export function run(cmd, args, opts = {}) {
+    try {
+        assertNoGitScope(cmd, args);
+    }
+    catch (e) {
+        return Promise.reject(e);
+    }
+    return new Promise((resolve, reject) => {
+        const child = spawn(cmd, args, { cwd: opts.cwd, signal: opts.signal });
+        let stdout = '';
+        let stderr = '';
+        let timedOut = false;
+        const timer = opts.timeoutMs
+            ? setTimeout(() => {
+                timedOut = true;
+                child.kill('SIGKILL');
+            }, opts.timeoutMs)
+            : undefined;
+        child.stdout.on('data', (d) => (stdout += d.toString()));
+        child.stderr.on('data', (d) => (stderr += d.toString()));
+        child.on('error', (err) => {
+            if (timer)
+                clearTimeout(timer);
+            reject(err);
+        });
+        child.on('close', (code) => {
+            if (timer)
+                clearTimeout(timer);
+            const result = { code, stdout, stderr, timedOut };
+            if (opts.rejectOnNonZero && code !== 0) {
+                reject(new Error(`\`${cmd} ${args.join(' ')}\` exited ${code}${timedOut ? ' (timed out)' : ''}: ${stderr.trim()}`));
+                return;
+            }
+            resolve(result);
+        });
+        if (opts.input !== undefined) {
+            child.stdin.write(opts.input);
+            child.stdin.end();
+        }
+    });
+}
+/** Like run(), but collects stdout as raw bytes (for screenshots etc.). */
+export function runBinary(cmd, args, opts = {}) {
+    try {
+        assertNoGitScope(cmd, args);
+    }
+    catch (e) {
+        return Promise.reject(e);
+    }
+    return new Promise((resolve, reject) => {
+        const child = spawn(cmd, args, { cwd: opts.cwd, signal: opts.signal });
+        const chunks = [];
+        let stderr = '';
+        let timedOut = false;
+        const timer = opts.timeoutMs
+            ? setTimeout(() => {
+                timedOut = true;
+                child.kill('SIGKILL');
+            }, opts.timeoutMs)
+            : undefined;
+        child.stdout.on('data', (d) => chunks.push(d));
+        child.stderr.on('data', (d) => (stderr += d.toString()));
+        child.on('error', (err) => {
+            if (timer)
+                clearTimeout(timer);
+            reject(err);
+        });
+        child.on('close', (code) => {
+            if (timer)
+                clearTimeout(timer);
+            if (opts.rejectOnNonZero && code !== 0) {
+                reject(new Error(`\`${cmd}\` exited ${code}: ${stderr.trim()}`));
+                return;
+            }
+            resolve({ code, stdout: Buffer.concat(chunks), stderr, timedOut });
+        });
+    });
+}
+//# sourceMappingURL=spawn.js.map

package/dist/lib/spawn.js.map

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

package/dist/lib/wda.js

@@ -0,0 +1,347 @@
+import { XMLParser } from 'fast-xml-parser';
+import { existsSync, readdirSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+import { run } from './spawn.js';
+const ELEMENT_KEY = 'element-6066-11e4-a52e-4f735466cecf';
+function normalizeUrl(url) {
+    return url.replace(/\/+$/, '');
+}
+async function wdaFetch(baseUrl, path, init) {
+    const res = await fetch(`${normalizeUrl(baseUrl)}${path}`, {
+        ...init,
+        headers: { 'content-type': 'application/json', ...(init?.headers ?? {}) },
+    });
+    const body = (await res.text()) || '{}';
+    let json;
+    try {
+        json = JSON.parse(body);
+    }
+    catch {
+        throw new Error(`WDA returned non-JSON ${res.status}: ${body.slice(0, 200)}`);
+    }
+    if (!res.ok) {
+        const msg = typeof json.value?.message === 'string'
+            ? json.value.message
+            : typeof json.message === 'string'
+                ? json.message
+                : body.slice(0, 200);
+        throw new Error(`WDA HTTP ${res.status}: ${msg}`);
+    }
+    return json;
+}
+function valueOf(json) {
+    return json.value ?? json;
+}
+function settingsCapabilities(settings) {
+    if (!settings)
+        return {};
+    return Object.fromEntries(Object.entries(settings).map(([key, value]) => [`settings[${key}]`, value]));
+}
+export async function checkWda(baseUrl, timeoutMs = 5000) {
+    const controller = new AbortController();
+    const t = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const res = await fetch(`${normalizeUrl(baseUrl)}/status`, { signal: controller.signal });
+        const body = (await res.text()) || '{}';
+        const json = JSON.parse(body);
+        const value = (json.value ?? json);
+        return {
+            reachable: res.ok,
+            ready: res.ok && (value.ready === true || json.status === 0 || value.state === 'success'),
+            message: typeof value.message === 'string' ? value.message : undefined,
+            build: typeof value.build === 'object' && value.build ? value.build : undefined,
+            os: typeof value.os === 'object' && value.os ? value.os : undefined,
+            ios: typeof value.ios === 'object' && value.ios ? value.ios : undefined,
+        };
+    }
+    catch (e) {
+        return { reachable: false, ready: false, error: String(e.message ?? e) };
+    }
+    finally {
+        clearTimeout(t);
+    }
+}
+export async function waitForWdaReady(baseUrl, timeoutMs, intervalMs = 1000) {
+    const started = Date.now();
+    let status = { reachable: false, ready: false, error: 'not checked yet' };
+    while (Date.now() - started < timeoutMs) {
+        status = await checkWda(baseUrl, Math.min(1500, Math.max(250, intervalMs)));
+        if (status.ready)
+            return { ready: true, status, durationMs: Date.now() - started };
+        const remaining = timeoutMs - (Date.now() - started);
+        if (remaining <= 0)
+            break;
+        await new Promise((r) => setTimeout(r, Math.min(intervalMs, remaining)));
+    }
+    return { ready: false, status, durationMs: Date.now() - started };
+}
+export async function xcodeAvailable() {
+    if (process.platform !== 'darwin')
+        return { available: false, error: 'WDA requires macOS with Xcode command line tools.' };
+    try {
+        const r = await run('xcodebuild', ['-version'], { timeoutMs: 8000 });
+        return r.code === 0 ? { available: true, version: r.stdout.trim() } : { available: false, error: r.stderr.trim() || r.stdout.trim() };
+    }
+    catch (e) {
+        return { available: false, error: String(e) };
+    }
+}
+export function discoverWdaProjects(root, extraCandidates = []) {
+    const directCandidates = [
+        ...extraCandidates,
+        process.env.WDA_PROJECT_PATH,
+        process.env.WEBDRIVERAGENT_PROJECT,
+        join(root, 'WebDriverAgent.xcodeproj'),
+        join(root, 'WebDriverAgent', 'WebDriverAgent.xcodeproj'),
+        join(root, 'ios', 'WebDriverAgent.xcodeproj'),
+        join(root, 'ios', 'WebDriverAgent', 'WebDriverAgent.xcodeproj'),
+        join(root, 'node_modules', 'appium-webdriveragent', 'WebDriverAgent.xcodeproj'),
+        join(root, 'node_modules', 'appium-xcuitest-driver', 'node_modules', 'appium-webdriveragent', 'WebDriverAgent.xcodeproj'),
+    ].filter((p) => !!p && p.trim().length > 0);
+    const found = new Set();
+    for (const p of directCandidates) {
+        if (existsSync(p) && /WebDriverAgent\.xcodeproj$/i.test(p))
+            found.add(p);
+    }
+    const searchedRoots = [root];
+    const skip = new Set(['.git', 'dist', 'build', 'DerivedData', '.swipium', 'node_modules']);
+    const stack = [{ path: root, depth: 0 }];
+    while (stack.length) {
+        const cur = stack.pop();
+        if (cur.depth > 4)
+            continue;
+        let entries;
+        try {
+            entries = readdirSync(cur.path);
+        }
+        catch {
+            continue;
+        }
+        for (const name of entries) {
+            if (skip.has(name))
+                continue;
+            const p = join(cur.path, name);
+            let st;
+            try {
+                st = statSync(p);
+            }
+            catch {
+                continue;
+            }
+            if (!st.isDirectory())
+                continue;
+            if (/WebDriverAgent\.xcodeproj$/i.test(name)) {
+                found.add(p);
+                continue;
+            }
+            stack.push({ path: p, depth: cur.depth + 1 });
+        }
+    }
+    return { candidates: [...found].sort(), searchedRoots };
+}
+export function managedWdaBuildArgs(opts) {
+    return [
+        '-project', opts.projectPath,
+        '-scheme', opts.scheme ?? 'WebDriverAgentRunner',
+        '-destination', `id=${opts.udid}`,
+        ...(opts.derivedDataPath ? ['-derivedDataPath', opts.derivedDataPath] : []),
+        ...(opts.allowProvisioningUpdates ? ['-allowProvisioningUpdates'] : []),
+        ...(opts.allowProvisioningDeviceRegistration ? ['-allowProvisioningDeviceRegistration'] : []),
+        ...(opts.authenticationKeyPath ? ['-authenticationKeyPath', opts.authenticationKeyPath] : []),
+        ...(opts.authenticationKeyId ? ['-authenticationKeyID', opts.authenticationKeyId] : []),
+        ...(opts.authenticationKeyIssuerId ? ['-authenticationKeyIssuerID', opts.authenticationKeyIssuerId] : []),
+        ...(opts.developmentTeam ? [`DEVELOPMENT_TEAM=${opts.developmentTeam}`] : []),
+        ...(opts.bundleId ? [`PRODUCT_BUNDLE_IDENTIFIER=${opts.bundleId}`] : []),
+        ...(opts.codeSignStyle ? [`CODE_SIGN_STYLE=${opts.codeSignStyle}`] : []),
+        'build-for-testing',
+    ];
+}
+export function managedWdaStartArgs(opts) {
+    return [
+        '-project', opts.projectPath,
+        '-scheme', opts.scheme ?? 'WebDriverAgentRunner',
+        '-destination', `id=${opts.udid}`,
+        ...(opts.derivedDataPath ? ['-derivedDataPath', opts.derivedDataPath] : []),
+        ...(opts.developmentTeam ? [`DEVELOPMENT_TEAM=${opts.developmentTeam}`] : []),
+        ...(opts.bundleId ? [`PRODUCT_BUNDLE_IDENTIFIER=${opts.bundleId}`] : []),
+        ...(opts.codeSignStyle ? [`CODE_SIGN_STYLE=${opts.codeSignStyle}`] : []),
+        'test-without-building',
+    ];
+}
+export function classifyWdaBuildFailure(log) {
+    if (/Signing for .* requires a development team|No profiles for|provisioning profile|Code signing is required|requires a provisioning profile|No signing certificate|No Accounts|Development Team/i.test(log)) {
+        return 'WDA_SIGNING_FAILED';
+    }
+    return 'WDA_BUILD_FAILED';
+}
+export function classifyWdaConnectionFailure(message) {
+    if (/EADDRINUSE|address already in use|port .*in use|bind.*address/i.test(message))
+        return 'WDA_PORT_CONFLICT';
+    if (/ECONNREFUSED|fetch failed|timed out|aborted|network|socket|unreachable/i.test(message))
+        return 'WDA_UNREACHABLE';
+    if (/bundle id|bundle identifier|application.*not.*installed|app.*not.*installed|no such application|could not.*launch.*app|failed to launch.*app/i.test(message))
+        return 'BUNDLE_ID_NOT_FOUND';
+    return 'WDA_SESSION_FAILED';
+}
+export async function createWdaSession(baseUrl, opts = {}) {
+    const alwaysMatch = {
+        ...(opts.capabilities ?? {}),
+        ...settingsCapabilities(opts.settings),
+    };
+    if (opts.bundleId)
+        alwaysMatch.bundleId = opts.bundleId;
+    if (opts.udid)
+        alwaysMatch.udid = opts.udid;
+    const json = await wdaFetch(baseUrl, '/session', {
+        method: 'POST',
+        body: JSON.stringify({ capabilities: { alwaysMatch } }),
+    });
+    const v = valueOf(json);
+    const sessionId = String(json.sessionId ?? v.sessionId ?? '');
+    if (!sessionId)
+        throw new Error('WDA did not return a sessionId.');
+    return { sessionId, capabilities: typeof v.capabilities === 'object' && v.capabilities ? v.capabilities : undefined };
+}
+export function wdaSessionUdid(capabilities) {
+    if (!capabilities)
+        return undefined;
+    for (const key of ['udid', 'deviceUDID', 'deviceUdid', 'appium:udid', 'appium:deviceUDID']) {
+        const value = capabilities[key];
+        if (typeof value === 'string' && value.trim())
+            return value;
+    }
+    return undefined;
+}
+export function wdaSessionUdidMismatch(capabilities, expectedUdid) {
+    if (!expectedUdid)
+        return undefined;
+    const actual = wdaSessionUdid(capabilities);
+    return actual && actual !== expectedUdid ? actual : undefined;
+}
+export async function deleteWdaSession(baseUrl, sessionId) {
+    await wdaFetch(baseUrl, `/session/${sessionId}`, { method: 'DELETE' });
+}
+export async function wdaScreenshot(baseUrl, sessionId) {
+    const json = await wdaFetch(baseUrl, `/session/${sessionId}/screenshot`);
+    return Buffer.from(String(valueOf(json)), 'base64');
+}
+export async function wdaSource(baseUrl, sessionId) {
+    const json = await wdaFetch(baseUrl, `/session/${sessionId}/source`);
+    return String(valueOf(json));
+}
+export async function wdaActiveAppInfo(baseUrl, sessionId) {
+    let json;
+    try {
+        json = await wdaFetch(baseUrl, `/session/${sessionId}/wda/activeAppInfo`);
+    }
+    catch {
+        json = await wdaFetch(baseUrl, '/wda/activeAppInfo');
+    }
+    const v = valueOf(json);
+    return {
+        bundleId: typeof v.bundleId === 'string' ? v.bundleId : undefined,
+        name: typeof v.name === 'string' ? v.name : undefined,
+        pid: typeof v.pid === 'number' ? v.pid : undefined,
+    };
+}
+export async function findWdaElement(baseUrl, sessionId, using, value) {
+    const json = await wdaFetch(baseUrl, `/session/${sessionId}/element`, {
+        method: 'POST',
+        body: JSON.stringify({ using, value }),
+    });
+    const v = valueOf(json);
+    const elementId = String(v[ELEMENT_KEY] ?? v.ELEMENT ?? v.elementId ?? '');
+    if (!elementId)
+        throw new Error(`WDA could not resolve element using ${using}=${value}.`);
+    return { elementId };
+}
+export async function tapWdaElement(baseUrl, sessionId, elementId) {
+    await wdaFetch(baseUrl, `/session/${sessionId}/element/${elementId}/click`, { method: 'POST', body: '{}' });
+}
+export async function typeWdaElement(baseUrl, sessionId, elementId, text) {
+    await wdaFetch(baseUrl, `/session/${sessionId}/element/${elementId}/value`, {
+        method: 'POST',
+        body: JSON.stringify({ value: [...text], text }),
+    });
+}
+export async function clearWdaElement(baseUrl, sessionId, elementId) {
+    await wdaFetch(baseUrl, `/session/${sessionId}/element/${elementId}/clear`, { method: 'POST', body: '{}' });
+}
+export async function tapWdaPoint(baseUrl, sessionId, x, y) {
+    await wdaFetch(baseUrl, `/session/${sessionId}/wda/tap/0`, { method: 'POST', body: JSON.stringify({ x, y }) });
+}
+export async function dragWdaPoint(baseUrl, sessionId, x1, y1, x2, y2, duration = 0.3) {
+    await wdaFetch(baseUrl, `/session/${sessionId}/wda/dragfromtoforduration`, {
+        method: 'POST',
+        body: JSON.stringify({ fromX: x1, fromY: y1, toX: x2, toY: y2, duration }),
+    });
+}
+export async function pressWdaHome(baseUrl, sessionId) {
+    await wdaFetch(baseUrl, `/session/${sessionId}/wda/homescreen`, { method: 'POST', body: '{}' });
+}
+export async function pressWdaBack(baseUrl, sessionId) {
+    await wdaFetch(baseUrl, `/session/${sessionId}/back`, { method: 'POST', body: '{}' });
+}
+function bool(v) {
+    return v === true || v === 'true' || v === 1 || v === '1';
+}
+function iosBounds(attrs) {
+    const x = Number(attrs.x ?? 0);
+    const y = Number(attrs.y ?? 0);
+    const w = Number(attrs.width ?? 0);
+    const h = Number(attrs.height ?? 0);
+    return `[${Math.round(x)},${Math.round(y)}][${Math.round(x + w)},${Math.round(y + h)}]`;
+}
+function normalizeNode(node) {
+    const type = String(node.type ?? node.name ?? 'XCUIElementTypeOther');
+    const id = String(node.identifier ?? '');
+    const label = String(node.label ?? node.name ?? '');
+    const value = String(node.value ?? '');
+    const enabled = node.enabled == null ? true : bool(node.enabled);
+    const visible = node.visible == null ? true : bool(node.visible);
+    const typeLooksInteractive = /Button|Cell|Link|Switch|Tab|Image|TextField|SecureTextField/i.test(type);
+    const clickable = node.hittable == null ? enabled && visible && typeLooksInteractive : bool(node.hittable);
+    const childValues = Object.entries(node)
+        .filter(([k]) => k === 'children' || k.startsWith('XCUIElementType'))
+        .flatMap(([, v]) => Array.isArray(v) ? v : v ? [v] : []);
+    const out = {
+        class: type,
+        text: value || label,
+        'content-desc': label,
+        'resource-id': id,
+        bounds: iosBounds(node),
+        clickable,
+        'long-clickable': false,
+        scrollable: /ScrollView|Table|CollectionView|Picker|WebView/i.test(type),
+        focusable: /TextField|SecureTextField|TextView/i.test(type),
+        focused: bool(node.focused),
+        enabled,
+        password: /SecureTextField/i.test(type),
+    };
+    if (childValues.length)
+        out.node = childValues.map((c) => normalizeNode(c));
+    return out;
+}
+function esc(v) {
+    return String(v ?? '').replace(/&/g, '&amp;').replace(/"/g, '&quot;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+}
+function nodeXml(node) {
+    const children = Array.isArray(node.node) ? node.node : [];
+    const attrs = Object.entries(node)
+        .filter(([k]) => k !== 'node')
+        .map(([k, v]) => `${k}="${esc(v)}"`)
+        .join(' ');
+    return `<node ${attrs}>${children.map(nodeXml).join('')}</node>`;
+}
+export function normalizeWdaSource(xml) {
+    const parser = new XMLParser({ ignoreAttributes: false, attributeNamePrefix: '', isArray: (name) => name.startsWith('XCUIElementType') || name === 'children' });
+    const doc = parser.parse(xml);
+    const rootKey = Object.keys(doc).find((k) => k.startsWith('XCUIElementType'));
+    if (!rootKey)
+        return xml;
+    const rootRaw = doc[rootKey];
+    const root = (Array.isArray(rootRaw) ? rootRaw[0] : rootRaw);
+    const normalized = normalizeNode({ ...root, type: root.type ?? rootKey });
+    return `<hierarchy>${nodeXml(normalized)}</hierarchy>`;
+}
+//# sourceMappingURL=wda.js.map