@stacksee/analytics 0.8.0 → 0.9.0

package/dist/providers/bento/client.d.ts

@@ -8,6 +8,11 @@ interface BentoClient {
     updateFields(fields: Record<string, unknown>): void;
     getEmail(): string | null;
     getName(): string | null;
+    showSurveyForm(element: HTMLElement, surveyId: string, type?: "popup" | "inline"): void;
+    spamCheck(email: string): Promise<boolean>;
+    showChat?(): void;
+    hideChat?(): void;
+    openChat?(): void;
 }
 export interface BentoClientConfig {
     /**
@@ -43,5 +48,101 @@ export declare class BentoClientProvider extends BaseAnalyticsProvider {
     pageView(properties?: Record<string, unknown>, context?: EventContext): void;
     pageLeave(properties?: Record<string, unknown>, context?: EventContext): void;
     reset(): void;
+    /**
+     * Add a tag to the current user
+     *
+     * @example
+     * ```typescript
+     * bentoProvider.tag('premium_user');
+     * bentoProvider.tag('beta_tester');
+     * ```
+     */
+    tag(tag: string): void;
+    /**
+     * Get the current user's email address
+     *
+     * @returns The user's email or null if not identified
+     *
+     * @example
+     * ```typescript
+     * const email = bentoProvider.getEmail();
+     * if (email) {
+     *   console.log('Current user:', email);
+     * }
+     * ```
+     */
+    getEmail(): string | null;
+    /**
+     * Get the current user's name
+     *
+     * @returns The user's name or null if not set
+     *
+     * @example
+     * ```typescript
+     * const name = bentoProvider.getName();
+     * if (name) {
+     *   console.log('Welcome back,', name);
+     * }
+     * ```
+     */
+    getName(): string | null;
+    /**
+     * Show a Bento survey form
+     *
+     * @param element - The HTML element to render the survey in
+     * @param surveyId - The survey ID from your Bento account
+     * @param type - Display type: 'popup' or 'inline' (default: 'popup')
+     *
+     * @example
+     * ```typescript
+     * const container = document.getElementById('survey-container');
+     * if (container) {
+     *   bentoProvider.showSurveyForm(container, 'survey-123', 'popup');
+     * }
+     * ```
+     */
+    showSurveyForm(element: HTMLElement, surveyId: string, type?: "popup" | "inline"): void;
+    /**
+     * Validate an email address using Bento's spam check
+     *
+     * @param email - The email address to validate
+     * @returns Promise that resolves to true if email is valid, false if spam
+     *
+     * @example
+     * ```typescript
+     * const isValid = await bentoProvider.spamCheck('user@example.com');
+     * if (!isValid) {
+     *   console.log('Invalid or spam email detected');
+     * }
+     * ```
+     */
+    spamCheck(email: string): Promise<boolean>;
+    /**
+     * Show the Bento chat widget
+     *
+     * @example
+     * ```typescript
+     * bentoProvider.showChat();
+     * ```
+     */
+    showChat(): void;
+    /**
+     * Hide the Bento chat widget
+     *
+     * @example
+     * ```typescript
+     * bentoProvider.hideChat();
+     * ```
+     */
+    hideChat(): void;
+    /**
+     * Open the Bento chat widget
+     *
+     * @example
+     * ```typescript
+     * bentoProvider.openChat();
+     * ```
+     */
+    openChat(): void;
 }
 export {};

package/dist/providers/client.js

@@ -1,10 +1,10 @@
 var u = Object.defineProperty;
-var f = (h, n, i) => n in h ? u(h, n, { enumerable: !0, configurable: !0, writable: !0, value: i }) : h[n] = i;
-var r = (h, n, i) => f(h, typeof n != "symbol" ? n + "" : n, i);
-import { B as o } from "../base.provider-AfFL5W_P.js";
-import { i as l } from "../client-DTHZYkxx.js";
+var f = (l, h, i) => h in l ? u(l, h, { enumerable: !0, configurable: !0, writable: !0, value: i }) : l[h] = i;
+var r = (l, h, i) => f(l, typeof h != "symbol" ? h + "" : h, i);
+import { B as d } from "../base.provider-AfFL5W_P.js";
+import { i as a } from "../client-DTHZYkxx.js";
 import { P as E } from "../client-DTHZYkxx.js";
-class y extends o {
+class b extends d {
   constructor(i) {
     super({ debug: i.debug, enabled: i.enabled });
     r(this, "name", "Bento-Client");
@@ -16,7 +16,7 @@ class y extends o {
   }
   async initialize() {
     if (this.isEnabled() && !this.initialized) {
-      if (!l()) {
+      if (!a()) {
         this.log("Skipping initialization - not in browser environment");
         return;
       }
@@ -37,35 +37,35 @@ class y extends o {
         this.scriptLoaded = !0, i();
         return;
       }
-      const t = document.createElement("script");
-      t.src = `https://cdn.bentonow.com/v1/${this.config.siteUuid}/bento.js`, t.async = !0, t.onload = () => {
+      const s = document.createElement("script");
+      s.src = `https://cdn.bentonow.com/v1/${this.config.siteUuid}/bento.js`, s.async = !0, s.onload = () => {
         this.scriptLoaded = !0, i();
-      }, t.onerror = () => {
+      }, s.onerror = () => {
         e(new Error("Failed to load Bento script"));
-      }, document.head.appendChild(t);
+      }, document.head.appendChild(s);
     });
   }
   async waitForBento(i = 50, e = 100) {
-    for (let s = 0; s < i; s++) {
+    for (let t = 0; t < i; t++) {
       if (window.bento)
         return;
-      await new Promise((t) => setTimeout(t, e));
+      await new Promise((s) => setTimeout(s, e));
     }
     throw new Error("Bento SDK not available after loading script");
   }
   identify(i, e) {
     if (!this.isEnabled() || !this.initialized || !this.bento) return;
-    const s = (e == null ? void 0 : e.email) || i;
-    if (this.bento.identify(s), e) {
-      const t = { ...e };
-      delete t.email, Object.keys(t).length > 0 && this.bento.updateFields(t);
+    const t = (e == null ? void 0 : e.email) || i;
+    if (this.bento.identify(t), e) {
+      const s = { ...e };
+      delete s.email, Object.keys(s).length > 0 && this.bento.updateFields(s);
     }
-    this.log("Identified user", { userId: i, email: s, traits: e });
+    this.log("Identified user", { userId: i, email: t, traits: e });
   }
   track(i, e) {
-    var t, a;
+    var s, n;
     if (!this.isEnabled() || !this.initialized || !this.bento) return;
-    const s = {
+    const t = {
       ...i.properties,
       category: i.category,
       timestamp: i.timestamp || Date.now(),
@@ -81,15 +81,15 @@ class y extends o {
       ...(e == null ? void 0 : e.device) && { device: e.device },
       ...(e == null ? void 0 : e.utm) && { utm: e.utm },
       // Include user email and traits as regular event properties
-      ...((t = e == null ? void 0 : e.user) == null ? void 0 : t.email) && { user_email: e.user.email },
-      ...((a = e == null ? void 0 : e.user) == null ? void 0 : a.traits) && { user_traits: e.user.traits }
+      ...((s = e == null ? void 0 : e.user) == null ? void 0 : s.email) && { user_email: e.user.email },
+      ...((n = e == null ? void 0 : e.user) == null ? void 0 : n.traits) && { user_traits: e.user.traits }
     };
-    this.bento.track(i.action, s), this.log("Tracked event", { event: i, context: e });
+    this.bento.track(i.action, t), this.log("Tracked event", { event: i, context: e });
   }
   pageView(i, e) {
-    if (!(!this.isEnabled() || !this.initialized || !this.bento || !l())) {
+    if (!(!this.isEnabled() || !this.initialized || !this.bento || !a())) {
       if (this.bento.view(), i || e != null && e.page) {
-        const s = {
+        const t = {
           ...i,
           ...(e == null ? void 0 : e.page) && {
             path: e.page.path,
@@ -97,15 +97,15 @@ class y extends o {
             referrer: e.page.referrer
           }
         };
-        this.bento.track("$pageview", s);
+        this.bento.track("$view", t);
       }
       this.log("Tracked page view", { properties: i, context: e });
     }
   }
   pageLeave(i, e) {
-    if (!this.isEnabled() || !this.initialized || !this.bento || !l())
+    if (!this.isEnabled() || !this.initialized || !this.bento || !a())
       return;
-    const s = {
+    const t = {
       ...i,
       ...(e == null ? void 0 : e.page) && {
         path: e.page.path,
@@ -113,13 +113,147 @@ class y extends o {
         referrer: e.page.referrer
       }
     };
-    this.bento.track("$pageleave", s), this.log("Tracked page leave", { properties: i, context: e });
+    this.bento.track("$pageleave", t), this.log("Tracked page leave", { properties: i, context: e });
   }
   reset() {
-    !this.isEnabled() || !this.initialized || !this.bento || !l() || this.log("Reset user session - Note: Bento doesn't have a native reset method");
+    !this.isEnabled() || !this.initialized || !this.bento || !a() || this.log("Reset user session - Note: Bento doesn't have a native reset method");
+  }
+  // ============================================================================
+  // Bento-Specific Utility Methods
+  // ============================================================================
+  /**
+   * Add a tag to the current user
+   *
+   * @example
+   * ```typescript
+   * bentoProvider.tag('premium_user');
+   * bentoProvider.tag('beta_tester');
+   * ```
+   */
+  tag(i) {
+    !this.isEnabled() || !this.initialized || !this.bento || !a() || (this.bento.tag(i), this.log("Added tag to user", { tag: i }));
+  }
+  /**
+   * Get the current user's email address
+   *
+   * @returns The user's email or null if not identified
+   *
+   * @example
+   * ```typescript
+   * const email = bentoProvider.getEmail();
+   * if (email) {
+   *   console.log('Current user:', email);
+   * }
+   * ```
+   */
+  getEmail() {
+    return !this.isEnabled() || !this.initialized || !this.bento || !a() ? null : this.bento.getEmail();
+  }
+  /**
+   * Get the current user's name
+   *
+   * @returns The user's name or null if not set
+   *
+   * @example
+   * ```typescript
+   * const name = bentoProvider.getName();
+   * if (name) {
+   *   console.log('Welcome back,', name);
+   * }
+   * ```
+   */
+  getName() {
+    return !this.isEnabled() || !this.initialized || !this.bento || !a() ? null : this.bento.getName();
+  }
+  // ============================================================================
+  // Survey Methods
+  // ============================================================================
+  /**
+   * Show a Bento survey form
+   *
+   * @param element - The HTML element to render the survey in
+   * @param surveyId - The survey ID from your Bento account
+   * @param type - Display type: 'popup' or 'inline' (default: 'popup')
+   *
+   * @example
+   * ```typescript
+   * const container = document.getElementById('survey-container');
+   * if (container) {
+   *   bentoProvider.showSurveyForm(container, 'survey-123', 'popup');
+   * }
+   * ```
+   */
+  showSurveyForm(i, e, t = "popup") {
+    !this.isEnabled() || !this.initialized || !this.bento || !a() || (this.bento.showSurveyForm(i, e, t), this.log("Showed survey form", { surveyId: e, type: t }));
+  }
+  /**
+   * Validate an email address using Bento's spam check
+   *
+   * @param email - The email address to validate
+   * @returns Promise that resolves to true if email is valid, false if spam
+   *
+   * @example
+   * ```typescript
+   * const isValid = await bentoProvider.spamCheck('user@example.com');
+   * if (!isValid) {
+   *   console.log('Invalid or spam email detected');
+   * }
+   * ```
+   */
+  async spamCheck(i) {
+    if (!this.isEnabled() || !this.initialized || !this.bento || !a())
+      return !1;
+    try {
+      const e = await this.bento.spamCheck(i);
+      return this.log("Spam check completed", { email: i, result: e }), e;
+    } catch (e) {
+      return console.error("[Bento-Client] Spam check failed:", e), !1;
+    }
+  }
+  // ============================================================================
+  // Chat Methods (if chat is enabled in Bento)
+  // ============================================================================
+  /**
+   * Show the Bento chat widget
+   *
+   * @example
+   * ```typescript
+   * bentoProvider.showChat();
+   * ```
+   */
+  showChat() {
+    !this.isEnabled() || !this.initialized || !this.bento || !a() || (this.bento.showChat ? (this.bento.showChat(), this.log("Showed chat widget")) : console.warn(
+      "[Bento-Client] Chat not available. Make sure chat is enabled in your Bento settings."
+    ));
+  }
+  /**
+   * Hide the Bento chat widget
+   *
+   * @example
+   * ```typescript
+   * bentoProvider.hideChat();
+   * ```
+   */
+  hideChat() {
+    !this.isEnabled() || !this.initialized || !this.bento || !a() || (this.bento.hideChat ? (this.bento.hideChat(), this.log("Hid chat widget")) : console.warn(
+      "[Bento-Client] Chat not available. Make sure chat is enabled in your Bento settings."
+    ));
+  }
+  /**
+   * Open the Bento chat widget
+   *
+   * @example
+   * ```typescript
+   * bentoProvider.openChat();
+   * ```
+   */
+  openChat() {
+    !this.isEnabled() || !this.initialized || !this.bento || !a() || (this.bento.openChat ? (this.bento.openChat(), this.log("Opened chat widget")) : console.warn(
+      "[Bento-Client] Chat not available. Make sure chat is enabled in your Bento settings."
+    ));
   }
 }
-class w extends o {
+class w extends d {
   constructor(i) {
     super({ debug: i.debug, enabled: i.enabled });
     r(this, "name", "Pirsch-Client");
@@ -130,7 +264,7 @@ class w extends o {
   }
   async initialize() {
     if (this.isEnabled() && !this.initialized) {
-      if (!l()) {
+      if (!a()) {
         this.log("Skipping initialization - not in browser environment");
         return;
       }
@@ -154,14 +288,14 @@ class w extends o {
     !this.isEnabled() || !this.initialized || !this.client || (this.client.event("user_identified", 0, {
       userId: i,
       ...e
-    }).catch((s) => {
-      console.error("[Pirsch-Client] Failed to track identify event:", s);
+    }).catch((t) => {
+      console.error("[Pirsch-Client] Failed to track identify event:", t);
     }), this.log("Identified user via event", { userId: i, traits: e }));
   }
   async track(i, e) {
-    var t, a;
+    var s, n;
     if (!this.isEnabled() || !this.initialized || !this.client) return;
-    const s = {
+    const t = {
       ...i.properties,
       category: i.category,
       ...i.userId && { userId: i.userId },
@@ -173,21 +307,21 @@ class w extends o {
       },
       ...(e == null ? void 0 : e.device) && { device: e.device },
       ...(e == null ? void 0 : e.utm) && { utm: e.utm },
-      ...((t = e == null ? void 0 : e.user) == null ? void 0 : t.email) && { user_email: e.user.email },
-      ...((a = e == null ? void 0 : e.user) == null ? void 0 : a.traits) && { user_traits: e.user.traits }
+      ...((s = e == null ? void 0 : e.user) == null ? void 0 : s.email) && { user_email: e.user.email },
+      ...((n = e == null ? void 0 : e.user) == null ? void 0 : n.traits) && { user_traits: e.user.traits }
     };
     try {
-      await this.client.event(i.action, 0, s), this.log("Tracked event", { event: i, context: e });
-    } catch (d) {
-      console.error("[Pirsch-Client] Failed to track event:", d);
+      await this.client.event(i.action, 0, t), this.log("Tracked event", { event: i, context: e });
+    } catch (o) {
+      console.error("[Pirsch-Client] Failed to track event:", o);
     }
   }
   pageView(i, e) {
-    if (!(!this.isEnabled() || !this.initialized || !this.client || !l())) {
-      if (this.client.hit().catch((s) => {
-        console.error("[Pirsch-Client] Failed to track page view:", s);
+    if (!(!this.isEnabled() || !this.initialized || !this.client || !a())) {
+      if (this.client.hit().catch((t) => {
+        console.error("[Pirsch-Client] Failed to track page view:", t);
       }), i && Object.keys(i).length > 0) {
-        const s = {
+        const t = {
           ...i,
           ...(e == null ? void 0 : e.page) && {
             path: e.page.path,
@@ -195,10 +329,10 @@ class w extends o {
             referrer: e.page.referrer
           }
         };
-        this.client.event("page_view", 0, s).catch((t) => {
+        this.client.event("page_view", 0, t).catch((s) => {
           console.error(
             "[Pirsch-Client] Failed to track page view event:",
-            t
+            s
           );
         });
       }
@@ -206,28 +340,28 @@ class w extends o {
     }
   }
   pageLeave(i, e) {
-    if (!this.isEnabled() || !this.initialized || !this.client || !l())
+    if (!this.isEnabled() || !this.initialized || !this.client || !a())
       return;
-    const s = {
+    const t = {
       ...i,
       ...(e == null ? void 0 : e.page) && {
         path: e.page.path,
         title: e.page.title
       }
     };
-    this.client.event("page_leave", 0, s).catch((t) => {
-      console.error("[Pirsch-Client] Failed to track page leave:", t);
+    this.client.event("page_leave", 0, t).catch((s) => {
+      console.error("[Pirsch-Client] Failed to track page leave:", s);
     }), this.log("Tracked page leave", { properties: i, context: e });
   }
   reset() {
-    !this.isEnabled() || !this.initialized || !this.client || !l() || (this.client.event("session_reset", 0, {}).catch((i) => {
+    !this.isEnabled() || !this.initialized || !this.client || !a() || (this.client.event("session_reset", 0, {}).catch((i) => {
       console.error("[Pirsch-Client] Failed to track session reset:", i);
     }), this.log("Reset user session"));
   }
 }
-class m extends o {
+class y extends d {
   constructor(i) {
-    var e, s, t, a, d;
+    var e, t, s, n, o;
     super({ debug: i.debug, enabled: i.enabled });
     r(this, "name", "Proxy");
     r(this, "config");
@@ -238,7 +372,7 @@ class m extends o {
     r(this, "retryAttempts");
     r(this, "retryBackoff");
     r(this, "retryInitialDelay");
-    this.config = i, this.batchSize = ((e = i.batch) == null ? void 0 : e.size) ?? 10, this.batchInterval = ((s = i.batch) == null ? void 0 : s.interval) ?? 5e3, this.retryAttempts = ((t = i.retry) == null ? void 0 : t.attempts) ?? 3, this.retryBackoff = ((a = i.retry) == null ? void 0 : a.backoff) ?? "exponential", this.retryInitialDelay = ((d = i.retry) == null ? void 0 : d.initialDelay) ?? 1e3, typeof window < "u" && (window.addEventListener("beforeunload", () => {
+    this.config = i, this.batchSize = ((e = i.batch) == null ? void 0 : e.size) ?? 10, this.batchInterval = ((t = i.batch) == null ? void 0 : t.interval) ?? 5e3, this.retryAttempts = ((s = i.retry) == null ? void 0 : s.attempts) ?? 3, this.retryBackoff = ((n = i.retry) == null ? void 0 : n.backoff) ?? "exponential", this.retryInitialDelay = ((o = i.retry) == null ? void 0 : o.initialDelay) ?? 1e3, typeof window < "u" && (window.addEventListener("beforeunload", () => {
       this.flush(!0);
     }), document.addEventListener("visibilitychange", () => {
       document.visibilityState === "hidden" && this.flush(!0);
@@ -298,19 +432,19 @@ class m extends o {
     }, this.batchInterval));
   }
   async sendEvents(i, e = !1) {
-    const s = { events: i };
+    const t = { events: i };
     if (e && typeof navigator < "u" && navigator.sendBeacon) {
-      const t = new Blob([JSON.stringify(s)], {
+      const s = new Blob([JSON.stringify(t)], {
         type: "application/json"
       });
-      navigator.sendBeacon(this.config.endpoint, t) || console.warn("[Proxy] Failed to send events via beacon");
+      navigator.sendBeacon(this.config.endpoint, s) || console.warn("[Proxy] Failed to send events via beacon");
       return;
     }
-    await this.sendWithRetry(s);
+    await this.sendWithRetry(t);
   }
   async sendWithRetry(i, e = 0) {
     try {
-      const s = await fetch(this.config.endpoint, {
+      const t = await fetch(this.config.endpoint, {
         method: "POST",
         headers: {
           "Content-Type": "application/json",
@@ -320,15 +454,15 @@ class m extends o {
         // Don't include credentials by default
         credentials: "same-origin"
       });
-      if (!s.ok)
-        throw new Error(`HTTP ${s.status}: ${s.statusText}`);
+      if (!t.ok)
+        throw new Error(`HTTP ${t.status}: ${t.statusText}`);
       this.log(`Sent ${i.events.length} events successfully`);
-    } catch (s) {
+    } catch (t) {
       if (e < this.retryAttempts) {
-        const t = this.calculateRetryDelay(e);
-        return this.log(`Retry attempt ${e + 1} after ${t}ms`, { error: s }), await new Promise((a) => setTimeout(a, t)), this.sendWithRetry(i, e + 1);
+        const s = this.calculateRetryDelay(e);
+        return this.log(`Retry attempt ${e + 1} after ${s}ms`, { error: t }), await new Promise((n) => setTimeout(n, s)), this.sendWithRetry(i, e + 1);
       }
-      throw console.error("[Proxy] Failed to send events after retries:", s), s;
+      throw console.error("[Proxy] Failed to send events after retries:", t), t;
     }
   }
   calculateRetryDelay(i) {
@@ -365,9 +499,9 @@ class m extends o {
   }
 }
 export {
-  o as BaseAnalyticsProvider,
-  y as BentoClientProvider,
+  d as BaseAnalyticsProvider,
+  b as BentoClientProvider,
   w as PirschClientProvider,
   E as PostHogClientProvider,
-  m as ProxyProvider
+  y as ProxyProvider
 };

package/dist/providers/server.js

@@ -89,7 +89,7 @@ class v extends p {
     }, t = ((r = e == null ? void 0 : e.user) == null ? void 0 : r.traits) || {};
     this.client.V1.track({
       email: s,
-      type: "$pageview",
+      type: "$view",
       details: a,
       fields: t
     }).catch((h) => {
@@ -233,12 +233,14 @@ async function g(l, n, i) {
               device: {
                 ...(e = r.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 } : {}
               }
             };
             await n.track(r.event.action, r.event.properties, {
               userId: r.event.userId,
               sessionId: r.event.sessionId,
+              // biome-ignore lint/suspicious/noExplicitAny: Generic context forwarding requires type assertion
               context: h
             });
             break;
@@ -253,6 +255,7 @@ async function g(l, n, i) {
               ...o,
               device: {
                 ...(s = r.context) == null ? void 0 : s.device,
+                // biome-ignore lint/suspicious/noExplicitAny: IP field not in base device type
                 // Add IP (using type assertion for extended fields)
                 ...t ? { ip: t } : {}
               }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stacksee/analytics",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "A highly typed, provider-agnostic analytics library for TypeScript applications",
   "type": "module",
   "exports": {
@@ -70,6 +70,10 @@
     "pnpm": ">=9.0.0",
     "node": ">=20"
   },
+  "dependencies": {
+    "@tailwindcss/vite": "^4.1.16",
+    "tailwindcss": "^4.1.16"
+  },
   "scripts": {
     "test": "vitest run",
     "test:watch": "vitest",