@wireai/activation 0.14.3 → 0.16.0

package/dist/analytics/index.d.ts

@@ -1,10 +1,10 @@
-export { R as ReportAppEventOptions, r as reportAppEvent } from '../transport-B_0SgCBe.js';
-import { C as ClientEventTarget, W as WireUserContext, E as EventQueueOptions } from '../currentSession-CW_5Mq4O.js';
-export { A as AUTO_DEVICE_ID_PREFIX, a as AnalyticsEvent, b as ClearUserContextOptions, c as ClientEvent, d as ClientEventType, e as ContextEnvelope, f as ContextEnvelopeInput, D as DeviceKeyStorage, g as EnvelopeSource, h as EventQueue, R as ResolveAutoDeviceKeyOptions, i as WIRE_ONBOARDING_EVENTS, j as WireOnboardingEventName, k as analyticsUserIdStorageKey, l as buildContextEnvelope, m as clearPiiFromContext, n as clearUserContext, o as createEventQueue, p as deviceIdStorageKey, q as ensureCurrentSessionId, r as getCurrentSessionId, s as looksLikeEmail, t as makeSessionId, u as reportClientEvent, v as reportClientEventAwait, w as reportClientEvents, x as reportClientEventsAwait, y as resetAutoDeviceKeys, z as resetCurrentSessionId, B as resetEventQueueKeys, F as resolveAutoDeviceKey, G as setCurrentSessionId, H as toAnalyticsEvent } from '../currentSession-CW_5Mq4O.js';
+export { R as ReportAppEventOptions, r as reportAppEvent } from '../transport-xqqSFqxs.js';
+import { C as ClientEventTarget, W as WireUserContext, E as EventQueueOptions } from '../currentSession-z-CZ55ad.js';
+export { A as AUTO_DEVICE_ID_PREFIX, a as AnalyticsEvent, b as ClearUserContextOptions, c as ClientEvent, d as ClientEventType, e as ContextEnvelope, f as ContextEnvelopeInput, D as DeviceKeyStorage, g as EnvelopeSource, h as EventQueue, R as ResolveAutoDeviceKeyOptions, i as WIRE_ONBOARDING_EVENTS, j as WireOnboardingEventName, k as analyticsUserIdStorageKey, l as buildContextEnvelope, m as clearPiiFromContext, n as clearUserContext, o as createEventQueue, p as deviceIdStorageKey, q as ensureCurrentSessionId, r as getCurrentSessionId, s as looksLikeEmail, t as makeSessionId, u as reportClientEvent, v as reportClientEventAwait, w as reportClientEvents, x as reportClientEventsAwait, y as resetAutoDeviceKeys, z as resetCurrentSessionId, B as resetEventQueueKeys, F as resolveAutoDeviceKey, G as setCurrentSessionId, H as toAnalyticsEvent } from '../currentSession-z-CZ55ad.js';
 import { W as WireOnboardingStorage } from '../types-BpwiRpA8.js';
-import '../types-h2BZvl1t.js';
+import '../types-tdATL5z0.js';
 import '../types-BKfpdZzX.js';
-import '../types-BcmagF6K.js';
+import '../types-D_0B0yay.js';
 import 'react';
 import 'wireai-rn';
 import 'react-native';
@@ -105,13 +105,18 @@ declare const useScreenTracking: (navigationRef: NavigationRefLike | undefined,
  * numeric `ts` did exactly that through 0.13.0. This turns that class of loss from something you
  * discover in a funnel report weeks later into something the first run tells you.
  *
- * SHAPE: four independent checks, each a `{name, ok, detail}` unit that can be read (and tested)
+ * SHAPE: five independent checks, each a `{name, ok, detail}` unit that can be read (and tested)
  * without the others. The report is data, never a thrown error and never a side effect on the host:
  *
  *   1. `target`      : is there a server URL and a key, and do they look like a key and a URL?
  *   2. `reachability`: is the server actually there? (`GET /v1/events/contract`, public and cheap)
  *   3. `storage`      : can the offline queue persist? (a write / read / delete probe)
  *   4. `round_trip`   : does a REAL event survive REAL server validation? (a `dry_run` POST)
+ *   5. `join_key`     : will those events be JOINABLE? (read-only; needs `join`)
+ *
+ * Checks 1-4 all answer "does an event leave and get accepted". NONE of them answers "can it be
+ * joined", and an integration with no `user_context.device_key` writes every event, passes every
+ * one of those four, and still reports a permanent ZERO in the activated funnel. That is check 5.
  *
  * NEVER THROWS, under any input, any network condition, or any hostile response object. A doctor
  * that can crash the screen it is diagnosing is worse than no doctor.
@@ -131,6 +136,9 @@ declare const useScreenTracking: (navigationRef: NavigationRefLike | undefined,
  *   const report = await wireDoctor({
  *     target: { serverUrl: "https://api.example.com", apiKey: DRIVELINE_KEY },
  *     storage: AsyncStorage,
+ *     // The same values you hand <WireOnboarding>. Omit `join` and the join_key check FAILS,
+ *     // because a report that never looked at the join cannot honestly read green.
+ *     join: { appId: WIRE_APP_ID, userContext },
  *   });
  *   console.log(report.ok, report.checks);
  */
@@ -138,7 +146,8 @@ declare const useScreenTracking: (navigationRef: NavigationRefLike | undefined,
 /** One diagnosis. `name` is stable and machine-readable; `detail` is for a human reading a console. */
 type WireDoctorCheck = {
     /**
-     * Stable id: `target` | `reachability` | `storage` | `round_trip` | `dev_only` | `internal_error`.
+     * Stable id: `target` | `reachability` | `storage` | `round_trip` | `join_key` | `dev_only` |
+     * `internal_error`.
      *
      * `dev_only` means ONE thing and only that thing: `__DEV__` is unset or false, so nothing ran.
      * `internal_error` is the separate catch-all for a failure that got past every check's own
@@ -155,6 +164,19 @@ type WireDoctorReport = {
     ok: boolean;
     checks: WireDoctorCheck[];
 };
+/**
+ * What the join check needs: the same three values the host hands `<WireOnboarding>`. Pass the very
+ * props you pass the component — anything reconstructed here would diagnose a DIFFERENT integration
+ * than the one that ships.
+ */
+type WireDoctorJoinTarget = {
+    /** The same `config.appId`. It namespaces the persisted auto key, so the wrong one reads the wrong slot. */
+    appId?: string;
+    /** The same `userContext` prop. Only `device_key` is read; nothing else is inspected or reported. */
+    userContext?: Record<string, string | number | boolean>;
+    /** The same `autoJoinKey` prop. `false` is the documented opt-out from the kit's auto-join. */
+    autoJoinKey?: boolean;
+};
 /** Input for {@link wireDoctor}. `storage` is optional: without it the queue runs in-memory only. */
 type WireDoctorOptions = {
     /** The same `{serverUrl, apiKey}` the kit is configured with. */
@@ -164,6 +186,11 @@ type WireDoctorOptions = {
      * check reports the DEGRADED in-memory mode rather than failing.
      */
     storage?: WireOnboardingStorage;
+    /**
+     * The join-key inputs. OMITTING THIS FAILS THE `join_key` CHECK — deliberately, and see
+     * {@link checkJoinKey} for why a skipped join check may not read as a pass.
+     */
+    join?: WireDoctorJoinTarget;
 };
 /**
  * Run the full diagnosis. Resolves a report; NEVER throws and NEVER rejects.
@@ -283,11 +310,6 @@ type Analytics = {
  */
 declare const createAnalytics: (config: CreateAnalyticsConfig, options?: AnalyticsOptions) => Analytics;
 
-/**
- * Build a per-mount analytics instance. `config`/`options` are read once at first render (the
- * instance is stable for the component's lifetime, held in a ref). Returns the {@link Analytics}
- * surface so the component can `track` / `screen` / `identify` and drive `notifyOnline` on reconnect.
- */
 declare const useAnalytics: (config: CreateAnalyticsConfig, options?: AnalyticsOptions) => Analytics;
 
-export { type Analytics, type AnalyticsOptions, type AnalyticsProps, ClientEventTarget, type CreateAnalyticsConfig, EventQueueOptions, type NavigationRefLike, type NavigationRouteLike, type NavigationStateLike, type ScreenTracker, type ScreenTrackerOptions, type WireDoctorCheck, type WireDoctorOptions, type WireDoctorReport, createAnalytics, createScreenTracker, getActiveRouteName, screenTrackingHandler, useAnalytics, useScreenTracking, wireDoctor };
+export { type Analytics, type AnalyticsOptions, type AnalyticsProps, ClientEventTarget, type CreateAnalyticsConfig, EventQueueOptions, type NavigationRefLike, type NavigationRouteLike, type NavigationStateLike, type ScreenTracker, type ScreenTrackerOptions, type WireDoctorCheck, type WireDoctorJoinTarget, type WireDoctorOptions, type WireDoctorReport, createAnalytics, createScreenTracker, getActiveRouteName, screenTrackingHandler, useAnalytics, useScreenTracking, wireDoctor };

package/dist/analytics/index.js

@@ -10,6 +10,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) => {
@@ -81,14 +103,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";
   }
@@ -109,25 +134,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;
   }
@@ -228,6 +279,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";
@@ -358,6 +512,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 {
@@ -373,14 +587,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 {
@@ -1031,108 +1249,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;
@@ -1285,30 +1401,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 = react.useRef(void 0);
   const prevKeys = react.useRef("");
+  const inputs = react.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 = react.useRef(void 0);
+  if (!facade.current) facade.current = stableAnalyticsFacade(() => ref.current);
+  react.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;
   react.useEffect(() => {
     var _a2;
     if (hostDeviceKey) (_a2 = ref.current) == null ? void 0 : _a2.setUserContext({ deviceKey: hostDeviceKey });
   }, [hostDeviceKey]);
-  react.useEffect(
-    () => () => {
-      var _a2;
-      (_a2 = ref.current) == null ? void 0 : _a2.dispose();
-      ref.current = void 0;
-    },
-    []
-  );
-  return ref.current;
+  return facade.current;
 };
 
 exports.AUTO_DEVICE_ID_PREFIX = AUTO_DEVICE_ID_PREFIX;