Passer au contenu principal
Lorsque vous travaillez avec Base44 dans un projet TypeScript, vous pouvez utiliser des types dynamiques. Vos entités, fonctions, agents et connecteurs ont des types TypeScript correspondants qui fournissent :
  • Autocomplétion : Votre IDE suggère les entités, champs, fonctions, agents et types d’intégration de connecteurs disponibles.
  • Sécurité de type : Détectez les fautes de frappe et les champs invalides au moment de la compilation au lieu de l’exécution.
  • Documentation : Survolez les types dans votre IDE pour voir les descriptions et types des champs.

Comment ça marche

Base44 lit la configuration de votre backend et crée un fichier base44/.types/types.d.ts qui augmente le SDK avec les types de votre projet. Le fichier de types inclut :
  • Schémas d’entités avec champs typés et opérations CRUD
  • Noms de fonctions pour l’autocomplétion
  • Noms d’agents pour l’autocomplétion
  • Noms de types d’intégration de connecteurs pour l’autocomplétion

Types d’entités

Les types dynamiques fournissent une sécurité de type complète pour toutes les opérations d’entité. Vos champs d’entité, types de retour et paramètres sont tous fortement typés.
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",
});

Types de fonctions

Les noms de fonctions sont typés pour l’autocomplétion lors de l’invocation des fonctions :
// Autocomplete shows all available functions
const result = await base44.functions.invoke("calculateTotal", {
  items: ["item1", "item2"],
});
Les types des paramètres de fonction ne sont pas générés. Référez-vous à l’implémentation de votre fonction pour les paramètres attendus.

Types d’agents

Les noms d’agents sont typés pour l’autocomplétion lorsque vous travaillez avec des conversations :
// Autocomplete shows all available agents
const conversation = await base44.agents.createConversation("SupportBot");

Types de connecteurs

Les noms de types d’intégration de connecteurs sont typés pour l’autocomplétion lors de la récupération des connexions :
// Autocomplete shows all available connector integration types
const { accessToken } = await base44.asServiceRole.connectors.getConnection(
  "googlecalendar"
);
Le module connectors est uniquement disponible en mode service role (environnements backend).

Générer les types

Pour générer ou mettre à jour votre fichier de types, exécutez la commande types generate :
base44 types generate
Réexécutez types generate chaque fois que vous modifiez des entités, ajoutez des fonctions ou modifiez des agents pour garder les types à jour.

Voir aussi

  • types generate : Commande CLI pour générer des types à partir de votre projet
  • entities : Référence SDK pour travailler avec les entités
  • functions : Référence SDK pour invoquer des fonctions backend
  • agents : Référence SDK pour travailler avec les agents IA
  • connectors : Référence SDK pour gérer les jetons OAuth
Cette page a été traduite à l’aide de l’IA. Pour les informations les plus précises et à jour, consultez la version anglaise.