@scandipwa/magento-scripts 1.14.1-alpha.8 → 1.15.1

package/lib/tasks/file-system/create-nginx-config.js

@@ -1,9 +1,7 @@
 const os = require('os');
 const path = require('path');
-const fs = require('fs');
 const setConfigFile = require('../../util/set-config');
-const pathExists = require('../../util/path-exists');
-const { isIpAddress } = require('../../util/ip');
+const UnknownError = require('../../errors/unknown-error');
 
 /**
  * @type {() => import('listr2').ListrTask<import('../../../typings/context').ListrContext>}
@@ -23,45 +21,9 @@ const createNginxConfig = () => ({
         const {
             configuration: {
                 nginx
-            },
-            ssl,
-            host
-        } = overridenConfiguration;
-
-        if (ssl.enabled) {
-            if (!(await pathExists(ssl.ssl_certificate))) {
-                throw new Error('ssl.ssl_certificate file does not exist!');
-            }
-            if (!(await pathExists(ssl.ssl_certificate_key))) {
-                throw new Error('ssl.ssl_certificate_key file does not exist!');
             }
+        } = overridenConfiguration;
 
-            const nginxCacheDir = path.join(baseConfig.cacheDir, 'nginx', 'conf.d');
-            if (!await pathExists(nginxCacheDir)) {
-                await fs.promises.mkdir(nginxCacheDir, { recursive: true });
-            }
-
-            await fs.promises.copyFile(
-                ssl.ssl_certificate,
-                path.join(
-                    baseConfig.cacheDir,
-                    'nginx',
-                    'conf.d',
-                    'ssl_certificate.pem'
-                )
-            );
-            await fs.promises.copyFile(
-                ssl.ssl_certificate_key,
-                path.join(
-                    baseConfig.cacheDir,
-                    'nginx',
-                    'conf.d',
-                    'ssl_certificate-key.pem'
-                )
-            );
-        }
-
-        const networkToBindTo = isIpAddress(host) ? host : '127.0.0.1';
         const isLinux = os.platform() === 'linux';
         const isNativeLinux = isLinux && !isWsl;
         const hostMachine = isNativeLinux ? '127.0.0.1' : 'host.docker.internal';
@@ -82,12 +44,11 @@ const createNginxConfig = () => ({
                     mageRoot: baseConfig.magentoDir,
                     hostMachine,
                     hostPort,
-                    config: overridenConfiguration,
-                    networkToBindTo
+                    config: overridenConfiguration
                 }
             });
         } catch (e) {
-            throw new Error(`Unexpected error accrued during nginx config creation\n\n${e}`);
+            throw new UnknownError(`Unexpected error accrued during nginx config creation\n\n${e}`);
         }
     }
 });

package/lib/tasks/file-system/create-php-config.js

@@ -1,4 +1,5 @@
 const semver = require('semver');
+const UnknownError = require('../../errors/unknown-error');
 const setConfigFile = require('../../util/set-config');
 
 /**
@@ -21,7 +22,7 @@ const createPhpConfig = () => ({
                 }
             });
         } catch (e) {
-            throw new Error(`Unexpected error accrued during php.ini config creation\n\n${e}`);
+            throw new UnknownError(`Unexpected error accrued during php.ini config creation\n\n${e}`);
         }
     }
 });

package/lib/tasks/file-system/create-php-fpm-config.js

@@ -1,4 +1,5 @@
 const path = require('path');
+const UnknownError = require('../../errors/unknown-error');
 const setConfigFile = require('../../util/set-config');
 
 /**
@@ -17,7 +18,7 @@ const createPhpFpmConfig = () => ({
                 }
             });
         } catch (e) {
-            throw new Error(`Unexpected error accrued during php-fpm config creation\n\n${e}`);
+            throw new UnknownError(`Unexpected error accrued during php-fpm config creation\n\n${e}`);
         }
     }
 });

package/lib/tasks/file-system/create-phpstorm-config/database-config.js

@@ -0,0 +1,249 @@
+/* eslint-disable no-param-reassign */
+const { loadXmlFile, buildXmlFile } = require('../../../config/xml-parser');
+const UnknownError = require('../../../errors/unknown-error');
+const pathExists = require('../../../util/path-exists');
+const setConfigFile = require('../../../util/set-config');
+
+/**
+ * Get link to data-source field, create fields if necessary
+ *
+ * @param {Object} data
+ * @param {Object} defaultData Default data structure that will be used if original data is missing
+ */
+const getToDataSource = (data, defaultData) => {
+    if (!data.project) {
+        data.project = defaultData.project;
+    }
+
+    if (!data.project.component) {
+        data.project.component = defaultData.project.component;
+    }
+
+    if (!data.project.component['data-source']) {
+        data.project.component['data-source'] = defaultData.project.component['data-source'];
+    }
+
+    return data.project.component['data-source'];
+};
+
+/**
+ * @type {() => import('listr2').ListrTask<import('../../../../typings/context').ListrContext>}
+ */
+const setupDataSourceLocalConfig = () => ({
+    title: 'Set up datasource local configuration',
+    task: async (ctx, task) => {
+        const {
+            config: {
+                phpStorm,
+                phpStorm: {
+                    database
+                }
+            }
+        } = ctx;
+
+        if (await pathExists(database.dataSourcesLocal.path)) {
+            let hasChanges = false;
+            const dataSourcesLocalData = await loadXmlFile(database.dataSourcesLocal.path);
+            const dataSource = getToDataSource(
+                dataSourcesLocalData,
+                {
+                    project: {
+                        '@_version': '4',
+                        component: {
+                            '@_name': 'dataSourceStorageLocal',
+                            '@_created-in': 'PS-212.5284.49',
+                            'data-source': {
+                                '@_uuid': 'a2eadb3c-6fc9-4d85-b5f4-d8114906ce2f'
+                            }
+                        }
+                    }
+                }
+            );
+
+            if (!dataSource['@_name']) {
+                hasChanges = true;
+                dataSource['@_name'] = database.dataSourceManagerName;
+            }
+
+            if (!dataSource['@_uuid']) {
+                hasChanges = true;
+                dataSource['@_uuid'] = 'a2eadb3c-6fc9-4d85-b5f4-d8114906ce2f';
+            }
+
+            const defaultDatabaseInfoConfig = {
+                '@_product': '',
+                '@_version': '',
+                '@_jdbc-version': '',
+                '@_driver-name': '',
+                '@_driver-version': '',
+                '@_dbms': 'MYSQL',
+                '@_exact-version': '0'
+            };
+            const isDatabaseInfoChangeNeeded = dataSource['database-info']
+                ? Object.entries(defaultDatabaseInfoConfig)
+                    .some(([key]) => !(key in dataSource['database-info']))
+                : true;
+
+            if (isDatabaseInfoChangeNeeded) {
+                hasChanges = true;
+                if (!dataSource['database-info']) {
+                    dataSource['database-info'] = defaultDatabaseInfoConfig;
+                } else {
+                    Object.entries(defaultDatabaseInfoConfig).forEach(([key, value]) => {
+                        if (!(key in dataSource['database-info'])) {
+                            dataSource['database-info'][key] = value;
+                        }
+                        // ^^^ only set missing properties, only ones should be in place
+                    });
+                }
+            }
+
+            const dataSourceDefaultData = {
+                'secret-storage': 'master_key',
+                'user-name': 'magento'
+            };
+
+            const isDataSourceDataChangeNeeded = dataSource
+                ? Object.entries(dataSourceDefaultData)
+                    .some(([key, value]) => dataSource[key] !== value)
+                : true;
+
+            if (isDataSourceDataChangeNeeded) {
+                hasChanges = true;
+                Object.entries(dataSourceDefaultData).forEach(([key, value]) => {
+                    dataSource[key] = value;
+                });
+            }
+
+            if (!('schema-mapping' in dataSource)) {
+                hasChanges = true;
+                dataSource['schema-mapping'] = '';
+            }
+
+            if (hasChanges) {
+                await buildXmlFile(database.dataSourcesLocal.path, dataSourcesLocalData);
+            } else {
+                task.skip();
+            }
+        } else {
+            try {
+                await setConfigFile({
+                    configPathname: phpStorm.database.dataSourcesLocal.path,
+                    template: phpStorm.database.dataSourcesLocal.templatePath,
+                    overwrite: true,
+                    templateArgs: {
+                        phpStorm
+                    }
+                });
+            } catch (e) {
+                throw new UnknownError(`Unexpected error accrued during dataSources.local.xml config creation\n\n${e}`);
+            }
+        }
+    }
+});
+
+/**
+ * @type {() => import('listr2').ListrTask<import('../../../../typings/context').ListrContext>}
+ */
+const setupDataSourceConfig = () => ({
+    task: async (ctx, task) => {
+        const {
+            config: {
+                phpStorm,
+                phpStorm: {
+                    database
+                }
+            },
+            ports
+        } = ctx;
+        const jdbcUrl = `jdbc:mysql://localhost:${ports.mysql}/magento`;
+
+        if (await pathExists(database.dataSources.path)) {
+            let hasChanges = false;
+            const dataSourcesData = await loadXmlFile(database.dataSources.path);
+            const dataSource = getToDataSource(
+                dataSourcesData,
+                {
+                    project: {
+                        '@_version': '4',
+                        component: {
+                            '@_name': 'DataSourceManagerImpl',
+                            '@_format': 'xml',
+                            '@_multifile-model': true,
+                            'data-source': {
+                                '@_source': 'LOCAL',
+                                '@_uuid': 'a2eadb3c-6fc9-4d85-b5f4-d8114906ce2f'
+                            }
+                        }
+                    }
+                }
+            );
+
+            if (dataSource['@_uuid'] === undefined) {
+                hasChanges = true;
+                dataSource['@_uuid'] = 'a2eadb3c-6fc9-4d85-b5f4-d8114906ce2f';
+            }
+
+            const expectedDataSourceData = {
+                '@_name': database.dataSourceManagerName,
+                'driver-ref': 'mysql.8',
+                synchronize: true,
+                'jdbc-driver': 'com.mysql.cj.jdbc.Driver',
+                'jdbc-url': jdbcUrl,
+                'working-dir': '$ProjectFileDir$',
+                '@_source': 'LOCAL'
+            };
+
+            const isDataSourceNeedChanges = dataSource
+                ? Object.entries(expectedDataSourceData)
+                    .some(([key]) => !(key in dataSource))
+                : true;
+
+            if (isDataSourceNeedChanges) {
+                hasChanges = true;
+                if (!dataSource) {
+                    dataSourcesData.project.component['data-source'] = expectedDataSourceData;
+                } else {
+                    Object.entries(expectedDataSourceData).forEach(([key, value]) => {
+                        if (!(key in dataSource)) {
+                            dataSource[key] = value;
+                        }
+                    });
+                }
+            }
+
+            if (hasChanges) {
+                await buildXmlFile(database.dataSources.path, dataSourcesData);
+            } else {
+                task.skip();
+            }
+        } else {
+            try {
+                await setConfigFile({
+                    configPathname: phpStorm.database.dataSources.path,
+                    template: phpStorm.database.dataSources.templatePath,
+                    overwrite: true,
+                    templateArgs: {
+                        phpStorm,
+                        jdbcUrl
+                    }
+                });
+            } catch (e) {
+                throw new UnknownError(`Unexpected error accrued during dataSources.xml config creation\n\n${e}`);
+            }
+        }
+    }
+});
+
+/**
+ * @type {() => import('listr2').ListrTask<import('../../../../typings/context').ListrContext>}
+ */
+const setupDatabaseConfig = () => ({
+    title: 'Set up database configuration',
+    task: (ctx, task) => task.newListr([
+        setupDataSourceLocalConfig(),
+        setupDataSourceConfig()
+    ])
+});
+
+module.exports = setupDatabaseConfig;

package/lib/tasks/file-system/create-phpstorm-config/eslint-config.js

@@ -0,0 +1,85 @@
+const path = require('path');
+const { loadXmlFile, buildXmlFile } = require('../../../config/xml-parser');
+const pathExists = require('../../../util/path-exists');
+const { valueKey, nameKey } = require('./keys');
+const { getCSAThemes } = require('../../../util/CSA-theme');
+const { formatPathForPHPStormConfig } = require('./xml-utils');
+
+const ESLINT_COMPONENT_NAME = 'EslintConfiguration';
+
+const pathToESLintConfig = path.join(process.cwd(), '.idea', 'jsLinters', 'eslint.xml');
+
+const defaultESLintComponentConfiguration = {
+    [nameKey]: ESLINT_COMPONENT_NAME,
+    option: {
+        [nameKey]: 'fix-on-save',
+        [valueKey]: 'true'
+    }
+};
+
+/**
+ * @type {() => import('listr2').ListrTask<import('../../../../typings/context').ListrContext>}
+ */
+const setupESLintConfig = () => ({
+    title: 'Set up ESLint configuration',
+    task: async (ctx, task) => {
+        if (await pathExists(pathToESLintConfig)) {
+            let hasChanges = false;
+            const esLintConfigurationData = await loadXmlFile(pathToESLintConfig);
+
+            if (esLintConfigurationData.project.component && !Array.isArray(esLintConfigurationData.project.component)) {
+                hasChanges = true;
+                esLintConfigurationData.project.component = [esLintConfigurationData.project.component];
+            }
+
+            const esLintConfigurationComponent = esLintConfigurationData.project.component.find(
+                (config) => config[nameKey] === ESLINT_COMPONENT_NAME
+            );
+
+            if (!esLintConfigurationComponent) {
+                hasChanges = true;
+                esLintConfigurationData.project.component.push(defaultESLintComponentConfiguration);
+            }
+
+            if (hasChanges) {
+                await buildXmlFile(pathToESLintConfig, esLintConfigurationData);
+            } else {
+                task.skip();
+            }
+
+            return;
+        }
+
+        const styleLintConfigurationData = {
+            '?xml': {
+                '@_version': '1.0',
+                '@_encoding': 'UTF-8'
+            },
+            project: {
+                '@_version': '4',
+                component: defaultESLintComponentConfiguration
+            }
+        };
+        const themes = await getCSAThemes();
+
+        if (themes.length > 0) {
+            const theme = themes[0];
+            if (await pathExists(theme.themePath)) {
+                styleLintConfigurationData.project.component['work-dir-pattern'] = {
+                    [valueKey]: formatPathForPHPStormConfig(theme.themePath)
+                };
+                const packageJsonPath = path.join(process.cwd(), theme.themePath, 'package.json');
+                if (await pathExists(packageJsonPath)) {
+                    styleLintConfigurationData.project.component['custom-configuration-file'] = {
+                        '@_used': 'true',
+                        '@_path': formatPathForPHPStormConfig(packageJsonPath)
+                    };
+                }
+            }
+        }
+
+        await buildXmlFile(pathToESLintConfig, styleLintConfigurationData);
+    }
+});
+
+module.exports = setupESLintConfig;

package/lib/tasks/file-system/create-phpstorm-config/exclude-folder-config.js

@@ -0,0 +1,154 @@
+const path = require('path');
+const { loadXmlFile, buildXmlFile } = require('../../../config/xml-parser');
+const pathExists = require('../../../util/path-exists');
+const { formatPathForPHPStormConfig } = require('./xml-utils');
+
+const pathToModulesConfig = path.join(process.cwd(), '.idea', 'modules.xml');
+const excludeFoldersPaths = [
+    'bin',
+    'dev',
+    'pub',
+    'setup',
+    'var/cache',
+    'var/page_cache',
+    'var/log'
+].map((p) => `file://$MODULE_DIR$/${p}`);
+
+/**
+ * Will retrieve project config file path from module.xml
+ *
+ * @returns {Promise<String>}
+ */
+const getProjectConfigFilePath = async () => {
+    const modulesConfigData = await loadXmlFile(pathToModulesConfig);
+    return modulesConfigData.project.component.modules.module['@_filepath'].replace('$PROJECT_DIR$', process.cwd());
+};
+
+/**
+ * @returns {Array<{'@_url': string}>}
+ */
+const getExcludedFoldersConfig = (projectConfigData) => {
+    if (!projectConfigData.module) {
+        projectConfigData.module = {
+            '@_type': 'WEB_MODULE',
+            '@_version': '4'
+        };
+    }
+
+    if (!projectConfigData.module.component) {
+        projectConfigData.module.component = {
+            '@_name': 'NewModuleRootManager',
+            orderEntry: [
+                {
+                    '@_type': 'inheritedJdk'
+                },
+                {
+                    '@_type': 'sourceFolder',
+                    '@_forTest': 'false'
+                }
+            ]
+        };
+    }
+
+    if (!projectConfigData.module.component.content) {
+        projectConfigData.module.component.content = {
+            '@_url': 'file://$MODULE_DIR$'
+        };
+    }
+
+    if (!projectConfigData.module.component.content.excludeFolder) {
+        projectConfigData.module.component.content.excludeFolder = [];
+    }
+
+    return projectConfigData
+        .module.component.content.excludeFolder;
+};
+
+const setupExcludedFolders = (excludedFoldersConfig) => {
+    let hasChanges = false;
+    // filter excluded folders to get ones that needs to be added to excluded folders list
+    const missingExcludedFolders = excludeFoldersPaths
+        .filter(
+            (excludeFoldersPath) => !excludedFoldersConfig.some(
+                (config) => config['@_url'] === excludeFoldersPath
+            )
+        );
+
+    if (missingExcludedFolders.length > 0) {
+        hasChanges = true;
+        missingExcludedFolders.forEach((missingExcludedFolder) => {
+            excludedFoldersConfig.unshift({
+                '@_url': missingExcludedFolder
+            });
+        });
+    }
+
+    return hasChanges;
+};
+
+const createModulesXML = async () => {
+    const filePath = path.join(process.cwd(), '.idea', `${path.parse(process.cwd()).base}.iml`);
+    const fileFormattedPath = formatPathForPHPStormConfig(filePath);
+    const fileFormattedUrl = `file://${fileFormattedPath}`;
+
+    const modulesConfig = {
+        '?xml': {
+            '@_version': '1.0',
+            '@_encoding': 'UTF-8'
+        },
+        project: {
+            '@_version': '4',
+            component: {
+                '@_name': 'ProjectModuleManager',
+                modules: [
+                    {
+                        module: {
+                            '@_fileurl': fileFormattedUrl,
+                            '@_filepath': fileFormattedPath
+                        }
+                    }
+                ]
+            }
+        }
+    };
+
+    await buildXmlFile(pathToModulesConfig, modulesConfig);
+
+    return filePath;
+};
+
+/**
+ * @type {() => import('listr2').ListrTask<import('../../../../typings/context').ListrContext>}
+ */
+const setupExcludedFoldersConfig = () => ({
+    title: 'Set up excluded folders configuration',
+    task: async (ctx, task) => {
+        if (await pathExists(pathToModulesConfig)) {
+            const projectFilePath = await getProjectConfigFilePath();
+            const projectConfigData = await loadXmlFile(projectFilePath);
+            const excludedFoldersConfig = getExcludedFoldersConfig(projectConfigData);
+            const hasChanges = setupExcludedFolders(excludedFoldersConfig);
+            if (hasChanges) {
+                await buildXmlFile(projectFilePath, projectConfigData);
+            } else {
+                task.skip();
+            }
+
+            return;
+        }
+
+        const projectFilePath = await createModulesXML();
+        const projectConfigData = {
+            '?xml': {
+                '@_version': '1.0',
+                '@_encoding': 'UTF-8'
+            }
+        };
+        const excludedFoldersConfig = getExcludedFoldersConfig(projectConfigData);
+        setupExcludedFolders(excludedFoldersConfig);
+
+        await buildXmlFile(projectFilePath, projectConfigData);
+    }
+});
+
+module.exports = setupExcludedFoldersConfig;

package/lib/tasks/file-system/create-phpstorm-config/index.js

@@ -0,0 +1,27 @@
+const setupWorkspaceConfig = require('./workspace-config');
+const setupPhpConfig = require('./php-config');
+const setupDatabaseConfig = require('./database-config');
+const setupInspectionToolsConfig = require('./inspection-tools-config');
+const setupExcludedFoldersConfig = require('./exclude-folder-config');
+const setupStylelintConfig = require('./stylelint-config');
+const setupESLintConfig = require('./eslint-config');
+
+/**
+ * @type {() => import('listr2').ListrTask<import('../../../../typings/context').ListrContext>}
+ */
+const createPhpStormConfig = () => ({
+    title: 'Setting PHPStorm config',
+    task: (ctx, task) => task.newListr([
+        setupWorkspaceConfig(),
+        setupPhpConfig(),
+        setupDatabaseConfig(),
+        setupInspectionToolsConfig(),
+        setupExcludedFoldersConfig(),
+        setupStylelintConfig(),
+        setupESLintConfig()
+    ], {
+        concurrent: true
+    })
+});
+
+module.exports = createPhpStormConfig;

package/lib/tasks/file-system/create-phpstorm-config/inspection-tools-config/coding-standard-config.js

@@ -0,0 +1,26 @@
+const { nameKey, valueKey } = require('../keys');
+const {
+    options: {
+        CODING_STANDARD_OPTION_NAME,
+        CUSTOM_CODING_STANDARD_OPTION_VALUE
+    }
+} = require('./config');
+
+const setupCodingStandardOption = async (config) => {
+    let hasChanges = false;
+    const codingStandardOption = config.option.find(
+        (option) => option[nameKey] === CODING_STANDARD_OPTION_NAME
+    );
+
+    if (!codingStandardOption) {
+        hasChanges = true;
+        config.option.push({
+            [nameKey]: CODING_STANDARD_OPTION_NAME,
+            [valueKey]: CUSTOM_CODING_STANDARD_OPTION_VALUE
+        });
+    }
+
+    return hasChanges;
+};
+
+module.exports = setupCodingStandardOption;