- Initial commit

Runtime/Extensions/IExtension.cs

@@ -0,0 +1,48 @@
+#if !UNITY_WEBGL || UNITY_EDITOR
+
+using System;
+
+using Best.HTTP;
+using Best.HTTP.Shared.PlatformSupport.Memory;
+using Best.WebSockets.Implementations.Frames;
+
+namespace Best.WebSockets.Extensions
+{
+    /// <summary>
+    /// Interface for websocket-extension implementations.
+    /// </summary>
+    public interface IExtension : IDisposable
+    {
+        /// <summary>
+        /// This is the first pass: here we can add headers to the request to initiate an extension negotiation.
+        /// </summary>
+        /// <param name="request"></param>
+        void AddNegotiation(HTTPRequest request);
+
+        /// <summary>
+        /// If the websocket upgrade succeded it will call this function to be able to parse the server's negotiation
+        /// response. Inside this function the IsEnabled should be set.
+        /// </summary>
+        bool ParseNegotiation(HTTPResponse resp);
+
+        /// <summary>
+        /// This function should return a new header flag based on the inFlag parameter. The extension should set only the
+        /// Rsv1-3 bits in the header.
+        /// </summary>
+        byte GetFrameHeader(WebSocketFrame writer, byte inFlag);
+
+        /// <summary>
+        /// This function will be called to be able to transform the data that will be sent to the server.
+        /// </summary>
+        /// <param name="writer"></param>
+        /// <returns></returns>
+        BufferSegment Encode(WebSocketFrame writer);
+
+        /// <summary>
+        /// This function can be used the decode the server-sent data.
+        /// </summary>
+        BufferSegment Decode(byte header, BufferSegment data);
+    }
+}
+
+#endif