apps-sdk 1.1.73 → 1.1.75

package/EJEMPLO_USO_SDK.md

@@ -279,3 +279,187 @@ npm install @apps-sdk/core @apps-sdk/expo @apps-sdk/web
 ```
 
 Esta arquitectura permite que el 90% del código de tu aplicación sea idéntico entre plataformas, mientras que las diferencias específicas se manejan transparentemente en los adaptadores.
+
+## 📄 Módulo Legal - Obtener Textos Legales
+
+### Uso Básico
+
+```javascript
+import SDK from 'apps-sdk';
+
+// Obtener términos y condiciones en español
+const response = await SDK.legal.getLegalText('chatconnect-ios-app', 'tc', 'es');
+
+// Obtener política de privacidad en inglés
+const response = await SDK.legal.getLegalText('chatconnect-ios-app', 'privacy_policy', 'en');
+
+// Obtener política de reembolso en francés
+const response = await SDK.legal.getLegalText('chatconnect-ios-app', 'refund_policy', 'fr');
+```
+
+### Tipos de Documentos Disponibles
+
+| Tipo | Descripción |
+|------|-------------|
+| `'tc'` | Términos y Condiciones (Terms & Conditions) |
+| `'contact'` | Información de Contacto Legal |
+| `'privacy_policy'` | Política de Privacidad |
+| `'refund_policy'` | Política de Reembolso |
+| `'faqs'` | Preguntas Frecuentes (FAQs) |
+
+### Idiomas Soportados
+
+El parámetro `lang` acepta códigos de idioma ISO estándar:
+
+- `'en'` - Inglés
+- `'es'` - Español
+- `'fr'` - Francés
+- `'de'` - Alemán
+- `'it'` - Italiano
+- `'pt'` - Portugués
+- Y otros códigos ISO estándar...
+
+### Detalles Técnicos
+
+**Endpoint**: `POST https://bc1742.gways.org/legal/get`
+
+**Request Body**:
+```json
+{
+  "type": "tc",
+  "lang": "es",
+  "web_id": "chatconnect-ios-app"
+}
+```
+
+**Respuesta Esperada**:
+```json
+{
+  "success": 1,
+  "data": {
+    "content": "Contenido del documento legal...",
+    "title": "Términos y Condiciones",
+    "last_updated": "2025-02-12"
+  }
+}
+```
+
+### Ejemplo Completo en React Native
+
+```javascript
+import React, { useEffect, useState } from 'react';
+import { View, Text, ScrollView } from 'react-native';
+import SDK from 'apps-sdk';
+
+const TermsAndConditionsScreen = () => {
+    const [termsContent, setTermsContent] = useState('');
+    const [loading, setLoading] = useState(true);
+
+    useEffect(() => {
+        loadTerms();
+    }, []);
+
+    const loadTerms = async () => {
+        try {
+            const response = await SDK.legal.getLegalText(
+                'chatconnect-ios-app',
+                'tc',
+                'es'
+            );
+            
+            if (response && response.success) {
+                setTermsContent(response.data.content);
+            }
+        } catch (error) {
+            console.error('Error al cargar términos:', error);
+        } finally {
+            setLoading(false);
+        }
+    };
+
+    return (
+        <ScrollView>
+            {loading ? (
+                <Text>Cargando...</Text>
+            ) : (
+                <Text>{termsContent}</Text>
+            )}
+        </ScrollView>
+    );
+};
+```
+
+### Cargar Múltiples Documentos
+
+```javascript
+const loadAllLegalDocuments = async (webId, lang) => {
+    try {
+        const [terms, privacy, refund, contact, faqs] = await Promise.all([
+            SDK.legal.getLegalText(webId, 'tc', lang),
+            SDK.legal.getLegalText(webId, 'privacy_policy', lang),
+            SDK.legal.getLegalText(webId, 'refund_policy', lang),
+            SDK.legal.getLegalText(webId, 'contact', lang),
+            SDK.legal.getLegalText(webId, 'faqs', lang),
+        ]);
+
+        return {
+            terms: terms.data,
+            privacy: privacy.data,
+            refund: refund.data,
+            contact: contact.data,
+            faqs: faqs.data,
+        };
+    } catch (error) {
+        console.error('Error al cargar documentos legales:', error);
+        throw error;
+    }
+};
+
+// Uso
+const legalDocs = await loadAllLegalDocuments('chatconnect-ios-app', 'es');
+```
+
+### Manejo de Errores
+
+```javascript
+const getLegalDocumentSafely = async (webId, type, lang) => {
+    try {
+        const response = await SDK.legal.getLegalText(webId, type, lang);
+        
+        if (response && response.success === 1) {
+            return {
+                success: true,
+                content: response.data
+            };
+        } else {
+            return {
+                success: false,
+                error: 'Documento no disponible'
+            };
+        }
+    } catch (error) {
+        console.error('Error al obtener documento legal:', error);
+        return {
+            success: false,
+            error: error.message
+        };
+    }
+};
+
+// Uso con manejo de errores
+const result = await getLegalDocumentSafely('chatconnect-ios-app', 'tc', 'es');
+if (result.success) {
+    console.log('Contenido:', result.content);
+} else {
+    console.error('Error:', result.error);
+}
+```
+
+### Validaciones
+
+El método incluye validaciones automáticas:
+
+1. **web_id requerido**: Lanza un error si no se proporciona
+2. **type requerido**: Lanza un error si no se proporciona
+3. **lang requerido**: Lanza un error si no se proporciona
+4. **Tipo válido**: Solo acepta los 5 tipos de documentos especificados

package/config.js

@@ -13,7 +13,7 @@ export var ENDPOINTS = {
     AUDIENCES: "https://backend.ailandsapp.com",
     CONTENTS: "https://backend.ailandsapp.com",
     EVENTS: "https://ap0404.gways.org",
-    GET_LEGAL_TEXT: "https://backend.ailandsapp.com/content/andromeda/get-legal-text",
+    LEGAL_BASE: "https://bc1742.gways.org/legal",
 }
 
 export var EVENTS = {}

package/index.js

@@ -1,6 +1,6 @@
 import {NotificationsPush, Networking, Storage, Session, Utils, PayWallLogic, Rating, AdJust, TrackingTransparency, Voice, MixPanel, Adapty, HomeActions, Facebook, Legal} from "./src/libraries";
 import PayWall from "./src/components/PayWall";
-import AdaptyOnboarding from "./src/components/AdaptyOnboarding";
+import AdaptyOnboarding from "./src/components/AdaptyOnboarding.js";
 
 class AppsSDK {
     constructor() {
@@ -64,4 +64,4 @@ export default {
     homeActions:                 HomeActions,
     facebook:                    Facebook,
     legal:                       Legal,
-}
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "apps-sdk",
-  "version": "1.1.73",
+  "version": "1.1.75",
   "description": "Apps SDK",
   "main": "index.js",
   "author": "ASD",

package/src/libraries/Legal.js

@@ -5,36 +5,49 @@ class Legal {
     constructor() {}
 
     /**
-     * Obtiene textos legales desde el backend
-     * @param {string} webId - ID del proyecto web
-     * @param {'tc' | 'privacy' | 'cookies'} type - Tipo de texto legal
-     * @param {string} language - Código de idioma (por defecto 'es')
-     * @returns {Promise<any>} Respuesta con el texto legal
+     * Get legal texts from backend
+     * @param {string} web_id - Web project ID
+     * @param {'tc' | 'contact' | 'privacy_policy' | 'refund_policy' | 'faqs'} type - Legal text type
+     * @param {string} lang - Language code (e.g. 'en', 'es', 'fr', 'de', etc.)
+     * @returns {Promise<any>} Legal text response
      */
-    async getLegalText(webId, type, language = 'es') {
-        config.DEBUG_MODE && console.debug("getLegalText", { webId, type, language });
+    async getLegalText(web_id, type, lang) {
+        config.DEBUG_MODE && console.debug("getLegalText", { web_id, type, lang });
         
-        if (!webId) {
-            console.error('getLegalText: webId es requerido');
-            throw new Error('webId es requerido');
+        if (!web_id) {
+            console.error('getLegalText: web_id is required');
+            throw new Error('web_id is required');
         }
 
-        if (!['tc', 'privacy', 'cookies'].includes(type)) {
-            console.error('getLegalText: tipo inválido. Debe ser tc, privacy o cookies');
-            throw new Error('Tipo inválido. Debe ser tc, privacy o cookies');
+        if (!type) {
+            console.error('getLegalText: type is required');
+            throw new Error('type is required');
+        }
+
+        if (!lang) {
+            console.error('getLegalText: lang is required');
+            throw new Error('lang is required');
+        }
+
+        const validTypes = ['tc', 'contact', 'privacy_policy', 'refund_policy', 'faqs'];
+        if (!validTypes.includes(type)) {
+            console.error(`getLegalText: invalid type. Must be one of: ${validTypes.join(', ')}`);
+            throw new Error(`Invalid type. Must be one of: ${validTypes.join(', ')}`);
         }
 
         try {
-            const response = await Networking.request(config.ENDPOINTS.GET_LEGAL_TEXT, {
-                webId,
+            const endpoint = `${config.ENDPOINTS.LEGAL_BASE}/get`;
+            
+            const response = await Networking.request(endpoint, {
                 type,
-                language
+                lang,
+                web_id
             });
             
             config.DEBUG_MODE && console.debug("getLegalText response", response);
             return response;
         } catch (error) {
-            console.error(`Failed to fetch legal text (${type}) for webId ${webId}:`, error);
+            console.error(`Failed to fetch legal text (${type}) for web_id ${web_id}:`, error);
             throw error;
         }
     }

package/types/index.d.ts

@@ -288,7 +288,7 @@ declare module 'apps-sdk' {
     }
 
     export class Legal {
-        getLegalText(webId: string, type: 'tc' | 'privacy' | 'cookies', language?: string): Promise<any>;
+        getLegalText(web_id: string, type: 'tc' | 'contact' | 'privacy_policy' | 'refund_policy' | 'faqs', lang: string): Promise<any>;
     }
 
     export class AppsSDK {
@@ -319,4 +319,4 @@ declare module 'apps-sdk' {
 
     const Core: AppsSDK;
     export default Core;
-}
+}