Introducción

TypeScript

JavaScript

NodeJS

Browser

@beyond-js/reactive es una potente librería TypeScript diseñada para proporcionar una Capa de Inteligencia de Datos para tu aplicación. Al centralizar la lógica de negocio, la validación y la reactividad dentro de tus estructuras de datos, permite a los desarrolladores construir aplicaciones escalables y agnósticas al framework que son increíblemente fáciles de entender y mantener para agentes de IA.

---

🧭 Ruta de Aprendizaje

Elige tu camino para dominar @beyond-js/reactive:

1. Visión y Conceptos Básicos

• Filosofía y Visión: Por qué la lógica de negocio pertenece a los datos y cómo impacta en el desarrollo con IA.

• Inicio Rápido: Instala y construye tu primer modelo en 2 minutos.

2. Fundamentos

• ReactiveModel: La clase base para todos los objetos reactivos.

• Interfaces: Contratos unificados para el manejo polimórfico.

3. Entidades de Dominio

• Items: Gestión de entidades individuales con IDs y ciclo de vida.

• Colecciones: Grupos de items con filtrado y paginación.

• Propiedades Anidadas: Modelado de relaciones complejas.

4. Estructuras Reactivas

• ReactiveMap: Almacenamiento reactivo clave-valor.

• ReactiveArray: Métodos de array estándar con eventos reactivos.

• ReactiveTree: Gestión de datos jerárquicos.

5. Avanzado y Arquitectura

• Guía de Integración (React & Zustand): Cómo coexistir con gestores de estado de UI.

• Providers: Desacoplamiento del acceso a datos (APIs, Bases de Datos).

• Plugins: Extensión de funcionalidad con aspectos transversales.

• Ejemplos Prácticos: Escenarios de implementación del mundo real.

---

✨ ¿Por qué elegir esta librería?

🎯 Lógica Centrada en los Datos

Deja de filtrar reglas de validación y negocio en tus componentes React. Defínelas una vez en tus modelos y úsalas en cualquier lugar (Frontend, Backend, Mobile).

🤖 Desarrollo Optimizado para IA

Los agentes de IA (Cursor, Copilot) rinden mejor cuando el código tiene una estructura explícita. El uso de Zod y la lógica encapsulada hace que esta librería sea autodocumentada para la IA.

🔌 Agnóstico al Framework

Compatible con React, Vue, Svelte o Node.js. No reemplaza a Zustand o Redux; maneja la capa de datos mientras ellos manejan el estado de la UI.

✅ Inteligencia Integrada

• Validación con Zod: Integración nativa de esquemas.

• Seguimiento de Cambios: Detecta automáticamente cambios no publicados.

• Sistema de Eventos: Reactividad de grano fino.

---

🚀 Fragmento de Inicio Rápido

import { Item } from '@beyond-js/reactive/entities/item';

class Producto extends Item<IProduct> {
  constructor(data) {
    super({
      entity: 'products',
      properties: ['name', 'price'],
      ...data
    });
  }
}

const miProducto = new Producto({ name: 'Laptop', price: 999 });
miProducto.on('change', () => console.log('¡Actualizado!'));
miProducto.name = 'Pro Laptop'; // Dispara el evento

---

🤝 Comunidad y Soporte

• CHANGELOG

• Guía de Migración

• Contribución