@wireai/activation 0.14.3 → 0.16.0

package/dist/index.js

@@ -1168,6 +1168,28 @@ var readProgress = (response) => {
   };
 };
 
+// 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) => {
@@ -1239,14 +1261,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";
   }
@@ -3478,11 +3503,11 @@ var provenanceRegistry = () => {
   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 (typeof input.value !== "string") return void 0;
+  if (!isUsableIdentityValue(input.value)) return void 0;
   const value = input.value.trim();
-  if (!value) return void 0;
   const durable = (_a = input.durable) != null ? _a : input.source === "host";
   if (input.source === "host") {
     provenanceRegistry().host.set(provenanceKey(input.space, input.scope), value);
@@ -3587,6 +3612,7 @@ var resetAutoDeviceKeys = () => {
   registry.keys.clear();
   registry.hydrating.clear();
   (_a = registry.pending) == null ? void 0 : _a.clear();
+  registry.ambient = void 0;
 };
 
 // src/analytics/currentSession.ts
@@ -3594,25 +3620,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;
   }
@@ -4452,17 +4504,31 @@ var failOpen = async (storage, key) => {
   const cached2 = await readCachedFeatures(storage, key);
   return (_a = cached2 == null ? void 0 : cached2.features) != null ? _a : defaultWireFeatures;
 };
-var fetchWithTimeout = async (url, apiKey, timeoutMs) => {
+var NO_ANSWER = /* @__PURE__ */ Symbol("wire-features-no-answer");
+var fetchFeaturesJson = async (url, apiKey, timeoutMs) => {
   const controller = typeof AbortController !== "undefined" ? new AbortController() : void 0;
-  const timer = setTimeout(() => controller == null ? void 0 : controller.abort(), timeoutMs);
-  try {
-    return await fetch(url, {
+  let timer;
+  const expired = new Promise((resolve) => {
+    timer = setTimeout(() => {
+      controller == null ? void 0 : controller.abort();
+      resolve(NO_ANSWER);
+    }, timeoutMs);
+  });
+  const exchange = (async () => {
+    const res = await fetch(url, {
       method: "GET",
       headers: { Accept: "application/json", Authorization: `Bearer ${apiKey}` },
       signal: controller == null ? void 0 : controller.signal
     });
+    if (!res || !res.ok) return NO_ANSWER;
+    return await res.json();
+  })();
+  try {
+    return await Promise.race([exchange, expired]);
   } finally {
     clearTimeout(timer);
+    void exchange.catch(() => {
+    });
   }
 };
 var fetchWireFeatures = async (config) => {
@@ -4472,9 +4538,8 @@ var fetchWireFeatures = async (config) => {
   const url = `${config.serverUrl.replace(/\/$/, "")}/v1/features`;
   const timeoutMs = config.timeoutMs && config.timeoutMs > 0 ? config.timeoutMs : DEFAULT_TIMEOUT_MS;
   try {
-    const res = await fetchWithTimeout(url, config.apiKey, timeoutMs);
-    if (!res || !res.ok) return failOpen(storage, key);
-    const json = await res.json();
+    const json = await fetchFeaturesJson(url, config.apiKey, timeoutMs);
+    if (json === NO_ANSWER) return failOpen(storage, key);
     const features = parseWireFeatures(json);
     if (storage) writeCachedFeatures(storage, key, features);
     return features;
@@ -4488,50 +4553,65 @@ var useStableValue = (value, isEqual) => {
   return ref.current;
 };
 var sameFetchKey = (a, b) => (a == null ? void 0 : a.serverUrl) === (b == null ? void 0 : b.serverUrl) && (a == null ? void 0 : a.apiKey) === (b == null ? void 0 : b.apiKey) && (a == null ? void 0 : a.appId) === (b == null ? void 0 : b.appId);
-var useWireFeatures = (config) => {
+var useWireFeaturesState = (config) => {
   const stableConfig = useStableValue(config, sameFetchKey);
   const [flags, setFlags] = React19.useState(defaultWireFeatures);
   const canFetch = !!(stableConfig == null ? void 0 : stableConfig.serverUrl) && !!(stableConfig == null ? void 0 : stableConfig.apiKey);
+  const [settled, setSettled] = React19.useState(!canFetch);
   React19.useEffect(() => {
     if (!canFetch) {
       setFlags((prev) => featuresEqual(prev, defaultWireFeatures) ? prev : defaultWireFeatures);
+      setSettled(true);
       return;
     }
     let alive = true;
     void fetchWireFeatures(stableConfig).then((next) => {
       if (!alive) return;
       setFlags((prev) => featuresEqual(prev, next) ? prev : next);
+      setSettled(true);
     });
     return () => {
       alive = false;
     };
   }, [canFetch, stableConfig]);
-  return flags;
+  return React19.useMemo(() => ({ flags, settled }), [flags, settled]);
 };
+var useWireFeatures = (config) => useWireFeaturesState(config).flags;
 var CONTEXT_SYMBOL = /* @__PURE__ */ Symbol.for("wireai.features.context");
-var globalObj = globalThis;
-if (!globalObj[CONTEXT_SYMBOL]) {
-  globalObj[CONTEXT_SYMBOL] = React19.createContext(null);
+var featuresContextGlobal = globalThis;
+if (!featuresContextGlobal[CONTEXT_SYMBOL]) {
+  featuresContextGlobal[CONTEXT_SYMBOL] = React19.createContext(null);
 }
-var WireFeaturesContext = globalObj[CONTEXT_SYMBOL];
+var WireFeaturesContext = featuresContextGlobal[CONTEXT_SYMBOL];
+var SETTLED_SYMBOL = /* @__PURE__ */ Symbol.for("wireai.features.settled.context");
+var settledContextGlobal = globalThis;
+if (!settledContextGlobal[SETTLED_SYMBOL]) {
+  settledContextGlobal[SETTLED_SYMBOL] = React19.createContext(true);
+}
+var WireFeaturesSettledContext = settledContextGlobal[SETTLED_SYMBOL];
 var WireFeaturesProvider = ({
   config,
   flags,
   children
 }) => {
-  const fetched = useWireFeatures(flags ? void 0 : config);
-  const value = flags != null ? flags : fetched;
+  const fetched = useWireFeaturesState(flags ? void 0 : config);
+  const value = flags != null ? flags : fetched.flags;
+  const settled = flags ? true : fetched.settled;
   const stable = React19.useMemo(() => value, [value]);
-  return /* @__PURE__ */ jsxRuntime.jsx(WireFeaturesContext.Provider, { value: stable, children });
+  return /* @__PURE__ */ jsxRuntime.jsx(WireFeaturesSettledContext.Provider, { value: settled, children: /* @__PURE__ */ jsxRuntime.jsx(WireFeaturesContext.Provider, { value: stable, children }) });
 };
 WireFeaturesProvider.displayName = "WireFeaturesProvider";
 var useWireFeaturesContext = () => React19.useContext(WireFeaturesContext);
-var useResolvedFeatures = (options) => {
+var useResolvedFeatures = (options) => useResolvedFeaturesState(options).flags;
+var useResolvedFeaturesState = (options) => {
   var _a, _b, _c;
   const ctx = useWireFeaturesContext();
+  const ctxSettled = React19.useContext(WireFeaturesSettledContext);
   const shouldFetch = !(options == null ? void 0 : options.flags) && ctx == null;
-  const fetched = useWireFeatures(shouldFetch ? options == null ? void 0 : options.config : void 0);
-  return (_c = (_b = (_a = options == null ? void 0 : options.flags) != null ? _a : ctx) != null ? _b : fetched) != null ? _c : defaultWireFeatures;
+  const fetched = useWireFeaturesState(shouldFetch ? options == null ? void 0 : options.config : void 0);
+  const flags = (_c = (_b = (_a = options == null ? void 0 : options.flags) != null ? _a : ctx) != null ? _b : fetched.flags) != null ? _c : defaultWireFeatures;
+  const settled = (options == null ? void 0 : options.flags) ? true : ctx != null ? ctxSettled : fetched.settled;
+  return React19.useMemo(() => ({ flags, settled }), [flags, settled]);
 };
 
 // src/config/wireConfigFromEnv.ts
@@ -5275,8 +5355,12 @@ var useSessionStart = (config, options = {}) => {
         fireOpen(void 0);
         return;
       }
-      void hydrateDeviceIdentity({ appId: cfg.appId, storage: cfg.storage }).then((identity) => {
+      void withTimeout(
+        hydrateDeviceIdentity({ appId: cfg.appId, storage: cfg.storage }),
+        READ_TIMEOUT_MS
+      ).then((read) => {
         if (cancelled) return;
+        const identity = read === READ_TIMED_OUT ? void 0 : read;
         fireOpen((identity == null ? void 0 : identity.durable) ? identity.value : void 0);
       });
     };
@@ -5376,8 +5460,9 @@ var emitFirstOpen = (opts) => {
   routeLifecycleEvent(buildLifecycleEvent(FIRST_OPEN_EVENT, opts), opts);
 };
 var reportFirstOpen = (opts) => {
-  var _a;
-  const appId = (_a = opts.appId) != null ? _a : "default";
+  var _a, _b;
+  if (!opts.sink && !((_a = opts.target) == null ? void 0 : _a.serverUrl)) return;
+  const appId = (_b = opts.appId) != null ? _b : "default";
   if (_firstOpenLatched.has(appId)) return;
   _firstOpenLatched.add(appId);
   const storage = opts.storage;
@@ -5462,8 +5547,12 @@ var useLifecycleEvents = (config, options = {}) => {
         fire(void 0);
         return;
       }
-      void hydrateDeviceIdentity({ appId: cfg.appId, storage: cfg.storage }).then((identity) => {
+      void withTimeout(
+        hydrateDeviceIdentity({ appId: cfg.appId, storage: cfg.storage }),
+        READ_TIMEOUT_MS
+      ).then((read) => {
         if (cancelled) return;
+        const identity = read === READ_TIMED_OUT ? void 0 : read;
         fire((identity == null ? void 0 : identity.durable) ? identity.value : void 0);
       });
     };