Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

An implementation of the Google Wave Gadget API using Node and websockets

branch: master

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 client
Octocat-spinner-32 examples
Octocat-spinner-32 lib
Octocat-spinner-32 .npmignore
Octocat-spinner-32 LICENSE
Octocat-spinner-32 README.md
Octocat-spinner-32 package.json
README.md

Wave-Node

This is an implementation of the Google Wave Gadget API using Node.js, Socket.io, and Redis.

It uses diff-match-patch to synchronize states across multiple instances: clients send patches to the server, which then propagates the patches to other clients which apply the patches to their local state model. So no matter how big the state model becomes, each update event is quite small.

Installation

Install Wave using NPM with:

$ npm install wave

Creating a Wave server

To create a Wave server instance, attach it to a http server instance as follows:

var server = http.createServer(function(req, res){ 
  res.writeHead(200, {'Content-Type': 'text/html'}); 
  res.end('<h1>Wave Gadget API Server</h1>');   
});
var wave = require('wave').Server;
wave.attach(server);
server.listen(8000, "127.0.0.1");

Note that you must have Redis running.

Setting Redis options

You can set various options for redis by passing a map of options to the attach() method, e.g.:

wave.attach(server, {"host":"127.0.0.1", "port":"6379", "clear":true});

The "clear" option, when set true, clears out all existing states. Other valid options are "host", "port", and any standard Redis configuration options you can pass to node_redis using redis.createClient(). See node-redis for more information.

Running the examples

To run the examples, you need to start your Redis server, and start a new Wave server using:

$ node examples/server/server.js

You can then run the examples by opening examples/index.htm in a browser and following the instructions on the page.

Client API

Each page or widget wanting to use the service needs to import the following JavaScript files:

diff_match_patch.js
json2.js
socket.io.js
wave.js

These can all be found in the "client" folder; you can also load the current socket.io.js client from the server itself (e.g. http://localhost:8081/socket.io/socket.io.js)

In addition you need to call the following methods in your own scripts after importing the wave.js library:

wave.setSharedDataKey(key) : this is the "context identifier" for the pages/widgets that will share state.
wave.setViewer(id, name, icon src) : this is the current user's information

For example:

wave.setSharedDataKey("SPACE1");
wave.setViewer("mindyourownbusiness","alice","smileys/rabbit.png");

When both have been set, your page/widget will handshake with the server.

You can then use the Wave Gadget API as described at: http://code.google.com/apis/wave/extensions/gadgets/guide.html

Notes

Note that private states are not supported yet, nor are getHost() or state.clear().

Something went wrong with that request. Please try again.