@ruiapp/rapid-core 0.9.9 → 0.10.1

package/src/queryBuilder/queryBuilder.ts

@@ -1,755 +1,755 @@
-import { find, isBoolean, isNil, isNull, isNumber, isString, isUndefined } from "lodash";
-import { RpdDataModel, RpdDataModelProperty, CreateEntityOptions, QuoteTableOptions, DatabaseQuery, IQueryBuilder } from "../types";
-import {
-  CountRowOptions,
-  DeleteRowOptions,
-  FindRowLogicalFilterOptions,
-  FindRowRelationalFilterOptions,
-  FindRowSetFilterOptions,
-  FindRowUnaryFilterOptions,
-  FindRowOptions,
-  RowFilterOptions,
-  RowFilterRelationalOperators,
-  UpdateRowOptions,
-  ColumnSelectOptions,
-  ColumnNameWithTableName,
-  DataAccessPgColumnTypes,
-  FindRowArrayFilterOptions,
-  FindRowRangeFilterOptions,
-} from "~/dataAccess/dataAccessTypes";
-import { pgPropertyTypeColumnMap } from "~/dataAccess/columnTypeMapper";
-
-const objLeftQuoteChar = '"';
-const objRightQuoteChar = '"';
-
-const relationalOperatorsMap = new Map<RowFilterRelationalOperators, string>([
-  ["eq", "="],
-  ["ne", "<>"],
-  ["gt", ">"],
-  ["gte", ">="],
-  ["lt", "<"],
-  ["lte", "<="],
-]);
-
-export interface BuildQueryContext {
-  model: RpdDataModel;
-  builder: QueryBuilder;
-  params: any[];
-  emitTableAlias: boolean;
-  /**
-   * emit parameter value to sql literal.
-   */
-  paramToLiteral: boolean;
-}
-
-export interface InitQueryBuilderOptions {
-  dbDefaultSchema: string;
-}
-
-export default class QueryBuilder implements IQueryBuilder {
-  #dbDefaultSchema: string;
-
-  constructor(options: InitQueryBuilderOptions) {
-    this.#dbDefaultSchema = options.dbDefaultSchema;
-  }
-
-  quoteTable(options: QuoteTableOptions) {
-    const { schema, tableName } = options;
-    if (schema) {
-      return `${this.quoteObject(schema)}.${this.quoteObject(tableName)}`;
-    } else if (this.#dbDefaultSchema) {
-      return `${this.quoteObject(this.#dbDefaultSchema)}.${this.quoteObject(tableName)}`;
-    } else {
-      return this.quoteObject(tableName);
-    }
-  }
-
-  quoteObject(name: string) {
-    return `${objLeftQuoteChar}${name}${objRightQuoteChar}`;
-  }
-
-  quoteColumn(model: RpdDataModel, column: ColumnSelectOptions, emitTableAlias: boolean) {
-    if (typeof column === "string") {
-      if (emitTableAlias) {
-        return `${objLeftQuoteChar}${model.tableName}${objRightQuoteChar}.${objLeftQuoteChar}${column}${objRightQuoteChar}`;
-      } else {
-        return `${objLeftQuoteChar}${column}${objRightQuoteChar}`;
-      }
-    } else {
-      if (emitTableAlias && column.tableName) {
-        return `${objLeftQuoteChar}${column.tableName}${objRightQuoteChar}.${objLeftQuoteChar}${column.name}${objRightQuoteChar}`;
-      } else {
-        return `${objLeftQuoteChar}${column.name}${objRightQuoteChar}`;
-      }
-    }
-  }
-
-  formatValueToSqlLiteral(value: any) {
-    return formatValueToSqlLiteral(value);
-  }
-
-  select(model: RpdDataModel, options: FindRowOptions): DatabaseQuery {
-    const ctx: BuildQueryContext = {
-      model,
-      builder: this,
-      params: [],
-      emitTableAlias: true,
-      paramToLiteral: false,
-    };
-    let { fields: columns, filters, orderBy, pagination } = options;
-    let command = "SELECT ";
-    if (!columns || !columns.length) {
-      command += `${this.quoteObject(model.tableName)}.* FROM `;
-    } else {
-      command += columns.map((column) => this.quoteColumn(ctx.model, column, ctx.emitTableAlias)).join(", ");
-      command += " FROM ";
-    }
-
-    command += this.quoteTable(model);
-
-    if (options.orderBy) {
-      options.orderBy
-        .filter((orderByItem) => orderByItem.relationField)
-        .forEach((orderByItem) => {
-          const { relationField } = orderByItem;
-          const orderField = orderByItem.field as ColumnNameWithTableName;
-          command += ` LEFT JOIN ${this.quoteTable({ schema: orderField.schema, tableName: orderField.tableName })} ON ${this.quoteObject(
-            orderField.tableName,
-          )}.id = ${this.quoteObject(relationField.tableName)}.${this.quoteObject(relationField.name)}`;
-        });
-    }
-
-    if (filters && filters.length) {
-      command += " WHERE ";
-      command += buildFiltersQuery(ctx, filters);
-    }
-
-    if (orderBy && orderBy.length) {
-      command += " ORDER BY ";
-      command += orderBy
-        .map((item) => {
-          const quotedName = this.quoteColumn(ctx.model, item.field, ctx.emitTableAlias);
-          return item.desc ? quotedName + " DESC" : quotedName;
-        })
-        .join(", ");
-    }
-
-    if (pagination) {
-      command += " OFFSET ";
-      ctx.params.push(pagination.offset);
-      command += "$" + ctx.params.length;
-
-      command += " LIMIT ";
-      ctx.params.push(pagination.limit);
-      command += "$" + ctx.params.length;
-    }
-
-    return {
-      command,
-      params: ctx.params,
-    };
-  }
-
-  selectDerived(derivedModel: RpdDataModel, baseModel: RpdDataModel, options: FindRowOptions): DatabaseQuery {
-    const ctx: BuildQueryContext = {
-      model: derivedModel,
-      builder: this,
-      params: [],
-      emitTableAlias: true,
-      paramToLiteral: false,
-    };
-    let { fields: columns, filters, orderBy, pagination } = options;
-    let command = "SELECT ";
-    if (!columns || !columns.length) {
-      command += `${this.quoteObject(derivedModel.tableName)}.* FROM `;
-    } else {
-      command += columns
-        .map((column) => {
-          return this.quoteColumn(derivedModel, column, ctx.emitTableAlias);
-        })
-        .join(", ");
-      command += " FROM ";
-    }
-
-    command += `${this.quoteTable(derivedModel)} LEFT JOIN ${this.quoteTable(baseModel)} ON ${this.quoteObject(derivedModel.tableName)}.id = ${this.quoteObject(
-      baseModel.tableName,
-    )}.id`;
-
-    if (options.orderBy) {
-      options.orderBy
-        .filter((orderByItem) => orderByItem.relationField)
-        .forEach((orderByItem) => {
-          const { relationField } = orderByItem;
-          const orderField = orderByItem.field as ColumnNameWithTableName;
-          command += ` LEFT JOIN ${this.quoteTable({ schema: orderField.schema, tableName: orderField.tableName })} ON ${this.quoteObject(
-            orderField.tableName,
-          )}.id = ${this.quoteObject(relationField.tableName)}.${this.quoteObject(relationField.name)}`;
-        });
-    }
-
-    if (filters && filters.length) {
-      command += " WHERE ";
-      command += buildFiltersQuery(ctx, filters);
-    }
-
-    if (orderBy && orderBy.length) {
-      command += " ORDER BY ";
-      command += orderBy
-        .map((item) => {
-          const quotedName = this.quoteColumn(derivedModel, item.field, ctx.emitTableAlias);
-          return item.desc ? quotedName + " DESC" : quotedName;
-        })
-        .join(", ");
-    }
-
-    if (pagination) {
-      command += " OFFSET ";
-      ctx.params.push(pagination.offset);
-      command += "$" + ctx.params.length;
-
-      command += " LIMIT ";
-      ctx.params.push(pagination.limit);
-      command += "$" + ctx.params.length;
-    }
-
-    return {
-      command,
-      params: ctx.params,
-    };
-  }
-
-  count(model: RpdDataModel, options: CountRowOptions): DatabaseQuery {
-    const ctx: BuildQueryContext = {
-      model,
-      builder: this,
-      params: [],
-      emitTableAlias: false,
-      paramToLiteral: false,
-    };
-    let { filters } = options;
-    let command = 'SELECT COUNT(*)::int as "count" FROM ';
-
-    command += this.quoteTable(model);
-
-    if (filters && filters.length) {
-      command += " WHERE ";
-      command += buildFiltersQuery(ctx, filters);
-    }
-
-    return {
-      command,
-      params: ctx.params,
-    };
-  }
-
-  countDerived(derivedModel: RpdDataModel, baseModel: RpdDataModel, options: CountRowOptions): DatabaseQuery {
-    const ctx: BuildQueryContext = {
-      model: derivedModel,
-      builder: this,
-      params: [],
-      emitTableAlias: true,
-      paramToLiteral: false,
-    };
-    let { filters } = options;
-    let command = 'SELECT COUNT(*)::int as "count" FROM ';
-
-    command += `${this.quoteTable(derivedModel)} LEFT JOIN ${this.quoteTable(baseModel)} ON ${this.quoteObject(derivedModel.tableName)}.id = ${this.quoteObject(
-      baseModel.tableName,
-    )}.id`;
-
-    if (filters && filters.length) {
-      command += " WHERE ";
-      command += buildFiltersQuery(ctx, filters);
-    }
-
-    return {
-      command,
-      params: ctx.params,
-    };
-  }
-
-  insert(model: RpdDataModel, options: CreateEntityOptions): DatabaseQuery {
-    const params: any[] = [];
-    const ctx: BuildQueryContext = {
-      model,
-      builder: this,
-      params,
-      emitTableAlias: false,
-      paramToLiteral: false,
-    };
-    const { entity } = options;
-    let command = "INSERT INTO ";
-
-    command += this.quoteTable(model);
-
-    const columnNames: string[] = Object.keys(entity);
-    let values = "";
-    columnNames.forEach((columnName, index) => {
-      if (index) {
-        values += ", ";
-      }
-
-      let property: RpdDataModelProperty | null = null;
-      if (model) {
-        property = find(model.properties, (e: RpdDataModelProperty) => (e.columnName || e.code) === columnName);
-      }
-      const columnType: DataAccessPgColumnTypes | null = property ? pgPropertyTypeColumnMap[property.type] : null;
-      if (columnType === "jsonb") {
-        params.push(JSON.stringify(entity[columnName]));
-        values += `$${params.length}::jsonb`;
-      } else {
-        params.push(entity[columnName]);
-        values += `$${params.length}`;
-      }
-    });
-
-    command += ` (${columnNames.map(this.quoteObject).join(", ")})`;
-    command += ` VALUES (${values}) RETURNING *`;
-
-    return {
-      command,
-      params: ctx.params,
-    };
-  }
-
-  update(model: RpdDataModel, options: UpdateRowOptions): DatabaseQuery {
-    const params: any[] = [];
-    const ctx: BuildQueryContext = {
-      model,
-      builder: this,
-      params,
-      emitTableAlias: false,
-      paramToLiteral: false,
-    };
-    let { entity, filters } = options;
-    let command = "UPDATE ";
-
-    command += this.quoteTable(model);
-
-    command += " SET ";
-    const columnNames: string[] = Object.keys(entity);
-    columnNames.forEach((columnName, index) => {
-      if (index) {
-        command += ", ";
-      }
-
-      command += `${this.quoteObject(columnName)}=`;
-
-      let property: RpdDataModelProperty | null = null;
-      if (model) {
-        property = find(model.properties, (e: RpdDataModelProperty) => (e.columnName || e.code) === columnName);
-      }
-      const columnType: DataAccessPgColumnTypes | null = property ? pgPropertyTypeColumnMap[property.type] : null;
-      if (columnType === "jsonb") {
-        params.push(JSON.stringify(entity[columnName]));
-        command += `$${params.length}::jsonb`;
-      } else {
-        params.push(entity[columnName]);
-        command += `$${params.length}`;
-      }
-    });
-
-    if (filters && filters.length) {
-      command += " WHERE ";
-      command += buildFiltersQuery(ctx, filters);
-    }
-
-    command += " RETURNING *";
-
-    return {
-      command,
-      params: ctx.params,
-    };
-  }
-
-  delete(model: RpdDataModel, options: DeleteRowOptions): DatabaseQuery {
-    const params: any[] = [];
-    const ctx: BuildQueryContext = {
-      model,
-      builder: this,
-      params,
-      emitTableAlias: false,
-      paramToLiteral: false,
-    };
-    let { filters } = options;
-    let command = "DELETE FROM ";
-
-    command += this.quoteTable(model);
-
-    if (filters && filters.length) {
-      command += " WHERE ";
-      command += buildFiltersQuery(ctx, filters);
-    }
-
-    return {
-      command,
-      params: ctx.params,
-    };
-  }
-
-  buildFiltersExpression(model: RpdDataModel, filters: RowFilterOptions[]) {
-    const params: any[] = [];
-    const ctx: BuildQueryContext = {
-      model,
-      builder: this,
-      params,
-      emitTableAlias: false,
-      paramToLiteral: true,
-    };
-
-    return buildFiltersQuery(ctx, filters);
-  }
-}
-
-export function buildFiltersQuery(ctx: BuildQueryContext, filters: RowFilterOptions[]) {
-  return buildFilterQuery(0, ctx, {
-    operator: "and",
-    filters,
-  });
-}
-
-function buildFilterQuery(level: number, ctx: BuildQueryContext, filter: RowFilterOptions): string {
-  const { operator } = filter;
-  if (operator === "eq" || operator === "ne" || operator === "gt" || operator === "gte" || operator === "lt" || operator === "lte") {
-    return buildRelationalFilterQuery(ctx, filter);
-  } else if (operator === "and" || operator === "or") {
-    return buildLogicalFilterQuery(level, ctx, filter);
-  } else if (operator === "null" || operator === "notNull") {
-    return buildUnaryFilterQuery(ctx, filter);
-  } else if (operator === "in" || operator === "notIn") {
-    return buildInFilterQuery(ctx, filter);
-  } else if (operator === "between" || operator === "range") {
-    return buildRangeFilterQuery(ctx, filter);
-  } else if (operator === "matches") {
-    return buildMatchesFilterQuery(ctx, filter);
-  } else if (operator === "matchesCS") {
-    return buildMatchesCSFilterQuery(ctx, filter);
-  } else if (operator === "contains") {
-    return buildContainsFilterQuery(ctx, filter);
-  } else if (operator === "containsCS") {
-    return buildContainsCSFilterQuery(ctx, filter);
-  } else if (operator === "notContains") {
-    return buildNotContainsFilterQuery(ctx, filter);
-  } else if (operator === "notContainsCS") {
-    return buildNotContainsCSFilterQuery(ctx, filter);
-  } else if (operator === "startsWith") {
-    return buildStartsWithFilterQuery(ctx, filter);
-  } else if (operator === "notStartsWith") {
-    return buildNotStartsWithFilterQuery(ctx, filter);
-  } else if (operator === "endsWith") {
-    return buildEndsWithFilterQuery(ctx, filter);
-  } else if (operator === "notEndsWith") {
-    return buildNotEndsWithFilterQuery(ctx, filter);
-  } else if (operator === "arrayContains") {
-    return buildArrayContainsFilterQuery(ctx, filter);
-  } else if (operator === "arrayOverlap") {
-    return buildArrayOverlapFilterQuery(ctx, filter);
-  } else {
-    throw new Error(`Filter operator '${operator}' is not supported.`);
-  }
-}
-
-function buildLogicalFilterQuery(level: number, ctx: BuildQueryContext, filter: FindRowLogicalFilterOptions) {
-  let dbOperator;
-  if (filter.operator === "and") {
-    dbOperator = " AND ";
-  } else {
-    dbOperator = " OR ";
-  }
-
-  let command = filter.filters.map(buildFilterQuery.bind(null, level + 1, ctx)).join(dbOperator);
-  if (level) {
-    return `(${command})`;
-  }
-  return command;
-}
-
-function buildUnaryFilterQuery(ctx: BuildQueryContext, filter: FindRowUnaryFilterOptions) {
-  let command = ctx.builder.quoteColumn(ctx.model, filter.field, ctx.emitTableAlias);
-  if (filter.operator === "null") {
-    command += " IS NULL";
-  } else {
-    command += " IS NOT NULL";
-  }
-  return command;
-}
-
-function buildInFilterQuery(ctx: BuildQueryContext, filter: FindRowSetFilterOptions) {
-  let command = ctx.builder.quoteColumn(ctx.model, filter.field, ctx.emitTableAlias);
-
-  if (filter.operator === "in") {
-    command += " = ";
-  } else {
-    command += " <> ";
-  }
-
-  if (ctx.paramToLiteral) {
-    // TODO: implement it
-  } else {
-    ctx.params.push(filter.value);
-    if (filter.operator === "in") {
-      command += `ANY($${ctx.params.length}::${filter.itemType || "int"}[])`;
-    } else {
-      command += `ALL($${ctx.params.length}::${filter.itemType || "int"}[])`;
-    }
-  }
-
-  return command;
-}
-
-function buildRangeFilterQuery(ctx: BuildQueryContext, filter: FindRowRangeFilterOptions) {
-  let command = "";
-
-  if (filter.value.length != 2) {
-    throw new Error(`Filter operator '${filter.operator}' need two values.`);
-  }
-
-  if (filter.operator === "between") {
-    command += ctx.builder.quoteColumn(ctx.model, filter.field, ctx.emitTableAlias);
-
-    command += " BETWEEN ";
-
-    ctx.params.push(filter.value[0]);
-    command += `$${ctx.params.length}`;
-
-    command += " AND ";
-
-    ctx.params.push(filter.value[1]);
-    command += `$${ctx.params.length}`;
-  } else if (filter.operator === "range") {
-    ctx.params.push(filter.value[0]);
-    command += `(${ctx.builder.quoteColumn(ctx.model, filter.field, ctx.emitTableAlias)} >= $${ctx.params.length}`;
-
-    command += " AND ";
-
-    ctx.params.push(filter.value[1]);
-    command += `${ctx.builder.quoteColumn(ctx.model, filter.field, ctx.emitTableAlias)} < $${ctx.params.length})`;
-  } else {
-    throw new Error(`Filter operator '${filter.operator}' is not supported.`);
-  }
-
-  return command;
-}
-
-function convertSearchTextToLikeParamValue(searchText: string) {
-  if (isNil(searchText)) {
-    return searchText;
-  }
-
-  let result = searchText.replace(/\*/g, "%");
-  result = result.replace(/\?/g, "_");
-  return result;
-}
-
-function buildMatchesFilterQuery(ctx: BuildQueryContext, filter: FindRowRelationalFilterOptions) {
-  let command = ctx.builder.quoteColumn(ctx.model, filter.field, ctx.emitTableAlias);
-
-  command += " ILIKE ";
-
-  if (ctx.paramToLiteral) {
-    // TODO: implement it
-  } else {
-    ctx.params.push(`%${convertSearchTextToLikeParamValue(filter.value)}%`);
-    command += "$" + ctx.params.length;
-  }
-
-  return command;
-}
-
-function buildMatchesCSFilterQuery(ctx: BuildQueryContext, filter: FindRowRelationalFilterOptions) {
-  let command = ctx.builder.quoteColumn(ctx.model, filter.field, ctx.emitTableAlias);
-
-  command += " LIKE ";
-
-  if (ctx.paramToLiteral) {
-    // TODO: implement it
-  } else {
-    ctx.params.push(`%${convertSearchTextToLikeParamValue(filter.value)}%`);
-    command += "$" + ctx.params.length;
-  }
-
-  return command;
-}
-
-function buildContainsFilterQuery(ctx: BuildQueryContext, filter: FindRowRelationalFilterOptions) {
-  let command = ctx.builder.quoteColumn(ctx.model, filter.field, ctx.emitTableAlias);
-
-  command += " ILIKE ";
-
-  if (ctx.paramToLiteral) {
-    // TODO: implement it
-  } else {
-    ctx.params.push(`%${filter.value}%`);
-    command += "$" + ctx.params.length;
-  }
-
-  return command;
-}
-
-function buildContainsCSFilterQuery(ctx: BuildQueryContext, filter: FindRowRelationalFilterOptions) {
-  let command = ctx.builder.quoteColumn(ctx.model, filter.field, ctx.emitTableAlias);
-
-  command += " LIKE ";
-
-  if (ctx.paramToLiteral) {
-    // TODO: implement it
-  } else {
-    ctx.params.push(`%${filter.value}%`);
-    command += "$" + ctx.params.length;
-  }
-
-  return command;
-}
-
-function buildNotContainsFilterQuery(ctx: BuildQueryContext, filter: FindRowRelationalFilterOptions) {
-  let command = ctx.builder.quoteColumn(ctx.model, filter.field, ctx.emitTableAlias);
-
-  command += " NOT ILIKE ";
-  if (ctx.paramToLiteral) {
-    // TODO: implement it
-  } else {
-    ctx.params.push(`%${filter.value}%`);
-    command += "$" + ctx.params.length;
-  }
-
-  return command;
-}
-
-function buildNotContainsCSFilterQuery(ctx: BuildQueryContext, filter: FindRowRelationalFilterOptions) {
-  let command = ctx.builder.quoteColumn(ctx.model, filter.field, ctx.emitTableAlias);
-
-  command += " NOT LIKE ";
-  if (ctx.paramToLiteral) {
-    // TODO: implement it
-  } else {
-    ctx.params.push(`%${filter.value}%`);
-    command += "$" + ctx.params.length;
-  }
-
-  return command;
-}
-
-function buildStartsWithFilterQuery(ctx: BuildQueryContext, filter: FindRowRelationalFilterOptions) {
-  let command = ctx.builder.quoteColumn(ctx.model, filter.field, ctx.emitTableAlias);
-
-  command += " ILIKE ";
-
-  if (ctx.paramToLiteral) {
-    // TODO: implement it
-  } else {
-    ctx.params.push(`${filter.value}%`);
-    command += "$" + ctx.params.length;
-  }
-
-  return command;
-}
-
-function buildNotStartsWithFilterQuery(ctx: BuildQueryContext, filter: FindRowRelationalFilterOptions) {
-  let command = ctx.builder.quoteColumn(ctx.model, filter.field, ctx.emitTableAlias);
-
-  command += " NOT ILIKE ";
-
-  if (ctx.paramToLiteral) {
-    // TODO: implement it
-  } else {
-    ctx.params.push(`${filter.value}%`);
-    command += "$" + ctx.params.length;
-  }
-
-  return command;
-}
-
-function buildEndsWithFilterQuery(ctx: BuildQueryContext, filter: FindRowRelationalFilterOptions) {
-  let command = ctx.builder.quoteColumn(ctx.model, filter.field, ctx.emitTableAlias);
-
-  command += " ILIKE ";
-
-  if (ctx.paramToLiteral) {
-    // TODO: implement it
-  } else {
-    ctx.params.push(`%${filter.value}`);
-    command += "$" + ctx.params.length;
-  }
-
-  return command;
-}
-
-function buildNotEndsWithFilterQuery(ctx: BuildQueryContext, filter: FindRowRelationalFilterOptions) {
-  let command = ctx.builder.quoteColumn(ctx.model, filter.field, ctx.emitTableAlias);
-
-  command += " NOT ILIKE ";
-
-  if (ctx.paramToLiteral) {
-    // TODO: implement it
-  } else {
-    ctx.params.push(`%${filter.value}`);
-    command += "$" + ctx.params.length;
-  }
-
-  return command;
-}
-
-function buildRelationalFilterQuery(ctx: BuildQueryContext, filter: FindRowRelationalFilterOptions) {
-  let command = ctx.builder.quoteColumn(ctx.model, filter.field, ctx.emitTableAlias);
-
-  command += relationalOperatorsMap.get(filter.operator);
-
-  if (ctx.paramToLiteral) {
-    command += formatValueToSqlLiteral(filter.value);
-  } else {
-    ctx.params.push(filter.value);
-    command += "$" + ctx.params.length;
-  }
-
-  return command;
-}
-
-function buildArrayContainsFilterQuery(ctx: BuildQueryContext, filter: FindRowArrayFilterOptions) {
-  let command = ctx.builder.quoteColumn(ctx.model, filter.field, ctx.emitTableAlias);
-
-  command += " @> ";
-
-  if (ctx.paramToLiteral) {
-    // TODO: implement it
-  } else {
-    ctx.params.push(filter.value);
-    command += "$" + ctx.params.length;
-  }
-
-  return command;
-}
-
-function buildArrayOverlapFilterQuery(ctx: BuildQueryContext, filter: FindRowArrayFilterOptions) {
-  let command = ctx.builder.quoteColumn(ctx.model, filter.field, ctx.emitTableAlias);
-
-  command += " && ";
-
-  if (ctx.paramToLiteral) {
-    // TODO: implement it
-  } else {
-    ctx.params.push(filter.value);
-    command += "$" + ctx.params.length;
-  }
-
-  return command;
-}
-
-function formatValueToSqlLiteral(value: any) {
-  if (isNull(value) || isUndefined(value)) {
-    return "null";
-  }
-
-  if (isString(value)) {
-    return `'${value.replaceAll("'", "''")}'`;
-  }
-
-  if (isBoolean(value)) {
-    return value ? "true" : "false";
-  }
-
-  if (isNumber(value)) {
-    return value.toString();
-  }
-
-  return `'${value.toString().replaceAll("'", "''")}'`;
-}
+import { find, isBoolean, isNil, isNull, isNumber, isString, isUndefined } from "lodash";
+import { RpdDataModel, RpdDataModelProperty, CreateEntityOptions, QuoteTableOptions, DatabaseQuery, IQueryBuilder } from "../types";
+import {
+  CountRowOptions,
+  DeleteRowOptions,
+  FindRowLogicalFilterOptions,
+  FindRowRelationalFilterOptions,
+  FindRowSetFilterOptions,
+  FindRowUnaryFilterOptions,
+  FindRowOptions,
+  RowFilterOptions,
+  RowFilterRelationalOperators,
+  UpdateRowOptions,
+  ColumnSelectOptions,
+  ColumnNameWithTableName,
+  DataAccessPgColumnTypes,
+  FindRowArrayFilterOptions,
+  FindRowRangeFilterOptions,
+} from "~/dataAccess/dataAccessTypes";
+import { pgPropertyTypeColumnMap } from "~/dataAccess/columnTypeMapper";
+
+const objLeftQuoteChar = '"';
+const objRightQuoteChar = '"';
+
+const relationalOperatorsMap = new Map<RowFilterRelationalOperators, string>([
+  ["eq", "="],
+  ["ne", "<>"],
+  ["gt", ">"],
+  ["gte", ">="],
+  ["lt", "<"],
+  ["lte", "<="],
+]);
+
+export interface BuildQueryContext {
+  model: RpdDataModel;
+  builder: QueryBuilder;
+  params: any[];
+  emitTableAlias: boolean;
+  /**
+   * emit parameter value to sql literal.
+   */
+  paramToLiteral: boolean;
+}
+
+export interface InitQueryBuilderOptions {
+  dbDefaultSchema: string;
+}
+
+export default class QueryBuilder implements IQueryBuilder {
+  #dbDefaultSchema: string;
+
+  constructor(options: InitQueryBuilderOptions) {
+    this.#dbDefaultSchema = options.dbDefaultSchema;
+  }
+
+  quoteTable(options: QuoteTableOptions) {
+    const { schema, tableName } = options;
+    if (schema) {
+      return `${this.quoteObject(schema)}.${this.quoteObject(tableName)}`;
+    } else if (this.#dbDefaultSchema) {
+      return `${this.quoteObject(this.#dbDefaultSchema)}.${this.quoteObject(tableName)}`;
+    } else {
+      return this.quoteObject(tableName);
+    }
+  }
+
+  quoteObject(name: string) {
+    return `${objLeftQuoteChar}${name}${objRightQuoteChar}`;
+  }
+
+  quoteColumn(model: RpdDataModel, column: ColumnSelectOptions, emitTableAlias: boolean) {
+    if (typeof column === "string") {
+      if (emitTableAlias) {
+        return `${objLeftQuoteChar}${model.tableName}${objRightQuoteChar}.${objLeftQuoteChar}${column}${objRightQuoteChar}`;
+      } else {
+        return `${objLeftQuoteChar}${column}${objRightQuoteChar}`;
+      }
+    } else {
+      if (emitTableAlias && column.tableName) {
+        return `${objLeftQuoteChar}${column.tableName}${objRightQuoteChar}.${objLeftQuoteChar}${column.name}${objRightQuoteChar}`;
+      } else {
+        return `${objLeftQuoteChar}${column.name}${objRightQuoteChar}`;
+      }
+    }
+  }
+
+  formatValueToSqlLiteral(value: any) {
+    return formatValueToSqlLiteral(value);
+  }
+
+  select(model: RpdDataModel, options: FindRowOptions): DatabaseQuery {
+    const ctx: BuildQueryContext = {
+      model,
+      builder: this,
+      params: [],
+      emitTableAlias: true,
+      paramToLiteral: false,
+    };
+    let { fields: columns, filters, orderBy, pagination } = options;
+    let command = "SELECT ";
+    if (!columns || !columns.length) {
+      command += `${this.quoteObject(model.tableName)}.* FROM `;
+    } else {
+      command += columns.map((column) => this.quoteColumn(ctx.model, column, ctx.emitTableAlias)).join(", ");
+      command += " FROM ";
+    }
+
+    command += this.quoteTable(model);
+
+    if (options.orderBy) {
+      options.orderBy
+        .filter((orderByItem) => orderByItem.relationField)
+        .forEach((orderByItem) => {
+          const { relationField } = orderByItem;
+          const orderField = orderByItem.field as ColumnNameWithTableName;
+          command += ` LEFT JOIN ${this.quoteTable({ schema: orderField.schema, tableName: orderField.tableName })} ON ${this.quoteObject(
+            orderField.tableName,
+          )}.id = ${this.quoteObject(relationField.tableName)}.${this.quoteObject(relationField.name)}`;
+        });
+    }
+
+    if (filters && filters.length) {
+      command += " WHERE ";
+      command += buildFiltersQuery(ctx, filters);
+    }
+
+    if (orderBy && orderBy.length) {
+      command += " ORDER BY ";
+      command += orderBy
+        .map((item) => {
+          const quotedName = this.quoteColumn(ctx.model, item.field, ctx.emitTableAlias);
+          return item.desc ? quotedName + " DESC" : quotedName;
+        })
+        .join(", ");
+    }
+
+    if (pagination) {
+      command += " OFFSET ";
+      ctx.params.push(pagination.offset);
+      command += "$" + ctx.params.length;
+
+      command += " LIMIT ";
+      ctx.params.push(pagination.limit);
+      command += "$" + ctx.params.length;
+    }
+
+    return {
+      command,
+      params: ctx.params,
+    };
+  }
+
+  selectDerived(derivedModel: RpdDataModel, baseModel: RpdDataModel, options: FindRowOptions): DatabaseQuery {
+    const ctx: BuildQueryContext = {
+      model: derivedModel,
+      builder: this,
+      params: [],
+      emitTableAlias: true,
+      paramToLiteral: false,
+    };
+    let { fields: columns, filters, orderBy, pagination } = options;
+    let command = "SELECT ";
+    if (!columns || !columns.length) {
+      command += `${this.quoteObject(derivedModel.tableName)}.* FROM `;
+    } else {
+      command += columns
+        .map((column) => {
+          return this.quoteColumn(derivedModel, column, ctx.emitTableAlias);
+        })
+        .join(", ");
+      command += " FROM ";
+    }
+
+    command += `${this.quoteTable(derivedModel)} LEFT JOIN ${this.quoteTable(baseModel)} ON ${this.quoteObject(derivedModel.tableName)}.id = ${this.quoteObject(
+      baseModel.tableName,
+    )}.id`;
+
+    if (options.orderBy) {
+      options.orderBy
+        .filter((orderByItem) => orderByItem.relationField)
+        .forEach((orderByItem) => {
+          const { relationField } = orderByItem;
+          const orderField = orderByItem.field as ColumnNameWithTableName;
+          command += ` LEFT JOIN ${this.quoteTable({ schema: orderField.schema, tableName: orderField.tableName })} ON ${this.quoteObject(
+            orderField.tableName,
+          )}.id = ${this.quoteObject(relationField.tableName)}.${this.quoteObject(relationField.name)}`;
+        });
+    }
+
+    if (filters && filters.length) {
+      command += " WHERE ";
+      command += buildFiltersQuery(ctx, filters);
+    }
+
+    if (orderBy && orderBy.length) {
+      command += " ORDER BY ";
+      command += orderBy
+        .map((item) => {
+          const quotedName = this.quoteColumn(derivedModel, item.field, ctx.emitTableAlias);
+          return item.desc ? quotedName + " DESC" : quotedName;
+        })
+        .join(", ");
+    }
+
+    if (pagination) {
+      command += " OFFSET ";
+      ctx.params.push(pagination.offset);
+      command += "$" + ctx.params.length;
+
+      command += " LIMIT ";
+      ctx.params.push(pagination.limit);
+      command += "$" + ctx.params.length;
+    }
+
+    return {
+      command,
+      params: ctx.params,
+    };
+  }
+
+  count(model: RpdDataModel, options: CountRowOptions): DatabaseQuery {
+    const ctx: BuildQueryContext = {
+      model,
+      builder: this,
+      params: [],
+      emitTableAlias: false,
+      paramToLiteral: false,
+    };
+    let { filters } = options;
+    let command = 'SELECT COUNT(*)::int as "count" FROM ';
+
+    command += this.quoteTable(model);
+
+    if (filters && filters.length) {
+      command += " WHERE ";
+      command += buildFiltersQuery(ctx, filters);
+    }
+
+    return {
+      command,
+      params: ctx.params,
+    };
+  }
+
+  countDerived(derivedModel: RpdDataModel, baseModel: RpdDataModel, options: CountRowOptions): DatabaseQuery {
+    const ctx: BuildQueryContext = {
+      model: derivedModel,
+      builder: this,
+      params: [],
+      emitTableAlias: true,
+      paramToLiteral: false,
+    };
+    let { filters } = options;
+    let command = 'SELECT COUNT(*)::int as "count" FROM ';
+
+    command += `${this.quoteTable(derivedModel)} LEFT JOIN ${this.quoteTable(baseModel)} ON ${this.quoteObject(derivedModel.tableName)}.id = ${this.quoteObject(
+      baseModel.tableName,
+    )}.id`;
+
+    if (filters && filters.length) {
+      command += " WHERE ";
+      command += buildFiltersQuery(ctx, filters);
+    }
+
+    return {
+      command,
+      params: ctx.params,
+    };
+  }
+
+  insert(model: RpdDataModel, options: CreateEntityOptions): DatabaseQuery {
+    const params: any[] = [];
+    const ctx: BuildQueryContext = {
+      model,
+      builder: this,
+      params,
+      emitTableAlias: false,
+      paramToLiteral: false,
+    };
+    const { entity } = options;
+    let command = "INSERT INTO ";
+
+    command += this.quoteTable(model);
+
+    const columnNames: string[] = Object.keys(entity);
+    let values = "";
+    columnNames.forEach((columnName, index) => {
+      if (index) {
+        values += ", ";
+      }
+
+      let property: RpdDataModelProperty | null = null;
+      if (model) {
+        property = find(model.properties, (e: RpdDataModelProperty) => (e.columnName || e.code) === columnName);
+      }
+      const columnType: DataAccessPgColumnTypes | null = property ? pgPropertyTypeColumnMap[property.type] : null;
+      if (columnType === "jsonb") {
+        params.push(JSON.stringify(entity[columnName]));
+        values += `$${params.length}::jsonb`;
+      } else {
+        params.push(entity[columnName]);
+        values += `$${params.length}`;
+      }
+    });
+
+    command += ` (${columnNames.map(this.quoteObject).join(", ")})`;
+    command += ` VALUES (${values}) RETURNING *`;
+
+    return {
+      command,
+      params: ctx.params,
+    };
+  }
+
+  update(model: RpdDataModel, options: UpdateRowOptions): DatabaseQuery {
+    const params: any[] = [];
+    const ctx: BuildQueryContext = {
+      model,
+      builder: this,
+      params,
+      emitTableAlias: false,
+      paramToLiteral: false,
+    };
+    let { entity, filters } = options;
+    let command = "UPDATE ";
+
+    command += this.quoteTable(model);
+
+    command += " SET ";
+    const columnNames: string[] = Object.keys(entity);
+    columnNames.forEach((columnName, index) => {
+      if (index) {
+        command += ", ";
+      }
+
+      command += `${this.quoteObject(columnName)}=`;
+
+      let property: RpdDataModelProperty | null = null;
+      if (model) {
+        property = find(model.properties, (e: RpdDataModelProperty) => (e.columnName || e.code) === columnName);
+      }
+      const columnType: DataAccessPgColumnTypes | null = property ? pgPropertyTypeColumnMap[property.type] : null;
+      if (columnType === "jsonb") {
+        params.push(JSON.stringify(entity[columnName]));
+        command += `$${params.length}::jsonb`;
+      } else {
+        params.push(entity[columnName]);
+        command += `$${params.length}`;
+      }
+    });
+
+    if (filters && filters.length) {
+      command += " WHERE ";
+      command += buildFiltersQuery(ctx, filters);
+    }
+
+    command += " RETURNING *";
+
+    return {
+      command,
+      params: ctx.params,
+    };
+  }
+
+  delete(model: RpdDataModel, options: DeleteRowOptions): DatabaseQuery {
+    const params: any[] = [];
+    const ctx: BuildQueryContext = {
+      model,
+      builder: this,
+      params,
+      emitTableAlias: false,
+      paramToLiteral: false,
+    };
+    let { filters } = options;
+    let command = "DELETE FROM ";
+
+    command += this.quoteTable(model);
+
+    if (filters && filters.length) {
+      command += " WHERE ";
+      command += buildFiltersQuery(ctx, filters);
+    }
+
+    return {
+      command,
+      params: ctx.params,
+    };
+  }
+
+  buildFiltersExpression(model: RpdDataModel, filters: RowFilterOptions[]) {
+    const params: any[] = [];
+    const ctx: BuildQueryContext = {
+      model,
+      builder: this,
+      params,
+      emitTableAlias: false,
+      paramToLiteral: true,
+    };
+
+    return buildFiltersQuery(ctx, filters);
+  }
+}
+
+export function buildFiltersQuery(ctx: BuildQueryContext, filters: RowFilterOptions[]) {
+  return buildFilterQuery(0, ctx, {
+    operator: "and",
+    filters,
+  });
+}
+
+function buildFilterQuery(level: number, ctx: BuildQueryContext, filter: RowFilterOptions): string {
+  const { operator } = filter;
+  if (operator === "eq" || operator === "ne" || operator === "gt" || operator === "gte" || operator === "lt" || operator === "lte") {
+    return buildRelationalFilterQuery(ctx, filter);
+  } else if (operator === "and" || operator === "or") {
+    return buildLogicalFilterQuery(level, ctx, filter);
+  } else if (operator === "null" || operator === "notNull") {
+    return buildUnaryFilterQuery(ctx, filter);
+  } else if (operator === "in" || operator === "notIn") {
+    return buildInFilterQuery(ctx, filter);
+  } else if (operator === "between" || operator === "range") {
+    return buildRangeFilterQuery(ctx, filter);
+  } else if (operator === "matches") {
+    return buildMatchesFilterQuery(ctx, filter);
+  } else if (operator === "matchesCS") {
+    return buildMatchesCSFilterQuery(ctx, filter);
+  } else if (operator === "contains") {
+    return buildContainsFilterQuery(ctx, filter);
+  } else if (operator === "containsCS") {
+    return buildContainsCSFilterQuery(ctx, filter);
+  } else if (operator === "notContains") {
+    return buildNotContainsFilterQuery(ctx, filter);
+  } else if (operator === "notContainsCS") {
+    return buildNotContainsCSFilterQuery(ctx, filter);
+  } else if (operator === "startsWith") {
+    return buildStartsWithFilterQuery(ctx, filter);
+  } else if (operator === "notStartsWith") {
+    return buildNotStartsWithFilterQuery(ctx, filter);
+  } else if (operator === "endsWith") {
+    return buildEndsWithFilterQuery(ctx, filter);
+  } else if (operator === "notEndsWith") {
+    return buildNotEndsWithFilterQuery(ctx, filter);
+  } else if (operator === "arrayContains") {
+    return buildArrayContainsFilterQuery(ctx, filter);
+  } else if (operator === "arrayOverlap") {
+    return buildArrayOverlapFilterQuery(ctx, filter);
+  } else {
+    throw new Error(`Filter operator '${operator}' is not supported.`);
+  }
+}
+
+function buildLogicalFilterQuery(level: number, ctx: BuildQueryContext, filter: FindRowLogicalFilterOptions) {
+  let dbOperator;
+  if (filter.operator === "and") {
+    dbOperator = " AND ";
+  } else {
+    dbOperator = " OR ";
+  }
+
+  let command = filter.filters.map(buildFilterQuery.bind(null, level + 1, ctx)).join(dbOperator);
+  if (level) {
+    return `(${command})`;
+  }
+  return command;
+}
+
+function buildUnaryFilterQuery(ctx: BuildQueryContext, filter: FindRowUnaryFilterOptions) {
+  let command = ctx.builder.quoteColumn(ctx.model, filter.field, ctx.emitTableAlias);
+  if (filter.operator === "null") {
+    command += " IS NULL";
+  } else {
+    command += " IS NOT NULL";
+  }
+  return command;
+}
+
+function buildInFilterQuery(ctx: BuildQueryContext, filter: FindRowSetFilterOptions) {
+  let command = ctx.builder.quoteColumn(ctx.model, filter.field, ctx.emitTableAlias);
+
+  if (filter.operator === "in") {
+    command += " = ";
+  } else {
+    command += " <> ";
+  }
+
+  if (ctx.paramToLiteral) {
+    // TODO: implement it
+  } else {
+    ctx.params.push(filter.value);
+    if (filter.operator === "in") {
+      command += `ANY($${ctx.params.length}::${filter.itemType || "int"}[])`;
+    } else {
+      command += `ALL($${ctx.params.length}::${filter.itemType || "int"}[])`;
+    }
+  }
+
+  return command;
+}
+
+function buildRangeFilterQuery(ctx: BuildQueryContext, filter: FindRowRangeFilterOptions) {
+  let command = "";
+
+  if (filter.value.length != 2) {
+    throw new Error(`Filter operator '${filter.operator}' need two values.`);
+  }
+
+  if (filter.operator === "between") {
+    command += ctx.builder.quoteColumn(ctx.model, filter.field, ctx.emitTableAlias);
+
+    command += " BETWEEN ";
+
+    ctx.params.push(filter.value[0]);
+    command += `$${ctx.params.length}`;
+
+    command += " AND ";
+
+    ctx.params.push(filter.value[1]);
+    command += `$${ctx.params.length}`;
+  } else if (filter.operator === "range") {
+    ctx.params.push(filter.value[0]);
+    command += `(${ctx.builder.quoteColumn(ctx.model, filter.field, ctx.emitTableAlias)} >= $${ctx.params.length}`;
+
+    command += " AND ";
+
+    ctx.params.push(filter.value[1]);
+    command += `${ctx.builder.quoteColumn(ctx.model, filter.field, ctx.emitTableAlias)} < $${ctx.params.length})`;
+  } else {
+    throw new Error(`Filter operator '${filter.operator}' is not supported.`);
+  }
+
+  return command;
+}
+
+function convertSearchTextToLikeParamValue(searchText: string) {
+  if (isNil(searchText)) {
+    return searchText;
+  }
+
+  let result = searchText.replace(/\*/g, "%");
+  result = result.replace(/\?/g, "_");
+  return result;
+}
+
+function buildMatchesFilterQuery(ctx: BuildQueryContext, filter: FindRowRelationalFilterOptions) {
+  let command = ctx.builder.quoteColumn(ctx.model, filter.field, ctx.emitTableAlias);
+
+  command += " ILIKE ";
+
+  if (ctx.paramToLiteral) {
+    // TODO: implement it
+  } else {
+    ctx.params.push(`%${convertSearchTextToLikeParamValue(filter.value)}%`);
+    command += "$" + ctx.params.length;
+  }
+
+  return command;
+}
+
+function buildMatchesCSFilterQuery(ctx: BuildQueryContext, filter: FindRowRelationalFilterOptions) {
+  let command = ctx.builder.quoteColumn(ctx.model, filter.field, ctx.emitTableAlias);
+
+  command += " LIKE ";
+
+  if (ctx.paramToLiteral) {
+    // TODO: implement it
+  } else {
+    ctx.params.push(`%${convertSearchTextToLikeParamValue(filter.value)}%`);
+    command += "$" + ctx.params.length;
+  }
+
+  return command;
+}
+
+function buildContainsFilterQuery(ctx: BuildQueryContext, filter: FindRowRelationalFilterOptions) {
+  let command = ctx.builder.quoteColumn(ctx.model, filter.field, ctx.emitTableAlias);
+
+  command += " ILIKE ";
+
+  if (ctx.paramToLiteral) {
+    // TODO: implement it
+  } else {
+    ctx.params.push(`%${filter.value}%`);
+    command += "$" + ctx.params.length;
+  }
+
+  return command;
+}
+
+function buildContainsCSFilterQuery(ctx: BuildQueryContext, filter: FindRowRelationalFilterOptions) {
+  let command = ctx.builder.quoteColumn(ctx.model, filter.field, ctx.emitTableAlias);
+
+  command += " LIKE ";
+
+  if (ctx.paramToLiteral) {
+    // TODO: implement it
+  } else {
+    ctx.params.push(`%${filter.value}%`);
+    command += "$" + ctx.params.length;
+  }
+
+  return command;
+}
+
+function buildNotContainsFilterQuery(ctx: BuildQueryContext, filter: FindRowRelationalFilterOptions) {
+  let command = ctx.builder.quoteColumn(ctx.model, filter.field, ctx.emitTableAlias);
+
+  command += " NOT ILIKE ";
+  if (ctx.paramToLiteral) {
+    // TODO: implement it
+  } else {
+    ctx.params.push(`%${filter.value}%`);
+    command += "$" + ctx.params.length;
+  }
+
+  return command;
+}
+
+function buildNotContainsCSFilterQuery(ctx: BuildQueryContext, filter: FindRowRelationalFilterOptions) {
+  let command = ctx.builder.quoteColumn(ctx.model, filter.field, ctx.emitTableAlias);
+
+  command += " NOT LIKE ";
+  if (ctx.paramToLiteral) {
+    // TODO: implement it
+  } else {
+    ctx.params.push(`%${filter.value}%`);
+    command += "$" + ctx.params.length;
+  }
+
+  return command;
+}
+
+function buildStartsWithFilterQuery(ctx: BuildQueryContext, filter: FindRowRelationalFilterOptions) {
+  let command = ctx.builder.quoteColumn(ctx.model, filter.field, ctx.emitTableAlias);
+
+  command += " ILIKE ";
+
+  if (ctx.paramToLiteral) {
+    // TODO: implement it
+  } else {
+    ctx.params.push(`${filter.value}%`);
+    command += "$" + ctx.params.length;
+  }
+
+  return command;
+}
+
+function buildNotStartsWithFilterQuery(ctx: BuildQueryContext, filter: FindRowRelationalFilterOptions) {
+  let command = ctx.builder.quoteColumn(ctx.model, filter.field, ctx.emitTableAlias);
+
+  command += " NOT ILIKE ";
+
+  if (ctx.paramToLiteral) {
+    // TODO: implement it
+  } else {
+    ctx.params.push(`${filter.value}%`);
+    command += "$" + ctx.params.length;
+  }
+
+  return command;
+}
+
+function buildEndsWithFilterQuery(ctx: BuildQueryContext, filter: FindRowRelationalFilterOptions) {
+  let command = ctx.builder.quoteColumn(ctx.model, filter.field, ctx.emitTableAlias);
+
+  command += " ILIKE ";
+
+  if (ctx.paramToLiteral) {
+    // TODO: implement it
+  } else {
+    ctx.params.push(`%${filter.value}`);
+    command += "$" + ctx.params.length;
+  }
+
+  return command;
+}
+
+function buildNotEndsWithFilterQuery(ctx: BuildQueryContext, filter: FindRowRelationalFilterOptions) {
+  let command = ctx.builder.quoteColumn(ctx.model, filter.field, ctx.emitTableAlias);
+
+  command += " NOT ILIKE ";
+
+  if (ctx.paramToLiteral) {
+    // TODO: implement it
+  } else {
+    ctx.params.push(`%${filter.value}`);
+    command += "$" + ctx.params.length;
+  }
+
+  return command;
+}
+
+function buildRelationalFilterQuery(ctx: BuildQueryContext, filter: FindRowRelationalFilterOptions) {
+  let command = ctx.builder.quoteColumn(ctx.model, filter.field, ctx.emitTableAlias);
+
+  command += relationalOperatorsMap.get(filter.operator);
+
+  if (ctx.paramToLiteral) {
+    command += formatValueToSqlLiteral(filter.value);
+  } else {
+    ctx.params.push(filter.value);
+    command += "$" + ctx.params.length;
+  }
+
+  return command;
+}
+
+function buildArrayContainsFilterQuery(ctx: BuildQueryContext, filter: FindRowArrayFilterOptions) {
+  let command = ctx.builder.quoteColumn(ctx.model, filter.field, ctx.emitTableAlias);
+
+  command += " @> ";
+
+  if (ctx.paramToLiteral) {
+    // TODO: implement it
+  } else {
+    ctx.params.push(filter.value);
+    command += "$" + ctx.params.length;
+  }
+
+  return command;
+}
+
+function buildArrayOverlapFilterQuery(ctx: BuildQueryContext, filter: FindRowArrayFilterOptions) {
+  let command = ctx.builder.quoteColumn(ctx.model, filter.field, ctx.emitTableAlias);
+
+  command += " && ";
+
+  if (ctx.paramToLiteral) {
+    // TODO: implement it
+  } else {
+    ctx.params.push(filter.value);
+    command += "$" + ctx.params.length;
+  }
+
+  return command;
+}
+
+function formatValueToSqlLiteral(value: any) {
+  if (isNull(value) || isUndefined(value)) {
+    return "null";
+  }
+
+  if (isString(value)) {
+    return `'${value.replaceAll("'", "''")}'`;
+  }
+
+  if (isBoolean(value)) {
+    return value ? "true" : "false";
+  }
+
+  if (isNumber(value)) {
+    return value.toString();
+  }
+
+  return `'${value.toString().replaceAll("'", "''")}'`;
+}