@stacksee/analytics 0.4.3 → 0.4.5

package/dist/server.js

@@ -1,6 +1,8 @@
-var o = Object.defineProperty;
-var f = (r, e, t) => e in r ? o(r, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : r[e] = t;
-var n = (r, e, t) => f(r, typeof e != "symbol" ? e + "" : e, t);
+var l = Object.defineProperty;
+var f = (r, e, t) => e in r ? l(r, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : r[e] = t;
+var s = (r, e, t) => f(r, typeof e != "symbol" ? e + "" : e, t);
+import { P as m } from "./server-CMRw9K0d.js";
+import { B as x } from "./base.provider-AfFL5W_P.js";
 class u {
   /**
    * Creates a new ServerAnalytics instance for server-side event tracking.
@@ -33,9 +35,9 @@ class u {
    * ```
    */
   constructor(e) {
-    n(this, "providers", []);
-    n(this, "config");
-    n(this, "initialized", !1);
+    s(this, "providers", []);
+    s(this, "config");
+    s(this, "initialized", !1);
     this.config = e, this.providers = e.providers;
   }
   /**
@@ -234,17 +236,17 @@ class u {
     }, c = {
       ...this.config.defaultContext,
       ...i == null ? void 0 : i.context
-    }, d = this.providers.map(async (s) => {
+    }, o = this.providers.map(async (n) => {
       try {
-        await s.track(a, c);
-      } catch (l) {
+        await n.track(a, c);
+      } catch (d) {
         console.error(
-          `[Analytics] Provider ${s.name} failed to track event:`,
-          l
+          `[Analytics] Provider ${n.name} failed to track event:`,
+          d
         );
       }
     });
-    await Promise.all(d);
+    await Promise.all(o);
   }
   /**
    * Tracks a page view event from the server side.
@@ -476,7 +478,7 @@ class u {
     return t.length > 1 && t[0] ? t[0] : "engagement";
   }
 }
-function v(r) {
+function h(r) {
   const e = {
     providers: r.providers || [],
     debug: r.debug,
@@ -487,6 +489,8 @@ function v(r) {
   return t.initialize(), t;
 }
 export {
+  x as BaseAnalyticsProvider,
+  m as PostHogServerProvider,
   u as ServerAnalytics,
-  v as createServerAnalytics
+  h as createServerAnalytics
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stacksee/analytics",
-  "version": "0.4.3",
+  "version": "0.4.5",
   "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';