@dolby-optiview/ads-sdk 1.4.0 → 1.6.0

package/ai/reference/error-codes.md

@@ -9,6 +9,11 @@ of the public contract and are never renamed.
 
 | Code | Category | Level | Meaning |
 |---|---|---|---|
+| `DA-BOOKMARK-START` | break | info | VOD bookmark start skipped earlier breaks. context: position, skippedBreakIds. |
+| `DA-CONTENT-END-INFERRED` | playback | info | Content end inferred from the VOD playhead. context: currentTime, duration, trigger (past-end or stalled-at-end). |
+| `DA-SNAPBACK-APPLIED` | break | info | Viewer seek corrected to an unplayed VOD snapback break. context: breakId, target, resumePosition (seek-over of a content-pausing format only). |
+| `DA-SNAPBACK-ABANDONED` | break | warn | VOD snapback correction abandoned after one retry or because the break became ineligible. context: breakId, reason. |
+| `DA-SNAPBACK-NOT-APPLIED` | break | debug | Viewer seek was not eligible for VOD snapback. context: reason, breakId (when known). |
 | `DA-SESSION-STARTED` | session | info | Monetization session started; manifest polling began. context: manifestUrl (stitcherUrl in SSAI mode), reported verbatim. |
 | `DA-SESSION-ENDED` | session | info | Monetization session ended; polling and scheduling stopped. |
 | `DA-ASSET-PARAMETERS-UPDATED` | session | info | The break manifest's session-level asset parameters changed; the merged parameters were pushed to the active GAM stream. context: source ('manifest'), keys (parameter names only, never values). |
@@ -19,6 +24,7 @@ of the public contract and are never renamed.
 | `DA-MANIFEST-REQUEST-INTERCEPT-FAILED` | manifest | warn | The customer manifest-request interceptor threw; the normal network fetch of the original URL was used instead. |
 | `DA-MANIFEST-SIGNATURE-INVALID` | manifest | error | The break-manifest response failed detached-JWS signature verification (missing/malformed X-Manifest-Signature, unsupported alg, unknown kid, unknown critical param, or signature mismatch); the manifest was rejected and no breaks were scheduled. context: url, reason. |
 | `DA-MANIFEST-EVENT-INVALID` | manifest | warn | A channel event was ignored because its time window or configuration is invalid, or because events are unsupported for the manifest timebase. context: eventId and index when available. |
+| `DA-SLATE-INVALID` | manifest | warn | The manifest's slate was ignored because it is unusable: not an object, an invalid minDuration, no assets, or an invalid first asset (the only one the player plays). The breaks of that manifest are unaffected and play without a slate. Reported once per distinct fault. context: reason (not-object, invalid-min-duration, no-assets, invalid-asset), assetId when the first asset has one. |
 | `DA-PDT-MISSING` | playback | warn | No EXT-X-PROGRAM-DATE-TIME once content is playing (or after the startup backstop window); wallclock-timebase breaks fall back to the system clock. |
 | `DA-ANVATO-CUE-PENDING` | break | info | ptsSource: 'anvatoCue' — no Anvato in-stream cue observed yet for a PTS break; the break stays pending until its cue arrives. |
 | `DA-ANVATO-CUE-MATCHED` | break | info | ptsSource: 'anvatoCue' — a PTS break's start was matched to an observed Anvato cue and scheduled at the cue's media time. |
@@ -29,6 +35,7 @@ of the public contract and are never renamed.
 | `DA-ANVATO-CUE-END-MATCHED` | break | info | ptsSource: 'anvatoCue' — the active break's Anvato type=cue_end was observed and its length on the stream clock (cue_end pts minus the break start pts) is within 2s of the break duration. Emitted once per break; context: breakId, mediaTime (where the player reported the cue_end), lengthSec, durationSec. |
 | `DA-ANVATO-CUE-END-REJECTED` | break | warn | ptsSource: 'anvatoCue' — an Anvato type=cue_end was observed for the active break but its stream-clock length differs from the break duration by more than 2s, so it is ignored and the resume keeps its computed target. Emitted once per break; context: breakId, mediaTime, lengthSec, durationSec. |
 | `DA-PRELOAD-FAILED` | preload | warn | Ad preload failed; the asset will be loaded on demand at break start. |
+| `DA-SLATE-PRELOADED` | preload | info | The manifest's slate asset was fetched ahead of its first use, on its first appearance in the manifest or when its URL changed, so a break that needs it starts it warm. Best-effort: a failed warm-up never fails a break. context: slateAssetId, mediaType, path (the preload path taken). |
 | `DA-PRELOAD-MODE-RESOLVED` | preload | info | The configured ad preload mode was resolved for this session; context carries both the configured and the resolved mode. |
 | `DA-PRELOAD-PATH` | preload | info | The preload path actually taken for a break's ad (parallel buffer / detached prefetch / first-frame warm-up on the ad player / none) and the creative container (stream vs progressive). |
 | `DA-BREAK-EARLY-RETURN` | break | info | The active break was removed from a polled manifest (early return); the break ends immediately and content resumes at break start plus the seconds already played. |
@@ -44,7 +51,9 @@ of the public contract and are never renamed.
 | `DA-PREROLL-CANCELLED-CONTENT-ERROR` | break | warn | A pending pre-roll was cancelled because the content failed to load before it could begin. |
 | `DA-SHARED-ELEMENT-UNSUPPORTED` | break | warn | Configured shared-element insertion is unsupported on this platform (non-iPhone/iPod); fell back to overlay insertion. |
 | `DA-SHARED-ELEMENT-RESTORE-FAILED` | playback | error | Content did not resume after a shared-element break: the reload/seek/play restore failed twice; the viewer is left paused on the handed-back element. |
-| `DA-IMAGE-LOAD-FAILED` | break | warn | An image (companion, backdrop or image ad) could not be fetched or decoded within the timeout; the break continues without it. |
+| `DA-IMAGE-LOAD-FAILED` | break | warn | An image (companion, backdrop or image ad) could not be fetched or decoded within the timeout, or exceeded the size limit; the break continues without it. |
+| `DA-IMAGE-ANIMATED` | break | debug | An animated image (GIF or animated WebP) started animating on a companion, backdrop, image ad or pause image. Native renderers only: browsers animate the image element themselves. context: surface ('companion', 'backdrop', 'image-ad' or 'pause'), uri, frameCount (iOS/tvOS; null on Android). |
+| `DA-IMAGE-ANIMATION-UNSUPPORTED` | break | warn | An image is animated but this device cannot animate it, so its first frame is shown. context: surface, uri, reason ('api-below-28' on Android below API 28; 'canvas-too-large' on iOS/tvOS when the animation exceeds the decode budget). |
 | `DA-PIP-TRANSFER-FAILED` | break | warn | The picture-in-picture window could not be moved between the content and ad elements; the break continues but the viewer may not see the ad in the PiP window. |
 | `DA-PIP-AUTODETECT-UNAVAILABLE` | break | warn | No Activity could be resolved from the renderer's Context or the overlay's view tree, so picture-in-picture cannot be detected automatically; the host must call OptiViewAds.setPictureInPicture() from Activity.onPictureInPictureModeChanged or breaks will be laid out for a fullscreen surface. Android only. |
 | `DA-CONTENT-ELEMENT-SWAPPED` | break | info | The content player replaced its <video> element; the SDK re-bound its presentation listeners to the new one. |
@@ -68,7 +77,13 @@ of the public contract and are never renamed.
 | `DA-EXTERNAL-VENDOR-DUPLICATE` | manifest | warn | External vendorConfiguration entries repeated a provider; the first valid entry was used. context: providers. |
 | `DA-CONTENT-PLAYBACK-ERROR` | playback | error | The content player reported a playback error. |
 | `DA-EXTERNAL-PLAYBACK-CHANGED` | playback | info | The content player's external (AirPlay) playback state changed; context carries the new state and the target. |
-| `DA-EXTERNAL-PLAYBACK-BLOCKED` | playback | warn | AirPlay was requested while an ad break is active or about to start; the content player stays on the device and the request is retried when the break ends. |
+| `DA-EXTERNAL-PLAYBACK-BLOCKED` | playback | warn | AirPlay was requested while an ad break is active or about to start; the content player stays on the device and the request is retried when the break ends. On iOS the running ad plays on the receiver meanwhile. |
+| `DA-AD-ROUTE-CHANGED` | playback | info | iOS: the audio route changed while an ad break played; context carries the route change reason, the current and previous outputs and a snapshot of the ad player (time control status, waiting reason, rate, buffer flags, external playback, ad and content state). |
+| `DA-AD-TIMECONTROL` | playback | info | iOS: the ad player's timeControlStatus or reasonForWaitingToPlay changed during an ad break; context.field names which, with the ad player snapshot. |
+| `DA-AD-ITEM-STALLED` | playback | warn | iOS: the ad player's current item reported a playback stall during an ad break; context carries the ad player snapshot. |
+| `DA-AD-AUDIO-INTERRUPTION` | playback | warn | iOS: an audio-session interruption began or ended during an ad break (context.type, options, wasSuspended) with the ad player snapshot. |
+| `DA-AD-INTERRUPTION-RESUMED` | playback | warn | iOS: an ad paused by an audio-session interruption was restarted after the audio session was reactivated; context.trigger is interruption-ended, route-changed, player-paused or retry, stalledSec how long the ad was stopped. |
+| `DA-AD-AUDIO-SESSION-REACTIVATE-FAILED` | playback | warn | iOS: reactivating the audio session before restarting an interrupted ad failed (context.errorCode, errorDomain, trigger); the SDK retries once a second, up to five times. |
 | `DA-SSB-SWITCH-FAILED` | playback | warn | Switching the content player to the SSB stream for AirPlay failed (context.reason: no-restore-source, load-error, load-timeout, external-not-active or receiver-paused); the SDK restores the previous content. |
 | `DA-SSB-RESTORE-FAILED` | playback | error | The previous content source could not be reloaded after the SSB stream (AirPlay ended or the switch failed); the session stays in ssb delivery until the app reloads its content. |
 | `DA-EXTERNAL-PLAYBACK-ALLOWED` | playback | info | An AirPlay request passed the ad-break guard; context.trigger says whether it was the request itself or the retry after a break. |
@@ -108,6 +123,7 @@ of the public contract and are never renamed.
 | `DA-VAST-REQUEST-FAILED` | gam | error | The VAST ad request failed (network error, invalid tag URL, wrapper error or too many redirects); reported as CMCD adec. |
 | `DA-VAST-CREATIVE-FAILED` | gam | error | The VAST creative could not be played (no compatible media file, playback error or trafficking error); reported as CMCD adec. |
 | `DA-VAST-IMA-SDK-MISSING` | gam | error | The Google IMA client-side SDK (ima3.js) is unavailable; VAST (CSAI) ads cannot be played. |
+| `DA-PAUSE-AD-ROTATION-EXHAUSTED` | break | info | No unused pause breaks remain in the rotation; nothing was shown. |
 | `DA-PAUSE-AD-SHOWN` | break | info | A pause ad (full-screen image or video) was shown while content is paused. |
 | `DA-PAUSE-AD-DISMISSED` | break | info | A pause ad was dismissed (content resumed, or the duration cap elapsed). |
 | `DA-PAUSE-AD-RESUME-ALLOWED` | break | info | The viewer may now resume content over the shown pause ad: the break's controls.skipOffset elapsed, or (no skipOffset) the ad was watched fully: a video creative ended, an image reached its duration cap or has none. context: breakId. |
@@ -151,8 +167,13 @@ of the public contract and are never renamed.
 | `DA-EVENT` | event | info | An SDK event, recorded into the diagnostic ring buffer so exportDiagnostics() carries one unified timeline of diagnostics and playback events. Raised to error for aderror. Buffer-only: not dispatched to onDiagnostic handlers, which would duplicate the event stream they already receive. |
 | `DA-BREAK-CONTENT-MASK` | break | warn | The host's content surface cannot follow view transforms (punch-through SurfaceView, e.g. react-native-video's default), so the two-box format masks the backdrop with a transparent hole over the content box instead of reframing the content view. context: format. |
 | `DA-BREAK-FORMAT-DEGRADED` | break | warn | Split break reframing degraded: the host supplied no content view or sibling container for the ad. |
-| `DA-BREAK-NO-PLAYABLE-ASSET` | break | warn | A break had nothing to play, so it never began: no adbreakbegin/adbreakend was emitted, content kept playing, and a public aderror (source ad, carrying the break) reports it. context.reason says why: no-variant (none declared), no-qualifying-variant (variant selection - device targeting + format playability - matched nothing and no downgrade applied), no-assets (the selected variant was empty), or lshape-content-skipped (shared-element insertion cannot render a backdrop). This is the BREAK-level outcome; when a particular variant was passed over for an unrecognised format, DA-BREAK-VARIANT-FORMAT-UNKNOWN names that format alongside it. context: breakId, reason, declaredAssetCount, format. |
+| `DA-SLATE-STARTED` | break | info | The slate began playing in a break because no ad covered the rest of it; it plays until the break's scheduled end (adbreakbegin plus the effective duration) and then the break ends as any other. No adbegin/adend is emitted for it. context: breakId, slateAssetId, reason (ads-ended: the last ad ended before the break end; no-ad: no ad could play), durationSec (the real time left to the scheduled end, so time lost to failed ad attempts and start-up shortens it), adsPlayedSec, effectiveDurationSec, minDurationSec. |
+| `DA-SLATE-NOT-STARTED` | break | info | A break with a slate left part of its time uncovered but the slate did not start: less than the slate's minDuration remained (below-min-duration), or the stitched stream fills the break (not-rendered: a time-based break under ssai delivery, or while an SSB stream plays). The break ends as without a slate. context: breakId, reason, remainingSec, minDurationSec. |
+| `DA-SLATE-ENDED` | break | info | The slate stopped playing. context: breakId, slateAssetId, plannedSec (the real time left to the break's scheduled end when the slate started), filledSec (seconds the slate was on screen: start-up, stalls and loop restarts shorten it, never the break), loops (completed plays of a video slate), interruptedSec (time it was not presenting), breakOverrunSec (the slate's end minus the scheduled end, signed: about 0 at break-end, negative when ended early), reason (break-end: the scheduled end was reached; skipped, removed, resumed: ended early). |
+| `DA-SLATE-FAILED` | playback | error | The slate could not load or play (load error, or it did not present within the ad-start budget); the break ends as without a slate and a public aderror carries the slate asset. context: breakId, slateAssetId, reason (load, stalled), error. |
+| `DA-BREAK-NO-PLAYABLE-ASSET` | break | warn | A break had nothing to play, so it never began: no adbreakbegin/adbreakend was emitted, content kept playing, and a public aderror (source ad, carrying the break) reports it. When the manifest carries a slate that fills the break (reason no-assets only), the break does begin and the slate covers it: the aderror and this diagnostic are still reported, then DA-SLATE-STARTED follows. context.reason says why: no-variant (none declared), no-qualifying-variant (variant selection - device targeting + format playability - matched nothing and no downgrade applied), no-assets (the selected variant was empty), or lshape-content-skipped (shared-element insertion cannot render a backdrop). This is the BREAK-level outcome; when a particular variant was passed over for an unrecognised format, DA-BREAK-VARIANT-FORMAT-UNKNOWN names that format alongside it. context: breakId, reason, declaredAssetCount, format. |
 | `DA-BREAK-VARIANT-FORMAT-UNKNOWN` | break | warn | A break variant declares a format this SDK version does not recognise, so it was passed over during variant selection rather than guessed at - an unknown format is never playable, because rendering it as a fullscreen single would be the most invasive possible misreading. Raised once per skipped variant: a break that still has a playable variant plays it and reports this too, so the skip is never silent, and a break left with nothing also reports DA-BREAK-NO-PLAYABLE-ASSET with reason no-qualifying-variant. An ABSENT format is treated identically to an unrecognised one. context: breakId, format (the raw manifest string; empty when the field was absent). |
+| `DA-BREAK-LSHAPE-ANCHOR-UNKNOWN` | break | warn | An lshape_ad or lshape_content variant declares an anchor this SDK version does not recognise (manifest spec 1.11.0 knows top_left, top_right, bottom_left and bottom_right), so the break still plays with the video box in the default top_left corner. Raised once per break begin on the selected variant. context: breakId, format, anchor (the raw manifest string). |
 | `DA-AD-STALLED` | playback | warn | An ad began playing and then stopped advancing: the playhead did not move for the stall threshold while the ad was meant to be playing. context: assetId, breakId, playbackState, stalledForMs, positionMs, bufferedAheadMs, reason. |
 | `DA-AD-FOREGROUND-RESUMED` | playback | info | An in-flight ad resumed after the app returned to the foreground; context carries the suspended duration and ad position at resume. |
 | `DA-AD-FOCUS-LOST` | playback | warn | The overlay ad lost permanent audio focus during an active break; the host player must not reclaim focus while the SDK ad is on screen. context: breakId, transient, reason. |
@@ -162,3 +183,5 @@ of the public contract and are never renamed.
 | `DA-BREAK-ABANDONED` | lifecycle | warn | A break was still in flight when the session was torn down (endSession, destroy, or a startSession over an active session). context: breakId, cause, phase, unbalancedAdBegin, adIndex, totalAds, assetId. |
 | `DA-RENDERER-UNAVAILABLE` | lifecycle | error | The renderer could not render a break because a required piece of it was not attached (e.g. no ad player), after the SDK had already emitted adbreakbegin — so the break began and will never end. context: breakId, missing. |
 | `DA-SESSION-STARTING` | session | info | A step of startSession() was entered: begin, manifest-fetch, gam-init or scheduling. Emitted on entry, so the last one recorded names the step a hung startSession never finished. context: step, manifestUrl, elapsedMs. The URL is reported verbatim; the redacted config summary carries only its origin (config.manifestOrigin). |
+| `DA-MANIFEST-URL-DISCOVERED` | session | info | startSession() was called without a manifestUrl and the SDK started the session with the ads manifest URL the content player discovered (e.g. THEOlive discovery). context: manifestUrl (reported verbatim), source ('player-discovery'). |
+| `DA-MANIFEST-URL-UNAVAILABLE` | session | error | startSession() was called without a manifestUrl and no ads manifest URL could be resolved from the player. context: reason ('disabled': the manifestUrlDiscovery config flag is off, 'unsupported-adapter': the adapter cannot discover one, 'no-ads': the player reported none, 'timeout': still pending after the discovery wait). |

package/ai/reference/knowledge-base.md

@@ -12,6 +12,22 @@ the sequence leading up to a failure.
 
 ---
 
+## DA-BOOKMARK-START
+
+Expected saved-position behavior. Compare `position` and `skippedBreakIds` with the intended start position. See [Start VOD from a bookmark](../../../demo/docs/07-session.md#vod-bookmark-start) for player setup and subsequent seek behavior.
+
+## DA-SNAPBACK-APPLIED
+
+Expected VOD seek protection: the last crossed snapback break was selected; an already-played or unplayable last break never falls back to an earlier crossed break. Compare `target` with the break start. `resumePosition` is set only for seek-over of content-pausing Single or L-Shape Ad, including fullscreen fallbacks at break start. It overrides insertion policy and `resumeOffset`. Double Box, L-Shape Content and Overlay omit it: content keeps playing and plays on without a seek, using normal chaining. Confirm the landing and balanced break lifecycle; a correction request alone does not prove playback succeeded. Backward seeks into an unplayed window use normal resume policy.
+
+## DA-SNAPBACK-ABANDONED
+
+The content player did not land after one corrective retry, or the selected break became ineligible. Check the adapter's seek implementation, seekable range and competing host seeks. The SDK releases the correction instead of trapping playback in a loop.
+
+## DA-SNAPBACK-NOT-APPLIED
+
+Check the diagnostic `reason`, VOD mediatime scheduling, `controls.snapback`, playable variants and whether the break already started in this session. Live, event-triggered, SSAI/SSB and excluded single-decoder web platforms are unchanged.
+
 ## DA-SESSION-STARTED
 
 Informational. The session started and manifest polling began. Use it to confirm
@@ -31,6 +47,20 @@ the session does start, `context.elapsedMs` on each marker gives a per-step cost
 breakdown, so a _slow_ start is attributable without adding instrumentation.
 `DA-SESSION-STARTED` marks completion.
 
+## DA-CONTENT-END-INFERRED
+
+**Cause:** Informational. The SDK inferred VOD content end from the playhead
+to arm a pending post-roll when the player did not fire `ended`. Inference requires
+an adapter reporting VOD (`isLive: false`); unknown live status, including native
+video web adapters that omit it, relies on the real `ended` event. Context carries
+`currentTime`, `duration` and `trigger`: `past-end` means within 0.25 seconds (0.05 seconds while paused) of
+duration or beyond it; `stalled-at-end` means no meaningful progress for two
+seconds within the final second while not paused. **Fix:** No action needed if
+content has ended. Otherwise verify the adapter's `duration`, `currentTime` and
+`isLive` values. A later `ended` does not trigger another post-roll. A pending
+post-roll is cancelled only after a backward replay beyond one second from the
+recorded end position, or on playback start when that position is unknown.
+
 ## DA-SESSION-ENDED
 
 Informational. Polling and scheduling stopped (via `endSession()`/`destroy()`).
@@ -121,6 +151,41 @@ nothing (or the unchanged request) when no modification is needed. Use a
 `ManifestMockResponse` (raw body) to short-circuit the network for tests. See the
 `interceptManifestRequest` configuration docs.
 
+## DA-MANIFEST-URL-DISCOVERED
+
+**Cause:** Informational — `startSession()` was called without a `manifestUrl`
+and the SDK started the session on the ads manifest URL the content player
+discovered (`context.source: 'player-discovery'`; `context.manifestUrl` is the
+URL verbatim). Typical source: THEOlive discovery via the THEOplayer adapter.
+**Fix:** No action needed; verify the reported URL is the ads manifest you
+expect for the loaded channel.
+
+## DA-MANIFEST-URL-UNAVAILABLE
+
+**Cause:** `startSession()` was called without a `manifestUrl` and no ads
+manifest URL could be used, so no session started. `context.reason` names the
+cause: `disabled` — the `manifestUrlDiscovery` config flag is off;
+`unsupported-adapter` — the player adapter does not expose manifest
+discovery; `no-ads` — the player's discovery completed but reported no ads
+manifest URL; `timeout` — discovery stayed pending past the wait window.
+**Fix:** For `disabled`, set `manifestUrlDiscovery: true` or pass `manifestUrl`
+explicitly. For `unsupported-adapter`, pass `manifestUrl` explicitly or use an
+adapter/player combination that discovers one (e.g. THEOplayer with a THEOlive
+source). For `no-ads`, check the channel's upstream ads configuration. For
+`timeout`, retry once the source has loaded or pass `manifestUrl` explicitly.
+
+## DA-SLATE-INVALID
+
+**Cause:** The manifest's `slate` was ignored because it is unusable, and its
+breaks play without one; the breaks themselves are unaffected. `context.reason`
+says why: `not-object` (the slate must be an object), `invalid-min-duration`
+(`minDuration` must be a number >= 0), `no-assets` (`assets` must be a non-empty
+array) or `invalid-asset` (the FIRST asset, the only one the player uses, must be
+a `static` video or image with an `id`, a `mediaType` and a `uri`; `context.assetId`
+names it). **Fix:** Correct the slate in the manifest. A slate asset carries no
+`duration`: the slate fills whatever the ads left of the break. Reported once per
+distinct fault, not once per poll. Non-fatal.
+
 ## DA-PDT-MISSING
 
 **Cause:** The stream exposed no `EXT-X-PROGRAM-DATE-TIME` once content was
@@ -701,6 +766,56 @@ or single-decoder prefetch limits. **Fix:** Verify the ad asset URL is reachable
 with correct CORS. On older single-decoder TVs confirm `adPreload: 'single-decoder'`
 or `'auto'`. Non-fatal — playback still proceeds.
 
+## DA-SLATE-PRELOADED
+
+**Cause:** Informational. The manifest's slate asset was fetched ahead of its first use,
+on its first appearance in the manifest or when its URL changed, so a break that needs it
+starts it warm. `context` carries `slateAssetId`, `mediaType` and the preload `path`
+taken. **Fix:** None. Best-effort: a failed warm-up never fails a break, and
+`adPreload: 'none'` skips it.
+
+## DA-SLATE-STARTED
+
+**Cause:** Informational. The slate began because no ad covered the rest of the break.
+`context.reason` is `ads-ended` (the last ad ended before the break end; `adsPlayedSec`
+of `effectiveDurationSec`) or `no-ad` (nothing could play). `durationSec` is the real time
+left to the break's scheduled end, so time lost to an ad that never played or to ad start-up
+shortens it. The slate plays until the scheduled end and then the break ends as any other; it
+emits no `adbegin`/`adend`, so ad counts and ad analytics are unaffected. **Fix:** None.
+If you expected a slate and see none, look for `DA-SLATE-NOT-STARTED` or
+`DA-SLATE-INVALID`.
+
+## DA-SLATE-NOT-STARTED
+
+**Cause:** Informational. The manifest has a slate and part of the break was uncovered,
+but the slate did not start. `below-min-duration`: less than the slate's `minDuration`
+(default 5 seconds) remained (`context.remainingSec`), so the break returned to content
+as it always did. `not-rendered`: the stitched stream fills the break (a time-based
+break under `ssai` delivery, or while an SSB stream plays), so a client slate would
+cover real content. **Fix:** To fill shorter gaps lower `minDuration` in the manifest
+(`0` starts the slate for any remaining time).
+
+## DA-SLATE-ENDED
+
+**Cause:** Informational. The slate stopped. `plannedSec` is the real time that was left to
+the break's scheduled end when the slate started; `filledSec` is how long it was on screen.
+`breakOverrunSec` is the slate's end minus the scheduled end: about 0 with `reason:
+break-end` means the break ended on schedule, negative with `skipped`, `removed` or
+`resumed` means it was ended early on purpose. `interruptedSec` is time the slate was not
+presenting (start-up, stalls, loop seams, app in the background); it shortens the slate
+and never moves the break end. `loops` is how many times a video slate completed.
+**Fix:** None. A very short slate asset loops often: prefer one a few seconds long or
+longer.
+
+## DA-SLATE-FAILED
+
+**Cause:** The slate could not load or play, so the break ended as it would without a
+slate (the viewer returns to content early) and a public `aderror` carrying the slate
+asset was emitted. `context.reason` is `load` (the player rejected the asset) or
+`stalled` (it did not present within the ad-start budget). **Fix:** Check the slate URL
+and CORS, and that an HLS or DASH slate is an on-demand presentation (`EXT-X-ENDLIST`, or
+an MPD of `type="static"`). A slate failure never fails the break itself.
+
 ## DA-PRELOAD-MODE-RESOLVED
 
 **Cause:** Informational, emitted once at construction. States the ad preload
@@ -754,10 +869,54 @@ for AirPlay while a break was active (`context.reason: break-active`) or within
 `externalPlayback.blockBeforeBreakSec` seconds of the next one
 (`break-imminent`). `context` also carries `breakId`, `secondsUntilBreak` and
 `trigger`.
-**Fix:** None needed; the video stays on the device and the SDK retries when
+**Fix:** None needed; the content video stays on the device (on iOS the running
+ad plays on the receiver instead) and the SDK retries when
 the break ends if the route is still on AirPlay. Shorten the window with
 `externalPlayback.blockBeforeBreakSec` (`0` blocks only during a break).
 
+## DA-AD-ROUTE-CHANGED
+
+**Cause:** iOS only. The audio route changed while an ad break played (an
+AirPlay or Bluetooth output appeared or went away). `context` carries `reason`,
+`outputs`, `previousOutputs` and the ad player snapshot.
+**Fix:** None needed; diagnostic. Read it next to `DA-AD-TIMECONTROL` and
+`DA-AD-AUDIO-INTERRUPTION` to explain an ad stall right after a route change.
+
+## DA-AD-TIMECONTROL
+
+**Cause:** iOS only. The ad player's `timeControlStatus` or
+`reasonForWaitingToPlay` changed during a break (`context.field` names which).
+**Fix:** None needed; diagnostic. A pause with no viewer action points at an
+audio-session interruption (`DA-AD-AUDIO-INTERRUPTION`).
+
+## DA-AD-ITEM-STALLED
+
+**Cause:** iOS only. The ad item reported a playback stall during a break.
+**Fix:** Check `context` buffer flags and outputs; a stall right after a route
+change means the app audio moved to an audio-only AirPlay route.
+
+## DA-AD-AUDIO-INTERRUPTION
+
+**Cause:** iOS only. An audio-session interruption began or ended during a
+break (a call, or another app taking audio focus). `context.type` is `began` or
+`ended`.
+**Fix:** None needed while an ad is meant to play: the SDK reactivates the
+session and restarts it (`DA-AD-INTERRUPTION-RESUMED`).
+
+## DA-AD-INTERRUPTION-RESUMED
+
+**Cause:** iOS only. An ad paused by an audio-session interruption was
+restarted. `context.trigger` is `interruption-ended`, `route-changed`,
+`player-paused` or `retry`; `stalledSec` is how long it was stopped.
+**Fix:** None needed; informational. The break cut deadline is not extended.
+
+## DA-AD-AUDIO-SESSION-REACTIVATE-FAILED
+
+**Cause:** iOS only. Reactivating the audio session before restarting an
+interrupted ad failed (`context.errorCode`, `errorDomain`).
+**Fix:** The SDK retries once a second, up to five times; if it keeps failing,
+another app or call still holds the audio session.
+
 ## DA-EXTERNAL-PLAYBACK-ALLOWED
 
 **Cause:** An AirPlay request passed the ad-break guard. `context.trigger` is
@@ -913,6 +1072,17 @@ SDK version too. Skipping is deliberate: an earlier SDK coerced an unrecognised
 format to `single`, which rendered a future format as a full-screen content
 takeover — the most invasive possible reading of a value it did not understand.
 
+## DA-BREAK-LSHAPE-ANCHOR-UNKNOWN
+
+**Cause:** An `lshape_ad` or `lshape_content` variant declared an `anchor` string
+this SDK version does not recognise. `context.anchor` is the raw manifest value.
+The break **still played**, with the video box in the default `top_left` corner:
+the manifest spec (1.11.0) says an unknown anchor must not drop the break. Raised
+once per break begin on the selected variant. **Fix:** Check the value against the
+spec enum (`top_left`, `top_right`, `bottom_left`, `bottom_right`); the usual
+cause is a typo or a casing mistake such as `TOP_RIGHT`. A corner newer than the
+SDK build looks identical here, so compare the SDK version too.
+
 ## DA-BREAK-FORMAT-DEGRADED
 
 **Cause:** A split break format (`double`, `lshape_ad`, `lshape_content`) has to
@@ -1196,11 +1366,31 @@ flip, and defers the exit hand-back past the close morph. `reachedEnd: true` fol
 is a forced break cut and intentionally keeps the ad on the layer until break end.
 Non-fatal.
 
+## DA-IMAGE-ANIMATED
+
+**Cause:** An animated image (GIF or animated WebP) used as a `double`/`lshape_ad`
+companion, an `lshape_content` backdrop, an image ad or a pause image started animating.
+Only the Android and iOS/tvOS renderers emit it, because browsers animate the image element
+themselves. `context.surface` is `companion`, `backdrop`, `image-ad` or `pause`, `context.uri`
+the image, and
+`context.frameCount` the frame count (iOS/tvOS; null on Android). **Fix:** None — it
+confirms the animation path ran. If the creative still looks frozen, check that the file
+really has more than one frame and a loop count other than 1. Debug.
+
+## DA-IMAGE-ANIMATION-UNSUPPORTED
+
+**Cause:** The image is animated but this device cannot animate it, so the first frame is
+shown and the break continues. `context.reason` is `api-below-28` on Android below API 28
+(no animated image decoder) or `canvas-too-large` on iOS/tvOS when the animation canvas is
+above the decode budget. **Fix:** Serve an animation of 1080p or less, or a still image for
+these devices. Non-fatal.
+
 ## DA-IMAGE-LOAD-FAILED
 
 **Cause:** An image the renderer needed — a `double`/`lshape_ad` companion, an
 `lshape_content` backdrop, or an image ad — could not be fetched or decoded within the
-timeout, so the break continued without it. `context.uri` is the URL that failed. **Fix:**
+timeout, or was larger than the 8 MB size limit (`context.error` is `too-large`), so the
+break continued without it. `context.uri` is the URL that failed. **Fix:**
 Check the URL is reachable from the device with correct CORS headers. The case the timeout
 exists for is a socket that CONNECTS and then goes quiet: `HttpURLConnection` defaults both
 its connect and read timeouts to infinite, so before this such a fetch could hang an entire
@@ -1648,6 +1838,14 @@ resume policy has no effect. **Fix:** Remove `adInsertionType` for SSAI sessions
 or switch to SGAI (`mode: 'sgai'`) if you need client-controlled DAR/DAI resume
 behaviour.
 
+## DA-PAUSE-AD-ROTATION-EXHAUSTED
+
+**Cause:** Informational. No unused pause breaks remain at or beyond the
+session's rotation position, so this pause shows no ad. Ordinary manifest
+updates preserve that position, including shorter or empty lists.
+**Fix:** No action needed; content can resume normally. To extend the rotation,
+append pause breaks beyond the consumed positions instead of repeating them.
+
 ## DA-PAUSE-AD-SHOWN
 
 **Cause:** Informational. A pause ad (full-screen image or video) was shown while

package/ai/reference/playeradapter.contract.md

@@ -16,6 +16,8 @@ and creates the matching native adapter. See `react-native-overview.md`.
 
 ## Events
 
+For VOD snapback, prefer the SDK's `seek()` entry point: it plans the correction before moving the player. External content seeks use `seeked`, or position jumps greater than two seconds when a host has no direct notification (AVPlayer host controls). Corrective seeks must land at the break start: Media3 uses exact seek parameters and AVPlayer uses zero tolerances. SDK corrections are suppressed as new viewer intent. Only playable mediatime-scheduled client-side VOD breaks participate; TV web, live, PTS/wallclock, event-triggered, SSAI and SSB are excluded. After seek-over, content-pausing Single and L-Shape Ad return to the requested target, overriding insertion policy and `resumeOffset` and bypassing chaining. Double Box, L-Shape Content and Overlay play on without a seek; normal chaining applies. Fullscreen fallbacks at break start count as Single. Seek-into uses normal resume policy.
+
 `PlayerAdapterEvent` is exactly these seven strings. An adapter MUST forward all
 of them to handlers registered via `on()`:
 

package/dist/RoutingAdAdapter.d.ts

@@ -33,6 +33,8 @@ export declare class RoutingAdAdapter implements PlayerAdapter, AdSourceQueue {
     private segmentEnd;
     private stopBoundaryWatch;
     private boundaryCrossed;
+    /** The hls.js engine came from a queued ad: it is configured for that hand-over only. */
+    private engineFromQueue;
     constructor(video: HTMLVideoElement, hlsSupported?: boolean);
     get currentTime(): number;
     get duration(): number;

package/dist/RoutingAdAdapter.js

@@ -1 +1 @@
-import e from"hls.js";import{HlsJsAdapter as t}from"@dolby-optiview/ads-sdk-adapter-hlsjs";import{HlsAdQueue as s}from"./HlsAdQueue";import{NativeVideoAdapter as i}from"./NativeVideoAdapter";import{selectAdTech as r}from"./selectAdTech";export class RoutingAdAdapter{constructor(t,s=e.isSupported()){this.inner=null,this.currentTech=null,this.ownedSrc=null,this.hls=null,this.eventListeners=new Map,this.queue=null,this.orphan=null,this.segmentStart=0,this.segmentEnd=null,this.stopBoundaryWatch=null,this.boundaryCrossed=!1,this.video=t,this.hlsSupported=s}get currentTime(){const e=this.inner?this.inner.currentTime:this.video.currentTime;return Math.max(0,e-this.segmentStart)}get duration(){return null!==this.segmentEnd?this.segmentEnd-this.segmentStart:(this.inner?this.inner.duration:this.video.duration)-this.segmentStart}get paused(){return this.inner?this.inner.paused:this.video.paused}get muted(){return this.video.muted}set muted(e){this.video.muted=e}get volume(){return this.video.volume}set volume(e){this.video.volume=e}get programDateTime(){return this.inner?this.inner.programDateTime:null}get videoElement(){return this.video}get supportsParallelBuffering(){return this.inner?.supportsParallelBuffering??this.hlsSupported}pause(){this.inner?this.inner.pause():this.video.pause()}async play(){if(this.inner)return this.inner.play();await this.video.play()}seek(e){this.inner?this.inner.seek(e+this.segmentStart):this.video.currentTime=e+this.segmentStart}load(e){this.resetQueue();const t=r(e),s=t=>{const s=this.ensureInner(t).load(e);return this.ownedSrc=this.video.getAttribute("src"),s};return"string"==typeof t?s(t):t.then(s)}preload(e){const t=r(e),s=t=>{if(this.inner&&this.currentTech!==(this.hlsSupported?t:"native"))return Promise.resolve();const s=this.ensureInner(t);return s.preload?s.preload(e):Promise.resolve()};return"string"==typeof t?s(t):t.then(s)}async queueNext(e,t){this.disposeQueue();const i=this.hls;if(!i||"hls"!==this.currentTech||i.media!==this.video)return!1;if("function"!=typeof i.transferMedia)return!1;const n=r(e);if("hls"!==("string"==typeof n?n:await n)||this.hls!==i||this.queue)return!1;const h=i.latestLevelDetails?.totalduration;if("number"!=typeof h||!Number.isFinite(h)||h<=0)return!1;const o=new s({url:e,video:this.video,current:i,boundary:this.segmentStart+h});this.queue=o;const u=this.segmentEnd;this.segmentEnd=o.boundary;const d=await o.start();return this.queue===o&&(d?(o.setOnFatal(()=>{this.queue===o&&(this.queue=null,this.dropTransferred(o),t())}),this.watchBoundary(o.boundary,"ended"),!0):(this.disposeQueue(),o.transferred||(this.segmentEnd=u),!1))}takeQueued(e){const s=this.queue;if(!s||s.url!==e||!s.transferred||this.video.ended||!s.isPlayable())return this.disposeQueue(),!1;this.queue=null;const i=this.boundaryCrossed;this.stopWatch(),!i&&this.video.currentTime<s.boundary&&(this.video.currentTime=s.boundary),this.inner?.destroy(),this.hls?.destroy(),this.hls=s.next,this.inner=new t(s.next,this.video);for(const[e,t]of this.eventListeners)for(const s of t)this.inner.on(e,s);return this.segmentStart=s.boundary,this.segmentEnd=s.boundary+s.duration,i?queueMicrotask(()=>this.emit("playing")):this.watchBoundary(s.boundary,"playing"),!0}clearQueued(){this.disposeQueue()}on(e,t){let s=this.eventListeners.get(e);s||(s=new Set,this.eventListeners.set(e,s)),s.add(t),this.inner?.on(e,t)}off(e,t){this.eventListeners.get(e)?.delete(t),this.inner?.off(e,t)}unload(){this.resetQueue(),this.teardownInner()}releaseMediaElement(){if(this.resetQueue(),this.inner){if(this.inner.destroy(),this.hls){try{this.hls.stopLoad()}catch{}this.video.getAttribute("src")===this.ownedSrc&&this.video.removeAttribute("src");for(const e of Array.from(this.video.querySelectorAll("source")))e.remove();try{this.hls.destroy()}catch{}this.hls=null}this.ownedSrc=null,this.inner=null,this.currentTech=null}}destroy(){this.resetQueue(),this.teardownInner(),this.eventListeners.clear()}resetQueue(){const e=this.queue;this.queue=null,this.stopWatch(),e?.destroy(),this.orphan?.destroy(),this.orphan=null,this.segmentStart=0,this.segmentEnd=null,this.boundaryCrossed=!1}disposeQueue(){const e=this.queue;this.queue=null,this.stopWatch(),e&&(e.transferred?this.dropTransferred(e):e.destroy())}dropTransferred(e){this.stopWatch(),e.drop(),this.orphan?.destroy(),this.orphan=e}watchBoundary(e,t){this.stopWatch(),this.boundaryCrossed=!1;const s=this.video;let i=null;const r=()=>{s.removeEventListener("timeupdate",h),null!==i&&s.cancelVideoFrameCallback?.(i)},n=()=>{this.stopBoundaryWatch===r&&(this.stopWatch(),this.boundaryCrossed=!0,this.emit(t))},h=()=>{s.currentTime>=e&&n()},o=(t,h)=>{h.mediaTime>=e?n():this.stopBoundaryWatch===r&&(i=s.requestVideoFrameCallback?.(o)??null)};this.stopBoundaryWatch=r,s.addEventListener("timeupdate",h),i=s.requestVideoFrameCallback?.(o)??null}stopWatch(){const e=this.stopBoundaryWatch;this.stopBoundaryWatch=null,e?.()}emit(e){for(const t of this.eventListeners.get(e)??[])t()}ensureInner(e){const t=this.hlsSupported?e:"native";if(this.inner&&this.currentTech===t)return this.inner;this.teardownInner(),this.inner=this.buildInner(t),this.currentTech=t;for(const[e,t]of this.eventListeners)for(const s of t)this.inner.on(e,s);return this.inner}buildInner(s){return"native"===s?new i(this.video):(this.hls=new e,new t(this.hls,this.video))}teardownInner(){if(this.inner?.destroy(),this.hls){const e=this.video.getAttribute("src");if(e&&e!==this.ownedSrc)for(const e of Array.from(this.video.querySelectorAll("source")))e.remove();try{this.hls.destroy()}catch{}this.hls=null}const e=this.video.getAttribute("src");e&&e!==this.ownedSrc||(this.video.removeAttribute("src"),"native"!==this.currentTech||null===this.ownedSrc||this.video.srcObject||this.video.load()),this.ownedSrc=null,this.inner=null,this.currentTech=null}}
+import e from"hls.js";import{HlsJsAdapter as t}from"@dolby-optiview/ads-sdk-adapter-hlsjs";import{HlsAdQueue as s}from"./HlsAdQueue";import{NativeVideoAdapter as i}from"./NativeVideoAdapter";import{selectAdTech as r}from"./selectAdTech";export class RoutingAdAdapter{constructor(t,s=e.isSupported()){this.inner=null,this.currentTech=null,this.ownedSrc=null,this.hls=null,this.eventListeners=new Map,this.queue=null,this.orphan=null,this.segmentStart=0,this.segmentEnd=null,this.stopBoundaryWatch=null,this.boundaryCrossed=!1,this.engineFromQueue=!1,this.video=t,this.hlsSupported=s}get currentTime(){const e=this.inner?this.inner.currentTime:this.video.currentTime;return Math.max(0,e-this.segmentStart)}get duration(){return null!==this.segmentEnd?this.segmentEnd-this.segmentStart:(this.inner?this.inner.duration:this.video.duration)-this.segmentStart}get paused(){return this.inner?this.inner.paused:this.video.paused}get muted(){return this.video.muted}set muted(e){this.video.muted=e}get volume(){return this.video.volume}set volume(e){this.video.volume=e}get programDateTime(){return this.inner?this.inner.programDateTime:null}get videoElement(){return this.video}get supportsParallelBuffering(){return this.inner?.supportsParallelBuffering??this.hlsSupported}pause(){this.inner?this.inner.pause():this.video.pause()}async play(){if(this.inner)return this.inner.play();await this.video.play()}seek(e){this.inner?this.inner.seek(e+this.segmentStart):this.video.currentTime=e+this.segmentStart}load(e){this.resetQueue(),this.engineFromQueue&&this.teardownInner();const t=r(e),s=t=>{const s=this.ensureInner(t).load(e);return this.ownedSrc=this.video.getAttribute("src"),s};return"string"==typeof t?s(t):t.then(s)}preload(e){const t=r(e),s=t=>{if(this.inner&&this.currentTech!==(this.hlsSupported?t:"native"))return Promise.resolve();const s=this.ensureInner(t);return s.preload?s.preload(e):Promise.resolve()};return"string"==typeof t?s(t):t.then(s)}async queueNext(e,t){this.disposeQueue();const i=this.hls;if(!i||"hls"!==this.currentTech||i.media!==this.video)return!1;if("function"!=typeof i.transferMedia)return!1;const n=r(e);if("hls"!==("string"==typeof n?n:await n)||this.hls!==i||this.queue)return!1;const h=i.latestLevelDetails?.totalduration;if("number"!=typeof h||!Number.isFinite(h)||h<=0)return!1;const o=new s({url:e,video:this.video,current:i,boundary:this.segmentStart+h});this.queue=o;const u=this.segmentEnd;this.segmentEnd=o.boundary;const d=await o.start();return this.queue===o&&(d?(o.setOnFatal(()=>{this.queue===o&&(this.queue=null,this.dropTransferred(o),t())}),this.watchBoundary(o.boundary,"ended"),!0):(this.disposeQueue(),o.transferred||(this.segmentEnd=u),!1))}takeQueued(e){const s=this.queue;if(!s||s.url!==e||!s.transferred||this.video.ended||!s.isPlayable())return this.disposeQueue(),!1;this.queue=null;const i=this.boundaryCrossed;this.stopWatch(),!i&&this.video.currentTime<s.boundary&&(this.video.currentTime=s.boundary),this.inner?.destroy(),this.hls?.destroy(),this.hls=s.next,this.inner=new t(s.next,this.video),this.engineFromQueue=!0;for(const[e,t]of this.eventListeners)for(const s of t)this.inner.on(e,s);return this.segmentStart=s.boundary,this.segmentEnd=s.boundary+s.duration,i?queueMicrotask(()=>this.emit("playing")):this.watchBoundary(s.boundary,"playing"),!0}clearQueued(){this.disposeQueue()}on(e,t){let s=this.eventListeners.get(e);s||(s=new Set,this.eventListeners.set(e,s)),s.add(t),this.inner?.on(e,t)}off(e,t){this.eventListeners.get(e)?.delete(t),this.inner?.off(e,t)}unload(){this.resetQueue(),this.teardownInner()}releaseMediaElement(){if(this.resetQueue(),this.inner){if(this.inner.destroy(),this.hls){try{this.hls.stopLoad()}catch{}this.video.getAttribute("src")===this.ownedSrc&&this.video.removeAttribute("src");for(const e of Array.from(this.video.querySelectorAll("source")))e.remove();try{this.hls.destroy()}catch{}this.hls=null}this.ownedSrc=null,this.inner=null,this.currentTech=null,this.engineFromQueue=!1}}destroy(){this.resetQueue(),this.teardownInner(),this.eventListeners.clear()}resetQueue(){const e=this.queue;this.queue=null,this.stopWatch(),e?.destroy(),this.orphan?.destroy(),this.orphan=null,this.segmentStart=0,this.segmentEnd=null,this.boundaryCrossed=!1}disposeQueue(){const e=this.queue;this.queue=null,this.stopWatch(),e&&(e.transferred?this.dropTransferred(e):e.destroy())}dropTransferred(e){this.stopWatch(),e.drop(),this.orphan?.destroy(),this.orphan=e}watchBoundary(e,t){this.stopWatch(),this.boundaryCrossed=!1;const s=this.video;let i=null;const r=()=>{s.removeEventListener("timeupdate",h),null!==i&&s.cancelVideoFrameCallback?.(i)},n=()=>{this.stopBoundaryWatch===r&&(this.stopWatch(),this.boundaryCrossed=!0,this.emit(t))},h=()=>{s.currentTime>=e&&n()},o=(t,h)=>{h.mediaTime>=e?n():this.stopBoundaryWatch===r&&(i=s.requestVideoFrameCallback?.(o)??null)};this.stopBoundaryWatch=r,s.addEventListener("timeupdate",h),i=s.requestVideoFrameCallback?.(o)??null}stopWatch(){const e=this.stopBoundaryWatch;this.stopBoundaryWatch=null,e?.()}emit(e){for(const t of this.eventListeners.get(e)??[])t()}ensureInner(e){const t=this.hlsSupported?e:"native";if(this.inner&&this.currentTech===t)return this.inner;this.teardownInner(),this.inner=this.buildInner(t),this.currentTech=t;for(const[e,t]of this.eventListeners)for(const s of t)this.inner.on(e,s);return this.inner}buildInner(s){return"native"===s?new i(this.video):(this.hls=new e,new t(this.hls,this.video))}teardownInner(){if(this.inner?.destroy(),this.hls){const e=this.video.getAttribute("src");if(e&&e!==this.ownedSrc)for(const e of Array.from(this.video.querySelectorAll("source")))e.remove();try{this.hls.destroy()}catch{}this.hls=null}const e=this.video.getAttribute("src");e&&e!==this.ownedSrc||(this.video.removeAttribute("src"),"native"!==this.currentTech||null===this.ownedSrc||this.video.srcObject||this.video.load()),this.ownedSrc=null,this.inner=null,this.currentTech=null,this.engineFromQueue=!1}}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dolby-optiview/ads-sdk",
-  "version": "1.4.0",
+  "version": "1.6.0",
   "description": "OptiView Ads SDK entry package - OptiViewAds with a default HLS.js ad player (native fallback)",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -44,8 +44,8 @@
   },
   "sideEffects": false,
   "dependencies": {
-    "@dolby-optiview/ads-sdk-adapter-hlsjs": "^1.4.0",
-    "@dolby-optiview/ads-sdk-core": "^1.4.0"
+    "@dolby-optiview/ads-sdk-adapter-hlsjs": "^1.6.0",
+    "@dolby-optiview/ads-sdk-core": "^1.6.0"
   },
   "peerDependencies": {
     "hls.js": "^1.0.0"