stormcloud-video-player 0.1.3 → 0.1.5

package/README.md

@@ -27,6 +27,31 @@ npm install stormcloud-video-player hls.js
 
 This library targets modern browsers (ES2020) and expects a DOM environment.
 
+### CDN Usage
+
+You can also use the library directly from CDN without npm:
+
+```html
+<!-- Use latest version (recommended for development) -->
+<script src="https://cdn.jsdelivr.net/npm/stormcloud-video-player/dist/stormcloud-vp.min.js"></script>
+
+<script>
+  // The library is available as window.StormcloudVideoPlayer
+  const { StormcloudVideoPlayer } = window.StormcloudVideoPlayer;
+
+  const video = document.getElementById("video");
+  const player = new StormcloudVideoPlayer({
+    videoElement: video,
+    src: "https://example.com/live/playlist.m3u8",
+    autoplay: true,
+    muted: true,
+    allowNativeHls: false,
+  });
+
+  player.load();
+</script>
+```
+
 ---
 
 ## Quick start
@@ -45,6 +70,7 @@ function MyApp() {
       muted={true}
       allowNativeHls={false}
       controls={true}
+      licenseKey="your_license_key_here"
       style={{ width: "640px", height: "360px" }}
       adSchedule={{
         lateJoinPolicy: "play_remaining",
@@ -87,6 +113,7 @@ function MyApp() {
     autoplay: true,
     muted: true,
     allowNativeHls: false,
+    licenseKey: "your_license_key_here", // Optional
     // Optional external ad schedule
     adSchedule: {
       lateJoinPolicy: "play_remaining",
@@ -141,11 +168,41 @@ interface StormcloudVideoPlayerConfig {
   allowNativeHls?: boolean;
   adSchedule?: AdSchedule;
   defaultVastTagUrl?: string;
+  licenseKey?: string;
 }
 ```
 
 ---
 
+## License Key Authentication
+
+The player supports license key authentication for API calls. When a `licenseKey` is provided, it will be included as a `Bearer` token in the `Authorization` header for all API requests to:
+
+- Ad configuration endpoint: `https://adstorm.co/api-adstorm-dev/adstorm/ads/web`
+- Initial tracking: `https://adstorm.co/api-adstorm-dev/adstorm/player-tracking/track`
+- Heartbeat tracking: `https://adstorm.co/api-adstorm-dev/adstorm/player-tracking/heartbeat`
+
+### Usage
+
+```javascript
+// Vanilla JavaScript
+const player = new StormcloudVideoPlayer({
+  videoElement: video,
+  src: "https://example.com/stream.m3u8",
+  licenseKey: "your_license_key_here" // Optional
+});
+
+// React Component
+<StormcloudVideoPlayerComponent
+  src="https://example.com/stream.m3u8"
+  licenseKey="your_license_key_here" // Optional
+/>
+```
+
+The license key is optional and the player will work without it, but some API features may be limited or unavailable.
+
+---
+
 ## How ad alignment works
 
 - On `CUE-OUT`/`DATERANGE` start: request IMA ads and start playback immediately; if duration is known, a countdown is scheduled to auto-stop if `CUE-IN` is missing.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stormcloud-video-player",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "main": "lib/index.cjs",
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1",
@@ -11,10 +11,30 @@
     "clean": "rm -rf lib dist",
     "build:lib": "npm run build"
   },
-  "keywords": [],
-  "author": "",
-  "license": "ISC",
-  "description": "",
+  "description": "Ad-first HLS video player with SCTE-35 support and Google IMA integration for precise ad break alignment",
+  "keywords": [
+    "video",
+    "player",
+    "hls",
+    "streaming",
+    "ads",
+    "advertising",
+    "scte-35",
+    "ima",
+    "vast",
+    "vpaid",
+    "live-streaming",
+    "video-ads",
+    "ad-insertion",
+    "broadcast",
+    "ott",
+    "connected-tv",
+    "ctv",
+    "react",
+    "typescript"
+  ],
+  "author": "Showfer Media LLC",
+  "license": "MIT",
   "dependencies": {
     "hls.js": "^1.6.11"
   },
@@ -41,5 +61,17 @@
   "peerDependencies": {
     "react": ">=17",
     "react-dom": ">=17"
+  },
+  "engines": {
+    "node": ">=16"
+  },
+  "files": [
+    "lib/**/*",
+    "dist/**/*",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
   }
 }

package/rollup.config.js

@@ -1,51 +0,0 @@
-import resolve from "@rollup/plugin-node-resolve";
-import commonjs from "@rollup/plugin-commonjs";
-import terser from "@rollup/plugin-terser";
-import typescript from "@rollup/plugin-typescript";
-
-export default {
-  input: "src/index.ts",
-
-  output: {
-    file: "dist/stormcloud-vp.min.js",
-    format: "umd",
-    name: "StormcloudVP",
-    sourcemap: false,
-    globals: {},
-  },
-
-  plugins: [
-    resolve({
-      browser: true,
-      preferBuiltins: false,
-    }),
-    commonjs({
-      include: ["node_modules/**"],
-    }),
-    typescript({
-      tsconfig: "./tsconfig.json",
-      sourceMap: false,
-      inlineSources: false,
-      declaration: false,
-      declarationMap: false,
-    }),
-    terser({
-      compress: {
-        drop_console: false,
-        drop_debugger: true,
-        pure_funcs: ["console.debug"],
-      },
-      mangle: {
-        reserved: ["StormcloudVP"],
-      },
-    }),
-  ],
-
-  external: [],
-
-  onwarn(warning, warn) {
-    if (warning.code === "CIRCULAR_DEPENDENCY") return;
-    if (warning.code === "THIS_IS_UNDEFINED") return;
-    warn(warning);
-  },
-};

package/src/index.ts

@@ -1,20 +0,0 @@
-export { StormcloudVideoPlayer } from "./player/StormcloudVideoPlayer";
-export type {
-  StormcloudVideoPlayerConfig,
-  AdBreak,
-  AdSchedule,
-  LateJoinPolicy,
-  ClientInfo,
-  TrackingData,
-  HeartbeatData,
-} from "./types";
-
-export { StormcloudVideoPlayerComponent } from "./ui/StormcloudVideoPlayer";
-export type { StormcloudVideoPlayerProps } from "./ui/StormcloudVideoPlayer";
-
-export {
-  getClientInfo,
-  getBrowserID,
-  sendInitialTracking,
-  sendHeartbeat,
-} from "./utils/tracking";