analytica.click 0.0.655 → 0.0.657

package/dist/helpers/environment.d.ts

@@ -1,3 +1,4 @@
 import type { IAnalyticaConfig } from '../types';
-export declare const isLocalhost: () => boolean;
-export declare const shouldIgnoreLocalhost: ({ devMode, ignoreLocalhost, }: Pick<IAnalyticaConfig, 'devMode' | 'ignoreLocalhost'>) => boolean;
+type TelemetryEnvironmentConfig = Pick<IAnalyticaConfig, 'devMode' | 'ignoreLocalhost' | 'overrideBaseUrl'>;
+export declare const shouldIgnoreLocalhost: ({ devMode, ignoreLocalhost, overrideBaseUrl }: TelemetryEnvironmentConfig, sourceUrl?: string) => boolean;
+export {};

package/dist/helpers/errorTrack.js

@@ -1 +1 @@
-"use strict";var h=Object.defineProperty;var M=Object.getOwnPropertyDescriptor;var x=Object.getOwnPropertyNames;var v=Object.prototype.hasOwnProperty;var z=(r,e)=>{for(var t in e)h(r,t,{get:e[t],enumerable:!0})},j=(r,e,t,o)=>{if(e&&typeof e=="object"||typeof e=="function")for(let s of x(e))!v.call(r,s)&&s!==t&&h(r,s,{get:()=>e[s],enumerable:!(o=M(e,s))||o.enumerable});return r};var V=r=>j(h({},"__esModule",{value:!0}),r);var lr={};z(lr,{createErrorOccurrence:()=>$,errorTrack:()=>ur,mergeErrorPayload:()=>S,serializeErrorArguments:()=>fr});module.exports=V(lr);var Er=require("cross-fetch/polyfill"),a=require("ag-common/dist/common/helpers/log"),D=require("ag-common/dist/common/helpers/string/contains");var W="localhost",I=()=>typeof window<"u"&&window.location.hostname===W,B=({devMode:r,ignoreLocalhost:e})=>I()&&(e===!0||r!==!0);var A=require("ag-common/dist/common/helpers/hashCode"),T=require("ag-common/dist/common/helpers/log"),w=require("ag-common/dist/common/helpers/object"),_=r=>{try{let e=/^\[?[0-9]{1,2}:[0-9]{1,2}:[0-9]{1,2}\]?$/gim,t=/(at \S+?) \(\S+\)\s/gim,o=/^((%[cs])+\s*)+$/gim,s=/^color:/gim,c;(0,w.isJson)(r.message)?c=JSON.parse(r.message):c=[r.message];let f=c.findIndex(n=>n.match(o)),u=c.findIndex(n=>n.match(s));f>=0&&u>=0&&u===f+1&&(c=c.filter((n,E)=>![f,u].includes(E)));let m=c.map(n=>n.includes(".js:")||n.includes("node_modules")?n.replace(t,"$1 (stacktrace)"):n.replace(e,"[date]")),l=JSON.stringify([r.name??"",...m]),g=(0,A.hashCode)(l).toString();return(0,T.debug)("got errorKey=",l,g),g}catch{return(0,A.hashCode)(`${r.name??""}:${r.message}`).toString()}};var P="https://analytica.click/api",Y="/site/errors",Z=10,k=100,q=500,G=1e3,Q=429,X=500,rr="unknown",L="[Unserializable]",d=new Map,i,b,er=["will be removed","performing full reload","tracking error","fetch RSC payload","perform a full reload","warnings#debug_enabled",'"digest"',"punycode"],$=()=>({occurrenceId:ar(),occurredAt:Date.now()}),S=(r,e)=>{if(r&&(r.data.occurrenceId!==e.data.occurrenceId||r.data.occurredAt!==e.data.occurredAt))return e;let t=(r?.data.occurrences??0)+(e.data.occurrences??1);return{...e,data:{...e.data,occurrenceId:r?.data.occurrenceId??e.data.occurrenceId,occurredAt:r?.data.occurredAt??e.data.occurredAt,occurrences:t}}},or=r=>r===Q||r>=X,tr=async()=>{let r=nr();if(!r)return{retryable:!1};try{let e=r.errors.map(({error:o})=>o);if(r.overload){let o=e[0];o&&e.splice(0,1,{...o,data:{...o.data,message:`error overload!: ${o.data.message||"?"}`}})}let t=await fetch(`${r.scope.overrideBaseUrl}${Y}`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(e)});if(!t.ok){let o=or(t.status);return o?N(r):r.scope.errors.length===0&&d.delete(r.scopeKey),{error:`HTTP error! status: ${t.status}`,retryable:o}}r.scope.errors.length===0&&d.delete(r.scopeKey)}catch(e){return N(r),{error:e instanceof Error?e.message:String(e),retryable:!0}}finally{K()?H(G):i=void 0}return{retryable:!1}},nr=()=>{let r=C(),e=r>k?1:Z;for(let[t,o]of d.entries()){if(o.errors.length===0)continue;let s=o.errors.splice(0,e);return{scopeKey:t,scope:o,errors:s,overload:r>k}}},N=r=>{r.scope.errors.unshift(...r.errors)},C=()=>{let r=0;for(let e of d.values())r+=e.errors.length;return r},K=()=>C()>0,H=r=>{i===void 0&&(i=setTimeout(()=>{i=void 0,F()},r))},U=()=>{i!==void 0&&(clearTimeout(i),i=void 0)},F=()=>(b??=tr().finally(()=>{b=void 0}),b),sr=async()=>{U();let r;for(;K();){let e=await F();if(e.error&&(r??=e.error,e.retryable))return{error:r};U()}return r===void 0?{}:{error:r}},cr=({apiKey:r,overrideBaseUrl:e,browserFingerprint:t})=>{let o=JSON.stringify([r,e,t??null]),s=d.get(o);return s||(s={overrideBaseUrl:e,errors:[]},d.set(o,s)),{scopeKey:o,scope:s}},ar=()=>typeof globalThis.crypto?.randomUUID=="function"?globalThis.crypto.randomUUID():`${Date.now()}-${Math.random().toString(36).slice(2)}`,ir=(r,e)=>{let t=$();return{...r,data:{...r.data,browserFingerprint:r.data.browserFingerprint??e,occurrenceId:r.data.occurrenceId??t.occurrenceId,occurredAt:r.data.occurredAt??t.occurredAt}}},ur=async({data:r,overrideBaseUrl:e=P,ignoreBrowserErrors:t,devMode:o,ignoreLocalhost:s,valueOverrides:c,flushImmediately:f=!1})=>{let u=e||P,m=u.startsWith("/")&&typeof window>"u"?P:u,l=[...er,...t??[]];if(l.length>0){let p=(0,D.containsInsensitive)(r.data.message,...l);if(p){(0,a.debug)("ignoring error, contains=",p);return}}let g=I();if(g&&B({devMode:o,ignoreLocalhost:s}))return(0,a.debug)(`local error tracking ignored:${r.data.message} ${JSON.stringify(r)}, to ${m}`),{};if(g&&(0,a.debug)("allowing local error tracking due to devmode=true"),!dr(r.data.message))return{};(0,a.debug)("error track",r.data.message,JSON.stringify(r));let n=ir(r,r.data.browserFingerprint??c?.browserFingerprint),E=n.data.browserFingerprint,J=_({...n.data,name:n.data.name??rr}),{scope:O}=cr({apiKey:n.key,overrideBaseUrl:m,browserFingerprint:E}),R=JSON.stringify([J,n.data.occurrenceId,n.data.occurredAt]),y=O.errors.find(p=>p.key===R);return y?y.error=S(y.error,n):O.errors.push({key:R,error:S(void 0,n)}),f?sr():(H(q),{})};function dr(r){return r?r.match(/^"?[0-9]{1,2}:[0-9]{1,2}:[0-9]{1,2}"?$/)?((0,a.info)("ignoring react devtools message"),!1):r===JSON.stringify([{}])?((0,a.info)("empty message payload?"),!1):!0:((0,a.info)("no message?"),!1)}var fr=r=>{let e=new WeakSet;try{return JSON.stringify(r,(t,o)=>{if(typeof o=="bigint")return o.toString();if(o instanceof Error)return{name:o.name,message:o.message,stack:o.stack};if(typeof o=="object"&&o!==null){if(e.has(o))return"[Circular]";e.add(o)}return o})??L}catch{return L}};0&&(module.exports={createErrorOccurrence,errorTrack,mergeErrorPayload,serializeErrorArguments});
+"use strict";var h=Object.defineProperty;var v=Object.getOwnPropertyDescriptor;var J=Object.getOwnPropertyNames;var V=Object.prototype.hasOwnProperty;var z=(r,e)=>{for(var t in e)h(r,t,{get:e[t],enumerable:!0})},x=(r,e,t,o)=>{if(e&&typeof e=="object"||typeof e=="function")for(let n of J(e))!V.call(r,n)&&n!==t&&h(r,n,{get:()=>e[n],enumerable:!(o=v(e,n))||o.enumerable});return r};var W=r=>x(h({},"__esModule",{value:!0}),r);var Er={};z(Er,{createErrorOccurrence:()=>K,errorTrack:()=>lr,mergeErrorPayload:()=>S,serializeErrorArguments:()=>mr});module.exports=W(Er);var Ar=require("cross-fetch/polyfill"),d=require("ag-common/dist/common/helpers/log"),C=require("ag-common/dist/common/helpers/string/contains");var w="localhost",j=/^127(?:\.\d{1,3}){3}$/,Y=new Set([w,"0.0.0.0","[::1]","::1"]),Z=new Set(["development","test"]),q=r=>{let e=r.toLowerCase().replace(/\.$/,"");return Y.has(e)||e.endsWith(`.${w}`)||j.test(e)},A=r=>{if(!r)return!1;try{let e=new URL(r);return q(e.hostname)}catch{return!1}},R=({devMode:r,ignoreLocalhost:e,overrideBaseUrl:t},o)=>{let n=typeof window<"u",s=n&&A(window.location.href),i=typeof process<"u"&&process.env.NODE_ENV!==void 0&&Z.has(process.env.NODE_ENV);if(!(s||i||A(o)||!n&&r===!0))return!1;let g=A(t);return e===!0||r!==!0||!g};var I=require("ag-common/dist/common/helpers/hashCode"),T=require("ag-common/dist/common/helpers/log"),B=require("ag-common/dist/common/helpers/object"),_=r=>{try{let e=/^\[?[0-9]{1,2}:[0-9]{1,2}:[0-9]{1,2}\]?$/gim,t=/(at \S+?) \(\S+\)\s/gim,o=/^((%[cs])+\s*)+$/gim,n=/^color:/gim,s;(0,B.isJson)(r.message)?s=JSON.parse(r.message):s=[r.message];let i=s.findIndex(a=>a.match(o)),u=s.findIndex(a=>a.match(n));i>=0&&u>=0&&u===i+1&&(s=s.filter((a,p)=>![i,u].includes(p)));let g=s.map(a=>a.includes(".js:")||a.includes("node_modules")?a.replace(t,"$1 (stacktrace)"):a.replace(e,"[date]")),m=JSON.stringify([r.name??"",...g]),c=(0,I.hashCode)(m).toString();return(0,T.debug)("got errorKey=",m,c),c}catch{return(0,I.hashCode)(`${r.name??""}:${r.message}`).toString()}};var L="https://analytica.click/api",G="/site/errors",Q=10,N=100,X=500,rr=1e3,er=429,or=500,tr="unknown",k="[Unserializable]",l=new Map,f,O,nr=["will be removed","performing full reload","tracking error","fetch RSC payload","perform a full reload","warnings#debug_enabled",'"digest"',"punycode"],K=()=>({occurrenceId:dr(),occurredAt:Date.now()}),S=(r,e)=>{if(r&&(r.data.occurrenceId!==e.data.occurrenceId||r.data.occurredAt!==e.data.occurredAt))return e;let t=(r?.data.occurrences??0)+(e.data.occurrences??1);return{...e,data:{...e.data,occurrenceId:r?.data.occurrenceId??e.data.occurrenceId,occurredAt:r?.data.occurredAt??e.data.occurredAt,occurrences:t}}},sr=r=>r===er||r>=or,cr=async()=>{let r=ar();if(!r)return{retryable:!1};try{let e=r.errors.map(({error:o})=>o);if(r.overload){let o=e[0];o&&e.splice(0,1,{...o,data:{...o.data,message:`error overload!: ${o.data.message||"?"}`}})}let t=await fetch(`${r.scope.overrideBaseUrl}${G}`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(e)});if(!t.ok){let o=sr(t.status);return o?D(r):r.scope.errors.length===0&&l.delete(r.scopeKey),{error:`HTTP error! status: ${t.status}`,retryable:o}}r.scope.errors.length===0&&l.delete(r.scopeKey)}catch(e){return D(r),{error:e instanceof Error?e.message:String(e),retryable:!0}}finally{H()?M(rr):f=void 0}return{retryable:!1}},ar=()=>{let r=$(),e=r>N?1:Q;for(let[t,o]of l.entries()){if(o.errors.length===0)continue;let n=o.errors.splice(0,e);return{scopeKey:t,scope:o,errors:n,overload:r>N}}},D=r=>{r.scope.errors.unshift(...r.errors)},$=()=>{let r=0;for(let e of l.values())r+=e.errors.length;return r},H=()=>$()>0,M=r=>{f===void 0&&(f=setTimeout(()=>{f=void 0,F()},r))},U=()=>{f!==void 0&&(clearTimeout(f),f=void 0)},F=()=>(O??=cr().finally(()=>{O=void 0}),O),ir=async()=>{U();let r;for(;H();){let e=await F();if(e.error&&(r??=e.error,e.retryable))return{error:r};U()}return r===void 0?{}:{error:r}},ur=({apiKey:r,overrideBaseUrl:e,browserFingerprint:t})=>{let o=JSON.stringify([r,e,t??null]),n=l.get(o);return n||(n={overrideBaseUrl:e,errors:[]},l.set(o,n)),{scopeKey:o,scope:n}},dr=()=>typeof globalThis.crypto?.randomUUID=="function"?globalThis.crypto.randomUUID():`${Date.now()}-${Math.random().toString(36).slice(2)}`,fr=(r,e)=>{let t=K();return{...r,data:{...r.data,browserFingerprint:r.data.browserFingerprint??e,occurrenceId:r.data.occurrenceId??t.occurrenceId,occurredAt:r.data.occurredAt??t.occurredAt}}},lr=async({data:r,overrideBaseUrl:e=L,ignoreBrowserErrors:t,devMode:o,ignoreLocalhost:n,valueOverrides:s,flushImmediately:i=!1})=>{let u=e||L;if(u.startsWith("/")&&typeof window>"u")return{};let g=u,m=[...nr,...t??[]];if(m.length>0){let E=(0,C.containsInsensitive)(r.data.message,...m);if(E){(0,d.debug)("ignoring error, contains=",E);return}}if(R({devMode:o,ignoreLocalhost:n,overrideBaseUrl:e},r.data.href))return{};if(!gr(r.data.message))return{};(0,d.debug)("error track",r.data.message,JSON.stringify(r));let c=fr(r,r.data.browserFingerprint??s?.browserFingerprint),a=c.data.browserFingerprint,p=_({...c.data,name:c.data.name??tr}),{scope:P}=ur({apiKey:c.key,overrideBaseUrl:g,browserFingerprint:a}),b=JSON.stringify([p,c.data.occurrenceId,c.data.occurredAt]),y=P.errors.find(E=>E.key===b);return y?y.error=S(y.error,c):P.errors.push({key:b,error:S(void 0,c)}),i?ir():(M(X),{})};function gr(r){return r?r.match(/^"?[0-9]{1,2}:[0-9]{1,2}:[0-9]{1,2}"?$/)?((0,d.info)("ignoring react devtools message"),!1):r===JSON.stringify([{}])?((0,d.info)("empty message payload?"),!1):!0:((0,d.info)("no message?"),!1)}var mr=r=>{let e=new WeakSet;try{return JSON.stringify(r,(t,o)=>{if(typeof o=="bigint")return o.toString();if(o instanceof Error)return{name:o.name,message:o.message,stack:o.stack};if(typeof o=="object"&&o!==null){if(e.has(o))return"[Circular]";e.add(o)}return o})??k}catch{return k}};0&&(module.exports={createErrorOccurrence,errorTrack,mergeErrorPayload,serializeErrorArguments});

package/dist/helpers/performance.d.ts

@@ -1,7 +1,7 @@
 import { type PerformanceMetricName } from '../performance';
 import type { IAnalyticaConfig, IPerformanceMetricsData } from '../types';
 export declare const PERFORMANCE_METRICS_TIMEOUT_MS = 10000;
-export declare const TIMED_OUT_PERFORMANCE_METRIC_VALUE = -1;
+export declare const PERFORMANCE_METRICS_INP_WAIT_MS = 500;
 interface PerformanceMetricsTimer {
     set: (callback: () => void, delay: number) => number;
     clear: (timer: number) => void;

package/dist/helpers/server.d.ts

@@ -6,5 +6,5 @@ export declare const event: TEvent;
 export declare const page: TPage;
 /** used for tracking custom metrics */
 export declare const metric: TMetric;
-/** used by the browser collector to send one page-performance batch */
+/** used by the browser collector to send page-performance observations */
 export declare const performanceMetrics: TPerformanceMetrics;

package/dist/helpers/server.js

@@ -1 +1 @@
-"use strict";var y=Object.defineProperty;var T=Object.getOwnPropertyDescriptor;var u=Object.getOwnPropertyNames;var w=Object.prototype.hasOwnProperty;var h=(e,r)=>{for(var a in r)y(e,a,{get:r[a],enumerable:!0})},M=(e,r,a,s)=>{if(r&&typeof r=="object"||typeof r=="function")for(let c of u(r))!w.call(e,c)&&c!==a&&y(e,c,{get:()=>r[c],enumerable:!(s=T(r,c))||s.enumerable});return e};var P=e=>M(y({},"__esModule",{value:!0}),e);var O={};h(O,{event:()=>L,metric:()=>S,page:()=>N,performanceMetrics:()=>I});module.exports=P(O);var b=require("cross-fetch/polyfill"),i=require("ag-common/dist/common/helpers/log");var p={CLS:"CLS",FCP:"FCP",INP:"INP",LCP:"LCP",TTFB:"TTFB",TTI:"TTI"},k=[p.CLS,p.FCP,p.INP,p.LCP,p.TTFB,p.TTI],m=e=>k.some(r=>r===e);var v="localhost",E=()=>typeof window<"u"&&window.location.hostname===v,d=({devMode:e,ignoreLocalhost:r})=>E()&&(r===!0||e!==!0);var l="https://analytica.click/api",C="health",L=async e=>{let{analyticaToken:r,overrideBaseUrl:a=l,eventName:s,devMode:c,ignoreLocalhost:f,valueOverrides:n}=e;if(d({devMode:c,ignoreLocalhost:f}))return(0,i.debug)(`local page ignored: ${JSON.stringify(e)}, to ${a}`),{};let o={eventName:s,browserFingerprint:n?.browserFingerprint,pageLocation:""};typeof window<"u"&&(o={...o,pageLocation:window.location.href,browserResolution:`${window.screen.width}:${window.screen.height}`}),typeof navigator<"u"&&(o={...o,browser:navigator.userAgent});try{let t=await fetch(`${a}/site/event`,{method:"POST",headers:{"Content-Type":"application/json",authorization:""},body:JSON.stringify({key:r,data:o})});if(!t.ok){let g=await t.text();return(0,i.warn)("tracking error:"+g),{error:g}}}catch(t){let g=t instanceof Error?t.message:"Unknown error";return(0,i.warn)("tracking error:"+g),{error:g}}return{}},N=async e=>{let{analyticaToken:r,overrideBaseUrl:a=l,devMode:s,ignoreLocalhost:c,valueOverrides:f}=e;if(d({devMode:s,ignoreLocalhost:c}))return(0,i.debug)(`local page ignored: ${JSON.stringify(e)}, to ${a}`),{};let n={pageLocation:"",browserFingerprint:f?.browserFingerprint};if(typeof window<"u"&&(n={...n,pageLocation:window.location.href,browserResolution:`${window.screen.width}:${window.screen.height}`}),typeof document<"u"&&(n={...n,pageReferrer:document.referrer,pageTitle:document.title}),typeof navigator<"u"&&(n={...n,browserLanguage:navigator.language,browser:navigator.userAgent}),!n.pageLocation)return(0,i.warn)("no pageLocation"),{};try{let o=await fetch(`${a}/site/tracking`,{method:"POST",headers:{"Content-Type":"application/json",authorization:""},body:JSON.stringify({key:r,data:n})});if(!o.ok){let t=await o.text();return(0,i.warn)("tracking error:"+t),{error:t}}}catch(o){let t=o instanceof Error?o.message:"Unknown error";return(0,i.warn)("tracking error:"+t),{error:t}}return{}},S=async e=>{let{analyticaToken:r,overrideBaseUrl:a=l,type:s,value:c,devMode:f,ignoreLocalhost:n}=e;if(d({devMode:f,ignoreLocalhost:n}))return(0,i.debug)(`local metric ignored: ${JSON.stringify(e)}, to ${a}`),{};if(s===C||m(s)){let t=`Type "${s}" is reserved for system metrics`;return(0,i.warn)(t),{error:t}}let o={type:s,value:c};try{let t=await fetch(`${a}/site/metric`,{method:"POST",headers:{"Content-Type":"application/json",authorization:""},body:JSON.stringify({key:r,data:o})});if(!t.ok){let g=await t.text();return(0,i.warn)("metric tracking error:"+g),{error:g}}}catch(t){let g=t instanceof Error?t.message:"Unknown error";return(0,i.warn)("metric tracking error:"+g),{error:g}}return{}},I=async e=>{let{analyticaToken:r,overrideBaseUrl:a=l,data:s,devMode:c,ignoreLocalhost:f}=e;if(d({devMode:c,ignoreLocalhost:f}))return(0,i.debug)(`local performance metrics ignored: ${JSON.stringify(s)}, to ${a}`),{};try{let n=await fetch(`${a}/site/metrics`,{method:"POST",headers:{"Content-Type":"text/plain;charset=UTF-8"},credentials:"omit",body:JSON.stringify({key:r,data:s}),keepalive:!0});if(!n.ok){let o=await n.text();return(0,i.warn)("performance metric tracking error:"+o),{error:o}}}catch(n){let o=n instanceof Error?n.message:"Unknown error";return(0,i.warn)("performance metric tracking error:"+o),{error:o}}return{}};0&&(module.exports={event,metric,page,performanceMetrics});
+"use strict";var m=Object.defineProperty;var w=Object.getOwnPropertyDescriptor;var h=Object.getOwnPropertyNames;var E=Object.prototype.hasOwnProperty;var P=(e,r)=>{for(var t in r)m(e,t,{get:r[t],enumerable:!0})},v=(e,r,t,i)=>{if(r&&typeof r=="object"||typeof r=="function")for(let s of h(r))!E.call(e,s)&&s!==t&&m(e,s,{get:()=>r[s],enumerable:!(i=w(r,s))||i.enumerable});return e};var M=e=>v(m({},"__esModule",{value:!0}),e);var b={};P(b,{event:()=>I,metric:()=>R,page:()=>A,performanceMetrics:()=>$});module.exports=M(b);var U=require("cross-fetch/polyfill"),c=require("ag-common/dist/common/helpers/log");var d={CLS:"CLS",FCP:"FCP",INP:"INP",LCP:"LCP",TTFB:"TTFB",TTI:"TTI"},L=[d.CLS,d.FCP,d.INP,d.LCP,d.TTFB,d.TTI],T=e=>L.some(r=>r===e);var u="localhost",C=/^127(?:\.\d{1,3}){3}$/,N=new Set([u,"0.0.0.0","[::1]","::1"]),k=new Set(["development","test"]),O=e=>{let r=e.toLowerCase().replace(/\.$/,"");return N.has(r)||r.endsWith(`.${u}`)||C.test(r)},y=e=>{if(!e)return!1;try{let r=new URL(e);return O(r.hostname)}catch{return!1}},p=({devMode:e,ignoreLocalhost:r,overrideBaseUrl:t},i)=>{let s=typeof window<"u",g=s&&y(window.location.href),n=typeof process<"u"&&process.env.NODE_ENV!==void 0&&k.has(process.env.NODE_ENV);if(!(g||n||y(i)||!s&&e===!0))return!1;let o=y(t);return r===!0||e!==!0||!o};var l="https://analytica.click/api",S="health",I=async e=>{let{analyticaToken:r,overrideBaseUrl:t=l,eventName:i,devMode:s,ignoreLocalhost:g,valueOverrides:n}=e;if(p({devMode:s,ignoreLocalhost:g,overrideBaseUrl:t}))return(0,c.debug)(`local page ignored: ${JSON.stringify(e)}, to ${t}`),{};let a={eventName:i,browserFingerprint:n?.browserFingerprint,pageLocation:""};typeof window<"u"&&(a={...a,pageLocation:window.location.href,browserResolution:`${window.screen.width}:${window.screen.height}`}),typeof navigator<"u"&&(a={...a,browser:navigator.userAgent});try{let o=await fetch(`${t}/site/event`,{method:"POST",headers:{"Content-Type":"application/json",authorization:""},body:JSON.stringify({key:r,data:a})});if(!o.ok){let f=await o.text();return(0,c.warn)("tracking error:"+f),{error:f}}}catch(o){let f=o instanceof Error?o.message:"Unknown error";return(0,c.warn)("tracking error:"+f),{error:f}}return{}},A=async e=>{let{analyticaToken:r,overrideBaseUrl:t=l,devMode:i,ignoreLocalhost:s,valueOverrides:g}=e;if(p({devMode:i,ignoreLocalhost:s,overrideBaseUrl:t}))return(0,c.debug)(`local page ignored: ${JSON.stringify(e)}, to ${t}`),{};let n={pageLocation:"",browserFingerprint:g?.browserFingerprint};if(typeof window<"u"&&(n={...n,pageLocation:window.location.href,browserResolution:`${window.screen.width}:${window.screen.height}`}),typeof document<"u"&&(n={...n,pageReferrer:document.referrer,pageTitle:document.title}),typeof navigator<"u"&&(n={...n,browserLanguage:navigator.language,browser:navigator.userAgent}),!n.pageLocation)return(0,c.warn)("no pageLocation"),{};try{let a=await fetch(`${t}/site/tracking`,{method:"POST",headers:{"Content-Type":"application/json",authorization:""},body:JSON.stringify({key:r,data:n})});if(!a.ok){let o=await a.text();return(0,c.warn)("tracking error:"+o),{error:o}}}catch(a){let o=a instanceof Error?a.message:"Unknown error";return(0,c.warn)("tracking error:"+o),{error:o}}return{}},R=async e=>{let{analyticaToken:r,overrideBaseUrl:t=l,type:i,value:s,devMode:g,ignoreLocalhost:n}=e;if(p({devMode:g,ignoreLocalhost:n,overrideBaseUrl:t}))return(0,c.debug)(`local metric ignored: ${JSON.stringify(e)}, to ${t}`),{};if(i===S||T(i)){let o=`Type "${i}" is reserved for system metrics`;return(0,c.warn)(o),{error:o}}let a={type:i,value:s};try{let o=await fetch(`${t}/site/metric`,{method:"POST",headers:{"Content-Type":"application/json",authorization:""},body:JSON.stringify({key:r,data:a})});if(!o.ok){let f=await o.text();return(0,c.warn)("metric tracking error:"+f),{error:f}}}catch(o){let f=o instanceof Error?o.message:"Unknown error";return(0,c.warn)("metric tracking error:"+f),{error:f}}return{}},$=async e=>{let{analyticaToken:r,overrideBaseUrl:t=l,data:i,devMode:s,ignoreLocalhost:g}=e;if(p({devMode:s,ignoreLocalhost:g,overrideBaseUrl:t},i.pageLocation))return(0,c.debug)(`local performance metrics ignored: ${JSON.stringify(i)}, to ${t}`),{};try{let n=await fetch(`${t}/site/metrics`,{method:"POST",headers:{"Content-Type":"text/plain;charset=UTF-8"},credentials:"omit",body:JSON.stringify({key:r,data:i}),keepalive:!0});if(!n.ok){let a=await n.text();return(0,c.warn)("performance metric tracking error:"+a),{error:a}}}catch(n){let a=n instanceof Error?n.message:"Unknown error";return(0,c.warn)("performance metric tracking error:"+a),{error:a}}return{}};0&&(module.exports={event,metric,page,performanceMetrics});

package/dist/index.js

@@ -1,2 +1,2 @@
 'use client';
-"use strict";var wr=Object.create;var S=Object.defineProperty;var vr=Object.getOwnPropertyDescriptor;var Cr=Object.getOwnPropertyNames;var Ir=Object.getPrototypeOf,kr=Object.prototype.hasOwnProperty;var Ar=(r,e)=>{for(var t in e)S(r,t,{get:e[t],enumerable:!0})},Q=(r,e,t,o)=>{if(e&&typeof e=="object"||typeof e=="function")for(let n of Cr(e))!kr.call(r,n)&&n!==t&&S(r,n,{get:()=>e[n],enumerable:!(o=vr(e,n))||o.enumerable});return r};var Sr=(r,e,t)=>(t=r!=null?wr(Ir(r)):{},Q(e||!r||!r.__esModule?S(t,"default",{value:r,enumerable:!0}):t,r)),br=r=>Q(S({},"__esModule",{value:!0}),r);var Zr={};Ar(Zr,{AnalyticaClickProvider:()=>j,AnalyticaConfigContext:()=>L,Modal:()=>G,PERFORMANCE_METRIC:()=>f,PERFORMANCE_METRICS_TIMEOUT_MS:()=>gr,PERFORMANCE_METRIC_NAMES:()=>M,TIMED_OUT_PERFORMANCE_METRIC_VALUE:()=>yr,createErrorOccurrence:()=>y,createPerformanceMetricsBatcher:()=>hr,errorTrack:()=>P,event:()=>J,getErrorKey:()=>F,getSupportedPerformanceMetricNames:()=>Er,installPerformanceMetricsCollector:()=>V,isPerformanceMetricName:()=>H,mergeErrorPayload:()=>D,metric:()=>W,page:()=>z,performanceMetrics:()=>K,serializeErrorArguments:()=>C,tokenMissing:()=>I,useAnalytica:()=>jr});module.exports=br(Zr);var O=require("ag-common/dist/common/helpers/log"),R=require("react");var re=require("cross-fetch/polyfill"),g=require("ag-common/dist/common/helpers/log"),ar=require("ag-common/dist/common/helpers/string/contains");var Mr="localhost",B=()=>typeof window<"u"&&window.location.hostname===Mr,h=({devMode:r,ignoreLocalhost:e})=>B()&&(e===!0||r!==!0);var _=require("ag-common/dist/common/helpers/hashCode"),X=require("ag-common/dist/common/helpers/log"),rr=require("ag-common/dist/common/helpers/object"),F=r=>{try{let e=/^\[?[0-9]{1,2}:[0-9]{1,2}:[0-9]{1,2}\]?$/gim,t=/(at \S+?) \(\S+\)\s/gim,o=/^((%[cs])+\s*)+$/gim,n=/^color:/gim,i;(0,rr.isJson)(r.message)?i=JSON.parse(r.message):i=[r.message];let a=i.findIndex(l=>l.match(o)),c=i.findIndex(l=>l.match(n));a>=0&&c>=0&&c===a+1&&(i=i.filter((l,E)=>![a,c].includes(E)));let s=i.map(l=>l.includes(".js:")||l.includes("node_modules")?l.replace(t,"$1 (stacktrace)"):l.replace(e,"[date]")),d=JSON.stringify([r.name??"",...s]),p=(0,_.hashCode)(d).toString();return(0,X.debug)("got errorKey=",d,p),p}catch{return(0,_.hashCode)(`${r.name??""}:${r.message}`).toString()}};var U="https://analytica.click/api",Nr="/site/errors",Or=10,er=100,Rr=500,Lr=1e3,xr=429,Br=500,_r="unknown",or="[Unserializable]",w=new Map,T,$,Fr=["will be removed","performing full reload","tracking error","fetch RSC payload","perform a full reload","warnings#debug_enabled",'"digest"',"punycode"],y=()=>({occurrenceId:zr(),occurredAt:Date.now()}),D=(r,e)=>{if(r&&(r.data.occurrenceId!==e.data.occurrenceId||r.data.occurredAt!==e.data.occurredAt))return e;let t=(r?.data.occurrences??0)+(e.data.occurrences??1);return{...e,data:{...e.data,occurrenceId:r?.data.occurrenceId??e.data.occurrenceId,occurredAt:r?.data.occurredAt??e.data.occurredAt,occurrences:t}}},Ur=r=>r===xr||r>=Br,$r=async()=>{let r=Dr();if(!r)return{retryable:!1};try{let e=r.errors.map(({error:o})=>o);if(r.overload){let o=e[0];o&&e.splice(0,1,{...o,data:{...o.data,message:`error overload!: ${o.data.message||"?"}`}})}let t=await fetch(`${r.scope.overrideBaseUrl}${Nr}`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(e)});if(!t.ok){let o=Ur(t.status);return o?tr(r):r.scope.errors.length===0&&w.delete(r.scopeKey),{error:`HTTP error! status: ${t.status}`,retryable:o}}r.scope.errors.length===0&&w.delete(r.scopeKey)}catch(e){return tr(r),{error:e instanceof Error?e.message:String(e),retryable:!0}}finally{sr()?cr(Lr):T=void 0}return{retryable:!1}},Dr=()=>{let r=ir(),e=r>er?1:Or;for(let[t,o]of w.entries()){if(o.errors.length===0)continue;let n=o.errors.splice(0,e);return{scopeKey:t,scope:o,errors:n,overload:r>er}}},tr=r=>{r.scope.errors.unshift(...r.errors)},ir=()=>{let r=0;for(let e of w.values())r+=e.errors.length;return r},sr=()=>ir()>0,cr=r=>{T===void 0&&(T=setTimeout(()=>{T=void 0,dr()},r))},nr=()=>{T!==void 0&&(clearTimeout(T),T=void 0)},dr=()=>($??=$r().finally(()=>{$=void 0}),$),Hr=async()=>{nr();let r;for(;sr();){let e=await dr();if(e.error&&(r??=e.error,e.retryable))return{error:r};nr()}return r===void 0?{}:{error:r}},Jr=({apiKey:r,overrideBaseUrl:e,browserFingerprint:t})=>{let o=JSON.stringify([r,e,t??null]),n=w.get(o);return n||(n={overrideBaseUrl:e,errors:[]},w.set(o,n)),{scopeKey:o,scope:n}},zr=()=>typeof globalThis.crypto?.randomUUID=="function"?globalThis.crypto.randomUUID():`${Date.now()}-${Math.random().toString(36).slice(2)}`,Wr=(r,e)=>{let t=y();return{...r,data:{...r.data,browserFingerprint:r.data.browserFingerprint??e,occurrenceId:r.data.occurrenceId??t.occurrenceId,occurredAt:r.data.occurredAt??t.occurredAt}}},P=async({data:r,overrideBaseUrl:e=U,ignoreBrowserErrors:t,devMode:o,ignoreLocalhost:n,valueOverrides:i,flushImmediately:a=!1})=>{let c=e||U,s=c.startsWith("/")&&typeof window>"u"?U:c,d=[...Fr,...t??[]];if(d.length>0){let A=(0,ar.containsInsensitive)(r.data.message,...d);if(A){(0,g.debug)("ignoring error, contains=",A);return}}let p=B();if(p&&h({devMode:o,ignoreLocalhost:n}))return(0,g.debug)(`local error tracking ignored:${r.data.message} ${JSON.stringify(r)}, to ${s}`),{};if(p&&(0,g.debug)("allowing local error tracking due to devmode=true"),!Kr(r.data.message))return{};(0,g.debug)("error track",r.data.message,JSON.stringify(r));let l=Wr(r,r.data.browserFingerprint??i?.browserFingerprint),E=l.data.browserFingerprint,u=F({...l.data,name:l.data.name??_r}),{scope:Z}=Jr({apiKey:l.key,overrideBaseUrl:s,browserFingerprint:E}),q=JSON.stringify([u,l.data.occurrenceId,l.data.occurredAt]),x=Z.errors.find(A=>A.key===q);return x?x.error=D(x.error,l):Z.errors.push({key:q,error:D(void 0,l)}),a?Hr():(cr(Rr),{})};function Kr(r){return r?r.match(/^"?[0-9]{1,2}:[0-9]{1,2}:[0-9]{1,2}"?$/)?((0,g.info)("ignoring react devtools message"),!1):r===JSON.stringify([{}])?((0,g.info)("empty message payload?"),!1):!0:((0,g.info)("no message?"),!1)}var C=r=>{let e=new WeakSet;try{return JSON.stringify(r,(t,o)=>{if(typeof o=="bigint")return o.toString();if(o instanceof Error)return{name:o.name,message:o.message,stack:o.stack};if(typeof o=="object"&&o!==null){if(e.has(o))return"[Circular]";e.add(o)}return o})??or}catch{return or}};async function b({ev:r,values:e}){if(!e.analyticaToken)return;let t=r instanceof Error?r:r.error instanceof Error?r.error:void 0,o={message:r.message,href:window.location.href,filename:r.filename,browserFingerprint:e.valueOverrides?.browserFingerprint,...t?{name:t.name,stack:t.stack}:{},...y()};await P({...e,data:{key:e.analyticaToken,data:o}})}function fr(r){if(!r.analyticaToken)return;let e=o=>{b({ev:o,values:r})},t=o=>{let n=o.reason;b({ev:{error:n,message:n instanceof Error?n.message:String(n)},values:r})};return window.addEventListener("error",e),window.addEventListener("unhandledrejection",t),()=>{window.removeEventListener("error",e),window.removeEventListener("unhandledrejection",t)}}function lr(r){let e=window;if(e.consoleset||!r.analyticaToken)return;e.consoleset=!0;let t=i=>{try{let a=C(i);P({...r,data:{data:{href:window.location.href,message:a,...y()},key:r.analyticaToken}}).catch(()=>{})}catch{return}},o=window.console.error.bind(window.console);window.console.error=(...i)=>{try{o(...i)}finally{t(i)}};let n=window.console.warn.bind(window.console);window.console.warn=(...i)=>{try{n(...i)}finally{t(i)}}}var I=r=>`[Analytica.${r}] Please load analytica token in AnalyticaClickProvider to use this component`;function ur(r){let e=globalThis,t=globalThis.console;if(e.__analyticaNodeSet||typeof window<"u"||!r.analyticaToken||r.ignoreLocalhost&&(r.devMode||r.overrideBaseUrl?.startsWith("/")))return;e.__analyticaNodeSet=!0;let o=a=>{try{let c=C(a);P({...r,data:{data:{href:"server",message:c,...y()},key:r.analyticaToken}}).catch(()=>{})}catch{return}},n=t.error.bind(t);t.error=(...a)=>{try{n(...a)}finally{o(a)}};let i=t.warn.bind(t);t.warn=(...a)=>{try{i(...a)}finally{o(a)}}}var pr=require("ag-common/dist/common/helpers/log");var f={CLS:"CLS",FCP:"FCP",INP:"INP",LCP:"LCP",TTFB:"TTFB",TTI:"TTI"},M=[f.CLS,f.FCP,f.INP,f.LCP,f.TTFB,f.TTI],H=r=>M.some(e=>e===r);var ue=require("cross-fetch/polyfill"),m=require("ag-common/dist/common/helpers/log");var N="https://analytica.click/api",Vr="health",J=async r=>{let{analyticaToken:e,overrideBaseUrl:t=N,eventName:o,devMode:n,ignoreLocalhost:i,valueOverrides:a}=r;if(h({devMode:n,ignoreLocalhost:i}))return(0,m.debug)(`local page ignored: ${JSON.stringify(r)}, to ${t}`),{};let c={eventName:o,browserFingerprint:a?.browserFingerprint,pageLocation:""};typeof window<"u"&&(c={...c,pageLocation:window.location.href,browserResolution:`${window.screen.width}:${window.screen.height}`}),typeof navigator<"u"&&(c={...c,browser:navigator.userAgent});try{let s=await fetch(`${t}/site/event`,{method:"POST",headers:{"Content-Type":"application/json",authorization:""},body:JSON.stringify({key:e,data:c})});if(!s.ok){let d=await s.text();return(0,m.warn)("tracking error:"+d),{error:d}}}catch(s){let d=s instanceof Error?s.message:"Unknown error";return(0,m.warn)("tracking error:"+d),{error:d}}return{}},z=async r=>{let{analyticaToken:e,overrideBaseUrl:t=N,devMode:o,ignoreLocalhost:n,valueOverrides:i}=r;if(h({devMode:o,ignoreLocalhost:n}))return(0,m.debug)(`local page ignored: ${JSON.stringify(r)}, to ${t}`),{};let a={pageLocation:"",browserFingerprint:i?.browserFingerprint};if(typeof window<"u"&&(a={...a,pageLocation:window.location.href,browserResolution:`${window.screen.width}:${window.screen.height}`}),typeof document<"u"&&(a={...a,pageReferrer:document.referrer,pageTitle:document.title}),typeof navigator<"u"&&(a={...a,browserLanguage:navigator.language,browser:navigator.userAgent}),!a.pageLocation)return(0,m.warn)("no pageLocation"),{};try{let c=await fetch(`${t}/site/tracking`,{method:"POST",headers:{"Content-Type":"application/json",authorization:""},body:JSON.stringify({key:e,data:a})});if(!c.ok){let s=await c.text();return(0,m.warn)("tracking error:"+s),{error:s}}}catch(c){let s=c instanceof Error?c.message:"Unknown error";return(0,m.warn)("tracking error:"+s),{error:s}}return{}},W=async r=>{let{analyticaToken:e,overrideBaseUrl:t=N,type:o,value:n,devMode:i,ignoreLocalhost:a}=r;if(h({devMode:i,ignoreLocalhost:a}))return(0,m.debug)(`local metric ignored: ${JSON.stringify(r)}, to ${t}`),{};if(o===Vr||H(o)){let s=`Type "${o}" is reserved for system metrics`;return(0,m.warn)(s),{error:s}}let c={type:o,value:n};try{let s=await fetch(`${t}/site/metric`,{method:"POST",headers:{"Content-Type":"application/json",authorization:""},body:JSON.stringify({key:e,data:c})});if(!s.ok){let d=await s.text();return(0,m.warn)("metric tracking error:"+d),{error:d}}}catch(s){let d=s instanceof Error?s.message:"Unknown error";return(0,m.warn)("metric tracking error:"+d),{error:d}}return{}},K=async r=>{let{analyticaToken:e,overrideBaseUrl:t=N,data:o,devMode:n,ignoreLocalhost:i}=r;if(h({devMode:n,ignoreLocalhost:i}))return(0,m.debug)(`local performance metrics ignored: ${JSON.stringify(o)}, to ${t}`),{};try{let a=await fetch(`${t}/site/metrics`,{method:"POST",headers:{"Content-Type":"text/plain;charset=UTF-8"},credentials:"omit",body:JSON.stringify({key:e,data:o}),keepalive:!0});if(!a.ok){let c=await a.text();return(0,m.warn)("performance metric tracking error:"+c),{error:c}}}catch(a){let c=a instanceof Error?a.message:"Unknown error";return(0,m.warn)("performance metric tracking error:"+c),{error:c}}return{}};var gr=1e4,yr=-1,k={EVENT:"event",LARGEST_CONTENTFUL_PAINT:"largest-contentful-paint",LAYOUT_SHIFT:"layout-shift",NAVIGATION:"navigation",PAINT:"paint"},Er=(r,e,t=!0)=>{let o=new Set(r),n=new Set;return o.has(k.LAYOUT_SHIFT)&&n.add(f.CLS),o.has(k.PAINT)&&n.add(f.FCP),o.has(k.EVENT)&&t&&n.add(f.INP),o.has(k.LARGEST_CONTENTFUL_PAINT)&&n.add(f.LCP),e&&(n.add(f.TTFB),n.add(f.TTI)),M.filter(i=>n.has(i))},hr=({pageLocation:r,send:e,supportedMetrics:t,timeoutMs:o=gr,timer:n={set:(i,a)=>window.setTimeout(i,a),clear:i=>window.clearTimeout(i)}})=>{let i=new Set(t),a=new Map,c=!1,s,d=()=>{c||i.size===0||(c=!0,s!==void 0&&n.clear(s),e({pageLocation:r,metrics:t.map(p=>({type:p,value:a.get(p)??yr}))}))};return i.size>0&&(s=n.set(d,o)),{flush:d,report:(p,l)=>{c||!i.has(p)||!Number.isFinite(l)||l<0||(a.set(p,l),a.size===i.size&&d())},stop:()=>{c=!0,s!==void 0&&n.clear(s)}}},mr=()=>performance.getEntriesByType(k.NAVIGATION)[0],Yr=(r,{onCLS:e,onFCP:t,onINP:o,onLCP:n,onTTFB:i})=>{if(!r.analyticaToken||typeof performance>"u")return;let a=mr(),c=Er(typeof PerformanceObserver>"u"?[]:PerformanceObserver.supportedEntryTypes??[],a!==void 0,typeof PerformanceEventTiming<"u"&&"interactionId"in PerformanceEventTiming.prototype);if(c.length===0)return;let s=hr({pageLocation:window.location.href,supportedMetrics:c,send:u=>{K({...r,data:u})}}),d=new Set(c),p=()=>s.flush();window.addEventListener("pagehide",p),d.has(f.CLS)&&e(u=>s.report(f.CLS,u.value),{reportAllChanges:!0}),d.has(f.FCP)&&t(u=>s.report(f.FCP,u.value)),d.has(f.INP)&&o(u=>s.report(f.INP,u.value),{reportAllChanges:!0}),d.has(f.LCP)&&n(u=>s.report(f.LCP,u.value),{reportAllChanges:!0}),d.has(f.TTFB)&&i(u=>s.report(f.TTFB,u.value));let l=()=>{let u=mr();return!u||u.domInteractive<=0?!1:(s.report(f.TTI,Math.max(0,u.domInteractive-(u.activationStart??0))),!0)},E=()=>{l()&&document.removeEventListener("readystatechange",E)};return d.has(f.TTI)&&!l()&&document.addEventListener("readystatechange",E),()=>{document.removeEventListener("readystatechange",E),window.removeEventListener("pagehide",p),s.stop()}},V=r=>{if(!r.analyticaToken||typeof performance>"u")return;let e=!0,t;return import("web-vitals").then(o=>{e&&(t=Yr(r,o))}).catch(o=>{(0,pr.warn)("unable to install performance metrics collector:",o instanceof Error?o.message:String(o))}),()=>{e=!1,t?.()}};var Y=require("react/jsx-runtime"),G=({open:r,setOpen:e,children:t})=>r?(0,Y.jsx)("div",{style:{position:"fixed",top:0,left:0,right:0,bottom:0,backgroundColor:"rgba(0, 0, 0, 0.5)",display:"flex",alignItems:"center",justifyContent:"center",zIndex:1e3},onClick:()=>e(!1),children:(0,Y.jsx)("div",{style:{backgroundColor:"white",padding:"2rem",borderRadius:"8px",maxWidth:"500px",maxHeight:"80vh",overflow:"auto",position:"relative",boxShadow:"0 10px 25px rgba(0, 0, 0, 0.2)"},onClick:o=>o.stopPropagation(),children:t})}):null;var v=require("react/jsx-runtime"),L=(0,R.createContext)(void 0),Gr={fontSize:"2rem"},j=class extends R.Component{constructor(e){super(e),this.state={},ur(e.values)}static getDerivedStateFromError(e){return{error:e instanceof Error?e:new Error(String(e))}}componentDidMount(){let{values:e}=this.props;lr(e),this.removeBrowserErrorHandler=fr(e),this.removePerformanceMetricsCollector=V(e),(0,O.debug)("installed analytica.click error handlers"),e.analyticaToken||(0,O.warn)(I("AnalyticaClickProvider"))}componentDidCatch(e){b({ev:e,values:this.props.values})}componentWillUnmount(){this.removeBrowserErrorHandler?.(),this.removePerformanceMetricsCollector?.()}render(){let{children:e,values:t}=this.props,{error:o}=this.state;if(o){if(!t.analyticaToken)throw o;return(0,v.jsx)(G,{open:!0,setOpen:()=>{},children:(0,v.jsxs)("div",{style:Gr,children:["A fatal error has occurred - the admin has been notified.",(0,v.jsx)("button",{type:"button",onClick:()=>window.location.reload(),children:"Press here to restart app"})]})})}return(0,v.jsx)(L.Provider,{value:t,children:e})}};var Tr=require("ag-common/dist/common/helpers/log"),Pr=require("react");var jr=()=>{let r=(0,Pr.useContext)(L);if(!r?.analyticaToken){(0,Tr.warn)(I("useAnalytica"));let e=async()=>({error:"no token"});return{event:e,page:e,metric:e}}return{event:e=>J({...e,...r}),page:e=>z({...e,...r}),metric:e=>W({...e,...r})}};0&&(module.exports={AnalyticaClickProvider,AnalyticaConfigContext,Modal,PERFORMANCE_METRIC,PERFORMANCE_METRICS_TIMEOUT_MS,PERFORMANCE_METRIC_NAMES,TIMED_OUT_PERFORMANCE_METRIC_VALUE,createErrorOccurrence,createPerformanceMetricsBatcher,errorTrack,event,getErrorKey,getSupportedPerformanceMetricNames,installPerformanceMetricsCollector,isPerformanceMetricName,mergeErrorPayload,metric,page,performanceMetrics,serializeErrorArguments,tokenMissing,useAnalytica});
+"use strict";var ve=Object.create;var O=Object.defineProperty;var Ce=Object.getOwnPropertyDescriptor;var Ie=Object.getOwnPropertyNames;var Ae=Object.getPrototypeOf,ke=Object.prototype.hasOwnProperty;var Se=(e,r)=>{for(var o in r)O(e,o,{get:r[o],enumerable:!0})},q=(e,r,o,t)=>{if(r&&typeof r=="object"||typeof r=="function")for(let n of Ie(r))!ke.call(e,n)&&n!==o&&O(e,n,{get:()=>r[n],enumerable:!(t=Ce(r,n))||t.enumerable});return e};var Ne=(e,r,o)=>(o=e!=null?ve(Ae(e)):{},q(r||!e||!e.__esModule?O(o,"default",{value:e,enumerable:!0}):o,e)),be=e=>q(O({},"__esModule",{value:!0}),e);var er={};Se(er,{AnalyticaClickProvider:()=>Z,AnalyticaConfigContext:()=>B,Modal:()=>j,PERFORMANCE_METRIC:()=>d,PERFORMANCE_METRICS_INP_WAIT_MS:()=>Ee,PERFORMANCE_METRICS_TIMEOUT_MS:()=>ye,PERFORMANCE_METRIC_NAMES:()=>L,createErrorOccurrence:()=>T,createPerformanceMetricsBatcher:()=>Te,errorTrack:()=>C,event:()=>W,getErrorKey:()=>D,getSupportedPerformanceMetricNames:()=>he,installPerformanceMetricsCollector:()=>Y,isPerformanceMetricName:()=>J,mergeErrorPayload:()=>H,metric:()=>K,page:()=>z,performanceMetrics:()=>V,serializeErrorArguments:()=>k,tokenMissing:()=>S,useAnalytica:()=>Xe});module.exports=be(er);var _=require("ag-common/dist/common/helpers/log"),x=require("react");var nr=require("cross-fetch/polyfill"),w=require("ag-common/dist/common/helpers/log"),ie=require("ag-common/dist/common/helpers/string/contains");var Q="localhost",Oe=/^127(?:\.\d{1,3}){3}$/,Me=new Set([Q,"0.0.0.0","[::1]","::1"]),Le=new Set(["development","test"]),Re=e=>{let r=e.toLowerCase().replace(/\.$/,"");return Me.has(r)||r.endsWith(`.${Q}`)||Oe.test(r)},F=e=>{if(!e)return!1;try{let r=new URL(e);return Re(r.hostname)}catch{return!1}},h=({devMode:e,ignoreLocalhost:r,overrideBaseUrl:o},t)=>{let n=typeof window<"u",i=n&&F(window.location.href),a=typeof process<"u"&&process.env.NODE_ENV!==void 0&&Le.has(process.env.NODE_ENV);if(!(i||a||F(t)||!n&&e===!0))return!1;let c=F(o);return r===!0||e!==!0||!c};var U=require("ag-common/dist/common/helpers/hashCode"),X=require("ag-common/dist/common/helpers/log"),ee=require("ag-common/dist/common/helpers/object"),D=e=>{try{let r=/^\[?[0-9]{1,2}:[0-9]{1,2}:[0-9]{1,2}\]?$/gim,o=/(at \S+?) \(\S+\)\s/gim,t=/^((%[cs])+\s*)+$/gim,n=/^color:/gim,i;(0,ee.isJson)(e.message)?i=JSON.parse(e.message):i=[e.message];let a=i.findIndex(u=>u.match(t)),s=i.findIndex(u=>u.match(n));a>=0&&s>=0&&s===a+1&&(i=i.filter((u,g)=>![a,s].includes(g)));let c=i.map(u=>u.includes(".js:")||u.includes("node_modules")?u.replace(o,"$1 (stacktrace)"):u.replace(r,"[date]")),f=JSON.stringify([e.name??"",...c]),m=(0,U.hashCode)(f).toString();return(0,X.debug)("got errorKey=",f,m),m}catch{return(0,U.hashCode)(`${e.name??""}:${e.message}`).toString()}};var re="https://analytica.click/api",_e="/site/errors",xe=10,te=100,Be=500,Fe=1e3,Ue=429,De=500,$e="unknown",oe="[Unserializable]",I=new Map,v,$,He=["will be removed","performing full reload","tracking error","fetch RSC payload","perform a full reload","warnings#debug_enabled",'"digest"',"punycode"],T=()=>({occurrenceId:Ye(),occurredAt:Date.now()}),H=(e,r)=>{if(e&&(e.data.occurrenceId!==r.data.occurrenceId||e.data.occurredAt!==r.data.occurredAt))return r;let o=(e?.data.occurrences??0)+(r.data.occurrences??1);return{...r,data:{...r.data,occurrenceId:e?.data.occurrenceId??r.data.occurrenceId,occurredAt:e?.data.occurredAt??r.data.occurredAt,occurrences:o}}},Je=e=>e===Ue||e>=De,We=async()=>{let e=ze();if(!e)return{retryable:!1};try{let r=e.errors.map(({error:t})=>t);if(e.overload){let t=r[0];t&&r.splice(0,1,{...t,data:{...t.data,message:`error overload!: ${t.data.message||"?"}`}})}let o=await fetch(`${e.scope.overrideBaseUrl}${_e}`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(r)});if(!o.ok){let t=Je(o.status);return t?ne(e):e.scope.errors.length===0&&I.delete(e.scopeKey),{error:`HTTP error! status: ${o.status}`,retryable:t}}e.scope.errors.length===0&&I.delete(e.scopeKey)}catch(r){return ne(e),{error:r instanceof Error?r.message:String(r),retryable:!0}}finally{ce()?de(Fe):v=void 0}return{retryable:!1}},ze=()=>{let e=se(),r=e>te?1:xe;for(let[o,t]of I.entries()){if(t.errors.length===0)continue;let n=t.errors.splice(0,r);return{scopeKey:o,scope:t,errors:n,overload:e>te}}},ne=e=>{e.scope.errors.unshift(...e.errors)},se=()=>{let e=0;for(let r of I.values())e+=r.errors.length;return e},ce=()=>se()>0,de=e=>{v===void 0&&(v=setTimeout(()=>{v=void 0,fe()},e))},ae=()=>{v!==void 0&&(clearTimeout(v),v=void 0)},fe=()=>($??=We().finally(()=>{$=void 0}),$),Ke=async()=>{ae();let e;for(;ce();){let r=await fe();if(r.error&&(e??=r.error,r.retryable))return{error:e};ae()}return e===void 0?{}:{error:e}},Ve=({apiKey:e,overrideBaseUrl:r,browserFingerprint:o})=>{let t=JSON.stringify([e,r,o??null]),n=I.get(t);return n||(n={overrideBaseUrl:r,errors:[]},I.set(t,n)),{scopeKey:t,scope:n}},Ye=()=>typeof globalThis.crypto?.randomUUID=="function"?globalThis.crypto.randomUUID():`${Date.now()}-${Math.random().toString(36).slice(2)}`,Ge=(e,r)=>{let o=T();return{...e,data:{...e.data,browserFingerprint:e.data.browserFingerprint??r,occurrenceId:e.data.occurrenceId??o.occurrenceId,occurredAt:e.data.occurredAt??o.occurredAt}}},C=async({data:e,overrideBaseUrl:r=re,ignoreBrowserErrors:o,devMode:t,ignoreLocalhost:n,valueOverrides:i,flushImmediately:a=!1})=>{let s=r||re;if(s.startsWith("/")&&typeof window>"u")return{};let c=s,f=[...He,...o??[]];if(f.length>0){let E=(0,ie.containsInsensitive)(e.data.message,...f);if(E){(0,w.debug)("ignoring error, contains=",E);return}}if(h({devMode:t,ignoreLocalhost:n,overrideBaseUrl:r},e.data.href))return{};if(!je(e.data.message))return{};(0,w.debug)("error track",e.data.message,JSON.stringify(e));let m=Ge(e,e.data.browserFingerprint??i?.browserFingerprint),u=m.data.browserFingerprint,g=D({...m.data,name:m.data.name??$e}),{scope:l}=Ve({apiKey:m.key,overrideBaseUrl:c,browserFingerprint:u}),P=JSON.stringify([g,m.data.occurrenceId,m.data.occurredAt]),y=l.errors.find(E=>E.key===P);return y?y.error=H(y.error,m):l.errors.push({key:P,error:H(void 0,m)}),a?Ke():(de(Be),{})};function je(e){return e?e.match(/^"?[0-9]{1,2}:[0-9]{1,2}:[0-9]{1,2}"?$/)?((0,w.info)("ignoring react devtools message"),!1):e===JSON.stringify([{}])?((0,w.info)("empty message payload?"),!1):!0:((0,w.info)("no message?"),!1)}var k=e=>{let r=new WeakSet;try{return JSON.stringify(e,(o,t)=>{if(typeof t=="bigint")return t.toString();if(t instanceof Error)return{name:t.name,message:t.message,stack:t.stack};if(typeof t=="object"&&t!==null){if(r.has(t))return"[Circular]";r.add(t)}return t})??oe}catch{return oe}};async function M({ev:e,values:r}){if(!r.analyticaToken)return;let o=e instanceof Error?e:e.error instanceof Error?e.error:void 0,t={message:e.message,href:window.location.href,filename:e.filename,browserFingerprint:r.valueOverrides?.browserFingerprint,...o?{name:o.name,stack:o.stack}:{},...T()};await C({...r,data:{key:r.analyticaToken,data:t}})}function le(e){if(!e.analyticaToken)return;let r=t=>{M({ev:t,values:e})},o=t=>{let n=t.reason;M({ev:{error:n,message:n instanceof Error?n.message:String(n)},values:e})};return window.addEventListener("error",r),window.addEventListener("unhandledrejection",o),()=>{window.removeEventListener("error",r),window.removeEventListener("unhandledrejection",o)}}function ue(e){let r=window;if(r.consoleset||!e.analyticaToken)return;r.consoleset=!0;let o=i=>{try{let a=k(i);C({...e,data:{data:{href:window.location.href,message:a,...T()},key:e.analyticaToken}}).catch(()=>{})}catch{return}},t=window.console.error.bind(window.console);window.console.error=(...i)=>{try{t(...i)}finally{o(i)}};let n=window.console.warn.bind(window.console);window.console.warn=(...i)=>{try{n(...i)}finally{o(i)}}}var S=e=>`[Analytica.${e}] Please load analytica token in AnalyticaClickProvider to use this component`;function me(e){let r=globalThis,o=globalThis.console;if(r.__analyticaNodeSet||typeof window<"u"||!e.analyticaToken||h(e)||e.overrideBaseUrl?.startsWith("/"))return;r.__analyticaNodeSet=!0;let t=a=>{try{let s=k(a);C({...e,data:{data:{href:"server",message:s,...T()},key:e.analyticaToken}}).catch(()=>{})}catch{return}},n=o.error.bind(o);o.error=(...a)=>{try{n(...a)}finally{t(a)}};let i=o.warn.bind(o);o.warn=(...a)=>{try{i(...a)}finally{t(a)}}}var ge=require("ag-common/dist/common/helpers/log");var d={CLS:"CLS",FCP:"FCP",INP:"INP",LCP:"LCP",TTFB:"TTFB",TTI:"TTI"},L=[d.CLS,d.FCP,d.INP,d.LCP,d.TTFB,d.TTI],J=e=>L.some(r=>r===e);var Er=require("cross-fetch/polyfill"),p=require("ag-common/dist/common/helpers/log");var R="https://analytica.click/api",Ze="health",W=async e=>{let{analyticaToken:r,overrideBaseUrl:o=R,eventName:t,devMode:n,ignoreLocalhost:i,valueOverrides:a}=e;if(h({devMode:n,ignoreLocalhost:i,overrideBaseUrl:o}))return(0,p.debug)(`local page ignored: ${JSON.stringify(e)}, to ${o}`),{};let s={eventName:t,browserFingerprint:a?.browserFingerprint,pageLocation:""};typeof window<"u"&&(s={...s,pageLocation:window.location.href,browserResolution:`${window.screen.width}:${window.screen.height}`}),typeof navigator<"u"&&(s={...s,browser:navigator.userAgent});try{let c=await fetch(`${o}/site/event`,{method:"POST",headers:{"Content-Type":"application/json",authorization:""},body:JSON.stringify({key:r,data:s})});if(!c.ok){let f=await c.text();return(0,p.warn)("tracking error:"+f),{error:f}}}catch(c){let f=c instanceof Error?c.message:"Unknown error";return(0,p.warn)("tracking error:"+f),{error:f}}return{}},z=async e=>{let{analyticaToken:r,overrideBaseUrl:o=R,devMode:t,ignoreLocalhost:n,valueOverrides:i}=e;if(h({devMode:t,ignoreLocalhost:n,overrideBaseUrl:o}))return(0,p.debug)(`local page ignored: ${JSON.stringify(e)}, to ${o}`),{};let a={pageLocation:"",browserFingerprint:i?.browserFingerprint};if(typeof window<"u"&&(a={...a,pageLocation:window.location.href,browserResolution:`${window.screen.width}:${window.screen.height}`}),typeof document<"u"&&(a={...a,pageReferrer:document.referrer,pageTitle:document.title}),typeof navigator<"u"&&(a={...a,browserLanguage:navigator.language,browser:navigator.userAgent}),!a.pageLocation)return(0,p.warn)("no pageLocation"),{};try{let s=await fetch(`${o}/site/tracking`,{method:"POST",headers:{"Content-Type":"application/json",authorization:""},body:JSON.stringify({key:r,data:a})});if(!s.ok){let c=await s.text();return(0,p.warn)("tracking error:"+c),{error:c}}}catch(s){let c=s instanceof Error?s.message:"Unknown error";return(0,p.warn)("tracking error:"+c),{error:c}}return{}},K=async e=>{let{analyticaToken:r,overrideBaseUrl:o=R,type:t,value:n,devMode:i,ignoreLocalhost:a}=e;if(h({devMode:i,ignoreLocalhost:a,overrideBaseUrl:o}))return(0,p.debug)(`local metric ignored: ${JSON.stringify(e)}, to ${o}`),{};if(t===Ze||J(t)){let c=`Type "${t}" is reserved for system metrics`;return(0,p.warn)(c),{error:c}}let s={type:t,value:n};try{let c=await fetch(`${o}/site/metric`,{method:"POST",headers:{"Content-Type":"application/json",authorization:""},body:JSON.stringify({key:r,data:s})});if(!c.ok){let f=await c.text();return(0,p.warn)("metric tracking error:"+f),{error:f}}}catch(c){let f=c instanceof Error?c.message:"Unknown error";return(0,p.warn)("metric tracking error:"+f),{error:f}}return{}},V=async e=>{let{analyticaToken:r,overrideBaseUrl:o=R,data:t,devMode:n,ignoreLocalhost:i}=e;if(h({devMode:n,ignoreLocalhost:i,overrideBaseUrl:o},t.pageLocation))return(0,p.debug)(`local performance metrics ignored: ${JSON.stringify(t)}, to ${o}`),{};try{let a=await fetch(`${o}/site/metrics`,{method:"POST",headers:{"Content-Type":"text/plain;charset=UTF-8"},credentials:"omit",body:JSON.stringify({key:r,data:t}),keepalive:!0});if(!a.ok){let s=await a.text();return(0,p.warn)("performance metric tracking error:"+s),{error:s}}}catch(a){let s=a instanceof Error?a.message:"Unknown error";return(0,p.warn)("performance metric tracking error:"+s),{error:s}}return{}};var ye=1e4,Ee=500,N={EVENT:"event",LARGEST_CONTENTFUL_PAINT:"largest-contentful-paint",LAYOUT_SHIFT:"layout-shift",NAVIGATION:"navigation",PAINT:"paint"},he=(e,r,o=!0)=>{let t=new Set(e),n=new Set;return t.has(N.LAYOUT_SHIFT)&&n.add(d.CLS),t.has(N.PAINT)&&n.add(d.FCP),t.has(N.EVENT)&&o&&n.add(d.INP),t.has(N.LARGEST_CONTENTFUL_PAINT)&&n.add(d.LCP),r&&(n.add(d.TTFB),n.add(d.TTI)),L.filter(i=>n.has(i))},Te=({pageLocation:e,send:r,supportedMetrics:o,timeoutMs:t=ye,timer:n={set:(i,a)=>window.setTimeout(i,a),clear:i=>window.clearTimeout(i)}})=>{let i=new Set(o),a=o.filter(y=>y!==d.INP),s=new Map,c=!1,f=!1,m=!1,u,g,l=()=>{u!==void 0&&(n.clear(u),u=void 0),g!==void 0&&(n.clear(g),g=void 0)},P=()=>{if(m||c||i.size===0)return;c=!0,l(),f=s.has(d.INP);let y=o.flatMap(E=>{let b=s.get(E);return b===void 0?[]:[{type:E,value:b}]});y.length>0&&r({pageLocation:e,metrics:y})};return a.length>0&&(u=n.set(P,t)),{flush:P,report:(y,E)=>{if(!(m||!i.has(y)||!Number.isFinite(E)||E<0)){if(c){y===d.INP&&!f&&(f=!0,r({pageLocation:e,metrics:[{type:y,value:E}]}));return}s.set(y,E),a.every(b=>s.has(b))&&(!i.has(d.INP)||s.has(d.INP)?P():g===void 0&&(g=n.set(P,Ee)))}},stop:()=>{m=!0,l()}}},pe=()=>performance.getEntriesByType(N.NAVIGATION)[0],qe=(e,{onCLS:r,onFCP:o,onINP:t,onLCP:n,onTTFB:i})=>{if(!e.analyticaToken||typeof performance>"u")return;let a=pe(),s=he(typeof PerformanceObserver>"u"?[]:PerformanceObserver.supportedEntryTypes??[],a!==void 0,typeof PerformanceEventTiming<"u"&&"interactionId"in PerformanceEventTiming.prototype);if(s.length===0)return;let c=Te({pageLocation:window.location.href,supportedMetrics:s,send:l=>{V({...e,data:l})}}),f=new Set(s),m=()=>c.flush();window.addEventListener("pagehide",m),f.has(d.CLS)&&r(l=>c.report(d.CLS,l.value),{reportAllChanges:!0}),f.has(d.FCP)&&o(l=>c.report(d.FCP,l.value)),f.has(d.INP)&&t(l=>c.report(d.INP,l.value),{reportAllChanges:!0}),f.has(d.LCP)&&n(l=>c.report(d.LCP,l.value),{reportAllChanges:!0}),f.has(d.TTFB)&&i(l=>c.report(d.TTFB,l.value));let u=()=>{let l=pe();return!l||l.domInteractive<=0?!1:(c.report(d.TTI,Math.max(0,l.domInteractive-(l.activationStart??0))),!0)},g=()=>{u()&&document.removeEventListener("readystatechange",g)};return f.has(d.TTI)&&!u()&&document.addEventListener("readystatechange",g),()=>{document.removeEventListener("readystatechange",g),window.removeEventListener("pagehide",m),c.stop()}},Y=e=>{if(!e.analyticaToken||typeof performance>"u")return;let r=!0,o;return import("web-vitals").then(t=>{r&&(o=qe(e,t))}).catch(t=>{(0,ge.warn)("unable to install performance metrics collector:",t instanceof Error?t.message:String(t))}),()=>{r=!1,o?.()}};var G=require("react/jsx-runtime"),j=({open:e,setOpen:r,children:o})=>e?(0,G.jsx)("div",{style:{position:"fixed",top:0,left:0,right:0,bottom:0,backgroundColor:"rgba(0, 0, 0, 0.5)",display:"flex",alignItems:"center",justifyContent:"center",zIndex:1e3},onClick:()=>r(!1),children:(0,G.jsx)("div",{style:{backgroundColor:"white",padding:"2rem",borderRadius:"8px",maxWidth:"500px",maxHeight:"80vh",overflow:"auto",position:"relative",boxShadow:"0 10px 25px rgba(0, 0, 0, 0.2)"},onClick:t=>t.stopPropagation(),children:o})}):null;var A=require("react/jsx-runtime"),B=(0,x.createContext)(void 0),Qe={fontSize:"2rem"},Z=class extends x.Component{constructor(r){super(r),this.state={},me(r.values)}static getDerivedStateFromError(r){return{error:r instanceof Error?r:new Error(String(r))}}componentDidMount(){let{values:r}=this.props;ue(r),this.removeBrowserErrorHandler=le(r),this.removePerformanceMetricsCollector=Y(r),(0,_.debug)("installed analytica.click error handlers"),r.analyticaToken||(0,_.warn)(S("AnalyticaClickProvider"))}componentDidCatch(r){M({ev:r,values:this.props.values})}componentWillUnmount(){this.removeBrowserErrorHandler?.(),this.removePerformanceMetricsCollector?.()}render(){let{children:r,values:o}=this.props,{error:t}=this.state;if(t){if(!o.analyticaToken)throw t;return(0,A.jsx)(j,{open:!0,setOpen:()=>{},children:(0,A.jsxs)("div",{style:Qe,children:["A fatal error has occurred - the admin has been notified.",(0,A.jsx)("button",{type:"button",onClick:()=>window.location.reload(),children:"Press here to restart app"})]})})}return(0,A.jsx)(B.Provider,{value:o,children:r})}};var Pe=require("ag-common/dist/common/helpers/log"),we=require("react");var Xe=()=>{let e=(0,we.useContext)(B);if(!e?.analyticaToken){(0,Pe.warn)(S("useAnalytica"));let r=async()=>({error:"no token"});return{event:r,page:r,metric:r}}return{event:r=>W({...r,...e}),page:r=>z({...r,...e}),metric:r=>K({...r,...e})}};0&&(module.exports={AnalyticaClickProvider,AnalyticaConfigContext,Modal,PERFORMANCE_METRIC,PERFORMANCE_METRICS_INP_WAIT_MS,PERFORMANCE_METRICS_TIMEOUT_MS,PERFORMANCE_METRIC_NAMES,createErrorOccurrence,createPerformanceMetricsBatcher,errorTrack,event,getErrorKey,getSupportedPerformanceMetricNames,installPerformanceMetricsCollector,isPerformanceMetricName,mergeErrorPayload,metric,page,performanceMetrics,serializeErrorArguments,tokenMissing,useAnalytica});

package/dist/types.d.ts

@@ -4,11 +4,12 @@ export type TEvent = (p: IEvent) => Promise<{
 }>;
 export interface IEvent {
     analyticaToken: string;
+    /** Collector base URL. Server error tracking requires an absolute URL. */
     overrideBaseUrl?: string;
     eventName: string;
-    /** internal testing only. also allows local sending of errors */
+    /** Internal testing: allow local telemetry only with an absolute localhost overrideBaseUrl. */
     devMode?: boolean;
-    /** Ignore browser telemetry from localhost even when devMode is enabled. */
+    /** Ignore localhost and development-runtime telemetry even when devMode is enabled. */
     ignoreLocalhost?: boolean;
     valueOverrides?: {
         browserFingerprint?: string;
@@ -19,10 +20,11 @@ export type TPage = (p: IPage) => Promise<{
 }>;
 export interface IPage {
     analyticaToken: string;
+    /** Collector base URL. Server error tracking requires an absolute URL. */
     overrideBaseUrl?: string;
-    /** internal testing only. also allows local sending of errors */
+    /** Internal testing: allow local telemetry only with an absolute localhost overrideBaseUrl. */
     devMode?: boolean;
-    /** Ignore browser telemetry from localhost even when devMode is enabled. */
+    /** Ignore localhost and development-runtime telemetry even when devMode is enabled. */
     ignoreLocalhost?: boolean;
     valueOverrides?: {
         browserFingerprint?: string;
@@ -33,17 +35,18 @@ export type TMetric = (p: IMetric) => Promise<{
 }>;
 export interface IMetric {
     analyticaToken: string;
+    /** Collector base URL. Server error tracking requires an absolute URL. */
     overrideBaseUrl?: string;
     type: string;
     value: number;
-    /** internal testing only. also allows local sending of errors */
+    /** Internal testing: allow local telemetry only with an absolute localhost overrideBaseUrl. */
     devMode?: boolean;
-    /** Ignore browser telemetry from localhost even when devMode is enabled. */
+    /** Ignore localhost and development-runtime telemetry even when devMode is enabled. */
     ignoreLocalhost?: boolean;
 }
 export interface IPerformanceMetricObservation {
     type: PerformanceMetricName;
-    /** -1 means the browser supports this metric but it did not report within the deadline. */
+    /** An observed, finite, nonnegative value. Unavailable metrics are omitted. */
     value: number;
 }
 export interface IPerformanceMetricsData {
@@ -57,10 +60,11 @@ export type TPerformanceMetrics = (p: IAnalyticaConfig & {
 }>;
 export interface IAnalyticaConfig {
     analyticaToken: string;
+    /** Collector base URL. Server error tracking requires an absolute URL. */
     overrideBaseUrl?: string;
-    /** internal testing only. also allows local sending of errors */
+    /** Internal testing: allow local telemetry only with an absolute localhost overrideBaseUrl. */
     devMode?: boolean;
-    /** Ignore browser telemetry from localhost even when devMode is enabled. */
+    /** Ignore localhost and development-runtime telemetry even when devMode is enabled. */
     ignoreLocalhost?: boolean;
     /** Additional browser error substrings to ignore alongside the defaults.
      * default: 'will be removed', 'performing full reload', 'tracking error', 'fetch RSC payload',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "analytica.click",
-  "version": "0.0.655",
+  "version": "0.0.657",
   "description": "",
   "license": "ISC",
   "author": " <help@analytica.click> (analytica.click)",