ably 1.2.2 → 1.2.3

data/lib/ably/realtime/channel/channel_properties.rb

@@ -1,14 +1,21 @@
 module Ably::Realtime
   class Channel
-    # Represents properties of a channel and its state
+    # Describes the properties of the channel state.
     class ChannelProperties
       # {Ably::Realtime::Channel} this object associated with
+      #
       # @return [Ably::Realtime::Channel]
+      #
       attr_reader :channel
 
-      # Contains the last channelSerial received in an ATTACHED ProtocolMesage for the channel, see RTL15a
+      # Starts unset when a channel is instantiated, then updated with the channelSerial from each
+      # {Ably::Realtime::Channel::STATE.Attached} event that matches the channel.
+      # Used as the value for {Ably::Realtime::Channel#history}.
+      #
+      # @spec CP2a
       #
       # @return [String]
+      #
       attr_reader :attach_serial
 
       def initialize(channel)

data/lib/ably/realtime/channel/publisher.rb

@@ -5,7 +5,9 @@ module Ably::Realtime
       private
 
       # Prepare and queue messages on the connection queue immediately
+      #
       # @return [Ably::Util::SafeDeferrable]
+      #
       def enqueue_messages_on_connection(client, raw_messages, channel_name, channel_options = {})
         messages = Array(raw_messages).map do |raw_msg|
           create_message(client, raw_msg, channel_options).tap do |message|

data/lib/ably/realtime/channel/push_channel.rb

@@ -1,10 +1,6 @@
 module Ably::Realtime
   class Channel
-    # A push channel used for push notifications
-    # Each PushChannel maps to exactly one Realtime Channel
-    #
-    # @!attribute [r] channel
-    #   @return [Ably::Realtime::Channel] Underlying channel object
+    # Enables devices to subscribe to push notifications for a channel.
     #
     class PushChannel
       attr_reader :channel
@@ -18,35 +14,46 @@ module Ably::Realtime
         "<PushChannel: name=#{channel.name}>"
       end
 
-      # Subscribe local device for push notifications on this channel
+      # Subscribes the device to push notifications for the channel.
+      #
+      # @spec RSH7a
       #
       # @note This is unsupported in the Ruby library
       def subscribe_device(*args)
         raise_unsupported
       end
 
-      # Subscribe all devices registered to this client's authenticated client_id for push notifications on this channel
+      # Subscribes all devices associated with the current device's clientId to push notifications for the channel.
+      #
+      # @spec RSH7b
       #
       # @note This is unsupported in the Ruby library
       def subscribe_client_id(*args)
         raise_unsupported
       end
 
-      # Unsubscribe local device for push notifications on this channel
+      # Unsubscribes the device from receiving push notifications for the channel.
+      #
+      # @spec RSH7c
       #
       # @note This is unsupported in the Ruby library
       def unsubscribe_device(*args)
         raise_unsupported
       end
 
-      # Unsubscribe all devices registered to this client's authenticated client_id for push notifications on this channel
+      # Unsubscribes all devices associated with the current device's clientId from receiving push notifications for the channel.
+      #
+      # @spec RSH7d
       #
       # @note This is unsupported in the Ruby library
       def unsubscribe_client_id(*args)
         raise_unsupported
       end
 
-      # Get list of subscriptions on this channel for this device or authenticate client_id
+      # Retrieves all push subscriptions for the channel. Subscriptions can be filtered using a params object.
+      # Returns a {Ably::Models::PaginatedResult} object containing an array of {Ably::Models::PushChannelSubscription} objects.
+      #
+      # @spec RSH7e
       #
       # @note This is unsupported in the Ruby library
       def get_subscriptions(*args)

data/lib/ably/realtime/channel.rb

@@ -2,10 +2,8 @@ require 'ably/realtime/channel/publisher'
 
 module Ably
   module Realtime
-    # The Channel class represents a Channel belonging to this application.
-    # The Channel instance allows messages to be published and
-    # received, and controls the lifecycle of this instance's
-    # attachment to the channel.
+    # Enables messages to be published and subscribed to. Also enables historic messages to be retrieved and provides
+    # access to the {Ably::Realtime::Channel} object of a channel.
     #
     # Channels will always be in one of the following states:
     #
@@ -18,15 +16,17 @@ module Ably
     #
     # Note that the states are available as Enum-like constants:
     #
-    #   Channel::STATE.Initialized
-    #   Channel::STATE.Attaching
-    #   Channel::STATE.Attached
-    #   Channel::STATE.Detaching
-    #   Channel::STATE.Detached
-    #   Channel::STATE.Failed
-    #
-    # @!attribute [r] state
-    #   @return {Ably::Realtime::Connection::STATE} channel state
+    #   Channel::STATE.Initialized  The channel has been initialized but no attach has yet been attempted.
+    #   Channel::STATE.Attaching    An attach has been initiated by sending a request to Ably.
+    #                               This is a transient state, followed either by a transition to ATTACHED, SUSPENDED, or FAILED.
+    #   Channel::STATE.Attached     The attach has succeeded. In the ATTACHED state a client may publish and subscribe to messages, or be present on the channel.
+    #   Channel::STATE.Detaching    A detach has been initiated on an ATTACHED channel by sending a request to Ably.
+    #                               This is a transient state, followed either by a transition to DETACHED or FAILED.
+    #   Channel::STATE.Detached     The channel, having previously been ATTACHED, has been detached by the user.
+    #   Channel::STATE.Suspended    The channel, having previously been ATTACHED, has lost continuity, usually due to
+    #                               the client being disconnected from Ably for longer than two minutes. It will automatically attempt to reattach as soon as connectivity is restored.
+    #   Channel::STATE.Failed       An indefinite failure condition. This state is entered if a channel error
+    #                               has been received from the Ably service, such as an attempt to attach without the necessary access rights.
     #
     class Channel
       include Ably::Modules::Conversions
@@ -38,7 +38,10 @@ module Ably
       extend Ably::Modules::Enum
       extend Forwardable
 
-      # ChannelState
+      # The current {Abbly::Realtime::Channel::STATE} of the channel.
+      #
+      # @spec RTL2b
+      #
       # The permited states for this channel
       STATE = ruby_enum('STATE',
         :initialized,
@@ -50,8 +53,13 @@ module Ably
         :failed
       )
 
-      # ChannelEvent
+      # Describes the events emitted by a {Ably::Rest::Channel} or {Ably::Realtime::Channel} object.
+      # An event is either an UPDATE or a {Ably::Rest::Channel::STATE}.
+      #
       # The permitted channel events that are emitted for this channel
+      #
+      # @spec RTL2g
+      #
       EVENT = ruby_enum('EVENT',
         STATE.to_sym_arr + [:update]
       )
@@ -64,15 +72,18 @@ module Ably
       MAX_PROTOCOL_MESSAGE_BATCH_SIZE = 50
 
       # {Ably::Realtime::Client} associated with this channel
+      #
       # @return [Ably::Realtime::Client]
+      #
       # @api private
       attr_reader :client
 
-      # Channel name
+      # The channel name.
       # @return [String]
       attr_reader :name
 
-      # Push channel used for push notification
+      # A {Ably::Realtime::Channel::PushChannel} object.
+      #
       # @return [Ably::Realtime::Channel::PushChannel]
       attr_reader :push
 
@@ -80,11 +91,15 @@ module Ably
       # @return [Hash]
       attr_reader :options
 
-      # Properties of a channel and its state
+      # A {Ably::Realtime::Channel::ChannelProperties} object.
+      #
+      # @spec CP1, RTL15
+      #
       # @return [{Ably::Realtime::Channel::ChannelProperties}]
       attr_reader :properties
 
-      # When a channel failure occurs this attribute contains the Ably Exception
+      # An {Ably::Models::ErrorInfo} object describing the last error which occurred on the channel, if any.
+      # @spec RTL4e
       # @return [Ably::Models::ErrorInfo,Ably::Exceptions::BaseAblyException]
       attr_reader :error_reason
 
@@ -94,11 +109,12 @@ module Ably
       attr_reader :manager
 
       # Flag that specifies whether channel is resuming attachment(reattach) or is doing a 'clean attach' RTL4j1
-      # @return [Bolean]
+      # @return [Boolean]
       # @api private
       attr_reader :attach_resume
 
-      # ChannelOptions params attrribute (#RTL4k)
+      # Optional channel parameters that configure the behavior of the channel.
+      # @spec RTL4k1
       # return [Hash]
       def_delegators :options, :params
 
@@ -127,9 +143,11 @@ module Ably
         setup_presence
       end
 
-      # Publish one or more messages to the channel.
+      # Publish a message to the channel. A callback may optionally be passed in to this call to be notified of success
+      # or failure of the operation. When publish is called with this client library, it won't attempt to implicitly
+      # attach to the channel.
       #
-      # When publishing a message, if the channel is not attached, the channel is implicitly attached
+      # @spec RTL6i
       #
       # @param name [String, Array<Ably::Models::Message|Hash>, nil]   The event name of the message to publish, or an Array of [Ably::Model::Message] objects or [Hash] objects with +:name+ and +:data+ pairs
       # @param data [String, ByteArray, nil]   The message payload unless an Array of [Ably::Model::Message] objects passed in the first argument
@@ -195,9 +213,11 @@ module Ably
         end
       end
 
-      # Subscribe to messages matching providing event name, or all messages if event name not provided.
+      # Registers a listener for messages on this channel. The caller supplies a listener function, which is called
+      # each time one or more messages arrives on the channel. A callback may optionally be passed in to this call
+      # to be notified of success or failure of the channel {Ably::Realtime::Channel#attach} operation.
       #
-      # When subscribing to messages, if the channel is not attached, the channel is implicitly attached
+      # @spec RTL7a
       #
       # @param names [String] The event name of the message to subscribe to if provided.  Defaults to all events.
       # @yield [Ably::Models::Message] For each message received, the block is called
@@ -209,8 +229,9 @@ module Ably
         super
       end
 
-      # Unsubscribe the matching block for messages matching providing event name, or all messages if event name not provided.
-      # If a block is not provided, all subscriptions will be unsubscribed
+      # Deregisters the given listener for the specified event name(s). This removes an earlier event-specific subscription.
+      #
+      # @spec RTL8a
       #
       # @param names [String] The event name of the message to subscribe to if provided.  Defaults to all events.
       #
@@ -220,9 +241,15 @@ module Ably
         super
       end
 
-      # Attach to this channel, and call the block if provided when attached.
-      # Attaching to a channel is implicit in when a message is published or #subscribe is called, so it is uncommon
-      # to need to call attach explicitly.
+      # Attach to this channel ensuring the channel is created in the Ably system and all messages published on
+      # the channel are received by any channel listeners registered using {Ably::Realtime::Channel#subscribe}.
+      # Any resulting channel state change will be emitted to any listeners registered using the {Ably::Modules::EventEmitter#on}
+      # or {Ably::Modules::EventEmitter#once} methods. A callback may optionally be passed in to this call to be notified
+      # of success or failure of the operation. As a convenience, attach() is called implicitly
+      # if {Ably::Realtime::Channel#subscribe} for the channel is called, or {Ably::Realtime::Presence#enter}
+      # or {Ably::Realtime::Presence#subscribe} are called on the {Ably::Realtime::Presence} object for this channel.
+      #
+      # @spec RTL4d
       #
       # @yield [Ably::Realtime::Channel] Block is called as soon as this channel is in the Attached state
       # @return [Ably::Util::SafeDeferrable] Deferrable that supports both success (callback) and failure (errback) callback
@@ -245,7 +272,12 @@ module Ably
         deferrable_for_state_change_to(STATE.Attached, &success_block)
       end
 
-      # Detach this channel, and call the block if provided when in a Detached or Failed state
+      # Detach from this channel. Any resulting channel state change is emitted to any listeners registered using
+      # the {Ably::Modules::EventEmitter#on} or {Ably::Modules::EventEmitter#once} methods. A callback may optionally
+      # be passed in to this call to be notified of success or failure of the operation. Once all clients globally
+      # have detached from the channel, the channel will be released in the Ably service within two minutes.
+      #
+      # @spec RTL5e
       #
       # @yield [Ably::Realtime::Channel] Block is called as soon as this channel is in the Detached or Failed state
       # @return [Ably::Util::SafeDeferrable] Deferrable that supports both success (callback) and failure (errback) callback
@@ -274,9 +306,9 @@ module Ably
         deferrable_for_state_change_to(STATE.Detached, &success_block)
       end
 
-      # Presence object for this Channel.  This controls this client's
-      # presence on the channel and may also be used to obtain presence information
-      # and change events for other members of the channel.
+      # A {Ably::Realtime::Presence} object.
+      #
+      # @spec RTL9
       #
       # @return {Ably::Realtime::Presence}
       #
@@ -284,14 +316,15 @@ module Ably
         @presence
       end
 
-      # Return the message history of the channel
+      # Retrieves a {Ably::Models::PaginatedResult} object, containing an array of historical
+      # {Ably::Models::Message} objects for the channel. If the channel is configured to persist messages,
+      # then messages can be retrieved from history for up to 72 hours in the past. If not, messages can only
+      # be retrieved from history for up to two minutes in the past.
       #
-      # If the channel is attached, you can retrieve messages published on the channel before the
-      # channel was attached with the option <tt>until_attach: true</tt>.  This is useful when a developer
-      # wishes to display historical messages with the guarantee that no messages have been missed since attach.
+      # @spec RSL2a
       #
-      # @param (see Ably::Rest::Channel#history)
-      # @option options (see Ably::Rest::Channel#history)
+      # @param (see {Ably::Rest::Channel#history})
+      # @option options (see {Ably::Rest::Channel#history})
       # @option options [Boolean]  :until_attach  When true, the history request will be limited only to messages published before this channel was attached. Channel must be attached
       #
       # @yield [Ably::Models::PaginatedResult<Ably::Models::Message>] First {Ably::Models::PaginatedResult page} of {Ably::Models::Message} objects accessible with {Ably::Models::PaginatedResult#items #items}.
@@ -312,8 +345,8 @@ module Ably
         end
       end
 
-      # @!attribute [r] __incoming_msgbus__
       # @return [Ably::Util::PubSub] Client library internal channel incoming message bus
+      #
       # @api private
       def __incoming_msgbus__
         @__incoming_msgbus__ ||= Ably::Util::PubSub.new(
@@ -321,7 +354,11 @@ module Ably
         )
       end
 
-      # Sets or updates the stored channel options. (#RTL16)
+      # Sets the {Ably::Models::ChannelOptions} for the channel.
+      # An optional callback may be provided to notify of the success or failure of the operation.
+      #
+      # @spec RTL16
+      #
       # @param channel_options [Hash, Ably::Models::ChannelOptions]     A hash of options or a {Ably::Models::ChannelOptions}
       # @return [Ably::Models::ChannelOptions]
       def set_options(channel_options)

data/lib/ably/realtime/channels.rb

@@ -5,28 +5,29 @@ module Ably
       include Ably::Modules::ChannelsCollection
 
       # @return [Ably::Realtime::Channels]
+      #
       def initialize(client)
         super client, Ably::Realtime::Channel
       end
 
-      # @!method get(name, channel_options = {})
       # Return a {Ably::Realtime::Channel} for the given name
       #
       # @param name [String] The name of the channel
       # @param channel_options [Hash, Ably::Models::ChannelOptions] A hash of options or a {Ably::Models::ChannelOptions}
-      # @return [Ably::Realtime::Channel}
+      #
+      # @return [Ably::Realtime::Channel]
       #
       def get(*args)
         super
       end
 
-      # @!method fetch(name, &missing_block)
       # Return a {Ably::Realtime::Channel} for the given name if it exists, else the block will be called.
       # This method is intentionally similar to {http://ruby-doc.org/core-2.1.3/Hash.html#method-i-fetch Hash#fetch} providing a simple way to check if a channel exists or not without creating one
       #
       # @param name [String] The name of the channel
       # @yield [options] (optional) if a missing_block is passed to this method and no channel exists matching the name, this block is called
       # @yieldparam [String] name of the missing channel
+      #
       # @return [Ably::Realtime::Channel]
       #
       def fetch(*args)

data/lib/ably/realtime/client/incoming_message_dispatcher.rb

@@ -121,23 +121,15 @@ module Ably::Realtime
             presence.manager.sync_process_messages protocol_message.channel_serial, protocol_message.presence
 
           when ACTION.Presence
-            if protocol_message.has_correct_message_size?
-              presence = get_channel(protocol_message.channel).presence
-              protocol_message.presence.each do |presence_message|
-                presence.__incoming_msgbus__.publish :presence, presence_message
-              end
-            else
-              logger.fatal Ably::Exceptions::ProtocolError.new("Not published. Channel message limit exceeded #{protocol_message.message_size} bytes", 400, Ably::Exceptions::Codes::UNABLE_TO_RECOVER_CHANNEL_MESSAGE_LIMIT_EXCEEDED).message
+            presence = get_channel(protocol_message.channel).presence
+            protocol_message.presence.each do |presence_message|
+              presence.__incoming_msgbus__.publish :presence, presence_message
             end
 
           when ACTION.Message
-            if protocol_message.has_correct_message_size?
-              channel = get_channel(protocol_message.channel)
-              protocol_message.messages.each do |message|
-                channel.__incoming_msgbus__.publish :message, message
-              end
-            else
-              logger.fatal Ably::Exceptions::ProtocolError.new("Not published. Channel message limit exceeded #{protocol_message.message_size} bytes", 400, Ably::Exceptions::Codes::UNABLE_TO_RECOVER_CHANNEL_MESSAGE_LIMIT_EXCEEDED).message
+            channel = get_channel(protocol_message.channel)
+            protocol_message.messages.each do |message|
+              channel.__incoming_msgbus__.publish :message, message
             end
 
           when ACTION.Auth

data/lib/ably/realtime/client.rb

@@ -3,22 +3,7 @@ require 'ably/realtime/channel/publisher'
 
 module Ably
   module Realtime
-    # Client for the Ably Realtime API
-    #
-    # @!attribute [r] client_id
-    #   (see Ably::Rest::Client#client_id)
-    # @!attribute [r] auth_options
-    #   (see Ably::Rest::Client#auth_options)
-    # @!attribute [r] environment
-    #   (see Ably::Rest::Client#environment)
-    # @!attribute [r] channels
-    #   @return [Aby::Realtime::Channels] The collection of {Ably::Realtime::Channel}s that have been created
-    # @!attribute [r] encoders
-    #   (see Ably::Rest::Client#encoders)
-    # @!attribute [r] protocol
-    #   (see Ably::Rest::Client#protocol)
-    # @!attribute [r] protocol_binary?
-    #   (see Ably::Rest::Client#protocol_binary?)
+    # A client that extends the functionality of the {Ably::Realtime::Client} and provides additional realtime-specific features.
     #
     class Client
       include Ably::Modules::AsyncWrapper
@@ -29,19 +14,33 @@ module Ably
 
       DOMAIN = 'realtime.ably.io'
 
-      # The collection of {Ably::Realtime::Channel}s that have been created
+      # A {Aby::Realtime::Channels} object.
+      #
+      # @spec RTC3, RTS1
+      #
       # @return [Aby::Realtime::Channels]
+      #
       attr_reader :channels
 
-      # (see Ably::Rest::Client#auth)
+      # An {Ably::Auth} object.
+      #
+      # @spec RTC4
+      #
+      # @return [Ably::Auth]
+      #
       attr_reader :auth
 
-      # The underlying connection for this client
+      # A {Aby::Realtime::Connection} object.
+      #
+      # @spec RTC2
+      #
       # @return [Aby::Realtime::Connection]
+      #
       attr_reader :connection
 
       # The {Ably::Rest::Client REST client} instantiated with the same credentials and configuration that is used for all REST operations such as authentication
       # @return [Ably::Rest::Client]
+
       # @private
       attr_reader :rest_client
 
@@ -78,8 +77,10 @@ module Ably
 
       # Creates a {Ably::Realtime::Client Realtime Client} and configures the {Ably::Auth} object for the connection.
       #
-      # @param (see Ably::Rest::Client#initialize)
-      # @option options (see Ably::Rest::Client#initialize)
+      # @spec RSC1
+      #
+      # @param (see {Ably::Rest::Client#initialize})
+      # @option options (see Ably::Rest::Client#initialize) An options {Hash} object.
       # @option options [Proc]                    :auth_callback       when provided, the Proc will be called with the token params hash as the first argument, whenever a new token is required.
       #                                                                Whilst the proc is called synchronously, it does not block the EventMachine reactor as it is run in a separate thread.
       #                                                                The Proc should return a token string, {Ably::Models::TokenDetails} or JSON equivalent, {Ably::Models::TokenRequest} or JSON equivalent
@@ -97,10 +98,10 @@ module Ably
       # @return [Ably::Realtime::Client]
       #
       # @example
-      #    # create a new client authenticating with basic auth
+      #    # Constructs a {Ably::Realtime::Client} object using an Ably API key or token string.
       #    client = Ably::Realtime::Client.new('key.id:secret')
       #
-      #    # create a new client and configure a client ID used for presence
+      #    # Constructs a {Ably::Realtime::Client} object using an Ably options object.
       #    client = Ably::Realtime::Client.new(key: 'key.id:secret', client_id: 'john')
       #
       def initialize(options)
@@ -141,9 +142,13 @@ module Ably
         channels.get(name, channel_options)
       end
 
-      # Retrieve the Ably service time
+      # Retrieves the time from the Ably service as milliseconds since the Unix epoch. Clients that do not have access
+      # to a sufficiently well maintained time source and wish to issue Ably {Ably::Models::TokenRequests} with
+      # a more accurate timestamp should use the queryTime property instead of this method.
+      #
+      # @spec RTC6a
       #
-      # @yield [Time] The time as reported by the Ably service
+      # @yield [Time] The time as milliseconds since the Unix epoch.
       # @return [Ably::Util::SafeDeferrable]
       #
       def time(&success_callback)
@@ -152,12 +157,15 @@ module Ably
         end
       end
 
-      # Retrieve the stats for the application
+      # Queries the REST /stats API and retrieves your application's usage statistics.
+      # Returns a {Ably::Util::SafeDeferrable} object, containing an array of {Ably::Models::Stats} objects. See the Stats docs.
+      #
+      # @spec RTC5
       #
       # @param (see Ably::Rest::Client#stats)
       # @option options (see Ably::Rest::Client#stats)
       #
-      # @yield [Ably::Models::PaginatedResult<Ably::Models::Stats>] An Array of Stats
+      # @yield [Ably::Models::PaginatedResult<Ably::Models::Stats>] A {Ably::Util::SafeDeferrable} object containing an array of {Ably::Models::Stats} objects.
       #
       # @return [Ably::Util::SafeDeferrable]
       #
@@ -167,26 +175,38 @@ module Ably
         end
       end
 
+      # Calls {Connection#close} and causes the connection to close, entering the closing state.
+      # Once closed, the library will not attempt to re-establish the connection without an explicit call to {Connection#connect}.
+      # @spec RTN12
       # (see Ably::Realtime::Connection#close)
       def close(&block)
         connection.close(&block)
       end
 
+      # Calls {Ably::Realtime::Connection#connect} and causes the connection to open, entering the connecting
+      # state. Explicitly calling connect() is unnecessary unless the autoConnect property is disabled.
+      # @spec RTN11
       # (see Ably::Realtime::Connection#connect)
       def connect(&block)
         connection.connect(&block)
       end
 
-      # Push notification object for publishing and managing push notifications
+      # A {Ably::Realtime::Push} object.
       # @return [Ably::Realtime::Push]
       def push
         @push ||= Push.new(self)
       end
 
-      # (see Ably::Rest::Client#request)
+      # Makes a REST request to a provided path. This is provided as a convenience for developers who wish to use REST
+      # API functionality that is either not documented or is not yet included in the public API, without having to
+      # directly handle features such as authentication, paging, fallback hosts, MsgPack and JSON support.
+      #
+      # @spec RTC9
+      #
+      # (see {Ably::Rest::Client#request})
       # @yield [Ably::Models::HttpPaginatedResponse<>] An Array of Stats
       #
-      # @return [Ably::Util::SafeDeferrable]
+      # @return [Ably::Util::SafeDeferrable] An {Ably::Util::SafeDeferrable} response object returned by the HTTP request, containing an empty or JSON-encodable object.
       def request(method, path, params = {}, body = nil, headers = {}, &callback)
         async_wrap(callback) do
           rest_client.request(method, path, params, body, headers, async_blocking_operations: true)
@@ -303,8 +323,9 @@ module Ably
         @fallback_endpoints[fallback_endpoint_index % @fallback_endpoints.count]
       end
 
-      # The local device detilas
-      # @return [Ably::Models::LocalDevice]
+      # Retrieves a {Ably::Models::LocalDevice} object that represents the current state of the device as a target for push notifications.
+      # @spec RSH8
+      # @return [Ably::Models::LocalDevice] A {Ably::Models::LocalDevice} object.
       #
       # @note This is unsupported in the Ruby library
       def device

data/lib/ably/realtime/connection/connection_manager.rb

@@ -270,7 +270,9 @@ module Ably::Realtime
       end
 
       # Number of consecutive attempts for provided state
+      #
       # @return [Integer]
+      #
       # @api private
       def retry_count_for_state(state)
         retries_for_state(state, ignore_states: [:connecting]).count
@@ -356,7 +358,9 @@ module Ably::Realtime
       end
 
       # Timers used to manage connection state, for internal use by the client library
+      #
       # @return [Hash]
+      #
       def timers
         @timers
       end

data/lib/ably/realtime/connection/websocket_transport.rb

@@ -31,7 +31,9 @@ module Ably::Realtime
 
       # Disconnect the socket transport connection and write all pending text.
       # If Disconnected state is not automatically emitted, it will be emitted automatically
+      #
       # @return [void]
+      #
       # @api public
       def disconnect
         close_connection_after_writing
@@ -133,15 +135,15 @@ module Ably::Realtime
         !connecting? && !connected?
       end
 
-      # @!attribute [r] __incoming_protocol_msgbus__
       # @return [Ably::Util::PubSub] Websocket Transport internal incoming protocol message bus
+      #
       # @api private
       def __incoming_protocol_msgbus__
         @__incoming_protocol_msgbus__ ||= create_pub_sub_message_bus
       end
 
-      # @!attribute [r] __outgoing_protocol_msgbus__
       # @return [Ably::Util::PubSub] Websocket Transport internal outgoing protocol message bus
+      #
       # @api private
       def __outgoing_protocol_msgbus__
         @__outgoing_protocol_msgbus__ ||= create_pub_sub_message_bus