@nizza/devkit 0.1.0-alpha.1 → 0.1.0-alpha.11

package/dist/cjs/vite-utils/config-builder/shared/utils/helpers.cjs

@@ -0,0 +1,115 @@
+'use strict';
+
+var devkit = require('@nx/devkit');
+var path = require('path');
+var R = require('ramda');
+require('../../../../shared/logger.cjs');
+var utils = require('../../../../shared/utils.cjs');
+
+function _interopNamespaceDefault(e) {
+  var n = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach(function (k) {
+      if (k !== 'default') {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  }
+  n.default = e;
+  return Object.freeze(n);
+}
+
+var R__namespace = /*#__PURE__*/_interopNamespaceDefault(R);
+
+/**
+ * Deeply merges two objects, combining their properties.
+ *
+ * @param {Record<string, any>} v1 - The first object.
+ * @param {Record<string, any>} v2 - The second object.
+ * @returns {Record<string, any>} - The merged object.
+ *
+ * @example
+ * const obj1 = { a: 1, b: { c: 2 } };
+ * const obj2 = { b: { d: 3 } };
+ * const merged = deepMerge(obj1, obj2);  // Outputs: { a: 1, b: { c: 2, d: 3 } }
+ */ function deepMerge(v1, v2) {
+    if (Array.isArray(v1) && Array.isArray(v2)) {
+        return R__namespace.uniq(R__namespace.concat(v1, v2));
+    } else if (typeof v1 === 'object' && typeof v2 === 'object' && !R__namespace.isNil(v1) && !R__namespace.isNil(v2)) {
+        return R__namespace.mergeWith(deepMerge, v1, v2);
+    } else {
+        return v2;
+    }
+}
+/**
+ * Generates a name for js files.
+ *
+ * @param {string} [prefix] - An optional prefix for the chunk name.
+ * @returns - A function that takes an item and generates a chunk name.
+ *
+ * @example
+ * const generateChunkName = chunkName('prefix');
+ * const name = generateChunkName({ name: 'example' });  // Outputs: "prefix-example-Aj3_Dk7_2j.js"
+ */ const chunkName = (prefix)=>(x)=>{
+        const nameWithoutUnderscore = x.name.replace(/_/g, '');
+        const pre = prefix ? `${prefix}-` : '';
+        return `${pre}${nameWithoutUnderscore}-${utils.shortId(8)}.js`;
+    };
+/**
+ * Returns the given object if the condition is true, otherwise returns null.
+ *
+ * @param {any} condition - The condition to evaluate.
+ * @param {Record<string, any>} obj - The object to return if the condition is true.
+ * @returns {Record<string, any> | null} - The object or null based on the condition.
+ *
+ * @example
+ * const obj = { a: 1 };
+ * const result = when(true, obj);  // Outputs: { a: 1 }
+ * const result2 = when(false, obj);  // Outputs: {}
+ */ const when = (condition, obj)=>condition ? obj : {};
+/**
+ * Filters and generates plugin configurations based on conditions and the provided context.
+ *
+ * @param {Context} ctx - The main configuration object.
+ * @returns {any[]} - An array of generated plugin configurations.
+ */ const getPlugins = (ctx, ...pluginConfigs)=>pluginConfigs// Filters the plugins based on conditions
+    .filter((p)=>!p.condition || p.condition(ctx))// Generates the configuration of each plugin and flattens the resulting array
+    .flatMap((p)=>p.generate(ctx));
+/**
+ * Gets the paths to the tsconfig files for all relevant projects.
+ *
+ * @returns {string[]} - An array containing paths to tsconfig files for both app and lib projects.
+ *
+ * @example
+ * const projects = {
+ *   'my-app': {
+ *     type: 'app',
+ *     data: { root: 'apps/my-app' }
+ *   },
+ *   'my-lib': {
+ *     type: 'lib',
+ *     data: { root: 'libs/my-lib' }
+ *   }
+ * };
+ *
+ * const tsConfigPaths = getTsConfigPaths(projects);
+ * console.log(tsConfigPaths);
+ * // Output:
+ * // ['apps/my-app/tsconfig.app.json', 'libs/my-lib/tsconfig.lib.json']
+ */ const getNxTsConfigPaths = ()=>{
+    const isValid = (p)=>p.data.root.startsWith('apps/') || p.data.root.startsWith('libs/');
+    const getTsConfigPath = (p)=>path.resolve(p.data.root, `tsconfig.${p.type === 'app' ? 'app' : 'lib'}.json`);
+    const graph = devkit.readCachedProjectGraph();
+    const projects = graph.nodes;
+    return Object.values(projects).filter(isValid).map(getTsConfigPath);
+};
+
+exports.chunkName = chunkName;
+exports.deepMerge = deepMerge;
+exports.getNxTsConfigPaths = getNxTsConfigPaths;
+exports.getPlugins = getPlugins;
+exports.when = when;

package/dist/cjs/vite-utils/config-builder/shared/utils/projectConfig.cjs

@@ -0,0 +1,114 @@
+'use strict';
+
+var minimatch = require('minimatch');
+var logger = require('../../../../shared/logger.cjs');
+var utils = require('../../../../shared/utils.cjs');
+var types = require('../types.cjs');
+var helpers = require('./helpers.cjs');
+var viteCommand = require('./viteCommand.cjs');
+
+/**
+ * Initializes the project configuration with default values.
+ *
+ * @example
+ * const config = { type: ProjectType.APP, path: '/path/to/project', viteEnv: { mode: ViteMode.DEV } };
+ * const initializedConfig = initializeConfig(config);
+ */ const initializeConfig = (ccfg, pcfg, localPkgJson)=>{
+    const { envPrefix } = ccfg;
+    const localPkgName = localPkgJson['name'];
+    const { name = localPkgName, overrides = {}, shadowDom = false, chunkPrefix = getInitials(localPkgName), resolveEnvs = {
+        default: true,
+        local: true
+    }, fileName = `${envPrefix}-${chunkPrefix}-index`, externalizeLibs = {
+        default: true,
+        glob: []
+    } } = pcfg;
+    const viteCmd = viteCommand.getViteCommand(pcfg.viteEnv.mode);
+    const isVerbose = Object.keys(viteCmd.flags).some((x)=>[
+            types.Flag.VERBOSE,
+            types.Flag.VERBOSE_ALIAS
+        ].includes(x));
+    const logLevel = isVerbose ? logger.LogLevel.DEBUG : pcfg.logLevel ?? logger.LogLevel.INFO;
+    logger.setLogLevel(logLevel);
+    return {
+        viteCmd,
+        cfg: {
+            ...pcfg,
+            name,
+            fileName,
+            logLevel,
+            overrides,
+            chunkPrefix,
+            shadowDom,
+            resolveEnvs,
+            externalizeLibs: externalizeLibs
+        }
+    };
+};
+/**
+ * Handles merging configurations and logs any errors.
+ *
+ * @param {UserConfig} defaultConfig - The default configuration.
+ * @param {UserConfig} overrides - The overrides configuration.
+ * @returns {UserConfig} - The merged configuration.
+ */ const mergeConfigs = (defaultConfig, overrides)=>{
+    try {
+        return helpers.deepMerge(defaultConfig, overrides);
+    } catch (err) {
+        logger.logger.error('Error merging vite configs: ', err);
+        return defaultConfig;
+    }
+};
+/**
+ * Resolves glob patterns to actual package names found in package.json dependencies.
+ * This function is used to determine which packages should be treated as external
+ * in a Rollup or Vite build configuration.
+ *
+ * @param {string} path - The base path where package.json is located.
+ * @param {string | string[]} globs - A glob pattern or an array of glob patterns to match dependencies against.
+ * @returns {string[]} An array of package names that match the given glob patterns.
+ *
+ * @example
+ * // Example of using `getExternalDependencies` to find all dependencies starting with "my-lib" and "lodash"
+ * const projectPath = '/path/to/project';
+ * const globs = ['my-lib*', 'lodash'];
+ * const externalDependencies = getExternalDependencies(projectPath, globs);
+ * console.log(externalDependencies);
+ * // Output might be: ['my-lib/utils', 'my-lib/core', 'lodash']
+ */ const getExternalDependencies = (path, globs = [])=>{
+    const pkgJson = utils.getPkgJson(path); // Assumes getLocalPkgJson is a function that reads and parses package.json
+    const dependencies = Object.keys(pkgJson.dependencies || {});
+    const globPatterns = Array.isArray(globs) ? globs : [
+        globs
+    ];
+    return dependencies.filter((dep)=>globPatterns.some((pattern)=>minimatch.minimatch(dep, pattern)));
+};
+/**
+ * Generates a string of initials based on the input string,
+ * following certain rules:
+ * 1. A word is considered as a sequence of characters
+ * separated by hyphens.
+ * 2. If the string contains '@', any characters before
+ * and including the next '/' are ignored.
+ * 3. The first character of each word is taken to form
+ * the initials.
+ *
+ * @param {string} input - The input string from which to generate the initials.
+ * @returns {string} The initials formed by taking the first character
+ * of each word, after applying the specified rules.
+ *
+ * @example
+ * getInitials("player-script"); // returns "ps"
+ * getInitials("ssv-admin"); // returns "sa"
+ * getInitials("@nizza/customize-live"); // returns "cl"
+ */ function getInitials(input) {
+    const cleanedInput = input.includes('@') ? input.split('/')[1] : input;
+    const words = cleanedInput?.split('-');
+    const initials = words?.map((word)=>word.charAt(0)).join('');
+    return initials ?? '';
+}
+
+exports.getExternalDependencies = getExternalDependencies;
+exports.getInitials = getInitials;
+exports.initializeConfig = initializeConfig;
+exports.mergeConfigs = mergeConfigs;

package/dist/cjs/vite-utils/config-builder/shared/utils/viteCommand.cjs

@@ -0,0 +1,59 @@
+'use strict';
+
+var chalk = require('chalk');
+var argv = require('mri');
+var vite = require('vite');
+var types = require('../types.cjs');
+
+/**
+ * Retrieves the Vite command details.
+ *
+ * @param {ViteMode} mode - The Vite mode.
+ * @returns {ViteCommand} - The command details.
+ *
+ * @example
+ * const command = getViteCommand(ViteMode.PROD);
+ * // Outputs: { stage: Stage.PROD, target: 'build', flags: {} }
+ */ function getViteCommand(mode) {
+    const nxEnv = vite.loadEnv(mode, process.cwd(), 'NX');
+    const nxCommandString = process?.env?.['npm_package_scripts_nx'];
+    const modeIsProd = mode === types.ViteMode.PROD;
+    const stage = (nxEnv?.['NX_TASK_TARGET_CONFIGURATION']) ?? (modeIsProd ? types.Stage.PROD : types.Stage.DEV);
+    const target = nxEnv?.['NX_TASK_TARGET_TARGET'] ?? types.Target.BUILD;
+    const flags = getViteCmdFlags(nxCommandString);
+    const showIn = {
+        prod: (...args)=>modeIsProd && console.log(...args),
+        dev: (...args)=>!modeIsProd && console.log(...args)
+    };
+    try {
+        showIn.prod(chalk.cyan('Build Stage:'), chalk.green(stage));
+        showIn.dev(chalk.green('  ➜ '), chalk.bold.white(`Stage:  `), chalk.cyan(stage));
+    } catch  {
+        showIn.prod(console.log('Build Stage:', stage));
+        showIn.dev(console.log(`  ➜  Stage:  `, stage));
+    }
+    return {
+        stage,
+        target,
+        flags
+    };
+}
+/**
+ * Parses the command string to extract flags.
+ *
+ * @param {string | undefined} commandString - The command string.
+ * @returns {Record<string, string>} - The flags extracted from the command string.
+ *
+ * @example
+ * const flags = getViteCmdFlags('nx run core:build --source-maps');
+ * // Outputs: { 'source-maps: 'true' }
+ */ function getViteCmdFlags(commandString) {
+    if (!commandString) return {};
+    const cleanedCommandString = commandString.replace(/"/g, '');
+    const args = argv(cleanedCommandString.split(' '));
+    delete args['_'];
+    return args;
+}
+
+exports.getViteCmdFlags = getViteCmdFlags;
+exports.getViteCommand = getViteCommand;

package/dist/{src/vite/plugins/shadow-dom-inject-css/index.js → cjs/vite-utils/plugins/shadow-dom-inject-css/index.cjs}

@@ -1,21 +1,5 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-function _export(target, all) {
-    for(var name in all)Object.defineProperty(target, name, {
-        enumerable: true,
-        get: all[name]
-    });
-}
-_export(exports, {
-    default: function() {
-        return _default;
-    },
-    injectCssIntoShadowDom: function() {
-        return injectCssIntoShadowDom;
-    }
-});
+'use strict';
+
 function injectCssIntoShadowDom() {
     const fileRegex = /\.(css)$/;
     let server;
@@ -41,4 +25,5 @@ function injectCssIntoShadowDom() {
         }
     };
 }
-const _default = injectCssIntoShadowDom;
+
+exports.injectCssIntoShadowDom = injectCssIntoShadowDom;

package/dist/{src/vite/plugins/third-party-css-inject/main.js → cjs/vite-utils/plugins/third-party-css-inject/main.cjs}

@@ -1,15 +1,12 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "thirdPartyCssInjectPlugin", {
-    enumerable: true,
-    get: function() {
-        return thirdPartyCssInjectPlugin;
-    }
-});
-const _utils = require("./utils");
-function thirdPartyCssInjectPlugin({ topExecutionPriority, execute } = {
+'use strict';
+
+var utils = require('./utils.cjs');
+
+/**
+ * Inject the CSS compiled with JS.
+ *
+ * @return {Plugin}
+ */ function thirdPartyCssInjectPlugin({ topExecutionPriority, execute } = {
     topExecutionPriority: true,
     execute: []
 }) {
@@ -33,12 +30,12 @@ function thirdPartyCssInjectPlugin({ topExecutionPriority, execute } = {
                 const htmlChunk = bundle[name];
                 let replacedHtml = htmlChunk.source;
                 cssAssets.forEach((cssName)=>{
-                    replacedHtml = (0, _utils.removeLinkStyleSheets)(replacedHtml, cssName);
+                    replacedHtml = utils.removeLinkStyleSheets(replacedHtml, cssName);
                     htmlChunk.source = replacedHtml;
                 });
             }
             const jsAsset = bundle[jsAssets[0]];
-            const cssInjectionCode = await (0, _utils.buildCSSInjectionCode)(execute);
+            const cssInjectionCode = await utils.buildCSSInjectionCode(execute);
             const appCode = jsAsset.code;
             jsAsset.code = topExecutionPriority ? '' : appCode;
             jsAsset.code += cssInjectionCode ? cssInjectionCode.code : '';
@@ -46,3 +43,5 @@ function thirdPartyCssInjectPlugin({ topExecutionPriority, execute } = {
         }
     };
 }
+
+exports.thirdPartyCssInjectPlugin = thirdPartyCssInjectPlugin;

package/dist/{src/vite/plugins/third-party-css-inject/utils.js → cjs/vite-utils/plugins/third-party-css-inject/utils.cjs}

@@ -1,22 +1,7 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-function _export(target, all) {
-    for(var name in all)Object.defineProperty(target, name, {
-        enumerable: true,
-        get: all[name]
-    });
-}
-_export(exports, {
-    buildCSSInjectionCode: function() {
-        return buildCSSInjectionCode;
-    },
-    removeLinkStyleSheets: function() {
-        return removeLinkStyleSheets;
-    }
-});
-const _vite = require("vite");
+'use strict';
+
+var vite = require('vite');
+
 const cssInjectedByJsId = '\0vite/all-css';
 const waitForElement = (selector, observerElementName = 'body')=>{
     const getElement = (selector)=>document.querySelector(selector);
@@ -47,7 +32,7 @@ const waitForElement = (selector, observerElementName = 'body')=>{
     });
 };
 async function buildCSSInjectionCode(execute) {
-    const res = await (0, _vite.build)({
+    const res = await vite.build({
         root: '',
         configFile: false,
         logLevel: 'error',
@@ -101,7 +86,7 @@ async function buildCSSInjectionCode(execute) {
                 return `try{if(typeof document != 'undefined'){
         const waitForElement=${waitForElement.toString()};
         ${executeJs.join(' ')}
-      }}catch(e){console.error('vite-third-party-css-inject-plugin', e);}`;
+      }}catch(e){console.error('vite'-third-party-css-inject-plugin', e);}`;
             }
         }
     };
@@ -110,3 +95,6 @@ function removeLinkStyleSheets(html, cssFileName) {
     const removeCSS = new RegExp(`<link rel=".*"[^>]*?href=".*/?${cssFileName}"[^>]*?>`);
     return html.replace(removeCSS, '');
 }
+
+exports.buildCSSInjectionCode = buildCSSInjectionCode;
+exports.removeLinkStyleSheets = removeLinkStyleSheets;

package/dist/esm/executors/deploy/helpers.mjs

@@ -0,0 +1,22 @@
+import { logger } from '@nx/devkit';
+import { runCommand } from '../shared/utils.mjs';
+
+async function cleanS3Bucket(s3BucketPath) {
+    logger.info('🧹 Cleaning S3 bucket...');
+    await runCommand(`aws s3 rm ${s3BucketPath} --recursive`);
+    logger.info('✅ S3 bucket cleared.');
+}
+async function copyAssetsToS3(s3BucketPath, projectRoot) {
+    logger.info('📦 Copying assets to S3 bucket...');
+    await runCommand(`aws s3 cp ${projectRoot}/dist ${s3BucketPath} --recursive`);
+    logger.info('🚚 Assets files copied.');
+}
+async function createCloudFrontInvalidation(distributionId, invalidationPaths) {
+    const pathsString = invalidationPaths.map((path)=>`"${path}"`).join(' ');
+    const command = `aws cloudfront create-invalidation --distribution-id ${distributionId} --paths ${pathsString}`;
+    logger.info('🔃 Creating invalidation for CloudFront...');
+    await runCommand(command);
+    logger.info('🔄 CloudFront invalidation created.');
+}
+
+export { cleanS3Bucket, copyAssetsToS3, createCloudFrontInvalidation };

package/dist/esm/executors/deploy/index.mjs

@@ -0,0 +1,20 @@
+import { getProjectConfig, runCommand, ok, err } from '../shared/utils.mjs';
+import { cleanS3Bucket, copyAssetsToS3, createCloudFrontInvalidation } from './helpers.mjs';
+
+async function deployExecutor(opts, ctx) {
+    try {
+        const { root, name } = getProjectConfig(ctx);
+        const { s3BucketPath, cloudFrontDistributionId, cloudFrontInvalidationPaths, skipBuild = false } = opts;
+        const buildTarget = `${name}:${opts.buildTarget}`;
+        if (!skipBuild) await runCommand(`nx run ${buildTarget}`);
+        await cleanS3Bucket(s3BucketPath);
+        await copyAssetsToS3(s3BucketPath, root);
+        await createCloudFrontInvalidation(cloudFrontDistributionId, cloudFrontInvalidationPaths);
+        const now = new Date().toLocaleString();
+        return ok(`✨ Build completed successfully on ${now}`);
+    } catch (error) {
+        return err(error, '❌ Error when executing deploy command');
+    }
+}
+
+export { deployExecutor as default };

package/dist/esm/executors/deploy/schema.json

@@ -0,0 +1,41 @@
+{
+  "$schema": "http://json-schema.org/schema",
+  "version": 2,
+  "title": "Deploy executor",
+  "description": "",
+  "type": "object",
+  "properties": {
+    "s3BucketPath": {
+      "type": "string",
+      "description": "S3 BUCKET ROUTE"
+    },
+    "cloudFrontDistributionId": {
+      "type": "string",
+      "description": "Cloudfront distribution id for cache invalidation"
+    },
+    "cloudFrontInvalidationPaths": {
+      "type": "array",
+      "description": "Cloudfront path list that must be invalidated in the cache",
+      "items": {
+        "type": "string"
+      },
+      "uniqueItems": true,
+      "minItems": 1
+    },
+    "buildTarget": {
+      "type": "string",
+      "description": "Build command relative to the project and without the name of the project because it is not necessary"
+    },
+    "skipBuild": {
+      "type": "boolean",
+      "description": "It allows to omit the Build process and assumes that it was already done",
+      "default": false
+    }
+  },
+  "required": [
+    "s3BucketPath",
+    "cloudFrontDistributionId",
+    "cloudFrontInvalidationPaths",
+    "buildTarget"
+  ]
+}

package/dist/esm/executors/environments/helpers.mjs

@@ -0,0 +1,58 @@
+import { promises } from 'fs';
+import { join } from 'path';
+import { logger } from '@nx/devkit';
+
+const { mkdir, writeFile, access } = promises;
+/**
+ * Creates the content for an environment file based on the core environment path.
+ *
+ * @param {CreateEnvironmentData} data - Values to replace in template.
+ * @returns {string} The content of the environment file.
+ */ async function createEnvironmentFileContent({ coreEnvFile, projectOrg }) {
+    return `import { Environment } from '@${projectOrg}/core';
+import coreEnvs from '@${projectOrg}/core/envs/${coreEnvFile}';
+
+const config = {
+  ...coreEnvs,
+};
+
+export const environment: Environment<typeof config> = config;
+export default environment;
+`;
+}
+/**
+ * Ensures that the given directory exists, creating it if it does not.
+ *
+ * @param {string} dir - The path to the directory to check/create.
+ */ async function ensureDirectoryExists(dir) {
+    try {
+        await access(dir);
+        logger.info('✅ Directory exists.');
+    } catch  {
+        logger.info('📁 Directory does not exist. Creating...');
+        await mkdir(dir, {
+            recursive: true
+        });
+        logger.info('📁 Directory created.');
+    }
+}
+/**
+ * Writes environment files to the given base path if they do not already exist.
+ *
+ * @param {string} basePath - The base directory where the files should be written.
+ * @param {Record<string, string>} files - An object containing filenames and their respective content.
+ */ async function writeFilesIfNotExist(basePath, files) {
+    await Promise.all(Object.entries(files).map(async ([filename, content])=>{
+        const filePath = join(basePath, filename);
+        try {
+            await access(filePath);
+            logger.info(`✅ The file "${filename}" already exists.`);
+        } catch  {
+            logger.warn(`📝 The file "${filename}" does not exist. Creating...`);
+            await writeFile(filePath, content);
+            logger.info(`🎉 The file "${filename}" has been created.`);
+        }
+    }));
+}
+
+export { createEnvironmentFileContent, ensureDirectoryExists, writeFilesIfNotExist };

package/dist/esm/executors/environments/index.mjs

@@ -0,0 +1,58 @@
+import { join } from 'path';
+import { getProjectConfig, ok, err } from '../shared/utils.mjs';
+import { ensureDirectoryExists, createEnvironmentFileContent, writeFilesIfNotExist } from './helpers.mjs';
+import '../../shared/logger.mjs';
+import { getPkgJson } from '../../shared/utils.mjs';
+
+const ENV_DIR = 'src/environments';
+const ENV_DEV_FILE = 'environment.ts';
+const ENV_LOCAL_FILE = 'environment.local.ts';
+const ENV_PROD_FILE = 'environment.prod.ts';
+const ENV_STAGING_FILE = 'environment.staging.ts';
+const environmentFiles = [
+    ENV_DEV_FILE,
+    ENV_LOCAL_FILE,
+    ENV_PROD_FILE,
+    ENV_STAGING_FILE
+];
+/**
+ * The executor function to create environment files.
+ * Ensures that the directory for the environment files exists and creates the files
+ * if they do not exist already. Files created are 'environment.ts', 'environment.prod.ts',
+ * and 'environment.staging.ts'.
+ *
+ * @param {ExecutorOptions} _opts - Executor options, currently not used but provided for future extensibility.
+ * @param {ExecutorContext} ctx - The executor context, providing access to the project configuration.
+ * @returns {Promise<ExecutorResponse>} The result object with a success or error status.
+ */ async function runExecutor(_opts, ctx) {
+    try {
+        const projectConfig = getProjectConfig(ctx);
+        const environmentsDir = join(projectConfig.root, ENV_DIR);
+        const mainPkgJson = getPkgJson(ctx.root);
+        const getEnvPath = (fileName)=>{
+            const isLocal = fileName.includes('.local');
+            const coreEnvFile = (isLocal ? ENV_DEV_FILE : fileName).replace('.ts', '');
+            const key = isLocal ? ENV_LOCAL_FILE : fileName;
+            return {
+                key,
+                coreEnvFile
+            };
+        };
+        await ensureDirectoryExists(environmentsDir);
+        for (const envFileName of environmentFiles){
+            const { key, coreEnvFile } = getEnvPath(envFileName);
+            const content = await createEnvironmentFileContent({
+                coreEnvFile,
+                projectOrg: mainPkgJson.name
+            });
+            await writeFilesIfNotExist(environmentsDir, {
+                [key]: content
+            });
+        }
+        return ok();
+    } catch (error) {
+        return err(error, `Failed to create environment files:`);
+    }
+}
+
+export { runExecutor as default };

package/dist/esm/executors/environments/schema.json

@@ -0,0 +1,9 @@
+{
+  "$schema": "http://json-schema.org/schema",
+  "version": 2,
+  "title": "Environments executor",
+  "description": "",
+  "type": "object",
+  "properties": {},
+  "required": []
+}

package/dist/esm/executors/publish/helpers.mjs

@@ -0,0 +1,48 @@
+import { logger } from '@nx/devkit';
+import { exec } from 'child_process';
+import { promisify } from 'util';
+
+const execAsync = promisify(exec);
+/**
+ * Retrieves the version of a published package with a given name and tag.
+ *
+ * @param {string} packageName The name of the package to retrieve the version for.
+ * @param {string} tag The tag to retrieve the version for.
+ * @returns The version of the package as a string or an object containing versions for each tag.
+ */ async function getPublishedPackageVersion(packageName, tag) {
+    const withTag = tag ? `.${tag}` : ' --json';
+    const command = `npm view ${packageName} dist-tags${withTag}`;
+    const { stdout, stderr } = await execAsync(command);
+    if (stderr) {
+        logger.error(stderr.trim());
+        process.exit(1);
+    }
+    const published = stdout.trim();
+    return tag ? published : JSON.parse(published);
+}
+/**
+ * Checks if a package with the given name is already published and returns its version.
+ *
+ * @param {string} packageName The name of the package to check for.
+ * @returns An object containing the published versions of the package and a flag indicating if it is the first version.
+ */ async function checkPublishedVersion(packageName) {
+    let publishedVersion;
+    let isFirstVersion = false;
+    try {
+        publishedVersion = await getPublishedPackageVersion(packageName);
+    } catch (err) {
+        if (err?.message.includes('code E404')) {
+            isFirstVersion = true;
+            logger.info(`🏁 This is the first version of "${packageName}" package. \n`);
+        } else {
+            logger.error('❌ Error when checking the last published versions \n');
+            throw err;
+        }
+    }
+    return {
+        publishedVersion,
+        isFirstVersion
+    };
+}
+
+export { checkPublishedVersion, getPublishedPackageVersion };