wip

src/utils/analytics/index.ts

@@ -0,0 +1,93 @@
+/**
+ * Analytics Service - Main entry point with DI
+ * Clean constructor-based dependency injection
+ */
+
+import type { AnalyticsAdapter, AnalyticsEvent, AnalyticsConfig } from './interfaces';
+import { PlausibleAdapter } from './plausible-adapter';
+
+export class AnalyticsService {
+  private adapter: AnalyticsAdapter;
+
+  /**
+   * Create analytics service with dependency injection
+   * @param adapter - Analytics adapter implementation
+   */
+  constructor(adapter: AnalyticsAdapter) {
+    this.adapter = adapter;
+  }
+
+  getAdapter(): AnalyticsAdapter {
+    return this.adapter;
+  }
+
+  async track(event: AnalyticsEvent): Promise<void> {
+    return this.adapter.track(event);
+  }
+
+  async page(path: string, props?: Record<string, any>): Promise<void> {
+    if (this.adapter.page) {
+      return this.adapter.page(path, props);
+    }
+    return this.track({ name: 'Pageview', props: { path, ...props } });
+  }
+
+  async identify(userId: string, traits?: Record<string, any>): Promise<void> {
+    if (this.adapter.identify) {
+      return this.adapter.identify(userId, traits);
+    }
+  }
+
+  // Convenience methods
+  async trackEvent(name: string, props?: Record<string, any>): Promise<void> {
+    return this.track({ name, props });
+  }
+
+  async trackOutboundLink(url: string, text: string): Promise<void> {
+    return this.track({
+      name: 'Outbound Link',
+      props: { url, text }
+    });
+  }
+
+  async trackSearch(query: string, path: string): Promise<void> {
+    return this.track({
+      name: 'Search',
+      props: { query, path }
+    });
+  }
+
+  async trackPageLoad(loadTime: number, path: string, userAgent: string): Promise<void> {
+    return this.track({
+      name: 'Page Load',
+      props: { loadTime: Math.round(loadTime), path, userAgent }
+    });
+  }
+}
+
+// Factory function
+export function createPlausibleAnalytics(config: AnalyticsConfig): AnalyticsService {
+  return new AnalyticsService(new PlausibleAdapter(config));
+}
+
+// Default singleton
+let defaultAnalytics: AnalyticsService | null = null;
+
+export function getDefaultAnalytics(): AnalyticsService {
+  if (!defaultAnalytics) {
+    defaultAnalytics = createPlausibleAnalytics({
+      domain: 'mintel.me',
+      scriptUrl: 'https://plausible.yourdomain.com/js/script.js'
+    });
+  }
+  return defaultAnalytics;
+}
+
+// Convenience function
+export async function track(name: string, props?: Record<string, any>): Promise<void> {
+  return getDefaultAnalytics().trackEvent(name, props);
+}
+
+// Re-export for advanced usage
+export type { AnalyticsAdapter, AnalyticsEvent, AnalyticsConfig };
+export { PlausibleAdapter };

src/utils/analytics/interfaces.ts

@@ -0,0 +1,20 @@
+/**
+ * Analytics interfaces - decoupled contracts
+ */
+
+export interface AnalyticsEvent {
+  name: string;
+  props?: Record<string, any>;
+}
+
+export interface AnalyticsAdapter {
+  track(event: AnalyticsEvent): Promise<void>;
+  identify?(userId: string, traits?: Record<string, any>): Promise<void>;
+  page?(path: string, props?: Record<string, any>): Promise<void>;
+  getScriptTag?(): string;
+}
+
+export interface AnalyticsConfig {
+  domain?: string;
+  scriptUrl?: string;
+}

src/utils/analytics/plausible-adapter.ts

@@ -0,0 +1,38 @@
+/**
+ * Plausible Analytics Adapter
+ * Decoupled implementation
+ */
+
+import type { AnalyticsAdapter, AnalyticsEvent, AnalyticsConfig } from './interfaces';
+
+export class PlausibleAdapter implements AnalyticsAdapter {
+  private domain: string;
+  private scriptUrl: string;
+
+  constructor(config: AnalyticsConfig) {
+    this.domain = config.domain || 'mintel.me';
+    this.scriptUrl = config.scriptUrl || 'https://plausible.yourdomain.com/js/script.js';
+  }
+
+  async track(event: AnalyticsEvent): Promise<void> {
+    if (typeof window === 'undefined') return;
+    
+    const w = window as any;
+    if (w.plausible) {
+      w.plausible(event.name, {
+        props: event.props
+      });
+    }
+  }
+
+  async page(path: string, props?: Record<string, any>): Promise<void> {
+    await this.track({
+      name: 'Pageview',
+      props: { path, ...props }
+    });
+  }
+
+  getScriptTag(): string {
+    return `<script defer data-domain="${this.domain}" src="${this.scriptUrl}"></script>`;
+  }
+}