Breviarium Core
Librería TypeScript con la Liturgia de las Horas completa y las lecturas de la Misa, asociadas a cada fecha del calendario litúrgico.
Breviarium Core (breviarium en npm) es la librería que da vida a la aplicación Breviarium. Dada una fecha, devuelve los textos completos para rezar cualquier hora del Oficio divino y las lecturas de la Misa del día, sin conexión a internet y sin servidor.
- Todas las horas: Invitatorio, Oficio de lectura, Laudes, Tercia, Sexta, Nona, Vísperas y Completas.
- Lecturas de la Misa: primera y segunda lectura, salmo, aclamación, Evangelio y comentario patrístico.
- Información del día: celebración, rango, color litúrgico, tiempo, semana del salterio y ciclo dominical.
- 100 % offline: todos los textos van incluidos en el paquete.
- Calendario de España: el cálculo de fechas se apoya en Romcal con el calendario propio de España.
Idioma y edición
Los textos están en español y siguen la edición española de la Liturgia de las Horas. Por eso los salmos usan la numeración de la Vulgata (por ejemplo, el Salmo 94 es el 95 de la numeración hebrea).
Instalación
npm install breviariumFunciona en Node.js 18+ y en navegadores modernos. Incluye tipos de TypeScript, y se puede importar como ES module o CommonJS.
Inicio rápido
import { Breviarium } from 'breviarium';
// Sin argumentos usa la fecha de hoy
const breviarium = new Breviarium();
const info = await breviarium.getLiturgyInformation();
console.log(info.celebration); // "Lunes de la 11ª semana del Tiempo Ordinario"
const [laudes] = (await breviarium.getLaudes()) ?? [];
console.log(laudes?.himno);
console.log(laudes?.oracion_final);Para otra fecha, pásala al constructor, cámbiala con setDate() o envíala a cada método:
const breviarium = new Breviarium(new Date(2025, 11, 25)); // 25 de diciembre de 2025
await breviarium.getVesperae(); // usa la fecha de la instancia
await breviarium.getVesperae(new Date(2026, 3, 5)); // fecha puntual, no cambia la instancia
breviarium.setDate(new Date(2026, 0, 1)); // cambia la fecha de la instanciaLos meses empiezan en 0
En JavaScript, new Date(2025, 11, 25) es el 25 de diciembre. Evita new Date('2025-12-25'): se interpreta en UTC y, según tu zona horaria, puede caer en el día anterior. Más detalles en Conceptos clave.
Qué devuelve cada método
| Método | Hora o contenido | Devuelve |
|---|---|---|
getLiturgyInformation | Datos del día litúrgico | LiturgyInformationOutput |
getInvitatorium | Antífona del Invitatorio | InvitatoriumSchemaOutput |
getInvitatoriumPsalms | Salmos del Invitatorio | array |
getOfficium | Oficio de lectura | OfficiumSchemaOutput |
getLaudes | Laudes | LaudesSchemaOutput[] |
getTertia, getSexta, getNona | Hora intermedia | IntermediateSchemaOutput |
getVesperae | Vísperas | VesperaeSchemaOutput[] |
getCompletorium | Completas | CompletoriumSchemaOutput |
getLectures | Lecturas de la Misa | LecturesSchemaOutput[] |
getEvangelium | Evangelio del día | EvangeliumSchemaOutput |
Todos los métodos de contenido son asíncronos y devuelven una Promise.
Siguientes pasos
Conceptos clave
Cómo se resuelve una fecha, qué son los ciclos y por qué Laudes devuelve varias opciones.
Formato de los textos
Las marcas de rúbricas, antífonas y saltos de línea, y cómo convertirlas en HTML.
Referencia de la API
Cada método con sus parámetros, la respuesta completa y ejemplos reales.
Cómo funciona por dentro
De la fecha al texto: Romcal, la base de datos y los mappers.
Enlaces
- Código fuente: github.com/Breviarium-app/breviarium--core
- Paquete npm: npmjs.com/package/breviarium
- Incidencias y sugerencias: GitHub Issues
Librerías: Core, Sanctus, Biblia de Jerusalén
Las librerías open-source del proyecto Breviarium, para construir aplicaciones de Liturgia de las Horas, lecturas de la Misa y santoral.
Conceptos clave
Cómo resuelve la librería una fecha, qué significan los ciclos y las opciones, y qué hacer cuando falta un texto.