@wireai/activation 0.11.0 → 0.12.0

package/dist/index.mjs

@@ -1512,6 +1512,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);
@@ -3308,6 +3325,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;
@@ -4107,6 +4146,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 = {};
@@ -4145,6 +4188,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(
@@ -4192,22 +4276,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) {
@@ -4216,8 +4298,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,
@@ -4244,9 +4326,16 @@ var useActivationRevalidation = () => useSyncExternalStore(
   getActivationRevalidationVersion
 );
 var useWireActivation = (config) => {
+  var _a2;
   const ref = useRef(void 0);
   const prevKeys = 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);
@@ -4255,6 +4344,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();
@@ -4307,6 +4544,8 @@ var reportSessionStart = (opts) => {
       method: "POST",
       headers,
       body: JSON.stringify({ events: [event] })
+    }).then((res) => {
+      warnOnSkippedEvents(res);
     }).catch(() => {
     });
   } catch {
@@ -4437,11 +4676,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,
@@ -4576,6 +4817,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;
@@ -4681,6 +4923,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;
@@ -4694,7 +4942,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: Platform.OS,
@@ -4715,7 +4963,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: Platform.OS,
@@ -4743,6 +4991,6 @@ var useLifecycleEvents = (config, options = {}) => {
   }, []);
 };
 
-export { AUTO_DEVICE_ID_PREFIX, AnimatedSparkle, BACKGROUND_SESSION_MS, CardGridSelectCard, CardHandoff, CenteredModal, ChipSelectCard, CompletionView, DEFAULT_FEATURES_TTL_MS, DEFAULT_SESSION_TTL_MS, DemoOnboarding, DoneBlock, EXTRA_KEY_PREFIX, ErrorBlock, FIRST_OPEN_EVENT, IconRegistryProvider, IllustrationProvider, InterstitialCard, LoadingBlock, LoadingScreen, NumberStepperCard, Button as OnboardingButton, OnboardingFlow, OnboardingScaffold, OnboardingThemeProvider, RESERVED_USER_CONTEXT_KEYS, SESSION_STARTED_EVENT, SelectionCard, StatusCard, StepProgress, TextInputCard, USER_ID_MAX_LENGTH, WIRE_ICON_GLYPHS, WIRE_ICON_NAMES, WIRE_ONBOARDING_EVENTS, WireFeaturesProvider, WireIcon, WireOnboarding, analyticsUserIdStorageKey, attributionMetadata, bumpActivationRevalidation, clearPersistedSession, clearPiiFromContext, clearUserContext, collectDeviceContext, createWireActivation, defaultIllustrations, defaultOnboardingTheme, defaultWireFeatures, deriveAnswers, detectAppVersion, detectNativeModel, deviceIdStorageKey, featuresCacheKey, featuresEqual, fetchWireFeatures, firstOpenStorageKey, getActivationRevalidationVersion, getCurrentSessionId, hashEmailFnv1a, identifyOnboarding, isFeaturesFresh, isOnboardingEnabled, isWireScalar, loadPersistedSession, looksLikeEmail, lookupIconGlyph, makeSessionId, mergeTheme, mintDeviceId, motionSpec_exports as motionSpec, namespaceExtra, onboardingComponents, parseWireFeatures, peekPersistedSession, readCachedFeatures, readProgress, reportClientEvent, reportClientEventAwait, reportClientEvents, reportClientEventsAwait, reportFirstOpen, reportSessionStart, resetActivationRevalidation, resetCurrentSessionId, resetFirstOpenLatch, resetSessionStartGuard, resolveUserContext, sanitizeUserId, savePersistedSession, sessionStorageKey, setCurrentSessionId, subscribeActivationRevalidation, themeFromBrand, toAnalyticsEvent, useActivationRevalidation, useHostIcon, useIllustration, useLifecycleEvents, useOnboardingTheme, useReducedMotion, useResolvedFeatures, useSessionStart, useWireActivation, useWireFeatures, useWireFeaturesContext, wireConfigFromEnv, wireLifecycleEvents, writeCachedFeatures };
+export { AUTO_DEVICE_ID_PREFIX, AnimatedSparkle, BACKGROUND_SESSION_MS, CardGridSelectCard, CardHandoff, CenteredModal, ChipSelectCard, CompletionView, DEFAULT_FEATURES_TTL_MS, DEFAULT_SESSION_TTL_MS, DemoOnboarding, DoneBlock, EXTRA_KEY_PREFIX, ErrorBlock, FIRST_OPEN_EVENT, IconRegistryProvider, IllustrationProvider, InterstitialCard, LoadingBlock, LoadingScreen, NumberStepperCard, Button as OnboardingButton, OnboardingFlow, OnboardingScaffold, OnboardingThemeProvider, PLAN_TIER_CONTEXT_KEY, RESERVED_USER_CONTEXT_KEYS, SESSION_STARTED_EVENT, SelectionCard, StatusCard, StepProgress, TextInputCard, USER_ID_MAX_LENGTH, WIRE_ICON_GLYPHS, WIRE_ICON_NAMES, WIRE_ONBOARDING_EVENTS, WIRE_PURCHASE_EVENTS, WireFeaturesProvider, WireIcon, WireOnboarding, activationJoinContext, activeEntitlement, analyticsUserIdStorageKey, attributionMetadata, bumpActivationRevalidation, clearPersistedSession, clearPiiFromContext, clearUserContext, collectDeviceContext, createRevenueCatBridge, createWireActivation, defaultIllustrations, defaultOnboardingTheme, defaultWireFeatures, deriveAnswers, describeEntitlement, describeFailure, describePackage, detectAppVersion, detectNativeModel, deviceIdStorageKey, ensureCurrentSessionId, featuresCacheKey, featuresEqual, fetchWireFeatures, firstOpenStorageKey, getActivationRevalidationVersion, getCurrentSessionId, hashEmailFnv1a, identifyOnboarding, isFeaturesFresh, isOnboardingEnabled, isUserCancelled, isWireScalar, loadPersistedSession, looksLikeEmail, lookupIconGlyph, makeSessionId, mergeTheme, mintDeviceId, motionSpec_exports as motionSpec, namespaceExtra, onboardingComponents, parseWireFeatures, peekPersistedSession, readCachedFeatures, readProgress, reportClientEvent, reportClientEventAwait, reportClientEvents, reportClientEventsAwait, reportFirstOpen, reportSessionStart, resetActivationRevalidation, resetAutoDeviceKeys, resetCurrentSessionId, resetFirstOpenLatch, resetSessionStartGuard, resolveAutoDeviceKey, resolvePlanTier, resolveUserContext, sanitizeUserId, savePersistedSession, sessionStorageKey, setCurrentSessionId, subscribeActivationRevalidation, themeFromBrand, toAnalyticsEvent, useActivationRevalidation, useHostIcon, useIllustration, useLifecycleEvents, useOnboardingTheme, useReducedMotion, useResolvedFeatures, useSessionStart, useWireActivation, useWireFeatures, useWireFeaturesContext, wireConfigFromEnv, wireLifecycleEvents, writeCachedFeatures };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map