const tasks = await base44.entities.Task.list();

npm install @base44/sdk

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

// IMPORTANTE: El nombre del parámetro es 'appId' (NO 'clientId', NO 'id')
// IMPORTANTE: onError debe estar anidado dentro del objeto 'options'
const base44 = createClient({
  appId: "your-app-id",          // Requerido: Usa el parámetro 'appId'
  token: "optional-user-token",  // Opcional: para solicitudes preautenticadas
  options: {                      // Opcional: opciones de configuración
    onError: (error) => {         // Opcional: manejador de errores (debe estar en options)
      console.error("Base44 error:", error);
    }
  }
});

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

Deno.serve(async (req) => {
  const base44 = createClientFromRequest(req);
  
  // El cliente hereda la autenticación de la solicitud
  const user = await base44.auth.me();
  
  return Response.json({ user });
});

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

// Solo funciona si la entidad Task permite lectura anónima
const publicTasks = await base44.entities.Task.list();

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

// El inicio de sesión establece el token
await base44.auth.loginViaEmailPassword("user@example.com", "password");

// Las solicitudes posteriores están autenticadas
const user = await base44.auth.me();
const myTasks = await base44.entities.Task.list();  // filtrado por permisos

// Dentro de una función de backend
Deno.serve(async (req) => {
  const base44 = createClientFromRequest(req);
  
  // Modo usuario - respeta permisos
  const myTasks = await base44.entities.Task.list();
  
  // Rol de servicio - evita permisos
  const allTasks = await base44.asServiceRole.entities.Task.list();
  const allUsers = await base44.asServiceRole.entities.User.list();
  const oauthToken = await base44.asServiceRole.connectors.getAccessToken("slack");
  
  return Response.json({ myTasks, allTasks });
});

base44.agents        // Conversaciones de IA
base44.analytics     // Rastreo de eventos
base44.appLogs       // Registro de uso de app
base44.auth          // Autenticación
base44.connectors    // Flujos OAuth por usuario (UserConnectorsModule)
base44.entities      // Operaciones CRUD
base44.functions     // Invocación de funciones de backend
base44.integrations  // Servicios de terceros
base44.users         // Invitaciones de usuario

// Solo rol de servicio (backend)
base44.asServiceRole.agents
base44.asServiceRole.appLogs
base44.asServiceRole.connectors  // Tokens OAuth con ámbito de app (ConnectorsModule)
base44.asServiceRole.entities
base44.asServiceRole.functions
base44.asServiceRole.integrations
base44.asServiceRole.sso         // Generación de tokens SSO

// Establecer el token de autenticación para todas las solicitudes posteriores
base44.setToken(newToken);

// Limpiar conexiones WebSocket (llama cuando termines con el cliente)
base44.cleanup();

// Después de recibir un token (por ejemplo, de autenticación externa)
base44.setToken("new-jwt-token");

// Limpieza al desmontar componente (ejemplo React)
useEffect(() => {
  return () => base44.cleanup();
}, []);

createClient({
  appId: "your-app-id",      // Requerido: DEBE usar 'appId' (no 'clientId' o 'id')
  token: "jwt-token",        // Opcional: token de autenticación preestablecido
  options: {                 // Opcional: opciones de configuración
    onError: (error) => {}   // Opcional: manejador de errores global (debe estar en options)
  }
});

/** Configuración para crear un cliente de Base44. */
interface CreateClientConfig {
  /** El ID de app de Base44 (requerido). */
  appId: string;
  /** Token de autenticación de usuario. Se usa para autenticar como un usuario específico. */
  token?: string;
  /** @internal Token de rol de servicio; solo se establece automáticamente en funciones de backend alojadas en Base44. */
  serviceToken?: string;
  /** Opciones adicionales del cliente. */
  options?: CreateClientOptions;
}

/** Opciones para crear un cliente de Base44. */
interface CreateClientOptions {
  /** Manejador de errores opcional llamado cuando ocurre un error de API. */
  onError?: (error: Error) => void;
}

/** La instancia del cliente de Base44. */
interface Base44Client {
  /** Módulo Agents para gestionar conversaciones de agente de IA. */
  agents: AgentsModule;
  /** Módulo Analytics para rastrear eventos personalizados. */
  analytics: AnalyticsModule;
  /** Módulo App logs para rastrear el uso de la app. */
  appLogs: AppLogsModule;
  /** Módulo Auth para autenticación y gestión de usuarios. */
  auth: AuthModule;
  /** Módulo Entities para operaciones CRUD en tus modelos de datos. */
  entities: EntitiesModule;
  /** Módulo Functions para invocar funciones de backend personalizadas. */
  functions: FunctionsModule;
  /** Módulo Integrations para llamar a métodos de integración prediseñados. */
  integrations: IntegrationsModule;

  /** Función de limpieza para desconectar conexiones WebSocket. */
  cleanup(): void;

  /** Establece un nuevo token de autenticación para todas las solicitudes posteriores. */
  setToken(newToken: string): void;

  /** Flujos OAuth por usuario. Cada usuario final tiene su propia conexión. */
  connectors: UserConnectorsModule;

  /** Proporciona acceso a módulos con permisos elevados de rol de servicio (solo backend). */
  readonly asServiceRole: {
    agents: AgentsModule;
    appLogs: AppLogsModule;
    /** Tokens OAuth con ámbito de app. Todos los usuarios comparten la misma cuenta conectada. */
    connectors: ConnectorsModule;
    entities: EntitiesModule;
    functions: FunctionsModule;
    integrations: IntegrationsModule;
    /** Generación de token SSO para usuarios. */
    sso: SsoModule;
    cleanup(): void;
  };
}