playron 1.0.0

package/dist/plugins/AdPlugin.d.ts

@@ -0,0 +1,8 @@
+import { VirtusPlugin } from '../core/PluginSystem';
+import { AdConfig } from './ads/types';
+/**
+ * Create Ad Plugin
+ */
+export declare function createAdPlugin(config: AdConfig): VirtusPlugin;
+export type { AdConfig } from './ads/types';
+//# sourceMappingURL=AdPlugin.d.ts.map

package/dist/plugins/AdPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AdPlugin.d.ts","sourceRoot":"","sources":["../../src/plugins/AdPlugin.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,QAAQ,GAAG,YAAY,CA0C7D;AAGD,YAAY,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC"}

package/dist/plugins/AnalyticsPlugin.d.ts

@@ -0,0 +1,50 @@
+import { PlayerCore } from '../core/PlayerCore';
+import { AnalyticsConfig, AnalyticsSessionMetrics } from '../types/analytics';
+export declare class AnalyticsPlugin {
+    private player;
+    private config;
+    private sessionId;
+    private sessionActive;
+    private queue;
+    private heartbeatTimer;
+    private isPlaying;
+    private isBuffering;
+    private currentQuality;
+    private currentSrc;
+    private metrics;
+    private playStartedAt;
+    private bufferStartedAt;
+    private qualityStartedAt;
+    private loadStartedAt;
+    private handlers;
+    constructor(player: PlayerCore, config?: AnalyticsConfig);
+    /** Start tracking. Call after setSource. */
+    start(src?: string): void;
+    /** Stop tracking and flush remaining events. */
+    end(): void;
+    private attachListeners;
+    private detachListeners;
+    private onPlay;
+    private onPause;
+    private onSeekStart;
+    private onSeekEnd;
+    private onBufferStart;
+    private onBufferEnd;
+    private onQualityChange;
+    private finalizePlayInterval;
+    private finalizeBufferInterval;
+    private finalizeQualityInterval;
+    private startHeartbeat;
+    private stopHeartbeat;
+    private track;
+    private flush;
+    private buildMeta;
+    private buildMetricsSummary;
+    private emptyMetrics;
+    private log;
+    /** Get a snapshot of current session metrics */
+    getMetrics(): AnalyticsSessionMetrics;
+    /** Get the current session ID */
+    getSessionId(): string;
+}
+//# sourceMappingURL=AnalyticsPlugin.d.ts.map

package/dist/plugins/AnalyticsPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnalyticsPlugin.d.ts","sourceRoot":"","sources":["../../src/plugins/AnalyticsPlugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EACV,eAAe,EAIf,uBAAuB,EACxB,MAAM,oBAAoB,CAAC;AAgB5B,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,MAAM,CAA4B;IAG1C,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,aAAa,CAAS;IAI9B,OAAO,CAAC,KAAK,CAAwB;IAGrC,OAAO,CAAC,cAAc,CAA+C;IAGrE,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,cAAc,CAAM;IAC5B,OAAO,CAAC,UAAU,CAAM;IAGxB,OAAO,CAAC,OAAO,CAAgD;IAG/D,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,aAAa,CAAK;IAG1B,OAAO,CAAC,QAAQ,CAAkE;gBAEtE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAE,eAAoB;IAe5D,4CAA4C;IAC5C,KAAK,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IAiBzB,gDAAgD;IAChD,GAAG,IAAI,IAAI;IAoBX,OAAO,CAAC,eAAe;IA0DvB,OAAO,CAAC,eAAe;IAiBvB,OAAO,CAAC,MAAM;IAoBd,OAAO,CAAC,OAAO;IAQf,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,WAAW;IAWnB,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,oBAAoB;IAO5B,OAAO,CAAC,sBAAsB;IAO9B,OAAO,CAAC,uBAAuB;IAW/B,OAAO,CAAC,cAAc;IAYtB,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,KAAK;IAsBb,OAAO,CAAC,KAAK;IAkCb,OAAO,CAAC,SAAS;IAajB,OAAO,CAAC,mBAAmB;IAc3B,OAAO,CAAC,YAAY;IAcpB,OAAO,CAAC,GAAG;IAYX,gDAAgD;IAChD,UAAU,IAAI,uBAAuB;IAIrC,iCAAiC;IACjC,YAAY,IAAI,MAAM;CAGvB"}

package/dist/plugins/PluginManager.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=PluginManager.d.ts.map

package/dist/plugins/PluginManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginManager.d.ts","sourceRoot":"","sources":["../../src/plugins/PluginManager.ts"],"names":[],"mappings":""}

package/dist/plugins/SocialPlugin.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=SocialPlugin.d.ts.map

package/dist/plugins/SocialPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SocialPlugin.d.ts","sourceRoot":"","sources":["../../src/plugins/SocialPlugin.ts"],"names":[],"mappings":""}

package/dist/plugins/ads/AdManager.d.ts

@@ -0,0 +1,79 @@
+import { AdConfig } from './types';
+type Playron = any;
+export declare class AdManager {
+    private player;
+    private config;
+    private vastParser;
+    private vmapParser;
+    private adPlayer;
+    private preRollPlayed;
+    private midRollsPlayed;
+    private postRollPlayed;
+    private vmapData;
+    private videoDuration;
+    private loadingContainer;
+    private onLoadingChange?;
+    constructor(player: Playron, config: AdConfig, onLoadingChange?: (isLoading: boolean) => void);
+    /**
+     * Wait for video element to be ready (with retry logic)
+     */
+    private waitForVideoElement;
+    /**
+     * Setup ad scheduling (listen to player events)
+     */
+    setup(): Promise<void>;
+    /**
+     * Handle pre-roll ad
+     */
+    private handlePreRoll;
+    /**
+     * Handle mid-roll ads
+     */
+    private handleMidRoll;
+    /**
+     * Handle post-roll ad
+     */
+    private handlePostRoll;
+    /**
+     * Get pre-roll VAST URL (from VMAP or config)
+     */
+    private getPreRollVastUrl;
+    /**
+     * Add unique correlator to VAST URL (prevents caching issues)
+     */
+    private addCorrelator;
+    /**
+     * Get post-roll VAST URL (from VMAP)
+     */
+    private getPostRollVastUrl;
+    /**
+     * Play ad from VAST URL (with Bitmovin-style retry)
+     */
+    private playAd;
+    /**
+     * Skip current ad
+     */
+    skipAd(): void;
+    /**
+     * Handle ad click
+     */
+    handleAdClick(): void;
+    /**
+     * Get current ad state
+     */
+    getAdState(): import('./types').AdPlaybackState;
+    /**
+     * Show ad loading spinner (or trigger external loading via callback)
+     */
+    private showAdLoading;
+    /**
+     * Hide ad loading spinner (or trigger external loading via callback)
+     */
+    private hideAdLoading;
+    /**
+     * Destroy ad manager
+     */
+    destroy(): void;
+}
+export {};
+//# sourceMappingURL=AdManager.d.ts.map

package/dist/plugins/ads/AdManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AdManager.d.ts","sourceRoot":"","sources":["../../../src/plugins/ads/AdManager.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAwB,MAAM,SAAS,CAAC;AAK9D,KAAK,OAAO,GAAG,GAAG,CAAC;AAEnB,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAU;IACxB,OAAO,CAAC,MAAM,CAAW;IACzB,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,QAAQ,CAAW;IAE3B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,cAAc,CAAqB;IAC3C,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,aAAa,CAAa;IAClC,OAAO,CAAC,gBAAgB,CAA+B;IACvD,OAAO,CAAC,eAAe,CAAC,CAA+B;gBAE3C,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI;IAe7F;;OAEG;YACW,mBAAmB;IAejC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAmJ5B;;OAEG;YACW,aAAa;IAiC3B;;OAEG;YACW,aAAa;IAuB3B;;OAEG;YACW,cAAc;IAa5B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAezB;;OAEG;IACH,OAAO,CAAC,aAAa;IAoBrB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAU1B;;OAEG;YACW,MAAM;IAkEpB;;OAEG;IACH,MAAM,IAAI,IAAI;IAId;;OAEG;IACH,aAAa,IAAI,IAAI;IAIrB;;OAEG;IACH,UAAU;IAIV;;OAEG;IACH,OAAO,CAAC,aAAa;IAgErB;;OAEG;IACH,OAAO,CAAC,aAAa;IAgBrB;;OAEG;IACH,OAAO,IAAI,IAAI;CAShB"}

package/dist/plugins/ads/AdPlayer.d.ts

@@ -0,0 +1,33 @@
+import { Ad, AdConfig, AdPlaybackState, AdPosition } from './types';
+type Playron = any;
+export declare class AdPlayer {
+    private player;
+    private config;
+    private tracker;
+    private hideLoadingCallback?;
+    private adVideo;
+    private adContainer;
+    private companionContainer;
+    private mainVideoElement;
+    private skipButton;
+    private countdownElement;
+    private vpaidIframe;
+    private vpaidCreative;
+    private state;
+    constructor(player: Playron, config: AdConfig, hideLoadingCallback?: () => void);
+    play(ad: Ad, position: AdPosition): Promise<void>;
+    playAdPod(ads: Ad[], position: AdPosition): Promise<void>;
+    private showCompanionBanners;
+    private buildCompanionElement;
+    private playVpaidCreative;
+    private createAdUI;
+    private playAdVideo;
+    private updateUI;
+    skip(): void;
+    handleClick(): void;
+    private destroyAdUI;
+    getState(): AdPlaybackState;
+    destroy(): void;
+}
+export {};
+//# sourceMappingURL=AdPlayer.d.ts.map

package/dist/plugins/ads/AdPlayer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AdPlayer.d.ts","sourceRoot":"","sources":["../../../src/plugins/ads/AdPlayer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,EAAE,EAAE,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAe,MAAM,SAAS,CAAC;AAGtF,KAAK,OAAO,GAAG,GAAG,CAAC;AAanB,qBAAa,QAAQ;IACnB,OAAO,CAAC,MAAM,CAAU;IACxB,OAAO,CAAC,MAAM,CAAW;IACzB,OAAO,CAAC,OAAO,CAAY;IAC3B,OAAO,CAAC,mBAAmB,CAAC,CAAa;IAEzC,OAAO,CAAC,OAAO,CAAiC;IAChD,OAAO,CAAC,WAAW,CAA+B;IAClD,OAAO,CAAC,kBAAkB,CAA+B;IACzD,OAAO,CAAC,gBAAgB,CAAiC;IACzD,OAAO,CAAC,UAAU,CAAkC;IACpD,OAAO,CAAC,gBAAgB,CAA+B;IAGvD,OAAO,CAAC,WAAW,CAAkC;IACrD,OAAO,CAAC,aAAa,CAA8B;IAEnD,OAAO,CAAC,KAAK,CAOX;gBAEU,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,mBAAmB,CAAC,EAAE,MAAM,IAAI;IASzE,IAAI,CAAC,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAiEjD,SAAS,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAc/D,OAAO,CAAC,oBAAoB;IAmC5B,OAAO,CAAC,qBAAqB;YA0Cf,iBAAiB;IAkE/B,OAAO,CAAC,UAAU;YAiHJ,WAAW;IA4EzB,OAAO,CAAC,QAAQ;IAkBhB,IAAI,IAAI,IAAI;IAkBZ,WAAW,IAAI,IAAI;IAQnB,OAAO,CAAC,WAAW;IAuCnB,QAAQ,IAAI,eAAe;IAI3B,OAAO,IAAI,IAAI;CAWhB"}

package/dist/plugins/ads/AdTracker.d.ts

@@ -0,0 +1,34 @@
+import { Ad } from './types';
+export declare class AdTracker {
+    private trackingEnabled;
+    constructor(trackingEnabled?: boolean);
+    /**
+     * Track impression
+     */
+    trackImpression(ad: Ad): void;
+    /**
+     * Track start
+     */
+    trackStart(ad: Ad): void;
+    /**
+     * Track complete
+     */
+    trackComplete(ad: Ad): void;
+    /**
+     * Track skip
+     */
+    trackSkip(ad: Ad): void;
+    /**
+     * Track error
+     */
+    trackError(ad: Ad, errorCode: string): void;
+    /**
+     * Fire tracking pixel (image request)
+     */
+    private fireTrackingPixel;
+    /**
+     * Reset tracker (for new ad)
+     */
+    reset(): void;
+}
+//# sourceMappingURL=AdTracker.d.ts.map

package/dist/plugins/ads/AdTracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AdTracker.d.ts","sourceRoot":"","sources":["../../../src/plugins/ads/AdTracker.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAElC,qBAAa,SAAS;IACpB,OAAO,CAAC,eAAe,CAAU;gBAErB,eAAe,GAAE,OAAc;IAI3C;;OAEG;IACH,eAAe,CAAC,EAAE,EAAE,EAAE,GAAG,IAAI;IAQ7B;;OAEG;IACH,UAAU,CAAC,EAAE,EAAE,EAAE,GAAG,IAAI;IAQxB;;OAEG;IACH,aAAa,CAAC,EAAE,EAAE,EAAE,GAAG,IAAI;IAQ3B;;OAEG;IACH,SAAS,CAAC,EAAE,EAAE,EAAE,GAAG,IAAI;IAQvB;;OAEG;IACH,UAAU,CAAC,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAS3C;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAWzB;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd"}

package/dist/plugins/ads/VASTParser.d.ts

@@ -0,0 +1,52 @@
+import { Ad } from './types';
+export declare class VASTParser {
+    private timeout;
+    private maxWrapperDepth;
+    constructor(timeout?: number, maxWrapperDepth?: number);
+    /**
+     * Parse VAST URL to Ad object (with retry for empty responses)
+     */
+    parse(vastUrl: string, depth?: number, retryCount?: number): Promise<Ad>;
+    /**
+     * Fetch VAST XML with timeout
+     */
+    private fetchVAST;
+    /**
+     * Parse XML string to Document
+     */
+    private parseXML;
+    /**
+     * Parse all Ads from a VAST URL — returns an ordered ad pod array.
+     * Ads are sorted by their `sequence` attribute (ascending).
+     * Wrapper chains are followed for each Ad independently.
+     */
+    parseAdPod(vastUrl: string): Promise<Ad[]>;
+    /**
+     * Parse inline VAST ad (first Ad element in document)
+     */
+    private parseInline;
+    /**
+     * Parse a single <Ad> element into an Ad object.
+     * Returns null if the Ad has no InLine / no MediaFile.
+     */
+    private parseAdElement;
+    private parseCompanions;
+    /**
+     * Parse duration string (HH:MM:SS) to seconds
+     */
+    private parseDuration;
+    /**
+     * Detect VPAID or get best regular media file (prefer MP4).
+     * Returns { mediaFile, isVpaid, vpaidUrl }.
+     */
+    private getMediaFileInfo;
+    /**
+     * Parse tracking events (impression + all quartile events)
+     */
+    private parseTrackingEvents;
+    /**
+     * Get error URLs
+     */
+    private getErrorUrls;
+}
+//# sourceMappingURL=VASTParser.d.ts.map

package/dist/plugins/ads/VASTParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VASTParser.d.ts","sourceRoot":"","sources":["../../../src/plugins/ads/VASTParser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,EAAE,EAAe,MAAM,SAAS,CAAC;AAE/C,qBAAa,UAAU;IACrB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,eAAe,CAAS;gBAEpB,OAAO,GAAE,MAAa,EAAE,eAAe,GAAE,MAAU;IAK/D;;OAEG;IACG,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,EAAE,UAAU,GAAE,MAAU,GAAG,OAAO,CAAC,EAAE,CAAC;IAkDpF;;OAEG;YACW,SAAS;IAoCvB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAkChB;;;;OAIG;IACG,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,EAAE,EAAE,CAAC;IAsChD;;OAEG;IACH,OAAO,CAAC,WAAW;IASnB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAgDtB,OAAO,CAAC,eAAe;IA8CvB;;OAEG;IACH,OAAO,CAAC,aAAa;IAWrB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAiCxB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA0B3B;;OAEG;IACH,OAAO,CAAC,YAAY;CAQrB"}

package/dist/plugins/ads/VMAPParser.d.ts

@@ -0,0 +1,31 @@
+import { VMAPData } from './types';
+export declare class VMAPParser {
+    private timeout;
+    constructor(timeout?: number);
+    /**
+     * Parse VMAP URL to VMAPData
+     */
+    parse(vmapUrl: string): Promise<VMAPData>;
+    /**
+     * Fetch VMAP XML with timeout
+     */
+    private fetchVMAP;
+    /**
+     * Parse XML string to Document
+     */
+    private parseXML;
+    /**
+     * Parse ad breaks from VMAP document
+     */
+    private parseAdBreaks;
+    /**
+     * Parse single AdBreak element
+     */
+    private parseAdBreak;
+    /**
+     * Parse timeOffset string to seconds
+     * Supports: "start" (0), "end" (-1), "HH:MM:SS" or "MM:SS" or "SS"
+     */
+    private parseTimeOffset;
+}
+//# sourceMappingURL=VMAPParser.d.ts.map

package/dist/plugins/ads/VMAPParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VMAPParser.d.ts","sourceRoot":"","sources":["../../../src/plugins/ads/VMAPParser.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAe,MAAM,SAAS,CAAC;AAErD,qBAAa,UAAU;IACrB,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,GAAE,MAAa;IAIlC;;OAEG;IACG,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IA0D/C;;OAEG;YACW,SAAS;IAoDvB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAgBhB;;OAEG;IACH,OAAO,CAAC,aAAa;IAmCrB;;OAEG;IACH,OAAO,CAAC,YAAY;IAiFpB;;;OAGG;IACH,OAAO,CAAC,eAAe;CA8BxB"}

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

@@ -0,0 +1,108 @@
+/**
+ * Simple Ad System Types
+ */
+/**
+ * Ad UI Configuration (optional customization)
+ */
+export interface AdUIConfig {
+    showLabel?: boolean;
+    showCountdown?: boolean;
+    showSkipButton?: boolean;
+    labelText?: string;
+    labelPosition?: 'top-left' | 'top-right';
+    countdownPosition?: 'top-left' | 'top-right';
+}
+/**
+ * Ads configuration (from user config)
+ */
+export interface AdConfig {
+    enabled: boolean;
+    vastUrl?: string;
+    vmapUrl?: string;
+    skipAfter?: number;
+    timeout?: number;
+    maxWrapperDepth?: number;
+    ui?: AdUIConfig;
+}
+/**
+ * Companion banner (displayed alongside the ad)
+ */
+export interface CompanionAd {
+    id?: string;
+    width: number;
+    height: number;
+    /** Static image / SWF URL */
+    staticResource?: string;
+    /** Raw HTML snippet */
+    htmlResource?: string;
+    /** IFrame URL */
+    iFrameResource?: string;
+    /** MIME type of the staticResource */
+    type?: string;
+    /** Click-through URL */
+    clickThrough?: string;
+    /** Alt text for image companions */
+    altText?: string;
+    /** Tracking URLs to fire on companion view */
+    viewTrackingUrls?: string[];
+}
+/**
+ * Parsed VAST ad data
+ */
+export interface Ad {
+    id: string;
+    title?: string;
+    duration: number;
+    mediaFile: string;
+    clickThrough?: string;
+    trackingEvents: {
+        impression?: string[];
+        start?: string[];
+        complete?: string[];
+        skip?: string[];
+        firstQuartile?: string[];
+        midpoint?: string[];
+        thirdQuartile?: string[];
+        pause?: string[];
+        resume?: string[];
+    };
+    errorUrls?: string[];
+    /** Companion banners to display alongside the linear ad */
+    companions?: CompanionAd[];
+    /** Whether this is a VPAID creative */
+    isVpaid?: boolean;
+    /** VPAID JavaScript URL (apiFramework=VPAID) */
+    vpaidUrl?: string;
+    /** Position within an ad pod (from sequence attribute) */
+    podSequence?: number;
+}
+/**
+ * Ad position
+ */
+export type AdPosition = 'preroll' | 'midroll' | 'postroll';
+/**
+ * Ad playback state
+ */
+export interface AdPlaybackState {
+    isPlaying: boolean;
+    ad: Ad | null;
+    position: AdPosition | null;
+    currentTime: number;
+    canSkip: boolean;
+    remainingTime: number;
+}
+/**
+ * VMAP Ad Break
+ */
+export interface VMAPAdBreak {
+    timeOffset: number;
+    vastUrl: string;
+}
+/**
+ * Parsed VMAP data
+ */
+export interface VMAPData {
+    version: string;
+    adBreaks: VMAPAdBreak[];
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/test-ad.xml

@@ -0,0 +1,37 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<VAST version="3.0">
+  <Ad id="test-ad-001">
+    <InLine>
+      <AdSystem>Virtus Player Test</AdSystem>
+      <AdTitle>Test Advertisement</AdTitle>
+      <Description>This is a test ad for Virtus Player</Description>
+      <Impression><![CDATA[https://example.com/impression]]></Impression>
+      <Creatives>
+        <Creative id="creative-001" sequence="1">
+          <Linear>
+            <Duration>00:00:10</Duration>
+            <TrackingEvents>
+              <Tracking event="start"><![CDATA[https://example.com/start]]></Tracking>
+              <Tracking event="firstQuartile"><![CDATA[https://example.com/firstQuartile]]></Tracking>
+              <Tracking event="midpoint"><![CDATA[https://example.com/midpoint]]></Tracking>
+              <Tracking event="thirdQuartile"><![CDATA[https://example.com/thirdQuartile]]></Tracking>
+              <Tracking event="complete"><![CDATA[https://example.com/complete]]></Tracking>
+            </TrackingEvents>
+            <VideoClicks>
+              <ClickThrough><![CDATA[https://www.example.com]]></ClickThrough>
+            </VideoClicks>
+            <MediaFiles>
+              <MediaFile delivery="progressive" type="video/mp4" width="1280" height="720">
+                <![CDATA[https://commondatastorage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4]]>
+              </MediaFile>
+            </MediaFiles>
+          </Linear>
+        </Creative>
+      </Creatives>
+    </InLine>
+  </Ad>
+</VAST>
+
+
+
+

package/dist/test-vmap.xml

@@ -0,0 +1,30 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<vmap:VMAP xmlns:vmap="http://www.iab.net/videosuite/vmap" version="1.0">
+  <!-- Pre-roll Ad -->
+  <vmap:AdBreak timeOffset="start" breakType="linear" breakId="preroll">
+    <vmap:AdSource id="preroll-ad" allowMultipleAds="false" followRedirects="true">
+      <vmap:AdTagURI templateType="vast3">
+        <![CDATA[https://pubads.g.doubleclick.net/gampad/ads?iu=/21775744923/external/single_ad_samples&sz=640x480&cust_params=sample_ct%3Dlinear&ciu_szs=300x250%2C728x90&gdfp_req=1&output=vast&unviewed_position_start=1&env=vp&impl=s&correlator=]]>
+      </vmap:AdTagURI>
+    </vmap:AdSource>
+  </vmap:AdBreak>
+  
+  <!-- Mid-roll Ad at 15 seconds -->
+  <vmap:AdBreak timeOffset="00:00:15" breakType="linear" breakId="midroll-1">
+    <vmap:AdSource id="midroll-ad" allowMultipleAds="false" followRedirects="true">
+      <vmap:AdTagURI templateType="vast3">
+        <![CDATA[https://pubads.g.doubleclick.net/gampad/ads?iu=/21775744923/external/single_ad_samples&sz=640x480&cust_params=sample_ct%3Dlinear&ciu_szs=300x250%2C728x90&gdfp_req=1&output=vast&unviewed_position_start=1&env=vp&impl=s&correlator=]]>
+      </vmap:AdTagURI>
+    </vmap:AdSource>
+  </vmap:AdBreak>
+  
+  <!-- Post-roll Ad -->
+  <vmap:AdBreak timeOffset="end" breakType="linear" breakId="postroll">
+    <vmap:AdSource id="postroll-ad" allowMultipleAds="false" followRedirects="true">
+      <vmap:AdTagURI templateType="vast3">
+        <![CDATA[https://pubads.g.doubleclick.net/gampad/ads?iu=/21775744923/external/single_ad_samples&sz=640x480&cust_params=sample_ct%3Dlinear&ciu_szs=300x250%2C728x90&gdfp_req=1&output=vast&unviewed_position_start=1&env=vp&impl=s&correlator=]]>
+      </vmap:AdTagURI>
+    </vmap:AdSource>
+  </vmap:AdBreak>
+</vmap:VMAP>
+

package/dist/types/analytics.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Analytics SDK Types
+ *
+ * Conviva / Youbora-style heartbeat + event tracking for Playron.
+ */
+export type AnalyticsEventName = 'session_start' | 'session_end' | 'play' | 'pause' | 'resume' | 'seek_start' | 'seek_end' | 'buffer_start' | 'buffer_end' | 'quality_change' | 'error' | 'heartbeat';
+/** A single analytics event payload sent to the endpoint */
+export interface AnalyticsEvent {
+    /** Event name */
+    event: AnalyticsEventName;
+    /** ISO-8601 timestamp */
+    timestamp: string;
+    /** Unique session ID for this playback session */
+    sessionId: string;
+    /** Player / content metadata */
+    meta: AnalyticsMeta;
+    /** Event-specific data */
+    data: Record<string, unknown>;
+}
+/** Player + content metadata attached to every event */
+export interface AnalyticsMeta {
+    /** Content source URL */
+    src: string;
+    /** Stream type — hls | dash | progressive | unknown */
+    streamType: string;
+    /** Whether the stream is live */
+    isLive: boolean;
+    /** Total content duration in seconds (NaN for live) */
+    duration: number;
+    /** Player version string */
+    playerVersion: string;
+    /** User agent */
+    userAgent: string;
+    /** Custom metadata provided by the integrator */
+    custom?: Record<string, unknown>;
+}
+export interface AnalyticsSessionMetrics {
+    /** Total play time in seconds */
+    playTime: number;
+    /** Total buffering time in seconds */
+    bufferingTime: number;
+    /** Number of buffering events */
+    bufferingCount: number;
+    /** Number of seek events */
+    seekCount: number;
+    /** Number of quality changes */
+    qualityChangeCount: number;
+    /** Timestamp (ms) when playback first started */
+    playbackStartTime: number;
+    /** Time-to-first-frame in seconds (setSource → first 'playing' event) */
+    timeToFirstFrame: number;
+    /** Map of quality label → seconds played at that quality */
+    qualityTime: Record<string, number>;
+    /** Average bandwidth estimate (bps) during session */
+    avgBandwidth: number;
+}
+export interface AnalyticsConfig {
+    /**
+     * Analytics endpoint URL.
+     * Events are POST-ed as JSON: `{ events: AnalyticsEvent[] }`.
+     * If omitted, events are only dispatched to `onEvent` callback.
+     */
+    endpointUrl?: string;
+    /** Extra HTTP headers for each analytics request */
+    headers?: Record<string, string>;
+    /**
+     * Heartbeat interval in seconds (default: 30).
+     * Set to 0 to disable heartbeats.
+     */
+    heartbeatInterval?: number;
+    /**
+     * Maximum number of events to batch before flushing (default: 10).
+     * Events are also flushed on heartbeat and session end.
+     */
+    batchSize?: number;
+    /** Custom metadata attached to `AnalyticsMeta.custom` */
+    customMeta?: Record<string, unknown>;
+    /**
+     * Optional event hook — called synchronously for every tracked event.
+     * Use this for custom integrations (e.g. gtag, Segment, Mixpanel).
+     */
+    onEvent?: (event: AnalyticsEvent) => void;
+    /** Whether to log events to the console (default: false) */
+    debug?: boolean;
+}
+//# sourceMappingURL=analytics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../../src/types/analytics.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,MAAM,kBAAkB,GAC1B,eAAe,GACf,aAAa,GACb,MAAM,GACN,OAAO,GACP,QAAQ,GACR,YAAY,GACZ,UAAU,GACV,cAAc,GACd,YAAY,GACZ,gBAAgB,GAChB,OAAO,GACP,WAAW,CAAC;AAEhB,4DAA4D;AAC5D,MAAM,WAAW,cAAc;IAC7B,iBAAiB;IACjB,KAAK,EAAE,kBAAkB,CAAC;IAC1B,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,IAAI,EAAE,aAAa,CAAC;IACpB,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,wDAAwD;AACxD,MAAM,WAAW,aAAa;IAC5B,yBAAyB;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,MAAM,EAAE,OAAO,CAAC;IAChB,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,4BAA4B;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAID,MAAM,WAAW,uBAAuB;IACtC,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,aAAa,EAAE,MAAM,CAAC;IACtB,iCAAiC;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iDAAiD;IACjD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,yEAAyE;IACzE,gBAAgB,EAAE,MAAM,CAAC;IACzB,4DAA4D;IAC5D,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,sDAAsD;IACtD,YAAY,EAAE,MAAM,CAAC;CACtB;AAID,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAErC;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;IAE1C,4DAA4D;IAC5D,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB"}

package/dist/types/chapters.types.d.ts

@@ -0,0 +1,17 @@
+export interface Chapter {
+    id: string;
+    title: string;
+    startTime: number;
+    endTime?: number;
+}
+export interface IntroOutro {
+    intro?: {
+        start: number;
+        end: number;
+    };
+    outro?: {
+        start: number;
+        end: number;
+    };
+}
+//# sourceMappingURL=chapters.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chapters.types.d.ts","sourceRoot":"","sources":["../../src/types/chapters.types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE;QACN,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;IACF,KAAK,CAAC,EAAE;QACN,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;CACH"}

package/dist/types/config.d.ts

@@ -0,0 +1,23 @@
+export interface VanillaPlayerConfig {
+    container: string | HTMLElement;
+    src: string;
+    width?: string | number;
+    height?: string | number;
+    autoplay?: boolean;
+    muted?: boolean;
+    poster?: string;
+    className?: string;
+    controls?: boolean;
+}
+export interface PlayerState {
+    isPlaying: boolean;
+    isMuted: boolean;
+    volume: number;
+    currentTime: number;
+    duration: number;
+    playbackRate?: number;
+    isLive?: boolean;
+    isAtLiveEdge?: boolean;
+    liveLatency?: number;
+}
+//# sourceMappingURL=config.d.ts.map