@od-oneapp/analytics 2026.1.1301

package/dist/client-CeOLjbac.mjs

@@ -0,0 +1,281 @@
+//#region src/providers/posthog/client.ts
+const logDebug = (_message, _context) => {};
+const logError = (_message, _error, _context) => {};
+const logWarn = (_message, _context) => {};
+var PostHogClientProvider = class {
+	name = "posthog";
+	config;
+	isInitialized = false;
+	posthogInstance = null;
+	retryQueue = [];
+	isOnline = true;
+	debugMode = false;
+	constructor(config) {
+		if (!config.apiKey) throw new Error("PostHog apiKey is required");
+		this.config = {
+			apiKey: config.apiKey,
+			options: config.options
+		};
+		this.debugMode = config.options?.debug === true || typeof window !== "undefined" && window.location.search.includes("debug=posthog");
+		if (typeof window !== "undefined") {
+			window.addEventListener("online", () => {
+				this.isOnline = true;
+				this.flushRetryQueue();
+			});
+			window.addEventListener("offline", () => {
+				this.isOnline = false;
+			});
+		}
+	}
+	async initialize() {
+		if (this.isInitialized) return;
+		try {
+			const { default: posthog } = await import("posthog-js");
+			const bootstrap = this.config.options?.bootstrap;
+			const initOptions = {
+				api_host: "https://app.posthog.com",
+				capture_pageleave: true,
+				capture_pageview: false,
+				ui_host: "https://app.posthog.com",
+				opt_in_site_apps: false,
+				person_profiles: "identified_only",
+				respect_dnt: true,
+				uuid_version: "v7",
+				batch_flush_interval_ms: 1e4,
+				request_batching: true,
+				session_recording: {
+					maskAllInputs: false,
+					maskInputOptions: {
+						email: false,
+						number: false,
+						password: true,
+						text: false
+					},
+					recordCanvas: false,
+					recordCrossOriginIframes: false,
+					sampling: {
+						minimumDurationMs: 1e3,
+						sampleRate: 1
+					}
+				},
+				debug: this.debugMode,
+				...this.config.options,
+				...bootstrap && { bootstrap: { distinctID: bootstrap.distinctID } }
+			};
+			posthog.init(this.config.apiKey, initOptions);
+			this.posthogInstance = posthog;
+			window.posthog = posthog;
+			this.isInitialized = true;
+		} catch {
+			throw new Error("PostHog JS SDK not available. Install with: npm install posthog-js");
+		}
+	}
+	async track(event, properties = {}) {
+		if (!this.isInitialized || !this.posthogInstance) {
+			await this.queueEvent("track", [event, properties]);
+			return;
+		}
+		try {
+			await this.log("Tracking event:", event, properties);
+			if (this.debugMode) await this.validateEventProperties(event, properties);
+			this.posthogInstance.capture(event, properties);
+		} catch (error) {
+			if (!this.isOnline) await this.queueEvent("track", [event, properties]);
+			await this.reportError(error, "track", {
+				event,
+				properties
+			});
+		}
+	}
+	async identify(userId, traits = {}) {
+		if (!this.isInitialized || !this.posthogInstance) return;
+		try {
+			this.posthogInstance.identify(userId, traits);
+		} catch {}
+	}
+	async page(name, properties = {}) {
+		if (!this.isInitialized || !this.posthogInstance) return;
+		try {
+			this.posthogInstance.capture("$pageview", {
+				$current_url: window.location.href,
+				$title: name ?? document.title,
+				...properties
+			});
+		} catch {}
+	}
+	async group(groupId, traits = {}) {
+		if (!this.isInitialized || !this.posthogInstance) return;
+		try {
+			this.posthogInstance.group("company", groupId, traits);
+		} catch {}
+	}
+	async alias(userId, _previousId) {
+		if (!this.isInitialized || !this.posthogInstance) return;
+		try {
+			this.posthogInstance.alias(userId);
+		} catch {}
+	}
+	async getAllFlags(userId) {
+		if (!this.isInitialized || !this.posthogInstance) return {};
+		try {
+			if (userId) await this.identify(userId);
+			return this.posthogInstance.getAllFlags() ?? {};
+		} catch {
+			return {};
+		}
+	}
+	async getFeatureFlag(flag, userId) {
+		if (!this.isInitialized || !this.posthogInstance) return false;
+		try {
+			if (userId) await this.identify(userId);
+			return this.posthogInstance.getFeatureFlag(flag);
+		} catch {
+			return false;
+		}
+	}
+	async isFeatureEnabled(flag, userId) {
+		if (!this.isInitialized || !this.posthogInstance) return false;
+		try {
+			if (userId) await this.identify(userId);
+			return this.posthogInstance.isFeatureEnabled(flag) ?? false;
+		} catch {
+			return false;
+		}
+	}
+	async getFeatureFlagPayload(flag, userId) {
+		if (!this.isInitialized || !this.posthogInstance) return null;
+		try {
+			if (userId) await this.identify(userId);
+			return this.posthogInstance.getFeatureFlagPayload(flag) ?? null;
+		} catch {
+			return null;
+		}
+	}
+	async getActiveExperiments(userId) {
+		if (!this.isInitialized || !this.posthogInstance) return [];
+		try {
+			if (userId) await this.identify(userId);
+			return (this.posthogInstance.getActiveMatchingFeatureFlags() ?? []).map((flag) => ({
+				key: flag,
+				payload: this.posthogInstance.getFeatureFlagPayload(flag),
+				variant: this.posthogInstance.getFeatureFlag(flag)
+			}));
+		} catch {
+			return [];
+		}
+	}
+	async getBootstrapData(distinctId) {
+		if (!this.isInitialized || !this.posthogInstance) return { distinctID: distinctId };
+		try {
+			await this.getAllFlags();
+			return { distinctID: distinctId };
+		} catch {
+			return { distinctID: distinctId };
+		}
+	}
+	reset() {
+		if (!this.isInitialized || !this.posthogInstance) return;
+		try {
+			this.posthogInstance.reset();
+		} catch {}
+	}
+	async shutdown() {
+		if (!this.isInitialized || !this.posthogInstance) return;
+		try {
+			if (this.posthogInstance.shutdown) await this.posthogInstance.shutdown();
+		} catch {}
+	}
+	getDistinctId() {
+		if (!this.isInitialized || !this.posthogInstance) return null;
+		try {
+			return this.posthogInstance.get_distinct_id();
+		} catch {
+			return null;
+		}
+	}
+	async queueEvent(method, args) {
+		this.retryQueue.push({
+			args,
+			method
+		});
+		await this.log(`Queued ${method} event for retry: `, args);
+	}
+	async flushRetryQueue() {
+		await this.log(`Flushing retry queue with ${this.retryQueue.length} events`);
+		while (this.retryQueue.length > 0) {
+			const item = this.retryQueue.shift();
+			if (!item) break;
+			const { args, method } = item;
+			try {
+				await this[method](...args);
+			} catch {
+				if (this.retryQueue.length < 100) await this.queueEvent(method, args);
+				break;
+			}
+		}
+	}
+	log(...args) {
+		if (this.debugMode) logDebug("PostHog Debug:", { args });
+	}
+	async validateEventProperties(event, properties) {
+		const reserved = new Set([
+			"$set",
+			"$set_once",
+			"$unset",
+			"distinct_id",
+			"$groups"
+		]);
+		const conflicts = Object.keys(properties).filter((key) => reserved.has(key) && !key.startsWith("$"));
+		if (conflicts.length > 0) logWarn("PostHog: Properties may conflict with reserved names:", {
+			conflicts: conflicts.join(", "),
+			event
+		});
+		try {
+			JSON.stringify(properties);
+		} catch (error) {
+			logWarn("PostHog: Event properties contain circular references:", {
+				event,
+				error: error instanceof Error ? error.message : String(error)
+			});
+		}
+	}
+	async reportError(error, method, context) {
+		if (this.debugMode) logError("PostHog Error:", error instanceof Error ? error : new Error(String(error)), {
+			method,
+			context
+		});
+	}
+	async optIn() {
+		if (this.posthogInstance) {
+			this.posthogInstance.opt_in_capturing();
+			await this.log("User opted in to tracking");
+		}
+	}
+	async optOut() {
+		if (this.posthogInstance) {
+			this.posthogInstance.opt_out_capturing();
+			await this.log("User opted out of tracking");
+		}
+	}
+	hasOptedOut() {
+		return this.posthogInstance ? this.posthogInstance.has_opted_out_capturing() : false;
+	}
+	async groupIdentify(groupType, groupKey, groupProperties, options) {
+		if (!this.isInitialized || !this.posthogInstance) return;
+		try {
+			await this.log("Group identify:", groupType, groupKey, groupProperties);
+			this.posthogInstance.group(groupType, groupKey, groupProperties);
+			if (options?.setAsDefault) this.posthogInstance.register({ [`$groups`]: { [groupType]: groupKey } });
+		} catch (error) {
+			await this.reportError(error, "groupIdentify", {
+				groupKey,
+				groupProperties,
+				groupType
+			});
+		}
+	}
+};
+
+//#endregion
+export { PostHogClientProvider };
+//# sourceMappingURL=client-CeOLjbac.mjs.map

package/dist/client-CeOLjbac.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-CeOLjbac.mjs","names":[],"sources":["../src/providers/posthog/client.ts"],"sourcesContent":["/**\n * @fileoverview PostHog client-side (browser) provider implementation\n *\n * Provides client-side integration with PostHog Analytics including feature flags support.\n * Supports full PostHog tracking including capture, identify, reset, group, alias, and feature flags.\n *\n * @remarks\n * This provider:\n * - Uses PostHog JavaScript SDK for browser tracking\n * - Supports bootstrap data for SSR optimization\n * - Handles feature flags and experiments\n * - Integrates with PostHog's analytics dashboard\n *\n * @module @repo/analytics/providers/posthog/client\n */\n\n// Simple console fallbacks - observability integration can be added later\nimport type {\n  BootstrapData,\n  EnhancedPostHogProvider,\n  ExperimentInfo,\n  PostHogConfig,\n} from './types';\nimport type { AnalyticsProvider, ProviderConfig } from '../../shared/types/types';\nconst logDebug = (_message: string, _context?: any) => {\n  // No-op to avoid console warnings in production\n  // TODO: Add proper debug logging via observability package\n};\nconst logError = (_message: string, _error?: Error, _context?: any) => {\n  // No-op to avoid console warnings in production\n  // TODO: Add proper error logging via observability package\n};\nconst logWarn = (_message: string, _context?: any) => {\n  // No-op to avoid console warnings in production\n  // TODO: Add proper error logging via observability package\n};\n\ndeclare global {\n  interface Window {\n    posthog?: {\n      init: (apiKey: string, options?: any) => void;\n      capture: (event: string, properties?: any) => void;\n      identify: (userId: string, properties?: any) => void;\n      reset: () => void;\n      group: (groupType: string, groupKey: string, properties?: any) => void;\n      alias: (alias: string) => void;\n      people?: {\n        set: (properties: any) => void;\n        set_once: (properties: any) => void;\n      };\n      register: (properties: any) => void;\n\n      // Feature flag methods\n      isFeatureEnabled: (flag: string) => boolean;\n      getFeatureFlag: (flag: string) => any;\n      getFeatureFlagPayload: (flag: string) => any;\n      getAllFlags: () => Record<string, any>;\n      onFeatureFlags: (callback: (flags: string[], variants: Record<string, any>) => void) => void;\n\n      // Experiment methods\n      getActiveMatchingFeatureFlags: () => string[];\n\n      // Utility methods\n      get_distinct_id: () => string;\n      shutdown: () => Promise<void>;\n    };\n  }\n}\n\nexport class PostHogClientProvider implements AnalyticsProvider, Partial<EnhancedPostHogProvider> {\n  readonly name = 'posthog';\n  private config: PostHogConfig;\n  private isInitialized = false;\n  private posthogInstance: any = null;\n  private retryQueue: { method: string; args: any[] }[] = [];\n  private isOnline = true;\n  private debugMode = false;\n\n  constructor(config: ProviderConfig) {\n    if (!config.apiKey) {\n      throw new Error('PostHog apiKey is required');\n    }\n\n    this.config = {\n      apiKey: config.apiKey,\n      options: config.options,\n    };\n\n    // Set up debug mode\n    this.debugMode =\n      config.options?.debug === true ||\n      (typeof window !== 'undefined' && window.location.search.includes('debug=posthog'));\n\n    // Monitor network status for retry queue\n    if (typeof window !== 'undefined') {\n      window.addEventListener('online', () => {\n        this.isOnline = true;\n        void this.flushRetryQueue();\n      });\n\n      window.addEventListener('offline', () => {\n        this.isOnline = false;\n      });\n    }\n  }\n\n  async initialize(): Promise<void> {\n    if (this.isInitialized) return;\n\n    try {\n      // Dynamically import PostHog (optional dependency)\n      const { default: posthog } = await import('posthog-js');\n\n      // Extract bootstrap data if provided\n      const bootstrap = this.config.options?.bootstrap;\n\n      // Initialize PostHog with enhanced options and all missing configurations\n      const initOptions: any = {\n        // Core PostHog configuration with PostHog recommended defaults\n        api_host: 'https://app.posthog.com',\n        capture_pageleave: true, // Important for engagement tracking\n        capture_pageview: false, // We handle pageviews manually\n        ui_host: 'https://app.posthog.com',\n\n        opt_in_site_apps: false, // Conservative default\n        // Privacy & GDPR compliance\n        person_profiles: 'identified_only', // GDPR-friendly default\n        respect_dnt: true, // Respect Do Not Track headers\n\n        // Performance optimizations\n        uuid_version: 'v7', // Better performance than v4\n        batch_flush_interval_ms: 10000, // 10 second batching\n        request_batching: true, // Batch requests for better performance\n\n        // Session recording with safe defaults\n        session_recording: {\n          maskAllInputs: false,\n          maskInputOptions: {\n            email: false,\n            number: false,\n            password: true, // Always mask passwords\n            text: false,\n          },\n          recordCanvas: false, // Performance consideration\n          recordCrossOriginIframes: false, // Conservative default\n          sampling: {\n            minimumDurationMs: 1000, // Only record sessions > 1s\n            sampleRate: 1, // Record all sessions by default\n          },\n        },\n\n        // Debug mode\n        debug: this.debugMode,\n\n        // Apply user configuration (this will override defaults)\n        ...this.config.options,\n\n        // Add bootstrap data if available (must be last to not be overridden)\n        ...(bootstrap && {\n          bootstrap: {\n            distinctID: bootstrap.distinctID,\n          },\n        }),\n      };\n\n      posthog.init(this.config.apiKey, initOptions);\n\n      // Store instance references\n      this.posthogInstance = posthog;\n      window.posthog = posthog as any;\n\n      this.isInitialized = true;\n    } catch {\n      throw new Error('PostHog JS SDK not available. Install with: npm install posthog-js');\n    }\n  }\n\n  async track(event: string, properties: any = {}): Promise<void> {\n    if (!this.isInitialized || !this.posthogInstance) {\n      await this.queueEvent('track', [event, properties]);\n      return;\n    }\n\n    try {\n      // Debug logging\n      await this.log('Tracking event:', event, properties);\n\n      // Validate properties in debug mode\n      if (this.debugMode) {\n        await this.validateEventProperties(event, properties);\n      }\n\n      this.posthogInstance.capture(event, properties);\n    } catch (error) {\n      // Queue event if offline\n      if (!this.isOnline) {\n        await this.queueEvent('track', [event, properties]);\n      }\n\n      // Enhanced error reporting\n      await this.reportError(error, 'track', { event, properties });\n    }\n  }\n\n  async identify(userId: string, traits: any = {}): Promise<void> {\n    if (!this.isInitialized || !this.posthogInstance) {\n      return;\n    }\n\n    try {\n      this.posthogInstance.identify(userId, traits);\n    } catch {\n      // Silently fail to avoid disrupting app flow\n    }\n  }\n\n  async page(name?: string, properties: any = {}): Promise<void> {\n    if (!this.isInitialized || !this.posthogInstance) {\n      return;\n    }\n\n    try {\n      this.posthogInstance.capture('$pageview', {\n        $current_url: window.location.href,\n        $title: name ?? document.title,\n        ...properties,\n      });\n    } catch {\n      // Silently fail to avoid disrupting app flow\n    }\n  }\n\n  async group(groupId: string, traits: any = {}): Promise<void> {\n    if (!this.isInitialized || !this.posthogInstance) {\n      return;\n    }\n\n    try {\n      this.posthogInstance.group('company', groupId, traits);\n    } catch {\n      // Silently fail to avoid disrupting app flow\n    }\n  }\n\n  async alias(userId: string, _previousId: string): Promise<void> {\n    if (!this.isInitialized || !this.posthogInstance) {\n      return;\n    }\n\n    try {\n      this.posthogInstance.alias(userId);\n    } catch {\n      // Silently fail to avoid disrupting app flow\n    }\n  }\n\n  // Feature Flag Methods\n  async getAllFlags(userId?: string): Promise<Record<string, any>> {\n    if (!this.isInitialized || !this.posthogInstance) {\n      return {};\n    }\n\n    try {\n      if (userId) {\n        // If userId provided, identify first to ensure flags are for correct user\n        await this.identify(userId);\n      }\n\n      return this.posthogInstance.getAllFlags() ?? {};\n    } catch {\n      return {};\n    }\n  }\n\n  async getFeatureFlag(flag: string, userId?: string): Promise<any> {\n    if (!this.isInitialized || !this.posthogInstance) {\n      return false;\n    }\n\n    try {\n      if (userId) {\n        await this.identify(userId);\n      }\n\n      return this.posthogInstance.getFeatureFlag(flag);\n    } catch {\n      return false;\n    }\n  }\n\n  async isFeatureEnabled(flag: string, userId?: string): Promise<boolean> {\n    if (!this.isInitialized || !this.posthogInstance) {\n      return false;\n    }\n\n    try {\n      if (userId) {\n        await this.identify(userId);\n      }\n\n      return this.posthogInstance.isFeatureEnabled(flag) ?? false;\n    } catch {\n      return false;\n    }\n  }\n\n  async getFeatureFlagPayload(flag: string, userId?: string): Promise<any | null> {\n    if (!this.isInitialized || !this.posthogInstance) {\n      return null;\n    }\n\n    try {\n      if (userId) {\n        await this.identify(userId);\n      }\n\n      return this.posthogInstance.getFeatureFlagPayload(flag) ?? null;\n    } catch {\n      return null;\n    }\n  }\n\n  async getActiveExperiments(userId?: string): Promise<ExperimentInfo[]> {\n    if (!this.isInitialized || !this.posthogInstance) {\n      return [];\n    }\n\n    try {\n      if (userId) {\n        await this.identify(userId);\n      }\n\n      const activeFlags = this.posthogInstance.getActiveMatchingFeatureFlags() ?? [];\n      return activeFlags.map((flag: string) => ({\n        key: flag,\n        payload: this.posthogInstance.getFeatureFlagPayload(flag),\n        variant: this.posthogInstance.getFeatureFlag(flag),\n      }));\n    } catch {\n      return [];\n    }\n  }\n\n  // Bootstrap method (not typically used on client, but included for completeness)\n  async getBootstrapData(distinctId: string): Promise<BootstrapData> {\n    if (!this.isInitialized || !this.posthogInstance) {\n      return { distinctID: distinctId };\n    }\n\n    try {\n      await this.getAllFlags();\n\n      return {\n        distinctID: distinctId,\n      };\n    } catch {\n      return { distinctID: distinctId };\n    }\n  }\n\n  // Utility Methods\n  reset(): void {\n    if (!this.isInitialized || !this.posthogInstance) {\n      return;\n    }\n\n    try {\n      this.posthogInstance.reset();\n    } catch {\n      // Silently fail\n    }\n  }\n\n  async shutdown(): Promise<void> {\n    if (!this.isInitialized || !this.posthogInstance) {\n      return;\n    }\n\n    try {\n      if (this.posthogInstance.shutdown) {\n        await this.posthogInstance.shutdown();\n      }\n    } catch {\n      // Silently fail\n    }\n  }\n\n  // Get distinct ID for bootstrap purposes\n  getDistinctId(): string | null {\n    if (!this.isInitialized || !this.posthogInstance) {\n      return null;\n    }\n\n    try {\n      return this.posthogInstance.get_distinct_id();\n    } catch {\n      return null;\n    }\n  }\n\n  // Enhanced error handling and utility methods\n  private async queueEvent(method: string, args: any[]) {\n    this.retryQueue.push({ args, method });\n    await this.log(`Queued ${method} event for retry: `, args);\n  }\n\n  private async flushRetryQueue() {\n    await this.log(`Flushing retry queue with ${this.retryQueue.length} events`);\n\n    while (this.retryQueue.length > 0) {\n      const item = this.retryQueue.shift();\n      if (!item) break;\n      const { args, method } = item;\n      try {\n        await (this as any)[method](...args);\n      } catch {\n        // Re-queue failed events (limit retries)\n        if (this.retryQueue.length < 100) {\n          // Prevent infinite queue growth\n          await this.queueEvent(method, args);\n        }\n        break;\n      }\n    }\n  }\n\n  private log(...args: any[]) {\n    if (this.debugMode) {\n      logDebug('PostHog Debug:', { args });\n    }\n  }\n\n  private async validateEventProperties(event: string, properties: any) {\n    // Check for reserved property names\n    const reserved = new Set(['$set', '$set_once', '$unset', 'distinct_id', '$groups']);\n    const conflicts = Object.keys(properties).filter(\n      key => reserved.has(key) && !key.startsWith('$'),\n    );\n\n    if (conflicts.length > 0) {\n      logWarn('PostHog: Properties may conflict with reserved names:', {\n        conflicts: conflicts.join(', '),\n        event,\n      });\n    }\n\n    // Check for circular references\n    try {\n      JSON.stringify(properties);\n    } catch (error) {\n      logWarn('PostHog: Event properties contain circular references:', {\n        event,\n        error: error instanceof Error ? error.message : String(error),\n      });\n    }\n  }\n\n  private async reportError(error: any, method: string, context: any) {\n    if (this.debugMode) {\n      logError('PostHog Error:', error instanceof Error ? error : new Error(String(error)), {\n        method,\n        context,\n      });\n    }\n\n    // Could emit error event to other analytics providers\n    // this.emit('analytics_error', { provider: 'posthog', method, error: error.message, context });\n  }\n\n  // Consent management methods\n  async optIn(): Promise<void> {\n    if (this.posthogInstance) {\n      this.posthogInstance.opt_in_capturing();\n      await this.log('User opted in to tracking');\n    }\n  }\n\n  async optOut(): Promise<void> {\n    if (this.posthogInstance) {\n      this.posthogInstance.opt_out_capturing();\n      await this.log('User opted out of tracking');\n    }\n  }\n\n  hasOptedOut(): boolean {\n    return this.posthogInstance ? this.posthogInstance.has_opted_out_capturing() : false;\n  }\n\n  // Enhanced group analytics\n  async groupIdentify(\n    groupType: string,\n    groupKey: string,\n    groupProperties: any,\n    options?: { setAsDefault?: boolean },\n  ): Promise<void> {\n    if (!this.isInitialized || !this.posthogInstance) {\n      return;\n    }\n\n    try {\n      await this.log('Group identify:', groupType, groupKey, groupProperties);\n\n      // Set group properties\n      this.posthogInstance.group(groupType, groupKey, groupProperties);\n\n      // Optionally set as default group for user\n      if (options?.setAsDefault) {\n        this.posthogInstance.register({\n          [`$groups`]: {\n            [groupType]: groupKey,\n          },\n        });\n      }\n    } catch (error) {\n      await this.reportError(error, 'groupIdentify', { groupKey, groupProperties, groupType });\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/client-D339NFJS.mjs

@@ -0,0 +1,267 @@
+//#region src/providers/base-provider.ts
+/**
+* Abstract base class for analytics providers
+*
+* @example
+* ```typescript
+* class MyProvider extends BaseAnalyticsProvider<MyConfig> {
+*   readonly name = 'my-provider';
+*
+*   protected async doInitialize(): Promise<void> {
+*     // Load SDK and set up client
+*   }
+*
+*   protected async doTrack(event: string, properties: Properties): Promise<void> {
+*     // Call SDK track method
+*   }
+*
+*   // ... implement other abstract methods
+* }
+* ```
+*/
+var BaseAnalyticsProvider = class {
+	/** Provider-specific configuration */
+	config;
+	/** Whether the provider has been initialized */
+	isInitialized = false;
+	/** Error handler for logging/reporting errors */
+	onError;
+	constructor(config, defaultConfig = {}) {
+		this.config = {
+			...defaultConfig,
+			...config,
+			...config.options
+		};
+		this.onError = this.config.onError ?? void 0;
+	}
+	/**
+	* Initialize the provider.
+	*
+	* This is called by the analytics manager before any tracking calls.
+	* Calls the abstract `doInitialize()` method and handles errors.
+	*
+	* @param {ProviderConfig} [config] - Optional provider configuration
+	* @returns {Promise<void>} Promise that resolves when initialization is complete
+	* @throws {Error} If initialization fails
+	*/
+	async initialize(config) {
+		if (this.isInitialized) return;
+		try {
+			await this.doInitialize(config);
+			this.isInitialized = true;
+		} catch (error) {
+			this.handleError(error, "initialize");
+			throw error;
+		}
+	}
+	/**
+	* Track an event.
+	*
+	* Validates that the provider is initialized, then calls the abstract
+	* `doTrack()` method. Handles errors gracefully without throwing.
+	*
+	* @param {string} event - Event name
+	* @param {Properties} [properties] - Event properties
+	* @param {AnalyticsContext} [context] - Analytics context
+	* @returns {Promise<void>} Promise that resolves when tracking is complete
+	*/
+	async track(event, properties = {}, context) {
+		if (!this.isInitialized) {
+			this.handleError(/* @__PURE__ */ new Error("Provider not initialized"), "track", { event });
+			return;
+		}
+		try {
+			await this.doTrack(event, properties, context);
+		} catch (error) {
+			this.handleError(error, "track", {
+				event,
+				properties
+			});
+		}
+	}
+	/**
+	* Identify a user.
+	*
+	* Validates that the provider is initialized, then calls the abstract
+	* `doIdentify()` method. Handles errors gracefully without throwing.
+	*
+	* @param {string} userId - User identifier
+	* @param {UserTraits} [traits] - User traits
+	* @param {AnalyticsContext} [context] - Analytics context
+	* @returns {Promise<void>} Promise that resolves when identification is complete
+	*/
+	async identify(userId, traits = {}, context) {
+		if (!this.isInitialized) {
+			this.handleError(/* @__PURE__ */ new Error("Provider not initialized"), "identify", { userId });
+			return;
+		}
+		try {
+			await this.doIdentify(userId, traits, context);
+		} catch (error) {
+			this.handleError(error, "identify", { userId });
+		}
+	}
+	/**
+	* Track a page view.
+	*
+	* Validates that the provider is initialized, then calls the abstract
+	* `doPage()` method. Handles errors gracefully.
+	*
+	* @param {string} [name] - Page name
+	* @param {PageProperties} [properties] - Page properties
+	* @param {AnalyticsContext} [context] - Analytics context
+	* @returns {Promise<void>} Promise that resolves when page tracking is complete
+	*/
+	async page(name, properties = {}, context) {
+		if (!this.isInitialized) {
+			this.handleError(/* @__PURE__ */ new Error("Provider not initialized"), "page", { name });
+			return;
+		}
+		try {
+			await this.doPage(name, properties, context);
+		} catch (error) {
+			this.handleError(error, "page", { name });
+		}
+	}
+	/**
+	* Associate user with a group.
+	*
+	* Validates that the provider is initialized, then calls the abstract
+	* `doGroup()` method. Handles errors gracefully.
+	*
+	* @param {string} groupId - Group identifier
+	* @param {GroupTraits} [traits] - Group traits
+	* @param {AnalyticsContext} [context] - Analytics context
+	* @returns {Promise<void>} Promise that resolves when group association is complete
+	*/
+	async group(groupId, traits = {}, context) {
+		if (!this.isInitialized) {
+			this.handleError(/* @__PURE__ */ new Error("Provider not initialized"), "group", { groupId });
+			return;
+		}
+		try {
+			await this.doGroup(groupId, traits, context);
+		} catch (error) {
+			this.handleError(error, "group", { groupId });
+		}
+	}
+	/**
+	* Alias one user ID to another.
+	*
+	* Validates that the provider is initialized, then calls the abstract
+	* `doAlias()` method. Handles errors gracefully.
+	*
+	* @param {string} userId - New user identifier
+	* @param {string} previousId - Previous user identifier
+	* @param {AnalyticsContext} [context] - Analytics context
+	* @returns {Promise<void>} Promise that resolves when aliasing is complete
+	*/
+	async alias(userId, previousId, context) {
+		if (!this.isInitialized) {
+			this.handleError(/* @__PURE__ */ new Error("Provider not initialized"), "alias", {
+				userId,
+				previousId
+			});
+			return;
+		}
+		try {
+			await this.doAlias(userId, previousId, context);
+		} catch (error) {
+			this.handleError(error, "alias", {
+				userId,
+				previousId
+			});
+		}
+	}
+	/**
+	* Handle errors consistently across all methods.
+	*
+	* Calls the error handler callback if configured. Errors are swallowed
+	* in production to not disrupt app flow, but logged via callback.
+	*
+	* @param {unknown} error - The error that occurred
+	* @param {string} method - Method name where error occurred
+	* @param {Record<string, unknown>} [metadata] - Additional error metadata
+	*
+	* @internal
+	*/
+	handleError(error, method, metadata) {
+		if (this.onError) this.onError(error, {
+			provider: this.name,
+			method,
+			...metadata
+		});
+	}
+	/**
+	* Check if provider is ready to accept tracking calls.
+	*
+	* @returns {boolean} `true` if provider is initialized and ready, `false` otherwise
+	*/
+	isReady() {
+		return this.isInitialized;
+	}
+};
+
+//#endregion
+//#region src/providers/segment/client.ts
+/**
+* @fileoverview Segment client-side (browser) provider implementation
+*
+* Provides client-side integration with Segment Analytics using @segment/analytics-next.
+* Supports full Segment.io spec tracking including track, identify, page, group, and alias.
+*
+* @remarks
+* This provider:
+* - Uses @segment/analytics-next for browser tracking
+* - Supports dynamic imports to avoid SSR issues
+* - Handles initialization and event tracking
+* - Integrates with Segment's CDN and API
+*
+* @module @od-oneapp/analytics/providers/segment/client
+*/
+var SegmentClientProvider = class extends BaseAnalyticsProvider {
+	name = "segment";
+	analytics = null;
+	constructor(config) {
+		super(config);
+		if (!config.writeKey) throw new Error("Segment writeKey is required");
+		this.config = {
+			options: config.options,
+			writeKey: config.writeKey
+		};
+	}
+	async doInitialize() {
+		const { AnalyticsBrowser } = await import(
+			/* webpackChunkName: "segment-analytics-browser" */
+			"@segment/analytics-next"
+);
+		this.analytics = AnalyticsBrowser.load({
+			writeKey: this.config.writeKey,
+			...this.config.options
+		});
+	}
+	async doTrack(event, properties, _context) {
+		if (!this.analytics) return;
+		await this.analytics.track(event, properties);
+	}
+	async doIdentify(userId, traits, _context) {
+		if (!this.analytics) return;
+		await this.analytics.identify(userId, traits);
+	}
+	async doPage(name, properties, _context) {
+		if (!this.analytics) return;
+		await this.analytics.page(name, properties);
+	}
+	async doGroup(groupId, traits, _context) {
+		if (!this.analytics) return;
+		await this.analytics.group(groupId, traits);
+	}
+	async doAlias(userId, previousId, _context) {
+		if (!this.analytics) return;
+		await this.analytics.alias(userId, previousId);
+	}
+};
+
+//#endregion
+export { SegmentClientProvider };
+//# sourceMappingURL=client-D339NFJS.mjs.map

package/dist/client-D339NFJS.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-D339NFJS.mjs","names":[],"sources":["../src/providers/base-provider.ts","../src/providers/segment/client.ts"],"sourcesContent":["/**\n * @fileoverview Base Analytics Provider\n *\n * Abstract base class that implements common provider patterns:\n * - Initialization state management\n * - Safe method execution with error handling\n * - Consistent interface implementation\n * - Error handling and logging\n *\n * **Provider Development**: Providers should extend this class and implement\n * the abstract methods (`doInitialize`, `doTrack`, `doIdentify`, etc.).\n *\n * **Benefits**:\n * - Consistent error handling across all providers\n * - Initialization state management\n * - Safe method execution (checks initialization before calling)\n * - Error callbacks for logging/reporting\n *\n * @module @od-oneapp/analytics/providers/base-provider\n */\n\nimport type {\n  AnalyticsContext,\n  AnalyticsProvider,\n  GroupTraits,\n  PageProperties,\n  Properties,\n  ProviderConfig,\n  UserTraits,\n} from '../shared/types/types';\n\n/**\n * Error handler type for provider operations.\n *\n * Called when an error occurs during provider operations. Receives the error\n * and context about which provider and method failed.\n *\n * @param {unknown} error - The error that occurred\n * @param {object} context - Context about the error (provider name, method name, metadata)\n */\nexport type ProviderErrorHandler = (\n  error: unknown,\n  context: {\n    provider: string;\n    method: string;\n    [key: string]: unknown;\n  },\n) => void;\n\n/**\n * Base configuration for all providers.\n *\n * Common configuration options that all providers support.\n */\nexport interface BaseProviderConfig {\n  /** Error handler callback */\n  onError?: ProviderErrorHandler;\n  /** Enable debug mode */\n  debug?: boolean;\n}\n\n/**\n * Abstract base class for analytics providers\n *\n * @example\n * ```typescript\n * class MyProvider extends BaseAnalyticsProvider<MyConfig> {\n *   readonly name = 'my-provider';\n *\n *   protected async doInitialize(): Promise<void> {\n *     // Load SDK and set up client\n *   }\n *\n *   protected async doTrack(event: string, properties: Properties): Promise<void> {\n *     // Call SDK track method\n *   }\n *\n *   // ... implement other abstract methods\n * }\n * ```\n */\nexport abstract class BaseAnalyticsProvider<\n  TConfig extends BaseProviderConfig = BaseProviderConfig,\n> implements AnalyticsProvider {\n  /** Provider name used for identification and logging */\n  abstract readonly name: string;\n\n  /** Provider-specific configuration */\n  protected config: TConfig;\n\n  /** Whether the provider has been initialized */\n  protected isInitialized = false;\n\n  /** Error handler for logging/reporting errors */\n  protected onError?: ProviderErrorHandler | undefined;\n\n  constructor(config: ProviderConfig, defaultConfig: Partial<TConfig> = {}) {\n    this.config = {\n      ...defaultConfig,\n      ...config,\n      ...(config.options as Partial<TConfig>),\n    } as TConfig;\n    this.onError = this.config.onError ?? undefined;\n  }\n\n  /**\n   * Initialize the provider.\n   *\n   * This is called by the analytics manager before any tracking calls.\n   * Calls the abstract `doInitialize()` method and handles errors.\n   *\n   * @param {ProviderConfig} [config] - Optional provider configuration\n   * @returns {Promise<void>} Promise that resolves when initialization is complete\n   * @throws {Error} If initialization fails\n   */\n  async initialize(config?: ProviderConfig): Promise<void> {\n    if (this.isInitialized) return;\n\n    try {\n      await this.doInitialize(config);\n      this.isInitialized = true;\n    } catch (error) {\n      this.handleError(error, 'initialize');\n      throw error; // Re-throw to let manager know initialization failed\n    }\n  }\n\n  /**\n   * Track an event.\n   *\n   * Validates that the provider is initialized, then calls the abstract\n   * `doTrack()` method. Handles errors gracefully without throwing.\n   *\n   * @param {string} event - Event name\n   * @param {Properties} [properties] - Event properties\n   * @param {AnalyticsContext} [context] - Analytics context\n   * @returns {Promise<void>} Promise that resolves when tracking is complete\n   */\n  async track(\n    event: string,\n    properties: Properties = {},\n    context?: AnalyticsContext,\n  ): Promise<void> {\n    if (!this.isInitialized) {\n      this.handleError(new Error('Provider not initialized'), 'track', { event });\n      return;\n    }\n\n    try {\n      await this.doTrack(event, properties, context);\n    } catch (error) {\n      this.handleError(error, 'track', { event, properties });\n    }\n  }\n\n  /**\n   * Identify a user.\n   *\n   * Validates that the provider is initialized, then calls the abstract\n   * `doIdentify()` method. Handles errors gracefully without throwing.\n   *\n   * @param {string} userId - User identifier\n   * @param {UserTraits} [traits] - User traits\n   * @param {AnalyticsContext} [context] - Analytics context\n   * @returns {Promise<void>} Promise that resolves when identification is complete\n   */\n  async identify(\n    userId: string,\n    traits: UserTraits = {},\n    context?: AnalyticsContext,\n  ): Promise<void> {\n    if (!this.isInitialized) {\n      this.handleError(new Error('Provider not initialized'), 'identify', { userId });\n      return;\n    }\n\n    try {\n      await this.doIdentify(userId, traits, context);\n    } catch (error) {\n      this.handleError(error, 'identify', { userId });\n    }\n  }\n\n  /**\n   * Track a page view.\n   *\n   * Validates that the provider is initialized, then calls the abstract\n   * `doPage()` method. Handles errors gracefully.\n   *\n   * @param {string} [name] - Page name\n   * @param {PageProperties} [properties] - Page properties\n   * @param {AnalyticsContext} [context] - Analytics context\n   * @returns {Promise<void>} Promise that resolves when page tracking is complete\n   */\n  async page(\n    name?: string,\n    properties: PageProperties = {},\n    context?: AnalyticsContext,\n  ): Promise<void> {\n    if (!this.isInitialized) {\n      this.handleError(new Error('Provider not initialized'), 'page', { name });\n      return;\n    }\n\n    try {\n      await this.doPage(name, properties, context);\n    } catch (error) {\n      this.handleError(error, 'page', { name });\n    }\n  }\n\n  /**\n   * Associate user with a group.\n   *\n   * Validates that the provider is initialized, then calls the abstract\n   * `doGroup()` method. Handles errors gracefully.\n   *\n   * @param {string} groupId - Group identifier\n   * @param {GroupTraits} [traits] - Group traits\n   * @param {AnalyticsContext} [context] - Analytics context\n   * @returns {Promise<void>} Promise that resolves when group association is complete\n   */\n  async group(\n    groupId: string,\n    traits: GroupTraits = {},\n    context?: AnalyticsContext,\n  ): Promise<void> {\n    if (!this.isInitialized) {\n      this.handleError(new Error('Provider not initialized'), 'group', { groupId });\n      return;\n    }\n\n    try {\n      await this.doGroup(groupId, traits, context);\n    } catch (error) {\n      this.handleError(error, 'group', { groupId });\n    }\n  }\n\n  /**\n   * Alias one user ID to another.\n   *\n   * Validates that the provider is initialized, then calls the abstract\n   * `doAlias()` method. Handles errors gracefully.\n   *\n   * @param {string} userId - New user identifier\n   * @param {string} previousId - Previous user identifier\n   * @param {AnalyticsContext} [context] - Analytics context\n   * @returns {Promise<void>} Promise that resolves when aliasing is complete\n   */\n  async alias(userId: string, previousId: string, context?: AnalyticsContext): Promise<void> {\n    if (!this.isInitialized) {\n      this.handleError(new Error('Provider not initialized'), 'alias', { userId, previousId });\n      return;\n    }\n\n    try {\n      await this.doAlias(userId, previousId, context);\n    } catch (error) {\n      this.handleError(error, 'alias', { userId, previousId });\n    }\n  }\n\n  /**\n   * Set global context for the provider\n   */\n  setContext?(context: AnalyticsContext): void;\n\n  /**\n   * Handle errors consistently across all methods.\n   *\n   * Calls the error handler callback if configured. Errors are swallowed\n   * in production to not disrupt app flow, but logged via callback.\n   *\n   * @param {unknown} error - The error that occurred\n   * @param {string} method - Method name where error occurred\n   * @param {Record<string, unknown>} [metadata] - Additional error metadata\n   *\n   * @internal\n   */\n  protected handleError(error: unknown, method: string, metadata?: Record<string, unknown>): void {\n    if (this.onError) {\n      this.onError(error, {\n        provider: this.name,\n        method,\n        ...metadata,\n      });\n    }\n    // In production, errors are swallowed to not disrupt app flow\n    // Logging happens via onError callback if provided\n  }\n\n  /**\n   * Check if provider is ready to accept tracking calls.\n   *\n   * @returns {boolean} `true` if provider is initialized and ready, `false` otherwise\n   */\n  isReady(): boolean {\n    return this.isInitialized;\n  }\n\n  // ============================================================================\n  // ABSTRACT METHODS - Must be implemented by subclasses\n  // ============================================================================\n\n  /**\n   * Perform provider-specific initialization.\n   *\n   * Called by `initialize()` after checking `isInitialized` flag.\n   * Subclasses must implement this to perform actual provider initialization.\n   *\n   * @param {ProviderConfig} [config] - Optional provider configuration\n   * @returns {Promise<void>} Promise that resolves when initialization is complete\n   *\n   * @protected\n   * @abstract\n   */\n  protected abstract doInitialize(config?: ProviderConfig): Promise<void>;\n\n  /**\n   * Perform provider-specific track call.\n   *\n   * Called by `track()` after validation. Subclasses must implement this\n   * to perform actual event tracking.\n   *\n   * @param {string} event - Event name\n   * @param {Properties} properties - Event properties\n   * @param {AnalyticsContext} [context] - Analytics context\n   * @returns {Promise<void>} Promise that resolves when tracking is complete\n   *\n   * @protected\n   * @abstract\n   */\n  protected abstract doTrack(\n    event: string,\n    properties: Properties,\n    context?: AnalyticsContext,\n  ): Promise<void>;\n\n  /**\n   * Perform provider-specific identify call.\n   *\n   * Called by `identify()` after validation. Subclasses must implement this\n   * to perform actual user identification.\n   *\n   * @param {string} userId - User identifier\n   * @param {UserTraits} traits - User traits\n   * @param {AnalyticsContext} [context] - Analytics context\n   * @returns {Promise<void>} Promise that resolves when identification is complete\n   *\n   * @protected\n   * @abstract\n   */\n  protected abstract doIdentify(\n    userId: string,\n    traits: UserTraits,\n    context?: AnalyticsContext,\n  ): Promise<void>;\n\n  /**\n   * Perform provider-specific page call.\n   *\n   * Called by `page()` after validation. Subclasses must implement this\n   * to perform actual page view tracking.\n   *\n   * @param {string | undefined} name - Page name\n   * @param {PageProperties} properties - Page properties\n   * @param {AnalyticsContext} [context] - Analytics context\n   * @returns {Promise<void>} Promise that resolves when page tracking is complete\n   *\n   * @protected\n   * @abstract\n   */\n  protected abstract doPage(\n    name: string | undefined,\n    properties: PageProperties,\n    context?: AnalyticsContext,\n  ): Promise<void>;\n\n  /**\n   * Perform provider-specific group call.\n   *\n   * Called by `group()` after validation. Subclasses must implement this\n   * to perform actual group association.\n   *\n   * @param {string} groupId - Group identifier\n   * @param {GroupTraits} traits - Group traits\n   * @param {AnalyticsContext} [context] - Analytics context\n   * @returns {Promise<void>} Promise that resolves when group association is complete\n   *\n   * @protected\n   * @abstract\n   */\n  protected abstract doGroup(\n    groupId: string,\n    traits: GroupTraits,\n    context?: AnalyticsContext,\n  ): Promise<void>;\n\n  /**\n   * Perform provider-specific alias call.\n   *\n   * Called by `alias()` after validation. Subclasses must implement this\n   * to perform actual user ID aliasing.\n   *\n   * @param {string} userId - New user identifier\n   * @param {string} previousId - Previous user identifier\n   * @param {AnalyticsContext} [context] - Analytics context\n   * @returns {Promise<void>} Promise that resolves when aliasing is complete\n   *\n   * @protected\n   * @abstract\n   */\n  protected abstract doAlias(\n    userId: string,\n    previousId: string,\n    context?: AnalyticsContext,\n  ): Promise<void>;\n}\n","/**\n * @fileoverview Segment client-side (browser) provider implementation\n *\n * Provides client-side integration with Segment Analytics using @segment/analytics-next.\n * Supports full Segment.io spec tracking including track, identify, page, group, and alias.\n *\n * @remarks\n * This provider:\n * - Uses @segment/analytics-next for browser tracking\n * - Supports dynamic imports to avoid SSR issues\n * - Handles initialization and event tracking\n * - Integrates with Segment's CDN and API\n *\n * @module @repo/analytics/providers/segment/client\n */\n\nimport { BaseAnalyticsProvider } from '../base-provider';\n\nimport type { SegmentConfig } from './types';\nimport type {\n  AnalyticsContext,\n  GroupTraits,\n  PageProperties,\n  Properties,\n  ProviderConfig,\n  UserTraits,\n} from '../../shared/types/types';\n\n// Type for AnalyticsBrowser instance\ninterface AnalyticsBrowserInstance {\n  track: (event: string, properties?: Properties) => Promise<unknown>;\n  identify: (userId: string, traits?: UserTraits) => Promise<unknown>;\n  page: (name?: string, properties?: PageProperties) => Promise<unknown>;\n  group: (groupId: string, traits?: GroupTraits) => Promise<unknown>;\n  alias: (userId: string, previousId: string) => Promise<unknown>;\n}\n\nexport class SegmentClientProvider extends BaseAnalyticsProvider<SegmentConfig> {\n  readonly name = 'segment';\n  private analytics: AnalyticsBrowserInstance | null = null;\n\n  constructor(config: ProviderConfig) {\n    super(config);\n\n    if (!config.writeKey) {\n      throw new Error('Segment writeKey is required');\n    }\n\n    this.config = {\n      options: config.options as Record<string, unknown>,\n      writeKey: config.writeKey,\n    };\n  }\n\n  protected async doInitialize(): Promise<void> {\n    // Dynamically import Segment Analytics Next\n    const { AnalyticsBrowser } = await import(\n      /* webpackChunkName: \"segment-analytics-browser\" */\n      '@segment/analytics-next'\n    );\n\n    // Initialize Analytics Browser\n    this.analytics = AnalyticsBrowser.load({\n      writeKey: this.config.writeKey,\n      ...this.config.options,\n    }) as unknown as AnalyticsBrowserInstance;\n  }\n\n  protected async doTrack(\n    event: string,\n    properties: Properties,\n    _context?: AnalyticsContext,\n  ): Promise<void> {\n    if (!this.analytics) return;\n    await this.analytics.track(event, properties);\n  }\n\n  protected async doIdentify(\n    userId: string,\n    traits: UserTraits,\n    _context?: AnalyticsContext,\n  ): Promise<void> {\n    if (!this.analytics) return;\n    await this.analytics.identify(userId, traits);\n  }\n\n  protected async doPage(\n    name: string | undefined,\n    properties: PageProperties,\n    _context?: AnalyticsContext,\n  ): Promise<void> {\n    if (!this.analytics) return;\n    await this.analytics.page(name, properties);\n  }\n\n  protected async doGroup(\n    groupId: string,\n    traits: GroupTraits,\n    _context?: AnalyticsContext,\n  ): Promise<void> {\n    if (!this.analytics) return;\n    await this.analytics.group(groupId, traits);\n  }\n\n  protected async doAlias(\n    userId: string,\n    previousId: string,\n    _context?: AnalyticsContext,\n  ): Promise<void> {\n    if (!this.analytics) return;\n    await this.analytics.alias(userId, previousId);\n  }\n}\n"],"mappings":"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"}