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

package/dist/cjs/executors/deploy/helpers.cjs

@@ -0,0 +1,26 @@
+'use strict';
+
+var devkit = require('@nx/devkit');
+var utils = require('../shared/utils.cjs');
+
+async function cleanS3Bucket(s3BucketPath) {
+    devkit.logger.info('🧹 Cleaning S3 bucket...');
+    await utils.runCommand(`aws s3 rm ${s3BucketPath} --recursive`);
+    devkit.logger.info('✅ S3 bucket cleared.');
+}
+async function copyAssetsToS3(s3BucketPath, projectRoot) {
+    devkit.logger.info('📦 Copying assets to S3 bucket...');
+    await utils.runCommand(`aws s3 cp ${projectRoot}/dist ${s3BucketPath} --recursive`);
+    devkit.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}`;
+    devkit.logger.info('🔃 Creating invalidation for CloudFront...');
+    await utils.runCommand(command);
+    devkit.logger.info('🔄 CloudFront invalidation created.');
+}
+
+exports.cleanS3Bucket = cleanS3Bucket;
+exports.copyAssetsToS3 = copyAssetsToS3;
+exports.createCloudFrontInvalidation = createCloudFrontInvalidation;

package/dist/cjs/executors/deploy/helpers.d.cts

@@ -0,0 +1,4 @@
+declare function cleanS3Bucket(s3BucketPath: string): Promise<void>;
+declare function copyAssetsToS3(s3BucketPath: string, projectRoot: string): Promise<void>;
+declare function createCloudFrontInvalidation(distributionId: string, invalidationPaths: string[]): Promise<void>;
+export { cleanS3Bucket, copyAssetsToS3, createCloudFrontInvalidation };

package/dist/cjs/executors/deploy/index.cjs

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

package/dist/cjs/executors/deploy/index.d.cts

@@ -0,0 +1,11 @@
+import { ExecutorContext } from '@nx/devkit';
+import { ExecutorResponse } from "../../index-f6330edc.js";
+interface ExecutorOptions {
+    s3BucketPath: string;
+    cloudFrontDistributionId: string;
+    cloudFrontInvalidationPaths: string[];
+    buildTarget: string;
+    skipBuild?: boolean;
+}
+declare function deployExecutor(opts: ExecutorOptions, ctx: ExecutorContext): Promise<ExecutorResponse>;
+export { ExecutorOptions, deployExecutor as default };

package/dist/cjs/executors/environments/helpers.cjs

@@ -0,0 +1,62 @@
+'use strict';
+
+var fs = require('fs');
+var path = require('path');
+var devkit = require('@nx/devkit');
+
+const { mkdir, writeFile, access } = fs.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);
+        devkit.logger.info('✅ Directory exists.');
+    } catch  {
+        devkit.logger.info('📁 Directory does not exist. Creating...');
+        await mkdir(dir, {
+            recursive: true
+        });
+        devkit.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 = path.join(basePath, filename);
+        try {
+            await access(filePath);
+            devkit.logger.info(`✅ The file "${filename}" already exists.`);
+        } catch  {
+            devkit.logger.warn(`📝 The file "${filename}" does not exist. Creating...`);
+            await writeFile(filePath, content);
+            devkit.logger.info(`🎉 The file "${filename}" has been created.`);
+        }
+    }));
+}
+
+exports.createEnvironmentFileContent = createEnvironmentFileContent;
+exports.ensureDirectoryExists = ensureDirectoryExists;
+exports.writeFilesIfNotExist = writeFilesIfNotExist;

package/dist/{src/executors/environments/helpers.d.ts → cjs/executors/environments/helpers.d.cts}

@@ -1,21 +1,25 @@
+interface CreateEnvironmentData {
+    projectOrg: string;
+    coreEnvFile: string;
+}
 /**
  * Creates the content for an environment file based on the core environment path.
  *
- * @param {string} coreEnvPath - The path to the core environment file.
+ * @param {CreateEnvironmentData} data - Values to replace in template.
  * @returns {string} The content of the environment file.
  */
-export declare function createEnvironmentFileContent(coreEnvPath: string): Promise<string>;
+declare function createEnvironmentFileContent({ coreEnvFile, projectOrg, }: CreateEnvironmentData): Promise<string>;
 /**
  * Ensures that the given directory exists, creating it if it does not.
  *
  * @param {string} dir - The path to the directory to check/create.
  */
-export declare function ensureDirectoryExists(dir: string): Promise<void>;
+declare function ensureDirectoryExists(dir: string): Promise<void>;
 /**
  * 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.
  */
-export declare function writeFilesIfNotExist(basePath: string, files: Record<string, string>): Promise<void>;
-//# sourceMappingURL=helpers.d.ts.map
+declare function writeFilesIfNotExist(basePath: string, files: Record<string, string>): Promise<void>;
+export { createEnvironmentFileContent, ensureDirectoryExists, writeFilesIfNotExist };

package/dist/cjs/executors/environments/index.cjs

@@ -0,0 +1,60 @@
+'use strict';
+
+var path = require('path');
+var utils = require('../shared/utils.cjs');
+var helpers = require('./helpers.cjs');
+require('../../shared/logger.cjs');
+var utils$1 = require('../../shared/utils.cjs');
+
+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 = utils.getProjectConfig(ctx);
+        const environmentsDir = path.join(projectConfig.root, ENV_DIR);
+        const mainPkgJson = utils$1.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 helpers.ensureDirectoryExists(environmentsDir);
+        for (const envFileName of environmentFiles){
+            const { key, coreEnvFile } = getEnvPath(envFileName);
+            const content = await helpers.createEnvironmentFileContent({
+                coreEnvFile,
+                projectOrg: mainPkgJson.name
+            });
+            await helpers.writeFilesIfNotExist(environmentsDir, {
+                [key]: content
+            });
+        }
+        return utils.ok();
+    } catch (error) {
+        return utils.err(error, `Failed to create environment files:`);
+    }
+}
+
+module.exports = runExecutor;

package/dist/{src/executors/environments/executor.d.ts → cjs/executors/environments/index.d.cts}

@@ -1,6 +1,6 @@
-import type { ExecutorContext } from '@nx/devkit';
-import { type ExecutorResponse } from '../shared';
-export interface ExecutorOptions {
+import { ExecutorContext } from '@nx/devkit';
+import { ExecutorResponse } from "../../index-f6330edc.js";
+interface ExecutorOptions {
 }
 /**
  * The executor function to create environment files.
@@ -12,5 +12,5 @@ export interface ExecutorOptions {
  * @param {ExecutorContext} ctx - The executor context, providing access to the project configuration.
  * @returns {Promise<ExecutorResponse>} The result object with a success or error status.
  */
-export default function runExecutor(_opts: ExecutorOptions, ctx: ExecutorContext): Promise<ExecutorResponse>;
-//# sourceMappingURL=executor.d.ts.map
+declare function runExecutor(_opts: ExecutorOptions, ctx: ExecutorContext): Promise<ExecutorResponse>;
+export { ExecutorOptions, runExecutor as default };

package/dist/cjs/executors/publish/helpers.cjs

@@ -0,0 +1,51 @@
+'use strict';
+
+var devkit = require('@nx/devkit');
+var child_process = require('child_process');
+var util = require('util');
+
+const execAsync = util.promisify(child_process.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) {
+        devkit.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;
+            devkit.logger.info(`🏁 This is the first version of "${packageName}" package. \n`);
+        } else {
+            devkit.logger.error('❌ Error when checking the last published versions \n');
+            throw err;
+        }
+    }
+    return {
+        publishedVersion,
+        isFirstVersion
+    };
+}
+
+exports.checkPublishedVersion = checkPublishedVersion;
+exports.getPublishedPackageVersion = getPublishedPackageVersion;

package/dist/{src/executors/publish/helpers.d.ts → cjs/executors/publish/helpers.d.cts}

@@ -5,15 +5,15 @@
  * @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.
  */
-export declare function getPublishedPackageVersion(packageName: string, tag?: string): Promise<any>;
+declare function getPublishedPackageVersion(packageName: string, tag?: string): Promise<any>;
 /**
  * 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.
  */
-export declare function checkPublishedVersion(packageName: string): Promise<{
+declare function checkPublishedVersion(packageName: string): Promise<{
     publishedVersion: any;
     isFirstVersion: boolean;
 }>;
-//# sourceMappingURL=helpers.d.ts.map
+export { getPublishedPackageVersion, checkPublishedVersion };

package/dist/cjs/executors/publish/index.cjs

@@ -0,0 +1,53 @@
+'use strict';
+
+var devkit = require('@nx/devkit');
+var semver = require('semver');
+require('../../shared/logger.cjs');
+var utils$1 = require('../../shared/utils.cjs');
+var utils = require('../shared/utils.cjs');
+var helpers = require('./helpers.cjs');
+
+/**
+ * This is a minimal script to publish package to "npm".
+ * Need to authenticate with NPM before running this script.
+ */ async function runExecutor(opts, ctx) {
+    try {
+        const { tag, dryRun: isDryRun } = opts;
+        const { root: projectRoot } = utils.getProjectConfig(ctx);
+        // Read the package.json file and extract the name and version.
+        const packageJson = utils$1.getPkgJson(projectRoot);
+        const { name: packageName, version: packageVersion } = packageJson;
+        // Check if the package has been previously published and get the published version.
+        const { publishedVersion, isFirstVersion } = await helpers.checkPublishedVersion(packageName);
+        let greaterThanTagVersion, greaterThanLatestVersion;
+        if (!isFirstVersion) {
+            // Check if the package version is greater than the latest published version for the specified tag.
+            greaterThanTagVersion = publishedVersion?.[tag] ? semver.gt(packageVersion, publishedVersion?.[tag]) : true;
+            // Check if the package version is greater than the latest published version.
+            greaterThanLatestVersion = semver.gt(packageVersion, publishedVersion.latest);
+            console.log(`🔎 package.json version: ${packageVersion}`);
+            console.log('🔺 published versions:');
+            Object.entries(publishedVersion).forEach(([k, v])=>console.log(`   * ${k}: ${v}`));
+            console.log('\n');
+        }
+        // Publish the package if it's the first version or if it's a new version.
+        const needsPublish = isFirstVersion || greaterThanLatestVersion && greaterThanTagVersion;
+        if (needsPublish) {
+            const dryRun = isDryRun ? '--dry-run' : '';
+            const commandToPublish = `pnpm publish --access public --tag ${tag} --no-git-checks ${dryRun}`;
+            isDryRun && devkit.logger.info('👀 Skip publish (dry run) \n');
+            devkit.logger.info(`${commandToPublish} \n`);
+            // Execute the command to publish the package.
+            // process.chdir(projectRoot);
+            await utils.runCommand(commandToPublish, projectRoot);
+            devkit.logger.info(`\n🚀 Successfully published ${packageName}@${packageVersion}`);
+        } else {
+            devkit.logger.warn(`👻 Package version "${packageVersion}" is invalid.`);
+        }
+        return utils.ok();
+    } catch (error) {
+        return utils.err(error, '❌ Error when publishing the package');
+    }
+}
+
+module.exports = runExecutor;

package/dist/cjs/executors/publish/index.d.cts

@@ -0,0 +1,12 @@
+import { ExecutorContext } from '@nx/devkit';
+import { ExecutorResponse } from "../../index-f6330edc.js";
+interface ExecutorOptions {
+    tag: string;
+    dryRun?: boolean;
+}
+/**
+ * This is a minimal script to publish package to "npm".
+ * Need to authenticate with NPM before running this script.
+ */
+declare function runExecutor(opts: ExecutorOptions, ctx: ExecutorContext): Promise<ExecutorResponse>;
+export { ExecutorOptions, runExecutor as default };

package/dist/cjs/executors/shared/utils.cjs

@@ -0,0 +1,67 @@
+'use strict';
+
+var devkit = require('@nx/devkit');
+var child_process = require('child_process');
+var util = require('util');
+
+const execAsync = util.promisify(child_process.exec);
+/**
+ * Indicates a successful executor operation.
+ *
+ * @param {string} message - Optional message to log for the success case.
+ * @returns {ExecutorResponse} - An object representing a successful operation.
+ */ function ok(message) {
+    message && devkit.logger.info(message);
+    return {
+        success: true
+    };
+}
+/**
+ * Indicates a failed executor operation.
+ *
+ * @param {string | Error | unknown} err - An optional error object or message indicating the nature of the failure.
+ * @param {string} message - An optional message to log for the error case. If not provided, a default error message is logged.
+ * @returns {ExecutorResponse} - An object representing a failed operation.
+ */ function err(err, message) {
+    if (message) {
+        devkit.logger.error(message);
+    } else {
+        devkit.logger.error(`❌ an error occurred:`);
+    }
+    if (err) devkit.logger.error(err);
+    return {
+        success: false
+    };
+}
+/**
+ * Retrieves the project configuration for the current execution context.
+ *
+ * @param {ExecutorContext} ctx - The execution context containing project information.
+ * @returns {ProjectConfiguration} - The configuration object for the current project.
+ * @throws {Error} If the project configuration is invalid or not found.
+ */ function getProjectConfig(ctx) {
+    const projectName = ctx.projectName || '';
+    const projectConfig = ctx.projectsConfigurations?.projects?.[projectName];
+    if (!projectConfig) throw new Error('Invalid project configuration.');
+    return projectConfig;
+}
+async function runCommand(command, cwd) {
+    try {
+        const { stdout, stderr } = await execAsync(command, {
+            ...cwd && {
+                cwd
+            }
+        });
+        devkit.logger.info(stdout);
+        devkit.logger.info(stderr);
+    } catch (error) {
+        devkit.logger.error(`Unexpected error running command:`);
+        devkit.logger.error(error);
+        throw error;
+    }
+}
+
+exports.err = err;
+exports.getProjectConfig = getProjectConfig;
+exports.ok = ok;
+exports.runCommand = runCommand;

package/dist/cjs/executors/shared/utils.d.cts

@@ -0,0 +1,27 @@
+import { ExecutorContext, ProjectConfiguration } from '@nx/devkit';
+import { ExecutorResponse } from "../../types-7377dcc9.js";
+/**
+ * Indicates a successful executor operation.
+ *
+ * @param {string} message - Optional message to log for the success case.
+ * @returns {ExecutorResponse} - An object representing a successful operation.
+ */
+declare function ok(message?: string): ExecutorResponse;
+/**
+ * Indicates a failed executor operation.
+ *
+ * @param {string | Error | unknown} err - An optional error object or message indicating the nature of the failure.
+ * @param {string} message - An optional message to log for the error case. If not provided, a default error message is logged.
+ * @returns {ExecutorResponse} - An object representing a failed operation.
+ */
+declare function err(err?: string | Error | unknown, message?: string): ExecutorResponse;
+/**
+ * Retrieves the project configuration for the current execution context.
+ *
+ * @param {ExecutorContext} ctx - The execution context containing project information.
+ * @returns {ProjectConfiguration} - The configuration object for the current project.
+ * @throws {Error} If the project configuration is invalid or not found.
+ */
+declare function getProjectConfig(ctx: ExecutorContext): ProjectConfiguration;
+declare function runCommand(command: string, cwd?: string | URL): Promise<void>;
+export { ok, err, getProjectConfig, runCommand };

package/dist/cjs/executors/update-executors-file/helpers.cjs

@@ -0,0 +1,64 @@
+'use strict';
+
+var devkit = require('@nx/devkit');
+var fs = require('fs');
+var R = require('ramda');
+
+const { writeFile } = fs.promises;
+const transformPathToRoot = (path)=>{
+    const distPrefix = './dist/cjs/';
+    const srcRegex = /^\.\/src\//;
+    const executorTsRegex = /executor\.ts$/;
+    const jsonFileRegex = /\.json$/;
+    const isJson = jsonFileRegex.test(path);
+    const changeSrcPath = (p)=>p.replace(srcRegex, distPrefix);
+    const changeFileName = (p)=>isJson ? p : p.replace(executorTsRegex, 'index.cjs');
+    return R.pipe(changeSrcPath, changeFileName)(path);
+};
+const transformPathToDist = (path)=>{
+    const cjsPrefix = './cjs/';
+    const distRegex = /^\.\/dist\/cjs\//;
+    return path.replace(distRegex, cjsPrefix);
+};
+/**
+ * Updates the executor paths for the provided executors object.
+ * @param {Executors} executors - The executors object from executors.json.
+ * @param {boolean} toDist - Flag to determine if './dist' should be removed from paths.
+ * @returns - The updated executors object with transformed paths.
+ */ const updateExecutorPaths = (executors, toDist)=>{
+    const transform = R.cond([
+        [
+            R.always(toDist),
+            transformPathToDist
+        ],
+        [
+            R.T,
+            transformPathToRoot
+        ]
+    ]);
+    return Object.entries(executors).reduce((updatedExecutors, [key, executor])=>{
+        updatedExecutors[key] = {
+            ...executor,
+            implementation: transform(executor.implementation),
+            schema: transform(executor.schema)
+        };
+        return updatedExecutors;
+    }, {});
+};
+/**
+ * Writes a JSON file asynchronously.
+ * @param {string} path - The file path where to write the JSON data.
+ * @param {any} data - The data to be written to the file.
+ */ const writeJsonFileAsync = async (path, data)=>{
+    try {
+        await writeFile(path, JSON.stringify(data, null, 2));
+        devkit.logger.info(`✅ Updated: ${path}`);
+    } catch (error) {
+        devkit.logger.error(`❌ Error writing file ${path}: ${error}`);
+    }
+};
+
+exports.transformPathToDist = transformPathToDist;
+exports.transformPathToRoot = transformPathToRoot;
+exports.updateExecutorPaths = updateExecutorPaths;
+exports.writeJsonFileAsync = writeJsonFileAsync;

package/dist/cjs/executors/update-executors-file/helpers.d.cts

@@ -0,0 +1,17 @@
+import { Executors } from "../../types-763439e4.js";
+declare const transformPathToRoot: (path: string) => string;
+declare const transformPathToDist: (path: string) => string;
+/**
+ * Updates the executor paths for the provided executors object.
+ * @param {Executors} executors - The executors object from executors.json.
+ * @param {boolean} toDist - Flag to determine if './dist' should be removed from paths.
+ * @returns - The updated executors object with transformed paths.
+ */
+declare const updateExecutorPaths: (executors: Executors, toDist: boolean) => Executors;
+/**
+ * Writes a JSON file asynchronously.
+ * @param {string} path - The file path where to write the JSON data.
+ * @param {any} data - The data to be written to the file.
+ */
+declare const writeJsonFileAsync: (path: string, data: any) => Promise<void>;
+export { transformPathToRoot, transformPathToDist, updateExecutorPaths, writeJsonFileAsync };

package/dist/cjs/executors/update-executors-file/index.cjs

@@ -0,0 +1,38 @@
+'use strict';
+
+var fs = require('fs');
+var path = require('path');
+var utils = require('../shared/utils.cjs');
+var helpers = require('./helpers.cjs');
+
+const { readFile } = fs.promises;
+/**
+ * Executor function to update paths in the executors.json file.
+ *
+ * @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 = utils.getProjectConfig(ctx);
+        const rootDir = projectConfig.root;
+        const executorsFilePath = path.join(rootDir, 'executors.json');
+        const distExecutorsFilePath = path.join(rootDir, 'dist', 'executors.json');
+        const originalContent = JSON.parse(await readFile(executorsFilePath, 'utf8'));
+        // Update paths to point to './dist/' and add '.js'
+        const updatedExecutors = helpers.updateExecutorPaths(originalContent.executors, false);
+        // Prepare the version for the dist folder by removing './dist/' from paths
+        // const distExecutors = updateExecutorPaths(updatedExecutors, true);
+        // Write both files asynchronously and in parallel
+        await Promise.all([
+            helpers.writeJsonFileAsync(executorsFilePath, {
+                executors: updatedExecutors
+            })
+        ]);
+        return utils.ok(`🚀 Executors updated successfully.`);
+    } catch (error) {
+        return utils.err(error, `❌ Error processing file: ${error}`);
+    }
+}
+
+module.exports = runExecutor;

package/dist/{src/executors/update-executors-file/executor.d.ts → cjs/executors/update-executors-file/index.d.cts}

@@ -1,6 +1,6 @@
-import type { ExecutorContext } from '@nx/devkit';
-import { type ExecutorResponse } from '../shared';
-import type { ExecutorOptions } from './types';
+import { ExecutorContext } from '@nx/devkit';
+import { ExecutorResponse } from "../../index-f6330edc.js";
+import { ExecutorOptions } from "../../types-763439e4.js";
 /**
  * Executor function to update paths in the executors.json file.
  *
@@ -8,5 +8,5 @@ import type { ExecutorOptions } from './types';
  * @param {ExecutorContext} ctx - The executor context, providing access to the project configuration.
  * @returns {Promise<ExecutorResponse>} The result object with a success or error status.
  */
-export default function runExecutor(_opts: ExecutorOptions, ctx: ExecutorContext): Promise<ExecutorResponse>;
-//# sourceMappingURL=executor.d.ts.map
+declare function runExecutor(_opts: ExecutorOptions, ctx: ExecutorContext): Promise<ExecutorResponse>;
+export { runExecutor as default };

package/dist/cjs/executors/vtex-link/constants.cjs

@@ -0,0 +1,9 @@
+'use strict';
+
+const VTEX_PROJECT_PATH = process.env.NZ_VTEX_PROJECT;
+const ERROR_LINKING_FLAG = '[31merror: App build failed';
+const SUCCESS_LINKING_FLAG = '[32minfo: App running';
+
+exports.ERROR_LINKING_FLAG = ERROR_LINKING_FLAG;
+exports.SUCCESS_LINKING_FLAG = SUCCESS_LINKING_FLAG;
+exports.VTEX_PROJECT_PATH = VTEX_PROJECT_PATH;

package/dist/cjs/executors/vtex-link/constants.d.cts

@@ -0,0 +1,4 @@
+declare const VTEX_PROJECT_PATH: string | undefined;
+declare const ERROR_LINKING_FLAG = "[31merror\u001B[39m: App build failed";
+declare const SUCCESS_LINKING_FLAG = "[32minfo\u001B[39m: App running";
+export { VTEX_PROJECT_PATH, ERROR_LINKING_FLAG, SUCCESS_LINKING_FLAG };