@stacksee/analytics 0.4.3 → 0.4.5

package/dist/base.provider-AfFL5W_P.js

@@ -0,0 +1,19 @@
+var l = Object.defineProperty;
+var b = (d, e, s) => e in d ? l(d, e, { enumerable: !0, configurable: !0, writable: !0, value: s }) : d[e] = s;
+var a = (d, e, s) => b(d, typeof e != "symbol" ? e + "" : e, s);
+class r {
+  constructor(e) {
+    a(this, "debug", !1);
+    a(this, "enabled", !0);
+    (e == null ? void 0 : e.debug) !== void 0 && (this.debug = e.debug), (e == null ? void 0 : e.enabled) !== void 0 && (this.enabled = e.enabled);
+  }
+  log(e, s) {
+    this.debug && console.log(`[${this.name}] ${e}`, s);
+  }
+  isEnabled() {
+    return this.enabled;
+  }
+}
+export {
+  r as B
+};

package/dist/client-RZPcOfAk.js

@@ -0,0 +1,86 @@
+var h = Object.defineProperty;
+var p = (a, s, e) => s in a ? h(a, s, { enumerable: !0, configurable: !0, writable: !0, value: e }) : a[s] = e;
+var t = (a, s, e) => p(a, typeof s != "symbol" ? s + "" : s, e);
+import { B as d } from "./base.provider-AfFL5W_P.js";
+function o() {
+  return typeof window < "u" && typeof window.document < "u";
+}
+class u extends d {
+  constructor(e) {
+    super({ debug: e.debug, enabled: e.enabled });
+    t(this, "name", "PostHog-Client");
+    t(this, "posthog");
+    t(this, "initialized", !1);
+    t(this, "config");
+    this.config = e;
+  }
+  async initialize() {
+    if (this.isEnabled() && !this.initialized) {
+      if (!o()) {
+        this.log("Skipping initialization - not in browser environment");
+        return;
+      }
+      if (!this.config.token || typeof this.config.token != "string")
+        throw new Error("PostHog requires a token");
+      try {
+        const { default: e } = await import("posthog-js"), { token: i, debug: r, ...g } = this.config;
+        e.init(i, {
+          ...g,
+          debug: r ?? this.debug
+        }), this.posthog = e, this.initialized = !0, this.log("Initialized successfully", this.config);
+      } catch (e) {
+        throw console.error("[PostHog-Client] Failed to initialize:", e), e;
+      }
+    }
+  }
+  identify(e, i) {
+    !this.isEnabled() || !this.initialized || !this.posthog || (this.posthog.identify(e, i), this.log("Identified user", { userId: e, traits: i }));
+  }
+  track(e, i) {
+    if (!this.isEnabled() || !this.initialized || !this.posthog) return;
+    const r = {
+      ...e.properties,
+      category: e.category,
+      timestamp: e.timestamp || Date.now(),
+      ...e.userId && { userId: e.userId },
+      ...e.sessionId && { sessionId: e.sessionId },
+      ...(i == null ? void 0 : i.page) && { $current_url: i.page.path },
+      ...(i == null ? void 0 : i.device) && { device: i.device },
+      ...(i == null ? void 0 : i.utm) && { utm: i.utm }
+    };
+    this.posthog.capture(e.action, r), this.log("Tracked event", { event: e, context: i });
+  }
+  pageView(e, i) {
+    if (!this.isEnabled() || !this.initialized || !this.posthog || !o())
+      return;
+    const r = {
+      ...e,
+      ...(i == null ? void 0 : i.page) && {
+        path: i.page.path,
+        title: i.page.title,
+        referrer: i.page.referrer
+      }
+    };
+    this.posthog.capture("$pageview", r), this.log("Tracked page view", { properties: e, context: i });
+  }
+  pageLeave(e, i) {
+    if (!this.isEnabled() || !this.initialized || !this.posthog || !o())
+      return;
+    const r = {
+      ...e,
+      ...(i == null ? void 0 : i.page) && {
+        path: i.page.path,
+        title: i.page.title,
+        referrer: i.page.referrer
+      }
+    };
+    this.posthog.capture("$pageleave", r), this.log("Tracked page leave", { properties: e, context: i });
+  }
+  reset() {
+    !this.isEnabled() || !this.initialized || !this.posthog || !o() || (this.posthog.reset(), this.log("Reset user session"));
+  }
+}
+export {
+  u as P,
+  o as i
+};

package/dist/client.d.ts

@@ -1,2 +1,68 @@
-export * from './src/client'
-export {}
+import { BrowserAnalytics } from './adapters/client/browser-analytics.js';
+import { AnalyticsProvider } from './core/events/types.js';
+import { EventMapFromCollection } from './core/events/index.js';
+type DefaultEventMap = Record<string, Record<string, unknown>>;
+export interface ClientAnalyticsConfig {
+    providers?: AnalyticsProvider[];
+    debug?: boolean;
+    enabled?: boolean;
+}
+/**
+ * Initialize analytics for the browser
+ *
+ * @example
+ * ```typescript
+ * import { createClientAnalytics } from '@stacksee/analytics/client';
+ * import { PostHogClientProvider } from '@stacksee/analytics/providers/posthog';
+ * import { AppEvents } from './events';
+ *
+ * const analytics = createClientAnalytics<typeof AppEvents>({
+ *   providers: [
+ *     new PostHogClientProvider({
+ *       apiKey: 'your-api-key',
+ *       host: 'https://app.posthog.com'
+ *     })
+ *   ],
+ *   debug: true,
+ *   enabled: true
+ * });
+ *
+ * // Now event names and properties are fully typed!
+ * analytics.track('user_signed_up', {
+ *   userId: 'user-123',
+ *   email: 'user@example.com',
+ *   plan: 'pro'
+ * });
+ * ```
+ */
+export declare function createClientAnalytics<TEvents = never>(config: ClientAnalyticsConfig): BrowserAnalytics<EventMapFromCollection<TEvents>>;
+export { createClientAnalytics as createAnalytics };
+/**
+ * Get the current analytics instance
+ */
+export declare function getAnalytics(): BrowserAnalytics<DefaultEventMap>;
+/**
+ * Convenience function to track events
+ */
+export declare function track(eventName: string, properties: Record<string, unknown>): Promise<void>;
+/**
+ * Convenience function to identify users
+ */
+export declare function identify(userId: string, traits?: Record<string, unknown>): void;
+/**
+ * Convenience function to track page views
+ */
+export declare function pageView(properties?: Record<string, unknown>): void;
+/**
+ * Convenience function to track page leave events
+ */
+export declare function pageLeave(properties?: Record<string, unknown>): void;
+/**
+ * Convenience function to reset user session
+ */
+export declare function reset(): void;
+/**
+ * Reset the analytics instance (for testing purposes)
+ * @internal
+ */
+export declare function resetAnalyticsInstance(): void;