@icarusmx/creta 1.3.3 → 1.3.5

package/lessons/lesson1-system-decomposition.js

@@ -1,313 +0,0 @@
-#!/usr/bin/env node
-
-// LECCIÓN 1: La parte difícil del diseño orientado a objetos es descomponer un sistema como un conjunto de objetos que interactúan entre sí
-// Enfoque práctico: Dos definiciones de sistema y su descomposición en objetos
-
-import { createInterface } from 'readline'
-
-export class Lesson1SystemDecomposition {
-  constructor() {
-    this.rl = createInterface({
-      input: process.stdin,
-      output: process.stdout
-    })
-  }
-
-  async start() {
-    await this.waitForEnter("\nPresiona Enter para comenzar...")
-
-    await this.practicalExercise()
-    await this.conclusion()
-
-    this.rl.close()
-  }
-
-  async practicalExercise() {
-    console.clear()
-    console.log("Comenzaremos con dos definiciones de sistema y posteriormente")
-    console.log("ejemplificaremos la descomposición en objetos.")
-
-    await this.waitForEnter("\nPresiona Enter para continuar...")
-
-    await this.step1_SystemDefinitions()
-    await this.step2_ApplyDefinitions()
-    await this.step3_ObjectIdentification()
-  }
-
-  async step1_SystemDefinitions() {
-    console.clear()
-    console.log("Definición 1:")
-    console.log("El sistema es una totalidad deductiva de discurso")
-
-    console.log("\nDefinición 2:")
-    console.log("El sistema es un conjunto de cosas que relacionadas")
-    console.log("entre sí ordenadamente contribuyen a un determinado propósito")
-
-    await this.waitForEnter("\nPresiona Enter para ver un ejemplo de sistema...")
-  }
-
-  async step2_ApplyDefinitions() {
-    console.clear()
-    console.log("🏛️ Ejemplo: Biblioteca Digital")
-    console.log("=" .repeat(40))
-
-    console.log("\n📚 Definición 1 - Totalidad deductiva de discurso:")
-    console.log("Partiendo de 'Biblioteca Digital', ¿qué se deduce naturalmente?")
-    await this.waitForEnter("\nPresiona Enter para ver la primera deducción...")
-
-    console.log("\n🔍 Primera deducción:")
-    console.log("• De 'Biblioteca' → contiene LIBROS")
-    console.log("• De 'Digital' → acceso remoto por USUARIOS")
-
-    await this.waitForEnter("\nPresiona Enter para ver la deducción clave...")
-
-    console.log("\n⚡ Deducción clave:")
-    console.log("• Libros + Usuarios → deben interactuar")
-    console.log("• ¿Cómo? → préstamos, búsquedas, devoluciones")
-    console.log("\n💡 Conclusión: De 'biblioteca digital' se deduce naturalmente")
-    console.log("   un conjunto de libros y usuarios interactuando")
-
-    await this.waitForEnter("\nPresiona Enter para la segunda definición...")
-
-    console.clear()
-    console.log("🎯 Definición 2 - Conjunto de cosas con propósito:")
-    console.log("¿Qué elementos relacionados contribuyen al propósito?")
-
-    console.log("\n📖 Elementos del sistema:")
-    console.log("• Libros - recursos que se prestan")
-    console.log("• Usuarios - quienes solicitan préstamos")
-    console.log("• Préstamos - relación temporal entre libro y usuario")
-    console.log("• Biblioteca - coordina todo el proceso")
-
-    console.log("\n🎯 Propósito determinado:")
-    console.log("Facilitar el acceso organizado a recursos bibliográficos")
-
-    console.log("\n🔗 Relaciones ordenadas:")
-    console.log("• Usuario solicita → Biblioteca evalúa → Préstamo se crea")
-    console.log("• Libro cambia estado → Usuario recibe acceso → Plazo se establece")
-    console.log("• Vencimiento llega → Usuario devuelve → Libro se libera")
-
-    await this.waitForEnter("\nPresiona Enter para ver la descomposición en objetos...")
-  }
-
-  async step3_ObjectIdentification() {
-    console.clear()
-    console.log("Descomposición en objetos:")
-
-    const bookCode = `class Book {
-  constructor(title, author, isbn) {
-    this.title = title
-    this.author = author
-    this.isbn = isbn
-    this.isLoaned = false
-  }
-
-  isAvailable() {
-    return !this.isLoaned
-  }
-
-  markAsLoaned() {
-    this.isLoaned = true
-  }
-
-  markAsReturned() {
-    this.isLoaned = false
-  }
-}`
-
-    this.printCodeWithColors("📄 Clase Book", bookCode)
-
-    await this.waitForEnter("\nPresiona Enter para ver User...")
-
-    const userCode = `class User {
-  constructor(name, email, maxLoans = 3) {
-    this.name = name
-    this.email = email
-    this.maxLoans = maxLoans
-    this.currentLoans = []
-  }
-
-  canBorrow() {
-    return this.currentLoans.length < this.maxLoans
-  }
-
-  addLoan(loan) {
-    this.currentLoans.push(loan)
-  }
-
-  removeLoan(loan) {
-    const index = this.currentLoans.indexOf(loan)
-    if (index > -1) this.currentLoans.splice(index, 1)
-  }
-}`
-
-    this.printCodeWithColors("📄 Clase User", userCode)
-
-    await this.waitForEnter("\nPresiona Enter para ver Loan...")
-
-    const loanCode = `class Loan {
-  constructor(user, book, durationDays = 14) {
-    this.user = user
-    this.book = book
-    this.startDate = new Date()
-    this.dueDate = new Date(Date.now() + durationDays * 24 * 60 * 60 * 1000)
-    this.returned = false
-  }
-
-  isOverdue() {
-    return !this.returned && new Date() > this.dueDate
-  }
-
-  calculateFine() {
-    if (!this.isOverdue()) return 0
-    const daysLate = Math.ceil((new Date() - this.dueDate) / (24 * 60 * 60 * 1000))
-    return daysLate * 5 // $5 por día
-  }
-
-  returnBook() {
-    this.returned = true
-    this.book.markAsReturned()
-    this.user.removeLoan(this)
-  }
-}`
-
-    this.printCodeWithColors("📄 Clase Loan", loanCode)
-
-    await this.waitForEnter("\nPresiona Enter para ver Library...")
-
-    console.log("\nclass Library {")
-    console.log("  constructor() {")
-    console.log("    this.books = []")
-    console.log("    this.users = []")
-    console.log("    this.loans = []")
-    console.log("  }")
-    console.log("")
-    console.log("  lendBook(user, book) {")
-    console.log("    if (!user.canBorrow()) return null")
-    console.log("    if (!book.isAvailable()) return null")
-    console.log("")
-    console.log("    const loan = new Loan(user, book)")
-    console.log("    book.markAsLoaned()")
-    console.log("    user.addLoan(loan)")
-    console.log("    this.loans.push(loan)")
-    console.log("    return loan")
-    console.log("  }")
-    console.log("")
-    console.log("  returnBook(loan) {")
-    console.log("    loan.returnBook()")
-    console.log("    return loan.calculateFine()")
-    console.log("  }")
-    console.log("")
-    console.log("  getOverdueLoans() {")
-    console.log("    return this.loans.filter(loan => loan.isOverdue())")
-    console.log("  }")
-    console.log("}")
-
-    await this.waitForEnter("\nPresiona Enter para ver la interacción...")
-
-    console.clear()
-    console.log("Ejemplo de uso:")
-    console.log("")
-    console.log("const library = new Library()")
-    console.log("const book = new Book('1984', 'George Orwell', '978-0451524935')")
-    console.log("const user = new User('Ana García', 'ana@email.com')")
-    console.log("")
-    console.log("// Los objetos interactúan entre sí")
-    console.log("const loan = library.lendBook(user, book)")
-    console.log("console.log(book.isAvailable())  // false")
-    console.log("console.log(user.canBorrow())    // true (2 préstamos disponibles)")
-    console.log("")
-    console.log("// Simular libro vencido")
-    console.log("loan.dueDate = new Date(Date.now() - 24 * 60 * 60 * 1000)")
-    console.log("console.log(loan.isOverdue())    // true")
-    console.log("console.log(loan.calculateFine()) // 5")
-    console.log("")
-    console.log("// Devolver libro")
-    console.log("const fine = library.returnBook(loan)")
-    console.log("console.log(book.isAvailable())  // true")
-
-    await this.waitForEnter("\nPresiona Enter para la conclusión...")
-  }
-
-  async conclusion() {
-    console.clear()
-    console.log("🎓 Conclusión: La Descomposición de Sistemas")
-    console.log("=" .repeat(50))
-    console.log("🎯 Hemos demostrado que:")
-
-    console.log("\n1️⃣ Sistema como totalidad deductiva:")
-    console.log("   • De 'biblioteca digital' se deduce naturalmente: libros + usuarios")
-    console.log("   • Esta deducción revela la interacción fundamental del sistema")
-
-    console.log("\n2️⃣ Sistema como conjunto con propósito:")
-    console.log("   • Elementos identificados: Book, User, Loan, Library")
-    console.log("   • Relaciones ordenadas: solicitud → evaluación → préstamo → devolución")
-    console.log("   • Propósito determinado: acceso organizado a recursos")
-
-    console.log("\n⚡ La parte difícil:")
-    console.log("¿Cómo decidimos que necesitábamos exactamente estos 4 objetos?")
-    console.log("¿Por qué no 3? ¿Por qué no 10? ¿Cuál es el criterio?")
-
-    console.log("\n🔍 Criterio de descomposición:")
-    console.log("• Book - responsabilidad de estado propio")
-    console.log("• User - responsabilidad de sus límites")
-    console.log("• Loan - responsabilidad de la relación temporal")
-    console.log("• Library - responsabilidad de coordinación")
-
-    console.log("\n📚 Conexión con lecciones siguientes:")
-    console.log("• Lección 2: Los objetos interactúan a través de solicitudes")
-    console.log("• Lección 3: Las solicitudes son la única forma de ejecutar operaciones")
-    console.log("• Lección 4-6: Cómo definir esas interacciones correctamente")
-
-    console.log("\n💭 Reflexión:")
-    console.log("La descomposición en objetos es difícil porque requiere identificar")
-    console.log("las responsabilidades naturales que se deducen del sistema.")
-
-    await this.waitForEnter("\n✨ ¡Lección 1 completada! Presiona Enter para continuar...")
-  }
-
-  formatCode(code) {
-    // ANSI color codes
-    const colors = {
-      keyword: '\x1b[35m',    // magenta for keywords like class, constructor
-      property: '\x1b[32m',   // green for this.property
-      string: '\x1b[33m',     // yellow for strings
-      comment: '\x1b[90m',    // gray for comments
-      reset: '\x1b[0m'        // reset color
-    }
-
-    return code
-      .replace(/\b(class|constructor|return|if|const|let|new)\b/g, `${colors.keyword}$1${colors.reset}`)
-      .replace(/\bthis\./g, `${colors.property}this.${colors.reset}`)
-      .replace(/'([^']*)'/g, `${colors.string}'$1'${colors.reset}`)
-      .replace(/"([^"]*)"/g, `${colors.string}"$1"${colors.reset}`)
-      .replace(/\/\/.*$/gm, `${colors.comment}$&${colors.reset}`)
-  }
-
-  printCodeWithColors(title, code) {
-    console.log(`\n${title}`)
-    console.log("━".repeat(50))
-
-    code.split('\n').forEach(line => {
-      const formattedLine = this.formatCode(line)
-      console.log(formattedLine)
-    })
-
-    console.log("━".repeat(50))
-  }
-
-  async waitForEnter(message) {
-    return new Promise((resolve) => {
-      this.rl.question(message, () => {
-        console.log("\n\n") // Add extra spacing after each interaction
-        resolve()
-      })
-    })
-  }
-}
-
-// Para usar la lección independientemente
-if (import.meta.url === `file://${process.argv[1]}`) {
-  const lesson = new Lesson1SystemDecomposition()
-  await lesson.start()
-}

package/lessons/lesson2-object-requests.js

@@ -1,309 +0,0 @@
-#!/usr/bin/env node
-
-// LECCIÓN 2: Los objetos interactúan entre sí a través de solicitudes
-// Enfoque práctico: Demostrar cómo los objetos se comunican sin acceder directamente a datos internos
-
-import { createInterface } from 'readline'
-
-export class Lesson2ObjectRequests {
-  constructor() {
-    this.rl = createInterface({
-      input: process.stdin,
-      output: process.stdout
-    })
-  }
-
-  async start() {
-    console.log("\n💡 ¿Qué significa esto exactamente?")
-    console.log("- Los objetos NO acceden directamente a los datos de otros objetos")
-    console.log("- En lugar de eso, hacen SOLICITUDES específicas")
-    console.log("- Cada solicitud tiene un propósito claro y definido")
-
-    await this.waitForEnter("\nPresiona Enter para comenzar el ejercicio práctico...")
-
-    await this.practicalExercise()
-    await this.conclusion()
-
-    this.rl.close()
-  }
-
-  async practicalExercise() {
-    console.clear()
-    console.log("🛠️ EJERCICIO PRÁCTICO: Sistema de Mensajería")
-    console.log("=" .repeat(50))
-    console.log("🎯 Vamos a ver cómo los objetos se solicitan información sin acceso directo")
-    console.log("\nSistema: Chat entre usuarios")
-    console.log("Objetos: User, Message, ChatRoom")
-
-    await this.waitForEnter("\nPresiona Enter para ver el ANTI-PATRÓN...")
-
-    await this.step1_ShowAntiPattern()
-    await this.step2_ShowCorrectPattern()
-    await this.step3_RequestTypes()
-    await this.step4_ComplexInteraction()
-  }
-
-  async step1_ShowAntiPattern() {
-    console.clear()
-    console.log("❌ ANTI-PATRÓN: Acceso Directo (INCORRECTO)")
-    console.log("=" .repeat(45))
-    console.log("Veamos qué NO debemos hacer:")
-
-    console.log("\n// ❌ MALO: Acceso directo a datos internos")
-    console.log(`class ChatRoom {
-  addMessage(user, text) {
-    // ❌ Accediendo directamente a user.name
-    if (user.name && user.name.length > 0) {
-      // ❌ Accediendo directamente a user.isActive
-      if (user.isActive === true) {
-        const message = new Message(user.name, text)
-        this.messages.push(message)
-      }
-    }
-  }
-}`)
-
-    console.log("\n🚨 Problemas del acceso directo:")
-    console.log("• ChatRoom conoce la estructura interna de User")
-    console.log("• Si User cambia, ChatRoom se rompe")
-    console.log("• No hay control sobre qué se accede")
-    console.log("• Violación de encapsulación")
-
-    await this.waitForEnter("\nPresiona Enter para ver la forma CORRECTA...")
-  }
-
-  async step2_ShowCorrectPattern() {
-    console.clear()
-    console.log("✅ PATRÓN CORRECTO: Solicitudes (CORRECTO)")
-    console.log("=" .repeat(45))
-    console.log("Ahora veamos cómo debe ser:")
-
-    console.log("\n// ✅ BUENO: Comunicación a través de solicitudes")
-    console.log(`class User {
-  constructor(name) {
-    this.#name = name
-    this.#isActive = true
-  }
-
-  // 🔑 SOLICITUD: getName()
-  getName() {
-    return this.#name
-  }
-
-  // 🔑 SOLICITUD: isCurrentlyActive()
-  isCurrentlyActive() {
-    return this.#isActive
-  }
-
-  // 🔑 SOLICITUD: canSendMessage()
-  canSendMessage() {
-    return this.#isActive && this.#name.length > 0
-  }
-}`)
-
-    await this.waitForEnter("\nPresiona Enter para ver cómo ChatRoom usa las solicitudes...")
-
-    console.log("\n// ✅ ChatRoom usa SOLICITUDES, no acceso directo")
-    console.log(`class ChatRoom {
-  addMessage(user, text) {
-    // ✅ SOLICITUD: ¿puede enviar mensajes?
-    if (user.canSendMessage()) {
-      // ✅ SOLICITUD: dame tu nombre
-      const userName = user.getName()
-      const message = new Message(userName, text)
-      this.messages.push(message)
-    }
-  }
-
-  getActiveUsers() {
-    return this.users.filter(user =>
-      // ✅ SOLICITUD: ¿estás activo?
-      user.isCurrentlyActive()
-    )
-  }
-}`)
-
-    console.log("\n🌟 Beneficios de las solicitudes:")
-    console.log("• ChatRoom no conoce la estructura interna de User")
-    console.log("• User controla qué información expone")
-    console.log("• Cambios internos en User no afectan ChatRoom")
-    console.log("• Cada solicitud tiene un propósito específico")
-
-    await this.waitForEnter("\nPresiona Enter para ver tipos de solicitudes...")
-  }
-
-  async step3_RequestTypes() {
-    console.clear()
-    console.log("🔍 TIPOS DE SOLICITUDES")
-    console.log("=" .repeat(30))
-    console.log("Las solicitudes pueden ser de diferentes tipos:")
-
-    console.log("\n1️⃣ SOLICITUDES DE CONSULTA (Query)")
-    console.log("   • user.getName() → devuelve información")
-    console.log("   • user.isCurrentlyActive() → devuelve estado")
-    console.log("   • message.getTimestamp() → devuelve dato")
-
-    console.log("\n2️⃣ SOLICITUDES DE ACCIÓN (Command)")
-    console.log("   • user.setActive(false) → cambia estado")
-    console.log("   • message.markAsRead() → ejecuta acción")
-    console.log("   • chatRoom.addUser(user) → modifica colección")
-
-    console.log("\n3️⃣ SOLICITUDES DE VALIDACIÓN (Validation)")
-    console.log("   • user.canSendMessage() → verifica capacidad")
-    console.log("   • message.isValid() → verifica integridad")
-    console.log("   • chatRoom.hasPermission(user) → verifica acceso")
-
-    await this.waitForEnter("\nPresiona Enter para ver una interacción compleja...")
-
-    console.clear()
-    console.log("💬 EJEMPLO: Enviar mensaje con validaciones")
-    console.log("=" .repeat(45))
-
-    console.log("\n// Los objetos colaboran solo a través de solicitudes")
-    console.log(`function sendMessage(chatRoom, user, text) {
-  // 🔍 SOLICITUD: ¿el usuario puede enviar?
-  if (!user.canSendMessage()) {
-    console.log("Usuario no puede enviar mensajes")
-    return false
-  }
-
-  // 🔍 SOLICITUD: ¿el usuario tiene permisos en este chat?
-  if (!chatRoom.hasPermission(user)) {
-    console.log("Sin permisos en este chat")
-    return false
-  }
-
-  // 🔍 SOLICITUD: ¿el texto es válido?
-  const message = new Message(user.getName(), text)
-  if (!message.isValid()) {
-    console.log("Mensaje inválido")
-    return false
-  }
-
-  // ⚡ SOLICITUD: agregar el mensaje
-  chatRoom.addMessage(user, text)
-
-  // 🔍 SOLICITUD: notificar a usuarios activos
-  const activeUsers = chatRoom.getActiveUsers()
-  activeUsers.forEach(activeUser => {
-    // 🔍 SOLICITUD: notificar
-    activeUser.notifyNewMessage(message)
-  })
-
-  return true
-}`)
-
-    console.log("\n🎯 Observa: En ningún momento accedemos directamente a")
-    console.log("    user.#name, user.#isActive, chatRoom.#messages, etc.")
-    console.log("    Todo pasa por SOLICITUDES específicas.")
-
-    await this.waitForEnter("\nPresiona Enter para la demostración final...")
-  }
-
-  async step4_ComplexInteraction() {
-    console.clear()
-    console.log("🎭 DEMOSTRACIÓN: Interacción Completa")
-    console.log("=" .repeat(40))
-    console.log("Veamos todos los objetos interactuando:")
-
-    console.log("\n// Crear objetos")
-    console.log("const chatRoom = new ChatRoom('Desarrollo')")
-    console.log("const ana = new User('Ana')")
-    console.log("const carlos = new User('Carlos')")
-    console.log("")
-    console.log("// Agregar usuarios al chat")
-    console.log("chatRoom.addUser(ana)    // SOLICITUD")
-    console.log("chatRoom.addUser(carlos) // SOLICITUD")
-    console.log("")
-    console.log("// Ana envía mensaje")
-    console.log("sendMessage(chatRoom, ana, 'Hola a todos!')")
-    console.log("")
-    console.log("// Secuencia de SOLICITUDES que se ejecutan:")
-    console.log("// 1. ana.canSendMessage() → true")
-    console.log("// 2. chatRoom.hasPermission(ana) → true")
-    console.log("// 3. ana.getName() → 'Ana'")
-    console.log("// 4. message.isValid() → true")
-    console.log("// 5. chatRoom.addMessage(ana, text)")
-    console.log("// 6. chatRoom.getActiveUsers() → [ana, carlos]")
-    console.log("// 7. carlos.notifyNewMessage(message)")
-
-    console.log("\n💡 Resultado:")
-    console.log("✅ Ana: Mensaje enviado")
-    console.log("📬 Carlos: Notificación recibida")
-
-    await this.waitForEnter("\nPresiona Enter para ver qué pasa si Carlos se desconecta...")
-
-    console.log("\n// Carlos se desconecta")
-    console.log("carlos.setActive(false)  // SOLICITUD")
-    console.log("")
-    console.log("// Ana envía otro mensaje")
-    console.log("sendMessage(chatRoom, ana, 'Carlos, ¿estás ahí?')")
-    console.log("")
-    console.log("// Secuencia de SOLICITUDES:")
-    console.log("// 1-5. Igual que antes...")
-    console.log("// 6. chatRoom.getActiveUsers() → [ana]  // ¡Carlos ya no aparece!")
-    console.log("// 7. Solo ana.notifyNewMessage() se ejecuta")
-
-    console.log("\n💡 Resultado:")
-    console.log("✅ Ana: Mensaje enviado")
-    console.log("😴 Carlos: No recibe notificación (está inactivo)")
-
-    console.log("\n🎯 Observación clave:")
-    console.log("Los objetos cambian su comportamiento interno, pero las")
-    console.log("SOLICITUDES siguen siendo las mismas. La interacción es estable.")
-
-    await this.waitForEnter("\nPresiona Enter para la conclusión...")
-  }
-
-  async conclusion() {
-    console.clear()
-    console.log("🎓 CONCLUSIÓN: Interacción a través de Solicitudes")
-    console.log("=" .repeat(50))
-    console.log("🎯 Hemos demostrado que:")
-
-    console.log("\n1️⃣ Los objetos NUNCA acceden directamente a datos internos")
-    console.log("2️⃣ Toda comunicación ocurre a través de SOLICITUDES específicas")
-    console.log("3️⃣ Cada solicitud tiene un propósito claro y definido")
-    console.log("4️⃣ Los objetos controlan qué información exponen")
-
-    console.log("\n🔑 Tipos de solicitudes vistas:")
-    console.log("• CONSULTA: getName(), isCurrentlyActive()")
-    console.log("• ACCIÓN: setActive(), addMessage()")
-    console.log("• VALIDACIÓN: canSendMessage(), hasPermission()")
-
-    console.log("\n🌟 Beneficios fundamentales:")
-    console.log("• Encapsulación preservada")
-    console.log("• Flexibilidad para cambios internos")
-    console.log("• Interacciones estables y predecibles")
-    console.log("• Control total sobre el acceso a datos")
-
-    console.log("\n📚 Conexión con otras lecciones:")
-    console.log("• Lección 1: Los objetos que identificamos ahora interactúan")
-    console.log("• Lección 3: Las solicitudes son la ÚNICA forma de ejecutar operaciones")
-    console.log("• Lecciones 4-6: Cómo definir formalmente estas solicitudes")
-
-    console.log("\n💭 Reflexión:")
-    console.log("¿Te imaginas un mundo donde pudieras acceder directamente")
-    console.log("a la cuenta bancaria de cualquier persona? ¡Sería un caos!")
-    console.log("Los objetos funcionan igual: solicitudes controladas, acceso seguro.")
-
-    console.log("\n🏆 Ahora entiendes por qué los objetos interactúan a través")
-    console.log("de solicitudes: es la base de la comunicación segura y ordenada.")
-
-    await this.waitForEnter("\n✨ ¡Lección 2 completada! Presiona Enter para salir...")
-  }
-
-  async waitForEnter(message) {
-    return new Promise((resolve) => {
-      this.rl.question(message, () => {
-        resolve()
-      })
-    })
-  }
-}
-
-// Para usar la lección independientemente
-if (import.meta.url === `file://${process.argv[1]}`) {
-  const lesson = new Lesson2ObjectRequests()
-  await lesson.start()
-}