Cliente e servizi
Il punto di ingresso dell'SDK: come creare il client e quali servizi espone.
6 min letto·Livello riferimento·Revisionato il 12 ott 2026
Questo testo inglese è stato generato automaticamente dall'originale francese e non è stato ancora rivisto.
Questa pagina è stata tradotta automaticamente. Fa fede la versione inglese.
#
Funzioni
Funzioni esportate
| Funzione | Descrizione |
|---|---|
function createClient<Database = any>(baseUrl: string, apiKey: string, options?: AuraClientOptions): AuraClient<Database> | Crea una nuova istanza client Aurabase. |
function createAdminClient<Database = any>(baseUrl: string, serviceRoleKey: string, options?: AuraClientOptions): AuraClient<Database> | Crea un client per SERVER utilizza solo per le operazioni di amministrazione (client.authAdmin: elenca/crea/esclude utenti, leggi controllo). |
#
Classe
AuraClient
Client principale Aurabase.
| Proprietà | Descrizione |
|---|---|
readonly baseUrl: string | URL del progetto (https://<slug>.aurabase.cloud), senza barra finale. |
readonly apiKey: string | null | Chiave API del progetto (anon o service_role) inviata nell'intestazione apikey; null se non ne è stato fornito nessuno. |
readonly fetchFn: typeof globalThis.fetch | Funzione fetch utilizzata per tutte le query (quella di options.fetch, altrimenti globalThis.fetch). |
readonly authStore: BaseAuthStore | Archivio di sessione (token di accesso, token di aggiornamento, utente): memoria, localStorage o cookie a seconda del contesto. |
readonly retryConfig: { enabled: boolean; maxRetries: number; } | Leggi i criteri di ripresa delle richieste (GET, HEAD) in caso di errore temporaneo: abilitato o meno e numero massimo di riprese. |
readonly requestTimeoutMs?: number | Timeout predefinito (ms) per le richieste JSON senza segnale. undefined → guasto nucleo (30 s). |
readonly onEvent?: (event: AuraObservabilityEvent) => void | Hook di osservabilità: vedere AuraClientOptions.onEvent. |
readonly debug?: boolean | Scrivi nel journal chaque AuraObservabilityEvent via console.debug — voir AuraClientOptions.debug. |
get auth(): AuthService | Servizio di autenticazione: registrazione, connessione, sessione, MFA, OAuth, identità. |
get authAdmin(): AuthAdminService | API di amministrazione dell'autenticazione (utenti, sessioni, registro di controllo, modelli di posta elettronica). |
get db(): DatabaseService<Database, Schema> | Servizio database: query su tabelle e viste, chiamate di funzioni SQL (rpc), SQL grezzo. |
get storage(): StorageService | Servizio di storage: bucket, invio, download, URL firmati e pubblici, trasformazioni di immagini. |
get realtime(): RealtimeService | Servizio in tempo reale: canali, modifiche Postgres, trasmissione (broadcast) e presenza. |
get functions(): FunctionsService | Servizio Edge Functions: invocazione e gestione di job e cron con una chiave service_role. |
get ai(): AiService | Servizio AI: conversazione (chat), incorporamenti, RAG (acquisizione, query, spazi dei nomi), ricerca semantica e sessioni. |
get notifications(): NotificationsService | Servizio notifiche: invio (email, SMS, push, webhook), cronologia, modelli e amministrazione. |
| Metodo | Descrizione |
|---|---|
dispose(): void | Smonta il client: interrompe l'aggiornamento proattivo (ticker + visibilità + BroadcastChannel), disconnette il tempo reale, svuota gli ascoltatori di autenticazione. |
from<TableName extends string & keyof Schema['Tables'], Table extends Schema['Tables'][TableName]>(table: TableName): AuraQueryBuilder<Schema, Table, TableName, AuraClientOptionsT>from<ViewName extends string & keyof Schema['Views'], View extends Schema['Views'][ViewName]>(view: ViewName): AuraQueryBuilder<Schema, View, ViewName, AuraClientOptionsT>from(table: string): AuraQueryBuilder<any, any, any, AuraClientOptionsT> | Scorciatoia: interroga una tabella o una vista del database (Supabase-API compatibile). |
rpc<FnName extends string = string, Args extends Record<string, unknown> = Record<string, unknown>>(fn: FnName, args?: Args, options?: Parameters<DatabaseService<Database, Schema>['rpc']>[2]): ReturnType<DatabaseService<Database, Schema>['rpc']> | Scorciatoia: richiama una procedura memorizzata/funzione PostgreSQL tramite RPC (API compatibile Supabase). |
channel(name: string, options?: ChannelConfig): AuraChannel | Scorciatoia: crea un canale in tempo reale con l'API compatibile con Supabase. |
removeChannel(channel: string | AuraChannel): void | Scorciatoia: rimuovi un canale in tempo reale per nome o istanza AuraChannel. |
removeAllChannels(): void | Scorciatoia: rimuovi tutti i canali in tempo reale e annulla l'iscrizione. |
getChannels(): AuraChannel[] | Scorciatoia: elenca tutti i canali in tempo reale attivi. |
Pagina generata
Questa pagina viene generata dalle dichiarazioni di tipo e dai commenti dell'SDK, quindi non può derivare dal codice pubblicato. Per esempi pratici, leggi le guide.
Ultimo aggiornamento · 12 ott 2026