github.com/centrifugal/centrifuge

Releases

1. ▸▾v0.23.1-0.20220630063704-775272d122dc30 Jun 2022pre-release

   Nothing published for this version

2. ▸▾v0.23.1-0.20220628083318-254e6d6899fb28 Jun 2022pre-release

   Nothing published for this version

3. ▸▾v0.23.028 Jun 20222 sources agree

   This release is a work concentrated around two main things:

   This release is a work concentrated around two main things:

   • More work on client protocol v2. This should become part of Centrifugo v4. New SDKs which work over new protocol and have new API will be soon released. SDKs will behave according to client SDK API spec. Probably in next major release of Centrifuge we will switch using protocol v2 by default. For now things should be backwards compatible with current protocol.
   • Introducing our own EXPERIMENTAL bidirectional emulation layer using HTTP-streaming and EventSource transports. There are a couple of examples which demonstrate how to use it. Examples located in _examples/experimental directory (they require new centrifuge-js SDK served locally from v3_dev branch). The important thing about our emulation implementation is that it does not require sticky sessions on load balancer in distributed case. This should be a more lightweight alternative to SockJS, and the cool thing is that our new Javascript SDK will be able to automatically fallback to HTTP-based transports in case of problems with WebSocket connection. More information will be available soon upon Centrifugo v4 release.

   Lots of changes here but in most cases it should be straightforward to adapt. Don't hesitate to reach out with questions in community chat rooms.

   Some important release highlights:

   • DefaultConfig removed, use Config{} as a starting point. I.e. centrifuge.New(centrifuge.Config{}) is equivalent to centrifuge.New(centrifuge.DefaultConfig).
   • We are avoiding using pointers for Disconnects. We got rid of nil Disconnect inside OnDisconnect callback when connection closing was not forced by a server. Where we previously had nil we now always have DisconnectConnectionClosed. This should make library usage more safe and better describes the reason of disconnection.
   • Refactor unsubscribe reasons, make unsubscribe first-class citizen with unsubscribe codes.
   • Introducing Temporary flag for Error to indicate temporary errors to a client. This allows making Subscriptions more resilient in client protocol v2 - subscriptions will re-subscribe automatically upon receiving temporary errors.
   • There are updated rules in code numbers used for errors, unsubscribes and disconnects. This allows splitting code number space and avoid code overlap. While these rules may be tricky to follow – we believe that in most cases library users do not deal with them a lot in application code:
     • For errors: error codes must be in range [0, 1999]. Codes [0, 99] are reserved for client-side errors. Codes [100, 399] are reserved for Centrifuge library internal usage. So applications must use codes in range [400, 1999] when creating custom errors.
     • For unsubscribe codes: codes must be in range [2000, 2999]. Unsubscribe codes >= 2500 coming from server to client result into resubscribe attempt in client protocol V2. Codes [2000, 2099] and [2500, 2599] are reserved for Centrifuge library internal usage. In client protocol v2 we are making Subscriptions to behave isolated from Connection. For example, some individual subscriptions can expire, but it does not result into connection close, only that individual Subscription will re-subscribe if required.
     • For disconnect codes: codes must be in range [3000, 4999]. Codes [3000, 3999] are reserved for Centrifuge library internal usage. Upon receiving disconnect code in range [3000, 3499] or [4000, 4499] client won't reconnect to a server. Splitting disconnect codes to ranges allows getting rid of sending JSON-encoded data in WebSocket CLOSE frame in client protocol v2. Thus – less network traffic and more lightweight disconnection process.
   • OnStateSnapshot callback for connection to return Client current state to the external code, useful for connection introspection. This is EXPERIMENTAL and a subject to change.
   • Remove an unnecessary lock - #230

   As you can see many changes in this release are concentrated around making library more strict in some aspects, this is a part of standardization and unifying client protocol and SDK API/behavior we want to achieve.

   ❯ gorelease -base v0.22.2 -version v0.23.0
   # github.com/centrifugal/centrifuge
   ## incompatible changes
   (*Client).Disconnect: changed from func(*Disconnect) to func(...Disconnect)
   (*Client).Unsubscribe: changed from func(string) error to func(string, ...Unsubscribe)
   DefaultConfig: removed
   DisconnectBadRequest: changed from *Disconnect to Disconnect
   DisconnectChannelLimit: changed from *Disconnect to Disconnect
   DisconnectConnectionLimit: changed from *Disconnect to Disconnect
   DisconnectEvent.Disconnect: changed from *Disconnect to Disconnect
   DisconnectExpired: changed from *Disconnect to Disconnect
   DisconnectForceNoReconnect: changed from *Disconnect to Disconnect
   DisconnectForceReconnect: changed from *Disconnect to Disconnect
   DisconnectInsufficientState: changed from *Disconnect to Disconnect
   DisconnectInvalidToken: changed from *Disconnect to Disconnect
   DisconnectNoPong: changed from *Disconnect to Disconnect
   DisconnectNormal: removed
   DisconnectServerError: changed from *Disconnect to Disconnect
   DisconnectShutdown: changed from *Disconnect to Disconnect
   DisconnectSlow: changed from *Disconnect to Disconnect
   DisconnectStale: changed from *Disconnect to Disconnect
   DisconnectSubExpired: changed from *Disconnect to Disconnect
   DisconnectWriteError: changed from *Disconnect to Disconnect
   Error.Error: removed
   Hub: old is comparable, new is not
   Transport.Close: changed from func(*Disconnect) error to func(Disconnect) error
   TransportInfo.Emulation: added
   UnsubscribeEvent.Reason: removed
   UnsubscribeReason: removed
   UnsubscribeReasonClient: removed
   UnsubscribeReasonDisconnect: removed
   UnsubscribeReasonServer: removed
   WithDisconnect: removed
   ## compatible changes
   (*Client).OnStateSnapshot: added
   (*Client).StateSnapshot: added
   (*Disconnect).CloseText: added
   (*Hub).Connections: added
   Disconnect.Error: added
   Disconnect.String: added
   DisconnectConnectionClosed: added
   DisconnectEvent.Code: added
   DisconnectEvent.Reason: added
   DisconnectEvent.Reconnect: added
   EmulationConfig: added
   EmulationHandler: added
   Error.Temporary: added
   HTTPStreamConfig: added
   HTTPStreamHandler: added
   NewEmulationHandler: added
   NewHTTPStreamHandler: added
   NewSSEHandler: added
   SSEConfig: added
   SSEHandler: added
   StateSnapshotHandler: added
   SubscribeEvent.Positioned: added
   SubscribeEvent.Recoverable: added
   Unsubscribe.String: added
   Unsubscribe: added
   UnsubscribeCodeClient: added
   UnsubscribeCodeDisconnect: added
   UnsubscribeCodeExpired: added
   UnsubscribeCodeInsufficient: added
   UnsubscribeCodeServer: added
   UnsubscribeEvent.Code: added
   UnsubscribeEvent.Unsubscribe: added
   WithCustomDisconnect: added
   WithCustomUnsubscribe: added
   
   # summary
   v0.23.0 is a valid semantic version for this release.