@rushstack/package-extractor 0.12.0 → 0.12.1

package/lib-commonjs/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 = void 0;
+exports.removeLinksAsync = removeLinksAsync;
+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 });
+}
+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 onExecuteAsync() {
+        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-commonjs/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;;;;;;AAY3D,4CAcC;AAxBD,0DAA6B;AAE7B,oEAAiE;AAEjE,gEAA+D;AAG/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;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;IAEkB,KAAK,CAAC,cAAc;QACrC,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';\n\nimport { Async, FileSystem } from '@rushstack/node-core-library';\nimport type { ITerminal } from '@rushstack/terminal';\nimport { CommandLineAction } from '@rushstack/ts-command-line';\n\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 override async onExecuteAsync(): 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-commonjs/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-commonjs/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-commonjs/scripts/createLinks/utilities/CreateLinksUtilities.js

@@ -0,0 +1,14 @@
+"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 = getExtractorMetadataAsync;
+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;
+}
+//# sourceMappingURL=CreateLinksUtilities.js.map

package/lib-commonjs/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;;AAO3D,8DAKC;AAVD,oEAA0D;AAG1D,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","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';\n\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-commonjs/scripts/createLinks/utilities/constants.js

@@ -0,0 +1,44 @@
+"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 };
+};
+var _a, _b;
+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 = ((_b = (_a = node_os_1.default.availableParallelism) === null || _a === void 0 ? void 0 : _a.call(node_os_1.default)) !== null && _b !== void 0 ? _b : 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-commonjs/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;AAI7B;;GAEG;AACU,QAAA,eAAe,GAAW,CAAC,MAAA,MAAA,iBAAE,CAAC,oBAAoB,iEAAI,mCAAI,iBAAE,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAE7F;;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';\n\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.availableParallelism?.() ?? 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/lib-dts/ArchiveManager.d.ts

@@ -0,0 +1,13 @@
+import { type FileSystemStats } from '@rushstack/node-core-library';
+export interface IAddToArchiveOptions {
+    filePath?: string;
+    fileData?: Buffer | string;
+    archivePath: string;
+    stats?: FileSystemStats;
+}
+export declare class ArchiveManager {
+    private _zip;
+    addToArchiveAsync(options: IAddToArchiveOptions): Promise<void>;
+    createArchiveAsync(archiveFilePath: string): Promise<void>;
+}
+//# sourceMappingURL=ArchiveManager.d.ts.map

package/lib-dts/ArchiveManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArchiveManager.d.ts","sourceRoot":"","sources":["../src/ArchiveManager.ts"],"names":[],"mappings":"AAKA,OAAO,EAAc,KAAK,eAAe,EAAQ,MAAM,8BAA8B,CAAC;AAUtF,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,eAAe,CAAC;CACzB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,IAAI,CAAsB;IAErB,iBAAiB,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IA+B/D,kBAAkB,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAOxE"}

package/lib-dts/AssetHandler.d.ts

@@ -0,0 +1,52 @@
+import { type FileSystemStats } from '@rushstack/node-core-library';
+import type { IExtractorOptions } from './PackageExtractor';
+import type { SymlinkAnalyzer } from './SymlinkAnalyzer';
+export interface IIncludeAssetOptions {
+    sourceFilePath?: string;
+    sourceFileStats?: FileSystemStats;
+    sourceFileContent?: string | Buffer;
+    targetFilePath: string;
+    ignoreIfExisting?: boolean;
+}
+export interface IIncludeAssetPathOptions extends IIncludeAssetOptions {
+    sourceFilePath: string;
+    sourceFileContent?: never;
+}
+export interface IIncludeExistingAssetPathOptions extends IIncludeAssetOptions {
+    sourceFilePath?: never;
+    sourceFileContent?: never;
+}
+export interface IIncludeAssetContentOptions extends IIncludeAssetOptions {
+    sourceFileContent: string | Buffer;
+    sourceFilePath?: never;
+    sourceFileStats?: never;
+}
+export interface IAssetHandlerOptions extends IExtractorOptions {
+    symlinkAnalyzer: SymlinkAnalyzer;
+}
+export interface IFinalizeOptions {
+    onAfterExtractSymlinksAsync: () => Promise<void>;
+}
+export declare class AssetHandler {
+    private readonly _terminal;
+    private readonly _sourceRootFolder;
+    private readonly _targetRootFolder;
+    private readonly _createArchiveOnly;
+    private readonly _symlinkAnalyzer;
+    private readonly _archiveManager;
+    private readonly _archiveFilePath;
+    private readonly _linkCreationMode;
+    private readonly _includedAssetPaths;
+    private _isFinalized;
+    constructor(options: IAssetHandlerOptions);
+    includeAssetAsync(options: IIncludeAssetPathOptions): Promise<void>;
+    includeAssetAsync(options: IIncludeExistingAssetPathOptions): Promise<void>;
+    includeAssetAsync(options: IIncludeAssetContentOptions): Promise<void>;
+    get assetPaths(): string[];
+    finalizeAsync(options?: IFinalizeOptions): Promise<void>;
+    /**
+     * Create a symlink as described by the ILinkInfo object.
+     */
+    private _extractSymlinkAsync;
+}
+//# sourceMappingURL=AssetHandler.d.ts.map

package/lib-dts/AssetHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AssetHandler.d.ts","sourceRoot":"","sources":["../src/AssetHandler.ts"],"names":[],"mappings":"AAMA,OAAO,EAA2B,KAAK,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAI7F,OAAO,KAAK,EAAE,iBAAiB,EAAoB,MAAM,oBAAoB,CAAC;AAC9E,OAAO,KAAK,EAAa,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGpE,MAAM,WAAW,oBAAoB;IACnC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,iBAAiB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACpC,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,wBAAyB,SAAQ,oBAAoB;IACpE,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,KAAK,CAAC;CAC3B;AAED,MAAM,WAAW,gCAAiC,SAAQ,oBAAoB;IAC5E,cAAc,CAAC,EAAE,KAAK,CAAC;IACvB,iBAAiB,CAAC,EAAE,KAAK,CAAC;CAC3B;AAED,MAAM,WAAW,2BAA4B,SAAQ,oBAAoB;IACvE,iBAAiB,EAAE,MAAM,GAAG,MAAM,CAAC;IACnC,cAAc,CAAC,EAAE,KAAK,CAAC;IACvB,eAAe,CAAC,EAAE,KAAK,CAAC;CACzB;AAED,MAAM,WAAW,oBAAqB,SAAQ,iBAAiB;IAC7D,eAAe,EAAE,eAAe,CAAC;CAClC;AAED,MAAM,WAAW,gBAAgB;IAC/B,2BAA2B,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAClD;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAU;IAC7C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAkB;IACnD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA6B;IAC7D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAqB;IACtD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAmB;IACrD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAkC;IACtE,OAAO,CAAC,YAAY,CAAkB;gBAEnB,OAAO,EAAE,oBAAoB;IA4BnC,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC;IACnE,iBAAiB,CAAC,OAAO,EAAE,gCAAgC,GAAG,OAAO,CAAC,IAAI,CAAC;IAC3E,iBAAiB,CAAC,OAAO,EAAE,2BAA2B,GAAG,OAAO,CAAC,IAAI,CAAC;IAgEnF,IAAW,UAAU,IAAI,MAAM,EAAE,CAEhC;IAEY,aAAa,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBrE;;OAEG;YACW,oBAAoB;CAiDnC"}

package/lib-dts/PackageExtractor.d.ts

@@ -0,0 +1,280 @@
+import { type IPackageJson } from '@rushstack/node-core-library';
+import { type ITerminal } from '@rushstack/terminal';
+import { type ILinkInfo } from './SymlinkAnalyzer';
+declare module 'npm-packlist' {
+    class Walker {
+        readonly result: string[];
+        constructor(opts: {
+            path: string;
+        });
+        on(event: 'done', callback: (result: string[]) => void): Walker;
+        on(event: 'error', callback: (error: Error) => void): Walker;
+        start(): void;
+    }
+}
+export declare const TARGET_ROOT_SCRIPT_RELATIVE_PATH_TEMPLATE_STRING: '{TARGET_ROOT_SCRIPT_RELATIVE_PATH}';
+/**
+ * Part of the extractor-matadata.json file format. Represents an extracted project.
+ *
+ * @public
+ */
+export interface IProjectInfoJson {
+    /**
+     * The name of the project as specified in its package.json file.
+     */
+    projectName: string;
+    /**
+     * This path is relative to the root of the extractor output folder
+     */
+    path: string;
+}
+/**
+ * The extractor-metadata.json file format.
+ *
+ * @public
+ */
+export interface IExtractorMetadataJson {
+    /**
+     * The name of the main project the extraction was performed for.
+     */
+    mainProjectName: string;
+    /**
+     * A list of all projects that were extracted.
+     */
+    projects: IProjectInfoJson[];
+    /**
+     * A list of all links that are part of the extracted project.
+     */
+    links: ILinkInfo[];
+    /**
+     * A list of all files that are part of the extracted project.
+     */
+    files: string[];
+}
+/**
+ * The extractor subspace configurations
+ *
+ * @public
+ */
+export interface IExtractorSubspace {
+    /**
+     * The subspace name
+     */
+    subspaceName: string;
+    /**
+     * The folder where the PNPM "node_modules" folder is located. This is used to resolve packages linked
+     * to the PNPM virtual store.
+     */
+    pnpmInstallFolder?: string;
+    /**
+     * The pnpmfile configuration if using PNPM, otherwise undefined. The configuration will be used to
+     * transform the package.json prior to extraction.
+     */
+    transformPackageJson?: (packageJson: IPackageJson) => IPackageJson;
+}
+/**
+ * The extractor configuration for individual projects.
+ *
+ * @public
+ */
+export interface IExtractorProjectConfiguration {
+    /**
+     * The name of the project.
+     */
+    projectName: string;
+    /**
+     * The absolute path to the project.
+     */
+    projectFolder: string;
+    /**
+     * A list of glob patterns to include when extracting this project. If a path is
+     * matched by both "patternsToInclude" and "patternsToExclude", the path will be
+     * excluded. If undefined, all paths will be included.
+     */
+    patternsToInclude?: string[];
+    /**
+     * A list of glob patterns to exclude when extracting this project. If a path is
+     * matched by both "patternsToInclude" and "patternsToExclude", the path will be
+     * excluded. If undefined, no paths will be excluded.
+     */
+    patternsToExclude?: string[];
+    /**
+     * The names of additional projects to include when extracting this project.
+     */
+    additionalProjectsToInclude?: string[];
+    /**
+     * The names of additional dependencies to include when extracting this project.
+     */
+    additionalDependenciesToInclude?: string[];
+    /**
+     * The names of additional dependencies to exclude when extracting this project.
+     */
+    dependenciesToExclude?: string[];
+}
+/**
+ * The extractor configuration for individual dependencies.
+ *
+ * @public
+ */
+export interface IExtractorDependencyConfiguration {
+    /**
+     * The name of dependency
+     */
+    dependencyName: string;
+    /**
+     * The semver version range of dependency
+     */
+    dependencyVersionRange: string;
+    /**
+     * A list of glob patterns to exclude when extracting this dependency. If a path is
+     * matched by both "patternsToInclude" and "patternsToExclude", the path will be
+     * excluded. If undefined, no paths will be excluded.
+     */
+    patternsToExclude?: string[];
+    /**
+     * A list of glob patterns to include when extracting this dependency. If a path is
+     * matched by both "patternsToInclude" and "patternsToExclude", the path will be
+     * excluded. If undefined, all paths will be included.
+     */
+    patternsToInclude?: string[];
+}
+/**
+ * The mode to use for link creation.
+ *
+ * @public
+ */
+export type LinkCreationMode = 'default' | 'script' | 'none';
+/**
+ * Options that can be provided to the extractor.
+ *
+ * @public
+ */
+export interface IExtractorOptions {
+    /**
+     * A terminal to log extraction progress.
+     */
+    terminal: ITerminal;
+    /**
+     * The main project to include in the extraction operation.
+     */
+    mainProjectName: string;
+    /**
+     * The source folder that copying originates from.  Generally it is the repo root folder.
+     */
+    sourceRootFolder: string;
+    /**
+     * The target folder for the extraction.
+     */
+    targetRootFolder: string;
+    /**
+     * Whether to overwrite the target folder if it already exists.
+     */
+    overwriteExisting: boolean;
+    /**
+     * The desired path to be used when archiving the target folder. Supported file extensions: .zip.
+     */
+    createArchiveFilePath?: string;
+    /**
+     * Whether to skip copying files to the extraction target directory, and only create an extraction
+     * archive. This is only supported when {@link IExtractorOptions.linkCreation} is 'script' or 'none'.
+     */
+    createArchiveOnly?: boolean;
+    /**
+     * The pnpmfile configuration if using PNPM, otherwise `undefined`. The configuration will be used to
+     * transform the package.json prior to extraction.
+     *
+     * @remarks
+     * When Rush subspaces are enabled, this setting applies to `default` subspace only.  To configure
+     * each subspace, use the {@link IExtractorOptions.subspaces} array instead.  The two approaches
+     * cannot be combined.
+     */
+    transformPackageJson?: (packageJson: IPackageJson) => IPackageJson;
+    /**
+     * If dependencies from the "devDependencies" package.json field should be included in the extraction.
+     */
+    includeDevDependencies?: boolean;
+    /**
+     * If files ignored by the .npmignore file should be included in the extraction.
+     */
+    includeNpmIgnoreFiles?: boolean;
+    /**
+     * The folder where the PNPM "node_modules" folder is located. This is used to resolve packages linked
+     * to the PNPM virtual store.
+     *
+     * @remarks
+     * When Rush subspaces are enabled, this setting applies to `default` subspace only.  To configure
+     * each subspace, use the {@link IExtractorOptions.subspaces} array instead.  The two approaches
+     * cannot be combined.
+     */
+    pnpmInstallFolder?: string;
+    /**
+     * The link creation mode to use.
+     * "default": Create the links while copying the files; this is the default behavior. Use this setting
+     * if your file copy tool can handle links correctly.
+     * "script": A Node.js script called create-links.js will be written to the target folder. Use this setting
+     * to create links on the server machine, after the files have been uploaded.
+     * "none": Do nothing; some other tool may create the links later, based on the extractor-metadata.json file.
+     */
+    linkCreation?: LinkCreationMode;
+    /**
+     * The path to the generated link creation script. This is only used when {@link IExtractorOptions.linkCreation}
+     * is 'script'.
+     */
+    linkCreationScriptPath?: string;
+    /**
+     * An additional folder containing files which will be copied into the root of the extraction.
+     */
+    folderToCopy?: string;
+    /**
+     * Configurations for individual projects, keyed by the project path relative to the sourceRootFolder.
+     */
+    projectConfigurations: IExtractorProjectConfiguration[];
+    /**
+     * Configurations for individual dependencies.
+     */
+    dependencyConfigurations?: IExtractorDependencyConfiguration[];
+    /**
+     * When using Rush subspaces, this setting can be used to provide configuration information for each
+     * individual subspace.
+     *
+     * @remarks
+     * To avoid confusion, if this setting is used, then the {@link IExtractorOptions.transformPackageJson} and
+     * {@link IExtractorOptions.pnpmInstallFolder} settings must not be used.
+     */
+    subspaces?: IExtractorSubspace[];
+}
+/**
+ * Manages the business logic for the "rush deploy" command.
+ *
+ * @public
+ */
+export declare class PackageExtractor {
+    /**
+     * Get a list of files that would be included in a package created from the provided package root path.
+     *
+     * @beta
+     */
+    static getPackageIncludedFilesAsync(packageRootPath: string): Promise<string[]>;
+    /**
+     * Extract a package using the provided options
+     */
+    extractAsync(options: IExtractorOptions): Promise<void>;
+    private static _normalizeOptions;
+    private _performExtractionAsync;
+    /**
+     * Recursively crawl the node_modules dependencies and collect the result in IExtractorState.foldersToCopy.
+     */
+    private _collectFoldersAsync;
+    private _applyDependencyFilters;
+    /**
+     * Copy one package folder to the extractor target folder.
+     */
+    private _extractFolderAsync;
+    /**
+     * Write the common/deploy/deploy-metadata.json file.
+     */
+    private _writeExtractorMetadataAsync;
+    private _makeBinLinksAsync;
+    private _writeCreateLinksScriptAsync;
+}
+//# sourceMappingURL=PackageExtractor.d.ts.map

package/lib-dts/PackageExtractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PackageExtractor.d.ts","sourceRoot":"","sources":["../src/PackageExtractor.ts"],"names":[],"mappings":"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"}

package/lib-dts/PathConstants.d.ts

@@ -0,0 +1,4 @@
+export declare const CREATE_LINKS_SCRIPT_FILENAME: 'create-links.js';
+export declare const EXTRACTOR_METADATA_FILENAME: 'extractor-metadata.json';
+export declare const SCRIPTS_FOLDER_PATH: string;
+//# sourceMappingURL=PathConstants.d.ts.map

package/lib-dts/PathConstants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PathConstants.d.ts","sourceRoot":"","sources":["../src/PathConstants.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,4BAA4B,EAAE,iBAAqC,CAAC;AAEjF,eAAO,MAAM,2BAA2B,EAAE,yBAAqD,CAAC;AAGhG,eAAO,MAAM,mBAAmB,EAAE,MAAyD,CAAC"}

package/lib-dts/SymlinkAnalyzer.d.ts

@@ -0,0 +1,73 @@
+import { type FileSystemStats } from '@rushstack/node-core-library';
+export interface IPathNodeBase {
+    kind: 'file' | 'folder' | 'link';
+    nodePath: string;
+    linkStats: FileSystemStats;
+}
+/**
+ * Represents a file object analyzed by {@link SymlinkAnalyzer}.
+ */
+export interface IFileNode extends IPathNodeBase {
+    kind: 'file';
+}
+/**
+ * Represents a folder object analyzed by {@link SymlinkAnalyzer}.
+ */
+export interface IFolderNode extends IPathNodeBase {
+    kind: 'folder';
+}
+/**
+ * Represents a symbolic link analyzed by {@link SymlinkAnalyzer}.
+ */
+export interface ILinkNode extends IPathNodeBase {
+    kind: 'link';
+    /**
+     * The immediate target that the symlink resolves to.
+     */
+    linkTarget: string;
+}
+export type PathNode = IFileNode | IFolderNode | ILinkNode;
+/**
+ * Represents a symbolic link.
+ *
+ * @public
+ */
+export interface ILinkInfo {
+    /**
+     * The type of link that was encountered.
+     */
+    kind: 'fileLink' | 'folderLink';
+    /**
+     * The path to the link, relative to the root of the extractor output folder.
+     */
+    linkPath: string;
+    /**
+     * The target that the link points to.
+     */
+    targetPath: string;
+}
+export interface ISymlinkAnalyzerOptions {
+    requiredSourceParentPath?: string;
+}
+export interface IAnalyzePathOptions {
+    inputPath: string;
+    preserveLinks?: boolean;
+    shouldIgnoreExternalLink?: (path: string) => boolean;
+}
+export declare class SymlinkAnalyzer {
+    private readonly _requiredSourceParentPath;
+    private readonly _nodesByPath;
+    private readonly _linkInfosByPath;
+    constructor(options?: ISymlinkAnalyzerOptions);
+    analyzePathAsync(options: IAnalyzePathOptions & {
+        shouldIgnoreExternalLink: (path: string) => boolean;
+    }): Promise<PathNode | undefined>;
+    analyzePathAsync(options: IAnalyzePathOptions & {
+        shouldIgnoreExternalLink?: never;
+    }): Promise<PathNode>;
+    /**
+     * Returns a summary of all the symbolic links encountered by {@link SymlinkAnalyzer.analyzePathAsync}.
+     */
+    reportSymlinks(): ILinkInfo[];
+}
+//# sourceMappingURL=SymlinkAnalyzer.d.ts.map

package/lib-dts/SymlinkAnalyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SymlinkAnalyzer.d.ts","sourceRoot":"","sources":["../src/SymlinkAnalyzer.ts"],"names":[],"mappings":"AAKA,OAAO,EAAc,KAAK,eAAe,EAAQ,MAAM,8BAA8B,CAAC;AAEtF,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,eAAe,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,SAAU,SAAQ,aAAa;IAC9C,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,WAAY,SAAQ,aAAa;IAChD,IAAI,EAAE,QAAQ,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,SAAU,SAAQ,aAAa;IAC9C,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CAAC;AAE3D;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB;;OAEG;IACH,IAAI,EAAE,UAAU,GAAG,YAAY,CAAC;IAEhC;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,wBAAwB,CAAC,EAAE,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,wBAAwB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;CACtD;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAAqB;IAG/D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAsD;IAGnF,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAwD;gBAEtE,OAAO,GAAE,uBAA4B;IAI3C,gBAAgB,CAC3B,OAAO,EAAE,mBAAmB,GAAG;QAAE,wBAAwB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAA;KAAE,GACrF,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC;IACnB,gBAAgB,CAC3B,OAAO,EAAE,mBAAmB,GAAG;QAAE,wBAAwB,CAAC,EAAE,KAAK,CAAA;KAAE,GAClE,OAAO,CAAC,QAAQ,CAAC;IAoHpB;;OAEG;IACI,cAAc,IAAI,SAAS,EAAE;CAKrC"}

package/lib-dts/Utils.d.ts

@@ -0,0 +1,30 @@
+import { type ITerminal } from '@rushstack/terminal';
+export declare function matchesWithStar(patternWithStar: string, input: string): boolean;
+export interface IRemapPathForTargetFolder {
+    sourcePath: string;
+    sourceRootFolder: string;
+    targetRootFolder: string;
+}
+/**
+ * Maps a file path under the provided {@link IRemapPathForTargetFolder.sourceRootFolder} to the provided
+ * {@link IExtractorOptions.targetRootFolder}.
+ *
+ * Example input: "C:\\MyRepo\\libraries\\my-lib"
+ * Example output: "C:\\MyRepo\\common\\deploy\\libraries\\my-lib"
+ */
+export declare function remapSourcePathForTargetFolder(options: IRemapPathForTargetFolder): string;
+/**
+ * Maps a file path under the provided folder path to the expected path format for the extractor metadata.
+ *
+ * Example input: "C:\\MyRepo\\libraries\\my-lib"
+ * Example output: "common/deploy/libraries/my-lib"
+ */
+export declare function remapPathForExtractorMetadata(folderPath: string, filePath: string): string;
+/**
+ * Creates the .bin files for the extracted projects and returns the paths to the created .bin files.
+ *
+ * @param terminal - The terminal to write to
+ * @param extractedProjectFolderPaths - The paths to the extracted projects
+ */
+export declare function makeBinLinksAsync(terminal: ITerminal, extractedProjectFolderPaths: string[]): Promise<string[]>;
+//# sourceMappingURL=Utils.d.ts.map

package/lib-dts/Utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Utils.d.ts","sourceRoot":"","sources":["../src/Utils.ts"],"names":[],"mappings":"AAQA,OAAO,EAAY,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAI/D,wBAAgB,eAAe,CAAC,eAAe,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAY/E;AAED,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,yBAAyB,GAAG,MAAM,CAQzF;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAM1F;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,SAAS,EACnB,2BAA2B,EAAE,MAAM,EAAE,GACpC,OAAO,CAAC,MAAM,EAAE,CAAC,CAiCnB"}

package/lib-dts/index.d.ts

@@ -0,0 +1,3 @@
+export { PackageExtractor, type LinkCreationMode, type IExtractorOptions, type IExtractorProjectConfiguration, type IExtractorDependencyConfiguration, type IExtractorMetadataJson, type IProjectInfoJson, type IExtractorSubspace } from './PackageExtractor';
+export type { ILinkInfo } from './SymlinkAnalyzer';
+//# sourceMappingURL=index.d.ts.map

package/lib-dts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,gBAAgB,EAChB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,8BAA8B,EACnC,KAAK,iCAAiC,EACtC,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACxB,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC"}

package/lib-dts/scripts/createLinks/cli/CreateLinksCommandLineParser.d.ts

@@ -0,0 +1,8 @@
+import { CommandLineParser } from '@rushstack/ts-command-line';
+import type { ITerminal } from '@rushstack/terminal';
+export declare class CreateLinksCommandLineParser extends CommandLineParser {
+    private readonly _terminal;
+    constructor(terminal: ITerminal);
+    protected onExecuteAsync(): Promise<void>;
+}
+//# sourceMappingURL=CreateLinksCommandLineParser.d.ts.map

package/lib-dts/scripts/createLinks/cli/CreateLinksCommandLineParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CreateLinksCommandLineParser.d.ts","sourceRoot":"","sources":["../../../../src/scripts/createLinks/cli/CreateLinksCommandLineParser.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAE/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAKrD,qBAAa,4BAA6B,SAAQ,iBAAiB;IACjE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;gBAEnB,QAAQ,EAAE,SAAS;cAYb,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;CAazD"}