@dolby-optiview/ads-sdk-core 1.0.0-beta.1

package/dist/generated/diagnosticCodes.d.ts

@@ -0,0 +1,487 @@
+/**
+ * The full catalog of known diagnostic codes, keyed by the stable code string.
+ * `as const` keeps the keys narrow so callers get compile-time checking via
+ * {@link KnownDiagnosticCode}.
+ */
+export declare const DIAGNOSTIC_CODES: {
+    readonly "DA-SESSION-STARTED": {
+        readonly category: "session";
+        readonly level: "info";
+        readonly summary: "Monetization session started; manifest polling began. context: manifestUrl (stitcherUrl in SSAI mode), reported verbatim.";
+    };
+    readonly "DA-SESSION-ENDED": {
+        readonly category: "session";
+        readonly level: "info";
+        readonly summary: "Monetization session ended; polling and scheduling stopped.";
+    };
+    readonly "DA-ASSET-PARAMETERS-UPDATED": {
+        readonly category: "session";
+        readonly level: "info";
+        readonly summary: "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).";
+    };
+    readonly "DA-MANIFEST-FETCH-FAILED": {
+        readonly category: "manifest";
+        readonly level: "error";
+        readonly summary: "Initial break-manifest fetch failed; the session could not start.";
+    };
+    readonly "DA-MANIFEST-POLL-FAILED": {
+        readonly category: "manifest";
+        readonly level: "warn";
+        readonly summary: "A manifest poll failed; the SDK keeps the last good manifest and retries.";
+    };
+    readonly "DA-MANIFEST-CHANNEL-CHANGED": {
+        readonly category: "manifest";
+        readonly level: "info";
+        readonly summary: "A polled manifest describes a different ads channel (channelId, GAM identity or timebase changed); the SDK re-aligned its ad setup and resolved delivery mode again while the session and content playback continued. context: previousChannelId, channelId, reason, manifestUrl.";
+    };
+    readonly "DA-MANIFEST-INTERCEPT-FAILED": {
+        readonly category: "manifest";
+        readonly level: "warn";
+        readonly summary: "The customer manifest-response interceptor threw; the un-modified parsed manifest was used instead.";
+    };
+    readonly "DA-MANIFEST-REQUEST-INTERCEPT-FAILED": {
+        readonly category: "manifest";
+        readonly level: "warn";
+        readonly summary: "The customer manifest-request interceptor threw; the normal network fetch of the original URL was used instead.";
+    };
+    readonly "DA-MANIFEST-SIGNATURE-INVALID": {
+        readonly category: "manifest";
+        readonly level: "error";
+        readonly summary: "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.";
+    };
+    readonly "DA-PDT-MISSING": {
+        readonly category: "playback";
+        readonly level: "warn";
+        readonly summary: "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.";
+    };
+    readonly "DA-ANVATO-CUE-PENDING": {
+        readonly category: "break";
+        readonly level: "info";
+        readonly summary: "ptsSource: 'anvatoCue' — no Anvato in-stream cue observed yet for a PTS break; the break stays pending until its cue arrives.";
+    };
+    readonly "DA-ANVATO-CUE-MATCHED": {
+        readonly category: "break";
+        readonly level: "info";
+        readonly summary: "ptsSource: 'anvatoCue' — a PTS break's start was matched to an observed Anvato cue and scheduled at the cue's media time.";
+    };
+    readonly "DA-ANVATO-CUE-ENTERED": {
+        readonly category: "break";
+        readonly level: "info";
+        readonly summary: "ptsSource: 'anvatoCue' — a break was started by the cue reaching the playhead rather than by the scheduler's 250ms tick; context carries the breakId, the cue pts and the media time it fired at, so the two start paths are distinguishable in the field.";
+    };
+    readonly "DA-ANVATO-CUE-OBSERVED": {
+        readonly category: "break";
+        readonly level: "info";
+        readonly summary: "ptsSource: 'anvatoCue' — an Anvato break-signaling (type=cue) frame was observed in the stream; context carries the cue's pts, the media time it landed at, whether the tracker recorded it, and the raw payload — so a manifest-PTS vs in-stream-PTS misalignment is observable in the field.";
+    };
+    readonly "DA-PRELOAD-FAILED": {
+        readonly category: "preload";
+        readonly level: "warn";
+        readonly summary: "Ad preload failed; the asset will be loaded on demand at break start.";
+    };
+    readonly "DA-PRELOAD-MODE-RESOLVED": {
+        readonly category: "preload";
+        readonly level: "info";
+        readonly summary: "The configured ad preload mode was resolved for this session; context carries both the configured and the resolved mode.";
+    };
+    readonly "DA-PRELOAD-PATH": {
+        readonly category: "preload";
+        readonly level: "info";
+        readonly summary: "The preload path actually taken for a break's ad (parallel buffer / detached prefetch / none) and the creative container (stream vs progressive).";
+    };
+    readonly "DA-BREAK-EARLY-RETURN": {
+        readonly category: "break";
+        readonly level: "info";
+        readonly summary: "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.";
+    };
+    readonly "DA-BREAK-WINDOW-ESCAPED": {
+        readonly category: "break";
+        readonly level: "warn";
+        readonly summary: "An active wallclock break outlived its window on the stream clock (ad stall, bogus trigger position, or a re-fired completed break); the SDK ended it and returned to content. context.overrunSec says by how much.";
+    };
+    readonly "DA-BREAK-EVENT-UNSUPPORTED": {
+        readonly category: "break";
+        readonly level: "warn";
+        readonly summary: "A break is triggered by a spec event this SDK version does not schedule on this platform (web schedules `start`, `pause` and `end`; Android and iOS do not schedule `end` yet); the break was ignored. context.event names the event.";
+    };
+    readonly "DA-BREAK-SUPPRESSED-OVERLAP": {
+        readonly category: "break";
+        readonly level: "warn";
+        readonly summary: "A break was suppressed because an ad was already playing.";
+    };
+    readonly "DA-BREAK-TRANSITION": {
+        readonly category: "break";
+        readonly level: "info";
+        readonly summary: "Measured duration of a playback transition into an ad break, between two ads, between chained breaks, or back to content.";
+    };
+    readonly "DA-AD-SURFACE-REVEALED": {
+        readonly category: "break";
+        readonly level: "info";
+        readonly summary: "The ad surface became visible: how long it was held back waiting for the ad's first frame, and whether it was revealed because that frame arrived or because the wait timed out.";
+    };
+    readonly "DA-PREROLL-CONTENT-HELD": {
+        readonly category: "break";
+        readonly level: "info";
+        readonly summary: "Content playback was held at session start until a pending pre-roll began, so no content is shown before the ad.";
+    };
+    readonly "DA-SHARED-ELEMENT-UNSUPPORTED": {
+        readonly category: "break";
+        readonly level: "warn";
+        readonly summary: "Configured shared-element insertion is unsupported on this platform (non-iPhone/iPod); fell back to overlay insertion.";
+    };
+    readonly "DA-SHARED-ELEMENT-RESTORE-FAILED": {
+        readonly category: "playback";
+        readonly level: "error";
+        readonly summary: "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.";
+    };
+    readonly "DA-IMAGE-LOAD-FAILED": {
+        readonly category: "break";
+        readonly level: "warn";
+        readonly summary: "An image (companion, backdrop or image ad) could not be fetched or decoded within the timeout; the break continues without it.";
+    };
+    readonly "DA-PIP-TRANSFER-FAILED": {
+        readonly category: "break";
+        readonly level: "warn";
+        readonly summary: "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.";
+    };
+    readonly "DA-PIP-AUTODETECT-UNAVAILABLE": {
+        readonly category: "break";
+        readonly level: "warn";
+        readonly summary: "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.";
+    };
+    readonly "DA-CONTENT-ELEMENT-SWAPPED": {
+        readonly category: "break";
+        readonly level: "info";
+        readonly summary: "The content player replaced its <video> element; the SDK re-bound its presentation listeners to the new one.";
+    };
+    readonly "DA-PIP-FORMAT-OVERRIDE": {
+        readonly category: "break";
+        readonly level: "info";
+        readonly summary: "The content player is in picture-in-picture, so the break's declared format was overruled and it plays as a single fullscreen ad.";
+    };
+    readonly "DA-CHAIN-RESOLVER-ERROR": {
+        readonly category: "chaining";
+        readonly level: "warn";
+        readonly summary: "The chained-successor resolver threw; chaining was skipped for this break.";
+    };
+    readonly "DA-GAM-NO-ASSET-KEY": {
+        readonly category: "gam";
+        readonly level: "warn";
+        readonly summary: "Retired: the GAM stream identity now comes from the manifest's vendorConfiguration. Kept declared so the code is never reused; see DA-GAM-CONFIG-MISSING.";
+    };
+    readonly "DA-GAM-SESSION-FAILED": {
+        readonly category: "gam";
+        readonly level: "error";
+        readonly summary: "The GAM/IMA session failed to initialize; GAM breaks will not serve.";
+    };
+    readonly "DA-GAM-CONFIG-RESOLVED": {
+        readonly category: "gam";
+        readonly level: "info";
+        readonly summary: "The GAM stream identity for this session was resolved from the manifest's vendorConfiguration.";
+    };
+    readonly "DA-GAM-CONFIG-MISSING": {
+        readonly category: "gam";
+        readonly level: "error";
+        readonly summary: "The break manifest carries no usable \"gam\" vendorConfiguration entry; GAM assets are skipped.";
+    };
+    readonly "DA-GAM-POD-IDENTITY-MISMATCH": {
+        readonly category: "gam";
+        readonly level: "error";
+        readonly summary: "A GAM pod asset's vendorParameters name a different network code or custom asset key than the stream session was created with; the asset is skipped because the pod request cannot serve.";
+    };
+    readonly "DA-VENDOR-CONFIG-UNKNOWN-TYPE": {
+        readonly category: "manifest";
+        readonly level: "info";
+        readonly summary: "One or more vendorConfiguration entries declare a type this SDK version does not recognise and were ignored.";
+    };
+    readonly "DA-CONTENT-PLAYBACK-ERROR": {
+        readonly category: "playback";
+        readonly level: "error";
+        readonly summary: "The content player reported a playback error.";
+    };
+    readonly "DA-CONTENT-RESUME-STALLED": {
+        readonly category: "playback";
+        readonly level: "warn";
+        readonly summary: "Content did not resume within the watchdog window after a break that paused it ended; the SDK re-issued play() once. iOS only for now.";
+    };
+    readonly "DA-AD-PLAYBACK-ERROR": {
+        readonly category: "playback";
+        readonly level: "error";
+        readonly summary: "The ad player reported a playback error during a break.";
+    };
+    readonly "DA-AD-START-INTERRUPTED": {
+        readonly category: "playback";
+        readonly level: "warn";
+        readonly summary: "The ad element's play() was interrupted by a browser-initiated pause before the ad started (Chromium AbortError, seen on Samsung Tizen); the SDK re-issued play() once. context: breakId, error.";
+    };
+    readonly "DA-DELIVERY-MODE-RESOLVED": {
+        readonly category: "session";
+        readonly level: "info";
+        readonly summary: "Delivery mode (sgai/ssai) resolved for the session at start and again on an ads-channel switch from the manifest's delivery rules (or the explicit client config).";
+    };
+    readonly "DA-DELIVERY-MODE-UNKNOWN": {
+        readonly category: "session";
+        readonly level: "warn";
+        readonly summary: "The matching delivery rule carried an unrecognized mode value; sgai is used (forward compatibility).";
+    };
+    readonly "DA-DELIVERY-MODE-OVERRIDDEN": {
+        readonly category: "session";
+        readonly level: "info";
+        readonly summary: "The manifest's delivery rules resolved a different mode, but the explicit client config takes precedence.";
+    };
+    readonly "DA-DELIVERY-MODE-CHANGE-IGNORED": {
+        readonly category: "session";
+        readonly level: "warn";
+        readonly summary: "An ordinary manifest poll resolves a different delivery mode; the mode pinned for the session stays in force. An ads-channel switch resolves the mode again.";
+    };
+    readonly "DA-SSAI-UNAVAILABLE": {
+        readonly category: "session";
+        readonly level: "error";
+        readonly summary: "The manifest selected ssai delivery but no vendor configuration can provide a stitched stream (no gam entry with an assetKey); at start the session fails, while on a channel switch the session stays in sgai.";
+    };
+    readonly "DA-SSAI-SESSION-FAILED": {
+        readonly category: "session";
+        readonly level: "error";
+        readonly summary: "The SSAI session failed to start (IMA stream init, stream id, or stitched-stream load).";
+    };
+    readonly "DA-SSAI-IMA-ERROR": {
+        readonly category: "gam";
+        readonly level: "error";
+        readonly summary: "IMA reported an error during the SSAI stream session.";
+    };
+    readonly "DA-INSERTION-TYPE-RESOLVED": {
+        readonly category: "session";
+        readonly level: "info";
+        readonly summary: "Per-session ad insertion type resolved, and whether the integrator set it or left it unset (unset lets the manifest's resumeOffset drive the resume point).";
+    };
+    readonly "DA-RESUME-OFFSET-CLAMPED": {
+        readonly category: "break";
+        readonly level: "info";
+        readonly summary: "The resume offset was shortened to the ad duration actually played, so the break could not skip further than the ads it delivered.";
+    };
+    readonly "DA-INSERTION-TYPE-IGNORED-SSAI": {
+        readonly category: "session";
+        readonly level: "warn";
+        readonly summary: "adInsertionType is ignored in SSAI mode; the stitcher controls ad insertion server-side.";
+    };
+    readonly "DA-VAST-UNSUPPORTED-FORMAT": {
+        readonly category: "break";
+        readonly level: "warn";
+        readonly summary: "A VAST asset appeared in an unsupported break format; VAST is only supported in single, double, and lshape_ad. The break was skipped.";
+    };
+    readonly "DA-ASSET-MACRO-UNKNOWN": {
+        readonly category: "break";
+        readonly level: "warn";
+        readonly summary: "An asset parameter value contained a macro the SDK has no value for (an unknown or unavailable OptiView macro, or a registered customer macro that returned no value); the parameter was still sent, with the macro kept as its literal token. Raised once per parameter key and macro. context: key, macro, breakId, assetId.";
+    };
+    readonly "DA-VAST-SSAI-UNSUPPORTED": {
+        readonly category: "session";
+        readonly level: "warn";
+        readonly summary: "VAST assets are not supported in SSAI mode (VAST is SGAI-only); the asset was skipped.";
+    };
+    readonly "DA-VAST-IMA-ERROR": {
+        readonly category: "gam";
+        readonly level: "error";
+        readonly summary: "Google IMA reported an error while loading or playing a VAST (client-side / CSAI) ad.";
+    };
+    readonly "DA-VAST-IMA-SDK-MISSING": {
+        readonly category: "gam";
+        readonly level: "error";
+        readonly summary: "The Google IMA client-side SDK (ima3.js) is unavailable; VAST (CSAI) ads cannot be played.";
+    };
+    readonly "DA-PAUSE-AD-SHOWN": {
+        readonly category: "break";
+        readonly level: "info";
+        readonly summary: "A pause ad (full-screen image or video) was shown while content is paused.";
+    };
+    readonly "DA-PAUSE-AD-DISMISSED": {
+        readonly category: "break";
+        readonly level: "info";
+        readonly summary: "A pause ad was dismissed (content resumed, or the duration cap elapsed).";
+    };
+    readonly "DA-PAUSE-AD-RESUME-ALLOWED": {
+        readonly category: "break";
+        readonly level: "info";
+        readonly summary: "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.";
+    };
+    readonly "DA-PAUSE-AD-RESUME-BLOCKED": {
+        readonly category: "break";
+        readonly level: "info";
+        readonly summary: "Content tried to resume while a pause ad must still be watched (controls.skipOffset not reached, or no skipOffset and the video creative has not ended / the image duration cap has not elapsed); the SDK keeps content paused. context: breakId, elapsedSec, skipOffset.";
+    };
+    readonly "DA-PAUSE-AD-DVR-EXPIRED": {
+        readonly category: "break";
+        readonly level: "info";
+        readonly summary: "The viewer paused for longer than the DVR window is deep, so the position they paused at aged out and playback resumed at the live edge instead. context: pinnedPosition, liveEdge.";
+    };
+    readonly "DA-PAUSE-AD-NO-ASSET": {
+        readonly category: "break";
+        readonly level: "warn";
+        readonly summary: "A pause break had no usable image or video asset (no first asset, unsupported media type, or no resolvable VAST creative); the pause ad was skipped.";
+    };
+    readonly "DA-PAUSE-AD-SSAI-UNSUPPORTED": {
+        readonly category: "session";
+        readonly level: "warn";
+        readonly summary: "Pause ads are SGAI-only and not supported in SSAI mode; the pause break was skipped.";
+    };
+    readonly "DA-MANIFEST-POLLED": {
+        readonly category: "manifest";
+        readonly level: "info";
+        readonly summary: "A manifest poll refresh succeeded (cadence follows the manifest polling config).";
+    };
+    readonly "DA-AD-SKIPPED": {
+        readonly category: "playback";
+        readonly level: "info";
+        readonly summary: "The viewer skipped the active ad break (controls.skipOffset honored).";
+    };
+    readonly "DA-AD-SKIP-SUPPRESSED": {
+        readonly category: "playback";
+        readonly level: "info";
+        readonly summary: "A skip request was suppressed (no skipOffset declared, or requested before the offset).";
+    };
+    readonly "DA-AD-CLICKED": {
+        readonly category: "playback";
+        readonly level: "info";
+        readonly summary: "The viewer clicked the ad on screen (adclick emitted).";
+    };
+    readonly "DA-RESUME-SEEK": {
+        readonly category: "playback";
+        readonly level: "info";
+        readonly summary: "Content was resume-seeked to the resolved post-break position (insertion type policy).";
+    };
+    readonly "DA-RESUME-LANDED": {
+        readonly category: "playback";
+        readonly level: "info";
+        readonly summary: "Where the post-break resume-seek actually landed, measured on the seeked event rather than inferred: context carries breakId, target (the position requested), landed and errorSec (landed - target; negative means the player settled EARLIER than asked). landed is null with a reason when no seeked event arrived, which is normal for a seek to the position the playhead already holds. Report-only: the SDK does not correct the position.";
+    };
+    readonly "DA-RESUME-PREPOSITIONED": {
+        readonly category: "playback";
+        readonly level: "info";
+        readonly summary: "The break resumed without a seek: content was moved onto its resume position DURING the break, so the transition needed no jump. Context carries breakId, target, prepositionedTo, landed, shortfallSec and exact. exact=true means it reached the policy target. exact=false means the live window never published those frames, so content was moved as close as exists — the viewer lands short, but arrives already in place rather than via a visible seek at the cut.";
+    };
+    readonly "DA-RESUME-CATCHUP": {
+        readonly category: "playback";
+        readonly level: "info";
+        readonly summary: "Content began playing behind the ad to reach its resume point. Context carries breakId, startPos, target, remainingAdSec, publishedEnd and clampedStart — clampedStart true means the stream had not published the ideal start position, so playback began late and the alignment loop must make up the difference (the zero-live-headroom case). Its ABSENCE on a live break that resumed short means catch-up never ran at all, which is a different fault from it running and falling short.";
+    };
+    readonly "DA-RESUME-TARGET-CLAMPED": {
+        readonly category: "playback";
+        readonly level: "warn";
+        readonly summary: "The computed resume position sat inside the engine's minimum live offset and was clamped to the closest position the engine will hold; context carries breakId, requested, clamped and shortfallSec. Distinct from DA-RESUME-OFFSET-CLAMPED, which shortens the OFFSET to the ad seconds actually played.";
+    };
+    readonly "DA-RESUME-ALIGN-BLOCKED": {
+        readonly category: "playback";
+        readonly level: "warn";
+        readonly summary: "Resume alignment wanted to move content past the live edge and stood down, because no seek can reach media the stream has not published yet; content is left riding the edge and the break-end clamp places it. Context carries target, requested, safeEnd, shortfallSec and remainingSec. Emitted once per break. A persistent shortfall here means the resume target is further ahead than the feed's published edge — typically the player's view of the edge is stale, not that the seek is wrong.";
+    };
+    readonly "DA-CONTINUE-PLAYOUT-BEGIN": {
+        readonly category: "playback";
+        readonly level: "info";
+        readonly summary: "continueContentDuringBreak engaged: content keeps PLAYING through the break, hidden and muted, so no resume seek is needed. Context carries breakId, anchor, breakDurationSec and edgeDistanceSec.";
+    };
+    readonly "DA-CONTINUE-PLAYOUT-END": {
+        readonly category: "playback";
+        readonly level: "info";
+        readonly summary: "continueContentDuringBreak reached the cut. Context carries driftSec (content position minus where the break says it should be), maxDriftSec, the corrections applied, rateHonoured (false if the engine drove playbackRate itself) and driftUnrecoverable.";
+    };
+    readonly "DA-CONTINUE-PLAYOUT-REFUSED": {
+        readonly category: "playback";
+        readonly level: "info";
+        readonly summary: "continueContentDuringBreak was not used this session, so breaks pause content and resume with a seek as before. Emitted once per session; context carries the reason (disabled, not-replacement, format, shared-element, picture-in-picture, single-decoder) and the break format. Its ABSENCE on an eligible session is the signal the mode engaged.";
+    };
+    readonly "DA-CONTINUE-PLAYOUT-QUALITY-UNAVAILABLE": {
+        readonly category: "playback";
+        readonly level: "warn";
+        readonly summary: "Content continues through the replacement break without a video-quality constraint, so the content stream may retain its normal bitrate alongside the ad. Context carries breakId and reason (unsupported when the optional Web adapter method is absent, not-applied when the adapter returned false or could not apply the request).";
+    };
+    readonly "DA-CONTINUE-PLAYOUT-DRIFT": {
+        readonly category: "playback";
+        readonly level: "warn";
+        readonly summary: "Content drifted further from the break timeline than the remaining break can remove within the playback-rate bounds, so part of it is carried into the cut. Context carries driftSec, remainingSec, the rate applied and seekIssued (always false: a corrective seek would be clipped).";
+    };
+    readonly "DA-CONTINUE-PLAYOUT-ABANDONED": {
+        readonly category: "playback";
+        readonly level: "warn";
+        readonly summary: "Content could not be kept playing through the break, so it reverted to the pause-and-resume path mid-break. Context carries breakId, the reason and the driftSec at the moment it converted.";
+    };
+    readonly "DA-AD-AV-DESYNC": {
+        readonly category: "playback";
+        readonly level: "warn";
+        readonly summary: "The ad player's audio sink was handed a buffer whose timestamp does not continue the audio it has already been fed, so the media clock had to be re-anchored mid-ad. Video is scheduled off that clock while the audio already queued in the output track keeps draining, so every re-anchor pushes the picture further from the sound actually being heard. Context carries breakId, assetId, expectedSec, actualSec, deltaSec (negative = audio running behind the picture) and positionSec. Seen on server-stitched pods whose per-ad audio and video durations do not match; a single event near the end of a pod is the accumulated total, not an isolated glitch.";
+    };
+    readonly "DA-AD-PLAYOUT-SYNC": {
+        readonly category: "playback";
+        readonly level: "info";
+        readonly summary: "Per-break summary of ad playout health, emitted once at break end. Context carries podUri (the resolved ad media, so a stitched pod can be fetched and inspected), desyncEvents, maxDesyncSec, droppedFrames, audioUnderruns, audioFormats and videoFormats (the distinct decoder input formats seen during the break — more than one means the stitched stream changed sample rate or codec mid-pod) and frameOffsetMeanMs (mean video frame processing offset; large negative values mean frames were released late against the audio clock).";
+    };
+    readonly "DA-EVENT": {
+        readonly category: "event";
+        readonly level: "info";
+        readonly summary: "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.";
+    };
+    readonly "DA-BREAK-CONTENT-MASK": {
+        readonly category: "break";
+        readonly level: "warn";
+        readonly summary: "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.";
+    };
+    readonly "DA-BREAK-FORMAT-DEGRADED": {
+        readonly category: "break";
+        readonly level: "warn";
+        readonly summary: "Split break reframing degraded: the host supplied no content view or sibling container for the ad.";
+    };
+    readonly "DA-BREAK-NO-PLAYABLE-ASSET": {
+        readonly category: "break";
+        readonly level: "warn";
+        readonly summary: "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.";
+    };
+    readonly "DA-BREAK-VARIANT-FORMAT-UNKNOWN": {
+        readonly category: "break";
+        readonly level: "warn";
+        readonly summary: "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).";
+    };
+    readonly "DA-AD-STALLED": {
+        readonly category: "playback";
+        readonly level: "warn";
+        readonly summary: "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.";
+    };
+    readonly "DA-AD-FOREGROUND-RESUMED": {
+        readonly category: "playback";
+        readonly level: "info";
+        readonly summary: "An in-flight ad resumed after the app returned to the foreground; context carries the suspended duration and ad position at resume.";
+    };
+    readonly "DA-AD-FOCUS-LOST": {
+        readonly category: "playback";
+        readonly level: "warn";
+        readonly summary: "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.";
+    };
+    readonly "DA-AD-FOCUS-GRANTED": {
+        readonly category: "playback";
+        readonly level: "info";
+        readonly summary: "The overlay ad was granted media audio focus for the break, so system focus semantics (call, duck, permanent loss) apply to ad playback. context: breakId, cause, alreadyHeld.";
+    };
+    readonly "DA-AD-FOCUS-DENIED": {
+        readonly category: "playback";
+        readonly level: "warn";
+        readonly summary: "The platform refused the overlay ad's media audio-focus request, so the break plays with no focus of its own: another app's audio can mix over the ad, and a call can neither duck nor pause it. context: breakId, cause.";
+    };
+    readonly "DA-AD-FOCUS-ABANDONED": {
+        readonly category: "playback";
+        readonly level: "info";
+        readonly summary: "The overlay ad gave media audio focus back, so the content player's own focus request finds a clean stack. context: breakId, cause.";
+    };
+    readonly "DA-BREAK-ABANDONED": {
+        readonly category: "lifecycle";
+        readonly level: "warn";
+        readonly summary: "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.";
+    };
+    readonly "DA-RENDERER-UNAVAILABLE": {
+        readonly category: "lifecycle";
+        readonly level: "error";
+        readonly summary: "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.";
+    };
+    readonly "DA-SESSION-STARTING": {
+        readonly category: "session";
+        readonly level: "info";
+        readonly summary: "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).";
+    };
+};

package/dist/generated/diagnosticCodes.js

@@ -0,0 +1 @@
+export const DIAGNOSTIC_CODES={"DA-SESSION-STARTED":{category:"session",level:"info",summary:"Monetization session started; manifest polling began. context: manifestUrl (stitcherUrl in SSAI mode), reported verbatim."},"DA-SESSION-ENDED":{category:"session",level:"info",summary:"Monetization session ended; polling and scheduling stopped."},"DA-ASSET-PARAMETERS-UPDATED":{category:"session",level:"info",summary:"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)."},"DA-MANIFEST-FETCH-FAILED":{category:"manifest",level:"error",summary:"Initial break-manifest fetch failed; the session could not start."},"DA-MANIFEST-POLL-FAILED":{category:"manifest",level:"warn",summary:"A manifest poll failed; the SDK keeps the last good manifest and retries."},"DA-MANIFEST-CHANNEL-CHANGED":{category:"manifest",level:"info",summary:"A polled manifest describes a different ads channel (channelId, GAM identity or timebase changed); the SDK re-aligned its ad setup and resolved delivery mode again while the session and content playback continued. context: previousChannelId, channelId, reason, manifestUrl."},"DA-MANIFEST-INTERCEPT-FAILED":{category:"manifest",level:"warn",summary:"The customer manifest-response interceptor threw; the un-modified parsed manifest was used instead."},"DA-MANIFEST-REQUEST-INTERCEPT-FAILED":{category:"manifest",level:"warn",summary:"The customer manifest-request interceptor threw; the normal network fetch of the original URL was used instead."},"DA-MANIFEST-SIGNATURE-INVALID":{category:"manifest",level:"error",summary:"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-PDT-MISSING":{category:"playback",level:"warn",summary:"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":{category:"break",level:"info",summary:"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":{category:"break",level:"info",summary:"ptsSource: 'anvatoCue' — a PTS break's start was matched to an observed Anvato cue and scheduled at the cue's media time."},"DA-ANVATO-CUE-ENTERED":{category:"break",level:"info",summary:"ptsSource: 'anvatoCue' — a break was started by the cue reaching the playhead rather than by the scheduler's 250ms tick; context carries the breakId, the cue pts and the media time it fired at, so the two start paths are distinguishable in the field."},"DA-ANVATO-CUE-OBSERVED":{category:"break",level:"info",summary:"ptsSource: 'anvatoCue' — an Anvato break-signaling (type=cue) frame was observed in the stream; context carries the cue's pts, the media time it landed at, whether the tracker recorded it, and the raw payload — so a manifest-PTS vs in-stream-PTS misalignment is observable in the field."},"DA-PRELOAD-FAILED":{category:"preload",level:"warn",summary:"Ad preload failed; the asset will be loaded on demand at break start."},"DA-PRELOAD-MODE-RESOLVED":{category:"preload",level:"info",summary:"The configured ad preload mode was resolved for this session; context carries both the configured and the resolved mode."},"DA-PRELOAD-PATH":{category:"preload",level:"info",summary:"The preload path actually taken for a break's ad (parallel buffer / detached prefetch / none) and the creative container (stream vs progressive)."},"DA-BREAK-EARLY-RETURN":{category:"break",level:"info",summary:"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."},"DA-BREAK-WINDOW-ESCAPED":{category:"break",level:"warn",summary:"An active wallclock break outlived its window on the stream clock (ad stall, bogus trigger position, or a re-fired completed break); the SDK ended it and returned to content. context.overrunSec says by how much."},"DA-BREAK-EVENT-UNSUPPORTED":{category:"break",level:"warn",summary:"A break is triggered by a spec event this SDK version does not schedule on this platform (web schedules `start`, `pause` and `end`; Android and iOS do not schedule `end` yet); the break was ignored. context.event names the event."},"DA-BREAK-SUPPRESSED-OVERLAP":{category:"break",level:"warn",summary:"A break was suppressed because an ad was already playing."},"DA-BREAK-TRANSITION":{category:"break",level:"info",summary:"Measured duration of a playback transition into an ad break, between two ads, between chained breaks, or back to content."},"DA-AD-SURFACE-REVEALED":{category:"break",level:"info",summary:"The ad surface became visible: how long it was held back waiting for the ad's first frame, and whether it was revealed because that frame arrived or because the wait timed out."},"DA-PREROLL-CONTENT-HELD":{category:"break",level:"info",summary:"Content playback was held at session start until a pending pre-roll began, so no content is shown before the ad."},"DA-SHARED-ELEMENT-UNSUPPORTED":{category:"break",level:"warn",summary:"Configured shared-element insertion is unsupported on this platform (non-iPhone/iPod); fell back to overlay insertion."},"DA-SHARED-ELEMENT-RESTORE-FAILED":{category:"playback",level:"error",summary:"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":{category:"break",level:"warn",summary:"An image (companion, backdrop or image ad) could not be fetched or decoded within the timeout; the break continues without it."},"DA-PIP-TRANSFER-FAILED":{category:"break",level:"warn",summary:"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":{category:"break",level:"warn",summary:"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":{category:"break",level:"info",summary:"The content player replaced its <video> element; the SDK re-bound its presentation listeners to the new one."},"DA-PIP-FORMAT-OVERRIDE":{category:"break",level:"info",summary:"The content player is in picture-in-picture, so the break's declared format was overruled and it plays as a single fullscreen ad."},"DA-CHAIN-RESOLVER-ERROR":{category:"chaining",level:"warn",summary:"The chained-successor resolver threw; chaining was skipped for this break."},"DA-GAM-NO-ASSET-KEY":{category:"gam",level:"warn",summary:"Retired: the GAM stream identity now comes from the manifest's vendorConfiguration. Kept declared so the code is never reused; see DA-GAM-CONFIG-MISSING."},"DA-GAM-SESSION-FAILED":{category:"gam",level:"error",summary:"The GAM/IMA session failed to initialize; GAM breaks will not serve."},"DA-GAM-CONFIG-RESOLVED":{category:"gam",level:"info",summary:"The GAM stream identity for this session was resolved from the manifest's vendorConfiguration."},"DA-GAM-CONFIG-MISSING":{category:"gam",level:"error",summary:'The break manifest carries no usable "gam" vendorConfiguration entry; GAM assets are skipped.'},"DA-GAM-POD-IDENTITY-MISMATCH":{category:"gam",level:"error",summary:"A GAM pod asset's vendorParameters name a different network code or custom asset key than the stream session was created with; the asset is skipped because the pod request cannot serve."},"DA-VENDOR-CONFIG-UNKNOWN-TYPE":{category:"manifest",level:"info",summary:"One or more vendorConfiguration entries declare a type this SDK version does not recognise and were ignored."},"DA-CONTENT-PLAYBACK-ERROR":{category:"playback",level:"error",summary:"The content player reported a playback error."},"DA-CONTENT-RESUME-STALLED":{category:"playback",level:"warn",summary:"Content did not resume within the watchdog window after a break that paused it ended; the SDK re-issued play() once. iOS only for now."},"DA-AD-PLAYBACK-ERROR":{category:"playback",level:"error",summary:"The ad player reported a playback error during a break."},"DA-AD-START-INTERRUPTED":{category:"playback",level:"warn",summary:"The ad element's play() was interrupted by a browser-initiated pause before the ad started (Chromium AbortError, seen on Samsung Tizen); the SDK re-issued play() once. context: breakId, error."},"DA-DELIVERY-MODE-RESOLVED":{category:"session",level:"info",summary:"Delivery mode (sgai/ssai) resolved for the session at start and again on an ads-channel switch from the manifest's delivery rules (or the explicit client config)."},"DA-DELIVERY-MODE-UNKNOWN":{category:"session",level:"warn",summary:"The matching delivery rule carried an unrecognized mode value; sgai is used (forward compatibility)."},"DA-DELIVERY-MODE-OVERRIDDEN":{category:"session",level:"info",summary:"The manifest's delivery rules resolved a different mode, but the explicit client config takes precedence."},"DA-DELIVERY-MODE-CHANGE-IGNORED":{category:"session",level:"warn",summary:"An ordinary manifest poll resolves a different delivery mode; the mode pinned for the session stays in force. An ads-channel switch resolves the mode again."},"DA-SSAI-UNAVAILABLE":{category:"session",level:"error",summary:"The manifest selected ssai delivery but no vendor configuration can provide a stitched stream (no gam entry with an assetKey); at start the session fails, while on a channel switch the session stays in sgai."},"DA-SSAI-SESSION-FAILED":{category:"session",level:"error",summary:"The SSAI session failed to start (IMA stream init, stream id, or stitched-stream load)."},"DA-SSAI-IMA-ERROR":{category:"gam",level:"error",summary:"IMA reported an error during the SSAI stream session."},"DA-INSERTION-TYPE-RESOLVED":{category:"session",level:"info",summary:"Per-session ad insertion type resolved, and whether the integrator set it or left it unset (unset lets the manifest's resumeOffset drive the resume point)."},"DA-RESUME-OFFSET-CLAMPED":{category:"break",level:"info",summary:"The resume offset was shortened to the ad duration actually played, so the break could not skip further than the ads it delivered."},"DA-INSERTION-TYPE-IGNORED-SSAI":{category:"session",level:"warn",summary:"adInsertionType is ignored in SSAI mode; the stitcher controls ad insertion server-side."},"DA-VAST-UNSUPPORTED-FORMAT":{category:"break",level:"warn",summary:"A VAST asset appeared in an unsupported break format; VAST is only supported in single, double, and lshape_ad. The break was skipped."},"DA-ASSET-MACRO-UNKNOWN":{category:"break",level:"warn",summary:"An asset parameter value contained a macro the SDK has no value for (an unknown or unavailable OptiView macro, or a registered customer macro that returned no value); the parameter was still sent, with the macro kept as its literal token. Raised once per parameter key and macro. context: key, macro, breakId, assetId."},"DA-VAST-SSAI-UNSUPPORTED":{category:"session",level:"warn",summary:"VAST assets are not supported in SSAI mode (VAST is SGAI-only); the asset was skipped."},"DA-VAST-IMA-ERROR":{category:"gam",level:"error",summary:"Google IMA reported an error while loading or playing a VAST (client-side / CSAI) ad."},"DA-VAST-IMA-SDK-MISSING":{category:"gam",level:"error",summary:"The Google IMA client-side SDK (ima3.js) is unavailable; VAST (CSAI) ads cannot be played."},"DA-PAUSE-AD-SHOWN":{category:"break",level:"info",summary:"A pause ad (full-screen image or video) was shown while content is paused."},"DA-PAUSE-AD-DISMISSED":{category:"break",level:"info",summary:"A pause ad was dismissed (content resumed, or the duration cap elapsed)."},"DA-PAUSE-AD-RESUME-ALLOWED":{category:"break",level:"info",summary:"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."},"DA-PAUSE-AD-RESUME-BLOCKED":{category:"break",level:"info",summary:"Content tried to resume while a pause ad must still be watched (controls.skipOffset not reached, or no skipOffset and the video creative has not ended / the image duration cap has not elapsed); the SDK keeps content paused. context: breakId, elapsedSec, skipOffset."},"DA-PAUSE-AD-DVR-EXPIRED":{category:"break",level:"info",summary:"The viewer paused for longer than the DVR window is deep, so the position they paused at aged out and playback resumed at the live edge instead. context: pinnedPosition, liveEdge."},"DA-PAUSE-AD-NO-ASSET":{category:"break",level:"warn",summary:"A pause break had no usable image or video asset (no first asset, unsupported media type, or no resolvable VAST creative); the pause ad was skipped."},"DA-PAUSE-AD-SSAI-UNSUPPORTED":{category:"session",level:"warn",summary:"Pause ads are SGAI-only and not supported in SSAI mode; the pause break was skipped."},"DA-MANIFEST-POLLED":{category:"manifest",level:"info",summary:"A manifest poll refresh succeeded (cadence follows the manifest polling config)."},"DA-AD-SKIPPED":{category:"playback",level:"info",summary:"The viewer skipped the active ad break (controls.skipOffset honored)."},"DA-AD-SKIP-SUPPRESSED":{category:"playback",level:"info",summary:"A skip request was suppressed (no skipOffset declared, or requested before the offset)."},"DA-AD-CLICKED":{category:"playback",level:"info",summary:"The viewer clicked the ad on screen (adclick emitted)."},"DA-RESUME-SEEK":{category:"playback",level:"info",summary:"Content was resume-seeked to the resolved post-break position (insertion type policy)."},"DA-RESUME-LANDED":{category:"playback",level:"info",summary:"Where the post-break resume-seek actually landed, measured on the seeked event rather than inferred: context carries breakId, target (the position requested), landed and errorSec (landed - target; negative means the player settled EARLIER than asked). landed is null with a reason when no seeked event arrived, which is normal for a seek to the position the playhead already holds. Report-only: the SDK does not correct the position."},"DA-RESUME-PREPOSITIONED":{category:"playback",level:"info",summary:"The break resumed without a seek: content was moved onto its resume position DURING the break, so the transition needed no jump. Context carries breakId, target, prepositionedTo, landed, shortfallSec and exact. exact=true means it reached the policy target. exact=false means the live window never published those frames, so content was moved as close as exists — the viewer lands short, but arrives already in place rather than via a visible seek at the cut."},"DA-RESUME-CATCHUP":{category:"playback",level:"info",summary:"Content began playing behind the ad to reach its resume point. Context carries breakId, startPos, target, remainingAdSec, publishedEnd and clampedStart — clampedStart true means the stream had not published the ideal start position, so playback began late and the alignment loop must make up the difference (the zero-live-headroom case). Its ABSENCE on a live break that resumed short means catch-up never ran at all, which is a different fault from it running and falling short."},"DA-RESUME-TARGET-CLAMPED":{category:"playback",level:"warn",summary:"The computed resume position sat inside the engine's minimum live offset and was clamped to the closest position the engine will hold; context carries breakId, requested, clamped and shortfallSec. Distinct from DA-RESUME-OFFSET-CLAMPED, which shortens the OFFSET to the ad seconds actually played."},"DA-RESUME-ALIGN-BLOCKED":{category:"playback",level:"warn",summary:"Resume alignment wanted to move content past the live edge and stood down, because no seek can reach media the stream has not published yet; content is left riding the edge and the break-end clamp places it. Context carries target, requested, safeEnd, shortfallSec and remainingSec. Emitted once per break. A persistent shortfall here means the resume target is further ahead than the feed's published edge — typically the player's view of the edge is stale, not that the seek is wrong."},"DA-CONTINUE-PLAYOUT-BEGIN":{category:"playback",level:"info",summary:"continueContentDuringBreak engaged: content keeps PLAYING through the break, hidden and muted, so no resume seek is needed. Context carries breakId, anchor, breakDurationSec and edgeDistanceSec."},"DA-CONTINUE-PLAYOUT-END":{category:"playback",level:"info",summary:"continueContentDuringBreak reached the cut. Context carries driftSec (content position minus where the break says it should be), maxDriftSec, the corrections applied, rateHonoured (false if the engine drove playbackRate itself) and driftUnrecoverable."},"DA-CONTINUE-PLAYOUT-REFUSED":{category:"playback",level:"info",summary:"continueContentDuringBreak was not used this session, so breaks pause content and resume with a seek as before. Emitted once per session; context carries the reason (disabled, not-replacement, format, shared-element, picture-in-picture, single-decoder) and the break format. Its ABSENCE on an eligible session is the signal the mode engaged."},"DA-CONTINUE-PLAYOUT-QUALITY-UNAVAILABLE":{category:"playback",level:"warn",summary:"Content continues through the replacement break without a video-quality constraint, so the content stream may retain its normal bitrate alongside the ad. Context carries breakId and reason (unsupported when the optional Web adapter method is absent, not-applied when the adapter returned false or could not apply the request)."},"DA-CONTINUE-PLAYOUT-DRIFT":{category:"playback",level:"warn",summary:"Content drifted further from the break timeline than the remaining break can remove within the playback-rate bounds, so part of it is carried into the cut. Context carries driftSec, remainingSec, the rate applied and seekIssued (always false: a corrective seek would be clipped)."},"DA-CONTINUE-PLAYOUT-ABANDONED":{category:"playback",level:"warn",summary:"Content could not be kept playing through the break, so it reverted to the pause-and-resume path mid-break. Context carries breakId, the reason and the driftSec at the moment it converted."},"DA-AD-AV-DESYNC":{category:"playback",level:"warn",summary:"The ad player's audio sink was handed a buffer whose timestamp does not continue the audio it has already been fed, so the media clock had to be re-anchored mid-ad. Video is scheduled off that clock while the audio already queued in the output track keeps draining, so every re-anchor pushes the picture further from the sound actually being heard. Context carries breakId, assetId, expectedSec, actualSec, deltaSec (negative = audio running behind the picture) and positionSec. Seen on server-stitched pods whose per-ad audio and video durations do not match; a single event near the end of a pod is the accumulated total, not an isolated glitch."},"DA-AD-PLAYOUT-SYNC":{category:"playback",level:"info",summary:"Per-break summary of ad playout health, emitted once at break end. Context carries podUri (the resolved ad media, so a stitched pod can be fetched and inspected), desyncEvents, maxDesyncSec, droppedFrames, audioUnderruns, audioFormats and videoFormats (the distinct decoder input formats seen during the break — more than one means the stitched stream changed sample rate or codec mid-pod) and frameOffsetMeanMs (mean video frame processing offset; large negative values mean frames were released late against the audio clock)."},"DA-EVENT":{category:"event",level:"info",summary:"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":{category:"break",level:"warn",summary:"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":{category:"break",level:"warn",summary:"Split break reframing degraded: the host supplied no content view or sibling container for the ad."},"DA-BREAK-NO-PLAYABLE-ASSET":{category:"break",level:"warn",summary:"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-BREAK-VARIANT-FORMAT-UNKNOWN":{category:"break",level:"warn",summary:"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-AD-STALLED":{category:"playback",level:"warn",summary:"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":{category:"playback",level:"info",summary:"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":{category:"playback",level:"warn",summary:"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."},"DA-AD-FOCUS-GRANTED":{category:"playback",level:"info",summary:"The overlay ad was granted media audio focus for the break, so system focus semantics (call, duck, permanent loss) apply to ad playback. context: breakId, cause, alreadyHeld."},"DA-AD-FOCUS-DENIED":{category:"playback",level:"warn",summary:"The platform refused the overlay ad's media audio-focus request, so the break plays with no focus of its own: another app's audio can mix over the ad, and a call can neither duck nor pause it. context: breakId, cause."},"DA-AD-FOCUS-ABANDONED":{category:"playback",level:"info",summary:"The overlay ad gave media audio focus back, so the content player's own focus request finds a clean stack. context: breakId, cause."},"DA-BREAK-ABANDONED":{category:"lifecycle",level:"warn",summary:"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":{category:"lifecycle",level:"error",summary:"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":{category:"session",level:"info",summary:"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)."}};

package/dist/generated/version.d.ts

@@ -0,0 +1,5 @@
+/**
+ * SDK version embedded in diagnostic reports.
+ * Stamped from the monorepo lockstep version (lerna.json) by the taxonomy generator.
+ */
+export declare const SDK_VERSION = "1.0.0-beta.1";

package/dist/generated/version.js

@@ -0,0 +1 @@
+export const SDK_VERSION="1.0.0-beta.1";

package/dist/id3/buildId3.d.ts

@@ -0,0 +1,25 @@
+export declare const latin1Bytes: (text: string) => number[];
+export declare const utf8Bytes: (text: string) => number[];
+/** UTF-16LE code units, optionally prefixed with the FF FE BOM. */
+export declare const utf16leBytes: (text: string, withBom?: boolean) => number[];
+/** UTF-16BE code units, optionally prefixed with the FE FF BOM. */
+export declare const utf16beBytes: (text: string, withBom?: boolean) => number[];
+export declare const syncsafe: (value: number) => number[];
+export declare const uint32: (value: number) => number[];
+/**
+ * GEOB frame body: encoding byte, MIME (latin1 + NUL), file name and content
+ * description (NUL-terminated in the frame encoding — double NUL for the
+ * UTF-16 encodings), then the object data.
+ */
+export declare const buildGeobBody: (encoding: number, mime: number[], fileName: number[], description: number[], data: number[]) => number[];
+/** Frame header: 4-byte id, 4-byte size (syncsafe in v2.4, plain in v2.3), 2 flag bytes. */
+export declare const buildFrame: (id: string, body: number[], version: 3 | 4) => number[];
+/** Tag header ("ID3" + ver + flags + syncsafe size) followed by the given content. */
+export declare const buildTag: (version: 3 | 4, frames: number[], options?: {
+    flags?: number;
+    padding?: number;
+    extendedHeader?: number[];
+}) => Uint8Array;
+export declare const ANVATO_PAYLOAD = "type=cue&pts=1234.567";
+/** A complete Anvato-shaped tag: one GEOB frame, latin1 texts, UTF-8 payload. */
+export declare const buildAnvatoGeobTag: (version?: 3 | 4, payload?: string) => Uint8Array;

package/dist/id3/buildId3.js

@@ -0,0 +1 @@
+export const latin1Bytes=t=>Array.from(t,t=>t.charCodeAt(0));export const utf8Bytes=t=>Array.from((new TextEncoder).encode(t));export const utf16leBytes=(t,e=!0)=>{const n=e?[255,254]:[];for(let e=0;e<t.length;e++){const o=t.charCodeAt(e);n.push(255&o,o>>8&255)}return n};export const utf16beBytes=(t,e=!1)=>{const n=e?[254,255]:[];for(let e=0;e<t.length;e++){const o=t.charCodeAt(e);n.push(o>>8&255,255&o)}return n};export const syncsafe=t=>[t>>21&127,t>>14&127,t>>7&127,127&t];export const uint32=t=>[t>>>24&255,t>>>16&255,t>>>8&255,255&t];export const buildGeobBody=(t,e,n,o,r)=>{const s=1===t||2===t?[0,0]:[0];return[t,...e,0,...n,...s,...o,...s,...r]};export const buildFrame=(t,e,n)=>{return[...latin1Bytes(t),...4===n?syncsafe(e.length):(o=e.length,[o>>>24&255,o>>>16&255,o>>>8&255,255&o]),0,0,...e];var o};export const buildTag=(t,e,n)=>{const o=n?.extendedHeader??[],r=new Array(n?.padding??0).fill(0),s=o.length+e.length+r.length;return new Uint8Array([73,68,51,t,0,n?.flags??0,...syncsafe(s),...o,...e,...r])};export const ANVATO_PAYLOAD="type=cue&pts=1234.567";export const buildAnvatoGeobTag=(t=3,e=ANVATO_PAYLOAD)=>{return buildTag(t,buildFrame("GEOB",buildGeobBody(0,latin1Bytes("application/json"),latin1Bytes("anvatos.json"),latin1Bytes("Anvatos"),(n=e,Array.from((new TextEncoder).encode(n)))),t));var n};

package/dist/id3/index.d.ts

@@ -0,0 +1,3 @@
+export { parseId3GeobFrames, parseId3GeobBody, decodeUtf8 } from './parseId3Geob';
+export type { Id3GeobFrame } from './parseId3Geob';
+export { ANVATO_PAYLOAD, buildAnvatoGeobTag, buildFrame, buildGeobBody, buildTag, latin1Bytes, syncsafe, uint32, utf16beBytes, utf16leBytes, utf8Bytes, } from './buildId3';

package/dist/id3/index.js

@@ -0,0 +1 @@
+export{parseId3GeobFrames,parseId3GeobBody,decodeUtf8}from"./parseId3Geob";export{ANVATO_PAYLOAD,buildAnvatoGeobTag,buildFrame,buildGeobBody,buildTag,latin1Bytes,syncsafe,uint32,utf16beBytes,utf16leBytes,utf8Bytes}from"./buildId3";

package/dist/id3/parseId3Geob.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Minimal ID3v2 GEOB parser for Anvato in-stream break signaling (`ptsSource: 'anvatoCue'`), which matches
+ * on description `Anvatos`, MIME `application/json` and data `type=cue&pts=…`. Two entry points:
+ * {@link parseId3GeobFrames} for a complete raw ID3v2 tag (HLS.js `FRAG_PARSING_METADATA`) and
+ * {@link parseId3GeobBody} for one frame body (Shaka's `shaka.util.Id3Utils` has no GEOB decoder
+ * and passes the body through undecoded). Lives in core because both adapters consume it and an
+ * adapter must never depend on another adapter; exposed as `@dolby-optiview/ads-sdk-core/id3`.
+ */
+/** A single parsed ID3v2 GEOB frame. */
+export interface Id3GeobFrame {
+    /** GEOB MIME type (always latin1 in the tag), e.g. `application/json`. */
+    mimeType: string;
+    /** GEOB file name, decoded in the frame's text encoding. */
+    fileName: string;
+    /** GEOB content description (e.g. `Anvatos`), in the frame's text encoding. */
+    description: string;
+    /** The encapsulated object bytes (undecoded). */
+    data: Uint8Array;
+}
+/** Empty array for anything that is not a well-formed ID3v2.3/2.4 tag; never throws. */
+export declare function parseId3GeobFrames(bytes: Uint8Array): Id3GeobFrame[];
+/**
+ * GEOB frame body (after the 10-byte frame header): encoding byte, MIME (latin1, NUL), file name
+ * (NUL, frame encoding), description (NUL, frame encoding), object data. Null when malformed; never throws.
+ */
+export declare function parseId3GeobBody(body: Uint8Array): Id3GeobFrame | null;
+/** Decode UTF-8 bytes (also used for the GEOB object data / Anvato payload). */
+export declare function decodeUtf8(bytes: Uint8Array): string;