apacuana-sdk-core 0.13.0 → 0.15.0

package/dist/types/certs.d.ts

@@ -1,4 +1,5 @@
-export type GenerateCertResponse = {
+export type ApacuanaSuccess = import("../success").ApacuanaSuccess;
+export type GenerateCertResponseData = {
     /**
      * - El certificado generado en formato string.
      */
@@ -7,26 +8,12 @@ export type GenerateCertResponse = {
      * - El ID del certificado generado.
      */
     certifiedid: string;
-    /**
-     * - Indica si la operación fue exitosa.
-     */
-    success: boolean;
 };
-export type GetCertStatusResponse = {
+export type GetCertStatusResponseData = {
     /**
      * - El estado actual del certificado del usuario.
      */
     status: string;
-    /**
-     * - Indica si la operación fue exitosa.
-     */
-    success: boolean;
-};
-export type EncryptedCSRObject = {
-    /**
-     * - The encrypted Certificate Signing Request.
-     */
-    csr: string;
 };
 export type CertType = {
     /**
@@ -38,15 +25,11 @@ export type CertType = {
      */
     name: string;
 };
-export type GetCertTypesResponse = {
+export type GetCertTypesResponseData = {
     /**
      * - A list of available certificate types.
      */
     types: Array<CertType>;
-    /**
-     * - Indicates if the operation was successful.
-     */
-    success: boolean;
 };
 export type Requirement = {
     /**
@@ -58,15 +41,28 @@ export type Requirement = {
      */
     description: string;
 };
-export type GetRequirementsResponse = {
+export type GetRequirementsResponseData = {
     /**
      * - A list of requirements for the user type.
      */
     requirements: Array<Requirement>;
+};
+export type RequestCertificateResponseData = {
+    /**
+     * - A message confirming the request.
+     */
+    message: string;
+};
+export type GenerateCertResponse = GenerateCertResponseData & ApacuanaSuccess;
+export type GetCertStatusResponse = GetCertStatusResponseData & ApacuanaSuccess;
+export type GetCertTypesResponse = GetCertTypesResponseData & ApacuanaSuccess;
+export type GetRequirementsResponse = GetRequirementsResponseData & ApacuanaSuccess;
+export type RequestCertificateResponse = RequestCertificateResponseData & ApacuanaSuccess;
+export type EncryptedCSRObject = {
     /**
-     * - Indicates if the operation was successful.
+     * - The encrypted Certificate Signing Request.
      */
-    success: boolean;
+    csr: string;
 };
 export type CertificateRequestParams = {
     /**
@@ -85,13 +81,3 @@ export type CertificateRequestParams = {
         file: string;
     }>;
 };
-export type RequestCertificateResponse = {
-    /**
-     * - A message confirming the request.
-     */
-    message: string;
-    /**
-     * - Indicates if the operation was successful.
-     */
-    success: boolean;
-};

package/dist/utils/constant.d.ts

@@ -8,6 +8,37 @@ export namespace STATUS_CERTIFICATE {
     let certificate_another_device: string;
     let sign_pending: string;
 }
+export const PARSE_STATUS: {
+    [STATUS_CERTIFICATE.certificate_another_device]: {
+        text: string;
+        descriptionText: undefined;
+    };
+    [STATUS_CERTIFICATE.request]: {
+        text: string;
+        descriptionText: string;
+    };
+    [STATUS_CERTIFICATE.generate]: {
+        text: string;
+        descriptionText: string;
+    };
+    [STATUS_CERTIFICATE.current]: {
+        text: string;
+        descriptionText: undefined;
+    };
+    [STATUS_CERTIFICATE.expire]: string;
+    [STATUS_CERTIFICATE.request_revoque]: {
+        text: string;
+        descriptionText: string;
+    };
+    [STATUS_CERTIFICATE.revoque]: {
+        text: string;
+        descriptionText: string;
+    };
+    [STATUS_CERTIFICATE.request_cert]: {
+        text: string;
+        descriptionText: string;
+    };
+};
 export namespace VERIFICATION_STATUS {
     let IN_REGISTER: number;
     let APPROVED: number;

package/dist/utils/helpers.d.ts

@@ -11,7 +11,7 @@ declare namespace _default {
     export { createPayloadGetDigest };
 }
 export default _default;
-declare function getCertificateStatus(userData: any, certificateInDevice: any): string;
+declare function getCertificateStatus(userData: any, certificateInDevice: any): any;
 declare function exportPrivateKey(key: any): Promise<string>;
 declare function arrayBufferToBase64(buffer: any): string;
 declare function encryptedCsr(csr: any, encryptKey?: string): {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "apacuana-sdk-core",
-  "version": "0.13.0",
+  "version": "0.15.0",
   "description": "Core SDK para interacciones con las APIs de Apacuana.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/api/certs.js

@@ -14,7 +14,7 @@ import { httpRequest } from "../utils/httpClient";
 import helpers from "../utils/helpers";
 import { ApacuanaAPIError } from "../errors";
 import ApacuanaSuccess from "../success";
-import { INTEGRATION_TYPE } from "../utils/constant";
+import { INTEGRATION_TYPE, PARSE_STATUS } from "../utils/constant";
 
 /**
  * @param {EncryptedCSRObject} encryptedCSR
@@ -88,7 +88,9 @@ export const getCertStatus = (isCertificateInDevice = false) => {
     config.userData,
     isCertificateInDevice
   );
-  return new ApacuanaSuccess({ status });
+  const parseStatus = PARSE_STATUS[status];
+
+  return new ApacuanaSuccess({ status: parseStatus });
 };
 
 const getCertTypesOnBoarding = async () => {

package/src/api/revocations.js

@@ -11,7 +11,7 @@ const requestRevocationOnBoarding = async (params) => {
   try {
     const response = await httpRequest(
       "services/api/onboardingclient/requestcert",
-      params,
+      { reason: params.reasonCode },
       "POST"
     );
     return new ApacuanaSuccess(response);

package/src/api/users.js

@@ -24,7 +24,7 @@ import ApacuanaSuccess from "../success";
  * @throws {Error} Si los parámetros de entrada son inválidos.
  * @throws {ApacuanaAPIError} Si ocurre un error en la API de Apacuana.
  */
-const getCustomer = async () => {
+export const getCustomer = async () => {
   const { verificationId, customerId } = getConfig();
 
   if (!verificationId || !customerId) {
@@ -69,4 +69,53 @@ const getCustomer = async () => {
   }
 };
 
-export default getCustomer;
+/**
+ * @typedef {object} CreateUserPayload
+ * @property {string} usr - Correo electrónico del usuario.
+ * @property {string} pwd - Contraseña del usuario.
+ * @property {string} kinddoc - Tipo de documento de identidad (ej. 'V', 'P', 'E').
+ * @property {string} doc - Número de documento de identidad.
+ */
+
+/**
+ * @typedef {object} CreateUserResponse
+ * @property {string} message - Mensaje de confirmación de la creación del usuario.
+ */
+
+/**
+ * Crea un nuevo usuario en la plataforma de Apacuana.
+ * @param {CreateUserPayload} userData - Objeto con los datos del usuario a crear.
+ * @returns {Promise<ApacuanaSuccess>} Una promesa que resuelve a un objeto con la respuesta exitosa.
+ * @throws {ApacuanaAPIError} Si los datos de entrada son inválidos o si ocurre un error en la API.
+ */
+
+export const createApacuanaUser = async (userData) => {
+  try {
+    const formData = new FormData();
+    Object.keys(userData).forEach((key) => {
+      const value = userData[key];
+      if (value instanceof File) {
+        formData.append(key, value);
+      } else if (value !== null && value !== undefined) {
+        formData.append(key, String(value));
+      }
+    });
+
+    const response = await httpRequest(
+      "services/api/register/initial",
+      formData,
+      "POST"
+    );
+
+    return new ApacuanaSuccess({
+      ...response,
+    });
+  } catch (error) {
+    if (error instanceof ApacuanaAPIError) {
+      throw error;
+    }
+    throw new ApacuanaAPIError(
+      `Unexpected failure creating user: ${error.message || "Unknown error"}`
+    );
+  }
+};

package/src/index.js

@@ -1,6 +1,5 @@
 import { setConfig, getConfig, close } from "./config/index";
 import { initHttpClient, setAuthToken } from "./utils/httpClient";
-import getCustomer from "./api/users";
 import { requestRevocation, getRevocationReasons } from "./api/revocations";
 import {
   generateCert,
@@ -23,44 +22,59 @@ import {
 } from "./api/faceLiveness";
 import ApacuanaSuccess from "./success/index";
 import { ApacuanaAPIError } from "./errors/index";
+import { createApacuanaUser, getCustomer } from "./api/users";
+
+/**
+ * Valida si el SDK está inicializado y si se dispone de un customerId.
+ * @param {boolean} requiresCustomerId - Indica si la operación necesita un customerId.
+ * @throws {ApacuanaAPIError} Si el SDK no está inicializado o el customerId es requerido y no está presente.
+ */
+const checkSdk = (requiresCustomerId = true) => {
+  const config = getConfig();
+
+  if (!config || !config.apiUrl) {
+    throw new ApacuanaAPIError(
+      "El SDK no está inicializado. Llama a apacuana.init() primero.",
+      400,
+      "NOT_INITIALIZED_ERROR"
+    );
+  }
+
+  if (requiresCustomerId && !config.customerId) {
+    throw new ApacuanaAPIError(
+      "Se requiere un CustomerId para esta operación. Por favor, inicia sesión.",
+      403,
+      "CUSTOMER_ID_REQUIRED"
+    );
+  }
+};
 
 const apacuana = {
   /**
-   * Inicializa el Apacuana SDK con la configuración necesaria y obtiene
-   * los detalles del usuario.
-   * @param {object} config - Objeto de configuración.
-   * @param {string} config.apiUrl - La URL base de la API de Apacuana.
-   * @param {string} config.secretKey - La clave secreta para la autenticación.
-   * @param {string} config.apiKey - La clave de API para la autenticación.
-   * @param {string} config.verificationId - El ID de verificación del usuario.
-   * @param {string} config.customerId - El ID del cliente.
-   * @param {string} config.integrationType - El tipo de integración ('onpremise' o 'onboarding').
-   * @returns {Promise<object>} retorna los detalles del usuario si la inicialización es exitosa.
+   * Inicializa el Apacuana SDK con la configuración necesaria.
    */
   init: async (config) => {
     try {
       setConfig(config);
       initHttpClient();
       const currentConfig = getConfig();
-      if (!currentConfig.customerId) {
-        throw new ApacuanaAPIError(
-          "Apacuana SDK: La configuración de CustomerId no se ha guardado" +
-            " correctamente.",
-          400,
-          { code: "CONFIG_ERROR" }
-        );
+
+      if (currentConfig.customerId) {
+        const customer = await getCustomer();
+        const { token, userData } = customer.data;
+        setConfig({ ...currentConfig, token, userData });
+        setAuthToken(token);
+        return new ApacuanaSuccess({
+          initialized: true,
+          message: "SDK inicializado con sesión de usuario.",
+        });
       }
 
-      const customer = await getCustomer();
-      const { token, userData } = customer.data;
-      setConfig({ ...currentConfig, token, userData });
-      setAuthToken(token);
       return new ApacuanaSuccess({
         initialized: true,
-        message: "SDK inicializado correctamente.",
+        message: "SDK inicializado para operaciones públicas (sin customerId).",
       });
     } catch (error) {
-      // eslint-disable-next-line no-console
       console.error("Error durante la inicialización del SDK:", error);
       if (error instanceof ApacuanaAPIError) {
         throw error;
@@ -72,25 +86,84 @@ const apacuana = {
       );
     }
   },
+
+  // --- Métodos de Revocación ---
+  requestRevocation: (data) => {
+    checkSdk(true);
+    return requestRevocation(data);
+  },
+  getRevocationReasons: () => {
+    checkSdk(true);
+    return getRevocationReasons();
+  },
+
+  // --- Métodos de Certificados ---
+  generateCert: (data) => {
+    checkSdk(true);
+    return generateCert(data);
+  },
+  getCertStatus: (isCertificateInDevice) => {
+    checkSdk(true);
+    return getCertStatus(isCertificateInDevice);
+  },
+  getCertTypes: () => {
+    checkSdk(false);
+    return getCertTypes();
+  },
+  getRequerimentsByTypeUser: (data) => {
+    checkSdk(false);
+    return getRequerimentsByTypeUser(data);
+  },
+
+  // --- Métodos de Firmas y Documentos ---
+  addSigner: (data) => {
+    checkSdk(true);
+    return addSigner(data);
+  },
+  deleteSignatureVariant: () => {
+    checkSdk(true);
+    return deleteSignatureVariant();
+  },
+  getDigest: (data) => {
+    checkSdk(true);
+    return getDigest(data);
+  },
+  getDocs: (data) => {
+    checkSdk(true);
+    return getDocs(data);
+  },
+  getSignatureVariant: () => {
+    checkSdk(true);
+    return getSignatureVariant();
+  },
+  signDocument: (data) => {
+    checkSdk(true);
+    return signDocument(data);
+  },
+  uploadSignatureVariant: (data) => {
+    checkSdk(true);
+    return uploadSignatureVariant(data);
+  },
+
+  getCustomer: () => {
+    checkSdk(true);
+    return getCustomer();
+  },
+  createFaceLivenessSession: () => {
+    checkSdk(true);
+    return createFaceLivenessSession();
+  },
+  createApacuanaUser: (data) => {
+    checkSdk(false);
+    return createApacuanaUser(data);
+  },
+  validateFaceLiveness: (data) => {
+    checkSdk(true);
+    return validateFaceLiveness(data);
+  },
+
   close: () => close(),
   getConfig,
-  requestRevocation,
-  getCertStatus,
-  getCustomer,
-  addSigner,
-  getDocs,
-  generateCert,
-  signDocument,
-  getDigest,
-  getRevocationReasons,
-  uploadSignatureVariant,
-  getSignatureVariant,
-  deleteSignatureVariant,
-  getCertTypes,
-  getRequerimentsByTypeUser,
-  createFaceLivenessSession,
-  validateFaceLiveness,
-  // requestCertificate,
 };
 
 export default apacuana;

package/src/types/certs.js

@@ -1,45 +1,62 @@
 /**
- * @typedef {object} GenerateCertResponse
- * @property {string} cert - El certificado generado en formato string.
- * @property {string} certifiedid - El ID del certificado generado.
- * @property {boolean} success - Indica si la operación fue exitosa.
+ * @typedef {import('../success').ApacuanaSuccess} ApacuanaSuccess
  */
 
+// Tipos de datos para las respuestas
 /**
- * @typedef {object} GetCertStatusResponse
- * @property {string} status - El estado actual del certificado del usuario.
- * @property {boolean} success - Indica si la operación fue exitosa.
+ * @typedef {object} GenerateCertResponseData
+ * @property {string} cert - El certificado generado en formato string.
+ * @property {string} certifiedid - El ID del certificado generado.
  */
-
 /**
- * @typedef {object} EncryptedCSRObject
- * @property {string} csr - The encrypted Certificate Signing Request.
+ * @typedef {object} GetCertStatusResponseData
+ * @property {string} status - El estado actual del certificado del usuario.
  */
-
 /**
  * @typedef {object} CertType
  * @property {string} id - The ID of the certificate type.
  * @property {string} name - The name of the certificate type.
  */
-
 /**
- * @typedef {object} GetCertTypesResponse
+ * @typedef {object} GetCertTypesResponseData
  * @property {Array<CertType>} types - A list of available certificate types.
- * @property {boolean} success - Indicates if the operation was successful.
  */
-
 /**
  * @typedef {object} Requirement
  * @property {string} id - The ID of the requirement.
  * @property {string} description - The description of the requirement.
  */
-
 /**
- * @typedef {object} GetRequirementsResponse
+ * @typedef {object} GetRequirementsResponseData
  * @property {Array<Requirement>} requirements - A list of requirements for the user type.
- * @property {boolean} success - Indicates if the operation was successful.
+ */
+/**
+ * @typedef {object} RequestCertificateResponseData
+ * @property {string} message - A message confirming the request.
  */
 
+// Tipos de respuesta combinados con ApacuanaSuccess
+/**
+ * @typedef {GenerateCertResponseData & ApacuanaSuccess} GenerateCertResponse
+ */
+/**
+ * @typedef {GetCertStatusResponseData & ApacuanaSuccess} GetCertStatusResponse
+ */
+/**
+ * @typedef {GetCertTypesResponseData & ApacuanaSuccess} GetCertTypesResponse
+ */
+/**
+ * @typedef {GetRequirementsResponseData & ApacuanaSuccess} GetRequirementsResponse
+ */
+/**
+ * @typedef {RequestCertificateResponseData & ApacuanaSuccess} RequestCertificateResponse
+ */
+
+// Otros tipos de datos
+/**
+ * @typedef {object} EncryptedCSRObject
+ * @property {string} csr - The encrypted Certificate Signing Request.
+ */
 /**
  * @typedef {object} CertificateRequestParams
  * @property {number} type - The user type to get requirements for.
@@ -47,10 +64,4 @@
  * @property {Array<{id: string, file: string}>} documents - The documents required for the certificate.
  */
 
-/**
- * @typedef {object} RequestCertificateResponse
- * @property {string} message - A message confirming the request.
- * @property {boolean} success - Indicates if the operation was successful.
- */
-
-export {};
+export {};

package/src/utils/constant.js

@@ -9,6 +9,43 @@ export const STATUS_CERTIFICATE = {
   sign_pending: "PENDIENTE_POR_FIRMAR",
 };
 
+export const PARSE_STATUS = {
+  [STATUS_CERTIFICATE.certificate_another_device]: {
+    text: "Verificado",
+    descriptionText: undefined,
+  },
+  [STATUS_CERTIFICATE.request_cert]: {
+    text: "En revisión",
+    descriptionText:
+      "La información y documentos enviados están siendo certificados por la Autoridad de Certificación para confirmar su validez.",
+  },
+  [STATUS_CERTIFICATE.request]: {
+    text: "Por verificar",
+    descriptionText:
+      "La información y documentos enviados están siendo revisados por la Autoridad de Registro.",
+  },
+  [STATUS_CERTIFICATE.generate]: {
+    text: "Por generar",
+    descriptionText:
+      "Tu solicitud fue aprobada. Solo falta que generes tu certificado para comenzar a usarlo.",
+  },
+  [STATUS_CERTIFICATE.current]: {
+    text: " ",
+    descriptionText: undefined,
+  },
+  [STATUS_CERTIFICATE.expire]: "Certificado expirado.",
+  [STATUS_CERTIFICATE.request_revoque]: {
+    text: "Por revocar",
+    descriptionText:
+      "Recibimos tu solicitud de revocación y estamos procesándola. El certificado dejará de ser válido una vez finalice el trámite.",
+  },
+  [STATUS_CERTIFICATE.revoque]: {
+    text: "Revocado",
+    descriptionText:
+      "Este certificado ha sido revocado. Debes solicitar uno nuevo.",
+  },
+};
+
 export const VERIFICATION_STATUS = {
   IN_REGISTER: 0,
   APPROVED: 1,

package/src/utils/helpers.js

@@ -17,6 +17,11 @@ const getCertificateStatus = (userData, certificateInDevice) => {
 
   if (userData?.verificationstatus?.id !== VERIFICATION_STATUS.APPROVED)
     return STATUS_CERTIFICATE.request;
+  if (
+    !userData?.certificationId &&
+    userData?.requestscert?.requests.length === 0
+  )
+    return STATUS_CERTIFICATE.request_cert;
   if (
     userData?.certificationId &&
     !userData?.cangenerate &&
@@ -25,7 +30,6 @@ const getCertificateStatus = (userData, certificateInDevice) => {
     userData?.certificatestatus !== STATUS_CERTIFICATE.revoque
   )
     return STATUS_CERTIFICATE.certificate_another_device;
-
   if (userData?.requestscert?.pending && userData?.certificationId)
     return STATUS_CERTIFICATE.request_revoque;
   if (
@@ -33,10 +37,7 @@ const getCertificateStatus = (userData, certificateInDevice) => {
     userData?.certificatestatus === STATUS_CERTIFICATE.revoque
   )
     return STATUS_CERTIFICATE.revoque;
-
-  if (!userData?.approvedUser) return STATUS_CERTIFICATE.request;
   if (userData?.cangenerate) return STATUS_CERTIFICATE.generate;
-
   if (userData?.certificationId) return STATUS_CERTIFICATE.current;
 
   return STATUS_CERTIFICATE.revoque;

package/src/utils/httpClient.js

@@ -16,8 +16,7 @@ export const initHttpClient = () => {
     !config.apiUrl ||
     !config.secretKey ||
     !config.apiKey ||
-    !config.verificationId ||
-    !config.customerId
+    !config.verificationId
   ) {
     throw new Error(
       "HttpClient: Configuración de inicialización incompleta. Llama a apacuana.init() primero."

package/tests/api/certs.test.js

@@ -85,9 +85,9 @@ describe("Certificate API - certs.js", () => {
 
   describe("getCertStatus", () => {
     it("should return the certificate status from helpers", () => {
-      const mockUserData = { certStatus: "VALID" };
+      const mockUserData = { certStatus: "SOLICITUD" };
       getConfig.mockReturnValue({ userData: mockUserData });
-      helpers.getCertificateStatus.mockReturnValue("VALID");
+      helpers.getCertificateStatus.mockReturnValue("SOLICITUD");
 
       const result = getCertStatus(true);
 
@@ -96,7 +96,15 @@ describe("Certificate API - certs.js", () => {
         true
       );
       expect(result).toBeInstanceOf(ApacuanaSuccess);
-      expect(result.data).toEqual({ status: "VALID" });
+
+      // --- CORRECCIÓN AQUÍ: El objeto esperado debe estar anidado en la clave 'status' ---
+      expect(result.data).toEqual({
+        status: {
+          text: "Por verificar",
+          descriptionText:
+            "La información y documentos enviados están siendo revisados por la Autoridad de Registro.",
+        },
+      });
     });
   });
 

package/tests/api/revocations.test.js

@@ -36,7 +36,7 @@ describe("Revocations API", () => {
 
       expect(httpRequest).toHaveBeenCalledWith(
         "services/api/onboardingclient/requestcert",
-        params,
+        { reason: params.reasonCode },
         "POST"
       );
       expect(result).toBeInstanceOf(ApacuanaSuccess);

package/tests/api/users.test.js

@@ -2,8 +2,8 @@
 import { httpRequest } from "../../src/utils/httpClient.js";
 import { getConfig } from "../../src/config/index.js";
 import { ApacuanaAPIError } from "../../src/errors/index.js";
-import getCustomer from "../../src/api/users.js";
 import ApacuanaSuccess from "../../src/success/index.js";
+import { getCustomer } from "../../src/api/users.js";
 
 // Mockear las dependencias:
 jest.mock("../../src/utils/httpClient.js", () => ({