@appilots/sdk 0.8.0 → 0.11.0

package/dist/index.js

@@ -1,8 +1,8 @@
 'use strict';
 
-var chunkH7BMQTXH_js = require('./chunk-H7BMQTXH.js');
-var chunkN7EAOLBP_js = require('./chunk-N7EAOLBP.js');
-var chunkAYWMBMSN_js = require('./chunk-AYWMBMSN.js');
+var chunkIZEWWAA7_js = require('./chunk-IZEWWAA7.js');
+var chunk2YPEQTL2_js = require('./chunk-2YPEQTL2.js');
+var chunk55Y2AQE7_js = require('./chunk-55Y2AQE7.js');
 var React7 = require('react');
 var reactNative = require('react-native');
 var reactNativeSafeAreaContext = require('react-native-safe-area-context');
@@ -31,16 +31,30 @@ function _interopNamespace(e) {
 var React7__namespace = /*#__PURE__*/_interopNamespace(React7);
 var Svg__default = /*#__PURE__*/_interopDefault(Svg);
 
+var NO_INSETS = { top: 0, right: 0, bottom: 0, left: 0 };
+var _warned = false;
+function useSafeAreaInsetsOrDefault() {
+  const insets = React7.useContext(reactNativeSafeAreaContext.SafeAreaInsetsContext);
+  if (insets) return insets;
+  if (!_warned) {
+    _warned = true;
+    console.warn(
+      "[Appilots] <AppilotsChat> found no <SafeAreaProvider> above it, so it is laying out with zero safe-area insets and may sit under the notch or the home indicator. Render <SafeAreaProvider> (from react-native-safe-area-context) at the root of your app, ABOVE <AppilotsProvider> \u2014 a provider nested inside your navigator does not cover a chat rendered as its sibling."
+    );
+  }
+  return NO_INSETS;
+}
+
 // src/components/breadcrumbPresentation.ts
 var DEFAULT_BREADCRUMB_PALETTE = {
-  primary: chunkAYWMBMSN_js.defaultLightTheme.colors.primary,
-  text: chunkAYWMBMSN_js.defaultLightTheme.colors.text,
-  textSecondary: chunkAYWMBMSN_js.defaultLightTheme.colors.textSecondary,
-  surface: chunkAYWMBMSN_js.defaultLightTheme.colors.surface,
-  border: chunkAYWMBMSN_js.defaultLightTheme.colors.border,
-  success: chunkAYWMBMSN_js.defaultLightTheme.colors.success,
-  warning: chunkAYWMBMSN_js.defaultLightTheme.colors.warning,
-  error: chunkAYWMBMSN_js.defaultLightTheme.colors.error
+  primary: chunk55Y2AQE7_js.defaultLightTheme.colors.primary,
+  text: chunk55Y2AQE7_js.defaultLightTheme.colors.text,
+  textSecondary: chunk55Y2AQE7_js.defaultLightTheme.colors.textSecondary,
+  surface: chunk55Y2AQE7_js.defaultLightTheme.colors.surface,
+  border: chunk55Y2AQE7_js.defaultLightTheme.colors.border,
+  success: chunk55Y2AQE7_js.defaultLightTheme.colors.success,
+  warning: chunk55Y2AQE7_js.defaultLightTheme.colors.warning,
+  error: chunk55Y2AQE7_js.defaultLightTheme.colors.error
 };
 var KNOWN_TINTS = {
   [DEFAULT_BREADCRUMB_PALETTE.primary.toUpperCase()]: "#EEF2FF",
@@ -80,13 +94,24 @@ function isDestructiveAction(action) {
   return action.payload?.destructive === true || action.destructive === true;
 }
 DEFAULT_BREADCRUMB_PALETTE.error;
-function deriveConfirmCardContent(action, palette = DEFAULT_BREADCRUMB_PALETTE) {
+var PT_BR_CONFIRM_FALLBACK = {
+  confirmDestructiveTitle: "A\xE7\xE3o destrutiva",
+  confirmTitle: "Confirma\xE7\xE3o necess\xE1ria",
+  confirmMessage: 'Tem certeza que deseja "{action}"?',
+  confirmDestructiveApprove: "Sim, executar",
+  confirmApprove: "Confirmar",
+  confirmCancel: "Cancelar",
+  confirmThisAction: "esta a\xE7\xE3o"
+};
+function deriveConfirmCardContent(action, palette = DEFAULT_BREADCRUMB_PALETTE, strings) {
   const payload = action.payload ?? {};
   const isDestructive = isDestructiveAction(action);
-  const message = typeof payload.message === "string" && payload.message || typeof payload.actionDescription === "string" && payload.actionDescription || "Confirme para prosseguir";
-  const title = typeof payload.title === "string" && payload.title || (isDestructive ? "A\xE7\xE3o destrutiva" : "Confirma\xE7\xE3o necess\xE1ria");
-  const confirmLabel = typeof payload.confirmLabel === "string" && payload.confirmLabel || (isDestructive ? "Sim, executar" : "Confirmar");
-  const cancelLabel = typeof payload.cancelLabel === "string" && payload.cancelLabel || "Cancelar";
+  const copy = { ...PT_BR_CONFIRM_FALLBACK, ...strings ?? {} };
+  const actionName = typeof payload.actionDescription === "string" && payload.actionDescription || copy.confirmThisAction;
+  const message = typeof payload.message === "string" && payload.message || copy.confirmMessage.replace("{action}", actionName);
+  const title = typeof payload.title === "string" && payload.title || (isDestructive ? copy.confirmDestructiveTitle : copy.confirmTitle);
+  const confirmLabel = typeof payload.confirmLabel === "string" && payload.confirmLabel || (isDestructive ? copy.confirmDestructiveApprove : copy.confirmApprove);
+  const cancelLabel = typeof payload.cancelLabel === "string" && payload.cancelLabel || copy.confirmCancel;
   return {
     isDestructive,
     title,
@@ -110,6 +135,7 @@ function ActionBreadcrumb({
   textColor,
   fontFamily,
   palette,
+  confirmStrings,
   requireApprovalFor,
   onApprove,
   onReject
@@ -130,6 +156,7 @@ function ActionBreadcrumb({
       textColor,
       fontFamily,
       palette: resolvedPalette,
+      confirmStrings,
       needsApproval: requireApprovalFor?.(action) ?? false,
       onApprove,
       onReject
@@ -145,6 +172,7 @@ function BreadcrumbRow(props) {
         action,
         palette: props.palette,
         fontFamily: props.fontFamily,
+        confirmStrings: props.confirmStrings,
         onApprove: props.onApprove,
         onReject: props.onReject
       }
@@ -162,7 +190,7 @@ function RegularBreadcrumbRow({
   onApprove,
   onReject
 }) {
-  const { label, state } = chunkAYWMBMSN_js.describeAction(action);
+  const { label, state } = chunk55Y2AQE7_js.describeAction(action);
   const tone = deriveStateTone(palette)[state];
   const fade = React7.useRef(new reactNative.Animated.Value(0)).current;
   const pulse = React7.useRef(new reactNative.Animated.Value(1)).current;
@@ -185,25 +213,26 @@ function RegularBreadcrumbRow({
     }).start();
   }, [state, pulse]);
   const isDestructive = isDestructiveAction(action);
-  return /* @__PURE__ */ React7__namespace.default.createElement(reactNative.Animated.View, { style: [styles.row, { opacity: fade }] }, /* @__PURE__ */ React7__namespace.default.createElement(reactNative.Animated.View, { style: { opacity: pulse, flexDirection: "row", alignItems: "flex-start", flex: 1 } }, /* @__PURE__ */ React7__namespace.default.createElement(StateIcon, { state, tone, primaryColor }), /* @__PURE__ */ React7__namespace.default.createElement(
-    reactNative.Text,
+  return /* @__PURE__ */ React7__namespace.default.createElement(reactNative.Animated.View, { style: [styles.row, { opacity: fade }] }, /* @__PURE__ */ React7__namespace.default.createElement(
+    reactNative.Animated.View,
     {
-      style: [
-        styles.label,
-        { color: state === "failed" ? tone.color : textColor, fontFamily }
-      ],
-      accessibilityLabel: `${state}: ${label}`
+      style: { opacity: pulse, flexDirection: "row", alignItems: "flex-start", flex: 1 }
     },
-    label,
-    isDestructive && /* @__PURE__ */ React7__namespace.default.createElement(reactNative.Text, { style: [styles.destructiveTag, { color: palette.error }] }, " \u26A0 destrutiva")
-  )), needsApproval && action.status === "pending" && onApprove && onReject && /* @__PURE__ */ React7__namespace.default.createElement(reactNative.View, { style: styles.approvalButtons }, /* @__PURE__ */ React7__namespace.default.createElement(
+    /* @__PURE__ */ React7__namespace.default.createElement(StateIcon, { state, tone, primaryColor }),
+    /* @__PURE__ */ React7__namespace.default.createElement(
+      reactNative.Text,
+      {
+        style: [styles.label, { color: state === "failed" ? tone.color : textColor, fontFamily }],
+        accessibilityLabel: `${state}: ${label}`
+      },
+      label,
+      isDestructive && /* @__PURE__ */ React7__namespace.default.createElement(reactNative.Text, { style: [styles.destructiveTag, { color: palette.error }] }, " \u26A0 destrutiva")
+    )
+  ), needsApproval && action.status === "pending" && onApprove && onReject && /* @__PURE__ */ React7__namespace.default.createElement(reactNative.View, { style: styles.approvalButtons }, /* @__PURE__ */ React7__namespace.default.createElement(
     reactNative.TouchableOpacity,
     {
       onPress: () => onReject(action.id),
-      style: [
-        styles.btn,
-        { backgroundColor: deriveStateTone(palette).failed.iconBg }
-      ],
+      style: [styles.btn, { backgroundColor: deriveStateTone(palette).failed.iconBg }],
       activeOpacity: 0.7,
       accessibilityLabel: "Rejeitar a\xE7\xE3o"
     },
@@ -219,7 +248,14 @@ function RegularBreadcrumbRow({
     /* @__PURE__ */ React7__namespace.default.createElement(reactNative.Text, { style: styles.approveBtnText }, "Aprovar")
   )));
 }
-function ConfirmCard({ action, palette, fontFamily, onApprove, onReject }) {
+function ConfirmCard({
+  action,
+  palette,
+  fontFamily,
+  confirmStrings,
+  onApprove,
+  onReject
+}) {
   const {
     isDestructive,
     title,
@@ -233,7 +269,7 @@ function ConfirmCard({ action, palette, fontFamily, onApprove, onReject }) {
     messageColor,
     cancelBackground,
     cancelTextColor
-  } = deriveConfirmCardContent(action, palette);
+  } = deriveConfirmCardContent(action, palette, confirmStrings);
   return /* @__PURE__ */ React7__namespace.default.createElement(
     reactNative.View,
     {
@@ -862,7 +898,7 @@ var styles2 = reactNative.StyleSheet.create({
     textDecorationLine: "underline"
   }
 });
-var ThemeContext = React7.createContext(chunkAYWMBMSN_js.defaultLightTheme);
+var ThemeContext = React7.createContext(chunk55Y2AQE7_js.defaultLightTheme);
 function AppilotsThemeProvider({
   theme,
   mode = "auto",
@@ -870,7 +906,7 @@ function AppilotsThemeProvider({
 }) {
   const systemScheme = reactNative.useColorScheme();
   const tokens = React7.useMemo(
-    () => chunkAYWMBMSN_js.mergeThemeTokens(chunkAYWMBMSN_js.resolveBaseTheme(mode, systemScheme), theme ?? void 0),
+    () => chunk55Y2AQE7_js.mergeThemeTokens(chunk55Y2AQE7_js.resolveBaseTheme(mode, systemScheme), theme ?? void 0),
     [mode, systemScheme, theme]
   );
   return /* @__PURE__ */ React7__namespace.default.createElement(ThemeContext.Provider, { value: tokens }, children);
@@ -981,6 +1017,13 @@ var ptBR = {
   approve: "Aprovar",
   reject: "Rejeitar",
   cancelledByUser: "Cancelado pelo usu\xE1rio",
+  confirmDestructiveTitle: "A\xE7\xE3o destrutiva",
+  confirmTitle: "Confirma\xE7\xE3o necess\xE1ria",
+  confirmMessage: 'Tem certeza que deseja "{action}"?',
+  confirmDestructiveApprove: "Sim, executar",
+  confirmApprove: "Confirmar",
+  confirmCancel: "Cancelar",
+  confirmThisAction: "esta a\xE7\xE3o",
   unknownAction: "A\xE7\xE3o desconhecida",
   somethingWentWrong: "Algo deu errado",
   openChatA11y: "Abrir chat do assistente",
@@ -1012,6 +1055,13 @@ var en = {
   approve: "Approve",
   reject: "Reject",
   cancelledByUser: "Cancelled by user",
+  confirmDestructiveTitle: "Destructive action",
+  confirmTitle: "Confirmation needed",
+  confirmMessage: 'Are you sure you want to "{action}"?',
+  confirmDestructiveApprove: "Yes, do it",
+  confirmApprove: "Confirm",
+  confirmCancel: "Cancel",
+  confirmThisAction: "this action",
   unknownAction: "Unknown action",
   somethingWentWrong: "Something went wrong",
   openChatA11y: "Open assistant chat",
@@ -1043,6 +1093,13 @@ var es = {
   approve: "Aprobar",
   reject: "Rechazar",
   cancelledByUser: "Cancelado por el usuario",
+  confirmDestructiveTitle: "Acci\xF3n destructiva",
+  confirmTitle: "Confirmaci\xF3n necesaria",
+  confirmMessage: '\xBFSeguro que quieres "{action}"?',
+  confirmDestructiveApprove: "S\xED, ejecutar",
+  confirmApprove: "Confirmar",
+  confirmCancel: "Cancelar",
+  confirmThisAction: "esta acci\xF3n",
   unknownAction: "Acci\xF3n desconocida",
   somethingWentWrong: "Algo sali\xF3 mal",
   openChatA11y: "Abrir chat del asistente",
@@ -1151,12 +1208,12 @@ var APPILOTS_SKIP_PROPS = {
   __appilotsInternal: true
 };
 function AppilotsChat(props) {
-  const { degraded } = chunkAYWMBMSN_js.useAppilotsContext();
+  const { degraded } = chunk55Y2AQE7_js.useAppilotsContext();
   if (degraded) return null;
-  return /* @__PURE__ */ React7__namespace.default.createElement(chunkAYWMBMSN_js.AppilotsErrorBoundary, { surface: "chat", fallback: null }, /* @__PURE__ */ React7__namespace.default.createElement(AppilotsChatSurface, { ...props }));
+  return /* @__PURE__ */ React7__namespace.default.createElement(chunk55Y2AQE7_js.AppilotsErrorBoundary, { surface: "chat", fallback: null }, /* @__PURE__ */ React7__namespace.default.createElement(AppilotsChatSurface, { ...props }));
 }
 function AppilotsChatSurface(props) {
-  const { remotePersonalization } = chunkAYWMBMSN_js.useAppilotsContext();
+  const { remotePersonalization } = chunk55Y2AQE7_js.useAppilotsContext();
   const themeProp = React7.useMemo(() => {
     if (!props.theme) return void 0;
     return isLegacyTheme(props.theme) ? translateLegacyTheme(props.theme) : props.theme;
@@ -1199,7 +1256,7 @@ function AppilotsChatInner({
     clearMessages,
     escalation,
     requestHuman
-  } = chunkN7EAOLBP_js.useAppilotsChat({
+  } = chunk2YPEQTL2_js.useAppilotsChat({
     errorPrefix: t("somethingWentWrong"),
     escalationStrings: {
       requested: t("escalationRequested"),
@@ -1208,14 +1265,8 @@ function AppilotsChatInner({
       offer: t("escalationOffer")
     }
   });
-  const {
-    pendingActions,
-    executingActions,
-    completedActions,
-    approveAction,
-    rejectAction
-  } = chunkN7EAOLBP_js.useAppilotsActions({ autoExecute });
-  const { emit, remotePersonalization } = chunkAYWMBMSN_js.useAppilotsContext();
+  const { pendingActions, executingActions, completedActions, approveAction, rejectAction } = chunk2YPEQTL2_js.useAppilotsActions({ autoExecute });
+  const { emit, remotePersonalization } = chunk55Y2AQE7_js.useAppilotsContext();
   const {
     headerTitle: resolvedTitle,
     assistantAvatar,
@@ -1245,18 +1296,18 @@ function AppilotsChatInner({
     }
     return void 0;
   }, [messages]);
-  const insets = reactNativeSafeAreaContext.useSafeAreaInsets();
+  const insets = useSafeAreaInsetsOrDefault();
   const [internalVisible, setInternalVisible] = React7.useState(mode === "inline");
   const [inputText, setInputText] = React7.useState("");
   const flatListRef = React7.useRef(null);
   const slideAnim = React7.useRef(new reactNative.Animated.Value(SCREEN_HEIGHT)).current;
   const isVisible = mode === "inline" ? true : controlledVisible !== void 0 ? controlledVisible : internalVisible;
-  const showSuggestedPrompts = chunkN7EAOLBP_js.shouldShowSuggestedPrompts({
+  const showSuggestedPrompts = chunk2YPEQTL2_js.shouldShowSuggestedPrompts({
     isVisible,
     messageCount: messages.length,
     inputText
   });
-  const { prompts: suggestedPrompts } = chunkN7EAOLBP_js.useSuggestedPrompts({
+  const { prompts: suggestedPrompts } = chunk2YPEQTL2_js.useSuggestedPrompts({
     enabled: showSuggestedPrompts,
     limit: 3
   });
@@ -1430,6 +1481,15 @@ function AppilotsChatInner({
         primaryColor: theme.colors.primary,
         textColor: theme.colors.text,
         fontFamily: theme.typography.fontFamily,
+        confirmStrings: {
+          confirmDestructiveTitle: strings.confirmDestructiveTitle,
+          confirmTitle: strings.confirmTitle,
+          confirmMessage: strings.confirmMessage,
+          confirmDestructiveApprove: strings.confirmDestructiveApprove,
+          confirmApprove: strings.confirmApprove,
+          confirmCancel: strings.confirmCancel,
+          confirmThisAction: strings.confirmThisAction
+        },
         palette: {
           textSecondary: theme.colors.textSecondary,
           surface: theme.colors.surface,
@@ -1535,7 +1595,15 @@ function AppilotsChatInner({
           color: escalation ? theme.colors.primary : theme.colors.textSecondary
         }
       )
-    ), /* @__PURE__ */ React7__namespace.default.createElement(reactNative.TouchableOpacity, { ...APPILOTS_SKIP_PROPS, onPress: clearMessages, style: styles3.headerButton }, /* @__PURE__ */ React7__namespace.default.createElement(reactNative.Text, { style: [styles3.headerButtonText, { color: theme.colors.textSecondary }] }, strings.clearButton)), mode !== "inline" && /* @__PURE__ */ React7__namespace.default.createElement(
+    ), /* @__PURE__ */ React7__namespace.default.createElement(
+      reactNative.TouchableOpacity,
+      {
+        ...APPILOTS_SKIP_PROPS,
+        onPress: clearMessages,
+        style: styles3.headerButton
+      },
+      /* @__PURE__ */ React7__namespace.default.createElement(reactNative.Text, { style: [styles3.headerButtonText, { color: theme.colors.textSecondary }] }, strings.clearButton)
+    ), mode !== "inline" && /* @__PURE__ */ React7__namespace.default.createElement(
       reactNative.TouchableOpacity,
       {
         ...APPILOTS_SKIP_PROPS,
@@ -1600,10 +1668,7 @@ function AppilotsChatInner({
         ) : /* @__PURE__ */ React7__namespace.default.createElement(
           reactNative.View,
           {
-            style: [
-              styles3.emptyIconBadge,
-              { backgroundColor: theme.colors.primary + "14" }
-            ]
+            style: [styles3.emptyIconBadge, { backgroundColor: theme.colors.primary + "14" }]
           },
           emptyStateIcon ? /* @__PURE__ */ React7__namespace.default.createElement(reactNative.Text, { style: styles3.emptyIconEmoji }, emptyStateIcon) : /* @__PURE__ */ React7__namespace.default.createElement(ChatIcon, { size: 30, color: theme.colors.primary })
         ), /* @__PURE__ */ React7__namespace.default.createElement(
@@ -2134,66 +2199,101 @@ var styles3 = reactNative.StyleSheet.create({
 function ConfirmDialog(_props = {}) {
   return null;
 }
+
+// src/hoc/canHoldRef.ts
+var FORWARD_REF = /* @__PURE__ */ Symbol.for("react.forward_ref");
+var MEMO = /* @__PURE__ */ Symbol.for("react.memo");
+var LAZY = /* @__PURE__ */ Symbol.for("react.lazy");
+function canHoldRef(type) {
+  if (typeof type === "string") return true;
+  if (!type) return false;
+  const t = type;
+  if (t.prototype?.isReactComponent) return true;
+  switch (t.$$typeof) {
+    case FORWARD_REF:
+      return true;
+    // memo(X) holds a ref only when X does. memo(forwardRef(f)) is the
+    // common shape and must keep working.
+    case MEMO:
+      return canHoldRef(t.type);
+    // lazy() resolves at render time; the payload is not inspectable here.
+    // Assume it can — refusing a ref to something that wanted one is a
+    // silent behaviour change, and lazy() is rare in this position.
+    case LAZY:
+      return true;
+    default:
+      return false;
+  }
+}
+
+// src/hoc/createAppilotsInput.tsx
 function normalizeId(label) {
   return label.toLowerCase().normalize("NFD").replace(/[\u0300-\u036f]/g, "").replace(/[^a-z0-9\s]/g, "").trim().replace(/\s+(.)/g, (_, c) => c.toUpperCase());
 }
 function createAppilotsInput(WrappedComponent) {
-  const AppilotsInput = React7__namespace.default.forwardRef(
-    (props, ref) => {
-      const {
-        appilotsId,
-        appilotsScreen,
-        appilotsFieldType = "text",
-        appilotsEnabled = true,
-        label,
-        value,
-        onChangeText,
-        ...rest
-      } = props;
-      const fieldId = appilotsId || (label ? normalizeId(label) : null);
-      const valueRef = React7.useRef(value ?? "");
-      const onChangeRef = React7.useRef(onChangeText);
-      const innerRef = React7.useRef(null);
-      valueRef.current = value ?? "";
-      onChangeRef.current = onChangeText;
-      const getValue = React7.useCallback(() => valueRef.current, []);
-      const setValue = React7.useCallback((v) => onChangeRef.current?.(v), []);
-      const focus = React7.useCallback(() => {
-        innerRef.current?.focus?.();
-      }, []);
-      React7.useEffect(() => {
-        if (!fieldId || !appilotsEnabled) return;
-        const entry = {
-          kind: "field",
-          getValue,
-          setValue,
-          focus,
-          fieldType: appilotsFieldType,
-          label: label ?? fieldId,
-          screen: appilotsScreen
-        };
-        chunkAYWMBMSN_js.componentRegistry.register(fieldId, entry);
-        return () => {
-          chunkAYWMBMSN_js.componentRegistry.unregister(fieldId);
-        };
-      }, [fieldId, appilotsEnabled, getValue, setValue, focus, appilotsFieldType, label, appilotsScreen]);
-      const mergedRef = React7.useCallback(
-        (instance) => {
-          innerRef.current = instance;
-          if (typeof ref === "function") ref(instance);
-          else if (ref) ref.current = instance;
-        },
-        [ref]
-      );
-      return /* @__PURE__ */ React7__namespace.default.createElement(
-        WrappedComponent,
-        {
-          ...{ label, value, onChangeText, ...rest },
-          ref: mergedRef
-        }
-      );
-    }
-  );
+  const AppilotsInput = React7__namespace.default.forwardRef((props, ref) => {
+    const {
+      appilotsId,
+      appilotsScreen,
+      appilotsFieldType = "text",
+      appilotsEnabled = true,
+      label,
+      value,
+      onChangeText,
+      ...rest
+    } = props;
+    const fieldId = appilotsId || (label ? normalizeId(label) : null);
+    const valueRef = React7.useRef(value ?? "");
+    const onChangeRef = React7.useRef(onChangeText);
+    const innerRef = React7.useRef(null);
+    valueRef.current = value ?? "";
+    onChangeRef.current = onChangeText;
+    const getValue = React7.useCallback(() => valueRef.current, []);
+    const setValue = React7.useCallback((v) => onChangeRef.current?.(v), []);
+    const focus = React7.useCallback(() => {
+      innerRef.current?.focus?.();
+    }, []);
+    React7.useEffect(() => {
+      if (!fieldId || !appilotsEnabled) return;
+      const entry = {
+        kind: "field",
+        getValue,
+        setValue,
+        focus,
+        fieldType: appilotsFieldType,
+        label: label ?? fieldId,
+        screen: appilotsScreen
+      };
+      chunk55Y2AQE7_js.componentRegistry.register(fieldId, entry);
+      return () => {
+        chunk55Y2AQE7_js.componentRegistry.unregister(fieldId);
+      };
+    }, [
+      fieldId,
+      appilotsEnabled,
+      getValue,
+      setValue,
+      focus,
+      appilotsFieldType,
+      label,
+      appilotsScreen
+    ]);
+    const mergedRef = React7.useCallback(
+      (instance) => {
+        innerRef.current = instance;
+        if (typeof ref === "function") ref(instance);
+        else if (ref) ref.current = instance;
+      },
+      [ref]
+    );
+    return /* @__PURE__ */ React7__namespace.default.createElement(
+      WrappedComponent,
+      {
+        ...{ label, value, onChangeText, ...rest },
+        ...canHoldRef(WrappedComponent) ? { ref: mergedRef } : {}
+      }
+    );
+  });
   AppilotsInput.displayName = `AppilotsInput(${WrappedComponent.displayName || WrappedComponent.name || "Component"})`;
   return AppilotsInput;
 }
@@ -2201,42 +2301,40 @@ function normalizeId2(label) {
   return label.toLowerCase().normalize("NFD").replace(/[\u0300-\u036f]/g, "").replace(/[^a-z0-9\s]/g, "").trim().replace(/\s+(.)/g, (_, c) => c.toUpperCase());
 }
 function createAppilotsButton(WrappedComponent) {
-  const AppilotsButton = React7__namespace.default.forwardRef(
-    (props, ref) => {
-      const {
-        appilotsId,
-        appilotsScreen,
-        appilotsEnabled = true,
-        title,
-        onPress,
-        ...rest
-      } = props;
-      const targetId = appilotsId || (title ? normalizeId2(title) : null);
-      const onPressRef = React7.useRef(onPress);
-      onPressRef.current = onPress;
-      const press = React7.useCallback(() => onPressRef.current?.(), []);
-      React7.useEffect(() => {
-        if (!targetId || !appilotsEnabled) return;
-        const entry = {
-          kind: "target",
-          press,
-          label: title ?? targetId,
-          screen: appilotsScreen
-        };
-        chunkAYWMBMSN_js.componentRegistry.register(targetId, entry);
-        return () => {
-          chunkAYWMBMSN_js.componentRegistry.unregister(targetId);
-        };
-      }, [targetId, appilotsEnabled, press, title, appilotsScreen]);
-      return /* @__PURE__ */ React7__namespace.default.createElement(
-        WrappedComponent,
-        {
-          ...{ title, onPress, ...rest },
-          ref
-        }
-      );
-    }
-  );
+  const AppilotsButton = React7__namespace.default.forwardRef((props, ref) => {
+    const {
+      appilotsId,
+      appilotsScreen,
+      appilotsEnabled = true,
+      title,
+      onPress,
+      ...rest
+    } = props;
+    const targetId = appilotsId || (title ? normalizeId2(title) : null);
+    const onPressRef = React7.useRef(onPress);
+    onPressRef.current = onPress;
+    const press = React7.useCallback(() => onPressRef.current?.(), []);
+    React7.useEffect(() => {
+      if (!targetId || !appilotsEnabled) return;
+      const entry = {
+        kind: "target",
+        press,
+        label: title ?? targetId,
+        screen: appilotsScreen
+      };
+      chunk55Y2AQE7_js.componentRegistry.register(targetId, entry);
+      return () => {
+        chunk55Y2AQE7_js.componentRegistry.unregister(targetId);
+      };
+    }, [targetId, appilotsEnabled, press, title, appilotsScreen]);
+    return /* @__PURE__ */ React7__namespace.default.createElement(
+      WrappedComponent,
+      {
+        ...{ title, onPress, ...rest },
+        ...canHoldRef(WrappedComponent) ? { ref } : {}
+      }
+    );
+  });
   AppilotsButton.displayName = `AppilotsButton(${WrappedComponent.displayName || WrappedComponent.name || "Component"})`;
   return AppilotsButton;
 }
@@ -2244,214 +2342,224 @@ function normalizeId3(label) {
   return label.toLowerCase().normalize("NFD").replace(/[\u0300-\u036f]/g, "").replace(/[^a-z0-9\s]/g, "").trim().replace(/\s+(.)/g, (_, c) => c.toUpperCase());
 }
 function createAppilotsSwitch(WrappedComponent) {
-  const AppilotsSwitch = React7__namespace.default.forwardRef(
-    (props, ref) => {
-      const {
-        appilotsId,
-        appilotsScreen,
-        appilotsEnabled = true,
-        label,
-        value,
-        onValueChange,
-        ...rest
-      } = props;
-      const toggleId = appilotsId || (label ? normalizeId3(label) : null);
-      const valueRef = React7.useRef(value ?? false);
-      const onChangeRef = React7.useRef(onValueChange);
-      valueRef.current = value ?? false;
-      onChangeRef.current = onValueChange;
-      const getValue = React7.useCallback(() => valueRef.current, []);
-      const setValue = React7.useCallback((v) => onChangeRef.current?.(v), []);
-      React7.useEffect(() => {
-        if (!toggleId || !appilotsEnabled) return;
-        const entry = {
-          kind: "toggle",
-          getValue,
-          setValue,
-          label: label ?? toggleId,
-          screen: appilotsScreen
-        };
-        chunkAYWMBMSN_js.componentRegistry.register(toggleId, entry);
-        return () => {
-          chunkAYWMBMSN_js.componentRegistry.unregister(toggleId);
-        };
-      }, [toggleId, appilotsEnabled, getValue, setValue, label, appilotsScreen]);
-      return /* @__PURE__ */ React7__namespace.default.createElement(
-        WrappedComponent,
-        {
-          ...{ label, value, onValueChange, ...rest },
-          ref
-        }
-      );
-    }
-  );
+  const AppilotsSwitch = React7__namespace.default.forwardRef((props, ref) => {
+    const {
+      appilotsId,
+      appilotsScreen,
+      appilotsEnabled = true,
+      label,
+      value,
+      onValueChange,
+      ...rest
+    } = props;
+    const toggleId = appilotsId || (label ? normalizeId3(label) : null);
+    const valueRef = React7.useRef(value ?? false);
+    const onChangeRef = React7.useRef(onValueChange);
+    valueRef.current = value ?? false;
+    onChangeRef.current = onValueChange;
+    const getValue = React7.useCallback(() => valueRef.current, []);
+    const setValue = React7.useCallback((v) => onChangeRef.current?.(v), []);
+    React7.useEffect(() => {
+      if (!toggleId || !appilotsEnabled) return;
+      const entry = {
+        kind: "toggle",
+        getValue,
+        setValue,
+        label: label ?? toggleId,
+        screen: appilotsScreen
+      };
+      chunk55Y2AQE7_js.componentRegistry.register(toggleId, entry);
+      return () => {
+        chunk55Y2AQE7_js.componentRegistry.unregister(toggleId);
+      };
+    }, [toggleId, appilotsEnabled, getValue, setValue, label, appilotsScreen]);
+    return /* @__PURE__ */ React7__namespace.default.createElement(
+      WrappedComponent,
+      {
+        ...{ label, value, onValueChange, ...rest },
+        ...canHoldRef(WrappedComponent) ? { ref } : {}
+      }
+    );
+  });
   AppilotsSwitch.displayName = `AppilotsSwitch(${WrappedComponent.displayName || WrappedComponent.name || "Component"})`;
   return AppilotsSwitch;
 }
 
 Object.defineProperty(exports, "AppilotsNavigationContainer", {
   enumerable: true,
-  get: function () { return chunkH7BMQTXH_js.AppilotsNavigationContainer; }
+  get: function () { return chunkIZEWWAA7_js.AppilotsNavigationContainer; }
+});
+Object.defineProperty(exports, "appilotsSelfCheck", {
+  enumerable: true,
+  get: function () { return chunk2YPEQTL2_js.appilotsSelfCheck; }
 });
 Object.defineProperty(exports, "captureSnapshot", {
   enumerable: true,
-  get: function () { return chunkN7EAOLBP_js.captureSnapshot; }
+  get: function () { return chunk2YPEQTL2_js.captureSnapshot; }
 });
 Object.defineProperty(exports, "executeAction", {
   enumerable: true,
-  get: function () { return chunkN7EAOLBP_js.executeAction; }
+  get: function () { return chunk2YPEQTL2_js.executeAction; }
 });
 Object.defineProperty(exports, "useAppilots", {
   enumerable: true,
-  get: function () { return chunkN7EAOLBP_js.useAppilots; }
+  get: function () { return chunk2YPEQTL2_js.useAppilots; }
 });
 Object.defineProperty(exports, "useAppilotsActions", {
   enumerable: true,
-  get: function () { return chunkN7EAOLBP_js.useAppilotsActions; }
+  get: function () { return chunk2YPEQTL2_js.useAppilotsActions; }
 });
 Object.defineProperty(exports, "useAppilotsChat", {
   enumerable: true,
-  get: function () { return chunkN7EAOLBP_js.useAppilotsChat; }
+  get: function () { return chunk2YPEQTL2_js.useAppilotsChat; }
 });
 Object.defineProperty(exports, "useAppilotsField", {
   enumerable: true,
-  get: function () { return chunkN7EAOLBP_js.useAppilotsField; }
+  get: function () { return chunk2YPEQTL2_js.useAppilotsField; }
 });
 Object.defineProperty(exports, "useAppilotsNavigation", {
   enumerable: true,
-  get: function () { return chunkN7EAOLBP_js.useAppilotsNavigation; }
+  get: function () { return chunk2YPEQTL2_js.useAppilotsNavigation; }
 });
 Object.defineProperty(exports, "useAppilotsSlider", {
   enumerable: true,
-  get: function () { return chunkN7EAOLBP_js.useAppilotsSlider; }
+  get: function () { return chunk2YPEQTL2_js.useAppilotsSlider; }
 });
 Object.defineProperty(exports, "useAppilotsTarget", {
   enumerable: true,
-  get: function () { return chunkN7EAOLBP_js.useAppilotsTarget; }
+  get: function () { return chunk2YPEQTL2_js.useAppilotsTarget; }
 });
 Object.defineProperty(exports, "useAppilotsToggle", {
   enumerable: true,
-  get: function () { return chunkN7EAOLBP_js.useAppilotsToggle; }
+  get: function () { return chunk2YPEQTL2_js.useAppilotsToggle; }
 });
 Object.defineProperty(exports, "useSuggestedPrompts", {
   enumerable: true,
-  get: function () { return chunkN7EAOLBP_js.useSuggestedPrompts; }
+  get: function () { return chunk2YPEQTL2_js.useSuggestedPrompts; }
 });
 Object.defineProperty(exports, "AppilotsClient", {
   enumerable: true,
-  get: function () { return chunkAYWMBMSN_js.AppilotsClient; }
+  get: function () { return chunk55Y2AQE7_js.AppilotsClient; }
 });
 Object.defineProperty(exports, "AppilotsProvider", {
   enumerable: true,
-  get: function () { return chunkAYWMBMSN_js.AppilotsProvider; }
+  get: function () { return chunk55Y2AQE7_js.AppilotsProvider; }
 });
 Object.defineProperty(exports, "AppilotsRegistryProvider", {
   enumerable: true,
-  get: function () { return chunkAYWMBMSN_js.AppilotsRegistryProvider; }
+  get: function () { return chunk55Y2AQE7_js.AppilotsRegistryProvider; }
 });
 Object.defineProperty(exports, "RateLimitedError", {
   enumerable: true,
-  get: function () { return chunkAYWMBMSN_js.RateLimitedError; }
+  get: function () { return chunk55Y2AQE7_js.RateLimitedError; }
 });
 Object.defineProperty(exports, "SDK_VERSION", {
   enumerable: true,
-  get: function () { return chunkAYWMBMSN_js.SDK_VERSION; }
+  get: function () { return chunk55Y2AQE7_js.SDK_VERSION; }
 });
 Object.defineProperty(exports, "_patchJsxRuntimes", {
   enumerable: true,
-  get: function () { return chunkAYWMBMSN_js._patchJsxRuntimes; }
+  get: function () { return chunk55Y2AQE7_js._patchJsxRuntimes; }
 });
 Object.defineProperty(exports, "clearAppilotsDebugTraces", {
   enumerable: true,
-  get: function () { return chunkAYWMBMSN_js.clearAppilotsDebugTraces; }
+  get: function () { return chunk55Y2AQE7_js.clearAppilotsDebugTraces; }
 });
 Object.defineProperty(exports, "componentRegistry", {
   enumerable: true,
-  get: function () { return chunkAYWMBMSN_js.componentRegistry; }
+  get: function () { return chunk55Y2AQE7_js.componentRegistry; }
 });
 Object.defineProperty(exports, "createComponentRegistry", {
   enumerable: true,
-  get: function () { return chunkAYWMBMSN_js.createComponentRegistry; }
+  get: function () { return chunk55Y2AQE7_js.createComponentRegistry; }
 });
 Object.defineProperty(exports, "createElementRegistry", {
   enumerable: true,
-  get: function () { return chunkAYWMBMSN_js.createElementRegistry; }
+  get: function () { return chunk55Y2AQE7_js.createElementRegistry; }
 });
 Object.defineProperty(exports, "createListRegistry", {
   enumerable: true,
-  get: function () { return chunkAYWMBMSN_js.createListRegistry; }
+  get: function () { return chunk55Y2AQE7_js.createListRegistry; }
 });
 Object.defineProperty(exports, "defaultDarkTheme", {
   enumerable: true,
-  get: function () { return chunkAYWMBMSN_js.defaultDarkTheme; }
+  get: function () { return chunk55Y2AQE7_js.defaultDarkTheme; }
 });
 Object.defineProperty(exports, "defaultLightTheme", {
   enumerable: true,
-  get: function () { return chunkAYWMBMSN_js.defaultLightTheme; }
+  get: function () { return chunk55Y2AQE7_js.defaultLightTheme; }
 });
 Object.defineProperty(exports, "describeAction", {
   enumerable: true,
-  get: function () { return chunkAYWMBMSN_js.describeAction; }
+  get: function () { return chunk55Y2AQE7_js.describeAction; }
 });
 Object.defineProperty(exports, "elementRegistry", {
   enumerable: true,
-  get: function () { return chunkAYWMBMSN_js.elementRegistry; }
+  get: function () { return chunk55Y2AQE7_js.elementRegistry; }
 });
 Object.defineProperty(exports, "enableAppilotsAutoTracking", {
   enumerable: true,
-  get: function () { return chunkAYWMBMSN_js.enableAppilotsAutoTracking; }
+  get: function () { return chunk55Y2AQE7_js.enableAppilotsAutoTracking; }
 });
 Object.defineProperty(exports, "getAppilotsDebugTraces", {
   enumerable: true,
-  get: function () { return chunkAYWMBMSN_js.getAppilotsDebugTraces; }
+  get: function () { return chunk55Y2AQE7_js.getAppilotsDebugTraces; }
+});
+Object.defineProperty(exports, "getAutoTrackingState", {
+  enumerable: true,
+  get: function () { return chunk55Y2AQE7_js.getAutoTrackingState; }
 });
 Object.defineProperty(exports, "getGlobalConfig", {
   enumerable: true,
-  get: function () { return chunkAYWMBMSN_js.getGlobalConfig; }
+  get: function () { return chunk55Y2AQE7_js.getGlobalConfig; }
 });
 Object.defineProperty(exports, "getIntrospectionDiagnostics", {
   enumerable: true,
-  get: function () { return chunkAYWMBMSN_js.getIntrospectionDiagnostics; }
+  get: function () { return chunk55Y2AQE7_js.getIntrospectionDiagnostics; }
 });
 Object.defineProperty(exports, "humanizeError", {
   enumerable: true,
-  get: function () { return chunkAYWMBMSN_js.humanizeError; }
+  get: function () { return chunk55Y2AQE7_js.humanizeError; }
 });
 Object.defineProperty(exports, "initAppilots", {
   enumerable: true,
-  get: function () { return chunkAYWMBMSN_js.initAppilots; }
+  get: function () { return chunk55Y2AQE7_js.initAppilots; }
 });
 Object.defineProperty(exports, "isAutoTrackingEnabled", {
   enumerable: true,
-  get: function () { return chunkAYWMBMSN_js.isAutoTrackingEnabled; }
+  get: function () { return chunk55Y2AQE7_js.isAutoTrackingEnabled; }
 });
 Object.defineProperty(exports, "listRegistry", {
   enumerable: true,
-  get: function () { return chunkAYWMBMSN_js.listRegistry; }
+  get: function () { return chunk55Y2AQE7_js.listRegistry; }
 });
 Object.defineProperty(exports, "mergeThemeTokens", {
   enumerable: true,
-  get: function () { return chunkAYWMBMSN_js.mergeThemeTokens; }
+  get: function () { return chunk55Y2AQE7_js.mergeThemeTokens; }
 });
 Object.defineProperty(exports, "recordAppilotsDebugTrace", {
   enumerable: true,
-  get: function () { return chunkAYWMBMSN_js.recordAppilotsDebugTrace; }
+  get: function () { return chunk55Y2AQE7_js.recordAppilotsDebugTrace; }
 });
 Object.defineProperty(exports, "registerScreen", {
   enumerable: true,
-  get: function () { return chunkAYWMBMSN_js.registerScreen; }
+  get: function () { return chunk55Y2AQE7_js.registerScreen; }
+});
+Object.defineProperty(exports, "setCurrentScreen", {
+  enumerable: true,
+  get: function () { return chunk55Y2AQE7_js.setCurrentScreen; }
 });
 Object.defineProperty(exports, "subscribeAppilotsDebugTraces", {
   enumerable: true,
-  get: function () { return chunkAYWMBMSN_js.subscribeAppilotsDebugTraces; }
+  get: function () { return chunk55Y2AQE7_js.subscribeAppilotsDebugTraces; }
 });
 Object.defineProperty(exports, "useAppilotsContext", {
   enumerable: true,
-  get: function () { return chunkAYWMBMSN_js.useAppilotsContext; }
+  get: function () { return chunk55Y2AQE7_js.useAppilotsContext; }
 });
 Object.defineProperty(exports, "useResolvedRegistry", {
   enumerable: true,
-  get: function () { return chunkAYWMBMSN_js.useResolvedRegistry; }
+  get: function () { return chunk55Y2AQE7_js.useResolvedRegistry; }
 });
 exports.ActionBreadcrumb = ActionBreadcrumb;
 exports.AppilotsChat = AppilotsChat;