@wireai/activation 0.1.1 → 0.3.0

package/dist/index.js

@@ -3101,7 +3101,7 @@ var resetSessionStartGuard = () => {
 var reportSessionStart = (opts) => {
   var _a;
   const target = opts.target;
-  if (!(target == null ? void 0 : target.serverUrl)) return;
+  if (!opts.sink && !(target == null ? void 0 : target.serverUrl)) return;
   const sessionId = (_a = opts.sessionId) != null ? _a : makeSessionId();
   if (opts.once !== false) {
     if (_emitted.has(sessionId)) return;
@@ -3112,9 +3112,6 @@ var reportSessionStart = (opts) => {
     _emitted.add(sessionId);
   }
   try {
-    const url = `${target.serverUrl.replace(/\/$/, "")}/v1/events`;
-    const headers = { "Content-Type": "application/json" };
-    if (target.apiKey) headers.Authorization = `Bearer ${target.apiKey}`;
     const userContext = {};
     if (opts.deviceKey) userContext.device_key = opts.deviceKey;
     if (typeof opts.sessionCount === "number" && Number.isFinite(opts.sessionCount)) {
@@ -3133,6 +3130,14 @@ var reportSessionStart = (opts) => {
     if (Object.keys(userContext).length > 0) event.user_context = userContext;
     if (opts.device) event.device = opts.device;
     if (opts.meta && Object.keys(opts.meta).length > 0) event.meta = JSON.stringify(opts.meta);
+    if (opts.sink) {
+      opts.sink(event);
+      return;
+    }
+    if (!(target == null ? void 0 : target.serverUrl)) return;
+    const url = `${target.serverUrl.replace(/\/$/, "")}/v1/events`;
+    const headers = { "Content-Type": "application/json" };
+    if (target.apiKey) headers.Authorization = `Bearer ${target.apiKey}`;
     void fetch(url, {
       method: "POST",
       headers,
@@ -3187,6 +3192,398 @@ var useSessionStart = (config, options = {}) => {
   }, []);
 };
 
+// src/session-analytics/lifecycle.ts
+var FIRST_OPEN_EVENT = "app.first_open";
+var firstOpenStorageKey = (appId) => `wireai:first_open:${appId}`;
+var READ_TIMEOUT_MS3 = 1500;
+var withTimeout3 = (p, ms) => {
+  let timer;
+  const timeout = new Promise((resolve) => {
+    timer = setTimeout(() => resolve(void 0), ms);
+  });
+  return Promise.race([p, timeout]).finally(() => clearTimeout(timer));
+};
+var _firstOpenLatched = /* @__PURE__ */ new Set();
+var resetFirstOpenLatch = () => {
+  _firstOpenLatched.clear();
+};
+var buildLifecycleEvent = (questionKey, opts) => {
+  var _a;
+  const userContext = {};
+  if (opts.deviceKey) userContext.device_key = opts.deviceKey;
+  if (typeof opts.sessionCount === "number" && Number.isFinite(opts.sessionCount)) {
+    userContext.session_count = opts.sessionCount;
+    userContext.returning = opts.sessionCount > 1;
+  }
+  if (opts.appVersion) userContext.app_version = opts.appVersion;
+  if (opts.platform) userContext.platform = opts.platform;
+  const event = {
+    event_type: "app_event",
+    question_key: questionKey,
+    session_id: (_a = opts.sessionId) != null ? _a : makeSessionId()
+  };
+  const userId = sanitizeUserId(opts.userId);
+  if (userId) event.user_id = userId;
+  if (Object.keys(userContext).length > 0) event.user_context = userContext;
+  if (opts.device) event.device = opts.device;
+  if (opts.meta && Object.keys(opts.meta).length > 0) event.meta = JSON.stringify(opts.meta);
+  return event;
+};
+var routeLifecycleEvent = (event, opts) => {
+  try {
+    if (opts.sink) {
+      opts.sink(event);
+      return;
+    }
+    const target = opts.target;
+    if (!(target == null ? void 0 : target.serverUrl)) return;
+    const url = `${target.serverUrl.replace(/\/$/, "")}/v1/events`;
+    const headers = { "Content-Type": "application/json" };
+    if (target.apiKey) headers.Authorization = `Bearer ${target.apiKey}`;
+    void fetch(url, {
+      method: "POST",
+      headers,
+      body: JSON.stringify({ events: [event] })
+    }).catch(() => {
+    });
+  } catch {
+  }
+};
+var emitFirstOpen = (opts) => {
+  routeLifecycleEvent(buildLifecycleEvent(FIRST_OPEN_EVENT, opts), opts);
+};
+var reportFirstOpen = (opts) => {
+  var _a;
+  const appId = (_a = opts.appId) != null ? _a : "default";
+  if (_firstOpenLatched.has(appId)) return;
+  _firstOpenLatched.add(appId);
+  const storage = opts.storage;
+  if (!storage) {
+    emitFirstOpen(opts);
+    return;
+  }
+  const key = firstOpenStorageKey(appId);
+  void (async () => {
+    try {
+      const seen = await withTimeout3(storage.getItem(key), READ_TIMEOUT_MS3);
+      if (seen) return;
+      emitFirstOpen(opts);
+      try {
+        void storage.setItem(key, JSON.stringify({ ts: Date.now() })).catch(() => {
+        });
+      } catch {
+      }
+    } catch {
+      emitFirstOpen(opts);
+    }
+  })();
+};
+var wireLifecycleEvents = (opts) => {
+  reportFirstOpen(opts);
+  reportSessionStart({
+    target: opts.target,
+    sink: opts.sink,
+    sessionId: opts.sessionId,
+    userId: opts.userId,
+    deviceKey: opts.deviceKey,
+    sessionCount: opts.sessionCount,
+    appVersion: opts.appVersion,
+    platform: opts.platform,
+    device: opts.device,
+    meta: opts.meta
+  });
+};
+
+// src/analytics/eventQueue.ts
+var DEFAULTS = {
+  maxSize: 200,
+  batchSize: 20,
+  baseBackoffMs: 1e3,
+  maxBackoffMs: 3e4,
+  maxRetries: 6
+};
+var READ_TIMEOUT_MS4 = 1500;
+var withTimeout4 = (p, ms) => {
+  let timer;
+  const timeout = new Promise((resolve) => {
+    timer = setTimeout(() => resolve(void 0), ms);
+  });
+  return Promise.race([p, timeout]).finally(() => clearTimeout(timer));
+};
+var unrefTimer = (timer) => {
+  const t = timer;
+  if (typeof t.unref === "function") t.unref();
+};
+var parsePersisted2 = (raw) => {
+  if (!raw) return [];
+  try {
+    const parsed = JSON.parse(raw);
+    if (!Array.isArray(parsed)) return [];
+    const items = [];
+    for (const entry of parsed) {
+      if (entry && typeof entry === "object" && typeof entry.id === "number" && entry.event && typeof entry.event === "object") {
+        items.push(entry);
+      }
+    }
+    return items;
+  } catch {
+    return [];
+  }
+};
+var createEventQueue = (options) => {
+  var _a, _b, _c, _d, _e, _f, _g;
+  const target = options.target;
+  const storage = options.storage;
+  const key = (_b = options.storageKey) != null ? _b : `wireai:evtq:${(_a = options.appId) != null ? _a : "default"}`;
+  const maxSize = (_c = options.maxSize) != null ? _c : DEFAULTS.maxSize;
+  const batchSize = (_d = options.batchSize) != null ? _d : DEFAULTS.batchSize;
+  const baseBackoffMs = (_e = options.baseBackoffMs) != null ? _e : DEFAULTS.baseBackoffMs;
+  const maxBackoffMs = (_f = options.maxBackoffMs) != null ? _f : DEFAULTS.maxBackoffMs;
+  const maxRetries = (_g = options.maxRetries) != null ? _g : DEFAULTS.maxRetries;
+  let pending = [];
+  let nextId = 0;
+  let flushing = false;
+  let attempt = 0;
+  let retryTimer;
+  const resolveEnvelope = () => {
+    try {
+      return typeof options.envelope === "function" ? options.envelope() : options.envelope;
+    } catch {
+      return void 0;
+    }
+  };
+  const stamp = (event) => {
+    var _a2;
+    const env = resolveEnvelope();
+    const stamped = { ...event };
+    if (!env) return stamped;
+    if (!stamped.device && env.device) stamped.device = env.device;
+    if (!stamped.session_id && env.sessionId) stamped.session_id = env.sessionId;
+    const uc = { ...(_a2 = stamped.user_context) != null ? _a2 : {} };
+    if (env.appVersion && uc.app_version === void 0) uc.app_version = env.appVersion;
+    if (env.appBuild && uc.app_build === void 0) uc.app_build = env.appBuild;
+    if (env.networkType && uc.network_type === void 0) uc.network_type = env.networkType;
+    if (Object.keys(uc).length > 0) stamped.user_context = uc;
+    return stamped;
+  };
+  const persist = () => {
+    if (!storage) return;
+    try {
+      if (pending.length === 0) {
+        void storage.removeItem(key).catch(() => {
+        });
+        return;
+      }
+      const payload = pending.map((item) => ({ id: item.id, event: item.event }));
+      void storage.setItem(key, JSON.stringify(payload)).catch(() => {
+      });
+    } catch {
+    }
+  };
+  const enforceSizeCap = () => {
+    if (pending.length > maxSize) pending.splice(0, pending.length - maxSize);
+  };
+  const safeSig = (event) => {
+    try {
+      return JSON.stringify(event);
+    } catch {
+      return `__nosig_${nextId}_${Math.random()}`;
+    }
+  };
+  const loadPromise = (async () => {
+    if (!storage) return;
+    try {
+      const persistedItems = parsePersisted2(await withTimeout4(storage.getItem(key), READ_TIMEOUT_MS4));
+      if (persistedItems.length === 0) return;
+      const events = [...persistedItems.map((p) => p.event), ...pending.map((p) => p.event)];
+      pending = [];
+      nextId = 0;
+      const seen = /* @__PURE__ */ new Set();
+      for (const event of events) {
+        const sig = safeSig(event);
+        if (seen.has(sig)) continue;
+        seen.add(sig);
+        pending.push({ id: nextId++, event, sig });
+      }
+      enforceSizeCap();
+      persist();
+    } catch {
+    }
+  })();
+  const postBatch = async (events) => {
+    if (!(target == null ? void 0 : target.serverUrl) || events.length === 0) return false;
+    try {
+      const url = `${target.serverUrl.replace(/\/$/, "")}/v1/events`;
+      const headers = { "Content-Type": "application/json" };
+      if (target.apiKey) headers.Authorization = `Bearer ${target.apiKey}`;
+      const res = await fetch(url, {
+        method: "POST",
+        headers,
+        body: JSON.stringify({ events })
+      });
+      return !!(res && res.ok);
+    } catch {
+      return false;
+    }
+  };
+  const clearRetry = () => {
+    if (retryTimer !== void 0) {
+      clearTimeout(retryTimer);
+      retryTimer = void 0;
+    }
+  };
+  const scheduleRetry = () => {
+    if (attempt >= maxRetries) return;
+    const delay = Math.min(baseBackoffMs * 2 ** attempt, maxBackoffMs);
+    attempt++;
+    clearRetry();
+    retryTimer = setTimeout(() => {
+      retryTimer = void 0;
+      void drain();
+    }, delay);
+    unrefTimer(retryTimer);
+  };
+  const drain = async () => {
+    try {
+      await loadPromise;
+    } catch {
+    }
+    if (flushing) return;
+    flushing = true;
+    try {
+      while (pending.length > 0) {
+        const batch = pending.slice(0, batchSize);
+        const ok = await postBatch(batch.map((item) => item.event));
+        if (!ok) {
+          scheduleRetry();
+          return;
+        }
+        const acked = new Set(batch.map((item) => item.id));
+        pending = pending.filter((item) => !acked.has(item.id));
+        persist();
+        attempt = 0;
+        clearRetry();
+      }
+    } finally {
+      flushing = false;
+    }
+  };
+  const flush = () => {
+    try {
+      void drain();
+    } catch {
+    }
+  };
+  const enqueue = (event) => {
+    try {
+      const stamped = stamp(event);
+      const sig = safeSig(stamped);
+      for (const item of pending) {
+        if (item.sig === sig) return;
+      }
+      pending.push({ id: nextId++, event: stamped, sig });
+      enforceSizeCap();
+      persist();
+      if (retryTimer === void 0) flush();
+    } catch {
+    }
+  };
+  const notifyOnline = () => {
+    attempt = 0;
+    clearRetry();
+    flush();
+  };
+  const size = () => pending.length;
+  return { enqueue, flush, notifyOnline, size };
+};
+
+// src/session-analytics/useLifecycleEvents.ts
+var useLifecycleEvents = (config, options = {}) => {
+  const latest = React14.useRef({ config, options });
+  latest.current = { config, options };
+  const queueRef = React14.useRef(void 0);
+  React14.useEffect(() => {
+    var _a;
+    const resolveSink = () => {
+      var _a2, _b;
+      const { config: cfg, options: opts } = latest.current;
+      if (opts.sink) return opts.sink;
+      if (!(cfg == null ? void 0 : cfg.serverUrl)) return void 0;
+      if (!queueRef.current) {
+        queueRef.current = createEventQueue({
+          target: { serverUrl: cfg.serverUrl, apiKey: (_a2 = cfg.apiKey) != null ? _a2 : "" },
+          storage: cfg.storage,
+          // Dedicated key so the hook's internal queue never collides with a host's main queue.
+          storageKey: `wireai:evtq:lifecycle:${(_b = cfg.appId) != null ? _b : "default"}`,
+          envelope: opts.envelope
+        });
+      }
+      return queueRef.current.enqueue;
+    };
+    const targetOf = (cfg) => {
+      var _a2;
+      return (cfg == null ? void 0 : cfg.serverUrl) ? { serverUrl: cfg.serverUrl, apiKey: (_a2 = cfg.apiKey) != null ? _a2 : "" } : void 0;
+    };
+    {
+      const { config: cfg, options: opts } = latest.current;
+      if (opts.enabled !== false) {
+        const device = collectDeviceContext();
+        if ((cfg == null ? void 0 : cfg.appVersion) && !device.appVersion) device.appVersion = cfg.appVersion;
+        reportFirstOpen({
+          target: targetOf(cfg),
+          sink: resolveSink(),
+          storage: cfg == null ? void 0 : cfg.storage,
+          appId: cfg == null ? void 0 : cfg.appId,
+          userId: opts.userId,
+          deviceKey: opts.deviceKey,
+          sessionCount: opts.sessionCount,
+          appVersion: (_a = cfg == null ? void 0 : cfg.appVersion) != null ? _a : device.appVersion,
+          platform: reactNative.Platform.OS,
+          device,
+          meta: opts.meta
+        });
+      }
+    }
+    const fireSession = () => {
+      var _a2;
+      const { config: cfg, options: opts } = latest.current;
+      if (opts.enabled === false) return;
+      if (!(cfg == null ? void 0 : cfg.serverUrl) && !opts.sink) return;
+      const device = collectDeviceContext();
+      if ((cfg == null ? void 0 : cfg.appVersion) && !device.appVersion) device.appVersion = cfg.appVersion;
+      reportSessionStart({
+        target: targetOf(cfg),
+        sink: resolveSink(),
+        // A fresh per-open id each fire; the emitter's once-guard dedupes within the open.
+        userId: opts.userId,
+        deviceKey: opts.deviceKey,
+        sessionCount: opts.sessionCount,
+        appVersion: (_a2 = cfg == null ? void 0 : cfg.appVersion) != null ? _a2 : device.appVersion,
+        platform: reactNative.Platform.OS,
+        device,
+        meta: opts.meta
+      });
+    };
+    fireSession();
+    let backgroundedAt = null;
+    const onChange = (state) => {
+      if (state === "background" || state === "inactive") {
+        if (backgroundedAt == null) backgroundedAt = Date.now();
+        return;
+      }
+      if (state === "active") {
+        const since = backgroundedAt;
+        backgroundedAt = null;
+        if (since != null && Date.now() - since >= BACKGROUND_SESSION_MS) fireSession();
+      }
+    };
+    const sub = reactNative.AppState.addEventListener("change", onChange);
+    return () => {
+      if (sub && typeof sub.remove === "function") sub.remove();
+    };
+  }, []);
+};
+
 exports.AnimatedSparkle = AnimatedSparkle;
 exports.BACKGROUND_SESSION_MS = BACKGROUND_SESSION_MS;
 exports.CardHandoff = CardHandoff;
@@ -3198,6 +3595,7 @@ exports.DEFAULT_SESSION_TTL_MS = DEFAULT_SESSION_TTL_MS;
 exports.DemoOnboarding = DemoOnboarding;
 exports.DoneBlock = DoneBlock;
 exports.ErrorBlock = ErrorBlock;
+exports.FIRST_OPEN_EVENT = FIRST_OPEN_EVENT;
 exports.IllustrationProvider = IllustrationProvider;
 exports.InterstitialCard = InterstitialCard;
 exports.LoadingBlock = LoadingBlock;
@@ -3226,6 +3624,7 @@ exports.deriveAnswers = deriveAnswers;
 exports.featuresCacheKey = featuresCacheKey;
 exports.featuresEqual = featuresEqual;
 exports.fetchWireFeatures = fetchWireFeatures;
+exports.firstOpenStorageKey = firstOpenStorageKey;
 exports.identifyOnboarding = identifyOnboarding;
 exports.isFeaturesFresh = isFeaturesFresh;
 exports.isOnboardingEnabled = isOnboardingEnabled;
@@ -3240,7 +3639,9 @@ exports.readCachedFeatures = readCachedFeatures;
 exports.readProgress = readProgress;
 exports.reportClientEvent = reportClientEvent;
 exports.reportClientEvents = reportClientEvents;
+exports.reportFirstOpen = reportFirstOpen;
 exports.reportSessionStart = reportSessionStart;
+exports.resetFirstOpenLatch = resetFirstOpenLatch;
 exports.resetSessionStartGuard = resetSessionStartGuard;
 exports.sanitizeUserId = sanitizeUserId;
 exports.savePersistedSession = savePersistedSession;
@@ -3248,6 +3649,7 @@ exports.sessionStorageKey = sessionStorageKey;
 exports.themeFromBrand = themeFromBrand;
 exports.toAnalyticsEvent = toAnalyticsEvent;
 exports.useIllustration = useIllustration;
+exports.useLifecycleEvents = useLifecycleEvents;
 exports.useOnboardingTheme = useOnboardingTheme;
 exports.useReducedMotion = useReducedMotion;
 exports.useResolvedFeatures = useResolvedFeatures;
@@ -3255,6 +3657,7 @@ exports.useSessionStart = useSessionStart;
 exports.useWireFeatures = useWireFeatures;
 exports.useWireFeaturesContext = useWireFeaturesContext;
 exports.wireConfigFromEnv = wireConfigFromEnv;
+exports.wireLifecycleEvents = wireLifecycleEvents;
 exports.writeCachedFeatures = writeCachedFeatures;
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map