@icarusmx/creta 0.10.2 → 1.0.0

package/bin/creta.js

@@ -7,6 +7,10 @@ import path from 'path'
 import { fileURLToPath } from 'url'
 import { CretaCodeSession } from '../lib/session.js'
 import { Lesson1SystemDecomposition } from '../lessons/lesson1-system-decomposition.js'
+import { Lesson2ObjectRequests } from '../lessons/lesson2-object-requests.js'
+import { Lesson3OnlyWay } from '../lessons/lesson3-only-way.js'
+import { Lesson4OperationSignatures } from '../lessons/lesson4-operation-signatures.js'
+import { Lesson5InterfaceSet } from '../lessons/lesson5-interface-set.js'
 import { Lesson6InterfaceDesign } from '../lessons/lesson6-interface-design.js'
 
 const ENUNCIADOS = [
@@ -841,6 +845,62 @@ async function startEnunciadosSelectorInteractive() {
             console.log("- Ejercicios prácticos que ilustren el concepto")
             console.log("- Proyectos específicos para internalizar la idea")
           }
+        } else if (enunciadoSeleccionado.id === 2) {
+          console.log("\n🚀 ¡Lección disponible! Iniciando sesión de estudio dirigida...")
+          await new Promise(resolve => setTimeout(resolve, 1500)) // Brief pause
+
+          try {
+            const lesson2 = new Lesson2ObjectRequests()
+            await lesson2.start()
+          } catch (error) {
+            console.error("\n❌ Error al ejecutar la lección:", error.message)
+            console.log("\n🚀 Próximamente:")
+            console.log("- Sesiones de estudio dirigidas basadas en este enunciado")
+            console.log("- Ejercicios prácticos que ilustren el concepto")
+            console.log("- Proyectos específicos para internalizar la idea")
+          }
+        } else if (enunciadoSeleccionado.id === 3) {
+          console.log("\n🚀 ¡Lección disponible! Iniciando sesión de estudio dirigida...")
+          await new Promise(resolve => setTimeout(resolve, 1500)) // Brief pause
+
+          try {
+            const lesson3 = new Lesson3OnlyWay()
+            await lesson3.start()
+          } catch (error) {
+            console.error("\n❌ Error al ejecutar la lección:", error.message)
+            console.log("\n🚀 Próximamente:")
+            console.log("- Sesiones de estudio dirigidas basadas en este enunciado")
+            console.log("- Ejercicios prácticos que ilustren el concepto")
+            console.log("- Proyectos específicos para internalizar la idea")
+          }
+        } else if (enunciadoSeleccionado.id === 4) {
+          console.log("\n🚀 ¡Lección disponible! Iniciando sesión de estudio dirigida...")
+          await new Promise(resolve => setTimeout(resolve, 1500)) // Brief pause
+
+          try {
+            const lesson4 = new Lesson4OperationSignatures()
+            await lesson4.start()
+          } catch (error) {
+            console.error("\n❌ Error al ejecutar la lección:", error.message)
+            console.log("\n🚀 Próximamente:")
+            console.log("- Sesiones de estudio dirigidas basadas en este enunciado")
+            console.log("- Ejercicios prácticos que ilustren el concepto")
+            console.log("- Proyectos específicos para internalizar la idea")
+          }
+        } else if (enunciadoSeleccionado.id === 5) {
+          console.log("\n🚀 ¡Lección disponible! Iniciando sesión de estudio dirigida...")
+          await new Promise(resolve => setTimeout(resolve, 1500)) // Brief pause
+
+          try {
+            const lesson5 = new Lesson5InterfaceSet()
+            await lesson5.start()
+          } catch (error) {
+            console.error("\n❌ Error al ejecutar la lección:", error.message)
+            console.log("\n🚀 Próximamente:")
+            console.log("- Sesiones de estudio dirigidas basadas en este enunciado")
+            console.log("- Ejercicios prácticos que ilustren el concepto")
+            console.log("- Proyectos específicos para internalizar la idea")
+          }
         } else if (enunciadoSeleccionado.id === 6) {
           console.log("\n🚀 ¡Lección disponible! Iniciando sesión de estudio dirigida...")
           await new Promise(resolve => setTimeout(resolve, 1500)) // Brief pause
@@ -956,6 +1016,70 @@ async function startEnunciadosSelectorFallback() {
           console.log("- Proyectos específicos para internalizar la idea")
         }
         return
+      } else if (enunciadoSeleccionado.id === 2) {
+        console.log("\n🚀 ¡Lección disponible! Iniciando sesión de estudio dirigida...")
+        rl.close()
+        await new Promise(resolve => setTimeout(resolve, 1500)) // Brief pause
+
+        try {
+          const lesson2 = new Lesson2ObjectRequests()
+          await lesson2.start()
+        } catch (error) {
+          console.error("\n❌ Error al ejecutar la lección:", error.message)
+          console.log("\n🚀 Próximamente:")
+          console.log("- Sesiones de estudio dirigidas basadas en este enunciado")
+          console.log("- Ejercicios prácticos que ilustren el concepto")
+          console.log("- Proyectos específicos para internalizar la idea")
+        }
+        return
+      } else if (enunciadoSeleccionado.id === 3) {
+        console.log("\n🚀 ¡Lección disponible! Iniciando sesión de estudio dirigida...")
+        rl.close()
+        await new Promise(resolve => setTimeout(resolve, 1500)) // Brief pause
+
+        try {
+          const lesson3 = new Lesson3OnlyWay()
+          await lesson3.start()
+        } catch (error) {
+          console.error("\n❌ Error al ejecutar la lección:", error.message)
+          console.log("\n🚀 Próximamente:")
+          console.log("- Sesiones de estudio dirigidas basadas en este enunciado")
+          console.log("- Ejercicios prácticos que ilustren el concepto")
+          console.log("- Proyectos específicos para internalizar la idea")
+        }
+        return
+      } else if (enunciadoSeleccionado.id === 4) {
+        console.log("\n🚀 ¡Lección disponible! Iniciando sesión de estudio dirigida...")
+        rl.close()
+        await new Promise(resolve => setTimeout(resolve, 1500)) // Brief pause
+
+        try {
+          const lesson4 = new Lesson4OperationSignatures()
+          await lesson4.start()
+        } catch (error) {
+          console.error("\n❌ Error al ejecutar la lección:", error.message)
+          console.log("\n🚀 Próximamente:")
+          console.log("- Sesiones de estudio dirigidas basadas en este enunciado")
+          console.log("- Ejercicios prácticos que ilustren el concepto")
+          console.log("- Proyectos específicos para internalizar la idea")
+        }
+        return
+      } else if (enunciadoSeleccionado.id === 5) {
+        console.log("\n🚀 ¡Lección disponible! Iniciando sesión de estudio dirigida...")
+        rl.close()
+        await new Promise(resolve => setTimeout(resolve, 1500)) // Brief pause
+
+        try {
+          const lesson5 = new Lesson5InterfaceSet()
+          await lesson5.start()
+        } catch (error) {
+          console.error("\n❌ Error al ejecutar la lección:", error.message)
+          console.log("\n🚀 Próximamente:")
+          console.log("- Sesiones de estudio dirigidas basadas en este enunciado")
+          console.log("- Ejercicios prácticos que ilustren el concepto")
+          console.log("- Proyectos específicos para internalizar la idea")
+        }
+        return
       } else if (enunciadoSeleccionado.id === 6) {
         console.log("\n🚀 ¡Lección disponible! Iniciando sesión de estudio dirigida...")
         rl.close()

package/lessons/lesson2-object-requests.js

@@ -0,0 +1,312 @@
+#!/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("🎯 LECCIÓN 2: Interacción a través de Solicitudes")
+    console.log("=" .repeat(50))
+    console.log("📚 Enunciado: Los objetos interactúan entre sí a través de solicitudes.")
+    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()
+}