@lakutata/orm 3.0.0 → 3.1.1

package/dist/vendor/typeorm/persistence/EntityPersistExecutor.js

@@ -0,0 +1,179 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EntityPersistExecutor = void 0;
+const MustBeEntityError_1 = require("../error/MustBeEntityError");
+const SubjectExecutor_1 = require("./SubjectExecutor");
+const CannotDetermineEntityError_1 = require("../error/CannotDetermineEntityError");
+const Subject_1 = require("./Subject");
+const OneToManySubjectBuilder_1 = require("./subject-builder/OneToManySubjectBuilder");
+const OneToOneInverseSideSubjectBuilder_1 = require("./subject-builder/OneToOneInverseSideSubjectBuilder");
+const ManyToManySubjectBuilder_1 = require("./subject-builder/ManyToManySubjectBuilder");
+const SubjectDatabaseEntityLoader_1 = require("./SubjectDatabaseEntityLoader");
+const CascadesSubjectBuilder_1 = require("./subject-builder/CascadesSubjectBuilder");
+const OrmUtils_1 = require("../util/OrmUtils");
+/**
+ * Persists a single entity or multiple entities - saves or removes them.
+ */
+class EntityPersistExecutor {
+    // -------------------------------------------------------------------------
+    // Constructor
+    // -------------------------------------------------------------------------
+    constructor(dataSource, queryRunner, mode, target, entity, options) {
+        this.dataSource = dataSource;
+        this.queryRunner = queryRunner;
+        this.mode = mode;
+        this.target = target;
+        this.entity = entity;
+        this.options = options;
+    }
+    // -------------------------------------------------------------------------
+    // Public Methods
+    // -------------------------------------------------------------------------
+    /**
+     * Executes persistence operation ob given entity or entities.
+     */
+    async execute() {
+        // check if entity we are going to save is valid and is an object
+        if (!this.entity || typeof this.entity !== "object")
+            return Promise.reject(new MustBeEntityError_1.MustBeEntityError(this.mode, this.entity));
+        // we MUST call "fake" resolve here to make sure all properties of lazily loaded relations are resolved
+        await Promise.resolve();
+        // if query runner is already defined in this class, it means this entity manager was already created for a single connection
+        // if its not defined we create a new query runner - single connection where we'll execute all our operations
+        const queryRunner = this.queryRunner ?? this.dataSource.createQueryRunner();
+        // save data in the query runner - this is useful functionality to share data from outside of the world
+        // with third classes - like subscribers and listener methods
+        const oldQueryRunnerData = queryRunner.data;
+        if (this.options?.data) {
+            queryRunner.data = this.options.data;
+        }
+        try {
+            // collect all operate subjects
+            const entities = Array.isArray(this.entity)
+                ? this.entity
+                : [this.entity];
+            const chunkSize = this.options?.chunk ?? 0;
+            const entitiesInChunks = chunkSize > 0 ? OrmUtils_1.OrmUtils.chunk(entities, chunkSize) : [entities];
+            const buildExecutor = async (entities) => {
+                const subjects = [];
+                // create subjects for all entities we received for the persistence
+                entities.forEach((entity) => {
+                    const entityTarget = this.target ?? entity.constructor;
+                    if (entityTarget === Object)
+                        throw new CannotDetermineEntityError_1.CannotDetermineEntityError(this.mode);
+                    const metadata = this.dataSource
+                        .getMetadata(entityTarget)
+                        .findInheritanceMetadata(entity);
+                    subjects.push(new Subject_1.Subject({
+                        metadata,
+                        entity: entity,
+                        canBeInserted: this.mode === "save",
+                        canBeUpdated: this.mode === "save",
+                        mustBeRemoved: this.mode === "remove",
+                        canBeSoftRemoved: this.mode === "soft-remove",
+                        canBeRecovered: this.mode === "recover",
+                    }));
+                });
+                // console.time("building cascades...");
+                // go through each entity with metadata and create subjects and subjects by cascades for them
+                const cascadesSubjectBuilder = new CascadesSubjectBuilder_1.CascadesSubjectBuilder(subjects);
+                subjects.forEach((subject) => {
+                    // next step we build list of subjects we will operate with
+                    // these subjects are subjects that we need to insert or update alongside with main persisted entity
+                    cascadesSubjectBuilder.build(subject, this.mode);
+                });
+                // console.timeEnd("building cascades...");
+                // load database entities for all subjects we have
+                // next step is to load database entities for all operate subjects
+                // console.time("loading...");
+                await new SubjectDatabaseEntityLoader_1.SubjectDatabaseEntityLoader(queryRunner, subjects).load(this.mode);
+                // console.timeEnd("loading...");
+                // console.time("other subjects...");
+                // build all related subjects and change maps
+                if (this.mode === "save" ||
+                    this.mode === "soft-remove" ||
+                    this.mode === "recover") {
+                    new OneToManySubjectBuilder_1.OneToManySubjectBuilder(subjects).build();
+                    new OneToOneInverseSideSubjectBuilder_1.OneToOneInverseSideSubjectBuilder(subjects).build();
+                    new ManyToManySubjectBuilder_1.ManyToManySubjectBuilder(subjects).build();
+                }
+                else {
+                    subjects.forEach((subject) => {
+                        if (subject.mustBeRemoved) {
+                            new ManyToManySubjectBuilder_1.ManyToManySubjectBuilder(subjects).buildForAllRemoval(subject);
+                        }
+                    });
+                }
+                // console.timeEnd("other subjects...");
+                // console.timeEnd("building subjects...");
+                // console.log("subjects", subjects);
+                // create a subject executor
+                return new SubjectExecutor_1.SubjectExecutor(queryRunner, subjects, this.options);
+            };
+            // console.time("building subject executors...");
+            // Avoid concurrent queries on the same pg client; see #12238.
+            // CockroachDB uses the pg package over a single connection too.
+            const driverType = this.dataSource.options.type;
+            let executors;
+            if (driverType === "postgres" || driverType === "cockroachdb") {
+                executors = [];
+                for (const entities of entitiesInChunks) {
+                    executors.push(await buildExecutor(entities));
+                }
+            }
+            else {
+                executors = await Promise.all(entitiesInChunks.map(buildExecutor));
+            }
+            // console.timeEnd("building subject executors...");
+            // make sure we have at least one executable operation before we create a transaction and proceed
+            // if we don't have operations it means we don't really need to update or remove something
+            const executorsWithExecutableOperations = executors.filter((executor) => executor.hasExecutableOperations);
+            if (executorsWithExecutableOperations.length === 0)
+                return;
+            // start execute queries in a transaction
+            // if transaction is already opened in this query runner then we don't touch it
+            // if its not opened yet then we open it here, and once we finish - we close it
+            let isTransactionStartedByUs = false;
+            try {
+                // open transaction if its not opened yet
+                if (!queryRunner.isTransactionActive) {
+                    if (this.dataSource.driver.transactionSupport !== "none" &&
+                        this.options?.transaction !== false) {
+                        // start transaction until it was not explicitly disabled
+                        isTransactionStartedByUs = true;
+                        await queryRunner.startTransaction();
+                    }
+                }
+                // execute all persistence operations for all entities we have
+                // console.time("executing subject executors...");
+                for (const executor of executorsWithExecutableOperations) {
+                    await executor.execute();
+                }
+                // console.timeEnd("executing subject executors...");
+                // commit transaction if it was started by us
+                // console.time("commit");
+                if (isTransactionStartedByUs === true)
+                    await queryRunner.commitTransaction();
+                // console.timeEnd("commit");
+            }
+            catch (error) {
+                // rollback transaction if it was started by us
+                if (isTransactionStartedByUs) {
+                    try {
+                        await queryRunner.rollbackTransaction();
+                    }
+                    catch (rollbackError) { }
+                }
+                throw error;
+            }
+        }
+        finally {
+            queryRunner.data = oldQueryRunnerData;
+            // release query runner only if its created by us
+            if (!this.queryRunner)
+                await queryRunner.release();
+        }
+    }
+}
+exports.EntityPersistExecutor = EntityPersistExecutor;
+//# sourceMappingURL=EntityPersistExecutor.js.map

package/dist/vendor/typeorm/persistence/EntityPersistExecutor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EntityPersistExecutor.js","sourceRoot":"","sources":["../../../../vendor/typeorm/persistence/EntityPersistExecutor.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ObjectLiteral } from \"../common/ObjectLiteral\"\nimport type { SaveOptions } from \"../repository/SaveOptions\"\nimport type { RemoveOptions } from \"../repository/RemoveOptions\"\nimport { MustBeEntityError } from \"../error/MustBeEntityError\"\nimport { SubjectExecutor } from \"./SubjectExecutor\"\nimport { CannotDetermineEntityError } from \"../error/CannotDetermineEntityError\"\nimport type { QueryRunner } from \"../query-runner/QueryRunner\"\nimport type { DataSource } from \"../data-source/DataSource\"\nimport { Subject } from \"./Subject\"\nimport { OneToManySubjectBuilder } from \"./subject-builder/OneToManySubjectBuilder\"\nimport { OneToOneInverseSideSubjectBuilder } from \"./subject-builder/OneToOneInverseSideSubjectBuilder\"\nimport { ManyToManySubjectBuilder } from \"./subject-builder/ManyToManySubjectBuilder\"\nimport { SubjectDatabaseEntityLoader } from \"./SubjectDatabaseEntityLoader\"\nimport { CascadesSubjectBuilder } from \"./subject-builder/CascadesSubjectBuilder\"\nimport { OrmUtils } from \"../util/OrmUtils\"\n\n/**\n * Persists a single entity or multiple entities - saves or removes them.\n */\nexport class EntityPersistExecutor {\n    // -------------------------------------------------------------------------\n    // Constructor\n    // -------------------------------------------------------------------------\n\n    constructor(\n        protected dataSource: DataSource,\n        protected queryRunner: QueryRunner | undefined,\n        protected mode: \"save\" | \"remove\" | \"soft-remove\" | \"recover\",\n        protected target: Function | string | undefined,\n        protected entity: ObjectLiteral | ObjectLiteral[],\n        protected options?: SaveOptions & RemoveOptions,\n    ) {}\n\n    // -------------------------------------------------------------------------\n    // Public Methods\n    // -------------------------------------------------------------------------\n\n    /**\n     * Executes persistence operation ob given entity or entities.\n     */\n    async execute(): Promise<void> {\n        // check if entity we are going to save is valid and is an object\n        if (!this.entity || typeof this.entity !== \"object\")\n            return Promise.reject(new MustBeEntityError(this.mode, this.entity))\n\n        // we MUST call \"fake\" resolve here to make sure all properties of lazily loaded relations are resolved\n        await Promise.resolve()\n\n        // if query runner is already defined in this class, it means this entity manager was already created for a single connection\n        // if its not defined we create a new query runner - single connection where we'll execute all our operations\n        const queryRunner =\n            this.queryRunner ?? this.dataSource.createQueryRunner()\n\n        // save data in the query runner - this is useful functionality to share data from outside of the world\n        // with third classes - like subscribers and listener methods\n        const oldQueryRunnerData = queryRunner.data\n        if (this.options?.data) {\n            queryRunner.data = this.options.data\n        }\n\n        try {\n            // collect all operate subjects\n            const entities: ObjectLiteral[] = Array.isArray(this.entity)\n                ? this.entity\n                : [this.entity]\n            const chunkSize = this.options?.chunk ?? 0\n            const entitiesInChunks =\n                chunkSize > 0 ? OrmUtils.chunk(entities, chunkSize) : [entities]\n\n            const buildExecutor = async (\n                entities: ObjectLiteral[],\n            ): Promise<SubjectExecutor> => {\n                const subjects: Subject[] = []\n\n                // create subjects for all entities we received for the persistence\n                entities.forEach((entity) => {\n                    const entityTarget = this.target ?? entity.constructor\n                    if (entityTarget === Object)\n                        throw new CannotDetermineEntityError(this.mode)\n\n                    const metadata = this.dataSource\n                        .getMetadata(entityTarget)\n                        .findInheritanceMetadata(entity)\n\n                    subjects.push(\n                        new Subject({\n                            metadata,\n                            entity: entity,\n                            canBeInserted: this.mode === \"save\",\n                            canBeUpdated: this.mode === \"save\",\n                            mustBeRemoved: this.mode === \"remove\",\n                            canBeSoftRemoved: this.mode === \"soft-remove\",\n                            canBeRecovered: this.mode === \"recover\",\n                        }),\n                    )\n                })\n\n                // console.time(\"building cascades...\");\n                // go through each entity with metadata and create subjects and subjects by cascades for them\n                const cascadesSubjectBuilder = new CascadesSubjectBuilder(\n                    subjects,\n                )\n                subjects.forEach((subject) => {\n                    // next step we build list of subjects we will operate with\n                    // these subjects are subjects that we need to insert or update alongside with main persisted entity\n                    cascadesSubjectBuilder.build(subject, this.mode)\n                })\n                // console.timeEnd(\"building cascades...\");\n\n                // load database entities for all subjects we have\n                // next step is to load database entities for all operate subjects\n                // console.time(\"loading...\");\n                await new SubjectDatabaseEntityLoader(\n                    queryRunner,\n                    subjects,\n                ).load(this.mode)\n                // console.timeEnd(\"loading...\");\n\n                // console.time(\"other subjects...\");\n                // build all related subjects and change maps\n                if (\n                    this.mode === \"save\" ||\n                    this.mode === \"soft-remove\" ||\n                    this.mode === \"recover\"\n                ) {\n                    new OneToManySubjectBuilder(subjects).build()\n                    new OneToOneInverseSideSubjectBuilder(subjects).build()\n                    new ManyToManySubjectBuilder(subjects).build()\n                } else {\n                    subjects.forEach((subject) => {\n                        if (subject.mustBeRemoved) {\n                            new ManyToManySubjectBuilder(\n                                subjects,\n                            ).buildForAllRemoval(subject)\n                        }\n                    })\n                }\n                // console.timeEnd(\"other subjects...\");\n                // console.timeEnd(\"building subjects...\");\n                // console.log(\"subjects\", subjects);\n\n                // create a subject executor\n                return new SubjectExecutor(queryRunner, subjects, this.options)\n            }\n\n            // console.time(\"building subject executors...\");\n            // Avoid concurrent queries on the same pg client; see #12238.\n            // CockroachDB uses the pg package over a single connection too.\n            const driverType = this.dataSource.options.type\n            let executors: SubjectExecutor[]\n            if (driverType === \"postgres\" || driverType === \"cockroachdb\") {\n                executors = []\n                for (const entities of entitiesInChunks) {\n                    executors.push(await buildExecutor(entities))\n                }\n            } else {\n                executors = await Promise.all(\n                    entitiesInChunks.map(buildExecutor),\n                )\n            }\n            // console.timeEnd(\"building subject executors...\");\n\n            // make sure we have at least one executable operation before we create a transaction and proceed\n            // if we don't have operations it means we don't really need to update or remove something\n            const executorsWithExecutableOperations = executors.filter(\n                (executor) => executor.hasExecutableOperations,\n            )\n            if (executorsWithExecutableOperations.length === 0) return\n\n            // start execute queries in a transaction\n            // if transaction is already opened in this query runner then we don't touch it\n            // if its not opened yet then we open it here, and once we finish - we close it\n            let isTransactionStartedByUs = false\n            try {\n                // open transaction if its not opened yet\n                if (!queryRunner.isTransactionActive) {\n                    if (\n                        this.dataSource.driver.transactionSupport !== \"none\" &&\n                        this.options?.transaction !== false\n                    ) {\n                        // start transaction until it was not explicitly disabled\n                        isTransactionStartedByUs = true\n                        await queryRunner.startTransaction()\n                    }\n                }\n\n                // execute all persistence operations for all entities we have\n                // console.time(\"executing subject executors...\");\n                for (const executor of executorsWithExecutableOperations) {\n                    await executor.execute()\n                }\n                // console.timeEnd(\"executing subject executors...\");\n\n                // commit transaction if it was started by us\n                // console.time(\"commit\");\n                if (isTransactionStartedByUs === true)\n                    await queryRunner.commitTransaction()\n                // console.timeEnd(\"commit\");\n            } catch (error) {\n                // rollback transaction if it was started by us\n                if (isTransactionStartedByUs) {\n                    try {\n                        await queryRunner.rollbackTransaction()\n                    } catch (rollbackError) {}\n                }\n                throw error\n            }\n        } finally {\n            queryRunner.data = oldQueryRunnerData\n\n            // release query runner only if its created by us\n            if (!this.queryRunner) await queryRunner.release()\n        }\n    }\n}\n"]}

package/dist/vendor/typeorm/persistence/Subject.d.ts

@@ -0,0 +1,155 @@
+import type { ObjectLiteral } from "../common/ObjectLiteral";
+import type { EntityMetadata } from "../metadata/EntityMetadata";
+import type { SubjectChangeMap } from "./SubjectChangeMap";
+import type { RelationMetadata } from "../metadata/RelationMetadata";
+import type { ColumnMetadata } from "../metadata/ColumnMetadata";
+/**
+ * Subject is a subject of persistence.
+ * It holds information about each entity that needs to be persisted:
+ * - what entity should be persisted
+ * - what is database representation of the persisted entity
+ * - what entity metadata of the persisted entity
+ * - what is allowed to with persisted entity (insert/update/remove)
+ *
+ * Having this collection of subjects we can perform database queries.
+ */
+export declare class Subject {
+    readonly "@instanceof": symbol;
+    /**
+     * Entity metadata of the subject entity.
+     */
+    metadata: EntityMetadata;
+    /**
+     * Subject identifier.
+     * This identifier is not limited to table entity primary columns.
+     * This can be entity id or ids as well as some unique entity properties, like name or title.
+     * Insert / Update / Remove operation will be executed by a given identifier.
+     */
+    identifier: ObjectLiteral | undefined;
+    /**
+     * Copy of entity but with relational ids fulfilled.
+     */
+    entityWithFulfilledIds: ObjectLiteral | undefined;
+    /**
+     * If subject was created by cascades this property will contain subject
+     * from where this subject was created.
+     */
+    parentSubject?: Subject;
+    /**
+     * Gets entity sent to the persistence (e.g. changed entity).
+     * If entity is not set then this subject is created only for the entity loaded from the database,
+     * or this subject is used for the junction operation (junction operations are relying only on identifier).
+     */
+    entity?: ObjectLiteral;
+    /**
+     * Database entity.
+     * THIS IS NOT RAW ENTITY DATA, its a real entity.
+     */
+    databaseEntity?: ObjectLiteral;
+    /**
+     * Indicates if database entity was loaded.
+     * No matter if it was found or not, it indicates the fact of loading.
+     */
+    databaseEntityLoaded: boolean;
+    /**
+     * Changes needs to be applied in the database for the given subject.
+     */
+    changeMaps: SubjectChangeMap[];
+    /**
+     * Generated values returned by a database (for example generated id or default values).
+     * Used in insert and update operations.
+     * Has entity-like structure (not just column database name and values).
+     */
+    generatedMap?: ObjectLiteral;
+    /**
+     * Inserted values with updated values of special and default columns.
+     * Has entity-like structure (not just column database name and values).
+     */
+    insertedValueSet?: ObjectLiteral;
+    /**
+     * Indicates if this subject can be inserted into the database.
+     * This means that this subject either is newly persisted, either can be inserted by cascades.
+     */
+    canBeInserted: boolean;
+    /**
+     * Indicates if this subject can be updated in the database.
+     * This means that this subject either was persisted, either can be updated by cascades.
+     */
+    canBeUpdated: boolean;
+    /**
+     * Indicates if this subject MUST be removed from the database.
+     * This means that this subject either was removed, either was removed by cascades.
+     */
+    mustBeRemoved: boolean;
+    /**
+     * Indicates if this subject can be soft-removed from the database.
+     * This means that this subject either was soft-removed, either was soft-removed by cascades.
+     */
+    canBeSoftRemoved: boolean;
+    /**
+     * Indicates if this subject can be recovered from the database.
+     * This means that this subject either was recovered, either was recovered by cascades.
+     */
+    canBeRecovered: boolean;
+    /**
+     * Relations updated by the change maps.
+     */
+    updatedRelationMaps: {
+        relation: RelationMetadata;
+        value: ObjectLiteral;
+    }[];
+    /**
+     * List of updated columns
+     */
+    diffColumns: ColumnMetadata[];
+    /**
+     * List of updated relations
+     */
+    diffRelations: RelationMetadata[];
+    constructor(options: {
+        metadata: EntityMetadata;
+        parentSubject?: Subject;
+        entity?: ObjectLiteral;
+        canBeInserted?: boolean;
+        canBeUpdated?: boolean;
+        mustBeRemoved?: boolean;
+        canBeSoftRemoved?: boolean;
+        canBeRecovered?: boolean;
+        identifier?: ObjectLiteral;
+        changeMaps?: SubjectChangeMap[];
+    });
+    /**
+     * Checks if this subject must be inserted into the database.
+     * Subject can be inserted into the database if it is allowed to be inserted (explicitly persisted or by cascades)
+     * and if it does not have database entity set.
+     */
+    get mustBeInserted(): boolean;
+    /**
+     * Checks if this subject must be updated into the database.
+     * Subject can be updated in the database if it is allowed to be updated (explicitly persisted or by cascades)
+     * and if it does have differentiated columns or relations.
+     */
+    get mustBeUpdated(): boolean | undefined;
+    /**
+     * Checks if this subject must be soft-removed into the database.
+     * Subject can be updated in the database if it is allowed to be soft-removed (explicitly persisted or by cascades)
+     * and if it does have differentiated columns or relations.
+     */
+    get mustBeSoftRemoved(): boolean | ObjectLiteral | undefined;
+    /**
+     * Checks if this subject must be recovered into the database.
+     * Subject can be updated in the database if it is allowed to be recovered (explicitly persisted or by cascades)
+     * and if it does have differentiated columns or relations.
+     */
+    get mustBeRecovered(): boolean | ObjectLiteral | undefined;
+    /**
+     * Creates a value set needs to be inserted / updated in the database.
+     * Value set is based on the entity and change maps of the subject.
+     * Important note: this method pops data from this subject's change maps.
+     */
+    createValueSetAndPopChangeMap(): ObjectLiteral;
+    /**
+     * Recomputes entityWithFulfilledIds and identifier when entity changes.
+     */
+    recompute(): void;
+}

package/dist/vendor/typeorm/persistence/Subject.js

@@ -0,0 +1,237 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Subject = void 0;
+const OrmUtils_1 = require("../util/OrmUtils");
+const ObjectUtils_1 = require("../util/ObjectUtils");
+const InstanceChecker_1 = require("../util/InstanceChecker");
+const Uint8ArrayUtils_1 = require("../util/Uint8ArrayUtils");
+/**
+ * Subject is a subject of persistence.
+ * It holds information about each entity that needs to be persisted:
+ * - what entity should be persisted
+ * - what is database representation of the persisted entity
+ * - what entity metadata of the persisted entity
+ * - what is allowed to with persisted entity (insert/update/remove)
+ *
+ * Having this collection of subjects we can perform database queries.
+ */
+class Subject {
+    // -------------------------------------------------------------------------
+    // Constructor
+    // -------------------------------------------------------------------------
+    constructor(options) {
+        this["@instanceof"] = Symbol.for("Subject");
+        /**
+         * Subject identifier.
+         * This identifier is not limited to table entity primary columns.
+         * This can be entity id or ids as well as some unique entity properties, like name or title.
+         * Insert / Update / Remove operation will be executed by a given identifier.
+         */
+        this.identifier = undefined;
+        /**
+         * Copy of entity but with relational ids fulfilled.
+         */
+        this.entityWithFulfilledIds = undefined;
+        /**
+         * Indicates if database entity was loaded.
+         * No matter if it was found or not, it indicates the fact of loading.
+         */
+        this.databaseEntityLoaded = false;
+        /**
+         * Changes needs to be applied in the database for the given subject.
+         */
+        this.changeMaps = [];
+        /**
+         * Indicates if this subject can be inserted into the database.
+         * This means that this subject either is newly persisted, either can be inserted by cascades.
+         */
+        this.canBeInserted = false;
+        /**
+         * Indicates if this subject can be updated in the database.
+         * This means that this subject either was persisted, either can be updated by cascades.
+         */
+        this.canBeUpdated = false;
+        /**
+         * Indicates if this subject MUST be removed from the database.
+         * This means that this subject either was removed, either was removed by cascades.
+         */
+        this.mustBeRemoved = false;
+        /**
+         * Indicates if this subject can be soft-removed from the database.
+         * This means that this subject either was soft-removed, either was soft-removed by cascades.
+         */
+        this.canBeSoftRemoved = false;
+        /**
+         * Indicates if this subject can be recovered from the database.
+         * This means that this subject either was recovered, either was recovered by cascades.
+         */
+        this.canBeRecovered = false;
+        /**
+         * Relations updated by the change maps.
+         */
+        this.updatedRelationMaps = [];
+        /**
+         * List of updated columns
+         */
+        this.diffColumns = [];
+        /**
+         * List of updated relations
+         */
+        this.diffRelations = [];
+        this.metadata = options.metadata;
+        this.entity = options.entity;
+        this.parentSubject = options.parentSubject;
+        if (options.canBeInserted !== undefined)
+            this.canBeInserted = options.canBeInserted;
+        if (options.canBeUpdated !== undefined)
+            this.canBeUpdated = options.canBeUpdated;
+        if (options.mustBeRemoved !== undefined)
+            this.mustBeRemoved = options.mustBeRemoved;
+        if (options.canBeSoftRemoved !== undefined)
+            this.canBeSoftRemoved = options.canBeSoftRemoved;
+        if (options.canBeRecovered !== undefined)
+            this.canBeRecovered = options.canBeRecovered;
+        if (options.identifier !== undefined)
+            this.identifier = options.identifier;
+        if (options.changeMaps !== undefined)
+            this.changeMaps.push(...options.changeMaps);
+        this.recompute();
+    }
+    // -------------------------------------------------------------------------
+    // Accessors
+    // -------------------------------------------------------------------------
+    /**
+     * Checks if this subject must be inserted into the database.
+     * Subject can be inserted into the database if it is allowed to be inserted (explicitly persisted or by cascades)
+     * and if it does not have database entity set.
+     */
+    get mustBeInserted() {
+        return this.canBeInserted && !this.databaseEntity;
+    }
+    /**
+     * Checks if this subject must be updated into the database.
+     * Subject can be updated in the database if it is allowed to be updated (explicitly persisted or by cascades)
+     * and if it does have differentiated columns or relations.
+     */
+    get mustBeUpdated() {
+        return (this.canBeUpdated &&
+            this.identifier &&
+            (this.databaseEntityLoaded === false ||
+                (this.databaseEntityLoaded && this.databaseEntity)) &&
+            // ((this.entity && this.databaseEntity) || (!this.entity && !this.databaseEntity)) &&
+            // ensure there are one or more changes for updatable columns
+            this.changeMaps.some((change) => !change.column || change.column.isUpdate));
+    }
+    /**
+     * Checks if this subject must be soft-removed into the database.
+     * Subject can be updated in the database if it is allowed to be soft-removed (explicitly persisted or by cascades)
+     * and if it does have differentiated columns or relations.
+     */
+    get mustBeSoftRemoved() {
+        return (this.canBeSoftRemoved &&
+            this.identifier &&
+            (this.databaseEntityLoaded === false ||
+                (this.databaseEntityLoaded && this.databaseEntity)));
+    }
+    /**
+     * Checks if this subject must be recovered into the database.
+     * Subject can be updated in the database if it is allowed to be recovered (explicitly persisted or by cascades)
+     * and if it does have differentiated columns or relations.
+     */
+    get mustBeRecovered() {
+        return (this.canBeRecovered &&
+            this.identifier &&
+            (this.databaseEntityLoaded === false ||
+                (this.databaseEntityLoaded && this.databaseEntity)));
+    }
+    // -------------------------------------------------------------------------
+    // Public Methods
+    // -------------------------------------------------------------------------
+    /**
+     * Creates a value set needs to be inserted / updated in the database.
+     * Value set is based on the entity and change maps of the subject.
+     * Important note: this method pops data from this subject's change maps.
+     */
+    createValueSetAndPopChangeMap() {
+        const changeMapsWithoutValues = [];
+        const changeSet = this.changeMaps.reduce((updateMap, changeMap) => {
+            let value = changeMap.value;
+            if (InstanceChecker_1.InstanceChecker.isSubject(value)) {
+                // referenced columns can refer on values both which were just inserted and which were present in the model
+                // if entity was just inserted valueSets must contain all values from the entity and values just inserted in the database
+                // so, here we check if we have a value set then we simply use it as value to get our reference column values
+                // otherwise simply use an entity which cannot be just inserted at the moment and have all necessary data
+                value = value.insertedValueSet ?? value.entity;
+            }
+            // value = changeMap.valueFactory ? changeMap.valueFactory(value) : changeMap.column.createValueMap(value);
+            let valueMap;
+            if (this.metadata.isJunction && changeMap.column) {
+                valueMap = changeMap.column.createValueMap(changeMap.column.referencedColumn.getEntityValue(value));
+            }
+            else if (changeMap.column) {
+                valueMap = changeMap.column.createValueMap(value);
+            }
+            else if (changeMap.relation) {
+                // value can be a related object, for example: post.question = { id: 1 }
+                // or value can be a null or direct relation id, e.g. post.question = 1
+                // if its a direction relation id then we just set it to the valueMap,
+                // however if its an object then we need to extract its relation id map and set it to the valueMap
+                if (ObjectUtils_1.ObjectUtils.isObject(value) && !(0, Uint8ArrayUtils_1.isUint8Array)(value)) {
+                    // get relation id, e.g. referenced column name and its value,
+                    // for example: { id: 1 } which then will be set to relation, e.g. post.category = { id: 1 }
+                    const relationId = changeMap.relation.getRelationIdMap(value);
+                    // but relation id can be empty, for example in the case when you insert a new post with category
+                    // and both post and category are newly inserted objects (by cascades) and in this case category will not have id
+                    // this means we need to insert post without question id and update post's questionId once question be inserted
+                    // that's why we create a new changeMap operation for future updation of the post entity
+                    if (relationId === undefined) {
+                        changeMapsWithoutValues.push(changeMap);
+                        this.canBeUpdated = true;
+                        return updateMap;
+                    }
+                    valueMap = changeMap.relation.createValueMap(relationId);
+                    this.updatedRelationMaps.push({
+                        relation: changeMap.relation,
+                        value: relationId,
+                    });
+                }
+                else {
+                    // value can be "null" or direct relation id here
+                    valueMap = changeMap.relation.createValueMap(value);
+                    this.updatedRelationMaps.push({
+                        relation: changeMap.relation,
+                        value: value,
+                    });
+                }
+            }
+            OrmUtils_1.OrmUtils.mergeDeep(updateMap, valueMap);
+            return updateMap;
+        }, {});
+        this.changeMaps = changeMapsWithoutValues;
+        return changeSet;
+    }
+    /**
+     * Recomputes entityWithFulfilledIds and identifier when entity changes.
+     */
+    recompute() {
+        if (this.entity) {
+            this.entityWithFulfilledIds = Object.assign({}, this.entity);
+            if (this.parentSubject) {
+                this.metadata.primaryColumns.forEach((primaryColumn) => {
+                    if (primaryColumn.relationMetadata
+                        ?.inverseEntityMetadata ===
+                        this.parentSubject.metadata) {
+                        const value = primaryColumn.referencedColumn.getEntityValue(this.parentSubject.entity);
+                        primaryColumn.setEntityValue(this.entityWithFulfilledIds, value);
+                    }
+                });
+            }
+            this.identifier = this.metadata.getEntityIdMap(this.entityWithFulfilledIds);
+        }
+        else if (this.databaseEntity) {
+            this.identifier = this.metadata.getEntityIdMap(this.databaseEntity);
+        }
+    }
+}
+exports.Subject = Subject;
+//# sourceMappingURL=Subject.js.map

package/dist/vendor/typeorm/persistence/Subject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Subject.js","sourceRoot":"","sources":["../../../../vendor/typeorm/persistence/Subject.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ObjectLiteral } from \"../common/ObjectLiteral\"\nimport type { EntityMetadata } from \"../metadata/EntityMetadata\"\nimport type { SubjectChangeMap } from \"./SubjectChangeMap\"\nimport { OrmUtils } from \"../util/OrmUtils\"\nimport type { RelationMetadata } from \"../metadata/RelationMetadata\"\nimport type { ColumnMetadata } from \"../metadata/ColumnMetadata\"\nimport { ObjectUtils } from \"../util/ObjectUtils\"\nimport { InstanceChecker } from \"../util/InstanceChecker\"\nimport { isUint8Array } from \"../util/Uint8ArrayUtils\"\n\n/**\n * Subject is a subject of persistence.\n * It holds information about each entity that needs to be persisted:\n * - what entity should be persisted\n * - what is database representation of the persisted entity\n * - what entity metadata of the persisted entity\n * - what is allowed to with persisted entity (insert/update/remove)\n *\n * Having this collection of subjects we can perform database queries.\n */\nexport class Subject {\n    readonly \"@instanceof\" = Symbol.for(\"Subject\")\n\n    // -------------------------------------------------------------------------\n    // Properties\n    // -------------------------------------------------------------------------\n\n    /**\n     * Entity metadata of the subject entity.\n     */\n    metadata: EntityMetadata\n\n    /**\n     * Subject identifier.\n     * This identifier is not limited to table entity primary columns.\n     * This can be entity id or ids as well as some unique entity properties, like name or title.\n     * Insert / Update / Remove operation will be executed by a given identifier.\n     */\n    identifier: ObjectLiteral | undefined = undefined\n\n    /**\n     * Copy of entity but with relational ids fulfilled.\n     */\n    entityWithFulfilledIds: ObjectLiteral | undefined = undefined\n\n    /**\n     * If subject was created by cascades this property will contain subject\n     * from where this subject was created.\n     */\n    parentSubject?: Subject\n\n    /**\n     * Gets entity sent to the persistence (e.g. changed entity).\n     * If entity is not set then this subject is created only for the entity loaded from the database,\n     * or this subject is used for the junction operation (junction operations are relying only on identifier).\n     */\n    entity?: ObjectLiteral\n\n    /**\n     * Database entity.\n     * THIS IS NOT RAW ENTITY DATA, its a real entity.\n     */\n    databaseEntity?: ObjectLiteral\n\n    /**\n     * Indicates if database entity was loaded.\n     * No matter if it was found or not, it indicates the fact of loading.\n     */\n    databaseEntityLoaded: boolean = false\n\n    /**\n     * Changes needs to be applied in the database for the given subject.\n     */\n    changeMaps: SubjectChangeMap[] = []\n\n    /**\n     * Generated values returned by a database (for example generated id or default values).\n     * Used in insert and update operations.\n     * Has entity-like structure (not just column database name and values).\n     */\n    generatedMap?: ObjectLiteral\n\n    /**\n     * Inserted values with updated values of special and default columns.\n     * Has entity-like structure (not just column database name and values).\n     */\n    insertedValueSet?: ObjectLiteral\n\n    /**\n     * Indicates if this subject can be inserted into the database.\n     * This means that this subject either is newly persisted, either can be inserted by cascades.\n     */\n    canBeInserted: boolean = false\n\n    /**\n     * Indicates if this subject can be updated in the database.\n     * This means that this subject either was persisted, either can be updated by cascades.\n     */\n    canBeUpdated: boolean = false\n\n    /**\n     * Indicates if this subject MUST be removed from the database.\n     * This means that this subject either was removed, either was removed by cascades.\n     */\n    mustBeRemoved: boolean = false\n\n    /**\n     * Indicates if this subject can be soft-removed from the database.\n     * This means that this subject either was soft-removed, either was soft-removed by cascades.\n     */\n    canBeSoftRemoved: boolean = false\n\n    /**\n     * Indicates if this subject can be recovered from the database.\n     * This means that this subject either was recovered, either was recovered by cascades.\n     */\n    canBeRecovered: boolean = false\n\n    /**\n     * Relations updated by the change maps.\n     */\n    updatedRelationMaps: {\n        relation: RelationMetadata\n        value: ObjectLiteral\n    }[] = []\n\n    /**\n     * List of updated columns\n     */\n    diffColumns: ColumnMetadata[] = []\n\n    /**\n     * List of updated relations\n     */\n    diffRelations: RelationMetadata[] = []\n\n    // -------------------------------------------------------------------------\n    // Constructor\n    // -------------------------------------------------------------------------\n\n    constructor(options: {\n        metadata: EntityMetadata\n        parentSubject?: Subject\n        entity?: ObjectLiteral\n        canBeInserted?: boolean\n        canBeUpdated?: boolean\n        mustBeRemoved?: boolean\n        canBeSoftRemoved?: boolean\n        canBeRecovered?: boolean\n        identifier?: ObjectLiteral\n        changeMaps?: SubjectChangeMap[]\n    }) {\n        this.metadata = options.metadata\n        this.entity = options.entity\n        this.parentSubject = options.parentSubject\n        if (options.canBeInserted !== undefined)\n            this.canBeInserted = options.canBeInserted\n        if (options.canBeUpdated !== undefined)\n            this.canBeUpdated = options.canBeUpdated\n        if (options.mustBeRemoved !== undefined)\n            this.mustBeRemoved = options.mustBeRemoved\n        if (options.canBeSoftRemoved !== undefined)\n            this.canBeSoftRemoved = options.canBeSoftRemoved\n        if (options.canBeRecovered !== undefined)\n            this.canBeRecovered = options.canBeRecovered\n        if (options.identifier !== undefined)\n            this.identifier = options.identifier\n        if (options.changeMaps !== undefined)\n            this.changeMaps.push(...options.changeMaps)\n\n        this.recompute()\n    }\n\n    // -------------------------------------------------------------------------\n    // Accessors\n    // -------------------------------------------------------------------------\n\n    /**\n     * Checks if this subject must be inserted into the database.\n     * Subject can be inserted into the database if it is allowed to be inserted (explicitly persisted or by cascades)\n     * and if it does not have database entity set.\n     */\n    get mustBeInserted() {\n        return this.canBeInserted && !this.databaseEntity\n    }\n\n    /**\n     * Checks if this subject must be updated into the database.\n     * Subject can be updated in the database if it is allowed to be updated (explicitly persisted or by cascades)\n     * and if it does have differentiated columns or relations.\n     */\n    get mustBeUpdated() {\n        return (\n            this.canBeUpdated &&\n            this.identifier &&\n            (this.databaseEntityLoaded === false ||\n                (this.databaseEntityLoaded && this.databaseEntity)) &&\n            // ((this.entity && this.databaseEntity) || (!this.entity && !this.databaseEntity)) &&\n            // ensure there are one or more changes for updatable columns\n            this.changeMaps.some(\n                (change) => !change.column || change.column.isUpdate,\n            )\n        )\n    }\n\n    /**\n     * Checks if this subject must be soft-removed into the database.\n     * Subject can be updated in the database if it is allowed to be soft-removed (explicitly persisted or by cascades)\n     * and if it does have differentiated columns or relations.\n     */\n    get mustBeSoftRemoved() {\n        return (\n            this.canBeSoftRemoved &&\n            this.identifier &&\n            (this.databaseEntityLoaded === false ||\n                (this.databaseEntityLoaded && this.databaseEntity))\n        )\n    }\n\n    /**\n     * Checks if this subject must be recovered into the database.\n     * Subject can be updated in the database if it is allowed to be recovered (explicitly persisted or by cascades)\n     * and if it does have differentiated columns or relations.\n     */\n    get mustBeRecovered() {\n        return (\n            this.canBeRecovered &&\n            this.identifier &&\n            (this.databaseEntityLoaded === false ||\n                (this.databaseEntityLoaded && this.databaseEntity))\n        )\n    }\n\n    // -------------------------------------------------------------------------\n    // Public Methods\n    // -------------------------------------------------------------------------\n\n    /**\n     * Creates a value set needs to be inserted / updated in the database.\n     * Value set is based on the entity and change maps of the subject.\n     * Important note: this method pops data from this subject's change maps.\n     */\n    createValueSetAndPopChangeMap(): ObjectLiteral {\n        const changeMapsWithoutValues: SubjectChangeMap[] = []\n        const changeSet = this.changeMaps.reduce((updateMap, changeMap) => {\n            let value = changeMap.value\n            if (InstanceChecker.isSubject(value)) {\n                // referenced columns can refer on values both which were just inserted and which were present in the model\n                // if entity was just inserted valueSets must contain all values from the entity and values just inserted in the database\n                // so, here we check if we have a value set then we simply use it as value to get our reference column values\n                // otherwise simply use an entity which cannot be just inserted at the moment and have all necessary data\n                value = value.insertedValueSet ?? value.entity\n            }\n            // value = changeMap.valueFactory ? changeMap.valueFactory(value) : changeMap.column.createValueMap(value);\n\n            let valueMap: ObjectLiteral | undefined\n            if (this.metadata.isJunction && changeMap.column) {\n                valueMap = changeMap.column.createValueMap(\n                    changeMap.column.referencedColumn!.getEntityValue(value),\n                )\n            } else if (changeMap.column) {\n                valueMap = changeMap.column.createValueMap(value)\n            } else if (changeMap.relation) {\n                // value can be a related object, for example: post.question = { id: 1 }\n                // or value can be a null or direct relation id, e.g. post.question = 1\n                // if its a direction relation id then we just set it to the valueMap,\n                // however if its an object then we need to extract its relation id map and set it to the valueMap\n                if (ObjectUtils.isObject(value) && !isUint8Array(value)) {\n                    // get relation id, e.g. referenced column name and its value,\n                    // for example: { id: 1 } which then will be set to relation, e.g. post.category = { id: 1 }\n                    const relationId =\n                        changeMap.relation!.getRelationIdMap(value)\n\n                    // but relation id can be empty, for example in the case when you insert a new post with category\n                    // and both post and category are newly inserted objects (by cascades) and in this case category will not have id\n                    // this means we need to insert post without question id and update post's questionId once question be inserted\n                    // that's why we create a new changeMap operation for future updation of the post entity\n                    if (relationId === undefined) {\n                        changeMapsWithoutValues.push(changeMap)\n                        this.canBeUpdated = true\n                        return updateMap\n                    }\n                    valueMap = changeMap.relation!.createValueMap(relationId)\n                    this.updatedRelationMaps.push({\n                        relation: changeMap.relation,\n                        value: relationId,\n                    })\n                } else {\n                    // value can be \"null\" or direct relation id here\n                    valueMap = changeMap.relation!.createValueMap(value)\n                    this.updatedRelationMaps.push({\n                        relation: changeMap.relation,\n                        value: value,\n                    })\n                }\n            }\n\n            OrmUtils.mergeDeep(updateMap, valueMap)\n            return updateMap\n        }, {} as ObjectLiteral)\n        this.changeMaps = changeMapsWithoutValues\n        return changeSet\n    }\n\n    /**\n     * Recomputes entityWithFulfilledIds and identifier when entity changes.\n     */\n    recompute(): void {\n        if (this.entity) {\n            this.entityWithFulfilledIds = Object.assign({}, this.entity)\n            if (this.parentSubject) {\n                this.metadata.primaryColumns.forEach((primaryColumn) => {\n                    if (\n                        primaryColumn.relationMetadata\n                            ?.inverseEntityMetadata ===\n                        this.parentSubject!.metadata\n                    ) {\n                        const value =\n                            primaryColumn.referencedColumn!.getEntityValue(\n                                this.parentSubject!.entity!,\n                            )\n                        primaryColumn.setEntityValue(\n                            this.entityWithFulfilledIds!,\n                            value,\n                        )\n                    }\n                })\n            }\n            this.identifier = this.metadata.getEntityIdMap(\n                this.entityWithFulfilledIds,\n            )\n        } else if (this.databaseEntity) {\n            this.identifier = this.metadata.getEntityIdMap(this.databaseEntity)\n        }\n    }\n}\n"]}