@breeze.blue/sdk 0.19.0 → 0.20.1

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 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`.
+- Import multi-chapter scripts with existing voices, preserve edit tokens and error metadata, and upload materials without forwarding API credentials.
+- Convert seconds and 48 kHz timeline frames with SDK helpers.
+
 ## 0.19.0
 
 - Create Voice Remix candidates from custom descriptions or curated presets, with automatic input preparation and Expressive (4) as the default strength.

package/README.md

@@ -653,3 +653,11 @@ For a complete response, use `client.textToSpeech.convertWithTimestamps(...)`. I
 For background generation with timing, use `client.textToSpeech.createJobWithTimestamps(...)`. Poll with `client.generationJobs.get(jobId)`; a ready job includes `wordTimestamps` and the audio download URL.
 
 Clone preview creation accepts an omitted name. The server uses the filename stem or `Cloned Voice`; saving a Clone preview without a name keeps its preview name. Other preview types still require a save name. Explicit names longer than 80 Unicode characters are rejected.
+
+## Studio management
+
+`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/_transform.js

@@ -19,7 +19,7 @@ function transform(value, keyFn) {
     if (isPlainObject(value)) {
         const out = {};
         for (const [k, v] of Object.entries(value)) {
-            out[keyFn(k)] = transform(v, keyFn);
+            out[keyFn(k)] = ["client_refs", "clientRefs", "headers"].includes(k) ? v : transform(v, keyFn);
         }
         return out;
     }

package/dist/client.d.ts

@@ -1,3 +1,4 @@
+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";
@@ -14,6 +15,7 @@ export declare class BreezeBlueClient {
     readonly history: HistoryResource;
     readonly models: ModelsResource;
     readonly account: AccountResource;
+    readonly studio: StudioResource;
     constructor(options?: BreezeBlueClientOptions);
     requestJson<T>(method: string, path: string, params?: object, body?: unknown, options?: RequestOptions): Promise<T>;
     requestAudio(method: string, path: string, params?: object, body?: unknown, options?: RequestOptions): Promise<AudioResponse>;

package/dist/client.js

@@ -1,3 +1,4 @@
+import { StudioResource } from "./studio.js";
 import { SpeechTimingStream } from "./timestamps.js";
 import { AudioResponse } from "./audio.js";
 import { BreezeBlueAPIError, BreezeBlueConfigurationError, BreezeBlueRealtimeError, errorFromResponse, } from "./errors.js";
@@ -33,6 +34,7 @@ export class BreezeBlueClient {
     history;
     models;
     account;
+    studio;
     constructor(options = {}) {
         const envApiKey = typeof process !== "undefined" ? process.env.BREEZE_API_KEY : undefined;
         const envBaseUrl = typeof process !== "undefined" ? process.env.BREEZE_BASE_URL : undefined;
@@ -40,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;
@@ -50,6 +54,7 @@ export class BreezeBlueClient {
         this.history = new HistoryResource(this);
         this.models = new ModelsResource(this);
         this.account = new AccountResource(this);
+        this.studio = new StudioResource(this);
     }
     async requestJson(method, path, params, body, options) {
         const response = await this.request(method, path, params, body, options);

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,8 +1,10 @@
 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";
 export * from "./voice-metadata.js";
 export { SpeechTimingStream } from "./timestamps.js";
 export type { SpeechTimingChunk, SpeechWithTimestamps, WordTimestamp } from "./timestamps.js";
+export * from "./studio.js";
+export type * from "./studio-types.js";

package/dist/index.js

@@ -1,6 +1,7 @@
 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";
 export { SpeechTimingStream } from "./timestamps.js";
+export * from "./studio.js";

package/dist/studio-types.d.ts

@@ -0,0 +1,371 @@
+export interface StudioChapterCreate {
+    expectedEditToken: string;
+    operationId: string;
+    title: string;
+}
+export interface StudioChapterDelete {
+    expectedEditToken: string;
+    operationId: string;
+    moveToChapterId?: string | null;
+}
+export interface StudioChapterList {
+    items: Array<StudioChapterView>;
+    editToken: string;
+}
+export interface StudioChapterPatch {
+    expectedEditToken: string;
+    operationId: string;
+    title: string;
+}
+export interface StudioChapterResult {
+    chapter: StudioChapterView;
+    editToken: string;
+}
+export interface StudioChapterView {
+    id: string;
+    title: string;
+    deleted: boolean;
+    clipIds: Array<string>;
+}
+export interface StudioClipBatchCreate {
+    expectedEditToken: string;
+    operationId: string;
+    chapterId?: string | null;
+    afterClipId?: string | null;
+    clips: Array<StudioClipFields>;
+}
+export interface StudioClipBatchPatch {
+    expectedEditToken: string;
+    operationId: string;
+    updates: Array<StudioClipUpdateItem>;
+}
+export interface StudioClipBulkDelete {
+    expectedEditToken: string;
+    operationId: string;
+    clipIds: Array<string>;
+}
+export interface StudioClipCreate {
+    expectedEditToken: string;
+    operationId: string;
+    clientRef?: string | null;
+    name?: string;
+    script?: string;
+    instructions?: string;
+    voiceId?: string | null;
+    playback?: StudioPlayback;
+    trailingSilenceMs?: number | null;
+    chapterId?: string | null;
+    afterClipId?: string | null;
+}
+export interface StudioClipFields {
+    clientRef?: string | null;
+    name?: string;
+    script?: string;
+    instructions?: string;
+    voiceId?: string | null;
+    playback?: StudioPlayback;
+    trailingSilenceMs?: number | null;
+}
+export interface StudioClipList {
+    items: Array<StudioClipView>;
+    editToken: string;
+    total: number;
+    page: number;
+    pageSize: number;
+}
+export interface StudioClipMove {
+    expectedEditToken: string;
+    operationId: string;
+    clipIds: Array<string>;
+    chapterId: string;
+    afterClipId?: string | null;
+}
+export interface StudioClipPatch {
+    expectedEditToken: string;
+    operationId: string;
+    name?: string | null;
+    script?: string | null;
+    instructions?: string | null;
+    voiceId?: string | null;
+    playback?: StudioPlayback | null;
+    trailingSilenceMs?: number | null;
+}
+export interface StudioClipReorder {
+    expectedEditToken: string;
+    operationId: string;
+    ids: Array<string>;
+    chapterId: string;
+}
+export interface StudioClipResult {
+    clip: StudioClipView;
+    editToken: string;
+}
+export interface StudioClipUpdateItem {
+    name?: string | null;
+    script?: string | null;
+    instructions?: string | null;
+    voiceId?: string | null;
+    playback?: StudioPlayback | null;
+    trailingSilenceMs?: number | null;
+    clipId: string;
+}
+export interface StudioClipView {
+    id: string;
+    chapterId: string | null;
+    name: string;
+    script: string;
+    instructions: string;
+    voiceId: string | null;
+    voice: StudioVoiceSummary | null;
+    playback: StudioPlaybackView;
+    trailingSilenceMs: number | null;
+    effectiveInstructions: string;
+    effectiveTrailingSilenceMs: number;
+    version: number;
+}
+export interface StudioDeleted {
+    deleted: boolean;
+    editToken: string | null;
+}
+export interface StudioEdit {
+    expectedEditToken: string;
+    operationId: string;
+}
+export interface StudioEffects {
+    speed?: number;
+    volume?: number;
+    fadeInSeconds?: number;
+    fadeOutSeconds?: number;
+}
+export interface StudioFileCreate {
+    operationId: string;
+    projectId?: string | null;
+    name: string;
+    sizeBytes: number;
+    mimeType: "audio/mpeg" | "audio/wav";
+}
+export interface StudioFileDelete {
+    expectedRevision: number;
+}
+export interface StudioFileList {
+    items: Array<StudioFileView>;
+    nextOffset: number | null;
+}
+export interface StudioFilePatch {
+    expectedRevision: number;
+    name: string;
+}
+export interface StudioFileView {
+    id: string;
+    projectId: string | null;
+    name: string;
+    revision: number;
+    status: StudioFileStatus;
+    frames: number | null;
+    sampleRate: number;
+    sizeBytes: number | null;
+    errorCode: string | null;
+    errorReason: string | null;
+    errorMessage: string | null;
+    references: number;
+}
+export interface StudioImportChapter {
+    clientRef?: string | null;
+    title: string;
+    clips: Array<StudioClipFields>;
+}
+export interface StudioInstanceCreate {
+    expectedEditToken: string;
+    operationId: string;
+    fileId: string;
+    position?: StudioPosition;
+    trimStart?: number;
+    trimEnd: number;
+    effects?: StudioEffects;
+    length?: number | null;
+}
+export interface StudioInstanceList {
+    items: Array<StudioInstanceView>;
+    editToken: string;
+}
+export interface StudioInstancePatch {
+    expectedEditToken: string;
+    operationId: string;
+    fileId?: string | null;
+    position?: StudioPosition | null;
+    trimStart?: number | null;
+    trimEnd?: number | null;
+    effects?: StudioEffects | null;
+    length?: number | null;
+    trackId?: string | null;
+}
+export interface StudioInstanceResult {
+    instance: StudioInstanceView;
+    editToken: string;
+}
+export interface StudioInstanceView {
+    id: string;
+    fileId: string;
+    position: StudioPosition;
+    trimStart: number;
+    trimEnd: number;
+    effects: StudioEffects;
+    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;
+    volume?: number;
+}
+export interface StudioPosition {
+    mode?: "fixed" | "follow";
+    frame?: number;
+    clipId?: string | null;
+    edge?: "start" | "end";
+    offset?: number;
+}
+export interface StudioProjectCreate {
+    title?: string;
+    description?: string;
+    ttsSettings?: StudioTtsSettings | null;
+    defaultVoiceId?: string | null;
+    defaultInstructions?: string;
+    defaultSilenceMs?: number;
+    operationId: string;
+}
+export interface StudioProjectImport {
+    title?: string;
+    description?: string;
+    ttsSettings?: StudioTtsSettings | null;
+    defaultVoiceId?: string | null;
+    defaultInstructions?: string;
+    defaultSilenceMs?: number;
+    operationId: string;
+    chapters: Array<StudioImportChapter>;
+}
+export interface StudioProjectList {
+    items: Array<StudioProjectView>;
+    total: number;
+    page: number;
+    pageSize: number;
+}
+export interface StudioProjectPatch {
+    expectedEditToken: string;
+    operationId: string;
+    title?: string | null;
+    description?: string | null;
+    ttsSettings?: StudioTtsSettings | null;
+    defaultVoiceId?: string | null;
+    defaultInstructions?: string | null;
+    defaultSilenceMs?: number | null;
+}
+export interface StudioProjectResult {
+    project: StudioProjectView;
+    editToken: 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;
+    id: string;
+    editToken: string;
+    createdAt: string;
+    updatedAt: string;
+    chapterCount: number;
+    clipCount: number;
+}
+export interface StudioReorder {
+    expectedEditToken: string;
+    operationId: string;
+    ids: Array<string>;
+}
+export interface StudioTrackCreate {
+    expectedEditToken: string;
+    operationId: string;
+    name: string;
+    chapterId?: string | null;
+    volume?: number;
+    muted?: boolean;
+}
+export interface StudioTrackList {
+    items: Array<StudioTrackView>;
+    editToken: string;
+}
+export interface StudioTrackPatch {
+    expectedEditToken: string;
+    operationId: string;
+    name?: string | null;
+    chapterId?: string | null;
+    volume?: number | null;
+    muted?: boolean | null;
+}
+export interface StudioTrackResult {
+    track: StudioTrackView;
+    editToken: string;
+}
+export interface StudioTrackView {
+    id: string;
+    name: string;
+    chapterId: string | null;
+    volume: number;
+    muted: boolean;
+    readonly: boolean;
+    instances: Array<StudioInstanceView>;
+}
+export interface StudioTtsSettings {
+    model?: string | null;
+    language?: string | null;
+    generationLanguage?: string | null;
+    guidanceScale?: number | null;
+}
+export interface StudioUploadResult {
+    uploadUrl: 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-types.js

@@ -0,0 +1 @@
+export {};

package/dist/studio.d.ts

@@ -0,0 +1,182 @@
+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?: 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?: 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?: 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, 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, 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?: 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 {
+    readonly projects: StudioProjectsResource;
+    readonly chapters: StudioChaptersResource;
+    readonly clips: StudioClipsResource;
+    readonly tracks: StudioTracksResource;
+    readonly instances: StudioInstancesResource;
+    readonly files: StudioFilesResource;
+    constructor(client: BreezeBlueClient);
+}

package/dist/studio.js

@@ -0,0 +1,275 @@
+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) {
+        this.client = client;
+    }
+    list(params, options) {
+        return this.client.requestJson("GET", `/v1/studio/projects`, params, undefined, options);
+    }
+    create(body, paramsOrOptions, legacyOptions) {
+        const [params, options] = requestArgs(paramsOrOptions, legacyOptions);
+        return this.client.requestJson("POST", `/v1/studio/projects`, params, body, 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, paramsOrOptions, legacyOptions) {
+        const [params, options] = requestArgs(paramsOrOptions, legacyOptions);
+        return this.client.requestJson("GET", `/v1/studio/projects/${encodeURIComponent(projectId)}`, params, undefined, 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, paramsOrOptions, legacyOptions) {
+        const [params, options] = requestArgs(paramsOrOptions, legacyOptions);
+        return this.client.requestJson("DELETE", `/v1/studio/projects/${encodeURIComponent(projectId)}`, params, body, options);
+    }
+}
+export class StudioChaptersResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    list(projectId, params, options) {
+        return this.client.requestJson("GET", `/v1/studio/projects/${encodeURIComponent(projectId)}/chapters`, params, undefined, 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, 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, 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, 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, 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, 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);
+    }
+}
+export class StudioClipsResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    list(projectId, params, options) {
+        return this.client.requestJson("GET", `/v1/studio/projects/${encodeURIComponent(projectId)}/clips`, params, undefined, 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, 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, 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, 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, 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, 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, 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, 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, paramsOrOptions, legacyOptions) {
+        const [params, options] = requestArgs(paramsOrOptions, legacyOptions);
+        return this.client.requestJson("DELETE", `/v1/studio/projects/${encodeURIComponent(projectId)}/clips/${encodeURIComponent(clipId)}`, params, body, options);
+    }
+}
+export class StudioTracksResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    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, 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, 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, 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, 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, paramsOrOptions, legacyOptions) {
+        const [params, options] = requestArgs(paramsOrOptions, legacyOptions);
+        return this.client.requestJson("DELETE", `/v1/studio/projects/${encodeURIComponent(projectId)}/tracks/${encodeURIComponent(trackId)}`, params, body, options);
+    }
+}
+export class StudioInstancesResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    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, 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, 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, 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, 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) {
+        this.client = client;
+    }
+    list(params, options) {
+        return this.client.requestJson("GET", `/v1/studio/files`, params, undefined, options);
+    }
+    create(body, paramsOrOptions, legacyOptions) {
+        const [params, options] = requestArgs(paramsOrOptions, legacyOptions);
+        return this.client.requestJson("POST", `/v1/studio/files`, params, body, 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, paramsOrOptions, legacyOptions) {
+        const [params, options] = requestArgs(paramsOrOptions, legacyOptions);
+        return this.client.requestJson("PATCH", `/v1/studio/files/${encodeURIComponent(fileId)}`, params, body, 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, paramsOrOptions, legacyOptions) {
+        const [params, options] = requestArgs(paramsOrOptions, legacyOptions);
+        return this.client.requestJson("POST", `/v1/studio/files/${encodeURIComponent(fileId)}/upload`, params, undefined, 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, 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, { signal: options.signal });
+            if (value.status === "ready")
+                return value;
+            if (value.status === "failed")
+                throw new BreezeBlueStudioFileError(value.errorMessage ?? "Studio file processing failed", value);
+            if (Date.now() >= deadline)
+                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 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, 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 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, { timeout: input.waitTimeout, signal: options.signal });
+    }
+}
+export class StudioResource {
+    projects;
+    chapters;
+    clips;
+    tracks;
+    instances;
+    files;
+    constructor(client) {
+        this.projects = new StudioProjectsResource(client);
+        this.chapters = new StudioChaptersResource(client);
+        this.clips = new StudioClipsResource(client);
+        this.tracks = new StudioTracksResource(client);
+        this.instances = new StudioInstancesResource(client);
+        this.files = new StudioFilesResource(client);
+    }
+}

package/dist/version.d.ts

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

package/dist/version.js

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

package/package.json

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