Gutenberg Collaborative Editing Plugin

Based on WebRTC

Installation

npm install

Building

npm run build

Local Server

npm start

Testing

npm test

Starting App

Peer starting collaboration has to generate a uuid using

var grtcID = GRTC.uuid(); // static function

After that pass that to GRTC module

window.history.pushState('', '', '#' + grtcID); // optional to add to url so can share with others.
var grtc = new GRTC(grtcID, window.location.origin,  true); // 3rd param is transport layer for encrypted session.

Peer not starting collaboration has to join and get that grtcID somehow possibly by sharing url

API

Events

• 'peerFound'
• Checked via long polling to /get/grtcID route to server

grtc.on('peerFound', function(peer){
  // peer => peer signal used for connection establishment
});

• 'peerSignal'
• Received from other peer as offer.

grtc.on('peerSignal', function(signal){
  // signal => signal that is received from another peer.
});

• 'peerConnected'
• Emitted after peerSignal and connection is established.

grtc.on('peerConnected', function(){
  // peer is connected.
});

• 'peerData'
• when data is received.

grtc.on('peerData', function(data){
  //data is always json stringified
});

Miscellaneous Events

• 'publicKey'
• when other peer publicKey is fetched.

grtc.on('publicKey', function(pubKey){
  //pubKey => encrypt shared token using this and send that to peer.
});

• 'peerSecret'
• when you received secret encrypted using your public key

grtc.on('peerSecret', function(secret){
  //secret => its decrypted using your private key.
});

• 'secretAck'
• this is ack when peer reply to initiator that secret is received.

grtc.on('secretAck', function(){
  
});

• 'transport'
• this is emitted on both initiator and peers that transport layer is ready to use.

grtc.on('transport', function(){
  // you can call grtc.secureSend('something') function
});

Data Format

Payload should always be JSON object which can be sent directly using grtc.send without stringify