@wireai/activation 0.13.2 → 0.13.5

package/dist/analytics/index.js

@@ -1,404 +1,14 @@
 'use strict';
 
-var reactNative = require('react-native');
 var react = require('react');
+var reactNative = require('react-native');
 
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
   get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
 }) : x)(function(x) {
   if (typeof require !== "undefined") return require.apply(this, arguments);
   throw Error('Dynamic require of "' + x + '" is not supported');
 });
-var __esm = (fn, res) => function __init() {
-  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
-};
-var __export = (target, all) => {
-  for (var name2 in all)
-    __defProp(target, name2, { get: all[name2], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// node_modules/expo-modules-core/src/errors/CodedError.ts
-var CodedError;
-var init_CodedError = __esm({
-  "node_modules/expo-modules-core/src/errors/CodedError.ts"() {
-    CodedError = class extends Error {
-      constructor(code, message) {
-        super(message);
-        this.code = code;
-      }
-    };
-  }
-});
-
-// node_modules/expo-modules-core/src/NativeModulesProxy.ts
-var NativeModulesProxy_default;
-var init_NativeModulesProxy = __esm({
-  "node_modules/expo-modules-core/src/NativeModulesProxy.ts"() {
-    NativeModulesProxy_default = {};
-  }
-});
-
-// node_modules/expo-modules-core/src/TurboModuleToExpoModuleProxy.ts
-function createTurboModuleToExpoProxy(turboModule, name2) {
-  return null;
-}
-var init_TurboModuleToExpoModuleProxy = __esm({
-  "node_modules/expo-modules-core/src/TurboModuleToExpoModuleProxy.ts"() {
-  }
-});
-var init_ensureNativeModulesAreInstalled = __esm({
-  "node_modules/expo-modules-core/src/ensureNativeModulesAreInstalled.ts"() {
-  }
-});
-function requireOptionalNativeModule(moduleName) {
-  var _a2, _b, _c, _d, _e;
-  try {
-    return (_e = (_d = (_c = (_b = (_a2 = globalThis.expo) == null ? void 0 : _a2.modules) == null ? void 0 : _b[moduleName]) != null ? _c : NativeModulesProxy_default[moduleName]) != null ? _d : createTurboModuleToExpoProxy(reactNative.TurboModuleRegistry.get(moduleName), moduleName)) != null ? _e : null;
-  } catch (e) {
-    const error = e;
-    console.warn(`An error occurred while requiring the '${moduleName}' module: ${error.message}`);
-    return null;
-  }
-}
-var init_requireNativeModule = __esm({
-  "node_modules/expo-modules-core/src/requireNativeModule.ts"() {
-    init_NativeModulesProxy();
-    init_TurboModuleToExpoModuleProxy();
-    init_ensureNativeModulesAreInstalled();
-  }
-});
-
-// node_modules/expo-modules-core/src/sweet/setUpJsLogger.fx.ts
-var init_setUpJsLogger_fx = __esm({
-  "node_modules/expo-modules-core/src/sweet/setUpJsLogger.fx.ts"() {
-    init_CodedError();
-    init_requireNativeModule();
-    if (__DEV__ && typeof window !== "undefined" && (process.env.EXPO_OS === "android" || process.env.EXPO_OS === "ios")) {
-      const NativeJSLogger = requireOptionalNativeModule("ExpoModulesCoreJSLogger");
-      if (NativeJSLogger) {
-        const onNewException = {
-          eventName: "ExpoModulesCoreJSLogger.onNewError",
-          action: console.error
-        };
-        const onNewWarning = {
-          eventName: "ExpoModulesCoreJSLogger.onNewWarning",
-          action: console.warn
-        };
-        const onNewDebug = {
-          eventName: "ExpoModulesCoreJSLogger.onNewDebug",
-          action: console.debug
-        };
-        const onNewInfo = {
-          eventName: "ExpoModulesCoreJSLogger.onNewInfo",
-          action: console.info
-        };
-        const onNewTrace = {
-          eventName: "ExpoModulesCoreJSLogger.onNewTrace",
-          action: console.trace
-        };
-        const listeners = [
-          onNewException,
-          onNewWarning,
-          onNewDebug,
-          onNewInfo,
-          onNewTrace
-        ];
-        for (const listener of listeners) {
-          NativeJSLogger.addListener(listener.eventName, ({ message }) => {
-            listener.action(message);
-          });
-        }
-      }
-    }
-    globalThis.ExpoModulesCore_CodedError = CodedError;
-  }
-});
-
-// node_modules/expo-modules-core/src/registerWebModule.ts
-var init_registerWebModule = __esm({
-  "node_modules/expo-modules-core/src/registerWebModule.ts"() {
-  }
-});
-
-// node_modules/expo-modules-core/src/TypedArrays.types.ts
-var init_TypedArrays_types = __esm({
-  "node_modules/expo-modules-core/src/TypedArrays.types.ts"() {
-  }
-});
-
-// node_modules/expo-modules-core/src/PermissionsInterface.ts
-var init_PermissionsInterface = __esm({
-  "node_modules/expo-modules-core/src/PermissionsInterface.ts"() {
-  }
-});
-var init_PermissionsHook = __esm({
-  "node_modules/expo-modules-core/src/PermissionsHook.ts"() {
-    "use client";
-  }
-});
-var init_Refs = __esm({
-  "node_modules/expo-modules-core/src/Refs.ts"() {
-  }
-});
-var init_useReleasingSharedObject = __esm({
-  "node_modules/expo-modules-core/src/hooks/useReleasingSharedObject.ts"() {
-    "use client";
-  }
-});
-
-// node_modules/expo-modules-core/src/reload.ts
-var init_reload = __esm({
-  "node_modules/expo-modules-core/src/reload.ts"() {
-  }
-});
-
-// node_modules/expo-modules-core/src/index.ts
-var init_src = __esm({
-  "node_modules/expo-modules-core/src/index.ts"() {
-    init_setUpJsLogger_fx();
-    init_requireNativeModule();
-    init_registerWebModule();
-    init_TypedArrays_types();
-    init_PermissionsInterface();
-    init_PermissionsHook();
-    init_Refs();
-    init_useReleasingSharedObject();
-    init_reload();
-    init_CodedError();
-  }
-});
-
-// node_modules/expo-constants/build/Constants.types.js
-var AppOwnership, ExecutionEnvironment, UserInterfaceIdiom;
-var init_Constants_types = __esm({
-  "node_modules/expo-constants/build/Constants.types.js"() {
-    (function(AppOwnership2) {
-      AppOwnership2["Expo"] = "expo";
-    })(AppOwnership || (AppOwnership = {}));
-    (function(ExecutionEnvironment2) {
-      ExecutionEnvironment2["Bare"] = "bare";
-      ExecutionEnvironment2["Standalone"] = "standalone";
-      ExecutionEnvironment2["StoreClient"] = "storeClient";
-    })(ExecutionEnvironment || (ExecutionEnvironment = {}));
-    (function(UserInterfaceIdiom2) {
-      UserInterfaceIdiom2["Handset"] = "handset";
-      UserInterfaceIdiom2["Tablet"] = "tablet";
-      UserInterfaceIdiom2["Desktop"] = "desktop";
-      UserInterfaceIdiom2["TV"] = "tv";
-      UserInterfaceIdiom2["Unsupported"] = "unsupported";
-    })(UserInterfaceIdiom || (UserInterfaceIdiom = {}));
-  }
-});
-
-// node_modules/expo-constants/build/ExponentConstants.js
-var ExponentConstants_default;
-var init_ExponentConstants = __esm({
-  "node_modules/expo-constants/build/ExponentConstants.js"() {
-    init_src();
-    ExponentConstants_default = requireOptionalNativeModule("ExponentConstants");
-  }
-});
-
-// node_modules/expo-constants/build/Constants.js
-var Constants_exports = {};
-__export(Constants_exports, {
-  AppOwnership: () => AppOwnership,
-  ExecutionEnvironment: () => ExecutionEnvironment,
-  UserInterfaceIdiom: () => UserInterfaceIdiom,
-  default: () => Constants_default
-});
-function isEmbeddedManifest(manifest) {
-  return !isExpoUpdatesManifest(manifest);
-}
-function isExpoUpdatesManifest(manifest) {
-  return "metadata" in manifest;
-}
-function getManifest(suppressWarning = false) {
-  if (!rawManifest) {
-    const invalidManifestType = rawManifest === null ? "null" : "undefined";
-    if (nativeConstants.executionEnvironment === ExecutionEnvironment.Bare && reactNative.Platform.OS !== "web") {
-      if (!suppressWarning) {
-        console.warn(`Constants.manifest is ${invalidManifestType} because the embedded app.config could not be read. Ensure that you have installed the expo-constants build scripts if you need to read from Constants.manifest.`);
-      }
-    } else if (nativeConstants.executionEnvironment === ExecutionEnvironment.StoreClient || nativeConstants.executionEnvironment === ExecutionEnvironment.Standalone) {
-      throw new CodedError("ERR_CONSTANTS_MANIFEST_UNAVAILABLE", `Constants.manifest is ${invalidManifestType}, must be an object.`);
-    }
-  }
-  return rawManifest;
-}
-var ExpoUpdates, rawUpdatesManifest, rawDevLauncherManifest, rawAppConfig, _a, rawManifest, name, appOwnership, nativeConstants, constants, Constants_default;
-var init_Constants = __esm({
-  "node_modules/expo-constants/build/Constants.js"() {
-    init_src();
-    init_Constants_types();
-    init_ExponentConstants();
-    init_Constants_types();
-    if (!ExponentConstants_default) {
-      console.warn("No native ExponentConstants module found, are you sure the expo-constants's module is linked properly?");
-    }
-    ExpoUpdates = requireOptionalNativeModule("ExpoUpdates");
-    rawUpdatesManifest = null;
-    if (ExpoUpdates) {
-      let updatesManifest;
-      if (ExpoUpdates.manifest) {
-        updatesManifest = ExpoUpdates.manifest;
-      } else if (ExpoUpdates.manifestString) {
-        updatesManifest = JSON.parse(ExpoUpdates.manifestString);
-      }
-      if (updatesManifest && Object.keys(updatesManifest).length > 0) {
-        rawUpdatesManifest = updatesManifest;
-      }
-    }
-    rawDevLauncherManifest = null;
-    if (reactNative.NativeModules.EXDevLauncher) {
-      let devLauncherManifest;
-      if (reactNative.NativeModules.EXDevLauncher.manifestString) {
-        devLauncherManifest = JSON.parse(reactNative.NativeModules.EXDevLauncher.manifestString);
-      }
-      if (devLauncherManifest && Object.keys(devLauncherManifest).length > 0) {
-        rawDevLauncherManifest = devLauncherManifest;
-      }
-    }
-    rawAppConfig = null;
-    if (ExponentConstants_default && ExponentConstants_default.manifest) {
-      const appConfig = ExponentConstants_default.manifest;
-      if (typeof appConfig === "string") {
-        rawAppConfig = JSON.parse(appConfig);
-      } else {
-        rawAppConfig = appConfig;
-      }
-    }
-    rawManifest = (_a = rawUpdatesManifest != null ? rawUpdatesManifest : rawDevLauncherManifest) != null ? _a : rawAppConfig;
-    ({ name, appOwnership, ...nativeConstants } = ExponentConstants_default || {});
-    constants = {
-      ...nativeConstants,
-      // Ensure this is null in bare workflow
-      appOwnership: appOwnership != null ? appOwnership : null
-    };
-    Object.defineProperties(constants, {
-      /**
-       * Use `manifest` property by default.
-       * This property is only used for internal purposes.
-       * It behaves similarly to the original one, but suppresses warning upon no manifest available.
-       * `expo-asset` uses it to prevent users from seeing mentioned warning.
-       */
-      __unsafeNoWarnManifest: {
-        get() {
-          const maybeManifest = getManifest(true);
-          if (!maybeManifest || !isEmbeddedManifest(maybeManifest)) {
-            return null;
-          }
-          return maybeManifest;
-        },
-        enumerable: false
-      },
-      __unsafeNoWarnManifest2: {
-        get() {
-          const maybeManifest = getManifest(true);
-          if (!maybeManifest || !isExpoUpdatesManifest(maybeManifest)) {
-            return null;
-          }
-          return maybeManifest;
-        },
-        enumerable: false
-      },
-      manifest: {
-        get() {
-          const maybeManifest = getManifest();
-          if (!maybeManifest || !isEmbeddedManifest(maybeManifest)) {
-            return null;
-          }
-          return maybeManifest;
-        },
-        enumerable: true
-      },
-      manifest2: {
-        get() {
-          const maybeManifest = getManifest();
-          if (!maybeManifest || !isExpoUpdatesManifest(maybeManifest)) {
-            return null;
-          }
-          return maybeManifest;
-        },
-        enumerable: true
-      },
-      expoConfig: {
-        get() {
-          var _a2, _b;
-          const maybeManifest = getManifest(true);
-          if (!maybeManifest) {
-            return null;
-          }
-          if (ExpoUpdates && ExpoUpdates.isEmbeddedLaunch) {
-            return rawAppConfig;
-          }
-          if (isExpoUpdatesManifest(maybeManifest)) {
-            return (_b = (_a2 = maybeManifest.extra) == null ? void 0 : _a2.expoClient) != null ? _b : null;
-          } else if (isEmbeddedManifest(maybeManifest)) {
-            return maybeManifest;
-          }
-          return null;
-        },
-        enumerable: true
-      },
-      expoGoConfig: {
-        get() {
-          var _a2, _b;
-          const maybeManifest = getManifest(true);
-          if (!maybeManifest) {
-            return null;
-          }
-          if (isExpoUpdatesManifest(maybeManifest)) {
-            return (_b = (_a2 = maybeManifest.extra) == null ? void 0 : _a2.expoGo) != null ? _b : null;
-          } else if (isEmbeddedManifest(maybeManifest)) {
-            return maybeManifest;
-          }
-          return null;
-        },
-        enumerable: true
-      },
-      easConfig: {
-        get() {
-          var _a2, _b;
-          const maybeManifest = getManifest(true);
-          if (!maybeManifest) {
-            return null;
-          }
-          if (isExpoUpdatesManifest(maybeManifest)) {
-            return (_b = (_a2 = maybeManifest.extra) == null ? void 0 : _a2.eas) != null ? _b : null;
-          } else if (isEmbeddedManifest(maybeManifest)) {
-            return maybeManifest;
-          }
-          return null;
-        },
-        enumerable: true
-      },
-      __rawManifest_TEST: {
-        get() {
-          return rawManifest;
-        },
-        set(value) {
-          rawManifest = value;
-        },
-        enumerable: false
-      }
-    });
-    Constants_default = constants;
-  }
-});
 
 // src/analytics/reportClientEvent.ts
 var makeSessionId = () => `wire_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;
@@ -412,13 +22,15 @@ var toWireEvents = (events) => events.map((event) => {
     return rest;
   }
 });
-var buildEventsRequest = (target, events) => {
+var buildEventsRequest = (target, events, options) => {
   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}`;
-    const body = JSON.stringify({ events: toWireEvents(events) });
+    const envelope = { events: toWireEvents(events) };
+    if ((options == null ? void 0 : options.dryRun) === true) envelope.dry_run = true;
+    const body = JSON.stringify(envelope);
     return { url, init: { method: "POST", headers, body } };
   } catch {
     return null;
@@ -522,14 +134,14 @@ var ensureCurrentSessionId = () => {
 };
 
 // src/reviews/transport.ts
-var reportAppEvent = (target, name2, options = {}) => {
-  var _a2;
-  if (!(target == null ? void 0 : target.serverUrl) || !name2) return;
+var reportAppEvent = (target, name, options = {}) => {
+  var _a;
+  if (!(target == null ? void 0 : target.serverUrl) || !name) return;
   try {
-    const supplied = (_a2 = options.sessionId) != null ? _a2 : "";
+    const supplied = (_a = options.sessionId) != null ? _a : "";
     const event = {
       event_type: "app_event",
-      question_key: name2,
+      question_key: name,
       session_id: supplied.trim().length > 0 ? supplied : ensureCurrentSessionId()
     };
     if (options.deviceKey) event.user_context = { device_key: options.deviceKey };
@@ -547,24 +159,24 @@ var reportAppEvent = (target, name2, options = {}) => {
 // src/analytics/screenTracking.ts
 var getActiveRouteName = (state) => {
   let current = state;
-  let name2;
+  let name;
   while (current && Array.isArray(current.routes) && current.routes.length > 0) {
     const index = typeof current.index === "number" ? current.index : 0;
     const route = current.routes[index];
     if (!route) break;
-    name2 = route.name;
+    name = route.name;
     current = route.state;
   }
-  return name2;
+  return name;
 };
 var createScreenTracker = (options = {}) => {
   let lastScreen;
   return {
     track: (screen) => {
-      var _a2;
+      var _a;
       if (!screen || screen === lastScreen) return;
       lastScreen = screen;
-      (_a2 = options.onScreen) == null ? void 0 : _a2.call(options, screen);
+      (_a = options.onScreen) == null ? void 0 : _a.call(options, screen);
       if (options.shouldTrack && !options.shouldTrack(screen)) return;
       reportAppEvent(options.target, "screen", {
         sessionId: options.sessionId,
@@ -606,8 +218,8 @@ var useScreenTracking = (navigationRef, options = {}) => {
     const tracker = trackerRef.current;
     if (!tracker || !(navigationRef == null ? void 0 : navigationRef.addListener)) return;
     const report = () => {
-      var _a2, _b;
-      return tracker.track((_b = (_a2 = navigationRef.getCurrentRoute) == null ? void 0 : _a2.call(navigationRef)) == null ? void 0 : _b.name);
+      var _a, _b;
+      return tracker.track((_b = (_a = navigationRef.getCurrentRoute) == null ? void 0 : _a.call(navigationRef)) == null ? void 0 : _b.name);
     };
     report();
     const unsubscribe = navigationRef.addListener("state", report);
@@ -615,6 +227,168 @@ var useScreenTracking = (navigationRef, options = {}) => {
   }, [navigationRef]);
 };
 
+// src/analytics/wireDoctor.ts
+var PROBE_STORAGE_KEY = "wireai:doctor:probe";
+var PROBE_QUESTION_KEY = "wire_doctor_probe";
+var EXPECTED_KEY_PREFIX = "wai_";
+var NETWORK_TIMEOUT_MS = 1e4;
+var check = (name, ok, detail) => ({ name, ok, detail });
+var fetchWithTimeout = async (url, init) => {
+  if (typeof fetch === "undefined") return void 0;
+  const controller = typeof AbortController !== "undefined" ? new AbortController() : void 0;
+  const timer = setTimeout(() => controller == null ? void 0 : controller.abort(), NETWORK_TIMEOUT_MS);
+  try {
+    return await fetch(url, controller ? { ...init, signal: controller.signal } : init);
+  } catch {
+    return void 0;
+  } finally {
+    clearTimeout(timer);
+  }
+};
+var checkTarget = (target) => {
+  const serverUrl = target == null ? void 0 : target.serverUrl;
+  if (typeof serverUrl !== "string" || serverUrl.trim().length === 0) {
+    return check("target", false, "no serverUrl configured: set `serverUrl` on the kit config.");
+  }
+  let parsedHost = false;
+  try {
+    const parsed = new URL(serverUrl);
+    parsedHost = parsed.protocol === "http:" || parsed.protocol === "https:";
+  } catch {
+    parsedHost = false;
+  }
+  if (!parsedHost) {
+    return check("target", false, "serverUrl is not a valid http(s) URL.");
+  }
+  const apiKey = target == null ? void 0 : target.apiKey;
+  if (typeof apiKey !== "string" || apiKey.length === 0) {
+    return check("target", false, "serverUrl looks valid, but no apiKey is configured.");
+  }
+  const prefixOk = apiKey.startsWith(EXPECTED_KEY_PREFIX);
+  return check(
+    "target",
+    true,
+    `serverUrl is a valid http(s) URL; apiKey present (${apiKey.length} chars, expected prefix: ${prefixOk ? "yes" : "no"}).`
+  );
+};
+var checkReachability = async (serverUrl) => {
+  const url = `${serverUrl.replace(/\/$/, "")}/v1/events/contract`;
+  const res = await fetchWithTimeout(url, { method: "GET" });
+  if (!res) {
+    return check("reachability", false, "could not reach the server (network error or timeout).");
+  }
+  const status = res.status;
+  const ok = !!res.ok;
+  if (!ok) {
+    return check(
+      "reachability",
+      false,
+      `the server answered ${typeof status === "number" ? status : "an error"} for the events contract; check the serverUrl points at a Wire server.`
+    );
+  }
+  return check("reachability", true, "the server answered the events contract.");
+};
+var checkStorage = async (storage) => {
+  if (!storage) {
+    return check(
+      "storage",
+      true,
+      "no storage injected: the queue runs in DEGRADED in-memory mode and loses pending events on an app kill. Pass AsyncStorage (or an MMKV wrapper) to make it durable."
+    );
+  }
+  const token = `probe_${Date.now().toString(36)}`;
+  try {
+    await storage.setItem(PROBE_STORAGE_KEY, token);
+    const read = await storage.getItem(PROBE_STORAGE_KEY);
+    if (read !== token) {
+      return check(
+        "storage",
+        false,
+        "the storage adapter accepted a write but did not read the same value back, so the queue cannot persist."
+      );
+    }
+    return check("storage", true, "storage write / read round trip succeeded.");
+  } catch {
+    return check("storage", false, "the storage adapter threw, so the queue cannot persist events.");
+  } finally {
+    try {
+      await storage.removeItem(PROBE_STORAGE_KEY);
+    } catch {
+    }
+  }
+};
+var checkRoundTrip = async (target) => {
+  var _a;
+  const event = {
+    event_type: "app_event",
+    session_id: makeSessionId(),
+    question_key: PROBE_QUESTION_KEY
+  };
+  const req = buildEventsRequest(target, [event], { dryRun: true });
+  if (!req) {
+    return check("round_trip", false, "could not build the events request from this target.");
+  }
+  const res = await fetchWithTimeout(req.url, req.init);
+  if (!res) {
+    return check("round_trip", false, "the events POST failed (network error or timeout).");
+  }
+  if (!res.ok) {
+    const status = res.status;
+    return check(
+      "round_trip",
+      false,
+      `the events endpoint answered ${typeof status === "number" ? status : "an error"}; a 401 here means the apiKey is not accepted.`
+    );
+  }
+  const ack = await readEventsAck(res);
+  if (!ack) {
+    return check(
+      "round_trip",
+      false,
+      "the server answered 2xx but sent no readable ack body, so it is unknown whether the event validated."
+    );
+  }
+  if (ack.written === 1 && ack.skipped === 0) {
+    return check("round_trip", true, "the server validated the probe event: written=1, skipped=0.");
+  }
+  return check(
+    "round_trip",
+    false,
+    `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 wireDoctor = async (options) => {
+  if (typeof __DEV__ === "undefined" || !__DEV__) {
+    return {
+      ok: false,
+      checks: [
+        check(
+          "dev_only",
+          false,
+          "wireDoctor is dev-only and did NOT run: __DEV__ is unset or false. Nothing was checked."
+        )
+      ]
+    };
+  }
+  try {
+    const target = options == null ? void 0 : options.target;
+    const checks = [checkTarget(target)];
+    if (checks[0].ok && target) {
+      checks.push(await checkReachability(target.serverUrl));
+      checks.push(await checkStorage(options == null ? void 0 : options.storage));
+      checks.push(await checkRoundTrip(target));
+    } else {
+      checks.push(await checkStorage(options == null ? void 0 : options.storage));
+    }
+    return { ok: checks.every((c) => c.ok), checks };
+  } catch {
+    return {
+      ok: false,
+      checks: [check("internal_error", false, "wireDoctor could not complete: an unexpected error was swallowed.")]
+    };
+  }
+};
+
 // src/permissions/permissionEvents.ts
 var WIRE_PERMISSION_EVENTS = {
   /** The priming screen became visible. The denominator for every rate below. */
@@ -707,9 +481,9 @@ var runtimeRequire = (moduleName) => {
   try {
     switch (moduleName) {
       case "expo-constants":
-        return init_Constants(), __toCommonJS(Constants_exports);
+        return require("expo-constants");
       case "expo-application":
-        return __require("expo-application");
+        return require("expo-application");
       default:
         return void 0;
     }
@@ -732,14 +506,14 @@ var safeInterop = (requireModule, moduleName) => {
 };
 var detectAppVersion = (requireModule = runtimeRequire) => {
   try {
-    const constants2 = safeInterop(requireModule, "expo-constants");
-    if (constants2) {
-      const expoConfig = constants2.expoConfig;
+    const constants = safeInterop(requireModule, "expo-constants");
+    if (constants) {
+      const expoConfig = constants.expoConfig;
       if (expoConfig && typeof expoConfig === "object") {
         const fromExpoConfig = coerceVersion(expoConfig.version);
         if (fromExpoConfig) return fromExpoConfig;
       }
-      const fromNative = coerceVersion(constants2.nativeAppVersion);
+      const fromNative = coerceVersion(constants.nativeAppVersion);
       if (fromNative) return fromNative;
     }
     const application = safeInterop(requireModule, "expo-application");
@@ -762,7 +536,7 @@ var runtimeRequire2 = (moduleName) => {
   if (moduleName !== "expo-device") return void 0;
   if (typeof __require !== "function") return void 0;
   try {
-    return __require("expo-device");
+    return require("expo-device");
   } catch {
     return void 0;
   }
@@ -804,7 +578,7 @@ var deriveFormFactor = (iosIdiom, width, height) => {
   return void 0;
 };
 var collectDeviceContext = () => {
-  var _a2;
+  var _a;
   const ctx = { platform: reactNative.Platform.OS };
   try {
     const version = reactNative.Platform.Version;
@@ -813,26 +587,26 @@ var collectDeviceContext = () => {
     }
   } catch {
   }
-  let constants2 = {};
+  let constants = {};
   try {
-    constants2 = (_a2 = reactNative.Platform.constants) != null ? _a2 : {};
+    constants = (_a = reactNative.Platform.constants) != null ? _a : {};
   } catch {
-    constants2 = {};
+    constants = {};
   }
   let iosIdiom;
   try {
     if (reactNative.Platform.OS === "android") {
-      const brand = constants2.Brand;
-      const model = constants2.Model;
-      const release = constants2.Release;
+      const brand = constants.Brand;
+      const model = constants.Model;
+      const release = constants.Release;
       if (typeof brand === "string" && brand) ctx.brand = brand;
       if (typeof model === "string" && model) ctx.model = model;
       if (release !== void 0 && release !== null && String(release)) {
         ctx.osVersion = String(release);
       }
     } else if (reactNative.Platform.OS === "ios") {
-      const osVersion = constants2.osVersion;
-      const idiom = constants2.interfaceIdiom;
+      const osVersion = constants.osVersion;
+      const idiom = constants.interfaceIdiom;
       if (osVersion !== void 0 && osVersion !== null && String(osVersion)) {
         ctx.osVersion = String(osVersion);
       }
@@ -873,10 +647,10 @@ var collectDeviceContext = () => {
 
 // src/analytics/contextEnvelope.ts
 var buildContextEnvelope = (input = {}) => {
-  var _a2;
+  var _a;
   const device = { ...collectDeviceContext() };
   if (input.appVersion) device.appVersion = input.appVersion;
-  const effectiveAppVersion = (_a2 = input.appVersion) != null ? _a2 : device.appVersion;
+  const effectiveAppVersion = (_a = input.appVersion) != null ? _a : device.appVersion;
   const envelope = { device };
   if (input.sessionId) envelope.sessionId = input.sessionId;
   if (effectiveAppVersion) envelope.appVersion = effectiveAppVersion;
@@ -919,10 +693,11 @@ var claimQueueKey = (preferred, explicit) => {
   return key;
 };
 var resetEventQueueKeys = () => claimedQueueKeys().clear();
+var READ_TIMED_OUT = /* @__PURE__ */ Symbol("wireai:storage-read-timeout");
 var withTimeout = (p, ms) => {
   let timer;
   const timeout = new Promise((resolve) => {
-    timer = setTimeout(() => resolve(void 0), ms);
+    timer = setTimeout(() => resolve(READ_TIMED_OUT), ms);
   });
   return Promise.race([p, timeout]).finally(() => clearTimeout(timer));
 };
@@ -947,10 +722,10 @@ var parsePersisted = (raw) => {
   }
 };
 var createEventQueue = (options) => {
-  var _a2, _b, _c, _d, _e, _f, _g;
+  var _a, _b, _c, _d, _e, _f, _g;
   const target = options.target;
   const storage = options.storage;
-  const defaultKey = (_b = options.storageKey) != null ? _b : `wireai:evtq:${(_a2 = options.appId) != null ? _a2 : "default"}`;
+  const defaultKey = (_b = options.storageKey) != null ? _b : `wireai:evtq:${(_a = options.appId) != null ? _a : "default"}`;
   const key = storage ? claimQueueKey(defaultKey, options.storageKey !== void 0) : defaultKey;
   const maxSize = (_c = options.maxSize) != null ? _c : DEFAULTS.maxSize;
   const batchSize = (_d = options.batchSize) != null ? _d : DEFAULTS.batchSize;
@@ -962,6 +737,7 @@ var createEventQueue = (options) => {
   let flushing = false;
   let attempt = 0;
   let retryTimer;
+  let backlogUnread = false;
   const resolveEnvelope = () => {
     try {
       return typeof options.envelope === "function" ? options.envelope() : options.envelope;
@@ -970,14 +746,14 @@ var createEventQueue = (options) => {
     }
   };
   const stamp = (event) => {
-    var _a3;
+    var _a2;
     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;
-    const uc = { ...(_a3 = stamped.user_context) != null ? _a3 : {} };
+    const uc = { ...(_a2 = stamped.user_context) != null ? _a2 : {} };
     if (env.appVersion && uc.app_version === void 0) uc.app_version = env.appVersion;
     if (env.appBuild && uc.app_build === void 0) uc.app_build = env.appBuild;
     if (env.networkType && uc.network_type === void 0) uc.network_type = env.networkType;
@@ -986,6 +762,7 @@ var createEventQueue = (options) => {
   };
   const persist = () => {
     if (!storage) return;
+    if (backlogUnread) return;
     try {
       if (pending.length === 0) {
         void storage.removeItem(key).catch(() => {
@@ -1008,23 +785,44 @@ var createEventQueue = (options) => {
       return `__nosig_${nextId}_${Math.random()}`;
     }
   };
+  const mergePersisted = (persistedItems) => {
+    if (persistedItems.length === 0) return;
+    const seen = new Set(pending.map((item) => item.sig));
+    const restored = [];
+    for (const persisted of persistedItems) {
+      const sig = safeSig(persisted.event);
+      if (seen.has(sig)) continue;
+      seen.add(sig);
+      restored.push({ id: nextId++, event: persisted.event, sig });
+    }
+    if (restored.length === 0) return;
+    pending = [...restored, ...pending];
+    enforceSizeCap();
+    persist();
+  };
   const loadPromise = (async () => {
     if (!storage) return;
     try {
-      const persistedItems = parsePersisted(await withTimeout(storage.getItem(key), READ_TIMEOUT_MS));
-      if (persistedItems.length === 0) return;
-      const events = [...persistedItems.map((p) => p.event), ...pending.map((p) => p.event)];
-      pending = [];
-      nextId = 0;
-      const seen = /* @__PURE__ */ new Set();
-      for (const event of events) {
-        const sig = safeSig(event);
-        if (seen.has(sig)) continue;
-        seen.add(sig);
-        pending.push({ id: nextId++, event, sig });
+      const read = Promise.resolve(storage.getItem(key));
+      read.catch(() => {
+      });
+      const raced = await withTimeout(read, READ_TIMEOUT_MS);
+      if (raced === READ_TIMED_OUT) {
+        backlogUnread = true;
+        warnInDev(
+          `[wireai] the persisted analytics backlog at "${key}" took longer than ${READ_TIMEOUT_MS}ms to read, so the queue started without it. The stored events are NOT discarded: writes are held back until the read lands, and the backlog is merged in then. If you see this on every cold start, your storage adapter is too slow to be on the launch path.`
+        );
+        void read.then((late) => {
+          backlogUnread = false;
+          mergePersisted(parsePersisted(late));
+          flush();
+        }).catch(() => {
+          backlogUnread = false;
+          persist();
+        });
+        return;
       }
-      enforceSizeCap();
-      persist();
+      mergePersisted(parsePersisted(raced));
     } catch {
     }
   })();
@@ -1173,7 +971,7 @@ var clearUserContext = async (opts = {}) => {
   }
 };
 var resolveUserContext = (ctx = {}, opts = {}) => {
-  var _a2;
+  var _a;
   const result = {};
   const bucket = {};
   const userId = sanitizeUserId(ctx.userId);
@@ -1183,7 +981,7 @@ var resolveUserContext = (ctx = {}, opts = {}) => {
     result.deviceKey = deviceKey;
     bucket.device_key = deviceKey;
   }
-  const appVersion = (_a2 = cleanString(ctx.appVersion)) != null ? _a2 : cleanString(opts.autoAppVersion);
+  const appVersion = (_a = cleanString(ctx.appVersion)) != null ? _a : cleanString(opts.autoAppVersion);
   if (appVersion) {
     result.appVersion = appVersion;
     bucket.app_version = appVersion;
@@ -1214,11 +1012,11 @@ var provenanceRegistry = () => {
 };
 var provenanceKey = (space, scope) => `${space}:${scope != null ? scope : "default"}`;
 var resolveIdentity = (input) => {
-  var _a2;
+  var _a;
   if (typeof input.value !== "string") return void 0;
   const value = input.value.trim();
   if (!value) return void 0;
-  const durable = (_a2 = input.durable) != null ? _a2 : input.source === "host";
+  const durable = (_a = input.durable) != null ? _a : input.source === "host";
   {
     provenanceRegistry().host.set(provenanceKey(input.space, input.scope), value);
   }
@@ -1248,8 +1046,8 @@ var startHydration = (registry, appId, storage, minted) => {
   if (existing) return existing;
   const slot = deviceIdStorageKey(appId);
   const degraded = () => {
-    var _a2;
-    return { value: (_a2 = registry.keys.get(appId)) != null ? _a2 : minted, durable: false };
+    var _a;
+    return { value: (_a = registry.keys.get(appId)) != null ? _a : minted, durable: false };
   };
   const adopted = (value) => ({ value, durable: true });
   let run;
@@ -1262,8 +1060,8 @@ var startHydration = (registry, appId, storage, minted) => {
       }
       return Promise.resolve(storage.setItem(slot, minted)).then(
         () => {
-          var _a2;
-          return adopted((_a2 = registry.keys.get(appId)) != null ? _a2 : minted);
+          var _a;
+          return adopted((_a = registry.keys.get(appId)) != null ? _a : minted);
         },
         degraded
       );
@@ -1273,17 +1071,17 @@ var startHydration = (registry, appId, storage, minted) => {
   }
   registry.pending.set(appId, run);
   void run.then((outcome) => {
-    var _a2;
+    var _a;
     if (outcome.durable) return;
-    (_a2 = registry.pending) == null ? void 0 : _a2.delete(appId);
+    (_a = registry.pending) == null ? void 0 : _a.delete(appId);
     registry.hydrating.delete(appId);
   });
   return run;
 };
 var resolveAutoDeviceKey = (opts = {}) => {
-  var _a2, _b;
+  var _a, _b;
   const registry = autoDeviceKeyRegistry();
-  const appId = (_a2 = opts.appId) != null ? _a2 : "default";
+  const appId = (_a = opts.appId) != null ? _a : "default";
   let id = registry.keys.get(appId);
   if (!id) {
     id = mintDeviceId();
@@ -1297,19 +1095,19 @@ var resolveAutoDeviceKey = (opts = {}) => {
   return (_b = registry.keys.get(appId)) != null ? _b : id;
 };
 var resetAutoDeviceKeys = () => {
-  var _a2;
+  var _a;
   const registry = autoDeviceKeyRegistry();
   registry.keys.clear();
   registry.hydrating.clear();
-  (_a2 = registry.pending) == null ? void 0 : _a2.clear();
+  (_a = registry.pending) == null ? void 0 : _a.clear();
 };
 
 // src/analytics/analyticsFacade.ts
 var createAnalytics = (config, options = {}) => {
-  var _a2, _b, _c;
+  var _a, _b, _c;
   const resolveSessionId = () => {
-    var _a3;
-    return (_a3 = config.sessionId) != null ? _a3 : ensureCurrentSessionId();
+    var _a2;
+    return (_a2 = config.sessionId) != null ? _a2 : ensureCurrentSessionId();
   };
   if (config.sessionId) {
     warnInDev(
@@ -1317,7 +1115,7 @@ var createAnalytics = (config, options = {}) => {
     );
   }
   const detectedAppVersion = detectAppVersion();
-  let userContext = { ...(_a2 = config.userContext) != null ? _a2 : {} };
+  let userContext = { ...(_a = config.userContext) != null ? _a : {} };
   const hostDeviceKeyAtInit = typeof ((_b = config.userContext) == null ? void 0 : _b.deviceKey) === "string" && config.userContext.deviceKey.trim() ? config.userContext.deviceKey.trim() : void 0;
   resolveIdentity({
     value: hostDeviceKeyAtInit,
@@ -1332,10 +1130,10 @@ var createAnalytics = (config, options = {}) => {
   };
   if (!hostDeviceKeyAtInit) resolveAutoDeviceKey(autoDeviceKeyOptions);
   const envelope = () => {
-    var _a3;
+    var _a2;
     return buildContextEnvelope({
       sessionId: resolveSessionId(),
-      appVersion: (_a3 = userContext.appVersion) != null ? _a3 : config.appVersion,
+      appVersion: (_a2 = userContext.appVersion) != null ? _a2 : config.appVersion,
       appBuild: config.appBuild,
       networkType: config.networkType
     });
@@ -1356,12 +1154,12 @@ var createAnalytics = (config, options = {}) => {
     });
   }
   const applyContext = (event) => {
-    var _a3, _b2;
+    var _a2, _b2;
     const hostDeviceKey = typeof userContext.deviceKey === "string" && userContext.deviceKey.trim() ? userContext.deviceKey : void 0;
     const resolved = resolveUserContext(
       // `??` 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 }
+      { autoAppVersion: (_a2 = config.appVersion) != null ? _a2 : detectedAppVersion }
     );
     if (resolved.userContext) {
       event.user_context = { ...resolved.userContext, ...(_b2 = event.user_context) != null ? _b2 : {} };
@@ -1376,9 +1174,9 @@ var createAnalytics = (config, options = {}) => {
     return void 0;
   };
   const setUserContext = (partial) => {
-    var _a3, _b2;
+    var _a2, _b2;
     if (!partial || typeof partial !== "object") return;
-    const mergedExtra = partial.extra || userContext.extra ? { ...(_a3 = userContext.extra) != null ? _a3 : {}, ...(_b2 = partial.extra) != null ? _b2 : {} } : void 0;
+    const mergedExtra = partial.extra || userContext.extra ? { ...(_a2 = userContext.extra) != null ? _a2 : {}, ...(_b2 = partial.extra) != null ? _b2 : {} } : void 0;
     userContext = { ...userContext, ...partial };
     if (mergedExtra) userContext.extra = mergedExtra;
     const uid = sanitizeUserId(partial.userId);
@@ -1408,9 +1206,9 @@ var createAnalytics = (config, options = {}) => {
     applyContext(clientEvent);
     queue.enqueue(clientEvent);
   };
-  const screen = (name2, props) => {
-    if (!name2) return;
-    const meta = { screen: name2, ...props != null ? props : {} };
+  const screen = (name, props) => {
+    if (!name) return;
+    const meta = { screen: name, ...props != null ? props : {} };
     const clientEvent = {
       event_type: "app_event",
       session_id: resolveSessionId(),
@@ -1453,7 +1251,7 @@ var createAnalytics = (config, options = {}) => {
   };
 };
 var useAnalytics = (config, options = {}) => {
-  var _a2;
+  var _a;
   const ref = react.useRef(void 0);
   const prevKeys = react.useRef("");
   const currentKeys = `${config.serverUrl}|${config.apiKey}|${config.appId}`;
@@ -1461,10 +1259,10 @@ 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;
+  const hostDeviceKey = typeof ((_a = config.userContext) == null ? void 0 : _a.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 });
+    var _a2;
+    if (hostDeviceKey) (_a2 = ref.current) == null ? void 0 : _a2.setUserContext({ deviceKey: hostDeviceKey });
   }, [hostDeviceKey]);
   return ref.current;
 };
@@ -1498,5 +1296,6 @@ exports.setCurrentSessionId = setCurrentSessionId;
 exports.toAnalyticsEvent = toAnalyticsEvent;
 exports.useAnalytics = useAnalytics;
 exports.useScreenTracking = useScreenTracking;
+exports.wireDoctor = wireDoctor;
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map