@mobilerun/sdk 5.2.0 → 5.3.0

package/src/resources/devices/files.ts

@@ -99,61 +99,63 @@ export class Files extends APIResource {
   }
 }
 
-export interface FileInfo {
-  extendedAttributes: boolean;
+export interface FileListResponse {
+  files: Array<FileListResponse.File> | null;
 
-  group: string;
+  path: string;
 
-  hardLinks: number;
+  total: number;
 
-  modifiedAt: string;
+  /**
+   * A URL to the JSON Schema for this object.
+   */
+  $schema?: string;
+}
 
-  name: string;
+export namespace FileListResponse {
+  export interface File {
+    extendedAttributes: boolean;
 
-  owner: string;
+    group: string;
 
-  permissions: FileInfo.Permissions;
+    hardLinks: number;
 
-  size: number;
+    modifiedAt: string;
 
-  type: string;
+    name: string;
 
-  symlinkTarget?: string;
-}
+    owner: string;
 
-export namespace FileInfo {
-  export interface Permissions {
-    group: Shared.PermissionSet;
+    permissions: File.Permissions;
 
-    others: Shared.PermissionSet;
+    size: number;
 
-    owner: Shared.PermissionSet;
+    type: string;
 
-    special: Permissions.Special;
+    symlinkTarget?: string;
   }
 
-  export namespace Permissions {
-    export interface Special {
-      setGid: boolean;
+  export namespace File {
+    export interface Permissions {
+      group: Shared.PermissionSet;
 
-      setUid: boolean;
+      others: Shared.PermissionSet;
 
-      sticky: boolean;
-    }
-  }
-}
+      owner: Shared.PermissionSet;
 
-export interface FileListResponse {
-  files: Array<FileInfo> | null;
+      special: Permissions.Special;
+    }
 
-  path: string;
+    export namespace Permissions {
+      export interface Special {
+        setGid: boolean;
 
-  total: number;
+        setUid: boolean;
 
-  /**
-   * A URL to the JSON Schema for this object.
-   */
-  $schema?: string;
+        sticky: boolean;
+      }
+    }
+  }
 }
 
 export type FileDownloadResponse = string;
@@ -213,7 +215,6 @@ export interface FileUploadParams {
 
 export declare namespace Files {
   export {
-    type FileInfo as FileInfo,
     type FileListResponse as FileListResponse,
     type FileDownloadResponse as FileDownloadResponse,
     type FileListParams as FileListParams,

package/src/resources/devices/index.ts

@@ -12,18 +12,34 @@ export {
 export {
   Apps,
   type AppListResponse,
+  type AppListInstallsResponse,
   type AppListParams,
   type AppDeleteParams,
+  type AppGrantPermissionParams,
   type AppInstallParams,
+  type AppListInstallsParams,
+  type AppRevokePermissionParams,
   type AppStartParams,
   type AppStopParams,
 } from './apps';
+export { Browser, type BrowserExecuteScriptResponse, type BrowserExecuteScriptParams } from './browser';
+export {
+  Clipboard,
+  type ClipboardGetResponse,
+  type ClipboardGetParams,
+  type ClipboardSetParams,
+} from './clipboard';
+export { DeepLink, type DeepLinkExecuteDeepLinkParams } from './deep-link';
 export {
   Devices,
-  type Device,
+  type DeviceCreateResponse,
+  type DeviceRetrieveResponse,
   type DeviceListResponse,
   type DeviceCountResponse,
   type DeviceFingerprintResponse,
+  type DeviceRetrieveCapabilitiesResponse,
+  type DeviceSetNameResponse,
+  type DeviceWaitReadyResponse,
   type DeviceCreateParams,
   type DeviceListParams,
   type DeviceFingerprintParams,
@@ -34,14 +50,16 @@ export {
   Esim,
   type EsimListResponse,
   type EsimActivateResponse,
+  type EsimStatusResponse,
   type EsimListParams,
   type EsimActivateParams,
   type EsimEnableParams,
   type EsimRemoveParams,
-} from './esim';
+  type EsimSetRoamingParams,
+  type EsimStatusParams,
+} from './esim/index';
 export {
   Files,
-  type FileInfo,
   type FileListResponse,
   type FileDownloadResponse,
   type FileListParams,
@@ -55,13 +73,28 @@ export {
   type KeyboardKeyParams,
   type KeyboardWriteParams,
 } from './keyboard';
+export { Kiosk, type KioskDisableParams, type KioskEnableParams } from './kiosk';
 export {
   Language,
   type LanguageGetResponse,
   type LanguageGetParams,
   type LanguageSetParams,
 } from './language';
-export { Location, type LocationGetParams, type LocationSetParams } from './location';
+export {
+  Location,
+  type LocationGetParams,
+  type LocationResetParams,
+  type LocationSetParams,
+} from './location';
+export {
+  MediaSessions,
+  type MediaSessionCreateResponse,
+  type MediaSessionActivateResponse,
+  type MediaSessionRetrieveCurrentResponse,
+  type MediaSessionCreateParams,
+  type MediaSessionDeleteParams,
+  type MediaSessionActivateParams,
+} from './media-sessions';
 export { Packages, type PackageListResponse, type PackageListParams } from './packages';
 export { Profile, type ProfileUpdateParams } from './profile';
 export {
@@ -71,10 +104,23 @@ export {
   type ProxyDisconnectParams,
   type ProxyStatusParams,
 } from './proxy';
+export {
+  Recordings,
+  type RecordingListResponse,
+  type RecordingStartResponse,
+  type RecordingStatusResponse,
+  type RecordingStopResponse,
+  type RecordingListParams,
+  type RecordingDeleteParams,
+  type RecordingStartParams,
+  type RecordingStatusParams,
+  type RecordingStopParams,
+  type RecordingTrajectoryParams,
+  type RecordingVideoParams,
+} from './recordings';
 export {
   State,
   type A11YNode,
-  type Rect,
   type StateScreenshotResponse,
   type StateTimeResponse,
   type StateUiResponse,

package/src/resources/devices/kiosk.ts

@@ -0,0 +1,74 @@
+// 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 Kiosk extends APIResource {
+  /**
+   * Disables Android lock-task (kiosk) mode on the device, releasing it from the
+   * locked app.
+   */
+  disable(
+    deviceID: string,
+    params: KioskDisableParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<void> {
+    const { 'X-Device-Display-ID': xDeviceDisplayID } = params ?? {};
+    return this._client.delete(path`/devices/${deviceID}/kiosk`, {
+      ...options,
+      headers: buildHeaders([
+        {
+          Accept: '*/*',
+          ...(xDeviceDisplayID?.toString() != null ?
+            { 'X-Device-Display-ID': xDeviceDisplayID?.toString() }
+          : undefined),
+        },
+        options?.headers,
+      ]),
+    });
+  }
+
+  /**
+   * Locks the device to the package named in the request body using Android
+   * lock-task (kiosk) mode, preventing the user from leaving the app.
+   */
+  enable(deviceID: string, params: KioskEnableParams, options?: RequestOptions): APIPromise<void> {
+    const { 'X-Device-Display-ID': xDeviceDisplayID, ...body } = params;
+    return this._client.put(path`/devices/${deviceID}/kiosk`, {
+      body,
+      ...options,
+      headers: buildHeaders([
+        {
+          Accept: '*/*',
+          ...(xDeviceDisplayID?.toString() != null ?
+            { 'X-Device-Display-ID': xDeviceDisplayID?.toString() }
+          : undefined),
+        },
+        options?.headers,
+      ]),
+    });
+  }
+}
+
+export interface KioskDisableParams {
+  'X-Device-Display-ID'?: number;
+}
+
+export interface KioskEnableParams {
+  /**
+   * Body param: Package to lock the device to (Android lock-task mode).
+   */
+  packageName: string;
+
+  /**
+   * Header param
+   */
+  'X-Device-Display-ID'?: number;
+}
+
+export declare namespace Kiosk {
+  export { type KioskDisableParams as KioskDisableParams, type KioskEnableParams as KioskEnableParams };
+}

package/src/resources/devices/location.ts

@@ -31,6 +31,30 @@ export class Location extends APIResource {
     });
   }
 
+  /**
+   * Clears any simulated GPS location and restores the device's default location
+   * behavior. Devices without geo support return an unsupported-feature error.
+   */
+  reset(
+    deviceID: string,
+    params: LocationResetParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<void> {
+    const { 'X-Device-Display-ID': xDeviceDisplayID } = params ?? {};
+    return this._client.delete(path`/devices/${deviceID}/location`, {
+      ...options,
+      headers: buildHeaders([
+        {
+          Accept: '*/*',
+          ...(xDeviceDisplayID?.toString() != null ?
+            { 'X-Device-Display-ID': xDeviceDisplayID?.toString() }
+          : undefined),
+        },
+        options?.headers,
+      ]),
+    });
+  }
+
   /**
    * Sets the device's simulated GPS location to the latitude and longitude in the
    * request body. Devices without geo support return an unsupported-feature error.
@@ -57,6 +81,10 @@ export interface LocationGetParams {
   'X-Device-Display-ID'?: number;
 }
 
+export interface LocationResetParams {
+  'X-Device-Display-ID'?: number;
+}
+
 export interface LocationSetParams {
   /**
    * Body param
@@ -75,5 +103,9 @@ export interface LocationSetParams {
 }
 
 export declare namespace Location {
-  export { type LocationGetParams as LocationGetParams, type LocationSetParams as LocationSetParams };
+  export {
+    type LocationGetParams as LocationGetParams,
+    type LocationResetParams as LocationResetParams,
+    type LocationSetParams as LocationSetParams,
+  };
 }

package/src/resources/devices/media-sessions.ts

@@ -0,0 +1,168 @@
+// 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 MediaSessions extends APIResource {
+  /**
+   * Allocates an exclusive relay path and returns one-time publish and control
+   * credentials. The relay publisher must be established before activation.
+   */
+  create(
+    deviceID: string,
+    body: MediaSessionCreateParams,
+    options?: RequestOptions,
+  ): APIPromise<MediaSessionCreateResponse> {
+    return this._client.post(path`/devices/${deviceID}/media-sessions`, { body, ...options });
+  }
+
+  /**
+   * Immediately revokes relay authorization, detaches virtual media inputs, and
+   * kicks the relay publisher.
+   */
+  delete(sessionID: string, params: MediaSessionDeleteParams, options?: RequestOptions): APIPromise<void> {
+    const { deviceId, 'X-Media-Control-Token': xMediaControlToken } = params;
+    return this._client.delete(path`/devices/${deviceId}/media-sessions/${sessionID}`, {
+      ...options,
+      headers: buildHeaders([
+        { Accept: '*/*', 'X-Media-Control-Token': xMediaControlToken },
+        options?.headers,
+      ]),
+    });
+  }
+
+  /**
+   * Validates relay codecs and attaches one private RTSP source to either the
+   * virtual microphone or the combined microphone-and-camera pipeline.
+   */
+  activate(
+    sessionID: string,
+    params: MediaSessionActivateParams,
+    options?: RequestOptions,
+  ): APIPromise<MediaSessionActivateResponse> {
+    const { deviceId, 'X-Media-Control-Token': xMediaControlToken } = params;
+    return this._client.post(path`/devices/${deviceId}/media-sessions/${sessionID}/activate`, {
+      ...options,
+      headers: buildHeaders([{ 'X-Media-Control-Token': xMediaControlToken }, options?.headers]),
+    });
+  }
+
+  /**
+   * Returns status only. Publish URLs and credentials are never replayed after
+   * creation.
+   */
+  retrieveCurrent(
+    deviceID: string,
+    options?: RequestOptions,
+  ): APIPromise<MediaSessionRetrieveCurrentResponse> {
+    return this._client.get(path`/devices/${deviceID}/media-sessions/current`, options);
+  }
+}
+
+export interface MediaSessionCreateResponse {
+  camera: boolean;
+
+  controlToken: string;
+
+  expiresAt: string;
+
+  microphone: boolean;
+
+  publishToken: string;
+
+  publishUrl: string;
+
+  sessionId: string;
+
+  state: 'created' | 'publishing' | 'active' | 'stopping' | 'closed' | 'failed';
+
+  /**
+   * A URL to the JSON Schema for this object.
+   */
+  $schema?: string;
+}
+
+export interface MediaSessionActivateResponse {
+  camera: boolean;
+
+  expiresAt: string;
+
+  microphone: boolean;
+
+  sessionId: string;
+
+  state: 'created' | 'publishing' | 'active' | 'stopping' | 'closed' | 'failed';
+
+  /**
+   * A URL to the JSON Schema for this object.
+   */
+  $schema?: string;
+}
+
+export interface MediaSessionRetrieveCurrentResponse {
+  camera: boolean;
+
+  expiresAt: string;
+
+  microphone: boolean;
+
+  sessionId: string;
+
+  state: 'created' | 'publishing' | 'active' | 'stopping' | 'closed' | 'failed';
+
+  /**
+   * A URL to the JSON Schema for this object.
+   */
+  $schema?: string;
+}
+
+export interface MediaSessionCreateParams {
+  /**
+   * Publish combined browser audio and H264 video into the device's virtual
+   * microphone and camera. Requires microphone=true.
+   */
+  camera: boolean;
+
+  /**
+   * Publish browser audio into the device's virtual microphone.
+   */
+  microphone: boolean;
+}
+
+export interface MediaSessionDeleteParams {
+  /**
+   * Path param
+   */
+  deviceId: string;
+
+  /**
+   * Header param
+   */
+  'X-Media-Control-Token': string;
+}
+
+export interface MediaSessionActivateParams {
+  /**
+   * Path param
+   */
+  deviceId: string;
+
+  /**
+   * Header param
+   */
+  'X-Media-Control-Token': string;
+}
+
+export declare namespace MediaSessions {
+  export {
+    type MediaSessionCreateResponse as MediaSessionCreateResponse,
+    type MediaSessionActivateResponse as MediaSessionActivateResponse,
+    type MediaSessionRetrieveCurrentResponse as MediaSessionRetrieveCurrentResponse,
+    type MediaSessionCreateParams as MediaSessionCreateParams,
+    type MediaSessionDeleteParams as MediaSessionDeleteParams,
+    type MediaSessionActivateParams as MediaSessionActivateParams,
+  };
+}