@stacksee/analytics 0.11.1 → 0.13.0

package/dist/server.js

@@ -1,9 +1,9 @@
-var h = Object.defineProperty;
-var f = (a, r, e) => r in a ? h(a, r, { enumerable: !0, configurable: !0, writable: !0, value: e }) : a[r] = e;
-var o = (a, r, e) => f(a, typeof r != "symbol" ? r + "" : r, e);
+var u = Object.defineProperty;
+var h = (i, e, t) => e in i ? u(i, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : i[e] = t;
+var c = (i, e, t) => h(i, typeof e != "symbol" ? e + "" : e, t);
 import { P as w } from "./server-DjEk1fUD.js";
-import { B as x } from "./base.provider-AfFL5W_P.js";
-class v {
+import { B as y } from "./base.provider-AfFL5W_P.js";
+class f {
   /**
    * Creates a new ServerAnalytics instance for server-side event tracking.
    *
@@ -34,17 +34,17 @@ class v {
    * analytics.initialize();
    * ```
    */
-  constructor(r) {
-    o(this, "providerConfigs", []);
-    o(this, "config");
-    o(this, "initialized", !1);
-    this.config = r, this.providerConfigs = this.normalizeProviders(r.providers);
+  constructor(e) {
+    c(this, "providerConfigs", []);
+    c(this, "config");
+    c(this, "initialized", !1);
+    this.config = e, this.providerConfigs = this.normalizeProviders(e.providers);
   }
   /**
    * Normalizes provider configurations into a consistent internal format
    */
-  normalizeProviders(r) {
-    const e = [
+  normalizeProviders(e) {
+    const t = [
       "initialize",
       "identify",
       "track",
@@ -52,35 +52,55 @@ class v {
       "pageLeave",
       "reset"
     ];
-    return r.map((i) => {
-      if ("initialize" in i && "track" in i)
+    return e.map((n) => {
+      if ("initialize" in n && "track" in n)
         return {
-          provider: i,
-          enabledMethods: new Set(e)
+          provider: n,
+          enabledMethods: new Set(t)
         };
-      const t = i;
-      t.methods && t.exclude && console.warn(
-        `[Analytics] Provider ${t.provider.name} has both 'methods' and 'exclude' specified. Using 'methods' and ignoring 'exclude'.`
+      const r = n;
+      r.methods && r.exclude && console.warn(
+        `[Analytics] Provider ${r.provider.name} has both 'methods' and 'exclude' specified. Using 'methods' and ignoring 'exclude'.`
+      ), r.events && r.excludeEvents && console.warn(
+        `[Analytics] Provider ${r.provider.name} has both 'events' and 'excludeEvents' specified. Using 'events' and ignoring 'excludeEvents'.`
+      ), r.events && r.eventPatterns && console.warn(
+        `[Analytics] Provider ${r.provider.name} has both 'events' and 'eventPatterns' specified. Using 'events' and ignoring 'eventPatterns'.`
+      ), r.excludeEvents && r.eventPatterns && console.warn(
+        `[Analytics] Provider ${r.provider.name} has both 'excludeEvents' and 'eventPatterns' specified. Using 'eventPatterns' and ignoring 'excludeEvents'.`
       );
-      let n;
-      return t.methods ? n = new Set(t.methods) : t.exclude ? n = new Set(
-        e.filter(
+      let a;
+      r.methods ? a = new Set(r.methods) : r.exclude ? a = new Set(
+        t.filter(
           (l) => {
-            var d;
-            return !((d = t.exclude) != null && d.includes(l));
+            var v;
+            return !((v = r.exclude) != null && v.includes(l));
           }
         )
-      ) : n = new Set(e), {
-        provider: t.provider,
-        enabledMethods: n
+      ) : a = new Set(t);
+      let o, d, s;
+      return r.events && r.events.length > 0 ? o = new Set(r.events) : r.eventPatterns && r.eventPatterns.length > 0 ? s = r.eventPatterns.map((l) => {
+        const v = l.replace(/\*/g, ".*");
+        return new RegExp(`^${v}$`);
+      }) : r.excludeEvents && r.excludeEvents.length > 0 && (d = new Set(r.excludeEvents)), {
+        provider: r.provider,
+        enabledMethods: a,
+        enabledEvents: o,
+        excludedEvents: d,
+        eventPatterns: s
       };
     });
   }
   /**
    * Checks if a method should be called on a provider based on routing configuration
    */
-  shouldCallMethod(r, e) {
-    return r.enabledMethods.has(e);
+  shouldCallMethod(e, t) {
+    return e.enabledMethods.has(t);
+  }
+  /**
+   * Checks if an event should be tracked on a provider based on event filtering configuration
+   */
+  shouldTrackEvent(e, t) {
+    return !e.enabledEvents && !e.excludedEvents && !e.eventPatterns ? !0 : e.enabledEvents ? e.enabledEvents.has(t) : e.eventPatterns ? e.eventPatterns.some((n) => n.test(t)) : e.excludedEvents ? !e.excludedEvents.has(t) : !0;
   }
   /**
    * Initializes all analytics providers.
@@ -120,8 +140,8 @@ class v {
    */
   initialize() {
     if (!this.initialized) {
-      for (const r of this.providerConfigs)
-        r.provider.initialize();
+      for (const e of this.providerConfigs)
+        e.provider.initialize();
       this.initialized = !0;
     }
   }
@@ -171,9 +191,9 @@ class v {
    * }
    * ```
    */
-  identify(r, e) {
-    for (const i of this.providerConfigs)
-      this.shouldCallMethod(i, "identify") && i.provider.identify(r, e);
+  identify(e, t) {
+    for (const n of this.providerConfigs)
+      this.shouldCallMethod(n, "identify") && n.provider.identify(e, t);
   }
   /**
    * Tracks a custom event with properties and optional context.
@@ -296,34 +316,36 @@ class v {
    * }
    * ```
    */
-  async track(r, e, i) {
+  async track(e, t, n) {
     var d;
     if (!this.initialized) {
       console.warn("[Analytics] Not initialized. Call initialize() first.");
       return;
     }
-    const t = {
-      action: r,
-      category: this.getCategoryFromEventName(r),
-      properties: e,
+    const r = {
+      action: e,
+      category: this.getCategoryFromEventName(e),
+      properties: t,
       timestamp: Date.now(),
-      userId: i == null ? void 0 : i.userId,
-      sessionId: i == null ? void 0 : i.sessionId
-    }, n = {
+      userId: n == null ? void 0 : n.userId,
+      sessionId: n == null ? void 0 : n.sessionId
+    }, a = {
       ...this.config.defaultContext,
-      ...i == null ? void 0 : i.context,
-      user: (i == null ? void 0 : i.user) || ((d = i == null ? void 0 : i.context) == null ? void 0 : d.user)
-    }, l = this.providerConfigs.filter((s) => this.shouldCallMethod(s, "track")).map(async (s) => {
+      ...n == null ? void 0 : n.context,
+      user: (n == null ? void 0 : n.user) || ((d = n == null ? void 0 : n.context) == null ? void 0 : d.user)
+    }, o = this.providerConfigs.filter(
+      (s) => this.shouldCallMethod(s, "track") && this.shouldTrackEvent(s, e)
+    ).map(async (s) => {
       try {
-        await s.provider.track(t, n);
-      } catch (c) {
+        await s.provider.track(r, a);
+      } catch (l) {
         console.error(
           `[Analytics] Provider ${s.provider.name} failed to track event:`,
-          c
+          l
         );
       }
     });
-    await Promise.all(l);
+    await Promise.all(o);
   }
   /**
    * Tracks a page view event from the server side.
@@ -385,14 +407,14 @@ class v {
    * }
    * ```
    */
-  pageView(r, e) {
+  pageView(e, t) {
     if (!this.initialized) return;
-    const i = {
+    const n = {
       ...this.config.defaultContext,
-      ...e == null ? void 0 : e.context
+      ...t == null ? void 0 : t.context
     };
-    for (const t of this.providerConfigs)
-      this.shouldCallMethod(t, "pageView") && t.provider.pageView(r, i);
+    for (const r of this.providerConfigs)
+      this.shouldCallMethod(r, "pageView") && r.provider.pageView(e, n);
   }
   /**
    * Tracks when a user leaves a page from the server side.
@@ -453,14 +475,14 @@ class v {
    * }
    * ```
    */
-  pageLeave(r, e) {
+  pageLeave(e, t) {
     if (!this.initialized) return;
-    const i = {
+    const n = {
       ...this.config.defaultContext,
-      ...e == null ? void 0 : e.context
+      ...t == null ? void 0 : t.context
     };
-    for (const t of this.providerConfigs)
-      this.shouldCallMethod(t, "pageLeave") && t.provider.pageLeave && t.provider.pageLeave(r, i);
+    for (const r of this.providerConfigs)
+      this.shouldCallMethod(r, "pageLeave") && r.provider.pageLeave && r.provider.pageLeave(e, n);
   }
   /**
    * Shuts down all analytics providers and flushes pending events.
@@ -547,25 +569,25 @@ class v {
    * ```
    */
   async shutdown() {
-    const r = this.providerConfigs.map((e) => "shutdown" in e.provider && typeof e.provider.shutdown == "function" ? e.provider.shutdown() : Promise.resolve());
-    await Promise.all(r);
+    const e = this.providerConfigs.map((t) => "shutdown" in t.provider && typeof t.provider.shutdown == "function" ? t.provider.shutdown() : Promise.resolve());
+    await Promise.all(e);
   }
-  getCategoryFromEventName(r) {
-    const e = r.split("_");
-    return e.length > 1 && e[0] ? e[0] : "engagement";
+  getCategoryFromEventName(e) {
+    const t = e.split("_");
+    return t.length > 1 && t[0] ? t[0] : "engagement";
   }
 }
-function g(a) {
-  const r = {
-    providers: a.providers || [],
-    debug: a.debug,
-    enabled: a.enabled
-  }, e = new v(r);
-  return e.initialize(), e;
+function x(i) {
+  const e = {
+    providers: i.providers || [],
+    debug: i.debug,
+    enabled: i.enabled
+  }, t = new f(e);
+  return t.initialize(), t;
 }
 export {
-  x as BaseAnalyticsProvider,
+  y as BaseAnalyticsProvider,
   w as PostHogServerProvider,
-  v as ServerAnalytics,
-  g as createServerAnalytics
+  f as ServerAnalytics,
+  x as createServerAnalytics
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stacksee/analytics",
-  "version": "0.11.1",
+  "version": "0.13.0",
   "description": "A highly typed, provider-agnostic analytics library for TypeScript applications",
   "type": "module",
   "exports": {