> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# `base44 types generate`

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

<Warning>
  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](/developers).
</Warning>

# `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

```bash theme={null}
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:**

```typescript theme={null}
// 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`:

```json theme={null}
{
  "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/`

<Note>Esta página foi traduzida usando IA. Para informações mais precisas e atualizadas, consulte a [versão em inglês](/). </Note>