@boldvideo/bold-js 0.5.0 → 0.6.1

package/dist/index.js

@@ -0,0 +1,265 @@
+var __defProp = Object.defineProperty;
+var __defProps = Object.defineProperties;
+var __getOwnPropDescs = Object.getOwnPropertyDescriptors;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
+var __async = (__this, __arguments, generator) => {
+  return new Promise((resolve, reject) => {
+    var fulfilled = (value) => {
+      try {
+        step(generator.next(value));
+      } catch (e) {
+        reject(e);
+      }
+    };
+    var rejected = (value) => {
+      try {
+        step(generator.throw(value));
+      } catch (e) {
+        reject(e);
+      }
+    };
+    var step = (x) => x.done ? resolve(x.value) : Promise.resolve(x.value).then(fulfilled, rejected);
+    step((generator = generator.apply(__this, __arguments)).next());
+  });
+};
+
+// src/lib/client.ts
+import axios from "axios";
+
+// src/lib/fetchers.ts
+function get(client, url) {
+  return __async(this, null, function* () {
+    try {
+      const res = yield client.get(url);
+      if (res.status !== 200) {
+        throw new Error(`Unexpected response status: ${res.status}`);
+      }
+      return res.data;
+    } catch (error) {
+      console.error(`Error fetching data from URL: ${url}`, error);
+      throw error;
+    }
+  });
+}
+function fetchSettings(client) {
+  return (videoLimit = 12) => __async(this, null, function* () {
+    try {
+      return yield get(
+        client,
+        `settings?limit=${videoLimit}`
+      );
+    } catch (error) {
+      console.error(`Error fetching settings with limit: ${videoLimit}`, error);
+      throw error;
+    }
+  });
+}
+function fetchVideos(client) {
+  return (videoLimit = 12) => __async(this, null, function* () {
+    try {
+      return yield get(
+        client,
+        `videos/latest?limit=${videoLimit}`
+      );
+    } catch (error) {
+      console.error(`Error fetching videos with limit: ${videoLimit}`, error);
+      throw error;
+    }
+  });
+}
+function searchVideos(client) {
+  return (term) => __async(this, null, function* () {
+    try {
+      return yield get(client, `videos?query=${term}`);
+    } catch (error) {
+      console.error(`Error searching for videos with term: ${term}`, error);
+      throw error;
+    }
+  });
+}
+function fetchVideo(client) {
+  return (id) => __async(this, null, function* () {
+    try {
+      return yield get(client, `videos/${id}`);
+    } catch (error) {
+      console.error(`Error fetching video with ID: ${id}`, error);
+      throw error;
+    }
+  });
+}
+function fetchPlaylists(client) {
+  return () => __async(this, null, function* () {
+    try {
+      return yield get(client, "playlists");
+    } catch (error) {
+      console.error("Error fetching playlists", error);
+      throw error;
+    }
+  });
+}
+function fetchPlaylist(client) {
+  return (id) => __async(this, null, function* () {
+    try {
+      return yield get(client, `playlists/${id}`);
+    } catch (error) {
+      console.error(`Error fetching playlist with ID: ${id}`, error);
+      throw error;
+    }
+  });
+}
+
+// src/util/throttle.ts
+var throttle = (fn, delay) => {
+  let wait = false;
+  let timeout;
+  let cancelled = false;
+  return [
+    (...args) => {
+      if (cancelled)
+        return void 0;
+      if (wait)
+        return void 0;
+      const val = fn(...args);
+      wait = true;
+      timeout = window.setTimeout(() => {
+        wait = false;
+      }, delay);
+      return val;
+    },
+    () => {
+      cancelled = true;
+      clearTimeout(timeout);
+    }
+  ];
+};
+
+// src/lib/tracking.ts
+function sendEvent(client, eventName, data, debug) {
+  const payload = {
+    n: eventName,
+    u: data.url,
+    usr: data.userId,
+    d: data.domain,
+    ua: data.userAgent,
+    w: data.deviceWidth,
+    vid: (data == null ? void 0 : data.videoId) || void 0,
+    vt: data.title,
+    vdur: (data == null ? void 0 : data.videoDuration) || void 0,
+    time: (data == null ? void 0 : data.currentTime) || void 0
+  };
+  if (debug)
+    console.log(`Bold SDK - Logging event '${eventName}'`, payload);
+  client.post("/event", payload);
+}
+var [throttledSendEvent] = throttle(sendEvent, 5e3);
+function trackEvent(client, userId, options) {
+  return (video, event) => {
+    var _a;
+    const eventDetails = __spreadProps(__spreadValues({}, basicInfos()), {
+      userId,
+      videoId: video.id,
+      title: video.title,
+      videoDuration: video.duration,
+      currentTime: ((_a = event.target) == null ? void 0 : _a.currentTime) || 0
+    });
+    if (event.type == "timeupdate" || event.type == "time-update") {
+      throttledSendEvent(
+        client,
+        getEventName(event),
+        eventDetails,
+        options.debug
+      );
+    } else {
+      sendEvent(client, getEventName(event), eventDetails, options.debug);
+    }
+  };
+}
+function trackPageView(client, userId, options) {
+  return (title) => {
+    const eventDetails = __spreadProps(__spreadValues({}, basicInfos()), {
+      userId,
+      title
+    });
+    sendEvent(client, "page_view", eventDetails, options.debug);
+  };
+}
+function getEventName(event) {
+  switch (event.type) {
+    case "pause":
+      return "video_pause";
+    case "play":
+      return "video_resume";
+    case "loadedmetadata":
+    case "loaded-metadata":
+      return "video_load";
+    case "time-update":
+    case "timeupdate":
+      return "video_progress";
+    default:
+      return "unknown_event";
+  }
+}
+function basicInfos() {
+  return {
+    url: location.href,
+    domain: location.hostname,
+    referrer: document.referrer || null,
+    deviceWidth: window.innerWidth,
+    userAgent: navigator.userAgent
+  };
+}
+
+// src/lib/client.ts
+function createClient(apiKey, options = { debug: false }) {
+  var _a;
+  if (!apiKey || typeof apiKey !== "string") {
+    throw new Error("API key is missing or invalid");
+  }
+  const { debug } = options;
+  const apiClientOptions = {
+    baseURL: (_a = options.baseURL) != null ? _a : "https://app.boldvideo.io/api/v1/",
+    headers: {
+      Authorization: apiKey
+    }
+  };
+  let apiClient;
+  try {
+    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: {
+      list: fetchVideos(apiClient),
+      get: fetchVideo(apiClient),
+      search: searchVideos(apiClient)
+    },
+    playlists: {
+      list: fetchPlaylists(apiClient),
+      get: fetchPlaylist(apiClient)
+    },
+    trackEvent: trackEvent(apiClient, userId, { debug }),
+    trackPageView: trackPageView(apiClient, userId, { debug })
+  };
+}
+export {
+  createClient
+};

package/package.json

@@ -1,11 +1,14 @@
 {
   "name": "@boldvideo/bold-js",
   "license": "MIT",
-  "version": "0.5.0",
+  "version": "0.6.1",
   "main": "dist/index.js",
   "module": "dist/index.js",
   "types": "dist/index.d.ts",
   "type": "module",
+  "engines": {
+    "node": ">=20.0.0"
+  },
   "repository": {
     "type": "git",
     "url": "https://github.com/boldvideo/bold-js"

package/.changeset/README.md

@@ -1,8 +0,0 @@
-# Changesets
-
-Hello and welcome! This folder has been automatically generated by `@changesets/cli`, a build tool that works
-with multi-package repos, or single-package repos to help you version and publish your code. You can
-find the full documentation for it [in our repository](https://github.com/changesets/changesets)
-
-We have a quick list of common questions to get you started engaging with this project in
-[our documentation](https://github.com/changesets/changesets/blob/main/docs/common-questions.md)

package/.changeset/config.json

@@ -1,11 +0,0 @@
-{
-  "$schema": "https://unpkg.com/@changesets/config@2.3.0/schema.json",
-  "changelog": "@changesets/cli/changelog",
-  "commit": false,
-  "fixed": [],
-  "linked": [],
-  "access": "restricted",
-  "baseBranch": "main",
-  "updateInternalDependencies": "patch",
-  "ignore": []
-}

package/.github/dependabot.yml

@@ -1,11 +0,0 @@
-version: 2
-updates:
-  - package-ecosystem: "npm"
-    directory: "/"
-    schedule:
-      interval: "weekly"
-    open-pull-requests-limit: 10
-    groups:
-      dependencies:
-        patterns:
-          - "*"

package/.github/workflow/main.yml

@@ -1,21 +0,0 @@
-name: CI
-on:
-  push:
-    branches:
-      - "**"
-
-jobs:
-  build:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v3
-      - uses: pnpm/action-setup@v2
-        with:
-          version: 7
-      - uses: actions/setup-node@v3
-        with:
-          node-version: 16.x
-          cache: "pnpm"
-
-      - run: pnpm install --frozen-lockfile
-      - run: pnpm run lint && pnpm run build

package/.github/workflow/publish.yml

@@ -1,29 +0,0 @@
-name: Publish
-on:
-  push:
-    branches:
-      - "main"
-
-concurrency: ${{ github.workflow }}-${{ github.ref }}
-
-jobs:
-  build:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v3
-      - uses: pnpm/action-setup@v2
-        with:
-          version: 7
-      - uses: actions/setup-node@v3
-        with:
-          node-version: 16.x
-          cache: "pnpm"
-
-      - run: pnpm install --frozen-lockfile
-      - name: Create Release Pull Request or Publish
-        id: changesets
-        uses: changesets/action@v1
-        with:
-          publish: pnpm run build
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

package/.github/workflows/changeset-release.yml

@@ -1,51 +0,0 @@
-name: Changeset Release
-
-on:
-  push:
-    branches:
-      - main
-
-concurrency: ${{ github.workflow }}-${{ github.ref }}
-
-permissions:
-  contents: write
-  pull-requests: write
-  id-token: write  # For npm provenance
-
-jobs:
-  release:
-    name: Release
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-      
-      - name: Install pnpm
-        uses: pnpm/action-setup@v2
-        with:
-          version: 10.12.2
-      
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: 20.x
-          cache: 'pnpm'
-          registry-url: 'https://registry.npmjs.org'
-      
-      - name: Install dependencies
-        run: pnpm install --frozen-lockfile
-      
-      - name: Create Release Pull Request or Publish to npm
-        id: changesets
-        uses: changesets/action@v1
-        with:
-          title: "chore: release package"
-          commit: "chore: release package"
-          publish: pnpm changeset publish
-          createGithubReleases: true
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-          NPM_CONFIG_PROVENANCE: true

package/.github/workflows/ci.yml

@@ -1,88 +0,0 @@
-name: CI
-
-on:
-  push:
-    branches: [ main ]
-  pull_request:
-    branches: [ main ]
-
-jobs:
-  test:
-    name: Test on Node ${{ matrix.node-version }}
-    runs-on: ubuntu-latest
-    
-    strategy:
-      matrix:
-        node-version: [16.x, 18.x, 20.x]
-    
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v4
-      
-      - name: Install pnpm
-        uses: pnpm/action-setup@v2
-        with:
-          version: 10.12.2
-      
-      - name: Use Node.js ${{ matrix.node-version }}
-        uses: actions/setup-node@v4
-        with:
-          node-version: ${{ matrix.node-version }}
-          cache: 'pnpm'
-      
-      - name: Install dependencies
-        run: pnpm install --frozen-lockfile
-      
-      - name: Run linter
-        run: pnpm run lint
-      
-      - name: Build package
-        run: pnpm run build
-      
-      - name: Check package exports
-        run: |
-          node -e "const pkg = require('./dist/index.cjs'); console.log('CJS import successful');"
-          node -e "import('./dist/index.js').then(() => console.log('ESM import successful'));"
-      
-      - name: Check TypeScript declarations
-        run: |
-          if [ ! -f "dist/index.d.ts" ]; then
-            echo "TypeScript declarations not found!"
-            exit 1
-          fi
-
-  size-check:
-    name: Bundle Size Check
-    runs-on: ubuntu-latest
-    
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v4
-      
-      - name: Install pnpm
-        uses: pnpm/action-setup@v2
-        with:
-          version: 10.12.2
-      
-      - name: Use Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: 20.x
-          cache: 'pnpm'
-      
-      - name: Install dependencies
-        run: pnpm install --frozen-lockfile
-      
-      - name: Build package
-        run: pnpm run build
-      
-      - name: Check bundle size
-        run: |
-          echo "Bundle sizes:"
-          ls -lh dist/
-          
-          # Warn if bundle exceeds 50KB (adjust threshold as needed)
-          size=$(stat -c%s dist/index.js 2>/dev/null || stat -f%z dist/index.js)
-          if [ $size -gt 51200 ]; then
-            echo "⚠️  Warning: Bundle size exceeds 50KB"
-          fi

package/.github/workflows/release.yml

@@ -1,83 +0,0 @@
-name: Release
-
-on:
-  push:
-    tags:
-      - 'v*'
-
-permissions:
-  contents: read
-  id-token: write  # For npm provenance
-
-jobs:
-  release:
-    name: Release to npm
-    runs-on: ubuntu-latest
-    
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 0  # Needed for changelog generation
-      
-      - name: Install pnpm
-        uses: pnpm/action-setup@v2
-        with:
-          version: 10.12.2
-      
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: 20.x
-          cache: 'pnpm'
-          registry-url: 'https://registry.npmjs.org'
-      
-      - name: Install dependencies
-        run: pnpm install --frozen-lockfile
-      
-      - name: Run CI checks
-        run: |
-          pnpm run lint
-          pnpm run build
-      
-      - name: Verify version matches tag
-        run: |
-          PACKAGE_VERSION="v$(node -p "require('./package.json').version")"
-          if [ "$PACKAGE_VERSION" != "${{ github.ref_name }}" ]; then
-            echo "Error: Package version ($PACKAGE_VERSION) doesn't match tag (${{ github.ref_name }})"
-            exit 1
-          fi
-      
-      - name: Check npm access
-        run: npm whoami
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-      
-      - name: Publish to npm with provenance
-        run: pnpm publish --access public --no-git-checks
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-          NPM_CONFIG_PROVENANCE: true
-      
-      - name: Create GitHub Release
-        uses: softprops/action-gh-release@v1
-        with:
-          generate_release_notes: true
-          body: |
-            ## What's Changed
-            
-            See [CHANGELOG.md](https://github.com/${{ github.repository }}/blob/main/CHANGELOG.md) for details.
-            
-            ## Installation
-            
-            ```bash
-            npm install @boldvideo/bold-js@${{ github.ref_name }}
-            ```
-            
-            ```bash
-            pnpm add @boldvideo/bold-js@${{ github.ref_name }}
-            ```
-            
-            ```bash
-            yarn add @boldvideo/bold-js@${{ github.ref_name }}
-            ```

package/CLAUDE.md

@@ -1,76 +0,0 @@
-# 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