@sovrahq/core

@quarkid/core

Descripción

@quarkid/core es un paquete fundamental que provee infraestructura arquitectónica base para el ecosistema QuarkID. Implementa patrones CQRS (Command Query Responsibility Segregation), mediadores, inyección de dependencias y un sistema de eventos ligero.

Este paquete no agrega funcionalidad de negocio, sino que expone abstracciones e infraestructura que son consumidas por otros paquetes del monorepo QuarkID.

Tecnologías y Dependencias Clave

• TypeScript (~4.5.4)
• reflect-metadata (^0.1.13) - Soporte para decoradores y metadatos

DevDependencies

• Inversify (^6.0.1) - Contenedor de inyección de dependencias
• Jest (^28.0.3) - Testing

Instalación

npm

npm install @quarkid/core

yarn

yarn add @quarkid/core

pnpm

pnpm add @quarkid/core

API / Exports Principales

Export	Descripción
ICommand	Interfaz base para comandos CQRS
ICommandHandler	Interfaz para handlers de comandos
INotification	Interfaz base para notificaciones
INotificationHandler	Interfaz para handlers de notificaciones
IMediator / Mediator	Implementación del patrón Mediator para CQRS
DIService	Servicio de inyección de dependencias
Injectable	Decorador para marcar clases inyectables
LiteEvent	Sistema de eventos ligero y type-safe

Configuración / Variables de Entorno

⚠️ No requiere configuración externa. Es un paquete de infraestructura pura.

Compatibilidad

• Node.js: >= 14.x
• TypeScript: >= 4.5.4
• Entornos: Backend (Node.js), puede funcionar en bundlers modernos (Webpack, Vite)

⚠️ Nota: Requiere soporte para decoradores TypeScript (experimentalDecorators: true en tsconfig.json).

Versionado y Publicación

• Versión actual: 1.0.7
• Build previo: Ejecutar npm run build antes de publicar
• Estructura de salida: dist/index.js (CommonJS)

Licencia

Apache-2.0

Ver archivo LICENSE en la raíz del monorepo.

Mantenido por: QuarkID Team
Repositorio: https://github.com/ssi-quarkid/Paquetes-NPMjs/tree/main