​

Base44 Coder

​

⚡ ACTION IMMÉDIATE REQUISE - À lire en premier

1. Vérifier si base44/config.jsonc existe dans le répertoire courant
2. Si OUI (scénario projet existant) :
   • Cette compétence (base44-sdk) traite la requête
   • Implémentez les fonctionnalités avec le SDK Base44
   • N’utilisez PAS base44-cli sauf si l’utilisateur demande explicitement des commandes CLI
3. Si NON (scénario nouveau projet) :
   • Transférez à la compétence base44-cli pour l’initialisation du projet
   • Cette compétence ne peut pas aider tant que le projet n’est pas initialisé

​

Quand utiliser cette compétence par rapport à base44-cli

• Construire des fonctionnalités dans un projet Base44 EXISTANT
• base44/config.jsonc existe déjà dans le projet
• Des imports du SDK Base44 sont présents (@base44/sdk)
• Écrire du code JavaScript/TypeScript utilisant les modules du SDK Base44
• Implémenter des fonctionnalités, composants ou features
• L’utilisateur mentionne : « implémenter », « construire une fonctionnalité », « ajouter une fonctionnalité », « écrire du code pour »
• L’utilisateur dit « créer une application de [type] » et un projet Base44 existe déjà

• ❌ Initialiser de nouveaux projets Base44 (utilisez base44-cli à la place)
• ❌ Répertoires vides sans configuration Base44
• ❌ Quand l’utilisateur dit « créer un nouveau projet/application/site Base44 » et qu’aucun projet n’existe
• ❌ Commandes CLI comme npx base44 create, npx base44 deploy, npx base44 login (utilisez base44-cli)

• base44-sdk suppose qu’un projet Base44 est déjà initialisé
• base44-cli est un prérequis de base44-sdk pour les nouveaux projets
• Si l’utilisateur veut « créer une application » et qu’aucun projet Base44 n’existe, utilisez d’abord base44-cli

• SI (l’utilisateur mentionne « créer/construire une application » OU « faire un projet ») :
  • SI (le répertoire est vide OU aucun base44/config.jsonc n’existe) : → Utilisez base44-cli (initialisation de projet nécessaire)
  • SINON : → Utilisez base44-sdk (le projet existe, construisez des fonctionnalités)

​

Démarrage rapide

// In Base44-generated apps, base44 client is pre-configured and available

// CRUD operations
const task = await base44.entities.Task.create({ title: "New task", status: "pending" });
const tasks = await base44.entities.Task.list();
await base44.entities.Task.update(task.id, { status: "done" });

// Get current user
const user = await base44.auth.me();

// External apps
import { createClient } from "@base44/sdk";

// IMPORTANT: Use 'appId' (NOT 'clientId' or 'id')
const base44 = createClient({ appId: "your-app-id" });
await base44.auth.loginViaEmailPassword("user@example.com", "password");

​

⚠️ CRITIQUE : ne pas halluciner d’API

​

Authentification — MAUVAIS vs CORRECT

​

Functions — MAUVAIS vs CORRECT

​

Integrations — MAUVAIS vs CORRECT

​

Entities — MAUVAIS vs CORRECT

​

Modules du SDK

​

TypeScript et registres de types

​

Installation

npm install @base44/sdk

​

Créer un client (applications externes)

import { createClient } from "@base44/sdk";

// ✅ CORRECT
const base44 = createClient({ appId: "your-app-id" });

// ❌ WRONG - Do NOT use these:
// const base44 = createClient({ clientId: "your-app-id" });  // WRONG
// const base44 = createClient({ id: "your-app-id" });        // WRONG

• token (string) — token utilisateur préauthentifié
• options (object) — options de configuration
  • options.onError (function) — gestionnaire d’erreurs global

const base44 = createClient({
  appId: "your-app-id",
  options: {
    onError: (error) => {
      console.error("Base44 error:", error);
    }
  }
});

​

Sélection de module

• Créer/lire/mettre à jour/supprimer des enregistrements → entities
• Importer des données depuis un fichier → entities.importEntities()
• Mises à jour en temps réel → entities.EntityName.subscribe()

• Connexion/inscription/déconnexion → auth
• Obtenir l’utilisateur courant → auth.me()
• Mettre à jour le profil utilisateur → auth.updateMe()
• Inviter des utilisateurs → users.inviteUser()

• Discuter avec des agents IA → agents (nécessite un utilisateur connecté)
• Créer une nouvelle conversation → agents.createConversation()
• Gérer les conversations → agents.getConversations()
• Générer du texte/JSON avec l’IA → integrations.Core.InvokeLLM()
• Générer des images → integrations.Core.GenerateImage()

• Exécuter du code côté serveur → functions.invoke()
• Besoin d’accès administrateur → base44.asServiceRole.functions.invoke()

• Envoyer des e-mails → integrations.Core.SendEmail()
• Envoyer des fichiers → integrations.Core.UploadFile()
• API personnalisées → integrations.custom.call()
• OAuth à l’échelle de l’application (compte du builder) → asServiceRole.connectors.getConnection() (backend uniquement)

• Suivre des événements personnalisés → analytics.track()
• Enregistrer les vues de pages/l’activité → appLogs.logUserInApp()

​

Motifs courants

​

Filtrer et trier les données

const pendingTasks = await base44.entities.Task.filter(
  { status: "pending", assignedTo: userId },  // query
  "-created_date",                             // sort (descending)
  10,                                          // limit
  0                                            // skip
);

​

Routes protégées (vérifier l’authentification)

const user = await base44.auth.me();
if (!user) {
  // Navigate to your custom login page
  navigate('/login', { state: { returnTo: window.location.pathname } });
  return;
}

​

Appel de fonction backend

// Frontend
// ⚠️ invoke() returns the RAW axios response — your function's JSON is on `.data`,
//    NOT the top-level object. It also THROWS on non-2xx (error body at err.response.data).
const res = await base44.functions.invoke("processOrder", {
  orderId: "123",
  action: "ship"
});
const result = res.data; // ✅ e.g. res.data.success  (res itself is { data, status, headers, … })

// Backend function (Deno)
import { createClientFromRequest } from "npm:@base44/sdk";

Deno.serve(async (req) => {
  const base44 = createClientFromRequest(req);
  const { orderId, action } = await req.json();
  // Process with service role for admin access
  const order = await base44.asServiceRole.entities.Orders.get(orderId);
  return Response.json({ success: true });
});

​

Accès Service Role

// User mode - respects permissions
const myTasks = await base44.entities.Task.list();

// Service role - full access (backend only)
const allTasks = await base44.asServiceRole.entities.Task.list();
const token = await base44.asServiceRole.connectors.getAccessToken("slack");

​

Frontend vs Backend