@stacksee/analytics 0.9.0 → 0.9.4

package/dist/providers/server.js

@@ -1,9 +1,9 @@
 var f = Object.defineProperty;
 var y = (l, n, i) => n in l ? f(l, n, { enumerable: !0, configurable: !0, writable: !0, value: i }) : l[n] = i;
 var d = (l, n, i) => y(l, typeof n != "symbol" ? n + "" : n, i);
-import { B as p } from "../base.provider-AfFL5W_P.js";
-import { P as z } from "../server-DjEk1fUD.js";
-class v extends p {
+import { B as c } from "../base.provider-AfFL5W_P.js";
+import { P } from "../server-DjEk1fUD.js";
+class w extends c {
   constructor(i) {
     super({ debug: i.debug, enabled: i.enabled });
     d(this, "name", "Bento-Server");
@@ -23,77 +23,110 @@ class v extends p {
       if (!((e = this.config.authentication) != null && e.secretKey) || typeof this.config.authentication.secretKey != "string")
         throw new Error("Bento requires authentication.secretKey");
       try {
-        const { Analytics: s } = await import("../bento-node-sdk.esm-C4HG7SVz.js"), { debug: a, enabled: t, ...o } = this.config;
-        this.client = new s(o), this.initialized = !0, this.log("Initialized successfully", {
+        const { Analytics: r } = await import("../bento-node-sdk.esm-CWEAoj97.js"), { debug: t, enabled: a, ...o } = this.config;
+        this.client = new r(o), this.initialized = !0, this.log("Initialized successfully", {
           siteUuid: this.config.siteUuid
         });
-      } catch (s) {
+      } catch (r) {
         throw console.error(
           "[Bento-Server] Failed to initialize. Make sure @bentonow/bento-node-sdk is installed:",
-          s
-        ), s;
+          r
+        ), r;
       }
     }
   }
   identify(i, e) {
     if (!this.isEnabled() || !this.initialized || !this.client) return;
-    const s = (e == null ? void 0 : e.email) || i;
-    this.currentUserEmail = s;
-    const a = e ? { ...e } : {};
-    delete a.email, this.client.V1.addSubscriber({
-      email: s,
-      fields: a
-    }).catch((t) => {
-      console.error("[Bento-Server] Failed to identify user:", t);
-    }), this.log("Identified user", { userId: i, email: s, traits: e });
+    const r = (e == null ? void 0 : e.email) || i;
+    if (!r || !r.includes("@")) {
+      this.log("Skipping identify - invalid or missing email", { userId: i, traits: e });
+      return;
+    }
+    this.currentUserEmail = r;
+    const t = e ? { ...e } : {};
+    delete t.email, this.client.V1.addSubscriber({
+      email: r,
+      fields: t
+    }).catch((a) => {
+      console.error("[Bento-Server] Failed to identify user:", a);
+    }), this.log("Identified user", { userId: i, email: r, traits: e });
   }
   async track(i, e) {
-    var o, r, h;
+    var o, s, h, u;
     if (!this.isEnabled() || !this.initialized || !this.client) return;
-    const s = ((o = e == null ? void 0 : e.user) == null ? void 0 : o.email) || this.currentUserEmail || ((r = e == null ? void 0 : e.user) == null ? void 0 : r.userId) || i.userId || "anonymous@unknown.com", a = {
+    const r = ((o = e == null ? void 0 : e.user) == null ? void 0 : o.email) || this.currentUserEmail || ((s = e == null ? void 0 : e.user) == null ? void 0 : s.userId) || i.userId;
+    if (!r || !r.includes("@")) {
+      console.warn(
+        "[Bento-Server] Skipping event - Bento requires an email address. Anonymous events are not currently supported by the Bento Node SDK. For now, use the Bento client provider for anonymous tracking. If you're using a proxy, use the hybrid pattern as described in the docs. For identified users, call identify() with a valid email before tracking events."
+      );
+      return;
+    }
+    const t = {
       ...i.properties,
       category: i.category,
       timestamp: i.timestamp || Date.now(),
       ...i.sessionId && { sessionId: i.sessionId },
       ...(e == null ? void 0 : e.page) && {
         page: {
+          url: e.page.url,
+          host: e.page.host,
           path: e.page.path,
           title: e.page.title,
-          referrer: e.page.referrer
+          protocol: e.page.protocol,
+          referrer: e.page.referrer,
+          ...e.page.search && { search: e.page.search }
         }
       },
       ...(e == null ? void 0 : e.device) && { device: e.device },
-      ...(e == null ? void 0 : e.utm) && { utm: e.utm }
-    }, t = ((h = e == null ? void 0 : e.user) == null ? void 0 : h.traits) || {};
+      ...(e == null ? void 0 : e.utm) && { utm: e.utm },
+      site: this.config.siteUuid,
+      ...((h = e == null ? void 0 : e.user) == null ? void 0 : h.userId) && { visitor: e.user.userId }
+    }, a = ((u = e == null ? void 0 : e.user) == null ? void 0 : u.traits) || {};
     try {
       await this.client.V1.track({
-        email: s,
+        email: r,
         type: `$${i.action}`,
-        details: a,
-        fields: t
+        details: t,
+        fields: a
       }), this.log("Tracked event", { event: i, context: e });
-    } catch (u) {
-      console.error("[Bento-Server] Failed to track event:", u);
+    } catch (p) {
+      console.error("[Bento-Server] Failed to track event:", p);
     }
   }
   pageView(i, e) {
-    var o, r;
+    var o, s, h;
     if (!this.isEnabled() || !this.initialized || !this.client) return;
-    const s = ((o = e == null ? void 0 : e.user) == null ? void 0 : o.email) || this.currentUserEmail || "anonymous@unknown.com", a = {
+    const r = ((o = e == null ? void 0 : e.user) == null ? void 0 : o.email) || this.currentUserEmail;
+    if (!r || !r.includes("@")) {
+      console.warn(
+        "[Bento-Server] Skipping pageView - Bento requires an email address. Anonymous events are not currently supported by the Bento Node SDK. For now, use the Bento client provider for anonymous tracking. If you're using a proxy, use the hybrid pattern as described in the docs. For identified users, call identify() with a valid email before tracking events."
+      );
+      return;
+    }
+    const t = {
       ...i,
+      date: (/* @__PURE__ */ new Date()).toISOString(),
       ...(e == null ? void 0 : e.page) && {
-        path: e.page.path,
-        title: e.page.title,
-        referrer: e.page.referrer
-      }
-    }, t = ((r = e == null ? void 0 : e.user) == null ? void 0 : r.traits) || {};
+        page: {
+          url: e.page.url,
+          host: e.page.host,
+          path: e.page.path,
+          title: e.page.title,
+          protocol: e.page.protocol,
+          referrer: e.page.referrer,
+          ...e.page.search && { search: e.page.search }
+        }
+      },
+      site: this.config.siteUuid,
+      ...((s = e == null ? void 0 : e.user) == null ? void 0 : s.userId) && { visitor: e.user.userId }
+    }, a = ((h = e == null ? void 0 : e.user) == null ? void 0 : h.traits) || {};
     this.client.V1.track({
-      email: s,
+      email: r,
       type: "$view",
-      details: a,
-      fields: t
-    }).catch((h) => {
-      console.error("[Bento-Server] Failed to track page view:", h);
+      details: t,
+      fields: a
+    }).catch((u) => {
+      console.error("[Bento-Server] Failed to track page view:", u);
     }), this.log("Tracked page view", { properties: i, context: e });
   }
   async reset() {
@@ -103,7 +136,7 @@ class v extends p {
     this.client = void 0, this.initialized = !1, this.log("Shutdown complete");
   }
 }
-class E extends p {
+class k extends c {
   constructor(i) {
     super({ debug: i.debug, enabled: i.enabled });
     d(this, "name", "Pirsch-Server");
@@ -119,8 +152,8 @@ class E extends p {
       if (!this.config.clientSecret || typeof this.config.clientSecret != "string")
         throw new Error("Pirsch requires a clientSecret (or access key)");
       try {
-        const { Pirsch: i } = await import("../index-bgxxv-IJ.js").then((t) => t.i), { debug: e, enabled: s, ...a } = this.config;
-        this.client = new i(a), this.initialized = !0, this.log("Initialized successfully", {
+        const { Pirsch: i } = await import("../index-zS7gy63J.js").then((a) => a.i), { debug: e, enabled: r, ...t } = this.config;
+        this.client = new i(t), this.initialized = !0, this.log("Initialized successfully", {
           hostname: this.config.hostname
         });
       } catch (i) {
@@ -133,37 +166,37 @@ class E extends p {
   }
   identify(i, e) {
     if (!this.isEnabled() || !this.initialized || !this.client) return;
-    const s = {
+    const r = {
       url: "https://identify",
       ip: "0.0.0.0",
       user_agent: "analytics-library"
-    }, a = {
+    }, t = {
       userId: i,
       ...e && Object.fromEntries(
         Object.entries(e).filter(
-          ([, t]) => typeof t == "string" || typeof t == "number" || typeof t == "boolean"
+          ([, a]) => typeof a == "string" || typeof a == "number" || typeof a == "boolean"
         )
       )
     };
-    this.client.event("user_identified", s, 0, a).catch((t) => {
-      console.error("[Pirsch-Server] Failed to track identify event:", t);
+    this.client.event("user_identified", r, 0, t).catch((a) => {
+      console.error("[Pirsch-Server] Failed to track identify event:", a);
     }), this.log("Identified user via event", { userId: i, traits: e });
   }
   async track(i, e) {
-    var o, r, h, u;
+    var o, s, h, u;
     if (!this.isEnabled() || !this.initialized || !this.client) return;
-    const s = {
+    const r = {
       url: ((o = e == null ? void 0 : e.page) == null ? void 0 : o.path) || "https://event",
       ip: "0.0.0.0",
       // Server-side should provide real IP if available
       user_agent: "analytics-library",
       // Server-side should provide real UA if available
-      ...((r = e == null ? void 0 : e.page) == null ? void 0 : r.title) && { title: e.page.title },
+      ...((s = e == null ? void 0 : e.page) == null ? void 0 : s.title) && { title: e.page.title },
       ...((h = e == null ? void 0 : e.page) == null ? void 0 : h.referrer) && { referrer: e.page.referrer }
-    }, t = {
+    }, a = {
       ...Object.fromEntries(
         Object.entries(i.properties).filter(
-          ([, c]) => typeof c == "string" || typeof c == "number" || typeof c == "boolean"
+          ([, p]) => typeof p == "string" || typeof p == "number" || typeof p == "boolean"
         )
       ),
       category: i.category,
@@ -173,32 +206,32 @@ class E extends p {
       ...((u = e == null ? void 0 : e.user) == null ? void 0 : u.email) && { user_email: e.user.email }
     };
     try {
-      await this.client.event(i.action, s, 0, t), this.log("Tracked event", { event: i, context: e });
-    } catch (c) {
-      console.error("[Pirsch-Server] Failed to track event:", c);
+      await this.client.event(i.action, r, 0, a), this.log("Tracked event", { event: i, context: e });
+    } catch (p) {
+      console.error("[Pirsch-Server] Failed to track event:", p);
     }
   }
   pageView(i, e) {
-    var a, t, o;
+    var t, a, o;
     if (!this.isEnabled() || !this.initialized || !this.client) return;
-    const s = {
-      url: ((a = e == null ? void 0 : e.page) == null ? void 0 : a.path) || "https://pageview",
+    const r = {
+      url: ((t = e == null ? void 0 : e.page) == null ? void 0 : t.path) || "https://pageview",
       ip: "0.0.0.0",
       // Server-side should provide real IP if available
       user_agent: "analytics-library",
       // Server-side should provide real UA if available
-      ...((t = e == null ? void 0 : e.page) == null ? void 0 : t.title) && { title: e.page.title },
+      ...((a = e == null ? void 0 : e.page) == null ? void 0 : a.title) && { title: e.page.title },
       ...((o = e == null ? void 0 : e.page) == null ? void 0 : o.referrer) && { referrer: e.page.referrer },
       ...i && {
         tags: Object.fromEntries(
           Object.entries(i).filter(
-            ([, r]) => typeof r == "string" || typeof r == "number" || typeof r == "boolean"
+            ([, s]) => typeof s == "string" || typeof s == "number" || typeof s == "boolean"
           )
         )
       }
     };
-    this.client.hit(s).catch((r) => {
-      console.error("[Pirsch-Server] Failed to track page view:", r);
+    this.client.hit(r).catch((s) => {
+      console.error("[Pirsch-Server] Failed to track page view:", s);
     }), this.log("Tracked page view", { properties: i, context: e });
   }
   async reset() {
@@ -217,65 +250,65 @@ class E extends p {
   }
 }
 async function g(l, n, i) {
-  var e, s;
+  var e, r;
   try {
-    const a = await l.json();
-    if (!a.events || !Array.isArray(a.events))
+    const t = await l.json();
+    if (!t.events || !Array.isArray(t.events))
       throw new Error("Invalid payload: missing events array");
-    const t = i != null && i.extractIp ? i.extractIp(l) : m(l), o = i != null && i.enrichContext ? i.enrichContext(l) : {};
-    for (const r of a.events)
+    const a = i != null && i.extractIp ? i.extractIp(l) : b(l), o = i != null && i.enrichContext ? i.enrichContext(l) : {};
+    for (const s of t.events)
       try {
-        switch (r.type) {
+        switch (s.type) {
           case "track": {
             const h = {
-              ...r.context,
+              ...s.context,
               ...o,
               device: {
-                ...(e = r.context) == null ? void 0 : e.device,
+                ...(e = s.context) == null ? void 0 : e.device,
                 // Add IP (using type assertion for extended fields)
                 // biome-ignore lint/suspicious/noExplicitAny: IP field not in base device type
-                ...t ? { ip: t } : {}
+                ...a ? { ip: a } : {}
               }
             };
-            await n.track(r.event.action, r.event.properties, {
-              userId: r.event.userId,
-              sessionId: r.event.sessionId,
+            await n.track(s.event.action, s.event.properties, {
+              userId: s.event.userId,
+              sessionId: s.event.sessionId,
               // biome-ignore lint/suspicious/noExplicitAny: Generic context forwarding requires type assertion
               context: h
             });
             break;
           }
           case "identify": {
-            n.identify(r.userId, r.traits);
+            n.identify(s.userId, s.traits);
             break;
           }
           case "pageView": {
             const h = {
-              ...r.context,
+              ...s.context,
               ...o,
               device: {
-                ...(s = r.context) == null ? void 0 : s.device,
+                ...(r = s.context) == null ? void 0 : r.device,
                 // biome-ignore lint/suspicious/noExplicitAny: IP field not in base device type
                 // Add IP (using type assertion for extended fields)
-                ...t ? { ip: t } : {}
+                ...a ? { ip: a } : {}
               }
             };
-            n.pageView(r.properties, h);
+            n.pageView(s.properties, h);
             break;
           }
           case "reset":
             break;
           default:
-            console.warn("[Proxy] Unknown event type:", r);
+            console.warn("[Proxy] Unknown event type:", s);
         }
       } catch (h) {
         i != null && i.onError ? i.onError(h) : console.error("[Proxy] Failed to process event:", h);
       }
-  } catch (a) {
-    throw i != null && i.onError ? i.onError(a) : console.error("[Proxy] Failed to ingest events:", a), a;
+  } catch (t) {
+    throw i != null && i.onError ? i.onError(t) : console.error("[Proxy] Failed to ingest events:", t), t;
   }
 }
-function m(l) {
+function b(l) {
   var i;
   const n = [
     "x-forwarded-for",
@@ -286,12 +319,12 @@ function m(l) {
     "x-cluster-client-ip"
   ];
   for (const e of n) {
-    const s = l.headers.get(e);
-    if (s)
-      return (i = s.split(",")[0]) == null ? void 0 : i.trim();
+    const r = l.headers.get(e);
+    if (r)
+      return (i = r.split(",")[0]) == null ? void 0 : i.trim();
   }
 }
-function k(l, n) {
+function S(l, n) {
   return async (i) => {
     try {
       return await g(i, l, n), new Response("OK", { status: 200 });
@@ -301,10 +334,10 @@ function k(l, n) {
   };
 }
 export {
-  p as BaseAnalyticsProvider,
-  v as BentoServerProvider,
-  E as PirschServerProvider,
-  z as PostHogServerProvider,
-  k as createProxyHandler,
+  c as BaseAnalyticsProvider,
+  w as BentoServerProvider,
+  k as PirschServerProvider,
+  P as PostHogServerProvider,
+  S as createProxyHandler,
   g as ingestProxyEvents
 };

package/dist/{web-CvEQewPd.js → web-imCcOhDC.js}

@@ -1,4 +1,4 @@
-import { r as O, a as P, b as E } from "./axios-gULqh8dv.js";
+import { r as O, a as P, b as E } from "./axios-0_CwElpL.js";
 function j(f, p) {
   for (var d = 0; d < p.length; d++) {
     const o = p[d];
@@ -19,19 +19,19 @@ var r = {}, w;
 function C() {
   if (w) return r;
   w = 1;
-  var f = r && r.__createBinding || (Object.create ? function(c, e, t, n) {
+  var f = r && r.__createBinding || (Object.create ? (function(c, e, t, n) {
     n === void 0 && (n = t);
     var i = Object.getOwnPropertyDescriptor(e, t);
     (!i || ("get" in i ? !e.__esModule : i.writable || i.configurable)) && (i = { enumerable: !0, get: function() {
       return e[t];
     } }), Object.defineProperty(c, n, i);
-  } : function(c, e, t, n) {
+  }) : (function(c, e, t, n) {
     n === void 0 && (n = t), c[n] = e[t];
-  }), p = r && r.__setModuleDefault || (Object.create ? function(c, e) {
+  })), p = r && r.__setModuleDefault || (Object.create ? (function(c, e) {
     Object.defineProperty(c, "default", { enumerable: !0, value: e });
-  } : function(c, e) {
+  }) : function(c, e) {
     c.default = e;
-  }), d = r && r.__importStar || /* @__PURE__ */ function() {
+  }), d = r && r.__importStar || /* @__PURE__ */ (function() {
     var c = function(e) {
       return c = Object.getOwnPropertyNames || function(t) {
         var n = [];
@@ -45,7 +45,7 @@ function C() {
       if (e != null) for (var n = c(e), i = 0; i < n.length; i++) n[i] !== "default" && f(t, e, n[i]);
       return p(t, e), t;
     };
-  }(), o = r && r.__awaiter || function(c, e, t, n) {
+  })(), o = r && r.__awaiter || function(c, e, t, n) {
     function i(s) {
       return s instanceof t ? s : new t(function(l) {
         l(s);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stacksee/analytics",
-  "version": "0.9.0",
+  "version": "0.9.4",
   "description": "A highly typed, provider-agnostic analytics library for TypeScript applications",
   "type": "module",
   "exports": {
@@ -36,6 +36,8 @@
     "analytics",
     "typescript",
     "posthog",
+    "bento",
+    "pirsch",
     "tracking",
     "events",
     "type-safe"
@@ -70,14 +72,12 @@
     "pnpm": ">=9.0.0",
     "node": ">=20"
   },
-  "dependencies": {
-    "@tailwindcss/vite": "^4.1.16",
-    "tailwindcss": "^4.1.16"
-  },
   "scripts": {
     "test": "vitest run",
     "test:watch": "vitest",
     "build": "vite build",
+    "dev": "pnpm --filter @stacksee/docs dev",
+    "build:docs": "pnpm --filter @stacksee/docs build",
     "deploy": "npm publish",
     "typecheck": "tsc --noEmit",
     "ci:publish": "pnpm build && changeset publish",