stormcloud-video-player 0.8.73 → 0.8.75

package/README.md

@@ -44,7 +44,6 @@ function MyVideoApp() {
       hideLoadingIndicator={false} // Hide the built-in loading spinner
       allowNativeHls={true} // Allow native HLS for better performance
       licenseKey="your_license_key_here"
-      vastMode="adstorm" // AdStorm VAST endpoint resolution
       isVmap={true}
       vmapUrl="https://your-cdn.com/ads.vmap" // Optional VMAP manifest for scheduled breaks
       style={{ width: "100%", aspectRatio: "16/9" }}
@@ -84,7 +83,6 @@ function MyVideoApp() {
       showCustomControls={true}
       hideLoadingIndicator={false}
       licenseKey="your_license_key_here"
-      vastMode="adstorm" // Use AdStorm mode (or omit for default mode)
       vmapUrl="https://your-cdn.com/ads.vmap" // Optional: VMAP manifest URL
       onReady={(player) => {
         console.log("Player is ready!", player);
@@ -125,7 +123,6 @@ const player = new StormcloudVideoPlayer({
   lowLatencyMode: false, // Set to true for live streams
   driftToleranceMs: 3000, // Drift tolerance for live streams
   licenseKey: "your_license_key_here",
-  vastMode: "default", // "adstorm" | "default"
   vmapUrl: "https://your-cdn.com/ads.vmap", // Optional VMAP manifest for scheduled ad breaks
   onVolumeToggle: () => console.log("Volume toggled"),
   onFullscreenToggle: () => console.log("Fullscreen toggled"),
@@ -280,7 +277,6 @@ interface StormcloudPlayerProps {
   minSegmentsBeforePlay?: number; // Number of segments to buffer before starting playback (default: 2)
 
   // Ad player configuration
-  vastMode?: 'adstorm' | 'default'; // VAST endpoint resolution: 'adstorm' (/vast/{licenseKey}) or 'default' (/ads/web or vastTagUrl) (default: 'default')
   vastTagUrl?: string; // Custom VAST tag URL (default mode; when omitted, /ads/web supplies the tag URL)
   isVmap?: boolean; // Enable VMAP manifest scheduling (requires vmapUrl)
   vmapUrl?: string; // VMAP 1.0 manifest URL for pre/mid/post-roll ad breaks (requires isVmap: true)
@@ -373,7 +369,6 @@ interface StormcloudVideoPlayerConfig {
   maxAdBreakExtensionMs?: number; // Max time an ad break may be extended past its SCTE-35 duration when ads are still playing/queued (default: 60000)
 
   // Ad configuration
-  vastMode?: 'adstorm' | 'default'; // VAST endpoint resolution: 'adstorm' (/vast/{licenseKey}) or 'default' (/ads/web or vastTagUrl) (default: 'default')
   vastTagUrl?: string; // Custom VAST tag URL (default mode; when omitted, /ads/web supplies the tag URL)
   isVmap?: boolean; // Enable VMAP manifest scheduling (requires vmapUrl)
   vmapUrl?: string; // VMAP 1.0 manifest URL (requires isVmap: true)
@@ -439,13 +434,9 @@ All controls use a consistent high-contrast design:
 
 ## 🎬 Ad Integration (HLS Streams Only)
 
-### VAST Mode Configuration
+### VAST Tag Configuration
 
-The player always uses the **HLS ad player** to fetch VAST XML and play ad media (HLS or progressive). The `vastMode` option only controls **which endpoint supplies the VAST tag URL**:
-
-#### 1. **AdStorm Mode** (Recommended)
-
-Uses the AdStorm `/vast/{licenseKey}` endpoint, which returns VAST XML directly:
+The player always uses the **HLS ad player** to fetch VAST XML and play ad media (HLS or progressive). The VAST tag URL comes from a custom `vastTagUrl` or, if none is provided, from the Stormcloud `/ads/web` API:
 
 ```javascript
 const player = new StormcloudVideoPlayer({
@@ -453,44 +444,6 @@ const player = new StormcloudVideoPlayer({
   src: "https://your-stream.com/playlist.m3u8",
   licenseKey: "your-license-key",
 
-  vastMode: 'adstorm',
-
-  debugAdTiming: true,
-});
-```
-
-**What happens:**
-- 🔗 VAST endpoint: `GET https://adstorm.co/api-adstorm-dev/adstorm/vast/{licenseKey}`
-  - License key is passed in the URL path (no authorization header needed)
-  - Returns VAST XML directly with HLS media files
-- 📊 Direct tracking and analytics through AdStorm backend
-- ⚠️ Gracefully handles "no ads available" scenarios (logs warnings, not errors)
-
-**API Flow:**
-1. Player calls `/vast/{licenseKey}` endpoint
-2. Backend returns VAST XML with HLS media files
-3. HLS ad player parses VAST XML and extracts MediaFile URLs
-4. Ad segments are loaded and played
-
-**Benefits:**
-- ✅ Zero external ad SDK dependencies
-- ✅ Full control over ad serving
-- ✅ Native HLS playback (same format as content)
-- ✅ Better performance and reliability on Smart TVs
-- ✅ Custom targeting and selection
-- ✅ Proper error handling (distinguishes parsing errors from "no ads available")
-
-#### 2. **Default Mode**
-
-Uses the AdStorm `/ads/web` API (or a custom `vastTagUrl`) to obtain a VAST tag URL, then plays ads through the same HLS ad player:
-
-```javascript
-const player = new StormcloudVideoPlayer({
-  videoElement: video,
-  src: "https://your-stream.com/playlist.m3u8",
-  licenseKey: "your-license-key",
-
-  vastMode: 'default', // or omit this property entirely
   vastTagUrl: 'https://your-vast-server.com/vast.xml', // optional
 
   debugAdTiming: true,
@@ -500,7 +453,7 @@ const player = new StormcloudVideoPlayer({
 **What happens:**
 - 🔗 VAST tag URL resolution:
   1. If `vastTagUrl` is provided, uses that URL directly
-  2. Otherwise, calls `GET https://adstorm.co/api-adstorm-dev/adstorm/ads/web`
+  2. Otherwise, calls `GET https://edge.stormcloudhub.com/api/v1/adstorm/ads/web`
      - Requires `Authorization: Bearer {licenseKey}` header
      - Returns JSON with a VAST tag URL in `response.ima["publisherdesk.ima"].payload`
 - 📊 HLS ad player fetches VAST XML from the resolved tag URL and plays returned media files
@@ -515,7 +468,7 @@ const player = new StormcloudVideoPlayer({
 - ✅ Industry-standard VAST tag URLs (e.g. Google Ad Manager)
 - ✅ Backward compatible with existing AdStorm `/ads/web` integrations
 - ✅ Supports both custom VAST URLs and AdStorm backend configuration
-- ✅ Same HLS ad player stack as AdStorm mode
+- ✅ Native HLS playback (same format as content)
 
 ### Ad Pod Generation (Multiple Consecutive Ads)
 
@@ -577,7 +530,6 @@ const player = new StormcloudVideoPlayer({
   src: "https://your-live-stream.com/playlist.m3u8",
   licenseKey: "your-license-key",
   
-  vastMode: 'default',
   debugAdTiming: true, // Enable to see adaptive calculations
 });
 ```
@@ -649,7 +601,6 @@ const player = new StormcloudVideoPlayer({
   src: "https://your-stream.com/video.m3u8",
   licenseKey: "your-license-key",
 
-  vastMode: 'default',
   isVmap: true,
   vmapUrl: 'https://your-cdn.com/schedule.vmap', // VMAP 1.0 manifest
 
@@ -721,7 +672,7 @@ The VMAP parser recognizes all standard `timeOffset` values:
 
 **Benefits:**
 - ✅ Declarative ad scheduling — no custom code needed per break
-- ✅ Works alongside `vastMode: 'adstorm'` and `vastMode: 'default'`
+- ✅ Works alongside `vastTagUrl` and the `/ads/web` configuration
 - ✅ Supports pre-roll, mid-roll, percentage-based, and post-roll breaks
 - ✅ Gracefully handles malformed XML and fetch failures (logged when `debugAdTiming` is enabled)
 
@@ -730,14 +681,10 @@ The VMAP parser recognizes all standard `timeOffset` values:
 All ads are played through the built-in **HLS ad player** (`createHlsAdPlayer`).
 
 The player:
-1. Resolves a VAST tag URL (`vastMode`, `vastTagUrl`, VMAP, or `/ads/web`)
+1. Resolves a VAST tag URL (`vastTagUrl`, VMAP, or `/ads/web`)
 2. Fetches and parses VAST XML (including wrapper chains)
 3. Plays HLS or progressive `MediaFile` URLs from the VAST response
 
-`vastMode` only changes how the initial VAST tag URL is obtained:
-- `vastMode: 'adstorm'` → `/vast/{licenseKey}` returns VAST XML directly (used as the tag URL for pod generation)
-- `vastMode: 'default'` → `/ads/web` or `vastTagUrl` supplies the tag URL; the HLS ad player fetches VAST from that URL
-
 ### SCTE-35 Support
 
 The HlsPlayer automatically detects and responds to SCTE-35 signals embedded in HLS streams:
@@ -881,7 +828,6 @@ Example with error handling:
 ```javascript
 const player = new StormcloudVideoPlayer({
   // ... config
-  vastMode: 'adstorm',
   debugAdTiming: true, // Enable detailed logging
 });
 
@@ -905,14 +851,11 @@ const player = new StormcloudVideoPlayer({
 
 Authenticated requests are sent to:
 
-- **AdStorm Mode** (`vastMode: 'adstorm'`):
-  - VAST endpoint: `GET https://adstorm.co/api-adstorm-dev/adstorm/vast/{licenseKey}` (license key in URL path)
-  
-- **Default Mode** (`vastMode: 'default'`):
-  - Ad configuration: `GET https://adstorm.co/api-adstorm-dev/adstorm/ads/web` (requires `Authorization: Bearer {licenseKey}` header)
+- **Ad Configuration**:
+  - Ad configuration: `GET https://edge.stormcloudhub.com/api/v1/adstorm/ads/web` (requires `Authorization: Bearer {licenseKey}` header)
   - Returns JSON with a VAST tag URL in `response.ima["publisherdesk.ima"].payload`
 
-- **Player Tracking** (both modes):
+- **Player Tracking**:
   - Metrics / heartbeat: `POST https://player-analytics-ingest-api-760490581852.us-central1.run.app/api/adstorm/player-tracking/metrics/ingest` (requires `Authorization: License-Key {licenseKey}` header)
   - Ad impressions: `POST https://player-analytics-ingest-api-760490581852.us-central1.run.app/api/adstorm/player-tracking/impressions/ingest` (requires `Authorization: License-Key {licenseKey}` header)
   - Ad-detect, ad-loaded, and ad-impression events are automatically emitted during ad breaks.
@@ -1344,15 +1287,12 @@ Built with ❤️ by the Stormcloud team
 ### What's New in v0.3
 
 - 🎬 **Custom HLS Ad Player**: Native HLS ad playback with VAST XML parsing
-- 🎯 **VAST Tag Resolution**: `vastMode` selects AdStorm `/vast/{licenseKey}` vs `/ads/web` or custom `vastTagUrl`
+- 🎯 **VAST Tag Resolution**: `/ads/web` or custom `vastTagUrl`
 - 📊 **Direct Analytics**: Full control over ad tracking and metrics
 - ⚡ **Better Performance**: Native HLS playback for ads (same format as content)
 - 🔧 **Custom VAST URLs**: Point to your own ad serving backend
 - 📦 **Zero external ad SDK dependencies**
 - 🎨 **Seamless Playback**: Same player stack for content and ads
-- 🔀 **VAST Mode System**: `vastMode` configures which endpoint supplies the VAST tag URL
-  - `vastMode: 'adstorm'` → `/vast/{licenseKey}` endpoint
-  - `vastMode: 'default'` → `/ads/web` endpoint or `vastTagUrl` (both resolve to HLS ad player playback)
 - ⚠️ **Improved Error Handling**: Distinguishes between parsing errors and "no ads available" scenarios
   - Logs warnings for "no ads available" (graceful handling)
   - Logs errors for actual parsing/fetch failures