@mobilerun/sdk 3.0.0 → 5.1.0

package/src/client.ts

@@ -17,16 +17,29 @@ import * as Errors from './core/error';
 import * as Uploads from './core/uploads';
 import * as API from './resources/index';
 import { APIPromise } from './core/api-promise';
-import { AgentListResponse, Agents } from './resources/agents';
-import { AppListParams, AppListResponse, Apps } from './resources/apps';
 import {
-  Carrier,
+  AppConfirmUploadResponse,
+  AppCreateSignedUploadURLParams,
+  AppCreateSignedUploadURLResponse,
+  AppDeleteResponse,
+  AppListParams,
+  AppListResponse,
+  AppListVersionsResponse,
+  AppMarkFailedResponse,
+  AppRetrieveResponse,
+  Apps,
+} from './resources/apps';
+import {
   CarrierCreateParams,
+  CarrierCreateResponse,
   CarrierDeleteResponse,
   CarrierListParams,
   CarrierListResponse,
   CarrierLookupParams,
+  CarrierLookupResponse,
+  CarrierRetrieveResponse,
   CarrierUpdateParams,
+  CarrierUpdateResponse,
   Carriers,
 } from './resources/carriers';
 import {
@@ -38,6 +51,8 @@ import {
   HookRetrieveResponse,
   HookSubscribeParams,
   HookSubscribeResponse,
+  HookTestParams,
+  HookTestResponse,
   HookUnsubscribeResponse,
   HookUpdateParams,
   HookUpdateResponse,
@@ -59,11 +74,15 @@ import {
   ProxyCreateParams,
   ProxyCreateResponse,
   ProxyDeleteResponse,
+  ProxyListParams,
   ProxyListResponse,
+  ProxyLookupParams,
+  ProxyLookupResponse,
   ProxyRetrieveResponse,
   ProxyUpdateParams,
   ProxyUpdateResponse,
 } from './resources/proxies';
+import { Connect } from './resources/connect/connect';
 import {
   CredentialListParams,
   CredentialListResponse,
@@ -73,8 +92,11 @@ import {
   Device,
   DeviceCountResponse,
   DeviceCreateParams,
+  DeviceFingerprintParams,
+  DeviceFingerprintResponse,
   DeviceListParams,
   DeviceListResponse,
+  DeviceSetNameParams,
   DeviceTerminateParams,
   Devices,
 } from './resources/devices/devices';
@@ -97,6 +119,20 @@ import {
   Tasks,
   UsageResult,
 } from './resources/tasks/tasks';
+import {
+  WebhookCreateParams,
+  WebhookCreateResponse,
+  WebhookEventTypesResponse,
+  WebhookListParams,
+  WebhookListResponse,
+  WebhookRetrieveResponse,
+  WebhookRotateSecretResponse,
+  WebhookTestDeliveryResponse,
+  WebhookUpdateParams,
+  WebhookUpdateResponse,
+  Webhooks,
+} from './resources/webhooks/webhooks';
+import { Flow, Workflows } from './resources/workflows/workflows';
 import { type Fetch } from './internal/builtin-types';
 import { HeadersLike, NullableHeaders, buildHeaders } from './internal/headers';
 import { FinalRequestOptions, RequestOptions } from './internal/request-options';
@@ -241,6 +277,18 @@ export class Mobilerun {
     this.fetch = options.fetch ?? Shims.getDefaultFetch();
     this.#encoder = Opts.FallbackEncoder;
 
+    const customHeadersEnv = readEnv('MOBILERUN_CUSTOM_HEADERS');
+    if (customHeadersEnv) {
+      const parsed: Record<string, string> = {};
+      for (const line of customHeadersEnv.split('\n')) {
+        const colon = line.indexOf(':');
+        if (colon >= 0) {
+          parsed[line.substring(0, colon).trim()] = line.substring(colon + 1).trim();
+        }
+      }
+      options.defaultHeaders = { ...parsed, ...options.defaultHeaders };
+    }
+
     this._options = options;
 
     this.apiKey = apiKey;
@@ -736,11 +784,19 @@ export class Mobilerun {
     return () => controller.abort();
   }
 
-  private buildBody({ options: { body, headers: rawHeaders } }: { options: FinalRequestOptions }): {
+  private buildBody({ options }: { options: FinalRequestOptions }): {
     bodyHeaders: HeadersLike;
     body: BodyInit | undefined;
   } {
+    const { body, headers: rawHeaders } = options;
     if (!body) {
+      // A resource method always passes a `body` key when its operation defines a
+      // request body, even if the caller omitted an optional body param. Keep the
+      // content-type for those, and only elide it for operations with no body at
+      // all (e.g. GET/DELETE).
+      if (body == null && 'body' in options) {
+        return this.#encoder({ body, headers: buildHeaders([rawHeaders]) });
+      }
       return { bodyHeaders: undefined, body: undefined };
     }
     const headers = buildHeaders([rawHeaders]);
@@ -801,79 +857,74 @@ export class Mobilerun {
   static toFile = Uploads.toFile;
 
   /**
-   * Tasks API
+   * App Management
    */
-  tasks: API.Tasks = new API.Tasks(this);
+  apps: API.Apps = new API.Apps(this);
   /**
-   * Agents API
+   * Mobile Carriers
    */
-  agents: API.Agents = new API.Agents(this);
-  proxies: API.Proxies = new API.Proxies(this);
   carriers: API.Carriers = new API.Carriers(this);
-  profiles: API.Profiles = new API.Profiles(this);
-  devices: API.Devices = new API.Devices(this);
-  apps: API.Apps = new API.Apps(this);
-  credentials: API.Credentials = new API.Credentials(this);
   /**
-   * Webhooks API
+   * Vault & Secrets
    */
+  credentials: API.Credentials = new API.Credentials(this);
+  devices: API.Devices = new API.Devices(this);
   hooks: API.Hooks = new API.Hooks(this);
+  /**
+   * LLM Models
+   */
   models: API.Models = new API.Models(this);
+  profiles: API.Profiles = new API.Profiles(this);
+  /**
+   * Network Proxies
+   */
+  proxies: API.Proxies = new API.Proxies(this);
+  connect: API.Connect = new API.Connect(this);
+  /**
+   * Tasks API
+   */
+  tasks: API.Tasks = new API.Tasks(this);
+  workflows: API.Workflows = new API.Workflows(this);
+  webhooks: API.Webhooks = new API.Webhooks(this);
 }
 
-Mobilerun.Tasks = Tasks;
-Mobilerun.Agents = Agents;
-Mobilerun.Proxies = Proxies;
-Mobilerun.Carriers = Carriers;
-Mobilerun.Profiles = Profiles;
-Mobilerun.Devices = Devices;
 Mobilerun.Apps = Apps;
+Mobilerun.Carriers = Carriers;
 Mobilerun.Credentials = Credentials;
+Mobilerun.Devices = Devices;
 Mobilerun.Hooks = Hooks;
 Mobilerun.Models = Models;
+Mobilerun.Profiles = Profiles;
+Mobilerun.Proxies = Proxies;
+Mobilerun.Connect = Connect;
+Mobilerun.Tasks = Tasks;
+Mobilerun.Workflows = Workflows;
+Mobilerun.Webhooks = Webhooks;
 
 export declare namespace Mobilerun {
   export type RequestOptions = Opts.RequestOptions;
 
   export {
-    Tasks as Tasks,
-    type PackageCredentials as PackageCredentials,
-    type Task as Task,
-    type TaskStatus as TaskStatus,
-    type UsageResult as UsageResult,
-    type TaskRetrieveResponse as TaskRetrieveResponse,
-    type TaskListResponse as TaskListResponse,
-    type TaskGetStatusResponse as TaskGetStatusResponse,
-    type TaskGetTrajectoryResponse as TaskGetTrajectoryResponse,
-    type TaskRunResponse as TaskRunResponse,
-    type TaskRunStreamedResponse as TaskRunStreamedResponse,
-    type TaskSendMessageResponse as TaskSendMessageResponse,
-    type TaskStopResponse as TaskStopResponse,
-    type TaskListParams as TaskListParams,
-    type TaskRunParams as TaskRunParams,
-    type TaskRunStreamedParams as TaskRunStreamedParams,
-    type TaskSendMessageParams as TaskSendMessageParams,
-  };
-
-  export { Agents as Agents, type AgentListResponse as AgentListResponse };
-
-  export {
-    Proxies as Proxies,
-    type ProxyConfig as ProxyConfig,
-    type ProxyCreateResponse as ProxyCreateResponse,
-    type ProxyRetrieveResponse as ProxyRetrieveResponse,
-    type ProxyUpdateResponse as ProxyUpdateResponse,
-    type ProxyListResponse as ProxyListResponse,
-    type ProxyDeleteResponse as ProxyDeleteResponse,
-    type ProxyCreateParams as ProxyCreateParams,
-    type ProxyUpdateParams as ProxyUpdateParams,
+    Apps as Apps,
+    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,
   };
 
   export {
     Carriers as Carriers,
-    type Carrier as Carrier,
+    type CarrierCreateResponse as CarrierCreateResponse,
+    type CarrierRetrieveResponse as CarrierRetrieveResponse,
+    type CarrierUpdateResponse as CarrierUpdateResponse,
     type CarrierListResponse as CarrierListResponse,
     type CarrierDeleteResponse as CarrierDeleteResponse,
+    type CarrierLookupResponse as CarrierLookupResponse,
     type CarrierCreateParams as CarrierCreateParams,
     type CarrierUpdateParams as CarrierUpdateParams,
     type CarrierListParams as CarrierListParams,
@@ -881,13 +932,9 @@ export declare namespace Mobilerun {
   };
 
   export {
-    Profiles as Profiles,
-    type Profile as Profile,
-    type ProfileListResponse as ProfileListResponse,
-    type ProfileDeleteResponse as ProfileDeleteResponse,
-    type ProfileCreateParams as ProfileCreateParams,
-    type ProfileUpdateParams as ProfileUpdateParams,
-    type ProfileListParams as ProfileListParams,
+    Credentials as Credentials,
+    type CredentialListResponse as CredentialListResponse,
+    type CredentialListParams as CredentialListParams,
   };
 
   export {
@@ -895,19 +942,14 @@ export declare namespace Mobilerun {
     type Device as Device,
     type DeviceListResponse as DeviceListResponse,
     type DeviceCountResponse as DeviceCountResponse,
+    type DeviceFingerprintResponse as DeviceFingerprintResponse,
     type DeviceCreateParams as DeviceCreateParams,
     type DeviceListParams as DeviceListParams,
+    type DeviceFingerprintParams as DeviceFingerprintParams,
+    type DeviceSetNameParams as DeviceSetNameParams,
     type DeviceTerminateParams as DeviceTerminateParams,
   };
 
-  export { Apps as Apps, type AppListResponse as AppListResponse, type AppListParams as AppListParams };
-
-  export {
-    Credentials as Credentials,
-    type CredentialListResponse as CredentialListResponse,
-    type CredentialListParams as CredentialListParams,
-  };
-
   export {
     Hooks as Hooks,
     type HookRetrieveResponse as HookRetrieveResponse,
@@ -916,21 +958,87 @@ export declare namespace Mobilerun {
     type HookGetSampleDataResponse as HookGetSampleDataResponse,
     type HookPerformResponse as HookPerformResponse,
     type HookSubscribeResponse as HookSubscribeResponse,
+    type HookTestResponse as HookTestResponse,
     type HookUnsubscribeResponse as HookUnsubscribeResponse,
     type HookUpdateParams as HookUpdateParams,
     type HookListParams as HookListParams,
     type HookPerformParams as HookPerformParams,
     type HookSubscribeParams as HookSubscribeParams,
+    type HookTestParams as HookTestParams,
   };
 
   export { Models as Models, type ModelListResponse as ModelListResponse };
 
-  export type Config = API.Config;
+  export {
+    Profiles as Profiles,
+    type Profile as Profile,
+    type ProfileListResponse as ProfileListResponse,
+    type ProfileDeleteResponse as ProfileDeleteResponse,
+    type ProfileCreateParams as ProfileCreateParams,
+    type ProfileUpdateParams as ProfileUpdateParams,
+    type ProfileListParams as ProfileListParams,
+  };
+
+  export {
+    Proxies as Proxies,
+    type ProxyConfig as ProxyConfig,
+    type ProxyCreateResponse as ProxyCreateResponse,
+    type ProxyRetrieveResponse as ProxyRetrieveResponse,
+    type ProxyUpdateResponse as ProxyUpdateResponse,
+    type ProxyListResponse as ProxyListResponse,
+    type ProxyDeleteResponse as ProxyDeleteResponse,
+    type ProxyLookupResponse as ProxyLookupResponse,
+    type ProxyCreateParams as ProxyCreateParams,
+    type ProxyUpdateParams as ProxyUpdateParams,
+    type ProxyListParams as ProxyListParams,
+    type ProxyLookupParams as ProxyLookupParams,
+  };
+
+  export { Connect as Connect };
+
+  export {
+    Tasks as Tasks,
+    type PackageCredentials as PackageCredentials,
+    type Task as Task,
+    type TaskStatus as TaskStatus,
+    type UsageResult as UsageResult,
+    type TaskRetrieveResponse as TaskRetrieveResponse,
+    type TaskListResponse as TaskListResponse,
+    type TaskGetStatusResponse as TaskGetStatusResponse,
+    type TaskGetTrajectoryResponse as TaskGetTrajectoryResponse,
+    type TaskRunResponse as TaskRunResponse,
+    type TaskRunStreamedResponse as TaskRunStreamedResponse,
+    type TaskSendMessageResponse as TaskSendMessageResponse,
+    type TaskStopResponse as TaskStopResponse,
+    type TaskListParams as TaskListParams,
+    type TaskRunParams as TaskRunParams,
+    type TaskRunStreamedParams as TaskRunStreamedParams,
+    type TaskSendMessageParams as TaskSendMessageParams,
+  };
+
+  export { Workflows as Workflows, type Flow as Flow };
+
+  export {
+    Webhooks as Webhooks,
+    type WebhookCreateResponse as WebhookCreateResponse,
+    type WebhookRetrieveResponse as WebhookRetrieveResponse,
+    type WebhookUpdateResponse as WebhookUpdateResponse,
+    type WebhookListResponse as WebhookListResponse,
+    type WebhookEventTypesResponse as WebhookEventTypesResponse,
+    type WebhookRotateSecretResponse as WebhookRotateSecretResponse,
+    type WebhookTestDeliveryResponse as WebhookTestDeliveryResponse,
+    type WebhookCreateParams as WebhookCreateParams,
+    type WebhookUpdateParams as WebhookUpdateParams,
+    type WebhookListParams as WebhookListParams,
+  };
+
   export type DeviceCarrier = API.DeviceCarrier;
   export type DeviceIdentifiers = API.DeviceIdentifiers;
   export type DeviceSpec = API.DeviceSpec;
+  export type Location = API.Location;
   export type Meta = API.Meta;
   export type Pagination = API.Pagination;
   export type PaginationMeta = API.PaginationMeta;
   export type PermissionSet = API.PermissionSet;
+  export type Socks5 = API.Socks5;
 }

package/src/internal/types.ts

@@ -40,7 +40,6 @@ type OverloadedParameters<T> =
   : T extends (...args: infer A) => unknown ? A
   : never;
 
-/* eslint-disable */
 /**
  * These imports attempt to get types from a parent package's dependencies.
  * Unresolved bare specifiers can trigger [automatic type acquisition][1] in some projects, which
@@ -63,19 +62,18 @@ type OverloadedParameters<T> =
  *
  * [1]: https://www.typescriptlang.org/tsconfig/#typeAcquisition
  */
-/** @ts-ignore For users with \@types/node */
+/** @ts-ignore For users with \@types/node */ /* prettier-ignore */
 type UndiciTypesRequestInit = NotAny<import('../node_modules/undici-types/index.d.ts').RequestInit> | NotAny<import('../../node_modules/undici-types/index.d.ts').RequestInit> | NotAny<import('../../../node_modules/undici-types/index.d.ts').RequestInit> | NotAny<import('../../../../node_modules/undici-types/index.d.ts').RequestInit> | NotAny<import('../../../../../node_modules/undici-types/index.d.ts').RequestInit> | NotAny<import('../../../../../../node_modules/undici-types/index.d.ts').RequestInit> | NotAny<import('../../../../../../../node_modules/undici-types/index.d.ts').RequestInit> | NotAny<import('../../../../../../../../node_modules/undici-types/index.d.ts').RequestInit> | NotAny<import('../../../../../../../../../node_modules/undici-types/index.d.ts').RequestInit> | NotAny<import('../../../../../../../../../../node_modules/undici-types/index.d.ts').RequestInit>;
-/** @ts-ignore For users with undici */
+/** @ts-ignore For users with undici */ /* prettier-ignore */
 type UndiciRequestInit = NotAny<import('../node_modules/undici/index.d.ts').RequestInit> | NotAny<import('../../node_modules/undici/index.d.ts').RequestInit> | NotAny<import('../../../node_modules/undici/index.d.ts').RequestInit> | NotAny<import('../../../../node_modules/undici/index.d.ts').RequestInit> | NotAny<import('../../../../../node_modules/undici/index.d.ts').RequestInit> | NotAny<import('../../../../../../node_modules/undici/index.d.ts').RequestInit> | NotAny<import('../../../../../../../node_modules/undici/index.d.ts').RequestInit> | NotAny<import('../../../../../../../../node_modules/undici/index.d.ts').RequestInit> | NotAny<import('../../../../../../../../../node_modules/undici/index.d.ts').RequestInit> | NotAny<import('../../../../../../../../../../node_modules/undici/index.d.ts').RequestInit>;
-/** @ts-ignore For users with \@types/bun */
+/** @ts-ignore For users with \@types/bun */ /* prettier-ignore */
 type BunRequestInit = globalThis.FetchRequestInit;
-/** @ts-ignore For users with node-fetch@2 */
+/** @ts-ignore For users with node-fetch@2 */ /* prettier-ignore */
 type NodeFetch2RequestInit = NotAny<import('../node_modules/@types/node-fetch/index.d.ts').RequestInit> | NotAny<import('../../node_modules/@types/node-fetch/index.d.ts').RequestInit> | NotAny<import('../../../node_modules/@types/node-fetch/index.d.ts').RequestInit> | NotAny<import('../../../../node_modules/@types/node-fetch/index.d.ts').RequestInit> | NotAny<import('../../../../../node_modules/@types/node-fetch/index.d.ts').RequestInit> | NotAny<import('../../../../../../node_modules/@types/node-fetch/index.d.ts').RequestInit> | NotAny<import('../../../../../../../node_modules/@types/node-fetch/index.d.ts').RequestInit> | NotAny<import('../../../../../../../../node_modules/@types/node-fetch/index.d.ts').RequestInit> | NotAny<import('../../../../../../../../../node_modules/@types/node-fetch/index.d.ts').RequestInit> | NotAny<import('../../../../../../../../../../node_modules/@types/node-fetch/index.d.ts').RequestInit>;
-/** @ts-ignore For users with node-fetch@3, doesn't need file extension because types are at ./@types/index.d.ts */
+/** @ts-ignore For users with node-fetch@3, doesn't need file extension because types are at ./@types/index.d.ts */ /* prettier-ignore */
 type NodeFetch3RequestInit =  NotAny<import('../node_modules/node-fetch').RequestInit> | NotAny<import('../../node_modules/node-fetch').RequestInit> | NotAny<import('../../../node_modules/node-fetch').RequestInit> | NotAny<import('../../../../node_modules/node-fetch').RequestInit> | NotAny<import('../../../../../node_modules/node-fetch').RequestInit> | NotAny<import('../../../../../../node_modules/node-fetch').RequestInit> | NotAny<import('../../../../../../../node_modules/node-fetch').RequestInit> | NotAny<import('../../../../../../../../node_modules/node-fetch').RequestInit> | NotAny<import('../../../../../../../../../node_modules/node-fetch').RequestInit> | NotAny<import('../../../../../../../../../../node_modules/node-fetch').RequestInit>;
-/** @ts-ignore For users who use Deno */
+/** @ts-ignore For users who use Deno */ /* prettier-ignore */
 type FetchRequestInit = NonNullable<OverloadedParameters<typeof fetch>[1]>;
-/* eslint-enable */
 
 type RequestInits =
   | NotAny<UndiciTypesRequestInit>

package/src/internal/utils/env.ts

@@ -9,10 +9,10 @@
  */
 export const readEnv = (env: string): string | undefined => {
   if (typeof (globalThis as any).process !== 'undefined') {
-    return (globalThis as any).process.env?.[env]?.trim() ?? undefined;
+    return (globalThis as any).process.env?.[env]?.trim() || undefined;
   }
   if (typeof (globalThis as any).Deno !== 'undefined') {
-    return (globalThis as any).Deno.env?.get?.(env)?.trim();
+    return (globalThis as any).Deno.env?.get?.(env)?.trim() || undefined;
   }
   return undefined;
 };

package/src/internal/utils/log.ts

@@ -107,6 +107,8 @@ export const formatRequestDetails = (details: {
           name,
           (
             name.toLowerCase() === 'authorization' ||
+            name.toLowerCase() === 'api-key' ||
+            name.toLowerCase() === 'x-api-key' ||
             name.toLowerCase() === 'cookie' ||
             name.toLowerCase() === 'set-cookie'
           ) ?