Errors and retries

SpineError
├── SpineConnectionError        # network / transport failures
├── SpineTimeoutError           # HTTP timeout or polling timeout
├── SpineRunFailedError         # waitForCompletion: status=failed
└── SpineAPIError               # 4xx / 5xx HTTP responses
    ├── SpineBadRequestError    # 400
    ├── SpineAuthError          # 401
    ├── SpineNotFoundError      # 404
    └── SpineServerError        # 5xx (after retry budget exhausted)

import { Spine, SpineBadRequestError } from 'spine-sdk';

try {
  const client = new Spine({ apiKey: process.env.SPINE_API_KEY! });
  await client.runs.create({ prompt: 'x', template: 'bogus' as 'memo' });
} catch (err) {
  if (err instanceof SpineBadRequestError) {
    console.log(err.statusCode);     // 400
    console.log(err.message);        // "Invalid template: bogus. Valid templates: ..."
    console.log(err.requestId);      // value of X-Request-ID header (if present)
    console.log(err.responseBody);   // parsed JSON body
  }
}

await client.runs.create({ prompt: 'hi', blocks: [] });     // SpineBadRequestError
await client.runs.retrieve('not-a-uuid');                    // SpineBadRequestError

const client = new Spine({
  apiKey: process.env.SPINE_API_KEY!,
  maxRetries: 5,    // default: 2, set to 0 to disable retries entirely
});

const client = new Spine({
  apiKey: process.env.SPINE_API_KEY!,
  timeoutMs: 120_000,
});

await client.runs.waitForCompletion(runId, { timeoutMs: 30 * 60_000 });

const terminal = await client.runs.waitForCompletion(runId, { resolveOnFailure: true });
if (terminal.status === 'failed') {
  console.error(terminal.errors);
}