apacuana-sdk-core 0.2.0 → 0.3.0

package/dist/index.js

@@ -522,7 +522,7 @@ var httpRequest = /*#__PURE__*/function () {
  * Este método es útil para endpoints que requieren datos en el cuerpo de la petición
  * para buscar un usuario, como un ID de sesión o un token de acceso.
  *
- * @returns {Promise<object>} Objeto con los detalles del usuario.
+ * @returns {Promise<{token: string, userData: object, success: boolean}>} Objeto con el token de sesión, los datos del usuario y un indicador de éxito.
  * @throws {Error} Si los parámetros de entrada son inválidos.
  * @throws {ApacuanaAPIError} Si ocurre un error en la API de Apacuana.
  */
@@ -533,62 +533,46 @@ var getCustomer = /*#__PURE__*/function () {
       while (1) switch (_context.p = _context.n) {
         case 0:
           _getConfig = getConfig(), verificationId = _getConfig.verificationId, customerId = _getConfig.customerId;
-          body = {
-            verificationid: verificationId,
-            customerid: customerId
-          }; // eslint-disable-next-line no-console
-          console.log("-> Función 'getCustomer' ejecutada.");
-          // eslint-disable-next-line no-console
-          console.log("Parámetros recibidos para buscar usuario:", body);
-
-          // 1. Validación de Parámetros de Entrada (Lado del SDK)
-          if (!(!body || !body.verificationid || !body.customerid)) {
+          if (!(!verificationId || !customerId)) {
             _context.n = 1;
             break;
           }
-          throw new Error("El 'body' con 'userId' es un parámetro requerido para getCustomer.");
+          throw new ApacuanaAPIError("Both 'verificationId' and 'customerId' must be configured.", 400, "CONFIGURATION_ERROR");
         case 1:
-          _context.p = 1;
-          _context.n = 2;
-          return httpRequest("services/api/register/init",
-          // Endpoint de ejemplo
-          body,
-          // Los datos a enviar en el cuerpo de la petición
-          "POST");
-        case 2:
+          body = {
+            verificationid: verificationId,
+            customerid: customerId
+          };
+          _context.p = 2;
+          _context.n = 3;
+          return httpRequest("services/api/register/init", body, "POST");
+        case 3:
           response = _context.v;
-          // 3. Procesar la Respuesta del Backend
-          // Asumiendo que la respuesta exitosa del backend incluye un objeto 'user'
-          // eslint-disable-next-line no-console
-          console.log("Respuesta del servidor para el token:", response);
           if (!(!response.sessionid || !response.entry)) {
-            _context.n = 3;
+            _context.n = 4;
             break;
           }
-          throw new ApacuanaAPIError("La respuesta de la API no contiene el usuario.", 200, "INVALID_API_RESPONSE");
-        case 3:
+          throw new ApacuanaAPIError("The API response does not contain the user.", 200, "INVALID_API_RESPONSE");
+        case 4:
           return _context.a(2, {
             token: response.sessionid,
             userData: response.entry,
             success: true
           });
-        case 4:
-          _context.p = 4;
+        case 5:
+          _context.p = 5;
           _t = _context.v;
-          // 4. Manejo de Errores
-          // eslint-disable-next-line no-console
-          console.error("Error en getCustomer:", _t);
           if (!(_t instanceof ApacuanaAPIError)) {
-            _context.n = 5;
+            _context.n = 6;
             break;
           }
           throw _t;
-        case 5:
-          throw new ApacuanaAPIError("Fallo inesperado al obtener el token: ".concat(_t.message || "Error desconocido"));
         case 6:
+          throw new ApacuanaAPIError("Unexpected failure getting token: ".concat(_t.message || "Unknown error"));
+        case 7:
           return _context.a(2);
       }
-    }, _callee, null, [[1, 4]]);
+    }, _callee, null, [[2, 5]]);
   }));
   return function getCustomer() {
     return _ref.apply(this, arguments);
@@ -32771,6 +32755,11 @@ var validateGetDocsData = function validateGetDocsData(data) {
     throw new ApacuanaAPIError("El parámetro 'status' no es válido. Los valores permitidos son: -1, 0, 1, 2.", 400, "INVALID_PARAMETER");
   }
 };
+var validateGetDigestData = function validateGetDigestData(signData) {
+  if (!signData || !signData.cert || typeof signData.cert !== "string" || !signData.signatureId || typeof signData.signatureId !== "string") {
+    throw new ApacuanaAPIError("Los parámetros 'cert' y 'signatureId' son requeridos y deben ser cadenas de texto.", 400, "INVALID_PARAMETER");
+  }
+};
 var helpers = {
   getCertificateStatus: getCertificateStatus,
   exportPrivateKey: exportPrivateKey,
@@ -32778,9 +32767,15 @@ var helpers = {
   encryptedCsr: encryptedCsr,
   validateOnBoardingSignerData: validateOnBoardingSignerData,
   validateCsr: validateCsr,
-  validateGetDocsData: validateGetDocsData
+  validateGetDocsData: validateGetDocsData,
+  validateGetDigestData: validateGetDigestData
 };
 
+/**
+ * Gets the user's certificate status.
+ * @param {boolean} [isCertificateInDevice=false] - Indicates if the certificate is already on the device.
+ * @returns {{status: string, success: boolean}} Object with the certificate status and a success indicator.
+ */
 var getCertStatus = function getCertStatus() {
   var isCertificateInDevice = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : false;
   var config = getConfig();
@@ -32791,299 +32786,198 @@ var getCertStatus = function getCertStatus() {
   };
 };
 
-/*
-const signDocumentOnBoarding = async (documentData, signatureData) => {
-  try {
-    const response = await httpRequest(
-      "/docs/sign",
-      { documentData, signatureData },
-      "POST"
-    );
-    if (!response.success) {
-      throw new ApacuanaAPIError(
-        response.message || "Error desconocido al firmar documento."
-      );
-    }
-    return { signedDocId: response.id, status: response.message };
-  } catch (error) {
-    if (error.name === "ApacuanaAPIError") {
-      throw error;
-    }
-    throw new ApacuanaAPIError(
-      `Fallo en la firma del documento (on-boarding): ${error.message}`
-    );
-  }
-};
-
-const signDocumentOnPremise = async (signature, cert, privateKey) => {
-  helpers.validateSignOnPremiseData({ signature, cert, privateKey });
-  try {
-    const digestBody = {
-      publickey: cert,
-    };
-
-    const digestResponse = await httpRequest(
-      `services/api/documents/getdigest/${signature.id}`,
-      digestBody,
-      "POST"
-    );
-
-    const digest = digestResponse.data?.digest || digestResponse.digest;
-    if (!digest) {
-      throw new ApacuanaAPIError(
-        "La generación de firma ha fallado: no se pudo obtener el digest del documento."
-      );
-    }
-
-    const signedDigest = await helpers.signDigest(digest, privateKey);
-
-    const signBody = {
-      positions: JSON.stringify(
-        signature.positions.map((p) => ({
-          x: p.x,
-          y: p.y,
-          page: p.page,
-          status: 1,
-        }))
-      ),
-      publickey: cert,
-      signeddigest: signedDigest,
-    };
-
-    const signResponse = await httpRequest(
-      `services/api/documents/sign/${signature.id}`,
-      signBody,
-      "PUT"
-    );
-
-    return signResponse;
-  } catch (error) {
-    if (error.name === "ApacuanaAPIError") {
-      throw error;
-    }
-    throw new ApacuanaAPIError(
-      `Fallo en la firma del documento (on-premise): ${error.message}`
-    );
-  }
-};
-*/
-
-/**
- * Firma un documento PDF con un certificado digital.
- * @param {object} data - Datos para la firma. Para 'on-boarding', debe contener {documentData, signatureData}. Para 'on-premise', debe contener {signature, cert, privateKey}.
- * @returns {Promise<object>} Objeto con el resultado de la firma.
- */
-/*
-export const signDocument = async (signData) => {
-  if (
-    !signData ||
-    typeof signData !== "object" ||
-    Object.keys(signData).length === 0
-  ) {
-    throw new ApacuanaAPIError(
-      "El parámetro 'data' es requerido y debe ser un objeto no vacío.",
-      400,
-      "INVALID_PARAMETER"
-    );
-  }
-
-  const { integrationType } = getConfig();
-
-  if (integrationType === INTEGRATION_TYPE.ONBOARDING) {
-    return signDocumentOnBoarding(signData);
-  }
-
-  if (integrationType === INTEGRATION_TYPE.ONPREMISE) {
-    return signDocumentOnPremise(signData);
-  }
-
-  throw new ApacuanaAPIError(
-    `Tipo de integración no soportado: ${integrationType}`,
-    400,
-    "UNSUPPORTED_INTEGRATION_TYPE"
-  );
-};
-*/
-
 var addSignerOnBoarding = /*#__PURE__*/function () {
-  var _ref = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee(signerData) {
-    var _t;
-    return _regenerator().w(function (_context) {
-      while (1) switch (_context.p = _context.n) {
+  var _ref7 = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee7(signerData) {
+    var _t2;
+    return _regenerator().w(function (_context7) {
+      while (1) switch (_context7.p = _context7.n) {
         case 0:
           helpers.validateOnBoardingSignerData(signerData);
-          _context.p = 1;
-          _context.n = 2;
+          _context7.p = 1;
+          _context7.n = 2;
           return httpRequest("services/api/documents/signing", signerData, "POST");
         case 2:
-          return _context.a(2, {
+          return _context7.a(2, {
             signer: signerData.typedoc + signerData.doc,
             success: true
           });
         case 3:
-          _context.p = 3;
-          _t = _context.v;
-          if (!(_t instanceof ApacuanaAPIError)) {
-            _context.n = 4;
+          _context7.p = 3;
+          _t2 = _context7.v;
+          if (!(_t2 instanceof ApacuanaAPIError)) {
+            _context7.n = 4;
             break;
           }
-          throw _t;
+          throw _t2;
         case 4:
-          throw new Error("Fallo al agregar firmante en On-Boarding: ".concat(_t.message));
+          throw new Error("Failed to add signer in On-Boarding: ".concat(_t2.message));
         case 5:
-          return _context.a(2);
+          return _context7.a(2);
       }
-    }, _callee, null, [[1, 3]]);
+    }, _callee7, null, [[1, 3]]);
   }));
-  return function addSignerOnBoarding(_x) {
-    return _ref.apply(this, arguments);
+  return function addSignerOnBoarding(_x3) {
+    return _ref7.apply(this, arguments);
   };
 }();
 var addSignerOnPremise = /*#__PURE__*/function () {
-  var _ref2 = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee2() {
-    return _regenerator().w(function (_context2) {
-      while (1) switch (_context2.n) {
+  var _ref8 = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee8() {
+    return _regenerator().w(function (_context8) {
+      while (1) switch (_context8.n) {
         case 0:
-          return _context2.a(2, Promise.resolve({
-            signerId: "on-premise-signer-id",
-            status: "added"
-          }));
+          throw new ApacuanaAPIError("Adding signers is not supported for integration type: ONPREMISE", 501, "NOT_IMPLEMENTED");
+        case 1:
+          return _context8.a(2);
       }
-    }, _callee2);
+    }, _callee8);
   }));
   return function addSignerOnPremise() {
-    return _ref2.apply(this, arguments);
+    return _ref8.apply(this, arguments);
   };
 }();
 
 /**
- * Agrega un firmante a un documento, manejando diferentes tipos de integración.
- * @param {object} signerData - Datos del firmante a agregar.
- * @returns {Promise<object>} Objeto con el resultado de agregar el firmante.
+ * Adds a signer to a document, handling different integration types.
+ * @param {object} signerData - Data of the signer to be added.
+ * @returns {Promise<{signer: string, success: boolean}>} Object with the result of adding the signer.
+ * @throws {ApacuanaAPIError} If the signer data is invalid, if the API call fails, or if the integration type is not supported.
  */
 var addSigner = /*#__PURE__*/function () {
-  var _ref3 = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee3(signerData) {
-    var _getConfig, integrationType;
-    return _regenerator().w(function (_context3) {
-      while (1) switch (_context3.n) {
+  var _ref9 = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee9(signerData) {
+    var _getConfig3, integrationType;
+    return _regenerator().w(function (_context9) {
+      while (1) switch (_context9.n) {
         case 0:
           if (!(!signerData || _typeof(signerData) !== "object" || Object.keys(signerData).length === 0)) {
-            _context3.n = 1;
+            _context9.n = 1;
             break;
           }
-          throw new ApacuanaAPIError("Los datos del firmante (signerData) son requeridos y deben ser un objeto no vacío.", 400, "INVALID_PARAMETER");
+          throw new ApacuanaAPIError("Signer data (signerData) is required and must be a non-empty object.", 400, "INVALID_PARAMETER");
         case 1:
-          _getConfig = getConfig(), integrationType = _getConfig.integrationType;
+          _getConfig3 = getConfig(), integrationType = _getConfig3.integrationType;
           if (!(integrationType === INTEGRATION_TYPE.ONBOARDING)) {
-            _context3.n = 2;
+            _context9.n = 2;
             break;
           }
-          return _context3.a(2, addSignerOnBoarding(signerData));
+          return _context9.a(2, addSignerOnBoarding(signerData));
         case 2:
           if (!(integrationType === INTEGRATION_TYPE.ONPREMISE)) {
-            _context3.n = 3;
+            _context9.n = 3;
             break;
           }
-          return _context3.a(2, addSignerOnPremise(signerData));
+          return _context9.a(2, addSignerOnPremise(signerData));
         case 3:
-          throw new ApacuanaAPIError("Tipo de integraci\xF3n no soportado: ".concat(integrationType), 400, "UNSUPPORTED_INTEGRATION_TYPE");
+          throw new ApacuanaAPIError("Unsupported integration type: ".concat(integrationType), 400, "UNSUPPORTED_INTEGRATION_TYPE");
         case 4:
-          return _context3.a(2);
+          return _context9.a(2);
       }
-    }, _callee3);
+    }, _callee9);
   }));
-  return function addSigner(_x2) {
-    return _ref3.apply(this, arguments);
+  return function addSigner(_x4) {
+    return _ref9.apply(this, arguments);
   };
 }();
 var getDocsOnPremise = /*#__PURE__*/function () {
-  var _ref4 = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee4() {
-    return _regenerator().w(function (_context4) {
-      while (1) switch (_context4.n) {
+  var _ref0 = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee0() {
+    return _regenerator().w(function (_context0) {
+      while (1) switch (_context0.n) {
         case 0:
-          throw new ApacuanaAPIError("La obtención de documentos no está soportada para el tipo de integración: ONBOARDING", 501, "NOT_IMPLEMENTED");
+          throw new ApacuanaAPIError("Document retrieval is not supported for integration type: ONBOARDING", 501, "NOT_IMPLEMENTED");
         case 1:
-          return _context4.a(2);
+          return _context0.a(2);
       }
-    }, _callee4);
+    }, _callee0);
   }));
   return function getDocsOnPremise() {
-    return _ref4.apply(this, arguments);
+    return _ref0.apply(this, arguments);
   };
 }();
 var getDocsOnBoarding = /*#__PURE__*/function () {
-  var _ref5 = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee5(data) {
-    var _getConfig2, customerId, apiUrl, response, _t2;
-    return _regenerator().w(function (_context5) {
-      while (1) switch (_context5.p = _context5.n) {
+  var _ref1 = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee1(data) {
+    var _getConfig4, customerId, params, apiUrl, response, _t3;
+    return _regenerator().w(function (_context1) {
+      while (1) switch (_context1.p = _context1.n) {
         case 0:
-          _getConfig2 = getConfig(), customerId = _getConfig2.customerId;
+          _getConfig4 = getConfig(), customerId = _getConfig4.customerId;
           if (customerId) {
-            _context5.n = 1;
+            _context1.n = 1;
             break;
           }
-          throw new ApacuanaAPIError("El 'customerId' no está configurado. Por favor, configure el SDK.", 400, "CONFIGURATION_ERROR");
+          throw new ApacuanaAPIError("'customerId' is not configured. Please configure the SDK.", 400, "CONFIGURATION_ERROR");
         case 1:
-          _context5.p = 1;
-          apiUrl = "services/api/documents/listcustomer?page=".concat(data.page, "&customerid=").concat(customerId, "&size=").concat(data.size, "&status=").concat(data.status);
-          _context5.n = 2;
+          _context1.p = 1;
+          params = new URLSearchParams({
+            page: data.page,
+            customerid: customerId,
+            size: data.size
+          });
+          if (typeof data.status !== "undefined") {
+            params.append("status", data.status);
+          }
+          apiUrl = "services/api/documents/listcustomer?".concat(params.toString());
+          _context1.n = 2;
           return httpRequest(apiUrl, {}, "GET");
         case 2:
-          response = _context5.v;
-          return _context5.a(2, response);
+          response = _context1.v;
+          return _context1.a(2, {
+            totalRecords: response.numofrecords,
+            records: response.records,
+            success: true
+          });
         case 3:
-          _context5.p = 3;
-          _t2 = _context5.v;
-          if (!(_t2.name === "ApacuanaAPIError")) {
-            _context5.n = 4;
+          _context1.p = 3;
+          _t3 = _context1.v;
+          if (!(_t3.name === "ApacuanaAPIError")) {
+            _context1.n = 4;
             break;
           }
-          throw _t2;
+          throw _t3;
         case 4:
-          throw new ApacuanaAPIError("Fallo al obtener la lista de documentos (on-premise): ".concat(_t2.message));
+          throw new ApacuanaAPIError("Failed to get document list (on-premise): ".concat(_t3.message));
         case 5:
-          return _context5.a(2);
+          return _context1.a(2);
       }
-    }, _callee5, null, [[1, 3]]);
+    }, _callee1, null, [[1, 3]]);
   }));
-  return function getDocsOnBoarding(_x3) {
-    return _ref5.apply(this, arguments);
+  return function getDocsOnBoarding(_x5) {
+    return _ref1.apply(this, arguments);
   };
 }();
 
 /**
- * Obtiene una lista de documentos.
- * @param {object} data - Objeto con los parámetros de paginación. Debe contener {page, size}.
- * @returns {Promise<object>} Objeto con la lista de documentos.
+ * Gets a list of documents.
+ * @param {object} data - Object with pagination parameters. Must contain {page, size}.
+ * @returns {Promise<{totalRecords: number, records:any[], success: boolean}>} Object with the list of documents.
+ * @throws {ApacuanaAPIError} If pagination parameters are invalid, if 'customerId' is not configured, if the API call fails, or if the integration type is not supported.
  */
 var getDocs = /*#__PURE__*/function () {
-  var _ref6 = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee6(data) {
-    var _getConfig3, integrationType;
-    return _regenerator().w(function (_context6) {
-      while (1) switch (_context6.n) {
+  var _ref10 = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee10(data) {
+    var _getConfig5, integrationType;
+    return _regenerator().w(function (_context10) {
+      while (1) switch (_context10.n) {
         case 0:
           helpers.validateGetDocsData(data);
-          _getConfig3 = getConfig(), integrationType = _getConfig3.integrationType;
+          _getConfig5 = getConfig(), integrationType = _getConfig5.integrationType;
           if (!(integrationType === INTEGRATION_TYPE.ONBOARDING)) {
-            _context6.n = 1;
+            _context10.n = 1;
             break;
           }
-          return _context6.a(2, getDocsOnBoarding(data));
+          return _context10.a(2, getDocsOnBoarding(data));
         case 1:
           if (!(integrationType === INTEGRATION_TYPE.ONPREMISE)) {
-            _context6.n = 2;
+            _context10.n = 2;
             break;
           }
-          return _context6.a(2, getDocsOnPremise());
+          return _context10.a(2, getDocsOnPremise());
         case 2:
-          throw new ApacuanaAPIError("La obtenci\xF3n de documentos no est\xE1 soportada para un tipo de integraci\xF3n desconocido: ".concat(integrationType), 501, "NOT_IMPLEMENTED");
+          throw new ApacuanaAPIError("Document retrieval is not supported for an unknown integration type: ".concat(integrationType), 501, "NOT_IMPLEMENTED");
         case 3:
-          return _context6.a(2);
+          return _context10.a(2);
       }
-    }, _callee6);
+    }, _callee10);
   }));
-  return function getDocs(_x4) {
-    return _ref6.apply(this, arguments);
+  return function getDocs(_x6) {
+    return _ref10.apply(this, arguments);
   };
 }();