@starbemtech/star-db-query-builder 1.0.0

package/.eslintignore

@@ -0,0 +1,4 @@
+# common
+dist/ 
+build/ 
+pnpm-lock.yaml

package/.eslintrc.json

@@ -0,0 +1,32 @@
+{
+    "env": {
+        "es2021": true,
+        "node": true
+    },
+    "extends": [
+        "eslint:recommended",
+        "prettier",
+        "plugin:@typescript-eslint/recommended"
+    ],
+    "parser": "@typescript-eslint/parser",
+    "parserOptions": {
+        "ecmaVersion": "latest",
+        "sourceType": "module"
+    },
+    "plugins": [
+        "@typescript-eslint",
+        "prettier"
+    ],
+    "rules": {
+        "prettier/prettier": "error",
+        "@typescript-eslint/explicit-function-return-type": "off",
+        "@typescript-eslint/no-explicit-any": "off",
+        "@typescript-eslint/explicit-module-boundary-types": "off",
+        "@typescript-eslint/no-require-imports": "off",
+        "import/prefer-default-export": "off",
+        "no-param-reassign": "off",
+        "no-console": "off",
+        "no-return-assign": "off",
+        "array-callback-return": "off"
+    }
+}

package/.husky/pre-commit

@@ -0,0 +1 @@
+npm test

package/.prettierignore

@@ -0,0 +1,3 @@
+# Ignore artifacts:
+build
+coverage

package/.prettierrc

@@ -0,0 +1,5 @@
+{
+  "semi": false,
+  "singleQuote": true,
+  "trailingComma": "es5"
+}

package/dist/.eslintrc.json

@@ -0,0 +1,32 @@
+{
+    "env": {
+        "es2021": true,
+        "node": true
+    },
+    "extends": [
+        "eslint:recommended",
+        "prettier",
+        "plugin:@typescript-eslint/recommended"
+    ],
+    "parser": "@typescript-eslint/parser",
+    "parserOptions": {
+        "ecmaVersion": "latest",
+        "sourceType": "module"
+    },
+    "plugins": [
+        "@typescript-eslint",
+        "prettier"
+    ],
+    "rules": {
+        "prettier/prettier": "error",
+        "@typescript-eslint/explicit-function-return-type": "off",
+        "@typescript-eslint/no-explicit-any": "off",
+        "@typescript-eslint/explicit-module-boundary-types": "off",
+        "@typescript-eslint/no-require-imports": "off",
+        "import/prefer-default-export": "off",
+        "no-param-reassign": "off",
+        "no-console": "off",
+        "no-return-assign": "off",
+        "array-callback-return": "off"
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './src/db/initDb';
+export * from './src/default/genericRepository';

package/dist/index.js

@@ -0,0 +1,21 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Configs
+__exportStar(require("./src/db/initDb"), exports);
+// Generic Repository
+__exportStar(require("./src/default/genericRepository"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,UAAU;AACV,kDAA+B;AAE/B,qBAAqB;AACrB,kEAA+C"}

package/dist/src/db/IDatabaseClient.d.ts

@@ -0,0 +1,5 @@
+import { DBClients } from '../default/types';
+export type IDatabaseClient = {
+    clientType: DBClients;
+    query: <T>(sql: string, params?: any[]) => Promise<T>;
+};

package/dist/src/db/IDatabaseClient.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IDatabaseClient.js.map

package/dist/src/db/IDatabaseClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IDatabaseClient.js","sourceRoot":"","sources":["../../../src/db/IDatabaseClient.ts"],"names":[],"mappings":""}

package/dist/src/db/initDb.d.ts

@@ -0,0 +1,6 @@
+import { IDatabaseClient } from './IDatabaseClient';
+export declare const initDb: (config: {
+    type: 'pg' | 'mysql';
+    options: any;
+}) => void;
+export declare const getDbClient: () => IDatabaseClient;

package/dist/src/db/initDb.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDbClient = exports.initDb = void 0;
+const pg_1 = require("pg");
+const promise_1 = require("mysql2/promise");
+const pgClient_1 = require("./pgClient");
+const mysqlClient_1 = require("./mysqlClient");
+let dbClient = null;
+const initDb = (config) => {
+    if (config.type === 'pg') {
+        const pool = new pg_1.Pool(config.options);
+        dbClient = (0, pgClient_1.createPgClient)(pool);
+    }
+    else if (config.type === 'mysql') {
+        const pool = (0, promise_1.createPool)(config.options);
+        dbClient = (0, mysqlClient_1.createMysqlClient)(pool);
+    }
+    else {
+        throw new Error('Unsupported database type');
+    }
+};
+exports.initDb = initDb;
+const getDbClient = () => {
+    if (!dbClient) {
+        throw new Error('Database client is not initialized');
+    }
+    return dbClient;
+};
+exports.getDbClient = getDbClient;
+//# sourceMappingURL=initDb.js.map

package/dist/src/db/initDb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"initDb.js","sourceRoot":"","sources":["../../../src/db/initDb.ts"],"names":[],"mappings":";;;AAAA,2BAAmC;AACnC,4CAA8D;AAC9D,yCAA2C;AAC3C,+CAAiD;AAGjD,IAAI,QAAQ,GAA2B,IAAI,CAAA;AAEpC,MAAM,MAAM,GAAG,CAAC,MAA8C,EAAE,EAAE;IACvE,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,IAAI,SAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;QACvC,QAAQ,GAAG,IAAA,yBAAc,EAAC,IAAI,CAAC,CAAA;IACjC,CAAC;SAAM,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,IAAA,oBAAe,EAAC,MAAM,CAAC,OAAO,CAAC,CAAA;QAC5C,QAAQ,GAAG,IAAA,+BAAiB,EAAC,IAAI,CAAC,CAAA;IACpC,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAA;IAC9C,CAAC;AACH,CAAC,CAAA;AAVY,QAAA,MAAM,UAUlB;AAEM,MAAM,WAAW,GAAG,GAAoB,EAAE;IAC/C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAA;IACvD,CAAC;IAED,OAAO,QAAQ,CAAA;AACjB,CAAC,CAAA;AANY,QAAA,WAAW,eAMvB"}

package/dist/src/db/mysqlClient.d.ts

@@ -0,0 +1,3 @@
+import { Pool } from 'mysql2/promise';
+import { IDatabaseClient } from './IDatabaseClient';
+export declare const createMysqlClient: (pool: Pool) => IDatabaseClient;

package/dist/src/db/mysqlClient.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createMysqlClient = void 0;
+const createMysqlClient = (pool) => ({
+    clientType: 'mysql',
+    query: async (sql, params) => {
+        const [rows] = await pool.execute(sql, params);
+        return rows;
+    },
+});
+exports.createMysqlClient = createMysqlClient;
+//# sourceMappingURL=mysqlClient.js.map

package/dist/src/db/mysqlClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mysqlClient.js","sourceRoot":"","sources":["../../../src/db/mysqlClient.ts"],"names":[],"mappings":";;;AAGO,MAAM,iBAAiB,GAAG,CAAC,IAAU,EAAmB,EAAE,CAAC,CAAC;IACjE,UAAU,EAAE,OAAO;IACnB,KAAK,EAAE,KAAK,EAAK,GAAW,EAAE,MAAc,EAAc,EAAE;QAC1D,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;QAC9C,OAAO,IAAoB,CAAA;IAC7B,CAAC;CACF,CAAC,CAAA;AANW,QAAA,iBAAiB,qBAM5B"}

package/dist/src/db/pgClient.d.ts

@@ -0,0 +1,3 @@
+import { Pool } from 'pg';
+import { IDatabaseClient } from './IDatabaseClient';
+export declare const createPgClient: (pool: Pool) => IDatabaseClient;

package/dist/src/db/pgClient.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPgClient = void 0;
+const createPgClient = (pool) => ({
+    clientType: 'pg',
+    query: async (sql, params) => {
+        const { rows } = await pool.query(sql, params);
+        return rows;
+    },
+});
+exports.createPgClient = createPgClient;
+//# sourceMappingURL=pgClient.js.map

package/dist/src/db/pgClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pgClient.js","sourceRoot":"","sources":["../../../src/db/pgClient.ts"],"names":[],"mappings":";;;AAGO,MAAM,cAAc,GAAG,CAAC,IAAU,EAAmB,EAAE,CAAC,CAAC;IAC9D,UAAU,EAAE,IAAI;IAChB,KAAK,EAAE,KAAK,EAAK,GAAW,EAAE,MAAc,EAAc,EAAE;QAC1D,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;QAC9C,OAAO,IAAoB,CAAA;IAC7B,CAAC;CACF,CAAC,CAAA;AANW,QAAA,cAAc,kBAMzB"}

package/dist/src/default/genericRepository.d.ts

@@ -0,0 +1,14 @@
+import { QueryParams } from './types';
+export declare const findFirst: <T>({ tableName, dbClient, select, where, groupBy, orderBy, }: QueryParams) => Promise<T>;
+export declare const findMany: <T>({ tableName, dbClient, select, where, groupBy, orderBy, limit, }: QueryParams) => Promise<T[]>;
+export declare const insert: <T>({ tableName, dbClient, data, returning, }: QueryParams & {
+    data: T;
+    returning?: string[] | undefined;
+}) => Promise<T | void>;
+export declare const update: <T>({ tableName, dbClient, id, data, returning, }: QueryParams & {
+    data: T;
+    returning?: string[] | undefined;
+}) => Promise<T | void>;
+export declare const deleteOne: ({ tableName, dbClient, id, permanently, }: QueryParams & {
+    permanently?: boolean | undefined;
+}) => Promise<void>;

package/dist/src/default/genericRepository.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deleteOne = exports.update = exports.insert = exports.findMany = exports.findFirst = void 0;
+const utils_1 = require("./utils");
+const findFirst = async ({ tableName, dbClient, select, where, groupBy, orderBy, }) => {
+    if (!tableName)
+        throw new Error('Table name is required');
+    if (!dbClient)
+        throw new Error('DB client is required');
+    const fields = (0, utils_1.createSelectFields)(select);
+    const [whereClause, params] = (0, utils_1.createWhereClause)(where);
+    const orderByClause = (0, utils_1.createOrderByClause)(orderBy);
+    const groupByClause = (0, utils_1.createGroupByClause)(groupBy);
+    const rows = await dbClient.query(`SELECT ${fields} FROM ${tableName}
+      ${whereClause.length > 7 ? whereClause : ''}
+      ${groupByClause}
+      ${orderByClause}
+    `, [params]);
+    return rows[0] || null;
+};
+exports.findFirst = findFirst;
+const findMany = async ({ tableName, dbClient, select, where, groupBy, orderBy, limit, }) => {
+    if (!tableName)
+        throw new Error('Table name is required');
+    if (!dbClient)
+        throw new Error('DB client is required');
+    const fields = (0, utils_1.createSelectFields)(select);
+    const [whereClause, params] = (0, utils_1.createWhereClause)(where);
+    const orderByClause = (0, utils_1.createOrderByClause)(orderBy);
+    const groupByClause = (0, utils_1.createGroupByClause)(groupBy);
+    const limitClause = (0, utils_1.createLimitClause)(limit);
+    const rows = await dbClient.query(`SELECT ${fields} FROM ${tableName}
+      ${whereClause.length > 7 ? whereClause : ''}
+      ${groupByClause}
+      ${orderByClause}
+      ${limitClause}
+    `, [params]);
+    return rows || [];
+};
+exports.findMany = findMany;
+const insert = async ({ tableName, dbClient, data, returning, }) => {
+    if (!tableName)
+        throw new Error('Table name is required');
+    if (!dbClient)
+        throw new Error('DB client is required');
+    if (!data)
+        throw new Error('Data object is required');
+    const keys = Object.keys(data);
+    const values = Object.values(data);
+    const placeholders = (0, utils_1.generatePlaceholders)(keys, dbClient.clientType);
+    let query = `INSERT INTO ${tableName} (${keys.join(', ')}) VALUES (${placeholders})`;
+    if (dbClient.clientType === 'pg') {
+        if (returning && returning.length > 0) {
+            query += ` RETURNING ${(0, utils_1.createSelectFields)(returning)}`;
+        }
+    }
+    const inserted = await dbClient.query(query, values);
+    if (dbClient.clientType === 'pg')
+        return inserted[0];
+};
+exports.insert = insert;
+const update = async ({ tableName, dbClient, id, data, returning, }) => {
+    if (!tableName)
+        throw new Error('Table name is required');
+    if (!dbClient)
+        throw new Error('DB client is required');
+    if (!id)
+        throw new Error('ID is required');
+    if (!data)
+        throw new Error('Data object is required');
+    const keys = Object.keys(data);
+    const values = Object.values(data);
+    const setClause = (0, utils_1.generateSetClause)(keys, dbClient.clientType);
+    let query = `UPDATE ${tableName} SET ${setClause} WHERE ${id}`;
+    if (dbClient.clientType === 'pg') {
+        if (returning && returning.length > 0) {
+            query += ` RETURNIN ${(0, utils_1.createSelectFields)(returning)}`;
+        }
+    }
+    const updated = await dbClient.query(query, values);
+    if (dbClient.clientType === 'pg')
+        return updated[0];
+};
+exports.update = update;
+const deleteOne = async ({ tableName, dbClient, id, permanently = false, }) => {
+    if (!tableName)
+        throw new Error('Table name is required');
+    if (!dbClient)
+        throw new Error('DB client is required');
+    if (!id)
+        throw new Error('ID is required');
+    await dbClient.query(permanently
+        ? `DELETE FROM ${tableName} WHERE id = ${dbClient.clientType === 'pg' ? '$1' : '?'}`
+        : `UPDATE ${tableName} SET status = 'deleted' WHERE id = ${dbClient.clientType === 'pg' ? '$1' : '?'}`, [id]);
+};
+exports.deleteOne = deleteOne;
+//# sourceMappingURL=genericRepository.js.map

package/dist/src/default/genericRepository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"genericRepository.js","sourceRoot":"","sources":["../../../src/default/genericRepository.ts"],"names":[],"mappings":";;;AACA,mCAQgB;AAET,MAAM,SAAS,GAAG,KAAK,EAAK,EACjC,SAAS,EACT,QAAQ,EACR,MAAM,EACN,KAAK,EACL,OAAO,EACP,OAAO,GACK,EAAc,EAAE;IAC5B,IAAI,CAAC,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAA;IACzD,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAA;IAEvD,MAAM,MAAM,GAAG,IAAA,0BAAkB,EAAC,MAAM,CAAC,CAAA;IACzC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,GAAG,IAAA,yBAAiB,EAAC,KAAK,CAAC,CAAA;IACtD,MAAM,aAAa,GAAG,IAAA,2BAAmB,EAAC,OAAO,CAAC,CAAA;IAClD,MAAM,aAAa,GAAG,IAAA,2BAAmB,EAAC,OAAO,CAAC,CAAA;IAElD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,KAAK,CAC/B,UAAU,MAAM,SAAS,SAAS;QAC9B,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE;QACzC,aAAa;QACb,aAAa;KAChB,EACD,CAAC,MAAM,CAAC,CACT,CAAA;IAED,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAA;AACxB,CAAC,CAAA;AA1BY,QAAA,SAAS,aA0BrB;AAEM,MAAM,QAAQ,GAAG,KAAK,EAAK,EAChC,SAAS,EACT,QAAQ,EACR,MAAM,EACN,KAAK,EACL,OAAO,EACP,OAAO,EACP,KAAK,GACO,EAAgB,EAAE;IAC9B,IAAI,CAAC,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAA;IACzD,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAA;IAEvD,MAAM,MAAM,GAAG,IAAA,0BAAkB,EAAC,MAAM,CAAC,CAAA;IACzC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,GAAG,IAAA,yBAAiB,EAAC,KAAK,CAAC,CAAA;IACtD,MAAM,aAAa,GAAG,IAAA,2BAAmB,EAAC,OAAO,CAAC,CAAA;IAClD,MAAM,aAAa,GAAG,IAAA,2BAAmB,EAAC,OAAO,CAAC,CAAA;IAClD,MAAM,WAAW,GAAG,IAAA,yBAAiB,EAAC,KAAK,CAAC,CAAA;IAE5C,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,KAAK,CAC/B,UAAU,MAAM,SAAS,SAAS;QAC9B,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE;QACzC,aAAa;QACb,aAAa;QACb,WAAW;KACd,EACD,CAAC,MAAM,CAAC,CACT,CAAA;IAED,OAAO,IAAI,IAAI,EAAE,CAAA;AACnB,CAAC,CAAA;AA7BY,QAAA,QAAQ,YA6BpB;AAEM,MAAM,MAAM,GAAG,KAAK,EAAK,EAC9B,SAAS,EACT,QAAQ,EACR,IAAI,EACJ,SAAS,GACuC,EAAqB,EAAE;IACvE,IAAI,CAAC,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAA;IACzD,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAA;IACvD,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAA;IAErD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC9B,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IAElC,MAAM,YAAY,GAAG,IAAA,4BAAoB,EAAC,IAAI,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAA;IACpE,IAAI,KAAK,GAAG,eAAe,SAAS,KAAK,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,YAAY,GAAG,CAAA;IAEpF,IAAI,QAAQ,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;QACjC,IAAI,SAAS,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtC,KAAK,IAAI,cAAc,IAAA,0BAAkB,EAAC,SAAS,CAAC,EAAE,CAAA;QACxD,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAM,KAAK,EAAE,MAAM,CAAC,CAAA;IAEzD,IAAI,QAAQ,CAAC,UAAU,KAAK,IAAI;QAAE,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAA;AACtD,CAAC,CAAA;AAzBY,QAAA,MAAM,UAyBlB;AAEM,MAAM,MAAM,GAAG,KAAK,EAAK,EAC9B,SAAS,EACT,QAAQ,EACR,EAAE,EACF,IAAI,EACJ,SAAS,GACuC,EAAqB,EAAE;IACvE,IAAI,CAAC,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAA;IACzD,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAA;IACvD,IAAI,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAA;IAC1C,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAA;IAErD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC9B,MAAM,MAAM,GAAU,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IAEzC,MAAM,SAAS,GAAG,IAAA,yBAAiB,EAAC,IAAI,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAA;IAC9D,IAAI,KAAK,GAAG,UAAU,SAAS,QAAQ,SAAS,UAAU,EAAE,EAAE,CAAA;IAE9D,IAAI,QAAQ,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;QACjC,IAAI,SAAS,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtC,KAAK,IAAI,aAAa,IAAA,0BAAkB,EAAC,SAAS,CAAC,EAAE,CAAA;QACvD,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAM,KAAK,EAAE,MAAM,CAAC,CAAA;IAExD,IAAI,QAAQ,CAAC,UAAU,KAAK,IAAI;QAAE,OAAO,OAAO,CAAC,CAAC,CAAC,CAAA;AACrD,CAAC,CAAA;AA3BY,QAAA,MAAM,UA2BlB;AAEM,MAAM,SAAS,GAAG,KAAK,EAAE,EAC9B,SAAS,EACT,QAAQ,EACR,EAAE,EACF,WAAW,GAAG,KAAK,GACqB,EAAiB,EAAE;IAC3D,IAAI,CAAC,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAA;IACzD,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAA;IACvD,IAAI,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAA;IAE1C,MAAM,QAAQ,CAAC,KAAK,CAClB,WAAW;QACT,CAAC,CAAC,eAAe,SAAS,eAAe,QAAQ,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE;QACpF,CAAC,CAAC,UAAU,SAAS,sCAAsC,QAAQ,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,EACxG,CAAC,EAAE,CAAC,CACL,CAAA;AACH,CAAC,CAAA;AAhBY,QAAA,SAAS,aAgBrB"}

package/dist/src/default/types.d.ts

@@ -0,0 +1,35 @@
+import { IDatabaseClient } from '../db/IDatabaseClient';
+export interface QueryExec {
+    text: string;
+    values?: any[];
+}
+type SimpleValue = string | number | boolean | Date;
+type ConditionOperator = 'AND' | 'OR';
+interface OperatorCondition {
+    operator: 'LIKE' | '=' | '>' | '<' | 'IN' | 'BETWEEN' | '!=' | '<=' | '>=' | 'NOT IN' | 'LIKE' | 'NOT LIKE';
+    value: SimpleValue | SimpleValue[];
+}
+export type DBClients = 'pg' | 'mysql';
+export interface CompositeCondition {
+    type: ConditionOperator;
+    conditions: Condition[];
+}
+export type Condition = SimpleValue | OperatorCondition | CompositeCondition;
+export interface Conditions {
+    [key: string]: Condition;
+}
+export type OrderBy = {
+    field: string;
+    direction: 'ASC' | 'DESC';
+}[];
+export interface QueryParams {
+    tableName: string;
+    dbClient: IDatabaseClient;
+    id?: string;
+    select?: string[];
+    where?: Conditions;
+    orderBy?: OrderBy;
+    groupBy?: string[];
+    limit?: number;
+}
+export {};

package/dist/src/default/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/src/default/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/default/types.ts"],"names":[],"mappings":""}

package/dist/src/default/utils.d.ts

@@ -0,0 +1,8 @@
+import { Conditions, OrderBy, DBClients } from './types';
+export declare const createSelectFields: (fields?: string[]) => string;
+export declare const generatePlaceholders: (keys: any[], clientType: DBClients) => string;
+export declare const generateSetClause: (keys: any[], clientType: DBClients) => string;
+export declare const createWhereClause: (conditions?: Conditions, startIndex?: number) => [string, any[], number];
+export declare const createOrderByClause: (orderBy?: OrderBy) => string;
+export declare const createGroupByClause: (groupBy?: string[]) => string;
+export declare const createLimitClause: (limit?: number) => string;

package/dist/src/default/utils.js

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createLimitClause = exports.createGroupByClause = exports.createOrderByClause = exports.createWhereClause = exports.generateSetClause = exports.generatePlaceholders = exports.createSelectFields = void 0;
+const arrayToStringWithQuotes = (items) => {
+    const itemsWithQuotes = items.map((item) => `"${item}"`);
+    return itemsWithQuotes.join(', ');
+};
+const createSelectFields = (fields) => {
+    return fields && fields.length > 0 ? arrayToStringWithQuotes(fields) : '*';
+};
+exports.createSelectFields = createSelectFields;
+const generatePlaceholders = (keys, clientType) => {
+    return keys
+        .map((_, index) => (clientType === 'pg' ? `$${index + 1}` : '?'))
+        .join(', ');
+};
+exports.generatePlaceholders = generatePlaceholders;
+const generateSetClause = (keys, clientType) => {
+    return keys
+        .map((key, index) => clientType === 'pg' ? `${key} = $${index + 1}` : `${key} = ?`)
+        .join(', ');
+};
+exports.generateSetClause = generateSetClause;
+const createWhereClause = (conditions = {}, startIndex = 1) => {
+    let index = startIndex;
+    const whereParts = [];
+    const values = [];
+    const processCondition = (key, condition) => {
+        if (typeof condition === 'object' && condition !== null) {
+            if ('operator' in condition && 'value' in condition) {
+                const { operator, value } = condition;
+                if (Array.isArray(value)) {
+                    const placeholders = value.map(() => `$${index++}`).join(', ');
+                    if (operator === 'BETWEEN') {
+                        whereParts.push(`"${key}" ${operator} ${placeholders.replace(', ', ' AND ')}`);
+                    }
+                    else {
+                        whereParts.push(`"${key}" ${operator} (${placeholders})`);
+                    }
+                    values.push(...value);
+                }
+                else {
+                    whereParts.push(`"${key}" ${operator} $${index++}`);
+                    values.push(value);
+                }
+            }
+            else if ('type' in condition && 'conditions' in condition) {
+                const compositeCondition = condition;
+                const subWhereParts = [];
+                compositeCondition.conditions.forEach((subCondition) => {
+                    // Recurso: criar uma chave fictícia, pois as condições compostas não necessitam de chave
+                    index = processCondition('', subCondition);
+                });
+                whereParts.push(`(${subWhereParts.join(` ${compositeCondition.type} `)})`);
+            }
+        }
+        else if (key) {
+            // Condição simples
+            whereParts.push(`"${key}" = $${index}`);
+            values.push(condition);
+            index++;
+        }
+        return index;
+    };
+    Object.entries(conditions).forEach(([key, value]) => {
+        index = processCondition(key, value);
+    });
+    const whereClause = whereParts.length > 0 ? ` WHERE ${whereParts.join(' AND ')}` : '';
+    return [whereClause, values, index];
+};
+exports.createWhereClause = createWhereClause;
+const createOrderByClause = (orderBy) => {
+    if (!orderBy || orderBy.length === 0)
+        return '';
+    const clause = orderBy.map((o) => `${o.field} ${o.direction}`).join(', ');
+    return ` ORDER BY ${clause}`;
+};
+exports.createOrderByClause = createOrderByClause;
+const createGroupByClause = (groupBy) => {
+    if (!groupBy || groupBy.length === 0)
+        return '';
+    return ` GROUP BY ${groupBy.join(', ')}`;
+};
+exports.createGroupByClause = createGroupByClause;
+const createLimitClause = (limit) => {
+    if (!limit)
+        return '';
+    return ` LIMIT ${limit}`;
+};
+exports.createLimitClause = createLimitClause;
+//# sourceMappingURL=utils.js.map

package/dist/src/default/utils.js.map

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

package/index.d.ts

@@ -0,0 +1,42 @@
+import { QueryParams } from './src/default/types'
+
+export declare function findFirst<T>({
+  tableName,
+  dbClient,
+  select,
+  where,
+  groupBy,
+  orderBy,
+}: QueryParams): Promise<T>
+
+export declare function findMany<T>({
+  tableName,
+  dbClient,
+  select,
+  where,
+  groupBy,
+  orderBy,
+  limit,
+}: QueryParams): Promise<T[]>
+
+export declare function insert<T>({
+  tableName,
+  dbClient,
+  data,
+  returning,
+}: QueryParams & { data: T; returning?: string[] }): Promise<T | void>
+
+export declare function update<T>({
+  tableName,
+  dbClient,
+  id,
+  data,
+  returning,
+}: QueryParams & { data: T; returning?: string[] }): Promise<T | void>
+
+export declare function deleteOne({
+  tableName,
+  dbClient,
+  id,
+  permanently,
+}: QueryParams & { permanently?: boolean }): Promise<void>

package/index.ts

@@ -0,0 +1,5 @@
+// Configs
+export * from './src/db/initDb'
+
+// Generic Repository
+export * from './src/default/genericRepository'

package/jest.config.ts

@@ -0,0 +1,199 @@
+/**
+ * For a detailed explanation regarding each configuration property, visit:
+ * https://jestjs.io/docs/configuration
+ */
+
+import type { Config } from 'jest'
+
+const config: Config = {
+  // All imported modules in your tests should be mocked automatically
+  // automock: false,
+
+  // Stop running tests after `n` failures
+  // bail: 0,
+
+  // The directory where Jest should store its cached dependency information
+  // cacheDirectory: "/private/var/folders/_3/bjt7nlhj13qd9dj4fnsdvwmc0000gn/T/jest_dx",
+
+  // Automatically clear mock calls, instances, contexts and results before every test
+  clearMocks: true,
+
+  // Indicates whether the coverage information should be collected while executing the test
+  collectCoverage: true,
+
+  // An array of glob patterns indicating a set of files for which coverage information should be collected
+  // collectCoverageFrom: undefined,
+
+  // The directory where Jest should output its coverage files
+  coverageDirectory: 'coverage',
+
+  // An array of regexp pattern strings used to skip coverage collection
+  // coveragePathIgnorePatterns: [
+  //   "/node_modules/"
+  // ],
+
+  // Indicates which provider should be used to instrument code for coverage
+  coverageProvider: 'v8',
+
+  // A list of reporter names that Jest uses when writing coverage reports
+  // coverageReporters: [
+  //   "json",
+  //   "text",
+  //   "lcov",
+  //   "clover"
+  // ],
+
+  // An object that configures minimum threshold enforcement for coverage results
+  // coverageThreshold: undefined,
+
+  // A path to a custom dependency extractor
+  // dependencyExtractor: undefined,
+
+  // Make calling deprecated APIs throw helpful error messages
+  // errorOnDeprecated: false,
+
+  // The default configuration for fake timers
+  // fakeTimers: {
+  //   "enableGlobally": false
+  // },
+
+  // Force coverage collection from ignored files using an array of glob patterns
+  // forceCoverageMatch: [],
+
+  // A path to a module which exports an async function that is triggered once before all test suites
+  // globalSetup: undefined,
+
+  // A path to a module which exports an async function that is triggered once after all test suites
+  // globalTeardown: undefined,
+
+  // A set of global variables that need to be available in all test environments
+  // globals: {},
+
+  // The maximum amount of workers used to run your tests. Can be specified as % or a number. E.g. maxWorkers: 10% will use 10% of your CPU amount + 1 as the maximum worker number. maxWorkers: 2 will use a maximum of 2 workers.
+  // maxWorkers: "50%",
+
+  // An array of directory names to be searched recursively up from the requiring module's location
+  // moduleDirectories: [
+  //   "node_modules"
+  // ],
+
+  // An array of file extensions your modules use
+  // moduleFileExtensions: [
+  //   "js",
+  //   "mjs",
+  //   "cjs",
+  //   "jsx",
+  //   "ts",
+  //   "tsx",
+  //   "json",
+  //   "node"
+  // ],
+
+  // A map from regular expressions to module names or to arrays of module names that allow to stub out resources with a single module
+  // moduleNameMapper: {},
+
+  // An array of regexp pattern strings, matched against all module paths before considered 'visible' to the module loader
+  // modulePathIgnorePatterns: [],
+
+  // Activates notifications for test results
+  // notify: false,
+
+  // An enum that specifies notification mode. Requires { notify: true }
+  // notifyMode: "failure-change",
+
+  // A preset that is used as a base for Jest's configuration
+  // preset: undefined,
+
+  // Run tests from one or more projects
+  // projects: undefined,
+
+  // Use this configuration option to add custom reporters to Jest
+  // reporters: undefined,
+
+  // Automatically reset mock state before every test
+  // resetMocks: false,
+
+  // Reset the module registry before running each individual test
+  // resetModules: false,
+
+  // A path to a custom resolver
+  // resolver: undefined,
+
+  // Automatically restore mock state and implementation before every test
+  // restoreMocks: false,
+
+  // The root directory that Jest should scan for tests and modules within
+  // rootDir: undefined,
+
+  // A list of paths to directories that Jest should use to search for files in
+  // roots: [
+  //   "<rootDir>"
+  // ],
+
+  // Allows you to use a custom runner instead of Jest's default test runner
+  // runner: "jest-runner",
+
+  // The paths to modules that run some code to configure or set up the testing environment before each test
+  // setupFiles: [],
+
+  // A list of paths to modules that run some code to configure or set up the testing framework before each test
+  // setupFilesAfterEnv: [],
+
+  // The number of seconds after which a test is considered as slow and reported as such in the results.
+  // slowTestThreshold: 5,
+
+  // A list of paths to snapshot serializer modules Jest should use for snapshot testing
+  // snapshotSerializers: [],
+
+  // The test environment that will be used for testing
+  // testEnvironment: "jest-environment-node",
+
+  // Options that will be passed to the testEnvironment
+  // testEnvironmentOptions: {},
+
+  // Adds a location field to test results
+  // testLocationInResults: false,
+
+  // The glob patterns Jest uses to detect test files
+  // testMatch: [
+  //   "**/__tests__/**/*.[jt]s?(x)",
+  //   "**/?(*.)+(spec|test).[tj]s?(x)"
+  // ],
+
+  // An array of regexp pattern strings that are matched against all test paths, matched tests are skipped
+  // testPathIgnorePatterns: [
+  //   "/node_modules/"
+  // ],
+
+  // The regexp pattern or array of patterns that Jest uses to detect test files
+  // testRegex: [],
+
+  // This option allows the use of a custom results processor
+  // testResultsProcessor: undefined,
+
+  // This option allows use of a custom test runner
+  // testRunner: "jest-circus/runner",
+
+  // A map from regular expressions to paths to transformers
+  // transform: undefined,
+
+  // An array of regexp pattern strings that are matched against all source file paths, matched files will skip transformation
+  // transformIgnorePatterns: [
+  //   "/node_modules/",
+  //   "\\.pnp\\.[^\\/]+$"
+  // ],
+
+  // An array of regexp pattern strings that are matched against all modules before the module loader will automatically return a mock for them
+  // unmockedModulePathPatterns: undefined,
+
+  // Indicates whether each individual test should be reported during the run
+  // verbose: undefined,
+
+  // An array of regexp patterns that are matched against all source file paths before re-running tests in watch mode
+  // watchPathIgnorePatterns: [],
+
+  // Whether to use watchman for file crawling
+  // watchman: true,
+}
+
+export default config

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@starbemtech/star-db-query-builder",
+  "version": "1.0.0",
+  "description": "A query builder to be used with mysql or postgres",
+  "author": "Julio Sousa <julio.sousa@starbem.app>",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "license": "MIT",
+  "engines": {
+    "node": ">=16.13",
+    "pnpm": ">=8.6.7 <9"
+  },
+  "scripts": {
+    "build": "tsc",
+    "prepare": "husky",
+    "test": "jest",
+    "coverage": "jest --watchAll --coverage"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/starbem/star-db-query-builder.git"
+  },
+  "bugs": {
+    "url": "https://github.com/starbem/star-db-query-builder/issues"
+  },
+  "keywords": [
+    "javascript",
+    "postgres",
+    "mysql",
+    "sql",
+    "database"
+  ],
+  "devDependencies": {
+    "@types/jest": "^29.5.12",
+    "@types/mysql": "^2.15.26",
+    "@types/node": "^20.11.30",
+    "@types/pg": "^8.11.4",
+    "@typescript-eslint/eslint-plugin": "^7.4.0",
+    "@typescript-eslint/parser": "^7.4.0",
+    "eslint": "^8.57.0",
+    "eslint-config-prettier": "^9.1.0",
+    "eslint-plugin-jest": "^27.9.0",
+    "eslint-plugin-prettier": "^5.1.3",
+    "git-commit-msg-linter": "^5.0.7",
+    "husky": "^9.0.11",
+    "jest": "^29.7.0",
+    "lint-staged": "^15.2.2",
+    "prettier": "^3.2.5",
+    "typescript": "^5.4.3"
+  },
+  "dependencies": {
+    "mysql2": "^3.9.3",
+    "pg": "^8.11.3"
+  },
+  "lint-staged": {
+    "*.{ts}": [
+      "eslint --fix",
+      "prettier --write"
+    ]
+  },
+  "husky": {
+    "hooks": {
+      "pre-commit": "lint-staged"
+    }
+  }
+}

package/src/db/IDatabaseClient.ts

@@ -0,0 +1,6 @@
+import { DBClients } from '../default/types'
+
+export type IDatabaseClient = {
+  clientType: DBClients
+  query: <T>(sql: string, params?: any[]) => Promise<T>
+}

package/src/db/initDb.ts

@@ -0,0 +1,27 @@
+import { Pool as PgPool } from 'pg'
+import { createPool as createMySqlPool } from 'mysql2/promise'
+import { createPgClient } from './pgClient'
+import { createMysqlClient } from './mysqlClient'
+import { IDatabaseClient } from './IDatabaseClient'
+
+let dbClient: IDatabaseClient | null = null
+
+export const initDb = (config: { type: 'pg' | 'mysql'; options: any }) => {
+  if (config.type === 'pg') {
+    const pool = new PgPool(config.options)
+    dbClient = createPgClient(pool)
+  } else if (config.type === 'mysql') {
+    const pool = createMySqlPool(config.options)
+    dbClient = createMysqlClient(pool)
+  } else {
+    throw new Error('Unsupported database type')
+  }
+}
+
+export const getDbClient = (): IDatabaseClient => {
+  if (!dbClient) {
+    throw new Error('Database client is not initialized')
+  }
+
+  return dbClient
+}

package/src/db/mysqlClient.ts

@@ -0,0 +1,10 @@
+import { Pool } from 'mysql2/promise'
+import { IDatabaseClient } from './IDatabaseClient'
+
+export const createMysqlClient = (pool: Pool): IDatabaseClient => ({
+  clientType: 'mysql',
+  query: async <T>(sql: string, params?: any[]): Promise<T> => {
+    const [rows] = await pool.execute(sql, params)
+    return rows as unknown as T
+  },
+})

package/src/db/pgClient.ts

@@ -0,0 +1,10 @@
+import { Pool } from 'pg'
+import { IDatabaseClient } from './IDatabaseClient'
+
+export const createPgClient = (pool: Pool): IDatabaseClient => ({
+  clientType: 'pg',
+  query: async <T>(sql: string, params?: any[]): Promise<T> => {
+    const { rows } = await pool.query(sql, params)
+    return rows as unknown as T
+  },
+})

package/src/default/genericRepository.ts

@@ -0,0 +1,143 @@
+import { QueryParams } from './types'
+import {
+  createGroupByClause,
+  createLimitClause,
+  createOrderByClause,
+  generatePlaceholders,
+  createSelectFields,
+  createWhereClause,
+  generateSetClause,
+} from './utils'
+
+export const findFirst = async <T>({
+  tableName,
+  dbClient,
+  select,
+  where,
+  groupBy,
+  orderBy,
+}: QueryParams): Promise<T> => {
+  if (!tableName) throw new Error('Table name is required')
+  if (!dbClient) throw new Error('DB client is required')
+
+  const fields = createSelectFields(select)
+  const [whereClause, params] = createWhereClause(where)
+  const orderByClause = createOrderByClause(orderBy)
+  const groupByClause = createGroupByClause(groupBy)
+
+  const rows = await dbClient.query<T>(
+    `SELECT ${fields} FROM ${tableName}
+      ${whereClause.length > 7 ? whereClause : ''}
+      ${groupByClause}
+      ${orderByClause}
+    `,
+    [params]
+  )
+
+  return rows[0] || null
+}
+
+export const findMany = async <T>({
+  tableName,
+  dbClient,
+  select,
+  where,
+  groupBy,
+  orderBy,
+  limit,
+}: QueryParams): Promise<T[]> => {
+  if (!tableName) throw new Error('Table name is required')
+  if (!dbClient) throw new Error('DB client is required')
+
+  const fields = createSelectFields(select)
+  const [whereClause, params] = createWhereClause(where)
+  const orderByClause = createOrderByClause(orderBy)
+  const groupByClause = createGroupByClause(groupBy)
+  const limitClause = createLimitClause(limit)
+
+  const rows = await dbClient.query<T[]>(
+    `SELECT ${fields} FROM ${tableName}
+      ${whereClause.length > 7 ? whereClause : ''}
+      ${groupByClause}
+      ${orderByClause}
+      ${limitClause}
+    `,
+    [params]
+  )
+
+  return rows || []
+}
+
+export const insert = async <T>({
+  tableName,
+  dbClient,
+  data,
+  returning,
+}: QueryParams & { data: T; returning?: string[] }): Promise<T | void> => {
+  if (!tableName) throw new Error('Table name is required')
+  if (!dbClient) throw new Error('DB client is required')
+  if (!data) throw new Error('Data object is required')
+
+  const keys = Object.keys(data)
+  const values = Object.values(data)
+
+  const placeholders = generatePlaceholders(keys, dbClient.clientType)
+  let query = `INSERT INTO ${tableName} (${keys.join(', ')}) VALUES (${placeholders})`
+
+  if (dbClient.clientType === 'pg') {
+    if (returning && returning.length > 0) {
+      query += ` RETURNING ${createSelectFields(returning)}`
+    }
+  }
+
+  const inserted = await dbClient.query<T[]>(query, values)
+
+  if (dbClient.clientType === 'pg') return inserted[0]
+}
+
+export const update = async <T>({
+  tableName,
+  dbClient,
+  id,
+  data,
+  returning,
+}: QueryParams & { data: T; returning?: string[] }): Promise<T | void> => {
+  if (!tableName) throw new Error('Table name is required')
+  if (!dbClient) throw new Error('DB client is required')
+  if (!id) throw new Error('ID is required')
+  if (!data) throw new Error('Data object is required')
+
+  const keys = Object.keys(data)
+  const values: any[] = Object.values(data)
+
+  const setClause = generateSetClause(keys, dbClient.clientType)
+  let query = `UPDATE ${tableName} SET ${setClause} WHERE ${id}`
+
+  if (dbClient.clientType === 'pg') {
+    if (returning && returning.length > 0) {
+      query += ` RETURNIN ${createSelectFields(returning)}`
+    }
+  }
+
+  const updated = await dbClient.query<T[]>(query, values)
+
+  if (dbClient.clientType === 'pg') return updated[0]
+}
+
+export const deleteOne = async ({
+  tableName,
+  dbClient,
+  id,
+  permanently = false,
+}: QueryParams & { permanently?: boolean }): Promise<void> => {
+  if (!tableName) throw new Error('Table name is required')
+  if (!dbClient) throw new Error('DB client is required')
+  if (!id) throw new Error('ID is required')
+
+  await dbClient.query(
+    permanently
+      ? `DELETE FROM ${tableName} WHERE id = ${dbClient.clientType === 'pg' ? '$1' : '?'}`
+      : `UPDATE ${tableName} SET status = 'deleted' WHERE id = ${dbClient.clientType === 'pg' ? '$1' : '?'}`,
+    [id]
+  )
+}

package/src/default/types.ts

@@ -0,0 +1,53 @@
+import { IDatabaseClient } from '../db/IDatabaseClient'
+
+export interface QueryExec {
+  text: string
+  values?: any[]
+}
+
+type SimpleValue = string | number | boolean | Date
+
+type ConditionOperator = 'AND' | 'OR'
+
+interface OperatorCondition {
+  operator:
+    | 'LIKE'
+    | '='
+    | '>'
+    | '<'
+    | 'IN'
+    | 'BETWEEN'
+    | '!='
+    | '<='
+    | '>='
+    | 'NOT IN'
+    | 'LIKE'
+    | 'NOT LIKE'
+  value: SimpleValue | SimpleValue[]
+}
+
+export type DBClients = 'pg' | 'mysql'
+
+export interface CompositeCondition {
+  type: ConditionOperator
+  conditions: Condition[]
+}
+
+export type Condition = SimpleValue | OperatorCondition | CompositeCondition
+
+export interface Conditions {
+  [key: string]: Condition
+}
+
+export type OrderBy = { field: string; direction: 'ASC' | 'DESC' }[]
+
+export interface QueryParams {
+  tableName: string
+  dbClient: IDatabaseClient
+  id?: string
+  select?: string[]
+  where?: Conditions
+  orderBy?: OrderBy
+  groupBy?: string[]
+  limit?: number
+}

package/src/default/utils.ts

@@ -0,0 +1,107 @@
+import {
+  Conditions,
+  Condition,
+  CompositeCondition,
+  OrderBy,
+  DBClients,
+} from './types'
+
+const arrayToStringWithQuotes = (items: string[]): string => {
+  const itemsWithQuotes = items.map((item) => `"${item}"`)
+  return itemsWithQuotes.join(', ')
+}
+
+export const createSelectFields = (fields?: string[]): string => {
+  return fields && fields.length > 0 ? arrayToStringWithQuotes(fields) : '*'
+}
+
+export const generatePlaceholders = (
+  keys: any[],
+  clientType: DBClients
+): string => {
+  return keys
+    .map((_, index) => (clientType === 'pg' ? `$${index + 1}` : '?'))
+    .join(', ')
+}
+
+export const generateSetClause = (
+  keys: any[],
+  clientType: DBClients
+): string => {
+  return keys
+    .map((key, index) =>
+      clientType === 'pg' ? `${key} = $${index + 1}` : `${key} = ?`
+    )
+    .join(', ')
+}
+
+export const createWhereClause = (
+  conditions: Conditions = {},
+  startIndex: number = 1
+): [string, any[], number] => {
+  let index = startIndex
+  const whereParts: string[] = []
+  const values: any[] = []
+
+  const processCondition = (key: string, condition: Condition): number => {
+    if (typeof condition === 'object' && condition !== null) {
+      if ('operator' in condition && 'value' in condition) {
+        const { operator, value } = condition
+        if (Array.isArray(value)) {
+          const placeholders = value.map(() => `$${index++}`).join(', ')
+          if (operator === 'BETWEEN') {
+            whereParts.push(
+              `"${key}" ${operator} ${placeholders.replace(', ', ' AND ')}`
+            )
+          } else {
+            whereParts.push(`"${key}" ${operator} (${placeholders})`)
+          }
+          values.push(...value)
+        } else {
+          whereParts.push(`"${key}" ${operator} $${index++}`)
+          values.push(value)
+        }
+      } else if ('type' in condition && 'conditions' in condition) {
+        const compositeCondition: CompositeCondition = condition
+        const subWhereParts: string[] = []
+        compositeCondition.conditions.forEach((subCondition) => {
+          // Recurso: criar uma chave fictícia, pois as condições compostas não necessitam de chave
+          index = processCondition('', subCondition)
+        })
+        whereParts.push(
+          `(${subWhereParts.join(` ${compositeCondition.type} `)})`
+        )
+      }
+    } else if (key) {
+      // Condição simples
+      whereParts.push(`"${key}" = $${index}`)
+      values.push(condition)
+      index++
+    }
+    return index
+  }
+
+  Object.entries(conditions).forEach(([key, value]) => {
+    index = processCondition(key, value)
+  })
+
+  const whereClause =
+    whereParts.length > 0 ? ` WHERE ${whereParts.join(' AND ')}` : ''
+  return [whereClause, values, index]
+}
+
+export const createOrderByClause = (orderBy?: OrderBy) => {
+  if (!orderBy || orderBy.length === 0) return ''
+  const clause = orderBy.map((o) => `${o.field} ${o.direction}`).join(', ')
+  return ` ORDER BY ${clause}`
+}
+
+export const createGroupByClause = (groupBy?: string[]) => {
+  if (!groupBy || groupBy.length === 0) return ''
+  return ` GROUP BY ${groupBy.join(', ')}`
+}
+
+export const createLimitClause = (limit?: number) => {
+  if (!limit) return ''
+  return ` LIMIT ${limit}`
+}