@majulii/aurora-sdk

TypeScript client for the Aurora SDK backend (hosted Cloudflare Worker). Use it from server-side only so your organization API key and LLM API key stay secret.

• HTTP: axios with axios-retry — exponential backoff on network errors, timeouts, 429, and 5xx (up to maxRetries, default 4).
• Timeouts: default 120s per request (LLM-heavy generate); shorter overrides for usage (30s) and health (15s).
• Worker URL is fixed (AURORA_SDK_DEFAULT_BASE_URL); pass apiKey and optional maxRetries / timeoutMs.
• generate() supports optional attachments (images: base64 + MIME or https URL; files: name + text) and memoryTokenBudget for long threads (see types).

Requires Node 18+.

Install

npm install @majulii/aurora-sdk

Usage

import { createAuroraClient } from "@majulii/aurora-sdk";

const sdk = createAuroraClient({
  apiKey: process.env.AURORA_SDK_API_KEY!,
  // optional tuning:
  // maxRetries: 6,
  // timeoutMs: 180_000,
});

const out = await sdk.generate({
  message: "Build a paginated table for my list API",
  threadId: sessionId,
  llm: {
    provider: "openai",
    apiKey: process.env.OPENAI_API_KEY!,
    model: "gpt-4o-mini",
  },
  context: {
    appData: { rows: [], page: 1 },
    hints: "Use GET /api/items?page=",
  },
});

// out.document — GenUIDocument for @majulii/aurora-ui

API

| Method | Description | |--------|-------------| | generate(req) | POST /v1/generate | | usage() | GET /v1/usage | | health() | GET /health |

Failures throw AuroraSdkError (status, body). Network errors after retries use status === 0.

Tests

Pass a custom axiosInstance (with your own adapter/mocks) via createAuroraClient({ apiKey: "x", axiosInstance }); maxRetries / timeoutMs are ignored in that case.

Develop & publish

npm install
npm run build
npm publish --access public

Update repository / homepage in package.json if your Git remote differs from github.com/majulii/aurora-sdk.

Related

• Backend (Worker, D1, R2) is a separate private repo — not on npm. Consumers only install this package.