typeorm 0.3.0-rc.9 → 0.3.0

package/browser/driver/mysql/MysqlDriver.js

@@ -1,4 +1,3 @@
-import * as tslib_1 from "tslib";
 import { ConnectionIsNotSetError } from "../../error/ConnectionIsNotSetError";
 import { DriverPackageNotInstalledError } from "../../error/DriverPackageNotInstalledError";
 import { DriverUtils } from "../DriverUtils";
@@ -8,14 +7,17 @@ import { PlatformTools } from "../../platform/PlatformTools";
 import { RdbmsSchemaBuilder } from "../../schema-builder/RdbmsSchemaBuilder";
 import { OrmUtils } from "../../util/OrmUtils";
 import { ApplyValueTransformers } from "../../util/ApplyValueTransformers";
+import { TypeORMError } from "../../error";
+import { VersionUtils } from "../../util/VersionUtils";
+import { InstanceChecker } from "../../util/InstanceChecker";
 /**
  * Organizes communication with MySQL DBMS.
  */
-var MysqlDriver = /** @class */ (function () {
+export class MysqlDriver {
     // -------------------------------------------------------------------------
     // Constructor
     // -------------------------------------------------------------------------
-    function MysqlDriver(connection) {
+    constructor(connection) {
         /**
          * Indicates if replication is enabled.
          */
@@ -24,6 +26,10 @@ var MysqlDriver = /** @class */ (function () {
          * Indicates if tree tables are supported by this driver.
          */
         this.treeSupport = true;
+        /**
+         * Represent transaction support by this driver
+         */
+        this.transactionSupport = "nested";
         /**
          * Gets list of supported column data types by a driver.
          *
@@ -84,8 +90,12 @@ var MysqlDriver = /** @class */ (function () {
             "multipoint",
             "multilinestring",
             "multipolygon",
-            "geometrycollection"
+            "geometrycollection",
         ];
+        /**
+         * Returns type of upsert supported by driver if any
+         */
+        this.supportedUpsertType = "on-duplicate-key-update";
         /**
          * Gets list of spatial column data types.
          */
@@ -97,7 +107,7 @@ var MysqlDriver = /** @class */ (function () {
             "multipoint",
             "multilinestring",
             "multipolygon",
-            "geometrycollection"
+            "geometrycollection",
         ];
         /**
          * Gets list of column data types that support length by a driver.
@@ -107,7 +117,7 @@ var MysqlDriver = /** @class */ (function () {
             "varchar",
             "nvarchar",
             "binary",
-            "varbinary"
+            "varbinary",
         ];
         /**
          * Gets list of column data types that support length by a driver.
@@ -119,7 +129,7 @@ var MysqlDriver = /** @class */ (function () {
             "mediumint",
             "int",
             "integer",
-            "bigint"
+            "bigint",
         ];
         /**
          * Gets list of column data types that support precision by a driver.
@@ -135,7 +145,7 @@ var MysqlDriver = /** @class */ (function () {
             "real",
             "time",
             "datetime",
-            "timestamp"
+            "timestamp",
         ];
         /**
          * Gets list of column data types that supports scale by a driver.
@@ -148,7 +158,7 @@ var MysqlDriver = /** @class */ (function () {
             "float",
             "double",
             "double precision",
-            "real"
+            "real",
         ];
         /**
          * Gets list of column data types that supports UNSIGNED and ZEROFILL attributes.
@@ -167,7 +177,7 @@ var MysqlDriver = /** @class */ (function () {
             "float",
             "double",
             "double precision",
-            "real"
+            "real",
         ];
         /**
          * ORM has special columns and we need to know what database column types should be for those columns.
@@ -180,6 +190,9 @@ var MysqlDriver = /** @class */ (function () {
             updateDate: "datetime",
             updateDatePrecision: 6,
             updateDateDefault: "CURRENT_TIMESTAMP(6)",
+            deleteDate: "datetime",
+            deleteDatePrecision: 6,
+            deleteDateNullable: true,
             version: "int",
             treeLevel: "int",
             migrationId: "int",
@@ -203,40 +216,53 @@ var MysqlDriver = /** @class */ (function () {
          * Used in the cases when length/precision/scale is not specified by user.
          */
         this.dataTypeDefaults = {
-            "varchar": { length: 255 },
-            "nvarchar": { length: 255 },
+            varchar: { length: 255 },
+            nvarchar: { length: 255 },
             "national varchar": { length: 255 },
-            "char": { length: 1 },
-            "binary": { length: 1 },
-            "varbinary": { length: 255 },
-            "decimal": { precision: 10, scale: 0 },
-            "dec": { precision: 10, scale: 0 },
-            "numeric": { precision: 10, scale: 0 },
-            "fixed": { precision: 10, scale: 0 },
-            "float": { precision: 12 },
-            "double": { precision: 22 },
-            "time": { precision: 0 },
-            "datetime": { precision: 0 },
-            "timestamp": { precision: 0 },
-            "bit": { width: 1 },
-            "int": { width: 11 },
-            "integer": { width: 11 },
-            "tinyint": { width: 4 },
-            "smallint": { width: 6 },
-            "mediumint": { width: 9 },
-            "bigint": { width: 20 }
+            char: { length: 1 },
+            binary: { length: 1 },
+            varbinary: { length: 255 },
+            decimal: { precision: 10, scale: 0 },
+            dec: { precision: 10, scale: 0 },
+            numeric: { precision: 10, scale: 0 },
+            fixed: { precision: 10, scale: 0 },
+            float: { precision: 12 },
+            double: { precision: 22 },
+            time: { precision: 0 },
+            datetime: { precision: 0 },
+            timestamp: { precision: 0 },
+            bit: { width: 1 },
+            int: { width: 11 },
+            integer: { width: 11 },
+            tinyint: { width: 4 },
+            smallint: { width: 6 },
+            mediumint: { width: 9 },
+            bigint: { width: 20 },
         };
         /**
          * Max length allowed by MySQL for aliases.
          * @see https://dev.mysql.com/doc/refman/5.5/en/identifiers.html
          */
         this.maxAliasLength = 63;
+        /**
+         * Supported returning types
+         */
+        this._isReturningSqlSupported = {
+            delete: false,
+            insert: false,
+            update: false,
+        };
         this.connection = connection;
-        this.options = tslib_1.__assign({ legacySpatialSupport: true }, connection.options);
+        this.options = {
+            legacySpatialSupport: true,
+            ...connection.options,
+        };
         this.isReplicated = this.options.replication ? true : false;
         // load mysql package
         this.loadDependencies();
-        this.database = this.options.replication ? this.options.replication.master.database : this.options.database;
+        this.database = DriverUtils.buildDriverOptions(this.options.replication
+            ? this.options.replication.master
+            : this.options).database;
         // validate options to make sure everything is set
         // todo: revisit validation with replication in mind
         // if (!(this.options.host || (this.options.extra && this.options.extra.socketPath)) && !this.options.socketPath)
@@ -254,123 +280,163 @@ var MysqlDriver = /** @class */ (function () {
     /**
      * Performs connection to the database.
      */
-    MysqlDriver.prototype.connect = function () {
-        return tslib_1.__awaiter(this, void 0, void 0, function () {
-            var _a;
-            var _this = this;
-            return tslib_1.__generator(this, function (_b) {
-                switch (_b.label) {
-                    case 0:
-                        if (!this.options.replication) return [3 /*break*/, 1];
-                        this.poolCluster = this.mysql.createPoolCluster(this.options.replication);
-                        this.options.replication.slaves.forEach(function (slave, index) {
-                            _this.poolCluster.add("SLAVE" + index, _this.createConnectionOptions(_this.options, slave));
-                        });
-                        this.poolCluster.add("MASTER", this.createConnectionOptions(this.options, this.options.replication.master));
-                        return [3 /*break*/, 3];
-                    case 1:
-                        _a = this;
-                        return [4 /*yield*/, this.createPool(this.createConnectionOptions(this.options, this.options))];
-                    case 2:
-                        _a.pool = _b.sent();
-                        _b.label = 3;
-                    case 3: return [2 /*return*/];
-                }
+    async connect() {
+        if (this.options.replication) {
+            this.poolCluster = this.mysql.createPoolCluster(this.options.replication);
+            this.options.replication.slaves.forEach((slave, index) => {
+                this.poolCluster.add("SLAVE" + index, this.createConnectionOptions(this.options, slave));
             });
-        });
-    };
+            this.poolCluster.add("MASTER", this.createConnectionOptions(this.options, this.options.replication.master));
+        }
+        else {
+            this.pool = await this.createPool(this.createConnectionOptions(this.options, this.options));
+        }
+        if (!this.database) {
+            const queryRunner = await this.createQueryRunner("master");
+            this.database = await queryRunner.getCurrentDatabase();
+            await queryRunner.release();
+        }
+        if (this.options.type === "mariadb") {
+            const result = (await this.createQueryRunner("master").query(`SELECT VERSION() AS \`version\``));
+            const dbVersion = result[0].version;
+            if (VersionUtils.isGreaterOrEqual(dbVersion, "10.0.5")) {
+                this._isReturningSqlSupported.delete = true;
+            }
+            if (VersionUtils.isGreaterOrEqual(dbVersion, "10.5.0")) {
+                this._isReturningSqlSupported.insert = true;
+            }
+        }
+    }
     /**
      * Makes any action after connection (e.g. create extensions in Postgres driver).
      */
-    MysqlDriver.prototype.afterConnect = function () {
+    afterConnect() {
         return Promise.resolve();
-    };
+    }
     /**
      * Closes connection with the database.
      */
-    MysqlDriver.prototype.disconnect = function () {
-        return tslib_1.__awaiter(this, void 0, void 0, function () {
-            var _this = this;
-            return tslib_1.__generator(this, function (_a) {
-                if (!this.poolCluster && !this.pool)
-                    return [2 /*return*/, Promise.reject(new ConnectionIsNotSetError("mysql"))];
-                if (this.poolCluster) {
-                    return [2 /*return*/, new Promise(function (ok, fail) {
-                            _this.poolCluster.end(function (err) { return err ? fail(err) : ok(); });
-                            _this.poolCluster = undefined;
-                        })];
-                }
-                if (this.pool) {
-                    return [2 /*return*/, new Promise(function (ok, fail) {
-                            _this.pool.end(function (err) {
-                                if (err)
-                                    return fail(err);
-                                _this.pool = undefined;
-                                ok();
-                            });
-                        })];
-                }
-                return [2 /*return*/];
+    async disconnect() {
+        if (!this.poolCluster && !this.pool)
+            return Promise.reject(new ConnectionIsNotSetError("mysql"));
+        if (this.poolCluster) {
+            return new Promise((ok, fail) => {
+                this.poolCluster.end((err) => (err ? fail(err) : ok()));
+                this.poolCluster = undefined;
             });
-        });
-    };
+        }
+        if (this.pool) {
+            return new Promise((ok, fail) => {
+                this.pool.end((err) => {
+                    if (err)
+                        return fail(err);
+                    this.pool = undefined;
+                    ok();
+                });
+            });
+        }
+    }
     /**
      * Creates a schema builder used to build and sync a schema.
      */
-    MysqlDriver.prototype.createSchemaBuilder = function () {
+    createSchemaBuilder() {
         return new RdbmsSchemaBuilder(this.connection);
-    };
+    }
     /**
      * Creates a query runner used to execute database queries.
      */
-    MysqlDriver.prototype.createQueryRunner = function (mode) {
-        if (mode === void 0) { mode = "master"; }
+    createQueryRunner(mode) {
         return new MysqlQueryRunner(this, mode);
-    };
+    }
     /**
      * Replaces parameters in the given sql with special escaping character
      * and an array of parameter names to be passed to a query.
      */
-    MysqlDriver.prototype.escapeQueryWithParameters = function (sql, parameters, nativeParameters) {
-        var escapedParameters = Object.keys(nativeParameters).map(function (key) { return nativeParameters[key]; });
+    escapeQueryWithParameters(sql, parameters, nativeParameters) {
+        const escapedParameters = Object.keys(nativeParameters).map((key) => nativeParameters[key]);
         if (!parameters || !Object.keys(parameters).length)
             return [sql, escapedParameters];
-        var keys = Object.keys(parameters).map(function (parameter) { return "(:(\\.\\.\\.)?" + parameter + "\\b)"; }).join("|");
-        sql = sql.replace(new RegExp(keys, "g"), function (key) {
-            var value;
-            if (key.substr(0, 4) === ":...") {
-                value = parameters[key.substr(4)];
+        sql = sql.replace(/:(\.\.\.)?([A-Za-z0-9_.]+)/g, (full, isArray, key) => {
+            if (!parameters.hasOwnProperty(key)) {
+                return full;
             }
-            else {
-                value = parameters[key.substr(1)];
+            let value = parameters[key];
+            if (isArray) {
+                return value
+                    .map((v) => {
+                    escapedParameters.push(v);
+                    return this.createParameter(key, escapedParameters.length - 1);
+                })
+                    .join(", ");
             }
-            if (value instanceof Function) {
+            if (typeof value === "function") {
                 return value();
             }
-            else {
-                escapedParameters.push(value);
-                return "?";
-            }
+            escapedParameters.push(value);
+            return this.createParameter(key, escapedParameters.length - 1);
         }); // todo: make replace only in value statements, otherwise problems
         return [sql, escapedParameters];
-    };
+    }
     /**
      * Escapes a column name.
      */
-    MysqlDriver.prototype.escape = function (columnName) {
+    escape(columnName) {
         return "`" + columnName + "`";
-    };
+    }
     /**
      * Build full table name with database name, schema name and table name.
-     * E.g. "myDB"."mySchema"."myTable"
+     * E.g. myDB.mySchema.myTable
      */
-    MysqlDriver.prototype.buildTableName = function (tableName, schema, database) {
-        return database ? database + "." + tableName : tableName;
-    };
+    buildTableName(tableName, schema, database) {
+        let tablePath = [tableName];
+        if (database) {
+            tablePath.unshift(database);
+        }
+        return tablePath.join(".");
+    }
+    /**
+     * Parse a target table name or other types and return a normalized table definition.
+     */
+    parseTableName(target) {
+        const driverDatabase = this.database;
+        const driverSchema = undefined;
+        if (InstanceChecker.isTable(target) || InstanceChecker.isView(target)) {
+            const parsed = this.parseTableName(target.name);
+            return {
+                database: target.database || parsed.database || driverDatabase,
+                schema: target.schema || parsed.schema || driverSchema,
+                tableName: parsed.tableName,
+            };
+        }
+        if (InstanceChecker.isTableForeignKey(target)) {
+            const parsed = this.parseTableName(target.referencedTableName);
+            return {
+                database: target.referencedDatabase ||
+                    parsed.database ||
+                    driverDatabase,
+                schema: target.referencedSchema || parsed.schema || driverSchema,
+                tableName: parsed.tableName,
+            };
+        }
+        if (InstanceChecker.isEntityMetadata(target)) {
+            // EntityMetadata tableName is never a path
+            return {
+                database: target.database || driverDatabase,
+                schema: target.schema || driverSchema,
+                tableName: target.tableName,
+            };
+        }
+        const parts = target.split(".");
+        return {
+            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.
      */
-    MysqlDriver.prototype.preparePersistentValue = function (value, columnMetadata) {
+    preparePersistentValue(value, columnMetadata) {
         if (columnMetadata.transformer)
             value = ApplyValueTransformers.transformTo(columnMetadata.transformer, value);
         if (value === null || value === undefined)
@@ -387,7 +453,9 @@ var MysqlDriver = /** @class */ (function () {
         else if (columnMetadata.type === "json") {
             return JSON.stringify(value);
         }
-        else if (columnMetadata.type === "timestamp" || columnMetadata.type === "datetime" || columnMetadata.type === Date) {
+        else if (columnMetadata.type === "timestamp" ||
+            columnMetadata.type === "datetime" ||
+            columnMetadata.type === Date) {
             return DateUtils.mixedDateToDate(value);
         }
         else if (columnMetadata.type === "simple-array") {
@@ -396,24 +464,30 @@ var MysqlDriver = /** @class */ (function () {
         else if (columnMetadata.type === "simple-json") {
             return DateUtils.simpleJsonToString(value);
         }
-        else if (columnMetadata.type === "enum" || columnMetadata.type === "simple-enum") {
+        else if (columnMetadata.type === "enum" ||
+            columnMetadata.type === "simple-enum") {
             return "" + value;
         }
         else if (columnMetadata.type === "set") {
             return DateUtils.simpleArrayToString(value);
         }
         return value;
-    };
+    }
     /**
      * Prepares given value to a value to be persisted, based on its column type or metadata.
      */
-    MysqlDriver.prototype.prepareHydratedValue = function (value, columnMetadata) {
+    prepareHydratedValue(value, columnMetadata) {
         if (value === null || value === undefined)
-            return columnMetadata.transformer ? ApplyValueTransformers.transformFrom(columnMetadata.transformer, value) : value;
-        if (columnMetadata.type === Boolean || columnMetadata.type === "bool" || columnMetadata.type === "boolean") {
+            return columnMetadata.transformer
+                ? ApplyValueTransformers.transformFrom(columnMetadata.transformer, value)
+                : value;
+        if (columnMetadata.type === Boolean ||
+            columnMetadata.type === "bool" ||
+            columnMetadata.type === "boolean") {
             value = value ? true : false;
         }
-        else if (columnMetadata.type === "datetime" || columnMetadata.type === Date) {
+        else if (columnMetadata.type === "datetime" ||
+            columnMetadata.type === Date) {
             value = DateUtils.normalizeHydratedDate(value);
         }
         else if (columnMetadata.type === "date") {
@@ -431,10 +505,11 @@ var MysqlDriver = /** @class */ (function () {
         else if (columnMetadata.type === "simple-json") {
             value = DateUtils.stringToSimpleJson(value);
         }
-        else if ((columnMetadata.type === "enum" || columnMetadata.type === "simple-enum")
-            && columnMetadata.enum
-            && !isNaN(value)
-            && columnMetadata.enum.indexOf(parseInt(value)) >= 0) {
+        else if ((columnMetadata.type === "enum" ||
+            columnMetadata.type === "simple-enum") &&
+            columnMetadata.enum &&
+            !isNaN(value) &&
+            columnMetadata.enum.indexOf(parseInt(value)) >= 0) {
             // convert to number if that exists in possible enum options
             value = parseInt(value);
         }
@@ -444,11 +519,11 @@ var MysqlDriver = /** @class */ (function () {
         if (columnMetadata.transformer)
             value = ApplyValueTransformers.transformFrom(columnMetadata.transformer, value);
         return value;
-    };
+    }
     /**
      * Creates a database type from a given column metadata.
      */
-    MysqlDriver.prototype.normalizeType = function (column) {
+    normalizeType(column) {
         if (column.type === Number || column.type === "integer") {
             return "int";
         }
@@ -467,22 +542,36 @@ var MysqlDriver = /** @class */ (function () {
         else if (column.type === "uuid") {
             return "varchar";
         }
-        else if (column.type === "simple-array" || column.type === "simple-json") {
+        else if (column.type === "json" && this.options.type === "mariadb") {
+            /*
+             * MariaDB implements this as a LONGTEXT rather, as the JSON data type contradicts the SQL standard,
+             * and MariaDB's benchmarks indicate that performance is at least equivalent.
+             *
+             * @see https://mariadb.com/kb/en/json-data-type/
+             */
+            return "longtext";
+        }
+        else if (column.type === "simple-array" ||
+            column.type === "simple-json") {
             return "text";
         }
         else if (column.type === "simple-enum") {
             return "enum";
         }
-        else if (column.type === "double precision" || column.type === "real") {
+        else if (column.type === "double precision" ||
+            column.type === "real") {
             return "double";
         }
-        else if (column.type === "dec" || column.type === "numeric" || column.type === "fixed") {
+        else if (column.type === "dec" ||
+            column.type === "numeric" ||
+            column.type === "fixed") {
             return "decimal";
         }
         else if (column.type === "bool" || column.type === "boolean") {
             return "tinyint";
         }
-        else if (column.type === "nvarchar" || column.type === "national varchar") {
+        else if (column.type === "nvarchar" ||
+            column.type === "national varchar") {
             return "varchar";
         }
         else if (column.type === "nchar" || column.type === "national char") {
@@ -491,47 +580,51 @@ var MysqlDriver = /** @class */ (function () {
         else {
             return column.type || "";
         }
-    };
+    }
     /**
      * Normalizes "default" value of the column.
      */
-    MysqlDriver.prototype.normalizeDefault = function (columnMetadata) {
-        var defaultValue = columnMetadata.default;
-        if ((columnMetadata.type === "enum" || columnMetadata.type === "simple-enum") && defaultValue !== undefined) {
-            return "'" + defaultValue + "'";
-        }
-        if ((columnMetadata.type === "set") && defaultValue !== undefined) {
-            return "'" + DateUtils.simpleArrayToString(defaultValue) + "'";
+    normalizeDefault(columnMetadata) {
+        const defaultValue = columnMetadata.default;
+        if (defaultValue === null) {
+            return undefined;
         }
-        if (typeof defaultValue === "number") {
-            return "" + defaultValue;
+        if ((columnMetadata.type === "enum" ||
+            columnMetadata.type === "simple-enum" ||
+            typeof defaultValue === "string") &&
+            defaultValue !== undefined) {
+            return `'${defaultValue}'`;
         }
-        else if (typeof defaultValue === "boolean") {
-            return defaultValue === true ? "1" : "0";
+        if (columnMetadata.type === "set" && defaultValue !== undefined) {
+            return `'${DateUtils.simpleArrayToString(defaultValue)}'`;
         }
-        else if (typeof defaultValue === "function") {
-            return defaultValue();
+        if (typeof defaultValue === "number") {
+            return `'${defaultValue.toFixed(columnMetadata.scale)}'`;
         }
-        else if (typeof defaultValue === "string") {
-            return "'" + defaultValue + "'";
+        if (typeof defaultValue === "boolean") {
+            return defaultValue ? "1" : "0";
         }
-        else if (defaultValue === null) {
-            return "null";
+        if (typeof defaultValue === "function") {
+            const value = defaultValue();
+            return this.normalizeDatetimeFunction(value);
         }
-        else {
-            return defaultValue;
+        if (defaultValue === undefined) {
+            return undefined;
         }
-    };
+        return `${defaultValue}`;
+    }
     /**
      * Normalizes "isUnique" value of the column.
      */
-    MysqlDriver.prototype.normalizeIsUnique = function (column) {
-        return column.entityMetadata.indices.some(function (idx) { return idx.isUnique && idx.columns.length === 1 && idx.columns[0] === column; });
-    };
+    normalizeIsUnique(column) {
+        return column.entityMetadata.indices.some((idx) => idx.isUnique &&
+            idx.columns.length === 1 &&
+            idx.columns[0] === column);
+    }
     /**
      * Returns default column lengths, which is required on column creation.
      */
-    MysqlDriver.prototype.getColumnLength = function (column) {
+    getColumnLength(column) {
         if (column.length)
             return column.length.toString();
         /**
@@ -550,75 +643,95 @@ var MysqlDriver = /** @class */ (function () {
             default:
                 return "";
         }
-    };
+    }
     /**
      * Creates column type definition including length, precision and scale
      */
-    MysqlDriver.prototype.createFullType = function (column) {
-        var type = column.type;
+    createFullType(column) {
+        let type = column.type;
         // used 'getColumnLength()' method, because MySQL requires column length for `varchar`, `nvarchar` and `varbinary` data types
         if (this.getColumnLength(column)) {
-            type += "(" + this.getColumnLength(column) + ")";
+            type += `(${this.getColumnLength(column)})`;
         }
         else if (column.width) {
-            type += "(" + column.width + ")";
+            type += `(${column.width})`;
         }
-        else if (column.precision !== null && column.precision !== undefined && column.scale !== null && column.scale !== undefined) {
-            type += "(" + column.precision + "," + column.scale + ")";
+        else if (column.precision !== null &&
+            column.precision !== undefined &&
+            column.scale !== null &&
+            column.scale !== undefined) {
+            type += `(${column.precision},${column.scale})`;
         }
-        else if (column.precision !== null && column.precision !== undefined) {
-            type += "(" + column.precision + ")";
+        else if (column.precision !== null &&
+            column.precision !== undefined) {
+            type += `(${column.precision})`;
         }
         if (column.isArray)
             type += " array";
         return type;
-    };
+    }
     /**
      * Obtains a new database connection to a master server.
      * Used for replication.
      * If replication is not setup then returns default connection's database connection.
      */
-    MysqlDriver.prototype.obtainMasterConnection = function () {
-        var _this = this;
-        return new Promise(function (ok, fail) {
-            if (_this.poolCluster) {
-                _this.poolCluster.getConnection("MASTER", function (err, dbConnection) {
-                    err ? fail(err) : ok(_this.prepareDbConnection(dbConnection));
+    obtainMasterConnection() {
+        return new Promise((ok, fail) => {
+            if (this.poolCluster) {
+                this.poolCluster.getConnection("MASTER", (err, dbConnection) => {
+                    err
+                        ? fail(err)
+                        : ok(this.prepareDbConnection(dbConnection));
                 });
             }
-            else if (_this.pool) {
-                _this.pool.getConnection(function (err, dbConnection) {
-                    err ? fail(err) : ok(_this.prepareDbConnection(dbConnection));
+            else if (this.pool) {
+                this.pool.getConnection((err, dbConnection) => {
+                    err ? fail(err) : ok(this.prepareDbConnection(dbConnection));
                 });
             }
             else {
-                fail(new Error("Connection is not established with mysql database"));
+                fail(new TypeORMError(`Connection is not established with mysql database`));
             }
         });
-    };
+    }
     /**
      * Obtains a new database connection to a slave server.
      * Used for replication.
      * If replication is not setup then returns master (default) connection's database connection.
      */
-    MysqlDriver.prototype.obtainSlaveConnection = function () {
-        var _this = this;
+    obtainSlaveConnection() {
         if (!this.poolCluster)
             return this.obtainMasterConnection();
-        return new Promise(function (ok, fail) {
-            _this.poolCluster.getConnection("SLAVE*", function (err, dbConnection) {
-                err ? fail(err) : ok(dbConnection);
+        return new Promise((ok, fail) => {
+            this.poolCluster.getConnection("SLAVE*", (err, dbConnection) => {
+                err ? fail(err) : ok(this.prepareDbConnection(dbConnection));
             });
         });
-    };
+    }
     /**
      * Creates generated map of values generated or returned by database after INSERT query.
      */
-    MysqlDriver.prototype.createGeneratedMap = function (metadata, insertResult) {
-        var generatedMap = metadata.generatedColumns.reduce(function (map, generatedColumn) {
-            var value;
-            if (generatedColumn.generationStrategy === "increment" && insertResult.insertId) {
-                value = insertResult.insertId;
+    createGeneratedMap(metadata, insertResult, entityIndex) {
+        if (!insertResult) {
+            return undefined;
+        }
+        if (insertResult.insertId === undefined) {
+            return Object.keys(insertResult).reduce((map, key) => {
+                const column = metadata.findColumnWithDatabaseName(key);
+                if (column) {
+                    OrmUtils.mergeDeep(map, column.createValueMap(insertResult[key]));
+                    // OrmUtils.mergeDeep(map, column.createValueMap(this.prepareHydratedValue(insertResult[key], column))); // TODO: probably should be like there, but fails on enums, fix later
+                }
+                return map;
+            }, {});
+        }
+        const generatedMap = metadata.generatedColumns.reduce((map, generatedColumn) => {
+            let value;
+            if (generatedColumn.generationStrategy === "increment" &&
+                insertResult.insertId) {
+                // NOTE: When multiple rows is inserted by a single INSERT statement,
+                // `insertId` is the value generated for the first inserted row only.
+                value = insertResult.insertId + entityIndex;
                 // } else if (generatedColumn.generationStrategy === "uuid") {
                 //     console.log("getting db value:", generatedColumn.databaseName);
                 //     value = generatedColumn.getEntityValue(uuidMap);
@@ -626,90 +739,105 @@ var MysqlDriver = /** @class */ (function () {
             return OrmUtils.mergeDeep(map, generatedColumn.createValueMap(value));
         }, {});
         return Object.keys(generatedMap).length > 0 ? generatedMap : undefined;
-    };
+    }
     /**
      * Differentiate columns of this table and columns from the given column metadatas columns
      * and returns only changed.
      */
-    MysqlDriver.prototype.findChangedColumns = function (tableColumns, columnMetadatas) {
-        var _this = this;
-        return columnMetadatas.filter(function (columnMetadata) {
-            var tableColumn = tableColumns.find(function (c) { return c.name === columnMetadata.databaseName; });
+    findChangedColumns(tableColumns, columnMetadatas) {
+        return columnMetadatas.filter((columnMetadata) => {
+            const tableColumn = tableColumns.find((c) => c.name === columnMetadata.databaseName);
             if (!tableColumn)
                 return false; // we don't need new columns, we only need exist and changed
-            // console.log("table:", columnMetadata.entityMetadata.tableName);
-            // console.log("name:", tableColumn.name, columnMetadata.databaseName);
-            // console.log("type:", tableColumn.type, this.normalizeType(columnMetadata));
-            // console.log("length:", tableColumn.length, columnMetadata.length);
-            // console.log("width:", tableColumn.width, columnMetadata.width);
-            // console.log("precision:", tableColumn.precision, columnMetadata.precision);
-            // console.log("scale:", tableColumn.scale, columnMetadata.scale);
-            // console.log("zerofill:", tableColumn.zerofill, columnMetadata.zerofill);
-            // console.log("unsigned:", tableColumn.unsigned, columnMetadata.unsigned);
-            // console.log("asExpression:", tableColumn.asExpression, columnMetadata.asExpression);
-            // console.log("generatedType:", tableColumn.generatedType, columnMetadata.generatedType);
-            // console.log("comment:", tableColumn.comment, columnMetadata.comment);
-            // console.log("default:", tableColumn.default, columnMetadata.default);
-            // console.log("enum:", tableColumn.enum, columnMetadata.enum);
-            // console.log("default changed:", !this.compareDefaultValues(this.normalizeDefault(columnMetadata), tableColumn.default));
-            // console.log("onUpdate:", tableColumn.onUpdate, columnMetadata.onUpdate);
-            // console.log("isPrimary:", tableColumn.isPrimary, columnMetadata.isPrimary);
-            // console.log("isNullable:", tableColumn.isNullable, columnMetadata.isNullable);
-            // console.log("isUnique:", tableColumn.isUnique, this.normalizeIsUnique(columnMetadata));
-            // console.log("isGenerated:", tableColumn.isGenerated, columnMetadata.isGenerated);
-            // console.log((columnMetadata.generationStrategy !== "uuid" && tableColumn.isGenerated !== columnMetadata.isGenerated));
-            // console.log("==========================================");
-            var columnMetadataLength = columnMetadata.length;
-            if (!columnMetadataLength && columnMetadata.generationStrategy === "uuid") { // fixing #3374
-                columnMetadataLength = _this.getColumnLength(columnMetadata);
-            }
-            return tableColumn.name !== columnMetadata.databaseName
-                || tableColumn.type !== _this.normalizeType(columnMetadata)
-                || tableColumn.length !== columnMetadataLength
-                || tableColumn.width !== columnMetadata.width
-                || tableColumn.precision !== columnMetadata.precision
-                || tableColumn.scale !== columnMetadata.scale
-                || tableColumn.zerofill !== columnMetadata.zerofill
-                || tableColumn.unsigned !== columnMetadata.unsigned
-                || tableColumn.asExpression !== columnMetadata.asExpression
-                || tableColumn.generatedType !== columnMetadata.generatedType
-                // || tableColumn.comment !== columnMetadata.comment // todo
-                || !_this.compareDefaultValues(_this.normalizeDefault(columnMetadata), tableColumn.default)
-                || (tableColumn.enum && columnMetadata.enum && !OrmUtils.isArraysEqual(tableColumn.enum, columnMetadata.enum.map(function (val) { return val + ""; })))
-                || tableColumn.onUpdate !== columnMetadata.onUpdate
-                || tableColumn.isPrimary !== columnMetadata.isPrimary
-                || tableColumn.isNullable !== columnMetadata.isNullable
-                || tableColumn.isUnique !== _this.normalizeIsUnique(columnMetadata)
-                || (columnMetadata.generationStrategy !== "uuid" && tableColumn.isGenerated !== columnMetadata.isGenerated);
+            const isColumnChanged = tableColumn.name !== columnMetadata.databaseName ||
+                tableColumn.type !== this.normalizeType(columnMetadata) ||
+                tableColumn.length !== this.getColumnLength(columnMetadata) ||
+                tableColumn.width !== columnMetadata.width ||
+                (columnMetadata.precision !== undefined &&
+                    tableColumn.precision !== columnMetadata.precision) ||
+                (columnMetadata.scale !== undefined &&
+                    tableColumn.scale !== columnMetadata.scale) ||
+                tableColumn.zerofill !== columnMetadata.zerofill ||
+                tableColumn.unsigned !== columnMetadata.unsigned ||
+                tableColumn.asExpression !== columnMetadata.asExpression ||
+                tableColumn.generatedType !== columnMetadata.generatedType ||
+                tableColumn.comment !==
+                    this.escapeComment(columnMetadata.comment) ||
+                !this.compareDefaultValues(this.normalizeDefault(columnMetadata), tableColumn.default) ||
+                (tableColumn.enum &&
+                    columnMetadata.enum &&
+                    !OrmUtils.isArraysEqual(tableColumn.enum, columnMetadata.enum.map((val) => val + ""))) ||
+                tableColumn.onUpdate !==
+                    this.normalizeDatetimeFunction(columnMetadata.onUpdate) ||
+                tableColumn.isPrimary !== columnMetadata.isPrimary ||
+                tableColumn.isNullable !== columnMetadata.isNullable ||
+                tableColumn.isUnique !==
+                    this.normalizeIsUnique(columnMetadata) ||
+                (columnMetadata.generationStrategy !== "uuid" &&
+                    tableColumn.isGenerated !== columnMetadata.isGenerated);
+            // DEBUG SECTION
+            // if (isColumnChanged) {
+            //     console.log("table:", columnMetadata.entityMetadata.tableName);
+            //     console.log("name:", tableColumn.name, columnMetadata.databaseName);
+            //     console.log("type:", tableColumn.type, this.normalizeType(columnMetadata));
+            //     console.log("length:", tableColumn.length, columnMetadata.length);
+            //     console.log("width:", tableColumn.width, columnMetadata.width);
+            //     console.log("precision:", tableColumn.precision, columnMetadata.precision);
+            //     console.log("scale:", tableColumn.scale, columnMetadata.scale);
+            //     console.log("zerofill:", tableColumn.zerofill, columnMetadata.zerofill);
+            //     console.log("unsigned:", tableColumn.unsigned, columnMetadata.unsigned);
+            //     console.log("asExpression:", tableColumn.asExpression, columnMetadata.asExpression);
+            //     console.log("generatedType:", tableColumn.generatedType, columnMetadata.generatedType);
+            //     console.log("comment:", tableColumn.comment, this.escapeComment(columnMetadata.comment));
+            //     console.log("default:", tableColumn.default, this.normalizeDefault(columnMetadata));
+            //     console.log("enum:", tableColumn.enum, columnMetadata.enum);
+            //     console.log("default changed:", !this.compareDefaultValues(this.normalizeDefault(columnMetadata), tableColumn.default));
+            //     console.log("onUpdate:", tableColumn.onUpdate, this.normalizeOnUpdate(columnMetadata.onUpdate));
+            //     console.log("isPrimary:", tableColumn.isPrimary, columnMetadata.isPrimary);
+            //     console.log("isNullable:", tableColumn.isNullable, columnMetadata.isNullable);
+            //     console.log("isUnique:", tableColumn.isUnique, this.normalizeIsUnique(columnMetadata));
+            //     console.log("isGenerated:", tableColumn.isGenerated, columnMetadata.isGenerated);
+            //     console.log((columnMetadata.generationStrategy !== "uuid" && tableColumn.isGenerated !== columnMetadata.isGenerated));
+            //     console.log("==========================================");
+            // }
+            return isColumnChanged;
         });
-    };
+    }
     /**
      * Returns true if driver supports RETURNING / OUTPUT statement.
      */
-    MysqlDriver.prototype.isReturningSqlSupported = function () {
-        return false;
-    };
+    isReturningSqlSupported(returningType) {
+        return this._isReturningSqlSupported[returningType];
+    }
     /**
      * Returns true if driver supports uuid values generation on its own.
      */
-    MysqlDriver.prototype.isUUIDGenerationSupported = function () {
+    isUUIDGenerationSupported() {
         return false;
-    };
+    }
+    /**
+     * Returns true if driver supports fulltext indices.
+     */
+    isFullTextColumnTypeSupported() {
+        return true;
+    }
     /**
      * Creates an escaped parameter.
      */
-    MysqlDriver.prototype.createParameter = function (parameterName, index) {
+    createParameter(parameterName, index) {
         return "?";
-    };
+    }
     // -------------------------------------------------------------------------
     // Protected Methods
     // -------------------------------------------------------------------------
     /**
      * Loads all driver dependencies.
      */
-    MysqlDriver.prototype.loadDependencies = function () {
+    loadDependencies() {
         try {
-            this.mysql = PlatformTools.load("mysql"); // try to load first supported package
+            // try to load first supported package
+            const mysql = this.options.driver || PlatformTools.load("mysql");
+            this.mysql = mysql;
             /*
              * Some frameworks (such as Jest) may mess up Node's require cache and provide garbage for the 'mysql' module
              * if it was not installed. We check that the object we got actually contains something otherwise we treat
@@ -718,7 +846,7 @@ var MysqlDriver = /** @class */ (function () {
              * @see https://github.com/typeorm/typeorm/issues/1373
              */
             if (Object.keys(this.mysql).length === 0) {
-                throw new Error("'mysql' was found but it is empty. Falling back to 'mysql2'.");
+                throw new TypeORMError("'mysql' was found but it is empty. Falling back to 'mysql2'.");
             }
         }
         catch (e) {
@@ -729,11 +857,11 @@ var MysqlDriver = /** @class */ (function () {
                 throw new DriverPackageNotInstalledError("Mysql", "mysql");
             }
         }
-    };
+    }
     /**
      * Creates a new connection pool for a given database credentials.
      */
-    MysqlDriver.prototype.createConnectionOptions = function (options, credentials) {
+    createConnectionOptions(options, credentials) {
         credentials = Object.assign({}, credentials, DriverUtils.buildDriverOptions(credentials)); // todo: do it better way
         // build connection options for the driver
         return Object.assign({}, {
@@ -741,70 +869,111 @@ var MysqlDriver = /** @class */ (function () {
             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 !== undefined
+                ? options.supportBigNumbers
+                : true,
+            bigNumberStrings: options.bigNumberStrings !== undefined
+                ? options.bigNumberStrings
+                : true,
             dateStrings: options.dateStrings,
             debug: options.debug,
             trace: options.trace,
             multipleStatements: options.multipleStatements,
-            flags: options.flags
+            flags: options.flags,
         }, {
             host: credentials.host,
             user: credentials.username,
             password: credentials.password,
             database: credentials.database,
             port: credentials.port,
-            ssl: options.ssl
+            ssl: options.ssl,
+            socketPath: credentials.socketPath,
         }, options.acquireTimeout === undefined
             ? {}
             : { acquireTimeout: options.acquireTimeout }, options.extra || {});
-    };
+    }
     /**
      * Creates a new connection pool for a given database credentials.
      */
-    MysqlDriver.prototype.createPool = function (connectionOptions) {
+    createPool(connectionOptions) {
         // create a connection pool
-        var pool = this.mysql.createPool(connectionOptions);
+        const pool = this.mysql.createPool(connectionOptions);
         // make sure connection is working fine
-        return new Promise(function (ok, fail) {
+        return new Promise((ok, fail) => {
             // (issue #610) we make first connection to database to make sure if connection credentials are wrong
             // we give error before calling any other method that creates actual query runner
-            pool.getConnection(function (err, connection) {
+            pool.getConnection((err, connection) => {
                 if (err)
-                    return pool.end(function () { return fail(err); });
+                    return pool.end(() => fail(err));
                 connection.release();
                 ok(pool);
             });
         });
-    };
+    }
     /**
      * Attaches all required base handlers to a database connection, such as the unhandled error handler.
      */
-    MysqlDriver.prototype.prepareDbConnection = function (connection) {
-        var logger = this.connection.logger;
+    prepareDbConnection(connection) {
+        const { logger } = this.connection;
         /*
-          Attaching an error handler to connection errors is essential, as, otherwise, errors raised will go unhandled and
-          cause the hosting app to crash.
+         * Attaching an error handler to connection errors is essential, as, otherwise, errors raised will go unhandled and
+         * cause the hosting app to crash.
          */
         if (connection.listeners("error").length === 0) {
-            connection.on("error", function (error) { return logger.log("warn", "MySQL connection raised an error. " + error); });
+            connection.on("error", (error) => logger.log("warn", `MySQL connection raised an error. ${error}`));
         }
         return connection;
-    };
+    }
     /**
      * Checks if "DEFAULT" values in the column metadata and in the database are equal.
      */
-    MysqlDriver.prototype.compareDefaultValues = function (columnMetadataValue, databaseValue) {
-        if (typeof columnMetadataValue === "string" && typeof databaseValue === "string") {
+    compareDefaultValues(columnMetadataValue, databaseValue) {
+        if (typeof columnMetadataValue === "string" &&
+            typeof databaseValue === "string") {
             // we need to cut out "'" because in mysql we can understand returned value is a string or a function
             // as result compare cannot understand if default is really changed or not
             columnMetadataValue = columnMetadataValue.replace(/^'+|'+$/g, "");
             databaseValue = databaseValue.replace(/^'+|'+$/g, "");
         }
-        return columnMetadataValue === databaseValue || (columnMetadataValue === null && typeof databaseValue === "undefined");
-    };
-    return MysqlDriver;
-}());
-export { MysqlDriver };
+        return columnMetadataValue === databaseValue;
+    }
+    /**
+     * If parameter is a datetime function, e.g. "CURRENT_TIMESTAMP", normalizes it.
+     * Otherwise returns original input.
+     */
+    normalizeDatetimeFunction(value) {
+        if (!value)
+            return value;
+        // check if input is datetime function
+        const isDatetimeFunction = value.toUpperCase().indexOf("CURRENT_TIMESTAMP") !== -1 ||
+            value.toUpperCase().indexOf("NOW") !== -1;
+        if (isDatetimeFunction) {
+            // extract precision, e.g. "(3)"
+            const precision = value.match(/\(\d+\)/);
+            if (this.options.type === "mariadb") {
+                return precision
+                    ? `CURRENT_TIMESTAMP${precision[0]}`
+                    : "CURRENT_TIMESTAMP()";
+            }
+            else {
+                return precision
+                    ? `CURRENT_TIMESTAMP${precision[0]}`
+                    : "CURRENT_TIMESTAMP";
+            }
+        }
+        else {
+            return value;
+        }
+    }
+    /**
+     * Escapes a given comment.
+     */
+    escapeComment(comment) {
+        if (!comment)
+            return comment;
+        comment = comment.replace(/\u0000/g, ""); // Null bytes aren't allowed in comments
+        return comment;
+    }
+}
 
 //# sourceMappingURL=MysqlDriver.js.map