mybase 1.1.16 → 1.1.18

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mybase",
-  "version": "1.1.16",
+  "version": "1.1.18",
   "description": "",
   "main": "mybase.js",
   "scripts": {
@@ -17,6 +17,8 @@
     "ip6": "=0.2.7",
     "ip6addr": "^0.2.5",
     "js-sha512": "^0.8.0",
+    "mysql": "^2.18.1",
+    "mysql2": "^3.9.1",
     "node-vault": "^0.10.2",
     "psl": "^1.9.0",
     "punycode": "^2.1.1",
@@ -27,6 +29,7 @@
     "@types/debug": "^4.1.12",
     "@types/ip6addr": "^0.2.6",
     "@types/jest": "^29.5.11",
+    "@types/mysql": "^2.15.25",
     "@types/node": "^20.11.5",
     "@types/validator": "^13.11.8",
     "chai": "^4.2.0",

package/ts/funcs/getMysql1.d.ts

@@ -0,0 +1,8 @@
+export type Mysql1ServerConfiguration = {
+    host: string;
+    port: number;
+    login: string;
+    password: string;
+    db: string;
+};
+export declare function getMysql1(config: Mysql1ServerConfiguration, pingInterval?: number): Promise<unknown>;

package/ts/funcs/getMysql1.js

@@ -0,0 +1,72 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getMysql1 = void 0;
+const mysql1 = __importStar(require("mysql"));
+const debug_1 = __importDefault(require("debug"));
+const dbg = (0, debug_1.default)("getMysql1");
+function getMysql1(config, pingInterval = 0) {
+    return __awaiter(this, void 0, void 0, function* () {
+        return new Promise((resolve, reject) => {
+            const mysql_client = mysql1.createConnection({
+                host: config.host,
+                port: config.port ? config.port : 3306,
+                user: config.login,
+                password: config.password,
+                database: config.db
+            });
+            mysql_client.connect((err, res) => {
+                if (err) {
+                    dbg(`mysql connection has failed to ${config.host}@${config.db}`, err);
+                    return reject(err);
+                }
+                dbg(`mysql connection has been established to ${config.host}@${config.db}`);
+                // install a pinger every 30 seconds to keep the connection alive
+                if (pingInterval > 0)
+                    setInterval(() => {
+                        mysql_client.ping(function (err) {
+                            if (err)
+                                return console.log(`could not ping mysql ${config.host}@${config.db}`, err.code);
+                            dbg(`mysql ${config.host}@${config.db} is pinging properly`);
+                        });
+                    }, pingInterval);
+                resolve(mysql_client);
+            });
+        });
+    });
+}
+exports.getMysql1 = getMysql1;

package/ts/funcs/getMysql1.ts

@@ -0,0 +1,41 @@
+import * as mysql1 from "mysql"
+import { MysqlError } from "mysql"
+import debug from "debug"
+const dbg = debug("getMysql1")
+
+export type Mysql1ServerConfiguration = {
+    host: string,
+    port: number,
+    login: string,
+    password: string,
+    db: string
+}
+
+export async function getMysql1(config: Mysql1ServerConfiguration, pingInterval: number = 0) {
+    return new Promise((resolve, reject) => {
+        const mysql_client = mysql1.createConnection({
+            host: config.host,
+            port: config.port ? config.port : 3306,
+            user: config.login,
+            password: config.password,
+            database: config.db
+        })
+
+        mysql_client.connect((err:MysqlError, res) => {
+            if (err) {
+                dbg(`mysql connection has failed to ${config.host}@${config.db}`, err)
+                return reject(err)
+            }
+            dbg(`mysql connection has been established to ${config.host}@${config.db}`)
+            // install a pinger every 30 seconds to keep the connection alive
+            if (pingInterval > 0)
+                setInterval(() => {
+                    mysql_client.ping(function (err:MysqlError) {
+                        if (err) return console.log(`could not ping mysql ${config.host}@${config.db}`, err.code)
+                        dbg(`mysql ${config.host}@${config.db} is pinging properly`)
+                    })
+                }, pingInterval)
+            resolve(mysql_client)
+        })
+    })
+}

package/ts/funcs/getMysql2.d.ts

@@ -0,0 +1,8 @@
+export type Mysql2ServerConfiguration = {
+    host: string;
+    port: number;
+    login: string;
+    password: string;
+    db: string;
+};
+export declare function getMysql2(config: Mysql2ServerConfiguration, pingInterval?: number): Promise<unknown>;

package/ts/funcs/getMysql2.js

@@ -0,0 +1,72 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getMysql2 = void 0;
+const mysql2 = __importStar(require("mysql2"));
+const debug_1 = __importDefault(require("debug"));
+const dbg = (0, debug_1.default)("getMysql2");
+function getMysql2(config, pingInterval = 0) {
+    return __awaiter(this, void 0, void 0, function* () {
+        return new Promise((resolve, reject) => {
+            const mysql_client = mysql2.createConnection({
+                host: config.host,
+                port: config.port ? config.port : 3306,
+                user: config.login,
+                password: config.password,
+                database: config.db
+            });
+            mysql_client.connect((err) => {
+                if (err) {
+                    dbg(`mysql connection has failed to ${config.host}@${config.db}`, err);
+                    return reject(err);
+                }
+                dbg(`mysql connection has been established to ${config.host}@${config.db}`);
+                // install a pinger every 30 seconds to keep the connection alive
+                if (pingInterval > 0)
+                    setInterval(() => {
+                        mysql_client.ping(function (err) {
+                            if (err)
+                                return console.log(`could not ping mysql ${config.host}@${config.db}`, err.code);
+                            dbg(`mysql ${config.host}@${config.db} is pinging properly`);
+                        });
+                    }, pingInterval);
+                resolve(mysql_client);
+            });
+        });
+    });
+}
+exports.getMysql2 = getMysql2;

package/ts/funcs/getMysql2.ts

@@ -0,0 +1,42 @@
+import * as mysql2 from "mysql2"
+import { QueryError } from "mysql2"
+import debug from "debug"
+const dbg = debug("getMysql2")
+
+export type Mysql2ServerConfiguration = {
+    host: string,
+    port: number,
+    login: string,
+    password: string,
+    db: string
+}
+
+export async function getMysql2(config: Mysql2ServerConfiguration, pingInterval: number = 0) {
+    return new Promise((resolve, reject) => {
+        const mysql_client = mysql2.createConnection({
+            host: config.host,
+            port: config.port ? config.port : 3306,
+            user: config.login,
+            password: config.password,
+            database: config.db
+        })
+
+        mysql_client.connect((err: QueryError | null) => {
+            if (err) {
+                dbg(`mysql connection has failed to ${config.host}@${config.db}`, err)
+                return reject(err)
+            }
+            dbg(`mysql connection has been established to ${config.host}@${config.db}`)
+            // install a pinger every 30 seconds to keep the connection alive
+            if (pingInterval > 0)
+                setInterval(() => {
+                    mysql_client.ping(function (err:QueryError | null) {
+                        if (err) 
+                            return console.log(`could not ping mysql ${config.host}@${config.db}`, err.code)
+                        dbg(`mysql ${config.host}@${config.db} is pinging properly`)
+                    })
+                }, pingInterval)
+            resolve(mysql_client)
+        })
+    })
+}

package/ts/funcs/initMysql2Pool.d.ts

@@ -0,0 +1,3 @@
+import { Pool } from "mysql2";
+import { Mysql2ServerConfiguration } from "./getMysql2";
+export declare function initMysql2Pool(sqlServer: Mysql2ServerConfiguration): Pool;

package/ts/funcs/initMysql2Pool.js

@@ -0,0 +1,38 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initMysql2Pool = void 0;
+const mysql2 = __importStar(require("mysql2"));
+const debug_1 = __importDefault(require("debug"));
+const dbg = (0, debug_1.default)("initMysql2Pool");
+function initMysql2Pool(sqlServer) {
+    const connectionUri = `mysql://${sqlServer.login}:${sqlServer.password}@${sqlServer.host}`;
+    dbg(`creating mysql pool to ${sqlServer.host}@${sqlServer.db} as connectionUri=${connectionUri}`);
+    return mysql2.createPool(connectionUri);
+}
+exports.initMysql2Pool = initMysql2Pool;

package/ts/funcs/initMysql2Pool.ts

@@ -0,0 +1,11 @@
+import * as mysql2 from "mysql2"
+import { Pool } from "mysql2"
+import debug from "debug"
+import { Mysql2ServerConfiguration } from "./getMysql2"
+const dbg = debug("initMysql2Pool")
+
+export function initMysql2Pool(sqlServer: Mysql2ServerConfiguration): Pool {
+    const connectionUri = `mysql://${sqlServer.login}:${sqlServer.password}@${sqlServer.host}`
+    dbg(`creating mysql pool to ${sqlServer.host}@${sqlServer.db} as connectionUri=${connectionUri}`)
+    return mysql2.createPool(connectionUri)
+}

package/ts/funcs/isLoopbackIP.test.ts

@@ -63,7 +63,11 @@ describe('isLoopbackIP', () => {
     })
 
     test('random ips should not be Loopback', () => {
-        for(let i=0;i<100;i++)
-            expect(isLoopbackIP(randomIP())).toBe(false)
+        for(let i=0;i<100;i++){
+            let ip = isLoopbackIP(randomIP())
+            console.log(ip)
+            expect(ip).toBe(false)
+        }
+            
     })
 });

package/ts/funcs/randomUTFString.d.ts

@@ -0,0 +1 @@
+export declare function randomUTFString(minLength: number, maxLength: number, includeAscii?: boolean): string;

package/ts/funcs/randomUTFString.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.randomUTFString = void 0;
+function randomUTFString(minLength, maxLength, includeAscii = true) {
+    // Extended characters set including various languages and symbols
+    let characters = 'àáâãäåæçèéêëìíîïðñòóôõöøùúûüýÿ' + // Accented Latin characters
+        'ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩαβγδεζηθικλμνξοπρσςτυφχψω' + // Greek
+        'אבגדהוזחטיךכלםמןנסעפצקרשת' + // Hebrew
+        //Arabic
+        'ا ب ت ث ج ح خ د ذ ر ز س ش ص ض ط ظ ع غ ف ق ك ل م ن ه و ي' +
+        // Persian
+        'آ ا ب پ ت ث ج چ ح خ د ذ ر ز ژ س ش ص ض ط ظ ع غ ف ق ک گ ل م ن و ه ی' +
+        // Turkish
+        'ğıöşü' +
+        'ĞİÖŞÜ ' +
+        // More Emojis
+        '🙂🤔😍😂👍🚀❤️🎉' +
+        'бвгдежзийклмнопрстуфхцчшщъыьэюя' + // Cyrillic (Russian, etc.)
+        '日本語中文한국어' + // Japanese, Chinese, Korean characters
+        '🙂🤔😍😂👍🚀❤️🎉'; // Emojis
+    if (includeAscii)
+        characters += 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789';
+    const charactersLength = Array.from(characters).length;
+    const length = Math.floor(Math.random() * (maxLength - minLength + 1)) + minLength;
+    let result = '';
+    for (let i = 0; i < length; i++)
+        result += Array.from(characters)[Math.floor(Math.random() * charactersLength)];
+    return result;
+}
+exports.randomUTFString = randomUTFString;

package/ts/funcs/randomUTFString.test.ts

@@ -0,0 +1,44 @@
+import { randomUTFString } from './randomUTFString';
+
+describe('randomUTFString', () => {
+    const asciiCharacters = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789';
+    let extendedCharset =
+        'àáâãäåæçèéêëìíîïðñòóôõöøùúûüýÿ' + // Accented Latin characters
+        'ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩαβγδεζηθικλμνξοπρσςτυφχψω' + // Greek
+        'אבגדהוזחטיךכלםמןנסעפצקרשת' + // Hebrew
+        //Arabic
+        'ا ب ت ث ج ح خ د ذ ر ز س ش ص ض ط ظ ع غ ف ق ك ل م ن ه و ي' +
+        // Persian
+        'آ ا ب پ ت ث ج چ ح خ د ذ ر ز ژ س ش ص ض ط ظ ع غ ف ق ک گ ل م ن و ه ی' +
+        // Turkish
+        'a b c ç d e f g ğ h ı i j k l m n o ö p r s ş t u ü v y z' +
+        'A B C Ç D E F G Ğ H I İ J K L M N O Ö P R S Ş T U Ü V Y Z' +
+        // More Emojis
+        '🙂🤔😍😂👍🚀❤️🎉' +
+        'абвгдежзийклмнопрстуфхцчшщъыьэюя' + // Cyrillic (Russian, etc.)
+        '日本語中文한국어' + // Japanese, Chinese, Korean characters
+        '🙂🤔😍😂👍🚀❤️🎉' // Emojis
+    it('should generate a random string within the specified length range', () => {
+        const minLength = 5;
+        const maxLength = 10;
+        const result = randomUTFString(minLength, maxLength);
+        expect(result.length).toBeGreaterThanOrEqual(minLength);
+        expect(result.length).toBeLessThanOrEqual(maxLength+1); // utf8 characters can be 1-4 bytes long
+    });
+
+    it('should include ASCII characters by default', () => {
+        const result = randomUTFString(500, 400);
+        
+        expect(result).toMatch(new RegExp(`[${asciiCharacters}]`));
+    });
+
+    it('should exclude ASCII characters when includeAscii is set to false', () => {
+        const result = randomUTFString(500, 1000, false);
+        expect(result).not.toMatch(new RegExp(`[${asciiCharacters}]`));
+    });
+
+    it('should include extended characters when includeAscii is set to true', () => {
+        const result = randomUTFString(500, 1000, true);
+        expect(result).toMatch(new RegExp(`[${extendedCharset}]`));
+    });
+});

package/ts/funcs/randomUTFString.ts

@@ -0,0 +1,33 @@
+
+
+
+export function randomUTFString(minLength: number, maxLength: number, includeAscii:boolean=true): string {
+    // Extended characters set including various languages and symbols
+    let characters = 
+        'àáâãäåæçèéêëìíîïðñòóôõöøùúûüýÿ' + // Accented Latin characters
+        'ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩαβγδεζηθικλμνξοπρσςτυφχψω' + // Greek
+        'אבגדהוזחטיךכלםמןנסעפצקרשת' + // Hebrew
+        //Arabic
+        'ا ب ت ث ج ح خ د ذ ر ز س ش ص ض ط ظ ع غ ف ق ك ل م ن ه و ي' +
+        // Persian
+        'آ ا ب پ ت ث ج چ ح خ د ذ ر ز ژ س ش ص ض ط ظ ع غ ف ق ک گ ل م ن و ه ی' +
+        // Turkish
+        'ğıöşü' +
+        'ĞİÖŞÜ ' +
+        // More Emojis
+        '🙂🤔😍😂👍🚀❤️🎉' +
+        'бвгдежзийклмнопрстуфхцчшщъыьэюя' + // Cyrillic (Russian, etc.)
+        '日本語中文한국어' + // Japanese, Chinese, Korean characters
+        '🙂🤔😍😂👍🚀❤️🎉' // Emojis
+
+    if (includeAscii) characters += 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789'
+
+    const charactersLength = Array.from(characters).length
+    const length = Math.floor(Math.random() * (maxLength - minLength + 1)) + minLength
+    let result = ''
+
+    for (let i = 0; i < length; i++) 
+        result += Array.from(characters)[Math.floor(Math.random() * charactersLength)]
+    
+    return result
+}

package/ts/index.d.ts

@@ -18,3 +18,7 @@ export * from "./funcs/randomTCPPort";
 export * from "./funcs/validEmail";
 export * from "./funcs/isLoopbackIP";
 export * from "./funcs/isLANIp";
+export * from "./funcs/getMysql1";
+export * from "./funcs/getMysql2";
+export * from "./funcs/initMysql2Pool";
+export * from "./funcs/randomUTFString";

package/ts/index.js

@@ -34,3 +34,7 @@ __exportStar(require("./funcs/randomTCPPort"), exports);
 __exportStar(require("./funcs/validEmail"), exports);
 __exportStar(require("./funcs/isLoopbackIP"), exports);
 __exportStar(require("./funcs/isLANIp"), exports);
+__exportStar(require("./funcs/getMysql1"), exports);
+__exportStar(require("./funcs/getMysql2"), exports);
+__exportStar(require("./funcs/initMysql2Pool"), exports);
+__exportStar(require("./funcs/randomUTFString"), exports);

package/ts/index.ts

@@ -18,3 +18,7 @@ export * from "./funcs/randomTCPPort"
 export * from "./funcs/validEmail"
 export * from "./funcs/isLoopbackIP"
 export * from "./funcs/isLANIp"
+export * from "./funcs/getMysql1"
+export * from "./funcs/getMysql2"
+export * from "./funcs/initMysql2Pool"
+export * from "./funcs/randomUTFString"