@lusor/sdk 0.0.0-stage → 1.0.0

package/dist/api/resources/sessions/resources/liveView/client/Client.js

@@ -0,0 +1,616 @@
+// 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 } 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";
+export class LiveViewClient {
+    _options;
+    constructor(options = {}) {
+        this._options = normalizeClientOptionsWithAuth(options);
+    }
+    /**
+     * Asks the phone to start a WebRTC stream for this session. Open
+     * `GET /v1/sessions/{id}/stream/events` first to receive the phone's
+     * offer. TURN servers are added automatically unless you pass
+     * `iceServers`.
+     *
+     * API keys get live view only on the customer's own phone; on a Lusor
+     * Phone every `/stream/*` route returns `403
+     * live_view_not_available_for_api_keys`.
+     *
+     * **Retries:** safe without an `Idempotency-Key`: short-lived live-view connection control that changes nothing on the phone.
+     *
+     * @param {Lusor.sessions.StartLiveViewRequest} request
+     * @param {LiveViewClient.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.BadGatewayError}
+     * @throws {@link errors.LusorError}
+     * @throws {@link errors.LusorTimeoutError}
+     *
+     * @example
+     *     await client.sessions.liveView.start({
+     *         id: "id",
+     *         body: {}
+     *     })
+     */
+    start(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__start(request, requestOptions));
+    }
+    async __start(request, requestOptions) {
+        const { id, body: _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/sessions/${core.url.encodePathParam(id)}/stream/start`),
+            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 502:
+                    throw new Lusor.BadGatewayError(_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/sessions/{id}/stream/start");
+    }
+    /**
+     * Reconnects the WebRTC stream without starting over: the phone reuses
+     * its running screen capture when it can. Same body and response as
+     * `POST /v1/sessions/{id}/stream/start`.
+     *
+     * **Retries:** safe without an `Idempotency-Key`: short-lived live-view connection control that changes nothing on the phone.
+     *
+     * @param {Lusor.sessions.ConnectLiveViewRequest} request
+     * @param {LiveViewClient.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.BadGatewayError}
+     * @throws {@link errors.LusorError}
+     * @throws {@link errors.LusorTimeoutError}
+     *
+     * @example
+     *     await client.sessions.liveView.connect({
+     *         id: "id",
+     *         body: {}
+     *     })
+     */
+    connect(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__connect(request, requestOptions));
+    }
+    async __connect(request, requestOptions) {
+        const { id, body: _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/sessions/${core.url.encodePathParam(id)}/stream/connect`),
+            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 502:
+                    throw new Lusor.BadGatewayError(_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/sessions/{id}/stream/connect");
+    }
+    /**
+     * Sends one extra keep-alive to the phone. The server already sends
+     * one every 25 seconds while a stream is active, so this is optional.
+     *
+     * **Retries:** safe without an `Idempotency-Key`: short-lived live-view connection control that changes nothing on the phone.
+     *
+     * @param {Lusor.sessions.KeepaliveLiveViewRequest} request
+     * @param {LiveViewClient.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.BadGatewayError}
+     * @throws {@link errors.LusorError}
+     * @throws {@link errors.LusorTimeoutError}
+     *
+     * @example
+     *     await client.sessions.liveView.keepalive({
+     *         id: "id",
+     *         body: {}
+     *     })
+     */
+    keepalive(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__keepalive(request, requestOptions));
+    }
+    async __keepalive(request, requestOptions) {
+        const { id, body: _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/sessions/${core.url.encodePathParam(id)}/stream/keepalive`),
+            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 502:
+                    throw new Lusor.BadGatewayError(_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/sessions/{id}/stream/keepalive");
+    }
+    /**
+     * Makes the phone's encoder send a keyframe, which recovers a frozen
+     * picture without reconnecting.
+     *
+     * **Retries:** safe without an `Idempotency-Key`: short-lived live-view connection control that changes nothing on the phone.
+     *
+     * @param {Lusor.sessions.RequestFrameLiveViewRequest} request
+     * @param {LiveViewClient.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.BadGatewayError}
+     * @throws {@link errors.LusorError}
+     * @throws {@link errors.LusorTimeoutError}
+     *
+     * @example
+     *     await client.sessions.liveView.requestFrame({
+     *         id: "id",
+     *         body: {}
+     *     })
+     */
+    requestFrame(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__requestFrame(request, requestOptions));
+    }
+    async __requestFrame(request, requestOptions) {
+        const { id, body: _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/sessions/${core.url.encodePathParam(id)}/stream/request_frame`),
+            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 502:
+                    throw new Lusor.BadGatewayError(_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/sessions/{id}/stream/request_frame");
+    }
+    /**
+     * Relays the client's side of the WebRTC handshake to the phone.
+     * `message.type` must be `webrtc_answer` or `webrtc_ice`; the rest of
+     * `message` is passed to the phone unchanged.
+     *
+     * **Retries:** safe without an `Idempotency-Key`: short-lived live-view connection control that changes nothing on the phone.
+     *
+     * @param {Lusor.sessions.StreamSignalInput} request
+     * @param {LiveViewClient.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.BadGatewayError}
+     * @throws {@link errors.LusorError}
+     * @throws {@link errors.LusorTimeoutError}
+     *
+     * @example
+     *     await client.sessions.liveView.signal({
+     *         id: "id",
+     *         message: {
+     *             type: "webrtc_answer"
+     *         }
+     *     })
+     */
+    signal(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__signal(request, requestOptions));
+    }
+    async __signal(request, requestOptions) {
+        const { id, ..._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/sessions/${core.url.encodePathParam(id)}/stream/signal`),
+            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 502:
+                    throw new Lusor.BadGatewayError(_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/sessions/{id}/stream/signal");
+    }
+    /**
+     * **Retries:** safe without an `Idempotency-Key`: short-lived live-view connection control that changes nothing on the phone.
+     *
+     * @param {Lusor.sessions.StreamStopInput} request
+     * @param {LiveViewClient.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.BadGatewayError}
+     * @throws {@link errors.LusorError}
+     * @throws {@link errors.LusorTimeoutError}
+     *
+     * @example
+     *     await client.sessions.liveView.stop({
+     *         id: "id"
+     *     })
+     */
+    stop(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__stop(request, requestOptions));
+    }
+    async __stop(request, requestOptions) {
+        const { id, ..._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/sessions/${core.url.encodePathParam(id)}/stream/stop`),
+            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 502:
+                    throw new Lusor.BadGatewayError(_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/sessions/{id}/stream/stop");
+    }
+    /**
+     * The STUN/TURN configuration for the client's `RTCPeerConnection`.
+     * The phone gets the same TURN allocation, so pass these to the
+     * browser unchanged. `iceServers` is null when TURN is not available;
+     * fall back to STUN. Rotating the credential during a live view is
+     * not available through the API yet: after `expiresAt`, start a new
+     * live view.
+     *
+     * @param {Lusor.sessions.IceServersLiveViewRequest} request
+     * @param {LiveViewClient.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 errors.LusorError}
+     * @throws {@link errors.LusorTimeoutError}
+     *
+     * @example
+     *     await client.sessions.liveView.iceServers({
+     *         id: "id"
+     *     })
+     */
+    iceServers(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__iceServers(request, requestOptions));
+    }
+    async __iceServers(request, requestOptions) {
+        const { id, workspaceId } = request;
+        const _queryParams = {
+            workspaceId,
+        };
+        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/sessions/${core.url.encodePathParam(id)}/stream/ice-servers`),
+            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 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);
+                default:
+                    throw new errors.LusorError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+        return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/v1/sessions/{id}/stream/ice-servers");
+    }
+    /**
+     * A Server-Sent Events stream. Each event is named `signal` and its
+     * `data` is one JSON signaling message from the phone, identified by
+     * its `action` (for example `webrtc_offer`, `webrtc_ice`,
+     * `stream_ready`). A `keep-alive` comment arrives every 15 seconds.
+     * The stream stays open until the client disconnects.
+     */
+    events(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__events(request, requestOptions));
+    }
+    async __events(request, requestOptions) {
+        const { id, workspaceId } = request;
+        const _queryParams = {
+            workspaceId,
+        };
+        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/sessions/${core.url.encodePathParam(id)}/stream/events`),
+            method: "GET",
+            headers: _headers,
+            queryString: core.url
+                .queryBuilder()
+                .addMany(_queryParams)
+                .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 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 502:
+                    throw new Lusor.BadGatewayError(_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/sessions/{id}/stream/events");
+    }
+}

package/dist/api/resources/sessions/resources/liveView/client/index.d.ts

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

package/dist/api/resources/sessions/resources/liveView/client/index.js

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

package/dist/api/resources/sessions/resources/liveView/client/requests/ConnectLiveViewRequest.d.ts

@@ -0,0 +1,13 @@
+import * as Lusor from "../../../../../../index.js";
+/**
+ * @example
+ *     {
+ *         id: "id",
+ *         body: {}
+ *     }
+ */
+export interface ConnectLiveViewRequest {
+    /** Session ID. */
+    id: string;
+    body?: Lusor.StreamStartInput;
+}

package/dist/api/resources/sessions/resources/liveView/client/requests/ConnectLiveViewRequest.js

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

package/dist/api/resources/sessions/resources/liveView/client/requests/EventsLiveViewRequest.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @example
+ *     {
+ *         id: "id"
+ *     }
+ */
+export interface EventsLiveViewRequest {
+    /** Session ID. */
+    id: string;
+    /**
+     * Workspace the request is scoped to. Optional for API keys: a key is
+     * bound to one workspace when it is created, and naming any other
+     * workspace returns an opaque 404.
+     */
+    workspaceId?: string;
+}

package/dist/api/resources/sessions/resources/liveView/client/requests/EventsLiveViewRequest.js

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

package/dist/api/resources/sessions/resources/liveView/client/requests/IceServersLiveViewRequest.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @example
+ *     {
+ *         id: "id"
+ *     }
+ */
+export interface IceServersLiveViewRequest {
+    /** Session ID. */
+    id: string;
+    /**
+     * Workspace the request is scoped to. Optional for API keys: a key is
+     * bound to one workspace when it is created, and naming any other
+     * workspace returns an opaque 404.
+     */
+    workspaceId?: string;
+}