@mobilerun/sdk 5.4.0 → 5.6.0

package/resources/connect/proxies.d.ts

@@ -7,6 +7,10 @@ export declare class Proxies extends APIResource {
      * password.
      */
     retrieve(id: string, options?: RequestOptions): APIPromise<ProxyRetrieveResponse>;
+    /**
+     * Renames the proxy identified by the path ID.
+     */
+    update(id: string, body: ProxyUpdateParams, options?: RequestOptions): APIPromise<ProxyUpdateResponse>;
     /**
      * Returns proxies owned by the calling tenant (the X-Owner-Id header, falling back
      * to X-User-ID). Credentials are omitted from the list.
@@ -21,6 +25,17 @@ export declare class Proxies extends APIResource {
      * Returns 404 if no such proxy exists for the caller.
      */
     cancel(id: string, options?: RequestOptions): APIPromise<void>;
+    /**
+     * Checks right now that the proxy's upstream accepts a connection through its
+     * current session. If the upstream refuses the session and the proxy is a rotating
+     * (sticky-session) proxy, the proxy is moved onto a fresh session that has been
+     * checked to work; its credentials and country stay the same, its exit IP changes.
+     * Intended for callers that are about to depend on the proxy (e.g. while
+     * provisioning a phone). After `rotated`, the gateway uses the new session within
+     * about 30 seconds. A `refused` or `unreachable` result is not an error: the
+     * response describes the proxy's state.
+     */
+    ensureHealthy(id: string, options?: RequestOptions): APIPromise<ProxyEnsureHealthyResponse>;
     /**
      * Returns the connection history recorded for this proxy, one item per connection
      * (aggregated across the connection's lifetime). Supports filtering on every
@@ -47,24 +62,63 @@ export interface ProxyRetrieveResponse {
     country: string;
     createdAt: string;
     host: string;
+    /**
+     * Display name for the proxy. Set it on create or change it with PATCH; when no
+     * name has been set, a label generated from the proxy's country, type, and id is
+     * returned instead — so this is never empty.
+     */
+    name: string;
     password: string;
     port: number;
     /**
-     * Lifecycle of a proxy. A freshly created proxy is `provisioning` — or
-     * `pending_payment` until the customer completes checkout — and becomes `active`
-     * once its upstream is assigned. `cancelling` retains full access through the paid
-     * period; when the subscription expires the proxy is `ended`. `error` marks a
-     * failed provisioning attempt.
+     * Lifecycle of a proxy. A freshly created proxy is `checking` while its billing
+     * identity is being resolved — clients should poll until a `paymentUrl` or a later
+     * status appears — then `provisioning` — or `pending_payment` until the customer
+     * completes checkout — and becomes `active` once its upstream is assigned.
+     * `cancelling` retains full access through the paid period; when the subscription
+     * expires the proxy is `ended`. `error` marks a failed provisioning attempt.
      */
-    status: 'pending_payment' | 'provisioning' | 'active' | 'cancelling' | 'ended' | 'error';
+    status: 'checking' | 'pending_payment' | 'provisioning' | 'active' | 'cancelling' | 'ended' | 'error';
     type: 'dedicated_residential' | 'residential' | 'mobile';
     username: string;
+    billingMode?: 'included' | 'standalone_paid';
     /**
      * Checkout URL to complete payment while status is `pending_payment`. Null once
      * paid or when no payment was required.
      */
     paymentUrl?: string | null;
 }
+/**
+ * A provisioned proxy without its credentials.
+ */
+export interface ProxyUpdateResponse {
+    id: string;
+    /**
+     * ISO 3166-1 alpha-2 country code (lowercase).
+     */
+    country: string;
+    createdAt: string;
+    host: string;
+    /**
+     * Display name for the proxy. Set it on create or change it with PATCH; when no
+     * name has been set, a label generated from the proxy's country, type, and id is
+     * returned instead — so this is never empty.
+     */
+    name: string;
+    port: number;
+    /**
+     * Lifecycle of a proxy. A freshly created proxy is `checking` while its billing
+     * identity is being resolved — clients should poll until a `paymentUrl` or a later
+     * status appears — then `provisioning` — or `pending_payment` until the customer
+     * completes checkout — and becomes `active` once its upstream is assigned.
+     * `cancelling` retains full access through the paid period; when the subscription
+     * expires the proxy is `ended`. `error` marks a failed provisioning attempt.
+     */
+    status: 'checking' | 'pending_payment' | 'provisioning' | 'active' | 'cancelling' | 'ended' | 'error';
+    type: 'dedicated_residential' | 'residential' | 'mobile';
+    username: string;
+    billingMode?: 'included' | 'standalone_paid';
+}
 /**
  * A page of proxies.
  */
@@ -87,17 +141,25 @@ export declare namespace ProxyListResponse {
         country: string;
         createdAt: string;
         host: string;
+        /**
+         * Display name for the proxy. Set it on create or change it with PATCH; when no
+         * name has been set, a label generated from the proxy's country, type, and id is
+         * returned instead — so this is never empty.
+         */
+        name: string;
         port: number;
         /**
-         * Lifecycle of a proxy. A freshly created proxy is `provisioning` — or
-         * `pending_payment` until the customer completes checkout — and becomes `active`
-         * once its upstream is assigned. `cancelling` retains full access through the paid
-         * period; when the subscription expires the proxy is `ended`. `error` marks a
-         * failed provisioning attempt.
+         * Lifecycle of a proxy. A freshly created proxy is `checking` while its billing
+         * identity is being resolved — clients should poll until a `paymentUrl` or a later
+         * status appears — then `provisioning` — or `pending_payment` until the customer
+         * completes checkout — and becomes `active` once its upstream is assigned.
+         * `cancelling` retains full access through the paid period; when the subscription
+         * expires the proxy is `ended`. `error` marks a failed provisioning attempt.
          */
-        status: 'pending_payment' | 'provisioning' | 'active' | 'cancelling' | 'ended' | 'error';
+        status: 'checking' | 'pending_payment' | 'provisioning' | 'active' | 'cancelling' | 'ended' | 'error';
         type: 'dedicated_residential' | 'residential' | 'mobile';
         username: string;
+        billingMode?: 'included' | 'standalone_paid';
     }
     /**
      * Pagination metadata for a list response.
@@ -140,24 +202,46 @@ export interface ProxyBuyResponse {
     country: string;
     createdAt: string;
     host: string;
+    /**
+     * Display name for the proxy. Set it on create or change it with PATCH; when no
+     * name has been set, a label generated from the proxy's country, type, and id is
+     * returned instead — so this is never empty.
+     */
+    name: string;
     password: string;
     port: number;
     /**
-     * Lifecycle of a proxy. A freshly created proxy is `provisioning` — or
-     * `pending_payment` until the customer completes checkout — and becomes `active`
-     * once its upstream is assigned. `cancelling` retains full access through the paid
-     * period; when the subscription expires the proxy is `ended`. `error` marks a
-     * failed provisioning attempt.
+     * Lifecycle of a proxy. A freshly created proxy is `checking` while its billing
+     * identity is being resolved — clients should poll until a `paymentUrl` or a later
+     * status appears — then `provisioning` — or `pending_payment` until the customer
+     * completes checkout — and becomes `active` once its upstream is assigned.
+     * `cancelling` retains full access through the paid period; when the subscription
+     * expires the proxy is `ended`. `error` marks a failed provisioning attempt.
      */
-    status: 'pending_payment' | 'provisioning' | 'active' | 'cancelling' | 'ended' | 'error';
+    status: 'checking' | 'pending_payment' | 'provisioning' | 'active' | 'cancelling' | 'ended' | 'error';
     type: 'dedicated_residential' | 'residential' | 'mobile';
     username: string;
+    billingMode?: 'included' | 'standalone_paid';
     /**
      * Checkout URL to complete payment while status is `pending_payment`. Null once
      * paid or when no payment was required.
      */
     paymentUrl?: string | null;
 }
+/**
+ * The outcome of an ensure-healthy check.
+ */
+export interface ProxyEnsureHealthyResponse {
+    proxyId: string;
+    /**
+     * `healthy`: the upstream accepted the current session. `rotated`: the session was
+     * refused and the proxy now uses a fresh, checked session; retry through the
+     * proxy. `refused`: the session was refused and could not be replaced.
+     * `unreachable`: the upstream could not be reached; the session was left
+     * unchanged.
+     */
+    status: 'healthy' | 'rotated' | 'refused' | 'unreachable';
+}
 /**
  * A page of connections.
  */
@@ -325,6 +409,15 @@ export declare namespace ProxyPingResponse {
         target: string;
     }
 }
+export interface ProxyUpdateParams {
+    /**
+     * New display name, up to 64 characters excluding surrounding whitespace, and
+     * containing no NUL. Send null (or an empty/whitespace-only string) to drop a
+     * custom name and go back to the generated label. Omit to leave the name
+     * unchanged.
+     */
+    name?: string | null;
+}
 export interface ProxyListParams {
     /**
      * Filter to proxies in this country (ISO 3166-1 alpha-2, lowercase).
@@ -345,6 +438,12 @@ export interface ProxyBuyParams {
      */
     country: string;
     type: 'dedicated_residential' | 'residential' | 'mobile';
+    /**
+     * Display name for the proxy, up to 64 characters excluding surrounding
+     * whitespace, and containing no NUL. Omit it (or send only whitespace) to get a
+     * generated label built from the country, type, and id.
+     */
+    name?: string;
 }
 export interface ProxyListConnectionsParams {
     /**
@@ -451,6 +550,6 @@ export interface ProxyListConnectionsParams {
     userId?: string;
 }
 export declare namespace Proxies {
-    export { type ProxyRetrieveResponse as ProxyRetrieveResponse, type ProxyListResponse as ProxyListResponse, type ProxyBuyResponse as ProxyBuyResponse, type ProxyListConnectionsResponse as ProxyListConnectionsResponse, type ProxyPingResponse as ProxyPingResponse, type ProxyListParams as ProxyListParams, type ProxyBuyParams as ProxyBuyParams, type ProxyListConnectionsParams as ProxyListConnectionsParams, };
+    export { type ProxyRetrieveResponse as ProxyRetrieveResponse, type ProxyUpdateResponse as ProxyUpdateResponse, type ProxyListResponse as ProxyListResponse, type ProxyBuyResponse as ProxyBuyResponse, type ProxyEnsureHealthyResponse as ProxyEnsureHealthyResponse, type ProxyListConnectionsResponse as ProxyListConnectionsResponse, type ProxyPingResponse as ProxyPingResponse, type ProxyUpdateParams as ProxyUpdateParams, type ProxyListParams as ProxyListParams, type ProxyBuyParams as ProxyBuyParams, type ProxyListConnectionsParams as ProxyListConnectionsParams, };
 }
 //# sourceMappingURL=proxies.d.ts.map

package/resources/connect/proxies.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"proxies.d.ts","sourceRoot":"","sources":["../../src/resources/connect/proxies.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,+BAA4B;AAClD,OAAO,EAAE,UAAU,EAAE,kCAA+B;AAEpD,OAAO,EAAE,cAAc,EAAE,0CAAuC;AAGhE,qBAAa,OAAQ,SAAQ,WAAW;IACtC;;;OAGG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,qBAAqB,CAAC;IAIjF;;;OAGG;IACH,IAAI,CACF,KAAK,GAAE,eAAe,GAAG,IAAI,GAAG,SAAc,EAC9C,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,iBAAiB,CAAC;IAIhC;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,gBAAgB,CAAC;IAIjF;;;OAGG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;IAO9D;;;;;OAKG;IACH,eAAe,CACb,EAAE,EAAE,MAAM,EACV,KAAK,GAAE,0BAA0B,GAAG,IAAI,GAAG,SAAc,EACzD,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,4BAA4B,CAAC;IAI3C;;;;;OAKG;IACH,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,iBAAiB,CAAC;CAG1E;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB,SAAS,EAAE,MAAM,CAAC;IAElB,IAAI,EAAE,MAAM,CAAC;IAEb,QAAQ,EAAE,MAAM,CAAC;IAEjB,IAAI,EAAE,MAAM,CAAC;IAEb;;;;;;OAMG;IACH,MAAM,EAAE,iBAAiB,GAAG,cAAc,GAAG,QAAQ,GAAG,YAAY,GAAG,OAAO,GAAG,OAAO,CAAC;IAEzF,IAAI,EAAE,uBAAuB,GAAG,aAAa,GAAG,QAAQ,CAAC;IAEzD,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,KAAK,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAErC;;OAEG;IACH,UAAU,EAAE,iBAAiB,CAAC,UAAU,CAAC;CAC1C;AAED,yBAAiB,iBAAiB,CAAC;IACjC;;OAEG;IACH,UAAiB,IAAI;QACnB,EAAE,EAAE,MAAM,CAAC;QAEX;;WAEG;QACH,OAAO,EAAE,MAAM,CAAC;QAEhB,SAAS,EAAE,MAAM,CAAC;QAElB,IAAI,EAAE,MAAM,CAAC;QAEb,IAAI,EAAE,MAAM,CAAC;QAEb;;;;;;WAMG;QACH,MAAM,EAAE,iBAAiB,GAAG,cAAc,GAAG,QAAQ,GAAG,YAAY,GAAG,OAAO,GAAG,OAAO,CAAC;QAEzF,IAAI,EAAE,uBAAuB,GAAG,aAAa,GAAG,QAAQ,CAAC;QAEzD,QAAQ,EAAE,MAAM,CAAC;KAClB;IAED;;OAEG;IACH,UAAiB,UAAU;QACzB;;WAEG;QACH,OAAO,EAAE,OAAO,CAAC;QAEjB;;WAEG;QACH,OAAO,EAAE,OAAO,CAAC;QAEjB;;WAEG;QACH,IAAI,EAAE,MAAM,CAAC;QAEb;;WAEG;QACH,KAAK,EAAE,MAAM,CAAC;QAEd;;WAEG;QACH,QAAQ,EAAE,MAAM,CAAC;QAEjB;;WAEG;QACH,KAAK,EAAE,MAAM,CAAC;KACf;CACF;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB,SAAS,EAAE,MAAM,CAAC;IAElB,IAAI,EAAE,MAAM,CAAC;IAEb,QAAQ,EAAE,MAAM,CAAC;IAEjB,IAAI,EAAE,MAAM,CAAC;IAEb;;;;;;OAMG;IACH,MAAM,EAAE,iBAAiB,GAAG,cAAc,GAAG,QAAQ,GAAG,YAAY,GAAG,OAAO,GAAG,OAAO,CAAC;IAEzF,IAAI,EAAE,uBAAuB,GAAG,aAAa,GAAG,QAAQ,CAAC;IAEzD,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,KAAK,EAAE,KAAK,CAAC,4BAA4B,CAAC,IAAI,CAAC,CAAC;IAEhD;;OAEG;IACH,UAAU,EAAE,4BAA4B,CAAC,UAAU,CAAC;CACrD;AAED,yBAAiB,4BAA4B,CAAC;IAC5C;;;OAGG;IACH,UAAiB,IAAI;QACnB;;WAEG;QACH,OAAO,EAAE,MAAM,CAAC;QAEhB;;WAEG;QACH,QAAQ,EAAE,MAAM,CAAC;QAEjB;;WAEG;QACH,OAAO,EAAE,MAAM,CAAC;QAEhB;;WAEG;QACH,OAAO,EAAE,MAAM,CAAC;QAEhB;;WAEG;QACH,OAAO,EAAE,MAAM,CAAC;QAEhB;;WAEG;QACH,UAAU,EAAE,MAAM,CAAC;QAEnB;;WAEG;QACH,OAAO,EAAE,MAAM,CAAC;QAEhB;;WAEG;QACH,QAAQ,EAAE,KAAK,GAAG,KAAK,GAAG,SAAS,CAAC;QAEpC;;WAEG;QACH,QAAQ,EAAE,MAAM,CAAC;QAEjB;;;WAGG;QACH,OAAO,EAAE,MAAM,CAAC;QAEhB;;WAEG;QACH,SAAS,EAAE,MAAM,CAAC;QAElB;;WAEG;QACH,KAAK,EAAE,MAAM,CAAC;QAEd;;WAEG;QACH,SAAS,EAAE,MAAM,CAAC;QAElB;;;WAGG;QACH,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;QAE5B;;WAEG;QACH,UAAU,EAAE,MAAM,CAAC;QAEnB;;WAEG;QACH,MAAM,EAAE,MAAM,CAAC;QAEf;;WAEG;QACH,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC7B;IAED;;OAEG;IACH,UAAiB,UAAU;QACzB;;WAEG;QACH,OAAO,EAAE,OAAO,CAAC;QAEjB;;WAEG;QACH,OAAO,EAAE,OAAO,CAAC;QAEjB;;WAEG;QACH,IAAI,EAAE,MAAM,CAAC;QAEb;;WAEG;QACH,KAAK,EAAE,MAAM,CAAC;QAEd;;WAEG;QACH,QAAQ,EAAE,MAAM,CAAC;QAEjB;;WAEG;QACH,KAAK,EAAE,MAAM,CAAC;KACf;CACF;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,OAAO,EAAE,iBAAiB,CAAC,OAAO,GAAG,IAAI,CAAC;IAE1C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,yBAAiB,iBAAiB,CAAC;IACjC;;OAEG;IACH,UAAiB,OAAO;QACtB;;WAEG;QACH,KAAK,EAAE,MAAM,CAAC;QAEd;;WAEG;QACH,QAAQ,EAAE,MAAM,CAAC;QAEjB;;WAEG;QACH,KAAK,EAAE,MAAM,CAAC;QAEd;;WAEG;QACH,UAAU,EAAE,MAAM,CAAC;QAEnB;;WAEG;QACH,KAAK,EAAE,MAAM,CAAC;QAEd;;;WAGG;QACH,UAAU,EAAE,MAAM,CAAC;QAEnB;;WAEG;QACH,OAAO,EAAE,MAAM,CAAC;QAEhB;;WAEG;QACH,MAAM,EAAE,MAAM,CAAC;KAChB;CACF;AAED,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB,IAAI,EAAE,uBAAuB,GAAG,aAAa,GAAG,QAAQ,CAAC;CAC1D;AAED,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAEvB;;OAEG;IACH,OAAO,CAAC,EAAE,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,YAAY,GAAG,YAAY,CAAC;IAEzF;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,QAAQ,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,SAAS,CAAC;IAErC;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAE7B;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,CAAC,OAAO,WAAW,OAAO,CAAC;IAC/B,OAAO,EACL,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,gBAAgB,IAAI,gBAAgB,EACzC,KAAK,4BAA4B,IAAI,4BAA4B,EACjE,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,eAAe,IAAI,eAAe,EACvC,KAAK,cAAc,IAAI,cAAc,EACrC,KAAK,0BAA0B,IAAI,0BAA0B,GAC9D,CAAC;CACH"}
+{"version":3,"file":"proxies.d.ts","sourceRoot":"","sources":["../../src/resources/connect/proxies.ts"],"names":[],"mappings":"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"}

package/resources/connect/proxies.js

@@ -13,6 +13,12 @@ class Proxies extends resource_1.APIResource {
     retrieve(id, options) {
         return this._client.get((0, path_1.path) `/connect/proxies/${id}`, options);
     }
+    /**
+     * Renames the proxy identified by the path ID.
+     */
+    update(id, body, options) {
+        return this._client.patch((0, path_1.path) `/connect/proxies/${id}`, { body, ...options });
+    }
     /**
      * Returns proxies owned by the calling tenant (the X-Owner-Id header, falling back
      * to X-User-ID). Credentials are omitted from the list.
@@ -36,6 +42,19 @@ class Proxies extends resource_1.APIResource {
             headers: (0, headers_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),
         });
     }
+    /**
+     * Checks right now that the proxy's upstream accepts a connection through its
+     * current session. If the upstream refuses the session and the proxy is a rotating
+     * (sticky-session) proxy, the proxy is moved onto a fresh session that has been
+     * checked to work; its credentials and country stay the same, its exit IP changes.
+     * Intended for callers that are about to depend on the proxy (e.g. while
+     * provisioning a phone). After `rotated`, the gateway uses the new session within
+     * about 30 seconds. A `refused` or `unreachable` result is not an error: the
+     * response describes the proxy's state.
+     */
+    ensureHealthy(id, options) {
+        return this._client.post((0, path_1.path) `/connect/proxies/${id}/ensure-healthy`, options);
+    }
     /**
      * Returns the connection history recorded for this proxy, one item per connection
      * (aggregated across the connection's lifetime). Supports filtering on every

package/resources/connect/proxies.js.map

@@ -1 +1 @@
-{"version":3,"file":"proxies.js","sourceRoot":"","sources":["../../src/resources/connect/proxies.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,qDAAkD;AAElD,uDAAsD;AAEtD,uDAAiD;AAEjD,MAAa,OAAQ,SAAQ,sBAAW;IACtC;;;OAGG;IACH,QAAQ,CAAC,EAAU,EAAE,OAAwB;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,oBAAoB,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IACjE,CAAC;IAED;;;OAGG;IACH,IAAI,CACF,QAA4C,EAAE,EAC9C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACrE,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,IAAoB,EAAE,OAAwB;QAChD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACrE,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,EAAU,EAAE,OAAwB;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,oBAAoB,EAAE,EAAE,EAAE;YACvD,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,eAAe,CACb,EAAU,EACV,QAAuD,EAAE,EACzD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,oBAAoB,EAAE,cAAc,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC3F,CAAC;IAED;;;;;OAKG;IACH,IAAI,CAAC,EAAU,EAAE,OAAwB;QACvC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,oBAAoB,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACtE,CAAC;CACF;AA7DD,0BA6DC"}
+{"version":3,"file":"proxies.js","sourceRoot":"","sources":["../../src/resources/connect/proxies.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,qDAAkD;AAElD,uDAAsD;AAEtD,uDAAiD;AAEjD,MAAa,OAAQ,SAAQ,sBAAW;IACtC;;;OAGG;IACH,QAAQ,CAAC,EAAU,EAAE,OAAwB;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,oBAAoB,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IACjE,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,EAAU,EAAE,IAAuB,EAAE,OAAwB;QAClE,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAA,WAAI,EAAA,oBAAoB,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAChF,CAAC;IAED;;;OAGG;IACH,IAAI,CACF,QAA4C,EAAE,EAC9C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACrE,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,IAAoB,EAAE,OAAwB;QAChD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACrE,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,EAAU,EAAE,OAAwB;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,oBAAoB,EAAE,EAAE,EAAE;YACvD,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;OASG;IACH,aAAa,CAAC,EAAU,EAAE,OAAwB;QAChD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,oBAAoB,EAAE,iBAAiB,EAAE,OAAO,CAAC,CAAC;IACjF,CAAC;IAED;;;;;OAKG;IACH,eAAe,CACb,EAAU,EACV,QAAuD,EAAE,EACzD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,oBAAoB,EAAE,cAAc,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC3F,CAAC;IAED;;;;;OAKG;IACH,IAAI,CAAC,EAAU,EAAE,OAAwB;QACvC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,oBAAoB,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACtE,CAAC;CACF;AAlFD,0BAkFC"}

package/resources/connect/proxies.mjs

@@ -10,6 +10,12 @@ export class Proxies extends APIResource {
     retrieve(id, options) {
         return this._client.get(path `/connect/proxies/${id}`, options);
     }
+    /**
+     * Renames the proxy identified by the path ID.
+     */
+    update(id, body, options) {
+        return this._client.patch(path `/connect/proxies/${id}`, { body, ...options });
+    }
     /**
      * Returns proxies owned by the calling tenant (the X-Owner-Id header, falling back
      * to X-User-ID). Credentials are omitted from the list.
@@ -33,6 +39,19 @@ export class Proxies extends APIResource {
             headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
         });
     }
+    /**
+     * Checks right now that the proxy's upstream accepts a connection through its
+     * current session. If the upstream refuses the session and the proxy is a rotating
+     * (sticky-session) proxy, the proxy is moved onto a fresh session that has been
+     * checked to work; its credentials and country stay the same, its exit IP changes.
+     * Intended for callers that are about to depend on the proxy (e.g. while
+     * provisioning a phone). After `rotated`, the gateway uses the new session within
+     * about 30 seconds. A `refused` or `unreachable` result is not an error: the
+     * response describes the proxy's state.
+     */
+    ensureHealthy(id, options) {
+        return this._client.post(path `/connect/proxies/${id}/ensure-healthy`, options);
+    }
     /**
      * Returns the connection history recorded for this proxy, one item per connection
      * (aggregated across the connection's lifetime). Supports filtering on every

package/resources/connect/proxies.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"proxies.mjs","sourceRoot":"","sources":["../../src/resources/connect/proxies.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAElD,OAAO,EAAE,YAAY,EAAE,mCAA+B;AAEtD,OAAO,EAAE,IAAI,EAAE,sCAAkC;AAEjD,MAAM,OAAO,OAAQ,SAAQ,WAAW;IACtC;;;OAGG;IACH,QAAQ,CAAC,EAAU,EAAE,OAAwB;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,oBAAoB,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IACjE,CAAC;IAED;;;OAGG;IACH,IAAI,CACF,QAA4C,EAAE,EAC9C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACrE,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,IAAoB,EAAE,OAAwB;QAChD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACrE,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,EAAU,EAAE,OAAwB;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,oBAAoB,EAAE,EAAE,EAAE;YACvD,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,eAAe,CACb,EAAU,EACV,QAAuD,EAAE,EACzD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,oBAAoB,EAAE,cAAc,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC3F,CAAC;IAED;;;;;OAKG;IACH,IAAI,CAAC,EAAU,EAAE,OAAwB;QACvC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,oBAAoB,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACtE,CAAC;CACF"}
+{"version":3,"file":"proxies.mjs","sourceRoot":"","sources":["../../src/resources/connect/proxies.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAElD,OAAO,EAAE,YAAY,EAAE,mCAA+B;AAEtD,OAAO,EAAE,IAAI,EAAE,sCAAkC;AAEjD,MAAM,OAAO,OAAQ,SAAQ,WAAW;IACtC;;;OAGG;IACH,QAAQ,CAAC,EAAU,EAAE,OAAwB;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,oBAAoB,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IACjE,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,EAAU,EAAE,IAAuB,EAAE,OAAwB;QAClE,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAA,oBAAoB,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAChF,CAAC;IAED;;;OAGG;IACH,IAAI,CACF,QAA4C,EAAE,EAC9C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACrE,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,IAAoB,EAAE,OAAwB;QAChD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACrE,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,EAAU,EAAE,OAAwB;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,oBAAoB,EAAE,EAAE,EAAE;YACvD,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;OASG;IACH,aAAa,CAAC,EAAU,EAAE,OAAwB;QAChD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,oBAAoB,EAAE,iBAAiB,EAAE,OAAO,CAAC,CAAC;IACjF,CAAC;IAED;;;;;OAKG;IACH,eAAe,CACb,EAAU,EACV,QAAuD,EAAE,EACzD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,oBAAoB,EAAE,cAAc,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC3F,CAAC;IAED;;;;;OAKG;IACH,IAAI,CAAC,EAAU,EAAE,OAAwB;QACvC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,oBAAoB,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACtE,CAAC;CACF"}

package/resources/devices/apps.d.mts

@@ -20,23 +20,24 @@ export declare class Apps extends APIResource {
     grantPermission(permission: 'POST_NOTIFICATIONS', params: AppGrantPermissionParams, options?: RequestOptions): APIPromise<void>;
     /**
      * 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.
-     * background (default false) selects the response contract: false installs inline
-     * and returns the outcome directly (200 on success, an error status on failure);
-     * true accepts the request and runs the download + install in the background,
-     * returning 202 immediately — poll list-app-installs for the backend's view of
-     * that attempt's status. Refuses with 409 once 2 other installs are already
-     * running on the device, in either mode; a repeat request for an app that already
-     * has an install running is also refused with 409 rather than superseding it —
-     * retry once that attempt reaches a terminal state.
+     * of an Android packageName or an iOS bundleId; optional country and versionCode
+     * select an exact regional uploaded Android version, and protected packages are
+     * rejected. background (default false) selects the response contract: false
+     * installs inline and returns the outcome directly (200 on success, an error
+     * status on failure); true accepts the request and runs the download + install in
+     * the background, returning 202 immediately — poll list-app-installs for the
+     * backend's view of that attempt's status. Refuses with 409 once 2 other installs
+     * are already running on the device, in either mode; a repeat request for an app
+     * that already has an install running is also refused with 409 rather than
+     * superseding it — retry once that attempt reaches a terminal state.
      */
     install(deviceID: string, params: AppInstallParams, options?: RequestOptions): APIPromise<void>;
     /**
-     * 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.
+     * Reports the backend's durable 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. Terminal and projected
+     * timeout 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>;
     /**
@@ -92,10 +93,9 @@ export declare namespace AppListInstallsResponse {
         status: 'running' | 'succeeded' | 'failed';
         updatedAt: string;
         /**
-         * Closed set: download_failed, adb_install_failed, panic, timeout, failed. Only
-         * present when status is failed.
+         * Only present when status is failed.
          */
-        errorClass?: string;
+        errorClass?: 'download_failed' | 'adb_install_failed' | 'panic' | 'timeout' | 'failed';
     }
 }
 export interface AppListParams {
@@ -149,10 +149,20 @@ export declare namespace AppInstallParams {
          * directly (200 on success, an error status on failure).
          */
         background?: boolean;
+        /**
+         * Body param: Optional ISO 3166-1 alpha-2 country of the uploaded app version
+         * (e.g. MY or SG).
+         */
+        country?: string;
         /**
          * Body param: Android package name (e.g. com.example.app)
          */
         packageName?: string;
+        /**
+         * Body param: Optional exact app-library version code. Use with country when
+         * multiple regional versions share an identifier.
+         */
+        versionCode?: number;
         /**
          * Header param
          */
@@ -173,6 +183,16 @@ export declare namespace AppInstallParams {
          * Body param: iOS bundle identifier (e.g. com.example.app)
          */
         bundleId?: string;
+        /**
+         * Body param: Optional ISO 3166-1 alpha-2 country of the uploaded app version
+         * (e.g. MY or SG).
+         */
+        country?: string;
+        /**
+         * Body param: Optional exact app-library version code. Use with country when
+         * multiple regional versions share an identifier.
+         */
+        versionCode?: number;
         /**
          * Header param
          */

package/resources/devices/apps.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"apps.d.mts","sourceRoot":"","sources":["../../src/resources/devices/apps.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"apps.d.mts","sourceRoot":"","sources":["../../src/resources/devices/apps.ts"],"names":[],"mappings":"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"}

package/resources/devices/apps.d.ts

@@ -20,23 +20,24 @@ export declare class Apps extends APIResource {
     grantPermission(permission: 'POST_NOTIFICATIONS', params: AppGrantPermissionParams, options?: RequestOptions): APIPromise<void>;
     /**
      * 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.
-     * background (default false) selects the response contract: false installs inline
-     * and returns the outcome directly (200 on success, an error status on failure);
-     * true accepts the request and runs the download + install in the background,
-     * returning 202 immediately — poll list-app-installs for the backend's view of
-     * that attempt's status. Refuses with 409 once 2 other installs are already
-     * running on the device, in either mode; a repeat request for an app that already
-     * has an install running is also refused with 409 rather than superseding it —
-     * retry once that attempt reaches a terminal state.
+     * of an Android packageName or an iOS bundleId; optional country and versionCode
+     * select an exact regional uploaded Android version, and protected packages are
+     * rejected. background (default false) selects the response contract: false
+     * installs inline and returns the outcome directly (200 on success, an error
+     * status on failure); true accepts the request and runs the download + install in
+     * the background, returning 202 immediately — poll list-app-installs for the
+     * backend's view of that attempt's status. Refuses with 409 once 2 other installs
+     * are already running on the device, in either mode; a repeat request for an app
+     * that already has an install running is also refused with 409 rather than
+     * superseding it — retry once that attempt reaches a terminal state.
      */
     install(deviceID: string, params: AppInstallParams, options?: RequestOptions): APIPromise<void>;
     /**
-     * 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.
+     * Reports the backend's durable 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. Terminal and projected
+     * timeout 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>;
     /**
@@ -92,10 +93,9 @@ export declare namespace AppListInstallsResponse {
         status: 'running' | 'succeeded' | 'failed';
         updatedAt: string;
         /**
-         * Closed set: download_failed, adb_install_failed, panic, timeout, failed. Only
-         * present when status is failed.
+         * Only present when status is failed.
          */
-        errorClass?: string;
+        errorClass?: 'download_failed' | 'adb_install_failed' | 'panic' | 'timeout' | 'failed';
     }
 }
 export interface AppListParams {
@@ -149,10 +149,20 @@ export declare namespace AppInstallParams {
          * directly (200 on success, an error status on failure).
          */
         background?: boolean;
+        /**
+         * Body param: Optional ISO 3166-1 alpha-2 country of the uploaded app version
+         * (e.g. MY or SG).
+         */
+        country?: string;
         /**
          * Body param: Android package name (e.g. com.example.app)
          */
         packageName?: string;
+        /**
+         * Body param: Optional exact app-library version code. Use with country when
+         * multiple regional versions share an identifier.
+         */
+        versionCode?: number;
         /**
          * Header param
          */
@@ -173,6 +183,16 @@ export declare namespace AppInstallParams {
          * Body param: iOS bundle identifier (e.g. com.example.app)
          */
         bundleId?: string;
+        /**
+         * Body param: Optional ISO 3166-1 alpha-2 country of the uploaded app version
+         * (e.g. MY or SG).
+         */
+        country?: string;
+        /**
+         * Body param: Optional exact app-library version code. Use with country when
+         * multiple regional versions share an identifier.
+         */
+        versionCode?: number;
         /**
          * Header param
          */

package/resources/devices/apps.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"apps.d.ts","sourceRoot":"","sources":["../../src/resources/devices/apps.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"apps.d.ts","sourceRoot":"","sources":["../../src/resources/devices/apps.ts"],"names":[],"mappings":"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"}

package/resources/devices/apps.js

@@ -67,15 +67,16 @@ class Apps extends resource_1.APIResource {
     }
     /**
      * 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.
-     * background (default false) selects the response contract: false installs inline
-     * and returns the outcome directly (200 on success, an error status on failure);
-     * true accepts the request and runs the download + install in the background,
-     * returning 202 immediately — poll list-app-installs for the backend's view of
-     * that attempt's status. Refuses with 409 once 2 other installs are already
-     * running on the device, in either mode; a repeat request for an app that already
-     * has an install running is also refused with 409 rather than superseding it —
-     * retry once that attempt reaches a terminal state.
+     * of an Android packageName or an iOS bundleId; optional country and versionCode
+     * select an exact regional uploaded Android version, and protected packages are
+     * rejected. background (default false) selects the response contract: false
+     * installs inline and returns the outcome directly (200 on success, an error
+     * status on failure); true accepts the request and runs the download + install in
+     * the background, returning 202 immediately — poll list-app-installs for the
+     * backend's view of that attempt's status. Refuses with 409 once 2 other installs
+     * are already running on the device, in either mode; a repeat request for an app
+     * that already has an install running is also refused with 409 rather than
+     * superseding it — retry once that attempt reaches a terminal state.
      */
     install(deviceID, params, options) {
         const { 'X-Device-Display-ID': xDeviceDisplayID, ...body } = params;
@@ -94,11 +95,11 @@ class Apps extends resource_1.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.
+     * Reports the backend's durable 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. Terminal and projected
+     * timeout records are kept ~15 minutes. Not gated on device readiness, so it also
+     * answers while the device is offline or crashed.
      */
     listInstalls(deviceID, params = {}, options) {
         const { 'X-Device-Display-ID': xDeviceDisplayID } = params ?? {};