Kiota 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 { RegistryClientFactory } from '@apicurio/apicurio-registry-sdk'

const client = RegistryClientFactory.createRegistryClient('https://registry.example.com/apis/registry/v3')

const page = await client.groups.get()
const group = await client.groups.byGroupId('payments').get()
const created = await client.groups.post({ groupId: 'payments' })
await client.groups.byGroupId('payments').delete()

import { ApicurioRegistrySDK } from '@voxgig-sdk/apicurio-registry-sdk'

const client = new ApicurioRegistrySDK({ server: { registry: 'registry.example.com' } })

const groups = await client.Group().list()
const group = await client.Group().load({ id: 'payments' })
// GroupCreateData is the group response: it requires owner, createdOn,
// modifiedBy and modifiedOn, which the server assigns. Hence the cast.
const created = await client.Group().create({ groupId: 'payments' } as any)
await client.Group().remove({ id: 'payments' })

What building and running both found

• Kiota's SDK gzips request bodies by default, which the mock could not read. Its README documents the opt-out, and the scenario used it.
• Its retries, redirects and telemetry come from Kiota's middleware in the six peer packages rather than from generated code, which is why the package itself is small.
• apidef took labels, the one object-valued property of the group schema, for an envelope until 8.18.0, so Voxgig's load and create returned the labels map. On 8.22.0 both return the group.
• Voxgig's create type is the group response, so it requires owner, createdOn, modifiedBy, and modifiedOn, which the server assigns, and a TypeScript create needs a cast (voxgig/sdkgen#215).
• The definition names no server, because the registry is self-hosted. apidef accepts that since 8.20.0, and the Voxgig build keeps the server the definition's own description states, so you pass your host as server.registry.
• sdkgen sent every match field as a query parameter too until 4.31.0. On 4.32.1 a path parameter stays in the path, which a strict server needs.

The full scorecard, with the evidence for every row