Skip to main content

Stainless Transition FAQ: SDK Coverage and Freshness

Use this page for customer and partner conversations about SDK coverage, generated client freshness, and Stainless-style comparisons. For full demo readiness, limitations, and approved status language, use the Spec-to-Stack Readiness Matrix.

Current Generated Client Support​

  • Primary first-class generated client: TypeScript.
  • TypeScript output is generated from OpenAPI and used by Valkyr frontend and integration surfaces.
  • Java backend code is generated from the same OpenAPI contract for the Spring Boot and JPA runtime stack.

Freshness and Stale-Client Behavior​

  • OpenAPI is the source of truth for backend and generated client contracts.
  • Regeneration is part of normal build workflows; generated TypeScript clients are expected to be refreshed whenever contract changes land.
  • If generated output is stale versus the contract, CI and build checks are expected to fail fast so drift is surfaced before release.
  • Customer demos should show the contract source, regenerated TypeScript surface, and CI evidence together so freshness is presented as a verifiable release control instead of a verbal promise.

Approved Answer for Multi-Language SDK Questions​

Use this response pattern:

  • Today, ValkyrAI's production-grade generated client focus is TypeScript.
  • We do not claim broad out-of-the-box multi-language SDK parity today.
  • Additional language SDK support can be scoped as targeted work based on customer requirements and roadmap priority.

Sales Qualification Checklist​

Use these questions before positioning Valkyr against SDK-only tooling:

  • Is the buyer asking for generated API consumers only, or do they also need generated backend services, RBAC, persistence, workflow rails, and deployment controls?
  • Which client language is required for the first production integration?
  • Does TypeScript coverage satisfy the first integration path, or is another language a hard launch blocker?
  • What proof does the buyer need that generated clients are fresh against the OpenAPI contract?
  • Who owns contract changes, regeneration, and CI failure triage after launch?

Customer-Facing Talk Track​

Valkyr is strongest when the buyer needs more than SDK generation. The current first-class generated client path is TypeScript, backed by the same OpenAPI contract used for the Spring Boot runtime. For other SDK languages, use explicit scoped language: roadmap or customer-specific implementation, not shipped parity.

What Not to Claim​

  • Do not claim ValkyrAI is already a full multi-language SDK replacement.
  • Do not imply every language has the same readiness, coverage, or release guarantees as TypeScript.
  • Do not imply stale generated clients can be safely handled outside the normal contract regeneration and CI review path.