import { GameNarrativeClient } from '@kitefrost/game-narrative';

const client = new GameNarrativeClient({ apiKey: 'sk_your_key_here' });

// every per-pack client exposes the shared core at .core
const health = await client.core.health.check();
console.log(health);  // { status: "ok", version: "..." }

await client.core.health.check();  // liveness probe - no auth required

await client.core.auth.whoami();  // introspect the current API key

await client.core.projects.list();
await client.core.projects.get(projectId);
await client.core.projects.create({ name: 'my-project' });

await client.core.keys.list();
await client.core.keys.create({ scopes: ['read', 'write'] });
await client.core.keys.revoke(keyId);

await client.core.billing.usage();

// Send a client/telemetry event
await client.core.events.send({ eventType: '...', payload: { ... } });

await client.core.context.get(projectId);

await client.core.byok.list('your-project-id');
await client.core.byok.set('your-project-id', { provider: '...', apiKey: '...' });

await client.core.webhooks.list();
await client.core.webhooks.create({ url: 'https://your-server.com/hook', events: [...] });
await client.core.webhooks.delete(webhookId);

KiteFrostApiError
├── KiteFrostAuthError      (401/403) - missing, invalid, or under-permissioned API key
├── KiteFrostNotFoundError  (404)     - project/entity/resource not found
├── ValidationError         (422)     - malformed request payload
├── RateLimited             (429)     - too many requests; check .retryAfter
└── ServerError             (5xx)     - unexpected server error

import { RateLimited, ValidationError, KiteFrostApiError } from '@kitefrost/core';

try {
  await client.core.projects.create({ name: 'my-project' });
} catch (error) {
  if (error instanceof RateLimited) {
    console.log(`Rate limited. Retry after ${error.retryAfter}s`);
  } else if (error instanceof ValidationError) {
    console.log(`Bad request: ${error.message}`);
  } else if (error instanceof KiteFrostApiError) {
    console.log(`API error ${error.statusCode}: ${error.message}`);
    if (error.feedbackId) {
      console.log(`Feedback reference: ${error.feedbackId}`);
    }
  }
}