Skip to main content
Esta página faz parte de uma habilidade de agente de código IA e é escrita para agentes, não para humanos. Para a documentação legível por humanos da Base44, veja a documentação para desenvolvedores.

base44 types generate

Gera um arquivo de declaração TypeScript (types.d.ts) a partir dos recursos do projeto (entidades, funções, agentes, conectores).

Uso

npx base44 types generate

O que faz

  1. Lê a configuração do projeto — Escaneia base44/entities/, base44/functions/, base44/agents/ e base44/connectors/ para todos os recursos definidos
  2. Gera base44/.types/types.d.ts — Cria um arquivo de declaração TypeScript que aumenta o módulo @base44/sdk com registros tipados
  3. Atualiza tsconfig.json (se presente) — Adiciona automaticamente base44/.types/*.d.ts ao array include para que o TypeScript reconheça os tipos gerados

Autenticação

Não obrigatório. Este comando é executado inteiramente localmente e não precisa de autenticação.

Arquivo de saída

O arquivo gerado é colocado em:
base44/.types/types.d.ts

Conteúdo gerado

O arquivo de declaração aumenta o módulo @base44/sdk com quatro registros:
  • EntityTypeRegistry — Mapeia nomes de entidades para suas interfaces TypeScript (compiladas dos schemas JSON de entidades)
  • FunctionNameRegistry — Lista todos os nomes de funções de backend
  • AgentNameRegistry — Lista todos os nomes de agentes
  • ConnectorTypeRegistry — Lista todos os tipos de conector
Exemplo de saída:
// Auto-generated by Base44 CLI - DO NOT EDIT
// Regenerate with: base44 types generate

export interface Task {
  title: string;
  status: "todo" | "in_progress" | "done";
  assignee?: string;
}

export interface Board {
  name: string;
  description?: string;
}

declare module '@base44/sdk' {
  interface EntityTypeRegistry {
    "Task": Task;
    "Board": Board;
  }

  interface FunctionNameRegistry {
    "send_email": true;
  }

  interface AgentNameRegistry {
    "support_agent": true;
  }

  interface ConnectorTypeRegistry {
    "googlecalendar": true;
  }
}
Se nenhum recurso for encontrado, o arquivo contém um placeholder com instruções sobre como adicionar recursos.

Integração com tsconfig.json

Se um tsconfig.json existir na raiz do projeto, o comando adiciona automaticamente base44/.types/*.d.ts ao array include:
{
  "include": [
    "src",
    "base44/.types/*.d.ts"
  ]
}
Se o caminho já estiver incluído, ou nenhum tsconfig.json existir, esta etapa é ignorada silenciosamente.

Quando executar

  • Após criar ou modificar schemas de entidade em base44/entities/
  • Após adicionar ou remover funções de backend em base44/functions/
  • Após adicionar ou remover agentes em base44/agents/
  • Após adicionar ou remover conectores em base44/connectors/
  • Ao configurar um projeto TypeScript pela primeira vez com a Base44

Notas

  • O arquivo gerado não deve ser editado manualmente — será sobrescrito na próxima execução
  • Considere adicionar base44 types generate ao seu pipeline de build ou como script de pré-build
  • O diretório .types é criado automaticamente dentro da pasta base44/
Esta página foi traduzida usando IA. Para informações mais precisas e atualizadas, consulte a versão em inglês.