Hey API and Voxgig, compared

What each SDK does

What the code is

The same calls in each, in TypeScript. Both samples type-check under strict mode against the SDK they name.

import { createNeonClient } from '@neon/sdk'

const neon = createNeonClient({ apiKey: process.env.NEON_API_KEY!, throwOnError: true })

const projects = await neon.projects.list().all()
const project = await neon.projects.get({ projectId: 'late-frost-12345' })
const created = await neon.projects.create({ name: 'app' })
await neon.projects.delete({ projectId: 'late-frost-12345' })

import { NeonSDK } from '@voxgig-sdk/neon-sdk'

const client = new NeonSDK({ apikey: process.env.NEON_APIKEY })

const projects = await client.Project().list()
const project = await client.Project().load({ id: 'late-frost-12345' })
// ProjectCreateData is the response schema, so without the cast TypeScript
// asks for id, created_at and the other fields the server assigns. The SDK
// wraps the input in the { project } body Neon's create expects.
const created = await client.Project().create({ name: 'app' } as any)
await client.Project().remove({ id: 'late-frost-12345' })

What building and running both found

• Neon's retries, timeouts, pagination and typed errors are in a hand-written wrapper over the Hey API client. What Hey API generated is the typed functions underneath, which the package also exports as raw.
• apidef read Neon's project list at body until 8.19.0, although Neon puts it at body.projects beside pagination, so Voxgig's list read 0 projects.
• Neon's writes answer the record beside other parts: a project create answers its project beside connection_uris and operations. apidef 8.22.0 reads the record through that composed response, which fixed the create and 13 more of Neon's writes (voxgig/apidef#112).
• Voxgig maps its project update to a transfer-request PUT, and Neon's real update, PATCH /projects/{project_id}, has no method (voxgig/sdkgen#211).
• Entities named operation, context or control collided with the SDK's own type names and broke the TypeScript build on sdkgen 4.30.2. The fix shipped in 4.30.3, so the Voxgig SDK, built on 4.32.1, has it.

The full scorecard, with the evidence for every row