simpleddp-plugin-login (SimpleDDP Meteor.Accounts Login Plugin)

This is plugin for simpleDDP js library.
Use it to authenticate with any Meteor.Accounts login provider (also custom).

Version 4.0.2

Plugin is for simpleDDP >= 2.2.4
For previous versions see.

Install

npm install simpleddp-plugin-login --save

Usage

Extends simpleDDP instance.

``javascript
const simpleDDP = require("simpleddp");
const simpleDDPLogin = require("simpleddp-plugin-login").simpleDDPLogin;

let opts = {
endpoint: "ws://someserver.com/websocket",
SocketConstructor: WebSocket,
reconnectInterval: 5000
};
const server = new simpleDDP(opts,[simpleDDPLogin]);
`

Adds events (login, logout, loginResume, loginSessionLost, loginResumeFailed),methods (login, logout) and userId property
which is undefined when user is not logged in or is equal to user.\_id when user is logged in.
Also token property when user is logged in.
Plugin automatically resumes authentication if connection with server was lost and then restored back.

$3

Call this method to login with any Meteor.Accounts login provider.

#### Returns

A Promise which resolves to the object with userId of the logged in user when the login succeeds, or rejects when it fails.

#### Example for Accounts Password

`javascript
server.userId; // undefined, we are not logged in

let password = "somepassword";
let username = "admin";
let email = "admin@admin";

// you must pass password and at least one of username or email
let userAuth = await server.login({
password,
user: {
username,
email
}
});

// userAuth will be something like this
// { id: 'd6PqCAKk2QZeqZHWy',
// token: 'N50Gmknk__geP63YD9pHKdl07b8XXxNGpB_cz5Lte4d',
// tokenExpires: { '$date': 1548525528846 },
// type: 'password' }

server.userId; // now equals to 'd6PqCAKk2QZeqZHWy'
server.token; // now equals to 'N50Gmknk__geP63YD9pHKdl07b8XXxNGpB_cz5Lte4d'
`

$3

Call this method to logout.

#### Returns

A Promise which resolves to undefined when the logout succeeds, or rejects when it fails.

#### Example

`javascript
await server.logout();
`

$3

`javascript
server.on('login',(m)=>{
console.log('User logged in as', m);
});

server.on('logout',()=>{
console.log('User logged out');
});

server.on('loginSessionLost',(id=>{
console.log(User {id} lost connection to server, will auto resume by default with token);
});

server.on('loginResume',(m)=>{
console.log('User resumed (logged in by token)', m);
});

server.on('loginResumeFailed',(m)=>{
console.log('Failed to resume authorization with token after reconnection ', m);
});
``