@wireai/activation 0.13.3 → 0.13.5

package/dist/analytics/index.mjs

@@ -20,13 +20,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;
@@ -223,6 +225,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. */
@@ -1101,6 +1265,6 @@ var useAnalytics = (config, options = {}) => {
   return ref.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 };
+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 };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map