utilitas 1989.9.21 → 1989.9.25

package/lib/bot.mjs

@@ -95,6 +95,7 @@ const end = async (options) => {
     return bot && bot.stop(options?.signal);
 };
 
+export default init;
 export {
     end,
     send,

package/lib/cache.mjs

@@ -21,6 +21,7 @@ const init = async (options) => {
     return redis;
 };
 
+export default init;
 export {
     init,
     //     set,

package/lib/dbio.mjs

@@ -261,6 +261,7 @@ const deleteAll = async (table, options) => {
     return await execute(assembleDelete(table));
 };
 
+export default init;
 export {
     assembleInsert,
     assembleQuery,

package/lib/email.mjs

@@ -88,6 +88,7 @@ const send = async (email, subject, text, html, args, options) => {
     }, html ? { html } : {}));
 }
 
+export default init;
 export {
     getSenderName,
     init,

package/lib/event.mjs

@@ -88,7 +88,8 @@ const bulk = async (absDir, options) => {
     return await Promise.all(pmsRun);
 };
 
-const end = async () => {
+const end = async (name) => {
+    if (name) { delete jobs[name]; if (jobs.length) { return; } }
     clearInterval(timer);
     timer = -1;
     const now = Date.now();
@@ -102,6 +103,7 @@ const end = async () => {
     log('Terminated.');
 };
 
+export default loop;
 export {
     bulk,
     end,

package/lib/sentinel.mjs

@@ -21,6 +21,7 @@ const init = async (options) => {
     return sentry;
 };
 
+export default init;
 export {
     init,
 };

package/lib/shell.mjs

@@ -34,6 +34,7 @@ const assertExist = async (bin, er, code = 500) => {
     utilitas.assert(await exist(bin), er || `Command not found: ${bin}.`, code);
 };
 
+export default exec;
 export {
     assertExist,
     exec,

package/lib/sms.mjs

@@ -60,6 +60,7 @@ const send = async (phone, message) => {
     }
 };
 
+export default init;
 export {
     init,
     send,

package/lib/tape.mjs

@@ -1,3 +1,5 @@
+import * as bot from './bot.mjs';
+import * as event from './event.mjs';
 import * as utilitas from './utilitas.mjs';
 
 // https://github.com/winstonjs/winston#logging-levels
@@ -5,13 +7,12 @@ import * as utilitas from './utilitas.mjs';
 // Handle, report, or silently ignore connection errors and failures
 const handleError = (err) => { process.stdout.write(`${err.message}\n`); };
 const consoleMap = { log: 'verbose', info: 0, debug: 0, warn: 0, error: 0 };
-const modLog = (content) => { return utilitas.modLog(content, 'tape'); };
+const TAPE = 'TAPE';
+const modLog = (content) => { return utilitas.modLog(content, TAPE); };
 const getLogger = async () => { return (await init()).logger; };
-const [providerDefault, providerPapertrail] = ['RSYSLOG', 'PAPERTRAIL'];
-// why keeping providerPapertrail ?
+const [BOT, RSYSLOG, PAPERTRAIL] = ['BOT', 'RSYSLOG', 'PAPERTRAIL'];
 
-let winston, papertrail, papertrailConnection,
-    papertrailTransport, logger, silent, provider;
+let chatIds, tarLevel, botBuffer, logger, silent, provider;
 
 // Do something after the connection to the Papertrail server is established
 const handleConnect = (data) => {
@@ -25,8 +26,7 @@ const hookConsole = () => {
         console[bakAct] = console[act];
         console[act] = function() {
             const str = [...arguments].map(utilitas.ensureString).join(' ');
-            // process.stdout.write(`SEND ${tar}: ${str}\n`);
-            logger && logger.log(tar, str);
+            logger && logger.log(tar, str.replace(/\u001b\[\d+m/g, ''));
             console[bakAct].apply(console, arguments);
         };
     }
@@ -43,53 +43,100 @@ const releaseConsole = () => {
 
 const getDefaultOptions = async (provider, options) => {
     const result = { program: (await utilitas.which()).name };
-    switch (provider) {
-        case providerDefault:
-            result.disableTls = true;
-            result.logFormat = (level, message) => {
-                return message.replace(/\u001b\[\d+m/g, '');
-            }
-    }
+    switch (provider) { case RSYSLOG: result.disableTls = true; }
+    // result.logFormat = (level, message) => { return message; }
     return Object.assign(result, options || {});
 };
 
+const sysLogInit = async (options) => {
+    options = await getDefaultOptions(provider, options);
+    const winston = await import('winston');
+    const papertrail = await import('winston-papertrail-mproved');
+    const papertrailConnection = new papertrail.PapertrailConnection(options);
+    papertrailConnection.on('error', handleError);
+    papertrailConnection.on('connect', handleConnect);
+    const papertrailTransport = new papertrail.PapertrailTransport(
+        papertrailConnection, options
+    );
+    logger = new winston.createLogger({ transports: [papertrailTransport] });
+    return {
+        logger,
+        dependencies: { winston, papertrail, papertrailConnection, papertrailTransport },
+    };
+};
+
+const addChatId = (id) => {
+    return chatIds && id && !chatIds.includes(id) ? chatIds.push(id) : null;
+};
+
+const removeChatId = (id) => {
+    return chatIds && id && chatIds.includes(id) ? delete chatIds[id] : false;
+};
+
+const botLoggerInit = async (options) => {
+    chatIds = utilitas.ensureArray(options?.chatId);
+    utilitas.assert(chatIds.length, 'ChatId is required.', 501);
+    handleConnect(`Sending logs via bot, chatId: ${chatIds.join(', ')}.`);
+    logger = botLogger;
+    await event.loop(
+        botLoggerSync, ~~options?.interval || 5, ~~options?.tout || 10,
+        ~~options?.delay, TAPE, { silent: true }
+    );
+    return { logger, dependencies: { bot, event } };
+};
+
+const botLoggerSync = async () => {
+    let f = (botBuffer?.length ? botBuffer.splice(0) : []).map(x => x[1]).join('\n');
+    if (!f.length) { return; }
+    for (let id of chatIds) {
+        try { await bot.send(id, f); } catch (err) { handleError(err); }
+    }
+};
+
+const botLogger = {
+    log: (level, message) => {
+        if (tarLevel !== 'verbose' && level === 'verbose') { return; }
+        (botBuffer = botBuffer || []).push([level, message]);
+    },
+    end: () => { chatIds = null; botBuffer = null; event.end(TAPE); },
+};
+
 // use options.level = 'verbose' to send console.log logs
 const init = async (options) => {
+    let result;
     if (options) {
-        silent = !!options.silent;
-        provider = utilitas.ensureString(
-            options.provider, { case: 'UP' }
-        ) || providerDefault;
-        options = await getDefaultOptions(provider, options);
-        winston = await import('winston');
-        papertrail = await import('winston-papertrail-mproved');
-        papertrailConnection = new papertrail.PapertrailConnection(options);
-        papertrailConnection.on('error', handleError);
-        papertrailConnection.on('connect', handleConnect);
-        papertrailTransport = new papertrail.PapertrailTransport(
-            papertrailConnection, options
-        );
-        logger = new winston.createLogger({
-            transports: [papertrailTransport],
-        });
+        silent = !!options?.silent;
+        tarLevel = options?.level;
+        provider = utilitas.ensureString(options?.provider, { case: 'UP' });
+        switch (provider) {
+            case BOT:
+                result = await botLoggerInit(options);
+                break;
+            case RSYSLOG:
+            case PAPERTRAIL:
+                result = await sysLogInit(options);
+                break;
+            default:
+                utilitas.throwError(
+                    `Invalid tape provider: '${options?.provider}'.`, 501
+                );
+        }
         options.noHook || hookConsole();
     }
     utilitas.assert(logger, 'Logger client has not been initialized.', 501);
-    return {
-        winston, papertrail, papertrailConnection, papertrailTransport, logger
-    };
+    return result;
 };
 
 const end = async () => {
     releaseConsole();
-    setTimeout(() => {
-        logger && logger.end();
-        modLog('Terminated.');
-    }, 1000);
+    setTimeout(() => { logger?.end?.(); modLog('Terminated.'); }, 1000);
 };
 
+export default init;
 export {
+    addChatId,
     end,
     getLogger,
     init,
+    removeChatId,
 };

package/lib/uoid.mjs

@@ -32,6 +32,7 @@ const getRfcUrlNamespaceUuid = (url) => {
     return uuid.v5(url, uuid.v5.URL);
 };
 
+export default create;
 export {
     uuidRegTxt,
     create,

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "utilitas",
     "description": "Just another common utility for Node.js.",
-    "version": "1989.9.21",
+    "version": "1989.9.25",
     "private": false,
     "homepage": "https://github.com/Leask/utilitas",
     "main": "index.mjs",