Errors

class ReforgioError extends Error {
  readonly statusCode: number  // HTTP status of the failed response
  // .message is the server's exact message from the tables below
}

import { ReforgioError } from '@reforgio/sdk-core'
// (also exported from '@reforgio/sdk-core/server' and re-thrown by all @reforgio/sdk-react hooks)
 
try {
  const doc = await client.render(templateId, data)
  window.open(doc.downloadUrl)
} catch (err) {
  if (!(err instanceof ReforgioError)) throw err // network failures, bugs — let them surface
 
  switch (err.statusCode) {
    case 400:
      // bad input for this template — show err.message, it's specific
      break
    case 401:
      // credentials problem — see the 401 table for the exact cause
      break
    case 404:
      // wrong ID or another organization's resource
      break
    case 429:
      // rate limited (100 req/min per key) — back off and retry
      break
    default:
      // 5xx — retry with backoff or surface a generic failure
      break
  }
}