@ichos/sdk 1.0.9 → 1.0.11

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

@@ -23,27 +23,40 @@ export class SegmentsClient {
     }
 
     /**
-     * Retrieve all segments for the authenticated context (Virtual User or Organization).
+     * Retrieve all segments for the given scope.
      *
+     * @param {Ichos.ListSegmentsRequest} request
      * @param {SegmentsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
+     * @throws {@link Ichos.BadRequestError}
      * @throws {@link Ichos.UnauthorizedError}
      * @throws {@link Ichos.ForbiddenError}
      * @throws {@link Ichos.NotFoundError}
      * @throws {@link Ichos.InternalServerError}
      *
      * @example
-     *     await client.segments.listSegments()
+     *     await client.segments.listSegments({
+     *         scope: "organization"
+     *     })
      */
     public listSegments(
+        request: Ichos.ListSegmentsRequest,
         requestOptions?: SegmentsClient.RequestOptions,
     ): core.HttpResponsePromise<Ichos.SegmentListResponse> {
-        return core.HttpResponsePromise.fromPromise(this.__listSegments(requestOptions));
+        return core.HttpResponsePromise.fromPromise(this.__listSegments(request, requestOptions));
     }
 
     private async __listSegments(
+        request: Ichos.ListSegmentsRequest,
         requestOptions?: SegmentsClient.RequestOptions,
     ): Promise<core.WithRawResponse<Ichos.SegmentListResponse>> {
+        const { scope, id } = request;
+        const _queryParams: Record<string, string | string[] | object | object[] | null> = {};
+        _queryParams.scope = scope;
+        if (id != null) {
+            _queryParams.id = id;
+        }
+
         const _authRequest: core.AuthRequest = await this._options.authProvider.getAuthRequest();
         const _headers: core.Fetcher.Args["headers"] = mergeHeaders(
             _authRequest.headers,
@@ -60,7 +73,7 @@ export class SegmentsClient {
             ),
             method: "GET",
             headers: _headers,
-            queryParameters: requestOptions?.queryParams,
+            queryParameters: { ..._queryParams, ...requestOptions?.queryParams },
             timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
             maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
             abortSignal: requestOptions?.abortSignal,
@@ -73,6 +86,11 @@ export class SegmentsClient {
 
         if (_response.error.reason === "status-code") {
             switch (_response.error.statusCode) {
+                case 400:
+                    throw new Ichos.BadRequestError(
+                        _response.error.body as Ichos.BadRequestErrorBody,
+                        _response.rawResponse,
+                    );
                 case 401:
                     throw new Ichos.UnauthorizedError(
                         _response.error.body as Ichos.UnauthorizedErrorResponse,
@@ -80,7 +98,7 @@ export class SegmentsClient {
                     );
                 case 403:
                     throw new Ichos.ForbiddenError(
-                        _response.error.body as Ichos.UnauthenticatedErrorResponse,
+                        _response.error.body as Ichos.ForbiddenErrorResponse,
                         _response.rawResponse,
                     );
                 case 404:
@@ -172,7 +190,7 @@ export class SegmentsClient {
                     );
                 case 403:
                     throw new Ichos.ForbiddenError(
-                        _response.error.body as Ichos.UnauthenticatedErrorResponse,
+                        _response.error.body as Ichos.ForbiddenErrorResponse,
                         _response.rawResponse,
                     );
                 case 500:
@@ -259,7 +277,7 @@ export class SegmentsClient {
                     );
                 case 403:
                     throw new Ichos.ForbiddenError(
-                        _response.error.body as Ichos.UnauthenticatedErrorResponse,
+                        _response.error.body as Ichos.ForbiddenErrorResponse,
                         _response.rawResponse,
                     );
                 case 500:
@@ -284,100 +302,6 @@ export class SegmentsClient {
         );
     }
 
-    /**
-     * Retrieve all segments for a specific podcast.
-     *
-     * @param {Ichos.ListPodcastSegmentsRequest} request
-     * @param {SegmentsClient.RequestOptions} requestOptions - Request-specific configuration.
-     *
-     * @throws {@link Ichos.UnauthorizedError}
-     * @throws {@link Ichos.ForbiddenError}
-     * @throws {@link Ichos.NotFoundError}
-     * @throws {@link Ichos.InternalServerError}
-     *
-     * @example
-     *     await client.segments.listPodcastSegments({
-     *         podcastId: "podcastId"
-     *     })
-     */
-    public listPodcastSegments(
-        request: Ichos.ListPodcastSegmentsRequest,
-        requestOptions?: SegmentsClient.RequestOptions,
-    ): core.HttpResponsePromise<Ichos.SegmentListResponse> {
-        return core.HttpResponsePromise.fromPromise(this.__listPodcastSegments(request, requestOptions));
-    }
-
-    private async __listPodcastSegments(
-        request: Ichos.ListPodcastSegmentsRequest,
-        requestOptions?: SegmentsClient.RequestOptions,
-    ): Promise<core.WithRawResponse<Ichos.SegmentListResponse>> {
-        const { podcastId } = 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/segments/podcast/${core.url.encodePathParam(podcastId)}`,
-            ),
-            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.SegmentListResponse, 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/segments/podcast/{podcastId}",
-        );
-    }
-
     /**
      * Delete a segment.
      * Optionally delete the associated audio file.
@@ -448,7 +372,7 @@ export class SegmentsClient {
                     );
                 case 403:
                     throw new Ichos.ForbiddenError(
-                        _response.error.body as Ichos.UnauthenticatedErrorResponse,
+                        _response.error.body as Ichos.ForbiddenErrorResponse,
                         _response.rawResponse,
                     );
                 case 404:
@@ -540,7 +464,7 @@ export class SegmentsClient {
                     );
                 case 403:
                     throw new Ichos.ForbiddenError(
-                        _response.error.body as Ichos.UnauthenticatedErrorResponse,
+                        _response.error.body as Ichos.ForbiddenErrorResponse,
                         _response.rawResponse,
                     );
                 case 404:

package/src/api/resources/segments/client/requests/ListSegmentsRequest.ts

@@ -0,0 +1,14 @@
+// This file was auto-generated by Fern from our API Definition.
+
+import type * as Ichos from "../../../../index.js";
+
+/**
+ * @example
+ *     {
+ *         scope: "organization"
+ *     }
+ */
+export interface ListSegmentsRequest {
+    scope: Ichos.ListSegmentsRequestScope;
+    id?: string;
+}

package/src/api/resources/segments/client/requests/SegmentCreate.ts

@@ -1,5 +1,7 @@
 // This file was auto-generated by Fern from our API Definition.
 
+import type * as Ichos from "../../../../index.js";
+
 /**
  * @example
  *     {
@@ -8,22 +10,42 @@
  *     }
  */
 export interface SegmentCreate {
+    /**
+     * The scope of the segment, which can be 'organization', 'virtualUser', or 'podcast'. This determines the ownership and applicability of the segment.
+     * - 'organization': The segment applies to all podcasts within the organization.
+     * - 'virtualUser': The segment applies to all podcasts associated with a specific virtual user.
+     * - 'podcast': The segment applies only to a specific podcast.
+     */
     scope: SegmentCreate.Scope;
+    /** The type of segment, which can be either 'intro' or 'outro'. */
     type: SegmentCreate.Type;
+    /** Whether or not the segment will be actively used. */
     active?: boolean;
-    organizationId?: string | null;
-    virtualUserId?: string | null;
-    podcastId?: string | null;
+    /**
+     * The ID to the virtualUser or podcast this segment belongs to, depending on the scope.
+     * For an organization-scoped segment, this is not required.
+     */
+    entityId?: string;
+    /** Optional metadata object that can store additional information about the segment. */
+    metadata?: Ichos.Metadata;
+    /** The ID of the audio file associated with this segment, if any. */
     audioId?: string | null;
 }
 
 export namespace SegmentCreate {
+    /**
+     * The scope of the segment, which can be 'organization', 'virtualUser', or 'podcast'. This determines the ownership and applicability of the segment.
+     * - 'organization': The segment applies to all podcasts within the organization.
+     * - 'virtualUser': The segment applies to all podcasts associated with a specific virtual user.
+     * - 'podcast': The segment applies only to a specific podcast.
+     */
     export const Scope = {
         Organization: "organization",
-        VirtualUser: "virtual_user",
+        VirtualUser: "virtualUser",
         Podcast: "podcast",
     } as const;
     export type Scope = (typeof Scope)[keyof typeof Scope];
+    /** The type of segment, which can be either 'intro' or 'outro'. */
     export const Type = {
         Intro: "intro",
         Outro: "outro",

package/src/api/resources/segments/client/requests/SegmentUpdate.ts

@@ -1,5 +1,7 @@
 // This file was auto-generated by Fern from our API Definition.
 
+import type * as Ichos from "../../../../index.js";
+
 /**
  * @example
  *     {
@@ -8,22 +10,42 @@
  */
 export interface SegmentUpdate {
     segmentId: string;
+    /**
+     * The scope of the segment, which can be 'organization', 'virtualUser', or 'podcast'. This determines the ownership and applicability of the segment.
+     * - 'organization': The segment applies to all podcasts within the organization.
+     * - 'virtualUser': The segment applies to all podcasts associated with a specific virtual user.
+     * - 'podcast': The segment applies only to a specific podcast.
+     */
     scope?: SegmentUpdate.Scope;
+    /** The type of segment, which can be either 'intro' or 'outro'. */
     type?: SegmentUpdate.Type;
+    /** Whether or not the segment will be actively used. */
     active?: boolean;
-    organizationId?: string;
-    virtualUserId?: string;
-    podcastId?: string;
+    /**
+     * The ID to the virtualUser or podcast this segment belongs to, depending on the scope.
+     * For an organization-scoped segment, this is not required.
+     */
+    entityId?: string;
+    /** Optional metadata object that can store additional information about the segment. */
+    metadata?: Ichos.Metadata;
+    /** The ID of the audio file associated with this segment, if any. */
     audioId?: string;
 }
 
 export namespace SegmentUpdate {
+    /**
+     * The scope of the segment, which can be 'organization', 'virtualUser', or 'podcast'. This determines the ownership and applicability of the segment.
+     * - 'organization': The segment applies to all podcasts within the organization.
+     * - 'virtualUser': The segment applies to all podcasts associated with a specific virtual user.
+     * - 'podcast': The segment applies only to a specific podcast.
+     */
     export const Scope = {
         Organization: "organization",
-        VirtualUser: "virtual_user",
+        VirtualUser: "virtualUser",
         Podcast: "podcast",
     } as const;
     export type Scope = (typeof Scope)[keyof typeof Scope];
+    /** The type of segment, which can be either 'intro' or 'outro'. */
     export const Type = {
         Intro: "intro",
         Outro: "outro",

package/src/api/resources/segments/client/requests/index.ts

@@ -1,5 +1,5 @@
 export type { DeleteSegmentRequest } from "./DeleteSegmentRequest.js";
 export type { LinkSegmentAudioRequest } from "./LinkSegmentAudioRequest.js";
-export type { ListPodcastSegmentsRequest } from "./ListPodcastSegmentsRequest.js";
+export type { ListSegmentsRequest } from "./ListSegmentsRequest.js";
 export type { SegmentCreate } from "./SegmentCreate.js";
 export type { SegmentUpdate } from "./SegmentUpdate.js";

package/src/api/resources/segments/index.ts

@@ -1 +1,2 @@
 export * from "./client/index.js";
+export * from "./types/index.js";

package/src/api/resources/segments/types/ListSegmentsRequestScope.ts

@@ -0,0 +1,8 @@
+// This file was auto-generated by Fern from our API Definition.
+
+export const ListSegmentsRequestScope = {
+    Organization: "organization",
+    VirtualUser: "virtualUser",
+    Podcast: "podcast",
+} as const;
+export type ListSegmentsRequestScope = (typeof ListSegmentsRequestScope)[keyof typeof ListSegmentsRequestScope];

package/src/api/resources/segments/types/index.ts

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

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

@@ -15,6 +15,9 @@ export declare namespace UsersClient {
     export interface RequestOptions extends BaseRequestOptions {}
 }
 
+/**
+ * Endpoints for managing user accounts and profiles.
+ */
 export class UsersClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<UsersClient.Options>;
 
@@ -30,6 +33,7 @@ export class UsersClient {
      * @throws {@link Ichos.UnauthorizedError}
      * @throws {@link Ichos.ForbiddenError}
      * @throws {@link Ichos.NotFoundError}
+     * @throws {@link Ichos.TooManyRequestsError}
      * @throws {@link Ichos.InternalServerError}
      *
      * @example
@@ -80,7 +84,7 @@ export class UsersClient {
                     );
                 case 403:
                     throw new Ichos.ForbiddenError(
-                        _response.error.body as Ichos.UnauthenticatedErrorResponse,
+                        _response.error.body as Ichos.ForbiddenErrorResponse,
                         _response.rawResponse,
                     );
                 case 404:
@@ -88,6 +92,11 @@ export class UsersClient {
                         _response.error.body as Ichos.NotFoundErrorResponse,
                         _response.rawResponse,
                     );
+                case 429:
+                    throw new Ichos.TooManyRequestsError(
+                        _response.error.body as Ichos.TooManyRequestsErrorResponse,
+                        _response.rawResponse,
+                    );
                 case 500:
                     throw new Ichos.InternalServerError(
                         _response.error.body as Ichos.InternalServerErrorResponse,
@@ -113,6 +122,7 @@ export class UsersClient {
      * @throws {@link Ichos.UnauthorizedError}
      * @throws {@link Ichos.ForbiddenError}
      * @throws {@link Ichos.NotFoundError}
+     * @throws {@link Ichos.TooManyRequestsError}
      * @throws {@link Ichos.InternalServerError}
      *
      * @example
@@ -163,7 +173,7 @@ export class UsersClient {
                     );
                 case 403:
                     throw new Ichos.ForbiddenError(
-                        _response.error.body as Ichos.UnauthenticatedErrorResponse,
+                        _response.error.body as Ichos.ForbiddenErrorResponse,
                         _response.rawResponse,
                     );
                 case 404:
@@ -171,6 +181,11 @@ export class UsersClient {
                         _response.error.body as Ichos.NotFoundErrorResponse,
                         _response.rawResponse,
                     );
+                case 429:
+                    throw new Ichos.TooManyRequestsError(
+                        _response.error.body as Ichos.TooManyRequestsErrorResponse,
+                        _response.rawResponse,
+                    );
                 case 500:
                     throw new Ichos.InternalServerError(
                         _response.error.body as Ichos.InternalServerErrorResponse,
@@ -197,6 +212,7 @@ export class UsersClient {
      * @throws {@link Ichos.UnauthorizedError}
      * @throws {@link Ichos.ForbiddenError}
      * @throws {@link Ichos.NotFoundError}
+     * @throws {@link Ichos.TooManyRequestsError}
      * @throws {@link Ichos.InternalServerError}
      *
      * @example
@@ -252,7 +268,7 @@ export class UsersClient {
                     );
                 case 403:
                     throw new Ichos.ForbiddenError(
-                        _response.error.body as Ichos.UnauthenticatedErrorResponse,
+                        _response.error.body as Ichos.ForbiddenErrorResponse,
                         _response.rawResponse,
                     );
                 case 404:
@@ -260,6 +276,11 @@ export class UsersClient {
                         _response.error.body as Ichos.NotFoundErrorResponse,
                         _response.rawResponse,
                     );
+                case 429:
+                    throw new Ichos.TooManyRequestsError(
+                        _response.error.body as Ichos.TooManyRequestsErrorResponse,
+                        _response.rawResponse,
+                    );
                 case 500:
                     throw new Ichos.InternalServerError(
                         _response.error.body as Ichos.InternalServerErrorResponse,
@@ -285,6 +306,7 @@ export class UsersClient {
      * @throws {@link Ichos.UnauthorizedError}
      * @throws {@link Ichos.ForbiddenError}
      * @throws {@link Ichos.NotFoundError}
+     * @throws {@link Ichos.TooManyRequestsError}
      * @throws {@link Ichos.InternalServerError}
      *
      * @example
@@ -335,7 +357,7 @@ export class UsersClient {
                     );
                 case 403:
                     throw new Ichos.ForbiddenError(
-                        _response.error.body as Ichos.UnauthenticatedErrorResponse,
+                        _response.error.body as Ichos.ForbiddenErrorResponse,
                         _response.rawResponse,
                     );
                 case 404:
@@ -343,6 +365,11 @@ export class UsersClient {
                         _response.error.body as Ichos.NotFoundErrorResponse,
                         _response.rawResponse,
                     );
+                case 429:
+                    throw new Ichos.TooManyRequestsError(
+                        _response.error.body as Ichos.TooManyRequestsErrorResponse,
+                        _response.rawResponse,
+                    );
                 case 500:
                     throw new Ichos.InternalServerError(
                         _response.error.body as Ichos.InternalServerErrorResponse,
@@ -368,6 +395,7 @@ export class UsersClient {
      * @throws {@link Ichos.UnauthorizedError}
      * @throws {@link Ichos.ForbiddenError}
      * @throws {@link Ichos.NotFoundError}
+     * @throws {@link Ichos.TooManyRequestsError}
      * @throws {@link Ichos.InternalServerError}
      *
      * @example
@@ -418,7 +446,7 @@ export class UsersClient {
                     );
                 case 403:
                     throw new Ichos.ForbiddenError(
-                        _response.error.body as Ichos.UnauthenticatedErrorResponse,
+                        _response.error.body as Ichos.ForbiddenErrorResponse,
                         _response.rawResponse,
                     );
                 case 404:
@@ -426,6 +454,11 @@ export class UsersClient {
                         _response.error.body as Ichos.NotFoundErrorResponse,
                         _response.rawResponse,
                     );
+                case 429:
+                    throw new Ichos.TooManyRequestsError(
+                        _response.error.body as Ichos.TooManyRequestsErrorResponse,
+                        _response.rawResponse,
+                    );
                 case 500:
                     throw new Ichos.InternalServerError(
                         _response.error.body as Ichos.InternalServerErrorResponse,

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

@@ -31,6 +31,7 @@ export class WebhooksClient {
      *
      * @throws {@link Ichos.UnauthorizedError}
      * @throws {@link Ichos.ForbiddenError}
+     * @throws {@link Ichos.TooManyRequestsError}
      * @throws {@link Ichos.InternalServerError}
      *
      * @example
@@ -88,7 +89,12 @@ export class WebhooksClient {
                     );
                 case 403:
                     throw new Ichos.ForbiddenError(
-                        _response.error.body as Ichos.UnauthenticatedErrorResponse,
+                        _response.error.body as Ichos.ForbiddenErrorResponse,
+                        _response.rawResponse,
+                    );
+                case 429:
+                    throw new Ichos.TooManyRequestsError(
+                        _response.error.body as Ichos.TooManyRequestsErrorResponse,
                         _response.rawResponse,
                     );
                 case 500:
@@ -115,6 +121,7 @@ export class WebhooksClient {
      *
      * @throws {@link Ichos.UnauthorizedError}
      * @throws {@link Ichos.ForbiddenError}
+     * @throws {@link Ichos.TooManyRequestsError}
      * @throws {@link Ichos.InternalServerError}
      *
      * @example
@@ -168,7 +175,12 @@ export class WebhooksClient {
                     );
                 case 403:
                     throw new Ichos.ForbiddenError(
-                        _response.error.body as Ichos.UnauthenticatedErrorResponse,
+                        _response.error.body as Ichos.ForbiddenErrorResponse,
+                        _response.rawResponse,
+                    );
+                case 429:
+                    throw new Ichos.TooManyRequestsError(
+                        _response.error.body as Ichos.TooManyRequestsErrorResponse,
                         _response.rawResponse,
                     );
                 case 500:
@@ -196,6 +208,7 @@ export class WebhooksClient {
      *
      * @throws {@link Ichos.UnauthorizedError}
      * @throws {@link Ichos.ForbiddenError}
+     * @throws {@link Ichos.TooManyRequestsError}
      * @throws {@link Ichos.InternalServerError}
      *
      * @example
@@ -251,7 +264,12 @@ export class WebhooksClient {
                     );
                 case 403:
                     throw new Ichos.ForbiddenError(
-                        _response.error.body as Ichos.UnauthenticatedErrorResponse,
+                        _response.error.body as Ichos.ForbiddenErrorResponse,
+                        _response.rawResponse,
+                    );
+                case 429:
+                    throw new Ichos.TooManyRequestsError(
+                        _response.error.body as Ichos.TooManyRequestsErrorResponse,
                         _response.rawResponse,
                     );
                 case 500:
@@ -283,6 +301,7 @@ export class WebhooksClient {
      *
      * @throws {@link Ichos.UnauthorizedError}
      * @throws {@link Ichos.ForbiddenError}
+     * @throws {@link Ichos.TooManyRequestsError}
      * @throws {@link Ichos.InternalServerError}
      *
      * @example
@@ -333,7 +352,12 @@ export class WebhooksClient {
                     );
                 case 403:
                     throw new Ichos.ForbiddenError(
-                        _response.error.body as Ichos.UnauthenticatedErrorResponse,
+                        _response.error.body as Ichos.ForbiddenErrorResponse,
+                        _response.rawResponse,
+                    );
+                case 429:
+                    throw new Ichos.TooManyRequestsError(
+                        _response.error.body as Ichos.TooManyRequestsErrorResponse,
                         _response.rawResponse,
                     );
                 case 500:

package/src/api/types/Audio.ts

@@ -3,22 +3,31 @@
 import type * as Ichos from "../index.js";
 
 export interface Audio {
+    /** Unique identifier for the audio record. */
     id: string;
-    rawKey: string | null;
+    /** Original file size of the raw file uploaded by the user. Null if the raw audio has been deleted. */
     rawSize: number | null;
+    /** Processing status of the audio file. Will be 'uploading' while the user is uploading the file, then transition to 'processing' while we analyze and process the audio, and finally 'done' when the audio is ready to be used. If any errors occur during upload or processing, the status will be 'pull_failed' or 'failed' respectively. */
     status: Audio.Status;
-    processedKey: string | null;
+    /** Duration in seconds for the processed audio. Null if unknown. */
     duration: number | null;
+    /** Size in bytes for the processed audio. Null if unknown. */
     size: number | null;
+    /** MIME type of the processed audio (e.g. "audio/mpeg"). Null if unknown. */
     type: string | null;
+    /** Bitrate in kbps for the processed audio. Null if unknown. */
     bitrate: number | null;
+    /** Sample rate in Hz for the processed audio. Null if unknown. */
     sampleRate: number | null;
+    /** Number of audio channels (e.g. 1 for mono, 2 for stereo) for the processed audio. Null if unknown. */
     channels: number | null;
     chapters: Ichos.Chapter[];
+    /** URL to access the audio file. This URL is temporary and will expire after 1 hour. */
     url: string | null;
 }
 
 export namespace Audio {
+    /** Processing status of the audio file. Will be 'uploading' while the user is uploading the file, then transition to 'processing' while we analyze and process the audio, and finally 'done' when the audio is ready to be used. If any errors occur during upload or processing, the status will be 'pull_failed' or 'failed' respectively. */
     export const Status = {
         Uploading: "uploading",
         Pulling: "pulling",

package/src/api/types/{UnauthenticatedError.ts → BadRequestErrorBody.ts}

@@ -1,6 +1,6 @@
 // This file was auto-generated by Fern from our API Definition.
 
-export interface UnauthenticatedError {
+export interface BadRequestErrorBody {
     name: string;
     message: string;
     stack?: string;

package/src/api/types/Chapter.ts

@@ -1,7 +1,10 @@
 // This file was auto-generated by Fern from our API Definition.
 
 export interface Chapter {
+    /** Start time of the chapter in seconds. Must be less than endTime. */
     startTime: number;
+    /** End time of the chapter in seconds. Must be greater than startTime. */
     endTime: number;
+    /** Title of the chapter. */
     title: string;
 }

package/src/api/types/EpisodeCreateResponse.ts

@@ -4,6 +4,6 @@ import type * as Ichos from "../index.js";
 
 export interface EpisodeCreateResponse {
     success: boolean;
-    data: Ichos.EpisodeCreatedResponseData;
+    data: Ichos.EpisodeCreateResponseData;
     meta: Ichos.ApiMetaSuccess;
 }