@wireai/activation 0.11.0 → 0.12.1

package/dist/reviews/index.mjs

@@ -730,6 +730,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 {
@@ -742,6 +743,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;
@@ -779,13 +809,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);
@@ -1049,14 +1081,21 @@ var styles6 = 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;
@@ -1065,8 +1104,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);
@@ -1252,7 +1291,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 {
@@ -1270,6 +1324,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) => {
@@ -1292,15 +1379,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 = 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;
@@ -1316,7 +1403,7 @@ var useReviewGate = ({
   }, [waits, timeoutMs]);
   const { visible, verdict } = 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,
@@ -1329,7 +1416,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 = useRef(false);
   const markShown = useCallback(() => {
     if (shownRef.current) return;