rx-player 4.5.0-dev.2026012302 → 4.5.0-dev.2026031700

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (180) hide show
  1. package/CHANGELOG.md +21 -3
  2. package/VERSION +1 -1
  3. package/dist/commonjs/__GENERATED_CODE/embedded_dash_wasm.d.ts.map +1 -1
  4. package/dist/commonjs/__GENERATED_CODE/embedded_dash_wasm.js +1 -1
  5. package/dist/commonjs/__GENERATED_CODE/embedded_worker.d.ts.map +1 -1
  6. package/dist/commonjs/__GENERATED_CODE/embedded_worker.js +1 -1
  7. package/dist/commonjs/compat/should_seek_at_zero.d.ts +12 -0
  8. package/dist/commonjs/compat/should_seek_at_zero.d.ts.map +1 -0
  9. package/dist/commonjs/compat/should_seek_at_zero.js +23 -0
  10. package/dist/commonjs/core/cmcd/cmcd_data_builder.js +2 -2
  11. package/dist/commonjs/core/entry/FreezeResolver.js +2 -2
  12. package/dist/commonjs/core/entry/content_preparer.d.ts +1 -6
  13. package/dist/commonjs/core/entry/content_preparer.d.ts.map +1 -1
  14. package/dist/commonjs/core/entry/content_preparer.js +2 -125
  15. package/dist/commonjs/core/entry/content_time_boundaries_observer.d.ts.map +1 -1
  16. package/dist/commonjs/core/entry/content_time_boundaries_observer.js +8 -0
  17. package/dist/commonjs/core/entry/core_entry.d.ts +1 -1
  18. package/dist/commonjs/core/entry/core_entry.d.ts.map +1 -1
  19. package/dist/commonjs/core/entry/core_entry.js +2 -7
  20. package/dist/commonjs/core/entry/core_text_displayer_interface.d.ts.map +1 -1
  21. package/dist/commonjs/core/entry/core_text_displayer_interface.js +3 -1
  22. package/dist/commonjs/core/entry/index.d.ts +1 -1
  23. package/dist/commonjs/core/entry/index.d.ts.map +1 -1
  24. package/dist/commonjs/core/entry/utils.d.ts +64 -0
  25. package/dist/commonjs/core/entry/utils.d.ts.map +1 -1
  26. package/dist/commonjs/core/entry/utils.js +165 -0
  27. package/dist/commonjs/core/fetchers/segment/segment_queue.d.ts +5 -6
  28. package/dist/commonjs/core/fetchers/segment/segment_queue.d.ts.map +1 -1
  29. package/dist/commonjs/core/fetchers/thumbnails/thumbnail_fetcher.d.ts.map +1 -1
  30. package/dist/commonjs/core/fetchers/thumbnails/thumbnail_fetcher.js +34 -30
  31. package/dist/commonjs/core/stream/representation/encryption_data_notifier.d.ts +70 -0
  32. package/dist/commonjs/core/stream/representation/encryption_data_notifier.d.ts.map +1 -0
  33. package/dist/commonjs/core/stream/representation/encryption_data_notifier.js +107 -0
  34. package/dist/commonjs/core/stream/representation/representation_stream.d.ts.map +1 -1
  35. package/dist/commonjs/core/stream/representation/representation_stream.js +12 -60
  36. package/dist/commonjs/core/stream/representation/utils/get_needed_segments.js +1 -1
  37. package/dist/commonjs/default_config.d.ts +5 -0
  38. package/dist/commonjs/default_config.d.ts.map +1 -1
  39. package/dist/commonjs/default_config.js +5 -0
  40. package/dist/commonjs/experimental/features/worker/index.d.ts +2 -1
  41. package/dist/commonjs/experimental/features/worker/index.d.ts.map +1 -1
  42. package/dist/commonjs/experimental/features/worker/index.js +4 -3
  43. package/dist/commonjs/main_thread/api/public_api.d.ts.map +1 -1
  44. package/dist/commonjs/main_thread/api/public_api.js +28 -4
  45. package/dist/commonjs/main_thread/init/directfile_content_initializer.d.ts.map +1 -1
  46. package/dist/commonjs/main_thread/init/directfile_content_initializer.js +23 -1
  47. package/dist/commonjs/main_thread/init/utils/initial_seek_and_play.d.ts.map +1 -1
  48. package/dist/commonjs/main_thread/init/utils/initial_seek_and_play.js +3 -1
  49. package/dist/commonjs/manifest/classes/index.d.ts +2 -1
  50. package/dist/commonjs/manifest/classes/index.d.ts.map +1 -1
  51. package/dist/commonjs/manifest/classes/representation.d.ts +1 -1
  52. package/dist/commonjs/manifest/classes/representation.d.ts.map +1 -1
  53. package/dist/commonjs/manifest/classes/representation.js +2 -2
  54. package/dist/commonjs/manifest/classes/representation_index/types.d.ts +2 -2
  55. package/dist/commonjs/parsers/texttracks/ttml/html/apply_line_height.d.ts.map +1 -1
  56. package/dist/commonjs/parsers/texttracks/ttml/html/apply_line_height.js +16 -1
  57. package/dist/commonjs/utils/base64.d.ts +15 -1
  58. package/dist/commonjs/utils/base64.d.ts.map +1 -1
  59. package/dist/commonjs/utils/base64.js +6 -0
  60. package/dist/commonjs/utils/ranges.d.ts +1 -1
  61. package/dist/commonjs/utils/ranges.js +1 -1
  62. package/dist/es2017/__GENERATED_CODE/embedded_dash_wasm.d.ts.map +1 -1
  63. package/dist/es2017/__GENERATED_CODE/embedded_dash_wasm.js +1 -1
  64. package/dist/es2017/__GENERATED_CODE/embedded_worker.d.ts.map +1 -1
  65. package/dist/es2017/__GENERATED_CODE/embedded_worker.js +1 -1
  66. package/dist/es2017/compat/should_seek_at_zero.d.ts +12 -0
  67. package/dist/es2017/compat/should_seek_at_zero.d.ts.map +1 -0
  68. package/dist/es2017/compat/should_seek_at_zero.js +20 -0
  69. package/dist/es2017/core/cmcd/cmcd_data_builder.js +2 -2
  70. package/dist/es2017/core/entry/FreezeResolver.js +1 -1
  71. package/dist/es2017/core/entry/content_preparer.d.ts +1 -6
  72. package/dist/es2017/core/entry/content_preparer.d.ts.map +1 -1
  73. package/dist/es2017/core/entry/content_preparer.js +1 -76
  74. package/dist/es2017/core/entry/content_time_boundaries_observer.d.ts.map +1 -1
  75. package/dist/es2017/core/entry/content_time_boundaries_observer.js +8 -0
  76. package/dist/es2017/core/entry/core_entry.d.ts +1 -1
  77. package/dist/es2017/core/entry/core_entry.d.ts.map +1 -1
  78. package/dist/es2017/core/entry/core_entry.js +2 -7
  79. package/dist/es2017/core/entry/core_text_displayer_interface.d.ts.map +1 -1
  80. package/dist/es2017/core/entry/core_text_displayer_interface.js +3 -1
  81. package/dist/es2017/core/entry/index.d.ts +1 -1
  82. package/dist/es2017/core/entry/index.d.ts.map +1 -1
  83. package/dist/es2017/core/entry/utils.d.ts +64 -0
  84. package/dist/es2017/core/entry/utils.d.ts.map +1 -1
  85. package/dist/es2017/core/entry/utils.js +98 -0
  86. package/dist/es2017/core/fetchers/segment/segment_queue.d.ts +5 -6
  87. package/dist/es2017/core/fetchers/segment/segment_queue.d.ts.map +1 -1
  88. package/dist/es2017/core/fetchers/thumbnails/thumbnail_fetcher.d.ts.map +1 -1
  89. package/dist/es2017/core/fetchers/thumbnails/thumbnail_fetcher.js +21 -16
  90. package/dist/es2017/core/stream/representation/encryption_data_notifier.d.ts +70 -0
  91. package/dist/es2017/core/stream/representation/encryption_data_notifier.d.ts.map +1 -0
  92. package/dist/es2017/core/stream/representation/encryption_data_notifier.js +80 -0
  93. package/dist/es2017/core/stream/representation/representation_stream.d.ts.map +1 -1
  94. package/dist/es2017/core/stream/representation/representation_stream.js +10 -38
  95. package/dist/es2017/core/stream/representation/utils/get_needed_segments.js +1 -1
  96. package/dist/es2017/default_config.d.ts +5 -0
  97. package/dist/es2017/default_config.d.ts.map +1 -1
  98. package/dist/es2017/default_config.js +5 -0
  99. package/dist/es2017/experimental/features/worker/index.d.ts +2 -1
  100. package/dist/es2017/experimental/features/worker/index.d.ts.map +1 -1
  101. package/dist/es2017/experimental/features/worker/index.js +2 -3
  102. package/dist/es2017/main_thread/api/public_api.d.ts.map +1 -1
  103. package/dist/es2017/main_thread/api/public_api.js +28 -4
  104. package/dist/es2017/main_thread/init/directfile_content_initializer.d.ts.map +1 -1
  105. package/dist/es2017/main_thread/init/directfile_content_initializer.js +23 -1
  106. package/dist/es2017/main_thread/init/utils/initial_seek_and_play.d.ts.map +1 -1
  107. package/dist/es2017/main_thread/init/utils/initial_seek_and_play.js +3 -1
  108. package/dist/es2017/manifest/classes/index.d.ts +2 -1
  109. package/dist/es2017/manifest/classes/index.d.ts.map +1 -1
  110. package/dist/es2017/manifest/classes/representation.d.ts +1 -1
  111. package/dist/es2017/manifest/classes/representation.d.ts.map +1 -1
  112. package/dist/es2017/manifest/classes/representation.js +1 -1
  113. package/dist/es2017/manifest/classes/representation_index/types.d.ts +2 -2
  114. package/dist/es2017/parsers/texttracks/ttml/html/apply_line_height.d.ts.map +1 -1
  115. package/dist/es2017/parsers/texttracks/ttml/html/apply_line_height.js +16 -1
  116. package/dist/es2017/utils/base64.d.ts +15 -1
  117. package/dist/es2017/utils/base64.d.ts.map +1 -1
  118. package/dist/es2017/utils/base64.js +6 -0
  119. package/dist/es2017/utils/ranges.d.ts +1 -1
  120. package/dist/es2017/utils/ranges.js +1 -1
  121. package/dist/mpd-parser.wasm +0 -0
  122. package/dist/worker.js +8 -8
  123. package/package.json +26 -23
  124. package/src/__GENERATED_CODE/embedded_dash_wasm.ts +1 -1
  125. package/src/__GENERATED_CODE/embedded_worker.ts +1 -1
  126. package/src/compat/should_seek_at_zero.ts +23 -0
  127. package/src/core/adaptive/__tests__/adaptive_representation_selector.test.ts +734 -0
  128. package/src/core/adaptive/__tests__/guess_based_chooser.test.ts +793 -0
  129. package/src/core/adaptive/__tests__/network_analyzer.test.ts +514 -0
  130. package/src/core/adaptive/utils/__tests__/bandwidth_estimator.test.ts +117 -0
  131. package/src/core/adaptive/utils/__tests__/last_estimate_storage.test.ts +76 -0
  132. package/src/core/adaptive/utils/__tests__/pending_requests_store.test.ts +288 -0
  133. package/src/core/adaptive/utils/__tests__/representation_score_calculator.test.ts +249 -0
  134. package/src/core/cmcd/__tests__/cmcd_data_builder.test.ts +464 -0
  135. package/src/core/cmcd/cmcd_data_builder.ts +2 -2
  136. package/src/core/entry/FreezeResolver.ts +1 -1
  137. package/src/core/entry/__tests__/FreezeResolver.test.ts +542 -0
  138. package/src/core/entry/__tests__/content_time_boundaries_observer.test.ts +867 -0
  139. package/src/core/entry/__tests__/core_text_displayer_interface.test.ts +205 -0
  140. package/src/core/entry/__tests__/get_buffered_data_per_media_buffer.test.ts +95 -0
  141. package/src/core/entry/__tests__/track_choice_setter.test.ts +288 -0
  142. package/src/core/entry/__tests__/utils.test.ts +309 -0
  143. package/src/core/entry/content_preparer.ts +7 -118
  144. package/src/core/entry/content_time_boundaries_observer.ts +10 -0
  145. package/src/core/entry/core_entry.ts +7 -14
  146. package/src/core/entry/core_text_displayer_interface.ts +3 -1
  147. package/src/core/entry/index.ts +1 -1
  148. package/src/core/entry/utils.ts +151 -0
  149. package/src/core/fetchers/__tests__/cdn_prioritizer.test.ts +166 -0
  150. package/src/core/fetchers/manifest/__tests__/manifest_fetcher.test.ts +803 -0
  151. package/src/core/fetchers/segment/__tests__/segment_fetcher.test.ts +872 -0
  152. package/src/core/fetchers/segment/__tests__/segment_queue.test.ts +557 -0
  153. package/src/core/fetchers/segment/segment_queue.ts +5 -6
  154. package/src/core/fetchers/thumbnails/__tests__/thumbnail_fetcher.test.ts +435 -0
  155. package/src/core/fetchers/thumbnails/thumbnail_fetcher.ts +28 -20
  156. package/src/core/fetchers/utils/__tests__/schedule_request.test.ts +331 -0
  157. package/src/core/stream/adaptation/__tests__/get_representations_switch_strategy.test.ts +593 -0
  158. package/src/core/stream/period/utils/__tests__/get_adaptation_switch_strategy.test.ts +646 -0
  159. package/src/core/stream/representation/__tests__/encryption_data_notifier.test.ts +531 -0
  160. package/src/core/stream/representation/encryption_data_notifier.ts +122 -0
  161. package/src/core/stream/representation/representation_stream.ts +11 -49
  162. package/src/core/stream/representation/utils/__tests__/append_segment_to_buffer.test.ts +321 -0
  163. package/src/core/stream/representation/utils/__tests__/check_for_discontinuity.test.ts +513 -0
  164. package/src/core/stream/representation/utils/__tests__/get_segment_priority.test.ts +132 -0
  165. package/src/core/stream/representation/utils/__tests__/push_init_segment.test.ts +209 -0
  166. package/src/core/stream/representation/utils/__tests__/push_media_segment.test.ts +343 -0
  167. package/src/core/stream/representation/utils/get_needed_segments.ts +1 -1
  168. package/src/default_config.ts +6 -0
  169. package/src/experimental/features/worker/index.ts +2 -4
  170. package/src/main_thread/api/public_api.ts +33 -4
  171. package/src/main_thread/init/directfile_content_initializer.ts +26 -1
  172. package/src/main_thread/init/utils/initial_seek_and_play.ts +5 -1
  173. package/src/manifest/classes/index.ts +2 -0
  174. package/src/manifest/classes/representation.ts +2 -1
  175. package/src/manifest/classes/representation_index/types.ts +2 -2
  176. package/src/mse/__tests__/main_media_source_interface.test.ts +846 -0
  177. package/src/parsers/texttracks/ttml/html/apply_line_height.ts +16 -1
  178. package/src/utils/__tests__/base64.test.ts +159 -191
  179. package/src/utils/base64.ts +30 -1
  180. package/src/utils/ranges.ts +1 -1
@@ -0,0 +1,464 @@
1
+ import { describe, it, expect, beforeEach, vi } from "vitest";
2
+ import CmcdDataBuilder from "../cmcd_data_builder";
3
+
4
+ /* eslint-disable @typescript-eslint/no-explicit-any */
5
+ /* eslint-disable @typescript-eslint/no-unsafe-member-access */
6
+ /* eslint-disable @typescript-eslint/no-unsafe-argument */
7
+ /* eslint-disable @typescript-eslint/no-unsafe-assignment */
8
+
9
+ const { mockLogDebug, mockCreateUuid, mockGetRelativeUrl } = vi.hoisted(() => {
10
+ return {
11
+ mockLogDebug: vi.fn(),
12
+ mockCreateUuid: vi.fn(() => "test-uuid"),
13
+ mockGetRelativeUrl: vi.fn(),
14
+ };
15
+ });
16
+
17
+ vi.mock("../../../log", () => ({
18
+ default: {
19
+ debug: mockLogDebug,
20
+ },
21
+ }));
22
+
23
+ vi.mock("../../../utils/create_uuid", () => ({
24
+ default: mockCreateUuid,
25
+ }));
26
+
27
+ vi.mock("../../../utils/url-utils", () => ({
28
+ getRelativeUrl: mockGetRelativeUrl,
29
+ }));
30
+
31
+ /** Helpers */
32
+ function makePlaybackObserver(
33
+ overrides: Partial<{
34
+ rebuffering: object | null;
35
+ speed: number;
36
+ buffered: Record<string, Array<{ start: number; end: number }> | null>;
37
+ position: { getWanted: () => number | undefined; getPolled: () => number };
38
+ }> = {},
39
+ ): any {
40
+ const obs = {
41
+ rebuffering: null,
42
+ speed: 1,
43
+ buffered: { video: null, audio: null, text: null },
44
+ position: {
45
+ getWanted: () => 10,
46
+ getPolled: () => 10,
47
+ },
48
+ ...overrides,
49
+ };
50
+
51
+ const getReference = vi.fn(() => ({ getValue: () => obs }));
52
+ const getCurrentTime = vi.fn(() => 10);
53
+ const listen = vi.fn((cb: (o: typeof obs) => void, _opts: unknown) => {
54
+ cb(obs);
55
+ });
56
+
57
+ return { getReference, getCurrentTime, listen, obs };
58
+ }
59
+
60
+ function makeRepresentation(bitrate: number, playable = true) {
61
+ return {
62
+ bitrate,
63
+ isPlayable: vi.fn(() => (playable ? true : false)),
64
+ };
65
+ }
66
+
67
+ function makeSegmentInfo(
68
+ overrides: Partial<{
69
+ nextSegment: object | null | undefined;
70
+ isInit: boolean;
71
+ segmentUrl: string | null;
72
+ nextSegmentUrl: string | null;
73
+ }> = {},
74
+ ): any {
75
+ const {
76
+ nextSegment,
77
+ isInit = false,
78
+ segmentUrl = "https://cdn.example.com/video/seg1.m4s",
79
+ nextSegmentUrl = "https://cdn.example.com/video/seg2.m4s",
80
+ } = overrides;
81
+
82
+ const representations = [makeRepresentation(2_000_000), makeRepresentation(4_000_000)];
83
+
84
+ return {
85
+ manifest: { transport: "dash", isDynamic: false },
86
+ period: {},
87
+ adaptation: {
88
+ type: "video",
89
+ representations,
90
+ },
91
+ representation: { bitrate: 2_000_000 },
92
+ segment: {
93
+ duration: 4,
94
+ url: segmentUrl,
95
+ isInit,
96
+ range: undefined,
97
+ indexRange: undefined,
98
+ },
99
+ nextSegment:
100
+ nextSegment !== undefined
101
+ ? nextSegment
102
+ : {
103
+ url: nextSegmentUrl,
104
+ isInit: false,
105
+ range: undefined,
106
+ indexRange: undefined,
107
+ },
108
+ };
109
+ }
110
+
111
+ describe("CmcdDataBuilder", () => {
112
+ beforeEach(() => {
113
+ mockCreateUuid.mockReturnValue("test-uuid");
114
+ mockGetRelativeUrl.mockReturnValue(null);
115
+ });
116
+
117
+ describe("constructor", () => {
118
+ it("uses provided sessionId and contentId", () => {
119
+ const builder = new CmcdDataBuilder({
120
+ sessionId: "my-session",
121
+ contentId: "my-content",
122
+ communicationType: "query",
123
+ });
124
+ const payload: any = builder.getCmcdDataForManifest("dash");
125
+ expect(payload.type).toBe("query");
126
+ const qs = decodeURIComponent(payload.value[0][1]);
127
+ expect(qs).toContain("my-session");
128
+ expect(qs).toContain("my-content");
129
+ });
130
+
131
+ it("generates UUIDs when sessionId/contentId not provided", () => {
132
+ mockCreateUuid
133
+ .mockReturnValueOnce("uuid-session")
134
+ .mockReturnValueOnce("uuid-content");
135
+ const builder = new CmcdDataBuilder({ communicationType: "query" });
136
+ const payload: any = builder.getCmcdDataForManifest("dash");
137
+ const qs = decodeURIComponent(payload.value[0][1]);
138
+ expect(qs).toContain("uuid-session");
139
+ expect(qs).toContain("uuid-content");
140
+ });
141
+ });
142
+
143
+ describe("getCmcdDataForManifest", () => {
144
+ it("returns headers payload when communicationType is headers", () => {
145
+ const builder = new CmcdDataBuilder({
146
+ sessionId: "s1",
147
+ contentId: "c1",
148
+ communicationType: "headers",
149
+ });
150
+ const payload: any = builder.getCmcdDataForManifest("dash");
151
+ expect(payload.type).toBe("headers");
152
+ expect(payload.value).toHaveProperty("CMCD-Object");
153
+ expect(payload.value).toHaveProperty("CMCD-Session");
154
+ });
155
+
156
+ it("returns query payload when communicationType is query", () => {
157
+ const builder = new CmcdDataBuilder({
158
+ sessionId: "s1",
159
+ contentId: "c1",
160
+ communicationType: "query",
161
+ });
162
+ const payload: any = builder.getCmcdDataForManifest("dash");
163
+ expect(payload.type).toBe("query");
164
+ });
165
+
166
+ it("sets ot=m for manifest", () => {
167
+ const builder = new CmcdDataBuilder({ communicationType: "headers" });
168
+ const payload: any = builder.getCmcdDataForManifest("dash");
169
+ const objectHeader = payload.value["CMCD-Object"];
170
+ expect(objectHeader).toContain("ot=m");
171
+ });
172
+
173
+ it("sets sf=d for dash transport", () => {
174
+ const builder = new CmcdDataBuilder({ communicationType: "headers" });
175
+ const payload: any = builder.getCmcdDataForManifest("dash");
176
+ const sessionHeader = payload.value["CMCD-Session"];
177
+ expect(sessionHeader).toContain("sf=d");
178
+ });
179
+
180
+ it("sets sf=s for smooth transport", () => {
181
+ const builder = new CmcdDataBuilder({ communicationType: "headers" });
182
+ const payload: any = builder.getCmcdDataForManifest("smooth");
183
+ const sessionHeader = payload.value["CMCD-Session"];
184
+ expect(sessionHeader).toContain("sf=s");
185
+ });
186
+
187
+ it("sets sf=o for unknown transport", () => {
188
+ const builder = new CmcdDataBuilder({ communicationType: "headers" });
189
+ const payload: any = builder.getCmcdDataForManifest("hls");
190
+ const sessionHeader = payload.value["CMCD-Session"];
191
+ expect(sessionHeader).toContain("sf=o");
192
+ });
193
+ });
194
+
195
+ describe("getCmcdDataForSegmentRequest", () => {
196
+ it("sets br from representation bitrate (in kbps)", () => {
197
+ const builder = new CmcdDataBuilder({ communicationType: "headers" });
198
+ const payload: any = builder.getCmcdDataForSegmentRequest(makeSegmentInfo());
199
+ const objectHeader = payload.value["CMCD-Object"];
200
+ expect(objectHeader).toContain("br=2000");
201
+ });
202
+
203
+ it("sets d from segment duration (in ms)", () => {
204
+ const builder = new CmcdDataBuilder({ communicationType: "headers" });
205
+ const payload: any = builder.getCmcdDataForSegmentRequest(makeSegmentInfo());
206
+ const objectHeader = payload.value["CMCD-Object"];
207
+ expect(objectHeader).toContain("d=4000");
208
+ });
209
+
210
+ it("sets ot=v for video segments", () => {
211
+ const builder = new CmcdDataBuilder({ communicationType: "headers" });
212
+ const payload: any = builder.getCmcdDataForSegmentRequest(makeSegmentInfo());
213
+ const objectHeader = payload.value["CMCD-Object"];
214
+ expect(objectHeader).toContain("ot=v");
215
+ });
216
+
217
+ it("sets ot=a for audio segments", () => {
218
+ const builder = new CmcdDataBuilder({ communicationType: "headers" });
219
+ const info = makeSegmentInfo();
220
+ info.adaptation.type = "audio";
221
+ const payload: any = builder.getCmcdDataForSegmentRequest(info);
222
+ const objectHeader = payload.value["CMCD-Object"];
223
+ expect(objectHeader).toContain("ot=a");
224
+ });
225
+
226
+ it("sets ot=c for text segments", () => {
227
+ const builder = new CmcdDataBuilder({ communicationType: "headers" });
228
+ const info = makeSegmentInfo();
229
+ info.adaptation.type = "text";
230
+ const payload: any = builder.getCmcdDataForSegmentRequest(info);
231
+ const objectHeader = payload.value["CMCD-Object"];
232
+ expect(objectHeader).toContain("ot=c");
233
+ });
234
+
235
+ it("overrides ot to i for init segments", () => {
236
+ const builder = new CmcdDataBuilder({ communicationType: "headers" });
237
+ const info = makeSegmentInfo({ isInit: true });
238
+ const payload: any = builder.getCmcdDataForSegmentRequest(info);
239
+ const objectHeader = payload.value["CMCD-Object"];
240
+ expect(objectHeader).toContain("ot=i");
241
+ });
242
+
243
+ it("sets st=v for VOD", () => {
244
+ const builder = new CmcdDataBuilder({ communicationType: "headers" });
245
+ const payload: any = builder.getCmcdDataForSegmentRequest(makeSegmentInfo());
246
+ const sessionHeader = payload.value["CMCD-Session"];
247
+ expect(sessionHeader).toContain("st=v");
248
+ });
249
+
250
+ it("sets st=l for live", () => {
251
+ const builder = new CmcdDataBuilder({ communicationType: "headers" });
252
+ const info = makeSegmentInfo();
253
+ info.manifest.isDynamic = true;
254
+ const payload: any = builder.getCmcdDataForSegmentRequest(info);
255
+ const sessionHeader = payload.value["CMCD-Session"];
256
+ expect(sessionHeader).toContain("st=l");
257
+ });
258
+
259
+ it("sets tb to the highest playable bitrate in kbps", () => {
260
+ const builder = new CmcdDataBuilder({ communicationType: "headers" });
261
+ const payload: any = builder.getCmcdDataForSegmentRequest(makeSegmentInfo());
262
+ const objectHeader = payload.value["CMCD-Object"];
263
+ expect(objectHeader).toContain("tb=4000");
264
+ });
265
+
266
+ it("ignores non-playable representations when computing tb", () => {
267
+ const builder = new CmcdDataBuilder({ communicationType: "headers" });
268
+ const info = makeSegmentInfo();
269
+ info.adaptation.representations = [
270
+ makeRepresentation(6_000_000, false),
271
+ makeRepresentation(2_000_000, true),
272
+ ];
273
+ const payload: any = builder.getCmcdDataForSegmentRequest(info);
274
+ const objectHeader = payload.value["CMCD-Object"];
275
+ expect(objectHeader).toContain("tb=2000");
276
+ });
277
+
278
+ it("sets nor when nextSegment has a relative url", () => {
279
+ mockGetRelativeUrl.mockReturnValue("seg2.m4s");
280
+ const builder = new CmcdDataBuilder({ communicationType: "headers" });
281
+ const payload: any = builder.getCmcdDataForSegmentRequest(makeSegmentInfo());
282
+ const requestHeader = payload.value["CMCD-Request"];
283
+ expect(requestHeader).toContain("nor=");
284
+ });
285
+
286
+ it("does not set nor when relative url is '.' (same file)", () => {
287
+ mockGetRelativeUrl.mockReturnValue(".");
288
+ const builder = new CmcdDataBuilder({ communicationType: "headers" });
289
+ const payload: any = builder.getCmcdDataForSegmentRequest(makeSegmentInfo());
290
+ const requestHeader = payload.value["CMCD-Request"];
291
+ expect(requestHeader).not.toContain("nor=");
292
+ });
293
+
294
+ it("does not set nor when nextSegment is null", () => {
295
+ mockGetRelativeUrl.mockReturnValue("seg2.m4s");
296
+ const builder = new CmcdDataBuilder({ communicationType: "headers" });
297
+ const payload: any = builder.getCmcdDataForSegmentRequest(
298
+ makeSegmentInfo({ nextSegment: null }),
299
+ );
300
+ const requestHeader = payload.value["CMCD-Request"];
301
+ expect(requestHeader).not.toContain("nor=");
302
+ });
303
+
304
+ it("sets nrr when next segment has a range", () => {
305
+ mockGetRelativeUrl.mockReturnValue("seg2.m4s");
306
+ const builder = new CmcdDataBuilder({ communicationType: "headers" });
307
+ const info = makeSegmentInfo();
308
+ (info.nextSegment as { range: [number, number] }).range = [0, 999];
309
+ const payload: any = builder.getCmcdDataForSegmentRequest(info);
310
+ const requestHeader = payload.value["CMCD-Request"];
311
+ expect(requestHeader).toContain("nrr=");
312
+ expect(requestHeader).toContain("0-999");
313
+ });
314
+ });
315
+
316
+ describe("updateThroughput + mtp", () => {
317
+ it("includes mtp rounded to nearest 100kbps when throughput is set", () => {
318
+ const builder = new CmcdDataBuilder({ communicationType: "headers" });
319
+ builder.updateThroughput("video", 3_450_000); // 3450 kbps → round to 3500
320
+ const payload: any = builder.getCmcdDataForSegmentRequest(makeSegmentInfo());
321
+ const requestHeader = payload.value["CMCD-Request"];
322
+ expect(requestHeader).toContain("mtp=3500");
323
+ });
324
+
325
+ it("does not include mtp when throughput is undefined", () => {
326
+ const builder = new CmcdDataBuilder({ communicationType: "headers" });
327
+ const payload: any = builder.getCmcdDataForSegmentRequest(makeSegmentInfo());
328
+ const requestHeader = payload.value["CMCD-Request"];
329
+ expect(requestHeader).not.toContain("mtp=");
330
+ });
331
+ });
332
+
333
+ describe("startMonitoringPlayback / buffer starvation", () => {
334
+ it("sets bs=true when rebuffering was observed, then clears it on next request", () => {
335
+ const builder = new CmcdDataBuilder({ communicationType: "headers" });
336
+ const observer = makePlaybackObserver({ rebuffering: { timestamp: 0 } });
337
+ builder.startMonitoringPlayback(observer);
338
+
339
+ const payload1: any = builder.getCmcdDataForManifest("dash");
340
+ const status1 = payload1.value["CMCD-Status"];
341
+ // bs is a boolean flag - present means true
342
+ expect(status1).toContain("bs");
343
+
344
+ // second request - bs should have been reset
345
+ const payload2: any = builder.getCmcdDataForManifest("dash");
346
+ const status2 = payload2.value["CMCD-Status"];
347
+ expect(status2).not.toContain("bs");
348
+ });
349
+
350
+ it("includes bl (buffer length) for video when playback observer is set", () => {
351
+ const builder = new CmcdDataBuilder({ communicationType: "headers" });
352
+ const observer = makePlaybackObserver({
353
+ buffered: {
354
+ video: [{ start: 5, end: 20 }],
355
+ audio: null,
356
+ text: null,
357
+ },
358
+ speed: 1,
359
+ rebuffering: null,
360
+ });
361
+ builder.startMonitoringPlayback(
362
+ observer as Parameters<typeof builder.startMonitoringPlayback>[0],
363
+ );
364
+
365
+ const payload: any = builder.getCmcdDataForSegmentRequest(makeSegmentInfo());
366
+ const requestHeader = payload.value["CMCD-Request"];
367
+ // position = 10, range.end = 20 → bufferLength = 10000ms → rounded to 10000
368
+ expect(requestHeader).toContain("bl=10000");
369
+ });
370
+
371
+ it("includes pr when playback speed is not 1", () => {
372
+ const builder = new CmcdDataBuilder({ communicationType: "headers" });
373
+ const observer = makePlaybackObserver({ speed: 2, rebuffering: null });
374
+ builder.startMonitoringPlayback(
375
+ observer as Parameters<typeof builder.startMonitoringPlayback>[0],
376
+ );
377
+
378
+ const payload: any = builder.getCmcdDataForManifest("dash");
379
+ const sessionHeader = payload.value["CMCD-Session"];
380
+ expect(sessionHeader).toContain("pr=2");
381
+ });
382
+
383
+ it("does not include pr when speed is 1", () => {
384
+ const builder = new CmcdDataBuilder({ communicationType: "headers" });
385
+ const observer = makePlaybackObserver({ speed: 1, rebuffering: null });
386
+ builder.startMonitoringPlayback(
387
+ observer as Parameters<typeof builder.startMonitoringPlayback>[0],
388
+ );
389
+
390
+ const payload: any = builder.getCmcdDataForManifest("dash");
391
+ const sessionHeader = payload.value["CMCD-Session"];
392
+ expect(sessionHeader).not.toContain("pr=");
393
+ });
394
+
395
+ it("includes su when rebuffering is active", () => {
396
+ const builder = new CmcdDataBuilder({ communicationType: "headers" });
397
+ const observer = makePlaybackObserver({ rebuffering: { timestamp: 0 }, speed: 1 });
398
+ builder.startMonitoringPlayback(
399
+ observer as Parameters<typeof builder.startMonitoringPlayback>[0],
400
+ );
401
+
402
+ const payload: any = builder.getCmcdDataForManifest("dash");
403
+ const requestHeader = payload.value["CMCD-Request"];
404
+ expect(requestHeader).toContain("su");
405
+ });
406
+ });
407
+
408
+ describe("stopMonitoringPlayback", () => {
409
+ it("clears the playback observer so subsequent calls work without observation data", () => {
410
+ const builder = new CmcdDataBuilder({ communicationType: "headers" });
411
+ const observer = makePlaybackObserver({ speed: 2, rebuffering: null });
412
+ builder.startMonitoringPlayback(
413
+ observer as Parameters<typeof builder.startMonitoringPlayback>[0],
414
+ );
415
+ builder.stopMonitoringPlayback();
416
+
417
+ const payload: any = builder.getCmcdDataForManifest("dash");
418
+ const sessionHeader = payload.value["CMCD-Session"];
419
+ // no pr since observer is gone
420
+ expect(sessionHeader).not.toContain("pr=");
421
+ });
422
+ });
423
+
424
+ describe("query string output format", () => {
425
+ it("encodes the query string and wraps it as CMCD param", () => {
426
+ const builder = new CmcdDataBuilder({
427
+ sessionId: "s",
428
+ contentId: "c",
429
+ communicationType: "query",
430
+ });
431
+ const payload: any = builder.getCmcdDataForManifest("dash");
432
+ expect(payload.type).toBe("query");
433
+ const value = payload.value;
434
+ expect(value[0][0]).toBe("CMCD");
435
+ });
436
+
437
+ it("does not have trailing comma in query string", () => {
438
+ const builder = new CmcdDataBuilder({
439
+ sessionId: "s",
440
+ contentId: "c",
441
+ communicationType: "query",
442
+ });
443
+ const payload: any = builder.getCmcdDataForManifest("dash");
444
+ const qs = decodeURIComponent(payload.value[0][1]);
445
+ expect(qs[qs.length - 1]).not.toBe(",");
446
+ });
447
+
448
+ it("does not have trailing comma in headers", () => {
449
+ const builder = new CmcdDataBuilder({
450
+ sessionId: "s",
451
+ contentId: "c",
452
+ communicationType: "headers",
453
+ });
454
+ const payload = builder.getCmcdDataForManifest("dash");
455
+ const headers = payload.value;
456
+ // eslint-disable-next-line no-restricted-properties
457
+ for (const val of Object.values(headers)) {
458
+ if (val.length > 0) {
459
+ expect(val[val.length - 1]).not.toBe(",");
460
+ }
461
+ }
462
+ });
463
+ });
464
+ });
@@ -397,7 +397,7 @@ export default class CmcdDataBuilder {
397
397
  const val = props[prop];
398
398
  if (val !== undefined) {
399
399
  const formatted = `"${val.replace("\\", "\\\\").replace('"', '\\"')}"`;
400
- const toAdd = `prop=${formatted},`;
400
+ const toAdd = `${prop}=${formatted},`;
401
401
  addPayload(toAdd, headerName);
402
402
  }
403
403
  };
@@ -408,7 +408,7 @@ export default class CmcdDataBuilder {
408
408
  ): void => {
409
409
  const val = props[prop];
410
410
  if (val !== undefined) {
411
- const toAdd = `prop=${val},`;
411
+ const toAdd = `${prop}=${val},`;
412
412
  addPayload(toAdd, headerName);
413
413
  }
414
414
  };
@@ -1,4 +1,4 @@
1
- import { config } from "../../experimental";
1
+ import config from "../../config";
2
2
  import log from "../../log";
3
3
  import type { IAdaptation, IPeriod, IRepresentation } from "../../manifest";
4
4
  import type {