signalk-parquet/dist/utils/path-safety.js

Vessel data Parquet file archive with automated value and geospatial triggers. History API compliant with cloud backups and queries.

"use strict";
var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
    if (k2 === undefined) k2 = k;
    var desc = Object.getOwnPropertyDescriptor(m, k);
    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
      desc = { enumerable: true, get: function() { return m[k]; } };
    }
    Object.defineProperty(o, k2, desc);
}) : (function(o, m, k, k2) {
    if (k2 === undefined) k2 = k;
    o[k2] = m[k];
}));
var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
    Object.defineProperty(o, "default", { enumerable: true, value: v });
}) : function(o, v) {
    o["default"] = v;
});
var __importStar = (this && this.__importStar) || (function () {
    var ownKeys = function(o) {
        ownKeys = Object.getOwnPropertyNames || function (o) {
            var ar = [];
            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
            return ar;
        };
        return ownKeys(o);
    };
    return function (mod) {
        if (mod && mod.__esModule) return mod;
        var result = {};
        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
        __setModuleDefault(result, mod);
        return result;
    };
})();
Object.defineProperty(exports, "__esModule", { value: true });
exports.resolveWithinRoot = resolveWithinRoot;
const path = __importStar(require("path"));
/**
 * Resolve a caller-supplied path against a trusted root directory and guarantee
 * the result stays inside that root. Returns the resolved absolute path, or
 * `null` if the input escapes the root — whether via `..` traversal segments or
 * an absolute path that points elsewhere.
 *
 * Use this for any request-body value that becomes a filesystem path, so that
 * untrusted callers cannot read, write, delete, or exfiltrate files outside the
 * configured data directory.
 */
function resolveWithinRoot(root, userPath) {
    const resolvedRoot = path.resolve(root);
    // path.resolve discards `resolvedRoot` when `userPath` is absolute, so an
    // absolute escape (e.g. '/etc/passwd') still lands outside and is rejected.
    const resolved = path.resolve(resolvedRoot, userPath);
    if (resolved === resolvedRoot || resolved.startsWith(resolvedRoot + path.sep)) {
        return resolved;
    }
    return null;
}
//# sourceMappingURL=path-safety.js.map