@simonbackx/simple-database 1.36.0 → 1.36.4

package/dist/src/classes/Database.d.cts

@@ -0,0 +1,59 @@
+import { DatabaseStoredValue } from "./DatabaseStoredValue.cjs";
+import mysql from "mysql2/promise";
+
+//#region src/classes/Database.d.ts
+type SQLResultRow = Record<string, DatabaseStoredValue>;
+type SQLResultNamespacedRow = Record<string, SQLResultRow>;
+type SelectOptions = {
+  connection?: mysql.PoolConnection;
+  nestTables?: boolean;
+};
+type PoolOptions = {
+  debug?: boolean;
+  host?: string;
+  user?: string;
+  password?: string;
+  port?: number;
+  database?: string | null;
+  connectionLimit?: number;
+  multipleStatements?: boolean;
+  charset?: string;
+  useSSL?: boolean;
+  ca?: string;
+};
+declare class DatabaseInstance {
+  pool: mysql.Pool;
+  debug: boolean;
+  constructor(options?: PoolOptions);
+  createPool(options?: PoolOptions): void;
+  reload(options?: PoolOptions): Promise<void>;
+  setDebug(enabled?: boolean): void;
+  getConnection(): Promise<mysql.PoolConnection>;
+  escapeId(value: string): string;
+  end(): Promise<void>;
+  startQuery(): [number, number];
+  logQuery(q: any, hrstart: [number, number]): void;
+  finishQuery(q: any, hrstart: [number, number]): void;
+  select(query: string, values?: any, options?: SelectOptions & {
+    nestTables: true;
+  }): Promise<[SQLResultNamespacedRow[], mysql.FieldPacket[] | undefined]>;
+  select(query: string, values?: any, options?: SelectOptions & {
+    nestTables: false;
+  }): Promise<[SQLResultRow[], mysql.FieldPacket[] | undefined]>;
+  insert(query: string, values?: any, useConnection?: mysql.PoolConnection): Promise<[{
+    insertId: any;
+    affectedRows: number;
+  }, mysql.FieldPacket[] | undefined]>;
+  update(query: string, values?: any, useConnection?: mysql.PoolConnection): Promise<[{
+    changedRows: number;
+    affectedRows: number;
+  }, mysql.FieldPacket[] | undefined]>;
+  delete(query: string, values?: any, useConnection?: mysql.PoolConnection): Promise<[{
+    affectedRows: number;
+  }, mysql.FieldPacket[] | undefined]>;
+  statement(query: string, values?: any, useConnection?: mysql.PoolConnection): Promise<[any, any]>;
+}
+declare const Database: DatabaseInstance;
+//#endregion
+export { Database, DatabaseInstance, PoolOptions, SQLResultNamespacedRow, SQLResultRow };
+//# sourceMappingURL=Database.d.cts.map

package/dist/src/classes/Database.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Database.d.cts","names":[],"sources":["../../../src/classes/Database.ts"],"mappings":";;;;KAGY,YAAA,GAAe,MAAA,SAAe,mBAAA;AAAA,KAC9B,sBAAA,GAAyB,MAAA,SAAe,YAAA;AAAA,KAE/C,aAAA;EAAkB,UAAA,GAAa,KAAA,CAAM,cAAA;EAAgB,UAAA;AAAA;AAAA,KAC9C,WAAA;EACR,KAAA;EACA,IAAA;EACA,IAAA;EACA,QAAA;EACA,IAAA;EACA,QAAA;EACA,eAAA;EACA,kBAAA;EACA,OAAA;EACA,MAAA;EACA,EAAA;AAAA;AAAA,cAIS,gBAAA;EACT,IAAA,EAAM,KAAA,CAAM,IAAA;EACZ,KAAA;cAEY,OAAA,GAAS,WAAA;EAIrB,UAAA,CAAW,OAAA,GAAS,WAAA;EA2Dd,MAAA,CAAO,OAAA,GAAS,WAAA,GAAmB,OAAA;EAKzC,QAAA,CAAS,OAAA;EAIH,aAAA,CAAA,GAAiB,OAAA,CAAQ,KAAA,CAAM,cAAA;EAKrC,QAAA,CAAS,KAAA;EAIH,GAAA,CAAA,GAAO,OAAA;EAIb,UAAA,CAAA;EAIA,QAAA,CAAS,CAAA,OAAG,OAAA;EAOZ,WAAA,CAAY,CAAA,OAAG,OAAA;EAOf,MAAA,CAAO,KAAA,UAAe,MAAA,QAAc,OAAA,GAAU,aAAA;IAAkB,UAAA;EAAA,IAAqB,OAAA,EAAS,sBAAA,IAA0B,KAAA,CAAM,WAAA;EAC9H,MAAA,CAAO,KAAA,UAAe,MAAA,QAAc,OAAA,GAAU,aAAA;IAAkB,UAAA;EAAA,IAAsB,OAAA,EAAS,YAAA,IAAgB,KAAA,CAAM,WAAA;EAiB/G,MAAA,CACF,KAAA,UACA,MAAA,QACA,aAAA,GAAgB,KAAA,CAAM,cAAA,GACvB,OAAA;IAAW,QAAA;IAAe,YAAA;EAAA,GAAwB,KAAA,CAAM,WAAA;EAgBrD,MAAA,CAAO,KAAA,UAAe,MAAA,QAAc,aAAA,GAAgB,KAAA,CAAM,cAAA,GAAiB,OAAA;IACxD,WAAA;IAAqB,YAAA;EAAA,GACxC,KAAA,CAAM,WAAA;EAgBN,MAAA,CAAO,KAAA,UAAe,MAAA,QAAc,aAAA,GAAgB,KAAA,CAAM,cAAA,GAAiB,OAAA;IAAW,YAAA;EAAA,GAAwB,KAAA,CAAM,WAAA;EAgBpH,SAAA,CAAU,KAAA,UAAe,MAAA,QAAc,aAAA,GAAgB,KAAA,CAAM,cAAA,GAAiB,OAAA;AAAA;AAAA,cAiB3E,QAAA,EAAQ,gBAAA"}

package/dist/src/classes/Database.d.mts

@@ -0,0 +1,59 @@
+import { DatabaseStoredValue } from "./DatabaseStoredValue.mjs";
+import mysql from "mysql2/promise";
+
+//#region src/classes/Database.d.ts
+type SQLResultRow = Record<string, DatabaseStoredValue>;
+type SQLResultNamespacedRow = Record<string, SQLResultRow>;
+type SelectOptions = {
+  connection?: mysql.PoolConnection;
+  nestTables?: boolean;
+};
+type PoolOptions = {
+  debug?: boolean;
+  host?: string;
+  user?: string;
+  password?: string;
+  port?: number;
+  database?: string | null;
+  connectionLimit?: number;
+  multipleStatements?: boolean;
+  charset?: string;
+  useSSL?: boolean;
+  ca?: string;
+};
+declare class DatabaseInstance {
+  pool: mysql.Pool;
+  debug: boolean;
+  constructor(options?: PoolOptions);
+  createPool(options?: PoolOptions): void;
+  reload(options?: PoolOptions): Promise<void>;
+  setDebug(enabled?: boolean): void;
+  getConnection(): Promise<mysql.PoolConnection>;
+  escapeId(value: string): string;
+  end(): Promise<void>;
+  startQuery(): [number, number];
+  logQuery(q: any, hrstart: [number, number]): void;
+  finishQuery(q: any, hrstart: [number, number]): void;
+  select(query: string, values?: any, options?: SelectOptions & {
+    nestTables: true;
+  }): Promise<[SQLResultNamespacedRow[], mysql.FieldPacket[] | undefined]>;
+  select(query: string, values?: any, options?: SelectOptions & {
+    nestTables: false;
+  }): Promise<[SQLResultRow[], mysql.FieldPacket[] | undefined]>;
+  insert(query: string, values?: any, useConnection?: mysql.PoolConnection): Promise<[{
+    insertId: any;
+    affectedRows: number;
+  }, mysql.FieldPacket[] | undefined]>;
+  update(query: string, values?: any, useConnection?: mysql.PoolConnection): Promise<[{
+    changedRows: number;
+    affectedRows: number;
+  }, mysql.FieldPacket[] | undefined]>;
+  delete(query: string, values?: any, useConnection?: mysql.PoolConnection): Promise<[{
+    affectedRows: number;
+  }, mysql.FieldPacket[] | undefined]>;
+  statement(query: string, values?: any, useConnection?: mysql.PoolConnection): Promise<[any, any]>;
+}
+declare const Database: DatabaseInstance;
+//#endregion
+export { Database, DatabaseInstance, PoolOptions, SQLResultNamespacedRow, SQLResultRow };
+//# sourceMappingURL=Database.d.mts.map

package/dist/src/classes/Database.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Database.d.mts","names":[],"sources":["../../../src/classes/Database.ts"],"mappings":";;;;KAGY,YAAA,GAAe,MAAA,SAAe,mBAAA;AAAA,KAC9B,sBAAA,GAAyB,MAAA,SAAe,YAAA;AAAA,KAE/C,aAAA;EAAkB,UAAA,GAAa,KAAA,CAAM,cAAA;EAAgB,UAAA;AAAA;AAAA,KAC9C,WAAA;EACR,KAAA;EACA,IAAA;EACA,IAAA;EACA,QAAA;EACA,IAAA;EACA,QAAA;EACA,eAAA;EACA,kBAAA;EACA,OAAA;EACA,MAAA;EACA,EAAA;AAAA;AAAA,cAIS,gBAAA;EACT,IAAA,EAAM,KAAA,CAAM,IAAA;EACZ,KAAA;cAEY,OAAA,GAAS,WAAA;EAIrB,UAAA,CAAW,OAAA,GAAS,WAAA;EA2Dd,MAAA,CAAO,OAAA,GAAS,WAAA,GAAmB,OAAA;EAKzC,QAAA,CAAS,OAAA;EAIH,aAAA,CAAA,GAAiB,OAAA,CAAQ,KAAA,CAAM,cAAA;EAKrC,QAAA,CAAS,KAAA;EAIH,GAAA,CAAA,GAAO,OAAA;EAIb,UAAA,CAAA;EAIA,QAAA,CAAS,CAAA,OAAG,OAAA;EAOZ,WAAA,CAAY,CAAA,OAAG,OAAA;EAOf,MAAA,CAAO,KAAA,UAAe,MAAA,QAAc,OAAA,GAAU,aAAA;IAAkB,UAAA;EAAA,IAAqB,OAAA,EAAS,sBAAA,IAA0B,KAAA,CAAM,WAAA;EAC9H,MAAA,CAAO,KAAA,UAAe,MAAA,QAAc,OAAA,GAAU,aAAA;IAAkB,UAAA;EAAA,IAAsB,OAAA,EAAS,YAAA,IAAgB,KAAA,CAAM,WAAA;EAiB/G,MAAA,CACF,KAAA,UACA,MAAA,QACA,aAAA,GAAgB,KAAA,CAAM,cAAA,GACvB,OAAA;IAAW,QAAA;IAAe,YAAA;EAAA,GAAwB,KAAA,CAAM,WAAA;EAgBrD,MAAA,CAAO,KAAA,UAAe,MAAA,QAAc,aAAA,GAAgB,KAAA,CAAM,cAAA,GAAiB,OAAA;IACxD,WAAA;IAAqB,YAAA;EAAA,GACxC,KAAA,CAAM,WAAA;EAgBN,MAAA,CAAO,KAAA,UAAe,MAAA,QAAc,aAAA,GAAgB,KAAA,CAAM,cAAA,GAAiB,OAAA;IAAW,YAAA;EAAA,GAAwB,KAAA,CAAM,WAAA;EAgBpH,SAAA,CAAU,KAAA,UAAe,MAAA,QAAc,aAAA,GAAgB,KAAA,CAAM,cAAA,GAAiB,OAAA;AAAA;AAAA,cAiB3E,QAAA,EAAQ,gBAAA"}

package/dist/src/classes/Database.mjs

@@ -0,0 +1,155 @@
+import fs from "fs";
+import mysql from "mysql2/promise";
+//#region src/classes/Database.ts
+var DatabaseInstance = class {
+	pool;
+	debug = false;
+	constructor(options = {}) {
+		this.createPool(options);
+	}
+	createPool(options = {}) {
+		const settings = {
+			host: options.host ?? process.env.DB_HOST ?? "localhost",
+			user: options.user ?? process.env.DB_USER ?? "root",
+			password: options.password ?? process.env.DB_PASS ?? "root",
+			port: options.port ? options.port : parseInt(process.env.DB_PORT ?? "3306"),
+			database: options.database === void 0 ? process.env.DB_DATABASE : options.database,
+			connectionLimit: options.connectionLimit ? options.connectionLimit : parseInt(process.env.DB_CONNECTION_LIMIT ?? "10"),
+			multipleStatements: options.multipleStatements ?? (process.env.DB_MULTIPLE_STATEMENTS ?? "true") === "true",
+			charset: options.charset ?? process.env.DB_CHARSET ?? "utf8mb4_0900_ai_ci",
+			useSSL: options.useSSL ?? !!process.env.DB_USE_SSL,
+			ca: options.ca ?? process.env.DB_CA
+		};
+		if (settings.database === void 0) throw new Error("Environment variable DB_DATABASE is missing");
+		this.pool = mysql.createPool({
+			host: settings.host,
+			user: settings.user,
+			password: settings.password,
+			port: settings.port,
+			database: settings.database ?? void 0,
+			waitForConnections: true,
+			connectionLimit: settings.connectionLimit,
+			queueLimit: 0,
+			multipleStatements: settings.multipleStatements,
+			charset: settings.charset,
+			decimalNumbers: true,
+			jsonStrings: true,
+			ssl: settings.useSSL ? {
+				ca: settings.ca ? fs.readFileSync(settings.ca) : void 0,
+				rejectUnauthorized: settings.ca ? true : false
+			} : void 0
+		});
+		this.debug = options?.debug ?? false;
+		if (this.debug) {
+			this.pool.on("acquire", function(connection) {
+				console.log("Connection %d acquired", connection.threadId);
+			});
+			this.pool.on("connection", function(connection) {
+				console.log("Connection %d created", connection.threadId);
+			});
+			this.pool.on("enqueue", function() {
+				console.log("Waiting for available connection slot");
+			});
+			this.pool.on("release", function(connection) {
+				console.log("Connection %d released", connection.threadId);
+			});
+		}
+	}
+	async reload(options = {}) {
+		await this.pool.end();
+		this.createPool(options);
+	}
+	setDebug(enabled = true) {
+		this.debug = enabled;
+	}
+	async getConnection() {
+		return await this.pool.getConnection();
+	}
+	escapeId(value) {
+		return this.pool.escapeId(value);
+	}
+	async end() {
+		return await this.pool.end();
+	}
+	startQuery() {
+		return process.hrtime();
+	}
+	logQuery(q, hrstart) {
+		if (this.debug) {
+			const hrend = process.hrtime(hrstart);
+			console.warn(q.sql.replace(/\n+ +/g, "\n"), "started at " + (hrend[0] * 1e3 + hrend[1] / 1e6) + "ms");
+		}
+	}
+	finishQuery(q, hrstart) {
+		if (this.debug) {
+			const hrend = process.hrtime(hrstart);
+			console.log(q.sql.replace(/\s+/g, " "), "in " + (hrend[0] * 1e3 + hrend[1] / 1e6) + "ms");
+		}
+	}
+	async select(query, values, options = {}) {
+		const connection = options.connection ?? await this.getConnection();
+		try {
+			const q = await connection.query({
+				sql: query,
+				nestTables: options.nestTables ?? true,
+				values
+			});
+			return [q[0], q[1]];
+		} finally {
+			if (!options.connection) connection.release();
+		}
+	}
+	async insert(query, values, useConnection) {
+		const connection = useConnection ?? await this.getConnection();
+		try {
+			const q = await connection.query({
+				sql: query,
+				values
+			});
+			return [q[0], q[1]];
+		} finally {
+			if (!useConnection) connection.release();
+		}
+	}
+	async update(query, values, useConnection) {
+		const connection = useConnection ?? await this.getConnection();
+		try {
+			const q = await connection.query({
+				sql: query,
+				values
+			});
+			return [q[0], q[1]];
+		} finally {
+			if (!useConnection) connection.release();
+		}
+	}
+	async delete(query, values, useConnection) {
+		const connection = useConnection ?? await this.getConnection();
+		try {
+			const q = await connection.query({
+				sql: query,
+				values
+			});
+			return [q[0], q[1]];
+		} finally {
+			if (!useConnection) connection.release();
+		}
+	}
+	async statement(query, values, useConnection) {
+		const connection = useConnection ?? await this.getConnection();
+		try {
+			const q = await connection.query({
+				sql: query,
+				values
+			});
+			return [q[0], q[1]];
+		} finally {
+			if (!useConnection) connection.release();
+		}
+	}
+};
+const Database = new DatabaseInstance();
+//#endregion
+export { Database, DatabaseInstance };
+
+//# sourceMappingURL=Database.mjs.map

package/dist/src/classes/Database.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Database.mjs","names":[],"sources":["../../../src/classes/Database.ts"],"sourcesContent":["import fs from 'fs';\nimport mysql from 'mysql2/promise';\nimport { type DatabaseStoredValue } from './DatabaseStoredValue.js';\nexport type SQLResultRow = Record<string, DatabaseStoredValue>;\nexport type SQLResultNamespacedRow = Record<string, SQLResultRow>;\n\ntype SelectOptions = { connection?: mysql.PoolConnection; nestTables?: boolean };\nexport type PoolOptions = {\n    debug?: boolean;\n    host?: string;\n    user?: string;\n    password?: string;\n    port?: number;\n    database?: string | null; // set to null to not use a default database\n    connectionLimit?: number;\n    multipleStatements?: boolean;\n    charset?: string;\n    useSSL?: boolean;\n    ca?: string;\n};\n\n/// Database is a wrapper arround mysql, because we want to use promises + types\nexport class DatabaseInstance {\n    pool: mysql.Pool;\n    debug = false;\n\n    constructor(options: PoolOptions = {}) {\n        this.createPool(options);\n    }\n\n    createPool(options: PoolOptions = {}) {\n        const settings = {\n            host: options.host ?? process.env.DB_HOST ?? 'localhost',\n            user: options.user ?? process.env.DB_USER ?? 'root',\n            password: options.password ?? process.env.DB_PASS ?? 'root',\n            port: options.port ? options.port : parseInt(process.env.DB_PORT ?? '3306'),\n            database: options.database === undefined ? process.env.DB_DATABASE : options.database,\n            connectionLimit: options.connectionLimit ? options.connectionLimit : parseInt(process.env.DB_CONNECTION_LIMIT ?? '10'),\n            multipleStatements: options.multipleStatements ?? ((process.env.DB_MULTIPLE_STATEMENTS ?? 'true') === 'true'),\n            charset: options.charset ?? process.env.DB_CHARSET ?? 'utf8mb4_0900_ai_ci',\n            useSSL: options.useSSL ?? !!process.env.DB_USE_SSL,\n            ca: options.ca ?? process.env.DB_CA,\n        };\n\n        if (settings.database === undefined) {\n            throw new Error('Environment variable DB_DATABASE is missing');\n        }\n\n        this.pool = mysql.createPool({\n            host: settings.host,\n            user: settings.user,\n            password: settings.password,\n            port: settings.port,\n            database: settings.database ?? undefined,\n            waitForConnections: true,\n            connectionLimit: settings.connectionLimit,\n            queueLimit: 0,\n            multipleStatements: settings.multipleStatements,\n            charset: settings.charset,\n            decimalNumbers: true,\n            jsonStrings: true,\n            ssl: settings.useSSL\n                ? {\n                        ca: settings.ca ? fs.readFileSync(settings.ca) : undefined,\n                        rejectUnauthorized: settings.ca ? true : false,\n                    }\n                : undefined,\n        });\n        this.debug = options?.debug ?? false;\n\n        if (this.debug) {\n            this.pool.on('acquire', function (connection) {\n                console.log('Connection %d acquired', connection.threadId);\n            });\n\n            this.pool.on('connection', function (connection) {\n                console.log('Connection %d created', connection.threadId);\n            });\n\n            this.pool.on('enqueue', function () {\n                console.log('Waiting for available connection slot');\n            });\n\n            this.pool.on('release', function (connection) {\n                console.log('Connection %d released', connection.threadId);\n            });\n        }\n    }\n\n    async reload(options: PoolOptions = {}): Promise<void> {\n        await this.pool.end();\n        this.createPool(options);\n    }\n\n    setDebug(enabled = true) {\n        this.debug = enabled;\n    }\n\n    async getConnection(): Promise<mysql.PoolConnection> {\n        // Todo: use the settings here to provide a good connection pool\n        return await this.pool.getConnection();\n    }\n\n    escapeId(value: string): string {\n        return this.pool.escapeId(value);\n    }\n\n    async end(): Promise<void> {\n        return await this.pool.end();\n    }\n\n    startQuery(): [number, number] {\n        return process.hrtime();\n    }\n\n    logQuery(q, hrstart: [number, number]) {\n        if (this.debug) {\n            const hrend = process.hrtime(hrstart);\n            console.warn(q.sql.replace(/\\n+ +/g, '\\n'), 'started at ' + (hrend[0] * 1000 + hrend[1] / 1000000) + 'ms');\n        }\n    }\n\n    finishQuery(q, hrstart: [number, number]) {\n        if (this.debug) {\n            const hrend = process.hrtime(hrstart);\n            console.log(q.sql.replace(/\\s+/g, ' '), 'in ' + (hrend[0] * 1000 + hrend[1] / 1000000) + 'ms');\n        }\n    }\n\n    select(query: string, values?: any, options?: SelectOptions & { nestTables: true }): Promise<[SQLResultNamespacedRow[], mysql.FieldPacket[] | undefined]>;\n    select(query: string, values?: any, options?: SelectOptions & { nestTables: false }): Promise<[SQLResultRow[], mysql.FieldPacket[] | undefined]>;\n    async select(query: string, values?: any, options: SelectOptions = {}): Promise<[(SQLResultNamespacedRow | SQLResultRow)[], mysql.FieldPacket[] | undefined]> {\n        const connection: mysql.PoolConnection = options.connection ?? (await this.getConnection());\n        try {\n            const q = await connection.query({ sql: query, nestTables: options.nestTables ?? true, values: values });\n            return [\n                q[0] as (SQLResultNamespacedRow | SQLResultRow)[],\n                q[1] as mysql.FieldPacket[] | undefined,\n            ];\n        }\n        finally {\n            if (!options.connection) {\n                connection.release();\n            }\n        }\n    }\n\n    async insert(\n        query: string,\n        values?: any,\n        useConnection?: mysql.PoolConnection,\n    ): Promise<[{ insertId: any; affectedRows: number }, mysql.FieldPacket[] | undefined]> {\n        const connection: mysql.PoolConnection = useConnection ?? (await this.getConnection());\n        try {\n            const q = await connection.query({ sql: query, values: values });\n            return [\n                q[0] as { insertId: any; affectedRows: number },\n                q[1] as mysql.FieldPacket[] | undefined,\n            ];\n        }\n        finally {\n            if (!useConnection) {\n                connection.release();\n            }\n        }\n    }\n\n    async update(query: string, values?: any, useConnection?: mysql.PoolConnection): Promise<[\n        { /** @deprecated */ changedRows: number; affectedRows: number }\n        , mysql.FieldPacket[] | undefined]> {\n        const connection: mysql.PoolConnection = useConnection ?? (await this.getConnection());\n        try {\n            const q = await connection.query({ sql: query, values: values });\n            return [\n                q[0] as { changedRows: number; affectedRows: number },\n                q[1] as mysql.FieldPacket[] | undefined,\n            ];\n        }\n        finally {\n            if (!useConnection) {\n                connection.release();\n            }\n        }\n    }\n\n    async delete(query: string, values?: any, useConnection?: mysql.PoolConnection): Promise<[{ affectedRows: number }, mysql.FieldPacket[] | undefined]> {\n        const connection: mysql.PoolConnection = useConnection ?? (await this.getConnection());\n        try {\n            const q = await connection.query({ sql: query, values: values });\n            return [\n                q[0] as { affectedRows: number },\n                q[1] as mysql.FieldPacket[] | undefined,\n            ];\n        }\n        finally {\n            if (!useConnection) {\n                connection.release();\n            }\n        }\n    }\n\n    async statement(query: string, values?: any, useConnection?: mysql.PoolConnection): Promise<[any, any]> {\n        const connection: mysql.PoolConnection = useConnection ?? (await this.getConnection());\n        try {\n            const q = await connection.query({ sql: query, values: values });\n            return [\n                q[0] as any,\n                q[1] as any,\n            ];\n        }\n        finally {\n            if (!useConnection) {\n                connection.release();\n            }\n        }\n    }\n}\n\nexport const Database = new DatabaseInstance();\n"],"mappings":";;;AAsBA,IAAa,mBAAb,MAA8B;CAC1B;CACA,QAAQ;CAER,YAAY,UAAuB,EAAE,EAAE;AACnC,OAAK,WAAW,QAAQ;;CAG5B,WAAW,UAAuB,EAAE,EAAE;EAClC,MAAM,WAAW;GACb,MAAM,QAAQ,QAAQ,QAAQ,IAAI,WAAW;GAC7C,MAAM,QAAQ,QAAQ,QAAQ,IAAI,WAAW;GAC7C,UAAU,QAAQ,YAAY,QAAQ,IAAI,WAAW;GACrD,MAAM,QAAQ,OAAO,QAAQ,OAAO,SAAS,QAAQ,IAAI,WAAW,OAAO;GAC3E,UAAU,QAAQ,aAAa,KAAA,IAAY,QAAQ,IAAI,cAAc,QAAQ;GAC7E,iBAAiB,QAAQ,kBAAkB,QAAQ,kBAAkB,SAAS,QAAQ,IAAI,uBAAuB,KAAK;GACtH,oBAAoB,QAAQ,uBAAwB,QAAQ,IAAI,0BAA0B,YAAY;GACtG,SAAS,QAAQ,WAAW,QAAQ,IAAI,cAAc;GACtD,QAAQ,QAAQ,UAAU,CAAC,CAAC,QAAQ,IAAI;GACxC,IAAI,QAAQ,MAAM,QAAQ,IAAI;GACjC;AAED,MAAI,SAAS,aAAa,KAAA,EACtB,OAAM,IAAI,MAAM,8CAA8C;AAGlE,OAAK,OAAO,MAAM,WAAW;GACzB,MAAM,SAAS;GACf,MAAM,SAAS;GACf,UAAU,SAAS;GACnB,MAAM,SAAS;GACf,UAAU,SAAS,YAAY,KAAA;GAC/B,oBAAoB;GACpB,iBAAiB,SAAS;GAC1B,YAAY;GACZ,oBAAoB,SAAS;GAC7B,SAAS,SAAS;GAClB,gBAAgB;GAChB,aAAa;GACb,KAAK,SAAS,SACR;IACM,IAAI,SAAS,KAAK,GAAG,aAAa,SAAS,GAAG,GAAG,KAAA;IACjD,oBAAoB,SAAS,KAAK,OAAO;IAC5C,GACH,KAAA;GACT,CAAC;AACF,OAAK,QAAQ,SAAS,SAAS;AAE/B,MAAI,KAAK,OAAO;AACZ,QAAK,KAAK,GAAG,WAAW,SAAU,YAAY;AAC1C,YAAQ,IAAI,0BAA0B,WAAW,SAAS;KAC5D;AAEF,QAAK,KAAK,GAAG,cAAc,SAAU,YAAY;AAC7C,YAAQ,IAAI,yBAAyB,WAAW,SAAS;KAC3D;AAEF,QAAK,KAAK,GAAG,WAAW,WAAY;AAChC,YAAQ,IAAI,wCAAwC;KACtD;AAEF,QAAK,KAAK,GAAG,WAAW,SAAU,YAAY;AAC1C,YAAQ,IAAI,0BAA0B,WAAW,SAAS;KAC5D;;;CAIV,MAAM,OAAO,UAAuB,EAAE,EAAiB;AACnD,QAAM,KAAK,KAAK,KAAK;AACrB,OAAK,WAAW,QAAQ;;CAG5B,SAAS,UAAU,MAAM;AACrB,OAAK,QAAQ;;CAGjB,MAAM,gBAA+C;AAEjD,SAAO,MAAM,KAAK,KAAK,eAAe;;CAG1C,SAAS,OAAuB;AAC5B,SAAO,KAAK,KAAK,SAAS,MAAM;;CAGpC,MAAM,MAAqB;AACvB,SAAO,MAAM,KAAK,KAAK,KAAK;;CAGhC,aAA+B;AAC3B,SAAO,QAAQ,QAAQ;;CAG3B,SAAS,GAAG,SAA2B;AACnC,MAAI,KAAK,OAAO;GACZ,MAAM,QAAQ,QAAQ,OAAO,QAAQ;AACrC,WAAQ,KAAK,EAAE,IAAI,QAAQ,UAAU,KAAK,EAAE,iBAAiB,MAAM,KAAK,MAAO,MAAM,KAAK,OAAW,KAAK;;;CAIlH,YAAY,GAAG,SAA2B;AACtC,MAAI,KAAK,OAAO;GACZ,MAAM,QAAQ,QAAQ,OAAO,QAAQ;AACrC,WAAQ,IAAI,EAAE,IAAI,QAAQ,QAAQ,IAAI,EAAE,SAAS,MAAM,KAAK,MAAO,MAAM,KAAK,OAAW,KAAK;;;CAMtG,MAAM,OAAO,OAAe,QAAc,UAAyB,EAAE,EAAyF;EAC1J,MAAM,aAAmC,QAAQ,cAAe,MAAM,KAAK,eAAe;AAC1F,MAAI;GACA,MAAM,IAAI,MAAM,WAAW,MAAM;IAAE,KAAK;IAAO,YAAY,QAAQ,cAAc;IAAc;IAAQ,CAAC;AACxG,UAAO,CACH,EAAE,IACF,EAAE,GACL;YAEG;AACJ,OAAI,CAAC,QAAQ,WACT,YAAW,SAAS;;;CAKhC,MAAM,OACF,OACA,QACA,eACmF;EACnF,MAAM,aAAmC,iBAAkB,MAAM,KAAK,eAAe;AACrF,MAAI;GACA,MAAM,IAAI,MAAM,WAAW,MAAM;IAAE,KAAK;IAAe;IAAQ,CAAC;AAChE,UAAO,CACH,EAAE,IACF,EAAE,GACL;YAEG;AACJ,OAAI,CAAC,cACD,YAAW,SAAS;;;CAKhC,MAAM,OAAO,OAAe,QAAc,eAEF;EACpC,MAAM,aAAmC,iBAAkB,MAAM,KAAK,eAAe;AACrF,MAAI;GACA,MAAM,IAAI,MAAM,WAAW,MAAM;IAAE,KAAK;IAAe;IAAQ,CAAC;AAChE,UAAO,CACH,EAAE,IACF,EAAE,GACL;YAEG;AACJ,OAAI,CAAC,cACD,YAAW,SAAS;;;CAKhC,MAAM,OAAO,OAAe,QAAc,eAA4G;EAClJ,MAAM,aAAmC,iBAAkB,MAAM,KAAK,eAAe;AACrF,MAAI;GACA,MAAM,IAAI,MAAM,WAAW,MAAM;IAAE,KAAK;IAAe;IAAQ,CAAC;AAChE,UAAO,CACH,EAAE,IACF,EAAE,GACL;YAEG;AACJ,OAAI,CAAC,cACD,YAAW,SAAS;;;CAKhC,MAAM,UAAU,OAAe,QAAc,eAA2D;EACpG,MAAM,aAAmC,iBAAkB,MAAM,KAAK,eAAe;AACrF,MAAI;GACA,MAAM,IAAI,MAAM,WAAW,MAAM;IAAE,KAAK;IAAe;IAAQ,CAAC;AAChE,UAAO,CACH,EAAE,IACF,EAAE,GACL;YAEG;AACJ,OAAI,CAAC,cACD,YAAW,SAAS;;;;AAMpC,MAAa,WAAW,IAAI,kBAAkB"}

package/dist/src/classes/DatabaseStoredValue.d.cts

@@ -0,0 +1,5 @@
+//#region src/classes/DatabaseStoredValue.d.ts
+type DatabaseStoredValue = string | number | Date | null;
+//#endregion
+export { DatabaseStoredValue };
+//# sourceMappingURL=DatabaseStoredValue.d.cts.map

package/dist/src/classes/DatabaseStoredValue.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DatabaseStoredValue.d.cts","names":[],"sources":["../../../src/classes/DatabaseStoredValue.ts"],"mappings":";KAAY,mBAAA,qBAAwC,IAAA"}

package/dist/src/classes/DatabaseStoredValue.d.mts

@@ -0,0 +1,5 @@
+//#region src/classes/DatabaseStoredValue.d.ts
+type DatabaseStoredValue = string | number | Date | null;
+//#endregion
+export { DatabaseStoredValue };
+//# sourceMappingURL=DatabaseStoredValue.d.mts.map

package/dist/src/classes/DatabaseStoredValue.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DatabaseStoredValue.d.mts","names":[],"sources":["../../../src/classes/DatabaseStoredValue.ts"],"mappings":";KAAY,mBAAA,qBAAwC,IAAA"}

package/dist/src/classes/Factory.cjs

@@ -0,0 +1,48 @@
+const require_boys = require("./data/boys.cjs");
+const require_family_names = require("./data/family-names.cjs");
+const require_girls = require("./data/girls.cjs");
+//#region src/classes/Factory.ts
+var Factory = class {
+	options;
+	constructor(options) {
+		this.options = options;
+	}
+	randomArray(arr) {
+		return arr[Math.floor(Math.random() * arr.length)];
+	}
+	randomEnum(e) {
+		return this.randomArray(Object.values(e));
+	}
+	randomString(length) {
+		let result = "";
+		const characters = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
+		const charactersLength = 62;
+		for (let i = 0; i < length; i++) result += characters.charAt(Math.floor(Math.random() * charactersLength));
+		return result;
+	}
+	randomFirstName(gender) {
+		let names;
+		switch (gender) {
+			case "Male":
+				names = require_boys.default;
+				break;
+			case "Female":
+				names = require_girls.default;
+				break;
+			case "Other":
+				names = [...require_boys.default, ...require_girls.default];
+				break;
+		}
+		return this.randomArray(names);
+	}
+	randomLastName() {
+		return this.randomArray(require_family_names.default);
+	}
+	async createMultiple(amount = 40) {
+		const arr = [];
+		for (let index = 0; index < amount; index++) arr.push(await this.create());
+		return arr;
+	}
+};
+//#endregion
+exports.Factory = Factory;

package/dist/src/classes/Factory.d.cts

@@ -0,0 +1,17 @@
+//#region src/classes/Factory.d.ts
+declare abstract class Factory<Options, Model> {
+  options: Options;
+  constructor(options: Options);
+  abstract create(): Promise<Model>;
+  randomArray(arr: Array<any>): any;
+  randomEnum<E extends {
+    [key: number]: string | number;
+  }>(e: E): E[keyof E];
+  randomString(length: number): string;
+  randomFirstName(gender: 'Male' | 'Female' | 'Other'): string;
+  randomLastName(): string;
+  createMultiple(amount?: number): Promise<Model[]>;
+}
+//#endregion
+export { Factory };
+//# sourceMappingURL=Factory.d.cts.map

package/dist/src/classes/Factory.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Factory.d.cts","names":[],"sources":["../../../src/classes/Factory.ts"],"mappings":";uBAIsB,OAAA;EAClB,OAAA,EAAS,OAAA;cACG,OAAA,EAAS,OAAA;EAAA,SAGZ,MAAA,CAAA,GAAU,OAAA,CAAQ,KAAA;EAE3B,WAAA,CAAY,GAAA,EAAK,KAAA;EAKjB,UAAA;IAAA,CAAwB,GAAA;EAAA,EAAA,CAAiC,CAAA,EAAG,CAAA,GAAI,CAAA,OAAQ,CAAA;EAIxE,YAAA,CAAa,MAAA;EAUb,eAAA,CAAgB,MAAA;EAgBhB,cAAA,CAAA;EAIM,cAAA,CAAe,MAAA,YAAc,OAAA,CAAQ,KAAA;AAAA"}

package/dist/src/classes/Factory.d.mts

@@ -0,0 +1,17 @@
+//#region src/classes/Factory.d.ts
+declare abstract class Factory<Options, Model> {
+  options: Options;
+  constructor(options: Options);
+  abstract create(): Promise<Model>;
+  randomArray(arr: Array<any>): any;
+  randomEnum<E extends {
+    [key: number]: string | number;
+  }>(e: E): E[keyof E];
+  randomString(length: number): string;
+  randomFirstName(gender: 'Male' | 'Female' | 'Other'): string;
+  randomLastName(): string;
+  createMultiple(amount?: number): Promise<Model[]>;
+}
+//#endregion
+export { Factory };
+//# sourceMappingURL=Factory.d.mts.map

package/dist/src/classes/Factory.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Factory.d.mts","names":[],"sources":["../../../src/classes/Factory.ts"],"mappings":";uBAIsB,OAAA;EAClB,OAAA,EAAS,OAAA;cACG,OAAA,EAAS,OAAA;EAAA,SAGZ,MAAA,CAAA,GAAU,OAAA,CAAQ,KAAA;EAE3B,WAAA,CAAY,GAAA,EAAK,KAAA;EAKjB,UAAA;IAAA,CAAwB,GAAA;EAAA,EAAA,CAAiC,CAAA,EAAG,CAAA,GAAI,CAAA,OAAQ,CAAA;EAIxE,YAAA,CAAa,MAAA;EAUb,eAAA,CAAgB,MAAA;EAgBhB,cAAA,CAAA;EAIM,cAAA,CAAe,MAAA,YAAc,OAAA,CAAQ,KAAA;AAAA"}

package/dist/src/classes/Factory.mjs

@@ -0,0 +1,50 @@
+import boys_default from "./data/boys.mjs";
+import family_names_default from "./data/family-names.mjs";
+import girls_default from "./data/girls.mjs";
+//#region src/classes/Factory.ts
+var Factory = class {
+	options;
+	constructor(options) {
+		this.options = options;
+	}
+	randomArray(arr) {
+		return arr[Math.floor(Math.random() * arr.length)];
+	}
+	randomEnum(e) {
+		return this.randomArray(Object.values(e));
+	}
+	randomString(length) {
+		let result = "";
+		const characters = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
+		const charactersLength = 62;
+		for (let i = 0; i < length; i++) result += characters.charAt(Math.floor(Math.random() * charactersLength));
+		return result;
+	}
+	randomFirstName(gender) {
+		let names;
+		switch (gender) {
+			case "Male":
+				names = boys_default;
+				break;
+			case "Female":
+				names = girls_default;
+				break;
+			case "Other":
+				names = [...boys_default, ...girls_default];
+				break;
+		}
+		return this.randomArray(names);
+	}
+	randomLastName() {
+		return this.randomArray(family_names_default);
+	}
+	async createMultiple(amount = 40) {
+		const arr = [];
+		for (let index = 0; index < amount; index++) arr.push(await this.create());
+		return arr;
+	}
+};
+//#endregion
+export { Factory };
+
+//# sourceMappingURL=Factory.mjs.map

package/dist/src/classes/Factory.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Factory.mjs","names":["BoyNames","GirlNames","FamilyNames"],"sources":["../../../src/classes/Factory.ts"],"sourcesContent":["import BoyNames from './data/boys.js';\nimport FamilyNames from './data/family-names.js';\nimport GirlNames from './data/girls.js';\n\nexport abstract class Factory<Options, Model> {\n    options: Options;\n    constructor(options: Options) {\n        this.options = options;\n    }\n    abstract create(): Promise<Model>;\n\n    randomArray(arr: Array<any>): any {\n        const int = Math.floor(Math.random() * arr.length);\n        return arr[int];\n    }\n\n    randomEnum<E extends { [key: number]: string | number }>(e: E): E[keyof E] {\n        return this.randomArray(Object.values(e));\n    }\n\n    randomString(length: number): string {\n        let result = '';\n        const characters = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';\n        const charactersLength = characters.length;\n        for (let i = 0; i < length; i++) {\n            result += characters.charAt(Math.floor(Math.random() * charactersLength));\n        }\n        return result;\n    }\n\n    randomFirstName(gender: 'Male' | 'Female' | 'Other'): string {\n        let names: string[];\n        switch (gender) {\n            case 'Male':\n                names = BoyNames;\n                break;\n            case 'Female':\n                names = GirlNames;\n                break;\n            case 'Other':\n                names = [...BoyNames, ...GirlNames];\n                break;\n        }\n        return this.randomArray(names);\n    }\n\n    randomLastName(): string {\n        return this.randomArray(FamilyNames);\n    }\n\n    async createMultiple(amount = 40): Promise<Model[]> {\n        const arr: Model[] = [];\n        for (let index = 0; index < amount; index++) {\n            arr.push(await this.create());\n        }\n        return arr;\n    }\n}\n"],"mappings":";;;;AAIA,IAAsB,UAAtB,MAA8C;CAC1C;CACA,YAAY,SAAkB;AAC1B,OAAK,UAAU;;CAInB,YAAY,KAAsB;AAE9B,SAAO,IADK,KAAK,MAAM,KAAK,QAAQ,GAAG,IAAI,OAAO;;CAItD,WAAyD,GAAkB;AACvE,SAAO,KAAK,YAAY,OAAO,OAAO,EAAE,CAAC;;CAG7C,aAAa,QAAwB;EACjC,IAAI,SAAS;EACb,MAAM,aAAa;EACnB,MAAM,mBAAmB;AACzB,OAAK,IAAI,IAAI,GAAG,IAAI,QAAQ,IACxB,WAAU,WAAW,OAAO,KAAK,MAAM,KAAK,QAAQ,GAAG,iBAAiB,CAAC;AAE7E,SAAO;;CAGX,gBAAgB,QAA6C;EACzD,IAAI;AACJ,UAAQ,QAAR;GACI,KAAK;AACD,YAAQA;AACR;GACJ,KAAK;AACD,YAAQC;AACR;GACJ,KAAK;AACD,YAAQ,CAAC,GAAGD,cAAU,GAAGC,cAAU;AACnC;;AAER,SAAO,KAAK,YAAY,MAAM;;CAGlC,iBAAyB;AACrB,SAAO,KAAK,YAAYC,qBAAY;;CAGxC,MAAM,eAAe,SAAS,IAAsB;EAChD,MAAM,MAAe,EAAE;AACvB,OAAK,IAAI,QAAQ,GAAG,QAAQ,QAAQ,QAChC,KAAI,KAAK,MAAM,KAAK,QAAQ,CAAC;AAEjC,SAAO"}