Errores, tiempos de espera y reintentos

invoke devuelve { data, error } y nunca arroja. error es un AuraError, por lo que isAuraError(error) es verdadero. Dos subclases te dicen quién falló:

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

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

if (error instanceof FunctionsHttpError) {
  // Tu función respondió, con un estado de error. Depura tu código.
} else if (error instanceof FunctionsRelayError) {
  // La plataforma falló: la respuesta de tu función nunca volvió.
} else if (error) {
  // La llamada fue cancelada o rechazada en el cliente (tiempo de espera, cuerpo_inválido, no_sesión).
}

Comportamientos observados frente a una pila en ejecución. La fila de cuota sigue la asignación de errores del backend y no se activó en nuestras pruebas.

El SDK nunca vuelve a intentar una invocación por usted: su función puede tener efectos secundarios y un POST repetido no es seguro de forma predeterminada. Tú decides, utilizando la siguiente tabla.

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 })
}

Tres relojes funcionan a la vez:

Cuando la función excede timeout_secs, el tiempo de ejecución la cancela y su llamada falla después de ese retraso, con el 500 o 503 que se muestra arriba. La causa aparece en error.context.detail (WorkerRequestCancelled: request has been cancelled by supervisor) en modo sin formato. Configure su cliente timeout ligeramente por encima del timeout_secs de la función para ver este error en lugar de un cliente timeout.

const { error } = await aura.functions.invoke('report', { timeout: 35_000 })
if (error?.code === 'timeout') {
  // Cancelado por su cliente. Es posible que la función aún esté ejecutándose.
}

Para trabajos de más de unos pocos segundos, ponga en cola un trabajo en lugar de mantener abierta una conexión.

• Los errores de plataforma llevan una identificación de solicitud: error.details.error.request_id. Cítelo cuando se comunique con el soporte.
• aura functions logs <name> enumera las solicitudes HTTP recientes con método, ruta, estado, duración e identificación de la solicitud. no muestra lo que su función escribió con console.log o console.error: esa salida permanece en los propios registros del tiempo de ejecución, que solo el operador de la plataforma puede leer. Consulte los límites de para conocer esta y otras brechas actuales.
• El identificador de la llamada no se reenvía a su función. Pase su propia identificación en headers y regístrela.