@ignisia/sql 0.2.2 → 0.4.0

package/dist/esm/query/index.js

@@ -1,9 +1,9 @@
 import { quoteIdentifier } from '../utilities.js';
-import { rawWhere, rawHaving, rawOr, where, having, or } from './condition.js';
+import { rawWhere, rawHaving, rawOr, where, having, or, on, whereGroup, orGroup, orNotGroup, whereNotGroup, orNot, havingNot, whereNot } from './condition/index.js';
 import { AcceptedJoin, QueryType } from './constants.js';
 import { alias, clone, aggregateCol, col } from './helper.js';
-import { addJoin } from './join.js';
-import { toQuery, toString, exec } from './sql.js';
+import { prepareJoin, addNoOnJoin } from './join.js';
+import { toQuery, toString, toDebugString, explain, exec } from './sql.js';
 import { getTimestamp, getParanoid } from './utilities.js';
 
 // src/query/index.ts
@@ -16,6 +16,8 @@ var QueryBuilder = class {
   clone;
   toQuery;
   toString;
+  toDebugString;
+  explain;
   exec;
   rawWhere;
   rawAnd;
@@ -24,33 +26,23 @@ var QueryBuilder = class {
   where;
   and;
   or;
+  on;
   having;
+  whereGroup;
+  orGroup;
+  not;
   constructor(table) {
     this.hooks = {};
     this.table = table;
     this.definition = {
-      queryType: null,
-      select: null,
-      having: null,
-      where: null,
-      params: null,
-      limit: null,
-      offset: null,
-      groupBy: null,
-      insertValues: null,
-      updateValues: null,
-      orderBy: null,
-      aggregates: null,
-      joins: null,
-      distinct: null,
-      baseAlias: table.name,
-      joinedTables: null,
-      withDeleted: null
+      baseAlias: table.name
     };
     this.alias = alias.bind(this);
     this.clone = clone.bind(this);
     this.toQuery = toQuery.bind(this);
     this.toString = toString.bind(this);
+    this.toDebugString = toDebugString.bind(this);
+    this.explain = explain.bind(this);
     this.exec = exec.bind(this);
     this.rawWhere = rawWhere.bind(this);
     this.rawHaving = rawHaving.bind(this);
@@ -60,46 +52,36 @@ var QueryBuilder = class {
     this.having = having.bind(this);
     this.and = this.where;
     this.or = or.bind(this);
+    this.on = on.bind(this);
+    this.whereGroup = whereGroup.bind(this);
+    this.orGroup = orGroup.bind(this);
+    this.not = {
+      where: whereNot.bind(this),
+      having: havingNot.bind(this),
+      or: orNot.bind(this),
+      whereGroup: whereNotGroup.bind(
+        this
+      ),
+      orGroup: orNotGroup.bind(this)
+    };
   }
-  leftJoin(joinTable, alias2, baseColumn, joinColumn) {
-    return addJoin(
-      this,
-      AcceptedJoin.LEFT,
-      alias2,
-      joinTable,
-      baseColumn,
-      joinColumn
-    );
+  leftJoin(joinTable, alias2) {
+    return prepareJoin(this, AcceptedJoin.LEFT, joinTable, alias2);
   }
-  rightJoin(joinTable, alias2, baseColumn, joinColumn) {
-    return addJoin(
-      this,
-      AcceptedJoin.RIGHT,
-      alias2,
-      joinTable,
-      baseColumn,
-      joinColumn
-    );
+  rightJoin(joinTable, alias2) {
+    return prepareJoin(this, AcceptedJoin.RIGHT, joinTable, alias2);
   }
-  innerJoin(joinTable, alias2, baseColumn, joinColumn) {
-    return addJoin(
-      this,
-      AcceptedJoin.INNER,
-      alias2,
-      joinTable,
-      baseColumn,
-      joinColumn
-    );
+  innerJoin(joinTable, alias2) {
+    return prepareJoin(this, AcceptedJoin.INNER, joinTable, alias2);
   }
-  naturalJoin(joinTable, alias2, baseColumn, joinColumn) {
-    return addJoin(
-      this,
-      AcceptedJoin.NATURAL,
-      alias2,
-      joinTable,
-      baseColumn,
-      joinColumn
-    );
+  fullJoin(joinTable, alias2) {
+    return prepareJoin(this, AcceptedJoin.FULL, joinTable, alias2);
+  }
+  crossJoin(joinTable, alias2) {
+    return addNoOnJoin(this, AcceptedJoin.CROSS, joinTable, alias2);
+  }
+  naturalJoin(joinTable, alias2) {
+    return prepareJoin(this, AcceptedJoin.NATURAL, joinTable, alias2);
   }
   distinct() {
     this.definition.distinct = true;
@@ -153,22 +135,33 @@ var QueryBuilder = class {
   insert(...values) {
     this.definition.queryType = QueryType.INSERT;
     if (!this.definition.insertValues) this.definition.insertValues = [];
-    const { isWithTimestamp, createdAt, updatedAt, timestamp } = getTimestamp(
-      this.table
-    );
-    if (isWithTimestamp) {
-      values = values.map((row) => ({
-        ...row,
-        [createdAt]: row[createdAt] ?? timestamp,
-        [updatedAt]: row[updatedAt] ?? timestamp
-      }));
-    }
+    const {
+      isWithTimestamp,
+      isHasCreatedAt,
+      isHasUpdatedAt,
+      createdAt,
+      updatedAt,
+      timestamp
+    } = getTimestamp(this.table);
+    values = values.map((row) => {
+      const fields = {};
+      for (const key in this.table.columns) {
+        fields[key] = row[key] ?? null;
+      }
+      if (isWithTimestamp && isHasCreatedAt) {
+        fields[createdAt] = row[createdAt] ?? timestamp;
+      }
+      if (isWithTimestamp && isHasUpdatedAt) {
+        fields[updatedAt] = row[updatedAt] ?? timestamp;
+      }
+      return fields;
+    });
     this.definition.insertValues = values;
     return this;
   }
   update(values) {
-    const { isWithTimestamp, updatedAt, timestamp } = getTimestamp(this.table);
-    if (isWithTimestamp) {
+    const { isWithTimestamp, isHasUpdatedAt, updatedAt, timestamp } = getTimestamp(this.table);
+    if (isWithTimestamp && isHasUpdatedAt) {
       values = {
         ...values,
         [updatedAt]: values[updatedAt] ?? timestamp
@@ -188,6 +181,17 @@ var QueryBuilder = class {
     this.definition.queryType = QueryType.DELETE;
     return this;
   }
+  paginate(page, size) {
+    if (page < 1) {
+      throw new Error("Page number must be at least 1");
+    }
+    if (size < 1) {
+      throw new Error("Page size must be at least 1");
+    }
+    this.definition.limit = size;
+    this.definition.offset = (page - 1) * size;
+    return this;
+  }
   infer() {
     return null;
   }

package/dist/esm/query/join.d.ts

@@ -1,16 +1,29 @@
-import { T as Table, Q as QueryDefinition, C as ColumnSelector, c as StrictColumnSelector, d as QueryBuilder } from '../index-FMT0YEO7.js';
+import { T as Table, Q as QueryDefinition, C as ColumnSelector, k as StrictColumnSelector, l as QueryBuilder, n as QueryTransformerContract, o as QueryConditionContract } from '../index-CjurLJdK.js';
 import { Column } from '../column/index.js';
 import { AcceptedJoin } from './constants.js';
-import '../column/constants.js';
+import 'bun';
 import '../types.js';
+import '../column/constants.js';
 import '../table/constants.js';
 import '../column/types.js';
 
-declare function addJoin<Alias extends string, TableRef extends Table<string, Record<string, Column>>, JoinedTables extends Record<string, Table<string, Record<string, Column>>>, Definition extends Partial<QueryDefinition<Alias, TableRef, JoinedTables>>, AllowedColumn extends ColumnSelector<Alias, TableRef, JoinedTables>, StrictAllowedColumn extends StrictColumnSelector<Alias, TableRef, JoinedTables>, JoinType extends AcceptedJoin, JoinTable extends Table<string, Record<string, Column>>, JoinAlias extends string, BaseColName extends `${Alias}."${keyof TableRef['columns'] & string}"`, JoinColName extends `${JoinAlias}."${keyof JoinTable['columns'] & string}"`, FinalJoinedTables extends JoinedTables & {
+declare function addNoOnJoin<Alias extends string, TableRef extends Table<string, Record<string, Column>>, JoinedTables extends Record<string, Table<string, Record<string, Column>>>, Definition extends Partial<QueryDefinition<Alias, TableRef, JoinedTables>>, AllowedColumn extends ColumnSelector<Alias, TableRef, JoinedTables>, StrictAllowedColumn extends StrictColumnSelector<Alias, TableRef, JoinedTables>, JoinType extends AcceptedJoin, JoinTable extends Table<string, Record<string, Column>>, JoinAlias extends string, FinalJoinedTables extends JoinedTables & {
     [K in JoinAlias]: JoinTable;
-}>(query: QueryBuilder<Alias, TableRef, JoinedTables, Definition, AllowedColumn, StrictAllowedColumn>, joinType: JoinType, alias: JoinAlias, joinTable: JoinTable, baseColumn: BaseColName, joinColumn: JoinColName): QueryBuilder<Alias, TableRef, FinalJoinedTables, Omit<Definition, "joins" | "joinedTables"> & {
+}>(query: QueryBuilder<Alias, TableRef, JoinedTables, Definition, AllowedColumn, StrictAllowedColumn>, joinType: JoinType, joinTable: JoinTable, alias: JoinAlias): QueryBuilder<Alias, TableRef, FinalJoinedTables, Omit<Definition, "joins" | "joinedTables"> & {
     joins: string[];
     joinedTables: FinalJoinedTables;
 }>;
+declare function prepareJoin<Alias extends string, TableRef extends Table<string, Record<string, Column>>, JoinedTables extends Record<string, Table<string, Record<string, Column>>>, Definition extends Partial<QueryDefinition<Alias, TableRef, JoinedTables>>, AllowedColumn extends ColumnSelector<Alias, TableRef, JoinedTables>, StrictAllowedColumn extends StrictColumnSelector<Alias, TableRef, JoinedTables>, JoinType extends AcceptedJoin, JoinTable extends Table<string, Record<string, Column>>, JoinAlias extends string>(query: QueryBuilder<Alias, TableRef, JoinedTables, Definition, AllowedColumn, StrictAllowedColumn>, joinType: JoinType, joinTable: JoinTable, alias: JoinAlias): {
+    on<FinalJoinedTables extends JoinedTables & { [K in JoinAlias]: JoinTable; }, ReturnedJoinedTables extends FinalJoinedTables = FinalJoinedTables>(callback: (q: QueryBuilder<Alias, TableRef, FinalJoinedTables>) => QueryBuilder<Alias, TableRef, ReturnedJoinedTables>): QueryBuilder<Alias, TableRef, ReturnedJoinedTables, Omit<Definition, "joins" | "joinedTables"> & {
+        joins: string[];
+        joinedTables: ReturnedJoinedTables;
+    }, ColumnSelector<Alias, TableRef, ReturnedJoinedTables>, StrictColumnSelector<Alias, TableRef, ReturnedJoinedTables>, QueryTransformerContract<Alias, TableRef, ReturnedJoinedTables, Omit<Definition, "joins" | "joinedTables"> & {
+        joins: string[];
+        joinedTables: ReturnedJoinedTables;
+    }, ColumnSelector<Alias, TableRef, ReturnedJoinedTables>, StrictColumnSelector<Alias, TableRef, ReturnedJoinedTables>>, QueryConditionContract<Alias, TableRef, ReturnedJoinedTables, Omit<Definition, "joins" | "joinedTables"> & {
+        joins: string[];
+        joinedTables: ReturnedJoinedTables;
+    }, ColumnSelector<Alias, TableRef, ReturnedJoinedTables>, StrictColumnSelector<Alias, TableRef, ReturnedJoinedTables>>>;
+};
 
-export { addJoin };
+export { addNoOnJoin, prepareJoin };

package/dist/esm/query/join.js

@@ -1,17 +1,45 @@
+import { QueryBuilder } from './index.js';
+
 // src/query/join.ts
-function addJoin(query, joinType, alias, joinTable, baseColumn, joinColumn) {
+function addNoOnJoin(query, joinType, joinTable, alias) {
   if (!query.definition.joins) query.definition.joins = [];
-  query.definition.joins.push(
-    `${joinType} JOIN ${joinTable.name} AS ${alias} ON ${baseColumn} = ${joinColumn}`
-  );
+  query.definition.joins.push(`${joinType} JOIN ${joinTable.name} AS ${alias}`);
   if (!query.definition.joinedTables) {
     query.definition.joinedTables = {};
   }
-  query.definition.joinedTables = {
-    ...query.definition.joinedTables,
-    [alias]: joinTable
-  };
+  query.definition.joinedTables[alias] = joinTable;
   return query;
 }
+function prepareJoin(query, joinType, joinTable, alias) {
+  return {
+    on(callback) {
+      const sub = callback(new QueryBuilder(query.table));
+      const subDef = sub.definition;
+      if (!subDef.where?.length) {
+        return query;
+      }
+      const grouped = `(${subDef.where.join(" ")})`;
+      if (!query.definition.joins) query.definition.joins = [];
+      query.definition.joins.push(
+        `${joinType} JOIN ${joinTable.name} AS ${alias} ON ${grouped}`
+      );
+      if (subDef.joins?.length) {
+        query.definition.joins.push(...subDef.joins);
+      }
+      if (subDef.params?.length) {
+        if (!query.definition.params) query.definition.params = [];
+        query.definition.params.push(...subDef.params);
+      }
+      if (!query.definition.joinedTables) {
+        query.definition.joinedTables = {};
+      }
+      query.definition.joinedTables[alias] = joinTable;
+      if (subDef.joinedTables) {
+        Object.assign(query.definition.joinedTables, subDef.joinedTables);
+      }
+      return query;
+    }
+  };
+}
 
-export { addJoin };
+export { addNoOnJoin, prepareJoin };

package/dist/esm/query/sql.d.ts

@@ -1,17 +1,20 @@
-import { T as Table, Q as QueryDefinition, C as ColumnSelector, c as StrictColumnSelector, d as QueryBuilder } from '../index-FMT0YEO7.js';
+import { TransactionSQL } from 'bun';
+import { T as Table, Q as QueryDefinition, C as ColumnSelector, k as StrictColumnSelector, l as QueryBuilder, E as ExplainOptions } from '../index-CjurLJdK.js';
 import { Column } from '../column/index.js';
-import '../column/constants.js';
+import { Dialect } from '../table/constants.js';
 import '../types.js';
 import './constants.js';
-import '../table/constants.js';
+import '../column/constants.js';
 import '../column/types.js';
 
 declare function buildQuery(query: string): string;
-declare function toQuery<Alias extends string, TableRef extends Table<string, Record<string, Column>>, JoinedTables extends Record<string, Table<string, Record<string, Column>>>, Definition extends Partial<QueryDefinition<Alias, TableRef, JoinedTables>>, AllowedColumn extends ColumnSelector<Alias, TableRef, JoinedTables>, StrictAllowedColumn extends StrictColumnSelector<Alias, TableRef, JoinedTables>, Query extends QueryBuilder<Alias, TableRef, JoinedTables, Definition, AllowedColumn, StrictAllowedColumn>>(this: Query): {
+declare function toQuery<Alias extends string, TableRef extends Table<string, Record<string, Column>>, JoinedTables extends Record<string, Table<string, Record<string, Column>>>, Definition extends Partial<QueryDefinition<Alias, TableRef, JoinedTables>>, AllowedColumn extends ColumnSelector<Alias, TableRef, JoinedTables>, StrictAllowedColumn extends StrictColumnSelector<Alias, TableRef, JoinedTables>, Query extends QueryBuilder<Alias, TableRef, JoinedTables, Definition, AllowedColumn, StrictAllowedColumn>>(this: Query, dialect?: Dialect | null): {
     query: string;
     params: unknown[] | null | undefined;
 };
 declare function toString<Alias extends string, TableRef extends Table<string, Record<string, Column>>, JoinedTables extends Record<string, Table<string, Record<string, Column>>>, Definition extends Partial<QueryDefinition<Alias, TableRef, JoinedTables>>, AllowedColumn extends ColumnSelector<Alias, TableRef, JoinedTables>, StrictAllowedColumn extends StrictColumnSelector<Alias, TableRef, JoinedTables>, Query extends QueryBuilder<Alias, TableRef, JoinedTables, Definition, AllowedColumn, StrictAllowedColumn>>(this: Query): string;
-declare function exec<Alias extends string, TableRef extends Table<string, Record<string, Column>>, JoinedTables extends Record<string, Table<string, Record<string, Column>>>, Definition extends Partial<QueryDefinition<Alias, TableRef, JoinedTables>>, AllowedColumn extends ColumnSelector<Alias, TableRef, JoinedTables>, StrictAllowedColumn extends StrictColumnSelector<Alias, TableRef, JoinedTables>, Query extends QueryBuilder<Alias, TableRef, JoinedTables, Definition, AllowedColumn, StrictAllowedColumn>, Output extends Query['_output'] = Query['_output']>(this: Query): Promise<Output>;
+declare function toDebugString<Alias extends string, TableRef extends Table<string, Record<string, Column>>, JoinedTables extends Record<string, Table<string, Record<string, Column>>>, Definition extends Partial<QueryDefinition<Alias, TableRef, JoinedTables>>, AllowedColumn extends ColumnSelector<Alias, TableRef, JoinedTables>, StrictAllowedColumn extends StrictColumnSelector<Alias, TableRef, JoinedTables>, Query extends QueryBuilder<Alias, TableRef, JoinedTables, Definition, AllowedColumn, StrictAllowedColumn>>(this: Query): string;
+declare function explain<Alias extends string, TableRef extends Table<string, Record<string, Column>>, JoinedTables extends Record<string, Table<string, Record<string, Column>>>, Definition extends Partial<QueryDefinition<Alias, TableRef, JoinedTables>>, AllowedColumn extends ColumnSelector<Alias, TableRef, JoinedTables>, StrictAllowedColumn extends StrictColumnSelector<Alias, TableRef, JoinedTables>, Query extends QueryBuilder<Alias, TableRef, JoinedTables, Definition, AllowedColumn, StrictAllowedColumn>>(this: Query, options?: ExplainOptions): Promise<unknown>;
+declare function exec<Alias extends string, TableRef extends Table<string, Record<string, Column>>, JoinedTables extends Record<string, Table<string, Record<string, Column>>>, Definition extends Partial<QueryDefinition<Alias, TableRef, JoinedTables>>, AllowedColumn extends ColumnSelector<Alias, TableRef, JoinedTables>, StrictAllowedColumn extends StrictColumnSelector<Alias, TableRef, JoinedTables>, Query extends QueryBuilder<Alias, TableRef, JoinedTables, Definition, AllowedColumn, StrictAllowedColumn>, Output extends Query['_output'] = Query['_output']>(this: Query, tx?: TransactionSQL | null): Promise<Output>;
 
-export { buildQuery, exec, toQuery, toString };
+export { buildQuery, exec, explain, toDebugString, toQuery, toString };

package/dist/esm/query/sql.js

@@ -1,6 +1,8 @@
+import { Dialect } from '../table/constants.js';
 import { buildDeleteQuery, buildUpdateQuery, buildInsertQuery, buildSelectQuery } from './builder.js';
 import { QueryType, QueryHooksType } from './constants.js';
-import { getWhereConditions, getGroupByConditions, parseAliasedRow } from './utilities.js';
+import { buildExplainQuery } from './explain.js';
+import { getWhereConditions, getGroupByConditions, sanitizeParams, parseAliasedRow } from './utilities.js';
 
 // src/query/sql.ts
 function buildQuery(query) {
@@ -10,80 +12,135 @@ function buildQuery(query) {
     return `$${index}`;
   });
 }
-function toQuery() {
-  let sql = "";
+function toQuery(dialect) {
+  const parts = [];
   switch (this.definition.queryType) {
     case QueryType.SELECT:
-      sql = buildSelectQuery(this);
+      parts.push(buildSelectQuery(this));
       break;
     case QueryType.INSERT:
-      sql = buildInsertQuery(this);
+      parts.push(buildInsertQuery(this));
       break;
     case QueryType.UPDATE:
-      sql = buildUpdateQuery(this);
+      parts.push(buildUpdateQuery(this));
       break;
     case QueryType.DELETE:
-      sql = buildDeleteQuery(this);
+      parts.push(buildDeleteQuery(this));
       break;
     default:
       throw new Error("No query type defined");
   }
   if (this.definition?.joins?.length) {
-    sql += ` ${this.definition.joins.join(" ")}`;
+    parts.push(this.definition.joins.join(" "));
   }
   const whereConditions = getWhereConditions(this);
   if (whereConditions.length) {
-    sql += ` WHERE ${whereConditions.join(" ")}`;
+    parts.push(`WHERE ${whereConditions.join(" ")}`);
   }
   const groupByConditions = getGroupByConditions(this);
   if (groupByConditions.length) {
-    sql += ` GROUP BY ${groupByConditions.join(", ")}`;
+    parts.push(`GROUP BY ${groupByConditions.join(", ")}`);
   }
   if (this.definition?.having?.length) {
-    sql += ` HAVING ${this.definition.having.join(" ")}`;
+    parts.push(`HAVING ${this.definition.having.join(" ")}`);
   }
   if (this.definition?.orderBy?.length) {
-    sql += ` ORDER BY ${this.definition.orderBy.map((order) => [order.column, order.direction].join(" ")).join(", ")}`;
+    parts.push(
+      `ORDER BY ${this.definition.orderBy.map((order) => `${order.column} ${order.direction}`).join(", ")}`
+    );
   }
   if (this.definition?.limit !== null) {
-    sql += ` LIMIT ?`;
+    parts.push("LIMIT ?");
     if (!this.definition.params) this.definition.params = [];
     this.definition.params.push(this.definition.limit);
   }
   if (this.definition?.offset !== null) {
-    sql += ` OFFSET ?`;
+    parts.push("OFFSET ?");
     if (!this.definition.params) this.definition.params = [];
     this.definition.params.push(this.definition.offset);
   }
   if (this.definition.queryType === QueryType.UPDATE || this.definition.queryType === QueryType.DELETE) {
-    sql += ` RETURNING *`;
+    if (dialect !== Dialect.MYSQL) {
+      parts.push("RETURNING *");
+    }
   }
-  sql = buildQuery(sql);
-  return { query: sql + ";", params: this.definition.params };
+  const sql = buildQuery(parts.join(" "));
+  return { query: `${sql};`, params: this.definition.params };
 }
 function toString() {
   return this.toQuery().query;
 }
-async function exec() {
-  if (!this.table.client) throw new Error("Database client not defined");
+function toDebugString() {
+  const { query, params } = this.toQuery();
+  if (!params || params.length === 0) {
+    return query;
+  }
+  let debugQuery = query;
+  sanitizeParams(params).forEach((param, index) => {
+    const value = param === null ? "NULL" : `'${String(param).replace(/'/g, "''")}'`;
+    debugQuery = debugQuery.replace(
+      new RegExp(`\\$${index + 1}\\b`, "g"),
+      value
+    );
+  });
+  return debugQuery;
+}
+function explain(options = {}) {
   const { query, params } = this.toQuery();
+  const explainPrefix = buildExplainQuery(this, options);
+  if (!this.table.client) {
+    throw new Error("Database client not defined");
+  }
+  return this.table.client.exec({
+    sql: `${explainPrefix}${query}`,
+    params
+  });
+}
+async function exec(tx) {
+  const client = this.table.client;
+  const dialect = this.table.dialect;
+  const queryType = this.definition.queryType;
+  const isUpdate = queryType === QueryType.UPDATE;
+  const isDelete = queryType === QueryType.DELETE;
+  const isReturning = isUpdate || isDelete;
+  const isMySQL = dialect === Dialect.MYSQL;
+  if (!client) {
+    throw new Error("Database client not defined");
+  }
+  if (!queryType) {
+    throw new Error("No query type defined");
+  }
+  const { query, params } = this.toQuery(dialect);
   if (this.hooks?.before?.size) {
     for (const hook of this.hooks.before.values()) {
       hook({
         query,
         params,
-        type: this.definition.queryType,
+        type: queryType,
         hook: QueryHooksType.BEFORE
       });
     }
   }
-  const result = await this.table.client.exec(query, params);
+  let result = await client.exec({
+    sql: query,
+    params,
+    tx
+  });
+  if (isMySQL && isReturning) {
+    const query2 = this.clone();
+    query2.definition.queryType = QueryType.SELECT;
+    result = await client.exec({
+      sql: query2.toQuery().query,
+      params,
+      tx
+    });
+  }
   if (this.hooks?.after?.size) {
     for (const hook of this.hooks.after.values()) {
       hook({
         query,
         params,
-        type: this.definition.queryType,
+        type: queryType,
         hook: QueryHooksType.AFTER
       });
     }
@@ -97,4 +154,4 @@ async function exec() {
   );
 }
 
-export { buildQuery, exec, toQuery, toString };
+export { buildQuery, exec, explain, toDebugString, toQuery, toString };

package/dist/esm/query/types.d.ts

@@ -1,6 +1,7 @@
+import 'bun';
 import '../column/index.js';
 import '../column/constants.js';
-export { j as AcceptedInsertValues, i as AcceptedOrderBy, k as AcceptedUpdateValues, l as AggregateColumn, A as AliasedColumn, C as ColumnSelector, f as QuerHooks, Q as QueryDefinition, n as QueryOutput, h as QueryRunHooks, o as QueryRunHooksOptions, R as RawColumn, m as SelectQueryOutput, e as SelectableColumn, c as StrictColumnSelector, W as WhereValue } from '../index-FMT0YEO7.js';
+export { u as AcceptedInsertValues, t as AcceptedOrderBy, v as AcceptedUpdateValues, w as AggregateColumn, A as AliasedColumn, C as ColumnSelector, E as ExplainOptions, Q as QueryDefinition, p as QueryHooks, y as QueryOutput, s as QueryRunHooks, z as QueryRunHooksOptions, R as RawColumn, x as SelectQueryOutput, m as SelectableColumn, k as StrictColumnSelector, W as WhereValue } from '../index-CjurLJdK.js';
 import '../types.js';
 import './constants.js';
 import '../table/constants.js';

package/dist/esm/query/utilities.d.ts

@@ -1,9 +1,10 @@
-import { T as Table, W as WhereValue, Q as QueryDefinition, C as ColumnSelector, c as StrictColumnSelector, d as QueryBuilder, A as AliasedColumn, e as SelectableColumn } from '../index-FMT0YEO7.js';
+import { T as Table, W as WhereValue, Q as QueryDefinition, C as ColumnSelector, k as StrictColumnSelector, l as QueryBuilder, A as AliasedColumn, m as SelectableColumn } from '../index-CjurLJdK.js';
 import { Column } from '../column/index.js';
 import { Dialect } from '../table/constants.js';
 import { AcceptedOperator } from './constants.js';
-import '../column/constants.js';
+import 'bun';
 import '../types.js';
+import '../column/constants.js';
 import '../column/types.js';
 
 declare function getTableColumnNames<ColName extends string, BaseAlias extends string, BaseTable extends Table<string, Record<string, Column>>, JoinedTables extends Record<string, Table<string, Record<string, Column>>>>(column: ColName, baseAlias: BaseAlias, baseTable: BaseTable, joinedTables: JoinedTables): {
@@ -16,6 +17,8 @@ declare function getTimestamp<TableRef extends Table<string, Record<string, Colu
     timestamp: Date;
     createdAt: string;
     updatedAt: string;
+    isHasUpdatedAt: boolean;
+    isHasCreatedAt: boolean;
 };
 declare function getParanoid<TableRef extends Table<string, Record<string, Column>>>(table: TableRef): {
     isWithParanoid: boolean;
@@ -30,5 +33,6 @@ declare function parseAliasedRow({ row, selects, root, }: {
     selects: SelectableColumn<string>[];
     root?: string | null;
 }): Record<string, any>;
+declare function sanitizeParams(params: unknown[]): (string | number | bigint | boolean | null)[];
 
-export { getCondition, getGroupByConditions, getParanoid, getTableColumnNames, getTableSelectName, getTimestamp, getWhereConditions, parseAliasedRow };
+export { getCondition, getGroupByConditions, getParanoid, getTableColumnNames, getTableSelectName, getTimestamp, getWhereConditions, parseAliasedRow, sanitizeParams };

package/dist/esm/query/utilities.js

@@ -54,6 +54,58 @@ function getCondition(dialect, column, operator, value) {
       return `${column} BETWEEN ? AND ?`;
     case AcceptedOperator.NOT_BETWEEN:
       return `${column} NOT BETWEEN ? AND ?`;
+    case AcceptedOperator.STARTS_WITH:
+      return `${column} LIKE ?`;
+    case AcceptedOperator.ENDS_WITH:
+      return `${column} LIKE ?`;
+    case AcceptedOperator.REG_EXP: {
+      switch (dialect) {
+        case Dialect.POSTGRES:
+          return `${column} ~ ?`;
+        case Dialect.MYSQL:
+          return `${column} REGEXP ?`;
+        case Dialect.SQLITE:
+          return `${column} GLOB ?`;
+        default:
+          throw new Error("Operator not supported");
+      }
+    }
+    case AcceptedOperator.NOT_REG_EXP: {
+      switch (dialect) {
+        case Dialect.POSTGRES:
+          return `${column} !~ ?`;
+        case Dialect.MYSQL:
+          return `${column} NOT REGEXP ?`;
+        case Dialect.SQLITE:
+          return `${column} NOT GLOB ?`;
+        default:
+          throw new Error("Operator not supported");
+      }
+    }
+    case AcceptedOperator.RLIKE: {
+      switch (dialect) {
+        case Dialect.POSTGRES:
+          return `${column} ~* ?`;
+        case Dialect.MYSQL:
+          return `${column} RLIKE ?`;
+        case Dialect.SQLITE:
+          return `${column} GLOB ?`;
+        default:
+          throw new Error("Operator not supported");
+      }
+    }
+    case AcceptedOperator.NOT_RLIKE: {
+      switch (dialect) {
+        case Dialect.POSTGRES:
+          return `${column} !~* ?`;
+        case Dialect.MYSQL:
+          return `${column} NOT RLIKE ?`;
+        case Dialect.SQLITE:
+          return `${column} NOT GLOB ?`;
+        default:
+          throw new Error("Operator not supported");
+      }
+    }
     default:
       throw new Error("Invalid operator");
   }
@@ -61,22 +113,32 @@ function getCondition(dialect, column, operator, value) {
 function getTimestamp(table) {
   const isWithTimestamp = !!table.timestamp;
   const timestamp = /* @__PURE__ */ new Date();
+  let isHasCreatedAt = true;
+  let isHasUpdatedAt = true;
   let createdAt = "createdAt";
   let updatedAt = "updatedAt";
   if (isWithTimestamp) {
     const isCustomTimestamp = typeof table.timestamp === "object";
-    if (isCustomTimestamp && table.timestamp.createdAt) {
-      createdAt = table.timestamp.createdAt;
+    if (isCustomTimestamp) {
+      if (typeof table.timestamp.createdAt === "string") {
+        createdAt = table.timestamp.createdAt;
+      }
+      isHasCreatedAt = table.timestamp.createdAt !== false;
     }
-    if (isCustomTimestamp && table.timestamp.updatedAt) {
-      updatedAt = table.timestamp.updatedAt;
+    if (isCustomTimestamp) {
+      if (typeof table.timestamp.updatedAt === "string") {
+        updatedAt = table.timestamp.updatedAt;
+      }
+      isHasUpdatedAt = table.timestamp.updatedAt !== false;
     }
   }
   return {
     isWithTimestamp,
     timestamp,
     createdAt,
-    updatedAt
+    updatedAt,
+    isHasUpdatedAt,
+    isHasCreatedAt
   };
 }
 function getParanoid(table) {
@@ -172,5 +234,23 @@ function parseAliasedRow({
   }
   return result;
 }
+function sanitizeParams(params) {
+  return params.map((param) => {
+    if (param === null || typeof param === "string" || typeof param === "number" || typeof param === "boolean" || typeof param === "bigint") {
+      return param;
+    }
+    if (param === void 0) {
+      return null;
+    }
+    if (param instanceof Date) {
+      return param.toISOString();
+    }
+    try {
+      return JSON.stringify(param);
+    } catch {
+      return null;
+    }
+  });
+}
 
-export { getCondition, getGroupByConditions, getParanoid, getTableColumnNames, getTableSelectName, getTimestamp, getWhereConditions, parseAliasedRow };
+export { getCondition, getGroupByConditions, getParanoid, getTableColumnNames, getTableSelectName, getTimestamp, getWhereConditions, parseAliasedRow, sanitizeParams };

package/dist/esm/table/constants.d.ts

@@ -1,5 +1,6 @@
 declare const Dialect: {
     readonly POSTGRES: "postgres";
+    readonly MYSQL: "mysql";
     readonly SQLITE: "sqlite";
 };
 type Dialect = (typeof Dialect)[keyof typeof Dialect];