just-scripts 1.8.2 → 2.0.0

package/CHANGELOG.json

@@ -2,7 +2,22 @@
   "name": "just-scripts",
   "entries": [
     {
-      "date": "Tue, 05 Apr 2022 20:55:40 GMT",
+      "date": "Mon, 16 May 2022 20:50:31 GMT",
+      "tag": "just-scripts_v2.0.0",
+      "version": "2.0.0",
+      "comments": {
+        "major": [
+          {
+            "author": "benw@microsoft.com",
+            "package": "just-scripts",
+            "comment": "Add support for symlink creation in the copy task",
+            "commit": "02e45b2c092548c4ac43e142aaa510a7ad95ec49"
+          }
+        ]
+      }
+    },
+    {
+      "date": "Tue, 05 Apr 2022 20:55:43 GMT",
       "tag": "just-scripts_v1.8.2",
       "version": "1.8.2",
       "comments": {

package/CHANGELOG.md

@@ -1,12 +1,20 @@
 # Change Log - just-scripts
 
-This log was last generated on Tue, 05 Apr 2022 20:55:40 GMT and should not be manually modified.
+This log was last generated on Mon, 16 May 2022 20:50:31 GMT and should not be manually modified.
 
 <!-- Start content -->
 
+## 2.0.0
+
+Mon, 16 May 2022 20:50:31 GMT
+
+### Major changes
+
+- Add support for symlink creation in the copy task (benw@microsoft.com)
+
 ## 1.8.2
 
-Tue, 05 Apr 2022 20:55:40 GMT
+Tue, 05 Apr 2022 20:55:43 GMT
 
 ### Patches
 

package/lib/copy/CopyInstruction.d.ts

@@ -8,6 +8,12 @@ export interface CopyInstruction {
      * The path+filename of the destination file.
      */
     destinationFilePath: string;
+    /**
+     * Set to true if a copy or merge should be performed, false if a symlink should be created.
+     * If multiple source files are specified (i.e. a merge), this must be true or undefined.
+     * The default value of undefined is equivalent to true for a merge, false in all other cases.
+     */
+    noSymlink?: boolean;
 }
 export interface CopyConfig {
     copyInstructions: CopyInstruction[];
@@ -17,13 +23,13 @@ export interface CopyConfig {
  * For example copyFilesToDestinationDirectory(['some/path/foo.js', 'bar.js'], 'dest/target') would result in the creation of
  * files 'dest/target/foo.js' and 'dest/target/bar.js'.
  */
-export declare function copyFilesToDestinationDirectory(sourceFilePaths: string | string[], destinationDirectory: string): CopyInstruction[];
+export declare function copyFilesToDestinationDirectory(sourceFilePaths: string | string[], destinationDirectory: string, noSymlinks?: boolean): CopyInstruction[];
 /**
  * Copies a file into a destination directory with a different name.
  * For example copyFileToDestinationDirectoryWithRename('some/path/foo.js', 'bar.js', 'dest/target') would result in the creation of
  * the file 'dest/target/bar.js'.
  */
-export declare function copyFileToDestinationDirectoryWithRename(sourceFilePath: string, destinationName: string, destinationDirectory: string): CopyInstruction[];
+export declare function copyFileToDestinationDirectoryWithRename(sourceFilePath: string, destinationName: string, destinationDirectory: string, noSymlink?: boolean): CopyInstruction[];
 /**
  * Copies files into a destination directory with different names.
  * For example copyFilesToDestinationDirectoryWithRename([{sourceFilePath:'some/path/foo.js', destinationName:'bar.js'}], 'dest/target')
@@ -32,12 +38,12 @@ export declare function copyFileToDestinationDirectoryWithRename(sourceFilePath:
 export declare function copyFilesToDestinationDirectoryWithRename(instrs: {
     sourceFilePath: string;
     destinationName: string;
-}[], destinationDirectory: string): CopyInstruction[];
+}[], destinationDirectory: string, noSymlinks?: boolean): CopyInstruction[];
 /**
  * Copies all the files in a directory to the output folder.
  * You can optionally provide a filter function that determines which files to copy.
  */
-export declare function copyFilesInDirectory(sourceDirectoryPath: string, outputDirectoryPath: string, filterFunction?: (file: string) => boolean): CopyInstruction[];
+export declare function copyFilesInDirectory(sourceDirectoryPath: string, outputDirectoryPath: string, filterFunction?: (file: string) => boolean, noSymlinks?: boolean): CopyInstruction[];
 /**
  * Merges the contents of multiple files and places them in the output folder.
  * This should only be used for text files and it should not be used for JavaScript

package/lib/copy/CopyInstruction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CopyInstruction.d.ts","sourceRoot":"","sources":["../../src/copy/CopyInstruction.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,cAAc,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAElC;;OAEG;IACH,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,UAAU;IACzB,gBAAgB,EAAE,eAAe,EAAE,CAAC;CACrC;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,oBAAoB,EAAE,MAAM,GAAG,eAAe,EAAE,CAKnI;AAED;;;;GAIG;AACH,wBAAgB,wCAAwC,CACtD,cAAc,EAAE,MAAM,EACtB,eAAe,EAAE,MAAM,EACvB,oBAAoB,EAAE,MAAM,GAC3B,eAAe,EAAE,CAEnB;AAED;;;;GAIG;AACH,wBAAgB,yCAAyC,CACvD,MAAM,EAAE;IAAE,cAAc,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,EAAE,EAC7D,oBAAoB,EAAE,MAAM,GAC3B,eAAe,EAAE,CAKnB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,mBAAmB,EAAE,MAAM,EAC3B,mBAAmB,EAAE,MAAM,EAC3B,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,GACzC,eAAe,EAAE,CAUnB;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,eAAe,EAAE,MAAM,EAAE,EAAE,mBAAmB,EAAE,MAAM,GAAG,eAAe,CAKlG"}
+{"version":3,"file":"CopyInstruction.d.ts","sourceRoot":"","sources":["../../src/copy/CopyInstruction.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,cAAc,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAElC;;OAEG;IACH,mBAAmB,EAAE,MAAM,CAAC;IAE5B;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,gBAAgB,EAAE,eAAe,EAAE,CAAC;CACrC;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAC7C,eAAe,EAAE,MAAM,GAAG,MAAM,EAAE,EAClC,oBAAoB,EAAE,MAAM,EAC5B,UAAU,CAAC,EAAE,OAAO,GACnB,eAAe,EAAE,CAMnB;AAED;;;;GAIG;AACH,wBAAgB,wCAAwC,CACtD,cAAc,EAAE,MAAM,EACtB,eAAe,EAAE,MAAM,EACvB,oBAAoB,EAAE,MAAM,EAC5B,SAAS,CAAC,EAAE,OAAO,GAClB,eAAe,EAAE,CAEnB;AAED;;;;GAIG;AACH,wBAAgB,yCAAyC,CACvD,MAAM,EAAE;IAAE,cAAc,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,EAAE,EAC7D,oBAAoB,EAAE,MAAM,EAC5B,UAAU,CAAC,EAAE,OAAO,GACnB,eAAe,EAAE,CAMnB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,mBAAmB,EAAE,MAAM,EAC3B,mBAAmB,EAAE,MAAM,EAC3B,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,EAC1C,UAAU,CAAC,EAAE,OAAO,GACnB,eAAe,EAAE,CAWnB;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,eAAe,EAAE,MAAM,EAAE,EAAE,mBAAmB,EAAE,MAAM,GAAG,eAAe,CAKlG"}

package/lib/copy/CopyInstruction.js

@@ -9,10 +9,11 @@ const arrayify_1 = require("../arrayUtils/arrayify");
  * For example copyFilesToDestinationDirectory(['some/path/foo.js', 'bar.js'], 'dest/target') would result in the creation of
  * files 'dest/target/foo.js' and 'dest/target/bar.js'.
  */
-function copyFilesToDestinationDirectory(sourceFilePaths, destinationDirectory) {
+function copyFilesToDestinationDirectory(sourceFilePaths, destinationDirectory, noSymlinks) {
     return arrayify_1.arrayify(sourceFilePaths).map(sourceName => ({
         sourceFilePath: path_1.normalize(sourceName),
         destinationFilePath: path_1.join(destinationDirectory, path_1.basename(sourceName)),
+        noSymlink: noSymlinks,
     }));
 }
 exports.copyFilesToDestinationDirectory = copyFilesToDestinationDirectory;
@@ -21,8 +22,8 @@ exports.copyFilesToDestinationDirectory = copyFilesToDestinationDirectory;
  * For example copyFileToDestinationDirectoryWithRename('some/path/foo.js', 'bar.js', 'dest/target') would result in the creation of
  * the file 'dest/target/bar.js'.
  */
-function copyFileToDestinationDirectoryWithRename(sourceFilePath, destinationName, destinationDirectory) {
-    return [{ sourceFilePath, destinationFilePath: path_1.join(destinationDirectory, destinationName) }];
+function copyFileToDestinationDirectoryWithRename(sourceFilePath, destinationName, destinationDirectory, noSymlink) {
+    return [{ sourceFilePath, destinationFilePath: path_1.join(destinationDirectory, destinationName), noSymlink }];
 }
 exports.copyFileToDestinationDirectoryWithRename = copyFileToDestinationDirectoryWithRename;
 /**
@@ -30,10 +31,11 @@ exports.copyFileToDestinationDirectoryWithRename = copyFileToDestinationDirector
  * For example copyFilesToDestinationDirectoryWithRename([{sourceFilePath:'some/path/foo.js', destinationName:'bar.js'}], 'dest/target')
  * would result in the creation of the file 'dest/target/bar.js'.
  */
-function copyFilesToDestinationDirectoryWithRename(instrs, destinationDirectory) {
+function copyFilesToDestinationDirectoryWithRename(instrs, destinationDirectory, noSymlinks) {
     return instrs.map(instr => ({
         sourceFilePath: instr.sourceFilePath,
         destinationFilePath: path_1.join(destinationDirectory, instr.destinationName),
+        noSymlink: noSymlinks,
     }));
 }
 exports.copyFilesToDestinationDirectoryWithRename = copyFilesToDestinationDirectoryWithRename;
@@ -41,7 +43,7 @@ exports.copyFilesToDestinationDirectoryWithRename = copyFilesToDestinationDirect
  * Copies all the files in a directory to the output folder.
  * You can optionally provide a filter function that determines which files to copy.
  */
-function copyFilesInDirectory(sourceDirectoryPath, outputDirectoryPath, filterFunction) {
+function copyFilesInDirectory(sourceDirectoryPath, outputDirectoryPath, filterFunction, noSymlinks) {
     let files = fs_1.readdirSync(sourceDirectoryPath);
     if (filterFunction) {
         files = files.filter(filterFunction);
@@ -49,6 +51,7 @@ function copyFilesInDirectory(sourceDirectoryPath, outputDirectoryPath, filterFu
     return files.map(file => ({
         sourceFilePath: path_1.join(sourceDirectoryPath, file),
         destinationFilePath: path_1.join(outputDirectoryPath, file),
+        noSymlink: noSymlinks,
     }));
 }
 exports.copyFilesInDirectory = copyFilesInDirectory;

package/lib/copy/CopyInstruction.js.map

@@ -1 +1 @@
-{"version":3,"file":"CopyInstruction.js","sourceRoot":"","sources":["../../src/copy/CopyInstruction.ts"],"names":[],"mappings":";;;AAAA,+BAAiD;AACjD,2BAAiC;AACjC,qDAAkD;AAmBlD;;;;GAIG;AACH,SAAgB,+BAA+B,CAAC,eAAkC,EAAE,oBAA4B;IAC9G,OAAO,mBAAQ,CAAC,eAAe,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QAClD,cAAc,EAAE,gBAAS,CAAC,UAAU,CAAC;QACrC,mBAAmB,EAAE,WAAI,CAAC,oBAAoB,EAAE,eAAQ,CAAC,UAAU,CAAC,CAAC;KACtE,CAAC,CAAC,CAAC;AACN,CAAC;AALD,0EAKC;AAED;;;;GAIG;AACH,SAAgB,wCAAwC,CACtD,cAAsB,EACtB,eAAuB,EACvB,oBAA4B;IAE5B,OAAO,CAAC,EAAE,cAAc,EAAE,mBAAmB,EAAE,WAAI,CAAC,oBAAoB,EAAE,eAAe,CAAC,EAAE,CAAC,CAAC;AAChG,CAAC;AAND,4FAMC;AAED;;;;GAIG;AACH,SAAgB,yCAAyC,CACvD,MAA6D,EAC7D,oBAA4B;IAE5B,OAAO,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC1B,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,mBAAmB,EAAE,WAAI,CAAC,oBAAoB,EAAE,KAAK,CAAC,eAAe,CAAC;KACvE,CAAC,CAAC,CAAC;AACN,CAAC;AARD,8FAQC;AAED;;;GAGG;AACH,SAAgB,oBAAoB,CAClC,mBAA2B,EAC3B,mBAA2B,EAC3B,cAA0C;IAE1C,IAAI,KAAK,GAAG,gBAAW,CAAC,mBAAmB,CAAC,CAAC;IAE7C,IAAI,cAAc,EAAE;QAClB,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;KACtC;IACD,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACxB,cAAc,EAAE,WAAI,CAAC,mBAAmB,EAAE,IAAI,CAAC;QAC/C,mBAAmB,EAAE,WAAI,CAAC,mBAAmB,EAAE,IAAI,CAAC;KACrD,CAAC,CAAC,CAAC;AACN,CAAC;AAdD,oDAcC;AAED;;;;GAIG;AACH,SAAgB,UAAU,CAAC,eAAyB,EAAE,mBAA2B;IAC/E,OAAO;QACL,cAAc,EAAE,eAAe;QAC/B,mBAAmB;KACpB,CAAC;AACJ,CAAC;AALD,gCAKC"}
+{"version":3,"file":"CopyInstruction.js","sourceRoot":"","sources":["../../src/copy/CopyInstruction.ts"],"names":[],"mappings":";;;AAAA,+BAAiD;AACjD,2BAAiC;AACjC,qDAAkD;AA0BlD;;;;GAIG;AACH,SAAgB,+BAA+B,CAC7C,eAAkC,EAClC,oBAA4B,EAC5B,UAAoB;IAEpB,OAAO,mBAAQ,CAAC,eAAe,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QAClD,cAAc,EAAE,gBAAS,CAAC,UAAU,CAAC;QACrC,mBAAmB,EAAE,WAAI,CAAC,oBAAoB,EAAE,eAAQ,CAAC,UAAU,CAAC,CAAC;QACrE,SAAS,EAAE,UAAU;KACtB,CAAC,CAAC,CAAC;AACN,CAAC;AAVD,0EAUC;AAED;;;;GAIG;AACH,SAAgB,wCAAwC,CACtD,cAAsB,EACtB,eAAuB,EACvB,oBAA4B,EAC5B,SAAmB;IAEnB,OAAO,CAAC,EAAE,cAAc,EAAE,mBAAmB,EAAE,WAAI,CAAC,oBAAoB,EAAE,eAAe,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;AAC3G,CAAC;AAPD,4FAOC;AAED;;;;GAIG;AACH,SAAgB,yCAAyC,CACvD,MAA6D,EAC7D,oBAA4B,EAC5B,UAAoB;IAEpB,OAAO,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC1B,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,mBAAmB,EAAE,WAAI,CAAC,oBAAoB,EAAE,KAAK,CAAC,eAAe,CAAC;QACtE,SAAS,EAAE,UAAU;KACtB,CAAC,CAAC,CAAC;AACN,CAAC;AAVD,8FAUC;AAED;;;GAGG;AACH,SAAgB,oBAAoB,CAClC,mBAA2B,EAC3B,mBAA2B,EAC3B,cAA0C,EAC1C,UAAoB;IAEpB,IAAI,KAAK,GAAG,gBAAW,CAAC,mBAAmB,CAAC,CAAC;IAE7C,IAAI,cAAc,EAAE;QAClB,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;KACtC;IACD,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACxB,cAAc,EAAE,WAAI,CAAC,mBAAmB,EAAE,IAAI,CAAC;QAC/C,mBAAmB,EAAE,WAAI,CAAC,mBAAmB,EAAE,IAAI,CAAC;QACpD,SAAS,EAAE,UAAU;KACtB,CAAC,CAAC,CAAC;AACN,CAAC;AAhBD,oDAgBC;AAED;;;;GAIG;AACH,SAAgB,UAAU,CAAC,eAAyB,EAAE,mBAA2B;IAC/E,OAAO;QACL,cAAc,EAAE,eAAe;QAC/B,mBAAmB;KACpB,CAAC;AACJ,CAAC;AALD,gCAKC"}

package/lib/copy/executeCopyInstructions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"executeCopyInstructions.d.ts","sourceRoot":"","sources":["../../src/copy/executeCopyInstructions.ts"],"names":[],"mappings":"AAEA,OAAO,EAAmB,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAIhE;;GAEG;AACH,wBAAsB,uBAAuB,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAK3F"}
+{"version":3,"file":"executeCopyInstructions.d.ts","sourceRoot":"","sources":["../../src/copy/executeCopyInstructions.ts"],"names":[],"mappings":"AAEA,OAAO,EAAmB,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAIhE;;GAEG;AACH,wBAAsB,uBAAuB,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAM3F"}

package/lib/copy/executeCopyInstructions.js

@@ -10,19 +10,32 @@ const uniqueValues_1 = require("../arrayUtils/uniqueValues");
  */
 async function executeCopyInstructions(config) {
     if (config && config.copyInstructions) {
+        validateConfig(config.copyInstructions);
         await createDirectories(config.copyInstructions);
         await Promise.all(config.copyInstructions.map(executeSingleCopyInstruction));
     }
 }
 exports.executeCopyInstructions = executeCopyInstructions;
+function validateConfig(copyInstructions) {
+    copyInstructions.forEach(instr => {
+        if (instr.noSymlink === false && Array.isArray(instr.sourceFilePath) && instr.sourceFilePath.length > 1) {
+            throw new Error('Multiple source files cannot be specified when making a symlink');
+        }
+    });
+}
 function createDirectories(copyInstructions) {
     return Promise.all(uniqueValues_1.uniqueValues(copyInstructions.map(instruction => path_1.dirname(instruction.destinationFilePath))).map(dirname => fs_extra_1.ensureDir(dirname)));
 }
 function executeSingleCopyInstruction(copyInstruction) {
     const sourceFileNames = arrayify_1.arrayify(copyInstruction.sourceFilePath);
-    // source and dest are 1-to-1?  perform binary copy.
+    // source and dest are 1-to-1?  perform binary copy or symlink as desired.
     if (sourceFileNames.length === 1) {
-        return fs_extra_1.copy(sourceFileNames[0], copyInstruction.destinationFilePath);
+        if (copyInstruction.noSymlink) {
+            return fs_extra_1.copy(sourceFileNames[0], copyInstruction.destinationFilePath);
+        }
+        else {
+            return fs_extra_1.ensureSymlink(path_1.resolve(sourceFileNames[0]), copyInstruction.destinationFilePath);
+        }
     }
     // perform text merge operation.
     return Promise.all(sourceFileNames.map(fileName => fs_extra_1.readFile(fileName))).then(fileContents => {

package/lib/copy/executeCopyInstructions.js.map

@@ -1 +1 @@
-{"version":3,"file":"executeCopyInstructions.js","sourceRoot":"","sources":["../../src/copy/executeCopyInstructions.ts"],"names":[],"mappings":";;;AAAA,+BAA+B;AAC/B,uCAAgE;AAEhE,qDAAkD;AAClD,6DAA0D;AAE1D;;GAEG;AACI,KAAK,UAAU,uBAAuB,CAAC,MAA8B;IAC1E,IAAI,MAAM,IAAI,MAAM,CAAC,gBAAgB,EAAE;QACrC,MAAM,iBAAiB,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;QACjD,MAAM,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC,CAAC;KAC9E;AACH,CAAC;AALD,0DAKC;AAED,SAAS,iBAAiB,CAAC,gBAAmC;IAC5D,OAAO,OAAO,CAAC,GAAG,CAChB,2BAAY,CAAC,gBAAgB,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC,cAAO,CAAC,WAAW,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,oBAAS,CAAC,OAAO,CAAC,CAAC,CAC/H,CAAC;AACJ,CAAC;AAED,SAAS,4BAA4B,CAAC,eAAgC;IACpE,MAAM,eAAe,GAAG,mBAAQ,CAAC,eAAe,CAAC,cAAc,CAAC,CAAC;IAEjE,oDAAoD;IACpD,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE;QAChC,OAAO,eAAI,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,eAAe,CAAC,mBAAmB,CAAC,CAAC;KACtE;IAED,gCAAgC;IAChC,OAAO,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,mBAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE;QAC1F,OAAO,oBAAS,CAAC,eAAe,CAAC,mBAAmB,EAAE,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACjF,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"executeCopyInstructions.js","sourceRoot":"","sources":["../../src/copy/executeCopyInstructions.ts"],"names":[],"mappings":";;;AAAA,+BAAwC;AACxC,uCAA+E;AAE/E,qDAAkD;AAClD,6DAA0D;AAE1D;;GAEG;AACI,KAAK,UAAU,uBAAuB,CAAC,MAA8B;IAC1E,IAAI,MAAM,IAAI,MAAM,CAAC,gBAAgB,EAAE;QACrC,cAAc,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;QACxC,MAAM,iBAAiB,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;QACjD,MAAM,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC,CAAC;KAC9E;AACH,CAAC;AAND,0DAMC;AAED,SAAS,cAAc,CAAC,gBAAmC;IACzD,gBAAgB,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;QAC/B,IAAI,KAAK,CAAC,SAAS,KAAK,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,KAAK,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE;YACvG,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;SACpF;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,iBAAiB,CAAC,gBAAmC;IAC5D,OAAO,OAAO,CAAC,GAAG,CAChB,2BAAY,CAAC,gBAAgB,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC,cAAO,CAAC,WAAW,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,oBAAS,CAAC,OAAO,CAAC,CAAC,CAC/H,CAAC;AACJ,CAAC;AAED,SAAS,4BAA4B,CAAC,eAAgC;IACpE,MAAM,eAAe,GAAG,mBAAQ,CAAC,eAAe,CAAC,cAAc,CAAC,CAAC;IAEjE,0EAA0E;IAC1E,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE;QAChC,IAAI,eAAe,CAAC,SAAS,EAAE;YAC7B,OAAO,eAAI,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,eAAe,CAAC,mBAAmB,CAAC,CAAC;SACtE;aAAM;YACL,OAAO,wBAAa,CAAC,cAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,EAAE,eAAe,CAAC,mBAAmB,CAAC,CAAC;SACxF;KACF;IAED,gCAAgC;IAChC,OAAO,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,mBAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE;QAC1F,OAAO,oBAAS,CAAC,eAAe,CAAC,mBAAmB,EAAE,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACjF,CAAC,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "just-scripts",
-  "version": "1.8.2",
+  "version": "2.0.0",
   "description": "Just Stack Scripts",
   "keywords": [],
   "repository": {

package/src/copy/CopyInstruction.ts

@@ -13,6 +13,13 @@ export interface CopyInstruction {
    * The path+filename of the destination file.
    */
   destinationFilePath: string;
+
+  /**
+   * Set to true if a copy or merge should be performed, false if a symlink should be created.
+   * If multiple source files are specified (i.e. a merge), this must be true or undefined.
+   * The default value of undefined is equivalent to true for a merge, false in all other cases.
+   */
+  noSymlink?: boolean;
 }
 
 export interface CopyConfig {
@@ -24,10 +31,15 @@ export interface CopyConfig {
  * For example copyFilesToDestinationDirectory(['some/path/foo.js', 'bar.js'], 'dest/target') would result in the creation of
  * files 'dest/target/foo.js' and 'dest/target/bar.js'.
  */
-export function copyFilesToDestinationDirectory(sourceFilePaths: string | string[], destinationDirectory: string): CopyInstruction[] {
+export function copyFilesToDestinationDirectory(
+  sourceFilePaths: string | string[],
+  destinationDirectory: string,
+  noSymlinks?: boolean,
+): CopyInstruction[] {
   return arrayify(sourceFilePaths).map(sourceName => ({
     sourceFilePath: normalize(sourceName),
     destinationFilePath: join(destinationDirectory, basename(sourceName)),
+    noSymlink: noSymlinks,
   }));
 }
 
@@ -40,8 +52,9 @@ export function copyFileToDestinationDirectoryWithRename(
   sourceFilePath: string,
   destinationName: string,
   destinationDirectory: string,
+  noSymlink?: boolean,
 ): CopyInstruction[] {
-  return [{ sourceFilePath, destinationFilePath: join(destinationDirectory, destinationName) }];
+  return [{ sourceFilePath, destinationFilePath: join(destinationDirectory, destinationName), noSymlink }];
 }
 
 /**
@@ -52,10 +65,12 @@ export function copyFileToDestinationDirectoryWithRename(
 export function copyFilesToDestinationDirectoryWithRename(
   instrs: { sourceFilePath: string; destinationName: string }[],
   destinationDirectory: string,
+  noSymlinks?: boolean,
 ): CopyInstruction[] {
   return instrs.map(instr => ({
     sourceFilePath: instr.sourceFilePath,
     destinationFilePath: join(destinationDirectory, instr.destinationName),
+    noSymlink: noSymlinks,
   }));
 }
 
@@ -67,6 +82,7 @@ export function copyFilesInDirectory(
   sourceDirectoryPath: string,
   outputDirectoryPath: string,
   filterFunction?: (file: string) => boolean,
+  noSymlinks?: boolean,
 ): CopyInstruction[] {
   let files = readdirSync(sourceDirectoryPath);
 
@@ -76,6 +92,7 @@ export function copyFilesInDirectory(
   return files.map(file => ({
     sourceFilePath: join(sourceDirectoryPath, file),
     destinationFilePath: join(outputDirectoryPath, file),
+    noSymlink: noSymlinks,
   }));
 }
 

package/src/copy/__tests__/executeCopyInstructions.spec.ts

@@ -1,8 +1,9 @@
+import * as mockfs from 'mock-fs';
 import * as path from 'path';
 import * as fs from 'fs';
-import mockfs = require('mock-fs');
 // import { dirSync, fileSync, DirResult, FileResult } from 'tmp';
 import { executeCopyInstructions } from '../executeCopyInstructions';
+import { CopyInstruction } from '../CopyInstruction';
 
 describe('executeCopyInstructions functional tests', () => {
   const sourceDir = 'sourceDir';
@@ -30,8 +31,8 @@ describe('executeCopyInstructions functional tests', () => {
     mockfs.restore();
   });
 
-  it('executes single source copy instructions', async () => {
-    const copyInstruction = {
+  it('executes single source copy instructions (symlink)', async () => {
+    const copyInstruction: CopyInstruction = {
       sourceFilePath: sourceFilePath1,
       destinationFilePath: destFilePath,
     };
@@ -43,13 +44,15 @@ describe('executeCopyInstructions functional tests', () => {
     });
 
     expect(fs.existsSync(destFilePath)).toBeTruthy();
+    expect(fs.lstatSync(destFilePath).isSymbolicLink()).toBeTruthy();
     expect(fs.readFileSync(destFilePath).toString()).toEqual(sourceFileContents1);
   });
 
-  it('executes single source (arrayified) copy instructions', async () => {
-    const copyInstruction = {
+  it('executes single source (arrayified) copy instructions (copy)', async () => {
+    const copyInstruction: CopyInstruction = {
       sourceFilePath: [sourceFilePath1],
       destinationFilePath: destFilePath,
+      noSymlink: true,
     };
 
     expect(fs.existsSync(destFilePath)).toBeFalsy();
@@ -59,11 +62,12 @@ describe('executeCopyInstructions functional tests', () => {
     });
 
     expect(fs.existsSync(destFilePath)).toBeTruthy();
+    expect(fs.lstatSync(destFilePath).isSymbolicLink()).toBeFalsy();
     expect(fs.readFileSync(destFilePath).toString()).toEqual(sourceFileContents1);
   });
 
   it('merges output', async () => {
-    const copyInstruction = {
+    const copyInstruction: CopyInstruction = {
       sourceFilePath: [sourceFilePath1, sourceFilePath2],
       destinationFilePath: destFilePath,
     };
@@ -77,9 +81,24 @@ describe('executeCopyInstructions functional tests', () => {
     });
 
     expect(fs.existsSync(destFilePath)).toBeTruthy();
+    expect(fs.lstatSync(destFilePath).isSymbolicLink()).toBeFalsy();
     expect(fs.readFileSync(destFilePath).toString()).toEqual(expectedOutput);
   });
 
+  it('fails to validate merge + symlink copy instruction', async () => {
+    const copyInstruction: CopyInstruction = {
+      sourceFilePath: [sourceFilePath1, sourceFilePath2],
+      destinationFilePath: destFilePath,
+      noSymlink: false,
+    };
+
+    const promise = executeCopyInstructions({
+      copyInstructions: [copyInstruction],
+    });
+
+    await expect(promise).rejects.toThrow();
+  });
+
   /**
    * TODO:
    * Rationalize and document expected executeCopyInstructions behavior.

package/src/copy/executeCopyInstructions.ts

@@ -1,5 +1,5 @@
-import { dirname } from 'path';
-import { readFile, writeFile, copy, ensureDir } from 'fs-extra';
+import { dirname, resolve } from 'path';
+import { readFile, writeFile, copy, ensureDir, ensureSymlink } from 'fs-extra';
 import { CopyInstruction, CopyConfig } from './CopyInstruction';
 import { arrayify } from '../arrayUtils/arrayify';
 import { uniqueValues } from '../arrayUtils/uniqueValues';
@@ -9,11 +9,20 @@ import { uniqueValues } from '../arrayUtils/uniqueValues';
  */
 export async function executeCopyInstructions(config: CopyConfig | undefined): Promise<void> {
   if (config && config.copyInstructions) {
+    validateConfig(config.copyInstructions);
     await createDirectories(config.copyInstructions);
     await Promise.all(config.copyInstructions.map(executeSingleCopyInstruction));
   }
 }
 
+function validateConfig(copyInstructions: CopyInstruction[]) {
+  copyInstructions.forEach(instr => {
+    if (instr.noSymlink === false && Array.isArray(instr.sourceFilePath) && instr.sourceFilePath.length > 1) {
+      throw new Error('Multiple source files cannot be specified when making a symlink');
+    }
+  });
+}
+
 function createDirectories(copyInstructions: CopyInstruction[]) {
   return Promise.all(
     uniqueValues(copyInstructions.map(instruction => dirname(instruction.destinationFilePath))).map(dirname => ensureDir(dirname)),
@@ -23,9 +32,13 @@ function createDirectories(copyInstructions: CopyInstruction[]) {
 function executeSingleCopyInstruction(copyInstruction: CopyInstruction) {
   const sourceFileNames = arrayify(copyInstruction.sourceFilePath);
 
-  // source and dest are 1-to-1?  perform binary copy.
+  // source and dest are 1-to-1?  perform binary copy or symlink as desired.
   if (sourceFileNames.length === 1) {
-    return copy(sourceFileNames[0], copyInstruction.destinationFilePath);
+    if (copyInstruction.noSymlink) {
+      return copy(sourceFileNames[0], copyInstruction.destinationFilePath);
+    } else {
+      return ensureSymlink(resolve(sourceFileNames[0]), copyInstruction.destinationFilePath);
+    }
   }
 
   // perform text merge operation.