@stacksee/analytics 0.7.0 → 0.8.0

package/dist/providers/client.d.ts

@@ -5,3 +5,6 @@ export { BentoClientProvider } from './bento/client.js';
 export type { BentoClientConfig } from './bento/client.js';
 export { PirschClientProvider } from './pirsch/client.js';
 export type { PirschClientConfig } from './pirsch/client.js';
+export { ProxyProvider } from './proxy/client.js';
+export type { ProxyProviderConfig } from './proxy/client.js';
+export type { ProxyBatchConfig, ProxyRetryConfig, ProxyEvent, ProxyPayload, ProxyTrackEvent, ProxyIdentifyEvent, ProxyPageViewEvent, ProxyResetEvent, } from './proxy/types.js';

package/dist/providers/client.js

@@ -1,18 +1,18 @@
-var g = Object.defineProperty;
-var p = (d, t, e) => t in d ? g(d, t, { enumerable: !0, configurable: !0, writable: !0, value: e }) : d[t] = e;
-var a = (d, t, e) => p(d, typeof t != "symbol" ? t + "" : t, e);
-import { B as h } from "../base.provider-AfFL5W_P.js";
+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";
-import { P as y } from "../client-DTHZYkxx.js";
-class m extends h {
-  constructor(e) {
-    super({ debug: e.debug, enabled: e.enabled });
-    a(this, "name", "Bento-Client");
-    a(this, "bento");
-    a(this, "initialized", !1);
-    a(this, "config");
-    a(this, "scriptLoaded", !1);
-    this.config = e;
+import { P as E } from "../client-DTHZYkxx.js";
+class y extends o {
+  constructor(i) {
+    super({ debug: i.debug, enabled: i.enabled });
+    r(this, "name", "Bento-Client");
+    r(this, "bento");
+    r(this, "initialized", !1);
+    r(this, "config");
+    r(this, "scriptLoaded", !1);
+    this.config = i;
   }
   async initialize() {
     if (this.isEnabled() && !this.initialized) {
@@ -24,109 +24,109 @@ class m extends h {
         throw new Error("Bento requires a siteUuid");
       try {
         this.scriptLoaded || await this.loadBentoScript(), await this.waitForBento(), this.bento = window.bento, this.initialized = !0, this.log("Initialized successfully", this.config);
-      } catch (e) {
-        throw console.error("[Bento-Client] Failed to initialize:", e), e;
+      } catch (i) {
+        throw console.error("[Bento-Client] Failed to initialize:", i), i;
       }
     }
   }
   async loadBentoScript() {
-    return new Promise((e, i) => {
+    return new Promise((i, e) => {
       if (document.querySelector(
         'script[src*="bentonow.com"]'
       )) {
-        this.scriptLoaded = !0, e();
+        this.scriptLoaded = !0, i();
         return;
       }
-      const r = document.createElement("script");
-      r.src = `https://cdn.bentonow.com/v1/${this.config.siteUuid}/bento.js`, r.async = !0, r.onload = () => {
-        this.scriptLoaded = !0, e();
-      }, r.onerror = () => {
-        i(new Error("Failed to load Bento script"));
-      }, document.head.appendChild(r);
+      const t = document.createElement("script");
+      t.src = `https://cdn.bentonow.com/v1/${this.config.siteUuid}/bento.js`, t.async = !0, t.onload = () => {
+        this.scriptLoaded = !0, i();
+      }, t.onerror = () => {
+        e(new Error("Failed to load Bento script"));
+      }, document.head.appendChild(t);
     });
   }
-  async waitForBento(e = 50, i = 100) {
-    for (let s = 0; s < e; s++) {
+  async waitForBento(i = 50, e = 100) {
+    for (let s = 0; s < i; s++) {
       if (window.bento)
         return;
-      await new Promise((r) => setTimeout(r, i));
+      await new Promise((t) => setTimeout(t, e));
     }
     throw new Error("Bento SDK not available after loading script");
   }
-  identify(e, i) {
+  identify(i, e) {
     if (!this.isEnabled() || !this.initialized || !this.bento) return;
-    const s = (i == null ? void 0 : i.email) || e;
-    if (this.bento.identify(s), i) {
-      const r = { ...i };
-      delete r.email, Object.keys(r).length > 0 && this.bento.updateFields(r);
+    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);
     }
-    this.log("Identified user", { userId: e, email: s, traits: i });
+    this.log("Identified user", { userId: i, email: s, traits: e });
   }
-  track(e, i) {
-    var r, n;
+  track(i, e) {
+    var t, a;
     if (!this.isEnabled() || !this.initialized || !this.bento) return;
     const s = {
-      ...e.properties,
-      category: e.category,
-      timestamp: e.timestamp || Date.now(),
-      ...e.userId && { userId: e.userId },
-      ...e.sessionId && { sessionId: e.sessionId },
-      ...(i == null ? void 0 : i.page) && {
+      ...i.properties,
+      category: i.category,
+      timestamp: i.timestamp || Date.now(),
+      ...i.userId && { userId: i.userId },
+      ...i.sessionId && { sessionId: i.sessionId },
+      ...(e == null ? void 0 : e.page) && {
         page: {
-          path: i.page.path,
-          title: i.page.title,
-          referrer: i.page.referrer
+          path: e.page.path,
+          title: e.page.title,
+          referrer: e.page.referrer
         }
       },
-      ...(i == null ? void 0 : i.device) && { device: i.device },
-      ...(i == null ? void 0 : i.utm) && { utm: i.utm },
+      ...(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
-      ...((r = i == null ? void 0 : i.user) == null ? void 0 : r.email) && { user_email: i.user.email },
-      ...((n = i == null ? void 0 : i.user) == null ? void 0 : n.traits) && { user_traits: i.user.traits }
+      ...((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 }
     };
-    this.bento.track(e.action, s), this.log("Tracked event", { event: e, context: i });
+    this.bento.track(i.action, s), this.log("Tracked event", { event: i, context: e });
   }
-  pageView(e, i) {
+  pageView(i, e) {
     if (!(!this.isEnabled() || !this.initialized || !this.bento || !l())) {
-      if (this.bento.view(), e || i != null && i.page) {
+      if (this.bento.view(), i || e != null && e.page) {
         const s = {
-          ...e,
-          ...(i == null ? void 0 : i.page) && {
-            path: i.page.path,
-            title: i.page.title,
-            referrer: i.page.referrer
+          ...i,
+          ...(e == null ? void 0 : e.page) && {
+            path: e.page.path,
+            title: e.page.title,
+            referrer: e.page.referrer
           }
         };
         this.bento.track("$pageview", s);
       }
-      this.log("Tracked page view", { properties: e, context: i });
+      this.log("Tracked page view", { properties: i, context: e });
     }
   }
-  pageLeave(e, i) {
+  pageLeave(i, e) {
     if (!this.isEnabled() || !this.initialized || !this.bento || !l())
       return;
     const s = {
-      ...e,
-      ...(i == null ? void 0 : i.page) && {
-        path: i.page.path,
-        title: i.page.title,
-        referrer: i.page.referrer
+      ...i,
+      ...(e == null ? void 0 : e.page) && {
+        path: e.page.path,
+        title: e.page.title,
+        referrer: e.page.referrer
       }
     };
-    this.bento.track("$pageleave", s), this.log("Tracked page leave", { properties: e, context: i });
+    this.bento.track("$pageleave", s), 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");
   }
 }
-class b extends h {
-  constructor(e) {
-    super({ debug: e.debug, enabled: e.enabled });
-    a(this, "name", "Pirsch-Client");
-    a(this, "client");
-    a(this, "initialized", !1);
-    a(this, "config");
-    this.config = e;
+class w extends o {
+  constructor(i) {
+    super({ debug: i.debug, enabled: i.enabled });
+    r(this, "name", "Pirsch-Client");
+    r(this, "client");
+    r(this, "initialized", !1);
+    r(this, "config");
+    this.config = i;
   }
   async initialize() {
     if (this.isEnabled() && !this.initialized) {
@@ -137,97 +137,237 @@ class b extends h {
       if (!this.config.identificationCode || typeof this.config.identificationCode != "string")
         throw new Error("Pirsch requires an identificationCode");
       try {
-        const { Pirsch: e } = await import("../web-CvEQewPd.js").then((i) => i.w);
-        this.client = new e({
+        const { Pirsch: i } = await import("../web-CvEQewPd.js").then((e) => e.w);
+        this.client = new i({
           identificationCode: this.config.identificationCode,
           ...this.config.hostname && { hostname: this.config.hostname }
         }), this.initialized = !0, this.log("Initialized successfully", this.config);
-      } catch (e) {
+      } catch (i) {
         throw console.error(
           "[Pirsch-Client] Failed to initialize. Make sure pirsch-sdk is installed:",
-          e
-        ), e;
+          i
+        ), i;
       }
     }
   }
-  identify(e, i) {
+  identify(i, e) {
     !this.isEnabled() || !this.initialized || !this.client || (this.client.event("user_identified", 0, {
-      userId: e,
-      ...i
+      userId: i,
+      ...e
     }).catch((s) => {
       console.error("[Pirsch-Client] Failed to track identify event:", s);
-    }), this.log("Identified user via event", { userId: e, traits: i }));
+    }), this.log("Identified user via event", { userId: i, traits: e }));
   }
-  async track(e, i) {
-    var r, n;
+  async track(i, e) {
+    var t, a;
     if (!this.isEnabled() || !this.initialized || !this.client) return;
     const s = {
-      ...e.properties,
-      category: e.category,
-      ...e.userId && { userId: e.userId },
-      ...e.sessionId && { sessionId: e.sessionId },
-      ...(i == null ? void 0 : i.page) && {
-        page_path: i.page.path,
-        page_title: i.page.title,
-        page_referrer: i.page.referrer
+      ...i.properties,
+      category: i.category,
+      ...i.userId && { userId: i.userId },
+      ...i.sessionId && { sessionId: i.sessionId },
+      ...(e == null ? void 0 : e.page) && {
+        page_path: e.page.path,
+        page_title: e.page.title,
+        page_referrer: e.page.referrer
       },
-      ...(i == null ? void 0 : i.device) && { device: i.device },
-      ...(i == null ? void 0 : i.utm) && { utm: i.utm },
-      ...((r = i == null ? void 0 : i.user) == null ? void 0 : r.email) && { user_email: i.user.email },
-      ...((n = i == null ? void 0 : i.user) == null ? void 0 : n.traits) && { user_traits: i.user.traits }
+      ...(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 }
     };
     try {
-      await this.client.event(e.action, 0, s), this.log("Tracked event", { event: e, context: i });
-    } catch (o) {
-      console.error("[Pirsch-Client] Failed to track event:", o);
+      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);
     }
   }
-  pageView(e, i) {
+  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);
-      }), e && Object.keys(e).length > 0) {
+      }), i && Object.keys(i).length > 0) {
         const s = {
-          ...e,
-          ...(i == null ? void 0 : i.page) && {
-            path: i.page.path,
-            title: i.page.title,
-            referrer: i.page.referrer
+          ...i,
+          ...(e == null ? void 0 : e.page) && {
+            path: e.page.path,
+            title: e.page.title,
+            referrer: e.page.referrer
           }
         };
-        this.client.event("page_view", 0, s).catch((r) => {
+        this.client.event("page_view", 0, s).catch((t) => {
           console.error(
             "[Pirsch-Client] Failed to track page view event:",
-            r
+            t
           );
         });
       }
-      this.log("Tracked page view", { properties: e, context: i });
+      this.log("Tracked page view", { properties: i, context: e });
     }
   }
-  pageLeave(e, i) {
+  pageLeave(i, e) {
     if (!this.isEnabled() || !this.initialized || !this.client || !l())
       return;
     const s = {
-      ...e,
-      ...(i == null ? void 0 : i.page) && {
-        path: i.page.path,
-        title: i.page.title
+      ...i,
+      ...(e == null ? void 0 : e.page) && {
+        path: e.page.path,
+        title: e.page.title
       }
     };
-    this.client.event("page_leave", 0, s).catch((r) => {
-      console.error("[Pirsch-Client] Failed to track page leave:", r);
-    }), this.log("Tracked page leave", { properties: e, context: i });
+    this.client.event("page_leave", 0, s).catch((t) => {
+      console.error("[Pirsch-Client] Failed to track page leave:", t);
+    }), this.log("Tracked page leave", { properties: i, context: e });
   }
   reset() {
-    !this.isEnabled() || !this.initialized || !this.client || !l() || (this.client.event("session_reset", 0, {}).catch((e) => {
-      console.error("[Pirsch-Client] Failed to track session reset:", e);
+    !this.isEnabled() || !this.initialized || !this.client || !l() || (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 {
+  constructor(i) {
+    var e, s, t, a, d;
+    super({ debug: i.debug, enabled: i.enabled });
+    r(this, "name", "Proxy");
+    r(this, "config");
+    r(this, "queue", []);
+    r(this, "flushTimer");
+    r(this, "batchSize");
+    r(this, "batchInterval");
+    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.flush(!0);
+    }), document.addEventListener("visibilitychange", () => {
+      document.visibilityState === "hidden" && this.flush(!0);
+    }));
+  }
+  async initialize() {
+    this.isEnabled() && this.log("Initialized successfully", { endpoint: this.config.endpoint });
+  }
+  identify(i, e) {
+    this.isEnabled() && (this.queueEvent({
+      type: "identify",
+      userId: i,
+      traits: e
+    }), this.log("Queued identify event", { userId: i, traits: e }));
+  }
+  async track(i, e) {
+    this.isEnabled() && (this.queueEvent({
+      type: "track",
+      event: i,
+      context: this.enrichContext(e)
+    }), this.log("Queued track event", { event: i, context: e }));
+  }
+  pageView(i, e) {
+    this.isEnabled() && (this.queueEvent({
+      type: "pageView",
+      properties: i,
+      context: this.enrichContext(e)
+    }), this.log("Queued page view event", { properties: i, context: e }));
+  }
+  async reset() {
+    this.isEnabled() && (this.queueEvent({
+      type: "reset"
+    }), this.log("Queued reset event"));
+  }
+  async shutdown() {
+    await this.flush(!0), this.log("Shutdown complete");
+  }
+  /**
+   * Manually flush all queued events
+   */
+  async flush(i = !1) {
+    if (this.queue.length === 0) return;
+    const e = [...this.queue];
+    this.queue = [], this.flushTimer && (clearTimeout(this.flushTimer), this.flushTimer = void 0), await this.sendEvents(e, i);
+  }
+  queueEvent(i) {
+    if (this.queue.push(i), this.queue.length >= this.batchSize) {
+      this.flush().catch((e) => {
+        console.error("[Proxy] Failed to flush events:", e);
+      });
+      return;
+    }
+    this.flushTimer || (this.flushTimer = setTimeout(() => {
+      this.flush().catch((e) => {
+        console.error("[Proxy] Failed to flush events:", e);
+      });
+    }, this.batchInterval));
+  }
+  async sendEvents(i, e = !1) {
+    const s = { events: i };
+    if (e && typeof navigator < "u" && navigator.sendBeacon) {
+      const t = new Blob([JSON.stringify(s)], {
+        type: "application/json"
+      });
+      navigator.sendBeacon(this.config.endpoint, t) || console.warn("[Proxy] Failed to send events via beacon");
+      return;
+    }
+    await this.sendWithRetry(s);
+  }
+  async sendWithRetry(i, e = 0) {
+    try {
+      const s = await fetch(this.config.endpoint, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          ...this.config.headers
+        },
+        body: JSON.stringify(i),
+        // Don't include credentials by default
+        credentials: "same-origin"
+      });
+      if (!s.ok)
+        throw new Error(`HTTP ${s.status}: ${s.statusText}`);
+      this.log(`Sent ${i.events.length} events successfully`);
+    } catch (s) {
+      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);
+      }
+      throw console.error("[Proxy] Failed to send events after retries:", s), s;
+    }
+  }
+  calculateRetryDelay(i) {
+    return this.retryBackoff === "exponential" ? this.retryInitialDelay * 2 ** i : this.retryInitialDelay * (i + 1);
+  }
+  enrichContext(i) {
+    return typeof window > "u" ? i || {} : {
+      ...i,
+      page: {
+        path: window.location.pathname,
+        title: document.title,
+        referrer: document.referrer,
+        ...i == null ? void 0 : i.page,
+        url: window.location.href
+      },
+      user: {
+        ...i == null ? void 0 : i.user
+      },
+      device: {
+        ...i == null ? void 0 : i.device,
+        userAgent: navigator.userAgent,
+        language: navigator.language,
+        timezone: Intl.DateTimeFormat().resolvedOptions().timeZone,
+        screen: {
+          width: window.screen.width,
+          height: window.screen.height
+        },
+        viewport: {
+          width: window.innerWidth,
+          height: window.innerHeight
+        }
+      }
+    };
+  }
+}
 export {
-  h as BaseAnalyticsProvider,
-  m as BentoClientProvider,
-  b as PirschClientProvider,
-  y as PostHogClientProvider
+  o as BaseAnalyticsProvider,
+  y as BentoClientProvider,
+  w as PirschClientProvider,
+  E as PostHogClientProvider,
+  m as ProxyProvider
 };

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

@@ -0,0 +1,56 @@
+import { BaseEvent, EventContext } from '../../core/events/types.js';
+import { BaseAnalyticsProvider } from '../base.provider.js';
+import { ProxyBatchConfig, ProxyRetryConfig } from './types.js';
+export interface ProxyProviderConfig {
+    /**
+     * The endpoint to send events to (e.g., '/api/events')
+     */
+    endpoint: string;
+    /**
+     * Batching configuration
+     */
+    batch?: ProxyBatchConfig;
+    /**
+     * Retry configuration
+     */
+    retry?: ProxyRetryConfig;
+    /**
+     * Custom headers to include in requests
+     */
+    headers?: Record<string, string>;
+    /**
+     * Enable debug logging
+     */
+    debug?: boolean;
+    /**
+     * Enable/disable the provider
+     */
+    enabled?: boolean;
+}
+export declare class ProxyProvider extends BaseAnalyticsProvider {
+    name: string;
+    private config;
+    private queue;
+    private flushTimer?;
+    private readonly batchSize;
+    private readonly batchInterval;
+    private readonly retryAttempts;
+    private readonly retryBackoff;
+    private readonly retryInitialDelay;
+    constructor(config: ProxyProviderConfig);
+    initialize(): Promise<void>;
+    identify(userId: string, traits?: Record<string, unknown>): void;
+    track(event: BaseEvent, context?: EventContext): Promise<void>;
+    pageView(properties?: Record<string, unknown>, context?: EventContext): void;
+    reset(): Promise<void>;
+    shutdown(): Promise<void>;
+    /**
+     * Manually flush all queued events
+     */
+    flush(useBeacon?: boolean): Promise<void>;
+    private queueEvent;
+    private sendEvents;
+    private sendWithRetry;
+    private calculateRetryDelay;
+    private enrichContext;
+}

package/dist/providers/proxy/server.d.ts

@@ -0,0 +1,55 @@
+import { ServerAnalytics } from '../../server.js';
+/**
+ * Configuration for ingesting proxy events
+ */
+export interface IngestProxyEventsConfig {
+    /**
+     * Enrich context with server-side data
+     */
+    enrichContext?: (request: Request) => Record<string, unknown>;
+    /**
+     * Extract IP address from request
+     * Default: Uses standard headers (X-Forwarded-For, X-Real-IP)
+     */
+    extractIp?: (request: Request) => string | undefined;
+    /**
+     * Error handler
+     */
+    onError?: (error: unknown) => void;
+}
+/**
+ * Ingests events from ProxyProvider and replays them through server analytics
+ *
+ * @example
+ * ```typescript
+ * // Next.js App Router
+ * export async function POST(req: Request) {
+ *   await ingestProxyEvents(req, serverAnalytics);
+ *   return new Response('OK');
+ * }
+ *
+ * // With custom IP extraction
+ * export async function POST(req: Request) {
+ *   await ingestProxyEvents(req, serverAnalytics, {
+ *     extractIp: (req) => req.headers.get('cf-connecting-ip') // Cloudflare
+ *   });
+ *   return new Response('OK');
+ * }
+ * ```
+ */
+export declare function ingestProxyEvents<TEventMap extends Record<string, Record<string, unknown>> = Record<string, Record<string, unknown>>, TUserTraits extends Record<string, unknown> = Record<string, unknown>>(request: Request, analytics: ServerAnalytics<TEventMap, TUserTraits>, config?: IngestProxyEventsConfig): Promise<void>;
+/**
+ * Creates a Request handler for common frameworks
+ *
+ * @example
+ * ```typescript
+ * // Next.js App Router
+ * export const POST = createProxyHandler(serverAnalytics);
+ *
+ * // With custom config
+ * export const POST = createProxyHandler(serverAnalytics, {
+ *   extractIp: (req) => req.headers.get('cf-connecting-ip')
+ * });
+ * ```
+ */
+export declare function createProxyHandler<TEventMap extends Record<string, Record<string, unknown>> = Record<string, Record<string, unknown>>, TUserTraits extends Record<string, unknown> = Record<string, unknown>>(analytics: ServerAnalytics<TEventMap, TUserTraits>, config?: IngestProxyEventsConfig): (request: Request) => Promise<Response>;

package/dist/providers/proxy/types.d.ts

@@ -0,0 +1,64 @@
+import { BaseEvent, EventContext } from '../../core/events/types.js';
+/**
+ * Proxy event types for batching and sending to server
+ */
+export type ProxyTrackEvent = {
+    type: "track";
+    event: BaseEvent;
+    context?: EventContext;
+};
+export type ProxyIdentifyEvent = {
+    type: "identify";
+    userId: string;
+    traits?: Record<string, unknown>;
+};
+export type ProxyPageViewEvent = {
+    type: "pageView";
+    properties?: Record<string, unknown>;
+    context?: EventContext;
+};
+export type ProxyResetEvent = {
+    type: "reset";
+};
+export type ProxyEvent = ProxyTrackEvent | ProxyIdentifyEvent | ProxyPageViewEvent | ProxyResetEvent;
+/**
+ * Payload sent to the proxy endpoint
+ */
+export interface ProxyPayload {
+    events: ProxyEvent[];
+}
+/**
+ * Configuration for batching behavior
+ */
+export interface ProxyBatchConfig {
+    /**
+     * Maximum number of events before auto-flush
+     * @default 10
+     */
+    size?: number;
+    /**
+     * Maximum time in ms before auto-flush
+     * @default 5000
+     */
+    interval?: number;
+}
+/**
+ * Configuration for retry behavior
+ */
+export interface ProxyRetryConfig {
+    /**
+     * Maximum retry attempts
+     * @default 3
+     */
+    attempts?: number;
+    /**
+     * Backoff strategy
+     * @default 'exponential'
+     */
+    backoff?: "exponential" | "linear";
+    /**
+     * Initial delay in ms
+     * @default 1000
+     */
+    initialDelay?: number;
+}

package/dist/providers/server.d.ts

@@ -5,3 +5,5 @@ export { BentoServerProvider } from './bento/server.js';
 export type { BentoServerConfig, BentoAnalyticsOptions } from './bento/server.js';
 export { PirschServerProvider } from './pirsch/server.js';
 export type { PirschServerConfig } from './pirsch/server.js';
+export { ingestProxyEvents, createProxyHandler } from './proxy/server.js';
+export type { IngestProxyEventsConfig } from './proxy/server.js';

package/dist/providers/server.js

@@ -1,100 +1,100 @@
-var g = Object.defineProperty;
-var p = (o, h, e) => h in o ? g(o, h, { enumerable: !0, configurable: !0, writable: !0, value: e }) : o[h] = e;
-var n = (o, h, e) => p(o, typeof h != "symbol" ? h + "" : h, e);
-import { B as f } from "../base.provider-AfFL5W_P.js";
-import { P as k } from "../server-DjEk1fUD.js";
-class b extends f {
-  constructor(e) {
-    super({ debug: e.debug, enabled: e.enabled });
-    n(this, "name", "Bento-Server");
-    n(this, "client");
-    n(this, "initialized", !1);
-    n(this, "config");
-    n(this, "currentUserEmail");
-    this.config = e;
+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 {
+  constructor(i) {
+    super({ debug: i.debug, enabled: i.enabled });
+    d(this, "name", "Bento-Server");
+    d(this, "client");
+    d(this, "initialized", !1);
+    d(this, "config");
+    d(this, "currentUserEmail");
+    this.config = i;
   }
   async initialize() {
-    var e, i;
+    var i, e;
     if (this.isEnabled() && !this.initialized) {
       if (!this.config.siteUuid || typeof this.config.siteUuid != "string")
         throw new Error("Bento requires a siteUuid");
-      if (!((e = this.config.authentication) != null && e.publishableKey) || typeof this.config.authentication.publishableKey != "string")
+      if (!((i = this.config.authentication) != null && i.publishableKey) || typeof this.config.authentication.publishableKey != "string")
         throw new Error("Bento requires authentication.publishableKey");
-      if (!((i = this.config.authentication) != null && i.secretKey) || typeof this.config.authentication.secretKey != "string")
+      if (!((e = this.config.authentication) != null && e.secretKey) || typeof this.config.authentication.secretKey != "string")
         throw new Error("Bento requires authentication.secretKey");
       try {
-        const { Analytics: r } = await import("../bento-node-sdk.esm-C4HG7SVz.js"), { debug: a, enabled: s, ...l } = this.config;
-        this.client = new r(l), this.initialized = !0, this.log("Initialized successfully", {
+        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", {
           siteUuid: this.config.siteUuid
         });
-      } catch (r) {
+      } catch (s) {
         throw console.error(
           "[Bento-Server] Failed to initialize. Make sure @bentonow/bento-node-sdk is installed:",
-          r
-        ), r;
+          s
+        ), s;
       }
     }
   }
-  identify(e, i) {
+  identify(i, e) {
     if (!this.isEnabled() || !this.initialized || !this.client) return;
-    const r = (i == null ? void 0 : i.email) || e;
-    this.currentUserEmail = r;
-    const a = i ? { ...i } : {};
+    const s = (e == null ? void 0 : e.email) || i;
+    this.currentUserEmail = s;
+    const a = e ? { ...e } : {};
     delete a.email, this.client.V1.addSubscriber({
-      email: r,
+      email: s,
       fields: a
-    }).catch((s) => {
-      console.error("[Bento-Server] Failed to identify user:", s);
-    }), this.log("Identified user", { userId: e, email: r, traits: i });
+    }).catch((t) => {
+      console.error("[Bento-Server] Failed to identify user:", t);
+    }), this.log("Identified user", { userId: i, email: s, traits: e });
   }
-  async track(e, i) {
-    var l, t, d;
+  async track(i, e) {
+    var o, r, h;
     if (!this.isEnabled() || !this.initialized || !this.client) return;
-    const r = ((l = i == null ? void 0 : i.user) == null ? void 0 : l.email) || this.currentUserEmail || ((t = i == null ? void 0 : i.user) == null ? void 0 : t.userId) || e.userId || "anonymous@unknown.com", a = {
-      ...e.properties,
-      category: e.category,
-      timestamp: e.timestamp || Date.now(),
-      ...e.sessionId && { sessionId: e.sessionId },
-      ...(i == null ? void 0 : i.page) && {
+    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 = {
+      ...i.properties,
+      category: i.category,
+      timestamp: i.timestamp || Date.now(),
+      ...i.sessionId && { sessionId: i.sessionId },
+      ...(e == null ? void 0 : e.page) && {
         page: {
-          path: i.page.path,
-          title: i.page.title,
-          referrer: i.page.referrer
+          path: e.page.path,
+          title: e.page.title,
+          referrer: e.page.referrer
         }
       },
-      ...(i == null ? void 0 : i.device) && { device: i.device },
-      ...(i == null ? void 0 : i.utm) && { utm: i.utm }
-    }, s = ((d = i == null ? void 0 : i.user) == null ? void 0 : d.traits) || {};
+      ...(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) || {};
     try {
       await this.client.V1.track({
-        email: r,
-        type: `$${e.action}`,
+        email: s,
+        type: `$${i.action}`,
         details: a,
-        fields: s
-      }), this.log("Tracked event", { event: e, context: i });
-    } catch (c) {
-      console.error("[Bento-Server] Failed to track event:", c);
+        fields: t
+      }), this.log("Tracked event", { event: i, context: e });
+    } catch (u) {
+      console.error("[Bento-Server] Failed to track event:", u);
     }
   }
-  pageView(e, i) {
-    var l, t;
+  pageView(i, e) {
+    var o, r;
     if (!this.isEnabled() || !this.initialized || !this.client) return;
-    const r = ((l = i == null ? void 0 : i.user) == null ? void 0 : l.email) || this.currentUserEmail || "anonymous@unknown.com", a = {
-      ...e,
-      ...(i == null ? void 0 : i.page) && {
-        path: i.page.path,
-        title: i.page.title,
-        referrer: i.page.referrer
+    const s = ((o = e == null ? void 0 : e.user) == null ? void 0 : o.email) || this.currentUserEmail || "anonymous@unknown.com", a = {
+      ...i,
+      ...(e == null ? void 0 : e.page) && {
+        path: e.page.path,
+        title: e.page.title,
+        referrer: e.page.referrer
       }
-    }, s = ((t = i == null ? void 0 : i.user) == null ? void 0 : t.traits) || {};
+    }, t = ((r = e == null ? void 0 : e.user) == null ? void 0 : r.traits) || {};
     this.client.V1.track({
-      email: r,
+      email: s,
       type: "$pageview",
       details: a,
-      fields: s
-    }).catch((d) => {
-      console.error("[Bento-Server] Failed to track page view:", d);
-    }), this.log("Tracked page view", { properties: e, context: i });
+      fields: t
+    }).catch((h) => {
+      console.error("[Bento-Server] Failed to track page view:", h);
+    }), this.log("Tracked page view", { properties: i, context: e });
   }
   async reset() {
     !this.isEnabled() || !this.initialized || !this.client || (this.currentUserEmail = void 0, this.log("Reset user session"));
@@ -103,14 +103,14 @@ class b extends f {
     this.client = void 0, this.initialized = !1, this.log("Shutdown complete");
   }
 }
-class w extends f {
-  constructor(e) {
-    super({ debug: e.debug, enabled: e.enabled });
-    n(this, "name", "Pirsch-Server");
-    n(this, "client");
-    n(this, "initialized", !1);
-    n(this, "config");
-    this.config = e;
+class E extends p {
+  constructor(i) {
+    super({ debug: i.debug, enabled: i.enabled });
+    d(this, "name", "Pirsch-Server");
+    d(this, "client");
+    d(this, "initialized", !1);
+    d(this, "config");
+    this.config = i;
   }
   async initialize() {
     if (this.isEnabled() && !this.initialized) {
@@ -119,106 +119,189 @@ class w extends f {
       if (!this.config.clientSecret || typeof this.config.clientSecret != "string")
         throw new Error("Pirsch requires a clientSecret (or access key)");
       try {
-        const { Pirsch: e } = await import("../index-bgxxv-IJ.js").then((s) => s.i), { debug: i, enabled: r, ...a } = this.config;
-        this.client = new e(a), this.initialized = !0, this.log("Initialized successfully", {
+        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", {
           hostname: this.config.hostname
         });
-      } catch (e) {
+      } catch (i) {
         throw console.error(
           "[Pirsch-Server] Failed to initialize. Make sure pirsch-sdk is installed:",
-          e
-        ), e;
+          i
+        ), i;
       }
     }
   }
-  identify(e, i) {
+  identify(i, e) {
     if (!this.isEnabled() || !this.initialized || !this.client) return;
-    const r = {
+    const s = {
       url: "https://identify",
       ip: "0.0.0.0",
       user_agent: "analytics-library"
     }, a = {
-      userId: e,
-      ...i && Object.fromEntries(
-        Object.entries(i).filter(
-          ([, s]) => typeof s == "string" || typeof s == "number" || typeof s == "boolean"
+      userId: i,
+      ...e && Object.fromEntries(
+        Object.entries(e).filter(
+          ([, t]) => typeof t == "string" || typeof t == "number" || typeof t == "boolean"
         )
       )
     };
-    this.client.event("user_identified", r, 0, a).catch((s) => {
-      console.error("[Pirsch-Server] Failed to track identify event:", s);
-    }), this.log("Identified user via event", { userId: e, traits: i });
+    this.client.event("user_identified", s, 0, a).catch((t) => {
+      console.error("[Pirsch-Server] Failed to track identify event:", t);
+    }), this.log("Identified user via event", { userId: i, traits: e });
   }
-  async track(e, i) {
-    var l, t, d, c;
+  async track(i, e) {
+    var o, r, h, u;
     if (!this.isEnabled() || !this.initialized || !this.client) return;
-    const r = {
-      url: ((l = i == null ? void 0 : i.page) == null ? void 0 : l.path) || "https://event",
+    const s = {
+      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
-      ...((t = i == null ? void 0 : i.page) == null ? void 0 : t.title) && { title: i.page.title },
-      ...((d = i == null ? void 0 : i.page) == null ? void 0 : d.referrer) && { referrer: i.page.referrer }
-    }, s = {
+      ...((r = e == null ? void 0 : e.page) == null ? void 0 : r.title) && { title: e.page.title },
+      ...((h = e == null ? void 0 : e.page) == null ? void 0 : h.referrer) && { referrer: e.page.referrer }
+    }, t = {
       ...Object.fromEntries(
-        Object.entries(e.properties).filter(
-          ([, u]) => typeof u == "string" || typeof u == "number" || typeof u == "boolean"
+        Object.entries(i.properties).filter(
+          ([, c]) => typeof c == "string" || typeof c == "number" || typeof c == "boolean"
         )
       ),
-      category: e.category,
-      timestamp: String(e.timestamp || Date.now()),
-      ...e.userId && { userId: e.userId },
-      ...e.sessionId && { sessionId: e.sessionId },
-      ...((c = i == null ? void 0 : i.user) == null ? void 0 : c.email) && { user_email: i.user.email }
+      category: i.category,
+      timestamp: String(i.timestamp || Date.now()),
+      ...i.userId && { userId: i.userId },
+      ...i.sessionId && { sessionId: i.sessionId },
+      ...((u = e == null ? void 0 : e.user) == null ? void 0 : u.email) && { user_email: e.user.email }
     };
     try {
-      await this.client.event(e.action, r, 0, s), this.log("Tracked event", { event: e, context: i });
-    } catch (u) {
-      console.error("[Pirsch-Server] Failed to track event:", u);
+      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);
     }
   }
-  pageView(e, i) {
-    var a, s, l;
+  pageView(i, e) {
+    var a, t, o;
     if (!this.isEnabled() || !this.initialized || !this.client) return;
-    const r = {
-      url: ((a = i == null ? void 0 : i.page) == null ? void 0 : a.path) || "https://pageview",
+    const s = {
+      url: ((a = e == null ? void 0 : e.page) == null ? void 0 : a.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
-      ...((s = i == null ? void 0 : i.page) == null ? void 0 : s.title) && { title: i.page.title },
-      ...((l = i == null ? void 0 : i.page) == null ? void 0 : l.referrer) && { referrer: i.page.referrer },
-      ...e && {
+      ...((t = e == null ? void 0 : e.page) == null ? void 0 : t.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(e).filter(
-            ([, t]) => typeof t == "string" || typeof t == "number" || typeof t == "boolean"
+          Object.entries(i).filter(
+            ([, r]) => typeof r == "string" || typeof r == "number" || typeof r == "boolean"
           )
         )
       }
     };
-    this.client.hit(r).catch((t) => {
-      console.error("[Pirsch-Server] Failed to track page view:", t);
-    }), this.log("Tracked page view", { properties: e, context: i });
+    this.client.hit(s).catch((r) => {
+      console.error("[Pirsch-Server] Failed to track page view:", r);
+    }), this.log("Tracked page view", { properties: i, context: e });
   }
   async reset() {
     if (!this.isEnabled() || !this.initialized || !this.client) return;
-    const e = {
+    const i = {
       url: "https://session-reset",
       ip: "0.0.0.0",
       user_agent: "analytics-library"
     };
-    await this.client.event("session_reset", e, 0, {}).catch((i) => {
-      console.error("[Pirsch-Server] Failed to track session reset:", i);
+    await this.client.event("session_reset", i, 0, {}).catch((e) => {
+      console.error("[Pirsch-Server] Failed to track session reset:", e);
     }), this.log("Reset user session");
   }
   async shutdown() {
     this.client = void 0, this.initialized = !1, this.log("Shutdown complete");
   }
 }
+async function g(l, n, i) {
+  var e, s;
+  try {
+    const a = await l.json();
+    if (!a.events || !Array.isArray(a.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)
+      try {
+        switch (r.type) {
+          case "track": {
+            const h = {
+              ...r.context,
+              ...o,
+              device: {
+                ...(e = r.context) == null ? void 0 : e.device,
+                // Add IP (using type assertion for extended fields)
+                ...t ? { ip: t } : {}
+              }
+            };
+            await n.track(r.event.action, r.event.properties, {
+              userId: r.event.userId,
+              sessionId: r.event.sessionId,
+              context: h
+            });
+            break;
+          }
+          case "identify": {
+            n.identify(r.userId, r.traits);
+            break;
+          }
+          case "pageView": {
+            const h = {
+              ...r.context,
+              ...o,
+              device: {
+                ...(s = r.context) == null ? void 0 : s.device,
+                // Add IP (using type assertion for extended fields)
+                ...t ? { ip: t } : {}
+              }
+            };
+            n.pageView(r.properties, h);
+            break;
+          }
+          case "reset":
+            break;
+          default:
+            console.warn("[Proxy] Unknown event type:", r);
+        }
+      } 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;
+  }
+}
+function m(l) {
+  var i;
+  const n = [
+    "x-forwarded-for",
+    "x-real-ip",
+    "cf-connecting-ip",
+    // Cloudflare
+    "x-client-ip",
+    "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();
+  }
+}
+function k(l, n) {
+  return async (i) => {
+    try {
+      return await g(i, l, n), new Response("OK", { status: 200 });
+    } catch (e) {
+      return console.error("[Proxy] Handler error:", e), new Response("Internal Server Error", { status: 500 });
+    }
+  };
+}
 export {
-  f as BaseAnalyticsProvider,
-  b as BentoServerProvider,
-  w as PirschServerProvider,
-  k as PostHogServerProvider
+  p as BaseAnalyticsProvider,
+  v as BentoServerProvider,
+  E as PirschServerProvider,
+  z as PostHogServerProvider,
+  k as createProxyHandler,
+  g as ingestProxyEvents
 };

package/package.json

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