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

package/browser/driver/capacitor/CapacitorQueryRunner.d.ts

@@ -24,6 +24,7 @@ export declare class CapacitorQueryRunner extends AbstractSqliteQueryRunner {
     }[]): Promise<any>;
     /**
      * Executes a given SQL query.
+     *
      * @param query
      * @param parameters
      * @param useStructuredResult
@@ -31,6 +32,7 @@ export declare class CapacitorQueryRunner extends AbstractSqliteQueryRunner {
     query(query: string, parameters?: any[], useStructuredResult?: boolean): Promise<any>;
     /**
      * Parametrizes given object of values. Used to create column=value queries.
+     *
      * @param objectLiteral
      */
     protected parametrize(objectLiteral: ObjectLiteral): string[];

package/browser/driver/capacitor/CapacitorQueryRunner.js

@@ -39,6 +39,7 @@ class CapacitorQueryRunner extends AbstractSqliteQueryRunner_1.AbstractSqliteQue
     }
     /**
      * Executes a given SQL query.
+     *
      * @param query
      * @param parameters
      * @param useStructuredResult
@@ -65,7 +66,7 @@ class CapacitorQueryRunner extends AbstractSqliteQueryRunner_1.AbstractSqliteQue
                 raw = await databaseConnection.run(query, parameters, false);
             }
             else {
-                raw = await databaseConnection.query(query, parameters || []);
+                raw = await databaseConnection.query(query, parameters ?? []);
             }
             const result = new QueryResult_1.QueryResult();
             if (raw?.hasOwnProperty("values")) {
@@ -74,7 +75,7 @@ class CapacitorQueryRunner extends AbstractSqliteQueryRunner_1.AbstractSqliteQue
             }
             if (raw?.hasOwnProperty("changes")) {
                 result.affected = raw.changes.changes;
-                result.raw = raw.changes.lastId || raw.changes.changes;
+                result.raw = raw.changes.lastId ?? raw.changes.changes;
             }
             if (!useStructuredResult) {
                 return result.raw;
@@ -91,6 +92,7 @@ class CapacitorQueryRunner extends AbstractSqliteQueryRunner_1.AbstractSqliteQue
     // -------------------------------------------------------------------------
     /**
      * Parametrizes given object of values. Used to create column=value queries.
+     *
      * @param objectLiteral
      */
     parametrize(objectLiteral) {

package/browser/driver/capacitor/CapacitorQueryRunner.js.map

@@ -1 +1 @@
-{"version":3,"file":"CapacitorQueryRunner.js","sourceRoot":"../build/browser/src/","sources":["driver/capacitor/CapacitorQueryRunner.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ObjectLiteral } from \"../../common/ObjectLiteral\"\nimport { QueryFailedError } from \"../../error/QueryFailedError\"\nimport { QueryRunnerAlreadyReleasedError } from \"../../error/QueryRunnerAlreadyReleasedError\"\nimport { QueryResult } from \"../../query-runner/QueryResult\"\nimport { Broadcaster } from \"../../subscriber/Broadcaster\"\nimport { AbstractSqliteQueryRunner } from \"../sqlite-abstract/AbstractSqliteQueryRunner\"\nimport type { CapacitorDriver } from \"./CapacitorDriver\"\n\n/**\n * Runs queries on a single sqlite database connection.\n */\nexport class CapacitorQueryRunner extends AbstractSqliteQueryRunner {\n    /**\n     * Database driver used by connection.\n     */\n    driver: CapacitorDriver\n\n    // -------------------------------------------------------------------------\n    // Constructor\n    // -------------------------------------------------------------------------\n\n    constructor(driver: CapacitorDriver) {\n        super()\n        this.driver = driver\n        this.dataSource = driver.dataSource\n        this.broadcaster = new Broadcaster(this)\n    }\n\n    /**\n     * Called before migrations are run.\n     */\n    async beforeMigration(): Promise<void> {\n        await this.query(`PRAGMA foreign_keys = OFF`)\n    }\n\n    /**\n     * Called after migrations are run.\n     */\n    async afterMigration(): Promise<void> {\n        await this.query(`PRAGMA foreign_keys = ON`)\n    }\n\n    async executeSet(set: { statement: string; values?: any[] }[]) {\n        if (this.isReleased) throw new QueryRunnerAlreadyReleasedError()\n\n        const databaseConnection = await this.connect()\n\n        return databaseConnection.executeSet(set, false)\n    }\n\n    /**\n     * Executes a given SQL query.\n     * @param query\n     * @param parameters\n     * @param useStructuredResult\n     */\n    async query(\n        query: string,\n        parameters?: any[],\n        useStructuredResult = false,\n    ): Promise<any> {\n        if (this.isReleased) throw new QueryRunnerAlreadyReleasedError()\n\n        const databaseConnection = await this.connect()\n\n        this.driver.dataSource.logger.logQuery(query, parameters, this)\n\n        const command = query.substring(\n            0,\n            query.indexOf(\" \") !== -1 ? query.indexOf(\" \") : undefined,\n        )\n\n        try {\n            let raw: any\n\n            if (\n                [\n                    \"BEGIN\",\n                    \"ROLLBACK\",\n                    \"COMMIT\",\n                    \"CREATE\",\n                    \"ALTER\",\n                    \"DROP\",\n                ].indexOf(command) !== -1\n            ) {\n                raw = await databaseConnection.execute(query, false)\n            } else if ([\"INSERT\", \"UPDATE\", \"DELETE\"].indexOf(command) !== -1) {\n                raw = await databaseConnection.run(query, parameters, false)\n            } else {\n                raw = await databaseConnection.query(query, parameters || [])\n            }\n\n            const result = new QueryResult()\n\n            if (raw?.hasOwnProperty(\"values\")) {\n                result.raw = raw.values\n                result.records = raw.values\n            }\n\n            if (raw?.hasOwnProperty(\"changes\")) {\n                result.affected = raw.changes.changes\n                result.raw = raw.changes.lastId || raw.changes.changes\n            }\n\n            if (!useStructuredResult) {\n                return result.raw\n            }\n\n            return result\n        } catch (err) {\n            this.driver.dataSource.logger.logQueryError(\n                err,\n                query,\n                parameters,\n                this,\n            )\n\n            throw new QueryFailedError(query, parameters, err)\n        }\n    }\n\n    // -------------------------------------------------------------------------\n    // Protected Methods\n    // -------------------------------------------------------------------------\n\n    /**\n     * Parametrizes given object of values. Used to create column=value queries.\n     * @param objectLiteral\n     */\n    protected parametrize(objectLiteral: ObjectLiteral): string[] {\n        return Object.keys(objectLiteral).map((key) => `\"${key}\"` + \"=?\")\n    }\n}\n"]}
+{"version":3,"file":"CapacitorQueryRunner.js","sourceRoot":"../build/browser/src/","sources":["driver/capacitor/CapacitorQueryRunner.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ObjectLiteral } from \"../../common/ObjectLiteral\"\nimport { QueryFailedError } from \"../../error/QueryFailedError\"\nimport { QueryRunnerAlreadyReleasedError } from \"../../error/QueryRunnerAlreadyReleasedError\"\nimport { QueryResult } from \"../../query-runner/QueryResult\"\nimport { Broadcaster } from \"../../subscriber/Broadcaster\"\nimport { AbstractSqliteQueryRunner } from \"../sqlite-abstract/AbstractSqliteQueryRunner\"\nimport type { CapacitorDriver } from \"./CapacitorDriver\"\n\n/**\n * Runs queries on a single sqlite database connection.\n */\nexport class CapacitorQueryRunner extends AbstractSqliteQueryRunner {\n    /**\n     * Database driver used by connection.\n     */\n    driver: CapacitorDriver\n\n    // -------------------------------------------------------------------------\n    // Constructor\n    // -------------------------------------------------------------------------\n\n    constructor(driver: CapacitorDriver) {\n        super()\n        this.driver = driver\n        this.dataSource = driver.dataSource\n        this.broadcaster = new Broadcaster(this)\n    }\n\n    /**\n     * Called before migrations are run.\n     */\n    async beforeMigration(): Promise<void> {\n        await this.query(`PRAGMA foreign_keys = OFF`)\n    }\n\n    /**\n     * Called after migrations are run.\n     */\n    async afterMigration(): Promise<void> {\n        await this.query(`PRAGMA foreign_keys = ON`)\n    }\n\n    async executeSet(set: { statement: string; values?: any[] }[]) {\n        if (this.isReleased) throw new QueryRunnerAlreadyReleasedError()\n\n        const databaseConnection = await this.connect()\n\n        return databaseConnection.executeSet(set, false)\n    }\n\n    /**\n     * Executes a given SQL query.\n     *\n     * @param query\n     * @param parameters\n     * @param useStructuredResult\n     */\n    async query(\n        query: string,\n        parameters?: any[],\n        useStructuredResult = false,\n    ): Promise<any> {\n        if (this.isReleased) throw new QueryRunnerAlreadyReleasedError()\n\n        const databaseConnection = await this.connect()\n\n        this.driver.dataSource.logger.logQuery(query, parameters, this)\n\n        const command = query.substring(\n            0,\n            query.indexOf(\" \") !== -1 ? query.indexOf(\" \") : undefined,\n        )\n\n        try {\n            let raw: any\n\n            if (\n                [\n                    \"BEGIN\",\n                    \"ROLLBACK\",\n                    \"COMMIT\",\n                    \"CREATE\",\n                    \"ALTER\",\n                    \"DROP\",\n                ].indexOf(command) !== -1\n            ) {\n                raw = await databaseConnection.execute(query, false)\n            } else if ([\"INSERT\", \"UPDATE\", \"DELETE\"].indexOf(command) !== -1) {\n                raw = await databaseConnection.run(query, parameters, false)\n            } else {\n                raw = await databaseConnection.query(query, parameters ?? [])\n            }\n\n            const result = new QueryResult()\n\n            if (raw?.hasOwnProperty(\"values\")) {\n                result.raw = raw.values\n                result.records = raw.values\n            }\n\n            if (raw?.hasOwnProperty(\"changes\")) {\n                result.affected = raw.changes.changes\n                result.raw = raw.changes.lastId ?? raw.changes.changes\n            }\n\n            if (!useStructuredResult) {\n                return result.raw\n            }\n\n            return result\n        } catch (err) {\n            this.driver.dataSource.logger.logQueryError(\n                err,\n                query,\n                parameters,\n                this,\n            )\n\n            throw new QueryFailedError(query, parameters, err)\n        }\n    }\n\n    // -------------------------------------------------------------------------\n    // Protected Methods\n    // -------------------------------------------------------------------------\n\n    /**\n     * Parametrizes given object of values. Used to create column=value queries.\n     *\n     * @param objectLiteral\n     */\n    protected parametrize(objectLiteral: ObjectLiteral): string[] {\n        return Object.keys(objectLiteral).map((key) => `\"${key}\"` + \"=?\")\n    }\n}\n"]}

package/browser/driver/cockroachdb/CockroachDataSourceOptions.d.ts

@@ -42,6 +42,7 @@ export interface CockroachDataSourceOptions extends BaseDataSourceOptions, Cockr
         readonly slaves: CockroachConnectionCredentialsOptions[];
         /**
          * Default connection pool to use for SELECT queries
+         *
          * @default "slave"
          */
         readonly defaultMode?: ReplicationMode;

package/browser/driver/cockroachdb/CockroachDataSourceOptions.js.map

@@ -1 +1 @@
-{"version":3,"file":"CockroachDataSourceOptions.js","sourceRoot":"../build/browser/src/","sources":["driver/cockroachdb/CockroachDataSourceOptions.ts"],"names":[],"mappings":"","sourcesContent":["import type { BaseDataSourceOptions } from \"../../data-source/BaseDataSourceOptions\"\nimport type { ReplicationMode } from \"../types/ReplicationMode\"\nimport type { CockroachConnectionCredentialsOptions } from \"./CockroachConnectionCredentialsOptions\"\n\n/**\n * Cockroachdb-specific connection options.\n */\nexport interface CockroachDataSourceOptions\n    extends BaseDataSourceOptions, CockroachConnectionCredentialsOptions {\n    /**\n     * Database type.\n     */\n    readonly type: \"cockroachdb\"\n\n    /**\n     * Enable time travel queries on cockroachdb.\n     * https://www.cockroachlabs.com/docs/stable/as-of-system-time.html\n     */\n    readonly timeTravelQueries: boolean\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     * Replication setup.\n     */\n    readonly replication?: {\n        /**\n         * Master server used by orm to perform writes.\n         */\n        readonly master: CockroachConnectionCredentialsOptions\n\n        /**\n         * List of read-from servers (slaves).\n         */\n        readonly slaves: CockroachConnectionCredentialsOptions[]\n\n        /**\n         * Default connection pool to use for SELECT queries\n         * @default \"slave\"\n         */\n        readonly defaultMode?: ReplicationMode\n    }\n\n    /**\n     * sets the application_name var to help db administrators identify\n     * the service using this connection. Defaults to 'undefined'\n     */\n    readonly applicationName?: string\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     * Max number of transaction retries in case of 40001 error.\n     */\n    readonly maxTransactionRetries?: number\n}\n"]}
+{"version":3,"file":"CockroachDataSourceOptions.js","sourceRoot":"../build/browser/src/","sources":["driver/cockroachdb/CockroachDataSourceOptions.ts"],"names":[],"mappings":"","sourcesContent":["import type { BaseDataSourceOptions } from \"../../data-source/BaseDataSourceOptions\"\nimport type { ReplicationMode } from \"../types/ReplicationMode\"\nimport type { CockroachConnectionCredentialsOptions } from \"./CockroachConnectionCredentialsOptions\"\n\n/**\n * Cockroachdb-specific connection options.\n */\nexport interface CockroachDataSourceOptions\n    extends BaseDataSourceOptions, CockroachConnectionCredentialsOptions {\n    /**\n     * Database type.\n     */\n    readonly type: \"cockroachdb\"\n\n    /**\n     * Enable time travel queries on cockroachdb.\n     * https://www.cockroachlabs.com/docs/stable/as-of-system-time.html\n     */\n    readonly timeTravelQueries: boolean\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     * Replication setup.\n     */\n    readonly replication?: {\n        /**\n         * Master server used by orm to perform writes.\n         */\n        readonly master: CockroachConnectionCredentialsOptions\n\n        /**\n         * List of read-from servers (slaves).\n         */\n        readonly slaves: CockroachConnectionCredentialsOptions[]\n\n        /**\n         * Default connection pool to use for SELECT queries\n         *\n         * @default \"slave\"\n         */\n        readonly defaultMode?: ReplicationMode\n    }\n\n    /**\n     * sets the application_name var to help db administrators identify\n     * the service using this connection. Defaults to 'undefined'\n     */\n    readonly applicationName?: string\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     * Max number of transaction retries in case of 40001 error.\n     */\n    readonly maxTransactionRetries?: number\n}\n"]}

package/browser/driver/cockroachdb/CockroachDriver.d.ts

@@ -15,6 +15,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 { CockroachConnectionCredentialsOptions } from "./CockroachConnectionCredentialsOptions";
 import type { CockroachDataSourceOptions } from "./CockroachDataSourceOptions";
@@ -23,12 +24,23 @@ import { CockroachQueryRunner } from "./CockroachQueryRunner";
  * Organizes communication with Cockroach DBMS.
  */
 export declare class CockroachDriver implements Driver {
+    /**
+     * Transaction isolation levels supported by this driver.
+     *
+     * @see https://www.cockroachlabs.com/docs/stable/transactions#isolation-levels
+     */
+    static readonly supportedIsolationLevels: IsolationLevel[];
     /**
      * DataSource used by the driver.
      */
     readonly 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;
@@ -84,6 +96,7 @@ export declare class CockroachDriver implements Driver {
     transactionSupport: "nested";
     /**
      * Gets list of supported column data types by a driver.
+     *
      * @see https://www.cockroachlabs.com/docs/stable/data-types.html
      */
     supportedDataTypes: ColumnType[];
@@ -148,17 +161,20 @@ export declare class CockroachDriver implements Driver {
     createSchemaBuilder(): RdbmsSchemaBuilder;
     /**
      * Creates a query runner used to execute database queries.
+     *
      * @param mode
      */
     createQueryRunner(mode: ReplicationMode): CockroachQueryRunner;
     /**
      * 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
      */
@@ -166,24 +182,28 @@ export declare class CockroachDriver 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): {
@@ -193,6 +213,7 @@ export declare class CockroachDriver implements Driver {
     };
     /**
      * Creates a database type from a given column metadata.
+     *
      * @param column
      * @param column.type
      * @param column.length
@@ -213,33 +234,39 @@ export declare class CockroachDriver 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;
@@ -259,6 +286,7 @@ export declare class CockroachDriver 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
      */
@@ -266,6 +294,7 @@ export declare class CockroachDriver implements Driver {
     /**
      * Differentiate columns of this table and columns from the given column metadatas columns
      * and returns only changed.
+     *
      * @param tableColumns
      * @param columnMetadatas
      */
@@ -273,6 +302,7 @@ export declare class CockroachDriver implements Driver {
     private lowerDefaultValueIfNecessary;
     /**
      * Returns true if driver supports RETURNING / OUTPUT statement.
+     *
      * @param _returningType
      */
     isReturningSqlSupported(_returningType: ReturningType): boolean;
@@ -286,6 +316,7 @@ export declare class CockroachDriver implements Driver {
     isFullTextColumnTypeSupported(): boolean;
     /**
      * Creates an escaped parameter.
+     *
      * @param parameterName
      * @param index
      */
@@ -300,22 +331,26 @@ export declare class CockroachDriver implements Driver {
     protected loadDependencies(): void;
     /**
      * Creates a new connection pool for a given database credentials.
+     *
      * @param options
      * @param credentials
      */
     protected createPool(options: CockroachDataSourceOptions, credentials: CockroachConnectionCredentialsOptions): Promise<any>;
     /**
      * Closes connection pool.
+     *
      * @param pool
      */
     protected closePool(pool: any): Promise<void>;
     /**
      * Escapes a given comment.
+     *
      * @param comment
      */
     protected escapeComment(comment?: string): string | undefined;
     /**
      * Builds ENUM type name from given table and column.
+     *
      * @param column
      */
     protected buildEnumName(column: ColumnMetadata): string;

package/browser/driver/cockroachdb/CockroachDriver.js

@@ -17,8 +17,23 @@ const CockroachQueryRunner_1 = require("./CockroachQueryRunner");
  * Organizes communication with Cockroach DBMS.
  */
 class CockroachDriver {
+    // -------------------------------------------------------------------------
+    // Static Properties
+    // -------------------------------------------------------------------------
+    /**
+     * Transaction isolation levels supported by this driver.
+     *
+     * @see https://www.cockroachlabs.com/docs/stable/transactions#isolation-levels
+     */
+    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 CockroachDriver {
     // Constructor
     // -------------------------------------------------------------------------
     constructor(dataSource) {
+        /**
+         * Isolation levels supported by this driver.
+         */
+        this.supportedIsolationLevels = CockroachDriver.supportedIsolationLevels;
         /**
          * Pool for slave databases.
          * Used in replication.
@@ -51,6 +70,7 @@ class CockroachDriver {
         this.transactionSupport = "nested";
         /**
          * Gets list of supported column data types by a driver.
+         *
          * @see https://www.cockroachlabs.com/docs/stable/data-types.html
          */
         this.supportedDataTypes = [
@@ -214,17 +234,11 @@ class CockroachDriver {
         }
         if (!this.database || !this.searchSchema) {
             const queryRunner = this.createQueryRunner("master");
-            if (!this.database) {
-                this.database = await queryRunner.getCurrentDatabase();
-            }
-            if (!this.searchSchema) {
-                this.searchSchema = await queryRunner.getCurrentSchema();
-            }
+            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).
@@ -258,6 +272,7 @@ class CockroachDriver {
     }
     /**
      * Creates a query runner used to execute database queries.
+     *
      * @param mode
      */
     createQueryRunner(mode) {
@@ -265,6 +280,7 @@ class CockroachDriver {
     }
     /**
      * Prepares given value to a value to be persisted, based on its column type and metadata.
+     *
      * @param value
      * @param columnMetadata
      */
@@ -305,6 +321,7 @@ class CockroachDriver {
     }
     /**
      * Prepares given value to a value to be persisted, based on its column type or metadata.
+     *
      * @param value
      * @param columnMetadata
      */
@@ -386,6 +403,7 @@ class CockroachDriver {
     /**
      * 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
      */
@@ -421,6 +439,7 @@ class CockroachDriver {
     }
     /**
      * Escapes a column name.
+     *
      * @param columnName
      */
     escape(columnName) {
@@ -429,6 +448,7 @@ class CockroachDriver {
     /**
      * Build full table name with schema name and table name.
      * E.g. myDB.mySchema.myTable
+     *
      * @param tableName
      * @param schema
      */
@@ -441,6 +461,7 @@ class CockroachDriver {
     }
     /**
      * Parse a target table name or other types and return a normalized table definition.
+     *
      * @param target
      */
     parseTableName(target) {
@@ -450,8 +471,8 @@ class CockroachDriver {
             // name is sometimes a path
             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,
             };
         }
@@ -459,30 +480,31 @@ class CockroachDriver {
             // referencedTableName is sometimes a path
             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
@@ -554,6 +576,7 @@ class CockroachDriver {
     }
     /**
      * Normalizes "default" value of the column.
+     *
      * @param columnMetadata
      */
     normalizeDefault(columnMetadata) {
@@ -615,6 +638,7 @@ class CockroachDriver {
     }
     /**
      * Compares "default" value of the column.
+     *
      * @param columnMetadata
      * @param tableColumn
      */
@@ -633,6 +657,7 @@ class CockroachDriver {
     }
     /**
      * Compares json/jsonb default values of the column.
+     *
      * @param columnMetadata
      * @param tableColumn
      */
@@ -668,6 +693,7 @@ class CockroachDriver {
     }
     /**
      * Normalizes "isUnique" value of the column.
+     *
      * @param column
      */
     normalizeIsUnique(column) {
@@ -675,6 +701,7 @@ class CockroachDriver {
     }
     /**
      * Returns default column lengths, which is required on column creation.
+     *
      * @param column
      */
     getColumnLength(column) {
@@ -682,6 +709,7 @@ class CockroachDriver {
     }
     /**
      * Creates column type definition including length, precision and scale
+     *
      * @param column
      */
     createFullType(column) {
@@ -758,6 +786,7 @@ class CockroachDriver {
      * 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
      */
@@ -775,6 +804,7 @@ class CockroachDriver {
     /**
      * Differentiate columns of this table and columns from the given column metadatas columns
      * and returns only changed.
+     *
      * @param tableColumns
      * @param columnMetadatas
      */
@@ -799,15 +829,15 @@ class CockroachDriver {
                 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.generatedType !== columnMetadata.generatedType ||
-                (tableColumn.asExpression || "").trim() !==
-                    (columnMetadata.asExpression || "").trim() ||
-                (tableColumn.spatialFeatureType || "").toLowerCase() !==
-                    (columnMetadata.spatialFeatureType || "").toLowerCase() ||
+                (tableColumn.asExpression ?? "").trim() !==
+                    (columnMetadata.asExpression ?? "").trim() ||
+                (tableColumn.spatialFeatureType ?? "").toLowerCase() !==
+                    (columnMetadata.spatialFeatureType ?? "").toLowerCase() ||
                 tableColumn.srid !== columnMetadata.srid);
         });
     }
@@ -824,6 +854,7 @@ class CockroachDriver {
     }
     /**
      * Returns true if driver supports RETURNING / OUTPUT statement.
+     *
      * @param _returningType
      */
     isReturningSqlSupported(_returningType) {
@@ -843,6 +874,7 @@ class CockroachDriver {
     }
     /**
      * Creates an escaped parameter.
+     *
      * @param parameterName
      * @param index
      */
@@ -872,10 +904,10 @@ class CockroachDriver {
      */
     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;
             }
@@ -888,6 +920,7 @@ class CockroachDriver {
     }
     /**
      * Creates a new connection pool for a given database credentials.
+     *
      * @param options
      * @param credentials
      */
@@ -903,11 +936,11 @@ class CockroachDriver {
             ssl: credentials.ssl,
             application_name: options.applicationName,
             max: options.poolSize,
-        }, options.extra || {});
+        }, options.extra ?? {});
         // create a connection pool
         const pool = new this.postgres.Pool(connectionOptions);
         const { logger } = this.dataSource;
-        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
@@ -925,6 +958,7 @@ class CockroachDriver {
     }
     /**
      * Closes connection pool.
+     *
      * @param pool
      */
     async closePool(pool) {
@@ -935,6 +969,7 @@ class CockroachDriver {
     }
     /**
      * Escapes a given comment.
+     *
      * @param comment
      */
     escapeComment(comment) {
@@ -945,13 +980,13 @@ class CockroachDriver {
     }
     /**
      * Builds ENUM type name from given table and column.
+     *
      * @param column
      */
     buildEnumName(column) {
         const { schema, tableName } = this.parseTableName(column.entityMetadata);
-        let enumName = column.enumName
-            ? column.enumName
-            : `${tableName}_${column.databaseName.toLowerCase()}_enum`;
+        let enumName = column.enumName ??
+            `${tableName}_${column.databaseName.toLowerCase()}_enum`;
         if (schema)
             enumName = `${schema}.${enumName}`;
         return enumName