Add plugin spec for Objects

Author: VeskeR

textile/features.textile

@@ -23,6 +23,7 @@ jump_to:
     - Channels#realtime-channels
     - RealtimeChannel#realtime-channel
     - RealtimePresence#realtime-presence
+    - Objects#objects
     - EventEmitter#eventemitter
     - Forwards compatibility#realtime-compatibility
     - State conditions and operations#state-conditions-and-operations
@@ -385,13 +386,15 @@ h3(#plugins). Plugins
 * @(PC2)@ No generic plugin interface is specified, and therefore there is no common API exposed by all plugins. However, for type-safety, the opaque interface @Plugin@ should be used in strongly-typed languages as the type of the @ClientOptions.plugins@ collection as per "TO3o":#TO3o.
 * @(PC3)@ A plugin provided with the @PluginType@ enum key value of @vcdiff@ should be capable of decoding "vcdiff"-encoded messages. It must implement the @VCDiffDecoder@ interface and the client library must be able to use it by casting it to this interface.
 ** @(PC3a)@ The base argument of the @VCDiffDecoder.decode@ method should receive the stored base payload of the last message on a channel as specified by "RTL19":#RTL19. If the base payload is a string it should be encoded to binary using UTF-8 before being passed as base argument of the @VCDiffDecoder.decode@ method.
+* @(PC5)@ A plugin provided with the @PluginType@ enum key value of @Objects@ should provide the Objects feature functionality for realtime channels. It must implement the @ObjectsPlugin@ interface and the client library must be able to use it by casting it to this interface.
 * @(PC4)@ A client library is allowed to accept plugins other than those specified in this specification, through the use of additional @ClientOptions.plugins@ keys defined by that library. The library is responsible for defining the interface of these plugins, and for making sure that these keys do not clash with the keys defined in this specification.
 
 h3(#plugin-type). PluginType
 
 * @(PT1)@ @PluginType@ is an enum describing the different types of plugins that the library supports. See the @ClientOptions#plugins@ property ("TO3o":#TO3o).
 * @(PT2)@ @PluginType@ takes one of the following values:
 ** @(PT2a)@ @vcdiff@ – see "PC3":#PC3.
+** @(PT2b)@ @Objects@ – see "PC5":#PC5.
 
 h3(#vcdiff-decoder). VCDiffDecoder
 
@@ -775,6 +778,8 @@ h3(#realtime-channel). RealtimeChannel
 ** @(RTL8b)@ Unsubscribe with a name argument and a listener argument unsubscribes the provided listener if previously subscribed with a name-specific subscription
 * @(RTL9)@ @RealtimeChannel#presence@ attribute:
 ** @(RTL9a)@ Returns the @RealtimePresence@ object for this channel
+* @(RTL27)@ @RealtimeChannel#objects@ attribute:
+** @(RTL27a)@ Returns the @Objects@ object for this channel "OBJ1":../objects-features#OBJ1
 * @(RTL10)@ @RealtimeChannel#history@ function:
 ** @(RTL10a)@ Supports all the same params as @RestChannel#history@
 ** @(RTL10b)@ Additionally supports the param @untilAttach@, which if true, will only retrieve messages prior to the moment that the channel was attached or emitted an @UPDATE@ indicating loss of continuity. This bound is specified by passing the querystring param @fromSerial@ with the @RealtimeChannel#properties.attachSerial@ assigned to the channel in the @ATTACHED@ @ProtocolMessage@ (see "RTL15a":#RTL15a). If the @untilAttach@ param is specified when the channel is not attached, it results in an error
@@ -2314,6 +2319,7 @@ class RealtimeChannel: // RTL*
   state: ChannelState // RTL2b
   whenState(ChannelState, (ChannelStateChange?) ->) // RTL25
   presence: RealtimePresence // RTL9
+  objects: Objects // RTL27
   properties: ChannelProperties // RTL15
   // Only on platforms that support receiving push notifications:
   push: PushChannel // RSH7
@@ -2853,6 +2859,7 @@ class Plugin // PC2
 
 enum PluginType // PT*
   "vcdiff" // PT2a
+  "Objects" // PT2b
 
 class VCDiffDecoder // VD*
   decode([byte] delta, [byte] base) -> [byte] // VD2a, PC3a