Errors, timeouts and retries

invoke returns { data, error } and never throws. error is an AuraError, so isAuraError(error) is true. Two subclasses tell you who failed:

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

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

if (error instanceof FunctionsHttpError) {
  // Your function answered, with an error status. Debug your code.
} else if (error instanceof FunctionsRelayError) {
  // The platform failed: the answer of your function never came back.
} else if (error) {
  // The call was cancelled or refused on the client (timeout, invalid_body, no_session).
}

Behaviours observed against a running stack. The quota row follows the backend's error mapping and was not triggered in our tests.

The SDK never retries an invocation for you: your function may have side effects, and a repeated POST is not safe by default. You decide, using the table below.

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

Three clocks run at once:

When the function exceeds timeout_secs, the runtime cancels it and your call fails after about that delay, with the 500 or 503 shown above. The cause appears in error.context.detail (WorkerRequestCancelled: request has been cancelled by supervisor) in raw mode. Set your client timeout slightly above the function's timeout_secs to see this error instead of a client timeout.

const { error } = await aura.functions.invoke('report', { timeout: 35_000 })
if (error?.code === 'timeout') {
  // Cancelled by your client. The function may still be running.
}

For work longer than a few seconds, enqueue a job instead of holding a connection open.

• Platform errors carry a request id: error.details.error.request_id. Quote it when you contact support.
• aura functions logs <name> lists recent HTTP requests with method, path, status, duration and request id. It does not show what your function wrote with console.log or console.error: that output stays in the runtime's own logs, which only the platform operator can read. See limits for this and the other current gaps.
• The identifier of the call is not forwarded to your function. Pass your own id in headers and log it.