@leotoloza/kernel NPM

@leotoloza/kernel

Microkernel modular dinámico para Node.js.
Permite cargar módulos desde carpetas, emitir y escuchar eventos entre ellos, y organizar la estructura de una aplicación de forma desacoplada.

🧠 ¿Qué es esto?

Este microkernel fue diseñado para crear aplicaciones modulares en Node.js, donde cada módulo puede tener su propio contexto y lógica interna, sin necesidad de depender directamente de otros.

Los módulos pueden ser detectados y cargados automáticamente desde un directorio, además de comunicarse entre sí mediante un sistema de eventos.

✨ Características principales

Carga dinámica de módulos
Sistema de eventos entre módulos
Arquitectura desacoplada
Soporte para rutas personalizadas
Hot-reloading de módulos

🚀 Instalación

pnpm add @leotoloza/kernel
# o
npm install @leotoloza/kernel
# o
yarn add @leotoloza/kernel

🛠️ Uso básico

// Ejemplo básico
import Kernel from "@leotoloza/kernel";

const kernel = new Kernel();
await kernel.iniciar();

// Ejemplo con ruta personalizada
import path from "path";
const rutaPersonalizada = path.resolve("src");
const kernel = new Kernel(rutaPersonalizada);
await kernel.iniciar();

El kernel puede inicializarse de dos formas: 1. Sin parámetros: cargará los módulos desde la carpeta /modulos en la raíz 2. Con ruta personalizada: cargará los módulos desde la ruta especificada

🐜 Bug fix

Ahora se puede pasar una ruta por parámetro al inicializar el microkernel, por ejemplo:

import path from "path";
const ruta = path.resolve("src"); // Esto devuelve la ruta absoluta

📦 Estructura de carpetas esperada

/src
  /modulos
    /usuarios
      index.ts       # Punto de entrada del módulo
      Controller.ts  # Controlador del módulo
      Router.ts      # Rutas del módulo
      Model.ts      # Modelo de datos
      Repository.ts  # Repositorio de datos
    /productos
      ...

Cada módulo debe tener al menos un archivo index.ts como punto de entrada.