@rapidrest/core 1.14.0 → 2.0.0

package/dist/lib/FileUtils.js

@@ -13,20 +13,56 @@ const logger = Logger();
  */
 export class FileUtils {
     /**
-     * Throws an error if the resolved `target` path is not contained within the resolved `rootDir` directory. Used
-     * to prevent path traversal (e.g. `../`) from escaping an intended root when a caller opts in by providing
-     * `rootDir`.
+     * Determines if the provided path exists on the filesystem.
+     */
+    static async exists(target) {
+        try {
+            await fs.promises.access(target);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Throws an error if `target` is not contained within `rootDir`. Used to prevent path traversal (e.g. `../`)
+     * from escaping an intended root when a caller opts in by providing `rootDir`.
+     *
+     * Both `rootDir` and the longest already-existing ancestor of `target` are resolved via `fs.promises.realpath`
+     * before the containment check, not just `path.resolve`. Without this, a symlink placed anywhere on disk
+     * within `target`'s existing ancestry (including `target` itself) that points outside `rootDir` would pass
+     * a purely lexical check, yet `fs.existsSync`/`fs.writeFileSync`/`fs.readFileSync` etc. would transparently
+     * follow it - defeating the containment guarantee entirely. Any remaining (not-yet-existing) trailing path
+     * segments can't be symlinks yet, so they're safely appended as literal strings.
      *
-     * @param {string} rootDir The directory that `target` must be contained within.
-     * @param {string} target The fully resolved path to verify.
+     * @param {string} rootDir The directory that `target` must be contained within. Must exist.
+     * @param {string} target The path to verify.
+     * @returns The fully resolved (existing-portion realpath'd) path. Callers should use this value - not the
+     * original `target` - for the actual filesystem operation, so a symlink swapped in after this check can't
+     * reintroduce the gap it closes.
      */
-    static assertContained(rootDir, target) {
-        const rootResolved = path.resolve(rootDir);
-        const targetResolved = path.resolve(target);
-        const rel = path.relative(rootResolved, targetResolved);
+    static async assertContained(rootDir, target) {
+        const rootReal = await fs.promises.realpath(path.resolve(rootDir));
+        let existingPart = path.resolve(target);
+        const remainder = [];
+        while (!(await FileUtils.exists(existingPart))) {
+            const parent = path.dirname(existingPart);
+            // `path.dirname()` of a filesystem root returns that same root, which is the only way this loop
+            // could otherwise become infinite. Not practically reachable in a real filesystem (the root itself
+            // always exists), so this is defense-in-depth rather than an expected/tested case.
+            /* v8 ignore next */
+            if (parent === existingPart)
+                break;
+            remainder.unshift(path.basename(existingPart));
+            existingPart = parent;
+        }
+        const existingReal = await fs.promises.realpath(existingPart);
+        const targetReal = remainder.length > 0 ? path.join(existingReal, ...remainder) : existingReal;
+        const rel = path.relative(rootReal, targetReal);
         if (rel !== "" && (rel.startsWith("..") || path.isAbsolute(rel))) {
-            throw new Error(`Path "${target}" escapes the allowed root directory "${rootResolved}".`);
+            throw new Error(`Path "${target}" escapes the allowed root directory "${rootReal}".`);
         }
+        return targetReal;
     }
     /**
      * Attempts to write the provided contents to the file path given. If a file already exists at the destination
@@ -44,21 +80,28 @@ export class FileUtils {
         let srcPathFull = path.resolve(srcPath);
         let outPathFull = path.resolve(outPath);
         if (rootDir) {
-            FileUtils.assertContained(rootDir, srcPathFull);
-            FileUtils.assertContained(rootDir, outPathFull);
+            await FileUtils.assertContained(rootDir, srcPathFull);
+            outPathFull = await FileUtils.assertContained(rootDir, outPathFull);
         }
-        let fileExists = fs.existsSync(outPathFull);
         // Make sure the path leading to the final destination exists
-        let outDirPath = path.dirname(outPath);
-        if (!fs.existsSync(outDirPath)) {
+        let outDirPath = path.dirname(outPathFull);
+        if (!(await FileUtils.exists(outDirPath))) {
             await mkdirp(outDirPath);
         }
-        if (fileExists && !overwrite) {
-            throw new Error(`File already exists at "${outPathFull}". Pass overwrite=true to replace it.`);
-        }
-        // Write the final output to disk
+        // Write the final output to disk. When `overwrite` is `false`, the exclusive `"wx"` flag makes the
+        // existence check and the write atomic - `fs.existsSync()` followed by a plain write would otherwise
+        // leave a window where two concurrent calls both see no existing file and one silently clobbers the
+        // other's output.
         logger.info("Writing: " + outPathFull);
-        fs.writeFileSync(outPathFull, contents);
+        try {
+            await fs.promises.writeFile(outPathFull, contents, overwrite ? undefined : { flag: "wx" });
+        }
+        catch (err) {
+            if (!overwrite && err?.code === "EEXIST") {
+                throw new Error(`File already exists at "${outPathFull}". Pass overwrite=true to replace it.`);
+            }
+            throw err;
+        }
     }
     /**
      * Generates a copy of the source file at the desired output destination and performs a swap of all values of the
@@ -72,28 +115,25 @@ export class FileUtils {
      * within this directory, otherwise an error is thrown.
      */
     static async copyFile(srcPath, outPath, variables = {}, overwrite = false, rootDir) {
+        variables = variables ?? {};
         let srcPathFull = path.resolve(srcPath);
+        // Containment is checked *before* existence: assertContained() already tolerates a not-yet-existing
+        // target (it walks up to the nearest existing ancestor), so checking existence first would let a path
+        // outside rootDir get a different error ("File does not exist") depending on whether it happens to
+        // exist on disk - a file-existence oracle for paths the caller is supposed to be sandboxed away from.
         if (rootDir) {
-            FileUtils.assertContained(rootDir, srcPathFull);
+            // Re-resolved via the realpath'd return value so the subsequent read follows the *validated* path
+            // rather than the original (potentially symlinked) one.
+            srcPathFull = await FileUtils.assertContained(rootDir, srcPathFull);
         }
-        if (!fs.existsSync(srcPathFull)) {
+        if (!(await FileUtils.exists(srcPathFull))) {
             throw new Error("File does not exist: " + srcPathFull);
         }
-        // Make sure the path leading to the final destination exists
-        let outDirPath = path.dirname(outPath);
-        if (!fs.existsSync(outDirPath)) {
-            await mkdirp(outDirPath);
-        }
-        let template = fs.readFileSync(srcPathFull, "utf-8");
-        if (template) {
-            let output = StringUtils.findAndReplace(template, variables);
-            let outPathFinal = path.resolve(StringUtils.findAndReplace(outPath, variables));
-            logger.info("Writing: " + outPathFinal);
-            await FileUtils.writeFile(srcPath, outPathFinal, output, overwrite, rootDir);
-        }
-        else {
-            throw new Error("Failed to read file: " + srcPathFull);
-        }
+        let template = await fs.promises.readFile(srcPathFull, "utf-8");
+        let output = StringUtils.findAndReplace(template, variables);
+        let outPathFinal = path.resolve(StringUtils.findAndReplace(outPath, variables));
+        logger.info("Writing: " + outPathFinal);
+        await FileUtils.writeFile(srcPath, outPathFinal, output, overwrite, rootDir);
     }
     /**
      * Generates a copy of the source file at the desired output destination using binary copy mode.
@@ -103,25 +143,55 @@ export class FileUtils {
      * @param {Map<string,string>} variables The map of variable names to values to swap. Applies to outPath only.
      * @param {string} rootDir Optional. When provided, all resolved source and destination paths must be contained
      * within this directory, otherwise an error is thrown.
+     * @param {boolean} overwrite Set to `true` to overwrite an existing file at the destination. Default is `false`,
+     * matching the behavior of `writeFile`/`copyFile`. Appended after `rootDir` to preserve the existing positional
+     * call signature - note this is the opposite order from `copyFile`'s `(overwrite, rootDir)`.
      */
-    static async copyBinaryFile(srcPath, outPath, variables = {}, rootDir) {
-        let srcPathFull = path.resolve(srcPath);
-        if (rootDir) {
-            FileUtils.assertContained(rootDir, srcPathFull);
+    static async copyBinaryFile(srcPath, outPath, variables = {}, rootDir, overwrite = false) {
+        // `copyBinaryFile`'s `(rootDir, overwrite)` parameter order is the reverse of `copyFile`'s
+        // `(overwrite, rootDir)`. A caller that swaps them by analogy with `copyFile` would otherwise either
+        // silently disable overwrite protection (a boolean passed where `rootDir` is expected is truthy and
+        // simply fails the `typeof` check for a path) or crash confusingly deep inside `path.resolve()`, so it's
+        // rejected here with a message that explains the actual mistake.
+        if (rootDir !== undefined && typeof rootDir !== "string") {
+            throw new TypeError(`copyBinaryFile: "rootDir" must be a string, got ${typeof rootDir}. Did you mean to swap the ` +
+                `"overwrite" and "rootDir" arguments? Unlike copyFile, copyBinaryFile's signature is ` +
+                `(srcPath, outPath, variables, rootDir, overwrite).`);
         }
-        if (!fs.existsSync(srcPathFull)) {
+        if (typeof overwrite !== "boolean") {
+            throw new TypeError(`copyBinaryFile: "overwrite" must be a boolean, got ${typeof overwrite}.`);
+        }
+        variables = variables ?? {};
+        let srcPathFull = path.resolve(srcPath);
+        if (!(await FileUtils.exists(srcPathFull))) {
             throw new Error("File does not exist: " + srcPathFull);
         }
-        // Make sure the path leading to the final destination exists
-        let outDirPath = path.resolve(path.dirname(outPath));
-        if (!fs.existsSync(outDirPath)) {
-            await mkdirp(outDirPath);
+        if (rootDir) {
+            srcPathFull = await FileUtils.assertContained(rootDir, srcPathFull);
         }
         let outPathFinal = path.resolve(StringUtils.findAndReplace(outPath, variables));
         if (rootDir) {
-            FileUtils.assertContained(rootDir, outPathFinal);
+            outPathFinal = await FileUtils.assertContained(rootDir, outPathFinal);
+        }
+        // Make sure the path leading to the final (template-substituted) destination exists. Must be derived from
+        // `outPathFinal`, not the raw `outPath`, otherwise the created directory can differ from the one actually
+        // written to whenever `outPath`'s directory itself contains template variables.
+        let outDirPath = path.dirname(outPathFinal);
+        if (!(await FileUtils.exists(outDirPath))) {
+            await mkdirp(outDirPath);
+        }
+        // `COPYFILE_EXCL` makes the existence check and the copy atomic when `overwrite` is `false` - a plain
+        // `fs.existsSync()` check followed by an unconditional copy would otherwise leave a window where two
+        // concurrent calls both see no existing file and one silently clobbers the other's output.
+        try {
+            await fs.promises.copyFile(srcPathFull, outPathFinal, overwrite ? 0 : fs.constants.COPYFILE_EXCL);
+        }
+        catch (err) {
+            if (!overwrite && err?.code === "EEXIST") {
+                throw new Error(`File already exists at "${outPathFinal}". Pass overwrite=true to replace it.`);
+            }
+            throw err;
         }
-        fs.copyFileSync(srcPathFull, outPathFinal);
     }
     /**
      * Performs a deep copy of a directory tree at the given srcPath to the specified output directory. Performs
@@ -137,15 +207,18 @@ export class FileUtils {
      * within this directory, otherwise an error is thrown.
      */
     static async copyDirectory(srcPath, outPath, vars = {}, excludeFilters = [], binaryFilters = [], force = false, rootDir) {
-        const templatePath = path.resolve(srcPath);
+        vars = vars ?? {};
+        let templatePath = path.resolve(srcPath);
         if (rootDir) {
-            FileUtils.assertContained(rootDir, templatePath);
+            templatePath = await FileUtils.assertContained(rootDir, templatePath);
         }
-        let files = fs.readdirSync(templatePath, { withFileTypes: true });
-        // Iterated with a sequentially-awaited for-of (not `Array#forEach`, which ignores the promise its async
-        // callback returns): copyDirectory must not resolve until every nested copy has actually finished, and
-        // any error thrown by a nested copy must propagate to the caller instead of becoming an unhandled rejection.
-        for (const file of files) {
+        let files = await fs.promises.readdir(templatePath, { withFileTypes: true });
+        // Copied concurrently via `Promise.all` rather than a sequentially-awaited loop, since sibling entries
+        // in the same directory are independent of one another. `Promise.all` still `await`s every entry before
+        // `copyDirectory` itself resolves and still propagates the first rejection to the caller, so this keeps
+        // the same "wait for everything, never swallow an error" guarantee a sequential loop would - it just lets
+        // independent copies overlap instead of running strictly one at a time.
+        await Promise.all(files.map(async (file) => {
             let extension = path.extname(file.name);
             if (!extension) {
                 extension = file.name;
@@ -154,24 +227,24 @@ export class FileUtils {
             if (excludeFilters.indexOf(extension) === -1) {
                 let destPath = StringUtils.findAndReplace(path.join(outPath, file.name), vars);
                 if (rootDir) {
-                    FileUtils.assertContained(rootDir, destPath);
+                    destPath = await FileUtils.assertContained(rootDir, destPath);
                 }
                 if (file.isDirectory()) {
-                    if (!fs.existsSync(destPath)) {
+                    if (!(await FileUtils.exists(destPath))) {
                         // Recursive: `outPath` itself may not exist yet either, e.g. when directory entries are
                         // processed ahead of any file entry that would otherwise implicitly create it via mkdirp.
-                        fs.mkdirSync(destPath, { recursive: true });
+                        await fs.promises.mkdir(destPath, { recursive: true });
                     }
                     await FileUtils.copyDirectory(path.join(templatePath, file.name), destPath, vars, excludeFilters, binaryFilters, force, rootDir);
                 }
                 else if (binaryFilters.indexOf(extension) >= 0) {
-                    await FileUtils.copyBinaryFile(path.join(templatePath, file.name), destPath, vars, rootDir);
+                    await FileUtils.copyBinaryFile(path.join(templatePath, file.name), destPath, vars, rootDir, force);
                 }
                 else {
                     await FileUtils.copyFile(path.join(templatePath, file.name), destPath, vars, force, rootDir);
                 }
             }
-        }
+        }));
     }
 }
 //# sourceMappingURL=FileUtils.js.map

package/dist/lib/FileUtils.js.map

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