@scandipwa/magento-scripts 2.0.0-alpha.9 → 2.0.1

package/lib/tasks/requirements/docker/version.js

@@ -14,6 +14,7 @@ const getDockerVersion = () => ({
             ctx.dockerServerData = dockerVersion.Server;
             ctx.dockerClientData = dockerVersion.Client;
             ctx.dockerVersion = dockerVersion.Server.Version;
+            ctx.isDockerDesktop = dockerVersion.Server.Platform.Name.includes('Desktop');
         } else {
             throw new UnknownError(`Got unexpected result during Docker version retrieval!\n\n${ dockerVersion }`);
         }

package/lib/tasks/requirements/index.js

@@ -19,8 +19,6 @@ const checkRequirements = () => ({
         checkDocker(),
         // check for Node.js version
         checkNodeVersion(),
-        // check installed PHP version
-        // checkPHPVersion(),
         // check for COMPOSER_AUTH or auth.json
         localAuthJson(),
         checkComposerCredentials()

package/lib/tasks/requirements/php-version.js

@@ -7,8 +7,10 @@ const { runContainerImage } = require('../../util/run-container-image');
 const checkPHPVersion = () => ({
     title: 'Checking container PHP version',
     task: async (ctx, task) => {
-        const { php } = ctx.config.docker.getContainers(ctx.ports);
-        const phpVersionResponse = await runContainerImage(php.image, 'php --version');
+        const phpVersionResponse = await runContainerImage(
+            ctx.config.overridenConfiguration.configuration.php.baseImage,
+            'php --version'
+        );
 
         const phpVersionResponseResult = phpVersionResponse.match(/PHP\s(\d+\.\d+\.\d+)/i);
 

package/lib/tasks/start.js

@@ -11,7 +11,6 @@ const { prepareFileSystem } = require('./file-system');
 const { installMagentoProject, setupMagento } = require('./magento');
 const { pullImages, stopContainers } = require('./docker/containers');
 const dockerNetwork = require('./docker/network');
-const { setPrefix } = require('./prefix');
 const { connectToDatabase } = require('./database');
 const { buildProjectImage, buildDebugProjectImage } = require('./docker/project-image-builder');
 const getProjectConfiguration = require('../config/get-project-configuration');
@@ -28,6 +27,19 @@ const waitingForVarnish = require('./magento/setup-magento/waiting-for-varnish')
 const checkPHPVersion = require('./requirements/php-version');
 const volumes = require('./docker/volume/tasks');
 const convertMySQLDatabaseToMariaDB = require('./docker/convert-mysql-to-mariadb');
+const { cmaGlobalConfig } = require('../config/cma-config');
+const { setProjectConfigTask } = require('./project-config');
+const { convertComposerHomeToComposerCacheVolume } = require('./docker/convert-composer-home-to-composer-cache-volume');
+
+/**
+ * @type {() => import('listr2').ListrTask<import('../../typings/context').ListrContext>}
+ */
+const resetCmaGlobalConfig = () => ({
+    skip: (ctx) => !ctx.resetGlobalConfig,
+    task: () => {
+        cmaGlobalConfig.clear();
+    }
+});
 
 /**
  * @type {() => import('listr2').ListrTask<import('../../typings/context').ListrContext>}
@@ -39,7 +51,6 @@ const retrieveProjectConfiguration = () => ({
         checkConfigurationFile(),
         getProjectConfiguration(),
         convertLegacyVolumes(),
-        convertMySQLDatabaseToMariaDB(),
         createCacheFolder(),
         getSystemConfigTask(),
         getCachedPorts()
@@ -59,7 +70,8 @@ const retrieveProjectConfiguration = () => ({
 const stopProject = () => ({
     title: 'Stopping project',
     task: (ctx, task) => task.newListr([
-        stopContainers()
+        stopContainers(),
+        volumes.removeLocalVolumes()
     ]),
     options: {
         showTimer: false
@@ -72,7 +84,7 @@ const stopProject = () => ({
 const retrieveFreshProjectConfiguration = () => ({
     title: 'Retrieving fresh project configuration',
     task: (ctx, task) => task.newListr([
-        setPrefix(),
+        setProjectConfigTask(),
         getProjectConfiguration(),
         // get fresh ports
         getAvailablePorts(),
@@ -93,9 +105,14 @@ const retrieveFreshProjectConfiguration = () => ({
 const configureProject = () => ({
     title: 'Configuring project',
     task: (ctx, task) => task.newListr([
-        pullImages(),
-        dockerNetwork.tasks.createNetwork(),
-        volumes.createVolumes(),
+        convertMySQLDatabaseToMariaDB(),
+        {
+            task: (ctx, task) => task.newListr([
+                pullImages(),
+                dockerNetwork.tasks.createNetwork()
+            ], { concurrent: true })
+        },
+        checkPHPVersion(),
         {
             task: (ctx, task) => task.newListr([
                 buildProjectImage(),
@@ -104,9 +121,10 @@ const configureProject = () => ({
                 concurrent: true
             })
         },
-        checkPHPVersion(),
         getComposerVersionTask(),
         prepareFileSystem(),
+        volumes.createVolumes(),
+        convertComposerHomeToComposerCacheVolume(),
         installMagentoProject(),
         enableMagentoComposerPlugins(),
         startServices(),
@@ -138,6 +156,7 @@ const start = () => ({
     task: (ctx, task) => {
         task.title = `Starting project (magento-scripts@${pkg.version})`;
         return task.newListr([
+            resetCmaGlobalConfig(),
             checkRequirements(),
             retrieveProjectConfiguration(),
             stopProject(),

package/lib/tasks/status/index.js

@@ -1,3 +1,4 @@
+/* eslint-disable max-len */
 const path = require('path');
 const logger = require('@scandipwa/scandipwa-dev-utils/logger');
 const { getProjectCreatedAt, getPrefix } = require('../../util/prefix');
@@ -5,9 +6,21 @@ const { getProjectCreatedAt, getPrefix } = require('../../util/prefix');
 const { version: packageVersion } = require('../../../package.json');
 const { getArchSync } = require('../../util/arch');
 const ConsoleBlock = require('../../util/console-block');
-const { getComposerVersion } = require('../composer');
 const { getInstanceMetadata } = require('../../util/instance-metadata');
 
+const isJSON = (str) => {
+    try {
+        const result = JSON.parse(str);
+        if (typeof result === 'object') {
+            return true;
+        }
+    } catch (e) {
+        //
+    }
+
+    return false;
+};
+
 /**
  * @param {string} port
  * @return {{ host: string, hostPort: string, containerPort: string }}
@@ -22,19 +35,24 @@ const parsePort = (port) => {
     };
 };
 
+/**
+ * @param {import('../../../typings/context').ListrContext & { containers: ReturnType<Awaited<ReturnType<import('../../config/docker')>>['getContainers']> }} ctx
+ */
 const prettyStatus = async (ctx) => {
     const {
         config: {
-            baseConfig
+            baseConfig,
+            projectConfig
         },
         magentoVersion,
         dockerVersion,
         platform,
         platformVersion,
-        containers
+        containers,
+        composerVersion,
+        systemDFData
     } = ctx;
     const projectCreatedAt = getProjectCreatedAt();
-    const composerVersion = await getComposerVersion(ctx);
 
     const prefix = getPrefix();
 
@@ -45,7 +63,7 @@ const prettyStatus = async (ctx) => {
     block
         .addHeader(`magento-scripts version: ${ logger.style.link(packageVersion) }`)
         .addEmptyLine()
-        .addLine(`Project: ${logger.style.file(baseConfig.prefix)} ${prefix === folderName ? '(without prefix)' : '(with prefix)'} (with php container)`)
+        .addLine(`Project: ${logger.style.file(baseConfig.prefix)} ${prefix === folderName ? '(without prefix)' : '(with prefix)'} (with php container)${ projectConfig.debug ? ' (with debugging)' : '' }`)
         .addLine(`Project location: ${logger.style.link(process.cwd())}`);
 
     if (projectCreatedAt) {
@@ -71,19 +89,25 @@ const prettyStatus = async (ctx) => {
 
         let containerStatus;
 
-        if (container.status && container.status.Health) {
-            containerStatus = `✓ ${ logger.style.file(container.status.Health.Status) } and ${ logger.style.file('running') }`;
-        } else if (container.status) {
-            containerStatus = logger.style.file(container.status.Status);
+        if (container.status && container.status.State && container.status.State.Health) {
+            containerStatus = `✓ ${ logger.style.file(container.status.State.Health.Status) } and ${ logger.style.file('running') }`;
+        } else if (container.status && container.status.State) {
+            containerStatus = logger.style.file(container.status.State.Status);
         } else {
             containerStatus = '✖ Not running';
         }
 
         block
             .addLine(`Status: ${containerStatus}`)
-            .addLine(`Name: ${logger.style.misc(container.name)}`)
-            .addLine(`Image: ${logger.style.file(container.image)}`)
-            .addLine(`Network: ${logger.style.link(container.network)}`);
+            .addLine(`Name: ${logger.style.misc(container.name)}`);
+
+        if (container.status && container.status.Config && container.status.Config.Image) {
+            block.addLine(`Image: ${logger.style.file(container.status.Config.Image)}`);
+        } else {
+            block.addLine(`Image: ${logger.style.file(container.image)}`);
+        }
+
+        block.addLine(`Network: ${logger.style.link(container.network)}`);
 
         if (!containerStatus.includes('Not running') && container.forwardedPorts && container.forwardedPorts.length > 0) {
             block.addLine('Port forwarding:');
@@ -100,11 +124,60 @@ const prettyStatus = async (ctx) => {
         if (container.env && Object.keys(container.env).length > 0) {
             block.addLine('Environment variables:');
             for (const [envName, envValue] of Object.entries(container.env)) {
-                block.addLine(`${' '.repeat(3)} ${logger.style.misc(envName)}=${logger.style.file(envValue)}`);
+                if (isJSON(envValue)) {
+                    const beautifyJSONLines = JSON.stringify(JSON.parse(envValue), null, 1).split('\n');
+
+                    block.addLine(`${' '.repeat(3)} ${logger.style.misc(envName)}=${logger.style.file(beautifyJSONLines.shift())}`);
+
+                    let currentOpeningBracket = 0;
+
+                    beautifyJSONLines.forEach((line) => {
+                        block.addLine(`${'  '.repeat(2 + currentOpeningBracket)}${logger.style.file(line)}`);
+                        if (['{', '['].some((openingBracketVariant) => line.includes(openingBracketVariant))) {
+                            currentOpeningBracket++;
+                        } else if (['}', ']'].some((closingBracketVariant) => line.includes(closingBracketVariant))) {
+                            currentOpeningBracket--;
+                        }
+                    });
+                } else {
+                    block.addLine(`${' '.repeat(3)} ${logger.style.misc(envName)}=${logger.style.file(envValue)}`);
+                }
             }
         }
+
+        if (container.description) {
+            block.addLine('Description:');
+            container.description.split('\n').forEach((line) => {
+                block.addLine(line);
+            });
+        }
     });
 
+    block
+        .addSeparator('Docker volume data')
+        .addEmptyLine();
+
+    const { volumes } = ctx.config.docker;
+
+    Object.values(volumes)
+        .map((volume) => {
+            volume.volumeData = systemDFData.Volumes
+                .find((v) => v.Name === volume.name);
+
+            return volume;
+        })
+        .forEach((v) => {
+            block
+                .addLine(`> ${logger.style.misc(v.name)}`);
+            if (v.volumeData) {
+                block.addLine(`Size: ${logger.style.code(v.volumeData.Size)}`);
+            }
+
+            if (ctx.isDockerDesktop && v.opt && v.opt.device) {
+                block.addLine(`Mountpoint: ${logger.style.file(v.opt.device.replace(process.cwd(), '<project location>'))}`);
+            }
+        });
+
     const instanceMetadata = getInstanceMetadata(ctx);
 
     block
@@ -123,14 +196,6 @@ const prettyStatus = async (ctx) => {
     instanceMetadata.admin.forEach(({ title, text }) => {
         block.addLine(`  ${title}: ${text}`);
     });
-    // block
-    //     .addEmptyLine()
-    //     .addSeparator('Magento status')
-    //     .addEmptyLine()
-    //     .addLine(`Web location: ${logger.style.link(`${ssl.enabled ? 'https' : 'http'}://${host}${ports.app === 80 ? '' : `:${ports.app}`}/`)}`)
-    //     .addLine(`Magento Admin panel location: ${logger.style.link(`${ssl.enabled ? 'https' : 'http'}://${host}${ports.app === 80 ? '' : `:${ports.app}`}/${magentoConfiguration.adminuri}`)}`)
-    //     .addLine(`Magento Admin panel credentials: ${logger.style.misc(magentoConfiguration.user)} - ${logger.style.misc(magentoConfiguration.password)}`)
-    //     .addEmptyLine();
 
     block.log();
 };

package/lib/tasks/stop.js

@@ -2,6 +2,7 @@ const { stopServices } = require('./docker');
 const getMagentoVersionConfig = require('../config/get-magento-version-config');
 const getProjectConfiguration = require('../config/get-project-configuration');
 const checkConfigurationFile = require('../config/check-configuration-file');
+const getDockerVersion = require('./requirements/docker/version');
 
 /**
  * @type {() => import('listr2').ListrTask<import('../../typings/context').ListrContext>}
@@ -9,6 +10,7 @@ const checkConfigurationFile = require('../config/check-configuration-file');
 const stop = () => ({
     title: 'Stopping project',
     task: async (ctx, task) => task.newListr([
+        getDockerVersion(),
         getMagentoVersionConfig(),
         checkConfigurationFile(),
         getProjectConfiguration(),

package/lib/tasks/theme/retrieve-theme-data.js

@@ -1,3 +1,4 @@
+const logger = require('@scandipwa/scandipwa-dev-utils/logger');
 const path = require('path');
 const KnownError = require('../../errors/known-error');
 const getJsonfileData = require('../../util/get-jsonfile-data');
@@ -9,12 +10,21 @@ const pathExists = require('../../util/path-exists');
 const retrieveThemeData = (themePath) => ({
     title: 'Checking theme folder',
     task: async (ctx) => {
-        let absoluteThemePath = path.join(process.cwd(), themePath);
+        let absoluteThemePath = path.resolve(themePath);
+
+        // validate if theme is located inside magento directory
+        if (!absoluteThemePath.includes(process.cwd())) {
+            throw new KnownError(`You are trying to link the theme from outside of your Magento project!
+
+This is not supported in ${ logger.style.command('magento-scripts') } version 2.
+
+Move your theme inside Magento project!`);
+        }
 
         // check if path not relative
         if (!(await pathExists(path.join(absoluteThemePath, 'composer.json')))) {
             // if composer.json is not found, then it's not correct path
-            // and we need to test if it's alsolute one
+            // and we need to test if it's absolute one
             if (await pathExists(path.join(themePath, 'composer.json'))) {
                 // if so, use it as absolute path
                 absoluteThemePath = themePath;

package/lib/util/config-file-validator.js

@@ -53,8 +53,9 @@ const phpExtensionConfiguration = Joi.object()
     .pattern(
         Joi.string(),
         Joi.object({
+            name: Joi.string().optional(),
             alternativeName: Joi.array().items(Joi.string()).optional(),
-            command: Joi.func().optional(),
+            command: Joi.alternatives().try(Joi.func(), Joi.string()).optional(),
             dependencies: Joi.array().items(Joi.string()).optional(),
             version: Joi.string().optional()
         })
@@ -69,6 +70,7 @@ const phpConfigurationSchema = Joi.object({
     debugImage: Joi.string().optional(),
     fpmConfigTemplate: Joi.string().optional(),
     configTemplate: Joi.string().optional().custom(fileExistsValidator),
+    debugTemplate: Joi.string().optional().custom(fileExistsValidator),
     extensions: phpExtensionConfiguration.optional()
 });
 
@@ -85,6 +87,7 @@ const nginxConfigurationSchema = Joi.object({
  */
 const varnishConfigurationSchema = Joi.object({
     enabled: Joi.boolean().optional(),
+    healthCheck: Joi.boolean().optional(),
     image: Joi.string().optional(),
     configTemplate: Joi.string().optional().custom(fileExistsValidator)
 });
@@ -114,7 +117,17 @@ const composerConfigurationSchema = Joi.object({
         }
 
         return versionValidator(value);
-    })
+    }),
+    plugins: Joi.object()
+        .pattern(
+            Joi.string(),
+            Joi.object({
+                version: Joi.string().optional(),
+                options: Joi.string().optional(),
+                enabled: Joi.boolean().optional()
+            })
+                .unknown()
+        )
 });
 
 /**
@@ -128,7 +141,8 @@ const configurationSchema = Joi.object({
     redis: serviceConfigurationSchema.optional(),
     composer: composerConfigurationSchema.optional(),
     varnish: varnishConfigurationSchema.optional(),
-    sslTerminator: nginxConfigurationSchema.optional()
+    sslTerminator: nginxConfigurationSchema.optional(),
+    maildev: serviceConfigurationSchema.optional()
 });
 
 /**

package/lib/util/connection-string.js

@@ -0,0 +1,62 @@
+/**
+ * @typedef ParsedConnection
+ * @prop {String} protocol
+ * @prop {String} [user]
+ * @prop {String} [port]
+ * @prop {String} host
+ * @prop {String} [hostname]
+ * @prop {String[]} [segments]
+ * @prop {Record<string, string} params
+ */
+
+/**
+ * @param {String} url
+ * @returns {ParsedConnection}
+ */
+const connectionStringParser = (url) => {
+    // eslint-disable-next-line no-useless-escape
+    const pattern = /^(?:([^:\/?#\s]+):\/{2})?(?:([^@\/?#\s]+)@)?([^\/?#\s]+)?(?:\/([^?#\s]*))?(?:[?]([^#\s]+))?\S*$/;
+    const matches = url.match(pattern);
+    const params = {};
+    if (matches[5] !== undefined) {
+        matches[5].split('&').forEach((x) => {
+            const a = x.split('=');
+            params[a[0]] = a[1];
+        });
+    }
+
+    return {
+        protocol: matches[1],
+        user: matches[2] !== undefined ? matches[2].split(':')[0] : undefined,
+        password: matches[2] !== undefined ? matches[2].split(':')[1] : undefined,
+        host: matches[3],
+        hostname: matches[3] !== undefined ? matches[3].split(/:(?=\d+$)/)[0] : undefined,
+        port: matches[3] !== undefined ? matches[3].split(/:(?=\d+$)/)[1] : undefined,
+        segments: matches[4] !== undefined ? matches[4].split('/') : undefined,
+        params
+    };
+};
+
+/**
+ * @param {ParsedConnection} options
+ * @returns {String}
+ */
+const connectionStringBuilder = (options) => {
+    const {
+        protocol,
+        user,
+        password,
+        host,
+        port,
+        segments,
+        params
+    } = options;
+
+    // eslint-disable-next-line max-len
+    return `${protocol}://${(user && password) ? `${user}:${password}@` : ''}${host}${port ? `:${port}` : ''}/${(segments && segments.length > 0) ? segments.join('/') : ''}${new URLSearchParams(params).toString()}`;
+};
+
+module.exports = {
+    connectionStringParser,
+    connectionStringBuilder
+};

package/lib/util/execute-in-container.js

@@ -1,17 +1,18 @@
-const os = require('os');
 const { spawn } = require('child_process');
 const { runCommand } = require('../tasks/docker/containers/container-api');
 
 /**
- * @param {{ containerName: string, commands: string[] }} param0
+ * @param {{ containerName: string, commands: string[], user?: string }} param0
  */
-const executeInContainer = ({ containerName, commands }) => {
+const executeInContainer = ({
+    containerName, commands, user
+}) => {
     if (!process.stdin.isTTY) {
         process.stderr.write('This app works only in TTY mode');
         process.exit(1);
     }
 
-    const userArg = os.platform() === 'linux' && `--user=${os.userInfo().uid}:${os.userInfo().gid}`;
+    const userArg = user && `--user=${user}`;
 
     spawn('docker', [
         'exec',
@@ -45,12 +46,10 @@ const runInContainer = (options, commands) => {
         tty: true,
         detach: false,
         rm: true,
-        command: commands.map((command) => command.split(' ')).flat().join(' ')
+        command: commands.join(' ')
     });
 
-    const args = runArgs.slice(1).map((command) => command.split(' ')).flat();
-
-    spawn('docker', args, { stdio: [0, 1, 2] });
+    spawn('bash', ['-c', runArgs.join(' ')], { stdio: [0, 1, 2] });
 
     return new Promise((_resolve) => {
         // never resolve

package/lib/util/instance-metadata.js

@@ -4,6 +4,7 @@ const WEB_LOCAL_LOCATION_TITLE = `Location on ${ logger.style.misc('localhost')
 const WEB_LOCATION_TITLE = 'Location on the Web';
 const WEB_ADMIN_LOCATION_TITLE = 'Panel location';
 const WEB_ADMIN_CREDENTIALS_TITLE = 'Panel credentials';
+const WEB_MAILDEV_LOCATION_TITLE = 'Panel location';
 
 const mapDataStyle = ({ title, text }) => ({
     title,
@@ -13,7 +14,7 @@ const mapDataStyle = ({ title, text }) => ({
 
 /**
  * @param {import("../../typings/context").ListrContext} ctx
- * @return {{ frontend: { title: string, text: string }[], admin: { title: string, url: string }[]}}
+ * @return {{ frontend: { title: string, text: string }[], admin: { title: string, url: string }[], maildev: { title: string, text: string }[] }}
  */
 const getInstanceMetadata = (ctx) => {
     const {
@@ -34,6 +35,11 @@ const getInstanceMetadata = (ctx) => {
      */
     const admin = [];
 
+    /**
+     * @type {{ title: string, text: string }[]}
+     */
+    const maildev = [];
+
     const isNgrok = host.endsWith('ngrok.io');
 
     if (isNgrok) {
@@ -64,9 +70,15 @@ const getInstanceMetadata = (ctx) => {
         text: `${logger.style.misc(magentoConfiguration.user)} - ${logger.style.misc(magentoConfiguration.password)}`
     });
 
+    maildev.push({
+        title: WEB_MAILDEV_LOCATION_TITLE,
+        text: `http://${host}:${ports.maildevWeb}/`
+    });
+
     return {
         admin,
-        frontend: frontend.map(mapDataStyle)
+        frontend: frontend.map(mapDataStyle),
+        maildev: maildev.map(mapDataStyle)
     };
 };
 

package/lib/util/systemctl.js

@@ -3,10 +3,10 @@ const { execAsyncSpawn } = require('./exec-async-command');
 /**
  * @param {String} cmd
  * @param {String} serviceName
- * @param {{ now: boolean }} options
+ * @param {{ now: boolean, user: boolean }} options
  */
 const run = (cmd, serviceName, options = {}) => execAsyncSpawn(
-    `systemctl ${ cmd }${ serviceName ? ` ${ serviceName }` : '' }${ options.now ? ' --now' : ''}`,
+    `systemctl ${ options.user ? '--user ' : '' }${ cmd }${ serviceName ? ` ${ serviceName }` : '' }${ options.now ? ' --now' : ''}`,
     {
         withCode: true
     }
@@ -14,29 +14,78 @@ const run = (cmd, serviceName, options = {}) => execAsyncSpawn(
 
 const daemonReload = () => run('daemon-reload');
 
-const systemctlControl = (serviceName) => ({
-    disable: () => run('disable', serviceName),
-    enable: () => run('enable', serviceName),
-    enableAndStart: () => run('enable', serviceName, { now: true }),
-    restart: () => run('restart', serviceName),
-    start: () => run('start', serviceName),
-    stop: () => run('stop', serviceName),
-    isEnabled: async () => {
+/**
+ * @param {String} serviceName
+ * @param {{ now: boolean, user: boolean }} defaultOptions
+ */
+const systemctlControl = (serviceName, defaultOptions = {}) => ({
+    /**
+     * @param {{ now: boolean, user: boolean }} options
+     */
+    disable: (options = {}) => run('disable', serviceName, { ...defaultOptions, ...options }),
+    /**
+     * @param {{ now: boolean, user: boolean }} options
+     */
+    enable: (options = {}) => run('enable', serviceName, { ...defaultOptions, ...options }),
+    /**
+     * @param {{ now: boolean, user: boolean }} options
+     */
+    enableAndStart: (options = {}) => run('enable', serviceName, { now: true, ...defaultOptions, ...options }),
+    /**
+     * @param {{ now: boolean, user: boolean }} options
+     */
+    restart: (options = {}) => run('restart', serviceName, { ...defaultOptions, ...options }),
+    /**
+     * @param {{ now: boolean, user: boolean }} options
+     */
+    start: (options = {}) => run('start', serviceName, { ...defaultOptions, ...options }),
+    /**
+     * @param {{ now: boolean, user: boolean }} options
+     */
+    stop: (options = {}) => run('stop', serviceName, { ...defaultOptions, ...options }),
+    /**
+     * @param {{ now: boolean, user: boolean }} options
+     */
+    isEnabled: async (options = {}) => {
         try {
-            const { result } = await run('is-enabled', serviceName);
+            const { result } = await run('is-enabled', serviceName, { ...defaultOptions, ...options });
             return result.includes('enabled');
         } catch (e) {
             return false;
         }
     },
-    isRunning: async () => {
+    /**
+     * @param {{ now: boolean, user: boolean }} options
+     */
+    isRunning: async (options = {}) => {
         try {
-            const { result } = await run('status', serviceName);
+            const { result } = await run('status', serviceName, { ...defaultOptions, ...options });
 
             return result.includes('active (running)');
         } catch (e) {
             return false;
         }
+    },
+    /**
+     * @param {{ user: boolean }} options
+     */
+    exists: async (options = {}) => {
+        const optionsToUse = { ...defaultOptions, ...options };
+        try {
+            // eslint-disable-next-line max-len, no-useless-escape
+            const command = `if [[ $(systemctl ${ optionsToUse.user ? '--user ' : ''}list-units --all -t service --full --no-legend "${ serviceName }.service" | sed 's/^\\s*//g' | cut -f1 -d' ') == ${ serviceName }.service ]]; then
+                echo "1"
+            else
+                echo "0"
+            fi`;
+            const result = await execAsyncSpawn(
+                command
+            );
+
+            return result === '1';
+        } catch (e) {
+            return false;
+        }
     }
 });
 

package/package.json

@@ -3,7 +3,7 @@
     "description": "Scripts and configuration used by CMA.",
     "homepage": "https://docs.create-magento-app.com/",
     "repository": "github:scandipwa/create-magento-app",
-    "version": "2.0.0-alpha.9",
+    "version": "2.0.1",
     "main": "./index.js",
     "types": "./typings/index.d.ts",
     "license": "OSL-3.0",
@@ -54,5 +54,5 @@
         "mysql",
         "scandipwa"
     ],
-    "gitHead": "0fad81d40dcadf7f9b239d310062c09338c11601"
+    "gitHead": "2b9e8f9a3a42beba42f64765585f86955b25b0d0"
 }