@lusor/sdk 0.0.0-stage → 1.0.0

package/dist/api/resources/appInstalls/client/Client.js

@@ -0,0 +1,591 @@
+// This file was auto-generated by Fern from our API Definition.
+import { normalizeClientOptionsWithAuth } from "../../../../BaseClient.js";
+import * as core from "../../../../core/index.js";
+import { mergeHeaders, mergeOnlyDefinedHeaders } from "../../../../core/headers.js";
+import { mergeAdditionalBodyParameters } from "../../../../core/requestBody.js";
+import * as environments from "../../../../environments.js";
+import { handleNonStatusCodeError } from "../../../../errors/handleNonStatusCodeError.js";
+import * as errors from "../../../../errors/index.js";
+import * as Lusor from "../../../index.js";
+/**
+ * Install catalog apps on a phone, follow the installs, and uninstall
+ * them. Viewers cannot install.
+ */
+export class AppInstallsClient {
+    _options;
+    constructor(options = {}) {
+        this._options = normalizeClientOptionsWithAuth(options);
+    }
+    /**
+     * @param {Lusor.ListAppInstallsRequest} request
+     * @param {AppInstallsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Lusor.BadRequestError}
+     * @throws {@link Lusor.UnauthorizedError}
+     * @throws {@link Lusor.NotFoundError}
+     * @throws {@link errors.LusorError}
+     * @throws {@link errors.LusorTimeoutError}
+     *
+     * @example
+     *     await client.appInstalls.list({
+     *         workspaceId: "workspaceId",
+     *         deviceId: "deviceId"
+     *     })
+     */
+    list(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__list(request, requestOptions));
+    }
+    async __list(request, requestOptions) {
+        const { workspaceId, deviceId, requestKey } = request;
+        const _queryParams = {
+            requestKey,
+        };
+        const _authRequest = await this._options.authProvider.getAuthRequest();
+        let _headers = mergeHeaders(_authRequest.headers, this._options?.headers, requestOptions?.headers);
+        const _response = await core.fetcher({
+            url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??
+                (await core.Supplier.get(this._options.environment)) ??
+                environments.LusorEnvironment.Production, `v1/workspaces/${core.url.encodePathParam(workspaceId)}/devices/${core.url.encodePathParam(deviceId)}/installs`),
+            method: "GET",
+            headers: _headers,
+            queryString: core.url
+                .queryBuilder()
+                .addMany(_queryParams)
+                .mergeAdditional(requestOptions?.queryParams)
+                .build(),
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return { data: _response.body, rawResponse: _response.rawResponse };
+        }
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 400:
+                    throw new Lusor.BadRequestError(_response.error.body, _response.rawResponse);
+                case 401:
+                    throw new Lusor.UnauthorizedError(_response.error.body, _response.rawResponse);
+                case 404:
+                    throw new Lusor.NotFoundError(_response.error.body, _response.rawResponse);
+                default:
+                    throw new errors.LusorError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+        return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/v1/workspaces/{workspaceId}/devices/{deviceId}/installs");
+    }
+    /**
+     * Starts installing one catalog app on a Lusor cloud Android phone.
+     * Follow it with `GET …/installs` (or the `…/installs/events`
+     * stream). `422` when the phone cannot take catalog installs
+     * (`unsupported_platform`, `unsupported_tier`, `unsupported_daemon`);
+     * `409` when the install conflicts with the phone's state; `503
+     * install_outcome_unknown` means it may have started: list the
+     * installs before retrying with a new key.
+     *
+     * **Retries:** safe: the required UUID `Idempotency-Key` returns the same install on a repeat.
+     *
+     * @param {Lusor.CreateAppInstallsRequest} request
+     * @param {AppInstallsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Lusor.BadRequestError}
+     * @throws {@link Lusor.UnauthorizedError}
+     * @throws {@link Lusor.ForbiddenError}
+     * @throws {@link Lusor.NotFoundError}
+     * @throws {@link Lusor.ConflictError}
+     * @throws {@link Lusor.UnprocessableEntityError}
+     * @throws {@link Lusor.ServiceUnavailableError}
+     * @throws {@link errors.LusorError}
+     * @throws {@link errors.LusorTimeoutError}
+     *
+     * @example
+     *     await client.appInstalls.create({
+     *         "Idempotency-Key": "Idempotency-Key",
+     *         workspaceId: "workspaceId",
+     *         deviceId: "deviceId",
+     *         "package": "package"
+     *     })
+     */
+    create(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__create(request, requestOptions));
+    }
+    async __create(request, requestOptions) {
+        const { workspaceId, deviceId, "Idempotency-Key": idempotencyKey, ..._body } = request;
+        const _authRequest = await this._options.authProvider.getAuthRequest();
+        let _headers = mergeHeaders(_authRequest.headers, this._options?.headers, mergeOnlyDefinedHeaders({ "Idempotency-Key": idempotencyKey }), requestOptions?.headers);
+        const _response = await core.fetcher({
+            url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??
+                (await core.Supplier.get(this._options.environment)) ??
+                environments.LusorEnvironment.Production, `v1/workspaces/${core.url.encodePathParam(workspaceId)}/devices/${core.url.encodePathParam(deviceId)}/installs`),
+            method: "POST",
+            headers: _headers,
+            contentType: "application/json",
+            queryString: core.url.queryBuilder().mergeAdditional(requestOptions?.queryParams).build(),
+            requestType: "json",
+            body: mergeAdditionalBodyParameters(_body, requestOptions?.additionalBodyParameters),
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: 0,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return { data: _response.body, rawResponse: _response.rawResponse };
+        }
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 400:
+                    throw new Lusor.BadRequestError(_response.error.body, _response.rawResponse);
+                case 401:
+                    throw new Lusor.UnauthorizedError(_response.error.body, _response.rawResponse);
+                case 403:
+                    throw new Lusor.ForbiddenError(_response.error.body, _response.rawResponse);
+                case 404:
+                    throw new Lusor.NotFoundError(_response.error.body, _response.rawResponse);
+                case 409:
+                    throw new Lusor.ConflictError(_response.error.body, _response.rawResponse);
+                case 422:
+                    throw new Lusor.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                case 503:
+                    throw new Lusor.ServiceUnavailableError(_response.error.body, _response.rawResponse);
+                default:
+                    throw new errors.LusorError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+        return handleNonStatusCodeError(_response.error, _response.rawResponse, "POST", "/v1/workspaces/{workspaceId}/devices/{deviceId}/installs");
+    }
+    /**
+     * A Server-Sent Events stream that says when to re-read
+     * `GET …/installs`. Each event's `data` is a JSON object
+     * (`AppInstallEvent`): `ready` (`{}`) once listening, then `change`
+     * (`{}`) whenever an install on the phone changes, or `error`
+     * (`{"error":"realtime_unavailable"}`), which ends the stream. The
+     * stream closes after at most 60 seconds; reconnect and re-read.
+     */
+    events(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__events(request, requestOptions));
+    }
+    async __events(request, requestOptions) {
+        const { workspaceId, deviceId } = request;
+        const _authRequest = await this._options.authProvider.getAuthRequest();
+        let _headers = mergeHeaders(_authRequest.headers, this._options?.headers, requestOptions?.headers);
+        const _response = await core.fetcher({
+            url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??
+                (await core.Supplier.get(this._options.environment)) ??
+                environments.LusorEnvironment.Production, `v1/workspaces/${core.url.encodePathParam(workspaceId)}/devices/${core.url.encodePathParam(deviceId)}/installs/events`),
+            method: "GET",
+            headers: _headers,
+            queryString: core.url.queryBuilder().mergeAdditional(requestOptions?.queryParams).build(),
+            responseType: "sse",
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return {
+                data: new core.Stream({
+                    stream: _response.body,
+                    parse: (data) => data,
+                    signal: requestOptions?.abortSignal,
+                    eventShape: {
+                        type: "sse",
+                    },
+                }),
+                rawResponse: _response.rawResponse,
+            };
+        }
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 401:
+                    throw new Lusor.UnauthorizedError(_response.error.body, _response.rawResponse);
+                case 404:
+                    throw new Lusor.NotFoundError(_response.error.body, _response.rawResponse);
+                case 503:
+                    throw new Lusor.ServiceUnavailableError(_response.error.body, _response.rawResponse);
+                default:
+                    throw new errors.LusorError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+        return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/v1/workspaces/{workspaceId}/devices/{deviceId}/installs/events");
+    }
+    /**
+     * Removes one installed catalog app. Reinstall it with
+     * `POST …/installs` and a new key. `503 uninstall_outcome_unknown`
+     * means it may have run: list the installs before retrying.
+     *
+     * **Retries:** a repeat after success answers `409`; list the installs to read the state.
+     *
+     * @param {Lusor.UninstallAppInstallsRequest} request
+     * @param {AppInstallsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Lusor.BadRequestError}
+     * @throws {@link Lusor.UnauthorizedError}
+     * @throws {@link Lusor.ForbiddenError}
+     * @throws {@link Lusor.NotFoundError}
+     * @throws {@link Lusor.ConflictError}
+     * @throws {@link Lusor.UnprocessableEntityError}
+     * @throws {@link Lusor.ServiceUnavailableError}
+     * @throws {@link errors.LusorError}
+     * @throws {@link errors.LusorTimeoutError}
+     *
+     * @example
+     *     await client.appInstalls.uninstall({
+     *         workspaceId: "workspaceId",
+     *         deviceId: "deviceId",
+     *         installId: "installId"
+     *     })
+     */
+    uninstall(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__uninstall(request, requestOptions));
+    }
+    async __uninstall(request, requestOptions) {
+        const { workspaceId, deviceId, installId } = request;
+        const _authRequest = await this._options.authProvider.getAuthRequest();
+        let _headers = mergeHeaders(_authRequest.headers, this._options?.headers, requestOptions?.headers);
+        const _response = await core.fetcher({
+            url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??
+                (await core.Supplier.get(this._options.environment)) ??
+                environments.LusorEnvironment.Production, `v1/workspaces/${core.url.encodePathParam(workspaceId)}/devices/${core.url.encodePathParam(deviceId)}/installs/${core.url.encodePathParam(installId)}/uninstall`),
+            method: "POST",
+            headers: _headers,
+            queryString: core.url.queryBuilder().mergeAdditional(requestOptions?.queryParams).build(),
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: 0,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return { data: _response.body, rawResponse: _response.rawResponse };
+        }
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 400:
+                    throw new Lusor.BadRequestError(_response.error.body, _response.rawResponse);
+                case 401:
+                    throw new Lusor.UnauthorizedError(_response.error.body, _response.rawResponse);
+                case 403:
+                    throw new Lusor.ForbiddenError(_response.error.body, _response.rawResponse);
+                case 404:
+                    throw new Lusor.NotFoundError(_response.error.body, _response.rawResponse);
+                case 409:
+                    throw new Lusor.ConflictError(_response.error.body, _response.rawResponse);
+                case 422:
+                    throw new Lusor.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                case 503:
+                    throw new Lusor.ServiceUnavailableError(_response.error.body, _response.rawResponse);
+                default:
+                    throw new errors.LusorError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+        return handleNonStatusCodeError(_response.error, _response.rawResponse, "POST", "/v1/workspaces/{workspaceId}/devices/{deviceId}/installs/{installId}/uninstall");
+    }
+    /**
+     * Starts one install batch: up to 24 unique catalog packages,
+     * installed one at a time. A phone runs one batch at a time (`409
+     * batch_active`). Follow it with `GET …/install-batches/active`.
+     * `503 install_outcome_unknown` means it may have started: read the
+     * active batch before starting another.
+     *
+     * @param {Lusor.AppInstallBatchInput} request
+     * @param {AppInstallsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Lusor.BadRequestError}
+     * @throws {@link Lusor.UnauthorizedError}
+     * @throws {@link Lusor.ForbiddenError}
+     * @throws {@link Lusor.NotFoundError}
+     * @throws {@link Lusor.ConflictError}
+     * @throws {@link Lusor.UnprocessableEntityError}
+     * @throws {@link Lusor.ServiceUnavailableError}
+     * @throws {@link errors.LusorError}
+     * @throws {@link errors.LusorTimeoutError}
+     *
+     * @example
+     *     await client.appInstalls.createBatch({
+     *         workspaceId: "workspaceId",
+     *         deviceId: "deviceId",
+     *         packages: ["packages"]
+     *     })
+     */
+    createBatch(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__createBatch(request, requestOptions));
+    }
+    async __createBatch(request, requestOptions) {
+        const { workspaceId, deviceId, ..._body } = request;
+        const _authRequest = await this._options.authProvider.getAuthRequest();
+        let _headers = mergeHeaders(_authRequest.headers, this._options?.headers, requestOptions?.headers);
+        const _response = await core.fetcher({
+            url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??
+                (await core.Supplier.get(this._options.environment)) ??
+                environments.LusorEnvironment.Production, `v1/workspaces/${core.url.encodePathParam(workspaceId)}/devices/${core.url.encodePathParam(deviceId)}/install-batches`),
+            method: "POST",
+            headers: _headers,
+            contentType: "application/json",
+            queryString: core.url.queryBuilder().mergeAdditional(requestOptions?.queryParams).build(),
+            requestType: "json",
+            body: mergeAdditionalBodyParameters(_body, requestOptions?.additionalBodyParameters),
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: 0,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return { data: _response.body, rawResponse: _response.rawResponse };
+        }
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 400:
+                    throw new Lusor.BadRequestError(_response.error.body, _response.rawResponse);
+                case 401:
+                    throw new Lusor.UnauthorizedError(_response.error.body, _response.rawResponse);
+                case 403:
+                    throw new Lusor.ForbiddenError(_response.error.body, _response.rawResponse);
+                case 404:
+                    throw new Lusor.NotFoundError(_response.error.body, _response.rawResponse);
+                case 409:
+                    throw new Lusor.ConflictError(_response.error.body, _response.rawResponse);
+                case 422:
+                    throw new Lusor.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                case 503:
+                    throw new Lusor.ServiceUnavailableError(_response.error.body, _response.rawResponse);
+                default:
+                    throw new errors.LusorError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+        return handleNonStatusCodeError(_response.error, _response.rawResponse, "POST", "/v1/workspaces/{workspaceId}/devices/{deviceId}/install-batches");
+    }
+    /**
+     * The phone's install batch, with each item's live status. `404` when the phone has none.
+     *
+     * @param {Lusor.GetActiveBatchAppInstallsRequest} request
+     * @param {AppInstallsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Lusor.UnauthorizedError}
+     * @throws {@link Lusor.NotFoundError}
+     * @throws {@link Lusor.ServiceUnavailableError}
+     * @throws {@link errors.LusorError}
+     * @throws {@link errors.LusorTimeoutError}
+     *
+     * @example
+     *     await client.appInstalls.getActiveBatch({
+     *         workspaceId: "workspaceId",
+     *         deviceId: "deviceId"
+     *     })
+     */
+    getActiveBatch(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getActiveBatch(request, requestOptions));
+    }
+    async __getActiveBatch(request, requestOptions) {
+        const { workspaceId, deviceId } = request;
+        const _authRequest = await this._options.authProvider.getAuthRequest();
+        let _headers = mergeHeaders(_authRequest.headers, this._options?.headers, requestOptions?.headers);
+        const _response = await core.fetcher({
+            url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??
+                (await core.Supplier.get(this._options.environment)) ??
+                environments.LusorEnvironment.Production, `v1/workspaces/${core.url.encodePathParam(workspaceId)}/devices/${core.url.encodePathParam(deviceId)}/install-batches/active`),
+            method: "GET",
+            headers: _headers,
+            queryString: core.url.queryBuilder().mergeAdditional(requestOptions?.queryParams).build(),
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return { data: _response.body, rawResponse: _response.rawResponse };
+        }
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 401:
+                    throw new Lusor.UnauthorizedError(_response.error.body, _response.rawResponse);
+                case 404:
+                    throw new Lusor.NotFoundError(_response.error.body, _response.rawResponse);
+                case 503:
+                    throw new Lusor.ServiceUnavailableError(_response.error.body, _response.rawResponse);
+                default:
+                    throw new errors.LusorError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+        return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/v1/workspaces/{workspaceId}/devices/{deviceId}/install-batches/active");
+    }
+    /**
+     * Cancels the batch. Read `GET …/install-batches/active` for each
+     * item's final status. `503 install_outcome_unknown`: the outcome is
+     * unknown; read the active batch.
+     *
+     * @param {Lusor.CancelBatchAppInstallsRequest} request
+     * @param {AppInstallsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Lusor.BadRequestError}
+     * @throws {@link Lusor.UnauthorizedError}
+     * @throws {@link Lusor.ForbiddenError}
+     * @throws {@link Lusor.NotFoundError}
+     * @throws {@link Lusor.ServiceUnavailableError}
+     * @throws {@link errors.LusorError}
+     * @throws {@link errors.LusorTimeoutError}
+     *
+     * @example
+     *     await client.appInstalls.cancelBatch({
+     *         workspaceId: "workspaceId",
+     *         deviceId: "deviceId",
+     *         batchId: "batchId"
+     *     })
+     */
+    cancelBatch(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__cancelBatch(request, requestOptions));
+    }
+    async __cancelBatch(request, requestOptions) {
+        const { workspaceId, deviceId, batchId } = request;
+        const _authRequest = await this._options.authProvider.getAuthRequest();
+        let _headers = mergeHeaders(_authRequest.headers, this._options?.headers, requestOptions?.headers);
+        const _response = await core.fetcher({
+            url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??
+                (await core.Supplier.get(this._options.environment)) ??
+                environments.LusorEnvironment.Production, `v1/workspaces/${core.url.encodePathParam(workspaceId)}/devices/${core.url.encodePathParam(deviceId)}/install-batches/${core.url.encodePathParam(batchId)}/cancel`),
+            method: "POST",
+            headers: _headers,
+            queryString: core.url.queryBuilder().mergeAdditional(requestOptions?.queryParams).build(),
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: 0,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return { data: _response.body, rawResponse: _response.rawResponse };
+        }
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 400:
+                    throw new Lusor.BadRequestError(_response.error.body, _response.rawResponse);
+                case 401:
+                    throw new Lusor.UnauthorizedError(_response.error.body, _response.rawResponse);
+                case 403:
+                    throw new Lusor.ForbiddenError(_response.error.body, _response.rawResponse);
+                case 404:
+                    throw new Lusor.NotFoundError(_response.error.body, _response.rawResponse);
+                case 503:
+                    throw new Lusor.ServiceUnavailableError(_response.error.body, _response.rawResponse);
+                default:
+                    throw new errors.LusorError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+        return handleNonStatusCodeError(_response.error, _response.rawResponse, "POST", "/v1/workspaces/{workspaceId}/devices/{deviceId}/install-batches/{batchId}/cancel");
+    }
+    /**
+     * Starts an agent turn on the iPhone that installs the named catalog
+     * apps from the App Store. `agentId` picks the agent; without it, the
+     * agent that uses the iPhone runs it (the workspace's primary agent
+     * when none does). Follow it as any run, under
+     * `GET /v1/sessions/{id}` with the returned `sessionId`.
+     * `409`: `phone_busy`, `agent_choice_required`,
+     * `agent_not_on_phone` or `no_agent_on_phone`; `422
+     * unsupported_platform` for a phone that is not an iPhone.
+     *
+     * **Retries:** safe: the required UUID `Idempotency-Key` returns the same run on a repeat.
+     *
+     * @param {Lusor.AppStoreInstallInput} request
+     * @param {AppInstallsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Lusor.BadRequestError}
+     * @throws {@link Lusor.UnauthorizedError}
+     * @throws {@link Lusor.ForbiddenError}
+     * @throws {@link Lusor.NotFoundError}
+     * @throws {@link Lusor.ConflictError}
+     * @throws {@link Lusor.UnprocessableEntityError}
+     * @throws {@link errors.LusorError}
+     * @throws {@link errors.LusorTimeoutError}
+     *
+     * @example
+     *     await client.appInstalls.createFromAppStore({
+     *         "Idempotency-Key": "Idempotency-Key",
+     *         workspaceId: "workspaceId",
+     *         deviceId: "deviceId",
+     *         packages: ["packages"]
+     *     })
+     */
+    createFromAppStore(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__createFromAppStore(request, requestOptions));
+    }
+    async __createFromAppStore(request, requestOptions) {
+        const { workspaceId, deviceId, "Idempotency-Key": idempotencyKey, ..._body } = request;
+        const _authRequest = await this._options.authProvider.getAuthRequest();
+        let _headers = mergeHeaders(_authRequest.headers, this._options?.headers, mergeOnlyDefinedHeaders({ "Idempotency-Key": idempotencyKey }), requestOptions?.headers);
+        const _response = await core.fetcher({
+            url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??
+                (await core.Supplier.get(this._options.environment)) ??
+                environments.LusorEnvironment.Production, `v1/workspaces/${core.url.encodePathParam(workspaceId)}/devices/${core.url.encodePathParam(deviceId)}/app-store-installs`),
+            method: "POST",
+            headers: _headers,
+            contentType: "application/json",
+            queryString: core.url.queryBuilder().mergeAdditional(requestOptions?.queryParams).build(),
+            requestType: "json",
+            body: mergeAdditionalBodyParameters(_body, requestOptions?.additionalBodyParameters),
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: 0,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return { data: _response.body, rawResponse: _response.rawResponse };
+        }
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 400:
+                    throw new Lusor.BadRequestError(_response.error.body, _response.rawResponse);
+                case 401:
+                    throw new Lusor.UnauthorizedError(_response.error.body, _response.rawResponse);
+                case 403:
+                    throw new Lusor.ForbiddenError(_response.error.body, _response.rawResponse);
+                case 404:
+                    throw new Lusor.NotFoundError(_response.error.body, _response.rawResponse);
+                case 409:
+                    throw new Lusor.ConflictError(_response.error.body, _response.rawResponse);
+                case 422:
+                    throw new Lusor.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                default:
+                    throw new errors.LusorError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+        return handleNonStatusCodeError(_response.error, _response.rawResponse, "POST", "/v1/workspaces/{workspaceId}/devices/{deviceId}/app-store-installs");
+    }
+}

package/dist/api/resources/appInstalls/client/index.d.ts

@@ -0,0 +1 @@
+export * from "./requests/index.js";

package/dist/api/resources/appInstalls/client/index.js

@@ -0,0 +1 @@
+export * from "./requests/index.js";

package/dist/api/resources/appInstalls/client/requests/AppInstallBatchInput.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @example
+ *     {
+ *         workspaceId: "workspaceId",
+ *         deviceId: "deviceId",
+ *         packages: ["packages"]
+ *     }
+ */
+export interface AppInstallBatchInput {
+    /** Workspace UUID. Caller must have access. */
+    workspaceId: string;
+    /** Device id (paired into the workspace). */
+    deviceId: string;
+    /** Catalog package names, installed in this order. */
+    packages: string[];
+}

package/dist/api/resources/appInstalls/client/requests/AppInstallBatchInput.js

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/api/resources/appInstalls/client/requests/AppStoreInstallInput.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @example
+ *     {
+ *         "Idempotency-Key": "Idempotency-Key",
+ *         workspaceId: "workspaceId",
+ *         deviceId: "deviceId",
+ *         packages: ["packages"]
+ *     }
+ */
+export interface AppStoreInstallInput {
+    /** Workspace UUID. Caller must have access. */
+    workspaceId: string;
+    /** Device id (paired into the workspace). */
+    deviceId: string;
+    /** A UUID per install request; a repeat with the same key returns the same install instead of starting another. */
+    "Idempotency-Key": string;
+    /** Catalog package names to install from the App Store. */
+    packages: string[];
+    /** The agent that runs the install. */
+    agentId?: string;
+}

package/dist/api/resources/appInstalls/client/requests/AppStoreInstallInput.js

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/api/resources/appInstalls/client/requests/CancelBatchAppInstallsRequest.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @example
+ *     {
+ *         workspaceId: "workspaceId",
+ *         deviceId: "deviceId",
+ *         batchId: "batchId"
+ *     }
+ */
+export interface CancelBatchAppInstallsRequest {
+    /** Workspace UUID. Caller must have access. */
+    workspaceId: string;
+    /** Device id (paired into the workspace). */
+    deviceId: string;
+    batchId: string;
+}

package/dist/api/resources/appInstalls/client/requests/CancelBatchAppInstallsRequest.js

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};