@grafana/faro-core 2.3.1 → 2.5.0

package/dist/esm/api/noop.js

@@ -0,0 +1,27 @@
+export function getNoopAPI() {
+    return {
+        pushLog: () => { },
+        pushError: () => { },
+        changeStacktraceParser: () => { },
+        getStacktraceParser: () => undefined,
+        pushMeasurement: () => { },
+        pushTraces: () => { },
+        getOTEL: () => undefined,
+        getTraceContext: () => undefined,
+        initOTEL: () => { },
+        isOTELInitialized: () => false,
+        setUser: () => { },
+        resetUser: () => { },
+        setSession: () => { },
+        resetSession: () => { },
+        getSession: () => undefined,
+        setView: () => { },
+        getView: () => undefined,
+        setPage: () => { },
+        getPage: () => undefined,
+        pushEvent: () => { },
+        startUserAction: () => undefined,
+        getActiveUserAction: () => undefined,
+    };
+}
+//# sourceMappingURL=noop.js.map

package/dist/esm/api/noop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"noop.js","sourceRoot":"","sources":["../../../src/api/noop.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,UAAU;IACxB,OAAO;QACL,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC;QACjB,SAAS,EAAE,GAAG,EAAE,GAAE,CAAC;QACnB,sBAAsB,EAAE,GAAG,EAAE,GAAE,CAAC;QAChC,mBAAmB,EAAE,GAAG,EAAE,CAAC,SAAS;QACpC,eAAe,EAAE,GAAG,EAAE,GAAE,CAAC;QACzB,UAAU,EAAE,GAAG,EAAE,GAAE,CAAC;QACpB,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS;QACxB,eAAe,EAAE,GAAG,EAAE,CAAC,SAAS;QAChC,QAAQ,EAAE,GAAG,EAAE,GAAE,CAAC;QAClB,iBAAiB,EAAE,GAAG,EAAE,CAAC,KAAK;QAC9B,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC;QACjB,SAAS,EAAE,GAAG,EAAE,GAAE,CAAC;QACnB,UAAU,EAAE,GAAG,EAAE,GAAE,CAAC;QACpB,YAAY,EAAE,GAAG,EAAE,GAAE,CAAC;QACtB,UAAU,EAAE,GAAG,EAAE,CAAC,SAAS;QAC3B,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC;QACjB,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS;QACxB,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC;QACjB,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS;QACxB,SAAS,EAAE,GAAG,EAAE,GAAE,CAAC;QACnB,eAAe,EAAE,GAAG,EAAE,CAAC,SAAS;QAChC,mBAAmB,EAAE,GAAG,EAAE,CAAC,SAAS;KACrC,CAAC;AACJ,CAAC","sourcesContent":["import type { API } from './types';\n\nexport function getNoopAPI(): API {\n  return {\n    pushLog: () => {},\n    pushError: () => {},\n    changeStacktraceParser: () => {},\n    getStacktraceParser: () => undefined,\n    pushMeasurement: () => {},\n    pushTraces: () => {},\n    getOTEL: () => undefined,\n    getTraceContext: () => undefined,\n    initOTEL: () => {},\n    isOTELInitialized: () => false,\n    setUser: () => {},\n    resetUser: () => {},\n    setSession: () => {},\n    resetSession: () => {},\n    getSession: () => undefined,\n    setView: () => {},\n    getView: () => undefined,\n    setPage: () => {},\n    getPage: () => undefined,\n    pushEvent: () => {},\n    startUserAction: () => undefined,\n    getActiveUserAction: () => undefined,\n  };\n}\n"]}

package/dist/esm/api/userActions/userAction.js

@@ -1,5 +1,5 @@
 import { TransportItemType } from '../../transports';
-import { dateNow, genShortID, Observable, stringifyObjectValues } from '../../utils';
+import { dateNow, genShortID, monoNow, Observable, stringifyObjectValues } from '../../utils';
 import { ItemBuffer } from '../ItemBuffer';
 import {} from '../measurements/types';
 import {} from '../types';
@@ -31,7 +31,12 @@ export default class UserAction extends Observable {
     _start() {
         this._state = UserActionState.Started;
         if (this._state === UserActionState.Started) {
+            // `startTime` is wall-clock (Unix-epoch ms) so it can be used as the event's
+            // `timestampOverwriteMs` and emitted as `userActionStartTime` for consumers that
+            // correlate with other systems. `_startTimeMono` is the monotonic anchor used
+            // for the duration calculation in `end()`.
             this.startTime = dateNow();
+            this._startTimeMono = monoNow();
         }
     }
     halt() {
@@ -56,7 +61,11 @@ export default class UserAction extends Observable {
             return;
         }
         const endTime = dateNow();
-        const duration = endTime - this.startTime;
+        // Compute duration from the monotonic clock so it is unaffected by wall-clock
+        // adjustments during the action. Note: `endTime - startTime` (both wall-clock) may
+        // disagree with `duration` if the system clock was adjusted between start and end;
+        // `duration` is authoritative.
+        const duration = monoNow() - this._startTimeMono;
         this._state = UserActionState.Ended;
         this._itemBuffer.flushBuffer((item) => {
             if (isExcludeFromUserAction(item, this.trackUserActionsExcludeItem)) {

package/dist/esm/api/userActions/userAction.js.map

@@ -1 +1 @@
-{"version":3,"file":"userAction.js","sourceRoot":"","sources":["../../../../src/api/userActions/userAction.ts"],"names":[],"mappings":"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","sourcesContent":["import { type TransportItem, TransportItemType, type Transports } from '../../transports';\nimport { dateNow, genShortID, Observable, stringifyObjectValues } from '../../utils';\nimport type { EventsAPI } from '../events/types';\nimport { ItemBuffer } from '../ItemBuffer';\nimport { type MeasurementEvent } from '../measurements/types';\nimport { type APIEvent } from '../types';\n\nimport { userActionEventName, UserActionImportance, type UserActionImportanceType } from './const';\nimport { type UserActionInternalInterface, UserActionState, type UserActionTransportItemBuffer } from './types';\n\nexport default class UserAction\n  extends Observable\n  implements UserActionInternalInterface, UserActionTransportItemBuffer\n{\n  name: string;\n  id: string;\n  attributes?: Record<string, string>;\n  parentId: string;\n  trigger: string;\n  importance: UserActionImportanceType;\n  startTime?: number;\n  trackUserActionsExcludeItem?: (item: TransportItem<APIEvent>) => boolean;\n\n  private _state: UserActionState;\n  private _itemBuffer: ItemBuffer<TransportItem>;\n  private _transports: Transports;\n  private _pushEvent: EventsAPI['pushEvent'];\n\n  constructor({\n    name,\n    parentId,\n    trigger,\n    transports,\n    attributes,\n    trackUserActionsExcludeItem,\n    importance = UserActionImportance.Normal,\n    pushEvent,\n  }: {\n    name: string;\n    transports: Transports;\n    parentId?: string;\n    trigger: string;\n    attributes?: Record<string, string>;\n    trackUserActionsExcludeItem?: (item: TransportItem<APIEvent>) => boolean;\n    importance?: UserActionImportanceType;\n    pushEvent: EventsAPI['pushEvent'];\n  }) {\n    super();\n    this.name = name;\n    this.attributes = attributes;\n    this.id = genShortID();\n    this.trigger = trigger;\n    this.parentId = parentId ?? this.id;\n    this.trackUserActionsExcludeItem = trackUserActionsExcludeItem;\n    this.importance = importance;\n    this._pushEvent = pushEvent;\n\n    this._itemBuffer = new ItemBuffer<TransportItem>();\n    this._transports = transports;\n    this._state = UserActionState.Started;\n    this._start();\n  }\n\n  addItem(item: TransportItem): boolean {\n    if (this._state === UserActionState.Started) {\n      this._itemBuffer.addItem(item);\n      return true;\n    }\n    return false;\n  }\n\n  private _start(): void {\n    this._state = UserActionState.Started;\n    if (this._state === UserActionState.Started) {\n      this.startTime = dateNow();\n    }\n  }\n\n  halt() {\n    if (this._state !== UserActionState.Started) {\n      return;\n    }\n    this._state = UserActionState.Halted;\n    this.notify(this._state);\n  }\n\n  cancel() {\n    if (this._state === UserActionState.Started) {\n      // Empty the buffer\n      this._itemBuffer.flushBuffer((item) => {\n        this._transports.execute(item);\n      });\n    }\n\n    this._state = UserActionState.Cancelled;\n    this.notify(this._state);\n  }\n\n  end() {\n    if (this._state === UserActionState.Cancelled) {\n      return;\n    }\n\n    const endTime = dateNow();\n    const duration = endTime - this.startTime!;\n    this._state = UserActionState.Ended;\n    this._itemBuffer.flushBuffer((item) => {\n      if (isExcludeFromUserAction(item, this.trackUserActionsExcludeItem)) {\n        this._transports.execute(item);\n        return;\n      }\n\n      const userActionItem = {\n        ...item,\n        payload: {\n          ...item.payload,\n          action: {\n            parentId: this.id,\n            name: this.name,\n          },\n        },\n      } as TransportItem;\n\n      this._transports.execute(userActionItem);\n    });\n\n    this._state = UserActionState.Ended;\n    this.notify(this._state);\n\n    this._pushEvent(\n      userActionEventName,\n      {\n        userActionName: this.name,\n        userActionStartTime: this.startTime!.toString(),\n        userActionEndTime: endTime.toString(),\n        userActionDuration: duration.toString(),\n        userActionTrigger: this.trigger!,\n        userActionImportance: this.importance,\n        ...stringifyObjectValues(this.attributes),\n      },\n      undefined,\n      {\n        timestampOverwriteMs: this.startTime,\n        customPayloadTransformer: (payload) => {\n          payload.action = {\n            id: this.id,\n            name: this.name,\n          };\n\n          return payload;\n        },\n      }\n    );\n  }\n\n  getState(): UserActionState {\n    return this._state;\n  }\n}\n\nfunction isExcludeFromUserAction(\n  item: TransportItem<APIEvent>,\n  trackUserActionsExcludeItem: ((item: TransportItem<APIEvent>) => boolean) | undefined\n) {\n  return (\n    trackUserActionsExcludeItem?.(item) ||\n    (item.type === TransportItemType.MEASUREMENT && (item.payload as MeasurementEvent).type === 'web-vitals')\n  );\n}\n"]}
+{"version":3,"file":"userAction.js","sourceRoot":"","sources":["../../../../src/api/userActions/userAction.ts"],"names":[],"mappings":"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","sourcesContent":["import { type TransportItem, TransportItemType, type Transports } from '../../transports';\nimport { dateNow, genShortID, monoNow, Observable, stringifyObjectValues } from '../../utils';\nimport type { EventsAPI } from '../events/types';\nimport { ItemBuffer } from '../ItemBuffer';\nimport { type MeasurementEvent } from '../measurements/types';\nimport { type APIEvent } from '../types';\n\nimport { userActionEventName, UserActionImportance, type UserActionImportanceType } from './const';\nimport { type UserActionInternalInterface, UserActionState, type UserActionTransportItemBuffer } from './types';\n\nexport default class UserAction\n  extends Observable\n  implements UserActionInternalInterface, UserActionTransportItemBuffer\n{\n  name: string;\n  id: string;\n  attributes?: Record<string, string>;\n  parentId: string;\n  trigger: string;\n  importance: UserActionImportanceType;\n  startTime?: number;\n  // Monotonic counterpart to `startTime`, used to compute `duration` immune to wall-clock\n  // adjustments (NTP step, manual clock change, DST). Not exposed in telemetry — see `end()`.\n  private _startTimeMono?: number;\n  trackUserActionsExcludeItem?: (item: TransportItem<APIEvent>) => boolean;\n\n  private _state: UserActionState;\n  private _itemBuffer: ItemBuffer<TransportItem>;\n  private _transports: Transports;\n  private _pushEvent: EventsAPI['pushEvent'];\n\n  constructor({\n    name,\n    parentId,\n    trigger,\n    transports,\n    attributes,\n    trackUserActionsExcludeItem,\n    importance = UserActionImportance.Normal,\n    pushEvent,\n  }: {\n    name: string;\n    transports: Transports;\n    parentId?: string;\n    trigger: string;\n    attributes?: Record<string, string>;\n    trackUserActionsExcludeItem?: (item: TransportItem<APIEvent>) => boolean;\n    importance?: UserActionImportanceType;\n    pushEvent: EventsAPI['pushEvent'];\n  }) {\n    super();\n    this.name = name;\n    this.attributes = attributes;\n    this.id = genShortID();\n    this.trigger = trigger;\n    this.parentId = parentId ?? this.id;\n    this.trackUserActionsExcludeItem = trackUserActionsExcludeItem;\n    this.importance = importance;\n    this._pushEvent = pushEvent;\n\n    this._itemBuffer = new ItemBuffer<TransportItem>();\n    this._transports = transports;\n    this._state = UserActionState.Started;\n    this._start();\n  }\n\n  addItem(item: TransportItem): boolean {\n    if (this._state === UserActionState.Started) {\n      this._itemBuffer.addItem(item);\n      return true;\n    }\n    return false;\n  }\n\n  private _start(): void {\n    this._state = UserActionState.Started;\n    if (this._state === UserActionState.Started) {\n      // `startTime` is wall-clock (Unix-epoch ms) so it can be used as the event's\n      // `timestampOverwriteMs` and emitted as `userActionStartTime` for consumers that\n      // correlate with other systems. `_startTimeMono` is the monotonic anchor used\n      // for the duration calculation in `end()`.\n      this.startTime = dateNow();\n      this._startTimeMono = monoNow();\n    }\n  }\n\n  halt() {\n    if (this._state !== UserActionState.Started) {\n      return;\n    }\n    this._state = UserActionState.Halted;\n    this.notify(this._state);\n  }\n\n  cancel() {\n    if (this._state === UserActionState.Started) {\n      // Empty the buffer\n      this._itemBuffer.flushBuffer((item) => {\n        this._transports.execute(item);\n      });\n    }\n\n    this._state = UserActionState.Cancelled;\n    this.notify(this._state);\n  }\n\n  end() {\n    if (this._state === UserActionState.Cancelled) {\n      return;\n    }\n\n    const endTime = dateNow();\n    // Compute duration from the monotonic clock so it is unaffected by wall-clock\n    // adjustments during the action. Note: `endTime - startTime` (both wall-clock) may\n    // disagree with `duration` if the system clock was adjusted between start and end;\n    // `duration` is authoritative.\n    const duration = monoNow() - this._startTimeMono!;\n    this._state = UserActionState.Ended;\n    this._itemBuffer.flushBuffer((item) => {\n      if (isExcludeFromUserAction(item, this.trackUserActionsExcludeItem)) {\n        this._transports.execute(item);\n        return;\n      }\n\n      const userActionItem = {\n        ...item,\n        payload: {\n          ...item.payload,\n          action: {\n            parentId: this.id,\n            name: this.name,\n          },\n        },\n      } as TransportItem;\n\n      this._transports.execute(userActionItem);\n    });\n\n    this._state = UserActionState.Ended;\n    this.notify(this._state);\n\n    this._pushEvent(\n      userActionEventName,\n      {\n        userActionName: this.name,\n        userActionStartTime: this.startTime!.toString(),\n        userActionEndTime: endTime.toString(),\n        userActionDuration: duration.toString(),\n        userActionTrigger: this.trigger!,\n        userActionImportance: this.importance,\n        ...stringifyObjectValues(this.attributes),\n      },\n      undefined,\n      {\n        timestampOverwriteMs: this.startTime,\n        customPayloadTransformer: (payload) => {\n          payload.action = {\n            id: this.id,\n            name: this.name,\n          };\n\n          return payload;\n        },\n      }\n    );\n  }\n\n  getState(): UserActionState {\n    return this._state;\n  }\n}\n\nfunction isExcludeFromUserAction(\n  item: TransportItem<APIEvent>,\n  trackUserActionsExcludeItem: ((item: TransportItem<APIEvent>) => boolean) | undefined\n) {\n  return (\n    trackUserActionsExcludeItem?.(item) ||\n    (item.type === TransportItemType.MEASUREMENT && (item.payload as MeasurementEvent).type === 'web-vitals')\n  );\n}\n"]}

package/dist/esm/index.js

@@ -9,7 +9,7 @@ export { faro, getInternalFaroFromGlobalObject, internalGlobalObjectKey, isInter
 export * from './semantic';
 export { BaseTransport, getTransportBody, TransportItemType, transportItemTypeToBodyKey } from './transports';
 export { defaultUnpatchedConsole } from './unpatchedConsole';
-export { allLogLevels, clampSamplingRate, 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, stringifyObjectValues, Observable, } from './utils';
+export { allLogLevels, clampSamplingRate, 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, monoNow, isEmpty, getCircularDependencyReplacer, stringifyExternalJson, stringifyObjectValues, Observable, } from './utils';
 export { VERSION } from './version';
 export { unknownString } from './consts';
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,wBAAwB,EACxB,0BAA0B,EAC1B,oBAAoB,EAEpB,eAAe,EACf,qBAAqB,GACtB,MAAM,OAAO,CAAC;AAkCf,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAG7C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAGzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAGzD,OAAO,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAoBzG,OAAO,EACL,IAAI,EACJ,+BAA+B,EAC/B,uBAAuB,EACvB,4BAA4B,EAC5B,6BAA6B,GAC9B,MAAM,OAAO,CAAC;AAGf,cAAc,YAAY,CAAC;AAE3B,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAW9G,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAG7D,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACnB,SAAS,EACT,eAAe,EACf,UAAU,EACV,mBAAmB,EACnB,OAAO,EACP,SAAS,EACT,UAAU,EACV,cAAc,EACd,SAAS,EACT,gBAAgB,EAChB,OAAO,EACP,cAAc,EACd,YAAY,EACZ,OAAO,EACP,cAAc,EACd,UAAU,EACV,YAAY,EACZ,KAAK,EACL,KAAK,EACL,YAAY,EACZ,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,gBAAgB,EAChB,UAAU,EACV,UAAU,EACV,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,IAAI,EACJ,OAAO,EACP,OAAO,EACP,6BAA6B,EAC7B,qBAAqB,EACrB,qBAAqB,EACrB,UAAU,GACX,MAAM,SAAS,CAAC;AAajB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC","sourcesContent":["export {\n  defaultExceptionType,\n  defaultLogArgsSerializer,\n  defaultErrorArgsSerializer,\n  UserActionImportance,\n  type UserActionImportanceType,\n  UserActionState,\n  userActionsMessageBus,\n} from './api';\nexport type {\n  API,\n  APIEvent,\n  EventAttributes,\n  EventEvent,\n  EventsAPI,\n  ExceptionEvent,\n  ExceptionEventExtended,\n  ExceptionStackFrame,\n  ExceptionsAPI,\n  ExtendedError,\n  LogArgsSerializer,\n  LogContext,\n  LogEvent,\n  LogsAPI,\n  MeasurementEvent,\n  MeasurementsAPI,\n  MetaAPI,\n  OTELApi,\n  PushErrorOptions,\n  PushEventOptions,\n  PushLogOptions,\n  PushMeasurementOptions,\n  Stacktrace,\n  StacktraceParser,\n  TraceContext,\n  TraceEvent,\n  TracesAPI,\n  UserAction,\n  UserActionInterface,\n  UserActionInternalInterface,\n} from './api';\n\nexport { BaseExtension } from './extensions';\nexport type { Extension } from './extensions';\n\nexport { globalObject } from './globalObject';\nexport type { GlobalObject } from './globalObject';\n\nexport { initializeFaro } from './initialize';\n\nexport { defaultBatchingConfig, defaultGlobalObjectKey } from './config';\nexport type { Config, Patterns } from './config';\n\nexport { BaseInstrumentation } from './instrumentations';\nexport type { Instrumentation, Instrumentations } from './instrumentations';\n\nexport { createInternalLogger, defaultInternalLoggerLevel, InternalLoggerLevel } from './internalLogger';\nexport type { InternalLogger } from './internalLogger';\n\nexport type {\n  Meta,\n  MetaApp,\n  MetaAttributes,\n  MetaBrowser,\n  MetaGetter,\n  MetaItem,\n  MetaPage,\n  Metas,\n  MetaSDK,\n  MetaSDKIntegration,\n  MetaSession,\n  MetaUser,\n  MetaView,\n  MetaOverrides,\n} from './metas';\n\nexport {\n  faro,\n  getInternalFaroFromGlobalObject,\n  internalGlobalObjectKey,\n  isInternalFaroOnGlobalObject,\n  setInternalFaroOnGlobalObject,\n} from './sdk';\nexport type { Faro } from './sdk';\n\nexport * from './semantic';\n\nexport { BaseTransport, getTransportBody, TransportItemType, transportItemTypeToBodyKey } from './transports';\nexport type {\n  BeforeSendHook,\n  SendFn,\n  Transport,\n  TransportBody,\n  TransportItem,\n  TransportItemPayload,\n  Transports,\n} from './transports';\n\nexport { defaultUnpatchedConsole } from './unpatchedConsole';\nexport type { UnpatchedConsole } from './unpatchedConsole';\n\nexport {\n  allLogLevels,\n  clampSamplingRate,\n  createPromiseBuffer,\n  deepEqual,\n  defaultLogLevel,\n  genShortID,\n  getCurrentTimestamp,\n  isArray,\n  isBoolean,\n  isDomError,\n  isDomException,\n  isElement,\n  isElementDefined,\n  isError,\n  isErrorDefined,\n  isErrorEvent,\n  isEvent,\n  isEventDefined,\n  isFunction,\n  isInstanceOf,\n  isInt,\n  isMap,\n  isMapDefined,\n  isNull,\n  isNumber,\n  isObject,\n  isPrimitive,\n  isRegExp,\n  isString,\n  isSymbol,\n  isSyntheticEvent,\n  isThenable,\n  isToString,\n  isTypeof,\n  isUndefined,\n  LogLevel,\n  noop,\n  dateNow,\n  isEmpty,\n  getCircularDependencyReplacer,\n  stringifyExternalJson,\n  stringifyObjectValues,\n  Observable,\n} from './utils';\nexport type {\n  BaseObject,\n  BaseObjectKey,\n  BaseObjectPrimitiveValue,\n  BaseObjectValue,\n  BufferItem,\n  PromiseBuffer,\n  PromiseBufferOptions,\n  PromiseProducer,\n  Subscription,\n} from './utils';\n\nexport { VERSION } from './version';\n\nexport { unknownString } from './consts';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,wBAAwB,EACxB,0BAA0B,EAC1B,oBAAoB,EAEpB,eAAe,EACf,qBAAqB,GACtB,MAAM,OAAO,CAAC;AAkCf,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAG7C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAGzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAGzD,OAAO,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAsBzG,OAAO,EACL,IAAI,EACJ,+BAA+B,EAC/B,uBAAuB,EACvB,4BAA4B,EAC5B,6BAA6B,GAC9B,MAAM,OAAO,CAAC;AAGf,cAAc,YAAY,CAAC;AAE3B,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAW9G,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAG7D,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACnB,SAAS,EACT,eAAe,EACf,UAAU,EACV,mBAAmB,EACnB,OAAO,EACP,SAAS,EACT,UAAU,EACV,cAAc,EACd,SAAS,EACT,gBAAgB,EAChB,OAAO,EACP,cAAc,EACd,YAAY,EACZ,OAAO,EACP,cAAc,EACd,UAAU,EACV,YAAY,EACZ,KAAK,EACL,KAAK,EACL,YAAY,EACZ,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,gBAAgB,EAChB,UAAU,EACV,UAAU,EACV,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,IAAI,EACJ,OAAO,EACP,OAAO,EACP,OAAO,EACP,6BAA6B,EAC7B,qBAAqB,EACrB,qBAAqB,EACrB,UAAU,GACX,MAAM,SAAS,CAAC;AAajB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC","sourcesContent":["export {\n  defaultExceptionType,\n  defaultLogArgsSerializer,\n  defaultErrorArgsSerializer,\n  UserActionImportance,\n  type UserActionImportanceType,\n  UserActionState,\n  userActionsMessageBus,\n} from './api';\nexport type {\n  API,\n  APIEvent,\n  EventAttributes,\n  EventEvent,\n  EventsAPI,\n  ExceptionEvent,\n  ExceptionEventExtended,\n  ExceptionStackFrame,\n  ExceptionsAPI,\n  ExtendedError,\n  LogArgsSerializer,\n  LogContext,\n  LogEvent,\n  LogsAPI,\n  MeasurementEvent,\n  MeasurementsAPI,\n  MetaAPI,\n  OTELApi,\n  PushErrorOptions,\n  PushEventOptions,\n  PushLogOptions,\n  PushMeasurementOptions,\n  Stacktrace,\n  StacktraceParser,\n  TraceContext,\n  TraceEvent,\n  TracesAPI,\n  UserAction,\n  UserActionInterface,\n  UserActionInternalInterface,\n} from './api';\n\nexport { BaseExtension } from './extensions';\nexport type { Extension } from './extensions';\n\nexport { globalObject } from './globalObject';\nexport type { GlobalObject } from './globalObject';\n\nexport { initializeFaro } from './initialize';\n\nexport { defaultBatchingConfig, defaultGlobalObjectKey } from './config';\nexport type { Config, Patterns } from './config';\n\nexport { BaseInstrumentation } from './instrumentations';\nexport type { Instrumentation, Instrumentations } from './instrumentations';\n\nexport { createInternalLogger, defaultInternalLoggerLevel, InternalLoggerLevel } from './internalLogger';\nexport type { InternalLogger } from './internalLogger';\n\nexport type {\n  Meta,\n  MetaApp,\n  MetaAttributes,\n  MetaBrowser,\n  MetaDevice,\n  MetaGetter,\n  MetaItem,\n  MetaOS,\n  MetaPage,\n  Metas,\n  MetaSDK,\n  MetaSDKIntegration,\n  MetaSession,\n  MetaUser,\n  MetaView,\n  MetaOverrides,\n} from './metas';\n\nexport {\n  faro,\n  getInternalFaroFromGlobalObject,\n  internalGlobalObjectKey,\n  isInternalFaroOnGlobalObject,\n  setInternalFaroOnGlobalObject,\n} from './sdk';\nexport type { Faro } from './sdk';\n\nexport * from './semantic';\n\nexport { BaseTransport, getTransportBody, TransportItemType, transportItemTypeToBodyKey } from './transports';\nexport type {\n  BeforeSendHook,\n  SendFn,\n  Transport,\n  TransportBody,\n  TransportItem,\n  TransportItemPayload,\n  Transports,\n} from './transports';\n\nexport { defaultUnpatchedConsole } from './unpatchedConsole';\nexport type { UnpatchedConsole } from './unpatchedConsole';\n\nexport {\n  allLogLevels,\n  clampSamplingRate,\n  createPromiseBuffer,\n  deepEqual,\n  defaultLogLevel,\n  genShortID,\n  getCurrentTimestamp,\n  isArray,\n  isBoolean,\n  isDomError,\n  isDomException,\n  isElement,\n  isElementDefined,\n  isError,\n  isErrorDefined,\n  isErrorEvent,\n  isEvent,\n  isEventDefined,\n  isFunction,\n  isInstanceOf,\n  isInt,\n  isMap,\n  isMapDefined,\n  isNull,\n  isNumber,\n  isObject,\n  isPrimitive,\n  isRegExp,\n  isString,\n  isSymbol,\n  isSyntheticEvent,\n  isThenable,\n  isToString,\n  isTypeof,\n  isUndefined,\n  LogLevel,\n  noop,\n  dateNow,\n  monoNow,\n  isEmpty,\n  getCircularDependencyReplacer,\n  stringifyExternalJson,\n  stringifyObjectValues,\n  Observable,\n} from './utils';\nexport type {\n  BaseObject,\n  BaseObjectKey,\n  BaseObjectPrimitiveValue,\n  BaseObjectValue,\n  BufferItem,\n  PromiseBuffer,\n  PromiseBufferOptions,\n  PromiseProducer,\n  Subscription,\n} from './utils';\n\nexport { VERSION } from './version';\n\nexport { unknownString } from './consts';\n"]}

package/dist/esm/metas/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/metas/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC","sourcesContent":["export { initializeMetas } from './initialize';\n\nexport { registerInitialMetas } from './registerInitial';\n\nexport type {\n  Meta,\n  MetaApp,\n  MetaAttributes,\n  MetaBrowser,\n  MetaGetter,\n  MetaItem,\n  MetaK6,\n  MetaPage,\n  MetaSDK,\n  MetaSDKIntegration,\n  MetaSession,\n  MetaUser,\n  MetaView,\n  Metas,\n  MetaOverrides,\n} from './types';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/metas/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC","sourcesContent":["export { initializeMetas } from './initialize';\n\nexport { registerInitialMetas } from './registerInitial';\n\nexport type {\n  Meta,\n  MetaApp,\n  MetaAttributes,\n  MetaBrowser,\n  MetaDevice,\n  MetaGetter,\n  MetaItem,\n  MetaK6,\n  MetaOS,\n  MetaPage,\n  MetaSDK,\n  MetaSDKIntegration,\n  MetaSession,\n  MetaUser,\n  MetaView,\n  Metas,\n  MetaOverrides,\n} from './types';\n"]}

package/dist/esm/metas/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/metas/types.ts"],"names":[],"mappings":"","sourcesContent":["export type MetaGetter<P = Partial<Meta>> = () => P;\n\nexport type MetaItem<P = Partial<Meta>> = P | MetaGetter<P>;\n\nexport type MetasListener = (value: Meta) => void;\n\nexport interface Metas {\n  add: (...getters: MetaItem[]) => void;\n  remove: (...getters: MetaItem[]) => void;\n  addListener: (listener: MetasListener) => void;\n  removeListener: (listener: MetasListener) => void;\n  value: Meta;\n}\n\nexport type MetaAttributes = Record<string, string>;\n\nexport interface MetaSDKIntegration {\n  name?: string;\n  version?: string;\n}\n\nexport interface MetaSDK {\n  name?: string;\n  version?: string;\n  integrations?: MetaSDKIntegration[];\n}\n\nexport interface MetaApp {\n  name?: string;\n  namespace?: string;\n  release?: string;\n  version?: string;\n  environment?: string;\n  bundleId?: string;\n}\n\nexport interface MetaUser {\n  /**\n   * User email address.\n   */\n  email?: string;\n  /**\n   * Unique identifier\n   */\n  id?: string;\n  /**\n   * Short name or login/username of the user.\n   */\n  username?: string;\n  /**\n   * User’s full name\n   */\n  fullName?: string;\n  /**\n   * comma separated list of user roles. \"admin\",editor\" etc.\n   */\n  roles?: string;\n  /**\n   * Unique user hash to correlate information for a user in anonymized form.\n   */\n  hash?: string;\n  /**\n   * arbitrary user attributes, must be of type string.\n   */\n  attributes?: MetaAttributes;\n}\n\nexport interface MetaSession {\n  id?: string;\n  attributes?: MetaAttributes;\n  overrides?: MetaOverrides;\n}\n\nexport interface MetaPage {\n  id?: string;\n  url?: string;\n  attributes?: MetaAttributes;\n}\n\ninterface NavigatorUABrandVersion {\n  brand?: string;\n  version?: string;\n}\n\nexport interface MetaBrowser {\n  name?: string;\n  version?: string;\n  os?: string;\n  mobile?: boolean;\n  userAgent?: string;\n  language?: string;\n  brands?: NavigatorUABrandVersion[] | string;\n  viewportWidth?: string;\n  viewportHeight?: string;\n}\n\nexport interface MetaView {\n  name: string;\n}\n\nexport interface MetaK6 {\n  isK6Browser?: boolean;\n  testRunId?: string;\n}\n\nexport interface Meta {\n  sdk?: MetaSDK;\n  app?: MetaApp;\n  user?: MetaUser;\n  session?: MetaSession;\n  page?: MetaPage;\n  browser?: MetaBrowser;\n  view?: MetaView;\n  k6?: MetaK6;\n}\n\n/**\n * MetaOverrides are instructions that allow the receiver to override certain properties (Grafana Cloud only).\n */\nexport type MetaOverrides = {\n  /**\n   * New service name (Grafana Cloud only)\n   */\n  serviceName?: string;\n\n  /**\n   * Enable or disable geolocation tracking (Grafana Cloud only).\n   * Geolocation tracking must be enabled in the Grafana Cloud settings first.\n   * It cannot be enabled solely on the client side.\n   * This option allows control over tracking on the client side to comply with user\n   * privacy requirements.\n   */\n  geoLocationTrackingEnabled?: boolean;\n};\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/metas/types.ts"],"names":[],"mappings":"","sourcesContent":["export type MetaGetter<P = Partial<Meta>> = () => P;\n\nexport type MetaItem<P = Partial<Meta>> = P | MetaGetter<P>;\n\nexport type MetasListener = (value: Meta) => void;\n\nexport interface Metas {\n  add: (...getters: MetaItem[]) => void;\n  remove: (...getters: MetaItem[]) => void;\n  addListener: (listener: MetasListener) => void;\n  removeListener: (listener: MetasListener) => void;\n  value: Meta;\n}\n\nexport type MetaAttributes = Record<string, string>;\n\nexport interface MetaSDKIntegration {\n  name?: string;\n  version?: string;\n}\n\nexport interface MetaSDK {\n  name?: string;\n  version?: string;\n  integrations?: MetaSDKIntegration[];\n}\n\nexport interface MetaApp {\n  bundleId?: string;\n  environment?: string;\n  installationId?: string;\n  name?: string;\n  namespace?: string;\n  release?: string;\n  version?: string;\n}\n\nexport interface MetaUser {\n  /**\n   * User email address.\n   */\n  email?: string;\n  /**\n   * Unique identifier\n   */\n  id?: string;\n  /**\n   * Short name or login/username of the user.\n   */\n  username?: string;\n  /**\n   * User’s full name\n   */\n  fullName?: string;\n  /**\n   * comma separated list of user roles. \"admin\",editor\" etc.\n   */\n  roles?: string;\n  /**\n   * Unique user hash to correlate information for a user in anonymized form.\n   */\n  hash?: string;\n  /**\n   * arbitrary user attributes, must be of type string.\n   */\n  attributes?: MetaAttributes;\n}\n\nexport interface MetaSession {\n  id?: string;\n  attributes?: MetaAttributes;\n  overrides?: MetaOverrides;\n}\n\nexport interface MetaPage {\n  id?: string;\n  url?: string;\n  attributes?: MetaAttributes;\n}\n\ninterface NavigatorUABrandVersion {\n  brand?: string;\n  version?: string;\n}\n\nexport interface MetaBrowser {\n  name?: string;\n  version?: string;\n  os?: string;\n  mobile?: boolean;\n  userAgent?: string;\n  language?: string;\n  brands?: NavigatorUABrandVersion[] | string;\n  viewportWidth?: string;\n  viewportHeight?: string;\n}\n\nexport interface MetaView {\n  name: string;\n}\n\nexport interface MetaK6 {\n  isK6Browser?: boolean;\n  testRunId?: string;\n}\n\n// Fields on MetaOS and MetaDevice use snake_case to mirror the Faro spec wire\n// format, which in turn mirrors OTel `os.*` and `device.*` semantic convention\n// attribute keys (e.g. os.build_id, device.model.identifier). Intentionally\n// inconsistent with the camelCase used elsewhere in Meta.\nexport interface MetaOS {\n  name?: string;\n  version?: string;\n  build_id?: string;\n  detail?: string;\n}\n\nexport interface MetaDevice {\n  manufacturer?: string;\n  model_identifier?: string;\n  model_name?: string;\n  brand?: string;\n  is_physical?: boolean;\n  type?: string;\n}\n\nexport interface Meta {\n  sdk?: MetaSDK;\n  app?: MetaApp;\n  user?: MetaUser;\n  session?: MetaSession;\n  page?: MetaPage;\n  browser?: MetaBrowser;\n  view?: MetaView;\n  k6?: MetaK6;\n  os?: MetaOS;\n  device?: MetaDevice;\n}\n\n/**\n * MetaOverrides are instructions that allow the receiver to override certain properties (Grafana Cloud only).\n */\nexport type MetaOverrides = {\n  /**\n   * New service name (Grafana Cloud only)\n   */\n  serviceName?: string;\n\n  /**\n   * Enable or disable geolocation tracking (Grafana Cloud only).\n   * Geolocation tracking must be enabled in the Grafana Cloud settings first.\n   * It cannot be enabled solely on the client side.\n   * This option allows control over tracking on the client side to comply with user\n   * privacy requirements.\n   */\n  geoLocationTrackingEnabled?: boolean;\n};\n"]}

package/dist/esm/sdk/registerFaro.js

@@ -1,6 +1,7 @@
+import { getNoopAPI } from '../api/noop';
 import { setFaroOnGlobalObject } from './faroGlobalObject';
 import { setInternalFaroOnGlobalObject } from './internalFaroGlobalObject';
-export let faro = {};
+export let faro = { api: getNoopAPI() };
 export function registerFaro(unpatchedConsole, internalLogger, config, metas, transports, api, instrumentations) {
     internalLogger.debug('Initializing Faro');
     faro = {

package/dist/esm/sdk/registerFaro.js.map

@@ -1 +1 @@
-{"version":3,"file":"registerFaro.js","sourceRoot":"","sources":["../../../src/sdk/registerFaro.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,6BAA6B,EAAE,MAAM,4BAA4B,CAAC;AAG3E,MAAM,CAAC,IAAI,IAAI,GAAS,EAAU,CAAC;AAEnC,MAAM,UAAU,YAAY,CAC1B,gBAAkC,EAClC,cAA8B,EAC9B,MAAc,EACd,KAAY,EACZ,UAAsB,EACtB,GAAQ,EACR,gBAAkC;IAElC,cAAc,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;IAE1C,IAAI,GAAG;QACL,GAAG;QACH,MAAM;QACN,gBAAgB;QAChB,cAAc;QACd,KAAK;QACL,KAAK,EAAE,UAAU,CAAC,KAAK;QACvB,UAAU;QACV,gBAAgB;QAChB,OAAO,EAAE,UAAU,CAAC,OAAO;KAC5B,CAAC;IAEF,6BAA6B,CAAC,IAAI,CAAC,CAAC;IAEpC,qBAAqB,CAAC,IAAI,CAAC,CAAC;IAE5B,OAAO,IAAI,CAAC;AACd,CAAC","sourcesContent":["import type { API } from '../api';\nimport type { Config } from '../config';\nimport type { Instrumentations } from '../instrumentations';\nimport type { InternalLogger } from '../internalLogger';\nimport type { Metas } from '../metas';\nimport type { Transports } from '../transports';\nimport type { UnpatchedConsole } from '../unpatchedConsole';\n\nimport { setFaroOnGlobalObject } from './faroGlobalObject';\nimport { setInternalFaroOnGlobalObject } from './internalFaroGlobalObject';\nimport type { Faro } from './types';\n\nexport let faro: Faro = {} as Faro;\n\nexport function registerFaro(\n  unpatchedConsole: UnpatchedConsole,\n  internalLogger: InternalLogger,\n  config: Config,\n  metas: Metas,\n  transports: Transports,\n  api: API,\n  instrumentations: Instrumentations\n): Faro {\n  internalLogger.debug('Initializing Faro');\n\n  faro = {\n    api,\n    config,\n    instrumentations,\n    internalLogger,\n    metas,\n    pause: transports.pause,\n    transports,\n    unpatchedConsole,\n    unpause: transports.unpause,\n  };\n\n  setInternalFaroOnGlobalObject(faro);\n\n  setFaroOnGlobalObject(faro);\n\n  return faro;\n}\n"]}
+{"version":3,"file":"registerFaro.js","sourceRoot":"","sources":["../../../src/sdk/registerFaro.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAQzC,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,6BAA6B,EAAE,MAAM,4BAA4B,CAAC;AAG3E,MAAM,CAAC,IAAI,IAAI,GAAS,EAAE,GAAG,EAAE,UAAU,EAAE,EAAU,CAAC;AAEtD,MAAM,UAAU,YAAY,CAC1B,gBAAkC,EAClC,cAA8B,EAC9B,MAAc,EACd,KAAY,EACZ,UAAsB,EACtB,GAAQ,EACR,gBAAkC;IAElC,cAAc,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;IAE1C,IAAI,GAAG;QACL,GAAG;QACH,MAAM;QACN,gBAAgB;QAChB,cAAc;QACd,KAAK;QACL,KAAK,EAAE,UAAU,CAAC,KAAK;QACvB,UAAU;QACV,gBAAgB;QAChB,OAAO,EAAE,UAAU,CAAC,OAAO;KAC5B,CAAC;IAEF,6BAA6B,CAAC,IAAI,CAAC,CAAC;IAEpC,qBAAqB,CAAC,IAAI,CAAC,CAAC;IAE5B,OAAO,IAAI,CAAC;AACd,CAAC","sourcesContent":["import type { API } from '../api';\nimport { getNoopAPI } from '../api/noop';\nimport type { Config } from '../config';\nimport type { Instrumentations } from '../instrumentations';\nimport type { InternalLogger } from '../internalLogger';\nimport type { Metas } from '../metas';\nimport type { Transports } from '../transports';\nimport type { UnpatchedConsole } from '../unpatchedConsole';\n\nimport { setFaroOnGlobalObject } from './faroGlobalObject';\nimport { setInternalFaroOnGlobalObject } from './internalFaroGlobalObject';\nimport type { Faro } from './types';\n\nexport let faro: Faro = { api: getNoopAPI() } as Faro;\n\nexport function registerFaro(\n  unpatchedConsole: UnpatchedConsole,\n  internalLogger: InternalLogger,\n  config: Config,\n  metas: Metas,\n  transports: Transports,\n  api: API,\n  instrumentations: Instrumentations\n): Faro {\n  internalLogger.debug('Initializing Faro');\n\n  faro = {\n    api,\n    config,\n    instrumentations,\n    internalLogger,\n    metas,\n    pause: transports.pause,\n    transports,\n    unpatchedConsole,\n    unpause: transports.unpause,\n  };\n\n  setInternalFaroOnGlobalObject(faro);\n\n  setFaroOnGlobalObject(faro);\n\n  return faro;\n}\n"]}

package/dist/esm/utils/date.js

@@ -1,6 +1,29 @@
 export function dateNow() {
     return Date.now();
 }
+/**
+ * Returns a high-resolution, monotonic timestamp in milliseconds.
+ *
+ * Use this for measuring elapsed time / durations. Unlike {@link dateNow} (which is
+ * derived from the system wall clock and is therefore subject to NTP adjustments,
+ * manual clock changes, daylight-savings transitions, etc.), `monoNow` is backed by
+ * `performance.now()`, which is guaranteed never to decrease and is unaffected by
+ * such adjustments.
+ *
+ * Do NOT use this for absolute event timestamps that need to be correlated with
+ * other systems or persisted across page loads — use {@link dateNow} or
+ * {@link getCurrentTimestamp} for that.
+ *
+ * Falls back to {@link dateNow} in environments where `performance.now` is
+ * unavailable (very old runtimes, unusual SSR setups). The fallback re-introduces
+ * wall-clock susceptibility but preserves the API contract.
+ */
+export function monoNow() {
+    if (typeof performance !== 'undefined' && typeof performance.now === 'function') {
+        return performance.now();
+    }
+    return Date.now();
+}
 export function getCurrentTimestamp() {
     return new Date().toISOString();
 }

package/dist/esm/utils/date.js.map

@@ -1 +1 @@
-{"version":3,"file":"date.js","sourceRoot":"","sources":["../../../src/utils/date.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,OAAO;IACrB,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;AACvC,CAAC","sourcesContent":["export function dateNow(): number {\n  return Date.now();\n}\n\nexport function getCurrentTimestamp(): string {\n  return new Date().toISOString();\n}\n\nexport function timestampToIsoString(value: number): string {\n  return new Date(value).toISOString();\n}\n"]}
+{"version":3,"file":"date.js","sourceRoot":"","sources":["../../../src/utils/date.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,OAAO;IACrB,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC;AACpB,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,OAAO;IACrB,IAAI,OAAO,WAAW,KAAK,WAAW,IAAI,OAAO,WAAW,CAAC,GAAG,KAAK,UAAU,EAAE,CAAC;QAChF,OAAO,WAAW,CAAC,GAAG,EAAE,CAAC;IAC3B,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;AACvC,CAAC","sourcesContent":["export function dateNow(): number {\n  return Date.now();\n}\n\n/**\n * Returns a high-resolution, monotonic timestamp in milliseconds.\n *\n * Use this for measuring elapsed time / durations. Unlike {@link dateNow} (which is\n * derived from the system wall clock and is therefore subject to NTP adjustments,\n * manual clock changes, daylight-savings transitions, etc.), `monoNow` is backed by\n * `performance.now()`, which is guaranteed never to decrease and is unaffected by\n * such adjustments.\n *\n * Do NOT use this for absolute event timestamps that need to be correlated with\n * other systems or persisted across page loads — use {@link dateNow} or\n * {@link getCurrentTimestamp} for that.\n *\n * Falls back to {@link dateNow} in environments where `performance.now` is\n * unavailable (very old runtimes, unusual SSR setups). The fallback re-introduces\n * wall-clock susceptibility but preserves the API contract.\n */\nexport function monoNow(): number {\n  if (typeof performance !== 'undefined' && typeof performance.now === 'function') {\n    return performance.now();\n  }\n  return Date.now();\n}\n\nexport function getCurrentTimestamp(): string {\n  return new Date().toISOString();\n}\n\nexport function timestampToIsoString(value: number): string {\n  return new Date(value).toISOString();\n}\n"]}

package/dist/esm/utils/index.js

@@ -7,7 +7,7 @@ export { noop } from './noop';
 export { createPromiseBuffer } from './promiseBuffer';
 export { genShortID } from './shortId';
 export { getBundleId } from './sourceMaps';
-export { dateNow } from './date';
+export { dateNow, monoNow } from './date';
 export { getCircularDependencyReplacer, stringifyExternalJson, stringifyObjectValues } from './json';
 export { Observable } from './reactive';
 //# sourceMappingURL=index.js.map

package/dist/esm/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAE7C,OAAO,EACL,OAAO,EACP,SAAS,EACT,UAAU,EACV,cAAc,EACd,SAAS,EACT,gBAAgB,EAChB,OAAO,EACP,cAAc,EACd,YAAY,EACZ,OAAO,EACP,cAAc,EACd,UAAU,EACV,YAAY,EACZ,KAAK,EACL,KAAK,EACL,YAAY,EACZ,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,gBAAgB,EAChB,UAAU,EACV,UAAU,EACV,QAAQ,EACR,WAAW,EACX,OAAO,GACR,MAAM,MAAM,CAAC;AAGd,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEtE,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE9B,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAGtD,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEjC,OAAO,EAAE,6BAA6B,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,QAAQ,CAAC;AAErG,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC","sourcesContent":["export type { BaseObject, BaseObjectKey, BaseObjectPrimitiveValue, BaseObjectValue } from './baseObject';\n\nexport { clampSamplingRate } from './sampling';\n\nexport { deepEqual } from './deepEqual';\n\nexport { getCurrentTimestamp } from './date';\n\nexport {\n  isArray,\n  isBoolean,\n  isDomError,\n  isDomException,\n  isElement,\n  isElementDefined,\n  isError,\n  isErrorDefined,\n  isErrorEvent,\n  isEvent,\n  isEventDefined,\n  isFunction,\n  isInstanceOf,\n  isInt,\n  isMap,\n  isMapDefined,\n  isNull,\n  isNumber,\n  isObject,\n  isPrimitive,\n  isRegExp,\n  isString,\n  isSymbol,\n  isSyntheticEvent,\n  isThenable,\n  isToString,\n  isTypeof,\n  isUndefined,\n  isEmpty,\n} from './is';\nexport type { IsFnHelper } from './is';\n\nexport { allLogLevels, defaultLogLevel, LogLevel } from './logLevels';\n\nexport { noop } from './noop';\n\nexport { createPromiseBuffer } from './promiseBuffer';\nexport type { BufferItem, PromiseBuffer, PromiseBufferOptions, PromiseProducer } from './promiseBuffer';\n\nexport { genShortID } from './shortId';\n\nexport { getBundleId } from './sourceMaps';\n\nexport { dateNow } from './date';\n\nexport { getCircularDependencyReplacer, stringifyExternalJson, stringifyObjectValues } from './json';\n\nexport { Observable } from './reactive';\nexport type { Subscription } from './reactive';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAE7C,OAAO,EACL,OAAO,EACP,SAAS,EACT,UAAU,EACV,cAAc,EACd,SAAS,EACT,gBAAgB,EAChB,OAAO,EACP,cAAc,EACd,YAAY,EACZ,OAAO,EACP,cAAc,EACd,UAAU,EACV,YAAY,EACZ,KAAK,EACL,KAAK,EACL,YAAY,EACZ,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,gBAAgB,EAChB,UAAU,EACV,UAAU,EACV,QAAQ,EACR,WAAW,EACX,OAAO,GACR,MAAM,MAAM,CAAC;AAGd,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEtE,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE9B,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAGtD,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAE1C,OAAO,EAAE,6BAA6B,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,QAAQ,CAAC;AAErG,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC","sourcesContent":["export type { BaseObject, BaseObjectKey, BaseObjectPrimitiveValue, BaseObjectValue } from './baseObject';\n\nexport { clampSamplingRate } from './sampling';\n\nexport { deepEqual } from './deepEqual';\n\nexport { getCurrentTimestamp } from './date';\n\nexport {\n  isArray,\n  isBoolean,\n  isDomError,\n  isDomException,\n  isElement,\n  isElementDefined,\n  isError,\n  isErrorDefined,\n  isErrorEvent,\n  isEvent,\n  isEventDefined,\n  isFunction,\n  isInstanceOf,\n  isInt,\n  isMap,\n  isMapDefined,\n  isNull,\n  isNumber,\n  isObject,\n  isPrimitive,\n  isRegExp,\n  isString,\n  isSymbol,\n  isSyntheticEvent,\n  isThenable,\n  isToString,\n  isTypeof,\n  isUndefined,\n  isEmpty,\n} from './is';\nexport type { IsFnHelper } from './is';\n\nexport { allLogLevels, defaultLogLevel, LogLevel } from './logLevels';\n\nexport { noop } from './noop';\n\nexport { createPromiseBuffer } from './promiseBuffer';\nexport type { BufferItem, PromiseBuffer, PromiseBufferOptions, PromiseProducer } from './promiseBuffer';\n\nexport { genShortID } from './shortId';\n\nexport { getBundleId } from './sourceMaps';\n\nexport { dateNow, monoNow } from './date';\n\nexport { getCircularDependencyReplacer, stringifyExternalJson, stringifyObjectValues } from './json';\n\nexport { Observable } from './reactive';\nexport type { Subscription } from './reactive';\n"]}

package/dist/esm/version.js

@@ -1,3 +1,3 @@
 // auto-generated by bin/genVersion.ts
-export const VERSION = '2.3.1';
+export const VERSION = '2.5.0';
 //# sourceMappingURL=version.js.map

package/dist/esm/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC","sourcesContent":["// auto-generated by bin/genVersion.ts\nexport const VERSION = '2.3.1';\n"]}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC","sourcesContent":["// auto-generated by bin/genVersion.ts\nexport const VERSION = '2.5.0';\n"]}

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

@@ -21,6 +21,7 @@ export interface ExceptionEventDefault {
     timestamp: string;
     type: string;
     value: string;
+    fatal?: boolean;
     fingerprint?: string;
     stacktrace?: Stacktrace;
     trace?: TraceContext;
@@ -37,6 +38,7 @@ export type ExceptionEventExtended = ExceptionEventDefault & {
 };
 export type ExceptionEvent<EXTENDED = ExceptionEventDefault> = EXTENDED extends boolean ? ExceptionEventExtended : ExceptionEventDefault;
 export interface PushErrorOptions {
+    fatal?: boolean;
     fingerprint?: string;
     skipDedupe?: boolean;
     stackFrames?: ExceptionStackFrame[];

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

@@ -1,4 +1,5 @@
 export { initializeAPI } from './initialize';
+export { getNoopAPI } from './noop';
 export type { API, APIEvent, UserAction } from './types';
 export type { EventAttributes, EventEvent, EventsAPI, PushEventOptions } from './events';
 export { defaultExceptionType, defaultErrorArgsSerializer } from './exceptions';

package/dist/types/api/noop.d.ts

@@ -0,0 +1,2 @@
+import type { API } from './types';
+export declare function getNoopAPI(): API;

package/dist/types/api/userActions/userAction.d.ts

@@ -12,6 +12,7 @@ export default class UserAction extends Observable implements UserActionInternal
     trigger: string;
     importance: UserActionImportanceType;
     startTime?: number;
+    private _startTimeMono?;
     trackUserActionsExcludeItem?: (item: TransportItem<APIEvent>) => boolean;
     private _state;
     private _itemBuffer;

package/dist/types/extensions/baseExtension.d.ts

@@ -5,7 +5,7 @@ export declare abstract class BaseExtension implements Extension {
     abstract readonly name: string;
     abstract readonly version: string;
     unpatchedConsole: Console;
-    internalLogger: import("../internalLogger").InternalLogger;
+    internalLogger: import("..").InternalLogger;
     config: Config;
     metas: Metas;
     logDebug(...args: unknown[]): void;

package/dist/types/index.d.ts

@@ -11,7 +11,7 @@ export { BaseInstrumentation } from './instrumentations';
 export type { Instrumentation, Instrumentations } from './instrumentations';
 export { createInternalLogger, defaultInternalLoggerLevel, InternalLoggerLevel } from './internalLogger';
 export type { InternalLogger } from './internalLogger';
-export type { Meta, MetaApp, MetaAttributes, MetaBrowser, MetaGetter, MetaItem, MetaPage, Metas, MetaSDK, MetaSDKIntegration, MetaSession, MetaUser, MetaView, MetaOverrides, } from './metas';
+export type { Meta, MetaApp, MetaAttributes, MetaBrowser, MetaDevice, MetaGetter, MetaItem, MetaOS, MetaPage, Metas, MetaSDK, MetaSDKIntegration, MetaSession, MetaUser, MetaView, MetaOverrides, } from './metas';
 export { faro, getInternalFaroFromGlobalObject, internalGlobalObjectKey, isInternalFaroOnGlobalObject, setInternalFaroOnGlobalObject, } from './sdk';
 export type { Faro } from './sdk';
 export * from './semantic';
@@ -19,7 +19,7 @@ export { BaseTransport, getTransportBody, TransportItemType, transportItemTypeTo
 export type { BeforeSendHook, SendFn, Transport, TransportBody, TransportItem, TransportItemPayload, Transports, } from './transports';
 export { defaultUnpatchedConsole } from './unpatchedConsole';
 export type { UnpatchedConsole } from './unpatchedConsole';
-export { allLogLevels, clampSamplingRate, 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, stringifyObjectValues, Observable, } from './utils';
+export { allLogLevels, clampSamplingRate, 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, monoNow, isEmpty, getCircularDependencyReplacer, stringifyExternalJson, stringifyObjectValues, Observable, } from './utils';
 export type { BaseObject, BaseObjectKey, BaseObjectPrimitiveValue, BaseObjectValue, BufferItem, PromiseBuffer, PromiseBufferOptions, PromiseProducer, Subscription, } from './utils';
 export { VERSION } from './version';
 export { unknownString } from './consts';

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

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

package/dist/types/metas/types.d.ts

@@ -19,12 +19,13 @@ export interface MetaSDK {
     integrations?: MetaSDKIntegration[];
 }
 export interface MetaApp {
+    bundleId?: string;
+    environment?: string;
+    installationId?: string;
     name?: string;
     namespace?: string;
     release?: string;
     version?: string;
-    environment?: string;
-    bundleId?: string;
 }
 export interface MetaUser {
     /**
@@ -88,6 +89,20 @@ export interface MetaK6 {
     isK6Browser?: boolean;
     testRunId?: string;
 }
+export interface MetaOS {
+    name?: string;
+    version?: string;
+    build_id?: string;
+    detail?: string;
+}
+export interface MetaDevice {
+    manufacturer?: string;
+    model_identifier?: string;
+    model_name?: string;
+    brand?: string;
+    is_physical?: boolean;
+    type?: string;
+}
 export interface Meta {
     sdk?: MetaSDK;
     app?: MetaApp;
@@ -97,6 +112,8 @@ export interface Meta {
     browser?: MetaBrowser;
     view?: MetaView;
     k6?: MetaK6;
+    os?: MetaOS;
+    device?: MetaDevice;
 }
 /**
  * MetaOverrides are instructions that allow the receiver to override certain properties (Grafana Cloud only).

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

@@ -4,7 +4,7 @@ import type { Transport, TransportItem } from '../transports';
 export declare class MockTransport extends BaseTransport implements Transport {
     private ignoreURLs;
     readonly name = "@grafana/transport-mock";
-    readonly version = "2.3.1";
+    readonly version = "2.5.0";
     items: TransportItem[];
     constructor(ignoreURLs?: Patterns);
     send(items: TransportItem[]): void | Promise<void>;

package/dist/types/utils/date.d.ts

@@ -1,3 +1,21 @@
 export declare function dateNow(): number;
+/**
+ * Returns a high-resolution, monotonic timestamp in milliseconds.
+ *
+ * Use this for measuring elapsed time / durations. Unlike {@link dateNow} (which is
+ * derived from the system wall clock and is therefore subject to NTP adjustments,
+ * manual clock changes, daylight-savings transitions, etc.), `monoNow` is backed by
+ * `performance.now()`, which is guaranteed never to decrease and is unaffected by
+ * such adjustments.
+ *
+ * Do NOT use this for absolute event timestamps that need to be correlated with
+ * other systems or persisted across page loads — use {@link dateNow} or
+ * {@link getCurrentTimestamp} for that.
+ *
+ * Falls back to {@link dateNow} in environments where `performance.now` is
+ * unavailable (very old runtimes, unusual SSR setups). The fallback re-introduces
+ * wall-clock susceptibility but preserves the API contract.
+ */
+export declare function monoNow(): number;
 export declare function getCurrentTimestamp(): string;
 export declare function timestampToIsoString(value: number): string;

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

@@ -10,7 +10,7 @@ export { createPromiseBuffer } from './promiseBuffer';
 export type { BufferItem, PromiseBuffer, PromiseBufferOptions, PromiseProducer } from './promiseBuffer';
 export { genShortID } from './shortId';
 export { getBundleId } from './sourceMaps';
-export { dateNow } from './date';
+export { dateNow, monoNow } from './date';
 export { getCircularDependencyReplacer, stringifyExternalJson, stringifyObjectValues } from './json';
 export { Observable } from './reactive';
 export type { Subscription } from './reactive';

package/dist/types/version.d.ts

@@ -1 +1 @@
-export declare const VERSION = "2.3.1";
+export declare const VERSION = "2.5.0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grafana/faro-core",
-  "version": "2.3.1",
+  "version": "2.5.0",
   "description": "Core package of Faro.",
   "keywords": [
     "observability",
@@ -56,13 +56,13 @@
   },
   "dependencies": {
     "@opentelemetry/api": "^1.9.0",
-    "@opentelemetry/otlp-transformer": "^0.213.0"
+    "@opentelemetry/otlp-transformer": "^0.216.0"
   },
   "devDependencies": {
-    "@types/node": "24.12.0"
+    "@types/node": "24.12.2"
   },
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "ad85e008b4e2e50398bf0bb12cdcad03dd996101"
+  "gitHead": "be7742480b1b4d936f3476620aab338237ae16ca"
 }

package/dist/spec/core/src/api/ItemBuffer.js

@@ -1,27 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ItemBuffer = void 0;
-var is_1 = require("../utils/is");
-var ItemBuffer = /** @class */ (function () {
-    function ItemBuffer() {
-        this.buffer = [];
-    }
-    ItemBuffer.prototype.addItem = function (item) {
-        this.buffer.push(item);
-    };
-    ItemBuffer.prototype.flushBuffer = function (cb) {
-        if ((0, is_1.isFunction)(cb)) {
-            for (var _i = 0, _a = this.buffer; _i < _a.length; _i++) {
-                var item = _a[_i];
-                cb(item);
-            }
-        }
-        this.buffer.length = 0;
-    };
-    ItemBuffer.prototype.size = function () {
-        return this.buffer.length;
-    };
-    return ItemBuffer;
-}());
-exports.ItemBuffer = ItemBuffer;
-//# sourceMappingURL=ItemBuffer.js.map

package/dist/spec/core/src/api/ItemBuffer.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ItemBuffer.js","sourceRoot":"","sources":["../../../../../src/api/ItemBuffer.ts"],"names":[],"mappings":";;;AAAA,kCAAyC;AAEzC;IAGE;QACE,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;IACnB,CAAC;IAED,4BAAO,GAAP,UAAQ,IAAO;QACb,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAED,gCAAW,GAAX,UAAY,EAAsB;QAChC,IAAI,IAAA,eAAU,EAAC,EAAE,CAAC,EAAE,CAAC;YACnB,KAAmB,UAAW,EAAX,KAAA,IAAI,CAAC,MAAM,EAAX,cAAW,EAAX,IAAW,EAAE,CAAC;gBAA5B,IAAM,IAAI,SAAA;gBACb,EAAE,CAAC,IAAI,CAAC,CAAC;YACX,CAAC;QACH,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;IACzB,CAAC;IAED,yBAAI,GAAJ;QACE,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;IAC5B,CAAC;IACH,iBAAC;AAAD,CAAC,AAxBD,IAwBC;AAxBY,gCAAU","sourcesContent":["import { isFunction } from '../utils/is';\n\nexport class ItemBuffer<T> {\n  private buffer: T[];\n\n  constructor() {\n    this.buffer = [];\n  }\n\n  addItem(item: T) {\n    this.buffer.push(item);\n  }\n\n  flushBuffer(cb?: (item: T) => void) {\n    if (isFunction(cb)) {\n      for (const item of this.buffer) {\n        cb(item);\n      }\n    }\n\n    this.buffer.length = 0;\n  }\n\n  size() {\n    return this.buffer.length;\n  }\n}\n"]}

package/dist/spec/core/src/api/apiTestHelpers.js

@@ -1,40 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.mockUserActionsApi = exports.mockTracesApi = exports.mockTransports = exports.mockMetas = void 0;
-exports.mockMetas = {
-    add: jest.fn(),
-    remove: jest.fn(),
-    addListener: jest.fn(),
-    removeListener: jest.fn(),
-    value: {},
-};
-exports.mockTransports = {
-    add: jest.fn(),
-    addBeforeSendHooks: jest.fn(),
-    execute: jest.fn(),
-    getBeforeSendHooks: jest.fn(),
-    remove: jest.fn(),
-    removeBeforeSendHooks: jest.fn(),
-    isPaused: function () {
-        throw new Error('Function not implemented.');
-    },
-    transports: [],
-    pause: function () {
-        throw new Error('Function not implemented.');
-    },
-    unpause: function () {
-        throw new Error('Function not implemented.');
-    },
-};
-exports.mockTracesApi = {
-    getOTEL: jest.fn(),
-    getTraceContext: jest.fn(),
-    initOTEL: jest.fn(),
-    isOTELInitialized: jest.fn(),
-    pushTraces: jest.fn(),
-};
-exports.mockUserActionsApi = {
-    startUserAction: jest.fn(),
-    getActiveUserAction: jest.fn(),
-};
-//# sourceMappingURL=apiTestHelpers.js.map

package/dist/spec/core/src/api/apiTestHelpers.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"apiTestHelpers.js","sourceRoot":"","sources":["../../../../../src/api/apiTestHelpers.ts"],"names":[],"mappings":";;;AAKa,QAAA,SAAS,GAAG;IACvB,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE;IACd,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE;IACjB,WAAW,EAAE,IAAI,CAAC,EAAE,EAAE;IACtB,cAAc,EAAE,IAAI,CAAC,EAAE,EAAE;IACzB,KAAK,EAAE,EAAE;CACV,CAAC;AAEW,QAAA,cAAc,GAAe;IACxC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE;IACd,kBAAkB,EAAE,IAAI,CAAC,EAAE,EAAE;IAC7B,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE;IAClB,kBAAkB,EAAE,IAAI,CAAC,EAAE,EAAE;IAC7B,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE;IACjB,qBAAqB,EAAE,IAAI,CAAC,EAAE,EAAE;IAChC,QAAQ,EAAE;QACR,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC/C,CAAC;IACD,UAAU,EAAE,EAAE;IACd,KAAK,EAAE;QACL,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,EAAE;QACP,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC/C,CAAC;CACF,CAAC;AAEW,QAAA,aAAa,GAAc;IACtC,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE;IAClB,eAAe,EAAE,IAAI,CAAC,EAAE,EAAE;IAC1B,QAAQ,EAAE,IAAI,CAAC,EAAE,EAAE;IACnB,iBAAiB,EAAE,IAAI,CAAC,EAAE,EAAE;IAC5B,UAAU,EAAE,IAAI,CAAC,EAAE,EAAE;CACtB,CAAC;AAEW,QAAA,kBAAkB,GAAmB;IAChD,eAAe,EAAE,IAAI,CAAC,EAAE,EAAE;IAC1B,mBAAmB,EAAE,IAAI,CAAC,EAAE,EAAE;CAC/B,CAAC","sourcesContent":["import type { Transports } from '../transports';\n\nimport type { TracesAPI } from './traces/types';\nimport type { UserActionsAPI } from './userActions/types';\n\nexport const mockMetas = {\n  add: jest.fn(),\n  remove: jest.fn(),\n  addListener: jest.fn(),\n  removeListener: jest.fn(),\n  value: {},\n};\n\nexport const mockTransports: Transports = {\n  add: jest.fn(),\n  addBeforeSendHooks: jest.fn(),\n  execute: jest.fn(),\n  getBeforeSendHooks: jest.fn(),\n  remove: jest.fn(),\n  removeBeforeSendHooks: jest.fn(),\n  isPaused: function (): boolean {\n    throw new Error('Function not implemented.');\n  },\n  transports: [],\n  pause: function (): void {\n    throw new Error('Function not implemented.');\n  },\n  unpause: function (): void {\n    throw new Error('Function not implemented.');\n  },\n};\n\nexport const mockTracesApi: TracesAPI = {\n  getOTEL: jest.fn(),\n  getTraceContext: jest.fn(),\n  initOTEL: jest.fn(),\n  isOTELInitialized: jest.fn(),\n  pushTraces: jest.fn(),\n};\n\nexport const mockUserActionsApi: UserActionsAPI = {\n  startUserAction: jest.fn(),\n  getActiveUserAction: jest.fn(),\n};\n"]}

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

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

package/dist/spec/core/src/api/events/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/api/events/index.ts"],"names":[],"mappings":";;;AACA,2CAAmD;AAA1C,iHAAA,mBAAmB,OAAA","sourcesContent":["export type { EventAttributes, EventEvent, EventsAPI, PushEventOptions } from './types';\nexport { initializeEventsAPI } from './initialize';\n"]}