@stingerloom/orm 0.1.0

package/dist/core/QueryTracker.js

@@ -0,0 +1,111 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QueryTracker = void 0;
+const Logger_1 = require("../utils/Logger");
+class QueryTracker {
+    constructor(options) {
+        this.log = [];
+        this.logger = new Logger_1.Logger("QueryTracker");
+        this.warned = new Set();
+        this._activeQueryCount = 0;
+        this.windowMs = options?.windowMs ?? 100;
+        this.threshold = options?.threshold ?? 10;
+        this.slowQueryMs = options?.slowQueryMs ?? null;
+        this.maxLogEntries = options?.maxLogEntries ?? 1000;
+        this.enabled = options?.enabled ?? true;
+        this.ttlMs = options?.ttlMs ?? 0;
+    }
+    track(entityName, sqlText, durationMs) {
+        if (!this.enabled)
+            return;
+        const now = Date.now();
+        if (this.ttlMs > 0) {
+            this.evictExpired(now);
+        }
+        this.log.push({
+            entityName,
+            sql: sqlText,
+            durationMs,
+            timestamp: now,
+        });
+        if (this.maxLogEntries > 0 && this.log.length > this.maxLogEntries) {
+            this.log.splice(0, this.log.length - this.maxLogEntries);
+        }
+        if (this.slowQueryMs !== null && durationMs > this.slowQueryMs) {
+            this.logger.warn(`[SLOW QUERY] ${durationMs}ms: ${sqlText}`);
+        }
+        this.detectNPlusOne(entityName, now);
+    }
+    getLog() {
+        return this.log;
+    }
+    get activeQueryCount() {
+        return this._activeQueryCount;
+    }
+    beginQuery() {
+        this._activeQueryCount++;
+    }
+    endQuery() {
+        if (this._activeQueryCount > 0) {
+            this._activeQueryCount--;
+        }
+    }
+    async waitForQueries(timeoutMs) {
+        if (this._activeQueryCount === 0)
+            return true;
+        const start = Date.now();
+        return new Promise((resolve) => {
+            const check = () => {
+                if (this._activeQueryCount === 0) {
+                    resolve(true);
+                    return;
+                }
+                if (Date.now() - start >= timeoutMs) {
+                    resolve(false);
+                    return;
+                }
+                setTimeout(check, 50);
+            };
+            check();
+        });
+    }
+    reset() {
+        this.log.length = 0;
+        this.warned.clear();
+    }
+    evictExpired(now) {
+        const cutoff = now - this.ttlMs;
+        let removeCount = 0;
+        for (let i = 0; i < this.log.length; i++) {
+            if (this.log[i].timestamp < cutoff) {
+                removeCount++;
+            }
+            else {
+                break;
+            }
+        }
+        if (removeCount > 0) {
+            this.log.splice(0, removeCount);
+        }
+    }
+    detectNPlusOne(entityName, now) {
+        if (this.warned.has(entityName))
+            return;
+        const windowStart = now - this.windowMs;
+        let count = 0;
+        for (let i = this.log.length - 1; i >= 0; i--) {
+            const entry = this.log[i];
+            if (entry.timestamp < windowStart)
+                break;
+            if (entry.entityName === entityName) {
+                count++;
+            }
+        }
+        if (count >= this.threshold) {
+            this.logger.warn(`[N+1 WARNING] Entity "${entityName}" queried ${count}+ times in ${this.windowMs}ms. Consider using eager loading or relations option.`);
+            this.warned.add(entityName);
+        }
+    }
+}
+exports.QueryTracker = QueryTracker;
+//# sourceMappingURL=QueryTracker.js.map

package/dist/core/QueryTracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueryTracker.js","sourceRoot":"","sources":["../../src/core/QueryTracker.ts"],"names":[],"mappings":"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"}

package/dist/core/RawQueryBuilder.d.ts

@@ -0,0 +1,40 @@
+import { Sql } from "sql-template-tag";
+import { BaseRawQueryBuilder } from "./BaseRawQueryBuilder";
+export type DatabaseType = "mysql" | "postgresql";
+export type SubqueryType = "SELECT" | "FROM" | "WHERE" | "HAVING";
+export declare class RawQueryBuilder implements BaseRawQueryBuilder {
+    private sqlQuerySegments;
+    private dbType;
+    private isSubquery;
+    static create(): RawQueryBuilder;
+    static subquery(): RawQueryBuilder;
+    setDatabaseType(type: DatabaseType): RawQueryBuilder;
+    select(columns: string[] | "*"): RawQueryBuilder;
+    from(table: string | Sql, alias?: string): RawQueryBuilder;
+    where(conditions: Sql[]): RawQueryBuilder;
+    andWhere(condition: Sql): RawQueryBuilder;
+    orWhere(condition: Sql): RawQueryBuilder;
+    whereIn(column: string, values: any[]): RawQueryBuilder;
+    whereNotIn(column: string, values: any[]): RawQueryBuilder;
+    whereNull(column: string): RawQueryBuilder;
+    whereNotNull(column: string): RawQueryBuilder;
+    whereBetween(column: string, min: any, max: any): RawQueryBuilder;
+    orderBy(orders: Array<{
+        column: string;
+        direction: "ASC" | "DESC";
+    }>): RawQueryBuilder;
+    limit(limit: number | [number, number]): RawQueryBuilder;
+    join(type: "INNER" | "LEFT" | "RIGHT", table: string | Sql, alias: string, condition: Sql): RawQueryBuilder;
+    groupBy(columns: string[]): RawQueryBuilder;
+    having(conditions: Sql[]): RawQueryBuilder;
+    leftJoin(table: string | Sql, alias: string, condition: Sql): RawQueryBuilder;
+    innerJoin(table: string | Sql, alias: string, condition: Sql): RawQueryBuilder;
+    rightJoin(table: string | Sql, alias: string, condition: Sql): RawQueryBuilder;
+    offset(offset: number): RawQueryBuilder;
+    appendSql(sqlFragment: Sql): RawQueryBuilder;
+    as(alias: string): Sql;
+    asInQuery(): Sql;
+    asExists(): Sql;
+    build(): Sql;
+}
+//# sourceMappingURL=RawQueryBuilder.d.ts.map

package/dist/core/RawQueryBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RawQueryBuilder.d.ts","sourceRoot":"","sources":["../../src/core/RawQueryBuilder.ts"],"names":[],"mappings":"AAAA,OAAY,EAAE,GAAG,EAAa,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,YAAY,CAAC;AAClD,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAQlE,qBAAa,eAAgB,YAAW,mBAAmB;IACzD,OAAO,CAAC,gBAAgB,CAAa;IACrC,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,UAAU,CAAkB;IAKpC,MAAM,CAAC,MAAM,IAAI,eAAe;IAOhC,MAAM,CAAC,QAAQ,IAAI,eAAe;IAWlC,eAAe,CAAC,IAAI,EAAE,YAAY,GAAG,eAAe;IAUpD,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,GAAG,GAAG,eAAe;IAgBhD,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,eAAe;IAqB1D,KAAK,CAAC,UAAU,EAAE,GAAG,EAAE,GAAG,eAAe;IAezC,QAAQ,CAAC,SAAS,EAAE,GAAG,GAAG,eAAe;IAWzC,OAAO,CAAC,SAAS,EAAE,GAAG,GAAG,eAAe;IAYxC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,eAAe;IAcvD,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,eAAe;IAa1D,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe;IAU1C,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe;IAY7C,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,GAAG,eAAe;IAYjE,OAAO,CACL,MAAM,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,KAAK,GAAG,MAAM,CAAA;KAAE,CAAC,GAC3D,eAAe;IAelB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,eAAe;IAyBxD,IAAI,CACF,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,EAChC,KAAK,EAAE,MAAM,GAAG,GAAG,EACnB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,GAAG,GACb,eAAe;IAgClB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,eAAe;IAY3C,MAAM,CAAC,UAAU,EAAE,GAAG,EAAE,GAAG,eAAe;IAU1C,QAAQ,CACN,KAAK,EAAE,MAAM,GAAG,GAAG,EACnB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,GAAG,GACb,eAAe;IAQlB,SAAS,CACP,KAAK,EAAE,MAAM,GAAG,GAAG,EACnB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,GAAG,GACb,eAAe;IAQlB,SAAS,CACP,KAAK,EAAE,MAAM,GAAG,GAAG,EACnB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,GAAG,GACb,eAAe;IAUlB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe;IAUvC,SAAS,CAAC,WAAW,EAAE,GAAG,GAAG,eAAe;IAU5C,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG;IAStB,SAAS,IAAI,GAAG;IAShB,QAAQ,IAAI,GAAG;IASf,KAAK,IAAI,GAAG;CAGb"}

package/dist/core/RawQueryBuilder.js

@@ -0,0 +1,211 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RawQueryBuilder = void 0;
+const sql_template_tag_1 = __importStar(require("sql-template-tag"));
+class RawQueryBuilder {
+    constructor() {
+        this.sqlQuerySegments = [];
+        this.dbType = "mysql";
+        this.isSubquery = false;
+    }
+    static create() {
+        return new RawQueryBuilder();
+    }
+    static subquery() {
+        const builder = new RawQueryBuilder();
+        builder.isSubquery = true;
+        return builder;
+    }
+    setDatabaseType(type) {
+        this.dbType = type;
+        return this;
+    }
+    select(columns) {
+        if (columns === "*") {
+            this.sqlQuerySegments.push((0, sql_template_tag_1.default) `SELECT *`);
+        }
+        else {
+            const columnSqls = columns.map((col) => (0, sql_template_tag_1.default) `${(0, sql_template_tag_1.raw)(col)}`);
+            this.sqlQuerySegments.push((0, sql_template_tag_1.default) `SELECT ${(0, sql_template_tag_1.join)(columnSqls, ", ")}`);
+        }
+        return this;
+    }
+    from(table, alias) {
+        if (alias) {
+            if (typeof table === "string") {
+                this.sqlQuerySegments.push((0, sql_template_tag_1.default) `FROM ${(0, sql_template_tag_1.raw)(table)} AS ${(0, sql_template_tag_1.raw)(alias)}`);
+            }
+            else {
+                this.sqlQuerySegments.push((0, sql_template_tag_1.default) `FROM ${table} ${(0, sql_template_tag_1.raw)(alias)}`);
+            }
+        }
+        else {
+            this.sqlQuerySegments.push((0, sql_template_tag_1.default) `FROM ${typeof table === "string" ? (0, sql_template_tag_1.raw)(table) : table}`);
+        }
+        return this;
+    }
+    where(conditions) {
+        if (conditions.length === 0) {
+            this.sqlQuerySegments.push((0, sql_template_tag_1.default) `WHERE 1=1`);
+        }
+        else {
+            this.sqlQuerySegments.push((0, sql_template_tag_1.default) `WHERE ${(0, sql_template_tag_1.join)(conditions, " AND ")}`);
+        }
+        return this;
+    }
+    andWhere(condition) {
+        this.sqlQuerySegments.push((0, sql_template_tag_1.default) `AND ${condition}`);
+        return this;
+    }
+    orWhere(condition) {
+        this.sqlQuerySegments.push((0, sql_template_tag_1.default) `OR ${condition}`);
+        return this;
+    }
+    whereIn(column, values) {
+        const valueSqls = values.map((v) => (0, sql_template_tag_1.default) `${v}`);
+        this.sqlQuerySegments.push((0, sql_template_tag_1.default) `AND ${(0, sql_template_tag_1.raw)(column)} IN (${(0, sql_template_tag_1.join)(valueSqls, ", ")})`);
+        return this;
+    }
+    whereNotIn(column, values) {
+        const valueSqls = values.map((v) => (0, sql_template_tag_1.default) `${v}`);
+        this.sqlQuerySegments.push((0, sql_template_tag_1.default) `AND ${(0, sql_template_tag_1.raw)(column)} NOT IN (${(0, sql_template_tag_1.join)(valueSqls, ", ")})`);
+        return this;
+    }
+    whereNull(column) {
+        this.sqlQuerySegments.push((0, sql_template_tag_1.default) `AND ${(0, sql_template_tag_1.raw)(column)} IS NULL`);
+        return this;
+    }
+    whereNotNull(column) {
+        this.sqlQuerySegments.push((0, sql_template_tag_1.default) `AND ${(0, sql_template_tag_1.raw)(column)} IS NOT NULL`);
+        return this;
+    }
+    whereBetween(column, min, max) {
+        this.sqlQuerySegments.push((0, sql_template_tag_1.default) `AND ${(0, sql_template_tag_1.raw)(column)} BETWEEN ${min} AND ${max}`);
+        return this;
+    }
+    orderBy(orders) {
+        if (orders.length === 0)
+            return this;
+        const orderSqls = orders.map(({ column, direction }) => (0, sql_template_tag_1.default) `${(0, sql_template_tag_1.raw)(column)} ${(0, sql_template_tag_1.raw)(direction)}`);
+        this.sqlQuerySegments.push((0, sql_template_tag_1.default) `ORDER BY ${(0, sql_template_tag_1.join)(orderSqls, ", ")}`);
+        return this;
+    }
+    limit(limit) {
+        if (Array.isArray(limit)) {
+            const [offset, count] = limit;
+            if (this.dbType === "mysql") {
+                this.sqlQuerySegments.push((0, sql_template_tag_1.default) `LIMIT ${offset}, ${count}`);
+            }
+            else if (this.dbType === "postgresql") {
+                this.sqlQuerySegments.push((0, sql_template_tag_1.default) `LIMIT ${count} OFFSET ${offset}`);
+            }
+            else {
+                this.sqlQuerySegments.push((0, sql_template_tag_1.default) `LIMIT ${count} OFFSET ${offset}`);
+            }
+        }
+        else {
+            this.sqlQuerySegments.push((0, sql_template_tag_1.default) `LIMIT ${limit}`);
+        }
+        return this;
+    }
+    join(type, table, alias, condition) {
+        if (typeof table === "string") {
+            if (table.includes(` AS ${alias}`)) {
+                this.sqlQuerySegments.push((0, sql_template_tag_1.default) `${(0, sql_template_tag_1.raw)(type)} JOIN ${(0, sql_template_tag_1.raw)(table)} ON ${condition}`);
+            }
+            else {
+                this.sqlQuerySegments.push((0, sql_template_tag_1.default) `${(0, sql_template_tag_1.raw)(type)} JOIN ${(0, sql_template_tag_1.raw)(table)} AS ${(0, sql_template_tag_1.raw)(alias)} ON ${condition}`);
+            }
+        }
+        else {
+            const tableStr = table.sql;
+            if (tableStr.includes(` AS ${alias}`)) {
+                this.sqlQuerySegments.push((0, sql_template_tag_1.default) `${(0, sql_template_tag_1.raw)(type)} JOIN ${table} ON ${condition}`);
+            }
+            else {
+                this.sqlQuerySegments.push((0, sql_template_tag_1.default) `${(0, sql_template_tag_1.raw)(type)} JOIN ${table} AS ${(0, sql_template_tag_1.raw)(alias)} ON ${condition}`);
+            }
+        }
+        return this;
+    }
+    groupBy(columns) {
+        if (columns.length === 0)
+            return this;
+        const columnSqls = columns.map((col) => (0, sql_template_tag_1.default) `${(0, sql_template_tag_1.raw)(col)}`);
+        this.sqlQuerySegments.push((0, sql_template_tag_1.default) `GROUP BY ${(0, sql_template_tag_1.join)(columnSqls, ", ")}`);
+        return this;
+    }
+    having(conditions) {
+        if (conditions.length === 0)
+            return this;
+        this.sqlQuerySegments.push((0, sql_template_tag_1.default) `HAVING ${(0, sql_template_tag_1.join)(conditions, " AND ")}`);
+        return this;
+    }
+    leftJoin(table, alias, condition) {
+        return this.join("LEFT", table, alias, condition);
+    }
+    innerJoin(table, alias, condition) {
+        return this.join("INNER", table, alias, condition);
+    }
+    rightJoin(table, alias, condition) {
+        return this.join("RIGHT", table, alias, condition);
+    }
+    offset(offset) {
+        this.sqlQuerySegments.push((0, sql_template_tag_1.default) `OFFSET ${offset}`);
+        return this;
+    }
+    appendSql(sqlFragment) {
+        this.sqlQuerySegments.push(sqlFragment);
+        return this;
+    }
+    as(alias) {
+        const query = this.build();
+        return (0, sql_template_tag_1.default) `(${query}) AS ${(0, sql_template_tag_1.raw)(alias)}`;
+    }
+    asInQuery() {
+        const query = this.build();
+        return (0, sql_template_tag_1.default) `(${query})`;
+    }
+    asExists() {
+        const query = this.build();
+        return (0, sql_template_tag_1.default) `EXISTS (${query})`;
+    }
+    build() {
+        return (0, sql_template_tag_1.join)(this.sqlQuerySegments, " ");
+    }
+}
+exports.RawQueryBuilder = RawQueryBuilder;
+//# sourceMappingURL=RawQueryBuilder.js.map

package/dist/core/RawQueryBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RawQueryBuilder.js","sourceRoot":"","sources":["../../src/core/RawQueryBuilder.ts"],"names":[],"mappings":"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"}

package/dist/core/RawQueryBuilderFactory.d.ts

@@ -0,0 +1,6 @@
+import { RawQueryBuilder } from "./RawQueryBuilder";
+export declare class RawQueryBuilderFactory {
+    static create(): RawQueryBuilder;
+    static subquery(): RawQueryBuilder;
+}
+//# sourceMappingURL=RawQueryBuilderFactory.d.ts.map

package/dist/core/RawQueryBuilderFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RawQueryBuilderFactory.d.ts","sourceRoot":"","sources":["../../src/core/RawQueryBuilderFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAWpD,qBAAa,sBAAsB;IACjC,MAAM,CAAC,MAAM;IAIb,MAAM,CAAC,QAAQ;CAGhB"}

package/dist/core/RawQueryBuilderFactory.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RawQueryBuilderFactory = void 0;
+const RawQueryBuilder_1 = require("./RawQueryBuilder");
+class RawQueryBuilderFactory {
+    static create() {
+        return RawQueryBuilder_1.RawQueryBuilder.create();
+    }
+    static subquery() {
+        return RawQueryBuilder_1.RawQueryBuilder.subquery();
+    }
+}
+exports.RawQueryBuilderFactory = RawQueryBuilderFactory;
+//# sourceMappingURL=RawQueryBuilderFactory.js.map

package/dist/core/RawQueryBuilderFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RawQueryBuilderFactory.js","sourceRoot":"","sources":["../../src/core/RawQueryBuilderFactory.ts"],"names":[],"mappings":";;;AAAA,uDAAoD;AAWpD,MAAa,sBAAsB;IACjC,MAAM,CAAC,MAAM;QACX,OAAO,iCAAe,CAAC,MAAM,EAAE,CAAC;IAClC,CAAC;IAED,MAAM,CAAC,QAAQ;QACb,OAAO,iCAAe,CAAC,QAAQ,EAAE,CAAC;IACpC,CAAC;CACF;AARD,wDAQC"}

package/dist/core/ResultTransformer.d.ts

@@ -0,0 +1,24 @@
+import { MyClassConstructor } from "./MyClassConstructor";
+import type { QueryResult } from "../types/QueryResult";
+import { BaseResultTransformer } from "./BaseResultTransformer";
+export type ForeignObject<T = any> = {
+    [key: string]: T;
+};
+export declare class ResultTransformer implements BaseResultTransformer {
+    private static PropertySeparator;
+    private hasNoResults;
+    private extractBaseEntity;
+    private buildNullEntity;
+    private buildEmptyEntities;
+    private createForeignObject;
+    private addSeparatorToColumnName;
+    toEntity<T>(entityClass: MyClassConstructor<T>, result: QueryResult<any> | undefined): T | undefined;
+    toEntities<T>(entityClass: MyClassConstructor<T>, result: QueryResult<any> | undefined): T[];
+    transform<T>(entityClass: MyClassConstructor<T>, result: QueryResult<any> | undefined): T | T[] | undefined;
+    private getObjectEntries;
+    private fillPropertiesToForeignObject;
+    transformNested<T>(entityClass: MyClassConstructor<T>, queryResult: QueryResult<any> | undefined, relations?: {
+        [key: string]: MyClassConstructor<any>;
+    }): T | T[] | undefined;
+}
+//# sourceMappingURL=ResultTransformer.d.ts.map

package/dist/core/ResultTransformer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResultTransformer.d.ts","sourceRoot":"","sources":["../../src/core/ResultTransformer.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAWhE,MAAM,MAAM,aAAa,CAAC,CAAC,GAAG,GAAG,IAAI;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,CAAA;CAAE,CAAC;AAE1D,qBAAa,iBAAkB,YAAW,qBAAqB;IAC7D,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAO;IAQvC,OAAO,CAAC,YAAY;IAWpB,OAAO,CAAC,iBAAiB;IAkBzB,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,kBAAkB;IAO1B,OAAO,CAAC,mBAAmB;IAO3B,OAAO,CAAC,wBAAwB;IAOzB,QAAQ,CAAC,CAAC,EACf,WAAW,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAClC,MAAM,EAAE,WAAW,CAAC,GAAG,CAAC,GAAG,SAAS,GACnC,CAAC,GAAG,SAAS;IAaT,UAAU,CAAC,CAAC,EACjB,WAAW,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAClC,MAAM,EAAE,WAAW,CAAC,GAAG,CAAC,GAAG,SAAS,GACnC,CAAC,EAAE;IAiBC,SAAS,CAAC,CAAC,EAChB,WAAW,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAClC,MAAM,EAAE,WAAW,CAAC,GAAG,CAAC,GAAG,SAAS,GACnC,CAAC,GAAG,CAAC,EAAE,GAAG,SAAS;IAuBtB,OAAO,CAAC,gBAAgB;IAWxB,OAAO,CAAC,6BAA6B;IAwG9B,eAAe,CAAC,CAAC,EACtB,WAAW,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAClC,WAAW,EAAE,WAAW,CAAC,GAAG,CAAC,GAAG,SAAS,EACzC,SAAS,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAA;KAAE,GACrD,CAAC,GAAG,CAAC,EAAE,GAAG,SAAS;CAyBvB"}

package/dist/core/ResultTransformer.js

@@ -0,0 +1,134 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResultTransformer = void 0;
+const DeserializeEntity_1 = require("./deserializer/DeserializeEntity");
+const decorators_1 = require("../decorators");
+class ResultTransformer {
+    hasNoResults(queryResult) {
+        return !queryResult?.results || queryResult.results.length === 0;
+    }
+    extractBaseEntity(entityClass, row, baseEntity) {
+        const enties = Object.entries(row);
+        for (const [key, value] of enties) {
+            const isUnderScored = key.includes(ResultTransformer.PropertySeparator);
+            if (!isUnderScored) {
+                baseEntity[key] = value;
+            }
+        }
+    }
+    buildNullEntity() {
+        return undefined;
+    }
+    buildEmptyEntities() {
+        return [];
+    }
+    createForeignObject() {
+        return {};
+    }
+    addSeparatorToColumnName(columnName) {
+        return `${columnName}${ResultTransformer.PropertySeparator}`;
+    }
+    toEntity(entityClass, result) {
+        if (this.hasNoResults(result)) {
+            return this.buildNullEntity();
+        }
+        const r = result;
+        return (0, DeserializeEntity_1.deserializeEntity)(entityClass, r.results[0]);
+    }
+    toEntities(entityClass, result) {
+        if (this.hasNoResults(result)) {
+            return this.buildEmptyEntities();
+        }
+        const r = result;
+        return r.results.map((item) => (0, DeserializeEntity_1.deserializeEntity)(entityClass, item));
+    }
+    transform(entityClass, result) {
+        if (this.hasNoResults(result)) {
+            return this.buildNullEntity();
+        }
+        const r = result;
+        const isSingleEntity = r.results.length === 1;
+        if (isSingleEntity) {
+            return (0, DeserializeEntity_1.deserializeEntity)(entityClass, r.results[0]);
+        }
+        return r.results.map((item) => (0, DeserializeEntity_1.deserializeEntity)(entityClass, item));
+    }
+    getObjectEntries(obj) {
+        return Object.entries(obj);
+    }
+    fillPropertiesToForeignObject(entityClass, baseEntity, resultSet) {
+        const manyToOneMappingMetadata = Reflect.getMetadata(decorators_1.MANY_TO_ONE_TOKEN, entityClass);
+        const foreignKeys = manyToOneMappingMetadata?.map((e) => e.columnName);
+        if (foreignKeys) {
+            for (const foreignKey of foreignKeys) {
+                if (!baseEntity[foreignKey]) {
+                    baseEntity[foreignKey] = this.createForeignObject();
+                }
+            }
+            for (const { getMappingEntity, columnName } of manyToOneMappingMetadata) {
+                const ForeignClass = getMappingEntity();
+                const rows = this.getObjectEntries(resultSet);
+                const foreignObject = this.createForeignObject();
+                for (const [key, value] of rows) {
+                    const prefix = this.addSeparatorToColumnName(columnName);
+                    const isContainsPrefix = key.startsWith(prefix);
+                    if (isContainsPrefix) {
+                        const keyWithoutPrefix = key.replace(prefix, "");
+                        foreignObject[keyWithoutPrefix] = value;
+                    }
+                }
+                const relatedManyToOneMappings = Reflect.getMetadata(decorators_1.MANY_TO_ONE_TOKEN, ForeignClass);
+                if (relatedManyToOneMappings) {
+                    this.fillPropertiesToForeignObject(ForeignClass, foreignObject, resultSet);
+                }
+                const allNull = Object.keys(foreignObject).length === 0 ||
+                    Object.values(foreignObject).every((v) => v === null || v === undefined);
+                baseEntity[columnName] = allNull
+                    ? null
+                    : (0, DeserializeEntity_1.deserializeEntity)(ForeignClass, foreignObject);
+            }
+        }
+        const oneToOneMappingMetadata = Reflect.getMetadata(decorators_1.ONE_TO_ONE_TOKEN, entityClass);
+        if (oneToOneMappingMetadata) {
+            for (const rel of oneToOneMappingMetadata) {
+                if (!rel.joinColumn)
+                    continue;
+                const propertyKey = rel.propertyKey;
+                const RelatedClass = rel.getRelatedEntity();
+                const rows = this.getObjectEntries(resultSet);
+                const foreignObject = this.createForeignObject();
+                for (const [key, value] of rows) {
+                    const prefix = this.addSeparatorToColumnName(propertyKey);
+                    if (key.startsWith(prefix)) {
+                        const keyWithoutPrefix = key.replace(prefix, "");
+                        foreignObject[keyWithoutPrefix] = value;
+                    }
+                }
+                const allNull = Object.keys(foreignObject).length === 0 ||
+                    Object.values(foreignObject).every((v) => v === null || v === undefined);
+                baseEntity[propertyKey] = allNull
+                    ? null
+                    : (0, DeserializeEntity_1.deserializeEntity)(RelatedClass, foreignObject);
+            }
+        }
+        const finalEntity = (0, DeserializeEntity_1.deserializeEntity)(entityClass, { ...baseEntity });
+        return finalEntity;
+    }
+    transformNested(entityClass, queryResult, relations) {
+        if (this.hasNoResults(queryResult)) {
+            return this.buildNullEntity();
+        }
+        const r = queryResult;
+        const transformedResults = r.results.map((row) => {
+            const baseEntity = {};
+            this.extractBaseEntity(entityClass, row, baseEntity);
+            const finalEntity = this.fillPropertiesToForeignObject(entityClass, baseEntity, row);
+            return finalEntity;
+        });
+        const isSingleResult = transformedResults.length === 1;
+        return isSingleResult ? transformedResults[0] : transformedResults;
+    }
+}
+exports.ResultTransformer = ResultTransformer;
+ResultTransformer.PropertySeparator = "_";
+//# sourceMappingURL=ResultTransformer.js.map

package/dist/core/ResultTransformer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResultTransformer.js","sourceRoot":"","sources":["../../src/core/ResultTransformer.ts"],"names":[],"mappings":"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"}

package/dist/core/ResultTransformerFactory.d.ts

@@ -0,0 +1,5 @@
+import { ResultTransformer } from "./ResultTransformer";
+export declare class ResultTransformerFactory {
+    static create(): ResultTransformer;
+}
+//# sourceMappingURL=ResultTransformerFactory.d.ts.map

package/dist/core/ResultTransformerFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResultTransformerFactory.d.ts","sourceRoot":"","sources":["../../src/core/ResultTransformerFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AASxD,qBAAa,wBAAwB;IACnC,MAAM,CAAC,MAAM;CAGd"}

package/dist/core/ResultTransformerFactory.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResultTransformerFactory = void 0;
+const ResultTransformer_1 = require("./ResultTransformer");
+class ResultTransformerFactory {
+    static create() {
+        return new ResultTransformer_1.ResultTransformer();
+    }
+}
+exports.ResultTransformerFactory = ResultTransformerFactory;
+//# sourceMappingURL=ResultTransformerFactory.js.map

package/dist/core/ResultTransformerFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResultTransformerFactory.js","sourceRoot":"","sources":["../../src/core/ResultTransformerFactory.ts"],"names":[],"mappings":";;;AAAA,2DAAwD;AASxD,MAAa,wBAAwB;IACnC,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,qCAAiB,EAAE,CAAC;IACjC,CAAC;CACF;AAJD,4DAIC"}

package/dist/core/SelectUtils.d.ts

@@ -0,0 +1,14 @@
+import { ISelectOption } from "../dialects/ISelectOption";
+import { FindOption } from "../dialects/FindOption";
+type SelectableFields<T> = {
+    [K in keyof T]?: boolean;
+};
+declare class SelectUtils {
+    static isArraySelect<T>(select: ISelectOption<T>): select is (keyof T)[];
+    static isBooleanSelect<T>(select: ISelectOption<T>): select is SelectableFields<T>;
+    static isNestedSelect<T>(select: ISelectOption<T>): select is {
+        [K in keyof T]?: FindOption<T[K]>;
+    };
+}
+export default SelectUtils;
+//# sourceMappingURL=SelectUtils.d.ts.map

package/dist/core/SelectUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SelectUtils.d.ts","sourceRoot":"","sources":["../../src/core/SelectUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD,KAAK,gBAAgB,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO;CAAE,CAAC;AAExD,cAAM,WAAW;IACf,MAAM,CAAC,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE;IAIxE,MAAM,CAAC,eAAe,CAAC,CAAC,EACtB,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,GACvB,MAAM,IAAI,gBAAgB,CAAC,CAAC,CAAC;IAUhC,MAAM,CAAC,cAAc,CAAC,CAAC,EACrB,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,GACvB,MAAM,IAAI;SAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;KAAE;CAUnD;AAED,eAAe,WAAW,CAAC"}