@wireai/activation 0.14.3 → 0.16.0

package/dist/reviews/index.d.mts

@@ -1,11 +1,11 @@
 import React__default from 'react';
-import { R as ReviewGateProps, a as ReviewPresentation, U as UseReviewGateOptions, b as ReviewGateController, c as ReviewDecision, d as ReviewStoreConfig } from '../types-Cju-1_jT.mjs';
-export { e as RatingRoute, f as ReviewConfig, g as ReviewDecisionResponse, h as ReviewGateEvent, i as ReviewGateEventName, j as ReviewSubmission, k as ReviewTarget, S as SubmitResult } from '../types-Cju-1_jT.mjs';
+import { R as ReviewGateProps, a as ReviewPresentation, U as UseReviewGateOptions, b as ReviewGateController, c as ReviewDecision, d as ReviewStoreConfig } from '../types-Byx306Kv.mjs';
+export { e as RatingRoute, f as ReviewConfig, g as ReviewDecisionResponse, h as ReviewGateEvent, i as ReviewGateEventName, j as ReviewSubmission, k as ReviewTarget, S as SubmitResult } from '../types-Byx306Kv.mjs';
 export { C as ReviewModal, a as ReviewModalHandle, b as ReviewModalProps } from '../CenteredModal-C3qQBHsA.mjs';
-export { G as GateRules, a as GateSignals, b as buildReviewSubmission, d as decideReview, e as evaluateGate, r as resolveRules, c as routeRating } from '../decision-Bgo17oH7.mjs';
+export { G as GateRules, a as GateSignals, b as buildReviewSubmission, d as decideReview, e as evaluateGate, r as resolveRules, c as routeRating } from '../decision-yBj2AyPW.mjs';
 import { c as OnboardingFonts } from '../types-BKfpdZzX.mjs';
-export { F as FetchReviewDecisionOptions, R as ReportAppEventOptions, a as ReviewSubmitResult, f as fetchReviewDecision, r as reportAppEvent, s as submitReview } from '../transport-j5gFfJhK.mjs';
-import '../types-BcmagF6K.mjs';
+export { F as FetchReviewDecisionOptions, R as ReportAppEventOptions, a as ReviewSubmitResult, f as fetchReviewDecision, r as reportAppEvent, s as submitReview } from '../transport-s5QxA-ci.mjs';
+import '../types-D_0B0yay.mjs';
 import '../types-BpwiRpA8.mjs';
 
 /**
@@ -41,7 +41,11 @@ declare const reviewSessionsKey: (id: string) => string;
  *
  * The form NEVER asks for identity (no name / email / contact field): the host already
  * identifies the user via `sessionId` + `meta` (e.g. user_id, device_key), which is all
- * the POST body carries alongside the rating and the free text.
+ * the POST body carries alongside the rating and the free text. Since 2026-08-19 the gate also
+ * fills in `meta.device_key` from the kit's own per-install id when the host passed none — not for
+ * identification, but because it is the unit the server scopes the idempotency key to, and without
+ * it the key is discarded. Any non-blank string the host passes still wins verbatim. See
+ * `idempotency.ts`.
  *
  * Motion (2026-07-16): the three phases used to swap IN PLACE with no transition. They now
  * ride `ModalPaneHost`, the same pane-slide primitive the questionnaire steps use, and the

package/dist/reviews/index.d.ts

@@ -1,11 +1,11 @@
 import React__default from 'react';
-import { R as ReviewGateProps, a as ReviewPresentation, U as UseReviewGateOptions, b as ReviewGateController, c as ReviewDecision, d as ReviewStoreConfig } from '../types-h2BZvl1t.js';
-export { e as RatingRoute, f as ReviewConfig, g as ReviewDecisionResponse, h as ReviewGateEvent, i as ReviewGateEventName, j as ReviewSubmission, k as ReviewTarget, S as SubmitResult } from '../types-h2BZvl1t.js';
+import { R as ReviewGateProps, a as ReviewPresentation, U as UseReviewGateOptions, b as ReviewGateController, c as ReviewDecision, d as ReviewStoreConfig } from '../types-tdATL5z0.js';
+export { e as RatingRoute, f as ReviewConfig, g as ReviewDecisionResponse, h as ReviewGateEvent, i as ReviewGateEventName, j as ReviewSubmission, k as ReviewTarget, S as SubmitResult } from '../types-tdATL5z0.js';
 export { C as ReviewModal, a as ReviewModalHandle, b as ReviewModalProps } from '../CenteredModal-Cdgns6--.js';
-export { G as GateRules, a as GateSignals, b as buildReviewSubmission, d as decideReview, e as evaluateGate, r as resolveRules, c as routeRating } from '../decision-Bkh_LigV.js';
+export { G as GateRules, a as GateSignals, b as buildReviewSubmission, d as decideReview, e as evaluateGate, r as resolveRules, c as routeRating } from '../decision-3vWLuBlO.js';
 import { c as OnboardingFonts } from '../types-BKfpdZzX.js';
-export { F as FetchReviewDecisionOptions, R as ReportAppEventOptions, a as ReviewSubmitResult, f as fetchReviewDecision, r as reportAppEvent, s as submitReview } from '../transport-B_0SgCBe.js';
-import '../types-BcmagF6K.js';
+export { F as FetchReviewDecisionOptions, R as ReportAppEventOptions, a as ReviewSubmitResult, f as fetchReviewDecision, r as reportAppEvent, s as submitReview } from '../transport-xqqSFqxs.js';
+import '../types-D_0B0yay.js';
 import '../types-BpwiRpA8.js';
 
 /**
@@ -41,7 +41,11 @@ declare const reviewSessionsKey: (id: string) => string;
  *
  * The form NEVER asks for identity (no name / email / contact field): the host already
  * identifies the user via `sessionId` + `meta` (e.g. user_id, device_key), which is all
- * the POST body carries alongside the rating and the free text.
+ * the POST body carries alongside the rating and the free text. Since 2026-08-19 the gate also
+ * fills in `meta.device_key` from the kit's own per-install id when the host passed none — not for
+ * identification, but because it is the unit the server scopes the idempotency key to, and without
+ * it the key is discarded. Any non-blank string the host passes still wins verbatim. See
+ * `idempotency.ts`.
  *
  * Motion (2026-07-16): the three phases used to swap IN PLACE with no transition. They now
  * ride `ModalPaneHost`, the same pane-slide primitive the questionnaire steps use, and the

package/dist/reviews/index.js

@@ -546,6 +546,7 @@ var buildReviewSubmission = (input) => {
   if (contact) body.contact = contact;
   if (input.sessionId) body.session_id = input.sessionId;
   if (input.source) body.source = input.source;
+  if (input.idempotencyKey) body.idempotency_key = input.idempotencyKey;
   if (input.meta && Object.keys(input.meta).length > 0) body.meta = input.meta;
   return body;
 };
@@ -563,6 +564,43 @@ var feedbackInputHeights = (fonts, verticalPadding = 0) => {
   };
 };
 
+// src/context/deviceId.ts
+var AUTO_DEVICE_ID_PREFIX = "wdev_";
+var randomChunk = () => Math.floor(Math.random() * 4294967296).toString(36).padStart(6, "0");
+var mintDeviceId = () => {
+  const time = Date.now().toString(36);
+  return `${AUTO_DEVICE_ID_PREFIX}${time}_${randomChunk()}${randomChunk()}`;
+};
+var AUTO_DEVICE_KEY_SLOT = /* @__PURE__ */ Symbol.for("@wireai/activation:autoDeviceKeys");
+var deviceKeyGlobal = globalThis;
+var autoDeviceKeyRegistry = () => {
+  const existing = deviceKeyGlobal[AUTO_DEVICE_KEY_SLOT];
+  if (existing) return existing;
+  const created = { keys: /* @__PURE__ */ new Map(), hydrating: /* @__PURE__ */ new Set() };
+  deviceKeyGlobal[AUTO_DEVICE_KEY_SLOT] = created;
+  return created;
+};
+var ambientAutoDeviceKey = () => {
+  const registry = autoDeviceKeyRegistry();
+  if (registry.keys.size > 1) return void 0;
+  const sole = [...registry.keys.values()][0];
+  if (sole) return sole;
+  if (!registry.ambient) registry.ambient = mintDeviceId();
+  return registry.ambient;
+};
+
+// src/reviews/idempotency.ts
+var REVIEW_IDEMPOTENCY_PREFIX = "rvw_";
+var mintIdempotencyKey = () => `${REVIEW_IDEMPOTENCY_PREFIX}${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;
+var hasDeviceKey = (meta) => {
+  const value = meta == null ? void 0 : meta.device_key;
+  return typeof value === "string" && value.trim().length > 0;
+};
+var createImpression = () => ({
+  idempotencyKey: mintIdempotencyKey(),
+  deviceKey: ambientAutoDeviceKey()
+});
+
 // src/motion/centeredModalMotion.ts
 var CENTERED_MODAL_ANIM = {
   /** Spring config for the card scale/opacity entrance (mirrors CompletionView's pop). */
@@ -740,6 +778,28 @@ var requestStoreReview = async (store) => {
   return opened ? "store_url" : "none";
 };
 
+// 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) => {
@@ -781,17 +841,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 subscribeCurrentSessionId = (listener) => {
+  const set = listeners();
+  set.add(listener);
+  return () => {
+    set.delete(listener);
+  };
+};
 var getCurrentSessionId = () => globalSlot[CURRENT_SESSION_ID_SLOT];
 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 isMintedSessionId = (id) => id !== void 0 && id === mintedSlot[MINTED_SESSION_ID_SLOT];
 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;
   }
@@ -805,11 +899,15 @@ var submitReview = async (target, review) => {
     const url = `${target.serverUrl.replace(/\/$/, "")}/v1/reviews`;
     const headers = { "Content-Type": "application/json" };
     if (target.apiKey) headers.Authorization = `Bearer ${target.apiKey}`;
-    const res = await fetch(url, {
-      method: "POST",
-      headers,
-      body: JSON.stringify(review)
-    });
+    const res = await withDeadline(
+      (signal) => fetch(url, {
+        method: "POST",
+        headers,
+        body: JSON.stringify(review),
+        signal
+      })
+    );
+    if (res === DEADLINE_EXPIRED) return "unsent";
     if (!res) return "unsent";
     return res.ok ? "accepted" : "rejected";
   } catch {
@@ -827,9 +925,12 @@ var fetchReviewDecision = async (target, options = {}) => {
     const url = `${base}/v1/reviews/decision${qs ? `?${qs}` : ""}`;
     const headers = {};
     if (target.apiKey) headers.Authorization = `Bearer ${target.apiKey}`;
-    const res = await fetch(url, { headers });
-    if (!res || !res.ok) return null;
-    const json = await res.json();
+    const json = await withDeadline(async (signal) => {
+      const res = await fetch(url, { headers, signal });
+      if (!res || !res.ok) return null;
+      return await res.json();
+    });
+    if (json === DEADLINE_EXPIRED) return null;
     if (!json || typeof json.fire !== "boolean") return null;
     return json;
   } catch {
@@ -901,8 +1002,33 @@ var _ReviewGate = ({
   const resolve = React7.useCallback(() => {
     onResolved == null ? void 0 : onResolved();
   }, [onResolved]);
+  const impressionRef = React7__default.default.useRef(null);
+  const buildBody = React7.useCallback(
+    (input) => {
+      let impression = impressionRef.current;
+      if (!impression) {
+        impression = createImpression();
+        impressionRef.current = impression;
+      }
+      const merged = { ...meta, ...input.extraMeta };
+      if (!hasDeviceKey(merged) && impression.deviceKey) merged.device_key = impression.deviceKey;
+      return buildReviewSubmission({
+        stars: input.stars,
+        feedbackText: input.feedbackText,
+        suggestion: input.suggestion,
+        sessionId,
+        meta: merged,
+        idempotencyKey: impression.idempotencyKey
+      });
+    },
+    [meta, sessionId]
+  );
   const postedRef = React7__default.default.useRef(false);
   const unackedRef = React7__default.default.useRef(null);
+  const recoverOnSettleRef = React7__default.default.useRef(false);
+  const recoveredRef = React7__default.default.useRef(false);
+  const postOnceRef = React7__default.default.useRef(() => {
+  });
   const postOnce = React7.useCallback(
     (body) => {
       if (postedRef.current) return;
@@ -911,6 +1037,10 @@ var _ReviewGate = ({
       void submitReview(target, body).then((result) => {
         if (result === "unsent") {
           postedRef.current = false;
+          if (recoverOnSettleRef.current && !recoveredRef.current) {
+            recoveredRef.current = true;
+            postOnceRef.current(body);
+          }
           return;
         }
         unackedRef.current = null;
@@ -918,6 +1048,7 @@ var _ReviewGate = ({
     },
     [target]
   );
+  postOnceRef.current = postOnce;
   const abandonRef = React7__default.default.useRef(() => {
   });
   abandonRef.current = () => {
@@ -926,14 +1057,17 @@ var _ReviewGate = ({
       postOnce(undelivered);
       return;
     }
+    if (postedRef.current && undelivered) {
+      recoverOnSettleRef.current = true;
+      return;
+    }
     if (postedRef.current || stars < 1) return;
     postOnce(
-      buildReviewSubmission({
+      buildBody({
         stars,
         feedbackText: feedback,
         suggestion,
-        sessionId,
-        meta: { ...meta, abandoned: true }
+        extraMeta: { abandoned: true }
       })
     );
   };
@@ -958,10 +1092,9 @@ var _ReviewGate = ({
         onEvent == null ? void 0 : onEvent({ name: "store_review_requested", id, stars: value });
         const route = await requestStoreReview(store);
         postOnce(
-          buildReviewSubmission({
+          buildBody({
             stars: value,
-            sessionId,
-            meta: { ...meta, store_route: route }
+            extraMeta: { store_route: route }
           })
         );
         setPhase("thanks");
@@ -970,24 +1103,18 @@ var _ReviewGate = ({
         setPhase("feedback");
       }
     },
-    [onEvent, id, store, postOnce, sessionId, meta, resolveWithDelay]
+    [onEvent, id, store, postOnce, buildBody, resolveWithDelay]
   );
   const feedbackReady = feedback.trim().length > 0;
   const sendFeedback = React7.useCallback(() => {
     if (!feedbackReady) return;
-    const body = buildReviewSubmission({
-      stars,
-      feedbackText: feedback,
-      suggestion,
-      sessionId,
-      meta
-    });
+    const body = buildBody({ stars, feedbackText: feedback, suggestion });
     postOnce(body);
     onEvent == null ? void 0 : onEvent({ name: "review_feedback_submitted", id, stars });
     playHaptic("success");
     setPhase("thanks");
     resolveWithDelay();
-  }, [feedbackReady, stars, feedback, suggestion, sessionId, meta, postOnce, onEvent, id, resolveWithDelay]);
+  }, [feedbackReady, stars, feedback, suggestion, buildBody, postOnce, onEvent, id, resolveWithDelay]);
   const dismiss = React7.useCallback(() => {
     setPhase("thanks");
     resolveWithDelay();
@@ -1134,9 +1261,54 @@ var coachmarkRuntime = () => {
 var getCoachmarkStorage = () => coachmarkRuntime().storage;
 var isCoachmarkTesting = () => coachmarkRuntime().testing;
 var SEEN_VALUE = "1";
+var GATE_PROBE_KEY = "wire_gate_probe";
+var ASYNC_GATE_STORAGE_WARNED_SLOT = /* @__PURE__ */ Symbol.for(
+  "@wireai/activation:asyncGateStorageWarned"
+);
+var asyncGateWarnGlobal = globalThis;
+var closedGateStorage = Object.freeze({
+  getItem: () => SEEN_VALUE,
+  setItem: () => {
+  }
+});
+var syncGateAdapters = /* @__PURE__ */ new WeakSet();
+var asyncGateAdapters = /* @__PURE__ */ new WeakSet();
+var warnAsyncGateStorage = () => {
+  if (asyncGateWarnGlobal[ASYNC_GATE_STORAGE_WARNED_SLOT]) return;
+  if (typeof __DEV__ === "undefined" || !__DEV__) return;
+  if (typeof console === "undefined" || !console.warn) return;
+  asyncGateWarnGlobal[ASYNC_GATE_STORAGE_WARNED_SLOT] = true;
+  console.warn(
+    "[wireai] the gate storage's getItem returned a Promise \u2014 an async adapter (e.g. AsyncStorage) cannot drive the once-per-user gates, so coachmark tours, showcases and the review/questionnaire gates are all DISABLED (fail closed: nothing shows, nothing fires) until a synchronous adapter is provided. Pass a sync adapter (e.g. MMKV: `{ getItem: (k) => mmkv.getString(k) ?? null, setItem: (k, v) => mmkv.set(k, v) }`) to CoachmarkProvider or the gate's `storage` prop."
+  );
+};
+var validateGateStorage = (storage) => {
+  if (!storage) return null;
+  if (syncGateAdapters.has(storage)) return storage;
+  if (asyncGateAdapters.has(storage)) return closedGateStorage;
+  let probed;
+  try {
+    probed = storage.getItem(GATE_PROBE_KEY);
+  } catch {
+    syncGateAdapters.add(storage);
+    return storage;
+  }
+  if (probed != null && typeof probed.then === "function") {
+    asyncGateAdapters.add(storage);
+    try {
+      probed.then(void 0, () => {
+      });
+    } catch {
+    }
+    warnAsyncGateStorage();
+    return closedGateStorage;
+  }
+  syncGateAdapters.add(storage);
+  return storage;
+};
 var hasSeenGate = (key, storageOverride, testingOverride) => {
   if (testingOverride != null ? testingOverride : isCoachmarkTesting()) return false;
-  const storage = storageOverride != null ? storageOverride : getCoachmarkStorage();
+  const storage = validateGateStorage(storageOverride != null ? storageOverride : getCoachmarkStorage());
   if (!storage) return false;
   try {
     return storage.getItem(key) === SEEN_VALUE;
@@ -1146,7 +1318,7 @@ var hasSeenGate = (key, storageOverride, testingOverride) => {
 };
 var markSeenGate = (key, storageOverride, testingOverride) => {
   if (testingOverride != null ? testingOverride : isCoachmarkTesting()) return;
-  const storage = storageOverride != null ? storageOverride : getCoachmarkStorage();
+  const storage = validateGateStorage(storageOverride != null ? storageOverride : getCoachmarkStorage());
   if (!storage) return;
   try {
     storage.setItem(key, SEEN_VALUE);
@@ -1234,17 +1406,31 @@ var failOpen = async (storage, key) => {
   const cached = await readCachedFeatures(storage, key);
   return (_a = cached == null ? void 0 : cached.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) => {
@@ -1254,9 +1440,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;
@@ -1272,39 +1457,51 @@ 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] = React7.useState(defaultWireFeatures);
   const canFetch = !!(stableConfig == null ? void 0 : stableConfig.serverUrl) && !!(stableConfig == null ? void 0 : stableConfig.apiKey);
+  const [settled, setSettled] = React7.useState(!canFetch);
   React7.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 React7.useMemo(() => ({ flags, settled }), [flags, settled]);
 };
 var CONTEXT_SYMBOL = /* @__PURE__ */ Symbol.for("wireai.features.context");
-var globalObj = globalThis;
-if (!globalObj[CONTEXT_SYMBOL]) {
-  globalObj[CONTEXT_SYMBOL] = React7.createContext(null);
+var featuresContextGlobal = globalThis;
+if (!featuresContextGlobal[CONTEXT_SYMBOL]) {
+  featuresContextGlobal[CONTEXT_SYMBOL] = React7.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] = React7.createContext(true);
+}
+var WireFeaturesSettledContext = settledContextGlobal[SETTLED_SYMBOL];
 var useWireFeaturesContext = () => React7.useContext(WireFeaturesContext);
-var useResolvedFeatures = (options) => {
+var useResolvedFeaturesState = (options) => {
   var _a, _b, _c;
   const ctx = useWireFeaturesContext();
+  const ctxSettled = React7.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 React7.useMemo(() => ({ flags, settled }), [flags, settled]);
 };
 
 // src/reviews/equality.ts
@@ -1333,7 +1530,7 @@ var reviewSeenKey = (id, version) => version ? `wire_review_${id}_${version}_see
 var reviewLastShownKey = (id) => `wire_review_${id}_last`;
 var reviewSessionsKey = (id) => `wire_review_${id}_sessions`;
 var reviewSessionOpenKey = (id) => `wire_review_${id}_open`;
-var resolveStorage = (override) => override != null ? override : getCoachmarkStorage();
+var resolveStorage = (override) => validateGateStorage(override != null ? override : getCoachmarkStorage());
 var NO_STORAGE_WARNED_SLOT = /* @__PURE__ */ Symbol.for(
   "@wireai/activation:gateStorageWarned"
 );
@@ -1378,18 +1575,23 @@ var PROCESS_OPEN_ID_SLOT = /* @__PURE__ */ Symbol.for("@wireai/activation:proces
 var openIdGlobal = globalThis;
 var currentOpenId = () => {
   const live = getCurrentSessionId();
+  const liveMinted = isMintedSessionId(live);
   const pin = openIdGlobal[PROCESS_OPEN_ID_SLOT];
   if (!pin) {
     const openId = live != null ? live : makeSessionId();
-    openIdGlobal[PROCESS_OPEN_ID_SLOT] = { openId, observed: live };
+    openIdGlobal[PROCESS_OPEN_ID_SLOT] = { openId, observed: live, observedMinted: liveMinted };
     return openId;
   }
   if (!live || live === pin.observed) return pin.openId;
-  if (pin.observed === void 0) {
-    openIdGlobal[PROCESS_OPEN_ID_SLOT] = { openId: pin.openId, observed: live };
+  if (pin.observed === void 0 || pin.observedMinted) {
+    openIdGlobal[PROCESS_OPEN_ID_SLOT] = {
+      openId: pin.openId,
+      observed: live,
+      observedMinted: liveMinted
+    };
     return pin.openId;
   }
-  openIdGlobal[PROCESS_OPEN_ID_SLOT] = { openId: live, observed: live };
+  openIdGlobal[PROCESS_OPEN_ID_SLOT] = { openId: live, observed: live, observedMinted: liveMinted };
   return live;
 };
 var bumpSessionCount = (storage, sessionsKey, openKey, openId = currentOpenId()) => {
@@ -1427,17 +1629,32 @@ var useReviewGate = ({
     decisionProp,
     (a, b) => sameDecision(a, b)
   );
-  const featureEnabled = useResolvedFeatures({ flags: features, config: featuresConfig }).review.enabled;
+  const { flags: resolvedFeatures, settled: featuresSettled } = useResolvedFeaturesState({
+    flags: features,
+    config: featuresConfig
+  });
+  const featureEnabled = resolvedFeatures.review.enabled;
   const testing = isTesting != null ? isTesting : isCoachmarkTesting();
   const seenKey = reviewSeenKey(config.id, config.oncePerVersion === false ? void 0 : config.appVersion);
   const lastKey = reviewLastShownKey(config.id);
   const sessionsKey = reviewSessionsKey(config.id);
   const sessionOpenKey = reviewSessionOpenKey(config.id);
-  const sessions = React7.useState(() => {
+  const openSessionId = React7.useSyncExternalStore(
+    subscribeCurrentSessionId,
+    getCurrentSessionId,
+    getCurrentSessionId
+  );
+  const storageRef = React7.useRef(storage);
+  storageRef.current = storage;
+  const [sessions, setSessions] = React7.useState(() => {
     const store = resolveStorage(storage);
     warnMissingGateStorage(store, "review");
     return bumpSessionCount(store, sessionsKey, sessionOpenKey);
-  })[0];
+  });
+  React7.useEffect(() => {
+    const next = bumpSessionCount(resolveStorage(storageRef.current), sessionsKey, sessionOpenKey);
+    setSessions((prev) => prev === next ? prev : next);
+  }, [openSessionId, sessionsKey, sessionOpenKey]);
   const hasServerDecision = decision != null;
   const timeoutMs = config.timeoutFallbackMs;
   const waits = !hasServerDecision && timeoutMs != null && timeoutMs > 0;
@@ -1463,9 +1680,9 @@ var useReviewGate = ({
     });
     const resolved = decideReview(local, decision);
     const alreadySeen = hasSeenGate(seenKey, storage, isTesting);
-    const ready = hasServerDecision || elapsed;
+    const ready = (hasServerDecision || elapsed) && featuresSettled;
     return { visible: ready && resolved.fire && !alreadySeen, verdict: resolved };
-  }, [featureEnabled, testing, config, decision, events, sessions, elapsed, hasServerDecision, seenKey, lastKey, storage, isTesting]);
+  }, [featureEnabled, featuresSettled, testing, config, decision, events, sessions, elapsed, hasServerDecision, seenKey, lastKey, storage, isTesting]);
   const shownRef = React7.useRef(false);
   const markShown = React7.useCallback(() => {
     if (shownRef.current) return;