@dolby-optiview/ads-sdk-core 1.2.1 → 1.4.0

package/dist/services/adPlayer/PreparedPresentation.js

@@ -1 +1 @@
-const e="position:absolute;top:0;left:0;right:0;bottom:0;transition:top 0.3s ease-in-out,left 0.3s ease-in-out,right 0.3s ease-in-out,bottom 0.3s ease-in-out,opacity 0.3s ease-in-out;",t=new WeakMap,s=new WeakMap,i=new WeakSet;class PreparedPresentation{constructor(t,s,i){this.owner=t,this.container=s,this.getVideo=i,this.subscribers=new Set,this.token=null,this.disposed=!1,this.geometry="",this.video=null,this.observer=null,this.resizeObserver=null,this.poll=null,this.refresh=()=>{if(this.disposed)return;const e=this.getVideo();e!==this.video&&(this.unbindVideo(),this.video=e,e?.addEventListener("loadedmetadata",this.refresh),e?.addEventListener("resize",this.refresh));const{width:t,height:s}=this.container.getBoundingClientRect();if(!(t>0&&s>0))return;const i=e&&e.videoWidth>0&&e.videoHeight>0?e.videoWidth/e.videoHeight:16/9,r=Math.min(t,s*i),o=r/i,n=`${t}:${s}:${r}:${o}`;if(n!==this.geometry){this.geometry=n,this.stage.style.width=`${r}px`,this.stage.style.height=`${o}px`,this.stage.style.left=(t-r)/2+"px",this.stage.style.top=(s-o)/2+"px";for(const e of this.subscribers)e()}};for(const e of Array.from(s.querySelectorAll("video,audio")))if(e.currentSrc||e.getAttribute("src")||e.srcObject||e.readyState>0||!e.paused)throw new Error("Prepare the ads presentation before loading the content source");this.originalPosition=s.style.position;const r=s.ownerDocument.defaultView?.getComputedStyle(s).position;r&&"static"!==r||(s.style.position="relative"),this.stage=s.ownerDocument.createElement("div"),this.stage.className="dolby-stage",this.stage.style.cssText="position:absolute;overflow:hidden;",this.playerContainer=s.ownerDocument.createElement("div"),this.playerContainer.style.cssText=e;const o=Array.from(s.childNodes);s.appendChild(this.stage),this.stage.appendChild(this.playerContainer);for(const e of o)this.playerContainer.appendChild(e);this.refresh(),"undefined"!=typeof MutationObserver&&(this.observer=new MutationObserver(()=>{this.getVideo()!==this.video&&this.refresh()}),this.observer.observe(s,{childList:!0,subtree:!0})),"undefined"!=typeof ResizeObserver?(this.resizeObserver=new ResizeObserver(this.refresh),this.resizeObserver.observe(s)):this.poll=setInterval(this.refresh,250)}assertAvailable(){if(this.disposed)throw new Error("The content presentation has been disposed");if(this.token)throw new Error("The content player already has an ads presentation owner");if(this.stage.parentNode!==this.container||this.playerContainer.parentNode!==this.stage)throw new Error("The prepared content presentation has been moved")}acquire(){this.assertAvailable();const t={};this.token=t;const s=new Set;return{stage:this.stage,playerContainer:this.playerContainer,subscribe:e=>(this.subscribers.add(e),s.add(e),()=>{this.subscribers.delete(e),s.delete(e)}),isActive:()=>!this.disposed&&this.token===t,release:()=>{for(const e of s)this.subscribers.delete(e);s.clear(),this.disposed||this.token!==t||(this.token=null,this.playerContainer.style.cssText=e)}}}dispose(){this.disposed||(this.disposed=!0,this.observer?.disconnect(),this.resizeObserver?.disconnect(),null!==this.poll&&clearInterval(this.poll),this.poll=null,this.unbindVideo(),this.subscribers.clear(),this.stage.parentNode&&this.stage.parentNode.removeChild(this.stage),s.get(this.container)===this&&(s.delete(this.container),this.container.style.position=this.originalPosition),i.add(this.owner))}unbindVideo(){this.video?.removeEventListener("loadedmetadata",this.refresh),this.video?.removeEventListener("resize",this.refresh),this.video=null}}export function preparePresentation(e,r,o){if(i.has(e))throw new Error("Cannot prepare a disposed content player");const n=t.get(e);if(n){if(n.container!==r)throw new Error("The content player presentation container changed");return n}if(s.has(r))throw new Error("The container belongs to another content player");const a=new PreparedPresentation(e,r,o);return t.set(e,a),s.set(r,a),a}export function getPreparedPresentation(e){return s.get(e)}export function disposePreparedPresentation(e){t.get(e)?.dispose()}
+import{LAYOUT_TRANSITION as e}from"./presentation/LayoutTransform";const t=`position:absolute;top:0;left:0;right:0;bottom:0;transition:${e};`,s=new WeakMap,i=new WeakMap,r=new WeakSet;class PreparedPresentation{constructor(e,s,i){this.owner=e,this.container=s,this.getVideo=i,this.subscribers=new Set,this.token=null,this.disposed=!1,this.geometry="",this.video=null,this.observer=null,this.resizeObserver=null,this.poll=null,this.refresh=()=>{if(this.disposed)return;const e=this.getVideo();e!==this.video&&(this.unbindVideo(),this.video=e,e?.addEventListener("loadedmetadata",this.refresh),e?.addEventListener("resize",this.refresh));const{width:t,height:s}=this.container.getBoundingClientRect();if(!(t>0&&s>0))return;const i=e&&e.videoWidth>0&&e.videoHeight>0?e.videoWidth/e.videoHeight:16/9,r=Math.min(t,s*i),o=r/i,n=`${t}:${s}:${r}:${o}`;if(n!==this.geometry){this.geometry=n,this.stage.style.width=`${r}px`,this.stage.style.height=`${o}px`,this.stage.style.left=(t-r)/2+"px",this.stage.style.top=(s-o)/2+"px";for(const e of this.subscribers)e()}};for(const e of Array.from(s.querySelectorAll("video,audio")))if(e.currentSrc||e.getAttribute("src")||e.srcObject||e.readyState>0||!e.paused)throw new Error("Prepare the ads presentation before loading the content source");this.originalPosition=s.style.position;const r=s.ownerDocument.defaultView?.getComputedStyle(s).position;r&&"static"!==r||(s.style.position="relative"),this.stage=s.ownerDocument.createElement("div"),this.stage.className="dolby-stage",this.stage.style.cssText="position:absolute;overflow:hidden;",this.playerContainer=s.ownerDocument.createElement("div"),this.playerContainer.style.cssText=t;const o=Array.from(s.childNodes);s.appendChild(this.stage),this.stage.appendChild(this.playerContainer);for(const e of o)this.playerContainer.appendChild(e);this.refresh(),"undefined"!=typeof MutationObserver&&(this.observer=new MutationObserver(()=>{this.getVideo()!==this.video&&this.refresh()}),this.observer.observe(s,{childList:!0,subtree:!0})),"undefined"!=typeof ResizeObserver?(this.resizeObserver=new ResizeObserver(this.refresh),this.resizeObserver.observe(s)):this.poll=setInterval(this.refresh,250)}assertAvailable(){if(this.disposed)throw new Error("The content presentation has been disposed");if(this.token)throw new Error("The content player already has an ads presentation owner");if(this.stage.parentNode!==this.container||this.playerContainer.parentNode!==this.stage)throw new Error("The prepared content presentation has been moved")}acquire(){this.assertAvailable();const e={};this.token=e;const s=new Set;return{stage:this.stage,playerContainer:this.playerContainer,subscribe:e=>(this.subscribers.add(e),s.add(e),()=>{this.subscribers.delete(e),s.delete(e)}),isActive:()=>!this.disposed&&this.token===e,release:()=>{for(const e of s)this.subscribers.delete(e);s.clear(),this.disposed||this.token!==e||(this.token=null,this.playerContainer.style.cssText=t)}}}dispose(){this.disposed||(this.disposed=!0,this.observer?.disconnect(),this.resizeObserver?.disconnect(),null!==this.poll&&clearInterval(this.poll),this.poll=null,this.unbindVideo(),this.subscribers.clear(),this.stage.parentNode&&this.stage.parentNode.removeChild(this.stage),i.get(this.container)===this&&(i.delete(this.container),this.container.style.position=this.originalPosition),r.add(this.owner))}unbindVideo(){this.video?.removeEventListener("loadedmetadata",this.refresh),this.video?.removeEventListener("resize",this.refresh),this.video=null}}export function preparePresentation(e,t,o){if(r.has(e))throw new Error("Cannot prepare a disposed content player");const n=s.get(e);if(n){if(n.container!==t)throw new Error("The content player presentation container changed");return n}if(i.has(t))throw new Error("The container belongs to another content player");const a=new PreparedPresentation(e,t,o);return s.set(e,a),i.set(t,a),a}export function getPreparedPresentation(e){return i.get(e)}export function disposePreparedPresentation(e){s.get(e)?.dispose()}

package/dist/services/adPlayer/PresentationModeTracker.d.ts

@@ -13,7 +13,7 @@ export interface PresentationModeTrackerDeps {
     hasCurrentAsset: () => boolean;
     contentSourceIsReloadable: () => boolean;
     adoptPictureInPictureMidBreak: () => void;
-    restoreLayout: (format?: BreakFormat) => void;
+    restoreLayout: () => void;
     applyLayout: (variant: BreakVariant) => void;
     show: () => void;
     playAdThroughContentElement: () => Promise<void>;

package/dist/services/adPlayer/PresentationModeTracker.js

@@ -1 +1 @@
-import{BreakFormat as e}from"../../types/BreakManifest";import{pipOverridesFormat as t,pipSuppressesBackdrop as n}from"../pictureInPicture";export class PresentationModeTracker{constructor(e,t){this.state=e,this.deps=t,this.pipEnterHandler=null,this.pipExitHandler=null,this.pipPresentationModeHandler=null}currentInsertionMode(){return this.deps.isSharedElementActive()?"shared-element":this.effectiveInsertionMode()}effectiveInsertionMode(){return"shared-element"===this.deps.insertionMode||this.isContentPictureInPicture()&&this.deps.contentSourceIsReloadable()&&!this.canReceivePictureInPictureWindow()||"adaptive"===this.deps.insertionMode&&this.isContentFullscreen()?"shared-element":"overlay"}isContentPictureInPicture(){const e=this.deps.getAdPlayer()?.videoElement,t=this.deps.contentPlayer.videoElement;return this.elementHasPictureInPicture(t)||this.elementHasPictureInPicture(e)}elementHasPictureInPicture(e){return!!e&&("picture-in-picture"===e.webkitPresentationMode||"undefined"!=typeof document&&document.pictureInPictureElement===e)}isContentFullscreen(){const e=this.deps.contentPlayer.videoElement;return e&&"boolean"==typeof e.webkitDisplayingFullscreen?e.webkitDisplayingFullscreen:this.state.isContentFullscreen}setupFullscreenTracking(){const e=this.deps.contentPlayer.videoElement;e&&(this.state.trackedContentVideo=e,this.state.fullscreenEnterHandler=()=>{this.state.isContentFullscreen=!0},this.state.fullscreenExitHandler=()=>{this.state.isContentFullscreen=!1},e.addEventListener("webkitbeginfullscreen",this.state.fullscreenEnterHandler),e.addEventListener("webkitendfullscreen",this.state.fullscreenExitHandler))}setupPictureInPictureTracking(){const e=this.deps.contentPlayer.videoElement;e&&(this.state.trackedContentVideo=e,this.pipEnterHandler=()=>{this.state.contentPictureInPicture=!0,this.deps.adoptPictureInPictureMidBreak()},this.pipExitHandler=()=>{this.state.pipTransferredToAd||(this.state.contentPictureInPicture=!1)},this.pipPresentationModeHandler=()=>{const t=e.webkitPresentationMode;this.state.contentPictureInPicture="picture-in-picture"===t,this.state.contentPictureInPicture&&this.deps.adoptPictureInPictureMidBreak()},e.addEventListener("enterpictureinpicture",this.pipEnterHandler),e.addEventListener("leavepictureinpicture",this.pipExitHandler),e.addEventListener("webkitpresentationmodechanged",this.pipPresentationModeHandler))}rebindContentElementIfSwapped(){const e=this.deps.contentPlayer.videoElement??null;if(e===this.state.trackedContentVideo)return;if(!this.state.trackedContentVideo||!e)return;const t=this.state.trackedContentVideo;this.teardownPictureInPictureTracking(),this.teardownFullscreenTracking(),this.state.trackedContentVideo=e,this.setupPictureInPictureTracking(),this.setupFullscreenTracking(),this.state.contentPictureInPicture=this.elementHasPictureInPicture(e),this.deps.diagnose("DA-CONTENT-ELEMENT-SWAPPED","the content player replaced its <video>",{wasConnected:t.isConnected,pictureInPicture:this.state.contentPictureInPicture})}teardownFullscreenTracking(){const e=this.state.trackedContentVideo??this.deps.contentPlayer.videoElement;e&&(this.state.fullscreenEnterHandler&&e.removeEventListener("webkitbeginfullscreen",this.state.fullscreenEnterHandler),this.state.fullscreenExitHandler&&e.removeEventListener("webkitendfullscreen",this.state.fullscreenExitHandler)),this.state.fullscreenEnterHandler=null,this.state.fullscreenExitHandler=null,this.state.isContentFullscreen=!1}teardownPictureInPictureTracking(){const e=this.state.trackedContentVideo??this.deps.contentPlayer.videoElement;e&&(this.pipEnterHandler&&e.removeEventListener("enterpictureinpicture",this.pipEnterHandler),this.pipExitHandler&&e.removeEventListener("leavepictureinpicture",this.pipExitHandler),this.pipPresentationModeHandler&&e.removeEventListener("webkitpresentationmodechanged",this.pipPresentationModeHandler)),this.pipEnterHandler=null,this.pipExitHandler=null,this.pipPresentationModeHandler=null,this.state.contentPictureInPicture=!1}isPictureInPicture(){return this.isContentPictureInPicture()}pictureInPictureOwner(){const e=this.deps.getAdPlayer()?.videoElement;if(this.elementHasPictureInPicture(e))return"ad";const t=this.deps.contentPlayer.videoElement;return t&&this.elementHasPictureInPicture(t)?"content":null}async moveAdIntoPictureInPictureWindow(){this.canReceivePictureInPictureWindow()&&(await this.transferPictureInPictureToAd(),this.state.pipTransferredToAd)||this.deps.isAdPlaying()&&this.deps.getCurrentBreak()&&this.deps.hasCurrentAsset()&&(this.deps.isSharedElementActive()||(this.deps.contentSourceIsReloadable()?await this.deps.playAdThroughContentElement():this.deps.diagnose("DA-SHARED-ELEMENT-UNSUPPORTED","The window could not be moved to the ad, and content cannot be reloaded, so the ad cannot be shown in the picture-in-picture window",{reason:"no-restorable-content-source",midBreak:!0})))}adoptPictureInPictureMidBreak(){if(!this.deps.isAdPlaying()||this.state.pipAdoptedForBreak)return;const i=this.deps.getCurrentFormat();if(n(i,!0))return this.state.pipAdoptedForBreak=!0,this.deps.restoreLayout(i),void this.deps.diagnose("DA-PIP-FORMAT-OVERRIDE","Entered picture-in-picture during an lshape_content break; the window shows content",{declared:i,effective:i,reason:"picture-in-picture",midBreak:!0});if(!t(i,!0))return void this.moveAdIntoPictureInPictureWindow();this.state.pipAdoptedForBreak=!0,this.state.contentPaused||(this.state.contentPaused=!0,this.deps.setContentPositionAtBreakStart(this.deps.contentPlayer.currentTime),this.deps.gateContentForBreak()),this.deps.restoreLayout(i);const r=this.deps.getCurrentBreak(),s=r?this.deps.getVariant(r):null;s&&(this.deps.applyLayout(s),this.deps.show()),this.deps.diagnose("DA-PIP-FORMAT-OVERRIDE",`Entered picture-in-picture during a ${i} break; it now plays as single`,{declared:i,effective:e.SINGLE,reason:"picture-in-picture",midBreak:!0}),this.moveAdIntoPictureInPictureWindow()}async restorePictureInPictureToContent(){if(!this.state.pipTransferredToAd)return;this.state.pipTransferredToAd=!1;const e=this.deps.contentPlayer.videoElement;if(e&&this.adElementHasPictureInPicture())try{await this.enterPictureInPicture(e),this.deps.log("PiP window handed back to content")}catch(e){this.deps.diagnose("DA-PIP-TRANSFER-FAILED",`Could not return the picture-in-picture window to content: ${e instanceof Error?e.message:String(e)}`,{direction:"to-content"})}}async transferPictureInPictureToAd(){if(!this.isContentPictureInPicture())return;if(this.state.pipTransferredToAd)return;const e=this.deps.getAdPlayer()?.videoElement;if(e&&!this.elementHasPictureInPicture(e))try{if(await this.enterPictureInPicture(e),!this.adElementHasPictureInPicture())throw new Error("the browser did not move the window to the ad element");this.state.pipTransferredToAd=!0,this.deps.log("PiP window handed to the ad element")}catch(e){this.deps.diagnose("DA-PIP-TRANSFER-FAILED",`Could not move the picture-in-picture window to the ad: ${e instanceof Error?e.message:String(e)}`,{direction:"to-ad"})}}canReceivePictureInPictureWindow(){const e=this.deps.getAdPlayer()?.videoElement;return!!e&&("function"==typeof e.requestPictureInPicture&&"function"!=typeof e.webkitSetPresentationMode)}adElementHasPictureInPicture(){return this.elementHasPictureInPicture(this.deps.getAdPlayer()?.videoElement)}async enterPictureInPicture(e){"function"!=typeof e.webkitSetPresentationMode?await(e.requestPictureInPicture?.()):await this.setWebkitPresentationMode(e,"picture-in-picture")}setWebkitPresentationMode(e,t){return new Promise((n,i)=>{if(e.webkitPresentationMode===t)return void n();const r=t=>{e.removeEventListener("webkitpresentationmodechanged",s),clearTimeout(o),t?i(t):n()},s=()=>{e.webkitPresentationMode===t&&r()};e.addEventListener("webkitpresentationmodechanged",s);const o=setTimeout(()=>r(new Error(`the browser did not enter '${t}' within 3000ms`)),3e3);try{e.webkitSetPresentationMode?.(t)}catch(e){r(e instanceof Error?e:new Error(String(e)))}})}}
+import{BreakFormat as e}from"../../types/BreakManifest";import{pipOverridesFormat as t,pipSuppressesBackdrop as n}from"../pictureInPicture";export class PresentationModeTracker{constructor(e,t){this.state=e,this.deps=t,this.pipEnterHandler=null,this.pipExitHandler=null,this.pipPresentationModeHandler=null}currentInsertionMode(){return this.deps.isSharedElementActive()?"shared-element":this.effectiveInsertionMode()}effectiveInsertionMode(){return"shared-element"===this.deps.insertionMode||this.isContentPictureInPicture()&&this.deps.contentSourceIsReloadable()&&!this.canReceivePictureInPictureWindow()||"adaptive"===this.deps.insertionMode&&this.isContentFullscreen()?"shared-element":"overlay"}isContentPictureInPicture(){const e=this.deps.getAdPlayer()?.videoElement,t=this.deps.contentPlayer.videoElement;return this.elementHasPictureInPicture(t)||this.elementHasPictureInPicture(e)}elementHasPictureInPicture(e){return!!e&&("picture-in-picture"===e.webkitPresentationMode||"undefined"!=typeof document&&document.pictureInPictureElement===e)}isContentFullscreen(){const e=this.deps.contentPlayer.videoElement;return e&&"boolean"==typeof e.webkitDisplayingFullscreen?e.webkitDisplayingFullscreen:this.state.isContentFullscreen}setupFullscreenTracking(){const e=this.deps.contentPlayer.videoElement;e&&(this.state.trackedContentVideo=e,this.state.fullscreenEnterHandler=()=>{this.state.isContentFullscreen=!0},this.state.fullscreenExitHandler=()=>{this.state.isContentFullscreen=!1},e.addEventListener("webkitbeginfullscreen",this.state.fullscreenEnterHandler),e.addEventListener("webkitendfullscreen",this.state.fullscreenExitHandler))}setupPictureInPictureTracking(){const e=this.deps.contentPlayer.videoElement;e&&(this.state.trackedContentVideo=e,this.pipEnterHandler=()=>{this.state.contentPictureInPicture=!0,this.deps.adoptPictureInPictureMidBreak()},this.pipExitHandler=()=>{this.state.pipTransferredToAd||(this.state.contentPictureInPicture=!1)},this.pipPresentationModeHandler=()=>{const t=e.webkitPresentationMode;this.state.contentPictureInPicture="picture-in-picture"===t,this.state.contentPictureInPicture&&this.deps.adoptPictureInPictureMidBreak()},e.addEventListener("enterpictureinpicture",this.pipEnterHandler),e.addEventListener("leavepictureinpicture",this.pipExitHandler),e.addEventListener("webkitpresentationmodechanged",this.pipPresentationModeHandler))}rebindContentElementIfSwapped(){const e=this.deps.contentPlayer.videoElement??null;if(e===this.state.trackedContentVideo)return;if(!this.state.trackedContentVideo||!e)return;const t=this.state.trackedContentVideo;this.teardownPictureInPictureTracking(),this.teardownFullscreenTracking(),this.state.trackedContentVideo=e,this.setupPictureInPictureTracking(),this.setupFullscreenTracking(),this.state.contentPictureInPicture=this.elementHasPictureInPicture(e),this.deps.diagnose("DA-CONTENT-ELEMENT-SWAPPED","the content player replaced its <video>",{wasConnected:t.isConnected,pictureInPicture:this.state.contentPictureInPicture})}teardownFullscreenTracking(){const e=this.state.trackedContentVideo??this.deps.contentPlayer.videoElement;e&&(this.state.fullscreenEnterHandler&&e.removeEventListener("webkitbeginfullscreen",this.state.fullscreenEnterHandler),this.state.fullscreenExitHandler&&e.removeEventListener("webkitendfullscreen",this.state.fullscreenExitHandler)),this.state.fullscreenEnterHandler=null,this.state.fullscreenExitHandler=null,this.state.isContentFullscreen=!1}teardownPictureInPictureTracking(){const e=this.state.trackedContentVideo??this.deps.contentPlayer.videoElement;e&&(this.pipEnterHandler&&e.removeEventListener("enterpictureinpicture",this.pipEnterHandler),this.pipExitHandler&&e.removeEventListener("leavepictureinpicture",this.pipExitHandler),this.pipPresentationModeHandler&&e.removeEventListener("webkitpresentationmodechanged",this.pipPresentationModeHandler)),this.pipEnterHandler=null,this.pipExitHandler=null,this.pipPresentationModeHandler=null,this.state.contentPictureInPicture=!1}isPictureInPicture(){return this.isContentPictureInPicture()}pictureInPictureOwner(){const e=this.deps.getAdPlayer()?.videoElement;if(this.elementHasPictureInPicture(e))return"ad";const t=this.deps.contentPlayer.videoElement;return t&&this.elementHasPictureInPicture(t)?"content":null}async moveAdIntoPictureInPictureWindow(){this.canReceivePictureInPictureWindow()&&(await this.transferPictureInPictureToAd(),this.state.pipTransferredToAd)||this.deps.isAdPlaying()&&this.deps.getCurrentBreak()&&this.deps.hasCurrentAsset()&&(this.deps.isSharedElementActive()||(this.deps.contentSourceIsReloadable()?await this.deps.playAdThroughContentElement():this.deps.diagnose("DA-SHARED-ELEMENT-UNSUPPORTED","The window could not be moved to the ad, and content cannot be reloaded, so the ad cannot be shown in the picture-in-picture window",{reason:"no-restorable-content-source",midBreak:!0})))}adoptPictureInPictureMidBreak(){if(!this.deps.isAdPlaying()||this.state.pipAdoptedForBreak)return;const i=this.deps.getCurrentFormat();if(n(i,!0))return this.state.pipAdoptedForBreak=!0,this.deps.restoreLayout(),void this.deps.diagnose("DA-PIP-FORMAT-OVERRIDE","Entered picture-in-picture during an lshape_content break; the window shows content",{declared:i,effective:i,reason:"picture-in-picture",midBreak:!0});if(!t(i,!0))return void this.moveAdIntoPictureInPictureWindow();this.state.pipAdoptedForBreak=!0,this.state.contentPaused||(this.state.contentPaused=!0,this.deps.setContentPositionAtBreakStart(this.deps.contentPlayer.currentTime),this.deps.gateContentForBreak()),this.deps.restoreLayout();const r=this.deps.getCurrentBreak(),s=r?this.deps.getVariant(r):null;s&&(this.deps.applyLayout(s),this.deps.show()),this.deps.diagnose("DA-PIP-FORMAT-OVERRIDE",`Entered picture-in-picture during a ${i} break; it now plays as single`,{declared:i,effective:e.SINGLE,reason:"picture-in-picture",midBreak:!0}),this.moveAdIntoPictureInPictureWindow()}async restorePictureInPictureToContent(){if(!this.state.pipTransferredToAd)return;this.state.pipTransferredToAd=!1;const e=this.deps.contentPlayer.videoElement;if(e&&this.adElementHasPictureInPicture())try{await this.enterPictureInPicture(e),this.deps.log("PiP window handed back to content")}catch(e){this.deps.diagnose("DA-PIP-TRANSFER-FAILED",`Could not return the picture-in-picture window to content: ${e instanceof Error?e.message:String(e)}`,{direction:"to-content"})}}async transferPictureInPictureToAd(){if(!this.isContentPictureInPicture())return;if(this.state.pipTransferredToAd)return;const e=this.deps.getAdPlayer()?.videoElement;if(e&&!this.elementHasPictureInPicture(e))try{if(await this.enterPictureInPicture(e),!this.adElementHasPictureInPicture())throw new Error("the browser did not move the window to the ad element");this.state.pipTransferredToAd=!0,this.deps.log("PiP window handed to the ad element")}catch(e){this.deps.diagnose("DA-PIP-TRANSFER-FAILED",`Could not move the picture-in-picture window to the ad: ${e instanceof Error?e.message:String(e)}`,{direction:"to-ad"})}}canReceivePictureInPictureWindow(){const e=this.deps.getAdPlayer()?.videoElement;return!!e&&("function"==typeof e.requestPictureInPicture&&"function"!=typeof e.webkitSetPresentationMode)}adElementHasPictureInPicture(){return this.elementHasPictureInPicture(this.deps.getAdPlayer()?.videoElement)}async enterPictureInPicture(e){"function"!=typeof e.webkitSetPresentationMode?await(e.requestPictureInPicture?.()):await this.setWebkitPresentationMode(e,"picture-in-picture")}setWebkitPresentationMode(e,t){return new Promise((n,i)=>{if(e.webkitPresentationMode===t)return void n();const r=t=>{e.removeEventListener("webkitpresentationmodechanged",s),clearTimeout(o),t?i(t):n()},s=()=>{e.webkitPresentationMode===t&&r()};e.addEventListener("webkitpresentationmodechanged",s);const o=setTimeout(()=>r(new Error(`the browser did not enter '${t}' within 3000ms`)),3e3);try{e.webkitSetPresentationMode?.(t)}catch(e){r(e instanceof Error?e:new Error(String(e)))}})}}

package/dist/services/adPlayer/SharedElementBreakPlayer.d.ts

@@ -2,9 +2,12 @@ import type { PlayerAdapter, TimedMetadataCue } from '../../interfaces/PlayerAda
 import type { Asset, Break } from '../../types/BreakManifest';
 import type { AdPlayerCallbacks } from '../AdPlayerController';
 import type { AdPlayerState } from './AdPlayerState';
+import type { SurfaceRevealReporter } from './SurfaceRevealReporter';
 export interface SharedElementBreakPlayerDeps {
     contentPlayer: PlayerAdapter;
     getAdPlayer: () => PlayerAdapter | null;
+    /** Watches for the ad's first frame on the content element (`DA-AD-SURFACE-REVEALED`). */
+    surfaceReveal?: SurfaceRevealReporter;
     resolveAssetUri: (asset: Asset, duration: number) => Promise<string | null>;
     liveEdgeDistanceSec: () => number | null;
     rebindContentElementIfSwapped: () => void;

package/dist/services/adPlayer/SharedElementBreakPlayer.js

@@ -1 +1 @@
-import{BreakFormat as e,isPostRollBreak as t}from"../../types/BreakManifest";import{armPlaybackCutoff as s,clearPlaybackCutoff as a}from"./PlaybackCutoff";import{AdError as n}from"../../types/AdError";import{classifyMediaError as r,toClassifiedAdError as i}from"./classifyMediaError";function d(e){return e?{src:e.getAttribute("src"),srcObject:e.srcObject,sourceChild:null!==e.querySelector("source")}:null}export class SharedElementBreakPlayer{constructor(e,t){this.state=e,this.deps=t,this.contentElementAdPlayer=null,this.sharedAdSource=null,this.sharedAdEndedHandler=null,this.sharedAdTimeUpdateHandler=null,this.sharedAdTimedMetadataHandler=null,this.sharedAdWaitingHandler=null,this.sharedAdPlayingHandler=null,this.sharedAdFirstFrameTimer=null,this.sharedRestoreWatchdog=null,this.sharedRestore=null,this.sharedRestoreGeneration=0,this.sharedActivityGeneration=0}sharedElementAdPlayer(){const e=this.deps.contentPlayer.videoElement;if(!e)return null;if(this.contentElementAdPlayer?.videoElement===e)return this.contentElementAdPlayer;this.releaseContentElementAdPlayer();const t=this.deps.createAdAdapter(document.createElement("div"),e);return t!==this.deps.contentPlayer&&t.prepareForAdPlayback?.(),t.videoElement!==e?(this.deps.log("shared-element: createAdAdapter ignored the content element; falling back to the content player for ad playback"),t.destroy(),null):(this.contentElementAdPlayer=t,t)}async sharedAdStep(e,t,s){try{await s()}catch(s){const a=t.videoElement,i=s instanceof Error?s.message:String(s),d=new n(`shared-element ${e} failed: ${i} (readyState=${a?.readyState??"-"} paused=${a?.paused??"-"} networkState=${a?.networkState??"-"})`,r(s));throw d.cause=s,d}}clearSharedAdFirstFrameWatchdog(){this.sharedAdFirstFrameTimer&&(clearTimeout(this.sharedAdFirstFrameTimer),this.sharedAdFirstFrameTimer=null)}armSharedAdFirstFrameWatchdog(e,t){this.clearSharedAdFirstFrameWatchdog(),this.sharedAdFirstFrameTimer=setTimeout(()=>{if(this.sharedAdFirstFrameTimer=null,!this.state.isPlaying||!this.state.currentBreak)return;const s=e.videoElement,a=this.deps.contentPlayer.videoElement,r=s?.currentSrc??"",i=`readyState=${s?.readyState??"-"} networkState=${s?.networkState??"-"} paused=${s?.paused??"-"} connected=${s?.isConnected??"-"} srcKind=${r.startsWith("blob:")?"blob":r?"url":"none"} sameElementAsContentPlayer=${String(s===a)}`;this.deps.log(`shared-element: no first frame within ${t}ms (${i})`),this.deps.diagnose("DA-AD-PLAYBACK-ERROR",`the ad never rendered a frame on the content element within ${t}ms`,{breakId:this.state.currentBreak.id,detail:i});const d=this.state.currentAsset;d&&this.state.callbacks?.onAdError(this.state.currentBreak,d,new n(`shared-element ad produced no frames within ${t}ms (${i})`,"DA-AD-START-TIMEOUT")),this.onSharedElementAdEnded()},t)}attachSharedAdListeners(e){this.sharedAdSource=e,this.sharedAdEndedHandler=()=>this.onSharedElementAdEnded(),e.on("ended",this.sharedAdEndedHandler),this.sharedAdTimeUpdateHandler=()=>{this.sharedAdFirstFrameTimer&&e.currentTime>0&&this.clearSharedAdFirstFrameWatchdog(),this.deps.reportAdProgress(e)},e.on("timeupdate",this.sharedAdTimeUpdateHandler),this.sharedAdTimedMetadataHandler=e=>{e&&this.deps.processTimedMetadata(e)},e.on("timedmetadata",this.sharedAdTimedMetadataHandler),this.sharedAdWaitingHandler=()=>{this.state.isPlaying&&this.state.currentBreak&&this.state.currentAsset&&this.state.callbacks?.onAdWaiting(this.state.currentBreak,this.state.currentAsset)},e.on("waiting",this.sharedAdWaitingHandler),this.sharedAdPlayingHandler=()=>{this.state.isPlaying&&this.state.currentBreak&&this.state.currentAsset&&!e.paused&&(this.clearSharedAdFirstFrameWatchdog(),this.state.startPlaybackCutoff?.(),this.state.callbacks?.onAdPlaying(this.state.currentBreak,this.state.currentAsset))},e.on("playing",this.sharedAdPlayingHandler)}detachSharedAdListeners(){const e=this.sharedAdSource??this.deps.contentPlayer;this.sharedAdSource=null,this.state.sharedAdClaimActive=!1,this.clearSharedAdFirstFrameWatchdog(),this.sharedAdTimedMetadataHandler&&(e.off("timedmetadata",this.sharedAdTimedMetadataHandler),this.sharedAdTimedMetadataHandler=null),this.sharedAdWaitingHandler&&(e.off("waiting",this.sharedAdWaitingHandler),this.sharedAdWaitingHandler=null),this.sharedAdPlayingHandler&&(e.off("playing",this.sharedAdPlayingHandler),this.sharedAdPlayingHandler=null),this.sharedAdTimeUpdateHandler&&(e.off("timeupdate",this.sharedAdTimeUpdateHandler),this.sharedAdTimeUpdateHandler=null),this.sharedAdEndedHandler&&(e.off("ended",this.sharedAdEndedHandler),this.sharedAdEndedHandler=null)}async releaseContentElementFromContentEngine(){if(this.deps.contentPlayer.releaseMediaElement)try{await this.deps.contentPlayer.releaseMediaElement()}catch(e){this.deps.log("shared-element: the content engine did not release the element:",e)}}releaseContentElementAdPlayer(){const e=this.contentElementAdPlayer;if(e){this.contentElementAdPlayer=null;try{e.destroy()}catch(e){this.deps.log("shared-element: releasing the ad player on the content element failed:",e)}}}async playAdThroughContentElement(){const e=this.state.currentAsset,t=this.state.currentBreak;if(!e||!t)return;const s=this.state.effectiveBreakDurationSec??t.duration,a=await this.deps.resolveAssetUri(e,s);if(!a)return void this.deps.log("shared-element: no URI for the running ad; leaving it on the ad element");const n=this.deps.getAdPlayer()?.currentTime??0;this.state.savedContentSrc=this.restorableContentSource(),this.state.savedContentTime=this.deps.contentPlayer.currentTime,this.state.savedContentLive=!Number.isFinite(this.deps.contentPlayer.duration),this.state.savedContentEdgeDistance=this.state.savedContentLive?this.deps.liveEdgeDistanceSec():null,this.state.sharedAdClaimActive=!0,await this.releaseContentElementFromContentEngine(),this.deps.rebindContentElementIfSwapped();const r=this.sharedElementAdPlayer()??this.deps.contentPlayer;try{this.deps.getAdPlayer()?.pause(),this.deps.clearContentGate(),await r.load(a),this.attachSharedAdListeners(r),n>0&&r.seek(n),await r.play(),this.deps.hide(),this.deps.log("shared-element: the ad now plays through the content element")}catch(e){this.deps.log("shared-element: could not move the ad onto the content element:",e),this.state.sharedAdClaimActive=!1,this.state.savedContentSrc=null,this.state.savedContentEdgeDistance=null}}async playSharedElementBreak(t,a){const r=this.deps.getVariant(t);if(!r)return this.deps.log("shared-element: no valid variant, skipping break:",t.id),void a.onBreakEnd(t);if(r.format===e.LSHAPE_CONTENT)return this.deps.log("shared-element: skipping lshape_content break (no fullscreen video asset):",t.id),void a.onBreakEnd(t);const d=this.deps.getAssets(t)[0];if(!d)return this.deps.log("shared-element: no asset to play, skipping break:",t.id),void a.onBreakEnd(t);r.format!==e.SINGLE&&this.deps.log(`shared-element: downgrading ${r.format} to a single fullscreen ad:`,t.id),this.state.currentBreak=t,this.state.currentAsset=d,this.state.callbacks=a,this.state.isPlaying=!0;const h=this.state.effectiveBreakDurationSec??t.duration,l=await this.deps.resolveAssetUri(d,h);if(!l)return this.deps.log("shared-element: no valid URI, skipping break:",t.id),this.state.isPlaying=!1,this.state.currentBreak=null,this.state.currentAsset=null,void a.onBreakEnd(t);this.state.savedContentSrc=this.restorableContentSource(),this.state.savedContentTime=this.deps.contentPlayer.currentTime,this.state.savedContentLive=!Number.isFinite(this.deps.contentPlayer.duration),this.state.savedContentEdgeDistance=this.state.savedContentLive?this.deps.liveEdgeDistanceSec():null,this.state.sharedAdClaimActive=!0,await this.releaseContentElementFromContentEngine(),this.deps.rebindContentElementIfSwapped();const o=this.sharedElementAdPlayer()??this.deps.contentPlayer;if(h&&h>0){const e=h+this.state.adBreakCutSafetyMarginSec;s(this.state,e,()=>{this.deps.log("shared-element: break-cut timer expired, ending break"),this.state.isPlaying&&this.state.currentBreak&&this.state.callbacks?.onBreakCut?.(this.state.currentBreak),this.onSharedElementAdEnded()},()=>{this.state.callbacks?.onAdError(t,d,new n("Ad playback startup timed out","DA-AD-START-TIMEOUT")),this.onSharedElementAdEnded()})}try{if(this.deps.clearContentGate(),await this.sharedAdStep("load",o,()=>o.load(l)),!this.state.isPlaying||this.state.currentBreak!==t)return;if(this.attachSharedAdListeners(o),this.armSharedAdFirstFrameWatchdog(o,Math.max(Math.min(1e3*(h??0)-100,5e3),3e3)),await this.sharedAdStep("play",o,()=>o.play()),!this.state.isPlaying||this.state.currentBreak!==t)return;this.state.callbacks?.onAdStart(t,d,0,1)}catch(e){if(!this.state.isPlaying||this.state.currentBreak!==t)return;this.deps.log("shared-element: ad playback failed:",e),this.state.callbacks?.onAdError(t,d,i(e)),this.onSharedElementAdEnded()}}onSharedElementAdEnded(){if(!this.state.isPlaying||!this.state.currentBreak)return;const e=this.state.currentBreak,t=this.state.currentAsset,s=this.state.callbacks,n=this.sharedRestoreGeneration;this.detachSharedAdListeners(),a(this.state),this.state.isPlaying=!1,this.state.currentBreak=null,this.state.currentAsset=null,t&&s?.onAdEnd(e,t,0,1),n===this.sharedRestoreGeneration&&this.restoreSharedElementContent(e),s?.onBreakEnd(e)}restoreSharedElementContent(e){const s=this.state.savedContentSrc;if(!s){if(this.sharedRestore)return;return this.deps.log("shared-element: no saved content source to restore"),void this.releaseContentElementAdPlayer()}if(!this.beginSharedActivity())return;const a=this.state.savedContentTime,n=this.state.savedContentLive,r=this.state.savedContentEdgeDistance,i=this.state.callbacks;this.state.savedContentSrc=null,this.state.savedContentEdgeDistance=null;const d={src:s,time:a,live:n,edgeDistance:r,breakInfo:e,postRoll:!!e&&t(e),onContentReloading:i?.onContentReloading?.bind(i),adPlayer:this.contentElementAdPlayer,reloading:!1,cleanedUp:!1,cancelled:!1,finishingActivity:null,attempt:null};this.sharedRestore=d,e&&"number"==typeof e.start&&i?.onContentResumeSeek?.(n?this.deps.contentPlayer.currentTime:a,e.start+e.duration),this.sharedRestore===d&&(d.reloading=!0,d.onContentReloading?.(!0),this.sharedRestore===d&&this.runSharedRestore(d))}async runSharedRestore(e){for(let t=1;t<=2;t++){const s={phase:"load",deadline:0,timer:null,settle:null};e.attempt=s;const a=await new Promise(t=>{s.settle=e=>{s.settle&&(s.settle=null,s.timer&&clearTimeout(s.timer),s.timer=null,t(e))},this.armSharedRestoreDeadline(s,1e4),this.reloadAndResume(e,s).then(()=>s.settle?.("success"),()=>s.settle?.("rejection"))});if(this.sharedRestore!==e||e.attempt!==s)return;if("success"===a||"cancelled"===a)break;if(2===t?this.deps.diagnose("DA-SHARED-ELEMENT-RESTORE-FAILED",`Content did not resume after the shared-element break: ${s.phase} ${a}`,{breakId:e.breakInfo?.id,live:e.live,attempts:t,phase:s.phase,reason:a}):this.deps.log(`shared-element: content restore ${s.phase} ${a}, retrying once`),this.sharedRestore!==e||e.attempt!==s)return}this.finishSharedRestore(e,!0)}armSharedRestoreDeadline(e,t){e.timer&&clearTimeout(e.timer),e.deadline=performance.now()+t,e.timer=setTimeout(()=>e.settle?.("timeout"),t)}ownsSharedRestoreAttempt(e,t){return!(this.sharedRestore!==e||e.attempt!==t||!t.settle)&&(performance.now()<t.deadline||(t.settle("timeout"),!1))}async reloadAndResume(e,t){const{src:s,time:a,live:n,edgeDistance:r,postRoll:i}=e,h=()=>this.ownsSharedRestoreAttempt(e,t);if(!h())return;if(e.adPlayer?.releaseMediaElement&&(await this.releaseAdEngineGrip(e),!h()))return;const l=this.deps.contentPlayer.videoElement??null,o=d(l);if(await this.deps.contentPlayer.load(s),h()){if(this.armSharedRestoreDeadline(t,5e3),n){if(!i&&null!==r&&r>0){t.phase="live-edge";const e=await this.deps.waitForLiveEdge(h);if(!h())return;if(null!==e){const s=Math.max(e-r,0);if(this.deps.log(`shared-element: live resume ${r.toFixed(2)}s behind the edge (${s.toFixed(2)}s)`),!h())return;t.phase="seek",this.deps.contentPlayer.seek(s)}}}else t.phase="seek",this.deps.contentPlayer.seek(a);h()&&!i&&(t.phase="play",await this.deps.contentPlayer.play(),h()&&await this.waitForContentEngineToTakeElement(l,o,h))}}async releaseAdEngineGrip(e){const t=e.adPlayer;if(t?.releaseMediaElement)try{await t.releaseMediaElement()}catch(e){this.deps.log("shared-element: the ad engine did not release the element:",e)}}async waitForContentEngineToTakeElement(e,t,s){if(!(e&&t&&(a=t,a.src||a.srcObject||a.sourceChild)))return;var a;const n=()=>{if(this.deps.contentPlayer.videoElement!==e)return!0;const s=d(e);if(!s)return!1;const a=!!s.src&&s.src!==t.src,n=!!s.srcObject&&s.srcObject!==t.srcObject;return a||n},r=performance.now();for(;!n()&&s()&&performance.now()-r<1500;)await new Promise(e=>setTimeout(e,25));if(!s())return;const i=Math.round(performance.now()-r);this.deps.log(`shared-element: content engine ${n()?"took":"did not take"} the element after ${i}ms`)}finishSharedRestore(e,t){this.sharedRestore===e&&(null===e.finishingActivity?(e.finishingActivity=this.sharedActivityGeneration,e.cleanedUp||(this.state.contentPaused=!1,this.contentElementAdPlayer===e.adPlayer&&this.releaseContentElementAdPlayer(),this.sharedRestore===e&&this.deps.clearContentGate(),this.sharedRestore===e&&this.deps.rebindContentElementIfSwapped(),e.cleanedUp=!0),this.endSharedRestoreReloading(e),e.finishingActivity=null,this.sharedRestore===e&&(!t||e.cancelled||e.postRoll?this.sharedRestore=null:this.armSharedRestoreWatchdog(e))):e.finishingActivity!==this.sharedActivityGeneration&&(this.endSharedRestoreReloading(e),this.sharedRestore===e&&(this.sharedRestore=null)))}endSharedRestoreReloading(e){e.reloading&&(e.reloading=!1,e.onContentReloading?.(!1))}armSharedRestoreWatchdog(e){const t=this.deps.contentPlayer.currentTime;this.sharedRestoreWatchdog=setTimeout(()=>{if(this.sharedRestore!==e)return;this.sharedRestoreWatchdog=null;const s=this.deps.contentPlayer.currentTime-t;(this.deps.contentPlayer.paused||s<1)&&(this.deps.diagnose("DA-CONTENT-RESUME-STALLED",`Content did not resume within 5s of the shared-element restore (paused: ${this.deps.contentPlayer.paused}, advanced: ${s.toFixed(1)}s); nudging play()`,{breakId:e.breakInfo?.id??"?",paused:this.deps.contentPlayer.paused,advancedSec:s}),this.sharedRestore===e&&this.deps.contentPlayer.play().catch(()=>{this.sharedRestore===e&&this.deps.log("shared-element: watchdog play() nudge failed")}))},5e3)}beginSharedActivity(){return this.sharedActivityGeneration++,this.cancelSharedRestore()}cancelSharedRestore(){const e=this.sharedActivityGeneration;this.sharedRestoreGeneration++,this.sharedRestoreWatchdog&&(clearTimeout(this.sharedRestoreWatchdog),this.sharedRestoreWatchdog=null);const t=this.sharedRestore;return t&&(t.cancelled=!0,t.attempt?.settle?.("cancelled"),this.finishSharedRestore(t,!1)),e===this.sharedActivityGeneration}restorableContentSource(){const e=this.deps.contentPlayer.sourceUrl;if(e&&!e.startsWith("blob:"))return e;const t=this.deps.contentPlayer.videoElement,s=t?.currentSrc||t?.src||"";return s.length>0&&!s.startsWith("blob:")?s:null}}
+import{BreakFormat as e,isPostRollBreak as t}from"../../types/BreakManifest";import{armPlaybackCutoff as s,clearPlaybackCutoff as a}from"./PlaybackCutoff";import{AdError as n}from"../../types/AdError";import{classifyMediaError as r,toClassifiedAdError as i}from"./classifyMediaError";function d(e){return e?{src:e.getAttribute("src"),srcObject:e.srcObject,sourceChild:null!==e.querySelector("source")}:null}export class SharedElementBreakPlayer{constructor(e,t){this.state=e,this.deps=t,this.contentElementAdPlayer=null,this.sharedAdSource=null,this.sharedAdEndedHandler=null,this.sharedAdTimeUpdateHandler=null,this.sharedAdTimedMetadataHandler=null,this.sharedAdWaitingHandler=null,this.sharedAdPlayingHandler=null,this.sharedAdFirstFrameTimer=null,this.sharedRestoreWatchdog=null,this.sharedRestore=null,this.sharedRestoreGeneration=0,this.sharedActivityGeneration=0}sharedElementAdPlayer(){const e=this.deps.contentPlayer.videoElement;if(!e)return null;if(this.contentElementAdPlayer?.videoElement===e)return this.contentElementAdPlayer;this.releaseContentElementAdPlayer();const t=this.deps.createAdAdapter(document.createElement("div"),e);return t!==this.deps.contentPlayer&&t.prepareForAdPlayback?.(),t.videoElement!==e?(this.deps.log("shared-element: createAdAdapter ignored the content element; falling back to the content player for ad playback"),t.destroy(),null):(this.contentElementAdPlayer=t,t)}async sharedAdStep(e,t,s){try{await s()}catch(s){const a=t.videoElement,i=s instanceof Error?s.message:String(s),d=new n(`shared-element ${e} failed: ${i} (readyState=${a?.readyState??"-"} paused=${a?.paused??"-"} networkState=${a?.networkState??"-"})`,r(s));throw d.cause=s,d}}clearSharedAdFirstFrameWatchdog(){this.sharedAdFirstFrameTimer&&(clearTimeout(this.sharedAdFirstFrameTimer),this.sharedAdFirstFrameTimer=null)}armSharedAdFirstFrameWatchdog(e,t){this.clearSharedAdFirstFrameWatchdog(),this.sharedAdFirstFrameTimer=setTimeout(()=>{if(this.sharedAdFirstFrameTimer=null,!this.state.isPlaying||!this.state.currentBreak)return;const s=e.videoElement,a=this.deps.contentPlayer.videoElement,r=s?.currentSrc??"",i=`readyState=${s?.readyState??"-"} networkState=${s?.networkState??"-"} paused=${s?.paused??"-"} connected=${s?.isConnected??"-"} srcKind=${r.startsWith("blob:")?"blob":r?"url":"none"} sameElementAsContentPlayer=${String(s===a)}`;this.deps.log(`shared-element: no first frame within ${t}ms (${i})`),this.deps.diagnose("DA-AD-PLAYBACK-ERROR",`the ad never rendered a frame on the content element within ${t}ms`,{breakId:this.state.currentBreak.id,detail:i});const d=this.state.currentAsset;d&&this.state.callbacks?.onAdError(this.state.currentBreak,d,new n(`shared-element ad produced no frames within ${t}ms (${i})`,"DA-AD-START-TIMEOUT")),this.onSharedElementAdEnded()},t)}attachSharedAdListeners(e){this.sharedAdSource=e,this.sharedAdEndedHandler=()=>this.onSharedElementAdEnded(),e.on("ended",this.sharedAdEndedHandler),this.sharedAdTimeUpdateHandler=()=>{this.sharedAdFirstFrameTimer&&e.currentTime>0&&this.clearSharedAdFirstFrameWatchdog(),this.deps.reportAdProgress(e)},e.on("timeupdate",this.sharedAdTimeUpdateHandler),this.sharedAdTimedMetadataHandler=e=>{e&&this.deps.processTimedMetadata(e)},e.on("timedmetadata",this.sharedAdTimedMetadataHandler),this.sharedAdWaitingHandler=()=>{this.state.isPlaying&&this.state.currentBreak&&this.state.currentAsset&&this.state.callbacks?.onAdWaiting(this.state.currentBreak,this.state.currentAsset)},e.on("waiting",this.sharedAdWaitingHandler),this.sharedAdPlayingHandler=()=>{this.state.isPlaying&&this.state.currentBreak&&this.state.currentAsset&&!e.paused&&(this.clearSharedAdFirstFrameWatchdog(),this.state.startPlaybackCutoff?.(),this.state.callbacks?.onAdPlaying(this.state.currentBreak,this.state.currentAsset))},e.on("playing",this.sharedAdPlayingHandler)}detachSharedAdListeners(){const e=this.sharedAdSource??this.deps.contentPlayer;this.sharedAdSource=null,this.state.sharedAdClaimActive=!1,this.clearSharedAdFirstFrameWatchdog(),this.sharedAdTimedMetadataHandler&&(e.off("timedmetadata",this.sharedAdTimedMetadataHandler),this.sharedAdTimedMetadataHandler=null),this.sharedAdWaitingHandler&&(e.off("waiting",this.sharedAdWaitingHandler),this.sharedAdWaitingHandler=null),this.sharedAdPlayingHandler&&(e.off("playing",this.sharedAdPlayingHandler),this.sharedAdPlayingHandler=null),this.sharedAdTimeUpdateHandler&&(e.off("timeupdate",this.sharedAdTimeUpdateHandler),this.sharedAdTimeUpdateHandler=null),this.sharedAdEndedHandler&&(e.off("ended",this.sharedAdEndedHandler),this.sharedAdEndedHandler=null)}async releaseContentElementFromContentEngine(){if(this.deps.contentPlayer.releaseMediaElement)try{await this.deps.contentPlayer.releaseMediaElement()}catch(e){this.deps.log("shared-element: the content engine did not release the element:",e)}}releaseContentElementAdPlayer(){const e=this.contentElementAdPlayer;if(e){this.contentElementAdPlayer=null;try{e.destroy()}catch(e){this.deps.log("shared-element: releasing the ad player on the content element failed:",e)}}}async playAdThroughContentElement(){const e=this.state.currentAsset,t=this.state.currentBreak;if(!e||!t)return;const s=this.state.effectiveBreakDurationSec??t.duration,a=await this.deps.resolveAssetUri(e,s);if(!a)return void this.deps.log("shared-element: no URI for the running ad; leaving it on the ad element");const n=this.deps.getAdPlayer()?.currentTime??0;this.state.savedContentSrc=this.restorableContentSource(),this.state.savedContentTime=this.deps.contentPlayer.currentTime,this.state.savedContentLive=!Number.isFinite(this.deps.contentPlayer.duration),this.state.savedContentEdgeDistance=this.state.savedContentLive?this.deps.liveEdgeDistanceSec():null,this.state.sharedAdClaimActive=!0,await this.releaseContentElementFromContentEngine(),this.deps.rebindContentElementIfSwapped();const r=this.sharedElementAdPlayer()??this.deps.contentPlayer;try{this.deps.getAdPlayer()?.pause(),this.deps.clearContentGate(),await r.load(a),this.attachSharedAdListeners(r),n>0&&r.seek(n),await r.play(),this.deps.hide(),this.deps.log("shared-element: the ad now plays through the content element")}catch(e){this.deps.log("shared-element: could not move the ad onto the content element:",e),this.state.sharedAdClaimActive=!1,this.state.savedContentSrc=null,this.state.savedContentEdgeDistance=null}}async playSharedElementBreak(t,a){const r=this.deps.getVariant(t);if(!r)return this.deps.log("shared-element: no valid variant, skipping break:",t.id),void a.onBreakEnd(t);if(r.format===e.LSHAPE_CONTENT)return this.deps.log("shared-element: skipping lshape_content break (no fullscreen video asset):",t.id),void a.onBreakEnd(t);const d=this.deps.getAssets(t)[0];if(!d)return this.deps.log("shared-element: no asset to play, skipping break:",t.id),void a.onBreakEnd(t);r.format!==e.SINGLE&&this.deps.log(`shared-element: downgrading ${r.format} to a single fullscreen ad:`,t.id),this.state.currentBreak=t,this.state.currentAsset=d,this.state.callbacks=a,this.state.isPlaying=!0;const h=this.state.effectiveBreakDurationSec??t.duration,l=await this.deps.resolveAssetUri(d,h);if(!l)return this.deps.log("shared-element: no valid URI, skipping break:",t.id),this.state.isPlaying=!1,this.state.currentBreak=null,this.state.currentAsset=null,void a.onBreakEnd(t);this.state.savedContentSrc=this.restorableContentSource(),this.state.savedContentTime=this.deps.contentPlayer.currentTime,this.state.savedContentLive=!Number.isFinite(this.deps.contentPlayer.duration),this.state.savedContentEdgeDistance=this.state.savedContentLive?this.deps.liveEdgeDistanceSec():null,this.state.sharedAdClaimActive=!0,await this.releaseContentElementFromContentEngine(),this.deps.rebindContentElementIfSwapped();const o=this.sharedElementAdPlayer()??this.deps.contentPlayer;if(h&&h>0){const e=h+this.state.adBreakCutSafetyMarginSec;s(this.state,e,()=>{this.deps.log("shared-element: break-cut timer expired, ending break"),this.state.isPlaying&&this.state.currentBreak&&this.state.callbacks?.onBreakCut?.(this.state.currentBreak),this.onSharedElementAdEnded()},()=>{this.state.callbacks?.onAdError(t,d,new n("Ad playback startup timed out","DA-AD-START-TIMEOUT")),this.onSharedElementAdEnded()})}try{if(this.deps.clearContentGate(),await this.sharedAdStep("load",o,()=>o.load(l)),!this.state.isPlaying||this.state.currentBreak!==t)return;if(this.attachSharedAdListeners(o),this.armSharedAdFirstFrameWatchdog(o,Math.max(Math.min(1e3*(h??0)-100,5e3),3e3)),this.deps.surfaceReveal?.surfaceShown(),this.deps.surfaceReveal?.watch(d.id,t.id,o.videoElement),await this.sharedAdStep("play",o,()=>o.play()),!this.state.isPlaying||this.state.currentBreak!==t)return;this.state.callbacks?.onAdStart(t,d,0,1)}catch(e){if(!this.state.isPlaying||this.state.currentBreak!==t)return;this.deps.log("shared-element: ad playback failed:",e),this.state.callbacks?.onAdError(t,d,i(e)),this.onSharedElementAdEnded()}}onSharedElementAdEnded(){if(!this.state.isPlaying||!this.state.currentBreak)return;const e=this.state.currentBreak,t=this.state.currentAsset,s=this.state.callbacks,n=this.sharedRestoreGeneration;this.detachSharedAdListeners(),a(this.state),this.state.isPlaying=!1,this.state.currentBreak=null,this.state.currentAsset=null,t&&s?.onAdEnd(e,t,0,1),n===this.sharedRestoreGeneration&&this.restoreSharedElementContent(e),this.deps.surfaceReveal?.surfaceHidden(),s?.onBreakEnd(e)}restoreSharedElementContent(e){const s=this.state.savedContentSrc;if(!s){if(this.sharedRestore)return;return this.deps.log("shared-element: no saved content source to restore"),void this.releaseContentElementAdPlayer()}if(!this.beginSharedActivity())return;const a=this.state.savedContentTime,n=this.state.savedContentLive,r=this.state.savedContentEdgeDistance,i=this.state.callbacks;this.state.savedContentSrc=null,this.state.savedContentEdgeDistance=null;const d={src:s,time:a,live:n,edgeDistance:r,breakInfo:e,postRoll:!!e&&t(e),onContentReloading:i?.onContentReloading?.bind(i),adPlayer:this.contentElementAdPlayer,reloading:!1,cleanedUp:!1,cancelled:!1,finishingActivity:null,attempt:null};this.sharedRestore=d,e&&"number"==typeof e.start&&i?.onContentResumeSeek?.(n?this.deps.contentPlayer.currentTime:a,e.start+e.duration),this.sharedRestore===d&&(d.reloading=!0,d.onContentReloading?.(!0),this.sharedRestore===d&&this.runSharedRestore(d))}async runSharedRestore(e){for(let t=1;t<=2;t++){const s={phase:"load",deadline:0,timer:null,settle:null};e.attempt=s;const a=await new Promise(t=>{s.settle=e=>{s.settle&&(s.settle=null,s.timer&&clearTimeout(s.timer),s.timer=null,t(e))},this.armSharedRestoreDeadline(s,1e4),this.reloadAndResume(e,s).then(()=>s.settle?.("success"),()=>s.settle?.("rejection"))});if(this.sharedRestore!==e||e.attempt!==s)return;if("success"===a||"cancelled"===a)break;if(2===t?this.deps.diagnose("DA-SHARED-ELEMENT-RESTORE-FAILED",`Content did not resume after the shared-element break: ${s.phase} ${a}`,{breakId:e.breakInfo?.id,live:e.live,attempts:t,phase:s.phase,reason:a}):this.deps.log(`shared-element: content restore ${s.phase} ${a}, retrying once`),this.sharedRestore!==e||e.attempt!==s)return}this.finishSharedRestore(e,!0)}armSharedRestoreDeadline(e,t){e.timer&&clearTimeout(e.timer),e.deadline=performance.now()+t,e.timer=setTimeout(()=>e.settle?.("timeout"),t)}ownsSharedRestoreAttempt(e,t){return!(this.sharedRestore!==e||e.attempt!==t||!t.settle)&&(performance.now()<t.deadline||(t.settle("timeout"),!1))}async reloadAndResume(e,t){const{src:s,time:a,live:n,edgeDistance:r,postRoll:i}=e,h=()=>this.ownsSharedRestoreAttempt(e,t);if(!h())return;if(e.adPlayer?.releaseMediaElement&&(await this.releaseAdEngineGrip(e),!h()))return;const l=this.deps.contentPlayer.videoElement??null,o=d(l);if(await this.deps.contentPlayer.load(s),h()){if(this.armSharedRestoreDeadline(t,5e3),n){if(!i&&null!==r&&r>0){t.phase="live-edge";const e=await this.deps.waitForLiveEdge(h);if(!h())return;if(null!==e){const s=Math.max(e-r,0);if(this.deps.log(`shared-element: live resume ${r.toFixed(2)}s behind the edge (${s.toFixed(2)}s)`),!h())return;t.phase="seek",this.deps.contentPlayer.seek(s)}}}else t.phase="seek",this.deps.contentPlayer.seek(a);h()&&!i&&(t.phase="play",await this.deps.contentPlayer.play(),h()&&await this.waitForContentEngineToTakeElement(l,o,h))}}async releaseAdEngineGrip(e){const t=e.adPlayer;if(t?.releaseMediaElement)try{await t.releaseMediaElement()}catch(e){this.deps.log("shared-element: the ad engine did not release the element:",e)}}async waitForContentEngineToTakeElement(e,t,s){if(!(e&&t&&(a=t,a.src||a.srcObject||a.sourceChild)))return;var a;const n=()=>{if(this.deps.contentPlayer.videoElement!==e)return!0;const s=d(e);if(!s)return!1;const a=!!s.src&&s.src!==t.src,n=!!s.srcObject&&s.srcObject!==t.srcObject;return a||n},r=performance.now();for(;!n()&&s()&&performance.now()-r<1500;)await new Promise(e=>setTimeout(e,25));if(!s())return;const i=Math.round(performance.now()-r);this.deps.log(`shared-element: content engine ${n()?"took":"did not take"} the element after ${i}ms`)}finishSharedRestore(e,t){this.sharedRestore===e&&(null===e.finishingActivity?(e.finishingActivity=this.sharedActivityGeneration,e.cleanedUp||(this.state.contentPaused=!1,this.contentElementAdPlayer===e.adPlayer&&this.releaseContentElementAdPlayer(),this.sharedRestore===e&&this.deps.clearContentGate(),this.sharedRestore===e&&this.deps.rebindContentElementIfSwapped(),e.cleanedUp=!0),this.endSharedRestoreReloading(e),e.finishingActivity=null,this.sharedRestore===e&&(!t||e.cancelled||e.postRoll?this.sharedRestore=null:this.armSharedRestoreWatchdog(e))):e.finishingActivity!==this.sharedActivityGeneration&&(this.endSharedRestoreReloading(e),this.sharedRestore===e&&(this.sharedRestore=null)))}endSharedRestoreReloading(e){e.reloading&&(e.reloading=!1,e.onContentReloading?.(!1))}armSharedRestoreWatchdog(e){const t=this.deps.contentPlayer.currentTime;this.sharedRestoreWatchdog=setTimeout(()=>{if(this.sharedRestore!==e)return;this.sharedRestoreWatchdog=null;const s=this.deps.contentPlayer.currentTime-t;(this.deps.contentPlayer.paused||s<1)&&(this.deps.diagnose("DA-CONTENT-RESUME-STALLED",`Content did not resume within 5s of the shared-element restore (paused: ${this.deps.contentPlayer.paused}, advanced: ${s.toFixed(1)}s); nudging play()`,{breakId:e.breakInfo?.id??"?",paused:this.deps.contentPlayer.paused,advancedSec:s}),this.sharedRestore===e&&this.deps.contentPlayer.play().catch(()=>{this.sharedRestore===e&&this.deps.log("shared-element: watchdog play() nudge failed")}))},5e3)}beginSharedActivity(){return this.sharedActivityGeneration++,this.cancelSharedRestore()}cancelSharedRestore(){const e=this.sharedActivityGeneration;this.sharedRestoreGeneration++,this.sharedRestoreWatchdog&&(clearTimeout(this.sharedRestoreWatchdog),this.sharedRestoreWatchdog=null);const t=this.sharedRestore;return t&&(t.cancelled=!0,t.attempt?.settle?.("cancelled"),this.finishSharedRestore(t,!1)),e===this.sharedActivityGeneration}restorableContentSource(){const e=this.deps.contentPlayer.sourceUrl;if(e&&!e.startsWith("blob:"))return e;const t=this.deps.contentPlayer.videoElement,s=t?.currentSrc||t?.src||"";return s.length>0&&!s.startsWith("blob:")?s:null}}

package/dist/services/adPlayer/SuccessorQueue.d.ts

@@ -0,0 +1,36 @@
+import type { PlayerAdapter } from '../../interfaces/PlayerAdapter';
+import { type Asset, type Break, type StaticAsset } from '../../types/BreakManifest';
+import type { AdPlayerCallbacks } from './AdPlayerCallbacks';
+export interface SuccessorQueueDeps {
+    getAdPlayer: () => PlayerAdapter | null;
+    /** Whether the playing break may keep the next ad buffered (overlay insertion, parallel preload). */
+    isEnabled: () => boolean;
+    buildStaticAssetUrl: (asset: StaticAsset, breakInfo: Break) => string | null;
+    getCallbacks: () => AdPlayerCallbacks | null;
+    log: (...args: unknown[]) => void;
+}
+/**
+ * The next ad, queued on the ad player while the current ad plays: the playing break's next ad,
+ * or during its last ad the chained break's first ad (`prepare-successor` / `drop-successor`).
+ * Ads it cannot queue keep today's load at the switch.
+ */
+export declare class SuccessorQueue {
+    private readonly deps;
+    private entry;
+    constructor(deps: SuccessorQueueDeps);
+    /** Queues `asset` of `breakInfo`; `late` when the successor changed while the last ad played. */
+    prepare(breakInfo: Break, asset: Asset, late: boolean): void;
+    /** Drops the queued item (of `breakId`, when given): it will not play next. */
+    drop(breakId?: string): void;
+    /**
+     * Before a chained break begins: keeps the queued item only when it is buffered and is the ad
+     * `next` opens with, so the switch measurement names the path that actually plays.
+     */
+    confirm(next: Break, firstAsset: Asset | undefined): void;
+    /** At the switch: true when the queued item is this ad and became the current source. */
+    take(breakId: string, assetId: string, uri: string): boolean;
+    /** Teardown: forgets the queued item without reporting it; nothing is listening any more. */
+    reset(): void;
+    private forget;
+    private queueableUri;
+}

package/dist/services/adPlayer/SuccessorQueue.js

@@ -0,0 +1 @@
+import{hasAdSourceQueue as e}from"../../interfaces/AdSourceQueue";import{AssetType as t,MediaType as s}from"../../types/BreakManifest";export class SuccessorQueue{constructor(e){this.deps=e,this.entry=null}prepare(t,s,r){const i=this.queueableUri(t,s),d=this.entry;if(d&&d.breakId===t.id&&d.assetId===s.id&&d.uri===i)return;this.drop();const u=this.deps.getAdPlayer();if(!i||!e(u))return;const n={breakId:t.id,assetId:s.id,uri:i,late:r,buffered:!1};this.entry=n,u.queueNext(i,()=>this.forget(n)).then(e=>{if(this.entry===n){if(!e)return this.entry=null,void this.deps.log("Chained successor not queued; it loads at the switch:",n.breakId);n.buffered=!0,this.deps.getCallbacks()?.onSuccessorBuffered?.(n.breakId,n.late)}},e=>{this.entry===n&&(this.entry=null),this.deps.log("Chained successor queue failed; it loads at the switch:",e)})}drop(t){const s=this.entry;if(!s||void 0!==t&&s.breakId!==t)return;this.entry=null;const r=this.deps.getAdPlayer();e(r)&&r.clearQueued(),s.buffered&&this.deps.getCallbacks()?.onSuccessorDropped?.(s.breakId)}confirm(e,t){const s=this.entry;if(!s)return;const r=t?this.queueableUri(e,t):null;s.buffered&&s.breakId===e.id&&s.assetId===t?.id&&s.uri===r||this.drop()}take(t,s,r){const i=this.entry;if(!i)return!1;const d=this.deps.getAdPlayer();return i.buffered&&i.breakId===t&&i.assetId===s&&i.uri===r&&this.deps.isEnabled()&&e(d)&&d.takeQueued(r)?(this.entry=null,!0):(this.drop(),!1)}reset(){if(!this.entry)return;this.entry=null;const t=this.deps.getAdPlayer();e(t)&&t.clearQueued()}forget(e){this.entry===e&&(this.entry=null,e.buffered&&this.deps.getCallbacks()?.onSuccessorDropped?.(e.breakId))}queueableUri(e,r){return this.deps.isEnabled()?r.type!==t.STATIC||r.mediaType===s.IMAGE?null:this.deps.buildStaticAssetUrl(r,e):null}}

package/dist/services/adPlayer/SurfaceRevealReporter.d.ts

@@ -0,0 +1,28 @@
+/** Native's ad-start deadline: an ad with no picture by then is reported as `reveal-timeout`. */
+export declare const SURFACE_REVEAL_DEADLINE_MS = 10000;
+type Diagnose = (code: string, message: string, context: Record<string, unknown>) => void;
+/**
+ * Reports `DA-AD-SURFACE-REVEALED` once per ad when its first frame is on screen, with the same
+ * fields as Android and iOS. Web shows the surface before the picture unless a pre-roll is held,
+ * so that gap is a distinct reason (`shown-before-frame`, `visibleGapMs`) and never `waitedMs`.
+ */
+export declare class SurfaceRevealReporter {
+    private readonly diagnose;
+    private readonly deadlineMs;
+    private readonly now;
+    private visibleSince;
+    private pending;
+    constructor(diagnose: Diagnose, deadlineMs?: number, now?: () => number);
+    /** The surface carrying the ad is on screen from now on. */
+    surfaceShown(): void;
+    surfaceHidden(): void;
+    /** An ad starts; `video` draws it, or is passed later through `watchVideo` (IMA's own element). */
+    watch(assetId: string, breakId: string, video?: HTMLVideoElement | null): void;
+    /** Chrome, Edge and Firefox stop frame callbacks in a hidden tab, so the deadline only runs while it is visible. */
+    private armDeadline;
+    watchVideo(video: HTMLVideoElement): void;
+    cancel(): void;
+    /** The surface may be shown after the ad started (a held pre-roll), so hidden and visible time split here. */
+    private report;
+}
+export {};

package/dist/services/adPlayer/SurfaceRevealReporter.js

@@ -0,0 +1 @@
+export const SURFACE_REVEAL_DEADLINE_MS=1e4;export class SurfaceRevealReporter{constructor(e,t=1e4,i=()=>performance.now()){this.diagnose=e,this.deadlineMs=t,this.now=i,this.visibleSince=null,this.pending=null}surfaceShown(){this.visibleSince??(this.visibleSince=this.now())}surfaceHidden(){this.visibleSince=null,this.cancel()}watch(e,t,i){this.cancel();const n={assetId:e,breakId:t,armedAt:this.now(),shownAtStart:null!==this.visibleSince,stops:[]};this.pending=n,n.stops.push(this.armDeadline(n)),i&&this.watchVideo(i)}armDeadline(e){let t=this.deadlineMs,i=0,n=null;const s=()=>{i=this.now(),n=setTimeout(()=>this.report(e,!0),t)},a=()=>{null!==n&&(clearTimeout(n),n=null,t=Math.max(0,t-(this.now()-i)))},r=()=>{"hidden"===document.visibilityState?a():null===n&&s()};return"hidden"!==document.visibilityState&&s(),document.addEventListener("visibilitychange",r),()=>{a(),document.removeEventListener("visibilitychange",r)}}watchVideo(e){const t=this.pending;t&&t.stops.push(function(e,t){if("function"==typeof e.requestVideoFrameCallback){const i=e.requestVideoFrameCallback(()=>t());return()=>e.cancelVideoFrameCallback?.(i)}const i=()=>{e.currentTime<=0||(e.removeEventListener("timeupdate",i),t())};return e.addEventListener("timeupdate",i),()=>e.removeEventListener("timeupdate",i)}(e,()=>this.report(t,!1)))}cancel(){this.pending?.stops.forEach(e=>e()),this.pending=null}report(e,t){if(this.pending!==e)return;this.cancel();const i=this.now(),n=this.visibleSince,s=t?"reveal-timeout":e.shownAtStart?"shown-before-frame":"first-frame",a=Math.round(Math.max(0,(n??i)-e.armedAt)),r={reason:s,waitedMs:a,transitionMs:0,cut:!0,assetId:e.assetId,breakId:e.breakId};let o=`Ad surface revealed after ${a}ms (${s})`;if(null!==n){const t=Math.round(Math.max(0,i-Math.max(e.armedAt,n)));r.visibleGapMs=t,o+=`, ${t}ms on screen without a picture`}this.diagnose("DA-AD-SURFACE-REVEALED",o,r)}}

package/dist/services/adPlayer/presentation/DomPresentationHost.d.ts

@@ -0,0 +1,22 @@
+import type { LayoutPlacement } from './PresentationLayout';
+/** The stage surfaces a presentation host places: content, ad, and the backdrop surface. */
+export interface PresentationSurfaces {
+    content: HTMLElement;
+    ad: HTMLElement;
+    backdrop: HTMLElement;
+}
+export interface PresentationHost {
+    getSurfaces(): PresentationSurfaces | null;
+    placeContent(placement: LayoutPlacement): void;
+    placeAd(placement: LayoutPlacement): void;
+    /** Drops pending transition-end work so it cannot touch elements after restore/destroy. */
+    cancelPendingTransitions(): void;
+}
+/** Returns the stage surfaces once all three exist. */
+export declare function toPresentationSurfaces(content: HTMLElement | null | undefined, ad: HTMLElement | null, backdrop: HTMLElement | null): PresentationSurfaces | null;
+/**
+ * Places the stage surfaces with normalized transforms. Placements write only `transform`,
+ * `transition` and `visibility`: the layout properties (`top`/`left`/`right`/`bottom`/`width`/
+ * `height`) belong to the base style and stay untouched so the elements keep their intrinsic size.
+ */
+export declare function createDomPresentationHost(getSurfaces: () => PresentationSurfaces | null): PresentationHost;

package/dist/services/adPlayer/presentation/DomPresentationHost.js

@@ -0,0 +1 @@
+import{jumpToTransform as t,toCssTransform as n,transitionToTransform as e}from"./LayoutTransform";export function toPresentationSurfaces(t,n,e){return t&&n&&e?{content:t,ad:n,backdrop:e}:null}export function createDomPresentationHost(r){const i=new Map,o=t=>{const n=i.get(t);n&&(t.removeEventListener("transitionend",n),i.delete(t))},s=(r,s)=>{o(r);const a=n(s.transform),c=r.style.transform===a;if("none"===s.transition)return c||t(r,s.transform),void(r.style.visibility=s.visible?"":"hidden");e(r,s.transform),s.visible?r.style.visibility="":c?r.style.visibility="hidden":((t,n)=>{const e=e=>{e.target===t&&"transform"===e.propertyName&&t.style.transform===n&&(o(t),t.style.visibility="hidden")};i.set(t,e),t.addEventListener("transitionend",e)})(r,a)};return{getSurfaces:r,placeContent(t){const n=r();n&&s(n.content,t)},placeAd(t){const n=r();n&&s(n.ad,t)},cancelPendingTransitions(){for(const[t,n]of i)t.removeEventListener("transitionend",n);i.clear()}}}

package/dist/services/adPlayer/presentation/LayoutTransform.d.ts

@@ -0,0 +1,28 @@
+/**
+ * A placement of a stage surface: the full-size element scaled around its center, then moved by a
+ * percentage of its own size. Every placement has the same `translate() scale()` shape, so the
+ * browser interpolates between any two of them in a straight line — including when a new placement
+ * interrupts a transition still in flight.
+ */
+export interface LayoutTransform {
+    /** Horizontal move of the element's center, in percent of the element's width. */
+    translateXPercent: number;
+    /** Vertical move of the element's center, in percent of the element's height. */
+    translateYPercent: number;
+    scale: number;
+}
+/** The element fills the stage: no transform at all, so it creates no stacking context. */
+export declare const FULL_SIZE_TRANSFORM: LayoutTransform;
+export declare const LAYOUT_TRANSITION = "transform 0.3s ease-in-out";
+/**
+ * Canonical serializer; full size is `''` (not `scale(1)`) to avoid a stacking context.
+ * Only this serializer's output may be compared against `element.style.transform`.
+ */
+export declare function toCssTransform(transform: LayoutTransform): string;
+/** Animates the element from where it is shown now to the given placement. */
+export declare function transitionToTransform(el: HTMLElement, transform: LayoutTransform): void;
+/**
+ * Puts the element at the given placement right away, without starting a transition.
+ * The forced style read applies the placement before the transition is restored.
+ */
+export declare function jumpToTransform(el: HTMLElement, transform: LayoutTransform): void;

package/dist/services/adPlayer/presentation/LayoutTransform.js

@@ -0,0 +1 @@
+export const FULL_SIZE_TRANSFORM={translateXPercent:0,translateYPercent:0,scale:1};export const LAYOUT_TRANSITION="transform 0.3s ease-in-out";export function toCssTransform(t){const{translateXPercent:n,translateYPercent:r,scale:s}=t;return 0===n&&0===r&&1===s?"":`translate(${n}%, ${r}%) scale(${s})`}export function transitionToTransform(t,n){t.style.transition=LAYOUT_TRANSITION,t.style.transform=toCssTransform(n)}export function jumpToTransform(t,n){t.style.transition="none",t.style.transform=toCssTransform(n),getComputedStyle(t).transform,t.style.transition=LAYOUT_TRANSITION}

package/dist/services/adPlayer/presentation/PresentationLayout.d.ts

@@ -0,0 +1,19 @@
+import { BreakFormat } from '../../../types/BreakManifest';
+import { LayoutTransform } from './LayoutTransform';
+/** Where a layout places one stage surface, and whether the move is animated. */
+export interface LayoutPlacement {
+    transform: LayoutTransform;
+    visible: boolean;
+    transition: 'none' | 'animated';
+}
+export interface PresentationLayout {
+    content: LayoutPlacement;
+    ad: LayoutPlacement;
+}
+/** Content returns to full size, animated — the placement restoreLayout() moves to. */
+export declare const RESTORED_CONTENT_PLACEMENT: LayoutPlacement;
+/**
+ * The presentation layout for a break format, or `null` when the format is not a layout state:
+ * `overlay` positions its surface from manifest values and unknown formats keep the base style.
+ */
+export declare function presentationLayoutFor(format: BreakFormat): PresentationLayout | null;

package/dist/services/adPlayer/presentation/PresentationLayout.js

@@ -0,0 +1 @@
+import{BreakFormat as t}from"../../../types/BreakManifest";import{FULL_SIZE_TRANSFORM as n}from"./LayoutTransform";export const RESTORED_CONTENT_PLACEMENT={transform:n,visible:!0,transition:"animated"};const e=.4792,r={translateXPercent:-12.5,translateYPercent:-12.5,scale:.65};export function presentationLayoutFor(a){switch(a){case t.SINGLE:return{content:{transform:n,visible:!0,transition:"animated"},ad:{transform:n,visible:!0,transition:"none"}};case t.DOUBLE:return{content:{transform:{translateXPercent:-25,translateYPercent:0,scale:e},visible:!0,transition:"animated"},ad:{transform:{translateXPercent:25,translateYPercent:0,scale:e},visible:!0,transition:"none"}};case t.LSHAPE_AD:return{content:{transform:r,visible:!1,transition:"animated"},ad:{transform:r,visible:!0,transition:"none"}};case t.LSHAPE_CONTENT:return{content:{transform:r,visible:!0,transition:"animated"},ad:{transform:n,visible:!0,transition:"none"}};default:return null}}

package/dist/services/assetParameterMacroTable.js

@@ -1 +1 @@
-import{OPTIVIEW_ASSET_PARAMETER_MACROS as e,resolveAssetParameterMacro as r}from"./assetParameterMacros";export function buildAssetParameterMacroTable(t){const n={};for(const r of Object.values(e))n[r]=()=>{switch(r){case e.USER_AGENT:return"undefined"!=typeof navigator?navigator.userAgent:void 0;case e.PLAYER_WIDTH:return t.element?String(Math.round(t.element.clientWidth)):void 0;case e.PLAYER_HEIGHT:return t.element?String(Math.round(t.element.clientHeight)):void 0;case e.BREAK_DURATION_MS:return void 0===t.breakDurationSec?void 0:String(Math.round(1e3*t.breakDurationSec));case e.BREAK_DURATION_SECONDS:return void 0===t.breakDurationSec?void 0:String(t.breakDurationSec);default:return}};for(const e of Object.keys(t.customerMacros)){const o=n[e];n[e]=()=>{const n=r(t.customerMacros[e]);return void 0===n?o?.():n}}return n}
+import{OPTIVIEW_ASSET_PARAMETER_MACROS as e,resolveAssetParameterMacro as t}from"./assetParameterMacros";export function buildAssetParameterMacroTable(r){const n={};for(const t of Object.values(e))n[t]=()=>{switch(t){case e.USER_AGENT:return"undefined"!=typeof navigator?navigator.userAgent:void 0;case e.PLAYER_WIDTH:return r.element?String(Math.round(r.element.clientWidth)):void 0;case e.PLAYER_HEIGHT:return r.element?String(Math.round(r.element.clientHeight)):void 0;case e.BREAK_DURATION_MS:return void 0===r.breakDurationSec?void 0:String(Math.round(1e3*r.breakDurationSec));case e.BREAK_DURATION_SECONDS:return void 0===r.breakDurationSec?void 0:String(r.breakDurationSec);default:return}};for(const e of Object.keys(r.customerMacros)){const o=r.customerMacros[e];if(void 0===o)continue;const a=n[e];n[e]=()=>{try{const e=t(o);return""===e||null==e?null:e}catch(t){return console.warn(`[OptiViewAds] Failed to evaluate asset parameter macro '${e}'.`,t),a?.()}}}return n}

package/dist/services/assetParameterMacros.d.ts

@@ -16,8 +16,8 @@
  *    `unresolved` (the caller diagnoses `DA-ASSET-MACRO-UNKNOWN`).
  * 3. Any other unresolved token is kept literally, since it may be a vendor
  *    macro the ad server itself expands, and is not reported.
- * 4. A macro resolving to `null` omits its parameter; GAM `cust_params` drops only
- *    the `&`-separated pair containing the macro.
+ * 4. A macro resolving to `null` or `""` omits its parameter. In a value with
+ *    a literal `&`, only the pair containing the macro is dropped.
  *
  * Matching is case-sensitive. Who fills the macro table is platform glue: the
  * runtime puts the customer's registered macros in front of the built-in
@@ -33,17 +33,17 @@ export declare const OPTIVIEW_ASSET_PARAMETER_MACROS: {
     readonly BREAK_DURATION_SECONDS: '$OPTIVIEW_BREAK_DURATION_SECONDS$';
 };
 export type AssetParameterMacroScope = 'session' | 'break';
-export type AssetParameterTarget = 'gam' | 'vast';
 export declare const OPTIVIEW_ASSET_PARAMETER_MACRO_SCOPES: Record<string, AssetParameterMacroScope>;
-/** A macro's replacement text, `null` when the parameter is empty, or `undefined` when no value is available. @category Manifest Customization */
+/** A macro replacement: `""`, `null`, or a registered callback's `undefined` result is empty; a core-table `undefined` is unresolved. An undefined customer map entry is unregistered, and `updateAssetParameterMacros` uses it to unregister a name. @category Manifest Customization */
 export type AssetParameterMacroValue = string | null | undefined;
 /**
  * A customer macro: a fixed value, or a callback invoked with no arguments
- * right before the URL is built. `null` omits parameters that use the macro;
- * `undefined` means "no value" and falls through to the built-ins.
+ * right before the URL is built. `""`, `null`, and a callback result of
+ * `undefined` omit parameters that use the macro. An undefined map entry is
+ * not registered; in an update it unregisters the name.
  * @category Manifest Customization */
 export type AssetParameterMacro = AssetParameterMacroValue | (() => AssetParameterMacroValue);
-/** Customer-registered macros, keyed by the full token (`'$CUSTOM_MACRO$'`). @category Manifest Customization */
+/** Customer-registered macros, keyed by the full token (`'$CUSTOM_MACRO$'`); an `undefined` entry is not registered. @category Manifest Customization */
 export type AssetParameterMacros = Record<string, AssetParameterMacro>;
 /**
  * Every macro that has a definition, keyed by token, each producing its value
@@ -60,7 +60,7 @@ export interface AppliedAssetParameters {
     params: Record<string, string> | undefined;
     /** Unresolved macros, ordered by sorted parameter key and scan order. */
     unresolved: UnresolvedAssetParameterMacro[];
-    /** Omitted parameters, ordered by sorted parameter key, then cust_params pair order. */
+    /** Omitted parameters, ordered by sorted parameter key, then pair order. */
     omitted: OmittedAssetParameter[];
 }
 export interface OmittedAssetParameter {
@@ -68,7 +68,7 @@ export interface OmittedAssetParameter {
     macro: string;
     pair?: string;
 }
-export declare function applyAssetParameterMacros(params: Record<string, string> | undefined, macros: AssetParameterMacroTable, target: AssetParameterTarget): AppliedAssetParameters;
+export declare function applyAssetParameterMacros(params: Record<string, string> | undefined, macros: AssetParameterMacroTable): AppliedAssetParameters;
 /**
  * Append `params` to `url` as `key=value` query parameters, before any
  * `#fragment`, reusing an existing `?`. Keys are sorted so the three cores

package/dist/services/assetParameterMacros.js

@@ -1 +1 @@
-export const OPTIVIEW_MACRO_PREFIX="$OPTIVIEW_";export const OPTIVIEW_ASSET_PARAMETER_MACROS={USER_AGENT:"$OPTIVIEW_USER_AGENT$",PLAYER_WIDTH:"$OPTIVIEW_PLAYER_WIDTH$",PLAYER_HEIGHT:"$OPTIVIEW_PLAYER_HEIGHT$",BREAK_DURATION_MS:"$OPTIVIEW_BREAK_DURATION_MS$",BREAK_DURATION_SECONDS:"$OPTIVIEW_BREAK_DURATION_SECONDS$"};export const OPTIVIEW_ASSET_PARAMETER_MACRO_SCOPES={[OPTIVIEW_ASSET_PARAMETER_MACROS.USER_AGENT]:"session",[OPTIVIEW_ASSET_PARAMETER_MACROS.PLAYER_WIDTH]:"session",[OPTIVIEW_ASSET_PARAMETER_MACROS.PLAYER_HEIGHT]:"session",[OPTIVIEW_ASSET_PARAMETER_MACROS.BREAK_DURATION_MS]:"break",[OPTIVIEW_ASSET_PARAMETER_MACROS.BREAK_DURATION_SECONDS]:"break"};export function resolveAssetParameterMacro(e){return"function"==typeof e?e():e}export function applyAssetParameterMacros(o,n,s){const r=o??{},E={},i=[],_=[];for(const o of Object.keys(r).sort()){if("gam"===s&&"cust_params"===o){const e=t(r[o],n);void 0!==e.value&&(E[o]=e.value),_.push(...e.omitted.map(({macro:e,pair:t})=>({key:o,macro:e,pair:t}))),i.push(...e.unresolved.map(e=>({key:o,macro:e})));continue}const A=e(r[o],n);void 0===A.omittedBy?(E[o]=A.value,i.push(...A.unresolved.map(e=>({key:o,macro:e})))):_.push({key:o,macro:A.omittedBy})}return{params:Object.keys(E).length>0?E:void 0,unresolved:i,omitted:_}}function e(e,t){let o="",s=0;const r=[],E=new Set;for(;s<e.length;){const i=e.indexOf("$",s);if(-1===i){o+=e.slice(s);break}o+=e.slice(s,i);const _=n(e,i);if(void 0===_){o+="$",s=i+1;continue}const A=t[_]?.();if(null===A)return{value:"",unresolved:[],omittedBy:_};void 0!==A?o+=A:(o+=_,!_.startsWith("$OPTIVIEW_")&&!(_ in t)||E.has(_)||(r.push(_),E.add(_))),s=i+_.length}return{value:o,unresolved:r}}function t(t,o){const n=[],s=[],r=[];for(const E of t.split("&")){const t=e(E,o);void 0===t.omittedBy?(n.push(t.value),s.push(...t.unresolved)):r.push({macro:t.omittedBy,pair:E})}return{value:n.length>0?n.join("&"):void 0,unresolved:s,omitted:r}}function o(e){return e>="A"&&e<="Z"||e>="a"&&e<="z"||e>="0"&&e<="9"||"_"===e}function n(e,t){let n=t+1;for(;n<e.length&&o(e[n]);)n++;return n>t+1&&"$"===e[n]?e.slice(t,n+1):void 0}export function appendQueryParameters(e,t){const o=t??{},n=Object.keys(o).sort();if(0===n.length)return e;if(/^data:/i.test(e))return e;const s=n.map(e=>`${encodeURIComponent(e)}=${encodeURIComponent(o[e])}`).join("&"),r=e.indexOf("#"),E=-1===r?e:e.slice(0,r),i=-1===r?"":e.slice(r),_=E.includes("?")?E.endsWith("?")||E.endsWith("&")?"":"&":"?";return`${E}${_}${s}${i}`}
+export const OPTIVIEW_MACRO_PREFIX="$OPTIVIEW_";export const OPTIVIEW_ASSET_PARAMETER_MACROS={USER_AGENT:"$OPTIVIEW_USER_AGENT$",PLAYER_WIDTH:"$OPTIVIEW_PLAYER_WIDTH$",PLAYER_HEIGHT:"$OPTIVIEW_PLAYER_HEIGHT$",BREAK_DURATION_MS:"$OPTIVIEW_BREAK_DURATION_MS$",BREAK_DURATION_SECONDS:"$OPTIVIEW_BREAK_DURATION_SECONDS$"};export const OPTIVIEW_ASSET_PARAMETER_MACRO_SCOPES={[OPTIVIEW_ASSET_PARAMETER_MACROS.USER_AGENT]:"session",[OPTIVIEW_ASSET_PARAMETER_MACROS.PLAYER_WIDTH]:"session",[OPTIVIEW_ASSET_PARAMETER_MACROS.PLAYER_HEIGHT]:"session",[OPTIVIEW_ASSET_PARAMETER_MACROS.BREAK_DURATION_MS]:"break",[OPTIVIEW_ASSET_PARAMETER_MACROS.BREAK_DURATION_SECONDS]:"break"};export function resolveAssetParameterMacro(e){return"function"==typeof e?e():e}export function applyAssetParameterMacros(o,n){const s=o??{},r={},E=[],i=[];for(const o of Object.keys(s).sort()){if(s[o].includes("&")){const e=t(s[o],n);void 0!==e.value&&(r[o]=e.value),i.push(...e.omitted.map(({macro:e,pair:t})=>({key:o,macro:e,pair:t}))),E.push(...e.unresolved.map(e=>({key:o,macro:e})));continue}const A=e(s[o],n);void 0===A.omittedBy?(r[o]=A.value,E.push(...A.unresolved.map(e=>({key:o,macro:e})))):i.push({key:o,macro:A.omittedBy})}return{params:Object.keys(r).length>0?r:void 0,unresolved:E,omitted:i}}function e(e,t){let o="",s=0;const r=[],E=new Set;for(;s<e.length;){const i=e.indexOf("$",s);if(-1===i){o+=e.slice(s);break}o+=e.slice(s,i);const A=n(e,i);if(void 0===A){o+="$",s=i+1;continue}const _=t[A]?.();if(null===_||""===_)return{value:"",unresolved:[],omittedBy:A};void 0!==_?o+=_:(o+=A,!A.startsWith("$OPTIVIEW_")&&!(A in t)||E.has(A)||(r.push(A),E.add(A))),s=i+A.length}return{value:o,unresolved:r}}function t(t,o){const n=[],s=[],r=new Set,E=[];for(const i of t.split("&")){const t=e(i,o);if(void 0===t.omittedBy){n.push(t.value);for(const e of t.unresolved)r.has(e)||(r.add(e),s.push(e))}else E.push({macro:t.omittedBy,pair:i})}return{value:n.length>0?n.join("&"):void 0,unresolved:s,omitted:E}}function o(e){return e>="A"&&e<="Z"||e>="a"&&e<="z"||e>="0"&&e<="9"||"_"===e}function n(e,t){let n=t+1;for(;n<e.length&&o(e[n]);)n++;return n>t+1&&"$"===e[n]?e.slice(t,n+1):void 0}export function appendQueryParameters(e,t){const o=t??{},n=Object.keys(o).sort();if(0===n.length)return e;if(/^data:/i.test(e))return e;const s=n.map(e=>`${encodeURIComponent(e)}=${encodeURIComponent(o[e])}`).join("&"),r=e.indexOf("#"),E=-1===r?e:e.slice(0,r),i=-1===r?"":e.slice(r),A=E.includes("?")?E.endsWith("?")||E.endsWith("&")?"":"&":"?";return`${E}${A}${s}${i}`}

package/dist/services/channelSwitch.d.ts

@@ -9,7 +9,7 @@ export interface ChannelSwitch {
     previousChannelId: string | null;
     channelId: string | null;
 }
-export type DeliveryModeSource = 'manifest' | 'channel-switch' | 'config';
+export type DeliveryModeSource = 'manifest' | 'channel-switch' | 'event-boundary' | 'config';
 export interface DeliveryModeDecision {
     /** Mode the manifest rules resolve to before the explicit config mode is applied. */
     manifestMode: OptiViewAdsMode;
@@ -20,7 +20,7 @@ export interface DeliveryModeDecision {
     targetingIssues: TargetingIssue[];
     source: DeliveryModeSource;
 }
-export declare function decideDeliveryMode(manifest: BreakManifest, deviceProfile: DeviceType | DeviceProfile, explicitMode: OptiViewAdsMode | null, source: 'manifest' | 'channel-switch'): DeliveryModeDecision;
+export declare function decideDeliveryMode(manifest: BreakManifest, deviceProfile: DeviceType | DeviceProfile, explicitMode: OptiViewAdsMode | null, source: DeliveryModeSource): DeliveryModeDecision;
 /** Blank ids count as absent: the backend omits the field, a proxy may emit `""`. */
 export declare function normalizeChannelId(channelId: string | undefined): string | null;
 /** True when the new manifest needs a new IMA session (different network or custom asset key). */

package/dist/services/externalPlaybackDiagnostic.d.ts

@@ -0,0 +1,3 @@
+import type { KnownDiagnosticCode } from '../diagnostics/errorCodes';
+/** Reports an `externalplaybackchange` payload as `DA-EXTERNAL-PLAYBACK-CHANGED`. */
+export declare function diagnoseExternalPlaybackChange(change: unknown, diagnose: (code: KnownDiagnosticCode, message: string, context?: Record<string, unknown>) => void): void;

package/dist/services/externalPlaybackDiagnostic.js

@@ -0,0 +1 @@
+export function diagnoseExternalPlaybackChange(a,t){const{state:e,target:n}=a??{};t("DA-EXTERNAL-PLAYBACK-CHANGED",`External playback ${e??"changed"}`,{state:e,target:n})}

package/dist/services/externalPlaybackGuard.d.ts

@@ -0,0 +1,24 @@
+/** What the guard needs to know about the break timeline at the moment AirPlay is requested. */
+export interface ExternalPlaybackGuardInput {
+    /** The break that is playing now, or null. */
+    activeBreakId: string | null;
+    /** The nearest scheduled break that has not started, or null. */
+    nextBreakId: string | null;
+    /** Seconds until `nextBreakId` starts (negative once its start has passed), or null when unknown. */
+    secondsUntilNextBreak: number | null;
+    /** Window before a break in which AirPlay may not start; already sanitised (not negative). */
+    blockBeforeBreakSec: number;
+}
+export type ExternalPlaybackBlockReason = 'break-active' | 'break-imminent';
+export type ExternalPlaybackGuardDecision = {
+    allowed: true;
+} | {
+    allowed: false;
+    reason: ExternalPlaybackBlockReason;
+    breakId: string;
+};
+/**
+ * Whether the content player may start AirPlay now: not while a break plays, and not within
+ * `blockBeforeBreakSec` of the next one (inclusive, so a window of 0 blocks only a break that is due).
+ */
+export declare function decideExternalPlaybackGuard(input: ExternalPlaybackGuardInput): ExternalPlaybackGuardDecision;

package/dist/services/externalPlaybackGuard.js

@@ -0,0 +1 @@
+export function decideExternalPlaybackGuard(e){return null!==e.activeBreakId?{allowed:!1,reason:"break-active",breakId:e.activeBreakId}:null!==e.nextBreakId&&null!==e.secondsUntilNextBreak&&e.secondsUntilNextBreak<=e.blockBeforeBreakSec?{allowed:!1,reason:"break-imminent",breakId:e.nextBreakId}:{allowed:!0}}

package/dist/services/parseBreakManifest.d.ts

@@ -1,4 +1,5 @@
 import { BreakManifest } from '../types/BreakManifest';
+import type { ChannelEventIssue } from './resolveChannelEvents';
 /**
  * Supported major version of the break manifest.
  */
@@ -12,4 +13,4 @@ export declare const SUPPORTED_MANIFEST_MAJOR_VERSION = 1;
  *
  * @throws Error when the data is not a valid v1 break manifest.
  */
-export declare function parseBreakManifest(data: unknown): BreakManifest;
+export declare function parseBreakManifest(data: unknown, onEventIssue?: (issue: ChannelEventIssue) => void): BreakManifest;

package/dist/services/parseBreakManifest.js

@@ -1 +1 @@
-export const SUPPORTED_MANIFEST_MAJOR_VERSION=1;export function parseBreakManifest(r){if(!r||"object"!=typeof r)throw new Error("Invalid manifest: expected object");const t=r;if("string"!=typeof t.version)throw new Error("Invalid manifest: missing version");if(1!==parseInt(t.version.split(".")[0],10))throw new Error(`Unsupported manifest version: ${t.version}. Supported major version: 1`);const n=t.timebase;if("wallclock"!==n&&"pts"!==n&&"mediatime"!==n)throw new Error("Invalid manifest: invalid or missing timebase");if(!Array.isArray(t.breaks))throw new Error("Invalid manifest: breaks must be an array");for(const r of t.breaks)e(r);if(void 0!==t.delivery){if(!Array.isArray(t.delivery)||0===t.delivery.length)throw new Error("Invalid manifest: delivery must be a non-empty array");for(const e of t.delivery)if(!e||"object"!=typeof e||"string"!=typeof e.mode)throw new Error("Invalid manifest: each delivery rule must have a string mode")}if(void 0!==t.vendorConfiguration&&!Array.isArray(t.vendorConfiguration))throw new Error("Invalid manifest: vendorConfiguration must be an array");if(void 0!==t.adStartDelay&&("number"!=typeof t.adStartDelay||!Number.isFinite(t.adStartDelay)||t.adStartDelay<0))throw new Error("Invalid manifest: adStartDelay must be a number >= 0");return t}function e(e){if(!e||"object"!=typeof e)return;const r=e.start;if(!r||"object"!=typeof r)return;const t=r;if("event"!==t.type||"string"!=typeof t.event)throw new Error('Invalid manifest: break start object must be { type: "event", event: string }');if(void 0!==t.delay&&("number"!=typeof t.delay||!Number.isFinite(t.delay)||t.delay<0))throw new Error("Invalid manifest: event trigger delay must be a number >= 0")}
+import{parseChannelEvents as e}from"./resolveChannelEvents";export const SUPPORTED_MANIFEST_MAJOR_VERSION=1;export function parseBreakManifest(t,n){if(!t||"object"!=typeof t)throw new Error("Invalid manifest: expected object");const i=t;if("string"!=typeof i.version)throw new Error("Invalid manifest: missing version");if(1!==parseInt(i.version.split(".")[0],10))throw new Error(`Unsupported manifest version: ${i.version}. Supported major version: 1`);const o=i.timebase;if("wallclock"!==o&&"pts"!==o&&"mediatime"!==o)throw new Error("Invalid manifest: invalid or missing timebase");if(!Array.isArray(i.breaks))throw new Error("Invalid manifest: breaks must be an array");for(const e of i.breaks)r(e);if(void 0!==i.delivery){if(!Array.isArray(i.delivery)||0===i.delivery.length)throw new Error("Invalid manifest: delivery must be a non-empty array");for(const e of i.delivery)if(!e||"object"!=typeof e||"string"!=typeof e.mode)throw new Error("Invalid manifest: each delivery rule must have a string mode")}if(void 0!==i.vendorConfiguration&&!Array.isArray(i.vendorConfiguration))throw new Error("Invalid manifest: vendorConfiguration must be an array");if(void 0!==i.adStartDelay&&("number"!=typeof i.adStartDelay||!Number.isFinite(i.adStartDelay)||i.adStartDelay<0))throw new Error("Invalid manifest: adStartDelay must be a number >= 0");const a=i,s=e(i.events,o);s.issues.forEach(e=>n?.(e));const f={...a};return delete f.events,{...f,...void 0===s.events?{}:{events:s.events}}}function r(e){if(!e||"object"!=typeof e)return;const r=e.start;if(!r||"object"!=typeof r)return;const t=r;if("event"!==t.type||"string"!=typeof t.event)throw new Error('Invalid manifest: break start object must be { type: "event", event: string }');if(void 0!==t.delay&&("number"!=typeof t.delay||!Number.isFinite(t.delay)||t.delay<0))throw new Error("Invalid manifest: event trigger delay must be a number >= 0")}

package/dist/services/resolveChannelEvents.d.ts

@@ -0,0 +1,17 @@
+import { Timebase } from '../types/BreakManifest';
+import type { BreakManifest, ChannelEvent } from '../types/BreakManifest';
+export interface ChannelEventIssue {
+    key: string;
+    message: string;
+    context: Record<string, unknown>;
+}
+export declare function parseChannelEvents(raw: unknown, timebase: Timebase): {
+    events: ChannelEvent[] | undefined;
+    issues: ChannelEventIssue[];
+};
+export declare function resolveActiveEvent(manifest: BreakManifest, positionMs: number): ChannelEvent | null;
+export declare function resolveEventManifest(manifest: BreakManifest, positionMs: number): {
+    manifest: BreakManifest;
+    eventId: string | null;
+};
+export declare function nextEventBoundaryMs(manifest: BreakManifest, positionMs: number): number | null;

package/dist/services/resolveChannelEvents.js

@@ -0,0 +1 @@
+import{Timebase as e}from"../types/BreakManifest";const t=/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?(?:Z|[+-]\d{2}:\d{2})$/;function n(e){if("string"!=typeof e||!t.test(e))return null;const n=Date.parse(e);return Number.isFinite(n)?n:null}export function parseChannelEvents(t,i){if(void 0===t)return{events:void 0,issues:[]};if(i!==e.WALLCLOCK)return{events:void 0,issues:[{key:"non-wallclock",message:"Ignored events because the manifest timebase is not wallclock.",context:{timebase:i}}]};if(!Array.isArray(t))return{events:void 0,issues:[{key:"not-array",message:"Ignored events because the value is not an array.",context:{}}]};const r=[],a=[];return t.forEach((e,t)=>{const i=e&&"object"==typeof e?e:{},o="string"==typeof i.id&&i.id.trim()?i.id:null,d=(e,n)=>{a.push({key:`${o??t}:${e}`,message:n,context:{...o?{eventId:o}:{},index:t}})};if(!o)return void d("missing-id","Ignored event without a non-empty id.");const s=n(i.start),l=n(i.end);null!==s&&null!==l?l<=s?d("invalid-range","Ignored event whose end is not after its start."):void 0===i.adStartDelay||"number"==typeof i.adStartDelay&&Number.isFinite(i.adStartDelay)&&!(i.adStartDelay<0)?void 0===i.delivery||Array.isArray(i.delivery)&&0!==i.delivery.length&&!i.delivery.some(e=>!e||"object"!=typeof e||"string"!=typeof e.mode)?void 0===i.vendorConfiguration||Array.isArray(i.vendorConfiguration)?r.push(i):d("invalid-vendor-configuration","Ignored event with invalid vendorConfiguration."):d("invalid-delivery","Ignored event with invalid delivery rules."):d("invalid-ad-start-delay","Ignored event with an invalid adStartDelay."):d("invalid-time","Ignored event with an invalid start or end timestamp.")}),{events:r,issues:a}}export function resolveActiveEvent(t,i){return t.timebase===e.WALLCLOCK&&Number.isFinite(i)?t.events?.filter(e=>{const t=n(e.start),r=n(e.end);return null!==t&&null!==r&&r>t&&t<=i&&i<r}).at(-1)??null:null}export function resolveEventManifest(e,t){const n=resolveActiveEvent(e,t),i=void 0===e.events?e.eventId??null:n?.id??null;if(!n){const t={...e};return delete t.eventId,{manifest:void 0===e.events?e:t,eventId:i}}const r=n.adStartDelay??e.adStartDelay,a=n.delivery??e.delivery,o=n.vendorConfiguration??e.vendorConfiguration;return{manifest:{...e,eventId:i,...void 0===r?{}:{adStartDelay:r},...void 0===a?{}:{delivery:a},...void 0===o?{}:{vendorConfiguration:o}},eventId:i}}export function nextEventBoundaryMs(t,i){if(t.timebase!==e.WALLCLOCK||!Number.isFinite(i))return null;const r=(t.events??[]).flatMap(e=>[n(e.start),n(e.end)]).filter(e=>null!==e&&e>i);return r.length?Math.min(...r):null}

package/dist/services/resolveExternalVendorConfigurations.js

@@ -1 +1 @@
-import{applyAssetParameterMacros as r}from"./assetParameterMacros";import{objectEntries as e,objectFromEntries as t}from"./runtimeObject";export function changedExternalVendorProviders(r,e){const t=new Map(r.map(r=>[r.provider,r])),n=new Set(e.map(r=>r.provider)),o=e.filter(r=>{const e=t.get(r.provider);return void 0===e||!function(r,e){const t=Object.keys(r);return t.length===Object.keys(e).length&&t.every(t=>Object.prototype.hasOwnProperty.call(e,t)&&r[t]===e[t])}(e.assetParameters,r.assetParameters)}).map(r=>r.provider);for(const e of r)n.has(e.provider)||o.push(e.provider);return o}function n(r){if("object"!=typeof r||null===r||Array.isArray(r))return!1;const e=Object.getPrototypeOf(r);return e===Object.prototype||null===e}function o(r){return"string"==typeof r&&""!==r.trim()}function s(r){return n(r)?t(e(r).filter(r=>"string"==typeof r[1])):null}export function resolveExternalVendorConfigurations(r){const e=r.vendorConfiguration,t=[],i=[],a=new Set;let u=0;if(!Array.isArray(e))return{entries:t,duplicateProviders:i,invalidCount:u};for(const r of e){if(!n(r)||"external"!==r.type)continue;const e=s(r.assetParameters);if(!o(r.provider)||null===e){u+=1;continue}const p=r.provider;a.has(p)?i.includes(p)||i.push(p):(a.add(p),t.push({provider:p,assetParameters:e}))}return{entries:t,duplicateProviders:i,invalidCount:u}}export function resolveExternalVendorParameters(e,t,n){const o={...t??{},...e.assetParameters},s=r(o,n,"gam");return{configuration:{provider:e.provider,assetParameters:s.params??{}},unresolved:s.unresolved,omitted:s.omitted}}
+import{applyAssetParameterMacros as r}from"./assetParameterMacros";import{objectEntries as e,objectFromEntries as t}from"./runtimeObject";export function changedExternalVendorProviders(r,e){const t=new Map(r.map(r=>[r.provider,r])),n=new Set(e.map(r=>r.provider)),o=e.filter(r=>{const e=t.get(r.provider);return void 0===e||!function(r,e){const t=Object.keys(r);return t.length===Object.keys(e).length&&t.every(t=>Object.prototype.hasOwnProperty.call(e,t)&&r[t]===e[t])}(e.assetParameters,r.assetParameters)}).map(r=>r.provider);for(const e of r)n.has(e.provider)||o.push(e.provider);return o}function n(r){if("object"!=typeof r||null===r||Array.isArray(r))return!1;const e=Object.getPrototypeOf(r);return e===Object.prototype||null===e}function o(r){return"string"==typeof r&&""!==r.trim()}function s(r){return n(r)?t(e(r).filter(r=>"string"==typeof r[1])):null}export function resolveExternalVendorConfigurations(r){const e=r.vendorConfiguration,t=[],i=[],a=new Set;let u=0;if(!Array.isArray(e))return{entries:t,duplicateProviders:i,invalidCount:u};for(const r of e){if(!n(r)||"external"!==r.type)continue;const e=s(r.assetParameters);if(!o(r.provider)||null===e){u+=1;continue}const p=r.provider;a.has(p)?i.includes(p)||i.push(p):(a.add(p),t.push({provider:p,assetParameters:e}))}return{entries:t,duplicateProviders:i,invalidCount:u}}export function resolveExternalVendorParameters(e,t,n){const o={...t??{},...e.assetParameters},s=r(o,n);return{configuration:{provider:e.provider,assetParameters:s.params??{}},unresolved:s.unresolved,omitted:s.omitted}}

package/dist/services/resolveGamVendorConfiguration.d.ts

@@ -1,4 +1,4 @@
-import type { BreakManifest } from '../types/BreakManifest';
+import type { BreakManifest, GamSsbConfiguration, VendorConfiguration } from '../types/BreakManifest';
 /**
  * GAM stream identity for the IMA/DAI session. Both required: a blank value yields a pod URL like
  * `.../network//custom_asset/...` whose 404 reads as a GAM outage instead of a config error.
@@ -32,6 +32,11 @@ export interface GamVendorConfigurationResult {
  * per type (FIRST `gam` wins, duplicate reported), unknown types ignored and collected.
  */
 export declare function resolveGamVendorConfiguration(manifest: Pick<BreakManifest, 'vendorConfiguration'>): GamVendorConfigurationResult;
+/**
+ * The channel's SSB stream: the first `ssai[]` item of the first `gam` entry whose `ssb` carries a
+ * non-blank `uri`. An `ssb` without a usable `uri` counts as absent. `drm` is kept as an opaque object.
+ */
+export declare function resolveSsbStream(vendorConfiguration: VendorConfiguration[] | undefined): GamSsbConfiguration | null;
 /** One field on which a pod asset disagrees with the session it would be served under. */
 export interface GamPodIdentityMismatch {
     field: 'networkCode' | 'customAssetKey';

package/dist/services/resolveGamVendorConfiguration.js

@@ -1 +1 @@
-import{objectEntries as e,objectFromEntries as s}from"./runtimeObject";function t(e){return"string"==typeof e&&""!==e.trim()?e:null}export function resolveGamVendorConfiguration(e){const s=e.vendorConfiguration,o={identity:null,unknownTypes:[],duplicateGam:!1,sgaiAssetParameters:void 0,ssai:null};if(!Array.isArray(s))return{...o,reason:"absent"};const r=[];let a=null,i=0;for(const e of s){if("object"!=typeof e||null===e)continue;const s=e,n=t(s.type);null!==n&&("gam"!==n?"external"!==n&&(r.includes(n)||r.push(n)):(i+=1,null===a&&(a=s)))}const u=i>1;if(null===a)return{...o,reason:"absent",unknownTypes:r,duplicateGam:u};const l=t(a.networkCode);if(null===l)return{...o,reason:"missing-network-code",unknownTypes:r,duplicateGam:u};const c=Array.isArray(a.ssai)?a.ssai[0]:void 0,y=("object"==typeof c&&null!==c?t(c.assetKey):null)??t(a.assetKey),f=y?{networkCode:l,assetKey:y,assetParameters:n("object"==typeof c&&null!==c?c.assetParameters:void 0)}:null,m=Array.isArray(a.sgai)?a.sgai[0]:void 0,d=("object"==typeof m&&null!==m?t(m.customAssetKey):null)??t(a.customAssetKey);if(null===d)return{...o,reason:"missing-custom-asset-key",unknownTypes:r,duplicateGam:u,ssai:f};return{identity:{networkCode:l,customAssetKey:d},reason:"ok",unknownTypes:r,duplicateGam:u,sgaiAssetParameters:n("object"==typeof m&&null!==m?m.assetParameters:void 0),ssai:f}}function n(t){if("object"!=typeof t||null===t||Array.isArray(t))return;const n=s(e(t).filter(e=>"string"==typeof e[1]));return Object.keys(n).length>0?n:void 0}export function gamPodIdentityMismatches(e,s){const t=[];return s.networkCode!==e.networkCode&&t.push({field:"networkCode",assetValue:s.networkCode,sessionValue:e.networkCode}),s.customAssetKey!==e.customAssetKey&&t.push({field:"customAssetKey",assetValue:s.customAssetKey,sessionValue:e.customAssetKey}),t}export function manifestHasGamAssets(e){for(const s of e.breaks??[]){const e=[...s.variants??[],...s.variant?[s.variant]:[]];for(const s of e)for(const e of s?.assets??[])if("gam"===e?.vendor)return!0}return!1}
+import{objectEntries as e,objectFromEntries as t}from"./runtimeObject";function s(e){return"string"==typeof e&&""!==e.trim()?e:null}export function resolveGamVendorConfiguration(e){const t=e.vendorConfiguration,n={identity:null,unknownTypes:[],duplicateGam:!1,sgaiAssetParameters:void 0,ssai:null};if(!Array.isArray(t))return{...n,reason:"absent"};const o=[];let a=null,i=0;for(const e of t){if("object"!=typeof e||null===e)continue;const t=e,n=s(t.type);null!==n&&("gam"!==n?"external"!==n&&(o.includes(n)||o.push(n)):(i+=1,null===a&&(a=t)))}const u=i>1;if(null===a)return{...n,reason:"absent",unknownTypes:o,duplicateGam:u};const l=s(a.networkCode);if(null===l)return{...n,reason:"missing-network-code",unknownTypes:o,duplicateGam:u};const c=Array.isArray(a.ssai)?a.ssai[0]:void 0,f=("object"==typeof c&&null!==c?s(c.assetKey):null)??s(a.assetKey),y=f?{networkCode:l,assetKey:f,assetParameters:r("object"==typeof c&&null!==c?c.assetParameters:void 0)}:null,m=Array.isArray(a.sgai)?a.sgai[0]:void 0,d=("object"==typeof m&&null!==m?s(m.customAssetKey):null)??s(a.customAssetKey);if(null===d)return{...n,reason:"missing-custom-asset-key",unknownTypes:o,duplicateGam:u,ssai:y};return{identity:{networkCode:l,customAssetKey:d},reason:"ok",unknownTypes:o,duplicateGam:u,sgaiAssetParameters:r("object"==typeof m&&null!==m?m.assetParameters:void 0),ssai:y}}export function resolveSsbStream(e){if(!Array.isArray(e))return null;const t=e.find(e=>"object"==typeof e&&null!==e&&"gam"===e.type);if(!t||!Array.isArray(t.ssai))return null;for(const e of t.ssai){const t=n(e)?e.ssb:void 0;if(!n(t))continue;const o=s(t.uri);if(null===o)continue;const a=s(t.format),i=r(t.assetParameters);return{uri:o,...null!==a?{format:a}:{},...i?{assetParameters:i}:{},...n(t.drm)?{drm:t.drm}:{}}}return null}function n(e){return"object"==typeof e&&null!==e&&!Array.isArray(e)}function r(s){if("object"!=typeof s||null===s||Array.isArray(s))return;const n=t(e(s).filter(e=>"string"==typeof e[1]));return Object.keys(n).length>0?n:void 0}export function gamPodIdentityMismatches(e,t){const s=[];return t.networkCode!==e.networkCode&&s.push({field:"networkCode",assetValue:t.networkCode,sessionValue:e.networkCode}),t.customAssetKey!==e.customAssetKey&&s.push({field:"customAssetKey",assetValue:t.customAssetKey,sessionValue:e.customAssetKey}),s}export function manifestHasGamAssets(e){for(const t of e.breaks??[]){const e=[...t.variants??[],...t.variant?[t.variant]:[]];for(const t of e)for(const e of t?.assets??[])if("gam"===e?.vendor)return!0}return!1}