Richiamare una funzione

invoke è l'unica chiamata che una chiave pubblica può effettuare. Funziona allo stesso modo in un browser e su un server.

import { createClient } from '@aurabase/aurabase-js'

const aura = createClient(process.env.AURA_URL!, process.env.AURA_ANON_KEY!)

const { data, error } = await aura.functions.invoke<{ greeting: string }>('hello', {
  body: { name: 'Ada' },
})
if (error) throw error
console.log(data?.greeting)

// Dopo l'accesso, l'SDK aggiunge JWT dell'utente a ogni chiamata: nessun codice aggiuntivo.
await aura.auth.signInWithPassword({ email, password })
const { data } = await aura.functions.invoke('whoami')
// La funzione vede x-aura-role: authenticated e l'id dell'utente.

Il generico invoke<T> digita solo la risposta. Il nome e il corpo non vengono controllati in fase di compilazione.

La tua funzione riceve esattamente la richiesta che descrivi, non un wrapper attorno ad essa.

await aura.functions.invoke('items', {
  method: 'PUT',
  path: '/items/1',
  headers: { 'x-source': 'dashboard' },
  body: { qty: 2 },
})

Deno.serve(async (req) => {
  const url = new URL(req.url)          // nome percorso: '/elementi/1'
  const source = req.headers.get('x-source') // 'cruscotto'
  const body = await req.json()         // {quantità: 2}
  return Response.json({ method: req.method, id: url.pathname.split('/').pop(), source, body })
})

Regole che vale la pena conoscere:

• GET e HEAD vengono inviati senza corpo.
• Un corpo che non è una stringa viene inviato come JSON, con content-type: application/json a meno che non ne imposti uno. Un corpo stringa viene inviato così com'è e riceve anche content-type: application/json, quindi leggilo con req.text().
• Senza body, la funzione riceve una richiesta senza corpo. Un semplice await req.json() genera, quindi scrivi await req.json().catch(() => ({})) quando la chiamata può essere effettuata senza payload.
• Il corpo deve essere JSON: un oggetto, un array, una stringa, un numero o un valore booleano. Un Blob, ArrayBuffer, array tipizzato, FormData, URLSearchParams o ReadableStream viene rifiutato con il codice di errore invalid_body prima che venga inviata qualsiasi richiesta.
• Le intestazioni di frame (content-length, transfer-encoding, connection, host, …) vengono ignorate.

La piattaforma convalida la chiave e il token dell'utente prima dell'esecuzione della funzione, quindi aggiunge queste intestazioni:

Deno.serve((req) => {
  if (req.headers.get('x-aura-role') !== 'authenticated') {
    return new Response('Sign in first', { status: 401 })
  }
  return Response.json({ userId: req.headers.get('x-aura-user-id') })
})

Risultati reali di questa chiamata con tre chiavi diverse:

{ "role": "anon",          "userId": null }
{ "role": "authenticated", "userId": "b125f8cd-ddc8-4042-9d9d-2e0aa3cebe51" }
{ "role": "service_role",  "userId": null }

Senza l'SDK, invia un oggetto JSON che descriva la richiesta. Il campo body è ciò che riceve la tua funzione.

curl -X POST "$AURA_URL/v1/functions/hello/invoke" \
  -H "apikey: $AURA_ANON_KEY" \
  -H "Content-Type: application/json" \
  -d '{"body":{"name":"Ada"}}'

Sono richiesti sia apikey che Content-Type: application/json. Aggiungi Authorization: Bearer <user JWT> per chiamare come utente registrato. La risposta predefinita è una busta; l'intestazione X-Aurabase-Invoke-Mode: raw restituisce invece la risposta della funzione, vedere risposte non JSON.

invoke non lancia mai. Restituisce { data, error }:

const { data, error } = await aura.functions.invoke('hello', { body: { name: 'Ada' } })

if (error) {
  // error.status: stato HTTP dell'errore
  // error.message: il testo restituito dalla funzione o la spiegazione della piattaforma
  return
}
// i dati sono nulli quando la funzione non ha restituito alcun contenuto (ad esempio un 204)
if (data === null) return
console.log(data)

Prova data anziché error quando ti serve il valore: TypeScript quindi saprai che non è null. Per gestire gli errori in modo preciso, leggere errori, timeout e nuovi tentativi.