datadog-frontend-toolkit 1.0.0

package/dist/esm/core/ObservabilitySDK.js

@@ -0,0 +1,351 @@
+import { SDKEvent } from '../types/events';
+import { ConfigManager } from './ConfigManager';
+import { BootstrapGuard } from './BootstrapGuard';
+import { ContextManager } from '../context/ContextManager';
+import { RumManager } from '../rum/RumManager';
+import { LogsManager } from '../logs/LogsManager';
+import { LoggerService } from '../logger/LoggerService';
+import { ErrorBoundary } from '../errors/ErrorBoundary';
+import { PerformanceMonitor } from '../performance/PerformanceMonitor';
+import { NetworkInterceptor } from '../network/NetworkInterceptor';
+import { EventEmitter } from '../utils/EventEmitter';
+/**
+ * Main orchestrator for the Observability Toolkit.
+ *
+ * Implements the Facade pattern to provide a single entry point
+ * for all observability features. Manages the lifecycle of all
+ * sub-modules and coordinates initialization.
+ *
+ * Usage:
+ * ```ts
+ * import { init } from 'datadog-frontend-toolkit';
+ *
+ * const observatory = init({
+ *   clientToken: 'pub-xxx',
+ *   applicationId: 'xxx',
+ *   service: 'my-app',
+ *   env: 'production',
+ * });
+ *
+ * const logger = observatory.logger;
+ * logger.info('App started');
+ * ```
+ */
+export class ObservabilitySDK {
+    static instance = null;
+    config;
+    emitter;
+    contextManager;
+    rumManager;
+    logsManager;
+    errorBoundary;
+    performanceMonitor;
+    networkInterceptor;
+    /** Public logger instance */
+    logger;
+    destroyed = false;
+    constructor(config) {
+        // Apply lifecycle hook
+        const finalConfig = config.hooks?.beforeInit?.(config) ?? config;
+        // Resolve config with defaults
+        this.config = ConfigManager.resolve(finalConfig);
+        // Initialize core infrastructure
+        this.emitter = new EventEmitter();
+        this.contextManager = new ContextManager(this.config, this.emitter);
+        // Initialize Datadog SDKs
+        this.rumManager = new RumManager(this.config, this.contextManager);
+        this.logsManager = new LogsManager(this.config, this.contextManager);
+        // Initialize logger
+        this.logger = new LoggerService(this.logsManager, this.contextManager, this.emitter, {
+            minLevel: this.config.logLevel,
+            consoleOutput: this.config.consoleOutput,
+            service: this.config.service,
+            env: this.config.env,
+            version: this.config.version,
+            piiFields: this.config.privacy.piiFields,
+        });
+        // Initialize error boundary
+        this.errorBoundary = new ErrorBoundary(this.config, this.logger, this.rumManager, this.contextManager, this.emitter);
+        // Initialize performance monitor
+        this.performanceMonitor = new PerformanceMonitor(this.config, this.logger, this.rumManager, this.emitter);
+        // Initialize network interceptor
+        this.networkInterceptor = new NetworkInterceptor(this.config, this.logger, this.emitter);
+    }
+    /**
+     * Initializes the Observability SDK.
+     * This is the main entry point — call once at application bootstrap.
+     *
+     * Returns the SDK instance (singleton). Subsequent calls return the same instance.
+     */
+    static init(config) {
+        const guard = BootstrapGuard.getInstance();
+        // Prevent double initialization
+        if (ObservabilitySDK.instance && !ObservabilitySDK.instance.destroyed) {
+            if (ObservabilitySDK.instance.config.debug) {
+                // eslint-disable-next-line no-console
+                console.warn('[dd-frontend-toolkit] SDK already initialized. Returning existing instance.');
+            }
+            return ObservabilitySDK.instance;
+        }
+        const sdk = new ObservabilitySDK(config);
+        ObservabilitySDK.instance = sdk;
+        // Track bootstrap
+        const isFirstBoot = guard.isFirstBootstrap(sdk.config.service, sdk.config.env);
+        guard.markInitialized(sdk.config.service, sdk.config.env, sdk.config.version);
+        // Boot all modules
+        sdk.boot(isFirstBoot);
+        return sdk;
+    }
+    /**
+     * Returns the current SDK instance, or null if not initialized.
+     */
+    static getInstance() {
+        return ObservabilitySDK.instance;
+    }
+    /**
+     * Destroys the SDK and cleans up all handlers.
+     */
+    async destroy() {
+        if (this.destroyed)
+            return;
+        // Teardown plugins
+        for (const plugin of this.config.plugins) {
+            try {
+                await plugin.teardown?.();
+            }
+            catch {
+                // Swallow plugin teardown errors
+            }
+        }
+        this.errorBoundary.uninstall();
+        this.networkInterceptor.uninstall();
+        this.performanceMonitor.stop();
+        this.rumManager.stop();
+        this.emitter.removeAllListeners();
+        this.destroyed = true;
+        ObservabilitySDK.instance = null;
+        this.emitter.emit(SDKEvent.DESTROYED, {
+            type: SDKEvent.DESTROYED,
+            timestamp: Date.now(),
+        });
+    }
+    // ── Public API ──────────────────────────────────────────────
+    /**
+     * Sets the current user context across all Datadog modules.
+     */
+    setUser(user) {
+        this.contextManager.setUser(user);
+        this.rumManager.setUser(user);
+    }
+    /**
+     * Clears the current user context.
+     */
+    clearUser() {
+        this.contextManager.clearUser();
+        this.rumManager.clearUser();
+    }
+    /**
+     * Adds a key-value pair to the global context.
+     */
+    addGlobalContext(key, value) {
+        this.contextManager.setGlobalContext(key, value);
+        this.rumManager.setGlobalContext(key, value);
+        this.logsManager.setGlobalContext(key, value);
+    }
+    /**
+     * Removes a key from the global context.
+     */
+    removeGlobalContext(key) {
+        this.contextManager.removeGlobalContext(key);
+        this.rumManager.removeGlobalContext(key);
+        this.logsManager.removeGlobalContext(key);
+    }
+    /**
+     * Sets the current view/route name.
+     * Use this when navigating between pages in SPAs.
+     */
+    setView(name) {
+        this.contextManager.setView(name);
+        if (this.config.actions.trackViewsManually) {
+            this.rumManager.startView(name);
+        }
+    }
+    /**
+     * Tracks a custom user action.
+     */
+    trackAction(name, context) {
+        this.rumManager.addAction(name, context);
+    }
+    /**
+     * Manually captures an error and sends it to Datadog.
+     */
+    captureError(error, context) {
+        this.errorBoundary.captureError(error, context);
+    }
+    /**
+     * Captures a message as an error-level event.
+     */
+    captureMessage(message, context) {
+        this.errorBoundary.captureMessage(message, context);
+    }
+    /**
+     * Records a custom performance timing.
+     */
+    addTiming(name, duration) {
+        this.rumManager.addTiming(name, duration);
+    }
+    /**
+     * Marks a performance checkpoint.
+     */
+    mark(name) {
+        this.performanceMonitor.mark(name);
+    }
+    /**
+     * Measures time between two performance marks.
+     */
+    measure(name, startMark, endMark) {
+        return this.performanceMonitor.measure(name, startMark, endMark);
+    }
+    /**
+     * Starts session replay recording.
+     */
+    startSessionReplay() {
+        this.rumManager.startSessionReplay();
+    }
+    /**
+     * Stops session replay recording.
+     */
+    stopSessionReplay() {
+        this.rumManager.stopSessionReplay();
+    }
+    /**
+     * Grants consent for tracking (when privacy.requireConsent is true).
+     */
+    grantConsent() {
+        this.emitter.emit(SDKEvent.CONSENT_GRANTED, {
+            type: SDKEvent.CONSENT_GRANTED,
+            timestamp: Date.now(),
+        });
+    }
+    /**
+     * Revokes consent for tracking.
+     */
+    revokeConsent() {
+        this.emitter.emit(SDKEvent.CONSENT_REVOKED, {
+            type: SDKEvent.CONSENT_REVOKED,
+            timestamp: Date.now(),
+        });
+    }
+    /**
+     * Subscribes to SDK lifecycle events.
+     */
+    onEvent(event, handler) {
+        this.emitter.on(event, handler);
+    }
+    /**
+     * Unsubscribes from SDK lifecycle events.
+     */
+    offEvent(event, handler) {
+        this.emitter.off(event, handler);
+    }
+    /**
+     * Returns the resolved (with defaults) configuration.
+     */
+    getConfig() {
+        return Object.freeze({ ...this.config });
+    }
+    /**
+     * Returns the RUM internal context (session ID, view ID, etc.).
+     */
+    getRumContext() {
+        return this.rumManager.getInternalContext();
+    }
+    /**
+     * Returns whether the SDK has been initialized and is active.
+     */
+    isActive() {
+        return !this.destroyed;
+    }
+    // ── Private Boot Sequence ───────────────────────────────────
+    boot(isFirstBoot) {
+        // 1. Initialize Datadog SDKs
+        this.rumManager.init();
+        this.logsManager.init();
+        // 2. Install error boundary
+        if (this.config.errorTracking.enabled) {
+            this.errorBoundary.install();
+        }
+        // 3. Start performance monitoring
+        if (this.config.performance.webVitals || this.config.performance.longTasks) {
+            this.performanceMonitor.start();
+        }
+        // 4. Install network interceptor
+        if (this.config.network.enabled) {
+            this.networkInterceptor.install();
+        }
+        // 5. Start session replay if configured
+        if (this.config.sampling.sessionReplaySampleRate > 0) {
+            this.rumManager.startSessionReplay();
+        }
+        // 6. Load plugins
+        this.loadPlugins();
+        // 7. Log initialization
+        this.logger.info('Observability SDK initialized', {
+            service: this.config.service,
+            env: this.config.env,
+            version: this.config.version,
+            isFirstBoot,
+            features: {
+                rum: this.rumManager.isInitialized(),
+                logs: this.logsManager.isInitialized(),
+                errorTracking: this.config.errorTracking.enabled,
+                performanceMonitoring: this.config.performance.webVitals,
+                networkInterception: this.config.network.enabled,
+                sessionReplay: this.config.sampling.sessionReplaySampleRate > 0,
+            },
+        });
+        // 8. Emit initialized event
+        this.emitter.emit(SDKEvent.INITIALIZED, {
+            type: SDKEvent.INITIALIZED,
+            timestamp: Date.now(),
+            data: { isFirstBoot },
+        });
+        // 9. Call afterInit hook
+        this.config.hooks.afterInit?.();
+    }
+    loadPlugins() {
+        for (const plugin of this.config.plugins) {
+            this.loadPlugin(plugin);
+        }
+    }
+    loadPlugin(plugin) {
+        try {
+            plugin.setup(this);
+            this.emitter.emit(SDKEvent.PLUGIN_LOADED, {
+                type: SDKEvent.PLUGIN_LOADED,
+                timestamp: Date.now(),
+                data: { name: plugin.name, version: plugin.version },
+            });
+            if (this.config.debug) {
+                this.logger.debug(`Plugin loaded: ${plugin.name}@${plugin.version}`);
+            }
+        }
+        catch (error) {
+            this.emitter.emit(SDKEvent.PLUGIN_ERROR, {
+                type: SDKEvent.PLUGIN_ERROR,
+                timestamp: Date.now(),
+                data: {
+                    name: plugin.name,
+                    error: error instanceof Error ? error.message : String(error),
+                },
+            });
+            this.logger.error(`Failed to load plugin: ${plugin.name}`, error instanceof Error ? error : new Error(String(error)));
+        }
+    }
+    /** @internal For testing only */
+    static resetInstance() {
+        ObservabilitySDK.instance = null;
+        BootstrapGuard.resetInstance();
+    }
+}
+//# sourceMappingURL=ObservabilitySDK.js.map

package/dist/esm/core/ObservabilitySDK.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObservabilitySDK.js","sourceRoot":"","sources":["../../../src/core/ObservabilitySDK.ts"],"names":[],"mappings":"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"}

package/dist/esm/errors/ErrorBoundary.js

@@ -0,0 +1,183 @@
+import { SDKEvent } from '../types/events';
+/**
+ * Global error boundary that intercepts unhandled errors and promise rejections.
+ * Automatically forwards them to Datadog with full context.
+ *
+ * Features:
+ * - Global window.onerror handler
+ * - Unhandled promise rejection handler
+ * - Error throttling to prevent log flooding
+ * - Error pattern filtering
+ * - Stack trace enrichment
+ *
+ * Follows the Chain of Responsibility pattern for error processing.
+ */
+export class ErrorBoundary {
+    config;
+    logger;
+    rumManager;
+    contextManager;
+    emitter;
+    errorCount = 0;
+    errorWindowStart = Date.now();
+    installed = false;
+    originalOnError = null;
+    originalOnUnhandledRejection = null;
+    boundErrorHandler;
+    boundRejectionHandler;
+    constructor(config, logger, rumManager, contextManager, emitter) {
+        this.config = config;
+        this.logger = logger;
+        this.rumManager = rumManager;
+        this.contextManager = contextManager;
+        this.emitter = emitter;
+        this.boundErrorHandler = this.handleError.bind(this);
+        this.boundRejectionHandler = this.handleRejection.bind(this);
+    }
+    /**
+     * Installs global error handlers.
+     */
+    install() {
+        if (this.installed || typeof window === 'undefined') {
+            return;
+        }
+        // Preserve existing handlers
+        this.originalOnError = window.onerror;
+        this.originalOnUnhandledRejection = window.onunhandledrejection;
+        // Install our handlers
+        window.addEventListener('error', this.boundErrorHandler);
+        if (this.config.errorTracking.unhandledRejections) {
+            window.addEventListener('unhandledrejection', this.boundRejectionHandler);
+        }
+        this.installed = true;
+    }
+    /**
+     * Uninstalls global error handlers and restores originals.
+     */
+    uninstall() {
+        if (!this.installed || typeof window === 'undefined') {
+            return;
+        }
+        window.removeEventListener('error', this.boundErrorHandler);
+        window.removeEventListener('unhandledrejection', this.boundRejectionHandler);
+        // Restore original handlers
+        if (this.originalOnError !== undefined) {
+            window.onerror = this.originalOnError;
+        }
+        if (this.originalOnUnhandledRejection !== undefined) {
+            window.onunhandledrejection = this.originalOnUnhandledRejection;
+        }
+        this.installed = false;
+    }
+    /**
+     * Manually capture an error (for framework integrations).
+     */
+    captureError(error, context) {
+        this.processError(error, 'custom', true, context);
+    }
+    /**
+     * Manually capture a message as an error.
+     */
+    captureMessage(message, context) {
+        const error = new Error(message);
+        error.name = 'CapturedMessage';
+        this.processError(error, 'custom', true, context);
+    }
+    handleError(event) {
+        const error = event.error instanceof Error
+            ? event.error
+            : new Error(event.message || 'Unknown error');
+        if (!(event.error instanceof Error)) {
+            error.name = 'UncaughtError';
+        }
+        const context = {
+            filename: event.filename,
+            lineno: event.lineno,
+            colno: event.colno,
+        };
+        this.processError(error, 'global', false, context);
+    }
+    handleRejection(event) {
+        const error = event.reason instanceof Error
+            ? event.reason
+            : new Error(typeof event.reason === 'string'
+                ? event.reason
+                : 'Unhandled promise rejection');
+        if (!(event.reason instanceof Error)) {
+            error.name = 'UnhandledRejection';
+        }
+        this.processError(error, 'promise', false, {
+            type: 'unhandled_rejection',
+        });
+    }
+    processError(error, source, handled, context) {
+        // Check if error should be ignored
+        if (this.shouldIgnore(error)) {
+            return;
+        }
+        // Throttle check
+        if (this.isThrottled()) {
+            return;
+        }
+        // Enrich context
+        const enrichedContext = {
+            ...context,
+            error_source: source,
+            handled,
+            url: typeof window !== 'undefined' ? window.location.href : undefined,
+            view: this.contextManager.getView(),
+            user_id: this.contextManager.getUser()?.id,
+        };
+        // Log the error
+        this.logger.error(`[${source}] ${error.message}`, error, enrichedContext);
+        // Report to RUM
+        this.rumManager.addError(error, enrichedContext);
+        // Emit event
+        const payload = {
+            type: SDKEvent.ERROR_CAPTURED,
+            timestamp: Date.now(),
+            data: {
+                error,
+                source,
+                context: enrichedContext,
+                handled,
+            },
+        };
+        this.emitter.emit(SDKEvent.ERROR_CAPTURED, payload);
+    }
+    shouldIgnore(error) {
+        const message = error.message || '';
+        return this.config.errorTracking.ignorePatterns.some((pattern) => {
+            if (typeof pattern === 'string') {
+                return message.includes(pattern);
+            }
+            return pattern.test(message);
+        });
+    }
+    isThrottled() {
+        const now = Date.now();
+        const windowMs = 60000; // 1 minute window
+        // Reset window if expired
+        if (now - this.errorWindowStart > windowMs) {
+            this.errorCount = 0;
+            this.errorWindowStart = now;
+        }
+        this.errorCount++;
+        if (this.errorCount > this.config.errorTracking.maxErrorsPerMinute) {
+            if (this.errorCount === this.config.errorTracking.maxErrorsPerMinute + 1) {
+                // Log throttle activation once
+                this.emitter.emit(SDKEvent.THROTTLE_ACTIVATED, {
+                    type: SDKEvent.THROTTLE_ACTIVATED,
+                    timestamp: now,
+                    data: {
+                        errorsPerMinute: this.errorCount,
+                        threshold: this.config.errorTracking.maxErrorsPerMinute,
+                    },
+                });
+            }
+            return true;
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=ErrorBoundary.js.map

package/dist/esm/errors/ErrorBoundary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorBoundary.js","sourceRoot":"","sources":["../../../src/errors/ErrorBoundary.ts"],"names":[],"mappings":"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"}

package/dist/esm/index.js

@@ -0,0 +1,87 @@
+/**
+ * datadog-frontend-toolkit
+ *
+ * Enterprise-grade, framework-agnostic frontend observability toolkit for Datadog.
+ * Auto-instruments RUM, Logs, Error Tracking, Performance Monitoring,
+ * and provisions Dashboards, Monitors & SLOs.
+ *
+ * @example
+ * ```ts
+ * import { init } from 'datadog-frontend-toolkit';
+ *
+ * const observatory = init({
+ *   clientToken: 'pub-xxx',
+ *   applicationId: 'xxx-xxx-xxx',
+ *   service: 'my-frontend-app',
+ *   env: 'production',
+ *   version: '1.2.3',
+ * });
+ *
+ * // Use the logger
+ * observatory.logger.info('Application started');
+ * observatory.logger.error('Something failed', new Error('oops'), { orderId: '123' });
+ *
+ * // Set user context
+ * observatory.setUser({ id: 'user-1', name: 'John', email: 'john@example.com' });
+ *
+ * // Track custom actions
+ * observatory.trackAction('checkout_completed', { total: 99.99 });
+ *
+ * // SPA view tracking
+ * observatory.setView('/dashboard');
+ * ```
+ *
+ * @packageDocumentation
+ */
+import { ObservabilitySDK } from './core/ObservabilitySDK';
+// ── Main init function ──────────────────────────────────────
+/**
+ * Initializes the Observability SDK with the given configuration.
+ * Call this once at application bootstrap.
+ *
+ * @param config - SDK configuration. Only `clientToken`, `applicationId`, `service`, and `env` are required.
+ * @returns The SDK instance with logger and all observability features.
+ */
+export function init(config) {
+    return ObservabilitySDK.init(config);
+}
+/**
+ * Returns the current SDK instance, or null if not initialized.
+ * Useful for accessing the SDK from anywhere without passing references.
+ */
+export function getInstance() {
+    return ObservabilitySDK.getInstance();
+}
+/**
+ * Shorthand to get the logger from the current SDK instance.
+ * Throws if the SDK has not been initialized.
+ */
+export function getLogger() {
+    const instance = ObservabilitySDK.getInstance();
+    if (!instance) {
+        throw new Error('[dd-frontend-toolkit] SDK not initialized. Call init() first.');
+    }
+    return instance.logger;
+}
+// ── Re-exports ──────────────────────────────────────────────
+// Core
+export { ObservabilitySDK } from './core/ObservabilitySDK';
+export { ConfigManager } from './core/ConfigManager';
+export { BootstrapGuard } from './core/BootstrapGuard';
+// Modules
+export { LoggerService, ChildLogger } from './logger/LoggerService';
+export { RumManager } from './rum/RumManager';
+export { LogsManager } from './logs/LogsManager';
+export { ErrorBoundary } from './errors/ErrorBoundary';
+export { PerformanceMonitor } from './performance/PerformanceMonitor';
+export { NetworkInterceptor } from './network/NetworkInterceptor';
+export { ContextManager } from './context/ContextManager';
+// Resource provisioning (CLI/server-side only)
+export { ResourceProvisioner } from './resources/ResourceProvisioner';
+// Utilities
+export { Sanitizer } from './utils/sanitizer';
+export { EventEmitter } from './utils/EventEmitter';
+export { LogLevel } from './types/config';
+export { LOG_LEVEL_PRIORITY } from './types/logger';
+export { SDKEvent } from './types/events';
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAG3D,+DAA+D;AAE/D;;;;;;GAMG;AACH,MAAM,UAAU,IAAI,CAAC,MAA2B;IAC9C,OAAO,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACvC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW;IACzB,OAAO,gBAAgB,CAAC,WAAW,EAAE,CAAC;AACxC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS;IACvB,MAAM,QAAQ,GAAG,gBAAgB,CAAC,WAAW,EAAE,CAAC;IAChD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CACb,+DAA+D,CAChE,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC,MAAM,CAAC;AACzB,CAAC;AAED,+DAA+D;AAE/D,OAAO;AACP,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,UAAU;AACV,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,+CAA+C;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAEtE,YAAY;AACZ,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAuBpD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAa1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAWpD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC"}