@iamkirbki/database-handler-core 4.3.1 → 4.4.0

package/dist/helpers/Errors/ExpressionErrors/InvalidExpressionParametersError.js

@@ -0,0 +1,6 @@
+export default class InvalidExpressionParametersError extends Error {
+    constructor(message) {
+        super(`Invalid expression parameters: ${message}`);
+        this.name = "InvalidExpressionParametersError";
+    }
+}

package/dist/helpers/Errors/ExpressionErrors/UnknownExpressionTypeError.d.ts

@@ -0,0 +1,4 @@
+export declare class UnknownExpressionTypeError extends Error {
+    constructor(type: string);
+}
+//# sourceMappingURL=UnknownExpressionTypeError.d.ts.map

package/dist/helpers/Errors/ExpressionErrors/UnknownExpressionTypeError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UnknownExpressionTypeError.d.ts","sourceRoot":"","sources":["../../../../src/helpers/Errors/ExpressionErrors/UnknownExpressionTypeError.ts"],"names":[],"mappings":"AAAA,qBAAa,0BAA2B,SAAQ,KAAK;gBACrC,IAAI,EAAE,MAAM;CAI3B"}

package/dist/helpers/Errors/ExpressionErrors/UnknownExpressionTypeError.js

@@ -0,0 +1,6 @@
+export class UnknownExpressionTypeError extends Error {
+    constructor(type) {
+        super(`No builder registered for expression type: ${type}`);
+        this.name = "UnknownExpressionTypeError";
+    }
+}

package/dist/helpers/Errors/ExpressionErrors/UnsupportedQueryPhaseError.d.ts

@@ -0,0 +1,4 @@
+export default class UnsupportedQueryPhaseError extends Error {
+    constructor(phase?: string);
+}
+//# sourceMappingURL=UnsupportedQueryPhaseError.d.ts.map

package/dist/helpers/Errors/ExpressionErrors/UnsupportedQueryPhaseError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UnsupportedQueryPhaseError.d.ts","sourceRoot":"","sources":["../../../../src/helpers/Errors/ExpressionErrors/UnsupportedQueryPhaseError.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,OAAO,OAAO,0BAA2B,SAAQ,KAAK;gBAC7C,KAAK,CAAC,EAAE,MAAM;CAI7B"}

package/dist/helpers/Errors/ExpressionErrors/UnsupportedQueryPhaseError.js

@@ -0,0 +1,6 @@
+export default class UnsupportedQueryPhaseError extends Error {
+    constructor(phase) {
+        super(`The query evaluation phase "${phase}" is not supported by this expression.`);
+        this.name = "UnsupportedQueryPhaseError";
+    }
+}

package/dist/helpers/Errors/QueryErrors/UnexpectedEmptyQueryError.d.ts

@@ -0,0 +1,4 @@
+export default class UnexpectedEmptyQueryError extends Error {
+    constructor();
+}
+//# sourceMappingURL=UnexpectedEmptyQueryError.d.ts.map

package/dist/helpers/Errors/QueryErrors/UnexpectedEmptyQueryError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UnexpectedEmptyQueryError.d.ts","sourceRoot":"","sources":["../../../../src/helpers/Errors/QueryErrors/UnexpectedEmptyQueryError.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,OAAO,OAAO,yBAA0B,SAAQ,KAAK;;CAK3D"}

package/dist/helpers/Errors/QueryErrors/UnexpectedEmptyQueryError.js

@@ -0,0 +1,6 @@
+export default class UnexpectedEmptyQueryError extends Error {
+    constructor() {
+        super(`The query is unexpectedly empty. Please ensure that the query is properly constructed and contains valid clauses.`);
+        this.name = "UnexpectedEmptyQueryError";
+    }
+}

package/dist/helpers/Errors/TableErrors/UnknownTableError.d.ts

@@ -0,0 +1,4 @@
+export default class UnknownTableError extends Error {
+    constructor(tableName: string);
+}
+//# sourceMappingURL=UnknownTableError.d.ts.map

package/dist/helpers/Errors/TableErrors/UnknownTableError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UnknownTableError.d.ts","sourceRoot":"","sources":["../../../../src/helpers/Errors/TableErrors/UnknownTableError.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,OAAO,OAAO,iBAAkB,SAAQ,KAAK;gBACpC,SAAS,EAAE,MAAM;CAIhC"}

package/dist/helpers/Errors/TableErrors/UnknownTableError.js

@@ -0,0 +1,6 @@
+export default class UnknownTableError extends Error {
+    constructor(tableName) {
+        super(`Unknown table: ${tableName}`);
+        this.name = "UnknownTableError";
+    }
+}

package/dist/helpers/QueryBuilders/BaseQueryBuilders/BaseDeleteQueryBuilder.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=BaseDeleteQueryBuilder.d.ts.map

package/dist/helpers/QueryBuilders/BaseQueryBuilders/BaseDeleteQueryBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseDeleteQueryBuilder.d.ts","sourceRoot":"","sources":["../../../../src/helpers/QueryBuilders/BaseQueryBuilders/BaseDeleteQueryBuilder.ts"],"names":[],"mappings":""}

package/dist/helpers/QueryBuilders/BaseQueryBuilders/BaseDeleteQueryBuilder.js

@@ -0,0 +1 @@
+"use strict";

package/dist/helpers/QueryBuilders/BaseQueryBuilders/BaseInsertQueryBuilder.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=BaseInsertQueryBuilder.d.ts.map

package/dist/helpers/QueryBuilders/BaseQueryBuilders/BaseInsertQueryBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseInsertQueryBuilder.d.ts","sourceRoot":"","sources":["../../../../src/helpers/QueryBuilders/BaseQueryBuilders/BaseInsertQueryBuilder.ts"],"names":[],"mappings":""}

package/dist/helpers/QueryBuilders/BaseQueryBuilders/BaseInsertQueryBuilder.js

@@ -0,0 +1,11 @@
+"use strict";
+// import IQueryBuilder from "../../../interfaces/IQueryBuilder.js";
+// export default class BaseInsertQueryBuilder implements IQueryBuilder {
+//     private tableName: string;
+//     constructor(tableName: string) {
+//         this.tableName = tableName;
+//     }
+//     async build(): Promise<string> {
+//         return `INSERT INTO "${this.tableName}"`;
+//     }
+// }

package/dist/helpers/QueryBuilders/BaseQueryBuilders/BaseSelectQueryBuilder.d.ts

@@ -0,0 +1,11 @@
+import { QueryContext } from "../../../index";
+import IQueryBuilder from "../../../interfaces/IQueryBuilder.js";
+export default class BaseSelectQueryBuilder implements IQueryBuilder {
+    private tableName;
+    private select;
+    private joinsSelect?;
+    private expressionsSelect?;
+    constructor(tableName: string, select: string[], joinsSelect?: string[], expressionsSelect?: string[]);
+    build(): Promise<QueryContext>;
+}
+//# sourceMappingURL=BaseSelectQueryBuilder.d.ts.map

package/dist/helpers/QueryBuilders/BaseQueryBuilders/BaseSelectQueryBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseSelectQueryBuilder.d.ts","sourceRoot":"","sources":["../../../../src/helpers/QueryBuilders/BaseQueryBuilders/BaseSelectQueryBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,aAAa,MAAM,mCAAmC,CAAC;AAE9D,MAAM,CAAC,OAAO,OAAO,sBAAuB,YAAW,aAAa;IAChE,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAW;IACzB,OAAO,CAAC,WAAW,CAAC,CAAW;IAC/B,OAAO,CAAC,iBAAiB,CAAC,CAAW;gBAEzB,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,EAAE,iBAAiB,CAAC,EAAE,MAAM,EAAE;IAO/F,KAAK,IAAI,OAAO,CAAC,YAAY,CAAC;CAQvC"}

package/dist/helpers/QueryBuilders/BaseQueryBuilders/BaseSelectQueryBuilder.js

@@ -0,0 +1,27 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+export default class BaseSelectQueryBuilder {
+    constructor(tableName, select, joinsSelect, expressionsSelect) {
+        this.tableName = tableName;
+        this.select = select;
+        this.joinsSelect = joinsSelect;
+        this.expressionsSelect = expressionsSelect;
+    }
+    build() {
+        return __awaiter(this, void 0, void 0, function* () {
+            return {
+                select: this.select,
+                joinsSelect: this.joinsSelect,
+                from: this.tableName,
+                expressionSelect: this.expressionsSelect,
+            };
+        });
+    }
+}

package/dist/helpers/QueryBuilders/BaseQueryBuilders/BaseUpdateQueryBuilder.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=BaseUpdateQueryBuilder.d.ts.map

package/dist/helpers/QueryBuilders/BaseQueryBuilders/BaseUpdateQueryBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseUpdateQueryBuilder.d.ts","sourceRoot":"","sources":["../../../../src/helpers/QueryBuilders/BaseQueryBuilders/BaseUpdateQueryBuilder.ts"],"names":[],"mappings":""}

package/dist/helpers/QueryBuilders/BaseQueryBuilders/BaseUpdateQueryBuilder.js

@@ -0,0 +1 @@
+"use strict";

package/dist/helpers/QueryBuilders/ExpressionBuilders/JsonAggregateExpression.d.ts

@@ -0,0 +1,9 @@
+import { expressionClause, JsonAggregateQueryExpression } from "../../../index.js";
+import IExpressionBuilder from "../../../interfaces/IExpressionBuilder.js";
+export default class JsonAggregateExpression implements IExpressionBuilder {
+    build(expression: JsonAggregateQueryExpression): expressionClause;
+    private buildJsonBuildObject;
+    validate(expression: JsonAggregateQueryExpression): boolean;
+    get defaultRequirements(): JsonAggregateQueryExpression['requirements'];
+}
+//# sourceMappingURL=JsonAggregateExpression.d.ts.map

package/dist/helpers/QueryBuilders/ExpressionBuilders/JsonAggregateExpression.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsonAggregateExpression.d.ts","sourceRoot":"","sources":["../../../../src/helpers/QueryBuilders/ExpressionBuilders/JsonAggregateExpression.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,4BAA4B,EAAwE,MAAM,gBAAgB,CAAC;AACtJ,OAAO,kBAAkB,MAAM,wCAAwC,CAAC;AAUxE,MAAM,CAAC,OAAO,OAAO,uBAAwB,YAAW,kBAAkB;IACtE,KAAK,CAAC,UAAU,EAAE,4BAA4B,GAAG,gBAAgB;IA8BjE,OAAO,CAAC,oBAAoB;IAqE5B,QAAQ,CAAC,UAAU,EAAE,4BAA4B,GAAG,OAAO;IAa3D,IAAI,mBAAmB,IAAI,4BAA4B,CAAC,cAAc,CAAC,CAOtE;CACJ"}

package/dist/helpers/QueryBuilders/ExpressionBuilders/JsonAggregateExpression.js

@@ -0,0 +1,102 @@
+import InvalidExpressionParametersError from "../../../helpers/Errors/ExpressionErrors/InvalidExpressionParametersError.js";
+import { QueryEvaluationPhase } from "../../../index.js";
+import QueryExpressionBuilder from "../QueryExpressionBuilder.js";
+import QueryStatementBuilder from "../QueryStatementBuilder.js";
+export default class JsonAggregateExpression {
+    build(expression) {
+        if (!this.validate(expression)) {
+            throw new InvalidExpressionParametersError("Invalid JSON aggregate expression parameters.");
+        }
+        const jsonBuildObjects = this.buildJsonBuildObject(expression);
+        const baseExpressionClause = `JSON_AGG(
+            ${jsonBuildObjects.sql}
+        ) AS ${expression.parameters.alias}`;
+        const groupByClause = expression.parameters.groupByColumns.length > 0
+            ? expression.parameters.groupByColumns
+                .map(col => col.includes(".") ? `"${col.replace(".", "__")}"` : `"${col}"`)
+                .join(", ")
+            : undefined;
+        return {
+            baseExpressionClause,
+            phase: expression.requirements.phase,
+            requiresWrapping: expression.requirements.requiresSelectWrapping || false,
+            groupByClause,
+            whereClause: jsonBuildObjects.whereClause,
+            valueClauseKeywords: jsonBuildObjects.valueClauseKeywords,
+            havingClause: expression.parameters.having
+        };
+    }
+    buildJsonBuildObject(expression) {
+        var _a, _b;
+        const columnPart = expression.parameters.columns
+            .map(col => `'${col}', "${expression.parameters.table}_${col}"`)
+            .join(",\n  ");
+        const computedPart = ((_a = expression.parameters.computed) === null || _a === void 0 ? void 0 : _a.length)
+            ? expression.parameters.computed
+                .map(comp => {
+                var _a;
+                const valueClauseKeywords = [`${comp.parameters.alias}_lat`, `${comp.parameters.alias}_lon`];
+                const expr = {
+                    type: comp.type,
+                    parameters: Object.assign(Object.assign({}, comp.parameters), { valueClauseKeywords: comp.type === 'spatialDistance' ? valueClauseKeywords : comp.parameters.valueClauseKeywords, isComputed: true }),
+                    requirements: QueryExpressionBuilder.getExpressionDefaultRequirements(comp.type)
+                };
+                const builder = QueryExpressionBuilder.buildExpressionsPart([expr])[0];
+                return {
+                    sql: `'${comp.parameters.alias}', ${(_a = builder.baseExpressionClause) === null || _a === void 0 ? void 0 : _a.split(" AS ")[0]}`,
+                    whereClause: builder.whereClause,
+                    valueClauseKeywords: builder.valueClauseKeywords
+                };
+            }) : [];
+        const computedSqlPart = computedPart.length
+            ? computedPart.map(c => c.sql).join(",\n  ")
+            : "";
+        const whereClauses = computedPart
+            .flatMap(c => c.whereClause ? QueryStatementBuilder.normalizeQueryConditions(c.whereClause) : []);
+        const valueClauseKeywords = computedPart
+            .flatMap(c => c.valueClauseKeywords || []);
+        const nestedPart = ((_b = expression.parameters.nested) === null || _b === void 0 ? void 0 : _b.length)
+            ? expression.parameters.nested
+                .map(n => {
+                return `'${n.alias}', ${this.buildJsonBuildObject({
+                    type: 'jsonAggregate',
+                    parameters: {
+                        table: n.table,
+                        alias: n.alias,
+                        columns: n.columns,
+                        computed: n.computed,
+                        nested: n.nested,
+                        groupByColumns: []
+                    },
+                    requirements: this.defaultRequirements
+                }).sql}`;
+            })
+                .join(",\n  ")
+            : "";
+        const parts = [columnPart, computedSqlPart, nestedPart].filter(Boolean).join(",\n  ");
+        return {
+            sql: `JSON_BUILD_OBJECT(
+                ${parts}
+            )`,
+            whereClause: whereClauses,
+            valueClauseKeywords: valueClauseKeywords
+        };
+    }
+    validate(expression) {
+        if (expression.type !== 'jsonAggregate') {
+            return false;
+        }
+        return (Array.isArray(expression.parameters.columns) &&
+            typeof expression.parameters.table === 'string' &&
+            Array.isArray(expression.parameters.groupByColumns) &&
+            typeof expression.parameters.alias === 'string');
+    }
+    get defaultRequirements() {
+        return {
+            phase: QueryEvaluationPhase.PROJECTION,
+            cardinality: 'row',
+            requiresAlias: true,
+            requiresSelectWrapping: true
+        };
+    }
+}

package/dist/helpers/QueryBuilders/ExpressionBuilders/SpatialDistanceExpression.d.ts

@@ -0,0 +1,8 @@
+import IExpressionBuilder from "../../../interfaces/IExpressionBuilder.js";
+import { expressionClause, SpatialQueryExpression } from "../../../types/index.js";
+export default class SpatialDistanceExpression implements IExpressionBuilder {
+    build(expression: SpatialQueryExpression): expressionClause;
+    validate(expression: SpatialQueryExpression): boolean;
+    get defaultRequirements(): SpatialQueryExpression['requirements'];
+}
+//# sourceMappingURL=SpatialDistanceExpression.d.ts.map

package/dist/helpers/QueryBuilders/ExpressionBuilders/SpatialDistanceExpression.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpatialDistanceExpression.d.ts","sourceRoot":"","sources":["../../../../src/helpers/QueryBuilders/ExpressionBuilders/SpatialDistanceExpression.ts"],"names":[],"mappings":"AACA,OAAO,kBAAkB,MAAM,wCAAwC,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAwB,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAGtG,MAAM,CAAC,OAAO,OAAO,yBAA0B,YAAW,kBAAkB;IACxE,KAAK,CAAC,UAAU,EAAE,sBAAsB,GAAG,gBAAgB;IAkD3D,QAAQ,CAAC,UAAU,EAAE,sBAAsB,GAAG,OAAO;IAcrD,IAAI,mBAAmB,IAAI,sBAAsB,CAAC,cAAc,CAAC,CAOhE;CACJ"}

package/dist/helpers/QueryBuilders/ExpressionBuilders/SpatialDistanceExpression.js

@@ -0,0 +1,63 @@
+import InvalidExpressionParametersError from "../../../helpers/Errors/ExpressionErrors/InvalidExpressionParametersError.js";
+import { QueryEvaluationPhase } from "../../../types/index.js";
+import QueryStatementBuilder from "../QueryStatementBuilder.js";
+export default class SpatialDistanceExpression {
+    build(expression) {
+        var _a;
+        if (!this.validate(expression)) {
+            throw new InvalidExpressionParametersError("Invalid spatial distance expression parameters.");
+        }
+        const earthRadius = (_a = expression.parameters.earthRadius) !== null && _a !== void 0 ? _a : (expression.parameters.unit === 'km' ? 6371 : 3959);
+        const isComputed = expression.parameters.isComputed;
+        const baseExpressionClause = `
+            ${earthRadius} * acos(
+                cos(radians(@${expression.parameters.valueClauseKeywords[0]}))
+                * cos(radians(${isComputed ? expression.parameters.targetColumns.lat.replace(".", "_") : `${expression.parameters.targetColumns.lat}`}))
+                * cos(
+                    radians(${isComputed ? expression.parameters.targetColumns.lon.replace(".", "_") : `${expression.parameters.targetColumns.lon}`})
+                    - radians(@${expression.parameters.valueClauseKeywords[1]})
+                )
+                + sin(radians(@${expression.parameters.valueClauseKeywords[0]}))
+                * sin(radians(${isComputed ? expression.parameters.targetColumns.lat.replace(".", "_") : `${expression.parameters.targetColumns.lat}`}))
+            ) AS ${expression.parameters.alias}
+        `.trim();
+        const orderByClause = {
+            column: expression.parameters.alias,
+            direction: expression.parameters.orderByDistance || 'ASC'
+        };
+        return {
+            baseExpressionClause,
+            phase: expression.requirements.phase,
+            requiresWrapping: expression.requirements.requiresSelectWrapping || false,
+            whereClause: [
+                {
+                    column: expression.parameters.alias,
+                    operator: '<=',
+                    value: expression.parameters.maxDistance
+                },
+                ...QueryStatementBuilder.normalizeQueryConditions(expression.parameters.where || [])
+            ],
+            valueClauseKeywords: expression.parameters.valueClauseKeywords,
+            orderByClause
+        };
+    }
+    validate(expression) {
+        // Basic validation for spatial distance expression
+        return (expression.type === 'spatialDistance' &&
+            typeof expression.parameters.referencePoint.lat === 'number' &&
+            typeof expression.parameters.referencePoint.lon === 'number' &&
+            typeof expression.parameters.targetColumns.lat === 'string' &&
+            typeof expression.parameters.targetColumns.lon === 'string' &&
+            (expression.parameters.unit === 'km' ||
+                expression.parameters.unit === 'miles') &&
+            typeof expression.parameters.alias === 'string');
+    }
+    get defaultRequirements() {
+        return {
+            phase: QueryEvaluationPhase.PROJECTION,
+            cardinality: 'row',
+            requiresAlias: true,
+            requiresSelectWrapping: true
+        };
+    }
+}

package/dist/helpers/QueryBuilders/ExpressionBuilders/TextRelevanceExpression.d.ts

@@ -0,0 +1,8 @@
+import IExpressionBuilder from "../../../interfaces/IExpressionBuilder.js";
+import { expressionClause, QueryExpressionRequirements, TextRelevanceQueryExpression } from "../../../types/index.js";
+export default class TextRelevanceExpression implements IExpressionBuilder {
+    build(expression: TextRelevanceQueryExpression): expressionClause;
+    validate(expression: TextRelevanceQueryExpression): boolean;
+    get defaultRequirements(): QueryExpressionRequirements;
+}
+//# sourceMappingURL=TextRelevanceExpression.d.ts.map

package/dist/helpers/QueryBuilders/ExpressionBuilders/TextRelevanceExpression.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextRelevanceExpression.d.ts","sourceRoot":"","sources":["../../../../src/helpers/QueryBuilders/ExpressionBuilders/TextRelevanceExpression.ts"],"names":[],"mappings":"AACA,OAAO,kBAAkB,MAAM,wCAAwC,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAwB,2BAA2B,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAC;AAEzI,MAAM,CAAC,OAAO,OAAO,uBAAwB,YAAW,kBAAkB;IACtE,KAAK,CAAC,UAAU,EAAE,4BAA4B,GAAG,gBAAgB;IAqCjE,QAAQ,CAAC,UAAU,EAAE,4BAA4B,GAAG,OAAO;IAW3D,IAAI,mBAAmB,IAAI,2BAA2B,CAOrD;CACJ"}

package/dist/helpers/QueryBuilders/ExpressionBuilders/TextRelevanceExpression.js

@@ -0,0 +1,49 @@
+import InvalidExpressionParametersError from "../../../helpers/Errors/ExpressionErrors/InvalidExpressionParametersError.js";
+import { QueryEvaluationPhase } from "../../../types/index.js";
+export default class TextRelevanceExpression {
+    build(expression) {
+        if (!this.validate(expression)) {
+            throw new InvalidExpressionParametersError("Invalid text relevance expression parameters.");
+        }
+        // Score: 3 = exact match, 2 = starts with, 1 = contains, 0 = no match
+        const columnConcat = expression.parameters.targetColumns
+            .map(col => `COALESCE(${col}, '')`)
+            .join(" || ' ' || ");
+        const baseExpressionClause = `(
+            CASE 
+                WHEN LOWER(${columnConcat}) = LOWER(@${expression.parameters.valueClauseKeywords[0]}) THEN 3
+                WHEN LOWER(${columnConcat}) LIKE LOWER(@${expression.parameters.valueClauseKeywords[0]} || '%') THEN 2
+                WHEN LOWER(${columnConcat}) LIKE LOWER('%' || @${expression.parameters.valueClauseKeywords[0]} || '%') THEN 1
+                ELSE 0
+            END
+        ) AS ${expression.parameters.alias}`;
+        const orderByClause = {
+            column: expression.parameters.alias,
+            direction: expression.parameters.orderByRelevance || 'ASC'
+        };
+        return {
+            baseExpressionClause,
+            phase: expression.requirements.phase,
+            requiresWrapping: expression.requirements.requiresSelectWrapping || false,
+            whereClause: expression.parameters.where,
+            valueClauseKeywords: expression.parameters.valueClauseKeywords,
+            orderByClause,
+        };
+    }
+    validate(expression) {
+        return (expression.type === 'textRelevance' &&
+            typeof expression.parameters.searchTerm === 'string' &&
+            Array.isArray(expression.parameters.targetColumns) &&
+            expression.parameters.targetColumns.every(col => typeof col === 'string') &&
+            typeof expression.parameters.alias === 'string' &&
+            typeof expression.parameters.minimumRelevance == 'number');
+    }
+    get defaultRequirements() {
+        return {
+            phase: QueryEvaluationPhase.PROJECTION,
+            cardinality: 'row',
+            requiresAlias: true,
+            requiresSelectWrapping: true
+        };
+    }
+}

package/dist/helpers/QueryBuilders/QueryDecorators/ExpressionDecorator.d.ts

@@ -0,0 +1,19 @@
+import { expressionClause, OrderByDefinition, QueryComparisonParameters, QueryContext } from "../../../types/index.js";
+import QueryDecorator from "./QueryDecorator.js";
+import IQueryBuilder from "../../../interfaces/IQueryBuilder.js";
+export default class ExpressionDecorator extends QueryDecorator {
+    private parsedExpressions;
+    whereClauses?: QueryComparisonParameters[];
+    orderByClauses?: OrderByDefinition[];
+    groupByClauses?: string[];
+    havingClauses?: QueryComparisonParameters[];
+    valueClauseKeywords: Set<string>;
+    constructor(component: IQueryBuilder, expressions: expressionClause[]);
+    build(): Promise<QueryContext>;
+    setWhereClauses(): void;
+    setOrderByClauses(): void;
+    setGroupByClauses(): void;
+    setHavingClauses(): void;
+    setValueClauseKeywords(): void;
+}
+//# sourceMappingURL=ExpressionDecorator.d.ts.map

package/dist/helpers/QueryBuilders/QueryDecorators/ExpressionDecorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExpressionDecorator.d.ts","sourceRoot":"","sources":["../../../../src/helpers/QueryBuilders/QueryDecorators/ExpressionDecorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpH,OAAO,cAAc,MAAM,qBAAqB,CAAC;AACjD,OAAO,aAAa,MAAM,mCAAmC,CAAC;AAG9D,MAAM,CAAC,OAAO,OAAO,mBAAoB,SAAQ,cAAc;IAC3D,OAAO,CAAC,iBAAiB,CAAqB;IACvC,YAAY,CAAC,EAAE,yBAAyB,EAAE,CAAC;IAC3C,cAAc,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACrC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,aAAa,CAAC,EAAE,yBAAyB,EAAE,CAAC;IAC5C,mBAAmB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAa;gBAGhD,SAAS,EAAE,aAAa,EACxB,WAAW,EAAE,gBAAgB,EAAE;IAW7B,KAAK,IAAI,OAAO,CAAC,YAAY,CAAC;IAU7B,eAAe,IAAI,IAAI;IASvB,iBAAiB,IAAI,IAAI;IAIzB,iBAAiB,IAAI,IAAI;IAIzB,gBAAgB,IAAI,IAAI;IASxB,sBAAsB,IAAI,IAAI;CASxC"}

package/dist/helpers/QueryBuilders/QueryDecorators/ExpressionDecorator.js

@@ -0,0 +1,60 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import QueryDecorator from "./QueryDecorator.js";
+import QueryStatementBuilder from "../QueryStatementBuilder.js";
+export default class ExpressionDecorator extends QueryDecorator {
+    constructor(component, expressions) {
+        super(component);
+        this.valueClauseKeywords = new Set();
+        this.parsedExpressions = expressions;
+        this.setWhereClauses();
+        this.setOrderByClauses();
+        this.setGroupByClauses();
+        this.setHavingClauses();
+        this.setValueClauseKeywords();
+    }
+    build() {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            const context = yield this.component.build();
+            (_a = context.expressionSelect) !== null && _a !== void 0 ? _a : (context.expressionSelect = []);
+            context.expressionSelect.push(...this.parsedExpressions.map(e => e.baseExpressionClause));
+            (_b = context.conditions) !== null && _b !== void 0 ? _b : (context.conditions = {});
+            return context;
+        });
+    }
+    setWhereClauses() {
+        this.whereClauses = this.parsedExpressions
+            .flatMap(expr => expr.whereClause
+            ? QueryStatementBuilder.normalizeQueryConditions(expr.whereClause)
+            : []);
+    }
+    setOrderByClauses() {
+        this.orderByClauses = this.parsedExpressions.map(expr => expr.orderByClause).filter(o => o !== undefined);
+    }
+    setGroupByClauses() {
+        this.groupByClauses = this.parsedExpressions.map(expr => expr.groupByClause).filter(g => g !== undefined);
+    }
+    setHavingClauses() {
+        this.havingClauses = this.parsedExpressions
+            .flatMap(expr => expr.havingClause
+            ? QueryStatementBuilder.normalizeQueryConditions(expr.havingClause)
+            : []);
+    }
+    setValueClauseKeywords() {
+        this.parsedExpressions.forEach(expr => {
+            if (expr.valueClauseKeywords && expr.valueClauseKeywords.length > 0) {
+                for (const keyword of expr.valueClauseKeywords) {
+                    this.valueClauseKeywords.add(keyword);
+                }
+            }
+        });
+    }
+}

package/dist/helpers/QueryBuilders/QueryDecorators/GroupByDecorator.d.ts

@@ -0,0 +1,9 @@
+import IQueryBuilder from "../../../interfaces/IQueryBuilder.js";
+import QueryDecorator from "./QueryDecorator.js";
+import { QueryContext } from "../../../types/query.js";
+export default class GroupByDecorator extends QueryDecorator {
+    private groupByColumns?;
+    constructor(component: IQueryBuilder, groupByColumns?: string[]);
+    build(): Promise<QueryContext>;
+}
+//# sourceMappingURL=GroupByDecorator.d.ts.map

package/dist/helpers/QueryBuilders/QueryDecorators/GroupByDecorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GroupByDecorator.d.ts","sourceRoot":"","sources":["../../../../src/helpers/QueryBuilders/QueryDecorators/GroupByDecorator.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,MAAM,mCAAmC,CAAC;AAC9D,OAAO,cAAc,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,MAAM,CAAC,OAAO,OAAO,gBAAiB,SAAQ,cAAc;IACxD,OAAO,CAAC,cAAc,CAAC,CAAW;gBAEtB,SAAS,EAAE,aAAa,EAAE,cAAc,CAAC,EAAE,MAAM,EAAE;IAKzD,KAAK,IAAI,OAAO,CAAC,YAAY,CAAC;CASvC"}

package/dist/helpers/QueryBuilders/QueryDecorators/GroupByDecorator.js

@@ -0,0 +1,27 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import QueryDecorator from "./QueryDecorator.js";
+export default class GroupByDecorator extends QueryDecorator {
+    constructor(component, groupByColumns) {
+        super(component);
+        this.groupByColumns = groupByColumns;
+    }
+    build() {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            const context = yield this.component.build();
+            if (this.groupByColumns) {
+                (_a = context.groupBy) !== null && _a !== void 0 ? _a : (context.groupBy = []);
+                context.groupBy.push(...this.groupByColumns);
+            }
+            return context;
+        });
+    }
+}

package/dist/helpers/QueryBuilders/QueryDecorators/JoinDecorator.d.ts

@@ -0,0 +1,15 @@
+import { QueryLayers, QueryContext } from "../../../index.js";
+import QueryDecorator from "./QueryDecorator.js";
+import IQueryBuilder from "../../../interfaces/IQueryBuilder.js";
+import { TableColumnInfo } from "../../../types/index.js";
+export default class JoinDecorator extends QueryDecorator {
+    private fromTableName;
+    private joins;
+    private tableColumnsCache;
+    private options?;
+    constructor(builder: IQueryBuilder, layer: QueryLayers, tableColumnInformation: Map<string, TableColumnInfo[]>);
+    build(): Promise<QueryContext>;
+    private buildJoinSelect;
+    private buildJoinPart;
+}
+//# sourceMappingURL=JoinDecorator.d.ts.map

package/dist/helpers/QueryBuilders/QueryDecorators/JoinDecorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JoinDecorator.d.ts","sourceRoot":"","sources":["../../../../src/helpers/QueryBuilders/QueryDecorators/JoinDecorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsD,WAAW,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC/G,OAAO,cAAc,MAAM,qBAAqB,CAAC;AACjD,OAAO,aAAa,MAAM,mCAAmC,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,cAAc;IACrD,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,iBAAiB,CAAiC;IAC1D,OAAO,CAAC,OAAO,CAAC,CAAgD;gBAEpD,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,WAAW,EAAE,sBAAsB,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC;IAmBxG,KAAK,IAAI,OAAO,CAAC,YAAY,CAAC;YActB,eAAe;IAuB7B,OAAO,CAAC,aAAa;CAgBxB"}