@depup/jsonjoy.com__fs-node-to-fsa 4.56.11-depup.0

package/lib/NodeFileSystemHandle.d.ts

@@ -0,0 +1,37 @@
+import { NodePermissionStatus } from './NodePermissionStatus';
+import type { IFileSystemHandle, FileSystemHandlePermissionDescriptor } from '@jsonjoy.com/fs-fsa';
+import type { NodeFsaFs, NodeFsaContext } from './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;
+    protected abstract readonly fs: NodeFsaFs;
+    protected abstract readonly __path: string;
+    protected abstract readonly ctx: NodeFsaContext;
+    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: IFileSystemHandle): boolean;
+    /**
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemHandle/queryPermission
+     */
+    queryPermission(fileSystemHandlePermissionDescriptor: FileSystemHandlePermissionDescriptor): Promise<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/NodeFileSystemHandle.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NodeFileSystemHandle = void 0;
+const NodePermissionStatus_1 = require("./NodePermissionStatus");
+/**
+ * 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
+     */
+    async queryPermission(fileSystemHandlePermissionDescriptor) {
+        const { mode } = fileSystemHandlePermissionDescriptor;
+        // Check if the requested mode is compatible with the context mode
+        const requestedMode = mode;
+        const contextMode = this.ctx.mode;
+        // If requesting readwrite but context only allows read, deny
+        if (requestedMode === 'readwrite' && contextMode === 'read') {
+            return new NodePermissionStatus_1.NodePermissionStatus(requestedMode, 'denied');
+        }
+        try {
+            // Use Node.js fs.promises.access() to check permissions asynchronously
+            let accessMode = 0 /* AMODE.F_OK */;
+            if (mode === 'read') {
+                accessMode = 4 /* AMODE.R_OK */;
+            }
+            else if (mode === 'readwrite') {
+                accessMode = 4 /* AMODE.R_OK */ | 2 /* AMODE.W_OK */;
+            }
+            // Use asynchronous access check
+            await this.fs.promises.access(this.__path, accessMode);
+            return new NodePermissionStatus_1.NodePermissionStatus(mode, 'granted');
+        }
+        catch (error) {
+            // If access check fails, permission is denied
+            return new NodePermissionStatus_1.NodePermissionStatus(mode, 'denied');
+        }
+    }
+    /**
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemHandle/remove
+     */
+    async remove({ recursive } = { recursive: false }) {
+        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;
+//# sourceMappingURL=NodeFileSystemHandle.js.map

package/lib/NodeFileSystemHandle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeFileSystemHandle.js","sourceRoot":"","sources":["../src/NodeFileSystemHandle.ts"],"names":[],"mappings":";;;AACA,iEAA8D;AAI9D;;;;;GAKG;AACH,MAAsB,oBAAoB;IAKxC,YACkB,IAA0B,EAC1B,IAAY;QADZ,SAAI,GAAJ,IAAI,CAAsB;QAC1B,SAAI,GAAJ,IAAI,CAAQ;IAC3B,CAAC;IAEJ;;;;OAIG;IACI,WAAW,CAAC,gBAAmC;QACpD,OAAO,CACL,IAAI,CAAC,WAAW,KAAK,gBAAgB,CAAC,WAAW,IAAK,IAAY,CAAC,MAAM,KAAM,gBAAwB,CAAC,MAAM,CAC/G,CAAC;IACJ,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,eAAe,CAC1B,oCAA0E;QAE1E,MAAM,EAAE,IAAI,EAAE,GAAG,oCAAoC,CAAC;QAEtD,kEAAkE;QAClE,MAAM,aAAa,GAAG,IAAI,CAAC;QAC3B,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;QAElC,6DAA6D;QAC7D,IAAI,aAAa,KAAK,WAAW,IAAI,WAAW,KAAK,MAAM,EAAE,CAAC;YAC5D,OAAO,IAAI,2CAAoB,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;QAC3D,CAAC;QAED,IAAI,CAAC;YACH,uEAAuE;YACvE,IAAI,UAAU,qBAAa,CAAC;YAE5B,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;gBACpB,UAAU,qBAAa,CAAC;YAC1B,CAAC;iBAAM,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;gBAChC,UAAU,GAAG,uCAAuB,CAAC;YACvC,CAAC;YAED,gCAAgC;YAChC,MAAM,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;YAEvD,OAAO,IAAI,2CAAoB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QACnD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,8CAA8C;YAC9C,OAAO,IAAI,2CAAoB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,MAAM,CAAC,EAAE,SAAS,KAA8B,EAAE,SAAS,EAAE,KAAK,EAAE;QAC/E,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACrC,CAAC;IAED;;OAEG;IACI,iBAAiB,CACtB,oCAA0E;QAE1E,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACrC,CAAC;CACF;AAzED,oDAyEC"}

package/lib/NodeFileSystemSyncAccessHandle.d.ts

@@ -0,0 +1,42 @@
+import type { FileSystemReadWriteOptions, IFileSystemSyncAccessHandle } from '@jsonjoy.com/fs-fsa';
+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/NodeFileSystemSyncAccessHandle.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NodeFileSystemSyncAccessHandle = void 0;
+const util_1 = require("./util");
+const buffer_1 = require("@jsonjoy.com/fs-node-builtins/lib/internal/buffer");
+/**
+ * @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+');
+        this.ctx.locks.acquireLock(this.path);
+    }
+    /**
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemSyncAccessHandle/close
+     */
+    async close() {
+        (0, util_1.assertCanWrite)(this.ctx.mode);
+        this.fs.closeSync(this.fd);
+        this.ctx.locks.releaseLock(this.path);
+    }
+    /**
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemSyncAccessHandle/flush
+     */
+    async flush() {
+        (0, util_1.assertCanWrite)(this.ctx.mode);
+        this.fs.fsyncSync(this.fd);
+    }
+    /**
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemSyncAccessHandle/getSize
+     */
+    async getSize() {
+        return this.fs.statSync(this.path).size;
+    }
+    /**
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemSyncAccessHandle/read
+     */
+    async read(buffer, options = {}) {
+        const buf = buffer instanceof ArrayBuffer ? buffer_1.Buffer.from(buffer) : buffer;
+        try {
+            const size = this.fs.readSync(this.fd, buf, 0, buffer.byteLength, options.at ?? 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.
+     */
+    async truncate(newSize) {
+        (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
+     */
+    async write(buffer, options = {}) {
+        (0, util_1.assertCanWrite)(this.ctx.mode);
+        const buf = buffer instanceof ArrayBuffer ? buffer_1.Buffer.from(buffer) : buffer;
+        try {
+            return this.fs.writeSync(this.fd, buf, 0, buffer.byteLength, options.at ?? 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;
+//# sourceMappingURL=NodeFileSystemSyncAccessHandle.js.map

package/lib/NodeFileSystemSyncAccessHandle.js.map

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

package/lib/NodeFileSystemWritableFileStream.d.ts

@@ -0,0 +1,56 @@
+import type { Data, FileSystemWritableFileStreamParams, IFileSystemWritableFileStream } from '@jsonjoy.com/fs-fsa';
+import type { IFileHandle } from '@jsonjoy.com/fs-node-utils/lib/types/misc';
+import type { NodeFsaFs, NodeFsaContext } 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>;
+}
+declare const WS: typeof WritableStream;
+/**
+ * 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 WS implements IFileSystemWritableFileStream {
+    protected readonly fs: NodeFsaFs;
+    protected readonly path: string;
+    protected readonly ctx: NodeFsaContext;
+    protected readonly swap: SwapFile;
+    constructor(fs: NodeFsaFs, path: string, keepExistingData: boolean, ctx: NodeFsaContext);
+    /**
+     * @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 {};

package/lib/NodeFileSystemWritableFileStream.js

@@ -0,0 +1,191 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NodeFileSystemWritableFileStream = exports.createSwapFile = void 0;
+const buffer_1 = require("@jsonjoy.com/fs-node-builtins/lib/internal/buffer");
+const util_1 = require("./util");
+/**
+ * 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.
+ */
+const createSwapFile = async (fs, path, keepExistingData) => {
+    let handle;
+    let swapPath = path + '.crswap';
+    try {
+        handle = await fs.promises.open(swapPath, 'ax');
+    }
+    catch (error) {
+        if (!error || typeof error !== 'object' || error.code !== 'EEXIST')
+            throw error;
+    }
+    if (!handle) {
+        for (let i = 1; i < 1000; i++) {
+            try {
+                swapPath = `${path}.${i}.crswap`;
+                handle = await fs.promises.open(swapPath, 'ax');
+                break;
+            }
+            catch (error) {
+                if (!error || typeof error !== 'object' || error.code !== 'EEXIST')
+                    throw error;
+            }
+        }
+    }
+    if (!handle)
+        throw new Error(`Could not create a swap file for "${path}".`);
+    if (keepExistingData)
+        await fs.promises.copyFile(path, swapPath, fs.constants.COPYFILE_FICLONE);
+    return [handle, swapPath];
+};
+exports.createSwapFile = createSwapFile;
+const WS = (typeof WritableStream === 'undefined' ? require('stream/web').WritableStream : WritableStream);
+/**
+ * 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
+ */
+class NodeFileSystemWritableFileStream extends WS {
+    constructor(fs, path, keepExistingData, ctx) {
+        const swap = { handle: undefined, path: '', offset: 0 };
+        super({
+            async start() {
+                if (ctx.locks.isLocked(path)) {
+                    throw (0, util_1.newNoModificationAllowedError)();
+                }
+                ctx.locks.acquireLock(path);
+                try {
+                    const promise = (0, exports.createSwapFile)(fs, path, keepExistingData);
+                    swap.ready = promise.then(() => undefined);
+                    const [handle, swapPath] = await promise;
+                    swap.handle = handle;
+                    swap.path = swapPath;
+                }
+                catch (error) {
+                    ctx.locks.releaseLock(path);
+                    throw error;
+                }
+            },
+            async write(chunk) {
+                await swap.ready;
+                const handle = swap.handle;
+                if (!handle)
+                    throw new Error('Invalid state');
+                const buffer = buffer_1.Buffer.from(typeof chunk === 'string'
+                    ? chunk
+                    : chunk instanceof Blob
+                        ? new Uint8Array(await chunk.arrayBuffer())
+                        : chunk);
+                const { bytesWritten } = await handle.write(buffer, 0, buffer.length, swap.offset);
+                swap.offset += bytesWritten;
+            },
+            async close() {
+                await swap.ready;
+                const handle = swap.handle;
+                if (!handle)
+                    return;
+                await handle.close();
+                await fs.promises.rename(swap.path, path);
+                ctx.locks.releaseLock(path);
+            },
+            async abort() {
+                await swap.ready;
+                const handle = swap.handle;
+                if (!handle)
+                    return;
+                await handle.close();
+                await fs.promises.unlink(swap.path);
+                ctx.locks.releaseLock(path);
+            },
+        });
+        this.fs = fs;
+        this.path = path;
+        this.ctx = ctx;
+        this.swap = swap;
+    }
+    /**
+     * @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.
+     */
+    async seek(position) {
+        this.swap.offset = position;
+    }
+    /**
+     * @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.
+     */
+    async truncate(size) {
+        await this.swap.ready;
+        const handle = this.swap.handle;
+        if (!handle)
+            throw new Error('Invalid state');
+        await handle.truncate(size);
+        if (this.swap.offset > size)
+            this.swap.offset = size;
+    }
+    async writeBase(chunk) {
+        const writer = this.getWriter();
+        try {
+            await writer.write(chunk);
+        }
+        finally {
+            writer.releaseLock();
+        }
+    }
+    async write(params) {
+        if (!params)
+            throw new TypeError('Missing required argument: params');
+        switch (typeof params) {
+            case 'string': {
+                return this.writeBase(params);
+            }
+            case 'object': {
+                const constructor = params.constructor;
+                switch (constructor) {
+                    case ArrayBuffer:
+                    case Blob:
+                    case DataView:
+                        return this.writeBase(params);
+                    default: {
+                        if (ArrayBuffer.isView(params)) {
+                            return this.writeBase(params);
+                        }
+                        else {
+                            const options = params;
+                            switch (options.type) {
+                                case 'write': {
+                                    if (typeof options.position === 'number')
+                                        await this.seek(options.position);
+                                    return this.writeBase(params.data);
+                                }
+                                case 'truncate': {
+                                    if (typeof params.size !== 'number')
+                                        throw new TypeError('Missing required argument: size');
+                                    if (this.swap.offset > params.size)
+                                        this.swap.offset = params.size;
+                                    return this.truncate(params.size);
+                                }
+                                case 'seek':
+                                    if (typeof params.position !== 'number')
+                                        throw new TypeError('Missing required argument: position');
+                                    return this.seek(params.position);
+                                default:
+                                    throw new TypeError('Invalid argument: params');
+                            }
+                        }
+                    }
+                }
+            }
+            default:
+                throw new TypeError('Invalid argument: params');
+        }
+    }
+}
+exports.NodeFileSystemWritableFileStream = NodeFileSystemWritableFileStream;
+//# sourceMappingURL=NodeFileSystemWritableFileStream.js.map

package/lib/NodeFileSystemWritableFileStream.js.map

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

package/lib/NodePermissionStatus.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @see [MDN Documentation](https://developer.mozilla.org/en-US/docs/Web/API/PermissionStatus)
+ */
+export declare class NodePermissionStatus {
+    readonly name: string;
+    readonly state: 'granted' | 'denied' | 'prompt';
+    constructor(name: string, state: 'granted' | 'denied' | 'prompt');
+}

package/lib/NodePermissionStatus.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NodePermissionStatus = void 0;
+/**
+ * @see [MDN Documentation](https://developer.mozilla.org/en-US/docs/Web/API/PermissionStatus)
+ */
+class NodePermissionStatus {
+    constructor(name, state) {
+        this.name = name;
+        this.state = state;
+    }
+}
+exports.NodePermissionStatus = NodePermissionStatus;
+//# sourceMappingURL=NodePermissionStatus.js.map

package/lib/NodePermissionStatus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodePermissionStatus.js","sourceRoot":"","sources":["../src/NodePermissionStatus.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,MAAa,oBAAoB;IAC/B,YACkB,IAAY,EACZ,KAAsC;QADtC,SAAI,GAAJ,IAAI,CAAQ;QACZ,UAAK,GAAL,KAAK,CAAiC;IACrD,CAAC;CACL;AALD,oDAKC"}

package/lib/index.d.ts

@@ -0,0 +1,7 @@
+import { NodeFileSystemDirectoryHandle } from './NodeFileSystemDirectoryHandle';
+import { NodeFsaContext, NodeFsaFs } from './types';
+export * from './types';
+export * from './NodeFileSystemHandle';
+export * from './NodeFileSystemDirectoryHandle';
+export * from './NodeFileSystemFileHandle';
+export declare const nodeToFsa: (fs: NodeFsaFs, dirPath: string, ctx?: Partial<NodeFsaContext>) => NodeFileSystemDirectoryHandle;

package/lib/index.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.nodeToFsa = void 0;
+const tslib_1 = require("tslib");
+const NodeFileSystemDirectoryHandle_1 = require("./NodeFileSystemDirectoryHandle");
+tslib_1.__exportStar(require("./types"), exports);
+tslib_1.__exportStar(require("./NodeFileSystemHandle"), exports);
+tslib_1.__exportStar(require("./NodeFileSystemDirectoryHandle"), exports);
+tslib_1.__exportStar(require("./NodeFileSystemFileHandle"), exports);
+const nodeToFsa = (fs, dirPath, ctx) => {
+    return new NodeFileSystemDirectoryHandle_1.NodeFileSystemDirectoryHandle(fs, dirPath, ctx);
+};
+exports.nodeToFsa = nodeToFsa;
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;AAAA,mFAAgF;AAGhF,kDAAwB;AACxB,iEAAuC;AACvC,0EAAgD;AAChD,qEAA2C;AAEpC,MAAM,SAAS,GAAG,CACvB,EAAa,EACb,OAAe,EACf,GAA6B,EACE,EAAE;IACjC,OAAO,IAAI,6DAA6B,CAAC,EAAE,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;AAC7D,CAAC,CAAC;AANW,QAAA,SAAS,aAMpB"}

package/lib/types.d.ts

@@ -0,0 +1,18 @@
+import type { FsPromisesApi, FsSynchronousApi } from '@jsonjoy.com/fs-node-utils';
+import type { FsCommonObjects } from '@jsonjoy.com/fs-node-utils/lib/types/FsCommonObjects';
+import type { FileLockManager } from '@jsonjoy.com/fs-fsa';
+/**
+ * Required Node.js `fs` module functions for File System Access API.
+ */
+export type NodeFsaFs = Pick<FsCommonObjects, 'constants'> & {
+    promises: FsPromisesApi;
+} & Pick<FsSynchronousApi, 'openSync' | 'fsyncSync' | 'statSync' | 'closeSync' | 'readSync' | 'truncateSync' | 'writeSync' | 'accessSync'>;
+export interface NodeFsaContext {
+    separator: '/' | '\\';
+    /** Whether synchronous file handles are allowed. */
+    syncHandleAllowed: boolean;
+    /** Whether writes are allowed, defaults to `read`. */
+    mode: 'read' | 'readwrite';
+    /** File lock manager for this context. */
+    locks: FileLockManager;
+}

package/lib/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/lib/util.d.ts

@@ -0,0 +1,12 @@
+import type { NodeFsaContext } from './types';
+export { basename } from '@jsonjoy.com/fs-node-utils';
+/**
+ * Creates a new {@link NodeFsaContext}.
+ */
+export declare const ctx: (partial?: Partial<NodeFsaContext>) => NodeFsaContext;
+export declare const assertName: (name: string, method: string, klass: string) => void;
+export declare const assertCanWrite: (mode: "read" | "readwrite") => void;
+export declare const newNotFoundError: () => DOMException;
+export declare const newTypeMismatchError: () => DOMException;
+export declare const newNotAllowedError: () => DOMException;
+export declare const newNoModificationAllowedError: () => DOMException;