Read the upgrade guide in our docs: https://docs.basehub.com/api-reference/javascript-sdk/release-notes/version-9.
pnpm i basehub@latest
v9 doesn’t introduce too many new features nor breaking changes, but it does fundamentally change how types are generated. Critically, the basehub
SDK can now work without a “generation step”, and the generation step now only augments the SDK with type information.
This seems subtle, but fixes many bugs related to basehub
not being able to resolve. For context, before v9, running basehub dev
or basehub build
was required for the runtime to get its graphql client. The generation step created the SDK, plus the types. Now, the client is “static” in the sense that’s ready to use once installed, and the generation step is just there for optional typesafety. Additionally, this typesafety works with TypeScript’s declaration merging, which means no more “Restart TS server” to make types work again.
Reasoning
While this version might seem subtle, it allows the library to run in environments that don’t have a build step (or acess to Node.js for a CLI to run). Environments like v0 or Bolt.
BaseHub can now run flawlessly in v0, which means… templates are coming.