SDKs

Official NexSpace SDKs provide typed clients with built-in retry, versioning, and idempotency support.

TypeScript

npm install @nexspace/sdkFull TypeScript types, tree-shakeable ESM, automatic retry with backoff.

Python

pip install nexspacePydantic v2 models, httpx async client, PEP 561 typed.

SDK Features

Feature	TypeScript	Python
Typed request/response	Yes	Yes (Pydantic)
Automatic retry	Yes (3 attempts)	Yes (3 attempts)
API versioning	Yes (`NexSpace-Version` header)	Yes
Idempotency keys	Yes (auto-generated for mutations)	Yes
Streaming	Planned	Planned

Generation

Both SDKs are generated from the OpenAPI spec (server/openapi/openapi.yaml) via Stainless. When the spec or stainless.config.yml changes, the Build Stainless SDKs CI workflow regenerates both SDKs and opens a release PR to the language production repos. See tools/stainless/README.md for the pipeline and ADR 0001 for the decision record.