@pie-players/pie-players-shared 0.2.0

package/dist/index.js

@@ -0,0 +1,11 @@
+export * from "./config/profile";
+export * from "./instrumentation";
+export * from "./loader-config";
+export * from "./loaders";
+export * from "./object";
+// Barrel export for PIE runtime utilities
+export * from "./pie";
+export { editorPostFix } from "./types";
+export * from "./ui/focus-trap";
+export * from "./ui/safe-storage";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,0CAA0C;AAC1C,cAAc,OAAO,CAAC;AAqBtB,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC"}

package/dist/instrumentation/index.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Instrumentation Module
+ *
+ * Provides pluggable instrumentation for PIE players.
+ * Supports multiple providers (New Relic, DataDog, console logging, custom, etc.)
+ *
+ * @example Using New Relic (default)
+ * ```typescript
+ * import { NewRelicInstrumentationProvider } from '@pie-players/pie-players-shared';
+ *
+ * const provider = new NewRelicInstrumentationProvider();
+ * await provider.initialize();
+ *
+ * const monitor = new ResourceMonitor({
+ *   trackPageActions: true,
+ *   instrumentationProvider: provider
+ * });
+ * ```
+ *
+ * @example Using DataDog
+ * ```typescript
+ * import { DataDogInstrumentationProvider } from '@pie-players/pie-players-shared';
+ *
+ * const provider = new DataDogInstrumentationProvider();
+ * await provider.initialize({
+ *   providerSettings: {
+ *     applicationId: 'abc123',
+ *     clientToken: 'pub_xyz'
+ *   }
+ * });
+ *
+ * const monitor = new ResourceMonitor({
+ *   trackPageActions: true,
+ *   instrumentationProvider: provider
+ * });
+ * ```
+ *
+ * @example Using console logger for development
+ * ```typescript
+ * import { ConsoleInstrumentationProvider } from '@pie-players/pie-players-shared';
+ *
+ * const provider = new ConsoleInstrumentationProvider();
+ * await provider.initialize({ debug: true });
+ *
+ * const monitor = new ResourceMonitor({
+ *   trackPageActions: true,
+ *   instrumentationProvider: provider
+ * });
+ * ```
+ */
+export * from "./providers";
+export type { ErrorAttributes, EventAttributes, InstrumentationConfig, InstrumentationProvider, MetricAttributes, } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/instrumentation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/instrumentation/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AAGH,cAAc,aAAa,CAAC;AAE5B,YAAY,EACX,eAAe,EACf,eAAe,EACf,qBAAqB,EACrB,uBAAuB,EACvB,gBAAgB,GAChB,MAAM,SAAS,CAAC"}

package/dist/instrumentation/index.js

@@ -0,0 +1,53 @@
+/**
+ * Instrumentation Module
+ *
+ * Provides pluggable instrumentation for PIE players.
+ * Supports multiple providers (New Relic, DataDog, console logging, custom, etc.)
+ *
+ * @example Using New Relic (default)
+ * ```typescript
+ * import { NewRelicInstrumentationProvider } from '@pie-players/pie-players-shared';
+ *
+ * const provider = new NewRelicInstrumentationProvider();
+ * await provider.initialize();
+ *
+ * const monitor = new ResourceMonitor({
+ *   trackPageActions: true,
+ *   instrumentationProvider: provider
+ * });
+ * ```
+ *
+ * @example Using DataDog
+ * ```typescript
+ * import { DataDogInstrumentationProvider } from '@pie-players/pie-players-shared';
+ *
+ * const provider = new DataDogInstrumentationProvider();
+ * await provider.initialize({
+ *   providerSettings: {
+ *     applicationId: 'abc123',
+ *     clientToken: 'pub_xyz'
+ *   }
+ * });
+ *
+ * const monitor = new ResourceMonitor({
+ *   trackPageActions: true,
+ *   instrumentationProvider: provider
+ * });
+ * ```
+ *
+ * @example Using console logger for development
+ * ```typescript
+ * import { ConsoleInstrumentationProvider } from '@pie-players/pie-players-shared';
+ *
+ * const provider = new ConsoleInstrumentationProvider();
+ * await provider.initialize({ debug: true });
+ *
+ * const monitor = new ResourceMonitor({
+ *   trackPageActions: true,
+ *   instrumentationProvider: provider
+ * });
+ * ```
+ */
+// Providers
+export * from "./providers";
+//# sourceMappingURL=index.js.map

package/dist/instrumentation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/instrumentation/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AAEH,YAAY;AACZ,cAAc,aAAa,CAAC"}

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

@@ -0,0 +1,197 @@
+/**
+ * Base Instrumentation Provider
+ *
+ * Abstract base class that implements common instrumentation logic for all providers.
+ * Provides a template method pattern for tracking errors and events with consistent
+ * filtering, transformation, and sampling behavior.
+ *
+ * Concrete providers only need to implement the actual tracking methods specific
+ * to their instrumentation backend (New Relic, DataDog, etc.)
+ */
+import type { ErrorAttributes, EventAttributes, InstrumentationConfig, InstrumentationProvider, MetricAttributes } from "../types";
+/**
+ * Abstract base class for instrumentation providers
+ *
+ * Implements the template method pattern:
+ * 1. Checks if provider is ready
+ * 2. Applies filters (errorFilter, eventFilter)
+ * 3. Applies sampling (sampleRate)
+ * 4. Transforms attributes (attributeTransformer)
+ * 5. Delegates to concrete provider implementation (doTrackError, doTrackEvent, etc.)
+ */
+export declare abstract class BaseInstrumentationProvider implements InstrumentationProvider {
+    abstract readonly providerId: string;
+    abstract readonly providerName: string;
+    protected initialized: boolean;
+    protected config?: InstrumentationConfig;
+    /**
+     * Initialize the provider with configuration
+     *
+     * Concrete providers should override this method to perform provider-specific
+     * initialization (e.g., loading SDK, checking global objects, etc.)
+     *
+     * @param config Optional configuration
+     */
+    abstract initialize(config?: InstrumentationConfig): Promise<void>;
+    /**
+     * Check if provider is ready to track events
+     *
+     * Concrete providers should override this method to check provider-specific
+     * readiness (e.g., SDK loaded, global object available, etc.)
+     *
+     * @returns true if provider is ready
+     */
+    abstract isReady(): boolean;
+    /**
+     * Cleanup provider resources
+     *
+     * Concrete providers should override this method to perform provider-specific
+     * cleanup (e.g., disconnect SDK, clear listeners, etc.)
+     */
+    abstract destroy(): void;
+    /**
+     * Track an error with the instrumentation backend
+     *
+     * Called by trackError() after all filters and transforms have been applied.
+     * Concrete providers should implement the actual error tracking here.
+     *
+     * @param error The error to track
+     * @param attributes Transformed and filtered attributes
+     */
+    protected abstract doTrackError(error: Error, attributes: Record<string, any>): void;
+    /**
+     * Track an event with the instrumentation backend
+     *
+     * Called by trackEvent() after all filters and transforms have been applied.
+     * Concrete providers should implement the actual event tracking here.
+     *
+     * @param eventName Name of the event
+     * @param attributes Transformed and filtered attributes
+     */
+    protected abstract doTrackEvent(eventName: string, attributes: Record<string, any>): void;
+    /**
+     * Set user context in the instrumentation backend
+     *
+     * Called by setUserContext() after readiness check.
+     * Concrete providers should implement the actual user context setting here.
+     *
+     * @param userId User identifier
+     * @param attributes Optional user attributes
+     */
+    protected abstract doSetUserContext(userId: string, attributes?: Record<string, any>): void;
+    /**
+     * Set global attributes in the instrumentation backend
+     *
+     * Called by setGlobalAttributes() after readiness check.
+     * Concrete providers should implement the actual global attribute setting here.
+     *
+     * @param attributes Attributes to set globally
+     */
+    protected abstract doSetGlobalAttributes(attributes: Record<string, any>): void;
+    /**
+     * Track an error with the instrumentation provider
+     *
+     * Template method that:
+     * 1. Checks if provider is ready
+     * 2. Applies error filter if configured
+     * 3. Transforms attributes if configured
+     * 4. Delegates to concrete provider implementation (doTrackError)
+     *
+     * @param error The error to track
+     * @param attributes Contextual attributes
+     */
+    trackError(error: Error, attributes: ErrorAttributes): void;
+    /**
+     * Track a custom event with the instrumentation provider
+     *
+     * Template method that:
+     * 1. Checks if provider is ready
+     * 2. Applies event filter if configured
+     * 3. Applies sampling if configured
+     * 4. Transforms attributes if configured
+     * 5. Adds timestamp if not present
+     * 6. Delegates to concrete provider implementation (doTrackEvent)
+     *
+     * @param eventName Name of the event
+     * @param attributes Event attributes
+     */
+    trackEvent(eventName: string, attributes: EventAttributes): void;
+    /**
+     * Track a performance metric
+     *
+     * Default implementation tracks metrics as events with a `metric:` prefix.
+     * Concrete providers can override this method if their backend has a
+     * dedicated metric API.
+     *
+     * @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 for session tracking
+     *
+     * Template method that checks if provider is ready then delegates
+     * to concrete provider implementation.
+     *
+     * @param userId User identifier
+     * @param attributes Optional user attributes
+     */
+    setUserContext(userId: string, attributes?: Record<string, any>): void;
+    /**
+     * Set global custom attributes
+     *
+     * Template method that checks if provider is ready then delegates
+     * to concrete provider implementation.
+     *
+     * @param attributes Attributes to set globally
+     */
+    setGlobalAttributes(attributes: Record<string, any>): void;
+    /**
+     * Guard operation - check if provider is ready
+     *
+     * Returns false if provider is not ready, logging a warning in debug mode.
+     *
+     * @param operation Name of the operation for logging
+     * @param args Arguments for logging
+     * @returns true if provider is ready, false otherwise
+     */
+    protected guardedOperation(operation: string, ...args: any[]): boolean;
+    /**
+     * Apply error filter if configured
+     *
+     * Returns false if error should be filtered out, logging in debug mode.
+     *
+     * @param error The error
+     * @param attributes Error attributes
+     * @returns true if error should be tracked, false if filtered out
+     */
+    protected applyErrorFilter(error: Error, attributes: ErrorAttributes): boolean;
+    /**
+     * Apply event filter if configured
+     *
+     * Returns false if event should be filtered out, logging in debug mode.
+     *
+     * @param eventName Event name
+     * @param attributes Event attributes
+     * @returns true if event should be tracked, false if filtered out
+     */
+    protected applyEventFilter(eventName: string, attributes: EventAttributes): boolean;
+    /**
+     * Apply sampling if configured
+     *
+     * Returns false if event should be sampled out, logging in debug mode.
+     *
+     * @param eventName Event name for logging
+     * @returns true if event should be tracked, false if sampled out
+     */
+    protected applySampling(eventName: string): boolean;
+    /**
+     * Transform attributes if transformer is configured
+     *
+     * @param attributes Original attributes
+     * @returns Transformed attributes or original if no transformer
+     */
+    protected transformAttributes(attributes: Record<string, any>): Record<string, any>;
+}
+//# sourceMappingURL=BaseInstrumentationProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BaseInstrumentationProvider.d.ts","sourceRoot":"","sources":["../../../src/instrumentation/providers/BaseInstrumentationProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACX,eAAe,EACf,eAAe,EACf,qBAAqB,EACrB,uBAAuB,EACvB,gBAAgB,EAChB,MAAM,UAAU,CAAC;AAElB;;;;;;;;;GASG;AACH,8BAAsB,2BACrB,YAAW,uBAAuB;IAElC,QAAQ,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAEvC,SAAS,CAAC,WAAW,UAAS;IAC9B,SAAS,CAAC,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAEzC;;;;;;;OAOG;IACH,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAElE;;;;;;;OAOG;IACH,QAAQ,CAAC,OAAO,IAAI,OAAO;IAE3B;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,IAAI,IAAI;IAMxB;;;;;;;;OAQG;IACH,SAAS,CAAC,QAAQ,CAAC,YAAY,CAC9B,KAAK,EAAE,KAAK,EACZ,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC7B,IAAI;IAEP;;;;;;;;OAQG;IACH,SAAS,CAAC,QAAQ,CAAC,YAAY,CAC9B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC7B,IAAI;IAEP;;;;;;;;OAQG;IACH,SAAS,CAAC,QAAQ,CAAC,gBAAgB,CAClC,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC9B,IAAI;IAEP;;;;;;;OAOG;IACH,SAAS,CAAC,QAAQ,CAAC,qBAAqB,CACvC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC7B,IAAI;IAMP;;;;;;;;;;;OAWG;IACH,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,eAAe,GAAG,IAAI;IA8B3D;;;;;;;;;;;;;OAaG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,eAAe,GAAG,IAAI;IA2ChE;;;;;;;;;;OAUG;IACH,WAAW,CACV,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,UAAU,CAAC,EAAE,gBAAgB,GAC3B,IAAI;IASP;;;;;;;;OAQG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAsBtE;;;;;;;OAOG;IACH,mBAAmB,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IA4B1D;;;;;;;;OAQG;IACH,SAAS,CAAC,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,OAAO;IAatE;;;;;;;;OAQG;IACH,SAAS,CAAC,gBAAgB,CACzB,KAAK,EAAE,KAAK,EACZ,UAAU,EAAE,eAAe,GACzB,OAAO;IAiBV;;;;;;;;OAQG;IACH,SAAS,CAAC,gBAAgB,CACzB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,eAAe,GACzB,OAAO;IAiBV;;;;;;;OAOG;IACH,SAAS,CAAC,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAYnD;;;;;OAKG;IACH,SAAS,CAAC,mBAAmB,CAC5B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC7B,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAMtB"}

package/dist/instrumentation/providers/BaseInstrumentationProvider.js

@@ -0,0 +1,267 @@
+/**
+ * Base Instrumentation Provider
+ *
+ * Abstract base class that implements common instrumentation logic for all providers.
+ * Provides a template method pattern for tracking errors and events with consistent
+ * filtering, transformation, and sampling behavior.
+ *
+ * Concrete providers only need to implement the actual tracking methods specific
+ * to their instrumentation backend (New Relic, DataDog, etc.)
+ */
+/**
+ * Abstract base class for instrumentation providers
+ *
+ * Implements the template method pattern:
+ * 1. Checks if provider is ready
+ * 2. Applies filters (errorFilter, eventFilter)
+ * 3. Applies sampling (sampleRate)
+ * 4. Transforms attributes (attributeTransformer)
+ * 5. Delegates to concrete provider implementation (doTrackError, doTrackEvent, etc.)
+ */
+export class BaseInstrumentationProvider {
+    initialized = false;
+    config;
+    // ============================================================================
+    // Public API methods (template methods)
+    // ============================================================================
+    /**
+     * Track an error with the instrumentation provider
+     *
+     * Template method that:
+     * 1. Checks if provider is ready
+     * 2. Applies error filter if configured
+     * 3. Transforms attributes if configured
+     * 4. Delegates to concrete provider implementation (doTrackError)
+     *
+     * @param error The error to track
+     * @param attributes Contextual attributes
+     */
+    trackError(error, attributes) {
+        // Guard: check if provider is ready
+        if (!this.guardedOperation("trackError", error, attributes)) {
+            return;
+        }
+        // Apply error filter
+        if (!this.applyErrorFilter(error, attributes)) {
+            return;
+        }
+        // Transform attributes
+        const finalAttributes = this.transformAttributes(attributes);
+        // Delegate to concrete provider
+        try {
+            this.doTrackError(error, finalAttributes);
+            if (this.config?.debug) {
+                console.log(`[${this.providerName}] Tracked error:`, error, finalAttributes);
+            }
+        }
+        catch (err) {
+            console.error(`[${this.providerName}] Error tracking error:`, err);
+        }
+    }
+    /**
+     * Track a custom event with the instrumentation provider
+     *
+     * Template method that:
+     * 1. Checks if provider is ready
+     * 2. Applies event filter if configured
+     * 3. Applies sampling if configured
+     * 4. Transforms attributes if configured
+     * 5. Adds timestamp if not present
+     * 6. Delegates to concrete provider implementation (doTrackEvent)
+     *
+     * @param eventName Name of the event
+     * @param attributes Event attributes
+     */
+    trackEvent(eventName, attributes) {
+        // Guard: check if provider is ready
+        if (!this.guardedOperation("trackEvent", eventName, attributes)) {
+            return;
+        }
+        // Apply event filter
+        if (!this.applyEventFilter(eventName, attributes)) {
+            return;
+        }
+        // Apply sampling
+        if (!this.applySampling(eventName)) {
+            return;
+        }
+        // Transform attributes
+        let finalAttributes = this.transformAttributes(attributes);
+        // Add timestamp if not present
+        if (!finalAttributes.timestamp) {
+            finalAttributes = {
+                ...finalAttributes,
+                timestamp: new Date().toISOString(),
+            };
+        }
+        // Delegate to concrete provider
+        try {
+            this.doTrackEvent(eventName, finalAttributes);
+            if (this.config?.debug) {
+                console.log(`[${this.providerName}] Tracked event:`, eventName, finalAttributes);
+            }
+        }
+        catch (err) {
+            console.error(`[${this.providerName}] Error tracking event:`, err);
+        }
+    }
+    /**
+     * Track a performance metric
+     *
+     * Default implementation tracks metrics as events with a `metric:` prefix.
+     * Concrete providers can override this method if their backend has a
+     * dedicated metric API.
+     *
+     * @param metricName Name of the metric
+     * @param value Numeric value
+     * @param attributes Optional metric attributes
+     */
+    trackMetric(metricName, value, attributes) {
+        // Default implementation: track as event
+        this.trackEvent(`metric:${metricName}`, {
+            ...attributes,
+            metricValue: value,
+            metricName,
+        });
+    }
+    /**
+     * Set user context for session tracking
+     *
+     * Template method that checks if provider is ready then delegates
+     * to concrete provider implementation.
+     *
+     * @param userId User identifier
+     * @param attributes Optional user attributes
+     */
+    setUserContext(userId, attributes) {
+        // Guard: check if provider is ready
+        if (!this.guardedOperation("setUserContext", userId, attributes)) {
+            return;
+        }
+        // Delegate to concrete provider
+        try {
+            this.doSetUserContext(userId, attributes);
+            if (this.config?.debug) {
+                console.log(`[${this.providerName}] Set user context:`, userId, attributes);
+            }
+        }
+        catch (err) {
+            console.error(`[${this.providerName}] Error setting user context:`, err);
+        }
+    }
+    /**
+     * Set global custom attributes
+     *
+     * Template method that checks if provider is ready then delegates
+     * to concrete provider implementation.
+     *
+     * @param attributes Attributes to set globally
+     */
+    setGlobalAttributes(attributes) {
+        // Guard: check if provider is ready
+        if (!this.guardedOperation("setGlobalAttributes", attributes)) {
+            return;
+        }
+        // Delegate to concrete provider
+        try {
+            this.doSetGlobalAttributes(attributes);
+            if (this.config?.debug) {
+                console.log(`[${this.providerName}] Set global attributes:`, attributes);
+            }
+        }
+        catch (err) {
+            console.error(`[${this.providerName}] Error setting global attributes:`, err);
+        }
+    }
+    // ============================================================================
+    // Protected utility methods (shared logic)
+    // ============================================================================
+    /**
+     * Guard operation - check if provider is ready
+     *
+     * Returns false if provider is not ready, logging a warning in debug mode.
+     *
+     * @param operation Name of the operation for logging
+     * @param args Arguments for logging
+     * @returns true if provider is ready, false otherwise
+     */
+    guardedOperation(operation, ...args) {
+        if (!this.isReady()) {
+            if (this.config?.debug) {
+                console.warn(`[${this.providerName}] Attempted to ${operation} but provider not ready:`, ...args);
+            }
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Apply error filter if configured
+     *
+     * Returns false if error should be filtered out, logging in debug mode.
+     *
+     * @param error The error
+     * @param attributes Error attributes
+     * @returns true if error should be tracked, false if filtered out
+     */
+    applyErrorFilter(error, attributes) {
+        if (this.config?.errorFilter &&
+            !this.config.errorFilter(error, attributes)) {
+            if (this.config?.debug) {
+                console.log(`[${this.providerName}] Error filtered out:`, error, attributes);
+            }
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Apply event filter if configured
+     *
+     * Returns false if event should be filtered out, logging in debug mode.
+     *
+     * @param eventName Event name
+     * @param attributes Event attributes
+     * @returns true if event should be tracked, false if filtered out
+     */
+    applyEventFilter(eventName, attributes) {
+        if (this.config?.eventFilter &&
+            !this.config.eventFilter(eventName, attributes)) {
+            if (this.config?.debug) {
+                console.log(`[${this.providerName}] Event filtered out:`, eventName, attributes);
+            }
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Apply sampling if configured
+     *
+     * Returns false if event should be sampled out, logging in debug mode.
+     *
+     * @param eventName Event name for logging
+     * @returns true if event should be tracked, false if sampled out
+     */
+    applySampling(eventName) {
+        if (this.config?.sampleRate !== undefined && this.config.sampleRate < 1.0) {
+            if (Math.random() > this.config.sampleRate) {
+                if (this.config?.debug) {
+                    console.log(`[${this.providerName}] Event sampled out:`, eventName);
+                }
+                return false;
+            }
+        }
+        return true;
+    }
+    /**
+     * Transform attributes if transformer is configured
+     *
+     * @param attributes Original attributes
+     * @returns Transformed attributes or original if no transformer
+     */
+    transformAttributes(attributes) {
+        if (this.config?.attributeTransformer) {
+            return this.config.attributeTransformer(attributes);
+        }
+        return attributes;
+    }
+}
+//# sourceMappingURL=BaseInstrumentationProvider.js.map

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

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