​

Base44 Coder

​

⚡ AÇÃO IMEDIATA NECESSÁRIA - Leia isto primeiro

1. Verifique se base44/config.jsonc existe no diretório atual
2. Se SIM (cenário de projeto existente):
   • Esta habilidade (base44-sdk) lida com a solicitação
   • Implemente recursos usando o SDK Base44
   • NÃO use base44-cli a menos que o usuário solicite explicitamente comandos CLI
3. Se NÃO (cenário de novo projeto):
   • Transfira para a habilidade base44-cli para inicialização do projeto
   • Esta habilidade não pode ajudar até que o projeto seja inicializado

​

Quando usar esta habilidade vs base44-cli

• Construindo recursos em um projeto Base44 EXISTENTE
• base44/config.jsonc já existe no projeto
• Importações do SDK Base44 estão presentes (@base44/sdk)
• Escrevendo código JavaScript/TypeScript usando módulos do SDK Base44
• Implementando funcionalidade, componentes ou recursos
• O usuário menciona: “implement”, “build a feature”, “add functionality”, “write code for”
• O usuário diz “create a [type] app” e um projeto Base44 já existe

• ❌ Inicializar novos projetos Base44 (use base44-cli em vez disso)
• ❌ Diretórios vazios sem configuração Base44
• ❌ Quando o usuário diz “create a new Base44 project/app/site” e nenhum projeto existe
• ❌ Comandos CLI como npx base44 create, npx base44 deploy, npx base44 login (use base44-cli)

• base44-sdk assume que um projeto Base44 já está inicializado
• base44-cli é um pré-requisito para base44-sdk em novos projetos
• Se o usuário quer “create an app” e nenhum projeto Base44 existe, use base44-cli primeiro

• SE (usuário menciona “create/build app” OU “make a project”):
  • SE (diretório está vazio OU nenhum base44/config.jsonc existe): → Use base44-cli (inicialização de projeto necessária)
  • SENÃO: → Use base44-sdk (projeto existe, construa recursos)

​

Início rápido

// 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");

​

⚠️ CRÍTICO: Não Alucine APIs

​

Autenticação - ERRADO vs CORRETO

​

Funções - ERRADO vs CORRETO

​

Integrações - ERRADO vs CORRETO

​

Entidades - ERRADO vs CORRETO

​

Módulos do SDK

​

TypeScript e registros de tipo

​

Instalação

npm install @base44/sdk

​

Criando um cliente (aplicativos externos)

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 de usuário pré-autenticado
• options (object) - Opções de configuração
  • options.onError (function) - Manipulador global de erros

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

​

Seleção de módulo

• Criar/ler/atualizar/excluir registros → entities
• Importar dados de arquivo → entities.importEntities()
• Atualizações em tempo real → entities.EntityName.subscribe()

• Login/registro/logout → auth
• Obter usuário atual → auth.me()
• Atualizar perfil de usuário → auth.updateMe()
• Convidar usuários → users.inviteUser()

• Conversar com agentes de IA → agents (requer usuário logado)
• Criar nova conversa → agents.createConversation()
• Gerenciar conversas → agents.getConversations()
• Gerar texto/JSON com IA → integrations.Core.InvokeLLM()
• Gerar imagens → integrations.Core.GenerateImage()

• Executar código do lado do servidor → functions.invoke()
• Necessário acesso de administrador → base44.asServiceRole.functions.invoke()

• Enviar e-mails → integrations.Core.SendEmail()
• Fazer upload de arquivos → integrations.Core.UploadFile()
• APIs personalizadas → integrations.custom.call()
• OAuth com escopo de aplicativo (conta do construtor do aplicativo) → asServiceRole.connectors.getConnection() (apenas backend)

• Rastrear eventos personalizados → analytics.track()
• Registrar visualizações de página/atividade → appLogs.logUserInApp()

​

Padrões comuns

​

Filtrar e ordenar dados

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

​

Rotas protegidas (verificar autenticação)

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

​

Chamada de função de 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 });
});

​

Acesso 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