npm - @breeze.blue/sdk - Versions diffs - 0.20.0 → 0.20.1 - Mend

@breeze.blue/sdk 0.20.0 → 0.20.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (13) hide show

package/CHANGELOG.md CHANGED Viewed

@@ -1,5 +1,15 @@
 # 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`.

package/README.md CHANGED Viewed

@@ -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.js CHANGED Viewed

@@ -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;

package/dist/errors.d.ts CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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/version.d.ts CHANGED Viewed

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

package/dist/version.js CHANGED Viewed

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

package/package.json CHANGED Viewed

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