@breeze.blue/sdk 0.5.0 → 0.5.1

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 0.5.1
+
+- Added official voice publishing metadata to `voices.savePreview(...)` and
+  `voices.edit(...)`, including `primaryCategoryCode`, `visibility`, and the
+  typed `SavedVoice` response.
+- Aligned voice, history, and generation metadata with the public API by using
+  `origin` instead of the legacy category fields; voice search now accepts an
+  `origin` filter.
+- Made `voices.edit(...)` support metadata-only updates without requiring a
+  voice name.
+- Improved the realtime TTS example to start consuming before sending text and
+  continue until `turn.done`, so early audio is not missed.
+
 ## 0.5.0
 
 - Fixed `textToSpeech.realtime.connect(...)` so a failed WebSocket handshake

package/README.md

@@ -112,29 +112,35 @@ Realtime needs a `WebSocket` implementation. Browsers, edge runtimes, and
 Node 22+ provide a global one; on Node 20, pass a constructor (for example the
 `ws` package's `WebSocket`) via `new BreezeBlueClient({ webSocket })`.
 
+Start consuming before appending text. Audio can arrive after `flush()` and may
+continue after `endTurn()`; keep the single consumer running until `turn.done`.
+
 ```ts
 const connection = await client.textToSpeech.realtime.connect("voc_...", {
   modelId: "bluebell-v1",
 });
 
+const pcmChunks: Uint8Array[] = [];
+const consumer = (async () => {
+  for await (const message of connection) {
+    if (message.type === "audio") {
+      // Forward this chunk to your playback or transport layer immediately.
+      pcmChunks.push(message.audio);
+    } else if (message.type === "error") {
+      throw new Error(`Realtime TTS failed: ${message.code}: ${message.message}`);
+    } else if (message.type === "turn.done") {
+      return;
+    }
+  }
+  throw new Error("Realtime session closed before turn.done");
+})();
+
 connection.startTurn("turn_1");
 connection.appendText("Hello from Breeze.");
 connection.flush();
 connection.endTurn();
 
-const pcmChunks: Uint8Array[] = [];
-for await (const message of connection) {
-  if (message.type === "audio") {
-    pcmChunks.push(message.audio);
-    continue;
-  }
-  if (message.type === "error") {
-    throw new Error(`Realtime TTS failed: ${message.code}: ${message.message}`);
-  }
-  if (message.type === "turn.done") {
-    break; // all audio for this turn has been delivered
-  }
-}
+await consumer;
 connection.close();
 ```
 

package/dist/version.d.ts

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

package/dist/version.js

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

package/package.json

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