memfs 4.0.0 → 4.1.0

package/lib/node-to-fsa/NodeFileSystemDirectoryHandle.js

@@ -0,0 +1,264 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __await = (this && this.__await) || function (v) { return this instanceof __await ? (this.v = v, this) : new __await(v); }
+var __asyncGenerator = (this && this.__asyncGenerator) || function (thisArg, _arguments, generator) {
+    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
+    var g = generator.apply(thisArg, _arguments || []), i, q = [];
+    return i = {}, verb("next"), verb("throw"), verb("return"), i[Symbol.asyncIterator] = function () { return this; }, i;
+    function verb(n) { if (g[n]) i[n] = function (v) { return new Promise(function (a, b) { q.push([n, v, a, b]) > 1 || resume(n, v); }); }; }
+    function resume(n, v) { try { step(g[n](v)); } catch (e) { settle(q[0][3], e); } }
+    function step(r) { r.value instanceof __await ? Promise.resolve(r.value.v).then(fulfill, reject) : settle(q[0][2], r); }
+    function fulfill(value) { resume("next", value); }
+    function reject(value) { resume("throw", value); }
+    function settle(f, v) { if (f(v), q.shift(), q.length) resume(q[0][0], q[0][1]); }
+};
+var __asyncValues = (this && this.__asyncValues) || function (o) {
+    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
+    var m = o[Symbol.asyncIterator], i;
+    return m ? m.call(o) : (o = typeof __values === "function" ? __values(o) : o[Symbol.iterator](), i = {}, verb("next"), verb("throw"), verb("return"), i[Symbol.asyncIterator] = function () { return this; }, i);
+    function verb(n) { i[n] = o[n] && function (v) { return new Promise(function (resolve, reject) { v = o[n](v), settle(resolve, reject, v.done, v.value); }); }; }
+    function settle(resolve, reject, d, v) { Promise.resolve(v).then(function(v) { resolve({ value: v, done: d }); }, reject); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NodeFileSystemDirectoryHandle = void 0;
+const NodeFileSystemHandle_1 = require("./NodeFileSystemHandle");
+const util_1 = require("./util");
+const NodeFileSystemFileHandle_1 = require("./NodeFileSystemFileHandle");
+/**
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemDirectoryHandle
+ */
+class NodeFileSystemDirectoryHandle extends NodeFileSystemHandle_1.NodeFileSystemHandle {
+    constructor(fs, __path, ctx = {}) {
+        super('directory', (0, util_1.basename)(__path, ctx.separator || '/'));
+        this.fs = fs;
+        this.__path = __path;
+        this.ctx = (0, util_1.ctx)(ctx);
+    }
+    /**
+     * Returns a new array iterator containing the keys for each item in
+     * {@link NodeFileSystemDirectoryHandle} object.
+     *
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemDirectoryHandle/keys
+     */
+    keys() {
+        return __asyncGenerator(this, arguments, function* keys_1() {
+            const list = yield __await(this.fs.promises.readdir(this.__path));
+            for (const name of list)
+                yield yield __await('' + name);
+        });
+    }
+    /**
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemDirectoryHandle/entries
+     */
+    entries() {
+        return __asyncGenerator(this, arguments, function* entries_1() {
+            const { __path: path, fs, ctx } = this;
+            const list = yield __await(fs.promises.readdir(path, { withFileTypes: true }));
+            for (const d of list) {
+                const dirent = d;
+                const name = dirent.name + '';
+                const newPath = path + ctx.separator + name;
+                if (dirent.isDirectory())
+                    yield yield __await([name, new NodeFileSystemDirectoryHandle(fs, newPath, ctx)]);
+                else if (dirent.isFile())
+                    yield yield __await([name, new NodeFileSystemFileHandle_1.NodeFileSystemFileHandle(fs, name, ctx)]);
+            }
+        });
+    }
+    /**
+     * Returns a new array iterator containing the values for each index in the
+     * {@link FileSystemDirectoryHandle} object.
+     *
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemDirectoryHandle/values
+     */
+    values() {
+        return __asyncGenerator(this, arguments, function* values_1() {
+            var _a, e_1, _b, _c;
+            try {
+                for (var _d = true, _e = __asyncValues(this.entries()), _f; _f = yield __await(_e.next()), _a = _f.done, !_a;) {
+                    _c = _f.value;
+                    _d = false;
+                    try {
+                        const [, value] = _c;
+                        yield yield __await(value);
+                    }
+                    finally {
+                        _d = true;
+                    }
+                }
+            }
+            catch (e_1_1) { e_1 = { error: e_1_1 }; }
+            finally {
+                try {
+                    if (!_d && !_a && (_b = _e.return)) yield __await(_b.call(_e));
+                }
+                finally { if (e_1) throw e_1.error; }
+            }
+        });
+    }
+    /**
+     * Returns a {@link NodeFileSystemDirectoryHandle} for a subdirectory with the specified
+     * name within the directory handle on which the method is called.
+     *
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemDirectoryHandle/getDirectoryHandle
+     * @param name A string representing the {@link NodeFileSystemHandle} name of
+     *        the subdirectory you wish to retrieve.
+     * @param options An optional object containing options for the retrieved
+     *        subdirectory.
+     */
+    getDirectoryHandle(name, options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            (0, util_1.assertName)(name, 'getDirectoryHandle', 'FileSystemDirectoryHandle');
+            const filename = this.__path + this.ctx.separator + name;
+            try {
+                const stats = yield this.fs.promises.stat(filename);
+                if (!stats.isDirectory())
+                    throw (0, util_1.newTypeMismatchError)();
+                return new NodeFileSystemDirectoryHandle(this.fs, filename, this.ctx);
+            }
+            catch (error) {
+                if (error instanceof DOMException)
+                    throw error;
+                if (error && typeof error === 'object') {
+                    switch (error.code) {
+                        case 'ENOENT': {
+                            if (options === null || options === void 0 ? void 0 : options.create) {
+                                (0, util_1.assertCanWrite)(this.ctx.mode);
+                                yield this.fs.promises.mkdir(filename);
+                                return new NodeFileSystemDirectoryHandle(this.fs, filename, this.ctx);
+                            }
+                            throw (0, util_1.newNotFoundError)();
+                        }
+                        case 'EPERM':
+                        case 'EACCES':
+                            throw (0, util_1.newNotAllowedError)();
+                    }
+                }
+                throw error;
+            }
+        });
+    }
+    /**
+     * Returns a {@link FileSystemFileHandle} for a file with the specified name,
+     * within the directory the method is called.
+     *
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemDirectoryHandle/getFileHandle
+     * @param name A string representing the {@link NodeFileSystemHandle} name of
+     *        the file you wish to retrieve.
+     * @param options An optional object containing options for the retrieved file.
+     */
+    getFileHandle(name, options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            (0, util_1.assertName)(name, 'getFileHandle', 'FileSystemDirectoryHandle');
+            const filename = this.__path + this.ctx.separator + name;
+            try {
+                const stats = yield this.fs.promises.stat(filename);
+                if (!stats.isFile())
+                    throw (0, util_1.newTypeMismatchError)();
+                return new NodeFileSystemFileHandle_1.NodeFileSystemFileHandle(this.fs, filename, this.ctx);
+            }
+            catch (error) {
+                if (error instanceof DOMException)
+                    throw error;
+                if (error && typeof error === 'object') {
+                    switch (error.code) {
+                        case 'ENOENT': {
+                            if (options === null || options === void 0 ? void 0 : options.create) {
+                                (0, util_1.assertCanWrite)(this.ctx.mode);
+                                yield this.fs.promises.writeFile(filename, '');
+                                return new NodeFileSystemFileHandle_1.NodeFileSystemFileHandle(this.fs, filename, this.ctx);
+                            }
+                            throw (0, util_1.newNotFoundError)();
+                        }
+                        case 'EPERM':
+                        case 'EACCES':
+                            throw (0, util_1.newNotAllowedError)();
+                    }
+                }
+                throw error;
+            }
+        });
+    }
+    /**
+     * Attempts to remove an entry if the directory handle contains a file or
+     * directory called the name specified.
+     *
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemDirectoryHandle/removeEntry
+     * @param name A string representing the {@link FileSystemHandle} name of the
+     *        entry you wish to remove.
+     * @param options An optional object containing options.
+     */
+    removeEntry(name, { recursive = false } = {}) {
+        return __awaiter(this, void 0, void 0, function* () {
+            (0, util_1.assertCanWrite)(this.ctx.mode);
+            (0, util_1.assertName)(name, 'removeEntry', 'FileSystemDirectoryHandle');
+            const filename = this.__path + this.ctx.separator + name;
+            const promises = this.fs.promises;
+            try {
+                const stats = yield promises.stat(filename);
+                if (stats.isFile()) {
+                    yield promises.unlink(filename);
+                }
+                else if (stats.isDirectory()) {
+                    yield promises.rmdir(filename, { recursive });
+                }
+                else
+                    throw (0, util_1.newTypeMismatchError)();
+            }
+            catch (error) {
+                if (error instanceof DOMException)
+                    throw error;
+                if (error && typeof error === 'object') {
+                    switch (error.code) {
+                        case 'ENOENT': {
+                            throw (0, util_1.newNotFoundError)();
+                        }
+                        case 'EPERM':
+                        case 'EACCES':
+                            throw (0, util_1.newNotAllowedError)();
+                        case 'ENOTEMPTY':
+                            throw new DOMException('The object can not be modified in this way.', 'InvalidModificationError');
+                    }
+                }
+                throw error;
+            }
+        });
+    }
+    /**
+     * The `resolve()` method of the {@link FileSystemDirectoryHandle} interface
+     * returns an {@link Array} of directory names from the parent handle to the specified
+     * child entry, with the name of the child entry as the last array item.
+     *
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemDirectoryHandle/resolve
+     * @param possibleDescendant The {@link NodeFileSystemFileHandle} from which
+     *        to return the relative path.
+     */
+    resolve(possibleDescendant) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (possibleDescendant instanceof NodeFileSystemDirectoryHandle ||
+                possibleDescendant instanceof NodeFileSystemFileHandle_1.NodeFileSystemFileHandle) {
+                const path = this.__path;
+                const childPath = possibleDescendant.__path;
+                if (!childPath.startsWith(path))
+                    return null;
+                let relative = childPath.slice(path.length);
+                if (relative === '')
+                    return [];
+                const separator = this.ctx.separator;
+                if (relative[0] === separator)
+                    relative = relative.slice(1);
+                return relative.split(separator);
+            }
+            return null;
+        });
+    }
+}
+exports.NodeFileSystemDirectoryHandle = NodeFileSystemDirectoryHandle;

package/lib/node-to-fsa/NodeFileSystemFileHandle.d.ts

@@ -0,0 +1,28 @@
+import { NodeFileSystemHandle } from './NodeFileSystemHandle';
+import { NodeFileSystemWritableFileStream } from './NodeFileSystemWritableFileStream';
+import type { NodeFsaContext, NodeFsaFs } from './types';
+import type { IFileSystemFileHandle, IFileSystemSyncAccessHandle } from '../fsa/types';
+export declare class NodeFileSystemFileHandle extends NodeFileSystemHandle implements IFileSystemFileHandle {
+    protected readonly fs: NodeFsaFs;
+    readonly __path: string;
+    protected readonly ctx: NodeFsaContext;
+    constructor(fs: NodeFsaFs, __path: string, ctx?: Partial<NodeFsaContext>);
+    /**
+     * Returns a {@link Promise} which resolves to a {@link File} object
+     * representing the state on disk of the entry represented by the handle.
+     *
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemFileHandle/getFile
+     */
+    getFile(): Promise<File>;
+    /**
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemFileHandle/createSyncAccessHandle
+     */
+    get createSyncAccessHandle(): undefined | (() => Promise<IFileSystemSyncAccessHandle>);
+    /**
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemFileHandle/createWritable
+     */
+    createWritable({ keepExistingData }?: CreateWritableOptions): Promise<NodeFileSystemWritableFileStream>;
+}
+export interface CreateWritableOptions {
+    keepExistingData?: boolean;
+}

package/lib/node-to-fsa/NodeFileSystemFileHandle.js

@@ -0,0 +1,73 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NodeFileSystemFileHandle = void 0;
+const NodeFileSystemHandle_1 = require("./NodeFileSystemHandle");
+const NodeFileSystemSyncAccessHandle_1 = require("./NodeFileSystemSyncAccessHandle");
+const util_1 = require("./util");
+const NodeFileSystemWritableFileStream_1 = require("./NodeFileSystemWritableFileStream");
+class NodeFileSystemFileHandle extends NodeFileSystemHandle_1.NodeFileSystemHandle {
+    constructor(fs, __path, ctx = {}) {
+        ctx = (0, util_1.ctx)(ctx);
+        super('file', (0, util_1.basename)(__path, ctx.separator));
+        this.fs = fs;
+        this.__path = __path;
+        this.ctx = ctx;
+    }
+    /**
+     * Returns a {@link Promise} which resolves to a {@link File} object
+     * representing the state on disk of the entry represented by the handle.
+     *
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemFileHandle/getFile
+     */
+    getFile() {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const path = this.__path;
+                const promises = this.fs.promises;
+                const stats = yield promises.stat(path);
+                const data = yield promises.readFile(path);
+                const file = new File([data], this.name, { lastModified: stats.mtime.getTime() });
+                return file;
+            }
+            catch (error) {
+                if (error instanceof DOMException)
+                    throw error;
+                if (error && typeof error === 'object') {
+                    switch (error.code) {
+                        case 'EPERM':
+                        case 'EACCES':
+                            throw (0, util_1.newNotAllowedError)();
+                    }
+                }
+                throw error;
+            }
+        });
+    }
+    /**
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemFileHandle/createSyncAccessHandle
+     */
+    get createSyncAccessHandle() {
+        if (!this.ctx.syncHandleAllowed)
+            return undefined;
+        return () => __awaiter(this, void 0, void 0, function* () { return new NodeFileSystemSyncAccessHandle_1.NodeFileSystemSyncAccessHandle(this.fs, this.__path, this.ctx); });
+    }
+    /**
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemFileHandle/createWritable
+     */
+    createWritable({ keepExistingData = false } = { keepExistingData: false }) {
+        return __awaiter(this, void 0, void 0, function* () {
+            (0, util_1.assertCanWrite)(this.ctx.mode);
+            return new NodeFileSystemWritableFileStream_1.NodeFileSystemWritableFileStream(this.fs, this.__path, keepExistingData);
+        });
+    }
+}
+exports.NodeFileSystemFileHandle = NodeFileSystemFileHandle;

package/lib/node-to-fsa/NodeFileSystemHandle.d.ts

@@ -0,0 +1,33 @@
+import { NodePermissionStatus } from './NodePermissionStatus';
+import type { IFileSystemHandle, FileSystemHandlePermissionDescriptor } from '../fsa/types';
+/**
+ * Represents a File System Access API file handle `FileSystemHandle` object,
+ * which was created from a Node.js `fs` module.
+ *
+ * @see [MDN Documentation](https://developer.mozilla.org/en-US/docs/Web/API/FileSystemHandle)
+ */
+export declare abstract class NodeFileSystemHandle implements IFileSystemHandle {
+    readonly kind: 'file' | 'directory';
+    readonly name: string;
+    constructor(kind: 'file' | 'directory', name: string);
+    /**
+     * Compares two handles to see if the associated entries (either a file or directory) match.
+     *
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemHandle/isSameEntry
+     */
+    isSameEntry(fileSystemHandle: NodeFileSystemHandle): boolean;
+    /**
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemHandle/queryPermission
+     */
+    queryPermission(fileSystemHandlePermissionDescriptor: FileSystemHandlePermissionDescriptor): NodePermissionStatus;
+    /**
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemHandle/remove
+     */
+    remove({ recursive }?: {
+        recursive?: boolean;
+    }): Promise<void>;
+    /**
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemHandle/requestPermission
+     */
+    requestPermission(fileSystemHandlePermissionDescriptor: FileSystemHandlePermissionDescriptor): NodePermissionStatus;
+}

package/lib/node-to-fsa/NodeFileSystemHandle.js

@@ -0,0 +1,53 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NodeFileSystemHandle = void 0;
+/**
+ * Represents a File System Access API file handle `FileSystemHandle` object,
+ * which was created from a Node.js `fs` module.
+ *
+ * @see [MDN Documentation](https://developer.mozilla.org/en-US/docs/Web/API/FileSystemHandle)
+ */
+class NodeFileSystemHandle {
+    constructor(kind, name) {
+        this.kind = kind;
+        this.name = name;
+    }
+    /**
+     * Compares two handles to see if the associated entries (either a file or directory) match.
+     *
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemHandle/isSameEntry
+     */
+    isSameEntry(fileSystemHandle) {
+        return (this.constructor === fileSystemHandle.constructor && this.__path === fileSystemHandle.__path);
+    }
+    /**
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemHandle/queryPermission
+     */
+    queryPermission(fileSystemHandlePermissionDescriptor) {
+        throw new Error('Not implemented');
+    }
+    /**
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemHandle/remove
+     */
+    remove({ recursive } = { recursive: false }) {
+        return __awaiter(this, void 0, void 0, function* () {
+            throw new Error('Not implemented');
+        });
+    }
+    /**
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemHandle/requestPermission
+     */
+    requestPermission(fileSystemHandlePermissionDescriptor) {
+        throw new Error('Not implemented');
+    }
+}
+exports.NodeFileSystemHandle = NodeFileSystemHandle;

package/lib/node-to-fsa/NodeFileSystemSyncAccessHandle.d.ts

@@ -0,0 +1,42 @@
+import type { FileSystemReadWriteOptions, IFileSystemSyncAccessHandle } from '../fsa/types';
+import type { NodeFsaContext, NodeFsaFs } from './types';
+/**
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemSyncAccessHandle
+ */
+export declare class NodeFileSystemSyncAccessHandle implements IFileSystemSyncAccessHandle {
+    protected readonly fs: NodeFsaFs;
+    protected readonly path: string;
+    protected readonly ctx: NodeFsaContext;
+    protected readonly fd: number;
+    constructor(fs: NodeFsaFs, path: string, ctx: NodeFsaContext);
+    /**
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemSyncAccessHandle/close
+     */
+    close(): Promise<void>;
+    /**
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemSyncAccessHandle/flush
+     */
+    flush(): Promise<void>;
+    /**
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemSyncAccessHandle/getSize
+     */
+    getSize(): Promise<number>;
+    /**
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemSyncAccessHandle/read
+     */
+    read(buffer: ArrayBuffer | ArrayBufferView, options?: FileSystemReadWriteOptions): Promise<number>;
+    /**
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemSyncAccessHandle/truncate
+     * @param newSize The number of bytes to resize the file to.
+     */
+    truncate(newSize: number): Promise<void>;
+    /**
+     * Writes the content of a specified buffer to the file associated with the
+     * handle, optionally at a given offset.
+     *
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemSyncAccessHandle/write
+     * @param buffer
+     * @param options
+     */
+    write(buffer: ArrayBuffer | ArrayBufferView | DataView, options?: FileSystemReadWriteOptions): Promise<number>;
+}

package/lib/node-to-fsa/NodeFileSystemSyncAccessHandle.js

@@ -0,0 +1,116 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NodeFileSystemSyncAccessHandle = void 0;
+const util_1 = require("./util");
+/**
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemSyncAccessHandle
+ */
+class NodeFileSystemSyncAccessHandle {
+    constructor(fs, path, ctx) {
+        this.fs = fs;
+        this.path = path;
+        this.ctx = ctx;
+        this.fd = fs.openSync(path, 'r+');
+    }
+    /**
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemSyncAccessHandle/close
+     */
+    close() {
+        return __awaiter(this, void 0, void 0, function* () {
+            (0, util_1.assertCanWrite)(this.ctx.mode);
+            this.fs.closeSync(this.fd);
+        });
+    }
+    /**
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemSyncAccessHandle/flush
+     */
+    flush() {
+        return __awaiter(this, void 0, void 0, function* () {
+            (0, util_1.assertCanWrite)(this.ctx.mode);
+            this.fs.fsyncSync(this.fd);
+        });
+    }
+    /**
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemSyncAccessHandle/getSize
+     */
+    getSize() {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.fs.statSync(this.path).size;
+        });
+    }
+    /**
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemSyncAccessHandle/read
+     */
+    read(buffer, options = {}) {
+        var _a;
+        return __awaiter(this, void 0, void 0, function* () {
+            const buf = buffer instanceof ArrayBuffer ? Buffer.from(buffer) : buffer;
+            try {
+                const size = this.fs.readSync(this.fd, buf, 0, buffer.byteLength, (_a = options.at) !== null && _a !== void 0 ? _a : 0);
+                return size;
+            }
+            catch (error) {
+                if (error instanceof DOMException)
+                    throw error;
+                if (error && typeof error === 'object') {
+                    switch (error.code) {
+                        case 'EBADF': {
+                            throw new DOMException('File handle already closed.', 'InvalidStateError');
+                        }
+                    }
+                }
+                throw error;
+            }
+        });
+    }
+    /**
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemSyncAccessHandle/truncate
+     * @param newSize The number of bytes to resize the file to.
+     */
+    truncate(newSize) {
+        return __awaiter(this, void 0, void 0, function* () {
+            (0, util_1.assertCanWrite)(this.ctx.mode);
+            this.fs.truncateSync(this.fd, newSize);
+        });
+    }
+    /**
+     * Writes the content of a specified buffer to the file associated with the
+     * handle, optionally at a given offset.
+     *
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemSyncAccessHandle/write
+     * @param buffer
+     * @param options
+     */
+    write(buffer, options = {}) {
+        var _a;
+        return __awaiter(this, void 0, void 0, function* () {
+            (0, util_1.assertCanWrite)(this.ctx.mode);
+            const buf = buffer instanceof ArrayBuffer ? Buffer.from(buffer) : buffer;
+            try {
+                return this.fs.writeSync(this.fd, buf, 0, buffer.byteLength, (_a = options.at) !== null && _a !== void 0 ? _a : 0);
+            }
+            catch (error) {
+                if (error instanceof DOMException)
+                    throw error;
+                if (error && typeof error === 'object') {
+                    switch (error.code) {
+                        case 'EBADF': {
+                            throw new DOMException('File handle already closed.', 'InvalidStateError');
+                        }
+                    }
+                }
+                throw error;
+            }
+        });
+    }
+}
+exports.NodeFileSystemSyncAccessHandle = NodeFileSystemSyncAccessHandle;

package/lib/node-to-fsa/NodeFileSystemWritableFileStream.d.ts

@@ -0,0 +1,54 @@
+import type { Data, FileSystemWritableFileStreamParams, IFileSystemWritableFileStream } from '../fsa/types';
+import type { IFileHandle } from '../node/types/misc';
+import type { NodeFsaFs } from './types';
+/**
+ * When Chrome writes to the file, it creates a copy of the file with extension
+ * `.crswap` and then replaces the original file with the copy only when the
+ * `close()` method is called. If the `abort()` method is called, the `.crswap`
+ * file is deleted.
+ *
+ * If a file name with with extension `.crswap` is already taken, it
+ * creates a new swap file with extension `.1.crswap` and so on.
+ */
+export declare const createSwapFile: (fs: NodeFsaFs, path: string, keepExistingData: boolean) => Promise<[handle: IFileHandle, path: string]>;
+interface SwapFile {
+    /** Swap file full path name. */
+    path: string;
+    /** Seek offset in the file. */
+    offset: number;
+    /** Node.js open FileHandle. */
+    handle?: IFileHandle;
+    /** Resolves when swap file is ready for operations. */
+    ready?: Promise<void>;
+}
+/**
+ * Is a WritableStream object with additional convenience methods, which
+ * operates on a single file on disk. The interface is accessed through the
+ * `FileSystemFileHandle.createWritable()` method.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemWritableFileStream
+ */
+export declare class NodeFileSystemWritableFileStream extends WritableStream implements IFileSystemWritableFileStream {
+    protected readonly fs: NodeFsaFs;
+    protected readonly path: string;
+    protected readonly swap: SwapFile;
+    constructor(fs: NodeFsaFs, path: string, keepExistingData: boolean);
+    /**
+     * @sse https://developer.mozilla.org/en-US/docs/Web/API/FileSystemWritableFileStream/seek
+     * @param position An `unsigned long` describing the byte position from the top
+     *                 (beginning) of the file.
+     */
+    seek(position: number): Promise<void>;
+    /**
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemWritableFileStream/truncate
+     * @param size An `unsigned long` of the amount of bytes to resize the stream to.
+     */
+    truncate(size: number): Promise<void>;
+    protected writeBase(chunk: Data): Promise<void>;
+    /**
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemWritableFileStream/write
+     */
+    write(chunk: Data): Promise<void>;
+    write(params: FileSystemWritableFileStreamParams): Promise<void>;
+}
+export {};