Home

Welcome to the iwebpp.io wiki!

iwebpp.io - iWebPP name-client to deliver Peer/P2P Web Service with Node.js.

http://www.peerweb.cn

Install:

1. install iwebpp.io module by npm install iwebpp.io

2. iwebpp.io will include node-httpp binary in bin directory, that supports 32/64bits linux/windows/osx. if the binary didn’t work, you can build it from source - https://github.com/InstantWebP2P/node-httpp.git

Usage/API:

1. create iWebPP client

   var WEBPP = require('iwebpp.io');
   var nmcln = new WEBPP({
     usrinfo: {domain: '51dese.com', usrkey: 'dese'}, // fill usrkey. And, 51dese.com is only useful domain by now
   });
   nmcln.on('ready', function(){
     console.log('iwebpp.io ready with vURL:'+nmcln.vurl);
     // ...
   });

2. hook your node.js web server in peer. Websocket server is supported with wspp module as well. notes: Please mount your web server in path prefix as nmcln.vpath below is express App example. file peerweb.js.

   var express = require('express');
   var WebSocket = require('wspp');
   var WebSocketServer = WebSocket.Server;
   var WEBPP = require('iwebpp.io');
   var nmcln = new WEBPP({
     usrinfo: {domain: '51dese.com', usrkey: 'dese'}, // fill your usrkey. And, 51dese.com is only useful domain by now
   });
   nmcln.on('ready', function(){
     // 2.1
     // create your express App
     var app = express();
     app.use(express.directory(__dirname + '/public'));
     app.use(express.static(__dirname + '/public'));
     app.use(function(req, res){
         res.end('invalid path');
     });
     // hook app on business server and mount on vPath
     var shell = express(); // create express shell app to mount on vPath
     shell.use(nmcln.vpath, app);
     nmcln.bsrv.srv.on('request', shell);
     console.log('Now access your web server via URL:'+nmcln.vurl);
     // 2.2
     // create your websocket server
     // notes: please always pass vPath as path option prefix of Websocket server
     var wss = new WebSocketServer({httpp: true, server: nmcln.bsrv.srv, path: nmcln.vpath//+your custom path});
     wss.on('connection', function(client){
       console.log('new ws connection');
     });
     console.log('Now connect to your websocket server via URL:'+nmcln.vurl);
   });

3. launch your web server by bin/win32/node.exe peerweb.js in Windows32 machine.

More demos:

Look at ./demos directory

TODO:

1. user authentication

2. domain authorization

3. enable STUN