@openplayerjs/ads 3.4.0 → 3.4.2

package/dist/types/ad-dom.d.ts

@@ -16,7 +16,7 @@ export declare class AdDomManager {
     private resolvedNonLinearContainer?;
     private resolvedCompanionContainer?;
     private sessionUnsubs;
-    constructor(overlay: HTMLDivElement, cfg: Pick<AdsPluginConfig, 'nonLinearContainer' | 'nonLinearSelector' | 'companionContainer' | 'companionSelector' | 'mountEl' | 'mountSelector'>, getAdVideo: () => HTMLVideoElement | undefined, getTracker: () => any, onSkipCallback: SkipCallback);
+    constructor(overlay: HTMLDivElement, cfg: Pick<AdsPluginConfig, 'nonLinearContainer' | 'nonLinearSelector' | 'companionContainer' | 'companionSelector' | 'mountEl' | 'mountSelector' | 'labels'>, getAdVideo: () => HTMLVideoElement | undefined, getTracker: () => any, onSkipCallback: SkipCallback);
     addSessionUnsub(fn: () => void): void;
     clearSession(): void;
     resolveContainer(el?: HTMLElement, selector?: string): HTMLElement | undefined;

package/dist/types/ad-dom.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ad-dom.d.ts","sourceRoot":"","sources":["../../src/ad-dom.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAK/C,wBAAgB,aAAa,CAAC,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,QAkD1D;AAED,KAAK,YAAY,GAAG,MAAM,IAAI,CAAC;AAE/B,qBAAa,YAAY;IAerB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,GAAG;IASX,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,cAAc;IA1BxB,OAAO,CAAC,QAAQ,CAAC,CAAiB;IAClC,OAAO,CAAC,OAAO,CAAC,CAAoB;IACpC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,aAAa,CAAC,EAAE,cAAc,CAAC;IAC/B,aAAa,CAAC,EAAE,cAAc,CAAC;IAE/B,OAAO,CAAC,0BAA0B,CAAC,CAAc;IACjD,OAAO,CAAC,0BAA0B,CAAC,CAAc;IAEjD,OAAO,CAAC,aAAa,CAAsB;gBAGjC,OAAO,EAAE,cAAc,EACvB,GAAG,EAAE,IAAI,CACf,eAAe,EACb,oBAAoB,GACpB,mBAAmB,GACnB,oBAAoB,GACpB,mBAAmB,GACnB,SAAS,GACT,eAAe,CAClB,EACO,UAAU,EAAE,MAAM,gBAAgB,GAAG,SAAS,EAC9C,UAAU,EAAE,MAAM,GAAG,EACrB,cAAc,EAAE,YAAY;IAKtC,eAAe,CAAC,EAAE,EAAE,MAAM,IAAI;IAI9B,YAAY;IAQZ,gBAAgB,CAAC,EAAE,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAS9E,qBAAqB,IAAI,WAAW,GAAG,SAAS;IAMhD,qBAAqB,IAAI,WAAW,GAAG,SAAS;IAMhD,YAAY,CAAC,KAAK,EAAE,gBAAgB,GAAG,WAAW;IASlD,oBAAoB,CAAC,KAAK,EAAE,gBAAgB;IAiB5C,WAAW,CAAC,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM;IAoDzC,cAAc,CAAC,MAAM,EAAE,MAAM;IAY7B,OAAO,CAAC,aAAa;IAuBrB,UAAU;IAMV,qBAAqB,CAAC,IAAI,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,GAAG,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,KAAK,IAAI;IAmCjH,WAAW,CACT,MAAM,EAAE,QAAQ,GAAG,OAAO,GAAG,KAAK,EAClC,OAAO,EAAE,gBAAgB,GAAG,SAAS,EACrC,gBAAgB,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,EAC/D,QAAQ,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,EAC7B,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,KAAK,IAAI;IAgC5B,eAAe;IAaf,eAAe,CAAC,QAAQ,EAAE,GAAG;IA8B7B,eAAe,CAAC,SAAS,EAAE,GAAG,GAAG,WAAW,GAAG,IAAI;IAwEnD,iCAAiC,CAAC,EAAE,EAAE,GAAG,GAAG,MAAM;IAgBlD,kBAAkB;IAmBlB,eAAe,CAAC,EAAE,EAAE,GAAG,GAAG,WAAW,GAAG,IAAI;IA8D5C,cAAc,CAAC,QAAQ,EAAE,GAAG;IAoB5B,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB;CAyBjD"}
+{"version":3,"file":"ad-dom.d.ts","sourceRoot":"","sources":["../../src/ad-dom.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAK/C,wBAAgB,aAAa,CAAC,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,QAkD1D;AAED,KAAK,YAAY,GAAG,MAAM,IAAI,CAAC;AAE/B,qBAAa,YAAY;IAerB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,GAAG;IAUX,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,cAAc;IA3BxB,OAAO,CAAC,QAAQ,CAAC,CAAiB;IAClC,OAAO,CAAC,OAAO,CAAC,CAAoB;IACpC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,aAAa,CAAC,EAAE,cAAc,CAAC;IAC/B,aAAa,CAAC,EAAE,cAAc,CAAC;IAE/B,OAAO,CAAC,0BAA0B,CAAC,CAAc;IACjD,OAAO,CAAC,0BAA0B,CAAC,CAAc;IAEjD,OAAO,CAAC,aAAa,CAAsB;gBAGjC,OAAO,EAAE,cAAc,EACvB,GAAG,EAAE,IAAI,CACf,eAAe,EACb,oBAAoB,GACpB,mBAAmB,GACnB,oBAAoB,GACpB,mBAAmB,GACnB,SAAS,GACT,eAAe,GACf,QAAQ,CACX,EACO,UAAU,EAAE,MAAM,gBAAgB,GAAG,SAAS,EAC9C,UAAU,EAAE,MAAM,GAAG,EACrB,cAAc,EAAE,YAAY;IAKtC,eAAe,CAAC,EAAE,EAAE,MAAM,IAAI;IAI9B,YAAY;IAQZ,gBAAgB,CAAC,EAAE,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAS9E,qBAAqB,IAAI,WAAW,GAAG,SAAS;IAMhD,qBAAqB,IAAI,WAAW,GAAG,SAAS;IAMhD,YAAY,CAAC,KAAK,EAAE,gBAAgB,GAAG,WAAW;IASlD,oBAAoB,CAAC,KAAK,EAAE,gBAAgB;IAiB5C,WAAW,CAAC,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM;IAoDzC,cAAc,CAAC,MAAM,EAAE,MAAM;IAY7B,OAAO,CAAC,aAAa;IAuBrB,UAAU;IAMV,qBAAqB,CAAC,IAAI,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,GAAG,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,KAAK,IAAI;IAoCjH,WAAW,CACT,MAAM,EAAE,QAAQ,GAAG,OAAO,GAAG,KAAK,EAClC,OAAO,EAAE,gBAAgB,GAAG,SAAS,EACrC,gBAAgB,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,EAC/D,QAAQ,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,EAC7B,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,KAAK,IAAI;IAgC5B,eAAe;IAaf,eAAe,CAAC,QAAQ,EAAE,GAAG;IA8B7B,eAAe,CAAC,SAAS,EAAE,GAAG,GAAG,WAAW,GAAG,IAAI;IAwEnD,iCAAiC,CAAC,EAAE,EAAE,GAAG,GAAG,MAAM;IAgBlD,kBAAkB;IAmBlB,eAAe,CAAC,EAAE,EAAE,GAAG,GAAG,WAAW,GAAG,IAAI;IA8D5C,cAAc,CAAC,QAAQ,EAAE,GAAG;IAoB5B,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB;CAyBjD"}

package/dist/types/ads.d.ts

@@ -1,67 +1,89 @@
 import type { PlayerPlugin, PluginContext } from '@openplayerjs/core';
-import type { AdsBreakConfig, AdsEvent, AdsPluginConfig, AdsSource, AdsSourceType, VastInput } from './types';
+import type { AdsBreakConfig, AdsEvent, AdsPluginConfig, AdsSource, AdsSourceType } from './types';
 export type { AdsBreakConfig, AdsEvent, AdsPluginConfig, AdsSource, AdsSourceType };
+/**
+ * `AdsPlugin` — thin dispatcher for ad delivery strategies.
+ *
+ * Selects an `AdSessionStrategy` based on `config.adDelivery` and delegates
+ * all lifecycle calls to it. Strategy selection:
+ *
+ * | `adDelivery` value | Strategy | Description |
+ * |--------------------|----------|-------------|
+ * | `'csai'` (default) | `CsaiAdStrategy` | Client-side insertion — fetches VAST/VMAP, renders an ad `<video>` |
+ * | `'ssai'` | `SsaiAdStrategy` | Server-side stitching — detects boundaries via SCTE-35 TextTrack cues |
+ * | `'hybrid'` | `HybridAdStrategy` | CSAI triggered by SCTE-35 OUT cues from the HLS engine |
+ *
+ * Auto-selection: if `scteSource` or `hybrid.scteSource` is provided without
+ * an explicit `adDelivery`, the mode defaults to `'hybrid'`.
+ *
+ * @example CSAI with preroll
+ * ```ts
+ * new AdsPlugin({
+ *   breaks: [{ at: 'preroll', source: { type: 'VAST', src: 'https://example.com/vast.xml' } }],
+ * });
+ * ```
+ *
+ * @example SSAI with event sink
+ * ```ts
+ * new AdsPlugin({
+ *   adDelivery: 'ssai',
+ *   ssai: { eventSink: (e) => console.log(e.type, e.breakId) },
+ * });
+ * ```
+ *
+ * @example Hybrid CSAI + SCTE-35
+ * ```ts
+ * new AdsPlugin({
+ *   adDelivery: 'hybrid',
+ *   hybrid: {
+ *     scteSource: hlsEngine,
+ *     resolveScteUrl: (cue) => `https://ads.example.com/vast?id=${cue.id}`,
+ *   },
+ * });
+ * ```
+ */
 export declare class AdsPlugin implements PlayerPlugin {
     name: string;
     version: string;
     capabilities: string[];
-    private ctx;
-    private bus;
-    private _lastCreative;
-    private overlayId;
-    private adEndPromise;
-    private cfg;
-    private overlay;
-    private adVideo?;
-    private currentBreakMeta?;
-    private vastClient;
-    private tracker?;
-    private globalUnsubs;
-    private sessionUnsubs;
-    private active;
-    private resumeAfter;
-    private contentMedia?;
-    private contentHadControls;
-    private startingBreak;
-    private userPlayIntent;
-    private forcedMuteUntilInteraction;
-    private syncingVolume;
-    private scheduler;
-    private captionMgr;
-    private _dom?;
-    private get dom();
-    private set dom(value);
-    private simidSession?;
-    private omidSession?;
+    private readonly rawConfig;
+    private strategy?;
+    private scteUnsub?;
     constructor(config?: AdsPluginConfig);
     setup(ctx: PluginContext): void;
     playAds(vastUrl: string): Promise<boolean>;
     playAdsFromXml(vastXml: string): Promise<boolean>;
     getDueMidrollBreaks(currentTime: number): AdsBreakConfig[];
     getDueMidrollBreak(currentTime: number): AdsBreakConfig | undefined;
+    requestSkip(reason?: 'button' | 'close' | 'api'): void;
     destroy(): void;
-    /**
-     * @deprecated Use SimidSession directly for full protocol support.
-     * Best-effort SIMID iframe mounting from creative data.
-     */
-    tryMountSimidLayer(creative: any): void;
-    private bindPrerollInterceptors;
-    private shouldInterceptPreroll;
-    private bindBreakScheduler;
-    private startBreak;
-    private startBreakGroup;
-    private playBreakFromVast;
-    private playNonLinearOnlyBreak;
-    private playNonLinearOnlyBreakFromXml;
-    private dismissNonLinear;
-    private mountAdVideo;
-    private bindAdSurfaceCommands;
-    private bindTrackerAndTelemetry;
-    private startAdPlayback;
-    private waitForAdEnd;
-    private requestSkip;
-    private clearSession;
-    private finish;
+    private bindScteSource;
+    private get csai();
+    private _lazyDom?;
+    private get lazyDom();
+    /** @internal */ get bus(): import("./types").PluginBus<AdsEvent> | undefined;
+    /** @internal */ get tracker(): any;
+    /** @internal */ get active(): boolean | undefined;
+    /** @internal */ set active(v: boolean | undefined);
+    /** @internal */ get overlay(): HTMLDivElement | undefined;
+    /** @internal */ get ctx(): PluginContext | undefined;
+    /** @internal */ get sessionUnsubs(): (() => void)[] | undefined;
+    /** @internal */ set sessionUnsubs(v: (() => void)[] | undefined);
+    /** @internal */ get resumeAfter(): boolean | undefined;
+    /** @internal */ get globalUnsubs(): (() => void)[];
+    /** @internal */ get adVideo(): HTMLVideoElement | undefined;
+    /** @internal */ set adVideo(v: HTMLVideoElement | undefined);
+    /** @internal */ get forcedMuteUntilInteraction(): boolean;
+    /** @internal */ set forcedMuteUntilInteraction(v: boolean);
+    /** @internal */ clearSession(): void | undefined;
+    /** @internal */ startAdPlayback(): void | undefined;
+    /** @internal */ mountAdVideo(...args: any[]): any;
+    /** @internal */ get vastClient(): any;
+    /** @internal */ set vastClient(v: any);
+    /** @internal */ shouldInterceptPreroll(): boolean | undefined;
+    /** @internal */ startBreak(...args: any[]): Promise<void> | undefined;
+    /** @internal */ startBreakGroup(...args: any[]): Promise<void> | undefined;
+    /** @internal */ playBreakFromVast(...args: any[]): Promise<boolean>;
     /** @internal */ getVastXmlText(input: any): Promise<string>;
     /** @internal */ normalizeVmapAdSource(adSource: any): any;
     /** @internal */ extractVastTagUri(adTagURI: any): string | undefined;
@@ -70,7 +92,7 @@ export declare class AdsPlugin implements PlayerPlugin {
         pendingPercent?: number | null;
     };
     /** @internal */ getVastInputFromBreak(b: AdsBreakConfig): {
-        input?: VastInput;
+        input?: import("./types").VastInput;
         sourceType?: AdsSourceType;
     };
     /** @internal */ setSafeHTML(el: HTMLElement, html: string): void;
@@ -86,24 +108,22 @@ export declare class AdsPlugin implements PlayerPlugin {
     /** @internal */ collectPodAds(parsed: any): import("./types").PodAd[];
     /** @internal */ getPrerollBreak(): AdsBreakConfig | undefined;
     /** @internal */ getBreakId(b: AdsBreakConfig): string;
-    /** @internal */ loadVmapAndMerge(existing: AdsBreakConfig[], src?: string): Promise<void>;
-    /** @internal */ get resolvedBreaks(): AdsBreakConfig[];
-    /** @internal */ set resolvedBreaks(v: AdsBreakConfig[]);
-    /** @internal */ get pendingPercentBreaks(): any[];
-    /** @internal */ set pendingPercentBreaks(v: any[]);
-    /** @internal */ get playedBreaks(): Set<string>;
-    /** @internal */ get vmapPending(): boolean;
-    /** @internal */ get vmapLoadPromise(): Promise<void> | null;
+    /** @internal */ loadVmapAndMerge(existing: AdsBreakConfig[], src?: string): Promise<void | undefined>;
+    /** @internal */ get resolvedBreaks(): AdsBreakConfig[] | undefined;
+    /** @internal */ set resolvedBreaks(v: AdsBreakConfig[] | undefined);
+    /** @internal */ get pendingPercentBreaks(): any[] | undefined;
+    /** @internal */ set pendingPercentBreaks(v: any[] | undefined);
+    /** @internal */ get playedBreaks(): Set<string> | undefined;
+    /** @internal */ get vmapPending(): boolean | undefined;
+    /** @internal */ get vmapLoadPromise(): Promise<void> | null | undefined;
     /** @internal */ get pendingVmapSrc(): string | undefined;
-    /** @internal */ isXmlString(src: string): boolean;
-    /** @internal */ ensureOverlayMounted(): void;
+    /** @internal */ isXmlString(src: string): boolean | undefined;
+    /** @internal */ ensureOverlayMounted(): void | undefined;
     /** @internal */ mountCompanions(creative: any): void;
     /** @internal */ renderCompanion(companion: any): HTMLElement | null;
     /** @internal */ renderNonLinear(nl: any): HTMLElement | null;
-    /** @internal */ ensureRawCaptions(mediaFileRaw: any, creative?: any): import("./types").CaptionResource[];
-    /** @internal */ attachAdCaptionTracks(adVideo: HTMLVideoElement, raw: any, creative?: any): HTMLTrackElement[];
-    private log;
-    private warn;
+    /** @internal */ ensureRawCaptions(mediaFileRaw: any, creative?: any): import("./types").CaptionResource[] | undefined;
+    /** @internal */ attachAdCaptionTracks(adVideo: HTMLVideoElement, raw: any, creative?: any): HTMLTrackElement[] | undefined;
 }
 export { extendAds, installAds } from './install';
 //# sourceMappingURL=ads.d.ts.map

package/dist/types/ads.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ads.d.ts","sourceRoot":"","sources":["../../src/ads.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ads.d.ts","sourceRoot":"","sources":["../../src/ads.ts"],"names":[],"mappings":"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"}

package/dist/types/index.d.ts

@@ -1,19 +1,46 @@
 /**
  * @openplayerjs/ads
  *
- * VAST / VMAP / SIMID / OMID ad-serving plugin for OpenPlayerJS.
+ * VAST / VMAP / SSAI / Hybrid ad-serving plugin for OpenPlayerJS.
  * Peer dependencies: @openplayerjs/core, @dailymotion/vast-client, @dailymotion/vmap
  *
- * ESM usage:
+ * Delivery modes (set via `adDelivery` in `AdsPluginConfig`):
+ *   - 'csai' (default)  — client-side insertion; fetches VAST/VMAP, renders an ad <video>
+ *   - 'ssai'            — server-side stitching; detects ad boundaries via SCTE-35 TextTrack cues
+ *   - 'hybrid'          — CSAI triggered by SCTE-35 OUT cues from the HLS engine
+ *
+ * ESM usage (CSAI):
  *   import { AdsPlugin } from '@openplayerjs/ads';
- *   new Core(el, { plugins: [new AdsPlugin({ breaks: [...] })] });
+ *   new Core(el, {
+ *     plugins: [new AdsPlugin({
+ *       breaks: [{ at: 'preroll', source: { type: 'VAST', src: 'https://...' } }],
+ *     })],
+ *   });
+ *
+ * ESM usage (SSAI):
+ *   new Core(el, {
+ *     plugins: [new AdsPlugin({ adDelivery: 'ssai', ssai: { eventSink: (e) => log(e) } })],
+ *   });
+ *
+ * ESM usage (Hybrid):
+ *   new Core(el, {
+ *     plugins: [new AdsPlugin({
+ *       adDelivery: 'hybrid',
+ *       hybrid: { scteSource: hlsEngine, resolveScteUrl: (cue) => myVastUrl(cue) },
+ *     })],
+ *   });
  *
  * UMD / CDN usage: load openplayer-ads.js after the main OpenPlayer bundle.
  * It auto-registers itself under window.OpenPlayerPlugins.ads.
  */
 export { AdsPlugin } from './ads';
-export { installAds, extendAds } from './install';
-export { SimidSession, SIMID_PLAYER, SIMID_CREATIVE } from './simid';
+export { extendAds, installAds } from './install';
 export { OmidSession } from './omid';
-export type { AdsEvent, AdsPluginConfig, AdsSource, AdsBreakConfig, AdsSourceType, NormalizedMediaFile, AdVerification, } from './types';
+export { SIMID_CREATIVE, SIMID_PLAYER, SimidSession } from './simid';
+export { CsaiAdStrategy } from './strategies/csai';
+export { HybridAdStrategy } from './strategies/hybrid';
+export { decodeSplice } from './strategies/scte35';
+export type { SpliceCommand } from './strategies/scte35';
+export { SsaiAdStrategy } from './strategies/ssai';
+export type { AdDeliveryMode, AdLifecycleEvent, AdsBreakConfig, AdSessionStrategy, AdsEvent, AdsPluginConfig, AdsSource, AdsSourceType, AdTagRequest, AdVerification, CsaiAdConfig, HybridAdConfig, NormalizedMediaFile, ScteOutCue, ScteSource, SsaiAdConfig, } from './types';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AACrC,YAAY,EACV,QAAQ,EACR,eAAe,EACf,SAAS,EACT,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,cAAc,GACf,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,QAAQ,EACR,eAAe,EACf,SAAS,EACT,aAAa,EACb,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,cAAc,EACd,mBAAmB,EACnB,UAAU,EACV,UAAU,EACV,YAAY,GACb,MAAM,SAAS,CAAC"}

package/dist/types/schedule.d.ts

@@ -55,5 +55,5 @@ export declare class AdScheduler {
     private parseVmapFallback;
     reset(): void;
 }
-export { };
+export {};
 //# sourceMappingURL=schedule.d.ts.map

package/dist/types/simid.d.ts

@@ -119,13 +119,15 @@ export declare class SimidSession {
      */
     private outgoingFormat;
     private _targetOrigin;
+    /** Authoritative window to postMessage to — pinned from event.source on first valid message. */
+    private creativeWindow;
     constructor(iframe: HTMLIFrameElement, adVideo: HTMLVideoElement, callbacks: SimidCallbacks, creativeInfo?: SimidCreativeInfo | undefined);
     private nextMsgId;
     /**
      * Returns the target origin for postMessage calls to the creative iframe.
-     * Lazily derived from iframe.src so we don't need a constructor argument.
-     * Falls back to '*' only when the src is not an absolute URL (e.g. data: URIs
-     * used in tests), which is an acceptable edge case.
+     * Prefer the origin captured from the first incoming message (event.origin),
+     * which reflects where the iframe actually landed after any redirects.
+     * Falls back to deriving from iframe.src until the first message arrives.
      */
     private getTargetOrigin;
     /**

package/dist/types/simid.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"simid.d.ts","sourceRoot":"","sources":["../../src/simid.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"simid.d.ts","sourceRoot":"","sources":["../../src/simid.ts"],"names":[],"mappings":"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"}

package/dist/types/strategies/csai.d.ts

@@ -0,0 +1,160 @@
+import type { PluginContext } from '@openplayerjs/core';
+import { AdDomManager } from '../ad-dom';
+import { CaptionManager } from '../caption-manager';
+import { AdScheduler } from '../schedule';
+import type { AdDeliveryMode, AdSessionStrategy, AdsBreakConfig, AdsEvent, AdsPluginConfig, AdsSource, AdsSourceType, ScteSource, VastInput } from '../types';
+import { PluginBus } from '../types';
+export type NormalizedCsaiConfig = {
+    sources: AdsSource[];
+    breaks: AdsBreakConfig[];
+    interceptPlayForPreroll: boolean;
+    autoPlayOnReady: boolean;
+    allowNativeControls: boolean;
+    resumeContent: boolean;
+    preferredMediaTypes: string[];
+    debug: boolean;
+    breakTolerance: number;
+    adSourcesMode: 'waterfall' | 'playlist';
+    omid: {
+        accessMode?: 'domain' | 'limited';
+    };
+    labels: {
+        skip?: string;
+        advertisement?: string;
+        adEnded?: string;
+    };
+    adDelivery: AdDeliveryMode;
+    mountEl?: HTMLElement;
+    mountSelector?: string;
+    nonLinearContainer?: HTMLElement;
+    nonLinearSelector?: string;
+    companionContainer?: HTMLElement;
+    companionSelector?: string;
+    requestInterceptor?: AdsPluginConfig['requestInterceptor'];
+    eventSink?: AdsPluginConfig['eventSink'];
+    scteSource?: ScteSource;
+    resolveScteUrl?: AdsPluginConfig['resolveScteUrl'];
+};
+/**
+ * Client-side ad insertion strategy.
+ *
+ * Owns all CSAI-specific logic: scheduling, VAST fetching, ad video rendering,
+ * tracking, OMID/SIMID sessions, and break lifecycle management.
+ *
+ * `HybridAdStrategy` extends this class and adds SCTE-35 cue bridging on top.
+ */
+export declare class CsaiAdStrategy implements AdSessionStrategy {
+    readonly mode: AdDeliveryMode;
+    /** @internal */ ctx: PluginContext;
+    /** @internal */ bus: PluginBus<AdsEvent>;
+    /** @internal */ cfg: NormalizedCsaiConfig;
+    /** @internal */ scheduler: AdScheduler;
+    /** @internal */ captionMgr: CaptionManager;
+    /** @internal */ _dom?: AdDomManager;
+    private overlayId;
+    /** @internal */ overlay: HTMLDivElement;
+    /** @internal */ adVideo?: HTMLVideoElement;
+    private adEndPromise;
+    private adEngineDetach?;
+    private currentBreakMeta?;
+    /** @internal */ vastClient: any;
+    /** @internal */ tracker?: any;
+    private _lastCreative;
+    /** @internal */ globalUnsubs: (() => void)[];
+    /** @internal */ sessionUnsubs: (() => void)[];
+    /** @internal */ active: boolean;
+    /** @internal */ resumeAfter: boolean;
+    private contentMedia?;
+    private contentHadControls;
+    private startingBreak;
+    private userPlayIntent;
+    /** @internal */ forcedMuteUntilInteraction: boolean;
+    private syncingVolume;
+    /**
+     * @internal
+     * Dispatch proxies — AdsPlugin replaces these after init() so that
+     * `jest.spyOn(plugin, 'startBreak')` etc. can intercept scheduler calls.
+     */
+    _dispatchStartBreak: (b: AdsBreakConfig, kind: 'preroll' | 'midroll' | 'postroll' | 'auto', opts?: {
+        suppressResume?: boolean;
+    }) => Promise<void>;
+    _dispatchStartBreakGroup: (breaks: AdsBreakConfig[], kind: 'preroll' | 'midroll' | 'postroll' | 'auto') => Promise<void>;
+    _dispatchPlayBreakFromVast: (input: VastInput, meta: {
+        kind: 'preroll' | 'midroll' | 'postroll' | 'auto' | 'manual';
+        id: string;
+        sourceType?: AdsSourceType;
+    }, opts?: {
+        suppressResumeOnError?: boolean;
+        suppressResumeOnSuccess?: boolean;
+    }) => Promise<boolean>;
+    _dispatchGetVastXmlText: (input: VastInput) => Promise<string>;
+    _dispatchBuildParsedForNonLinear: (xmlText: string) => XMLDocument | null;
+    _dispatchMountAdVideo: (contentMedia: HTMLMediaElement, mediaFile: {
+        fileURL: string;
+        raw: any;
+    }, creative?: any) => void;
+    _dispatchStartAdPlayback: () => void;
+    private simidSession?;
+    private omidSession?;
+    init(ctx: PluginContext, config: AdsPluginConfig): void;
+    destroy(): void;
+    playAds(vastUrl: string): Promise<boolean>;
+    playAdsFromXml(vastXml: string): Promise<boolean>;
+    getDueMidrollBreaks(currentTime: number): AdsBreakConfig[];
+    getDueMidrollBreak(currentTime: number): AdsBreakConfig | undefined;
+    requestSkip(reason?: 'button' | 'close' | 'api'): void;
+    /** @internal */
+    get dom(): AdDomManager;
+    /** @internal */
+    set dom(v: AdDomManager);
+    private bindPrerollInterceptors;
+    /** @internal */ shouldInterceptPreroll(): boolean;
+    private bindBreakScheduler;
+    /** @internal */ startBreak(b: AdsBreakConfig, kind: 'preroll' | 'midroll' | 'postroll' | 'auto', opts?: {
+        suppressResume?: boolean;
+    }): Promise<void>;
+    /** @internal */ startBreakGroup(breaks: AdsBreakConfig[], kind: 'preroll' | 'midroll' | 'postroll' | 'auto'): Promise<void>;
+    /** @internal */ playBreakFromVast(input: VastInput, meta: {
+        kind: 'preroll' | 'midroll' | 'postroll' | 'auto' | 'manual';
+        id: string;
+        sourceType?: AdsSourceType;
+    }, opts?: {
+        suppressResumeOnError?: boolean;
+        suppressResumeOnSuccess?: boolean;
+    }): Promise<boolean>;
+    private playNonLinearOnlyBreak;
+    private playNonLinearOnlyBreakFromXml;
+    private dismissNonLinear;
+    private mountAdVideo;
+    private bindAdSurfaceCommands;
+    private bindTrackerAndTelemetry;
+    /** @internal */ startAdPlayback(): void;
+    private waitForAdEnd;
+    /** @internal */ clearSession(): void;
+    private finish;
+    protected log(...args: any[]): void;
+    protected warn(...args: any[]): void;
+    /** @internal */ getVastXmlText(input: any): Promise<string>;
+    /** @internal */ buildParsedForNonLinearFromXml(xmlText: string): XMLDocument;
+    /** @internal */ computeSkipAtSecondsDelegate(skipOffset: string | undefined, duration: number): number | undefined;
+    /** @internal */ collectPodAdsDelegate(parsed: any): import("../types").PodAd[];
+    /** @internal */ getPrerollBreak(): AdsBreakConfig | undefined;
+    /** @internal */ getBreakId(b: AdsBreakConfig): string;
+    /** @internal */ loadVmapAndMerge(existing: AdsBreakConfig[], src?: string): Promise<void>;
+    /** @internal */ get resolvedBreaks(): AdsBreakConfig[];
+    /** @internal */ set resolvedBreaks(v: AdsBreakConfig[]);
+    /** @internal */ get pendingPercentBreaks(): any[];
+    /** @internal */ set pendingPercentBreaks(v: any[]);
+    /** @internal */ get playedBreaks(): Set<string>;
+    /** @internal */ get vmapPending(): boolean;
+    /** @internal */ get vmapLoadPromise(): Promise<void> | null;
+    /** @internal */ get pendingVmapSrc(): string | undefined;
+    /** @internal */ isXmlString(src: string): boolean;
+    /** @internal */ ensureOverlayMounted(): void;
+    /** @internal */ mountCompanions(creative: any): void;
+    /** @internal */ renderCompanion(companion: any): HTMLElement | null;
+    /** @internal */ renderNonLinear(nl: any): HTMLElement | null;
+    /** @internal */ ensureRawCaptions(mediaFileRaw: any, creative?: any): import("../types").CaptionResource[];
+    /** @internal */ attachAdCaptionTracks(adVideo: HTMLVideoElement, raw: any, creative?: any): HTMLTrackElement[];
+}
+//# sourceMappingURL=csai.d.ts.map

package/dist/types/strategies/csai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"csai.d.ts","sourceRoot":"","sources":["../../../src/strategies/csai.ts"],"names":[],"mappings":"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"}

package/dist/types/strategies/hybrid.d.ts

@@ -0,0 +1,24 @@
+import type { AdDeliveryMode } from '../types';
+import { CsaiAdStrategy } from './csai';
+/**
+ * CSAI + SCTE-35 hybrid ad delivery strategy.
+ *
+ * Behaves identically to `CsaiAdStrategy` for ad rendering. The SCTE-35 cue
+ * bridging (mapping `engine.onCue` → `playAds()`) is handled by `AdsPlugin`
+ * so that spy/intercept tests can observe calls at the public API boundary.
+ *
+ * Configuration (prefer the sub-config form; flat aliases kept for backward compat):
+ * ```ts
+ * new AdsPlugin({
+ *   adDelivery: 'hybrid',
+ *   hybrid: {
+ *     scteSource: hlsEngine,          // any object with onCue?: (cue) => void
+ *     resolveScteUrl: (cue) => adServerUrl(cue.id),
+ *   },
+ * });
+ * ```
+ */
+export declare class HybridAdStrategy extends CsaiAdStrategy {
+    readonly mode: AdDeliveryMode;
+}
+//# sourceMappingURL=hybrid.d.ts.map

package/dist/types/strategies/hybrid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hybrid.d.ts","sourceRoot":"","sources":["../../../src/strategies/hybrid.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAExC;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,gBAAiB,SAAQ,cAAc;IAClD,SAAkB,IAAI,EAAE,cAAc,CAAY;CACnD"}

package/dist/types/strategies/scte35.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Minimal SCTE-35 splice_info_section decoder.
+ *
+ * Accepts the three forms a splice_info_section can arrive in:
+ *   - ArrayBuffer  (DataCue.data from enableID3MetadataCues)
+ *   - Uint8Array   (same, already sliced)
+ *   - base64 string (EXT-X-DATERANGE X-SCTE35 attribute value)
+ *
+ * Only splice_insert (0x05) and time_signal (0x06) are decoded.
+ * All other command types are returned as { type: 'unknown' }.
+ */
+export type SpliceCommand = {
+    type: 'splice_insert';
+    outOfNetwork: boolean;
+    durationSecs: number | null;
+    autoReturn: boolean;
+} | {
+    type: 'time_signal';
+} | {
+    type: 'unknown';
+    commandType: number;
+};
+/**
+ * Decode a SCTE-35 splice_info_section.
+ * Returns `null` if the buffer cannot be parsed as a valid section.
+ */
+export declare function decodeSplice(source: ArrayBufferLike | Uint8Array | string): SpliceCommand | null;
+//# sourceMappingURL=scte35.d.ts.map

package/dist/types/strategies/scte35.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scte35.d.ts","sourceRoot":"","sources":["../../../src/strategies/scte35.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,YAAY,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,GAClG;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,GACvB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7C;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,eAAe,GAAG,UAAU,GAAG,MAAM,GAAG,aAAa,GAAG,IAAI,CAsDhG"}

package/dist/types/strategies/ssai.d.ts

@@ -0,0 +1,37 @@
+import type { PluginContext } from '@openplayerjs/core';
+import type { AdSessionStrategy, AdsPluginConfig } from '../types';
+/**
+ * Server-side ad insertion strategy.
+ *
+ * Responsibilities:
+ *  - Discover hls.js metadata TextTrack objects created by
+ *    `enableDateRangeMetadataCues` / `enableID3MetadataCues`.
+ *  - Subscribe to DOM `cuechange` events; parse SCTE-35 splice commands
+ *    from active cues (DataCue ArrayBuffer path for ID3, or custom attributes
+ *    for EXT-X-DATERANGE).
+ *  - Track active ad breaks and emit IAB quartile events via `timeupdate`.
+ *  - Report all lifecycle events through the configured `AdEventSink`.
+ *
+ * What this strategy does NOT do:
+ *  - Fetch VAST/VMAP (no outbound ad-tagged network requests — ad-blocker-proof).
+ *  - Render an ad <video> element (the content stream IS the ad stream).
+ *  - Acquire a playback lease (the stream is continuous).
+ */
+export declare class SsaiAdStrategy implements AdSessionStrategy {
+    readonly mode: "ssai";
+    private ctx;
+    private sink;
+    private boundTracks;
+    private activeBreaks;
+    private cleanups;
+    init(ctx: PluginContext, config: AdsPluginConfig): void;
+    destroy(): void;
+    private scanTracks;
+    private bindTrack;
+    private handleActiveCues;
+    private processCue;
+    private startBreak;
+    private endBreak;
+    private checkQuartiles;
+}
+//# sourceMappingURL=ssai.d.ts.map

package/dist/types/strategies/ssai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssai.d.ts","sourceRoot":"","sources":["../../../src/strategies/ssai.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,KAAK,EAAoB,iBAAiB,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAUrF;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,cAAe,YAAW,iBAAiB;IACtD,QAAQ,CAAC,IAAI,EAAG,MAAM,CAAU;IAEhC,OAAO,CAAC,GAAG,CAAiB;IAC5B,OAAO,CAAC,IAAI,CAAkD;IAE9D,OAAO,CAAC,WAAW,CAAwB;IAC3C,OAAO,CAAC,YAAY,CAAgC;IACpD,OAAO,CAAC,QAAQ,CAAsB;IAEtC,IAAI,CAAC,GAAG,EAAE,aAAa,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI;IA4BvD,OAAO,IAAI,IAAI;IASf,OAAO,CAAC,UAAU;IAMlB,OAAO,CAAC,SAAS;IAWjB,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,UAAU;IAiElB,OAAO,CAAC,UAAU;IAUlB,OAAO,CAAC,QAAQ;IAShB,OAAO,CAAC,cAAc;CAkBvB"}