@boldvideo/bold-js 1.9.0 → 1.11.0

package/CHANGELOG.md

@@ -1,5 +1,36 @@
 # @boldvideo/bold-js
 
+## 1.11.0
+
+### Minor Changes
+
+- 88c5d1c: Remove deprecated SSE event types and add Segment type
+
+  **Breaking changes to `AIEvent` type:**
+
+  - Remove deprecated event types: `token`, `clarification`, `answer`, `complete`
+  - Remove `AnswerMetadata` interface
+  - Change `message_complete` event: `sources` field renamed to `citations`, added `responseType: "answer" | "clarification"`
+
+  **New exports:**
+
+  - `Segment` - Primary type for video segments (replaces Source)
+  - `Citation` - Semantic alias for Segment (for cited chunks)
+  - `Source` - Now a deprecated alias for Segment (kept for backwards compatibility)
+
+  This aligns the SDK with the simplified backend SSE event structure.
+
+## 1.10.0
+
+### Minor Changes
+
+- a9402d1: Add missing SSE event types and fix streaming termination
+
+  - Add `token`, `answer`, and `complete` event types to the `AIEvent` type union
+  - Add `AnswerMetadata` interface for answer event metadata
+  - Fix AsyncIterable not signaling completion: now terminates on `complete` event in addition to `message_complete` and `error`
+  - Add error logging for malformed SSE JSON to aid debugging
+
 ## 1.9.0
 
 ### Minor Changes

package/dist/index.cjs

@@ -273,7 +273,8 @@ async function* parseSSE(response) {
             await reader.cancel();
             return;
           }
-        } catch {
+        } catch (err) {
+          console.error("[bold-js] Failed to parse SSE JSON:", json, err);
         }
       }
       if (done)

package/dist/index.d.ts

@@ -179,9 +179,9 @@ type Settings = {
     version: string;
 };
 /**
- * Source citation from AI responses
+ * Video segment from AI responses (used for both sources and citations)
  */
-interface Source {
+interface Segment {
     id: string;
     videoId: string;
     title: string;
@@ -191,6 +191,14 @@ interface Source {
     playbackId: string;
     speaker?: string;
 }
+/**
+ * @deprecated Use Segment instead
+ */
+type Source = Segment;
+/**
+ * Alias for Segment - represents chunks the LLM actually cited
+ */
+type Citation = Segment;
 /**
  * Token usage statistics
  */
@@ -207,14 +215,10 @@ type AIEvent = {
     videoId?: string;
 } | {
     type: "sources";
-    sources: Source[];
+    sources: Segment[];
 } | {
     type: "text_delta";
     delta: string;
-} | {
-    type: "clarification";
-    content: string;
-    questions: string[];
 } | {
     type: "recommendations";
     recommendations: Recommendation[];
@@ -222,7 +226,8 @@ type AIEvent = {
     type: "message_complete";
     conversationId?: string;
     content: string;
-    sources: Source[];
+    citations: Segment[];
+    responseType: "answer" | "clarification";
     usage?: AIUsage;
     context?: AIContextMessage[];
     recommendations?: Recommendation[];
@@ -484,4 +489,4 @@ declare const DEFAULT_API_BASE_URL = "https://app.boldvideo.io/api/v1/";
  */
 declare const DEFAULT_INTERNAL_API_BASE_URL = "https://app.boldvideo.io/i/v1/";
 
-export { AIContextMessage, AIEvent, AIResponse, AIUsage, Account, AccountAI, AskOptions, AssistantConfig, ChatOptions, ClientOptions, DEFAULT_API_BASE_URL, DEFAULT_INTERNAL_API_BASE_URL, MenuItem, Playlist, Portal, PortalDisplay, PortalLayout, PortalNavigation, PortalTheme, RecommendOptions, RecommendResponse, Recommendation, RecommendationVideo, RecommendationsOptions, RecommendationsResponse, SearchOptions, Settings, Source, ThemeColors, ThemeConfig, Video, VideoAttachment, VideoDownloadUrls, VideoMetadata, VideoSubtitles, VideoTranscript, createClient };
+export { AIContextMessage, AIEvent, AIResponse, AIUsage, Account, AccountAI, AskOptions, AssistantConfig, ChatOptions, Citation, ClientOptions, DEFAULT_API_BASE_URL, DEFAULT_INTERNAL_API_BASE_URL, MenuItem, Playlist, Portal, PortalDisplay, PortalLayout, PortalNavigation, PortalTheme, RecommendOptions, RecommendResponse, Recommendation, RecommendationVideo, RecommendationsOptions, RecommendationsResponse, SearchOptions, Segment, Settings, Source, ThemeColors, ThemeConfig, Video, VideoAttachment, VideoDownloadUrls, VideoMetadata, VideoSubtitles, VideoTranscript, createClient };

package/dist/index.js

@@ -235,7 +235,8 @@ async function* parseSSE(response) {
             await reader.cancel();
             return;
           }
-        } catch {
+        } catch (err) {
+          console.error("[bold-js] Failed to parse SSE JSON:", json, err);
         }
       }
       if (done)

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@boldvideo/bold-js",
   "license": "MIT",
-  "version": "1.9.0",
+  "version": "1.11.0",
   "main": "dist/index.js",
   "module": "dist/index.js",
   "types": "dist/index.d.ts",