TypeScript SDK - Ela

@elanotes/sdk is packaging of the HTTP contract, not a new surface. Types come from openapi-typescript over contracts/openapi/elanotes.v1.json. The client is openapi-fetch. Not published to npm in v1. Workspace package: packages/sdk. Browser-safe: no Node-only modules.

pnpm --filter @elanotes/sdk build

Create a client

import { createElanotesClient, ElanotesError } from "@elanotes/sdk";

const client = createElanotesClient({
  baseUrl: "http://127.0.0.1:4000",
  token: process.env.ELA_API_TOKEN,
});

const { data } = await client.GET("/v1/search", {
  params: { query: { q: "Paddle" } },
});

baseUrl is the API origin (no /v1 suffix). Production uses the same client with baseUrl: "https://api.elanotes.com" and a bearer in token. Writes get an automatic Idempotency-Key (UUID) unless you set one. Failed responses throw ElanotesError with reason, hint, help, retryAfterSeconds, and details.

VERSION_MOVED

try {
  await client.POST("/v1/notes/{note}:edit", {
    params: { path: { note: "hello" } },
    body: {
      version_id: stale,
      old_string: "Hello",
      new_string: "Hello again",
      agent_id: "sdk",
    },
  });
} catch (err) {
  if (err instanceof ElanotesError && err.reason === "VERSION_MOVED") {
    console.error(err.hint);
  }
}

Regenerate after an OpenAPI change: node scripts/sdk-generate.mjs. Drift check: node scripts/assert-sdk-current.mjs (wired into pnpm verify). The Python SDK is generated from the same spec.