@grafana/faro-core 1.14.1 → 1.14.2

package/dist/spec/core/src/api/userActionLifecycleHandler.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"userActionLifecycleHandler.test.js","sourceRoot":"","sources":["../../../../../src/api/userActionLifecycleHandler.test.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  type APIEvent,\n  ApiMessageBusMessages,\n  type Config,\n  dateNow,\n  EventEvent,\n  type Meta,\n  TransportItem,\n  TransportItemType,\n  UserActionStartMessage,\n} from '..';\nimport { Observable } from '../utils/reactive';\n\nimport { mockTransports } from './apiTestHelpers';\nimport { USER_ACTION_CANCEL_MESSAGE_TYPE, USER_ACTION_END_MESSAGE_TYPE, USER_ACTION_START_MESSAGE_TYPE } from './const';\nimport { createUserActionLifecycleHandler } from './userActionLifecycleHandler';\n\ndescribe('userActionLifecycleHandler', () => {\n  it('assigns the user-action-start message to the message variable when it receives it', () => {\n    const apiMessageBus = new Observable<ApiMessageBusMessages>();\n\n    const { getMessage } = createUserActionLifecycleHandler({\n      apiMessageBus,\n      transports: mockTransports,\n      config: {} as Config,\n    });\n\n    const message: UserActionStartMessage = {\n      type: USER_ACTION_START_MESSAGE_TYPE,\n      name: '',\n      startTime: 0,\n      parentId: '',\n    };\n\n    apiMessageBus.notify(message);\n\n    expect(getMessage()).toEqual(message);\n  });\n\n  it('When it receives a user-action-cancel message, it resets the cached message flushes the buffer and sends the items to the transports', () => {\n    const apiMessageBus = new Observable<ApiMessageBusMessages>();\n\n    const mockExecute = jest.fn();\n    const { actionBuffer, getMessage } = createUserActionLifecycleHandler({\n      apiMessageBus,\n      transports: {\n        ...mockTransports,\n        execute: mockExecute,\n      },\n      config: {} as Config,\n    });\n\n    const message: UserActionStartMessage = {\n      type: USER_ACTION_START_MESSAGE_TYPE,\n      name: '',\n      startTime: 0,\n      parentId: '',\n    };\n\n    apiMessageBus.notify(message);\n\n    const item = { type: TransportItemType.EVENT, payload: {}, meta: {} as Meta };\n    actionBuffer.addItem(item);\n\n    const cancelMessage: ApiMessageBusMessages = {\n      type: USER_ACTION_CANCEL_MESSAGE_TYPE,\n      name: 'pointerdown',\n    };\n\n    apiMessageBus.notify(cancelMessage);\n\n    expect(getMessage()).toBeUndefined();\n    expect(mockExecute).toHaveBeenCalledTimes(1);\n    expect(mockExecute).toHaveBeenCalledWith(item);\n    expect(actionBuffer.size()).toEqual(0);\n  });\n\n  it('When it receives a user-action-end message, it sends the items to the transports with the action parentId and name', () => {\n    const apiMessageBus = new Observable<ApiMessageBusMessages>();\n\n    const mockExecute = jest.fn();\n    const { actionBuffer } = createUserActionLifecycleHandler({\n      apiMessageBus,\n      transports: {\n        ...mockTransports,\n        execute: mockExecute,\n      },\n      config: {} as Config,\n    });\n\n    const message: UserActionStartMessage = {\n      type: USER_ACTION_START_MESSAGE_TYPE,\n      name: 'pointerdown',\n      startTime: 0,\n      parentId: '123',\n    };\n\n    apiMessageBus.notify(message);\n\n    const item = { type: TransportItemType.EVENT, payload: {}, meta: {} as Meta };\n    actionBuffer.addItem(item);\n\n    const endMessage: ApiMessageBusMessages = {\n      type: USER_ACTION_END_MESSAGE_TYPE,\n      id: '123',\n      name: 'pointerdown',\n      startTime: 100,\n      endTime: 120,\n      duration: 20,\n      eventType: 'keydown',\n    };\n\n    apiMessageBus.notify(endMessage);\n\n    expect(mockExecute).toHaveBeenCalledTimes(1);\n    expect(mockExecute).toHaveBeenCalledWith({\n      ...item,\n      payload: {\n        ...item.payload,\n        action: {\n          parentId: '123',\n          name: 'pointerdown',\n        },\n      },\n    });\n  });\n\n  it('excludes items defined by the isExcludeFromUserAction function from the user actions', () => {\n    const apiMessageBus = new Observable<ApiMessageBusMessages>();\n\n    const mockExecute = jest.fn();\n    const { actionBuffer, getMessage } = createUserActionLifecycleHandler({\n      apiMessageBus,\n      transports: {\n        ...mockTransports,\n        execute: mockExecute,\n      },\n      config: {\n        trackUserActionsExcludeItem(item) {\n          return item.type === TransportItemType.EVENT && (item.payload as EventEvent).name === 'i-am-excluded';\n        },\n      } as Config,\n    });\n\n    const message: UserActionStartMessage = {\n      type: USER_ACTION_START_MESSAGE_TYPE,\n      name: 'pointerdown',\n      startTime: 0,\n      parentId: '123',\n    };\n\n    apiMessageBus.notify(message);\n\n    const itemEvent = { type: TransportItemType.EVENT, payload: {}, meta: {} as Meta };\n    actionBuffer.addItem(itemEvent);\n\n    const itemMeasurement: TransportItem<APIEvent> = {\n      type: TransportItemType.MEASUREMENT,\n      payload: { type: 'web-vitals', values: {}, timestamp: dateNow().toString() },\n      meta: {} as Meta,\n    };\n    actionBuffer.addItem(itemMeasurement);\n\n    const itemEventExcluded: TransportItem<EventEvent> = {\n      type: TransportItemType.EVENT,\n      payload: {\n        timestamp: dateNow().toString(),\n        name: 'i-am-excluded',\n      },\n      meta: {} as Meta,\n    };\n    actionBuffer.addItem(itemEventExcluded);\n\n    const endMessage: ApiMessageBusMessages = {\n      type: USER_ACTION_END_MESSAGE_TYPE,\n      id: '123',\n      name: 'pointerdown',\n      startTime: 100,\n      endTime: 120,\n      duration: 20,\n      eventType: 'keydown',\n    };\n\n    apiMessageBus.notify(endMessage);\n\n    expect(mockExecute).toHaveBeenCalledTimes(3);\n    expect(mockExecute).toHaveBeenNthCalledWith(1, {\n      ...itemEvent,\n      payload: {\n        ...itemEvent.payload,\n        action: {\n          parentId: '123',\n          name: 'pointerdown',\n        },\n      },\n    });\n    expect(mockExecute).toHaveBeenNthCalledWith(2, itemMeasurement);\n    expect(mockExecute).toHaveBeenNthCalledWith(3, itemEventExcluded);\n    expect(getMessage()).toBeUndefined();\n  });\n});\n"]}

package/dist/spec/core/src/config/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/config/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { APIEvent, LogArgsSerializer, StacktraceParser } from '../api';\nimport type { Instrumentation } from '../instrumentations';\nimport type { InternalLoggerLevel } from '../internalLogger';\nimport type { Meta, MetaApp, MetaItem, MetaPage, MetaSession, MetaUser, MetaView } from '../metas';\nimport type { BatchExecutorOptions, BeforeSendHook, Transport } from '../transports';\nimport type { UnpatchedConsole } from '../unpatchedConsole';\nimport type { LogLevel } from '../utils';\n\ntype SamplingContext = {\n  metas: Meta;\n};\n\nexport interface Config<P = APIEvent> {\n  /**\n   * Application metadata\n   */\n  app: MetaApp;\n\n  /**\n   * Set max number and max interval for signals to be batched before sending\n   */\n  batching?: BatchExecutorOptions;\n\n  /**\n   * A flag for toggling deduplication for signals\n   */\n  dedupe: boolean;\n\n  /**\n   * The key (name) to use for the global Faro object (default: 'faro')\n   */\n  globalObjectKey: string;\n\n  /**\n   * The (custom) instrumentations to use with Faro\n   */\n  instrumentations: Instrumentation[];\n\n  /**\n   * The level of information printed to console for internal messages (default: LogLevel.ERROR)\n   */\n  internalLoggerLevel: InternalLoggerLevel;\n\n  /**\n   * Isolate Faro instance from other Faro instances on the same page. (default: false)\n   */\n  isolate: boolean;\n\n  /**\n   * Custom function to serialize log arguments\n   */\n  logArgsSerializer?: LogArgsSerializer;\n\n  /**\n   * Add custom Metas during Faro initialization\n   */\n  metas: MetaItem[];\n\n  /**\n   * Custom function used to parse stack traces\n   */\n  parseStacktrace: StacktraceParser;\n\n  /**\n   * Pause sending data (default: false)\n   */\n  paused: boolean;\n\n  /**\n   * Prevent Faro from exposing itself to the global object (default: false)\n   */\n  preventGlobalExposure: boolean;\n\n  /**\n   * The transports to use for sending beacons\n   */\n  transports: Transport[];\n\n  /**\n   * Some instrumentations might override the default console methods but Faro instance provides a\n   * way to access the unmodified console methods.\n   *\n   * faro.unpatchedConsole.log('This is a log');\n   * faro.unpatchedConsole.warn('This is a warning');\n   */\n  unpatchedConsole: UnpatchedConsole;\n\n  /**\n   * Function which invoked before pushing event to transport. Can be used to modify or filter events\n   */\n  beforeSend?: BeforeSendHook<P>;\n\n  /**\n   * Error message patterns for errors that should be ignored\n   */\n  ignoreErrors?: Patterns;\n\n  /**\n   * Path patterns for Endpoints that should be ignored form being tracked\n   */\n  ignoreUrls?: Patterns;\n\n  /**\n   * Configuration for the built in session tracker\n   */\n  sessionTracking?: {\n    /**\n     * Enable session tracking (default: true)\n     */\n    enabled?: boolean;\n    /**\n     * Wether to use sticky sessions (default: false)\n     */\n    persistent?: boolean;\n    /**\n     * Session metadata object to be used when initializing session tracking\n     */\n    session?: MetaSession;\n    /**\n     * How long is a sticky session valid for recurring users (default: 15 minutes)\n     */\n    maxSessionPersistenceTime?: number;\n    /**\n     * Called each time a session changes. This can be when a new session is created or when an existing session is updated.\n     * @param oldSession\n     * @param newSession\n     */\n    onSessionChange?: (oldSession: MetaSession | null, newSession: MetaSession) => void;\n    /**\n     * Then sampling rate for the session based sampler (default: 1). If a session is not part of a sample, no signals for this session are tracked.\n     */\n    samplingRate?: number;\n    /**\n     * Custom sampler function if custom sampling logic is needed.\n     * @param context\n     */\n    sampler?: (context: SamplingContext) => number;\n    /**\n     * Custom function to generate session id. If available Faro uses this function instead of the internal one.\n     */\n    generateSessionId?: () => string;\n  };\n\n  /**\n   * Meta object for user data\n   */\n  user?: MetaUser;\n\n  /**\n   * Meta object for view data\n   */\n  view?: MetaView;\n\n  eventDomain?: string;\n\n  /**\n   * Only resource timings for fetch and xhr requests are tracked by default. Set this to true to track all resources (default: false).\n   */\n  trackResources?: boolean;\n\n  /**\n   * Track web vitals attribution data (default: false)\n   */\n  trackWebVitalsAttribution?: boolean;\n\n  /**\n   * Configuration for the web vitals instrumentation\n   */\n  webVitalsInstrumentation?: {\n    /**\n     * Report all changes for web vitals (default: false)\n     *\n     * In most cases, you only want the callback function to be called when the metric is ready to be reported.\n     * However, it is possible to report every change (e.g. each larger layout shift as it happens)\n     * by setting reportAllChanges to true.\n     *\n     * This can be useful when debugging, but in general using reportAllChanges is not needed (or recommended)\n     * for measuring these metrics in production.\n     */\n    reportAllChanges?: boolean;\n  };\n\n  /**\n   * Configuration for the console instrumentation\n   */\n  consoleInstrumentation?: {\n    /**\n     * Configure what console levels should be captured by Faro. By default the following levels\n     * are disabled: console.debug, console.trace, console.log\n     *\n     * If you want to collect all levels set captureConsoleDisabledLevels: [];\n     * If you want to disable only some levels set captureConsoleDisabledLevels: [LogLevel.DEBUG, LogLevel.TRACE];\n     */\n    disabledLevels?: LogLevel[];\n    /*\n     * By default, Faro sends an error for console.error calls. If you want to send a log instead, set this to true.\n     */\n    consoleErrorAsLog?: boolean;\n\n    /**\n     * If true, use the default Faro error serializer for console.error calls. If false, simply call toString() on the error arguments.\n     * If enabled, payloads containing serialized errors may become very large. If left disabled, some error details may be lost.\n     * (default: false)\n     */\n    serializeErrors?: boolean;\n\n    /**\n     * Custom function to serialize Error arguments\n     */\n    errorSerializer?: LogArgsSerializer;\n  };\n\n  /**\n   * Configuration for the page tracking\n   */\n  pageTracking?: {\n    /**\n     * The page meta for initial page settings\n     */\n    page?: MetaPage;\n\n    /**\n     * Allows to provide a template for the page id\n     */\n    generatePageId?: (location: Location) => string;\n  };\n\n  /**\n   * Configuration for the location tracking (Grafana cloud only)\n   */\n  geoLocationTracking?: {\n    /**\n     * Enable or disable geolocation tracking.\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    enabled?: boolean;\n  };\n}\n\nexport type Patterns = Array<string | RegExp>;\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/config/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { APIEvent, LogArgsSerializer, StacktraceParser } from '../api';\nimport type { Instrumentation } from '../instrumentations';\nimport type { InternalLoggerLevel } from '../internalLogger';\nimport type { Meta, MetaApp, MetaItem, MetaPage, MetaSession, MetaUser, MetaView } from '../metas';\nimport type { BatchExecutorOptions, BeforeSendHook, Transport, TransportItem } from '../transports';\nimport type { UnpatchedConsole } from '../unpatchedConsole';\nimport type { LogLevel } from '../utils';\n\ntype SamplingContext = {\n  metas: Meta;\n};\n\nexport interface Config<P = APIEvent> {\n  /**\n   * Application metadata\n   */\n  app: MetaApp;\n\n  /**\n   * Set max number and max interval for signals to be batched before sending\n   */\n  batching?: BatchExecutorOptions;\n\n  /**\n   * A flag for toggling deduplication for signals\n   */\n  dedupe: boolean;\n\n  /**\n   * The key (name) to use for the global Faro object (default: 'faro')\n   */\n  globalObjectKey: string;\n\n  /**\n   * The (custom) instrumentations to use with Faro\n   */\n  instrumentations: Instrumentation[];\n\n  /**\n   * The level of information printed to console for internal messages (default: LogLevel.ERROR)\n   */\n  internalLoggerLevel: InternalLoggerLevel;\n\n  /**\n   * Isolate Faro instance from other Faro instances on the same page. (default: false)\n   */\n  isolate: boolean;\n\n  /**\n   * Custom function to serialize log arguments\n   */\n  logArgsSerializer?: LogArgsSerializer;\n\n  /**\n   * Add custom Metas during Faro initialization\n   */\n  metas: MetaItem[];\n\n  /**\n   * Custom function used to parse stack traces\n   */\n  parseStacktrace: StacktraceParser;\n\n  /**\n   * Pause sending data (default: false)\n   */\n  paused: boolean;\n\n  /**\n   * Prevent Faro from exposing itself to the global object (default: false)\n   */\n  preventGlobalExposure: boolean;\n\n  /**\n   * The transports to use for sending beacons\n   */\n  transports: Transport[];\n\n  /**\n   * Some instrumentations might override the default console methods but Faro instance provides a\n   * way to access the unmodified console methods.\n   *\n   * faro.unpatchedConsole.log('This is a log');\n   * faro.unpatchedConsole.warn('This is a warning');\n   */\n  unpatchedConsole: UnpatchedConsole;\n\n  /**\n   * Function which invoked before pushing event to transport. Can be used to modify or filter events\n   */\n  beforeSend?: BeforeSendHook<P>;\n\n  /**\n   * Error message patterns for errors that should be ignored\n   */\n  ignoreErrors?: Patterns;\n\n  /**\n   * Path patterns for Endpoints that should be ignored form being tracked\n   */\n  ignoreUrls?: Patterns;\n\n  /**\n   * Configuration for the built in session tracker\n   */\n  sessionTracking?: {\n    /**\n     * Enable session tracking (default: true)\n     */\n    enabled?: boolean;\n    /**\n     * Wether to use sticky sessions (default: false)\n     */\n    persistent?: boolean;\n    /**\n     * Session metadata object to be used when initializing session tracking\n     */\n    session?: MetaSession;\n    /**\n     * How long is a sticky session valid for recurring users (default: 15 minutes)\n     */\n    maxSessionPersistenceTime?: number;\n    /**\n     * Called each time a session changes. This can be when a new session is created or when an existing session is updated.\n     * @param oldSession\n     * @param newSession\n     */\n    onSessionChange?: (oldSession: MetaSession | null, newSession: MetaSession) => void;\n    /**\n     * Then sampling rate for the session based sampler (default: 1). If a session is not part of a sample, no signals for this session are tracked.\n     */\n    samplingRate?: number;\n    /**\n     * Custom sampler function if custom sampling logic is needed.\n     * @param context\n     */\n    sampler?: (context: SamplingContext) => number;\n    /**\n     * Custom function to generate session id. If available Faro uses this function instead of the internal one.\n     */\n    generateSessionId?: () => string;\n  };\n\n  /**\n   * Meta object for user data\n   */\n  user?: MetaUser;\n\n  /**\n   * Meta object for view data\n   */\n  view?: MetaView;\n\n  eventDomain?: string;\n\n  /**\n   * Only resource timings for fetch and xhr requests are tracked by default. Set this to true to track all resources (default: false).\n   */\n  trackResources?: boolean;\n\n  /**\n   * Track web vitals attribution data (default: false)\n   */\n  trackWebVitalsAttribution?: boolean;\n\n  /**\n   * Configuration for the web vitals instrumentation\n   */\n  webVitalsInstrumentation?: {\n    /**\n     * Report all changes for web vitals (default: false)\n     *\n     * In most cases, you only want the callback function to be called when the metric is ready to be reported.\n     * However, it is possible to report every change (e.g. each larger layout shift as it happens)\n     * by setting reportAllChanges to true.\n     *\n     * This can be useful when debugging, but in general using reportAllChanges is not needed (or recommended)\n     * for measuring these metrics in production.\n     */\n    reportAllChanges?: boolean;\n  };\n\n  /**\n   * Configuration for the console instrumentation\n   */\n  consoleInstrumentation?: {\n    /**\n     * Configure what console levels should be captured by Faro. By default the following levels\n     * are disabled: console.debug, console.trace, console.log\n     *\n     * If you want to collect all levels set captureConsoleDisabledLevels: [];\n     * If you want to disable only some levels set captureConsoleDisabledLevels: [LogLevel.DEBUG, LogLevel.TRACE];\n     */\n    disabledLevels?: LogLevel[];\n    /*\n     * By default, Faro sends an error for console.error calls. If you want to send a log instead, set this to true.\n     */\n    consoleErrorAsLog?: boolean;\n\n    /**\n     * If true, use the default Faro error serializer for console.error calls. If false, simply call toString() on the error arguments.\n     * If enabled, payloads containing serialized errors may become very large. If left disabled, some error details may be lost.\n     * (default: false)\n     */\n    serializeErrors?: boolean;\n\n    /**\n     * Custom function to serialize Error arguments\n     */\n    errorSerializer?: LogArgsSerializer;\n  };\n\n  /**\n   * Configuration for the page tracking\n   */\n  pageTracking?: {\n    /**\n     * The page meta for initial page settings\n     */\n    page?: MetaPage;\n\n    /**\n     * Allows to provide a template for the page id\n     */\n    generatePageId?: (location: Location) => string;\n  };\n\n  /**\n   * Enable or disable geolocation tracking.\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  trackGeolocation?: boolean;\n\n  /**\n   * This is a preview feature.\n   * We have tested it thoroughly, but it is possible that it might not work as expected in all cases.\n   */\n  // TODO: remove preview postfix when feature is ga\n  trackUserActionsPreview?: boolean;\n\n  /**\n   * Configure your own attribute name for tracking user actions. Default is 'data-faro-user-action-name'\n   */\n  trackUserActionsDataAttributeName?: string;\n\n  /**\n   * Predicate function to exclude items from user actions.\n   * If the function returns true, the item will be excluded from user actions.\n   */\n  trackUserActionsExcludeItem?: (item: TransportItem<APIEvent>) => boolean;\n}\n\nexport type Patterns = Array<string | RegExp>;\n"]}

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

@@ -14,12 +14,16 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-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.stringifyObjectValues = 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;
+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.USER_ACTION_START_MESSAGE_TYPE = exports.USER_ACTION_END_MESSAGE_TYPE = exports.USER_ACTION_CANCEL_MESSAGE_TYPE = exports.apiMessageBus = exports.defaultErrorArgsSerializer = exports.defaultLogArgsSerializer = exports.defaultExceptionType = void 0;
+exports.unknownString = exports.VERSION = exports.merge = exports.Observable = exports.stringifyObjectValues = exports.stringifyExternalJson = exports.getCircularDependencyReplacer = exports.isEmpty = exports.dateNow = exports.noop = exports.LogLevel = exports.isUndefined = exports.isTypeof = exports.isToString = exports.isThenable = exports.isSyntheticEvent = exports.isSymbol = exports.isString = exports.isRegExp = exports.isPrimitive = exports.isObject = 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; } });
+Object.defineProperty(exports, "apiMessageBus", { enumerable: true, get: function () { return api_1.apiMessageBus; } });
+Object.defineProperty(exports, "USER_ACTION_CANCEL_MESSAGE_TYPE", { enumerable: true, get: function () { return api_1.USER_ACTION_CANCEL_MESSAGE_TYPE; } });
+Object.defineProperty(exports, "USER_ACTION_END_MESSAGE_TYPE", { enumerable: true, get: function () { return api_1.USER_ACTION_END_MESSAGE_TYPE; } });
+Object.defineProperty(exports, "USER_ACTION_START_MESSAGE_TYPE", { enumerable: true, get: function () { return api_1.USER_ACTION_START_MESSAGE_TYPE; } });
 var extensions_1 = require("./extensions");
 Object.defineProperty(exports, "BaseExtension", { enumerable: true, get: function () { return extensions_1.BaseExtension; } });
 var globalObject_1 = require("./globalObject");
@@ -91,6 +95,8 @@ Object.defineProperty(exports, "isEmpty", { enumerable: true, get: function () {
 Object.defineProperty(exports, "getCircularDependencyReplacer", { enumerable: true, get: function () { return utils_1.getCircularDependencyReplacer; } });
 Object.defineProperty(exports, "stringifyExternalJson", { enumerable: true, get: function () { return utils_1.stringifyExternalJson; } });
 Object.defineProperty(exports, "stringifyObjectValues", { enumerable: true, get: function () { return utils_1.stringifyObjectValues; } });
+Object.defineProperty(exports, "Observable", { enumerable: true, get: function () { return utils_1.Observable; } });
+Object.defineProperty(exports, "merge", { enumerable: true, get: function () { return utils_1.merge; } });
 var version_1 = require("./version");
 Object.defineProperty(exports, "VERSION", { enumerable: true, get: function () { return version_1.VERSION; } });
 var consts_1 = require("./consts");

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;AAAA,6BAAmG;AAA1F,2GAAA,oBAAoB,OAAA;AAAE,+GAAA,wBAAwB,OAAA;AAAE,iHAAA,0BAA0B,OAAA;AA8BnF,2CAA6C;AAApC,2GAAA,aAAa,OAAA;AAGtB,+CAA8C;AAArC,4GAAA,YAAY,OAAA;AAGrB,2CAA8C;AAArC,4GAAA,cAAc,OAAA;AAEvB,mCAAyE;AAAhE,+GAAA,qBAAqB,OAAA;AAAE,gHAAA,sBAAsB,OAAA;AAGtD,uDAAyD;AAAhD,uHAAA,mBAAmB,OAAA;AAG5B,mDAAyG;AAAhG,sHAAA,oBAAoB,OAAA;AAAE,4HAAA,0BAA0B,OAAA;AAAE,qHAAA,mBAAmB,OAAA;AAoB9E,6BAMe;AALb,2FAAA,IAAI,OAAA;AACJ,sHAAA,+BAA+B,OAAA;AAC/B,8GAAA,uBAAuB,OAAA;AACvB,mHAAA,4BAA4B,OAAA;AAC5B,oHAAA,6BAA6B,OAAA;AAI/B,6CAA2B;AAE3B,2CAA8G;AAArG,2GAAA,aAAa,OAAA;AAAE,8GAAA,gBAAgB,OAAA;AAAE,+GAAA,iBAAiB,OAAA;AAAE,wHAAA,0BAA0B,OAAA;AAWvF,uDAA6D;AAApD,2HAAA,uBAAuB,OAAA;AAGhC,iCA0CiB;AAzCf,qGAAA,YAAY,OAAA;AACZ,4GAAA,mBAAmB,OAAA;AACnB,kGAAA,SAAS,OAAA;AACT,wGAAA,eAAe,OAAA;AACf,mGAAA,UAAU,OAAA;AACV,4GAAA,mBAAmB,OAAA;AACnB,gGAAA,OAAO,OAAA;AACP,kGAAA,SAAS,OAAA;AACT,mGAAA,UAAU,OAAA;AACV,uGAAA,cAAc,OAAA;AACd,kGAAA,SAAS,OAAA;AACT,yGAAA,gBAAgB,OAAA;AAChB,gGAAA,OAAO,OAAA;AACP,uGAAA,cAAc,OAAA;AACd,qGAAA,YAAY,OAAA;AACZ,gGAAA,OAAO,OAAA;AACP,uGAAA,cAAc,OAAA;AACd,mGAAA,UAAU,OAAA;AACV,qGAAA,YAAY,OAAA;AACZ,8FAAA,KAAK,OAAA;AACL,8FAAA,KAAK,OAAA;AACL,qGAAA,YAAY,OAAA;AACZ,+FAAA,MAAM,OAAA;AACN,iGAAA,QAAQ,OAAA;AACR,iGAAA,QAAQ,OAAA;AACR,oGAAA,WAAW,OAAA;AACX,iGAAA,QAAQ,OAAA;AACR,iGAAA,QAAQ,OAAA;AACR,iGAAA,QAAQ,OAAA;AACR,yGAAA,gBAAgB,OAAA;AAChB,mGAAA,UAAU,OAAA;AACV,mGAAA,UAAU,OAAA;AACV,iGAAA,QAAQ,OAAA;AACR,oGAAA,WAAW,OAAA;AACX,iGAAA,QAAQ,OAAA;AACR,6FAAA,IAAI,OAAA;AACJ,gGAAA,OAAO,OAAA;AACP,gGAAA,OAAO,OAAA;AACP,sHAAA,6BAA6B,OAAA;AAC7B,8GAAA,qBAAqB,OAAA;AACrB,8GAAA,qBAAqB,OAAA;AAavB,qCAAoC;AAA3B,kGAAA,OAAO,OAAA;AAEhB,mCAAyC;AAAhC,uGAAA,aAAa,OAAA","sourcesContent":["export { defaultExceptionType, defaultLogArgsSerializer, defaultErrorArgsSerializer } from './api';\nexport type {\n  API,\n  APIEvent,\n  EventAttributes,\n  EventEvent,\n  EventsAPI,\n  ExceptionEvent,\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} 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  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} from './utils';\nexport type {\n  BaseObject,\n  BaseObjectKey,\n  BaseObjectPrimitiveValue,\n  BaseObjectValue,\n  BufferItem,\n  PromiseBuffer,\n  PromiseBufferOptions,\n  PromiseProducer,\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,6BAQe;AAPb,2GAAA,oBAAoB,OAAA;AACpB,+GAAA,wBAAwB,OAAA;AACxB,iHAAA,0BAA0B,OAAA;AAC1B,oGAAA,aAAa,OAAA;AACb,sHAAA,+BAA+B,OAAA;AAC/B,mHAAA,4BAA4B,OAAA;AAC5B,qHAAA,8BAA8B,OAAA;AAoChC,2CAA6C;AAApC,2GAAA,aAAa,OAAA;AAGtB,+CAA8C;AAArC,4GAAA,YAAY,OAAA;AAGrB,2CAA8C;AAArC,4GAAA,cAAc,OAAA;AAEvB,mCAAyE;AAAhE,+GAAA,qBAAqB,OAAA;AAAE,gHAAA,sBAAsB,OAAA;AAGtD,uDAAyD;AAAhD,uHAAA,mBAAmB,OAAA;AAG5B,mDAAyG;AAAhG,sHAAA,oBAAoB,OAAA;AAAE,4HAAA,0BAA0B,OAAA;AAAE,qHAAA,mBAAmB,OAAA;AAoB9E,6BAMe;AALb,2FAAA,IAAI,OAAA;AACJ,sHAAA,+BAA+B,OAAA;AAC/B,8GAAA,uBAAuB,OAAA;AACvB,mHAAA,4BAA4B,OAAA;AAC5B,oHAAA,6BAA6B,OAAA;AAI/B,6CAA2B;AAE3B,2CAA8G;AAArG,2GAAA,aAAa,OAAA;AAAE,8GAAA,gBAAgB,OAAA;AAAE,+GAAA,iBAAiB,OAAA;AAAE,wHAAA,0BAA0B,OAAA;AAWvF,uDAA6D;AAApD,2HAAA,uBAAuB,OAAA;AAGhC,iCA4CiB;AA3Cf,qGAAA,YAAY,OAAA;AACZ,4GAAA,mBAAmB,OAAA;AACnB,kGAAA,SAAS,OAAA;AACT,wGAAA,eAAe,OAAA;AACf,mGAAA,UAAU,OAAA;AACV,4GAAA,mBAAmB,OAAA;AACnB,gGAAA,OAAO,OAAA;AACP,kGAAA,SAAS,OAAA;AACT,mGAAA,UAAU,OAAA;AACV,uGAAA,cAAc,OAAA;AACd,kGAAA,SAAS,OAAA;AACT,yGAAA,gBAAgB,OAAA;AAChB,gGAAA,OAAO,OAAA;AACP,uGAAA,cAAc,OAAA;AACd,qGAAA,YAAY,OAAA;AACZ,gGAAA,OAAO,OAAA;AACP,uGAAA,cAAc,OAAA;AACd,mGAAA,UAAU,OAAA;AACV,qGAAA,YAAY,OAAA;AACZ,8FAAA,KAAK,OAAA;AACL,8FAAA,KAAK,OAAA;AACL,qGAAA,YAAY,OAAA;AACZ,+FAAA,MAAM,OAAA;AACN,iGAAA,QAAQ,OAAA;AACR,iGAAA,QAAQ,OAAA;AACR,oGAAA,WAAW,OAAA;AACX,iGAAA,QAAQ,OAAA;AACR,iGAAA,QAAQ,OAAA;AACR,iGAAA,QAAQ,OAAA;AACR,yGAAA,gBAAgB,OAAA;AAChB,mGAAA,UAAU,OAAA;AACV,mGAAA,UAAU,OAAA;AACV,iGAAA,QAAQ,OAAA;AACR,oGAAA,WAAW,OAAA;AACX,iGAAA,QAAQ,OAAA;AACR,6FAAA,IAAI,OAAA;AACJ,gGAAA,OAAO,OAAA;AACP,gGAAA,OAAO,OAAA;AACP,sHAAA,6BAA6B,OAAA;AAC7B,8GAAA,qBAAqB,OAAA;AACrB,8GAAA,qBAAqB,OAAA;AACrB,mGAAA,UAAU,OAAA;AACV,8FAAA,KAAK,OAAA;AAcP,qCAAoC;AAA3B,kGAAA,OAAO,OAAA;AAEhB,mCAAyC;AAAhC,uGAAA,aAAa,OAAA","sourcesContent":["export {\n  defaultExceptionType,\n  defaultLogArgsSerializer,\n  defaultErrorArgsSerializer,\n  apiMessageBus,\n  USER_ACTION_CANCEL_MESSAGE_TYPE,\n  USER_ACTION_END_MESSAGE_TYPE,\n  USER_ACTION_START_MESSAGE_TYPE,\n} from './api';\nexport type {\n  API,\n  APIEvent,\n  EventAttributes,\n  EventEvent,\n  EventsAPI,\n  ExceptionEvent,\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  ApiMessageBusMessages,\n  UserActionStartMessage,\n  UserActionEndMessage,\n  UserActionCancelMessage,\n  UserAction,\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  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  merge,\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/spec/core/src/utils/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.stringifyObjectValues = 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;
+exports.merge = exports.Observable = exports.stringifyObjectValues = 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");
 Object.defineProperty(exports, "deepEqual", { enumerable: true, get: function () { return deepEqual_1.deepEqual; } });
 var date_1 = require("./date");
@@ -53,4 +53,7 @@ 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; } });
 Object.defineProperty(exports, "stringifyObjectValues", { enumerable: true, get: function () { return json_1.stringifyObjectValues; } });
+var reactive_1 = require("./reactive");
+Object.defineProperty(exports, "Observable", { enumerable: true, get: function () { return reactive_1.Observable; } });
+Object.defineProperty(exports, "merge", { enumerable: true, get: function () { return reactive_1.merge; } });
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/utils/index.ts"],"names":[],"mappings":";;;AAEA,yCAAwC;AAA/B,sGAAA,SAAS,OAAA;AAElB,+BAA6C;AAApC,2GAAA,mBAAmB,OAAA;AAE5B,2BA8Bc;AA7BZ,6FAAA,OAAO,OAAA;AACP,+FAAA,SAAS,OAAA;AACT,gGAAA,UAAU,OAAA;AACV,oGAAA,cAAc,OAAA;AACd,+FAAA,SAAS,OAAA;AACT,sGAAA,gBAAgB,OAAA;AAChB,6FAAA,OAAO,OAAA;AACP,oGAAA,cAAc,OAAA;AACd,kGAAA,YAAY,OAAA;AACZ,6FAAA,OAAO,OAAA;AACP,oGAAA,cAAc,OAAA;AACd,gGAAA,UAAU,OAAA;AACV,kGAAA,YAAY,OAAA;AACZ,2FAAA,KAAK,OAAA;AACL,2FAAA,KAAK,OAAA;AACL,kGAAA,YAAY,OAAA;AACZ,4FAAA,MAAM,OAAA;AACN,8FAAA,QAAQ,OAAA;AACR,8FAAA,QAAQ,OAAA;AACR,iGAAA,WAAW,OAAA;AACX,8FAAA,QAAQ,OAAA;AACR,8FAAA,QAAQ,OAAA;AACR,8FAAA,QAAQ,OAAA;AACR,sGAAA,gBAAgB,OAAA;AAChB,gGAAA,UAAU,OAAA;AACV,gGAAA,UAAU,OAAA;AACV,8FAAA,QAAQ,OAAA;AACR,iGAAA,WAAW,OAAA;AACX,6FAAA,OAAO,OAAA;AAIT,yCAAsE;AAA7D,yGAAA,YAAY,OAAA;AAAE,4GAAA,eAAe,OAAA;AAAE,qGAAA,QAAQ,OAAA;AAEhD,+BAA8B;AAArB,4FAAA,IAAI,OAAA;AAEb,iDAAsD;AAA7C,oHAAA,mBAAmB,OAAA;AAG5B,qCAAuC;AAA9B,qGAAA,UAAU,OAAA;AAEnB,2CAA2C;AAAlC,yGAAA,WAAW,OAAA;AAEpB,+BAAiC;AAAxB,+FAAA,OAAO,OAAA;AAEhB,+BAAqG;AAA5F,qHAAA,6BAA6B,OAAA;AAAE,6GAAA,qBAAqB,OAAA;AAAE,6GAAA,qBAAqB,OAAA","sourcesContent":["export type { BaseObject, BaseObjectKey, BaseObjectPrimitiveValue, BaseObjectValue } from './baseObject';\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"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/utils/index.ts"],"names":[],"mappings":";;;AAEA,yCAAwC;AAA/B,sGAAA,SAAS,OAAA;AAElB,+BAA6C;AAApC,2GAAA,mBAAmB,OAAA;AAE5B,2BA8Bc;AA7BZ,6FAAA,OAAO,OAAA;AACP,+FAAA,SAAS,OAAA;AACT,gGAAA,UAAU,OAAA;AACV,oGAAA,cAAc,OAAA;AACd,+FAAA,SAAS,OAAA;AACT,sGAAA,gBAAgB,OAAA;AAChB,6FAAA,OAAO,OAAA;AACP,oGAAA,cAAc,OAAA;AACd,kGAAA,YAAY,OAAA;AACZ,6FAAA,OAAO,OAAA;AACP,oGAAA,cAAc,OAAA;AACd,gGAAA,UAAU,OAAA;AACV,kGAAA,YAAY,OAAA;AACZ,2FAAA,KAAK,OAAA;AACL,2FAAA,KAAK,OAAA;AACL,kGAAA,YAAY,OAAA;AACZ,4FAAA,MAAM,OAAA;AACN,8FAAA,QAAQ,OAAA;AACR,8FAAA,QAAQ,OAAA;AACR,iGAAA,WAAW,OAAA;AACX,8FAAA,QAAQ,OAAA;AACR,8FAAA,QAAQ,OAAA;AACR,8FAAA,QAAQ,OAAA;AACR,sGAAA,gBAAgB,OAAA;AAChB,gGAAA,UAAU,OAAA;AACV,gGAAA,UAAU,OAAA;AACV,8FAAA,QAAQ,OAAA;AACR,iGAAA,WAAW,OAAA;AACX,6FAAA,OAAO,OAAA;AAIT,yCAAsE;AAA7D,yGAAA,YAAY,OAAA;AAAE,4GAAA,eAAe,OAAA;AAAE,qGAAA,QAAQ,OAAA;AAEhD,+BAA8B;AAArB,4FAAA,IAAI,OAAA;AAEb,iDAAsD;AAA7C,oHAAA,mBAAmB,OAAA;AAG5B,qCAAuC;AAA9B,qGAAA,UAAU,OAAA;AAEnB,2CAA2C;AAAlC,yGAAA,WAAW,OAAA;AAEpB,+BAAiC;AAAxB,+FAAA,OAAO,OAAA;AAEhB,+BAAqG;AAA5F,qHAAA,6BAA6B,OAAA;AAAE,6GAAA,qBAAqB,OAAA;AAAE,6GAAA,qBAAqB,OAAA;AAEpF,uCAA+C;AAAtC,sGAAA,UAAU,OAAA;AAAE,iGAAA,KAAK,OAAA","sourcesContent":["export type { BaseObject, BaseObjectKey, BaseObjectPrimitiveValue, BaseObjectValue } from './baseObject';\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, merge } from './reactive';\nexport type { Subscription } from './reactive';\n"]}

package/dist/spec/core/src/utils/reactive.js

@@ -0,0 +1,104 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.merge = exports.Observable = void 0;
+var Observable = /** @class */ (function () {
+    function Observable() {
+        this.subscribers = [];
+    }
+    /**
+     * Subscribes a callback function to the observable.
+     * @param callback - The function to call when the observable emits a value.
+     * @returns A subscription object with an unsubscribe method to cancel the subscription.
+     */
+    Observable.prototype.subscribe = function (callback) {
+        var _this = this;
+        this.subscribers.push(callback);
+        return {
+            unsubscribe: function () { return _this.unsubscribe(callback); },
+        };
+    };
+    /**
+     * Notifies all subscribers with the given data.
+     * @param data - The data to emit to all subscribers.
+     */
+    Observable.prototype.notify = function (data) {
+        this.subscribers.forEach(function (callback) { return callback(data); });
+    };
+    /**
+     * Subscribes a callback function to the observable and automatically unsubscribes after the first emission.
+     * @param callback - The function to call when the observable emits a value.
+     * @returns A subscription object with an unsubscribe method to cancel the subscription.
+     */
+    Observable.prototype.first = function (callback) {
+        var subscription = this.subscribe(function (data) {
+            callback(data);
+            subscription.unsubscribe();
+        });
+        return subscription;
+    };
+    /**
+     * Emits values from the source observable until the provided predicate function returns false.
+     * @param predicate - A function that evaluates each value emitted by the source observable.
+     * @returns A new observable that emits values from the source observable while the predicate returns true.
+     */
+    Observable.prototype.takeWhile = function (predicate) {
+        var result = new Observable();
+        var subscription = this.subscribe(function (value) {
+            if (predicate(value)) {
+                result.notify(value);
+            }
+            else {
+                subscription.unsubscribe();
+            }
+        });
+        return result;
+    };
+    /**
+     * Unsubscribes all subscribers by clearing the subscribers array.
+     *
+     * @remarks
+     * This method sets the `subscribers` array to an empty array, effectively removing all current subscribers.
+     */
+    Observable.prototype.unsubscribeAll = function () {
+        this.subscribers = [];
+    };
+    Observable.prototype.unsubscribe = function (callback) {
+        this.subscribers = this.subscribers.filter(function (sub) { return sub !== callback; });
+    };
+    return Observable;
+}());
+exports.Observable = Observable;
+/**
+ * Merges multiple observables into a single observable.
+ *
+ * @template T - The type of the values emitted by the observables.
+ * @param {...Observable[]} observables - The observables to merge.
+ * @returns {Observable} A new observable that emits values from all input observables.
+ */
+function merge() {
+    var observables = [];
+    for (var _i = 0; _i < arguments.length; _i++) {
+        observables[_i] = arguments[_i];
+    }
+    var mainObservable = new Observable();
+    var subscriptions = [];
+    observables.forEach(function (observable) {
+        var subscription = observable.subscribe(function (value) {
+            mainObservable.notify(value);
+        });
+        subscriptions.push(subscription);
+    });
+    return {
+        subscribe: mainObservable.subscribe.bind(mainObservable),
+        takeWhile: mainObservable.takeWhile.bind(mainObservable),
+        first: mainObservable.first.bind(mainObservable),
+        notify: mainObservable.notify.bind(mainObservable),
+        unsubscribeAll: function () {
+            observables.forEach(function (observable) {
+                observable.unsubscribeAll();
+            });
+        },
+    };
+}
+exports.merge = merge;
+//# sourceMappingURL=reactive.js.map

package/dist/spec/core/src/utils/reactive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactive.js","sourceRoot":"","sources":["../../../../../src/utils/reactive.ts"],"names":[],"mappings":";;;AAIA;IAGE;QACE,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC;IACxB,CAAC;IAED;;;;OAIG;IACH,8BAAS,GAAT,UAAU,QAA2B;QAArC,iBAMC;QALC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAEhC,OAAO;YACL,WAAW,EAAE,cAAM,OAAA,KAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,EAA1B,CAA0B;SAC9C,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,2BAAM,GAAN,UAAO,IAAO;QACZ,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,UAAC,QAAQ,IAAK,OAAA,QAAQ,CAAC,IAAI,CAAC,EAAd,CAAc,CAAC,CAAC;IACzD,CAAC;IAED;;;;OAIG;IACH,0BAAK,GAAL,UAAM,QAA2B;QAC/B,IAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,UAAC,IAAI;YACvC,QAAQ,CAAC,IAAI,CAAC,CAAC;YACf,YAAY,CAAC,WAAW,EAAE,CAAC;QAC7B,CAAC,CAAC,CAAC;QAEH,OAAO,YAAY,CAAC;IACtB,CAAC;IAED;;;;OAIG;IACH,8BAAS,GAAT,UAAU,SAAgC;QACxC,IAAM,MAAM,GAAG,IAAI,UAAU,EAAK,CAAC;QACnC,IAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,UAAC,KAAQ;YAC3C,IAAI,SAAS,CAAC,KAAK,CAAC,EAAE;gBACpB,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;aACtB;iBAAM;gBACL,YAAY,CAAC,WAAW,EAAE,CAAC;aAC5B;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;OAKG;IACH,mCAAc,GAAd;QACE,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC;IACxB,CAAC;IAEO,gCAAW,GAAnB,UAAoB,QAA6B;QAC/C,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,UAAC,GAAG,IAAK,OAAA,GAAG,KAAK,QAAQ,EAAhB,CAAgB,CAAC,CAAC;IACxE,CAAC;IACH,iBAAC;AAAD,CAAC,AAzED,IAyEC;AAzEY,gCAAU;AA2EvB;;;;;;GAMG;AACH,SAAgB,KAAK;IAAI,qBAAoC;SAApC,UAAoC,EAApC,qBAAoC,EAApC,IAAoC;QAApC,gCAAoC;;IAC3D,IAAM,cAAc,GAAG,IAAI,UAAU,EAAK,CAAC;IAC3C,IAAM,aAAa,GAAmB,EAAE,CAAC;IAEzC,WAAW,CAAC,OAAO,CAAC,UAAC,UAAU;QAC7B,IAAM,YAAY,GAAG,UAAU,CAAC,SAAS,CAAC,UAAC,KAAQ;YACjD,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;QACH,aAAa,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,SAAS,EAAE,cAAc,CAAC,SAAS,CAAC,IAAI,CAAC,cAAc,CAAC;QACxD,SAAS,EAAE,cAAc,CAAC,SAAS,CAAC,IAAI,CAAC,cAAc,CAAC;QACxD,KAAK,EAAE,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC;QAChD,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC;QAClD,cAAc,EAAE;YACd,WAAW,CAAC,OAAO,CAAC,UAAC,UAAU;gBAC7B,UAAU,CAAC,cAAc,EAAE,CAAC;YAC9B,CAAC,CAAC,CAAC;QACL,CAAC;KACe,CAAC;AACrB,CAAC;AAtBD,sBAsBC","sourcesContent":["export interface Subscription {\n  unsubscribe: () => void;\n}\n\nexport class Observable<T = any> {\n  private subscribers: Array<(data: T) => void>;\n\n  constructor() {\n    this.subscribers = [];\n  }\n\n  /**\n   * Subscribes a callback function to the observable.\n   * @param callback - The function to call when the observable emits a value.\n   * @returns A subscription object with an unsubscribe method to cancel the subscription.\n   */\n  subscribe(callback: (data: T) => void): Subscription {\n    this.subscribers.push(callback);\n\n    return {\n      unsubscribe: () => this.unsubscribe(callback),\n    };\n  }\n\n  /**\n   * Notifies all subscribers with the given data.\n   * @param data - The data to emit to all subscribers.\n   */\n  notify(data: T): void {\n    this.subscribers.forEach((callback) => callback(data));\n  }\n\n  /**\n   * Subscribes a callback function to the observable and automatically unsubscribes after the first emission.\n   * @param callback - The function to call when the observable emits a value.\n   * @returns A subscription object with an unsubscribe method to cancel the subscription.\n   */\n  first(callback: (data: T) => void): Subscription {\n    const subscription = this.subscribe((data) => {\n      callback(data);\n      subscription.unsubscribe();\n    });\n\n    return subscription;\n  }\n\n  /**\n   * Emits values from the source observable until the provided predicate function returns false.\n   * @param predicate - A function that evaluates each value emitted by the source observable.\n   * @returns A new observable that emits values from the source observable while the predicate returns true.\n   */\n  takeWhile(predicate: (value: T) => boolean): Observable<T> {\n    const result = new Observable<T>();\n    const subscription = this.subscribe((value: T) => {\n      if (predicate(value)) {\n        result.notify(value);\n      } else {\n        subscription.unsubscribe();\n      }\n    });\n\n    return result;\n  }\n\n  /**\n   * Unsubscribes all subscribers by clearing the subscribers array.\n   *\n   * @remarks\n   * This method sets the `subscribers` array to an empty array, effectively removing all current subscribers.\n   */\n  unsubscribeAll(): void {\n    this.subscribers = [];\n  }\n\n  private unsubscribe(callback: (data: any) => void): void {\n    this.subscribers = this.subscribers.filter((sub) => sub !== callback);\n  }\n}\n\n/**\n * Merges multiple observables into a single observable.\n *\n * @template T - The type of the values emitted by the observables.\n * @param {...Observable[]} observables - The observables to merge.\n * @returns {Observable} A new observable that emits values from all input observables.\n */\nexport function merge<T>(...observables: Array<Observable<T>>): Observable<T> {\n  const mainObservable = new Observable<T>();\n  const subscriptions: Subscription[] = [];\n\n  observables.forEach((observable) => {\n    const subscription = observable.subscribe((value: T) => {\n      mainObservable.notify(value);\n    });\n    subscriptions.push(subscription);\n  });\n\n  return {\n    subscribe: mainObservable.subscribe.bind(mainObservable),\n    takeWhile: mainObservable.takeWhile.bind(mainObservable),\n    first: mainObservable.first.bind(mainObservable),\n    notify: mainObservable.notify.bind(mainObservable),\n    unsubscribeAll: () => {\n      observables.forEach((observable) => {\n        observable.unsubscribeAll();\n      });\n    },\n  } as Observable<T>;\n}\n"]}

package/dist/spec/core/src/utils/reactive.test.js

@@ -0,0 +1,104 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+var __1 = require("..");
+describe('Reactive', function () {
+    describe('Observable', function () {
+        it('Creates an observable, subscribe to it, and emit values', function () {
+            var observable = new __1.Observable();
+            var callback = jest.fn();
+            observable.subscribe(callback);
+            observable.notify(1);
+            observable.notify(2);
+            expect(callback).toHaveBeenCalledTimes(2);
+            expect(callback).toHaveBeenNthCalledWith(1, 1);
+            expect(callback).toHaveBeenNthCalledWith(2, 2);
+        });
+        it('Unsubscribes from an observable', function () {
+            var observable = new __1.Observable();
+            var callback = jest.fn();
+            var subscription = observable.subscribe(callback);
+            observable.notify(1);
+            subscription.unsubscribe();
+            observable.notify(2);
+            expect(callback).toHaveBeenCalledTimes(1);
+            expect(callback).toHaveBeenCalledWith(1);
+        });
+        it('Unsubscribes all subscriptions from the observable when unsubscribeAll is called', function () {
+            var observable = new __1.Observable();
+            var callback = jest.fn();
+            observable.subscribe(callback);
+            observable.subscribe(callback);
+            observable.subscribe(callback);
+            observable.notify(1);
+            observable.unsubscribeAll();
+            observable.subscribe(callback);
+            observable.subscribe(callback);
+            observable.subscribe(callback);
+            expect(callback).toHaveBeenCalledTimes(3);
+            expect(callback).toHaveBeenCalledWith(1);
+        });
+        it('takes emitted values until the predicate returns false', function () {
+            var observable = new __1.Observable();
+            var callback = jest.fn();
+            observable.takeWhile(function (value) { return value <= 2; }).subscribe(callback);
+            observable.notify(1);
+            observable.notify(2);
+            observable.notify(3);
+            expect(callback).toHaveBeenCalledTimes(2);
+            expect(callback).toHaveBeenNthCalledWith(1, 1);
+            expect(callback).toHaveBeenNthCalledWith(2, 2);
+        });
+        it('subscribes to the first emitted value and unsubscribes after', function () {
+            var observable = new __1.Observable();
+            var callback = jest.fn();
+            observable.first(callback);
+            observable.notify(1);
+            observable.notify(2);
+            expect(callback).toHaveBeenCalledTimes(1);
+            expect(callback).toHaveBeenCalledWith(1);
+        });
+        it('unsubscribes a callback from the list of subscribers', function () {
+            var observable = new __1.Observable();
+            var callback = jest.fn();
+            var sub = observable.subscribe(callback);
+            observable.notify(1);
+            sub.unsubscribe();
+            observable.notify(2);
+            expect(callback).toHaveBeenCalledTimes(1);
+            expect(callback).toHaveBeenCalledWith(1);
+        });
+    });
+    describe('Merge', function () {
+        it('Merges multiple observables into a single observable using the merge() function', function () {
+            var observable1 = new __1.Observable();
+            var observable2 = new __1.Observable();
+            var callback = jest.fn();
+            (0, __1.merge)(observable1, observable2).subscribe(callback);
+            observable1.notify(1);
+            observable2.notify('A');
+            observable1.notify(2);
+            observable2.notify('B');
+            expect(callback).toHaveBeenCalledTimes(4);
+            expect(callback).toHaveBeenNthCalledWith(1, 1);
+            expect(callback).toHaveBeenNthCalledWith(2, 'A');
+            expect(callback).toHaveBeenNthCalledWith(3, 2);
+            expect(callback).toHaveBeenNthCalledWith(4, 'B');
+        });
+        it('Unsubscribes from all observables when merge.unsubscribeAll isCalled', function () {
+            var observable1 = new __1.Observable();
+            var observable2 = new __1.Observable();
+            var callback = jest.fn();
+            var mergeObserver = (0, __1.merge)(observable1, observable2);
+            mergeObserver.subscribe(callback);
+            observable1.notify(1);
+            observable2.notify(2);
+            mergeObserver.unsubscribeAll();
+            observable1.notify(3);
+            observable2.notify(4);
+            expect(callback).toHaveBeenCalledTimes(2);
+            expect(callback).toHaveBeenNthCalledWith(1, 1);
+            expect(callback).toHaveBeenNthCalledWith(2, 2);
+        });
+    });
+});
+//# sourceMappingURL=reactive.test.js.map

package/dist/spec/core/src/utils/reactive.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactive.test.js","sourceRoot":"","sources":["../../../../../src/utils/reactive.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { merge, Observable } from '..';\n\ndescribe('Reactive', () => {\n  describe('Observable', () => {\n    it('Creates an observable, subscribe to it, and emit values', () => {\n      const observable = new Observable<number>();\n      const callback = jest.fn();\n\n      observable.subscribe(callback);\n      observable.notify(1);\n      observable.notify(2);\n\n      expect(callback).toHaveBeenCalledTimes(2);\n      expect(callback).toHaveBeenNthCalledWith(1, 1);\n      expect(callback).toHaveBeenNthCalledWith(2, 2);\n    });\n\n    it('Unsubscribes from an observable', () => {\n      const observable = new Observable<number>();\n      const callback = jest.fn();\n\n      const subscription = observable.subscribe(callback);\n      observable.notify(1);\n\n      subscription.unsubscribe();\n      observable.notify(2);\n\n      expect(callback).toHaveBeenCalledTimes(1);\n      expect(callback).toHaveBeenCalledWith(1);\n    });\n\n    it('Unsubscribes all subscriptions from the observable when unsubscribeAll is called', () => {\n      const observable = new Observable<number>();\n      const callback = jest.fn();\n\n      observable.subscribe(callback);\n      observable.subscribe(callback);\n      observable.subscribe(callback);\n\n      observable.notify(1);\n      observable.unsubscribeAll();\n\n      observable.subscribe(callback);\n      observable.subscribe(callback);\n      observable.subscribe(callback);\n\n      expect(callback).toHaveBeenCalledTimes(3);\n      expect(callback).toHaveBeenCalledWith(1);\n    });\n\n    it('takes emitted values until the predicate returns false', () => {\n      const observable = new Observable<number>();\n      const callback = jest.fn();\n\n      observable.takeWhile((value) => value <= 2).subscribe(callback);\n      observable.notify(1);\n      observable.notify(2);\n      observable.notify(3);\n\n      expect(callback).toHaveBeenCalledTimes(2);\n      expect(callback).toHaveBeenNthCalledWith(1, 1);\n      expect(callback).toHaveBeenNthCalledWith(2, 2);\n    });\n\n    it('subscribes to the first emitted value and unsubscribes after', () => {\n      const observable = new Observable<number>();\n      const callback = jest.fn();\n\n      observable.first(callback);\n      observable.notify(1);\n      observable.notify(2);\n\n      expect(callback).toHaveBeenCalledTimes(1);\n      expect(callback).toHaveBeenCalledWith(1);\n    });\n\n    it('unsubscribes a callback from the list of subscribers', () => {\n      const observable = new Observable<number>();\n      const callback = jest.fn();\n\n      const sub = observable.subscribe(callback);\n      observable.notify(1);\n      sub.unsubscribe();\n      observable.notify(2);\n\n      expect(callback).toHaveBeenCalledTimes(1);\n      expect(callback).toHaveBeenCalledWith(1);\n    });\n  });\n\n  describe('Merge', () => {\n    it('Merges multiple observables into a single observable using the merge() function', () => {\n      const observable1 = new Observable<number | string>();\n      const observable2 = new Observable<number | string>();\n      const callback = jest.fn();\n\n      merge(observable1, observable2).subscribe(callback);\n\n      observable1.notify(1);\n      observable2.notify('A');\n      observable1.notify(2);\n      observable2.notify('B');\n\n      expect(callback).toHaveBeenCalledTimes(4);\n      expect(callback).toHaveBeenNthCalledWith(1, 1);\n      expect(callback).toHaveBeenNthCalledWith(2, 'A');\n      expect(callback).toHaveBeenNthCalledWith(3, 2);\n      expect(callback).toHaveBeenNthCalledWith(4, 'B');\n    });\n\n    it('Unsubscribes from all observables when merge.unsubscribeAll isCalled', () => {\n      const observable1 = new Observable<number>();\n      const observable2 = new Observable<number>();\n      const callback = jest.fn();\n\n      const mergeObserver = merge(observable1, observable2);\n      mergeObserver.subscribe(callback);\n\n      observable1.notify(1);\n      observable2.notify(2);\n\n      mergeObserver.unsubscribeAll();\n      observable1.notify(3);\n      observable2.notify(4);\n\n      expect(callback).toHaveBeenCalledTimes(2);\n      expect(callback).toHaveBeenNthCalledWith(1, 1);\n      expect(callback).toHaveBeenNthCalledWith(2, 2);\n    });\n  });\n});\n"]}

package/dist/spec/core/src/version.js

@@ -2,5 +2,5 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
 // auto-generated by bin/genVersion.ts
-exports.VERSION = '1.14.1';
+exports.VERSION = '1.14.2';
 //# sourceMappingURL=version.js.map

package/dist/spec/core/src/version.js.map

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

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

@@ -0,0 +1,7 @@
+export declare class ItemBuffer<T> {
+    private buffer;
+    constructor();
+    addItem(item: T): void;
+    flushBuffer(cb?: (item: T) => void): void;
+    size(): number;
+}

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

@@ -0,0 +1,11 @@
+import type { Transports } from '../transports';
+import type { TracesAPI } from './traces/types';
+export declare const mockMetas: {
+    add: jest.Mock<any, any, any>;
+    remove: jest.Mock<any, any, any>;
+    addListener: jest.Mock<any, any, any>;
+    removeListener: jest.Mock<any, any, any>;
+    value: {};
+};
+export declare const mockTransports: Transports;
+export declare const mockTracesApi: TracesAPI;

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

@@ -0,0 +1,3 @@
+export declare const USER_ACTION_START_MESSAGE_TYPE = "user-action-start";
+export declare const USER_ACTION_END_MESSAGE_TYPE = "user-action-end";
+export declare const USER_ACTION_CANCEL_MESSAGE_TYPE = "user-action-cancel";

package/dist/types/api/events/initialize.d.ts

@@ -1,8 +1,19 @@
 import type { Config } from '../../config';
 import type { InternalLogger } from '../../internalLogger';
 import type { Metas } from '../../metas';
-import { Transports } from '../../transports';
+import type { TransportItem, Transports } from '../../transports';
 import type { UnpatchedConsole } from '../../unpatchedConsole';
+import type { ItemBuffer } from '../ItemBuffer';
 import type { TracesAPI } from '../traces';
+import type { ApiMessageBusMessages } from '../types';
 import type { EventsAPI } from './types';
-export declare function initializeEventsAPI(_unpatchedConsole: UnpatchedConsole, internalLogger: InternalLogger, config: Config, metas: Metas, transports: Transports, tracesApi: TracesAPI): EventsAPI;
+export declare function initializeEventsAPI({ internalLogger, config, metas, transports, tracesApi, actionBuffer, getMessage, }: {
+    unpatchedConsole: UnpatchedConsole;
+    internalLogger: InternalLogger;
+    config: Config;
+    metas: Metas;
+    transports: Transports;
+    tracesApi: TracesAPI;
+    actionBuffer: ItemBuffer<TransportItem>;
+    getMessage: () => ApiMessageBusMessages | undefined;
+}): EventsAPI;

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

@@ -1,5 +1,6 @@
 import type { SpanContext } from '@opentelemetry/api';
 import type { TraceContext } from '../traces';
+import type { UserAction } from '../types';
 export type EventAttributes = Record<string, string>;
 export interface EventEvent {
     name: string;
@@ -7,11 +8,21 @@ export interface EventEvent {
     domain?: string;
     attributes?: EventAttributes;
     trace?: TraceContext;
+    action?: UserAction;
 }
 export interface PushEventOptions {
     skipDedupe?: boolean;
     spanContext?: Pick<SpanContext, 'traceId' | 'spanId'>;
     timestampOverwriteMs?: number;
+    /**
+     * Allows manual transformation of the payload before adding it to the internal buffer.
+     *
+     * @param payload - The event payload to be transformed.
+     * @returns The transformed event payload.
+     *
+     * @remarks This should be used sparingly and only in special cases where custom payload processing cannot be deferred to the before-send hook.
+     */
+    customPayloadTransformer?: (payload: EventEvent) => EventEvent;
 }
 export interface EventsAPI {
     pushEvent: (name: string, attributes?: EventAttributes, domain?: string, options?: PushEventOptions) => void;

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

@@ -1,8 +1,19 @@
 import type { Config } from '../../config';
 import type { InternalLogger } from '../../internalLogger';
 import type { Metas } from '../../metas';
-import type { Transports } from '../../transports';
+import type { TransportItem, Transports } from '../../transports';
 import type { UnpatchedConsole } from '../../unpatchedConsole';
+import type { ItemBuffer } from '../ItemBuffer';
 import type { TracesAPI } from '../traces';
+import type { ApiMessageBusMessages } from '../types';
 import type { ExceptionsAPI } from './types';
-export declare function initializeExceptionsAPI(_unpatchedConsole: UnpatchedConsole, internalLogger: InternalLogger, config: Config, metas: Metas, transports: Transports, tracesApi: TracesAPI): ExceptionsAPI;
+export declare function initializeExceptionsAPI({ internalLogger, config, metas, transports, tracesApi, actionBuffer, getMessage, }: {
+    unpatchedConsole: UnpatchedConsole;
+    internalLogger: InternalLogger;
+    config: Config;
+    metas: Metas;
+    transports: Transports;
+    tracesApi: TracesAPI;
+    actionBuffer: ItemBuffer<TransportItem>;
+    getMessage: () => ApiMessageBusMessages | undefined;
+}): ExceptionsAPI;

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

@@ -1,5 +1,6 @@
 import type { SpanContext } from '@opentelemetry/api';
 import type { TraceContext } from '../traces';
+import type { UserAction } from '../types';
 export type StacktraceParser = (err: ExtendedError) => Stacktrace;
 export interface ExceptionStackFrame {
     filename: string;
@@ -23,6 +24,7 @@ export interface ExceptionEvent {
     stacktrace?: Stacktrace;
     trace?: TraceContext;
     context?: ExceptionContext;
+    action?: UserAction;
 }
 export interface PushErrorOptions {
     skipDedupe?: boolean;

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

@@ -1,5 +1,5 @@
 export { initializeAPI } from './initialize';
-export type { API, APIEvent } from './types';
+export type { API, APIEvent, ApiMessageBusMessages, UserActionCancelMessage, UserActionEndMessage, UserActionStartMessage, UserAction, } from './types';
 export type { EventAttributes, EventEvent, EventsAPI, PushEventOptions } from './events';
 export { defaultExceptionType, defaultErrorArgsSerializer } from './exceptions';
 export type { ExceptionEvent, ExceptionStackFrame, ExceptionsAPI, ExtendedError, PushErrorOptions, Stacktrace, StacktraceParser, } from './exceptions';
@@ -8,3 +8,5 @@ export type { LogContext, LogEvent, LogArgsSerializer, LogsAPI, PushLogOptions }
 export type { MeasurementEvent, MeasurementsAPI, PushMeasurementOptions } from './measurements';
 export type { MetaAPI } from './meta';
 export type { OTELApi, TraceContext, TraceEvent, TracesAPI } from './traces';
+export { apiMessageBus } from './initialize';
+export { USER_ACTION_CANCEL_MESSAGE_TYPE, USER_ACTION_END_MESSAGE_TYPE, USER_ACTION_START_MESSAGE_TYPE } from './const';

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

@@ -3,5 +3,7 @@ import type { InternalLogger } from '../internalLogger';
 import type { Metas } from '../metas';
 import type { Transports } from '../transports';
 import type { UnpatchedConsole } from '../unpatchedConsole';
-import type { API } from './types';
+import { Observable } from '../utils';
+import type { API, ApiMessageBusMessages } from './types';
+export declare const apiMessageBus: Observable<ApiMessageBusMessages>;
 export declare function initializeAPI(unpatchedConsole: UnpatchedConsole, internalLogger: InternalLogger, config: Config, metas: Metas, transports: Transports): API;

package/dist/types/api/logs/initialize.d.ts

@@ -1,8 +1,19 @@
 import type { Config } from '../../config';
 import type { InternalLogger } from '../../internalLogger';
 import type { Metas } from '../../metas';
-import type { Transports } from '../../transports';
+import { TransportItem, Transports } from '../../transports';
 import type { UnpatchedConsole } from '../../unpatchedConsole';
+import type { ItemBuffer } from '../ItemBuffer';
 import type { TracesAPI } from '../traces';
+import type { ApiMessageBusMessages } from '../types';
 import type { LogsAPI } from './types';
-export declare function initializeLogsAPI(_unpatchedConsole: UnpatchedConsole, internalLogger: InternalLogger, config: Config, metas: Metas, transports: Transports, tracesApi: TracesAPI): LogsAPI;
+export declare function initializeLogsAPI({ internalLogger, config, metas, transports, tracesApi, actionBuffer, getMessage, }: {
+    unpatchedConsole: UnpatchedConsole;
+    internalLogger: InternalLogger;
+    config: Config;
+    metas: Metas;
+    transports: Transports;
+    tracesApi: TracesAPI;
+    actionBuffer: ItemBuffer<TransportItem>;
+    getMessage: () => ApiMessageBusMessages | undefined;
+}): LogsAPI;

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

@@ -1,13 +1,15 @@
 import type { SpanContext } from '@opentelemetry/api';
 import type { LogLevel } from '../../utils';
 import type { TraceContext } from '../traces';
+import type { UserAction } from '../types';
 export type LogContext = Record<string, string>;
 export interface LogEvent {
-    context: LogContext;
+    context: LogContext | undefined;
     level: LogLevel;
     message: string;
     timestamp: string;
     trace?: TraceContext;
+    action?: UserAction;
 }
 export interface PushLogOptions {
     context?: LogContext;