@wireai/activation 0.15.0 → 0.16.0

package/dist/questionnaire/index.d.mts

@@ -246,19 +246,6 @@ declare const buildQuestionnaireSubmission: (input: {
     meta?: QuestionnaireMeta;
 }) => QuestionnaireSubmission;
 
-/**
- * transport.ts - kit → Wire server requests for the questionnaire module, never throwing
- * (a pre-onboarding questionnaire must NEVER break the app). Mirrors `submitReview`: a thin
- * fetch wrapper, Bearer tenant key, and — since 0.13.3 — the SAME three-outcome delivery ack.
- *
- *   • submitQuestionnaireResponse → POST {serverUrl}/v1/questionnaires/{id}/responses
- *   • fetchQuestionnaireDecision  → GET  {serverUrl}/v1/questionnaires/decision  (best-effort)
- *
- * The decision fetch is HARD fail-open on the "never show" side: an unreachable endpoint, a
- * non-2xx (incl. 404), a missing `fetch`, or bad JSON all resolve to null, so a host wiring
- * pure server-directed firing simply shows nothing - exactly the reviews decision seam.
- */
-
 /**
  * What became of a questionnaire POST. The SHARED verdict — identical values, identical meaning,
  * identical retry rule as `ReviewSubmitResult`. The reasoning lives once, in `utils/submitResult.ts`.

package/dist/questionnaire/index.d.ts

@@ -246,19 +246,6 @@ declare const buildQuestionnaireSubmission: (input: {
     meta?: QuestionnaireMeta;
 }) => QuestionnaireSubmission;
 
-/**
- * transport.ts - kit → Wire server requests for the questionnaire module, never throwing
- * (a pre-onboarding questionnaire must NEVER break the app). Mirrors `submitReview`: a thin
- * fetch wrapper, Bearer tenant key, and — since 0.13.3 — the SAME three-outcome delivery ack.
- *
- *   • submitQuestionnaireResponse → POST {serverUrl}/v1/questionnaires/{id}/responses
- *   • fetchQuestionnaireDecision  → GET  {serverUrl}/v1/questionnaires/decision  (best-effort)
- *
- * The decision fetch is HARD fail-open on the "never show" side: an unreachable endpoint, a
- * non-2xx (incl. 404), a missing `fetch`, or bad JSON all resolve to null, so a host wiring
- * pure server-directed firing simply shows nothing - exactly the reviews decision seam.
- */
-
 /**
  * What became of a questionnaire POST. The SHARED verdict — identical values, identical meaning,
  * identical retry rule as `ReviewSubmitResult`. The reasoning lives once, in `utils/submitResult.ts`.

package/dist/questionnaire/index.js

@@ -843,6 +843,28 @@ var toAnswers = (drafts) => {
   };
 };
 
+// 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/questionnaire/transport.ts
 var submitQuestionnaireResponse = async (target, id, submission) => {
   if (!(target == null ? void 0 : target.serverUrl) || !id) return "unsent";
@@ -851,11 +873,15 @@ var submitQuestionnaireResponse = async (target, id, submission) => {
     const url = `${base}/v1/questionnaires/${encodeURIComponent(id)}/responses`;
     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(submission)
-    });
+    const res = await withDeadline(
+      (signal) => fetch(url, {
+        method: "POST",
+        headers,
+        body: JSON.stringify(submission),
+        signal
+      })
+    );
+    if (res === DEADLINE_EXPIRED) return "unsent";
     if (!res) return "unsent";
     return res.ok ? "accepted" : "rejected";
   } catch {
@@ -873,9 +899,12 @@ var fetchQuestionnaireDecision = async (target, options = {}) => {
     const url = `${base}/v1/questionnaires/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 {
@@ -954,6 +983,10 @@ var _QuestionnaireGate = ({
   }, [id, onResolved]);
   const postedRef = React8.useRef(false);
   const unackedRef = React8.useRef(null);
+  const recoverOnSettleRef = React8.useRef(false);
+  const recoveredRef = React8.useRef(false);
+  const postOnceRef = React8.useRef(() => {
+  });
   const postOnce = React8.useCallback(
     (body) => {
       if (postedRef.current) return;
@@ -962,6 +995,10 @@ var _QuestionnaireGate = ({
       void submitQuestionnaireResponse(target, id, body).then((result) => {
         if (result === "unsent") {
           postedRef.current = false;
+          if (recoverOnSettleRef.current && !recoveredRef.current) {
+            recoveredRef.current = true;
+            postOnceRef.current(body);
+          }
           return;
         }
         unackedRef.current = null;
@@ -969,11 +1006,16 @@ var _QuestionnaireGate = ({
     },
     [target, id]
   );
+  postOnceRef.current = postOnce;
   const recoverRef = React8.useRef(() => {
   });
   recoverRef.current = () => {
     const undelivered = unackedRef.current;
-    if (undelivered && !postedRef.current) postOnce(undelivered);
+    if (undelivered && !postedRef.current) {
+      postOnce(undelivered);
+      return;
+    }
+    if (postedRef.current && undelivered) recoverOnSettleRef.current = true;
   };
   React8__default.default.useEffect(() => () => recoverRef.current(), []);
   const finish = React8.useCallback(
@@ -1122,6 +1164,39 @@ var styles7 = reactNative.StyleSheet.create({
   backGlyph: { includeFontPadding: false }
 });
 
+// src/analytics/reportClientEvent.ts
+var makeSessionId = () => `wire_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;
+
+// src/analytics/currentSession.ts
+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 subscribeCurrentSessionId = (listener) => {
+  const set = listeners();
+  set.add(listener);
+  return () => {
+    set.delete(listener);
+  };
+};
+var getCurrentSessionId = () => globalSlot[CURRENT_SESSION_ID_SLOT];
+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];
+
 // src/coachmarks/runtime.ts
 var COACHMARK_RUNTIME_SLOT = /* @__PURE__ */ Symbol.for("@wireai/activation:coachmarkRuntime");
 var runtimeGlobal = globalThis;
@@ -1280,17 +1355,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) => {
@@ -1300,9 +1389,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;
@@ -1318,39 +1406,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] = React8.useState(defaultWireFeatures);
   const canFetch = !!(stableConfig == null ? void 0 : stableConfig.serverUrl) && !!(stableConfig == null ? void 0 : stableConfig.apiKey);
+  const [settled, setSettled] = React8.useState(!canFetch);
   React8.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 React8.useMemo(() => ({ flags, settled }), [flags, settled]);
 };
 var CONTEXT_SYMBOL = /* @__PURE__ */ Symbol.for("wireai.features.context");
-var globalObj = globalThis;
-if (!globalObj[CONTEXT_SYMBOL]) {
-  globalObj[CONTEXT_SYMBOL] = React8.createContext(null);
+var featuresContextGlobal = globalThis;
+if (!featuresContextGlobal[CONTEXT_SYMBOL]) {
+  featuresContextGlobal[CONTEXT_SYMBOL] = React8.createContext(null);
+}
+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] = React8.createContext(true);
 }
-var WireFeaturesContext = globalObj[CONTEXT_SYMBOL];
+var WireFeaturesSettledContext = settledContextGlobal[SETTLED_SYMBOL];
 var useWireFeaturesContext = () => React8.useContext(WireFeaturesContext);
-var useResolvedFeatures = (options) => {
+var useResolvedFeaturesState = (options) => {
   var _a, _b, _c;
   const ctx = useWireFeaturesContext();
+  const ctxSettled = React8.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 React8.useMemo(() => ({ flags, settled }), [flags, settled]);
 };
 
 // src/reviews/equality.ts
@@ -1374,16 +1474,6 @@ var sameDecision = (a, b) => {
   return a.fire === b.fire && a.reason === b.reason;
 };
 
-// src/analytics/reportClientEvent.ts
-var makeSessionId = () => `wire_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;
-
-// src/analytics/currentSession.ts
-var CURRENT_SESSION_ID_SLOT = /* @__PURE__ */ Symbol.for(
-  "@wireai/activation:currentSessionId"
-);
-var globalSlot = globalThis;
-var getCurrentSessionId = () => globalSlot[CURRENT_SESSION_ID_SLOT];
-
 // src/reviews/runtime.ts
 var resolveStorage = (override) => validateGateStorage(override != null ? override : getCoachmarkStorage());
 var NO_STORAGE_WARNED_SLOT = /* @__PURE__ */ Symbol.for(
@@ -1430,18 +1520,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()) => {
@@ -1482,7 +1577,11 @@ var useQuestionnaireGate = ({
 }) => {
   const config = useStableValue2(configProp, shallowEqual);
   const decision = useStableValue2(decisionProp, (a, b) => sameDecision(a, b));
-  const featureEnabled = useResolvedFeatures({ flags: features, config: featuresConfig }).questionnaire.enabled;
+  const { flags: resolvedFeatures, settled: featuresSettled } = useResolvedFeaturesState({
+    flags: features,
+    config: featuresConfig
+  });
+  const featureEnabled = resolvedFeatures.questionnaire.enabled;
   const testing = isTesting != null ? isTesting : isCoachmarkTesting();
   const seenKey = questionnaireSeenKey(
     config.id,
@@ -1491,11 +1590,22 @@ var useQuestionnaireGate = ({
   const lastKey = questionnaireLastShownKey(config.id);
   const sessionsKey = questionnaireSessionsKey(config.id);
   const sessionOpenKey = questionnaireSessionOpenKey(config.id);
-  const sessions = React8.useState(() => {
+  const openSessionId = React8.useSyncExternalStore(
+    subscribeCurrentSessionId,
+    getCurrentSessionId,
+    getCurrentSessionId
+  );
+  const storageRef = React8.useRef(storage);
+  storageRef.current = storage;
+  const [sessions, setSessions] = React8.useState(() => {
     const store = resolveStorage(storage);
     warnMissingGateStorage(store, "questionnaire");
     return bumpSessionCount(store, sessionsKey, sessionOpenKey);
-  })[0];
+  });
+  React8.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;
@@ -1529,10 +1639,11 @@ var useQuestionnaireGate = ({
     });
     const resolved = decideQuestionnaire(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,
+    featuresSettled,
     testing,
     config,
     decision,