@vidisoft/agendateapp-codes

Lista centralizada de códigos y mensajes usados por los microservicios de AgendateApp.

Estructura

El archivo principal es index.js. Cada código expone:

| Campo | Descripción | Ejemplo | |-------|-------------|---------| | code | Código HTTP lógico de la respuesta | 202, 500 | | name | Identificador del código | W-025 | | message | Mensaje (puede usar {0}, {1}, …) | Required field: {0} |

// Ejemplo de entrada en index.js
W_025: {
  code: 202,
  name: 'W-025',
  message: 'Field {0} requires at least {1} characters. El campo {0} requiere al menos {1} caracteres.'
}

Uso en un microservicio

import code from '@vidisoft/agendateapp-codes'

// Acceso directo
console.log(code.G_200.message) // "Successful"

// Con placeholders (en el consumidor)
const msg = code.W_025.message.replace('{0}', 'detalle').replace('{1}', '10')

Publicar una nueva versión

La publicación en npm la realiza el mantenedor del paquete.

1. Editar index.js con los códigos nuevos o cambios de mensaje.
2. Incrementar la versión en package.json (semver: patch para mensajes, minor si añades códigos compatibles).
3. Desde la carpeta agendateapp-codes:

npm login          # si la sesión expiró
npm publish --access public

4. Comprobar:

npm view @vidisoft/agendateapp-codes version

Actualizar en los proyectos consumidores

En agendateapp.main, agendateapp.otp, agendateapp.files y agendateapp.notification, declarar la dependencia con caret (igual que el resto de paquetes):

"@vidisoft/agendateapp-codes": "^1.0.6"

Luego en cada proyecto:

npm install

El package-lock.json debe resolver desde https://registry.npmjs.org/, no desde rutas file: locales.

Changelog reciente

1.0.7

• W_027: sin relación conductor–vehículo para los ids enviados ({0} = id enviado, {1} = vehículo).
• W_028: relación encontrada pero no se pudo eliminar ({0} = id registro Conductores).
• W_029: conductores encontrados en el vehículo; requiere force:true ({0} = cantidad).
• W_030: ningún conductor vinculado al vehículo ({0} = id vehículo).

1.0.6

• W_025: longitud mínima de campo ({0} = campo, {1} = mínimo).
• W_026: longitud máxima de campo.
• W_023 / W_024: mensajes por defecto documentados (conflictos de placa/propietario en registro).

Prueba local (opcional)

Solo para desarrollo sin publicar aún:

npm pack
npm install ./vidisoft-agendateapp-codes-X.Y.Z.tgz

En producción y Docker se usa siempre la versión publicada en npm con ^ en package.json.