softdinlibreriajs 12.0.42 → 12.0.44

package/.github/workflows/publish.yml

@@ -0,0 +1,33 @@
+name: Publish to npm
+
+# Se dispara al crear un tag de versión (ej. v12.0.44) o manualmente desde Actions.
+on:
+  push:
+    tags:
+      - 'v*'
+      - 'V*'
+  workflow_dispatch:
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Show package version
+        run: node -p "require('./package.json').version"
+
+      - name: Publish to npm
+        run: npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/package.json

@@ -1,23 +1,23 @@
-{
-  "name": "softdinlibreriajs",
-  "version": "12.0.42",
-  "description": "Libreria Softdin",
-  "main": "src/",
-  "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/SoftdinNomina/libreriaSoftdinJS.git"
-  },
-  "keywords": [
-    "keyword"
-  ],
-  "author": "Deivi Ibarra Negrette",
-  "license": "MIT",
-  "bugs": {
-    "url": "https://github.com/SoftdinNomina/libreriaSoftdinJS/issues"
-  },
-  "homepage": "https://github.com/SoftdinNomina/libreriaSoftdinJS#readme",
-  "_comments": "comando para ejecutar las veriosnes despues debe cambiar la VERSION 12.0.24  por la que sigue despues ejecutar este comando npm publish"
-}
+{
+  "name": "softdinlibreriajs",
+  "version": "12.0.44",
+  "description": "Libreria Softdin",
+  "main": "src/",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/DinSoftdin/libreriaSoftdinJS.git"
+  },
+  "keywords": [
+    "keyword"
+  ],
+  "author": "Deivi Ibarra Negrette",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/DinSoftdin/libreriaSoftdinJS/issues"
+  },
+  "homepage": "https://github.com/DinSoftdin/libreriaSoftdinJS#readme",
+  "_comments": "comando para ejecutar las veriosnes despues debe cambiar la VERSION 12.0.24  por la que sigue despues ejecutar este comando npm publish"
+}

package/src/EnumActualizacionWEB.js

@@ -1,3 +1,6 @@
+/**
+ * Enumeración de estados de actualización en la aplicación web.
+ */
 export class EnumActualizacionWEB {
     static REGISTRADO = 1;
     static NO_REGISTRADO = 3;
@@ -19,14 +22,28 @@ export class EnumActualizacionWEB {
         { id: EnumActualizacionWEB.INACTIVO, code: 'INACTIVO', description: "Inactivo" }
     ];
 
+    /**
+     * Obtiene un elemento por su identificador.
+     * @param {number} id - Identificador del elemento.
+     * @returns {Object|null} El objeto con id, code y description, o null si no existe.
+     */
     static getById(id) {
         return EnumActualizacionWEB.descriptions.find(item => item.id === id) || null;
     }
 
+    /**
+     * Obtiene todos los elementos de la enumeración.
+     * @returns {Array} Lista de objetos con id, code y description.
+     */
     static getAll() {
         return EnumActualizacionWEB.descriptions;
     }
 
+    /**
+     * Obtiene un elemento por su descripción.
+     * @param {string} description - Descripción del elemento.
+     * @returns {Object|null} El objeto con id, code y description, o null si no existe.
+     */
     static getByDescription(description) {
         return EnumActualizacionWEB.descriptions.find(item => item.description === description) || null;
     }

package/src/EnumAplicacionConceptoNovedadEmpresal.js

@@ -1,3 +1,6 @@
+/**
+ * Enumeración de aplicacionconceptonovedadempresal.
+ */
 class EnumAplicacionConceptoNovedadEmpresal {
     static INDIVIDUAL = 1;
     static TODOS = 2;
@@ -8,14 +11,30 @@ class EnumAplicacionConceptoNovedadEmpresal {
         { id: EnumAplicacionConceptoNovedadEmpresal.TODOS, code: 'TODOS', description: 'Todos' },
         { id: EnumAplicacionConceptoNovedadEmpresal.AGRUPAR, code: 'AGRUPAR', description: 'Agrupar' },
     ];
+/**
+* Obtiene un elemento por su identificador.
+* @param {number} id - Identificador del elemento.
+
+     * @returns {Object|null} El objeto con id, code y description, o null si no existe.
+*/
 
     static getById(id) {
         return EnumAplicacionConceptoNovedadEmpresal.descriptions.find(item => item.id === id) || null;
     }
+/**
+* Obtiene todos los elementos de la enumeración.
+* @returns {Array} Lista de objetos con id, code y description.
+*/
 
     static getAll() {
         return EnumAplicacionConceptoNovedadEmpresal.descriptions;
     }
+/**
+* Obtiene un elemento por su descripción.
+* @param {string} description - Descripción del elemento.
+
+     * @returns {Object|null} El objeto con id, code y description, o null si no existe.
+*/
 
     static getByDescription(description) {
         return EnumAplicacionConceptoNovedadEmpresal.descriptions.find(item => item.description === description) || null;

package/src/EnumArchivoPlano.js

@@ -1,3 +1,6 @@
+/**
+ * Enumeración de archivoplano.
+ */
 class EnumArchivoPlano {
     static BANCO_BOGOTA = 1;
     static BANCOLOMBIA = 2;
@@ -12,14 +15,30 @@ class EnumArchivoPlano {
         { id: EnumArchivoPlano.BANCO_BBVA, code: 'BANCO_BBVA', description: 'BANCO BBVA' },
         { id: EnumArchivoPlano.JURISCOL, code: 'JURISCOL', description: 'JURISCOL' },
     ];
+/**
+* Obtiene un elemento por su identificador.
+* @param {number} id - Identificador del elemento.
+
+     * @returns {Object|null} El objeto con id, code y description, o null si no existe.
+*/
 
     static getById(id) {
         return EnumArchivoPlano.descriptions.find(item => item.id === id) || null;
     }
+/**
+* Obtiene todos los elementos de la enumeración.
+* @returns {Array} Lista de objetos con id, code y description.
+*/
 
     static getAll() {
         return EnumArchivoPlano.descriptions;
     }
+/**
+* Obtiene un elemento por su descripción.
+* @param {string} description - Descripción del elemento.
+
+     * @returns {Object|null} El objeto con id, code y description, o null si no existe.
+*/
 
     static getByDescription(description) {
         return EnumArchivoPlano.descriptions.find(item => item.description === description) || null;

package/src/EnumAreaTrabajo.js

@@ -1,3 +1,6 @@
+/**
+ * Enumeración de areatrabajo.
+ */
 class EnumAreaTrabajo {
     static ADMINISTRATIVO = 1;
     static OPERATIVO = 2;
@@ -6,14 +9,30 @@ class EnumAreaTrabajo {
         { id: EnumAreaTrabajo.ADMINISTRATIVO, code: 'ADMINISTRATIVO', description: 'Administrativo' },
         { id: EnumAreaTrabajo.OPERATIVO, code: 'OPERATIVO', description: 'Operativo' },
     ];
+/**
+* Obtiene un elemento por su identificador.
+* @param {number} id - Identificador del elemento.
+
+     * @returns {Object|null} El objeto con id, code y description, o null si no existe.
+*/
 
     static getById(id) {
         return EnumAreaTrabajo.descriptions.find(item => item.id === id) || null;
     }
+/**
+* Obtiene todos los elementos de la enumeración.
+* @returns {Array} Lista de objetos con id, code y description.
+*/
 
     static getAll() {
         return EnumAreaTrabajo.descriptions;
     }
+/**
+* Obtiene un elemento por su descripción.
+* @param {string} description - Descripción del elemento.
+
+     * @returns {Object|null} El objeto con id, code y description, o null si no existe.
+*/
 
     static getByDescription(description) {
         return EnumAreaTrabajo.descriptions.find(item => item.description === description) || null;

package/src/EnumCertificadoIngresosAportesListado.js

@@ -1,3 +1,6 @@
+/**
+ * Enumeración de certificadoingresosaporteslistado.
+ */
 class EnumCertificadoIngresosAportesListado {
     static No36 = 1;
     static No37 = 2;
@@ -52,14 +55,30 @@ class EnumCertificadoIngresosAportesListado {
         { id: EnumCertificadoIngresosAportesListado.No59, code: "No59", description: "59 Ingreso laboral promedio de los últimos seis meses anteriores (numeral 4 art. 206 E.T.)" },
         { id: EnumCertificadoIngresosAportesListado.No60, code: "No60", description: "60 Valor de la retención en la fuente por ingresos laborales y de pensiones" }
     ];
+/**
+* Obtiene un elemento por su identificador.
+* @param {number} id - Identificador del elemento.
+
+     * @returns {Object|null} El objeto con id, code y description, o null si no existe.
+*/
 
     static getById(id) {
         return EnumCertificadoIngresosAportesListado.descriptions.find(item => item.id === id) || null;
     }
+/**
+* Obtiene todos los elementos de la enumeración.
+* @returns {Array} Lista de objetos con id, code y description.
+*/
 
     static getAll() {
         return EnumCertificadoIngresosAportesListado.descriptions;
     }
+/**
+* Obtiene un elemento por su descripción.
+* @param {string} description - Descripción del elemento.
+
+     * @returns {Object|null} El objeto con id, code y description, o null si no existe.
+*/
 
     static getByDescription(description) {
         return EnumCertificadoIngresosAportesListado.descriptions.find(item => item.description === description) || null;

package/src/EnumClaseEmpresa.js

@@ -1,3 +1,6 @@
+/**
+ * Enumeración de claseempresa.
+ */
 class EnumClaseEmpresa {
     static EMPRESA = 1;
     static COOPERATIVA = 2;
@@ -10,14 +13,30 @@ class EnumClaseEmpresa {
         { id: EnumClaseEmpresa.BANCO, code: 'BAN', description: 'BANCO' },
         { id: EnumClaseEmpresa.PILA, code: 'PIL', description: 'PILA' },
     ];
+/**
+* Obtiene un elemento por su identificador.
+* @param {number} id - Identificador del elemento.
+
+     * @returns {Object|null} El objeto con id, code y description, o null si no existe.
+*/
 
     static getById(id) {
         return EnumClaseEmpresa.descriptions.find(item => item.id === id) || null;
     }
+/**
+* Obtiene todos los elementos de la enumeración.
+* @returns {Array} Lista de objetos con id, code y description.
+*/
 
     static getAll() {
         return EnumClaseEmpresa.descriptions;
     }
+/**
+* Obtiene un elemento por su descripción.
+* @param {string} description - Descripción del elemento.
+
+     * @returns {Object|null} El objeto con id, code y description, o null si no existe.
+*/
 
     static getByDescription(description) {
         return EnumClaseEmpresa.descriptions.find(item => item.description === description) || null;

package/src/EnumClaseRiesgoActividad.js

@@ -0,0 +1,99 @@
+/**
+ * Clases de riesgo de la actividad económica (ARL / Decreto 1072 de 2015).
+ * Tarifas de cotización sobre el IBC.
+ */
+class EnumClaseRiesgoActividad {
+    static CLASE_I = 1;
+    static CLASE_II = 2;
+    static CLASE_III = 3;
+    static CLASE_IV = 4;
+    static CLASE_V = 5;
+
+    static descriptions = [
+        {
+            id: EnumClaseRiesgoActividad.CLASE_I,
+            code: 'CLASE_I',
+            description: 'Clase I - Riesgo mínimo',
+            porcentaje: 0.522,
+        },
+        {
+            id: EnumClaseRiesgoActividad.CLASE_II,
+            code: 'CLASE_II',
+            description: 'Clase II - Riesgo bajo',
+            porcentaje: 1.044,
+        },
+        {
+            id: EnumClaseRiesgoActividad.CLASE_III,
+            code: 'CLASE_III',
+            description: 'Clase III - Riesgo medio',
+            porcentaje: 2.436,
+        },
+        {
+            id: EnumClaseRiesgoActividad.CLASE_IV,
+            code: 'CLASE_IV',
+            description: 'Clase IV - Riesgo alto',
+            porcentaje: 4.350,
+        },
+        {
+            id: EnumClaseRiesgoActividad.CLASE_V,
+            code: 'CLASE_V',
+            description: 'Clase V - Riesgo máximo',
+            porcentaje: 6.960,
+        },
+    ];
+
+    /**
+     * Obtiene un elemento por su identificador.
+     * @param {number} id - Identificador del elemento.
+     * @returns {Object|null} El objeto con id, code, description y porcentaje, o null si no existe.
+     */
+    static getById(id) {
+        return EnumClaseRiesgoActividad.descriptions.find((item) => item.id === id) || null;
+    }
+
+    /**
+     * Obtiene todos los elementos de la enumeración.
+     * @returns {Array} Lista de objetos con id, code, description y porcentaje.
+     */
+    static getAll() {
+        return EnumClaseRiesgoActividad.descriptions;
+    }
+
+    /**
+     * Obtiene un elemento por su descripción.
+     * @param {string} description - Descripción del elemento.
+     * @returns {Object|null} El objeto encontrado o null si no existe.
+     */
+    static getByDescription(description) {
+        return (
+            EnumClaseRiesgoActividad.descriptions.find(
+                (item) => item.description === description,
+            ) || null
+        );
+    }
+
+    /**
+     * Obtiene un elemento por su porcentaje de cotización ARL.
+     * @param {number} porcentaje - Porcentaje sobre el IBC.
+     * @returns {Object|null} El objeto encontrado o null si no existe.
+     */
+    static getByPorcentaje(porcentaje) {
+        return (
+            EnumClaseRiesgoActividad.descriptions.find(
+                (item) => Math.abs(item.porcentaje - porcentaje) < 0.0001,
+            ) || null
+        );
+    }
+
+    /**
+     * Retorna el porcentaje de cotización ARL de una clase.
+     * @param {number} id - Identificador de la clase.
+     * @returns {number|null} Porcentaje o null si no existe.
+     */
+    static getPorcentaje(id) {
+        const item = EnumClaseRiesgoActividad.getById(id);
+        return item ? item.porcentaje : null;
+    }
+}
+
+module.exports = EnumClaseRiesgoActividad;

package/src/EnumConceptosCertificacion.js

@@ -1,3 +1,6 @@
+/**
+ * Enumeración de conceptoscertificacion.
+ */
 class EnumConceptosCertificacion {
     static NIT = 1;
     static RAZON_SOCIAL = 2;
@@ -26,7 +29,7 @@ class EnumConceptosCertificacion {
     static CESANTIAS = 25;
     static MOTIVO_RETIRO = 26;
     static FECHA_ACTUAL_LARGO = 27;
-    static FECHA_ACTUAL_CORTO = 27;
+    static FECHA_ACTUAL_CORTO = 28;
     static DESCRIPCION_CARGO = 29;
     static SALARIO_LETRAS = 30;
     static DESCRIPCION_CONTRATO = 31;
@@ -80,7 +83,7 @@ class EnumConceptosCertificacion {
         { id: EnumConceptosCertificacion.CESANTIAS, description2: "CESANTIAS", code: "<<25>>", description: "<<25>> CESANTIAS" },
         { id: EnumConceptosCertificacion.MOTIVO_RETIRO, description2: "MOTIVO RETIRO", code: "<<26>>", description: "<<26>> MOTIVO RETIRO" },
         { id: EnumConceptosCertificacion.FECHA_ACTUAL_LARGO, description2: "FECHA ACTUAL LARGO", code: "<<27>>", description: "<<27>> FECHA ACTUAL LARGO" },
-        { id: EnumConceptosCertificacion.FECHA_ACTUAL_CORTO, description2: "FECHA ACTUAL CORTO", code: "<<27>>", description: "<<27>> FECHA ACTUAL CORTO" },
+        { id: EnumConceptosCertificacion.FECHA_ACTUAL_CORTO, description2: "FECHA ACTUAL CORTO", code: "<<28>>", description: "<<28>> FECHA ACTUAL CORTO" },
         { id: EnumConceptosCertificacion.DESCRIPCION_CARGO, description2: "DESCRIPCION CARGO", code: "<<29>>", description: "<<29>> DESCRIPCION CARGO" },
         { id: EnumConceptosCertificacion.SALARIO_LETRAS, description2: "SALARIO LETRAS", code: "<<30>>", description: "<<30>> SALARIO LETRAS" },
         { id: EnumConceptosCertificacion.DESCRIPCION_CONTRATO, description2: "DESCRIPCION CONTRATO", code: "<<31>>", description: "<<31>> DESCRIPCION CONTRATO" },
@@ -106,14 +109,30 @@ class EnumConceptosCertificacion {
         { id: EnumConceptosCertificacion.EMAIL, description2: "EMAIL", code: "<<51>>", description: "<<51>> EMAIL" },
         { id: EnumConceptosCertificacion.TEL_EMERGENCIA, description2: "TEL EMERGENCIA", code: "<<52>>", description: "<<52>> TEL EMERGENCIA" }
     ];
+/**
+* Obtiene un elemento por su identificador.
+* @param {number} id - Identificador del elemento.
+
+     * @returns {Object|null} El objeto con id, code y description, o null si no existe.
+*/
 
     static getById(id) {
         return EnumConceptosCertificacion.descriptions.find(item => item.id === id) || null;
     }
+/**
+* Obtiene todos los elementos de la enumeración.
+* @returns {Array} Lista de objetos con id, code y description.
+*/
 
     static getAll() {
         return EnumConceptosCertificacion.descriptions;
     }
+/**
+* Obtiene un elemento por su descripción.
+* @param {string} description - Descripción del elemento.
+
+     * @returns {Object|null} El objeto con id, code y description, o null si no existe.
+*/
 
     static getByDescription(description) {
         return EnumConceptosCertificacion.descriptions.find(item => item.description === description) || null;

package/src/EnumConceptosContrato.js

@@ -1,3 +1,6 @@
+/**
+ * Enumeración de conceptoscontrato.
+ */
 class EnumConceptosContrato {
     static AREATRABAJO = 1;
     static CARGO = 2;
@@ -18,14 +21,30 @@ class EnumConceptosContrato {
         { id: EnumConceptosContrato.SUCURSALPILA, codigo: 'SUCURSALPILA', description: "Sucursal PILA" },
         { id: EnumConceptosContrato.TIPOCONTRATO, codigo: 'TIPOCONTRATO', description: "Tipo de Contrato" },
     ];
+/**
+* Obtiene un elemento por su identificador.
+* @param {number} id - Identificador del elemento.
+
+     * @returns {Object|null} El objeto con id, code y description, o null si no existe.
+*/
 
     static getById(id) {
         return EnumConceptosContrato.descriptions.find(item => item.id === id) || null;
     }
+/**
+* Obtiene todos los elementos de la enumeración.
+* @returns {Array} Lista de objetos con id, code y description.
+*/
 
     static getAll() {
         return EnumConceptosContrato.descriptions;
     }
+/**
+* Obtiene un elemento por su descripción.
+* @param {string} description - Descripción del elemento.
+
+     * @returns {Object|null} El objeto con id, code y description, o null si no existe.
+*/
 
     static getByDescription(description) {
         return EnumConceptosContrato.descriptions.find(item => item.description === description) || null;

package/src/EnumContinente.js

@@ -1,3 +1,6 @@
+/**
+ * Enumeración de continente.
+ */
 class EnumContinente {
     static ASIA = 1;
     static AFRICA = 2;
@@ -13,14 +16,30 @@ class EnumContinente {
         { id: EnumContinente.AMERICA_NORTE, code: 'AMERICA_NORTE', description: 'América del Norte' },
         { id: EnumContinente.AMERICA_SUR, code: 'AMERICA_SUR', description: 'América del Sur' },
         { id: EnumContinente.OCEANIA, code: 'OCEANIA', description: 'Oceanía' },    ];
+/**
+* Obtiene un elemento por su identificador.
+* @param {number} id - Identificador del elemento.
+
+     * @returns {Object|null} El objeto con id, code y description, o null si no existe.
+*/
 
     static getById(id) {
         return EnumContinente.descriptions.find(item => item.id === id) || null;
     }
+/**
+* Obtiene todos los elementos de la enumeración.
+* @returns {Array} Lista de objetos con id, code y description.
+*/
 
     static getAll() {
         return EnumContinente.descriptions;
     }
+/**
+* Obtiene un elemento por su descripción.
+* @param {string} description - Descripción del elemento.
+
+     * @returns {Object|null} El objeto con id, code y description, o null si no existe.
+*/
 
     static getByDescription(description) {
         return EnumContinente.descriptions.find(item => item.description === description) || null;

package/src/EnumDiasSemana.js

@@ -1,3 +1,6 @@
+/**
+ * Enumeración de diassemana.
+ */
 class EnumDiasSemana {
     static LUNES = 1;
     static MARTES = 2;
@@ -16,14 +19,30 @@ class EnumDiasSemana {
         { id: EnumDiasSemana.SABADO, code: 'SABADO', description: 'Sabado' },
         { id: EnumDiasSemana.DOMINGO, code: 'DOMINGO', description: 'Domingo' },
     ];
+/**
+* Obtiene un elemento por su identificador.
+* @param {number} id - Identificador del elemento.
+
+     * @returns {Object|null} El objeto con id, code y description, o null si no existe.
+*/
 
     static getById(id) {
         return EnumDiasSemana.descriptions.find(item => item.id === id) || null;
     }
+/**
+* Obtiene todos los elementos de la enumeración.
+* @returns {Array} Lista de objetos con id, code y description.
+*/
 
     static getAll() {
         return EnumDiasSemana.descriptions;
     }
+/**
+* Obtiene un elemento por su descripción.
+* @param {string} description - Descripción del elemento.
+
+     * @returns {Object|null} El objeto con id, code y description, o null si no existe.
+*/
 
     static getByDescription(description) {
         return EnumDiasSemana.descriptions.find(item => item.description === description) || null;

package/src/EnumEstadoCalendario.js

@@ -1,3 +1,6 @@
+/**
+ * Enumeración de estadocalendario.
+ */
 class EnumEstadoCalendario {
     static NORMAL = 1;
     static FERIADO = 2;
@@ -6,14 +9,30 @@ class EnumEstadoCalendario {
         { id: EnumEstadoCalendario.NORMAL, code: 'NORMAL', description: 'Normal' },
         { id: EnumEstadoCalendario.FERIADO, code: 'FERIADO', description: 'Feriado' },
     ];
+/**
+* Obtiene un elemento por su identificador.
+* @param {number} id - Identificador del elemento.
+
+     * @returns {Object|null} El objeto con id, code y description, o null si no existe.
+*/
 
     static getById(id) {
         return EnumEstadoCalendario.descriptions.find(item => item.id === id) || null;
     }
+/**
+* Obtiene todos los elementos de la enumeración.
+* @returns {Array} Lista de objetos con id, code y description.
+*/
 
     static getAll() {
         return EnumEstadoCalendario.descriptions;
     }
+/**
+* Obtiene un elemento por su descripción.
+* @param {string} description - Descripción del elemento.
+
+     * @returns {Object|null} El objeto con id, code y description, o null si no existe.
+*/
 
     static getByDescription(description) {
         return EnumEstadoCalendario.descriptions.find(item => item.description === description) || null;
@@ -23,6 +42,12 @@ class EnumEstadoCalendario {
         'primary': EnumEstadoCalendario.NORMAL,
         'danger': EnumEstadoCalendario.FERIADO, // Default color for unknown states
     };
+/**
+* Obtiene un objeto con el mapeo de colores al valor del campo especificado.
+* @param {string} campo - Nombre del campo a extraer.
+
+     * @returns {Object} Objeto con claves de color y valores del campo.
+*/
 
     static getColors(campo) {
         const colorArray = {};
@@ -37,6 +62,14 @@ class EnumEstadoCalendario {
         }
         return colorArray;
     }
+/**
+* Obtiene el nombre del color asociado a un valor del campo especificado.
+* @param {string} campo - Nombre del campo a consultar.
+
+     * @param {*} valor - Valor a buscar.
+
+     * @returns {string|undefined} Nombre del color o undefined si no se encuentra.
+*/
 
     static getColorName(campo, valor) {
         const colors = EnumEstadoCalendario.getColors(campo);