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

package/dist/{src/vite/plugins/third-party-css-inject/utils.js → cjs/vite/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',
@@ -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/cjs/vite/plugins/third-party-css-inject/utils.d.cts

@@ -0,0 +1,5 @@
+import { OutputChunk } from 'rollup';
+import { Execute } from "../../../index-3080371d.js";
+declare function buildCSSInjectionCode(execute?: Execute[]): Promise<OutputChunk | null | any>;
+declare function removeLinkStyleSheets(html: string, cssFileName: string): string;
+export { buildCSSInjectionCode, removeLinkStyleSheets };

package/dist/esm/executors/deploy/helpers.d.mts

@@ -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/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.d.mts

@@ -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/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.d.mts

@@ -0,0 +1,25 @@
+interface CreateEnvironmentData {
+    projectOrg: string;
+    coreEnvFile: string;
+}
+/**
+ * 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.
+ */
+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.
+ */
+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.
+ */
+declare function writeFilesIfNotExist(basePath: string, files: Record<string, string>): Promise<void>;
+export { createEnvironmentFileContent, ensureDirectoryExists, writeFilesIfNotExist };

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.d.mts

@@ -0,0 +1,16 @@
+import { ExecutorContext } from '@nx/devkit';
+import { ExecutorResponse } from "../../index-f6330edc.js";
+interface ExecutorOptions {
+}
+/**
+ * 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.
+ */
+declare function runExecutor(_opts: ExecutorOptions, ctx: ExecutorContext): Promise<ExecutorResponse>;
+export { ExecutorOptions, runExecutor as default };

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.d.mts

@@ -0,0 +1,19 @@
+/**
+ * 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.
+ */
+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.
+ */
+declare function checkPublishedVersion(packageName: string): Promise<{
+    publishedVersion: any;
+    isFirstVersion: boolean;
+}>;
+export { getPublishedPackageVersion, checkPublishedVersion };

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 };

package/dist/esm/executors/publish/index.d.mts

@@ -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/esm/executors/publish/index.mjs

@@ -0,0 +1,51 @@
+import { logger } from '@nx/devkit';
+import semver from 'semver';
+import '../../shared/logger.mjs';
+import { getPkgJson } from '../../shared/utils.mjs';
+import { getProjectConfig, runCommand, ok, err } from '../shared/utils.mjs';
+import { checkPublishedVersion } from './helpers.mjs';
+
+/**
+ * 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 } = getProjectConfig(ctx);
+        // Read the package.json file and extract the name and version.
+        const packageJson = 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 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 && logger.info('👀 Skip publish (dry run) \n');
+            logger.info(`${commandToPublish} \n`);
+            // Execute the command to publish the package.
+            // process.chdir(projectRoot);
+            await runCommand(commandToPublish, projectRoot);
+            logger.info(`\n🚀 Successfully published ${packageName}@${packageVersion}`);
+        } else {
+            logger.warn(`👻 Package version "${packageVersion}" is invalid.`);
+        }
+        return ok();
+    } catch (error) {
+        return err(error, '❌ Error when publishing the package');
+    }
+}
+
+export { runExecutor as default };

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

@@ -0,0 +1,19 @@
+{
+  "$schema": "http://json-schema.org/schema",
+  "version": 2,
+  "title": "Publish executor",
+  "description": "",
+  "type": "object",
+  "properties": {
+    "tag": {
+      "type": "string",
+      "description": "Tag name to publish"
+    },
+    "dryRun": {
+      "type": "boolean",
+      "description": "Indicates whether a test execution should be done without really publishing",
+      "default": false
+    }
+  },
+  "required": ["tag"]
+}

package/dist/esm/executors/shared/utils.d.mts

@@ -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/esm/executors/shared/utils.mjs

@@ -0,0 +1,62 @@
+import { logger } from '@nx/devkit';
+import { exec } from 'child_process';
+import { promisify } from 'util';
+
+const execAsync = promisify(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 && 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) {
+        logger.error(message);
+    } else {
+        logger.error(`❌ an error occurred:`);
+    }
+    if (err) 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
+            }
+        });
+        logger.info(stdout);
+        logger.info(stderr);
+    } catch (error) {
+        logger.error(`Unexpected error running command:`);
+        logger.error(error);
+        throw error;
+    }
+}
+
+export { err, getProjectConfig, ok, runCommand };

package/dist/esm/executors/update-executors-file/helpers.d.mts

@@ -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/esm/executors/update-executors-file/helpers.mjs

@@ -0,0 +1,59 @@
+import { logger } from '@nx/devkit';
+import { promises } from 'fs';
+import { cond, always, T, pipe } from 'ramda';
+
+const { writeFile } = 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 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 = cond([
+        [
+            always(toDist),
+            transformPathToDist
+        ],
+        [
+            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));
+        logger.info(`✅ Updated: ${path}`);
+    } catch (error) {
+        logger.error(`❌ Error writing file ${path}: ${error}`);
+    }
+};
+
+export { transformPathToDist, transformPathToRoot, updateExecutorPaths, writeJsonFileAsync };

package/dist/esm/executors/update-executors-file/index.d.mts

@@ -0,0 +1,12 @@
+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.
+ *
+ * @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.
+ */
+declare function runExecutor(_opts: ExecutorOptions, ctx: ExecutorContext): Promise<ExecutorResponse>;
+export { runExecutor as default };