@wireai/activation 0.14.3 → 0.16.0

package/dist/analytics/index.mjs

@@ -8,6 +8,28 @@ var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require
   throw Error('Dynamic require of "' + x + '" is not supported');
 });
 
+// src/utils/withDeadline.ts
+var DEADLINE_EXPIRED = /* @__PURE__ */ Symbol("wire-deadline-expired");
+var DEFAULT_DEADLINE_MS = 15e3;
+var withDeadline = async (exchange, timeoutMs = DEFAULT_DEADLINE_MS) => {
+  const controller = typeof AbortController !== "undefined" ? new AbortController() : void 0;
+  let timer;
+  const expired = new Promise((resolve) => {
+    timer = setTimeout(() => {
+      controller == null ? void 0 : controller.abort();
+      resolve(DEADLINE_EXPIRED);
+    }, timeoutMs);
+  });
+  const running = exchange(controller == null ? void 0 : controller.signal);
+  try {
+    return await Promise.race([running, expired]);
+  } finally {
+    clearTimeout(timer);
+    void running.catch(() => {
+    });
+  }
+};
+
 // src/analytics/reportClientEvent.ts
 var makeSessionId = () => `wire_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;
 var toWireEvents = (events) => events.map((event) => {
@@ -79,14 +101,17 @@ var reportClientEventsOutcome = async (target, events) => {
   try {
     const req = buildEventsRequest(target, events);
     if (!req) return "refused";
-    const res = await fetch(req.url, req.init);
-    if (!res || !res.ok) return "unreachable";
-    const ack = await readEventsAck(res);
-    if (!ack || ack.skipped <= 0) return "delivered";
-    if (typeof __DEV__ !== "undefined" && __DEV__ && typeof console !== "undefined" && console.warn) {
-      console.warn(describeDiscarded(ack));
-    }
-    return "refused";
+    const outcome = await withDeadline(async (signal) => {
+      const res = await fetch(req.url, { ...req.init, signal });
+      if (!res || !res.ok) return "unreachable";
+      const ack = await readEventsAck(res);
+      if (!ack || ack.skipped <= 0) return "delivered";
+      if (typeof __DEV__ !== "undefined" && __DEV__ && typeof console !== "undefined" && console.warn) {
+        console.warn(describeDiscarded(ack));
+      }
+      return "refused";
+    });
+    return outcome === DEADLINE_EXPIRED ? "unreachable" : outcome;
   } catch {
     return "unreachable";
   }
@@ -107,25 +132,51 @@ var CURRENT_SESSION_ID_SLOT = /* @__PURE__ */ Symbol.for(
   "@wireai/activation:currentSessionId"
 );
 var globalSlot = globalThis;
+var SESSION_ID_LISTENERS_SLOT = /* @__PURE__ */ Symbol.for(
+  "@wireai/activation:currentSessionIdListeners"
+);
+var listenerSlot = globalThis;
+var listeners = () => {
+  const existing = listenerSlot[SESSION_ID_LISTENERS_SLOT];
+  if (existing) return existing;
+  const created = /* @__PURE__ */ new Set();
+  listenerSlot[SESSION_ID_LISTENERS_SLOT] = created;
+  return created;
+};
+var writeCurrentSessionId = (id) => {
+  if (globalSlot[CURRENT_SESSION_ID_SLOT] === id) return;
+  globalSlot[CURRENT_SESSION_ID_SLOT] = id;
+  for (const listener of Array.from(listeners())) {
+    try {
+      listener();
+    } catch {
+    }
+  }
+};
 var setCurrentSessionId = (id) => {
   if (typeof id === "string" && id.length > 0) {
-    globalSlot[CURRENT_SESSION_ID_SLOT] = id;
+    writeCurrentSessionId(id);
   }
 };
 var getCurrentSessionId = () => globalSlot[CURRENT_SESSION_ID_SLOT];
 var resetCurrentSessionId = () => {
-  globalSlot[CURRENT_SESSION_ID_SLOT] = void 0;
+  writeCurrentSessionId(void 0);
 };
 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 MINTED_SESSION_ID_SLOT = /* @__PURE__ */ Symbol.for(
+  "@wireai/activation:mintedSessionId"
+);
+var mintedSlot = 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;
+  writeCurrentSessionId(minted);
+  mintedSlot[MINTED_SESSION_ID_SLOT] = minted;
   if (!warnSlot[MINT_WARNED_SLOT] && warnInDev(MINT_WARNING)) {
     warnSlot[MINT_WARNED_SLOT] = true;
   }
@@ -226,6 +277,109 @@ var useScreenTracking = (navigationRef, options = {}) => {
   }, [navigationRef]);
 };
 
+// src/identity/identityRecord.ts
+var IDENTITY_PROVENANCE_SLOT = /* @__PURE__ */ Symbol.for("@wireai/activation:identityProvenance");
+var provenanceGlobal = globalThis;
+var provenanceRegistry = () => {
+  const existing = provenanceGlobal[IDENTITY_PROVENANCE_SLOT];
+  if (existing) return existing;
+  const created = { host: /* @__PURE__ */ new Map() };
+  provenanceGlobal[IDENTITY_PROVENANCE_SLOT] = created;
+  return created;
+};
+var provenanceKey = (space, scope) => `${space}:${scope != null ? scope : "default"}`;
+var isUsableIdentityValue = (value) => typeof value === "string" && value.trim().length > 0;
+var resolveIdentity = (input) => {
+  var _a;
+  if (!isUsableIdentityValue(input.value)) return void 0;
+  const value = input.value.trim();
+  const durable = (_a = input.durable) != null ? _a : input.source === "host";
+  {
+    provenanceRegistry().host.set(provenanceKey(input.space, input.scope), value);
+  }
+  return { value, space: input.space, source: input.source, durable };
+};
+
+// src/context/deviceId.ts
+var AUTO_DEVICE_ID_PREFIX = "wdev_";
+var deviceIdStorageKey = (appId) => `wireai:analytics:deviceKey:${appId != null ? appId : "default"}`;
+var randomChunk = () => Math.floor(Math.random() * 4294967296).toString(36).padStart(6, "0");
+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 degraded = () => {
+    var _a;
+    return { value: (_a = registry.keys.get(appId)) != null ? _a : minted, durable: false };
+  };
+  const adopted = (value) => ({ value, durable: true });
+  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 adopted(persisted);
+      }
+      return Promise.resolve(storage.setItem(slot, minted)).then(
+        () => {
+          var _a;
+          return adopted((_a = registry.keys.get(appId)) != null ? _a : minted);
+        },
+        degraded
+      );
+    }).catch(degraded);
+  } catch {
+    run = Promise.resolve(degraded());
+  }
+  registry.pending.set(appId, run);
+  void run.then((outcome) => {
+    var _a;
+    if (outcome.durable) return;
+    (_a = registry.pending) == null ? void 0 : _a.delete(appId);
+    registry.hydrating.delete(appId);
+  });
+  return run;
+};
+var resolveAutoDeviceKey = (opts = {}) => {
+  var _a, _b;
+  const registry = autoDeviceKeyRegistry();
+  const appId = (_a = opts.appId) != null ? _a : "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 _a;
+  const registry = autoDeviceKeyRegistry();
+  registry.keys.clear();
+  registry.hydrating.clear();
+  (_a = registry.pending) == null ? void 0 : _a.clear();
+  registry.ambient = void 0;
+};
+
 // src/analytics/wireDoctor.ts
 var PROBE_STORAGE_KEY = "wireai:doctor:probe";
 var PROBE_QUESTION_KEY = "wire_doctor_probe";
@@ -356,6 +510,66 @@ var checkRoundTrip = async (target) => {
     `the server DISCARDED the probe event: written=${(_a = ack.written) != null ? _a : "unknown"}, skipped=${ack.skipped}` + (ack.reasons.length > 0 ? `, reasons: ${ack.reasons.join(", ")}.` : ". It gave no reason; check the server's ingest log for this request.")
   );
 };
+var checkJoinKey = async (join, storage, storageOk) => {
+  var _a;
+  if (!join) {
+    return check(
+      "join_key",
+      false,
+      "NOT EVALUATED: pass `join: { appId, userContext, autoJoinKey }` \u2014 the same values you pass <WireOnboarding> \u2014 so the doctor can tell whether this integration's sessions will be joinable. It is reported as a failure rather than skipped because every other check can pass while the funnel reads a permanent zero."
+    );
+  }
+  if (isUsableIdentityValue((_a = join.userContext) == null ? void 0 : _a.device_key)) {
+    return check(
+      "join_key",
+      true,
+      "user_context.device_key is supplied by the host, so onboarding sessions join the rest of the funnel."
+    );
+  }
+  if (join.autoJoinKey === false) {
+    return check(
+      "join_key",
+      false,
+      "no user_context.device_key AND autoJoinKey is false, so these onboarding sessions are UNLINKED by choice: they join nothing the app reports later and the activated funnel reads zero. Supply user_context.device_key, or drop autoJoinKey:false to let the kit inject its own."
+    );
+  }
+  if (!storage) {
+    return check(
+      "join_key",
+      false,
+      "no user_context.device_key, and the kit cannot auto-inject one without storage: an unpersisted key differs every launch, which corrupts the server's session counting rather than just leaving it empty, so the kit declines it. Pass AsyncStorage (or an MMKV wrapper) to <WireOnboarding>."
+    );
+  }
+  if (!storageOk) {
+    return check(
+      "join_key",
+      false,
+      "no user_context.device_key, and the storage check above FAILED \u2014 the kit refuses a non-durable auto key, so it will inject nothing and these sessions will not join. Fix the storage adapter first."
+    );
+  }
+  let persisted = null;
+  try {
+    persisted = await storage.getItem(deviceIdStorageKey(join.appId));
+  } catch {
+    return check(
+      "join_key",
+      false,
+      "no user_context.device_key, and reading the persisted auto key threw, so it is unknown whether the kit can supply one. Treat this as the storage adapter being unreliable."
+    );
+  }
+  if (isUsableIdentityValue(persisted)) {
+    return check(
+      "join_key",
+      true,
+      "no host device_key, but a durable auto join key is already persisted for this appId, so sessions join."
+    );
+  }
+  return check(
+    "join_key",
+    true,
+    "no host device_key and none persisted yet (first run): the kit will mint and persist its own on first mount, and the storage check above proved the write/read round trip that injection is gated on."
+  );
+};
 var wireDoctor = async (options) => {
   if (typeof __DEV__ === "undefined" || !__DEV__) {
     return {
@@ -371,14 +585,18 @@ var wireDoctor = async (options) => {
   }
   try {
     const target = options == null ? void 0 : options.target;
-    const checks = [checkTarget(target)];
-    if (checks[0].ok && target) {
+    const targetCheck = checkTarget(target);
+    const checks = [targetCheck];
+    const targetUsable = targetCheck.ok && !!target;
+    if (targetUsable && target) {
       checks.push(await checkReachability(target.serverUrl));
-      checks.push(await checkStorage(options == null ? void 0 : options.storage));
+    }
+    const storageCheck = await checkStorage(options == null ? void 0 : options.storage);
+    checks.push(storageCheck);
+    if (targetUsable && target) {
       checks.push(await checkRoundTrip(target));
-    } else {
-      checks.push(await checkStorage(options == null ? void 0 : options.storage));
     }
+    checks.push(await checkJoinKey(options == null ? void 0 : options.join, options == null ? void 0 : options.storage, storageCheck.ok));
     return { ok: checks.every((c) => c.ok), checks };
   } catch {
     return {
@@ -1029,108 +1247,6 @@ var resolveUserContext = (ctx = {}, opts = {}) => {
   return result;
 };
 
-// src/identity/identityRecord.ts
-var IDENTITY_PROVENANCE_SLOT = /* @__PURE__ */ Symbol.for("@wireai/activation:identityProvenance");
-var provenanceGlobal = globalThis;
-var provenanceRegistry = () => {
-  const existing = provenanceGlobal[IDENTITY_PROVENANCE_SLOT];
-  if (existing) return existing;
-  const created = { host: /* @__PURE__ */ new Map() };
-  provenanceGlobal[IDENTITY_PROVENANCE_SLOT] = created;
-  return created;
-};
-var provenanceKey = (space, scope) => `${space}:${scope != null ? scope : "default"}`;
-var resolveIdentity = (input) => {
-  var _a;
-  if (typeof input.value !== "string") return void 0;
-  const value = input.value.trim();
-  if (!value) return void 0;
-  const durable = (_a = input.durable) != null ? _a : input.source === "host";
-  {
-    provenanceRegistry().host.set(provenanceKey(input.space, input.scope), value);
-  }
-  return { value, space: input.space, source: input.source, durable };
-};
-
-// src/context/deviceId.ts
-var AUTO_DEVICE_ID_PREFIX = "wdev_";
-var deviceIdStorageKey = (appId) => `wireai:analytics:deviceKey:${appId != null ? appId : "default"}`;
-var randomChunk = () => Math.floor(Math.random() * 4294967296).toString(36).padStart(6, "0");
-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 degraded = () => {
-    var _a;
-    return { value: (_a = registry.keys.get(appId)) != null ? _a : minted, durable: false };
-  };
-  const adopted = (value) => ({ value, durable: true });
-  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 adopted(persisted);
-      }
-      return Promise.resolve(storage.setItem(slot, minted)).then(
-        () => {
-          var _a;
-          return adopted((_a = registry.keys.get(appId)) != null ? _a : minted);
-        },
-        degraded
-      );
-    }).catch(degraded);
-  } catch {
-    run = Promise.resolve(degraded());
-  }
-  registry.pending.set(appId, run);
-  void run.then((outcome) => {
-    var _a;
-    if (outcome.durable) return;
-    (_a = registry.pending) == null ? void 0 : _a.delete(appId);
-    registry.hydrating.delete(appId);
-  });
-  return run;
-};
-var resolveAutoDeviceKey = (opts = {}) => {
-  var _a, _b;
-  const registry = autoDeviceKeyRegistry();
-  const appId = (_a = opts.appId) != null ? _a : "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 _a;
-  const registry = autoDeviceKeyRegistry();
-  registry.keys.clear();
-  registry.hydrating.clear();
-  (_a = registry.pending) == null ? void 0 : _a.clear();
-};
-
 // src/analytics/analyticsFacade.ts
 var createAnalytics = (config, options = {}) => {
   var _a, _b, _c;
@@ -1283,30 +1399,75 @@ var createAnalytics = (config, options = {}) => {
     dispose: queue.dispose
   };
 };
+var stableAnalyticsFacade = (live) => ({
+  track: (event, props) => {
+    var _a;
+    return (_a = live()) == null ? void 0 : _a.track(event, props);
+  },
+  screen: (name, props) => {
+    var _a;
+    return (_a = live()) == null ? void 0 : _a.screen(name, props);
+  },
+  identify: (userId, traits) => {
+    var _a;
+    return (_a = live()) == null ? void 0 : _a.identify(userId, traits);
+  },
+  setUserContext: (partial) => {
+    var _a;
+    return (_a = live()) == null ? void 0 : _a.setUserContext(partial);
+  },
+  reset: () => {
+    var _a;
+    return (_a = live()) == null ? void 0 : _a.reset();
+  },
+  flush: () => {
+    var _a;
+    return (_a = live()) == null ? void 0 : _a.flush();
+  },
+  notifyOnline: () => {
+    var _a;
+    return (_a = live()) == null ? void 0 : _a.notifyOnline();
+  },
+  // After a real unmount there is no instance and nothing pending on it — 0 is the honest answer.
+  size: () => {
+    var _a, _b;
+    return (_b = (_a = live()) == null ? void 0 : _a.size()) != null ? _b : 0;
+  },
+  dispose: () => {
+    var _a;
+    return (_a = live()) == null ? void 0 : _a.dispose();
+  }
+});
 var useAnalytics = (config, options = {}) => {
   var _a, _b;
   const ref = useRef(void 0);
   const prevKeys = useRef("");
+  const inputs = useRef({ config, options });
+  inputs.current = { config, options };
   const currentKeys = `${config.serverUrl}|${config.apiKey}|${config.appId}`;
   if (!ref.current || prevKeys.current !== currentKeys) {
     prevKeys.current = currentKeys;
     (_a = ref.current) == null ? void 0 : _a.dispose();
     ref.current = createAnalytics(config, options);
   }
+  const facade = useRef(void 0);
+  if (!facade.current) facade.current = stableAnalyticsFacade(() => ref.current);
+  useEffect(() => {
+    if (!ref.current) {
+      ref.current = createAnalytics(inputs.current.config, inputs.current.options);
+    }
+    return () => {
+      var _a2;
+      (_a2 = ref.current) == null ? void 0 : _a2.dispose();
+      ref.current = void 0;
+    };
+  }, []);
   const hostDeviceKey = typeof ((_b = config.userContext) == null ? void 0 : _b.deviceKey) === "string" && config.userContext.deviceKey.trim() ? config.userContext.deviceKey.trim() : void 0;
   useEffect(() => {
     var _a2;
     if (hostDeviceKey) (_a2 = ref.current) == null ? void 0 : _a2.setUserContext({ deviceKey: hostDeviceKey });
   }, [hostDeviceKey]);
-  useEffect(
-    () => () => {
-      var _a2;
-      (_a2 = ref.current) == null ? void 0 : _a2.dispose();
-      ref.current = void 0;
-    },
-    []
-  );
-  return ref.current;
+  return facade.current;
 };
 
 export { AUTO_DEVICE_ID_PREFIX, WIRE_ONBOARDING_EVENTS, analyticsUserIdStorageKey, buildContextEnvelope, clearPiiFromContext, clearUserContext, createAnalytics, createEventQueue, createScreenTracker, deviceIdStorageKey, ensureCurrentSessionId, getActiveRouteName, getCurrentSessionId, looksLikeEmail, makeSessionId, reportAppEvent, reportClientEvent, reportClientEventAwait, reportClientEvents, reportClientEventsAwait, resetAutoDeviceKeys, resetCurrentSessionId, resetEventQueueKeys, resolveAutoDeviceKey, screenTrackingHandler, setCurrentSessionId, toAnalyticsEvent, useAnalytics, useScreenTracking, wireDoctor };