@grafana/faro-core - npm Package Compare versions

Comparing version 1.12.3 to 1.13.0

dist/bundle/faro-core.iife.js

@@ -1,1 +0,1 @@
-var GrafanaFaroCore=function(e){"use strict";function n(e,n){return typeof e===n}function t(e,n){return Object.prototype.toString.call(e)===`[object ${n}]`}function r(e,n){try{return e instanceof n}catch(e){return!1}}const a=e=>n(e,"null"),i=e=>n(e,"string"),o=e=>n(e,"number")&&!isNaN(e)||n(e,"bigint"),s=e=>!a(e)&&n(e,"object"),u=e=>n(e,"function"),l=e=>t(e,"Array"),c="undefined"!=typeof Event,d="undefined"!=typeof Error,g=e=>d&&r(e,Error),p="undefined"!=typeof Element,f="undefined"!=typeof Map;function m(e,t){if(e===t)return!0;if(n(e,"number")&&isNaN(e))return n(t,"number")&&isNaN(t);const r=l(e),a=l(t);if(r!==a)return!1;if(r&&a){const n=e.length;if(n!==t.length)return!1;for(let r=n;0!=r--;)if(!m(e[r],t[r]))return!1;return!0}const i=s(e),o=s(t);if(i!==o)return!1;if(e&&t&&i&&o){const n=Object.keys(e),r=Object.keys(t);if(n.length!==r.length)return!1;for(let e of n)if(!r.includes(e))return!1;for(let r of n)if(!m(e[r],t[r]))return!1;return!0}return!1}function v(){return(new Date).toISOString()}function b(e){return new Date(e).toISOString()}var h;e.LogLevel=void 0,(h=e.LogLevel||(e.LogLevel={})).TRACE="trace",h.DEBUG="debug",h.INFO="info",h.LOG="log",h.WARN="warn",h.ERROR="error";const E=e.LogLevel.LOG,y=[e.LogLevel.TRACE,e.LogLevel.DEBUG,e.LogLevel.INFO,e.LogLevel.LOG,e.LogLevel.WARN,e.LogLevel.ERROR];function I(){}const T="abcdefghijkmnopqrstuvwxyzABCDEFGHJKLMNPQRSTUVWXYZ0123456789";const O="undefined"!=typeof globalThis?globalThis:"undefined"!=typeof global?global:"undefined"!=typeof self?self:void 0;class L{constructor(e,n){var t,r;this.signalBuffer=[],this.itemLimit=null!==(t=null==n?void 0:n.itemLimit)&&void 0!==t?t:50,this.sendTimeout=null!==(r=null==n?void 0:n.sendTimeout)&&void 0!==r?r:250,this.paused=(null==n?void 0:n.paused)||!1,this.sendFn=e,this.flushInterval=-1,this.paused||this.start(),document.addEventListener("visibilitychange",(()=>{"hidden"===document.visibilityState&&this.flush()}))}addItem(e){this.paused||(this.signalBuffer.push(e),this.signalBuffer.length>=this.itemLimit&&this.flush())}start(){this.paused=!1,this.sendTimeout>0&&(this.flushInterval=window.setInterval((()=>this.flush()),this.sendTimeout))}pause(){this.paused=!0,clearInterval(this.flushInterval)}groupItems(e){const n=new Map;return e.forEach((e=>{const t=JSON.stringify(e.meta);let r=n.get(t);r=void 0===r?[e]:[...r,e],n.set(t,r)})),Array.from(n.values())}flush(){if(this.paused||0===this.signalBuffer.length)return;this.groupItems(this.signalBuffer).forEach(this.sendFn),this.signalBuffer=[]}}var S;e.TransportItemType=void 0,(S=e.TransportItemType||(e.TransportItemType={})).EXCEPTION="exception",S.LOG="log",S.MEASUREMENT="measurement",S.TRACE="trace",S.EVENT="event";const N={[e.TransportItemType.EXCEPTION]:"exceptions",[e.TransportItemType.LOG]:"logs",[e.TransportItemType.MEASUREMENT]:"measurements",[e.TransportItemType.TRACE]:"traces",[e.TransportItemType.EVENT]:"events"};function x(n){return t=>{if(t.type===e.TransportItemType.EXCEPTION&&t.payload){const e=t.payload,r=`${e.type}: ${e.value}`;if(function(e,n){return e.some((e=>i(e)?n.includes(e):!!n.match(e)))}(n,r))return null}return t}}function R(e,n,t,r){var a;n.debug("Initializing transports");const i=[];let o=t.paused,s=[];const u=e=>{let n=e;for(const e of s){const t=n.map(e).filter(Boolean);if(0===t.length)return[];n=t}return n},l=e=>{const t=u(e);if(0!==t.length)for(const e of i)n.debug(`Transporting item using ${e.name}\n`,t),e.isBatched()&&e.send(t)};let c;(null===(a=t.batching)||void 0===a?void 0:a.enabled)&&(c=new L(l,{sendTimeout:t.batching.sendTimeout,itemLimit:t.batching.itemLimit,paused:o}));return{add:(...a)=>{n.debug("Adding transports"),a.forEach((a=>{n.debug(`Adding "${a.name}" transport`);i.some((e=>e===a))?n.warn(`Transport ${a.name} is already added`):(a.unpatchedConsole=e,a.internalLogger=n,a.config=t,a.metas=r,i.push(a))}))},addBeforeSendHooks:(...e)=>{n.debug("Adding beforeSendHooks\n",s),e.forEach((e=>{e&&s.push(e)}))},addIgnoreErrorsPatterns:(...e)=>{n.debug("Adding ignoreErrorsPatterns\n",e),e.forEach((e=>{e&&s.push(x(e))}))},getBeforeSendHooks:()=>[...s],execute:e=>{var r;o||((null===(r=t.batching)||void 0===r?void 0:r.enabled)&&(null==c||c.addItem(e)),(e=>{var r,a;if((null===(r=t.batching)||void 0===r?void 0:r.enabled)&&i.every((e=>e.isBatched())))return;const[o]=u([e]);if(void 0!==o)for(const e of i)n.debug(`Transporting item using ${e.name}\n`,o),e.isBatched()?(null===(a=t.batching)||void 0===a?void 0:a.enabled)||e.send([o]):e.send(o)})(e))},isPaused:()=>o,pause:()=>{n.debug("Pausing transports"),null==c||c.pause(),o=!0},remove:(...e)=>{n.debug("Removing transports"),e.forEach((e=>{n.debug(`Removing "${e.name}" transport`);const t=i.indexOf(e);-1!==t?i.splice(t,1):n.warn(`Transport "${e.name}" is not added`)}))},removeBeforeSendHooks:(...e)=>{s.filter((n=>!e.includes(n)))},get transports(){return[...i]},unpause:()=>{n.debug("Unpausing transports"),null==c||c.start(),o=!1}}}var j;e.InternalLoggerLevel=void 0,(j=e.InternalLoggerLevel||(e.InternalLoggerLevel={}))[j.OFF=0]="OFF",j[j.ERROR=1]="ERROR",j[j.WARN=2]="WARN",j[j.INFO=3]="INFO",j[j.VERBOSE=4]="VERBOSE";const A={debug:I,error:I,info:I,prefix:"Faro",warn:I},w=e.InternalLoggerLevel.ERROR,C=Object.assign({},console);let k=C;function _(e){var n;return k=null!==(n=e.unpatchedConsole)&&void 0!==n?n:k,k}function P(n=C,t=w){const r=A;return t>e.InternalLoggerLevel.OFF&&(r.error=t>=e.InternalLoggerLevel.ERROR?function(...e){n.error(`${r.prefix}\n`,...e)}:I,r.warn=t>=e.InternalLoggerLevel.WARN?function(...e){n.warn(`${r.prefix}\n`,...e)}:I,r.info=t>=e.InternalLoggerLevel.INFO?function(...e){n.info(`${r.prefix}\n`,...e)}:I,r.debug=t>=e.InternalLoggerLevel.VERBOSE?function(...e){n.debug(`${r.prefix}\n`,...e)}:I),r}let B=A;function F(e,n){return B=P(e,n.internalLoggerLevel),B}class D{constructor(){this.unpatchedConsole=C,this.internalLogger=A,this.config={},this.metas={}}logDebug(...e){this.internalLogger.debug(`${this.name}\n`,...e)}logInfo(...e){this.internalLogger.info(`${this.name}\n`,...e)}logWarn(...e){this.internalLogger.warn(`${this.name}\n`,...e)}logError(...e){this.internalLogger.error(`${this.name}\n`,...e)}}function M(e,n){var t,r;if(void 0===n)return e;if(void 0===e)return{resourceSpans:n};const a=null===(t=e.resourceSpans)||void 0===t?void 0:t[0];if(void 0===a)return e;const i=(null==a?void 0:a.scopeSpans)||[],o=(null===(r=null==n?void 0:n[0])||void 0===r?void 0:r.scopeSpans)||[];return Object.assign(Object.assign({},e),{resourceSpans:[Object.assign(Object.assign({},a),{scopeSpans:[...i,...o]})]})}const $="Error";let G;function V(e){let n=e.cause;return g(n)?n=e.cause.toString():null!==n&&(s(e.cause)||l(e.cause))?n=JSON.stringify(e.cause):null!=n&&(n=e.cause.toString()),null==n?{}:{cause:n}}const z=e=>e.map((e=>{try{return String(e)}catch(e){return""}})).join(" ");function U(n,t,r,i,o){t.debug("Initializing API");const s=function(n,t,r,a,i){let o;return t.debug("Initializing traces API"),{getOTEL:()=>o,getTraceContext:()=>{const e=null==o?void 0:o.trace.getSpanContext(o.context.active());return e?{trace_id:e.traceId,span_id:e.spanId}:void 0},initOTEL:(e,n)=>{t.debug("Initializing OpenTelemetry"),o={trace:e,context:n}},isOTELInitialized:()=>!!o,pushTraces:n=>{try{const r={type:e.TransportItemType.TRACE,payload:n,meta:a.value};t.debug("Pushing trace\n",r),i.execute(r)}catch(e){t.error("Error pushing trace\n",e)}}}}(0,t,0,i,o);return Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({},s),function(n,t,r,i,o,s){var u;t.debug("Initializing exceptions API");let l=null;G=null!==(u=r.parseStacktrace)&&void 0!==u?u:G;const c=e=>{t.debug("Changing stacktrace parser"),G=null!=e?e:G};return c(r.parseStacktrace),{changeStacktraceParser:c,getStacktraceParser:()=>G,pushError:(n,{skipDedupe:u,stackFrames:c,type:d,context:g,spanContext:p,timestampOverwriteMs:f}={})=>{d=d||n.name||$;const h={meta:i.value,payload:{type:d,value:n.message,timestamp:f?b(f):v(),trace:p?{trace_id:p.traceId,span_id:p.spanId}:s.getTraceContext(),context:Object.assign(Object.assign({},V(n)),null!=g?g:{})},type:e.TransportItemType.EXCEPTION};(null==(c=null!=c?c:n.stack?null==G?void 0:G(n).frames:void 0)?void 0:c.length)&&(h.payload.stacktrace={frames:c});const E={type:h.payload.type,value:h.payload.value,stackTrace:h.payload.stacktrace,context:h.payload.context};u||!r.dedupe||a(l)||!m(E,l)?(l=E,t.debug("Pushing exception\n",h),o.execute(h)):t.debug("Skipping error push because it is the same as the last one\n",h.payload)}}}(0,t,r,i,o,s)),function(e,n,t,r){let a,i,o;n.debug("Initializing meta API");const s=e=>{i&&r.remove(i),i={user:e},r.add(i)},u=e=>{a&&r.remove(a),a={session:e},r.add(a)};return{setUser:s,resetUser:s,setSession:u,resetSession:u,getSession:()=>r.value.session,setView:e=>{var n;if((null===(n=null==o?void 0:o.view)||void 0===n?void 0:n.name)===(null==e?void 0:e.name))return;const t=o;o={view:e},r.add(o),t&&r.remove(t)},getView:()=>r.value.view}}(0,t,0,i)),function(n,t,r,i,o,s){var u;t.debug("Initializing logs API");let l=null;const c=null!==(u=r.logArgsSerializer)&&void 0!==u?u:z;return{pushLog:(n,{context:u,level:d,skipDedupe:g,spanContext:p,timestampOverwriteMs:f}={})=>{try{const h={type:e.TransportItemType.LOG,payload:{message:c(n),level:null!=d?d:E,context:null!=u?u:{},timestamp:f?b(f):v(),trace:p?{trace_id:p.traceId,span_id:p.spanId}:s.getTraceContext()},meta:i.value},y={message:h.payload.message,level:h.payload.level,context:h.payload.context};if(!g&&r.dedupe&&!a(l)&&m(y,l))return void t.debug("Skipping log push because it is the same as the last one\n",h.payload);l=y,t.debug("Pushing log\n",h),o.execute(h)}catch(e){t.error("Error pushing log\n",e)}}}}(0,t,r,i,o,s)),function(n,t,r,i,o,s){t.debug("Initializing measurements API");let u=null;return{pushMeasurement:(n,{skipDedupe:l,context:c,spanContext:d,timestampOverwriteMs:g}={})=>{try{const p={type:e.TransportItemType.MEASUREMENT,payload:Object.assign(Object.assign({},n),{trace:d?{trace_id:d.traceId,span_id:d.spanId}:s.getTraceContext(),timestamp:g?b(g):v(),context:null!=c?c:{}}),meta:i.value},f={type:p.payload.type,values:p.payload.values,context:p.payload.context};if(!l&&r.dedupe&&!a(u)&&m(f,u))return void t.debug("Skipping measurement push because it is the same as the last one\n",p.payload);u=f,t.debug("Pushing measurement\n",p),o.execute(p)}catch(e){t.error("Error pushing measurement\n",e)}}}}(0,t,r,i,o,s)),function(n,t,r,i,o,s){let u=null;return{pushEvent:(n,l,c,{skipDedupe:d,spanContext:g,timestampOverwriteMs:p}={})=>{try{const f={meta:i.value,payload:{name:n,domain:null!=c?c:r.eventDomain,attributes:l,timestamp:p?b(p):v(),trace:g?{trace_id:g.traceId,span_id:g.spanId}:s.getTraceContext()},type:e.TransportItemType.EVENT},h={name:f.payload.name,attributes:f.payload.attributes,domain:f.payload.domain};if(!d&&r.dedupe&&!a(u)&&m(h,u))return void t.debug("Skipping event push because it is the same as the last one\n",f.payload);u=h,t.debug("Pushing event\n",f),o.execute(f)}catch(e){t.error("Error pushing event",e)}}}}(0,t,r,i,o,s))}const K="1.12.3";const H="_faroInternal";function W(e){e.config.isolate?e.internalLogger.debug("Skipping registering internal Faro instance on global object"):(e.internalLogger.debug("Registering internal Faro instance on global object"),Object.defineProperty(O,H,{configurable:!1,enumerable:!1,writable:!1,value:e}))}function X(){return H in O}function J(n,t,r,a,i,o,s){return t.debug("Initializing Faro"),e.faro={api:o,config:r,instrumentations:s,internalLogger:t,metas:a,pause:i.pause,transports:i,unpatchedConsole:n,unpause:i.unpause},W(e.faro),function(e){if(e.config.preventGlobalExposure)e.internalLogger.debug("Skipping registering public Faro instance in the global scope");else{if(e.internalLogger.debug(`Registering public faro reference in the global scope using "${e.config.globalObjectKey}" key`),e.config.globalObjectKey in O)return void e.internalLogger.warn(`Skipping global registration due to key "${e.config.globalObjectKey}" being used already. Please set "globalObjectKey" to something else or set "preventGlobalExposure" to "true"`);Object.defineProperty(O,e.config.globalObjectKey,{configurable:!1,writable:!1,value:e})}}(e.faro),e.faro}e.faro={};return e.BaseExtension=D,e.BaseInstrumentation=class extends D{constructor(){super(...arguments),this.api={},this.transports={}}},e.BaseTransport=class extends D{isBatched(){return!1}getIgnoreUrls(){return[]}},e.Conventions={EventNames:{CLICK:"click",NAVIGATION:"navigation",SESSION_START:"session_start",VIEW_CHANGED:"view_changed"}},e.EVENT_CLICK="click",e.EVENT_NAVIGATION="navigation",e.EVENT_ROUTE_CHANGE="route_change",e.EVENT_SESSION_EXTEND="session_extend",e.EVENT_SESSION_RESUME="session_resume",e.EVENT_SESSION_START="session_start",e.EVENT_VIEW_CHANGED="view_changed",e.VERSION=K,e.allLogLevels=y,e.createInternalLogger=P,e.createPromiseBuffer=function(e){const{size:n,concurrency:t}=e,r=[];let a=0;const i=()=>{if(a<t&&r.length){const{producer:e,resolve:n,reject:t}=r.shift();a++,e().then((e=>{a--,i(),n(e)}),(e=>{a--,i(),t(e)}))}};return{add:e=>{if(r.length+a>=n)throw new Error("Task buffer full");return new Promise(((n,t)=>{r.push({producer:e,resolve:n,reject:t}),i()}))}}},e.dateNow=function(){return Date.now()},e.deepEqual=m,e.defaultBatchingConfig={enabled:!0,sendTimeout:250,itemLimit:50},e.defaultExceptionType=$,e.defaultGlobalObjectKey="faro",e.defaultInternalLoggerLevel=w,e.defaultLogArgsSerializer=z,e.defaultLogLevel=E,e.defaultUnpatchedConsole=C,e.genShortID=function(e=10){return Array.from(Array(e)).map((()=>T[Math.floor(59*Math.random())])).join("")},e.getCurrentTimestamp=v,e.getInternalFaroFromGlobalObject=function(){return O[H]},e.getTransportBody=function(n){let t={meta:{}};return void 0!==n[0]&&(t.meta=n[0].meta),n.forEach((n=>{switch(n.type){case e.TransportItemType.LOG:case e.TransportItemType.EVENT:case e.TransportItemType.EXCEPTION:case e.TransportItemType.MEASUREMENT:const r=N[n.type],a=t[r];t=Object.assign(Object.assign({},t),{[r]:void 0===a?[n.payload]:[...a,n.payload]});break;case e.TransportItemType.TRACE:t=Object.assign(Object.assign({},t),{traces:M(t.traces,n.payload.resourceSpans)})}})),t},e.globalObject=O,e.initializeFaro=function(e){const n=_(e),t=F(n,e);if(X()&&!e.isolate)return void t.error('Faro is already registered. Either add instrumentations, transports etc. to the global faro instance or use the "isolate" property');t.debug("Initializing");const r=function(e,n){let t=[],r=[];const a=()=>t.reduce(((e,n)=>Object.assign(e,u(n)?n():n)),{}),i=()=>{if(r.length){const e=a();r.forEach((n=>n(e)))}};return{add:(...e)=>{n.debug("Adding metas\n",e),t.push(...e),i()},remove:(...e)=>{n.debug("Removing metas\n",e),t=t.filter((n=>!e.includes(n))),i()},addListener:e=>{n.debug("Adding metas listener\n",e),r.push(e)},removeListener:e=>{n.debug("Removing metas listener\n",e),r=r.filter((n=>n!==e))},get value(){return a()}}}(0,t),a=R(n,t,e,r),i=U(0,t,e,r,a),o=function(e,n,t,r,a,i){n.debug("Initializing instrumentations");const o=[];return{add:(...s)=>{n.debug("Adding instrumentations"),s.forEach((s=>{n.debug(`Adding "${s.name}" instrumentation`),o.some((e=>e.name===s.name))?n.warn(`Instrumentation ${s.name} is already added`):(s.unpatchedConsole=e,s.internalLogger=n,s.config=t,s.metas=r,s.transports=a,s.api=i,o.push(s),s.initialize())}))},get instrumentations(){return[...o]},remove:(...e)=>{n.debug("Removing instrumentations"),e.forEach((e=>{var t,r;n.debug(`Removing "${e.name}" instrumentation`);const a=o.reduce(((n,t,r)=>null===n&&t.name===e.name?r:null),null);a?(null===(r=(t=o[a]).destroy)||void 0===r||r.call(t),o.splice(a,1)):n.warn(`Instrumentation "${e.name}" is not added`)}))}}}(n,t,e,r,a,i),s=J(n,t,e,r,a,i,o);return function(e){var n,t;const r={sdk:{version:K},app:{bundleId:e.config.app.name&&(a=e.config.app.name,null==O?void 0:O[`__faroBundleId_${a}`])}};var a;const i=null===(n=e.config.sessionTracking)||void 0===n?void 0:n.session;i&&e.api.setSession(i),e.config.app&&(r.app=Object.assign(Object.assign({},e.config.app),r.app)),e.config.user&&(r.user=e.config.user),e.config.view&&(r.view=e.config.view),e.metas.add(r,...null!==(t=e.config.metas)&&void 0!==t?t:[])}(s),function(e){e.transports.add(...e.config.transports),e.transports.addBeforeSendHooks(e.config.beforeSend),e.transports.addIgnoreErrorsPatterns(e.config.ignoreErrors)}(s),function(e){e.instrumentations.add(...e.config.instrumentations)}(s),s},e.internalGlobalObjectKey=H,e.isArray=l,e.isBoolean=e=>n(e,"boolean"),e.isDomError=e=>t(e,"DOMError"),e.isDomException=e=>t(e,"DOMException"),e.isElement=e=>p&&r(e,Element),e.isElementDefined=p,e.isError=g,e.isErrorDefined=d,e.isErrorEvent=e=>t(e,"ErrorEvent"),e.isEvent=e=>c&&r(e,Event),e.isEventDefined=c,e.isFunction=u,e.isInstanceOf=r,e.isInt=e=>o(e)&&Number.isInteger(e),e.isInternalFaroOnGlobalObject=X,e.isMap=e=>f&&r(e,Map),e.isMapDefined=f,e.isNull=a,e.isNumber=o,e.isObject=s,e.isPrimitive=e=>!s(e)&&!u(e),e.isRegExp=e=>t(e,"RegExp"),e.isString=i,e.isSymbol=e=>n(e,"symbol"),e.isSyntheticEvent=e=>s(e)&&"nativeEvent"in e&&"preventDefault"in e&&"stopPropagation"in e,e.isThenable=e=>u(null==e?void 0:e.then),e.isToString=t,e.isTypeof=n,e.isUndefined=e=>n(e,"undefined"),e.noop=I,e.setInternalFaroOnGlobalObject=W,e.transportItemTypeToBodyKey=N,e.unknownString="unknown",e}({});
+var GrafanaFaroCore=function(e){"use strict";function n(e,n){return typeof e===n}function t(e,n){return Object.prototype.toString.call(e)===`[object ${n}]`}function r(e,n){try{return e instanceof n}catch(e){return!1}}const i=e=>n(e,"null"),a=e=>n(e,"string"),s=e=>n(e,"number")&&!isNaN(e)||n(e,"bigint"),o=e=>!i(e)&&n(e,"object"),l=e=>n(e,"function"),u=e=>t(e,"Array"),c="undefined"!=typeof Event,d="undefined"!=typeof Error,g=e=>d&&r(e,Error),p="undefined"!=typeof Element,f="undefined"!=typeof Map;function m(e){return null==e||(u(e)||a(e)?0===e.length:!!o(e)&&0===Object.keys(e).length)}function v(e,t){if(e===t)return!0;if(n(e,"number")&&isNaN(e))return n(t,"number")&&isNaN(t);const r=u(e),i=u(t);if(r!==i)return!1;if(r&&i){const n=e.length;if(n!==t.length)return!1;for(let r=n;0!=r--;)if(!v(e[r],t[r]))return!1;return!0}const a=o(e),s=o(t);if(a!==s)return!1;if(e&&t&&a&&s){const n=Object.keys(e),r=Object.keys(t);if(n.length!==r.length)return!1;for(let e of n)if(!r.includes(e))return!1;for(let r of n)if(!v(e[r],t[r]))return!1;return!0}return!1}function b(){return(new Date).toISOString()}function h(e){return new Date(e).toISOString()}var E;e.LogLevel=void 0,(E=e.LogLevel||(e.LogLevel={})).TRACE="trace",E.DEBUG="debug",E.INFO="info",E.LOG="log",E.WARN="warn",E.ERROR="error";const y=e.LogLevel.LOG,I=[e.LogLevel.TRACE,e.LogLevel.DEBUG,e.LogLevel.INFO,e.LogLevel.LOG,e.LogLevel.WARN,e.LogLevel.ERROR];function T(){}const O="abcdefghijkmnopqrstuvwxyzABCDEFGHJKLMNPQRSTUVWXYZ0123456789";const L="undefined"!=typeof globalThis?globalThis:"undefined"!=typeof global?global:"undefined"!=typeof self?self:void 0;function S(){const e=new WeakSet;return function(n,t){if("object"==typeof t&&null!==t){if(e.has(t))return null;e.add(t)}return t}}function N(e={}){return JSON.stringify(null!=e?e:{},S())}class R{constructor(e,n){var t,r;this.signalBuffer=[],this.itemLimit=null!==(t=null==n?void 0:n.itemLimit)&&void 0!==t?t:50,this.sendTimeout=null!==(r=null==n?void 0:n.sendTimeout)&&void 0!==r?r:250,this.paused=(null==n?void 0:n.paused)||!1,this.sendFn=e,this.flushInterval=-1,this.paused||this.start(),document.addEventListener("visibilitychange",(()=>{"hidden"===document.visibilityState&&this.flush()}))}addItem(e){this.paused||(this.signalBuffer.push(e),this.signalBuffer.length>=this.itemLimit&&this.flush())}start(){this.paused=!1,this.sendTimeout>0&&(this.flushInterval=window.setInterval((()=>this.flush()),this.sendTimeout))}pause(){this.paused=!0,clearInterval(this.flushInterval)}groupItems(e){const n=new Map;return e.forEach((e=>{const t=JSON.stringify(e.meta);let r=n.get(t);r=void 0===r?[e]:[...r,e],n.set(t,r)})),Array.from(n.values())}flush(){if(this.paused||0===this.signalBuffer.length)return;this.groupItems(this.signalBuffer).forEach(this.sendFn),this.signalBuffer=[]}}var j;e.TransportItemType=void 0,(j=e.TransportItemType||(e.TransportItemType={})).EXCEPTION="exception",j.LOG="log",j.MEASUREMENT="measurement",j.TRACE="trace",j.EVENT="event";const x={[e.TransportItemType.EXCEPTION]:"exceptions",[e.TransportItemType.LOG]:"logs",[e.TransportItemType.MEASUREMENT]:"measurements",[e.TransportItemType.TRACE]:"traces",[e.TransportItemType.EVENT]:"events"};function A(n){return t=>{if(t.type===e.TransportItemType.EXCEPTION&&t.payload){const e=t.payload,r=`${e.type}: ${e.value}`;if(function(e,n){return e.some((e=>a(e)?n.includes(e):!!n.match(e)))}(n,r))return null}return t}}function w(e,n,t,r){var i;n.debug("Initializing transports");const a=[];let s=t.paused,o=[];const l=e=>{let n=e;for(const e of o){const t=n.map(e).filter(Boolean);if(0===t.length)return[];n=t}return n},u=e=>{const t=l(e);if(0!==t.length)for(const e of a)n.debug(`Transporting item using ${e.name}\n`,t),e.isBatched()&&e.send(t)};let c;(null===(i=t.batching)||void 0===i?void 0:i.enabled)&&(c=new R(u,{sendTimeout:t.batching.sendTimeout,itemLimit:t.batching.itemLimit,paused:s}));return{add:(...i)=>{n.debug("Adding transports"),i.forEach((i=>{n.debug(`Adding "${i.name}" transport`);a.some((e=>e===i))?n.warn(`Transport ${i.name} is already added`):(i.unpatchedConsole=e,i.internalLogger=n,i.config=t,i.metas=r,a.push(i))}))},addBeforeSendHooks:(...e)=>{n.debug("Adding beforeSendHooks\n",o),e.forEach((e=>{e&&o.push(e)}))},addIgnoreErrorsPatterns:(...e)=>{n.debug("Adding ignoreErrorsPatterns\n",e),e.forEach((e=>{e&&o.push(A(e))}))},getBeforeSendHooks:()=>[...o],execute:e=>{var r;s||((null===(r=t.batching)||void 0===r?void 0:r.enabled)&&(null==c||c.addItem(e)),(e=>{var r,i;if((null===(r=t.batching)||void 0===r?void 0:r.enabled)&&a.every((e=>e.isBatched())))return;const[s]=l([e]);if(void 0!==s)for(const e of a)n.debug(`Transporting item using ${e.name}\n`,s),e.isBatched()?(null===(i=t.batching)||void 0===i?void 0:i.enabled)||e.send([s]):e.send(s)})(e))},isPaused:()=>s,pause:()=>{n.debug("Pausing transports"),null==c||c.pause(),s=!0},remove:(...e)=>{n.debug("Removing transports"),e.forEach((e=>{n.debug(`Removing "${e.name}" transport`);const t=a.indexOf(e);-1!==t?a.splice(t,1):n.warn(`Transport "${e.name}" is not added`)}))},removeBeforeSendHooks:(...e)=>{o.filter((n=>!e.includes(n)))},get transports(){return[...a]},unpause:()=>{n.debug("Unpausing transports"),null==c||c.start(),s=!1}}}var C;e.InternalLoggerLevel=void 0,(C=e.InternalLoggerLevel||(e.InternalLoggerLevel={}))[C.OFF=0]="OFF",C[C.ERROR=1]="ERROR",C[C.WARN=2]="WARN",C[C.INFO=3]="INFO",C[C.VERBOSE=4]="VERBOSE";const k={debug:T,error:T,info:T,prefix:"Faro",warn:T},_=e.InternalLoggerLevel.ERROR,P=Object.assign({},console);let B=P;function F(e){var n;return B=null!==(n=e.unpatchedConsole)&&void 0!==n?n:B,B}function D(n=P,t=_){const r=k;return t>e.InternalLoggerLevel.OFF&&(r.error=t>=e.InternalLoggerLevel.ERROR?function(...e){n.error(`${r.prefix}\n`,...e)}:T,r.warn=t>=e.InternalLoggerLevel.WARN?function(...e){n.warn(`${r.prefix}\n`,...e)}:T,r.info=t>=e.InternalLoggerLevel.INFO?function(...e){n.info(`${r.prefix}\n`,...e)}:T,r.debug=t>=e.InternalLoggerLevel.VERBOSE?function(...e){n.debug(`${r.prefix}\n`,...e)}:T),r}let M=k;function V(e,n){return M=D(e,n.internalLoggerLevel),M}class ${constructor(){this.unpatchedConsole=P,this.internalLogger=k,this.config={},this.metas={}}logDebug(...e){this.internalLogger.debug(`${this.name}\n`,...e)}logInfo(...e){this.internalLogger.info(`${this.name}\n`,...e)}logWarn(...e){this.internalLogger.warn(`${this.name}\n`,...e)}logError(...e){this.internalLogger.error(`${this.name}\n`,...e)}}function G(e,n){var t,r;if(void 0===n)return e;if(void 0===e)return{resourceSpans:n};const i=null===(t=e.resourceSpans)||void 0===t?void 0:t[0];if(void 0===i)return e;const a=(null==i?void 0:i.scopeSpans)||[],s=(null===(r=null==n?void 0:n[0])||void 0===r?void 0:r.scopeSpans)||[];return Object.assign(Object.assign({},e),{resourceSpans:[Object.assign(Object.assign({},i),{scopeSpans:[...a,...s]})]})}const z="Error";let U;function K(e){let n=e.cause;return g(n)?n=e.cause.toString():null!==n&&(o(e.cause)||u(e.cause))?n=JSON.stringify(e.cause):null!=n&&(n=e.cause.toString()),null==n?{}:{cause:n}}const W=e=>e.map((e=>{try{return String(e)}catch(e){return""}})).join(" ");function H(n,t,r,s,o){t.debug("Initializing API");const l=function(n,t,r,i,a){let s;return t.debug("Initializing traces API"),{getOTEL:()=>s,getTraceContext:()=>{const e=null==s?void 0:s.trace.getSpanContext(s.context.active());return e?{trace_id:e.traceId,span_id:e.spanId}:void 0},initOTEL:(e,n)=>{t.debug("Initializing OpenTelemetry"),s={trace:e,context:n}},isOTELInitialized:()=>!!s,pushTraces:n=>{try{const r={type:e.TransportItemType.TRACE,payload:n,meta:i.value};t.debug("Pushing trace\n",r),a.execute(r)}catch(e){t.error("Error pushing trace\n",e)}}}}(0,t,0,s,o);return Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({},l),function(n,t,r,a,s,o){var l;t.debug("Initializing exceptions API");let u=null;U=null!==(l=r.parseStacktrace)&&void 0!==l?l:U;const c=e=>{t.debug("Changing stacktrace parser"),U=null!=e?e:U};return c(r.parseStacktrace),{changeStacktraceParser:c,getStacktraceParser:()=>U,pushError:(n,{skipDedupe:l,stackFrames:c,type:d,context:g,spanContext:p,timestampOverwriteMs:f}={})=>{d=d||n.name||z;const m={meta:a.value,payload:{type:d,value:n.message,timestamp:f?h(f):b(),trace:p?{trace_id:p.traceId,span_id:p.spanId}:o.getTraceContext(),context:Object.assign(Object.assign({},K(n)),null!=g?g:{})},type:e.TransportItemType.EXCEPTION};(null==(c=null!=c?c:n.stack?null==U?void 0:U(n).frames:void 0)?void 0:c.length)&&(m.payload.stacktrace={frames:c});const E={type:m.payload.type,value:m.payload.value,stackTrace:m.payload.stacktrace,context:m.payload.context};l||!r.dedupe||i(u)||!v(E,u)?(u=E,t.debug("Pushing exception\n",m),s.execute(m)):t.debug("Skipping error push because it is the same as the last one\n",m.payload)}}}(0,t,r,s,o,l)),function(e,n,t,r){let i,s,o,l;n.debug("Initializing meta API");const u=e=>{s&&r.remove(s),s={user:e},r.add(s)},c=(e,n)=>{const t=null==n?void 0:n.overrides;i&&r.remove(i),i={session:Object.assign(Object.assign({},m(e)?void 0:e),t?{overrides:t}:{})},r.add(i)},d=()=>r.value.session;return{setUser:u,resetUser:u,setSession:c,resetSession:c,getSession:d,setView:(e,n)=>{var t;if((null==n?void 0:n.overrides)&&c(d(),{overrides:n.overrides}),(null===(t=null==o?void 0:o.view)||void 0===t?void 0:t.name)===(null==e?void 0:e.name))return;const i=o;o={view:e},r.add(o),i&&r.remove(i)},getView:()=>r.value.view,setPage:e=>{const n=a(e)?Object.assign(Object.assign({},null==l?void 0:l.page),{id:e}):e;l&&r.remove(l),l={page:n},r.add(l)},getPage:()=>r.value.page}}(0,t,0,s)),function(n,t,r,a,s,o){var l;t.debug("Initializing logs API");let u=null;const c=null!==(l=r.logArgsSerializer)&&void 0!==l?l:W;return{pushLog:(n,{context:l,level:d,skipDedupe:g,spanContext:p,timestampOverwriteMs:f}={})=>{try{const m={type:e.TransportItemType.LOG,payload:{message:c(n),level:null!=d?d:y,context:null!=l?l:{},timestamp:f?h(f):b(),trace:p?{trace_id:p.traceId,span_id:p.spanId}:o.getTraceContext()},meta:a.value},E={message:m.payload.message,level:m.payload.level,context:m.payload.context};if(!g&&r.dedupe&&!i(u)&&v(E,u))return void t.debug("Skipping log push because it is the same as the last one\n",m.payload);u=E,t.debug("Pushing log\n",m),s.execute(m)}catch(e){t.error("Error pushing log\n",e)}}}}(0,t,r,s,o,l)),function(n,t,r,a,s,o){t.debug("Initializing measurements API");let l=null;return{pushMeasurement:(n,{skipDedupe:u,context:c,spanContext:d,timestampOverwriteMs:g}={})=>{try{const p={type:e.TransportItemType.MEASUREMENT,payload:Object.assign(Object.assign({},n),{trace:d?{trace_id:d.traceId,span_id:d.spanId}:o.getTraceContext(),timestamp:g?h(g):b(),context:null!=c?c:{}}),meta:a.value},f={type:p.payload.type,values:p.payload.values,context:p.payload.context};if(!u&&r.dedupe&&!i(l)&&v(f,l))return void t.debug("Skipping measurement push because it is the same as the last one\n",p.payload);l=f,t.debug("Pushing measurement\n",p),s.execute(p)}catch(e){t.error("Error pushing measurement\n",e)}}}}(0,t,r,s,o,l)),function(n,t,r,a,s,o){let l=null;return{pushEvent:(n,u,c,{skipDedupe:d,spanContext:g,timestampOverwriteMs:p}={})=>{try{const f={meta:a.value,payload:{name:n,domain:null!=c?c:r.eventDomain,attributes:u,timestamp:p?h(p):b(),trace:g?{trace_id:g.traceId,span_id:g.spanId}:o.getTraceContext()},type:e.TransportItemType.EVENT},m={name:f.payload.name,attributes:f.payload.attributes,domain:f.payload.domain};if(!d&&r.dedupe&&!i(l)&&v(m,l))return void t.debug("Skipping event push because it is the same as the last one\n",f.payload);l=m,t.debug("Pushing event\n",f),s.execute(f)}catch(e){t.error("Error pushing event",e)}}}}(0,t,r,s,o,l))}const X="1.13.0";const J="_faroInternal";function q(e){e.config.isolate?e.internalLogger.debug("Skipping registering internal Faro instance on global object"):(e.internalLogger.debug("Registering internal Faro instance on global object"),Object.defineProperty(L,J,{configurable:!1,enumerable:!1,writable:!1,value:e}))}function Q(){return J in L}function Y(n,t,r,i,a,s,o){return t.debug("Initializing Faro"),e.faro={api:s,config:r,instrumentations:o,internalLogger:t,metas:i,pause:a.pause,transports:a,unpatchedConsole:n,unpause:a.unpause},q(e.faro),function(e){if(e.config.preventGlobalExposure)e.internalLogger.debug("Skipping registering public Faro instance in the global scope");else{if(e.internalLogger.debug(`Registering public faro reference in the global scope using "${e.config.globalObjectKey}" key`),e.config.globalObjectKey in L)return void e.internalLogger.warn(`Skipping global registration due to key "${e.config.globalObjectKey}" being used already. Please set "globalObjectKey" to something else or set "preventGlobalExposure" to "true"`);Object.defineProperty(L,e.config.globalObjectKey,{configurable:!1,writable:!1,value:e})}}(e.faro),e.faro}e.faro={};return e.BaseExtension=$,e.BaseInstrumentation=class extends ${constructor(){super(...arguments),this.api={},this.transports={}}},e.BaseTransport=class extends ${isBatched(){return!1}getIgnoreUrls(){return[]}},e.Conventions={EventNames:{CLICK:"click",NAVIGATION:"navigation",SESSION_START:"session_start",VIEW_CHANGED:"view_changed"}},e.EVENT_CLICK="click",e.EVENT_NAVIGATION="navigation",e.EVENT_OVERRIDES_SERVICE_NAME="service_name_override",e.EVENT_ROUTE_CHANGE="route_change",e.EVENT_SESSION_EXTEND="session_extend",e.EVENT_SESSION_RESUME="session_resume",e.EVENT_SESSION_START="session_start",e.EVENT_VIEW_CHANGED="view_changed",e.VERSION=X,e.allLogLevels=I,e.createInternalLogger=D,e.createPromiseBuffer=function(e){const{size:n,concurrency:t}=e,r=[];let i=0;const a=()=>{if(i<t&&r.length){const{producer:e,resolve:n,reject:t}=r.shift();i++,e().then((e=>{i--,a(),n(e)}),(e=>{i--,a(),t(e)}))}};return{add:e=>{if(r.length+i>=n)throw new Error("Task buffer full");return new Promise(((n,t)=>{r.push({producer:e,resolve:n,reject:t}),a()}))}}},e.dateNow=function(){return Date.now()},e.deepEqual=v,e.defaultBatchingConfig={enabled:!0,sendTimeout:250,itemLimit:50},e.defaultErrorArgsSerializer=e=>e.map((e=>o(e)?N(e):String(e))).join(" "),e.defaultExceptionType=z,e.defaultGlobalObjectKey="faro",e.defaultInternalLoggerLevel=_,e.defaultLogArgsSerializer=W,e.defaultLogLevel=y,e.defaultUnpatchedConsole=P,e.genShortID=function(e=10){return Array.from(Array(e)).map((()=>O[Math.floor(59*Math.random())])).join("")},e.getCircularDependencyReplacer=S,e.getCurrentTimestamp=b,e.getInternalFaroFromGlobalObject=function(){return L[J]},e.getTransportBody=function(n){let t={meta:{}};return void 0!==n[0]&&(t.meta=n[0].meta),n.forEach((n=>{switch(n.type){case e.TransportItemType.LOG:case e.TransportItemType.EVENT:case e.TransportItemType.EXCEPTION:case e.TransportItemType.MEASUREMENT:const r=x[n.type],i=t[r];t=Object.assign(Object.assign({},t),{[r]:void 0===i?[n.payload]:[...i,n.payload]});break;case e.TransportItemType.TRACE:t=Object.assign(Object.assign({},t),{traces:G(t.traces,n.payload.resourceSpans)})}})),t},e.globalObject=L,e.initializeFaro=function(e){const n=F(e),t=V(n,e);if(Q()&&!e.isolate)return void t.error('Faro is already registered. Either add instrumentations, transports etc. to the global faro instance or use the "isolate" property');t.debug("Initializing");const r=function(e,n){let t=[],r=[];const i=()=>t.reduce(((e,n)=>Object.assign(e,l(n)?n():n)),{}),a=()=>{if(r.length){const e=i();r.forEach((n=>n(e)))}};return{add:(...e)=>{n.debug("Adding metas\n",e),t.push(...e),a()},remove:(...e)=>{n.debug("Removing metas\n",e),t=t.filter((n=>!e.includes(n))),a()},addListener:e=>{n.debug("Adding metas listener\n",e),r.push(e)},removeListener:e=>{n.debug("Removing metas listener\n",e),r=r.filter((n=>n!==e))},get value(){return i()}}}(0,t),i=w(n,t,e,r),a=H(0,t,e,r,i),s=function(e,n,t,r,i,a){n.debug("Initializing instrumentations");const s=[];return{add:(...o)=>{n.debug("Adding instrumentations"),o.forEach((o=>{n.debug(`Adding "${o.name}" instrumentation`),s.some((e=>e.name===o.name))?n.warn(`Instrumentation ${o.name} is already added`):(o.unpatchedConsole=e,o.internalLogger=n,o.config=t,o.metas=r,o.transports=i,o.api=a,s.push(o),o.initialize())}))},get instrumentations(){return[...s]},remove:(...e)=>{n.debug("Removing instrumentations"),e.forEach((e=>{var t,r;n.debug(`Removing "${e.name}" instrumentation`);const i=s.reduce(((n,t,r)=>null===n&&t.name===e.name?r:null),null);i?(null===(r=(t=s[i]).destroy)||void 0===r||r.call(t),s.splice(i,1)):n.warn(`Instrumentation "${e.name}" is not added`)}))}}}(n,t,e,r,i,a),o=Y(n,t,e,r,i,a,s);return function(e){var n,t;const r={sdk:{version:X},app:{bundleId:e.config.app.name&&(i=e.config.app.name,null==L?void 0:L[`__faroBundleId_${i}`])}};var i;const a=null===(n=e.config.sessionTracking)||void 0===n?void 0:n.session;a&&e.api.setSession(a),e.config.app&&(r.app=Object.assign(Object.assign({},e.config.app),r.app)),e.config.user&&(r.user=e.config.user),e.config.view&&(r.view=e.config.view),e.metas.add(r,...null!==(t=e.config.metas)&&void 0!==t?t:[])}(o),function(e){e.transports.add(...e.config.transports),e.transports.addBeforeSendHooks(e.config.beforeSend),e.transports.addIgnoreErrorsPatterns(e.config.ignoreErrors)}(o),function(e){e.instrumentations.add(...e.config.instrumentations)}(o),o},e.internalGlobalObjectKey=J,e.isArray=u,e.isBoolean=e=>n(e,"boolean"),e.isDomError=e=>t(e,"DOMError"),e.isDomException=e=>t(e,"DOMException"),e.isElement=e=>p&&r(e,Element),e.isElementDefined=p,e.isEmpty=m,e.isError=g,e.isErrorDefined=d,e.isErrorEvent=e=>t(e,"ErrorEvent"),e.isEvent=e=>c&&r(e,Event),e.isEventDefined=c,e.isFunction=l,e.isInstanceOf=r,e.isInt=e=>s(e)&&Number.isInteger(e),e.isInternalFaroOnGlobalObject=Q,e.isMap=e=>f&&r(e,Map),e.isMapDefined=f,e.isNull=i,e.isNumber=s,e.isObject=o,e.isPrimitive=e=>!o(e)&&!l(e),e.isRegExp=e=>t(e,"RegExp"),e.isString=a,e.isSymbol=e=>n(e,"symbol"),e.isSyntheticEvent=e=>o(e)&&"nativeEvent"in e&&"preventDefault"in e&&"stopPropagation"in e,e.isThenable=e=>l(null==e?void 0:e.then),e.isToString=t,e.isTypeof=n,e.isUndefined=e=>n(e,"undefined"),e.noop=T,e.setInternalFaroOnGlobalObject=q,e.stringifyExternalJson=N,e.transportItemTypeToBodyKey=x,e.unknownString="unknown",e}({});

dist/bundle/types/api/exceptions/const.d.ts

 export declare const defaultExceptionType = "Error";
+export declare const defaultErrorArgsSerializer: (args: [any?, ...any[]]) => string;

dist/bundle/types/api/exceptions/index.d.ts

@@ -1,3 +0,3 @@
-export { defaultExceptionType } from './const';
+export { defaultExceptionType, defaultErrorArgsSerializer } from './const';
 export { initializeExceptionsAPI } from './initialize';
 export type { ExceptionEvent, ExceptionStackFrame, ExceptionsAPI, ExtendedError, PushErrorOptions, Stacktrace, StacktraceParser, ErrorWithIndexProperties, } from './types';

dist/bundle/types/api/index.d.ts

 export { initializeAPI } from './initialize';
 export type { API, APIEvent } from './types';
 export type { EventAttributes, EventEvent, EventsAPI, PushEventOptions } from './events';
-export { defaultExceptionType } from './exceptions';
+export { defaultExceptionType, defaultErrorArgsSerializer } from './exceptions';
 export type { ExceptionEvent, ExceptionStackFrame, ExceptionsAPI, ExtendedError, PushErrorOptions, Stacktrace, StacktraceParser, } from './exceptions';
@@ -6,0 +6,0 @@ export { defaultLogArgsSerializer } from './logs';

dist/bundle/types/api/meta/types.d.ts

@@ -1,10 +0,20 @@
-import type { MetaSession, MetaUser, MetaView } from '../../metas';
+import type { MetaOverrides, MetaPage, MetaSession, MetaUser, MetaView } from '../../metas';
 export interface MetaAPI {
     setUser: (user?: MetaUser | undefined) => void;
     resetUser: () => void;
-    setSession: (session?: MetaSession | undefined) => void;
+    setSession: (session?: MetaSession | undefined, options?: {
+        overrides: MetaOverrides;
+    }) => void;
     resetSession: () => void;
     getSession: () => MetaSession | undefined;
-    setView: (view?: MetaView | undefined) => void;
+    setView: (view?: MetaView | undefined, options?: {
+        overrides: MetaOverrides;
+    }) => void;
     getView: () => MetaView | undefined;
+    /**
+     * If a string is provided, it will be used as the page id.
+     * @returns
+     */
+    setPage: (page?: MetaPage | string | undefined) => void;
+    getPage: () => MetaPage | undefined;
 }

dist/bundle/types/config/types.d.ts

 import type { APIEvent, LogArgsSerializer, StacktraceParser } from '../api';
 import type { Instrumentation } from '../instrumentations';
 import type { InternalLoggerLevel } from '../internalLogger';
-import type { Meta, MetaApp, MetaItem, MetaSession, MetaUser, MetaView } from '../metas';
+import type { Meta, MetaApp, MetaItem, MetaPage, MetaSession, MetaUser, MetaView } from '../metas';
 import type { BatchExecutorOptions, BeforeSendHook, Transport } from '../transports';
@@ -154,5 +154,25 @@ import type { UnpatchedConsole } from '../unpatchedConsole';
         consoleErrorAsLog?: boolean;
+        /**
+         * If true, use the default Faro error serializer for console.error calls. If false, simply call toString() on the error arguments.
+         * If enabled, payloads containing serialized errors may become very large. If left disabled, some error details may be lost.
+         * (default: false)
+         */
+        serializeErrors?: boolean;
+        /**
+         * Custom function to serialize Error arguments
+         */
+        errorSerializer?: LogArgsSerializer;
     };
+    pageTracking?: {
+        /**
+         * The page meta for initial page settings
+         */
+        page?: MetaPage;
+        /**
+         * Allows to provide a template for the page id
+         */
+        generatePageId?: (location: Location) => string;
+    };
 }
 export type Patterns = Array<string | RegExp>;
 export {};

dist/bundle/types/index.d.ts

@@ -1,2 +0,2 @@
-export { defaultExceptionType, defaultLogArgsSerializer } from './api';
+export { defaultExceptionType, defaultLogArgsSerializer, defaultErrorArgsSerializer } from './api';
 export type { API, APIEvent, EventAttributes, EventEvent, EventsAPI, ExceptionEvent, ExceptionStackFrame, ExceptionsAPI, ExtendedError, LogArgsSerializer, LogContext, LogEvent, LogsAPI, MeasurementEvent, MeasurementsAPI, MetaAPI, OTELApi, PushErrorOptions, PushEventOptions, PushLogOptions, PushMeasurementOptions, Stacktrace, StacktraceParser, TraceContext, TraceEvent, TracesAPI, } from './api';
@@ -14,3 +14,3 @@ export { BaseExtension } from './extensions';
 export type { InternalLogger } from './internalLogger';
-export type { Meta, MetaApp, MetaAttributes, MetaBrowser, MetaGetter, MetaItem, MetaPage, Metas, MetaSDK, MetaSDKIntegration, MetaSession, MetaUser, MetaView, } from './metas';
+export type { Meta, MetaApp, MetaAttributes, MetaBrowser, MetaGetter, MetaItem, MetaPage, Metas, MetaSDK, MetaSDKIntegration, MetaSession, MetaUser, MetaView, MetaOverrides, } from './metas';
 export { faro, getInternalFaroFromGlobalObject, internalGlobalObjectKey, isInternalFaroOnGlobalObject, setInternalFaroOnGlobalObject, } from './sdk';
@@ -23,5 +23,5 @@ export type { Faro } from './sdk';
 export type { UnpatchedConsole } from './unpatchedConsole';
-export { allLogLevels, createPromiseBuffer, deepEqual, defaultLogLevel, genShortID, getCurrentTimestamp, isArray, isBoolean, isDomError, isDomException, isElement, isElementDefined, isError, isErrorDefined, isErrorEvent, isEvent, isEventDefined, isFunction, isInstanceOf, isInt, isMap, isMapDefined, isNull, isNumber, isObject, isPrimitive, isRegExp, isString, isSymbol, isSyntheticEvent, isThenable, isToString, isTypeof, isUndefined, LogLevel, noop, dateNow, } from './utils';
+export { allLogLevels, createPromiseBuffer, deepEqual, defaultLogLevel, genShortID, getCurrentTimestamp, isArray, isBoolean, isDomError, isDomException, isElement, isElementDefined, isError, isErrorDefined, isErrorEvent, isEvent, isEventDefined, isFunction, isInstanceOf, isInt, isMap, isMapDefined, isNull, isNumber, isObject, isPrimitive, isRegExp, isString, isSymbol, isSyntheticEvent, isThenable, isToString, isTypeof, isUndefined, LogLevel, noop, dateNow, isEmpty, getCircularDependencyReplacer, stringifyExternalJson, } from './utils';
 export type { BaseObject, BaseObjectKey, BaseObjectPrimitiveValue, BaseObjectValue, BufferItem, PromiseBuffer, PromiseBufferOptions, PromiseProducer, } from './utils';
 export { VERSION } from './version';
 export { unknownString } from './consts';

dist/bundle/types/metas/index.d.ts

 export { initializeMetas } from './initialize';
 export { registerInitialMetas } from './registerInitial';
-export type { Meta, MetaApp, MetaAttributes, MetaBrowser, MetaGetter, MetaItem, MetaK6, MetaPage, MetaSDK, MetaSDKIntegration, MetaSession, MetaUser, MetaView, Metas, } from './types';
+export type { Meta, MetaApp, MetaAttributes, MetaBrowser, MetaGetter, MetaItem, MetaK6, MetaPage, MetaSDK, MetaSDKIntegration, MetaSession, MetaUser, MetaView, Metas, MetaOverrides, } from './types';

dist/bundle/types/metas/types.d.ts

@@ -38,2 +38,3 @@ export type MetaGetter<P = Partial<Meta>> = () => P;
     attributes?: MetaAttributes;
+    overrides?: MetaOverrides;
 }
@@ -77,2 +78,8 @@ export interface MetaPage {
 }
+/**
+ * Overrides are instructions that allow the receiver to override certain properties.
+ */
+export type MetaOverrides = {
+    serviceName?: string;
+};
 export {};

dist/bundle/types/semantic.d.ts

@@ -21,2 +21,3 @@ /**
 export declare const EVENT_SESSION_EXTEND = "session_extend";
+export declare const EVENT_OVERRIDES_SERVICE_NAME = "service_name_override";
 export declare const EVENT_ROUTE_CHANGE = "route_change";

dist/bundle/types/testUtils/mockTransport.d.ts

@@ -7,3 +7,3 @@ import type { Patterns } from '../config';
     readonly name = "@grafana/transport-mock";
-    readonly version = "1.12.3";
+    readonly version = "1.13.0";
     items: TransportItem[];
@@ -10,0 +10,0 @@ constructor(ignoreURLs?: Patterns);

dist/bundle/types/utils/index.d.ts

 export type { BaseObject, BaseObjectKey, BaseObjectPrimitiveValue, BaseObjectValue } from './baseObject';
 export { deepEqual } from './deepEqual';
 export { getCurrentTimestamp } from './date';
-export { isArray, isBoolean, isDomError, isDomException, isElement, isElementDefined, isError, isErrorDefined, isErrorEvent, isEvent, isEventDefined, isFunction, isInstanceOf, isInt, isMap, isMapDefined, isNull, isNumber, isObject, isPrimitive, isRegExp, isString, isSymbol, isSyntheticEvent, isThenable, isToString, isTypeof, isUndefined, } from './is';
+export { isArray, isBoolean, isDomError, isDomException, isElement, isElementDefined, isError, isErrorDefined, isErrorEvent, isEvent, isEventDefined, isFunction, isInstanceOf, isInt, isMap, isMapDefined, isNull, isNumber, isObject, isPrimitive, isRegExp, isString, isSymbol, isSyntheticEvent, isThenable, isToString, isTypeof, isUndefined, isEmpty, } from './is';
 export type { IsFnHelper } from './is';
@@ -13,1 +13,2 @@ export { allLogLevels, defaultLogLevel, LogLevel } from './logLevels';
 export { dateNow } from './date';
+export { getCircularDependencyReplacer, stringifyExternalJson } from './json';

dist/bundle/types/utils/is.d.ts

@@ -32,1 +32,2 @@ export type IsFnHelper<T = unknown> = (value: unknown) => value is T;
 export declare const isSyntheticEvent: IsFnHelper<Event>;
+export declare function isEmpty(value: any): boolean;

dist/bundle/types/version.d.ts

@@ -1,1 +0,1 @@
-export declare const VERSION = "1.12.3";
+export declare const VERSION = "1.13.0";

dist/cjs/api/exceptions/const.js

 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.defaultExceptionType = void 0;
+exports.defaultErrorArgsSerializer = exports.defaultExceptionType = void 0;
+var utils_1 = require("../../utils");
 exports.defaultExceptionType = 'Error';
+var defaultErrorArgsSerializer = function (args) {
+    return args
+        .map(function (arg) {
+        if ((0, utils_1.isObject)(arg)) {
+            return (0, utils_1.stringifyExternalJson)(arg);
+        }
+        return String(arg);
+    })
+        .join(' ');
+};
+exports.defaultErrorArgsSerializer = defaultErrorArgsSerializer;
 //# sourceMappingURL=const.js.map

dist/cjs/api/exceptions/index.js

 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.initializeExceptionsAPI = exports.defaultExceptionType = void 0;
+exports.initializeExceptionsAPI = exports.defaultErrorArgsSerializer = exports.defaultExceptionType = void 0;
 var const_1 = require("./const");
 Object.defineProperty(exports, "defaultExceptionType", { enumerable: true, get: function () { return const_1.defaultExceptionType; } });
+Object.defineProperty(exports, "defaultErrorArgsSerializer", { enumerable: true, get: function () { return const_1.defaultErrorArgsSerializer; } });
 var initialize_1 = require("./initialize");
 Object.defineProperty(exports, "initializeExceptionsAPI", { enumerable: true, get: function () { return initialize_1.initializeExceptionsAPI; } });
 //# sourceMappingURL=index.js.map

dist/cjs/api/index.js

 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.defaultLogArgsSerializer = exports.defaultExceptionType = exports.initializeAPI = void 0;
+exports.defaultLogArgsSerializer = exports.defaultErrorArgsSerializer = exports.defaultExceptionType = exports.initializeAPI = void 0;
 var initialize_1 = require("./initialize");
@@ -8,4 +8,5 @@ Object.defineProperty(exports, "initializeAPI", { enumerable: true, get: function () { return initialize_1.initializeAPI; } });
 Object.defineProperty(exports, "defaultExceptionType", { enumerable: true, get: function () { return exceptions_1.defaultExceptionType; } });
+Object.defineProperty(exports, "defaultErrorArgsSerializer", { enumerable: true, get: function () { return exceptions_1.defaultErrorArgsSerializer; } });
 var logs_1 = require("./logs");
 Object.defineProperty(exports, "defaultLogArgsSerializer", { enumerable: true, get: function () { return logs_1.defaultLogArgsSerializer; } });
 //# sourceMappingURL=index.js.map

dist/cjs/api/meta/initialize.js

 "use strict";
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.initializeMetaAPI = void 0;
+var is_1 = require("../../utils/is");
 function initializeMetaAPI(_unpatchedConsole, internalLogger, _config, metas, _transports) {
@@ -9,2 +21,3 @@ internalLogger.debug('Initializing meta API');
     var metaView = undefined;
+    var metaPage = undefined;
     var setUser = function (user) {
@@ -19,3 +32,4 @@ if (metaUser) {
     };
-    var setSession = function (session) {
+    var setSession = function (session, options) {
+        var overrides = options === null || options === void 0 ? void 0 : options.overrides;
         if (metaSession) {
@@ -25,3 +39,3 @@ metas.remove(metaSession);
         metaSession = {
-            session: session,
+            session: __assign(__assign({}, ((0, is_1.isEmpty)(session) ? undefined : session)), (overrides ? { overrides: overrides } : {})),
         };
@@ -31,4 +45,7 @@ metas.add(metaSession);
     var getSession = function () { return metas.value.session; };
-    var setView = function (view) {
+    var setView = function (view, options) {
         var _a;
+        if (options === null || options === void 0 ? void 0 : options.overrides) {
+            setSession(getSession(), { overrides: options.overrides });
+        }
         if (((_a = metaView === null || metaView === void 0 ? void 0 : metaView.view) === null || _a === void 0 ? void 0 : _a.name) === (view === null || view === void 0 ? void 0 : view.name)) {
@@ -47,2 +64,14 @@ return;
     var getView = function () { return metas.value.view; };
+    var setPage = function (page) {
+        var pageMeta = (0, is_1.isString)(page)
+            ? __assign(__assign({}, metaPage === null || metaPage === void 0 ? void 0 : metaPage.page), { id: page }) : page;
+        if (metaPage) {
+            metas.remove(metaPage);
+        }
+        metaPage = {
+            page: pageMeta,
+        };
+        metas.add(metaPage);
+    };
+    var getPage = function () { return metas.value.page; };
     return {
@@ -56,2 +85,4 @@ setUser: setUser,
         getView: getView,
+        setPage: setPage,
+        getPage: getPage,
     };
@@ -58,0 +89,0 @@ }

dist/cjs/index.js

@@ -17,7 +17,8 @@ "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isSymbol = exports.isString = exports.isRegExp = exports.isPrimitive = exports.isObject = exports.isNumber = exports.isNull = exports.isMapDefined = exports.isMap = exports.isInt = exports.isInstanceOf = exports.isFunction = exports.isEventDefined = exports.isEvent = exports.isErrorEvent = exports.isErrorDefined = exports.isError = exports.isElementDefined = exports.isElement = exports.isDomException = exports.isDomError = exports.isBoolean = exports.isArray = exports.getCurrentTimestamp = exports.genShortID = exports.defaultLogLevel = exports.deepEqual = exports.createPromiseBuffer = exports.allLogLevels = exports.defaultUnpatchedConsole = exports.transportItemTypeToBodyKey = exports.TransportItemType = exports.getTransportBody = exports.BaseTransport = exports.setInternalFaroOnGlobalObject = exports.isInternalFaroOnGlobalObject = exports.internalGlobalObjectKey = exports.getInternalFaroFromGlobalObject = exports.faro = exports.InternalLoggerLevel = exports.defaultInternalLoggerLevel = exports.createInternalLogger = exports.BaseInstrumentation = exports.defaultGlobalObjectKey = exports.defaultBatchingConfig = exports.initializeFaro = exports.globalObject = exports.BaseExtension = exports.defaultLogArgsSerializer = exports.defaultExceptionType = void 0;
-exports.unknownString = exports.VERSION = exports.dateNow = exports.noop = exports.LogLevel = exports.isUndefined = exports.isTypeof = exports.isToString = exports.isThenable = exports.isSyntheticEvent = void 0;
+exports.isString = exports.isRegExp = exports.isPrimitive = exports.isObject = exports.isNumber = exports.isNull = exports.isMapDefined = exports.isMap = exports.isInt = exports.isInstanceOf = exports.isFunction = exports.isEventDefined = exports.isEvent = exports.isErrorEvent = exports.isErrorDefined = exports.isError = exports.isElementDefined = exports.isElement = exports.isDomException = exports.isDomError = exports.isBoolean = exports.isArray = exports.getCurrentTimestamp = exports.genShortID = exports.defaultLogLevel = exports.deepEqual = exports.createPromiseBuffer = exports.allLogLevels = exports.defaultUnpatchedConsole = exports.transportItemTypeToBodyKey = exports.TransportItemType = exports.getTransportBody = exports.BaseTransport = exports.setInternalFaroOnGlobalObject = exports.isInternalFaroOnGlobalObject = exports.internalGlobalObjectKey = exports.getInternalFaroFromGlobalObject = exports.faro = exports.InternalLoggerLevel = exports.defaultInternalLoggerLevel = exports.createInternalLogger = exports.BaseInstrumentation = exports.defaultGlobalObjectKey = exports.defaultBatchingConfig = exports.initializeFaro = exports.globalObject = exports.BaseExtension = exports.defaultErrorArgsSerializer = exports.defaultLogArgsSerializer = exports.defaultExceptionType = void 0;
+exports.unknownString = exports.VERSION = exports.stringifyExternalJson = exports.getCircularDependencyReplacer = exports.isEmpty = exports.dateNow = exports.noop = exports.LogLevel = exports.isUndefined = exports.isTypeof = exports.isToString = exports.isThenable = exports.isSyntheticEvent = exports.isSymbol = void 0;
 var api_1 = require("./api");
 Object.defineProperty(exports, "defaultExceptionType", { enumerable: true, get: function () { return api_1.defaultExceptionType; } });
 Object.defineProperty(exports, "defaultLogArgsSerializer", { enumerable: true, get: function () { return api_1.defaultLogArgsSerializer; } });
+Object.defineProperty(exports, "defaultErrorArgsSerializer", { enumerable: true, get: function () { return api_1.defaultErrorArgsSerializer; } });
 var extensions_1 = require("./extensions");
@@ -90,2 +91,5 @@ Object.defineProperty(exports, "BaseExtension", { enumerable: true, get: function () { return extensions_1.BaseExtension; } });
 Object.defineProperty(exports, "dateNow", { enumerable: true, get: function () { return utils_1.dateNow; } });
+Object.defineProperty(exports, "isEmpty", { enumerable: true, get: function () { return utils_1.isEmpty; } });
+Object.defineProperty(exports, "getCircularDependencyReplacer", { enumerable: true, get: function () { return utils_1.getCircularDependencyReplacer; } });
+Object.defineProperty(exports, "stringifyExternalJson", { enumerable: true, get: function () { return utils_1.stringifyExternalJson; } });
 var version_1 = require("./version");
@@ -92,0 +96,0 @@ Object.defineProperty(exports, "VERSION", { enumerable: true, get: function () { return version_1.VERSION; } });

dist/cjs/semantic.js

 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.EVENT_ROUTE_CHANGE = exports.EVENT_SESSION_EXTEND = exports.EVENT_SESSION_RESUME = exports.EVENT_SESSION_START = exports.EVENT_VIEW_CHANGED = exports.EVENT_NAVIGATION = exports.EVENT_CLICK = exports.Conventions = void 0;
+exports.EVENT_ROUTE_CHANGE = exports.EVENT_OVERRIDES_SERVICE_NAME = exports.EVENT_SESSION_EXTEND = exports.EVENT_SESSION_RESUME = exports.EVENT_SESSION_START = exports.EVENT_VIEW_CHANGED = exports.EVENT_NAVIGATION = exports.EVENT_CLICK = exports.Conventions = void 0;
 /**
@@ -24,3 +24,4 @@ * @deprecated The conventions object will be removed in a future version
 exports.EVENT_SESSION_EXTEND = 'session_extend';
+exports.EVENT_OVERRIDES_SERVICE_NAME = 'service_name_override';
 exports.EVENT_ROUTE_CHANGE = 'route_change';
 //# sourceMappingURL=semantic.js.map

dist/cjs/utils/index.js

 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.dateNow = exports.getBundleId = exports.genShortID = exports.createPromiseBuffer = exports.noop = exports.LogLevel = exports.defaultLogLevel = exports.allLogLevels = exports.isUndefined = exports.isTypeof = exports.isToString = exports.isThenable = exports.isSyntheticEvent = exports.isSymbol = exports.isString = exports.isRegExp = exports.isPrimitive = exports.isObject = exports.isNumber = exports.isNull = exports.isMapDefined = exports.isMap = exports.isInt = exports.isInstanceOf = exports.isFunction = exports.isEventDefined = exports.isEvent = exports.isErrorEvent = exports.isErrorDefined = exports.isError = exports.isElementDefined = exports.isElement = exports.isDomException = exports.isDomError = exports.isBoolean = exports.isArray = exports.getCurrentTimestamp = exports.deepEqual = void 0;
+exports.stringifyExternalJson = exports.getCircularDependencyReplacer = exports.dateNow = exports.getBundleId = exports.genShortID = exports.createPromiseBuffer = exports.noop = exports.LogLevel = exports.defaultLogLevel = exports.allLogLevels = exports.isEmpty = exports.isUndefined = exports.isTypeof = exports.isToString = exports.isThenable = exports.isSyntheticEvent = exports.isSymbol = exports.isString = exports.isRegExp = exports.isPrimitive = exports.isObject = exports.isNumber = exports.isNull = exports.isMapDefined = exports.isMap = exports.isInt = exports.isInstanceOf = exports.isFunction = exports.isEventDefined = exports.isEvent = exports.isErrorEvent = exports.isErrorDefined = exports.isError = exports.isElementDefined = exports.isElement = exports.isDomException = exports.isDomError = exports.isBoolean = exports.isArray = exports.getCurrentTimestamp = exports.deepEqual = void 0;
 var deepEqual_1 = require("./deepEqual");
@@ -37,2 +37,3 @@ Object.defineProperty(exports, "deepEqual", { enumerable: true, get: function () { return deepEqual_1.deepEqual; } });
 Object.defineProperty(exports, "isUndefined", { enumerable: true, get: function () { return is_1.isUndefined; } });
+Object.defineProperty(exports, "isEmpty", { enumerable: true, get: function () { return is_1.isEmpty; } });
 var logLevels_1 = require("./logLevels");
@@ -52,2 +53,5 @@ Object.defineProperty(exports, "allLogLevels", { enumerable: true, get: function () { return logLevels_1.allLogLevels; } });
 Object.defineProperty(exports, "dateNow", { enumerable: true, get: function () { return date_2.dateNow; } });
+var json_1 = require("./json");
+Object.defineProperty(exports, "getCircularDependencyReplacer", { enumerable: true, get: function () { return json_1.getCircularDependencyReplacer; } });
+Object.defineProperty(exports, "stringifyExternalJson", { enumerable: true, get: function () { return json_1.stringifyExternalJson; } });
 //# sourceMappingURL=index.js.map

dist/cjs/utils/is.js

 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isSyntheticEvent = exports.isMap = exports.isMapDefined = exports.isElement = exports.isElementDefined = exports.isDomException = exports.isDomError = exports.isErrorEvent = exports.isError = exports.isErrorDefined = exports.isEvent = exports.isEventDefined = exports.isPrimitive = exports.isThenable = exports.isRegExp = exports.isArray = exports.isFunction = exports.isObject = exports.isSymbol = exports.isBoolean = exports.isInt = exports.isNumber = exports.isString = exports.isNull = exports.isUndefined = exports.isInstanceOf = exports.isToString = exports.isTypeof = void 0;
+exports.isEmpty = exports.isSyntheticEvent = exports.isMap = exports.isMapDefined = exports.isElement = exports.isElementDefined = exports.isDomException = exports.isDomError = exports.isErrorEvent = exports.isError = exports.isErrorDefined = exports.isEvent = exports.isEventDefined = exports.isPrimitive = exports.isThenable = exports.isRegExp = exports.isArray = exports.isFunction = exports.isObject = exports.isSymbol = exports.isBoolean = exports.isInt = exports.isNumber = exports.isString = exports.isNull = exports.isUndefined = exports.isInstanceOf = exports.isToString = exports.isTypeof = void 0;
 function isTypeof(value, type) {
@@ -53,2 +53,15 @@ return typeof value === type;
 });
+function isEmpty(value) {
+    if (value == null) {
+        return true;
+    }
+    if ((0, exports.isArray)(value) || (0, exports.isString)(value)) {
+        return value.length === 0;
+    }
+    if ((0, exports.isObject)(value)) {
+        return Object.keys(value).length === 0;
+    }
+    return false;
+}
+exports.isEmpty = isEmpty;
 //# sourceMappingURL=is.js.map

dist/cjs/version.js

@@ -5,3 +5,3 @@ "use strict";
 // auto-generated by bin/genVersion.ts
-exports.VERSION = '1.12.3';
+exports.VERSION = '1.13.0';
 //# sourceMappingURL=version.js.map

dist/esm/api/exceptions/const.js

@@ -0,2 +1,13 @@
+import { isObject, stringifyExternalJson } from '../../utils';
 export const defaultExceptionType = 'Error';
+export const defaultErrorArgsSerializer = (args) => {
+    return args
+        .map((arg) => {
+        if (isObject(arg)) {
+            return stringifyExternalJson(arg);
+        }
+        return String(arg);
+    })
+        .join(' ');
+};
 //# sourceMappingURL=const.js.map

dist/esm/api/exceptions/index.js

@@ -1,3 +0,3 @@
-export { defaultExceptionType } from './const';
+export { defaultExceptionType, defaultErrorArgsSerializer } from './const';
 export { initializeExceptionsAPI } from './initialize';
 //# sourceMappingURL=index.js.map

dist/esm/api/index.js

 export { initializeAPI } from './initialize';
-export { defaultExceptionType } from './exceptions';
+export { defaultExceptionType, defaultErrorArgsSerializer } from './exceptions';
 export { defaultLogArgsSerializer } from './logs';
 //# sourceMappingURL=index.js.map

dist/esm/api/meta/initialize.js

@@ -0,1 +1,2 @@
+import { isEmpty, isString } from '../../utils/is';
 export function initializeMetaAPI(_unpatchedConsole, internalLogger, _config, metas, _transports) {
@@ -6,2 +7,3 @@ internalLogger.debug('Initializing meta API');
     let metaView = undefined;
+    let metaPage = undefined;
     const setUser = (user) => {
@@ -16,3 +18,4 @@ if (metaUser) {
     };
-    const setSession = (session) => {
+    const setSession = (session, options) => {
+        const overrides = options === null || options === void 0 ? void 0 : options.overrides;
         if (metaSession) {
@@ -22,3 +25,3 @@ metas.remove(metaSession);
         metaSession = {
-            session,
+            session: Object.assign(Object.assign({}, (isEmpty(session) ? undefined : session)), (overrides ? { overrides } : {})),
         };
@@ -28,4 +31,7 @@ metas.add(metaSession);
     const getSession = () => metas.value.session;
-    const setView = (view) => {
+    const setView = (view, options) => {
         var _a;
+        if (options === null || options === void 0 ? void 0 : options.overrides) {
+            setSession(getSession(), { overrides: options.overrides });
+        }
         if (((_a = metaView === null || metaView === void 0 ? void 0 : metaView.view) === null || _a === void 0 ? void 0 : _a.name) === (view === null || view === void 0 ? void 0 : view.name)) {
@@ -44,2 +50,14 @@ return;
     const getView = () => metas.value.view;
+    const setPage = (page) => {
+        const pageMeta = isString(page)
+            ? Object.assign(Object.assign({}, metaPage === null || metaPage === void 0 ? void 0 : metaPage.page), { id: page }) : page;
+        if (metaPage) {
+            metas.remove(metaPage);
+        }
+        metaPage = {
+            page: pageMeta,
+        };
+        metas.add(metaPage);
+    };
+    const getPage = () => metas.value.page;
     return {
@@ -53,4 +71,6 @@ setUser,
         getView,
+        setPage,
+        getPage,
     };
 }
 //# sourceMappingURL=initialize.js.map

dist/esm/index.js

@@ -1,2 +0,2 @@
-export { defaultExceptionType, defaultLogArgsSerializer } from './api';
+export { defaultExceptionType, defaultLogArgsSerializer, defaultErrorArgsSerializer } from './api';
 export { BaseExtension } from './extensions';
@@ -12,5 +12,5 @@ export { globalObject } from './globalObject';
 export { defaultUnpatchedConsole } from './unpatchedConsole';
-export { allLogLevels, createPromiseBuffer, deepEqual, defaultLogLevel, genShortID, getCurrentTimestamp, isArray, isBoolean, isDomError, isDomException, isElement, isElementDefined, isError, isErrorDefined, isErrorEvent, isEvent, isEventDefined, isFunction, isInstanceOf, isInt, isMap, isMapDefined, isNull, isNumber, isObject, isPrimitive, isRegExp, isString, isSymbol, isSyntheticEvent, isThenable, isToString, isTypeof, isUndefined, LogLevel, noop, dateNow, } from './utils';
+export { allLogLevels, createPromiseBuffer, deepEqual, defaultLogLevel, genShortID, getCurrentTimestamp, isArray, isBoolean, isDomError, isDomException, isElement, isElementDefined, isError, isErrorDefined, isErrorEvent, isEvent, isEventDefined, isFunction, isInstanceOf, isInt, isMap, isMapDefined, isNull, isNumber, isObject, isPrimitive, isRegExp, isString, isSymbol, isSyntheticEvent, isThenable, isToString, isTypeof, isUndefined, LogLevel, noop, dateNow, isEmpty, getCircularDependencyReplacer, stringifyExternalJson, } from './utils';
 export { VERSION } from './version';
 export { unknownString } from './consts';
 //# sourceMappingURL=index.js.map

dist/esm/semantic.js

@@ -21,3 +21,4 @@ /**
 export const EVENT_SESSION_EXTEND = 'session_extend';
+export const EVENT_OVERRIDES_SERVICE_NAME = 'service_name_override';
 export const EVENT_ROUTE_CHANGE = 'route_change';
 //# sourceMappingURL=semantic.js.map

dist/esm/utils/index.js

 export { deepEqual } from './deepEqual';
 export { getCurrentTimestamp } from './date';
-export { isArray, isBoolean, isDomError, isDomException, isElement, isElementDefined, isError, isErrorDefined, isErrorEvent, isEvent, isEventDefined, isFunction, isInstanceOf, isInt, isMap, isMapDefined, isNull, isNumber, isObject, isPrimitive, isRegExp, isString, isSymbol, isSyntheticEvent, isThenable, isToString, isTypeof, isUndefined, } from './is';
+export { isArray, isBoolean, isDomError, isDomException, isElement, isElementDefined, isError, isErrorDefined, isErrorEvent, isEvent, isEventDefined, isFunction, isInstanceOf, isInt, isMap, isMapDefined, isNull, isNumber, isObject, isPrimitive, isRegExp, isString, isSymbol, isSyntheticEvent, isThenable, isToString, isTypeof, isUndefined, isEmpty, } from './is';
 export { allLogLevels, defaultLogLevel, LogLevel } from './logLevels';
@@ -10,2 +10,3 @@ export { noop } from './noop';
 export { dateNow } from './date';
+export { getCircularDependencyReplacer, stringifyExternalJson } from './json';
 //# sourceMappingURL=index.js.map

dist/esm/utils/is.js

@@ -43,2 +43,14 @@ export function isTypeof(value, type) {
     'stopPropagation' in value);
+export function isEmpty(value) {
+    if (value == null) {
+        return true;
+    }
+    if (isArray(value) || isString(value)) {
+        return value.length === 0;
+    }
+    if (isObject(value)) {
+        return Object.keys(value).length === 0;
+    }
+    return false;
+}
 //# sourceMappingURL=is.js.map

dist/esm/version.js

 // auto-generated by bin/genVersion.ts
-export const VERSION = '1.12.3';
+export const VERSION = '1.13.0';
 //# sourceMappingURL=version.js.map

dist/spec/core/src/api/exceptions/const.js

 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.defaultExceptionType = void 0;
+exports.defaultErrorArgsSerializer = exports.defaultExceptionType = void 0;
+var utils_1 = require("../../utils");
 exports.defaultExceptionType = 'Error';
+var defaultErrorArgsSerializer = function (args) {
+    return args
+        .map(function (arg) {
+        if ((0, utils_1.isObject)(arg)) {
+            return (0, utils_1.stringifyExternalJson)(arg);
+        }
+        return String(arg);
+    })
+        .join(' ');
+};
+exports.defaultErrorArgsSerializer = defaultErrorArgsSerializer;
 //# sourceMappingURL=const.js.map

dist/spec/core/src/api/exceptions/index.js

 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.initializeExceptionsAPI = exports.defaultExceptionType = void 0;
+exports.initializeExceptionsAPI = exports.defaultErrorArgsSerializer = exports.defaultExceptionType = void 0;
 var const_1 = require("./const");
 Object.defineProperty(exports, "defaultExceptionType", { enumerable: true, get: function () { return const_1.defaultExceptionType; } });
+Object.defineProperty(exports, "defaultErrorArgsSerializer", { enumerable: true, get: function () { return const_1.defaultErrorArgsSerializer; } });
 var initialize_1 = require("./initialize");
 Object.defineProperty(exports, "initializeExceptionsAPI", { enumerable: true, get: function () { return initialize_1.initializeExceptionsAPI; } });
 //# sourceMappingURL=index.js.map

dist/spec/core/src/api/index.js

 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.defaultLogArgsSerializer = exports.defaultExceptionType = exports.initializeAPI = void 0;
+exports.defaultLogArgsSerializer = exports.defaultErrorArgsSerializer = exports.defaultExceptionType = exports.initializeAPI = void 0;
 var initialize_1 = require("./initialize");
@@ -8,4 +8,5 @@ Object.defineProperty(exports, "initializeAPI", { enumerable: true, get: function () { return initialize_1.initializeAPI; } });
 Object.defineProperty(exports, "defaultExceptionType", { enumerable: true, get: function () { return exceptions_1.defaultExceptionType; } });
+Object.defineProperty(exports, "defaultErrorArgsSerializer", { enumerable: true, get: function () { return exceptions_1.defaultErrorArgsSerializer; } });
 var logs_1 = require("./logs");
 Object.defineProperty(exports, "defaultLogArgsSerializer", { enumerable: true, get: function () { return logs_1.defaultLogArgsSerializer; } });
 //# sourceMappingURL=index.js.map

dist/spec/core/src/api/meta/initialize.js

 "use strict";
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.initializeMetaAPI = void 0;
+var is_1 = require("../../utils/is");
 function initializeMetaAPI(_unpatchedConsole, internalLogger, _config, metas, _transports) {
@@ -9,2 +21,3 @@ internalLogger.debug('Initializing meta API');
     var metaView = undefined;
+    var metaPage = undefined;
     var setUser = function (user) {
@@ -19,3 +32,4 @@ if (metaUser) {
     };
-    var setSession = function (session) {
+    var setSession = function (session, options) {
+        var overrides = options === null || options === void 0 ? void 0 : options.overrides;
         if (metaSession) {
@@ -25,3 +39,3 @@ metas.remove(metaSession);
         metaSession = {
-            session: session,
+            session: __assign(__assign({}, ((0, is_1.isEmpty)(session) ? undefined : session)), (overrides ? { overrides: overrides } : {})),
         };
@@ -31,4 +45,7 @@ metas.add(metaSession);
     var getSession = function () { return metas.value.session; };
-    var setView = function (view) {
+    var setView = function (view, options) {
         var _a;
+        if (options === null || options === void 0 ? void 0 : options.overrides) {
+            setSession(getSession(), { overrides: options.overrides });
+        }
         if (((_a = metaView === null || metaView === void 0 ? void 0 : metaView.view) === null || _a === void 0 ? void 0 : _a.name) === (view === null || view === void 0 ? void 0 : view.name)) {
@@ -47,2 +64,14 @@ return;
     var getView = function () { return metas.value.view; };
+    var setPage = function (page) {
+        var pageMeta = (0, is_1.isString)(page)
+            ? __assign(__assign({}, metaPage === null || metaPage === void 0 ? void 0 : metaPage.page), { id: page }) : page;
+        if (metaPage) {
+            metas.remove(metaPage);
+        }
+        metaPage = {
+            page: pageMeta,
+        };
+        metas.add(metaPage);
+    };
+    var getPage = function () { return metas.value.page; };
     return {
@@ -56,2 +85,4 @@ setUser: setUser,
         getView: getView,
+        setPage: setPage,
+        getPage: getPage,
     };
@@ -58,0 +89,0 @@ }

dist/spec/core/src/index.js

@@ -17,7 +17,8 @@ "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isSymbol = exports.isString = exports.isRegExp = exports.isPrimitive = exports.isObject = exports.isNumber = exports.isNull = exports.isMapDefined = exports.isMap = exports.isInt = exports.isInstanceOf = exports.isFunction = exports.isEventDefined = exports.isEvent = exports.isErrorEvent = exports.isErrorDefined = exports.isError = exports.isElementDefined = exports.isElement = exports.isDomException = exports.isDomError = exports.isBoolean = exports.isArray = exports.getCurrentTimestamp = exports.genShortID = exports.defaultLogLevel = exports.deepEqual = exports.createPromiseBuffer = exports.allLogLevels = exports.defaultUnpatchedConsole = exports.transportItemTypeToBodyKey = exports.TransportItemType = exports.getTransportBody = exports.BaseTransport = exports.setInternalFaroOnGlobalObject = exports.isInternalFaroOnGlobalObject = exports.internalGlobalObjectKey = exports.getInternalFaroFromGlobalObject = exports.faro = exports.InternalLoggerLevel = exports.defaultInternalLoggerLevel = exports.createInternalLogger = exports.BaseInstrumentation = exports.defaultGlobalObjectKey = exports.defaultBatchingConfig = exports.initializeFaro = exports.globalObject = exports.BaseExtension = exports.defaultLogArgsSerializer = exports.defaultExceptionType = void 0;
-exports.unknownString = exports.VERSION = exports.dateNow = exports.noop = exports.LogLevel = exports.isUndefined = exports.isTypeof = exports.isToString = exports.isThenable = exports.isSyntheticEvent = void 0;
+exports.isString = exports.isRegExp = exports.isPrimitive = exports.isObject = exports.isNumber = exports.isNull = exports.isMapDefined = exports.isMap = exports.isInt = exports.isInstanceOf = exports.isFunction = exports.isEventDefined = exports.isEvent = exports.isErrorEvent = exports.isErrorDefined = exports.isError = exports.isElementDefined = exports.isElement = exports.isDomException = exports.isDomError = exports.isBoolean = exports.isArray = exports.getCurrentTimestamp = exports.genShortID = exports.defaultLogLevel = exports.deepEqual = exports.createPromiseBuffer = exports.allLogLevels = exports.defaultUnpatchedConsole = exports.transportItemTypeToBodyKey = exports.TransportItemType = exports.getTransportBody = exports.BaseTransport = exports.setInternalFaroOnGlobalObject = exports.isInternalFaroOnGlobalObject = exports.internalGlobalObjectKey = exports.getInternalFaroFromGlobalObject = exports.faro = exports.InternalLoggerLevel = exports.defaultInternalLoggerLevel = exports.createInternalLogger = exports.BaseInstrumentation = exports.defaultGlobalObjectKey = exports.defaultBatchingConfig = exports.initializeFaro = exports.globalObject = exports.BaseExtension = exports.defaultErrorArgsSerializer = exports.defaultLogArgsSerializer = exports.defaultExceptionType = void 0;
+exports.unknownString = exports.VERSION = exports.stringifyExternalJson = exports.getCircularDependencyReplacer = exports.isEmpty = exports.dateNow = exports.noop = exports.LogLevel = exports.isUndefined = exports.isTypeof = exports.isToString = exports.isThenable = exports.isSyntheticEvent = exports.isSymbol = void 0;
 var api_1 = require("./api");
 Object.defineProperty(exports, "defaultExceptionType", { enumerable: true, get: function () { return api_1.defaultExceptionType; } });
 Object.defineProperty(exports, "defaultLogArgsSerializer", { enumerable: true, get: function () { return api_1.defaultLogArgsSerializer; } });
+Object.defineProperty(exports, "defaultErrorArgsSerializer", { enumerable: true, get: function () { return api_1.defaultErrorArgsSerializer; } });
 var extensions_1 = require("./extensions");
@@ -90,2 +91,5 @@ Object.defineProperty(exports, "BaseExtension", { enumerable: true, get: function () { return extensions_1.BaseExtension; } });
 Object.defineProperty(exports, "dateNow", { enumerable: true, get: function () { return utils_1.dateNow; } });
+Object.defineProperty(exports, "isEmpty", { enumerable: true, get: function () { return utils_1.isEmpty; } });
+Object.defineProperty(exports, "getCircularDependencyReplacer", { enumerable: true, get: function () { return utils_1.getCircularDependencyReplacer; } });
+Object.defineProperty(exports, "stringifyExternalJson", { enumerable: true, get: function () { return utils_1.stringifyExternalJson; } });
 var version_1 = require("./version");
@@ -92,0 +96,0 @@ Object.defineProperty(exports, "VERSION", { enumerable: true, get: function () { return version_1.VERSION; } });

dist/spec/core/src/semantic.js

 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.EVENT_ROUTE_CHANGE = exports.EVENT_SESSION_EXTEND = exports.EVENT_SESSION_RESUME = exports.EVENT_SESSION_START = exports.EVENT_VIEW_CHANGED = exports.EVENT_NAVIGATION = exports.EVENT_CLICK = exports.Conventions = void 0;
+exports.EVENT_ROUTE_CHANGE = exports.EVENT_OVERRIDES_SERVICE_NAME = exports.EVENT_SESSION_EXTEND = exports.EVENT_SESSION_RESUME = exports.EVENT_SESSION_START = exports.EVENT_VIEW_CHANGED = exports.EVENT_NAVIGATION = exports.EVENT_CLICK = exports.Conventions = void 0;
 /**
@@ -24,3 +24,4 @@ * @deprecated The conventions object will be removed in a future version
 exports.EVENT_SESSION_EXTEND = 'session_extend';
+exports.EVENT_OVERRIDES_SERVICE_NAME = 'service_name_override';
 exports.EVENT_ROUTE_CHANGE = 'route_change';
 //# sourceMappingURL=semantic.js.map

dist/spec/core/src/utils/index.js

 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.dateNow = exports.getBundleId = exports.genShortID = exports.createPromiseBuffer = exports.noop = exports.LogLevel = exports.defaultLogLevel = exports.allLogLevels = exports.isUndefined = exports.isTypeof = exports.isToString = exports.isThenable = exports.isSyntheticEvent = exports.isSymbol = exports.isString = exports.isRegExp = exports.isPrimitive = exports.isObject = exports.isNumber = exports.isNull = exports.isMapDefined = exports.isMap = exports.isInt = exports.isInstanceOf = exports.isFunction = exports.isEventDefined = exports.isEvent = exports.isErrorEvent = exports.isErrorDefined = exports.isError = exports.isElementDefined = exports.isElement = exports.isDomException = exports.isDomError = exports.isBoolean = exports.isArray = exports.getCurrentTimestamp = exports.deepEqual = void 0;
+exports.stringifyExternalJson = exports.getCircularDependencyReplacer = exports.dateNow = exports.getBundleId = exports.genShortID = exports.createPromiseBuffer = exports.noop = exports.LogLevel = exports.defaultLogLevel = exports.allLogLevels = exports.isEmpty = exports.isUndefined = exports.isTypeof = exports.isToString = exports.isThenable = exports.isSyntheticEvent = exports.isSymbol = exports.isString = exports.isRegExp = exports.isPrimitive = exports.isObject = exports.isNumber = exports.isNull = exports.isMapDefined = exports.isMap = exports.isInt = exports.isInstanceOf = exports.isFunction = exports.isEventDefined = exports.isEvent = exports.isErrorEvent = exports.isErrorDefined = exports.isError = exports.isElementDefined = exports.isElement = exports.isDomException = exports.isDomError = exports.isBoolean = exports.isArray = exports.getCurrentTimestamp = exports.deepEqual = void 0;
 var deepEqual_1 = require("./deepEqual");
@@ -37,2 +37,3 @@ Object.defineProperty(exports, "deepEqual", { enumerable: true, get: function () { return deepEqual_1.deepEqual; } });
 Object.defineProperty(exports, "isUndefined", { enumerable: true, get: function () { return is_1.isUndefined; } });
+Object.defineProperty(exports, "isEmpty", { enumerable: true, get: function () { return is_1.isEmpty; } });
 var logLevels_1 = require("./logLevels");
@@ -52,2 +53,5 @@ Object.defineProperty(exports, "allLogLevels", { enumerable: true, get: function () { return logLevels_1.allLogLevels; } });
 Object.defineProperty(exports, "dateNow", { enumerable: true, get: function () { return date_2.dateNow; } });
+var json_1 = require("./json");
+Object.defineProperty(exports, "getCircularDependencyReplacer", { enumerable: true, get: function () { return json_1.getCircularDependencyReplacer; } });
+Object.defineProperty(exports, "stringifyExternalJson", { enumerable: true, get: function () { return json_1.stringifyExternalJson; } });
 //# sourceMappingURL=index.js.map

dist/spec/core/src/utils/is.js

 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isSyntheticEvent = exports.isMap = exports.isMapDefined = exports.isElement = exports.isElementDefined = exports.isDomException = exports.isDomError = exports.isErrorEvent = exports.isError = exports.isErrorDefined = exports.isEvent = exports.isEventDefined = exports.isPrimitive = exports.isThenable = exports.isRegExp = exports.isArray = exports.isFunction = exports.isObject = exports.isSymbol = exports.isBoolean = exports.isInt = exports.isNumber = exports.isString = exports.isNull = exports.isUndefined = exports.isInstanceOf = exports.isToString = exports.isTypeof = void 0;
+exports.isEmpty = exports.isSyntheticEvent = exports.isMap = exports.isMapDefined = exports.isElement = exports.isElementDefined = exports.isDomException = exports.isDomError = exports.isErrorEvent = exports.isError = exports.isErrorDefined = exports.isEvent = exports.isEventDefined = exports.isPrimitive = exports.isThenable = exports.isRegExp = exports.isArray = exports.isFunction = exports.isObject = exports.isSymbol = exports.isBoolean = exports.isInt = exports.isNumber = exports.isString = exports.isNull = exports.isUndefined = exports.isInstanceOf = exports.isToString = exports.isTypeof = void 0;
 function isTypeof(value, type) {
@@ -53,2 +53,15 @@ return typeof value === type;
 });
+function isEmpty(value) {
+    if (value == null) {
+        return true;
+    }
+    if ((0, exports.isArray)(value) || (0, exports.isString)(value)) {
+        return value.length === 0;
+    }
+    if ((0, exports.isObject)(value)) {
+        return Object.keys(value).length === 0;
+    }
+    return false;
+}
+exports.isEmpty = isEmpty;
 //# sourceMappingURL=is.js.map

dist/spec/core/src/version.js

@@ -5,3 +5,3 @@ "use strict";
 // auto-generated by bin/genVersion.ts
-exports.VERSION = '1.12.3';
+exports.VERSION = '1.13.0';
 //# sourceMappingURL=version.js.map

dist/types/api/exceptions/const.d.ts

 export declare const defaultExceptionType = "Error";
+export declare const defaultErrorArgsSerializer: (args: [any?, ...any[]]) => string;

dist/types/api/exceptions/index.d.ts

@@ -1,3 +0,3 @@
-export { defaultExceptionType } from './const';
+export { defaultExceptionType, defaultErrorArgsSerializer } from './const';
 export { initializeExceptionsAPI } from './initialize';
 export type { ExceptionEvent, ExceptionStackFrame, ExceptionsAPI, ExtendedError, PushErrorOptions, Stacktrace, StacktraceParser, ErrorWithIndexProperties, } from './types';

dist/types/api/index.d.ts

 export { initializeAPI } from './initialize';
 export type { API, APIEvent } from './types';
 export type { EventAttributes, EventEvent, EventsAPI, PushEventOptions } from './events';
-export { defaultExceptionType } from './exceptions';
+export { defaultExceptionType, defaultErrorArgsSerializer } from './exceptions';
 export type { ExceptionEvent, ExceptionStackFrame, ExceptionsAPI, ExtendedError, PushErrorOptions, Stacktrace, StacktraceParser, } from './exceptions';
@@ -6,0 +6,0 @@ export { defaultLogArgsSerializer } from './logs';

dist/types/api/meta/types.d.ts

@@ -1,10 +0,20 @@
-import type { MetaSession, MetaUser, MetaView } from '../../metas';
+import type { MetaOverrides, MetaPage, MetaSession, MetaUser, MetaView } from '../../metas';
 export interface MetaAPI {
     setUser: (user?: MetaUser | undefined) => void;
     resetUser: () => void;
-    setSession: (session?: MetaSession | undefined) => void;
+    setSession: (session?: MetaSession | undefined, options?: {
+        overrides: MetaOverrides;
+    }) => void;
     resetSession: () => void;
     getSession: () => MetaSession | undefined;
-    setView: (view?: MetaView | undefined) => void;
+    setView: (view?: MetaView | undefined, options?: {
+        overrides: MetaOverrides;
+    }) => void;
     getView: () => MetaView | undefined;
+    /**
+     * If a string is provided, it will be used as the page id.
+     * @returns
+     */
+    setPage: (page?: MetaPage | string | undefined) => void;
+    getPage: () => MetaPage | undefined;
 }

dist/types/config/types.d.ts

 import type { APIEvent, LogArgsSerializer, StacktraceParser } from '../api';
 import type { Instrumentation } from '../instrumentations';
 import type { InternalLoggerLevel } from '../internalLogger';
-import type { Meta, MetaApp, MetaItem, MetaSession, MetaUser, MetaView } from '../metas';
+import type { Meta, MetaApp, MetaItem, MetaPage, MetaSession, MetaUser, MetaView } from '../metas';
 import type { BatchExecutorOptions, BeforeSendHook, Transport } from '../transports';
@@ -154,5 +154,25 @@ import type { UnpatchedConsole } from '../unpatchedConsole';
         consoleErrorAsLog?: boolean;
+        /**
+         * If true, use the default Faro error serializer for console.error calls. If false, simply call toString() on the error arguments.
+         * If enabled, payloads containing serialized errors may become very large. If left disabled, some error details may be lost.
+         * (default: false)
+         */
+        serializeErrors?: boolean;
+        /**
+         * Custom function to serialize Error arguments
+         */
+        errorSerializer?: LogArgsSerializer;
     };
+    pageTracking?: {
+        /**
+         * The page meta for initial page settings
+         */
+        page?: MetaPage;
+        /**
+         * Allows to provide a template for the page id
+         */
+        generatePageId?: (location: Location) => string;
+    };
 }
 export type Patterns = Array<string | RegExp>;
 export {};

dist/types/core/src/api/exceptions/const.d.ts

 export declare const defaultExceptionType = "Error";
+export declare const defaultErrorArgsSerializer: (args: [any?, ...any[]]) => string;

dist/types/core/src/api/exceptions/index.d.ts

@@ -1,3 +0,3 @@
-export { defaultExceptionType } from './const';
+export { defaultExceptionType, defaultErrorArgsSerializer } from './const';
 export { initializeExceptionsAPI } from './initialize';
 export type { ExceptionEvent, ExceptionStackFrame, ExceptionsAPI, ExtendedError, PushErrorOptions, Stacktrace, StacktraceParser, ErrorWithIndexProperties, } from './types';

dist/types/core/src/api/index.d.ts

 export { initializeAPI } from './initialize';
 export type { API, APIEvent } from './types';
 export type { EventAttributes, EventEvent, EventsAPI, PushEventOptions } from './events';
-export { defaultExceptionType } from './exceptions';
+export { defaultExceptionType, defaultErrorArgsSerializer } from './exceptions';
 export type { ExceptionEvent, ExceptionStackFrame, ExceptionsAPI, ExtendedError, PushErrorOptions, Stacktrace, StacktraceParser, } from './exceptions';
@@ -6,0 +6,0 @@ export { defaultLogArgsSerializer } from './logs';

dist/types/core/src/api/meta/types.d.ts

@@ -1,10 +0,20 @@
-import type { MetaSession, MetaUser, MetaView } from '../../metas';
+import type { MetaOverrides, MetaPage, MetaSession, MetaUser, MetaView } from '../../metas';
 export interface MetaAPI {
     setUser: (user?: MetaUser | undefined) => void;
     resetUser: () => void;
-    setSession: (session?: MetaSession | undefined) => void;
+    setSession: (session?: MetaSession | undefined, options?: {
+        overrides: MetaOverrides;
+    }) => void;
     resetSession: () => void;
     getSession: () => MetaSession | undefined;
-    setView: (view?: MetaView | undefined) => void;
+    setView: (view?: MetaView | undefined, options?: {
+        overrides: MetaOverrides;
+    }) => void;
     getView: () => MetaView | undefined;
+    /**
+     * If a string is provided, it will be used as the page id.
+     * @returns
+     */
+    setPage: (page?: MetaPage | string | undefined) => void;
+    getPage: () => MetaPage | undefined;
 }

dist/types/core/src/config/types.d.ts

 import type { APIEvent, LogArgsSerializer, StacktraceParser } from '../api';
 import type { Instrumentation } from '../instrumentations';
 import type { InternalLoggerLevel } from '../internalLogger';
-import type { Meta, MetaApp, MetaItem, MetaSession, MetaUser, MetaView } from '../metas';
+import type { Meta, MetaApp, MetaItem, MetaPage, MetaSession, MetaUser, MetaView } from '../metas';
 import type { BatchExecutorOptions, BeforeSendHook, Transport } from '../transports';
@@ -154,5 +154,25 @@ import type { UnpatchedConsole } from '../unpatchedConsole';
         consoleErrorAsLog?: boolean;
+        /**
+         * If true, use the default Faro error serializer for console.error calls. If false, simply call toString() on the error arguments.
+         * If enabled, payloads containing serialized errors may become very large. If left disabled, some error details may be lost.
+         * (default: false)
+         */
+        serializeErrors?: boolean;
+        /**
+         * Custom function to serialize Error arguments
+         */
+        errorSerializer?: LogArgsSerializer;
     };
+    pageTracking?: {
+        /**
+         * The page meta for initial page settings
+         */
+        page?: MetaPage;
+        /**
+         * Allows to provide a template for the page id
+         */
+        generatePageId?: (location: Location) => string;
+    };
 }
 export type Patterns = Array<string | RegExp>;
 export {};

dist/types/core/src/index.d.ts

@@ -1,2 +0,2 @@
-export { defaultExceptionType, defaultLogArgsSerializer } from './api';
+export { defaultExceptionType, defaultLogArgsSerializer, defaultErrorArgsSerializer } from './api';
 export type { API, APIEvent, EventAttributes, EventEvent, EventsAPI, ExceptionEvent, ExceptionStackFrame, ExceptionsAPI, ExtendedError, LogArgsSerializer, LogContext, LogEvent, LogsAPI, MeasurementEvent, MeasurementsAPI, MetaAPI, OTELApi, PushErrorOptions, PushEventOptions, PushLogOptions, PushMeasurementOptions, Stacktrace, StacktraceParser, TraceContext, TraceEvent, TracesAPI, } from './api';
@@ -14,3 +14,3 @@ export { BaseExtension } from './extensions';
 export type { InternalLogger } from './internalLogger';
-export type { Meta, MetaApp, MetaAttributes, MetaBrowser, MetaGetter, MetaItem, MetaPage, Metas, MetaSDK, MetaSDKIntegration, MetaSession, MetaUser, MetaView, } from './metas';
+export type { Meta, MetaApp, MetaAttributes, MetaBrowser, MetaGetter, MetaItem, MetaPage, Metas, MetaSDK, MetaSDKIntegration, MetaSession, MetaUser, MetaView, MetaOverrides, } from './metas';
 export { faro, getInternalFaroFromGlobalObject, internalGlobalObjectKey, isInternalFaroOnGlobalObject, setInternalFaroOnGlobalObject, } from './sdk';
@@ -23,5 +23,5 @@ export type { Faro } from './sdk';
 export type { UnpatchedConsole } from './unpatchedConsole';
-export { allLogLevels, createPromiseBuffer, deepEqual, defaultLogLevel, genShortID, getCurrentTimestamp, isArray, isBoolean, isDomError, isDomException, isElement, isElementDefined, isError, isErrorDefined, isErrorEvent, isEvent, isEventDefined, isFunction, isInstanceOf, isInt, isMap, isMapDefined, isNull, isNumber, isObject, isPrimitive, isRegExp, isString, isSymbol, isSyntheticEvent, isThenable, isToString, isTypeof, isUndefined, LogLevel, noop, dateNow, } from './utils';
+export { allLogLevels, createPromiseBuffer, deepEqual, defaultLogLevel, genShortID, getCurrentTimestamp, isArray, isBoolean, isDomError, isDomException, isElement, isElementDefined, isError, isErrorDefined, isErrorEvent, isEvent, isEventDefined, isFunction, isInstanceOf, isInt, isMap, isMapDefined, isNull, isNumber, isObject, isPrimitive, isRegExp, isString, isSymbol, isSyntheticEvent, isThenable, isToString, isTypeof, isUndefined, LogLevel, noop, dateNow, isEmpty, getCircularDependencyReplacer, stringifyExternalJson, } from './utils';
 export type { BaseObject, BaseObjectKey, BaseObjectPrimitiveValue, BaseObjectValue, BufferItem, PromiseBuffer, PromiseBufferOptions, PromiseProducer, } from './utils';
 export { VERSION } from './version';
 export { unknownString } from './consts';

dist/types/core/src/metas/index.d.ts

 export { initializeMetas } from './initialize';
 export { registerInitialMetas } from './registerInitial';
-export type { Meta, MetaApp, MetaAttributes, MetaBrowser, MetaGetter, MetaItem, MetaK6, MetaPage, MetaSDK, MetaSDKIntegration, MetaSession, MetaUser, MetaView, Metas, } from './types';
+export type { Meta, MetaApp, MetaAttributes, MetaBrowser, MetaGetter, MetaItem, MetaK6, MetaPage, MetaSDK, MetaSDKIntegration, MetaSession, MetaUser, MetaView, Metas, MetaOverrides, } from './types';

dist/types/core/src/metas/types.d.ts

@@ -38,2 +38,3 @@ export type MetaGetter<P = Partial<Meta>> = () => P;
     attributes?: MetaAttributes;
+    overrides?: MetaOverrides;
 }
@@ -77,2 +78,8 @@ export interface MetaPage {
 }
+/**
+ * Overrides are instructions that allow the receiver to override certain properties.
+ */
+export type MetaOverrides = {
+    serviceName?: string;
+};
 export {};

dist/types/core/src/semantic.d.ts

@@ -21,2 +21,3 @@ /**
 export declare const EVENT_SESSION_EXTEND = "session_extend";
+export declare const EVENT_OVERRIDES_SERVICE_NAME = "service_name_override";
 export declare const EVENT_ROUTE_CHANGE = "route_change";

dist/types/core/src/testUtils/mockTransport.d.ts

@@ -7,3 +7,3 @@ import type { Patterns } from '../config';
     readonly name = "@grafana/transport-mock";
-    readonly version = "1.12.3";
+    readonly version = "1.13.0";
     items: TransportItem[];
@@ -10,0 +10,0 @@ constructor(ignoreURLs?: Patterns);

dist/types/core/src/utils/index.d.ts

 export type { BaseObject, BaseObjectKey, BaseObjectPrimitiveValue, BaseObjectValue } from './baseObject';
 export { deepEqual } from './deepEqual';
 export { getCurrentTimestamp } from './date';
-export { isArray, isBoolean, isDomError, isDomException, isElement, isElementDefined, isError, isErrorDefined, isErrorEvent, isEvent, isEventDefined, isFunction, isInstanceOf, isInt, isMap, isMapDefined, isNull, isNumber, isObject, isPrimitive, isRegExp, isString, isSymbol, isSyntheticEvent, isThenable, isToString, isTypeof, isUndefined, } from './is';
+export { isArray, isBoolean, isDomError, isDomException, isElement, isElementDefined, isError, isErrorDefined, isErrorEvent, isEvent, isEventDefined, isFunction, isInstanceOf, isInt, isMap, isMapDefined, isNull, isNumber, isObject, isPrimitive, isRegExp, isString, isSymbol, isSyntheticEvent, isThenable, isToString, isTypeof, isUndefined, isEmpty, } from './is';
 export type { IsFnHelper } from './is';
@@ -13,1 +13,2 @@ export { allLogLevels, defaultLogLevel, LogLevel } from './logLevels';
 export { dateNow } from './date';
+export { getCircularDependencyReplacer, stringifyExternalJson } from './json';

dist/types/core/src/utils/is.d.ts

@@ -32,1 +32,2 @@ export type IsFnHelper<T = unknown> = (value: unknown) => value is T;
 export declare const isSyntheticEvent: IsFnHelper<Event>;
+export declare function isEmpty(value: any): boolean;

dist/types/core/src/version.d.ts

@@ -1,1 +0,1 @@
-export declare const VERSION = "1.12.3";
+export declare const VERSION = "1.13.0";

dist/types/index.d.ts

@@ -1,2 +0,2 @@
-export { defaultExceptionType, defaultLogArgsSerializer } from './api';
+export { defaultExceptionType, defaultLogArgsSerializer, defaultErrorArgsSerializer } from './api';
 export type { API, APIEvent, EventAttributes, EventEvent, EventsAPI, ExceptionEvent, ExceptionStackFrame, ExceptionsAPI, ExtendedError, LogArgsSerializer, LogContext, LogEvent, LogsAPI, MeasurementEvent, MeasurementsAPI, MetaAPI, OTELApi, PushErrorOptions, PushEventOptions, PushLogOptions, PushMeasurementOptions, Stacktrace, StacktraceParser, TraceContext, TraceEvent, TracesAPI, } from './api';
@@ -14,3 +14,3 @@ export { BaseExtension } from './extensions';
 export type { InternalLogger } from './internalLogger';
-export type { Meta, MetaApp, MetaAttributes, MetaBrowser, MetaGetter, MetaItem, MetaPage, Metas, MetaSDK, MetaSDKIntegration, MetaSession, MetaUser, MetaView, } from './metas';
+export type { Meta, MetaApp, MetaAttributes, MetaBrowser, MetaGetter, MetaItem, MetaPage, Metas, MetaSDK, MetaSDKIntegration, MetaSession, MetaUser, MetaView, MetaOverrides, } from './metas';
 export { faro, getInternalFaroFromGlobalObject, internalGlobalObjectKey, isInternalFaroOnGlobalObject, setInternalFaroOnGlobalObject, } from './sdk';
@@ -23,5 +23,5 @@ export type { Faro } from './sdk';
 export type { UnpatchedConsole } from './unpatchedConsole';
-export { allLogLevels, createPromiseBuffer, deepEqual, defaultLogLevel, genShortID, getCurrentTimestamp, isArray, isBoolean, isDomError, isDomException, isElement, isElementDefined, isError, isErrorDefined, isErrorEvent, isEvent, isEventDefined, isFunction, isInstanceOf, isInt, isMap, isMapDefined, isNull, isNumber, isObject, isPrimitive, isRegExp, isString, isSymbol, isSyntheticEvent, isThenable, isToString, isTypeof, isUndefined, LogLevel, noop, dateNow, } from './utils';
+export { allLogLevels, createPromiseBuffer, deepEqual, defaultLogLevel, genShortID, getCurrentTimestamp, isArray, isBoolean, isDomError, isDomException, isElement, isElementDefined, isError, isErrorDefined, isErrorEvent, isEvent, isEventDefined, isFunction, isInstanceOf, isInt, isMap, isMapDefined, isNull, isNumber, isObject, isPrimitive, isRegExp, isString, isSymbol, isSyntheticEvent, isThenable, isToString, isTypeof, isUndefined, LogLevel, noop, dateNow, isEmpty, getCircularDependencyReplacer, stringifyExternalJson, } from './utils';
 export type { BaseObject, BaseObjectKey, BaseObjectPrimitiveValue, BaseObjectValue, BufferItem, PromiseBuffer, PromiseBufferOptions, PromiseProducer, } from './utils';
 export { VERSION } from './version';
 export { unknownString } from './consts';

dist/types/metas/index.d.ts

 export { initializeMetas } from './initialize';
 export { registerInitialMetas } from './registerInitial';
-export type { Meta, MetaApp, MetaAttributes, MetaBrowser, MetaGetter, MetaItem, MetaK6, MetaPage, MetaSDK, MetaSDKIntegration, MetaSession, MetaUser, MetaView, Metas, } from './types';
+export type { Meta, MetaApp, MetaAttributes, MetaBrowser, MetaGetter, MetaItem, MetaK6, MetaPage, MetaSDK, MetaSDKIntegration, MetaSession, MetaUser, MetaView, Metas, MetaOverrides, } from './types';

dist/types/metas/types.d.ts

@@ -38,2 +38,3 @@ export type MetaGetter<P = Partial<Meta>> = () => P;
     attributes?: MetaAttributes;
+    overrides?: MetaOverrides;
 }
@@ -77,2 +78,8 @@ export interface MetaPage {
 }
+/**
+ * Overrides are instructions that allow the receiver to override certain properties.
+ */
+export type MetaOverrides = {
+    serviceName?: string;
+};
 export {};

dist/types/semantic.d.ts

@@ -21,2 +21,3 @@ /**
 export declare const EVENT_SESSION_EXTEND = "session_extend";
+export declare const EVENT_OVERRIDES_SERVICE_NAME = "service_name_override";
 export declare const EVENT_ROUTE_CHANGE = "route_change";

dist/types/testUtils/mockTransport.d.ts

@@ -7,3 +7,3 @@ import type { Patterns } from '../config';
     readonly name = "@grafana/transport-mock";
-    readonly version = "1.12.3";
+    readonly version = "1.13.0";
     items: TransportItem[];
@@ -10,0 +10,0 @@ constructor(ignoreURLs?: Patterns);

dist/types/utils/index.d.ts

 export type { BaseObject, BaseObjectKey, BaseObjectPrimitiveValue, BaseObjectValue } from './baseObject';
 export { deepEqual } from './deepEqual';
 export { getCurrentTimestamp } from './date';
-export { isArray, isBoolean, isDomError, isDomException, isElement, isElementDefined, isError, isErrorDefined, isErrorEvent, isEvent, isEventDefined, isFunction, isInstanceOf, isInt, isMap, isMapDefined, isNull, isNumber, isObject, isPrimitive, isRegExp, isString, isSymbol, isSyntheticEvent, isThenable, isToString, isTypeof, isUndefined, } from './is';
+export { isArray, isBoolean, isDomError, isDomException, isElement, isElementDefined, isError, isErrorDefined, isErrorEvent, isEvent, isEventDefined, isFunction, isInstanceOf, isInt, isMap, isMapDefined, isNull, isNumber, isObject, isPrimitive, isRegExp, isString, isSymbol, isSyntheticEvent, isThenable, isToString, isTypeof, isUndefined, isEmpty, } from './is';
 export type { IsFnHelper } from './is';
@@ -13,1 +13,2 @@ export { allLogLevels, defaultLogLevel, LogLevel } from './logLevels';
 export { dateNow } from './date';
+export { getCircularDependencyReplacer, stringifyExternalJson } from './json';

dist/types/utils/is.d.ts

@@ -32,1 +32,2 @@ export type IsFnHelper<T = unknown> = (value: unknown) => value is T;
 export declare const isSyntheticEvent: IsFnHelper<Event>;
+export declare function isEmpty(value: any): boolean;

dist/types/version.d.ts

@@ -1,1 +0,1 @@
-export declare const VERSION = "1.12.3";
+export declare const VERSION = "1.13.0";

package.json

 {
   "name": "@grafana/faro-core",
-  "version": "1.12.3",
+  "version": "1.13.0",
   "description": "Core package of Faro.",
+  "engines": {
+    "node": ">=18.0.0"
+  },
   "keywords": [
@@ -63,3 +66,3 @@ "observability",
   },
-  "gitHead": "a0caa5a8c08398394e3a140465d6f9007754be2e"
+  "gitHead": "6cd423ffab2f4218c81d624577958d3140a438ba"
 }

New alerts

Unstable ownership

Supply chain risk

A new collaborator has begun publishing package versions. Package stability and security risk may be elevated.

Found 1 instance in 1 package

New author

Supply chain risk

A new npm collaborator published a version of the package for the first time. New collaborators are usually benign additions to a project, but do indicate a change to the security surface area of a package.

Found 1 instance in 1 package

Improved metrics

Total package byte prevSize

1071158

increased by5.19%

Number of package files

815

increased by2.26%

Lines of code

10133

increased by5.19%

Worsened metrics

Number of high supply chain risk alerts

1

increased byInfinity%

Number of medium supply chain risk alerts

1

increased byInfinity%

No dependency changes