File Explorer

1import { chownr, chownrSync } from 'chownr';2import fs from 'node:fs';3import fsp from 'node:fs/promises';4import path from 'node:path';5import { CwdError } from './cwd-error.js';6import { normalizeWindowsPath } from './normalize-windows-path.js';7import { SymlinkError } from './symlink-error.js';8const checkCwd = (dir, cb) => {9    fs.stat(dir, (er, st) => {10        if (er || !st.isDirectory()) {11            er = new CwdError(dir, er?.code || 'ENOTDIR');12        }13        cb(er);14    });15};16/**17 * Wrapper around fs/promises.mkdir for tar's needs.18 *19 * The main purpose is to avoid creating directories if we know that20 * they already exist (and track which ones exist for this purpose),21 * and prevent entries from being extracted into symlinked folders,22 * if `preservePaths` is not set.23 */24export const mkdir = (dir, opt, cb) => {25    dir = normalizeWindowsPath(dir);26    // if there's any overlap between mask and mode,27    // then we'll need an explicit chmod28    /* c8 ignore next */29    const umask = opt.umask ?? 0o22;30    const mode = opt.mode | 0o0700;31    const needChmod = (mode & umask) !== 0;32    const uid = opt.uid;33    const gid = opt.gid;34    const doChown = typeof uid === 'number' &&35        typeof gid === 'number' &&36        (uid !== opt.processUid || gid !== opt.processGid);37    const preserve = opt.preserve;38    const unlink = opt.unlink;39    const cwd = normalizeWindowsPath(opt.cwd);40    const done = (er, created) => {41        if (er) {42            cb(er);43        }44        else {45            if (created && doChown) {46                chownr(created, uid, gid, er => done(er));47            }48            else if (needChmod) {49                fs.chmod(dir, mode, cb);50            }51            else {52                cb();53            }54        }55    };56    if (dir === cwd) {57        return checkCwd(dir, done);58    }59    if (preserve) {60        return fsp.mkdir(dir, { mode, recursive: true }).then(made => done(null, made ?? undefined), // oh, ts61        done);62    }63    const sub = normalizeWindowsPath(path.relative(cwd, dir));64    const parts = sub.split('/');65    mkdir_(cwd, parts, mode, unlink, cwd, undefined, done);66};67const mkdir_ = (base, parts, mode, unlink, cwd, created, cb) => {68    if (!parts.length) {69        return cb(null, created);70    }71    const p = parts.shift();72    const part = normalizeWindowsPath(path.resolve(base + '/' + p));73    fs.mkdir(part, mode, onmkdir(part, parts, mode, unlink, cwd, created, cb));74};75const onmkdir = (part, parts, mode, unlink, cwd, created, cb) => (er) => {76    if (er) {77        fs.lstat(part, (statEr, st) => {78            if (statEr) {79                statEr.path =80                    statEr.path && normalizeWindowsPath(statEr.path);81                cb(statEr);82            }83            else if (st.isDirectory()) {84                mkdir_(part, parts, mode, unlink, cwd, created, cb);85            }86            else if (unlink) {87                fs.unlink(part, er => {88                    if (er) {89                        return cb(er);90                    }91                    fs.mkdir(part, mode, onmkdir(part, parts, mode, unlink, cwd, created, cb));92                });93            }94            else if (st.isSymbolicLink()) {95                return cb(new SymlinkError(part, part + '/' + parts.join('/')));96            }97            else {98                cb(er);99            }100        });101    }102    else {103        created = created || part;104        mkdir_(part, parts, mode, unlink, cwd, created, cb);105    }106};107const checkCwdSync = (dir) => {108    let ok = false;109    let code = undefined;110    try {111        ok = fs.statSync(dir).isDirectory();112    }113    catch (er) {114        code = er?.code;115    }116    finally {117        if (!ok) {118            throw new CwdError(dir, code ?? 'ENOTDIR');119        }120    }121};122export const mkdirSync = (dir, opt) => {123    dir = normalizeWindowsPath(dir);124    // if there's any overlap between mask and mode,125    // then we'll need an explicit chmod126    /* c8 ignore next */127    const umask = opt.umask ?? 0o22;128    const mode = opt.mode | 0o700;129    const needChmod = (mode & umask) !== 0;130    const uid = opt.uid;131    const gid = opt.gid;132    const doChown = typeof uid === 'number' &&133        typeof gid === 'number' &&134        (uid !== opt.processUid || gid !== opt.processGid);135    const preserve = opt.preserve;136    const unlink = opt.unlink;137    const cwd = normalizeWindowsPath(opt.cwd);138    const done = (created) => {139        if (created && doChown) {140            chownrSync(created, uid, gid);141        }142        if (needChmod) {143            fs.chmodSync(dir, mode);144        }145    };146    if (dir === cwd) {147        checkCwdSync(cwd);148        return done();149    }150    if (preserve) {151        return done(fs.mkdirSync(dir, { mode, recursive: true }) ?? undefined);152    }153    const sub = normalizeWindowsPath(path.relative(cwd, dir));154    const parts = sub.split('/');155    let created = undefined;156    for (let p = parts.shift(), part = cwd; p && (part += '/' + p); p = parts.shift()) {157        part = normalizeWindowsPath(path.resolve(part));158        try {159            fs.mkdirSync(part, mode);160            created = created || part;161        }162        catch (er) {163            const st = fs.lstatSync(part);164            if (st.isDirectory()) {165                continue;166            }167            else if (unlink) {168                fs.unlinkSync(part);169                fs.mkdirSync(part, mode);170                created = created || part;171                continue;172            }173            else if (st.isSymbolicLink()) {174                return new SymlinkError(part, part + '/' + parts.join('/'));175            }176        }177    }178    return done(created);179};180//# sourceMappingURL=mkdir.js.map