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

package/dist/services/AdPlayerController.d.ts

@@ -0,0 +1,495 @@
+import { PlayerAdapter } from '../interfaces/PlayerAdapter';
+import { Asset, Break, BreakFormat, Timebase } from '../types/BreakManifest';
+import { AdInsertionType, CreateAdAdapter, DoubleBoxAudio, GamConfig } from '../types/OptiViewAdsConfig';
+import { AssetParameterMacros } from './assetParameterMacros';
+import { ResolvedPreloadMode } from './detectPreloadMode';
+import { ResolvedInsertionMode } from './detectInsertionMode';
+import type { GamSessionIdentity } from './resolveGamVendorConfiguration';
+import { type NoPlayableAssetReason } from './AdBreakSequencer';
+import type { PauseAdResolution } from './PauseAdController';
+import { type Clock } from './BreakScheduler';
+import { PauseAdPresenter } from './adPlayer/PauseAdPresenter';
+/** Creative identity IMA reports for an ad of a GAM pod; absent for other asset kinds. */
+export interface AdCreativeIdentity {
+    adId?: string | undefined;
+    creativeId?: string | undefined;
+    /** 1-based position within the pod (IMA `getAdPodInfo().getAdPosition()` / VAST `sequence`); absent when unreported. */
+    podPosition?: number | undefined;
+}
+export interface AdPlayerCallbacks {
+    onAdStart: (breakInfo: Break, asset: Asset, index: number, total: number, identity?: AdCreativeIdentity) => void;
+    onAdEnd: (breakInfo: Break, asset: Asset, index: number, total: number, identity?: AdCreativeIdentity) => void;
+    /** `asset` is undefined for a break-level error (no playable variant, the break never began). */
+    onAdError: (breakInfo: Break, asset: Asset | undefined, error: Error) => void;
+    onAdTimeUpdate: (breakInfo: Break, asset: Asset, currentTime: number, duration: number) => void;
+    onAdWaiting: (breakInfo: Break, asset: Asset) => void;
+    onAdPlaying: (breakInfo: Break, asset: Asset) => void;
+    onBreakEnd: (breakInfo: Break) => void;
+    /**
+     * A content-covering break ended before its content pause landed, so no player transition
+     * announces the resume. Only the deferred-pause renderers (Kotlin/Swift) fire this.
+     */
+    onBreakEndedWithoutContentPause?: (breakInfo: Break) => void;
+    /** Ad overlay became visible; gates `adbreakbegin` so the AD badge never precedes the first ad frame. */
+    onBreakVisible?: (breakInfo: Break) => void;
+    /** The current break soft-ended into a chained successor (overlay held, no content resume). */
+    onChainedBreakBegin?: (next: Break) => void;
+    /** A chained successor resolved but has nothing to play; the SDK must retire it (completeBreak). */
+    onChainedBreakSkipped?: (next: Break) => void;
+    /**
+     * Fired just before the runtime's own post-break resume-seek, so the scheduler does not read
+     * the backward step as a DVR seek-back and re-arm the break.
+     */
+    onContentResumeSeek?: (targetSeconds: number, breakEndSeconds: number) => void;
+    /**
+     * Brackets a content RELOAD (shared-element break end), so the playhead passing through the
+     * start of the freshly loaded stream is not read as a seek back before the break.
+     */
+    onContentReloading?: (active: boolean) => void;
+}
+export interface PlayBreakOptions {
+    /** Seconds to present the break for (tune-in breaks: the remaining time); defaults to `break.duration`. */
+    effectiveDurationSec?: number;
+    /** Defer the overlay and `onBreakVisible` until the first ad frame renders (held delay:0 fullscreen pre-rolls). */
+    firstFrameGate?: boolean;
+}
+/**
+ * IMA quartile callbacks. `adIndex`/`totalAds` attribute the milestone to one ad of a
+ * multi-ad GAM pod; omitted when there is no per-ad breakdown.
+ */
+export interface GamEventCallbacks {
+    onAdFirstQuartile?: (breakInfo: Break, asset: Asset, adIndex?: number, totalAds?: number) => void;
+    onAdMidpoint?: (breakInfo: Break, asset: Asset, adIndex?: number, totalAds?: number) => void;
+    onAdThirdQuartile?: (breakInfo: Break, asset: Asset, adIndex?: number, totalAds?: number) => void;
+}
+export declare class AdPlayerController {
+    private static readonly AD_START_BUDGET_MS;
+    private static readonly GAM_POD_AD_START_BUDGET_MS;
+    private static readonly MIN_AD_START_BUDGET_MS;
+    private contentPlayer;
+    private container;
+    private playerContainer;
+    private playerContainerCreatedBySDK;
+    private createAdAdapter;
+    private adMediaContainer;
+    private adPlayer;
+    private adContainer;
+    private companionElement;
+    private staticQuartilesFired;
+    private sequencer;
+    private pendingAdError;
+    private get contentPaused();
+    private set contentPaused(value);
+    /** Wall-clock ms when a wallclock-timebase break pinned content; 0 when N/A. */
+    private preRollHoldActive;
+    private preRollHoldHandler;
+    private breakContentGateHandler;
+    private get firstFrameGateActive();
+    private set firstFrameGateActive(value);
+    private get firstFrameGateShown();
+    private set firstFrameGateShown(value);
+    private get firstFrameRejector();
+    private set firstFrameRejector(value);
+    private readonly state;
+    readonly pauseAdPresenter: PauseAdPresenter;
+    private readonly assetParameters;
+    private readonly gamPodBridge;
+    private readonly adStage;
+    private readonly preloader;
+    private readonly assetPlayback;
+    private readonly breakSequenceDriver;
+    private readonly variantSelector;
+    private readonly adPlayerEvents;
+    private get gamEventCallbacks();
+    /** Grace before the live resume releases the scheduler's reload guard — see endBreak(). */
+    private readonly RESUME_GUARD_RELEASE_GRACE_MS;
+    /**
+     * The panel frees the displaced decoder asynchronously; resuming in the same task
+     * intermittently fails with MEDIA_ERR_DECODE on Tizen — see endBreak().
+     */
+    private readonly SINGLE_DECODER_RESUME_DELAY_MS;
+    /** Post-restore progress check — see armSharedRestoreWatchdog(). Mirrors the iOS runtime. */
+    private debug;
+    /**
+     * Early-return state (manifest spec "Break removal"): suppresses the chained hand-off and
+     * overrides the resume point to `break.start + offset`, even in `replacement` mode.
+     */
+    private abortingBreak;
+    private overlayImageEl;
+    private imageAssetTimer;
+    private get preloadedBreakId();
+    private set preloadedBreakId(value);
+    private chainResolver;
+    private transitionPhaseReporter;
+    private chaining;
+    private get vastAdManager();
+    private set vastAdManager(value);
+    /** Runtime pod position IMA reported for the VAST ad whose `adbegin` is about to be emitted. */
+    private vastPodPosition;
+    private diagnoseHandler;
+    /**
+     * One closure releases both the `seeked` listener and its timeout; a leaked timer of
+     * exactly this shape held jest and its container open.
+     */
+    /**
+     * GAM identity the IMA/DAI session was opened under. A pod URL built from a different
+     * identity is rejected by Google (HTTP 410), so {@link buildGamUrl} checks against it.
+     */
+    private playerContainerOriginalStyle;
+    private companionRemoveTimer;
+    private adFadeTimer;
+    private readonly presentationModes;
+    private readonly sharedElementPlayer;
+    private readonly resumeCoordinator;
+    private syncing;
+    private contentVolumeHandler;
+    private adVolumeChangeHandler;
+    private volumeChangeCallback;
+    private stage;
+    private resizeObserver;
+    private contentVideoElement;
+    private contentVideoGeometryHandler;
+    private contentVideoMutationObserver;
+    private preloadMode;
+    private insertionMode;
+    /**
+     * Manifest-spec platform-capability fallback: on handheld/tablet web a `double` break renders
+     * as a single fullscreen ad, while the reported format stays `double`.
+     */
+    private readonly singleSurfaceDevice;
+    /** Declared format of the selected variant, latched at break start (selection never re-runs mid-break). */
+    private currentSelectedFormat;
+    private get currentBreak();
+    private set currentBreak(value);
+    private get currentAsset();
+    private set currentAsset(value);
+    private get callbacks();
+    private set callbacks(value);
+    private get isPlaying();
+    private set isPlaying(value);
+    private get effectiveBreakDurationSec();
+    private set effectiveBreakDurationSec(value);
+    private get adBreakCutSafetyMarginSec();
+    private set adBreakCutSafetyMarginSec(value);
+    private get durationTimer();
+    private set durationTimer(value);
+    private get adInsertionType();
+    private set adInsertionType(value);
+    private get breakTimebase();
+    private set breakTimebase(value);
+    /**
+     * Anchor the resume offset is added to. Anchoring here rather than on `Break.start` keeps the
+     * rule timebase-free: on wallclock, `start` is an ISO timestamp.
+     */
+    private readonly clock;
+    /**
+     * The SDK's own ad player bound to the content element for a shared-element break. Leaving
+     * the swap to the content engine loses the Safari PiP window (Shaka's `load()` detaches the
+     * element); replacing the source ourselves keeps it. Null when `createAdAdapter` ignores the
+     * element argument, in which case the `contentPlayer.load()` path still runs.
+     */
+    /** Whichever adapter carries the running shared-element ad — the SDK's, or the content's. */
+    /**
+     * Bounds how long a shared-element ad may sit at zero frames after `play()` resolved;
+     * without it a never-started ad produced no `adbegin`, error or diagnostic.
+     */
+    /**
+     * Set when the content element is claimed for an ad. The ad's listeners are armed only after
+     * the media swap resolves, so this covers the window in which a PiP entry would otherwise
+     * load the same creative onto the same element twice.
+     */
+    /** Seconds behind the live edge when the ad took the element; null for VOD. */
+    /**
+     * THEOplayer replaces its own `<video>` on a source change; resolving the element fresh at
+     * teardown would unbind from the new node and leave listeners on the dead one.
+     */
+    /** True while the PiP window has been moved to the ad element by this controller. */
+    /**
+     * Set at break start or by a mid-break switch, cleared per break. Leaving PiP mid-break does
+     * not undo it: re-boxing a rolling creative would re-fetch a skipped companion and un-pause content.
+     */
+    private doubleBoxAudio;
+    private audioFocus;
+    constructor(contentPlayer: PlayerAdapter, container: HTMLElement, playerContainer: HTMLElement | undefined, createAdAdapter: CreateAdAdapter, debug?: boolean, gamConfig?: GamConfig, preloadMode?: ResolvedPreloadMode, insertionMode?: ResolvedInsertionMode, adBreakCutSafetyMarginSec?: number, doubleBoxAudio?: DoubleBoxAudio, singleSurfaceDevice?: boolean, 
+    /** Injected so drift correction is deterministic under fake timers; reuses the scheduler's `Clock`. */
+    clock?: Clock);
+    setGamEventCallbacks(callbacks: GamEventCallbacks): void;
+    setDiagnoseHandler(fn: (code: string, message: string, context?: Record<string, unknown>) => void): void;
+    private diagnose;
+    /**
+     * Pause content while an immediate (delay:0) pre-roll is pending and re-pause on any `playing`
+     * until {@link releaseContentHold}. Only for formats that fully cover content. Idempotent.
+     */
+    holdContentForPreRoll(breakInfo: Break): void;
+    /** Detach the pre-roll re-pause listener; the break then owns the content pause/resume. Idempotent. */
+    releaseContentHold(): void;
+    /**
+     * Re-pause content on any `playing` while `contentPaused`, so a late app `play()` or a
+     * buffer auto-resume cannot leak content frames behind the overlay. Idempotent.
+     */
+    private gateContentForBreak;
+    private clearContentGate;
+    /** `null` disables chaining: breaks then always hard-end regardless of how close the next one is. */
+    setChainResolver(resolver: ((currentBreakId: string) => Break | null) | null): void;
+    /** Only wired by the SDK in debug mode, so production reports keep their shape. */
+    setTransitionPhaseReporter(reporter: ((name: string) => void) | null): void;
+    /** No-op when no reporter is wired or no transition is in flight. */
+    private reportPhase;
+    /**
+     * `insertionType` is `undefined` when the integrator did not set one; do not substitute a
+     * default, or the manifest can never drive the resume point.
+     */
+    setBreakResumePolicy(insertionType: AdInsertionType | undefined, timebase: Timebase, continueContentDuringBreak?: boolean): void;
+    /** One-time setup: creates the ad <video>, calls createAdAdapter and mounts the overlay container. */
+    initialize(): void;
+    /**
+     * Creates a fresh IMA session; call once the break manifest has been fetched (the identity
+     * comes from its `vendorConfiguration`). The manifest layer is per asset and applied in {@link buildGamUrl}.
+     */
+    startGamSession(identity: GamSessionIdentity, assetParameters?: Record<string, string>): Promise<void>;
+    endGamSession(): void;
+    /**
+     * Record the session layer of the asset parameters (`SessionConfig.assetParameters`) for the
+     * VAST path, which needs no vendor session to consume it.
+     */
+    setSessionAssetParameters(params: Record<string, string> | undefined): void;
+    setManifestAssetParameters(params: Record<string, string> | undefined): void;
+    /**
+     * Replace the live-update layer of the asset parameters for future breaks: VAST tag URLs
+     * re-resolve the layers per asset, and an active IMA session gets the new map pushed right
+     * away. Stored as well as pushed: each later asset re-resolves the three layers, so a
+     * mid-break update applies from the next asset on.
+     */
+    updateAssetParameters(params: Record<string, string>): void;
+    /** The live-update layer last set by {@link updateAssetParameters}; `endGamSession()` clears it. */
+    get updatedAssetParameters(): Record<string, string> | undefined;
+    /** Record the session's customer macros (`SessionConfig.assetParameterMacros`). */
+    setSessionAssetParameterMacros(macros: AssetParameterMacros | undefined): void;
+    private buildVastTagUrl;
+    private pushAssetParameters;
+    private setupOverlay;
+    /** Always creates a fresh IMA session. */
+    private isGamPodAsset;
+    private isExpandingPodAsset;
+    private beginGamPodTracking;
+    private fallBackToPodLevelReporting;
+    private resetGamPodTracking;
+    private emitGamPodSteps;
+    /**
+     * True unless a host opted out with `gam: { enabled: false }`. Not gated on a GamConfig: the
+     * runtime links IMA unconditionally, and requiring one made React Native hosts skip GAM silently.
+     */
+    isGamEnabled(): boolean;
+    isGamReady(): boolean;
+    /** Used by the SDK to decide whether `adbreakbegin` can be first-frame gated. */
+    isOverlayInsertion(): boolean;
+    /**
+     * Used by both insertion paths; on the shared-element path the ad plays through the content
+     * element, and `adbreakstatus.breakRemainingSec` is driven by this same callback.
+     */
+    /** A still image has no media timeline, so it contributes its declared duration instead. */
+    private settleAssetProgress;
+    private reportAdProgress;
+    private setupEventListeners;
+    preload(breakInfo: Break): Promise<void>;
+    private renderLshapeContentBackdrop;
+    /**
+     * `adaptive` (iPhone iOS 17.1+/MMS) maps to `shared-element` while the content video is in
+     * OS-native fullscreen (DOM overlays cannot render there) and to `overlay` otherwise.
+     */
+    /**
+     * Public because the mechanism changes what an observer sees: with `shared-element` the ad
+     * is the content element, so content position keeps advancing and the PiP window stays `content`.
+     */
+    currentInsertionMode(): 'overlay' | 'shared-element';
+    private effectiveInsertionMode;
+    private isContentPictureInPicture;
+    /**
+     * THEOplayer replaces its media element on a source change, which the SDK causes on every
+     * shared-element break; listeners left on the old node never see PiP transitions again.
+     * PiP state is re-read from the new element rather than reset.
+     */
+    private rebindContentElementIfSwapped;
+    private teardownFullscreenTracking;
+    /** Remove the listeners registered by setupPictureInPictureTracking(). */
+    private teardownPictureInPictureTracking;
+    /** Public answer behind `OptiViewAds.getPresentationState()`, so integrators never infer it from the DOM. */
+    isPictureInPicture(): boolean;
+    /**
+     * Distinct from {@link isShowingAd}, which is about the media: only this tells a harness the
+     * viewer is looking at content while the ad plays (Safari refuses the hand-over silently).
+     */
+    pictureInPictureOwner(): 'content' | 'ad' | null;
+    /**
+     * Differs from {@link isAdPlaying} for an `lshape_content` break in picture-in-picture: active,
+     * yet showing only the main content. Mirrors the Kotlin `AdRenderer.isShowingAd`.
+     */
+    isShowingAd(): boolean;
+    /** Latched at break start: a PiP entry after start must not flip which variant is reasoned about. */
+    private currentDeclaredFormat;
+    playBreak(breakInfo: Break, callbacks: AdPlayerCallbacks, options?: PlayBreakOptions): Promise<void>;
+    /** Read from the element's seekable range, the one place MSE and native playback agree on the edge. */
+    /**
+     * Latest position the engine will hold on live content, or null when unknown and on VOD.
+     * Seeking past the engine's minimum live offset is quietly pulled back, so the resume target
+     * is clamped to it. Liveness is `!Number.isFinite(duration)` of the content, not the break's
+     * timebase (ID3/Anvato breaks are PTS). `null` from the adapter means no clamp: a guessed
+     * holdback would be wrong on any stream whose segments are not 6s.
+     */
+    /** Read from the element's seekable range, the same source {@link liveEdgeDistanceSec} trusts. */
+    /**
+     * `Number.isFinite` is not enough: MAX_SAFE_INTEGER passes it. Anything a day beyond the
+     * playhead is a sentinel, not a DVR window.
+     */
+    /**
+     * Move the paused content player onto its resume point while the ad plays, as soon as the
+     * live window reaches it. A single seek at `adbreakend` targets a position that may not
+     * exist yet on live and gets refused; THEOads does the same
+     * (`PlayerController.seekContentToResumePoint`). No-op on VOD or once positioned.
+     */
+    /**
+     * Let content play (muted, behind the ad) for the last stretch so it arrives at its resume
+     * point instead of being seeked there: a paused player starves its playlist refresh, a
+     * playing one pulls segments aggressively. Started only when the remaining ad time covers
+     * the gap; overshoot is bounded by one ad tick. Live only.
+     */
+    /**
+     * Idempotent. `keepPlaying` at break end avoids the decoder's start-up (~450ms) of a pause
+     * and play() on the right frame; on abort/teardown content must stop.
+     */
+    /** True while content is playing behind the ad, so the resume can hand over without a stop. */
+    private get resumeHandoverInMotion();
+    /**
+     * Computed from the declared length because `adSecondsPlayedThisBreak` is still growing
+     * mid-break (THEOads pre-seeks to a `plannedResumeTime` too). {@link applyResumeSeek}
+     * corrects at break end if the two differ by more than a frame.
+     */
+    /** Attached to both the pre-positioned and the clamped path, since which one fires is the outcome to explain. */
+    /** Release an armed resume-landing probe, if any. Safe to call repeatedly. */
+    /**
+     * Report where the resume-seek landed, as distinct from where it was aimed. Report-only.
+     * The listener is attached before the seek and reads `currentTime` in the handler, because
+     * playback resumes right after. Timeout is a normal outcome (`landed: null`): a seek to the
+     * current position fires no `seeked` on several engines.
+     */
+    /** Gives up rather than hanging: a missed seek leaves the viewer at the live edge. */
+    private reapplyAdContainerLayout;
+    /**
+     * Entering PiP while an ad is already on screen hands the window straight to the ad;
+     * otherwise the window shows the paused content element while the ad plays on the page.
+     * Fire-and-forget (runs from a DOM event handler); a refused transfer is diagnosed inside.
+     */
+    private adoptPictureInPictureMidBreak;
+    /** Only when we took it: a viewer who opened PiP on the ad or closed the window must not have one forced back open. */
+    private restorePictureInPictureToContent;
+    private continueContentDuringBreakReason;
+    private shouldPauseContent;
+    private selectionInputs;
+    /**
+     * The SDK's pre-`adbreakbegin` gate: a non-null reason means no adbreakbegin/adbreakend,
+     * aderror + DA-BREAK-NO-PLAYABLE-ASSET instead, and content keeps playing.
+     */
+    breakNothingToPlayReason(breakInfo: Break): NoPlayableAssetReason | null;
+    /**
+     * Raw `format` strings of variants skipped as unrecognised; `''` means absent. Read at the
+     * break-start gates only, because selection runs several times per break.
+     */
+    unknownVariantFormatsOf(breakInfo: Break): string[];
+    /** Called from the break-start gates; a break with nothing unknown emits nothing. */
+    diagnoseUnknownVariantFormats(breakInfo: Break): void;
+    /** What the public events report as "declared" before any PiP mapping. */
+    declaredFormatOf(breakInfo: Break): BreakFormat | undefined;
+    private getVariant;
+    private applyLayout;
+    /**
+     * For double/lshape_ad/lshape_content, playerContainer keeps its break-time z-index (101)
+     * during the transition so it stays above the still-fading adContainer (z:100) and companion
+     * (z:99); otherwise the backdrop cuts to black instead of content growing back.
+     */
+    private restoreLayout;
+    /**
+     * Selection-aware: without the inputs, a device-targeted variant's assets would read as empty
+     * on exactly the device it targets.
+     */
+    private getAssets;
+    private playAsset;
+    private clearOverlayImage;
+    showPauseImage(resolution: PauseAdResolution): Promise<void>;
+    /** A video creative is stopped immediately so it does not keep playing under the fade. */
+    hidePauseImage(): void;
+    private drive;
+    private emitStep;
+    private resolveAssetUri;
+    /** Null (with a warning) if GAM is not configured. */
+    private buildGamUrl;
+    private resolveUri;
+    private adPlayerStreamRemainingSec;
+    private onAdEnded;
+    private toAdError;
+    private onAdError;
+    private endBreak;
+    /** Exposed so `clickAd()` can name the creative the viewer actually clicked. */
+    currentAdAsset(): Asset | null;
+    /**
+     * Same path as the break-cut timer: the sequencer's `break-elapsed` emits the in-flight ad's
+     * `adend` before `adbreakend`, so a skipped break is indistinguishable in the event stream
+     * (e2e G3). Gating is the caller's job: `OptiViewAds.skipAd()` owns `controls.skipOffset`.
+     */
+    skipBreak(): void;
+    /**
+     * The manifest spec's "early return": same sequencer-driven teardown as {@link skipBreak}, but
+     * content resumes at `break.start + resumeOffsetSec` (forcing the seek even in `replacement`
+     * mode, since the rest of the replaced window no longer exists) and chaining is suppressed
+     * (the successor is anchored to the removed break's scheduled end). Live needs no override:
+     * `restoreLiveLatency` gives back exactly the elapsed wall time.
+     */
+    abortBreak(resumeOffsetSec: number): void;
+    /**
+     * Pausing the ad media is what stops its audio — removing the overlay from the DOM does not
+     * reliably stop a playing element. Unlike {@link endBreak} it does not resume content: the
+     * caller owns the content lifecycle once the session is ending. No-op when idle.
+     */
+    stopActiveBreak(): void;
+    private resolveChainedSuccessor;
+    private advanceToChainedBreak;
+    /**
+     * Warms the HTTP cache (and a detached prefetch if the adapter supports it) without attaching
+     * a second MediaSource — safe on single-decoder Smart TVs. GAM successors are skipped: their
+     * pod URLs carry per-break targeting that must be requested fresh.
+     */
+    private preloadChainedSuccessor;
+    private revealFirstFrame;
+    /**
+     * Resolves `true` on success, `false` past the budget (then `aderror` was already raised and
+     * the caller must stop); a rejecting load is rethrown into `playAsset`'s catch. Needed because
+     * a host that never answers leaves `load()` pending, so `waitForFirstFrame()` is never armed.
+     * `onAdError` is called rather than thrown: `playAsset`'s catch swallows errors while
+     * `firstFrameGateActive && firstFrameResolver === null`, which is the default before the wait is armed.
+     */
+    private armAdStartBudget;
+    private remainingAdStartBudgetMs;
+    private loadWithinBudget;
+    /** Resolves on the first `playing` event, rejects on error/timeout. */
+    private waitForFirstFrame;
+    /** Called when the break ends before the first frame arrives. */
+    private clearFirstFrame;
+    private show;
+    private hide;
+    isAdPlaying(): boolean;
+    /**
+     * Reads/writes the effective audio owner — the ad player during a break, content otherwise.
+     * The `volumechange` sync mirrors onto the other side; a CSAI ad is bridged via
+     * {@link VastAdManager.setMuted} (IMA manages its own audio path). With an active
+     * {@link audioFocus} only the focused side is targeted.
+     */
+    get muted(): boolean;
+    set muted(value: boolean);
+    /** 0-1. See {@link muted} for which player is the effective target. */
+    get volume(): number;
+    set volume(value: number);
+    /** Invoked with the current {@link muted}/{@link volume} whenever either changes. Pass `null` to detach. */
+    setVolumeChangeCallback(callback: ((muted: boolean, volume: number) => void) | null): void;
+    private notifyVolumeChange;
+    destroy(): void;
+    private log;
+}

package/dist/services/AdPlayerController.js

@@ -0,0 +1 @@
+import{BreakFormat as e,Timebase as t,isPostRollBreak as r}from"../types/BreakManifest";import{DEFAULT_AD_BREAK_CUT_SAFETY_MARGIN_SEC as a,DEFAULT_DOUBLE_BOX_AUDIO as i}from"../types/OptiViewAdsConfig";import{pipOverridesFormat as s,pipSuppressesBackdrop as n}from"./pictureInPicture";import{AdBreakSequencer as o,assetsOfVariant as l,resolveBreakFormat as d}from"./AdBreakSequencer";import{selectVariantDetailed as h}from"./selectVariant";import{debugLog as u}from"../diagnostics/debugLog";import{systemClock as c}from"./BreakScheduler";import{createAdPlayerState as m}from"./adPlayer/AdPlayerState";import{PauseAdPresenter as g}from"./adPlayer/PauseAdPresenter";import{AssetParameterResolver as P}from"./adPlayer/AssetParameterResolver";import{GamPodBridge as y}from"./adPlayer/GamPodBridge";import{AdStage as p}from"./adPlayer/AdStage";import{AdPreloader as A}from"./adPlayer/AdPreloader";import{PresentationModeTracker as C}from"./adPlayer/PresentationModeTracker";import{SharedElementBreakPlayer as v}from"./adPlayer/SharedElementBreakPlayer";import{ContentResumeCoordinator as k}from"./adPlayer/ContentResumeCoordinator";import{AssetPlayback as f}from"./adPlayer/AssetPlayback";import{BreakSequenceDriver as S}from"./adPlayer/BreakSequenceDriver";import{VariantSelector as B}from"./adPlayer/VariantSelector";import{AdPlayerEvents as E}from"./adPlayer/AdPlayerEvents";export class AdPlayerController{get contentPaused(){return this.state.contentPaused}set contentPaused(e){this.state.contentPaused=e}get firstFrameGateActive(){return this.state.firstFrameGateActive}set firstFrameGateActive(e){this.state.firstFrameGateActive=e}get firstFrameGateShown(){return this.state.firstFrameGateShown}set firstFrameGateShown(e){this.state.firstFrameGateShown=e}get firstFrameRejector(){return this.state.firstFrameRejector}set firstFrameRejector(e){this.state.firstFrameRejector=e}get gamEventCallbacks(){return this.gamPodBridge.eventCallbacks}get preloadedBreakId(){return this.state.preloadedBreakId}set preloadedBreakId(e){this.state.preloadedBreakId=e}get vastAdManager(){return this.state.vastAdManager}set vastAdManager(e){this.state.vastAdManager=e}get currentBreak(){return this.state.currentBreak}set currentBreak(e){this.state.currentBreak=e}get currentAsset(){return this.state.currentAsset}set currentAsset(e){this.state.currentAsset=e}get callbacks(){return this.state.callbacks}set callbacks(e){this.state.callbacks=e}get isPlaying(){return this.state.isPlaying}set isPlaying(e){this.state.isPlaying=e}get effectiveBreakDurationSec(){return this.state.effectiveBreakDurationSec}set effectiveBreakDurationSec(e){this.state.effectiveBreakDurationSec=e}get adBreakCutSafetyMarginSec(){return this.state.adBreakCutSafetyMarginSec}set adBreakCutSafetyMarginSec(e){this.state.adBreakCutSafetyMarginSec=e}get durationTimer(){return this.state.durationTimer}set durationTimer(e){this.state.durationTimer=e}get adInsertionType(){return this.state.adInsertionType}set adInsertionType(e){this.state.adInsertionType=e}get breakTimebase(){return this.state.breakTimebase}set breakTimebase(e){this.state.breakTimebase=e}constructor(e,t,r,s,n=!1,o,l="parallel",d="overlay",h=a,u=i,b=!1,T=c){this.playerContainerCreatedBySDK=!1,this.adMediaContainer=null,this.adPlayer=null,this.adContainer=null,this.companionElement=null,this.staticQuartilesFired=new Set,this.sequencer=null,this.pendingAdError=null,this.preRollHoldActive=!1,this.preRollHoldHandler=null,this.breakContentGateHandler=null,this.RESUME_GUARD_RELEASE_GRACE_MS=2e3,this.SINGLE_DECODER_RESUME_DELAY_MS=300,this.abortingBreak=!1,this.overlayImageEl=null,this.imageAssetTimer=null,this.chainResolver=null,this.transitionPhaseReporter=null,this.chaining=!1,this.diagnoseHandler=null,this.playerContainerOriginalStyle="",this.companionRemoveTimer=null,this.adFadeTimer=null,this.syncing=!1,this.contentVolumeHandler=null,this.adVolumeChangeHandler=null,this.volumeChangeCallback=null,this.stage=null,this.resizeObserver=null,this.contentVideoElement=null,this.contentVideoGeometryHandler=null,this.contentVideoMutationObserver=null,this.singleSurfaceDevice=!1,this.currentSelectedFormat=void 0,this.audioFocus=null,this.state=m(),this.state.playerContainer=r??null,this.clock=T,this.singleSurfaceDevice=b,this.contentPlayer=e,this.adBreakCutSafetyMarginSec=h,this.doubleBoxAudio=u,this.container=t,r&&(this.playerContainer=r),this.createAdAdapter=s,this.debug=n,this.state.gamConfig=o,this.preloadMode=l,this.insertionMode=d,this.pauseAdPresenter=new g({contentPlayer:this.contentPlayer,getStage:()=>this.stage,resolveUri:e=>this.resolveUri(e),diagnose:(e,t,r)=>this.diagnose(e,t,r),log:(...e)=>this.log(...e)}),this.assetParameters=new P(this.state,{contentPlayer:this.contentPlayer,container:this.container,getGamStreamManager:()=>this.state.gamStreamManager,getCurrentBreak:()=>this.currentBreak,getEffectiveBreakDuration:()=>this.effectiveBreakDurationSec,diagnose:(e,t,r)=>this.diagnose(e,t,r),log:(...e)=>this.log(...e)}),this.gamPodBridge=new y(this.state,{contentPlayer:this.contentPlayer,debug:this.debug,getAdPlayer:()=>this.adPlayer,getAdContainer:()=>this.adContainer,isSharedElement:()=>"shared-element"===this.effectiveInsertionMode(),getCurrentBreak:()=>this.currentBreak,getCurrentAsset:()=>this.currentAsset,getEffectiveBreakDuration:()=>this.effectiveBreakDurationSec,getAdPlayerStreamRemainingSec:()=>this.adPlayerStreamRemainingSec(),emitStep:e=>this.emitStep(e),emitAdStart:(e,t,r,a,i)=>this.callbacks?.onAdStart(e,t,r,a,i),emitAdEnd:(e,t,r,a,i)=>this.callbacks?.onAdEnd(e,t,r,a,i),onAdEnded:()=>this.onAdEnded(),pushAssetParameters:(e,t)=>this.pushAssetParameters(e,t),resolveSessionAdTagParameters:()=>this.assetParameters.resolveSessionAdTagParameters(),diagnose:(e,t,r)=>this.diagnose(e,t,r),log:(...e)=>this.log(...e)}),this.adStage=new p({contentPlayer:this.contentPlayer,container:this.container,getPlayerContainer:()=>this.playerContainer,setPlayerContainer:e=>{this.playerContainer=e},setPlayerContainerOriginalStyle:e=>{this.playerContainerOriginalStyle=e},onPlayerContainerCreated:()=>{this.playerContainerCreatedBySDK=!0},getStage:()=>this.stage,setStage:e=>{this.stage=e},getContentVideo:()=>this.contentVideoElement,setContentVideo:e=>{this.contentVideoElement=e},getAdContainer:()=>this.adContainer,setAdContainer:e=>{this.adContainer=e},getAdMediaContainer:()=>this.adMediaContainer,setAdMediaContainer:e=>{this.adMediaContainer=e},setAdPlayer:e=>{this.adPlayer=e},createAdAdapter:e=>this.createAdAdapter(e),setupEventListeners:()=>this.setupEventListeners(),resizeVast:()=>this.vastAdManager?.resize(),getVariant:e=>this.getVariant(e),getCurrentBreak:()=>this.currentBreak,resolveUri:e=>this.resolveUri(e),getCompanion:()=>this.companionElement,setCompanion:e=>{this.companionElement=e},getOverlayImage:()=>this.overlayImageEl,setOverlayImage:e=>{this.overlayImageEl=e},getImageAssetTimer:()=>this.imageAssetTimer,setImageAssetTimer:e=>{this.imageAssetTimer=e},isChaining:()=>this.chaining,log:(...e)=>this.log(...e)}),this.preloader=new A({state:this.state,clock:this.clock,adStartBudgetMs:AdPlayerController.AD_START_BUDGET_MS,gamPodAdStartBudgetMs:AdPlayerController.GAM_POD_AD_START_BUDGET_MS,minAdStartBudgetMs:AdPlayerController.MIN_AD_START_BUDGET_MS,debug:this.debug,isPlaying:()=>this.isPlaying,preloadMode:this.preloadMode,effectiveInsertionMode:()=>this.effectiveInsertionMode(),getVariant:e=>this.getVariant(e),getAssets:e=>this.getAssets(e),resolveUri:e=>this.resolveUri(e),resolveAssetUri:(e,t)=>this.resolveAssetUri(e,t),getCompanionVariant:e=>this.getVariant(e),getAdPlayer:()=>this.adPlayer,getAdContainer:()=>this.adContainer,buildVastTagUrl:(e,t)=>this.buildVastTagUrl(e,t),resolveChainedSuccessor:e=>this.resolveChainedSuccessor(e),show:()=>this.show(),reapplyAdContainerLayout:e=>this.reapplyAdContainerLayout(e),getCurrentBreak:()=>this.currentBreak,onBreakVisible:e=>this.callbacks?.onBreakVisible?.(e),onAdError:e=>this.onAdError(e),diagnose:(e,t,r)=>this.diagnose(e,t,r),log:(...e)=>this.log(...e)}),this.presentationModes=new C(this.state,{contentPlayer:this.contentPlayer,getAdPlayer:()=>this.adPlayer,insertionMode:this.insertionMode,getCurrentBreak:()=>this.currentBreak,getCurrentFormat:()=>this.currentSelectedFormat,isSharedElementActive:()=>this.state.sharedAdClaimActive,getVariant:e=>this.getVariant(e),isAdPlaying:()=>this.isAdPlaying(),hasCurrentAsset:()=>null!==this.currentAsset,contentSourceIsReloadable:()=>null!==this.sharedElementPlayer.restorableContentSource(),adoptPictureInPictureMidBreak:()=>this.adoptPictureInPictureMidBreak(),restoreLayout:e=>this.restoreLayout(e),applyLayout:e=>this.applyLayout(e),show:()=>this.show(),playAdThroughContentElement:()=>this.sharedElementPlayer.playAdThroughContentElement(),getContentPositionAtBreakStart:()=>this.state.contentPositionAtBreakStart,setContentPositionAtBreakStart:e=>{this.state.contentPositionAtBreakStart=e},gateContentForBreak:()=>this.gateContentForBreak(),diagnose:(e,t,r)=>this.diagnose(e,t,r),log:(...e)=>this.log(...e)}),this.resumeCoordinator=new k(this.state,{contentPlayer:this.contentPlayer,clock:this.clock,getInsertionMode:()=>this.effectiveInsertionMode(),gateContentForBreak:()=>this.gateContentForBreak(),clearContentGate:e=>this.clearContentGate(e),diagnose:(e,t,r)=>this.diagnose(e,t,r),log:(...e)=>this.log(...e)}),this.sharedElementPlayer=new v(this.state,{contentPlayer:this.contentPlayer,getAdPlayer:()=>this.adPlayer,resolveAssetUri:(e,t)=>this.resolveAssetUri(e,t),liveEdgeDistanceSec:()=>this.resumeCoordinator.liveEdgeDistanceSec(),rebindContentElementIfSwapped:()=>this.rebindContentElementIfSwapped(),createAdAdapter:(e,t)=>this.createAdAdapter(e,t),reportAdProgress:e=>this.reportAdProgress(e),diagnose:(e,t,r)=>this.diagnose(e,t,r),log:(...e)=>this.log(...e),clearContentGate:()=>this.clearContentGate(),hide:()=>this.hide(),waitForLiveEdge:()=>this.resumeCoordinator.waitForLiveEdge(),getVariant:e=>this.getVariant(e),getAssets:e=>this.getAssets(e)}),this.variantSelector=new B(this.state,{getEffectiveInsertionMode:()=>this.effectiveInsertionMode(),singleSurfaceDevice:this.singleSurfaceDevice,preloadMode:this.preloadMode,getIsContentPictureInPicture:()=>this.isContentPictureInPicture(),getIsGamReady:()=>this.isGamReady(),getSupportsParallelBuffering:()=>this.contentPlayer.supportsParallelBuffering,diagnose:(e,t,r)=>this.diagnose(e,t,r)}),this.assetPlayback=new f(this.state,{getAdPlayer:()=>this.adPlayer,getAdContainer:()=>this.adContainer,getAdMediaContainer:()=>this.adMediaContainer,clearStaticQuartiles:()=>this.staticQuartilesFired.clear(),getVariant:e=>this.getVariant(e),getGamEventCallbacks:()=>this.gamEventCallbacks,getSequencer:()=>this.sequencer,debug:this.debug,resolveUri:e=>this.resolveUri(e),buildGamUrl:(e,t)=>this.buildGamUrl(e,t),buildVastTagUrl:(e,t)=>this.buildVastTagUrl(e,t),onAdError:e=>this.onAdError(e),onAdEnded:()=>this.onAdEnded(),drive:e=>this.drive(e),clearOverlayImage:()=>this.clearOverlayImage(),revealFirstFrame:()=>this.preloader.revealFirstFrame(),transferPictureInPictureToAd:()=>this.presentationModes.transferPictureInPictureToAd(),isGamPodAsset:e=>this.isGamPodAsset(e),beginGamPodTracking:e=>this.beginGamPodTracking(e),recordAdProgress:e=>this.adPlayerEvents.recordAdProgress(e),reportPhase:e=>this.reportPhase(e),armAdStartBudget:e=>this.armAdStartBudget(e),remainingAdStartBudgetMs:()=>this.remainingAdStartBudgetMs(),loadWithinBudget:e=>this.loadWithinBudget(e),waitForFirstFrame:()=>this.waitForFirstFrame(),getOverlayImage:()=>this.overlayImageEl,setOverlayImage:e=>{this.overlayImageEl=e},getImageAssetTimer:()=>this.imageAssetTimer,setImageAssetTimer:e=>{this.imageAssetTimer=e},getVastPodPosition:()=>this.vastPodPosition,setVastPodPosition:e=>{this.vastPodPosition=e},diagnose:(e,t,r)=>this.diagnose(e,t,r),log:(...e)=>this.log(...e)}),this.breakSequenceDriver=new S(this.state,{getChainResolver:()=>this.chainResolver,getEffectiveInsertionMode:()=>this.effectiveInsertionMode(),getVastPodPosition:()=>this.vastPodPosition,setVastPodPosition:e=>{this.vastPodPosition=e},getPendingAdError:()=>this.pendingAdError,setPendingAdError:e=>{this.pendingAdError=e},getChaining:()=>this.chaining,setChaining:e=>{this.chaining=e},isExpandingPodAsset:e=>this.isExpandingPodAsset(e),fallBackToPodLevelReporting:()=>this.fallBackToPodLevelReporting(),resetGamPodTracking:()=>this.resetGamPodTracking(),emitGamPodSteps:e=>this.gamPodBridge.emitGamPodSteps(e),playAsset:(e,t,r)=>this.playAsset(e,t,r),endBreak:()=>this.endBreak(),playBreak:(e,t,r)=>this.playBreak(e,t,r),diagnose:(e,t,r)=>this.diagnose(e,t,r),log:(...e)=>this.log(...e)}),this.adPlayerEvents=new E(this.state,{getAdPlayer:()=>this.adPlayer,getContentPlayer:()=>this.contentPlayer,getGamEventCallbacks:()=>this.gamEventCallbacks,getSequencer:()=>this.sequencer,getAudioFocus:()=>this.audioFocus,getSyncing:()=>this.syncing,setSyncing:e=>{this.syncing=e},setAdVolumeChangeHandler:e=>{this.adVolumeChangeHandler=e},setContentVolumeHandler:e=>{this.contentVolumeHandler=e},notifyVolumeChange:()=>this.notifyVolumeChange(),onAdEnded:()=>this.onAdEnded(),processTimedMetadata:e=>this.gamPodBridge.processTimedMetadata(e),toAdError:e=>this.toAdError(e),revealFirstFrame:()=>this.revealFirstFrame(),clearFirstFrameResolver:()=>this.preloader.clearFirstFrameResolver(),drive:e=>this.drive(e),setPendingAdError:e=>{this.pendingAdError=e},log:(...e)=>this.log(...e),maybePrepositionContentForResume:()=>this.resumeCoordinator.maybePrepositionContentForResume(),maybeCatchUpContentForResume:e=>this.resumeCoordinator.maybeCatchUpContentForResume(e),getStaticQuartilesFired:()=>this.staticQuartilesFired})}setGamEventCallbacks(e){this.gamPodBridge.setEventCallbacks(e)}setDiagnoseHandler(e){this.diagnoseHandler=e}diagnose(e,t,r){this.diagnoseHandler?.(e,t,r)}holdContentForPreRoll(e){if(this.preRollHoldActive)return;const t=this.getVariant(e);t&&this.shouldPauseContent(t.format)&&(this.preRollHoldActive=!0,this.contentPlayer.pause(),this.preRollHoldHandler=()=>{this.preRollHoldActive&&this.contentPlayer.pause()},this.contentPlayer.on("playing",this.preRollHoldHandler),this.diagnose("DA-PREROLL-CONTENT-HELD","Content held at session start until the pending pre-roll begins.",{breakId:e.id}))}releaseContentHold(){this.preRollHoldActive&&(this.preRollHoldActive=!1,this.preRollHoldHandler&&(this.contentPlayer.off("playing",this.preRollHoldHandler),this.preRollHoldHandler=null))}gateContentForBreak(){this.contentPlayer.pause(),this.breakContentGateHandler||(this.breakContentGateHandler=()=>{this.contentPaused&&!this.state.resumeCatchupActive&&this.contentPlayer.pause()},this.contentPlayer.on("playing",this.breakContentGateHandler))}clearContentGate(e=!1){this.resumeCoordinator.endResumeCatchup(e),this.breakContentGateHandler&&(this.contentPlayer.off("playing",this.breakContentGateHandler),this.breakContentGateHandler=null)}setChainResolver(e){this.chainResolver=e}setTransitionPhaseReporter(e){this.transitionPhaseReporter=e}reportPhase(e){this.transitionPhaseReporter?.(e)}setBreakResumePolicy(e,t,r=!1){this.adInsertionType=e,this.breakTimebase=t,this.state.continueContentDuringBreak=r,this.state.continueRefusalReported=!1}initialize(){this.adContainer||(this.setupOverlay(),this.presentationModes.setupPictureInPictureTracking(),"adaptive"===this.insertionMode&&this.presentationModes.setupFullscreenTracking())}async startGamSession(e,t){await this.gamPodBridge.startGamSession(e,t)}endGamSession(){this.gamPodBridge.endGamSession()}setSessionAssetParameters(e){this.assetParameters.setSessionAssetParameters(e)}setManifestAssetParameters(e){this.assetParameters.setManifestAssetParameters(e)}updateAssetParameters(e){this.assetParameters.updateAssetParameters(e)}get updatedAssetParameters(){return this.state.updatedAssetParameters}setSessionAssetParameterMacros(e){this.assetParameters.setSessionAssetParameterMacros(e)}buildVastTagUrl(e,t){return this.assetParameters.buildVastTagUrl(e,t)}pushAssetParameters(e,t){this.assetParameters.pushAssetParameters(e,t)}setupOverlay(){this.adStage.setupOverlay()}isGamPodAsset(e){return this.gamPodBridge.isGamPodAsset(e)}isExpandingPodAsset(e){return this.gamPodBridge.isExpandingPodAsset(e)}beginGamPodTracking(e){this.gamPodBridge.beginGamPodTracking(e)}fallBackToPodLevelReporting(){this.gamPodBridge.fallBackToPodLevelReporting()}resetGamPodTracking(){this.gamPodBridge.resetGamPodTracking()}emitGamPodSteps(e){this.gamPodBridge.emitGamPodSteps(e)}isGamEnabled(){return this.gamPodBridge.isGamEnabled()}isGamReady(){return this.gamPodBridge.isGamReady()}isOverlayInsertion(){return"overlay"===this.effectiveInsertionMode()}settleAssetProgress(){this.adPlayerEvents.settleAssetProgress()}reportAdProgress(e){this.adPlayerEvents.reportAdProgress(e)}setupEventListeners(){this.adPlayerEvents.setupEventListeners()}async preload(e){return this.preloader.preload(e)}renderLshapeContentBackdrop(e){this.adStage.renderLshapeContentBackdrop(e)}currentInsertionMode(){return this.presentationModes.currentInsertionMode()}effectiveInsertionMode(){return this.presentationModes.effectiveInsertionMode()}isContentPictureInPicture(){return this.presentationModes.isPictureInPicture()}rebindContentElementIfSwapped(){this.presentationModes.rebindContentElementIfSwapped()}teardownFullscreenTracking(){this.presentationModes.teardownFullscreenTracking()}teardownPictureInPictureTracking(){this.presentationModes.teardownPictureInPictureTracking()}isPictureInPicture(){return this.presentationModes.isPictureInPicture()}pictureInPictureOwner(){return this.presentationModes.pictureInPictureOwner()}isShowingAd(){if(!this.isAdPlaying())return!1;const e=this.currentDeclaredFormat();return!n(e,this.isContentPictureInPicture())}currentDeclaredFormat(){return this.currentSelectedFormat??(this.currentBreak?d(this.currentBreak):void 0)}async playBreak(t,a,i){this.releaseContentHold(),this.rebindContentElementIfSwapped(),this.sharedElementPlayer.clearSharedRestoreWatchdog();const n=i?.effectiveDurationSec??null;this.effectiveBreakDurationSec=null!==n&&n>0?n:null;const l=this.effectiveBreakDurationSec??t.duration;if("shared-element"===this.effectiveInsertionMode())return void await this.sharedElementPlayer.playSharedElementBreak(t,a);if(!this.adPlayer)return void this.log("playBreak called before initialize()");const d=this.getVariant(t);if(!d)return void this.log("No valid variant found for break:",t.id);this.currentBreak=t,this.callbacks=a,this.isPlaying=!0,this.firstFrameGateActive=i?.firstFrameGate??!1,this.firstFrameGateShown=!1;const h=this.continueContentDuringBreakReason(d.format),u=r(t),c=this.shouldPauseContent(d.format)&&"ok"===h&&!u;c||u||this.state.continueRefusalReported||!this.shouldPauseContent(d.format)||(this.state.continueRefusalReported=!0,this.diagnose("DA-CONTINUE-PLAYOUT-REFUSED",`Content will be paused for breaks this session: ${h}`,{reason:h,format:d.format})),this.audioFocus=d.format===e.DOUBLE?this.doubleBoxAudio:c?"ad":null,this.adPlayer&&("content"===this.audioFocus?(this.adPlayer.muted=!0,this.adPlayer.volume=0):(this.adPlayer.muted=this.contentPlayer.muted,this.adPlayer.volume=this.contentPlayer.volume,"ad"===this.audioFocus&&(this.contentPlayer.muted=!0)));const m=this.declaredFormatOf(t);if(this.currentSelectedFormat=m,this.state.pipAdoptedForBreak=s(m,this.isContentPictureInPicture()),this.state.pipAdoptedForBreak&&this.diagnose("DA-PIP-FORMAT-OVERRIDE",`Picture-in-picture: ${m} break plays as single`,{declared:m,effective:e.SINGLE,reason:"picture-in-picture",midBreak:!1}),this.shouldPauseContent(d.format)?(this.state.contentPositionAtBreakStart=this.contentPlayer.currentTime,this.resumeCoordinator.resetBreakResumeState(),c?(this.contentPaused=!1,this.resumeCoordinator.beginContinueContentPlayout()):(this.contentPaused=!0,this.gateContentForBreak())):this.contentPaused=!1,this.applyLayout(d),d.format===e.LSHAPE_CONTENT)return this.renderLshapeContentBackdrop(d),void(l&&l>0?(this.log("Starting duration timer:",l,"seconds"),this.durationTimer=setTimeout(()=>{this.log("Duration timer expired, ending break"),this.endBreak()},1e3*l)):this.endBreak());this.firstFrameGateActive||(this.show(),this.reapplyAdContainerLayout(d));if(0===this.getAssets(t).length)return this.log("No assets in break, ending immediately"),void this.endBreak();{const e=Math.max(0,l||0)+this.adBreakCutSafetyMarginSec;this.log("Starting break-cut timer:",e,"seconds"),this.durationTimer=setTimeout(()=>{this.log("Break-cut timer expired, ending break"),this.firstFrameRejector?this.onAdError(new Error("Break cut before first frame rendered")):this.sequencer&&this.currentBreak&&this.isPlaying?this.drive(this.sequencer.onOutcome({kind:"break-elapsed"})):this.endBreak()},1e3*e)}this.sequencer=new o("overlay",()=>null,this.selectionInputs()),await this.drive(this.sequencer.beginBreak(t)),this.preloadChainedSuccessor(t.id)}get resumeHandoverInMotion(){return this.state.resumeCatchupActive}reapplyAdContainerLayout(e){this.adStage.reapplyAdContainerLayout(e)}adoptPictureInPictureMidBreak(){this.presentationModes.adoptPictureInPictureMidBreak()}async restorePictureInPictureToContent(){await this.presentationModes.restorePictureInPictureToContent()}continueContentDuringBreakReason(e){return this.variantSelector.continueContentDuringBreakReason(e)}shouldPauseContent(t){return t===e.SINGLE||t===e.LSHAPE_AD}selectionInputs(){return this.variantSelector.selectionInputs()}breakNothingToPlayReason(e){return this.variantSelector.breakNothingToPlayReason(e)}unknownVariantFormatsOf(e){return this.variantSelector.unknownVariantFormatsOf(e)}diagnoseUnknownVariantFormats(e){this.variantSelector.diagnoseUnknownVariantFormats(e)}declaredFormatOf(e){const{selected:t,deviceQualified:r}=h(e,this.selectionInputs());return(t??r)?.format??d(e)}getVariant(e){return this.variantSelector.getVariant(e)}applyLayout(e){this.adStage.applyLayout(e)}restoreLayout(e){this.adStage.restoreLayout(e)}getAssets(e){return l(this.getVariant(e))}async playAsset(e,t,r){return this.assetPlayback.playAsset(e,t,r)}clearOverlayImage(){this.adStage.clearOverlayImage()}async showPauseImage(e){return this.pauseAdPresenter.showPauseImage(e)}hidePauseImage(){this.pauseAdPresenter.hidePauseImage()}async drive(e){return this.breakSequenceDriver.drive(e)}emitStep(e){this.breakSequenceDriver.emitStep(e)}async resolveAssetUri(e,t){return this.assetPlayback.resolveAssetUri(e,t)}async buildGamUrl(e,t){return this.gamPodBridge.buildGamUrl(e,t)}resolveUri(e){return this.assetParameters.resolveUri(e)}adPlayerStreamRemainingSec(){return this.assetPlayback.adPlayerStreamRemainingSec()}onAdEnded(){this.currentBreak&&this.isPlaying&&this.sequencer&&(this.settleAssetProgress(),this.drive(this.sequencer.onOutcome({kind:"asset-ended"})))}toAdError(e){return this.assetPlayback.toAdError(e)}onAdError(e){this.adPlayerEvents.onAdError(e)}endBreak(){if(!this.currentBreak)return;this.log("Break ended:",this.currentBreak.id),this.durationTimer&&(clearTimeout(this.durationTimer),this.durationTimer=null),this.state.gamPodTracker&&this.emitGamPodSteps(this.state.gamPodTracker.finish()),this.resetGamPodTracking(),this.pushAssetParameters(void 0);const e=this.currentBreak,a=this.getVariant(e)?.format;let i=this.abortingBreak?null:this.resolveChainedSuccessor(e.id);if(i){const e=this.breakNothingToPlayReason(i);this.diagnoseUnknownVariantFormats(i),e&&(this.diagnose("DA-BREAK-NO-PLAYABLE-ASSET",`chained break ${i.id} has no playable variant (${e}); it will not begin.`,{breakId:i.id,reason:e}),this.callbacks?.onAdError(i,void 0,new Error(`Break ${i.id} has no playable variant (${e})`)),this.callbacks?.onChainedBreakSkipped?.(i),i=null)}if(i)this.advanceToChainedBreak(e,i);else{if(this.currentSelectedFormat=void 0,this.resumeCoordinator.endContinueContentPlayout(),this.restorePictureInPictureToContent(),this.isPlaying=!1,this.currentBreak=null,this.effectiveBreakDurationSec=null,this.preloadedBreakId=null,this.preloader.clearWarmedBreaks(),this.firstFrameGateActive=!1,this.firstFrameGateShown=!1,this.clearFirstFrame("Break ended before first frame"),"ad"===this.audioFocus&&this.adPlayer?(this.contentPlayer.muted=this.adPlayer.muted,this.contentPlayer.volume=this.adPlayer.volume):"content"===this.audioFocus&&this.adPlayer&&(this.adPlayer.muted=this.contentPlayer.muted,this.adPlayer.volume=this.contentPlayer.volume),this.audioFocus=null,this.clearOverlayImage(),this.vastAdManager?.reset(),this.hide(),this.restoreLayout(a),this.adPlayer?.pause(),this.state.sharedAdClaimActive)return this.sharedElementPlayer.detachSharedAdListeners(),this.sharedElementPlayer.restoreSharedElementContent(e),this.abortingBreak=!1,this.state.earlyReturnResumeOffsetSec=null,void this.callbacks?.onBreakEnd(e);if("single-decoder"===this.preloadMode&&this.adPlayer?.unload?.(),this.contentPaused&&r(e))this.contentPaused=!1,this.clearContentGate();else if(this.contentPaused){this.contentPaused=!1,this.clearContentGate(this.resumeHandoverInMotion);const r=this.state.earlyReturnResumeOffsetSec,a=this.breakTimebase===t.WALLCLOCK,i=()=>{a&&this.callbacks?.onContentReloading?.(!0),this.resumeCoordinator.applyResumeSeek(e,r),this.contentPlayer.play().catch(e=>{this.log("Content resume failed:",e)}).finally(()=>{a&&setTimeout(()=>this.callbacks?.onContentReloading?.(!1),this.RESUME_GUARD_RELEASE_GRACE_MS)})};"single-decoder"===this.preloadMode?setTimeout(i,this.SINGLE_DECODER_RESUME_DELAY_MS):i()}this.abortingBreak=!1,this.state.earlyReturnResumeOffsetSec=null,this.callbacks?.onBreakEnd(e)}}currentAdAsset(){return this.isPlaying?this.currentAsset:null}skipBreak(){this.isPlaying&&(this.log("Skipping break:",this.currentBreak?.id),this.durationTimer&&(clearTimeout(this.durationTimer),this.durationTimer=null),this.sequencer&&this.currentBreak?this.drive(this.sequencer.onOutcome({kind:"break-elapsed"})):this.endBreak())}abortBreak(e){this.isPlaying&&(this.log("Early return — break removed from manifest:",this.currentBreak?.id),this.state.earlyReturnResumeOffsetSec=Math.max(0,e),this.abortingBreak=!0,this.durationTimer&&(clearTimeout(this.durationTimer),this.durationTimer=null),this.sequencer&&this.currentBreak?this.drive(this.sequencer.onOutcome({kind:"break-elapsed"})):this.endBreak())}stopActiveBreak(){this.isPlaying&&(this.log("Aborting active break on session end:",this.currentBreak?.id),this.durationTimer&&(clearTimeout(this.durationTimer),this.durationTimer=null),this.sharedElementPlayer.detachSharedAdListeners(),this.sharedElementPlayer.releaseContentElementAdPlayer(),this.adPlayer?.pause(),this.clearOverlayImage(),this.vastAdManager?.reset(),this.hide(),this.restoreLayout(this.currentBreak?this.getVariant(this.currentBreak)?.format??void 0:void 0),this.isPlaying=!1,this.currentBreak=null,this.currentAsset=null,this.contentPaused=!1,this.clearContentGate(),this.resumeCoordinator.endContinueContentPlayout(),this.effectiveBreakDurationSec=null,this.firstFrameGateActive=!1,this.firstFrameGateShown=!1,this.clearFirstFrame("Break aborted before first frame"),this.audioFocus=null)}resolveChainedSuccessor(e){return this.breakSequenceDriver.resolveChainedSuccessor(e)}advanceToChainedBreak(e,t){this.breakSequenceDriver.advanceToChainedBreak(e,t)}preloadChainedSuccessor(e){this.preloader.preloadChainedSuccessor(e)}revealFirstFrame(){this.assetPlayback.revealFirstFrame()}armAdStartBudget(e){this.preloader.armAdStartBudget(e)}remainingAdStartBudgetMs(){return this.preloader.remainingAdStartBudgetMs()}loadWithinBudget(e){return this.preloader.loadWithinBudget(e)}async waitForFirstFrame(){return this.preloader.waitForFirstFrame()}clearFirstFrame(e="Break ended before first frame"){this.preloader.clearFirstFrame(e)}show(){this.adStage.show()}hide(){this.adStage.hide()}isAdPlaying(){return this.isPlaying}get muted(){return"content"===this.audioFocus?this.contentPlayer.muted:"ad"===this.audioFocus?this.adPlayer?this.adPlayer.muted:this.contentPlayer.muted:this.isPlaying&&this.adPlayer?this.adPlayer.muted:this.contentPlayer.muted}set muted(e){if("content"===this.audioFocus)this.contentPlayer.muted=e;else if("ad"===this.audioFocus)this.adPlayer&&(this.adPlayer.muted=e);else{(this.isPlaying&&this.adPlayer?this.adPlayer:this.contentPlayer).muted=e}this.vastAdManager?.setMuted(e),this.notifyVolumeChange()}get volume(){return"content"===this.audioFocus?this.contentPlayer.volume:"ad"===this.audioFocus?this.adPlayer?this.adPlayer.volume:this.contentPlayer.volume:this.isPlaying&&this.adPlayer?this.adPlayer.volume:this.contentPlayer.volume}set volume(e){if("content"===this.audioFocus)this.contentPlayer.volume=e;else if("ad"===this.audioFocus)this.adPlayer&&(this.adPlayer.volume=e);else{(this.isPlaying&&this.adPlayer?this.adPlayer:this.contentPlayer).volume=e}this.vastAdManager?.setVolume(e),this.notifyVolumeChange()}setVolumeChangeCallback(e){this.volumeChangeCallback=e}notifyVolumeChange(){this.volumeChangeCallback?.(this.muted,this.volume)}destroy(){if(this.adStage.destroy(),this.resumeCoordinator.cancelResumeLandedProbe(),this.resumeCoordinator.endResumeCatchup(),this.resumeCoordinator.endContinueContentPlayout(),this.state.resumePrepositionSettle&&(clearTimeout(this.state.resumePrepositionSettle),this.state.resumePrepositionSettle=null),this.sharedElementPlayer.clearSharedRestoreWatchdog(),this.releaseContentHold(),this.clearContentGate(),this.clearFirstFrame("Controller destroyed before first frame"),this.firstFrameGateActive=!1,this.firstFrameGateShown=!1,this.resetGamPodTracking(),this.durationTimer&&(clearTimeout(this.durationTimer),this.durationTimer=null),this.companionRemoveTimer&&(clearTimeout(this.companionRemoveTimer),this.companionRemoveTimer=null),this.adFadeTimer&&(clearTimeout(this.adFadeTimer),this.adFadeTimer=null),this.adPlayer?.pause(),this.clearOverlayImage(),this.pauseAdPresenter.destroy(),this.contentVolumeHandler&&(this.contentPlayer.off("volumechange",this.contentVolumeHandler),this.contentVolumeHandler=null),this.sharedElementPlayer.detachSharedAdListeners(),this.sharedElementPlayer.releaseContentElementAdPlayer(),this.state.pipTransferredToAd=!1,this.teardownFullscreenTracking(),this.teardownPictureInPictureTracking(),this.adVolumeChangeHandler&&this.adPlayer&&this.adPlayer.off("volumechange",this.adVolumeChangeHandler),this.adVolumeChangeHandler=null,this.hide(),this.resizeObserver?.disconnect(),this.resizeObserver=null,this.contentVideoMutationObserver?.disconnect(),this.contentVideoMutationObserver=null,this.contentVideoElement&&this.contentVideoGeometryHandler&&(this.contentVideoElement.removeEventListener("loadedmetadata",this.contentVideoGeometryHandler),this.contentVideoElement.removeEventListener("resize",this.contentVideoGeometryHandler)),this.contentVideoElement=null,this.contentVideoGeometryHandler=null,this.playerContainerCreatedBySDK)for(;this.playerContainer.firstChild;)this.container.appendChild(this.playerContainer.firstChild);else this.container.appendChild(this.playerContainer),this.playerContainer.style.cssText=this.playerContainerOriginalStyle;this.companionElement&&this.companionElement.parentElement&&(this.companionElement.parentElement.removeChild(this.companionElement),this.companionElement=null),this.isPlaying=!1,this.currentBreak=null,this.adContainer&&this.adContainer.parentElement&&this.adContainer.parentElement.removeChild(this.adContainer),this.stage&&this.stage.parentElement&&this.stage.parentElement.removeChild(this.stage),this.stage=null,this.adContainer=null,this.adMediaContainer=null;try{this.adPlayer?.destroy()}catch(e){this.log("Ad player adapter destroy failed (ignored):",e)}this.adPlayer=null,this.callbacks=null,this.gamPodBridge.destroy(),this.vastAdManager?.destroy(),this.vastAdManager=null,this.log("Ad player destroyed")}log(...e){this.debug&&u("[OptiViewAds:AdPlayerController]",...e)}}AdPlayerController.AD_START_BUDGET_MS=5e3,AdPlayerController.GAM_POD_AD_START_BUDGET_MS=1e4,AdPlayerController.MIN_AD_START_BUDGET_MS=3e3;