Server-to-server integration

# 1. Verify the template exists and read its manifest.
curl https://api.craftkit.dev/v1/templates/charter-handover \
  -H "Authorization: Bearer $CRAFTKIT_API_KEY"

# 2. Render (idempotent on the booking + handover identity).
curl -X POST https://api.craftkit.dev/v1/templates/charter-handover/render \
  -H "Authorization: Bearer $CRAFTKIT_API_KEY" \
  -H "Idempotency-Key: handover-BK-12345-checkout" \
  -H "Content-Type: application/json" \
  -d '{
    "data": {
      "booking": { "code": "BK-12345", "activityName": "Sunset Charter" },
      "handover": { "kind": "checkout", "date": "2026-06-04", "signedBy": "Jane Doe" },
      "areas": [
        { "areaKey": "hull", "condition": "damage", "severity": "cosmetic", "location": "port bow" },
        { "areaKey": "engine", "condition": "ok" }
      ]
    },
    "options": { "filename": "charter-handover-BK-12345.pdf" }
  }'
# → 202 { "id": "…", "status": "queued", "pollUrl": "…/v1/renders/…", "downloadUrl": null }

const BASE = 'https://api.craftkit.dev';
const headers = {
  Authorization: `Bearer ${process.env.CRAFTKIT_API_KEY}`,
  'Content-Type': 'application/json',
};

// 1. Enqueue (idempotent — retrying the same key returns the same render).
const enqueue = await fetch(`${BASE}/v1/templates/charter-handover/render`, {
  method: 'POST',
  headers: { ...headers, 'Idempotency-Key': 'handover-BK-12345-checkout' },
  body: JSON.stringify({
    data: {
      booking: { code: 'BK-12345', activityName: 'Sunset Charter' },
      handover: { kind: 'checkout', date: '2026-06-04', signedBy: 'Jane Doe' },
      areas: [
        { areaKey: 'hull', condition: 'damage', severity: 'cosmetic', location: 'port bow' },
        { areaKey: 'engine', condition: 'ok' },
      ],
    },
    options: { filename: 'charter-handover-BK-12345.pdf' },
  }),
});
const { id } = await enqueue.json();

// 2. Poll to a terminal state.
async function waitForRender(renderId: string, timeoutMs = 30_000) {
  const deadline = Date.now() + timeoutMs;
  let delay = 250;
  while (Date.now() < deadline) {
    const r = await fetch(`${BASE}/v1/renders/${renderId}`, { headers });
    const render = await r.json();
    if (render.status === 'succeeded') return render.downloadUrl as string;
    if (render.status === 'failed') throw new Error(render.errorMessage ?? 'render failed');
    await new Promise((res) => setTimeout(res, delay));
    delay = Math.min(delay * 2, 5_000);
  }
  throw new Error('render timed out');
}

const downloadUrl = await waitForRender(id);