@wireai/activation 0.10.0 → 0.11.0

package/dist/analytics/index.mjs

@@ -398,13 +398,45 @@ var init_Constants = __esm({
   }
 });
 
-// src/reviews/transport.ts
-var reportAppEvent = (target, name2, options = {}) => {
-  if (!(target == null ? void 0 : target.serverUrl) || !name2) return;
+// src/analytics/reportClientEvent.ts
+var makeSessionId = () => `wire_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;
+var buildEventsRequest = (target, events) => {
+  if (!(target == null ? void 0 : target.serverUrl) || events.length === 0) return null;
   try {
     const url = `${target.serverUrl.replace(/\/$/, "")}/v1/events`;
     const headers = { "Content-Type": "application/json" };
     if (target.apiKey) headers.Authorization = `Bearer ${target.apiKey}`;
+    return { url, init: { method: "POST", headers, body: JSON.stringify({ events }) } };
+  } catch {
+    return null;
+  }
+};
+var reportClientEvents = (target, events) => {
+  try {
+    const req = buildEventsRequest(target, events);
+    if (!req) return;
+    void fetch(req.url, req.init).catch(() => {
+    });
+  } catch {
+  }
+};
+var reportClientEvent = (target, event) => reportClientEvents(target, [event]);
+var reportClientEventsAwait = async (target, events) => {
+  try {
+    const req = buildEventsRequest(target, events);
+    if (!req) return false;
+    const res = await fetch(req.url, req.init);
+    return Boolean(res && res.ok);
+  } catch {
+    return false;
+  }
+};
+var reportClientEventAwait = (target, event) => reportClientEventsAwait(target, [event]);
+
+// src/reviews/transport.ts
+var reportAppEvent = (target, name2, options = {}) => {
+  if (!(target == null ? void 0 : target.serverUrl) || !name2) return;
+  try {
     const event = {
       event_type: "app_event",
       question_key: name2
@@ -414,11 +446,9 @@ var reportAppEvent = (target, name2, options = {}) => {
     if (options.meta && Object.keys(options.meta).length > 0) {
       event.meta = JSON.stringify(options.meta);
     }
-    void fetch(url, {
-      method: "POST",
-      headers,
-      body: JSON.stringify({ events: [event] })
-    }).catch(() => {
+    const req = buildEventsRequest(target, [event]);
+    if (!req) return;
+    void fetch(req.url, req.init).catch(() => {
     });
   } catch {
   }
@@ -495,41 +525,6 @@ var useScreenTracking = (navigationRef, options = {}) => {
   }, [navigationRef]);
 };
 
-// src/analytics/reportClientEvent.ts
-var makeSessionId = () => `wire_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;
-var buildEventsRequest = (target, events) => {
-  if (!(target == null ? void 0 : target.serverUrl) || events.length === 0) return null;
-  try {
-    const url = `${target.serverUrl.replace(/\/$/, "")}/v1/events`;
-    const headers = { "Content-Type": "application/json" };
-    if (target.apiKey) headers.Authorization = `Bearer ${target.apiKey}`;
-    return { url, init: { method: "POST", headers, body: JSON.stringify({ events }) } };
-  } catch {
-    return null;
-  }
-};
-var reportClientEvents = (target, events) => {
-  try {
-    const req = buildEventsRequest(target, events);
-    if (!req) return;
-    void fetch(req.url, req.init).catch(() => {
-    });
-  } catch {
-  }
-};
-var reportClientEvent = (target, event) => reportClientEvents(target, [event]);
-var reportClientEventsAwait = async (target, events) => {
-  try {
-    const req = buildEventsRequest(target, events);
-    if (!req) return false;
-    const res = await fetch(req.url, req.init);
-    return Boolean(res && res.ok);
-  } catch {
-    return false;
-  }
-};
-var reportClientEventAwait = (target, event) => reportClientEventsAwait(target, [event]);
-
 // src/analytics/analyticsEvent.ts
 var WIRE_ONBOARDING_EVENTS = {
   started: "wire_onboarding_started",
@@ -820,6 +815,7 @@ var createEventQueue = (options) => {
     var _a3;
     const env = resolveEnvelope();
     const stamped = { ...event };
+    if (stamped.ts === void 0) stamped.ts = Date.now();
     if (!env) return stamped;
     if (!stamped.device && env.device) stamped.device = env.device;
     if (!stamped.session_id && env.sessionId) stamped.session_id = env.sessionId;
@@ -875,19 +871,12 @@ var createEventQueue = (options) => {
     }
   })();
   const postBatch = async (events) => {
-    if (!(target == null ? void 0 : target.serverUrl) || events.length === 0) return false;
+    const req = buildEventsRequest(target, events);
+    if (!req) return false;
     const controller = typeof AbortController !== "undefined" ? new AbortController() : void 0;
     const timer = setTimeout(() => controller == null ? void 0 : controller.abort(), 15e3);
     try {
-      const url = `${target.serverUrl.replace(/\/$/, "")}/v1/events`;
-      const headers = { "Content-Type": "application/json" };
-      if (target.apiKey) headers.Authorization = `Bearer ${target.apiKey}`;
-      const res = await fetch(url, {
-        method: "POST",
-        headers,
-        body: JSON.stringify({ events }),
-        signal: controller == null ? void 0 : controller.signal
-      });
+      const res = await fetch(req.url, { ...req.init, signal: controller == null ? void 0 : controller.signal });
       return !!(res && res.ok);
     } catch {
       return false;
@@ -989,6 +978,7 @@ var sanitizeUserId = (raw) => {
   if (!trimmed) return void 0;
   return trimmed.length > USER_ID_MAX_LENGTH ? trimmed.slice(0, USER_ID_MAX_LENGTH) : trimmed;
 };
+var looksLikeEmail = (value) => typeof value === "string" && /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(value.trim());
 
 // src/context/userContext.ts
 var EXTRA_KEY_PREFIX = "custom.";
@@ -1023,6 +1013,21 @@ var namespaceExtra = (extra) => {
   }
   return out;
 };
+var analyticsUserIdStorageKey = (appId) => `wireai:analytics:userId:${appId != null ? appId : "default"}`;
+var clearPiiFromContext = (ctx = {}) => {
+  const rest = {};
+  if (typeof ctx.appVersion === "string") rest.appVersion = ctx.appVersion;
+  if (typeof ctx.deviceKey === "string") rest.deviceKey = ctx.deviceKey;
+  return rest;
+};
+var clearUserContext = async (opts = {}) => {
+  const storage = opts.storage;
+  if (!storage) return;
+  try {
+    await storage.removeItem(analyticsUserIdStorageKey(opts.appId));
+  } catch {
+  }
+};
 var resolveUserContext = (ctx = {}, opts = {}) => {
   var _a2;
   const result = {};
@@ -1063,8 +1068,13 @@ var mintDeviceId = () => {
 };
 
 // src/analytics/analyticsFacade.ts
+var warnInDev = (message) => {
+  if (typeof __DEV__ !== "undefined" && __DEV__ && typeof console !== "undefined" && console.warn) {
+    console.warn(message);
+  }
+};
 var createAnalytics = (config, options = {}) => {
-  var _a2, _b, _c, _d, _e;
+  var _a2, _b, _c, _d;
   const instanceSessionId = (_a2 = config.sessionId) != null ? _a2 : makeSessionId();
   const resolveSessionId = () => {
     var _a3, _b2;
@@ -1101,7 +1111,7 @@ var createAnalytics = (config, options = {}) => {
     ...options
   });
   let boundUserId = sanitizeUserId((_d = config.userContext) == null ? void 0 : _d.userId);
-  const storageKey = `wireai:analytics:userId:${(_e = config.appId) != null ? _e : "default"}`;
+  const storageKey = analyticsUserIdStorageKey(config.appId);
   if (config.storage) {
     void config.storage.getItem(storageKey).then((saved) => {
       if (saved && !boundUserId) boundUserId = saved;
@@ -1120,6 +1130,13 @@ var createAnalytics = (config, options = {}) => {
     }
     if (boundUserId && !event.user_id) event.user_id = boundUserId;
   };
+  const guardUserId = (clean) => {
+    if (config.allowEmailAsUserId || !looksLikeEmail(clean)) return clean;
+    warnInDev(
+      "[wireai] identify() was called with an email-shaped id. A raw email must NOT be the opaque user_id (PII leak) \u2014 pass it as userContext.userEmail instead. Binding was skipped. Set allowEmailAsUserId:true on createAnalytics if your user id genuinely is an email."
+    );
+    return void 0;
+  };
   const setUserContext = (partial) => {
     var _a3, _b2;
     if (!partial || typeof partial !== "object") return;
@@ -1128,11 +1145,20 @@ var createAnalytics = (config, options = {}) => {
     if (mergedExtra) userContext.extra = mergedExtra;
     const uid = sanitizeUserId(partial.userId);
     if (uid) {
-      boundUserId = uid;
-      if (config.storage) void config.storage.setItem(storageKey, uid).catch(() => {
-      });
+      const bindable = guardUserId(uid);
+      if (bindable) {
+        boundUserId = bindable;
+        if (config.storage) void config.storage.setItem(storageKey, bindable).catch(() => {
+        });
+      }
     }
   };
+  const reset = () => {
+    boundUserId = void 0;
+    userContext = clearPiiFromContext(userContext);
+    if (config.storage) void config.storage.removeItem(storageKey).catch(() => {
+    });
+  };
   const track = (event, props) => {
     if (!event) return;
     const clientEvent = {
@@ -1159,9 +1185,11 @@ var createAnalytics = (config, options = {}) => {
   const identify = (userId, traits) => {
     const clean = sanitizeUserId(userId);
     if (!clean) return;
-    boundUserId = clean;
+    const bindable = guardUserId(clean);
+    if (!bindable) return;
+    boundUserId = bindable;
     if (config.storage) {
-      void config.storage.setItem(storageKey, clean).catch(() => {
+      void config.storage.setItem(storageKey, bindable).catch(() => {
       });
     }
     const clientEvent = {
@@ -1169,7 +1197,7 @@ var createAnalytics = (config, options = {}) => {
       // Reuse the LIVE per-open session id (see `resolveSessionId`) so the server binds identity to
       // the session it already saw instead of back-filling a phantom `session_started`.
       session_id: resolveSessionId(),
-      user_id: clean
+      user_id: bindable
     };
     if (traits && Object.keys(traits).length > 0) clientEvent.meta = JSON.stringify(traits);
     applyContext(clientEvent);
@@ -1180,6 +1208,7 @@ var createAnalytics = (config, options = {}) => {
     screen,
     identify,
     setUserContext,
+    reset,
     flush: queue.flush,
     notifyOnline: queue.notifyOnline,
     size: queue.size
@@ -1196,6 +1225,6 @@ var useAnalytics = (config, options = {}) => {
   return ref.current;
 };
 
-export { WIRE_ONBOARDING_EVENTS, buildContextEnvelope, createAnalytics, createEventQueue, createScreenTracker, getActiveRouteName, getCurrentSessionId, makeSessionId, reportAppEvent, reportClientEvent, reportClientEventAwait, reportClientEvents, reportClientEventsAwait, resetCurrentSessionId, screenTrackingHandler, setCurrentSessionId, toAnalyticsEvent, useAnalytics, useScreenTracking };
+export { WIRE_ONBOARDING_EVENTS, analyticsUserIdStorageKey, buildContextEnvelope, clearPiiFromContext, clearUserContext, createAnalytics, createEventQueue, createScreenTracker, getActiveRouteName, getCurrentSessionId, looksLikeEmail, makeSessionId, reportAppEvent, reportClientEvent, reportClientEventAwait, reportClientEvents, reportClientEventsAwait, resetCurrentSessionId, screenTrackingHandler, setCurrentSessionId, toAnalyticsEvent, useAnalytics, useScreenTracking };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map