@depup/typeorm 0.3.28-depup.0

package/util/DirectoryExportedClassesLoader.d.ts

@@ -0,0 +1,9 @@
+import { Logger } from "../logger/Logger";
+/**
+ * Loads all exported classes from the given directory.
+ */
+export declare function importClassesFromDirectories(logger: Logger, directories: string[], formats?: string[]): Promise<Function[]>;
+/**
+ * Loads all json files from the given directory.
+ */
+export declare function importJsonsFromDirectories(directories: string[], format?: string): any[];

package/util/DirectoryExportedClassesLoader.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.importClassesFromDirectories = importClassesFromDirectories;
+exports.importJsonsFromDirectories = importJsonsFromDirectories;
+const tslib_1 = require("tslib");
+const glob = tslib_1.__importStar(require("glob"));
+const PlatformTools_1 = require("../platform/PlatformTools");
+const ImportUtils_1 = require("./ImportUtils");
+const ObjectUtils_1 = require("./ObjectUtils");
+const InstanceChecker_1 = require("./InstanceChecker");
+/**
+ * Loads all exported classes from the given directory.
+ */
+async function importClassesFromDirectories(logger, directories, formats = [".js", ".mjs", ".cjs", ".ts", ".mts", ".cts"]) {
+    const logLevel = "info";
+    const classesNotFoundMessage = "No classes were found using the provided glob pattern: ";
+    const classesFoundMessage = "All classes found using provided glob pattern";
+    function loadFileClasses(exported, allLoaded) {
+        if (typeof exported === "function" ||
+            InstanceChecker_1.InstanceChecker.isEntitySchema(exported)) {
+            allLoaded.push(exported);
+        }
+        else if (Array.isArray(exported)) {
+            exported.forEach((value) => loadFileClasses(value, allLoaded));
+        }
+        else if (ObjectUtils_1.ObjectUtils.isObject(exported)) {
+            Object.values(exported).forEach((value) => loadFileClasses(value, allLoaded));
+        }
+        return allLoaded;
+    }
+    const allFiles = directories.reduce((allDirs, dir) => {
+        return allDirs.concat(glob.sync(PlatformTools_1.PlatformTools.pathNormalize(dir)));
+    }, []);
+    if (directories.length > 0 && allFiles.length === 0) {
+        logger.log(logLevel, `${classesNotFoundMessage} "${directories}"`);
+    }
+    else if (allFiles.length > 0) {
+        logger.log(logLevel, `${classesFoundMessage} "${directories}" : "${allFiles}"`);
+    }
+    const dirPromises = allFiles
+        .filter((file) => {
+        const dtsExtension = file.substring(file.length - 5, file.length);
+        return (formats.indexOf(PlatformTools_1.PlatformTools.pathExtname(file)) !== -1 &&
+            dtsExtension !== ".d.ts");
+    })
+        .map(async (file) => {
+        const [importOrRequireResult] = await (0, ImportUtils_1.importOrRequireFile)(PlatformTools_1.PlatformTools.pathResolve(file));
+        return importOrRequireResult;
+    });
+    const dirs = await Promise.all(dirPromises);
+    return loadFileClasses(dirs, []);
+}
+/**
+ * Loads all json files from the given directory.
+ */
+function importJsonsFromDirectories(directories, format = ".json") {
+    const allFiles = directories.reduce((allDirs, dir) => {
+        return allDirs.concat(glob.sync(PlatformTools_1.PlatformTools.pathNormalize(dir)));
+    }, []);
+    return allFiles
+        .filter((file) => PlatformTools_1.PlatformTools.pathExtname(file) === format)
+        .map((file) => require(PlatformTools_1.PlatformTools.pathResolve(file)));
+}
+
+//# sourceMappingURL=DirectoryExportedClassesLoader.js.map

package/util/DirectoryExportedClassesLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/util/DirectoryExportedClassesLoader.ts"],"names":[],"mappings":"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","file":"DirectoryExportedClassesLoader.js","sourcesContent":["import * as glob from \"glob\"\nimport { PlatformTools } from \"../platform/PlatformTools\"\nimport { Logger } from \"../logger/Logger\"\nimport { importOrRequireFile } from \"./ImportUtils\"\nimport { ObjectUtils } from \"./ObjectUtils\"\nimport { InstanceChecker } from \"./InstanceChecker\"\n\n/**\n * Loads all exported classes from the given directory.\n */\nexport async function importClassesFromDirectories(\n    logger: Logger,\n    directories: string[],\n    formats = [\".js\", \".mjs\", \".cjs\", \".ts\", \".mts\", \".cts\"],\n): Promise<Function[]> {\n    const logLevel = \"info\"\n    const classesNotFoundMessage =\n        \"No classes were found using the provided glob pattern: \"\n    const classesFoundMessage = \"All classes found using provided glob pattern\"\n    function loadFileClasses(exported: any, allLoaded: Function[]) {\n        if (\n            typeof exported === \"function\" ||\n            InstanceChecker.isEntitySchema(exported)\n        ) {\n            allLoaded.push(exported)\n        } else if (Array.isArray(exported)) {\n            exported.forEach((value) => loadFileClasses(value, allLoaded))\n        } else if (ObjectUtils.isObject(exported)) {\n            Object.values(exported).forEach((value) =>\n                loadFileClasses(value, allLoaded),\n            )\n        }\n        return allLoaded\n    }\n\n    const allFiles = directories.reduce((allDirs, dir) => {\n        return allDirs.concat(glob.sync(PlatformTools.pathNormalize(dir)))\n    }, [] as string[])\n\n    if (directories.length > 0 && allFiles.length === 0) {\n        logger.log(logLevel, `${classesNotFoundMessage} \"${directories}\"`)\n    } else if (allFiles.length > 0) {\n        logger.log(\n            logLevel,\n            `${classesFoundMessage} \"${directories}\" : \"${allFiles}\"`,\n        )\n    }\n    const dirPromises = allFiles\n        .filter((file) => {\n            const dtsExtension = file.substring(file.length - 5, file.length)\n            return (\n                formats.indexOf(PlatformTools.pathExtname(file)) !== -1 &&\n                dtsExtension !== \".d.ts\"\n            )\n        })\n        .map(async (file) => {\n            const [importOrRequireResult] = await importOrRequireFile(\n                PlatformTools.pathResolve(file),\n            )\n            return importOrRequireResult\n        })\n\n    const dirs = await Promise.all(dirPromises)\n\n    return loadFileClasses(dirs, [])\n}\n\n/**\n * Loads all json files from the given directory.\n */\nexport function importJsonsFromDirectories(\n    directories: string[],\n    format = \".json\",\n): any[] {\n    const allFiles = directories.reduce((allDirs, dir) => {\n        return allDirs.concat(glob.sync(PlatformTools.pathNormalize(dir)))\n    }, [] as string[])\n\n    return allFiles\n        .filter((file) => PlatformTools.pathExtname(file) === format)\n        .map((file) => require(PlatformTools.pathResolve(file)))\n}\n"],"sourceRoot":".."}

package/util/ImportUtils.d.ts

@@ -0,0 +1 @@
+export declare function importOrRequireFile(filePath: string): Promise<[any, "esm" | "commonjs"]>;

package/util/ImportUtils.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.importOrRequireFile = importOrRequireFile;
+const tslib_1 = require("tslib");
+const promises_1 = tslib_1.__importDefault(require("fs/promises"));
+const path_1 = tslib_1.__importDefault(require("path"));
+const url_1 = require("url");
+async function importOrRequireFile(filePath) {
+    const tryToImport = async () => {
+        // `Function` is required to make sure the `import` statement wil stay `import` after
+        // transpilation and won't be converted to `require`
+        return [
+            // eslint-disable-next-line @typescript-eslint/no-implied-eval
+            await Function("return filePath => import(filePath)")()(filePath.startsWith("file://")
+                ? filePath
+                : (0, url_1.pathToFileURL)(filePath).toString()),
+            "esm",
+        ];
+    };
+    const tryToRequire = () => {
+        return [require(filePath), "commonjs"];
+    };
+    const extension = filePath.substring(filePath.lastIndexOf(".") + ".".length);
+    if (extension === "mjs" || extension === "mts")
+        return tryToImport();
+    else if (extension === "cjs" || extension === "cts")
+        return tryToRequire();
+    else if (extension === "js" || extension === "ts") {
+        const packageJson = await getNearestPackageJson(filePath);
+        if (packageJson != null) {
+            const isModule = packageJson?.type === "module";
+            if (isModule)
+                return tryToImport();
+            else
+                return tryToRequire();
+        }
+        else
+            return tryToRequire();
+    }
+    return tryToRequire();
+}
+const packageJsonCache = new Map();
+const MAX_CACHE_SIZE = 1000;
+function setPackageJsonCache(paths, packageJson) {
+    for (const path of paths) {
+        // Simple LRU-like behavior: if we're at capacity, remove oldest entry
+        if (packageJsonCache.size >= MAX_CACHE_SIZE &&
+            !packageJsonCache.has(path)) {
+            const firstKey = packageJsonCache.keys().next().value;
+            if (firstKey)
+                packageJsonCache.delete(firstKey);
+        }
+        packageJsonCache.set(path, packageJson);
+    }
+}
+async function getNearestPackageJson(filePath) {
+    let currentPath = filePath;
+    const paths = [];
+    while (currentPath !== path_1.default.dirname(currentPath)) {
+        currentPath = path_1.default.dirname(currentPath);
+        // Check if we have already cached the package.json for this path
+        if (packageJsonCache.has(currentPath)) {
+            setPackageJsonCache(paths, packageJsonCache.get(currentPath));
+            return packageJsonCache.get(currentPath);
+        }
+        // Add the current path to the list of paths to cache
+        paths.push(currentPath);
+        const potentialPackageJson = path_1.default.join(currentPath, "package.json");
+        try {
+            const stats = await promises_1.default.stat(potentialPackageJson);
+            if (!stats.isFile()) {
+                continue;
+            }
+            try {
+                const parsedPackage = JSON.parse(await promises_1.default.readFile(potentialPackageJson, "utf8"));
+                // Cache the parsed package.json object and return it
+                setPackageJsonCache(paths, parsedPackage);
+                return parsedPackage;
+            }
+            catch {
+                // If parsing fails, we still cache null to avoid repeated attempts
+                setPackageJsonCache(paths, null);
+                return null;
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    // the top of the file tree is reached
+    setPackageJsonCache(paths, null);
+    return null;
+}
+
+//# sourceMappingURL=ImportUtils.js.map

package/util/ImportUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/util/ImportUtils.ts"],"names":[],"mappings":"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","file":"ImportUtils.js","sourcesContent":["import fs from \"fs/promises\"\nimport path from \"path\"\nimport { pathToFileURL } from \"url\"\n\nexport async function importOrRequireFile(\n    filePath: string,\n): Promise<[any, \"esm\" | \"commonjs\"]> {\n    const tryToImport = async (): Promise<[any, \"esm\"]> => {\n        // `Function` is required to make sure the `import` statement wil stay `import` after\n        // transpilation and won't be converted to `require`\n        return [\n            // eslint-disable-next-line @typescript-eslint/no-implied-eval\n            await Function(\"return filePath => import(filePath)\")()(\n                filePath.startsWith(\"file://\")\n                    ? filePath\n                    : pathToFileURL(filePath).toString(),\n            ),\n            \"esm\",\n        ]\n    }\n    const tryToRequire = (): [any, \"commonjs\"] => {\n        return [require(filePath), \"commonjs\"]\n    }\n\n    const extension = filePath.substring(filePath.lastIndexOf(\".\") + \".\".length)\n\n    if (extension === \"mjs\" || extension === \"mts\") return tryToImport()\n    else if (extension === \"cjs\" || extension === \"cts\") return tryToRequire()\n    else if (extension === \"js\" || extension === \"ts\") {\n        const packageJson = await getNearestPackageJson(filePath)\n\n        if (packageJson != null) {\n            const isModule = (packageJson as any)?.type === \"module\"\n\n            if (isModule) return tryToImport()\n            else return tryToRequire()\n        } else return tryToRequire()\n    }\n\n    return tryToRequire()\n}\n\nconst packageJsonCache = new Map<string, object | null>()\nconst MAX_CACHE_SIZE = 1000\n\nfunction setPackageJsonCache(paths: string[], packageJson: object | null) {\n    for (const path of paths) {\n        // Simple LRU-like behavior: if we're at capacity, remove oldest entry\n        if (\n            packageJsonCache.size >= MAX_CACHE_SIZE &&\n            !packageJsonCache.has(path)\n        ) {\n            const firstKey = packageJsonCache.keys().next().value\n            if (firstKey) packageJsonCache.delete(firstKey)\n        }\n        packageJsonCache.set(path, packageJson)\n    }\n}\n\nasync function getNearestPackageJson(filePath: string): Promise<object | null> {\n    let currentPath = filePath\n    const paths: string[] = []\n\n    while (currentPath !== path.dirname(currentPath)) {\n        currentPath = path.dirname(currentPath)\n\n        // Check if we have already cached the package.json for this path\n        if (packageJsonCache.has(currentPath)) {\n            setPackageJsonCache(paths, packageJsonCache.get(currentPath)!)\n            return packageJsonCache.get(currentPath)!\n        }\n\n        // Add the current path to the list of paths to cache\n        paths.push(currentPath)\n\n        const potentialPackageJson = path.join(currentPath, \"package.json\")\n\n        try {\n            const stats = await fs.stat(potentialPackageJson)\n            if (!stats.isFile()) {\n                continue\n            }\n\n            try {\n                const parsedPackage = JSON.parse(\n                    await fs.readFile(potentialPackageJson, \"utf8\"),\n                )\n                // Cache the parsed package.json object and return it\n                setPackageJsonCache(paths, parsedPackage)\n                return parsedPackage\n            } catch {\n                // If parsing fails, we still cache null to avoid repeated attempts\n                setPackageJsonCache(paths, null)\n                return null\n            }\n        } catch {\n            continue\n        }\n    }\n\n    // the top of the file tree is reached\n    setPackageJsonCache(paths, null)\n    return null\n}\n"],"sourceRoot":".."}

package/util/InstanceChecker.d.ts

@@ -0,0 +1,61 @@
+import type { MongoEntityManager } from "../entity-manager/MongoEntityManager";
+import type { SqljsEntityManager } from "../entity-manager/SqljsEntityManager";
+import type { EntitySchema } from "../entity-schema/EntitySchema";
+import type { FindOperator } from "../find-options/FindOperator";
+import type { EqualOperator } from "../find-options/EqualOperator";
+import type { Query } from "../driver/Query";
+import type { RdbmsSchemaBuilder } from "../schema-builder/RdbmsSchemaBuilder";
+import type { Subject } from "../persistence/Subject";
+import type { SelectQueryBuilder } from "../query-builder/SelectQueryBuilder";
+import type { UpdateQueryBuilder } from "../query-builder/UpdateQueryBuilder";
+import type { DeleteQueryBuilder } from "../query-builder/DeleteQueryBuilder";
+import type { SoftDeleteQueryBuilder } from "../query-builder/SoftDeleteQueryBuilder";
+import type { InsertQueryBuilder } from "../query-builder/InsertQueryBuilder";
+import type { RelationQueryBuilder } from "../query-builder/RelationQueryBuilder";
+import type { Brackets } from "../query-builder/Brackets";
+import type { Table } from "../schema-builder/table/Table";
+import type { TableCheck } from "../schema-builder/table/TableCheck";
+import type { TableColumn } from "../schema-builder/table/TableColumn";
+import type { TableExclusion } from "../schema-builder/table/TableExclusion";
+import type { TableForeignKey } from "../schema-builder/table/TableForeignKey";
+import type { TableIndex } from "../schema-builder/table/TableIndex";
+import type { TableUnique } from "../schema-builder/table/TableUnique";
+import type { View } from "../schema-builder/view/View";
+import type { NotBrackets } from "../query-builder/NotBrackets";
+import type { EntityMetadata } from "../metadata/EntityMetadata";
+import type { ColumnMetadata } from "../metadata/ColumnMetadata";
+import type { MssqlParameter } from "../driver/sqlserver/MssqlParameter";
+import { DataSource } from "../data-source";
+import { BaseEntity } from "../repository/BaseEntity";
+export declare class InstanceChecker {
+    static isMssqlParameter(obj: unknown): obj is MssqlParameter;
+    static isEntityMetadata(obj: unknown): obj is EntityMetadata;
+    static isColumnMetadata(obj: unknown): obj is ColumnMetadata;
+    static isSelectQueryBuilder(obj: unknown): obj is SelectQueryBuilder<any>;
+    static isInsertQueryBuilder(obj: unknown): obj is InsertQueryBuilder<any>;
+    static isDeleteQueryBuilder(obj: unknown): obj is DeleteQueryBuilder<any>;
+    static isUpdateQueryBuilder(obj: unknown): obj is UpdateQueryBuilder<any>;
+    static isSoftDeleteQueryBuilder(obj: unknown): obj is SoftDeleteQueryBuilder<any>;
+    static isRelationQueryBuilder(obj: unknown): obj is RelationQueryBuilder<any>;
+    static isBrackets(obj: unknown): obj is Brackets;
+    static isNotBrackets(obj: unknown): obj is NotBrackets;
+    static isSubject(obj: unknown): obj is Subject;
+    static isRdbmsSchemaBuilder(obj: unknown): obj is RdbmsSchemaBuilder;
+    static isMongoEntityManager(obj: unknown): obj is MongoEntityManager;
+    static isSqljsEntityManager(obj: unknown): obj is SqljsEntityManager;
+    static isEntitySchema(obj: unknown): obj is EntitySchema;
+    static isBaseEntityConstructor(obj: unknown): obj is typeof BaseEntity;
+    static isFindOperator(obj: unknown): obj is FindOperator<any>;
+    static isEqualOperator(obj: unknown): obj is EqualOperator<any>;
+    static isQuery(obj: unknown): obj is Query;
+    static isTable(obj: unknown): obj is Table;
+    static isTableCheck(obj: unknown): obj is TableCheck;
+    static isTableColumn(obj: unknown): obj is TableColumn;
+    static isTableExclusion(obj: unknown): obj is TableExclusion;
+    static isTableForeignKey(obj: unknown): obj is TableForeignKey;
+    static isTableIndex(obj: unknown): obj is TableIndex;
+    static isTableUnique(obj: unknown): obj is TableUnique;
+    static isView(obj: unknown): obj is View;
+    static isDataSource(obj: unknown): obj is DataSource;
+    private static check;
+}

package/util/InstanceChecker.js

@@ -0,0 +1,104 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InstanceChecker = void 0;
+class InstanceChecker {
+    static isMssqlParameter(obj) {
+        return this.check(obj, "MssqlParameter");
+    }
+    static isEntityMetadata(obj) {
+        return this.check(obj, "EntityMetadata");
+    }
+    static isColumnMetadata(obj) {
+        return this.check(obj, "ColumnMetadata");
+    }
+    static isSelectQueryBuilder(obj) {
+        return this.check(obj, "SelectQueryBuilder");
+    }
+    static isInsertQueryBuilder(obj) {
+        return this.check(obj, "InsertQueryBuilder");
+    }
+    static isDeleteQueryBuilder(obj) {
+        return this.check(obj, "DeleteQueryBuilder");
+    }
+    static isUpdateQueryBuilder(obj) {
+        return this.check(obj, "UpdateQueryBuilder");
+    }
+    static isSoftDeleteQueryBuilder(obj) {
+        return this.check(obj, "SoftDeleteQueryBuilder");
+    }
+    static isRelationQueryBuilder(obj) {
+        return this.check(obj, "RelationQueryBuilder");
+    }
+    static isBrackets(obj) {
+        return this.check(obj, "Brackets") || this.check(obj, "NotBrackets");
+    }
+    static isNotBrackets(obj) {
+        return this.check(obj, "NotBrackets");
+    }
+    static isSubject(obj) {
+        return this.check(obj, "Subject");
+    }
+    static isRdbmsSchemaBuilder(obj) {
+        return this.check(obj, "RdbmsSchemaBuilder");
+    }
+    static isMongoEntityManager(obj) {
+        return this.check(obj, "MongoEntityManager");
+    }
+    static isSqljsEntityManager(obj) {
+        return this.check(obj, "SqljsEntityManager");
+    }
+    static isEntitySchema(obj) {
+        return this.check(obj, "EntitySchema");
+    }
+    static isBaseEntityConstructor(obj) {
+        return (typeof obj === "function" &&
+            typeof obj.hasId === "function" &&
+            typeof obj.save === "function" &&
+            typeof obj.useDataSource === "function");
+    }
+    static isFindOperator(obj) {
+        return (this.check(obj, "FindOperator") || this.check(obj, "EqualOperator"));
+    }
+    static isEqualOperator(obj) {
+        return this.check(obj, "EqualOperator");
+    }
+    static isQuery(obj) {
+        return this.check(obj, "Query");
+    }
+    static isTable(obj) {
+        return this.check(obj, "Table");
+    }
+    static isTableCheck(obj) {
+        return this.check(obj, "TableCheck");
+    }
+    static isTableColumn(obj) {
+        return this.check(obj, "TableColumn");
+    }
+    static isTableExclusion(obj) {
+        return this.check(obj, "TableExclusion");
+    }
+    static isTableForeignKey(obj) {
+        return this.check(obj, "TableForeignKey");
+    }
+    static isTableIndex(obj) {
+        return this.check(obj, "TableIndex");
+    }
+    static isTableUnique(obj) {
+        return this.check(obj, "TableUnique");
+    }
+    static isView(obj) {
+        return this.check(obj, "View");
+    }
+    static isDataSource(obj) {
+        return this.check(obj, "DataSource");
+    }
+    static check(obj, name) {
+        return (typeof obj === "object" &&
+            obj !== null &&
+            obj["@instanceof"] ===
+                Symbol.for(name));
+    }
+}
+exports.InstanceChecker = InstanceChecker;
+
+//# sourceMappingURL=InstanceChecker.js.map

package/util/InstanceChecker.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/util/InstanceChecker.ts"],"names":[],"mappings":"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","file":"InstanceChecker.js","sourcesContent":["import type { MongoEntityManager } from \"../entity-manager/MongoEntityManager\"\nimport type { SqljsEntityManager } from \"../entity-manager/SqljsEntityManager\"\nimport type { EntitySchema } from \"../entity-schema/EntitySchema\"\nimport type { FindOperator } from \"../find-options/FindOperator\"\nimport type { EqualOperator } from \"../find-options/EqualOperator\"\nimport type { Query } from \"../driver/Query\"\nimport type { RdbmsSchemaBuilder } from \"../schema-builder/RdbmsSchemaBuilder\"\nimport type { Subject } from \"../persistence/Subject\"\nimport type { SelectQueryBuilder } from \"../query-builder/SelectQueryBuilder\"\nimport type { UpdateQueryBuilder } from \"../query-builder/UpdateQueryBuilder\"\nimport type { DeleteQueryBuilder } from \"../query-builder/DeleteQueryBuilder\"\nimport type { SoftDeleteQueryBuilder } from \"../query-builder/SoftDeleteQueryBuilder\"\nimport type { InsertQueryBuilder } from \"../query-builder/InsertQueryBuilder\"\nimport type { RelationQueryBuilder } from \"../query-builder/RelationQueryBuilder\"\nimport type { Brackets } from \"../query-builder/Brackets\"\nimport type { Table } from \"../schema-builder/table/Table\"\nimport type { TableCheck } from \"../schema-builder/table/TableCheck\"\nimport type { TableColumn } from \"../schema-builder/table/TableColumn\"\nimport type { TableExclusion } from \"../schema-builder/table/TableExclusion\"\nimport type { TableForeignKey } from \"../schema-builder/table/TableForeignKey\"\nimport type { TableIndex } from \"../schema-builder/table/TableIndex\"\nimport type { TableUnique } from \"../schema-builder/table/TableUnique\"\nimport type { View } from \"../schema-builder/view/View\"\nimport type { NotBrackets } from \"../query-builder/NotBrackets\"\nimport type { EntityMetadata } from \"../metadata/EntityMetadata\"\nimport type { ColumnMetadata } from \"../metadata/ColumnMetadata\"\nimport type { MssqlParameter } from \"../driver/sqlserver/MssqlParameter\"\nimport { DataSource } from \"../data-source\"\nimport { BaseEntity } from \"../repository/BaseEntity\"\n\nexport class InstanceChecker {\n    static isMssqlParameter(obj: unknown): obj is MssqlParameter {\n        return this.check(obj, \"MssqlParameter\")\n    }\n    static isEntityMetadata(obj: unknown): obj is EntityMetadata {\n        return this.check(obj, \"EntityMetadata\")\n    }\n    static isColumnMetadata(obj: unknown): obj is ColumnMetadata {\n        return this.check(obj, \"ColumnMetadata\")\n    }\n    static isSelectQueryBuilder(obj: unknown): obj is SelectQueryBuilder<any> {\n        return this.check(obj, \"SelectQueryBuilder\")\n    }\n    static isInsertQueryBuilder(obj: unknown): obj is InsertQueryBuilder<any> {\n        return this.check(obj, \"InsertQueryBuilder\")\n    }\n    static isDeleteQueryBuilder(obj: unknown): obj is DeleteQueryBuilder<any> {\n        return this.check(obj, \"DeleteQueryBuilder\")\n    }\n    static isUpdateQueryBuilder(obj: unknown): obj is UpdateQueryBuilder<any> {\n        return this.check(obj, \"UpdateQueryBuilder\")\n    }\n    static isSoftDeleteQueryBuilder(\n        obj: unknown,\n    ): obj is SoftDeleteQueryBuilder<any> {\n        return this.check(obj, \"SoftDeleteQueryBuilder\")\n    }\n    static isRelationQueryBuilder(\n        obj: unknown,\n    ): obj is RelationQueryBuilder<any> {\n        return this.check(obj, \"RelationQueryBuilder\")\n    }\n    static isBrackets(obj: unknown): obj is Brackets {\n        return this.check(obj, \"Brackets\") || this.check(obj, \"NotBrackets\")\n    }\n    static isNotBrackets(obj: unknown): obj is NotBrackets {\n        return this.check(obj, \"NotBrackets\")\n    }\n    static isSubject(obj: unknown): obj is Subject {\n        return this.check(obj, \"Subject\")\n    }\n    static isRdbmsSchemaBuilder(obj: unknown): obj is RdbmsSchemaBuilder {\n        return this.check(obj, \"RdbmsSchemaBuilder\")\n    }\n    static isMongoEntityManager(obj: unknown): obj is MongoEntityManager {\n        return this.check(obj, \"MongoEntityManager\")\n    }\n    static isSqljsEntityManager(obj: unknown): obj is SqljsEntityManager {\n        return this.check(obj, \"SqljsEntityManager\")\n    }\n    static isEntitySchema(obj: unknown): obj is EntitySchema {\n        return this.check(obj, \"EntitySchema\")\n    }\n    static isBaseEntityConstructor(obj: unknown): obj is typeof BaseEntity {\n        return (\n            typeof obj === \"function\" &&\n            typeof (obj as typeof BaseEntity).hasId === \"function\" &&\n            typeof (obj as typeof BaseEntity).save === \"function\" &&\n            typeof (obj as typeof BaseEntity).useDataSource === \"function\"\n        )\n    }\n    static isFindOperator(obj: unknown): obj is FindOperator<any> {\n        return (\n            this.check(obj, \"FindOperator\") || this.check(obj, \"EqualOperator\")\n        )\n    }\n    static isEqualOperator(obj: unknown): obj is EqualOperator<any> {\n        return this.check(obj, \"EqualOperator\")\n    }\n    static isQuery(obj: unknown): obj is Query {\n        return this.check(obj, \"Query\")\n    }\n    static isTable(obj: unknown): obj is Table {\n        return this.check(obj, \"Table\")\n    }\n    static isTableCheck(obj: unknown): obj is TableCheck {\n        return this.check(obj, \"TableCheck\")\n    }\n    static isTableColumn(obj: unknown): obj is TableColumn {\n        return this.check(obj, \"TableColumn\")\n    }\n    static isTableExclusion(obj: unknown): obj is TableExclusion {\n        return this.check(obj, \"TableExclusion\")\n    }\n    static isTableForeignKey(obj: unknown): obj is TableForeignKey {\n        return this.check(obj, \"TableForeignKey\")\n    }\n    static isTableIndex(obj: unknown): obj is TableIndex {\n        return this.check(obj, \"TableIndex\")\n    }\n    static isTableUnique(obj: unknown): obj is TableUnique {\n        return this.check(obj, \"TableUnique\")\n    }\n    static isView(obj: unknown): obj is View {\n        return this.check(obj, \"View\")\n    }\n    static isDataSource(obj: unknown): obj is DataSource {\n        return this.check(obj, \"DataSource\")\n    }\n\n    private static check(obj: unknown, name: string) {\n        return (\n            typeof obj === \"object\" &&\n            obj !== null &&\n            (obj as { \"@instanceof\": symbol })[\"@instanceof\"] ===\n                Symbol.for(name)\n        )\n    }\n}\n"],"sourceRoot":".."}

package/util/ObjectUtils.d.ts

@@ -0,0 +1,45 @@
+import { MixedList } from "../common/MixedList";
+export declare class ObjectUtils {
+    /**
+     * Checks if given value is an object.
+     * We cannot use instanceof because it has problems when running on different contexts.
+     * And we don't simply use typeof because typeof null === "object".
+     */
+    static isObject(val: any): val is object;
+    /**
+     * Checks if given value is an object.
+     * We cannot use instanceof because it has problems when running on different contexts.
+     * And we don't simply use typeof because typeof null === "object".
+     */
+    static isObjectWithName(val: any): val is object & {
+        name: string;
+    };
+    /**
+     * Copy the values of all of the enumerable own properties from one or more source objects to a
+     * target object.
+     * @param target The target object to copy to.
+     * @param source The source object from which to copy properties.
+     */
+    static assign<T, U>(target: T, source: U): void;
+    /**
+     * Copy the values of all of the enumerable own properties from one or more source objects to a
+     * target object.
+     * @param target The target object to copy to.
+     * @param source1 The first source object from which to copy properties.
+     * @param source2 The second source object from which to copy properties.
+     */
+    static assign<T, U, V>(target: T, source1: U, source2: V): void;
+    /**
+     * Copy the values of all of the enumerable own properties from one or more source objects to a
+     * target object.
+     * @param target The target object to copy to.
+     * @param source1 The first source object from which to copy properties.
+     * @param source2 The second source object from which to copy properties.
+     * @param source3 The third source object from which to copy properties.
+     */
+    static assign<T, U, V, W>(target: T, source1: U, source2: V, source3: W): void;
+    /**
+     * Converts MixedList<T> to strictly an array of its T items.
+     */
+    static mixedListToArray<T>(list: MixedList<T>): T[];
+}

package/util/ObjectUtils.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ObjectUtils = void 0;
+class ObjectUtils {
+    /**
+     * Checks if given value is an object.
+     * We cannot use instanceof because it has problems when running on different contexts.
+     * And we don't simply use typeof because typeof null === "object".
+     */
+    static isObject(val) {
+        return val !== null && typeof val === "object";
+    }
+    /**
+     * Checks if given value is an object.
+     * We cannot use instanceof because it has problems when running on different contexts.
+     * And we don't simply use typeof because typeof null === "object".
+     */
+    static isObjectWithName(val) {
+        return (val !== null && typeof val === "object" && val["name"] !== undefined);
+    }
+    /**
+     * Copy the values of all of the enumerable own properties from one or more source objects to a
+     * target object.
+     * @param target The target object to copy to.
+     * @param sources One or more source objects from which to copy properties
+     */
+    static assign(target, ...sources) {
+        for (const source of sources) {
+            for (const prop of Object.getOwnPropertyNames(source)) {
+                ;
+                target[prop] = source[prop];
+            }
+        }
+    }
+    /**
+     * Converts MixedList<T> to strictly an array of its T items.
+     */
+    static mixedListToArray(list) {
+        if (list !== null && typeof list === "object") {
+            return Object.keys(list).map((key) => list[key]);
+        }
+        else {
+            return list;
+        }
+    }
+}
+exports.ObjectUtils = ObjectUtils;
+
+//# sourceMappingURL=ObjectUtils.js.map

package/util/ObjectUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/util/ObjectUtils.ts"],"names":[],"mappings":";;;AAEA,MAAa,WAAW;IACpB;;;;OAIG;IACH,MAAM,CAAC,QAAQ,CAAC,GAAQ;QACpB,OAAO,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,CAAA;IAClD,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,gBAAgB,CAAC,GAAQ;QAC5B,OAAO,CACH,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,SAAS,CACvE,CAAA;IACL,CAAC;IAkCD;;;;;OAKG;IACH,MAAM,CAAC,MAAM,CAAC,MAAc,EAAE,GAAG,OAAc;QAC3C,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC3B,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,mBAAmB,CAAC,MAAM,CAAC,EAAE,CAAC;gBACpD,CAAC;gBAAC,MAAc,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,CAAA;YACzC,CAAC;QACL,CAAC;IACL,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAI,IAAkB;QACzC,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC5C,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CACxB,CAAC,GAAG,EAAE,EAAE,CAAE,IAA6B,CAAC,GAAG,CAAC,CAC/C,CAAA;QACL,CAAC;aAAM,CAAC;YACJ,OAAO,IAAI,CAAA;QACf,CAAC;IACL,CAAC;CACJ;AA/ED,kCA+EC","file":"ObjectUtils.js","sourcesContent":["import { MixedList } from \"../common/MixedList\"\n\nexport class ObjectUtils {\n    /**\n     * Checks if given value is an object.\n     * We cannot use instanceof because it has problems when running on different contexts.\n     * And we don't simply use typeof because typeof null === \"object\".\n     */\n    static isObject(val: any): val is object {\n        return val !== null && typeof val === \"object\"\n    }\n\n    /**\n     * Checks if given value is an object.\n     * We cannot use instanceof because it has problems when running on different contexts.\n     * And we don't simply use typeof because typeof null === \"object\".\n     */\n    static isObjectWithName(val: any): val is object & { name: string } {\n        return (\n            val !== null && typeof val === \"object\" && val[\"name\"] !== undefined\n        )\n    }\n\n    /**\n     * Copy the values of all of the enumerable own properties from one or more source objects to a\n     * target object.\n     * @param target The target object to copy to.\n     * @param source The source object from which to copy properties.\n     */\n    static assign<T, U>(target: T, source: U): void\n\n    /**\n     * Copy the values of all of the enumerable own properties from one or more source objects to a\n     * target object.\n     * @param target The target object to copy to.\n     * @param source1 The first source object from which to copy properties.\n     * @param source2 The second source object from which to copy properties.\n     */\n    static assign<T, U, V>(target: T, source1: U, source2: V): void\n\n    /**\n     * Copy the values of all of the enumerable own properties from one or more source objects to a\n     * target object.\n     * @param target The target object to copy to.\n     * @param source1 The first source object from which to copy properties.\n     * @param source2 The second source object from which to copy properties.\n     * @param source3 The third source object from which to copy properties.\n     */\n    static assign<T, U, V, W>(\n        target: T,\n        source1: U,\n        source2: V,\n        source3: W,\n    ): void\n\n    /**\n     * Copy the values of all of the enumerable own properties from one or more source objects to a\n     * target object.\n     * @param target The target object to copy to.\n     * @param sources One or more source objects from which to copy properties\n     */\n    static assign(target: object, ...sources: any[]): void {\n        for (const source of sources) {\n            for (const prop of Object.getOwnPropertyNames(source)) {\n                ;(target as any)[prop] = source[prop]\n            }\n        }\n    }\n\n    /**\n     * Converts MixedList<T> to strictly an array of its T items.\n     */\n    static mixedListToArray<T>(list: MixedList<T>): T[] {\n        if (list !== null && typeof list === \"object\") {\n            return Object.keys(list).map(\n                (key) => (list as { [key: string]: T })[key],\n            )\n        } else {\n            return list\n        }\n    }\n}\n"],"sourceRoot":".."}

package/util/OrmUtils.d.ts

@@ -0,0 +1,73 @@
+import { DeepPartial } from "../common/DeepPartial";
+import { ObjectLiteral } from "../common/ObjectLiteral";
+import { PrimitiveCriteria, SinglePrimitiveCriteria } from "../common/PrimitiveCriteria";
+export declare class OrmUtils {
+    /**
+     * Chunks array into pieces.
+     */
+    static chunk<T>(array: T[], size: number): T[][];
+    static splitClassesAndStrings<T>(classesAndStrings: (string | T)[]): [T[], string[]];
+    static groupBy<T, R>(array: T[], propertyCallback: (item: T) => R): {
+        id: R;
+        items: T[];
+    }[];
+    static uniq<T>(array: T[], criteria?: (item: T) => unknown): T[];
+    static uniq<T, K extends keyof T>(array: T[], property: K): T[];
+    /**
+     * Deep Object.assign.
+     */
+    static mergeDeep<T>(target: T, ...sources: (DeepPartial<T> | undefined)[]): T;
+    /**
+     * Creates a shallow copy of the object, without invoking the constructor
+     */
+    static cloneObject<T extends object>(object: T): T;
+    /**
+     * Deep compare objects.
+     *
+     * @see http://stackoverflow.com/a/1144249
+     */
+    static deepCompare<T>(...args: T[]): boolean;
+    /**
+     * Gets deeper value of object.
+     */
+    static deepValue(obj: ObjectLiteral, path: string): any;
+    static replaceEmptyObjectsWithBooleans(obj: any): void;
+    static propertyPathsToTruthyObject(paths: string[]): any;
+    /**
+     * Check if two entity-id-maps are the same
+     */
+    static compareIds(firstId: ObjectLiteral | undefined, secondId: ObjectLiteral | undefined): boolean;
+    /**
+     * Transforms given value into boolean value.
+     */
+    static toBoolean(value: any): boolean;
+    /**
+     * Checks if two arrays of unique values contain the same values
+     */
+    static isArraysEqual<T>(arr1: T[], arr2: T[]): boolean;
+    static areMutuallyExclusive<T>(...lists: T[][]): boolean;
+    /**
+     * Parses the CHECK constraint on the specified column and returns
+     * all values allowed by the constraint or undefined if the constraint
+     * is not present.
+     */
+    static parseSqlCheckExpression(sql: string, columnName: string): string[] | undefined;
+    /**
+     * Checks if given criteria is null or empty.
+     */
+    static isCriteriaNullOrEmpty(criteria: unknown): boolean;
+    /**
+     * Checks if given criteria is a primitive value.
+     * Primitive values are strings, numbers and dates.
+     */
+    static isSinglePrimitiveCriteria(criteria: unknown): criteria is SinglePrimitiveCriteria;
+    /**
+     * Checks if given criteria is a primitive value or an array of primitive values.
+     */
+    static isPrimitiveCriteria(criteria: unknown): criteria is PrimitiveCriteria;
+    private static compare2Objects;
+    private static isPlainObject;
+    private static mergeArrayKey;
+    private static mergeObjectKey;
+    private static merge;
+}