@breeze.blue/sdk 0.20.0 → 0.21.0

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## 0.21.0
+
+- Support request-scoped speaker boost across HTTP and realtime TTS, with performance instructions taking priority when guidance exceeds 1.
+- Serialize documented request controls only.
+- Honor the clone reference-denoising switch (disabled by default).
+- Read the account's plan, billing period, monthly credits, saved voice and project limits and generation concurrency with `client.account.entitlements()`, typed as `Entitlements`.
+- Breaking: remove `voices.getSettings(...)`, `voices.editSettings(...)`, the `VoiceSettings` type and `Voice.settings`; the voice settings endpoints are removed.
+- TTS guidance no longer inherits saved voice settings; omitted `voiceSettings.guidanceScale` uses the default 1.
+- Breaking: remove `voices.favorite(...)` and `voices.unfavorite(...)`; the favorite endpoints are removed. `isFavorited` and the `favoritesOnly` filter remain.
+
+## 0.20.1
+
+- Studio list methods type their filters: `StudioProjectListParams`, `StudioChapterListParams`, `StudioClipListParams` and `StudioFileListParams`.
+- `studio.files.upload` accepts `waitTimeout`.
+- Studio file upload and processing failures reject with `BreezeBlueStudioFileError`, which carries the latest file record in `file`.
+- Studio response types mark fields the API always returns as required.
+- The default `fetch` is called unbound, so the client works in browsers without passing `fetch`; a custom `window.fetch` no longer throws "Illegal invocation".
+- Studio methods without query parameters take request options as the last argument, e.g. `studio.projects.get(id, { timeout })`. The `(…, params, options)` form still works and is deprecated.
+- Studio file responses type `status` as `StudioFileStatus`, and `uploadUrl` returns `expiresIn`.
+
 ## 0.20.0
 
 - Manage Studio projects, chapters, clips, auxiliary tracks, audio instances and files through `client.studio`.

package/README.md

@@ -7,6 +7,8 @@ models, and account usage.
 The root entrypoint is safe to import in Node, browser, and edge runtimes. Local
 audio playback helpers live in the Node-only `@breeze.blue/sdk/node` subpath.
 
+Guidance accepts 1–10; when omitted, the default 1 is used. HTTP speed and volume are per request and default to 1. Use `voiceSettings: { useSpeakerBoost: true }` for closer similarity to the reference voice (default false): it is ignored with non-empty instructions and guidance above 1, and otherwise instructions are not used. Realtime fixes boost at session creation; create a new session to change instructions while boost applies. Pass `removeBackgroundNoise: true` to denoise a clone sample (default false).
+
 ## Install
 
 ```sh
@@ -421,7 +423,6 @@ const taggedFavorites = await client.voices.search({
 const firstVoiceId = voices.voices[0].voiceId;
 
 const voice = await client.voices.get(firstVoiceId);
-const settings = await client.voices.getSettings(firstVoiceId);
 
 const randomVoice = await client.voices.random();
 console.log(randomVoice.voiceId, randomVoice.name);
@@ -563,7 +564,7 @@ const saved = await client.voices.savePreview({
 });
 ```
 
-Edit, tune settings, or delete a saved voice:
+Edit or delete a saved voice:
 
 ```ts
 await client.voices.edit(saved.voiceId, {
@@ -573,11 +574,8 @@ await client.voices.edit(saved.voiceId, {
 });
 // null clears nullable metadata; [] clears tone. Omitted fields remain unchanged.
 await client.voices.edit(saved.voiceId, { accent: null, tone: [] });
-await client.voices.editSettings(saved.voiceId, { guidanceScale: 1.2 });
-await client.voices.favorite(firstVoiceId);
 await client.voices.updateTags(firstVoiceId, ["narration", "novel=三体"]);
 await client.voices.updateTags(firstVoiceId, []); // Resume owner tag inheritance.
-await client.voices.unfavorite(firstVoiceId);
 await client.voices.delete(saved.voiceId);
 ```
 
@@ -592,6 +590,8 @@ language-to-accent cascade at runtime.
 ```ts
 const models = await client.models.list();
 const balance = await client.account.balance();
+const entitlements = await client.account.entitlements();
+console.log(entitlements.planCode, entitlements.maxConcurrentGenerations);
 const currentKey = (await client.account.currentApiKey()).apiKey;
 console.log(currentKey.status, currentKey.creditRemaining);
 const usage = await client.account.usage({ days: 7 });
@@ -640,9 +640,9 @@ Clone previews automatically generate a short script in the detected reference a
 
 ### HTTP TTS speed
 
-Pass `voiceSettings: { speed: 1.25 }` to control speech speed without changing pitch, from 0.5 to 2.0. Omission always means 1.0; saved voice speed is not inherited. Sync, async and HTTP streaming support this parameter; Realtime does not.
+Pass `voiceSettings: { speed: 1.25 }` to control speech speed without changing pitch, from 0.5 to 2.0. Omission always means 1.0. Sync, async and HTTP streaming support this parameter; Realtime does not.
 
-Pass `voiceSettings: { volume: 1.5 }` to apply a request-level linear amplitude multiplier. Values range from 0.01 to 2.0; omission means 1.0. Values above 1.0 may clip peaks. Sync, async and HTTP streaming support this parameter; it does not change saved voice settings or apply to Realtime.
+Pass `voiceSettings: { volume: 1.5 }` to apply a request-level linear amplitude multiplier. Values range from 0.01 to 2.0; omission means 1.0. Values above 1.0 may clip peaks. Sync, async and HTTP streaming support this parameter; Realtime does not.
 
 ## Word timing
 
@@ -659,3 +659,5 @@ Clone preview creation accepts an omitted name. The server uses the filename ste
 `client.studio` exposes `projects`, `chapters`, `clips`, `tracks`, `instances`, and `files`. Import scripts with existing voice IDs, edit inherited instructions and silence, upload MP3/WAV materials, and arrange background audio. Project writes require the latest edit token and a UUID operation ID. Conflicts preserve error metadata and are not retried automatically.
 
 See the [Studio initialization guide](https://docs.breezeblue.ai/guides/studio-projects) for a complete workflow. Signed uploads use a separate request without the API key. Management operations do not generate speech or export projects.
+
+`client.studio.files.upload(blob, { operationId, name, projectId })` creates the file record, uploads to the signed URL, completes the upload and waits for `ready`; failures reject with `BreezeBlueStudioFileError`. Timeline positions, trims and lengths are 48 kHz frames; use `secondsToFrames` and `framesToSeconds` to convert.

package/dist/client.d.ts

@@ -1,7 +1,7 @@
 import { StudioResource } from "./studio.js";
 import { SpeechTimingStream, type SpeechWithTimestamps } from "./timestamps.js";
 import { AudioResponse } from "./audio.js";
-import type { AudioRequestOptions, BreezeBlueWebSocket, AsyncTextToSpeechJob, Balance, BreezeBlueClientOptions, CurrentApiKeyResponse, GenericStatus, GenerationJob, HistoryItem, HistoryList, HistoryListParams, Model, RequestOptions, RealtimeTextToSpeechConnectOptions, RealtimeTextToSpeechEvent, RealtimeTextToSpeechManagedConnectOptions, RealtimeTextToSpeechMessage, RealtimeTextToSpeechSession, RealtimeTextToSpeechSessionRequest, SavedVoice, SaveVoiceRequest, StreamTextToSpeechOptions, TextToSpeechRequest, TtsEnhanceRequest, TtsEnhanceResponse, Usage, UsageParams, Voice, VoiceClonePreview, VoiceClonePreviewRequest, VoiceDesignRequest, VoiceDesignResponse, VoiceDesignStreamRequest, VoiceEditRequest, VoiceList, VoiceLocalizeJob, VoiceLocalizePreviewRequest, VoiceLocalizePreviewStatus, VoiceRemixPreviewRequest, VoiceRemixPrepareRequest, VoiceRemixPresets, VoiceRemixPreparation, VoiceRemixJob, VoiceRemixPreviewStatus, VoiceMetadataOptions, VoiceRandomParams, VoiceSearchParams, VoiceSettings } from "./types.js";
+import type { AudioRequestOptions, BreezeBlueWebSocket, AsyncTextToSpeechJob, Balance, BreezeBlueClientOptions, CurrentApiKeyResponse, Entitlements, GenericStatus, GenerationJob, HistoryItem, HistoryList, HistoryListParams, Model, RequestOptions, RealtimeTextToSpeechConnectOptions, RealtimeTextToSpeechEvent, RealtimeTextToSpeechManagedConnectOptions, RealtimeTextToSpeechMessage, RealtimeTextToSpeechSession, RealtimeTextToSpeechSessionRequest, SavedVoice, SaveVoiceRequest, StreamTextToSpeechOptions, TextToSpeechRequest, TtsEnhanceRequest, TtsEnhanceResponse, Usage, UsageParams, Voice, VoiceClonePreview, VoiceClonePreviewRequest, VoiceDesignRequest, VoiceDesignResponse, VoiceDesignStreamRequest, VoiceEditRequest, VoiceList, VoiceLocalizeJob, VoiceLocalizePreviewRequest, VoiceLocalizePreviewStatus, VoiceRemixPreviewRequest, VoiceRemixPrepareRequest, VoiceRemixPresets, VoiceRemixPreparation, VoiceRemixJob, VoiceRemixPreviewStatus, VoiceMetadataOptions, VoiceRandomParams, VoiceSearchParams } from "./types.js";
 export declare class BreezeBlueClient {
     readonly apiKey: string | undefined;
     readonly baseUrl: string;
@@ -232,11 +232,7 @@ declare class VoicesResource {
     metadataOptions(options?: RequestOptions): Promise<VoiceMetadataOptions>;
     edit(voiceId: string, request: VoiceEditRequest, options?: RequestOptions): Promise<GenericStatus>;
     updateTags(voiceId: string, tags: string[], options?: RequestOptions): Promise<Voice>;
-    favorite(voiceId: string, options?: RequestOptions): Promise<Voice>;
-    unfavorite(voiceId: string, options?: RequestOptions): Promise<Voice>;
     delete(voiceId: string, options?: RequestOptions): Promise<GenericStatus>;
-    getSettings(voiceId: string, options?: RequestOptions): Promise<Required<VoiceSettings>>;
-    editSettings(voiceId: string, settings: VoiceSettings, options?: RequestOptions): Promise<Required<VoiceSettings>>;
     /**
      * Generate a clone preview from a single audio sample. Returns a
      * `generatedVoiceId`; call {@link savePreview} after the user accepts
@@ -298,6 +294,8 @@ declare class AccountResource {
     private readonly client;
     constructor(client: BreezeBlueClient);
     balance(options?: RequestOptions): Promise<Balance>;
+    /** Return the account's plan, billing period and generation limits. */
+    entitlements(options?: RequestOptions): Promise<Entitlements>;
     /** Return the authenticating API key and its current Key Budget counters. */
     currentApiKey(options?: RequestOptions): Promise<CurrentApiKeyResponse>;
     usage(params?: UsageParams, options?: RequestOptions): Promise<Usage>;

package/dist/client.js

@@ -42,7 +42,9 @@ export class BreezeBlueClient {
         // clientSecret works without one, so missing keys are reported lazily.
         this.apiKey = options.apiKey ?? envApiKey;
         this.baseUrl = normalizeBaseUrl(options.baseUrl ?? envBaseUrl ?? DEFAULT_BASE_URL);
-        this.fetch = options.fetch ?? globalThis.fetch;
+        const fetchImpl = options.fetch;
+        // Call fetch unbound: browsers reject window.fetch invoked with the client as `this`.
+        this.fetch = (input, init) => (fetchImpl ?? globalThis.fetch)(input, init);
         this.webSocket = options.webSocket ?? readGlobalWebSocket();
         this.headers = options.headers;
         this.timeout = options.timeout ?? DEFAULT_TIMEOUT_MS;
@@ -103,6 +105,18 @@ export class BreezeBlueClient {
         return headers;
     }
 }
+function ttsRequest(request) {
+    const { text, modelId, languageCode, instructions, voiceSettings } = request;
+    return {
+        text, modelId, languageCode, instructions,
+        voiceSettings: voiceSettings == null ? voiceSettings : {
+            guidanceScale: voiceSettings.guidanceScale,
+            useSpeakerBoost: voiceSettings.useSpeakerBoost,
+            speed: voiceSettings.speed,
+            volume: voiceSettings.volume,
+        },
+    };
+}
 class TextToSpeechResource {
     client;
     realtime;
@@ -111,26 +125,25 @@ class TextToSpeechResource {
         this.realtime = new RealtimeTextToSpeechResource(client);
     }
     convert(voiceId, request, options = {}) {
-        return this.client.requestAudio("POST", `/v1/text-to-speech/${encodeURIComponent(voiceId)}`, { outputFormat: options.outputFormat }, request, options);
+        return this.client.requestAudio("POST", `/v1/text-to-speech/${encodeURIComponent(voiceId)}`, { outputFormat: options.outputFormat }, ttsRequest(request), options);
     }
     createJob(voiceId, request, options = {}) {
-        return this.client.requestJson("POST", `/v1/text-to-speech/${encodeURIComponent(voiceId)}`, { outputFormat: options.outputFormat, delivery: "async" }, request, options);
+        return this.client.requestJson("POST", `/v1/text-to-speech/${encodeURIComponent(voiceId)}`, { outputFormat: options.outputFormat, delivery: "async" }, ttsRequest(request), options);
     }
     createJobWithTimestamps(voiceId, request, options = {}) {
-        return this.client.requestJson("POST", `/v1/text-to-speech/${encodeURIComponent(voiceId)}/with-timestamps`, { outputFormat: options.outputFormat, delivery: "async" }, request, options);
+        return this.client.requestJson("POST", `/v1/text-to-speech/${encodeURIComponent(voiceId)}/with-timestamps`, { outputFormat: options.outputFormat, delivery: "async" }, ttsRequest(request), options);
     }
     stream(voiceId, request, options = {}) {
         return this.client.requestAudio("POST", `/v1/text-to-speech/${encodeURIComponent(voiceId)}/stream`, {
             outputFormat: options.outputFormat,
-            optimizeStreamingLatency: options.optimizeStreamingLatency,
             enableLogging: options.enableLogging,
-        }, request, options);
+        }, ttsRequest(request), options);
     }
     convertWithTimestamps(voiceId, request, options = {}) {
-        return this.client.requestJson("POST", `/v1/text-to-speech/${encodeURIComponent(voiceId)}/with-timestamps`, { outputFormat: options.outputFormat }, request, options);
+        return this.client.requestJson("POST", `/v1/text-to-speech/${encodeURIComponent(voiceId)}/with-timestamps`, { outputFormat: options.outputFormat }, ttsRequest(request), options);
     }
     async streamWithTimestamps(voiceId, request, options = {}) {
-        const response = await this.client.request("POST", `/v1/text-to-speech/${encodeURIComponent(voiceId)}/stream/with-timestamps`, { outputFormat: options.outputFormat, optimizeStreamingLatency: options.optimizeStreamingLatency, enableLogging: options.enableLogging }, request, options);
+        const response = await this.client.request("POST", `/v1/text-to-speech/${encodeURIComponent(voiceId)}/stream/with-timestamps`, { outputFormat: options.outputFormat, enableLogging: options.enableLogging }, { ...ttsRequest(request), timestampMode: request.timestampMode }, options);
         return new SpeechTimingStream(response);
     }
     enhance(request, options) {
@@ -143,7 +156,14 @@ class RealtimeTextToSpeechResource {
         this.client = client;
     }
     createSession(voiceId, request = {}, options) {
-        return this.client.requestJson("POST", `/v1/text-to-speech/${encodeURIComponent(voiceId)}/realtime-sessions`, undefined, request, options);
+        return this.client.requestJson("POST", `/v1/text-to-speech/${encodeURIComponent(voiceId)}/realtime-sessions`, undefined, {
+            modelId: request.modelId,
+            languageCode: request.languageCode,
+            instructions: request.instructions,
+            voiceSettings: request.voiceSettings == null ? request.voiceSettings : { guidanceScale: request.voiceSettings.guidanceScale, useSpeakerBoost: request.voiceSettings.useSpeakerBoost },
+            inactivityTimeoutSeconds: request.inactivityTimeoutSeconds,
+            enableLogging: request.enableLogging,
+        }, options);
     }
     async connect(voiceId, options = {}) {
         if ((options.clientSecret !== undefined ||
@@ -1541,24 +1561,9 @@ class VoicesResource {
         const result = await this.client.requestJson("PUT", `/v1/voices/${encodeURIComponent(voiceId)}/tags`, undefined, { tags }, options);
         return stripHiddenVoiceFields(result);
     }
-    async favorite(voiceId, options) {
-        const result = await this.client.requestJson("PUT", `/v1/voices/${encodeURIComponent(voiceId)}/favorite`, undefined, undefined, options);
-        return stripHiddenVoiceFields(result);
-    }
-    async unfavorite(voiceId, options) {
-        const result = await this.client.requestJson("DELETE", `/v1/voices/${encodeURIComponent(voiceId)}/favorite`, undefined, undefined, options);
-        return stripHiddenVoiceFields(result);
-    }
     delete(voiceId, options) {
         return this.client.requestJson("DELETE", `/v1/voices/${encodeURIComponent(voiceId)}`, undefined, undefined, options);
     }
-    // -- voice settings ---------------------------------------------------
-    getSettings(voiceId, options) {
-        return this.client.requestJson("GET", `/v1/voices/${encodeURIComponent(voiceId)}/settings`, undefined, undefined, options);
-    }
-    editSettings(voiceId, settings, options) {
-        return this.client.requestJson("PATCH", `/v1/voices/${encodeURIComponent(voiceId)}/settings`, undefined, settings, options);
-    }
     // -- two-step preview → save flow -------------------------------------
     /**
      * Generate a clone preview from a single audio sample. Returns a
@@ -1574,14 +1579,16 @@ class VoicesResource {
      * {@link savePreview}.
      */
     createDesignPreview(request, options = {}) {
-        return this.client.requestJson("POST", "/v1/voice-previews/design", { outputFormat: options.outputFormat }, request, options);
+        const { voiceDescription, text, modelId, languageCode, guidanceScale, previewCount } = request;
+        return this.client.requestJson("POST", "/v1/voice-previews/design", { outputFormat: options.outputFormat }, { voiceDescription, text, modelId, languageCode, guidanceScale, previewCount }, options);
     }
     /**
      * Generate exactly one voice design preview as live 24 kHz mono PCM.
      * A clean end means `generatedVoiceId` is ready for {@link savePreview}.
      */
     streamDesignPreview(request, options) {
-        return this.client.requestAudio("POST", "/v1/voice-previews/design/stream", undefined, request, options);
+        return this.client.requestAudio("POST", "/v1/voice-previews/design/stream", undefined, { voiceDescription: request.voiceDescription, text: request.text, modelId: request.modelId,
+            languageCode: request.languageCode, guidanceScale: request.guidanceScale }, options);
     }
     /** List curated voice changes and their sample recordings. */
     listRemixPresets(options) {
@@ -1629,7 +1636,6 @@ class VoicesResource {
             tags: request.tags,
             primaryCategoryCode: request.primaryCategoryCode,
             visibility: request.visibility,
-            playedNotSelectedVoiceIds: request.playedNotSelectedVoiceIds,
             languageCode: request.languageCode,
             gender: request.gender,
             age: request.age,
@@ -1674,6 +1680,10 @@ class AccountResource {
     balance(options) {
         return this.client.requestJson("GET", "/v1/balance", undefined, undefined, options);
     }
+    /** Return the account's plan, billing period and generation limits. */
+    entitlements(options) {
+        return this.client.requestJson("GET", "/v1/entitlements", undefined, undefined, options);
+    }
     /** Return the authenticating API key and its current Key Budget counters. */
     currentApiKey(options) {
         return this.client.requestJson("GET", "/v1/api-keys/current", undefined, undefined, options);
@@ -1776,17 +1786,10 @@ function clonePreviewForm(request) {
     if (request.name != null && typeof request.name !== "string") {
         throw new BreezeBlueConfigurationError("Clone name must be a string or null.");
     }
-    if (request.removeBackgroundNoise) {
-        throw new BreezeBlueConfigurationError("removeBackgroundNoise is not supported by the Breeze Developer API.");
-    }
-    for (const field of ["text", "instructions", "languageCode", "previewLanguageCode"]) {
-        if (field in request) {
-            throw new BreezeBlueConfigurationError(`Clone previews do not accept ${field}; the script and language are generated automatically.`);
-        }
-    }
     const form = new FormData();
     appendOptional(form, "name", request.name ?? undefined);
     appendOptional(form, "description", request.description);
+    appendOptional(form, "remove_background_noise", request.removeBackgroundNoise ?? false);
     for (const file of normalizeFiles(request.file, request.files, { required: true })) {
         appendFile(form, "files", file);
     }

package/dist/errors.d.ts

@@ -1,3 +1,4 @@
+import type { StudioFileView } from "./studio-types.js";
 export interface BreezeBlueErrorPayload {
     ok?: false;
     code?: string;
@@ -37,6 +38,15 @@ export declare class BreezeBlueRealtimeError extends BreezeBlueError {
         cause?: unknown;
     });
 }
+/**
+ * A Studio file upload or processing step failed. `file` holds the latest
+ * file record; inspect `status`, `errorCode` and `errorMessage`, then retry
+ * processing or upload again.
+ */
+export declare class BreezeBlueStudioFileError extends BreezeBlueError {
+    readonly file: StudioFileView;
+    constructor(message: string, file: StudioFileView);
+}
 export declare class BreezeBlueAPIError extends BreezeBlueError {
     readonly status: number;
     readonly code: string;

package/dist/errors.js

@@ -33,6 +33,18 @@ export class BreezeBlueRealtimeError extends BreezeBlueError {
         this.recoverable = params.recoverable ?? false;
     }
 }
+/**
+ * A Studio file upload or processing step failed. `file` holds the latest
+ * file record; inspect `status`, `errorCode` and `errorMessage`, then retry
+ * processing or upload again.
+ */
+export class BreezeBlueStudioFileError extends BreezeBlueError {
+    file;
+    constructor(message, file) {
+        super(message);
+        this.file = file;
+    }
+}
 export class BreezeBlueAPIError extends BreezeBlueError {
     status;
     code;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { AudioResponse } from "./audio.js";
-export { BreezeBlueAPIError, BreezeBlueAuthenticationError, BreezeBlueBadRequestError, BreezeBlueConfigurationError, BreezeBlueConflictError, BreezeBlueError, BreezeBlueForbiddenError, BreezeBlueGenerationNotReadyError, BreezeBlueInsufficientCreditsError, BreezeBlueNotFoundError, BreezeBlueRateLimitError, BreezeBlueRealtimeError, BreezeBlueServiceUnavailableError, BreezeBlueUpstreamError, BreezeBlueValidationError, } from "./errors.js";
+export { BreezeBlueAPIError, BreezeBlueAuthenticationError, BreezeBlueBadRequestError, BreezeBlueConfigurationError, BreezeBlueConflictError, BreezeBlueError, BreezeBlueForbiddenError, BreezeBlueGenerationNotReadyError, BreezeBlueInsufficientCreditsError, BreezeBlueNotFoundError, BreezeBlueRateLimitError, BreezeBlueRealtimeError, BreezeBlueServiceUnavailableError, BreezeBlueStudioFileError, BreezeBlueUpstreamError, BreezeBlueValidationError, } from "./errors.js";
 export { BreezeBlueClient, ManagedRealtimeTextToSpeechConnection, RealtimeTextToSpeechConnection, } from "./client.js";
 export { SDK_NAME, SDK_VERSION } from "./version.js";
 export type * from "./types.js";

package/dist/index.js

@@ -1,5 +1,5 @@
 export { AudioResponse } from "./audio.js";
-export { BreezeBlueAPIError, BreezeBlueAuthenticationError, BreezeBlueBadRequestError, BreezeBlueConfigurationError, BreezeBlueConflictError, BreezeBlueError, BreezeBlueForbiddenError, BreezeBlueGenerationNotReadyError, BreezeBlueInsufficientCreditsError, BreezeBlueNotFoundError, BreezeBlueRateLimitError, BreezeBlueRealtimeError, BreezeBlueServiceUnavailableError, BreezeBlueUpstreamError, BreezeBlueValidationError, } from "./errors.js";
+export { BreezeBlueAPIError, BreezeBlueAuthenticationError, BreezeBlueBadRequestError, BreezeBlueConfigurationError, BreezeBlueConflictError, BreezeBlueError, BreezeBlueForbiddenError, BreezeBlueGenerationNotReadyError, BreezeBlueInsufficientCreditsError, BreezeBlueNotFoundError, BreezeBlueRateLimitError, BreezeBlueRealtimeError, BreezeBlueServiceUnavailableError, BreezeBlueStudioFileError, BreezeBlueUpstreamError, BreezeBlueValidationError, } from "./errors.js";
 export { BreezeBlueClient, ManagedRealtimeTextToSpeechConnection, RealtimeTextToSpeechConnection, } from "./client.js";
 export { SDK_NAME, SDK_VERSION } from "./version.js";
 export * from "./voice-metadata.js";

package/dist/studio-types.d.ts

@@ -117,15 +117,15 @@ export interface StudioClipView {
     instructions: string;
     voiceId: string | null;
     voice: StudioVoiceSummary | null;
-    playback: StudioPlayback;
+    playback: StudioPlaybackView;
     trailingSilenceMs: number | null;
     effectiveInstructions: string;
     effectiveTrailingSilenceMs: number;
     version: number;
 }
 export interface StudioDeleted {
-    deleted?: boolean;
-    editToken?: string | null;
+    deleted: boolean;
+    editToken: string | null;
 }
 export interface StudioEdit {
     expectedEditToken: string;
@@ -160,7 +160,7 @@ export interface StudioFileView {
     projectId: string | null;
     name: string;
     revision: number;
-    status: string;
+    status: StudioFileStatus;
     frames: number | null;
     sampleRate: number;
     sizeBytes: number | null;
@@ -210,11 +210,16 @@ export interface StudioInstanceView {
     trimStart: number;
     trimEnd: number;
     effects: StudioEffects;
-    length?: number | null;
-    phase?: number;
-    envelopeOffset?: number;
-    envelopeLength?: number | null;
-    issues?: Array<string>;
+    length: number | null;
+    phase: number;
+    envelopeOffset: number;
+    envelopeLength: number | null;
+    issues: Array<string>;
+}
+export type StudioFileStatus = "uploading" | "queued" | "running" | "ready" | "failed";
+export interface StudioPlaybackView {
+    speed: number;
+    volume: number;
 }
 export interface StudioPlayback {
     speed?: number;
@@ -265,16 +270,16 @@ export interface StudioProjectPatch {
 export interface StudioProjectResult {
     project: StudioProjectView;
     editToken: string;
-    clientRefs?: Record<string, string>;
-    createdIds?: Array<string>;
+    clientRefs: Record<string, string>;
+    createdIds: Array<string>;
 }
 export interface StudioProjectView {
-    title?: string;
-    description?: string;
-    ttsSettings?: StudioTtsSettings | null;
-    defaultVoiceId?: string | null;
-    defaultInstructions?: string;
-    defaultSilenceMs?: number;
+    title: string;
+    description: string;
+    ttsSettings: StudioTtsSettings | null;
+    defaultVoiceId: string | null;
+    defaultInstructions: string;
+    defaultSilenceMs: number;
     id: string;
     editToken: string;
     createdAt: string;
@@ -314,11 +319,11 @@ export interface StudioTrackResult {
 export interface StudioTrackView {
     id: string;
     name: string;
-    chapterId?: string | null;
-    volume?: number;
-    muted?: boolean;
-    readonly?: boolean;
-    instances?: Array<StudioInstanceView>;
+    chapterId: string | null;
+    volume: number;
+    muted: boolean;
+    readonly: boolean;
+    instances: Array<StudioInstanceView>;
 }
 export interface StudioTtsSettings {
     model?: string | null;
@@ -328,10 +333,39 @@ export interface StudioTtsSettings {
 }
 export interface StudioUploadResult {
     uploadUrl: string;
-    headers?: Record<string, string>;
+    headers: Record<string, string>;
+    expiresIn: number;
 }
 export interface StudioVoiceSummary {
     id: string;
     name: string;
     available: boolean;
 }
+/** Query parameters accepted by Studio endpoints; list methods document their named filters. */
+export type StudioQueryParams = Record<string, string | number | boolean | undefined>;
+export interface StudioProjectListParams extends StudioQueryParams {
+    /** Case-insensitive title filter. */
+    q?: string;
+    page?: number;
+    /** Defaults to 50; maximum 100. */
+    pageSize?: number;
+}
+export interface StudioChapterListParams extends StudioQueryParams {
+    includeDeleted?: boolean;
+}
+export interface StudioClipListParams extends StudioQueryParams {
+    chapterId?: string;
+    includeDeleted?: boolean;
+    page?: number;
+    /** Defaults to 100; maximum 400. */
+    pageSize?: number;
+}
+export interface StudioFileListParams extends StudioQueryParams {
+    /** Omit to list personal files. */
+    projectId?: string;
+    /** Case-insensitive name filter. */
+    q?: string;
+    offset?: number;
+    /** Defaults to 100; maximum 500. Continue with `nextOffset`. */
+    limit?: number;
+}

package/dist/studio.d.ts

@@ -1,83 +1,174 @@
 import type { BreezeBlueClient } from "./client.js";
 import type { RequestOptions } from "./types.js";
 import type * as Types from "./studio-types.js";
+/** Convert seconds to 48 kHz Studio timeline frames, rounding half away from zero. */
 export declare function secondsToFrames(seconds: number): number;
+/** Convert 48 kHz Studio timeline frames to seconds. */
 export declare function framesToSeconds(frames: number): number;
 export declare class StudioProjectsResource {
     private client;
     constructor(client: BreezeBlueClient);
-    list(params?: Record<string, string | number | boolean | undefined>, options?: RequestOptions): Promise<Types.StudioProjectList>;
-    create(body: Types.StudioProjectCreate, params?: Record<string, string | number | boolean | undefined>, options?: RequestOptions): Promise<Types.StudioProjectResult>;
-    importProject(body: Types.StudioProjectImport, params?: Record<string, string | number | boolean | undefined>, options?: RequestOptions): Promise<Types.StudioProjectResult>;
-    get(projectId: string, params?: Record<string, string | number | boolean | undefined>, options?: RequestOptions): Promise<Types.StudioProjectResult>;
-    update(projectId: string, body: Types.StudioProjectPatch, params?: Record<string, string | number | boolean | undefined>, options?: RequestOptions): Promise<Types.StudioProjectResult>;
-    delete(projectId: string, body: Types.StudioEdit, params?: Record<string, string | number | boolean | undefined>, options?: RequestOptions): Promise<Types.StudioDeleted>;
+    list(params?: Types.StudioProjectListParams, options?: RequestOptions): Promise<Types.StudioProjectList>;
+    create(body: Types.StudioProjectCreate, options?: RequestOptions): Promise<Types.StudioProjectResult>;
+    /** @deprecated This endpoint takes no query parameters; pass request options as the last argument. */
+    create(body: Types.StudioProjectCreate, params: Types.StudioQueryParams | undefined, options?: RequestOptions): Promise<Types.StudioProjectResult>;
+    importProject(body: Types.StudioProjectImport, options?: RequestOptions): Promise<Types.StudioProjectResult>;
+    /** @deprecated This endpoint takes no query parameters; pass request options as the last argument. */
+    importProject(body: Types.StudioProjectImport, params: Types.StudioQueryParams | undefined, options?: RequestOptions): Promise<Types.StudioProjectResult>;
+    get(projectId: string, options?: RequestOptions): Promise<Types.StudioProjectResult>;
+    /** @deprecated This endpoint takes no query parameters; pass request options as the last argument. */
+    get(projectId: string, params: Types.StudioQueryParams | undefined, options?: RequestOptions): Promise<Types.StudioProjectResult>;
+    update(projectId: string, body: Types.StudioProjectPatch, options?: RequestOptions): Promise<Types.StudioProjectResult>;
+    /** @deprecated This endpoint takes no query parameters; pass request options as the last argument. */
+    update(projectId: string, body: Types.StudioProjectPatch, params: Types.StudioQueryParams | undefined, options?: RequestOptions): Promise<Types.StudioProjectResult>;
+    delete(projectId: string, body: Types.StudioEdit, options?: RequestOptions): Promise<Types.StudioDeleted>;
+    /** @deprecated This endpoint takes no query parameters; pass request options as the last argument. */
+    delete(projectId: string, body: Types.StudioEdit, params: Types.StudioQueryParams | undefined, options?: RequestOptions): Promise<Types.StudioDeleted>;
 }
 export declare class StudioChaptersResource {
     private client;
     constructor(client: BreezeBlueClient);
-    list(projectId: string, params?: Record<string, string | number | boolean | undefined>, options?: RequestOptions): Promise<Types.StudioChapterList>;
-    create(projectId: string, body: Types.StudioChapterCreate, params?: Record<string, string | number | boolean | undefined>, options?: RequestOptions): Promise<Types.StudioProjectResult>;
-    reorder(projectId: string, body: Types.StudioReorder, params?: Record<string, string | number | boolean | undefined>, options?: RequestOptions): Promise<Types.StudioProjectResult>;
-    get(projectId: string, chapterId: string, params?: Record<string, string | number | boolean | undefined>, options?: RequestOptions): Promise<Types.StudioChapterResult>;
-    update(projectId: string, chapterId: string, body: Types.StudioChapterPatch, params?: Record<string, string | number | boolean | undefined>, options?: RequestOptions): Promise<Types.StudioProjectResult>;
-    delete(projectId: string, chapterId: string, body: Types.StudioChapterDelete, params?: Record<string, string | number | boolean | undefined>, options?: RequestOptions): Promise<Types.StudioProjectResult>;
-    restore(projectId: string, chapterId: string, body: Types.StudioEdit, params?: Record<string, string | number | boolean | undefined>, options?: RequestOptions): Promise<Types.StudioProjectResult>;
+    list(projectId: string, params?: Types.StudioChapterListParams, options?: RequestOptions): Promise<Types.StudioChapterList>;
+    create(projectId: string, body: Types.StudioChapterCreate, options?: RequestOptions): Promise<Types.StudioProjectResult>;
+    /** @deprecated This endpoint takes no query parameters; pass request options as the last argument. */
+    create(projectId: string, body: Types.StudioChapterCreate, params: Types.StudioQueryParams | undefined, options?: RequestOptions): Promise<Types.StudioProjectResult>;
+    reorder(projectId: string, body: Types.StudioReorder, options?: RequestOptions): Promise<Types.StudioProjectResult>;
+    /** @deprecated This endpoint takes no query parameters; pass request options as the last argument. */
+    reorder(projectId: string, body: Types.StudioReorder, params: Types.StudioQueryParams | undefined, options?: RequestOptions): Promise<Types.StudioProjectResult>;
+    get(projectId: string, chapterId: string, options?: RequestOptions): Promise<Types.StudioChapterResult>;
+    /** @deprecated This endpoint takes no query parameters; pass request options as the last argument. */
+    get(projectId: string, chapterId: string, params: Types.StudioQueryParams | undefined, options?: RequestOptions): Promise<Types.StudioChapterResult>;
+    update(projectId: string, chapterId: string, body: Types.StudioChapterPatch, options?: RequestOptions): Promise<Types.StudioProjectResult>;
+    /** @deprecated This endpoint takes no query parameters; pass request options as the last argument. */
+    update(projectId: string, chapterId: string, body: Types.StudioChapterPatch, params: Types.StudioQueryParams | undefined, options?: RequestOptions): Promise<Types.StudioProjectResult>;
+    delete(projectId: string, chapterId: string, body: Types.StudioChapterDelete, options?: RequestOptions): Promise<Types.StudioProjectResult>;
+    /** @deprecated This endpoint takes no query parameters; pass request options as the last argument. */
+    delete(projectId: string, chapterId: string, body: Types.StudioChapterDelete, params: Types.StudioQueryParams | undefined, options?: RequestOptions): Promise<Types.StudioProjectResult>;
+    restore(projectId: string, chapterId: string, body: Types.StudioEdit, options?: RequestOptions): Promise<Types.StudioProjectResult>;
+    /** @deprecated This endpoint takes no query parameters; pass request options as the last argument. */
+    restore(projectId: string, chapterId: string, body: Types.StudioEdit, params: Types.StudioQueryParams | undefined, options?: RequestOptions): Promise<Types.StudioProjectResult>;
 }
 export declare class StudioClipsResource {
     private client;
     constructor(client: BreezeBlueClient);
-    list(projectId: string, params?: Record<string, string | number | boolean | undefined>, options?: RequestOptions): Promise<Types.StudioClipList>;
-    create(projectId: string, body: Types.StudioClipCreate, params?: Record<string, string | number | boolean | undefined>, options?: RequestOptions): Promise<Types.StudioProjectResult>;
-    batchCreate(projectId: string, body: Types.StudioClipBatchCreate, params?: Record<string, string | number | boolean | undefined>, options?: RequestOptions): Promise<Types.StudioProjectResult>;
-    batchUpdate(projectId: string, body: Types.StudioClipBatchPatch, params?: Record<string, string | number | boolean | undefined>, options?: RequestOptions): Promise<Types.StudioProjectResult>;
-    bulkDelete(projectId: string, body: Types.StudioClipBulkDelete, params?: Record<string, string | number | boolean | undefined>, options?: RequestOptions): Promise<Types.StudioProjectResult>;
-    reorder(projectId: string, body: Types.StudioClipReorder, params?: Record<string, string | number | boolean | undefined>, options?: RequestOptions): Promise<Types.StudioProjectResult>;
-    move(projectId: string, body: Types.StudioClipMove, params?: Record<string, string | number | boolean | undefined>, options?: RequestOptions): Promise<Types.StudioProjectResult>;
-    get(projectId: string, clipId: string, params?: Record<string, string | number | boolean | undefined>, options?: RequestOptions): Promise<Types.StudioClipResult>;
-    update(projectId: string, clipId: string, body: Types.StudioClipPatch, params?: Record<string, string | number | boolean | undefined>, options?: RequestOptions): Promise<Types.StudioProjectResult>;
-    delete(projectId: string, clipId: string, body: Types.StudioEdit, params?: Record<string, string | number | boolean | undefined>, options?: RequestOptions): Promise<Types.StudioProjectResult>;
+    list(projectId: string, params?: Types.StudioClipListParams, options?: RequestOptions): Promise<Types.StudioClipList>;
+    create(projectId: string, body: Types.StudioClipCreate, options?: RequestOptions): Promise<Types.StudioProjectResult>;
+    /** @deprecated This endpoint takes no query parameters; pass request options as the last argument. */
+    create(projectId: string, body: Types.StudioClipCreate, params: Types.StudioQueryParams | undefined, options?: RequestOptions): Promise<Types.StudioProjectResult>;
+    batchCreate(projectId: string, body: Types.StudioClipBatchCreate, options?: RequestOptions): Promise<Types.StudioProjectResult>;
+    /** @deprecated This endpoint takes no query parameters; pass request options as the last argument. */
+    batchCreate(projectId: string, body: Types.StudioClipBatchCreate, params: Types.StudioQueryParams | undefined, options?: RequestOptions): Promise<Types.StudioProjectResult>;
+    batchUpdate(projectId: string, body: Types.StudioClipBatchPatch, options?: RequestOptions): Promise<Types.StudioProjectResult>;
+    /** @deprecated This endpoint takes no query parameters; pass request options as the last argument. */
+    batchUpdate(projectId: string, body: Types.StudioClipBatchPatch, params: Types.StudioQueryParams | undefined, options?: RequestOptions): Promise<Types.StudioProjectResult>;
+    bulkDelete(projectId: string, body: Types.StudioClipBulkDelete, options?: RequestOptions): Promise<Types.StudioProjectResult>;
+    /** @deprecated This endpoint takes no query parameters; pass request options as the last argument. */
+    bulkDelete(projectId: string, body: Types.StudioClipBulkDelete, params: Types.StudioQueryParams | undefined, options?: RequestOptions): Promise<Types.StudioProjectResult>;
+    reorder(projectId: string, body: Types.StudioClipReorder, options?: RequestOptions): Promise<Types.StudioProjectResult>;
+    /** @deprecated This endpoint takes no query parameters; pass request options as the last argument. */
+    reorder(projectId: string, body: Types.StudioClipReorder, params: Types.StudioQueryParams | undefined, options?: RequestOptions): Promise<Types.StudioProjectResult>;
+    move(projectId: string, body: Types.StudioClipMove, options?: RequestOptions): Promise<Types.StudioProjectResult>;
+    /** @deprecated This endpoint takes no query parameters; pass request options as the last argument. */
+    move(projectId: string, body: Types.StudioClipMove, params: Types.StudioQueryParams | undefined, options?: RequestOptions): Promise<Types.StudioProjectResult>;
+    get(projectId: string, clipId: string, options?: RequestOptions): Promise<Types.StudioClipResult>;
+    /** @deprecated This endpoint takes no query parameters; pass request options as the last argument. */
+    get(projectId: string, clipId: string, params: Types.StudioQueryParams | undefined, options?: RequestOptions): Promise<Types.StudioClipResult>;
+    update(projectId: string, clipId: string, body: Types.StudioClipPatch, options?: RequestOptions): Promise<Types.StudioProjectResult>;
+    /** @deprecated This endpoint takes no query parameters; pass request options as the last argument. */
+    update(projectId: string, clipId: string, body: Types.StudioClipPatch, params: Types.StudioQueryParams | undefined, options?: RequestOptions): Promise<Types.StudioProjectResult>;
+    delete(projectId: string, clipId: string, body: Types.StudioEdit, options?: RequestOptions): Promise<Types.StudioProjectResult>;
+    /** @deprecated This endpoint takes no query parameters; pass request options as the last argument. */
+    delete(projectId: string, clipId: string, body: Types.StudioEdit, params: Types.StudioQueryParams | undefined, options?: RequestOptions): Promise<Types.StudioProjectResult>;
 }
 export declare class StudioTracksResource {
     private client;
     constructor(client: BreezeBlueClient);
-    list(projectId: string, params?: Record<string, string | number | boolean | undefined>, options?: RequestOptions): Promise<Types.StudioTrackList>;
-    create(projectId: string, body: Types.StudioTrackCreate, params?: Record<string, string | number | boolean | undefined>, options?: RequestOptions): Promise<Types.StudioProjectResult>;
-    reorder(projectId: string, body: Types.StudioReorder, params?: Record<string, string | number | boolean | undefined>, options?: RequestOptions): Promise<Types.StudioProjectResult>;
-    get(projectId: string, trackId: string, params?: Record<string, string | number | boolean | undefined>, options?: RequestOptions): Promise<Types.StudioTrackResult>;
-    update(projectId: string, trackId: string, body: Types.StudioTrackPatch, params?: Record<string, string | number | boolean | undefined>, options?: RequestOptions): Promise<Types.StudioProjectResult>;
-    delete(projectId: string, trackId: string, body: Types.StudioEdit, params?: Record<string, string | number | boolean | undefined>, options?: RequestOptions): Promise<Types.StudioProjectResult>;
+    list(projectId: string, options?: RequestOptions): Promise<Types.StudioTrackList>;
+    /** @deprecated This endpoint takes no query parameters; pass request options as the last argument. */
+    list(projectId: string, params: Types.StudioQueryParams | undefined, options?: RequestOptions): Promise<Types.StudioTrackList>;
+    create(projectId: string, body: Types.StudioTrackCreate, options?: RequestOptions): Promise<Types.StudioProjectResult>;
+    /** @deprecated This endpoint takes no query parameters; pass request options as the last argument. */
+    create(projectId: string, body: Types.StudioTrackCreate, params: Types.StudioQueryParams | undefined, options?: RequestOptions): Promise<Types.StudioProjectResult>;
+    reorder(projectId: string, body: Types.StudioReorder, options?: RequestOptions): Promise<Types.StudioProjectResult>;
+    /** @deprecated This endpoint takes no query parameters; pass request options as the last argument. */
+    reorder(projectId: string, body: Types.StudioReorder, params: Types.StudioQueryParams | undefined, options?: RequestOptions): Promise<Types.StudioProjectResult>;
+    get(projectId: string, trackId: string, options?: RequestOptions): Promise<Types.StudioTrackResult>;
+    /** @deprecated This endpoint takes no query parameters; pass request options as the last argument. */
+    get(projectId: string, trackId: string, params: Types.StudioQueryParams | undefined, options?: RequestOptions): Promise<Types.StudioTrackResult>;
+    update(projectId: string, trackId: string, body: Types.StudioTrackPatch, options?: RequestOptions): Promise<Types.StudioProjectResult>;
+    /** @deprecated This endpoint takes no query parameters; pass request options as the last argument. */
+    update(projectId: string, trackId: string, body: Types.StudioTrackPatch, params: Types.StudioQueryParams | undefined, options?: RequestOptions): Promise<Types.StudioProjectResult>;
+    delete(projectId: string, trackId: string, body: Types.StudioEdit, options?: RequestOptions): Promise<Types.StudioProjectResult>;
+    /** @deprecated This endpoint takes no query parameters; pass request options as the last argument. */
+    delete(projectId: string, trackId: string, body: Types.StudioEdit, params: Types.StudioQueryParams | undefined, options?: RequestOptions): Promise<Types.StudioProjectResult>;
 }
 export declare class StudioInstancesResource {
     private client;
     constructor(client: BreezeBlueClient);
-    list(projectId: string, trackId: string, params?: Record<string, string | number | boolean | undefined>, options?: RequestOptions): Promise<Types.StudioInstanceList>;
-    create(projectId: string, trackId: string, body: Types.StudioInstanceCreate, params?: Record<string, string | number | boolean | undefined>, options?: RequestOptions): Promise<Types.StudioProjectResult>;
-    get(projectId: string, trackId: string, instanceId: string, params?: Record<string, string | number | boolean | undefined>, options?: RequestOptions): Promise<Types.StudioInstanceResult>;
-    update(projectId: string, trackId: string, instanceId: string, body: Types.StudioInstancePatch, params?: Record<string, string | number | boolean | undefined>, options?: RequestOptions): Promise<Types.StudioProjectResult>;
-    delete(projectId: string, trackId: string, instanceId: string, body: Types.StudioEdit, params?: Record<string, string | number | boolean | undefined>, options?: RequestOptions): Promise<Types.StudioProjectResult>;
+    list(projectId: string, trackId: string, options?: RequestOptions): Promise<Types.StudioInstanceList>;
+    /** @deprecated This endpoint takes no query parameters; pass request options as the last argument. */
+    list(projectId: string, trackId: string, params: Types.StudioQueryParams | undefined, options?: RequestOptions): Promise<Types.StudioInstanceList>;
+    create(projectId: string, trackId: string, body: Types.StudioInstanceCreate, options?: RequestOptions): Promise<Types.StudioProjectResult>;
+    /** @deprecated This endpoint takes no query parameters; pass request options as the last argument. */
+    create(projectId: string, trackId: string, body: Types.StudioInstanceCreate, params: Types.StudioQueryParams | undefined, options?: RequestOptions): Promise<Types.StudioProjectResult>;
+    get(projectId: string, trackId: string, instanceId: string, options?: RequestOptions): Promise<Types.StudioInstanceResult>;
+    /** @deprecated This endpoint takes no query parameters; pass request options as the last argument. */
+    get(projectId: string, trackId: string, instanceId: string, params: Types.StudioQueryParams | undefined, options?: RequestOptions): Promise<Types.StudioInstanceResult>;
+    update(projectId: string, trackId: string, instanceId: string, body: Types.StudioInstancePatch, options?: RequestOptions): Promise<Types.StudioProjectResult>;
+    /** @deprecated This endpoint takes no query parameters; pass request options as the last argument. */
+    update(projectId: string, trackId: string, instanceId: string, body: Types.StudioInstancePatch, params: Types.StudioQueryParams | undefined, options?: RequestOptions): Promise<Types.StudioProjectResult>;
+    delete(projectId: string, trackId: string, instanceId: string, body: Types.StudioEdit, options?: RequestOptions): Promise<Types.StudioProjectResult>;
+    /** @deprecated This endpoint takes no query parameters; pass request options as the last argument. */
+    delete(projectId: string, trackId: string, instanceId: string, body: Types.StudioEdit, params: Types.StudioQueryParams | undefined, options?: RequestOptions): Promise<Types.StudioProjectResult>;
 }
+/**
+ * Studio audio materials (MP3 or WAV). `upload` runs the whole flow:
+ * `create` → `uploadUrl` → signed PUT → `complete` → `waitReady`.
+ */
 export declare class StudioFilesResource {
     private client;
     constructor(client: BreezeBlueClient);
-    list(params?: Record<string, string | number | boolean | undefined>, options?: RequestOptions): Promise<Types.StudioFileList>;
-    create(body: Types.StudioFileCreate, params?: Record<string, string | number | boolean | undefined>, options?: RequestOptions): Promise<Types.StudioFileView>;
-    get(fileId: string, params?: Record<string, string | number | boolean | undefined>, options?: RequestOptions): Promise<Types.StudioFileView>;
-    update(fileId: string, body: Types.StudioFilePatch, params?: Record<string, string | number | boolean | undefined>, options?: RequestOptions): Promise<Types.StudioFileView>;
-    delete(fileId: string, body: Types.StudioFileDelete, params?: Record<string, string | number | boolean | undefined>, options?: RequestOptions): Promise<Types.StudioDeleted>;
-    uploadUrl(fileId: string, params?: Record<string, string | number | boolean | undefined>, options?: RequestOptions): Promise<Types.StudioUploadResult>;
-    complete(fileId: string, params?: Record<string, string | number | boolean | undefined>, options?: RequestOptions): Promise<Types.StudioFileView>;
-    retry(fileId: string, params?: Record<string, string | number | boolean | undefined>, options?: RequestOptions): Promise<Types.StudioFileView>;
+    list(params?: Types.StudioFileListParams, options?: RequestOptions): Promise<Types.StudioFileList>;
+    create(body: Types.StudioFileCreate, options?: RequestOptions): Promise<Types.StudioFileView>;
+    /** @deprecated This endpoint takes no query parameters; pass request options as the last argument. */
+    create(body: Types.StudioFileCreate, params: Types.StudioQueryParams | undefined, options?: RequestOptions): Promise<Types.StudioFileView>;
+    get(fileId: string, options?: RequestOptions): Promise<Types.StudioFileView>;
+    /** @deprecated This endpoint takes no query parameters; pass request options as the last argument. */
+    get(fileId: string, params: Types.StudioQueryParams | undefined, options?: RequestOptions): Promise<Types.StudioFileView>;
+    update(fileId: string, body: Types.StudioFilePatch, options?: RequestOptions): Promise<Types.StudioFileView>;
+    /** @deprecated This endpoint takes no query parameters; pass request options as the last argument. */
+    update(fileId: string, body: Types.StudioFilePatch, params: Types.StudioQueryParams | undefined, options?: RequestOptions): Promise<Types.StudioFileView>;
+    delete(fileId: string, body: Types.StudioFileDelete, options?: RequestOptions): Promise<Types.StudioDeleted>;
+    /** @deprecated This endpoint takes no query parameters; pass request options as the last argument. */
+    delete(fileId: string, body: Types.StudioFileDelete, params: Types.StudioQueryParams | undefined, options?: RequestOptions): Promise<Types.StudioDeleted>;
+    uploadUrl(fileId: string, options?: RequestOptions): Promise<Types.StudioUploadResult>;
+    /** @deprecated This endpoint takes no query parameters; pass request options as the last argument. */
+    uploadUrl(fileId: string, params: Types.StudioQueryParams | undefined, options?: RequestOptions): Promise<Types.StudioUploadResult>;
+    complete(fileId: string, options?: RequestOptions): Promise<Types.StudioFileView>;
+    /** @deprecated This endpoint takes no query parameters; pass request options as the last argument. */
+    complete(fileId: string, params: Types.StudioQueryParams | undefined, options?: RequestOptions): Promise<Types.StudioFileView>;
+    retry(fileId: string, options?: RequestOptions): Promise<Types.StudioFileView>;
+    /** @deprecated This endpoint takes no query parameters; pass request options as the last argument. */
+    retry(fileId: string, params: Types.StudioQueryParams | undefined, options?: RequestOptions): Promise<Types.StudioFileView>;
+    /**
+     * Poll until the file is `ready`. Rejects with `BreezeBlueStudioFileError`
+     * when processing fails or is still running after `timeout` milliseconds.
+     */
     waitReady(fileId: string, options?: {
         timeout?: number;
         pollInterval?: number;
         signal?: AbortSignal;
     }): Promise<Types.StudioFileView>;
+    /**
+     * Upload an MP3 or WAV blob and, unless `wait` is false, wait until it is ready.
+     * Reusing `operationId` with identical input resumes the same file.
+     */
     upload(file: Blob, input: {
         operationId: string;
         name: string;
         projectId?: string;
         wait?: boolean;
+        waitTimeout?: number;
     }, options?: RequestOptions): Promise<Types.StudioFileView>;
 }
 export declare class StudioResource {

package/dist/studio.js

@@ -1,9 +1,21 @@
+import { BreezeBlueConfigurationError, BreezeBlueStudioFileError } from "./errors.js";
+/** Convert seconds to 48 kHz Studio timeline frames, rounding half away from zero. */
 export function secondsToFrames(seconds) {
     if (!Number.isFinite(seconds))
         throw new Error("seconds must be finite");
     return Math.sign(seconds) * Math.round(Math.abs(seconds) * 48000);
 }
+/** Convert 48 kHz Studio timeline frames to seconds. */
 export function framesToSeconds(frames) { return frames / 48000; }
+/**
+ * Methods without query parameters take request options last. The 0.20.0
+ * `(…, params, options)` form keeps working when options are passed third.
+ */
+function requestArgs(paramsOrOptions, legacyOptions) {
+    return legacyOptions === undefined
+        ? [undefined, paramsOrOptions]
+        : [paramsOrOptions, legacyOptions];
+}
 export class StudioProjectsResource {
     client;
     constructor(client) {
@@ -12,19 +24,24 @@ export class StudioProjectsResource {
     list(params, options) {
         return this.client.requestJson("GET", `/v1/studio/projects`, params, undefined, options);
     }
-    create(body, params, options) {
+    create(body, paramsOrOptions, legacyOptions) {
+        const [params, options] = requestArgs(paramsOrOptions, legacyOptions);
         return this.client.requestJson("POST", `/v1/studio/projects`, params, body, options);
     }
-    importProject(body, params, options) {
+    importProject(body, paramsOrOptions, legacyOptions) {
+        const [params, options] = requestArgs(paramsOrOptions, legacyOptions);
         return this.client.requestJson("POST", `/v1/studio/projects/import`, params, body, options);
     }
-    get(projectId, params, options) {
+    get(projectId, paramsOrOptions, legacyOptions) {
+        const [params, options] = requestArgs(paramsOrOptions, legacyOptions);
         return this.client.requestJson("GET", `/v1/studio/projects/${encodeURIComponent(projectId)}`, params, undefined, options);
     }
-    update(projectId, body, params, options) {
+    update(projectId, body, paramsOrOptions, legacyOptions) {
+        const [params, options] = requestArgs(paramsOrOptions, legacyOptions);
         return this.client.requestJson("PATCH", `/v1/studio/projects/${encodeURIComponent(projectId)}`, params, body, options);
     }
-    delete(projectId, body, params, options) {
+    delete(projectId, body, paramsOrOptions, legacyOptions) {
+        const [params, options] = requestArgs(paramsOrOptions, legacyOptions);
         return this.client.requestJson("DELETE", `/v1/studio/projects/${encodeURIComponent(projectId)}`, params, body, options);
     }
 }
@@ -36,22 +53,28 @@ export class StudioChaptersResource {
     list(projectId, params, options) {
         return this.client.requestJson("GET", `/v1/studio/projects/${encodeURIComponent(projectId)}/chapters`, params, undefined, options);
     }
-    create(projectId, body, params, options) {
+    create(projectId, body, paramsOrOptions, legacyOptions) {
+        const [params, options] = requestArgs(paramsOrOptions, legacyOptions);
         return this.client.requestJson("POST", `/v1/studio/projects/${encodeURIComponent(projectId)}/chapters`, params, body, options);
     }
-    reorder(projectId, body, params, options) {
+    reorder(projectId, body, paramsOrOptions, legacyOptions) {
+        const [params, options] = requestArgs(paramsOrOptions, legacyOptions);
         return this.client.requestJson("PATCH", `/v1/studio/projects/${encodeURIComponent(projectId)}/chapters/reorder`, params, body, options);
     }
-    get(projectId, chapterId, params, options) {
+    get(projectId, chapterId, paramsOrOptions, legacyOptions) {
+        const [params, options] = requestArgs(paramsOrOptions, legacyOptions);
         return this.client.requestJson("GET", `/v1/studio/projects/${encodeURIComponent(projectId)}/chapters/${encodeURIComponent(chapterId)}`, params, undefined, options);
     }
-    update(projectId, chapterId, body, params, options) {
+    update(projectId, chapterId, body, paramsOrOptions, legacyOptions) {
+        const [params, options] = requestArgs(paramsOrOptions, legacyOptions);
         return this.client.requestJson("PATCH", `/v1/studio/projects/${encodeURIComponent(projectId)}/chapters/${encodeURIComponent(chapterId)}`, params, body, options);
     }
-    delete(projectId, chapterId, body, params, options) {
+    delete(projectId, chapterId, body, paramsOrOptions, legacyOptions) {
+        const [params, options] = requestArgs(paramsOrOptions, legacyOptions);
         return this.client.requestJson("DELETE", `/v1/studio/projects/${encodeURIComponent(projectId)}/chapters/${encodeURIComponent(chapterId)}`, params, body, options);
     }
-    restore(projectId, chapterId, body, params, options) {
+    restore(projectId, chapterId, body, paramsOrOptions, legacyOptions) {
+        const [params, options] = requestArgs(paramsOrOptions, legacyOptions);
         return this.client.requestJson("POST", `/v1/studio/projects/${encodeURIComponent(projectId)}/chapters/${encodeURIComponent(chapterId)}/restore`, params, body, options);
     }
 }
@@ -63,31 +86,40 @@ export class StudioClipsResource {
     list(projectId, params, options) {
         return this.client.requestJson("GET", `/v1/studio/projects/${encodeURIComponent(projectId)}/clips`, params, undefined, options);
     }
-    create(projectId, body, params, options) {
+    create(projectId, body, paramsOrOptions, legacyOptions) {
+        const [params, options] = requestArgs(paramsOrOptions, legacyOptions);
         return this.client.requestJson("POST", `/v1/studio/projects/${encodeURIComponent(projectId)}/clips`, params, body, options);
     }
-    batchCreate(projectId, body, params, options) {
+    batchCreate(projectId, body, paramsOrOptions, legacyOptions) {
+        const [params, options] = requestArgs(paramsOrOptions, legacyOptions);
         return this.client.requestJson("POST", `/v1/studio/projects/${encodeURIComponent(projectId)}/clips/batch`, params, body, options);
     }
-    batchUpdate(projectId, body, params, options) {
+    batchUpdate(projectId, body, paramsOrOptions, legacyOptions) {
+        const [params, options] = requestArgs(paramsOrOptions, legacyOptions);
         return this.client.requestJson("PATCH", `/v1/studio/projects/${encodeURIComponent(projectId)}/clips/batch`, params, body, options);
     }
-    bulkDelete(projectId, body, params, options) {
+    bulkDelete(projectId, body, paramsOrOptions, legacyOptions) {
+        const [params, options] = requestArgs(paramsOrOptions, legacyOptions);
         return this.client.requestJson("POST", `/v1/studio/projects/${encodeURIComponent(projectId)}/clips/bulk-delete`, params, body, options);
     }
-    reorder(projectId, body, params, options) {
+    reorder(projectId, body, paramsOrOptions, legacyOptions) {
+        const [params, options] = requestArgs(paramsOrOptions, legacyOptions);
         return this.client.requestJson("PATCH", `/v1/studio/projects/${encodeURIComponent(projectId)}/clips/reorder`, params, body, options);
     }
-    move(projectId, body, params, options) {
+    move(projectId, body, paramsOrOptions, legacyOptions) {
+        const [params, options] = requestArgs(paramsOrOptions, legacyOptions);
         return this.client.requestJson("POST", `/v1/studio/projects/${encodeURIComponent(projectId)}/clips/move`, params, body, options);
     }
-    get(projectId, clipId, params, options) {
+    get(projectId, clipId, paramsOrOptions, legacyOptions) {
+        const [params, options] = requestArgs(paramsOrOptions, legacyOptions);
         return this.client.requestJson("GET", `/v1/studio/projects/${encodeURIComponent(projectId)}/clips/${encodeURIComponent(clipId)}`, params, undefined, options);
     }
-    update(projectId, clipId, body, params, options) {
+    update(projectId, clipId, body, paramsOrOptions, legacyOptions) {
+        const [params, options] = requestArgs(paramsOrOptions, legacyOptions);
         return this.client.requestJson("PATCH", `/v1/studio/projects/${encodeURIComponent(projectId)}/clips/${encodeURIComponent(clipId)}`, params, body, options);
     }
-    delete(projectId, clipId, body, params, options) {
+    delete(projectId, clipId, body, paramsOrOptions, legacyOptions) {
+        const [params, options] = requestArgs(paramsOrOptions, legacyOptions);
         return this.client.requestJson("DELETE", `/v1/studio/projects/${encodeURIComponent(projectId)}/clips/${encodeURIComponent(clipId)}`, params, body, options);
     }
 }
@@ -96,22 +128,28 @@ export class StudioTracksResource {
     constructor(client) {
         this.client = client;
     }
-    list(projectId, params, options) {
+    list(projectId, paramsOrOptions, legacyOptions) {
+        const [params, options] = requestArgs(paramsOrOptions, legacyOptions);
         return this.client.requestJson("GET", `/v1/studio/projects/${encodeURIComponent(projectId)}/tracks`, params, undefined, options);
     }
-    create(projectId, body, params, options) {
+    create(projectId, body, paramsOrOptions, legacyOptions) {
+        const [params, options] = requestArgs(paramsOrOptions, legacyOptions);
         return this.client.requestJson("POST", `/v1/studio/projects/${encodeURIComponent(projectId)}/tracks`, params, body, options);
     }
-    reorder(projectId, body, params, options) {
+    reorder(projectId, body, paramsOrOptions, legacyOptions) {
+        const [params, options] = requestArgs(paramsOrOptions, legacyOptions);
         return this.client.requestJson("PATCH", `/v1/studio/projects/${encodeURIComponent(projectId)}/tracks/reorder`, params, body, options);
     }
-    get(projectId, trackId, params, options) {
+    get(projectId, trackId, paramsOrOptions, legacyOptions) {
+        const [params, options] = requestArgs(paramsOrOptions, legacyOptions);
         return this.client.requestJson("GET", `/v1/studio/projects/${encodeURIComponent(projectId)}/tracks/${encodeURIComponent(trackId)}`, params, undefined, options);
     }
-    update(projectId, trackId, body, params, options) {
+    update(projectId, trackId, body, paramsOrOptions, legacyOptions) {
+        const [params, options] = requestArgs(paramsOrOptions, legacyOptions);
         return this.client.requestJson("PATCH", `/v1/studio/projects/${encodeURIComponent(projectId)}/tracks/${encodeURIComponent(trackId)}`, params, body, options);
     }
-    delete(projectId, trackId, body, params, options) {
+    delete(projectId, trackId, body, paramsOrOptions, legacyOptions) {
+        const [params, options] = requestArgs(paramsOrOptions, legacyOptions);
         return this.client.requestJson("DELETE", `/v1/studio/projects/${encodeURIComponent(projectId)}/tracks/${encodeURIComponent(trackId)}`, params, body, options);
     }
 }
@@ -120,22 +158,31 @@ export class StudioInstancesResource {
     constructor(client) {
         this.client = client;
     }
-    list(projectId, trackId, params, options) {
+    list(projectId, trackId, paramsOrOptions, legacyOptions) {
+        const [params, options] = requestArgs(paramsOrOptions, legacyOptions);
         return this.client.requestJson("GET", `/v1/studio/projects/${encodeURIComponent(projectId)}/tracks/${encodeURIComponent(trackId)}/instances`, params, undefined, options);
     }
-    create(projectId, trackId, body, params, options) {
+    create(projectId, trackId, body, paramsOrOptions, legacyOptions) {
+        const [params, options] = requestArgs(paramsOrOptions, legacyOptions);
         return this.client.requestJson("POST", `/v1/studio/projects/${encodeURIComponent(projectId)}/tracks/${encodeURIComponent(trackId)}/instances`, params, body, options);
     }
-    get(projectId, trackId, instanceId, params, options) {
+    get(projectId, trackId, instanceId, paramsOrOptions, legacyOptions) {
+        const [params, options] = requestArgs(paramsOrOptions, legacyOptions);
         return this.client.requestJson("GET", `/v1/studio/projects/${encodeURIComponent(projectId)}/tracks/${encodeURIComponent(trackId)}/instances/${encodeURIComponent(instanceId)}`, params, undefined, options);
     }
-    update(projectId, trackId, instanceId, body, params, options) {
+    update(projectId, trackId, instanceId, body, paramsOrOptions, legacyOptions) {
+        const [params, options] = requestArgs(paramsOrOptions, legacyOptions);
         return this.client.requestJson("PATCH", `/v1/studio/projects/${encodeURIComponent(projectId)}/tracks/${encodeURIComponent(trackId)}/instances/${encodeURIComponent(instanceId)}`, params, body, options);
     }
-    delete(projectId, trackId, instanceId, body, params, options) {
+    delete(projectId, trackId, instanceId, body, paramsOrOptions, legacyOptions) {
+        const [params, options] = requestArgs(paramsOrOptions, legacyOptions);
         return this.client.requestJson("DELETE", `/v1/studio/projects/${encodeURIComponent(projectId)}/tracks/${encodeURIComponent(trackId)}/instances/${encodeURIComponent(instanceId)}`, params, body, options);
     }
 }
+/**
+ * Studio audio materials (MP3 or WAV). `upload` runs the whole flow:
+ * `create` → `uploadUrl` → signed PUT → `complete` → `waitReady`.
+ */
 export class StudioFilesResource {
     client;
     constructor(client) {
@@ -144,55 +191,70 @@ export class StudioFilesResource {
     list(params, options) {
         return this.client.requestJson("GET", `/v1/studio/files`, params, undefined, options);
     }
-    create(body, params, options) {
+    create(body, paramsOrOptions, legacyOptions) {
+        const [params, options] = requestArgs(paramsOrOptions, legacyOptions);
         return this.client.requestJson("POST", `/v1/studio/files`, params, body, options);
     }
-    get(fileId, params, options) {
+    get(fileId, paramsOrOptions, legacyOptions) {
+        const [params, options] = requestArgs(paramsOrOptions, legacyOptions);
         return this.client.requestJson("GET", `/v1/studio/files/${encodeURIComponent(fileId)}`, params, undefined, options);
     }
-    update(fileId, body, params, options) {
+    update(fileId, body, paramsOrOptions, legacyOptions) {
+        const [params, options] = requestArgs(paramsOrOptions, legacyOptions);
         return this.client.requestJson("PATCH", `/v1/studio/files/${encodeURIComponent(fileId)}`, params, body, options);
     }
-    delete(fileId, body, params, options) {
+    delete(fileId, body, paramsOrOptions, legacyOptions) {
+        const [params, options] = requestArgs(paramsOrOptions, legacyOptions);
         return this.client.requestJson("DELETE", `/v1/studio/files/${encodeURIComponent(fileId)}`, params, body, options);
     }
-    uploadUrl(fileId, params, options) {
+    uploadUrl(fileId, paramsOrOptions, legacyOptions) {
+        const [params, options] = requestArgs(paramsOrOptions, legacyOptions);
         return this.client.requestJson("POST", `/v1/studio/files/${encodeURIComponent(fileId)}/upload`, params, undefined, options);
     }
-    complete(fileId, params, options) {
+    complete(fileId, paramsOrOptions, legacyOptions) {
+        const [params, options] = requestArgs(paramsOrOptions, legacyOptions);
         return this.client.requestJson("POST", `/v1/studio/files/${encodeURIComponent(fileId)}/complete`, params, undefined, options);
     }
-    retry(fileId, params, options) {
+    retry(fileId, paramsOrOptions, legacyOptions) {
+        const [params, options] = requestArgs(paramsOrOptions, legacyOptions);
         return this.client.requestJson("POST", `/v1/studio/files/${encodeURIComponent(fileId)}/retry`, params, undefined, options);
     }
+    /**
+     * Poll until the file is `ready`. Rejects with `BreezeBlueStudioFileError`
+     * when processing fails or is still running after `timeout` milliseconds.
+     */
     async waitReady(fileId, options = {}) {
         const deadline = Date.now() + (options.timeout ?? 300000);
         while (true) {
             options.signal?.throwIfAborted();
-            const value = await this.get(fileId, undefined, { signal: options.signal });
+            const value = await this.get(fileId, { signal: options.signal });
             if (value.status === "ready")
                 return value;
             if (value.status === "failed")
-                throw new Error(value.errorMessage ?? "Studio file processing failed");
+                throw new BreezeBlueStudioFileError(value.errorMessage ?? "Studio file processing failed", value);
             if (Date.now() >= deadline)
-                throw new Error("Studio file is still processing; query the same file ID to resume");
+                throw new BreezeBlueStudioFileError("Studio file is still processing; query the same file ID to resume", value);
             await new Promise(resolve => setTimeout(resolve, Math.max(100, Math.min(options.pollInterval ?? 1000, deadline - Date.now()))));
         }
     }
+    /**
+     * Upload an MP3 or WAV blob and, unless `wait` is false, wait until it is ready.
+     * Reusing `operationId` with identical input resumes the same file.
+     */
     async upload(file, input, options = {}) {
         const mimeType = input.name.toLowerCase().endsWith(".mp3") ? "audio/mpeg" : input.name.toLowerCase().endsWith(".wav") ? "audio/wav" : null;
         if (!mimeType)
-            throw new Error("Studio accepts MP3 or WAV files");
-        let value = await this.create({ operationId: input.operationId, name: input.name, projectId: input.projectId, sizeBytes: file.size, mimeType }, undefined, options);
+            throw new BreezeBlueConfigurationError("Studio accepts MP3 or WAV files");
+        let value = await this.create({ operationId: input.operationId, name: input.name, projectId: input.projectId, sizeBytes: file.size, mimeType }, options);
         if (value.status === "uploading") {
-            const signed = await this.uploadUrl(value.id, undefined, options);
+            const signed = await this.uploadUrl(value.id, options);
             // Never use the API request helper for a signed storage URL.
             const response = await this.client.fetch(signed.uploadUrl, { method: "PUT", headers: signed.headers, body: file, credentials: "omit", redirect: "error", signal: options.signal });
             if (!response.ok)
-                throw new Error(`Studio upload failed: ${response.status}`);
-            value = await this.complete(value.id, undefined, options);
+                throw new BreezeBlueStudioFileError(`Studio upload failed with HTTP ${response.status}`, value);
+            value = await this.complete(value.id, options);
         }
-        return input.wait === false ? value : this.waitReady(value.id, { signal: options.signal });
+        return input.wait === false ? value : this.waitReady(value.id, { timeout: input.waitTimeout, signal: options.signal });
     }
 }
 export class StudioResource {

package/dist/types.d.ts

@@ -23,7 +23,6 @@ export interface AudioRequestOptions extends RequestOptions {
     outputFormat?: string;
 }
 export interface StreamTextToSpeechOptions extends AudioRequestOptions {
-    optimizeStreamingLatency?: number;
     enableLogging?: boolean;
 }
 export type BreezeBlueWebSocketConstructor = new (url: string, protocols?: string | string[]) => BreezeBlueWebSocket;
@@ -42,9 +41,7 @@ export interface RealtimeTextToSpeechSessionRequest {
     modelId?: string;
     languageCode?: string;
     instructions?: string;
-    voiceSettings?: {
-        guidanceScale?: number | null;
-    };
+    voiceSettings?: Pick<TtsVoiceSettings, "guidanceScale" | "useSpeakerBoost">;
     inactivityTimeoutSeconds?: number;
     enableLogging?: boolean;
 }
@@ -226,18 +223,15 @@ export interface RealtimeTextToSpeechAudioMessage {
     audio: Uint8Array;
 }
 export type RealtimeTextToSpeechMessage = RealtimeTextToSpeechEvent | RealtimeTextToSpeechAudioMessage;
-export interface VoiceSettings {
-    stability?: number;
-    similarityBoost?: number;
-    style?: number;
+/** Per-request controls. */
+export interface TtsVoiceSettings {
+    /** Generation guidance strength (1–10). Omitted or null uses the default 1. */
+    guidanceScale?: number | null;
+    /** Default false. Ignored with non-empty instructions and guidanceScale > 1; otherwise instructions are not used. */
     useSpeakerBoost?: boolean;
-    /** Request-only, pitch-preserving HTTP TTS speed (0.5–2.0). Omitted means 1.0. */
+    /** Pitch-preserving speed (0.5–2.0). */
     speed?: number;
-    guidanceScale?: number | null;
-}
-/** Request-only HTTP TTS settings. Volume is a linear amplitude multiplier. */
-export interface TtsVoiceSettings extends VoiceSettings {
-    /** Linear amplitude multiplier (0.01–2.0); omitted means 1.0. */
+    /** Linear amplitude multiplier (0.01–2.0). */
     volume?: number;
 }
 export interface PronunciationDictionaryLocator {
@@ -250,14 +244,6 @@ export interface TextToSpeechRequest {
     languageCode?: string;
     instructions?: string;
     voiceSettings?: TtsVoiceSettings;
-    seed?: number;
-    pronunciationDictionaryLocators?: PronunciationDictionaryLocator[];
-    previousText?: string;
-    nextText?: string;
-    previousRequestIds?: string[];
-    nextRequestIds?: string[];
-    applyTextNormalization?: string;
-    applyLanguageTextNormalization?: boolean;
 }
 export interface TtsEnhanceRequest {
     instruction: string;
@@ -315,7 +301,6 @@ export interface Voice {
     tags: string[];
     isFavorited: boolean;
     previewUrl?: string | null;
-    settings: Required<VoiceSettings>;
     description?: string | null;
     createdAtUnix?: number | null;
     primaryCategoryCode?: string | null;
@@ -430,10 +415,6 @@ export interface VoiceDesignRequest {
     text?: string;
     modelId?: string;
     languageCode?: VoiceLanguageCode;
-    autoGenerateText?: boolean;
-    loudness?: number;
-    quality?: number;
-    seed?: number;
     guidanceScale?: number | null;
     previewCount?: number;
 }
@@ -528,7 +509,6 @@ export interface SaveVoiceRequest {
     tags?: string[];
     primaryCategoryCode?: string;
     visibility?: "private" | "public" | string;
-    playedNotSelectedVoiceIds?: string[];
     languageCode: VoiceLanguageCode;
     gender?: VoiceGender | null;
     age?: VoiceAge | null;
@@ -588,6 +568,20 @@ export interface Balance {
     topups: BalanceTopup[];
     [key: string]: unknown;
 }
+export interface Entitlements {
+    planCode: string;
+    status: string;
+    billingInterval: string | null;
+    cancelAtPeriodEnd: boolean;
+    currentPeriodStart: string | null;
+    currentPeriodEnd: string | null;
+    monthlyCreativeCredits: number;
+    savedVoiceLimit: number;
+    savedProjectLimit: number;
+    maxConcurrentGenerations: number;
+    studioLongFormAccess: boolean;
+    commercialUseAllowed: boolean;
+}
 export interface CurrentApiKey {
     id: string;
     name: string;

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const SDK_VERSION = "0.20.0";
+export declare const SDK_VERSION = "0.21.0";
 export declare const SDK_NAME = "@breeze.blue/sdk";

package/dist/version.js

@@ -1,2 +1,2 @@
-export const SDK_VERSION = "0.20.0";
+export const SDK_VERSION = "0.21.0";
 export const SDK_NAME = "@breeze.blue/sdk";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@breeze.blue/sdk",
-  "version": "0.20.0",
+  "version": "0.21.0",
   "description": "ESM-first TypeScript SDK for the Breeze Blue Developer API.",
   "license": "MIT",
   "author": "Breeze Blue <support@breezeblue.ai>",