@v-tilt/browser 1.2.0 → 1.3.0

package/dist/types.d.ts

@@ -51,8 +51,11 @@ export interface VTiltConfig {
     person_profiles?: PersonProfilesMode;
     /** Enable autocapture */
     autocapture?: boolean;
-    /** Enable web vitals tracking */
-    capture_performance?: boolean;
+    /**
+     * Enable web vitals tracking.
+     * Can be a boolean or an object with detailed configuration.
+     */
+    capture_performance?: boolean | CapturePerformanceConfig;
     /** Enable page view tracking */
     capture_pageview?: boolean | "auto";
     /** Enable page leave tracking */
@@ -160,6 +163,29 @@ export interface AliasEvent {
     distinct_id: string;
     original: string;
 }
+/** Supported Web Vitals metrics */
+export type SupportedWebVitalsMetric = "LCP" | "CLS" | "FCP" | "INP" | "TTFB";
+/** All supported Web Vitals metrics */
+export declare const ALL_WEB_VITALS_METRICS: SupportedWebVitalsMetric[];
+/** Default Web Vitals metrics (matches PostHog defaults) */
+export declare const DEFAULT_WEB_VITALS_METRICS: SupportedWebVitalsMetric[];
+/**
+ * Web Vitals capture configuration
+ */
+export interface CapturePerformanceConfig {
+    /** Enable or disable web vitals capture */
+    web_vitals?: boolean;
+    /** Which metrics to capture (default: LCP, CLS, FCP, INP) */
+    web_vitals_allowed_metrics?: SupportedWebVitalsMetric[];
+    /** Delay before flushing metrics in ms (default: 5000) */
+    web_vitals_delayed_flush_ms?: number;
+    /**
+     * Maximum allowed metric value in ms (default: 900000 = 15 minutes)
+     * Values above this are considered anomalies and ignored.
+     * Set to 0 to disable this check.
+     */
+    __web_vitals_max_value?: number;
+}
 export interface WebVitalMetric {
     name: string;
     value: number;
@@ -167,6 +193,10 @@ export interface WebVitalMetric {
     rating: "good" | "needs-improvement" | "poor";
     id: string;
     navigationType: string;
+    /** Timestamp when the metric was captured (added internally) */
+    timestamp?: number;
+    /** Attribution data from web-vitals library */
+    attribution?: Record<string, unknown>;
 }
 export interface GeolocationData {
     country?: string;

package/dist/utils/globals.d.ts

@@ -17,6 +17,31 @@ export interface LazyLoadedSessionRecordingInterface {
     log: (message: string, level: "log" | "warn" | "error") => void;
     updateConfig: (config: any) => void;
 }
+/**
+ * Web Vitals metric callback type
+ */
+export type WebVitalsMetricCallback = (metric: any) => void;
+/**
+ * Options for web vitals callbacks
+ */
+export interface WebVitalsCallbackOptions {
+    /** Report all changes (useful for CLS which updates over time) */
+    reportAllChanges?: boolean;
+}
+/**
+ * Web Vitals callback function type (with optional options)
+ */
+export type WebVitalsCallbackFn = (callback: WebVitalsMetricCallback, options?: WebVitalsCallbackOptions) => void;
+/**
+ * Web Vitals callbacks interface (set by web-vitals.ts entrypoint)
+ */
+export interface WebVitalsCallbacks {
+    onLCP: WebVitalsCallbackFn;
+    onCLS: WebVitalsCallbackFn;
+    onFCP: WebVitalsCallbackFn;
+    onINP: WebVitalsCallbackFn;
+    onTTFB?: WebVitalsCallbackFn;
+}
 /**
  * VTilt Extensions interface for dynamically loaded modules
  * This is the contract between lazily loaded extensions and the SDK
@@ -37,6 +62,8 @@ export interface VTiltExtensions {
     };
     /** Factory to create LazyLoadedSessionRecording (set by recorder.ts) */
     initSessionRecording?: (instance: any, config?: any) => LazyLoadedSessionRecordingInterface;
+    /** Web Vitals callbacks (set by web-vitals.ts entrypoint) */
+    webVitalsCallbacks?: WebVitalsCallbacks;
 }
 export type AssignableWindow = Window & typeof globalThis & {
     /** Main VTilt instance */

package/dist/web-vitals.d.ts

@@ -1,11 +1,95 @@
-import { VTiltConfig } from "./types";
+import { VTiltConfig, SupportedWebVitalsMetric } from "./types";
 import { VTilt } from "./vtilt";
+/**
+ * Web Vitals Manager
+ *
+ * Captures Core Web Vitals (LCP, CLS, FCP, INP, TTFB) and sends them
+ * as batched $web_vitals events. Follows PostHog's approach with:
+ *
+ * 1. Extension pattern - checks for callbacks registered on __VTiltExtensions__
+ * 2. Lazy loading - loads web-vitals.js on demand if not bundled
+ * 3. Configurable metrics - choose which metrics to capture
+ * 4. Smart buffering - collects metrics per page, flushes on navigation or timeout
+ * 5. Session context - includes session_id and window_id for correlation
+ *
+ * Event structure:
+ * - event: "$web_vitals"
+ * - properties:
+ *   - $web_vitals_LCP_value: number
+ *   - $web_vitals_LCP_event: { name, value, delta, rating, ... }
+ *   - $pathname: string
+ *   - $current_url: string
+ */
 export declare class WebVitalsManager {
     private instance;
-    private webVitals;
-    constructor(config: VTiltConfig, instance: VTilt);
+    private buffer;
+    private flushTimer;
+    private initialized;
+    private config;
+    constructor(vtiltConfig: VTiltConfig, instance: VTilt);
     /**
-     * Initialize web vitals tracking
+     * Parse capture_performance config (boolean or object)
      */
-    private initializeWebVitals;
+    private parseConfig;
+    /**
+     * Check if web vitals capture is enabled
+     */
+    get isEnabled(): boolean;
+    /**
+     * Get the list of metrics to capture
+     */
+    get allowedMetrics(): SupportedWebVitalsMetric[];
+    /**
+     * Get flush timeout in ms
+     */
+    get flushTimeoutMs(): number;
+    /**
+     * Get maximum allowed metric value
+     */
+    get maxAllowedValue(): number;
+    private createEmptyBuffer;
+    /**
+     * Check if web vitals callbacks are available
+     */
+    private getWebVitalsCallbacks;
+    /**
+     * Start capturing if enabled and callbacks are available
+     */
+    startIfEnabled(): void;
+    /**
+     * Lazy load web-vitals extension
+     */
+    private loadWebVitals;
+    /**
+     * Start capturing web vitals using the provided callbacks
+     */
+    private startCapturing;
+    /**
+     * Get current URL
+     */
+    private getCurrentUrl;
+    /**
+     * Get current pathname
+     */
+    private getCurrentPathname;
+    /**
+     * Add a metric to the buffer
+     */
+    private addToBuffer;
+    /**
+     * Clean attribution data by removing large elements
+     */
+    private cleanAttribution;
+    /**
+     * Get window ID from instance
+     */
+    private getWindowId;
+    /**
+     * Schedule a delayed flush
+     */
+    private scheduleFlush;
+    /**
+     * Flush buffered metrics as a single event
+     */
+    private flush;
 }

package/dist/web-vitals.js

@@ -0,0 +1,2 @@
+!function(){"use strict";var n,e=-1,t=function(n){addEventListener("pageshow",function(t){t.persisted&&(e=t.timeStamp,n(t))},!0)},i=function(){return window.performance&&performance.getEntriesByType&&performance.getEntriesByType("navigation")[0]},r=function(){var n=i();return n&&n.activationStart||0},o=function(n,t){var o=i(),u="navigate";return e>=0?u="back-forward-cache":o&&(document.prerendering||r()>0?u="prerender":document.wasDiscarded?u="restore":o.type&&(u=o.type.replace(/_/g,"-"))),{name:n,value:void 0===t?-1:t,rating:"good",delta:0,entries:[],id:"v3-".concat(Date.now(),"-").concat(Math.floor(8999999999999*Math.random())+1e12),navigationType:u}},u=function(n,e,t){try{if(PerformanceObserver.supportedEntryTypes.includes(n)){var i=new PerformanceObserver(function(n){Promise.resolve().then(function(){e(n.getEntries())})});return i.observe(Object.assign({type:n,buffered:!0},t||{})),i}}catch(n){}},c=function(n,e,t,i){var r,o;return function(u){e.value>=0&&(u||i)&&((o=e.value-(r||0))||void 0===r)&&(r=e.value,e.delta=o,e.rating=function(n,e){return n>e[1]?"poor":n>e[0]?"needs-improvement":"good"}(e.value,t),n(e))}},f=function(n){requestAnimationFrame(function(){return requestAnimationFrame(function(){return n()})})},a=function(n){var e=function(e){"pagehide"!==e.type&&"hidden"!==document.visibilityState||n(e)};addEventListener("visibilitychange",e,!0),addEventListener("pagehide",e,!0)},d=function(n){var e=!1;return function(t){e||(n(t),e=!0)}},v=-1,s=function(){return"hidden"!==document.visibilityState||document.prerendering?1/0:0},l=function(n){"hidden"===document.visibilityState&&v>-1&&(v="visibilitychange"===n.type?n.timeStamp:0,h())},m=function(){addEventListener("visibilitychange",l,!0),addEventListener("prerenderingchange",l,!0)},h=function(){removeEventListener("visibilitychange",l,!0),removeEventListener("prerenderingchange",l,!0)},p=function(){return v<0&&(v=s(),m(),t(function(){setTimeout(function(){v=s(),m()},0)})),{get firstHiddenTime(){return v}}},g=function(n){document.prerendering?addEventListener("prerenderingchange",function(){return n()},!0):n()},T=[1800,3e3],L=function(n,e){e=e||{},g(function(){var i,a=p(),d=o("FCP"),v=u("paint",function(n){n.forEach(function(n){"first-contentful-paint"===n.name&&(v.disconnect(),n.startTime<a.firstHiddenTime&&(d.value=Math.max(n.startTime-r(),0),d.entries.push(n),i(!0)))})});v&&(i=c(n,d,T,e.reportAllChanges),t(function(t){d=o("FCP"),i=c(n,d,T,e.reportAllChanges),f(function(){d.value=performance.now()-t.timeStamp,i(!0)})}))})},w=[.1,.25],y=0,P=1/0,b=0,E=function(n){n.forEach(function(n){n.interactionId&&(P=Math.min(P,n.interactionId),b=Math.max(b,n.interactionId),y=b?(b-P)/7+1:0)})},C=function(){return n?y:performance.interactionCount||0},M=function(){"interactionCount"in performance||n||(n=u("event",E,{type:"event",buffered:!0,durationThreshold:0}))},F=[200,500],I=0,k=function(){return C()-I},B=[],N={},O=function(n){var e=B[B.length-1],t=N[n.interactionId];if(t||B.length<10||n.duration>e.latency){if(t)t.entries.push(n),t.latency=Math.max(t.latency,n.duration);else{var i={id:n.interactionId,latency:n.duration,entries:[n]};N[i.id]=i,B.push(i)}B.sort(function(n,e){return e.latency-n.latency}),B.splice(10).forEach(function(n){delete N[n.id]})}},S=[2500,4e3],q={},A=[800,1800],j=function n(e){document.prerendering?g(function(){return n(e)}):"complete"!==document.readyState?addEventListener("load",function(){return n(e)},!0):setTimeout(e,0)},D="undefined"!=typeof window?window:void 0,H="undefined"!=typeof globalThis?globalThis:D,_=null==H?void 0:H.navigator;null==H||H.document,null==H||H.location,null==H||H.fetch,(null==H?void 0:H.XMLHttpRequest)&&"withCredentials"in new H.XMLHttpRequest&&H.XMLHttpRequest,null==H||H.AbortController,null==_||_.userAgent;var x=null!=D?D:{},z={onLCP:function(n,e){e=e||{},g(function(){var i,v=p(),s=o("LCP"),l=function(n){var e=n[n.length-1];e&&e.startTime<v.firstHiddenTime&&(s.value=Math.max(e.startTime-r(),0),s.entries=[e],i())},m=u("largest-contentful-paint",l);if(m){i=c(n,s,S,e.reportAllChanges);var h=d(function(){q[s.id]||(l(m.takeRecords()),m.disconnect(),q[s.id]=!0,i(!0))});["keydown","click"].forEach(function(n){addEventListener(n,function(){return setTimeout(h,0)},!0)}),a(h),t(function(t){s=o("LCP"),i=c(n,s,S,e.reportAllChanges),f(function(){s.value=performance.now()-t.timeStamp,q[s.id]=!0,i(!0)})})}})},onCLS:function(n,e){e=e||{},L(d(function(){var i,r=o("CLS",0),d=0,v=[],s=function(n){n.forEach(function(n){if(!n.hadRecentInput){var e=v[0],t=v[v.length-1];d&&n.startTime-t.startTime<1e3&&n.startTime-e.startTime<5e3?(d+=n.value,v.push(n)):(d=n.value,v=[n])}}),d>r.value&&(r.value=d,r.entries=v,i())},l=u("layout-shift",s);l&&(i=c(n,r,w,e.reportAllChanges),a(function(){s(l.takeRecords()),i(!0)}),t(function(){d=0,r=o("CLS",0),i=c(n,r,w,e.reportAllChanges),f(function(){return i()})}),setTimeout(i,0))}))},onFCP:L,onINP:function(n,e){e=e||{},g(function(){var i;M();var r,f=o("INP"),d=function(n){n.forEach(function(n){n.interactionId&&O(n),"first-input"===n.entryType&&!B.some(function(e){return e.entries.some(function(e){return n.duration===e.duration&&n.startTime===e.startTime})})&&O(n)});var e,t=(e=Math.min(B.length-1,Math.floor(k()/50)),B[e]);t&&t.latency!==f.value&&(f.value=t.latency,f.entries=t.entries,r())},v=u("event",d,{durationThreshold:null!==(i=e.durationThreshold)&&void 0!==i?i:40});r=c(n,f,F,e.reportAllChanges),v&&("PerformanceEventTiming"in window&&"interactionId"in PerformanceEventTiming.prototype&&v.observe({type:"first-input",buffered:!0}),a(function(){d(v.takeRecords()),f.value<0&&k()>0&&(f.value=0,f.entries=[]),r(!0)}),t(function(){B=[],I=C(),f=o("INP"),r=c(n,f,F,e.reportAllChanges)}))})},onTTFB:function(n,e){e=e||{};var u=o("TTFB"),f=c(n,u,A,e.reportAllChanges);j(function(){var a=i();if(a){var d=a.responseStart;if(d<=0||d>performance.now())return;u.value=Math.max(d-r(),0),u.entries=[a],f(!0),t(function(){u=o("TTFB",0),(f=c(n,u,A,e.reportAllChanges))(!0)})}})}};x.__VTiltExtensions__=x.__VTiltExtensions__||{},x.__VTiltExtensions__.webVitalsCallbacks=z}();
+//# sourceMappingURL=web-vitals.js.map

package/dist/web-vitals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-vitals.js","sources":["../../../../node_modules/.pnpm/web-vitals@3.5.2/node_modules/web-vitals/dist/web-vitals.js","../src/utils/globals.ts","../src/entrypoints/web-vitals.ts"],"sourcesContent":["var e,n,t,i,r,a=-1,o=function(e){addEventListener(\"pageshow\",(function(n){n.persisted&&(a=n.timeStamp,e(n))}),!0)},c=function(){return window.performance&&performance.getEntriesByType&&performance.getEntriesByType(\"navigation\")[0]},u=function(){var e=c();return e&&e.activationStart||0},f=function(e,n){var t=c(),i=\"navigate\";a>=0?i=\"back-forward-cache\":t&&(document.prerendering||u()>0?i=\"prerender\":document.wasDiscarded?i=\"restore\":t.type&&(i=t.type.replace(/_/g,\"-\")));return{name:e,value:void 0===n?-1:n,rating:\"good\",delta:0,entries:[],id:\"v3-\".concat(Date.now(),\"-\").concat(Math.floor(8999999999999*Math.random())+1e12),navigationType:i}},s=function(e,n,t){try{if(PerformanceObserver.supportedEntryTypes.includes(e)){var i=new PerformanceObserver((function(e){Promise.resolve().then((function(){n(e.getEntries())}))}));return i.observe(Object.assign({type:e,buffered:!0},t||{})),i}}catch(e){}},d=function(e,n,t,i){var r,a;return function(o){n.value>=0&&(o||i)&&((a=n.value-(r||0))||void 0===r)&&(r=n.value,n.delta=a,n.rating=function(e,n){return e>n[1]?\"poor\":e>n[0]?\"needs-improvement\":\"good\"}(n.value,t),e(n))}},l=function(e){requestAnimationFrame((function(){return requestAnimationFrame((function(){return e()}))}))},p=function(e){var n=function(n){\"pagehide\"!==n.type&&\"hidden\"!==document.visibilityState||e(n)};addEventListener(\"visibilitychange\",n,!0),addEventListener(\"pagehide\",n,!0)},v=function(e){var n=!1;return function(t){n||(e(t),n=!0)}},m=-1,h=function(){return\"hidden\"!==document.visibilityState||document.prerendering?1/0:0},g=function(e){\"hidden\"===document.visibilityState&&m>-1&&(m=\"visibilitychange\"===e.type?e.timeStamp:0,T())},y=function(){addEventListener(\"visibilitychange\",g,!0),addEventListener(\"prerenderingchange\",g,!0)},T=function(){removeEventListener(\"visibilitychange\",g,!0),removeEventListener(\"prerenderingchange\",g,!0)},E=function(){return m<0&&(m=h(),y(),o((function(){setTimeout((function(){m=h(),y()}),0)}))),{get firstHiddenTime(){return m}}},C=function(e){document.prerendering?addEventListener(\"prerenderingchange\",(function(){return e()}),!0):e()},L=[1800,3e3],w=function(e,n){n=n||{},C((function(){var t,i=E(),r=f(\"FCP\"),a=s(\"paint\",(function(e){e.forEach((function(e){\"first-contentful-paint\"===e.name&&(a.disconnect(),e.startTime<i.firstHiddenTime&&(r.value=Math.max(e.startTime-u(),0),r.entries.push(e),t(!0)))}))}));a&&(t=d(e,r,L,n.reportAllChanges),o((function(i){r=f(\"FCP\"),t=d(e,r,L,n.reportAllChanges),l((function(){r.value=performance.now()-i.timeStamp,t(!0)}))})))}))},b=[.1,.25],S=function(e,n){n=n||{},w(v((function(){var t,i=f(\"CLS\",0),r=0,a=[],c=function(e){e.forEach((function(e){if(!e.hadRecentInput){var n=a[0],t=a[a.length-1];r&&e.startTime-t.startTime<1e3&&e.startTime-n.startTime<5e3?(r+=e.value,a.push(e)):(r=e.value,a=[e])}})),r>i.value&&(i.value=r,i.entries=a,t())},u=s(\"layout-shift\",c);u&&(t=d(e,i,b,n.reportAllChanges),p((function(){c(u.takeRecords()),t(!0)})),o((function(){r=0,i=f(\"CLS\",0),t=d(e,i,b,n.reportAllChanges),l((function(){return t()}))})),setTimeout(t,0))})))},A={passive:!0,capture:!0},I=new Date,P=function(i,r){e||(e=r,n=i,t=new Date,k(removeEventListener),F())},F=function(){if(n>=0&&n<t-I){var r={entryType:\"first-input\",name:e.type,target:e.target,cancelable:e.cancelable,startTime:e.timeStamp,processingStart:e.timeStamp+n};i.forEach((function(e){e(r)})),i=[]}},M=function(e){if(e.cancelable){var n=(e.timeStamp>1e12?new Date:performance.now())-e.timeStamp;\"pointerdown\"==e.type?function(e,n){var t=function(){P(e,n),r()},i=function(){r()},r=function(){removeEventListener(\"pointerup\",t,A),removeEventListener(\"pointercancel\",i,A)};addEventListener(\"pointerup\",t,A),addEventListener(\"pointercancel\",i,A)}(n,e):P(n,e)}},k=function(e){[\"mousedown\",\"keydown\",\"touchstart\",\"pointerdown\"].forEach((function(n){return e(n,M,A)}))},D=[100,300],x=function(t,r){r=r||{},C((function(){var a,c=E(),u=f(\"FID\"),l=function(e){e.startTime<c.firstHiddenTime&&(u.value=e.processingStart-e.startTime,u.entries.push(e),a(!0))},m=function(e){e.forEach(l)},h=s(\"first-input\",m);a=d(t,u,D,r.reportAllChanges),h&&p(v((function(){m(h.takeRecords()),h.disconnect()}))),h&&o((function(){var o;u=f(\"FID\"),a=d(t,u,D,r.reportAllChanges),i=[],n=-1,e=null,k(addEventListener),o=l,i.push(o),F()}))}))},B=0,R=1/0,H=0,N=function(e){e.forEach((function(e){e.interactionId&&(R=Math.min(R,e.interactionId),H=Math.max(H,e.interactionId),B=H?(H-R)/7+1:0)}))},O=function(){return r?B:performance.interactionCount||0},q=function(){\"interactionCount\"in performance||r||(r=s(\"event\",N,{type:\"event\",buffered:!0,durationThreshold:0}))},j=[200,500],_=0,z=function(){return O()-_},G=[],J={},K=function(e){var n=G[G.length-1],t=J[e.interactionId];if(t||G.length<10||e.duration>n.latency){if(t)t.entries.push(e),t.latency=Math.max(t.latency,e.duration);else{var i={id:e.interactionId,latency:e.duration,entries:[e]};J[i.id]=i,G.push(i)}G.sort((function(e,n){return n.latency-e.latency})),G.splice(10).forEach((function(e){delete J[e.id]}))}},Q=function(e,n){n=n||{},C((function(){var t;q();var i,r=f(\"INP\"),a=function(e){e.forEach((function(e){(e.interactionId&&K(e),\"first-input\"===e.entryType)&&(!G.some((function(n){return n.entries.some((function(n){return e.duration===n.duration&&e.startTime===n.startTime}))}))&&K(e))}));var n,t=(n=Math.min(G.length-1,Math.floor(z()/50)),G[n]);t&&t.latency!==r.value&&(r.value=t.latency,r.entries=t.entries,i())},c=s(\"event\",a,{durationThreshold:null!==(t=n.durationThreshold)&&void 0!==t?t:40});i=d(e,r,j,n.reportAllChanges),c&&(\"PerformanceEventTiming\"in window&&\"interactionId\"in PerformanceEventTiming.prototype&&c.observe({type:\"first-input\",buffered:!0}),p((function(){a(c.takeRecords()),r.value<0&&z()>0&&(r.value=0,r.entries=[]),i(!0)})),o((function(){G=[],_=O(),r=f(\"INP\"),i=d(e,r,j,n.reportAllChanges)})))}))},U=[2500,4e3],V={},W=function(e,n){n=n||{},C((function(){var t,i=E(),r=f(\"LCP\"),a=function(e){var n=e[e.length-1];n&&n.startTime<i.firstHiddenTime&&(r.value=Math.max(n.startTime-u(),0),r.entries=[n],t())},c=s(\"largest-contentful-paint\",a);if(c){t=d(e,r,U,n.reportAllChanges);var m=v((function(){V[r.id]||(a(c.takeRecords()),c.disconnect(),V[r.id]=!0,t(!0))}));[\"keydown\",\"click\"].forEach((function(e){addEventListener(e,(function(){return setTimeout(m,0)}),!0)})),p(m),o((function(i){r=f(\"LCP\"),t=d(e,r,U,n.reportAllChanges),l((function(){r.value=performance.now()-i.timeStamp,V[r.id]=!0,t(!0)}))}))}}))},X=[800,1800],Y=function e(n){document.prerendering?C((function(){return e(n)})):\"complete\"!==document.readyState?addEventListener(\"load\",(function(){return e(n)}),!0):setTimeout(n,0)},Z=function(e,n){n=n||{};var t=f(\"TTFB\"),i=d(e,t,X,n.reportAllChanges);Y((function(){var r=c();if(r){var a=r.responseStart;if(a<=0||a>performance.now())return;t.value=Math.max(a-u(),0),t.entries=[r],i(!0),o((function(){t=f(\"TTFB\",0),(i=d(e,t,X,n.reportAllChanges))(!0)}))}}))};export{b as CLSThresholds,L as FCPThresholds,D as FIDThresholds,j as INPThresholds,U as LCPThresholds,X as TTFBThresholds,S as getCLS,w as getFCP,x as getFID,Q as getINP,W as getLCP,Z as getTTFB,S as onCLS,w as onFCP,x as onFID,Q as onINP,W as onLCP,Z as onTTFB};\n",null,null],"names":["r","a","o","e","addEventListener","n","persisted","timeStamp","c","window","performance","getEntriesByType","u","activationStart","f","t","i","document","prerendering","wasDiscarded","type","replace","name","value","rating","delta","entries","id","concat","Date","now","Math","floor","random","navigationType","s","PerformanceObserver","supportedEntryTypes","includes","Promise","resolve","then","getEntries","observe","Object","assign","buffered","d","l","requestAnimationFrame","p","visibilityState","v","m","h","g","T","y","removeEventListener","E","setTimeout","firstHiddenTime","C","L","w","forEach","disconnect","startTime","max","push","reportAllChanges","b","B","R","H","N","interactionId","min","O","interactionCount","q","durationThreshold","j","_","z","G","J","K","length","duration","latency","sort","splice","U","V","X","Y","readyState","win","undefined","global","globalThis","navigator","location","fetch","XMLHttpRequest","AbortController","userAgent","assignableWindow","vtiltWebVitalsCallbacks","takeRecords","hadRecentInput","onFCP","entryType","some","PerformanceEventTiming","prototype","onTTFB","responseStart","__VTiltExtensions__","webVitalsCallbacks"],"mappings":"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","x_google_ignoreList":[0]}

package/lib/config.js

@@ -39,9 +39,11 @@ class ConfigManager {
             script.getAttribute("data-storage") || initialConfig.storage;
         config.stringifyPayload =
             script.getAttribute("data-stringify-payload") !== "false";
-        config.capture_performance =
-            script.getAttribute("data-capture-performance") === "true" ||
-                initialConfig.capture_performance;
+        // Handle capture_performance: data attribute is boolean, initialConfig can be boolean or object
+        const dataAttrPerformance = script.getAttribute("data-capture-performance") === "true";
+        config.capture_performance = dataAttrPerformance
+            ? true
+            : initialConfig.capture_performance;
         // Check for conflicting proxy configurations
         if (config.proxy && config.proxyUrl) {
             console.error("Error: Both data-proxy and data-proxy-url are specified. Please use only one of them.");

package/lib/entrypoints/all-external-dependencies.d.ts

@@ -0,0 +1,8 @@
+/**
+ * All External Dependencies
+ *
+ * This file imports all external dependency entrypoints.
+ * Used by array.full.ts for the full bundle that includes everything.
+ */
+import "./recorder";
+import "./web-vitals";

package/lib/entrypoints/all-external-dependencies.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * All External Dependencies
+ *
+ * This file imports all external dependency entrypoints.
+ * Used by array.full.ts for the full bundle that includes everything.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+require("./recorder");
+require("./web-vitals");

package/lib/entrypoints/array.full.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Full Bundle Entrypoint
+ *
+ * Same as array.ts but includes all external dependencies bundled in.
+ * This is useful for users who want a single script tag without lazy loading.
+ *
+ * Usage:
+ *   <script src="https://cdn.example.com/dist/array.full.js"></script>
+ *
+ * This bundle includes:
+ * - Core SDK (array.no-external.ts)
+ * - External scripts loader
+ * - Session recording (rrweb)
+ * - Web Vitals tracking
+ */
+import "./all-external-dependencies";
+import "./array";

package/lib/entrypoints/array.full.js

@@ -0,0 +1,19 @@
+"use strict";
+/**
+ * Full Bundle Entrypoint
+ *
+ * Same as array.ts but includes all external dependencies bundled in.
+ * This is useful for users who want a single script tag without lazy loading.
+ *
+ * Usage:
+ *   <script src="https://cdn.example.com/dist/array.full.js"></script>
+ *
+ * This bundle includes:
+ * - Core SDK (array.no-external.ts)
+ * - External scripts loader
+ * - Session recording (rrweb)
+ * - Web Vitals tracking
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+require("./all-external-dependencies");
+require("./array");

package/lib/entrypoints/external-scripts-loader.js

@@ -72,7 +72,7 @@ exports.loadScript = loadScript;
 /**
  * SDK version - used for loading correct script version from CDN
  */
-const SDK_VERSION = "1.1.5";
+const SDK_VERSION = "1.3.0";
 /**
  * Get the URL for an extension script
  *

package/lib/entrypoints/web-vitals.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Web Vitals Extension Entrypoint
+ *
+ * This file imports the web-vitals library and registers its callbacks
+ * on the global __VTiltExtensions__ object. The main SDK checks for these
+ * callbacks and uses them if available.
+ *
+ * Usage:
+ * - Include this entrypoint in the full bundle (array.full.ts)
+ * - Or load it dynamically via loadExternalDependency('web-vitals', callback)
+ */
+import { WebVitalsCallbacks } from "../utils/globals";
+declare const vtiltWebVitalsCallbacks: WebVitalsCallbacks;
+export default vtiltWebVitalsCallbacks;

package/lib/entrypoints/web-vitals.js

@@ -0,0 +1,29 @@
+"use strict";
+/**
+ * Web Vitals Extension Entrypoint
+ *
+ * This file imports the web-vitals library and registers its callbacks
+ * on the global __VTiltExtensions__ object. The main SDK checks for these
+ * callbacks and uses them if available.
+ *
+ * Usage:
+ * - Include this entrypoint in the full bundle (array.full.ts)
+ * - Or load it dynamically via loadExternalDependency('web-vitals', callback)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const web_vitals_1 = require("web-vitals");
+const globals_1 = require("../utils/globals");
+const vtiltWebVitalsCallbacks = {
+    onLCP: web_vitals_1.onLCP,
+    onCLS: web_vitals_1.onCLS,
+    onFCP: web_vitals_1.onFCP,
+    onINP: web_vitals_1.onINP,
+    onTTFB: web_vitals_1.onTTFB,
+};
+// Initialize extensions object if not exists
+globals_1.assignableWindow.__VTiltExtensions__ =
+    globals_1.assignableWindow.__VTiltExtensions__ || {};
+// Register web vitals callbacks
+globals_1.assignableWindow.__VTiltExtensions__.webVitalsCallbacks =
+    vtiltWebVitalsCallbacks;
+exports.default = vtiltWebVitalsCallbacks;

package/lib/types.d.ts

@@ -51,8 +51,11 @@ export interface VTiltConfig {
     person_profiles?: PersonProfilesMode;
     /** Enable autocapture */
     autocapture?: boolean;
-    /** Enable web vitals tracking */
-    capture_performance?: boolean;
+    /**
+     * Enable web vitals tracking.
+     * Can be a boolean or an object with detailed configuration.
+     */
+    capture_performance?: boolean | CapturePerformanceConfig;
     /** Enable page view tracking */
     capture_pageview?: boolean | "auto";
     /** Enable page leave tracking */
@@ -160,6 +163,29 @@ export interface AliasEvent {
     distinct_id: string;
     original: string;
 }
+/** Supported Web Vitals metrics */
+export type SupportedWebVitalsMetric = "LCP" | "CLS" | "FCP" | "INP" | "TTFB";
+/** All supported Web Vitals metrics */
+export declare const ALL_WEB_VITALS_METRICS: SupportedWebVitalsMetric[];
+/** Default Web Vitals metrics (matches PostHog defaults) */
+export declare const DEFAULT_WEB_VITALS_METRICS: SupportedWebVitalsMetric[];
+/**
+ * Web Vitals capture configuration
+ */
+export interface CapturePerformanceConfig {
+    /** Enable or disable web vitals capture */
+    web_vitals?: boolean;
+    /** Which metrics to capture (default: LCP, CLS, FCP, INP) */
+    web_vitals_allowed_metrics?: SupportedWebVitalsMetric[];
+    /** Delay before flushing metrics in ms (default: 5000) */
+    web_vitals_delayed_flush_ms?: number;
+    /**
+     * Maximum allowed metric value in ms (default: 900000 = 15 minutes)
+     * Values above this are considered anomalies and ignored.
+     * Set to 0 to disable this check.
+     */
+    __web_vitals_max_value?: number;
+}
 export interface WebVitalMetric {
     name: string;
     value: number;
@@ -167,6 +193,10 @@ export interface WebVitalMetric {
     rating: "good" | "needs-improvement" | "poor";
     id: string;
     navigationType: string;
+    /** Timestamp when the metric was captured (added internally) */
+    timestamp?: number;
+    /** Attribution data from web-vitals library */
+    attribution?: Record<string, unknown>;
 }
 export interface GeolocationData {
     country?: string;

package/lib/types.js

@@ -6,3 +6,19 @@
  * Following PostHog's patterns where applicable.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_WEB_VITALS_METRICS = exports.ALL_WEB_VITALS_METRICS = void 0;
+/** All supported Web Vitals metrics */
+exports.ALL_WEB_VITALS_METRICS = [
+    "LCP",
+    "CLS",
+    "FCP",
+    "INP",
+    "TTFB",
+];
+/** Default Web Vitals metrics (matches PostHog defaults) */
+exports.DEFAULT_WEB_VITALS_METRICS = [
+    "LCP",
+    "CLS",
+    "FCP",
+    "INP",
+];

package/lib/utils/globals.d.ts

@@ -17,6 +17,31 @@ export interface LazyLoadedSessionRecordingInterface {
     log: (message: string, level: "log" | "warn" | "error") => void;
     updateConfig: (config: any) => void;
 }
+/**
+ * Web Vitals metric callback type
+ */
+export type WebVitalsMetricCallback = (metric: any) => void;
+/**
+ * Options for web vitals callbacks
+ */
+export interface WebVitalsCallbackOptions {
+    /** Report all changes (useful for CLS which updates over time) */
+    reportAllChanges?: boolean;
+}
+/**
+ * Web Vitals callback function type (with optional options)
+ */
+export type WebVitalsCallbackFn = (callback: WebVitalsMetricCallback, options?: WebVitalsCallbackOptions) => void;
+/**
+ * Web Vitals callbacks interface (set by web-vitals.ts entrypoint)
+ */
+export interface WebVitalsCallbacks {
+    onLCP: WebVitalsCallbackFn;
+    onCLS: WebVitalsCallbackFn;
+    onFCP: WebVitalsCallbackFn;
+    onINP: WebVitalsCallbackFn;
+    onTTFB?: WebVitalsCallbackFn;
+}
 /**
  * VTilt Extensions interface for dynamically loaded modules
  * This is the contract between lazily loaded extensions and the SDK
@@ -37,6 +62,8 @@ export interface VTiltExtensions {
     };
     /** Factory to create LazyLoadedSessionRecording (set by recorder.ts) */
     initSessionRecording?: (instance: any, config?: any) => LazyLoadedSessionRecordingInterface;
+    /** Web Vitals callbacks (set by web-vitals.ts entrypoint) */
+    webVitalsCallbacks?: WebVitalsCallbacks;
 }
 export type AssignableWindow = Window & typeof globalThis & {
     /** Main VTilt instance */

package/lib/web-vitals.d.ts

@@ -1,11 +1,95 @@
-import { VTiltConfig } from "./types";
+import { VTiltConfig, SupportedWebVitalsMetric } from "./types";
 import { VTilt } from "./vtilt";
+/**
+ * Web Vitals Manager
+ *
+ * Captures Core Web Vitals (LCP, CLS, FCP, INP, TTFB) and sends them
+ * as batched $web_vitals events. Follows PostHog's approach with:
+ *
+ * 1. Extension pattern - checks for callbacks registered on __VTiltExtensions__
+ * 2. Lazy loading - loads web-vitals.js on demand if not bundled
+ * 3. Configurable metrics - choose which metrics to capture
+ * 4. Smart buffering - collects metrics per page, flushes on navigation or timeout
+ * 5. Session context - includes session_id and window_id for correlation
+ *
+ * Event structure:
+ * - event: "$web_vitals"
+ * - properties:
+ *   - $web_vitals_LCP_value: number
+ *   - $web_vitals_LCP_event: { name, value, delta, rating, ... }
+ *   - $pathname: string
+ *   - $current_url: string
+ */
 export declare class WebVitalsManager {
     private instance;
-    private webVitals;
-    constructor(config: VTiltConfig, instance: VTilt);
+    private buffer;
+    private flushTimer;
+    private initialized;
+    private config;
+    constructor(vtiltConfig: VTiltConfig, instance: VTilt);
     /**
-     * Initialize web vitals tracking
+     * Parse capture_performance config (boolean or object)
      */
-    private initializeWebVitals;
+    private parseConfig;
+    /**
+     * Check if web vitals capture is enabled
+     */
+    get isEnabled(): boolean;
+    /**
+     * Get the list of metrics to capture
+     */
+    get allowedMetrics(): SupportedWebVitalsMetric[];
+    /**
+     * Get flush timeout in ms
+     */
+    get flushTimeoutMs(): number;
+    /**
+     * Get maximum allowed metric value
+     */
+    get maxAllowedValue(): number;
+    private createEmptyBuffer;
+    /**
+     * Check if web vitals callbacks are available
+     */
+    private getWebVitalsCallbacks;
+    /**
+     * Start capturing if enabled and callbacks are available
+     */
+    startIfEnabled(): void;
+    /**
+     * Lazy load web-vitals extension
+     */
+    private loadWebVitals;
+    /**
+     * Start capturing web vitals using the provided callbacks
+     */
+    private startCapturing;
+    /**
+     * Get current URL
+     */
+    private getCurrentUrl;
+    /**
+     * Get current pathname
+     */
+    private getCurrentPathname;
+    /**
+     * Add a metric to the buffer
+     */
+    private addToBuffer;
+    /**
+     * Clean attribution data by removing large elements
+     */
+    private cleanAttribution;
+    /**
+     * Get window ID from instance
+     */
+    private getWindowId;
+    /**
+     * Schedule a delayed flush
+     */
+    private scheduleFlush;
+    /**
+     * Flush buffered metrics as a single event
+     */
+    private flush;
 }