@wireai/activation 0.11.0 → 0.12.0

package/dist/index.js

@@ -1518,6 +1518,23 @@ var buildEventsRequest = (target, events) => {
     return null;
   }
 };
+var warnOnSkippedEvents = (res) => {
+  try {
+    const json = res == null ? void 0 : res.json;
+    if (typeof json !== "function") return;
+    void Promise.resolve(json.call(res)).then((body) => {
+      const skipped = body == null ? void 0 : body.skipped;
+      if (typeof skipped !== "number" || skipped <= 0) return;
+      if (typeof __DEV__ !== "undefined" && __DEV__ && typeof console !== "undefined" && console.warn) {
+        console.warn(
+          `[wireai] the server ACCEPTED the /v1/events POST but DISCARDED ${skipped} event(s) (skipped in the response body) \u2014 they are gone, not retried. The usual cause is an event with a missing or empty session_id.`
+        );
+      }
+    }).catch(() => {
+    });
+  } catch {
+  }
+};
 var reportClientEvents = (target, events) => {
   try {
     const req = buildEventsRequest(target, events);
@@ -3314,6 +3331,28 @@ var getCurrentSessionId = () => globalSlot[CURRENT_SESSION_ID_SLOT];
 var resetCurrentSessionId = () => {
   globalSlot[CURRENT_SESSION_ID_SLOT] = void 0;
 };
+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/session/persistedSession.ts
 var DEFAULT_SESSION_TTL_MS = 36e5;
@@ -4113,6 +4152,10 @@ var clearUserContext = async (opts = {}) => {
   } catch {
   }
 };
+var activationJoinContext = (deviceKey) => {
+  var _a2;
+  return (_a2 = resolveUserContext({ deviceKey }).userContext) != null ? _a2 : {};
+};
 var resolveUserContext = (ctx = {}, opts = {}) => {
   var _a2;
   const result = {};
@@ -4151,6 +4194,47 @@ 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 resolveAutoDeviceKey = (opts = {}) => {
+  var _a2, _b;
+  const registry = autoDeviceKeyRegistry();
+  const appId = (_a2 = opts.appId) != null ? _a2 : "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);
+    const slot = deviceIdStorageKey(appId);
+    const minted = id;
+    try {
+      void 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);
+        else void Promise.resolve(storage.setItem(slot, minted)).catch(() => {
+        });
+      }).catch(() => {
+      });
+    } catch {
+    }
+  }
+  return (_b = registry.keys.get(appId)) != null ? _b : id;
+};
+var resetAutoDeviceKeys = () => {
+  const registry = autoDeviceKeyRegistry();
+  registry.keys.clear();
+  registry.hydrating.clear();
+};
 
 // src/activation/revalidation.ts
 var REVALIDATION_SLOT = /* @__PURE__ */ Symbol.for(
@@ -4198,22 +4282,20 @@ var createWireActivation = (config) => {
   var _a2, _b;
   const target = { serverUrl: config.serverUrl, apiKey: config.apiKey };
   const explicitDeviceKey = (_b = clean(config.deviceKey)) != null ? _b : clean((_a2 = config.userContext) == null ? void 0 : _a2.deviceKey);
-  let autoDeviceKey = explicitDeviceKey != null ? explicitDeviceKey : mintDeviceId();
-  if (config.storage && !explicitDeviceKey) {
-    const storage = config.storage;
-    const key = deviceIdStorageKey(config.appId);
-    void storage.getItem(key).then((saved) => {
-      const persisted = clean(saved != null ? saved : void 0);
-      if (persisted) autoDeviceKey = persisted;
-      else void storage.setItem(key, autoDeviceKey).catch(() => {
-      });
-    }).catch(() => {
-    });
-  }
+  const autoDeviceKeyOptions = {
+    appId: config.appId,
+    // An explicit key opts out of minting AND persisting (unchanged contract).
+    storage: explicitDeviceKey ? void 0 : config.storage
+  };
+  if (!explicitDeviceKey) resolveAutoDeviceKey(autoDeviceKeyOptions);
   const applyContext = (event) => {
     var _a3, _b2;
     const resolved = resolveUserContext(
-      { ...(_a3 = config.userContext) != null ? _a3 : {}, deviceKey: explicitDeviceKey != null ? explicitDeviceKey : autoDeviceKey },
+      // `??` is lazy on purpose: an explicit key must never even touch the auto registry.
+      {
+        ...(_a3 = config.userContext) != null ? _a3 : {},
+        deviceKey: explicitDeviceKey != null ? explicitDeviceKey : resolveAutoDeviceKey(autoDeviceKeyOptions)
+      },
       { autoAppVersion: config.appVersion }
     );
     if (resolved.userContext) {
@@ -4222,8 +4304,8 @@ var createWireActivation = (config) => {
     if (resolved.userId && !event.user_id) event.user_id = resolved.userId;
   };
   const track = async (name2, meta) => {
-    const sessionId = getCurrentSessionId();
-    if (!clean(name2) || !sessionId) return false;
+    if (!clean(name2)) return false;
+    const sessionId = ensureCurrentSessionId();
     const event = {
       event_type: "app_event",
       session_id: sessionId,
@@ -4250,9 +4332,16 @@ var useActivationRevalidation = () => React18.useSyncExternalStore(
   getActivationRevalidationVersion
 );
 var useWireActivation = (config) => {
+  var _a2;
   const ref = React18.useRef(void 0);
   const prevKeys = React18.useRef("");
-  const currentKeys = `${config.serverUrl}|${config.apiKey}|${config.appId}|${config.deviceKey}`;
+  const currentKeys = [
+    config.serverUrl,
+    config.apiKey,
+    config.appId,
+    config.deviceKey,
+    (_a2 = config.userContext) == null ? void 0 : _a2.deviceKey
+  ].join("|");
   if (!ref.current || prevKeys.current !== currentKeys) {
     prevKeys.current = currentKeys;
     ref.current = createWireActivation(config);
@@ -4261,6 +4350,154 @@ var useWireActivation = (config) => {
   return { track: ref.current.track, sessionId: ref.current.sessionId, revalidation };
 };
 
+// src/revenuecat/purchaseEvents.ts
+var WIRE_PURCHASE_EVENTS = {
+  /** The paywall became visible (offerings loaded). */
+  paywallShown: "wire_paywall_shown",
+  /** The user tapped buy; the store sheet is about to open. */
+  checkoutStarted: "wire_checkout_started",
+  /** The store confirmed the purchase AND the entitlement is now active. */
+  purchased: "wire_purchase_completed",
+  /** The purchase did not land: a user cancel or a real store/network error (see `reason`). */
+  purchaseFailed: "wire_purchase_failed",
+  /** A restore ran (whether or not it produced an entitlement; see `plan_tier`). */
+  restored: "wire_purchase_restored"
+};
+var PLAN_TIER_CONTEXT_KEY = "plan_tier";
+var asRecord = (value) => typeof value === "object" && value !== null ? value : void 0;
+var activeEntitlement = (info, entitlementId) => {
+  var _a2, _b;
+  const active = asRecord((_b = asRecord((_a2 = asRecord(info)) == null ? void 0 : _a2.entitlements)) == null ? void 0 : _b.active);
+  const found = active == null ? void 0 : active[entitlementId];
+  const entitlement = asRecord(found);
+  if (!entitlement) return void 0;
+  return entitlement.isActive === false ? void 0 : entitlement;
+};
+var isTrial = (entitlement) => typeof entitlement.periodType === "string" && entitlement.periodType.toUpperCase() === "TRIAL";
+var resolvePlanTier = (info, entitlementId) => {
+  const entitlement = activeEntitlement(info, entitlementId);
+  if (!entitlement) return "free";
+  return isTrial(entitlement) ? "trial" : "paid";
+};
+var describePackage = (pkg) => {
+  const props = {};
+  if (!pkg) return props;
+  if (typeof pkg.identifier === "string") props.package_id = pkg.identifier;
+  if (typeof pkg.packageType === "string") props.package_type = pkg.packageType;
+  if (typeof pkg.offeringIdentifier === "string") props.offering_id = pkg.offeringIdentifier;
+  const product = asRecord(pkg.product);
+  if (product) {
+    if (typeof product.identifier === "string") props.product_id = product.identifier;
+    if (typeof product.price === "number" && Number.isFinite(product.price)) {
+      props.price = product.price;
+    }
+    if (typeof product.currencyCode === "string") props.currency = product.currencyCode;
+  }
+  return props;
+};
+var describeEntitlement = (info, entitlementId) => {
+  const entitlement = activeEntitlement(info, entitlementId);
+  const props = {
+    entitlement: entitlementId,
+    plan_tier: entitlement ? isTrial(entitlement) ? "trial" : "paid" : "free"
+  };
+  if (!entitlement) return props;
+  if (typeof entitlement.periodType === "string") props.period_type = entitlement.periodType;
+  props.is_trial = isTrial(entitlement);
+  if (typeof entitlement.willRenew === "boolean") props.will_renew = entitlement.willRenew;
+  if (typeof entitlement.store === "string") props.store = entitlement.store;
+  if (typeof entitlement.productIdentifier === "string") {
+    props.product_id = entitlement.productIdentifier;
+  }
+  if (typeof entitlement.isSandbox === "boolean") props.is_sandbox = entitlement.isSandbox;
+  return props;
+};
+var PURCHASE_CANCELLED_CODE = "1";
+var isUserCancelled = (error) => {
+  const record = asRecord(error);
+  if (!record) return false;
+  if (record.userCancelled === true) return true;
+  return record.code === PURCHASE_CANCELLED_CODE;
+};
+var describeFailure = (error) => {
+  const record = asRecord(error);
+  const code = typeof (record == null ? void 0 : record.code) === "string" ? record.code : "unknown";
+  return { reason: isUserCancelled(error) ? "cancelled" : "error", code };
+};
+
+// src/revenuecat/revenueCatBridge.ts
+var createRevenueCatBridge = (config) => {
+  const { analytics, entitlementId } = config;
+  const writeTier = config.writePlanTier !== false;
+  const emit = (event, props) => {
+    try {
+      const result = analytics.track(event, { ...config.commonProps, ...props });
+      if (result && typeof result.catch === "function") {
+        void result.catch(() => {
+        });
+      }
+    } catch {
+    }
+  };
+  const syncPlanTier = (customerInfo) => {
+    var _a2;
+    const tier = resolvePlanTier(customerInfo, entitlementId);
+    if (!writeTier) return tier;
+    try {
+      (_a2 = analytics.setUserContext) == null ? void 0 : _a2.call(analytics, { extra: { [PLAN_TIER_CONTEXT_KEY]: tier } });
+    } catch {
+    }
+    return tier;
+  };
+  const paywallShown = (offering, props) => {
+    var _a2, _b;
+    const shown = {
+      packages_count: (_b = (_a2 = offering == null ? void 0 : offering.availablePackages) == null ? void 0 : _a2.length) != null ? _b : 0
+    };
+    if (typeof (offering == null ? void 0 : offering.identifier) === "string") shown.offering_id = offering.identifier;
+    emit(WIRE_PURCHASE_EVENTS.paywallShown, { ...shown, ...props });
+  };
+  const checkoutStarted = (pkg, props) => {
+    emit(WIRE_PURCHASE_EVENTS.checkoutStarted, { ...describePackage(pkg), ...props });
+  };
+  const purchaseCompleted = (customerInfo, pkg, props) => {
+    const tier = syncPlanTier(customerInfo);
+    const entitled = tier !== "free";
+    if (entitled) {
+      emit(WIRE_PURCHASE_EVENTS.purchased, {
+        ...describePackage(pkg),
+        ...describeEntitlement(customerInfo, entitlementId),
+        ...props
+      });
+      return true;
+    }
+    emit(WIRE_PURCHASE_EVENTS.purchaseFailed, {
+      ...describePackage(pkg),
+      reason: "not_entitled",
+      code: "unknown",
+      entitlement: entitlementId,
+      ...props
+    });
+    return false;
+  };
+  const purchaseFailed = (error, pkg, props) => {
+    emit(WIRE_PURCHASE_EVENTS.purchaseFailed, {
+      ...describePackage(pkg),
+      ...describeFailure(error),
+      ...props
+    });
+  };
+  const purchasesRestored = (customerInfo, props) => {
+    const tier = syncPlanTier(customerInfo);
+    emit(WIRE_PURCHASE_EVENTS.restored, {
+      ...describeEntitlement(customerInfo, entitlementId),
+      ...props
+    });
+    return tier !== "free";
+  };
+  return { paywallShown, checkoutStarted, purchaseCompleted, purchaseFailed, purchasesRestored, syncPlanTier };
+};
+
 // src/session-analytics/reportSessionStart.ts
 var SESSION_STARTED_EVENT = "app.session_started";
 var _emitted = /* @__PURE__ */ new Set();
@@ -4313,6 +4550,8 @@ var reportSessionStart = (opts) => {
       method: "POST",
       headers,
       body: JSON.stringify({ events: [event] })
+    }).then((res) => {
+      warnOnSkippedEvents(res);
     }).catch(() => {
     });
   } catch {
@@ -4443,11 +4682,13 @@ var reportFirstOpen = (opts) => {
   })();
 };
 var wireLifecycleEvents = (opts) => {
-  reportFirstOpen(opts);
+  var _a2;
+  const sessionId = (_a2 = opts.sessionId) != null ? _a2 : makeSessionId();
+  reportFirstOpen({ ...opts, sessionId });
   reportSessionStart({
     target: opts.target,
     sink: opts.sink,
-    sessionId: opts.sessionId,
+    sessionId,
     userId: opts.userId,
     deviceKey: opts.deviceKey,
     sessionCount: opts.sessionCount,
@@ -4582,6 +4823,7 @@ var createEventQueue = (options) => {
     const timer = setTimeout(() => controller == null ? void 0 : controller.abort(), 15e3);
     try {
       const res = await fetch(req.url, { ...req.init, signal: controller == null ? void 0 : controller.signal });
+      warnOnSkippedEvents(res);
       return !!(res && res.ok);
     } catch {
       return false;
@@ -4687,6 +4929,12 @@ var useLifecycleEvents = (config, options = {}) => {
       var _a3;
       return (cfg == null ? void 0 : cfg.serverUrl) ? { serverUrl: cfg.serverUrl, apiKey: (_a3 = cfg.apiKey) != null ? _a3 : "" } : void 0;
     };
+    const resolveDeviceKey = (cfg, opts) => {
+      const host = typeof opts.deviceKey === "string" && opts.deviceKey.trim() ? opts.deviceKey : void 0;
+      if (host) return host;
+      if (!(cfg == null ? void 0 : cfg.storage)) return void 0;
+      return resolveAutoDeviceKey({ appId: cfg.appId, storage: cfg.storage });
+    };
     const mountOpenSessionId = makeSessionId();
     const fireSession = (sessionId) => {
       var _a3;
@@ -4700,7 +4948,7 @@ var useLifecycleEvents = (config, options = {}) => {
         sink: resolveSink(),
         sessionId,
         userId: opts.userId,
-        deviceKey: opts.deviceKey,
+        deviceKey: resolveDeviceKey(cfg, opts),
         sessionCount: opts.sessionCount,
         appVersion: (_a3 = cfg == null ? void 0 : cfg.appVersion) != null ? _a3 : device.appVersion,
         platform: reactNative.Platform.OS,
@@ -4721,7 +4969,7 @@ var useLifecycleEvents = (config, options = {}) => {
           storage: cfg == null ? void 0 : cfg.storage,
           appId: cfg == null ? void 0 : cfg.appId,
           userId: opts.userId,
-          deviceKey: opts.deviceKey,
+          deviceKey: resolveDeviceKey(cfg, opts),
           sessionCount: opts.sessionCount,
           appVersion: (_a2 = cfg == null ? void 0 : cfg.appVersion) != null ? _a2 : device.appVersion,
           platform: reactNative.Platform.OS,
@@ -4774,6 +5022,7 @@ exports.OnboardingButton = Button;
 exports.OnboardingFlow = OnboardingFlow;
 exports.OnboardingScaffold = OnboardingScaffold;
 exports.OnboardingThemeProvider = OnboardingThemeProvider;
+exports.PLAN_TIER_CONTEXT_KEY = PLAN_TIER_CONTEXT_KEY;
 exports.RESERVED_USER_CONTEXT_KEYS = RESERVED_USER_CONTEXT_KEYS;
 exports.SESSION_STARTED_EVENT = SESSION_STARTED_EVENT;
 exports.SelectionCard = SelectionCard;
@@ -4784,9 +5033,12 @@ exports.USER_ID_MAX_LENGTH = USER_ID_MAX_LENGTH;
 exports.WIRE_ICON_GLYPHS = WIRE_ICON_GLYPHS;
 exports.WIRE_ICON_NAMES = WIRE_ICON_NAMES;
 exports.WIRE_ONBOARDING_EVENTS = WIRE_ONBOARDING_EVENTS;
+exports.WIRE_PURCHASE_EVENTS = WIRE_PURCHASE_EVENTS;
 exports.WireFeaturesProvider = WireFeaturesProvider;
 exports.WireIcon = WireIcon;
 exports.WireOnboarding = WireOnboarding;
+exports.activationJoinContext = activationJoinContext;
+exports.activeEntitlement = activeEntitlement;
 exports.analyticsUserIdStorageKey = analyticsUserIdStorageKey;
 exports.attributionMetadata = attributionMetadata;
 exports.bumpActivationRevalidation = bumpActivationRevalidation;
@@ -4794,14 +5046,19 @@ exports.clearPersistedSession = clearPersistedSession;
 exports.clearPiiFromContext = clearPiiFromContext;
 exports.clearUserContext = clearUserContext;
 exports.collectDeviceContext = collectDeviceContext;
+exports.createRevenueCatBridge = createRevenueCatBridge;
 exports.createWireActivation = createWireActivation;
 exports.defaultIllustrations = defaultIllustrations;
 exports.defaultOnboardingTheme = defaultOnboardingTheme;
 exports.defaultWireFeatures = defaultWireFeatures;
 exports.deriveAnswers = deriveAnswers;
+exports.describeEntitlement = describeEntitlement;
+exports.describeFailure = describeFailure;
+exports.describePackage = describePackage;
 exports.detectAppVersion = detectAppVersion;
 exports.detectNativeModel = detectNativeModel;
 exports.deviceIdStorageKey = deviceIdStorageKey;
+exports.ensureCurrentSessionId = ensureCurrentSessionId;
 exports.featuresCacheKey = featuresCacheKey;
 exports.featuresEqual = featuresEqual;
 exports.fetchWireFeatures = fetchWireFeatures;
@@ -4812,6 +5069,7 @@ exports.hashEmailFnv1a = hashEmailFnv1a;
 exports.identifyOnboarding = identifyOnboarding;
 exports.isFeaturesFresh = isFeaturesFresh;
 exports.isOnboardingEnabled = isOnboardingEnabled;
+exports.isUserCancelled = isUserCancelled;
 exports.isWireScalar = isWireScalar;
 exports.loadPersistedSession = loadPersistedSession;
 exports.looksLikeEmail = looksLikeEmail;
@@ -4833,9 +5091,12 @@ exports.reportClientEventsAwait = reportClientEventsAwait;
 exports.reportFirstOpen = reportFirstOpen;
 exports.reportSessionStart = reportSessionStart;
 exports.resetActivationRevalidation = resetActivationRevalidation;
+exports.resetAutoDeviceKeys = resetAutoDeviceKeys;
 exports.resetCurrentSessionId = resetCurrentSessionId;
 exports.resetFirstOpenLatch = resetFirstOpenLatch;
 exports.resetSessionStartGuard = resetSessionStartGuard;
+exports.resolveAutoDeviceKey = resolveAutoDeviceKey;
+exports.resolvePlanTier = resolvePlanTier;
 exports.resolveUserContext = resolveUserContext;
 exports.sanitizeUserId = sanitizeUserId;
 exports.savePersistedSession = savePersistedSession;