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

package/driver/mysql/MysqlDriver.js

@@ -17,8 +17,23 @@ const MysqlQueryRunner_1 = require("./MysqlQueryRunner");
  * Organizes communication with MySQL DBMS.
  */
 class MysqlDriver {
+    // -------------------------------------------------------------------------
+    // Static Properties
+    // -------------------------------------------------------------------------
+    /**
+     * Transaction isolation levels supported by this driver.
+     *
+     * @see https://dev.mysql.com/doc/refman/8.0/en/innodb-transaction-isolation-levels.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 MysqlDriver {
     // Constructor
     // -------------------------------------------------------------------------
     constructor(dataSource) {
+        /**
+         * Isolation levels supported by this driver.
+         */
+        this.supportedIsolationLevels = MysqlDriver.supportedIsolationLevels;
         /**
          * Indicates if replication is enabled.
          */
@@ -42,6 +61,7 @@ class MysqlDriver {
         this.transactionSupport = "nested";
         /**
          * Gets list of supported column data types by a driver.
+         *
          * @see https://www.tutorialspoint.com/mysql/mysql-data-types.htm
          * @see https://dev.mysql.com/doc/refman/8.0/en/data-types.html
          */
@@ -220,6 +240,7 @@ class MysqlDriver {
         };
         /**
          * Max length allowed by MySQL for aliases.
+         *
          * @see https://dev.mysql.com/doc/refman/5.5/en/identifiers.html
          */
         this.maxAliasLength = 63;
@@ -342,6 +363,7 @@ class MysqlDriver {
     }
     /**
      * Creates a query runner used to execute database queries.
+     *
      * @param mode
      */
     createQueryRunner(mode) {
@@ -350,6 +372,7 @@ class MysqlDriver {
     /**
      * 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
      */
@@ -380,6 +403,7 @@ class MysqlDriver {
     }
     /**
      * Escapes a column name.
+     *
      * @param columnName
      */
     escape(columnName) {
@@ -388,6 +412,7 @@ class MysqlDriver {
     /**
      * Build full table name with database name, schema name and table name.
      * E.g. myDB.mySchema.myTable
+     *
      * @param tableName
      * @param schema
      * @param database
@@ -401,6 +426,7 @@ class MysqlDriver {
     }
     /**
      * Parse a target table name or other types and return a normalized table definition.
+     *
      * @param target
      */
     parseTableName(target) {
@@ -409,38 +435,39 @@ class MysqlDriver {
         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: (parts.length > 1 ? parts[0] : undefined) || driverDatabase,
+            database: (parts.length > 1 ? parts[0] : undefined) ?? driverDatabase,
             schema: driverSchema,
             tableName: parts.length > 1 ? parts[1] : parts[0],
         };
     }
     /**
      * Prepares given value to a value to be persisted, based on its column type and metadata.
+     *
      * @param value
      * @param columnMetadata
      */
@@ -489,6 +516,7 @@ class MysqlDriver {
     }
     /**
      * Prepares given value to a value to be persisted, based on its column type or metadata.
+     *
      * @param value
      * @param columnMetadata
      */
@@ -558,6 +586,7 @@ class MysqlDriver {
     }
     /**
      * Creates a database type from a given column metadata.
+     *
      * @param column
      * @param column.type
      * @param column.length
@@ -628,6 +657,7 @@ class MysqlDriver {
     }
     /**
      * Normalizes "default" value of the column.
+     *
      * @param columnMetadata
      */
     normalizeDefault(columnMetadata) {
@@ -661,6 +691,7 @@ class MysqlDriver {
     }
     /**
      * Normalizes "isUnique" value of the column.
+     *
      * @param column
      */
     normalizeIsUnique(column) {
@@ -670,6 +701,7 @@ class MysqlDriver {
     }
     /**
      * Returns default column lengths, which is required on column creation.
+     *
      * @param column
      */
     getColumnLength(column) {
@@ -696,6 +728,7 @@ class MysqlDriver {
     }
     /**
      * Creates column type definition including length, precision and scale
+     *
      * @param column
      */
     createFullType(column) {
@@ -771,6 +804,7 @@ class MysqlDriver {
     }
     /**
      * Creates generated map of values generated or returned by database after INSERT query.
+     *
      * @param metadata
      * @param insertResult
      * @param entityIndex
@@ -807,6 +841,7 @@ class MysqlDriver {
     /**
      * Differentiate columns of this table and columns from the given column metadatas columns
      * and returns only changed.
+     *
      * @param tableColumns
      * @param columnMetadatas
      */
@@ -828,7 +863,7 @@ class MysqlDriver {
                 tableColumn.comment !==
                     this.escapeComment(columnMetadata.comment) ||
                 !this.compareDefaultValues(this.normalizeDefault(columnMetadata), tableColumn.default) ||
-                (tableColumn.enum &&
+                !!(tableColumn.enum &&
                     columnMetadata.enum &&
                     !OrmUtils_1.OrmUtils.isArraysEqual(tableColumn.enum, columnMetadata.enum.map((val) => val + ""))) ||
                 tableColumn.onUpdate !==
@@ -844,6 +879,7 @@ class MysqlDriver {
     }
     /**
      * Returns true if driver supports RETURNING / OUTPUT statement.
+     *
      * @param returningType
      */
     isReturningSqlSupported(returningType) {
@@ -863,6 +899,7 @@ class MysqlDriver {
     }
     /**
      * Creates an escaped parameter.
+     *
      * @param parameterName
      * @param index
      */
@@ -877,7 +914,7 @@ class MysqlDriver {
      */
     loadDependencies() {
         try {
-            this.mysql = this.options.driver || PlatformTools_1.PlatformTools.load("mysql2");
+            this.mysql = this.options.driver ?? PlatformTools_1.PlatformTools.load("mysql2");
         }
         catch (e) {
             throw new DriverPackageNotInstalledError_1.DriverPackageNotInstalledError("Mysql", "mysql2");
@@ -885,6 +922,7 @@ class MysqlDriver {
     }
     /**
      * Creates a new connection pool for a given database credentials.
+     *
      * @param options
      * @param credentials
      */
@@ -896,12 +934,8 @@ class MysqlDriver {
             timezone: options.timezone,
             connectTimeout: options.connectTimeout,
             insecureAuth: options.insecureAuth,
-            supportBigNumbers: options.supportBigNumbers !== undefined
-                ? options.supportBigNumbers
-                : true,
-            bigNumberStrings: options.bigNumberStrings !== undefined
-                ? options.bigNumberStrings
-                : true,
+            supportBigNumbers: options.supportBigNumbers ?? true,
+            bigNumberStrings: options.bigNumberStrings ?? true,
             dateStrings: options.dateStrings,
             debug: options.debug,
             trace: options.trace,
@@ -919,10 +953,11 @@ class MysqlDriver {
             connectionLimit: credentials.poolSize ?? options.poolSize,
         }, options.acquireTimeout === undefined
             ? {}
-            : { acquireTimeout: options.acquireTimeout }, options.extra || {});
+            : { acquireTimeout: options.acquireTimeout }, options.extra ?? {});
     }
     /**
      * Creates a new connection pool for a given database credentials.
+     *
      * @param connectionOptions
      */
     createPool(connectionOptions) {
@@ -942,6 +977,7 @@ class MysqlDriver {
     }
     /**
      * Attaches all required base handlers to a database connection, such as the unhandled error handler.
+     *
      * @param connection
      */
     prepareDbConnection(connection) {
@@ -957,6 +993,7 @@ class MysqlDriver {
     }
     /**
      * Checks if "DEFAULT" values in the column metadata and in the database are equal.
+     *
      * @param columnMetadataValue
      * @param databaseValue
      */
@@ -981,6 +1018,7 @@ class MysqlDriver {
     /**
      * If parameter is a datetime function, e.g. "CURRENT_TIMESTAMP", normalizes it.
      * Otherwise returns original input.
+     *
      * @param value
      */
     normalizeDatetimeFunction(value) {
@@ -1009,6 +1047,7 @@ class MysqlDriver {
     }
     /**
      * Escapes a given comment.
+     *
      * @param comment
      */
     escapeComment(comment) {
@@ -1021,6 +1060,7 @@ class MysqlDriver {
      * A helper to check if column data types have changed
      * This can be used to manage checking any types the
      * database may alias
+     *
      * @param tableColumn
      * @param columnMetadata
      */