@icarusmx/creta 0.8.2 → 0.9.0

package/bin/creta.js

@@ -6,6 +6,7 @@ import fs from 'fs'
 import path from 'path'
 import { fileURLToPath } from 'url'
 import { CretaCodeSession } from '../lib/session.js'
+import { Lesson6InterfaceDesign } from '../lessons/lesson6-interface-design.js'
 
 const ENUNCIADOS = [
   {
@@ -786,7 +787,7 @@ async function startEnunciadosSelectorInteractive() {
   return new Promise((resolve) => {
     renderOptions()
 
-    const onKeyPress = (key) => {
+    const onKeyPress = async (key) => {
       if (key === 'q' || key === '\x03') { // q or Ctrl+C
         process.stdin.setRawMode(false)
         process.stdin.removeListener('data', onKeyPress)
@@ -810,13 +811,30 @@ async function startEnunciadosSelectorInteractive() {
         console.log(`\n💡 Enfoque: ${enunciadoSeleccionado.enfoque}`)
         console.log(`📚 Nivel: ${enunciadoSeleccionado.nivel}`)
 
-        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")
+        // Check if we have a lesson implementation for this enunciado
+        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
+
+          try {
+            const lesson6 = new Lesson6InterfaceDesign()
+            await lesson6.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 {
+          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")
 
-        console.log("\n💭 Por ahora, reflexiona: ¿qué parte específica de este enunciado")
-        console.log("   te genera más curiosidad o confusión?")
+          console.log("\n💭 Por ahora, reflexiona: ¿qué parte específica de este enunciado")
+          console.log("   te genera más curiosidad o confusión?")
+        }
 
         resolve()
         return
@@ -876,13 +894,32 @@ async function startEnunciadosSelectorFallback() {
       console.log(`\n💡 Enfoque: ${enunciadoSeleccionado.enfoque}`)
       console.log(`📚 Nivel: ${enunciadoSeleccionado.nivel}`)
 
-      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")
+      // Check if we have a lesson implementation for this enunciado
+      if (enunciadoSeleccionado.id === 6) {
+        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 lesson6 = new Lesson6InterfaceDesign()
+          await lesson6.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 {
+        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")
 
-      console.log("\n💭 Por ahora, reflexiona: ¿qué parte específica de este enunciado")
-      console.log("   te genera más curiosidad o confusión?")
+        console.log("\n💭 Por ahora, reflexiona: ¿qué parte específica de este enunciado")
+        console.log("   te genera más curiosidad o confusión?")
+      }
 
     } else {
       console.log("❌ Opción no válida. Elige un número entre 1 y 6.")

package/lessons/lesson6-interface-design.js

@@ -0,0 +1,306 @@
+#!/usr/bin/env node
+
+// LECCIÓN 6: El énfasis al diseñar los objetos debe estar en la definición de sus solicitudes e interfaces
+// Enfoque práctico: Sistema de gestión de tareas con diseño interface-first
+
+import { createInterface } from 'readline'
+
+export class Lesson6InterfaceDesign {
+  constructor() {
+    this.rl = createInterface({
+      input: process.stdin,
+      output: process.stdout
+    })
+  }
+
+  async start() {
+    console.log("🎯 LECCIÓN 6: Diseño basado en Interfaces")
+    console.log("=" .repeat(50))
+    console.log("📚 Concepto: El énfasis al diseñar los objetos debe estar en la definición de sus solicitudes e interfaces.")
+    console.log("\n💡 ¿Por qué es importante?")
+    console.log("- Las interfaces definen QUÉ hace un objeto, no CÓMO lo hace")
+    console.log("- Facilita la colaboración entre objetos")
+    console.log("- Permite cambiar implementaciones sin afectar otros objetos")
+    console.log("- Hace el código más mantenible y extensible")
+
+    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 Gestión de Tareas")
+    console.log("=" .repeat(50))
+    console.log("🎯 Objetivo: Diseñar interfaces ANTES de implementar")
+    console.log("\nVamos a crear un sistema donde:")
+    console.log("- TaskManager gestiona una colección de tareas")
+    console.log("- Task representa una tarea individual")
+    console.log("- TaskStorage guarda y recupera tareas")
+
+    await this.waitForEnter("\nPresiona Enter para ver cómo diseñar las interfaces...")
+
+    await this.step1_DefineRequests()
+    await this.step2_DefineInterfaces()
+    await this.step3_ImplementObjects()
+    await this.step4_TestInteraction()
+  }
+
+  async step1_DefineRequests() {
+    console.clear()
+    console.log("📋 PASO 1: Definir las Solicitudes")
+    console.log("=" .repeat(40))
+    console.log("Antes de escribir código, pensemos: ¿Qué solicitudes debe manejar cada objeto?")
+    console.log("\n🎯 TaskManager debe poder:")
+    console.log("  - Crear una nueva tarea")
+    console.log("  - Listar todas las tareas")
+    console.log("  - Marcar tarea como completada")
+    console.log("  - Eliminar una tarea")
+
+    console.log("\n📝 Task debe poder:")
+    console.log("  - Proporcionar su información")
+    console.log("  - Cambiar su estado (pendiente/completada)")
+    console.log("  - Validar si está completada")
+
+    console.log("\n💾 TaskStorage debe poder:")
+    console.log("  - Guardar una tarea")
+    console.log("  - Recuperar todas las tareas")
+    console.log("  - Eliminar una tarea específica")
+
+    await this.waitForEnter("\n✅ ¡Excelente! Ya definimos QUÉ debe hacer cada objeto. Presiona Enter para definir las interfaces...")
+  }
+
+  async step2_DefineInterfaces() {
+    console.clear()
+    console.log("🔌 PASO 2: Definir las Interfaces (Firmas de Operación)")
+    console.log("=" .repeat(50))
+    console.log("Ahora especifiquemos CÓMO se solicitan estas operaciones:")
+
+    console.log("\n// TaskManager Interface")
+    console.log("class TaskManager {")
+    console.log("  createTask(title, description) → Task")
+    console.log("  getAllTasks() → Array<Task>")
+    console.log("  completeTask(taskId) → boolean")
+    console.log("  deleteTask(taskId) → boolean")
+    console.log("}")
+
+    console.log("\n// Task Interface")
+    console.log("class Task {")
+    console.log("  constructor(id, title, description) → Task")
+    console.log("  getInfo() → {id, title, description, completed}")
+    console.log("  markCompleted() → void")
+    console.log("  isCompleted() → boolean")
+    console.log("}")
+
+    console.log("\n// TaskStorage Interface")
+    console.log("class TaskStorage {")
+    console.log("  save(task) → void")
+    console.log("  findAll() → Array<Task>")
+    console.log("  remove(taskId) → boolean")
+    console.log("}")
+
+    console.log("\n💡 Observa que cada operación especifica:")
+    console.log("   a) Nombre de la operación (createTask, save, etc.)")
+    console.log("   b) Insumos necesarios (title, description, taskId, etc.)")
+    console.log("   c) Valor que regresa (Task, boolean, Array, etc.)")
+
+    await this.waitForEnter("\n✅ Interfaces definidas. Presiona Enter para implementar...")
+  }
+
+  async step3_ImplementObjects() {
+    console.clear()
+    console.log("⚙️ PASO 3: Implementar los Objetos")
+    console.log("=" .repeat(40))
+    console.log("Ahora que tenemos las interfaces claras, implementemos:")
+
+    console.log("\n// Implementación de Task")
+    console.log(`class Task {
+  constructor(id, title, description) {
+    this.id = id
+    this.title = title
+    this.description = description
+    this.completed = false
+  }
+
+  getInfo() {
+    return {
+      id: this.id,
+      title: this.title,
+      description: this.description,
+      completed: this.completed
+    }
+  }
+
+  markCompleted() {
+    this.completed = true
+  }
+
+  isCompleted() {
+    return this.completed
+  }
+}`)
+
+    await this.waitForEnter("\nPresiona Enter para ver TaskStorage...")
+
+    console.log("\n// Implementación de TaskStorage")
+    console.log(`class TaskStorage {
+  constructor() {
+    this.tasks = []
+  }
+
+  save(task) {
+    this.tasks.push(task)
+  }
+
+  findAll() {
+    return [...this.tasks]
+  }
+
+  remove(taskId) {
+    const index = this.tasks.findIndex(t => t.id === taskId)
+    if (index !== -1) {
+      this.tasks.splice(index, 1)
+      return true
+    }
+    return false
+  }
+}`)
+
+    await this.waitForEnter("\nPresiona Enter para ver TaskManager...")
+
+    console.log("\n// Implementación de TaskManager")
+    console.log(`class TaskManager {
+  constructor(storage) {
+    this.storage = storage
+    this.nextId = 1
+  }
+
+  createTask(title, description) {
+    const task = new Task(this.nextId++, title, description)
+    this.storage.save(task)
+    return task
+  }
+
+  getAllTasks() {
+    return this.storage.findAll()
+  }
+
+  completeTask(taskId) {
+    const tasks = this.storage.findAll()
+    const task = tasks.find(t => t.id === taskId)
+    if (task) {
+      task.markCompleted()
+      return true
+    }
+    return false
+  }
+
+  deleteTask(taskId) {
+    return this.storage.remove(taskId)
+  }
+}`)
+
+    await this.waitForEnter("\n✅ Implementación completa. Presiona Enter para probar la interacción...")
+  }
+
+  async step4_TestInteraction() {
+    console.clear()
+    console.log("🧪 PASO 4: Probar la Interacción entre Objetos")
+    console.log("=" .repeat(45))
+    console.log("Veamos cómo los objetos colaboran usando sus interfaces:")
+
+    console.log("\n// Crear el sistema")
+    console.log("const storage = new TaskStorage()")
+    console.log("const manager = new TaskManager(storage)")
+    console.log("")
+    console.log("// Los objetos interactúan a través de solicitudes")
+    console.log("const task1 = manager.createTask('Estudiar OOP', 'Completar lección 6')")
+    console.log("const task2 = manager.createTask('Practicar código', 'Implementar sistema de tareas')")
+    console.log("")
+    console.log("// Cada solicitud respeta la interfaz definida")
+    console.log("manager.completeTask(task1.id)")
+    console.log("const allTasks = manager.getAllTasks()")
+    console.log("")
+    console.log("allTasks.forEach(task => {")
+    console.log("  const info = task.getInfo() // Solicitud a Task")
+    console.log("  console.log(`${info.title}: ${info.completed ? '✅' : '❌'}`)")
+    console.log("})")
+
+    console.log("\n🎯 Resultado esperado:")
+    console.log("Estudiar OOP: ✅")
+    console.log("Practicar código: ❌")
+
+    await this.waitForEnter("\nPresiona Enter para ver los beneficios de este enfoque...")
+
+    console.clear()
+    console.log("🌟 BENEFICIOS DEL DISEÑO INTERFACE-FIRST")
+    console.log("=" .repeat(45))
+    console.log("1. 🎯 Claridad: Cada objeto tiene responsabilidades bien definidas")
+    console.log("2. 🔗 Colaboración: Los objetos saben exactamente cómo solicitar operaciones")
+    console.log("3. 🔄 Flexibilidad: Podemos cambiar TaskStorage por DatabaseStorage sin afectar TaskManager")
+    console.log("4. 🧪 Testeable: Podemos crear mocks fácilmente para testing")
+    console.log("5. 📚 Mantenible: Las interfaces documentan el contrato de cada objeto")
+
+    console.log("\n💡 Ejemplo de extensibilidad:")
+    console.log("// Podemos cambiar el storage sin modificar TaskManager")
+    console.log("class DatabaseStorage {")
+    console.log("  save(task) { /* guardar en BD */ }")
+    console.log("  findAll() { /* consultar BD */ }")
+    console.log("  remove(taskId) { /* eliminar de BD */ }")
+    console.log("}")
+    console.log("")
+    console.log("// TaskManager sigue funcionando igual!")
+    console.log("const dbStorage = new DatabaseStorage()")
+    console.log("const manager = new TaskManager(dbStorage)")
+
+    await this.waitForEnter("\nPresiona Enter para continuar con la conclusión...")
+  }
+
+  async conclusion() {
+    console.clear()
+    console.log("🎓 CONCLUSIÓN: Diseño basado en Interfaces")
+    console.log("=" .repeat(45))
+    console.log("🎯 Hemos demostrado que:")
+    console.log("\n1. El ÉNFASIS debe estar en definir QUÉ solicitudes maneja cada objeto")
+    console.log("2. Las INTERFACES especifican cómo hacer estas solicitudes")
+    console.log("3. La IMPLEMENTACIÓN viene después, siguiendo el contrato")
+    console.log("4. Los objetos COLABORAN a través de estas interfaces bien definidas")
+
+    console.log("\n📚 Conexión con lecciones anteriores:")
+    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: Cada operación tiene nombre, insumos y valor de retorno ✓")
+    console.log("• Lección 5: La interfaz es el conjunto de todas las firmas ✓")
+    console.log("• Lección 6: El énfasis está en definir solicitudes e interfaces ✓")
+
+    console.log("\n🚀 Próximo paso:")
+    console.log("Practica este enfoque en tus propios proyectos:")
+    console.log("1. Define primero QUÉ debe hacer cada objeto")
+    console.log("2. Especifica las interfaces (firmas de operación)")
+    console.log("3. Implementa respetando esos contratos")
+    console.log("4. Haz que los objetos colaboren a través de solicitudes")
+
+    console.log("\n💭 Reflexión final:")
+    console.log("¿Cómo cambiaría tu forma de programar si siempre empezaras")
+    console.log("definiendo las interfaces antes de la implementación?")
+
+    await this.waitForEnter("\n✨ ¡Lección 6 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 Lesson6InterfaceDesign()
+  await lesson.start()
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@icarusmx/creta",
-  "version": "0.8.2",
+  "version": "0.9.0",
   "description": "Salgamos de este laberinto.",
   "type": "module",
   "bin": {