@wireai/activation 0.11.0 → 0.12.1

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-BGW9uXZJ.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-jUJd5kxu.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

@@ -736,6 +736,7 @@ var requestStoreReview = async (store) => {
 };
 
 // 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 {
@@ -748,6 +749,35 @@ var buildEventsRequest = (target, events) => {
   }
 };
 
+// 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;
@@ -785,13 +815,15 @@ var fetchReviewDecision = async (target, options = {}) => {
   }
 };
 var reportAppEvent = (target, name, options = {}) => {
+  var _a;
   if (!(target == null ? void 0 : target.serverUrl) || !name) return;
   try {
+    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);
@@ -1055,14 +1087,21 @@ var styles6 = reactNative.StyleSheet.create({
 });
 
 // src/coachmarks/runtime.ts
-var storageSingleton = null;
-var testing = false;
-var getCoachmarkStorage = () => storageSingleton;
-var isCoachmarkTesting = () => testing;
+var COACHMARK_RUNTIME_SLOT = /* @__PURE__ */ Symbol.for("@wireai/activation:coachmarkRuntime");
+var runtimeGlobal = globalThis;
+var coachmarkRuntime = () => {
+  const existing = runtimeGlobal[COACHMARK_RUNTIME_SLOT];
+  if (existing) return existing;
+  const created = { storage: null, testing: false, coachmarksEnabled: true };
+  runtimeGlobal[COACHMARK_RUNTIME_SLOT] = created;
+  return created;
+};
+var getCoachmarkStorage = () => coachmarkRuntime().storage;
+var isCoachmarkTesting = () => coachmarkRuntime().testing;
 var SEEN_VALUE = "1";
 var hasSeenGate = (key, storageOverride, testingOverride) => {
-  if (testingOverride != null ? testingOverride : testing) return false;
-  const storage = storageOverride != null ? storageOverride : storageSingleton;
+  if (testingOverride != null ? testingOverride : isCoachmarkTesting()) return false;
+  const storage = storageOverride != null ? storageOverride : getCoachmarkStorage();
   if (!storage) return false;
   try {
     return storage.getItem(key) === SEEN_VALUE;
@@ -1071,8 +1110,8 @@ var hasSeenGate = (key, storageOverride, testingOverride) => {
   }
 };
 var markSeenGate = (key, storageOverride, testingOverride) => {
-  if (testingOverride != null ? testingOverride : testing) return;
-  const storage = storageOverride != null ? storageOverride : storageSingleton;
+  if (testingOverride != null ? testingOverride : isCoachmarkTesting()) return;
+  const storage = storageOverride != null ? storageOverride : getCoachmarkStorage();
   if (!storage) return;
   try {
     storage.setItem(key, SEEN_VALUE);
@@ -1258,7 +1297,22 @@ 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 NO_STORAGE_WARNED_SLOT = /* @__PURE__ */ Symbol.for(
+  "@wireai/activation:gateStorageWarned"
+);
+var gateWarnGlobal = globalThis;
+var warnMissingGateStorage = (storage, gate) => {
+  if (storage) return;
+  if (gateWarnGlobal[NO_STORAGE_WARNED_SLOT]) return;
+  if (typeof __DEV__ === "undefined" || !__DEV__) return;
+  if (typeof console === "undefined" || !console.warn) return;
+  gateWarnGlobal[NO_STORAGE_WARNED_SLOT] = true;
+  console.warn(
+    `[wireai] the ${gate} gate has no sync storage, so its app-open counter is stuck at 1 and the fail-closed minSessions rule can never be satisfied \u2014 the gate will never fire. Mount CoachmarkProvider with a sync storage adapter at your app root, or pass \`storage\` to the gate.`
+  );
+};
 var readInt = (storage, key) => {
   if (!storage) return 0;
   try {
@@ -1276,6 +1330,39 @@ 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 = () => {
+  var _a;
+  const existing = openIdGlobal[PROCESS_OPEN_ID_SLOT];
+  if (existing) return existing;
+  const resolved = (_a = getCurrentSessionId()) != null ? _a : makeSessionId();
+  openIdGlobal[PROCESS_OPEN_ID_SLOT] = resolved;
+  return resolved;
+};
+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) => {
@@ -1298,15 +1385,15 @@ var useReviewGate = ({
     (a, b) => sameDecision(a, b)
   );
   const featureEnabled = useResolvedFeatures({ flags: features, config: featuresConfig }).review.enabled;
-  const testing2 = isTesting != null ? isTesting : isCoachmarkTesting();
+  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 store = resolveStorage(storage);
-    const next = readInt(store, sessionsKey) + 1;
-    writeInt(store, sessionsKey, next);
-    return next;
+    warnMissingGateStorage(store, "review");
+    return bumpSessionCount(store, sessionsKey, sessionOpenKey);
   })[0];
   const hasServerDecision = decision != null;
   const timeoutMs = config.timeoutFallbackMs;
@@ -1322,7 +1409,7 @@ var useReviewGate = ({
   }, [waits, timeoutMs]);
   const { visible, verdict } = React7.useMemo(() => {
     if (!featureEnabled) return { visible: false, verdict: { fire: false, reason: "feature_disabled" } };
-    if (testing2) return { visible: true, verdict: { fire: true, reason: "testing" } };
+    if (testing) return { visible: true, verdict: { fire: true, reason: "testing" } };
     const store = resolveStorage(storage);
     const local = evaluateGate(resolveRules(config), {
       sessions,
@@ -1335,7 +1422,7 @@ var useReviewGate = ({
     const alreadySeen = hasSeenGate(seenKey, storage, isTesting);
     const ready = hasServerDecision || elapsed;
     return { visible: ready && resolved.fire && !alreadySeen, verdict: resolved };
-  }, [featureEnabled, testing2, config, decision, events, sessions, elapsed, hasServerDecision, seenKey, lastKey, storage, isTesting]);
+  }, [featureEnabled, testing, config, decision, events, sessions, elapsed, hasServerDecision, seenKey, lastKey, storage, isTesting]);
   const shownRef = React7.useRef(false);
   const markShown = React7.useCallback(() => {
     if (shownRef.current) return;