@rushstack/package-extractor 0.9.9 → 0.10.1

package/lib/scripts/createLinks/cli/actions/CreateLinksAction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CreateLinksAction.d.ts","sourceRoot":"","sources":["../../../../../src/scripts/createLinks/cli/actions/CreateLinksAction.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAiC,MAAM,4BAA4B,CAAC;AAqE9F,qBAAa,iBAAkB,SAAQ,iBAAiB;IACtD,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,sBAAsB,CAA2B;IACzD,OAAO,CAAC,kBAAkB,CAA2B;gBAElC,QAAQ,EAAE,SAAS;cAoBtB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;CAsB3C"}

package/lib/scripts/createLinks/cli/actions/CreateLinksAction.js

@@ -0,0 +1,91 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreateLinksAction = void 0;
+const node_path_1 = __importDefault(require("node:path"));
+const node_core_library_1 = require("@rushstack/node-core-library");
+const ts_command_line_1 = require("@rushstack/ts-command-line");
+const Utils_1 = require("../../../../Utils");
+const CreateLinksUtilities_1 = require("../../utilities/CreateLinksUtilities");
+const constants_1 = require("../../utilities/constants");
+const RemoveLinksAction_1 = require("./RemoveLinksAction");
+async function createLinksAsync(terminal, targetRootFolder, extractorMetadataObject) {
+    await node_core_library_1.Async.forEachAsync(extractorMetadataObject.links, async (linkInfo) => {
+        // Link to the relative path for symlinks
+        const newLinkPath = node_path_1.default.join(targetRootFolder, linkInfo.linkPath);
+        const linkTargetPath = node_path_1.default.join(targetRootFolder, linkInfo.targetPath);
+        // Make sure the containing folder exists
+        await node_core_library_1.FileSystem.ensureFolderAsync(node_path_1.default.dirname(newLinkPath));
+        // NOTE: This logic is based on NpmLinkManager._createSymlink()
+        if (linkInfo.kind === 'folderLink') {
+            terminal.writeVerboseLine(`Creating linked folder at path "${newLinkPath}"`);
+            await node_core_library_1.FileSystem.createSymbolicLinkJunctionAsync({ newLinkPath, linkTargetPath });
+        }
+        else if (linkInfo.kind === 'fileLink') {
+            // Use hardlinks for Windows and symlinks for other platforms since creating a symbolic link
+            // requires administrator permission on Windows. This may cause unexpected behaviour for consumers
+            // of the hardlinked files. If this becomes an issue, we may need to revisit this.
+            terminal.writeVerboseLine(`Creating linked file at path "${newLinkPath}"`);
+            if (process.platform === 'win32') {
+                await node_core_library_1.FileSystem.createHardLinkAsync({ newLinkPath, linkTargetPath });
+            }
+            else {
+                await node_core_library_1.FileSystem.createSymbolicLinkFileAsync({ newLinkPath, linkTargetPath });
+            }
+        }
+    }, { concurrency: constants_1.MAX_CONCURRENCY });
+}
+async function realizeFilesAsync(terminal, targetRootFolder, extractorMetadataObject) {
+    await node_core_library_1.Async.forEachAsync(extractorMetadataObject.files, async (relativeFilePath) => {
+        const filePath = `${targetRootFolder}/${relativeFilePath}`;
+        const realFilePath = await node_core_library_1.FileSystem.getRealPathAsync(filePath);
+        if (!node_core_library_1.Path.isEqual(realFilePath, filePath)) {
+            // Delete the existing symlink and create a hardlink to the real file, since creating hardlinks
+            // is less overhead than copying the file.
+            terminal.writeVerboseLine(`Realizing file at path "${filePath}"`);
+            await node_core_library_1.FileSystem.deleteFileAsync(filePath);
+            await node_core_library_1.FileSystem.createHardLinkAsync({ newLinkPath: filePath, linkTargetPath: realFilePath });
+        }
+    }, { concurrency: constants_1.MAX_CONCURRENCY });
+}
+class CreateLinksAction extends ts_command_line_1.CommandLineAction {
+    constructor(terminal) {
+        super({
+            actionName: 'create',
+            summary: 'Create symlinks for extraction',
+            documentation: 'This action creates symlinks for the extraction process.'
+        });
+        this._terminal = terminal;
+        this._realizeFilesParameter = this.defineFlagParameter({
+            parameterLongName: constants_1.REALIZE_FILES_PARAMETER_NAME,
+            description: 'Realize files instead of creating symlinks'
+        });
+        this._linkBinsParameter = this.defineFlagParameter({
+            parameterLongName: constants_1.LINK_BINS_PARAMETER_NAME,
+            description: 'Create the .bin files for extracted packages'
+        });
+    }
+    async onExecute() {
+        const extractorMetadataObject = await (0, CreateLinksUtilities_1.getExtractorMetadataAsync)();
+        const realizeFiles = this._realizeFilesParameter.value;
+        const linkBins = this._linkBinsParameter.value;
+        this._terminal.writeLine(`Creating links for extraction at path "${constants_1.TARGET_ROOT_FOLDER}"`);
+        await (0, RemoveLinksAction_1.removeLinksAsync)(this._terminal, constants_1.TARGET_ROOT_FOLDER, extractorMetadataObject);
+        await createLinksAsync(this._terminal, constants_1.TARGET_ROOT_FOLDER, extractorMetadataObject);
+        if (realizeFiles) {
+            this._terminal.writeLine(`Realizing files for extraction at path "${constants_1.TARGET_ROOT_FOLDER}"`);
+            await realizeFilesAsync(this._terminal, constants_1.TARGET_ROOT_FOLDER, extractorMetadataObject);
+        }
+        if (linkBins) {
+            this._terminal.writeLine(`Linking bins for extraction at path "${constants_1.TARGET_ROOT_FOLDER}"`);
+            const extractedProjectFolderPaths = extractorMetadataObject.projects.map((project) => node_path_1.default.join(constants_1.TARGET_ROOT_FOLDER, project.path));
+            await (0, Utils_1.makeBinLinksAsync)(this._terminal, extractedProjectFolderPaths);
+        }
+    }
+}
+exports.CreateLinksAction = CreateLinksAction;
+//# sourceMappingURL=CreateLinksAction.js.map

package/lib/scripts/createLinks/cli/actions/CreateLinksAction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CreateLinksAction.js","sourceRoot":"","sources":["../../../../../src/scripts/createLinks/cli/actions/CreateLinksAction.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport path from 'node:path';\nimport { Async, FileSystem, Path } from '@rushstack/node-core-library';\nimport type { ITerminal } from '@rushstack/terminal';\nimport { CommandLineAction, type CommandLineFlagParameter } from '@rushstack/ts-command-line';\nimport type { IExtractorMetadataJson, IProjectInfoJson } from '../../../../PackageExtractor';\nimport { makeBinLinksAsync } from '../../../../Utils';\nimport { getExtractorMetadataAsync } from '../../utilities/CreateLinksUtilities';\nimport {\n  TARGET_ROOT_FOLDER,\n  REALIZE_FILES_PARAMETER_NAME,\n  LINK_BINS_PARAMETER_NAME,\n  MAX_CONCURRENCY\n} from '../../utilities/constants';\nimport { removeLinksAsync } from './RemoveLinksAction';\n\nasync function createLinksAsync(\n  terminal: ITerminal,\n  targetRootFolder: string,\n  extractorMetadataObject: IExtractorMetadataJson\n): Promise<void> {\n  await Async.forEachAsync(\n    extractorMetadataObject.links,\n    async (linkInfo) => {\n      // Link to the relative path for symlinks\n      const newLinkPath: string = path.join(targetRootFolder, linkInfo.linkPath);\n      const linkTargetPath: string = path.join(targetRootFolder, linkInfo.targetPath);\n\n      // Make sure the containing folder exists\n      await FileSystem.ensureFolderAsync(path.dirname(newLinkPath));\n\n      // NOTE: This logic is based on NpmLinkManager._createSymlink()\n      if (linkInfo.kind === 'folderLink') {\n        terminal.writeVerboseLine(`Creating linked folder at path \"${newLinkPath}\"`);\n        await FileSystem.createSymbolicLinkJunctionAsync({ newLinkPath, linkTargetPath });\n      } else if (linkInfo.kind === 'fileLink') {\n        // Use hardlinks for Windows and symlinks for other platforms since creating a symbolic link\n        // requires administrator permission on Windows. This may cause unexpected behaviour for consumers\n        // of the hardlinked files. If this becomes an issue, we may need to revisit this.\n        terminal.writeVerboseLine(`Creating linked file at path \"${newLinkPath}\"`);\n        if (process.platform === 'win32') {\n          await FileSystem.createHardLinkAsync({ newLinkPath, linkTargetPath });\n        } else {\n          await FileSystem.createSymbolicLinkFileAsync({ newLinkPath, linkTargetPath });\n        }\n      }\n    },\n    { concurrency: MAX_CONCURRENCY }\n  );\n}\n\nasync function realizeFilesAsync(\n  terminal: ITerminal,\n  targetRootFolder: string,\n  extractorMetadataObject: IExtractorMetadataJson\n): Promise<void> {\n  await Async.forEachAsync(\n    extractorMetadataObject.files,\n    async (relativeFilePath) => {\n      const filePath: string = `${targetRootFolder}/${relativeFilePath}`;\n      const realFilePath: string = await FileSystem.getRealPathAsync(filePath);\n      if (!Path.isEqual(realFilePath, filePath)) {\n        // Delete the existing symlink and create a hardlink to the real file, since creating hardlinks\n        // is less overhead than copying the file.\n        terminal.writeVerboseLine(`Realizing file at path \"${filePath}\"`);\n        await FileSystem.deleteFileAsync(filePath);\n        await FileSystem.createHardLinkAsync({ newLinkPath: filePath, linkTargetPath: realFilePath });\n      }\n    },\n    { concurrency: MAX_CONCURRENCY }\n  );\n}\n\nexport class CreateLinksAction extends CommandLineAction {\n  private _terminal: ITerminal;\n  private _realizeFilesParameter: CommandLineFlagParameter;\n  private _linkBinsParameter: CommandLineFlagParameter;\n\n  public constructor(terminal: ITerminal) {\n    super({\n      actionName: 'create',\n      summary: 'Create symlinks for extraction',\n      documentation: 'This action creates symlinks for the extraction process.'\n    });\n\n    this._terminal = terminal;\n\n    this._realizeFilesParameter = this.defineFlagParameter({\n      parameterLongName: REALIZE_FILES_PARAMETER_NAME,\n      description: 'Realize files instead of creating symlinks'\n    });\n\n    this._linkBinsParameter = this.defineFlagParameter({\n      parameterLongName: LINK_BINS_PARAMETER_NAME,\n      description: 'Create the .bin files for extracted packages'\n    });\n  }\n\n  protected async onExecute(): Promise<void> {\n    const extractorMetadataObject: IExtractorMetadataJson = await getExtractorMetadataAsync();\n    const realizeFiles: boolean = this._realizeFilesParameter.value;\n    const linkBins: boolean = this._linkBinsParameter.value;\n\n    this._terminal.writeLine(`Creating links for extraction at path \"${TARGET_ROOT_FOLDER}\"`);\n    await removeLinksAsync(this._terminal, TARGET_ROOT_FOLDER, extractorMetadataObject);\n    await createLinksAsync(this._terminal, TARGET_ROOT_FOLDER, extractorMetadataObject);\n\n    if (realizeFiles) {\n      this._terminal.writeLine(`Realizing files for extraction at path \"${TARGET_ROOT_FOLDER}\"`);\n      await realizeFilesAsync(this._terminal, TARGET_ROOT_FOLDER, extractorMetadataObject);\n    }\n\n    if (linkBins) {\n      this._terminal.writeLine(`Linking bins for extraction at path \"${TARGET_ROOT_FOLDER}\"`);\n      const extractedProjectFolderPaths: string[] = extractorMetadataObject.projects.map(\n        (project: IProjectInfoJson) => path.join(TARGET_ROOT_FOLDER, project.path)\n      );\n      await makeBinLinksAsync(this._terminal, extractedProjectFolderPaths);\n    }\n  }\n}\n"]}

package/lib/scripts/createLinks/cli/actions/RemoveLinksAction.d.ts

@@ -0,0 +1,10 @@
+import type { ITerminal } from '@rushstack/terminal';
+import { CommandLineAction } from '@rushstack/ts-command-line';
+import type { IExtractorMetadataJson } from '../../../../PackageExtractor';
+export declare function removeLinksAsync(terminal: ITerminal, targetRootFolder: string, extractorMetadataObject: IExtractorMetadataJson): Promise<void>;
+export declare class RemoveLinksAction extends CommandLineAction {
+    private _terminal;
+    constructor(terminal: ITerminal);
+    protected onExecute(): Promise<void>;
+}
+//# sourceMappingURL=RemoveLinksAction.d.ts.map

package/lib/scripts/createLinks/cli/actions/RemoveLinksAction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RemoveLinksAction.d.ts","sourceRoot":"","sources":["../../../../../src/scripts/createLinks/cli/actions/RemoveLinksAction.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAI3E,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,SAAS,EACnB,gBAAgB,EAAE,MAAM,EACxB,uBAAuB,EAAE,sBAAsB,GAC9C,OAAO,CAAC,IAAI,CAAC,CAUf;AAED,qBAAa,iBAAkB,SAAQ,iBAAiB;IACtD,OAAO,CAAC,SAAS,CAAY;gBAEV,QAAQ,EAAE,SAAS;cAUtB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;CAM3C"}

package/lib/scripts/createLinks/cli/actions/RemoveLinksAction.js

@@ -0,0 +1,38 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RemoveLinksAction = exports.removeLinksAsync = void 0;
+const node_path_1 = __importDefault(require("node:path"));
+const node_core_library_1 = require("@rushstack/node-core-library");
+const ts_command_line_1 = require("@rushstack/ts-command-line");
+const CreateLinksUtilities_1 = require("../../utilities/CreateLinksUtilities");
+const constants_1 = require("../../utilities/constants");
+async function removeLinksAsync(terminal, targetRootFolder, extractorMetadataObject) {
+    await node_core_library_1.Async.forEachAsync(extractorMetadataObject.links, async ({ linkPath }) => {
+        const newLinkPath = node_path_1.default.join(targetRootFolder, linkPath);
+        terminal.writeVerboseLine(`Removing link at path "${newLinkPath}"`);
+        await node_core_library_1.FileSystem.deleteFileAsync(newLinkPath, { throwIfNotExists: false });
+    }, { concurrency: constants_1.MAX_CONCURRENCY });
+}
+exports.removeLinksAsync = removeLinksAsync;
+class RemoveLinksAction extends ts_command_line_1.CommandLineAction {
+    constructor(terminal) {
+        super({
+            actionName: 'remove',
+            summary: 'Remove symlinks created by the "create" action',
+            documentation: 'This action removes the symlinks created by the "create" action.'
+        });
+        this._terminal = terminal;
+    }
+    async onExecute() {
+        const extractorMetadataObject = await (0, CreateLinksUtilities_1.getExtractorMetadataAsync)();
+        this._terminal.writeLine(`Removing links for extraction at path "${constants_1.TARGET_ROOT_FOLDER}"`);
+        await removeLinksAsync(this._terminal, constants_1.TARGET_ROOT_FOLDER, extractorMetadataObject);
+    }
+}
+exports.RemoveLinksAction = RemoveLinksAction;
+//# sourceMappingURL=RemoveLinksAction.js.map

package/lib/scripts/createLinks/cli/actions/RemoveLinksAction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RemoveLinksAction.js","sourceRoot":"","sources":["../../../../../src/scripts/createLinks/cli/actions/RemoveLinksAction.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;;;;AAE3D,0DAA6B;AAC7B,oEAAiE;AAEjE,gEAA+D;AAE/D,+EAAiF;AACjF,yDAAgF;AAEzE,KAAK,UAAU,gBAAgB,CACpC,QAAmB,EACnB,gBAAwB,EACxB,uBAA+C;IAE/C,MAAM,yBAAK,CAAC,YAAY,CACtB,uBAAuB,CAAC,KAAK,EAC7B,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;QACrB,MAAM,WAAW,GAAW,mBAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC;QAClE,QAAQ,CAAC,gBAAgB,CAAC,0BAA0B,WAAW,GAAG,CAAC,CAAC;QACpE,MAAM,8BAAU,CAAC,eAAe,CAAC,WAAW,EAAE,EAAE,gBAAgB,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7E,CAAC,EACD,EAAE,WAAW,EAAE,2BAAe,EAAE,CACjC,CAAC;AACJ,CAAC;AAdD,4CAcC;AAED,MAAa,iBAAkB,SAAQ,mCAAiB;IAGtD,YAAmB,QAAmB;QACpC,KAAK,CAAC;YACJ,UAAU,EAAE,QAAQ;YACpB,OAAO,EAAE,gDAAgD;YACzD,aAAa,EAAE,kEAAkE;SAClF,CAAC,CAAC;QAEH,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC5B,CAAC;IAES,KAAK,CAAC,SAAS;QACvB,MAAM,uBAAuB,GAA2B,MAAM,IAAA,gDAAyB,GAAE,CAAC;QAE1F,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,0CAA0C,8BAAkB,GAAG,CAAC,CAAC;QAC1F,MAAM,gBAAgB,CAAC,IAAI,CAAC,SAAS,EAAE,8BAAkB,EAAE,uBAAuB,CAAC,CAAC;IACtF,CAAC;CACF;AAnBD,8CAmBC","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport path from 'node:path';\nimport { Async, FileSystem } from '@rushstack/node-core-library';\nimport type { ITerminal } from '@rushstack/terminal';\nimport { CommandLineAction } from '@rushstack/ts-command-line';\nimport type { IExtractorMetadataJson } from '../../../../PackageExtractor';\nimport { getExtractorMetadataAsync } from '../../utilities/CreateLinksUtilities';\nimport { TARGET_ROOT_FOLDER, MAX_CONCURRENCY } from '../../utilities/constants';\n\nexport async function removeLinksAsync(\n  terminal: ITerminal,\n  targetRootFolder: string,\n  extractorMetadataObject: IExtractorMetadataJson\n): Promise<void> {\n  await Async.forEachAsync(\n    extractorMetadataObject.links,\n    async ({ linkPath }) => {\n      const newLinkPath: string = path.join(targetRootFolder, linkPath);\n      terminal.writeVerboseLine(`Removing link at path \"${newLinkPath}\"`);\n      await FileSystem.deleteFileAsync(newLinkPath, { throwIfNotExists: false });\n    },\n    { concurrency: MAX_CONCURRENCY }\n  );\n}\n\nexport class RemoveLinksAction extends CommandLineAction {\n  private _terminal: ITerminal;\n\n  public constructor(terminal: ITerminal) {\n    super({\n      actionName: 'remove',\n      summary: 'Remove symlinks created by the \"create\" action',\n      documentation: 'This action removes the symlinks created by the \"create\" action.'\n    });\n\n    this._terminal = terminal;\n  }\n\n  protected async onExecute(): Promise<void> {\n    const extractorMetadataObject: IExtractorMetadataJson = await getExtractorMetadataAsync();\n\n    this._terminal.writeLine(`Removing links for extraction at path \"${TARGET_ROOT_FOLDER}\"`);\n    await removeLinksAsync(this._terminal, TARGET_ROOT_FOLDER, extractorMetadataObject);\n  }\n}\n"]}

package/lib/scripts/createLinks/start.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=start.d.ts.map

package/lib/scripts/createLinks/start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../../src/scripts/createLinks/start.ts"],"names":[],"mappings":""}

package/lib/scripts/createLinks/start.js

@@ -0,0 +1,10 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+const terminal_1 = require("@rushstack/terminal");
+const CreateLinksCommandLineParser_1 = require("./cli/CreateLinksCommandLineParser");
+const terminal = new terminal_1.Terminal(new terminal_1.ConsoleTerminalProvider({ verboseEnabled: true }));
+const parser = new CreateLinksCommandLineParser_1.CreateLinksCommandLineParser(terminal);
+parser.executeAsync().catch(terminal.writeErrorLine);
+//# sourceMappingURL=start.js.map

package/lib/scripts/createLinks/start.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.js","sourceRoot":"","sources":["../../../src/scripts/createLinks/start.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;AAE3D,kDAAwE;AAExE,qFAAkF;AAElF,MAAM,QAAQ,GAAa,IAAI,mBAAQ,CAAC,IAAI,kCAAuB,CAAC,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAE/F,MAAM,MAAM,GAAiC,IAAI,2DAA4B,CAAC,QAAQ,CAAC,CAAC;AACxF,MAAM,CAAC,YAAY,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport { Terminal, ConsoleTerminalProvider } from '@rushstack/terminal';\n\nimport { CreateLinksCommandLineParser } from './cli/CreateLinksCommandLineParser';\n\nconst terminal: Terminal = new Terminal(new ConsoleTerminalProvider({ verboseEnabled: true }));\n\nconst parser: CreateLinksCommandLineParser = new CreateLinksCommandLineParser(terminal);\nparser.executeAsync().catch(terminal.writeErrorLine);\n"]}

package/lib/scripts/createLinks/utilities/CreateLinksUtilities.d.ts

@@ -0,0 +1,3 @@
+import type { IExtractorMetadataJson } from '../../../PackageExtractor';
+export declare function getExtractorMetadataAsync(): Promise<IExtractorMetadataJson>;
+//# sourceMappingURL=CreateLinksUtilities.d.ts.map

package/lib/scripts/createLinks/utilities/CreateLinksUtilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CreateLinksUtilities.d.ts","sourceRoot":"","sources":["../../../../src/scripts/createLinks/utilities/CreateLinksUtilities.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAGxE,wBAAsB,yBAAyB,IAAI,OAAO,CAAC,sBAAsB,CAAC,CAKjF"}

package/lib/scripts/createLinks/utilities/CreateLinksUtilities.js

@@ -0,0 +1,15 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getExtractorMetadataAsync = void 0;
+const node_core_library_1 = require("@rushstack/node-core-library");
+const PathConstants_1 = require("../../../PathConstants");
+async function getExtractorMetadataAsync() {
+    const extractorMetadataPath = `${__dirname}/${PathConstants_1.EXTRACTOR_METADATA_FILENAME}`;
+    const extractorMetadataJson = await node_core_library_1.FileSystem.readFileAsync(extractorMetadataPath);
+    const extractorMetadataObject = JSON.parse(extractorMetadataJson);
+    return extractorMetadataObject;
+}
+exports.getExtractorMetadataAsync = getExtractorMetadataAsync;
+//# sourceMappingURL=CreateLinksUtilities.js.map

package/lib/scripts/createLinks/utilities/CreateLinksUtilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CreateLinksUtilities.js","sourceRoot":"","sources":["../../../../src/scripts/createLinks/utilities/CreateLinksUtilities.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;AAE3D,oEAA0D;AAE1D,0DAAqE;AAE9D,KAAK,UAAU,yBAAyB;IAC7C,MAAM,qBAAqB,GAAW,GAAG,SAAS,IAAI,2CAA2B,EAAE,CAAC;IACpF,MAAM,qBAAqB,GAAW,MAAM,8BAAU,CAAC,aAAa,CAAC,qBAAqB,CAAC,CAAC;IAC5F,MAAM,uBAAuB,GAA2B,IAAI,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;IAC1F,OAAO,uBAAuB,CAAC;AACjC,CAAC;AALD,8DAKC","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport { FileSystem } from '@rushstack/node-core-library';\nimport type { IExtractorMetadataJson } from '../../../PackageExtractor';\nimport { EXTRACTOR_METADATA_FILENAME } from '../../../PathConstants';\n\nexport async function getExtractorMetadataAsync(): Promise<IExtractorMetadataJson> {\n  const extractorMetadataPath: string = `${__dirname}/${EXTRACTOR_METADATA_FILENAME}`;\n  const extractorMetadataJson: string = await FileSystem.readFileAsync(extractorMetadataPath);\n  const extractorMetadataObject: IExtractorMetadataJson = JSON.parse(extractorMetadataJson);\n  return extractorMetadataObject;\n}\n"]}

package/lib/scripts/createLinks/utilities/constants.d.ts

@@ -0,0 +1,34 @@
+import type { TARGET_ROOT_SCRIPT_RELATIVE_PATH_TEMPLATE_STRING as TargetRootScriptRelativePathTemplateString } from '../../../PackageExtractor';
+/**
+ * The maximum number of concurrent operations to perform.
+ */
+export declare const MAX_CONCURRENCY: number;
+/**
+ * The name of the action to create symlinks.
+ */
+export declare const CREATE_ACTION_NAME: 'create';
+/**
+ * The name of the action to remove symlinks.
+ */
+export declare const REMOVE_ACTION_NAME: 'remove';
+/**
+ * The name of the parameter to realize files when creating symlinks.
+ */
+export declare const REALIZE_FILES_PARAMETER_NAME: '--realize-files';
+/**
+ * The name of the parameter to link bins when creating symlinks.
+ */
+export declare const LINK_BINS_PARAMETER_NAME: '--link-bins';
+/**
+ * The name of the parameter to link packages when creating symlinks. The actual value of this
+ * export is modified after bundling the script to ensure that the extracted version of the script
+ * contains the relative path from the extraction target folder to the script. Generally, this
+ * value should not be used directly, but rather the `TARGET_ROOT_FOLDER` export should be used
+ * instead.
+ */
+export declare const TARGET_ROOT_SCRIPT_RELATIVE_PATH: typeof TargetRootScriptRelativePathTemplateString;
+/**
+ * The path to the root folder where symlinks are created.
+ */
+export declare const TARGET_ROOT_FOLDER: string;
+//# sourceMappingURL=constants.d.ts.map

package/lib/scripts/createLinks/utilities/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/scripts/createLinks/utilities/constants.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gDAAgD,IAAI,0CAA0C,EAAE,MAAM,2BAA2B,CAAC;AAEhJ;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,MAA6B,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,QAAmB,CAAC;AAErD;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,QAAmB,CAAC;AAErD;;GAEG;AACH,eAAO,MAAM,4BAA4B,EAAE,iBAAqC,CAAC;AAEjF;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,aAA6B,CAAC;AAErE;;;;;;GAMG;AACH,eAAO,MAAM,gCAAgC,EAAE,OAAO,0CAChB,CAAC;AAEvC;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAkE,CAAC"}

package/lib/scripts/createLinks/utilities/constants.js

@@ -0,0 +1,43 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TARGET_ROOT_FOLDER = exports.TARGET_ROOT_SCRIPT_RELATIVE_PATH = exports.LINK_BINS_PARAMETER_NAME = exports.REALIZE_FILES_PARAMETER_NAME = exports.REMOVE_ACTION_NAME = exports.CREATE_ACTION_NAME = exports.MAX_CONCURRENCY = void 0;
+const node_os_1 = __importDefault(require("node:os"));
+const node_path_1 = __importDefault(require("node:path"));
+/**
+ * The maximum number of concurrent operations to perform.
+ */
+exports.MAX_CONCURRENCY = node_os_1.default.cpus().length * 2;
+/**
+ * The name of the action to create symlinks.
+ */
+exports.CREATE_ACTION_NAME = 'create';
+/**
+ * The name of the action to remove symlinks.
+ */
+exports.REMOVE_ACTION_NAME = 'remove';
+/**
+ * The name of the parameter to realize files when creating symlinks.
+ */
+exports.REALIZE_FILES_PARAMETER_NAME = '--realize-files';
+/**
+ * The name of the parameter to link bins when creating symlinks.
+ */
+exports.LINK_BINS_PARAMETER_NAME = '--link-bins';
+/**
+ * The name of the parameter to link packages when creating symlinks. The actual value of this
+ * export is modified after bundling the script to ensure that the extracted version of the script
+ * contains the relative path from the extraction target folder to the script. Generally, this
+ * value should not be used directly, but rather the `TARGET_ROOT_FOLDER` export should be used
+ * instead.
+ */
+exports.TARGET_ROOT_SCRIPT_RELATIVE_PATH = '{TARGET_ROOT_SCRIPT_RELATIVE_PATH}';
+/**
+ * The path to the root folder where symlinks are created.
+ */
+exports.TARGET_ROOT_FOLDER = node_path_1.default.resolve(__dirname, exports.TARGET_ROOT_SCRIPT_RELATIVE_PATH);
+//# sourceMappingURL=constants.js.map

package/lib/scripts/createLinks/utilities/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/scripts/createLinks/utilities/constants.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;;;;AAE3D,sDAAyB;AACzB,0DAA6B;AAG7B;;GAEG;AACU,QAAA,eAAe,GAAW,iBAAE,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;AAE5D;;GAEG;AACU,QAAA,kBAAkB,GAAa,QAAQ,CAAC;AAErD;;GAEG;AACU,QAAA,kBAAkB,GAAa,QAAQ,CAAC;AAErD;;GAEG;AACU,QAAA,4BAA4B,GAAsB,iBAAiB,CAAC;AAEjF;;GAEG;AACU,QAAA,wBAAwB,GAAkB,aAAa,CAAC;AAErE;;;;;;GAMG;AACU,QAAA,gCAAgC,GAC3C,oCAAoC,CAAC;AAEvC;;GAEG;AACU,QAAA,kBAAkB,GAAW,mBAAI,CAAC,OAAO,CAAC,SAAS,EAAE,wCAAgC,CAAC,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport os from 'node:os';\nimport path from 'node:path';\nimport type { TARGET_ROOT_SCRIPT_RELATIVE_PATH_TEMPLATE_STRING as TargetRootScriptRelativePathTemplateString } from '../../../PackageExtractor';\n\n/**\n * The maximum number of concurrent operations to perform.\n */\nexport const MAX_CONCURRENCY: number = os.cpus().length * 2;\n\n/**\n * The name of the action to create symlinks.\n */\nexport const CREATE_ACTION_NAME: 'create' = 'create';\n\n/**\n * The name of the action to remove symlinks.\n */\nexport const REMOVE_ACTION_NAME: 'remove' = 'remove';\n\n/**\n * The name of the parameter to realize files when creating symlinks.\n */\nexport const REALIZE_FILES_PARAMETER_NAME: '--realize-files' = '--realize-files';\n\n/**\n * The name of the parameter to link bins when creating symlinks.\n */\nexport const LINK_BINS_PARAMETER_NAME: '--link-bins' = '--link-bins';\n\n/**\n * The name of the parameter to link packages when creating symlinks. The actual value of this\n * export is modified after bundling the script to ensure that the extracted version of the script\n * contains the relative path from the extraction target folder to the script. Generally, this\n * value should not be used directly, but rather the `TARGET_ROOT_FOLDER` export should be used\n * instead.\n */\nexport const TARGET_ROOT_SCRIPT_RELATIVE_PATH: typeof TargetRootScriptRelativePathTemplateString =\n  '{TARGET_ROOT_SCRIPT_RELATIVE_PATH}';\n\n/**\n * The path to the root folder where symlinks are created.\n */\nexport const TARGET_ROOT_FOLDER: string = path.resolve(__dirname, TARGET_ROOT_SCRIPT_RELATIVE_PATH);\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rushstack/package-extractor",
-  "version": "0.9.9",
+  "version": "0.10.1",
   "description": "A library for bundling selected files and dependencies into a deployable package.",
   "main": "lib/index.js",
   "typings": "dist/package-extractor.d.ts",
@@ -17,8 +17,9 @@
     "minimatch": "~3.0.3",
     "npm-packlist": "~2.1.2",
     "semver": "~7.5.4",
-    "@rushstack/node-core-library": "5.9.0",
-    "@rushstack/terminal": "0.14.2"
+    "@rushstack/node-core-library": "5.10.0",
+    "@rushstack/ts-command-line": "4.23.1",
+    "@rushstack/terminal": "0.14.3"
   },
   "devDependencies": {
     "@types/glob": "7.1.1",
@@ -28,9 +29,9 @@
     "webpack": "~5.95.0",
     "@types/semver": "7.5.0",
     "local-node-rig": "1.0.0",
-    "@rushstack/heft-webpack5-plugin": "0.11.4",
-    "@rushstack/heft": "0.68.6",
-    "@rushstack/webpack-preserve-dynamic-require-plugin": "0.11.73"
+    "@rushstack/heft": "0.68.7",
+    "@rushstack/heft-webpack5-plugin": "0.11.5",
+    "@rushstack/webpack-preserve-dynamic-require-plugin": "0.11.74"
   },
   "scripts": {
     "build": "heft build --clean",

package/lib/scripts/create-links.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=create-links.d.ts.map

package/lib/scripts/create-links.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"create-links.d.ts","sourceRoot":"","sources":["../../src/scripts/create-links.ts"],"names":[],"mappings":""}

package/lib/scripts/create-links.js

@@ -1,119 +0,0 @@
-"use strict";
-// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
-// See LICENSE in the project root for license information.
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-// THIS SCRIPT IS GENERATED BY THE "rush deploy" COMMAND.
-const node_os_1 = __importDefault(require("node:os"));
-const node_fs_1 = __importDefault(require("node:fs"));
-const node_path_1 = __importDefault(require("node:path"));
-const node_core_library_1 = require("@rushstack/node-core-library");
-const terminal_1 = require("@rushstack/terminal");
-const MAX_CONCURRENCY = node_os_1.default.cpus().length * 2;
-const CREATE_ACTION_NAME = 'create';
-const REMOVE_ACTION_NAME = 'remove';
-const REALIZE_FILES_OPTION_NAME = '--realize-files';
-const TARGET_ROOT_SCRIPT_RELATIVE_PATH = '{TARGET_ROOT_SCRIPT_RELATIVE_PATH}';
-const TARGET_ROOT_FOLDER = node_path_1.default.resolve(__dirname, TARGET_ROOT_SCRIPT_RELATIVE_PATH);
-async function removeLinksAsync(terminal, targetRootFolder, extractorMetadataObject) {
-    await node_core_library_1.Async.forEachAsync(extractorMetadataObject.links, async ({ linkPath }) => {
-        const newLinkPath = `${targetRootFolder}/${linkPath}`;
-        terminal.writeVerboseLine(`Removing link at path "${newLinkPath}"`);
-        await node_core_library_1.FileSystem.deleteFileAsync(newLinkPath, { throwIfNotExists: false });
-    }, { concurrency: MAX_CONCURRENCY });
-}
-async function createLinksAsync(terminal, targetRootFolder, extractorMetadataObject) {
-    await node_core_library_1.Async.forEachAsync(extractorMetadataObject.links, async (linkInfo) => {
-        // Link to the relative path for symlinks
-        const newLinkPath = `${targetRootFolder}/${linkInfo.linkPath}`;
-        const linkTargetPath = `${targetRootFolder}/${linkInfo.targetPath}`;
-        // Make sure the containing folder exists
-        await node_core_library_1.FileSystem.ensureFolderAsync(node_path_1.default.dirname(newLinkPath));
-        // NOTE: This logic is based on NpmLinkManager._createSymlink()
-        if (linkInfo.kind === 'folderLink') {
-            terminal.writeVerboseLine(`Creating linked folder at path "${newLinkPath}"`);
-            await node_core_library_1.FileSystem.createSymbolicLinkJunctionAsync({ newLinkPath, linkTargetPath });
-        }
-        else if (linkInfo.kind === 'fileLink') {
-            // Use hardlinks for Windows and symlinks for other platforms since creating a symbolic link
-            // requires administrator permission on Windows. This may cause unexpected behaviour for consumers
-            // of the hardlinked files. If this becomes an issue, we may need to revisit this.
-            terminal.writeVerboseLine(`Creating linked file at path "${newLinkPath}"`);
-            if (process.platform === 'win32') {
-                await node_core_library_1.FileSystem.createHardLinkAsync({ newLinkPath, linkTargetPath });
-            }
-            else {
-                await node_core_library_1.FileSystem.createSymbolicLinkFileAsync({ newLinkPath, linkTargetPath });
-            }
-        }
-    }, { concurrency: MAX_CONCURRENCY });
-}
-async function realizeFilesAsync(terminal, targetRootFolder, extractorMetadataObject) {
-    await node_core_library_1.Async.forEachAsync(extractorMetadataObject.files, async (relativeFilePath) => {
-        const filePath = `${targetRootFolder}/${relativeFilePath}`;
-        const realFilePath = await node_core_library_1.FileSystem.getRealPathAsync(filePath);
-        if (!node_core_library_1.Path.isEqual(realFilePath, filePath)) {
-            await node_core_library_1.FileSystem.deleteFileAsync(filePath);
-            // Hard links seem to cause build failures on Mac, so for all other operating
-            // systems we copy files.
-            terminal.writeVerboseLine(`Realizing file at path "${filePath}"`);
-            if (process.platform === 'win32') {
-                await node_core_library_1.FileSystem.createHardLinkAsync({ newLinkPath: filePath, linkTargetPath: realFilePath });
-            }
-            else {
-                await node_core_library_1.FileSystem.copyFileAsync({ sourcePath: realFilePath, destinationPath: filePath });
-            }
-        }
-    }, { concurrency: MAX_CONCURRENCY });
-}
-function showUsage(terminal) {
-    terminal.writeLine('Usage:');
-    terminal.writeLine(`  node create-links.js ${CREATE_ACTION_NAME} [${REALIZE_FILES_OPTION_NAME}]`);
-    terminal.writeLine(`  node create-links.js ${REMOVE_ACTION_NAME}`);
-    terminal.writeLine('');
-    terminal.writeLine('Creates or removes the symlinks for the output folder created by "rush deploy".');
-    terminal.writeLine('The link information is read from "extractor-metadata.json" in the same folder.');
-}
-async function runAsync(terminal) {
-    // Example: [ "node.exe", "create-links.js", ""create" ]
-    const args = process.argv.slice(2);
-    if ((args[0] !== CREATE_ACTION_NAME && args[0] !== REMOVE_ACTION_NAME) ||
-        (args[0] === CREATE_ACTION_NAME && args[1] && args[1] !== REALIZE_FILES_OPTION_NAME) ||
-        (args[0] === REMOVE_ACTION_NAME && args[1])) {
-        showUsage(terminal);
-        return false;
-    }
-    const extractorMetadataPath = `${__dirname}/extractor-metadata.json`;
-    if (!node_fs_1.default.existsSync(extractorMetadataPath)) {
-        throw new Error('Input file not found: ' + extractorMetadataPath);
-    }
-    const extractorMetadataJson = node_fs_1.default.readFileSync(extractorMetadataPath).toString();
-    const extractorMetadataObject = JSON.parse(extractorMetadataJson);
-    if (args[0] === 'create') {
-        const realizeFiles = args[1] === '--realize-files';
-        terminal.writeLine(`Creating links for extraction at path "${TARGET_ROOT_FOLDER}"`);
-        await removeLinksAsync(terminal, TARGET_ROOT_FOLDER, extractorMetadataObject);
-        await createLinksAsync(terminal, TARGET_ROOT_FOLDER, extractorMetadataObject);
-        if (realizeFiles) {
-            await realizeFilesAsync(terminal, TARGET_ROOT_FOLDER, extractorMetadataObject);
-        }
-    }
-    else if (args[0] === 'remove') {
-        terminal.writeLine(`Removing links for extraction at path "${TARGET_ROOT_FOLDER}"`);
-        await removeLinksAsync(terminal, TARGET_ROOT_FOLDER, extractorMetadataObject);
-    }
-    terminal.writeLine('The operation completed successfully.');
-    return true;
-}
-process.exitCode = 1;
-const terminal = new terminal_1.Terminal(new terminal_1.ConsoleTerminalProvider());
-runAsync(terminal)
-    .then((result) => {
-    process.exitCode = result ? 0 : 1;
-})
-    .catch((error) => {
-    terminal.writeErrorLine('ERROR: ' + error);
-});
-//# sourceMappingURL=create-links.js.map

package/lib/scripts/create-links.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"create-links.js","sourceRoot":"","sources":["../../src/scripts/create-links.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\n// THIS SCRIPT IS GENERATED BY THE \"rush deploy\" COMMAND.\n\nimport os from 'node:os';\nimport fs from 'node:fs';\nimport path from 'node:path';\nimport { Async, FileSystem, Path } from '@rushstack/node-core-library';\nimport { Terminal, ConsoleTerminalProvider } from '@rushstack/terminal';\nimport type {\n  TARGET_ROOT_SCRIPT_RELATIVE_PATH_TEMPLATE_STRING as TargetRootScriptRelativePathTemplateString,\n  IExtractorMetadataJson\n} from '../PackageExtractor';\n\nconst MAX_CONCURRENCY: number = os.cpus().length * 2;\nconst CREATE_ACTION_NAME: 'create' = 'create';\nconst REMOVE_ACTION_NAME: 'remove' = 'remove';\nconst REALIZE_FILES_OPTION_NAME: '--realize-files' = '--realize-files';\n\nconst TARGET_ROOT_SCRIPT_RELATIVE_PATH: typeof TargetRootScriptRelativePathTemplateString =\n  '{TARGET_ROOT_SCRIPT_RELATIVE_PATH}';\nconst TARGET_ROOT_FOLDER: string = path.resolve(__dirname, TARGET_ROOT_SCRIPT_RELATIVE_PATH);\n\nasync function removeLinksAsync(\n  terminal: Terminal,\n  targetRootFolder: string,\n  extractorMetadataObject: IExtractorMetadataJson\n): Promise<void> {\n  await Async.forEachAsync(\n    extractorMetadataObject.links,\n    async ({ linkPath }) => {\n      const newLinkPath: string = `${targetRootFolder}/${linkPath}`;\n      terminal.writeVerboseLine(`Removing link at path \"${newLinkPath}\"`);\n      await FileSystem.deleteFileAsync(newLinkPath, { throwIfNotExists: false });\n    },\n    { concurrency: MAX_CONCURRENCY }\n  );\n}\n\nasync function createLinksAsync(\n  terminal: Terminal,\n  targetRootFolder: string,\n  extractorMetadataObject: IExtractorMetadataJson\n): Promise<void> {\n  await Async.forEachAsync(\n    extractorMetadataObject.links,\n    async (linkInfo) => {\n      // Link to the relative path for symlinks\n      const newLinkPath: string = `${targetRootFolder}/${linkInfo.linkPath}`;\n      const linkTargetPath: string = `${targetRootFolder}/${linkInfo.targetPath}`;\n\n      // Make sure the containing folder exists\n      await FileSystem.ensureFolderAsync(path.dirname(newLinkPath));\n\n      // NOTE: This logic is based on NpmLinkManager._createSymlink()\n      if (linkInfo.kind === 'folderLink') {\n        terminal.writeVerboseLine(`Creating linked folder at path \"${newLinkPath}\"`);\n        await FileSystem.createSymbolicLinkJunctionAsync({ newLinkPath, linkTargetPath });\n      } else if (linkInfo.kind === 'fileLink') {\n        // Use hardlinks for Windows and symlinks for other platforms since creating a symbolic link\n        // requires administrator permission on Windows. This may cause unexpected behaviour for consumers\n        // of the hardlinked files. If this becomes an issue, we may need to revisit this.\n        terminal.writeVerboseLine(`Creating linked file at path \"${newLinkPath}\"`);\n        if (process.platform === 'win32') {\n          await FileSystem.createHardLinkAsync({ newLinkPath, linkTargetPath });\n        } else {\n          await FileSystem.createSymbolicLinkFileAsync({ newLinkPath, linkTargetPath });\n        }\n      }\n    },\n    { concurrency: MAX_CONCURRENCY }\n  );\n}\n\nasync function realizeFilesAsync(\n  terminal: Terminal,\n  targetRootFolder: string,\n  extractorMetadataObject: IExtractorMetadataJson\n): Promise<void> {\n  await Async.forEachAsync(\n    extractorMetadataObject.files,\n    async (relativeFilePath) => {\n      const filePath: string = `${targetRootFolder}/${relativeFilePath}`;\n      const realFilePath: string = await FileSystem.getRealPathAsync(filePath);\n      if (!Path.isEqual(realFilePath, filePath)) {\n        await FileSystem.deleteFileAsync(filePath);\n\n        // Hard links seem to cause build failures on Mac, so for all other operating\n        // systems we copy files.\n        terminal.writeVerboseLine(`Realizing file at path \"${filePath}\"`);\n        if (process.platform === 'win32') {\n          await FileSystem.createHardLinkAsync({ newLinkPath: filePath, linkTargetPath: realFilePath });\n        } else {\n          await FileSystem.copyFileAsync({ sourcePath: realFilePath, destinationPath: filePath });\n        }\n      }\n    },\n    { concurrency: MAX_CONCURRENCY }\n  );\n}\n\nfunction showUsage(terminal: Terminal): void {\n  terminal.writeLine('Usage:');\n  terminal.writeLine(`  node create-links.js ${CREATE_ACTION_NAME} [${REALIZE_FILES_OPTION_NAME}]`);\n  terminal.writeLine(`  node create-links.js ${REMOVE_ACTION_NAME}`);\n  terminal.writeLine('');\n  terminal.writeLine('Creates or removes the symlinks for the output folder created by \"rush deploy\".');\n  terminal.writeLine('The link information is read from \"extractor-metadata.json\" in the same folder.');\n}\n\nasync function runAsync(terminal: Terminal): Promise<boolean> {\n  // Example: [ \"node.exe\", \"create-links.js\", \"\"create\" ]\n  const args: string[] = process.argv.slice(2);\n  if (\n    (args[0] !== CREATE_ACTION_NAME && args[0] !== REMOVE_ACTION_NAME) ||\n    (args[0] === CREATE_ACTION_NAME && args[1] && args[1] !== REALIZE_FILES_OPTION_NAME) ||\n    (args[0] === REMOVE_ACTION_NAME && args[1])\n  ) {\n    showUsage(terminal);\n    return false;\n  }\n\n  const extractorMetadataPath: string = `${__dirname}/extractor-metadata.json`;\n  if (!fs.existsSync(extractorMetadataPath)) {\n    throw new Error('Input file not found: ' + extractorMetadataPath);\n  }\n\n  const extractorMetadataJson: string = fs.readFileSync(extractorMetadataPath).toString();\n  const extractorMetadataObject: IExtractorMetadataJson = JSON.parse(extractorMetadataJson);\n\n  if (args[0] === 'create') {\n    const realizeFiles: boolean = args[1] === '--realize-files';\n    terminal.writeLine(`Creating links for extraction at path \"${TARGET_ROOT_FOLDER}\"`);\n    await removeLinksAsync(terminal, TARGET_ROOT_FOLDER, extractorMetadataObject);\n    await createLinksAsync(terminal, TARGET_ROOT_FOLDER, extractorMetadataObject);\n    if (realizeFiles) {\n      await realizeFilesAsync(terminal, TARGET_ROOT_FOLDER, extractorMetadataObject);\n    }\n  } else if (args[0] === 'remove') {\n    terminal.writeLine(`Removing links for extraction at path \"${TARGET_ROOT_FOLDER}\"`);\n    await removeLinksAsync(terminal, TARGET_ROOT_FOLDER, extractorMetadataObject);\n  }\n\n  terminal.writeLine('The operation completed successfully.');\n  return true;\n}\n\nprocess.exitCode = 1;\nconst terminal: Terminal = new Terminal(new ConsoleTerminalProvider());\nrunAsync(terminal)\n  .then((result) => {\n    process.exitCode = result ? 0 : 1;\n  })\n  .catch((error) => {\n    terminal.writeErrorLine('ERROR: ' + error);\n  });\n"]}