@pie-players/pie-players-shared 0.2.0

package/dist/instrumentation/providers/ConsoleInstrumentationProvider.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Console Instrumentation Provider
+ *
+ * Development provider that logs instrumentation events to the console.
+ * Useful for debugging and testing without requiring external instrumentation services.
+ *
+ * @example
+ * ```typescript
+ * const provider = new ConsoleInstrumentationProvider();
+ * await provider.initialize({ debug: true });
+ *
+ * provider.trackError(new Error('Test error'), {
+ *   component: 'test-component',
+ *   errorType: 'TestError'
+ * });
+ * // Outputs: [Instrumentation Error] test-component: TestError
+ * //          Error: Test error
+ * //          { component: 'test-component', errorType: 'TestError' }
+ * ```
+ */
+import type { InstrumentationConfig, MetricAttributes } from "../types";
+import { BaseInstrumentationProvider } from "./BaseInstrumentationProvider";
+export interface ConsoleProviderConfig {
+    /**
+     * Use colored output in console
+     *
+     * @default true
+     */
+    useColors?: boolean;
+    /**
+     * Include stack traces with errors
+     *
+     * @default true
+     */
+    includeStackTrace?: boolean;
+    /**
+     * Group related logs together
+     *
+     * @default false
+     */
+    useGroups?: boolean;
+}
+export declare class ConsoleInstrumentationProvider extends BaseInstrumentationProvider {
+    readonly providerId = "console";
+    readonly providerName = "Console Logger";
+    private providerConfig;
+    constructor(providerConfig?: ConsoleProviderConfig);
+    /**
+     * Initialize the console provider
+     *
+     * @param config Optional configuration
+     */
+    initialize(config?: InstrumentationConfig): Promise<void>;
+    /**
+     * Check if provider is ready
+     *
+     * @returns true if initialized
+     */
+    isReady(): boolean;
+    /**
+     * Cleanup provider resources
+     */
+    destroy(): void;
+    /**
+     * Track an error to console
+     *
+     * @param error The error to track
+     * @param attributes Transformed attributes (already filtered and transformed by base class)
+     */
+    protected doTrackError(error: Error, attributes: Record<string, any>): void;
+    /**
+     * Track an event to console
+     *
+     * @param eventName Name of the event
+     * @param attributes Transformed attributes (already filtered and transformed by base class)
+     */
+    protected doTrackEvent(eventName: string, attributes: Record<string, any>): void;
+    /**
+     * Track a metric to console
+     *
+     * Overrides base class to provide custom formatting.
+     *
+     * @param metricName Name of the metric
+     * @param value Numeric value
+     * @param attributes Optional metric attributes
+     */
+    trackMetric(metricName: string, value: number, attributes?: MetricAttributes): void;
+    /**
+     * Set user context
+     *
+     * Logs user context to console.
+     *
+     * @param userId User identifier
+     * @param attributes Optional user attributes
+     */
+    protected doSetUserContext(userId: string, attributes?: Record<string, any>): void;
+    /**
+     * Set global attributes
+     *
+     * Logs global attributes to console.
+     *
+     * @param attributes Attributes to set globally
+     */
+    protected doSetGlobalAttributes(attributes: Record<string, any>): void;
+}
+//# sourceMappingURL=ConsoleInstrumentationProvider.d.ts.map

package/dist/instrumentation/providers/ConsoleInstrumentationProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConsoleInstrumentationProvider.d.ts","sourceRoot":"","sources":["../../../src/instrumentation/providers/ConsoleInstrumentationProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACxE,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAE5E,MAAM,WAAW,qBAAqB;IACrC;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,qBAAa,8BAA+B,SAAQ,2BAA2B;IAC9E,QAAQ,CAAC,UAAU,aAAa;IAChC,QAAQ,CAAC,YAAY,oBAAoB;IAEzC,OAAO,CAAC,cAAc,CAAwB;gBAElC,cAAc,GAAE,qBAA0B;IAStD;;;;OAIG;IACG,UAAU,CAAC,MAAM,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB/D;;;;OAIG;IACH,OAAO,IAAI,OAAO;IAIlB;;OAEG;IACH,OAAO,IAAI,IAAI;IAQf;;;;;OAKG;IACH,SAAS,CAAC,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAgC3E;;;;;OAKG;IACH,SAAS,CAAC,YAAY,CACrB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC7B,IAAI;IAgBP;;;;;;;;OAQG;IACH,WAAW,CACV,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,UAAU,CAAC,EAAE,gBAAgB,GAC3B,IAAI;IA+BP;;;;;;;OAOG;IACH,SAAS,CAAC,gBAAgB,CACzB,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC9B,IAAI;IAUP;;;;;;OAMG;IACH,SAAS,CAAC,qBAAqB,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;CAOtE"}

package/dist/instrumentation/providers/ConsoleInstrumentationProvider.js

@@ -0,0 +1,182 @@
+/**
+ * Console Instrumentation Provider
+ *
+ * Development provider that logs instrumentation events to the console.
+ * Useful for debugging and testing without requiring external instrumentation services.
+ *
+ * @example
+ * ```typescript
+ * const provider = new ConsoleInstrumentationProvider();
+ * await provider.initialize({ debug: true });
+ *
+ * provider.trackError(new Error('Test error'), {
+ *   component: 'test-component',
+ *   errorType: 'TestError'
+ * });
+ * // Outputs: [Instrumentation Error] test-component: TestError
+ * //          Error: Test error
+ * //          { component: 'test-component', errorType: 'TestError' }
+ * ```
+ */
+import { BaseInstrumentationProvider } from "./BaseInstrumentationProvider";
+export class ConsoleInstrumentationProvider extends BaseInstrumentationProvider {
+    providerId = "console";
+    providerName = "Console Logger";
+    providerConfig;
+    constructor(providerConfig = {}) {
+        super();
+        this.providerConfig = {
+            useColors: providerConfig.useColors !== false,
+            includeStackTrace: providerConfig.includeStackTrace !== false,
+            useGroups: providerConfig.useGroups === true,
+        };
+    }
+    /**
+     * Initialize the console provider
+     *
+     * @param config Optional configuration
+     */
+    async initialize(config) {
+        this.config = config;
+        this.initialized = true;
+        // Merge provider-specific config if provided
+        if (config?.providerSettings) {
+            this.providerConfig = {
+                ...this.providerConfig,
+                ...config.providerSettings,
+            };
+        }
+        console.log("%c[ConsoleProvider] Initialized", this.providerConfig.useColors ? "color: green; font-weight: bold" : "");
+    }
+    /**
+     * Check if provider is ready
+     *
+     * @returns true if initialized
+     */
+    isReady() {
+        return this.initialized;
+    }
+    /**
+     * Cleanup provider resources
+     */
+    destroy() {
+        this.initialized = false;
+        console.log("%c[ConsoleProvider] Destroyed", this.providerConfig.useColors ? "color: gray" : "");
+    }
+    /**
+     * Track an error to console
+     *
+     * @param error The error to track
+     * @param attributes Transformed attributes (already filtered and transformed by base class)
+     */
+    doTrackError(error, attributes) {
+        const style = this.providerConfig.useColors
+            ? "color: red; font-weight: bold"
+            : "";
+        const timestamp = new Date().toISOString();
+        if (this.providerConfig.useGroups) {
+            console.groupCollapsed(`%c[Instrumentation Error] ${attributes.component}: ${attributes.errorType}`, style);
+            console.error("Error:", error.message);
+            if (this.providerConfig.includeStackTrace && error.stack) {
+                console.error("Stack:", error.stack);
+            }
+            console.log("Attributes:", attributes);
+            console.log("Timestamp:", timestamp);
+            console.groupEnd();
+        }
+        else {
+            console.error(`%c[Instrumentation Error] ${attributes.component}: ${attributes.errorType}`, style);
+            console.error("Error:", error.message);
+            if (this.providerConfig.includeStackTrace && error.stack) {
+                console.error("Stack:", error.stack);
+            }
+            console.error("Attributes:", attributes);
+            console.error("Timestamp:", timestamp);
+        }
+    }
+    /**
+     * Track an event to console
+     *
+     * @param eventName Name of the event
+     * @param attributes Transformed attributes (already filtered and transformed by base class)
+     */
+    doTrackEvent(eventName, attributes) {
+        const style = this.providerConfig.useColors ? "color: blue" : "";
+        const timestamp = new Date().toISOString();
+        if (this.providerConfig.useGroups) {
+            console.groupCollapsed(`%c[Instrumentation Event] ${eventName}`, style);
+            console.log("Attributes:", attributes);
+            console.log("Timestamp:", timestamp);
+            console.groupEnd();
+        }
+        else {
+            console.log(`%c[Instrumentation Event] ${eventName}`, style);
+            console.log("Attributes:", attributes);
+            console.log("Timestamp:", timestamp);
+        }
+    }
+    /**
+     * Track a metric to console
+     *
+     * Overrides base class to provide custom formatting.
+     *
+     * @param metricName Name of the metric
+     * @param value Numeric value
+     * @param attributes Optional metric attributes
+     */
+    trackMetric(metricName, value, attributes) {
+        if (!this.isReady())
+            return;
+        const style = this.providerConfig.useColors ? "color: green" : "";
+        const timestamp = new Date().toISOString();
+        const unit = attributes?.unit || "";
+        const displayValue = unit ? `${value} ${unit}` : value;
+        if (this.providerConfig.useGroups) {
+            console.groupCollapsed(`%c[Instrumentation Metric] ${metricName}: ${displayValue}`, style);
+            if (attributes) {
+                console.log("Attributes:", attributes);
+            }
+            console.log("Timestamp:", timestamp);
+            console.groupEnd();
+        }
+        else {
+            console.log(`%c[Instrumentation Metric] ${metricName}:`, style, displayValue);
+            if (attributes) {
+                console.log("Attributes:", attributes);
+            }
+            console.log("Timestamp:", timestamp);
+        }
+    }
+    /**
+     * Set user context
+     *
+     * Logs user context to console.
+     *
+     * @param userId User identifier
+     * @param attributes Optional user attributes
+     */
+    doSetUserContext(userId, attributes) {
+        const style = this.providerConfig.useColors
+            ? "color: purple; font-weight: bold"
+            : "";
+        console.log(`%c[Instrumentation] Set User Context: ${userId}`, style);
+        if (attributes) {
+            console.log("User Attributes:", attributes);
+        }
+    }
+    /**
+     * Set global attributes
+     *
+     * Logs global attributes to console.
+     *
+     * @param attributes Attributes to set globally
+     */
+    doSetGlobalAttributes(attributes) {
+        const style = this.providerConfig.useColors
+            ? "color: orange; font-weight: bold"
+            : "";
+        console.log("%c[Instrumentation] Set Global Attributes", style);
+        console.log("Attributes:", attributes);
+    }
+}
+//# sourceMappingURL=ConsoleInstrumentationProvider.js.map

package/dist/instrumentation/providers/ConsoleInstrumentationProvider.js.map

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

package/dist/instrumentation/providers/DataDogInstrumentationProvider.d.ts

@@ -0,0 +1,170 @@
+/**
+ * DataDog RUM Instrumentation Provider
+ *
+ * Example alternative provider for DataDog Real User Monitoring.
+ * Demonstrates how to integrate with a third-party instrumentation service.
+ *
+ * NOTE: This provider requires `@datadog/browser-rum` to be installed:
+ * ```bash
+ * npm install @datadog/browser-rum
+ * ```
+ *
+ * @example
+ * ```typescript
+ * const provider = new DataDogInstrumentationProvider();
+ * await provider.initialize({
+ *   enabled: true,
+ *   sampleRate: 1.0,
+ *   providerSettings: {
+ *     applicationId: 'abc123',
+ *     clientToken: 'pub_xyz',
+ *     site: 'datadoghq.com',
+ *     service: 'pie-players',
+ *     env: 'production'
+ *   }
+ * });
+ *
+ * provider.trackError(new Error('Something went wrong'), {
+ *   component: 'my-component',
+ *   errorType: 'ValidationError'
+ * });
+ * ```
+ */
+import type { InstrumentationConfig } from "../types";
+import { BaseInstrumentationProvider } from "./BaseInstrumentationProvider";
+/**
+ * DataDog-specific configuration
+ */
+export interface DataDogConfig {
+    /**
+     * DataDog application ID
+     *
+     * Required. Get this from DataDog RUM application settings.
+     */
+    applicationId: string;
+    /**
+     * DataDog client token
+     *
+     * Required. Get this from DataDog RUM application settings.
+     */
+    clientToken: string;
+    /**
+     * DataDog site
+     *
+     * @default 'datadoghq.com'
+     * @example 'datadoghq.eu' for EU
+     */
+    site?: string;
+    /**
+     * Service name
+     *
+     * @default 'pie-players'
+     */
+    service?: string;
+    /**
+     * Environment name
+     *
+     * @default 'production'
+     * @example 'development', 'staging', 'production'
+     */
+    env?: string;
+    /**
+     * Application version
+     *
+     * @default '1.0.0'
+     */
+    version?: string;
+    /**
+     * Session replay sample rate (0-100)
+     *
+     * @default 0 (disabled)
+     * @example 20 to record 20% of sessions
+     */
+    sessionReplaySampleRate?: number;
+    /**
+     * Track user interactions
+     *
+     * @default true
+     */
+    trackUserInteractions?: boolean;
+    /**
+     * Track long tasks
+     *
+     * @default true
+     */
+    trackLongTasks?: boolean;
+    /**
+     * Default privacy level for session replay
+     *
+     * @default 'mask-user-input'
+     */
+    defaultPrivacyLevel?: "allow" | "mask" | "mask-user-input";
+}
+/**
+ * DataDog RUM Instrumentation Provider
+ *
+ * Integrates PIE players instrumentation with DataDog Real User Monitoring.
+ */
+export declare class DataDogInstrumentationProvider extends BaseInstrumentationProvider {
+    readonly providerId = "datadog";
+    readonly providerName = "DataDog RUM";
+    private datadogConfig?;
+    /**
+     * Initialize the DataDog provider
+     *
+     * Loads the DataDog RUM SDK and initializes it with the provided configuration.
+     *
+     * @param config Instrumentation configuration with DataDog-specific settings
+     * @throws {Error} If DataDog configuration is invalid or SDK fails to load
+     */
+    initialize(config?: InstrumentationConfig): Promise<void>;
+    /**
+     * Check if provider is ready
+     *
+     * @returns true if DataDog is initialized
+     */
+    isReady(): boolean;
+    /**
+     * Cleanup provider resources
+     *
+     * Marks provider as uninitialized. DataDog RUM SDK is not explicitly
+     * destroyed (no cleanup API available).
+     */
+    destroy(): void;
+    /**
+     * Track an error with DataDog
+     *
+     * Calls `datadogRum.addError()`
+     *
+     * @param error The error to track
+     * @param attributes Transformed attributes (already filtered and transformed by base class)
+     */
+    protected doTrackError(error: Error, attributes: Record<string, any>): void;
+    /**
+     * Track a custom event/action with DataDog
+     *
+     * Calls `datadogRum.addAction()`
+     *
+     * @param eventName Name of the event
+     * @param attributes Transformed attributes (already filtered and transformed by base class)
+     */
+    protected doTrackEvent(eventName: string, attributes: Record<string, any>): void;
+    /**
+     * Set user context for session tracking
+     *
+     * Calls `datadogRum.setUser()`
+     *
+     * @param userId User identifier
+     * @param attributes Optional user attributes
+     */
+    protected doSetUserContext(userId: string, attributes?: Record<string, any>): void;
+    /**
+     * Set global custom attributes
+     *
+     * Calls `datadogRum.setGlobalContextProperty()` for each attribute.
+     *
+     * @param attributes Attributes to set globally
+     */
+    protected doSetGlobalAttributes(attributes: Record<string, any>): void;
+}
+//# sourceMappingURL=DataDogInstrumentationProvider.d.ts.map

package/dist/instrumentation/providers/DataDogInstrumentationProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataDogInstrumentationProvider.d.ts","sourceRoot":"","sources":["../../../src/instrumentation/providers/DataDogInstrumentationProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAE5E;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B;;;;OAIG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;;OAKG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;;OAKG;IACH,uBAAuB,CAAC,EAAE,MAAM,CAAC;IAEjC;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAEhC;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,iBAAiB,CAAC;CAC3D;AAED;;;;GAIG;AACH,qBAAa,8BAA+B,SAAQ,2BAA2B;IAC9E,QAAQ,CAAC,UAAU,aAAa;IAChC,QAAQ,CAAC,YAAY,iBAAiB;IAEtC,OAAO,CAAC,aAAa,CAAC,CAAgB;IAEtC;;;;;;;OAOG;IACG,UAAU,CAAC,MAAM,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAkE/D;;;;OAIG;IACH,OAAO,IAAI,OAAO;IAIlB;;;;;OAKG;IACH,OAAO,IAAI,IAAI;IAOf;;;;;;;OAOG;IACH,SAAS,CAAC,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAW3E;;;;;;;OAOG;IACH,SAAS,CAAC,YAAY,CACrB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC7B,IAAI;IAQP;;;;;;;OAOG;IACH,SAAS,CAAC,gBAAgB,CACzB,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC9B,IAAI;IAWP;;;;;;OAMG;IACH,SAAS,CAAC,qBAAqB,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;CAStE"}

package/dist/instrumentation/providers/DataDogInstrumentationProvider.js

@@ -0,0 +1,183 @@
+/**
+ * DataDog RUM Instrumentation Provider
+ *
+ * Example alternative provider for DataDog Real User Monitoring.
+ * Demonstrates how to integrate with a third-party instrumentation service.
+ *
+ * NOTE: This provider requires `@datadog/browser-rum` to be installed:
+ * ```bash
+ * npm install @datadog/browser-rum
+ * ```
+ *
+ * @example
+ * ```typescript
+ * const provider = new DataDogInstrumentationProvider();
+ * await provider.initialize({
+ *   enabled: true,
+ *   sampleRate: 1.0,
+ *   providerSettings: {
+ *     applicationId: 'abc123',
+ *     clientToken: 'pub_xyz',
+ *     site: 'datadoghq.com',
+ *     service: 'pie-players',
+ *     env: 'production'
+ *   }
+ * });
+ *
+ * provider.trackError(new Error('Something went wrong'), {
+ *   component: 'my-component',
+ *   errorType: 'ValidationError'
+ * });
+ * ```
+ */
+import { BaseInstrumentationProvider } from "./BaseInstrumentationProvider";
+/**
+ * DataDog RUM Instrumentation Provider
+ *
+ * Integrates PIE players instrumentation with DataDog Real User Monitoring.
+ */
+export class DataDogInstrumentationProvider extends BaseInstrumentationProvider {
+    providerId = "datadog";
+    providerName = "DataDog RUM";
+    datadogConfig;
+    /**
+     * Initialize the DataDog provider
+     *
+     * Loads the DataDog RUM SDK and initializes it with the provided configuration.
+     *
+     * @param config Instrumentation configuration with DataDog-specific settings
+     * @throws {Error} If DataDog configuration is invalid or SDK fails to load
+     */
+    async initialize(config) {
+        if (typeof window === "undefined") {
+            throw new Error("[DataDogProvider] DataDog RUM requires browser environment");
+        }
+        this.config = config;
+        this.datadogConfig = config?.providerSettings;
+        if (!this.datadogConfig?.applicationId ||
+            !this.datadogConfig?.clientToken) {
+            throw new Error("[DataDogProvider] applicationId and clientToken are required in providerSettings");
+        }
+        try {
+            // Dynamically import DataDog RUM SDK
+            // @ts-expect-error - Optional peer dependency
+            const { datadogRum } = await import("@datadog/browser-rum");
+            // Initialize DataDog RUM
+            datadogRum.init({
+                applicationId: this.datadogConfig.applicationId,
+                clientToken: this.datadogConfig.clientToken,
+                site: this.datadogConfig.site || "datadoghq.com",
+                service: this.datadogConfig.service || "pie-players",
+                env: this.datadogConfig.env || "production",
+                version: this.datadogConfig.version || "1.0.0",
+                sessionSampleRate: config?.sampleRate !== undefined ? config.sampleRate * 100 : 100,
+                sessionReplaySampleRate: this.datadogConfig.sessionReplaySampleRate || 0,
+                trackUserInteractions: this.datadogConfig.trackUserInteractions !== false,
+                trackResources: true,
+                trackLongTasks: this.datadogConfig.trackLongTasks !== false,
+                defaultPrivacyLevel: this.datadogConfig.defaultPrivacyLevel || "mask-user-input",
+            });
+            // Start session replay if configured
+            if (this.datadogConfig.sessionReplaySampleRate &&
+                this.datadogConfig.sessionReplaySampleRate > 0) {
+                datadogRum.startSessionReplayRecording();
+            }
+            this.initialized = true;
+            if (this.config?.debug) {
+                console.log("[DataDogProvider] Initialized successfully", this.datadogConfig);
+            }
+        }
+        catch (error) {
+            console.error("[DataDogProvider] Failed to initialize:", error);
+            throw error;
+        }
+    }
+    /**
+     * Check if provider is ready
+     *
+     * @returns true if DataDog is initialized
+     */
+    isReady() {
+        return this.initialized;
+    }
+    /**
+     * Cleanup provider resources
+     *
+     * Marks provider as uninitialized. DataDog RUM SDK is not explicitly
+     * destroyed (no cleanup API available).
+     */
+    destroy() {
+        this.initialized = false;
+        if (this.config?.debug) {
+            console.log("[DataDogProvider] Destroyed");
+        }
+    }
+    /**
+     * Track an error with DataDog
+     *
+     * Calls `datadogRum.addError()`
+     *
+     * @param error The error to track
+     * @param attributes Transformed attributes (already filtered and transformed by base class)
+     */
+    doTrackError(error, attributes) {
+        // DataDog requires dynamic import
+        // @ts-expect-error - Optional peer dependency
+        import("@datadog/browser-rum").then(({ datadogRum }) => {
+            datadogRum.addError(error, {
+                ...attributes,
+                source: "custom",
+            });
+        });
+    }
+    /**
+     * Track a custom event/action with DataDog
+     *
+     * Calls `datadogRum.addAction()`
+     *
+     * @param eventName Name of the event
+     * @param attributes Transformed attributes (already filtered and transformed by base class)
+     */
+    doTrackEvent(eventName, attributes) {
+        // DataDog requires dynamic import
+        // @ts-expect-error - Optional peer dependency
+        import("@datadog/browser-rum").then(({ datadogRum }) => {
+            datadogRum.addAction(eventName, attributes);
+        });
+    }
+    /**
+     * Set user context for session tracking
+     *
+     * Calls `datadogRum.setUser()`
+     *
+     * @param userId User identifier
+     * @param attributes Optional user attributes
+     */
+    doSetUserContext(userId, attributes) {
+        // DataDog requires dynamic import
+        // @ts-expect-error - Optional peer dependency
+        import("@datadog/browser-rum").then(({ datadogRum }) => {
+            datadogRum.setUser({
+                id: userId,
+                ...attributes,
+            });
+        });
+    }
+    /**
+     * Set global custom attributes
+     *
+     * Calls `datadogRum.setGlobalContextProperty()` for each attribute.
+     *
+     * @param attributes Attributes to set globally
+     */
+    doSetGlobalAttributes(attributes) {
+        // DataDog requires dynamic import
+        // @ts-expect-error - Optional peer dependency
+        import("@datadog/browser-rum").then(({ datadogRum }) => {
+            for (const [key, value] of Object.entries(attributes)) {
+                datadogRum.setGlobalContextProperty(key, value);
+            }
+        });
+    }
+}
+//# sourceMappingURL=DataDogInstrumentationProvider.js.map

package/dist/instrumentation/providers/DataDogInstrumentationProvider.js.map

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