@zenfs/core/dist/context.js

A filesystem, anywhere

// SPDX-License-Identifier: LGPL-3.0-or-later
import { UV } from 'kerium';
import { bindFunctions } from 'utilium';
import { contextOf, createChildContext } from './internal/contexts.js';
import * as fs from './node/index.js';
import * as path from './path.js';
import * as xattr from './vfs/xattr.js';
/**
 * A map of all contexts.
 * @internal
 * @category Contexts
 */
export const boundContexts = new Map();
/**
 * Allows you to restrict operations to a specific root path and set of credentials.
 * Note that the default credentials of a bound context are copied from the global credentials.
 * @category Contexts
 */
export function bindContext(init = {}) {
    const $ = contextOf(this);
    if (!fs.statSync.call(this, $.root).isDirectory())
        throw UV('ENOTDIR', { syscall: 'chroot', path: $.root });
    const ctx = createChildContext($, init);
    const bound = Object.assign(ctx, {
        fs: {
            ...bindFunctions(fs, ctx),
            promises: bindFunctions(fs.promises, ctx),
            xattr: bindFunctions(xattr, ctx),
        },
        path: bindFunctions(path, ctx),
        bind: (init) => {
            const child = bindContext.call(ctx, init);
            ctx.children.push(child);
            return child;
        },
    });
    boundContexts.set(ctx.id, bound);
    return bound;
}