@wireai/activation 0.10.0 → 0.12.0

package/dist/questionnaire/index.d.mts

@@ -290,7 +290,7 @@ declare const fetchQuestionnaireDecision: (target: QuestionnaireTarget | undefin
 declare const questionnaireSeenKey: (id: string, version?: string) => string;
 /** Last-shown timestamp key (epoch ms), for the cooldown rule. */
 declare const questionnaireLastShownKey: (id: string) => string;
-/** Session-count key, incremented once per gate mount, for the min-sessions rule. */
+/** Session-count key, incremented once per APP-OPEN (not per mount), for the min-sessions rule. */
 declare const questionnaireSessionsKey: (id: string) => string;
 
 export { type FetchQuestionnaireDecisionOptions, type QuestionnaireAnswers, type QuestionnaireDecision, type QuestionnaireDecisionResponse, type QuestionnaireDefinition, QuestionnaireGate, type QuestionnaireGateController, type QuestionnaireGateEvent, type QuestionnaireGateEventName, type QuestionnaireGateProps, type QuestionnaireMeta, type QuestionnaireSubmission, type QuestionnaireTarget, type UseQuestionnaireGateOptions, buildQuestionnaireSubmission, decideQuestionnaire, fetchQuestionnaireDecision, questionnaireLastShownKey, questionnaireSeenKey, questionnaireSessionsKey, submitQuestionnaireResponse, useQuestionnaireGate };

package/dist/questionnaire/index.d.ts

@@ -290,7 +290,7 @@ declare const fetchQuestionnaireDecision: (target: QuestionnaireTarget | undefin
 declare const questionnaireSeenKey: (id: string, version?: string) => string;
 /** Last-shown timestamp key (epoch ms), for the cooldown rule. */
 declare const questionnaireLastShownKey: (id: string) => string;
-/** Session-count key, incremented once per gate mount, for the min-sessions rule. */
+/** Session-count key, incremented once per APP-OPEN (not per mount), for the min-sessions rule. */
 declare const questionnaireSessionsKey: (id: string) => string;
 
 export { type FetchQuestionnaireDecisionOptions, type QuestionnaireAnswers, type QuestionnaireDecision, type QuestionnaireDecisionResponse, type QuestionnaireDefinition, QuestionnaireGate, type QuestionnaireGateController, type QuestionnaireGateEvent, type QuestionnaireGateEventName, type QuestionnaireGateProps, type QuestionnaireMeta, type QuestionnaireSubmission, type QuestionnaireTarget, type UseQuestionnaireGateOptions, buildQuestionnaireSubmission, decideQuestionnaire, fetchQuestionnaireDecision, questionnaireLastShownKey, questionnaireSeenKey, questionnaireSessionsKey, submitQuestionnaireResponse, useQuestionnaireGate };

package/dist/questionnaire/index.js

@@ -704,7 +704,14 @@ var resolveRules = (config) => {
   var _a, _b, _c, _d, _e;
   return {
     enabled: (_a = config.enabled) != null ? _a : true,
-    minSessions: (_b = config.minSessions) != null ? _b : 0,
+    // FAIL-CLOSED on the first session (behavior change, 0.11.0). An unconfigured host with no
+    // server decision must NOT prompt on the very first mount: `minSessions` defaults to 2 so the
+    // gate needs at least a second session before the LOCAL rules can fire. This is the client-side
+    // floor only — a server `decision` (from `fetchReviewDecision`) still OVERRIDES everything, and a
+    // host that genuinely wants first-session prompting can set `minSessions: 1` (or `0`) explicitly.
+    // Mirrors the 2026-07-16 incident: a first-session user, no server decision, got the prompt and
+    // left 1 star. See `evaluateGate` (`min_sessions` reason) and the CHANGELOG.
+    minSessions: (_b = config.minSessions) != null ? _b : 2,
     minEvents: (_c = config.minEvents) != null ? _c : 0,
     cooldownDays: (_d = config.cooldownDays) != null ? _d : 0,
     oncePerVersion: (_e = config.oncePerVersion) != null ? _e : true
@@ -862,7 +869,8 @@ var fetchQuestionnaireDecision = async (target, options = {}) => {
     const res = await fetch(url, { headers });
     if (!res || !res.ok) return null;
     const json = await res.json();
-    return json != null ? json : null;
+    if (!json || typeof json.fire !== "boolean") return null;
+    return json;
   } catch {
     return null;
   }
@@ -1282,6 +1290,16 @@ 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) => override != null ? override : getCoachmarkStorage();
 var readInt = (storage, key) => {
@@ -1301,11 +1319,46 @@ var writeInt = (storage, key, value) => {
   } catch {
   }
 };
+var readStr = (storage, key) => {
+  if (!storage) return void 0;
+  try {
+    const raw = storage.getItem(key);
+    return typeof raw === "string" && raw.length > 0 ? raw : void 0;
+  } catch {
+    return void 0;
+  }
+};
+var PROCESS_OPEN_ID_SLOT = /* @__PURE__ */ Symbol.for("@wireai/activation:processOpenId");
+var openIdGlobal = globalThis;
+var currentOpenId = () => {
+  const live = getCurrentSessionId();
+  if (live) return live;
+  const existing = openIdGlobal[PROCESS_OPEN_ID_SLOT];
+  if (existing) return existing;
+  const created = makeSessionId();
+  openIdGlobal[PROCESS_OPEN_ID_SLOT] = created;
+  return created;
+};
+var bumpSessionCount = (storage, sessionsKey, openKey, openId = currentOpenId()) => {
+  const lastOpen = readStr(storage, openKey);
+  const stored = readInt(storage, sessionsKey);
+  if (lastOpen === openId) return stored > 0 ? stored : 1;
+  const next = stored + 1;
+  writeInt(storage, sessionsKey, next);
+  if (storage) {
+    try {
+      storage.setItem(openKey, openId);
+    } catch {
+    }
+  }
+  return next;
+};
 
 // src/questionnaire/runtime.ts
 var questionnaireSeenKey = (id, version) => version ? `wire_questionnaire_${id}_${version}_seen` : `wire_questionnaire_${id}_seen`;
 var questionnaireLastShownKey = (id) => `wire_questionnaire_${id}_last`;
 var questionnaireSessionsKey = (id) => `wire_questionnaire_${id}_sessions`;
+var questionnaireSessionOpenKey = (id) => `wire_questionnaire_${id}_open`;
 
 // src/questionnaire/useQuestionnaireGate.ts
 var useStableValue2 = (value, isEqual) => {
@@ -1332,12 +1385,10 @@ var useQuestionnaireGate = ({
   );
   const lastKey = questionnaireLastShownKey(config.id);
   const sessionsKey = questionnaireSessionsKey(config.id);
-  const sessions = React8.useState(() => {
-    const store = resolveStorage(storage);
-    const next = readInt(store, sessionsKey) + 1;
-    writeInt(store, sessionsKey, next);
-    return next;
-  })[0];
+  const sessionOpenKey = questionnaireSessionOpenKey(config.id);
+  const sessions = React8.useState(
+    () => bumpSessionCount(resolveStorage(storage), sessionsKey, sessionOpenKey)
+  )[0];
   const hasServerDecision = decision != null;
   const timeoutMs = config.timeoutFallbackMs;
   const waits = !hasServerDecision && timeoutMs != null && timeoutMs > 0;