@wireai/activation 0.14.3 → 0.15.0

package/dist/reviews/index.d.mts

@@ -1,11 +1,11 @@
 import React__default from 'react';
-import { R as ReviewGateProps, a as ReviewPresentation, U as UseReviewGateOptions, b as ReviewGateController, c as ReviewDecision, d as ReviewStoreConfig } from '../types-Cju-1_jT.mjs';
-export { e as RatingRoute, f as ReviewConfig, g as ReviewDecisionResponse, h as ReviewGateEvent, i as ReviewGateEventName, j as ReviewSubmission, k as ReviewTarget, S as SubmitResult } from '../types-Cju-1_jT.mjs';
+import { R as ReviewGateProps, a as ReviewPresentation, U as UseReviewGateOptions, b as ReviewGateController, c as ReviewDecision, d as ReviewStoreConfig } from '../types-Byx306Kv.mjs';
+export { e as RatingRoute, f as ReviewConfig, g as ReviewDecisionResponse, h as ReviewGateEvent, i as ReviewGateEventName, j as ReviewSubmission, k as ReviewTarget, S as SubmitResult } from '../types-Byx306Kv.mjs';
 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-Bgo17oH7.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-yBj2AyPW.mjs';
 import { c as OnboardingFonts } from '../types-BKfpdZzX.mjs';
-export { F as FetchReviewDecisionOptions, R as ReportAppEventOptions, a as ReviewSubmitResult, f as fetchReviewDecision, r as reportAppEvent, s as submitReview } from '../transport-j5gFfJhK.mjs';
-import '../types-BcmagF6K.mjs';
+export { F as FetchReviewDecisionOptions, R as ReportAppEventOptions, a as ReviewSubmitResult, f as fetchReviewDecision, r as reportAppEvent, s as submitReview } from '../transport-s5QxA-ci.mjs';
+import '../types-D_0B0yay.mjs';
 import '../types-BpwiRpA8.mjs';
 
 /**
@@ -41,7 +41,11 @@ declare const reviewSessionsKey: (id: string) => string;
  *
  * The form NEVER asks for identity (no name / email / contact field): the host already
  * identifies the user via `sessionId` + `meta` (e.g. user_id, device_key), which is all
- * the POST body carries alongside the rating and the free text.
+ * the POST body carries alongside the rating and the free text. Since 2026-08-19 the gate also
+ * fills in `meta.device_key` from the kit's own per-install id when the host passed none — not for
+ * identification, but because it is the unit the server scopes the idempotency key to, and without
+ * it the key is discarded. Any non-blank string the host passes still wins verbatim. See
+ * `idempotency.ts`.
  *
  * Motion (2026-07-16): the three phases used to swap IN PLACE with no transition. They now
  * ride `ModalPaneHost`, the same pane-slide primitive the questionnaire steps use, and the

package/dist/reviews/index.d.ts

@@ -1,11 +1,11 @@
 import React__default from 'react';
-import { R as ReviewGateProps, a as ReviewPresentation, U as UseReviewGateOptions, b as ReviewGateController, c as ReviewDecision, d as ReviewStoreConfig } from '../types-h2BZvl1t.js';
-export { e as RatingRoute, f as ReviewConfig, g as ReviewDecisionResponse, h as ReviewGateEvent, i as ReviewGateEventName, j as ReviewSubmission, k as ReviewTarget, S as SubmitResult } from '../types-h2BZvl1t.js';
+import { R as ReviewGateProps, a as ReviewPresentation, U as UseReviewGateOptions, b as ReviewGateController, c as ReviewDecision, d as ReviewStoreConfig } from '../types-tdATL5z0.js';
+export { e as RatingRoute, f as ReviewConfig, g as ReviewDecisionResponse, h as ReviewGateEvent, i as ReviewGateEventName, j as ReviewSubmission, k as ReviewTarget, S as SubmitResult } from '../types-tdATL5z0.js';
 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-Bkh_LigV.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-3vWLuBlO.js';
 import { c as OnboardingFonts } from '../types-BKfpdZzX.js';
-export { F as FetchReviewDecisionOptions, R as ReportAppEventOptions, a as ReviewSubmitResult, f as fetchReviewDecision, r as reportAppEvent, s as submitReview } from '../transport-B_0SgCBe.js';
-import '../types-BcmagF6K.js';
+export { F as FetchReviewDecisionOptions, R as ReportAppEventOptions, a as ReviewSubmitResult, f as fetchReviewDecision, r as reportAppEvent, s as submitReview } from '../transport-xqqSFqxs.js';
+import '../types-D_0B0yay.js';
 import '../types-BpwiRpA8.js';
 
 /**
@@ -41,7 +41,11 @@ declare const reviewSessionsKey: (id: string) => string;
  *
  * The form NEVER asks for identity (no name / email / contact field): the host already
  * identifies the user via `sessionId` + `meta` (e.g. user_id, device_key), which is all
- * the POST body carries alongside the rating and the free text.
+ * the POST body carries alongside the rating and the free text. Since 2026-08-19 the gate also
+ * fills in `meta.device_key` from the kit's own per-install id when the host passed none — not for
+ * identification, but because it is the unit the server scopes the idempotency key to, and without
+ * it the key is discarded. Any non-blank string the host passes still wins verbatim. See
+ * `idempotency.ts`.
  *
  * Motion (2026-07-16): the three phases used to swap IN PLACE with no transition. They now
  * ride `ModalPaneHost`, the same pane-slide primitive the questionnaire steps use, and the

package/dist/reviews/index.js

@@ -546,6 +546,7 @@ var buildReviewSubmission = (input) => {
   if (contact) body.contact = contact;
   if (input.sessionId) body.session_id = input.sessionId;
   if (input.source) body.source = input.source;
+  if (input.idempotencyKey) body.idempotency_key = input.idempotencyKey;
   if (input.meta && Object.keys(input.meta).length > 0) body.meta = input.meta;
   return body;
 };
@@ -563,6 +564,96 @@ var feedbackInputHeights = (fonts, verticalPadding = 0) => {
   };
 };
 
+// src/context/deviceId.ts
+var AUTO_DEVICE_ID_PREFIX = "wdev_";
+var deviceIdStorageKey = (appId) => `wireai:analytics:deviceKey:${appId != null ? appId : "default"}`;
+var randomChunk = () => Math.floor(Math.random() * 4294967296).toString(36).padStart(6, "0");
+var mintDeviceId = () => {
+  const time = Date.now().toString(36);
+  return `${AUTO_DEVICE_ID_PREFIX}${time}_${randomChunk()}${randomChunk()}`;
+};
+var AUTO_DEVICE_KEY_SLOT = /* @__PURE__ */ Symbol.for("@wireai/activation:autoDeviceKeys");
+var deviceKeyGlobal = globalThis;
+var autoDeviceKeyRegistry = () => {
+  const existing = deviceKeyGlobal[AUTO_DEVICE_KEY_SLOT];
+  if (existing) return existing;
+  const created = { keys: /* @__PURE__ */ new Map(), hydrating: /* @__PURE__ */ new Set() };
+  deviceKeyGlobal[AUTO_DEVICE_KEY_SLOT] = created;
+  return created;
+};
+var startHydration = (registry, appId, storage, minted) => {
+  if (!registry.pending) registry.pending = /* @__PURE__ */ new Map();
+  const existing = registry.pending.get(appId);
+  if (existing) return existing;
+  const slot = deviceIdStorageKey(appId);
+  const degraded = () => {
+    var _a;
+    return { value: (_a = registry.keys.get(appId)) != null ? _a : minted, durable: false };
+  };
+  const adopted = (value) => ({ value, durable: true });
+  let run;
+  try {
+    run = Promise.resolve(storage.getItem(slot)).then((saved) => {
+      const persisted = typeof saved === "string" && saved.trim() ? saved.trim() : void 0;
+      if (persisted) {
+        registry.keys.set(appId, persisted);
+        return adopted(persisted);
+      }
+      return Promise.resolve(storage.setItem(slot, minted)).then(
+        () => {
+          var _a;
+          return adopted((_a = registry.keys.get(appId)) != null ? _a : minted);
+        },
+        degraded
+      );
+    }).catch(degraded);
+  } catch {
+    run = Promise.resolve(degraded());
+  }
+  registry.pending.set(appId, run);
+  void run.then((outcome) => {
+    var _a;
+    if (outcome.durable) return;
+    (_a = registry.pending) == null ? void 0 : _a.delete(appId);
+    registry.hydrating.delete(appId);
+  });
+  return run;
+};
+var resolveAutoDeviceKey = (opts = {}) => {
+  var _a, _b;
+  const registry = autoDeviceKeyRegistry();
+  const appId = (_a = opts.appId) != null ? _a : "default";
+  let id = registry.keys.get(appId);
+  if (!id) {
+    id = mintDeviceId();
+    registry.keys.set(appId, id);
+  }
+  const storage = opts.storage;
+  if (storage && !registry.hydrating.has(appId)) {
+    registry.hydrating.add(appId);
+    void startHydration(registry, appId, storage, id);
+  }
+  return (_b = registry.keys.get(appId)) != null ? _b : id;
+};
+var ambientAutoDeviceKey = () => {
+  const registry = autoDeviceKeyRegistry();
+  if (registry.keys.size === 0) return resolveAutoDeviceKey();
+  if (registry.keys.size > 1) return void 0;
+  return [...registry.keys.values()][0];
+};
+
+// src/reviews/idempotency.ts
+var REVIEW_IDEMPOTENCY_PREFIX = "rvw_";
+var mintIdempotencyKey = () => `${REVIEW_IDEMPOTENCY_PREFIX}${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;
+var hasDeviceKey = (meta) => {
+  const value = meta == null ? void 0 : meta.device_key;
+  return typeof value === "string" && value.trim().length > 0;
+};
+var createImpression = () => ({
+  idempotencyKey: mintIdempotencyKey(),
+  deviceKey: ambientAutoDeviceKey()
+});
+
 // src/motion/centeredModalMotion.ts
 var CENTERED_MODAL_ANIM = {
   /** Spring config for the card scale/opacity entrance (mirrors CompletionView's pop). */
@@ -901,6 +992,27 @@ var _ReviewGate = ({
   const resolve = React7.useCallback(() => {
     onResolved == null ? void 0 : onResolved();
   }, [onResolved]);
+  const impressionRef = React7__default.default.useRef(null);
+  const buildBody = React7.useCallback(
+    (input) => {
+      let impression = impressionRef.current;
+      if (!impression) {
+        impression = createImpression();
+        impressionRef.current = impression;
+      }
+      const merged = { ...meta, ...input.extraMeta };
+      if (!hasDeviceKey(merged) && impression.deviceKey) merged.device_key = impression.deviceKey;
+      return buildReviewSubmission({
+        stars: input.stars,
+        feedbackText: input.feedbackText,
+        suggestion: input.suggestion,
+        sessionId,
+        meta: merged,
+        idempotencyKey: impression.idempotencyKey
+      });
+    },
+    [meta, sessionId]
+  );
   const postedRef = React7__default.default.useRef(false);
   const unackedRef = React7__default.default.useRef(null);
   const postOnce = React7.useCallback(
@@ -928,12 +1040,11 @@ var _ReviewGate = ({
     }
     if (postedRef.current || stars < 1) return;
     postOnce(
-      buildReviewSubmission({
+      buildBody({
         stars,
         feedbackText: feedback,
         suggestion,
-        sessionId,
-        meta: { ...meta, abandoned: true }
+        extraMeta: { abandoned: true }
       })
     );
   };
@@ -958,10 +1069,9 @@ var _ReviewGate = ({
         onEvent == null ? void 0 : onEvent({ name: "store_review_requested", id, stars: value });
         const route = await requestStoreReview(store);
         postOnce(
-          buildReviewSubmission({
+          buildBody({
             stars: value,
-            sessionId,
-            meta: { ...meta, store_route: route }
+            extraMeta: { store_route: route }
           })
         );
         setPhase("thanks");
@@ -970,24 +1080,18 @@ var _ReviewGate = ({
         setPhase("feedback");
       }
     },
-    [onEvent, id, store, postOnce, sessionId, meta, resolveWithDelay]
+    [onEvent, id, store, postOnce, buildBody, resolveWithDelay]
   );
   const feedbackReady = feedback.trim().length > 0;
   const sendFeedback = React7.useCallback(() => {
     if (!feedbackReady) return;
-    const body = buildReviewSubmission({
-      stars,
-      feedbackText: feedback,
-      suggestion,
-      sessionId,
-      meta
-    });
+    const body = buildBody({ stars, feedbackText: feedback, suggestion });
     postOnce(body);
     onEvent == null ? void 0 : onEvent({ name: "review_feedback_submitted", id, stars });
     playHaptic("success");
     setPhase("thanks");
     resolveWithDelay();
-  }, [feedbackReady, stars, feedback, suggestion, sessionId, meta, postOnce, onEvent, id, resolveWithDelay]);
+  }, [feedbackReady, stars, feedback, suggestion, buildBody, postOnce, onEvent, id, resolveWithDelay]);
   const dismiss = React7.useCallback(() => {
     setPhase("thanks");
     resolveWithDelay();
@@ -1134,9 +1238,54 @@ var coachmarkRuntime = () => {
 var getCoachmarkStorage = () => coachmarkRuntime().storage;
 var isCoachmarkTesting = () => coachmarkRuntime().testing;
 var SEEN_VALUE = "1";
+var GATE_PROBE_KEY = "wire_gate_probe";
+var ASYNC_GATE_STORAGE_WARNED_SLOT = /* @__PURE__ */ Symbol.for(
+  "@wireai/activation:asyncGateStorageWarned"
+);
+var asyncGateWarnGlobal = globalThis;
+var closedGateStorage = Object.freeze({
+  getItem: () => SEEN_VALUE,
+  setItem: () => {
+  }
+});
+var syncGateAdapters = /* @__PURE__ */ new WeakSet();
+var asyncGateAdapters = /* @__PURE__ */ new WeakSet();
+var warnAsyncGateStorage = () => {
+  if (asyncGateWarnGlobal[ASYNC_GATE_STORAGE_WARNED_SLOT]) return;
+  if (typeof __DEV__ === "undefined" || !__DEV__) return;
+  if (typeof console === "undefined" || !console.warn) return;
+  asyncGateWarnGlobal[ASYNC_GATE_STORAGE_WARNED_SLOT] = true;
+  console.warn(
+    "[wireai] the gate storage's getItem returned a Promise \u2014 an async adapter (e.g. AsyncStorage) cannot drive the once-per-user gates, so coachmark tours, showcases and the review/questionnaire gates are all DISABLED (fail closed: nothing shows, nothing fires) until a synchronous adapter is provided. Pass a sync adapter (e.g. MMKV: `{ getItem: (k) => mmkv.getString(k) ?? null, setItem: (k, v) => mmkv.set(k, v) }`) to CoachmarkProvider or the gate's `storage` prop."
+  );
+};
+var validateGateStorage = (storage) => {
+  if (!storage) return null;
+  if (syncGateAdapters.has(storage)) return storage;
+  if (asyncGateAdapters.has(storage)) return closedGateStorage;
+  let probed;
+  try {
+    probed = storage.getItem(GATE_PROBE_KEY);
+  } catch {
+    syncGateAdapters.add(storage);
+    return storage;
+  }
+  if (probed != null && typeof probed.then === "function") {
+    asyncGateAdapters.add(storage);
+    try {
+      probed.then(void 0, () => {
+      });
+    } catch {
+    }
+    warnAsyncGateStorage();
+    return closedGateStorage;
+  }
+  syncGateAdapters.add(storage);
+  return storage;
+};
 var hasSeenGate = (key, storageOverride, testingOverride) => {
   if (testingOverride != null ? testingOverride : isCoachmarkTesting()) return false;
-  const storage = storageOverride != null ? storageOverride : getCoachmarkStorage();
+  const storage = validateGateStorage(storageOverride != null ? storageOverride : getCoachmarkStorage());
   if (!storage) return false;
   try {
     return storage.getItem(key) === SEEN_VALUE;
@@ -1146,7 +1295,7 @@ var hasSeenGate = (key, storageOverride, testingOverride) => {
 };
 var markSeenGate = (key, storageOverride, testingOverride) => {
   if (testingOverride != null ? testingOverride : isCoachmarkTesting()) return;
-  const storage = storageOverride != null ? storageOverride : getCoachmarkStorage();
+  const storage = validateGateStorage(storageOverride != null ? storageOverride : getCoachmarkStorage());
   if (!storage) return;
   try {
     storage.setItem(key, SEEN_VALUE);
@@ -1333,7 +1482,7 @@ var reviewSeenKey = (id, version) => version ? `wire_review_${id}_${version}_see
 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 resolveStorage = (override) => validateGateStorage(override != null ? override : getCoachmarkStorage());
 var NO_STORAGE_WARNED_SLOT = /* @__PURE__ */ Symbol.for(
   "@wireai/activation:gateStorageWarned"
 );