@mobilerun/sdk 5.2.0 → 5.2.1

package/src/resources/devices/apps.ts

@@ -53,6 +53,30 @@ export class Apps extends APIResource {
     });
   }
 
+  /**
+   * Grants an Android runtime permission to the package named in the path. The
+   * permission is given by its short name (e.g. POST_NOTIFICATIONS).
+   */
+  grantPermission(
+    permission: 'POST_NOTIFICATIONS',
+    params: AppGrantPermissionParams,
+    options?: RequestOptions,
+  ): APIPromise<void> {
+    const { deviceId, packageName, 'X-Device-Display-ID': xDeviceDisplayID } = params;
+    return this._client.put(path`/devices/${deviceId}/apps/${packageName}/permissions/${permission}`, {
+      ...options,
+      headers: buildHeaders([
+        {
+          Accept: '*/*',
+          ...(xDeviceDisplayID?.toString() != null ?
+            { 'X-Device-Display-ID': xDeviceDisplayID?.toString() }
+          : undefined),
+        },
+        options?.headers,
+      ]),
+    });
+  }
+
   /**
    * Requests an app install on the device. The request body must supply exactly one
    * of an Android packageName or an iOS bundleId; protected packages are rejected.
@@ -82,6 +106,56 @@ export class Apps extends APIResource {
     });
   }
 
+  /**
+   * Reports the backend's view of background app-install attempts on this device —
+   * status reflects the install ATTEMPT, not device ground truth; list-apps remains
+   * authoritative for what is actually installed. Records are in-memory and lost on
+   * service restart; terminal records are kept ~15 minutes. Not gated on device
+   * readiness, so it also answers while the device is offline or crashed.
+   */
+  listInstalls(
+    deviceID: string,
+    params: AppListInstallsParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<AppListInstallsResponse> {
+    const { 'X-Device-Display-ID': xDeviceDisplayID } = params ?? {};
+    return this._client.get(path`/devices/${deviceID}/apps/installs`, {
+      ...options,
+      headers: buildHeaders([
+        {
+          ...(xDeviceDisplayID?.toString() != null ?
+            { 'X-Device-Display-ID': xDeviceDisplayID?.toString() }
+          : undefined),
+        },
+        options?.headers,
+      ]),
+    });
+  }
+
+  /**
+   * Revokes an Android runtime permission from the package named in the path. The
+   * permission is given by its short name (e.g. POST_NOTIFICATIONS).
+   */
+  revokePermission(
+    permission: 'POST_NOTIFICATIONS',
+    params: AppRevokePermissionParams,
+    options?: RequestOptions,
+  ): APIPromise<void> {
+    const { deviceId, packageName, 'X-Device-Display-ID': xDeviceDisplayID } = params;
+    return this._client.delete(path`/devices/${deviceId}/apps/${packageName}/permissions/${permission}`, {
+      ...options,
+      headers: buildHeaders([
+        {
+          Accept: '*/*',
+          ...(xDeviceDisplayID?.toString() != null ?
+            { 'X-Device-Display-ID': xDeviceDisplayID?.toString() }
+          : undefined),
+        },
+        options?.headers,
+      ]),
+    });
+  }
+
   /**
    * Launches the app identified by the path package name, optionally starting a
    * specific activity given in the request body. Protected packages cannot be
@@ -143,6 +217,45 @@ export namespace AppListResponse {
   }
 }
 
+export interface AppListInstallsResponse {
+  installs: Array<AppListInstallsResponse.Install> | null;
+
+  /**
+   * A URL to the JSON Schema for this object.
+   */
+  $schema?: string;
+}
+
+export namespace AppListInstallsResponse {
+  export interface Install {
+    /**
+     * Android package name or iOS bundle id
+     */
+    appId: string;
+
+    /**
+     * android or ios
+     */
+    platform: string;
+
+    startedAt: string;
+
+    /**
+     * On iOS MDM devices, succeeded means the install command was accepted by the
+     * device's MDM channel, not that the install finished on-device.
+     */
+    status: 'running' | 'succeeded' | 'failed';
+
+    updatedAt: string;
+
+    /**
+     * Closed set: download_failed, adb_install_failed, panic, timeout, failed. Only
+     * present when status is failed.
+     */
+    errorClass?: string;
+  }
+}
+
 export interface AppListParams {
   /**
    * Query param
@@ -172,6 +285,23 @@ export interface AppDeleteParams {
   'X-Device-Display-ID'?: number;
 }
 
+export interface AppGrantPermissionParams {
+  /**
+   * Path param
+   */
+  deviceId: string;
+
+  /**
+   * Path param
+   */
+  packageName: string;
+
+  /**
+   * Header param
+   */
+  'X-Device-Display-ID'?: number;
+}
+
 export type AppInstallParams = AppInstallParams.Variant0 | AppInstallParams.Variant1;
 
 export declare namespace AppInstallParams {
@@ -224,6 +354,27 @@ export declare namespace AppInstallParams {
   }
 }
 
+export interface AppListInstallsParams {
+  'X-Device-Display-ID'?: number;
+}
+
+export interface AppRevokePermissionParams {
+  /**
+   * Path param
+   */
+  deviceId: string;
+
+  /**
+   * Path param
+   */
+  packageName: string;
+
+  /**
+   * Header param
+   */
+  'X-Device-Display-ID'?: number;
+}
+
 export interface AppStartParams {
   /**
    * Path param
@@ -262,9 +413,13 @@ export interface AppStopParams {
 export declare namespace Apps {
   export {
     type AppListResponse as AppListResponse,
+    type AppListInstallsResponse as AppListInstallsResponse,
     type AppListParams as AppListParams,
     type AppDeleteParams as AppDeleteParams,
+    type AppGrantPermissionParams as AppGrantPermissionParams,
     type AppInstallParams as AppInstallParams,
+    type AppListInstallsParams as AppListInstallsParams,
+    type AppRevokePermissionParams as AppRevokePermissionParams,
     type AppStartParams as AppStartParams,
     type AppStopParams as AppStopParams,
   };

package/src/resources/devices/browser.ts

@@ -0,0 +1,71 @@
+// 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 Browser extends APIResource {
+  /**
+   * Evaluates a JavaScript expression in the device's foreground Chrome tab via the
+   * Chrome DevTools Protocol and returns its JSON-serialized result. Devices without
+   * browser support return an unsupported-feature error.
+   */
+  executeScript(
+    deviceID: string,
+    params: BrowserExecuteScriptParams,
+    options?: RequestOptions,
+  ): APIPromise<BrowserExecuteScriptResponse> {
+    const { 'X-Device-Display-ID': xDeviceDisplayID, ...body } = params;
+    return this._client.post(path`/devices/${deviceID}/browser/execute-script`, {
+      body,
+      ...options,
+      headers: buildHeaders([
+        {
+          ...(xDeviceDisplayID?.toString() != null ?
+            { 'X-Device-Display-ID': xDeviceDisplayID?.toString() }
+          : undefined),
+        },
+        options?.headers,
+      ]),
+    });
+  }
+}
+
+export interface BrowserExecuteScriptResponse {
+  /**
+   * JSON-serialized return value of the script (null if it returned undefined).
+   * Non-JSON-serializable numbers (Infinity, NaN, -0) are returned as their string
+   * representation.
+   */
+  result: unknown;
+
+  /**
+   * A URL to the JSON Schema for this object.
+   */
+  $schema?: string;
+}
+
+export interface BrowserExecuteScriptParams {
+  /**
+   * Body param: JavaScript expression to evaluate in the device's foreground Chrome
+   * tab (CDP Runtime.evaluate). It is an expression, not a function body — the
+   * expression's value is returned (no top-level 'return'). Must evaluate to a
+   * JSON-serializable value; wrap multi-statement logic in an IIFE, e.g. (() => {
+   * ... ; return x })().
+   */
+  script: string;
+
+  /**
+   * Header param
+   */
+  'X-Device-Display-ID'?: number;
+}
+
+export declare namespace Browser {
+  export {
+    type BrowserExecuteScriptResponse as BrowserExecuteScriptResponse,
+    type BrowserExecuteScriptParams as BrowserExecuteScriptParams,
+  };
+}

package/src/resources/devices/deep-link.ts

@@ -0,0 +1,70 @@
+// 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 DeepLink extends APIResource {
+  /**
+   * Opens a deep link on the device. On Android the link is dispatched as an intent
+   * — packageName optionally pins it to a specific app and action overrides the
+   * default android.intent.action.VIEW. On iOS the URL is opened directly and the
+   * optional fields must be omitted. Protected packages are rejected.
+   */
+  executeDeepLink(
+    deviceID: string,
+    params: DeepLinkExecuteDeepLinkParams,
+    options?: RequestOptions,
+  ): APIPromise<void> {
+    const { 'X-Device-Display-ID': xDeviceDisplayID, ...body } = params;
+    return this._client.post(path`/devices/${deviceID}/apps/open-deep-link`, {
+      body,
+      ...options,
+      headers: buildHeaders([
+        {
+          Accept: '*/*',
+          ...(xDeviceDisplayID?.toString() != null ?
+            { 'X-Device-Display-ID': xDeviceDisplayID?.toString() }
+          : undefined),
+        },
+        options?.headers,
+      ]),
+    });
+  }
+}
+
+export interface DeepLinkExecuteDeepLinkParams {
+  /**
+   * Body param: Deep link to open (e.g. myapp://path or https://example.com/path)
+   */
+  deepLink: string;
+
+  /**
+   * Body param: Android only: intent action to dispatch. Defaults to
+   * android.intent.action.VIEW.
+   */
+  action?: string;
+
+  /**
+   * Body param: Reserved for targeting a specific iOS app; currently rejected as
+   * unsupported.
+   */
+  bundleId?: string;
+
+  /**
+   * Body param: Android only: package to receive the intent (e.g. com.example.app).
+   * Omit to let the system pick the handler.
+   */
+  packageName?: string;
+
+  /**
+   * Header param
+   */
+  'X-Device-Display-ID'?: number;
+}
+
+export declare namespace DeepLink {
+  export { type DeepLinkExecuteDeepLinkParams as DeepLinkExecuteDeepLinkParams };
+}