tspace-mysql 1.9.0 → 1.9.1-beta.2

package/dist/lib/core/Builder.js

@@ -24,7 +24,15 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
     }
     /**
      * The 'driver' method is used to get current driver
-     * @returns {string} driver
+     * @static
+     * @returns {TDriver} driver
+     */
+    static driver() {
+        return new this().driver();
+    }
+    /**
+     * The 'driver' method is used to get current driver
+     * @returns {TDriver} driver
      */
     driver() {
         return this.$driver;
@@ -37,16 +45,83 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
         return this.$database;
     }
     /**
-     * The 'rowLock' method is used to row level locks
+     * The 'rowLock' method is used to row level locks (`FOR UPDATE` or `FOR SHARE`) to the query.
      *
      * @param {string} mode
      * @returns {this} this
      */
-    rowLock(mode) {
+    rowLock(mode, opts = {}) {
         if (!["FOR_UPDATE", "FOR_SHARE"].includes(mode)) {
             throw new Error(`Invalid lock mode: ${mode}`);
         }
-        this.$state.set("ROW_LEVEL_LOCK", mode);
+        if (opts.skipLocked && opts.nowait) {
+            throw new Error("Cannot use skipLocked and nowait together");
+        }
+        this.$state.set("ROW_LEVEL_LOCK", {
+            mode,
+            skipLocked: !!opts.skipLocked,
+            nowait: !!opts.nowait
+        });
+        return this;
+    }
+    /**
+     * The 'forUpdate' method is used to applies a row-level exclusive lock (`FOR UPDATE`) to the query.
+     *
+     * This lock prevents other transactions from modifying or acquiring
+     * conflicting locks on the selected rows until the current transaction
+     * is committed or rolled back.
+     *
+     * Commonly used in queue systems or critical sections to safely
+     * select and update rows without race conditions.
+     *
+     * @param {Object} [opts] - Locking options
+     * @param {boolean} [opts.skipLocked=false] - If true, skips rows that are already locked by other transactions.
+     *                                           Useful for building non-blocking workers (e.g., job queues).
+     * @param {boolean} [opts.nowait=false] - If true, throws an error immediately if the lock cannot be acquired.
+     *
+     * @throws {Error} If both `skipLocked` and `nowait` are enabled at the same time.
+     *
+     * @returns {this} Returns the query builder instance for chaining.
+     */
+    forUpdate(opts = {}) {
+        if (opts.skipLocked && opts.nowait) {
+            throw new Error("Cannot use skipLocked and nowait together");
+        }
+        this.$state.set("ROW_LEVEL_LOCK", {
+            mode: 'FOR_UPDATE',
+            skipLocked: !!opts.skipLocked,
+            nowait: !!opts.nowait
+        });
+        return this;
+    }
+    /**
+     * The 'forShare' method is used to applies a row-level exclusive lock (`FOR SHARE`) to the query.
+     *
+     * This lock prevents other transactions from modifying or acquiring
+     * conflicting locks on the selected rows until the current transaction
+     * is committed or rolled back.
+     *
+     * Commonly used in queue systems or critical sections to safely
+     * select and update rows without race conditions.
+     *
+     * @param {Object} [opts] - Locking options
+     * @param {boolean} [opts.skipLocked=false] - If true, skips rows that are already locked by other transactions.
+     *                                           Useful for building non-blocking workers (e.g., job queues).
+     * @param {boolean} [opts.nowait=false] - If true, throws an error immediately if the lock cannot be acquired.
+     *
+     * @throws {Error} If both `skipLocked` and `nowait` are enabled at the same time.
+     *
+     * @returns {this} Returns the query builder instance for chaining.
+     */
+    forShare(opts = {}) {
+        if (opts.skipLocked && opts.nowait) {
+            throw new Error("Cannot use skipLocked and nowait together");
+        }
+        this.$state.set("ROW_LEVEL_LOCK", {
+            mode: 'FOR_SHARE',
+            skipLocked: !!opts.skipLocked,
+            nowait: !!opts.nowait
+        });
         return this;
     }
     /**
@@ -80,7 +155,8 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
         if (options?.offset != null && options.offset)
             this.$state.set("OFFSET", null);
         if (options?.alias != null && options.alias)
-            this.$state.set("RAW_ALIAS", null);
+            this.$state.set("ALIAS", null);
+        this.$state.set("RAW_ALIAS", null);
         return this;
     }
     /**
@@ -138,6 +214,27 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
         this.$state.set("SELECT", select);
         return this;
     }
+    /**
+     * The 'addSelect' method is used to add columns you want to retrieve from a database table.
+     *
+     * It allows you to choose the specific columns that should be included in the result set of a database query.
+     * @param {string[]} ...columns
+     * @returns {this} this
+     */
+    addSelect(...columns) {
+        let select = columns.map((c) => {
+            const column = String(c);
+            if (column.includes(this.$constants("RAW"))) {
+                return column?.replace(this.$constants("RAW"), "").replace(/'/g, "");
+            }
+            return this.bindColumn(column);
+        });
+        this.$state.set("ADD_SELECT", [
+            ...select,
+            ...this.$state.get("ADD_SELECT"),
+        ]);
+        return this;
+    }
     /**
      * The 'selectRaw' method is used to specify which columns you want to retrieve from a database table.
      *
@@ -155,8 +252,9 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
                 return column;
             if (column.includes("`*`"))
                 return column.replace("`*`", "*");
-            if (column.includes(this.$constants("RAW")))
-                return column?.replace(this.$constants("RAW"), "").replace(/'/g, "");
+            if (column.includes(this.$constants("RAW"))) {
+                return column?.replace(this.$constants("RAW"), "");
+            }
             return column;
         });
         select = [...this.$state.get("SELECT"), ...select];
@@ -200,7 +298,7 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
         return this;
     }
     /**
-     * The 'selectObject' method is used to specify which columns you want to retrieve from a database table.
+     * The 'selectArray' method is used to specify which columns you want to retrieve from a database table.
      *
      * It allows you to choose the specific columns that should be included in the result set to 'Object' of a database query.
      * @param {string} object table name
@@ -223,15 +321,17 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
                 `\`${this.getTableName()}\`.\`${value}\``,
             ];
         }
-        const json = `
-            ${this.$constants("CASE")}
-            ${this.$constants("WHEN")} COUNT(${Object.values(maping)[1]}) = 0 ${this.$constants("THEN")} ${this.$constants("JSON_ARRAY")}()
-            ${this.$constants("ELSE")} ${this.$constants("JSON_ARRAYAGG")}(
-                ${this.$constants("JSON_OBJECT")}(${maping.join(" , ")})
-            )
-            ${this.$constants("END")}
-            ${this.$constants("AS")} \`${alias}\`
-        `;
+        const json = [
+            `${this.$constants("CASE")}`,
+            `${this.$constants("WHEN")}`,
+            `${this.$constants("COUNT")}(${Object.values(maping)[1]}) = 0`,
+            `${this.$constants("THEN")}`,
+            `${this.$constants("JSON_ARRAY")}()`,
+            `${this.$constants("ELSE")}`,
+            `${this.$constants("JSON_ARRAYAGG")}(${this.$constants("JSON_OBJECT")}(${maping.join(", ")}))`,
+            `${this.$constants("END")}`,
+            `${this.$constants("AS")} \`${alias}\``
+        ].join(" ");
         this.$state.set("SELECT", [...this.$state.get("SELECT"), json]);
         return this;
     }
@@ -321,7 +421,9 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
      */
     sleep(second) {
         this.CTEs('sleep', (query) => {
-            return query.selectRaw(this._queryBuilder().sleep(second)).from('');
+            return query
+                .selectRaw(`${this._queryBuilder().sleep(second)} ${this.$constants("AS")} delay`)
+                .from(null);
         });
         this.from(this.$state.get("TABLE_NAME"), {
             push: [`${this.$constants("RAW")}sleep`]
@@ -389,8 +491,6 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
             return this.whereObject(column);
         }
         [value, operator] = this.$utils.valueAndOperator(value, operator, arguments.length === 2);
-        value = this.$utils.escape(value);
-        value = this.$utils.transfromBooleanToNumber(value);
         if (value === null) {
             return this.whereNull(column);
         }
@@ -399,12 +499,11 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
         }
         this.$state.set("WHERE", [
             ...this.$state.get("WHERE"),
-            [
-                this.$state.get("WHERE").length ? `${this.$constants("AND")}` : "",
-                `${this.bindColumn(String(column))}`,
-                `${operator}`,
-                `${this.$utils.transfromValueHasRaw(value)}`,
-            ].join(" "),
+            {
+                column: this.bindColumn(String(column)),
+                operator: operator,
+                value: this.$utils.formatQueryValue(value),
+            }
         ]);
         return this;
     }
@@ -421,8 +520,6 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
      */
     orWhere(column, operator, value) {
         [value, operator] = this.$utils.valueAndOperator(value, operator, arguments.length === 2);
-        value = this.$utils.escape(value);
-        value = this.$utils.transfromBooleanToNumber(value);
         if (value === null) {
             return this.orWhereNull(column);
         }
@@ -431,12 +528,12 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
         }
         this.$state.set("WHERE", [
             ...this.$state.get("WHERE"),
-            [
-                this.$state.get("WHERE").length ? `${this.$constants("OR")}` : "",
-                `${this.bindColumn(String(column))}`,
-                `${operator}`,
-                `${this.$utils.transfromValueHasRaw(value)}`,
-            ].join(" "),
+            {
+                column: this.bindColumn(String(column)),
+                operator: operator,
+                value: this.$utils.formatQueryValue(value),
+                condition: 'OR'
+            }
         ]);
         return this;
     }
@@ -451,12 +548,11 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
     whereDay(column, day) {
         this.$state.set("WHERE", [
             ...this.$state.get("WHERE"),
-            [
-                this.$state.get("WHERE").length ? `${this.$constants("AND")}` : "",
-                `DAY(${this.bindColumn(String(column))})`,
-                `=`,
-                `'${`00${this.$utils.escape(day)}`.slice(-2)}'`,
-            ].join(" "),
+            {
+                column: `DAY(${this.bindColumn(String(column))})`,
+                operator: '=',
+                value: `'${`00${this.$utils.escape(day)}`.slice(-2)}'`,
+            }
         ]);
         return this;
     }
@@ -471,12 +567,11 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
     whereMonth(column, month) {
         this.$state.set("WHERE", [
             ...this.$state.get("WHERE"),
-            [
-                this.$state.get("WHERE").length ? `${this.$constants("AND")}` : "",
-                `MONTH(${this.bindColumn(String(column))})`,
-                `=`,
-                `'${`00${this.$utils.escape(month)}`.slice(-2)}'`,
-            ].join(" "),
+            {
+                column: `MONTH(${this.bindColumn(String(column))})`,
+                operator: '=',
+                value: `'${`00${this.$utils.formatQueryValue(month)}`.slice(-2)}'`,
+            }
         ]);
         return this;
     }
@@ -491,12 +586,11 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
     whereYear(column, year) {
         this.$state.set("WHERE", [
             ...this.$state.get("WHERE"),
-            [
-                this.$state.get("WHERE").length ? `${this.$constants("AND")}` : "",
-                `YEAR(${this.bindColumn(String(column))})`,
-                `=`,
-                `'${`0000${this.$utils.escape(year)}`.slice(-4)}'`,
-            ].join(" "),
+            {
+                column: `YEAR(${this.bindColumn(String(column))})`,
+                operator: '=',
+                value: `'${`0000${this.$utils.formatQueryValue(year)}`.slice(-2)}'`,
+            }
         ]);
         return this;
     }
@@ -508,13 +602,16 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
      * @param {string} sql where column with raw sql
      * @returns {this} this
      */
-    whereRaw(sql) {
+    whereRaw(sql, parameters = []) {
+        if (parameters.length) {
+            sql = this.$utils.bindingParameters(sql, parameters);
+        }
+        ;
         this.$state.set("WHERE", [
             ...this.$state.get("WHERE"),
-            [
-                this.$state.get("WHERE").length ? `${this.$constants("AND")}` : "",
-                `${sql}`,
-            ].join(" "),
+            {
+                value: sql,
+            }
         ]);
         return this;
     }
@@ -526,13 +623,17 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
      * @param {string} sql where column with raw sql
      * @returns {this} this
      */
-    orWhereRaw(sql) {
+    orWhereRaw(sql, parameters = []) {
+        if (parameters.length) {
+            sql = this.$utils.bindingParameters(sql, parameters);
+        }
+        ;
         this.$state.set("WHERE", [
             ...this.$state.get("WHERE"),
-            [
-                this.$state.get("WHERE").length ? `${this.$constants("OR")}` : "",
-                `${sql}`,
-            ].join(" "),
+            {
+                value: sql,
+                condition: 'OR'
+            }
         ]);
         return this;
     }
@@ -618,16 +719,13 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
      * @returns   {this}
      */
     whereJSON(column, { key, value, operator }) {
-        value = this.$utils.escape(value);
-        value = this.$utils.transfromBooleanToNumber(value);
         this.$state.set("WHERE", [
             ...this.$state.get("WHERE"),
-            [
-                this.$state.get("WHERE").length ? `${this.$constants("AND")}` : "",
-                `${this.bindColumn(column)}->>'$.${key}'`,
-                `${operator == null ? "=" : operator.toLocaleUpperCase()}`,
-                `${this.$utils.transfromValueHasRaw(value)}`,
-            ].join(" "),
+            {
+                column: `${this.bindColumn(String(column))}->>'$.${key}'`,
+                operator: `${operator == null ? "=" : operator.toLocaleUpperCase()}`,
+                value: `${this.$utils.formatQueryValue(value)}`
+            }
         ]);
         return this;
     }
@@ -654,13 +752,14 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
      * @returns {this}
      */
     whereExists(sql) {
+        if (sql instanceof Builder && !sql.$state.get("SELECT").length) {
+            sql.select1();
+        }
         this.$state.set("WHERE", [
             ...this.$state.get("WHERE"),
-            [
-                this.$state.get("WHERE").length ? `${this.$constants("AND")}` : "",
-                `${this.$constants("EXISTS")}`,
-                `(${sql})`,
-            ].join(" "),
+            {
+                value: `${this.$constants("EXISTS")} (${sql})`
+            }
         ]);
         return this;
     }
@@ -675,11 +774,9 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
     whereNotExists(sql) {
         this.$state.set("WHERE", [
             ...this.$state.get("WHERE"),
-            [
-                this.$state.get("WHERE").length ? `${this.$constants("AND")}` : "",
-                `${this.$constants("NOT")} ${this.$constants("EXISTS")}`,
-                `(${sql})`,
-            ].join(" "),
+            {
+                value: `${this.$constants("NOT")} ${this.$constants("EXISTS")} (${sql})`
+            }
         ]);
         return this;
     }
@@ -694,11 +791,10 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
     orWhereExists(sql) {
         this.$state.set("WHERE", [
             ...this.$state.get("WHERE"),
-            [
-                this.$state.get("WHERE").length ? `${this.$constants("OR")}` : "",
-                `${this.$constants("EXISTS")}`,
-                `(${sql})`,
-            ].join(" "),
+            {
+                value: `${this.$constants("EXISTS")} (${sql})`,
+                condition: 'OR'
+            }
         ]);
         return this;
     }
@@ -713,11 +809,10 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
     orWhereNotExists(sql) {
         this.$state.set("WHERE", [
             ...this.$state.get("WHERE"),
-            [
-                this.$state.get("WHERE").length ? `${this.$constants("OR")}` : "",
-                `${this.$constants("NOT")} ${this.$constants("EXISTS")}`,
-                `(${sql})`,
-            ].join(" "),
+            {
+                value: `${this.$constants("NOT")} ${this.$constants("EXISTS")} (${sql})`,
+                condition: 'OR'
+            }
         ]);
         return this;
     }
@@ -729,10 +824,11 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
     whereId(id, column = "id") {
         this.$state.set("WHERE", [
             ...this.$state.get("WHERE"),
-            [
-                this.$state.get("WHERE").length ? `${this.$constants("AND")}` : "",
-                `${this.bindColumn(column)} = ${this.$utils.escape(id)}`,
-            ].join(" "),
+            {
+                column: this.bindColumn(String(column)),
+                operator: '=',
+                value: this.$utils.escape(id),
+            }
         ]);
         return this;
     }
@@ -745,10 +841,11 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
         const column = "email";
         this.$state.set("WHERE", [
             ...this.$state.get("WHERE"),
-            [
-                this.$state.get("WHERE").length ? `${this.$constants("AND")}` : "",
-                `${this.bindColumn(column)} = ${this.$utils.escape(email)}`,
-            ].join(" "),
+            {
+                column: this.bindColumn(String(column)),
+                operator: '=',
+                value: this.$utils.escape(email),
+            }
         ]);
         return this;
     }
@@ -761,10 +858,11 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
     whereUser(userId, column = "user_id") {
         this.$state.set("WHERE", [
             ...this.$state.get("WHERE"),
-            [
-                this.$state.get("WHERE").length ? `${this.$constants("AND")}` : "",
-                `${this.bindColumn(column)} = ${this.$utils.escape(userId)}`,
-            ].join(" "),
+            {
+                column: this.bindColumn(String(column)),
+                operator: '=',
+                value: this.$utils.escape(userId),
+            }
         ]);
         return this;
     }
@@ -779,19 +877,19 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
     whereIn(column, array) {
         if (!Array.isArray(array))
             array = [array];
-        const values = array.length
-            ? `${array
-                .map((value) => this.$utils.transfromValueHasRaw(this.$utils.escape(value)))
-                .join(",")}`
-            : this.$constants(this.$constants("NULL"));
+        if (!array.length) {
+            array = [DB_1.DB.raw(this.$constants("NULL"))];
+        }
         this.$state.set("WHERE", [
             ...this.$state.get("WHERE"),
-            [
-                this.$state.get("WHERE").length ? `${this.$constants("AND")}` : "",
-                `${this.bindColumn(column)}`,
-                `${this.$constants("IN")}`,
-                `(${values})`,
-            ].join(" "),
+            {
+                column: this.bindColumn(String(column)),
+                operator: `${this.$constants("IN")}`,
+                value: array
+                    .map((value) => {
+                    return this.$utils.formatQueryValue(value);
+                })
+            }
         ]);
         return this;
     }
@@ -806,19 +904,20 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
     orWhereIn(column, array) {
         if (!Array.isArray(array))
             array = [array];
-        const values = array.length
-            ? `${array
-                .map((value) => this.$utils.transfromValueHasRaw(this.$utils.escape(value)))
-                .join(",")}`
-            : this.$constants(this.$constants("NULL"));
+        if (!array.length) {
+            array = [DB_1.DB.raw(this.$constants("NULL"))];
+        }
         this.$state.set("WHERE", [
             ...this.$state.get("WHERE"),
-            [
-                this.$state.get("WHERE").length ? `${this.$constants("OR")}` : "",
-                `${this.bindColumn(column)}`,
-                `${this.$constants("IN")}`,
-                `(${values})`,
-            ].join(" "),
+            {
+                column: this.bindColumn(String(column)),
+                operator: `${this.$constants("IN")}`,
+                condition: 'OR',
+                value: array
+                    .map((value) => {
+                    return this.$utils.formatQueryValue(value);
+                })
+            }
         ]);
         return this;
     }
@@ -833,19 +932,16 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
     whereNotIn(column, array) {
         if (!Array.isArray(array))
             array = [array];
-        const values = array.length
-            ? `${array
-                .map((value) => this.$utils.transfromValueHasRaw(this.$utils.escape(value)))
-                .join(",")}`
-            : this.$constants(this.$constants("NULL"));
         this.$state.set("WHERE", [
             ...this.$state.get("WHERE"),
-            [
-                this.$state.get("WHERE").length ? `${this.$constants("AND")}` : "",
-                `${this.bindColumn(column)}`,
-                `${this.$constants("NOT_IN")}`,
-                `(${values})`,
-            ].join(" "),
+            {
+                column: this.bindColumn(String(column)),
+                operator: `${this.$constants("NOT_IN")}`,
+                value: array
+                    .map((value) => {
+                    return this.$utils.formatQueryValue(value);
+                })
+            }
         ]);
         return this;
     }
@@ -860,19 +956,17 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
     orWhereNotIn(column, array) {
         if (!Array.isArray(array))
             array = [array];
-        const values = array.length
-            ? `${array
-                .map((value) => this.$utils.transfromValueHasRaw(this.$utils.escape(value)))
-                .join(",")}`
-            : this.$constants(this.$constants("NULL"));
         this.$state.set("WHERE", [
             ...this.$state.get("WHERE"),
-            [
-                this.$state.get("WHERE").length ? `${this.$constants("OR")}` : "",
-                `${this.bindColumn(column)}`,
-                `${this.$constants("NOT_IN")}`,
-                `(${values})`,
-            ].join(" "),
+            {
+                column: this.bindColumn(String(column)),
+                operator: `${this.$constants("IN")}`,
+                condition: 'OR',
+                value: array
+                    .map((value) => {
+                    return this.$utils.formatQueryValue(value);
+                })
+            }
         ]);
         return this;
     }
@@ -892,12 +986,11 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
         }
         this.$state.set("WHERE", [
             ...this.$state.get("WHERE"),
-            [
-                this.$state.get("WHERE").length ? `${this.$constants("AND")}` : "",
-                `${this.bindColumn(column)}`,
-                options.operator,
-                `(${subQuery})`,
-            ].join(" "),
+            {
+                column: this.bindColumn(String(column)),
+                operator: options.operator,
+                value: `(${subQuery})`
+            }
         ]);
         return this;
     }
@@ -917,13 +1010,11 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
         }
         this.$state.set("WHERE", [
             ...this.$state.get("WHERE"),
-            [
-                this.$state.get("WHERE").length ? `${this.$constants("AND")}` : "",
-                `${this.bindColumn(column)}`,
-                options.operator,
-                ,
-                `(${subQuery})`,
-            ].join(" "),
+            {
+                column: this.bindColumn(String(column)),
+                operator: options.operator,
+                value: `(${subQuery})`
+            }
         ]);
         return this;
     }
@@ -943,12 +1034,12 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
         }
         this.$state.set("WHERE", [
             ...this.$state.get("WHERE"),
-            [
-                this.$state.get("WHERE").length ? `${this.$constants("OR")}` : "",
-                `${this.bindColumn(column)}`,
-                options.operator,
-                `(${subQuery})`,
-            ].join(" "),
+            {
+                column: this.bindColumn(String(column)),
+                operator: options.operator,
+                condition: 'OR',
+                value: `(${subQuery})`
+            }
         ]);
         return this;
     }
@@ -968,12 +1059,12 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
         }
         this.$state.set("WHERE", [
             ...this.$state.get("WHERE"),
-            [
-                this.$state.get("WHERE").length ? `${this.$constants("OR")}` : "",
-                `${this.bindColumn(column)}`,
-                options.operator,
-                `(${subQuery})`,
-            ].join(" "),
+            {
+                column: this.bindColumn(String(column)),
+                operator: options.operator,
+                condition: 'OR',
+                value: `(${subQuery})`
+            }
         ]);
         return this;
     }
@@ -987,30 +1078,20 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
      */
     whereBetween(column, array) {
         if (!array.length) {
-            this.$state.set("WHERE", [
-                ...this.$state.get("WHERE"),
-                [
-                    this.$state.get("WHERE").length ? `${this.$constants("AND")}` : "",
-                    `${this.bindColumn(column)}`,
-                    `${this.$constants("BETWEEN")}`,
-                    `${this.$constants(this.$constants("NULL"))}`,
-                    `${this.$constants("AND")}`,
-                    `${this.$constants(this.$constants("NULL"))}`,
-                ].join(" "),
-            ]);
-            return this;
+            return this.whereBetween(column, [DB_1.DB.raw('NULL'), DB_1.DB.raw('NULL')]);
         }
         const [value1, value2] = array;
         this.$state.set("WHERE", [
             ...this.$state.get("WHERE"),
-            [
-                this.$state.get("WHERE").length ? `${this.$constants("AND")}` : "",
-                `${this.bindColumn(column)}`,
-                `${this.$constants("BETWEEN")}`,
-                `${this.$utils.transfromValueHasRaw(this.$utils.escape(value1))}`,
-                `${this.$constants("AND")}`,
-                `${this.$utils.transfromValueHasRaw(this.$utils.escape(value2))}`,
-            ].join(" "),
+            {
+                column: this.bindColumn(String(column)),
+                operator: `${this.$constants("BETWEEN")}`,
+                value: [
+                    `${this.$utils.formatQueryValue(value1)}`,
+                    `${this.$constants("AND")}`,
+                    `${this.$utils.formatQueryValue(value2)}`,
+                ].join(" ")
+            }
         ]);
         return this;
     }
@@ -1024,30 +1105,21 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
      */
     orWhereBetween(column, array) {
         if (!array.length) {
-            this.$state.set("WHERE", [
-                ...this.$state.get("WHERE"),
-                [
-                    this.$state.get("WHERE").length ? `${this.$constants("OR")}` : "",
-                    `${this.bindColumn(column)}`,
-                    `${this.$constants("BETWEEN")}`,
-                    `${this.$constants(this.$constants("NULL"))}`,
-                    `${this.$constants("AND")}`,
-                    `${this.$constants(this.$constants("NULL"))}`,
-                ].join(" "),
-            ]);
-            return this;
+            return this.orWhereBetween(column, ['NULL', 'NULL']);
         }
         const [value1, value2] = array;
         this.$state.set("WHERE", [
             ...this.$state.get("WHERE"),
-            [
-                this.$state.get("WHERE").length ? `${this.$constants("OR")}` : "",
-                `${this.bindColumn(column)}`,
-                `${this.$constants("BETWEEN")}`,
-                `${this.$utils.transfromValueHasRaw(this.$utils.escape(value1))}`,
-                `${this.$constants("AND")}`,
-                `${this.$utils.transfromValueHasRaw(this.$utils.escape(value2))}`,
-            ].join(" "),
+            {
+                column: this.bindColumn(String(column)),
+                operator: `${this.$constants("BETWEEN")}`,
+                condition: 'OR',
+                value: [
+                    `${this.$utils.formatQueryValue(value1)}`,
+                    `${this.$constants("AND")}`,
+                    `${this.$utils.formatQueryValue(value2)}`,
+                ].join(" ")
+            }
         ]);
         return this;
     }
@@ -1063,30 +1135,20 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
         if (!Array.isArray(array))
             throw new Error("Value is't array");
         if (!array.length) {
-            this.$state.set("WHERE", [
-                ...this.$state.get("WHERE"),
-                [
-                    this.$state.get("WHERE").length ? `${this.$constants("AND")}` : "",
-                    `${this.bindColumn(column)}`,
-                    `${this.$constants("NOT_BETWEEN")}`,
-                    `${this.$constants(this.$constants("NULL"))}`,
-                    `${this.$constants("AND")}`,
-                    `${this.$constants(this.$constants("NULL"))}`,
-                ].join(" "),
-            ]);
-            return this;
+            return this.whereNotBetween(column, ['NULL', 'NULL']);
         }
         const [value1, value2] = array;
         this.$state.set("WHERE", [
             ...this.$state.get("WHERE"),
-            [
-                this.$state.get("WHERE").length ? `${this.$constants("AND")}` : "",
-                `${this.bindColumn(column)}`,
-                `${this.$constants("NOT_BETWEEN")}`,
-                `${this.$utils.transfromValueHasRaw(this.$utils.escape(value1))}`,
-                `${this.$constants("AND")}`,
-                `${this.$utils.transfromValueHasRaw(this.$utils.escape(value2))}`,
-            ].join(" "),
+            {
+                column: this.bindColumn(String(column)),
+                operator: `${this.$constants("NOT_BETWEEN")}`,
+                value: [
+                    `${this.$utils.formatQueryValue(value1)}`,
+                    `${this.$constants("AND")}`,
+                    `${this.$utils.formatQueryValue(value2)}`,
+                ].join(" ")
+            }
         ]);
         return this;
     }
@@ -1102,30 +1164,21 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
         if (!Array.isArray(array))
             throw new Error("Value is't array");
         if (!array.length) {
-            this.$state.set("WHERE", [
-                ...this.$state.get("WHERE"),
-                [
-                    this.$state.get("WHERE").length ? `${this.$constants("OR")}` : "",
-                    `${this.bindColumn(column)}`,
-                    `${this.$constants("NOT_BETWEEN")}`,
-                    `${this.$constants(this.$constants("NULL"))}`,
-                    `${this.$constants("AND")}`,
-                    `${this.$constants(this.$constants("NULL"))}`,
-                ].join(" "),
-            ]);
-            return this;
+            return this.orWhereNotBetween(column, ['NULL', 'NULL']);
         }
         const [value1, value2] = array;
         this.$state.set("WHERE", [
             ...this.$state.get("WHERE"),
-            [
-                this.$state.get("WHERE").length ? `${this.$constants("OR")}` : "",
-                `${this.bindColumn(column)}`,
-                `${this.$constants("NOT_BETWEEN")}`,
-                `${this.$utils.transfromValueHasRaw(this.$utils.escape(value1))}`,
-                `${this.$constants("AND")}`,
-                `${this.$utils.transfromValueHasRaw(this.$utils.escape(value2))}`,
-            ].join(" "),
+            {
+                column: this.bindColumn(String(column)),
+                operator: `${this.$constants("NOT_BETWEEN")}`,
+                condition: 'OR',
+                value: [
+                    `${this.$utils.formatQueryValue(value1)}`,
+                    `${this.$constants("AND")}`,
+                    `${this.$utils.formatQueryValue(value2)}`,
+                ].join(" ")
+            }
         ]);
         return this;
     }
@@ -1139,11 +1192,10 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
     whereNull(column) {
         this.$state.set("WHERE", [
             ...this.$state.get("WHERE"),
-            [
-                this.$state.get("WHERE").length ? `${this.$constants("AND")}` : "",
-                `${this.bindColumn(column)}`,
-                `${this.$constants("IS_NULL")}`,
-            ].join(" "),
+            {
+                column: this.bindColumn(String(column)),
+                operator: `${this.$constants("IS_NULL")}`,
+            }
         ]);
         return this;
     }
@@ -1157,11 +1209,11 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
     orWhereNull(column) {
         this.$state.set("WHERE", [
             ...this.$state.get("WHERE"),
-            [
-                this.$state.get("WHERE").length ? `${this.$constants("OR")}` : "",
-                `${this.bindColumn(column)}`,
-                `${this.$constants("IS_NULL")}`,
-            ].join(" "),
+            {
+                column: this.bindColumn(String(column)),
+                operator: `${this.$constants("IS_NULL")}`,
+                condition: 'OR'
+            }
         ]);
         return this;
     }
@@ -1175,11 +1227,10 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
     whereNotNull(column) {
         this.$state.set("WHERE", [
             ...this.$state.get("WHERE"),
-            [
-                this.$state.get("WHERE").length ? `${this.$constants("AND")}` : "",
-                `${this.bindColumn(column)}`,
-                `${this.$constants("IS_NOT_NULL")}`,
-            ].join(" "),
+            {
+                column: this.bindColumn(String(column)),
+                operator: `${this.$constants("IS_NOT_NULL")}`,
+            }
         ]);
         return this;
     }
@@ -1193,11 +1244,10 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
     orWhereNotNull(column) {
         this.$state.set("WHERE", [
             ...this.$state.get("WHERE"),
-            [
-                this.$state.get("WHERE").length ? `${this.$constants("OR")}` : "",
-                `${this.bindColumn(column)}`,
-                `${this.$constants("IS_NOT_NULL")}`,
-            ].join(" "),
+            {
+                column: this.bindColumn(String(column)),
+                operator: `${this.$constants("IS_NOT_NULL")}`,
+            }
         ]);
         return this;
     }
@@ -1214,17 +1264,13 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
      */
     whereSensitive(column, operator, value) {
         [value, operator] = this.$utils.valueAndOperator(value, operator, arguments.length === 2);
-        value = this.$utils.escape(value);
-        value = this.$utils.transfromBooleanToNumber(value);
         this.$state.set("WHERE", [
             ...this.$state.get("WHERE"),
-            [
-                this.$state.get("WHERE").length ? `${this.$constants("AND")}` : "",
-                `${this.$constants("BINARY")}`,
-                `${this.bindColumn(column)}`,
-                `${operator}`,
-                `${this.$utils.transfromValueHasRaw(this.$utils.escape(value))}`,
-            ].join(" "),
+            {
+                column: `${this.$constants("BINARY")} ${this.bindColumn(String(column))}`,
+                operator: `${this.$constants("IS_NULL")}`,
+                value: `${this.$utils.formatQueryValue(value)}`,
+            }
         ]);
         return this;
     }
@@ -1255,17 +1301,14 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
      */
     orWhereSensitive(column, operator, value) {
         [value, operator] = this.$utils.valueAndOperator(value, operator, arguments.length === 2);
-        value = this.$utils.escape(value);
-        value = this.$utils.transfromBooleanToNumber(value);
         this.$state.set("WHERE", [
             ...this.$state.get("WHERE"),
-            [
-                this.$state.get("WHERE").length ? `${this.$constants("OR")}` : "",
-                `${this.$constants("BINARY")}`,
-                `${this.bindColumn(column)}`,
-                `${operator}`,
-                `${this.$utils.transfromValueHasRaw(this.$utils.escape(value))}`,
-            ].join(" "),
+            {
+                column: `${this.$constants("BINARY")} ${this.bindColumn(String(column))}`,
+                operator,
+                condition: 'OR',
+                value: `${this.$utils.formatQueryValue(value)}`,
+            }
         ]);
         return this;
     }
@@ -1289,10 +1332,7 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
         const query = where.join(" ");
         this.$state.set("WHERE", [
             ...this.$state.get("WHERE"),
-            [
-                this.$state.get("WHERE").length ? `${this.$constants("AND")}` : "",
-                `(${query})`,
-            ].join(" "),
+            ...where
         ]);
         return this;
     }
@@ -1323,13 +1363,9 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
         const where = repository?.$state.get("WHERE") || [];
         if (!where.length)
             return this;
-        const query = where.join(" ");
         this.$state.set("WHERE", [
             ...this.$state.get("WHERE"),
-            [
-                this.$state.get("WHERE").length ? `${this.$constants("OR")}` : "",
-                `(${query})`,
-            ].join(" "),
+            ...where
         ]);
         return this;
     }
@@ -1355,8 +1391,6 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
      */
     whereAny(columns, operator, value) {
         [value, operator] = this.$utils.valueAndOperator(value, operator, arguments.length === 2);
-        value = this.$utils.escape(value);
-        value = this.$utils.transfromBooleanToNumber(value);
         this.whereQuery((query) => {
             for (const index in columns) {
                 const column = columns[index];
@@ -1383,8 +1417,6 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
      */
     whereAll(columns, operator, value) {
         [value, operator] = this.$utils.valueAndOperator(value, operator, arguments.length === 2);
-        value = this.$utils.escape(value);
-        value = this.$utils.transfromBooleanToNumber(value);
         this.whereQuery((query) => {
             for (const column of columns)
                 query.where(column, operator, value);
@@ -1412,7 +1444,6 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
             return `${this.$constants("WHEN")} ${when} ${this.$constants("THEN")} ${then}`;
         });
         const whereClause = [
-            this.$state.get("WHERE").length ? this.$constants("AND") : "",
             "(",
             this.$constants("CASE"),
             ...query,
@@ -1422,7 +1453,7 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
         ]
             .filter(Boolean)
             .join(" ");
-        this.$state.set("WHERE", [...this.$state.get("WHERE"), whereClause]);
+        this.whereRaw(whereClause);
         return this;
     }
     /**
@@ -1445,7 +1476,6 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
             return `${this.$constants("WHEN")} ${when} ${this.$constants("THEN")} ${then}`;
         });
         const whereClause = [
-            this.$state.get("WHERE").length ? this.$constants("OR") : "",
             "(",
             this.$constants("CASE"),
             ...query,
@@ -1455,17 +1485,11 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
         ]
             .filter(Boolean)
             .join(" ");
-        this.$state.set("WHERE", [...this.$state.get("WHERE"), whereClause]);
+        this.orWhereRaw(whereClause);
         return this;
     }
     whereReference(tableAndLocalKey, tableAndForeignKey) {
-        this.$state.set("WHERE", [
-            ...this.$state.get("WHERE"),
-            [
-                this.$state.get("WHERE").length ? `${this.$constants("AND")}` : "",
-                `${tableAndLocalKey} = ${tableAndForeignKey}`,
-            ].join(" "),
-        ]);
+        this.whereRaw(`${tableAndLocalKey} = ${tableAndForeignKey}`);
         return this;
     }
     /**
@@ -1613,10 +1637,6 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
             ...this.$state.get("ORDER_BY"),
             `${orderBy} ${order.toUpperCase()}`,
         ]);
-        this.$state.set("ORDER_BY", [
-            ...this.$state.get("ORDER_BY"),
-            `\`${column}\` ${order.toUpperCase()}`,
-        ]);
         return this;
     }
     /**
@@ -2143,8 +2163,7 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
      * @returns {this} this this
      */
     insertNotExists(data) {
-        this.createNotExists(data);
-        return this;
+        return this.createNotExists(data);
     }
     /**
      * The 'createOrSelect' method to insert data into a database table while select any duplicate key constraint violations.
@@ -2168,8 +2187,7 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
      * @returns {this} this this
      */
     insertOrSelect(data) {
-        this.createOrSelect(data);
-        return this;
+        return this.createOrSelect(data);
     }
     /**
      * The 'updateOrCreate' method allows you to update an existing record in a database table if it exists or create a new record if it does not exist.
@@ -2195,8 +2213,7 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
      * @returns {this} this this
      */
     updateOrInsert(data) {
-        this.updateOrCreate(data);
-        return this;
+        return this.updateOrCreate(data);
     }
     /**
      * The 'insertOrUpdate' method allows you to update an existing record in a database table if it exists or create a new record if it does not exist.
@@ -2207,8 +2224,7 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
      * @returns {this} this this
      */
     insertOrUpdate(data) {
-        this.updateOrCreate(data);
-        return this;
+        return this.updateOrCreate(data);
     }
     /**
      *
@@ -2220,8 +2236,7 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
      * @returns {this} this this
      */
     createOrUpdate(data) {
-        this.updateOrCreate(data);
-        return this;
+        return this.updateOrCreate(data);
     }
     /**
      * The 'toString' method is used to retrieve the raw SQL query that would be executed by a query builder instance without actually executing it.
@@ -2364,11 +2379,11 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
      *
      */
     async getFKs(table) {
-        const sql = this._queryBuilder().getFKs({
+        const fks = await this.rawQuery(this._queryBuilder().getFKs({
             database: this.$database,
             table: table ?? String(this.$state.get("TABLE_NAME")),
-        });
-        return await this.rawQuery(sql);
+        }));
+        return fks;
     }
     /**
      * The `hasFK` method is used to determine whether a specific foreign key
@@ -2381,12 +2396,11 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
      *
      */
     async hasFK({ constraint, table }) {
-        const sql = this._queryBuilder().hasFK({
+        const result = await this.rawQuery(this._queryBuilder().hasFK({
             database: this.$database,
             table: table ?? String(this.$state.get("TABLE_NAME")),
             constraint
-        });
-        const result = await this.rawQuery(sql);
+        }));
         return Boolean(result[0]?.IS_EXISTS ?? false);
     }
     /**
@@ -2405,11 +2419,49 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
      *
      */
     async getChildFKs(table) {
-        const sql = this._queryBuilder().getChildFKs({
+        const childFks = await this.rawQuery(this._queryBuilder().getChildFKs({
             database: this.$database,
             table: table ?? String(this.$state.get("TABLE_NAME")),
-        });
-        return await this.rawQuery(sql);
+        }));
+        return childFks;
+    }
+    /**
+     * Adds a foreign key constraint to a table.
+     *
+     * This method checks whether the specified foreign key constraint already exists
+     * on the table before attempting to create it. If the constraint exists, an error
+     * will be thrown to prevent duplication.
+     *
+     * @async
+     * @method addFK
+     * @param {Object} params - Parameters for creating the foreign key.
+     * @param {string} params.table - The name of the table where the foreign key will be added.
+     * @param {string} params.tableRef - The referenced table name.
+     * @param {string} params.key - The column in the current table that will act as the foreign key.
+     * @param {string} params.constraint - The name of the foreign key constraint.
+     * @param {Object} params.foreign - Foreign key configuration.
+     * @param {string} params.foreign.references - The referenced column in the referenced table.
+     * @param {string} params.foreign.onDelete - Action when a referenced row is deleted (e.g. CASCADE, SET NULL).
+     * @param {string} params.foreign.onUpdate - Action when a referenced row is updated (e.g. CASCADE, RESTRICT).
+     *
+     * @throws {Error} If the specified foreign key constraint already exists.
+     *
+     * @returns {Promise<void>} Resolves when the foreign key constraint is successfully created.
+     */
+    async addFK({ table, tableRef, key, constraint, foreign }) {
+        const exists = await this.hasFK({ constraint, table });
+        if (exists) {
+            throw new Error('The specified foreign key constraint already exists.');
+        }
+        await this.rawQuery(this._queryBuilder()
+            .addFK({
+            table: table ?? this.getTableName(),
+            tableRef,
+            key,
+            constraint,
+            foreign
+        }));
+        return;
     }
     /**
      * The `dropFK` method is used to remove a foreign key constraint from the database.
@@ -2422,11 +2474,15 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
      * @returns {Promise<void>}
      */
     async dropFK({ constraint, table }) {
-        const sql = this._queryBuilder().dropFK({
-            table: table ?? String(this.$state.get("TABLE_NAME")),
+        const exists = await this.hasFK({ constraint, table });
+        if (!exists) {
+            throw new Error('The specified foreign key constraint was not found.');
+        }
+        await this.rawQuery(this._queryBuilder()
+            .dropFK({
+            table: table ?? this.getTableName(),
             constraint
-        });
-        await this.rawQuery(sql);
+        }));
         return;
     }
     /**
@@ -2445,11 +2501,11 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
      *
      */
     async getIndexes(table) {
-        const sql = this._queryBuilder().getIndexes({
+        const indexes = await this.rawQuery(this._queryBuilder().getIndexes({
             database: this.$database,
-            table: table ?? String(this.$state.get("TABLE_NAME")),
-        });
-        return await this.rawQuery(sql);
+            table: table ?? this.getTableName()
+        }));
+        return indexes;
     }
     /**
      * The `hasIndex` method is used to determine whether a specific index exists
@@ -2461,15 +2517,226 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
      * @returns {Promise<boolean>}
      *
      */
-    async hasIndex({ index, table }) {
-        const sql = this._queryBuilder().hasIndex({
+    async hasIndex({ name, table }) {
+        const result = await this.rawQuery(this._queryBuilder().hasIndex({
             database: this.$database,
-            table: table ?? String(this.$state.get("TABLE_NAME")),
-            index
-        });
-        const result = await this.rawQuery(sql);
+            table: table ?? this.getTableName(),
+            name
+        }));
         return Boolean(result[0]?.IS_EXISTS ?? false);
     }
+    /**
+     * Adds an index to a table.
+     *
+     * This method checks whether the specified index already exists on the table
+     * before attempting to create it. If the index exists, an error will be thrown
+     * to prevent duplication.
+     *
+     * @async
+     * @method addIndex
+     * @param {Object} params - Parameters for creating the index.
+     * @param {string} params.name - The name of the index.
+     * @param {string} [params.table] - The table where the index will be created. Defaults to the current model table.
+     * @param {string[]} params.columns - The columns included in the index.
+     *
+     * @throws {Error} If the specified index already exists.
+     *
+     * @returns {Promise<void>} Resolves when the index has been successfully created.
+     */
+    async addIndex({ name, table, columns }) {
+        const exists = await this.hasIndex({ name, table });
+        if (exists) {
+            throw new Error('The specified index already exists.');
+        }
+        await this.rawQuery(this._queryBuilder().addIndex({
+            table: table ?? this.getTableName(),
+            name,
+            columns
+        }));
+        return;
+    }
+    /**
+     * Drops an index from a table.
+     *
+     * This method checks whether the specified index exists on the table
+     * before attempting to drop it. If the index does not exist, an error
+     * will be thrown.
+     *
+     * @async
+     * @method dropIndex
+     * @param {Object} params - Parameters for dropping the index.
+     * @param {string} params.name - The name of the index to drop.
+     * @param {string} [params.table] - The table from which the index will be removed. Defaults to the current model table.
+     *
+     * @throws {Error} If the specified index was not found.
+     *
+     * @returns {Promise<void>} Resolves when the index has been successfully dropped.
+     */
+    async dropIndex({ name, table }) {
+        const exists = await this.hasIndex({ name, table });
+        if (!exists) {
+            throw new Error('The specified index was not found');
+        }
+        await this.rawQuery(this._queryBuilder().dropIndex({
+            table: table ?? this.getTableName(),
+            name,
+        }));
+        return;
+    }
+    /**
+     * Checks whether a unique constraint exists on a table.
+     *
+     * This method queries the database metadata to determine if the specified
+     * unique constraint exists on the given table.
+     *
+     * @async
+     * @method hasUnique
+     * @param {Object} params - Parameters for checking the unique constraint.
+     * @param {string} params.name - The name of the unique constraint.
+     * @param {string} [params.table] - The table to check. Defaults to the current model table.
+     *
+     * @returns {Promise<boolean>} Returns `true` if the unique constraint exists, otherwise `false`.
+     */
+    async hasUnique({ name, table }) {
+        const result = await this.rawQuery(this._queryBuilder().hasUnique({
+            database: this.$database,
+            table: table ?? this.getTableName(),
+            name
+        }));
+        return Boolean(result[0]?.IS_EXISTS ?? false);
+    }
+    /**
+     * Adds a unique constraint to a table.
+     *
+     * This method checks whether the specified unique constraint already exists
+     * on the table before attempting to create it. If the constraint already exists,
+     * an error will be thrown to prevent duplication.
+     *
+     * @async
+     * @method addUnique
+     * @param {Object} params - Parameters for creating the unique constraint.
+     * @param {string} params.name - The name of the unique constraint.
+     * @param {string} [params.table] - The table where the unique constraint will be added. Defaults to the current model table.
+     * @param {string[]} params.columns - The columns that will be included in the unique constraint.
+     *
+     * @throws {Error} If the specified unique constraint already exists.
+     *
+     * @returns {Promise<void>} Resolves when the unique constraint has been successfully created.
+     */
+    async addUnique({ name, table, columns }) {
+        const exists = await this.hasUnique({ name, table });
+        if (exists) {
+            throw new Error('The specified unique constraint already exists.');
+        }
+        await this.rawQuery(this._queryBuilder().addUnique({
+            table: table ?? this.getTableName(),
+            name,
+            columns
+        }));
+        return;
+    }
+    /**
+     * Drops a unique constraint from a table.
+     *
+     * This method checks whether the specified unique constraint exists
+     * on the table before attempting to remove it. If the constraint does
+     * not exist, an error will be thrown.
+     *
+     * @async
+     * @method dropUnique
+     * @param {Object} params - Parameters for dropping the unique constraint.
+     * @param {string} params.name - The name of the unique constraint to drop.
+     * @param {string} [params.table] - The table from which the unique constraint will be removed. Defaults to the current model table.
+     *
+     * @throws {Error} If the specified unique constraint was not found.
+     *
+     * @returns {Promise<void>} Resolves when the unique constraint has been successfully dropped.
+     */
+    async dropUnique({ name, table }) {
+        const exists = await this.hasUnique({ name, table });
+        if (!exists) {
+            throw new Error('The specified unique constraint was not found.');
+        }
+        await this.rawQuery(this._queryBuilder().dropUnique({
+            table: table ?? this.getTableName(),
+            name,
+        }));
+        return;
+    }
+    /**
+     * Checks whether a primary key constraint exists on a table.
+     *
+     * This method queries the database metadata to determine if the specified
+     * table contains a primary key constraint.
+     *
+     * @async
+     * @method hasPrimaryKey
+     * @param {Object} [params={}] - Parameters for checking the primary key.
+     * @param {string} [params.table] - The table to check. Defaults to the current model table.
+     *
+     * @returns {Promise<boolean>} Returns `true` if the table has a primary key constraint,
+     * otherwise `false`.
+     */
+    async hasPrimaryKey({ table } = {}) {
+        const result = await this.rawQuery(this._queryBuilder().hasPrimaryKey({
+            database: this.$database,
+            table: table ?? this.getTableName()
+        }));
+        return Boolean(result[0]?.IS_EXISTS ?? false);
+    }
+    /**
+     * Adds a primary key constraint to a table.
+     *
+     * This method checks whether the table already has a primary key
+     * before attempting to create one. If a primary key already exists,
+     * an error will be thrown.
+     *
+     * @async
+     * @method addPrimaryKey
+     * @param {Object} params - Parameters for creating the primary key.
+     * @param {string} [params.table] - The table where the primary key will be added. Defaults to the current model table.
+     * @param {string[]} params.columns - The column(s) that will form the primary key.
+     *
+     * @throws {Error} If the table already has a primary key constraint.
+     *
+     * @returns {Promise<void>} Resolves when the primary key has been successfully created.
+     */
+    async addPrimaryKey({ table, columns }) {
+        const exists = await this.hasPrimaryKey({ table });
+        if (exists) {
+            throw new Error('The specified primary constraint already exists.');
+        }
+        await this.rawQuery(this._queryBuilder().addPrimaryKey({
+            table: table ?? String(this.getTableName()),
+            columns
+        }));
+        return;
+    }
+    /**
+     * Drops the primary key constraint from a table.
+     *
+     * This method checks whether the table has a primary key before
+     * attempting to remove it. If no primary key exists, an error will be thrown.
+     *
+     * @async
+     * @method dropPrimaryKey
+     * @param {Object} [params={}] - Parameters for dropping the primary key.
+     * @param {string} [params.table] - The table from which the primary key will be removed. Defaults to the current model table.
+     *
+     * @throws {Error} If the specified primary key constraint was not found.
+     *
+     * @returns {Promise<void>} Resolves when the primary key constraint has been successfully removed.
+     */
+    async dropPrimaryKey({ table } = {}) {
+        const exists = await this.hasPrimaryKey({ table });
+        if (!exists) {
+            throw new Error('The specified primary constraint was not found.');
+        }
+        await this.rawQuery(this._queryBuilder().dropPrimaryKey({
+            table: table ?? String(this.getTableName())
+        }));
+        return;
+    }
     /**
      * The 'bindColumn' method is used to concat table and column -> `users`.`id`
      * @param {string} column
@@ -2683,11 +2950,11 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
      * The 'find' method is used to retrieve a single record from a database table by its primary key.
      *
      * This method allows you to quickly fetch a specific record by specifying the primary key value, which is typically an integer id.
-     * @param {number} id
+     * @param {number | string} primaryKey
      * @returns {promise<any>}
      */
-    async find(id) {
-        this.where("id", id);
+    async find(primaryKey) {
+        this.where("id", primaryKey);
         return await this.first();
     }
     /**
@@ -2695,17 +2962,21 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
      *
      * It allows you to split a large set of query results into smaller, more manageable pages,
      * making it easier to display data in a web application and improve user experience
-     * @param {?object} paginationOptions
-     * @param {number} paginationOptions.limit default 15
-     * @param {number} paginationOptions.page default 1
+     * @param    {object?}  opts by default page = 1 , limit = 15
+     * @property {number?}  opts.limit
+     * @property {number?}  opts.page
+     * @property {boolean?} opts.distinct
      * @returns {promise<Pagination>}
      */
-    async pagination(paginationOptions) {
+    async pagination(opts) {
         let limit = 15;
         let page = 1;
-        if (paginationOptions != null) {
-            limit = paginationOptions?.limit || limit;
-            page = paginationOptions?.page || page;
+        if (opts?.distinct) {
+            this.distinct();
+        }
+        if (opts != null) {
+            limit = opts?.limit || limit;
+            page = opts?.page || page;
         }
         const currentPage = page;
         const nextPage = currentPage + 1;
@@ -2717,7 +2988,6 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
         const result = await this._queryStatement(sql);
         if (!result.length)
             return {
-                //@ts-ignore
                 meta: {
                     total: 0,
                     limit,
@@ -2726,6 +2996,12 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
                     last_page: 0,
                     next_page: 0,
                     prev_page: 0,
+                    page: {
+                        prev: 0,
+                        next: 0,
+                        current: currentPage,
+                        last: 0,
+                    },
                 },
                 data: [],
             };
@@ -2733,13 +3009,11 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
             .copyBuilder(this, { where: true, join: true })
             .bind(this.$pool.get())
             .debug(this.$state.get("DEBUG"))
-            .unset({ alias: true })
             .count();
         let lastPage = Math.ceil(total / limit) || 0;
         lastPage = lastPage > 1 ? lastPage : 1;
         const count = result?.length ?? 0;
         return {
-            //@ts-ignore
             meta: {
                 total: total,
                 limit: limit,
@@ -2748,6 +3022,12 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
                 last_page: lastPage,
                 next_page: nextPage,
                 prev_page: prevPage,
+                page: {
+                    prev: prevPage,
+                    next: nextPage,
+                    current: currentPage,
+                    last: lastPage,
+                },
             },
             data: result ?? [],
         };
@@ -2757,19 +3037,14 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
      *
      * It allows you to split a large set of query results into smaller, more manageable pages,
      * making it easier to display data in a web application and improve user experience
-     * @param {?object} paginationOptions
-     * @param {number} paginationOptions.limit
-     * @param {number} paginationOptions.page
+     * @param    {object?}  opts by default page = 1 , limit = 15
+     * @property {number?}  opts.limit
+     * @property {number?}  opts.page
+     * @property {boolean?} opts.distinct
      * @returns {promise<Pagination>}
      */
-    async paginate(paginationOptions) {
-        let limit = 15;
-        let page = 1;
-        if (paginationOptions != null) {
-            limit = paginationOptions?.limit || limit;
-            page = paginationOptions?.page || page;
-        }
-        return await this.pagination({ limit, page });
+    async paginate(opts) {
+        return await this.pagination(opts);
     }
     /**
      *
@@ -2942,7 +3217,7 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
                 : distinct
                     ? `${this.$constants("DISTINCT")} ${this.bindColumn(column)}`
                     : `${this.bindColumn(column)}`;
-        this.selectRaw(`${this.$constants("COUNT")}(${column}) ${this.$constants("AS")} \`aggregate\``);
+        this.selectRaw(`${this.$constants("COUNT")}(${column}) ${this.$constants(`${this.$constants("AS")}`)} \`aggregate\``);
         const sql = this._queryBuilder().select();
         const result = await this._queryStatement(sql);
         return Number(this._resultHandler(result.reduce((prev, cur) => prev + Number(cur?.aggregate ?? 0), 0) || 0));
@@ -3264,6 +3539,18 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
             .map((table) => String(Object.values(table)[0]))
             .filter((d) => d != null || d !== "");
     }
+    /**
+     * The `getTable` method is used to retrieve a list of all table names
+     * in the current database.
+     *
+     * @returns {Promise<string[]>} A promise that resolves to an array of table names.
+     *
+     * @async
+     */
+    async hasTable(table) {
+        const result = await this._queryStatement(this._queryBuilder().hasTable({ database: this.database(), table }));
+        return Boolean(result[0]?.IS_EXISTS ?? false);
+    }
     /**
      *
      * The 'showColumns' method is used to show columns table.
@@ -3388,10 +3675,7 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
             ].join('\n'));
             return false;
         }
-        const sql = [
-            `${this.$constants("TRUNCATE_TABLE")}`,
-            `${table}`,
-        ].join(" ");
+        const sql = this._queryBuilder().truncate(this.getTableName());
         if (!force) {
             console.log([
                 `\x1b[33m`,
@@ -3402,7 +3686,7 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
             ].join('\n'));
             return false;
         }
-        const childFKs = await this.getChildFKs();
+        const childFKs = await this.getChildFKs().catch(() => []);
         if (childFKs.length && !dropFK) {
             console.log([
                 `\x1b[33m`,
@@ -3553,7 +3837,6 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
         return data;
     }
     async _queryStatement(sql) {
-        sql = this._queryBuilder().format([sql]);
         try {
             const startTime = +new Date();
             const result = await this.$pool.query(sql);
@@ -3609,7 +3892,8 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
                 await this.$utils.wait(this.$state.get("AFTER_SAVE"));
                 const data = await new Builder()
                     .copyBuilder(this, { select: true })
-                    .whereIn("id", result.$meta.insertIds)
+                    .whereIn(this.$state.get('PRIMARY_KEY'), result.$meta.insertIds)
+                    .debug(this.$state.get('DEBUG'))
                     .bind(this.$pool.get())
                     .first();
                 return this._resultHandler(data);
@@ -3625,7 +3909,8 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
         await this.$utils.wait(this.$state.get("AFTER_SAVE"));
         const results = await new Builder()
             .copyBuilder(this, { select: true })
-            .whereIn("id", result.$meta.insertIds)
+            .whereIn(this.$state.get('PRIMARY_KEY'), result.$meta.insertIds)
+            .debug(this.$state.get('DEBUG'))
             .bind(this.$pool.get())
             .first();
         return this._resultHandler(results);
@@ -3637,7 +3922,8 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
         await this.$utils.wait(this.$state.get("AFTER_SAVE"));
         const resultData = await new Builder()
             .copyBuilder(this, { select: true, limit: true })
-            .whereIn("id", result.$meta.insertIds)
+            .whereIn(this.$state.get('PRIMARY_KEY'), result.$meta.insertIds)
+            .debug(this.$state.get('DEBUG'))
             .bind(this.$pool.get())
             .get();
         return this._resultHandler(resultData);
@@ -3663,7 +3949,8 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
                 await this.$utils.wait(this.$state.get("AFTER_SAVE"));
                 const data = await new Builder()
                     .copyBuilder(this, { select: true })
-                    .whereIn("id", result.$meta.insertIds)
+                    .whereIn(this.$state.get('PRIMARY_KEY'), result.$meta.insertIds)
+                    .debug(this.$state.get('DEBUG'))
                     .bind(this.$pool.get())
                     .first();
                 const resultData = data == null ? null : { ...data, $action: "insert" };
@@ -3709,7 +3996,8 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
                 await this.$utils.wait(this.$state.get("AFTER_SAVE"));
                 const data = await new Builder()
                     .copyBuilder(this, { select: true })
-                    .whereIn("id", result.$meta.insertIds)
+                    .whereIn(this.$state.get('PRIMARY_KEY'), result.$meta.insertIds)
+                    .debug(this.$state.get('DEBUG'))
                     .bind(this.$pool.get())
                     .first();
                 const resultData = data == null ? null : { ...data, $action: "insert" };
@@ -3865,7 +4153,7 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
                         const isReaded = [
                             this.$constants("SELECT"),
                             this.$constants("SHOW"),
-                            this.$constants("DESCRIBE"),
+                            this.$constants("DESCRIBE")
                         ].includes(first) &&
                             (!sql
                                 .toUpperCase()
@@ -3903,10 +4191,16 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
                             ? poolCluster?.queryBuilder
                             : poolCluster?.masters[0]?.queryBuilder;
                     },
+                    transaction: async () => {
+                        return await poolCluster.masters[0].connection();
+                    },
                 };
             }
             let pool = Pool_1.Pool.connect();
             return {
+                transaction: async () => {
+                    return await pool.connection();
+                },
                 query: async (sql) => {
                     return pool.query(sql);
                 },
@@ -3922,13 +4216,14 @@ class Builder extends AbstractBuilder_1.AbstractBuilder {
             };
         })();
         this.$state = new StateManager_1.StateManager("default");
-        this.$constants = (name) => {
+        this.$constants = ((name) => {
             if (name == null)
                 return constants_1.CONSTANTS;
-            if (!constants_1.CONSTANTS.hasOwnProperty(name))
-                throw new Error(`Not found that constant : '${name}'`);
+            if (!Object.prototype.hasOwnProperty.call(constants_1.CONSTANTS, name)) {
+                throw new Error(`Not found that constant : '${String(name)}'`);
+            }
             return constants_1.CONSTANTS[name];
-        };
+        });
     }
 }
 exports.Builder = Builder;