vike/dist/cjs/utils/isFilePathAbsoluteFilesystem.js

The Framework *You* Control - Next.js & Nuxt alternative for unprecedented flexibility and dependability.

"use strict";
var __importDefault = (this && this.__importDefault) || function (mod) {
    return (mod && mod.__esModule) ? mod : { "default": mod };
};
Object.defineProperty(exports, "__esModule", { value: true });
exports.assertFilePathAbsoluteFilesystem = assertFilePathAbsoluteFilesystem;
exports.isFilePathAbsolute = isFilePathAbsolute;
const node_path_1 = __importDefault(require("node:path"));
const assert_js_1 = require("./assert.js");
const path_js_1 = require("./path.js");
const assertIsNotBrowser_js_1 = require("./assertIsNotBrowser.js");
const assertSetup_js_1 = require("./assertSetup.js");
(0, assertIsNotBrowser_js_1.assertIsNotBrowser)();
// Server runtime shouldn't depend on node:path
(0, assertSetup_js_1.assertIsNotProductionRuntime)();
/**
 * Asserts that `filePath` is an absolute file path starting from the filesystem root.
 *
 * It isn't reliable for Linux users, but that's okay because the assertion will eventually fail on windows.
 */
function assertFilePathAbsoluteFilesystem(filePath) {
    // The assert is "eventually reliable":
    // - For Windows users, the assert is correct.
    // - For Linux users assertFilePathAbsoluteFilesystem() will erroneously succeed if `p` is a path absolute from the user root dir.
    //   - But that's okay because the assertion will eventually fail for Windows users.
    //   - On Linux there doesn't seem to be a way to distinguish between an absolute path starting from the filesystem root or starting from the user root directory, see comment at isFilePathAbsoluteFilesystem()
    (0, path_js_1.assertPosixPath)(filePath);
    (0, assert_js_1.assert)(isFilePathAbsoluteFilesystem(filePath));
}
/**
 * Whether `filePath` is an absolute file path starting from the filesystem root.
 *
 * Isn't reliable for Linux users: it returns `true` for an absolute path starting from the user root dir.
 */
function isFilePathAbsoluteFilesystem(filePath) {
    (0, assert_js_1.assert)(!filePath.startsWith('/@fs/'));
    if (process.platform !== 'win32') {
        // - For linux users, there doesn't seem to be a reliable way to distinguish between:
        //   - File path absolute starting from filesystem root, e.g. /home/rom/code/my-app/pages/about/+Page.js
        //   - File path absolute starting from user root dir (Vite's `config.root`), e.g. /pages/about/+Page.js
        // - Checking whether `p` starts with the first directory of process.cwd() (or `userRootDir`) can be erroneous, most notably when using docker: https://github.com/vikejs/vike/issues/703
        // - Using require.resolve() or node:fs to check whether the file/dir exists would be a solution, but maybe too slow?
        return filePath.startsWith('/');
    }
    else {
        const yes = node_path_1.default.win32.isAbsolute(filePath);
        // Ensure isFilePathAbsoluteFilesystem() returns `false` if path is absolute starting from the user root dir (see comments above).
        if (yes)
            (0, assert_js_1.assert)(!filePath.startsWith('/'));
        return yes;
    }
}
/**
 * Whether `filePath` is an absolute file path.
 *
 * Returns `true` regardless whether it starts from the user root dir or filesystem root.
 */
function isFilePathAbsolute(filePath) {
    (0, assert_js_1.assert)(!filePath.startsWith('/@fs/'));
    // Absolute path starting from the user root dir.
    if (filePath.startsWith('/'))
        return true;
    // Seems to be reliable: https://nodejs.org/api/path.html#pathisabsolutepath
    return node_path_1.default.isAbsolute(filePath);
}