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

package/metadata/EntityListenerMetadata.d.ts

@@ -35,16 +35,19 @@ export declare class EntityListenerMetadata {
     });
     /**
      * Checks if entity listener is allowed to be executed on the given entity.
+     *
      * @param entity
      */
     isAllowed(entity: ObjectLiteral): boolean;
     /**
      * Executes listener method of the given entity.
+     *
      * @param entity
      */
     execute(entity: ObjectLiteral): any;
     /**
      * Calls embedded entity listener method no matter how nested it is.
+     *
      * @param entity
      * @param propertyPaths
      */

package/metadata/EntityListenerMetadata.js

@@ -20,6 +20,7 @@ class EntityListenerMetadata {
     // ---------------------------------------------------------------------
     /**
      * Checks if entity listener is allowed to be executed on the given entity.
+     *
      * @param entity
      */
     isAllowed(entity) {
@@ -31,6 +32,7 @@ class EntityListenerMetadata {
     }
     /**
      * Executes listener method of the given entity.
+     *
      * @param entity
      */
     execute(entity) {
@@ -55,6 +57,7 @@ class EntityListenerMetadata {
     // ---------------------------------------------------------------------
     /**
      * Calls embedded entity listener method no matter how nested it is.
+     *
      * @param entity
      * @param propertyPaths
      */

package/metadata/EntityListenerMetadata.js.map

@@ -1 +1 @@
-{"version":3,"file":"EntityListenerMetadata.js","sourceRoot":"","sources":["../../../src/metadata/EntityListenerMetadata.ts"],"names":[],"mappings":";;;AAMA;;GAEG;AACH,MAAa,sBAAsB;IA+B/B,wEAAwE;IACxE,cAAc;IACd,wEAAwE;IAExE,YAAY,OAIX;QACG,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,CAAA;QAC5C,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAA;QAChD,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAA;QACjC,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,YAAY,CAAA;QAC7C,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA;IACjC,CAAC;IAED,wEAAwE;IACxE,iBAAiB;IACjB,wEAAwE;IAExE;;;OAGG;IACH,SAAS,CAAC,MAAqB;QAC3B,2DAA2D;QAC3D,OAAO,CACH,IAAI,CAAC,cAAc,CAAC,MAAM,KAAK,MAAM,CAAC,WAAW,IAAI,oIAAoI;YACzL,CAAC,OAAO,IAAI,CAAC,cAAc,CAAC,MAAM,KAAK,UAAU;gBAC7C,MAAM,CAAC,WAAW,CAAC,SAAS;oBACxB,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CACtC,CAAA,CAAC,yDAAyD;IAC/D,CAAC;IAED;;;OAGG;IACH,OAAO,CAAC,MAAqB;QACzB,gDAAgD;QAChD,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACzB,0BAA0B;YAC1B,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;YAE9C,4CAA4C;YAC5C,IAAI,CAAC,YAAY;gBACb,MAAM,IAAI,KAAK,CACX,2BAA2B,IAAI,CAAC,YAAY,+BAA+B,MAAM,CAAC,WAAW,CAAC,IAAI,IAAI,CACzG,CAAA;YAEL,+CAA+C;YAC/C,IAAI,OAAO,YAAY,KAAK,UAAU;gBAClC,MAAM,IAAI,KAAK,CACX,2BAA2B,IAAI,CAAC,YAAY,gBACxC,MAAM,CAAC,WAAW,CAAC,IACvB,iCAAiC,OAAO,YAAY,IAAI,CAC3D,CAAA;YAEL,oCAAoC;YACpC,OAAO,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QACpC,CAAC;QAED,2BAA2B;QAC3B,IAAI,CAAC,wBAAwB,CACzB,MAAM,EACN,IAAI,CAAC,gBAAgB,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAChD,CAAA;IACL,CAAC;IAED,wEAAwE;IACxE,oBAAoB;IACpB,wEAAwE;IAExE;;;;OAIG;IACO,wBAAwB,CAC9B,MAAqB,EACrB,aAAuB;QAEvB,MAAM,YAAY,GAAG,aAAa,CAAC,KAAK,EAAE,CAAA;QAC1C,IAAI,CAAC,YAAY,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC;YAAE,OAAM;QAElD,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC;gBACtC,MAAM,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,CAAC,QAAuB,EAAE,EAAE,CACjD,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAChC,CAAA;YACL,CAAC;iBAAM,CAAC;gBACJ,MAAM,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAA;YAC7C,CAAC;QACL,CAAC;aAAM,CAAC;YACJ,IAAI,MAAM,CAAC,YAAY,CAAC;gBACpB,IAAI,CAAC,wBAAwB,CACzB,MAAM,CAAC,YAAY,CAAC,EACpB,aAAa,CAChB,CAAA;QACT,CAAC;IACL,CAAC;CACJ;AApID,wDAoIC","sourcesContent":["import type { EventListenerType } from \"./types/EventListenerTypes\"\nimport type { EntityListenerMetadataArgs } from \"../metadata-args/EntityListenerMetadataArgs\"\nimport type { ObjectLiteral } from \"../common/ObjectLiteral\"\nimport type { EntityMetadata } from \"./EntityMetadata\"\nimport type { EmbeddedMetadata } from \"./EmbeddedMetadata\"\n\n/**\n * This metadata contains all information about entity's listeners.\n */\nexport class EntityListenerMetadata {\n    // ---------------------------------------------------------------------\n    // Properties\n    // ---------------------------------------------------------------------\n\n    /**\n     * Entity metadata of the listener.\n     */\n    entityMetadata: EntityMetadata\n\n    /**\n     * Embedded metadata of the listener, in the case if listener is in embedded.\n     */\n    embeddedMetadata?: EmbeddedMetadata\n\n    /**\n     * Target class to which metadata is applied.\n     * This can be different then entityMetadata.target in the case if listener is in the embedded.\n     */\n    target: Function | string\n\n    /**\n     * Target's property name to which this metadata is applied.\n     */\n    propertyName: string\n\n    /**\n     * The type of the listener.\n     */\n    type: EventListenerType\n\n    // ---------------------------------------------------------------------\n    // Constructor\n    // ---------------------------------------------------------------------\n\n    constructor(options: {\n        entityMetadata: EntityMetadata\n        embeddedMetadata?: EmbeddedMetadata\n        args: EntityListenerMetadataArgs\n    }) {\n        this.entityMetadata = options.entityMetadata\n        this.embeddedMetadata = options.embeddedMetadata\n        this.target = options.args.target\n        this.propertyName = options.args.propertyName\n        this.type = options.args.type\n    }\n\n    // ---------------------------------------------------------------------\n    // Public Methods\n    // ---------------------------------------------------------------------\n\n    /**\n     * Checks if entity listener is allowed to be executed on the given entity.\n     * @param entity\n     */\n    isAllowed(entity: ObjectLiteral) {\n        // todo: create in entity metadata method like isInherited?\n        return (\n            this.entityMetadata.target === entity.constructor || // todo: .constructor won't work for entity schemas, but there are no entity listeners in schemas since there are no objects, right?\n            (typeof this.entityMetadata.target === \"function\" &&\n                entity.constructor.prototype instanceof\n                    this.entityMetadata.target)\n        ) // todo: also need to implement entity schema inheritance\n    }\n\n    /**\n     * Executes listener method of the given entity.\n     * @param entity\n     */\n    execute(entity: ObjectLiteral) {\n        // Check if the Embedded Metadata does not exist\n        if (!this.embeddedMetadata) {\n            // Get the Entity's Method\n            const entityMethod = entity[this.propertyName]\n\n            // Check if the Entity Method does not exist\n            if (!entityMethod)\n                throw new Error(\n                    `Entity listener method \"${this.propertyName}\" does not exist in entity \"${entity.constructor.name}\".`,\n                )\n\n            // Check if the Entity Method is not a function\n            if (typeof entityMethod !== \"function\")\n                throw new Error(\n                    `Entity listener method \"${this.propertyName}\" in entity \"${\n                        entity.constructor.name\n                    }\" must be a function but got \"${typeof entityMethod}\".`,\n                )\n\n            // Call and return the Entity Method\n            return entityMethod.call(entity)\n        }\n\n        // Call the Embedded Method\n        this.callEntityEmbeddedMethod(\n            entity,\n            this.embeddedMetadata.propertyPath.split(\".\"),\n        )\n    }\n\n    // ---------------------------------------------------------------------\n    // Protected Methods\n    // ---------------------------------------------------------------------\n\n    /**\n     * Calls embedded entity listener method no matter how nested it is.\n     * @param entity\n     * @param propertyPaths\n     */\n    protected callEntityEmbeddedMethod(\n        entity: ObjectLiteral,\n        propertyPaths: string[],\n    ): void {\n        const propertyPath = propertyPaths.shift()\n        if (!propertyPath || !entity[propertyPath]) return\n\n        if (propertyPaths.length === 0) {\n            if (Array.isArray(entity[propertyPath])) {\n                entity[propertyPath].map((embedded: ObjectLiteral) =>\n                    embedded[this.propertyName](),\n                )\n            } else {\n                entity[propertyPath][this.propertyName]()\n            }\n        } else {\n            if (entity[propertyPath])\n                this.callEntityEmbeddedMethod(\n                    entity[propertyPath],\n                    propertyPaths,\n                )\n        }\n    }\n}\n"]}
+{"version":3,"file":"EntityListenerMetadata.js","sourceRoot":"","sources":["../../../src/metadata/EntityListenerMetadata.ts"],"names":[],"mappings":";;;AAMA;;GAEG;AACH,MAAa,sBAAsB;IA+B/B,wEAAwE;IACxE,cAAc;IACd,wEAAwE;IAExE,YAAY,OAIX;QACG,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,CAAA;QAC5C,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAA;QAChD,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAA;QACjC,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,YAAY,CAAA;QAC7C,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA;IACjC,CAAC;IAED,wEAAwE;IACxE,iBAAiB;IACjB,wEAAwE;IAExE;;;;OAIG;IACH,SAAS,CAAC,MAAqB;QAC3B,2DAA2D;QAC3D,OAAO,CACH,IAAI,CAAC,cAAc,CAAC,MAAM,KAAK,MAAM,CAAC,WAAW,IAAI,oIAAoI;YACzL,CAAC,OAAO,IAAI,CAAC,cAAc,CAAC,MAAM,KAAK,UAAU;gBAC7C,MAAM,CAAC,WAAW,CAAC,SAAS;oBACxB,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CACtC,CAAA,CAAC,yDAAyD;IAC/D,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,MAAqB;QACzB,gDAAgD;QAChD,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACzB,0BAA0B;YAC1B,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;YAE9C,4CAA4C;YAC5C,IAAI,CAAC,YAAY;gBACb,MAAM,IAAI,KAAK,CACX,2BAA2B,IAAI,CAAC,YAAY,+BAA+B,MAAM,CAAC,WAAW,CAAC,IAAI,IAAI,CACzG,CAAA;YAEL,+CAA+C;YAC/C,IAAI,OAAO,YAAY,KAAK,UAAU;gBAClC,MAAM,IAAI,KAAK,CACX,2BAA2B,IAAI,CAAC,YAAY,gBACxC,MAAM,CAAC,WAAW,CAAC,IACvB,iCAAiC,OAAO,YAAY,IAAI,CAC3D,CAAA;YAEL,oCAAoC;YACpC,OAAO,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QACpC,CAAC;QAED,2BAA2B;QAC3B,IAAI,CAAC,wBAAwB,CACzB,MAAM,EACN,IAAI,CAAC,gBAAgB,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAChD,CAAA;IACL,CAAC;IAED,wEAAwE;IACxE,oBAAoB;IACpB,wEAAwE;IAExE;;;;;OAKG;IACO,wBAAwB,CAC9B,MAAqB,EACrB,aAAuB;QAEvB,MAAM,YAAY,GAAG,aAAa,CAAC,KAAK,EAAE,CAAA;QAC1C,IAAI,CAAC,YAAY,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC;YAAE,OAAM;QAElD,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC;gBACtC,MAAM,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,CAAC,QAAuB,EAAE,EAAE,CACjD,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAChC,CAAA;YACL,CAAC;iBAAM,CAAC;gBACJ,MAAM,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAA;YAC7C,CAAC;QACL,CAAC;aAAM,CAAC;YACJ,IAAI,MAAM,CAAC,YAAY,CAAC;gBACpB,IAAI,CAAC,wBAAwB,CACzB,MAAM,CAAC,YAAY,CAAC,EACpB,aAAa,CAChB,CAAA;QACT,CAAC;IACL,CAAC;CACJ;AAvID,wDAuIC","sourcesContent":["import type { EventListenerType } from \"./types/EventListenerTypes\"\nimport type { EntityListenerMetadataArgs } from \"../metadata-args/EntityListenerMetadataArgs\"\nimport type { ObjectLiteral } from \"../common/ObjectLiteral\"\nimport type { EntityMetadata } from \"./EntityMetadata\"\nimport type { EmbeddedMetadata } from \"./EmbeddedMetadata\"\n\n/**\n * This metadata contains all information about entity's listeners.\n */\nexport class EntityListenerMetadata {\n    // ---------------------------------------------------------------------\n    // Properties\n    // ---------------------------------------------------------------------\n\n    /**\n     * Entity metadata of the listener.\n     */\n    entityMetadata: EntityMetadata\n\n    /**\n     * Embedded metadata of the listener, in the case if listener is in embedded.\n     */\n    embeddedMetadata?: EmbeddedMetadata\n\n    /**\n     * Target class to which metadata is applied.\n     * This can be different then entityMetadata.target in the case if listener is in the embedded.\n     */\n    target: Function | string\n\n    /**\n     * Target's property name to which this metadata is applied.\n     */\n    propertyName: string\n\n    /**\n     * The type of the listener.\n     */\n    type: EventListenerType\n\n    // ---------------------------------------------------------------------\n    // Constructor\n    // ---------------------------------------------------------------------\n\n    constructor(options: {\n        entityMetadata: EntityMetadata\n        embeddedMetadata?: EmbeddedMetadata\n        args: EntityListenerMetadataArgs\n    }) {\n        this.entityMetadata = options.entityMetadata\n        this.embeddedMetadata = options.embeddedMetadata\n        this.target = options.args.target\n        this.propertyName = options.args.propertyName\n        this.type = options.args.type\n    }\n\n    // ---------------------------------------------------------------------\n    // Public Methods\n    // ---------------------------------------------------------------------\n\n    /**\n     * Checks if entity listener is allowed to be executed on the given entity.\n     *\n     * @param entity\n     */\n    isAllowed(entity: ObjectLiteral) {\n        // todo: create in entity metadata method like isInherited?\n        return (\n            this.entityMetadata.target === entity.constructor || // todo: .constructor won't work for entity schemas, but there are no entity listeners in schemas since there are no objects, right?\n            (typeof this.entityMetadata.target === \"function\" &&\n                entity.constructor.prototype instanceof\n                    this.entityMetadata.target)\n        ) // todo: also need to implement entity schema inheritance\n    }\n\n    /**\n     * Executes listener method of the given entity.\n     *\n     * @param entity\n     */\n    execute(entity: ObjectLiteral) {\n        // Check if the Embedded Metadata does not exist\n        if (!this.embeddedMetadata) {\n            // Get the Entity's Method\n            const entityMethod = entity[this.propertyName]\n\n            // Check if the Entity Method does not exist\n            if (!entityMethod)\n                throw new Error(\n                    `Entity listener method \"${this.propertyName}\" does not exist in entity \"${entity.constructor.name}\".`,\n                )\n\n            // Check if the Entity Method is not a function\n            if (typeof entityMethod !== \"function\")\n                throw new Error(\n                    `Entity listener method \"${this.propertyName}\" in entity \"${\n                        entity.constructor.name\n                    }\" must be a function but got \"${typeof entityMethod}\".`,\n                )\n\n            // Call and return the Entity Method\n            return entityMethod.call(entity)\n        }\n\n        // Call the Embedded Method\n        this.callEntityEmbeddedMethod(\n            entity,\n            this.embeddedMetadata.propertyPath.split(\".\"),\n        )\n    }\n\n    // ---------------------------------------------------------------------\n    // Protected Methods\n    // ---------------------------------------------------------------------\n\n    /**\n     * Calls embedded entity listener method no matter how nested it is.\n     *\n     * @param entity\n     * @param propertyPaths\n     */\n    protected callEntityEmbeddedMethod(\n        entity: ObjectLiteral,\n        propertyPaths: string[],\n    ): void {\n        const propertyPath = propertyPaths.shift()\n        if (!propertyPath || !entity[propertyPath]) return\n\n        if (propertyPaths.length === 0) {\n            if (Array.isArray(entity[propertyPath])) {\n                entity[propertyPath].map((embedded: ObjectLiteral) =>\n                    embedded[this.propertyName](),\n                )\n            } else {\n                entity[propertyPath][this.propertyName]()\n            }\n        } else {\n            if (entity[propertyPath])\n                this.callEntityEmbeddedMethod(\n                    entity[propertyPath],\n                    propertyPaths,\n                )\n        }\n    }\n}\n"]}

package/metadata/EntityMetadata.d.ts

@@ -29,6 +29,7 @@ export declare class EntityMetadata {
     dataSource: DataSource;
     /**
      * DataSource where this entity metadata is created.
+     *
      * @deprecated since 1.0.0. Use {@link dataSource} instance instead.
      */
     get connection(): DataSource;
@@ -430,6 +431,7 @@ export declare class EntityMetadata {
     });
     /**
      * Creates a new entity.
+     *
      * @param queryRunner
      * @param options
      * @param options.fromDeserializer
@@ -441,12 +443,14 @@ export declare class EntityMetadata {
     }): any;
     /**
      * Checks if given entity has an id.
+     *
      * @param entity
      */
     hasId(entity: ObjectLiteral): boolean;
     /**
      * Checks if given entity / object contains ALL primary keys entity must have.
      * Returns true if it contains all of them, false if at least one of them is not defined.
+     *
      * @param entity
      */
     hasAllPrimaryKeys(entity: ObjectLiteral): boolean;
@@ -455,6 +459,7 @@ export declare class EntityMetadata {
      * If given id is an object then it means its already id map.
      * If given id isn't an object then it means its a value of the id column
      * and it creates a new id map with this value and name of the primary column.
+     *
      * @param id
      */
     ensureEntityIdMap(id: any): ObjectLiteral;
@@ -463,6 +468,7 @@ export declare class EntityMetadata {
      * For example, for Post{ id: 1, title: "hello" } where id is primary it will return { id: 1 }
      * For multiple primary keys it returns multiple keys in object.
      * For primary keys inside embeds it returns complex object literal with keys in them.
+     *
      * @param entity
      */
     getEntityIdMap(entity: ObjectLiteral | undefined): ObjectLiteral | undefined;
@@ -471,76 +477,90 @@ export declare class EntityMetadata {
      * If entity has multiple primary keys (ids) then it will return just regular id map, like what getEntityIdMap returns.
      * But if entity has a single primary key then it will return just value of the id column of the entity, just value.
      * This is called mixed id map.
+     *
      * @param entity
      */
     getEntityIdMixedMap(entity: ObjectLiteral | undefined): ObjectLiteral | undefined;
     /**
      * Compares two different entities by their ids.
      * Returns true if they match, false otherwise.
+     *
      * @param firstEntity
      * @param secondEntity
      */
     compareEntities(firstEntity: ObjectLiteral, secondEntity: ObjectLiteral): boolean;
     /**
      * Finds column with a given property name.
+     *
      * @param propertyName
      */
     findColumnWithPropertyName(propertyName: string): ColumnMetadata | undefined;
     /**
      * Finds column with a given database name.
+     *
      * @param databaseName
      */
     findColumnWithDatabaseName(databaseName: string): ColumnMetadata | undefined;
     /**
      * Checks if there is a column or relationship with a given property path.
+     *
      * @param propertyPath
      */
     hasColumnWithPropertyPath(propertyPath: string): boolean;
     /**
      * Finds column with a given property path.
+     *
      * @param propertyPath
      */
     findColumnWithPropertyPath(propertyPath: string): ColumnMetadata | undefined;
     /**
      * Finds column with a given property path.
      * Does not search in relation unlike findColumnWithPropertyPath.
+     *
      * @param propertyPath
      */
     findColumnWithPropertyPathStrict(propertyPath: string): ColumnMetadata | undefined;
     /**
      * Finds columns with a given property path.
      * Property path can match a relation, and relations can contain multiple columns.
+     *
      * @param propertyPath
      */
     findColumnsWithPropertyPath(propertyPath: string): ColumnMetadata[];
     /**
      * Checks if there is a relation with the given property path.
+     *
      * @param propertyPath
      */
     hasRelationWithPropertyPath(propertyPath: string): boolean;
     /**
      * Finds relation with the given property path.
+     *
      * @param propertyPath
      */
     findRelationWithPropertyPath(propertyPath: string): RelationMetadata | undefined;
     /**
      * Checks if there is an embedded with a given property path.
+     *
      * @param propertyPath
      */
     hasEmbeddedWithPropertyPath(propertyPath: string): boolean;
     /**
      * Finds embedded with a given property path.
+     *
      * @param propertyPath
      */
     findEmbeddedWithPropertyPath(propertyPath: string): EmbeddedMetadata | undefined;
     /**
      * Returns an array of databaseNames mapped from provided propertyPaths
+     *
      * @param propertyPaths
      */
     mapPropertyPathsToColumns(propertyPaths: string[]): ColumnMetadata[];
     /**
      * Iterates through entity and finds and extracts all values from relations in the entity.
      * If relation value is an array its being flattened.
+     *
      * @param entity
      * @param relations
      */
@@ -548,6 +568,7 @@ export declare class EntityMetadata {
     /**
      * In the case of SingleTableInheritance, find the correct metadata
      * for a given value.
+     *
      * @param value The value to find the metadata for.
      * @returns The found metadata for the entity or the base metadata if no matching metadata
      *          was found in the whole inheritance tree.
@@ -557,6 +578,7 @@ export declare class EntityMetadata {
     /**
      * Finds difference between two entity id maps.
      * Returns items that exist in the first array and absent in the second array.
+     *
      * @param firstIdMaps
      * @param secondIdMaps
      */
@@ -564,17 +586,15 @@ export declare class EntityMetadata {
     /**
      * Creates value map from the given values and columns.
      * Examples of usages are primary columns map and join columns map.
+     *
      * @param entity
      * @param columns
-     * @param options
-     * @param options.skipNulls
      */
-    static getValueMap(entity: ObjectLiteral, columns: ColumnMetadata[], options?: {
-        skipNulls?: boolean;
-    }): ObjectLiteral | undefined;
+    static getValueMap(entity: ObjectLiteral, columns: ColumnMetadata[]): ObjectLiteral | undefined;
     build(): void;
     /**
      * Registers a new column in the entity and recomputes all depend properties.
+     *
      * @param column
      */
     registerColumn(column: ColumnMetadata): void;

package/metadata/EntityMetadata.js

@@ -12,6 +12,7 @@ const StringUtils_1 = require("../util/StringUtils");
 class EntityMetadata {
     /**
      * DataSource where this entity metadata is created.
+     *
      * @deprecated since 1.0.0. Use {@link dataSource} instance instead.
      */
     get connection() {
@@ -248,7 +249,7 @@ class EntityMetadata {
          */
         this.afterRecoverListeners = [];
         this.dataSource = options.dataSource;
-        this.inheritanceTree = options.inheritanceTree || [];
+        this.inheritanceTree = options.inheritanceTree ?? [];
         this.inheritancePattern = options.inheritancePattern;
         this.treeType = options.tableTree ? options.tableTree.type : undefined;
         this.treeOptions = options.tableTree
@@ -267,13 +268,14 @@ class EntityMetadata {
     // -------------------------------------------------------------------------
     /**
      * Creates a new entity.
+     *
      * @param queryRunner
      * @param options
      * @param options.fromDeserializer
      * @param options.pojo
      */
     create(queryRunner, options) {
-        const pojo = options && options.pojo === true ? true : false;
+        const pojo = options?.pojo === true ? true : false;
         // if target is set to a function (e.g. class) that can be created then create it
         let ret;
         if (typeof this.target === "function" && !pojo) {
@@ -297,6 +299,7 @@ class EntityMetadata {
     }
     /**
      * Checks if given entity has an id.
+     *
      * @param entity
      */
     hasId(entity) {
@@ -310,6 +313,7 @@ class EntityMetadata {
     /**
      * Checks if given entity / object contains ALL primary keys entity must have.
      * Returns true if it contains all of them, false if at least one of them is not defined.
+     *
      * @param entity
      */
     hasAllPrimaryKeys(entity) {
@@ -323,6 +327,7 @@ class EntityMetadata {
      * If given id is an object then it means its already id map.
      * If given id isn't an object then it means its a value of the id column
      * and it creates a new id map with this value and name of the primary column.
+     *
      * @param id
      */
     ensureEntityIdMap(id) {
@@ -337,20 +342,20 @@ class EntityMetadata {
      * For example, for Post{ id: 1, title: "hello" } where id is primary it will return { id: 1 }
      * For multiple primary keys it returns multiple keys in object.
      * For primary keys inside embeds it returns complex object literal with keys in them.
+     *
      * @param entity
      */
     getEntityIdMap(entity) {
         if (!entity)
             return undefined;
-        return EntityMetadata.getValueMap(entity, this.primaryColumns, {
-            skipNulls: true,
-        });
+        return EntityMetadata.getValueMap(entity, this.primaryColumns);
     }
     /**
      * Creates a "mixed id map".
      * If entity has multiple primary keys (ids) then it will return just regular id map, like what getEntityIdMap returns.
      * But if entity has a single primary key then it will return just value of the id column of the entity, just value.
      * This is called mixed id map.
+     *
      * @param entity
      */
     getEntityIdMixedMap(entity) {
@@ -368,6 +373,7 @@ class EntityMetadata {
     /**
      * Compares two different entities by their ids.
      * Returns true if they match, false otherwise.
+     *
      * @param firstEntity
      * @param secondEntity
      */
@@ -382,6 +388,7 @@ class EntityMetadata {
     }
     /**
      * Finds column with a given property name.
+     *
      * @param propertyName
      */
     findColumnWithPropertyName(propertyName) {
@@ -389,6 +396,7 @@ class EntityMetadata {
     }
     /**
      * Finds column with a given database name.
+     *
      * @param databaseName
      */
     findColumnWithDatabaseName(databaseName) {
@@ -396,6 +404,7 @@ class EntityMetadata {
     }
     /**
      * Checks if there is a column or relationship with a given property path.
+     *
      * @param propertyPath
      */
     hasColumnWithPropertyPath(propertyPath) {
@@ -404,6 +413,7 @@ class EntityMetadata {
     }
     /**
      * Finds column with a given property path.
+     *
      * @param propertyPath
      */
     findColumnWithPropertyPath(propertyPath) {
@@ -413,13 +423,14 @@ class EntityMetadata {
         // in the case if column with property path was not found, try to find a relation with such property path
         // if we find relation and it has a single join column then its the column user was seeking
         const relation = this.relations.find((relation) => relation.propertyPath === propertyPath);
-        if (relation && relation.joinColumns.length === 1)
+        if (relation?.joinColumns.length === 1)
             return relation.joinColumns[0];
         return undefined;
     }
     /**
      * Finds column with a given property path.
      * Does not search in relation unlike findColumnWithPropertyPath.
+     *
      * @param propertyPath
      */
     findColumnWithPropertyPathStrict(propertyPath) {
@@ -428,6 +439,7 @@ class EntityMetadata {
     /**
      * Finds columns with a given property path.
      * Property path can match a relation, and relations can contain multiple columns.
+     *
      * @param propertyPath
      */
     findColumnsWithPropertyPath(propertyPath) {
@@ -437,12 +449,13 @@ class EntityMetadata {
         // in the case if column with property path was not found, try to find a relation with such property path
         // if we find relation and it has a single join column then its the column user was seeking
         const relation = this.findRelationWithPropertyPath(propertyPath);
-        if (relation && relation.joinColumns)
+        if (relation?.joinColumns)
             return relation.joinColumns;
         return [];
     }
     /**
      * Checks if there is a relation with the given property path.
+     *
      * @param propertyPath
      */
     hasRelationWithPropertyPath(propertyPath) {
@@ -450,6 +463,7 @@ class EntityMetadata {
     }
     /**
      * Finds relation with the given property path.
+     *
      * @param propertyPath
      */
     findRelationWithPropertyPath(propertyPath) {
@@ -457,6 +471,7 @@ class EntityMetadata {
     }
     /**
      * Checks if there is an embedded with a given property path.
+     *
      * @param propertyPath
      */
     hasEmbeddedWithPropertyPath(propertyPath) {
@@ -464,6 +479,7 @@ class EntityMetadata {
     }
     /**
      * Finds embedded with a given property path.
+     *
      * @param propertyPath
      */
     findEmbeddedWithPropertyPath(propertyPath) {
@@ -471,6 +487,7 @@ class EntityMetadata {
     }
     /**
      * Returns an array of databaseNames mapped from provided propertyPaths
+     *
      * @param propertyPaths
      */
     mapPropertyPathsToColumns(propertyPaths) {
@@ -485,6 +502,7 @@ class EntityMetadata {
     /**
      * Iterates through entity and finds and extracts all values from relations in the entity.
      * If relation value is an array its being flattened.
+     *
      * @param entity
      * @param relations
      */
@@ -512,6 +530,7 @@ class EntityMetadata {
     /**
      * In the case of SingleTableInheritance, find the correct metadata
      * for a given value.
+     *
      * @param value The value to find the metadata for.
      * @returns The found metadata for the entity or the base metadata if no matching metadata
      *          was found in the whole inheritance tree.
@@ -530,7 +549,7 @@ class EntityMetadata {
             }
             return (this.childEntityMetadatas.find((meta) => manuallySetDiscriminatorValue ===
                 meta.discriminatorValue ||
-                value.constructor === meta.target) || this);
+                value.constructor === meta.target) ?? this);
         }
         return this;
     }
@@ -546,6 +565,7 @@ class EntityMetadata {
     /**
      * Finds difference between two entity id maps.
      * Returns items that exist in the first array and absent in the second array.
+     *
      * @param firstIdMaps
      * @param secondIdMaps
      */
@@ -557,14 +577,13 @@ class EntityMetadata {
     /**
      * Creates value map from the given values and columns.
      * Examples of usages are primary columns map and join columns map.
+     *
      * @param entity
      * @param columns
-     * @param options
-     * @param options.skipNulls
      */
-    static getValueMap(entity, columns, options) {
+    static getValueMap(entity, columns) {
         return columns.reduce((map, column) => {
-            const value = column.getEntityValueMap(entity, options);
+            const value = column.getEntityValueMap(entity);
             // make sure that none of the values of the columns are not missing
             if (map === undefined || value === null || value === undefined)
                 return undefined;
@@ -651,6 +670,7 @@ class EntityMetadata {
     }
     /**
      * Registers a new column in the entity and recomputes all depend properties.
+     *
      * @param column
      */
     registerColumn(column) {