@mobilerun/sdk 5.2.0 → 5.3.0

package/src/resources/credentials/packages/credentials/credentials.ts

@@ -64,61 +64,137 @@ export class Credentials extends APIResource {
   }
 }
 
-export interface Credential {
-  createdBy: string | null;
+export interface CredentialCreateResponse {
+  data: CredentialCreateResponse.Data;
 
-  credentialName: string;
+  message: string;
 
-  fields: Array<Credential.Field>;
+  success: true;
+}
 
-  ownerId: string;
+export namespace CredentialCreateResponse {
+  export interface Data {
+    createdBy: string | null;
 
-  packageName: string;
+    credentialName: string;
 
-  secretPath: string;
+    fields: Array<Data.Field>;
 
-  /**
-   * @deprecated Deprecated: use createdBy (same value — the creating actor). Null
-   * for credentials created before rollout.
-   */
-  userId: string | null;
-}
+    ownerId: string;
 
-export namespace Credential {
-  export interface Field {
-    fieldType:
-      | 'email'
-      | 'username'
-      | 'password'
-      | 'api_token'
-      | 'phone_number'
-      | 'two_factor_secret'
-      | 'backup_codes';
+    packageName: string;
 
-    value: string;
+    secretPath: string;
+
+    /**
+     * @deprecated Deprecated: use createdBy (same value — the creating actor). Null
+     * for credentials created before rollout.
+     */
+    userId: string | null;
+  }
+
+  export namespace Data {
+    export interface Field {
+      fieldType:
+        | 'email'
+        | 'username'
+        | 'password'
+        | 'api_token'
+        | 'phone_number'
+        | 'two_factor_secret'
+        | 'backup_codes';
+
+      value: string;
+    }
   }
 }
 
-export interface CredentialCreateResponse {
-  data: Credential;
+export interface CredentialRetrieveResponse {
+  data: CredentialRetrieveResponse.Data;
+}
 
-  message: string;
+export namespace CredentialRetrieveResponse {
+  export interface Data {
+    createdBy: string | null;
 
-  success: true;
-}
+    credentialName: string;
 
-export interface CredentialRetrieveResponse {
-  data: Credential;
+    fields: Array<Data.Field>;
+
+    ownerId: string;
+
+    packageName: string;
+
+    secretPath: string;
+
+    /**
+     * @deprecated Deprecated: use createdBy (same value — the creating actor). Null
+     * for credentials created before rollout.
+     */
+    userId: string | null;
+  }
+
+  export namespace Data {
+    export interface Field {
+      fieldType:
+        | 'email'
+        | 'username'
+        | 'password'
+        | 'api_token'
+        | 'phone_number'
+        | 'two_factor_secret'
+        | 'backup_codes';
+
+      value: string;
+    }
+  }
 }
 
 export interface CredentialDeleteResponse {
-  data: Credential;
+  data: CredentialDeleteResponse.Data;
 
   message: string;
 
   success: true;
 }
 
+export namespace CredentialDeleteResponse {
+  export interface Data {
+    createdBy: string | null;
+
+    credentialName: string;
+
+    fields: Array<Data.Field>;
+
+    ownerId: string;
+
+    packageName: string;
+
+    secretPath: string;
+
+    /**
+     * @deprecated Deprecated: use createdBy (same value — the creating actor). Null
+     * for credentials created before rollout.
+     */
+    userId: string | null;
+  }
+
+  export namespace Data {
+    export interface Field {
+      fieldType:
+        | 'email'
+        | 'username'
+        | 'password'
+        | 'api_token'
+        | 'phone_number'
+        | 'two_factor_secret'
+        | 'backup_codes';
+
+      value: string;
+    }
+  }
+}
+
 export interface CredentialCreateParams {
   credentialName: string;
 
@@ -152,7 +228,6 @@ Credentials.Fields = Fields;
 
 export declare namespace Credentials {
   export {
-    type Credential as Credential,
     type CredentialCreateResponse as CredentialCreateResponse,
     type CredentialRetrieveResponse as CredentialRetrieveResponse,
     type CredentialDeleteResponse as CredentialDeleteResponse,

package/src/resources/credentials/packages/credentials/fields.ts

@@ -1,7 +1,6 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../../../core/resource';
-import * as CredentialsAPI from './credentials';
 import { APIPromise } from '../../../../core/api-promise';
 import { RequestOptions } from '../../../../internal/request-options';
 import { path } from '../../../../internal/utils/path';
@@ -73,29 +72,140 @@ export class Fields extends APIResource {
 }
 
 export interface FieldCreateResponse {
-  data: CredentialsAPI.Credential;
+  data: FieldCreateResponse.Data;
 
   message: string;
 
   success: true;
 }
 
+export namespace FieldCreateResponse {
+  export interface Data {
+    createdBy: string | null;
+
+    credentialName: string;
+
+    fields: Array<Data.Field>;
+
+    ownerId: string;
+
+    packageName: string;
+
+    secretPath: string;
+
+    /**
+     * @deprecated Deprecated: use createdBy (same value — the creating actor). Null
+     * for credentials created before rollout.
+     */
+    userId: string | null;
+  }
+
+  export namespace Data {
+    export interface Field {
+      fieldType:
+        | 'email'
+        | 'username'
+        | 'password'
+        | 'api_token'
+        | 'phone_number'
+        | 'two_factor_secret'
+        | 'backup_codes';
+
+      value: string;
+    }
+  }
+}
+
 export interface FieldUpdateResponse {
-  data: CredentialsAPI.Credential;
+  data: FieldUpdateResponse.Data;
 
   message: string;
 
   success: true;
 }
 
+export namespace FieldUpdateResponse {
+  export interface Data {
+    createdBy: string | null;
+
+    credentialName: string;
+
+    fields: Array<Data.Field>;
+
+    ownerId: string;
+
+    packageName: string;
+
+    secretPath: string;
+
+    /**
+     * @deprecated Deprecated: use createdBy (same value — the creating actor). Null
+     * for credentials created before rollout.
+     */
+    userId: string | null;
+  }
+
+  export namespace Data {
+    export interface Field {
+      fieldType:
+        | 'email'
+        | 'username'
+        | 'password'
+        | 'api_token'
+        | 'phone_number'
+        | 'two_factor_secret'
+        | 'backup_codes';
+
+      value: string;
+    }
+  }
+}
+
 export interface FieldDeleteResponse {
-  data: CredentialsAPI.Credential;
+  data: FieldDeleteResponse.Data;
 
   message: string;
 
   success: true;
 }
 
+export namespace FieldDeleteResponse {
+  export interface Data {
+    createdBy: string | null;
+
+    credentialName: string;
+
+    fields: Array<Data.Field>;
+
+    ownerId: string;
+
+    packageName: string;
+
+    secretPath: string;
+
+    /**
+     * @deprecated Deprecated: use createdBy (same value — the creating actor). Null
+     * for credentials created before rollout.
+     */
+    userId: string | null;
+  }
+
+  export namespace Data {
+    export interface Field {
+      fieldType:
+        | 'email'
+        | 'username'
+        | 'password'
+        | 'api_token'
+        | 'phone_number'
+        | 'two_factor_secret'
+        | 'backup_codes';
+
+      value: string;
+    }
+  }
+}
+
 export interface FieldCreateParams {
   /**
    * Path param

package/src/resources/credentials/packages/credentials/index.ts

@@ -2,7 +2,6 @@
 
 export {
   Credentials,
-  type Credential,
   type CredentialCreateResponse,
   type CredentialRetrieveResponse,
   type CredentialDeleteResponse,

package/src/resources/credentials/packages/index.ts

@@ -2,7 +2,6 @@
 
 export {
   Credentials,
-  type Credential,
   type CredentialCreateResponse,
   type CredentialRetrieveResponse,
   type CredentialDeleteResponse,
@@ -14,5 +13,6 @@ export {
   Packages,
   type PackageCreateResponse,
   type PackageListResponse,
+  type PackageListAllResponse,
   type PackageCreateParams,
 } from './packages';

package/src/resources/credentials/packages/packages.ts

@@ -3,7 +3,6 @@
 import { APIResource } from '../../../core/resource';
 import * as CredentialsAPI from './credentials/credentials';
 import {
-  Credential,
   CredentialCreateParams,
   CredentialCreateResponse,
   CredentialDeleteParams,
@@ -35,6 +34,15 @@ export class Packages extends APIResource {
   list(packageName: string, options?: RequestOptions): APIPromise<PackageListResponse> {
     return this._client.get(path`/credentials/packages/${packageName}`, options);
   }
+
+  /**
+   * Returns the names of all packages (apps) the authenticated owner has credentials
+   * grouped under. Use this to discover which `packageName` values are valid for the
+   * per-package credential routes.
+   */
+  listAll(options?: RequestOptions): APIPromise<PackageListAllResponse> {
+    return this._client.get('/credentials/packages', options);
+  }
 }
 
 export interface PackageCreateResponse {
@@ -52,7 +60,54 @@ export namespace PackageCreateResponse {
 }
 
 export interface PackageListResponse {
-  data: Array<CredentialsAPI.Credential>;
+  data: Array<PackageListResponse.Data>;
+}
+
+export namespace PackageListResponse {
+  export interface Data {
+    createdBy: string | null;
+
+    credentialName: string;
+
+    fields: Array<Data.Field>;
+
+    ownerId: string;
+
+    packageName: string;
+
+    secretPath: string;
+
+    /**
+     * @deprecated Deprecated: use createdBy (same value — the creating actor). Null
+     * for credentials created before rollout.
+     */
+    userId: string | null;
+  }
+
+  export namespace Data {
+    export interface Field {
+      fieldType:
+        | 'email'
+        | 'username'
+        | 'password'
+        | 'api_token'
+        | 'phone_number'
+        | 'two_factor_secret'
+        | 'backup_codes';
+
+      value: string;
+    }
+  }
+}
+
+export interface PackageListAllResponse {
+  data: Array<PackageListAllResponse.Data>;
+}
+
+export namespace PackageListAllResponse {
+  export interface Data {
+    packageName: string;
+  }
 }
 
 export interface PackageCreateParams {
@@ -65,12 +120,12 @@ export declare namespace Packages {
   export {
     type PackageCreateResponse as PackageCreateResponse,
     type PackageListResponse as PackageListResponse,
+    type PackageListAllResponse as PackageListAllResponse,
     type PackageCreateParams as PackageCreateParams,
   };
 
   export {
     Credentials as Credentials,
-    type Credential as Credential,
     type CredentialCreateResponse as CredentialCreateResponse,
     type CredentialRetrieveResponse as CredentialRetrieveResponse,
     type CredentialDeleteResponse as CredentialDeleteResponse,

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,
+  };
+}