@breeze.blue/sdk 0.3.0 → 0.3.1

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 0.3.1
+
+- Added SDK-side validation for `voices.createClonePreview(...)` and
+  `voices.edit(...)` reference audio inputs so `file` and single-item `files`
+  forms are accepted, while missing or multiple clone samples are rejected
+  before sending a request.
+
 ## 0.3.0
 
 - Added async text-to-speech helpers: `client.textToSpeech.createJob(...)`,

package/README.md

@@ -163,6 +163,8 @@ const design = await client.voices.createDesignPreview({
 generatedVoiceId = design.previews[0].generatedVoiceId;
 ```
 
+`files` is also accepted with exactly one item.
+
 Stream the preview so the user can audition it, then save the one they
 pick:
 

package/dist/client.js

@@ -279,7 +279,7 @@ function clonePreviewForm(request) {
     appendOptional(form, "labels", request.labels ? JSON.stringify(request.labels) : undefined);
     appendOptional(form, "text", request.text);
     appendOptional(form, "instructions", request.instructions);
-    for (const file of normalizeFiles(request.file, request.files)) {
+    for (const file of normalizeFiles(request.file, request.files, { required: true })) {
         appendFile(form, "files", file);
     }
     return form;
@@ -289,7 +289,7 @@ function voiceEditForm(request) {
     form.set("name", request.name);
     appendOptional(form, "description", request.description);
     appendOptional(form, "labels", request.labels ? JSON.stringify(request.labels) : undefined);
-    for (const file of normalizeFiles(request.file, request.files)) {
+    for (const file of normalizeFiles(request.file, request.files, { required: false })) {
         appendFile(form, "files", file);
     }
     return form;
@@ -299,10 +299,18 @@ function appendOptional(form, key, value) {
         return;
     form.set(key, String(value));
 }
-function normalizeFiles(file, files) {
-    if (files && files.length > 0)
-        return files;
-    return file === undefined ? [] : [file];
+function normalizeFiles(file, files, options) {
+    if (file !== undefined && files !== undefined) {
+        throw new BreezeBlueConfigurationError("Pass either file or files, not both.");
+    }
+    const selected = files !== undefined ? files : file === undefined ? [] : [file];
+    if (options.required && selected.length === 0) {
+        throw new BreezeBlueConfigurationError("Exactly one sample file is required.");
+    }
+    if (selected.length > 1) {
+        throw new BreezeBlueConfigurationError("Exactly one sample file is currently supported.");
+    }
+    return selected;
 }
 function appendFile(form, key, input) {
     const upload = isUploadFile(input) ? input : { data: input };

package/dist/types.d.ts

@@ -192,6 +192,9 @@ export interface HistoryItem {
     requestId?: string | null;
     latencyMs?: number | null;
     httpStatus?: number | null;
+    billableUnits?: number | null;
+    cost?: number | null;
+    costMillicredits?: number | null;
     [key: string]: unknown;
 }
 export interface HistoryList {

package/dist/version.d.ts

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

package/dist/version.js

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

package/package.json

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