@se-studio/core-ui 0.0.0-next16-20260822103555

package/dist/analytics/adapters/GoogleTagManagerAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GoogleTagManagerAdapter.d.ts","sourceRoot":"","sources":["../../../src/analytics/adapters/GoogleTagManagerAdapter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAElG,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,SAAS,EAAE,OAAO,EAAE,CAAC;KACtB;CACF;AAED;;GAEG;AACH,UAAU,YAAY;IACpB,iCAAiC;IACjC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,UAAU,sBAAsB;IAC9B;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,uBAAwB,YAAW,gBAAgB;IAC9D,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,MAAM,CAAyB;gBAE3B,MAAM,EAAE,sBAAsB;IAI1C;;OAEG;IACH,OAAO,CAAC,IAAI;IAMZ;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAS7B,UAAU;IA2DV;;;;;OAKG;IACH,aAAa,CAAC,OAAO,EAAE,YAAY;IAkBnC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAapE,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,sBAAsB,GAAG,IAAI;IAiBhE,UAAU,CAAC,UAAU,EAAE,uBAAuB,GAAG,IAAI;CAatD"}

package/dist/analytics/adapters/GoogleTagManagerAdapter.js

@@ -0,0 +1,134 @@
+'use client';
+export class GoogleTagManagerAdapter {
+    initialized = false;
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Push gtag commands to dataLayer
+     */
+    gtag(...args) {
+        if (typeof window === 'undefined')
+            return;
+        window.dataLayer = window.dataLayer || [];
+        window.dataLayer.push(args);
+    }
+    /**
+     * Initialize consent mode with all consent types granted by default
+     */
+    initializeConsentMode() {
+        this.gtag('consent', 'default', {
+            analytics_storage: 'granted',
+            ad_storage: 'granted',
+            ad_user_data: 'granted',
+            ad_personalization: 'granted',
+        });
+    }
+    initialize() {
+        if (typeof window === 'undefined' || this.initialized)
+            return;
+        const { containerId, measurementId } = this.config;
+        if (!containerId && !measurementId) {
+            console.warn('[GTM Adapter] No container ID or measurement ID provided');
+            return;
+        }
+        // Initialize dataLayer
+        window.dataLayer = window.dataLayer || [];
+        // IMPORTANT: Initialize consent BEFORE loading GTM
+        this.initializeConsentMode();
+        if (containerId) {
+            // Check if GTM script already exists
+            const existingScript = document.querySelector(`script[src*="googletagmanager.com/gtm.js?id=${containerId}"]`);
+            if (existingScript) {
+                console.warn(`[GTM Adapter] GTM script with ID ${containerId} already exists in document.`);
+                this.initialized = true;
+                return;
+            }
+            // Load GTM
+            window.dataLayer.push({ 'gtm.start': Date.now(), event: 'gtm.js' });
+            const script = document.createElement('script');
+            script.async = true;
+            script.src = `https://www.googletagmanager.com/gtm.js?id=${containerId}`;
+            document.head.appendChild(script);
+        }
+        else if (measurementId) {
+            // Check if GA4 script already exists
+            const existingScript = document.querySelector(`script[src*="googletagmanager.com/gtag/js?id=${measurementId}"]`);
+            if (existingScript) {
+                console.warn(`[GTM Adapter] GA4 script with ID ${measurementId} already exists in document.`);
+                this.initialized = true;
+                return;
+            }
+            // Load GA4 directly (gtag.js)
+            const script = document.createElement('script');
+            script.async = true;
+            script.src = `https://www.googletagmanager.com/gtag/js?id=${measurementId}`;
+            document.head.appendChild(script);
+            this.gtag('js', new Date());
+            this.gtag('config', measurementId);
+        }
+        this.initialized = true;
+    }
+    /**
+     * Update consent state for specific purposes.
+     * Call this when user grants or revokes consent.
+     *
+     * @param consent - Object with analytics and/or advertising consent state
+     */
+    updateConsent(consent) {
+        if (typeof window === 'undefined')
+            return;
+        if (consent.analytics !== undefined) {
+            this.gtag('consent', 'update', {
+                analytics_storage: consent.analytics ? 'granted' : 'denied',
+            });
+        }
+        if (consent.advertising !== undefined) {
+            this.gtag('consent', 'update', {
+                ad_storage: consent.advertising ? 'granted' : 'denied',
+                ad_user_data: consent.advertising ? 'granted' : 'denied',
+                ad_personalization: consent.advertising ? 'granted' : 'denied',
+            });
+        }
+    }
+    trackEvent(event, properties) {
+        if (typeof window === 'undefined')
+            return;
+        const dataLayer = window.dataLayer;
+        if (dataLayer) {
+            dataLayer.push({
+                event,
+                ...properties,
+            });
+        }
+    }
+    trackPage(url, properties) {
+        if (typeof window === 'undefined')
+            return;
+        const dataLayer = window.dataLayer;
+        if (dataLayer) {
+            dataLayer.push({
+                event: 'page_view',
+                page_location: url,
+                page_path: properties.pathname,
+                page_title: properties.title,
+                page_type: properties.type,
+                slug: properties.slug,
+            });
+        }
+    }
+    trackClick(properties) {
+        if (typeof window === 'undefined')
+            return;
+        const dataLayer = window.dataLayer;
+        const eventName = properties.trackingInfo?.trackingEventName?.trim() || 'click';
+        if (dataLayer) {
+            dataLayer.push({
+                event: eventName,
+                ...properties,
+            });
+        }
+    }
+}
+//# sourceMappingURL=GoogleTagManagerAdapter.js.map

package/dist/analytics/adapters/GoogleTagManagerAdapter.js.map

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

package/dist/analytics/adapters/index.d.ts

@@ -0,0 +1,5 @@
+export { CompositeAnalyticsAdapter } from './CompositeAnalyticsAdapter';
+export { ConsentAwareAdapter } from './ConsentAwareAdapter';
+export { ConsoleAnalyticsAdapter } from './ConsoleAnalyticsAdapter';
+export { GoogleTagManagerAdapter } from './GoogleTagManagerAdapter';
+//# sourceMappingURL=index.d.ts.map

package/dist/analytics/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/analytics/adapters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/analytics/adapters/index.js

@@ -0,0 +1,5 @@
+export { CompositeAnalyticsAdapter } from './CompositeAnalyticsAdapter';
+export { ConsentAwareAdapter } from './ConsentAwareAdapter';
+export { ConsoleAnalyticsAdapter } from './ConsoleAnalyticsAdapter';
+export { GoogleTagManagerAdapter } from './GoogleTagManagerAdapter';
+//# sourceMappingURL=index.js.map

package/dist/analytics/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/analytics/adapters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/analytics/types.d.ts

@@ -0,0 +1,42 @@
+import type { IAnalyticsContext, ILinkTrackingInfo } from '@se-studio/core-data-types';
+/**
+ * Properties for tracking a click event
+ */
+export interface ClickTrackingProperties extends IAnalyticsContext {
+    componentType: string;
+    url: string;
+    targetUrl?: string;
+    linkText: string;
+    location?: string;
+    trackingInfo?: ILinkTrackingInfo;
+}
+/**
+ * Properties for tracking a page view
+ */
+export interface PageTrackingProperties extends IAnalyticsContext {
+    url: string;
+    pathname: string;
+}
+/**
+ * Interface that analytics adapters must implement
+ */
+export interface AnalyticsAdapter {
+    /**
+     * Track a custom event
+     * @param event - Event name
+     * @param properties - Event properties
+     */
+    trackEvent(event: string, properties: Record<string, unknown>): void;
+    /**
+     * Track a page view
+     * @param url - Full URL of the page
+     * @param properties - Page properties
+     */
+    trackPage(url: string, properties: PageTrackingProperties): void;
+    /**
+     * Track a component click
+     * @param properties - Click tracking properties
+     */
+    trackClick(properties: ClickTrackingProperties): void;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/analytics/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAEvF;;GAEG;AACH,MAAM,WAAW,uBAAwB,SAAQ,iBAAiB;IAChE,aAAa,EAAE,MAAM,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,iBAAiB,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,iBAAiB;IAC/D,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAErE;;;;OAIG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAEjE;;;OAGG;IACH,UAAU,CAAC,UAAU,EAAE,uBAAuB,GAAG,IAAI,CAAC;CACvD"}

package/dist/analytics/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/analytics/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/analytics/types.ts"],"names":[],"mappings":""}

package/dist/analytics/useAnalytics.d.ts

@@ -0,0 +1,44 @@
+import type { IAnalyticsContext, ILinkTrackingInfo } from '@se-studio/core-data-types';
+/**
+ * Hook for accessing analytics functions.
+ *
+ * Provides a clean API for tracking events, pages, and clicks. Prefer using
+ * inside an `AnalyticsProvider`; without one, calls are silent no-ops.
+ *
+ * @returns Object with tracking functions:
+ * - `trackEvent` - Track custom events
+ * - `trackPage` - Track page views
+ * - `trackClick` - Track click interactions
+ *
+ * @example Basic usage
+ * ```tsx
+ * import { useAnalytics } from '@se-studio/core-ui';
+ *
+ * function MyComponent() {
+ *   const { trackClick, trackPage } = useAnalytics();
+ *
+ *   useEffect(() => {
+ *     trackPage(window.location.href, window.location.pathname, {
+ *       page_title: 'Home',
+ *       page_type: 'landing',
+ *     });
+ *   }, []);
+ *
+ *   return (
+ *     <button onClick={() => trackClick('Button', 'Sign up', { page_title: 'Home' })}>
+ *       Sign up
+ *     </button>
+ *   );
+ * }
+ * ```
+ */
+export declare function useAnalytics(): {
+    trackEvent: (event: string, properties: Record<string, unknown>) => void;
+    trackPage: (url: string, pathname: string, analyticsContext: IAnalyticsContext) => void;
+    trackClick: (componentType: string, linkText: string, analyticsContext: IAnalyticsContext, options?: {
+        targetUrl?: string;
+        location?: string;
+        trackingInfo?: ILinkTrackingInfo;
+    }) => void;
+};
+//# sourceMappingURL=useAnalytics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useAnalytics.d.ts","sourceRoot":"","sources":["../../src/analytics/useAnalytics.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAKvF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,YAAY;wBAGhB,MAAM,cAAc,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;qBAO7C,MAAM,YAAY,MAAM,oBAAoB,iBAAiB;gCAalD,MAAM,YACX,MAAM,oBACE,iBAAiB,YACzB;QACR,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,YAAY,CAAC,EAAE,iBAAiB,CAAC;KAClC;EAsBN"}

package/dist/analytics/useAnalytics.js

@@ -0,0 +1,69 @@
+'use client';
+import { useCallback } from 'react';
+import { useAnalyticsContext } from './AnalyticsProvider';
+/**
+ * Hook for accessing analytics functions.
+ *
+ * Provides a clean API for tracking events, pages, and clicks. Prefer using
+ * inside an `AnalyticsProvider`; without one, calls are silent no-ops.
+ *
+ * @returns Object with tracking functions:
+ * - `trackEvent` - Track custom events
+ * - `trackPage` - Track page views
+ * - `trackClick` - Track click interactions
+ *
+ * @example Basic usage
+ * ```tsx
+ * import { useAnalytics } from '@se-studio/core-ui';
+ *
+ * function MyComponent() {
+ *   const { trackClick, trackPage } = useAnalytics();
+ *
+ *   useEffect(() => {
+ *     trackPage(window.location.href, window.location.pathname, {
+ *       page_title: 'Home',
+ *       page_type: 'landing',
+ *     });
+ *   }, []);
+ *
+ *   return (
+ *     <button onClick={() => trackClick('Button', 'Sign up', { page_title: 'Home' })}>
+ *       Sign up
+ *     </button>
+ *   );
+ * }
+ * ```
+ */
+export function useAnalytics() {
+    const adapter = useAnalyticsContext();
+    const trackEvent = useCallback((event, properties) => {
+        adapter.trackEvent(event, properties);
+    }, [adapter]);
+    const trackPage = useCallback((url, pathname, analyticsContext) => {
+        const properties = {
+            url,
+            pathname,
+            ...analyticsContext,
+        };
+        adapter.trackPage(url, properties);
+    }, [adapter]);
+    const trackClick = useCallback((componentType, linkText, analyticsContext, options) => {
+        const url = typeof window !== 'undefined' ? window.location.href : '';
+        const properties = {
+            componentType,
+            url,
+            linkText,
+            location: options?.location,
+            targetUrl: options?.targetUrl,
+            trackingInfo: options?.trackingInfo,
+            ...analyticsContext,
+        };
+        adapter.trackClick(properties);
+    }, [adapter]);
+    return {
+        trackEvent,
+        trackPage,
+        trackClick,
+    };
+}
+//# sourceMappingURL=useAnalytics.js.map

package/dist/analytics/useAnalytics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAnalytics.js","sourceRoot":"","sources":["../../src/analytics/useAnalytics.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAGb,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAG1D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,OAAO,GAAG,mBAAmB,EAAE,CAAC;IACtC,MAAM,UAAU,GAAG,WAAW,CAC5B,CAAC,KAAa,EAAE,UAAmC,EAAE,EAAE;QACrD,OAAO,CAAC,UAAU,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IACxC,CAAC,EACD,CAAC,OAAO,CAAC,CACV,CAAC;IAEF,MAAM,SAAS,GAAG,WAAW,CAC3B,CAAC,GAAW,EAAE,QAAgB,EAAE,gBAAmC,EAAE,EAAE;QACrE,MAAM,UAAU,GAA2B;YACzC,GAAG;YACH,QAAQ;YACR,GAAG,gBAAgB;SACpB,CAAC;QACF,OAAO,CAAC,SAAS,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IACrC,CAAC,EACD,CAAC,OAAO,CAAC,CACV,CAAC;IAEF,MAAM,UAAU,GAAG,WAAW,CAC5B,CACE,aAAqB,EACrB,QAAgB,EAChB,gBAAmC,EACnC,OAIC,EACD,EAAE;QACF,MAAM,GAAG,GAAG,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,MAAM,UAAU,GAA4B;YAC1C,aAAa;YACb,GAAG;YACH,QAAQ;YACR,QAAQ,EAAE,OAAO,EAAE,QAAQ;YAC3B,SAAS,EAAE,OAAO,EAAE,SAAS;YAC7B,YAAY,EAAE,OAAO,EAAE,YAAY;YACnC,GAAG,gBAAgB;SACpB,CAAC;QACF,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;IACjC,CAAC,EACD,CAAC,OAAO,CAAC,CACV,CAAC;IAEF,OAAO;QACL,UAAU;QACV,SAAS;QACT,UAAU;KACX,CAAC;AACJ,CAAC"}

package/dist/analytics/video/classifySeek.d.ts

@@ -0,0 +1,15 @@
+import { VIDEO_ENGAGEMENT_THRESHOLDS } from './videoEngagementTypes';
+export interface SeekClassification {
+    /** Large enough jump to count as a seek (forward or back). */
+    material: boolean;
+    /** Forward jump past seek thresholds. */
+    largeForward: boolean;
+    fromPercent: number;
+    toPercent: number;
+    direction: 'forward' | 'back';
+}
+/**
+ * Classify a playback position jump for analytics (material seek vs noise).
+ */
+export declare function classifySeek(fromSeconds: number, toSeconds: number, durationSeconds: number, thresholds?: typeof VIDEO_ENGAGEMENT_THRESHOLDS): SeekClassification;
+//# sourceMappingURL=classifySeek.d.ts.map

package/dist/analytics/video/classifySeek.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classifySeek.d.ts","sourceRoot":"","sources":["../../../src/analytics/video/classifySeek.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAErE,MAAM,WAAW,kBAAkB;IACjC,8DAA8D;IAC9D,QAAQ,EAAE,OAAO,CAAC;IAClB,yCAAyC;IACzC,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,SAAS,GAAG,MAAM,CAAC;CAC/B;AAaD;;GAEG;AACH,wBAAgB,YAAY,CAC1B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,EACvB,UAAU,GAAE,OAAO,2BAAyD,GAC3E,kBAAkB,CAoBpB"}

package/dist/analytics/video/classifySeek.js

@@ -0,0 +1,32 @@
+import { VIDEO_ENGAGEMENT_THRESHOLDS } from './videoEngagementTypes';
+function clampPercent(value) {
+    if (!Number.isFinite(value) || value < 0)
+        return 0;
+    if (value > 100)
+        return 100;
+    return value;
+}
+function percentOf(current, duration) {
+    if (!duration || duration <= 0 || !Number.isFinite(current))
+        return 0;
+    return clampPercent((current / duration) * 100);
+}
+/**
+ * Classify a playback position jump for analytics (material seek vs noise).
+ */
+export function classifySeek(fromSeconds, toSeconds, durationSeconds, thresholds = VIDEO_ENGAGEMENT_THRESHOLDS) {
+    const duration = durationSeconds > 0 ? durationSeconds : 0;
+    const delta = toSeconds - fromSeconds;
+    const absDelta = Math.abs(delta);
+    const minByPercent = duration > 0 ? (thresholds.seekMinPercent / 100) * duration : thresholds.seekMinSeconds;
+    const material = absDelta >= thresholds.seekMinSeconds || (duration > 0 && absDelta >= minByPercent);
+    const largeForward = delta > 0 && (delta >= thresholds.seekMinSeconds || (duration > 0 && delta >= minByPercent));
+    return {
+        material,
+        largeForward,
+        fromPercent: Math.round(percentOf(fromSeconds, duration) * 10) / 10,
+        toPercent: Math.round(percentOf(toSeconds, duration) * 10) / 10,
+        direction: delta >= 0 ? 'forward' : 'back',
+    };
+}
+//# sourceMappingURL=classifySeek.js.map

package/dist/analytics/video/classifySeek.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classifySeek.js","sourceRoot":"","sources":["../../../src/analytics/video/classifySeek.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAYrE,SAAS,YAAY,CAAC,KAAa;IACjC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,CAAC,CAAC;IACnD,IAAI,KAAK,GAAG,GAAG;QAAE,OAAO,GAAG,CAAC;IAC5B,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,SAAS,CAAC,OAAe,EAAE,QAAgB;IAClD,IAAI,CAAC,QAAQ,IAAI,QAAQ,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,CAAC,CAAC;IACtE,OAAO,YAAY,CAAC,CAAC,OAAO,GAAG,QAAQ,CAAC,GAAG,GAAG,CAAC,CAAC;AAClD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAC1B,WAAmB,EACnB,SAAiB,EACjB,eAAuB,EACvB,aAAiD,2BAA2B;IAE5E,MAAM,QAAQ,GAAG,eAAe,GAAG,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3D,MAAM,KAAK,GAAG,SAAS,GAAG,WAAW,CAAC;IACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACjC,MAAM,YAAY,GAChB,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,cAAc,GAAG,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,cAAc,CAAC;IAE1F,MAAM,QAAQ,GACZ,QAAQ,IAAI,UAAU,CAAC,cAAc,IAAI,CAAC,QAAQ,GAAG,CAAC,IAAI,QAAQ,IAAI,YAAY,CAAC,CAAC;IAEtF,MAAM,YAAY,GAChB,KAAK,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,UAAU,CAAC,cAAc,IAAI,CAAC,QAAQ,GAAG,CAAC,IAAI,KAAK,IAAI,YAAY,CAAC,CAAC,CAAC;IAE/F,OAAO;QACL,QAAQ;QACR,YAAY;QACZ,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,WAAW,EAAE,QAAQ,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE;QACnE,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,SAAS,EAAE,QAAQ,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE;QAC/D,SAAS,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM;KAC3C,CAAC;AACJ,CAAC"}

package/dist/analytics/video/createVideoEngagementSession.d.ts

@@ -0,0 +1,51 @@
+import { type VideoEngagementIdentity, type VideoEngagementTrackFn } from './videoEngagementTypes';
+export interface CreateVideoEngagementSessionOptions {
+    identity: VideoEngagementIdentity;
+    track: VideoEngagementTrackFn;
+    /** Page URL for payload; defaults to window.location.href when available. */
+    getPageUrl?: () => string;
+}
+export interface VideoEngagementSession {
+    /** Fire video_impression once (e.g. from IntersectionObserver). */
+    markImpression: () => void;
+    onPlay: (muted: boolean) => void;
+    onPause: () => void;
+    onTime: (currentTimeSeconds: number, durationSeconds: number) => void;
+    onSeek: (fromSeconds: number, toSeconds: number, durationSeconds: number) => void;
+    onMuteChange: (muted: boolean) => void;
+    onFullscreen: (fullscreen: boolean) => void;
+    onEnded: (durationSeconds: number) => void;
+    /** Call on unmount / pagehide — may emit video_exit. */
+    dispose: () => void;
+    /**
+     * Snapshot for unit tests / debugging only — not part of the public analytics
+     * surface. Returns live internal state (mutable Sets, etc.).
+     */
+    getState: () => Readonly<SessionState>;
+}
+interface SessionState {
+    impressed: boolean;
+    started: boolean;
+    completed: boolean;
+    exited: boolean;
+    muted: boolean;
+    mutedAtStart: boolean | null;
+    usedFullscreen: boolean;
+    fullscreen: boolean;
+    maxPercent: number;
+    watchSeconds: number;
+    durationSeconds: number;
+    seekCount: number;
+    largeForwardSeekCount: number;
+    quartilesFired: Set<number>;
+    unmutedFired: boolean;
+    playing: boolean;
+    playStartedAtMs: number | null;
+}
+/**
+ * Pure engagement session: provider adapters translate player events into these methods.
+ * Fires at most one start/complete/exit/impression; quartiles once each; unmute once.
+ */
+export declare function createVideoEngagementSession(options: CreateVideoEngagementSessionOptions): VideoEngagementSession;
+export {};
+//# sourceMappingURL=createVideoEngagementSession.d.ts.map

package/dist/analytics/video/createVideoEngagementSession.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createVideoEngagementSession.d.ts","sourceRoot":"","sources":["../../../src/analytics/video/createVideoEngagementSession.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC5B,MAAM,wBAAwB,CAAC;AAEhC,MAAM,WAAW,mCAAmC;IAClD,QAAQ,EAAE,uBAAuB,CAAC;IAClC,KAAK,EAAE,sBAAsB,CAAC;IAC9B,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB;IACrC,mEAAmE;IACnE,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACjC,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,MAAM,EAAE,CAAC,kBAAkB,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,KAAK,IAAI,CAAC;IACtE,MAAM,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,KAAK,IAAI,CAAC;IAClF,YAAY,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC,YAAY,EAAE,CAAC,UAAU,EAAE,OAAO,KAAK,IAAI,CAAC;IAC5C,OAAO,EAAE,CAAC,eAAe,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,wDAAwD;IACxD,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB;;;OAGG;IACH,QAAQ,EAAE,MAAM,QAAQ,CAAC,YAAY,CAAC,CAAC;CACxC;AAED,UAAU,YAAY;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,YAAY,EAAE,OAAO,GAAG,IAAI,CAAC;IAC7B,cAAc,EAAE,OAAO,CAAC;IACxB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC5B,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAkBD;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,mCAAmC,GAC3C,sBAAsB,CAuNxB"}