apps-sdk 1.1.58 → 1.1.60

package/SDK_GUIDELINES.md

@@ -0,0 +1,386 @@
+# SDK Guidelines para Agentes IA
+
+## Arquitectura
+
+SDK monolítico para React Native/Expo que centraliza funcionalidades core de aplicaciones móviles. No es multi-plataforma aún (planificado). Estructura singleton con módulos especializados.
+
+## Punto de Entrada
+
+```javascript
+import SDK from 'apps-sdk';
+await SDK.session.init();
+```
+
+**Inicialización obligatoria**: `SDK.session.init()` debe ejecutarse al inicio de la app. Configura:
+- Estructura de sesión con datos de device/app
+- UserID persistente
+- Endpoints desde backend
+- Configuración de tracking y eventos
+- Validación de suscripción
+
+## Módulos Core
+
+### Session (`SDK.session`)
+Gestión de sesión, datos de usuario y configuración global.
+
+**Responsabilidades**:
+- Generar y mantener sessionID
+- Almacenar datos de device (modelo, OS, versión)
+- Gestionar userID persistente
+- Detectar first_open
+- Estado de suscripción
+- Configuración de idioma/región
+
+**Flujo típico**:
+```javascript
+await SDK.session.init();
+const userID = SDK.session.getUserID();
+const isSubscribed = SDK.session.getIsSubscribed();
+const deviceLang = SDK.session.getDeviceLanguage();
+```
+
+**sessionData estructura**:
+```javascript
+{
+  user_id: string,
+  isFirstOpen: boolean,
+  app: { shortVersion, package, languageCode, regionCode, buildVersionNumber },
+  device: { name, systemName, systemVersion, model },
+  adjust: { attribution_id, idfa, googleAdid, attribution },
+  lang: string,
+  package: string
+}
+```
+
+### Storage (`SDK.storage`)
+Persistencia local con AsyncStorage + FileSystem de Expo.
+
+**Patrones de uso**:
+```javascript
+// Datos JSON simples
+await SDK.storage.storeData(key, value);
+const data = await SDK.storage.getData(key);
+await SDK.storage.removeData(key);
+
+// Imágenes en galería
+await SDK.storage.handleDownloadImageToGallery(imageUri);
+
+// Sistema de archivos (creations)
+await SDK.storage.handleDownloadImageToCreations(base64, fileName, metadata);
+const creations = await SDK.storage.getCreations();
+await SDK.storage.deleteCreation(dirName);
+
+// Compresión automática
+const compressed = await SDK.storage.compressImage(imageUri, maxSizeMB);
+
+// Compartir archivos
+await SDK.storage.handleShareFile(fileUri);
+```
+
+**Directorios**:
+- `${FileSystem.documentDirectory}/creations` - Almacenamiento persistente
+- `${FileSystem.documentDirectory}/tmp` - Temporal (se limpia con `deleteTempFiles()`)
+
+**Permisos**: Gestiona permisos de galería automáticamente, solicitándolos cuando sea necesario.
+
+### Networking (`SDK.networking`)
+Comunicación HTTP con backend. Todas las peticiones incluyen `sessionData` automáticamente.
+
+**Request unificado**:
+```javascript
+const response = await SDK.networking.request(url, data);
+```
+
+**Sistema de eventos**:
+```javascript
+await SDK.networking.sendEvent(eventType, eventKeyword, eventData);
+// eventType: 'action', 'screen', 'other'
+// Se envía a tracking (Adjust) automáticamente
+```
+
+**Eventos especiales**: Primera ocurrencia de eventos se trackea con prefijo `first_` (ej: `first_paywall_shown`).
+
+**Pending Events**: Cola para eventos que no pueden enviarse de inmediato:
+```javascript
+SDK.networking.addPendingEvent({ eventType, eventKeyword, eventData });
+SDK.networking.sendPendingEvents();
+```
+
+**Configuración dinámica**: `executeInit()` carga desde backend:
+- Endpoints (`config.ENDPOINTS`)
+- Eventos de tracking (`config.EVENTS`)
+- Configuración de paywall (`config.PAYWALL_DATA`)
+- Forced update check
+- Quick actions
+- Compresión de imágenes
+
+### Utils (`SDK.utils`)
+Funciones auxiliares:
+```javascript
+SDK.utils.isBase64(str);
+SDK.utils.isBase64Image(str);
+SDK.utils.isSpecialEvent(eventKeyword);
+```
+
+## Integraciones de Analytics
+
+### Adjust (`SDK.adjust`)
+Attribution y tracking de instalación.
+
+```javascript
+await SDK.adjust.initialize(adjustToken, sendAttributionToAdapty);
+SDK.adjust.trackEventIfExist(eventKeyword, eventValue);
+await SDK.adjust.getAttribution();
+await SDK.adjust.getIdfa(); // iOS
+await SDK.adjust.getGoogleAdId(); // Android
+```
+
+**Integración con Session**: Attribution data se almacena en `sessionData.adjust`.
+
+### MixPanel (`SDK.mixpanel`)
+Analytics de comportamiento.
+
+```javascript
+await SDK.mixpanel.initialize(token, trackAutomaticEvents, useNative, devMode);
+await SDK.mixpanel.trackEvent(event, properties);
+await SDK.mixpanel.identifyUser(userID);
+await SDK.mixpanel.superProperties({ plan_type: 'premium' });
+```
+
+**Super Properties**: Propiedades globales que se envían con todos los eventos.
+
+### Facebook (`SDK.facebook`)
+Facebook Analytics.
+
+```javascript
+await SDK.facebook.initialize(appId, clientToken, debugMode, devMode);
+await SDK.facebook.trackEvent(eventName, properties);
+await SDK.facebook.trackPurchase(amount, currency);
+await SDK.facebook.trackStartTrial();
+```
+
+## Sistema de Paywall
+
+### Adapty (`SDK.adapty`)
+Gestión de suscripciones y paywalls.
+
+```javascript
+await SDK.adapty.initialize(apiKey);
+await SDK.adapty.showPaywall(placementID, lang, eventHandlers);
+const profile = await SDK.adapty.getProfile();
+await SDK.adapty.updateAdjustAttributionData(attribution);
+```
+
+**Event Handlers**:
+```javascript
+{
+  onPurchaseCompleted: (result, product) => {},
+  onPurchaseFailed: (error) => {},
+  onRestoreCompleted: (profile) => {},
+  onCloseButtonPress: () => {}
+}
+```
+
+**Onboarding**:
+```javascript
+await SDK.adapty.showOnboarding(placementID, lang, eventHandlers);
+```
+
+### PayWall Component (`SDK.paywall`)
+Componente React para paywalls custom.
+
+```jsx
+<SDK.paywall
+  visible={true}
+  onClose={() => {}}
+  type="subscription"
+  keyword="premium_monthly"
+/>
+```
+
+### PayWallLogic (`SDK.paywallLogic`)
+Lógica de compra con react-native-iap (legacy, usar Adapty).
+
+## Funcionalidades Específicas
+
+### Notifications (`SDK.notifications`)
+Push notifications con Expo Notifications.
+
+```javascript
+await SDK.initializePushNotifications(); // Retorna expo token
+const status = await SDK.getPushNotificationsStatus();
+```
+
+**Token se envía automáticamente** al backend en `initializePushNotifications()`.
+
+### Rating (`SDK.rating`)
+Sistema de reviews.
+
+```javascript
+await SDK.rating.showRatingDialog(force);
+```
+
+### Voice (`SDK.voice`)
+Speech-to-text y text-to-speech.
+
+```javascript
+// Speech-to-text
+await SDK.voice.startRecognizing(
+  onSpeechStart,
+  onSpeechRecognized,
+  onSpeechResults,
+  onInactivityTimeout,
+  inactivitySeconds
+);
+await SDK.voice.stopRecognizing();
+
+// Text-to-speech
+SDK.voice.speak(message, language, voice, onStart, onDone, onError);
+await SDK.voice.stopSpeaking();
+```
+
+### TrackingTransparency (`SDK.tracking`)
+ATT para iOS.
+
+```javascript
+const status = await SDK.tracking.requestTrackingTransparencyPermission();
+const idfa = await SDK.tracking.getAdvertisingIdentifier();
+```
+
+**Almacenamiento automático**: El estado se guarda en `TRACKING_PERMISSION` y actualiza `config.TRACKING_ACTIVE`.
+
+### HomeActions (`SDK.homeActions`)
+Quick Actions (iOS/Android shortcuts).
+
+```javascript
+await SDK.homeActions.setItems(quickActionsArray);
+await SDK.homeActions.itemCallback(callbackFunction);
+```
+
+## Configuración Global
+
+### config.js
+Variables globales del SDK:
+
+```javascript
+config.DEBUG_MODE = true/false;
+config.TRACKING_ACTIVE = true/false;
+config.FORCED_UPDATE = true/false;
+config.ENDPOINTS = { CONFIG, EVENTS_PUSH, SUB_STATUS, ... };
+config.EVENTS = { eventKeyword: eventToken };
+config.EVENTS_MIXPANEL = { eventKeyword: eventName };
+config.PAYWALL_DATA = { actions, scenes, others, products };
+config.CONFIG_EXTRA = {}; // Configuración custom desde backend
+config.QUICK_ACTIONS = []; // Quick actions desde backend
+config.IMAGE_COMPRESSION = { ACTIVE, COMPRESSION, WIDTH };
+config.EVENT_TYPES = { ACTION: 'action', SCREEN: 'screen', OTHER: 'other' };
+```
+
+## Principios de Diseño
+
+1. **Singleton Pattern**: Todos los módulos son instancias singleton exportadas directamente
+2. **Auto-inicialización**: Módulos se inicializan en importación cuando sea posible
+3. **sessionData global**: Todas las peticiones incluyen sessionData automáticamente
+4. **Persistencia transparente**: Storage abstrae AsyncStorage para uso sencillo
+5. **Error handling silencioso**: Logs en consola, no crashes
+6. **Permission management**: Gestión automática de permisos con fallback a settings
+
+## Convenciones
+
+- **Async/await**: Todas las operaciones I/O usan async/await
+- **Console logs condicionales**: `config.DEBUG_MODE && console.debug(...)`
+- **Naming**: camelCase para métodos, UPPER_CASE para constantes globales
+- **Return values**: null en caso de error, throw solo cuando sea crítico
+- **Storage keys**: Snake_case en mayúsculas (ej: `TRACKING_PERMISSION`)
+- **Event naming**: snake_case en minúsculas (ej: `first_open`, `paywall_shown`)
+
+## Dependencias Críticas
+
+```json
+{
+  "@react-native-async-storage/async-storage": "Persistencia",
+  "expo-file-system": "Sistema de archivos",
+  "expo-media-library": "Galería",
+  "expo-notifications": "Push notifications",
+  "expo-constants": "App metadata",
+  "expo-device": "Device info",
+  "react-native-adapty": "Suscripciones",
+  "react-native-adjust": "Attribution",
+  "mixpanel-react-native": "Analytics",
+  "react-native-fbsdk-next": "Facebook",
+  "@react-native-voice/voice": "Speech",
+  "expo-tracking-transparency": "ATT iOS",
+  "react-native-iap": "IAP legacy",
+  "semver": "Version comparison"
+}
+```
+
+## Flujo de Inicialización Típico
+
+```javascript
+// 1. Inicializar SDK
+await SDK.session.init();
+
+// 2. Configurar tracking (si necesario)
+const trackingStatus = await SDK.tracking.requestTrackingTransparencyPermission();
+await SDK.storage.setTrackingPermissionGranted(trackingStatus === 'authorized');
+
+// 3. Inicializar analytics
+await SDK.adjust.initialize(ADJUST_TOKEN, true);
+await SDK.mixpanel.initialize(MIXPANEL_TOKEN);
+await SDK.facebook.initialize(FB_APP_ID, FB_CLIENT_TOKEN);
+
+// 4. Inicializar monetización
+await SDK.adapty.initialize(ADAPTY_KEY);
+await SDK.adapty.setAdjustIntegrationIdentifier(adjustIntegrationID);
+await SDK.adapty.setMixpanelIntegrationIdentifier(mixpanelDistinctID);
+
+// 5. Setup notifications
+const expoToken = await SDK.initializePushNotifications();
+
+// 6. Limpiar temporal
+await SDK.storage.deleteTempFiles();
+
+// 7. Verificar suscripción cada 24h
+await SDK.session.checkSubscription24h();
+```
+
+## TypeScript Support
+
+Definiciones completas en `types/index.d.ts`. Todos los módulos y métodos están tipados.
+
+## Debugging
+
+```javascript
+// Console override automático con timestamps
+SDK.sobrescribeConsole(); // Ya ejecutado en constructor
+
+// Ver todas las claves de AsyncStorage
+await SDK.storage.printAllKeys();
+
+// Limpiar todo AsyncStorage
+await SDK.storage.removeAllKeys();
+
+// Verificar endpoints cargados
+const endpoints = await SDK.networking.getEndpoints();
+
+// Ver configuración extra del backend
+const config = SDK.networking.getConfigExtra();
+```
+
+## Limitaciones Conocidas
+
+- **Solo Expo/React Native**: No funciona en web ni otras plataformas
+- **Backend dependency**: Requiere endpoints configurados para init
+- **Singleton limitations**: No soporta múltiples instancias
+- **No lazy loading**: Todos los módulos se cargan al importar
+- **AsyncStorage limits**: No usar para datos grandes (>6MB)
+
+## Migración a Arquitectura Multi-plataforma (Futuro)
+
+Estructura planificada con adaptadores:
+- `@apps-sdk/core`: Lógica compartida
+- `@apps-sdk/expo`: Adaptadores React Native/Expo
+- `@apps-sdk/web`: Adaptadores Web (localStorage, Canvas, etc)
+
+Ver `EJEMPLO_USO_SDK.md` para detalles de arquitectura propuesta.

package/index.js

@@ -1,6 +1,5 @@
 import {NotificationsPush, Networking, Storage, Session, Utils, PayWallLogic, Rating, AdJust, TrackingTransparency, Voice, MixPanel, Adapty, HomeActions, Facebook} from "./src/libraries";
 import PayWall from "./src/components/PayWall";
-import AdaptyOnboarding from "./src/components/AdaptyOnboarding";
 
 class AppsSDK {
     constructor() {
@@ -57,7 +56,6 @@ export default {
     mixpanel:                    MixPanel,
     tracking:                    TrackingTransparency,
     paywall:                     PayWall,
-    adaptyOnboarding:            AdaptyOnboarding,
     notifications:               NotificationsPush,
     voice:                       Voice,
     adapty:                      Adapty,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "apps-sdk",
-  "version": "1.1.58",
+  "version": "1.1.60",
   "description": "Apps SDK",
   "main": "index.js",
   "scripts": {

package/src/libraries/Adapty.js

@@ -75,11 +75,14 @@ class Adapty {
                     onCustomAction: eventHandlers.onCustomAction || (() => {  }),
                 });
                 await paywallView.present();
+                return paywallView;
             } else {
                 console.warn('Error showing paywall: paywall not found for placement', placementID, 'and language', lang);
+                return null;
             }
         } catch (error) {
             console.error('Error showing paywall:', error);
+            return null;
         }
     }
 

package/types/index.d.ts

@@ -158,22 +158,6 @@ declare module 'apps-sdk' {
 
     export class PayWall extends Component<PayWallProps, {}> {}
 
-    export interface AdaptyOnboardingProps {
-        visible: boolean;
-        placementID: string;
-        lang: string;
-        onCustom?: (actionId: string, meta: Record<string, any> | undefined, remoteConfig: Record<string, any> | null) => void;
-        onClose?: (actionId: string, meta: Record<string, any> | undefined, remoteConfig: Record<string, any> | null) => boolean;
-        onError?: (error: Error | any, remoteConfig: Record<string, any> | null) => boolean;
-        onRemoteConfigLoaded?: (remoteConfig: Record<string, any>) => void;
-        onAnalytics?: (event: any, data: any, remoteConfig: Record<string, any> | null) => void;
-        onPaywall?: (actionId: string, meta: Record<string, any> | undefined) => void;
-        onStateUpdated?: (action: any, meta: Record<string, any> | undefined, remoteConfig: Record<string, any> | null) => void;
-        onFinishedLoading?: (meta: Record<string, any> | undefined, remoteConfig: Record<string, any> | null) => void;
-    }
-
-    export class AdaptyOnboarding extends Component<AdaptyOnboardingProps, {}> {}
-
     export class PayWallLogic {
         initializePayWall(): Promise<void>;
         executePurchase(productID: string): Promise<void>;
@@ -294,7 +278,6 @@ declare module 'apps-sdk' {
         session             : Session;
         utils               : Utils;
         paywall             : PayWall;
-        adaptyOnboarding    : typeof AdaptyOnboarding;
         rating              : Rating;
         adjust              : AdJust;
         mixpanel            : MixPanel;

package/PLAN_SDK_UNIFICADO.md

@@ -1,319 +0,0 @@
-# Plan para Crear SDK Unificado (Expo + Web)
-
-## Objetivo
-Crear un SDK único que funcione tanto para aplicaciones Expo/React Native como para aplicaciones web (Next.js/React), maximizando la reutilización de código y manteniendo una API consistente.
-
-## Análisis del Estado Actual
-
-### Funcionalidades Existentes en SDK Expo
-- ✅ **Networking** - Gestión de APIs y comunicación con backend
-- ✅ **Storage** - Almacenamiento local y gestión de archivos/imágenes
-- ✅ **Session** - Gestión de sesión de usuario y datos del dispositivo
-- ✅ **Analytics** - MixPanel, Adjust, tracking de eventos
-- ✅ **Monetización** - Adapty, PayWall, suscripciones
-- ✅ **Notificaciones Push** - Expo notifications
-- ✅ **Utilidades** - Funciones helper, validaciones
-- ✅ **Voz** - Reconocimiento y síntesis de voz
-- ✅ **Rating** - Sistema de valoraciones
-- ✅ **Quick Actions** - Acciones rápidas del sistema
-- ✅ **Tracking Transparency** - Permisos de tracking iOS
-
-### Código Reutilizable para Web
-
-#### 🟢 Altamente Reutilizable (80-90%)
-- **Networking.js** - Lógica de APIs, fetch, gestión de eventos
-- **Session.js** - Gestión de sesión (adaptando detección de dispositivo)
-- **Utils.js** - Funciones helper, validaciones base64
-- **PayWallLogic.js** - Lógica de negocio de suscripciones
-- **MixPanel.js** - Analytics (con SDK web de MixPanel)
-- **AdJust.js** - Attribution (con SDK web de Adjust)
-
-#### 🟡 Parcialmente Reutilizable (40-60%)
-- **Storage.js** - Lógica de almacenamiento (localStorage/IndexedDB vs AsyncStorage)
-- **Adapty.js** - Monetización (con adaptaciones para web)
-- **Notifications.js** - Web Push API vs Expo notifications
-
-#### 🔴 No Reutilizable Directamente
-- **Voice.js** - Requiere Web Speech API
-- **TrackingTransparency.js** - Específico de iOS
-- **QuickActions.js** - Específico de móvil
-- **Rating.js** - Requiere implementación web custom
-
-## Arquitectura Propuesta
-
-### Estructura del Proyecto
-```
-apps-sdk-unified/
-├── packages/
-│   ├── core/                    # Lógica compartida
-│   │   ├── src/
-│   │   │   ├── networking/
-│   │   │   ├── session/
-│   │   │   ├── analytics/
-│   │   │   ├── monetization/
-│   │   │   ├── utils/
-│   │   │   └── types/
-│   │   ├── package.json
-│   │   └── tsconfig.json
-│   ├── expo/                    # Adaptadores Expo
-│   │   ├── src/
-│   │   │   ├── adapters/
-│   │   │   ├── components/
-│   │   │   └── index.ts
-│   │   ├── package.json
-│   │   └── tsconfig.json
-│   ├── web/                     # Adaptadores Web
-│   │   ├── src/
-│   │   │   ├── adapters/
-│   │   │   ├── components/
-│   │   │   └── index.ts
-│   │   ├── package.json
-│   │   └── tsconfig.json
-│   └── shared/                  # Tipos y utilidades compartidas
-│       ├── src/
-│       │   ├── types/
-│       │   └── constants/
-│       ├── package.json
-│       └── tsconfig.json
-├── tools/
-│   ├── build/
-│   └── scripts/
-├── docs/
-├── examples/
-│   ├── expo-example/
-│   └── web-example/
-├── package.json
-├── lerna.json
-└── tsconfig.json
-```
-
-## Plan de Implementación
-
-### Fase 1: Preparación y Core (Semanas 1-2)
-
-#### 1.1 Configuración del Monorepo
-- [ ] Configurar Lerna/Nx para gestión de monorepo
-- [ ] Configurar TypeScript workspace
-- [ ] Configurar ESLint y Prettier compartidos
-- [ ] Configurar scripts de build y testing
-
-#### 1.2 Extracción del Core
-- [ ] Crear package `@apps-sdk/core`
-- [ ] Migrar lógica de negocio compartida:
-  - [ ] Networking (sin dependencias de React Native)
-  - [ ] Session management (abstracto)
-  - [ ] Utils y validaciones
-  - [ ] Constantes y configuración
-- [ ] Definir interfaces y tipos compartidos
-- [ ] Crear sistema de adaptadores (Strategy Pattern)
-
-#### 1.3 Definición de Interfaces
-```typescript
-// Ejemplo de interfaz para adaptadores
-interface StorageAdapter {
-  setItem(key: string, value: string): Promise<void>;
-  getItem(key: string): Promise<string | null>;
-  removeItem(key: string): Promise<void>;
-  clear(): Promise<void>;
-}
-
-interface DeviceAdapter {
-  getDeviceInfo(): DeviceInfo;
-  getLanguage(): string;
-  getPlatform(): 'ios' | 'android' | 'web';
-}
-```
-
-### Fase 2: Adaptadores Expo (Semanas 3-4)
-
-#### 2.1 Package Expo
-- [ ] Crear `@apps-sdk/expo`
-- [ ] Implementar adaptadores específicos de Expo:
-  - [ ] StorageAdapter (AsyncStorage)
-  - [ ] DeviceAdapter (expo-device, expo-constants)
-  - [ ] NotificationAdapter (expo-notifications)
-  - [ ] VoiceAdapter (@react-native-voice/voice)
-  - [ ] FileSystemAdapter (expo-file-system)
-
-#### 2.2 Componentes Expo
-- [ ] Migrar PayWall component
-- [ ] Adaptar para nueva arquitectura
-- [ ] Mantener compatibilidad con API actual
-
-#### 2.3 Testing Expo
-- [ ] Configurar Jest para React Native
-- [ ] Tests unitarios para adaptadores
-- [ ] Tests de integración
-
-### Fase 3: Adaptadores Web (Semanas 5-6)
-
-#### 3.1 Package Web
-- [ ] Crear `@apps-sdk/web`
-- [ ] Implementar adaptadores web:
-  - [ ] StorageAdapter (localStorage/sessionStorage/IndexedDB)
-  - [ ] DeviceAdapter (navigator APIs)
-  - [ ] NotificationAdapter (Web Push API)
-  - [ ] VoiceAdapter (Web Speech API)
-  - [ ] FileSystemAdapter (File API)
-
-#### 3.2 Componentes Web
-- [ ] Crear PayWall component para React/Next.js
-- [ ] Implementar rating system para web
-- [ ] Crear equivalentes web de funcionalidades móviles
-
-#### 3.3 Librerías Web Específicas
-```json
-{
-  "dependencies": {
-    "mixpanel-browser": "^2.47.0",
-    "@adjust/web-sdk": "^5.7.0",
-    "idb": "^7.1.1",
-    "js-cookie": "^3.0.5"
-  }
-}
-```
-
-### Fase 4: Analytics y Monetización (Semanas 7-8)
-
-#### 4.1 Analytics Unificados
-- [ ] Adaptar MixPanel para ambas plataformas
-- [ ] Adaptar Adjust para web
-- [ ] Crear sistema de eventos unificado
-- [ ] Implementar queue de eventos offline
-
-#### 4.2 Monetización
-- [ ] Investigar Adapty Web SDK
-- [ ] Implementar alternativas web (Stripe, PayPal)
-- [ ] Crear interfaz unificada de pagos
-- [ ] Adaptar lógica de suscripciones
-
-### Fase 5: Testing y Documentación (Semanas 9-10)
-
-#### 5.1 Testing Integral
-- [ ] Tests unitarios para todos los packages
-- [ ] Tests de integración cross-platform
-- [ ] Tests E2E con ejemplos
-- [ ] Performance testing
-
-#### 5.2 Documentación
-- [ ] API documentation
-- [ ] Migration guide desde SDK actual
-- [ ] Ejemplos de uso
-- [ ] Best practices
-
-#### 5.3 Ejemplos
-- [ ] App Expo de ejemplo
-- [ ] App Next.js de ejemplo
-- [ ] Casos de uso comunes
-
-### Fase 6: Migración y Deploy (Semanas 11-12)
-
-#### 6.1 Migración Gradual
-- [ ] Crear herramientas de migración
-- [ ] Backward compatibility layer
-- [ ] Deprecation warnings
-- [ ] Migration scripts
-
-#### 6.2 CI/CD
-- [ ] Configurar GitHub Actions/GitLab CI
-- [ ] Automated testing
-- [ ] Automated publishing a npm
-- [ ] Semantic versioning
-
-#### 6.3 Release
-- [ ] Alpha release para testing interno
-- [ ] Beta release para early adopters
-- [ ] Stable release
-- [ ] Post-release monitoring
-
-## Consideraciones Técnicas
-
-### Gestión de Dependencias
-```json
-{
-  "peerDependencies": {
-    "react": ">=16.8.0",
-    "react-native": ">=0.60.0" // Solo para package expo
-  },
-  "optionalDependencies": {
-    "expo": ">=45.0.0" // Solo si se usa Expo
-  }
-}
-```
-
-### Tree Shaking y Bundle Size
-- Configurar builds optimizados para cada plataforma
-- Lazy loading de módulos pesados
-- Conditional imports basados en plataforma
-
-### Versionado
-- Semantic versioning para todos los packages
-- Synchronized releases
-- Changelog automatizado
-
-## Riesgos y Mitigaciones
-
-### Riesgos Identificados
-1. **Complejidad de mantenimiento** - Mitigar con buena arquitectura y testing
-2. **Bundle size** - Mitigar con tree shaking y lazy loading
-3. **Breaking changes** - Mitigar con versionado semántico y deprecation warnings
-4. **Platform-specific bugs** - Mitigar with comprehensive testing
-
-### Plan de Contingencia
-- Mantener SDK Expo actual como fallback
-- Implementación gradual por módulos
-- Rollback strategy para cada fase
-
-## Métricas de Éxito
-
-### Técnicas
-- [ ] 90%+ de cobertura de tests
-- [ ] Bundle size < 50KB para web
-- [ ] Performance similar o mejor que SDK actual
-- [ ] Zero breaking changes en migración
-
-### Negocio
-- [ ] Reducción 50% tiempo de desarrollo de nuevas features
-- [ ] Adopción 80%+ en proyectos existentes
-- [ ] Feedback positivo de desarrolladores
-- [ ] Mantenimiento más eficiente
-
-## Timeline Estimado
-
-| Fase | Duración | Entregables |
-|------|----------|-------------|
-| 1 | 2 semanas | Core setup, monorepo |
-| 2 | 2 semanas | Expo adapters |
-| 3 | 2 semanas | Web adapters |
-| 4 | 2 semanas | Analytics & monetization |
-| 5 | 2 semanas | Testing & docs |
-| 6 | 2 semanas | Migration & release |
-
-**Total: 12 semanas (3 meses)**
-
-## Recursos Necesarios
-
-### Equipo
-- 1 Senior Developer (lead)
-- 1 Frontend Developer (web specialist)
-- 1 Mobile Developer (Expo specialist)
-- 1 QA Engineer (testing)
-
-### Herramientas
-- Lerna/Nx para monorepo
-- TypeScript
-- Jest para testing
-- GitHub Actions para CI/CD
-- Storybook para component documentation
-
-## Próximos Pasos Inmediatos
-
-1. **Validar el plan** con stakeholders
-2. **Configurar el monorepo** básico
-3. **Crear POC** con un módulo simple (Utils)
-4. **Definir APIs finales** para adaptadores
-5. **Comenzar migración** del core
-
----
-
-*Este plan está sujeto a revisiones basadas en feedback y descubrimientos durante la implementación.*

package/src/components/AdaptyOnboarding.js

@@ -1,217 +0,0 @@
-import React from 'react';
-import { Modal } from 'react-native';
-import { AdaptyOnboardingView } from 'react-native-adapty/dist/ui';
-import { View } from "react-native";
-import Adapty from '../libraries/Adapty';
-import * as config from '../../config';
-
-class AdaptyOnboarding extends React.Component {
-    constructor(props) {
-        super(props);
-        this.state = {
-            onboarding: null,
-            isLoading: true,
-        };
-        this.remoteConfig = null;
-        this.termsAccepted = false;
-        this.currentStep = 0;
-        this.totalSteps = 0;
-    }
-
-    componentDidMount() {
-        const { placementID, lang } = this.props;
-        this.loadOnboarding(placementID, lang);
-    }
-
-    async componentDidUpdate(prevProps) {
-        if (this.props.visible && !prevProps.visible) {
-            const { placementID, lang } = this.props;
-            await this.loadOnboarding(placementID, lang);
-        }
-    }
-
-    loadOnboarding = async (placementID, lang) => {
-        try {
-            this.setState({ isLoading: true });
-            const onboarding = await Adapty.getOnboardingForPlacement(placementID, lang);
-            
-            if (onboarding) {
-                this.remoteConfig = onboarding.remoteConfig || {};
-                
-                if (this.props.onRemoteConfigLoaded && this.remoteConfig) {
-                    config.DEBUG_MODE && console.log('Remote config loaded:', this.remoteConfig);
-                    this.props.onRemoteConfigLoaded(this.remoteConfig);
-                }
-                
-                this.setState({ onboarding, isLoading: false });
-            } else {
-                console.log('Onboarding not found for placement:', placementID, 'and language:', lang);
-                this.setState({ isLoading: false });
-                if (this.props.onError) {
-                    this.props.onError(new Error('Onboarding not found'), this.remoteConfig);
-                }
-            }
-        } catch (error) {
-            console.log('Error loading onboarding:', error);
-            this.setState({ isLoading: false });
-            if (this.props.onError) {
-                this.props.onError(error, this.remoteConfig);
-            }
-        }
-    }
-
-    //  --------------------------------------- Event Handlers ---------------------------------------
-    handleCustom = (actionId, meta) => {
-        config.DEBUG_MODE && console.log('Onboarding custom action:', actionId, meta);
-        
-        if (actionId === 'accept_terms') {
-            this.termsAccepted = true;
-            config.DEBUG_MODE && console.log('Terms accepted');
-        }
-        
-        if (this.props.onCustom) {
-            this.props.onCustom(actionId, meta, this.remoteConfig);
-        }
-    }
-
-    handleClose = (actionId, meta) => {
-        const isLastStep = this.totalSteps > 0 && this.currentStep === this.totalSteps - 1;
-        const canClose = this.termsAccepted && isLastStep;
-        
-        config.DEBUG_MODE && console.log('Onboarding close attempt:', {
-            actionId,
-            meta,
-            termsAccepted: this.termsAccepted,
-            currentStep: this.currentStep,
-            totalSteps: this.totalSteps,
-            isLastStep,
-            canClose
-        });
-        
-        if (!canClose) {
-            config.DEBUG_MODE && console.log('Close prevented');
-            return false;
-        }
-        
-        config.DEBUG_MODE && console.log('Close allowed');
-        
-        if (this.props.onClose) {
-            this.props.onClose(actionId, meta, this.remoteConfig);
-        }
-        
-        this.termsAccepted = false;
-        this.currentStep = 0;
-        this.totalSteps = 0;
-        
-        return true;
-    }
-
-    handleStateUpdated = (action, meta) => {
-        if (meta && typeof meta === 'object') {
-            this.currentStep = meta.screen_index ?? this.currentStep;
-            this.totalSteps = meta.total_screens ?? this.totalSteps;
-            
-            config.DEBUG_MODE && console.log('State updated:', {
-                action,
-                meta,
-                currentStep: this.currentStep,
-                totalSteps: this.totalSteps,
-                termsAccepted: this.termsAccepted
-            });
-        }
-        
-        if (this.props.onStateUpdated) {
-            this.props.onStateUpdated(action, meta, this.remoteConfig);
-        }
-    }
-
-    handleError = (error) => {
-        console.log('Onboarding error:', error);
-        
-        if (this.props.onError) {
-            this.props.onError(error, this.remoteConfig);
-        }
-        return true;
-    }
-
-    handleAnalytics = (event, data) => {
-        config.DEBUG_MODE && console.log('Onboarding analytics:', event, data);
-        
-        if (this.props.onAnalytics) {
-            this.props.onAnalytics(event, data, this.remoteConfig);
-        }
-    }
-
-    handlePaywall = (actionId, meta) => {
-        config.DEBUG_MODE && console.log('Onboarding paywall:', actionId, meta);
-        
-        if (this.props.onPaywall) {
-            this.props.onPaywall(this.remoteConfig);
-        }
-    }
-
-    handleFinishedLoading = (meta) => {
-        config.DEBUG_MODE && console.log('Onboarding finished loading', meta);
-        
-        if (this.props.onFinishedLoading) {
-            this.props.onFinishedLoading(meta, this.remoteConfig);
-        }
-    }
-    //  --------------------------------------- Event Handlers ---------------------------------------
-
-    render() {
-        const { visible } = this.props;
-        const { onboarding, isLoading } = this.state;
-
-        if (!visible) {
-            return null;
-        }
-
-        const content = (
-            <View style={styles.container}>
-                {!isLoading && onboarding ? (
-                    <AdaptyOnboardingView
-                        onboarding={onboarding}
-                        style={styles.onboardingView}
-                        eventHandlers={{
-                            onAnalytics: this.handleAnalytics,
-                            onClose: this.handleClose,
-                            onCustom: this.handleCustom,
-                            onPaywall: this.handlePaywall,
-                            onStateUpdated: this.handleStateUpdated,
-                            onFinishedLoading: this.handleFinishedLoading,
-                            onError: this.handleError,
-                        }}
-                    />
-                ) : null}
-            </View>
-        );
-
-        return (
-            <Modal
-                visible={visible}
-                animationType="slide"
-                presentationStyle="fullScreen"
-                onRequestClose={() => {
-                    config.DEBUG_MODE && console.log('Modal onRequestClose prevented');
-                    return false;
-                }}
-            >
-                {content}
-            </Modal>
-        );
-    }
-}
-
-const styles = {
-    container: {
-        backgroundColor: '#000',
-        width: '100%',
-        height: '100%',
-    },
-    onboardingView: {
-        flex: 1,
-    },
-}
-
-export default AdaptyOnboarding;