@iamkirbki/database-handler-core 4.3.0 → 4.4.0

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"}

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

@@ -0,0 +1,74 @@
+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 JoinDecorator extends QueryDecorator {
+    constructor(builder, layer, tableColumnInformation) {
+        var _a, _b, _c, _d, _e;
+        if (!layer.base.from) {
+            throw new Error("Base layer must specify 'from' table name for JoinDecorator.");
+        }
+        super(builder);
+        this.fromTableName = layer.base.from;
+        this.joins = layer.base.joins || [];
+        this.tableColumnsCache = tableColumnInformation;
+        this.options = {
+            orderBy: (_a = layer.final) === null || _a === void 0 ? void 0 : _a.orderBy,
+            limit: (_b = layer.final) === null || _b === void 0 ? void 0 : _b.limit,
+            offset: (_c = layer.final) === null || _c === void 0 ? void 0 : _c.offset,
+            groupBy: (_d = layer.pretty) === null || _d === void 0 ? void 0 : _d.groupBy,
+            blacklistTables: (_e = layer.final) === null || _e === void 0 ? void 0 : _e.blacklistTables,
+        };
+    }
+    build() {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            const context = yield this.component.build();
+            const selectExtensions = yield this.buildJoinSelect();
+            const joinPart = this.buildJoinPart();
+            context.joinsSelect = selectExtensions;
+            (_a = context.joins) !== null && _a !== void 0 ? _a : (context.joins = []);
+            context.joins.push(...joinPart);
+            return context;
+        });
+    }
+    buildJoinSelect() {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            const blacklist = ((_a = this.options) === null || _a === void 0 ? void 0 : _a.blacklistTables) || [];
+            const joinArray = Array.isArray(this.joins) ? this.joins : [this.joins];
+            const mainCols = this.tableColumnsCache.get(this.fromTableName) || [];
+            const mainSelect = mainCols
+                .filter(() => !blacklist.includes(this.fromTableName))
+                .map(col => `"${this.fromTableName}"."${col.name}" AS "${this.fromTableName}__${col.name}"`);
+            const joinedSelects = yield Promise.all(joinArray.map((join) => __awaiter(this, void 0, void 0, function* () {
+                if (blacklist.includes(join.fromTable))
+                    return "";
+                const cols = this.tableColumnsCache.get(join.fromTable) || [];
+                return cols
+                    .map(col => `"${join.fromTable}"."${col.name}" AS "${join.fromTable}__${col.name}"`)
+                    .filter(col => col.trim() !== "");
+            })));
+            return [...mainSelect, ...joinedSelects.flat()].filter(s => s !== "").filter(Boolean);
+        });
+    }
+    buildJoinPart() {
+        const joinArray = Array.isArray(this.joins) ? this.joins : [this.joins];
+        return joinArray.map(join => {
+            const baseTable = join.baseTable || this.fromTableName;
+            const onConditions = Array.isArray(join.on) ? join.on : [join.on];
+            const onClause = onConditions.map(part => {
+                const targetCol = Object.keys(part)[0];
+                const sourceCol = Object.values(part)[0];
+                return `${baseTable}.${sourceCol} = ${join.fromTable}.${targetCol}`;
+            }).join(" AND ");
+            return `${join.joinType} JOIN "${join.fromTable}" ON ${onClause}`;
+        });
+    }
+}

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

@@ -0,0 +1,10 @@
+import IQueryBuilder from "../../../interfaces/IQueryBuilder.js";
+import QueryDecorator from "./QueryDecorator.js";
+import { QueryContext } from "../../../types/query.js";
+export default class LimitDecorator extends QueryDecorator {
+    private limitCount;
+    private offsetCount?;
+    constructor(component: IQueryBuilder, limitCount: number, offsetCount?: number);
+    build(): Promise<QueryContext>;
+}
+//# sourceMappingURL=LimitDecorator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LimitDecorator.d.ts","sourceRoot":"","sources":["../../../../src/helpers/QueryBuilders/QueryDecorators/LimitDecorator.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,cAAe,SAAQ,cAAc;IACtD,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,WAAW,CAAC,CAAS;gBAEjB,SAAS,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM;IAMxE,KAAK,IAAI,OAAO,CAAC,YAAY,CAAC;CAYvC"}

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

@@ -0,0 +1,29 @@
+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 LimitDecorator extends QueryDecorator {
+    constructor(component, limitCount, offsetCount) {
+        super(component);
+        this.limitCount = limitCount;
+        this.offsetCount = offsetCount;
+    }
+    build() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const context = yield this.component.build();
+            if (this.limitCount) {
+                context.limit = this.limitCount;
+            }
+            if (this.offsetCount) {
+                context.offset = this.offsetCount;
+            }
+            return context;
+        });
+    }
+}

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

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

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

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

package/dist/helpers/QueryBuilders/QueryDecorators/OrderByDecorator.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 OrderByDecorator extends QueryDecorator {
+    constructor(component, orderByColumns) {
+        super(component);
+        this.orderByColumns = orderByColumns;
+    }
+    build() {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            const context = yield this.component.build();
+            if (this.orderByColumns) {
+                (_a = context.orderBy) !== null && _a !== void 0 ? _a : (context.orderBy = []);
+                context.orderBy.push(...this.orderByColumns);
+            }
+            return context;
+        });
+    }
+}

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

@@ -0,0 +1,8 @@
+import IQueryBuilder from "../../../interfaces/IQueryBuilder";
+import { QueryContext } from "../../../types/query";
+export default abstract class QueryDecorator implements IQueryBuilder {
+    protected component: IQueryBuilder;
+    constructor(component: IQueryBuilder);
+    abstract build(): Promise<QueryContext>;
+}
+//# sourceMappingURL=QueryDecorator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"QueryDecorator.d.ts","sourceRoot":"","sources":["../../../../src/helpers/QueryBuilders/QueryDecorators/QueryDecorator.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,MAAM,gCAAgC,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,MAAM,CAAC,OAAO,CAAC,QAAQ,OAAO,cAAe,YAAW,aAAa;IACjE,SAAS,CAAC,SAAS,EAAE,aAAa,CAAC;gBAEvB,SAAS,EAAE,aAAa;IAIpC,QAAQ,CAAC,KAAK,IAAI,OAAO,CAAC,YAAY,CAAC;CAC1C"}

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

@@ -0,0 +1,5 @@
+export default class QueryDecorator {
+    constructor(component) {
+        this.component = component;
+    }
+}

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

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

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

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

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

@@ -0,0 +1,17 @@
+"use strict";
+// import IQueryBuilder from "../../../interfaces/IQueryBuilder.js";
+// import { columnType } from "../../../types/index.js";
+// import QueryDecorator from "./QueryDecorator";
+// export default class ValuesDecorator extends QueryDecorator {
+//     private values: columnType[];
+//     constructor(component: IQueryBuilder, values: columnType[]) {
+//         super(component);
+//         this.values = values;
+//     }
+//     async build(): Promise<string> {
+//         const baseQuery = await this.component.build();
+//         const columns = Object.keys(this.values);
+//         const placeholders = columns.map((col) => `@${col}`);
+//         return `${baseQuery} ${columns.map((c) => `"${c}"`).join(", ")} VALUES (${placeholders.join(", ")})`;
+//     }
+// }

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"WhereDecorator.d.ts","sourceRoot":"","sources":["../../../../src/helpers/QueryBuilders/QueryDecorators/WhereDecorator.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,MAAM,mCAAmC,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AACzE,OAAO,cAAc,MAAM,qBAAqB,CAAC;AAGjD,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,cAAc;IACtD,OAAO,CAAC,UAAU,CAAsB;gBAGpC,SAAS,EAAE,aAAa,EACxB,UAAU,EAAE,mBAAmB;IAM7B,KAAK,IAAI,OAAO,CAAC,YAAY,CAAC;CAUvC"}

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

@@ -0,0 +1,29 @@
+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 WhereDecorator extends QueryDecorator {
+    constructor(component, conditions) {
+        super(component);
+        this.conditions = conditions;
+    }
+    build() {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            var _c;
+            const context = yield this.component.build();
+            const combinedConditions = [...QueryStatementBuilder.normalizeQueryConditions(this.conditions)];
+            (_a = context.conditions) !== null && _a !== void 0 ? _a : (context.conditions = {});
+            (_b = (_c = context.conditions).where) !== null && _b !== void 0 ? _b : (_c.where = []);
+            context.conditions.where.push(...combinedConditions);
+            return context;
+        });
+    }
+}

package/dist/helpers/QueryBuilders/QueryExpressionBuilder.d.ts

@@ -0,0 +1,54 @@
+import { PossibleExpressions, ExpressionBuilderFunction, expressionClause } from "../../types/index.js";
+/**
+ * A normalized, intermediate representation of a query expression.
+ *
+ * Expressions are NOT SQL strings directly — they are metadata-rich
+ * building blocks that later stages of the query builder can reason about.
+ *
+ * This is what allows:
+ * - base vs projection expressions
+ * - conditional query wrapping
+ * - expression-driven WHERE / ORDER BY injection
+ */
+/**
+ * Central factory and orchestration layer for query expressions.
+ *
+ * This class is intentionally:
+ * - static
+ * - registry-driven
+ * - dumb about SQL execution
+ *
+ * Its ONLY job is to translate abstract expressions
+ * into structured SQL fragments with metadata.
+ */
+export default class QueryExpressionBuilder {
+    /**
+     * Registry mapping expression "type" → builder function.
+     *
+     * This allows:
+     * - zero switch statements
+     * - easy plugin-style extension
+     * - no touching core logic to add new expressions
+     */
+    private static expressionBuilders;
+    private static expressionDefaults;
+    static getExpressionDefaultRequirements(type: string): PossibleExpressions['requirements'] | undefined;
+    /**
+     * Registers a new expression builder at runtime.
+     *
+     * This is your “escape hatch” when core expressions
+     * are not enough.
+     *
+     * @param type - expression.type value
+     * @param builder - function that converts expression → expressionClause
+     */
+    static registerExpressionBuilder<T extends PossibleExpressions>(type: string, builder: ExpressionBuilderFunction<T>): void;
+    /**
+     * Converts high-level expression definitions into normalized clauses.
+     *
+     * Any expression without a registered builder is ignored
+     * (with a error, because silence is how bugs breed).
+     */
+    static buildExpressionsPart(expressions: PossibleExpressions[]): expressionClause[];
+}
+//# sourceMappingURL=QueryExpressionBuilder.d.ts.map

package/dist/helpers/QueryBuilders/QueryExpressionBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueryExpressionBuilder.d.ts","sourceRoot":"","sources":["../../../src/helpers/QueryBuilders/QueryExpressionBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,mBAAmB,EAEnB,yBAAyB,EACzB,gBAAgB,EAGnB,MAAM,sBAAsB,CAAC;AAM9B;;;;;;;;;;GAUG;AAEH;;;;;;;;;;GAUG;AACH,MAAM,CAAC,OAAO,OAAO,sBAAsB;IAEvC;;;;;;;OAOG;IACH,OAAO,CAAC,MAAM,CAAC,kBAAkB,CA0B9B;IAEH,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAa9B;WAEW,gCAAgC,CAC1C,IAAI,EAAE,MAAM,GACb,mBAAmB,CAAC,cAAc,CAAC,GAAG,SAAS;IAIlD;;;;;;;;OAQG;WACW,yBAAyB,CAAC,CAAC,SAAS,mBAAmB,EACjE,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,yBAAyB,CAAC,CAAC,CAAC,GACtC,IAAI;IAIP;;;;;OAKG;WACW,oBAAoB,CAC9B,WAAW,EAAE,mBAAmB,EAAE,GACnC,gBAAgB,EAAE;CAexB"}