@wireai/activation 0.9.1 → 0.10.0

package/dist/index.js

@@ -1507,22 +1507,38 @@ var readProgress = (response) => {
 
 // src/analytics/reportClientEvent.ts
 var makeSessionId = () => `wire_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;
-var reportClientEvents = (target, events) => {
-  if (!(target == null ? void 0 : target.serverUrl) || events.length === 0) return;
+var buildEventsRequest = (target, events) => {
+  if (!(target == null ? void 0 : target.serverUrl) || events.length === 0) return null;
   try {
     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 })
-    }).catch(() => {
+    return { url, init: { method: "POST", headers, body: JSON.stringify({ events }) } };
+  } catch {
+    return null;
+  }
+};
+var reportClientEvents = (target, events) => {
+  try {
+    const req = buildEventsRequest(target, events);
+    if (!req) return;
+    void fetch(req.url, req.init).catch(() => {
     });
   } catch {
   }
 };
 var reportClientEvent = (target, event) => reportClientEvents(target, [event]);
+var reportClientEventsAwait = async (target, events) => {
+  try {
+    const req = buildEventsRequest(target, events);
+    if (!req) return false;
+    const res = await fetch(req.url, req.init);
+    return Boolean(res && res.ok);
+  } catch {
+    return false;
+  }
+};
+var reportClientEventAwait = (target, event) => reportClientEventsAwait(target, [event]);
 
 // src/analytics/sendPreview.ts
 var sendPreview = (target, { sessionId, userMessage }) => {
@@ -3285,13 +3301,18 @@ var collectDeviceContext = () => {
 };
 
 // src/analytics/currentSession.ts
-var _currentSessionId;
+var CURRENT_SESSION_ID_SLOT = /* @__PURE__ */ Symbol.for(
+  "@wireai/activation:currentSessionId"
+);
+var globalSlot = globalThis;
 var setCurrentSessionId = (id) => {
-  if (typeof id === "string" && id.length > 0) _currentSessionId = id;
+  if (typeof id === "string" && id.length > 0) {
+    globalSlot[CURRENT_SESSION_ID_SLOT] = id;
+  }
 };
-var getCurrentSessionId = () => _currentSessionId;
+var getCurrentSessionId = () => globalSlot[CURRENT_SESSION_ID_SLOT];
 var resetCurrentSessionId = () => {
-  _currentSessionId = void 0;
+  globalSlot[CURRENT_SESSION_ID_SLOT] = void 0;
 };
 
 // src/session/persistedSession.ts
@@ -3351,6 +3372,7 @@ var clearPersistedSession = (storage, key) => {
   } catch {
   }
 };
+var shouldClearOnComplete = (retainSessionOnComplete) => !retainSessionOnComplete;
 
 // src/identity/userIdentity.ts
 var USER_ID_MAX_LENGTH = 128;
@@ -3400,6 +3422,7 @@ var WireOnboarding = ({
   storage,
   sessionTtlMs = DEFAULT_SESSION_TTL_MS,
   persistKey,
+  retainSessionOnComplete,
   userContext,
   userId
 }) => {
@@ -3434,10 +3457,10 @@ var WireOnboarding = ({
   }, [storage, storageKey, sessionTtlMs, session]);
   const handleComplete = React18.useCallback(
     (result) => {
-      if (storage) clearPersistedSession(storage, storageKey);
+      if (storage && shouldClearOnComplete(retainSessionOnComplete)) clearPersistedSession(storage, storageKey);
       onComplete(result);
     },
-    [storage, storageKey, onComplete]
+    [storage, storageKey, retainSessionOnComplete, onComplete]
   );
   const sessionId = (_a2 = session == null ? void 0 : session.id) != null ? _a2 : "";
   const startupUserIdRef = React18.useRef(boundUserId);
@@ -4113,6 +4136,115 @@ var mintDeviceId = () => {
   return `${AUTO_DEVICE_ID_PREFIX}${time}_${randomChunk()}${randomChunk()}`;
 };
 
+// src/activation/revalidation.ts
+var REVALIDATION_SLOT = /* @__PURE__ */ Symbol.for(
+  "@wireai/activation:activationRevalidation"
+);
+var globalSlot2 = globalThis;
+var store = () => {
+  const existing = globalSlot2[REVALIDATION_SLOT];
+  if (existing) return existing;
+  const created = { version: 0, listeners: /* @__PURE__ */ new Set() };
+  globalSlot2[REVALIDATION_SLOT] = created;
+  return created;
+};
+var bumpActivationRevalidation = () => {
+  const s = store();
+  s.version += 1;
+  for (const listener of Array.from(s.listeners)) {
+    try {
+      listener();
+    } catch {
+    }
+  }
+};
+var subscribeActivationRevalidation = (listener) => {
+  const s = store();
+  s.listeners.add(listener);
+  return () => {
+    s.listeners.delete(listener);
+  };
+};
+var getActivationRevalidationVersion = () => store().version;
+var resetActivationRevalidation = () => {
+  const s = store();
+  s.version = 0;
+  s.listeners.clear();
+};
+
+// src/activation/wireActivation.ts
+var clean = (value) => {
+  if (typeof value !== "string") return void 0;
+  const trimmed = value.trim();
+  return trimmed.length > 0 ? trimmed : void 0;
+};
+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 applyContext = (event) => {
+    var _a3, _b2;
+    const resolved = resolveUserContext(
+      { ...(_a3 = config.userContext) != null ? _a3 : {}, deviceKey: explicitDeviceKey != null ? explicitDeviceKey : autoDeviceKey },
+      { autoAppVersion: config.appVersion }
+    );
+    if (resolved.userContext) {
+      event.user_context = { ...resolved.userContext, ...(_b2 = event.user_context) != null ? _b2 : {} };
+    }
+    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;
+    const event = {
+      event_type: "app_event",
+      session_id: sessionId,
+      question_key: name2
+    };
+    if (meta && Object.keys(meta).length > 0) event.meta = JSON.stringify(meta);
+    applyContext(event);
+    const ok = await reportClientEventAwait(target, event);
+    if (ok) bumpActivationRevalidation();
+    return ok;
+  };
+  return {
+    track,
+    get sessionId() {
+      return getCurrentSessionId();
+    },
+    subscribeRevalidation: subscribeActivationRevalidation,
+    getRevalidationVersion: getActivationRevalidationVersion
+  };
+};
+var useActivationRevalidation = () => React18.useSyncExternalStore(
+  subscribeActivationRevalidation,
+  getActivationRevalidationVersion,
+  getActivationRevalidationVersion
+);
+var useWireActivation = (config) => {
+  const ref = React18.useRef(void 0);
+  const prevKeys = React18.useRef("");
+  const currentKeys = `${config.serverUrl}|${config.apiKey}|${config.appId}|${config.deviceKey}`;
+  if (!ref.current || prevKeys.current !== currentKeys) {
+    prevKeys.current = currentKeys;
+    ref.current = createWireActivation(config);
+  }
+  const revalidation = useActivationRevalidation();
+  return { track: ref.current.track, sessionId: ref.current.sessionId, revalidation };
+};
+
 // src/session-analytics/reportSessionStart.ts
 var SESSION_STARTED_EVENT = "app.session_started";
 var _emitted = /* @__PURE__ */ new Set();
@@ -4651,8 +4783,10 @@ exports.WireFeaturesProvider = WireFeaturesProvider;
 exports.WireIcon = WireIcon;
 exports.WireOnboarding = WireOnboarding;
 exports.attributionMetadata = attributionMetadata;
+exports.bumpActivationRevalidation = bumpActivationRevalidation;
 exports.clearPersistedSession = clearPersistedSession;
 exports.collectDeviceContext = collectDeviceContext;
+exports.createWireActivation = createWireActivation;
 exports.defaultIllustrations = defaultIllustrations;
 exports.defaultOnboardingTheme = defaultOnboardingTheme;
 exports.defaultWireFeatures = defaultWireFeatures;
@@ -4664,6 +4798,7 @@ exports.featuresCacheKey = featuresCacheKey;
 exports.featuresEqual = featuresEqual;
 exports.fetchWireFeatures = fetchWireFeatures;
 exports.firstOpenStorageKey = firstOpenStorageKey;
+exports.getActivationRevalidationVersion = getActivationRevalidationVersion;
 exports.getCurrentSessionId = getCurrentSessionId;
 exports.hashEmailFnv1a = hashEmailFnv1a;
 exports.identifyOnboarding = identifyOnboarding;
@@ -4683,9 +4818,12 @@ exports.peekPersistedSession = peekPersistedSession;
 exports.readCachedFeatures = readCachedFeatures;
 exports.readProgress = readProgress;
 exports.reportClientEvent = reportClientEvent;
+exports.reportClientEventAwait = reportClientEventAwait;
 exports.reportClientEvents = reportClientEvents;
+exports.reportClientEventsAwait = reportClientEventsAwait;
 exports.reportFirstOpen = reportFirstOpen;
 exports.reportSessionStart = reportSessionStart;
+exports.resetActivationRevalidation = resetActivationRevalidation;
 exports.resetCurrentSessionId = resetCurrentSessionId;
 exports.resetFirstOpenLatch = resetFirstOpenLatch;
 exports.resetSessionStartGuard = resetSessionStartGuard;
@@ -4694,8 +4832,10 @@ exports.sanitizeUserId = sanitizeUserId;
 exports.savePersistedSession = savePersistedSession;
 exports.sessionStorageKey = sessionStorageKey;
 exports.setCurrentSessionId = setCurrentSessionId;
+exports.subscribeActivationRevalidation = subscribeActivationRevalidation;
 exports.themeFromBrand = themeFromBrand;
 exports.toAnalyticsEvent = toAnalyticsEvent;
+exports.useActivationRevalidation = useActivationRevalidation;
 exports.useHostIcon = useHostIcon;
 exports.useIllustration = useIllustration;
 exports.useLifecycleEvents = useLifecycleEvents;
@@ -4703,6 +4843,7 @@ exports.useOnboardingTheme = useOnboardingTheme;
 exports.useReducedMotion = useReducedMotion;
 exports.useResolvedFeatures = useResolvedFeatures;
 exports.useSessionStart = useSessionStart;
+exports.useWireActivation = useWireActivation;
 exports.useWireFeatures = useWireFeatures;
 exports.useWireFeaturesContext = useWireFeaturesContext;
 exports.wireConfigFromEnv = wireConfigFromEnv;