sql-flex-query 1.0.0

package/README.md

@@ -0,0 +1,98 @@
+# sql-flex-query
+
+A lightweight, dialect-aware SQL query builder that enhances base query templates with dynamic WHERE, HAVING, ORDER BY, pagination, and more.
+
+## Supported Databases
+
+| Database | Placeholders | Identifier Quoting | Pagination |
+|----------|-------------|-------------------|------------|
+| PostgreSQL | `$1, $2` | `"double quotes"` | `LIMIT/OFFSET` |
+| MySQL | `?` | backticks | `LIMIT/OFFSET` |
+| SQLite | `?` | `"double quotes"` | `LIMIT/OFFSET` |
+| SQL Server | `@p1, @p2` | `[brackets]` | `OFFSET/FETCH` |
+
+## Installation
+
+```bash
+npm install sql-flex-query
+```
+
+## Quick Start
+
+### Functional API
+
+```javascript
+const { buildQueries } = require('sql-flex-query');
+
+const BASE = \`
+  SELECT /*SELECT_COLUMNS*/
+  FROM users u
+  /*WHERE_CLAUSE*/
+  /*ORDER_BY*/
+  /*LIMIT_CLAUSE*/
+\`;
+
+// Postgres (default)
+const result = buildQueries(
+  BASE,
+  [{ key: 'status', operation: 'EQ', value: 'ACTIVE' }],
+  [], [], 1, 10, {}, []
+);
+
+// MySQL
+const mysqlResult = buildQueries(
+  BASE,
+  [{ key: 'status', operation: 'EQ', value: 'ACTIVE' }],
+  [], [], 1, 10, {}, [], false, null,
+  { dialect: 'mysql' }
+);
+```
+
+### Options Object API
+
+```javascript
+const result = buildQueries({
+  baseQueryTemplate: BASE,
+  whereParams: [{ key: 'status', operation: 'EQ', value: 'ACTIVE' }],
+  sortBy: [{ key: 'name', direction: 'ASC' }],
+  page: 1,
+  size: 10,
+  dialect: 'mysql',
+});
+```
+
+### Fluent API
+
+```javascript
+const { QueryBuilder } = require('sql-flex-query');
+
+const result = new QueryBuilder('mysql')
+  .baseQuery(BASE)
+  .columnMapper({ name: 'u.name' })
+  .select(['name', 'email'])
+  .where({ key: 'status', operation: 'EQ', value: 'ACTIVE' })
+  .textSearch([{ key: 'name', operation: 'LIKE', value: '%john%', ignoreCase: true }])
+  .orderBy({ key: 'name', direction: 'ASC' })
+  .paginate(1, 10)
+  .build();
+```
+
+## Operations
+
+| Operation | SQL Output |
+|-----------|-----------|
+| EQ | `column = ?` |
+| NEQ | `column <> ?` |
+| LIKE | `column LIKE ?` |
+| NOT_LIKE | `column NOT LIKE ?` |
+| GT | `column > ?` |
+| LT | `column < ?` |
+| GTE | `column >= ?` |
+| LTE | `column <= ?` |
+| IN | `column IN (?, ?)` |
+| NULL | `column IS NULL` |
+| NOT_NULL | `column IS NOT NULL` |
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,125 @@
+type Operation = 'EQ' | 'NEQ' | 'LIKE' | 'NOT_LIKE' | 'GT' | 'LT' | 'GTE' | 'LTE' | 'IN' | 'NULL' | 'NOT_NULL';
+type DialectName = 'postgres' | 'mysql' | 'sqlite' | 'mssql';
+type SortDirection = 'ASC' | 'DESC';
+interface Criteria {
+    key: string;
+    operation: Operation;
+    value?: any;
+    ignoreCase?: boolean;
+    having?: boolean;
+}
+interface SortCriteria {
+    key: string;
+    direction: SortDirection;
+}
+interface ColumnMapper {
+    [key: string]: string;
+}
+interface BuildResult {
+    searchQuery: string;
+    countQuery: string;
+    params: any[];
+}
+interface BuildOptions {
+    baseQueryTemplate: string;
+    whereParams?: Criteria[];
+    textSearchParams?: Criteria[];
+    sortBy?: SortCriteria[];
+    page?: number;
+    size?: number;
+    columnMapper?: ColumnMapper;
+    selectColumns?: string[];
+    distinct?: boolean;
+    modifyCountQuery?: ((query: string) => string) | null;
+    dialect?: DialectName;
+}
+interface Dialect {
+    name: DialectName;
+    placeholder(position: number): string;
+    quoteIdentifier(identifier: string): string;
+    paginationClause(page: number, size: number): string;
+    lowerFunction(column: string): string;
+    lowerValue(value: string): string;
+    requiresOrderByForPagination: boolean;
+    mergesPaginationWithOrderBy: boolean;
+    orderByWithPagination(orderClause: string, page: number, size: number): string;
+}
+
+declare function buildQueries(options: BuildOptions): BuildResult;
+declare function buildQueries(baseQueryTemplate: string, whereParams?: Criteria[], textSearchParams?: Criteria[], sortBy?: SortCriteria[], page?: number, size?: number, columnMapper?: ColumnMapper, selectColumns?: string[], distinct?: boolean, modifyCountQuery?: ((query: string) => string) | null, dialectOptions?: {
+    dialect?: DialectName;
+}): BuildResult;
+
+declare class QueryBuilder {
+    private _dialect;
+    private _baseQueryTemplate;
+    private _whereParams;
+    private _textSearchParams;
+    private _sortBy;
+    private _page;
+    private _size;
+    private _columnMapper;
+    private _selectColumns;
+    private _distinct;
+    private _modifyCountQuery;
+    constructor(dialect?: DialectName);
+    baseQuery(template: string): this;
+    columnMapper(mapper: ColumnMapper): this;
+    select(columns: string[]): this;
+    where(criteria: Criteria | Criteria[]): this;
+    textSearch(criteria: Criteria | Criteria[]): this;
+    having(criteria: Criteria | Criteria[]): this;
+    orderBy(sort: SortCriteria | SortCriteria[]): this;
+    sortBy(key: string, direction?: SortDirection): this;
+    paginate(page: number, size: number): this;
+    distinct(enabled?: boolean): this;
+    modifyCountQuery(fn: (query: string) => string): this;
+    build(): BuildResult;
+    reset(): this;
+}
+
+declare abstract class BaseDialect implements Dialect {
+    abstract name: DialectName;
+    abstract placeholder(position: number): string;
+    abstract quoteIdentifier(identifier: string): string;
+    lowerFunction(column: string): string;
+    lowerValue(value: string): string;
+    requiresOrderByForPagination: boolean;
+    mergesPaginationWithOrderBy: boolean;
+    paginationClause(page: number, size: number): string;
+    orderByWithPagination(orderClause: string, page: number, size: number): string;
+}
+
+declare class PostgresDialect extends BaseDialect {
+    name: DialectName;
+    placeholder(position: number): string;
+    quoteIdentifier(identifier: string): string;
+}
+
+declare class MySQLDialect extends BaseDialect {
+    name: DialectName;
+    placeholder(_position: number): string;
+    quoteIdentifier(identifier: string): string;
+    lowerFunction(column: string): string;
+    lowerValue(value: string): string;
+}
+
+declare class SQLiteDialect extends BaseDialect {
+    name: DialectName;
+    placeholder(_position: number): string;
+    quoteIdentifier(identifier: string): string;
+}
+
+declare class MSSQLDialect extends BaseDialect {
+    name: DialectName;
+    requiresOrderByForPagination: boolean;
+    mergesPaginationWithOrderBy: boolean;
+    placeholder(position: number): string;
+    quoteIdentifier(identifier: string): string;
+    paginationClause(page: number, size: number): string;
+    orderByWithPagination(orderClause: string, page: number, size: number): string;
+}
+
+declare function createDialect(name: DialectName): Dialect;
+
+export { BaseDialect, type BuildOptions, type BuildResult, type ColumnMapper, type Criteria, type Dialect, type DialectName, MSSQLDialect, MySQLDialect, type Operation, PostgresDialect, QueryBuilder, SQLiteDialect, type SortCriteria, type SortDirection, buildQueries, createDialect };

package/dist/index.d.ts

@@ -0,0 +1,125 @@
+type Operation = 'EQ' | 'NEQ' | 'LIKE' | 'NOT_LIKE' | 'GT' | 'LT' | 'GTE' | 'LTE' | 'IN' | 'NULL' | 'NOT_NULL';
+type DialectName = 'postgres' | 'mysql' | 'sqlite' | 'mssql';
+type SortDirection = 'ASC' | 'DESC';
+interface Criteria {
+    key: string;
+    operation: Operation;
+    value?: any;
+    ignoreCase?: boolean;
+    having?: boolean;
+}
+interface SortCriteria {
+    key: string;
+    direction: SortDirection;
+}
+interface ColumnMapper {
+    [key: string]: string;
+}
+interface BuildResult {
+    searchQuery: string;
+    countQuery: string;
+    params: any[];
+}
+interface BuildOptions {
+    baseQueryTemplate: string;
+    whereParams?: Criteria[];
+    textSearchParams?: Criteria[];
+    sortBy?: SortCriteria[];
+    page?: number;
+    size?: number;
+    columnMapper?: ColumnMapper;
+    selectColumns?: string[];
+    distinct?: boolean;
+    modifyCountQuery?: ((query: string) => string) | null;
+    dialect?: DialectName;
+}
+interface Dialect {
+    name: DialectName;
+    placeholder(position: number): string;
+    quoteIdentifier(identifier: string): string;
+    paginationClause(page: number, size: number): string;
+    lowerFunction(column: string): string;
+    lowerValue(value: string): string;
+    requiresOrderByForPagination: boolean;
+    mergesPaginationWithOrderBy: boolean;
+    orderByWithPagination(orderClause: string, page: number, size: number): string;
+}
+
+declare function buildQueries(options: BuildOptions): BuildResult;
+declare function buildQueries(baseQueryTemplate: string, whereParams?: Criteria[], textSearchParams?: Criteria[], sortBy?: SortCriteria[], page?: number, size?: number, columnMapper?: ColumnMapper, selectColumns?: string[], distinct?: boolean, modifyCountQuery?: ((query: string) => string) | null, dialectOptions?: {
+    dialect?: DialectName;
+}): BuildResult;
+
+declare class QueryBuilder {
+    private _dialect;
+    private _baseQueryTemplate;
+    private _whereParams;
+    private _textSearchParams;
+    private _sortBy;
+    private _page;
+    private _size;
+    private _columnMapper;
+    private _selectColumns;
+    private _distinct;
+    private _modifyCountQuery;
+    constructor(dialect?: DialectName);
+    baseQuery(template: string): this;
+    columnMapper(mapper: ColumnMapper): this;
+    select(columns: string[]): this;
+    where(criteria: Criteria | Criteria[]): this;
+    textSearch(criteria: Criteria | Criteria[]): this;
+    having(criteria: Criteria | Criteria[]): this;
+    orderBy(sort: SortCriteria | SortCriteria[]): this;
+    sortBy(key: string, direction?: SortDirection): this;
+    paginate(page: number, size: number): this;
+    distinct(enabled?: boolean): this;
+    modifyCountQuery(fn: (query: string) => string): this;
+    build(): BuildResult;
+    reset(): this;
+}
+
+declare abstract class BaseDialect implements Dialect {
+    abstract name: DialectName;
+    abstract placeholder(position: number): string;
+    abstract quoteIdentifier(identifier: string): string;
+    lowerFunction(column: string): string;
+    lowerValue(value: string): string;
+    requiresOrderByForPagination: boolean;
+    mergesPaginationWithOrderBy: boolean;
+    paginationClause(page: number, size: number): string;
+    orderByWithPagination(orderClause: string, page: number, size: number): string;
+}
+
+declare class PostgresDialect extends BaseDialect {
+    name: DialectName;
+    placeholder(position: number): string;
+    quoteIdentifier(identifier: string): string;
+}
+
+declare class MySQLDialect extends BaseDialect {
+    name: DialectName;
+    placeholder(_position: number): string;
+    quoteIdentifier(identifier: string): string;
+    lowerFunction(column: string): string;
+    lowerValue(value: string): string;
+}
+
+declare class SQLiteDialect extends BaseDialect {
+    name: DialectName;
+    placeholder(_position: number): string;
+    quoteIdentifier(identifier: string): string;
+}
+
+declare class MSSQLDialect extends BaseDialect {
+    name: DialectName;
+    requiresOrderByForPagination: boolean;
+    mergesPaginationWithOrderBy: boolean;
+    placeholder(position: number): string;
+    quoteIdentifier(identifier: string): string;
+    paginationClause(page: number, size: number): string;
+    orderByWithPagination(orderClause: string, page: number, size: number): string;
+}
+
+declare function createDialect(name: DialectName): Dialect;
+
+export { BaseDialect, type BuildOptions, type BuildResult, type ColumnMapper, type Criteria, type Dialect, type DialectName, MSSQLDialect, MySQLDialect, type Operation, PostgresDialect, QueryBuilder, SQLiteDialect, type SortCriteria, type SortDirection, buildQueries, createDialect };

package/dist/index.js

@@ -0,0 +1,425 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  BaseDialect: () => BaseDialect,
+  MSSQLDialect: () => MSSQLDialect,
+  MySQLDialect: () => MySQLDialect,
+  PostgresDialect: () => PostgresDialect,
+  QueryBuilder: () => QueryBuilder,
+  SQLiteDialect: () => SQLiteDialect,
+  buildQueries: () => buildQueries,
+  createDialect: () => createDialect
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/dialects/base.dialect.ts
+var BaseDialect = class {
+  constructor() {
+    this.requiresOrderByForPagination = false;
+    this.mergesPaginationWithOrderBy = false;
+  }
+  lowerFunction(column) {
+    return `LOWER(${column})`;
+  }
+  lowerValue(value) {
+    return value.toLowerCase();
+  }
+  paginationClause(page, size) {
+    if (!page || !size) {
+      return "";
+    }
+    const offset = (page - 1) * size;
+    return `LIMIT ${size} OFFSET ${offset}`;
+  }
+  orderByWithPagination(orderClause, page, size) {
+    const pagination = this.paginationClause(page, size);
+    return [orderClause, pagination].filter(Boolean).join(" ");
+  }
+};
+
+// src/dialects/postgres.dialect.ts
+var PostgresDialect = class extends BaseDialect {
+  constructor() {
+    super(...arguments);
+    this.name = "postgres";
+  }
+  placeholder(position) {
+    return `$${position}`;
+  }
+  quoteIdentifier(identifier) {
+    return `"${identifier}"`;
+  }
+};
+
+// src/dialects/mysql.dialect.ts
+var MySQLDialect = class extends BaseDialect {
+  constructor() {
+    super(...arguments);
+    this.name = "mysql";
+  }
+  placeholder(_position) {
+    return "?";
+  }
+  quoteIdentifier(identifier) {
+    return `\`${identifier}\``;
+  }
+  lowerFunction(column) {
+    return column;
+  }
+  lowerValue(value) {
+    return value;
+  }
+};
+
+// src/dialects/sqlite.dialect.ts
+var SQLiteDialect = class extends BaseDialect {
+  constructor() {
+    super(...arguments);
+    this.name = "sqlite";
+  }
+  placeholder(_position) {
+    return "?";
+  }
+  quoteIdentifier(identifier) {
+    return `"${identifier}"`;
+  }
+};
+
+// src/dialects/mssql.dialect.ts
+var MSSQLDialect = class extends BaseDialect {
+  constructor() {
+    super(...arguments);
+    this.name = "mssql";
+    this.requiresOrderByForPagination = true;
+    this.mergesPaginationWithOrderBy = true;
+  }
+  placeholder(position) {
+    return `@p${position}`;
+  }
+  quoteIdentifier(identifier) {
+    return `[${identifier}]`;
+  }
+  paginationClause(page, size) {
+    if (!page || !size) {
+      return "";
+    }
+    const offset = (page - 1) * size;
+    return `OFFSET ${offset} ROWS FETCH NEXT ${size} ROWS ONLY`;
+  }
+  orderByWithPagination(orderClause, page, size) {
+    const pagination = this.paginationClause(page, size);
+    if (!pagination) {
+      return orderClause;
+    }
+    if (!orderClause) {
+      return `ORDER BY (SELECT NULL) ${pagination}`;
+    }
+    return `${orderClause} ${pagination}`;
+  }
+};
+
+// src/dialects/index.ts
+var dialects = {
+  postgres: () => new PostgresDialect(),
+  mysql: () => new MySQLDialect(),
+  sqlite: () => new SQLiteDialect(),
+  mssql: () => new MSSQLDialect()
+};
+function createDialect(name) {
+  const factory = dialects[name];
+  if (!factory) {
+    const supported = Object.keys(dialects).join(", ");
+    throw new Error(
+      `Unsupported dialect: "${name}". Supported dialects: ${supported}`
+    );
+  }
+  return factory();
+}
+
+// src/utils/helpers.ts
+function addQuotesIfMissing(str, dialect) {
+  if (str.startsWith('"') && str.endsWith('"') || str.startsWith("`") && str.endsWith("`") || str.startsWith("[") && str.endsWith("]")) {
+    return str;
+  }
+  if (str.includes(".")) {
+    return str;
+  }
+  return dialect.quoteIdentifier(str);
+}
+function getKey(columnMapper, key, dialect) {
+  return columnMapper[key] || addQuotesIfMissing(key, dialect);
+}
+
+// src/builder/clause-builder.ts
+function prepareClause(criteria, params, columnMapper, dialect) {
+  const key = getKey(columnMapper, criteria.key, dialect);
+  const operation = criteria.operation.toUpperCase();
+  const value = criteria.value;
+  const ignoreCase = criteria.ignoreCase || false;
+  switch (operation) {
+    case "EQ":
+      params.push(value);
+      return `${key} = ${dialect.placeholder(params.length)}`;
+    case "NEQ":
+      params.push(value);
+      return `${key} <> ${dialect.placeholder(params.length)}`;
+    case "LIKE": {
+      params.push(ignoreCase ? dialect.lowerValue(value) : value);
+      const col = ignoreCase ? dialect.lowerFunction(key) : key;
+      return `${col} LIKE ${dialect.placeholder(params.length)}`;
+    }
+    case "NOT_LIKE": {
+      params.push(ignoreCase ? dialect.lowerValue(value) : value);
+      const col = ignoreCase ? dialect.lowerFunction(key) : key;
+      return `${col} NOT LIKE ${dialect.placeholder(params.length)}`;
+    }
+    case "GT":
+      params.push(value);
+      return `${key} > ${dialect.placeholder(params.length)}`;
+    case "LT":
+      params.push(value);
+      return `${key} < ${dialect.placeholder(params.length)}`;
+    case "GTE":
+      params.push(value);
+      return `${key} >= ${dialect.placeholder(params.length)}`;
+    case "LTE":
+      params.push(value);
+      return `${key} <= ${dialect.placeholder(params.length)}`;
+    case "IN": {
+      const values = value;
+      const placeholders = values.map((_, i) => dialect.placeholder(params.length + i + 1)).join(", ");
+      params.push(...values);
+      return `${key} IN (${placeholders})`;
+    }
+    case "NULL":
+      return `${key} IS NULL`;
+    case "NOT_NULL":
+      return `${key} IS NOT NULL`;
+    default:
+      throw new Error(`Unsupported operation: ${operation}`);
+  }
+}
+function prepareWhereClause(whereParams, textSearchParams, params, columnMapper, dialect) {
+  const clauses = [];
+  if (textSearchParams.length > 0) {
+    const orGroup = textSearchParams.map((c) => prepareClause(c, params, columnMapper, dialect)).join(" OR ");
+    clauses.push(`(${orGroup})`);
+  }
+  for (const criteria of whereParams) {
+    const clause = prepareClause(criteria, params, columnMapper, dialect);
+    clauses.push(clause);
+  }
+  return clauses.length > 0 ? ` WHERE ${clauses.join(" AND ")}` : "";
+}
+function prepareHavingClause(havingParams, params, columnMapper, dialect) {
+  const clauses = [];
+  for (const criteria of havingParams) {
+    const clause = prepareClause(criteria, params, columnMapper, dialect);
+    clauses.push(clause);
+  }
+  return clauses.length > 0 ? ` HAVING ${clauses.join(" AND ")}` : "";
+}
+function addQuotesIfMissingForSelect(str, dialect) {
+  if (str.includes(".") || str.startsWith('"') && str.endsWith('"') || str.startsWith("`") && str.endsWith("`") || str.startsWith("[") && str.endsWith("]")) {
+    return str;
+  }
+  return dialect.quoteIdentifier(str);
+}
+function prepareSelect(columnMapper, selectColumns, distinct, dialect) {
+  const columns = selectColumns.length > 0 ? selectColumns.map((col) => {
+    const actualCol = columnMapper[col] || col;
+    return columnMapper[col] ? `${actualCol} AS ${dialect.quoteIdentifier(col)}` : addQuotesIfMissingForSelect(actualCol, dialect);
+  }).join(", ") : "*";
+  return distinct ? `DISTINCT ${columns}` : columns;
+}
+function prepareOrderClause(sortBy, columnMapper, dialect) {
+  return sortBy.length > 0 ? "ORDER BY " + sortBy.map((s) => `${getKey(columnMapper, s.key, dialect)} ${s.direction}`).join(", ") : "";
+}
+
+// src/builder/build-queries.ts
+function buildQueries(baseQueryTemplateOrOptions, whereParams = [], textSearchParams = [], sortBy = [], page = 0, size = 10, columnMapper = {}, selectColumns = [], distinct = false, modifyCountQuery = null, dialectOptions) {
+  let baseQueryTemplate;
+  let dialectName;
+  if (typeof baseQueryTemplateOrOptions === "object") {
+    const opts = baseQueryTemplateOrOptions;
+    baseQueryTemplate = opts.baseQueryTemplate;
+    whereParams = opts.whereParams || [];
+    textSearchParams = opts.textSearchParams || [];
+    sortBy = opts.sortBy || [];
+    page = opts.page || 0;
+    size = opts.size || 10;
+    columnMapper = opts.columnMapper || {};
+    selectColumns = opts.selectColumns || [];
+    distinct = opts.distinct || false;
+    modifyCountQuery = opts.modifyCountQuery || null;
+    dialectName = opts.dialect || "postgres";
+  } else {
+    baseQueryTemplate = baseQueryTemplateOrOptions;
+    dialectName = dialectOptions?.dialect || "postgres";
+  }
+  const dialect = createDialect(dialectName);
+  const params = [];
+  const havingCriteria = whereParams.filter((w) => w.having);
+  const whereCriteria = whereParams.filter((w) => !w.having);
+  const whereClause = prepareWhereClause(
+    whereCriteria,
+    textSearchParams,
+    params,
+    columnMapper,
+    dialect
+  );
+  const havingClause = prepareHavingClause(havingCriteria, params, columnMapper, dialect);
+  const orderClause = prepareOrderClause(sortBy, columnMapper, dialect);
+  let orderAndPagination;
+  let limitClause;
+  if (dialect.mergesPaginationWithOrderBy) {
+    orderAndPagination = dialect.orderByWithPagination(orderClause, page, size);
+    limitClause = "";
+  } else {
+    orderAndPagination = orderClause;
+    limitClause = dialect.paginationClause(page, size);
+    if (limitClause) {
+      limitClause = ` ${limitClause}`;
+    }
+  }
+  const searchQuery = baseQueryTemplate.replace(
+    "/*SELECT_COLUMNS*/",
+    prepareSelect(columnMapper, selectColumns, distinct, dialect)
+  ).replace("/*WHERE_CLAUSE*/", whereClause).replace("/*HAVING_CLAUSE*/", havingClause).replace("/*ORDER_BY*/", orderAndPagination).replace("/*LIMIT_CLAUSE*/", limitClause).trim();
+  const distinctClause = distinct && selectColumns.length > 0 ? "DISTINCT (" + selectColumns.map((col) => columnMapper[col] || col).join(", ") + ")" : "1";
+  const countExpr = modifyCountQuery ? "1" : `COUNT(${distinctClause}) AS count`;
+  let countQuery = baseQueryTemplate.replace("/*SELECT_COLUMNS*/", countExpr).replace("/*WHERE_CLAUSE*/", whereClause).replace("/*HAVING_CLAUSE*/", havingClause).replace("/*ORDER_BY*/", "").replace("/*LIMIT_CLAUSE*/", "").trim();
+  if (modifyCountQuery) {
+    countQuery = modifyCountQuery(countQuery);
+  }
+  return { searchQuery, countQuery, params };
+}
+
+// src/builder/query-builder.ts
+var QueryBuilder = class {
+  constructor(dialect = "postgres") {
+    this._baseQueryTemplate = "";
+    this._whereParams = [];
+    this._textSearchParams = [];
+    this._sortBy = [];
+    this._page = 0;
+    this._size = 0;
+    this._columnMapper = {};
+    this._selectColumns = [];
+    this._distinct = false;
+    this._modifyCountQuery = null;
+    this._dialect = dialect;
+  }
+  baseQuery(template) {
+    this._baseQueryTemplate = template;
+    return this;
+  }
+  columnMapper(mapper) {
+    this._columnMapper = mapper;
+    return this;
+  }
+  select(columns) {
+    this._selectColumns = columns;
+    return this;
+  }
+  where(criteria) {
+    const items = Array.isArray(criteria) ? criteria : [criteria];
+    this._whereParams.push(...items);
+    return this;
+  }
+  textSearch(criteria) {
+    const items = Array.isArray(criteria) ? criteria : [criteria];
+    this._textSearchParams.push(...items);
+    return this;
+  }
+  having(criteria) {
+    const items = Array.isArray(criteria) ? criteria : [criteria];
+    items.forEach((c) => c.having = true);
+    this._whereParams.push(...items);
+    return this;
+  }
+  orderBy(sort) {
+    const items = Array.isArray(sort) ? sort : [sort];
+    this._sortBy.push(...items);
+    return this;
+  }
+  sortBy(key, direction = "ASC") {
+    this._sortBy.push({ key, direction });
+    return this;
+  }
+  paginate(page, size) {
+    this._page = page;
+    this._size = size;
+    return this;
+  }
+  distinct(enabled = true) {
+    this._distinct = enabled;
+    return this;
+  }
+  modifyCountQuery(fn) {
+    this._modifyCountQuery = fn;
+    return this;
+  }
+  build() {
+    if (!this._baseQueryTemplate) {
+      throw new Error("baseQuery() must be called before build()");
+    }
+    return buildQueries({
+      baseQueryTemplate: this._baseQueryTemplate,
+      whereParams: this._whereParams,
+      textSearchParams: this._textSearchParams,
+      sortBy: this._sortBy,
+      page: this._page,
+      size: this._size,
+      columnMapper: this._columnMapper,
+      selectColumns: this._selectColumns,
+      distinct: this._distinct,
+      modifyCountQuery: this._modifyCountQuery,
+      dialect: this._dialect
+    });
+  }
+  reset() {
+    this._baseQueryTemplate = "";
+    this._whereParams = [];
+    this._textSearchParams = [];
+    this._sortBy = [];
+    this._page = 0;
+    this._size = 0;
+    this._columnMapper = {};
+    this._selectColumns = [];
+    this._distinct = false;
+    this._modifyCountQuery = null;
+    return this;
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BaseDialect,
+  MSSQLDialect,
+  MySQLDialect,
+  PostgresDialect,
+  QueryBuilder,
+  SQLiteDialect,
+  buildQueries,
+  createDialect
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/dialects/base.dialect.ts","../src/dialects/postgres.dialect.ts","../src/dialects/mysql.dialect.ts","../src/dialects/sqlite.dialect.ts","../src/dialects/mssql.dialect.ts","../src/dialects/index.ts","../src/utils/helpers.ts","../src/builder/clause-builder.ts","../src/builder/build-queries.ts","../src/builder/query-builder.ts"],"sourcesContent":["export { buildQueries } from './builder/build-queries';\nexport { QueryBuilder } from './builder/query-builder';\nexport {\n  createDialect,\n  PostgresDialect,\n  MySQLDialect,\n  SQLiteDialect,\n  MSSQLDialect,\n  BaseDialect,\n} from './dialects';\nexport type {\n  Criteria,\n  SortCriteria,\n  ColumnMapper,\n  BuildResult,\n  BuildOptions,\n  Dialect,\n  DialectName,\n  Operation,\n  SortDirection,\n} from './types';\n","import { Dialect, DialectName } from '../types';\n\nexport abstract class BaseDialect implements Dialect {\n  abstract name: DialectName;\n  abstract placeholder(position: number): string;\n  abstract quoteIdentifier(identifier: string): string;\n\n  lowerFunction(column: string): string {\n    return `LOWER(${column})`;\n  }\n\n  lowerValue(value: string): string {\n    return value.toLowerCase();\n  }\n\n  requiresOrderByForPagination: boolean = false;\n  mergesPaginationWithOrderBy: boolean = false;\n\n  paginationClause(page: number, size: number): string {\n    if (!page || !size) {\n      return '';\n    }\n    const offset = (page - 1) * size;\n    return `LIMIT ${size} OFFSET ${offset}`;\n  }\n\n  orderByWithPagination(orderClause: string, page: number, size: number): string {\n    const pagination = this.paginationClause(page, size);\n    return [orderClause, pagination].filter(Boolean).join(' ');\n  }\n}\n","import { DialectName } from '../types';\nimport { BaseDialect } from './base.dialect';\n\nexport class PostgresDialect extends BaseDialect {\n  name: DialectName = 'postgres';\n\n  placeholder(position: number): string {\n    return `$${position}`;\n  }\n\n  quoteIdentifier(identifier: string): string {\n    return `\"${identifier}\"`;\n  }\n}\n","import { DialectName } from '../types';\nimport { BaseDialect } from './base.dialect';\n\nexport class MySQLDialect extends BaseDialect {\n  name: DialectName = 'mysql';\n\n  placeholder(_position: number): string {\n    return '?';\n  }\n\n  quoteIdentifier(identifier: string): string {\n    return `\\`${identifier}\\``;\n  }\n\n  lowerFunction(column: string): string {\n    return column;\n  }\n\n  lowerValue(value: string): string {\n    return value;\n  }\n}\n","import { DialectName } from '../types';\nimport { BaseDialect } from './base.dialect';\n\nexport class SQLiteDialect extends BaseDialect {\n  name: DialectName = 'sqlite';\n\n  placeholder(_position: number): string {\n    return '?';\n  }\n\n  quoteIdentifier(identifier: string): string {\n    return `\"${identifier}\"`;\n  }\n}\n","import { DialectName } from '../types';\nimport { BaseDialect } from './base.dialect';\n\nexport class MSSQLDialect extends BaseDialect {\n  name: DialectName = 'mssql';\n  requiresOrderByForPagination: boolean = true;\n  mergesPaginationWithOrderBy: boolean = true;\n\n  placeholder(position: number): string {\n    return `@p${position}`;\n  }\n\n  quoteIdentifier(identifier: string): string {\n    return `[${identifier}]`;\n  }\n\n  paginationClause(page: number, size: number): string {\n    if (!page || !size) {\n      return '';\n    }\n    const offset = (page - 1) * size;\n    return `OFFSET ${offset} ROWS FETCH NEXT ${size} ROWS ONLY`;\n  }\n\n  orderByWithPagination(orderClause: string, page: number, size: number): string {\n    const pagination = this.paginationClause(page, size);\n    if (!pagination) {\n      return orderClause;\n    }\n    if (!orderClause) {\n      return `ORDER BY (SELECT NULL) ${pagination}`;\n    }\n    return `${orderClause} ${pagination}`;\n  }\n}\n","import { Dialect, DialectName } from '../types';\nimport { PostgresDialect } from './postgres.dialect';\nimport { MySQLDialect } from './mysql.dialect';\nimport { SQLiteDialect } from './sqlite.dialect';\nimport { MSSQLDialect } from './mssql.dialect';\n\nconst dialects: Record<DialectName, () => Dialect> = {\n  postgres: () => new PostgresDialect(),\n  mysql: () => new MySQLDialect(),\n  sqlite: () => new SQLiteDialect(),\n  mssql: () => new MSSQLDialect(),\n};\n\nexport function createDialect(name: DialectName): Dialect {\n  const factory = dialects[name];\n  if (!factory) {\n    const supported = Object.keys(dialects).join(', ');\n    throw new Error(\n      `Unsupported dialect: \"${name}\". Supported dialects: ${supported}`\n    );\n  }\n  return factory();\n}\n\nexport { PostgresDialect } from './postgres.dialect';\nexport { MySQLDialect } from './mysql.dialect';\nexport { SQLiteDialect } from './sqlite.dialect';\nexport { MSSQLDialect } from './mssql.dialect';\nexport { BaseDialect } from './base.dialect';\n","import { Dialect } from '../types';\n\nexport function addQuotesIfMissing(str: string, dialect: Dialect): string {\n  if (\n    (str.startsWith('\"') && str.endsWith('\"')) ||\n    (str.startsWith('`') && str.endsWith('`')) ||\n    (str.startsWith('[') && str.endsWith(']'))\n  ) {\n    return str;\n  }\n  if (str.includes('.')) {\n    return str;\n  }\n  return dialect.quoteIdentifier(str);\n}\n\nexport function getKey(\n  columnMapper: { [key: string]: string },\n  key: string,\n  dialect: Dialect\n): string {\n  return columnMapper[key] || addQuotesIfMissing(key, dialect);\n}\n","import { Criteria, SortCriteria, ColumnMapper, Dialect } from '../types';\nimport { getKey } from '../utils/helpers';\n\nexport function prepareClause(\n  criteria: Criteria,\n  params: any[],\n  columnMapper: ColumnMapper,\n  dialect: Dialect\n): string {\n  const key = getKey(columnMapper, criteria.key, dialect);\n  const operation = criteria.operation.toUpperCase();\n  const value = criteria.value;\n  const ignoreCase = criteria.ignoreCase || false;\n\n  switch (operation) {\n    case 'EQ':\n      params.push(value);\n      return `${key} = ${dialect.placeholder(params.length)}`;\n    case 'NEQ':\n      params.push(value);\n      return `${key} <> ${dialect.placeholder(params.length)}`;\n    case 'LIKE': {\n      params.push(ignoreCase ? dialect.lowerValue(value) : value);\n      const col = ignoreCase ? dialect.lowerFunction(key) : key;\n      return `${col} LIKE ${dialect.placeholder(params.length)}`;\n    }\n    case 'NOT_LIKE': {\n      params.push(ignoreCase ? dialect.lowerValue(value) : value);\n      const col = ignoreCase ? dialect.lowerFunction(key) : key;\n      return `${col} NOT LIKE ${dialect.placeholder(params.length)}`;\n    }\n    case 'GT':\n      params.push(value);\n      return `${key} > ${dialect.placeholder(params.length)}`;\n    case 'LT':\n      params.push(value);\n      return `${key} < ${dialect.placeholder(params.length)}`;\n    case 'GTE':\n      params.push(value);\n      return `${key} >= ${dialect.placeholder(params.length)}`;\n    case 'LTE':\n      params.push(value);\n      return `${key} <= ${dialect.placeholder(params.length)}`;\n    case 'IN': {\n      const values = value as any[];\n      const placeholders = values\n        .map((_, i) => dialect.placeholder(params.length + i + 1))\n        .join(', ');\n      params.push(...values);\n      return `${key} IN (${placeholders})`;\n    }\n    case 'NULL':\n      return `${key} IS NULL`;\n    case 'NOT_NULL':\n      return `${key} IS NOT NULL`;\n    default:\n      throw new Error(`Unsupported operation: ${operation}`);\n  }\n}\n\nexport function prepareWhereClause(\n  whereParams: Criteria[],\n  textSearchParams: Criteria[],\n  params: any[],\n  columnMapper: ColumnMapper,\n  dialect: Dialect\n): string {\n  const clauses: string[] = [];\n\n  if (textSearchParams.length > 0) {\n    const orGroup = textSearchParams\n      .map((c) => prepareClause(c, params, columnMapper, dialect))\n      .join(' OR ');\n    clauses.push(`(${orGroup})`);\n  }\n\n  for (const criteria of whereParams) {\n    const clause = prepareClause(criteria, params, columnMapper, dialect);\n    clauses.push(clause);\n  }\n\n  return clauses.length > 0 ? ` WHERE ${clauses.join(' AND ')}` : '';\n}\n\nexport function prepareHavingClause(\n  havingParams: Criteria[],\n  params: any[],\n  columnMapper: ColumnMapper,\n  dialect: Dialect\n): string {\n  const clauses: string[] = [];\n  for (const criteria of havingParams) {\n    const clause = prepareClause(criteria, params, columnMapper, dialect);\n    clauses.push(clause);\n  }\n  return clauses.length > 0 ? ` HAVING ${clauses.join(' AND ')}` : '';\n}\n\nfunction addQuotesIfMissingForSelect(str: string, dialect: Dialect): string {\n  if (\n    str.includes('.') ||\n    (str.startsWith('\"') && str.endsWith('\"')) ||\n    (str.startsWith('`') && str.endsWith('`')) ||\n    (str.startsWith('[') && str.endsWith(']'))\n  ) {\n    return str;\n  }\n  return dialect.quoteIdentifier(str);\n}\n\nexport function prepareSelect(\n  columnMapper: ColumnMapper,\n  selectColumns: string[],\n  distinct: boolean,\n  dialect: Dialect\n): string {\n  const columns =\n    selectColumns.length > 0\n      ? selectColumns\n          .map((col) => {\n            const actualCol = columnMapper[col] || col;\n            return columnMapper[col]\n              ? `${actualCol} AS ${dialect.quoteIdentifier(col)}`\n              : addQuotesIfMissingForSelect(actualCol, dialect);\n          })\n          .join(', ')\n      : '*';\n\n  return distinct ? `DISTINCT ${columns}` : columns;\n}\n\nexport function prepareOrderClause(\n  sortBy: SortCriteria[],\n  columnMapper: ColumnMapper,\n  dialect: Dialect\n): string {\n  return sortBy.length > 0\n    ? 'ORDER BY ' +\n        sortBy\n          .map((s) => `${getKey(columnMapper, s.key, dialect)} ${s.direction}`)\n          .join(', ')\n    : '';\n}\n","import {\n  Criteria,\n  SortCriteria,\n  ColumnMapper,\n  BuildResult,\n  BuildOptions,\n  DialectName,\n} from '../types';\nimport { createDialect } from '../dialects';\nimport {\n  prepareWhereClause,\n  prepareHavingClause,\n  prepareSelect,\n  prepareOrderClause,\n} from './clause-builder';\n\nexport function buildQueries(options: BuildOptions): BuildResult;\nexport function buildQueries(\n  baseQueryTemplate: string,\n  whereParams?: Criteria[],\n  textSearchParams?: Criteria[],\n  sortBy?: SortCriteria[],\n  page?: number,\n  size?: number,\n  columnMapper?: ColumnMapper,\n  selectColumns?: string[],\n  distinct?: boolean,\n  modifyCountQuery?: ((query: string) => string) | null,\n  dialectOptions?: { dialect?: DialectName }\n): BuildResult;\n\nexport function buildQueries(\n  baseQueryTemplateOrOptions: string | BuildOptions,\n  whereParams: Criteria[] = [],\n  textSearchParams: Criteria[] = [],\n  sortBy: SortCriteria[] = [],\n  page: number = 0,\n  size: number = 10,\n  columnMapper: ColumnMapper = {},\n  selectColumns: string[] = [],\n  distinct: boolean = false,\n  modifyCountQuery: ((query: string) => string) | null = null,\n  dialectOptions?: { dialect?: DialectName }\n): BuildResult {\n  let baseQueryTemplate: string;\n  let dialectName: DialectName;\n\n  if (typeof baseQueryTemplateOrOptions === 'object') {\n    const opts = baseQueryTemplateOrOptions;\n    baseQueryTemplate = opts.baseQueryTemplate;\n    whereParams = opts.whereParams || [];\n    textSearchParams = opts.textSearchParams || [];\n    sortBy = opts.sortBy || [];\n    page = opts.page || 0;\n    size = opts.size || 10;\n    columnMapper = opts.columnMapper || {};\n    selectColumns = opts.selectColumns || [];\n    distinct = opts.distinct || false;\n    modifyCountQuery = opts.modifyCountQuery || null;\n    dialectName = opts.dialect || 'postgres';\n  } else {\n    baseQueryTemplate = baseQueryTemplateOrOptions;\n    dialectName = dialectOptions?.dialect || 'postgres';\n  }\n\n  const dialect = createDialect(dialectName);\n\n  const params: any[] = [];\n  const havingCriteria = whereParams.filter((w) => w.having);\n  const whereCriteria = whereParams.filter((w) => !w.having);\n\n  const whereClause = prepareWhereClause(\n    whereCriteria,\n    textSearchParams,\n    params,\n    columnMapper,\n    dialect\n  );\n  const havingClause = prepareHavingClause(havingCriteria, params, columnMapper, dialect);\n  const orderClause = prepareOrderClause(sortBy, columnMapper, dialect);\n\n  let orderAndPagination: string;\n  let limitClause: string;\n\n  if (dialect.mergesPaginationWithOrderBy) {\n    orderAndPagination = dialect.orderByWithPagination(orderClause, page, size);\n    limitClause = '';\n  } else {\n    orderAndPagination = orderClause;\n    limitClause = dialect.paginationClause(page, size);\n    if (limitClause) {\n      limitClause = ` ${limitClause}`;\n    }\n  }\n\n  const searchQuery = baseQueryTemplate\n    .replace(\n      '/*SELECT_COLUMNS*/',\n      prepareSelect(columnMapper, selectColumns, distinct, dialect)\n    )\n    .replace('/*WHERE_CLAUSE*/', whereClause)\n    .replace('/*HAVING_CLAUSE*/', havingClause)\n    .replace('/*ORDER_BY*/', orderAndPagination)\n    .replace('/*LIMIT_CLAUSE*/', limitClause)\n    .trim();\n\n  const distinctClause =\n    distinct && selectColumns.length > 0\n      ? 'DISTINCT (' +\n        selectColumns\n          .map((col) => columnMapper[col] || col)\n          .join(', ') +\n        ')'\n      : '1';\n  const countExpr = modifyCountQuery ? '1' : `COUNT(${distinctClause}) AS count`;\n\n  let countQuery = baseQueryTemplate\n    .replace('/*SELECT_COLUMNS*/', countExpr)\n    .replace('/*WHERE_CLAUSE*/', whereClause)\n    .replace('/*HAVING_CLAUSE*/', havingClause)\n    .replace('/*ORDER_BY*/', '')\n    .replace('/*LIMIT_CLAUSE*/', '')\n    .trim();\n\n  if (modifyCountQuery) {\n    countQuery = modifyCountQuery(countQuery);\n  }\n\n  return { searchQuery, countQuery, params };\n}\n","import {\n  Criteria,\n  SortCriteria,\n  ColumnMapper,\n  BuildResult,\n  DialectName,\n  SortDirection,\n} from '../types';\nimport { buildQueries } from './build-queries';\n\nexport class QueryBuilder {\n  private _dialect: DialectName;\n  private _baseQueryTemplate: string = '';\n  private _whereParams: Criteria[] = [];\n  private _textSearchParams: Criteria[] = [];\n  private _sortBy: SortCriteria[] = [];\n  private _page: number = 0;\n  private _size: number = 0;\n  private _columnMapper: ColumnMapper = {};\n  private _selectColumns: string[] = [];\n  private _distinct: boolean = false;\n  private _modifyCountQuery: ((query: string) => string) | null = null;\n\n  constructor(dialect: DialectName = 'postgres') {\n    this._dialect = dialect;\n  }\n\n  baseQuery(template: string): this {\n    this._baseQueryTemplate = template;\n    return this;\n  }\n\n  columnMapper(mapper: ColumnMapper): this {\n    this._columnMapper = mapper;\n    return this;\n  }\n\n  select(columns: string[]): this {\n    this._selectColumns = columns;\n    return this;\n  }\n\n  where(criteria: Criteria | Criteria[]): this {\n    const items = Array.isArray(criteria) ? criteria : [criteria];\n    this._whereParams.push(...items);\n    return this;\n  }\n\n  textSearch(criteria: Criteria | Criteria[]): this {\n    const items = Array.isArray(criteria) ? criteria : [criteria];\n    this._textSearchParams.push(...items);\n    return this;\n  }\n\n  having(criteria: Criteria | Criteria[]): this {\n    const items = Array.isArray(criteria) ? criteria : [criteria];\n    items.forEach((c) => (c.having = true));\n    this._whereParams.push(...items);\n    return this;\n  }\n\n  orderBy(sort: SortCriteria | SortCriteria[]): this {\n    const items = Array.isArray(sort) ? sort : [sort];\n    this._sortBy.push(...items);\n    return this;\n  }\n\n  sortBy(key: string, direction: SortDirection = 'ASC'): this {\n    this._sortBy.push({ key, direction });\n    return this;\n  }\n\n  paginate(page: number, size: number): this {\n    this._page = page;\n    this._size = size;\n    return this;\n  }\n\n  distinct(enabled: boolean = true): this {\n    this._distinct = enabled;\n    return this;\n  }\n\n  modifyCountQuery(fn: (query: string) => string): this {\n    this._modifyCountQuery = fn;\n    return this;\n  }\n\n  build(): BuildResult {\n    if (!this._baseQueryTemplate) {\n      throw new Error('baseQuery() must be called before build()');\n    }\n\n    return buildQueries({\n      baseQueryTemplate: this._baseQueryTemplate,\n      whereParams: this._whereParams,\n      textSearchParams: this._textSearchParams,\n      sortBy: this._sortBy,\n      page: this._page,\n      size: this._size,\n      columnMapper: this._columnMapper,\n      selectColumns: this._selectColumns,\n      distinct: this._distinct,\n      modifyCountQuery: this._modifyCountQuery,\n      dialect: this._dialect,\n    });\n  }\n\n  reset(): this {\n    this._baseQueryTemplate = '';\n    this._whereParams = [];\n    this._textSearchParams = [];\n    this._sortBy = [];\n    this._page = 0;\n    this._size = 0;\n    this._columnMapper = {};\n    this._selectColumns = [];\n    this._distinct = false;\n    this._modifyCountQuery = null;\n    return this;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.mjs

@@ -0,0 +1,391 @@
+// src/dialects/base.dialect.ts
+var BaseDialect = class {
+  constructor() {
+    this.requiresOrderByForPagination = false;
+    this.mergesPaginationWithOrderBy = false;
+  }
+  lowerFunction(column) {
+    return `LOWER(${column})`;
+  }
+  lowerValue(value) {
+    return value.toLowerCase();
+  }
+  paginationClause(page, size) {
+    if (!page || !size) {
+      return "";
+    }
+    const offset = (page - 1) * size;
+    return `LIMIT ${size} OFFSET ${offset}`;
+  }
+  orderByWithPagination(orderClause, page, size) {
+    const pagination = this.paginationClause(page, size);
+    return [orderClause, pagination].filter(Boolean).join(" ");
+  }
+};
+
+// src/dialects/postgres.dialect.ts
+var PostgresDialect = class extends BaseDialect {
+  constructor() {
+    super(...arguments);
+    this.name = "postgres";
+  }
+  placeholder(position) {
+    return `$${position}`;
+  }
+  quoteIdentifier(identifier) {
+    return `"${identifier}"`;
+  }
+};
+
+// src/dialects/mysql.dialect.ts
+var MySQLDialect = class extends BaseDialect {
+  constructor() {
+    super(...arguments);
+    this.name = "mysql";
+  }
+  placeholder(_position) {
+    return "?";
+  }
+  quoteIdentifier(identifier) {
+    return `\`${identifier}\``;
+  }
+  lowerFunction(column) {
+    return column;
+  }
+  lowerValue(value) {
+    return value;
+  }
+};
+
+// src/dialects/sqlite.dialect.ts
+var SQLiteDialect = class extends BaseDialect {
+  constructor() {
+    super(...arguments);
+    this.name = "sqlite";
+  }
+  placeholder(_position) {
+    return "?";
+  }
+  quoteIdentifier(identifier) {
+    return `"${identifier}"`;
+  }
+};
+
+// src/dialects/mssql.dialect.ts
+var MSSQLDialect = class extends BaseDialect {
+  constructor() {
+    super(...arguments);
+    this.name = "mssql";
+    this.requiresOrderByForPagination = true;
+    this.mergesPaginationWithOrderBy = true;
+  }
+  placeholder(position) {
+    return `@p${position}`;
+  }
+  quoteIdentifier(identifier) {
+    return `[${identifier}]`;
+  }
+  paginationClause(page, size) {
+    if (!page || !size) {
+      return "";
+    }
+    const offset = (page - 1) * size;
+    return `OFFSET ${offset} ROWS FETCH NEXT ${size} ROWS ONLY`;
+  }
+  orderByWithPagination(orderClause, page, size) {
+    const pagination = this.paginationClause(page, size);
+    if (!pagination) {
+      return orderClause;
+    }
+    if (!orderClause) {
+      return `ORDER BY (SELECT NULL) ${pagination}`;
+    }
+    return `${orderClause} ${pagination}`;
+  }
+};
+
+// src/dialects/index.ts
+var dialects = {
+  postgres: () => new PostgresDialect(),
+  mysql: () => new MySQLDialect(),
+  sqlite: () => new SQLiteDialect(),
+  mssql: () => new MSSQLDialect()
+};
+function createDialect(name) {
+  const factory = dialects[name];
+  if (!factory) {
+    const supported = Object.keys(dialects).join(", ");
+    throw new Error(
+      `Unsupported dialect: "${name}". Supported dialects: ${supported}`
+    );
+  }
+  return factory();
+}
+
+// src/utils/helpers.ts
+function addQuotesIfMissing(str, dialect) {
+  if (str.startsWith('"') && str.endsWith('"') || str.startsWith("`") && str.endsWith("`") || str.startsWith("[") && str.endsWith("]")) {
+    return str;
+  }
+  if (str.includes(".")) {
+    return str;
+  }
+  return dialect.quoteIdentifier(str);
+}
+function getKey(columnMapper, key, dialect) {
+  return columnMapper[key] || addQuotesIfMissing(key, dialect);
+}
+
+// src/builder/clause-builder.ts
+function prepareClause(criteria, params, columnMapper, dialect) {
+  const key = getKey(columnMapper, criteria.key, dialect);
+  const operation = criteria.operation.toUpperCase();
+  const value = criteria.value;
+  const ignoreCase = criteria.ignoreCase || false;
+  switch (operation) {
+    case "EQ":
+      params.push(value);
+      return `${key} = ${dialect.placeholder(params.length)}`;
+    case "NEQ":
+      params.push(value);
+      return `${key} <> ${dialect.placeholder(params.length)}`;
+    case "LIKE": {
+      params.push(ignoreCase ? dialect.lowerValue(value) : value);
+      const col = ignoreCase ? dialect.lowerFunction(key) : key;
+      return `${col} LIKE ${dialect.placeholder(params.length)}`;
+    }
+    case "NOT_LIKE": {
+      params.push(ignoreCase ? dialect.lowerValue(value) : value);
+      const col = ignoreCase ? dialect.lowerFunction(key) : key;
+      return `${col} NOT LIKE ${dialect.placeholder(params.length)}`;
+    }
+    case "GT":
+      params.push(value);
+      return `${key} > ${dialect.placeholder(params.length)}`;
+    case "LT":
+      params.push(value);
+      return `${key} < ${dialect.placeholder(params.length)}`;
+    case "GTE":
+      params.push(value);
+      return `${key} >= ${dialect.placeholder(params.length)}`;
+    case "LTE":
+      params.push(value);
+      return `${key} <= ${dialect.placeholder(params.length)}`;
+    case "IN": {
+      const values = value;
+      const placeholders = values.map((_, i) => dialect.placeholder(params.length + i + 1)).join(", ");
+      params.push(...values);
+      return `${key} IN (${placeholders})`;
+    }
+    case "NULL":
+      return `${key} IS NULL`;
+    case "NOT_NULL":
+      return `${key} IS NOT NULL`;
+    default:
+      throw new Error(`Unsupported operation: ${operation}`);
+  }
+}
+function prepareWhereClause(whereParams, textSearchParams, params, columnMapper, dialect) {
+  const clauses = [];
+  if (textSearchParams.length > 0) {
+    const orGroup = textSearchParams.map((c) => prepareClause(c, params, columnMapper, dialect)).join(" OR ");
+    clauses.push(`(${orGroup})`);
+  }
+  for (const criteria of whereParams) {
+    const clause = prepareClause(criteria, params, columnMapper, dialect);
+    clauses.push(clause);
+  }
+  return clauses.length > 0 ? ` WHERE ${clauses.join(" AND ")}` : "";
+}
+function prepareHavingClause(havingParams, params, columnMapper, dialect) {
+  const clauses = [];
+  for (const criteria of havingParams) {
+    const clause = prepareClause(criteria, params, columnMapper, dialect);
+    clauses.push(clause);
+  }
+  return clauses.length > 0 ? ` HAVING ${clauses.join(" AND ")}` : "";
+}
+function addQuotesIfMissingForSelect(str, dialect) {
+  if (str.includes(".") || str.startsWith('"') && str.endsWith('"') || str.startsWith("`") && str.endsWith("`") || str.startsWith("[") && str.endsWith("]")) {
+    return str;
+  }
+  return dialect.quoteIdentifier(str);
+}
+function prepareSelect(columnMapper, selectColumns, distinct, dialect) {
+  const columns = selectColumns.length > 0 ? selectColumns.map((col) => {
+    const actualCol = columnMapper[col] || col;
+    return columnMapper[col] ? `${actualCol} AS ${dialect.quoteIdentifier(col)}` : addQuotesIfMissingForSelect(actualCol, dialect);
+  }).join(", ") : "*";
+  return distinct ? `DISTINCT ${columns}` : columns;
+}
+function prepareOrderClause(sortBy, columnMapper, dialect) {
+  return sortBy.length > 0 ? "ORDER BY " + sortBy.map((s) => `${getKey(columnMapper, s.key, dialect)} ${s.direction}`).join(", ") : "";
+}
+
+// src/builder/build-queries.ts
+function buildQueries(baseQueryTemplateOrOptions, whereParams = [], textSearchParams = [], sortBy = [], page = 0, size = 10, columnMapper = {}, selectColumns = [], distinct = false, modifyCountQuery = null, dialectOptions) {
+  let baseQueryTemplate;
+  let dialectName;
+  if (typeof baseQueryTemplateOrOptions === "object") {
+    const opts = baseQueryTemplateOrOptions;
+    baseQueryTemplate = opts.baseQueryTemplate;
+    whereParams = opts.whereParams || [];
+    textSearchParams = opts.textSearchParams || [];
+    sortBy = opts.sortBy || [];
+    page = opts.page || 0;
+    size = opts.size || 10;
+    columnMapper = opts.columnMapper || {};
+    selectColumns = opts.selectColumns || [];
+    distinct = opts.distinct || false;
+    modifyCountQuery = opts.modifyCountQuery || null;
+    dialectName = opts.dialect || "postgres";
+  } else {
+    baseQueryTemplate = baseQueryTemplateOrOptions;
+    dialectName = dialectOptions?.dialect || "postgres";
+  }
+  const dialect = createDialect(dialectName);
+  const params = [];
+  const havingCriteria = whereParams.filter((w) => w.having);
+  const whereCriteria = whereParams.filter((w) => !w.having);
+  const whereClause = prepareWhereClause(
+    whereCriteria,
+    textSearchParams,
+    params,
+    columnMapper,
+    dialect
+  );
+  const havingClause = prepareHavingClause(havingCriteria, params, columnMapper, dialect);
+  const orderClause = prepareOrderClause(sortBy, columnMapper, dialect);
+  let orderAndPagination;
+  let limitClause;
+  if (dialect.mergesPaginationWithOrderBy) {
+    orderAndPagination = dialect.orderByWithPagination(orderClause, page, size);
+    limitClause = "";
+  } else {
+    orderAndPagination = orderClause;
+    limitClause = dialect.paginationClause(page, size);
+    if (limitClause) {
+      limitClause = ` ${limitClause}`;
+    }
+  }
+  const searchQuery = baseQueryTemplate.replace(
+    "/*SELECT_COLUMNS*/",
+    prepareSelect(columnMapper, selectColumns, distinct, dialect)
+  ).replace("/*WHERE_CLAUSE*/", whereClause).replace("/*HAVING_CLAUSE*/", havingClause).replace("/*ORDER_BY*/", orderAndPagination).replace("/*LIMIT_CLAUSE*/", limitClause).trim();
+  const distinctClause = distinct && selectColumns.length > 0 ? "DISTINCT (" + selectColumns.map((col) => columnMapper[col] || col).join(", ") + ")" : "1";
+  const countExpr = modifyCountQuery ? "1" : `COUNT(${distinctClause}) AS count`;
+  let countQuery = baseQueryTemplate.replace("/*SELECT_COLUMNS*/", countExpr).replace("/*WHERE_CLAUSE*/", whereClause).replace("/*HAVING_CLAUSE*/", havingClause).replace("/*ORDER_BY*/", "").replace("/*LIMIT_CLAUSE*/", "").trim();
+  if (modifyCountQuery) {
+    countQuery = modifyCountQuery(countQuery);
+  }
+  return { searchQuery, countQuery, params };
+}
+
+// src/builder/query-builder.ts
+var QueryBuilder = class {
+  constructor(dialect = "postgres") {
+    this._baseQueryTemplate = "";
+    this._whereParams = [];
+    this._textSearchParams = [];
+    this._sortBy = [];
+    this._page = 0;
+    this._size = 0;
+    this._columnMapper = {};
+    this._selectColumns = [];
+    this._distinct = false;
+    this._modifyCountQuery = null;
+    this._dialect = dialect;
+  }
+  baseQuery(template) {
+    this._baseQueryTemplate = template;
+    return this;
+  }
+  columnMapper(mapper) {
+    this._columnMapper = mapper;
+    return this;
+  }
+  select(columns) {
+    this._selectColumns = columns;
+    return this;
+  }
+  where(criteria) {
+    const items = Array.isArray(criteria) ? criteria : [criteria];
+    this._whereParams.push(...items);
+    return this;
+  }
+  textSearch(criteria) {
+    const items = Array.isArray(criteria) ? criteria : [criteria];
+    this._textSearchParams.push(...items);
+    return this;
+  }
+  having(criteria) {
+    const items = Array.isArray(criteria) ? criteria : [criteria];
+    items.forEach((c) => c.having = true);
+    this._whereParams.push(...items);
+    return this;
+  }
+  orderBy(sort) {
+    const items = Array.isArray(sort) ? sort : [sort];
+    this._sortBy.push(...items);
+    return this;
+  }
+  sortBy(key, direction = "ASC") {
+    this._sortBy.push({ key, direction });
+    return this;
+  }
+  paginate(page, size) {
+    this._page = page;
+    this._size = size;
+    return this;
+  }
+  distinct(enabled = true) {
+    this._distinct = enabled;
+    return this;
+  }
+  modifyCountQuery(fn) {
+    this._modifyCountQuery = fn;
+    return this;
+  }
+  build() {
+    if (!this._baseQueryTemplate) {
+      throw new Error("baseQuery() must be called before build()");
+    }
+    return buildQueries({
+      baseQueryTemplate: this._baseQueryTemplate,
+      whereParams: this._whereParams,
+      textSearchParams: this._textSearchParams,
+      sortBy: this._sortBy,
+      page: this._page,
+      size: this._size,
+      columnMapper: this._columnMapper,
+      selectColumns: this._selectColumns,
+      distinct: this._distinct,
+      modifyCountQuery: this._modifyCountQuery,
+      dialect: this._dialect
+    });
+  }
+  reset() {
+    this._baseQueryTemplate = "";
+    this._whereParams = [];
+    this._textSearchParams = [];
+    this._sortBy = [];
+    this._page = 0;
+    this._size = 0;
+    this._columnMapper = {};
+    this._selectColumns = [];
+    this._distinct = false;
+    this._modifyCountQuery = null;
+    return this;
+  }
+};
+export {
+  BaseDialect,
+  MSSQLDialect,
+  MySQLDialect,
+  PostgresDialect,
+  QueryBuilder,
+  SQLiteDialect,
+  buildQueries,
+  createDialect
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/dialects/base.dialect.ts","../src/dialects/postgres.dialect.ts","../src/dialects/mysql.dialect.ts","../src/dialects/sqlite.dialect.ts","../src/dialects/mssql.dialect.ts","../src/dialects/index.ts","../src/utils/helpers.ts","../src/builder/clause-builder.ts","../src/builder/build-queries.ts","../src/builder/query-builder.ts"],"sourcesContent":["import { Dialect, DialectName } from '../types';\n\nexport abstract class BaseDialect implements Dialect {\n  abstract name: DialectName;\n  abstract placeholder(position: number): string;\n  abstract quoteIdentifier(identifier: string): string;\n\n  lowerFunction(column: string): string {\n    return `LOWER(${column})`;\n  }\n\n  lowerValue(value: string): string {\n    return value.toLowerCase();\n  }\n\n  requiresOrderByForPagination: boolean = false;\n  mergesPaginationWithOrderBy: boolean = false;\n\n  paginationClause(page: number, size: number): string {\n    if (!page || !size) {\n      return '';\n    }\n    const offset = (page - 1) * size;\n    return `LIMIT ${size} OFFSET ${offset}`;\n  }\n\n  orderByWithPagination(orderClause: string, page: number, size: number): string {\n    const pagination = this.paginationClause(page, size);\n    return [orderClause, pagination].filter(Boolean).join(' ');\n  }\n}\n","import { DialectName } from '../types';\nimport { BaseDialect } from './base.dialect';\n\nexport class PostgresDialect extends BaseDialect {\n  name: DialectName = 'postgres';\n\n  placeholder(position: number): string {\n    return `$${position}`;\n  }\n\n  quoteIdentifier(identifier: string): string {\n    return `\"${identifier}\"`;\n  }\n}\n","import { DialectName } from '../types';\nimport { BaseDialect } from './base.dialect';\n\nexport class MySQLDialect extends BaseDialect {\n  name: DialectName = 'mysql';\n\n  placeholder(_position: number): string {\n    return '?';\n  }\n\n  quoteIdentifier(identifier: string): string {\n    return `\\`${identifier}\\``;\n  }\n\n  lowerFunction(column: string): string {\n    return column;\n  }\n\n  lowerValue(value: string): string {\n    return value;\n  }\n}\n","import { DialectName } from '../types';\nimport { BaseDialect } from './base.dialect';\n\nexport class SQLiteDialect extends BaseDialect {\n  name: DialectName = 'sqlite';\n\n  placeholder(_position: number): string {\n    return '?';\n  }\n\n  quoteIdentifier(identifier: string): string {\n    return `\"${identifier}\"`;\n  }\n}\n","import { DialectName } from '../types';\nimport { BaseDialect } from './base.dialect';\n\nexport class MSSQLDialect extends BaseDialect {\n  name: DialectName = 'mssql';\n  requiresOrderByForPagination: boolean = true;\n  mergesPaginationWithOrderBy: boolean = true;\n\n  placeholder(position: number): string {\n    return `@p${position}`;\n  }\n\n  quoteIdentifier(identifier: string): string {\n    return `[${identifier}]`;\n  }\n\n  paginationClause(page: number, size: number): string {\n    if (!page || !size) {\n      return '';\n    }\n    const offset = (page - 1) * size;\n    return `OFFSET ${offset} ROWS FETCH NEXT ${size} ROWS ONLY`;\n  }\n\n  orderByWithPagination(orderClause: string, page: number, size: number): string {\n    const pagination = this.paginationClause(page, size);\n    if (!pagination) {\n      return orderClause;\n    }\n    if (!orderClause) {\n      return `ORDER BY (SELECT NULL) ${pagination}`;\n    }\n    return `${orderClause} ${pagination}`;\n  }\n}\n","import { Dialect, DialectName } from '../types';\nimport { PostgresDialect } from './postgres.dialect';\nimport { MySQLDialect } from './mysql.dialect';\nimport { SQLiteDialect } from './sqlite.dialect';\nimport { MSSQLDialect } from './mssql.dialect';\n\nconst dialects: Record<DialectName, () => Dialect> = {\n  postgres: () => new PostgresDialect(),\n  mysql: () => new MySQLDialect(),\n  sqlite: () => new SQLiteDialect(),\n  mssql: () => new MSSQLDialect(),\n};\n\nexport function createDialect(name: DialectName): Dialect {\n  const factory = dialects[name];\n  if (!factory) {\n    const supported = Object.keys(dialects).join(', ');\n    throw new Error(\n      `Unsupported dialect: \"${name}\". Supported dialects: ${supported}`\n    );\n  }\n  return factory();\n}\n\nexport { PostgresDialect } from './postgres.dialect';\nexport { MySQLDialect } from './mysql.dialect';\nexport { SQLiteDialect } from './sqlite.dialect';\nexport { MSSQLDialect } from './mssql.dialect';\nexport { BaseDialect } from './base.dialect';\n","import { Dialect } from '../types';\n\nexport function addQuotesIfMissing(str: string, dialect: Dialect): string {\n  if (\n    (str.startsWith('\"') && str.endsWith('\"')) ||\n    (str.startsWith('`') && str.endsWith('`')) ||\n    (str.startsWith('[') && str.endsWith(']'))\n  ) {\n    return str;\n  }\n  if (str.includes('.')) {\n    return str;\n  }\n  return dialect.quoteIdentifier(str);\n}\n\nexport function getKey(\n  columnMapper: { [key: string]: string },\n  key: string,\n  dialect: Dialect\n): string {\n  return columnMapper[key] || addQuotesIfMissing(key, dialect);\n}\n","import { Criteria, SortCriteria, ColumnMapper, Dialect } from '../types';\nimport { getKey } from '../utils/helpers';\n\nexport function prepareClause(\n  criteria: Criteria,\n  params: any[],\n  columnMapper: ColumnMapper,\n  dialect: Dialect\n): string {\n  const key = getKey(columnMapper, criteria.key, dialect);\n  const operation = criteria.operation.toUpperCase();\n  const value = criteria.value;\n  const ignoreCase = criteria.ignoreCase || false;\n\n  switch (operation) {\n    case 'EQ':\n      params.push(value);\n      return `${key} = ${dialect.placeholder(params.length)}`;\n    case 'NEQ':\n      params.push(value);\n      return `${key} <> ${dialect.placeholder(params.length)}`;\n    case 'LIKE': {\n      params.push(ignoreCase ? dialect.lowerValue(value) : value);\n      const col = ignoreCase ? dialect.lowerFunction(key) : key;\n      return `${col} LIKE ${dialect.placeholder(params.length)}`;\n    }\n    case 'NOT_LIKE': {\n      params.push(ignoreCase ? dialect.lowerValue(value) : value);\n      const col = ignoreCase ? dialect.lowerFunction(key) : key;\n      return `${col} NOT LIKE ${dialect.placeholder(params.length)}`;\n    }\n    case 'GT':\n      params.push(value);\n      return `${key} > ${dialect.placeholder(params.length)}`;\n    case 'LT':\n      params.push(value);\n      return `${key} < ${dialect.placeholder(params.length)}`;\n    case 'GTE':\n      params.push(value);\n      return `${key} >= ${dialect.placeholder(params.length)}`;\n    case 'LTE':\n      params.push(value);\n      return `${key} <= ${dialect.placeholder(params.length)}`;\n    case 'IN': {\n      const values = value as any[];\n      const placeholders = values\n        .map((_, i) => dialect.placeholder(params.length + i + 1))\n        .join(', ');\n      params.push(...values);\n      return `${key} IN (${placeholders})`;\n    }\n    case 'NULL':\n      return `${key} IS NULL`;\n    case 'NOT_NULL':\n      return `${key} IS NOT NULL`;\n    default:\n      throw new Error(`Unsupported operation: ${operation}`);\n  }\n}\n\nexport function prepareWhereClause(\n  whereParams: Criteria[],\n  textSearchParams: Criteria[],\n  params: any[],\n  columnMapper: ColumnMapper,\n  dialect: Dialect\n): string {\n  const clauses: string[] = [];\n\n  if (textSearchParams.length > 0) {\n    const orGroup = textSearchParams\n      .map((c) => prepareClause(c, params, columnMapper, dialect))\n      .join(' OR ');\n    clauses.push(`(${orGroup})`);\n  }\n\n  for (const criteria of whereParams) {\n    const clause = prepareClause(criteria, params, columnMapper, dialect);\n    clauses.push(clause);\n  }\n\n  return clauses.length > 0 ? ` WHERE ${clauses.join(' AND ')}` : '';\n}\n\nexport function prepareHavingClause(\n  havingParams: Criteria[],\n  params: any[],\n  columnMapper: ColumnMapper,\n  dialect: Dialect\n): string {\n  const clauses: string[] = [];\n  for (const criteria of havingParams) {\n    const clause = prepareClause(criteria, params, columnMapper, dialect);\n    clauses.push(clause);\n  }\n  return clauses.length > 0 ? ` HAVING ${clauses.join(' AND ')}` : '';\n}\n\nfunction addQuotesIfMissingForSelect(str: string, dialect: Dialect): string {\n  if (\n    str.includes('.') ||\n    (str.startsWith('\"') && str.endsWith('\"')) ||\n    (str.startsWith('`') && str.endsWith('`')) ||\n    (str.startsWith('[') && str.endsWith(']'))\n  ) {\n    return str;\n  }\n  return dialect.quoteIdentifier(str);\n}\n\nexport function prepareSelect(\n  columnMapper: ColumnMapper,\n  selectColumns: string[],\n  distinct: boolean,\n  dialect: Dialect\n): string {\n  const columns =\n    selectColumns.length > 0\n      ? selectColumns\n          .map((col) => {\n            const actualCol = columnMapper[col] || col;\n            return columnMapper[col]\n              ? `${actualCol} AS ${dialect.quoteIdentifier(col)}`\n              : addQuotesIfMissingForSelect(actualCol, dialect);\n          })\n          .join(', ')\n      : '*';\n\n  return distinct ? `DISTINCT ${columns}` : columns;\n}\n\nexport function prepareOrderClause(\n  sortBy: SortCriteria[],\n  columnMapper: ColumnMapper,\n  dialect: Dialect\n): string {\n  return sortBy.length > 0\n    ? 'ORDER BY ' +\n        sortBy\n          .map((s) => `${getKey(columnMapper, s.key, dialect)} ${s.direction}`)\n          .join(', ')\n    : '';\n}\n","import {\n  Criteria,\n  SortCriteria,\n  ColumnMapper,\n  BuildResult,\n  BuildOptions,\n  DialectName,\n} from '../types';\nimport { createDialect } from '../dialects';\nimport {\n  prepareWhereClause,\n  prepareHavingClause,\n  prepareSelect,\n  prepareOrderClause,\n} from './clause-builder';\n\nexport function buildQueries(options: BuildOptions): BuildResult;\nexport function buildQueries(\n  baseQueryTemplate: string,\n  whereParams?: Criteria[],\n  textSearchParams?: Criteria[],\n  sortBy?: SortCriteria[],\n  page?: number,\n  size?: number,\n  columnMapper?: ColumnMapper,\n  selectColumns?: string[],\n  distinct?: boolean,\n  modifyCountQuery?: ((query: string) => string) | null,\n  dialectOptions?: { dialect?: DialectName }\n): BuildResult;\n\nexport function buildQueries(\n  baseQueryTemplateOrOptions: string | BuildOptions,\n  whereParams: Criteria[] = [],\n  textSearchParams: Criteria[] = [],\n  sortBy: SortCriteria[] = [],\n  page: number = 0,\n  size: number = 10,\n  columnMapper: ColumnMapper = {},\n  selectColumns: string[] = [],\n  distinct: boolean = false,\n  modifyCountQuery: ((query: string) => string) | null = null,\n  dialectOptions?: { dialect?: DialectName }\n): BuildResult {\n  let baseQueryTemplate: string;\n  let dialectName: DialectName;\n\n  if (typeof baseQueryTemplateOrOptions === 'object') {\n    const opts = baseQueryTemplateOrOptions;\n    baseQueryTemplate = opts.baseQueryTemplate;\n    whereParams = opts.whereParams || [];\n    textSearchParams = opts.textSearchParams || [];\n    sortBy = opts.sortBy || [];\n    page = opts.page || 0;\n    size = opts.size || 10;\n    columnMapper = opts.columnMapper || {};\n    selectColumns = opts.selectColumns || [];\n    distinct = opts.distinct || false;\n    modifyCountQuery = opts.modifyCountQuery || null;\n    dialectName = opts.dialect || 'postgres';\n  } else {\n    baseQueryTemplate = baseQueryTemplateOrOptions;\n    dialectName = dialectOptions?.dialect || 'postgres';\n  }\n\n  const dialect = createDialect(dialectName);\n\n  const params: any[] = [];\n  const havingCriteria = whereParams.filter((w) => w.having);\n  const whereCriteria = whereParams.filter((w) => !w.having);\n\n  const whereClause = prepareWhereClause(\n    whereCriteria,\n    textSearchParams,\n    params,\n    columnMapper,\n    dialect\n  );\n  const havingClause = prepareHavingClause(havingCriteria, params, columnMapper, dialect);\n  const orderClause = prepareOrderClause(sortBy, columnMapper, dialect);\n\n  let orderAndPagination: string;\n  let limitClause: string;\n\n  if (dialect.mergesPaginationWithOrderBy) {\n    orderAndPagination = dialect.orderByWithPagination(orderClause, page, size);\n    limitClause = '';\n  } else {\n    orderAndPagination = orderClause;\n    limitClause = dialect.paginationClause(page, size);\n    if (limitClause) {\n      limitClause = ` ${limitClause}`;\n    }\n  }\n\n  const searchQuery = baseQueryTemplate\n    .replace(\n      '/*SELECT_COLUMNS*/',\n      prepareSelect(columnMapper, selectColumns, distinct, dialect)\n    )\n    .replace('/*WHERE_CLAUSE*/', whereClause)\n    .replace('/*HAVING_CLAUSE*/', havingClause)\n    .replace('/*ORDER_BY*/', orderAndPagination)\n    .replace('/*LIMIT_CLAUSE*/', limitClause)\n    .trim();\n\n  const distinctClause =\n    distinct && selectColumns.length > 0\n      ? 'DISTINCT (' +\n        selectColumns\n          .map((col) => columnMapper[col] || col)\n          .join(', ') +\n        ')'\n      : '1';\n  const countExpr = modifyCountQuery ? '1' : `COUNT(${distinctClause}) AS count`;\n\n  let countQuery = baseQueryTemplate\n    .replace('/*SELECT_COLUMNS*/', countExpr)\n    .replace('/*WHERE_CLAUSE*/', whereClause)\n    .replace('/*HAVING_CLAUSE*/', havingClause)\n    .replace('/*ORDER_BY*/', '')\n    .replace('/*LIMIT_CLAUSE*/', '')\n    .trim();\n\n  if (modifyCountQuery) {\n    countQuery = modifyCountQuery(countQuery);\n  }\n\n  return { searchQuery, countQuery, params };\n}\n","import {\n  Criteria,\n  SortCriteria,\n  ColumnMapper,\n  BuildResult,\n  DialectName,\n  SortDirection,\n} from '../types';\nimport { buildQueries } from './build-queries';\n\nexport class QueryBuilder {\n  private _dialect: DialectName;\n  private _baseQueryTemplate: string = '';\n  private _whereParams: Criteria[] = [];\n  private _textSearchParams: Criteria[] = [];\n  private _sortBy: SortCriteria[] = [];\n  private _page: number = 0;\n  private _size: number = 0;\n  private _columnMapper: ColumnMapper = {};\n  private _selectColumns: string[] = [];\n  private _distinct: boolean = false;\n  private _modifyCountQuery: ((query: string) => string) | null = null;\n\n  constructor(dialect: DialectName = 'postgres') {\n    this._dialect = dialect;\n  }\n\n  baseQuery(template: string): this {\n    this._baseQueryTemplate = template;\n    return this;\n  }\n\n  columnMapper(mapper: ColumnMapper): this {\n    this._columnMapper = mapper;\n    return this;\n  }\n\n  select(columns: string[]): this {\n    this._selectColumns = columns;\n    return this;\n  }\n\n  where(criteria: Criteria | Criteria[]): this {\n    const items = Array.isArray(criteria) ? criteria : [criteria];\n    this._whereParams.push(...items);\n    return this;\n  }\n\n  textSearch(criteria: Criteria | Criteria[]): this {\n    const items = Array.isArray(criteria) ? criteria : [criteria];\n    this._textSearchParams.push(...items);\n    return this;\n  }\n\n  having(criteria: Criteria | Criteria[]): this {\n    const items = Array.isArray(criteria) ? criteria : [criteria];\n    items.forEach((c) => (c.having = true));\n    this._whereParams.push(...items);\n    return this;\n  }\n\n  orderBy(sort: SortCriteria | SortCriteria[]): this {\n    const items = Array.isArray(sort) ? sort : [sort];\n    this._sortBy.push(...items);\n    return this;\n  }\n\n  sortBy(key: string, direction: SortDirection = 'ASC'): this {\n    this._sortBy.push({ key, direction });\n    return this;\n  }\n\n  paginate(page: number, size: number): this {\n    this._page = page;\n    this._size = size;\n    return this;\n  }\n\n  distinct(enabled: boolean = true): this {\n    this._distinct = enabled;\n    return this;\n  }\n\n  modifyCountQuery(fn: (query: string) => string): this {\n    this._modifyCountQuery = fn;\n    return this;\n  }\n\n  build(): BuildResult {\n    if (!this._baseQueryTemplate) {\n      throw new Error('baseQuery() must be called before build()');\n    }\n\n    return buildQueries({\n      baseQueryTemplate: this._baseQueryTemplate,\n      whereParams: this._whereParams,\n      textSearchParams: this._textSearchParams,\n      sortBy: this._sortBy,\n      page: this._page,\n      size: this._size,\n      columnMapper: this._columnMapper,\n      selectColumns: this._selectColumns,\n      distinct: this._distinct,\n      modifyCountQuery: this._modifyCountQuery,\n      dialect: this._dialect,\n    });\n  }\n\n  reset(): this {\n    this._baseQueryTemplate = '';\n    this._whereParams = [];\n    this._textSearchParams = [];\n    this._sortBy = [];\n    this._page = 0;\n    this._size = 0;\n    this._columnMapper = {};\n    this._selectColumns = [];\n    this._distinct = false;\n    this._modifyCountQuery = null;\n    return this;\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "sql-flex-query",
+  "version": "1.0.0",
+  "description": "A lightweight, dialect-aware SQL query builder that enhances base query templates with dynamic WHERE, HAVING, ORDER BY, pagination, and more.",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "import": "./dist/index.mjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "keywords": [
+    "sql",
+    "query-builder",
+    "postgres",
+    "mysql",
+    "sqlite",
+    "mssql",
+    "pagination"
+  ],
+  "author": "Ashish Lohia",
+  "license": "MIT",
+  "devDependencies": {
+    "tsup": "^8.4.0",
+    "typescript": "^5.7.3",
+    "vitest": "^4.0.18"
+  }
+}