v6.0.0-alpha.1

YDB JavaScript SDK [first αlpha]

We are excited to introduce the first alpha of our revamped SDK for interacting with YDB databases in JavaScript and TypeScript!

🚀 What's new

Monorepo & Modular Packages

• Monorepo setup: The SDK is now structured as a monorepo, with independent, logically separated packages:
  @ydbjs/api – Generated protobuf messages (using Buf)
  @ydbjs/core – Driver creation, client-side balancing (can be disabled for single-endpoint/serverless), gRPC client setup
  @ydbjs/auth – Token providers for authentication: token, login+password, metadata service, anonymous
  @ydbjs/error – Unified YDBError wrapper based on operation status
  @ydbjs/retry – Flexible, pluggable operation retries; sensible defaults according to YDB client policies
  @ydbjs/value – Convenient YDB type wrappers and helpers for casting/inferring types between native and server representations
  @ydbjs/query – Query service client for YQL queries with template string support, strong typing, flexible result modes (object, string array, raw), and typed parameterization.
• NPM Release under @ydbjs: All packages are published to npm under the @ydbjs organization. After v6, the main ydb-sdk will become a proxy package aggregating these.

Drivers, Endpoints & Balancer

• Dynamic endpoint set: The driver actualizes the available endpoints every minute for resilience.
• Client-side balancer: Toggle balancer off to connect to a single endpoint—ideal for serverless functions!

Authentication

• Multiple auth modes: Token, login/password, metadata service, or anonymous – all through pluggable providers.

Error Handling

• Consistent error wrapper: Always receive errors in the unified YDBError format.

Query Service

• Type-safe YQL: Write YQL queries with full type support and safe template strings, plus parameterization.
• Flexible outputs: Choose between structured objects, plain string arrays, or raw results.
• Automatic retries: All query operations use the SDK’s robust, configurable retry policies.

Toolbox & Development

• Developer-friendly setup: DevContainers support – a database instance is automatically launched for you alongside the IDE!
• Testing: Core test suite in place, with initial integration and end-to-end tests.

v5.11.0

5.11.0 (2025-03-24)

Features

• enhance static credentials authentication with token refresh interval and improved token handling (444a34d)

Bug Fixes

• avoid unnecessary variable declaration in consumed units example (dd5ebcd)

v5.10.0

5.10.0 (2025-03-19)

Features

• add sessionTrailerCallbackSymbol and support for trailer callbacks in QueryClient (d9ae990)

Bug Fixes

• do not remove session tx id if txMeta empty. (b3e1c01)

v5.9.1

5.9.1 (2025-02-15)

Bug Fixes

• correct get IAM token with authorized key (8111762)
• driver: bring endpoint and connection string to just a host (7bf10b0)
• export QuerySession from root (cfd1efa)
• fixed database connection URL (77800f1)
• fixed database connection URL (27f64d5)

v5.9.0

5.9.0 (2025-02-11)

Features

• enhance UUID handling (12704a6)
• table: add support for unique index (6d2946c)
• update Long type usage and improve UUID generation in topic client (058b5a4)

v5.8.0

5.8.0 (2024-10-30)

Features

• rename poolId to resourcePool and deprecate (74de142)

v5.7.0

5.7.0 (2024-10-30)

Features

• add support for poolId parameter in query service requests (1098749)

v5.6.0

5.6.0 (2024-10-29)

Features

• update ydb-sdk-proto dep (e4ff812)

v5.5.3

5.5.3 (2024-10-22)

Bug Fixes

• topic stream auth in cloud (6adca13)

v5.5.2

5.5.2 (2024-10-15)

Bug Fixes

• fix topic example and make Context publically available (644c116)
• update protobufjs to the latest version and add dependencies to protobufjs in the proto file (509ea47)