@breeze.blue/sdk 0.11.0 → 0.12.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.12.0
+
+- Voice listings preserve the `created_at_unix desc` default and support the
+  shared Daily Trend with `{ sort: "trend", voiceType: "default" }`, signed
+  snapshot pagination, and language/category/gender/age/tone/accent filters.
+
 ## 0.11.0
 
 - Added canonical Voice `tags`, personal tag overrides, favorite management,

package/README.md

@@ -406,6 +406,14 @@ or voice ID.
 
 ```ts
 const voices = await client.voices.search({ search: "calm documentary narrator" });
+const newestFirst = await client.voices.search();
+const dailyTrend = await client.voices.search({
+  voiceType: "default",
+  sort: "trend",
+  languageCode: "zh",
+  gender: ["female", "neutral"],
+  tone: ["warm"],
+});
 const taggedFavorites = await client.voices.search({
   favoritesOnly: true,
   tags: ["narration", "novel=三体"],
@@ -424,6 +432,11 @@ console.log(metadataOptions.languageCodes);
 console.log(metadataOptions.accentCodesByLanguage.en);
 ```
 
+Voice listings keep the published default of stable creation-time order from
+newest to oldest. Use `{ sort: "trend", voiceType: "default" }` for the shared
+Daily Trend order. Search queries remain relevance-ranked; Trend is only a
+weak prior within the same relevance tier.
+
 Breeze voice creation is always two steps: produce a **preview**, let the
 user accept it, then **save the preview** as a real voice. Two ways to
 produce a preview:

package/dist/client.d.ts

@@ -207,7 +207,9 @@ declare class VoicesResource {
     /**
      * Search every voice visible to the account. Catalog results use hybrid
      * semantic and text relevance; personal voices match by name, description,
-     * or identifier.
+     * or identifier. Listings default to stable creation-time order from newest
+     * to oldest. Pass sort: "trend" with voiceType: "default" for the shared
+     * Daily Trend order.
      */
     search(params?: VoiceSearchParams, options?: RequestOptions): Promise<VoiceList>;
     get(voiceId: string, options?: RequestOptions): Promise<Voice>;

package/dist/client.js

@@ -1492,10 +1492,12 @@ class VoicesResource {
     /**
      * Search every voice visible to the account. Catalog results use hybrid
      * semantic and text relevance; personal voices match by name, description,
-     * or identifier.
+     * or identifier. Listings default to stable creation-time order from newest
+     * to oldest. Pass sort: "trend" with voiceType: "default" for the shared
+     * Daily Trend order.
      */
     async search(params = {}, options) {
-        const result = await this.client.requestJson("GET", "/v1/voices", params, undefined, options);
+        const result = await this.client.requestJson("GET", "/v1/voices", { sort: "created_at_unix", sortDirection: "desc", ...params }, undefined, options);
         return Array.isArray(result.voices)
             ? { ...result, voices: result.voices.map(stripHiddenVoiceFields) }
             : result;

package/dist/types.d.ts

@@ -354,9 +354,14 @@ export interface VoiceMetadataOptions {
 export interface VoiceSearchParams {
     search?: string;
     languageCode?: VoiceLanguageCode;
+    primaryCategoryCode?: string;
+    gender?: VoiceGender[];
+    age?: VoiceAge[];
+    tone?: VoiceTone[];
+    accent?: VoiceAccent;
     origin?: "designed" | "cloned" | string;
     voiceType?: "all" | "default" | "personal" | string;
-    sort?: "created_at_unix" | "name" | string;
+    sort?: "created_at_unix" | "name" | "trend" | string;
     sortDirection?: "asc" | "desc";
     nextPageToken?: string;
     page?: number;

package/dist/version.d.ts

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

package/dist/version.js

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

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@breeze.blue/sdk",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "description": "ESM-first TypeScript SDK for the Breeze Blue Developer API.",
   "license": "MIT",
-  "author": "Breeze Blue <support@breeze.blue>",
+  "author": "Breeze Blue <support@breezeblue.ai>",
   "homepage": "https://breezeblue.ai",
   "repository": {
     "type": "git",