@struktoai/mirage-core/dist/utils/mode.js

A Unified Virtual Filesystem For AI Agents

// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
const MODE_CLASS_BITS = { u: 0o700, g: 0o070, o: 0o007, a: 0o777 };
const MODE_PERM_BITS = { r: 0o444, w: 0o222, x: 0o111 };
const MODE_CLAUSE_RE = /^([ugoa]*)([+\-=])([rwx]*)$/;
export const DEFAULT_DIR_MODE = 0o755;
export const DEFAULT_FILE_MODE = 0o644;
// Parse a chmod MODE argument (octal or symbolic). Symbolic supports the
// common grammar: `[ugoa...][+-=][rwx...]` clauses joined by commas
// (`u+x`, `go-w`, `a=r`, `+x`). Special bits (s, t, X) are not supported.
// Returns the new mode, or null when the text does not parse.
export function parseChmod(text, current) {
    if (/^[0-7]+$/.test(text)) {
        const value = parseInt(text, 8);
        return value <= 0o7777 ? value : null;
    }
    let mode = current;
    for (const clause of text.split(',')) {
        const match = MODE_CLAUSE_RE.exec(clause);
        if (match === null)
            return null;
        const [, classes = '', action, perms = ''] = match;
        let classMask = 0;
        for (const c of classes.length > 0 ? classes : 'a') {
            classMask |= MODE_CLASS_BITS[c] ?? 0;
        }
        let permMask = 0;
        for (const c of perms)
            permMask |= MODE_PERM_BITS[c] ?? 0;
        const bits = classMask & permMask;
        if (action === '+')
            mode |= bits;
        else if (action === '-')
            mode &= ~bits;
        else
            mode = (mode & ~classMask) | bits;
    }
    return mode;
}
//# sourceMappingURL=mode.js.map