@outlit/browser 1.4.1 → 1.4.5

package/dist/react/index.mjs

@@ -1,9 +1,11 @@
+// src/react/hooks.ts
+import { useCallback as useCallback2, useContext } from "react";
+
 // src/react/provider.tsx
 import { createContext, useCallback, useEffect, useRef, useState } from "react";
 
 // src/tracker.ts
 import {
-  DEFAULT_API_HOST,
   buildBillingEvent,
   buildCalendarEvent,
   buildCustomEvent,
@@ -11,7 +13,9 @@ import {
   buildIdentifyEvent,
   buildIngestPayload,
   buildPageviewEvent,
-  buildStageEvent
+  buildStageEvent,
+  DEFAULT_API_HOST,
+  validateCustomerIdentity
 } from "@outlit/core";
 
 // src/autocapture.ts
@@ -655,11 +659,23 @@ var Outlit = class {
   currentUser = null;
   pendingUser = null;
   pendingStageEvents = [];
+  exitCleanups = [];
   constructor(options) {
     this.publicKey = options.publicKey;
     this.apiHost = options.apiHost ?? DEFAULT_API_HOST;
     this.flushInterval = options.flushInterval ?? 5e3;
     this.options = options;
+    const isDev = typeof window !== "undefined" && typeof process !== "undefined" && process.env?.NODE_ENV !== "production";
+    if (isDev) {
+      const key = `__outlit_${options.publicKey}`;
+      if (window[key]) {
+        console.warn(
+          "[Outlit] Multiple instances created with the same key. If using HMR, this is expected. Otherwise, use init() for singleton behavior or call shutdown() on the previous instance."
+        );
+      }
+      ;
+      window[key] = true;
+    }
     if (typeof window !== "undefined") {
       const handleExit = () => {
         if (this.hasHandledExit) return;
@@ -667,15 +683,21 @@ var Outlit = class {
         this.sessionTracker?.emitEngagement();
         this.flush();
       };
-      document.addEventListener("visibilitychange", () => {
+      const visibilityHandler = () => {
         if (document.visibilityState === "hidden") {
           handleExit();
         } else {
           this.hasHandledExit = false;
         }
-      });
+      };
+      document.addEventListener("visibilitychange", visibilityHandler);
       window.addEventListener("pagehide", handleExit);
       window.addEventListener("beforeunload", handleExit);
+      this.exitCleanups = [
+        () => document.removeEventListener("visibilitychange", visibilityHandler),
+        () => window.removeEventListener("pagehide", handleExit),
+        () => window.removeEventListener("beforeunload", handleExit)
+      ];
     }
     this.isInitialized = true;
     const consent = getConsentState();
@@ -778,11 +800,19 @@ var Outlit = class {
       console.warn("[Outlit] Tracking not enabled. Call enableTracking() first.");
       return;
     }
+    if (!options.email && !options.userId) {
+      console.warn("[Outlit] identify requires email or userId");
+      return;
+    }
     if (options.email || options.userId) {
       const hadNoUser = !this.currentUser;
       this.currentUser = {
         email: options.email,
-        userId: options.userId
+        userId: options.userId,
+        customerId: options.customerId,
+        customerDomain: options.customerDomain,
+        customerTraits: options.customerTraits,
+        traits: options.traits
       };
       if (hadNoUser) {
         this.flushPendingStageEvents();
@@ -793,6 +823,9 @@ var Outlit = class {
       referrer: document.referrer,
       email: options.email,
       userId: options.userId,
+      customerId: options.customerId,
+      customerDomain: options.customerDomain,
+      customerTraits: options.customerTraits,
       traits: options.traits
     });
     this.enqueue(event);
@@ -834,7 +867,14 @@ var Outlit = class {
    */
   applyUser(identity) {
     this.currentUser = identity;
-    this.identify({ email: identity.email, userId: identity.userId, traits: identity.traits });
+    this.identify({
+      email: identity.email,
+      userId: identity.userId,
+      traits: identity.traits,
+      customerId: identity.customerId,
+      customerDomain: identity.customerDomain,
+      customerTraits: identity.customerTraits
+    });
     this.flushPendingStageEvents();
   }
   /**
@@ -902,11 +942,23 @@ var Outlit = class {
       console.warn("[Outlit] Tracking not enabled. Call enableTracking() first.");
       return;
     }
+    try {
+      validateCustomerIdentity(
+        options.customerId,
+        options.customerDomain,
+        options.domain,
+        options.stripeCustomerId
+      );
+    } catch (error) {
+      console.warn("[Outlit]", error instanceof Error ? error.message : error);
+      return;
+    }
     const event = buildBillingEvent({
       url: window.location.href,
       referrer: document.referrer,
       status,
       customerId: options.customerId,
+      customerDomain: options.customerDomain,
       stripeCustomerId: options.stripeCustomerId,
       domain: options.domain,
       properties: options.properties
@@ -941,6 +993,13 @@ var Outlit = class {
     stopCalendarTracking();
     stopSessionTracking();
     this.sessionTracker = null;
+    for (const cleanup of this.exitCleanups) {
+      cleanup();
+    }
+    this.exitCleanups = [];
+    if (typeof window !== "undefined" && typeof process !== "undefined" && process.env?.NODE_ENV !== "production") {
+      delete window[`__outlit_${this.publicKey}`];
+    }
     await this.flush();
   }
   // ============================================
@@ -1017,12 +1076,47 @@ var Outlit = class {
       this.flush();
     }, this.flushInterval);
   }
+  getPayloadUserIdentity() {
+    if (!this.currentUser) {
+      return void 0;
+    }
+    const { email, userId } = this.currentUser;
+    if (!email && !userId) {
+      return void 0;
+    }
+    return {
+      ...email && { email },
+      ...userId && { userId }
+    };
+  }
+  getPayloadCustomerIdentity() {
+    if (!this.currentUser) {
+      return void 0;
+    }
+    const { customerId, customerDomain } = this.currentUser;
+    if (!customerId && !customerDomain) {
+      return void 0;
+    }
+    return {
+      ...customerId && { customerId },
+      ...customerDomain && { customerDomain }
+    };
+  }
   async sendEvents(events) {
     if (events.length === 0) return;
     if (!this.visitorId) return;
-    const userIdentity = this.currentUser ?? void 0;
+    const userIdentity = this.getPayloadUserIdentity();
+    const customerIdentity = this.getPayloadCustomerIdentity();
     const sessionId = this.sessionTracker?.getSessionId();
-    const payload = buildIngestPayload(this.visitorId, "client", events, userIdentity, sessionId);
+    const payload = buildIngestPayload(
+      this.visitorId,
+      "client",
+      events,
+      userIdentity,
+      sessionId,
+      void 0,
+      customerIdentity
+    );
     const url = `${this.apiHost}/api/i/v1/${this.publicKey}/events`;
     try {
       if (typeof navigator !== "undefined" && navigator.sendBeacon) {
@@ -1073,7 +1167,7 @@ function OutlitProvider(props) {
   useEffect(() => {
     if (initializedRef.current) return;
     if (props.client) {
-      if (process.env.NODE_ENV !== "production") {
+      if (typeof process !== "undefined" && process.env?.NODE_ENV !== "production") {
         const configKeys = [
           "publicKey",
           "apiHost",
@@ -1171,7 +1265,6 @@ function OutlitProvider(props) {
 }
 
 // src/react/hooks.ts
-import { useCallback as useCallback2, useContext } from "react";
 function useOutlit() {
   const { outlit, isInitialized, isTrackingEnabled, enableTracking, disableTracking } = useContext(OutlitContext);
   const track = useCallback2(