SDK Generation Pipeline

Full Documentation GitHub

REMOTE SOURCES

gladia

api.gladia.io/openapi.json...

assemblyai

raw.githubusercontent.com/AssemblyAI/ass...

assemblyaiAsync

raw.githubusercontent.com/AssemblyAI/ass...

assemblyaiStreaming

raw.githubusercontent.com/AssemblyAI/ass...

deepgram

raw.githubusercontent.com/deepgram/deepg...

openai

app.stainless.com/api/spec/documented/op...

azure

raw.githubusercontent.com/Azure/azure-re...

speechmatics

raw.githubusercontent.com/speechmatics/s...

speechmaticsAsync

raw.githubusercontent.com/speechmatics/s...

deepgramStreaming

raw.githubusercontent.com/deepgram/deepg...

soniox

api.soniox.com/v1/openapi.json...

MANUAL SPECS

assemblyai-streaming-types.ts

Curated streaming types - generated by sync-assemblyai-streaming-types.js

openai-realtime-types.ts

Realtime API types - from Azure-Samples/RealtimeAIApp-JS

speechmatics-batch-types.zod.ts

Curated batch schemas for field-configs

soniox-streaming-types.ts

No official AsyncAPI spec - types extracted from @soniox/speech-to-text-web SDK

SPEC SYNC

sync-specs.js

pnpm openapi:sync

specs/ directory

assemblyai-asyncapi.json

assemblyai-openapi.json

assemblyai-streaming-sdk.ts

assemblyai-streaming-types.ts

azure-stt-openapi.json

deepgram-openapi.yml

deepgram-streaming-sdk.ts

gladia-openapi.json

openai-openapi.yaml

openai-realtime-types.ts

soniox-openapi.json

soniox-streaming-types.ts

speechmatics-asyncapi.yml

speechmatics-batch-types.zod.ts

speechmatics-batch.yml

PRE-ORVAL FIXES

fix-deepgram-spec.js

fixes deepgram spec

fix-openai-spec.js

fixes openai spec

fix-speechmatics-spec.js

fixes speechmatics spec

MANUAL TYPE OVERRIDES

deepgram/

3 type files

ORVAL GENERATION

orval.config.ts

14 projects

API clients

axios-functions

Zod schemas

runtime validation

TypeScript types

schema/ directories

POST-ORVAL FIXES

fix-assemblyai-missing-schemas.js

fix-generated.js

sed fixes

speechmatics string literals

STREAMING TYPE GENERATION

sync-assemblyai-streaming-types.js

assemblyai

sync-deepgram-streaming-types.js

deepgram

sync-soniox-streaming-types.js

soniox

sync-speechmatics-streaming-types.js

speechmatics

LANGUAGE/LOCALE EXTRACTION

generate-azure-locales.js

generate-deepgram-languages.js

generate-soniox-languages.js

generate-speechmatics-languages.js

src/generated/

assemblyai/

api/ schema/ streaming

azure/

api/ schema/ locales

deepgram/

api/ schema/ streaming languages models

gladia/

api/ schema/

openai/

api/ schema/ streaming models

soniox/

api/ schema/ streaming languages models

speechmatics/

api/ schema/ streaming batch languages

SDK EXPORTS

field-configs.ts

zodToFieldConfigs() + typed field names

field-metadata.ts

Pre-computed field metadata (lightweight)

index.ts

Types + Zod namespaces

provider-metadata.ts

Provider info + capabilities

constants.ts

Enums + constants (all providers)

SDK INTERNALS

Provider Adapters

assemblyai

azure-stt

base

deepgram

gladia

openai-whisper

soniox

speechmatics

Webhook Handlers

assemblyai

azure

base

deepgram

gladia

speechmatics

Voice Router

voice-router.ts

VoiceRouter class

types.ts

TranscriptionConfig

provider-streaming-types.ts

PUBLIC API (what users import)

VoiceRouter

Multi-provider routing

Provider Adapters

Direct provider access

WebhookRouter

Webhook handling

Types + Zod Schemas

Runtime validation

Field Configs

UI form generation + typed overrides

Field Metadata

Lightweight alternative to full Zod

Provider Metadata

Provider capabilities

Constants

Type-safe enums for all providers

SDK Generation Pipeline

104 nodes • 46 edges