@allwright.dev/core 0.1.15 → 0.1.17

package/dist/bootstrap.js

@@ -12,7 +12,7 @@ const ALLWRIGHT_HOME_ENV_VAR = "ALLWRIGHT_HOME";
 const ALLWRIGHT_REPOSITORY_ENV_VAR = "ALLWRIGHT_REPOSITORY";
 const ALLWRIGHT_VERSION_ENV_VAR = "ALLWRIGHT_VERSION";
 const DEFAULT_RELEASE_REPOSITORY = "allwright-dev/allwright";
-const DEFAULT_RELEASE_VERSION = "0.1.15";
+const DEFAULT_RELEASE_VERSION = "0.1.17";
 const STARTUP_TIMEOUT_MS = 20_000;
 const PING_TIMEOUT_MS = 1_000;
 const PROTO_ROOT = fileURLToPath(new URL("../proto/", import.meta.url));

package/dist/index.d.ts

@@ -5,7 +5,7 @@ import { PageImpl } from "./page.js";
 import { setServerAddr, shutdown } from "./runtime.js";
 import type { Browser, BrowserKind, BrowserType, LaunchOptions, Page, Dialog, FileChooser, Download, HookType, ResolveConfigOptions, ResolvedAllwrightConfig } from "./types.js";
 export { findConfigFile, loadConfigFile, resolveConfig, setServerAddr, shutdown };
-export type { CapturedOption, BoundingBox, AccessibilitySnapshotOptions, AllwrightConfig, Browser, BrowserInfo, BrowserKind, BrowserType, Hook, HookType, Dialog, FileChooser, Download, ClickResult, CommandOptions, CountResult, ElementResult, FillResult, HighlightOptions, HighlightResult, LaunchOptions, MobileAndroidConnectOptions, MobileAndroidDevice, MobileAndroidLaunchOptions, MobileAndroidLocator, MobileAndroidApp, Locator, LocatorInfo, MobileSurfaceNamespace, NavigateResult, Page, PageInfo, PressOptions, PressResult, ResolveConfigOptions, ResolvedAllwrightConfig, RetryConfig, ScreenshotOptions, ScreenshotResult, TextResult, WaitForSelectorOptions, WaitForSelectorResult, } from "./types.js";
+export type { CapturedOption, BoundingBox, AccessibilitySnapshotOptions, AllwrightConfig, Browser, BrowserInfo, BrowserKind, BrowserType, Hook, HookType, Dialog, FileChooser, Download, ClickResult, CommandOptions, CountResult, ElementResult, FillResult, HighlightOptions, HighlightResult, LaunchOptions, MobileAndroidConnectOptions, MobileAndroidDevice, MobileAndroidLaunchOptions, MobileAndroidLocator, MobileAndroidApp, MobileIosConnectOptions, MobileIosDevice, MobileIosLaunchOptions, MobileIosLocator, MobileIosApp, Locator, LocatorInfo, MobileSurfaceNamespace, NavigateResult, Page, PageInfo, PressOptions, PressResult, ResolveConfigOptions, ResolvedAllwrightConfig, RetryConfig, ScreenshotOptions, ScreenshotResult, TextResult, WaitForSelectorOptions, WaitForSelectorResult, } from "./types.js";
 export declare const chromium: BrowserType;
 export declare const firefox: BrowserType;
 export declare const hooks: {

package/dist/mobile.js

@@ -605,6 +605,50 @@ class MobileAndroidDeviceImpl {
         }
     }
 }
+class MobileIosDeviceImpl {
+    sessionId;
+    surfaceSessionId;
+    runtime;
+    #stream;
+    #queue;
+    #closed = false;
+    #currentApp;
+    constructor(sessionId, surfaceSessionId, runtime, stream, queue, initialAppSessionId) {
+        this.sessionId = sessionId;
+        this.surfaceSessionId = surfaceSessionId;
+        this.runtime = runtime;
+        this.#stream = stream;
+        this.#queue = queue;
+        this.#currentApp = new MobileAndroidAppImpl(runtime, surfaceSessionId, initialAppSessionId);
+    }
+    app() { return this.#currentApp; }
+    initialApp() { return this.#currentApp; }
+    async launch(options = {}) {
+        if (this.#closed)
+            throw new Error(`ios device session ${this.sessionId} is closed`);
+        this.#stream.write({
+            launchApp: {
+                apkPath: options.appPath,
+                appId: options.appId,
+                stopBeforeLaunch: options.stopBeforeLaunch ?? false,
+                retryOptions: retryOptions(options.timeoutMs),
+            },
+        });
+        while (true) {
+            const event = await this.#queue.next();
+            if (event.appLaunched?.appSessionId) {
+                this.#currentApp = new MobileAndroidAppImpl(this.runtime, this.surfaceSessionId, event.appLaunched.appSessionId);
+                return this.#currentApp;
+            }
+            if (event.error?.message)
+                throw new Error(event.error.message);
+            if (event.closed) {
+                this.#closed = true;
+                throw new Error(`ios device session ${this.sessionId} closed while launching app`);
+            }
+        }
+    }
+}
 class MobileAndroidSurfaceImpl {
     async connect(options = {}) {
         const runtime = await getRuntime();
@@ -629,6 +673,32 @@ class MobileAndroidSurfaceImpl {
         }
     }
 }
+class MobileIosSurfaceImpl {
+    async connect(options = {}) {
+        const runtime = await getRuntime();
+        const { stream, queue } = await createBrowserSessionHandle(runtime);
+        stream.write({
+            connectMobile: {
+                platform: 2,
+                device: options.device,
+                // The protobuf slot is transport-internal and shared with the older
+                // Android endpoint field; the public iOS API names it accurately.
+                adbEndpoint: options.agentEndpoint,
+                preserveAppState: options.preserveAppState ?? false,
+                retryOptions: retryOptions(options.timeoutMs),
+            },
+        });
+        while (true) {
+            const event = await queue.next();
+            if (event.mobileConnected?.initialAppSessionId) {
+                return new MobileIosDeviceImpl(event.mobileConnected.deviceSessionId ?? event.sessionId ?? "", event.sessionId ?? "", runtime, stream, queue, event.mobileConnected.initialAppSessionId);
+            }
+            if (event.error?.message)
+                throw new Error(event.error.message);
+        }
+    }
+}
 export const mobile = {
     android: new MobileAndroidSurfaceImpl(),
+    ios: new MobileIosSurfaceImpl(),
 };

package/dist/types.d.ts

@@ -217,10 +217,33 @@ export interface MobileAndroidDevice {
     initialApp(): MobileAndroidApp;
     launch(options?: MobileAndroidLaunchOptions): Promise<MobileAndroidApp>;
 }
+export interface MobileIosConnectOptions {
+    device?: string;
+    agentEndpoint?: string;
+    preserveAppState?: boolean;
+    timeoutMs?: number;
+}
+export interface MobileIosLaunchOptions {
+    appPath?: string;
+    appId?: string;
+    stopBeforeLaunch?: boolean;
+    timeoutMs?: number;
+}
+export type MobileIosLocator = MobileAndroidLocator;
+export type MobileIosApp = MobileAndroidApp;
+export interface MobileIosDevice {
+    readonly sessionId: string;
+    app(): MobileIosApp;
+    initialApp(): MobileIosApp;
+    launch(options?: MobileIosLaunchOptions): Promise<MobileIosApp>;
+}
 export interface MobileSurfaceNamespace {
     android: {
         connect(options?: MobileAndroidConnectOptions): Promise<MobileAndroidDevice>;
     };
+    ios: {
+        connect(options?: MobileIosConnectOptions): Promise<MobileIosDevice>;
+    };
 }
 export interface Locator extends WebLocators {
     inputValue(options?: CommandOptions): Promise<string>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@allwright.dev/core",
-  "version": "0.1.15",
+  "version": "0.1.17",
   "description": "High-level TypeScript client for the allwright automation engine.",
   "license": "MIT",
   "type": "module",
@@ -39,6 +39,7 @@
     "build": "tsc -p tsconfig.json",
     "example:web": "bun run examples/web-basic.ts",
     "example:android": "bun run examples/android-basic.ts",
+    "example:ios": "bun run examples/ios-basic.ts",
     "prepublishOnly": "bun run build"
   },
   "dependencies": {