Master

.gitignore

@@ -1,2 +1,3 @@
 test.html
 WebSocket.swc
+flash-src-websocket

LICENSE.txt

@@ -0,0 +1,9 @@
+Copyright (c) 2013, Hiroshi Ichikawa
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+
+Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+Neither the name of the Hiroshi Ichikawa nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

NEWS.md

@@ -0,0 +1,17 @@
+- 2011-12-27
+    - web-socket-js now speaks WebSocket defined in RFC 6455, which is
+      equivalent to hybi-13 to hybi-17. It no longer supports old draft
+      protocols.
+
+- 2011-12-17
+    - web-socket-js now uses MozWebSocket when available. i.e. When you load
+      web_socket.js, WebSocket is defined as alias of MozWebSocket when
+      available.
+
+- 2011-09-18
+    - web-socket-js now speaks WebSocket version hybi-10. Old versions spoke
+      hixie-76. If you really need web-socket-js which speaks hixie-76, you can
+      get it from
+      [hixie-76 branch](https://github.com/gimite/web-socket-js/tree/hixie-76),
+      but the branch is no longer maintained. Implementation of hybi-10 is
+      mostly done by Joel Martin (kanaka).

README.md

@@ -54,13 +54,13 @@ $ ruby web-socket-ruby/samples/echo_server.rb example.com 10081
 
 If it doesn't work, try these:
 
-1. Try Chrome and Firefox 3.x.
+1. Try Chrome and IE 8 or 9.
 
    - It doesn't work on Chrome:<br>
      It's likely an issue of your code or the server. Debug your code as usual e.g. using console.log.
-   - It works on Chrome but it doesn't work on Firefox:<br>
+   - It works on Chrome but it doesn't work on IE:<br>
      It's likely an issue of web-socket-js specific configuration (e.g. 3 and 4 below).
-   - It works on both Chrome and Firefox, but it doesn't work on your browser:<br>
+   - It works on both Chrome and IE, but it doesn't work on your browser:<br>
      Check "Supported environment" section below. Your browser may not be supported by web-socket-js.
 
 2. Add this line before your code:
@@ -79,13 +79,20 @@ and use Developer Tools (Chrome/Safari) or Firebug (Firefox) to see if console.l
 
 8. Install [debugger version of Flash Player](http://www.adobe.com/support/flashplayer/downloads.html) to see Flash errors.
 
+9. If you followed the steps above and you still have an issue, please [report here](https://github.com/gimite/web-socket-js/issues) with these information:
+
+   - The WebSocket server library you use (e.g. em-websocket, pywebsocket) and its version
+   - The Web browser you use and its version
+   - The exact message you are trying to send from the server or the client
+   - The result of all steps above, especially error message in step 2 if any
+
 
 ## Supported environments
 
 It should work on:
 
-- Google Chrome 4 or later (just uses native implementation)
-- Firefox 3.x, 4.x, Internet Explorer 8, 9 + Flash Player 10 or later
+- Google Chrome 4 or later, Firefox 6 or later (uses native WebSocket or MozWebSocket implementation)
+- Firefox 3 to 5, Internet Explorer 8, 9 + Flash Player 10 or later
 
 It may or may not work on other browsers such as Safari, Opera or IE 6. Patch for these browsers are appreciated, but I will not work on fixing issues specific to these browsers by myself.
 
@@ -105,7 +112,11 @@ This implementation uses Flash's socket, which means that your server must provi
 
 If you use [web-socket-ruby](http://github.com/gimite/web-socket-ruby/tree/master) or [em-websocket](https://github.com/igrigorik/em-websocket), you don't need anything special, because they handle Flash socket policy file request. But if you already provide socket policy file at port **843**, you need to modify the file to allow access to Web Socket port, because it precedes what the libraries provide.
 
-If you use other Web Socket server implementation, you need to provide socket policy file yourself. See [Setting up A Flash Socket Policy File](http://www.lightsphere.com/dev/articles/flash_socket_policy.html) for details and sample script to run socket policy file server. [node.js implementation is available here](https://github.com/3rd-Eden/FlashPolicyFileServer).
+If you use other Web Socket server implementation, you need to provide socket policy file yourself. See [Setting up A Flash Socket Policy File](http://www.lightsphere.com/dev/articles/flash_socket_policy.html) for details. Implementation of socket policy file server is available at:
+
+- The article above (Perl implementation)
+- [Ruby implementation](https://github.com/futurechimp/flash_policy_server)
+- [Node.js implementation](https://github.com/3rd-Eden/FlashPolicyFileServer)
 
 Actually, it's still better to provide socket policy file at port 843 even if you use web-socket-ruby or em-websocket. Flash always try to connect to port 843 first, so providing the file at port 843 makes startup faster.
 
@@ -121,7 +132,7 @@ Note that it's technically possible that client sends arbitrary string as Cookie
 
 ### Proxy support
 
-[The WebSocket spec](http://tools.ietf.org/html/draft-hixie-thewebsocketprotocol) specifies instructions for User Agents to support proxied connections by implementing the HTTP CONNECT method.
+[The WebSocket spec](http://tools.ietf.org/html/draft-ietf-hybi-thewebsocketprotocol-10) specifies instructions for User Agents to support proxied connections by implementing the HTTP CONNECT method.
 
 The AS3 Socket class doesn't implement this mechanism, which renders it useless for the scenarios where the user trying to open a socket is behind a proxy. 
 
@@ -149,9 +160,8 @@ Install [Flex 4 SDK](http://opensource.adobe.com/wiki/display/flexsdk/Download+F
 
 ## WebSocket protocol versions
 
-- web-socket-js supports [Hixie 76 version](http://tools.ietf.org/html/draft-hixie-thewebsocketprotocol-76) of WebSocket protocol by default i.e. in [master branch](https://github.com/gimite/web-socket-js).
-- If you want to try newer [Hybi 07 version](http://tools.ietf.org/html/draft-ietf-hybi-thewebsocketprotocol-07), check out from [hybi-07 branch](https://github.com/gimite/web-socket-js/tree/hybi-07). This will become the master branch in the future, probably when Chrome switches to Hybi 07.
-- Hixie 75 or before is no longer supported.
+- web-socket-js speaks WebSocket protocol defined in [RFC 6455](http://tools.ietf.org/html/rfc6455).
+- web-socket-js doesn't speak old draft versions of WebSocket protocol including hixie-76, which was supported by old version of this library. If you really need web-socket-js which speaks hixie-76, you can get it from [hixie-76 branch](https://github.com/gimite/web-socket-js/tree/hixie-76), but the branch is no longer maintained.
 
 
 ## License

bower.json

@@ -0,0 +1,19 @@
+{
+  "name": "gimite/web-socket-js",
+  "description": "HTML5 Web Socket implementation powered by Flash",
+  "license": "New BSD",
+  "ignore": [
+    "flash-src",
+    "src",
+    ".gitignore",
+    "LICENSE.txt",
+    "NEWS.md",
+    "README.md",
+    "sample.html",
+    "WebSocketMainInsecure.zip"
+  ],
+  "dependencies": {
+  },
+  "devDependencies": {
+  }
+}