@stacksee/analytics 0.4.3 → 0.4.4

package/dist/providers/client.js

@@ -0,0 +1,84 @@
+var o = Object.defineProperty;
+var p = (a, e, s) => e in a ? o(a, e, { enumerable: !0, configurable: !0, writable: !0, value: s }) : a[e] = s;
+var t = (a, e, s) => p(a, typeof e != "symbol" ? e + "" : e, s);
+import { B as l } from "../base.provider-AfFL5W_P.js";
+import { i as g } from "../environment-Bnc8FqHv.js";
+class f extends l {
+  constructor(s) {
+    super({ debug: s.debug, enabled: s.enabled });
+    t(this, "name", "PostHog-Client");
+    t(this, "posthog");
+    t(this, "initialized", !1);
+    t(this, "config");
+    this.config = s;
+  }
+  async initialize() {
+    if (this.isEnabled() && !this.initialized) {
+      if (!g()) {
+        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: s } = await import("posthog-js"), { token: i, debug: r, ...h } = this.config;
+        s.init(i, {
+          ...h,
+          debug: r ?? this.debug
+        }), this.posthog = s, this.initialized = !0, this.log("Initialized successfully", this.config);
+      } catch (s) {
+        throw console.error("[PostHog-Client] Failed to initialize:", s), s;
+      }
+    }
+  }
+  identify(s, i) {
+    !this.isEnabled() || !this.initialized || !this.posthog || (this.posthog.identify(s, i), this.log("Identified user", { userId: s, traits: i }));
+  }
+  track(s, i) {
+    if (!this.isEnabled() || !this.initialized || !this.posthog) return;
+    const r = {
+      ...s.properties,
+      category: s.category,
+      timestamp: s.timestamp || Date.now(),
+      ...s.userId && { userId: s.userId },
+      ...s.sessionId && { sessionId: s.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(s.action, r), this.log("Tracked event", { event: s, context: i });
+  }
+  pageView(s, i) {
+    if (!this.isEnabled() || !this.initialized || !this.posthog || !g())
+      return;
+    const r = {
+      ...s,
+      ...(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: s, context: i });
+  }
+  pageLeave(s, i) {
+    if (!this.isEnabled() || !this.initialized || !this.posthog || !g())
+      return;
+    const r = {
+      ...s,
+      ...(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: s, context: i });
+  }
+  reset() {
+    !this.isEnabled() || !this.initialized || !this.posthog || !g() || (this.posthog.reset(), this.log("Reset user session"));
+  }
+}
+export {
+  l as BaseAnalyticsProvider,
+  f as PostHogClientProvider
+};

package/dist/providers/server.d.ts

@@ -0,0 +1 @@
+export {}

package/dist/{providers.js → providers/server.js}

@@ -1,8 +1,7 @@
 var l = Object.defineProperty;
 var h = (r, s, i) => s in r ? l(r, s, { enumerable: !0, configurable: !0, writable: !0, value: i }) : r[s] = i;
 var t = (r, s, i) => h(r, typeof s != "symbol" ? s + "" : s, i);
-import { B as n } from "./client-MwIAm9fk.js";
-import { P as m } from "./client-MwIAm9fk.js";
+import { B as n } from "../base.provider-AfFL5W_P.js";
 import { PostHog as p } from "posthog-node";
 class u extends n {
   constructor(i) {
@@ -82,6 +81,5 @@ class u extends n {
 }
 export {
   n as BaseAnalyticsProvider,
-  m as PostHogClientProvider,
   u as PostHogServerProvider
 };

package/dist/server.d.ts

@@ -1,2 +1 @@
-export * from './src/server'
 export {}

package/dist/src/adapters/client/browser-analytics.d.ts

@@ -1,4 +1,4 @@
-import { AnalyticsConfig, EventContext } from '../../core/events/types.js';
+import { AnalyticsConfig, EventContext } from '../../../../src/core/events/types.js';
 type DefaultEventMap = Record<string, Record<string, unknown>>;
 export declare class BrowserAnalytics<TEventMap extends DefaultEventMap = DefaultEventMap> {
     private providers;

package/dist/src/adapters/server/server-analytics.d.ts

@@ -1,4 +1,4 @@
-import { AnalyticsConfig, EventContext } from '../../core/events/types.js';
+import { AnalyticsConfig, EventContext } from '../../../../src/core/events/types.js';
 type DefaultEventMap = Record<string, Record<string, unknown>>;
 export declare class ServerAnalytics<TEventMap extends DefaultEventMap = DefaultEventMap> {
     private providers;

package/dist/src/client/index.d.ts

@@ -1,7 +1,7 @@
-export { createClientAnalytics, createAnalytics, getAnalytics, track, identify, pageView, pageLeave, reset, type ClientAnalyticsConfig, } from '../client.js';
-export { BrowserAnalytics } from '../adapters/client/browser-analytics.js';
-export { PostHogClientProvider } from '../providers/posthog/client.js';
+export { createClientAnalytics, createAnalytics, getAnalytics, track, identify, pageView, pageLeave, reset, type ClientAnalyticsConfig, } from '../../../src/client.js';
+export { BrowserAnalytics } from '../../../src/adapters/client/browser-analytics.js';
+export { PostHogClientProvider } from '../../../src/providers/posthog/client.js';
 export type { PostHogConfig } from 'posthog-js';
-export { BaseAnalyticsProvider } from '../providers/base.provider.js';
-export type { EventCategory, BaseEvent, EventContext, AnalyticsProvider, AnalyticsConfig, } from '../core/events/types.js';
-export type { CreateEventDefinition, ExtractEventNames, ExtractEventPropertiesFromCollection, EventCollection, AnyEventName, AnyEventProperties, } from '../core/events/index.js';
+export { BaseAnalyticsProvider } from '../../../src/providers/base.provider.js';
+export type { EventCategory, BaseEvent, EventContext, AnalyticsProvider, AnalyticsConfig, } from '../../../src/core/events/types.js';
+export type { CreateEventDefinition, ExtractEventNames, ExtractEventPropertiesFromCollection, EventCollection, AnyEventName, AnyEventProperties, } from '../../../src/core/events/index.js';

package/dist/src/client.d.ts

@@ -1,6 +1,6 @@
-import { BrowserAnalytics } from './adapters/client/browser-analytics.js';
-import { AnalyticsProvider } from './core/events/types.js';
-import { EventMapFromCollection } from './core/events/index.js';
+import { BrowserAnalytics } from '../../src/adapters/client/browser-analytics.js';
+import { AnalyticsProvider } from '../../src/core/events/types.js';
+import { EventMapFromCollection } from '../../src/core/events/index.js';
 type DefaultEventMap = Record<string, Record<string, unknown>>;
 export interface ClientAnalyticsConfig {
     providers?: AnalyticsProvider[];

package/dist/src/index.d.ts

@@ -1,5 +1,2 @@
-export type { EventCategory, BaseEvent, EventContext, AnalyticsProvider, AnalyticsConfig, } from './core/events/types.js';
-export type { CreateEventDefinition, ExtractEventNames, ExtractEventPropertiesFromCollection, EventCollection, AnyEventName, AnyEventProperties, EventMapFromCollection, } from './core/events/index.js';
-export { createAnalytics as createClientAnalytics, getAnalytics, track as trackClient, identify as identifyClient, pageView as pageViewClient, pageLeave as pageLeaveClient, reset as resetClient, type ClientAnalyticsConfig, } from './client.js';
-export { BaseAnalyticsProvider, PostHogClientProvider, type PostHogConfig, } from './providers/client.js';
-export { BrowserAnalytics } from './adapters/client/browser-analytics.js';
+export type { EventCategory, BaseEvent, EventContext, AnalyticsProvider, AnalyticsConfig, } from '../../src/core/events/types.js';
+export type { CreateEventDefinition, ExtractEventNames, ExtractEventPropertiesFromCollection, EventCollection, AnyEventName, AnyEventProperties, EventMapFromCollection, } from '../../src/core/events/index.js';

package/dist/src/providers/base.provider.d.ts

@@ -1,4 +1,4 @@
-import { AnalyticsProvider, BaseEvent, EventContext } from '../core/events/types.js';
+import { AnalyticsProvider, BaseEvent, EventContext } from '../../../src/core/events/types.js';
 export declare abstract class BaseAnalyticsProvider implements AnalyticsProvider {
     abstract name: string;
     protected debug: boolean;

package/dist/src/providers/posthog/client.d.ts

@@ -1,5 +1,5 @@
-import { BaseEvent, EventContext } from '../../core/events/types.js';
-import { BaseAnalyticsProvider } from '../base.provider.js';
+import { BaseEvent, EventContext } from '../../../../src/core/events/types.js';
+import { BaseAnalyticsProvider } from '../../../../src/providers/base.provider.js';
 import { PostHogConfig } from 'posthog-js';
 export declare class PostHogClientProvider extends BaseAnalyticsProvider {
     name: string;

package/dist/src/providers/posthog/server.d.ts

@@ -1,5 +1,5 @@
-import { BaseEvent, EventContext } from '../../core/events/types.js';
-import { BaseAnalyticsProvider } from '../base.provider.js';
+import { BaseEvent, EventContext } from '../../../../src/core/events/types.js';
+import { BaseAnalyticsProvider } from '../../../../src/providers/base.provider.js';
 import { PostHogOptions } from 'posthog-node';
 export declare class PostHogServerProvider extends BaseAnalyticsProvider {
     name: string;

package/dist/src/providers/{index.d.ts → server.d.ts}

@@ -1,5 +1,3 @@
 export { BaseAnalyticsProvider } from './base.provider.js';
-export { PostHogClientProvider } from './posthog/client.js';
 export { PostHogServerProvider } from './posthog/server.js';
-export type { PostHogConfig } from 'posthog-js';
 export type { PostHogOptions } from 'posthog-node';

package/dist/src/server/index.d.ts

@@ -1,6 +1,6 @@
-export { createServerAnalytics, ServerAnalytics, type ServerAnalyticsConfig, } from '../server.js';
-export { PostHogServerProvider } from '../providers/posthog/server.js';
+export { createServerAnalytics, ServerAnalytics, type ServerAnalyticsConfig, } from '../../../src/server.js';
+export { PostHogServerProvider } from '../../../src/providers/posthog/server.js';
 export type { PostHogOptions } from 'posthog-node';
-export { BaseAnalyticsProvider } from '../providers/base.provider.js';
-export type { EventCategory, BaseEvent, EventContext, AnalyticsProvider, AnalyticsConfig, } from '../core/events/types.js';
-export type { CreateEventDefinition, ExtractEventNames, ExtractEventPropertiesFromCollection, EventCollection, AnyEventName, AnyEventProperties, } from '../core/events/index.js';
+export { BaseAnalyticsProvider } from '../../../src/providers/base.provider.js';
+export type { EventCategory, BaseEvent, EventContext, AnalyticsProvider, AnalyticsConfig, } from '../../../src/core/events/types.js';
+export type { CreateEventDefinition, ExtractEventNames, ExtractEventPropertiesFromCollection, EventCollection, AnyEventName, AnyEventProperties, } from '../../../src/core/events/index.js';

package/dist/src/server.d.ts

@@ -1,6 +1,6 @@
-import { ServerAnalytics } from './adapters/server/server-analytics.js';
-import { AnalyticsProvider } from './core/events/types.js';
-import { EventMapFromCollection } from './core/events/index.js';
+import { ServerAnalytics } from '../../src/adapters/server/server-analytics.js';
+import { AnalyticsProvider } from '../../src/core/events/types.js';
+import { EventMapFromCollection } from '../../src/core/events/index.js';
 export interface ServerAnalyticsConfig {
     providers?: AnalyticsProvider[];
     debug?: boolean;

package/dist/test/mock-provider.d.ts

@@ -1,5 +1,5 @@
-import { BaseAnalyticsProvider } from '../src/providers/base.provider';
-import { BaseEvent, EventContext } from '../src/core/events/types';
+import { BaseAnalyticsProvider } from '../../src/providers/base.provider';
+import { BaseEvent, EventContext } from '../../src/core/events/types';
 export declare class MockAnalyticsProvider extends BaseAnalyticsProvider {
     name: string;
     private initialized;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stacksee/analytics",
-  "version": "0.4.3",
+  "version": "0.4.4",
   "description": "A highly typed, provider-agnostic analytics library for TypeScript applications",
   "type": "module",
   "exports": {
@@ -16,9 +16,13 @@
       "types": "./dist/server.d.ts",
       "import": "./dist/server.js"
     },
-    "./providers": {
-      "types": "./dist/providers.d.ts",
-      "import": "./dist/providers.js"
+    "./providers/client": {
+      "types": "./dist/providers/client.d.ts",
+      "import": "./dist/providers/client.js"
+    },
+    "./providers/server": {
+      "types": "./dist/providers/server.d.ts",
+      "import": "./dist/providers/server.js"
     }
   },
   "main": "./dist/index.js",

package/readme.md

@@ -97,7 +97,7 @@ Tip: If you have a lot of events, you can also divide your events into multiple
 
 ```typescript
 import { createClientAnalytics } from '@stacksee/analytics/client';
-import { PostHogClientProvider } from '@stacksee/analytics/providers/posthog';
+import { PostHogClientProvider } from '@stacksee/analytics/providers/client';
 import type { AppEvents } from './events';
 
 // Initialize analytics with providers as plugins
@@ -138,7 +138,7 @@ analytics.identify('user-123', {
 
 ```typescript
 import { createServerAnalytics } from '@stacksee/analytics/server';
-import { PostHogServerProvider } from '@stacksee/analytics/providers/posthog';
+import { PostHogServerProvider } from '@stacksee/analytics/providers/server';
 import type { AppEvents } from './events';
 
 // Create analytics instance with providers as plugins
@@ -268,7 +268,7 @@ Here's a complete example using Svelte 5 that demonstrates both client and serve
 ```typescript
 // src/lib/config/analytics.ts
 import { createClientAnalytics } from '@stacksee/analytics/client';
-import { PostHogClientProvider } from '@stacksee/analytics/providers/posthog';
+import { PostHogClientProvider } from '@stacksee/analytics/providers/client';
 import { PUBLIC_POSTHOG_API_KEY, PUBLIC_POSTHOG_HOST } from '$env/static/public';
 
 // Define your events for the waitlist
@@ -306,7 +306,7 @@ export const clientAnalytics = createClientAnalytics<AppEvents>({
 ```typescript
 // src/lib/server/analytics.ts
 import { createServerAnalytics } from '@stacksee/analytics/server';
-import { PostHogServerProvider } from '@stacksee/analytics/providers/posthog';
+import { PostHogServerProvider } from '@stacksee/analytics/providers/server';
 import { AppEvents } from '$lib/config/analytics'; // Import AppEvents
 import { PUBLIC_POSTHOG_API_KEY, PUBLIC_POSTHOG_HOST } from '$env/static/public';
 
@@ -564,6 +564,12 @@ const analytics = await createClientAnalytics<typeof AppEvents>({
 
 ### Client-Only and Server-Only Providers
 
+**Important**: To avoid bundling Node.js dependencies in your client code, always use the environment-specific provider imports:
+
+- **Client-side**: `@stacksee/analytics/providers/client` - Only includes browser-compatible providers
+- **Server-side**: `@stacksee/analytics/providers/server` - Only includes Node.js providers  
+- **Both**: `@stacksee/analytics/providers` - Includes all providers (may cause bundling issues in browsers)
+
 Some analytics libraries are designed to work only in specific environments. For example:
 - **Client-only**: Google Analytics (gtag.js), Hotjar, FullStory
 - **Server-only**: Some enterprise analytics APIs that require secret keys
@@ -638,7 +644,7 @@ The plugin architecture makes it easy to send events to multiple analytics servi
 
 ```typescript
 import { createClientAnalytics } from '@stacksee/analytics/client';
-import { PostHogClientProvider } from '@stacksee/analytics/providers/posthog';
+import { PostHogClientProvider } from '@stacksee/analytics/providers/client';
 // Import your custom providers
 import { GoogleAnalyticsProvider } from './providers/google-analytics';
 import { MixpanelProvider } from './providers/mixpanel';