@mdfriday/foundry 0.1.0

package/dist/internal/domain/fs/entity/overlaydir.js

@@ -0,0 +1,249 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OverlayDir = void 0;
+exports.getDir = getDir;
+exports.releaseDir = releaseDir;
+exports.openDir = openDir;
+exports.newOverlayDir = newOverlayDir;
+const type_1 = require("../type");
+const overlayoptions_1 = require("@internal/domain/fs/vo/overlayoptions");
+/**
+ * OverlayDir entity - represents a merged directory from multiple filesystems
+ * TypeScript version of Go's Dir struct
+ */
+class OverlayDir {
+    constructor(options = {}) {
+        this._name = options.name || '';
+        this.fss = options.fss ? [...options.fss] : [];
+        this.dirOpeners = options.dirOpeners ? [...options.dirOpeners] : [];
+        if (options.info !== undefined) {
+            this.info = options.info;
+        }
+        this.merge = options.merge || overlayoptions_1.defaultDirMerger;
+        this.offset = 0;
+        this.fis = [];
+        this.closed = false;
+    }
+    /**
+     * Get file name
+     */
+    name() {
+        return this._name;
+    }
+    /**
+     * Check if directory is closed
+     */
+    isClosed() {
+        return this.closed || (this.fss.length === 0 && this.dirOpeners.length === 0);
+    }
+    /**
+     * Read directory entries
+     */
+    async readdir(count) {
+        if (this.isClosed()) {
+            throw type_1.ErrFileClosed;
+        }
+        if (this.err) {
+            throw this.err;
+        }
+        // Load directory entries if not already loaded
+        if (this.offset === 0) {
+            await this.loadDirectoryEntries();
+        }
+        const remainingEntries = this.fis.slice(this.offset);
+        if (count <= 0) {
+            // Return all remaining entries
+            this.err = new Error('EOF');
+            if (this.offset > 0 && remainingEntries.length === 0) {
+                throw this.err;
+            }
+            return [...remainingEntries];
+        }
+        if (remainingEntries.length === 0) {
+            this.err = new Error('EOF');
+            throw this.err;
+        }
+        const result = remainingEntries.slice(0, count);
+        this.offset += result.length;
+        return result;
+    }
+    /**
+     * Read directory names
+     */
+    async readdirnames(n) {
+        if (this.isClosed()) {
+            throw type_1.ErrFileClosed;
+        }
+        const entries = await this.readdir(n);
+        return entries.map(entry => entry.name());
+    }
+    /**
+     * Load directory entries from all filesystems
+     */
+    async loadDirectoryEntries() {
+        // Read from filesystems directly (like Go version)
+        for (let i = 0; i < this.fss.length; i++) {
+            const fs = this.fss[i];
+            await this.readFromFilesystem(fs, null);
+        }
+        // Read from directory openers (fallback for compatibility)
+        for (let i = 0; i < this.dirOpeners.length; i++) {
+            const file = await this.dirOpeners[i]();
+            await this.readFromFilesystem(null, file);
+        }
+    }
+    /**
+     * Read directory entries from a specific filesystem or file
+     */
+    async readFromFilesystem(fs, file) {
+        let f = file;
+        try {
+            if (!f && fs) {
+                // Convert "/" to "" for root directory access in BaseFs (like Go version)
+                const fsPath = this._name === '/' ? '' : this._name;
+                f = await fs.open(fsPath);
+            }
+            if (!f) {
+                return;
+            }
+            // Get directory entries
+            const entries = await f.readdir(-1);
+            // Merge with existing entries
+            this.fis = this.merge(this.fis, entries);
+        }
+        catch (error) {
+            // Continue if directory doesn't exist or can't be read
+        }
+        finally {
+            if (f && !file) {
+                // Only close if we opened it ourselves
+                await f.close();
+            }
+        }
+    }
+    /**
+     * Get file statistics
+     */
+    async stat() {
+        if (this.isClosed()) {
+            throw type_1.ErrFileClosed;
+        }
+        if (this.info) {
+            return await this.info();
+        }
+        if (this.fss.length > 0) {
+            return await this.fss[0].stat(this._name);
+        }
+        throw new type_1.OverlayFsError('no filesystem available for stat', 'NO_FILESYSTEM');
+    }
+    /**
+     * Close directory
+     */
+    async close() {
+        this.closed = true;
+        this.fss = [];
+        this.dirOpeners = [];
+        this.fis = [];
+        delete this.info;
+        this.offset = 0;
+        delete this.err;
+    }
+    /**
+     * Not supported operations for directories
+     */
+    notSupported(operation) {
+        throw new type_1.OverlayFsError(`operation ${operation} not supported on directory "${this._name}"`, 'OPERATION_NOT_SUPPORTED');
+    }
+    // File interface methods that are not supported for directories
+    async read(buffer) {
+        this.notSupported('read');
+    }
+    async readAt(buffer, offset) {
+        this.notSupported('readAt');
+    }
+    async seek(offset, whence) {
+        this.notSupported('seek');
+    }
+    async write(buffer) {
+        this.notSupported('write');
+    }
+    async writeAt(buffer, offset) {
+        this.notSupported('writeAt');
+    }
+    async sync() {
+        this.notSupported('sync');
+    }
+    async truncate(size) {
+        this.notSupported('truncate');
+    }
+    async writeString(s) {
+        this.notSupported('writeString');
+    }
+}
+exports.OverlayDir = OverlayDir;
+/**
+ * Directory pool for reusing OverlayDir instances
+ */
+class DirPool {
+    constructor() {
+        this.pool = [];
+    }
+    get() {
+        if (this.pool.length > 0) {
+            return this.pool.pop();
+        }
+        return new OverlayDir();
+    }
+    release(dir) {
+        // Reset the directory state
+        dir['fss'] = [];
+        dir['dirOpeners'] = [];
+        dir['fis'] = [];
+        delete dir['info'];
+        dir['offset'] = 0;
+        dir['_name'] = '';
+        delete dir['err'];
+        dir['closed'] = false;
+        this.pool.push(dir);
+    }
+}
+const dirPool = new DirPool();
+/**
+ * Get a directory from the pool
+ */
+function getDir() {
+    return dirPool.get();
+}
+/**
+ * Release a directory back to the pool
+ */
+function releaseDir(dir) {
+    dirPool.release(dir);
+}
+/**
+ * Open a new merged directory
+ * TypeScript version of Go's OpenDir function
+ */
+async function openDir(name, merge, info, fss // Pass filesystems directly like Go version
+) {
+    if (!info) {
+        throw new type_1.OverlayFsError('info function must not be null', 'INFO_REQUIRED');
+    }
+    const dir = getDir();
+    const options = {
+        name,
+        fss: [...fss], // Set filesystems directly
+        info,
+        merge: merge || overlayoptions_1.defaultDirMerger,
+    };
+    // Reinitialize the pooled directory
+    Object.assign(dir, new OverlayDir(options));
+    return dir;
+}
+/**
+ * Create a new OverlayDir instance
+ */
+function newOverlayDir(options = {}) {
+    return new OverlayDir(options);
+}
+//# sourceMappingURL=overlaydir.js.map

package/dist/internal/domain/fs/entity/overlaydir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlaydir.js","sourceRoot":"","sources":["../../../../../internal/domain/fs/entity/overlaydir.ts"],"names":[],"mappings":"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"}

package/dist/internal/domain/fs/entity/overlayfs.d.ts

@@ -0,0 +1,113 @@
+import { Fs, File, FileInfo, OverlayFs as IOverlayFs, DirsMerger, OverlayFsOptions } from '../type';
+import { OverlayOptions } from '@internal/domain/fs/vo/overlayoptions';
+/**
+ * OverlayFs entity - main overlay filesystem implementation
+ * TypeScript version of Go's OverlayFs struct
+ */
+export declare class OverlayFs implements IOverlayFs {
+    private fss;
+    private mergeDirs;
+    private firstWritable;
+    constructor(options: OverlayOptions);
+    /**
+     * Get filesystem name
+     */
+    name(): string;
+    /**
+     * Implementation of FilesystemIterator interface
+     */
+    filesystem(i: number): Fs | null;
+    /**
+     * Get number of filesystems in overlay
+     */
+    numFilesystems(): number;
+    /**
+     * Append filesystems to overlay (returns new instance)
+     */
+    append(...fss: Fs[]): OverlayFs;
+    /**
+     * Set directory merger (returns new instance)
+     */
+    withDirsMerger(merger: DirsMerger): OverlayFs;
+    /**
+     * Get writable filesystem (first filesystem if firstWritable is true)
+     */
+    private writeFs;
+    /**
+     * Collect directories from all filesystems
+     */
+    private collectDirs;
+    /**
+     * Recursively collect directories from filesystem hierarchy
+     */
+    private collectDirsRecursive;
+    /**
+     * Stat file/directory across all filesystems
+     */
+    private statInternal;
+    /**
+     * Recursive stat implementation
+     */
+    private statRecursive;
+    /**
+     * Check if error is "not exist" error
+     */
+    private isNotExistError;
+    /**
+     * Create a file (write operation)
+     */
+    create(name: string): Promise<File>;
+    /**
+     * Create directory (write operation)
+     */
+    mkdir(name: string, perm: number): Promise<void>;
+    /**
+     * Create directory tree (write operation)
+     */
+    mkdirAll(path: string, perm: number): Promise<void>;
+    /**
+     * Open file for reading (searches all filesystems)
+     */
+    open(name: string): Promise<File>;
+    /**
+     * Open file with flags (write operations use first filesystem)
+     */
+    openFile(name: string, flag: number, perm: number): Promise<File>;
+    /**
+     * Remove file (write operation)
+     */
+    remove(name: string): Promise<void>;
+    /**
+     * Remove directory tree (write operation)
+     */
+    removeAll(path: string): Promise<void>;
+    /**
+     * Rename file (write operation)
+     */
+    rename(oldname: string, newname: string): Promise<void>;
+    /**
+     * Get file info (searches all filesystems)
+     */
+    stat(name: string): Promise<FileInfo>;
+    /**
+     * Change file mode (write operation)
+     */
+    chmod(name: string, mode: number): Promise<void>;
+    /**
+     * Change file ownership (write operation)
+     */
+    chown(name: string, uid: number, gid: number): Promise<void>;
+    /**
+     * Change file times (write operation)
+     */
+    chtimes(name: string, atime: Date, mtime: Date): Promise<void>;
+}
+/**
+ * Factory function to create new OverlayFs
+ */
+export declare function newOverlayFs(options: OverlayOptions): OverlayFs;
+/**
+ * Create OverlayFs from raw options
+ */
+export declare function createOverlayFs(opts: OverlayFsOptions): OverlayFs;
+//# sourceMappingURL=overlayfs.d.ts.map

package/dist/internal/domain/fs/entity/overlayfs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlayfs.d.ts","sourceRoot":"","sources":["../../../../../internal/domain/fs/entity/overlayfs.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,EAAE,EACF,IAAI,EACJ,QAAQ,EACR,SAAS,IAAI,UAAU,EAEvB,UAAU,EACV,gBAAgB,EAKjB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAOvE;;;GAGG;AACH,qBAAa,SAAU,YAAW,UAAU;IAC1C,OAAO,CAAC,GAAG,CAAO;IAClB,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,aAAa,CAAU;gBAEnB,OAAO,EAAE,cAAc;IAMnC;;OAEG;IACH,IAAI,IAAI,MAAM;IAId;;OAEG;IACH,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,EAAE,GAAG,IAAI;IAOhC;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;OAEG;IACH,MAAM,CAAC,GAAG,GAAG,EAAE,EAAE,EAAE,GAAG,SAAS;IAS/B;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS;IAS7C;;OAEG;IACH,OAAO,CAAC,OAAO;IAOf;;OAEG;YACW,WAAW;IAMzB;;OAEG;YACW,oBAAoB;IAsBlC;;OAEG;YACW,YAAY;IAe1B;;OAEG;YACW,aAAa;IA4B3B;;OAEG;IACH,OAAO,CAAC,eAAe;IAMvB;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOzC;;OAEG;IACG,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOtD;;OAEG;IACG,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOzD;;OAEG;IACG,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAyCvC;;OAEG;IACG,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAcvE;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOzC;;OAEG;IACG,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO5C;;OAEG;IACG,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO7D;;OAEG;IACG,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAU3C;;OAEG;IACG,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOtD;;OAEG;IACG,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOlE;;OAEG;IACG,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;CAMrE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,SAAS,CAE/D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,gBAAgB,GAAG,SAAS,CAGjE"}

package/dist/internal/domain/fs/entity/overlayfs.js

@@ -0,0 +1,310 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OverlayFs = void 0;
+exports.newOverlayFs = newOverlayFs;
+exports.createOverlayFs = createOverlayFs;
+const type_1 = require("../type");
+const overlayoptions_1 = require("@internal/domain/fs/vo/overlayoptions");
+const overlaydir_1 = require("./overlaydir");
+const log_1 = require("@pkg/log");
+// Create domain-specific logger for fs operations
+const log = (0, log_1.getDomainLogger)('fs', { component: 'overlayfs' });
+/**
+ * OverlayFs entity - main overlay filesystem implementation
+ * TypeScript version of Go's OverlayFs struct
+ */
+class OverlayFs {
+    constructor(options) {
+        this.fss = [...options.fss]; // Create a copy
+        this.mergeDirs = options.dirsMerger;
+        this.firstWritable = options.firstWritable;
+    }
+    /**
+     * Get filesystem name
+     */
+    name() {
+        return 'overlayfs';
+    }
+    /**
+     * Implementation of FilesystemIterator interface
+     */
+    filesystem(i) {
+        if (i >= this.fss.length) {
+            return null;
+        }
+        return this.fss[i];
+    }
+    /**
+     * Get number of filesystems in overlay
+     */
+    numFilesystems() {
+        return this.fss.length;
+    }
+    /**
+     * Append filesystems to overlay (returns new instance)
+     */
+    append(...fss) {
+        const newOptions = new overlayoptions_1.OverlayOptions({
+            fss: [...this.fss, ...fss],
+            firstWritable: this.firstWritable,
+            dirsMerger: this.mergeDirs,
+        });
+        return new OverlayFs(newOptions);
+    }
+    /**
+     * Set directory merger (returns new instance)
+     */
+    withDirsMerger(merger) {
+        const newOptions = new overlayoptions_1.OverlayOptions({
+            fss: this.fss,
+            firstWritable: this.firstWritable,
+            dirsMerger: merger,
+        });
+        return new OverlayFs(newOptions);
+    }
+    /**
+     * Get writable filesystem (first filesystem if firstWritable is true)
+     */
+    writeFs() {
+        if (this.fss.length === 0) {
+            throw type_1.ErrNoFilesystems;
+        }
+        return this.fss[0];
+    }
+    /**
+     * Collect directories from all filesystems
+     */
+    async collectDirs(name, withFs) {
+        for (const fs of this.fss) {
+            await this.collectDirsRecursive(fs, name, withFs);
+        }
+    }
+    /**
+     * Recursively collect directories from filesystem hierarchy
+     */
+    async collectDirsRecursive(fs, name, withFs) {
+        try {
+            const fi = await fs.stat(name);
+            if (fi.isDir()) {
+                withFs(fs);
+            }
+        }
+        catch (error) {
+            // File doesn't exist in this filesystem, continue
+        }
+        // Check if filesystem implements FilesystemIterator
+        const fsi = fs;
+        if (fsi.filesystem && fsi.numFilesystems) {
+            for (let i = 0; i < fsi.numFilesystems(); i++) {
+                const subFs = fsi.filesystem(i);
+                if (subFs) {
+                    await this.collectDirsRecursive(subFs, name, withFs);
+                }
+            }
+        }
+    }
+    /**
+     * Stat file/directory across all filesystems
+     */
+    async statInternal(name, lstatIfPossible) {
+        for (let i = 0; i < this.fss.length; i++) {
+            const fs = this.fss[i];
+            const [fs2, fi, ok, err] = await this.statRecursive(fs, name, lstatIfPossible);
+            if (err === null || !this.isNotExistError(err)) {
+                return [fs2, fi, ok, err];
+            }
+        }
+        log.debug(`OverlayFs.statInternal: File ${name} not found in any filesystem`);
+        return [null, null, false, type_1.ErrFileNotFound];
+    }
+    /**
+     * Recursive stat implementation
+     */
+    async statRecursive(fs, name, lstatIfPossible) {
+        try {
+            // For now, we'll use regular stat since TypeScript doesn't have lstat equivalent
+            const fi = await fs.stat(name);
+            return [fs, fi, false, null];
+        }
+        catch (error) {
+            if (!this.isNotExistError(error)) {
+                return [fs, null, false, error];
+            }
+        }
+        // Check if filesystem implements FilesystemIterator
+        const fsi = fs;
+        if (fsi.filesystem && fsi.numFilesystems) {
+            for (let i = 0; i < fsi.numFilesystems(); i++) {
+                const subFs = fsi.filesystem(i);
+                if (subFs) {
+                    const [fs2, fi, ok, err] = await this.statRecursive(subFs, name, lstatIfPossible);
+                    if (err === null || !this.isNotExistError(err)) {
+                        return [fs2, fi, ok, err];
+                    }
+                }
+            }
+        }
+        return [null, null, false, type_1.ErrFileNotFound];
+    }
+    /**
+     * Check if error is "not exist" error
+     */
+    isNotExistError(error) {
+        return error.message.includes('ENOENT') ||
+            error.message.includes('no such file') ||
+            error === type_1.ErrFileNotFound;
+    }
+    /**
+     * Create a file (write operation)
+     */
+    async create(name) {
+        if (!this.firstWritable) {
+            throw new type_1.OverlayFsError('filesystem is read-only', 'READ_ONLY');
+        }
+        return await this.writeFs().create(name);
+    }
+    /**
+     * Create directory (write operation)
+     */
+    async mkdir(name, perm) {
+        if (!this.firstWritable) {
+            throw new type_1.OverlayFsError('filesystem is read-only', 'READ_ONLY');
+        }
+        return await this.writeFs().mkdir(name, perm);
+    }
+    /**
+     * Create directory tree (write operation)
+     */
+    async mkdirAll(path, perm) {
+        if (!this.firstWritable) {
+            throw new type_1.OverlayFsError('filesystem is read-only', 'READ_ONLY');
+        }
+        return await this.writeFs().mkdirAll(path, perm);
+    }
+    /**
+     * Open file for reading (searches all filesystems)
+     */
+    async open(name) {
+        // Handle empty filesystem case
+        if (this.fss.length === 0) {
+            log.debug(`OverlayFs.open: No filesystems available`);
+            throw type_1.ErrFileNotFound;
+        }
+        const [fs, fi, , err] = await this.statInternal(name, false);
+        if (err) {
+            log.debug(`OverlayFs.open: stat failed for ${name}: ${err.message}`);
+            throw err;
+        }
+        if (fi.isDir()) {
+            // Return merged directory - like Go version
+            const dirFss = [];
+            await this.collectDirs(name, (fs) => {
+                dirFss.push(fs);
+            });
+            if (dirFss.length === 0) {
+                // They may have been deleted
+                throw type_1.ErrFileNotFound;
+            }
+            if (dirFss.length === 1) {
+                return await dirFss[0].open(name);
+            }
+            return await (0, overlaydir_1.openDir)(name, this.mergeDirs, async () => fi, dirFss // Pass filesystems directly
+            );
+        }
+        return await fs.open(name);
+    }
+    /**
+     * Open file with flags (write operations use first filesystem)
+     */
+    async openFile(name, flag, perm) {
+        const isWrite = (flag & type_1.OpenFlags.O_WRONLY) !== 0 || (flag & type_1.OpenFlags.O_RDWR) !== 0;
+        if (isWrite && !this.firstWritable) {
+            throw new type_1.OverlayFsError('filesystem is read-only', 'READ_ONLY');
+        }
+        if (isWrite) {
+            return await this.writeFs().openFile(name, flag, perm);
+        }
+        return await this.open(name);
+    }
+    /**
+     * Remove file (write operation)
+     */
+    async remove(name) {
+        if (!this.firstWritable) {
+            throw new type_1.OverlayFsError('filesystem is read-only', 'READ_ONLY');
+        }
+        return await this.writeFs().remove(name);
+    }
+    /**
+     * Remove directory tree (write operation)
+     */
+    async removeAll(path) {
+        if (!this.firstWritable) {
+            throw new type_1.OverlayFsError('filesystem is read-only', 'READ_ONLY');
+        }
+        return await this.writeFs().removeAll(path);
+    }
+    /**
+     * Rename file (write operation)
+     */
+    async rename(oldname, newname) {
+        if (!this.firstWritable) {
+            throw new type_1.OverlayFsError('filesystem is read-only', 'READ_ONLY');
+        }
+        return await this.writeFs().rename(oldname, newname);
+    }
+    /**
+     * Get file info (searches all filesystems)
+     */
+    async stat(name) {
+        // Convert "/" to "" for root directory access in BaseFs
+        const fsPath = name === '/' ? '' : name;
+        const [, fi, , err] = await this.statInternal(fsPath, false);
+        if (err) {
+            throw err;
+        }
+        return fi;
+    }
+    /**
+     * Change file mode (write operation)
+     */
+    async chmod(name, mode) {
+        if (!this.firstWritable) {
+            throw new type_1.OverlayFsError('filesystem is read-only', 'READ_ONLY');
+        }
+        return await this.writeFs().chmod(name, mode);
+    }
+    /**
+     * Change file ownership (write operation)
+     */
+    async chown(name, uid, gid) {
+        if (!this.firstWritable) {
+            throw new type_1.OverlayFsError('filesystem is read-only', 'READ_ONLY');
+        }
+        return await this.writeFs().chown(name, uid, gid);
+    }
+    /**
+     * Change file times (write operation)
+     */
+    async chtimes(name, atime, mtime) {
+        if (!this.firstWritable) {
+            throw new type_1.OverlayFsError('filesystem is read-only', 'READ_ONLY');
+        }
+        return await this.writeFs().chtimes(name, atime, mtime);
+    }
+}
+exports.OverlayFs = OverlayFs;
+/**
+ * Factory function to create new OverlayFs
+ */
+function newOverlayFs(options) {
+    return new OverlayFs(options);
+}
+/**
+ * Create OverlayFs from raw options
+ */
+function createOverlayFs(opts) {
+    const options = new overlayoptions_1.OverlayOptions(opts);
+    return new OverlayFs(options);
+}
+//# sourceMappingURL=overlayfs.js.map