@begapp/sdk 1.1.3 → 2.1.0

package/README.md

@@ -2,9 +2,52 @@
 
 Librería cliente para consumir los servicios de BegaApp desde cualquier aplicación externa. Permite configurar la API Key y consumir fácilmente endpoints.
 
+## Audiencia dinámica
+
+Los avisos estáticos mantienen la firma existente:
+
+```js
+await crearNotificacionBegaApp('RECEPCION_CREADA', data);
+```
+
+Para un aviso dinámico, la aplicación origen identifica al destinatario usando
+su identidad externa. Bega resuelve el vínculo y valida que el usuario esté
+autorizado en la definición del aviso:
+
+```js
+await crearNotificacionBegaApp('RECEPCION_ELIMINADA', data, {
+  recipients: {
+    users: [{ source: 'easy-bodega', externalId: creadorId }]
+  },
+  context: {
+    actor: { source: 'easy-bodega', externalId: usuarioActualId }
+  }
+});
+```
+
+Las mismas opciones están disponibles como cuarto argumento de
+`crearNotificacionFileBegaApp(codigoAviso, data, files, options)`.
+
+### Suprimir el correo en una ejecución
+
+Si el aviso tiene correo habilitado en Bega, la aplicación origen puede decidir
+que una ejecución concreta se entregue solo por chat y campanita:
+
+```js
+await crearNotificacionBegaApp('RECEPCION_ACTUALIZADA', data, {
+  delivery: { email: false }
+});
+```
+
+Omitir `delivery.email` conserva el comportamiento configurado en Bega. Enviar
+`true` no habilita el correo si la definición del aviso lo tiene desactivado.
+
+Durante la transición el servidor también acepta el `ObjectId` histórico, pero
+las integraciones nuevas deben usar el código estable configurado en Bega.
+
 ---
 
 ## 🚀 Instalación
 
 ```bash
-npm install @begaapp/sdk
+npm install @begaapp/sdk

package/index.js

@@ -1,7 +1,8 @@
 import { configurarSDKBegaApp } from './src/client.js';
-import { crearNotificacionBegaApp } from './src/notificaciones.js';
+import { crearNotificacionBegaApp, crearNotificacionFileBegaApp } from './src/notificaciones.js';
 
 export {
     configurarSDKBegaApp,
     crearNotificacionBegaApp,
+    crearNotificacionFileBegaApp
 };

package/package.json

@@ -1,20 +1,25 @@
-{
-  "name": "@begapp/sdk",
-  "version": "1.1.3",
-  "description": "SDK para interactuar con el servicio de notificaciones de Bega App",
-  "main": "index.js",
-  "type": "module",
-  "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
-  },
-  "keywords": [],
-  "author": "Bega App",
-  "license": "MIT",
-  "dependencies": {
-    "axios": "^1.9.0",
-    "crypto-js": "^4.2.0"
-  },
-  "publishConfig": {
-    "access": "public"
-  }
-}
+{
+  "name": "@begapp/sdk",
+  "version": "2.1.0",
+  "description": "SDK para interactuar con el servicio de notificaciones de Bega App",
+  "main": "index.js",
+  "type": "module",
+  "files": [
+    "index.js",
+    "src",
+    "README.md"
+  ],
+  "scripts": {
+    "test": "node --test"
+  },
+  "keywords": [],
+  "author": "Bega App",
+  "license": "MIT",
+  "dependencies": {
+    "axios": "^1.9.0",
+    "crypto-js": "^4.2.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/client.js

@@ -6,9 +6,9 @@ var claveSecreta = '';
 export function configurarSDKBegaApp({ apiKey, urlApi, secretKey }) {
     if (!apiKey) throw new Error("Debes proporcionar una API key");
     if (!urlApi) throw new Error("Debes proporcionar la URL de la API Bega");
-    if (!secretKey) throw new Error("Debes proporcionar la URL de la API Bega");
+    // if (!secretKey) throw new Error("Debes proporcionar la Secret Key de la API Bega");
 
-    claveSecreta = secretKey;
+    // claveSecreta = secretKey;
 
     axiosInstance = axios.create({
         baseURL: urlApi,
@@ -25,12 +25,4 @@ export function getClient() {
     }
 
     return axiosInstance;
-}
-
-export function getClaveSecreta() {
-    if (claveSecreta === '') {
-        throw new Error("No se ha configurado la Clave secreta para encriptar los mensajes");
-    }
-
-    return claveSecreta;
 }

package/src/notificaciones.js

@@ -1,18 +1,89 @@
-import { getClaveSecreta, getClient } from './client.js';
-import { encryptMensaje } from './crypMensaje.js';
+import { getClient } from './client.js';
 
-export async function crearNotificacionBegaApp(id, dataFull) {
-    if (!id || typeof dataFull !== 'object') {
-        throw new Error("crearNotificacion requiere un ID y un objeto data.");
+function buildNotificationPayload(identifier, data, options = {}) {
+    if (!identifier || !data || typeof data !== 'object' || Array.isArray(data)) {
+        throw new Error("crearNotificacion requiere un identificador y un objeto data.");
     }
+    // `id` se conserva durante la transición para servidores SDK anteriores.
+    const payload = { identifier, id: identifier, data };
+    if (options.context) payload.context = options.context;
+    if (options.recipients) payload.recipients = options.recipients;
+    if (options.delivery) payload.delivery = options.delivery;
+    if (options.attachments) payload.attachments = options.attachments;
+    return payload;
+}
 
-    const data = encryptMensaje(dataFull, getClaveSecreta());
+function sdkError(error) {
+    return {
+        status: "error",
+        code: error.response?.data?.code,
+        message: error.response?.data?.message || error.message,
+        details: error.response?.data?.details
+    };
+}
 
-    const client = getClient();
-    const res = await client.post("/notification/create-notification", {
-        id,
-        data,
-    });
+export async function crearNotificacionBegaApp(identifier, data, options = {}) {
+    try {
+        const client = getClient();
+        const res = await client.post("/notification/create-notification", buildNotificationPayload(identifier, data, options));
 
-    return res.data;
-}
+        return { status: "success", data: res.data };
+    } catch (error) {
+        return sdkError(error);
+    }
+}
+
+export async function crearNotificacionFileBegaApp(identifier, data, files, options = {}) {
+    try {
+        if (!identifier || typeof data !== 'object') {
+            throw new Error("crearNotificacionFileBegaApp requiere un identificador y un objeto data.");
+        }
+
+        if (!files || files.length <= 0) {
+            throw new Error("crearNotificacionFileBegaApp requiere al menos un archivo");
+        }
+
+        const client = getClient();
+
+        const attachments = await Promise.all(
+            files.map(async ({ name, file }) => {
+
+                const form = new FormData();
+                form.append('file', file, `${name}.pdf`);
+                form.append('meta', JSON.stringify({ generatedAt: new Date().toISOString() }));
+                form.append('id', identifier);
+
+                console.log("ASÍ ESTOY ARMANDO EL FORM: ", form);
+
+                const respFile = await client.post("uploads/document-notification", form, {
+                    headers: {
+                        // No pongas application/json. Deja que el browser ponga el Content-Type con boundary.
+                        // En axios está bien poner 'multipart/form-data' — el browser añadirá el boundary.
+                        'Content-Type': 'multipart/form-data'
+                    },
+                    onUploadProgress: (e) => {
+                        if (!e.total) return;
+                        const pct = Math.round((e.loaded * 100) / e.total);
+                        console.log(`${name}: Progreso de subida: ${pct}%`);
+                    },
+                });
+
+                if (respFile?.data?.status !== 'success') {
+                    throw new Error(`Upload fallido para ${name}: ${respFile?.data?.message ?? 'sin mensaje'}`);
+                }
+
+                return respFile.data.attachment;
+            })
+        );
+
+        console.log("ESTE ES MI ATTACHMENTS: ", attachments);
+
+        const res = await client.post("/notification/create-notification", buildNotificationPayload(identifier, data, { ...options, attachments }));
+
+        return { status: "success", data: res.data };
+    } catch (error) {
+        return sdkError(error);
+    }
+}
+
+export { buildNotificationPayload };

package/src/crypMensaje.js

@@ -1,24 +0,0 @@
-import CryptoJS from "crypto-js";
-
-/**
- * Cifra un objeto JSON como string
- * @param {Object} data - El objeto con los datos (por ejemplo { cliente, estado })
- * @param {string} claveSecreta - Clave AES
- * @returns {string} - Texto cifrado
- */
-export function encryptMensaje(data, claveSecreta) {
-    const stringData = JSON.stringify(data);
-    return CryptoJS.AES.encrypt(stringData, claveSecreta).toString();
-}
-
-/**
- * Descifra un string cifrado a objeto JSON
- * @param {string} mensajeCifrado - Texto cifrado
- * @param {string} claveSecreta - Clave AES
- * @returns {Object} - Objeto original
- */
-export function decryptMensaje(mensajeCifrado, claveSecreta) {
-    const bytes = CryptoJS.AES.decrypt(mensajeCifrado, claveSecreta);
-    const textoPlano = bytes.toString(CryptoJS.enc.Utf8);
-    return JSON.parse(textoPlano);
-}