easy-postgresql 0.0.1

package/dist/operations/connect_to_server.js

@@ -0,0 +1,108 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.connectToServer = exports.isConnected = void 0;
+exports.getPool = getPool;
+const pg_1 = require("pg");
+const config_1 = require("./config");
+const log_1 = require("./log");
+let pool = null;
+function getPool() {
+    if (!pool)
+        throw new Error('Database not connected. Call Connect() first.');
+    return pool;
+}
+/**
+ * This function checks if the database connection is active
+ *
+ * @returns Promise<boolean> - Returns true if connection is active, false otherwise
+ */
+const isConnected = async () => {
+    try {
+        const p = getPool();
+        const client = await p.connect();
+        try {
+            await client.query('SELECT 1');
+        }
+        finally {
+            client.release();
+        }
+        return { status: 200, message: 'OK' };
+    }
+    catch (err) {
+        return { status: 500, message: 'Error: ' + String(err) };
+    }
+};
+exports.isConnected = isConnected;
+/**
+ * This function is used to connect to the database.
+ *
+ * @param sqlConfig - The PostgreSQL configuration to connect to the database
+ * @param run - Optional callback function to be executed after the connection is established
+ * @returns Promise<boolean> - Returns true if connection is successful, false otherwise
+ */
+const connectToServer = async (sqlConfig, run) => {
+    if (!sqlConfig || typeof sqlConfig !== 'object') {
+        if (config_1.config.get.logingMode())
+            (0, log_1.log)('Connection', null, 'The sqlConfig parameter is not an object.');
+        return false;
+    }
+    const required = { user: "string", password: "string", host: "string", database: "string" };
+    for (const key in required) {
+        if (!sqlConfig[key] || typeof sqlConfig[key] !== required[key]) {
+            if (config_1.config.get.logingMode())
+                (0, log_1.log)('Connection', null, `The ${key} parameter is not a ${required[key]}.`);
+            return false;
+        }
+    }
+    pool = new pg_1.Pool({
+        user: sqlConfig.user,
+        password: sqlConfig.password,
+        host: sqlConfig.host,
+        port: sqlConfig.port || 5432,
+        database: sqlConfig.database,
+    });
+    const maxRetries = 3;
+    const retryInterval = 2500;
+    let retryCount = 0;
+    const tryConnect = async () => {
+        try {
+            const client = await pool.connect();
+            try {
+                await client.query('SELECT 1');
+            }
+            finally {
+                client.release();
+            }
+            if (run && typeof run === 'function') {
+                run(sqlConfig);
+            }
+            if (config_1.config.get.logingMode())
+                (0, log_1.log)('Connection', null, 'Success');
+            return true;
+        }
+        catch (err) {
+            if (config_1.config.get.logingMode())
+                (0, log_1.log)('Connection', 'Attempt', `${retryCount + 1}: ${err instanceof Error ? err.message : String(err)}`);
+            if (run && typeof run === 'function') {
+                run(sqlConfig, err instanceof Error ? err : new Error(String(err)));
+            }
+            return false;
+        }
+    };
+    while (retryCount < maxRetries) {
+        const result = await tryConnect();
+        if (result)
+            return true;
+        retryCount++;
+        if (retryCount < maxRetries) {
+            if (config_1.config.get.logingMode())
+                (0, log_1.log)('Connection', 'Retry', `Retrying in 2.5s... (Attempt ${retryCount + 1}/${maxRetries})`);
+            await new Promise(resolve => setTimeout(resolve, retryInterval));
+        }
+    }
+    if (config_1.config.get.logingMode())
+        (0, log_1.log)('Connection', null, `Failed after ${maxRetries} attempts`);
+    return false;
+};
+exports.connectToServer = connectToServer;
+//# sourceMappingURL=connect_to_server.js.map

package/dist/operations/connect_to_server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect_to_server.js","sourceRoot":"","sources":["../../operations/connect_to_server.ts"],"names":[],"mappings":"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"}

package/dist/operations/data_types.d.ts

@@ -0,0 +1,6 @@
+type TypeConverter = (value: any) => any;
+/**
+ * This object contains the data types of PostgreSQL and their corresponding JavaScript data type converters.
+ */
+export declare const sqlTypes: Record<string, TypeConverter>;
+export {};

package/dist/operations/data_types.js

@@ -0,0 +1,120 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sqlTypes = void 0;
+/**
+ * This class is used to create an object of any data type.
+ */
+class Any {
+    constructor(value) {
+        this.value = value;
+    }
+}
+/**
+ * This function is used to check if the value is null.
+ *
+ * @param value - The data to be checked
+ * @returns boolean - Returns true if the value is null, false otherwise
+ */
+const isNull = (value) => value === null;
+/**
+ * This object contains functions to convert values to specific data types.
+ */
+const types = {
+    /**
+     * Converts a value to a string.
+     * @param value - The value to be converted
+     * @returns string | null - The converted string value or null
+     */
+    string: (value) => {
+        return isNull(value) ? null : String(value);
+    },
+    /**
+     * Converts a value to a number.
+     * @param value - The value to be converted
+     * @returns number | null - The converted number value or null
+     */
+    number: (value) => {
+        return isNull(value) ? null : Number(value);
+    },
+    /**
+     * Converts a value to a boolean.
+     * @param value - The value to be converted
+     * @returns boolean | null - The converted boolean value or null
+     */
+    boolean: (value) => {
+        return isNull(value) ? null : Boolean(value);
+    },
+    /**
+     * Converts a value to a Date.
+     * @param value - The value to be converted
+     * @returns Date | null - The converted Date value or null
+     */
+    date: (value) => {
+        return isNull(value) ? null : new Date(value);
+    },
+    /**
+     * Converts a value to a Buffer.
+     * @param value - The value to be converted
+     * @returns Buffer | null - The converted Buffer value or null
+     */
+    buffer: (value) => {
+        return isNull(value) ? null : Buffer.from(String(value));
+    },
+    /**
+     * Converts a value to an Array.
+     * @param value - The value to be converted
+     * @returns any[] | null - The converted Array value or null
+     */
+    array: (value) => {
+        return isNull(value) ? null : Array.isArray(value) ? value : [value];
+    },
+    /**
+     * Wraps a value in an Any object.
+     * @param value - The value to be wrapped
+     * @returns Any | null - The wrapped value or null
+     */
+    any: (value) => {
+        return isNull(value) ? null : new Any(value);
+    }
+};
+/**
+ * This object contains the data types of PostgreSQL and their corresponding JavaScript data type converters.
+ */
+exports.sqlTypes = {
+    "char": types.string,
+    "character": types.string,
+    "varchar": types.string,
+    "character varying": types.string,
+    "text": types.string,
+    "bytea": types.buffer,
+    "bool": types.boolean,
+    "boolean": types.boolean,
+    "int2": types.number,
+    "smallint": types.number,
+    "int4": types.number,
+    "integer": types.number,
+    "int8": types.number,
+    "bigint": types.number,
+    "decimal": types.number,
+    "numeric": types.number,
+    "float4": types.number,
+    "real": types.number,
+    "float8": types.number,
+    "double precision": types.number,
+    "money": types.number,
+    "timestamp": types.date,
+    "timestamptz": types.date,
+    "timestamp without time zone": types.date,
+    "timestamp with time zone": types.date,
+    "date": types.date,
+    "time": types.string,
+    "timetz": types.string,
+    "time without time zone": types.string,
+    "time with time zone": types.string,
+    "uuid": types.string,
+    "xml": types.string,
+    "json": types.any,
+    "jsonb": types.any,
+    "ARRAY": types.array,
+};
+//# sourceMappingURL=data_types.js.map

package/dist/operations/data_types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data_types.js","sourceRoot":"","sources":["../../operations/data_types.ts"],"names":[],"mappings":"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"}

package/dist/operations/get_pieces.d.ts

@@ -0,0 +1,29 @@
+export interface ParameterizedPieces {
+    condition: string;
+    inputs: any[];
+}
+export interface InsertPieces {
+    columns: string;
+    values: string;
+    inputs: any[];
+}
+/**
+ * Converts an object into a parameterized WHERE/SET condition string.
+ * Generates $1, $2... positional placeholders to prevent SQL injection.
+ *
+ * @param data - The key/value pairs to parameterize
+ * @param startIndex - Starting positional index for parameters (default: 0, meaning first param is $1)
+ * @returns Parameterized condition and ordered input values array
+ */
+export declare const getConditionPieces: (data?: Record<string, any>, startIndex?: number) => ParameterizedPieces;
+/**
+ * Converts an object into a parameterized INSERT fragment.
+ *
+ * @param data - The key/value pairs to insert
+ * @returns Column names, positional placeholders ($1, $2...), and ordered input values
+ */
+export declare const getInsertPieces: (data?: Record<string, any>) => InsertPieces;
+/**
+ * Validates that a SQL identifier (table/column name) contains only safe characters.
+ */
+export declare const isValidIdentifier: (name: string) => boolean;

package/dist/operations/get_pieces.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isValidIdentifier = exports.getInsertPieces = exports.getConditionPieces = void 0;
+/**
+ * Converts an object into a parameterized WHERE/SET condition string.
+ * Generates $1, $2... positional placeholders to prevent SQL injection.
+ *
+ * @param data - The key/value pairs to parameterize
+ * @param startIndex - Starting positional index for parameters (default: 0, meaning first param is $1)
+ * @returns Parameterized condition and ordered input values array
+ */
+const getConditionPieces = (data = {}, startIndex = 0) => {
+    const keys = Object.keys(data).filter(key => (0, exports.isValidIdentifier)(key));
+    const condition = keys.map((key, i) => `${key} = $${startIndex + i + 1}`).join(' AND ');
+    const inputs = keys.map(key => sanitizeValue(data[key]));
+    return { condition, inputs };
+};
+exports.getConditionPieces = getConditionPieces;
+/**
+ * Converts an object into a parameterized INSERT fragment.
+ *
+ * @param data - The key/value pairs to insert
+ * @returns Column names, positional placeholders ($1, $2...), and ordered input values
+ */
+const getInsertPieces = (data = {}) => {
+    const keys = Object.keys(data).filter(key => (0, exports.isValidIdentifier)(key));
+    const columns = keys.join(', ');
+    const values = keys.map((_, i) => `$${i + 1}`).join(', ');
+    const inputs = keys.map(key => sanitizeValue(data[key]));
+    return { columns, values, inputs };
+};
+exports.getInsertPieces = getInsertPieces;
+/**
+ * Validates that a SQL identifier (table/column name) contains only safe characters.
+ */
+const isValidIdentifier = (name) => {
+    return /^[a-zA-Z_][a-zA-Z0-9_]*$/.test(name);
+};
+exports.isValidIdentifier = isValidIdentifier;
+/**
+ * Sanitizes a value for use as a SQL parameter.
+ * Converts undefined/NaN to null, booleans to true/false, bigint to string.
+ */
+function sanitizeValue(value) {
+    if (value === undefined || value === null || (typeof value === 'number' && isNaN(value))) {
+        return null;
+    }
+    if (typeof value === 'boolean') {
+        return value;
+    }
+    if (typeof value === 'bigint') {
+        return value.toString();
+    }
+    return value;
+}
+//# sourceMappingURL=get_pieces.js.map

package/dist/operations/get_pieces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_pieces.js","sourceRoot":"","sources":["../../operations/get_pieces.ts"],"names":[],"mappings":";;;AAWA;;;;;;;GAOG;AACI,MAAM,kBAAkB,GAAG,CAAC,IAAI,GAAwB,EAAE,EAAE,UAAU,GAAW,CAAC,EAAuB,EAAE;IAC9G,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,IAAA,QAAA,iBAAiB,EAAC,GAAG,CAAC,CAAC,CAAC;IACrE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,OAAO,UAAU,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACxF,MAAM,MAAM,GAAU,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAChE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;AACjC,CAAC,CAAC;AALW,QAAA,kBAAkB,GAAlB,kBAAkB,CAK7B;AAEF;;;;;GAKG;AACI,MAAM,eAAe,GAAG,CAAC,IAAI,GAAwB,EAAE,EAAgB,EAAE;IAC5E,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,IAAA,QAAA,iBAAiB,EAAC,GAAG,CAAC,CAAC,CAAC;IACrE,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1D,MAAM,MAAM,GAAU,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAChE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AACvC,CAAC,CAAC;AANW,QAAA,eAAe,GAAf,eAAe,CAM1B;AAEF;;GAEG;AACI,MAAM,iBAAiB,GAAG,CAAC,IAAY,EAAW,EAAE;IACvD,OAAO,0BAA0B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjD,CAAC,CAAC;AAFW,QAAA,iBAAiB,GAAjB,iBAAiB,CAE5B;AAEF;;;GAGG;AACH,SAAS,aAAa,CAAC,KAAU;IAC7B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;QACvF,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO,KAAK,CAAC;IACjB,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC5B,CAAC;IACD,OAAO,KAAK,CAAC;AACjB,CAAC"}

package/dist/operations/log.d.ts

@@ -0,0 +1,12 @@
+import 'colors';
+/**
+ * This function is used to display logs in the console.
+ *
+ * @param title - The title of the log.
+ * @param alt - The alternative title of the log.
+ * @param description - The description of the log.
+ * @param file - The file of the log.
+     */
+declare function Log(title: string | null, alt: string | null, description: string | null, file?: string | null): void;
+export declare const log: typeof Log;
+export {};

package/dist/operations/log.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.log = void 0;
+require("colors");
+/**
+ * This function is used to display logs in the console.
+ *
+ * @param title - The title of the log.
+ * @param alt - The alternative title of the log.
+ * @param description - The description of the log.
+ * @param file - The file of the log.
+     */
+function Log(title, alt, description, file = null) {
+    title = title ? (title.length > 20 ? title.substring(0, 20) + '...' : title) : null;
+    alt = alt ? (alt.length > 20 ? alt.substring(0, 20) + '...' : alt) : null;
+    description = description ? (description.length > 50 ? description.substring(0, 50) + '...' : description) : null;
+    file = file ? (file.length > 20 ? file.substring(0, 20) + '...' : file) : null;
+    let time = (new Date().toLocaleTimeString()).gray;
+    title = title ? ('[' + title.trim() + ']').cyan.bold : null;
+    alt = alt ? ('(' + alt.trim() + ')').magenta : null;
+    description = description ? description.trim().green : null;
+    file = file ? ('[' + file.trim() + ']').gray : 'easy-postgresql'.gray;
+    const data = [time, title, alt, description, file].filter(f => f !== null && f !== undefined);
+    console.log(data.join(' '));
+}
+exports.log = Log;
+//# sourceMappingURL=log.js.map

package/dist/operations/log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.js","sourceRoot":"","sources":["../../operations/log.ts"],"names":[],"mappings":";;;AAAA,kBAAgB;AAEhB;;;;;;;OAOO;AACP,SAAS,GAAG,CAAC,KAAoB,EAAE,GAAkB,EAAE,WAA0B,EAAE,IAAI,GAAkB,IAAI;IACzG,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACpF,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1E,WAAW,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAClH,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAE/E,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,kBAAkB,EAAE,CAAC,CAAC,IAAI,CAAC;IAClD,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC,IAAI,EAAE,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,IAAqB,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7E,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,IAAI,EAAE,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IACpD,WAAW,GAAG,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IAC5D,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,iBAAiB,CAAC,IAAI,CAAC;IAEtE,MAAM,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,SAAS,CAAC,CAAC;IAC9F,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAChC,CAAC;AAEY,QAAA,GAAG,GAAG,GAAG,CAAC"}

package/dist/operations/procedure_execute.d.ts

@@ -0,0 +1,18 @@
+interface ProcedureResult {
+    status: number;
+    message: string;
+    data: any[] | any | null;
+}
+interface ProcedureReference {
+    [key: string]: any;
+}
+/**
+ * Executes a stored procedure/function in the database.
+ *
+ * @param procedureName - The name of the stored procedure/function
+ * @param reference - The input parameters for the procedure
+ * @param useRecordsets - If true, wraps rows in array; otherwise returns rows directly
+ * @returns Promise<ProcedureResult>
+ */
+export declare const executeProcedure: (procedureName: string, reference?: ProcedureReference, useRecordsets?: boolean) => Promise<ProcedureResult>;
+export {};

package/dist/operations/procedure_execute.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeProcedure = void 0;
+const connect_to_server_1 = require("./connect_to_server");
+const config_1 = require("./config");
+const log_1 = require("./log");
+function pgTypeOf(value) {
+    if (value === null || value === undefined)
+        return 'text';
+    if (typeof value === 'number')
+        return Number.isInteger(value) ? 'integer' : 'float8';
+    if (typeof value === 'boolean')
+        return 'boolean';
+    if (value instanceof Date)
+        return 'timestamp';
+    if (Buffer.isBuffer(value))
+        return 'bytea';
+    return 'text';
+}
+/**
+ * Executes a stored procedure/function in the database.
+ *
+ * @param procedureName - The name of the stored procedure/function
+ * @param reference - The input parameters for the procedure
+ * @param useRecordsets - If true, wraps rows in array; otherwise returns rows directly
+ * @returns Promise<ProcedureResult>
+ */
+const executeProcedure = async (procedureName, reference = {}, useRecordsets = false) => {
+    try {
+        const keys = Object.keys(reference);
+        const values = keys.map(k => reference[k]);
+        const params = keys.map((_, i) => `$${i + 1}::${pgTypeOf(values[i])}`).join(', ');
+        const queryText = `SELECT * FROM ${procedureName}(${params})`;
+        const pool = (0, connect_to_server_1.getPool)();
+        const client = await pool.connect();
+        try {
+            const result = await client.query(queryText, values);
+            const data = useRecordsets ? [result.rows] : result.rows;
+            return { status: 200, message: 'Success', data };
+        }
+        finally {
+            client.release();
+        }
+    }
+    catch (err) {
+        if (config_1.config.get.logingMode()) {
+            (0, log_1.log)('Procedure', procedureName, err instanceof Error ? err.message : String(err));
+        }
+        return { status: 500, message: 'Error', data: null };
+    }
+};
+exports.executeProcedure = executeProcedure;
+//# sourceMappingURL=procedure_execute.js.map

package/dist/operations/procedure_execute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"procedure_execute.js","sourceRoot":"","sources":["../../operations/procedure_execute.ts"],"names":[],"mappings":";;;AAAA,2DAA8C;AAC9C,qCAAkC;AAClC,+BAA4B;AAY5B,SAAS,QAAQ,CAAC,KAAU;IACxB,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IACzD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC;IACrF,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACjD,IAAI,KAAK,YAAY,IAAI;QAAE,OAAO,WAAW,CAAC;IAC9C,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC;IAC3C,OAAO,MAAM,CAAC;AAClB,CAAC;AAED;;;;;;;GAOG;AACI,MAAM,gBAAgB,GAAG,KAAK,EACjC,aAAqB,EACrB,SAAS,GAAuB,EAAE,EAClC,aAAa,GAAY,KAAK,EACN,EAAE;IAC1B,IAAI,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACpC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClF,MAAM,SAAS,GAAG,iBAAiB,aAAa,IAAI,MAAM,GAAG,CAAC;QAE9D,MAAM,IAAI,GAAG,IAAA,2BAAO,GAAE,CAAC;QACvB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACpC,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YACrD,MAAM,IAAI,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC;YACzD,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;QACrD,CAAC;gBAAS,CAAC;YACP,MAAM,CAAC,OAAO,EAAE,CAAC;QACrB,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,IAAI,eAAM,CAAC,GAAG,CAAC,UAAU,EAAE,EAAE,CAAC;YAC1B,IAAA,SAAG,EAAC,WAAW,EAAE,aAAa,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACtF,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACzD,CAAC;AACL,CAAC,CAAC;AA1BW,QAAA,gBAAgB,GAAhB,gBAAgB,CA0B3B"}

package/operations/config.ts

@@ -0,0 +1,28 @@
+import 'colors';
+
+let logingMode = false;
+
+/**
+ * This function is used to set the output format of the query result.
+ * 
+ * @param mode - This parameter is used to set the output format of the query result.
+ */
+function setLogingMode(mode = false): void {
+    if (typeof mode !== 'boolean') throw new Error('Invalid parameter type. Expected boolean.');
+    logingMode = mode;
+}
+
+/**
+ * This function is used to get the current output format of the query result.
+ * @file config.ts
+ * @description This file contains the configuration operations.
+ * @module
+ */
+export const config = {
+    get: {
+        logingMode: (): boolean => logingMode,
+    },
+    set: {
+        logingMode: setLogingMode
+    }
+}; 

package/operations/connect_to_server.ts

@@ -0,0 +1,111 @@
+import { Pool, PoolConfig } from 'pg';
+import { config } from './config';
+import { log } from './log';
+
+export interface SqlConfig {
+    user?: string;
+    password?: string;
+    host?: string;
+    port?: number;
+    database?: string;
+    [key: string]: any;
+}
+
+export type RunCallback = (sqlConfig: SqlConfig, err?: Error) => void;
+
+let pool: Pool | null = null;
+
+export function getPool(): Pool {
+    if (!pool) throw new Error('Database not connected. Call Connect() first.');
+    return pool;
+}
+
+/**
+ * This function checks if the database connection is active
+ * 
+ * @returns Promise<boolean> - Returns true if connection is active, false otherwise
+ */
+export const isConnected = async (): Promise<{ status: number, message: string }> => {
+    try {
+        const p = getPool();
+        const client = await p.connect();
+        try {
+            await client.query('SELECT 1');
+        } finally {
+            client.release();
+        }
+        return { status: 200, message: 'OK' }
+    } catch (err) {
+        return { status: 500, message: 'Error: ' + String(err) }
+    }
+};
+
+/**
+ * This function is used to connect to the database.
+ * 
+ * @param sqlConfig - The PostgreSQL configuration to connect to the database
+ * @param run - Optional callback function to be executed after the connection is established
+ * @returns Promise<boolean> - Returns true if connection is successful, false otherwise
+ */
+export const connectToServer = async (sqlConfig: SqlConfig, run?: RunCallback): Promise<boolean> => {
+    if (!sqlConfig || typeof sqlConfig !== 'object') {
+        if (config.get.logingMode()) log('Connection', null, 'The sqlConfig parameter is not an object.');
+        return false;
+    }
+
+    const required: Record<string, string> = { user: "string", password: "string", host: "string", database: "string" };
+    for (const key in required) {
+        if (!sqlConfig[key as keyof SqlConfig] || typeof sqlConfig[key as keyof SqlConfig] !== required[key]) {
+            if (config.get.logingMode()) log('Connection', null, `The ${key} parameter is not a ${required[key]}.`);
+            return false;
+        }
+    }
+
+    pool = new Pool({
+        user: sqlConfig.user,
+        password: sqlConfig.password,
+        host: sqlConfig.host,
+        port: sqlConfig.port || 5432,
+        database: sqlConfig.database,
+    });
+
+    const maxRetries = 3;
+    const retryInterval = 2500;
+    let retryCount = 0;
+
+    const tryConnect = async (): Promise<boolean> => {
+        try {
+            const client = await pool!.connect();
+            try {
+                await client.query('SELECT 1');
+            } finally {
+                client.release();
+            }
+            if (run && typeof run === 'function') {
+                run(sqlConfig);
+            }
+            if (config.get.logingMode()) log('Connection', null, 'Success');
+            return true;
+        } catch (err) {
+            if (config.get.logingMode()) log('Connection', 'Attempt', `${retryCount + 1}: ${err instanceof Error ? err.message : String(err)}`);
+            if (run && typeof run === 'function') {
+                run(sqlConfig, err instanceof Error ? err : new Error(String(err)));
+            }
+            return false;
+        }
+    };
+
+    while (retryCount < maxRetries) {
+        const result = await tryConnect();
+        if (result) return true;
+
+        retryCount++;
+        if (retryCount < maxRetries) {
+            if (config.get.logingMode()) log('Connection', 'Retry', `Retrying in 2.5s... (Attempt ${retryCount + 1}/${maxRetries})`);
+            await new Promise(resolve => setTimeout(resolve, retryInterval));
+        }
+    }
+
+    if (config.get.logingMode()) log('Connection', null, `Failed after ${maxRetries} attempts`);
+    return false;
+};