Pular para o conteúdo principal
Quando você trabalha com a Base44 em um projeto TypeScript, pode usar tipos dinâmicos. Suas entidades, funções, agentes e conectores têm tipos TypeScript correspondentes que fornecem:
  • Autocomplete: seu IDE sugere entidades, campos, funções, agentes e tipos de integração de conectores disponíveis.
  • Segurança de tipos: detecte erros de digitação e campos inválidos em tempo de compilação em vez de em tempo de execução.
  • Documentação: passe o cursor sobre os tipos no seu IDE para ver descrições de campos e tipos.

​
Como funciona

A Base44 lê a configuração do seu backend e cria um arquivo base44/.types/types.d.ts que aumenta o SDK com tipos do seu projeto. O arquivo de tipos inclui:
  • Esquemas de entidade com campos tipados e operações CRUD
  • Nomes de funções para autocomplete
  • Nomes de agentes para autocomplete
  • Nomes de tipos de integração de conectores para autocomplete

​
Tipos de entidade

Os tipos dinâmicos oferecem segurança de tipos completa para todas as operações de entidade. Seus campos de entidade, tipos de retorno e parâmetros são todos fortemente 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 função

Os nomes de função são tipados para autocomplete ao invocar funções: 
// Autocomplete shows all available functions
const result = await base44.functions.invoke("calculateTotal", {
  items: ["item1", "item2"],
});
Os tipos de parâmetros de função não são gerados. Consulte a implementação da sua função para os parâmetros esperados.

​
Tipos de agente

Os nomes dos agentes são tipados para autocomplete ao trabalhar com conversas: 
// Autocomplete shows all available agents
const conversation = await base44.agents.createConversation("SupportBot");

​
Tipos de conector

Os nomes dos tipos de integração de conectores são tipados para autocomplete ao recuperar conexões: 
// Autocomplete shows all available connector integration types
const { accessToken } = await base44.asServiceRole.connectors.getConnection(
  "googlecalendar"
);
O módulo connectors está disponível apenas no modo service role (ambientes de backend).

​
Gerar tipos

Para gerar ou atualizar seu arquivo de tipos, execute o comando types generate: 
base44 types generate
Execute types generate novamente sempre que modificar entidades, adicionar funções ou alterar agentes para manter os tipos atualizados.

​
Veja também

  • types generate: comando da CLI para gerar tipos a partir do seu projeto
  • entities: referência do SDK para trabalhar com entidades
  • functions: referência do SDK para invocar funções de backend
  • agents: referência do SDK para trabalhar com agentes de IA
  • connectors: referência do SDK para gerenciar tokens OAuth
Esta página foi traduzida usando IA. Para informações mais precisas e atualizadas, consulte a versão em inglês.