@mobilerun/sdk 5.1.0 → 5.2.1

package/src/resources/apps.ts

@@ -6,9 +6,6 @@ import { APIPromise } from '../core/api-promise';
 import { RequestOptions } from '../internal/request-options';
 import { path } from '../internal/utils/path';
 
-/**
- * App Management
- */
 export class Apps extends APIResource {
   /**
    * Retrieves an app by its ID
@@ -82,7 +79,6 @@ export class Apps extends APIResource {
    *       fileName: 'J!Q0Ok0bzJb7.apk/i',
    *     },
    *   ],
-   *   sizeBytes: 0,
    *   versionCode: 0,
    *   versionName: 'x',
    * });
@@ -123,6 +119,19 @@ export class Apps extends APIResource {
   markFailed(id: string, options?: RequestOptions): APIPromise<AppMarkFailedResponse> {
     return this._client.post(path`/apps/${id}/mark-failed`, options);
   }
+
+  /**
+   * Returns the user’s total storage quota, bytes used, and remaining bytes — the
+   * reliable maximum size for the next upload.
+   *
+   * @example
+   * ```ts
+   * const response = await client.apps.storageUsage();
+   * ```
+   */
+  storageUsage(options?: RequestOptions): APIPromise<AppStorageUsageResponse> {
+    return this._client.get('/apps/storage-usage', options);
+  }
 }
 
 export interface AppRetrieveResponse {
@@ -454,11 +463,15 @@ export namespace AppListResponse {
 
       createdAt: string | null;
 
+      createdBy: string | null;
+
+      ownerId: string | null;
+
       queuedAt: string | null;
 
       sizeBytes: number | null;
 
-      source: 'user' | 'system' | 'portal';
+      source: 'user' | 'system' | 'portal' | 'store';
 
       status: 'queued' | 'available' | 'failed';
 
@@ -466,6 +479,9 @@ export namespace AppListResponse {
 
       updatedAt: string | null;
 
+      /**
+       * @deprecated Deprecated: use ownerId (tenancy) / createdBy (actor).
+       */
       userId: string | null;
 
       versionCode: number;
@@ -778,11 +794,15 @@ export namespace AppListVersionsResponse {
 
     createdAt: string | null;
 
+    createdBy: string | null;
+
+    ownerId: string | null;
+
     queuedAt: string | null;
 
     sizeBytes: number | null;
 
-    source: 'user' | 'system' | 'portal';
+    source: 'user' | 'system' | 'portal' | 'store';
 
     status: 'queued' | 'available' | 'failed';
 
@@ -790,6 +810,9 @@ export namespace AppListVersionsResponse {
 
     updatedAt: string | null;
 
+    /**
+     * @deprecated Deprecated: use ownerId (tenancy) / createdBy (actor).
+     */
     userId: string | null;
 
     versionCode: number;
@@ -804,6 +827,31 @@ export interface AppMarkFailedResponse {
   success: true;
 }
 
+export interface AppStorageUsageResponse {
+  data: AppStorageUsageResponse.Data;
+}
+
+export namespace AppStorageUsageResponse {
+  export interface Data {
+    /**
+     * Remaining bytes — the reliable maximum size for the next upload. Advisory
+     * snapshot: the quota is enforced under a lock at confirm, so concurrent uploads
+     * may reduce actual headroom.
+     */
+    availableBytes: number;
+
+    /**
+     * Total storage allowance for the user, in bytes
+     */
+    quotaBytes: number;
+
+    /**
+     * Bytes currently consumed across all of the user’s app versions
+     */
+    usedBytes: number;
+  }
+}
+
 export interface AppListParams {
   order?: 'asc' | 'desc';
 
@@ -827,8 +875,6 @@ export interface AppCreateSignedUploadURLParams {
 
   files: Array<AppCreateSignedUploadURLParams.File>;
 
-  sizeBytes: number;
-
   versionCode: number;
 
   versionName: string;
@@ -868,6 +914,7 @@ export declare namespace Apps {
     type AppCreateSignedUploadURLResponse as AppCreateSignedUploadURLResponse,
     type AppListVersionsResponse as AppListVersionsResponse,
     type AppMarkFailedResponse as AppMarkFailedResponse,
+    type AppStorageUsageResponse as AppStorageUsageResponse,
     type AppListParams as AppListParams,
     type AppCreateSignedUploadURLParams as AppCreateSignedUploadURLParams,
   };

package/src/resources/carriers.ts

@@ -6,9 +6,6 @@ import { APIPromise } from '../core/api-promise';
 import { RequestOptions } from '../internal/request-options';
 import { path } from '../internal/utils/path';
 
-/**
- * Mobile Carriers
- */
 export class Carriers extends APIResource {
   /**
    * Create a new carrier

package/src/resources/connect/countries.ts

@@ -4,9 +4,14 @@ import { APIResource } from '../../core/resource';
 import { APIPromise } from '../../core/api-promise';
 import { RequestOptions } from '../../internal/request-options';
 
+/**
+ * Mobilerun Connect country coverage information
+ */
 export class Countries extends APIResource {
   /**
-   * Lookup of countries that can be selected when creating a proxy.
+   * Lookup of countries that can be selected when creating a proxy. Each country
+   * lists the proxy types available there; without a ?type filter, every covered
+   * country is returned.
    */
   list(
     query: CountryListParams | null | undefined = {},
@@ -40,7 +45,7 @@ export namespace CountryListResponse {
     /**
      * Proxy types available to provision in this country.
      */
-    proxyTypes: Array<'residential'>;
+    proxyTypes: Array<'dedicated_residential' | 'residential' | 'mobile'>;
   }
 
   /**
@@ -93,7 +98,7 @@ export interface CountryListParams {
   /**
    * Filter to countries offering this proxy type.
    */
-  type?: 'residential';
+  type?: 'dedicated_residential' | 'residential' | 'mobile';
 }
 
 export declare namespace Countries {

package/src/resources/connect/proxies.ts

@@ -8,15 +8,16 @@ import { path } from '../../internal/utils/path';
 
 export class Proxies extends APIResource {
   /**
-   * Get a proxy by ID, including its password
+   * Returns the proxy identified by the path ID. The response includes the proxy's
+   * password.
    */
   retrieve(id: string, options?: RequestOptions): APIPromise<ProxyRetrieveResponse> {
     return this._client.get(path`/connect/proxies/${id}`, options);
   }
 
   /**
-   * Returns proxies owned by the user identified by the X-User-ID header.
-   * Credentials are omitted from the list.
+   * Returns proxies owned by the calling tenant (the X-Owner-Id header, falling back
+   * to X-User-ID). Credentials are omitted from the list.
    */
   list(
     query: ProxyListParams | null | undefined = {},
@@ -26,14 +27,15 @@ export class Proxies extends APIResource {
   }
 
   /**
-   * Provisions a proxy for the caller in the selected country.
+   * Provisions a proxy of the requested type for the caller in the selected country.
    */
   buy(body: ProxyBuyParams, options?: RequestOptions): APIPromise<ProxyBuyResponse> {
     return this._client.post('/connect/proxies', { body, ...options });
   }
 
   /**
-   * Delete a proxy
+   * Deletes the proxy identified by the path ID and releases its provisioning.
+   * Returns 404 if no such proxy exists for the caller.
    */
   cancel(id: string, options?: RequestOptions): APIPromise<void> {
     return this._client.delete(path`/connect/proxies/${id}`, {
@@ -95,7 +97,7 @@ export interface ProxyRetrieveResponse {
    */
   status: 'pending_payment' | 'provisioning' | 'active' | 'cancelling' | 'ended' | 'error';
 
-  type: 'residential';
+  type: 'dedicated_residential' | 'residential' | 'mobile';
 
   username: string;
 
@@ -145,7 +147,7 @@ export namespace ProxyListResponse {
      */
     status: 'pending_payment' | 'provisioning' | 'active' | 'cancelling' | 'ended' | 'error';
 
-    type: 'residential';
+    type: 'dedicated_residential' | 'residential' | 'mobile';
 
     username: string;
   }
@@ -214,7 +216,7 @@ export interface ProxyBuyResponse {
    */
   status: 'pending_payment' | 'provisioning' | 'active' | 'cancelling' | 'ended' | 'error';
 
-  type: 'residential';
+  type: 'dedicated_residential' | 'residential' | 'mobile';
 
   username: string;
 
@@ -450,7 +452,7 @@ export interface ProxyBuyParams {
    */
   country: string;
 
-  type?: 'residential';
+  type: 'dedicated_residential' | 'residential' | 'mobile';
 }
 
 export interface ProxyListConnectionsParams {

package/src/resources/connect/users.ts

@@ -6,6 +6,9 @@ import { buildHeaders } from '../../internal/headers';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
+/**
+ * Manage your Mobilerun Connect Socks Users
+ */
 export class Users extends APIResource {
   /**
    * Creates a SOCKS5 credential, optionally bound to a proxy for dedicated routing.
@@ -16,7 +19,8 @@ export class Users extends APIResource {
   }
 
   /**
-   * Get a SOCKS5 user by ID, including its password
+   * Returns the SOCKS5 user identified by the path ID. The response includes the
+   * user's password.
    */
   retrieve(id: string, options?: RequestOptions): APIPromise<UserRetrieveResponse> {
     return this._client.get(path`/connect/users/${id}`, options);
@@ -40,7 +44,8 @@ export class Users extends APIResource {
   }
 
   /**
-   * Delete a SOCKS5 user
+   * Deletes the SOCKS5 user identified by the path ID, revoking its credentials and
+   * any proxy binding. Returns 404 if no such user exists for the caller.
    */
   delete(id: string, options?: RequestOptions): APIPromise<void> {
     return this._client.delete(path`/connect/users/${id}`, {

package/src/resources/credentials/credentials.ts

@@ -6,21 +6,20 @@ import * as PackagesAPI from './packages/packages';
 import {
   PackageCreateParams,
   PackageCreateResponse,
+  PackageListAllResponse,
   PackageListResponse,
   Packages,
 } from './packages/packages';
-import * as PackagesCredentialsAPI from './packages/credentials/credentials';
 import { APIPromise } from '../../core/api-promise';
 import { RequestOptions } from '../../internal/request-options';
 
-/**
- * Vault & Secrets
- */
 export class Credentials extends APIResource {
   packages: PackagesAPI.Packages = new PackagesAPI.Packages(this._client);
 
   /**
-   * List all credentials for the authenticated user
+   * Returns a paginated list of all credentials belonging to the authenticated user
+   * across every package. Accepts standard pagination query parameters and responds
+   * with the credential items plus pagination metadata.
    */
   list(
     query: CredentialListParams | null | undefined = {},
@@ -31,11 +30,48 @@ export class Credentials extends APIResource {
 }
 
 export interface CredentialListResponse {
-  items: Array<PackagesCredentialsAPI.Credential>;
+  items: Array<CredentialListResponse.Item>;
 
   pagination: Shared.Pagination;
 }
 
+export namespace CredentialListResponse {
+  export interface Item {
+    createdBy: string | null;
+
+    credentialName: string;
+
+    fields: Array<Item.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 Item {
+    export interface Field {
+      fieldType:
+        | 'email'
+        | 'username'
+        | 'password'
+        | 'api_token'
+        | 'phone_number'
+        | 'two_factor_secret'
+        | 'backup_codes';
+
+      value: string;
+    }
+  }
+}
+
 export interface CredentialListParams {
   page?: number;
 
@@ -54,6 +90,7 @@ export declare namespace Credentials {
     Packages as Packages,
     type PackageCreateResponse as PackageCreateResponse,
     type PackageListResponse as PackageListResponse,
+    type PackageListAllResponse as PackageListAllResponse,
     type PackageCreateParams as PackageCreateParams,
   };
 }

package/src/resources/credentials/index.ts

@@ -5,5 +5,6 @@ export {
   Packages,
   type PackageCreateResponse,
   type PackageListResponse,
+  type PackageListAllResponse,
   type PackageCreateParams,
 } from './packages/index';

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

@@ -15,14 +15,13 @@ import { APIPromise } from '../../../../core/api-promise';
 import { RequestOptions } from '../../../../internal/request-options';
 import { path } from '../../../../internal/utils/path';
 
-/**
- * Vault & Secrets
- */
 export class Credentials extends APIResource {
   fields: FieldsAPI.Fields = new FieldsAPI.Fields(this._client);
 
   /**
-   * Create a credential with fields for a package
+   * Creates a credential under the given package with a `credentialName` and at
+   * least one field. Each field has a `fieldType` (email, username, password,
+   * api_token, phone_number, two_factor_secret, or backup_codes) and a value.
    */
   create(
     packageName: string,
@@ -33,7 +32,8 @@ export class Credentials extends APIResource {
   }
 
   /**
-   * Get a specific credential with its fields
+   * Fetches a single credential by `packageName` and `credentialName`, including all
+   * of its stored fields. Returns not found if no matching credential exists.
    */
   retrieve(
     credentialName: string,
@@ -48,7 +48,8 @@ export class Credentials extends APIResource {
   }
 
   /**
-   * Delete a credential and all its fields
+   * Permanently deletes the credential identified by `packageName` and
+   * `credentialName`, removing all of its fields. Returns the deleted credential.
    */
   delete(
     credentialName: string,
@@ -63,53 +64,137 @@ export class Credentials extends APIResource {
   }
 }
 
-export interface Credential {
-  credentialName: string;
+export interface CredentialCreateResponse {
+  data: CredentialCreateResponse.Data;
 
-  fields: Array<Credential.Field>;
+  message: string;
 
-  packageName: string;
+  success: true;
+}
 
-  secretPath: string;
+export namespace CredentialCreateResponse {
+  export interface Data {
+    createdBy: string | null;
 
-  userId: string;
-}
+    credentialName: string;
 
-export namespace Credential {
-  export interface Field {
-    fieldType:
-      | 'email'
-      | 'username'
-      | 'password'
-      | 'api_token'
-      | 'phone_number'
-      | 'two_factor_secret'
-      | 'backup_codes';
+    fields: Array<Data.Field>;
 
-    value: string;
-  }
-}
+    ownerId: string;
 
-export interface CredentialCreateResponse {
-  data: Credential;
+    packageName: string;
 
-  message: string;
+    secretPath: string;
 
-  success: true;
+    /**
+     * @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 CredentialRetrieveResponse {
-  data: Credential;
+  data: CredentialRetrieveResponse.Data;
+}
+
+export namespace CredentialRetrieveResponse {
+  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 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;
 
@@ -143,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,