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

> Genera il file di dichiarazione TypeScript (types.d.ts) dalle risorse del progetto (entità, funzioni, agenti, connettori).

<Warning>
  Questa pagina fa parte di una skill per agenti di codifica IA ed è scritta per gli agenti, non per gli esseri umani. Per la documentazione Base44 leggibile dagli umani, consulta la [documentazione per sviluppatori](/developers).
</Warning>

# `base44 types generate`

Genera il file di dichiarazione TypeScript (`types.d.ts`) dalle risorse del progetto (entità, funzioni, agenti, connettori).

## Utilizzo

```bash theme={null}
npx base44 types generate
```

## Cosa fa

1. **Legge la configurazione del progetto** — Analizza `base44/entities/`, `base44/functions/`, `base44/agents/` e `base44/connectors/` per tutte le risorse definite
2. **Genera `base44/.types/types.d.ts`** — Crea un file di dichiarazione TypeScript che estende il modulo `@base44/sdk` con registri tipizzati
3. **Aggiorna `tsconfig.json`** (se presente) — Aggiunge automaticamente `base44/.types/*.d.ts` all'array `include` così TypeScript riconosce i tipi generati

## Autenticazione

**Non richiesta.** Questo comando viene eseguito interamente in locale e non richiede autenticazione.

## File di output

Il file generato viene collocato in:

```
base44/.types/types.d.ts
```

### Contenuto generato

Il file di dichiarazione estende il modulo `@base44/sdk` con quattro registri:

* **`EntityTypeRegistry`** — Mappa i nomi delle entità alle loro interfacce TypeScript (compilate dagli schemi JSON delle entità)
* **`FunctionNameRegistry`** — Elenca tutti i nomi delle funzioni backend
* **`AgentNameRegistry`** — Elenca tutti i nomi degli agenti
* **`ConnectorTypeRegistry`** — Elenca tutti i tipi di connettori

**Esempio di output:**

```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 non vengono trovate risorse, il file contiene un segnaposto con istruzioni su come aggiungerle.

## Integrazione con tsconfig.json

Se nella radice del progetto esiste un `tsconfig.json`, il comando aggiunge automaticamente `base44/.types/*.d.ts` all'array `include`:

```json theme={null}
{
  "include": [
    "src",
    "base44/.types/*.d.ts"
  ]
}
```

Se il percorso è già incluso, o se non esiste alcun `tsconfig.json`, questo passaggio viene saltato silenziosamente.

## Quando eseguirlo

* Dopo aver creato o modificato schemi di entità in `base44/entities/`
* Dopo aver aggiunto o rimosso funzioni backend in `base44/functions/`
* Dopo aver aggiunto o rimosso agenti in `base44/agents/`
* Dopo aver aggiunto o rimosso connettori in `base44/connectors/`
* Quando configuri per la prima volta un progetto TypeScript con Base44

## Note

* Il file generato **non** deve essere modificato manualmente — verrà sovrascritto alla prossima esecuzione
* Considera di aggiungere `base44 types generate` alla tua pipeline di build o come script pre-build
* La directory `.types` viene creata automaticamente all'interno della cartella `base44/`

<Note>Questa pagina è stata tradotta utilizzando l'IA. Per informazioni più accurate e aggiornate, consulta la [versione inglese](/). </Note>