durcno 1.0.0-alpha.0

package/dist/src/filters/array.mjs

@@ -0,0 +1,150 @@
+import { Filter } from "./custom.mjs";
+//#region src/filters/array.ts
+/** Converts an array of values to a PostgreSQL array literal. */
+function arrayToSql(values) {
+	if (values.length === 0) return "'{}'";
+	return `ARRAY[${values.map((v) => {
+		if (typeof v === "string") return `'${v.replace(/'/g, "''")}'`;
+		return String(v);
+	}).join(", ")}]`;
+}
+/** Converts a single value to a SQL literal. */
+function valueToSql(value) {
+	if (typeof value === "string") return `'${value.replace(/'/g, "''")}'`;
+	return String(value);
+}
+/**
+* ArrayContains filter: col @> ARRAY[values]
+* Returns true if the array column contains all the specified values.
+*/
+var ArrayContainsFilter = class extends Filter {
+	left;
+	right;
+	constructor(column, values) {
+		super();
+		this.left = column;
+		this.right = values;
+	}
+	toSQL() {
+		return `${this.left.fullName} @> ${arrayToSql(this.right)}`;
+	}
+	toQuery(query) {
+		query.sql += `${this.left.fullName} @> ${arrayToSql(this.right)}`;
+	}
+};
+/**
+* Creates a condition that checks if an array column contains all specified values.
+* SQL: column @> ARRAY[values]
+*
+* @example
+* db.from(Posts).select().where(arrayContains(Posts.tags, ['typescript', 'postgres']))
+*/
+function arrayContains(column, values) {
+	return new ArrayContainsFilter(column, values);
+}
+/**
+* ArrayContainedBy filter: col <@ ARRAY[values]
+* Returns true if the array column is contained by (is a subset of) the specified values.
+*/
+var ArrayContainedByFilter = class extends Filter {
+	left;
+	right;
+	constructor(column, values) {
+		super();
+		this.left = column;
+		this.right = values;
+	}
+	toSQL() {
+		return `${this.left.fullName} <@ ${arrayToSql(this.right)}`;
+	}
+	toQuery(query) {
+		query.sql += `${this.left.fullName} <@ ${arrayToSql(this.right)}`;
+	}
+};
+/**
+* Creates a condition that checks if an array column is contained by the specified values.
+* SQL: column <@ ARRAY[values]
+*/
+function arrayContainedBy(column, values) {
+	return new ArrayContainedByFilter(column, values);
+}
+/**
+* ArrayOverlaps filter: col && ARRAY[values]
+* Returns true if the arrays have any elements in common.
+*/
+var ArrayOverlapsFilter = class extends Filter {
+	left;
+	right;
+	constructor(column, values) {
+		super();
+		this.left = column;
+		this.right = values;
+	}
+	toSQL() {
+		return `${this.left.fullName} && ${arrayToSql(this.right)}`;
+	}
+	toQuery(query) {
+		query.sql += `${this.left.fullName} && ${arrayToSql(this.right)}`;
+	}
+};
+/**
+* Creates a condition that checks if an array column overlaps with the specified values.
+* SQL: column && ARRAY[values]
+*/
+function arrayOverlaps(column, values) {
+	return new ArrayOverlapsFilter(column, values);
+}
+/**
+* ArrayHas filter: value = ANY(col)
+* Returns true if the value exists in the array column.
+*/
+var ArrayHasFilter = class extends Filter {
+	left;
+	right;
+	constructor(column, value) {
+		super();
+		this.left = column;
+		this.right = value;
+	}
+	toSQL() {
+		return `${valueToSql(this.right)} = ANY(${this.left.fullName})`;
+	}
+	toQuery(query) {
+		query.sql += `${valueToSql(this.right)} = ANY(${this.left.fullName})`;
+	}
+};
+/**
+* Creates a condition that checks if a value exists in an array column.
+* SQL: value = ANY(column)
+*/
+function arrayHas(column, value) {
+	return new ArrayHasFilter(column, value);
+}
+/**
+* ArrayAll filter: value = ALL(col)
+* Returns true if all elements in the array column equal the value.
+*/
+var ArrayAllFilter = class extends Filter {
+	left;
+	right;
+	constructor(column, value) {
+		super();
+		this.left = column;
+		this.right = value;
+	}
+	toSQL() {
+		return `${valueToSql(this.right)} = ALL(${this.left.fullName})`;
+	}
+	toQuery(query) {
+		query.sql += `${valueToSql(this.right)} = ALL(${this.left.fullName})`;
+	}
+};
+/**
+* Creates a condition that checks if all elements in an array column equal a value.
+* SQL: value = ALL(column)
+*/
+function arrayAll(column, value) {
+	return new ArrayAllFilter(column, value);
+}
+//#endregion
+export { arrayAll, arrayContainedBy, arrayContains, arrayHas, arrayOverlaps };

package/dist/src/filters/custom.d.mts

@@ -0,0 +1,12 @@
+import { Query } from "../query-builders/query.mjs";
+import { AnyColumn, TableColumn } from "../table.mjs";
+
+//#region src/filters/custom.d.ts
+/** Abstract base class for SQL filter expressions used in `WHERE`/`ON` clauses. */
+declare abstract class Filter<TColumn extends TableColumn<any, any, any, AnyColumn>> {
+  readonly $Columns: TColumn;
+  abstract toSQL(): string;
+  abstract toQuery(query: Query): void;
+}
+//#endregion
+export { Filter };

package/dist/src/filters/custom.mjs

@@ -0,0 +1,7 @@
+//#region src/filters/custom.ts
+/** Abstract base class for SQL filter expressions used in `WHERE`/`ON` clauses. */
+var Filter = class {
+	$Columns;
+};
+//#endregion
+export { Filter };

package/dist/src/filters/index.d.mts

@@ -0,0 +1,155 @@
+import { Query } from "../query-builders/query.mjs";
+import { SelectQuery } from "../query-builders/select.mjs";
+import { Sql } from "../sql.mjs";
+import { Filter } from "./custom.mjs";
+import { Arg } from "../query-builders/pre.mjs";
+import { AnyColumn, AnyTableWithColumns, TColsToLeftRight, TableColumn, TableColumnArgs } from "../table.mjs";
+
+//#region src/filters/index.d.ts
+type ConditionExpression<Left extends TableColumnArgs, Right extends Record<string, TableColumnArgs>, TArg extends boolean = false> = EqualValCondition<Left[0], Left[1], Left[2], Left[3], Left[3]["ValType"]> | (TArg extends true ? EqualValCondition<Left[0], Left[1], Left[2], Left[3], Arg<Left[3]["ValType"]>> : never) | { [RightKey in keyof Right]: EqualColCondition<Left[0], Left[1], Left[2], Left[3], Right[RightKey][0], Right[RightKey][1], Right[RightKey][2], Right[RightKey][3]> }[keyof Right] | GreaterEqualValCondition<Left[0], Left[1], Left[2], Left[3], Left[3]["ValType"] | (TArg extends true ? Arg<Left[3]["ValType"]> : never)> | { [RightKey in keyof Right]: GreaterEqualColCondition<Left[0], Left[1], Left[2], Left[3], Right[RightKey][0], Right[RightKey][1], Right[RightKey][2], Right[RightKey][3]> }[keyof Right] | GreaterThanValCondition<Left[0], Left[1], Left[2], Left[3], Left[3]["ValType"] | (TArg extends true ? Arg<Left[3]["ValType"]> : never)> | { [RightKey in keyof Right]: GreaterThanColCondition<Left[0], Left[1], Left[2], Left[3], Right[RightKey][0], Right[RightKey][1], Right[RightKey][2], Right[RightKey][3]> }[keyof Right] | LessThanValCondition<Left[0], Left[1], Left[2], Left[3], Left[3]["ValType"] | (TArg extends true ? Arg<Left[3]["ValType"]> : never)> | { [RightKey in keyof Right]: LessThanColCondition<Left[0], Left[1], Left[2], Left[3], Right[RightKey][0], Right[RightKey][1], Right[RightKey][2], Right[RightKey][3]> }[keyof Right] | LessEqualValCondition<Left[0], Left[1], Left[2], Left[3], Left[3]["ValType"] | (TArg extends true ? Arg<Left[3]["ValType"]> : never)> | { [RightKey in keyof Right]: LessEqualColCondition<Left[0], Left[1], Left[2], Left[3], Right[RightKey][0], Right[RightKey][1], Right[RightKey][2], Right[RightKey][3]> }[keyof Right] | IsNullCondition<Left[0], Left[1], Left[2], Left[3]> | InCondition<Left[0], Left[1], Left[2], Left[3], TArg>;
+type BuildFilterExpression<TLeftRight extends Record<string, {
+  left: TableColumnArgs;
+  right: Record<string, TableColumnArgs>;
+}>, TArg extends boolean = false> = { [LeftKey in keyof TLeftRight]: ConditionExpression<TLeftRight[LeftKey]["left"], TLeftRight[LeftKey]["right"], TArg> }[keyof TLeftRight] | Filter<{ [LeftKey in keyof TLeftRight]: TLeftRight[LeftKey]["left"] extends [infer Schema extends string, infer TblName extends string, infer ColName extends string, infer ColType extends AnyColumn] ? TableColumn<Schema, TblName, ColName, ColType> : never }[keyof TLeftRight]> | Sql | AndCondition<BuildFilterExpression<TLeftRight, TArg>[]> | OrCondition<BuildFilterExpression<TLeftRight, TArg>[]>;
+type StdCondition = BuildFilterExpression<TColsToLeftRight<AnyTableWithColumns["_"]["columns"]>>;
+declare class EqualValCondition<CTSchema extends string, CTName extends string, CName extends Key, Col extends AnyColumn, TRight extends Col["ValType"] | Arg<Col["ValType"]>> {
+  readonly left: TableColumn<CTSchema, CTName, CName, Col>;
+  readonly right: TRight;
+  constructor(field: TableColumn<CTSchema, CTName, CName, Col>, right: TRight);
+  toSQL(): string;
+  toQuery(query: Query): void;
+}
+declare class EqualColCondition<C1TSchema extends string, C1TName extends string, C1Name extends Key, C1 extends AnyColumn, C2TSchema extends string, C2TName extends string, C2Name extends Key, C2 extends AnyColumn> {
+  readonly left: TableColumn<C1TSchema, C1TName, C1Name, C1>;
+  readonly right: TableColumn<C2TSchema, C2TName, C2Name, C2>;
+  constructor(field: TableColumn<C1TSchema, C1TName, C1Name, C1>, right: TableColumn<C2TSchema, C2TName, C2Name, C2>);
+  toSQL(): string;
+  toQuery(query: Query): void;
+}
+declare function eq<CTSchema extends string, CTName extends string, CName extends Key, Col extends AnyColumn, TRight extends Col["ValType"]>(field: TableColumn<CTSchema, CTName, CName, Col>, right: TRight): EqualValCondition<CTSchema, CTName, CName, Col, TRight>;
+declare function eq<CTSchema extends string, CTName extends string, CName extends Key, Col extends AnyColumn, TRight extends Arg<Col["ValType"]>>(field: TableColumn<CTSchema, CTName, CName, Col>, right: TRight): EqualValCondition<CTSchema, CTName, CName, Col, TRight>;
+declare function eq<C1TSchema extends string, C1TName extends string, C1Name extends Key, C1 extends AnyColumn, C2TSchema extends string, C2TName extends string, C2Name extends Key, C2 extends AnyColumn>(field: TableColumn<C1TSchema, C1TName, C1Name, C1>, right: TableColumn<C2TSchema, C2TName, C2Name, C2>): EqualColCondition<C1TSchema, C1TName, C1Name, C1, C2TSchema, C2TName, C2Name, C2>;
+declare class NotEqualValCondition<CTSchema extends string, CTName extends string, CName extends Key, Col extends AnyColumn, TRight extends Col["ValType"] | Arg<Col["ValType"]>> {
+  readonly left: TableColumn<CTSchema, CTName, CName, Col>;
+  readonly right: TRight;
+  constructor(field: TableColumn<CTSchema, CTName, CName, Col>, right: TRight);
+  toSQL(): string;
+  toQuery(query: Query): void;
+}
+declare class NotEqualColCondition<C1TSchema extends string, C1TName extends string, C1Name extends Key, C1 extends AnyColumn, C2TSchema extends string, C2TName extends string, C2Name extends Key, C2 extends AnyColumn> {
+  readonly left: TableColumn<C1TSchema, C1TName, C1Name, C1>;
+  readonly right: TableColumn<C2TSchema, C2TName, C2Name, C2>;
+  constructor(field: TableColumn<C1TSchema, C1TName, C1Name, C1>, right: TableColumn<C2TSchema, C2TName, C2Name, C2>);
+  toSQL(): string;
+  toQuery(query: Query): void;
+}
+declare function ne<CTSchema extends string, CTName extends string, CName extends Key, Col extends AnyColumn, TRight extends Col["ValType"]>(field: TableColumn<CTSchema, CTName, CName, Col>, right: TRight): NotEqualValCondition<CTSchema, CTName, CName, Col, TRight>;
+declare function ne<CTSchema extends string, CTName extends string, CName extends Key, Col extends AnyColumn, TRight extends Arg<Col["ValType"]>>(field: TableColumn<CTSchema, CTName, CName, Col>, right: TRight): NotEqualValCondition<CTSchema, CTName, CName, Col, TRight>;
+declare function ne<C1TSchema extends string, C1TName extends string, C1Name extends Key, C1 extends AnyColumn, C2TSchema extends string, C2TName extends string, C2Name extends Key, C2 extends AnyColumn>(field: TableColumn<C1TSchema, C1TName, C1Name, C1>, right: TableColumn<C2TSchema, C2TName, C2Name, C2>): NotEqualColCondition<C1TSchema, C1TName, C1Name, C1, C2TSchema, C2TName, C2Name, C2>;
+declare class GreaterEqualValCondition<CTSchema extends string, CTName extends string, CName extends Key, Col extends AnyColumn, TRight extends Col["ValType"] | Arg<Col["ValType"]>> {
+  readonly left: TableColumn<CTSchema, CTName, CName, Col>;
+  readonly right: TRight;
+  constructor(field: TableColumn<CTSchema, CTName, CName, Col>, right: TRight);
+  toSQL(): string;
+  toQuery(query: Query): void;
+}
+declare class GreaterEqualColCondition<C1TSchema extends string, C1TName extends string, C1Name extends Key, C1 extends AnyColumn, C2TSchema extends string, C2TName extends string, C2Name extends Key, C2 extends AnyColumn> {
+  readonly left: TableColumn<C1TSchema, C1TName, C1Name, C1>;
+  readonly right: TableColumn<C2TSchema, C2TName, C2Name, C2>;
+  constructor(field: TableColumn<C1TSchema, C1TName, C1Name, C1>, right: TableColumn<C2TSchema, C2TName, C2Name, C2>);
+  toSQL(): string;
+  toQuery(query: Query): void;
+}
+declare function gte<CTSchema extends string, CTName extends string, CName extends Key, Col extends AnyColumn, TRight extends Col["ValType"]>(field: TableColumn<CTSchema, CTName, CName, Col>, right: TRight): GreaterEqualValCondition<CTSchema, CTName, CName, Col, TRight>;
+declare function gte<CTSchema extends string, CTName extends string, CName extends Key, Col extends AnyColumn, TRight extends Arg<Col["ValType"]>>(field: TableColumn<CTSchema, CTName, CName, Col>, right: TRight): GreaterEqualValCondition<CTSchema, CTName, CName, Col, TRight>;
+declare function gte<C1TSchema extends string, C1TName extends string, C1Name extends Key, C1 extends AnyColumn, C2TSchema extends string, C2TName extends string, C2Name extends Key, C2 extends AnyColumn>(field: TableColumn<C1TSchema, C1TName, C1Name, C1>, right: TableColumn<C2TSchema, C2TName, C2Name, C2>): GreaterEqualColCondition<C1TSchema, C1TName, C1Name, C1, C2TSchema, C2TName, C2Name, C2>;
+declare class GreaterThanValCondition<CTSchema extends string, CTName extends string, CName extends Key, Col extends AnyColumn, TRight extends Col["ValType"] | Arg<Col["ValType"]>> {
+  readonly left: TableColumn<CTSchema, CTName, CName, Col>;
+  readonly right: TRight;
+  constructor(field: TableColumn<CTSchema, CTName, CName, Col>, right: TRight);
+  toSQL(): string;
+  toQuery(query: Query): void;
+}
+declare class GreaterThanColCondition<C1TSchema extends string, C1TName extends string, C1Name extends Key, C1 extends AnyColumn, C2TSchema extends string, C2TName extends string, C2Name extends Key, C2 extends AnyColumn> {
+  readonly left: TableColumn<C1TSchema, C1TName, C1Name, C1>;
+  readonly right: TableColumn<C2TSchema, C2TName, C2Name, C2>;
+  constructor(field: TableColumn<C1TSchema, C1TName, C1Name, C1>, right: TableColumn<C2TSchema, C2TName, C2Name, C2>);
+  toSQL(): string;
+  toQuery(query: Query): void;
+}
+declare function gt<CTSchema extends string, CTName extends string, CName extends Key, Col extends AnyColumn, TRight extends Col["ValType"]>(field: TableColumn<CTSchema, CTName, CName, Col>, right: TRight): GreaterThanValCondition<CTSchema, CTName, CName, Col, TRight>;
+declare function gt<CTSchema extends string, CTName extends string, CName extends Key, Col extends AnyColumn, TRight extends Arg<Col["ValType"]>>(field: TableColumn<CTSchema, CTName, CName, Col>, right: TRight): GreaterThanValCondition<CTSchema, CTName, CName, Col, TRight>;
+declare function gt<C1TSchema extends string, C1TName extends string, C1Name extends Key, C1 extends AnyColumn, C2TSchema extends string, C2TName extends string, C2Name extends Key, C2 extends AnyColumn>(field: TableColumn<C1TSchema, C1TName, C1Name, C1>, right: TableColumn<C2TSchema, C2TName, C2Name, C2>): GreaterThanColCondition<C1TSchema, C1TName, C1Name, C1, C2TSchema, C2TName, C2Name, C2>;
+declare class LessEqualValCondition<CTSchema extends string, CTName extends string, CName extends Key, Col extends AnyColumn, TRight extends Col["ValType"] | Arg<Col["ValType"]>> {
+  readonly left: TableColumn<CTSchema, CTName, CName, Col>;
+  readonly right: TRight;
+  constructor(field: TableColumn<CTSchema, CTName, CName, Col>, right: TRight);
+  toSQL(): string;
+  toQuery(query: Query): void;
+}
+declare class LessEqualColCondition<C1TSchema extends string, C1TName extends string, C1Name extends Key, C1 extends AnyColumn, C2TSchema extends string, C2TName extends string, C2Name extends Key, C2 extends AnyColumn> {
+  readonly left: TableColumn<C1TSchema, C1TName, C1Name, C1>;
+  readonly right: TableColumn<C2TSchema, C2TName, C2Name, C2>;
+  constructor(field: TableColumn<C1TSchema, C1TName, C1Name, C1>, right: TableColumn<C2TSchema, C2TName, C2Name, C2>);
+  toSQL(): string;
+  toQuery(query: Query): void;
+}
+declare function lte<CTSchema extends string, CTName extends string, CName extends Key, Col extends AnyColumn, TRight extends Col["ValType"]>(field: TableColumn<CTSchema, CTName, CName, Col>, right: TRight): LessEqualValCondition<CTSchema, CTName, CName, Col, TRight>;
+declare function lte<CTSchema extends string, CTName extends string, CName extends Key, Col extends AnyColumn, TRight extends Arg<Col["ValType"]>>(field: TableColumn<CTSchema, CTName, CName, Col>, right: TRight): LessEqualValCondition<CTSchema, CTName, CName, Col, TRight>;
+declare function lte<C1TSchema extends string, C1TName extends string, C1Name extends Key, C1 extends AnyColumn, C2TSchema extends string, C2TName extends string, C2Name extends Key, C2 extends AnyColumn>(field: TableColumn<C1TSchema, C1TName, C1Name, C1>, right: TableColumn<C2TSchema, C2TName, C2Name, C2>): LessEqualColCondition<C1TSchema, C1TName, C1Name, C1, C2TSchema, C2TName, C2Name, C2>;
+declare class LessThanValCondition<CTSchema extends string, CTName extends string, CName extends Key, Col extends AnyColumn, TRight extends Col["ValType"] | Arg<Col["ValType"]>> {
+  readonly left: TableColumn<CTSchema, CTName, CName, Col>;
+  readonly right: TRight;
+  constructor(field: TableColumn<CTSchema, CTName, CName, Col>, right: TRight);
+  toSQL(): string;
+  toQuery(query: Query): void;
+}
+declare class LessThanColCondition<C1TSchema extends string, C1TName extends string, C1Name extends Key, C1 extends AnyColumn, C2TSchema extends string, C2TName extends string, C2Name extends Key, C2 extends AnyColumn> {
+  readonly left: TableColumn<C1TSchema, C1TName, C1Name, C1>;
+  readonly right: TableColumn<C2TSchema, C2TName, C2Name, C2>;
+  constructor(field: TableColumn<C1TSchema, C1TName, C1Name, C1>, right: TableColumn<C2TSchema, C2TName, C2Name, C2>);
+  toSQL(): string;
+  toQuery(query: Query): void;
+}
+declare function lt<CTSchema extends string, CTName extends string, CName extends Key, Col extends AnyColumn, TRight extends Col["ValType"]>(field: TableColumn<CTSchema, CTName, CName, Col>, right: TRight): LessThanValCondition<CTSchema, CTName, CName, Col, TRight>;
+declare function lt<CTSchema extends string, CTName extends string, CName extends Key, Col extends AnyColumn, TRight extends Arg<Col["ValType"]>>(field: TableColumn<CTSchema, CTName, CName, Col>, right: TRight): LessThanValCondition<CTSchema, CTName, CName, Col, TRight>;
+declare function lt<C1TSchema extends string, C1TName extends string, C1Name extends Key, C1 extends AnyColumn, C2TSchema extends string, C2TName extends string, C2Name extends Key, C2 extends AnyColumn>(field: TableColumn<C1TSchema, C1TName, C1Name, C1>, right: TableColumn<C2TSchema, C2TName, C2Name, C2>): LessThanColCondition<C1TSchema, C1TName, C1Name, C1, C2TSchema, C2TName, C2Name, C2>;
+declare class IsNullCondition<CTSchema extends string, CTName extends string, CName extends Key, Col extends AnyColumn> {
+  readonly field: TableColumn<CTSchema, CTName, CName, Col>;
+  constructor(field: TableColumn<CTSchema, CTName, CName, Col>);
+  toSQL(): string;
+  toQuery(query: Query): void;
+}
+declare function isNull<CTSchema extends string, CTName extends string, CName extends Key, Col extends AnyColumn>(field: TableColumn<CTSchema, CTName, CName, Col>): IsNullCondition<CTSchema, CTName, CName, Col>;
+declare class IsNotNullCondition<CTSchema extends string, CTName extends string, CName extends Key, Col extends AnyColumn> {
+  readonly field: TableColumn<CTSchema, CTName, CName, Col>;
+  constructor(field: TableColumn<CTSchema, CTName, CName, Col>);
+  toSQL(): string;
+  toQuery(query: Query): void;
+}
+declare function isNotNull<CTSchema extends string, CTName extends string, CName extends Key, Col extends AnyColumn>(field: TableColumn<CTSchema, CTName, CName, Col>): IsNotNullCondition<CTSchema, CTName, CName, Col>;
+type InSelectQuery<TArg extends boolean, TReturn> = SelectQuery<any, any, any, any, any, TArg, any, any, Record<string, TReturn>[]>;
+declare class InCondition<CTSchema extends string, CTName extends string, CName extends Key, Col extends AnyColumn, TArg extends boolean> {
+  readonly field: TableColumn<CTSchema, CTName, CName, Col>;
+  readonly values: Col["ValType"][] | InSelectQuery<TArg, Col["ValType"]>;
+  constructor(field: TableColumn<CTSchema, CTName, CName, Col>, values: Col["ValType"][] | InSelectQuery<TArg, Col["ValType"]>);
+  toSQL(): string;
+  toQuery(query: Query): void;
+}
+declare function isIn<CTSchema extends string, CTName extends string, CName extends Key, Col extends AnyColumn>(field: TableColumn<CTSchema, CTName, CName, Col>, values: Col["ValType"][] | InSelectQuery<boolean, Col["ValType"]>): InCondition<CTSchema, CTName, CName, Col, boolean>;
+declare class AndCondition<TConditions extends any[]> {
+  readonly conditions: TConditions;
+  constructor(...conditions: TConditions);
+  toSQL(): string;
+  toQuery(query: Query): void;
+}
+declare function and<TConditions extends any[]>(...conditions: TConditions): AndCondition<TConditions>;
+declare class OrCondition<TConditions extends any[]> {
+  readonly conditions: TConditions;
+  constructor(...conditions: TConditions);
+  toSQL(): string;
+  toQuery(query: Query): void;
+}
+declare function or<TConditions extends any[]>(...conditions: TConditions): OrCondition<TConditions>;
+//#endregion
+export { BuildFilterExpression, StdCondition, and, eq, gt, gte, isIn, isNotNull, isNull, lt, lte, ne, or };

package/dist/src/filters/index.mjs

@@ -0,0 +1,318 @@
+import { Arg } from "../query-builders/pre.mjs";
+import { is, isTCol } from "../entity.mjs";
+import "./custom.mjs";
+//#region src/filters/index.ts
+var EqualValCondition = class {
+	left;
+	right;
+	constructor(field, right) {
+		this.left = field;
+		this.right = right;
+	}
+	toSQL() {
+		return `${this.left.fullName} = ${this.left.toSQL(this.right)}`;
+	}
+	toQuery(query) {
+		query.sql += `${this.left.fullName} = `;
+		if (is(this.right, Arg)) query.addArg(this.right);
+		else query.sql += this.left.toSQL(this.right);
+	}
+};
+var EqualColCondition = class {
+	left;
+	right;
+	constructor(field, right) {
+		this.left = field;
+		this.right = right;
+	}
+	toSQL() {
+		return `${this.left.fullName} = ${this.right.fullName}`;
+	}
+	toQuery(query) {
+		query.sql += `${this.left.fullName} = ${this.right.fullName}`;
+	}
+};
+function eq(field, right) {
+	if (isTCol(right)) return new EqualColCondition(field, right);
+	else return new EqualValCondition(field, right);
+}
+var NotEqualValCondition = class {
+	left;
+	right;
+	constructor(field, right) {
+		this.left = field;
+		this.right = right;
+	}
+	toSQL() {
+		return `${this.left.fullName} != ${this.left.toSQL(this.right)}`;
+	}
+	toQuery(query) {
+		query.sql += `${this.left.fullName} != `;
+		if (is(this.right, Arg)) query.addArg(this.right);
+		else query.sql += this.left.toSQL(this.right);
+	}
+};
+var NotEqualColCondition = class {
+	left;
+	right;
+	constructor(field, right) {
+		this.left = field;
+		this.right = right;
+	}
+	toSQL() {
+		return `${this.left.fullName} != ${this.right.fullName}`;
+	}
+	toQuery(query) {
+		query.sql += `${this.left.fullName} != ${this.right.fullName}`;
+	}
+};
+function ne(field, right) {
+	if (isTCol(right)) return new NotEqualColCondition(field, right);
+	else return new NotEqualValCondition(field, right);
+}
+var GreaterEqualValCondition = class {
+	left;
+	right;
+	constructor(field, right) {
+		this.left = field;
+		this.right = right;
+	}
+	toSQL() {
+		return `${this.left.fullName} >= ${this.left.toSQL(this.right)}`;
+	}
+	toQuery(query) {
+		query.sql += `${this.left.fullName} >= `;
+		if (is(this.right, Arg)) query.addArg(this.right);
+		else query.sql += this.left.toSQL(this.right);
+	}
+};
+var GreaterEqualColCondition = class {
+	left;
+	right;
+	constructor(field, right) {
+		this.left = field;
+		this.right = right;
+	}
+	toSQL() {
+		return `${this.left.fullName} >= ${this.right.fullName}`;
+	}
+	toQuery(query) {
+		query.sql += `${this.left.fullName} >= ${this.right.fullName}`;
+	}
+};
+function gte(field, right) {
+	if (isTCol(right)) return new GreaterEqualColCondition(field, right);
+	else return new GreaterEqualValCondition(field, right);
+}
+var GreaterThanValCondition = class {
+	left;
+	right;
+	constructor(field, right) {
+		this.left = field;
+		this.right = right;
+	}
+	toSQL() {
+		return `${this.left.fullName} > ${this.left.toSQL(this.right)}`;
+	}
+	toQuery(query) {
+		query.sql += `${this.left.fullName} > `;
+		if (is(this.right, Arg)) query.addArg(this.right);
+		else query.sql += this.left.toSQL(this.right);
+	}
+};
+var GreaterThanColCondition = class {
+	left;
+	right;
+	constructor(field, right) {
+		this.left = field;
+		this.right = right;
+	}
+	toSQL() {
+		return `${this.left.fullName} > ${this.right.fullName}`;
+	}
+	toQuery(query) {
+		query.sql += `${this.left.fullName} > ${this.right.fullName}`;
+	}
+};
+function gt(field, right) {
+	if (isTCol(right)) return new GreaterThanColCondition(field, right);
+	else return new GreaterThanValCondition(field, right);
+}
+var LessEqualValCondition = class {
+	left;
+	right;
+	constructor(field, right) {
+		this.left = field;
+		this.right = right;
+	}
+	toSQL() {
+		return `${this.left.fullName} <= ${this.left.toSQL(this.right)}`;
+	}
+	toQuery(query) {
+		query.sql += `${this.left.fullName} <= `;
+		if (is(this.right, Arg)) query.addArg(this.right);
+		else query.sql += this.left.toSQL(this.right);
+	}
+};
+var LessEqualColCondition = class {
+	left;
+	right;
+	constructor(field, right) {
+		this.left = field;
+		this.right = right;
+	}
+	toSQL() {
+		return `${this.left.fullName} <= ${this.right.fullName}`;
+	}
+	toQuery(query) {
+		query.sql += `${this.left.fullName} <= ${this.right.fullName}`;
+	}
+};
+function lte(field, right) {
+	if (isTCol(right)) return new LessEqualColCondition(field, right);
+	else return new LessEqualValCondition(field, right);
+}
+var LessThanValCondition = class {
+	left;
+	right;
+	constructor(field, right) {
+		this.left = field;
+		this.right = right;
+	}
+	toSQL() {
+		return `${this.left.fullName} < ${this.left.toSQL(this.right)}`;
+	}
+	toQuery(query) {
+		query.sql += `${this.left.fullName} < `;
+		if (is(this.right, Arg)) query.addArg(this.right);
+		else query.sql += this.left.toSQL(this.right);
+	}
+};
+var LessThanColCondition = class {
+	left;
+	right;
+	constructor(field, right) {
+		this.left = field;
+		this.right = right;
+	}
+	toSQL() {
+		return `${this.left.fullName} < ${this.right.fullName}`;
+	}
+	toQuery(query) {
+		query.sql += `${this.left.fullName} < ${this.right.fullName}`;
+	}
+};
+function lt(field, right) {
+	if (isTCol(right)) return new LessThanColCondition(field, right);
+	else return new LessThanValCondition(field, right);
+}
+var IsNullCondition = class {
+	field;
+	constructor(field) {
+		this.field = field;
+	}
+	toSQL() {
+		return `${this.field.fullName} IS NULL`;
+	}
+	toQuery(query) {
+		query.sql += `${this.field.fullName} IS NULL`;
+	}
+};
+function isNull(field) {
+	return new IsNullCondition(field);
+}
+var IsNotNullCondition = class {
+	field;
+	constructor(field) {
+		this.field = field;
+	}
+	toSQL() {
+		return `${this.field.fullName} IS NOT NULL`;
+	}
+	toQuery(query) {
+		query.sql += `${this.field.fullName} IS NOT NULL`;
+	}
+};
+function isNotNull(field) {
+	return new IsNotNullCondition(field);
+}
+var InCondition = class {
+	field;
+	values;
+	constructor(field, values) {
+		this.field = field;
+		this.values = values;
+	}
+	toSQL() {
+		if (Array.isArray(this.values)) {
+			if (this.values.length === 0) return "FALSE";
+			return `${this.field.fullName} IN (${this.values.map((v) => this.field.toSQL(v)).join(", ")})`;
+		} else return `${this.field.fullName} IN (${this.values.toQuery()})`;
+	}
+	toQuery(query) {
+		if (Array.isArray(this.values)) {
+			if (this.values.length === 0) {
+				query.sql += "FALSE";
+				return;
+			}
+			query.sql += `${this.field.fullName} IN (`;
+			query.sql += this.values.map((v) => this.field.toSQL(v)).join(", ");
+			query.sql += ")";
+		} else {
+			query.sql += `${this.field.fullName} IN (`;
+			query.sql += this.values.toQuery();
+			query.sql += ")";
+		}
+	}
+};
+function isIn(field, values) {
+	return new InCondition(field, values);
+}
+var AndCondition = class {
+	conditions;
+	constructor(...conditions) {
+		this.conditions = conditions;
+	}
+	toSQL() {
+		let sql = "";
+		for (let i = 0; i < this.conditions.length; i++) {
+			sql += this.conditions[i].toSQL();
+			if (i < this.conditions.length - 1) sql += " AND ";
+		}
+		return sql;
+	}
+	toQuery(query) {
+		for (let i = 0; i < this.conditions.length; i++) {
+			this.conditions[i].toQuery(query);
+			if (i < this.conditions.length - 1) query.sql += " AND ";
+		}
+	}
+};
+function and(...conditions) {
+	return new AndCondition(...conditions);
+}
+var OrCondition = class {
+	conditions;
+	constructor(...conditions) {
+		this.conditions = conditions;
+	}
+	toSQL() {
+		let sql = "";
+		for (let i = 0; i < this.conditions.length; i++) {
+			sql += this.conditions[i].toSQL();
+			if (i < this.conditions.length - 1) sql += " OR ";
+		}
+		return sql;
+	}
+	toQuery(query) {
+		for (let i = 0; i < this.conditions.length; i++) {
+			this.conditions[i].toQuery(query);
+			if (i < this.conditions.length - 1) query.sql += " OR ";
+		}
+	}
+};
+function or(...conditions) {
+	return new OrCondition(...conditions);
+}
+//#endregion
+export { and, eq, gt, gte, isIn, isNotNull, isNull, lt, lte, ne, or };

package/dist/src/functions/index.d.mts

@@ -0,0 +1,24 @@
+import { Sql } from "../sql.mjs";
+
+//#region src/functions/index.d.ts
+/**
+ * Returns a Sql object that represents the SQL function `now()`.
+ * @returns Sql
+ */
+declare function now(): Sql;
+/**
+ * Returns a Sql object that represents the SQL function `gen_random_uuid()` (UUID v4).
+ *
+ * Note: Requires the pgcrypto extension in PostgreSQL.
+ * @returns Sql
+ */
+declare function uuidv4(): Sql;
+/**
+ * Returns a Sql object that represents the SQL function `uuid_generate_v7()` (UUID v7).
+ *
+ * Note: Requires the uuid-ossp extension in PostgreSQL.
+ * @returns Sql
+ */
+declare function uuidv7(): Sql;
+//#endregion
+export { now, uuidv4, uuidv7 };