Erros, tempos limite e novas tentativas

invoke retorna { data, error } e nunca lança. error é um AuraError, então isAuraError(error) é verdadeiro. Duas subclasses informam quem falhou:

import { FunctionsHttpError, FunctionsRelayError } from '@aurabase/aurabase-js'

const { data, error } = await aura.functions.invoke('checkout', { body })

if (error instanceof FunctionsHttpError) {
  // Sua função respondeu, com status de erro. Depure seu código.
} else if (error instanceof FunctionsRelayError) {
  // A plataforma falhou: a resposta da sua função nunca mais voltou.
} else if (error) {
  // A chamada foi cancelada ou recusada no cliente (timeout, invalid_body, no_session).
}

Comportamentos observados em uma pilha em execução. A linha de cota segue o mapeamento de erros do backend e não foi acionada em nossos testes.

O SDK nunca tenta novamente uma invocação para você: sua função pode ter efeitos colaterais e um POST repetido não é seguro por padrão. Você decide, usando a tabela abaixo.

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

async function invokeWithRetry(name: string, body: unknown, attempts = 3) {
  for (let i = 0; i < attempts; i++) {
    const res = await aura.functions.invoke(name, { body })
    const safe = res.error instanceof FunctionsRelayError && res.error.status === 503
    if (!res.error || !safe) return res
    await new Promise((r) => setTimeout(r, 2 ** i * 500))
  }
  return aura.functions.invoke(name, { body })
}

Três relógios funcionam ao mesmo tempo:

Quando a função excede timeout_secs, o tempo de execução a cancela e sua chamada falha após esse atraso, com 500 ou 503 mostrado acima. A causa aparece em error.context.detail (WorkerRequestCancelled: request has been cancelled by supervisor) no modo bruto. Defina seu cliente timeout um pouco acima do timeout_secs da função para ver esse erro em vez de um cliente timeout.

const { error } = await aura.functions.invoke('report', { timeout: 35_000 })
if (error?.code === 'timeout') {
  // Cancelado pelo seu cliente. A função ainda pode estar em execução.
}

Para trabalhos que duram mais de alguns segundos, enfileira uma tarefa em vez de manter uma conexão aberta.

• Erros de plataforma carregam um ID de solicitação: error.details.error.request_id. Cite-o quando entrar em contato com o suporte.
• aura functions logs <name> lista solicitações HTTP recentes com método, caminho, status, duração e ID da solicitação. não mostra o que sua função escreveu com console.log ou console.error: essa saída permanece nos próprios logs do tempo de execução, que somente o operador da plataforma pode ler. Consulte limites para esta e outras lacunas atuais.
• O identificador da chamada não é encaminhado para sua função. Passe seu próprio id em headers e registre-o.