@wireai/activation 0.12.2 → 0.13.2

package/dist/analytics/index.js

@@ -402,39 +402,63 @@ var init_Constants = __esm({
 
 // src/analytics/reportClientEvent.ts
 var makeSessionId = () => `wire_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;
+var toWireEvents = (events) => events.map((event) => {
+  if (typeof event.ts !== "number") return event;
+  const { ts, ...rest } = event;
+  if (!Number.isFinite(ts)) return rest;
+  try {
+    return { ...rest, ts: new Date(ts).toISOString() };
+  } catch {
+    return rest;
+  }
+});
 var buildEventsRequest = (target, events) => {
   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}`;
-    return { url, init: { method: "POST", headers, body: JSON.stringify({ events }) } };
+    const body = JSON.stringify({ events: toWireEvents(events) });
+    return { url, init: { method: "POST", headers, body } };
   } catch {
     return null;
   }
 };
-var warnOnSkippedEvents = (res) => {
-  if (typeof __DEV__ === "undefined" || !__DEV__) return;
-  if (typeof console === "undefined" || !console.warn) return;
+var readEventsAck = async (res) => {
   try {
     const json = res == null ? void 0 : res.json;
-    if (typeof json !== "function") return;
-    void Promise.resolve(json.call(res)).then((body) => {
-      const skipped = body == null ? void 0 : body.skipped;
-      if (typeof skipped !== "number" || skipped <= 0) return;
-      console.warn(
-        `[wireai] the server ACCEPTED the /v1/events POST but DISCARDED ${skipped} event(s) (skipped in the response body) \u2014 they are gone, not retried. The usual cause is an event with a missing or empty session_id.`
-      );
-    }).catch(() => {
-    });
+    if (typeof json !== "function") return void 0;
+    const body = await Promise.resolve(json.call(res));
+    const skipped = body == null ? void 0 : body.skipped;
+    if (typeof skipped !== "number" || !Number.isFinite(skipped)) return void 0;
+    const reasons = Array.isArray(body == null ? void 0 : body.errors) ? body.errors.map((e) => {
+      const entry = e;
+      const reason = entry == null ? void 0 : entry.reason;
+      if (typeof reason !== "string") return void 0;
+      const field = entry == null ? void 0 : entry.field;
+      return typeof field === "string" && field.length > 0 ? `${reason} (field: ${field})` : reason;
+    }).filter((r) => typeof r === "string") : [];
+    return { written: typeof (body == null ? void 0 : body.written) === "number" ? body.written : void 0, skipped, reasons };
   } catch {
+    return void 0;
   }
 };
+var describeDiscarded = (ack) => `[wireai] the server ACCEPTED the /v1/events POST but DISCARDED ${ack.skipped} event(s) (skipped in the response body) \u2014 they are gone, not retried. The server reported: skipped=${ack.skipped}${ack.written !== void 0 ? `, written=${ack.written}` : ""}` + (ack.reasons.length > 0 ? `, reasons: ${ack.reasons.join(", ")}.` : ". It gave no reason (the endpoint folds every rejection into one count), so check the server's ingest log for this request rather than guessing.");
+var warnOnSkippedEvents = (res) => {
+  if (typeof __DEV__ === "undefined" || !__DEV__) return;
+  if (typeof console === "undefined" || !console.warn) return;
+  void readEventsAck(res).then((ack) => {
+    if (!ack || ack.skipped <= 0) return;
+    console.warn(describeDiscarded(ack));
+  });
+};
 var reportClientEvents = (target, events) => {
   try {
     const req = buildEventsRequest(target, events);
     if (!req) return;
-    void fetch(req.url, req.init).catch(() => {
+    void fetch(req.url, req.init).then((res) => {
+      warnOnSkippedEvents(res);
+    }).catch(() => {
     });
   } catch {
   }
@@ -445,13 +469,28 @@ var reportClientEventsAwait = async (target, events) => {
     const req = buildEventsRequest(target, events);
     if (!req) return false;
     const res = await fetch(req.url, req.init);
-    return Boolean(res && res.ok);
+    if (!res || !res.ok) return false;
+    const ack = await readEventsAck(res);
+    if (!ack || ack.skipped <= 0) return true;
+    if (typeof __DEV__ !== "undefined" && __DEV__ && typeof console !== "undefined" && console.warn) {
+      console.warn(describeDiscarded(ack));
+    }
+    return false;
   } catch {
     return false;
   }
 };
 var reportClientEventAwait = (target, event) => reportClientEventsAwait(target, [event]);
 
+// src/utils/warnInDev.ts
+var warnInDev = (message) => {
+  if (typeof __DEV__ !== "undefined" && __DEV__ && typeof console !== "undefined" && console.warn) {
+    console.warn(message);
+    return true;
+  }
+  return false;
+};
+
 // src/analytics/currentSession.ts
 var CURRENT_SESSION_ID_SLOT = /* @__PURE__ */ Symbol.for(
   "@wireai/activation:currentSessionId"
@@ -466,13 +505,6 @@ var getCurrentSessionId = () => globalSlot[CURRENT_SESSION_ID_SLOT];
 var resetCurrentSessionId = () => {
   globalSlot[CURRENT_SESSION_ID_SLOT] = void 0;
 };
-var warnInDev = (message) => {
-  if (typeof __DEV__ !== "undefined" && __DEV__ && typeof console !== "undefined" && console.warn) {
-    console.warn(message);
-    return true;
-  }
-  return false;
-};
 var MINT_WARNING = "[wireai] No app-open session was registered, so a session id was minted for this event (the server drops an event that has no session_id, and still answers 200). Mount useLifecycleEvents at your app root so events correlate to a real app-open.";
 var MINT_WARNED_SLOT = /* @__PURE__ */ Symbol.for(
   "@wireai/activation:currentSessionIdMintWarned"
@@ -583,6 +615,43 @@ var useScreenTracking = (navigationRef, options = {}) => {
   }, [navigationRef]);
 };
 
+// src/permissions/permissionEvents.ts
+var WIRE_PERMISSION_EVENTS = {
+  /** The priming screen became visible. The denominator for every rate below. */
+  screenShown: "wire_permission_screen_shown",
+  /** The user tapped the primary, so the OS dialog is about to open. The rationale worked. */
+  primerAccepted: "wire_permission_primer_accepted",
+  /** The OS granted it. */
+  granted: "wire_permission_granted",
+  /** The OS refused it (a permanently blocked answer reports here too, with `status: "blocked"`). */
+  denied: "wire_permission_denied",
+  /** The user took the secondary. The one native prompt was NOT spent. */
+  skipped: "wire_permission_skipped",
+  /** A blocked user was redirected to the OS settings page. */
+  settingsOpened: "wire_permission_settings_opened"
+};
+var permissionEventName = (stage) => {
+  switch (stage) {
+    case "shown":
+      return WIRE_PERMISSION_EVENTS.screenShown;
+    case "accepted":
+      return WIRE_PERMISSION_EVENTS.primerAccepted;
+    case "granted":
+      return WIRE_PERMISSION_EVENTS.granted;
+    case "denied":
+      return WIRE_PERMISSION_EVENTS.denied;
+    case "skipped":
+      return WIRE_PERMISSION_EVENTS.skipped;
+    case "settings":
+      return WIRE_PERMISSION_EVENTS.settingsOpened;
+    default: {
+      const _exhaustive = stage;
+      return _exhaustive;
+    }
+  }
+};
+var permissionEventProps = (permission, status) => status ? { permission, status } : { permission };
+
 // src/analytics/analyticsEvent.ts
 var WIRE_ONBOARDING_EVENTS = {
   started: "wire_onboarding_started",
@@ -615,6 +684,11 @@ var toAnalyticsEvent = (event) => {
       };
     case "fallback":
       return { name: WIRE_ONBOARDING_EVENTS.fallback, params: { reason: event.reason } };
+    case "permission":
+      return {
+        name: permissionEventName(event.stage),
+        params: permissionEventProps(event.permission, event.status)
+      };
     default: {
       const _exhaustive = event;
       return _exhaustive;
@@ -820,6 +894,31 @@ var DEFAULTS = {
   maxRetries: 6
 };
 var READ_TIMEOUT_MS = 1500;
+var QUEUE_KEY_SLOT = /* @__PURE__ */ Symbol.for("@wireai/activation:eventQueueKeys");
+var queueKeyGlobal = globalThis;
+var claimedQueueKeys = () => {
+  const existing = queueKeyGlobal[QUEUE_KEY_SLOT];
+  if (existing) return existing;
+  const created = /* @__PURE__ */ new Set();
+  queueKeyGlobal[QUEUE_KEY_SLOT] = created;
+  return created;
+};
+var claimQueueKey = (preferred, explicit) => {
+  const claimed = claimedQueueKeys();
+  if (explicit || !claimed.has(preferred)) {
+    claimed.add(preferred);
+    return preferred;
+  }
+  let ordinal = 2;
+  while (claimed.has(`${preferred}#${ordinal}`)) ordinal++;
+  const key = `${preferred}#${ordinal}`;
+  claimed.add(key);
+  warnInDev(
+    `[wireai] a second event queue was created for the same appId, and "${preferred}" is already claimed by a live one. Two queues sharing one storage slot overwrite each other's backlog, delete each other's pending events when one drains to empty, and double-send on relaunch, so this queue was given "${key}" instead. Prefer ONE analytics instance per app; if you really need two, pass an explicit \`storageKey\` to each so the slots are yours to reason about.`
+  );
+  return key;
+};
+var resetEventQueueKeys = () => claimedQueueKeys().clear();
 var withTimeout = (p, ms) => {
   let timer;
   const timeout = new Promise((resolve) => {
@@ -851,7 +950,8 @@ var createEventQueue = (options) => {
   var _a2, _b, _c, _d, _e, _f, _g;
   const target = options.target;
   const storage = options.storage;
-  const key = (_b = options.storageKey) != null ? _b : `wireai:evtq:${(_a2 = options.appId) != null ? _a2 : "default"}`;
+  const defaultKey = (_b = options.storageKey) != null ? _b : `wireai:evtq:${(_a2 = options.appId) != null ? _a2 : "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;
   const baseBackoffMs = (_e = options.baseBackoffMs) != null ? _e : DEFAULTS.baseBackoffMs;
@@ -1102,6 +1202,29 @@ 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 _a2;
+  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";
+  {
+    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"}`;
@@ -1124,24 +1247,37 @@ var startHydration = (registry, appId, storage, minted) => {
   const existing = registry.pending.get(appId);
   if (existing) return existing;
   const slot = deviceIdStorageKey(appId);
-  const settled = () => {
+  const degraded = () => {
     var _a2;
-    return (_a2 = registry.keys.get(appId)) != null ? _a2 : minted;
+    return { value: (_a2 = registry.keys.get(appId)) != null ? _a2 : 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 persisted;
+        return adopted(persisted);
       }
-      return Promise.resolve(storage.setItem(slot, minted)).then(settled, settled);
-    }).catch(settled);
+      return Promise.resolve(storage.setItem(slot, minted)).then(
+        () => {
+          var _a2;
+          return adopted((_a2 = registry.keys.get(appId)) != null ? _a2 : minted);
+        },
+        degraded
+      );
+    }).catch(degraded);
   } catch {
-    run = Promise.resolve(settled());
+    run = Promise.resolve(degraded());
   }
   registry.pending.set(appId, run);
+  void run.then((outcome) => {
+    var _a2;
+    if (outcome.durable) return;
+    (_a2 = registry.pending) == null ? void 0 : _a2.delete(appId);
+    registry.hydrating.delete(appId);
+  });
   return run;
 };
 var resolveAutoDeviceKey = (opts = {}) => {
@@ -1169,11 +1305,6 @@ var resetAutoDeviceKeys = () => {
 };
 
 // src/analytics/analyticsFacade.ts
-var warnInDev2 = (message) => {
-  if (typeof __DEV__ !== "undefined" && __DEV__ && typeof console !== "undefined" && console.warn) {
-    console.warn(message);
-  }
-};
 var createAnalytics = (config, options = {}) => {
   var _a2, _b, _c;
   const resolveSessionId = () => {
@@ -1181,13 +1312,19 @@ var createAnalytics = (config, options = {}) => {
     return (_a3 = config.sessionId) != null ? _a3 : ensureCurrentSessionId();
   };
   if (config.sessionId) {
-    warnInDev2(
+    warnInDev(
       "[wireai] createAnalytics({ sessionId }) PINS every event from this instance to that one frozen id and opts out of the live per-open session (app.session_started) \u2014 lifecycle analytics collapse onto a single device-scoped id. Remove it unless your host runs its own session lifecycle."
     );
   }
   const detectedAppVersion = detectAppVersion();
   let userContext = { ...(_a2 = config.userContext) != null ? _a2 : {} };
   const hostDeviceKeyAtInit = typeof ((_b = config.userContext) == null ? void 0 : _b.deviceKey) === "string" && config.userContext.deviceKey.trim() ? config.userContext.deviceKey.trim() : void 0;
+  resolveIdentity({
+    value: hostDeviceKeyAtInit,
+    space: "device",
+    source: "host",
+    scope: config.appId
+  });
   const autoDeviceKeyOptions = {
     appId: config.appId,
     // A host-supplied deviceKey opts out of minting AND persisting (unchanged contract).
@@ -1233,7 +1370,7 @@ var createAnalytics = (config, options = {}) => {
   };
   const guardUserId = (clean) => {
     if (config.allowEmailAsUserId || !looksLikeEmail(clean)) return clean;
-    warnInDev2(
+    warnInDev(
       "[wireai] identify() was called with an email-shaped id. A raw email must NOT be the opaque user_id (PII leak) \u2014 pass it as userContext.userEmail instead. Binding was skipped. Set allowEmailAsUserId:true on createAnalytics if your user id genuinely is an email."
     );
     return void 0;
@@ -1354,6 +1491,7 @@ exports.reportClientEvents = reportClientEvents;
 exports.reportClientEventsAwait = reportClientEventsAwait;
 exports.resetAutoDeviceKeys = resetAutoDeviceKeys;
 exports.resetCurrentSessionId = resetCurrentSessionId;
+exports.resetEventQueueKeys = resetEventQueueKeys;
 exports.resolveAutoDeviceKey = resolveAutoDeviceKey;
 exports.screenTrackingHandler = screenTrackingHandler;
 exports.setCurrentSessionId = setCurrentSessionId;