typeorm 1.0.0-beta.1 → 1.0.0-beta.2

package/browser/query-builder/JoinAttribute.js.map

@@ -1 +1 @@
-{"version":3,"file":"JoinAttribute.js","sourceRoot":"../build/browser/src/","sources":["query-builder/JoinAttribute.ts"],"names":[],"mappings":"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","sourcesContent":["import type { EntityMetadata } from \"../metadata/EntityMetadata\"\nimport type { DataSource } from \"../data-source/DataSource\"\nimport type { RelationMetadata } from \"../metadata/RelationMetadata\"\nimport { QueryBuilderUtils } from \"./QueryBuilderUtils\"\nimport type { QueryExpressionMap } from \"./QueryExpressionMap\"\nimport type { Alias } from \"./Alias\"\nimport { ObjectUtils } from \"../util/ObjectUtils\"\nimport { TypeORMError } from \"../error\"\nimport { DriverUtils } from \"../driver/DriverUtils\"\n\n/**\n * Stores all join attributes which will be used to build a JOIN query.\n */\nexport class JoinAttribute {\n    // -------------------------------------------------------------------------\n    // Public Properties\n    // -------------------------------------------------------------------------\n\n    /**\n     * Join direction.\n     */\n    direction: \"LEFT\" | \"INNER\"\n\n    /**\n     * Alias of the joined (destination) table.\n     */\n    alias: Alias\n\n    /**\n     * Joined table, entity target, or relation in \"post.category\" format.\n     */\n    entityOrProperty: Function | string\n\n    /**\n     * Extra condition applied to \"ON\" section of join.\n     */\n    condition?: string\n\n    /**\n     * Property + alias of the object where to joined data should be mapped.\n     */\n    mapToProperty?: string\n\n    /**\n     * Indicates if user maps one or many objects from the join.\n     */\n    isMappingMany?: boolean\n\n    /**\n     * Useful when the joined expression is a custom query to support mapping.\n     */\n    mapAsEntity?: Function | string\n\n    // -------------------------------------------------------------------------\n    // Constructor\n    // -------------------------------------------------------------------------\n\n    constructor(\n        private dataSource: DataSource,\n        private queryExpressionMap: QueryExpressionMap,\n        joinAttribute?: JoinAttribute,\n    ) {\n        if (joinAttribute) {\n            ObjectUtils.assign(this, joinAttribute)\n        }\n    }\n\n    // -------------------------------------------------------------------------\n    // Public Methods\n    // -------------------------------------------------------------------------\n\n    get isMany(): boolean {\n        if (this.isMappingMany !== undefined) return this.isMappingMany\n\n        if (this.relation)\n            return this.relation.isManyToMany || this.relation.isOneToMany\n\n        return false\n    }\n\n    isSelectedCache: boolean\n    isSelectedEvaluated: boolean = false\n    /**\n     * Indicates if this join is selected.\n     */\n    get isSelected(): boolean {\n        if (!this.isSelectedEvaluated) {\n            const getValue = () => {\n                for (const select of this.queryExpressionMap.selects) {\n                    if (select.selection === this.alias.name) return true\n\n                    if (\n                        this.metadata &&\n                        !!this.metadata.columns.find(\n                            (column) =>\n                                select.selection ===\n                                this.alias.name + \".\" + column.propertyPath,\n                        )\n                    )\n                        return true\n                }\n\n                return false\n            }\n            this.isSelectedCache = getValue()\n            this.isSelectedEvaluated = true\n        }\n        return this.isSelectedCache\n    }\n\n    /**\n     * Name of the table which we should join.\n     */\n    get tablePath(): string {\n        return this.metadata\n            ? this.metadata.tablePath\n            : (this.entityOrProperty as string)\n    }\n\n    /**\n     * Alias of the parent of this join.\n     * For example, if we join (\"post.category\", \"categoryAlias\") then \"post\" is a parent alias.\n     * This value is extracted from entityOrProperty value.\n     * This is available when join was made using \"post.category\" syntax.\n     */\n    get parentAlias(): string | undefined {\n        if (!QueryBuilderUtils.isAliasProperty(this.entityOrProperty))\n            return undefined\n\n        return this.entityOrProperty.substr(\n            0,\n            this.entityOrProperty.indexOf(\".\"),\n        )\n    }\n\n    /**\n     * Relation property name of the parent.\n     * This is used to understand what is joined.\n     * For example, if we join (\"post.category\", \"categoryAlias\") then \"category\" is a relation property.\n     * This value is extracted from entityOrProperty value.\n     * This is available when join was made using \"post.category\" syntax.\n     */\n    get relationPropertyPath(): string | undefined {\n        if (!QueryBuilderUtils.isAliasProperty(this.entityOrProperty))\n            return undefined\n\n        return this.entityOrProperty.substr(\n            this.entityOrProperty.indexOf(\".\") + 1,\n        )\n    }\n\n    relationCache: RelationMetadata | undefined\n    relationEvaluated: boolean = false\n    /**\n     * Relation of the parent.\n     * This is used to understand what is joined.\n     * This is available when join was made using \"post.category\" syntax.\n     * Relation can be undefined if entityOrProperty is regular entity or custom table.\n     */\n    get relation(): RelationMetadata | undefined {\n        if (!this.relationEvaluated) {\n            const getValue = () => {\n                if (!QueryBuilderUtils.isAliasProperty(this.entityOrProperty))\n                    return undefined\n\n                const relationOwnerSelection =\n                    this.queryExpressionMap.findAliasByName(this.parentAlias!)\n                let relation =\n                    relationOwnerSelection.metadata.findRelationWithPropertyPath(\n                        this.relationPropertyPath!,\n                    )\n\n                if (relation) {\n                    return relation\n                }\n\n                if (relationOwnerSelection.metadata.parentEntityMetadata) {\n                    relation =\n                        relationOwnerSelection.metadata.parentEntityMetadata.findRelationWithPropertyPath(\n                            this.relationPropertyPath!,\n                        )\n                    if (relation) {\n                        return relation\n                    }\n                }\n\n                throw new TypeORMError(\n                    `Relation with property path ${this.relationPropertyPath} in entity was not found.`,\n                )\n            }\n            this.relationCache = getValue.bind(this)()\n            this.relationEvaluated = true\n        }\n        return this.relationCache\n    }\n\n    /**\n     * Metadata of the joined entity.\n     * If table without entity was joined, then it will return undefined.\n     */\n    get metadata(): EntityMetadata | undefined {\n        // entityOrProperty is relation, e.g. \"post.category\"\n        if (this.relation) return this.relation.inverseEntityMetadata\n\n        // entityOrProperty is Entity class\n        if (this.dataSource.hasMetadata(this.entityOrProperty))\n            return this.dataSource.getMetadata(this.entityOrProperty)\n\n        // Overriden mapping entity provided for leftJoinAndMapOne with custom query builder\n        if (this.mapAsEntity && this.dataSource.hasMetadata(this.mapAsEntity)) {\n            return this.dataSource.getMetadata(this.mapAsEntity)\n        }\n\n        return undefined\n    }\n\n    /**\n     * Generates alias of junction table, whose ids we get.\n     */\n    get junctionAlias(): string {\n        if (!this.relation) {\n            throw new TypeORMError(\n                `Cannot get junction table for join without relation.`,\n            )\n        }\n        if (typeof this.entityOrProperty !== \"string\") {\n            throw new TypeORMError(`Junction property is not defined.`)\n        }\n\n        const aliasProperty = this.entityOrProperty.substr(\n            0,\n            this.entityOrProperty.indexOf(\".\"),\n        )\n\n        if (this.relation.isOwning) {\n            return DriverUtils.buildAlias(\n                this.dataSource.driver,\n                undefined,\n                aliasProperty,\n                this.alias.name,\n            )\n        } else {\n            return DriverUtils.buildAlias(\n                this.dataSource.driver,\n                undefined,\n                this.alias.name,\n                aliasProperty,\n            )\n        }\n    }\n\n    get mapToPropertyParentAlias(): string | undefined {\n        if (!this.mapToProperty) return undefined\n\n        return this.mapToProperty!.split(\".\")[0]\n    }\n\n    get mapToPropertyPropertyName(): string | undefined {\n        if (!this.mapToProperty) return undefined\n\n        return this.mapToProperty!.split(\".\")[1]\n    }\n}\n"]}
+{"version":3,"file":"JoinAttribute.js","sourceRoot":"../build/browser/src/","sources":["query-builder/JoinAttribute.ts"],"names":[],"mappings":";;;AAGA,2DAAuD;AAGvD,qDAAiD;AACjD,oCAAuC;AACvC,uDAAmD;AAEnD;;GAEG;AACH,MAAa,aAAa;IAwCtB,4EAA4E;IAC5E,cAAc;IACd,4EAA4E;IAE5E,YACY,UAAsB,EACtB,kBAAsC,EAC9C,aAA6B;QAFrB,eAAU,GAAV,UAAU,CAAY;QACtB,uBAAkB,GAAlB,kBAAkB,CAAoB;QAsBlD,wBAAmB,GAAY,KAAK,CAAA;QAuEpC,sBAAiB,GAAY,KAAK,CAAA;QA1F9B,IAAI,aAAa,EAAE,CAAC;YAChB,yBAAW,CAAC,MAAM,CAAC,IAAI,EAAE,aAAa,CAAC,CAAA;QAC3C,CAAC;IACL,CAAC;IAED,4EAA4E;IAC5E,iBAAiB;IACjB,4EAA4E;IAE5E,IAAI,MAAM;QACN,IAAI,IAAI,CAAC,aAAa,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC,aAAa,CAAA;QAE/D,IAAI,IAAI,CAAC,QAAQ;YACb,OAAO,IAAI,CAAC,QAAQ,CAAC,YAAY,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAA;QAElE,OAAO,KAAK,CAAA;IAChB,CAAC;IAID;;OAEG;IACH,IAAI,UAAU;QACV,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC5B,MAAM,QAAQ,GAAG,GAAG,EAAE;gBAClB,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE,CAAC;oBACnD,IAAI,MAAM,CAAC,SAAS,KAAK,IAAI,CAAC,KAAK,CAAC,IAAI;wBAAE,OAAO,IAAI,CAAA;oBAErD,IACI,IAAI,CAAC,QAAQ;wBACb,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CACxB,CAAC,MAAM,EAAE,EAAE,CACP,MAAM,CAAC,SAAS;4BAChB,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,GAAG,GAAG,MAAM,CAAC,YAAY,CAClD;wBAED,OAAO,IAAI,CAAA;gBACnB,CAAC;gBAED,OAAO,KAAK,CAAA;YAChB,CAAC,CAAA;YACD,IAAI,CAAC,eAAe,GAAG,QAAQ,EAAE,CAAA;YACjC,IAAI,CAAC,mBAAmB,GAAG,IAAI,CAAA;QACnC,CAAC;QACD,OAAO,IAAI,CAAC,eAAe,CAAA;IAC/B,CAAC;IAED;;OAEG;IACH,IAAI,SAAS;QACT,OAAO,IAAI,CAAC,QAAQ;YAChB,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS;YACzB,CAAC,CAAE,IAAI,CAAC,gBAA2B,CAAA;IAC3C,CAAC;IAED;;;;;OAKG;IACH,IAAI,WAAW;QACX,IAAI,CAAC,qCAAiB,CAAC,eAAe,CAAC,IAAI,CAAC,gBAAgB,CAAC;YACzD,OAAO,SAAS,CAAA;QAEpB,OAAO,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAClC,CAAC,EACD,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,GAAG,CAAC,CACrC,CAAA;IACL,CAAC;IAED;;;;;;OAMG;IACH,IAAI,oBAAoB;QACpB,IAAI,CAAC,qCAAiB,CAAC,eAAe,CAAC,IAAI,CAAC,gBAAgB,CAAC;YACzD,OAAO,SAAS,CAAA;QAEpB,OAAO,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAClC,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CACzC,CAAA;IACL,CAAC;IAID;;;;;OAKG;IACH,IAAI,QAAQ;QACR,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC1B,MAAM,QAAQ,GAAG,GAAG,EAAE;gBAClB,IAAI,CAAC,qCAAiB,CAAC,eAAe,CAAC,IAAI,CAAC,gBAAgB,CAAC;oBACzD,OAAO,SAAS,CAAA;gBAEpB,MAAM,sBAAsB,GACxB,IAAI,CAAC,kBAAkB,CAAC,eAAe,CAAC,IAAI,CAAC,WAAY,CAAC,CAAA;gBAC9D,IAAI,QAAQ,GACR,sBAAsB,CAAC,QAAQ,CAAC,4BAA4B,CACxD,IAAI,CAAC,oBAAqB,CAC7B,CAAA;gBAEL,IAAI,QAAQ,EAAE,CAAC;oBACX,OAAO,QAAQ,CAAA;gBACnB,CAAC;gBAED,IAAI,sBAAsB,CAAC,QAAQ,CAAC,oBAAoB,EAAE,CAAC;oBACvD,QAAQ;wBACJ,sBAAsB,CAAC,QAAQ,CAAC,oBAAoB,CAAC,4BAA4B,CAC7E,IAAI,CAAC,oBAAqB,CAC7B,CAAA;oBACL,IAAI,QAAQ,EAAE,CAAC;wBACX,OAAO,QAAQ,CAAA;oBACnB,CAAC;gBACL,CAAC;gBAED,MAAM,IAAI,oBAAY,CAClB,+BAA+B,IAAI,CAAC,oBAAoB,2BAA2B,CACtF,CAAA;YACL,CAAC,CAAA;YACD,IAAI,CAAC,aAAa,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAA;YAC1C,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAA;QACjC,CAAC;QACD,OAAO,IAAI,CAAC,aAAa,CAAA;IAC7B,CAAC;IAED;;;OAGG;IACH,IAAI,QAAQ;QACR,qDAAqD;QACrD,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC,QAAQ,CAAC,qBAAqB,CAAA;QAE7D,mCAAmC;QACnC,IAAI,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,gBAAgB,CAAC;YAClD,OAAO,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAA;QAE7D,oFAAoF;QACpF,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;YACpE,OAAO,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;QACxD,CAAC;QAED,OAAO,SAAS,CAAA;IACpB,CAAC;IAED;;OAEG;IACH,IAAI,aAAa;QACb,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACjB,MAAM,IAAI,oBAAY,CAClB,sDAAsD,CACzD,CAAA;QACL,CAAC;QACD,IAAI,OAAO,IAAI,CAAC,gBAAgB,KAAK,QAAQ,EAAE,CAAC;YAC5C,MAAM,IAAI,oBAAY,CAAC,mCAAmC,CAAC,CAAA;QAC/D,CAAC;QAED,MAAM,aAAa,GAAG,IAAI,CAAC,gBAAgB,CAAC,SAAS,CACjD,CAAC,EACD,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,GAAG,CAAC,CACrC,CAAA;QAED,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;YACzB,OAAO,yBAAW,CAAC,UAAU,CACzB,IAAI,CAAC,UAAU,CAAC,MAAM,EACtB,SAAS,EACT,aAAa,EACb,IAAI,CAAC,KAAK,CAAC,IAAI,CAClB,CAAA;QACL,CAAC;aAAM,CAAC;YACJ,OAAO,yBAAW,CAAC,UAAU,CACzB,IAAI,CAAC,UAAU,CAAC,MAAM,EACtB,SAAS,EACT,IAAI,CAAC,KAAK,CAAC,IAAI,EACf,aAAa,CAChB,CAAA;QACL,CAAC;IACL,CAAC;IAED,IAAI,wBAAwB;QACxB,IAAI,CAAC,IAAI,CAAC,aAAa;YAAE,OAAO,SAAS,CAAA;QAEzC,OAAO,IAAI,CAAC,aAAc,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;IAC5C,CAAC;IAED,IAAI,yBAAyB;QACzB,IAAI,CAAC,IAAI,CAAC,aAAa;YAAE,OAAO,SAAS,CAAA;QAEzC,OAAO,IAAI,CAAC,aAAc,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;IAC5C,CAAC;CACJ;AAzPD,sCAyPC","sourcesContent":["import type { EntityMetadata } from \"../metadata/EntityMetadata\"\nimport type { DataSource } from \"../data-source/DataSource\"\nimport type { RelationMetadata } from \"../metadata/RelationMetadata\"\nimport { QueryBuilderUtils } from \"./QueryBuilderUtils\"\nimport type { QueryExpressionMap } from \"./QueryExpressionMap\"\nimport type { Alias } from \"./Alias\"\nimport { ObjectUtils } from \"../util/ObjectUtils\"\nimport { TypeORMError } from \"../error\"\nimport { DriverUtils } from \"../driver/DriverUtils\"\n\n/**\n * Stores all join attributes which will be used to build a JOIN query.\n */\nexport class JoinAttribute {\n    // -------------------------------------------------------------------------\n    // Public Properties\n    // -------------------------------------------------------------------------\n\n    /**\n     * Join direction.\n     */\n    direction: \"LEFT\" | \"INNER\"\n\n    /**\n     * Alias of the joined (destination) table.\n     */\n    alias: Alias\n\n    /**\n     * Joined table, entity target, or relation in \"post.category\" format.\n     */\n    entityOrProperty: Function | string\n\n    /**\n     * Extra condition applied to \"ON\" section of join.\n     */\n    condition?: string\n\n    /**\n     * Property + alias of the object where to joined data should be mapped.\n     */\n    mapToProperty?: string\n\n    /**\n     * Indicates if user maps one or many objects from the join.\n     */\n    isMappingMany?: boolean\n\n    /**\n     * Useful when the joined expression is a custom query to support mapping.\n     */\n    mapAsEntity?: Function | string\n\n    // -------------------------------------------------------------------------\n    // Constructor\n    // -------------------------------------------------------------------------\n\n    constructor(\n        private dataSource: DataSource,\n        private queryExpressionMap: QueryExpressionMap,\n        joinAttribute?: JoinAttribute,\n    ) {\n        if (joinAttribute) {\n            ObjectUtils.assign(this, joinAttribute)\n        }\n    }\n\n    // -------------------------------------------------------------------------\n    // Public Methods\n    // -------------------------------------------------------------------------\n\n    get isMany(): boolean {\n        if (this.isMappingMany !== undefined) return this.isMappingMany\n\n        if (this.relation)\n            return this.relation.isManyToMany || this.relation.isOneToMany\n\n        return false\n    }\n\n    isSelectedCache: boolean\n    isSelectedEvaluated: boolean = false\n    /**\n     * Indicates if this join is selected.\n     */\n    get isSelected(): boolean {\n        if (!this.isSelectedEvaluated) {\n            const getValue = () => {\n                for (const select of this.queryExpressionMap.selects) {\n                    if (select.selection === this.alias.name) return true\n\n                    if (\n                        this.metadata &&\n                        !!this.metadata.columns.find(\n                            (column) =>\n                                select.selection ===\n                                this.alias.name + \".\" + column.propertyPath,\n                        )\n                    )\n                        return true\n                }\n\n                return false\n            }\n            this.isSelectedCache = getValue()\n            this.isSelectedEvaluated = true\n        }\n        return this.isSelectedCache\n    }\n\n    /**\n     * Name of the table which we should join.\n     */\n    get tablePath(): string {\n        return this.metadata\n            ? this.metadata.tablePath\n            : (this.entityOrProperty as string)\n    }\n\n    /**\n     * Alias of the parent of this join.\n     * For example, if we join (\"post.category\", \"categoryAlias\") then \"post\" is a parent alias.\n     * This value is extracted from entityOrProperty value.\n     * This is available when join was made using \"post.category\" syntax.\n     */\n    get parentAlias(): string | undefined {\n        if (!QueryBuilderUtils.isAliasProperty(this.entityOrProperty))\n            return undefined\n\n        return this.entityOrProperty.substring(\n            0,\n            this.entityOrProperty.indexOf(\".\"),\n        )\n    }\n\n    /**\n     * Relation property name of the parent.\n     * This is used to understand what is joined.\n     * For example, if we join (\"post.category\", \"categoryAlias\") then \"category\" is a relation property.\n     * This value is extracted from entityOrProperty value.\n     * This is available when join was made using \"post.category\" syntax.\n     */\n    get relationPropertyPath(): string | undefined {\n        if (!QueryBuilderUtils.isAliasProperty(this.entityOrProperty))\n            return undefined\n\n        return this.entityOrProperty.substring(\n            this.entityOrProperty.indexOf(\".\") + 1,\n        )\n    }\n\n    relationCache: RelationMetadata | undefined\n    relationEvaluated: boolean = false\n    /**\n     * Relation of the parent.\n     * This is used to understand what is joined.\n     * This is available when join was made using \"post.category\" syntax.\n     * Relation can be undefined if entityOrProperty is regular entity or custom table.\n     */\n    get relation(): RelationMetadata | undefined {\n        if (!this.relationEvaluated) {\n            const getValue = () => {\n                if (!QueryBuilderUtils.isAliasProperty(this.entityOrProperty))\n                    return undefined\n\n                const relationOwnerSelection =\n                    this.queryExpressionMap.findAliasByName(this.parentAlias!)\n                let relation =\n                    relationOwnerSelection.metadata.findRelationWithPropertyPath(\n                        this.relationPropertyPath!,\n                    )\n\n                if (relation) {\n                    return relation\n                }\n\n                if (relationOwnerSelection.metadata.parentEntityMetadata) {\n                    relation =\n                        relationOwnerSelection.metadata.parentEntityMetadata.findRelationWithPropertyPath(\n                            this.relationPropertyPath!,\n                        )\n                    if (relation) {\n                        return relation\n                    }\n                }\n\n                throw new TypeORMError(\n                    `Relation with property path ${this.relationPropertyPath} in entity was not found.`,\n                )\n            }\n            this.relationCache = getValue.bind(this)()\n            this.relationEvaluated = true\n        }\n        return this.relationCache\n    }\n\n    /**\n     * Metadata of the joined entity.\n     * If table without entity was joined, then it will return undefined.\n     */\n    get metadata(): EntityMetadata | undefined {\n        // entityOrProperty is relation, e.g. \"post.category\"\n        if (this.relation) return this.relation.inverseEntityMetadata\n\n        // entityOrProperty is Entity class\n        if (this.dataSource.hasMetadata(this.entityOrProperty))\n            return this.dataSource.getMetadata(this.entityOrProperty)\n\n        // Overriden mapping entity provided for leftJoinAndMapOne with custom query builder\n        if (this.mapAsEntity && this.dataSource.hasMetadata(this.mapAsEntity)) {\n            return this.dataSource.getMetadata(this.mapAsEntity)\n        }\n\n        return undefined\n    }\n\n    /**\n     * Generates alias of junction table, whose ids we get.\n     */\n    get junctionAlias(): string {\n        if (!this.relation) {\n            throw new TypeORMError(\n                `Cannot get junction table for join without relation.`,\n            )\n        }\n        if (typeof this.entityOrProperty !== \"string\") {\n            throw new TypeORMError(`Junction property is not defined.`)\n        }\n\n        const aliasProperty = this.entityOrProperty.substring(\n            0,\n            this.entityOrProperty.indexOf(\".\"),\n        )\n\n        if (this.relation.isOwning) {\n            return DriverUtils.buildAlias(\n                this.dataSource.driver,\n                undefined,\n                aliasProperty,\n                this.alias.name,\n            )\n        } else {\n            return DriverUtils.buildAlias(\n                this.dataSource.driver,\n                undefined,\n                this.alias.name,\n                aliasProperty,\n            )\n        }\n    }\n\n    get mapToPropertyParentAlias(): string | undefined {\n        if (!this.mapToProperty) return undefined\n\n        return this.mapToProperty!.split(\".\")[0]\n    }\n\n    get mapToPropertyPropertyName(): string | undefined {\n        if (!this.mapToProperty) return undefined\n\n        return this.mapToProperty!.split(\".\")[1]\n    }\n}\n"]}

package/browser/query-builder/QueryBuilder.d.ts

@@ -15,6 +15,7 @@ import { Brackets } from "./Brackets";
 import type { QueryDeepPartialEntity } from "./QueryPartialEntity";
 import type { EntityMetadata } from "../metadata/EntityMetadata";
 import type { ColumnMetadata } from "../metadata/ColumnMetadata";
+import type { OrderByCondition } from "../find-options/OrderByCondition";
 import type { WhereClause, WhereClauseCondition } from "./WhereClause";
 import type { NotBrackets } from "./NotBrackets";
 import type { ReturningType } from "../driver/types/ReturningType";
@@ -29,6 +30,7 @@ export declare abstract class QueryBuilder<Entity extends ObjectLiteral> {
     readonly dataSource: DataSource;
     /**
      * DataSource on which QueryBuilder was created.
+     *
      * @deprecated since 1.0.0. Use {@link dataSource} instance instead.
      */
     get connection(): DataSource;
@@ -92,6 +94,10 @@ export declare abstract class QueryBuilder<Entity extends ObjectLiteral> {
      * Creates UPDATE query and applies given update values.
      */
     update(): UpdateQueryBuilder<Entity>;
+    /**
+     * Creates UPDATE query for the given entity.
+     */
+    update<Entity extends ObjectLiteral>(entity: EntityTarget<Entity>): UpdateQueryBuilder<Entity>;
     /**
      * Creates UPDATE query and applies given update values.
      */
@@ -134,6 +140,7 @@ export declare abstract class QueryBuilder<Entity extends ObjectLiteral> {
     hasRelation<T>(target: EntityTarget<T>, relation: string[]): boolean;
     /**
      * Check the existence of a parameter for this query builder.
+     *
      * @param key
      */
     hasParameter(key: string): boolean;
@@ -141,12 +148,14 @@ export declare abstract class QueryBuilder<Entity extends ObjectLiteral> {
      * Sets parameter name and its value.
      *
      * The key for this parameter may contain numbers, letters, underscores, or periods.
+     *
      * @param key
      * @param value
      */
     setParameter(key: string, value: any): this;
     /**
      * Adds all parameters from the given object.
+     *
      * @param parameters
      */
     setParameters(parameters: ObjectLiteral): this;
@@ -155,10 +164,6 @@ export declare abstract class QueryBuilder<Entity extends ObjectLiteral> {
      * Gets all parameters.
      */
     getParameters(): ObjectLiteral;
-    /**
-     * Logs the generated sql query using the configured logger.
-     */
-    logQuery(): this;
     /**
      * Gets generated sql that will be executed.
      * Parameters in the query are escaped for the currently used driver.
@@ -175,6 +180,7 @@ export declare abstract class QueryBuilder<Entity extends ObjectLiteral> {
     /**
      * Creates a completely new query builder.
      * Uses same query runner as current QueryBuilder.
+     *
      * @param queryRunner
      */
     createQueryBuilder(queryRunner?: QueryRunner): this;
@@ -189,6 +195,7 @@ export declare abstract class QueryBuilder<Entity extends ObjectLiteral> {
      * Includes a Query comment in the query builder.  This is helpful for debugging purposes,
      * such as finding a specific query in the database server's logs, or for categorization using
      * an APM product.
+     *
      * @param comment
      */
     comment(comment: string): this;
@@ -198,27 +205,32 @@ export declare abstract class QueryBuilder<Entity extends ObjectLiteral> {
     disableEscaping(): this;
     /**
      * Escapes table name, column name or alias name using current database's escaping character.
+     *
      * @param name
      */
     escape(name: string): string;
     /**
      * Sets or overrides query builder's QueryRunner.
+     *
      * @param queryRunner
      */
     setQueryRunner(queryRunner: QueryRunner): this;
     /**
      * Indicates if listeners and subscribers must be called before and after query execution.
      * Enabled by default.
+     *
      * @param enabled
      */
     callListeners(enabled: boolean): this;
     /**
      * If set to true the query will be wrapped into a transaction.
+     *
      * @param enabled
      */
     useTransaction(enabled: boolean): this;
     /**
      * Adds CTE to query
+     *
      * @param queryBuilder
      * @param alias
      * @param options
@@ -227,6 +239,7 @@ export declare abstract class QueryBuilder<Entity extends ObjectLiteral> {
     /**
      * Gets escaped table name with schema name if SqlServer driver used with custom
      * schema name, otherwise returns escaped table name.
+     *
      * @param tablePath
      */
     protected getTableName(tablePath: string): string;
@@ -237,12 +250,14 @@ export declare abstract class QueryBuilder<Entity extends ObjectLiteral> {
     /**
      * Specifies FROM which entity's table select/update/delete will be executed.
      * Also sets a main string alias of the selection data.
+     *
      * @param entityTarget
      * @param aliasName
      */
     protected createFromAlias(entityTarget: EntityTarget<any> | ((qb: SelectQueryBuilder<any>) => SelectQueryBuilder<any>), aliasName?: string): Alias;
     /**
      * Replaces all entity's propertyName to name in the given SQL string.
+     *
      * @param statement
      */
     protected replacePropertyNamesForTheWholeQuery(statement: string): string;
@@ -257,6 +272,7 @@ export declare abstract class QueryBuilder<Entity extends ObjectLiteral> {
     protected createWhereExpression(): string;
     /**
      * Creates "RETURNING" / "OUTPUT" expression.
+     *
      * @param returningType
      */
     protected createReturningExpression(returningType: ReturningType): string;
@@ -268,6 +284,7 @@ export declare abstract class QueryBuilder<Entity extends ObjectLiteral> {
     protected createWhereClausesExpression(clauses: WhereClause[]): string;
     /**
      * Computes given where argument - transforms to a where string all forms it can take.
+     *
      * @param condition
      * @param alwaysWrap
      */
@@ -275,6 +292,7 @@ export declare abstract class QueryBuilder<Entity extends ObjectLiteral> {
     protected createCteExpression(): string;
     /**
      * Creates "WHERE" condition for an in-ids condition.
+     *
      * @param ids
      */
     protected getWhereInIdsCondition(ids: any | any[]): ObjectLiteral | Brackets;
@@ -282,6 +300,7 @@ export declare abstract class QueryBuilder<Entity extends ObjectLiteral> {
     private findColumnsForPropertyPath;
     /**
      * Creates a property paths for a given ObjectLiteral.
+     *
      * @param metadata
      * @param entity
      * @param prefix
@@ -295,4 +314,6 @@ export declare abstract class QueryBuilder<Entity extends ObjectLiteral> {
      */
     protected obtainQueryRunner(): QueryRunner;
     protected hasCommonTableExpressions(): boolean;
+    protected assertNoSemicolon(value: string, context: string): void;
+    protected validateOrderByCondition(sort: OrderByCondition): void;
 }

package/browser/query-builder/QueryBuilder.js

@@ -29,6 +29,7 @@ const escapeRegExp_1 = require("../util/escapeRegExp");
 class QueryBuilder {
     /**
      * DataSource on which QueryBuilder was created.
+     *
      * @deprecated since 1.0.0. Use {@link dataSource} instance instead.
      */
     get connection() {
@@ -40,6 +41,7 @@ class QueryBuilder {
     static { this.queryBuilderRegistry = {}; }
     /**
      * QueryBuilder can be initialized from given Connection and QueryRunner objects or from given other QueryBuilder.
+     *
      * @param connectionOrQueryBuilder
      * @param queryRunner
      */
@@ -77,17 +79,22 @@ class QueryBuilder {
     /**
      * Creates SELECT query and selects given data.
      * Replaces all previous selections if they exist.
+     *
      * @param selection
      * @param selectionAliasName
      */
     select(selection, selectionAliasName) {
         this.expressionMap.queryType = "select";
         if (Array.isArray(selection)) {
+            for (const s of selection) {
+                this.assertNoSemicolon(s, "select");
+            }
             this.expressionMap.selects = selection.map((selection) => ({
                 selection: selection,
             }));
         }
         else if (selection) {
+            this.assertNoSemicolon(selection, "select");
             this.expressionMap.selects = [
                 { selection: selection, aliasName: selectionAliasName },
             ];
@@ -107,13 +114,13 @@ class QueryBuilder {
     }
     /**
      * Creates UPDATE query and applies given update values.
+     *
      * @param entityOrTableNameUpdateSet
      * @param maybeUpdateSet
      */
     update(entityOrTableNameUpdateSet, maybeUpdateSet) {
-        const updateSet = maybeUpdateSet
-            ? maybeUpdateSet
-            : entityOrTableNameUpdateSet;
+        const updateSet = maybeUpdateSet ??
+            entityOrTableNameUpdateSet;
         entityOrTableNameUpdateSet = InstanceChecker_1.InstanceChecker.isEntitySchema(entityOrTableNameUpdateSet)
             ? entityOrTableNameUpdateSet.options.name
             : entityOrTableNameUpdateSet;
@@ -151,6 +158,7 @@ class QueryBuilder {
     }
     /**
      * Sets entity's relation with which this query builder gonna work.
+     *
      * @param entityTargetOrPropertyPath
      * @param maybePropertyPath
      */
@@ -174,6 +182,7 @@ class QueryBuilder {
      * Returns true if relation exists, false otherwise.
      *
      * todo: move this method to manager? or create a shortcut?
+     *
      * @param target
      * @param relation
      */
@@ -186,6 +195,7 @@ class QueryBuilder {
     }
     /**
      * Check the existence of a parameter for this query builder.
+     *
      * @param key
      */
     hasParameter(key) {
@@ -196,6 +206,7 @@ class QueryBuilder {
      * Sets parameter name and its value.
      *
      * The key for this parameter may contain numbers, letters, underscores, or periods.
+     *
      * @param key
      * @param value
      */
@@ -214,6 +225,7 @@ class QueryBuilder {
     }
     /**
      * Adds all parameters from the given object.
+     *
      * @param parameters
      */
     setParameters(parameters) {
@@ -236,8 +248,7 @@ class QueryBuilder {
     getParameters() {
         const parameters = Object.assign({}, this.expressionMap.parameters);
         // add discriminator column parameter if it exist
-        if (this.expressionMap.mainAlias &&
-            this.expressionMap.mainAlias.hasMetadata) {
+        if (this.expressionMap.mainAlias?.hasMetadata) {
             const metadata = this.expressionMap.mainAlias.metadata;
             if (metadata.discriminatorColumn && metadata.parentEntityMetadata) {
                 const values = metadata.childEntityMetadatas
@@ -249,14 +260,6 @@ class QueryBuilder {
         }
         return parameters;
     }
-    /**
-     * Logs the generated sql query using the configured logger.
-     */
-    logQuery() {
-        const [query, parameters] = this.getQueryAndParameters();
-        this.dataSource.logger.logQuery(query, parameters);
-        return this;
-    }
     /**
      * Gets generated sql that will be executed.
      * Parameters in the query are escaped for the currently used driver.
@@ -291,6 +294,7 @@ class QueryBuilder {
     /**
      * Creates a completely new query builder.
      * Uses same query runner as current QueryBuilder.
+     *
      * @param queryRunner
      */
     createQueryBuilder(queryRunner) {
@@ -309,6 +313,7 @@ class QueryBuilder {
      * Includes a Query comment in the query builder.  This is helpful for debugging purposes,
      * such as finding a specific query in the database server's logs, or for categorization using
      * an APM product.
+     *
      * @param comment
      */
     comment(comment) {
@@ -324,6 +329,7 @@ class QueryBuilder {
     }
     /**
      * Escapes table name, column name or alias name using current database's escaping character.
+     *
      * @param name
      */
     escape(name) {
@@ -333,6 +339,7 @@ class QueryBuilder {
     }
     /**
      * Sets or overrides query builder's QueryRunner.
+     *
      * @param queryRunner
      */
     setQueryRunner(queryRunner) {
@@ -342,6 +349,7 @@ class QueryBuilder {
     /**
      * Indicates if listeners and subscribers must be called before and after query execution.
      * Enabled by default.
+     *
      * @param enabled
      */
     callListeners(enabled) {
@@ -350,6 +358,7 @@ class QueryBuilder {
     }
     /**
      * If set to true the query will be wrapped into a transaction.
+     *
      * @param enabled
      */
     useTransaction(enabled) {
@@ -358,6 +367,7 @@ class QueryBuilder {
     }
     /**
      * Adds CTE to query
+     *
      * @param queryBuilder
      * @param alias
      * @param options
@@ -366,7 +376,7 @@ class QueryBuilder {
         this.expressionMap.commonTableExpressions.push({
             queryBuilder,
             alias,
-            options: options || {},
+            options: options ?? {},
         });
         return this;
     }
@@ -376,6 +386,7 @@ class QueryBuilder {
     /**
      * Gets escaped table name with schema name if SqlServer driver used with custom
      * schema name, otherwise returns escaped table name.
+     *
      * @param tablePath
      */
     getTableName(tablePath) {
@@ -402,6 +413,7 @@ class QueryBuilder {
     /**
      * Specifies FROM which entity's table select/update/delete will be executed.
      * Also sets a main string alias of the selection data.
+     *
      * @param entityTarget
      * @param aliasName
      */
@@ -441,6 +453,7 @@ class QueryBuilder {
     }
     /**
      * Replaces all entity's propertyName to name in the given SQL string.
+     *
      * @param statement
      */
     replacePropertyNamesForTheWholeQuery(statement) {
@@ -598,6 +611,7 @@ class QueryBuilder {
     }
     /**
      * Creates "RETURNING" / "OUTPUT" expression.
+     *
      * @param returningType
      */
     createReturningExpression(returningType) {
@@ -702,6 +716,7 @@ class QueryBuilder {
     }
     /**
      * Computes given where argument - transforms to a where string all forms it can take.
+     *
      * @param condition
      * @param alwaysWrap
      */
@@ -830,6 +845,7 @@ class QueryBuilder {
     }
     /**
      * Creates "WHERE" condition for an in-ids condition.
+     *
      * @param ids
      */
     getWhereInIdsCondition(ids) {
@@ -919,6 +935,7 @@ class QueryBuilder {
     }
     /**
      * Creates a property paths for a given ObjectLiteral.
+     *
      * @param metadata
      * @param entity
      * @param prefix
@@ -1132,11 +1149,37 @@ class QueryBuilder {
      * Creates a query builder used to execute sql queries inside this query builder.
      */
     obtainQueryRunner() {
-        return this.queryRunner || this.dataSource.createQueryRunner();
+        return this.queryRunner ?? this.dataSource.createQueryRunner();
     }
     hasCommonTableExpressions() {
         return this.expressionMap.commonTableExpressions.length > 0;
     }
+    assertNoSemicolon(value, context) {
+        if (value.includes(";")) {
+            throw new error_1.TypeORMError(`Semicolons are not allowed in ${context} to prevent SQL statement stacking.`);
+        }
+    }
+    validateOrderByCondition(sort) {
+        const validOrders = ["ASC", "DESC"];
+        const validNulls = ["NULLS FIRST", "NULLS LAST"];
+        for (const [key, value] of Object.entries(sort)) {
+            this.assertNoSemicolon(key, "orderBy sort key");
+            if (typeof value === "string") {
+                if (!validOrders.includes(value))
+                    throw new error_1.TypeORMError(`Invalid order direction "${value}" for "${key}". Allowed values: ${validOrders.join(", ")}.`);
+            }
+            else if (typeof value === "object" && value !== null) {
+                if (!validOrders.includes(value.order))
+                    throw new error_1.TypeORMError(`Invalid order direction "${value.order}" for "${key}". Allowed values: ${validOrders.join(", ")}.`);
+                if (value.nulls !== undefined &&
+                    !validNulls.includes(value.nulls))
+                    throw new error_1.TypeORMError(`Invalid nulls option "${value.nulls}" for "${key}". Allowed values: ${validNulls.join(", ")}.`);
+            }
+            else {
+                throw new error_1.TypeORMError(`Invalid order-by value for "${key}". Expected "ASC", "DESC", or { order, nulls } object.`);
+            }
+        }
+    }
 }
 exports.QueryBuilder = QueryBuilder;
 //# sourceMappingURL=QueryBuilder.js.map