@boldvideo/bold-js 0.4.1 → 0.4.3

package/.claude/settings.local.json

@@ -0,0 +1,9 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(pnpm run lint:*)",
+      "Bash(ls:*)"
+    ]
+  },
+  "enableAllProjectMcpServers": false
+}

package/CHANGELOG.md

@@ -0,0 +1,7 @@
+# @boldvideo/bold-js
+
+## 0.4.3
+
+### Patch Changes
+
+- New `has_ai` field to settings

package/CLAUDE.md

@@ -0,0 +1,76 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+This is the Bold JavaScript SDK (`@boldvideo/bold-js`) - a TypeScript client library for interacting with the Bold Video API. The SDK provides methods for fetching videos, playlists, channel settings, and tracking analytics events.
+
+## Common Development Commands
+
+```bash
+# Install dependencies
+pnpm install
+
+# Build the project (outputs to dist/)
+pnpm run build
+
+# Run type checking/linting
+pnpm run lint
+
+# Publish new version (uses changesets)
+pnpm changeset
+pnpm changeset version
+pnpm changeset publish
+```
+
+## Architecture & Key Components
+
+### Client Structure
+The SDK uses a factory pattern where `createClient(apiKey)` returns an object with namespaced methods:
+- `bold.settings()` - Fetch channel settings
+- `bold.videos.list()` / `.get(id)` / `.search(query)` - Video operations
+- `bold.playlists.list()` / `.get(id)` - Playlist operations
+- `bold.trackEvent()` / `bold.trackPageView()` - Analytics tracking
+
+### Core Files
+- `/src/index.ts` - Main entry point, exports `createClient` and all types
+- `/src/lib/client.ts` - Client factory that creates the Bold instance with API key auth
+- `/src/lib/fetchers.ts` - Individual API endpoint implementations
+- `/src/lib/tracking.ts` - Analytics event tracking with throttling
+- `/src/lib/types.ts` - TypeScript interfaces for Video, Playlist, Settings, etc.
+- `/src/util/throttle.ts` - Throttling utility for rate-limiting event tracking
+
+### Build Configuration
+- Uses `tsup` for building TypeScript to both ESM and CommonJS formats
+- Outputs to `/dist/` with type declarations
+- TypeScript strict mode enabled
+- Target: ES2016
+
+## Development Workflow
+
+1. The project uses GitHub Actions for CI/CD:
+   - All branches run lint and build checks
+   - Main branch can publish to npm using changesets
+
+2. When making changes:
+   - Ensure TypeScript types are properly defined
+   - Run `pnpm run lint` before committing
+   - The SDK supports both ESM and CommonJS consumers
+
+3. API Integration:
+   - Default base URL: `https://app.boldvideo.io/api/v1/`
+   - Authentication via API key in Authorization header
+   - All API methods return promises
+
+4. Analytics Tracking:
+   - Events are throttled to prevent API rate limiting
+   - User IDs are auto-generated for each client instance
+   - Debug mode available for development
+
+## Important Notes
+
+- No test framework is currently configured
+- The SDK is designed to be lightweight with minimal dependencies (only axios)
+- All API responses follow the type definitions in `/src/lib/types.ts`
+- The tracking system includes automatic throttling to handle high-frequency events like video progress updates

package/README.md

@@ -1,10 +1,10 @@
 <div align="center">
-    <a href="https://wearebold.af?utm_source=github.com&utm_medium=readme&utm_campaign=bold-js" align="center">
-		<img src="https://wearebold.af/bold-js-github-header.svg"  alt="Bold Logo">
+    <a href="https://boldvideo.com?utm_source=github.com&utm_medium=readme&utm_campaign=bold-js" align="center">
+		<img src="https://boldvideo.com/bold-js-github-header.svg"  alt="Bold Logo">
 	</a>
 	<h1 align="center rainbow">@boldvideo/bold-js</h1>
     <p align="center">
-        The JavaScript SDK for interacting with the <a href="http://wearebold.af?utm_source=github.com&utm_medium=readme&utm_campaign=bold-js" target="_blank">Bold API</a>, to power your own business video platform.
+        The JavaScript SDK for interacting with the <a href="https://boldvideo.com?utm_source=github.com&utm_medium=readme&utm_campaign=bold-js" target="_blank">Bold API</a>, to power your own business video platform.
     </p>
 </div>
 

package/dist/index.cjs

@@ -72,11 +72,9 @@ __export(src_exports, {
 module.exports = __toCommonJS(src_exports);
 
 // src/lib/client.ts
-var import_axios2 = __toESM(require("axios"), 1);
-var import_js_cookie = __toESM(require("js-cookie"), 1);
+var import_axios = __toESM(require("axios"), 1);
 
 // src/lib/fetchers.ts
-var import_axios = __toESM(require("axios"), 1);
 function get(client, url) {
   return __async(this, null, function* () {
     try {
@@ -86,16 +84,7 @@ function get(client, url) {
       }
       return res.data;
     } catch (error) {
-      if (import_axios.default.isAxiosError(error)) {
-        console.error("fetching error details:", {
-          message: error.message,
-          code: error.code,
-          config: error.config,
-          response: error.response
-        });
-      } else {
-        console.error(`Error fetching data from URL: ${url}`, error);
-      }
+      console.error(`Error fetching data from URL: ${url}`, error);
       throw error;
     }
   });
@@ -269,39 +258,26 @@ function basicInfos() {
 }
 
 // src/lib/client.ts
-var generateUserId = () => {
-  return [...Array(30)].map(() => Math.random().toString(36)[2]).join("");
-};
-var getUserId = () => {
-  const localStorageKey = "boldvideo_user_id";
-  let userId = import_js_cookie.default.get(localStorageKey);
-  if (!userId) {
-    userId = generateUserId();
-    import_js_cookie.default.set(localStorageKey, userId, { expires: 365 });
-  }
-  return userId;
-};
 function createClient(apiKey, options = { debug: false }) {
   var _a;
   if (!apiKey || typeof apiKey !== "string") {
     throw new Error("API key is missing or invalid");
   }
-  const userId = getUserId();
   const { debug } = options;
   const apiClientOptions = {
     baseURL: (_a = options.baseURL) != null ? _a : "https://app.boldvideo.io/api/v1/",
     headers: {
-      Authorization: apiKey,
-      "X-User-Id": userId
+      Authorization: apiKey
     }
   };
   let apiClient;
   try {
-    apiClient = import_axios2.default.create(apiClientOptions);
+    apiClient = import_axios.default.create(apiClientOptions);
   } catch (error) {
     console.error("Error creating API client", error);
     throw error;
   }
+  const userId = [...Array(30)].map(() => Math.random().toString(36)[2]).join("");
   return {
     settings: fetchSettings(apiClient),
     videos: {

package/dist/index.d.ts

@@ -34,6 +34,9 @@ type MenuItem = {
 type Settings = {
     featured_playlists: Playlist[];
     menu_items: MenuItem[];
+    ai_avatar: string;
+    ai_name: string;
+    has_ai: boolean;
     meta_data: {
         channel_name: string;
         description: string;

package/dist/index.js

@@ -39,11 +39,9 @@ var __async = (__this, __arguments, generator) => {
 };
 
 // src/lib/client.ts
-import axios2 from "axios";
-import Cookies from "js-cookie";
+import axios from "axios";
 
 // src/lib/fetchers.ts
-import axios from "axios";
 function get(client, url) {
   return __async(this, null, function* () {
     try {
@@ -53,16 +51,7 @@ function get(client, url) {
       }
       return res.data;
     } catch (error) {
-      if (axios.isAxiosError(error)) {
-        console.error("fetching error details:", {
-          message: error.message,
-          code: error.code,
-          config: error.config,
-          response: error.response
-        });
-      } else {
-        console.error(`Error fetching data from URL: ${url}`, error);
-      }
+      console.error(`Error fetching data from URL: ${url}`, error);
       throw error;
     }
   });
@@ -236,39 +225,26 @@ function basicInfos() {
 }
 
 // src/lib/client.ts
-var generateUserId = () => {
-  return [...Array(30)].map(() => Math.random().toString(36)[2]).join("");
-};
-var getUserId = () => {
-  const localStorageKey = "boldvideo_user_id";
-  let userId = Cookies.get(localStorageKey);
-  if (!userId) {
-    userId = generateUserId();
-    Cookies.set(localStorageKey, userId, { expires: 365 });
-  }
-  return userId;
-};
 function createClient(apiKey, options = { debug: false }) {
   var _a;
   if (!apiKey || typeof apiKey !== "string") {
     throw new Error("API key is missing or invalid");
   }
-  const userId = getUserId();
   const { debug } = options;
   const apiClientOptions = {
     baseURL: (_a = options.baseURL) != null ? _a : "https://app.boldvideo.io/api/v1/",
     headers: {
-      Authorization: apiKey,
-      "X-User-Id": userId
+      Authorization: apiKey
     }
   };
   let apiClient;
   try {
-    apiClient = axios2.create(apiClientOptions);
+    apiClient = axios.create(apiClientOptions);
   } catch (error) {
     console.error("Error creating API client", error);
     throw error;
   }
+  const userId = [...Array(30)].map(() => Math.random().toString(36)[2]).join("");
   return {
     settings: fetchSettings(apiClient),
     videos: {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@boldvideo/bold-js",
   "license": "MIT",
-  "version": "0.4.1",
+  "version": "0.4.3",
   "main": "dist/index.js",
   "module": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -17,5 +17,6 @@
   },
   "dependencies": {
     "axios": "^1.3.6"
-  }
+  },
+  "packageManager": "pnpm@10.12.2+sha512.a32540185b964ee30bb4e979e405adc6af59226b438ee4cc19f9e8773667a66d302f5bfee60a39d3cac69e35e4b96e708a71dd002b7e9359c4112a1722ac323f"
 }

package/src/lib/types.ts

@@ -39,6 +39,7 @@ export type Settings = {
   menu_items: MenuItem[];
   ai_avatar: string;
   ai_name: string;
+  has_ai: boolean;
   meta_data: {
     channel_name: string;
     description: string;