@boldvideo/bold-js 1.7.0 → 1.8.0

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @boldvideo/bold-js
 
+## 1.8.0
+
+### Minor Changes
+
+- 065d7ea: Transform all API responses to use camelCase (TypeScript/JavaScript convention)
+
+  **Breaking Changes:**
+
+  - **All response types now use camelCase** (was snake_case). API responses are transformed at the SDK boundary.
+    - `video_id` → `videoId`
+    - `timestamp_end` → `timestampEnd`
+    - `playback_id` → `playbackId`
+    - `input_tokens` → `inputTokens`
+    - `conversation_id` → `conversationId`
+
+  **Internal:**
+
+  - Added `camelizeKeys` utility for deep snake_case → camelCase transformation
+  - Applied transformation in `jsonRequest()` and `parseSSE()` at the transport boundary
+
 ## 1.7.0
 
 ### Minor Changes

package/README.md

@@ -271,6 +271,26 @@ import type {
 
 ## Migration from v1.6.x
 
+### Breaking: Response types now use camelCase
+
+All API responses are now transformed to use idiomatic TypeScript/JavaScript naming:
+
+```typescript
+// Before (v1.6.x)
+source.video_id
+source.timestamp_end
+source.playback_id
+usage.input_tokens
+event.conversation_id
+
+// After (v1.7.0)
+source.videoId
+source.timestampEnd
+source.playbackId
+usage.inputTokens
+event.conversationId
+```
+
 ### Method Changes
 
 | Old | New | Notes |

package/dist/index.cjs

@@ -221,6 +221,24 @@ function basicInfos() {
   };
 }
 
+// src/util/camelize.ts
+var isPlainObject = (value) => value !== null && typeof value === "object" && (Object.getPrototypeOf(value) === Object.prototype || Object.getPrototypeOf(value) === null);
+var snakeToCamel = (key) => key.replace(/_([a-z0-9])/g, (_, c) => c.toUpperCase());
+function camelizeKeys(input) {
+  if (Array.isArray(input)) {
+    return input.map((item) => camelizeKeys(item));
+  }
+  if (!isPlainObject(input)) {
+    return input;
+  }
+  const out = {};
+  for (const [rawKey, value] of Object.entries(input)) {
+    const key = snakeToCamel(rawKey);
+    out[key] = camelizeKeys(value);
+  }
+  return out;
+}
+
 // src/lib/ai.ts
 async function* parseSSE(response) {
   const reader = response.body?.getReader();
@@ -248,7 +266,8 @@ async function* parseSSE(response) {
         if (!json)
           continue;
         try {
-          const event = JSON.parse(json);
+          const raw = JSON.parse(json);
+          const event = camelizeKeys(raw);
           yield event;
           if (event.type === "message_complete" || event.type === "error") {
             await reader.cancel();
@@ -298,7 +317,8 @@ async function jsonRequest(path, body, config) {
   if (!response.ok) {
     throw new Error(`AI request failed: ${response.status} ${response.statusText}`);
   }
-  return response.json();
+  const raw = await response.json();
+  return camelizeKeys(raw);
 }
 function createAI(config) {
   async function chat(options) {

package/dist/index.d.ts

@@ -183,29 +183,28 @@ type Settings = {
  */
 interface Source {
     id: string;
-    video_id: string;
+    videoId: string;
     title: string;
     text: string;
     timestamp: number;
-    timestamp_end: number;
-    playback_id: string;
+    timestampEnd: number;
+    playbackId: string;
     speaker?: string;
 }
 /**
  * Token usage statistics
  */
 interface AIUsage {
-    input_tokens: number;
-    output_tokens: number;
+    inputTokens: number;
+    outputTokens: number;
 }
 /**
  * SSE event types for AI streaming responses
  */
 type AIEvent = {
     type: "message_start";
-    id: string;
-    conversation_id?: string;
-    video_id?: string;
+    conversationId?: string;
+    videoId?: string;
 } | {
     type: "sources";
     sources: Source[];
@@ -221,8 +220,7 @@ type AIEvent = {
     recommendations: Recommendation[];
 } | {
     type: "message_complete";
-    id: string;
-    conversation_id?: string;
+    conversationId?: string;
     content: string;
     sources: Source[];
     usage?: AIUsage;
@@ -236,10 +234,13 @@ type AIEvent = {
     retryable: boolean;
 };
 /**
- * Non-streaming AI response
+ * Non-streaming AI response for /ai/chat, /ai/videos/:id/chat, and /ai/search
  */
 interface AIResponse {
-    id: string;
+    conversationId?: string;
+    videoId?: string;
+    /** @deprecated Use conversationId instead. Will be removed in v2. */
+    id?: string;
     content: string;
     sources: Source[];
     usage: AIUsage;
@@ -295,9 +296,9 @@ interface SearchOptions {
  * A recommended video with relevance score
  */
 interface RecommendationVideo {
-    video_id: string;
+    videoId: string;
     title: string;
-    playback_id: string;
+    playbackId: string;
     relevance: number;
     reason: string;
 }
@@ -328,7 +329,6 @@ type RecommendOptions = RecommendationsOptions;
  * Non-streaming response for recommendations endpoint
  */
 interface RecommendationsResponse {
-    id: string;
     recommendations: Recommendation[];
     guidance: string;
     sources: Source[];

package/dist/index.js

@@ -183,6 +183,24 @@ function basicInfos() {
   };
 }
 
+// src/util/camelize.ts
+var isPlainObject = (value) => value !== null && typeof value === "object" && (Object.getPrototypeOf(value) === Object.prototype || Object.getPrototypeOf(value) === null);
+var snakeToCamel = (key) => key.replace(/_([a-z0-9])/g, (_, c) => c.toUpperCase());
+function camelizeKeys(input) {
+  if (Array.isArray(input)) {
+    return input.map((item) => camelizeKeys(item));
+  }
+  if (!isPlainObject(input)) {
+    return input;
+  }
+  const out = {};
+  for (const [rawKey, value] of Object.entries(input)) {
+    const key = snakeToCamel(rawKey);
+    out[key] = camelizeKeys(value);
+  }
+  return out;
+}
+
 // src/lib/ai.ts
 async function* parseSSE(response) {
   const reader = response.body?.getReader();
@@ -210,7 +228,8 @@ async function* parseSSE(response) {
         if (!json)
           continue;
         try {
-          const event = JSON.parse(json);
+          const raw = JSON.parse(json);
+          const event = camelizeKeys(raw);
           yield event;
           if (event.type === "message_complete" || event.type === "error") {
             await reader.cancel();
@@ -260,7 +279,8 @@ async function jsonRequest(path, body, config) {
   if (!response.ok) {
     throw new Error(`AI request failed: ${response.status} ${response.statusText}`);
   }
-  return response.json();
+  const raw = await response.json();
+  return camelizeKeys(raw);
 }
 function createAI(config) {
   async function chat(options) {

package/llms.txt

@@ -110,6 +110,8 @@ Key types exported:
 - `ChatOptions`, `SearchOptions`
 - `RecommendationsOptions`, `RecommendationsResponse`, `Recommendation`, `RecommendationVideo`
 
+All response types use camelCase (e.g., `source.videoId`, `source.timestampEnd`, `usage.inputTokens`).
+
 ## Links
 
 - [GitHub](https://github.com/boldvideo/bold-js)

package/package.json

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