@magicfeedback/popup-sdk 1.1.0 → 1.1.2

package/dist/index.d.ts

@@ -1,29 +1,196 @@
+/**
+ * Identidad + sesión para el tracking de navegación (Fase 1).
+ * Implementa el "Contrato común Web+KMP".
+ *
+ * Modelo: el SDK gestiona el `user_id` (persistente). El `session_id` es propiedad
+ * del BACKEND: llega en la respuesta de `POST /sdk/popups` y se cachea; el backend
+ * cose sesiones por `user_id` + ventana. El SDK NO genera ni expira sesiones.
+ *
+ * Sin dependencias de DOM: recibe el storage y (opcionalmente) el reloj y el
+ * generador de uuid por inyección. El binding a `localStorage` vive en `createDefaultStorage`.
+ */
+/** Store clave/valor mínimo (espejo conceptual del `KeyValueStorage` de KMP). */
+interface KeyValueStorage {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+    removeItem(key: string): void;
+}
+/** Impl en memoria — usada en tests y como fallback sin `localStorage`. */
+declare class InMemoryStorage implements KeyValueStorage {
+    private map;
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+    removeItem(key: string): void;
+}
+/** Par clave/valor con el formato `NativeAnswer` que espera `@magicfeedback/native`. */
+interface IdentityAnswer {
+    key: string;
+    value: string[];
+}
+
+/**
+ * Device info para el context de analytics (Technology #11–13).
+ *
+ * En Web enviamos `device_type` + `user_agent` crudo y dejamos que el backend
+ * derive OS/navegador del UA (como hace GA). Los campos adicionales (timezone,
+ * referrer, viewport, etc.) se recogen de las APIs del navegador sin permisos.
+ * `country`/`city` se rellenan de forma asíncrona (ver geo-info.ts).
+ * En KMP las APIs nativas dan os_version/device_model reales.
+ */
+interface DeviceInfo {
+    device_type: 'mobile' | 'tablet' | 'desktop';
+    os_version?: string;
+    device_model?: string;
+    app_version?: string;
+    user_agent?: string;
+    timezone?: string;
+    referrer?: string;
+    viewport_size?: string;
+    screen_resolution?: string;
+    pixel_ratio?: number;
+    entry_type?: string;
+    page_load_ms?: number;
+    connection_type?: string;
+    country?: string;
+    city?: string;
+}
+
+/**
+ * Capa de Analytics (eventos GA-style) — canal SEPARADO del feedback de survey.
+ *
+ * El feedback de survey se envía con `magicfeedback.send()`. La analítica de
+ * navegación/comportamiento (page views, mini-services, tasks/funnels, meaningful
+ * interactions, findability…) va por un ENDPOINT PROPIO, vinculada por `user_id`.
+ *
+ * De momento NO se hace la llamada: el `sink` por defecto hace `console.log` del
+ * payload exacto que se enviaría (dry-run), para poder verificarlo. Cuando el
+ * endpoint exista, se sustituye el sink por un POST.
+ */
+
+interface AnalyticsEvent {
+    name: string;
+    timestamp: number;
+    params?: Record<string, unknown>;
+}
+interface AnalyticsEnvelope {
+    /** Clave pública del cliente (auth). */
+    publicKey?: string;
+    /** Id que vincula la analítica al usuario (el backend cose por aquí). */
+    userId: string | null;
+    /** Session id del backend si ya se conoce (puede ir null). */
+    sessionId: string | null;
+    context: {
+        platform: string;
+        language?: string;
+        /** Info de dispositivo (Technology #11–13). */
+        device?: DeviceInfo;
+        /** User attributes del cliente, usados para breakdowns (registration_status, pass_type, …). */
+        attributes: Record<string, string>;
+    };
+    events: AnalyticsEvent[];
+}
+type AnalyticsSink = (payload: AnalyticsEnvelope) => void;
+
+/**
+ * Mapeo del envelope de analytics → body de `POST /sdk/feedback`.
+ *
+ * La analítica se envía como un Feedback del modelo del Surveys SDK, agrupado por una
+ * INTEGRACIÓN creada en la plataforma. Se manda en streaming con `completed:false` y
+ * `finished:false` (nunca se "cierra"); el backend cose por `sessionId` + `user_id`.
+ *
+ * Encoding:
+ *  - todo va en `feedback.metadata`: contexto (user_id, session_id, platform…) + eventos
+ *  - cada entrada usa `value: string[]` (array de un elemento)
+ *  - eventos: {key: nombre_evento, value: [JSON(timestamp + params)]}
+ *  - identidad (user_id) → `profile` como `external-user-id`
+ *  - `answers` vacío, `metrics` no se usa
+ *  - `text` vacío
+ */
+
+interface AnalyticsKeys {
+    publicKey: string;
+    integration: string;
+}
+interface FeedbackKV {
+    key: string;
+    value: string[];
+}
+interface AnalyticsFeedbackBody {
+    feedback: {
+        text: string;
+        answers: FeedbackKV[];
+        metadata: FeedbackKV[];
+        profile: FeedbackKV[];
+        finished: boolean;
+    };
+    publicKey: string;
+    integration: string;
+    completed: boolean;
+    finished?: boolean;
+    /** sessionId devuelto por el primer POST; permite que el backend agrupe todos los eventos en un solo registro. */
+    sessionId?: string;
+}
+declare function buildAnalyticsFeedbackBody(envelope: AnalyticsEnvelope, keys: AnalyticsKeys, feedbackSessionId?: string): AnalyticsFeedbackBody;
+interface FeedbackSinkOptions {
+    /** Base URL del backend (api(.|-dev.)deepdots.com) ya resuelta por el entorno. */
+    baseUrl: string;
+    keys: AnalyticsKeys;
+    /** Logger opcional (gated por debug). */
+    log?: (...args: unknown[]) => void;
+    /** fetch inyectable (tests / RN). */
+    fetchImpl?: typeof fetch;
+    /** Callback invocado cuando el backend devuelve un nuevo sessionId (primer POST). */
+    onSessionId?: (id: string) => void;
+}
+/**
+ * Sink real: transforma el envelope y hace `POST {baseUrl}/sdk/feedback`.
+ * Fire-and-forget (no bloquea el flush); errores solo se loguean.
+ * Stateful: cachea el `sessionId` que devuelve el backend en la primera respuesta
+ * y lo envía en los siguientes POSTs para que el backend agrupe todos los eventos
+ * en un único registro de feedback.
+ */
+declare function createFeedbackSink(options: FeedbackSinkOptions): AnalyticsSink;
+
 /**
  * Configuration options for initializing the DeepdotsPopups SDK
  */
+
 interface DeepdotsInitParams {
     /** API key for authentication */
     apiKey?: string;
     /** Node environment: 'development' or 'production' */
     nodeEnv?: 'development' | 'production';
-    /** Execution mode: 'server' or 'client' */
-    mode?: 'server' | 'client';
     /** Enable debug logging */
     debug?: boolean;
-    /** Lista de definiciones de popups precargadas */
-    popups?: PopupDefinition[];
     /** Optional user id to send with popup events */
     userId?: string;
+    /** Starts tracking enabled (default) or disabled (e.g. until consent is granted). Equivalent to calling `setTrackingEnabled` after init. */
+    trackingEnabled?: boolean;
+    /** Host app version (for analytics device info / Technology #11). */
+    appVersion?: string;
+    /** Injectable persistent storage (RN: adapter over AsyncStorage). If missing, uses localStorage/in-memory. */
+    storage?: KeyValueStorage;
+    /** Platform used in the analytics envelope. Default is 'web'; in RN pass 'android'/'ios'. */
+    platform?: 'web' | 'android' | 'ios';
+    /** Injectable device info (RN: from react-native-device-info). If missing, it is derived from the browser. */
+    device?: DeviceInfo;
+    /**
+     * Analytics channel keys (`POST /sdk/feedback`). If provided, analytics is SENT
+     * to the configured integration; if missing, it stays in dry-run mode (console.log only).
+     */
+    analytics?: AnalyticsKeys;
+    /**
+     * Internal user attributes known only by the host (language, age, plan, ...), sent
+     * to the backend Contact for segmentation/targeting. Requires `userId`. Equivalent to calling
+     * `setContactAttributes` after init (sends only when values changed from the last sync).
+     */
+    contactAttributes?: Record<string, string | number | boolean>;
 }
 interface DeepdotsConfig {
     /** API key for authentication */
     apiKey?: string;
-    /** Execution mode: 'server' or 'client' */
-    mode?: 'server' | 'client';
     /** Enable debug logging */
     debug?: boolean;
-    /** Lista de definiciones de popups precargadas */
-    popups?: PopupDefinition[];
     /** Optional user id to send with popup events */
     userId?: string;
 }
@@ -40,17 +207,6 @@ interface TriggerConfig {
     /** Optional popup definition id (used to disambiguate repeated survey ids) */
     popupId?: string;
 }
-/**
- * Options for showing a popup
- */
-interface ShowOptions {
-    /** Survey ID to display */
-    surveyId: string;
-    /** Product ID associated with the survey */
-    productId: string;
-    /** Additional data to pass with the survey */
-    data?: Record<string, unknown>;
-}
 /**
  * Event types emitted by the SDK
  */
@@ -68,26 +224,26 @@ interface DeepdotsEvent {
  * Event listener callback
  */
 type EventListener = (event: DeepdotsEvent) => void;
-/** Tipo de trigger específico para definiciones de popup remotas */
+/** Trigger type used by remote popup definitions */
 type PopupTriggerType = 'time_on_page' | 'scroll' | 'exit' | 'click' | 'event';
 type PopupTriggerConditionStatus = 'SHOWED' | 'PARTIAL' | 'COMPLETED';
 declare const POPUP_TRIGGER_CONDITION_STATUSES: PopupTriggerConditionStatus[];
-/** Condición adicional para la activación del popup */
+/** Extra condition used to activate the popup */
 interface PopupTriggerCondition {
     answered: PopupTriggerConditionStatus;
     cooldownDays: number;
 }
-/** Trigger asociado a la definición del popup */
+/** Trigger attached to the popup definition */
 interface PopupTrigger {
     type: PopupTriggerType;
     value: number | string;
 }
-/** Acción de aceptar (abrir encuesta) */
+/** Accept action (open survey) */
 interface PopupActionAccept {
     label: string;
     surveyId: string;
 }
-/** Acción de declinar */
+/** Decline action */
 interface PopupActionDecline {
     label: string;
     cooldownDays?: number;
@@ -96,14 +252,14 @@ interface PopupActionDecline {
 interface PopupActionStart {
     label: string;
 }
-/** Acción de completar (aceptar y completar encuesta automáticamente) */
+/** Complete action (accept and auto-complete survey) */
 interface PopupActionComplete {
     label: string;
     surveyId: string;
     autoCompleteParams: Record<string, unknown>;
     cooldownDays?: number;
 }
-/** Conjunto de acciones disponibles en el popup */
+/** Set of actions available in the popup */
 interface PopupActions {
     accept?: PopupActionAccept;
     decline?: PopupActionDecline;
@@ -111,20 +267,20 @@ interface PopupActions {
     start?: PopupActionStart;
     back?: PopupActionDecline;
 }
-/** Estilos configurables del popup */
+/** Configurable popup styles */
 interface PopupStyle {
     theme: 'light' | 'dark';
     position: 'bottom' | 'bottom-right' | 'bottom-left' | 'top' | 'top-right' | 'top-left' | 'center';
-    /** @deprecated No usado por el SDK — solo se conserva por compatibilidad con la API */
+    /** @deprecated Not used by the SDK; kept only for API compatibility */
     imageUrl?: string | null;
 }
-/** Segmentos o targeting para mostrar el popup */
+/** Segments/targeting rules for showing the popup */
 interface PopupSegments {
     lang?: string[];
     path?: string[];
     [key: string]: unknown;
 }
-/** Definición completa de un popup */
+/** Full popup definition */
 interface PopupDefinition {
     id: string;
     title: string;
@@ -142,10 +298,59 @@ interface PopupRenderer {
     /** Preparar recursos si aplica */
     init?(): void;
     /** Mostrar popup */
-    show(surveyId: string, productId: string, actions: PopupActions | undefined, emit: (type: DeepdotsEventType, surveyId: string, data?: Record<string, unknown>) => void, onClose: () => void, env?: string, userId?: string, style?: PopupStyle): void;
+    show(surveyId: string, productId: string, actions: PopupActions | undefined, emit: (type: DeepdotsEventType, surveyId: string, data?: Record<string, unknown>) => void, onClose: () => void, env?: string, userId?: string, style?: PopupStyle, sessionId?: string, miniService?: string, analyticsFeedbackSessionId?: string): void;
     /** Ocultar popup */
     hide(): void;
 }
+/** Renderer que no hace nada (SSR / entornos sin DOM) */
+declare class NoopPopupRenderer implements PopupRenderer {
+    show(): void;
+    hide(): void;
+}
+/** Renderer para navegadores usando la implementación actual basada en renderPopup */
+declare class BrowserPopupRenderer implements PopupRenderer {
+    private container;
+    private visible;
+    init(): void;
+    show(surveyId: string, productId: string, actions: PopupActions | undefined, emit: (type: DeepdotsEventType, surveyId: string, data?: Record<string, unknown>) => void, onClose: () => void, env?: string, userId?: string, style?: PopupStyle, sessionId?: string, miniService?: string, analyticsFeedbackSessionId?: string): void;
+    hide(): void;
+}
+/** Factoría para obtener renderer por defecto */
+declare function createDefaultRenderer(): PopupRenderer;
+
+/** Valor de un atributo de contact (info interna del usuario que solo conoce el host). */
+type ContactAttributeValue = string | number | boolean;
+type ContactAttributes = Record<string, ContactAttributeValue>;
+/** Body de `POST /sdk/popups/contact`. */
+interface ContactBody {
+    publicKey: string;
+    userId: string;
+    userAttributes: ContactAttributes;
+}
+interface ContactManagerOptions {
+    storage: KeyValueStorage;
+    publicKey: string;
+    userId: string;
+    /** Envío real (inyectable para tests): hace el `POST /sdk/popups/contact`. */
+    post: (body: ContactBody) => Promise<void>;
+}
+/**
+ * Gestiona los atributos de contact del usuario identificado (`userId` del init).
+ * Solo envía cuando cambian respecto a lo último persistido en storage, para ahorrar
+ * peticiones (el host puede llamar `setAttributes` en cada identificación sin miedo).
+ */
+declare class ContactManager {
+    private readonly storage;
+    private readonly publicKey;
+    private readonly userId;
+    private readonly post;
+    constructor(options: ContactManagerOptions);
+    /**
+     * Envía los atributos si cambiaron respecto a lo último enviado.
+     * @returns `true` si se envió, `false` si no hubo cambios.
+     */
+    setAttributes(attributes: ContactAttributes): Promise<boolean>;
+}
 
 /**
  * Main class for managing survey popups
@@ -167,20 +372,76 @@ declare class DeepdotsPopups {
     private deferredExitTimers;
     private baseUrl;
     private env;
+    /** Identidad + sesión (Fase 1 tracking). Null hasta init(). */
+    private tracking;
+    /** Capa de analytics (canal separado del feedback). Null hasta init(). */
+    private analytics;
+    /** feedbackSessionId cacheado del canal de analytics (devuelto por POST /sdk/feedback). */
+    private analyticsFeedbackSessionId;
+    /** Timer del flush periódico de analytics (cada ANALYTICS_FLUSH_INTERVAL_MS). */
+    private analyticsFlushTimer;
+    /** Observador de navegación (Fase 2): emite page_view por el canal de analytics. */
+    private navObserver;
+    /** Tiempo activo (engagement time, #8). */
+    private engagement;
+    /** Atributos internos del usuario identificado → POST /sdk/popups/contact. Null si no hay userId. */
+    private contact;
+    /** Marca si ya se inició la navegación manual (setScreen) — para RN sin History API. */
+    private navStarted;
     /** Initialize the SDK with configuration */
     init(config: DeepdotsInitParams): void;
+    /** User id actual (generado por el SDK o provisto por el cliente). Null si tracking off. */
+    getUserId(): string | null;
+    /** Session id de navegación actual. Null si tracking off. */
+    getSessionId(): string | null;
+    /** Activa/desactiva el tracking (identidad + sesión + analytics). Kill-switch del contrato §7bis. */
+    setTrackingEnabled(enabled: boolean): void;
+    /** Registra un evento de analítica (modelo GA: nombre + params). No-op si tracking off. */
+    track(name: string, params?: Record<string, unknown>): void;
+    /** User attributes para breakdowns (registration_status, pass_type, sector, pass_status…). */
+    setUserAttributes(attributes: Record<string, string | number | boolean>): void;
+    /**
+     * Info interna del usuario que solo conoce el host (idioma, edad, plan…), persistida en el
+     * Contact del backend para segmentación/targeting de popups. Identificada por el `userId` del
+     * init. Solo envía si los atributos cambiaron (diff en storage). No-op si tracking off o sin userId.
+     * @returns `true` si se envió al backend, `false` si no hubo cambios o está deshabilitado.
+     */
+    setContactAttributes(attributes: ContactAttributes): Promise<boolean>;
+    /** Marca el inicio de un mini-service; etiqueta los eventos siguientes. No-op si tracking off. */
+    enterMiniService(name: string, entryPointType?: string): void;
+    /** Cierra el mini-service activo (emite `mini_service_exit` con duración, #27). No-op si tracking off. */
+    exitMiniService(): void;
+    /** Findability (#31/#35): registra una búsqueda. `has_results` se deriva de `resultsCount`. */
+    trackSearch(query: string, resultsCount: number, params?: Record<string, unknown>): void;
+    /** Findability friction (#34/#35): señal de fricción con su `friction_topic`. */
+    trackFindabilityFriction(frictionTopic: string, params?: Record<string, unknown>): void;
+    /** Funnel: un paso del embudo, correlacionado por `taskId`. El backend reconstruye conversión/drop-off/tiempo. */
+    trackFunnelStep(funnel: string, step: string, taskId: string, params?: Record<string, unknown>): void;
+    /**
+     * Navegación MANUAL (entornos sin History API, p. ej. React Native con React Navigation).
+     * El host la llama en cada cambio de pantalla; emite `page_view` al salir de la anterior.
+     */
+    setScreen(name: string): void;
+    /** App a foreground (RN: AppState 'active'): reanuda el engagement time. */
+    onForeground(): void;
+    /**
+     * App a background (RN: AppState 'background'): cierra pantalla actual (page_view),
+     * mini-service (mini_service_exit), emite engagement y hace flush del lote.
+     */
+    onBackground(): void;
+    /** Payload que se ENVIARÍA al endpoint de analytics (no envía ni vacía el buffer). */
+    previewAnalytics(): AnalyticsEnvelope;
+    /** Envía (hoy dry-run → console.log) el lote acumulado de analytics y vacía el buffer. */
+    flushAnalytics(): void;
+    /** Emite un evento `user_engagement` con el tiempo activo acumulado (#8). */
+    private flushEngagement;
+    private analyticsIdentity;
+    /** Flush automático al ocultar/cerrar la página (no perder el lote pendiente). */
+    private setupAnalyticsFlush;
     /** Enable auto-launch functionality with configured triggers */
     autoLaunch(): void;
     /** Inicia los triggers configurados */
     private startTriggers;
-    /** Show a popup immediately (supports legacy ShowOptions and new PopupDefinition) */
-    show(options: PopupDefinition | {
-        surveyId: string;
-        productId: string;
-        data?: Record<string, unknown>;
-    }): void;
-    /** Mostrar popup por id de definición (usa surveyId interno) */
-    showByPopupId(popupId: string): void;
     /** Configure triggers for auto-launching popups (manual) */
     configureTriggers(triggers: TriggerConfig[]): void;
     /** Deriva triggers desde las definiciones de popup */
@@ -209,6 +470,8 @@ declare class DeepdotsPopups {
     private setDeferredExitQueue;
     /** Fetch al servidor para obtener popups */
     private fetchPopupsFromServer;
+    /** Envía los atributos de contact a la API (`POST /sdk/popups/contact`). */
+    private postContact;
     /** Notifica eventos de popup a la API */
     private postPopupEvent;
     /** Add an event listener */
@@ -245,4 +508,118 @@ declare class DeepdotsPopups {
     private validatePopupDefinitions;
 }
 
-export { type DeepdotsConfig, type DeepdotsEvent, type DeepdotsEventType, DeepdotsPopups, type EventListener, POPUP_TRIGGER_CONDITION_STATUSES, type PopupDefinition, type PopupTrigger, type PopupTriggerCondition, type PopupTriggerConditionStatus, type ShowOptions, type TriggerConfig };
+type EmitFn = (type: DeepdotsEventType, surveyId: string, data?: Record<string, unknown>) => void;
+/** Payload que recibe el host para montar el WebView del survey. */
+interface ReactNativeSurveyPayload {
+    surveyId: string;
+    productId: string;
+    /** HTML autocontenido para `<WebView source={{ html }}>`. */
+    html: string;
+}
+interface ReactNativeRendererOptions {
+    /** Se llama al mostrar un popup: monta el WebView con `payload.html`. */
+    onShow?: (payload: ReactNativeSurveyPayload) => void;
+    /** Se llama al cerrar el popup: desmonta el WebView. */
+    onHide?: () => void;
+}
+/**
+ * Renderer de React Native: el SDK no puede pintar componentes RN, así que entrega el
+ * HTML del survey al host (que lo monta en `react-native-webview`) y traduce los
+ * mensajes del WebView a eventos de popup del SDK (→ `POST /sdk/popups`, Messaging #18–22).
+ *
+ * Uso:
+ * ```tsx
+ * const renderer = new ReactNativePopupRenderer({
+ *   onShow: (p) => setSurvey({ ...p, visible: true }),
+ *   onHide: () => setSurvey((s) => ({ ...s, visible: false })),
+ * });
+ * sdk.setRenderer(renderer);
+ * // …
+ * <WebView source={{ html: survey.html }}
+ *          onMessage={(e) => renderer.handleMessage(e.nativeEvent.data)} />
+ * ```
+ */
+declare class ReactNativePopupRenderer implements PopupRenderer {
+    private options;
+    private emitFn;
+    private onCloseFn;
+    private currentSurveyId;
+    private partialEmitted;
+    constructor(options?: ReactNativeRendererOptions);
+    init(): void;
+    show(surveyId: string, productId: string, _actions: PopupActions | undefined, emit: EmitFn, onClose: () => void, env?: string, userId?: string, _style?: PopupStyle, sessionId?: string, miniService?: string, analyticsFeedbackSessionId?: string): void;
+    hide(): void;
+    /**
+     * El host la conecta al `onMessage` del WebView. Traduce los mensajes del survey a
+     * eventos del SDK: primera interacción → `popup_clicked` (PARTIAL), completado →
+     * `survey_completed` (COMPLETED) y cierra el popup.
+     */
+    handleMessage(raw: string): void;
+}
+
+/**
+ * Construye un HTML autocontenido que renderiza el survey de `@magicfeedback/native`
+ * dentro de un WebView (React Native). Carga el bundle desde CDN, crea el form con la
+ * identidad inyectada (`profile`/`metadata`) y reenvía los eventos del survey al host
+ * vía el puente de react-native-webview: `window.ReactNativeWebView.postMessage`.
+ *
+ * Mensajes emitidos (JSON `{name, payload}`): `loaded`, `before_submit`, `after_submit`,
+ * `survey_completed`, `back`, `popup_close`.
+ */
+interface BuildSurveyHtmlOptions {
+    surveyId: string;
+    productId: string;
+    env?: string;
+    profile?: IdentityAnswer[];
+    metadata?: IdentityAnswer[];
+    version?: string;
+}
+declare function buildSurveyHtml(opts: BuildSurveyHtmlOptions): string;
+
+/**
+ * Auto-wiring de React Native: concentra TODA la configuración en el SDK para que el
+ * host solo tenga que envolver su app en un `<DeepdotsProvider config={...}>`.
+ *
+ * No importa React ni librerías nativas: el host (o el Provider) le pasa los módulos
+ * nativos que tenga instalados (MMKV, device-info, AppState). Todo es opcional y degrada
+ * con elegancia (sin MMKV → in-memory; sin device-info → sin device info).
+ */
+
+/** Forma mínima de `react-native-mmkv` (instancia MMKV). */
+interface MmkvLike {
+    getString(key: string): string | undefined | null;
+    set(key: string, value: string): void;
+    delete(key: string): void;
+}
+/** Forma mínima de `react-native-device-info`. */
+interface DeviceInfoLike {
+    isTablet?: () => boolean;
+    getSystemVersion?: () => string;
+    getDeviceId?: () => string;
+    getVersion?: () => string;
+}
+/** Forma mínima de `AppState` de react-native. */
+interface AppStateLike {
+    addEventListener(type: 'change', listener: (state: string) => void): {
+        remove: () => void;
+    } | void;
+}
+interface ReactNativeSetupDeps {
+    mmkv?: MmkvLike | null;
+    deviceInfo?: DeviceInfoLike | null;
+    appState?: AppStateLike | null;
+    platform?: 'web' | 'android' | 'ios';
+    renderer?: PopupRenderer;
+}
+/** Adaptador KeyValueStorage (síncrono) sobre una instancia de MMKV. */
+declare function mmkvStorage(mmkv: MmkvLike): KeyValueStorage;
+/** Recoge device info desde react-native-device-info (Technology #11–13). */
+declare function collectRnDevice(d: DeviceInfoLike): DeviceInfo;
+/**
+ * Configura el SDK para React Native en una sola llamada: storage persistente (MMKV),
+ * device info, platform, init y lifecycle (AppState → onForeground/onBackground).
+ * Devuelve una función de limpieza (quita el listener de AppState).
+ */
+declare function setupReactNative(sdk: DeepdotsPopups, config: DeepdotsInitParams, deps?: ReactNativeSetupDeps): () => void;
+
+export { type AnalyticsFeedbackBody, type AnalyticsKeys, type AppStateLike, BrowserPopupRenderer, type ContactAttributeValue, type ContactAttributes, type ContactBody, ContactManager, type DeepdotsConfig, type DeepdotsEvent, type DeepdotsEventType, DeepdotsPopups, type DeviceInfo, type DeviceInfoLike, type EventListener, type FeedbackKV, InMemoryStorage, type KeyValueStorage, type MmkvLike, NoopPopupRenderer, POPUP_TRIGGER_CONDITION_STATUSES, type PopupDefinition, type PopupRenderer, type PopupTrigger, type PopupTriggerCondition, type PopupTriggerConditionStatus, ReactNativePopupRenderer, type ReactNativeRendererOptions, type ReactNativeSetupDeps, type ReactNativeSurveyPayload, type TriggerConfig, buildAnalyticsFeedbackBody, buildSurveyHtml, collectRnDevice, createDefaultRenderer, createFeedbackSink, mmkvStorage, setupReactNative };