@ichos/sdk 1.0.2 → 1.0.4

package/src/api/resources/episodes/client/Client.ts

@@ -0,0 +1,1155 @@
+// This file was auto-generated by Fern from our API Definition.
+
+import type { BaseClientOptions, BaseRequestOptions } from "../../../../BaseClient.js";
+import { type NormalizedClientOptionsWithAuth, normalizeClientOptionsWithAuth } from "../../../../BaseClient.js";
+import { mergeHeaders, mergeOnlyDefinedHeaders } from "../../../../core/headers.js";
+import * as core from "../../../../core/index.js";
+import * as environments from "../../../../environments.js";
+import { handleNonStatusCodeError } from "../../../../errors/handleNonStatusCodeError.js";
+import * as errors from "../../../../errors/index.js";
+import * as Ichos from "../../../index.js";
+
+export declare namespace EpisodesClient {
+    export type Options = BaseClientOptions;
+
+    export interface RequestOptions extends BaseRequestOptions {}
+}
+
+export class EpisodesClient {
+    protected readonly _options: NormalizedClientOptionsWithAuth<EpisodesClient.Options>;
+
+    constructor(options: EpisodesClient.Options) {
+        this._options = normalizeClientOptionsWithAuth(options);
+    }
+
+    /**
+     * Retrieve all episodes for a specific podcast.
+     *
+     * @param {Ichos.ListPodcastEpisodesRequest} request
+     * @param {EpisodesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Ichos.UnauthorizedError}
+     * @throws {@link Ichos.ForbiddenError}
+     * @throws {@link Ichos.NotFoundError}
+     * @throws {@link Ichos.InternalServerError}
+     *
+     * @example
+     *     await client.episodes.listPodcastEpisodes({
+     *         podcast: "podcast"
+     *     })
+     */
+    public listPodcastEpisodes(
+        request: Ichos.ListPodcastEpisodesRequest,
+        requestOptions?: EpisodesClient.RequestOptions,
+    ): core.HttpResponsePromise<Ichos.EpisodesResponse> {
+        return core.HttpResponsePromise.fromPromise(this.__listPodcastEpisodes(request, requestOptions));
+    }
+
+    private async __listPodcastEpisodes(
+        request: Ichos.ListPodcastEpisodesRequest,
+        requestOptions?: EpisodesClient.RequestOptions,
+    ): Promise<core.WithRawResponse<Ichos.EpisodesResponse>> {
+        const { podcast } = request;
+        const _queryParams: Record<string, string | string[] | object | object[] | null> = {};
+        _queryParams.podcast = podcast;
+        const _authRequest: core.AuthRequest = await this._options.authProvider.getAuthRequest();
+        const _headers: core.Fetcher.Args["headers"] = mergeHeaders(
+            _authRequest.headers,
+            this._options?.headers,
+            mergeOnlyDefinedHeaders({ "x-virtual-user": requestOptions?.virtualUser ?? this._options?.virtualUser }),
+            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.IchosEnvironment.Default,
+                "v1/episodes",
+            ),
+            method: "GET",
+            headers: _headers,
+            queryParameters: { ..._queryParams, ...requestOptions?.queryParams },
+            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 as Ichos.EpisodesResponse, rawResponse: _response.rawResponse };
+        }
+
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 401:
+                    throw new Ichos.UnauthorizedError(
+                        _response.error.body as Ichos.UnauthorizedErrorResponse,
+                        _response.rawResponse,
+                    );
+                case 403:
+                    throw new Ichos.ForbiddenError(
+                        _response.error.body as Ichos.UnauthenticatedErrorResponse,
+                        _response.rawResponse,
+                    );
+                case 404:
+                    throw new Ichos.NotFoundError(
+                        _response.error.body as Ichos.NotFoundErrorResponse,
+                        _response.rawResponse,
+                    );
+                case 500:
+                    throw new Ichos.InternalServerError(
+                        _response.error.body as Ichos.InternalServerErrorResponse,
+                        _response.rawResponse,
+                    );
+                default:
+                    throw new errors.IchosError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+
+        return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/v1/episodes");
+    }
+
+    /**
+     * Create a new episode.
+     *
+     * @param {Ichos.EpisodeCreate} request
+     * @param {EpisodesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Ichos.UnauthorizedError}
+     * @throws {@link Ichos.ForbiddenError}
+     * @throws {@link Ichos.NotFoundError}
+     * @throws {@link Ichos.InternalServerError}
+     *
+     * @example
+     *     await client.episodes.createEpisode({
+     *         podcastId: "podcastId",
+     *         title: "title"
+     *     })
+     */
+    public createEpisode(
+        request: Ichos.EpisodeCreate,
+        requestOptions?: EpisodesClient.RequestOptions,
+    ): core.HttpResponsePromise<Ichos.EpisodeCreateResponse> {
+        return core.HttpResponsePromise.fromPromise(this.__createEpisode(request, requestOptions));
+    }
+
+    private async __createEpisode(
+        request: Ichos.EpisodeCreate,
+        requestOptions?: EpisodesClient.RequestOptions,
+    ): Promise<core.WithRawResponse<Ichos.EpisodeCreateResponse>> {
+        const _authRequest: core.AuthRequest = await this._options.authProvider.getAuthRequest();
+        const _headers: core.Fetcher.Args["headers"] = mergeHeaders(
+            _authRequest.headers,
+            this._options?.headers,
+            mergeOnlyDefinedHeaders({ "x-virtual-user": requestOptions?.virtualUser ?? this._options?.virtualUser }),
+            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.IchosEnvironment.Default,
+                "v1/episodes",
+            ),
+            method: "POST",
+            headers: _headers,
+            contentType: "application/json",
+            queryParameters: requestOptions?.queryParams,
+            requestType: "json",
+            body: request,
+            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 as Ichos.EpisodeCreateResponse, rawResponse: _response.rawResponse };
+        }
+
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 401:
+                    throw new Ichos.UnauthorizedError(
+                        _response.error.body as Ichos.UnauthorizedErrorResponse,
+                        _response.rawResponse,
+                    );
+                case 403:
+                    throw new Ichos.ForbiddenError(
+                        _response.error.body as Ichos.UnauthenticatedErrorResponse,
+                        _response.rawResponse,
+                    );
+                case 404:
+                    throw new Ichos.NotFoundError(
+                        _response.error.body as Ichos.NotFoundErrorResponse,
+                        _response.rawResponse,
+                    );
+                case 500:
+                    throw new Ichos.InternalServerError(
+                        _response.error.body as Ichos.InternalServerErrorResponse,
+                        _response.rawResponse,
+                    );
+                default:
+                    throw new errors.IchosError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+
+        return handleNonStatusCodeError(_response.error, _response.rawResponse, "POST", "/v1/episodes");
+    }
+
+    /**
+     * Retrieve a single episode by ID.
+     *
+     * @param {Ichos.GetEpisodeRequest} request
+     * @param {EpisodesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Ichos.UnauthorizedError}
+     * @throws {@link Ichos.ForbiddenError}
+     * @throws {@link Ichos.NotFoundError}
+     * @throws {@link Ichos.InternalServerError}
+     *
+     * @example
+     *     await client.episodes.getEpisode({
+     *         episodeId: "episodeId"
+     *     })
+     */
+    public getEpisode(
+        request: Ichos.GetEpisodeRequest,
+        requestOptions?: EpisodesClient.RequestOptions,
+    ): core.HttpResponsePromise<Ichos.EpisodeResponse> {
+        return core.HttpResponsePromise.fromPromise(this.__getEpisode(request, requestOptions));
+    }
+
+    private async __getEpisode(
+        request: Ichos.GetEpisodeRequest,
+        requestOptions?: EpisodesClient.RequestOptions,
+    ): Promise<core.WithRawResponse<Ichos.EpisodeResponse>> {
+        const { episodeId } = request;
+        const _authRequest: core.AuthRequest = await this._options.authProvider.getAuthRequest();
+        const _headers: core.Fetcher.Args["headers"] = mergeHeaders(
+            _authRequest.headers,
+            this._options?.headers,
+            mergeOnlyDefinedHeaders({ "x-virtual-user": requestOptions?.virtualUser ?? this._options?.virtualUser }),
+            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.IchosEnvironment.Default,
+                `v1/episodes/${core.url.encodePathParam(episodeId)}`,
+            ),
+            method: "GET",
+            headers: _headers,
+            queryParameters: requestOptions?.queryParams,
+            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 as Ichos.EpisodeResponse, rawResponse: _response.rawResponse };
+        }
+
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 401:
+                    throw new Ichos.UnauthorizedError(
+                        _response.error.body as Ichos.UnauthorizedErrorResponse,
+                        _response.rawResponse,
+                    );
+                case 403:
+                    throw new Ichos.ForbiddenError(
+                        _response.error.body as Ichos.UnauthenticatedErrorResponse,
+                        _response.rawResponse,
+                    );
+                case 404:
+                    throw new Ichos.NotFoundError(
+                        _response.error.body as Ichos.NotFoundErrorResponse,
+                        _response.rawResponse,
+                    );
+                case 500:
+                    throw new Ichos.InternalServerError(
+                        _response.error.body as Ichos.InternalServerErrorResponse,
+                        _response.rawResponse,
+                    );
+                default:
+                    throw new errors.IchosError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+
+        return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/v1/episodes/{episodeId}");
+    }
+
+    /**
+     * Delete an episode.
+     * Optionally delete the associated audio file.
+     *
+     * @param {Ichos.DeleteEpisodeRequest} request
+     * @param {EpisodesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Ichos.UnauthorizedError}
+     * @throws {@link Ichos.ForbiddenError}
+     * @throws {@link Ichos.NotFoundError}
+     * @throws {@link Ichos.InternalServerError}
+     *
+     * @example
+     *     await client.episodes.deleteEpisode({
+     *         episodeId: "episodeId"
+     *     })
+     */
+    public deleteEpisode(
+        request: Ichos.DeleteEpisodeRequest,
+        requestOptions?: EpisodesClient.RequestOptions,
+    ): core.HttpResponsePromise<Ichos.NullResponse> {
+        return core.HttpResponsePromise.fromPromise(this.__deleteEpisode(request, requestOptions));
+    }
+
+    private async __deleteEpisode(
+        request: Ichos.DeleteEpisodeRequest,
+        requestOptions?: EpisodesClient.RequestOptions,
+    ): Promise<core.WithRawResponse<Ichos.NullResponse>> {
+        const { episodeId, deleteAudio } = request;
+        const _queryParams: Record<string, string | string[] | object | object[] | null> = {};
+        if (deleteAudio != null) {
+            _queryParams.deleteAudio = deleteAudio.toString();
+        }
+
+        const _authRequest: core.AuthRequest = await this._options.authProvider.getAuthRequest();
+        const _headers: core.Fetcher.Args["headers"] = mergeHeaders(
+            _authRequest.headers,
+            this._options?.headers,
+            mergeOnlyDefinedHeaders({ "x-virtual-user": requestOptions?.virtualUser ?? this._options?.virtualUser }),
+            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.IchosEnvironment.Default,
+                `v1/episodes/${core.url.encodePathParam(episodeId)}`,
+            ),
+            method: "DELETE",
+            headers: _headers,
+            queryParameters: { ..._queryParams, ...requestOptions?.queryParams },
+            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 as Ichos.NullResponse, rawResponse: _response.rawResponse };
+        }
+
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 401:
+                    throw new Ichos.UnauthorizedError(
+                        _response.error.body as Ichos.UnauthorizedErrorResponse,
+                        _response.rawResponse,
+                    );
+                case 403:
+                    throw new Ichos.ForbiddenError(
+                        _response.error.body as Ichos.UnauthenticatedErrorResponse,
+                        _response.rawResponse,
+                    );
+                case 404:
+                    throw new Ichos.NotFoundError(
+                        _response.error.body as Ichos.NotFoundErrorResponse,
+                        _response.rawResponse,
+                    );
+                case 500:
+                    throw new Ichos.InternalServerError(
+                        _response.error.body as Ichos.InternalServerErrorResponse,
+                        _response.rawResponse,
+                    );
+                default:
+                    throw new errors.IchosError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+
+        return handleNonStatusCodeError(_response.error, _response.rawResponse, "DELETE", "/v1/episodes/{episodeId}");
+    }
+
+    /**
+     * Update an existing episode.
+     *
+     * @param {Ichos.EpisodeUpdate} request
+     * @param {EpisodesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Ichos.UnauthorizedError}
+     * @throws {@link Ichos.ForbiddenError}
+     * @throws {@link Ichos.NotFoundError}
+     * @throws {@link Ichos.InternalServerError}
+     *
+     * @example
+     *     await client.episodes.updateEpisode({
+     *         episodeId: "episodeId"
+     *     })
+     */
+    public updateEpisode(
+        request: Ichos.EpisodeUpdate,
+        requestOptions?: EpisodesClient.RequestOptions,
+    ): core.HttpResponsePromise<Ichos.EpisodeResponse> {
+        return core.HttpResponsePromise.fromPromise(this.__updateEpisode(request, requestOptions));
+    }
+
+    private async __updateEpisode(
+        request: Ichos.EpisodeUpdate,
+        requestOptions?: EpisodesClient.RequestOptions,
+    ): Promise<core.WithRawResponse<Ichos.EpisodeResponse>> {
+        const { episodeId, ..._body } = request;
+        const _authRequest: core.AuthRequest = await this._options.authProvider.getAuthRequest();
+        const _headers: core.Fetcher.Args["headers"] = mergeHeaders(
+            _authRequest.headers,
+            this._options?.headers,
+            mergeOnlyDefinedHeaders({ "x-virtual-user": requestOptions?.virtualUser ?? this._options?.virtualUser }),
+            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.IchosEnvironment.Default,
+                `v1/episodes/${core.url.encodePathParam(episodeId)}`,
+            ),
+            method: "PATCH",
+            headers: _headers,
+            contentType: "application/json",
+            queryParameters: requestOptions?.queryParams,
+            requestType: "json",
+            body: _body,
+            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 as Ichos.EpisodeResponse, rawResponse: _response.rawResponse };
+        }
+
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 401:
+                    throw new Ichos.UnauthorizedError(
+                        _response.error.body as Ichos.UnauthorizedErrorResponse,
+                        _response.rawResponse,
+                    );
+                case 403:
+                    throw new Ichos.ForbiddenError(
+                        _response.error.body as Ichos.UnauthenticatedErrorResponse,
+                        _response.rawResponse,
+                    );
+                case 404:
+                    throw new Ichos.NotFoundError(
+                        _response.error.body as Ichos.NotFoundErrorResponse,
+                        _response.rawResponse,
+                    );
+                case 500:
+                    throw new Ichos.InternalServerError(
+                        _response.error.body as Ichos.InternalServerErrorResponse,
+                        _response.rawResponse,
+                    );
+                default:
+                    throw new errors.IchosError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+
+        return handleNonStatusCodeError(_response.error, _response.rawResponse, "PATCH", "/v1/episodes/{episodeId}");
+    }
+
+    /**
+     * Generate a signed URL for uploading an episode cover image.
+     *
+     * @param {Ichos.GenerateEpisodeCoverUploadUrlRequest} request
+     * @param {EpisodesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Ichos.UnauthorizedError}
+     * @throws {@link Ichos.ForbiddenError}
+     * @throws {@link Ichos.NotFoundError}
+     * @throws {@link Ichos.InternalServerError}
+     *
+     * @example
+     *     await client.episodes.generateEpisodeCoverUploadUrl({
+     *         episodeId: "episodeId"
+     *     })
+     */
+    public generateEpisodeCoverUploadUrl(
+        request: Ichos.GenerateEpisodeCoverUploadUrlRequest,
+        requestOptions?: EpisodesClient.RequestOptions,
+    ): core.HttpResponsePromise<Ichos.UserUploadCoverResponse> {
+        return core.HttpResponsePromise.fromPromise(this.__generateEpisodeCoverUploadUrl(request, requestOptions));
+    }
+
+    private async __generateEpisodeCoverUploadUrl(
+        request: Ichos.GenerateEpisodeCoverUploadUrlRequest,
+        requestOptions?: EpisodesClient.RequestOptions,
+    ): Promise<core.WithRawResponse<Ichos.UserUploadCoverResponse>> {
+        const { episodeId } = request;
+        const _authRequest: core.AuthRequest = await this._options.authProvider.getAuthRequest();
+        const _headers: core.Fetcher.Args["headers"] = mergeHeaders(
+            _authRequest.headers,
+            this._options?.headers,
+            mergeOnlyDefinedHeaders({ "x-virtual-user": requestOptions?.virtualUser ?? this._options?.virtualUser }),
+            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.IchosEnvironment.Default,
+                `v1/episodes/${core.url.encodePathParam(episodeId)}/cover/put`,
+            ),
+            method: "GET",
+            headers: _headers,
+            queryParameters: requestOptions?.queryParams,
+            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 as Ichos.UserUploadCoverResponse, rawResponse: _response.rawResponse };
+        }
+
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 401:
+                    throw new Ichos.UnauthorizedError(
+                        _response.error.body as Ichos.UnauthorizedErrorResponse,
+                        _response.rawResponse,
+                    );
+                case 403:
+                    throw new Ichos.ForbiddenError(
+                        _response.error.body as Ichos.UnauthenticatedErrorResponse,
+                        _response.rawResponse,
+                    );
+                case 404:
+                    throw new Ichos.NotFoundError(
+                        _response.error.body as Ichos.NotFoundErrorResponse,
+                        _response.rawResponse,
+                    );
+                case 500:
+                    throw new Ichos.InternalServerError(
+                        _response.error.body as Ichos.InternalServerErrorResponse,
+                        _response.rawResponse,
+                    );
+                default:
+                    throw new errors.IchosError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+
+        return handleNonStatusCodeError(
+            _response.error,
+            _response.rawResponse,
+            "GET",
+            "/v1/episodes/{episodeId}/cover/put",
+        );
+    }
+
+    /**
+     * Trigger the system to pull an episode cover image from a URL.
+     *
+     * @param {Ichos.PullEpisodeCoverFromUrlRequest} request
+     * @param {EpisodesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Ichos.UnauthorizedError}
+     * @throws {@link Ichos.ForbiddenError}
+     * @throws {@link Ichos.NotFoundError}
+     * @throws {@link Ichos.InternalServerError}
+     *
+     * @example
+     *     await client.episodes.pullEpisodeCoverFromUrl({
+     *         episodeId: "episodeId",
+     *         url: "url"
+     *     })
+     */
+    public pullEpisodeCoverFromUrl(
+        request: Ichos.PullEpisodeCoverFromUrlRequest,
+        requestOptions?: EpisodesClient.RequestOptions,
+    ): core.HttpResponsePromise<Ichos.NullResponse> {
+        return core.HttpResponsePromise.fromPromise(this.__pullEpisodeCoverFromUrl(request, requestOptions));
+    }
+
+    private async __pullEpisodeCoverFromUrl(
+        request: Ichos.PullEpisodeCoverFromUrlRequest,
+        requestOptions?: EpisodesClient.RequestOptions,
+    ): Promise<core.WithRawResponse<Ichos.NullResponse>> {
+        const { episodeId, ..._body } = request;
+        const _authRequest: core.AuthRequest = await this._options.authProvider.getAuthRequest();
+        const _headers: core.Fetcher.Args["headers"] = mergeHeaders(
+            _authRequest.headers,
+            this._options?.headers,
+            mergeOnlyDefinedHeaders({ "x-virtual-user": requestOptions?.virtualUser ?? this._options?.virtualUser }),
+            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.IchosEnvironment.Default,
+                `v1/episodes/${core.url.encodePathParam(episodeId)}/cover/pull`,
+            ),
+            method: "POST",
+            headers: _headers,
+            contentType: "application/json",
+            queryParameters: requestOptions?.queryParams,
+            requestType: "json",
+            body: _body,
+            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 as Ichos.NullResponse, rawResponse: _response.rawResponse };
+        }
+
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 401:
+                    throw new Ichos.UnauthorizedError(
+                        _response.error.body as Ichos.UnauthorizedErrorResponse,
+                        _response.rawResponse,
+                    );
+                case 403:
+                    throw new Ichos.ForbiddenError(
+                        _response.error.body as Ichos.UnauthenticatedErrorResponse,
+                        _response.rawResponse,
+                    );
+                case 404:
+                    throw new Ichos.NotFoundError(
+                        _response.error.body as Ichos.NotFoundErrorResponse,
+                        _response.rawResponse,
+                    );
+                case 500:
+                    throw new Ichos.InternalServerError(
+                        _response.error.body as Ichos.InternalServerErrorResponse,
+                        _response.rawResponse,
+                    );
+                default:
+                    throw new errors.IchosError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+
+        return handleNonStatusCodeError(
+            _response.error,
+            _response.rawResponse,
+            "POST",
+            "/v1/episodes/{episodeId}/cover/pull",
+        );
+    }
+
+    /**
+     * Retrieve the current cover image for an episode.
+     *
+     * @param {Ichos.GetEpisodeCoverRequest} request
+     * @param {EpisodesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Ichos.UnauthorizedError}
+     * @throws {@link Ichos.ForbiddenError}
+     * @throws {@link Ichos.NotFoundError}
+     * @throws {@link Ichos.InternalServerError}
+     *
+     * @example
+     *     await client.episodes.getEpisodeCover({
+     *         episodeId: "episodeId"
+     *     })
+     */
+    public getEpisodeCover(
+        request: Ichos.GetEpisodeCoverRequest,
+        requestOptions?: EpisodesClient.RequestOptions,
+    ): core.HttpResponsePromise<Ichos.RetrieveCoverResponse> {
+        return core.HttpResponsePromise.fromPromise(this.__getEpisodeCover(request, requestOptions));
+    }
+
+    private async __getEpisodeCover(
+        request: Ichos.GetEpisodeCoverRequest,
+        requestOptions?: EpisodesClient.RequestOptions,
+    ): Promise<core.WithRawResponse<Ichos.RetrieveCoverResponse>> {
+        const { episodeId } = request;
+        const _authRequest: core.AuthRequest = await this._options.authProvider.getAuthRequest();
+        const _headers: core.Fetcher.Args["headers"] = mergeHeaders(
+            _authRequest.headers,
+            this._options?.headers,
+            mergeOnlyDefinedHeaders({ "x-virtual-user": requestOptions?.virtualUser ?? this._options?.virtualUser }),
+            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.IchosEnvironment.Default,
+                `v1/episodes/${core.url.encodePathParam(episodeId)}/cover`,
+            ),
+            method: "GET",
+            headers: _headers,
+            queryParameters: requestOptions?.queryParams,
+            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 as Ichos.RetrieveCoverResponse, rawResponse: _response.rawResponse };
+        }
+
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 401:
+                    throw new Ichos.UnauthorizedError(
+                        _response.error.body as Ichos.UnauthorizedErrorResponse,
+                        _response.rawResponse,
+                    );
+                case 403:
+                    throw new Ichos.ForbiddenError(
+                        _response.error.body as Ichos.UnauthenticatedErrorResponse,
+                        _response.rawResponse,
+                    );
+                case 404:
+                    throw new Ichos.NotFoundError(
+                        _response.error.body as Ichos.NotFoundErrorResponse,
+                        _response.rawResponse,
+                    );
+                case 500:
+                    throw new Ichos.InternalServerError(
+                        _response.error.body as Ichos.InternalServerErrorResponse,
+                        _response.rawResponse,
+                    );
+                default:
+                    throw new errors.IchosError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+
+        return handleNonStatusCodeError(
+            _response.error,
+            _response.rawResponse,
+            "GET",
+            "/v1/episodes/{episodeId}/cover",
+        );
+    }
+
+    /**
+     * Publish an episode to make it available in the RSS feed.
+     *
+     * @param {Ichos.PublishEpisodeRequest} request
+     * @param {EpisodesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Ichos.UnauthorizedError}
+     * @throws {@link Ichos.ForbiddenError}
+     * @throws {@link Ichos.NotFoundError}
+     * @throws {@link Ichos.UnprocessableEntityError}
+     * @throws {@link Ichos.InternalServerError}
+     *
+     * @example
+     *     await client.episodes.publishEpisode({
+     *         episodeId: "episodeId"
+     *     })
+     */
+    public publishEpisode(
+        request: Ichos.PublishEpisodeRequest,
+        requestOptions?: EpisodesClient.RequestOptions,
+    ): core.HttpResponsePromise<Ichos.NullResponse> {
+        return core.HttpResponsePromise.fromPromise(this.__publishEpisode(request, requestOptions));
+    }
+
+    private async __publishEpisode(
+        request: Ichos.PublishEpisodeRequest,
+        requestOptions?: EpisodesClient.RequestOptions,
+    ): Promise<core.WithRawResponse<Ichos.NullResponse>> {
+        const { episodeId } = request;
+        const _authRequest: core.AuthRequest = await this._options.authProvider.getAuthRequest();
+        const _headers: core.Fetcher.Args["headers"] = mergeHeaders(
+            _authRequest.headers,
+            this._options?.headers,
+            mergeOnlyDefinedHeaders({ "x-virtual-user": requestOptions?.virtualUser ?? this._options?.virtualUser }),
+            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.IchosEnvironment.Default,
+                `v1/episodes/${core.url.encodePathParam(episodeId)}/publish`,
+            ),
+            method: "POST",
+            headers: _headers,
+            queryParameters: requestOptions?.queryParams,
+            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 as Ichos.NullResponse, rawResponse: _response.rawResponse };
+        }
+
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 401:
+                    throw new Ichos.UnauthorizedError(
+                        _response.error.body as Ichos.UnauthorizedErrorResponse,
+                        _response.rawResponse,
+                    );
+                case 403:
+                    throw new Ichos.ForbiddenError(
+                        _response.error.body as Ichos.UnauthenticatedErrorResponse,
+                        _response.rawResponse,
+                    );
+                case 404:
+                    throw new Ichos.NotFoundError(
+                        _response.error.body as Ichos.NotFoundErrorResponse,
+                        _response.rawResponse,
+                    );
+                case 422:
+                    throw new Ichos.UnprocessableEntityError(
+                        _response.error.body as Ichos.ValidationErrorResponse,
+                        _response.rawResponse,
+                    );
+                case 500:
+                    throw new Ichos.InternalServerError(
+                        _response.error.body as Ichos.InternalServerErrorResponse,
+                        _response.rawResponse,
+                    );
+                default:
+                    throw new errors.IchosError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+
+        return handleNonStatusCodeError(
+            _response.error,
+            _response.rawResponse,
+            "POST",
+            "/v1/episodes/{episodeId}/publish",
+        );
+    }
+
+    /**
+     * Retrieve listener analytics for an episode.
+     *
+     * @param {Ichos.GetEpisodeListenersReportRequest} request
+     * @param {EpisodesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Ichos.UnauthorizedError}
+     * @throws {@link Ichos.ForbiddenError}
+     * @throws {@link Ichos.NotFoundError}
+     * @throws {@link Ichos.InternalServerError}
+     *
+     * @example
+     *     await client.episodes.getEpisodeListenersReport({
+     *         episodeId: "episodeId"
+     *     })
+     */
+    public getEpisodeListenersReport(
+        request: Ichos.GetEpisodeListenersReportRequest,
+        requestOptions?: EpisodesClient.RequestOptions,
+    ): core.HttpResponsePromise<Ichos.ListenersReportResponse> {
+        return core.HttpResponsePromise.fromPromise(this.__getEpisodeListenersReport(request, requestOptions));
+    }
+
+    private async __getEpisodeListenersReport(
+        request: Ichos.GetEpisodeListenersReportRequest,
+        requestOptions?: EpisodesClient.RequestOptions,
+    ): Promise<core.WithRawResponse<Ichos.ListenersReportResponse>> {
+        const { episodeId } = request;
+        const _authRequest: core.AuthRequest = await this._options.authProvider.getAuthRequest();
+        const _headers: core.Fetcher.Args["headers"] = mergeHeaders(
+            _authRequest.headers,
+            this._options?.headers,
+            mergeOnlyDefinedHeaders({ "x-virtual-user": requestOptions?.virtualUser ?? this._options?.virtualUser }),
+            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.IchosEnvironment.Default,
+                `v1/episodes/${core.url.encodePathParam(episodeId)}/analytics/listens`,
+            ),
+            method: "GET",
+            headers: _headers,
+            queryParameters: requestOptions?.queryParams,
+            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 as Ichos.ListenersReportResponse, rawResponse: _response.rawResponse };
+        }
+
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 401:
+                    throw new Ichos.UnauthorizedError(
+                        _response.error.body as Ichos.UnauthorizedErrorResponse,
+                        _response.rawResponse,
+                    );
+                case 403:
+                    throw new Ichos.ForbiddenError(
+                        _response.error.body as Ichos.UnauthenticatedErrorResponse,
+                        _response.rawResponse,
+                    );
+                case 404:
+                    throw new Ichos.NotFoundError(
+                        _response.error.body as Ichos.NotFoundErrorResponse,
+                        _response.rawResponse,
+                    );
+                case 500:
+                    throw new Ichos.InternalServerError(
+                        _response.error.body as Ichos.InternalServerErrorResponse,
+                        _response.rawResponse,
+                    );
+                default:
+                    throw new errors.IchosError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+
+        return handleNonStatusCodeError(
+            _response.error,
+            _response.rawResponse,
+            "GET",
+            "/v1/episodes/{episodeId}/analytics/listens",
+        );
+    }
+
+    /**
+     * List audio records for a specific episode.
+     *
+     * @param {Ichos.GetEpisodeAudioRequest} request
+     * @param {EpisodesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Ichos.UnauthorizedError}
+     * @throws {@link Ichos.ForbiddenError}
+     * @throws {@link Ichos.NotFoundError}
+     * @throws {@link Ichos.InternalServerError}
+     *
+     * @example
+     *     await client.episodes.getEpisodeAudio({
+     *         episodeId: "episodeId"
+     *     })
+     */
+    public getEpisodeAudio(
+        request: Ichos.GetEpisodeAudioRequest,
+        requestOptions?: EpisodesClient.RequestOptions,
+    ): core.HttpResponsePromise<Ichos.AudioResponse> {
+        return core.HttpResponsePromise.fromPromise(this.__getEpisodeAudio(request, requestOptions));
+    }
+
+    private async __getEpisodeAudio(
+        request: Ichos.GetEpisodeAudioRequest,
+        requestOptions?: EpisodesClient.RequestOptions,
+    ): Promise<core.WithRawResponse<Ichos.AudioResponse>> {
+        const { episodeId } = request;
+        const _authRequest: core.AuthRequest = await this._options.authProvider.getAuthRequest();
+        const _headers: core.Fetcher.Args["headers"] = mergeHeaders(
+            _authRequest.headers,
+            this._options?.headers,
+            mergeOnlyDefinedHeaders({ "x-virtual-user": requestOptions?.virtualUser ?? this._options?.virtualUser }),
+            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.IchosEnvironment.Default,
+                `v1/episodes/${core.url.encodePathParam(episodeId)}/audio`,
+            ),
+            method: "GET",
+            headers: _headers,
+            queryParameters: requestOptions?.queryParams,
+            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 as Ichos.AudioResponse, rawResponse: _response.rawResponse };
+        }
+
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 401:
+                    throw new Ichos.UnauthorizedError(
+                        _response.error.body as Ichos.UnauthorizedErrorResponse,
+                        _response.rawResponse,
+                    );
+                case 403:
+                    throw new Ichos.ForbiddenError(
+                        _response.error.body as Ichos.UnauthenticatedErrorResponse,
+                        _response.rawResponse,
+                    );
+                case 404:
+                    throw new Ichos.NotFoundError(
+                        _response.error.body as Ichos.NotFoundErrorResponse,
+                        _response.rawResponse,
+                    );
+                case 500:
+                    throw new Ichos.InternalServerError(
+                        _response.error.body as Ichos.InternalServerErrorResponse,
+                        _response.rawResponse,
+                    );
+                default:
+                    throw new errors.IchosError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+
+        return handleNonStatusCodeError(
+            _response.error,
+            _response.rawResponse,
+            "GET",
+            "/v1/episodes/{episodeId}/audio",
+        );
+    }
+
+    /**
+     * Link an audio file to an episode.
+     *
+     * @param {Ichos.LinkEpisodeAudioRequest} request
+     * @param {EpisodesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Ichos.UnauthorizedError}
+     * @throws {@link Ichos.ForbiddenError}
+     * @throws {@link Ichos.NotFoundError}
+     * @throws {@link Ichos.InternalServerError}
+     *
+     * @example
+     *     await client.episodes.linkEpisodeAudio({
+     *         episodeId: "episodeId",
+     *         audioId: "audioId"
+     *     })
+     */
+    public linkEpisodeAudio(
+        request: Ichos.LinkEpisodeAudioRequest,
+        requestOptions?: EpisodesClient.RequestOptions,
+    ): core.HttpResponsePromise<Ichos.NullResponse> {
+        return core.HttpResponsePromise.fromPromise(this.__linkEpisodeAudio(request, requestOptions));
+    }
+
+    private async __linkEpisodeAudio(
+        request: Ichos.LinkEpisodeAudioRequest,
+        requestOptions?: EpisodesClient.RequestOptions,
+    ): Promise<core.WithRawResponse<Ichos.NullResponse>> {
+        const { episodeId, ..._body } = request;
+        const _authRequest: core.AuthRequest = await this._options.authProvider.getAuthRequest();
+        const _headers: core.Fetcher.Args["headers"] = mergeHeaders(
+            _authRequest.headers,
+            this._options?.headers,
+            mergeOnlyDefinedHeaders({ "x-virtual-user": requestOptions?.virtualUser ?? this._options?.virtualUser }),
+            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.IchosEnvironment.Default,
+                `v1/episodes/${core.url.encodePathParam(episodeId)}/link-audio`,
+            ),
+            method: "PUT",
+            headers: _headers,
+            contentType: "application/json",
+            queryParameters: requestOptions?.queryParams,
+            requestType: "json",
+            body: _body,
+            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 as Ichos.NullResponse, rawResponse: _response.rawResponse };
+        }
+
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 401:
+                    throw new Ichos.UnauthorizedError(
+                        _response.error.body as Ichos.UnauthorizedErrorResponse,
+                        _response.rawResponse,
+                    );
+                case 403:
+                    throw new Ichos.ForbiddenError(
+                        _response.error.body as Ichos.UnauthenticatedErrorResponse,
+                        _response.rawResponse,
+                    );
+                case 404:
+                    throw new Ichos.NotFoundError(
+                        _response.error.body as Ichos.NotFoundErrorResponse,
+                        _response.rawResponse,
+                    );
+                case 500:
+                    throw new Ichos.InternalServerError(
+                        _response.error.body as Ichos.InternalServerErrorResponse,
+                        _response.rawResponse,
+                    );
+                default:
+                    throw new errors.IchosError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+
+        return handleNonStatusCodeError(
+            _response.error,
+            _response.rawResponse,
+            "PUT",
+            "/v1/episodes/{episodeId}/link-audio",
+        );
+    }
+}