faye 0.1.1 → 0.2.2

data/History.txt

@@ -1 +1,29 @@
+=== 0.2.2 / 2010-02-10
+
+* Kick out requests with malformed JSON as 400s
+
+
+=== 0.2.1 / 2010-02-04
+
+* Fix server-side flushing of callback-polling connections
+* Backend can be used cross-domain if running on Node or Thin
+
+
+=== 0.2.0 / 2010-02-02
+
+* Port server to JavaScript with an adapter for Node.js
+* Support Thin's async responses in the Ruby version for complete non-blocking
+* Fix some minor client-side bugs in transport choice
+
+
+=== 0.1.1 / 2009-07-26
+
+* Fix a broken client build
+
+
+=== 0.1.0 / 2009-06-15
+
+* Ruby Bayeux server and Rack adapter
+* Internally evented using EventMachine, web frontend blocks
+* JavaScript client with long-polling and callback-polling
 

data/Jakefile

@@ -1,2 +1,13 @@
 require File.join('lib', 'faye')
+DIR = File.dirname(__FILE__)
+
+jake_hook :build_complete do |build|
+  FileUtils.cp build.package('faye-client').build_path(:min), DIR + '/lib/faye-client-min.js'
+  FileUtils.cp build.package('faye-client').build_path(:min), DIR + '/examples/node/faye-client-min.js'
+  FileUtils.cp build.package(:faye).build_path(:src),         DIR + '/examples/node/faye.js'
+  
+  [['faye-client', :src], [:faye, :min], [:core, :src], [:core, :min]].each do |(pkg,typ)|
+    FileUtils.rm build.package(pkg).build_path(typ)
+  end
+end
 

data/Manifest.txt

@@ -4,16 +4,21 @@ README.txt
 Rakefile
 jake.yml
 Jakefile
-client/util/class.js
-client/util/event.js
-client/util/json.js
-client/util/uri.js
-client/util/xhr.js
-client/faye.js
-client/transport.js
-client/client.js
-client/channel.js
-lib/faye-min.js
+build/faye.js
+build/faye-client-min.js
+examples/README.rdoc
+examples/shared/public/index.html
+examples/shared/public/favicon.ico
+examples/shared/public/jquery.js
+examples/shared/public/robots.txt
+examples/shared/public/soapbox.js
+examples/shared/public/style.css
+examples/node/app.js
+examples/node/faye.js
+examples/node/faye-client-min.js
+examples/rack/app.rb
+examples/rack/config.ru
+lib/faye-client-min.js
 lib/faye.rb
 lib/faye/channel.rb
 lib/faye/connection.rb
@@ -21,13 +26,6 @@ lib/faye/error.rb
 lib/faye/grammar.rb
 lib/faye/rack_adapter.rb
 lib/faye/server.rb
-examples/soapbox/README
-examples/soapbox/app.rb
-examples/soapbox/config.ru
-examples/soapbox/public/jquery.js
-examples/soapbox/public/soapbox.js
-examples/soapbox/public/style.css
-examples/soapbox/views/index.erb
 test/test_channel.rb
 test/test_grammar.rb
 test/test_server.rb

data/README.txt

@@ -2,54 +2,64 @@
 
 * http://github.com/jcoglan/faye
 
-Faye is an implementation of the Bayeux protocol in Ruby. It includes a
-server backend and an adapter for Rack, and a self-contained JavaScript
-client. Bayeux is a protocol designed to facilitate Comet, also known as
-'server push' or 'Ajax push', a technique for pushing messages from the
-server to the client to minimize latency.
+Faye provides dirt-simple Comet messaging based on the Bayeux protocol.
+It ships with a self-contained client for use in the browser and two
+message-routing backends; one for Node.js and one for Rack.
 
-NOTE this is not currently intended for large-scale use. It is being
-developed mostly as a tool for scripting multiple browsers and automating
-JavaScript testing. However, use of a well-known protocol should allow
-it to be repurposed fairly easily.
 
+== Introduction
 
-== Usage
+Comet is an umbrella term for a collection of techniques that let web
+servers push data to clients, allowing for low-latency data transfer.
+Bayeux is a protocol designed to support publish/subscribe-style messaging
+between web clients and servers. Clients can subscribe to named channels
+and publish messages, each message being distributed to all clients
+subscribed to its target channel. See http://svn.cometd.com/trunk/bayeux/bayeux.html
 
-Faye can be installed as middleware in front of any Rack application. For
-example, here's a <tt>config.ru</tt> for running it with Sinatra:
+Faye's messaging backend was originally developed in Ruby for a toy
+project of mine, but was not written to scale across multiple processes
+as required for scaling a Ruby server. It has since been ported to Node.js
+which should handle the required connection load more gracefully.
 
-  require 'rubygems'
-  require 'faye'
-  require 'sinatra'
-  require 'path/to/sinatra/app'
-  
-  use Faye::RackAdapter, :mount   => '/comet',
-                         :timeout => 30
-  
-  run Sinatra::Application
+The two backends are architecturally identical, using evented messaging
+throughout and maintaining subscription data in memory. Node.js allows
+for far more concurrent connections per process than a typical Ruby server,
+and will get you more mileage from a single process.
+
+
+== Installation
+
+The JavaScript client and Node.js server are in the +build+ directory. Just
+copy them onto your machine and <tt>require('path/to/faye')</tt>.
+
+The Rack server is distributed as a Ruby gem:
+
+  sudo gem install faye
 
-This starts a Comet endpoint at <tt>http://localhost:9292/comet</tt> with
-the client script at <tt>http://localhost:9292/comet.js</tt>. The +timeout+
-option sets how long (in seconds) a long-polling request will wait before
-timing out; this must be less than the timeout set on your frontend web server
-so that the Comet server can send a response before Apache (for example)
-closes the connection.
 
-In your front-end code, set up the client as follows:
+== Using the client
+
+Both backends allow you to specify a 'mount point' that the Comet server
+accepts requests on. Say you set this to <tt>/comet</tt>, the client script
+will be available from <tt>/comet.js</tt> and should connect to <tt>/comet</tt>.
+
+You should set up the client as follows:
 
   <script type="text/javascript" src="/comet.js"></script>
   
   <script type="text/javascript">
-      CometClient = new Faye.Client('/comet');
-      CometClient.connect();
+    CometClient = new Faye.Client('/comet');
+    CometClient.connect();
   </script>
 
-This client object can then be used to publish and subscribe to named
-channels as follows:
+Take care only to have one instance of the client per page; since each one
+opens a long-running request you will hit the two-requests-per-host limit
+and block all other Ajax calls if you use more than one client.
+
+This client object can be used to publish and subscribe to named channels:
 
   CometClient.subscribe('/path/to/channel', function(message) {
-      // process received message
+    // process received message object
   });
   
   CometClient.publish('/some/other/channel', {foo: 'bar'});
@@ -60,36 +70,127 @@ Channel names must be formatted as absolute path names as shown. Channels
 beginning with <tt>/meta/</tt> are reserved for use by the messaging protocol
 and may not be subscribed to.
 
+The client can also be used cross-domain if connecting to a backend that
+supports callback polling (see below under 'Transports'). Just pass in the
+full path to the endpoint including the domain. Faye figures out whether the
+server is on the same domain and uses an appropriate transport.
+
+  CometClient = new Faye.Client('http://example.com/comet');
+
+
+=== Transports
+
+The Bayeux spec defines several transport mechanisms for clients to establish
+low-latency connections with the server, the two required types being
+<tt>long-polling</tt> and <tt>callback-polling</tt>.
+
+<tt>long-polling</tt> is where the client makes an <tt>XMLHttpRequest</tt>
+to the server, and the server waits until it has new messages for that client
+before it returns a response. Faye's client and server backends all support
+this transport. Since it uses XHR, the Comet endpoint must be on the same
+domain as the client page.
+
+<tt>callback-polling</tt> involves the client using JSON-P to make the request.
+The server wraps its JSON responses in a JavaScript function call that the
+client then executes. This transport does not require the client and server
+to be on the same domain. Faye's client supports this transport, as does the
+Node.js backend. The Rack backend supports it if running under Thin.
+
+
+== Using the backend
+
+Both the Node.js and Rack backends have identical architectures and are
+designed to be easily plugged into other web services. For Rack the adapter
+is explicitly designed as middleware, while for Node.js the adapter is
+a simple object you can manually offload requests to.
+
+The backends provide a service for routing messages between clients; no
+server-side programming is needed to control them, just start them up
+and they'll sit there merrily chewing through requests. They are both
+currently single-process since they hold all channel subscriptions in
+memory. This means, for example, that the Rack backend will not work
+under Passenger since that spawns multiple Ruby processes to serve your
+site.
 
-== Examples
+Faye uses async messaging internally so nothing blocks while waiting for
+new messages. If running under a Ruby web server (except Thin) the server
+will block while waiting for a response from Faye. Thin supports async
+responses and is a better choice for long-running concurrent connections.
 
-See demo apps in +examples+. If you've checked this out from the repo rather than
-installing the gem you will need to build the JavaScript client from source, this
-is done as follows:
+Both backends support the following initialization options:
 
-  sudo gem install jake
-  jake -f
+* +mount+ - the path at which the Comet service is accessible. e.g. if
+  set to <tt>/faye</tt>, the Comet endpoint will be at <tt>http://yoursite.com/faye</tt>
+  and the client script at <tt>http://yoursite.com/faye.js</tt>.
+* +timeout+ - the maximum time (seconds) to hold a long-running request
+  open before returning a response. This must be smaller than the timeout
+  on your frontend webserver to make sure Faye sends a response before
+  the server kills the connection.
+
+Usage examples and a demo app are in the +examples+ directory.
+
+
+=== Node.js backend
+
+Here's a very simple Node web server that offloads requests to the Comet
+service to Faye and deals with all other requests itself. The Faye object
+returns +true+ or +false+ to indicate whether it handled the request.
+You'll need <tt>faye.js</tt> and <tt>faye-client-min.js</tt> in the same
+directory.
+
+  var http  = require('http')
+      faye  = require('./faye');
+  
+  var comet = new faye.NodeAdapter({mount: '/comet', timeout: 45});
+  
+  http.createServer(function(request, response) {
+    if (comet.call(request, response)) return;
+    
+    response.sendHeader(200, {'Content-Type': 'text/plain'});
+    response.sendBody('Hello, non-Comet request!');
+    response.finish();
+    
+  }).listen(9292);
+
+
+=== Rack backend
+
+Faye can be installed as middleware in front of any Rack application. The
+Rack backend uses EventMachine for asynchronous message distribution and
+timeouts. It can run under any web server, though Thin is best placed for
+handling long-running concurrent connections and supports async server
+responses. Under other servers the request thread will block while waiting
+for a response from Faye.
+
+Here's a <tt>config.ru</tt> for running it with Sinatra:
+
+  require 'rubygems'
+  require 'faye'
+  require 'sinatra'
+  require 'path/to/sinatra/app'
+  
+  use Faye::RackAdapter, :mount   => '/comet',
+                         :timeout => 25
+  
+  run Sinatra::Application
+
+This functions much the same as the Node.js example; Faye catches Comet
+requests and deals with them, letting all other requests fall down the
+stack of Rack middlewares.
 
 
 == To-do
 
 * Provide support for user-defined <tt>/service/*</tt> channels
-* Support Thin's async response
 * Allow server to scale to multiple nodes
 * Provide a server-side client
-* Console for scripting browsers from the command line
-
-
-== Installation
-
-  sudo gem install hoe faye
 
 
 == License
 
 (The MIT License)
 
-Copyright (c) 2009 James Coglan
+Copyright (c) 2009-2010 James Coglan
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the
@@ -109,3 +210,4 @@ IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
 CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
 TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
 SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+

data/build/faye-client-min.js

@@ -0,0 +1 @@
+if(!this.Faye)Faye={};Faye.extend=function(a,b,c){if(!b)return a;for(var d in b){if(b.hasOwnProperty(d)&&a[d]!==b[d]){if(!a.hasOwnProperty(d)||c!==false)a[d]=b[d]}}return a};Faye.extend(Faye,{BAYEUX_VERSION:'1.0',VERSION:'0.2.2',JSONP_CALLBACK:'jsonpcallback',ID_LENGTH:128,CONNECTION_TYPES:["long-polling","callback-polling"],ENV:this,Grammar:{LOWALPHA:/^[a-z]$/,UPALPHA:/^[A-Z]$/,ALPHA:/^([a-z]|[A-Z])$/,DIGIT:/^[0-9]$/,ALPHANUM:/^(([a-z]|[A-Z])|[0-9])$/,MARK:/^(\-|\_|\!|\~|\(|\)|\$|\@)$/,STRING:/^(((([a-z]|[A-Z])|[0-9])|(\-|\_|\!|\~|\(|\)|\$|\@)| |\/|\*|\.))*$/,TOKEN:/^(((([a-z]|[A-Z])|[0-9])|(\-|\_|\!|\~|\(|\)|\$|\@)))+$/,INTEGER:/^([0-9])+$/,CHANNEL_SEGMENT:/^(((([a-z]|[A-Z])|[0-9])|(\-|\_|\!|\~|\(|\)|\$|\@)))+$/,CHANNEL_SEGMENTS:/^(((([a-z]|[A-Z])|[0-9])|(\-|\_|\!|\~|\(|\)|\$|\@)))+(\/(((([a-z]|[A-Z])|[0-9])|(\-|\_|\!|\~|\(|\)|\$|\@)))+)*$/,CHANNEL_NAME:/^\/(((([a-z]|[A-Z])|[0-9])|(\-|\_|\!|\~|\(|\)|\$|\@)))+(\/(((([a-z]|[A-Z])|[0-9])|(\-|\_|\!|\~|\(|\)|\$|\@)))+)*$/,WILD_CARD:/^\*{1,2}$/,CHANNEL_PATTERN:/^(\/(((([a-z]|[A-Z])|[0-9])|(\-|\_|\!|\~|\(|\)|\$|\@)))+)*\/\*{1,2}$/,VERSION_ELEMENT:/^(([a-z]|[A-Z])|[0-9])(((([a-z]|[A-Z])|[0-9])|\-|\_))*$/,VERSION:/^([0-9])+(\.(([a-z]|[A-Z])|[0-9])(((([a-z]|[A-Z])|[0-9])|\-|\_))*)*$/,CLIENT_ID:/^((([a-z]|[A-Z])|[0-9]))+$/,ID:/^((([a-z]|[A-Z])|[0-9]))+$/,ERROR_MESSAGE:/^(((([a-z]|[A-Z])|[0-9])|(\-|\_|\!|\~|\(|\)|\$|\@)| |\/|\*|\.))*$/,ERROR_ARGS:/^(((([a-z]|[A-Z])|[0-9])|(\-|\_|\!|\~|\(|\)|\$|\@)| |\/|\*|\.))*(,(((([a-z]|[A-Z])|[0-9])|(\-|\_|\!|\~|\(|\)|\$|\@)| |\/|\*|\.))*)*$/,ERROR_CODE:/^[0-9][0-9][0-9]$/,ERROR:/^([0-9][0-9][0-9]:(((([a-z]|[A-Z])|[0-9])|(\-|\_|\!|\~|\(|\)|\$|\@)| |\/|\*|\.))*(,(((([a-z]|[A-Z])|[0-9])|(\-|\_|\!|\~|\(|\)|\$|\@)| |\/|\*|\.))*)*:(((([a-z]|[A-Z])|[0-9])|(\-|\_|\!|\~|\(|\)|\$|\@)| |\/|\*|\.))*|[0-9][0-9][0-9]::(((([a-z]|[A-Z])|[0-9])|(\-|\_|\!|\~|\(|\)|\$|\@)| |\/|\*|\.))*)$/},commonElement:function(a,b){for(var c=0,d=a.length;c<d;c++){if(this.indexOf(b,a[c])!==-1)return a[c]}return null},indexOf:function(a,b){for(var c=0,d=a.length;c<d;c++){if(a[c]===b)return c}return-1},each:function(a,b,c){if(a instanceof Array){for(var d=0,f=a.length;d<f;d++){if(a[d]!==undefined)b.call(c||null,a[d],d)}}else{for(var g in a){if(a.hasOwnProperty(g))b.call(c||null,g,a[g])}}},size:function(a){var b=0;this.each(a,function(){b+=1});return b},random:function(){var a=Math.pow(2,this.ID_LENGTH);return(Math.random()*a).toString(16).replace(/0*$/,'')},enumEqual:function(c,d){if(d instanceof Array){if(!(c instanceof Array))return false;var f=c.length;if(f!==d.length)return false;while(f--){if(c[f]!==d[f])return false}return true}else{if(!(c instanceof Object))return false;if(this.size(d)!==this.size(c))return false;var g=true;this.each(c,function(a,b){g=g&&(d[a]===b)});return g}}});Faye.Class=function(a,b){if(typeof a!=='function'){b=a;a=Object}var c=function(){if(!this.initialize)return this;return this.initialize.apply(this,arguments)||this};var d=function(){};d.prototype=a.prototype;c.prototype=new d();Faye.extend(c.prototype,b);return c};Faye.Observable={on:function(a,b,c){this._1=this._1||{};var d=this._1[a]=this._1[a]||[];d.push([b,c])},stopObserving:function(a,b,c){if(!this._1||!this._1[a])return;if(!b){delete this._1[a];return}var d=this._1[a],f=d.length;while(f--){if(b&&d[f][0]!==b)continue;if(c&&d[f][1]!==c)continue;d.splice(f,1)}},fire:function(){var b=Array.prototype.slice.call(arguments),c=b.shift();if(!this._1||!this._1[c])return;Faye.each(this._1[c],function(a){a[0].apply(a[1],b.slice())})}};Faye.Channel=Faye.Class({initialize:function(a){this.__id=this._A=a},push:function(a){this.fire('message',a)}});Faye.extend(Faye.Channel.prototype,Faye.Observable);Faye.extend(Faye.Channel,{HANDSHAKE:'/meta/handshake',CONNECT:'/meta/connect',SUBSCRIBE:'/meta/subscribe',UNSUBSCRIBE:'/meta/unsubscribe',DISCONNECT:'/meta/disconnect',META:'meta',SERVICE:'service',isValid:function(a){return Faye.Grammar.CHANNEL_NAME.test(a)||Faye.Grammar.CHANNEL_PATTERN.test(a)},parse:function(a){if(!this.isValid(a))return null;return a.split('/').slice(1)},isMeta:function(a){var b=this.parse(a);return b?(b[0]===this.META):null},isService:function(a){var b=this.parse(a);return b?(b[0]===this.SERVICE):null},isSubscribable:function(a){if(!this.isValid(a))return null;return!this.isMeta(a)&&!this.isService(a)},Tree:Faye.Class({initialize:function(a){this._3=a;this._5={}},eachChild:function(c,d){Faye.each(this._5,function(a,b){c.call(d,a,b)})},each:function(c,d,f){this.eachChild(function(a,b){a=c.concat(a);b.each(a,d,f)});if(this._3!==undefined)d.call(f,c,this._3)},map:function(c,d){var f=[];this.each([],function(a,b){f.push(c.call(d,a,b))});return f},get:function(a){var b=this.traverse(a);return b?b._3:null},set:function(a,b){var c=this.traverse(a,true);if(c)c._3=b},traverse:function(a,b){if(typeof a==='string')a=Faye.Channel.parse(a);if(a===null)return null;if(a.length===0)return this;var c=this._5[a[0]];if(!c&&!b)return null;if(!c)c=this._5[a[0]]=new Faye.Channel.Tree();return c.traverse(a.slice(1),b)},findOrCreate:function(a){var b=this.get(a);if(b)return b;b=new Faye.Channel(a);this.set(a,b);return b},glob:function(f){if(typeof f==='string')f=Faye.Channel.parse(f);if(f===null)return[];if(f.length===0)return(this._3===undefined)?[]:[this._3];var g=[];if(Faye.enumEqual(f,['*'])){Faye.each(this._5,function(a,b){if(b._3!==undefined)g.push(b._3)});return g}if(Faye.enumEqual(f,['**'])){g=this.map(function(a,b){return b});g.pop();return g}Faye.each(this._5,function(b,c){if(b!==f[0]&&b!=='*')return;var d=c.glob(f.slice(1));Faye.each(d,function(a){g.push(a)})});if(this._5['**'])g.push(this._5['**']._3);return g}})});Faye.Event={_a:[],on:function(a,b,c,d){var f=function(){c.call(d)};if(a.addEventListener)a.addEventListener(b,f,false);else a.attachEvent('on'+b,f);this._a.push({_b:a,_h:b,_s:c,_c:d,_m:f})},detach:function(a,b,c,d){var f=this._a.length,g;while(f--){g=this._a[f];if((a&&a!==g._b)||(b&&b!==g._h)||(c&&c!==g._s)||(d&&d!==g._c))continue;if(g._b.removeEventListener)g._b.removeEventListener(g._h,g._m,false);else g._b.detachEvent('on'+g._h,g._m);this._a.splice(f,1);g=null}}};Faye.Event.on(Faye.ENV,'unload',Faye.Event.detach,Faye.Event);Faye.URI=Faye.extend(Faye.Class({queryString:function(){var c=[],d;Faye.each(this.params,function(a,b){c.push(encodeURIComponent(a)+'='+encodeURIComponent(b))});return c.join('&')},isLocal:function(){var a=Faye.URI.parse(Faye.ENV.location.href);var b=(a.hostname!==this.hostname)||(a.port!==this.port)||(a.protocol!==this.protocol);return!b},toURL:function(){return this.protocol+this.hostname+':'+this.port+this.pathname+'?'+this.queryString()}}),{parse:function(d,f){if(typeof d!=='string')return d;var g=new this();var k=function(b,c){d=d.replace(c,function(a){if(a)g[b]=a;return''})};k('protocol',/^https?\:\/+/);k('hostname',/^[^\/\:]+/);k('port',/^:[0-9]+/);Faye.extend(g,{protocol:'http://',hostname:Faye.ENV.location.hostname,port:Faye.ENV.location.port},false);if(!g.port)g.port=(g.protocol==='https://')?'443':'80';g.port=g.port.replace(/\D/g,'');var i=d.split('?'),h=i.shift(),l=i.join('?'),n=l?l.split('&'):[],o=n.length,j={};while(o--){i=n[o].split('=');j[decodeURIComponent(i[0]||'')]=decodeURIComponent(i[1]||'')}Faye.extend(j,f);g.pathname=h;g.params=j;return g}});Faye.XHR={request:function(a,b,c,d,f){var g=new this.Request(a,b,c,d,f);g.send();return g},getXhrObject:function(){return Faye.ENV.ActiveXObject?new ActiveXObject("Microsoft.XMLHTTP"):new XMLHttpRequest()},Request:Faye.Class({initialize:function(a,b,c,d,f){this._d=a.toUpperCase();this._6=Faye.URI.parse(b,c);this._t=(typeof d==='function')?{success:d}:d;this._c=f||null;this._2=null},send:function(){if(this._i)return;var a=this._6.pathname,b=this._6.queryString();if(this._d==='GET')a+='?'+b;var c=this._d==='POST'?b:'';this._i=true;this._2=Faye.XHR.getXhrObject();this._2.open(this._d,a,true);if(this._d==='POST')this._2.setRequestHeader('Content-Type','application/x-www-form-urlencoded');var d=this,f=function(){if(d._2.readyState!==4)return;if(g){clearInterval(g);g=null}Faye.Event.detach(Faye.ENV,'beforeunload',d.abort,d);d._i=false;d._u();d=null};var g=setInterval(f,10);Faye.Event.on(Faye.ENV,'beforeunload',this.abort,this);this._2.send(c)},abort:function(){this._2.abort()},_u:function(){var a=this._t;if(!a)return;return this.success()?a.success&&a.success.call(this._c,this):a.failure&&a.failure.call(this._c,this)},waiting:function(){return!!this._i},complete:function(){return this._2&&!this.waiting()},success:function(){if(!this.complete())return false;var a=this._2.status;return(a>=200&&a<300)||a===304||a===1223},failure:function(){if(!this.complete())return false;return!this.success()},text:function(){if(!this.complete())return null;return this._2.responseText},status:function(){if(!this.complete())return null;return this._2.status}})};Faye.Transport=Faye.extend(Faye.Class({initialize:function(a,b){this._n=a;this._6=b},send:function(c,d,f){c={message:JSON.stringify(c)};return this.request(c,function(b){if(!d)return;Faye.each([].concat(b),function(a){d.call(f,a);if(a.advice)this._n._v(a.advice);if(a.data&&a.channel)this._n._w(a)},this)},this)}}),{get:function(a,b){var c=a._6;if(b===undefined)b=this.supportedConnectionTypes();var d=Faye.URI.parse(c).isLocal()?['long-polling','callback-polling']:['callback-polling'];var f=Faye.commonElement(d,b);if(!f)throw'Could not find a usable connection type for '+c;var g=this._j[f];return new g(a,c)},register:function(a,b){this._j[a]=b;b.prototype.connectionType=a},_j:{},supportedConnectionTypes:function(){var c=[],d;Faye.each(this._j,function(a,b){c.push(a)});return c}});Faye.XHRTransport=Faye.Class(Faye.Transport,{request:function(b,c,d){Faye.XHR.request('post',this._6,b,function(a){if(c)c.call(d,JSON.parse(a.text()))})}});Faye.Transport.register('long-polling',Faye.XHRTransport);Faye.JSONPTransport=Faye.extend(Faye.Class(Faye.Transport,{request:function(b,c,d){var f=document.getElementsByTagName('head')[0],g=document.createElement('script'),k=Faye.JSONPTransport.getCallbackName(),i=Faye.URI.parse(this._6,b);Faye.ENV[k]=function(a){Faye.ENV[k]=undefined;try{delete Faye.ENV[k]}catch(e){}f.removeChild(g);if(c)c.call(d,a)};i.params.jsonp=k;g.type='text/javascript';g.src=i.toURL();f.appendChild(g)}}),{_o:0,getCallbackName:function(){this._o+=1;return'__jsonp'+this._o+'__'}});Faye.Transport.register('callback-polling',Faye.JSONPTransport);Faye.Client=Faye.Class({_e:{},_x:{},_8:{},_y:{},_p:'handshake',_z:'retry',_q:'none',DEFAULT_ENDPOINT:'/bayeux',MAX_DELAY:0.1,INTERVAL:1000.0,initialize:function(a){this._6=a||this.DEFAULT_ENDPOINT;this._4=Faye.Transport.get(this);this._0=this._e;this._k=[];this._f=new Faye.Channel.Tree();this._7={reconnect:this._z,interval:this.INTERVAL};Faye.Event.on(Faye.ENV,'beforeunload',this.disconnect,this)},handshake:function(b,c){if(this._7.reconnect===this._q)return;if(this._0!==this._e)return;this._0=this._x;var d=this,f=this.generateId();this._4.send({channel:Faye.Channel.HANDSHAKE,version:Faye.BAYEUX_VERSION,supportedConnectionTypes:Faye.Transport.supportedConnectionTypes(),id:f},function(a){if(a.id!==f)return;if(!a.successful){setTimeout(function(){d.handshake(b,c)},this._7.interval);return this._0=this._e}this._0=this._8;this._9=a.clientId;this._4=Faye.Transport.get(this,a.supportedConnectionTypes);if(b)b.call(c)},this)},connect:function(b,c){if(this._7.reconnect===this._q)return;if(this._7.reconnect===this._p||this._0===this._e)return this.handshake(function(){this.connect(b,c)},this);if(this._0!==this._8)return;if(this._g)return;this._g=this.generateId();var d=this;this._4.send({channel:Faye.Channel.CONNECT,clientId:this._9,connectionType:this._4.connectionType,id:this._g},function(a){if(a.id!==this._g)return;delete this._g;if(a.successful)this.connect();else setTimeout(function(){d.connect()},this._7.interval)},this);if(b)b.call(c)},disconnect:function(){if(this._0!==this._8)return;this._0=this._y;this._4.send({channel:Faye.Channel.DISCONNECT,clientId:this._9});this._f=new Faye.Channel.Tree()},subscribe:function(c,d,f){if(this._0!==this._8)return;c=[].concat(c);this._l(c);var g=this.generateId();this._4.send({channel:Faye.Channel.SUBSCRIBE,clientId:this._9,subscription:c,id:g},function(b){if(b.id!==g)return;if(!b.successful)return;c=[].concat(b.subscription);Faye.each(c,function(a){this._f.set(a,[d,f])},this)},this)},unsubscribe:function(c,d,f){if(this._0!==this._8)return;c=[].concat(c);this._l(c);var g=this.generateId();this._4.send({channel:Faye.Channel.UNSUBSCRIBE,clientId:this._9,subscription:c,id:g},function(b){if(b.id!==g)return;if(!b.successful)return;c=[].concat(b.subscription);Faye.each(c,function(a){this._f.set(a,null)},this)},this)},publish:function(a,b){if(this._0!==this._8)return;this._l([a]);this.enqueue({channel:a,data:b,clientId:this._9});if(this._r)return;var c=this;this._r=setTimeout(function(){delete c._r;c.flush()},this.MAX_DELAY*1000)},generateId:function(a){a=a||32;return Math.floor(Math.pow(2,a)*Math.random()).toString(16)},enqueue:function(a){this._k.push(a)},flush:function(){this._4.send(this._k);this._k=[]},_l:function(b){Faye.each(b,function(a){if(!Faye.Channel.isValid(a))throw'"'+a+'" is not a valid channel name';if(!Faye.Channel.isSubscribable(a))throw'Clients may not subscribe to channel "'+a+'"';})},_v:function(a){Faye.extend(this._7,a);if(this._7.reconnect===this._p)this._9=null},_w:function(b){var c=this._f.glob(b.channel);Faye.each(c,function(a){if(!a)return;a[0].call(a[1],b.data)})}});if(!this.JSON){JSON={}}(function(){function l(a){return a<10?'0'+a:a}if(typeof Date.prototype.toJSON!=='function'){Date.prototype.toJSON=function(a){return this.getUTCFullYear()+'-'+l(this.getUTCMonth()+1)+'-'+l(this.getUTCDate())+'T'+l(this.getUTCHours())+':'+l(this.getUTCMinutes())+':'+l(this.getUTCSeconds())+'Z'};String.prototype.toJSON=Number.prototype.toJSON=Boolean.prototype.toJSON=function(a){return this.valueOf()}}var n=/[\u0000\u00ad\u0600-\u0604\u070f\u17b4\u17b5\u200c-\u200f\u2028-\u202f\u2060-\u206f\ufeff\ufff0-\uffff]/g,o=/[\\\"\x00-\x1f\x7f-\x9f\u00ad\u0600-\u0604\u070f\u17b4\u17b5\u200c-\u200f\u2028-\u202f\u2060-\u206f\ufeff\ufff0-\uffff]/g,j,p,s={'\b':'\\b','\t':'\\t','\n':'\\n','\f':'\\f','\r':'\\r','"':'\\"','\\':'\\\\'},m;function r(c){o.lastIndex=0;return o.test(c)?'"'+c.replace(o,function(a){var b=s[a];return typeof b==='string'?b:'\\u'+('0000'+a.charCodeAt(0).toString(16)).slice(-4)})+'"':'"'+c+'"'}function q(a,b){var c,d,f,g,k=j,i,h=b[a];if(h&&typeof h==='object'&&typeof h.toJSON==='function'){h=h.toJSON(a)}if(typeof m==='function'){h=m.call(b,a,h)}switch(typeof h){case'string':return r(h);case'number':return isFinite(h)?String(h):'null';case'boolean':case'null':return String(h);case'object':if(!h){return'null'}j+=p;i=[];if(Object.prototype.toString.apply(h)==='[object Array]'){g=h.length;for(c=0;c<g;c+=1){i[c]=q(c,h)||'null'}f=i.length===0?'[]':j?'[\n'+j+i.join(',\n'+j)+'\n'+k+']':'['+i.join(',')+']';j=k;return f}if(m&&typeof m==='object'){g=m.length;for(c=0;c<g;c+=1){d=m[c];if(typeof d==='string'){f=q(d,h);if(f){i.push(r(d)+(j?': ':':')+f)}}}}else{for(d in h){if(Object.hasOwnProperty.call(h,d)){f=q(d,h);if(f){i.push(r(d)+(j?': ':':')+f)}}}}f=i.length===0?'{}':j?'{\n'+j+i.join(',\n'+j)+'\n'+k+'}':'{'+i.join(',')+'}';j=k;return f}}if(typeof JSON.stringify!=='function'){JSON.stringify=function(a,b,c){var d;j='';p='';if(typeof c==='number'){for(d=0;d<c;d+=1){p+=' '}}else if(typeof c==='string'){p=c}m=b;if(b&&typeof b!=='function'&&(typeof b!=='object'||typeof b.length!=='number')){throw new Error('JSON.stringify');}return q('',{'':a})}}if(typeof JSON.parse!=='function'){JSON.parse=function(g,k){var i;function h(a,b){var c,d,f=a[b];if(f&&typeof f==='object'){for(c in f){if(Object.hasOwnProperty.call(f,c)){d=h(f,c);if(d!==undefined){f[c]=d}else{delete f[c]}}}}return k.call(a,b,f)}n.lastIndex=0;if(n.test(g)){g=g.replace(n,function(a){return'\\u'+('0000'+a.charCodeAt(0).toString(16)).slice(-4)})}if(/^[\],:{}\s]*$/.test(g.replace(/\\(?:["\\\/bfnrt]|u[0-9a-fA-F]{4})/g,'@').replace(/"[^"\\\n\r]*"|true|false|null|-?\d+(?:\.\d*)?(?:[eE][+\-]?\d+)?/g,']').replace(/(?:^|:|,)(?:\s*\[)+/g,''))){i=eval('('+g+')');return typeof k==='function'?h({'':i},''):i}throw new SyntaxError('JSON.parse');}}}());

data/build/faye.js

@@ -0,0 +1,868 @@
+if (!this.Faye) Faye = {};
+
+Faye.extend = function(dest, source, overwrite) {
+  if (!source) return dest;
+  for (var key in source) {
+    if (source.hasOwnProperty(key) && dest[key] !== source[key]) {
+      if (!dest.hasOwnProperty(key) || overwrite !== false)
+        dest[key] = source[key];
+    }
+  }
+  return dest;
+};
+
+Faye.extend(Faye, {
+  BAYEUX_VERSION:   '1.0',
+  VERSION:          '0.2.2',
+  JSONP_CALLBACK:   'jsonpcallback',
+  ID_LENGTH:        128,
+  CONNECTION_TYPES: ["long-polling", "callback-polling"],
+  
+  ENV:              this,
+  
+  Grammar: {
+
+    LOWALPHA:     /^[a-z]$/,
+
+    UPALPHA:     /^[A-Z]$/,
+
+    ALPHA:     /^([a-z]|[A-Z])$/,
+
+    DIGIT:     /^[0-9]$/,
+
+    ALPHANUM:     /^(([a-z]|[A-Z])|[0-9])$/,
+
+    MARK:     /^(\-|\_|\!|\~|\(|\)|\$|\@)$/,
+
+    STRING:     /^(((([a-z]|[A-Z])|[0-9])|(\-|\_|\!|\~|\(|\)|\$|\@)| |\/|\*|\.))*$/,
+
+    TOKEN:     /^(((([a-z]|[A-Z])|[0-9])|(\-|\_|\!|\~|\(|\)|\$|\@)))+$/,
+
+    INTEGER:     /^([0-9])+$/,
+
+    CHANNEL_SEGMENT:     /^(((([a-z]|[A-Z])|[0-9])|(\-|\_|\!|\~|\(|\)|\$|\@)))+$/,
+
+    CHANNEL_SEGMENTS:     /^(((([a-z]|[A-Z])|[0-9])|(\-|\_|\!|\~|\(|\)|\$|\@)))+(\/(((([a-z]|[A-Z])|[0-9])|(\-|\_|\!|\~|\(|\)|\$|\@)))+)*$/,
+
+    CHANNEL_NAME:     /^\/(((([a-z]|[A-Z])|[0-9])|(\-|\_|\!|\~|\(|\)|\$|\@)))+(\/(((([a-z]|[A-Z])|[0-9])|(\-|\_|\!|\~|\(|\)|\$|\@)))+)*$/,
+
+    WILD_CARD:     /^\*{1,2}$/,
+
+    CHANNEL_PATTERN:     /^(\/(((([a-z]|[A-Z])|[0-9])|(\-|\_|\!|\~|\(|\)|\$|\@)))+)*\/\*{1,2}$/,
+
+    VERSION_ELEMENT:     /^(([a-z]|[A-Z])|[0-9])(((([a-z]|[A-Z])|[0-9])|\-|\_))*$/,
+
+    VERSION:     /^([0-9])+(\.(([a-z]|[A-Z])|[0-9])(((([a-z]|[A-Z])|[0-9])|\-|\_))*)*$/,
+
+    CLIENT_ID:     /^((([a-z]|[A-Z])|[0-9]))+$/,
+
+    ID:     /^((([a-z]|[A-Z])|[0-9]))+$/,
+
+    ERROR_MESSAGE:     /^(((([a-z]|[A-Z])|[0-9])|(\-|\_|\!|\~|\(|\)|\$|\@)| |\/|\*|\.))*$/,
+
+    ERROR_ARGS:     /^(((([a-z]|[A-Z])|[0-9])|(\-|\_|\!|\~|\(|\)|\$|\@)| |\/|\*|\.))*(,(((([a-z]|[A-Z])|[0-9])|(\-|\_|\!|\~|\(|\)|\$|\@)| |\/|\*|\.))*)*$/,
+
+    ERROR_CODE:     /^[0-9][0-9][0-9]$/,
+
+    ERROR:     /^([0-9][0-9][0-9]:(((([a-z]|[A-Z])|[0-9])|(\-|\_|\!|\~|\(|\)|\$|\@)| |\/|\*|\.))*(,(((([a-z]|[A-Z])|[0-9])|(\-|\_|\!|\~|\(|\)|\$|\@)| |\/|\*|\.))*)*:(((([a-z]|[A-Z])|[0-9])|(\-|\_|\!|\~|\(|\)|\$|\@)| |\/|\*|\.))*|[0-9][0-9][0-9]::(((([a-z]|[A-Z])|[0-9])|(\-|\_|\!|\~|\(|\)|\$|\@)| |\/|\*|\.))*)$/
+
+  },
+  
+  commonElement: function(lista, listb) {
+    for (var i = 0, n = lista.length; i < n; i++) {
+      if (this.indexOf(listb, lista[i]) !== -1)
+        return lista[i];
+    }
+    return null;
+  },
+  
+  indexOf: function(list, needle) {
+    for (var i = 0, n = list.length; i < n; i++) {
+      if (list[i] === needle) return i;
+    }
+    return -1;
+  },
+  
+  each: function(object, callback, scope) {
+    if (object instanceof Array) {
+      for (var i = 0, n = object.length; i < n; i++) {
+        if (object[i] !== undefined)
+          callback.call(scope || null, object[i], i);
+      }
+    } else {
+      for (var key in object) {
+        if (object.hasOwnProperty(key))
+          callback.call(scope || null, key, object[key]);
+      }
+    }
+  },
+  
+  size: function(object) {
+    var size = 0;
+    this.each(object, function() { size += 1 });
+    return size;
+  },
+  
+  random: function() {
+    var field = Math.pow(2, this.ID_LENGTH);
+    return (Math.random() * field).toString(16).replace(/0*$/, '');
+  },
+  
+  enumEqual: function(actual, expected) {
+    if (expected instanceof Array) {
+      if (!(actual instanceof Array)) return false;
+      var i = actual.length;
+      if (i !== expected.length) return false;
+      while (i--) {
+        if (actual[i] !== expected[i]) return false;
+      }
+      return true;
+    } else {
+      if (!(actual instanceof Object)) return false;
+      if (this.size(expected) !== this.size(actual)) return false;
+      var result = true;
+      this.each(actual, function(key, value) {
+        result = result && (expected[key] === value);
+      });
+      return result;
+    }
+  }
+});
+
+
+Faye.Class = function(parent, methods) {
+  if (typeof parent !== 'function') {
+    methods = parent;
+    parent  = Object;
+  }
+  
+  var klass = function() {
+    if (!this.initialize) return this;
+    return this.initialize.apply(this, arguments) || this;
+  };
+  
+  var bridge = function() {};
+  bridge.prototype = parent.prototype;
+  
+  klass.prototype = new bridge();
+  Faye.extend(klass.prototype, methods);
+  
+  return klass;
+};
+
+
+Faye.Observable = {
+  on: function(eventType, block, scope) {
+    this._observers = this._observers || {};
+    var list = this._observers[eventType] = this._observers[eventType] || [];
+    list.push([block, scope]);
+  },
+  
+  stopObserving: function(eventType, block, scope) {
+    if (!this._observers || !this._observers[eventType]) return;
+    
+    if (!block) {
+      delete this._observers[eventType];
+      return;
+    }
+    var list = this._observers[eventType],
+        i    = list.length;
+    
+    while (i--) {
+      if (block && list[i][0] !== block) continue;
+      if (scope && list[i][1] !== scope) continue;
+      list.splice(i,1);
+    }
+  },
+  
+  fire: function() {
+    var args = Array.prototype.slice.call(arguments),
+        eventType = args.shift();
+    
+    if (!this._observers || !this._observers[eventType]) return;
+    
+    Faye.each(this._observers[eventType], function(listener) {
+      listener[0].apply(listener[1], args.slice());
+    });
+  }
+};
+
+
+Faye.Channel = Faye.Class({
+  initialize: function(name) {
+    this.__id = this._name = name;
+  },
+  
+  push: function(message) {
+    this.fire('message', message);
+  }
+});
+
+Faye.extend(Faye.Channel.prototype, Faye.Observable);
+
+Faye.extend(Faye.Channel, {
+  HANDSHAKE:    '/meta/handshake',
+  CONNECT:      '/meta/connect',
+  SUBSCRIBE:    '/meta/subscribe',
+  UNSUBSCRIBE:  '/meta/unsubscribe',
+  DISCONNECT:   '/meta/disconnect',
+  
+  META:         'meta',
+  SERVICE:      'service',
+  
+  isValid: function(name) {
+    return Faye.Grammar.CHANNEL_NAME.test(name) ||
+           Faye.Grammar.CHANNEL_PATTERN.test(name);
+  },
+  
+  parse: function(name) {
+    if (!this.isValid(name)) return null;
+    return name.split('/').slice(1);
+  },
+  
+  isMeta: function(name) {
+    var segments = this.parse(name);
+    return segments ? (segments[0] === this.META) : null;
+  },
+  
+  isService: function(name) {
+    var segments = this.parse(name);
+    return segments ? (segments[0] === this.SERVICE) : null;
+  },
+  
+  isSubscribable: function(name) {
+    if (!this.isValid(name)) return null;
+    return !this.isMeta(name) && !this.isService(name);
+  },
+  
+  Tree: Faye.Class({
+    initialize: function(value) {
+      this._value = value;
+      this._children = {};
+    },
+    
+    eachChild: function(block, context) {
+      Faye.each(this._children, function(key, subtree) {
+        block.call(context, key, subtree);
+      });
+    },
+    
+    each: function(prefix, block, context) {
+      this.eachChild(function(path, subtree) {
+        path = prefix.concat(path);
+        subtree.each(path, block, context);
+      });
+      if (this._value !== undefined) block.call(context, prefix, this._value);
+    },
+    
+    map: function(block, context) {
+      var result = [];
+      this.each([], function(path, value) {
+        result.push(block.call(context, path, value));
+      });
+      return result;
+    },
+    
+    get: function(name) {
+      var tree = this.traverse(name);
+      return tree ? tree._value : null;
+    },
+    
+    set: function(name, value) {
+      var subtree = this.traverse(name, true);
+      if (subtree) subtree._value = value;
+    },
+    
+    traverse: function(path, createIfAbsent) {
+      if (typeof path === 'string') path = Faye.Channel.parse(path);
+      
+      if (path === null) return null;
+      if (path.length === 0) return this;
+      
+      var subtree = this._children[path[0]];
+      if (!subtree && !createIfAbsent) return null;
+      if (!subtree) subtree = this._children[path[0]] = new Faye.Channel.Tree();
+      
+      return subtree.traverse(path.slice(1), createIfAbsent);
+    },
+    
+    findOrCreate: function(channel) {
+      var existing = this.get(channel);
+      if (existing) return existing;
+      existing = new Faye.Channel(channel);
+      this.set(channel, existing);
+      return existing;
+    },
+    
+    glob: function(path) {
+      if (typeof path === 'string') path = Faye.Channel.parse(path);
+      
+      if (path === null) return [];
+      if (path.length === 0) return (this._value === undefined) ? [] : [this._value];
+      
+      var list = [];
+      
+      if (Faye.enumEqual(path, ['*'])) {
+        Faye.each(this._children, function(key, subtree) {
+          if (subtree._value !== undefined) list.push(subtree._value);
+        });
+        return list;
+      }
+      
+      if (Faye.enumEqual(path, ['**'])) {
+        list = this.map(function(key, value) { return value });
+        list.pop();
+        return list;
+      }
+      
+      Faye.each(this._children, function(key, subtree) {
+        if (key !== path[0] && key !== '*') return;
+        var sublist = subtree.glob(path.slice(1));
+        Faye.each(sublist, function(channel) { list.push(channel) });
+      });
+      
+      if (this._children['**']) list.push(this._children['**']._value);
+      return list;
+    }
+    
+    /**
+      Tests
+      
+      glob = new Faye.Channel.Tree();
+      list = '/foo/bar /foo/boo /foo /foobar /foo/bar/boo /foobar/boo /foo/* /foo/**'.split(' ');
+
+      Faye.each(list, function(c, i) {
+          glob.set(c, i + 1);
+      });
+
+      console.log(glob.glob('/foo/*').sort());        // 1,2,7,8
+      console.log(glob.glob('/foo/bar').sort());      // 1,7,8
+      console.log(glob.glob('/foo/**').sort());       // 1,2,5,7,8
+      console.log(glob.glob('/foo/bar/boo').sort());  // 5,8
+    **/
+  })
+});
+
+
+Faye.Set = Faye.Class({
+  initialize: function() {
+    this._index = {};
+  },
+  
+  add: function(item) {
+    var key = (item.__id !== undefined) ? item.__id : item;
+    if (this._index.hasOwnProperty(key)) return false;
+    this._index[key] = item;
+    return true;
+  },
+  
+  forEach: function(block, scope) {
+    for (var key in this._index) {
+      if (this._index.hasOwnProperty(key))
+        block.call(scope, this._index[key]);
+    }
+  },
+  
+  isEmpty: function() {
+    for (var key in this._index) {
+      if (this._index.hasOwnProperty(key)) return false;
+    }
+    return true;
+  },
+  
+  member: function(item) {
+    for (var key in this._index) {
+      if (this._index[key] === item) return true;
+    }
+    return false;
+  },
+  
+  remove: function(item) {
+    var key = (item.__id !== undefined) ? item.__id : item;
+    delete this._index[key];
+  },
+  
+  toArray: function() {
+    var array = [];
+    this.forEach(function(item) { array.push(item) });
+    return array;
+  }
+});
+
+
+Faye.Server = Faye.Class({
+  initialize: function(options) {
+    this._options  = options || {};
+    this._channels = new Faye.Channel.Tree();
+    this._clients  = {};
+  },
+  
+  clientIds: function() {
+    var ids = [];
+    Faye.each(this._clients, function(key, value) { ids.push(key) });
+    return ids;
+  },
+  
+  process: function(messages, local, callback) {
+    messages = (messages instanceof Array) ? messages : [messages];
+    var processed = 0, responses = [];
+    
+    Faye.each(messages, function(message) {
+      this._handle(message, local, function(reply) {
+        responses = responses.concat(reply);
+        processed += 1;
+        if (processed === messages.length) callback(responses);
+      });
+    }, this);
+  },
+  
+  flushConnection: function(messages) {
+    messages = (messages instanceof Array) ? messages : [messages];
+    Faye.each(messages, function(message) {
+      var client = this._clients[message.clientId];
+      if (client) client.flush();
+    }, this);
+  },
+  
+  _generateId: function() {
+    var id = Faye.random();
+    while (this._clients.hasOwnProperty(id)) id = Faye.random();
+    return this._connection(id).id;
+  },
+  
+  _connection: function(id) {
+    if (this._clients.hasOwnProperty(id)) return this._clients[id];
+    var client = new Faye.Connection(id, this._options);
+    client.on('stale', this._destroyClient, this);
+    return this._clients[id] = client;
+  },
+  
+  _destroyClient: function(client) {
+    client.disconnect();
+    client.stopObserving('stale', this._destroyClient, this);
+    delete this._clients[client.id];
+  },
+  
+  _handle: function(message, local, callback) {
+    var clientId = message.clientId,
+        channel  = message.channel,
+        response;
+    
+    if (Faye.Channel.isMeta(channel)) {
+      response = this[Faye.Channel.parse(channel)[1]](message, local);
+      
+      clientId = clientId || response.clientId;
+      response.advice = response.advice || {};
+      Faye.extend(response.advice, {
+        reconnect:  this._clients.hasOwnProperty(clientId) ? 'retry' : 'handshake',
+        interval:   Faye.Connection.INTERVAL * 1000
+      }, false);
+      
+      response.id = message.id;
+      
+      if (response.channel !== Faye.Channel.CONNECT ||
+          response.successful !== true)
+        return callback(response);
+      
+      return this._connection(response.clientId).connect(function(events) {
+        Faye.each(events, function(e) { delete e.__id });
+        callback([response].concat(events));
+      });
+    }
+    
+    if (!message.clientId || Faye.Channel.isService(channel))
+      return callback([]);
+    
+    message.__id = Faye.random();
+    Faye.each(this._channels.glob(channel), function(c) { c.push(message) });
+    
+    callback( { channel:      channel,
+                successful:   true,
+                id:           message.id  } );
+  },
+  
+  handshake: function(message, local) {
+    var response = { channel:   Faye.Channel.HANDSHAKE,
+                     version:   Faye.BAYEUX_VERSION,
+                     supportedConnectionTypes: Faye.CONNECTION_TYPES,
+                     id:        message.id };
+    
+    if (!message.version)
+      response.error = Faye.Error.parameterMissing('version');
+    
+    var clientConns = message.supportedConnectionTypes,
+        commonConns;
+    
+    if (clientConns) {
+      commonConns = clientConns.filter(function(conn) {
+        return Faye.CONNECTION_TYPES.indexOf(conn) !== -1;
+      });
+      if (commonConns.length === 0)
+        response.error = Faye.Error.conntypeMismatch(clientConns);
+    } else {
+      response.error = Faye.Error.parameterMissing('supportedConnectionTypes');
+    }
+    
+    response.successful = !response.error;
+    if (!response.successful) return response;
+    
+    response.clientId = this._generateId();
+    return response;
+  },
+  
+  connect: function(message, local) {
+    var response = { channel:   Faye.Channel.CONNECT,
+                     id:        message.id };
+    
+    var clientId = message.clientId,
+        client   = clientId ? this._clients[clientId] : null,
+        connectionType = message.connectionType;
+    
+    if (!client)         response.error = Faye.Error.clientUnknown(clientId);
+    if (!clientId)       response.error = Faye.Error.parameterMissing('clientId');
+    if (!connectionType) response.error = Faye.Error.parameterMissing('connectionType');
+    
+    response.successful = !response.error;
+    if (!response.successful) return response;
+    
+    response.clientId = client.id;
+    return response;
+  },
+  
+  disconnect: function(message, local) {
+    var response = { channel:   Faye.Channel.DISCONNECT,
+                     id:        message.id };
+    
+    var clientId = message.clientId,
+        client   = clientId ? this._clients[clientId] : null;
+    
+    if (!client)   response.error = Faye.Error.clientUnknown(clientId);
+    if (!clientId) response.error = Faye.Error.parameterMissing('clientId');
+    
+    response.successful = !response.error;
+    if (!response.successful) return response;
+    
+    this._destroyClient(client);
+    
+    response.clientId = clientId;
+    return response;
+  },
+  
+  subscribe: function(message, local) {
+    var response     = { channel:   Faye.Channel.SUBSCRIBE,
+                         clientId:  message.clientId,
+                         id:        message.id };
+    
+    var clientId     = message.clientId,
+        client       = clientId ? this._clients[clientId] : null,
+        subscription = message.subscription;
+    
+    subscription = (subscription instanceof Array) ? subscription : [subscription];
+    
+    if (!client)               response.error = Faye.Error.clientUnknown(clientId);
+    if (!clientId)             response.error = Faye.Error.parameterMissing('clientId');
+    if (!message.subscription) response.error = Faye.Error.parameterMissing('subscription');
+    
+    response.subscription = subscription;
+    
+    Faye.each(subscription, function(channel) {
+      if (response.error) return;
+      if (!Faye.Channel.isSubscribable(channel)) response.error = Faye.Error.channelForbidden(channel);
+      if (!Faye.Channel.isValid(channel))        response.error = Faye.Error.channelInvalid(channel);
+      
+      if (response.error) return;
+      channel = this._channels.findOrCreate(channel);
+      client.subscribe(channel);
+    }, this);
+    
+    response.successful = !response.error;
+    return response;
+  },
+  
+  unsubscribe: function(message, local) {
+    var response     = { channel:   Faye.Channel.UNSUBSCRIBE,
+                         clientId:  message.clientId,
+                         id:        message.id };
+    
+    var clientId     = message.clientId,
+        client       = clientId ? this._clients[clientId] : null,
+        subscription = message.subscription;
+    
+    subscription = (subscription instanceof Array) ? subscription : [subscription];
+    
+    if (!client)               response.error = Faye.Error.clientUnknown(clientId);
+    if (!clientId)             response.error = Faye.Error.parameterMissing('clientId');
+    if (!message.subscription) response.error = Faye.Error.parameterMissing('subscription');
+    
+    Faye.each(subscription, function(channel) {
+      if (response.error) return;
+      
+      if (!Faye.Channel.isValid(channel))
+        return response.error = Faye.Error.channelInvalid(channel);
+      
+      channel = this._channels.get(channel);
+      if (channel) client.unsubscribe(channel);
+    }, this);
+    
+    response.successful = !response.error;
+    return response;
+  }
+});
+
+
+Faye.Connection = Faye.Class({
+  initialize: function(id, options) {
+    this.id         = id;
+    this._options   = options;
+    this._observers = {};
+    this._channels  = new Faye.Set();
+    this._inbox     = new Faye.Set();
+  },
+  
+  timeout: function() {
+    return this._options.timeout || Faye.Connection.TIMEOUT;
+  },
+  
+  _onMessage: function(event) {
+    this._inbox.add(event);
+    this._beginDeliveryTimeout();
+  },
+  
+  subscribe: function(channel) {
+    if (!this._channels.add(channel)) return;
+    channel.on('message', this._onMessage, this);
+  },
+  
+  unsubscribe: function(channel) {
+    if (channel === 'all') return this._channels.forEach(this.unsubscribe, this);
+    if (!this._channels.member(channel)) return;
+    this._channels.remove(channel);
+    channel.stopObserving('message', this._onMessage, this);
+  },
+  
+  connect: function(callback) {
+    this.on('flush', callback);
+    if (this._connected) return;
+    
+    this._markForDeletion = false;
+    this._connected       = true;
+    
+    if (!this._inbox.isEmpty()) this._beginDeliveryTimeout();
+    this._beginConnectionTimeout();
+  },
+  
+  flush: function() {
+    if (!this._connected) return;
+    this._releaseConnection();
+    
+    var events = this._inbox.toArray();
+    this._inbox = new Faye.Set();
+    
+    this.fire('flush', events);
+    this.stopObserving('flush');
+  },
+  
+  disconnect: function() {
+    this.unsubscribe('all');
+    this.flush();
+  },
+  
+  _beginDeliveryTimeout: function() {
+    if (this._deliveryTimeout || !this._connected || this._inbox.isEmpty())
+      return;
+    
+    var self = this;
+    this._deliveryTimeout = setTimeout(function () { self.flush() },
+                                       Faye.Connection.MAX_DELAY * 1000);
+  },
+  
+  _beginConnectionTimeout: function() {
+    if (this._connectionTimeout || !this._connected)
+      return;
+    
+    var self = this;
+    this._connectionTimeout = setTimeout(function() { self.flush() },
+                                         this.timeout() * 1000);
+  },
+  
+  _releaseConnection: function() {
+    if (this._connectionTimeout) {
+      clearTimeout(this._connectionTimeout);
+      delete this._connectionTimeout;
+    }
+    
+    if (this._deliveryTimeout) {
+      clearTimeout(this._deliveryTimeout);
+      delete this._deliveryTimeout;
+    }
+    
+    this._connected = false;
+    this._scheduleForDeletion();
+  },
+  
+  _scheduleForDeletion: function() {
+    if (this._markForDeletion) return;
+    this._markForDeletion = true;
+    var self = this;
+    
+    setTimeout(function() {
+      if (!self._markForDeletion) return;
+      self.fire('stale', self);
+    }, 10000 * Faye.Connection.INTERVAL);
+  }
+});
+
+Faye.extend(Faye.Connection.prototype, Faye.Observable);
+
+Faye.extend(Faye.Connection, {
+  MAX_DELAY:  0.1,
+  INTERVAL:   1.0,
+  TIMEOUT:    60.0
+});
+
+
+Faye.Error = Faye.Class({
+  initialize: function(code, args, message) {
+    this.code    = code;
+    this.args    = Array.prototype.slice.call(args);
+    this.message = message;
+  },
+  
+  toString: function() {
+    return this.code + ':' +
+           this.args.join(',') + ':' +
+           this.message;
+  }
+});
+
+
+Faye.Error.versionMismatch = function() {
+  return new this(300, arguments, "Version mismatch").toString();
+};
+
+Faye.Error.conntypeMismatch = function() {
+  return new this(301, arguments, "Connection types not supported").toString();
+};
+
+Faye.Error.extMismatch = function() {
+  return new this(302, arguments, "Extension mismatch").toString();
+};
+
+Faye.Error.badRequest = function() {
+  return new this(400, arguments, "Bad request").toString();
+};
+
+Faye.Error.clientUnknown = function() {
+  return new this(401, arguments, "Unknown client").toString();
+};
+
+Faye.Error.parameterMissing = function() {
+  return new this(402, arguments, "Missing required parameter").toString();
+};
+
+Faye.Error.channelForbidden = function() {
+  return new this(403, arguments, "Forbidden channel").toString();
+};
+
+Faye.Error.channelUnknown = function() {
+  return new this(404, arguments, "Unknown channel").toString();
+};
+
+Faye.Error.channelInvalid = function() {
+  return new this(405, arguments, "Invalid channel").toString();
+};
+
+Faye.Error.extUnknown = function() {
+  return new this(406, arguments, "Unknown extension").toString();
+};
+
+Faye.Error.publishFailed = function() {
+  return new this(407, arguments, "Failed to publish").toString();
+};
+
+Faye.Error.serverError = function() {
+  return new this(500, arguments, "Internal server error").toString();
+};
+
+
+
+var path  = require('path'),
+    posix = require('posix'),
+    sys   = require('sys'),
+    url   = require('url'),
+    querystring = require('querystring');
+
+Faye.NodeAdapter = Faye.Class({
+  initialize: function(options) {
+    this._options  = options || {};
+    this._endpoint = this._options.mount || Faye.NodeAdapter.DEFAULT_ENDPOINT;
+    this._script   = this._endpoint + '.js';
+    this._server   = new Faye.Server(this._options);
+  },
+  
+  call: function(request, response) {
+    var requestUrl = url.parse(request.url, true);
+    switch (requestUrl.pathname) {
+      
+      case this._endpoint:
+        var isGet = (request.method === 'GET'),
+            self  = this;
+        
+        if (isGet)
+          this._callWithParams(request, response, requestUrl.query);
+        
+        else
+          request.addListener('body', function(chunk) {
+            self._callWithParams(request, response, querystring.parse(chunk));
+          });
+        
+        return true;
+        break;
+      
+      case this._script:
+        posix.cat(Faye.NodeAdapter.SCRIPT_PATH).addCallback(function(content) {
+          response.sendHeader(200, Faye.NodeAdapter.TYPE_SCRIPT);
+          response.sendBody(content);
+          response.finish();
+        });
+        return true;
+        break;
+      
+      default: return false;
+    }
+  },
+  
+  _callWithParams: function(request, response, params) {
+    try {
+      var message = JSON.parse(params.message),
+          jsonp   = params.jsonp || Faye.JSONP_CALLBACK,
+          isGet   = (request.method === 'GET'),
+          type    = isGet ? Faye.NodeAdapter.TYPE_SCRIPT : Faye.NodeAdapter.TYPE_JSON;
+      
+      if (isGet) this._server.flushConnection(message);
+      
+      this._server.process(message, false, function(replies) {
+        var body = JSON.stringify(replies);
+        if (isGet) body = jsonp + '(' + body + ');';
+        response.sendHeader(200, type);
+        response.sendBody(body);
+        response.finish();
+      });
+    } catch (e) {
+      response.sendHeader(400, {'Content-Type': 'text/plain'});
+      response.sendBody('Bad request');
+      response.finish();
+    }
+  }
+});
+
+Faye.extend(Faye.NodeAdapter, {
+  DEFAULT_ENDPOINT: '/bayeux',
+  SCRIPT_PATH:      path.dirname(__filename) + '/faye-client-min.js',
+  
+  TYPE_JSON:    {'Content-Type': 'text/json'},
+  TYPE_SCRIPT:  {'Content-Type': 'text/javascript'},
+  TYPE_TEXT:    {'Content-Type': 'text/plain'}
+});
+
+exports.NodeAdapter = Faye.NodeAdapter;