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

package/driver/postgres/PostgresDataSourceOptions.d.ts

@@ -41,6 +41,7 @@ export interface PostgresDataSourceOptions extends BaseDataSourceOptions, Postgr
         readonly slaves: PostgresConnectionCredentialsOptions[];
         /**
          * Default connection pool to use for SELECT queries
+         *
          * @default "slave"
          */
         readonly defaultMode?: ReplicationMode;
@@ -75,6 +76,7 @@ export interface PostgresDataSourceOptions extends BaseDataSourceOptions, Postgr
      *
      * Enabling parseInt8 will cause node-postgres to parse int8 results as numbers.
      * Note: the maximum safe integer in js is: Number.MAX_SAFE_INTEGER (`+2^53`)
+     *
      * @see [JavaScript Number objects](http://ecma262-5.com/ELS5_HTML.htm#Section_8.5)
      * @see [node-postgres int8 explanation](https://github.com/brianc/node-pg-types#:~:text=on%20projects%3A%20return-,64%2Dbit%20integers,-(int8)%20as)
      * @see [node-postgres defaults.parseInt8 implementation](https://github.com/brianc/node-postgres/blob/pg%408.8.0/packages/pg/lib/defaults.js#L80)

package/driver/postgres/PostgresDataSourceOptions.js.map

@@ -1 +1 @@
-{"version":3,"file":"PostgresDataSourceOptions.js","sourceRoot":"","sources":["../../../../src/driver/postgres/PostgresDataSourceOptions.ts"],"names":[],"mappings":"","sourcesContent":["import type { BaseDataSourceOptions } from \"../../data-source/BaseDataSourceOptions\"\nimport type { ReplicationMode } from \"../types/ReplicationMode\"\nimport type { PostgresConnectionCredentialsOptions } from \"./PostgresConnectionCredentialsOptions\"\n\n/**\n * Postgres-specific connection options.\n */\nexport interface PostgresDataSourceOptions\n    extends BaseDataSourceOptions, PostgresConnectionCredentialsOptions {\n    /**\n     * Database type.\n     */\n    readonly type: \"postgres\"\n\n    /**\n     * Schema name.\n     */\n    readonly schema?: string\n\n    /**\n     * The driver object\n     * This defaults to `require(\"pg\")`.\n     */\n    readonly driver?: any\n\n    /**\n     * The driver object\n     * This defaults to `require(\"pg-native\")`.\n     */\n    readonly nativeDriver?: any\n\n    /**\n     * A boolean determining whether to pass time values in UTC or local time. (default: false).\n     */\n    readonly useUTC?: boolean\n\n    /**\n     * Replication setup.\n     */\n    readonly replication?: {\n        /**\n         * Master server used by orm to perform writes.\n         */\n        readonly master: PostgresConnectionCredentialsOptions\n\n        /**\n         * List of read-from servers (slaves).\n         */\n        readonly slaves: PostgresConnectionCredentialsOptions[]\n\n        /**\n         * Default connection pool to use for SELECT queries\n         * @default \"slave\"\n         */\n        readonly defaultMode?: ReplicationMode\n    }\n\n    /**\n     * The milliseconds before a timeout occurs during the initial connection to the postgres\n     * server. If undefined, or set to 0, there is no timeout. Defaults to undefined.\n     */\n    readonly connectTimeoutMS?: number\n\n    /**\n     * The Postgres extension to use to generate UUID columns. Defaults to uuid-ossp.\n     * If pgcrypto is selected, TypeORM will use the gen_random_uuid() function from this extension.\n     * If uuid-ossp is selected, TypeORM will use the uuid_generate_v4() function from this extension.\n     */\n    readonly uuidExtension?: \"pgcrypto\" | \"uuid-ossp\"\n\n    /*\n     * Function handling errors thrown by drivers pool.\n     * Defaults to logging error with `warn` level.\n     */\n    readonly poolErrorHandler?: (err: any) => any\n\n    /**\n     * Include notification messages from Postgres server in client logs\n     */\n    readonly logNotifications?: boolean\n\n    /**\n     * Automatically install postgres extensions\n     */\n    readonly installExtensions?: boolean\n\n    /**\n     * Return 64-bit integers (int8) as JavaScript integers.\n     *\n     * Because JavaScript doesn't have support for 64-bit integers node-postgres cannot confidently\n     * parse int8 data type results as numbers because if you have a huge number it will overflow\n     * and the result you'd get back from node-postgres would not be the result in the database.\n     * That would be a very bad thing so node-postgres just returns int8 results as strings and leaves the parsing up to you.\n     *\n     * Enabling parseInt8 will cause node-postgres to parse int8 results as numbers.\n     * Note: the maximum safe integer in js is: Number.MAX_SAFE_INTEGER (`+2^53`)\n     * @see [JavaScript Number objects](http://ecma262-5.com/ELS5_HTML.htm#Section_8.5)\n     * @see [node-postgres int8 explanation](https://github.com/brianc/node-pg-types#:~:text=on%20projects%3A%20return-,64%2Dbit%20integers,-(int8)%20as)\n     * @see [node-postgres defaults.parseInt8 implementation](https://github.com/brianc/node-postgres/blob/pg%408.8.0/packages/pg/lib/defaults.js#L80)\n     */\n    readonly parseInt8?: boolean\n\n    /**\n     * List of additional Postgres extensions to be installed in the database.\n     */\n    readonly extensions?: string[]\n}\n"]}
+{"version":3,"file":"PostgresDataSourceOptions.js","sourceRoot":"","sources":["../../../../src/driver/postgres/PostgresDataSourceOptions.ts"],"names":[],"mappings":"","sourcesContent":["import type { BaseDataSourceOptions } from \"../../data-source/BaseDataSourceOptions\"\nimport type { ReplicationMode } from \"../types/ReplicationMode\"\nimport type { PostgresConnectionCredentialsOptions } from \"./PostgresConnectionCredentialsOptions\"\n\n/**\n * Postgres-specific connection options.\n */\nexport interface PostgresDataSourceOptions\n    extends BaseDataSourceOptions, PostgresConnectionCredentialsOptions {\n    /**\n     * Database type.\n     */\n    readonly type: \"postgres\"\n\n    /**\n     * Schema name.\n     */\n    readonly schema?: string\n\n    /**\n     * The driver object\n     * This defaults to `require(\"pg\")`.\n     */\n    readonly driver?: any\n\n    /**\n     * The driver object\n     * This defaults to `require(\"pg-native\")`.\n     */\n    readonly nativeDriver?: any\n\n    /**\n     * A boolean determining whether to pass time values in UTC or local time. (default: false).\n     */\n    readonly useUTC?: boolean\n\n    /**\n     * Replication setup.\n     */\n    readonly replication?: {\n        /**\n         * Master server used by orm to perform writes.\n         */\n        readonly master: PostgresConnectionCredentialsOptions\n\n        /**\n         * List of read-from servers (slaves).\n         */\n        readonly slaves: PostgresConnectionCredentialsOptions[]\n\n        /**\n         * Default connection pool to use for SELECT queries\n         *\n         * @default \"slave\"\n         */\n        readonly defaultMode?: ReplicationMode\n    }\n\n    /**\n     * The milliseconds before a timeout occurs during the initial connection to the postgres\n     * server. If undefined, or set to 0, there is no timeout. Defaults to undefined.\n     */\n    readonly connectTimeoutMS?: number\n\n    /**\n     * The Postgres extension to use to generate UUID columns. Defaults to uuid-ossp.\n     * If pgcrypto is selected, TypeORM will use the gen_random_uuid() function from this extension.\n     * If uuid-ossp is selected, TypeORM will use the uuid_generate_v4() function from this extension.\n     */\n    readonly uuidExtension?: \"pgcrypto\" | \"uuid-ossp\"\n\n    /*\n     * Function handling errors thrown by drivers pool.\n     * Defaults to logging error with `warn` level.\n     */\n    readonly poolErrorHandler?: (err: any) => any\n\n    /**\n     * Include notification messages from Postgres server in client logs\n     */\n    readonly logNotifications?: boolean\n\n    /**\n     * Automatically install postgres extensions\n     */\n    readonly installExtensions?: boolean\n\n    /**\n     * Return 64-bit integers (int8) as JavaScript integers.\n     *\n     * Because JavaScript doesn't have support for 64-bit integers node-postgres cannot confidently\n     * parse int8 data type results as numbers because if you have a huge number it will overflow\n     * and the result you'd get back from node-postgres would not be the result in the database.\n     * That would be a very bad thing so node-postgres just returns int8 results as strings and leaves the parsing up to you.\n     *\n     * Enabling parseInt8 will cause node-postgres to parse int8 results as numbers.\n     * Note: the maximum safe integer in js is: Number.MAX_SAFE_INTEGER (`+2^53`)\n     *\n     * @see [JavaScript Number objects](http://ecma262-5.com/ELS5_HTML.htm#Section_8.5)\n     * @see [node-postgres int8 explanation](https://github.com/brianc/node-pg-types#:~:text=on%20projects%3A%20return-,64%2Dbit%20integers,-(int8)%20as)\n     * @see [node-postgres defaults.parseInt8 implementation](https://github.com/brianc/node-postgres/blob/pg%408.8.0/packages/pg/lib/defaults.js#L80)\n     */\n    readonly parseInt8?: boolean\n\n    /**\n     * List of additional Postgres extensions to be installed in the database.\n     */\n    readonly extensions?: string[]\n}\n"]}

package/driver/postgres/PostgresDriver.d.ts

@@ -18,6 +18,7 @@ import type { DataTypeDefaults } from "../types/DataTypeDefaults";
 import type { MappedColumnTypes } from "../types/MappedColumnTypes";
 import type { ReplicationMode } from "../types/ReplicationMode";
 import type { ReturningType } from "../types/ReturningType";
+import type { IsolationLevel } from "../types/IsolationLevel";
 import type { UpsertType } from "../types/UpsertType";
 import type { PostgresConnectionCredentialsOptions } from "./PostgresConnectionCredentialsOptions";
 import type { PostgresDataSourceOptions } from "./PostgresDataSourceOptions";
@@ -26,12 +27,23 @@ import { PostgresQueryRunner } from "./PostgresQueryRunner";
  * Organizes communication with PostgreSQL DBMS.
  */
 export declare class PostgresDriver implements Driver {
+    /**
+     * Transaction isolation levels supported by this driver.
+     *
+     * @see https://www.postgresql.org/docs/current/transaction-iso.html
+     */
+    static readonly supportedIsolationLevels: IsolationLevel[];
     /**
      * DataSource used by the driver.
      */
     dataSource: DataSource;
+    /**
+     * Isolation levels supported by this driver.
+     */
+    supportedIsolationLevels: ("READ COMMITTED" | "READ UNCOMMITTED" | "REPEATABLE READ" | "SERIALIZABLE" | "SNAPSHOT")[];
     /**
      * DataSource used by the driver.
+     *
      * @deprecated since 1.0.0. Use {@link dataSource} instance instead.
      */
     get connection(): DataSource;
@@ -92,6 +104,7 @@ export declare class PostgresDriver implements Driver {
     transactionSupport: "nested";
     /**
      * Gets list of supported column data types by a driver.
+     *
      * @see https://www.postgresql.org/docs/current/datatype.html
      */
     supportedDataTypes: ColumnType[];
@@ -135,6 +148,7 @@ export declare class PostgresDriver implements Driver {
     dataTypeDefaults: DataTypeDefaults;
     /**
      * Max length allowed by Postgres for aliases.
+     *
      * @see https://www.postgresql.org/docs/current/sql-syntax-lexical.html#SQL-SYNTAX-IDENTIFIERS
      */
     maxAliasLength: number;
@@ -175,17 +189,20 @@ export declare class PostgresDriver implements Driver {
     createSchemaBuilder(): RdbmsSchemaBuilder;
     /**
      * Creates a query runner used to execute database queries.
+     *
      * @param mode
      */
     createQueryRunner(mode: ReplicationMode): PostgresQueryRunner;
     /**
      * Prepares given value to a value to be persisted, based on its column type and metadata.
+     *
      * @param value
      * @param columnMetadata
      */
     preparePersistentValue(value: any, columnMetadata: ColumnMetadata): any;
     /**
      * Prepares given value to a value to be persisted, based on its column type or metadata.
+     *
      * @param value
      * @param columnMetadata
      */
@@ -193,24 +210,28 @@ export declare class PostgresDriver implements Driver {
     /**
      * Replaces parameters in the given sql with special escaping character
      * and an array of parameter names to be passed to a query.
+     *
      * @param sql
      * @param parameters
      */
     escapeQueryWithParameters(sql: string, parameters: ObjectLiteral): [string, any[]];
     /**
      * Escapes a column name.
+     *
      * @param columnName
      */
     escape(columnName: string): string;
     /**
      * Build full table name with schema name and table name.
      * E.g. myDB.mySchema.myTable
+     *
      * @param tableName
      * @param schema
      */
     buildTableName(tableName: string, schema?: string): string;
     /**
      * Parse a target table name or other types and return a normalized table definition.
+     *
      * @param target
      */
     parseTableName(target: EntityMetadata | Table | View | TableForeignKey | string): {
@@ -220,6 +241,7 @@ export declare class PostgresDriver implements Driver {
     };
     /**
      * Creates a database type from a given column metadata.
+     *
      * @param column
      * @param column.type
      * @param column.length
@@ -236,33 +258,39 @@ export declare class PostgresDriver implements Driver {
     }): string;
     /**
      * Normalizes "default" value of the column.
+     *
      * @param columnMetadata
      */
     normalizeDefault(columnMetadata: ColumnMetadata): string | undefined;
     /**
      * Compares "default" value of the column.
+     *
      * @param columnMetadata
      * @param tableColumn
      */
     private defaultEqual;
     /**
      * Compares json/jsonb default values of the column.
+     *
      * @param columnMetadata
      * @param tableColumn
      */
     private compareJsonDefaults;
     /**
      * Normalizes "isUnique" value of the column.
+     *
      * @param column
      */
     normalizeIsUnique(column: ColumnMetadata): boolean;
     /**
      * Returns default column lengths, which is required on column creation.
+     *
      * @param column
      */
     getColumnLength(column: ColumnMetadata): string;
     /**
      * Creates column type definition including length, precision and scale
+     *
      * @param column
      */
     createFullType(column: TableColumn): string;
@@ -282,6 +310,7 @@ export declare class PostgresDriver implements Driver {
      * Creates generated map of values generated or returned by database after INSERT query.
      *
      * todo: slow. optimize Object.keys(), OrmUtils.mergeDeep and column.createValueMap parts
+     *
      * @param metadata
      * @param insertResult
      */
@@ -289,6 +318,7 @@ export declare class PostgresDriver implements Driver {
     /**
      * Differentiate columns of this table and columns from the given column metadatas columns
      * and returns only changed.
+     *
      * @param tableColumns
      * @param columnMetadatas
      */
@@ -296,6 +326,7 @@ export declare class PostgresDriver implements Driver {
     private lowerDefaultValueIfNecessary;
     /**
      * Returns true if driver supports RETURNING / OUTPUT statement.
+     *
      * @param _returningType
      */
     isReturningSqlSupported(_returningType: ReturningType): boolean;
@@ -310,6 +341,7 @@ export declare class PostgresDriver implements Driver {
     get uuidGenerator(): string;
     /**
      * Creates an escaped parameter.
+     *
      * @param parameterName
      * @param index
      */
@@ -325,17 +357,20 @@ export declare class PostgresDriver implements Driver {
     protected loadDependencies(): void;
     /**
      * Creates a new connection pool for a given database credentials.
+     *
      * @param options
      * @param credentials
      */
     protected createPool(options: PostgresDataSourceOptions, credentials: PostgresConnectionCredentialsOptions): Promise<any>;
     /**
      * Closes connection pool.
+     *
      * @param pool
      */
     protected closePool(pool: any): Promise<void>;
     /**
      * Executes given query.
+     *
      * @param connection
      * @param query
      */
@@ -343,11 +378,13 @@ export declare class PostgresDriver implements Driver {
     /**
      * If parameter is a datetime function, e.g. "CURRENT_TIMESTAMP", normalizes it.
      * Otherwise returns original input.
+     *
      * @param value
      */
     protected normalizeDatetimeFunction(value: string): string;
     /**
      * Escapes a given comment.
+     *
      * @param comment
      */
     protected escapeComment(comment?: string): string | undefined;

package/driver/postgres/PostgresDriver.js

@@ -17,8 +17,23 @@ const PostgresQueryRunner_1 = require("./PostgresQueryRunner");
  * Organizes communication with PostgreSQL DBMS.
  */
 class PostgresDriver {
+    // -------------------------------------------------------------------------
+    // Static Properties
+    // -------------------------------------------------------------------------
+    /**
+     * Transaction isolation levels supported by this driver.
+     *
+     * @see https://www.postgresql.org/docs/current/transaction-iso.html
+     */
+    static { this.supportedIsolationLevels = [
+        "READ UNCOMMITTED",
+        "READ COMMITTED",
+        "REPEATABLE READ",
+        "SERIALIZABLE",
+    ]; }
     /**
      * DataSource used by the driver.
+     *
      * @deprecated since 1.0.0. Use {@link dataSource} instance instead.
      */
     get connection() {
@@ -28,6 +43,10 @@ class PostgresDriver {
     // Constructor
     // -------------------------------------------------------------------------
     constructor(dataSource) {
+        /**
+         * Isolation levels supported by this driver.
+         */
+        this.supportedIsolationLevels = PostgresDriver.supportedIsolationLevels;
         /**
          * Pool for slave databases.
          * Used in replication.
@@ -51,6 +70,7 @@ class PostgresDriver {
         this.transactionSupport = "nested";
         /**
          * Gets list of supported column data types by a driver.
+         *
          * @see https://www.postgresql.org/docs/current/datatype.html
          */
         this.supportedDataTypes = [
@@ -227,6 +247,7 @@ class PostgresDriver {
         };
         /**
          * Max length allowed by Postgres for aliases.
+         *
          * @see https://www.postgresql.org/docs/current/sql-syntax-lexical.html#SQL-SYNTAX-IDENTIFIERS
          */
         this.maxAliasLength = 63;
@@ -287,20 +308,12 @@ class PostgresDriver {
         }
         if (!this.version || !this.database || !this.searchSchema) {
             const queryRunner = this.createQueryRunner("master");
-            if (!this.version) {
-                this.version = await queryRunner.getVersion();
-            }
-            if (!this.database) {
-                this.database = await queryRunner.getCurrentDatabase();
-            }
-            if (!this.searchSchema) {
-                this.searchSchema = await queryRunner.getCurrentSchema();
-            }
+            this.version ??= await queryRunner.getVersion();
+            this.database ??= await queryRunner.getCurrentDatabase();
+            this.searchSchema ??= await queryRunner.getCurrentSchema();
             await queryRunner.release();
         }
-        if (!this.schema) {
-            this.schema = this.searchSchema;
-        }
+        this.schema ??= this.searchSchema;
     }
     /**
      * Makes any action after connection (e.g. create extensions in Postgres driver).
@@ -343,10 +356,10 @@ class PostgresDriver {
         const { hasUuidColumns, hasCitextColumns, hasHstoreColumns, hasCubeColumns, hasGeometryColumns, hasLtreeColumns, hasVectorColumns, hasExclusionConstraints, } = extensionsMetadata;
         if (hasUuidColumns)
             try {
-                await this.executeQuery(connection, `CREATE EXTENSION IF NOT EXISTS "${this.options.uuidExtension || "uuid-ossp"}"`);
+                await this.executeQuery(connection, `CREATE EXTENSION IF NOT EXISTS "${this.options.uuidExtension ?? "uuid-ossp"}"`);
             }
             catch (_) {
-                logger.log("warn", `At least one of the entities has uuid column, but the '${this.options.uuidExtension || "uuid-ossp"}' extension cannot be installed automatically. Please install it manually using superuser rights, or select another uuid extension.`);
+                logger.log("warn", `At least one of the entities has uuid column, but the '${this.options.uuidExtension ?? "uuid-ossp"}' extension cannot be installed automatically. Please install it manually using superuser rights, or select another uuid extension.`);
             }
         if (hasCitextColumns)
             try {
@@ -483,6 +496,7 @@ class PostgresDriver {
     }
     /**
      * Creates a query runner used to execute database queries.
+     *
      * @param mode
      */
     createQueryRunner(mode) {
@@ -490,6 +504,7 @@ class PostgresDriver {
     }
     /**
      * Prepares given value to a value to be persisted, based on its column type and metadata.
+     *
      * @param value
      * @param columnMetadata
      */
@@ -597,6 +612,7 @@ class PostgresDriver {
     }
     /**
      * Prepares given value to a value to be persisted, based on its column type or metadata.
+     *
      * @param value
      * @param columnMetadata
      */
@@ -725,6 +741,7 @@ class PostgresDriver {
     /**
      * Replaces parameters in the given sql with special escaping character
      * and an array of parameter names to be passed to a query.
+     *
      * @param sql
      * @param parameters
      */
@@ -760,6 +777,7 @@ class PostgresDriver {
     }
     /**
      * Escapes a column name.
+     *
      * @param columnName
      */
     escape(columnName) {
@@ -768,6 +786,7 @@ class PostgresDriver {
     /**
      * Build full table name with schema name and table name.
      * E.g. myDB.mySchema.myTable
+     *
      * @param tableName
      * @param schema
      */
@@ -780,6 +799,7 @@ class PostgresDriver {
     }
     /**
      * Parse a target table name or other types and return a normalized table definition.
+     *
      * @param target
      */
     parseTableName(target) {
@@ -788,38 +808,39 @@ class PostgresDriver {
         if (InstanceChecker_1.InstanceChecker.isTable(target) || InstanceChecker_1.InstanceChecker.isView(target)) {
             const parsed = this.parseTableName(target.name);
             return {
-                database: target.database || parsed.database || driverDatabase,
-                schema: target.schema || parsed.schema || driverSchema,
+                database: target.database ?? parsed.database ?? driverDatabase,
+                schema: target.schema ?? parsed.schema ?? driverSchema,
                 tableName: parsed.tableName,
             };
         }
         if (InstanceChecker_1.InstanceChecker.isTableForeignKey(target)) {
             const parsed = this.parseTableName(target.referencedTableName);
             return {
-                database: target.referencedDatabase ||
-                    parsed.database ||
+                database: target.referencedDatabase ??
+                    parsed.database ??
                     driverDatabase,
-                schema: target.referencedSchema || parsed.schema || driverSchema,
+                schema: target.referencedSchema ?? parsed.schema ?? driverSchema,
                 tableName: parsed.tableName,
             };
         }
         if (InstanceChecker_1.InstanceChecker.isEntityMetadata(target)) {
             // EntityMetadata tableName is never a path
             return {
-                database: target.database || driverDatabase,
-                schema: target.schema || driverSchema,
+                database: target.database ?? driverDatabase,
+                schema: target.schema ?? driverSchema,
                 tableName: target.tableName,
             };
         }
         const parts = target.split(".");
         return {
             database: driverDatabase,
-            schema: (parts.length > 1 ? parts[0] : undefined) || driverSchema,
+            schema: (parts.length > 1 ? parts[0] : undefined) ?? driverSchema,
             tableName: parts.length > 1 ? parts[1] : parts[0],
         };
     }
     /**
      * Creates a database type from a given column metadata.
+     *
      * @param column
      * @param column.type
      * @param column.length
@@ -887,6 +908,7 @@ class PostgresDriver {
     }
     /**
      * Normalizes "default" value of the column.
+     *
      * @param columnMetadata
      */
     normalizeDefault(columnMetadata) {
@@ -918,6 +940,7 @@ class PostgresDriver {
     }
     /**
      * Compares "default" value of the column.
+     *
      * @param columnMetadata
      * @param tableColumn
      */
@@ -936,6 +959,7 @@ class PostgresDriver {
     }
     /**
      * Compares json/jsonb default values of the column.
+     *
      * @param columnMetadata
      * @param tableColumn
      */
@@ -965,6 +989,7 @@ class PostgresDriver {
     }
     /**
      * Normalizes "isUnique" value of the column.
+     *
      * @param column
      */
     normalizeIsUnique(column) {
@@ -972,6 +997,7 @@ class PostgresDriver {
     }
     /**
      * Returns default column lengths, which is required on column creation.
+     *
      * @param column
      */
     getColumnLength(column) {
@@ -979,6 +1005,7 @@ class PostgresDriver {
     }
     /**
      * Creates column type definition including length, precision and scale
+     *
      * @param column
      */
     createFullType(column) {
@@ -1090,6 +1117,7 @@ class PostgresDriver {
      * Creates generated map of values generated or returned by database after INSERT query.
      *
      * todo: slow. optimize Object.keys(), OrmUtils.mergeDeep and column.createValueMap parts
+     *
      * @param metadata
      * @param insertResult
      */
@@ -1108,6 +1136,7 @@ class PostgresDriver {
     /**
      * Differentiate columns of this table and columns from the given column metadatas columns
      * and returns only changed.
+     *
      * @param tableColumns
      * @param columnMetadatas
      */
@@ -1132,16 +1161,16 @@ class PostgresDriver {
                 tableColumn.isUnique !==
                     this.normalizeIsUnique(columnMetadata) ||
                 tableColumn.enumName !== columnMetadata.enumName ||
-                (tableColumn.enum &&
+                !!(tableColumn.enum &&
                     columnMetadata.enum &&
                     !OrmUtils_1.OrmUtils.isArraysEqual(tableColumn.enum, columnMetadata.enum.map((val) => val + ""))) || // enums in postgres are always strings
                 tableColumn.isGenerated !== columnMetadata.isGenerated ||
-                (tableColumn.spatialFeatureType || "").toLowerCase() !==
-                    (columnMetadata.spatialFeatureType || "").toLowerCase() ||
+                (tableColumn.spatialFeatureType ?? "").toLowerCase() !==
+                    (columnMetadata.spatialFeatureType ?? "").toLowerCase() ||
                 tableColumn.srid !== columnMetadata.srid ||
                 tableColumn.generatedType !== columnMetadata.generatedType ||
-                (tableColumn.asExpression || "").trim() !==
-                    (columnMetadata.asExpression || "").trim() ||
+                (tableColumn.asExpression ?? "").trim() !==
+                    (columnMetadata.asExpression ?? "").trim() ||
                 tableColumn.collation !== columnMetadata.collation;
             // DEBUG SECTION
             // if (isColumnChanged) {
@@ -1258,6 +1287,7 @@ class PostgresDriver {
     }
     /**
      * Returns true if driver supports RETURNING / OUTPUT statement.
+     *
      * @param _returningType
      */
     isReturningSqlSupported(_returningType) {
@@ -1282,6 +1312,7 @@ class PostgresDriver {
     }
     /**
      * Creates an escaped parameter.
+     *
      * @param parameterName
      * @param index
      */
@@ -1311,10 +1342,10 @@ class PostgresDriver {
      */
     loadDependencies() {
         try {
-            const postgres = this.options.driver || PlatformTools_1.PlatformTools.load("pg");
+            const postgres = this.options.driver ?? PlatformTools_1.PlatformTools.load("pg");
             this.postgres = postgres;
             try {
-                const pgNative = this.options.nativeDriver || PlatformTools_1.PlatformTools.load("pg-native");
+                const pgNative = this.options.nativeDriver ?? PlatformTools_1.PlatformTools.load("pg-native");
                 if (pgNative && this.postgres.native)
                     this.postgres = this.postgres.native;
             }
@@ -1327,6 +1358,7 @@ class PostgresDriver {
     }
     /**
      * Creates a new connection pool for a given database credentials.
+     *
      * @param options
      * @param credentials
      */
@@ -1346,7 +1378,7 @@ class PostgresDriver {
             connectionTimeoutMillis: options.connectTimeoutMS,
             application_name: options.applicationName ?? credentials.applicationName,
             max: options.poolSize,
-        }, options.extra || {});
+        }, options.extra ?? {});
         if (options.parseInt8 !== undefined) {
             if (this.postgres.defaults &&
                 Object.getOwnPropertyDescriptor(this.postgres.defaults, "parseInt8")?.set) {
@@ -1358,7 +1390,7 @@ class PostgresDriver {
         }
         // create a connection pool
         const pool = new this.postgres.Pool(connectionOptions);
-        const poolErrorHandler = options.poolErrorHandler ||
+        const poolErrorHandler = options.poolErrorHandler ??
             ((error) => logger.log("warn", `Postgres pool raised an error. ${error}`));
         /*
           Attaching an error handler to pool errors is essential, as, otherwise, errors raised will go unhandled and
@@ -1388,6 +1420,7 @@ class PostgresDriver {
     }
     /**
      * Closes connection pool.
+     *
      * @param pool
      */
     async closePool(pool) {
@@ -1400,6 +1433,7 @@ class PostgresDriver {
     }
     /**
      * Executes given query.
+     *
      * @param connection
      * @param query
      */
@@ -1412,6 +1446,7 @@ class PostgresDriver {
     /**
      * If parameter is a datetime function, e.g. "CURRENT_TIMESTAMP", normalizes it.
      * Otherwise returns original input.
+     *
      * @param value
      */
     normalizeDatetimeFunction(value) {
@@ -1453,6 +1488,7 @@ class PostgresDriver {
     }
     /**
      * Escapes a given comment.
+     *
      * @param comment
      */
     escapeComment(comment) {