@guidelytech/react-native 0.13.0 → 0.15.0

package/dist/index.d.cts

@@ -526,7 +526,12 @@ interface DeviceEnvironment {
     platform: "ios" | "android";
     deviceType: "mobile" | "tablet";
     locale?: string;
+    /** Host app version, detected from a linked native module (see `core/device.ts`). */
     appVersion?: string;
+    /** Host app build number (`CFBundleVersion` / `versionCode`). */
+    appBuild?: string;
+    /** OS version: `18.1` on iOS, `14` on Android. */
+    osVersion?: string;
 }
 interface GuidelyOptions {
     /** Environment public key, e.g. `pk_dev_…`. Not a secret. */
@@ -544,9 +549,13 @@ interface GuidelyOptions {
     /** Send analytics events (default `true`). Guides still render when disabled. */
     analytics?: boolean;
     consent?: ConsentState;
-    /** Host app version for `app.version` targeting rules and `app_install` / `app_update` events (e.g. from `expo-application`). */
+    /**
+     * Host app version for `app.version` targeting rules, every event's `appVersion` and `app_install` /
+     * `app_update`. Detected on iOS and Android when `@guidelytech/react-native-replay`, `expo-application`
+     * or `react-native-device-info` is linked; pass it to override that (or when none is).
+     */
     appVersion?: string;
-    /** Host app build number (`CFBundleVersion` / `versionCode`), sent as `build` with app lifecycle events. */
+    /** Host app build number (`CFBundleVersion` / `versionCode`), sent as `build` with app lifecycle events. Detected like `appVersion`. */
     appBuild?: string;
     /**
      * Product analytics autocapture: taps (`click`), rage taps, heatmaps, time on screen
@@ -682,7 +691,7 @@ interface UiState {
 }
 
 declare const SDK_NAME = "@guidelytech/react-native";
-declare const SDK_VERSION = "0.13.0";
+declare const SDK_VERSION = "0.15.0";
 declare const DEFAULT_API_URL = "https://guidelytech.com";
 /** Host-platform services the engine needs; the provider supplies React Native implementations. */
 interface PlatformBridge {
@@ -872,7 +881,7 @@ declare class GuidelyClient {
     private appInfo;
     /**
      * Once per launch, as soon as a config is known: `app_install` / `app_update` from the stored
-     * version (when the app passes `appVersion` and `storage`), then `app_open` with `coldStart: true`.
+     * version (when the app version is known and the app passes `storage`), then `app_open` with `coldStart: true`.
      */
     private checkLaunch;
     private wentToBackground;
@@ -1063,6 +1072,33 @@ declare class GuidelyClient {
     private log;
 }
 
+/**
+ * Host app and OS versions, read from native modules the app already links (never imported, so none
+ * of them is a dependency): `@guidelytech/react-native-replay`, `expo-application`, then
+ * `react-native-device-info`. React Native itself has no API for the app's own version.
+ */
+interface AppVersionInfo {
+    /** `CFBundleShortVersionString` / `versionName`. */
+    appVersion?: string;
+    /** `CFBundleVersion` / `versionCode`. */
+    appBuild?: string;
+}
+/** Where the lookups read from; the provider passes React Native's objects, tests pass fakes. */
+interface NativeSources {
+    platform: {
+        OS: string;
+        Version?: string | number;
+        constants?: Record<string, unknown>;
+    };
+    nativeModules: Record<string, unknown>;
+    /** `globalThis.expo.modules` in Expo SDK 50+ apps. */
+    expoModules?: Record<string, unknown>;
+}
+/** The host app's version and build, or `{}` when no linked module knows them. */
+declare function detectAppVersion(src: NativeSources): AppVersionInfo;
+/** The OS version: `18.1` on iOS, `14` on Android (falling back to the API level). */
+declare function detectOsVersion(src: NativeSources): string | undefined;
+
 /**
  * Declares which screen its children are on, so targets on screens that are mounted but not
  * visible (inactive tabs, screens under a stack) are never used. `name` must match what you pass
@@ -1281,4 +1317,4 @@ declare function useGuideState(idOrKey: string): {
 /** The guide currently running exclusively (flow, modal, survey…), or null. */
 declare function useActiveGuide(): PublishedGuide | null;
 
-export { type AutocaptureOption, type ChecklistView, DEFAULT_API_URL, type DeviceEnvironment, Feature, FeatureFlag, type FeatureProps, FeatureValue, type FeatureValueProps, FlagsProvider, type FlagsProviderProps, type GuideStepInfo, GuidelyClient, type GuidelyEventName, type GuidelyEvents, GuidelyMask, type GuidelyMaskProps, type GuidelyOptions, GuidelyOverlay, GuidelyProvider, type GuidelyProviderProps, GuidelyScreenScope, type GuidelyStorage, GuidelyTarget, type GuidelyTargetProps, HeatmapBuffer, type Insets, Messenger, type MessengerSnapshot, type MessengerTab, type MessengerThread, type MessengerView, type PlatformBridge, RageClickDetector, type ReplayCaptureOptions, type ReplayFrame, ReplayUploader, RrwebEvents, SDK_NAME, SDK_VERSION, type ScreenCapturer, SessionRecorder, type SessionReplayOptions, type StepView, type SurveyView, type TapElement, type TapInfo, type TapProperties, TapTracker, TargetRegistry, type TouchPhase, type UiState, createSseParser, guidelyScreenLayout, htmlToText, noopClient, parseHtml, positionCard, targetIdsFor, useActiveGuide, useChecklistProgress, useFeatureValue, useFlag, useFlagDetails, useFlags, useFlagsClient, useFlagsReady, useGuideState, useGuidely, useGuidelyEvent, useGuidelyIdentify, useGuidelyNavigation, useGuidelyReady, useGuidelyScreen, useGuidelyTarget };
+export { type AppVersionInfo, type AutocaptureOption, type ChecklistView, DEFAULT_API_URL, type DeviceEnvironment, Feature, FeatureFlag, type FeatureProps, FeatureValue, type FeatureValueProps, FlagsProvider, type FlagsProviderProps, type GuideStepInfo, GuidelyClient, type GuidelyEventName, type GuidelyEvents, GuidelyMask, type GuidelyMaskProps, type GuidelyOptions, GuidelyOverlay, GuidelyProvider, type GuidelyProviderProps, GuidelyScreenScope, type GuidelyStorage, GuidelyTarget, type GuidelyTargetProps, HeatmapBuffer, type Insets, Messenger, type MessengerSnapshot, type MessengerTab, type MessengerThread, type MessengerView, type NativeSources, type PlatformBridge, RageClickDetector, type ReplayCaptureOptions, type ReplayFrame, ReplayUploader, RrwebEvents, SDK_NAME, SDK_VERSION, type ScreenCapturer, SessionRecorder, type SessionReplayOptions, type StepView, type SurveyView, type TapElement, type TapInfo, type TapProperties, TapTracker, TargetRegistry, type TouchPhase, type UiState, createSseParser, detectAppVersion, detectOsVersion, guidelyScreenLayout, htmlToText, noopClient, parseHtml, positionCard, targetIdsFor, useActiveGuide, useChecklistProgress, useFeatureValue, useFlag, useFlagDetails, useFlags, useFlagsClient, useFlagsReady, useGuideState, useGuidely, useGuidelyEvent, useGuidelyIdentify, useGuidelyNavigation, useGuidelyReady, useGuidelyScreen, useGuidelyTarget };

package/dist/index.d.ts

@@ -526,7 +526,12 @@ interface DeviceEnvironment {
     platform: "ios" | "android";
     deviceType: "mobile" | "tablet";
     locale?: string;
+    /** Host app version, detected from a linked native module (see `core/device.ts`). */
     appVersion?: string;
+    /** Host app build number (`CFBundleVersion` / `versionCode`). */
+    appBuild?: string;
+    /** OS version: `18.1` on iOS, `14` on Android. */
+    osVersion?: string;
 }
 interface GuidelyOptions {
     /** Environment public key, e.g. `pk_dev_…`. Not a secret. */
@@ -544,9 +549,13 @@ interface GuidelyOptions {
     /** Send analytics events (default `true`). Guides still render when disabled. */
     analytics?: boolean;
     consent?: ConsentState;
-    /** Host app version for `app.version` targeting rules and `app_install` / `app_update` events (e.g. from `expo-application`). */
+    /**
+     * Host app version for `app.version` targeting rules, every event's `appVersion` and `app_install` /
+     * `app_update`. Detected on iOS and Android when `@guidelytech/react-native-replay`, `expo-application`
+     * or `react-native-device-info` is linked; pass it to override that (or when none is).
+     */
     appVersion?: string;
-    /** Host app build number (`CFBundleVersion` / `versionCode`), sent as `build` with app lifecycle events. */
+    /** Host app build number (`CFBundleVersion` / `versionCode`), sent as `build` with app lifecycle events. Detected like `appVersion`. */
     appBuild?: string;
     /**
      * Product analytics autocapture: taps (`click`), rage taps, heatmaps, time on screen
@@ -682,7 +691,7 @@ interface UiState {
 }
 
 declare const SDK_NAME = "@guidelytech/react-native";
-declare const SDK_VERSION = "0.13.0";
+declare const SDK_VERSION = "0.15.0";
 declare const DEFAULT_API_URL = "https://guidelytech.com";
 /** Host-platform services the engine needs; the provider supplies React Native implementations. */
 interface PlatformBridge {
@@ -872,7 +881,7 @@ declare class GuidelyClient {
     private appInfo;
     /**
      * Once per launch, as soon as a config is known: `app_install` / `app_update` from the stored
-     * version (when the app passes `appVersion` and `storage`), then `app_open` with `coldStart: true`.
+     * version (when the app version is known and the app passes `storage`), then `app_open` with `coldStart: true`.
      */
     private checkLaunch;
     private wentToBackground;
@@ -1063,6 +1072,33 @@ declare class GuidelyClient {
     private log;
 }
 
+/**
+ * Host app and OS versions, read from native modules the app already links (never imported, so none
+ * of them is a dependency): `@guidelytech/react-native-replay`, `expo-application`, then
+ * `react-native-device-info`. React Native itself has no API for the app's own version.
+ */
+interface AppVersionInfo {
+    /** `CFBundleShortVersionString` / `versionName`. */
+    appVersion?: string;
+    /** `CFBundleVersion` / `versionCode`. */
+    appBuild?: string;
+}
+/** Where the lookups read from; the provider passes React Native's objects, tests pass fakes. */
+interface NativeSources {
+    platform: {
+        OS: string;
+        Version?: string | number;
+        constants?: Record<string, unknown>;
+    };
+    nativeModules: Record<string, unknown>;
+    /** `globalThis.expo.modules` in Expo SDK 50+ apps. */
+    expoModules?: Record<string, unknown>;
+}
+/** The host app's version and build, or `{}` when no linked module knows them. */
+declare function detectAppVersion(src: NativeSources): AppVersionInfo;
+/** The OS version: `18.1` on iOS, `14` on Android (falling back to the API level). */
+declare function detectOsVersion(src: NativeSources): string | undefined;
+
 /**
  * Declares which screen its children are on, so targets on screens that are mounted but not
  * visible (inactive tabs, screens under a stack) are never used. `name` must match what you pass
@@ -1281,4 +1317,4 @@ declare function useGuideState(idOrKey: string): {
 /** The guide currently running exclusively (flow, modal, survey…), or null. */
 declare function useActiveGuide(): PublishedGuide | null;
 
-export { type AutocaptureOption, type ChecklistView, DEFAULT_API_URL, type DeviceEnvironment, Feature, FeatureFlag, type FeatureProps, FeatureValue, type FeatureValueProps, FlagsProvider, type FlagsProviderProps, type GuideStepInfo, GuidelyClient, type GuidelyEventName, type GuidelyEvents, GuidelyMask, type GuidelyMaskProps, type GuidelyOptions, GuidelyOverlay, GuidelyProvider, type GuidelyProviderProps, GuidelyScreenScope, type GuidelyStorage, GuidelyTarget, type GuidelyTargetProps, HeatmapBuffer, type Insets, Messenger, type MessengerSnapshot, type MessengerTab, type MessengerThread, type MessengerView, type PlatformBridge, RageClickDetector, type ReplayCaptureOptions, type ReplayFrame, ReplayUploader, RrwebEvents, SDK_NAME, SDK_VERSION, type ScreenCapturer, SessionRecorder, type SessionReplayOptions, type StepView, type SurveyView, type TapElement, type TapInfo, type TapProperties, TapTracker, TargetRegistry, type TouchPhase, type UiState, createSseParser, guidelyScreenLayout, htmlToText, noopClient, parseHtml, positionCard, targetIdsFor, useActiveGuide, useChecklistProgress, useFeatureValue, useFlag, useFlagDetails, useFlags, useFlagsClient, useFlagsReady, useGuideState, useGuidely, useGuidelyEvent, useGuidelyIdentify, useGuidelyNavigation, useGuidelyReady, useGuidelyScreen, useGuidelyTarget };
+export { type AppVersionInfo, type AutocaptureOption, type ChecklistView, DEFAULT_API_URL, type DeviceEnvironment, Feature, FeatureFlag, type FeatureProps, FeatureValue, type FeatureValueProps, FlagsProvider, type FlagsProviderProps, type GuideStepInfo, GuidelyClient, type GuidelyEventName, type GuidelyEvents, GuidelyMask, type GuidelyMaskProps, type GuidelyOptions, GuidelyOverlay, GuidelyProvider, type GuidelyProviderProps, GuidelyScreenScope, type GuidelyStorage, GuidelyTarget, type GuidelyTargetProps, HeatmapBuffer, type Insets, Messenger, type MessengerSnapshot, type MessengerTab, type MessengerThread, type MessengerView, type NativeSources, type PlatformBridge, RageClickDetector, type ReplayCaptureOptions, type ReplayFrame, ReplayUploader, RrwebEvents, SDK_NAME, SDK_VERSION, type ScreenCapturer, SessionRecorder, type SessionReplayOptions, type StepView, type SurveyView, type TapElement, type TapInfo, type TapProperties, TapTracker, TargetRegistry, type TouchPhase, type UiState, createSseParser, detectAppVersion, detectOsVersion, guidelyScreenLayout, htmlToText, noopClient, parseHtml, positionCard, targetIdsFor, useActiveGuide, useChecklistProgress, useFeatureValue, useFlag, useFlagDetails, useFlags, useFlagsClient, useFlagsReady, useGuideState, useGuidely, useGuidelyEvent, useGuidelyIdentify, useGuidelyNavigation, useGuidelyReady, useGuidelyScreen, useGuidelyTarget };

package/dist/index.js

@@ -1378,14 +1378,14 @@ function quoteValue(value) {
 function attrSelector(name, value) {
   return `[${name}=${quoteValue(value)}]`.slice(0, 300);
 }
-function cleanText(text) {
-  const t = (text ?? "").replace(/\s+/g, " ").trim();
+function cleanText(text2) {
+  const t = (text2 ?? "").replace(/\s+/g, " ").trim();
   return t ? t.slice(0, 100) : void 0;
 }
 function tapProperties(el, x, y, platform, maskAll) {
   const props = { selector: el.selector.slice(0, 300), tag: el.tag || "View", x: Math.round(x) || 0, y: Math.round(y) || 0, platform };
-  const text = maskAll ? void 0 : cleanText(el.text);
-  if (text) props.text = text;
+  const text2 = maskAll ? void 0 : cleanText(el.text);
+  if (text2) props.text = text2;
   return props;
 }
 var r2 = (n) => Math.round(Math.min(1, Math.max(0, n)) * 100) / 100;
@@ -2006,10 +2006,10 @@ function xhrStreamPost() {
       const type = xhr.getResponseHeader("content-type") || "";
       if (!type.includes("text/event-stream")) return;
       streamed = true;
-      const text = xhr.responseText || "";
-      if (text.length > seen) {
-        onChunk(text.slice(seen));
-        seen = text.length;
+      const text2 = xhr.responseText || "";
+      if (text2.length > seen) {
+        onChunk(text2.slice(seen));
+        seen = text2.length;
       }
     };
     xhr.open("POST", url);
@@ -2084,14 +2084,14 @@ function fetchStreamPost(fetchImpl) {
         if (rest) onChunk(rest);
         return { status: res.status, json: null, streamed: true };
       }
-      const text = await race(res.text());
+      const text2 = await race(res.text());
       if (sse) {
-        onChunk(text);
+        onChunk(text2);
         return { status: res.status, json: null, streamed: true };
       }
       let json = null;
       try {
-        json = JSON.parse(text || "null");
+        json = JSON.parse(text2 || "null");
       } catch {
         json = null;
       }
@@ -2204,10 +2204,10 @@ var Messenger = class {
     if (v.kind === "tab" && v.tab === "messages") void this.refreshConversations();
   }
   /** Opens a new thread (optionally pre-filling the composer). */
-  showNewMessage(text = "") {
+  showNewMessage(text2 = "") {
     this.stopThreadPolling();
     if (!this.snapshot.open) this.deps.onOpen();
-    this.set({ open: true, view: { kind: "thread", conversationId: null }, thread: { conversation: null, messages: [], streaming: {}, sending: false, error: null, draft: text } });
+    this.set({ open: true, view: { kind: "thread", conversationId: null }, thread: { conversation: null, messages: [], streaming: {}, sending: false, error: null, draft: text2 } });
   }
   async openConversation(id) {
     const known = this.snapshot.conversations.find((c) => c.id === id) ?? null;
@@ -2251,8 +2251,8 @@ var Messenger = class {
     }
   }
   /** Sends the composer text: starts a conversation or posts to the open one. Streams Scout's reply. */
-  async send(text) {
-    const body = text.trim().slice(0, 4e3);
+  async send(text2) {
+    const body = text2.trim().slice(0, 4e3);
     const thread = this.snapshot.thread;
     if (!body || !thread || thread.sending) return;
     this.setThread({ sending: true, error: null, draft: "" });
@@ -2900,7 +2900,7 @@ var PersistentStore = class {
 
 // src/core/client.ts
 var SDK_NAME = "@guidelytech/react-native";
-var SDK_VERSION = "0.13.0";
+var SDK_VERSION = "0.15.0";
 var DEFAULT_API_URL = "https://guidelytech.com";
 var PAGE_SCOPED = /* @__PURE__ */ new Set(["page_load", "url_match", "element_click", "element_visible", "delay"]);
 var CACHED_START_MS = 1500;
@@ -3544,7 +3544,7 @@ var GuidelyClient = class {
     const opts = this.options.sessionReplay ?? {};
     const ids = new Set((r?.blockSelectors ?? []).map((sel) => guidelyIdFromSelector(sel)).filter((id) => !!id));
     const rects = await Promise.all(Array.from(ids, (id) => this.targets.measure(id)));
-    return { maskAllText: !!opts.maskAllText || !!r?.maskAllText, maskAllImages: !!opts.maskAllImages, blockRects: rects.filter((rect) => !!rect) };
+    return { maskAllText: !!opts.maskAllText || !!r?.maskAllText, maskAllImages: !!opts.maskAllImages || !!r?.maskAllImages, blockRects: rects.filter((rect) => !!rect) };
   }
   /**
    * Records this session even when it was not sampled (still needs `sessionReplay.enabled`, replay
@@ -3672,12 +3672,12 @@ var GuidelyClient = class {
   /** `{ appVersion, build }` of this launch, without unknown keys. */
   appInfo() {
     const appVersion = this.options.appVersion ?? this.bridge.device.appVersion;
-    const build = this.options.appBuild;
+    const build = this.options.appBuild ?? (this.options.appVersion ? void 0 : this.bridge.device.appBuild);
     return { ...appVersion ? { appVersion: String(appVersion) } : {}, ...build ? { build: String(build) } : {} };
   }
   /**
    * Once per launch, as soon as a config is known: `app_install` / `app_update` from the stored
-   * version (when the app passes `appVersion` and `storage`), then `app_open` with `coldStart: true`.
+   * version (when the app version is known and the app passes `storage`), then `app_open` with `coldStart: true`.
    */
   checkLaunch() {
     if (this.launchChecked || !this.config || this.destroyed || !this.hydrated) return;
@@ -4494,8 +4494,8 @@ var GuidelyClient = class {
     this.messenger?.close();
   }
   /** Opens a new messenger conversation, optionally pre-filling the message. */
-  showNewMessage(text) {
-    this.whenHydrated(() => this.messenger?.showNewMessage(text));
+  showNewMessage(text2) {
+    this.whenHydrated(() => this.messenger?.showNewMessage(text2));
   }
   // ---------------------------------------------------------------------------
   // Feature flags
@@ -4519,7 +4519,7 @@ var GuidelyClient = class {
   /** Device facts on every screen view, read by the Pages devices / browsers breakdowns. */
   deviceProperties() {
     const d = this.bridge.device;
-    return { platform: d.platform, deviceType: d.deviceType, os: d.platform };
+    return { platform: d.platform, deviceType: d.deviceType, os: d.platform, ...d.osVersion ? { osVersion: d.osVersion } : {} };
   }
   /** Attributes flags are evaluated with: identity, traits, account, audiences, screen and device. */
   flagContext() {
@@ -4530,6 +4530,7 @@ var GuidelyClient = class {
       deviceType: d.deviceType,
       locale: d.locale,
       appVersion: this.options.appVersion ?? d.appVersion,
+      osVersion: d.osVersion,
       environment: this.options.environment,
       ...this.screenName ? { screen: this.screenName, path: this.currentUrl() } : {},
       ...this.user?.traits ?? {},
@@ -4620,6 +4621,51 @@ function withoutCode(guide) {
   return { ...guide, config: { ...guide.config, steps: guide.config.steps.map(({ code: _code, ...step }) => step) } };
 }
 
+// src/core/device.ts
+function text(value) {
+  if (typeof value === "number" && Number.isFinite(value)) return String(value);
+  if (typeof value !== "string") return void 0;
+  const v = value.trim();
+  return v ? v.slice(0, 64) : void 0;
+}
+function constant(mod, key) {
+  if (!mod || typeof mod !== "object" && typeof mod !== "function") return void 0;
+  const m = mod;
+  try {
+    const fromGetter = typeof m.getConstants === "function" ? m.getConstants()?.[key] : void 0;
+    return fromGetter ?? m[key];
+  } catch {
+    return void 0;
+  }
+}
+function read(mod, versionKey, buildKey) {
+  const appVersion = text(constant(mod, versionKey));
+  if (!appVersion) return null;
+  const appBuild = text(constant(mod, buildKey));
+  return { appVersion, ...appBuild ? { appBuild } : {} };
+}
+function inExpoGo(src) {
+  const c = src.expoModules?.ExponentConstants ?? src.nativeModules.ExponentConstants;
+  return constant(c, "executionEnvironment") === "storeClient" || constant(c, "appOwnership") === "expo";
+}
+function detectAppVersion(src) {
+  try {
+    const expo = inExpoGo(src) ? null : src.expoModules?.ExpoApplication ?? src.nativeModules.ExpoApplication;
+    return read(src.nativeModules.GuidelyReplay, "appVersion", "appBuild") ?? read(expo, "nativeApplicationVersion", "nativeBuildVersion") ?? read(src.nativeModules.RNDeviceInfo, "appVersion", "buildNumber") ?? {};
+  } catch {
+    return {};
+  }
+}
+function detectOsVersion(src) {
+  try {
+    const c = src.platform.constants ?? {};
+    if (src.platform.OS === "android") return text(c.Release) ?? text(src.platform.Version);
+    return text(c.osVersion) ?? text(src.platform.Version);
+  } catch {
+    return void 0;
+  }
+}
+
 // src/ui/Autocapture.tsx
 import { useMemo as useMemo5, useRef as useRef5 } from "react";
 import { View as View10 } from "react-native";
@@ -4751,8 +4797,8 @@ function describe(f, masked, opts, withText) {
     if (!sub.masked) {
       const hostProps = host?.memoizedProps && typeof host.memoizedProps === "object" ? host.memoizedProps : {};
       const label = props.accessibilityLabel ?? props["aria-label"] ?? hostProps.accessibilityLabel ?? hostProps["aria-label"];
-      const text = cleanText(sub.text) ?? (typeof label === "string" ? cleanText(label) : void 0);
-      if (text) el.text = text;
+      const text2 = cleanText(sub.text) ?? (typeof label === "string" ? cleanText(label) : void 0);
+      if (text2) el.text = text2;
     }
   }
   if (host) el.measure = () => measureHost(host);
@@ -4908,17 +4954,17 @@ function parseHtml(html) {
     flush();
     current = { kind, level, marker, runs: [] };
   };
-  const push = (text) => {
-    if (!text) return;
+  const push = (text2) => {
+    if (!text2) return;
     if (!current) current = { kind: "paragraph", level: 1, runs: [] };
-    const run = { text };
+    const run = { text: text2 };
     if (style.bold) run.bold = true;
     if (style.italic) run.italic = true;
     if (style.underline) run.underline = true;
     if (style.code) run.code = true;
     if (hrefs.length) run.href = hrefs[hrefs.length - 1];
     const last = current.runs[current.runs.length - 1];
-    if (last && last.bold === run.bold && last.italic === run.italic && last.underline === run.underline && last.code === run.code && last.href === run.href) last.text += text;
+    if (last && last.bold === run.bold && last.italic === run.italic && last.underline === run.underline && last.code === run.code && last.href === run.href) last.text += text2;
     else current.runs.push(run);
   };
   const size = (attrs, name) => {
@@ -4934,18 +4980,18 @@ function parseHtml(html) {
   const re = /<!--[\s\S]*?-->|<\/?([a-zA-Z][a-zA-Z0-9]*)\b([^>]*)>|([^<]+|<)/g;
   let m;
   while (m = re.exec(html || "")) {
-    const [token, rawTag, attrs = "", text] = m;
-    if (text !== void 0) {
+    const [token, rawTag, attrs = "", text2] = m;
+    if (text2 !== void 0) {
       if (skipping) continue;
       if (pdf) {
-        if (pdf.inLink) pdf.name += decodeEntities(text);
+        if (pdf.inLink) pdf.name += decodeEntities(text2);
         continue;
       }
       if (fileLink) {
-        fileLink.name += decodeEntities(text);
+        fileLink.name += decodeEntities(text2);
         continue;
       }
-      push(decodeEntities(text.replace(/\s+/g, " ")));
+      push(decodeEntities(text2.replace(/\s+/g, " ")));
       continue;
     }
     if (!rawTag) continue;
@@ -5519,13 +5565,13 @@ function Conversations({ store, palette: p }) {
     /* @__PURE__ */ jsx5(GButton, { label: "New conversation", palette: p, onPress: () => store.showNewMessage(), style: styles4.fullWidth })
   ] });
 }
-function Bubble({ m, text, name, palette: p, onArticle, onGuide }) {
+function Bubble({ m, text: text2, name, palette: p, onArticle, onGuide }) {
   if (m.author === "system")
-    return /* @__PURE__ */ jsx5(Text4, { accessibilityRole: "text", style: [styles4.system, { color: p.muted }], children: text });
+    return /* @__PURE__ */ jsx5(Text4, { accessibilityRole: "text", style: [styles4.system, { color: p.muted }], children: text2 });
   const mine = m.author === "user";
   return /* @__PURE__ */ jsxs3(View4, { style: [styles4.bubbleWrap, mine ? styles4.mine : styles4.theirs], children: [
     !mine ? /* @__PURE__ */ jsx5(Text4, { style: [styles4.author, { color: p.muted }], children: m.author === "agent" ? m.authorName || "Team" : name }) : null,
-    /* @__PURE__ */ jsx5(View4, { style: [styles4.bubble, { borderRadius: Math.max(12, p.radius) }, mine ? { backgroundColor: p.primary } : { backgroundColor: p.surface }], children: m.status === "pending" && !text ? /* @__PURE__ */ jsx5(TypingDots, { color: p.muted }) : /* @__PURE__ */ jsx5(Text4, { style: [styles4.bubbleText, { color: mine ? p.onPrimary : p.text }], children: text }) }),
+    /* @__PURE__ */ jsx5(View4, { style: [styles4.bubble, { borderRadius: Math.max(12, p.radius) }, mine ? { backgroundColor: p.primary } : { backgroundColor: p.surface }], children: m.status === "pending" && !text2 ? /* @__PURE__ */ jsx5(TypingDots, { color: p.muted }) : /* @__PURE__ */ jsx5(Text4, { style: [styles4.bubbleText, { color: mine ? p.onPrimary : p.text }], children: text2 }) }),
     m.citations.length || m.suggestedGuides.length ? /* @__PURE__ */ jsxs3(View4, { style: styles4.chips, children: [
       m.citations.map((c) => /* @__PURE__ */ jsx5(Pressable4, { accessibilityRole: "link", accessibilityLabel: `Article: ${c.title}`, onPress: () => onArticle(c.articleId), style: [styles4.chip, { borderColor: p.border }], children: /* @__PURE__ */ jsxs3(Text4, { style: [styles4.chipText, { color: p.text }], children: [
         "\u{1F4C4} ",
@@ -5544,7 +5590,7 @@ function TypingDots({ color }) {
 function Thread({ store, palette: p, bottomInset }) {
   const snap = useMessenger(store);
   const t = snap.thread;
-  const [text, setText] = useState3(t?.draft ?? "");
+  const [text2, setText] = useState3(t?.draft ?? "");
   const scroll = useRef2(null);
   const convo = t?.conversation ?? null;
   useEffect3(() => {
@@ -5553,7 +5599,7 @@ function Thread({ store, palette: p, bottomInset }) {
   const streamingIds = useMemo3(() => Object.keys(t?.streaming ?? {}).filter((id) => !t?.messages.some((m) => m.id === id)), [t]);
   if (!t) return null;
   const send = () => {
-    const value = text;
+    const value = text2;
     setText("");
     void store.send(value);
   };
@@ -5575,7 +5621,7 @@ function Thread({ store, palette: p, bottomInset }) {
       /* @__PURE__ */ jsx5(
         TextInput,
         {
-          value: text,
+          value: text2,
           onChangeText: (v) => setText(v.slice(0, 4e3)),
           placeholder: convo ? "Reply\u2026" : "Write a message\u2026",
           placeholderTextColor: p.muted,
@@ -5584,7 +5630,7 @@ function Thread({ store, palette: p, bottomInset }) {
           style: [styles4.input, { color: p.text, backgroundColor: p.surface, borderRadius: Math.min(18, p.radius + 6) }]
         }
       ),
-      /* @__PURE__ */ jsx5(GButton, { label: "Send", palette: p, onPress: send, disabled: !text.trim() || t.sending })
+      /* @__PURE__ */ jsx5(GButton, { label: "Send", palette: p, onPress: send, disabled: !text2.trim() || t.sending })
     ] })
   ] });
 }
@@ -6498,15 +6544,15 @@ function palette(theme, systemScheme, explicit) {
   const wantsDark = theme.dark === "dark" || theme.dark === "auto" && systemScheme === "dark";
   const dark = wantsDark && !explicit?.backgroundColor;
   const background = dark ? DARK.background : theme.backgroundColor ?? "#ffffff";
-  const text = dark ? DARK.text : theme.textColor ?? "#111827";
+  const text2 = dark ? DARK.text : theme.textColor ?? "#111827";
   return {
     primary,
     onPrimary: luminance(primary) > 0.45 ? "#111827" : "#ffffff",
     background,
-    text,
-    muted: dark ? DARK.muted : mix(text, 0.65),
-    border: dark ? DARK.border : mix(text, 0.12),
-    surface: dark ? DARK.surface : mix(text, 0.05),
+    text: text2,
+    muted: dark ? DARK.muted : mix(text2, 0.65),
+    border: dark ? DARK.border : mix(text2, 0.12),
+    surface: dark ? DARK.surface : mix(text2, 0.05),
     radius: theme.borderRadius ?? 12,
     overlay: `rgba(15, 23, 42, ${theme.overlayOpacity ?? 0.55})`,
     fontFamily: nativeFont(theme.fontFamily)
@@ -6733,14 +6779,25 @@ function deviceLocale() {
     return void 0;
   }
 }
-function defaultBridge(appVersion) {
+function nativeSources() {
+  return {
+    platform: Platform6,
+    nativeModules: NativeModules,
+    expoModules: globalThis.expo?.modules
+  };
+}
+function defaultBridge(appVersion, appBuild) {
   const { width, height } = Dimensions.get("window");
+  const sources = nativeSources();
+  const detected = appVersion ? {} : detectAppVersion(sources);
   return {
     device: {
       platform: Platform6.OS === "android" ? "android" : "ios",
       deviceType: Platform6.OS === "ios" && Platform6.isPad || Math.min(width, height) >= 600 ? "tablet" : "mobile",
       locale: deviceLocale(),
-      appVersion
+      appVersion: appVersion ?? detected.appVersion,
+      appBuild: appBuild ?? detected.appBuild,
+      osVersion: detectOsVersion(sources)
     },
     openExternal: (url) => void Linking.openURL(url).catch(() => {
     }),
@@ -6785,7 +6842,7 @@ function GuidelyProvider({ children, user, insets, launcherOffset = 72, flagsPay
           onNavigate: (url) => optionsRef.current.onNavigate?.(url),
           onError: (err) => optionsRef.current.onError?.(err)
         },
-        defaultBridge(latest.appVersion)
+        defaultBridge(latest.appVersion, latest.appBuild)
       );
     } catch (err) {
       optionsRef.current.onError?.(err instanceof Error ? err : new Error(String(err)));
@@ -6987,6 +7044,8 @@ export {
   TargetRegistry,
   createFlagsClient3 as createFlagsClient,
   createSseParser,
+  detectAppVersion,
+  detectOsVersion,
   guidelyScreenLayout,
   htmlToText,
   noopClient,