MarzbanSDK
Resources

Changelog

MarzbanSDK and marzban-mcp release history — generated directly from each package's CHANGELOG.md, so it can't drift from what's on npm or GitHub Releases.

🚀 Features

  • Send the WS log-stream token as Authorization: Bearer on the ws-package transport 0dc6e5f6
  • Public reconnect option with initial/budget/backoff/shouldReconnect escape hatches c9538ec7
  • Add LogOptions.replay to dedup log lines after a reconnect d15fcd9c
  • Typed onError + onOpen/onReconnect/onClose lifecycle callbacks ff35c3e9
  • Return a callable stream handle from logs.connect*() b8bf6249
  • Reconnect WS log streams with a phase-based state machine 075886e4
  • Add WsError, WS_* codes, and URL-token redaction 5da4d2de
  • Make destroy() a terminal, idempotent lifecycle transition #84 0528e1f4

🐛 Bug Fixes

  • Redact URL-embedded secrets inside walk(), not just details.url 77d8958b
  • Correct mcp entries, drop duplicate sdk-v3.0.2 section 32b386b3

🚜 Refactor

  • Extract a shared exponential-backoff helper c99dc901

⚙️ Miscellaneous Tasks

  • Bump marzban-sdk to 4.0.0 14261aa3
  • Drop merge commits, link each changelog entry to its commit c9c30177

Upgrading across a breaking release? See the Migration guide.

Contributing

How to contribute to MarzbanSDK — reporting bugs, submitting PRs, and development setup in the pnpm/Turborepo monorepo.

Migration guide

Step-by-step guides for migrating MarzbanSDK across its breaking releases — v3.0.0's async webhook API, and v4.0.0's WebSocket reconnect lifecycle and destroy() contract.