w3gram

W3gram Server

This is a node.js server for the W3gram push notification protocol.

The server was designed to be deployed to Heroku using free resources, so it fits in a single dyno. The code has great test coverage using mocha.

Easy Setup

Click the ''Deploy to Heroku'' button at the top of this page to create your own W3gram server running on Heroku. Don't worry, the project only uses free add-ons!

Get your server's MAK and store it somewhere safely.

curl -i https://w3gram-test.herokuapp.com/mak

# Response example:
# { "mak": "3LwwhZCuqPxO_0fNATuZbOxRgXjWuCLXzOzVaH5dZ4k" }

Create an application and note its API key and secret.

curl -i -X POST -H 'Content-Type: application/json' \
  -d '{"mak": "3LwwhZCuqPxO_0fNATuZbOxRgXjWuCLXzOzVaH5dZ4k", "app": { "name": "Testing", "origin": "*"}}' \
  https://w3gram-test.herokuapp.com/apps

# Response example:
# {
#    "key":"MYp4g89u3OafCtZP",
#    "secret":"z7zlLM44rFWQzmgXZX0d2r7rX9mdAP7Gg56V6YjFscY",
#    "origin":"*",
#    "name":"Testing"
# }

Manual Interaction Example

Create a token for a device ID.

echo -n "device-id|my-tablet" | \
    openssl dgst -sha256 -hmac "z7zlLM44rFWQzmgXZX0d2r7rX9mdAP7Gg56V6YjFscY" \
    -binary | base64

# Response example:
# Xm3U6AU4qj7z5axtldHsNvhHqlsLdMRKQQbXoiFhmDU

Do the routing step.

curl -i -X POST -H 'Content-Type: application/json' \
    -d '{"app": "MYp4g89u3OafCtZP", "device": "my-tablet", "token": "Xm3U6AU4qj7z5axtldHsNvhHqlsLdMRKQQbXoiFhmDU"}' \
    https://w3gram-test.herokuapp.com/route

# Response example:
# {
#    "receiverId":"2.my-tablet.Wk3Lgc_dy0wu8smU7vHhL-Z2oDhkcF6V3Fj3O1ta2a4",
#    "push":"https://w3gram-test.herokuapp.com/push",
#    "listen":"wss://w3gram-test.herokuapp.com/ws/2.my-tablet.Wk3Lgc_dy0wu8smU7vHhL-Z2oDhkcF6V3Fj3O1ta2a4"
# }

Start a WebSocket connection:

wscat -c "wss://w3gram-test.herokuapp.com/ws/2.my-tablet.Wk3Lgc_dy0wu8smU7vHhL-Z2oDhkcF6V3Fj3O1ta2a4"

Send a notification:

curl -i -X POST -H 'Content-Type: application/json' \
    -d '{"receiver": "2.my-tablet.Wk3Lgc_dy0wu8smU7vHhL-Z2oDhkcF6V3Fj3O1ta2a4", "message": { "data": "Hello push world" } }' \
    https://w3gram-test.herokuapp.com/push

Development Setup

Install all dependencies and create PostgreSQL database for development and testing.

npm install
createdb w3gram_test
createdb w3gram_dev

Run the server in developmentm mode.

npm start

License

This project is Copyright (c) 2014 Victor Costan, and distributed under the MIT License.