@boldvideo/bold-js 1.13.0 → 1.15.0

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @boldvideo/bold-js
 
+## 1.15.0
+
+### Minor Changes
+
+- d7e0675: Add `bold.ai.getConversation(conversationId)` method to fetch conversation history by ID. Returns the full conversation including messages, metadata, and timestamps.
+
+## 1.14.0
+
+### Minor Changes
+
+- 4bfba45: Add Portal analytics and custom redirects support
+
+  - Add `analyticsProvider` and `analyticsId` fields to Portal type for Plausible, GA4, and Fathom integrations
+  - Add `customRedirects` field to Portal type for custom redirect configuration
+  - Export new types: `AnalyticsProvider`, `CustomRedirect`
+
 ## 1.13.0
 
 ### Minor Changes

package/README.md

@@ -220,6 +220,19 @@ const stream = await bold.ai.chat({
 });
 ```
 
+### Get Conversation History
+
+Retrieve a conversation by ID to display message history:
+
+```typescript
+const conversation = await bold.ai.getConversation('550e8400-e29b-41d4-a716-446655440000');
+
+console.log(`Created: ${conversation.createdAt}`);
+for (const msg of conversation.messages) {
+  console.log(`${msg.role}: ${msg.content}`);
+}
+```
+
 ### Multi-turn Conversations
 
 Use the `context` parameter for follow-up questions:
@@ -279,6 +292,8 @@ import type {
   RecommendationsOptions,
   RecommendationsResponse,
   Recommendation,
+  Conversation,
+  ConversationMessage,
   Source
 } from '@boldvideo/bold-js';
 ```

package/dist/index.cjs

@@ -321,6 +321,21 @@ async function jsonRequest(path, body, config) {
   const raw = await response.json();
   return camelizeKeys(raw);
 }
+async function getRequest(path, config) {
+  const url = buildURL(config.baseURL, path);
+  const response = await fetch(url, {
+    method: "GET",
+    headers: {
+      "Accept": "application/json",
+      ...config.headers
+    }
+  });
+  if (!response.ok) {
+    throw new Error(`AI request failed: ${response.status} ${response.statusText}`);
+  }
+  const raw = await response.json();
+  return camelizeKeys(raw);
+}
 function createAI(config) {
   async function chat(options) {
     const isVideoScoped = !!options.videoId;
@@ -387,13 +402,20 @@ function createAI(config) {
   async function recommend(options) {
     return recommendations(options);
   }
+  async function getConversation(conversationId) {
+    if (!conversationId) {
+      throw new Error("conversationId is required");
+    }
+    return getRequest(`ai/chat/${conversationId}`, config);
+  }
   return {
     chat,
     ask,
     coach,
     search,
     recommendations,
-    recommend
+    recommend,
+    getConversation
   };
 }
 

package/dist/index.d.ts

@@ -109,6 +109,12 @@ type PortalTheme = {
 type PortalHero = {
     type: 'none' | 'custom';
 };
+type CustomRedirect = {
+    path: string;
+    url: string;
+    permanent: boolean;
+};
+type AnalyticsProvider = 'plausible' | 'ga4' | 'fathom';
 type Portal = {
     colorScheme?: 'toggle' | 'light' | 'dark';
     display: PortalDisplay;
@@ -116,6 +122,9 @@ type Portal = {
     layout: PortalLayout;
     navigation: PortalNavigation;
     theme: PortalTheme;
+    customRedirects?: CustomRedirect[];
+    analyticsProvider?: AnalyticsProvider;
+    analyticsId?: string;
 };
 type ThemeColors = {
     accent: string;
@@ -351,6 +360,35 @@ interface RecommendationsResponse {
  * @deprecated Use RecommendationsResponse instead
  */
 type RecommendResponse = RecommendationsResponse;
+/**
+ * A message in a conversation
+ */
+interface ConversationMessage {
+    id: string;
+    role: 'user' | 'assistant' | 'system';
+    content: string;
+    sources: Segment[];
+    insertedAt: string;
+}
+/**
+ * Conversation metadata
+ */
+interface ConversationMetadata {
+    originalQuery: string;
+    status: string;
+    confidence: string;
+    chunksFound: number;
+}
+/**
+ * Full conversation with message history
+ */
+interface Conversation {
+    conversationId: string;
+    messages: ConversationMessage[];
+    metadata: ConversationMetadata;
+    createdAt: string;
+    updatedAt: string;
+}
 
 /**
  * AI client interface for type-safe method overloading
@@ -452,6 +490,16 @@ interface AIClient {
         stream?: true;
     }): Promise<AsyncIterable<AIEvent>>;
     recommend(options: RecommendOptions): Promise<AsyncIterable<AIEvent> | RecommendResponse>;
+    /**
+     * Get conversation history by ID
+     *
+     * @example
+     * const conversation = await bold.ai.getConversation("550e8400-e29b-41d4-a716-446655440000");
+     * for (const msg of conversation.messages) {
+     *   console.log(`${msg.role}: ${msg.content}`);
+     * }
+     */
+    getConversation(conversationId: string): Promise<Conversation>;
 }
 
 type ClientOptions = {
@@ -496,4 +544,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, Citation, ClientOptions, DEFAULT_API_BASE_URL, DEFAULT_INTERNAL_API_BASE_URL, MenuItem, Playlist, Portal, PortalDisplay, PortalHero, PortalLayout, PortalNavigation, PortalTheme, RecommendOptions, RecommendResponse, Recommendation, RecommendationVideo, RecommendationsOptions, RecommendationsResponse, SearchOptions, Segment, Settings, Source, ThemeColors, ThemeConfig, Video, VideoAttachment, VideoDownloadUrls, VideoMetadata, VideoSubtitles, VideoTranscript, createClient };
+export { AIContextMessage, AIEvent, AIResponse, AIUsage, Account, AccountAI, AnalyticsProvider, AskOptions, AssistantConfig, ChatOptions, Citation, ClientOptions, Conversation, ConversationMessage, ConversationMetadata, CustomRedirect, DEFAULT_API_BASE_URL, DEFAULT_INTERNAL_API_BASE_URL, MenuItem, Playlist, Portal, PortalDisplay, PortalHero, 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

@@ -283,6 +283,21 @@ async function jsonRequest(path, body, config) {
   const raw = await response.json();
   return camelizeKeys(raw);
 }
+async function getRequest(path, config) {
+  const url = buildURL(config.baseURL, path);
+  const response = await fetch(url, {
+    method: "GET",
+    headers: {
+      "Accept": "application/json",
+      ...config.headers
+    }
+  });
+  if (!response.ok) {
+    throw new Error(`AI request failed: ${response.status} ${response.statusText}`);
+  }
+  const raw = await response.json();
+  return camelizeKeys(raw);
+}
 function createAI(config) {
   async function chat(options) {
     const isVideoScoped = !!options.videoId;
@@ -349,13 +364,20 @@ function createAI(config) {
   async function recommend(options) {
     return recommendations(options);
   }
+  async function getConversation(conversationId) {
+    if (!conversationId) {
+      throw new Error("conversationId is required");
+    }
+    return getRequest(`ai/chat/${conversationId}`, config);
+  }
   return {
     chat,
     ask,
     coach,
     search,
     recommendations,
-    recommend
+    recommend,
+    getConversation
   };
 }
 

package/package.json

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