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,557 @@
1
+ import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
2
+ import noop from "../../../../utils/noop";
3
+ import SharedReference from "../../../../utils/reference";
4
+ import SegmentQueue from "../segment_queue";
5
+ import type { ISegmentQueueContext } from "../segment_queue";
6
+
7
+ /* eslint-disable @typescript-eslint/no-explicit-any */
8
+
9
+ /* eslint-disable @typescript-eslint/no-unsafe-assignment */
10
+
11
+ const { mockLog, mockCreateRequest, mockUpdatePriority } = vi.hoisted(() => {
12
+ return {
13
+ mockLog: {
14
+ debug: vi.fn(),
15
+ info: vi.fn(),
16
+ warn: vi.fn(),
17
+ error: vi.fn(),
18
+ },
19
+ mockCreateRequest: vi.fn(),
20
+ mockUpdatePriority: vi.fn(),
21
+ };
22
+ });
23
+
24
+ vi.mock("../../../../log", () => ({ default: mockLog }));
25
+
26
+ /** Build a minimal fake segment. */
27
+ function makeSegment(id: string, time = 0): { id: string; time: number } {
28
+ return { id, time };
29
+ }
30
+
31
+ /** Build a minimal ISegmentQueueContext. */
32
+ function makeContent(type = "video"): ISegmentQueueContext {
33
+ return {
34
+ adaptation: { type } as any,
35
+ manifest: {} as any,
36
+ period: {} as any,
37
+ representation: {} as any,
38
+ };
39
+ }
40
+
41
+ /**
42
+ * Build a fake IPrioritizedSegmentFetcher whose `createRequest` delegates to
43
+ * the shared `mockCreateRequest` spy and returns a controllable Promise.
44
+ */
45
+ function makeSegmentFetcher() {
46
+ return {
47
+ createRequest: mockCreateRequest,
48
+ updatePriority: mockUpdatePriority,
49
+ };
50
+ }
51
+
52
+ /** Default interrupted reference (not interrupted). */
53
+ function makeInterruptedRef(initial = false) {
54
+ return new SharedReference<boolean>(initial);
55
+ }
56
+
57
+ /**
58
+ * Helper that captures the callbacks passed to `createRequest` for a given
59
+ * call index and exposes controls to simulate request lifecycle events.
60
+ */
61
+ function captureRequestCallbacks(callIndex = 0) {
62
+ const [, , callbacks] = mockCreateRequest.mock.calls[callIndex];
63
+ return callbacks as {
64
+ onRetry: (err: any) => void;
65
+ beforeInterrupted: () => void;
66
+ onChunk: (parse: (ts: number | undefined) => any) => void;
67
+ onAllChunksReceived: () => void;
68
+ beforeEnded: () => void;
69
+ };
70
+ }
71
+
72
+ describe("SegmentQueue", () => {
73
+ let fetcher: ReturnType<typeof makeSegmentFetcher>;
74
+ let interruptedRef: SharedReference<boolean>;
75
+
76
+ beforeEach(() => {
77
+ fetcher = makeSegmentFetcher();
78
+ interruptedRef = makeInterruptedRef();
79
+
80
+ // Default createRequest: return a never-resolving promise so we can
81
+ // control resolution manually.
82
+ mockCreateRequest.mockReturnValue(new Promise(noop));
83
+ });
84
+
85
+ afterEach(() => {
86
+ vi.resetAllMocks();
87
+ });
88
+
89
+ describe("constructor / initial state", () => {
90
+ it("initialises with no pending requests", () => {
91
+ const queue = new SegmentQueue(fetcher, interruptedRef);
92
+ expect(queue.getRequestedInitSegment()).toBeNull();
93
+ expect(queue.getRequestedMediaSegment()).toBeNull();
94
+ });
95
+ });
96
+
97
+ describe("stop()", () => {
98
+ it("does nothing when called before resetForContent", () => {
99
+ const queue = new SegmentQueue(fetcher, interruptedRef);
100
+ expect(() => queue.stop("test")).not.toThrow();
101
+ });
102
+
103
+ it("cancels ongoing content after resetForContent", () => {
104
+ const queue = new SegmentQueue(fetcher, interruptedRef);
105
+ const content = makeContent();
106
+ const downloadQueue = queue.resetForContent(content, false, undefined);
107
+
108
+ // Finishing the SharedReference signals the canceller propagated.
109
+ // We check by verifying that further updates on the returned ref do
110
+ // NOT trigger new requests after stop().
111
+ queue.stop("reason");
112
+
113
+ // NOTE: Doing this in dev build might trigger console.error calls, we
114
+ // mute it in case
115
+ vi.spyOn(console, "error").mockImplementation(noop);
116
+
117
+ // Push a media segment – should not start a request.
118
+ downloadQueue.setValue({
119
+ initSegment: null,
120
+ segmentQueue: [{ segment: makeSegment("s1") as any, priority: 1 }],
121
+ });
122
+
123
+ // createRequest should never have been called (no init, queue was stopped).
124
+ expect(mockCreateRequest).not.toHaveBeenCalled();
125
+ });
126
+ });
127
+
128
+ describe("resetForContent()", () => {
129
+ it("cancels the previous content when called a second time", () => {
130
+ const queue = new SegmentQueue(fetcher, interruptedRef);
131
+ const content1 = makeContent("video");
132
+ const downloadQueue1 = queue.resetForContent(content1, false, undefined);
133
+
134
+ const content2 = makeContent("audio");
135
+ queue.resetForContent(content2, false, undefined);
136
+
137
+ // NOTE: Doing this in dev build might trigger console.error calls, we
138
+ // mute it in case
139
+ vi.spyOn(console, "error").mockImplementation(noop);
140
+
141
+ // After the second call, the first downloadQueue should be finished;
142
+ // pushing on it has no further effect.
143
+ expect(() =>
144
+ downloadQueue1.setValue({ initSegment: null, segmentQueue: [] }),
145
+ ).not.toThrow();
146
+ });
147
+
148
+ it("returns a SharedReference with default empty value", () => {
149
+ const queue = new SegmentQueue(fetcher, interruptedRef);
150
+ const ref = queue.resetForContent(makeContent(), false, undefined);
151
+ const val = ref.getValue();
152
+ expect(val.initSegment).toBeNull();
153
+ expect(val.segmentQueue).toEqual([]);
154
+ });
155
+ });
156
+
157
+ describe("getRequestedInitSegment / getRequestedMediaSegment", () => {
158
+ it("returns null when no requests are in flight", () => {
159
+ const queue = new SegmentQueue(fetcher, interruptedRef);
160
+ queue.resetForContent(makeContent(), false, undefined);
161
+ expect(queue.getRequestedInitSegment()).toBeNull();
162
+ expect(queue.getRequestedMediaSegment()).toBeNull();
163
+ });
164
+
165
+ it("returns the init segment once its request starts", () => {
166
+ const queue = new SegmentQueue(fetcher, interruptedRef);
167
+ const content = makeContent();
168
+ const downloadQueue = queue.resetForContent(content, true, undefined);
169
+
170
+ const initSeg = makeSegment("init-1");
171
+ downloadQueue.setValue({
172
+ initSegment: { segment: initSeg as any, priority: 1 },
173
+ segmentQueue: [],
174
+ });
175
+
176
+ expect(queue.getRequestedInitSegment()).toEqual(initSeg);
177
+ expect(queue.getRequestedMediaSegment()).toBeNull();
178
+ });
179
+
180
+ it("returns the media segment once its request starts", () => {
181
+ const queue = new SegmentQueue(fetcher, interruptedRef);
182
+ const content = makeContent();
183
+ // hasInitSegment=false so media can start without waiting for init
184
+ const downloadQueue = queue.resetForContent(content, false, undefined);
185
+
186
+ const mediaSeg = makeSegment("media-1");
187
+ downloadQueue.setValue({
188
+ initSegment: null,
189
+ segmentQueue: [{ segment: mediaSeg as any, priority: 2 }],
190
+ });
191
+
192
+ expect(queue.getRequestedMediaSegment()).toEqual(mediaSeg);
193
+ });
194
+ });
195
+
196
+ describe("media segment downloading", () => {
197
+ it("does not start a request when queue is empty", () => {
198
+ const queue = new SegmentQueue(fetcher, interruptedRef);
199
+ queue.resetForContent(makeContent(), false, undefined);
200
+ // Default value already has an empty segmentQueue – no request expected.
201
+ expect(mockCreateRequest).not.toHaveBeenCalled();
202
+ });
203
+
204
+ it("starts a request when a segment is added to the queue", () => {
205
+ const queue = new SegmentQueue(fetcher, interruptedRef);
206
+ const downloadQueue = queue.resetForContent(makeContent(), false, undefined);
207
+
208
+ downloadQueue.setValue({
209
+ initSegment: null,
210
+ segmentQueue: [{ segment: makeSegment("s1") as any, priority: 1 }],
211
+ });
212
+
213
+ expect(mockCreateRequest).toHaveBeenCalledTimes(1);
214
+ });
215
+
216
+ it("updates priority when segment priority changes", () => {
217
+ const queue = new SegmentQueue(fetcher, interruptedRef);
218
+ const downloadQueue = queue.resetForContent(makeContent(), false, undefined);
219
+
220
+ const seg = makeSegment("s1");
221
+ downloadQueue.setValue({
222
+ initSegment: null,
223
+ segmentQueue: [{ segment: seg as any, priority: 5 }],
224
+ });
225
+ expect(mockCreateRequest).toHaveBeenCalledTimes(1);
226
+
227
+ // Change priority of the same segment
228
+ downloadQueue.setValue({
229
+ initSegment: null,
230
+ segmentQueue: [{ segment: seg as any, priority: 1 }],
231
+ });
232
+
233
+ expect(mockUpdatePriority).toHaveBeenCalledTimes(1);
234
+ expect(mockUpdatePriority.mock.calls[0][1]).toBe(1);
235
+ });
236
+
237
+ it("restarts the queue when the next needed segment changes", () => {
238
+ const queue = new SegmentQueue(fetcher, interruptedRef);
239
+ const downloadQueue = queue.resetForContent(makeContent(), false, undefined);
240
+
241
+ downloadQueue.setValue({
242
+ initSegment: null,
243
+ segmentQueue: [{ segment: makeSegment("s1") as any, priority: 1 }],
244
+ });
245
+ expect(mockCreateRequest).toHaveBeenCalledTimes(1);
246
+
247
+ // Swap to a different segment at the head of the queue
248
+ downloadQueue.setValue({
249
+ initSegment: null,
250
+ segmentQueue: [{ segment: makeSegment("s2") as any, priority: 1 }],
251
+ });
252
+
253
+ // A second createRequest should have been issued for the new segment
254
+ expect(mockCreateRequest).toHaveBeenCalledTimes(2);
255
+ });
256
+
257
+ it("emits emptyQueue event when segment queue becomes empty mid-flight", () => {
258
+ const queue = new SegmentQueue<unknown>(fetcher, interruptedRef);
259
+ const downloadQueue = queue.resetForContent(makeContent(), false, undefined);
260
+
261
+ const emptyQueueHandler = vi.fn();
262
+ queue.addEventListener("emptyQueue", emptyQueueHandler);
263
+
264
+ downloadQueue.setValue({
265
+ initSegment: null,
266
+ segmentQueue: [{ segment: makeSegment("s1") as any, priority: 1 }],
267
+ });
268
+
269
+ // Now empty the queue while request is in-flight
270
+ downloadQueue.setValue({ initSegment: null, segmentQueue: [] });
271
+
272
+ expect(emptyQueueHandler).toHaveBeenCalled();
273
+ });
274
+
275
+ it("emits requestRetry when onRetry callback is invoked", () => {
276
+ const queue = new SegmentQueue<unknown>(fetcher, interruptedRef);
277
+ const downloadQueue = queue.resetForContent(makeContent(), false, undefined);
278
+
279
+ const retryHandler = vi.fn();
280
+ queue.addEventListener("requestRetry", retryHandler);
281
+
282
+ const seg = makeSegment("s1");
283
+ downloadQueue.setValue({
284
+ initSegment: null,
285
+ segmentQueue: [{ segment: seg as any, priority: 1 }],
286
+ });
287
+
288
+ const cbs = captureRequestCallbacks(0);
289
+ const fakeError = new Error("network error");
290
+ cbs.onRetry(fakeError);
291
+
292
+ expect(retryHandler).toHaveBeenCalledWith({ segment: seg, error: fakeError });
293
+ });
294
+
295
+ it("emits fullyLoadedSegment after onAllChunksReceived (no init wait)", () => {
296
+ const queue = new SegmentQueue<unknown>(fetcher, interruptedRef);
297
+ const downloadQueue = queue.resetForContent(makeContent(), false, undefined);
298
+
299
+ const fullyLoadedHandler = vi.fn();
300
+ queue.addEventListener("fullyLoadedSegment", fullyLoadedHandler);
301
+
302
+ const seg = makeSegment("s1");
303
+ downloadQueue.setValue({
304
+ initSegment: null,
305
+ segmentQueue: [{ segment: seg as any, priority: 1 }],
306
+ });
307
+
308
+ const cbs = captureRequestCallbacks(0);
309
+ cbs.onAllChunksReceived();
310
+
311
+ expect(fullyLoadedHandler).toHaveBeenCalledWith(seg);
312
+ });
313
+
314
+ it("emits parsedMediaSegment when a chunk is received (no init segment)", () => {
315
+ const queue = new SegmentQueue<unknown>(fetcher, interruptedRef);
316
+ const downloadQueue = queue.resetForContent(makeContent(), false, undefined);
317
+
318
+ const parsedHandler = vi.fn();
319
+ queue.addEventListener("parsedMediaSegment", parsedHandler);
320
+
321
+ const seg = makeSegment("s1");
322
+ downloadQueue.setValue({
323
+ initSegment: null,
324
+ segmentQueue: [{ segment: seg as any, priority: 1 }],
325
+ });
326
+
327
+ const cbs = captureRequestCallbacks(0);
328
+ const fakeChunkData = { segmentType: "media", chunkData: "data" };
329
+ cbs.onChunk(() => fakeChunkData as any);
330
+
331
+ expect(parsedHandler).toHaveBeenCalled();
332
+ expect(parsedHandler.mock.calls[0][0]).toMatchObject({
333
+ segmentType: "media",
334
+ segment: seg,
335
+ });
336
+ });
337
+
338
+ it("moves to the next segment after beforeEnded is called", () => {
339
+ const queue = new SegmentQueue<unknown>(fetcher, interruptedRef);
340
+ const downloadQueue = queue.resetForContent(makeContent(), false, undefined);
341
+
342
+ const seg1 = makeSegment("s1");
343
+ const seg2 = makeSegment("s2");
344
+ downloadQueue.setValue({
345
+ initSegment: null,
346
+ segmentQueue: [
347
+ { segment: seg1 as any, priority: 1 },
348
+ { segment: seg2 as any, priority: 1 },
349
+ ],
350
+ });
351
+
352
+ expect(mockCreateRequest).toHaveBeenCalledTimes(1);
353
+
354
+ // Simulate end of first request
355
+ const cbs = captureRequestCallbacks(0);
356
+ cbs.beforeEnded();
357
+
358
+ // A second request should have started for s2
359
+ expect(mockCreateRequest).toHaveBeenCalledTimes(2);
360
+ });
361
+
362
+ it("emits error and stops when the request promise rejects", async () => {
363
+ let rejectRequest!: (err: unknown) => void;
364
+ mockCreateRequest.mockReturnValueOnce(
365
+ new Promise<void>((_, reject) => {
366
+ rejectRequest = reject;
367
+ }),
368
+ );
369
+
370
+ const queue = new SegmentQueue<unknown>(fetcher, interruptedRef);
371
+ const downloadQueue = queue.resetForContent(makeContent(), false, undefined);
372
+
373
+ const errorHandler = vi.fn();
374
+ queue.addEventListener("error", errorHandler);
375
+
376
+ downloadQueue.setValue({
377
+ initSegment: null,
378
+ segmentQueue: [{ segment: makeSegment("s1") as any, priority: 1 }],
379
+ });
380
+
381
+ const fakeErr = new Error("fatal");
382
+ rejectRequest(fakeErr);
383
+
384
+ // Let microtasks run
385
+ await Promise.resolve();
386
+ await Promise.resolve();
387
+
388
+ expect(errorHandler).toHaveBeenCalledWith(fakeErr);
389
+ });
390
+ });
391
+
392
+ describe("init segment downloading", () => {
393
+ it("starts an init segment request when one is provided", () => {
394
+ const queue = new SegmentQueue(fetcher, interruptedRef);
395
+ const downloadQueue = queue.resetForContent(makeContent(), true, undefined);
396
+
397
+ const initSeg = makeSegment("init-1");
398
+ downloadQueue.setValue({
399
+ initSegment: { segment: initSeg as any, priority: 0 },
400
+ segmentQueue: [],
401
+ });
402
+
403
+ expect(mockCreateRequest).toHaveBeenCalledTimes(1);
404
+ expect(queue.getRequestedInitSegment()).toEqual(initSeg);
405
+ });
406
+
407
+ it("emits parsedInitSegment event when init chunk arrives", () => {
408
+ const queue = new SegmentQueue<unknown>(fetcher, interruptedRef);
409
+ const downloadQueue = queue.resetForContent(makeContent(), true, undefined);
410
+
411
+ const parsedInitHandler = vi.fn();
412
+ queue.addEventListener("parsedInitSegment", parsedInitHandler);
413
+
414
+ const initSeg = makeSegment("init-1");
415
+ downloadQueue.setValue({
416
+ initSegment: { segment: initSeg as any, priority: 0 },
417
+ segmentQueue: [],
418
+ });
419
+
420
+ const cbs = captureRequestCallbacks(0);
421
+ const fakeInitData = { segmentType: "init", initTimescale: 90000 };
422
+ cbs.onChunk(() => fakeInitData as any);
423
+
424
+ expect(parsedInitHandler).toHaveBeenCalled();
425
+ expect(parsedInitHandler.mock.calls[0][0]).toMatchObject({
426
+ segmentType: "init",
427
+ segment: initSeg,
428
+ });
429
+ });
430
+
431
+ it("updates init segment priority when it changes", () => {
432
+ const queue = new SegmentQueue(fetcher, interruptedRef);
433
+ const downloadQueue = queue.resetForContent(makeContent(), true, undefined);
434
+
435
+ const initSeg = makeSegment("init-1");
436
+ downloadQueue.setValue({
437
+ initSegment: { segment: initSeg as any, priority: 5 },
438
+ segmentQueue: [],
439
+ });
440
+ expect(mockCreateRequest).toHaveBeenCalledTimes(1);
441
+
442
+ downloadQueue.setValue({
443
+ initSegment: { segment: initSeg as any, priority: 1 },
444
+ segmentQueue: [],
445
+ });
446
+
447
+ expect(mockUpdatePriority).toHaveBeenCalledTimes(1);
448
+ expect(mockUpdatePriority.mock.calls[0][1]).toBe(1);
449
+ });
450
+
451
+ it("cancels init request when initSegment is set to null", () => {
452
+ const queue = new SegmentQueue(fetcher, interruptedRef);
453
+ const downloadQueue = queue.resetForContent(makeContent(), true, undefined);
454
+
455
+ const initSeg = makeSegment("init-1");
456
+ downloadQueue.setValue({
457
+ initSegment: { segment: initSeg as any, priority: 0 },
458
+ segmentQueue: [],
459
+ });
460
+
461
+ // Should not throw when init segment is removed
462
+ expect(() =>
463
+ downloadQueue.setValue({ initSegment: null, segmentQueue: [] }),
464
+ ).not.toThrow();
465
+ });
466
+
467
+ it("emits fullyLoadedSegment for init segment after onAllChunksReceived", () => {
468
+ const queue = new SegmentQueue<unknown>(fetcher, interruptedRef);
469
+ const downloadQueue = queue.resetForContent(makeContent(), true, undefined);
470
+
471
+ const fullyLoadedHandler = vi.fn();
472
+ queue.addEventListener("fullyLoadedSegment", fullyLoadedHandler);
473
+
474
+ const initSeg = makeSegment("init-1");
475
+ downloadQueue.setValue({
476
+ initSegment: { segment: initSeg as any, priority: 0 },
477
+ segmentQueue: [],
478
+ });
479
+
480
+ const cbs = captureRequestCallbacks(0);
481
+ const fakeInitData = { segmentType: "init", initTimescale: 90000 };
482
+ cbs.onChunk(() => fakeInitData as any);
483
+ cbs.onAllChunksReceived();
484
+
485
+ expect(fullyLoadedHandler).toHaveBeenCalledWith(initSeg);
486
+ });
487
+ });
488
+
489
+ describe("isMediaSegmentQueueInterrupted", () => {
490
+ it("does not start media requests when interrupted from the start", () => {
491
+ const interrupted = makeInterruptedRef(true);
492
+ const queue = new SegmentQueue(fetcher, interrupted);
493
+ const downloadQueue = queue.resetForContent(makeContent(), false, undefined);
494
+
495
+ downloadQueue.setValue({
496
+ initSegment: null,
497
+ segmentQueue: [{ segment: makeSegment("s1") as any, priority: 1 }],
498
+ });
499
+
500
+ expect(mockCreateRequest).not.toHaveBeenCalled();
501
+ });
502
+
503
+ it("resumes media requests when interrupted flag goes back to false", () => {
504
+ const interrupted = makeInterruptedRef(true);
505
+ const queue = new SegmentQueue(fetcher, interrupted);
506
+ const downloadQueue = queue.resetForContent(makeContent(), false, undefined);
507
+
508
+ downloadQueue.setValue({
509
+ initSegment: null,
510
+ segmentQueue: [{ segment: makeSegment("s1") as any, priority: 1 }],
511
+ });
512
+
513
+ expect(mockCreateRequest).not.toHaveBeenCalled();
514
+
515
+ // Lift the interruption
516
+ interrupted.setValue(false);
517
+
518
+ expect(mockCreateRequest).toHaveBeenCalledTimes(1);
519
+ });
520
+ });
521
+
522
+ describe("media segment waiting on init metadata", () => {
523
+ it("delays parsedMediaSegment until init timescale is known", () => {
524
+ const queue = new SegmentQueue<unknown>(fetcher, interruptedRef);
525
+ const downloadQueue = queue.resetForContent(makeContent(), true, undefined);
526
+
527
+ const parsedMediaHandler = vi.fn();
528
+ queue.addEventListener("parsedMediaSegment", parsedMediaHandler);
529
+
530
+ const initSeg = makeSegment("init-1");
531
+ const mediaSeg = makeSegment("media-1");
532
+
533
+ // Set up both init and media segment in queue
534
+ downloadQueue.setValue({
535
+ initSegment: { segment: initSeg as any, priority: 0 },
536
+ segmentQueue: [{ segment: mediaSeg as any, priority: 0 }],
537
+ });
538
+
539
+ // Two createRequest calls: one for init, one for media
540
+ expect(mockCreateRequest).toHaveBeenCalledTimes(2);
541
+
542
+ // The first call's callbacks represent the media segment
543
+ const mediaCbs = captureRequestCallbacks(0);
544
+
545
+ // Media chunk arrives BEFORE init has been parsed → handler not called yet
546
+ mediaCbs.onChunk(() => ({ segmentType: "media", chunkData: "x" }) as any);
547
+ expect(parsedMediaHandler).not.toHaveBeenCalled();
548
+
549
+ // Now parse the init segment (resolves the SharedReference)
550
+ const initCbs = captureRequestCallbacks(1);
551
+ initCbs.onChunk(() => ({ segmentType: "init", initTimescale: 90000 }) as any);
552
+
553
+ // After init timescale is set, the deferred media parse should fire
554
+ expect(parsedMediaHandler).toHaveBeenCalled();
555
+ });
556
+ });
557
+ });
@@ -595,8 +595,8 @@ export interface ISegmentQueueEvent<T> {
595
595
  * You can now push that segment to its corresponding buffer and use its parsed
596
596
  * metadata.
597
597
  *
598
- * Only sent if an initialization segment exists (when the `SegmentQueue`'s
599
- * `hasInitSegment` constructor option has been set to `true`).
598
+ * Only sent if an initialization segment exists (when the `hasInitSegment`
599
+ * option has been set to `true`).
600
600
  * In that case, an `IParsedInitSegmentEvent` will always be sent before any
601
601
  * `IParsedSegmentEvent` event is sent.
602
602
  */
@@ -605,10 +605,9 @@ export interface ISegmentQueueEvent<T> {
605
605
  * Notify that a media chunk (decodable sub-part of a media segment) has been
606
606
  * loaded and parsed.
607
607
  *
608
- * If an initialization segment exists (when the `SegmentQueue`'s
609
- * `hasInitSegment` constructor option has been set to `true`), an
610
- * `IParsedSegmentEvent` will always be sent AFTER the `IParsedInitSegmentEvent`
611
- * event.
608
+ * If an initialization segment exists (when the `hasInitSegment` option has
609
+ * been set to `true`), an `IParsedSegmentEvent` will always be sent AFTER
610
+ * the `IParsedInitSegmentEvent` event.
612
611
  *
613
612
  * It can now be pushed to its corresponding buffer. Note that there might be
614
613
  * multiple `IParsedSegmentEvent` for a single segment, if that segment is