@crimson-education/browser-logger 2.0.2 → 3.0.0

package/README.md

@@ -1,6 +1,6 @@
 # Crimson Education Browser Logger
 
-An abstract logger and reporting utility for browser environments.
+A structured logger and analytics reporting utility for browser environments.
 
 This library contains a number of reporters that is will send analytics to.
 
@@ -34,30 +34,39 @@ Logger.init({
     application: 'test',
   },
 
-  datadog: {
-    applicationId: config.datadogApplicationId,
-    clientToken: config.datadogClientToken,
-    site: config.datadogSite,
-    proxyUrl: config.datadogTunnelProxyUrl,
-    version: config.datadogVersion,
-
-    sampleRate: config.environment === 'production' ? 50 : 0,
-    replaySampleRate: config.environment === 'production' ? 50 : 0,
-
-    forwardConsoleLogs: true,
-    trackInteractions: true,
-    trackFrustrations: true,
-    allowedTracingOrigins: ['https://my.api.domain']
-  },
-
-  amplify: {
-    region: config.awsRegion,
-    identityPoolId: config.pinpointIdentityPoolId,
-    analyticsAppId: config.pinpointAnalyticsAppId,
-
-    autoTrackEvents: true,
-    autoTrackPageViews: true,
-    autoTrackSessions: true,
+  reporters: {
+    log: true,
+
+    gtm: true,
+
+    datadog: {
+      applicationId: config.datadogApplicationId,
+      clientToken: config.datadogClientToken,
+      site: config.datadogSite,
+      proxyUrl: config.datadogTunnelProxyUrl,
+      version: config.datadogVersion,
+
+      sampleRate: config.environment === 'production' ? 50 : 0,
+      replaySampleRate: config.environment === 'production' ? 50 : 0,
+
+      forwardConsoleLogs: true,
+      logTransport: {
+        level: Logger.LogLevel.Info,
+      },
+      trackInteractions: true,
+      trackFrustrations: true,
+      allowedTracingOrigins: ['https://my.api.domain']
+    },
+
+    amplify: {
+      region: config.awsRegion,
+      identityPoolId: config.pinpointIdentityPoolId,
+      analyticsAppId: config.pinpointAnalyticsAppId,
+
+      autoTrackEvents: true,
+      autoTrackPageViews: true,
+      autoTrackSessions: true,
+    }
   }
 });
 
@@ -77,8 +86,7 @@ Logger.trackEvent({
   },
 });
 
-// Must init before you can create a logger.
-const logger = Logger.createLogger('app');
+export const logger = Logger.createLogger();
 
 // Attributed logging.
 logger.info('WOW!', {
@@ -86,7 +94,133 @@ logger.info('WOW!', {
 });
 ```
 
-### Reporters
+### Structured Logging
+
+Structured logging in this library is loosely based on Winston, and follows roughly the same interface as `@crimson-education/node-logger`.
+
+Call `Logger.createLogger()` to create a logger instance, it is recommended to re-use this as a global logger everywhere, and then call `.child()` to reuse metadata.
+
+Global metadata about the service will be added for transport usage after calling `Logger.init()`.
+
+You can add more Global Metadata at any time by calling `addMetadata()`.
+
+
+```ts
+export const logger = Logger.createLogger();
+
+const log = logger.child({
+  from: 'childLog',
+});
+
+log.info('My Log', { jobCount: jobs.length });
+
+const timer = log.startTimer();
+
+const result = await job(jobs);
+
+timer.done({ message: 'Job Completed', metadata: { id: result.id } });
+```
+
+### Reporting
+
+#### Opting out of events
+
+You can opt out of sending events to reporters on a global, or per call basis using the endpoints config.
+
+E.g. On calls
+
+```ts
+Logger.trackEvent({
+  message: 'my-event',
+  toReporters: ['log', 'datadog'],
+  excludeReporters: ['datadog']
+});
+```
+
+E.g. Globally
+
+```ts
+Logger.init({
+  reporters: {
+    log: true,
+    datadog: {
+      ...
+      endpoints: {
+        trackEvent: false,
+      }
+    }
+  }
+});
+```
+
+These will only send to the log reporter, it is recommended to use `toReporters` or `excludeReporters` separately as they overlap.
+
+#### Filtering out metadata
+
+You can filter what metadata gets sent to each reporter in the reporter config. 
+This accepts a string for exact match metadata keys, or a RegExp.
+You can use `.` to traverse metadata.
+
+```ts
+Logger.init({
+  reporters: {
+    log: {
+      ignoreMetadataPatterns: [
+        'internalError',
+        'user.email',
+        /error\.stack.*/g
+      ]
+    }
+  }
+});
+```
+
+### Filtering out Breadcrumb categories
+
+You can filter what breadcrumbs get sent to reports in the reporter config.
+
+```ts
+Logger.init({
+  reporters: {
+    log: {
+      ignoreBreadcrumbCategories: [
+        'fetch'
+      ]
+    }
+  }
+});
+
+// Not sent to the log reporter.
+Logger.addBreadcrumb({
+  ...
+  category: 'fetch',
+});
+```
+
+### Configure Reporters
+
+#### Log
+
+By default, the log reporter is enabled. This adds all reporter functions to logs. Set `reporters.log` to `false` to disable reporter logging.
+
+```ts
+import { config } from '../configuration';
+import * as Logger from '@crimson-education/browser-logger';
+
+Logger.init({
+  reporters: {
+    log: {
+      trackEventLevel: Logger.LogInfo.Debug,
+      endpoints: {
+        recordSession: false,
+        recordSessionStop: false,
+      }
+    }
+  }
+});
+```
+
+Check out the [`DatadogReporterConfig`](https://github.com/crimson-education/browser-logger/blob/main/src/reporters/datadogReporter.ts) for all of the configuration you can apply to Datadog reporting.
 
 #### Datadog
 
@@ -97,26 +231,32 @@ import { config } from '../configuration';
 import * as Logger from '@crimson-education/browser-logger';
 
 Logger.init({
-  ...
-  datadog: {
-    applicationId: config.datadogApplicationId,
-    clientToken: config.datadogClientToken,
-    site: config.datadogSite,
-    proxyUrl: config.datadogTunnelProxyUrl,
-    version: config.datadogVersion,
-
-    sampleRate: config.environment === 'production' ? 50 : 0,
-    replaySampleRate: config.environment === 'production' ? 50 : 0,
-
-    forwardConsoleLogs: true,
-    trackInteractions: true,
-    allowedTracingOrigins: ['https://my.api.domain']
+  reporters: {
+    datadog: {
+      applicationId: config.datadogApplicationId,
+      clientToken: config.datadogClientToken,
+      site: config.datadogSite,
+      proxyUrl: config.datadogTunnelProxyUrl,
+      version: config.datadogVersion,
+
+      sampleRate: config.environment === 'production' ? 50 : 0,
+      replaySampleRate: config.environment === 'production' ? 50 : 0,
+
+      forwardConsoleLogs: true,
+      logTransport: {
+        level: Logger.LogLevel.Info,
+      },
+      trackInteractions: true,
+      allowedTracingOrigins: ['https://my.api.domain']
+    }
   }
 });
 ```
 
 Check out the [`DatadogReporterConfig`](https://github.com/crimson-education/browser-logger/blob/main/src/reporters/datadogReporter.ts) for all of the configuration you can apply to Datadog reporting.
 
+This automatically adds a Datadog Log Transport that transmits Log data to Datadog, this can be customized in `DatadogReporterConfig` with `logTransport`, or disabled by setting `logTransport` to `false`.
+
 #### Amplify/Pinpoint
 
 To configure Amplify, this requires at least `region`, `identityPoolId` and `analyticsAppId`.
@@ -131,15 +271,16 @@ import { config } from '../configuration';
 import * as Logger from '@crimson-education/browser-logger';
 
 Logger.init({
-  ...
-  amplify: {
-    region: config.amplifyAwsRegion,
-    analyticsAppId: config.pinpointAnalyticsAppId,
-    identityPoolId: config.amplifyIdentityPoolId,
-
-    autoTrackEvents: true,
-    autoTrackPageViews: true,
-    autoTrackSessions: true,
+  reporters: {
+    amplify: {
+      region: config.amplifyAwsRegion,
+      analyticsAppId: config.pinpointAnalyticsAppId,
+      identityPoolId: config.amplifyIdentityPoolId,
+
+      autoTrackEvents: true,
+      autoTrackPageViews: true,
+      autoTrackSessions: true,
+    }
   }
 });
 ```
@@ -158,15 +299,16 @@ Auth.configure({
 });
 
 Logger.init({
-  ...
-  amplify: {
-    region: config.amplifyAwsRegion,
-    analyticsAppId: config.pinpointAnalyticsAppId,
-    identityPoolId: false,
-
-    autoTrackEvents: true,
-    autoTrackPageViews: true,
-    autoTrackSessions: true,
+  reporters: {
+    amplify: {
+      region: config.amplifyAwsRegion,
+      analyticsAppId: config.pinpointAnalyticsAppId,
+      identityPoolId: false,
+
+      autoTrackEvents: true,
+      autoTrackPageViews: true,
+      autoTrackSessions: true,
+    }
   }
 });
 ```
@@ -184,16 +326,18 @@ import * as Logger from '@crimson-education/browser-logger';
 
 // No configuration
 Logger.init({
-  ...
-  gtm: true,
+  reporters: {
+    gtm: true,
+  }
 });
 
 // With configuration
 Logger.init({
-  ...
-  gtm: {
-    ignoreBreadcrumbCategories: ['fetch']
-  },
+  reporters: {
+    gtm: {
+      ignoreBreadcrumbCategories: ['fetch']
+    }
+  }
 });
 ```
 
@@ -201,7 +345,8 @@ Check out the [`GTMReporterConfig`](https://github.com/crimson-education/browser
 
 ### Functions
 
-See the [src/index.ts](./src/index.ts) file for all exported functions of the Logger.
+See the [src/logger/index.ts](./src/logger/index.ts) file for all exported functions of the Logger.
+See the [src/reporter/index.ts](./src/reporter/index.ts) file for all exported functions of the Reporter.
 
 ### Improve Session Tracking with Component names
 

package/lib/index.d.ts

@@ -1,83 +1,13 @@
-import { ILogger, Metadata, ReporterBreadcrumb, ReporterEvent, ReporterFilters, ReportError, ReportUser, ServiceInfo, TrackedReporterEvent } from './types';
-import { DatadogReporterConfig, GTMReporterConfig, AmplifyReporterConfig } from './reporters';
+import { ReporterConfigurations, ServiceInfo } from './types';
 export * from './types';
-export declare let logger: ILogger | null;
-export declare type ReporterType = 'datadog' | 'gtm' | 'amplify';
-export declare type ReporterConfig = ServiceInfo & {
-    datadog?: DatadogReporterConfig;
-    amplify?: AmplifyReporterConfig;
-    gtm?: true | GTMReporterConfig;
+export * from './reporters';
+export * from './logger';
+export declare type LoggerConfig = ServiceInfo & {
+    reporters?: ReporterConfigurations;
 };
 /**
  * Initializes the logger and reporters.
  * @param config Reporter config options.
  */
-export declare function init(config: ReporterConfig): void;
-/**
- * Tracks an Analytics event.
- */
-export declare function trackEvent(event: ReporterEvent): void;
-/**
- * Tracks an Analytics event, recording the time since the last event, if available.
- */
-export declare function trackEventSinceLastAction(event: ReporterEvent): void;
-/**
- * Gets the last tracked event, if available.
- */
-export declare function getLastTrackedEvent(): TrackedReporterEvent | null;
-/**
- * Breadcrumbs to create a trail of events that happened prior to an issue.
- * These events are very similar to traditional logs, but can record more rich structured data.
- */
-export declare function addBreadcrumb(breadcrumb: ReporterBreadcrumb): void;
-/**
- * Adds global metadata to all events.
- * @param metadata Metadata to add.
- * @param filters Optional filters to specify which reporters to add metadata to.
- */
-export declare function addMetadata(metadata: Metadata, filters?: ReporterFilters): void;
-/**
- * Sets the user information in Analytics.
- * @param user User information, or null to clear.
- * @param filters Optional filters to specify which reporters to set the user for.
- */
-export declare function setUser(user: ReportUser | null, filters?: ReporterFilters): void;
-/**
- * Sets the route name in Analytics.
- * Some Analytics services use this differentiate SPA Route vs Page changes.
- * @param routeName Name of the Route.
- * @param filters Optional filters to specify which reporters to set the route name for.
- */
-export declare function setRouteName(routeName: string, filters?: ReporterFilters): void;
-/**
- * Sets the page name in Analytics.
- * @param pageName Name of the Page.
- * @param filters Optional filters to specify which reporters to set the page name for.
- */
-export declare function setPageName(pageName: string, filters?: ReporterFilters): void;
-/**
- * Reports an Error in Reporters that support error tracking.
- * @param error Error data.
- * @param metadata Metadata to add to the error.
- * @param filters Optional filters to specify which reporters to report the error to.
- */
-export declare function reportError(error: ReportError, metadata?: Metadata, filters?: ReporterFilters): void;
-/**
- * Starts a session recording in Analytics, e.g. RUM Session Replay
- * @param filters Optional filters to specify which reporters to start a session recording for.
- */
-export declare function recordSession(filters?: ReporterFilters): void;
-/**
- * Stops a session recording in Analytics, e.g. RUM Session Replay
- * @param filters Optional filters to specify which reporters to stop a session recording for.
- */
-export declare function recordSessionStop(filters?: ReporterFilters): void;
-/**
- * Creates a Logger instance.
- * @param name Name of the Logger.
- * @param options Logger configuration options.
- */
-export declare function createLogger(name?: string, options?: {
-    metadata?: Metadata;
-}): ILogger;
+export declare function init(config: LoggerConfig): void;
 //# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EAEP,QAAQ,EACR,kBAAkB,EAClB,aAAa,EACb,eAAe,EACf,WAAW,EACX,UAAU,EACV,WAAW,EACX,oBAAoB,EACrB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAGL,qBAAqB,EAErB,iBAAiB,EAEjB,qBAAqB,EACtB,MAAM,aAAa,CAAC;AAErB,cAAc,SAAS,CAAC;AAExB,eAAO,IAAI,MAAM,EAAE,OAAO,GAAG,IAAW,CAAC;AAEzC,oBAAY,YAAY,GAAG,SAAS,GAAG,KAAK,GAAG,SAAS,CAAC;AAEzD,oBAAY,cAAc,GAAG,WAAW,GAAG;IAEzC,OAAO,CAAC,EAAE,qBAAqB,CAAC;IAGhC,OAAO,CAAC,EAAE,qBAAqB,CAAC;IAGhC,GAAG,CAAC,EAAE,IAAI,GAAG,iBAAiB,CAAC;CAChC,CAAC;AAMF;;;GAGG;AACH,wBAAgB,IAAI,CAAC,MAAM,EAAE,cAAc,QAuB1C;AAkBD;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAIrD;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAgBpE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,oBAAoB,GAAG,IAAI,CAOjE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,kBAAkB,GAAG,IAAI,CAIlE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,IAAI,CAI/E;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,IAAI,CAIhF;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,IAAI,CAI/E;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,IAAI,CAI7E;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,IAAI,CAIpG;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,IAAI,CAI7D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,IAAI,CAIjE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,QAAQ,CAAA;CAAE,GAAG,OAAO,CAUtF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAQ9D,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AAEzB,oBAAY,YAAY,GAAG,WAAW,GAAG;IAAE,SAAS,CAAC,EAAE,sBAAsB,CAAA;CAAE,CAAC;AAIhF;;;GAGG;AACH,wBAAgB,IAAI,CAAC,MAAM,EAAE,YAAY,QA2CxC"}

package/lib/index.js

@@ -14,201 +14,57 @@ 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.createLogger = exports.recordSessionStop = exports.recordSession = exports.reportError = exports.setPageName = exports.setRouteName = exports.setUser = exports.addMetadata = exports.addBreadcrumb = exports.getLastTrackedEvent = exports.trackEventSinceLastAction = exports.trackEvent = exports.init = exports.logger = void 0;
-const utils_1 = require("./utils");
+exports.init = void 0;
+const logger_1 = require("./logger");
 const reporters_1 = require("./reporters");
+const gtmReporter_1 = require("./reporters/gtmReporter");
+const amplifyReporter_1 = require("./reporters/amplifyReporter");
+const datadogReporter_1 = require("./reporters/datadogReporter");
+const logReporter_1 = require("./reporters/logReporter");
 __exportStar(require("./types"), exports);
-exports.logger = null;
-const reporters = {};
+__exportStar(require("./reporters"), exports);
+__exportStar(require("./logger"), exports);
 let initialized = false;
-let ddInitialized = false;
 /**
  * Initializes the logger and reporters.
  * @param config Reporter config options.
  */
 function init(config) {
-    initialized = true;
-    if (config.datadog) {
-        reporters['datadog'] = (0, reporters_1.datadogReporter)(config, config.datadog);
-        ddInitialized = true;
-    }
-    if (config.amplify) {
-        reporters['amplify'] = (0, reporters_1.amplifyReporter)(config, config.amplify);
-    }
-    if (config.gtm) {
-        reporters['gtm'] = (0, reporters_1.gtmReporter)(config, typeof config.gtm === 'boolean' ? {} : config.gtm);
-    }
-    if (config.defaultMetadata) {
-        for (const reporter of Object.values(reporters)) {
-            reporter.addMetadata(config.defaultMetadata);
-        }
+    var _a, _b, _c, _d, _e, _f;
+    // Some reporters don't like being initialized multiple times.
+    if (initialized) {
+        return;
     }
-    exports.logger = createLogger('Reporter');
+    initialized = true;
+    // Log Reporter enabled by default.
+    const logReporterConfig = (_b = (_a = config.reporters) === null || _a === void 0 ? void 0 : _a.log) !== null && _b !== void 0 ? _b : true;
+    if (logReporterConfig !== false) {
+        reporters_1.reporters['log'] = (0, logReporter_1.logReporter)(config, typeof logReporterConfig === 'boolean' ? {} : logReporterConfig);
+    }
+    if ((_c = config.reporters) === null || _c === void 0 ? void 0 : _c.datadog) {
+        reporters_1.reporters['datadog'] = (0, datadogReporter_1.datadogReporter)(config, config.reporters.datadog);
+    }
+    if ((_d = config.reporters) === null || _d === void 0 ? void 0 : _d.amplify) {
+        reporters_1.reporters['amplify'] = (0, amplifyReporter_1.amplifyReporter)(config, config.reporters.amplify);
+    }
+    if ((_e = config.reporters) === null || _e === void 0 ? void 0 : _e.gtm) {
+        reporters_1.reporters['gtm'] = (0, gtmReporter_1.gtmReporter)(config, typeof config.reporters.gtm === 'boolean' ? {} : config.reporters.gtm);
+    }
+    const defaultMetadata = {
+        ...((_f = config.defaultMetadata) !== null && _f !== void 0 ? _f : {}),
+        service: config.service,
+        environment: config.environment,
+        version: config.version,
+    };
+    // Sets the global log level, if specified.
+    if (config.logLevel) {
+        (0, logger_1.setLogLevel)(config.logLevel);
+    }
+    // Sets the global event level, if specified.
+    if (config.eventLevel) {
+        (0, reporters_1.setEventLevel)(config.eventLevel);
+    }
+    (0, reporters_1.addMetadata)(defaultMetadata);
 }
 exports.init = init;
-/**
- * Gets reporters, optionally with filters.
- * @param filters Filters to remove or specify specific reporters.
- * @returns Selected reporters, or all registered reporters.
- */
-function getReporters(filters) {
-    let result = Object.entries(reporters);
-    if (filters === null || filters === void 0 ? void 0 : filters.excludeReporters) {
-        result = result.filter(([key]) => { var _a; return !((_a = filters === null || filters === void 0 ? void 0 : filters.excludeReporters) === null || _a === void 0 ? void 0 : _a.includes(key)); });
-    }
-    if (filters === null || filters === void 0 ? void 0 : filters.toReporters) {
-        result = result.filter(([key]) => { var _a; return (_a = filters === null || filters === void 0 ? void 0 : filters.toReporters) === null || _a === void 0 ? void 0 : _a.includes(key); });
-    }
-    return result.map(([, reporter]) => reporter);
-}
-/**
- * Tracks an Analytics event.
- */
-function trackEvent(event) {
-    for (const reporter of getReporters(event)) {
-        reporter.trackEvent(event);
-    }
-}
-exports.trackEvent = trackEvent;
-/**
- * Tracks an Analytics event, recording the time since the last event, if available.
- */
-function trackEventSinceLastAction(event) {
-    const lastEvent = getLastTrackedEvent();
-    if (lastEvent) {
-        const duration = new Date().getTime() - lastEvent.occurred.getTime();
-        trackEvent({
-            ...event,
-            metadata: {
-                ...event.metadata,
-                lastEventName: lastEvent.message,
-                timeSinceLastEvent: duration,
-            },
-        });
-    }
-    else {
-        trackEvent(event);
-    }
-    sessionStorage.setItem('loggerLastEvent', JSON.stringify({ ...event, occurred: new Date() }));
-}
-exports.trackEventSinceLastAction = trackEventSinceLastAction;
-/**
- * Gets the last tracked event, if available.
- */
-function getLastTrackedEvent() {
-    const eventStr = sessionStorage.getItem('loggerLastEvent');
-    if (!eventStr)
-        return null;
-    const event = JSON.parse(eventStr);
-    event.occurred = new Date(event.occurred);
-    return event;
-}
-exports.getLastTrackedEvent = getLastTrackedEvent;
-/**
- * Breadcrumbs to create a trail of events that happened prior to an issue.
- * These events are very similar to traditional logs, but can record more rich structured data.
- */
-function addBreadcrumb(breadcrumb) {
-    for (const reporter of getReporters(breadcrumb)) {
-        reporter.addBreadcrumb(breadcrumb);
-    }
-}
-exports.addBreadcrumb = addBreadcrumb;
-/**
- * Adds global metadata to all events.
- * @param metadata Metadata to add.
- * @param filters Optional filters to specify which reporters to add metadata to.
- */
-function addMetadata(metadata, filters) {
-    for (const reporter of getReporters(filters)) {
-        reporter.addMetadata(metadata);
-    }
-}
-exports.addMetadata = addMetadata;
-/**
- * Sets the user information in Analytics.
- * @param user User information, or null to clear.
- * @param filters Optional filters to specify which reporters to set the user for.
- */
-function setUser(user, filters) {
-    for (const reporter of getReporters(filters)) {
-        reporter.setUser(user);
-    }
-}
-exports.setUser = setUser;
-/**
- * Sets the route name in Analytics.
- * Some Analytics services use this differentiate SPA Route vs Page changes.
- * @param routeName Name of the Route.
- * @param filters Optional filters to specify which reporters to set the route name for.
- */
-function setRouteName(routeName, filters) {
-    for (const reporter of getReporters(filters)) {
-        reporter.setRouteName(routeName);
-    }
-}
-exports.setRouteName = setRouteName;
-/**
- * Sets the page name in Analytics.
- * @param pageName Name of the Page.
- * @param filters Optional filters to specify which reporters to set the page name for.
- */
-function setPageName(pageName, filters) {
-    for (const reporter of getReporters(filters)) {
-        reporter.setPageName(pageName);
-    }
-}
-exports.setPageName = setPageName;
-/**
- * Reports an Error in Reporters that support error tracking.
- * @param error Error data.
- * @param metadata Metadata to add to the error.
- * @param filters Optional filters to specify which reporters to report the error to.
- */
-function reportError(error, metadata, filters) {
-    var _a;
-    for (const reporter of getReporters(filters)) {
-        (_a = reporter.reportError) === null || _a === void 0 ? void 0 : _a.call(reporter, error, metadata);
-    }
-}
-exports.reportError = reportError;
-/**
- * Starts a session recording in Analytics, e.g. RUM Session Replay
- * @param filters Optional filters to specify which reporters to start a session recording for.
- */
-function recordSession(filters) {
-    var _a;
-    for (const reporter of getReporters(filters)) {
-        (_a = reporter.recordSession) === null || _a === void 0 ? void 0 : _a.call(reporter);
-    }
-}
-exports.recordSession = recordSession;
-/**
- * Stops a session recording in Analytics, e.g. RUM Session Replay
- * @param filters Optional filters to specify which reporters to stop a session recording for.
- */
-function recordSessionStop(filters) {
-    var _a;
-    for (const reporter of getReporters(filters)) {
-        (_a = reporter.recordSessionStop) === null || _a === void 0 ? void 0 : _a.call(reporter);
-    }
-}
-exports.recordSessionStop = recordSessionStop;
-/**
- * Creates a Logger instance.
- * @param name Name of the Logger.
- * @param options Logger configuration options.
- */
-function createLogger(name, options) {
-    if (!initialized) {
-        throw new Error('You must call init on BrowserLogger before creating a logger');
-    }
-    if (ddInitialized) {
-        return (0, reporters_1.datadogLogger)(name, options);
-    }
-    else {
-        return (0, utils_1.consoleLogger)(name, options);
-    }
-}
-exports.createLogger = createLogger;
 //# sourceMappingURL=index.js.map