Skip to content

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[Unreleased]

[0.2.0] - 2026-05-29

Added

  • CustomChannel class for broadcasting to any named group (project rooms, shared feeds) without user-scoping
  • useChannel React hook for subscribing to a CustomChannel from frontend components — multiple components share one underlying WebSocket subscription, cleaned up when the last unmounts
  • custom Centrifugo namespace support — the SDK now emits channels under the custom: prefix and documents the required Centrifugo namespace config

Changed

  • React peer dependency now requires React 19 (>=19.0.0)

[0.1.2] - 2026-01-01

Added

  • JaduSpineBackend singleton for server-side usage — initialize once at startup and call JaduSpineBackend.publish() / broadcast() from anywhere
  • JaduSpineProvider React context and useJaduSpine hook for sharing a single WebSocket connection across the app
  • JWT authentication support with playground auth flow
  • FrontendChannel, BackendChannel typed channel classes with FrontendChannels / BackendChannels enums
  • Restructured playground (backend + frontend) for local development

Changed

  • Renamed source files to camelCase; extracted shared debugLogger
  • Flattened workspace structure

[0.1.0] - 2026-01-01

Added

  • Initial release of @scenarix/jaduspine-sdk
  • JaduSpine class for WebSocket-based realtime messaging (frontend/bidirectional)
  • Connection management with automatic reconnection
  • Channel subscription/unsubscription
  • Message publishing and receiving
  • Event-driven architecture with typed events
  • JaduSpineHttp class for HTTP-based message publishing (backend/server-side)
  • Publish to single channel
  • Broadcast to multiple channels
  • Configurable retry logic with exponential backoff
  • SpineError custom error class with error codes
  • SpineErrorCode enum for programmatic error handling
  • SpineUtils utility class for message creation and validation
  • Emitter generic event emitter with type safety
  • VERSION and SDK_NAME exports for version tracking
  • Full TypeScript type definitions included
  • Comprehensive JSDoc documentation