Errors

import { NotFoundError, RateLimitError } from '@airstore/sdk'

try {
  await airstore.workspaces.retrieve('ws_nonexistent')
} catch (err) {
  if (err instanceof NotFoundError) {
    console.log('Workspace not found')
  }
}

try {
  await airstore.workspaces.retrieve('ws_bad')
} catch (err) {
  if (err instanceof APIError) {
    console.log(err.status)    // 404
    console.log(err.message)   // "workspace not found"
    console.log(err.requestId) // "req_abc123" (if available)
    console.log(err.headers)   // Response Headers object
  }
}

// Client-level
const airstore = new Airstore({ maxRetries: 5 })

// Per-request
await airstore.workspaces.list({ maxRetries: 0 }) // no retries

import {
  AuthenticationError,
  NotFoundError,
  RateLimitError,
  APIConnectionError,
} from '@airstore/sdk'

try {
  const ws = await airstore.workspaces.retrieve('ws_abc123')
} catch (err) {
  if (err instanceof AuthenticationError) {
    // Bad API key -- check AIRSTORE_API_KEY
  } else if (err instanceof NotFoundError) {
    // Workspace doesn't exist
  } else if (err instanceof RateLimitError) {
    // Shouldn't normally hit this (auto-retried), but possible if retries exhausted
  } else if (err instanceof APIConnectionError) {
    // Network issue -- DNS, firewall, etc.
  } else {
    throw err // unexpected
  }
}

const controller = new AbortController()

// Cancel after 5 seconds
setTimeout(() => controller.abort(), 5_000)

try {
  await airstore.fs.read('ws_abc123', { path: '/large-file' }, {
    signal: controller.signal,
  })
} catch (err) {
  if (err instanceof AirstoreError && err.message === 'Request was cancelled') {
    console.log('Cancelled')
  }
}