utils.js 16 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663
  1. import async from "async";
  2. import crypto from "crypto";
  3. import CoreClass from "../core";
  4. let UtilsModule;
  5. let IOModule;
  6. let CacheModule;
  7. class _UtilsModule extends CoreClass {
  8. // eslint-disable-next-line require-jsdoc
  9. constructor() {
  10. super("utils");
  11. UtilsModule = this;
  12. }
  13. /**
  14. * Initialises the utils module
  15. *
  16. * @returns {Promise} - returns promise (reject, resolve)
  17. */
  18. initialize() {
  19. return new Promise(resolve => {
  20. IOModule = this.moduleManager.modules.io;
  21. CacheModule = this.moduleManager.modules.cache;
  22. resolve();
  23. });
  24. }
  25. /**
  26. * Parses the cookie into a readable object
  27. *
  28. * @param {object} payload - object that contains the payload
  29. * @param {string} payload.cookieString - the cookie string
  30. * @returns {Promise} - returns promise (reject, resolve)
  31. */
  32. PARSE_COOKIES(payload) {
  33. return new Promise((resolve, reject) => {
  34. const cookies = {};
  35. if (typeof payload.cookieString !== "string") return reject(new Error("Cookie string is not a string"));
  36. // eslint-disable-next-line array-callback-return
  37. payload.cookieString.split("; ").map(cookie => {
  38. cookies[cookie.substring(0, cookie.indexOf("="))] = cookie.substring(
  39. cookie.indexOf("=") + 1,
  40. cookie.length
  41. );
  42. });
  43. return resolve(cookies);
  44. });
  45. }
  46. // COOKIES_TO_STRING() {//cookies
  47. // return new Promise((resolve, reject) => {
  48. // let newCookie = [];
  49. // for (let prop in cookie) {
  50. // newCookie.push(prop + "=" + cookie[prop]);
  51. // }
  52. // return newCookie.join("; ");
  53. // });
  54. // }
  55. /**
  56. * Removes a cookie by name
  57. *
  58. * @param {object} payload - object that contains the payload
  59. * @param {object} payload.cookieString - the cookie string
  60. * @param {string} payload.cookieName - the unique name of the cookie
  61. * @returns {Promise} - returns promise (reject, resolve)
  62. */
  63. REMOVE_COOKIE(payload) {
  64. return new Promise((resolve, reject) => {
  65. let cookies;
  66. try {
  67. cookies = UtilsModule.runJob(
  68. "PARSE_COOKIES",
  69. {
  70. cookieString: payload.cookieString
  71. },
  72. this
  73. );
  74. } catch (err) {
  75. return reject(err);
  76. }
  77. delete cookies[payload.cookieName];
  78. return resolve();
  79. });
  80. }
  81. /**
  82. * Replaces any html reserved characters in a string with html entities
  83. *
  84. * @param {object} payload - object that contains the payload
  85. * @param {string} payload.str - the string to replace characters with html entities
  86. * @returns {Promise} - returns promise (reject, resolve)
  87. */
  88. HTML_ENTITIES(payload) {
  89. return new Promise(resolve => {
  90. resolve(
  91. String(payload.str)
  92. .replace(/&/g, "&")
  93. .replace(/</g, "&lt;")
  94. .replace(/>/g, "&gt;")
  95. .replace(/"/g, "&quot;")
  96. );
  97. });
  98. }
  99. /**
  100. * Generates a random string of a specified length
  101. *
  102. * @param {object} payload - object that contains the payload
  103. * @param {number} payload.length - the length the random string should be
  104. * @returns {Promise} - returns promise (reject, resolve)
  105. */
  106. async GENERATE_RANDOM_STRING(payload) {
  107. const chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789".split("");
  108. const promises = [];
  109. for (let i = 0; i < payload.length; i += 1) {
  110. promises.push(
  111. UtilsModule.runJob(
  112. "GET_RANDOM_NUMBER",
  113. {
  114. min: 0,
  115. max: chars.length - 1
  116. },
  117. this
  118. )
  119. );
  120. }
  121. const randomNums = await Promise.all(promises);
  122. const randomChars = [];
  123. for (let i = 0; i < payload.length; i += 1) {
  124. randomChars.push(chars[randomNums[i]]);
  125. }
  126. return new Promise(resolve => resolve(randomChars.join("")));
  127. }
  128. /**
  129. * Returns a socket object from a socket identifier
  130. *
  131. * @param {object} payload - object that contains the payload
  132. * @param {string} payload.socketId - the socket id
  133. * @returns {Promise} - returns promise (reject, resolve)
  134. */
  135. async GET_SOCKET_FROM_ID(payload) {
  136. // socketId
  137. const io = await IOModule.runJob("IO", {}, this);
  138. return new Promise(resolve => resolve(io.sockets.sockets[payload.socketId]));
  139. }
  140. /**
  141. * Creates a random number within a range
  142. *
  143. * @param {object} payload - object that contains the payload
  144. * @param {number} payload.min - the minimum number the result should be
  145. * @param {number} payload.max - the maximum number the result should be
  146. * @returns {Promise} - returns promise (reject, resolve)
  147. */
  148. GET_RANDOM_NUMBER(payload) {
  149. // min, max
  150. return new Promise(resolve =>
  151. resolve(Math.floor(Math.random() * (payload.max - payload.min + 1)) + payload.min)
  152. );
  153. }
  154. /**
  155. * Converts ISO8601 time format (YouTube API) to HH:MM:SS
  156. *
  157. * @param {object} payload - object contaiing the payload
  158. * @param {string} payload.duration - string in the format of ISO8601
  159. * @returns {Promise} - returns a promise (resolve, reject)
  160. */
  161. CONVERT_TIME(payload) {
  162. // duration
  163. return new Promise(resolve => {
  164. let { duration } = payload;
  165. let a = duration.match(/\d+/g);
  166. if (duration.indexOf("M") >= 0 && duration.indexOf("H") === -1 && duration.indexOf("S") === -1) {
  167. a = [0, a[0], 0];
  168. }
  169. if (duration.indexOf("H") >= 0 && duration.indexOf("M") === -1) {
  170. a = [a[0], 0, a[1]];
  171. }
  172. if (duration.indexOf("H") >= 0 && duration.indexOf("M") === -1 && duration.indexOf("S") === -1) {
  173. a = [a[0], 0, 0];
  174. }
  175. duration = 0;
  176. if (a.length === 3) {
  177. duration += parseInt(a[0]) * 3600;
  178. duration += parseInt(a[1]) * 60;
  179. duration += parseInt(a[2]);
  180. }
  181. if (a.length === 2) {
  182. duration += parseInt(a[0]) * 60;
  183. duration += parseInt(a[1]);
  184. }
  185. if (a.length === 1) {
  186. duration += parseInt(a[0]);
  187. }
  188. const hours = Math.floor(duration / 3600);
  189. const minutes = Math.floor((duration % 3600) / 60);
  190. const seconds = Math.floor((duration % 3600) % 60);
  191. resolve(
  192. (hours < 10 ? `0${hours}:` : `${hours}:`) +
  193. (minutes < 10 ? `0${minutes}:` : `${minutes}:`) +
  194. (seconds < 10 ? `0${seconds}` : seconds)
  195. );
  196. });
  197. }
  198. /**
  199. * Creates a random identifier for e.g. sessionId
  200. *
  201. * @returns {Promise} - returns promise (reject, resolve)
  202. */
  203. GUID() {
  204. return new Promise(resolve => {
  205. resolve(
  206. [1, 1, 0, 1, 0, 1, 0, 1, 0, 1, 1, 1]
  207. .map(b =>
  208. b
  209. ? Math.floor((1 + Math.random()) * 0x10000)
  210. .toString(16)
  211. .substring(1)
  212. : "-"
  213. )
  214. .join("")
  215. );
  216. });
  217. }
  218. // UNKNOWN
  219. // eslint-disable-next-line require-jsdoc
  220. async SOCKET_FROM_SESSION(payload) {
  221. // socketId
  222. const io = await IOModule.runJob("IO", {}, this);
  223. return new Promise((resolve, reject) => {
  224. const ns = io.of("/");
  225. if (ns) {
  226. return resolve(ns.connected[payload.socketId]);
  227. }
  228. return reject();
  229. });
  230. }
  231. /**
  232. * Gets all sockets for a specified session id
  233. *
  234. * @param {object} payload - object containing the payload
  235. * @param {string} payload.sessionId - user session id
  236. * @returns {Promise} - returns promise (reject, resolve)
  237. */
  238. async SOCKETS_FROM_SESSION_ID(payload) {
  239. const io = await IOModule.runJob("IO", {}, this);
  240. return new Promise(resolve => {
  241. const ns = io.of("/");
  242. const sockets = [];
  243. if (ns) {
  244. return async.each(
  245. Object.keys(ns.connected),
  246. (id, next) => {
  247. const { session } = ns.connected[id];
  248. if (session.sessionId === payload.sessionId) sockets.push(session.sessionId);
  249. next();
  250. },
  251. () => {
  252. resolve({ sockets });
  253. }
  254. );
  255. }
  256. return resolve();
  257. });
  258. }
  259. /**
  260. * Returns any sockets for a specific user
  261. *
  262. * @param {object} payload - object that contains the payload
  263. * @param {string} payload.userId - the user id
  264. * @returns {Promise} - returns promise (reject, resolve)
  265. */
  266. async SOCKETS_FROM_USER(payload) {
  267. const io = await IOModule.runJob("IO", {}, this);
  268. return new Promise((resolve, reject) => {
  269. const ns = io.of("/");
  270. const sockets = [];
  271. if (ns) {
  272. return async.each(
  273. Object.keys(ns.connected),
  274. (id, next) => {
  275. const { session } = ns.connected[id];
  276. CacheModule.runJob(
  277. "HGET",
  278. {
  279. table: "sessions",
  280. key: session.sessionId
  281. },
  282. this
  283. )
  284. .then(session => {
  285. if (session && session.userId === payload.userId) sockets.push(ns.connected[id]);
  286. next();
  287. })
  288. .catch(err => {
  289. next(err);
  290. });
  291. },
  292. err => {
  293. if (err) return reject(err);
  294. return resolve({ sockets });
  295. }
  296. );
  297. }
  298. return resolve();
  299. });
  300. }
  301. /**
  302. * Returns any sockets from a specific ip address
  303. *
  304. * @param {object} payload - object that contains the payload
  305. * @param {string} payload.ip - the ip address in question
  306. * @returns {Promise} - returns promise (reject, resolve)
  307. */
  308. async SOCKETS_FROM_IP(payload) {
  309. const io = await IOModule.runJob("IO", {}, this);
  310. return new Promise(resolve => {
  311. const ns = io.of("/");
  312. const sockets = [];
  313. if (ns) {
  314. return async.each(
  315. Object.keys(ns.connected),
  316. (id, next) => {
  317. const { session } = ns.connected[id];
  318. CacheModule.runJob(
  319. "HGET",
  320. {
  321. table: "sessions",
  322. key: session.sessionId
  323. },
  324. this
  325. )
  326. .then(session => {
  327. if (session && ns.connected[id].ip === payload.ip) sockets.push(ns.connected[id]);
  328. next();
  329. })
  330. .catch(() => next());
  331. },
  332. () => {
  333. resolve({ sockets });
  334. }
  335. );
  336. }
  337. return resolve();
  338. });
  339. }
  340. /**
  341. * Returns any sockets from a specific user without using redis/cache
  342. *
  343. * @param {object} payload - object that contains the payload
  344. * @param {string} payload.userId - the id of the user in question
  345. * @returns {Promise} - returns promise (reject, resolve)
  346. */
  347. async SOCKETS_FROM_USER_WITHOUT_CACHE(payload) {
  348. const io = await IOModule.runJob("IO", {}, this);
  349. return new Promise(resolve => {
  350. const ns = io.of("/");
  351. const sockets = [];
  352. if (ns) {
  353. return async.each(
  354. Object.keys(ns.connected),
  355. (id, next) => {
  356. const { session } = ns.connected[id];
  357. if (session.userId === payload.userId) sockets.push(ns.connected[id]);
  358. next();
  359. },
  360. () => {
  361. resolve({ sockets });
  362. }
  363. );
  364. }
  365. return resolve();
  366. });
  367. }
  368. /**
  369. * Allows a socket to leave any rooms they are connected to
  370. *
  371. * @param {object} payload - object that contains the payload
  372. * @param {string} payload.socketId - the id of the socket which should leave all their rooms
  373. * @returns {Promise} - returns promise (reject, resolve)
  374. */
  375. async SOCKET_LEAVE_ROOMS(payload) {
  376. const socket = await UtilsModule.runJob(
  377. "SOCKET_FROM_SESSION",
  378. {
  379. socketId: payload.socketId
  380. },
  381. this
  382. );
  383. return new Promise(resolve => {
  384. const { rooms } = socket;
  385. Object.keys(rooms).forEach(roomKey => {
  386. const room = rooms[roomKey];
  387. socket.leave(room);
  388. });
  389. return resolve();
  390. });
  391. }
  392. /**
  393. * Allows a socket to join a specified room
  394. *
  395. * @param {object} payload - object that contains the payload
  396. * @param {string} payload.socketId - the id of the socket which should join the room
  397. * @param {object} payload.room - the object representing the room the socket should join
  398. * @returns {Promise} - returns promise (reject, resolve)
  399. */
  400. async SOCKET_JOIN_ROOM(payload) {
  401. const socket = await UtilsModule.runJob(
  402. "SOCKET_FROM_SESSION",
  403. {
  404. socketId: payload.socketId
  405. },
  406. this
  407. );
  408. return new Promise(resolve => {
  409. const { rooms } = socket;
  410. Object.keys(rooms).forEach(roomKey => {
  411. const room = rooms[roomKey];
  412. socket.leave(room);
  413. });
  414. socket.join(payload.room);
  415. return resolve();
  416. });
  417. }
  418. // UNKNOWN
  419. // eslint-disable-next-line require-jsdoc
  420. async SOCKET_JOIN_SONG_ROOM(payload) {
  421. // socketId, room
  422. const socket = await UtilsModule.runJob(
  423. "SOCKET_FROM_SESSION",
  424. {
  425. socketId: payload.socketId
  426. },
  427. this
  428. );
  429. return new Promise(resolve => {
  430. const { rooms } = socket;
  431. Object.keys(rooms).forEach(roomKey => {
  432. const room = rooms[roomKey];
  433. if (room.indexOf("song.") !== -1) socket.leave(room);
  434. });
  435. socket.join(payload.room);
  436. return resolve();
  437. });
  438. }
  439. // UNKNOWN
  440. // eslint-disable-next-line require-jsdoc
  441. SOCKETS_JOIN_SONG_ROOM(payload) {
  442. // sockets, room
  443. return new Promise(resolve => {
  444. Object.keys(payload.sockets).forEach(socketKey => {
  445. const socket = payload.sockets[socketKey];
  446. const { rooms } = socket;
  447. Object.keys(rooms).forEach(roomKey => {
  448. const room = rooms[roomKey];
  449. if (room.indexOf("song.") !== -1) socket.leave(room);
  450. });
  451. socket.join(payload.room);
  452. });
  453. return resolve();
  454. });
  455. }
  456. // UNKNOWN
  457. // eslint-disable-next-line require-jsdoc
  458. SOCKETS_LEAVE_SONG_ROOMS(payload) {
  459. // sockets
  460. return new Promise(resolve => {
  461. Object.keys(payload.sockets).forEach(socketKey => {
  462. const socket = payload.sockets[socketKey];
  463. const { rooms } = socket;
  464. Object.keys(rooms).forEach(roomKey => {
  465. const room = rooms[roomKey];
  466. if (room.indexOf("song.") !== -1) socket.leave(room);
  467. });
  468. });
  469. resolve();
  470. });
  471. }
  472. /**
  473. * Emits arguments to any sockets that are in a specified a room
  474. *
  475. * @param {object} payload - object that contains the payload
  476. * @param {string} payload.room - the name of the room to emit arguments
  477. * @param {object} payload.args - any arguments to be emitted to the sockets in the specific room
  478. * @returns {Promise} - returns promise (reject, resolve)
  479. */
  480. async EMIT_TO_ROOM(payload) {
  481. const io = await IOModule.runJob("IO", {}, this);
  482. return new Promise(resolve => {
  483. const { sockets } = io.sockets;
  484. Object.keys(sockets).forEach(socketKey => {
  485. const socket = sockets[socketKey];
  486. if (socket.rooms[payload.room]) {
  487. socket.emit(...payload.args);
  488. }
  489. });
  490. return resolve();
  491. });
  492. }
  493. /**
  494. * Gets any sockets connected to a room
  495. *
  496. * @param {object} payload - object that contains the payload
  497. * @param {string} payload.room - the name of the room
  498. * @returns {Promise} - returns promise (reject, resolve)
  499. */
  500. async GET_ROOM_SOCKETS(payload) {
  501. const io = await IOModule.runJob("IO", {}, this);
  502. return new Promise(resolve => {
  503. const { sockets } = io.sockets;
  504. const roomSockets = [];
  505. Object.keys(sockets).forEach(socketKey => {
  506. const socket = sockets[socketKey];
  507. if (socket.rooms[payload.room]) roomSockets.push(socket);
  508. });
  509. return resolve(roomSockets);
  510. });
  511. }
  512. /**
  513. * Shuffles an array of songs
  514. *
  515. * @param {object} payload - object that contains the payload
  516. * @param {object} payload.array - an array of songs that should be shuffled
  517. * @returns {Promise} - returns promise (reject, resolve)
  518. */
  519. SHUFFLE(payload) {
  520. // array
  521. return new Promise(resolve => {
  522. const array = payload.array.slice();
  523. let currentIndex = payload.array.length;
  524. let temporaryValue;
  525. let randomIndex;
  526. // While there remain elements to shuffle...
  527. while (currentIndex !== 0) {
  528. // Pick a remaining element...
  529. randomIndex = Math.floor(Math.random() * currentIndex);
  530. currentIndex -= 1;
  531. // And swap it with the current element.
  532. temporaryValue = array[currentIndex];
  533. array[currentIndex] = array[randomIndex];
  534. array[randomIndex] = temporaryValue;
  535. }
  536. resolve({ array });
  537. });
  538. }
  539. /**
  540. * Creates an error
  541. *
  542. * @param {object} payload - object that contains the payload
  543. * @param {object} payload.error - object that contains the error
  544. * @param {string} payload.message - possible error message
  545. * @param {object} payload.errors - possible object that contains multiple errors
  546. * @returns {Promise} - returns promise (reject, resolve)
  547. */
  548. GET_ERROR(payload) {
  549. return new Promise(resolve => {
  550. let error = "An error occurred.";
  551. if (typeof payload.error === "string") error = payload.error;
  552. else if (payload.error.message) {
  553. if (payload.error.message !== "Validation failed") error = payload.error.message;
  554. else error = payload.error.errors[Object.keys(payload.error.errors)].message;
  555. }
  556. resolve(error);
  557. });
  558. }
  559. /**
  560. * Creates the gravatar url for a specified email address
  561. *
  562. * @param {object} payload - object that contains the payload
  563. * @param {string} payload.email - the email address
  564. * @returns {Promise} - returns promise (reject, resolve)
  565. */
  566. CREATE_GRAVATAR(payload) {
  567. return new Promise(resolve => {
  568. const hash = crypto.createHash("md5").update(payload.email).digest("hex");
  569. resolve(`https://www.gravatar.com/avatar/${hash}`);
  570. });
  571. }
  572. /**
  573. * @returns {Promise} - returns promise (reject, resolve)
  574. */
  575. DEBUG() {
  576. return new Promise(resolve => resolve());
  577. }
  578. }
  579. export default new _UtilsModule();