@wireai/activation 0.11.0 → 0.12.1

package/dist/analytics/index.js

@@ -413,6 +413,23 @@ var buildEventsRequest = (target, events) => {
     return null;
   }
 };
+var warnOnSkippedEvents = (res) => {
+  if (typeof __DEV__ === "undefined" || !__DEV__) return;
+  if (typeof console === "undefined" || !console.warn) return;
+  try {
+    const json = res == null ? void 0 : res.json;
+    if (typeof json !== "function") return;
+    void Promise.resolve(json.call(res)).then((body) => {
+      const skipped = body == null ? void 0 : body.skipped;
+      if (typeof skipped !== "number" || skipped <= 0) return;
+      console.warn(
+        `[wireai] the server ACCEPTED the /v1/events POST but DISCARDED ${skipped} event(s) (skipped in the response body) \u2014 they are gone, not retried. The usual cause is an event with a missing or empty session_id.`
+      );
+    }).catch(() => {
+    });
+  } catch {
+  }
+};
 var reportClientEvents = (target, events) => {
   try {
     const req = buildEventsRequest(target, events);
@@ -435,15 +452,54 @@ var reportClientEventsAwait = async (target, events) => {
 };
 var reportClientEventAwait = (target, event) => reportClientEventsAwait(target, [event]);
 
+// src/analytics/currentSession.ts
+var CURRENT_SESSION_ID_SLOT = /* @__PURE__ */ Symbol.for(
+  "@wireai/activation:currentSessionId"
+);
+var globalSlot = globalThis;
+var setCurrentSessionId = (id) => {
+  if (typeof id === "string" && id.length > 0) {
+    globalSlot[CURRENT_SESSION_ID_SLOT] = id;
+  }
+};
+var getCurrentSessionId = () => globalSlot[CURRENT_SESSION_ID_SLOT];
+var resetCurrentSessionId = () => {
+  globalSlot[CURRENT_SESSION_ID_SLOT] = void 0;
+};
+var warnInDev = (message) => {
+  if (typeof __DEV__ !== "undefined" && __DEV__ && typeof console !== "undefined" && console.warn) {
+    console.warn(message);
+    return true;
+  }
+  return false;
+};
+var MINT_WARNING = "[wireai] No app-open session was registered, so a session id was minted for this event (the server drops an event that has no session_id, and still answers 200). Mount useLifecycleEvents at your app root so events correlate to a real app-open.";
+var MINT_WARNED_SLOT = /* @__PURE__ */ Symbol.for(
+  "@wireai/activation:currentSessionIdMintWarned"
+);
+var warnSlot = globalThis;
+var ensureCurrentSessionId = () => {
+  const existing = globalSlot[CURRENT_SESSION_ID_SLOT];
+  if (typeof existing === "string" && existing.length > 0) return existing;
+  const minted = makeSessionId();
+  globalSlot[CURRENT_SESSION_ID_SLOT] = minted;
+  if (!warnSlot[MINT_WARNED_SLOT] && warnInDev(MINT_WARNING)) {
+    warnSlot[MINT_WARNED_SLOT] = true;
+  }
+  return minted;
+};
+
 // src/reviews/transport.ts
 var reportAppEvent = (target, name2, options = {}) => {
+  var _a2;
   if (!(target == null ? void 0 : target.serverUrl) || !name2) return;
   try {
+    const supplied = (_a2 = options.sessionId) != null ? _a2 : "";
     const event = {
       event_type: "app_event",
-      question_key: name2
+      question_key: name2,
+      session_id: supplied.trim().length > 0 ? supplied : ensureCurrentSessionId()
     };
-    if (options.sessionId) event.session_id = options.sessionId;
     if (options.deviceKey) event.user_context = { device_key: options.deviceKey };
     if (options.meta && Object.keys(options.meta).length > 0) {
       event.meta = JSON.stringify(options.meta);
@@ -879,6 +935,7 @@ var createEventQueue = (options) => {
     const timer = setTimeout(() => controller == null ? void 0 : controller.abort(), 15e3);
     try {
       const res = await fetch(req.url, { ...req.init, signal: controller == null ? void 0 : controller.signal });
+      warnOnSkippedEvents(res);
       return !!(res && res.ok);
     } catch {
       return false;
@@ -957,21 +1014,6 @@ var createEventQueue = (options) => {
   return { enqueue, flush, notifyOnline, size };
 };
 
-// src/analytics/currentSession.ts
-var CURRENT_SESSION_ID_SLOT = /* @__PURE__ */ Symbol.for(
-  "@wireai/activation:currentSessionId"
-);
-var globalSlot = globalThis;
-var setCurrentSessionId = (id) => {
-  if (typeof id === "string" && id.length > 0) {
-    globalSlot[CURRENT_SESSION_ID_SLOT] = id;
-  }
-};
-var getCurrentSessionId = () => globalSlot[CURRENT_SESSION_ID_SLOT];
-var resetCurrentSessionId = () => {
-  globalSlot[CURRENT_SESSION_ID_SLOT] = void 0;
-};
-
 // src/identity/userIdentity.ts
 var USER_ID_MAX_LENGTH = 128;
 var sanitizeUserId = (raw) => {
@@ -1068,34 +1110,90 @@ var mintDeviceId = () => {
   const time = Date.now().toString(36);
   return `${AUTO_DEVICE_ID_PREFIX}${time}_${randomChunk()}${randomChunk()}`;
 };
+var AUTO_DEVICE_KEY_SLOT = /* @__PURE__ */ Symbol.for("@wireai/activation:autoDeviceKeys");
+var deviceKeyGlobal = globalThis;
+var autoDeviceKeyRegistry = () => {
+  const existing = deviceKeyGlobal[AUTO_DEVICE_KEY_SLOT];
+  if (existing) return existing;
+  const created = { keys: /* @__PURE__ */ new Map(), hydrating: /* @__PURE__ */ new Set() };
+  deviceKeyGlobal[AUTO_DEVICE_KEY_SLOT] = created;
+  return created;
+};
+var startHydration = (registry, appId, storage, minted) => {
+  if (!registry.pending) registry.pending = /* @__PURE__ */ new Map();
+  const existing = registry.pending.get(appId);
+  if (existing) return existing;
+  const slot = deviceIdStorageKey(appId);
+  const settled = () => {
+    var _a2;
+    return (_a2 = registry.keys.get(appId)) != null ? _a2 : minted;
+  };
+  let run;
+  try {
+    run = Promise.resolve(storage.getItem(slot)).then((saved) => {
+      const persisted = typeof saved === "string" && saved.trim() ? saved.trim() : void 0;
+      if (persisted) {
+        registry.keys.set(appId, persisted);
+        return persisted;
+      }
+      return Promise.resolve(storage.setItem(slot, minted)).then(settled, settled);
+    }).catch(settled);
+  } catch {
+    run = Promise.resolve(settled());
+  }
+  registry.pending.set(appId, run);
+  return run;
+};
+var resolveAutoDeviceKey = (opts = {}) => {
+  var _a2, _b;
+  const registry = autoDeviceKeyRegistry();
+  const appId = (_a2 = opts.appId) != null ? _a2 : "default";
+  let id = registry.keys.get(appId);
+  if (!id) {
+    id = mintDeviceId();
+    registry.keys.set(appId, id);
+  }
+  const storage = opts.storage;
+  if (storage && !registry.hydrating.has(appId)) {
+    registry.hydrating.add(appId);
+    void startHydration(registry, appId, storage, id);
+  }
+  return (_b = registry.keys.get(appId)) != null ? _b : id;
+};
+var resetAutoDeviceKeys = () => {
+  var _a2;
+  const registry = autoDeviceKeyRegistry();
+  registry.keys.clear();
+  registry.hydrating.clear();
+  (_a2 = registry.pending) == null ? void 0 : _a2.clear();
+};
 
 // src/analytics/analyticsFacade.ts
-var warnInDev = (message) => {
+var warnInDev2 = (message) => {
   if (typeof __DEV__ !== "undefined" && __DEV__ && typeof console !== "undefined" && console.warn) {
     console.warn(message);
   }
 };
 var createAnalytics = (config, options = {}) => {
-  var _a2, _b, _c, _d;
-  const instanceSessionId = (_a2 = config.sessionId) != null ? _a2 : makeSessionId();
+  var _a2, _b, _c;
   const resolveSessionId = () => {
-    var _a3, _b2;
-    return (_b2 = (_a3 = config.sessionId) != null ? _a3 : getCurrentSessionId()) != null ? _b2 : instanceSessionId;
+    var _a3;
+    return (_a3 = config.sessionId) != null ? _a3 : ensureCurrentSessionId();
   };
-  let userContext = { ...(_b = config.userContext) != null ? _b : {} };
-  const hostDeviceKeyAtInit = typeof ((_c = config.userContext) == null ? void 0 : _c.deviceKey) === "string" && config.userContext.deviceKey.trim() ? config.userContext.deviceKey.trim() : void 0;
-  let autoDeviceKey = mintDeviceId();
-  if (config.storage && !hostDeviceKeyAtInit) {
-    const storage = config.storage;
-    const deviceKey = deviceIdStorageKey(config.appId);
-    void storage.getItem(deviceKey).then((saved) => {
-      const persisted = typeof saved === "string" && saved.trim() ? saved.trim() : void 0;
-      if (persisted) autoDeviceKey = persisted;
-      else void storage.setItem(deviceKey, autoDeviceKey).catch(() => {
-      });
-    }).catch(() => {
-    });
+  if (config.sessionId) {
+    warnInDev2(
+      "[wireai] createAnalytics({ sessionId }) PINS every event from this instance to that one frozen id and opts out of the live per-open session (app.session_started) \u2014 lifecycle analytics collapse onto a single device-scoped id. Remove it unless your host runs its own session lifecycle."
+    );
   }
+  const detectedAppVersion = detectAppVersion();
+  let userContext = { ...(_a2 = config.userContext) != null ? _a2 : {} };
+  const hostDeviceKeyAtInit = typeof ((_b = config.userContext) == null ? void 0 : _b.deviceKey) === "string" && config.userContext.deviceKey.trim() ? config.userContext.deviceKey.trim() : void 0;
+  const autoDeviceKeyOptions = {
+    appId: config.appId,
+    // A host-supplied deviceKey opts out of minting AND persisting (unchanged contract).
+    storage: hostDeviceKeyAtInit ? void 0 : config.storage
+  };
+  if (!hostDeviceKeyAtInit) resolveAutoDeviceKey(autoDeviceKeyOptions);
   const envelope = () => {
     var _a3;
     return buildContextEnvelope({
@@ -1112,7 +1210,7 @@ var createAnalytics = (config, options = {}) => {
     envelope,
     ...options
   });
-  let boundUserId = sanitizeUserId((_d = config.userContext) == null ? void 0 : _d.userId);
+  let boundUserId = sanitizeUserId((_c = config.userContext) == null ? void 0 : _c.userId);
   const storageKey = analyticsUserIdStorageKey(config.appId);
   if (config.storage) {
     void config.storage.getItem(storageKey).then((saved) => {
@@ -1121,20 +1219,21 @@ var createAnalytics = (config, options = {}) => {
     });
   }
   const applyContext = (event) => {
-    var _a3;
+    var _a3, _b2;
     const hostDeviceKey = typeof userContext.deviceKey === "string" && userContext.deviceKey.trim() ? userContext.deviceKey : void 0;
     const resolved = resolveUserContext(
-      { ...userContext, deviceKey: hostDeviceKey != null ? hostDeviceKey : autoDeviceKey },
-      { autoAppVersion: config.appVersion }
+      // `??` is lazy on purpose: a host-supplied key must never even touch the auto registry.
+      { ...userContext, deviceKey: hostDeviceKey != null ? hostDeviceKey : resolveAutoDeviceKey(autoDeviceKeyOptions) },
+      { autoAppVersion: (_a3 = config.appVersion) != null ? _a3 : detectedAppVersion }
     );
     if (resolved.userContext) {
-      event.user_context = { ...resolved.userContext, ...(_a3 = event.user_context) != null ? _a3 : {} };
+      event.user_context = { ...resolved.userContext, ...(_b2 = event.user_context) != null ? _b2 : {} };
     }
     if (boundUserId && !event.user_id) event.user_id = boundUserId;
   };
   const guardUserId = (clean) => {
     if (config.allowEmailAsUserId || !looksLikeEmail(clean)) return clean;
-    warnInDev(
+    warnInDev2(
       "[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;
@@ -1217,6 +1316,7 @@ var createAnalytics = (config, options = {}) => {
   };
 };
 var useAnalytics = (config, options = {}) => {
+  var _a2;
   const ref = react.useRef(void 0);
   const prevKeys = react.useRef("");
   const currentKeys = `${config.serverUrl}|${config.apiKey}|${config.appId}`;
@@ -1224,9 +1324,15 @@ var useAnalytics = (config, options = {}) => {
     prevKeys.current = currentKeys;
     ref.current = createAnalytics(config, options);
   }
+  const hostDeviceKey = typeof ((_a2 = config.userContext) == null ? void 0 : _a2.deviceKey) === "string" && config.userContext.deviceKey.trim() ? config.userContext.deviceKey.trim() : void 0;
+  react.useEffect(() => {
+    var _a3;
+    if (hostDeviceKey) (_a3 = ref.current) == null ? void 0 : _a3.setUserContext({ deviceKey: hostDeviceKey });
+  }, [hostDeviceKey]);
   return ref.current;
 };
 
+exports.AUTO_DEVICE_ID_PREFIX = AUTO_DEVICE_ID_PREFIX;
 exports.WIRE_ONBOARDING_EVENTS = WIRE_ONBOARDING_EVENTS;
 exports.analyticsUserIdStorageKey = analyticsUserIdStorageKey;
 exports.buildContextEnvelope = buildContextEnvelope;
@@ -1235,6 +1341,8 @@ exports.clearUserContext = clearUserContext;
 exports.createAnalytics = createAnalytics;
 exports.createEventQueue = createEventQueue;
 exports.createScreenTracker = createScreenTracker;
+exports.deviceIdStorageKey = deviceIdStorageKey;
+exports.ensureCurrentSessionId = ensureCurrentSessionId;
 exports.getActiveRouteName = getActiveRouteName;
 exports.getCurrentSessionId = getCurrentSessionId;
 exports.looksLikeEmail = looksLikeEmail;
@@ -1244,7 +1352,9 @@ exports.reportClientEvent = reportClientEvent;
 exports.reportClientEventAwait = reportClientEventAwait;
 exports.reportClientEvents = reportClientEvents;
 exports.reportClientEventsAwait = reportClientEventsAwait;
+exports.resetAutoDeviceKeys = resetAutoDeviceKeys;
 exports.resetCurrentSessionId = resetCurrentSessionId;
+exports.resolveAutoDeviceKey = resolveAutoDeviceKey;
 exports.screenTrackingHandler = screenTrackingHandler;
 exports.setCurrentSessionId = setCurrentSessionId;
 exports.toAnalyticsEvent = toAnalyticsEvent;