@icarusmx/creta 0.8.2 → 0.9.1

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,375 @@
+#!/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 bancario con diseño interface-first y encapsulación
+
+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 Bancario")
+    console.log("=" .repeat(50))
+    console.log("🎯 Objetivo: Diseñar interfaces ANTES de implementar")
+    console.log("\nVamos a crear un sistema bancario donde:")
+    console.log("- BankAccount representa una cuenta con balance privado")
+    console.log("- Transaction registra movimientos entre cuentas")
+    console.log("- Bank gestiona múltiples cuentas y validaciones")
+
+    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🏦 BankAccount debe poder:")
+    console.log("  - Consultar balance (sin exponer el dato interno)")
+    console.log("  - Recibir dinero (depósito)")
+    console.log("  - Enviar dinero (con validación interna)")
+    console.log("  - Proporcionar información de la cuenta")
+
+    console.log("\n📊 Transaction debe poder:")
+    console.log("  - Registrar origen, destino y monto")
+    console.log("  - Proporcionar detalles del movimiento")
+    console.log("  - Validar si la transacción es válida")
+
+    console.log("\n🏛️ Bank debe poder:")
+    console.log("  - Crear nuevas cuentas")
+    console.log("  - Procesar transferencias entre cuentas")
+    console.log("  - Validar operaciones antes de ejecutarlas")
+    console.log("  - Llevar registro de todas las transacciones")
+
+    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// BankAccount Interface")
+    console.log("class BankAccount {")
+    console.log("  constructor(accountNumber, ownerName, initialBalance) → BankAccount")
+    console.log("  getBalance() → number              // ⚠️ ENCAPSULACIÓN: acceso controlado")
+    console.log("  getAccountInfo() → {number, owner, balance}")
+    console.log("  deposit(amount) → boolean")
+    console.log("  send(amount, targetAccount) → boolean  // ⚠️ VALIDACIÓN interna")
+    console.log("}")
+
+    console.log("\n// Transaction Interface")
+    console.log("class Transaction {")
+    console.log("  constructor(from, to, amount, timestamp) → Transaction")
+    console.log("  getDetails() → {from, to, amount, timestamp, status}")
+    console.log("  isValid() → boolean")
+    console.log("}")
+
+    console.log("\n// Bank Interface")
+    console.log("class Bank {")
+    console.log("  createAccount(ownerName, initialBalance) → BankAccount")
+    console.log("  transfer(fromAccount, toAccount, amount) → Transaction")
+    console.log("  getAllTransactions() → Array<Transaction>")
+    console.log("  validateOperation(account, amount) → boolean")
+    console.log("}")
+
+    console.log("\n💡 Observa que cada operación especifica:")
+    console.log("   a) Nombre de la operación (getBalance, send, transfer, etc.)")
+    console.log("   b) Insumos necesarios (amount, targetAccount, etc.)")
+    console.log("   c) Valor que regresa (boolean, Transaction, etc.)")
+    console.log("\n🔒 Nota especial: getBalance() encapsula el acceso al estado interno")
+    console.log("🛡️  Nota especial: send() incluirá validación antes de ejecutar")
+
+    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 BankAccount")
+    console.log(`class BankAccount {
+  constructor(accountNumber, ownerName, initialBalance) {
+    this.accountNumber = accountNumber
+    this.ownerName = ownerName
+    this.#balance = initialBalance  // 🔒 PRIVADO: no se accede directamente
+  }
+
+  // 🔑 ENCAPSULACIÓN: método GET para acceder al balance
+  getBalance() {
+    return this.#balance
+  }
+
+  getAccountInfo() {
+    return {
+      number: this.accountNumber,
+      owner: this.ownerName,
+      balance: this.#balance  // Controlamos qué se expone
+    }
+  }
+
+  deposit(amount) {
+    if (amount > 0) {
+      this.#balance += amount
+      return true
+    }
+    return false
+  }
+
+  // 🛡️ VALIDACIÓN: método SEND con lógica interna
+  send(amount, targetAccount) {
+    // Validación interna ANTES de ejecutar
+    if (amount > 0 && this.#balance >= amount) {
+      this.#balance -= amount
+      targetAccount.deposit(amount)
+      return true
+    }
+    return false  // Fondos insuficientes o monto inválido
+  }
+}`)
+
+    await this.waitForEnter("\nPresiona Enter para ver Transaction...")
+
+    console.log("\n// Implementación de Transaction")
+    console.log(`class Transaction {
+  constructor(fromAccount, toAccount, amount) {
+    this.fromAccount = fromAccount
+    this.toAccount = toAccount
+    this.amount = amount
+    this.timestamp = new Date()
+    this.status = 'pending'
+  }
+
+  getDetails() {
+    return {
+      from: this.fromAccount.accountNumber,
+      to: this.toAccount.accountNumber,
+      amount: this.amount,
+      timestamp: this.timestamp,
+      status: this.status
+    }
+  }
+
+  isValid() {
+    return this.amount > 0 &&
+           this.fromAccount.getBalance() >= this.amount
+  }
+
+  execute() {
+    if (this.isValid()) {
+      const success = this.fromAccount.send(this.amount, this.toAccount)
+      this.status = success ? 'completed' : 'failed'
+      return success
+    }
+    this.status = 'failed'
+    return false
+  }
+}`)
+
+    await this.waitForEnter("\nPresiona Enter para ver Bank...")
+
+    console.log("\n// Implementación de Bank")
+    console.log(`class Bank {
+  constructor() {
+    this.accounts = []
+    this.transactions = []
+    this.nextAccountNumber = 1000
+  }
+
+  createAccount(ownerName, initialBalance) {
+    const account = new BankAccount(
+      this.nextAccountNumber++,
+      ownerName,
+      initialBalance
+    )
+    this.accounts.push(account)
+    return account
+  }
+
+  transfer(fromAccount, toAccount, amount) {
+    const transaction = new Transaction(fromAccount, toAccount, amount)
+
+    // El Bank valida ANTES de ejecutar
+    if (this.validateOperation(fromAccount, amount)) {
+      const success = transaction.execute()
+      this.transactions.push(transaction)
+      return transaction
+    }
+
+    transaction.status = 'failed'
+    this.transactions.push(transaction)
+    return transaction
+  }
+
+  validateOperation(account, amount) {
+    return amount > 0 && account.getBalance() >= amount
+  }
+
+  getAllTransactions() {
+    return [...this.transactions]
+  }
+}`)
+
+    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 bancario")
+    console.log("const bank = new Bank()")
+    console.log("const cuenta1 = bank.createAccount('Ana García', 1000)")
+    console.log("const cuenta2 = bank.createAccount('Carlos López', 500)")
+    console.log("")
+    console.log("// 🔑 ENCAPSULACIÓN: Solo podemos acceder al balance via getBalance()")
+    console.log("console.log('Balance Ana:', cuenta1.getBalance())  // 1000")
+    console.log("console.log('Balance Carlos:', cuenta2.getBalance())  // 500")
+    console.log("")
+    console.log("// 🛡️ VALIDACIÓN: send() verifica internamente antes de ejecutar")
+    console.log("const exitoso = cuenta1.send(300, cuenta2)  // ✅ Tiene fondos")
+    console.log("console.log('Transferencia exitosa:', exitoso)  // true")
+    console.log("")
+    console.log("const fallido = cuenta1.send(1500, cuenta2)  // ❌ Fondos insuficientes")
+    console.log("console.log('Transferencia fallida:', fallido)  // false")
+    console.log("")
+    console.log("// El estado interno se mantiene íntegro")
+    console.log("console.log('Balance final Ana:', cuenta1.getBalance())  // 700")
+    console.log("console.log('Balance final Carlos:', cuenta2.getBalance())  // 800")
+
+    console.log("\n🎯 Resultado esperado:")
+    console.log("Balance Ana: 1000")
+    console.log("Balance Carlos: 500")
+    console.log("Transferencia exitosa: true")
+    console.log("Transferencia fallida: false")
+    console.log("Balance final Ana: 700")
+    console.log("Balance final Carlos: 800")
+
+    await this.waitForEnter("\nPresiona Enter para ver los beneficios de este enfoque...")
+
+    console.clear()
+    console.log("🌟 BENEFICIOS DEL DISEÑO INTERFACE-FIRST EN SISTEMAS BANCARIOS")
+    console.log("=" .repeat(60))
+    console.log("1. 🔒 Encapsulación: El balance está protegido, solo accesible via getBalance()")
+    console.log("2. 🛡️ Validación: send() incluye lógica de negocio interna")
+    console.log("3. 🎯 Claridad: Cada objeto tiene responsabilidades financieras bien definidas")
+    console.log("4. 🔗 Colaboración: Los objetos saben exactamente cómo solicitar operaciones")
+    console.log("5. 🧪 Testeable: Podemos simular cuentas y transacciones fácilmente")
+    console.log("6. 📚 Mantenible: Las interfaces documentan el contrato bancario")
+
+    console.log("\n💡 Ejemplo de extensibilidad:")
+    console.log("// Podemos crear diferentes tipos de cuenta sin cambiar Bank")
+    console.log("class SavingsAccount extends BankAccount {")
+    console.log("  getBalance() {")
+    console.log("    return super.getBalance() + this.calculateInterest()")
+    console.log("  }")
+    console.log("}")
+    console.log("")
+    console.log("class CreditAccount extends BankAccount {")
+    console.log("  send(amount, target) {")
+    console.log("    // Permite sobregiro hasta el límite de crédito")
+    console.log("    if (amount > 0 && (this.getBalance() + this.creditLimit) >= amount) {")
+    console.log("      // ... lógica específica")
+    console.log("    }")
+    console.log("  }")
+    console.log("}")
+    console.log("")
+    console.log("// Bank sigue funcionando igual con cualquier tipo de cuenta!")
+    console.log("const savingsAcc = new SavingsAccount(123, 'María', 1000)")
+    console.log("const creditAcc = new CreditAccount(456, 'Juan', 500, 2000)  // límite crédito")
+    console.log("bank.transfer(savingsAcc, creditAcc, 300)  // ¡Funciona!")
+
+    await this.waitForEnter("\nPresiona Enter para continuar con la conclusión...")
+  }
+
+  async conclusion() {
+    console.clear()
+    console.log("🎓 CONCLUSIÓN: Diseño basado en Interfaces (Sistema Bancario)")
+    console.log("=" .repeat(55))
+    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🔑 Lecciones específicas del ejemplo bancario:")
+    console.log("• ENCAPSULACIÓN: getBalance() protege el acceso al estado interno")
+    console.log("• VALIDACIÓN: send() ejecuta lógica de negocio antes de operar")
+    console.log("• RESPONSABILIDAD: Cada objeto maneja su propia integridad")
+    console.log("• COLABORACIÓN: Bank, BankAccount y Transaction trabajan juntos")
+
+    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. Incluye validaciones internas en tus métodos")
+    console.log("4. Encapsula el estado, expón solo lo necesario")
+    console.log("5. Haz que los objetos colaboren a través de solicitudes")
+
+    console.log("\n💭 Reflexión final:")
+    console.log("En el mundo real, ¿cómo te asegurarías de que tu cuenta bancaria")
+    console.log("esté protegida y que solo se ejecuten operaciones válidas?")
+    console.log("¡Exactamente como lo hicimos aquí: interfaces bien definidas!")
+
+    console.log("\n🏆 ¡Has completado el ejemplo más importante del diseño orientado a objetos!")
+    console.log("Ahora entiendes por qué el ÉNFASIS debe estar en las interfaces.")
+
+    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.1",
   "description": "Salgamos de este laberinto.",
   "type": "module",
   "bin": {