mysql-memory-server 1.8.1 → 1.9.0

package/README.md

@@ -1,6 +1,6 @@
 # MySQL Memory Server
 
-This package allows you to create ephemeral MySQL databases from JavaScript and/or TypeScript code and also the CLI, great for testing, CI, and learning MySQL. When creating a new database, if the version selected is not installed on the system, the binary is downloaded from MySQL's CDN (cdn.mysql.com)
+This package allows you to create ephemeral MySQL databases from JavaScript and/or TypeScript code and also the CLI, great for testing, CI, and learning MySQL. When creating a new database, if the version selected is not installed on the system, the binary is downloaded from MySQL's CDN (cdn.mysql.com). This package supports Linux, macOS, and Windows.
 
 You can run multiple MySQL databases with this package at the same time. Each database will use a random free port. The databases will automatically shutdown when the JS runtime process exits. A `stop()` method is also provided to stop each database instance.
 
@@ -11,24 +11,13 @@ Download with your package manager of choice. The package name is `mysql-memory-
 #### Requirements
 
 - Node.js >=16.6.0 or Bun >= 1.0.0
-- macOS 13+, Windows, or Linux (This package is only tested on Ubuntu 20.04, 22.04, 24.04, and Fedora 40. Other Linux distributions may or may not work at this time.)
-
-#### Requirements for downloaded MySQL versions
-
-The following requirements only apply if you intend to have `mysql-memory-server` download a version of MySQL to use instead of using an already installed version of MySQL on the system:
-
-Requirements for Windows:
-- `Microsoft Visual C++ 2019 Redistributable Package` needs to be installed
-
-Requirements for Linux:
-- The `libaio1` or `libaio1t64` package needs to be installed
-- If `libaio1` is not available but `libaio1t64` is, the `ldconfig` command needs to be available to run
-- The `tar` package needs to be installed
 
 #### Currently supported MySQL versions
 
-- If using the system installed MySQL server: 8.0.20 and newer
-- If not using the system installed MySQL server: 8.0.39, 8.0.40, 8.1.0, 8.2.0, 8.3.0, 8.4.2, 8.4.3, 9.0.1, 9.1.0
+- ```mysql-memory-server``` can run MySQL versions 5.7.19 and newer (if the version is already installed on your system)
+- ```mysql-memory-server``` can download and run MySQL versions 5.7.19 - 9.2.0 (if the version is not already installed on your system)
+
+Extra system requirements apply when ```mysql-memory-server``` is downloading MySQL instead of running a version of MySQL that is already installed on the system. To see the requirements and learn more about the supported versions for download, [read the doc](https://github.com/Sebastian-Webster/mysql-memory-server-nodejs/blob/v1.9.0/docs/SUPPORTED_MYSQL_DOWNLOADS.md)
 
 ## Example Usage - Application Code
 
@@ -112,11 +101,11 @@ Default: undefined
 Description: Version of MySQL to use for the database. Uses semver for getting the version, so valid semver versions are allowed. For example, `8.x` is a valid version and will use the latest 8.x MySQL version. 
 
 If left undefined:
-- If the system has MySQL installed, the system-installed version will be used. If the installed version is not supported by this package (currently <8.0.20), an error will be thrown unless `ignoreUnsupportedSystemVersion` is set to `true`.
+- If the system has MySQL installed, the system-installed version will be used. If the installed version is not supported by this package (currently <5.7.19), an error will be thrown unless `ignoreUnsupportedSystemVersion` is set to `true`.
 - If the system does not have MySQL installed, the latest version of MySQL in the `versions.json` file in this package will be downloaded.
 
 If defined:
-- If the version is 8.0.19 or older, an error will be thrown as this package does not currently support those versions of MySQL.
+- If the version is older than 5.7.19, an error will be thrown as this package does not currently support those versions of MySQL.
 - If the desired version of MySQL is installed on the system, the installed version will be used. Otherwise the selected version will be downloaded from the MySQL CDN as long as it can be found in the `versions.json` file. If it cannot be found in that file, an error will be thrown.
 
 - `dbName: string`
@@ -179,11 +168,11 @@ Description: The port that the MySQL X Plugin will listen on. If set to 0, a ran
 
 Default: false
 
-Description: This option only applies if the system-installed MySQL version is lower than the oldest supported MySQL version for this package (8.0.20) and the `version` option is not defined. If set to `true`, this package will use the latest version of MySQL instead of the system-installed version. If `false`, the package will throw an error.
+Description: This option only applies if the system-installed MySQL version is lower than the oldest supported MySQL version for this package (5.7.19) and the `version` option is not defined. If set to `true`, this package will use the latest version of MySQL instead of the system-installed version. If `false`, the package will throw an error.
 
 - `downloadRetries: number`
 
-Default: 3
+Default: 10
 
 Description: The number of times to try to download a MySQL binary before giving up and rejecting the `createDB()` promise.
 
@@ -200,32 +189,3 @@ The internal queries that are ran before the queries in ```initSQLString``` are
 Default: process.arch
 
 Description: The MySQL binary architecture to execute. MySQL does not offer server builds for Windows on ARM, so to get this package working on Windows on ARM, set the arch option to "x64" and Windows will emulate MySQL.
-
-***
-### :warning: Internal Options :warning:
-
-The following options are only meant for internal use (such as for testing this package or the internals for running this package via the CLI). Their behaviour may change or they may get removed between major/minor/patch versions and they are not to be considered stable. The options below will not follow Semantic Versioning so it is advised to not use them.
-
-- `_DO_NOT_USE_deleteDBAfterStopped: boolean`
-
-Default: true
-
-Description: Changes whether or not the database will be deleted after it has been stopped. If set to `true`, the database WILL be deleted after it has been stopped.
-
-- `_DO_NOT_USE_dbPath: string`
-
-Default: `TMPDIR/mysqlmsn/dbs/UUID` (replacing TMPDIR with the OS temp directory and UUID with a UUIDv4 without seperating dashes).
-
-Description: The folder to store database-related data in
-
-- `_DO_NOT_USE_binaryDirectoryPath: string`
-
-Default: `TMPDIR/mysqlmsn/binaries` (replacing TMPDIR with the OS temp directory)
-
-Description: The folder to store the MySQL binaries when they are downloaded from the CDN.
-
-- `_DO_NOT_USE_cli: boolean`
-
-Default: ```false``` if the package is not being executed via the CLI and ```true``` if it is.
-
-Description: If set to ```true```, this enables certain CLI-only functionality. For example, when ran by the CLI, logging a message to the console when a shutdown signal (like CTRL + C) has been received and the MySQL database is shutting down and getting deleted.

package/dist/src/cli.js

@@ -3,16 +3,20 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const index_1 = require("./index");
 const constants_1 = require("./constants");
-async function main() {
+function main() {
     const definedOptions = process.argv.filter((option) => option.startsWith('--'));
-    const options = {
-        _DO_NOT_USE_cli: true
-    };
+    const options = {};
+    process.env.mysqlmsn_internal_DO_NOT_USE_cli = 'true';
     for (const opt of definedOptions) {
+        if (!constants_1.DEFAULT_OPTIONS_KEYS.includes(opt.replace('--', ''))) {
+            console.error(`Option ${opt} is not a valid option.`);
+            return;
+        }
         const index = process.argv.indexOf(opt);
         const optionValue = process.argv[index + 1];
         if (optionValue === undefined) {
-            throw `Option ${opt} must have a value.`;
+            console.error(`Option ${opt} must have a value.`);
+            return;
         }
         const optionName = opt.slice(2);
         const optionType = constants_1.OPTION_TYPE_CHECKS[optionName].definedType;
@@ -39,17 +43,18 @@ async function main() {
         }
     }
     console.log('Creating ephemeral MySQL database...');
-    const db = await (0, index_1.createDB)(options);
-    console.log(`A MySQL database has been successfully created with the following parameters:\n\nMySQL Version: ${db.mysql.version} (${db.mysql.versionIsInstalledOnSystem ? 'installed on this system' : 'not installed on this system - downloaded from the MySQL CDN'}) \nUsername: ${db.username} \nDatabase Name: ${db.dbName} \nPort: ${db.port} \nX Plugin Port: ${db.xPort} \nSocket: ${db.socket} \nX Plugin Socket: ${db.xSocket}\n`);
-    if (process.platform === 'win32') {
-        //The connection information logs will be different for Windows compared to other platforms.
-        //Windows uses mysqlsh instead of mysql to invoke the client shell, needs a --sql flag to be put into SQL mode, and also does not have a protocol flag.
-        //Also according to https://bugs.mysql.com/bug.php?id=106852, you cannot log into a MySQL database with a named pipe for the first connection so a socket connection suggestion
-        //should only be displayed for non-Windows platforms.
-        console.log(`If you want to use the MySQL CLI client to connect to the database, you can use the following command: \nmysqlsh --sql -u ${db.username} -P ${db.port}\nIf prompted for a password, leave the password field blank. The database does not have a password set.`);
-    }
-    else {
-        console.log(`If you want to use the MySQL CLI client to connect to the database, you can use either commands: \nmysql -u ${db.username} -P ${db.port} --protocol tcp \nOR\nmysql -u ${db.username} --socket ${db.socket}\nIf prompted for a password, leave the password field blank. The database does not have a password set.`);
-    }
+    (0, index_1.createDB)(options).then(db => {
+        console.log(`A MySQL database has been successfully created with the following parameters:\n\nMySQL Version: ${db.mysql.version} (${db.mysql.versionIsInstalledOnSystem ? 'installed on this system' : 'not installed on this system - downloaded from the MySQL CDN'}) \nUsername: ${db.username} \nDatabase Name: ${db.dbName} \nPort: ${db.port} \nX Plugin Port: ${db.xPort} \nSocket: ${db.socket} \nX Plugin Socket: ${db.xSocket}\n`);
+        if (process.platform === 'win32') {
+            //The connection information logs will be different for Windows compared to other platforms.
+            //Windows uses mysqlsh instead of mysql to invoke the client shell, needs a --sql flag to be put into SQL mode, and also does not have a protocol flag.
+            //Also according to https://bugs.mysql.com/bug.php?id=106852, you cannot log into a MySQL database with a named pipe for the first connection so a socket connection suggestion
+            //should only be displayed for non-Windows platforms.
+            console.log(`If you want to use the MySQL CLI client to connect to the database, you can use the following command: \nmysqlsh --sql -u ${db.username} -P ${db.port}\nIf prompted for a password, leave the password field blank. The database does not have a password set.`);
+        }
+        else {
+            console.log(`If you want to use the MySQL CLI client to connect to the database, you can use either commands: \nmysql -u ${db.username} -P ${db.port} --protocol tcp \nOR\nmysql -u ${db.username} --socket ${db.socket}\nIf prompted for a password, leave the password field blank. The database does not have a password set.`);
+        }
+    });
 }
 main();

package/dist/src/constants.d.ts

@@ -1,11 +1,88 @@
 import { InternalServerOptions, OptionTypeChecks } from "../types";
-export declare const MIN_SUPPORTED_MYSQL = "8.0.20";
-export declare const DEFAULT_OPTIONS_GENERATOR: () => InternalServerOptions;
+export declare const DEFAULT_OPTIONS: InternalServerOptions;
 export declare const DEFAULT_OPTIONS_KEYS: readonly string[];
 export declare const LOG_LEVELS: {
     readonly LOG: 0;
     readonly WARN: 1;
     readonly ERROR: 2;
 };
-export declare const INTERNAL_OPTIONS: readonly ["_DO_NOT_USE_deleteDBAfterStopped", "_DO_NOT_USE_dbPath", "_DO_NOT_USE_binaryDirectoryPath", "_DO_NOT_USE_beforeSignalCleanup", "_DO_NOT_USE_afterSignalCleanup"];
+declare const internalOptions: {
+    deleteDBAfterStopped: string;
+    databaseDirectoryPath: string;
+    binaryDirectoryPath: string;
+    cli: string;
+};
+export declare function getInternalEnvVariable(envVar: keyof typeof internalOptions): string;
 export declare const OPTION_TYPE_CHECKS: OptionTypeChecks;
+export declare const MIN_SUPPORTED_MYSQL = "5.7.19";
+export declare const downloadsBaseURL = "https://cdn.mysql.com//Downloads/MySQL-";
+export declare const archiveBaseURL = "https://cdn.mysql.com/archives/mysql-";
+export declare const DOWNLOADABLE_MYSQL_VERSIONS: readonly ["5.7.19", "5.7.20", "5.7.21", "5.7.22", "5.7.23", "5.7.24", "5.7.25", "5.7.26", "5.7.27", "5.7.28", "5.7.29", "5.7.30", "5.7.31", "5.7.32", "5.7.33", "5.7.34", "5.7.35", "5.7.36", "5.7.37", "5.7.38", "5.7.39", "5.7.40", "5.7.41", "5.7.42", "5.7.43", "5.7.44", "8.0.0", "8.0.1", "8.0.2", "8.0.3", "8.0.4", "8.0.11", "8.0.12", "8.0.13", "8.0.14", "8.0.15", "8.0.16", "8.0.17", "8.0.18", "8.0.19", "8.0.20", "8.0.21", "8.0.22", "8.0.23", "8.0.24", "8.0.25", "8.0.26", "8.0.27", "8.0.28", "8.0.30", "8.0.31", "8.0.32", "8.0.33", "8.0.34", "8.0.35", "8.0.36", "8.0.37", "8.0.39", "8.0.40", "8.0.41", "8.1.0", "8.2.0", "8.3.0", "8.4.0", "8.4.2", "8.4.3", "8.4.4", "9.0.1", "9.1.0", "9.2.0"];
+export declare const MYSQL_ARCH_SUPPORT: {
+    readonly darwin: {
+        readonly arm64: "8.0.26 - 9.2.0";
+        readonly x64: "5.7.19 - 9.2.0";
+    };
+    readonly linux: {
+        readonly arm64: "8.0.31 - 9.2.0";
+        readonly x64: "5.7.19 - 9.2.0";
+    };
+    readonly win32: {
+        readonly x64: "5.7.19 - 9.2.0";
+    };
+};
+export declare const MYSQL_MIN_OS_SUPPORT: {
+    readonly win32: {
+        readonly x: "0.0.0";
+    };
+    readonly linux: {
+        readonly x: "0.0.0";
+    };
+    readonly darwin: {
+        readonly '5.7.19 - 5.7.23 || 8.0.1 - 8.0.3 || 8.0.11 - 8.0.12': "16.0.0";
+        readonly '5.7.24 - 5.7.29 || 8.0.4 || 8.0.13 - 8.0.18': "17.0.0";
+        readonly '5.7.30 - 5.7.31 || 8.0.19 - 8.0.22': "18.0.0";
+        readonly '8.0.0': "13.0.0";
+        readonly '8.0.23 - 8.0.27': "19.0.0";
+        readonly '8.0.28 - 8.0.31': "20.0.0";
+        readonly '8.0.32 - 8.0.34': "21.0.0";
+        readonly '8.0.35 - 8.0.39 || 8.1.0 - 8.4.2 || 9.0.1': "22.0.0";
+        readonly '8.0.40 - 8.0.41 || 8.4.3 - 8.4.4 || 9.1.0 - 9.2.0': "23.0.0";
+    };
+};
+export declare const DMR_MYSQL_VERSIONS = "8.0.0 - 8.0.2";
+export declare const RC_MYSQL_VERSIONS = "8.0.3 - 8.0.4";
+export declare const MYSQL_MACOS_VERSIONS_IN_FILENAME: {
+    readonly '5.7.19 - 5.7.20 || 8.0.1 - 8.0.3': "macos10.12";
+    readonly '5.7.21 - 5.7.23 || 8.0.4 - 8.0.12': "macos10.13";
+    readonly '5.7.24 - 5.7.31 || 8.0.13 - 8.0.18': "macos10.14";
+    readonly '8.0.0': "osx10.11";
+    readonly '8.0.19 - 8.0.23': "macos10.15";
+    readonly '8.0.24 - 8.0.28': "macos11";
+    readonly '8.0.30 - 8.0.31': "macos12";
+    readonly '8.0.32 - 8.0.35 || 8.1.0 - 8.2.0': "macos13";
+    readonly '8.0.36 - 8.0.40 || 8.3.0 - 8.4.3 || 9.0.1 - 9.1.0': "macos14";
+    readonly '8.0.41 || 8.4.4 || 9.2.0': "macos15";
+};
+export declare const MYSQL_LINUX_GLIBC_VERSIONS: {
+    readonly '5.7.19 - 8.0.20': "2.12";
+    readonly '8.0.21 - 9.2.0': "2.17";
+};
+export declare const MYSQL_LINUX_MINIMAL_INSTALL_AVAILABLE: {
+    readonly '5.7.19 - 8.0.15': "no";
+    readonly '8.0.16 - 8.0.20': "no-glibc-tag";
+    readonly '8.0.21 - 9.2.0': "glibc-tag";
+};
+export declare const MYSQL_LINUX_MINIMAL_INSTALL_AVAILABLE_ARM64 = ">=8.0.33";
+export declare const MYSQL_LINUX_FILE_EXTENSIONS: {
+    readonly x64: {
+        readonly '5.7.19 - 8.0.11': "gz";
+        readonly '8.0.12 - 9.2.0': "xz";
+    };
+    readonly arm64: {
+        readonly '8.0.31 - 8.0.32': "gz";
+        readonly '8.0.33 - 9.2.0': "xz";
+    };
+};
+export declare const MYSQL_LINUX_MINIMAL_REBUILD_VERSIONS = "8.0.26";
+export {};

package/dist/src/constants.js

@@ -1,41 +1,43 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.OPTION_TYPE_CHECKS = exports.INTERNAL_OPTIONS = exports.LOG_LEVELS = exports.DEFAULT_OPTIONS_KEYS = exports.DEFAULT_OPTIONS_GENERATOR = exports.MIN_SUPPORTED_MYSQL = void 0;
-const crypto_1 = require("crypto");
+exports.MYSQL_LINUX_MINIMAL_REBUILD_VERSIONS = exports.MYSQL_LINUX_FILE_EXTENSIONS = exports.MYSQL_LINUX_MINIMAL_INSTALL_AVAILABLE_ARM64 = exports.MYSQL_LINUX_MINIMAL_INSTALL_AVAILABLE = exports.MYSQL_LINUX_GLIBC_VERSIONS = exports.MYSQL_MACOS_VERSIONS_IN_FILENAME = exports.RC_MYSQL_VERSIONS = exports.DMR_MYSQL_VERSIONS = exports.MYSQL_MIN_OS_SUPPORT = exports.MYSQL_ARCH_SUPPORT = exports.DOWNLOADABLE_MYSQL_VERSIONS = exports.archiveBaseURL = exports.downloadsBaseURL = exports.MIN_SUPPORTED_MYSQL = exports.OPTION_TYPE_CHECKS = exports.LOG_LEVELS = exports.DEFAULT_OPTIONS_KEYS = exports.DEFAULT_OPTIONS = void 0;
+exports.getInternalEnvVariable = getInternalEnvVariable;
 const path_1 = require("path");
 const os_1 = require("os");
 const semver_1 = require("semver");
-exports.MIN_SUPPORTED_MYSQL = '8.0.20';
-const DEFAULT_OPTIONS_GENERATOR = () => ({
+exports.DEFAULT_OPTIONS = {
     version: undefined,
     dbName: 'dbdata',
     logLevel: 'ERROR',
     portRetries: 10,
     downloadBinaryOnce: true,
-    lockRetries: 1000,
-    lockRetryWait: 1000,
+    lockRetries: 1_000,
+    lockRetryWait: 1_000,
     username: 'root',
     ignoreUnsupportedSystemVersion: false,
     port: 0,
     xPort: 0,
     downloadRetries: 10,
     initSQLString: '',
-    arch: process.arch,
-    _DO_NOT_USE_deleteDBAfterStopped: true,
-    //mysqlmsn = MySQL Memory Server Node.js
-    _DO_NOT_USE_dbPath: (0, path_1.normalize)(`${(0, os_1.tmpdir)()}/mysqlmsn/dbs/${(0, crypto_1.randomUUID)().replace(/-/g, '')}`),
-    _DO_NOT_USE_binaryDirectoryPath: `${(0, os_1.tmpdir)()}/mysqlmsn/binaries`,
-    _DO_NOT_USE_cli: false
-});
-exports.DEFAULT_OPTIONS_GENERATOR = DEFAULT_OPTIONS_GENERATOR;
-exports.DEFAULT_OPTIONS_KEYS = Object.freeze(Object.keys((0, exports.DEFAULT_OPTIONS_GENERATOR)()));
+    arch: process.arch
+};
+exports.DEFAULT_OPTIONS_KEYS = Object.freeze(Object.keys(exports.DEFAULT_OPTIONS));
 exports.LOG_LEVELS = {
     'LOG': 0,
     'WARN': 1,
     'ERROR': 2
 };
-exports.INTERNAL_OPTIONS = ['_DO_NOT_USE_deleteDBAfterStopped', '_DO_NOT_USE_dbPath', '_DO_NOT_USE_binaryDirectoryPath', '_DO_NOT_USE_beforeSignalCleanup', '_DO_NOT_USE_afterSignalCleanup'];
-const allowedArches = ['x64', 'arm64', undefined];
+const internalOptions = {
+    deleteDBAfterStopped: 'true',
+    //mysqlmsn = MySQL Memory Server Node.js
+    databaseDirectoryPath: (0, path_1.normalize)(`${(0, os_1.tmpdir)()}/mysqlmsn/dbs`),
+    binaryDirectoryPath: `${(0, os_1.tmpdir)()}/mysqlmsn/binaries`,
+    cli: 'false'
+};
+function getInternalEnvVariable(envVar) {
+    return process.env['mysqlmsn_internal_DO_NOT_USE_' + envVar] || internalOptions[envVar];
+}
+const allowedArches = ['x64', 'arm64'];
 exports.OPTION_TYPE_CHECKS = {
     version: {
         check: (opt) => opt === undefined || typeof opt === 'string' && (0, semver_1.valid)((0, semver_1.coerce)(opt)) !== null,
@@ -103,28 +105,88 @@ exports.OPTION_TYPE_CHECKS = {
         definedType: 'string'
     },
     arch: {
-        check: (opt) => allowedArches.includes(opt),
+        check: (opt) => opt === undefined || allowedArches.includes(opt),
         errorMessage: `Option arch must be either of the following: ${allowedArches.join(', ')}`,
         definedType: 'string'
-    },
-    _DO_NOT_USE_deleteDBAfterStopped: {
-        check: (opt) => opt === undefined || typeof opt === 'boolean',
-        errorMessage: 'Option _DO_NOT_USE_deleteDBAfterStopped must be either undefined or a boolean.',
-        definedType: 'boolean'
-    },
-    _DO_NOT_USE_dbPath: {
-        check: (opt) => opt === undefined || typeof opt === 'string',
-        errorMessage: 'Option _DO_NOT_USE_dbPath must be either undefined or a string.',
-        definedType: 'string'
-    },
-    _DO_NOT_USE_binaryDirectoryPath: {
-        check: (opt) => opt === undefined || typeof opt === 'string',
-        errorMessage: 'Option _DO_NOT_USE_binaryDirectoryPath must be either undefined or a string.',
-        definedType: 'string'
-    },
-    _DO_NOT_USE_cli: {
-        check: (opt) => opt === undefined || typeof opt === 'boolean',
-        errorMessage: 'Option _DO_NOT_USE_cli must be either undefined or a boolean.',
-        definedType: 'boolean'
     }
 };
+exports.MIN_SUPPORTED_MYSQL = '5.7.19';
+exports.downloadsBaseURL = 'https://cdn.mysql.com//Downloads/MySQL-';
+exports.archiveBaseURL = 'https://cdn.mysql.com/archives/mysql-';
+// Versions 8.0.29, 8.0.38, 8.4.1, and 9.0.0 have been purposefully left out of this list as MySQL has removed them from the CDN due to critical issues.
+exports.DOWNLOADABLE_MYSQL_VERSIONS = [
+    '5.7.19', '5.7.20', '5.7.21', '5.7.22', '5.7.23', '5.7.24', '5.7.25', '5.7.26', '5.7.27', '5.7.28', '5.7.29', '5.7.30', '5.7.31', '5.7.32', '5.7.33', '5.7.34', '5.7.35', '5.7.36', '5.7.37', '5.7.38', '5.7.39', '5.7.40', '5.7.41', '5.7.42', '5.7.43', '5.7.44',
+    '8.0.0', '8.0.1', '8.0.2', '8.0.3', '8.0.4',
+    '8.0.11', '8.0.12', '8.0.13', '8.0.14', '8.0.15', '8.0.16', '8.0.17', '8.0.18', '8.0.19', '8.0.20', '8.0.21', '8.0.22', '8.0.23', '8.0.24', '8.0.25', '8.0.26', '8.0.27', '8.0.28', '8.0.30', '8.0.31', '8.0.32', '8.0.33', '8.0.34', '8.0.35', '8.0.36', '8.0.37', '8.0.39', '8.0.40', '8.0.41',
+    '8.1.0', '8.2.0', '8.3.0',
+    '8.4.0', '8.4.2', '8.4.3', '8.4.4',
+    '9.0.1', '9.1.0', '9.2.0'
+];
+exports.MYSQL_ARCH_SUPPORT = {
+    darwin: {
+        arm64: '8.0.26 - 9.2.0',
+        x64: '5.7.19 - 9.2.0'
+    },
+    linux: {
+        arm64: '8.0.31 - 9.2.0',
+        x64: '5.7.19 - 9.2.0'
+    },
+    win32: {
+        x64: '5.7.19 - 9.2.0'
+    }
+};
+exports.MYSQL_MIN_OS_SUPPORT = {
+    win32: {
+        x: '0.0.0' // No minimum version is documented as far as I can tell, so allow any minimum version
+    },
+    linux: {
+        x: '0.0.0' // No minimum version is documented as far as I can tell, so allow any minimum version
+    },
+    darwin: {
+        '5.7.19 - 5.7.23 || 8.0.1 - 8.0.3 || 8.0.11 - 8.0.12': '16.0.0',
+        '5.7.24 - 5.7.29 || 8.0.4 || 8.0.13 - 8.0.18': '17.0.0',
+        '5.7.30 - 5.7.31 || 8.0.19 - 8.0.22': '18.0.0',
+        //5.7.32 - 5.7.44 is not supported for macOS by MySQL. Those versions are not appearing in this list
+        '8.0.0': '13.0.0',
+        '8.0.23 - 8.0.27': '19.0.0',
+        '8.0.28 - 8.0.31': '20.0.0',
+        '8.0.32 - 8.0.34': '21.0.0',
+        '8.0.35 - 8.0.39 || 8.1.0 - 8.4.2 || 9.0.1': '22.0.0',
+        '8.0.40 - 8.0.41 || 8.4.3 - 8.4.4 || 9.1.0 - 9.2.0': '23.0.0'
+    }
+};
+exports.DMR_MYSQL_VERSIONS = '8.0.0 - 8.0.2';
+exports.RC_MYSQL_VERSIONS = '8.0.3 - 8.0.4';
+exports.MYSQL_MACOS_VERSIONS_IN_FILENAME = {
+    '5.7.19 - 5.7.20 || 8.0.1 - 8.0.3': 'macos10.12',
+    '5.7.21 - 5.7.23 || 8.0.4 - 8.0.12': 'macos10.13',
+    '5.7.24 - 5.7.31 || 8.0.13 - 8.0.18': 'macos10.14',
+    '8.0.0': 'osx10.11',
+    '8.0.19 - 8.0.23': 'macos10.15',
+    '8.0.24 - 8.0.28': 'macos11',
+    '8.0.30 - 8.0.31': 'macos12',
+    '8.0.32 - 8.0.35 || 8.1.0 - 8.2.0': 'macos13',
+    '8.0.36 - 8.0.40 || 8.3.0 - 8.4.3 || 9.0.1 - 9.1.0': 'macos14',
+    '8.0.41 || 8.4.4 || 9.2.0': 'macos15'
+};
+exports.MYSQL_LINUX_GLIBC_VERSIONS = {
+    '5.7.19 - 8.0.20': '2.12',
+    '8.0.21 - 9.2.0': '2.17'
+};
+exports.MYSQL_LINUX_MINIMAL_INSTALL_AVAILABLE = {
+    '5.7.19 - 8.0.15': 'no',
+    '8.0.16 - 8.0.20': 'no-glibc-tag',
+    '8.0.21 - 9.2.0': 'glibc-tag'
+};
+exports.MYSQL_LINUX_MINIMAL_INSTALL_AVAILABLE_ARM64 = '>=8.0.33';
+exports.MYSQL_LINUX_FILE_EXTENSIONS = {
+    x64: {
+        '5.7.19 - 8.0.11': 'gz',
+        '8.0.12 - 9.2.0': 'xz'
+    },
+    arm64: {
+        '8.0.31 - 8.0.32': 'gz',
+        '8.0.33 - 9.2.0': 'xz'
+    }
+};
+exports.MYSQL_LINUX_MINIMAL_REBUILD_VERSIONS = '8.0.26';

package/dist/src/index.js

@@ -1,59 +1,19 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createDB = createDB;
 const Logger_1 = __importDefault(require("./libraries/Logger"));
-const os = __importStar(require("node:os"));
 const Executor_1 = __importDefault(require("./libraries/Executor"));
 const semver_1 = require("semver");
 const Version_1 = __importDefault(require("./libraries/Version"));
-const versions_json_1 = __importDefault(require("./versions.json"));
 const Downloader_1 = require("./libraries/Downloader");
 const constants_1 = require("./constants");
 async function createDB(opts) {
     const suppliedOpts = opts || {};
     const suppliedOptsKeys = Object.keys(suppliedOpts);
-    for (const opt of constants_1.INTERNAL_OPTIONS) {
-        if (suppliedOptsKeys.includes(opt)) {
-            console.warn(`[ mysql-memory-server - Options WARN ]: Creating MySQL database with option ${opt}. This is considered unstable and should not be used externally. Please consider removing this option.`);
-        }
-    }
-    const options = (0, constants_1.DEFAULT_OPTIONS_GENERATOR)();
+    const options = { ...constants_1.DEFAULT_OPTIONS };
     for (const opt of suppliedOptsKeys) {
         if (!constants_1.DEFAULT_OPTIONS_KEYS.includes(opt)) {
             throw `Option ${opt} is not a valid option.`;
@@ -78,22 +38,7 @@ async function createDB(opts) {
     if (version === null || (options.version && !(0, semver_1.satisfies)(version.version, options.version)) || unsupportedMySQLIsInstalled) {
         let binaryInfo;
         let binaryFilepath;
-        try {
-            binaryInfo = (0, Version_1.default)(versions_json_1.default, options.version, options);
-            logger.log('Using MySQL binary version:', binaryInfo.version, 'from URL:', binaryInfo.url);
-        }
-        catch (e) {
-            if (options.version && (0, semver_1.lt)((0, semver_1.coerce)(options.version), constants_1.MIN_SUPPORTED_MYSQL)) {
-                //The difference between the throw here and the throw above is this throw is because the selected "version" is not supported.
-                //The throw above is because the system-installed MySQL is out of date and "ignoreUnsupportedSystemVersion" is not set to true.
-                throw `The selected version of MySQL (${options.version}) is not currently supported by this package. Please choose a different version to use.`;
-            }
-            logger.error(e);
-            if (options.version) {
-                throw `A MySQL version ${options.version} binary could not be found that supports your OS (${os.platform()} | ${os.version()} | ${os.release()}) and CPU architecture (${os.arch()}). Please check you have the latest version of mysql-memory-server. If the latest version still doesn't support the version you want to use, feel free to make a pull request to add support!`;
-            }
-            throw `A MySQL binary could not be found that supports your OS (${os.platform()} | ${os.version()} | ${os.release()}) and CPU architecture (${os.arch()}). Please check you have the latest version of mysql-memory-server. If the latest version still doesn't support your OS and CPU architecture, feel free to make a pull request to add support!`;
-        }
+        binaryInfo = (0, Version_1.default)(options.version, options.arch);
         try {
             binaryFilepath = await (0, Downloader_1.downloadBinary)(binaryInfo, options, logger);
         }

package/dist/src/libraries/Downloader.d.ts

@@ -1,4 +1,3 @@
 import Logger from './Logger';
 import { BinaryInfo, InternalServerOptions } from '../../types';
-export declare function downloadVersions(): Promise<string>;
 export declare function downloadBinary(binaryInfo: BinaryInfo, options: InternalServerOptions, logger: Logger): Promise<string>;