Errors

The SDK exports:

class OpenCloudError extends Error
class OpenCloudAuthError extends OpenCloudError

OpenCloudAuthError means an authenticated operation had no current brokered session. Render a sign-in or retry state.

OpenCloudError covers invalid runtime configuration, cross-origin or invalid paths, malformed platform responses, and Realtime state failures.

HTTP failures are returned as normal Response objects:

const response = await opencloud.rest.request("items?select=*");
if (!response.ok) {
  const message = await response.text();
  throw new Error(`Items request failed: ${response.status} ${message}`);
}

Do not display raw deployment, database, or internal platform errors directly to end users.