nx 20.8.4 → 22.7.7

package/src/utils/command-line-utils.js

@@ -1,247 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createOverrides = createOverrides;
-exports.getBaseRef = getBaseRef;
-exports.splitArgsIntoNxArgsAndOverrides = splitArgsIntoNxArgsAndOverrides;
-exports.parseFiles = parseFiles;
-exports.getProjectRoots = getProjectRoots;
-exports.readGraphFileFromGraphArg = readGraphFileFromGraphArg;
-const yargsParser = require("yargs-parser");
-const file_utils_1 = require("../project-graph/file-utils");
-const output_1 = require("./output");
-const child_process_1 = require("child_process");
-const workspace_root_1 = require("./workspace-root");
-const shared_options_1 = require("../command-line/yargs-utils/shared-options");
-function createOverrides(__overrides_unparsed__ = []) {
-    let overrides = yargsParser(__overrides_unparsed__, {
-        configuration: {
-            'camel-case-expansion': false,
-            'dot-notation': true,
-        },
-    }) || {};
-    if (!overrides._ || overrides._.length === 0) {
-        delete overrides._;
-    }
-    overrides.__overrides_unparsed__ = __overrides_unparsed__;
-    return overrides;
-}
-function getBaseRef(nxJson) {
-    return nxJson.defaultBase ?? nxJson.affected?.defaultBase ?? 'main';
-}
-function splitArgsIntoNxArgsAndOverrides(args, mode, options = { printWarnings: true }, nxJson) {
-    // this is to lerna case when this function is invoked imperatively
-    if (args['target'] && !args['targets']) {
-        args['targets'] = [args['target']];
-    }
-    delete args['target'];
-    delete args['t'];
-    if (!args.__overrides_unparsed__ && args._) {
-        // required for backwards compatibility
-        args.__overrides_unparsed__ = args._;
-        delete args._;
-    }
-    // This handles the way Lerna passes in overrides
-    if (!args.__overrides_unparsed__ && args.__overrides__) {
-        // required for backwards compatibility
-        args.__overrides_unparsed__ = args.__overrides__;
-        delete args._;
-    }
-    const nxArgs = args;
-    let overrides = createOverrides(args.__overrides_unparsed__);
-    delete nxArgs.$0;
-    delete nxArgs.__overrides_unparsed__;
-    if (mode === 'run-many') {
-        const args = nxArgs;
-        if (!args.projects) {
-            args.projects = [];
-        }
-        else if (typeof args.projects === 'string') {
-            args.projects = args.projects.split(',');
-        }
-    }
-    if (nxArgs.prod) {
-        delete nxArgs.prod;
-        nxArgs.configuration = 'production';
-    }
-    if (mode === 'affected') {
-        if (options.printWarnings && nxArgs.all) {
-            output_1.output.warn({
-                title: `Running affected:* commands with --all can result in very slow builds.`,
-                bodyLines: [
-                    `${output_1.output.bold('--all')} is not meant to be used for any sizable project or to be used in CI.`,
-                    '',
-                    `${output_1.output.dim('Learn more about checking only what is affected: https://nx.dev/nx/affected')}`,
-                ],
-            });
-        }
-        // Allow setting base and head via environment variables (lower priority than direct command arguments)
-        if (!nxArgs.base && process.env.NX_BASE) {
-            nxArgs.base = process.env.NX_BASE;
-            if (options.printWarnings) {
-                output_1.output.note({
-                    title: `No explicit --base argument provided, but found environment variable NX_BASE so using its value as the affected base: ${output_1.output.bold(`${nxArgs.base}`)}`,
-                });
-            }
-        }
-        if (!nxArgs.head && process.env.NX_HEAD) {
-            nxArgs.head = process.env.NX_HEAD;
-            if (options.printWarnings) {
-                output_1.output.note({
-                    title: `No explicit --head argument provided, but found environment variable NX_HEAD so using its value as the affected head: ${output_1.output.bold(`${nxArgs.head}`)}`,
-                });
-            }
-        }
-        if (!nxArgs.base) {
-            nxArgs.base = getBaseRef(nxJson);
-            // No user-provided arguments to set the affected criteria, so inform the user of the defaults being used
-            if (options.printWarnings &&
-                !nxArgs.head &&
-                !nxArgs.files &&
-                !nxArgs.uncommitted &&
-                !nxArgs.untracked &&
-                !nxArgs.all) {
-                output_1.output.note({
-                    title: `Affected criteria defaulted to --base=${output_1.output.bold(`${nxArgs.base}`)} --head=${output_1.output.bold('HEAD')}`,
-                });
-            }
-        }
-        if (nxArgs.base) {
-            nxArgs.base = getMergeBase(nxArgs.base, nxArgs.head);
-        }
-    }
-    if (typeof args.exclude === 'string') {
-        nxArgs.exclude = args.exclude.split(',');
-    }
-    if (!nxArgs.skipNxCache) {
-        nxArgs.skipNxCache =
-            process.env.NX_SKIP_NX_CACHE === 'true' ||
-                process.env.NX_DISABLE_NX_CACHE === 'true';
-    }
-    if (!nxArgs.skipRemoteCache) {
-        nxArgs.skipRemoteCache =
-            process.env.NX_DISABLE_REMOTE_CACHE === 'true' ||
-                process.env.NX_SKIP_REMOTE_CACHE === 'true';
-    }
-    normalizeNxArgsRunner(nxArgs, nxJson, options);
-    nxArgs['parallel'] = (0, shared_options_1.readParallelFromArgsAndEnv)(args);
-    return { nxArgs, overrides };
-}
-function normalizeNxArgsRunner(nxArgs, nxJson, options) {
-    if (!nxArgs.runner) {
-        const envKey = 'NX_TASKS_RUNNER';
-        const runner = process.env[envKey];
-        if (runner) {
-            const runnerExists = nxJson.tasksRunnerOptions?.[runner];
-            if (options.printWarnings) {
-                if (runnerExists) {
-                    output_1.output.note({
-                        title: `No explicit --runner argument provided, but found environment variable ${envKey} so using its value: ${output_1.output.bold(`${runner}`)}`,
-                    });
-                }
-                else if (nxArgs.verbose ||
-                    process.env.NX_VERBOSE_LOGGING === 'true') {
-                    output_1.output.warn({
-                        title: `Could not find ${output_1.output.bold(`${runner}`)} within \`nx.json\` tasksRunnerOptions.`,
-                        bodyLines: [
-                            `${output_1.output.bold(`${runner}`)} was set by ${envKey}`,
-                            ``,
-                            `To suppress this message, either:`,
-                            `  - provide a valid task runner with --runner`,
-                            `  - ensure NX_TASKS_RUNNER matches a task runner defined in nx.json`,
-                        ],
-                    });
-                }
-            }
-            if (runnerExists) {
-                nxArgs.runner = runner;
-            }
-        }
-    }
-}
-function parseFiles(options) {
-    const { files, uncommitted, untracked, base, head } = options;
-    if (files) {
-        return {
-            files,
-        };
-    }
-    else if (uncommitted) {
-        return {
-            files: getUncommittedFiles(),
-        };
-    }
-    else if (untracked) {
-        return {
-            files: getUntrackedFiles(),
-        };
-    }
-    else if (base && head) {
-        return {
-            files: getFilesUsingBaseAndHead(base, head),
-        };
-    }
-    else if (base) {
-        return {
-            files: Array.from(new Set([
-                ...getFilesUsingBaseAndHead(base, 'HEAD'),
-                ...getUncommittedFiles(),
-                ...getUntrackedFiles(),
-            ])),
-        };
-    }
-}
-function getUncommittedFiles() {
-    return parseGitOutput(`git diff --name-only --no-renames --relative HEAD .`);
-}
-function getUntrackedFiles() {
-    return parseGitOutput(`git ls-files --others --exclude-standard`);
-}
-function getMergeBase(base, head = 'HEAD') {
-    try {
-        return (0, child_process_1.execSync)(`git merge-base "${base}" "${head}"`, {
-            maxBuffer: file_utils_1.TEN_MEGABYTES,
-            cwd: workspace_root_1.workspaceRoot,
-            stdio: 'pipe',
-            windowsHide: false,
-        })
-            .toString()
-            .trim();
-    }
-    catch {
-        try {
-            return (0, child_process_1.execSync)(`git merge-base --fork-point "${base}" "${head}"`, {
-                maxBuffer: file_utils_1.TEN_MEGABYTES,
-                cwd: workspace_root_1.workspaceRoot,
-                stdio: 'pipe',
-                windowsHide: false,
-            })
-                .toString()
-                .trim();
-        }
-        catch {
-            return base;
-        }
-    }
-}
-function getFilesUsingBaseAndHead(base, head) {
-    return parseGitOutput(`git diff --name-only --no-renames --relative "${base}" "${head}"`);
-}
-function parseGitOutput(command) {
-    return (0, child_process_1.execSync)(command, {
-        maxBuffer: file_utils_1.TEN_MEGABYTES,
-        cwd: workspace_root_1.workspaceRoot,
-        windowsHide: false,
-    })
-        .toString('utf-8')
-        .split('\n')
-        .map((a) => a.trim())
-        .filter((a) => a.length > 0);
-}
-function getProjectRoots(projectNames, { nodes }) {
-    return projectNames.map((name) => nodes[name].data.root);
-}
-function readGraphFileFromGraphArg({ graph }) {
-    return typeof graph === 'string' && graph !== 'true' && graph !== ''
-        ? graph
-        : undefined;
-}

package/src/utils/consume-messages-from-socket.d.ts

@@ -1 +0,0 @@
-export declare function consumeMessagesFromSocket(callback: (message: string) => void): (data: any) => void;

package/src/utils/consume-messages-from-socket.js

@@ -1,21 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.consumeMessagesFromSocket = consumeMessagesFromSocket;
-function consumeMessagesFromSocket(callback) {
-    let message = '';
-    return (data) => {
-        const chunk = data.toString();
-        if (chunk.codePointAt(chunk.length - 1) === 4) {
-            message += chunk.substring(0, chunk.length - 1);
-            // Server may send multiple messages in one chunk, so splitting by 0x4
-            const messages = message.split('');
-            for (const splitMessage of messages) {
-                callback(splitMessage);
-            }
-            message = '';
-        }
-        else {
-            message += chunk;
-        }
-    };
-}

package/src/utils/db-connection.d.ts

@@ -1,6 +0,0 @@
-import { ExternalObject } from '../native';
-export declare function getDbConnection(opts?: {
-    directory?: string;
-    dbName?: string;
-}): ExternalObject<NxDbConnection>;
-export declare function removeDbConnections(): void;

package/src/utils/db-connection.js

@@ -1,29 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getDbConnection = getDbConnection;
-exports.removeDbConnections = removeDbConnections;
-const native_1 = require("../native");
-const cache_directory_1 = require("./cache-directory");
-const package_json_1 = require("../../package.json");
-const dbConnectionMap = new Map();
-function getDbConnection(opts = {}) {
-    opts.directory ??= cache_directory_1.workspaceDataDirectory;
-    const key = `${opts.directory}:${opts.dbName ?? 'default'}`;
-    const connection = getEntryOrSet(dbConnectionMap, key, () => (0, native_1.connectToNxDb)(opts.directory, package_json_1.version, opts.dbName));
-    return connection;
-}
-function removeDbConnections() {
-    for (const connection of dbConnectionMap.values()) {
-        (0, native_1.closeDbConnection)(connection);
-    }
-    dbConnectionMap.clear();
-}
-function getEntryOrSet(map, key, defaultValue) {
-    const existing = map.get(key);
-    if (existing) {
-        return existing;
-    }
-    const val = defaultValue();
-    map.set(key, val);
-    return val;
-}

package/src/utils/default-base.js

@@ -1,17 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.deduceDefaultBase = deduceDefaultBase;
-const child_process_1 = require("child_process");
-function deduceDefaultBase() {
-    const nxDefaultBase = 'main';
-    try {
-        return ((0, child_process_1.execSync)('git config --get init.defaultBranch', {
-            windowsHide: false,
-        })
-            .toString()
-            .trim() || nxDefaultBase);
-    }
-    catch {
-        return nxDefaultBase;
-    }
-}

package/src/utils/delayed-spinner.d.ts

@@ -1,42 +0,0 @@
-import * as ora from 'ora';
-export type DelayedSpinnerOptions = {
-    delay?: number;
-    ciDelay?: number;
-};
-/**
- * A class that allows to delay the creation of a spinner, as well
- * as schedule updates to the message of the spinner. Useful for
- * scenarios where one wants to only show a spinner if an operation
- * takes longer than a certain amount of time.
- */
-export declare class DelayedSpinner {
-    spinner: ora.Ora;
-    timeouts: NodeJS.Timeout[];
-    private lastMessage;
-    private ready;
-    /**
-     * Constructs a new {@link DelayedSpinner} instance.
-     *
-     * @param opts The options for the spinner
-     */
-    constructor(message: string, opts?: DelayedSpinnerOptions);
-    /**
-     * Sets the message to display in the spinner.
-     *
-     * @param message The message to display in the spinner
-     * @returns The {@link DelayedSpinner} instance
-     */
-    setMessage(message: string): this;
-    /**
-     * Schedules an update to the message of the spinner. Useful for
-     * changing the message after a certain amount of time has passed.
-     *
-     * @param opts The options for the update
-     * @returns The {@link DelayedSpinner} instance
-     */
-    scheduleMessageUpdate(message: string, opts?: DelayedSpinnerOptions): this;
-    /**
-     * Stops the spinner and cleans up any scheduled timeouts.
-     */
-    cleanup(): void;
-}

package/src/utils/delayed-spinner.js

@@ -1,80 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DelayedSpinner = void 0;
-const ora = require("ora");
-const is_ci_1 = require("./is-ci");
-/**
- * A class that allows to delay the creation of a spinner, as well
- * as schedule updates to the message of the spinner. Useful for
- * scenarios where one wants to only show a spinner if an operation
- * takes longer than a certain amount of time.
- */
-class DelayedSpinner {
-    /**
-     * Constructs a new {@link DelayedSpinner} instance.
-     *
-     * @param opts The options for the spinner
-     */
-    constructor(message, opts) {
-        this.timeouts = [];
-        opts = normalizeDelayedSpinnerOpts(opts);
-        const delay = SHOULD_SHOW_SPINNERS ? opts.delay : opts.ciDelay;
-        this.timeouts.push(setTimeout(() => {
-            this.ready = true;
-            this.lastMessage = message;
-            if (!SHOULD_SHOW_SPINNERS) {
-                console.warn(this.lastMessage);
-            }
-            else {
-                this.spinner = ora(this.lastMessage).start();
-            }
-        }, delay).unref());
-    }
-    /**
-     * Sets the message to display in the spinner.
-     *
-     * @param message The message to display in the spinner
-     * @returns The {@link DelayedSpinner} instance
-     */
-    setMessage(message) {
-        if (SHOULD_SHOW_SPINNERS) {
-            if (this.spinner) {
-                this.spinner.text = message;
-            }
-        }
-        else if (this.ready && this.lastMessage && this.lastMessage !== message) {
-            console.warn(message);
-        }
-        this.lastMessage = message;
-        return this;
-    }
-    /**
-     * Schedules an update to the message of the spinner. Useful for
-     * changing the message after a certain amount of time has passed.
-     *
-     * @param opts The options for the update
-     * @returns The {@link DelayedSpinner} instance
-     */
-    scheduleMessageUpdate(message, opts) {
-        opts = normalizeDelayedSpinnerOpts(opts);
-        this.timeouts.push(setTimeout(() => {
-            this.setMessage(message);
-        }, SHOULD_SHOW_SPINNERS ? opts.delay : opts.ciDelay).unref());
-        return this;
-    }
-    /**
-     * Stops the spinner and cleans up any scheduled timeouts.
-     */
-    cleanup() {
-        this.spinner?.stop();
-        this.timeouts.forEach((t) => clearTimeout(t));
-    }
-}
-exports.DelayedSpinner = DelayedSpinner;
-const SHOULD_SHOW_SPINNERS = process.stdout.isTTY && !(0, is_ci_1.isCI)();
-function normalizeDelayedSpinnerOpts(opts) {
-    opts ??= {};
-    opts.delay ??= 500;
-    opts.ciDelay ??= 30_000;
-    return opts;
-}

package/src/utils/dotenv.js

@@ -1,21 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.loadRootEnvFiles = loadRootEnvFiles;
-const dotenv_1 = require("dotenv");
-const dotenv_expand_1 = require("dotenv-expand");
-const workspace_root_1 = require("./workspace-root");
-const path_1 = require("path");
-/**
- * This loads dotenv files from:
- * - .env
- * - .local.env
- * - .env.local
- */
-function loadRootEnvFiles(root = workspace_root_1.workspaceRoot) {
-    for (const file of ['.local.env', '.env.local', '.env']) {
-        const myEnv = (0, dotenv_1.config)({
-            path: (0, path_1.join)(root, file),
-        });
-        (0, dotenv_expand_1.expand)(myEnv);
-    }
-}

package/src/utils/exit-codes.d.ts

@@ -1,5 +0,0 @@
-/**
- * Translates NodeJS signals to numeric exit code
- * @param signal
- */
-export declare function signalToCode(signal: NodeJS.Signals): number;

package/src/utils/exit-codes.js

@@ -1,19 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.signalToCode = signalToCode;
-/**
- * Translates NodeJS signals to numeric exit code
- * @param signal
- */
-function signalToCode(signal) {
-    switch (signal) {
-        case 'SIGHUP':
-            return 128 + 1;
-        case 'SIGINT':
-            return 128 + 2;
-        case 'SIGTERM':
-            return 128 + 15;
-        default:
-            return 128;
-    }
-}

package/src/utils/fileutils.js

@@ -1,151 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.readJsonFile = readJsonFile;
-exports.readYamlFile = readYamlFile;
-exports.writeJsonFile = writeJsonFile;
-exports.writeJsonFileAsync = writeJsonFileAsync;
-exports.directoryExists = directoryExists;
-exports.fileExists = fileExists;
-exports.createDirectory = createDirectory;
-exports.isRelativePath = isRelativePath;
-exports.extractFileFromTarball = extractFileFromTarball;
-exports.readFileIfExisting = readFileIfExisting;
-const json_1 = require("./json");
-const node_fs_1 = require("node:fs");
-const promises_1 = require("node:fs/promises");
-const path_1 = require("path");
-const tar = require("tar-stream");
-const zlib_1 = require("zlib");
-/**
- * Reads a JSON file and returns the object the JSON content represents.
- *
- * @param path A path to a file.
- * @param options JSON parse options
- * @returns Object the JSON content of the file represents
- */
-function readJsonFile(path, options) {
-    const content = (0, node_fs_1.readFileSync)(path, 'utf-8');
-    if (options) {
-        options.endsWithNewline = content.charCodeAt(content.length - 1) === 10;
-    }
-    try {
-        return (0, json_1.parseJson)(content, options);
-    }
-    catch (e) {
-        e.message = e.message.replace('JSON', path);
-        throw e;
-    }
-}
-/**
- * Reads a YAML file and returns the object the YAML content represents.
- *
- * @param path A path to a file.
- * @returns
- */
-function readYamlFile(path, options) {
-    const content = (0, node_fs_1.readFileSync)(path, 'utf-8');
-    const { load } = require('@zkochan/js-yaml');
-    return load(content, { ...options, filename: path });
-}
-/**
- * Serializes the given data to JSON and writes it to a file.
- *
- * @param path A path to a file.
- * @param data data which should be serialized to JSON and written to the file
- * @param options JSON serialize options
- */
-function writeJsonFile(path, data, options) {
-    (0, node_fs_1.mkdirSync)((0, path_1.dirname)(path), { recursive: true });
-    const serializedJson = (0, json_1.serializeJson)(data, options);
-    const content = options?.appendNewLine
-        ? `${serializedJson}\n`
-        : serializedJson;
-    (0, node_fs_1.writeFileSync)(path, content, { encoding: 'utf-8' });
-}
-/**
- * Serializes the given data to JSON and writes it to a file asynchronously.
- *
- * @param path A path to a file.
- * @param data data which should be serialized to JSON and written to the file
- * @param options JSON serialize options
- */
-async function writeJsonFileAsync(path, data, options) {
-    await (0, promises_1.mkdir)((0, path_1.dirname)(path), { recursive: true });
-    const serializedJson = (0, json_1.serializeJson)(data, options);
-    const content = options?.appendNewLine
-        ? `${serializedJson}\n`
-        : serializedJson;
-    await (0, promises_1.writeFile)(path, content, { encoding: 'utf-8' });
-}
-/**
- * Check if a directory exists
- * @param path Path to directory
- */
-function directoryExists(path) {
-    try {
-        return (0, node_fs_1.statSync)(path).isDirectory();
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * Check if a file exists.
- * @param path Path to file
- */
-function fileExists(path) {
-    try {
-        return (0, node_fs_1.statSync)(path).isFile();
-    }
-    catch {
-        return false;
-    }
-}
-function createDirectory(path) {
-    (0, node_fs_1.mkdirSync)(path, { recursive: true });
-}
-function isRelativePath(path) {
-    return (path === '.' ||
-        path === '..' ||
-        path.startsWith('./') ||
-        path.startsWith('../'));
-}
-/**
- * Extracts a file from a given tarball to the specified destination.
- * @param tarballPath The path to the tarball from where the file should be extracted.
- * @param file The path to the file inside the tarball.
- * @param destinationFilePath The destination file path.
- * @returns True if the file was extracted successfully, false otherwise.
- */
-async function extractFileFromTarball(tarballPath, file, destinationFilePath) {
-    return new Promise((resolve, reject) => {
-        (0, node_fs_1.mkdirSync)((0, path_1.dirname)(destinationFilePath), { recursive: true });
-        var tarExtractStream = tar.extract();
-        const destinationFileStream = (0, node_fs_1.createWriteStream)(destinationFilePath);
-        let isFileExtracted = false;
-        tarExtractStream.on('entry', function (header, stream, next) {
-            if (header.name === file) {
-                stream.pipe(destinationFileStream);
-                stream.on('end', () => {
-                    isFileExtracted = true;
-                });
-                destinationFileStream.on('close', () => {
-                    resolve(destinationFilePath);
-                });
-            }
-            stream.on('end', function () {
-                next();
-            });
-            stream.resume();
-        });
-        tarExtractStream.on('finish', function () {
-            if (!isFileExtracted) {
-                reject();
-            }
-        });
-        (0, node_fs_1.createReadStream)(tarballPath).pipe((0, zlib_1.createGunzip)()).pipe(tarExtractStream);
-    });
-}
-function readFileIfExisting(path) {
-    return (0, node_fs_1.existsSync)(path) ? (0, node_fs_1.readFileSync)(path, 'utf-8') : '';
-}