​

Base44 Coder

​

⚡ ACCIÓN INMEDIATA REQUERIDA - Lee esto primero

1. Comprueba si base44/config.jsonc existe en el directorio actual
2. Si SÍ (escenario de proyecto existente):
   • Esta habilidad (base44-sdk) maneja la solicitud
   • Implementa funciones usando el SDK de Base44
   • NO uses base44-cli a menos que el usuario solicite explícitamente comandos CLI
3. Si NO (escenario de nuevo proyecto):
   • Transfiere a la habilidad base44-cli para la inicialización del proyecto
   • Esta habilidad no puede ayudar hasta que el proyecto se inicialice

​

Cuándo usar esta habilidad vs base44-cli

• Construyas funciones en un proyecto de Base44 EXISTENTE
• base44/config.jsonc ya existe en el proyecto
• Los imports del SDK de Base44 están presentes (@base44/sdk)
• Escribas código JavaScript/TypeScript usando módulos del SDK de Base44
• Implementes funcionalidad, componentes o funciones
• El usuario menciona: “implementar”, “construir una función”, “añadir funcionalidad”, “escribir código para”
• El usuario dice “crear una app [tipo]” y ya existe un proyecto de Base44

• ❌ Inicializar nuevos proyectos de Base44 (usa base44-cli en su lugar)
• ❌ Directorios vacíos sin configuración de Base44
• ❌ Cuando el usuario dice “crear un nuevo proyecto/app/sitio de Base44” y no existe proyecto
• ❌ Comandos CLI como npx base44 create, npx base44 deploy, npx base44 login (usa base44-cli)

• base44-sdk asume que un proyecto de Base44 ya está inicializado
• base44-cli es un requisito previo para base44-sdk en nuevos proyectos
• Si el usuario quiere “crear una app” y no existe un proyecto de Base44, usa base44-cli primero

• SI (el usuario menciona “crear/construir app” O “hacer un proyecto”):
  • SI (el directorio está vacío O no existe base44/config.jsonc): → Usa base44-cli (se necesita inicialización de proyecto)
  • SI NO: → Usa base44-sdk (el proyecto existe, construye funciones)

​

Inicio rápido

// En apps generadas por Base44, el cliente base44 está preconfigurado y disponible

// Operaciones CRUD
const task = await base44.entities.Task.create({ title: "New task", status: "pending" });
const tasks = await base44.entities.Task.list();
await base44.entities.Task.update(task.id, { status: "done" });

// Obtener el usuario actual
const user = await base44.auth.me();

// Apps externas
import { createClient } from "@base44/sdk";

// IMPORTANTE: Usa 'appId' (NO 'clientId' o 'id')
const base44 = createClient({ appId: "your-app-id" });
await base44.auth.loginViaEmailPassword("user@example.com", "password");

​

⚠️ CRÍTICO: No alucines APIs

​

Autenticación - INCORRECTO vs CORRECTO

​

Funciones - INCORRECTO vs CORRECTO

​

Integraciones - INCORRECTO vs CORRECTO

​

Entidades - INCORRECTO vs CORRECTO

​

Módulos del SDK

​

TypeScript y registros de tipos

​

Instalación

npm install @base44/sdk

​

Crear un cliente (apps externas)

import { createClient } from "@base44/sdk";

// ✅ CORRECTO
const base44 = createClient({ appId: "your-app-id" });

// ❌ INCORRECTO - NO uses estos:
// const base44 = createClient({ clientId: "your-app-id" });  // INCORRECTO
// const base44 = createClient({ id: "your-app-id" });        // INCORRECTO

• token (string) - Token de usuario preautenticado
• options (object) - Opciones de configuración
  • options.onError (function) - Manejador de errores global

const base44 = createClient({
  appId: "your-app-id",
  options: {
    onError: (error) => {
      console.error("Base44 error:", error);
    }
  }
});

​

Selección de módulo

• Crear/leer/actualizar/eliminar registros → entities
• Importar datos desde archivo → entities.importEntities()
• Actualizaciones en tiempo real → entities.EntityName.subscribe()

• Login/registro/logout → auth
• Obtener usuario actual → auth.me()
• Actualizar perfil de usuario → auth.updateMe()
• Invitar usuarios → users.inviteUser()

• Chatear con agentes de IA → agents (requiere usuario registrado)
• Crear nueva conversación → agents.createConversation()
• Gestionar conversaciones → agents.getConversations()
• Generar texto/JSON con IA → integrations.Core.InvokeLLM()
• Generar imágenes → integrations.Core.GenerateImage()

• Ejecutar código del lado del servidor → functions.invoke()
• Necesitas acceso de administrador → base44.asServiceRole.functions.invoke()

• Enviar correos → integrations.Core.SendEmail()
• Subir archivos → integrations.Core.UploadFile()
• APIs personalizadas → integrations.custom.call()
• OAuth con ámbito de app (cuenta del constructor de la app) → asServiceRole.connectors.getConnection() (solo backend)

• Rastrear eventos personalizados → analytics.track()
• Registrar vistas de página/actividad → appLogs.logUserInApp()

​

Patrones comunes

​

Filtrar y ordenar datos

const pendingTasks = await base44.entities.Task.filter(
  { status: "pending", assignedTo: userId },  // consulta
  "-created_date",                             // orden (descendente)
  10,                                          // límite
  0                                            // saltar
);

​

Rutas protegidas (comprobar autenticación)

const user = await base44.auth.me();
if (!user) {
  // Navega a tu página de inicio de sesión personalizada
  navigate('/login', { state: { returnTo: window.location.pathname } });
  return;
}

​

Llamada a función de backend

// Frontend
// ⚠️ invoke() devuelve la respuesta axios SIN PROCESAR — el JSON de tu función está en `.data`,
//    NO el objeto de nivel superior. También LANZA en no-2xx (cuerpo de error en err.response.data).
const res = await base44.functions.invoke("processOrder", {
  orderId: "123",
  action: "ship"
});
const result = res.data; // ✅ por ejemplo, res.data.success  (res mismo es { data, status, headers, … })

// Función de backend (Deno)
import { createClientFromRequest } from "npm:@base44/sdk";

Deno.serve(async (req) => {
  const base44 = createClientFromRequest(req);
  const { orderId, action } = await req.json();
  // Procesa con rol de servicio para acceso de administrador
  const order = await base44.asServiceRole.entities.Orders.get(orderId);
  return Response.json({ success: true });
});

​

Acceso de rol de servicio

// Modo usuario - respeta permisos
const myTasks = await base44.entities.Task.list();

// Rol de servicio - acceso total (solo backend)
const allTasks = await base44.asServiceRole.entities.Task.list();
const token = await base44.asServiceRole.connectors.getAccessToken("slack");

​

Frontend vs Backend