video-dev
diff --git a/‎.gitignore‎
Lines changed: 3 additions & 0 deletions b/‎.gitignore‎
Lines changed: 3 additions & 0 deletions
diff --git a/‎api-extractor/report/hls.js.api.md‎
Lines changed: 16 additions & 1 deletion b/‎api-extractor/report/hls.js.api.md‎
Lines changed: 16 additions & 1 deletion
diff --git a/‎docs/API.md‎
Lines changed: 9 additions & 1 deletion b/‎docs/API.md‎
Lines changed: 9 additions & 1 deletion
diff --git a/‎karma.conf.js‎
Lines changed: 1 addition & 0 deletions b/‎karma.conf.js‎
Lines changed: 1 addition & 0 deletions
@@ -46,3 +46,6 @@ _ReSharper*/
 
 # VSCode custom workspace settings
 .vscode/settings.json
+
+# Claude local settings
+.claude/settings.local.json
@@ -4,6 +4,9 @@
 
 ```ts
 
+import type { CmcdEventReportConfig } from '@svta/cml-cmcd';
+import type { CmcdKey } from '@svta/cml-cmcd';
+import type { CmcdVersion } from '@svta/cml-cmcd';
 import { EventEmitter } from 'eventemitter3';
 
 // Warning: (ae-missing-release-tag) "AbrComponentAPI" is part of the package's API, but it is missing a release tag (@alpha, @beta, @public, or @internal)
@@ -1012,7 +1015,19 @@ export type CMCDControllerConfig = {
     sessionId?: string;
     contentId?: string;
     useHeaders?: boolean;
-    includeKeys?: string[];
+    includeKeys?: CmcdKey[];
+    version?: CmcdVersion;
+    eventTargets?: (Omit<CmcdEventReportConfig, 'enabledKeys'> & {
+        includeKeys?: CmcdKey[];
+    })[];
+    loader?: (request: {
+        url: string;
+        method?: string;
+        headers?: Record<string, string>;
+        body?: BodyInit;
+    }) => Promise<{
+        status: number;
+    }>;
 };
 
 // Warning: (ae-missing-release-tag) "CodecsParsed" is part of the package's API, but it is missing a release tag (@alpha, @beta, @public, or @internal)
 
@@ -1895,7 +1895,15 @@ data will be passed on all media requests (manifests, playlists, a/v segments, t
 - `sessionId`: The CMCD session id. One will be automatically generated if none is provided.
 - `contentId`: The CMCD content id.
 - `useHeaders`: Send CMCD data in request headers instead of as query args. Defaults to `false`.
-- `includeKeys`: An optional array of CMCD keys. When present, only these CMCD fields will be included with each each request.
+- `includeKeys`: An optional array of CMCD keys. When present, only these CMCD fields will be included with each request. Defaults to the full set of keys for the configured `version`.
+- `version`: CMCD version to report. Accepts `1` (CMCD v1) or `2` (CMCD v2). Defaults to `1`. When set to `2`, additional v2 fields (player state `sta`, buffer starvation duration `bs`, etc.) and event-mode reporting become available.
+- `eventTargets`: An optional array of CMCD v2 event report targets. Each target configures an endpoint that receives batched event reports (player state changes, bitrate changes, errors, etc.). Requires `version: 2`. Each target has the following properties:
+  - `url`: The endpoint URL that receives CMCD event reports. Required.
+  - `events`: An optional array of [CMCD event types](https://github.com/streaming-video-technology-alliance/common-media-library/tree/main/libs/cmcd) to report to this target. If omitted, no events are sent. Values are the short codes such as `"ps"` (play state), `"bc"` (bitrate change), `"e"` (error), `"t"` (time interval).
+  - `interval`: For the time-interval event, the reporting cadence in seconds. Defaults to `30`.
+  - `batchSize`: The number of events to batch before sending a report. Defaults to `1` (send each event immediately).
+  - `includeKeys`: An optional array of CMCD keys that overrides the top-level `includeKeys` for this target.
+- `loader`: An optional async function `(request) => Promise<{ status }>` used to deliver CMCD v2 event reports. When omitted, event reports are delivered via `fetch` (honoring the Hls `xhrSetup`/`fetchSetup` hooks). Only used when `eventTargets` is configured.
 
 ### `enableInterstitialPlayback`
 
 
@@ -3,6 +3,7 @@ const { buildRollupConfig, BUILD_TYPE, FORMAT } = require('./build-config');
 // Do not add coverage for JavaScript debugging when running `test:unit:debug`
 // eslint-disable-next-line no-undef
 const includeCoverage = !process.env.DEBUG_UNIT_TESTS && !process.env.CI;
+// eslint-disable-next-line no-undef
 const isDevContainer = process.env.IN_DEV_CONTAINER === 'true';
 
 const rollupPreprocessor = buildRollupConfig({