Saltar al contenido principal
Cuando trabajas con Base44 en un proyecto TypeScript, puedes usar tipos dinámicos. Tus entidades, funciones, agentes y conectores tienen tipos TypeScript correspondientes que proporcionan:
  • Autocompletado: tu IDE sugiere las entidades, campos, funciones, agentes y tipos de integración de conectores disponibles.
  • Seguridad de tipos: detecta erratas y campos inválidos en tiempo de compilación en lugar de en tiempo de ejecución.
  • Documentación: pasa el cursor sobre los tipos en tu IDE para ver las descripciones y tipos de los campos.

Cómo funciona

Base44 lee la configuración de tu backend y crea un archivo base44/.types/types.d.ts que aumenta el SDK con los tipos de tu proyecto. El archivo de tipos incluye:
  • Esquemas de entidad con campos tipados y operaciones CRUD
  • Nombres de función para autocompletado
  • Nombres de agente para autocompletado
  • Nombres de tipo de integración de conectores para autocompletado

Tipos de entidad

Los tipos dinámicos proporcionan seguridad de tipos completa para todas las operaciones de entidad. Los campos de tus entidades, los tipos de retorno y los parámetros están todos fuertemente tipados.
import type { EntityRecord } from "@base44/sdk";

type TaskRecord = EntityRecord["Task"];

// All fields are typed
const task = await base44.entities.Task.create({
  title: "Complete documentation",
  status: "in-progress",
  priority: "high",
});

// Return type includes both your fields and server fields
console.log(task.id); // Server field
console.log(task.created_date); // Server field
console.log(task.title); // Your field

// Get with full type safety
const retrieved = await base44.entities.Task.get(task.id);

// Update with type checking
await base44.entities.Task.update(task.id, {
  status: "completed",
});

Tipos de función

Los nombres de las funciones están tipados para autocompletado al invocar funciones:
// Autocomplete shows all available functions
const result = await base44.functions.invoke("calculateTotal", {
  items: ["item1", "item2"],
});
Los tipos de los parámetros de las funciones no se generan. Consulta la implementación de tu función para conocer los parámetros esperados.

Tipos de agente

Los nombres de los agentes están tipados para autocompletado al trabajar con conversaciones:
// Autocomplete shows all available agents
const conversation = await base44.agents.createConversation("SupportBot");

Tipos de conector

Los nombres de los tipos de integración de conectores están tipados para autocompletado al recuperar conexiones:
// Autocomplete shows all available connector integration types
const { accessToken } = await base44.asServiceRole.connectors.getConnection(
  "googlecalendar"
);
El módulo connectors solo está disponible en modo service role (entornos de backend).

Generar tipos

Para generar o actualizar tu archivo de tipos, ejecuta el comando types generate:
base44 types generate
Vuelve a ejecutar types generate cada vez que modifiques entidades, añadas funciones o cambies agentes para mantener los tipos actualizados.

Véase también

  • types generate: comando de la CLI para generar tipos a partir de tu proyecto
  • entities: referencia del SDK para trabajar con entidades
  • functions: referencia del SDK para invocar funciones del backend
  • agents: referencia del SDK para trabajar con agentes de IA
  • connectors: referencia del SDK para gestionar tokens OAuth
Esta página se tradujo con IA. Para información más precisa y actualizada, consulta la versión en inglés.