Product Updates
Early Access for Universal Typescript SDK and SDK Docs
Sagar Batchu
November 30, 2023 - 3 min read
Welcome to another edition of the Speakeasy Changelog. In this issue, we will give you a sneak peek into products rolling hot off the press—our latest Typescript release as well as SDK Documentation.
Sound good?
Ok, let’s go! 🚀
(Early Access) Universal Typescript SDK
We’re super excited to announce early access to our newest Typescript SDK. This SDK is designed to be a truly universal interface created to run on servers and in the browser, and in any Javascript runtime! Powered by fetch and Zod , it has a minimal code footprint while providing a rich toolkit for one of the fastest-growing and evolving language communities. Other goodies include:
- Built-in runtime validation for types,
- Support for union types and Bigints,
- Native streaming upload and download support. Got an AI product that streams megabytes of data per request and response? No problem, we’ve got your users covered.
Check out that slick interface:
Read more about it here! Or join our Slack for early access!
(Early Access) SDK Documentation
We’re also excited to announce SDK Docs into early access! We’ve always believed that great developer experience starts with type safe experiences and rapid time to 200s. We believe this should
extend to your documentation as well. That’s why we’re releasing support for generating great SDK docs straight from your OpenAPI spec. Get a fully working NextJS powered app with embedded usage snippets
just by running speakeasy generate docs .... ! Or plug into our automation and get a working docs site that stays up to date with every API and SDK change.
We’ve built SDK docs to provide a language-specific guide that gets your users to a fully working integration with just a single copy-paste. Let’s face it: 3-pane API references are out of date! It’s time for something new.
Join our Slack to get early access to SDK Docs!
New OpenAPI Guides:
We have two new posts in our OpenAPI tips series covering best practices when working with tags and servers in your OpenAPI document. These simple concepts, when used effectively, can greatly improve the developer experience for your end users.
-
Working with Servers: The servers block can be a great way to provide your users with convenient access to production, staging, sandbox and other environments you might have. Maybe your API supports tenancy? No problem! You can template out your server endpoints with variables.
-
Working with Tags: Tags can be your best friend when organising your API resources into logical groups for your users.
sdk.payments.list? That’s nice and easy to use :)
🚢 Improvements and Bug Fixes 🐛
Speakeasy v1.125.1
🚢 Improved preferred usage examples selection
🚢 Server selection section automatically added to Readmes
🚢 Complex serialization of deep objects in additionalProperties
Terraform
🐛 Importing of external array of enums
Python
🐛 Unused imports in Python for errors
🐛 Relaxed urllib3 dependency in Python to support boto3
Java
🚢 Nullable support
🚢 Header capture in operation responses
C#
🚢 Support for server variables
🐛 Class names conflicting with namespaces and SDKs in C#/Unity