@mobilerun/sdk 4.0.0 → 5.2.0

package/src/resources/apps.ts

@@ -4,14 +4,147 @@ import { APIResource } from '../core/resource';
 import * as Shared from './shared';
 import { APIPromise } from '../core/api-promise';
 import { RequestOptions } from '../internal/request-options';
+import { path } from '../internal/utils/path';
 
 export class Apps extends APIResource {
+  /**
+   * Retrieves an app by its ID
+   *
+   * @example
+   * ```ts
+   * const app = await client.apps.retrieve(
+   *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+   * );
+   * ```
+   */
+  retrieve(id: string, options?: RequestOptions): APIPromise<AppRetrieveResponse> {
+    return this._client.get(path`/apps/${id}`, options);
+  }
+
   /**
    * Retrieves a paginated list of apps with filtering and search capabilities
+   *
+   * @example
+   * ```ts
+   * const apps = await client.apps.list();
+   * ```
    */
   list(query: AppListParams | null | undefined = {}, options?: RequestOptions): APIPromise<AppListResponse> {
     return this._client.get('/apps', { query, ...options });
   }
+
+  /**
+   * Deletes an uploaded app by ID. Removes files from R2 storage and the database
+   * entry.
+   *
+   * @example
+   * ```ts
+   * const app = await client.apps.delete(
+   *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+   * );
+   * ```
+   */
+  delete(id: string, options?: RequestOptions): APIPromise<AppDeleteResponse> {
+    return this._client.delete(path`/apps/${id}`, options);
+  }
+
+  /**
+   * Verifies the APK file exists in R2 and sets the app status to available.
+   *
+   * @example
+   * ```ts
+   * const response = await client.apps.confirmUpload(
+   *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+   * );
+   * ```
+   */
+  confirmUpload(id: string, options?: RequestOptions): APIPromise<AppConfirmUploadResponse> {
+    return this._client.post(path`/apps/${id}/confirm-upload`, options);
+  }
+
+  /**
+   * Creates or updates an app and returns pre-signed Cloudflare R2 upload URLs for
+   * each file
+   *
+   * @example
+   * ```ts
+   * const response = await client.apps.createSignedUploadURL({
+   *   bundleId:
+   *     'NX0.JB-_-.m-u--_-p.Z1-u_2I.D--_T-_.dzZ-.Wx.L_a8--_.w_D_',
+   *   displayName: 'x',
+   *   files: [
+   *     {
+   *       contentType:
+   *         'application/vnd.android.package-archive',
+   *       fileName: 'J!Q0Ok0bzJb7.apk/i',
+   *     },
+   *   ],
+   *   versionCode: 0,
+   *   versionName: 'x',
+   * });
+   * ```
+   */
+  createSignedUploadURL(
+    body: AppCreateSignedUploadURLParams,
+    options?: RequestOptions,
+  ): APIPromise<AppCreateSignedUploadURLResponse> {
+    return this._client.post('/apps/create-signed-upload-url', { body, ...options });
+  }
+
+  /**
+   * Retrieves all versions of an app visible to the user (own uploads + system
+   * versions)
+   *
+   * @example
+   * ```ts
+   * const response = await client.apps.listVersions(
+   *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+   * );
+   * ```
+   */
+  listVersions(id: string, options?: RequestOptions): APIPromise<AppListVersionsResponse> {
+    return this._client.get(path`/apps/${id}/versions`, options);
+  }
+
+  /**
+   * Sets the app status to failed.
+   *
+   * @example
+   * ```ts
+   * const response = await client.apps.markFailed(
+   *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+   * );
+   * ```
+   */
+  markFailed(id: string, options?: RequestOptions): APIPromise<AppMarkFailedResponse> {
+    return this._client.post(path`/apps/${id}/mark-failed`, options);
+  }
+}
+
+export interface AppRetrieveResponse {
+  data: AppRetrieveResponse.Data;
+}
+
+export namespace AppRetrieveResponse {
+  export interface Data {
+    id: string;
+
+    bundleId: string;
+
+    createdAt: string | null;
+
+    description: string | null;
+
+    developerName: string | null;
+
+    displayName: string;
+
+    iconURL: string;
+
+    platform: 'android' | 'ios';
+
+    updatedAt: string | null;
+  }
 }
 
 export interface AppListResponse {
@@ -26,19 +159,371 @@ export namespace AppListResponse {
   export interface Count {
     availableCount: number;
 
-    queuedCount: number;
+    failedCount: number;
 
-    storeCount: number;
+    queuedCount: number;
 
     totalCount: number;
-
-    uploadCount: number;
   }
 
   export interface Item {
     id: string;
 
-    categoryName: string | null;
+    bundleId: string;
+
+    createdAt: string | null;
+
+    description: string | null;
+
+    developerName: string | null;
+
+    displayName: string;
+
+    iconURL: string;
+
+    platform: 'android' | 'ios';
+
+    updatedAt: string | null;
+
+    version: Item.Version;
+  }
+
+  export namespace Item {
+    export interface Version {
+      id: string;
+
+      appId: string;
+
+      country:
+        | 'AF'
+        | 'AL'
+        | 'DZ'
+        | 'AS'
+        | 'AD'
+        | 'AO'
+        | 'AI'
+        | 'AQ'
+        | 'AG'
+        | 'AR'
+        | 'AM'
+        | 'AW'
+        | 'AP'
+        | 'AU'
+        | 'AT'
+        | 'AZ'
+        | 'BS'
+        | 'BH'
+        | 'BD'
+        | 'BB'
+        | 'BY'
+        | 'BE'
+        | 'BZ'
+        | 'BJ'
+        | 'BM'
+        | 'BT'
+        | 'BO'
+        | 'BQ'
+        | 'BA'
+        | 'BW'
+        | 'BV'
+        | 'BR'
+        | 'IO'
+        | 'BN'
+        | 'BG'
+        | 'BF'
+        | 'BI'
+        | 'KH'
+        | 'CM'
+        | 'CA'
+        | 'CV'
+        | 'KY'
+        | 'CF'
+        | 'TD'
+        | 'CL'
+        | 'CN'
+        | 'CX'
+        | 'CC'
+        | 'CO'
+        | 'KM'
+        | 'CG'
+        | 'CD'
+        | 'CK'
+        | 'CR'
+        | 'HR'
+        | 'CU'
+        | 'CW'
+        | 'CY'
+        | 'CZ'
+        | 'CI'
+        | 'DK'
+        | 'DJ'
+        | 'DM'
+        | 'DO'
+        | 'EC'
+        | 'EG'
+        | 'SV'
+        | 'GQ'
+        | 'ER'
+        | 'EE'
+        | 'ET'
+        | 'FK'
+        | 'FO'
+        | 'FJ'
+        | 'FI'
+        | 'FR'
+        | 'GF'
+        | 'PF'
+        | 'TF'
+        | 'GA'
+        | 'GM'
+        | 'GE'
+        | 'DE'
+        | 'GH'
+        | 'GI'
+        | 'GR'
+        | 'GL'
+        | 'GD'
+        | 'GP'
+        | 'GU'
+        | 'GT'
+        | 'GG'
+        | 'GN'
+        | 'GW'
+        | 'GY'
+        | 'HT'
+        | 'HM'
+        | 'VA'
+        | 'HN'
+        | 'HK'
+        | 'HU'
+        | 'IS'
+        | 'IN'
+        | 'ID'
+        | 'IR'
+        | 'IQ'
+        | 'IE'
+        | 'IM'
+        | 'IL'
+        | 'IT'
+        | 'JM'
+        | 'JP'
+        | 'JE'
+        | 'JO'
+        | 'KZ'
+        | 'KE'
+        | 'KI'
+        | 'KR'
+        | 'KW'
+        | 'KG'
+        | 'LA'
+        | 'LV'
+        | 'LB'
+        | 'LS'
+        | 'LR'
+        | 'LY'
+        | 'LI'
+        | 'LT'
+        | 'LU'
+        | 'MO'
+        | 'MG'
+        | 'MW'
+        | 'MY'
+        | 'MV'
+        | 'ML'
+        | 'MT'
+        | 'MH'
+        | 'MQ'
+        | 'MR'
+        | 'MU'
+        | 'YT'
+        | 'MX'
+        | 'FM'
+        | 'MD'
+        | 'MC'
+        | 'MN'
+        | 'ME'
+        | 'MS'
+        | 'MA'
+        | 'MZ'
+        | 'MM'
+        | 'NA'
+        | 'NR'
+        | 'NP'
+        | 'NL'
+        | 'AN'
+        | 'NC'
+        | 'NZ'
+        | 'NI'
+        | 'NE'
+        | 'NG'
+        | 'NU'
+        | 'NF'
+        | 'KP'
+        | 'MK'
+        | 'MP'
+        | 'NO'
+        | 'OM'
+        | 'PK'
+        | 'PW'
+        | 'PS'
+        | 'PA'
+        | 'PG'
+        | 'PY'
+        | 'PE'
+        | 'PH'
+        | 'PN'
+        | 'PL'
+        | 'PT'
+        | 'PR'
+        | 'QA'
+        | 'RE'
+        | 'RO'
+        | 'RU'
+        | 'RW'
+        | 'BL'
+        | 'SH'
+        | 'KN'
+        | 'LC'
+        | 'MF'
+        | 'PM'
+        | 'VC'
+        | 'WS'
+        | 'SM'
+        | 'ST'
+        | 'SA'
+        | 'SN'
+        | 'RS'
+        | 'CS'
+        | 'SC'
+        | 'SL'
+        | 'SG'
+        | 'SX'
+        | 'SK'
+        | 'SI'
+        | 'SB'
+        | 'SO'
+        | 'ZA'
+        | 'GS'
+        | 'SS'
+        | 'ES'
+        | 'LK'
+        | 'SD'
+        | 'SR'
+        | 'SJ'
+        | 'SZ'
+        | 'SE'
+        | 'CH'
+        | 'SY'
+        | 'TW'
+        | 'TJ'
+        | 'TZ'
+        | 'TH'
+        | 'TL'
+        | 'TG'
+        | 'TK'
+        | 'TO'
+        | 'TT'
+        | 'TN'
+        | 'TR'
+        | 'TM'
+        | 'TC'
+        | 'TV'
+        | 'UG'
+        | 'UA'
+        | 'AE'
+        | 'GB'
+        | 'US'
+        | 'UM'
+        | 'UY'
+        | 'UZ'
+        | 'VU'
+        | 'VE'
+        | 'VN'
+        | 'VG'
+        | 'VI'
+        | 'WF'
+        | 'EH'
+        | 'YE'
+        | 'ZM'
+        | 'ZW'
+        | 'AX';
+
+      createdAt: string | null;
+
+      createdBy: string | null;
+
+      ownerId: string | null;
+
+      queuedAt: string | null;
+
+      sizeBytes: number | null;
+
+      source: 'user' | 'system' | 'portal' | 'store';
+
+      status: 'queued' | 'available' | 'failed';
+
+      targetSdk: number | null;
+
+      updatedAt: string | null;
+
+      /**
+       * @deprecated Deprecated: use ownerId (tenancy) / createdBy (actor).
+       */
+      userId: string | null;
+
+      versionCode: number;
+
+      versionName: string;
+    }
+  }
+}
+
+export interface AppDeleteResponse {
+  message: string;
+
+  success: true;
+}
+
+export interface AppConfirmUploadResponse {
+  message: string;
+
+  success: true;
+}
+
+export interface AppCreateSignedUploadURLResponse {
+  /**
+   * App ID in the database
+   */
+  appId: string;
+
+  /**
+   * Pre-signed Cloudflare R2 URLs for uploading app files
+   */
+  r2UploadUrls: Array<AppCreateSignedUploadURLResponse.R2UploadURL>;
+
+  /**
+   * App version ID in the database
+   */
+  versionId: string;
+}
+
+export namespace AppCreateSignedUploadURLResponse {
+  export interface R2UploadURL {
+    fileName: string;
+
+    r2UploadUrl: string;
+  }
+}
+
+export interface AppListVersionsResponse {
+  data: Array<AppListVersionsResponse.Data>;
+}
+
+export namespace AppListVersionsResponse {
+  export interface Data {
+    id: string;
+
+    appId: string;
 
     country:
       | 'AF'
@@ -296,40 +781,25 @@ export namespace AppListResponse {
 
     createdAt: string | null;
 
-    description: string | null;
-
-    developerName: string | null;
-
-    displayName: string;
+    createdBy: string | null;
 
-    expectedFiles: string | number | boolean | { [key: string]: unknown } | Array<unknown> | null;
-
-    iconURL: string;
-
-    packageName: string;
-
-    privacyPolicyUrl: string | null;
+    ownerId: string | null;
 
     queuedAt: string | null;
 
-    ratingCount: number | null;
-
-    ratingScore: string | null;
-
     sizeBytes: number | null;
 
-    source: 'uploaded' | 'store';
+    source: 'user' | 'system' | 'portal' | 'store';
 
     status: 'queued' | 'available' | 'failed';
 
-    stealthTier: 'tier1' | 'tier2' | 'tier3' | null;
-
     targetSdk: number | null;
 
-    type: 'android' | 'ios';
-
     updatedAt: string | null;
 
+    /**
+     * @deprecated Deprecated: use ownerId (tenancy) / createdBy (actor).
+     */
     userId: string | null;
 
     versionCode: number;
@@ -338,6 +808,12 @@ export namespace AppListResponse {
   }
 }
 
+export interface AppMarkFailedResponse {
+  message: string;
+
+  success: true;
+}
+
 export interface AppListParams {
   order?: 'asc' | 'desc';
 
@@ -345,13 +821,62 @@ export interface AppListParams {
 
   pageSize?: number;
 
+  platform?: 'all' | 'android' | 'ios';
+
   query?: string;
 
   sortBy?: 'createdAt' | 'name';
 
-  source?: 'all' | 'uploaded' | 'store' | 'queued';
+  status?: 'all' | 'queued' | 'available' | 'failed';
+}
+
+export interface AppCreateSignedUploadURLParams {
+  bundleId: string;
+
+  displayName: string;
+
+  files: Array<AppCreateSignedUploadURLParams.File>;
+
+  versionCode: number;
+
+  versionName: string;
+
+  /**
+   * Country code for Search Results
+   */
+  country?: string;
+
+  description?: string;
+
+  developerName?: string;
+
+  iconURL?: string;
+
+  platform?: 'android' | 'ios';
+
+  targetSdk?: number;
+}
+
+export namespace AppCreateSignedUploadURLParams {
+  export interface File {
+    contentType: 'application/vnd.android.package-archive' | 'application/octet-stream' | 'application/zip';
+
+    fileName: string;
+
+    sha256?: string;
+  }
 }
 
 export declare namespace Apps {
-  export { type AppListResponse as AppListResponse, type AppListParams as AppListParams };
+  export {
+    type AppRetrieveResponse as AppRetrieveResponse,
+    type AppListResponse as AppListResponse,
+    type AppDeleteResponse as AppDeleteResponse,
+    type AppConfirmUploadResponse as AppConfirmUploadResponse,
+    type AppCreateSignedUploadURLResponse as AppCreateSignedUploadURLResponse,
+    type AppListVersionsResponse as AppListVersionsResponse,
+    type AppMarkFailedResponse as AppMarkFailedResponse,
+    type AppListParams as AppListParams,
+    type AppCreateSignedUploadURLParams as AppCreateSignedUploadURLParams,
+  };
 }