@wireai/activation 0.10.0 → 0.12.0

package/dist/reviews/index.d.mts

@@ -4,7 +4,7 @@ export { e as RatingRoute, f as ReviewConfig, g as ReviewDecisionResponse, h as
 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-Bl_M2y3r.mjs';
 import { c as OnboardingFonts } from '../types-BKfpdZzX.mjs';
-export { F as FetchReviewDecisionOptions, R as ReportAppEventOptions, f as fetchReviewDecision, r as reportAppEvent, s as submitReview } from '../transport-Bzb-bcB2.mjs';
+export { F as FetchReviewDecisionOptions, R as ReportAppEventOptions, f as fetchReviewDecision, r as reportAppEvent, s as submitReview } from '../transport-CF_eHwzC.mjs';
 import '../types-BcmagF6K.mjs';
 import '../types-CKFhyrMu.mjs';
 
@@ -19,7 +19,7 @@ import '../types-CKFhyrMu.mjs';
 declare const reviewSeenKey: (id: string, version?: string) => string;
 /** Last-shown timestamp key (epoch ms), for the cooldown rule. */
 declare const reviewLastShownKey: (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 reviewSessionsKey: (id: string) => string;
 
 /**

package/dist/reviews/index.d.ts

@@ -4,7 +4,7 @@ export { e as RatingRoute, f as ReviewConfig, g as ReviewDecisionResponse, h as
 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-Cau5KmP6.js';
 import { c as OnboardingFonts } from '../types-BKfpdZzX.js';
-export { F as FetchReviewDecisionOptions, R as ReportAppEventOptions, f as fetchReviewDecision, r as reportAppEvent, s as submitReview } from '../transport-B31G0Cib.js';
+export { F as FetchReviewDecisionOptions, R as ReportAppEventOptions, f as fetchReviewDecision, r as reportAppEvent, s as submitReview } from '../transport-DsRe4epC.js';
 import '../types-BcmagF6K.js';
 import '../types-CKFhyrMu.js';
 
@@ -19,7 +19,7 @@ import '../types-CKFhyrMu.js';
 declare const reviewSeenKey: (id: string, version?: string) => string;
 /** Last-shown timestamp key (epoch ms), for the cooldown rule. */
 declare const reviewLastShownKey: (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 reviewSessionsKey: (id: string) => string;
 
 /**

package/dist/reviews/index.js

@@ -504,7 +504,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
@@ -728,6 +735,49 @@ var requestStoreReview = async (store) => {
   return opened ? "store_url" : "none";
 };
 
+// src/analytics/reportClientEvent.ts
+var makeSessionId = () => `wire_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;
+var buildEventsRequest = (target, events) => {
+  if (!(target == null ? void 0 : target.serverUrl) || events.length === 0) return null;
+  try {
+    const url = `${target.serverUrl.replace(/\/$/, "")}/v1/events`;
+    const headers = { "Content-Type": "application/json" };
+    if (target.apiKey) headers.Authorization = `Bearer ${target.apiKey}`;
+    return { url, init: { method: "POST", headers, body: JSON.stringify({ events }) } };
+  } catch {
+    return null;
+  }
+};
+
+// 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];
+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"
+);
+var warnSlot = 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;
+  if (!warnSlot[MINT_WARNED_SLOT] && warnInDev(MINT_WARNING)) {
+    warnSlot[MINT_WARNED_SLOT] = true;
+  }
+  return minted;
+};
+
 // src/reviews/transport.ts
 var submitReview = (target, review) => {
   if (!(target == null ? void 0 : target.serverUrl)) return;
@@ -765,25 +815,22 @@ var fetchReviewDecision = async (target, options = {}) => {
   }
 };
 var reportAppEvent = (target, name, options = {}) => {
+  var _a;
   if (!(target == null ? void 0 : target.serverUrl) || !name) return;
   try {
-    const url = `${target.serverUrl.replace(/\/$/, "")}/v1/events`;
-    const headers = { "Content-Type": "application/json" };
-    if (target.apiKey) headers.Authorization = `Bearer ${target.apiKey}`;
+    const supplied = (_a = options.sessionId) != null ? _a : "";
     const event = {
       event_type: "app_event",
-      question_key: name
+      question_key: name,
+      session_id: supplied.trim().length > 0 ? supplied : ensureCurrentSessionId()
     };
-    if (options.sessionId) event.session_id = options.sessionId;
     if (options.deviceKey) event.user_context = { device_key: options.deviceKey };
     if (options.meta && Object.keys(options.meta).length > 0) {
       event.meta = JSON.stringify(options.meta);
     }
-    void fetch(url, {
-      method: "POST",
-      headers,
-      body: JSON.stringify({ events: [event] })
-    }).catch(() => {
+    const req = buildEventsRequest(target, [event]);
+    if (!req) return;
+    void fetch(req.url, req.init).catch(() => {
     });
   } catch {
   }
@@ -1243,6 +1290,7 @@ var sameDecision = (a, b) => {
 var reviewSeenKey = (id, version) => version ? `wire_review_${id}_${version}_seen` : `wire_review_${id}_seen`;
 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 readInt = (storage, key) => {
   if (!storage) return 0;
@@ -1261,6 +1309,40 @@ 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/reviews/useReviewGate.ts
 var useStableValue2 = (value, isEqual) => {
@@ -1287,12 +1369,10 @@ var useReviewGate = ({
   const seenKey = reviewSeenKey(config.id, config.oncePerVersion === false ? void 0 : config.appVersion);
   const lastKey = reviewLastShownKey(config.id);
   const sessionsKey = reviewSessionsKey(config.id);
-  const sessions = React7.useState(() => {
-    const store = resolveStorage(storage);
-    const next = readInt(store, sessionsKey) + 1;
-    writeInt(store, sessionsKey, next);
-    return next;
-  })[0];
+  const sessionOpenKey = reviewSessionOpenKey(config.id);
+  const sessions = React7.useState(
+    () => bumpSessionCount(resolveStorage(storage), sessionsKey, sessionOpenKey)
+  )[0];
   const hasServerDecision = decision != null;
   const timeoutMs = config.timeoutFallbackMs;
   const waits = !hasServerDecision && timeoutMs != null && timeoutMs > 0;