Pulled from https://github.com/50ButtonsEach/flic-hub-sdk-mqtt-js Referenced by https://community.flic.io/topic/18233/release-of-mqtt-client?lang=en-US
580 lines
17 KiB
JavaScript
580 lines
17 KiB
JavaScript
/* Copyright (c) 2013 Gordon Williams, Pur3 Ltd
|
|
|
|
------------------------------------------------------------------------------
|
|
|
|
All sections of code within this repository are licensed under an MIT License:
|
|
|
|
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
of this software and associated documentation files (the "Software"), to deal
|
|
in the Software without restriction, including without limitation the rights
|
|
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
copies of the Software, and to permit persons to whom the Software is
|
|
furnished to do so, subject to the following conditions:
|
|
|
|
The above copyright notice and this permission notice shall be included in
|
|
all copies or substantial portions of the Software.
|
|
|
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
|
THE SOFTWARE.
|
|
|
|
-----------------------------------------------------------------------------
|
|
|
|
Modified by Flic Shortcut Labs.
|
|
|
|
*/
|
|
|
|
/** 'private' constants */
|
|
var C = {
|
|
PROTOCOL_LEVEL: 4, // MQTT protocol level
|
|
DEF_PORT : 1883, // MQTT default server port
|
|
DEF_KEEP_ALIVE: 60 // Default keep_alive (s)
|
|
};
|
|
|
|
/** Control packet types */
|
|
var TYPE = {
|
|
CONNECT : 1,
|
|
CONNACK : 2,
|
|
PUBLISH : 3,
|
|
PUBACK : 4,
|
|
PUBREC : 5,
|
|
PUBREL : 6,
|
|
PUBCOMP : 7,
|
|
SUBSCRIBE : 8,
|
|
SUBACK : 9,
|
|
UNSUBSCRIBE: 10,
|
|
UNSUBACK : 11,
|
|
PINGREQ : 12,
|
|
PINGRESP : 13,
|
|
DISCONNECT : 14
|
|
};
|
|
|
|
var pakId = Math.floor(Math.random() * 65534);
|
|
|
|
Uint8Array.prototype.charCodeAt = function(a,b) {
|
|
return this.toString().charCodeAt(a,b);
|
|
}
|
|
|
|
/**
|
|
Return Codes
|
|
http://docs.oasis-open.org/mqtt/mqtt/v3.1.1/os/mqtt-v3.1.1-os.html#_Toc385349256
|
|
**/
|
|
var RETURN_CODES = {
|
|
0: 'ACCEPTED',
|
|
1: 'UNACCEPTABLE_PROTOCOL_VERSION',
|
|
2: 'IDENTIFIER_REJECTED',
|
|
3: 'SERVER_UNAVAILABLE',
|
|
4: 'BAD_USER_NAME_OR_PASSWORD',
|
|
5: 'NOT_AUTHORIZED'
|
|
};
|
|
|
|
/** MQTT constructor */
|
|
function MQTT(server, options) {
|
|
this.server = server;
|
|
options = options || {};
|
|
this.port = options.port || C.DEF_PORT;
|
|
this.client_id = options.client_id || mqttUid();
|
|
this.keep_alive = options.keep_alive || C.DEF_KEEP_ALIVE;
|
|
this.clean_session = options.clean_session || true;
|
|
this.username = options.username;
|
|
this.password = options.password;
|
|
this.client = false;
|
|
this.connected = false;
|
|
/* if keep_alive is less than the ping interval we need to use
|
|
a shorter ping interval, otherwise we'll just time out! */
|
|
this.ping_interval =
|
|
this.keep_alive < this.C.PING_INTERVAL ? (this.keep_alive - 5) : this.C.PING_INTERVAL;
|
|
this.protocol_name = options.protocol_name || "MQTT";
|
|
this.protocol_level = (options.protocol_level || C.PROTOCOL_LEVEL);
|
|
|
|
if (typeof this.client_id == 'string') {
|
|
var payloadarray =[this.client_id.length >> 8, this.client_id.length & 255];
|
|
var i = 2;
|
|
var messagearray = this.client_id.split('');
|
|
for (var j = 0; j < this.client_id.length; j++) {
|
|
var char = messagearray[j];
|
|
var numberrepres = char.charCodeAt(0);
|
|
payloadarray[i] = numberrepres;
|
|
i = i + 1;
|
|
}
|
|
this.client_id = payloadarray;
|
|
}
|
|
if (this.password) {
|
|
var payloadarray =[this.password.length >> 8, this.password.length & 255];
|
|
var i = 2;
|
|
var messagearray = this.password.split('');
|
|
for (var j = 0; j < this.password.length; j++) {
|
|
var char = messagearray[j];
|
|
var numberrepres = char.charCodeAt(0);
|
|
payloadarray[i] = numberrepres;
|
|
i = i + 1;
|
|
}
|
|
this.password = payloadarray;
|
|
}
|
|
if (this.username) {
|
|
var payloadarray =[this.username.length >> 8, this.username.length & 255];
|
|
var i = 2;
|
|
var messagearray = this.username.split('');
|
|
for (var j = 0; j < this.username.length; j++) {
|
|
var char = messagearray[j];
|
|
var numberrepres = char.charCodeAt(0);
|
|
payloadarray[i] = numberrepres;
|
|
i = i + 1;
|
|
}
|
|
this.username = payloadarray;
|
|
}
|
|
}
|
|
|
|
var __listeners = {};
|
|
|
|
Object.prototype.on = function(type, fn) {
|
|
if (!__listeners[type]) {
|
|
__listeners[type] = [];
|
|
}
|
|
__listeners[type].push(fn);
|
|
}
|
|
|
|
Object.prototype.emit = function (type, data) {
|
|
if (__listeners[type]) {
|
|
__listeners[type].map(function (fn) {
|
|
fn(data);
|
|
});
|
|
}
|
|
}
|
|
|
|
if (!Buffer.from) {
|
|
Buffer.from = function(a) {
|
|
return new Buffer(a);
|
|
}
|
|
}
|
|
|
|
/** 'public' constants here */
|
|
MQTT.prototype.C = {
|
|
DEF_QOS : 0, // Default QOS level
|
|
CONNECT_TIMEOUT: 10000, // Time (ms) to wait for CONNACK
|
|
PING_INTERVAL : 40 // Server ping interval (s)
|
|
};
|
|
|
|
/* Utility functions ***************************/
|
|
|
|
var fromCharCode = String.fromCharCode;
|
|
|
|
/** MQTT string (length MSB, LSB + data) */
|
|
function mqttStr(s) {
|
|
var payloadarray =[s.length >> 8, s.length & 255];
|
|
var i = 2;
|
|
var messagearray = s.split('');
|
|
for (var j = 0; j < s.length; j++) {
|
|
var char = messagearray[j];
|
|
var numberrepres = char.charCodeAt(0);
|
|
payloadarray[i] = numberrepres;
|
|
i = i + 1;
|
|
}
|
|
|
|
return payloadarray;
|
|
}
|
|
|
|
|
|
/** MQTT packet length formatter - algorithm from reference docs */
|
|
function mqttPacketLength(length) {
|
|
var encLength = [];
|
|
var i = 0;
|
|
do {
|
|
var encByte = length & 127;
|
|
length = length >> 7;
|
|
// if there are more data to encode, set the top bit of this byte
|
|
if (length > 0) {
|
|
encByte += 128;
|
|
}
|
|
encLength[i] = encByte;
|
|
i++;
|
|
} while (length > 0);
|
|
return encLength;
|
|
}
|
|
|
|
/** MQTT packet length decoder - algorithm from reference docs */
|
|
function mqttPacketLengthDec(length) {
|
|
var bytes = 0;
|
|
var decL = 0;
|
|
var lb = 0;
|
|
do {
|
|
lb = length[bytes];
|
|
decL |= (lb & 127) << (bytes++*7);
|
|
} while ((lb & 128) && (bytes < 4))
|
|
return {"decLen": decL, "lenBy": bytes};
|
|
}
|
|
|
|
/** MQTT standard packet formatter */
|
|
function mqttPacket(cmd, variable, payload) {
|
|
var cmdAndLengthArray = [cmd].concat(mqttPacketLength(variable.length + payload.length));
|
|
var headerAndPayloadArray = cmdAndLengthArray.concat(variable).concat(payload);
|
|
var messageBuffer = Buffer.from(headerAndPayloadArray);
|
|
return messageBuffer;
|
|
}
|
|
|
|
/** Generate random UID */
|
|
var mqttUid = (function () {
|
|
function s4() {
|
|
var numberstring = Math.floor((1 + Math.random()*10));
|
|
if (numberstring == 10) numberstring = 9;
|
|
numberstring = 97 + numberstring;
|
|
return numberstring;
|
|
}
|
|
|
|
return function () {
|
|
var output = [0, 12, s4(), s4(), s4(), s4(), s4(), s4(), s4(), s4(), s4(), s4(), s4(), s4()];
|
|
return output;
|
|
};
|
|
})();
|
|
|
|
/** Generate PID */
|
|
function mqttPid() {
|
|
pakId = pakId > 65534 ? 1 : ++pakId;
|
|
return [pakId >> 8, pakId & 0xFF];
|
|
}
|
|
|
|
/** Get PID from message */
|
|
function getPid(data) {
|
|
return data.slice(0,2);
|
|
}
|
|
|
|
/** PUBLISH control packet */
|
|
function mqttPublish(topic, message, qos, flags) {
|
|
var cmd = TYPE.PUBLISH << 4 | (qos << 1) | flags;
|
|
var variable = mqttStr(topic);
|
|
// Packet id must be included for QOS > 0
|
|
if (qos > 0) {
|
|
var newvariable = variable.concat(mqttPid());
|
|
return mqttPacket(cmd, newvariable, message);
|
|
} else {
|
|
return mqttPacket(cmd, variable, message);
|
|
}
|
|
}
|
|
|
|
/** SUBSCRIBE control packet */
|
|
function mqttSubscribe(topic, qos) {
|
|
var cmd = TYPE.SUBSCRIBE << 4 | 2;
|
|
var payloadarray =[];
|
|
var i = 0;
|
|
var messagearray = topic.split('');
|
|
for (var j = 0; j < topic.length; j++) {
|
|
var char = messagearray[j];
|
|
var numberrepres = char.charCodeAt(0);
|
|
payloadarray[i] = numberrepres;
|
|
i = i + 1;
|
|
}
|
|
return mqttPacket(cmd,
|
|
mqttPid(),
|
|
mqttStr(topic).concat([qos]));
|
|
}
|
|
|
|
/** UNSUBSCRIBE control packet */
|
|
function mqttUnsubscribe(topic) {
|
|
var cmd = TYPE.UNSUBSCRIBE << 4 | 2;
|
|
return mqttPacket(cmd,
|
|
mqttPid(),
|
|
mqttStr(topic));
|
|
}
|
|
|
|
/** Create escaped hex value from number */
|
|
function createEscapedHex(number) {
|
|
return fromCharCode(parseInt(number.toString(16), 16));
|
|
}
|
|
|
|
// Handle a single packet of data
|
|
MQTT.prototype.packetHandler = function(data) {
|
|
|
|
// if we had some data left over from last
|
|
// time, add it on
|
|
if (this.partData && this.partData.length > 0) {
|
|
data = Buffer.from(Array.prototype.slice.call(this.partData).concat(Array.prototype.slice.call(data)));
|
|
this.partData = [];
|
|
}
|
|
|
|
// Figure out packet length...
|
|
var dLen = mqttPacketLengthDec(data.slice(1, data.length));
|
|
var pLen = dLen.decLen + dLen.lenBy + 1;
|
|
// less than one packet?
|
|
if (data.length < pLen) {
|
|
this.partData = data;
|
|
return;
|
|
}
|
|
// Get the data for this packet
|
|
var pData = data.slice(1 + dLen.lenBy, pLen);
|
|
// more than one packet? re-emit it so we handle it later
|
|
if (data.length > pLen) {
|
|
this.client.emit('data', data.slice(pLen, data.length));
|
|
}
|
|
// Now handle this MQTT packet
|
|
var cmd = data[0];
|
|
var type = cmd >> 4;
|
|
var flag = cmd & 15;
|
|
if (type === TYPE.PUBLISH) {
|
|
var qos = (cmd & 0x6) >> 1;
|
|
var topic_len = pData[0] << 8 | pData[1];
|
|
var msg_start = 2 + topic_len + (qos ? 2 : 0);
|
|
var parsedData = {
|
|
topic : pData.slice(2, 2 + topic_len),
|
|
message: pData.slice(msg_start, pData.length),
|
|
dup : (cmd & 0x8) >> 3,
|
|
qos : qos,
|
|
pid : qos?pData.slice(2+topic_len,4+topic_len):0,
|
|
retain : cmd & 0x1
|
|
};
|
|
if (parsedData.qos) {
|
|
this.client.write([((parsedData.qos == 1)?TYPE.PUBACK:TYPE.PUBREC) << 4, 2, parsedData.pid]);
|
|
}
|
|
this.emit('publish', parsedData);
|
|
this.emit('message', parsedData.topic, parsedData.message);
|
|
} else if (type === TYPE.PUBACK) {
|
|
this.emit('puback', data.charCodeAt(2) << 8 | data.charCodeAt(3));
|
|
} else if (type === TYPE.PUBREC) {
|
|
var pubrelArray = [(TYPE.PUBREL << 4 | 2), 2];
|
|
var pidArray = Array.prototype.slice.call(getPid(pData));
|
|
var pubrecResponse = pubrelArray.concat(pidArray);
|
|
this.client.write(Buffer.from(pubrecResponse));
|
|
} else if (type === TYPE.PUBREL) {
|
|
var pubcompArray = [(TYPE.PUBCOMP << 4), 2];
|
|
var pidArray = Array.prototype.slice.call(getPid(pData));
|
|
var pubrelResponse = pubcompArray.concat(pidArray);
|
|
this.client.write(pubrelResponse);
|
|
} else if (type === TYPE.PUBCOMP) {
|
|
this.emit('pubcomp', data.charCodeAt(2) << 8 | data.charCodeAt(3));
|
|
} else if (type === TYPE.SUBACK) {
|
|
if(pData.length > 0) {
|
|
if(pData[pData.length - 1] == 0x80) {
|
|
this.emit('subscribed_fail');
|
|
} else {
|
|
this.emit('subscribed');
|
|
}
|
|
}
|
|
} else if (type === TYPE.UNSUBACK) {
|
|
this.emit('unsubscribed');
|
|
} else if (type === TYPE.PINGREQ) {
|
|
this.client.write([(TYPE.PINGRESP << 4), 0]);
|
|
} else if (type === TYPE.PINGRESP) {
|
|
this.emit('ping_reply');
|
|
} else if (type === TYPE.CONNACK) {
|
|
if (this.ctimo) clearTimeout(this.ctimo);
|
|
this.ctimo = undefined;
|
|
this.partData = [];
|
|
var returnCode = pData[1];
|
|
if (RETURN_CODES[returnCode] === 'ACCEPTED') {
|
|
this.connected = true;
|
|
// start pinging
|
|
if (this.pintr) clearInterval(this.pintr);
|
|
this.pintr = setInterval(this.ping.bind(this), this.ping_interval * 1000);
|
|
// emit connected events
|
|
this.emit('connected');
|
|
this.emit('connect');
|
|
} else {
|
|
var mqttError = "Connection refused, ";
|
|
this.connected = false;
|
|
if (returnCode > 0 && returnCode < 6) {
|
|
mqttError += RETURN_CODES[returnCode];
|
|
} else {
|
|
mqttError += "unknown return code: " + returnCode + ".";
|
|
}
|
|
this.emit('error', mqttError);
|
|
}
|
|
} else {
|
|
this.emit('error', "MQTT unsupported packet type: " + type);
|
|
}
|
|
};
|
|
|
|
/* Public interface ****************************/
|
|
|
|
/** Establish connection and set up keep_alive ping */
|
|
MQTT.prototype.connect = function (client) {
|
|
if (this.connected) return;
|
|
var mqo = this;
|
|
var onConnect = function () {
|
|
mqo.client = client;
|
|
// write connection message
|
|
var teststring = mqo.mqttConnect(mqo.client_id)
|
|
client.write(teststring);
|
|
// handle connection timeout if too slow
|
|
mqo.ctimo = setTimeout(function () {
|
|
mqo.ctimo = undefined;
|
|
mqo.emit('disconnected');
|
|
mqo.disconnect();
|
|
}, mqo.C.CONNECT_TIMEOUT);
|
|
// Incoming data
|
|
client.on('data', mqo.packetHandler.bind(mqo));
|
|
// Socket closed
|
|
client.on('end', function () {
|
|
mqo._scktClosed();
|
|
});
|
|
};
|
|
if (client) {
|
|
onConnect();
|
|
} else {
|
|
try {
|
|
var self = this;
|
|
client = require("net").Socket().connect({ host: mqo.server, port: mqo.port }, onConnect);
|
|
client.on('error', function (err) {
|
|
self.emit('error', err.message);
|
|
});
|
|
} catch (e) {
|
|
this.client = false;
|
|
this.emit('error', e.message);
|
|
}
|
|
}
|
|
};
|
|
|
|
/** Called internally when the connection closes */
|
|
MQTT.prototype._scktClosed = function () {
|
|
if (this.connected) {
|
|
this.connected = false;
|
|
this.client = false;
|
|
if (this.pintr) clearInterval(this.pintr);
|
|
if (this.ctimo) clearTimeout(this.ctimo);
|
|
this.pintr = this.ctimo = undefined;
|
|
this.emit('disconnected');
|
|
this.emit('close');
|
|
}
|
|
};
|
|
|
|
/** Disconnect from server */
|
|
MQTT.prototype.disconnect = function () {
|
|
if (!this.client) return;
|
|
try {
|
|
this.client.write(Buffer.from([(TYPE.DISCONNECT << 4), 0]));
|
|
} catch (e) {
|
|
return this._scktClosed();
|
|
}
|
|
this.client.end();
|
|
this.client = false;
|
|
};
|
|
|
|
/** Publish message using specified topic.
|
|
opts = {
|
|
retain: bool // the server should retain this message and send it out again to new subscribers
|
|
dup : bool // indicate the message is a duplicate because original wasn't ACKed (QoS > 0 only)
|
|
}
|
|
*/
|
|
MQTT.prototype.publish = function (topic, message, opts) {
|
|
if (!this.client) return;
|
|
opts = opts || {};
|
|
try {
|
|
var payloadarray =[];
|
|
var i = 0;
|
|
var messagearray = message.split('');
|
|
for (var j = 0; j < message.length; j++) {
|
|
var char = messagearray[j];
|
|
var numberrepres = char.charCodeAt(0);
|
|
payloadarray[i] = numberrepres;
|
|
i = i + 1;
|
|
}
|
|
var publishMessage = mqttPublish(topic, payloadarray, opts.qos || this.C.DEF_QOS, (opts.retain ? 1 : 0) | (opts.dup ? 8 : 0));
|
|
this.client.write(publishMessage);
|
|
} catch (e) {
|
|
this._scktClosed();
|
|
}
|
|
};
|
|
|
|
/** Subscribe to topic (filter) */
|
|
MQTT.prototype.subscribe = function (topics, opts) {
|
|
if (!this.client) return;
|
|
opts = opts || {};
|
|
|
|
var subs = [];
|
|
if ('string' === typeof topics) {
|
|
topics = [topics];
|
|
}
|
|
if (Array.isArray(topics)) {
|
|
topics.forEach(function (topic) {
|
|
subs.push({
|
|
topic: topic,
|
|
qos : opts.qos || this.C.DEF_QOS
|
|
});
|
|
}.bind(this));
|
|
} else {
|
|
Object
|
|
.keys(topics)
|
|
.forEach(function (k) {
|
|
subs.push({
|
|
topic: k,
|
|
qos : topics[k]
|
|
});
|
|
});
|
|
}
|
|
|
|
subs.forEach(function (sub) {
|
|
var subpacket = mqttSubscribe(sub.topic, sub.qos);
|
|
this.client.write(subpacket);
|
|
}.bind(this));
|
|
};
|
|
|
|
/** Unsubscribe to topic (filter) */
|
|
MQTT.prototype.unsubscribe = function (topic) {
|
|
if (!this.client) return;
|
|
this.client.write(mqttUnsubscribe(topic));
|
|
};
|
|
|
|
/** Send ping request to server */
|
|
MQTT.prototype.ping = function () {
|
|
if (!this.client) return;
|
|
try {
|
|
this.client.write(Buffer.from([TYPE.PINGREQ << 4, 0]));
|
|
} catch (e) {
|
|
this._scktClosed();
|
|
}
|
|
};
|
|
|
|
/* Packet specific functions *******************/
|
|
|
|
/** Create connection flags */
|
|
MQTT.prototype.createFlagsForConnection = function (options) {
|
|
var flags = 0;
|
|
flags |= ( this.username ) ? 0x80 : 0;
|
|
flags |= ( this.username && this.password ) ? 0x40 : 0;
|
|
flags |= ( options.clean_session ) ? 0x02 : 0;
|
|
return flags;
|
|
};
|
|
|
|
/** CONNECT control packet
|
|
Clean Session and Userid/Password are currently only supported
|
|
connect flag. Wills are not
|
|
currently supported.
|
|
*/
|
|
MQTT.prototype.mqttConnect = function (clean) {
|
|
var cmd = TYPE.CONNECT << 4;
|
|
var flags = this.createFlagsForConnection({
|
|
clean_session: clean
|
|
});
|
|
|
|
var keep_alive = [this.keep_alive >> 8, this.keep_alive & 255];
|
|
|
|
/* payload */
|
|
var payload = this.client_id;
|
|
if (this.username) {
|
|
payload = payload.concat(this.username);
|
|
if (this.password) {
|
|
payload = payload.concat(this.password);
|
|
}
|
|
}
|
|
return mqttPacket(cmd,
|
|
mqttStr(this.protocol_name)/*protocol name*/.concat(
|
|
[this.protocol_level]) /*protocol level*/.concat(
|
|
[flags]).concat(keep_alive),
|
|
payload);
|
|
};
|
|
|
|
/* Exports *************************************/
|
|
|
|
/** This is 'exported' so it can be used with `require('MQTT.js').create(server, options)` */
|
|
exports.create = function (server, options) {
|
|
return new MQTT(server, options);
|
|
};
|
|
|
|
exports.connect = function (options) {
|
|
var mqtt = new MQTT(options.host, options);
|
|
mqtt.connect();
|
|
return mqtt;
|
|
};
|