@icarusmx/creta 0.10.2 → 1.0.0

package/lessons/lesson3-only-way.js

@@ -0,0 +1,327 @@
+#!/usr/bin/env node
+
+// LECCIÓN 3: Las solicitudes son la única forma de conseguir que un objeto lleve a cabo una operación
+// Enfoque práctico: Demostrar que NO hay alternativas a las solicitudes para ejecutar operaciones
+
+import { createInterface } from 'readline'
+
+export class Lesson3OnlyWay {
+  constructor() {
+    this.rl = createInterface({
+      input: process.stdin,
+      output: process.stdout
+    })
+  }
+
+  async start() {
+    console.log("🎯 LECCIÓN 3: Solicitudes como Única Forma")
+    console.log("=" .repeat(50))
+    console.log("📚 Enunciado: Las solicitudes son la única forma de conseguir que un objeto lleve a cabo una operación.")
+    console.log("\n💡 ¿Por qué ÚNICA forma?")
+    console.log("- No puedes forzar a un objeto a ejecutar algo")
+    console.log("- No puedes manipular directamente su estado interno")
+    console.log("- Toda operación DEBE pasar por una solicitud")
+    console.log("- El objeto decide si acepta o rechaza la solicitud")
+
+    await this.waitForEnter("\nPresiona Enter para ver qué significa esto en la práctica...")
+
+    await this.practicalExercise()
+    await this.conclusion()
+
+    this.rl.close()
+  }
+
+  async practicalExercise() {
+    console.clear()
+    console.log("🛠️ EJERCICIO PRÁCTICO: Caja Fuerte Digital")
+    console.log("=" .repeat(50))
+    console.log("🎯 Vamos a demostrar por qué las solicitudes son la ÚNICA forma")
+    console.log("\nSistema: Una caja fuerte que protege documentos importantes")
+    console.log("Objeto: DigitalSafe")
+
+    await this.waitForEnter("\nPresiona Enter para ver todas las formas que NO funcionan...")
+
+    await this.step1_ShowWhatDoesntWork()
+    await this.step2_ShowOnlyWay()
+    await this.step3_ObjectDecision()
+    await this.step4_CompleteDemo()
+  }
+
+  async step1_ShowWhatDoesntWork() {
+    console.clear()
+    console.log("❌ FORMAS QUE NO FUNCIONAN")
+    console.log("=" .repeat(35))
+    console.log("Veamos todas las cosas que NO puedes hacer:")
+
+    console.log("\n🚫 1. ACCESO DIRECTO A DATOS (Imposible)")
+    console.log(`// ❌ Esto NO funciona en objetos bien diseñados
+class DigitalSafe {
+  constructor() {
+    this.#documents = []     // PRIVADO
+    this.#isLocked = true    // PRIVADO
+    this.#password = "1234"  // PRIVADO
+  }
+}
+
+const safe = new DigitalSafe()
+// ❌ ERROR: No puedes acceder a datos privados
+console.log(safe.#documents)  // SyntaxError!
+safe.#isLocked = false        // SyntaxError!`)
+
+    await this.waitForEnter("\nPresiona Enter para ver más formas que no funcionan...")
+
+    console.log("\n🚫 2. MANIPULACIÓN EXTERNA (Imposible)")
+    console.log(`// ❌ No puedes forzar cambios desde afuera
+safe.documents = ["documento_falso.pdf"]  // undefined (no existe)
+safe.isLocked = false                     // undefined (no existe)
+safe.forceOpen()                          // TypeError: no es función
+
+// ❌ No puedes inyectar funciones
+safe.hackOpen = function() { this.#isLocked = false }  // No funciona`)
+
+    await this.waitForEnter("\nPresiona Enter para ver la última forma que no funciona...")
+
+    console.log("\n🚫 3. HERENCIA FORZADA (Violación de diseño)")
+    console.log(`// ❌ Incluso extendiendo la clase, no puedes saltarte las reglas
+class HackedSafe extends DigitalSafe {
+  forceOpen() {
+    // ❌ ERROR: No puedes acceder a campos privados del padre
+    this.#isLocked = false    // SyntaxError!
+    return this.#documents    // SyntaxError!
+  }
+}`)
+
+    console.log("\n💡 Observación clave:")
+    console.log("El objeto está completamente protegido. No hay forma de")
+    console.log("manipularlo externamente sin su consentimiento.")
+
+    await this.waitForEnter("\nPresiona Enter para ver la ÚNICA forma que funciona...")
+  }
+
+  async step2_ShowOnlyWay() {
+    console.clear()
+    console.log("✅ LA ÚNICA FORMA: SOLICITUDES")
+    console.log("=" .repeat(40))
+    console.log("Solo hay UNA manera de que el objeto ejecute operaciones:")
+
+    console.log("\n🔑 IMPLEMENTACIÓN COMPLETA:")
+    console.log(`class DigitalSafe {
+  constructor() {
+    this.#documents = []
+    this.#isLocked = true
+    this.#password = "1234"
+    this.#attempts = 0
+    this.#maxAttempts = 3
+  }
+
+  // ✅ SOLICITUD: Intentar desbloquear
+  unlock(password) {
+    if (this.#attempts >= this.#maxAttempts) {
+      return { success: false, message: "Bloqueado por seguridad" }
+    }
+
+    if (password === this.#password) {
+      this.#isLocked = false
+      this.#attempts = 0
+      return { success: true, message: "Caja fuerte desbloqueada" }
+    } else {
+      this.#attempts++
+      return {
+        success: false,
+        message: \`Contraseña incorrecta. Intentos restantes: \${this.#maxAttempts - this.#attempts}\`
+      }
+    }
+  }
+
+  // ✅ SOLICITUD: Agregar documento
+  addDocument(document) {
+    if (this.#isLocked) {
+      return { success: false, message: "Caja fuerte bloqueada" }
+    }
+
+    this.#documents.push(document)
+    return { success: true, message: "Documento agregado" }
+  }
+
+  // ✅ SOLICITUD: Obtener documentos
+  getDocuments() {
+    if (this.#isLocked) {
+      return { success: false, message: "Caja fuerte bloqueada", documents: [] }
+    }
+
+    return { success: true, documents: [...this.#documents] }
+  }
+
+  // ✅ SOLICITUD: Bloquear
+  lock() {
+    this.#isLocked = true
+    return { success: true, message: "Caja fuerte bloqueada" }
+  }
+
+  // ✅ SOLICITUD: Consultar estado
+  getStatus() {
+    return {
+      isLocked: this.#isLocked,
+      documentsCount: this.#documents.length,
+      attemptsRemaining: this.#maxAttempts - this.#attempts
+    }
+  }
+}`)
+
+    await this.waitForEnter("\nPresiona Enter para ver por qué esto es la ÚNICA forma...")
+  }
+
+  async step3_ObjectDecision() {
+    console.clear()
+    console.log("🧠 EL OBJETO DECIDE")
+    console.log("=" .repeat(25))
+    console.log("Observa que cada solicitud permite al objeto DECIDIR:")
+
+    console.log("\n🔍 EJEMPLO 1: Solicitud aceptada")
+    console.log(`const safe = new DigitalSafe()
+
+// SOLICITUD: unlock con contraseña correcta
+const result = safe.unlock("1234")
+console.log(result)  // { success: true, message: "Caja fuerte desbloqueada" }
+
+// El OBJETO decidió aceptar la solicitud porque:
+// - La contraseña era correcta
+// - No se habían agotado los intentos`)
+
+    await this.waitForEnter("\nPresiona Enter para ver una solicitud rechazada...")
+
+    console.log("\n🚫 EJEMPLO 2: Solicitud rechazada")
+    console.log(`// SOLICITUD: addDocument sin desbloquear
+const result2 = safe.addDocument("documento_secreto.pdf")
+console.log(result2)  // { success: false, message: "Caja fuerte bloqueada" }
+
+// El OBJETO decidió rechazar la solicitud porque:
+// - La caja fuerte está bloqueada
+// - No cumple las condiciones internas`)
+
+    await this.waitForEnter("\nPresiona Enter para ver el control total del objeto...")
+
+    console.log("\n🛡️ EJEMPLO 3: Protección automática")
+    console.log(`// Intentos fallidos múltiples
+safe.unlock("wrong1")  // { success: false, message: "Contraseña incorrecta..." }
+safe.unlock("wrong2")  // { success: false, message: "Contraseña incorrecta..." }
+safe.unlock("wrong3")  // { success: false, message: "Contraseña incorrecta..." }
+safe.unlock("1234")    // { success: false, message: "Bloqueado por seguridad" }
+
+// El OBJETO decidió bloquearse completamente porque:
+// - Se agotaron los intentos permitidos
+// - Sus reglas internas de seguridad se activaron`)
+
+    console.log("\n💡 Punto clave:")
+    console.log("Incluso con la contraseña correcta, el objeto puede rechazar")
+    console.log("la solicitud si sus condiciones internas no se cumplen.")
+
+    await this.waitForEnter("\nPresiona Enter para la demostración completa...")
+  }
+
+  async step4_CompleteDemo() {
+    console.clear()
+    console.log("🎭 DEMOSTRACIÓN: Flujo Completo")
+    console.log("=" .repeat(40))
+    console.log("Veamos un flujo completo de solicitudes:")
+
+    console.log("\n// Crear caja fuerte")
+    console.log("const safe = new DigitalSafe()")
+    console.log("")
+    console.log("// 🔍 SOLICITUD: Consultar estado inicial")
+    console.log("console.log(safe.getStatus())")
+    console.log("// { isLocked: true, documentsCount: 0, attemptsRemaining: 3 }")
+    console.log("")
+    console.log("// 🚫 SOLICITUD: Intentar agregar documento (será rechazada)")
+    console.log("safe.addDocument('mi_testamento.pdf')")
+    console.log("// { success: false, message: 'Caja fuerte bloqueada' }")
+    console.log("")
+    console.log("// 🔑 SOLICITUD: Desbloquear")
+    console.log("safe.unlock('1234')")
+    console.log("// { success: true, message: 'Caja fuerte desbloqueada' }")
+    console.log("")
+    console.log("// ✅ SOLICITUD: Ahora sí agregar documento")
+    console.log("safe.addDocument('mi_testamento.pdf')")
+    console.log("// { success: true, message: 'Documento agregado' }")
+    console.log("")
+    console.log("safe.addDocument('contrato_importante.pdf')")
+    console.log("// { success: true, message: 'Documento agregado' }")
+
+    await this.waitForEnter("\nPresiona Enter para ver la recuperación...")
+
+    console.log("\n// 📄 SOLICITUD: Recuperar documentos")
+    console.log("const docs = safe.getDocuments()")
+    console.log("console.log(docs)")
+    console.log("// { success: true, documents: ['mi_testamento.pdf', 'contrato_importante.pdf'] }")
+    console.log("")
+    console.log("// 🔒 SOLICITUD: Bloquear nuevamente")
+    console.log("safe.lock()")
+    console.log("// { success: true, message: 'Caja fuerte bloqueada' }")
+    console.log("")
+    console.log("// 🚫 SOLICITUD: Intentar recuperar (será rechazada)")
+    console.log("safe.getDocuments()")
+    console.log("// { success: false, message: 'Caja fuerte bloqueada', documents: [] }")
+
+    console.log("\n🎯 Observaciones finales:")
+    console.log("• Cada operación requirió una SOLICITUD específica")
+    console.log("• El objeto controló completamente qué solicitudes aceptar")
+    console.log("• No hubo forma de saltarse este mecanismo")
+    console.log("• Las solicitudes son verdaderamente la ÚNICA forma")
+
+    await this.waitForEnter("\nPresiona Enter para la conclusión...")
+  }
+
+  async conclusion() {
+    console.clear()
+    console.log("🎓 CONCLUSIÓN: Solicitudes como Única Forma")
+    console.log("=" .repeat(50))
+    console.log("🎯 Hemos demostrado que:")
+
+    console.log("\n1️⃣ NO es posible acceder directamente a datos privados")
+    console.log("2️⃣ NO es posible manipular el objeto externamente")
+    console.log("3️⃣ NO es posible forzar operaciones sin consentimiento")
+    console.log("4️⃣ Las SOLICITUDES son literalmente la única forma")
+
+    console.log("\n🔑 Características de las solicitudes:")
+    console.log("• El objeto DECIDE si acepta o rechaza")
+    console.log("• Cada solicitud pasa por validaciones internas")
+    console.log("• El objeto mantiene control total de su estado")
+    console.log("• Las reglas internas se respetan siempre")
+
+    console.log("\n🛡️ Beneficios de este diseño:")
+    console.log("• Seguridad garantizada")
+    console.log("• Integridad de datos preservada")
+    console.log("• Comportamiento predecible")
+    console.log("• Control total del objeto sobre sí mismo")
+
+    console.log("\n📚 Conexión con otras lecciones:")
+    console.log("• Lección 1: Los objetos que identificamos tienen este comportamiento")
+    console.log("• Lección 2: Esas interacciones son siempre solicitudes")
+    console.log("• Lección 3: ✅ Y 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("Imagina que tu casa tuviera esta protección: nadie puede entrar")
+    console.log("a menos que tú decidas abrir la puerta después de verificar")
+    console.log("quién es. Los objetos funcionan exactamente igual.")
+
+    console.log("\n🏆 Ahora entiendes por qué las solicitudes son la ÚNICA forma:")
+    console.log("porque los objetos están diseñados para protegerse y decidir.")
+
+    await this.waitForEnter("\n✨ ¡Lección 3 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 Lesson3OnlyWay()
+  await lesson.start()
+}

package/lessons/lesson4-operation-signatures.js

@@ -0,0 +1,327 @@
+#!/usr/bin/env node
+
+// LECCIÓN 4: Cada operación declarada por un objeto debe incluir: a) nombre de la operación; b) insumos necesarios para realizar la operación; c) el valor que regresa tras ejecutar la operación. Estos tres elementos constituyen la firma de operación.
+// Enfoque práctico: Diseñar firmas de operación precisas y completas
+
+import { createInterface } from 'readline'
+
+export class Lesson4OperationSignatures {
+  constructor() {
+    this.rl = createInterface({
+      input: process.stdin,
+      output: process.stdout
+    })
+  }
+
+  async start() {
+    console.log("🎯 LECCIÓN 4: Firmas de Operación")
+    console.log("=" .repeat(50))
+    console.log("📚 Enunciado: Cada operación declarada por un objeto debe incluir:")
+    console.log("   a) nombre de la operación")
+    console.log("   b) insumos necesarios para realizar la operación")
+    console.log("   c) el valor que regresa tras ejecutar la operación")
+    console.log("   Estos tres elementos constituyen la firma de operación.")
+
+    console.log("\n💡 ¿Por qué son importantes las firmas?")
+    console.log("- Define exactamente QUÉ hace la operación (nombre)")
+    console.log("- Define exactamente QUÉ necesita (insumos)")
+    console.log("- Define exactamente QUÉ devuelve (valor de retorno)")
+    console.log("- Permite predecir el comportamiento sin ver la implementación")
+
+    await this.waitForEnter("\nPresiona Enter para comenzar con ejemplos prácticos...")
+
+    await this.practicalExercise()
+    await this.conclusion()
+
+    this.rl.close()
+  }
+
+  async practicalExercise() {
+    console.clear()
+    console.log("🛠️ EJERCICIO PRÁCTICO: Calculadora Financiera")
+    console.log("=" .repeat(50))
+    console.log("🎯 Vamos a diseñar firmas de operación precisas y completas")
+    console.log("\nSistema: Calculadora para operaciones financieras")
+    console.log("Objeto: FinancialCalculator")
+
+    await this.waitForEnter("\nPresiona Enter para ver firmas mal diseñadas...")
+
+    await this.step1_BadSignatures()
+    await this.step2_GoodSignatures()
+    await this.step3_SignatureAnalysis()
+    await this.step4_CompleteExample()
+  }
+
+  async step1_BadSignatures() {
+    console.clear()
+    console.log("❌ FIRMAS MAL DISEÑADAS")
+    console.log("=" .repeat(30))
+    console.log("Veamos firmas incompletas o confusas:")
+
+    console.log("\n🚫 PROBLEMA 1: Nombre poco claro")
+    console.log(`// ❌ ¿Qué hace exactamente 'calc'?
+calc(x, y) → ?
+
+// ❌ ¿Es 'do' suma, resta, multiplicación?
+do(amount, rate) → ?`)
+
+    console.log("\n🚫 PROBLEMA 2: Insumos ambiguos")
+    console.log(`// ❌ ¿Qué tipo de datos espera?
+calculateInterest(amount, rate) → number
+// ¿amount es string o number?
+// ¿rate es porcentaje (0.05) o entero (5)?`)
+
+    console.log("\n🚫 PROBLEMA 3: Valor de retorno incierto")
+    console.log(`// ❌ ¿Qué devuelve exactamente?
+calculatePayment() → ?
+// ¿Un número? ¿Un objeto? ¿null si falla?
+
+// ❌ ¿Y si hay error?
+divideNumbers(a, b) → number
+// ¿Qué pasa si b es 0?`)
+
+    await this.waitForEnter("\nPresiona Enter para ver más problemas...")
+
+    console.log("\n🚫 PROBLEMA 4: Firmas inconsistentes")
+    console.log(`// ❌ Métodos similares con firmas diferentes
+addMoney(amount) → boolean
+subtractCash(value, currency) → {success: boolean, balance: number}
+multiply(x, y, precision) → number | null
+
+// ❌ Imposible predecir qué esperar de cada método`)
+
+    console.log("\n💥 Consecuencias:")
+    console.log("• Imposible usar el objeto sin ver el código interno")
+    console.log("• Errores constantes por malentender los parámetros")
+    console.log("• Código frágil y difícil de mantener")
+    console.log("• Colaboración entre objetos impredecible")
+
+    await this.waitForEnter("\nPresiona Enter para ver cómo debe ser...")
+  }
+
+  async step2_GoodSignatures() {
+    console.clear()
+    console.log("✅ FIRMAS BIEN DISEÑADAS")
+    console.log("=" .repeat(35))
+    console.log("Ahora veamos firmas completas y precisas:")
+
+    console.log("\n🎯 ELEMENTO A: Nombre claro y específico")
+    console.log(`// ✅ Nombres que describen exactamente la operación
+calculateSimpleInterest(principal, rate, time) → number
+calculateCompoundInterest(principal, rate, time, frequency) → number
+calculateMonthlyPayment(loanAmount, interestRate, termInMonths) → number`)
+
+    console.log("\n📥 ELEMENTO B: Insumos específicos y tipados")
+    console.log(`// ✅ Cada parámetro claramente definido
+calculateSimpleInterest(
+  principal: number,      // Monto principal en pesos
+  rate: number,          // Tasa anual como decimal (0.05 = 5%)
+  time: number           // Tiempo en años
+) → number
+
+calculateMonthlyPayment(
+  loanAmount: number,         // Monto del préstamo en pesos
+  interestRate: number,       // Tasa mensual como decimal
+  termInMonths: number        // Plazo en meses
+) → number`)
+
+    console.log("\n📤 ELEMENTO C: Valor de retorno específico")
+    console.log(`// ✅ Especifica exactamente qué devuelve y cuándo
+calculateLoanPayment(amount, rate, term) → {
+  success: boolean,
+  monthlyPayment: number | null,
+  totalInterest: number | null,
+  error: string | null
+}
+
+validateLoanAmount(amount) → {
+  isValid: boolean,
+  minimumRequired: number,
+  maximumAllowed: number
+}`)
+
+    await this.waitForEnter("\nPresiona Enter para ver la implementación completa...")
+  }
+
+  async step3_SignatureAnalysis() {
+    console.clear()
+    console.log("🔍 ANÁLISIS DE FIRMAS COMPLETAS")
+    console.log("=" .repeat(40))
+    console.log("Examinemos cada elemento de las firmas:")
+
+    console.log("\n💼 EJEMPLO: Calculadora financiera completa")
+    console.log(`class FinancialCalculator {
+  // 🎯 FIRMA 1: Interés simple
+  calculateSimpleInterest(
+    principal: number,    // a) Monto principal en pesos
+    rate: number,        // b) Tasa anual (0.05 = 5%)
+    time: number         // c) Tiempo en años
+  ): number {            // RETORNA: Interés total calculado
+    return principal * rate * time
+  }
+
+  // 🎯 FIRMA 2: Validación con resultado estructurado
+  validateLoanApplication(
+    income: number,           // a) Ingreso mensual
+    existingDebt: number,     // b) Deuda actual
+    requestedAmount: number   // c) Monto solicitado
+  ): {                       // RETORNA: Objeto con análisis completo
+    approved: boolean,
+    maxLoanAmount: number,
+    debtToIncomeRatio: number,
+    reasons: string[]
+  }
+
+  // 🎯 FIRMA 3: Cálculo que puede fallar
+  calculateCompoundInterest(
+    principal: number,    // a) Monto principal
+    rate: number,        // b) Tasa anual
+    time: number,        // c) Años
+    frequency: number    // d) Frecuencia de composición
+  ): number | null {     // RETORNA: Resultado o null si hay error
+    if (principal <= 0 || rate < 0 || time <= 0 || frequency <= 0) {
+      return null
+    }
+    return principal * Math.pow(1 + rate/frequency, frequency * time)
+  }
+}`)
+
+    await this.waitForEnter("\nPresiona Enter para analizar cada firma...")
+
+    console.log("\n📋 ANÁLISIS FIRMA POR FIRMA:")
+    console.log("\n1️⃣ calculateSimpleInterest:")
+    console.log("   • NOMBRE: 'calculateSimpleInterest' - claro y específico")
+    console.log("   • INSUMOS: (principal, rate, time) - 3 números con propósito definido")
+    console.log("   • RETORNO: number - interés calculado, siempre un número")
+
+    console.log("\n2️⃣ validateLoanApplication:")
+    console.log("   • NOMBRE: 'validateLoanApplication' - describe validación completa")
+    console.log("   • INSUMOS: (income, existingDebt, requestedAmount) - datos financieros")
+    console.log("   • RETORNO: objeto estructurado - análisis completo con múltiples campos")
+
+    console.log("\n3️⃣ calculateCompoundInterest:")
+    console.log("   • NOMBRE: 'calculateCompoundInterest' - específico del tipo de interés")
+    console.log("   • INSUMOS: (principal, rate, time, frequency) - 4 parámetros necesarios")
+    console.log("   • RETORNO: number | null - puede fallar si datos inválidos")
+
+    await this.waitForEnter("\nPresiona Enter para ver cómo usar estas firmas...")
+  }
+
+  async step4_CompleteExample() {
+    console.clear()
+    console.log("🎭 DEMOSTRACIÓN: Uso con Firmas Claras")
+    console.log("=" .repeat(45))
+    console.log("Veamos cómo las firmas bien diseñadas facilitan el uso:")
+
+    console.log("\n// Crear calculadora")
+    console.log("const calc = new FinancialCalculator()")
+    console.log("")
+    console.log("// 💡 Con las firmas claras, sabemos exactamente qué esperar:")
+    console.log("")
+    console.log("// FIRMA: calculateSimpleInterest(principal, rate, time) → number")
+    console.log("const interest = calc.calculateSimpleInterest(10000, 0.05, 2)")
+    console.log("console.log(interest)  // 1000 (siempre un número)")
+
+    await this.waitForEnter("\nPresiona Enter para ver validación...")
+
+    console.log("\n// FIRMA: validateLoanApplication(income, debt, amount) → objeto")
+    console.log("const validation = calc.validateLoanApplication(5000, 1000, 50000)")
+    console.log("console.log(validation)")
+    console.log("// {")
+    console.log("//   approved: false,")
+    console.log("//   maxLoanAmount: 20000,")
+    console.log("//   debtToIncomeRatio: 0.2,")
+    console.log("//   reasons: ['Monto solicitado excede capacidad de pago']")
+    console.log("// }")
+    console.log("")
+    console.log("// 💡 Podemos usar cada campo porque la firma nos dice qué esperar")
+    console.log("if (validation.approved) {")
+    console.log("  console.log('Préstamo aprobado!')")
+    console.log("} else {")
+    console.log("  console.log('Máximo permitido:', validation.maxLoanAmount)")
+    console.log("  validation.reasons.forEach(reason => console.log('❌', reason))")
+    console.log("}")
+
+    await this.waitForEnter("\nPresiona Enter para ver manejo de errores...")
+
+    console.log("\n// FIRMA: calculateCompoundInterest(...) → number | null")
+    console.log("const compound1 = calc.calculateCompoundInterest(10000, 0.05, 2, 12)")
+    console.log("const compound2 = calc.calculateCompoundInterest(-1000, 0.05, 2, 12)")
+    console.log("")
+    console.log("// 💡 La firma nos dice que puede retornar null, así que verificamos")
+    console.log("if (compound1 !== null) {")
+    console.log("  console.log('Interés compuesto:', compound1)  // 11049.41")
+    console.log("}")
+    console.log("")
+    console.log("if (compound2 === null) {")
+    console.log("  console.log('Error: datos inválidos')  // Se ejecuta")
+    console.log("}")
+
+    console.log("\n🎯 Beneficios observados:")
+    console.log("• Sabemos exactamente qué pasar a cada método")
+    console.log("• Sabemos exactamente qué esperar de vuelta")
+    console.log("• Podemos manejar errores apropiadamente")
+    console.log("• El código es predecible y confiable")
+
+    await this.waitForEnter("\nPresiona Enter para la conclusión...")
+  }
+
+  async conclusion() {
+    console.clear()
+    console.log("🎓 CONCLUSIÓN: Firmas de Operación")
+    console.log("=" .repeat(40))
+    console.log("🎯 Hemos demostrado que cada firma debe incluir:")
+
+    console.log("\n🎯 A) NOMBRE de la operación:")
+    console.log("   • Claro y específico")
+    console.log("   • Describe exactamente qué hace")
+    console.log("   • Ejemplo: 'calculateSimpleInterest' vs 'calc'")
+
+    console.log("\n📥 B) INSUMOS necesarios:")
+    console.log("   • Tipo y propósito de cada parámetro")
+    console.log("   • Valores esperados y restricciones")
+    console.log("   • Ejemplo: 'rate: number (decimal, 0.05 = 5%)'")
+
+    console.log("\n📤 C) VALOR de retorno:")
+    console.log("   • Tipo exacto que retorna")
+    console.log("   • Qué significa el valor")
+    console.log("   • Cómo manejar casos de error")
+    console.log("   • Ejemplo: 'number | null' vs solo 'number'")
+
+    console.log("\n🌟 Beneficios de firmas completas:")
+    console.log("• Predictibilidad total del comportamiento")
+    console.log("• Colaboración segura entre objetos")
+    console.log("• Código autodocumentado")
+    console.log("• Detección temprana de errores")
+
+    console.log("\n📚 Conexión con otras lecciones:")
+    console.log("• Lección 1-3: Las operaciones que identificamos necesitan firmas")
+    console.log("• Lección 4: ✅ Cada operación tiene nombre, insumos y retorno")
+    console.log("• Lección 5: El conjunto de firmas forma la interfaz")
+    console.log("• Lección 6: El énfasis está en diseñar estas firmas primero")
+
+    console.log("\n💭 Reflexión:")
+    console.log("¿Te imaginas usar una función de la que no sabes qué parámetros")
+    console.log("espera ni qué devuelve? ¡Sería imposible! Las firmas son el")
+    console.log("contrato que hace posible la colaboración entre objetos.")
+
+    console.log("\n🏆 Ahora entiendes por qué cada operación necesita una firma")
+    console.log("completa: es la base de la comunicación predecible.")
+
+    await this.waitForEnter("\n✨ ¡Lección 4 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 Lesson4OperationSignatures()
+  await lesson.start()
+}