@mobilerun/sdk 3.0.0 → 5.1.0

package/src/resources/devices/index.ts

@@ -12,21 +12,33 @@ export {
 export {
   Apps,
   type AppListResponse,
-  type AppUpdateParams,
   type AppListParams,
   type AppDeleteParams,
   type AppInstallParams,
   type AppStartParams,
+  type AppStopParams,
 } from './apps';
 export {
   Devices,
   type Device,
   type DeviceListResponse,
   type DeviceCountResponse,
+  type DeviceFingerprintResponse,
   type DeviceCreateParams,
   type DeviceListParams,
+  type DeviceFingerprintParams,
+  type DeviceSetNameParams,
   type DeviceTerminateParams,
 } from './devices';
+export {
+  Esim,
+  type EsimListResponse,
+  type EsimActivateResponse,
+  type EsimListParams,
+  type EsimActivateParams,
+  type EsimEnableParams,
+  type EsimRemoveParams,
+} from './esim';
 export {
   Files,
   type FileInfo,
@@ -44,29 +56,36 @@ export {
   type KeyboardWriteParams,
 } from './keyboard';
 export {
-  Location,
-  type LocationGetResponse,
-  type LocationGetParams,
-  type LocationSetParams,
-} from './location';
+  Language,
+  type LanguageGetResponse,
+  type LanguageGetParams,
+  type LanguageSetParams,
+} from './language';
+export { Location, type LocationGetParams, type LocationSetParams } from './location';
 export { Packages, type PackageListResponse, type PackageListParams } from './packages';
 export { Profile, type ProfileUpdateParams } from './profile';
-export { Proxy, type ProxyConnectParams, type ProxyDisconnectParams } from './proxy';
+export {
+  Proxy,
+  type ProxyStatusResponse,
+  type ProxyConnectParams,
+  type ProxyDisconnectParams,
+  type ProxyStatusParams,
+} from './proxy';
 export {
   State,
+  type A11YNode,
   type Rect,
   type StateScreenshotResponse,
+  type StateTimeResponse,
   type StateUiResponse,
   type StateScreenshotParams,
+  type StateTimeParams,
   type StateUiParams,
 } from './state';
 export { Tasks, type TaskListResponse, type TaskListParams } from './tasks';
 export {
-  Time,
-  type TimeTimeResponse,
-  type TimeTimezoneResponse,
-  type TimeSetTimeParams,
-  type TimeSetTimezoneParams,
-  type TimeTimeParams,
-  type TimeTimezoneParams,
-} from './time';
+  Timezone,
+  type TimezoneGetResponse,
+  type TimezoneGetParams,
+  type TimezoneSetParams,
+} from './timezone';

package/src/resources/devices/keyboard.ts

@@ -98,6 +98,12 @@ export interface KeyboardWriteParams {
    */
   clear?: boolean;
 
+  /**
+   * Body param: Per-character mistake rate for humantouch typing. -1 uses server
+   * default.
+   */
+  errorRate?: number;
+
   /**
    * Body param
    */

package/src/resources/devices/language.ts

@@ -0,0 +1,91 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import { APIPromise } from '../../core/api-promise';
+import { buildHeaders } from '../../internal/headers';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+export class Language extends APIResource {
+  /**
+   * Get device language/locale
+   */
+  get(
+    deviceID: string,
+    params: LanguageGetParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<LanguageGetResponse> {
+    const { 'X-Device-Display-ID': xDeviceDisplayID } = params ?? {};
+    return this._client.get(path`/devices/${deviceID}/language`, {
+      ...options,
+      headers: buildHeaders([
+        {
+          ...(xDeviceDisplayID?.toString() != null ?
+            { 'X-Device-Display-ID': xDeviceDisplayID?.toString() }
+          : undefined),
+        },
+        options?.headers,
+      ]),
+    });
+  }
+
+  /**
+   * Set device language/locale
+   */
+  set(deviceID: string, params: LanguageSetParams, options?: RequestOptions): APIPromise<void> {
+    const { 'X-Device-Display-ID': xDeviceDisplayID, ...body } = params;
+    return this._client.post(path`/devices/${deviceID}/language`, {
+      body,
+      ...options,
+      headers: buildHeaders([
+        {
+          Accept: '*/*',
+          ...(xDeviceDisplayID?.toString() != null ?
+            { 'X-Device-Display-ID': xDeviceDisplayID?.toString() }
+          : undefined),
+        },
+        options?.headers,
+      ]),
+    });
+  }
+}
+
+export interface LanguageGetResponse {
+  locale: string;
+
+  /**
+   * A URL to the JSON Schema for this object.
+   */
+  $schema?: string;
+}
+
+export interface LanguageGetParams {
+  'X-Device-Display-ID'?: number;
+}
+
+export interface LanguageSetParams {
+  /**
+   * Body param: BCP-47 locale: a 2–3 letter language tag, optionally followed by a
+   * 4-letter script and/or a 2-letter region (e.g. en-US, de-DE, ja-JP, zh-Hans-CN).
+   */
+  locale: string;
+
+  /**
+   * Body param: Restart zygote so the locale change takes full effect immediately.
+   * Without it, the locale is written but won't fully apply until the next reboot.
+   */
+  restart?: boolean;
+
+  /**
+   * Header param
+   */
+  'X-Device-Display-ID'?: number;
+}
+
+export declare namespace Language {
+  export {
+    type LanguageGetResponse as LanguageGetResponse,
+    type LanguageGetParams as LanguageGetParams,
+    type LanguageSetParams as LanguageSetParams,
+  };
+}

package/src/resources/devices/location.ts

@@ -1,6 +1,7 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../core/resource';
+import * as Shared from '../shared';
 import { APIPromise } from '../../core/api-promise';
 import { buildHeaders } from '../../internal/headers';
 import { RequestOptions } from '../../internal/request-options';
@@ -14,7 +15,7 @@ export class Location extends APIResource {
     deviceID: string,
     params: LocationGetParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<LocationGetResponse> {
+  ): APIPromise<Shared.Location> {
     const { 'X-Device-Display-ID': xDeviceDisplayID } = params ?? {};
     return this._client.get(path`/devices/${deviceID}/location`, {
       ...options,
@@ -50,17 +51,6 @@ export class Location extends APIResource {
   }
 }
 
-export interface LocationGetResponse {
-  latitude: number;
-
-  longitude: number;
-
-  /**
-   * A URL to the JSON Schema for this object.
-   */
-  $schema?: string;
-}
-
 export interface LocationGetParams {
   'X-Device-Display-ID'?: number;
 }
@@ -83,9 +73,5 @@ export interface LocationSetParams {
 }
 
 export declare namespace Location {
-  export {
-    type LocationGetResponse as LocationGetResponse,
-    type LocationGetParams as LocationGetParams,
-    type LocationSetParams as LocationSetParams,
-  };
+  export { type LocationGetParams as LocationGetParams, type LocationSetParams as LocationSetParams };
 }

package/src/resources/devices/proxy.ts

@@ -49,6 +49,47 @@ export class Proxy extends APIResource {
       ]),
     });
   }
+
+  /**
+   * Get proxy connection state
+   */
+  status(
+    deviceID: string,
+    params: ProxyStatusParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<ProxyStatusResponse> {
+    const { 'X-Device-Display-ID': xDeviceDisplayID } = params ?? {};
+    return this._client.get(path`/devices/${deviceID}/proxy`, {
+      ...options,
+      headers: buildHeaders([
+        {
+          ...(xDeviceDisplayID?.toString() != null ?
+            { 'X-Device-Display-ID': xDeviceDisplayID?.toString() }
+          : undefined),
+        },
+        options?.headers,
+      ]),
+    });
+  }
+}
+
+export interface ProxyStatusResponse {
+  connected: boolean;
+
+  /**
+   * Active proxy name
+   */
+  name: string | null;
+
+  /**
+   * Active proxy protocol (socks5).
+   */
+  protocol: string | null;
+
+  /**
+   * A URL to the JSON Schema for this object.
+   */
+  $schema?: string;
 }
 
 export interface ProxyConnectParams {
@@ -57,6 +98,11 @@ export interface ProxyConnectParams {
    */
   host?: string;
 
+  /**
+   * Body param: Proxy name
+   */
+  name?: string;
+
   /**
    * @deprecated Body param
    */
@@ -68,14 +114,14 @@ export interface ProxyConnectParams {
   port?: number;
 
   /**
-   * Body param: Preferred new format.
+   * Body param
    */
-  proxy?: ProxyConnectParams.Proxy;
+  smartIp?: boolean;
 
   /**
-   * Body param
+   * Body param: SOCKS5 proxy configuration (required for socks5).
    */
-  smartIp?: boolean;
+  socks5?: ProxyConnectParams.Socks5;
 
   /**
    * @deprecated Body param
@@ -90,16 +136,16 @@ export interface ProxyConnectParams {
 
 export namespace ProxyConnectParams {
   /**
-   * Preferred new format.
+   * SOCKS5 proxy configuration (required for socks5).
    */
-  export interface Proxy {
+  export interface Socks5 {
     host: string;
 
-    password: string;
-
     port: number;
 
-    user: string;
+    password?: string;
+
+    user?: string;
   }
 }
 
@@ -107,9 +153,15 @@ export interface ProxyDisconnectParams {
   'X-Device-Display-ID'?: number;
 }
 
+export interface ProxyStatusParams {
+  'X-Device-Display-ID'?: number;
+}
+
 export declare namespace Proxy {
   export {
+    type ProxyStatusResponse as ProxyStatusResponse,
     type ProxyConnectParams as ProxyConnectParams,
     type ProxyDisconnectParams as ProxyDisconnectParams,
+    type ProxyStatusParams as ProxyStatusParams,
   };
 }

package/src/resources/devices/state.ts

@@ -31,6 +31,28 @@ export class State extends APIResource {
     });
   }
 
+  /**
+   * Device time
+   */
+  time(
+    deviceID: string,
+    params: StateTimeParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<string> {
+    const { 'X-Device-Display-ID': xDeviceDisplayID } = params ?? {};
+    return this._client.get(path`/devices/${deviceID}/time`, {
+      ...options,
+      headers: buildHeaders([
+        {
+          ...(xDeviceDisplayID?.toString() != null ?
+            { 'X-Device-Display-ID': xDeviceDisplayID?.toString() }
+          : undefined),
+        },
+        options?.headers,
+      ]),
+    });
+  }
+
   /**
    * UI state
    */
@@ -55,6 +77,54 @@ export class State extends APIResource {
   }
 }
 
+export interface A11YNode {
+  boundsInScreen: A11YNode.BoundsInScreen;
+
+  children: Array<A11YNode> | null;
+
+  className: string;
+
+  contentDescription: string;
+
+  isCheckable: boolean;
+
+  isChecked: boolean;
+
+  isClickable: boolean;
+
+  isEnabled: boolean;
+
+  isFocusable: boolean;
+
+  isFocused: boolean;
+
+  isLongClickable: boolean;
+
+  isPassword: boolean;
+
+  isScrollable: boolean;
+
+  isSelected: boolean;
+
+  packageName: string;
+
+  resourceId: string;
+
+  text: string;
+}
+
+export namespace A11YNode {
+  export interface BoundsInScreen {
+    bottom: number;
+
+    left: number;
+
+    right: number;
+
+    top: number;
+  }
+}
+
 export interface Rect {
   height: number;
 
@@ -63,11 +133,15 @@ export interface Rect {
 
 export type StateScreenshotResponse = string;
 
+export type StateTimeResponse = string;
+
 export interface StateUiResponse {
-  a11y_tree: unknown;
+  a11y_tree: A11YNode;
 
   device_context: StateUiResponse.DeviceContext;
 
+  ime_tree: A11YNode;
+
   phone_state: StateUiResponse.PhoneState;
 
   /**
@@ -83,8 +157,6 @@ export namespace StateUiResponse {
     filtering_params: DeviceContext.FilteringParams;
 
     screen_bounds: StateAPI.Rect;
-
-    screenSize: StateAPI.Rect;
   }
 
   export namespace DeviceContext {
@@ -144,6 +216,10 @@ export interface StateScreenshotParams {
   'X-Device-Display-ID'?: number;
 }
 
+export interface StateTimeParams {
+  'X-Device-Display-ID'?: number;
+}
+
 export interface StateUiParams {
   /**
    * Query param
@@ -158,10 +234,13 @@ export interface StateUiParams {
 
 export declare namespace State {
   export {
+    type A11YNode as A11YNode,
     type Rect as Rect,
     type StateScreenshotResponse as StateScreenshotResponse,
+    type StateTimeResponse as StateTimeResponse,
     type StateUiResponse as StateUiResponse,
     type StateScreenshotParams as StateScreenshotParams,
+    type StateTimeParams as StateTimeParams,
     type StateUiParams as StateUiParams,
   };
 }

package/src/resources/devices/tasks.ts

@@ -6,6 +6,9 @@ import { APIPromise } from '../../core/api-promise';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
+/**
+ * Device Management
+ */
 export class Tasks extends APIResource {
   /**
    * List tasks for a device

package/src/resources/devices/timezone.ts

@@ -0,0 +1,84 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import { APIPromise } from '../../core/api-promise';
+import { buildHeaders } from '../../internal/headers';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+export class Timezone extends APIResource {
+  /**
+   * Get device timezone
+   */
+  get(
+    deviceID: string,
+    params: TimezoneGetParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<TimezoneGetResponse> {
+    const { 'X-Device-Display-ID': xDeviceDisplayID } = params ?? {};
+    return this._client.get(path`/devices/${deviceID}/timezone`, {
+      ...options,
+      headers: buildHeaders([
+        {
+          ...(xDeviceDisplayID?.toString() != null ?
+            { 'X-Device-Display-ID': xDeviceDisplayID?.toString() }
+          : undefined),
+        },
+        options?.headers,
+      ]),
+    });
+  }
+
+  /**
+   * Set device timezone
+   */
+  set(deviceID: string, params: TimezoneSetParams, options?: RequestOptions): APIPromise<void> {
+    const { 'X-Device-Display-ID': xDeviceDisplayID, ...body } = params;
+    return this._client.post(path`/devices/${deviceID}/timezone`, {
+      body,
+      ...options,
+      headers: buildHeaders([
+        {
+          Accept: '*/*',
+          ...(xDeviceDisplayID?.toString() != null ?
+            { 'X-Device-Display-ID': xDeviceDisplayID?.toString() }
+          : undefined),
+        },
+        options?.headers,
+      ]),
+    });
+  }
+}
+
+export interface TimezoneGetResponse {
+  timezone: string | null;
+
+  /**
+   * A URL to the JSON Schema for this object.
+   */
+  $schema?: string;
+}
+
+export interface TimezoneGetParams {
+  'X-Device-Display-ID'?: number;
+}
+
+export interface TimezoneSetParams {
+  /**
+   * Body param
+   */
+  timezone: string;
+
+  /**
+   * Header param
+   */
+  'X-Device-Display-ID'?: number;
+}
+
+export declare namespace Timezone {
+  export {
+    type TimezoneGetResponse as TimezoneGetResponse,
+    type TimezoneGetParams as TimezoneGetParams,
+    type TimezoneSetParams as TimezoneSetParams,
+  };
+}

package/src/resources/hooks.ts

@@ -7,9 +7,6 @@ import { APIPromise } from '../core/api-promise';
 import { RequestOptions } from '../internal/request-options';
 import { path } from '../internal/utils/path';
 
-/**
- * Webhooks API
- */
 export class Hooks extends APIResource {
   /**
    * Get a hook subscription by id.
@@ -59,6 +56,16 @@ export class Hooks extends APIResource {
     return this._client.post('/hooks/subscribe', { body, ...options });
   }
 
+  /**
+   * Send a test event to a webhook endpoint.
+   *
+   * Delivers a sample payload to the hook's URL with a single attempt (no retries)
+   * for fast feedback.
+   */
+  test(hookID: string, body: HookTestParams, options?: RequestOptions): APIPromise<HookTestResponse> {
+    return this._client.post(path`/hooks/${hookID}/test`, { body, ...options });
+  }
+
   /**
    * Unsubscribe a previously created subscription by id.
    *
@@ -220,6 +227,31 @@ export interface HookSubscribeResponse {
   service?: string | null;
 }
 
+/**
+ * Response after attempting test delivery.
+ */
+export interface HookTestResponse {
+  /**
+   * The hook ID
+   */
+  id: string;
+
+  /**
+   * Whether delivery succeeded (2xx)
+   */
+  success: boolean;
+
+  /**
+   * Error message if delivery failed
+   */
+  error?: string | null;
+
+  /**
+   * HTTP status from target
+   */
+  statusCode?: number | null;
+}
+
 /**
  * Response model after successful unsubscription.
  */
@@ -279,6 +311,13 @@ export interface HookSubscribeParams {
   service?: string | null;
 }
 
+export interface HookTestParams {
+  /**
+   * Event type to simulate (default: completed)
+   */
+  event?: string | null;
+}
+
 export declare namespace Hooks {
   export {
     type HookRetrieveResponse as HookRetrieveResponse,
@@ -287,10 +326,12 @@ export declare namespace Hooks {
     type HookGetSampleDataResponse as HookGetSampleDataResponse,
     type HookPerformResponse as HookPerformResponse,
     type HookSubscribeResponse as HookSubscribeResponse,
+    type HookTestResponse as HookTestResponse,
     type HookUnsubscribeResponse as HookUnsubscribeResponse,
     type HookUpdateParams as HookUpdateParams,
     type HookListParams as HookListParams,
     type HookPerformParams as HookPerformParams,
     type HookSubscribeParams as HookSubscribeParams,
+    type HookTestParams as HookTestParams,
   };
 }