@pie-players/pie-players-shared 0.2.0

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

@@ -0,0 +1,86 @@
+/**
+ * New Relic Instrumentation Provider
+ *
+ * Default provider that maintains backwards compatibility with existing
+ * New Relic instrumentation.
+ *
+ * This provider wraps the global `window.newrelic` object provided by
+ * the New Relic Browser Agent.
+ *
+ * @example
+ * ```typescript
+ * const provider = new NewRelicInstrumentationProvider();
+ * await provider.initialize();
+ *
+ * if (provider.isReady()) {
+ *   provider.trackError(new Error('Something went wrong'), {
+ *     component: 'my-component',
+ *     errorType: 'ValidationError'
+ *   });
+ * }
+ * ```
+ */
+import type { InstrumentationConfig } from "../types";
+import { BaseInstrumentationProvider } from "./BaseInstrumentationProvider";
+export declare class NewRelicInstrumentationProvider extends BaseInstrumentationProvider {
+    readonly providerId = "newrelic";
+    readonly providerName = "New Relic";
+    /**
+     * Initialize the New Relic provider
+     *
+     * Checks if the New Relic Browser Agent is available via `window.newrelic`.
+     * If not available, initialization succeeds but `isReady()` will return false.
+     *
+     * @param config Optional configuration
+     */
+    initialize(config?: InstrumentationConfig): Promise<void>;
+    /**
+     * Check if provider is ready
+     *
+     * @returns true if New Relic is available and initialized
+     */
+    isReady(): boolean;
+    /**
+     * Cleanup provider resources
+     *
+     * Marks provider as uninitialized. The global `window.newrelic` object
+     * is not modified.
+     */
+    destroy(): void;
+    /**
+     * Track an error with New Relic
+     *
+     * Calls `newrelic.noticeError(error, attributes)`
+     *
+     * @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/page action with New Relic
+     *
+     * Calls `newrelic.addPageAction(eventName, attributes)`
+     *
+     * @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 `newrelic.setUserId()` and `newrelic.setCustomAttribute()` for user attributes.
+     *
+     * @param userId User identifier
+     * @param attributes Optional user attributes
+     */
+    protected doSetUserContext(userId: string, attributes?: Record<string, any>): void;
+    /**
+     * Set global custom attributes
+     *
+     * Calls `newrelic.setCustomAttribute()` for each attribute.
+     *
+     * @param attributes Attributes to set globally
+     */
+    protected doSetGlobalAttributes(attributes: Record<string, any>): void;
+}
+//# sourceMappingURL=NewRelicInstrumentationProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NewRelicInstrumentationProvider.d.ts","sourceRoot":"","sources":["../../../src/instrumentation/providers/NewRelicInstrumentationProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAE5E,qBAAa,+BAAgC,SAAQ,2BAA2B;IAC/E,QAAQ,CAAC,UAAU,cAAc;IACjC,QAAQ,CAAC,YAAY,eAAe;IAEpC;;;;;;;OAOG;IACG,UAAU,CAAC,MAAM,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB/D;;;;OAIG;IACH,OAAO,IAAI,OAAO;IAQlB;;;;;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;IAK3E;;;;;;;OAOG;IACH,SAAS,CAAC,YAAY,CACrB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC7B,IAAI;IAKP;;;;;;;OAOG;IACH,SAAS,CAAC,gBAAgB,CACzB,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC9B,IAAI;IAgBP;;;;;;OAMG;IACH,SAAS,CAAC,qBAAqB,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;CAStE"}

package/dist/instrumentation/providers/NewRelicInstrumentationProvider.js

@@ -0,0 +1,135 @@
+/**
+ * New Relic Instrumentation Provider
+ *
+ * Default provider that maintains backwards compatibility with existing
+ * New Relic instrumentation.
+ *
+ * This provider wraps the global `window.newrelic` object provided by
+ * the New Relic Browser Agent.
+ *
+ * @example
+ * ```typescript
+ * const provider = new NewRelicInstrumentationProvider();
+ * await provider.initialize();
+ *
+ * if (provider.isReady()) {
+ *   provider.trackError(new Error('Something went wrong'), {
+ *     component: 'my-component',
+ *     errorType: 'ValidationError'
+ *   });
+ * }
+ * ```
+ */
+import { BaseInstrumentationProvider } from "./BaseInstrumentationProvider";
+export class NewRelicInstrumentationProvider extends BaseInstrumentationProvider {
+    providerId = "newrelic";
+    providerName = "New Relic";
+    /**
+     * Initialize the New Relic provider
+     *
+     * Checks if the New Relic Browser Agent is available via `window.newrelic`.
+     * If not available, initialization succeeds but `isReady()` will return false.
+     *
+     * @param config Optional configuration
+     */
+    async initialize(config) {
+        this.config = config;
+        // Check if New Relic is available
+        if (typeof window !== "undefined" && window.newrelic) {
+            this.initialized = true;
+            if (this.config?.debug) {
+                console.log("[NewRelicProvider] Initialized successfully");
+            }
+        }
+        else {
+            if (this.config?.debug) {
+                console.warn("[NewRelicProvider] New Relic not available (window.newrelic not found)");
+            }
+            // Don't throw - allow graceful degradation
+            this.initialized = false;
+        }
+    }
+    /**
+     * Check if provider is ready
+     *
+     * @returns true if New Relic is available and initialized
+     */
+    isReady() {
+        return (this.initialized &&
+            typeof window !== "undefined" &&
+            !!window.newrelic);
+    }
+    /**
+     * Cleanup provider resources
+     *
+     * Marks provider as uninitialized. The global `window.newrelic` object
+     * is not modified.
+     */
+    destroy() {
+        this.initialized = false;
+        if (this.config?.debug) {
+            console.log("[NewRelicProvider] Destroyed");
+        }
+    }
+    /**
+     * Track an error with New Relic
+     *
+     * Calls `newrelic.noticeError(error, attributes)`
+     *
+     * @param error The error to track
+     * @param attributes Transformed attributes (already filtered and transformed by base class)
+     */
+    doTrackError(error, attributes) {
+        const newrelic = window.newrelic;
+        newrelic.noticeError(error, attributes);
+    }
+    /**
+     * Track a custom event/page action with New Relic
+     *
+     * Calls `newrelic.addPageAction(eventName, attributes)`
+     *
+     * @param eventName Name of the event
+     * @param attributes Transformed attributes (already filtered and transformed by base class)
+     */
+    doTrackEvent(eventName, attributes) {
+        const newrelic = window.newrelic;
+        newrelic.addPageAction(eventName, attributes);
+    }
+    /**
+     * Set user context for session tracking
+     *
+     * Calls `newrelic.setUserId()` and `newrelic.setCustomAttribute()` for user attributes.
+     *
+     * @param userId User identifier
+     * @param attributes Optional user attributes
+     */
+    doSetUserContext(userId, attributes) {
+        const newrelic = window.newrelic;
+        // Set user ID if method exists
+        if (newrelic.setUserId) {
+            newrelic.setUserId(userId);
+        }
+        // Set custom attributes for user
+        if (attributes && newrelic.setCustomAttribute) {
+            for (const [key, value] of Object.entries(attributes)) {
+                newrelic.setCustomAttribute(key, value);
+            }
+        }
+    }
+    /**
+     * Set global custom attributes
+     *
+     * Calls `newrelic.setCustomAttribute()` for each attribute.
+     *
+     * @param attributes Attributes to set globally
+     */
+    doSetGlobalAttributes(attributes) {
+        const newrelic = window.newrelic;
+        if (newrelic.setCustomAttribute) {
+            for (const [key, value] of Object.entries(attributes)) {
+                newrelic.setCustomAttribute(key, value);
+            }
+        }
+    }
+}
+//# sourceMappingURL=NewRelicInstrumentationProvider.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NewRelicInstrumentationProvider.js","sourceRoot":"","sources":["../../../src/instrumentation/providers/NewRelicInstrumentationProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAE5E,MAAM,OAAO,+BAAgC,SAAQ,2BAA2B;IACtE,UAAU,GAAG,UAAU,CAAC;IACxB,YAAY,GAAG,WAAW,CAAC;IAEpC;;;;;;;OAOG;IACH,KAAK,CAAC,UAAU,CAAC,MAA8B;QAC9C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QAErB,kCAAkC;QAClC,IAAI,OAAO,MAAM,KAAK,WAAW,IAAK,MAAc,CAAC,QAAQ,EAAE,CAAC;YAC/D,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;YACxB,IAAI,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC;gBACxB,OAAO,CAAC,GAAG,CAAC,6CAA6C,CAAC,CAAC;YAC5D,CAAC;QACF,CAAC;aAAM,CAAC;YACP,IAAI,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC;gBACxB,OAAO,CAAC,IAAI,CACX,wEAAwE,CACxE,CAAC;YACH,CAAC;YACD,2CAA2C;YAC3C,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;QAC1B,CAAC;IACF,CAAC;IAED;;;;OAIG;IACH,OAAO;QACN,OAAO,CACN,IAAI,CAAC,WAAW;YAChB,OAAO,MAAM,KAAK,WAAW;YAC7B,CAAC,CAAE,MAAc,CAAC,QAAQ,CAC1B,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,OAAO;QACN,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;QACzB,IAAI,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC;YACxB,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;QAC7C,CAAC;IACF,CAAC;IAED;;;;;;;OAOG;IACO,YAAY,CAAC,KAAY,EAAE,UAA+B;QACnE,MAAM,QAAQ,GAAI,MAAc,CAAC,QAAQ,CAAC;QAC1C,QAAQ,CAAC,WAAW,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IACzC,CAAC;IAED;;;;;;;OAOG;IACO,YAAY,CACrB,SAAiB,EACjB,UAA+B;QAE/B,MAAM,QAAQ,GAAI,MAAc,CAAC,QAAQ,CAAC;QAC1C,QAAQ,CAAC,aAAa,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IAC/C,CAAC;IAED;;;;;;;OAOG;IACO,gBAAgB,CACzB,MAAc,EACd,UAAgC;QAEhC,MAAM,QAAQ,GAAI,MAAc,CAAC,QAAQ,CAAC;QAE1C,+BAA+B;QAC/B,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;YACxB,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC5B,CAAC;QAED,iCAAiC;QACjC,IAAI,UAAU,IAAI,QAAQ,CAAC,kBAAkB,EAAE,CAAC;YAC/C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;gBACvD,QAAQ,CAAC,kBAAkB,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACzC,CAAC;QACF,CAAC;IACF,CAAC;IAED;;;;;;OAMG;IACO,qBAAqB,CAAC,UAA+B;QAC9D,MAAM,QAAQ,GAAI,MAAc,CAAC,QAAQ,CAAC;QAE1C,IAAI,QAAQ,CAAC,kBAAkB,EAAE,CAAC;YACjC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;gBACvD,QAAQ,CAAC,kBAAkB,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACzC,CAAC;QACF,CAAC;IACF,CAAC;CACD"}

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

@@ -0,0 +1,12 @@
+/**
+ * Instrumentation Providers
+ *
+ * This module exports all available instrumentation providers.
+ */
+export { BaseInstrumentationProvider } from "./BaseInstrumentationProvider";
+export type { ConsoleProviderConfig } from "./ConsoleInstrumentationProvider";
+export { ConsoleInstrumentationProvider } from "./ConsoleInstrumentationProvider";
+export type { DataDogConfig } from "./DataDogInstrumentationProvider";
+export { DataDogInstrumentationProvider } from "./DataDogInstrumentationProvider";
+export { NewRelicInstrumentationProvider } from "./NewRelicInstrumentationProvider";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/instrumentation/providers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAC5E,YAAY,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAE9E,OAAO,EAAE,8BAA8B,EAAE,MAAM,kCAAkC,CAAC;AAClF,YAAY,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,8BAA8B,EAAE,MAAM,kCAAkC,CAAC;AAClF,OAAO,EAAE,+BAA+B,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/instrumentation/providers/index.js

@@ -0,0 +1,12 @@
+/**
+ * Instrumentation Providers
+ *
+ * This module exports all available instrumentation providers.
+ */
+// Base class for creating custom providers
+export { BaseInstrumentationProvider } from "./BaseInstrumentationProvider";
+// Built-in providers
+export { ConsoleInstrumentationProvider } from "./ConsoleInstrumentationProvider";
+export { DataDogInstrumentationProvider } from "./DataDogInstrumentationProvider";
+export { NewRelicInstrumentationProvider } from "./NewRelicInstrumentationProvider";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/instrumentation/providers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,2CAA2C;AAC3C,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAE5E,qBAAqB;AACrB,OAAO,EAAE,8BAA8B,EAAE,MAAM,kCAAkC,CAAC;AAElF,OAAO,EAAE,8BAA8B,EAAE,MAAM,kCAAkC,CAAC;AAClF,OAAO,EAAE,+BAA+B,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/instrumentation/types.d.ts

@@ -0,0 +1,348 @@
+/**
+ * Instrumentation Types
+ *
+ * Core interfaces and types for pluggable instrumentation system.
+ * Abstracts vendor-specific APIs (New Relic, DataDog, Dynatrace, etc.)
+ * to enable clients to use any instrumentation provider.
+ */
+/**
+ * Pluggable instrumentation provider interface
+ *
+ * All instrumentation providers must implement this interface.
+ * Provides methods for tracking errors, events, and metrics.
+ *
+ * @example
+ * ```typescript
+ * class CustomProvider implements InstrumentationProvider {
+ *   readonly providerId = 'custom';
+ *   readonly providerName = 'Custom Analytics';
+ *
+ *   async initialize(config?: InstrumentationConfig): Promise<void> {
+ *     // Initialize your analytics SDK
+ *   }
+ *
+ *   trackError(error: Error, attributes: ErrorAttributes): void {
+ *     // Send error to your analytics backend
+ *   }
+ *
+ *   trackEvent(eventName: string, attributes: EventAttributes): void {
+ *     // Send event to your analytics backend
+ *   }
+ *
+ *   isReady(): boolean {
+ *     return true;
+ *   }
+ *
+ *   destroy(): void {
+ *     // Cleanup
+ *   }
+ * }
+ * ```
+ */
+export interface InstrumentationProvider {
+    /**
+     * Unique identifier for the provider (e.g., 'newrelic', 'datadog', 'console')
+     */
+    readonly providerId: string;
+    /**
+     * Human-readable provider name (e.g., 'New Relic', 'DataDog RUM')
+     */
+    readonly providerName: string;
+    /**
+     * Initialize the provider (load SDKs, configure clients, etc.)
+     *
+     * @param config Optional configuration for the provider
+     */
+    initialize(config?: InstrumentationConfig): Promise<void>;
+    /**
+     * Track an error with contextual attributes
+     *
+     * @param error The error to track
+     * @param attributes Contextual attributes about the error
+     */
+    trackError(error: Error, attributes: ErrorAttributes): void;
+    /**
+     * Track a custom event/page action
+     *
+     * @param eventName Name of the event (e.g., 'pie-resource-load', 'pie-resource-retry')
+     * @param attributes Contextual attributes about the event
+     */
+    trackEvent(eventName: string, attributes: EventAttributes): void;
+    /**
+     * Track a performance metric
+     *
+     * Optional - not all providers support direct metrics.
+     * For providers without metric support, consider tracking as custom events instead.
+     *
+     * @param metricName Name of the metric
+     * @param value Numeric value of the metric
+     * @param attributes Optional attributes about the metric
+     */
+    trackMetric?(metricName: string, value: number, attributes?: MetricAttributes): void;
+    /**
+     * Set user context for session tracking
+     *
+     * Optional - associates user information with subsequent events/errors.
+     *
+     * @param userId User identifier
+     * @param attributes Optional user attributes
+     */
+    setUserContext?(userId: string, attributes?: Record<string, any>): void;
+    /**
+     * Set custom attributes that apply to all subsequent events
+     *
+     * Optional - useful for setting context like environment, version, etc.
+     *
+     * @param attributes Attributes to set globally
+     */
+    setGlobalAttributes?(attributes: Record<string, any>): void;
+    /**
+     * Cleanup provider resources
+     *
+     * Called when the provider is being destroyed or replaced.
+     */
+    destroy(): void;
+    /**
+     * Check if provider is ready to track events
+     *
+     * @returns true if provider is initialized and ready, false otherwise
+     */
+    isReady(): boolean;
+}
+/**
+ * Configuration for instrumentation providers
+ */
+export interface InstrumentationConfig {
+    /**
+     * Enable/disable instrumentation
+     *
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * Enable debug logging
+     *
+     * @default false
+     */
+    debug?: boolean;
+    /**
+     * Sample rate for events (0.0 to 1.0)
+     *
+     * 1.0 = 100% of events tracked
+     * 0.5 = 50% of events tracked
+     * 0.1 = 10% of events tracked
+     *
+     * @default 1.0
+     */
+    sampleRate?: number;
+    /**
+     * Provider-specific settings
+     *
+     * Each provider can define its own configuration structure.
+     *
+     * @example New Relic
+     * ```typescript
+     * providerSettings: {
+     *   // New Relic doesn't need additional config (uses global newrelic object)
+     * }
+     * ```
+     *
+     * @example DataDog
+     * ```typescript
+     * providerSettings: {
+     *   applicationId: 'abc123',
+     *   clientToken: 'pub_xyz',
+     *   site: 'datadoghq.com',
+     *   service: 'pie-players'
+     * }
+     * ```
+     */
+    providerSettings?: Record<string, any>;
+    /**
+     * Filter function for errors
+     *
+     * Return false to skip tracking the error.
+     *
+     * @param error The error being tracked
+     * @param attributes The error attributes
+     * @returns true to track, false to skip
+     */
+    errorFilter?: (error: Error, attributes: ErrorAttributes) => boolean;
+    /**
+     * Filter function for events
+     *
+     * Return false to skip tracking the event.
+     *
+     * @param eventName The event name
+     * @param attributes The event attributes
+     * @returns true to track, false to skip
+     */
+    eventFilter?: (eventName: string, attributes: EventAttributes) => boolean;
+    /**
+     * Transform function for attributes
+     *
+     * Allows modifying or enriching attributes before they're sent to the provider.
+     *
+     * @param attributes The original attributes
+     * @returns The transformed attributes
+     */
+    attributeTransformer?: (attributes: Record<string, any>) => Record<string, any>;
+}
+/**
+ * Common error attributes
+ *
+ * These attributes are sent with error tracking calls.
+ * All providers should support these base attributes.
+ */
+export interface ErrorAttributes {
+    /**
+     * Component that generated the error
+     *
+     * Examples: 'pie-fixed-player', 'pie-resource-monitor', 'pie-esm-player'
+     */
+    component: string;
+    /**
+     * Type/category of error
+     *
+     * Examples: 'InvalidConfig', 'ConfigParseError', 'EsmLoadingError',
+     * 'IifeLoadingError', 'ResourceLoadError'
+     */
+    errorType: string;
+    /**
+     * Single item ID (if error relates to a specific item)
+     */
+    itemId?: string;
+    /**
+     * Multiple item IDs (if error relates to multiple items)
+     */
+    itemIds?: string[];
+    /**
+     * PIE element type (if error relates to a specific element)
+     *
+     * Examples: '@pie-element/inline-choice', '@pie-element/match'
+     */
+    elementType?: string;
+    /**
+     * CDN base URL (for ESM loading errors)
+     */
+    cdnBaseUrl?: string;
+    /**
+     * Bundle host URL (for IIFE loading errors)
+     */
+    bundleHost?: string;
+    /**
+     * Resource URL (for resource loading errors)
+     */
+    resourceUrl?: string;
+    /**
+     * Resource type (for resource loading errors)
+     *
+     * Examples: 'img', 'audio', 'video', 'link', 'source'
+     */
+    resourceType?: string;
+    /**
+     * Duration in milliseconds (for timing-related errors)
+     */
+    duration?: number;
+    /**
+     * Retry count (for retry-related errors)
+     */
+    retryCount?: number;
+    /**
+     * Whether retry was attempted (for resource errors)
+     */
+    wasRetried?: boolean;
+    /**
+     * Extensible for additional context-specific attributes
+     */
+    [key: string]: any;
+}
+/**
+ * Common event attributes
+ *
+ * These attributes are sent with event tracking calls.
+ */
+export interface EventAttributes {
+    /**
+     * Component that generated the event
+     *
+     * Optional - some events may be component-agnostic
+     */
+    component?: string;
+    /**
+     * Timestamp of the event
+     *
+     * ISO 8601 format string
+     */
+    timestamp?: string;
+    /**
+     * Resource URL
+     */
+    url?: string;
+    /**
+     * Load duration in milliseconds
+     */
+    duration?: number;
+    /**
+     * Transfer size in bytes
+     */
+    size?: number;
+    /**
+     * Resource type
+     *
+     * Examples: 'img', 'audio', 'video', 'link', 'script', 'stylesheet'
+     */
+    type?: string;
+    /**
+     * Resource type (alternative name for compatibility)
+     */
+    resourceType?: string;
+    /**
+     * Whether the resource load failed
+     */
+    failed?: boolean;
+    /**
+     * Whether retry was attempted
+     */
+    wasRetried?: boolean;
+    /**
+     * Retry count
+     */
+    retryCount?: number;
+    /**
+     * Retry attempt number
+     */
+    attempt?: number;
+    /**
+     * Delay before retry in milliseconds
+     */
+    delay?: number;
+    /**
+     * Extensible for additional event-specific attributes
+     */
+    [key: string]: any;
+}
+/**
+ * Metric attributes
+ *
+ * These attributes are sent with metric tracking calls.
+ */
+export interface MetricAttributes {
+    /**
+     * Unit of measurement
+     *
+     * Examples: 'ms', 'bytes', 'count', 'percent'
+     */
+    unit?: string;
+    /**
+     * Category of metric
+     *
+     * Examples: 'performance', 'resource', 'error', 'user-action'
+     */
+    category?: string;
+    /**
+     * Extensible for additional metric-specific attributes
+     */
+    [key: string]: any;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/instrumentation/types.js

@@ -0,0 +1,9 @@
+/**
+ * Instrumentation Types
+ *
+ * Core interfaces and types for pluggable instrumentation system.
+ * Abstracts vendor-specific APIs (New Relic, DataDog, Dynatrace, etc.)
+ * to enable clients to use any instrumentation provider.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/instrumentation/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/instrumentation/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}