@wireai/activation 0.12.1 → 0.13.0

package/dist/analytics/index.mjs

@@ -411,28 +411,35 @@ var buildEventsRequest = (target, events) => {
     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) => e == null ? void 0 : e.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 {
   }
@@ -443,13 +450,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"
@@ -464,13 +486,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"
@@ -818,6 +833,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) => {
@@ -849,7 +889,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;
@@ -1100,6 +1141,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"}`;
@@ -1122,24 +1186,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 = {}) => {
@@ -1167,11 +1244,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 = () => {
@@ -1179,13 +1251,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).
@@ -1231,7 +1309,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;
@@ -1330,6 +1408,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, 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 };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map