@zenfs/core 0.9.6 → 0.9.7

package/dist/file.d.ts

@@ -49,11 +49,11 @@ export declare abstract class File {
     /**
      * Get the current file position.
      */
-    abstract position?: number;
+    abstract position: number;
     /**
      * The path to the file
      */
-    abstract readonly path?: string;
+    abstract readonly path: string;
     /**
      * Asynchronous `stat`.
      */
@@ -99,7 +99,7 @@ export declare abstract class File {
      *   the current position.
      * @returns Promise resolving to the new length of the buffer
      */
-    abstract write(buffer: Uint8Array, offset?: number, length?: number, position?: number): Promise<number>;
+    abstract write(buffer: Uint8Array, offset?: number, length?: number, position?: number | null): Promise<number>;
     /**
      * Write buffer to the file.
      * Note that it is unsafe to use fs.writeSync multiple times on the same file
@@ -112,7 +112,7 @@ export declare abstract class File {
      *   data should be written. If position is null, the data will be written at
      *   the current position.
      */
-    abstract writeSync(buffer: Uint8Array, offset?: number, length?: number, position?: number): number;
+    abstract writeSync(buffer: Uint8Array, offset?: number, length?: number, position?: number | null): number;
     /**
      * Read data from the file.
      * @param buffer The buffer that the data will be

package/dist/file.js

@@ -15,7 +15,7 @@ export var ActionType;
     ActionType[ActionType["TRUNCATE"] = 2] = "TRUNCATE";
     // Indicates that the code should create the file.
     ActionType[ActionType["CREATE"] = 3] = "CREATE";
-})(ActionType = ActionType || (ActionType = {}));
+})(ActionType || (ActionType = {}));
 const validFlags = ['r', 'r+', 'rs', 'rs+', 'w', 'wx', 'w+', 'wx+', 'a', 'ax', 'a+', 'ax+'];
 export function parseFlag(flag) {
     if (typeof flag === 'number') {
@@ -263,7 +263,7 @@ export class PreloadFile extends File {
      * Asynchronous truncate.
      * @param len
      */
-    truncate(len) {
+    async truncate(len) {
         this.truncateSync(len);
         if (isSynchronous(this.flag)) {
             return this.sync();
@@ -308,7 +308,9 @@ export class PreloadFile extends File {
      *   the current position.
      */
     async write(buffer, offset = 0, length = this.stats.size, position = 0) {
-        return this.writeSync(buffer, offset, length, position);
+        const bytesWritten = this.writeSync(buffer, offset, length, position);
+        await this.sync();
+        return bytesWritten;
     }
     /**
      * Write buffer to the file.
@@ -380,7 +382,7 @@ export class PreloadFile extends File {
      *   position.
      * @returns number of bytes written
      */
-    readSync(buffer, offset = 0, length = this.stats.size, position = 0) {
+    readSync(buffer, offset = 0, length = this.stats.size, position) {
         if (!isReadable(this.flag)) {
             throw new ApiError(ErrorCode.EPERM, 'File not opened with a readable mode.');
         }
@@ -396,7 +398,7 @@ export class PreloadFile extends File {
             // No copy/read. Return immediatly for better performance
             return bytesRead;
         }
-        new Uint8Array(buffer.buffer).set(this._buffer.slice(position, end), offset);
+        new Uint8Array(buffer.buffer, 0, length).set(this._buffer.slice(position, end), offset);
         return bytesRead;
     }
     /**

package/dist/filesystem.d.ts

@@ -1,7 +1,7 @@
 import { type Cred } from './cred.js';
 import { type File } from './file.js';
 import type { Stats } from './stats.js';
-export type FileContents = Uint8Array | string;
+export type FileContents = ArrayBufferView | string;
 /**
  * Metadata about a FileSystem
  */

package/dist/filesystem.js

@@ -58,6 +58,7 @@ export class FileSystem {
 /**
  * Implements the asynchronous API in terms of the synchronous API.
  */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
 export function Sync(FS) {
     class _SyncFileSystem extends FS {
         async exists(path, cred) {
@@ -108,6 +109,7 @@ export function Sync(FS) {
  *   the synchronous store, if desired.
  *
  */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
 export function Async(FS) {
     class _AsyncFileSystem extends FS {
         constructor() {
@@ -241,6 +243,7 @@ export function Async(FS) {
 /**
  * Implements the non-readonly methods to throw `EROFS`
  */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
 export function Readonly(FS) {
     class _ReadonlyFileSystem extends FS {
         metadata() {

package/dist/mutex.js

@@ -12,7 +12,7 @@ export class Mutex {
                 this._locks.get(path).push(resolve);
             }
             else {
-                this._locks.set(path, []);
+                this._locks.set(path, [resolve]);
             }
         });
     }
@@ -20,7 +20,7 @@ export class Mutex {
         if (!this._locks.has(path)) {
             throw new Error('unlock of a non-locked mutex');
         }
-        const next = this._locks.get(path).shift();
+        const next = this._locks.get(path)?.shift();
         /*
             don't unlock - we want to queue up next for the
             end of the current task execution, but we don't

package/dist/stats.d.ts

@@ -5,9 +5,9 @@ import { Cred } from './cred.js';
  * Indicates the type of the given file. Applied to 'mode'.
  */
 export declare enum FileType {
-    FILE,
-    DIRECTORY,
-    SYMLINK
+    FILE = 32768,
+    DIRECTORY = 16384,
+    SYMLINK = 40960
 }
 /**
  *
@@ -173,6 +173,10 @@ export declare abstract class StatsCommon<T extends number | bigint> implements
      * @internal
      */
     chown(uid: number | bigint, gid: number | bigint): void;
+    get atimeNs(): bigint;
+    get mtimeNs(): bigint;
+    get ctimeNs(): bigint;
+    get birthtimeNs(): bigint;
 }
 /**
  * Implementation of Node's `Stats`.
@@ -195,10 +199,6 @@ export declare class Stats extends StatsCommon<number> implements Node.Stats, St
  */
 export declare class BigIntStats extends StatsCommon<bigint> implements Node.BigIntStats, StatsLike {
     protected _isBigint: boolean;
-    atimeNs: bigint;
-    mtimeNs: bigint;
-    ctimeNs: bigint;
-    birthtimeNs: bigint;
     /**
      * Clone a stats object.
      * @deprecated use `new BigIntStats(stats)`

package/dist/stats.js

@@ -4,10 +4,10 @@ import { S_IFDIR, S_IFLNK, S_IFMT, S_IFREG, S_IRWXG, S_IRWXO, S_IRWXU } from './
  */
 export var FileType;
 (function (FileType) {
-    FileType[FileType["FILE"] = S_IFREG] = "FILE";
-    FileType[FileType["DIRECTORY"] = S_IFDIR] = "DIRECTORY";
-    FileType[FileType["SYMLINK"] = S_IFLNK] = "SYMLINK";
-})(FileType = FileType || (FileType = {}));
+    FileType[FileType["FILE"] = 32768] = "FILE";
+    FileType[FileType["DIRECTORY"] = 16384] = "DIRECTORY";
+    FileType[FileType["SYMLINK"] = 40960] = "SYMLINK";
+})(FileType || (FileType = {}));
 /**
  * Provides information about a particular entry in the file system.
  * Common code used by both Stats and BigIntStats.
@@ -78,10 +78,6 @@ export class StatsCommon {
          * group ID of owner
          */
         this.gid = this._convert(0);
-        /**
-         * Some file systems stash data on stats objects.
-         */
-        this.fileData = null;
         const currentTime = Date.now();
         const resolveT = (val, _default) => (typeof val == this._typename ? val : this._convert(typeof val == this._typename_inverse ? val : _default));
         this.atimeMs = resolveT(atimeMs, currentTime);
@@ -90,8 +86,8 @@ export class StatsCommon {
         this.birthtimeMs = resolveT(birthtimeMs, currentTime);
         this.uid = resolveT(uid, 0);
         this.gid = resolveT(gid, 0);
-        this.size = this._convert(size);
-        this.ino = this._convert(ino);
+        this.size = resolveT(size, 0);
+        this.ino = resolveT(ino, 0);
         const itemType = Number(mode) & S_IFMT || FileType.FILE;
         if (mode) {
             this.mode = this._convert(mode);
@@ -197,6 +193,18 @@ export class StatsCommon {
             this.gid = this._convert(gid);
         }
     }
+    get atimeNs() {
+        return BigInt(this.atimeMs);
+    }
+    get mtimeNs() {
+        return BigInt(this.mtimeMs);
+    }
+    get ctimeNs() {
+        return BigInt(this.ctimeMs);
+    }
+    get birthtimeNs() {
+        return BigInt(this.birthtimeMs);
+    }
 }
 /**
  * Implementation of Node's `Stats`.
@@ -237,6 +245,38 @@ export class BigIntStats extends StatsCommon {
     }
 }
 export class StatsFs {
+    constructor() {
+        /** Type of file system. */
+        this.type = 0;
+        /**  Optimal transfer block size. */
+        this.bsize = 0;
+        /**  Total data blocks in file system. */
+        this.blocks = 0;
+        /** Free blocks in file system. */
+        this.bfree = 0;
+        /** Available blocks for unprivileged users */
+        this.bavail = 0;
+        /** Total file nodes in file system. */
+        this.files = 0;
+        /** Free file nodes in file system. */
+        this.ffree = 0;
+    }
 }
 export class BigIntStatsFs {
+    constructor() {
+        /** Type of file system. */
+        this.type = 0n;
+        /**  Optimal transfer block size. */
+        this.bsize = 0n;
+        /**  Total data blocks in file system. */
+        this.blocks = 0n;
+        /** Free blocks in file system. */
+        this.bfree = 0n;
+        /** Available blocks for unprivileged users */
+        this.bavail = 0n;
+        /** Total file nodes in file system. */
+        this.files = 0n;
+        /** Free file nodes in file system. */
+        this.ffree = 0n;
+    }
 }

package/dist/utils.d.ts

@@ -43,7 +43,7 @@ export declare function decodeDirListing(data: Uint8Array): Record<string, bigin
  */
 export declare function encodeDirListing(data: Record<string, bigint>): Uint8Array;
 export type Callback<Args extends unknown[] = []> = (e?: ApiError, ...args: OptionalTuple<Args>) => unknown;
-import type { EncodingOption, OpenMode, WriteFileOptions } from 'node:fs';
+import type { EncodingOption, OpenMode, PathLike, WriteFileOptions } from 'node:fs';
 /**
  * converts Date or number to a integer UNIX timestamp
  * Grabbed from NodeJS sources (lib/fs.js)
@@ -65,7 +65,7 @@ export declare function normalizeTime(time: string | number | Date): Date;
  * Normalizes a path
  * @internal
  */
-export declare function normalizePath(p: string): string;
+export declare function normalizePath(p: PathLike): string;
 /**
  * Normalizes options
  * @param options options to normalize
@@ -74,10 +74,10 @@ export declare function normalizePath(p: string): string;
  * @param mode default mode
  * @internal
  */
-export declare function normalizeOptions(options?: WriteFileOptions | (EncodingOption & {
+export declare function normalizeOptions(options: WriteFileOptions | (EncodingOption & {
     flag?: OpenMode;
-}), encoding?: BufferEncoding, flag?: string, mode?: number): {
-    encoding: BufferEncoding;
+}) | undefined, encoding: BufferEncoding | null | undefined, flag: string, mode?: number): {
+    encoding?: BufferEncoding | null;
     flag: string;
     mode: number;
 };

package/dist/utils.js

@@ -86,7 +86,7 @@ export function levenshtein(a, b) {
 /**
  * @hidden
  */
-export const setImmediate = typeof globalThis.setImmediate == 'function' ? globalThis.setImmediate : cb => setTimeout(cb, 0);
+export const setImmediate = typeof globalThis.setImmediate == 'function' ? globalThis.setImmediate : (cb) => setTimeout(cb, 0);
 /**
  * Encodes a string into a buffer
  * @internal
@@ -188,6 +188,7 @@ export function normalizeTime(time) {
  * @internal
  */
 export function normalizePath(p) {
+    p = p.toString();
     // Node doesn't allow null characters in paths.
     if (p.includes('\x00')) {
         throw new ApiError(ErrorCode.EINVAL, 'Path must be a string without null bytes.');
@@ -208,13 +209,13 @@ export function normalizePath(p) {
 export function normalizeOptions(options, encoding = 'utf8', flag, mode = 0) {
     if (typeof options != 'object' || options === null) {
         return {
-            encoding: typeof options == 'string' ? options : encoding,
+            encoding: typeof options == 'string' ? options : encoding ?? null,
             flag,
             mode,
         };
     }
     return {
-        encoding: typeof options?.encoding == 'string' ? options.encoding : encoding,
+        encoding: typeof options?.encoding == 'string' ? options.encoding : encoding ?? null,
         flag: typeof options?.flag == 'string' ? options.flag : flag,
         mode: normalizeMode('mode' in options ? options?.mode : null, mode),
     };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@zenfs/core",
-	"version": "0.9.6",
+	"version": "0.9.7",
 	"description": "A filesystem in your browser",
 	"main": "dist/index.js",
 	"types": "src/index.ts",
@@ -65,7 +65,7 @@
 		"jest": "^29.5.0",
 		"prettier": "^3.2.5",
 		"ts-jest": "^29.1.0",
-		"typedoc": "^0.25.1",
-		"typescript": "^4.9.5"
+		"typedoc": "^0.25.13",
+		"typescript": "^5.4.0"
 	}
 }

package/readme.md

@@ -4,7 +4,7 @@ ZenFS is a file system that emulates the [NodeJS filesystem API](http://nodejs.o
 
 It works using a system of backends, which are used by ZenFS to store and retrieve data. ZenFS can also integrate with other tools.
 
-ZenFS is a fork of [BrowserFS](https://github.com/jvilk/BrowserFS).
+ZenFS is a fork of [BrowserFS](https://github.com/jvilk/BrowserFS). If you are using ZenFS in a research paper, you may want to [cite BrowserFS](https://github.com/jvilk/BrowserFS?tab=readme-ov-file#citing).
 
 ## Backends
 
@@ -13,7 +13,7 @@ ZenFS is modular and extensible. The core includes two built-in backends:
 -   `InMemory`: Stores files in-memory. This is cleared when the runtime ends (e.g. a user navigating away from a web page or a Node process exiting)
 -   `Overlay`: Use read-only file system as read-write by overlaying a writable file system on top of it. ([copy-on-write](https://en.wikipedia.org/wiki/Copy-on-write))
 
-ZenFS supports a number of other backends. Many are provided as separate packages under `@zenfs`. More backends can be defined by separate libraries by extending the `FileSystem` class and/or providing a `Backend` object.
+ZenFS supports a number of other backends. Many are provided as separate packages under `@zenfs`. More backends can be defined by separate libraries by extending the `FileSystem` class and providing a `Backend` object.
 
 For more information, see the [docs](https://zen-fs.github.io/core).
 

package/src/ApiError.ts

@@ -255,12 +255,14 @@ export class ApiError extends Error implements NodeJS.ErrnoException {
 		return err;
 	}
 
-	public static With(code: keyof typeof ErrorCode, path: string, syscall?: string): ApiError {
+	public static With(code: keyof typeof ErrorCode, path?: string, syscall?: string): ApiError {
 		return new ApiError(ErrorCode[code], errorMessages[ErrorCode[code]], path, syscall);
 	}
 
 	public code: keyof typeof ErrorCode;
 
+	public declare stack: string;
+
 	/**
 	 * Represents a ZenFS error. Passed back to applications after a failed
 	 * call to the ZenFS API.

package/src/backends/AsyncStore.ts

@@ -34,7 +34,7 @@ class LRUCache<K, V> {
 		this.cache.push({ key, value });
 	}
 
-	public get(key: K): V | null {
+	public get(key: K): V | void {
 		const node = this.cache.find(n => n.key === key);
 		if (!node) {
 			return;
@@ -131,21 +131,27 @@ export interface AsyncStoreOptions {
  * @internal
  */
 export class AsyncStoreFS extends Async(FileSystem) {
-	protected store: AsyncStore;
+	protected _store?: AsyncStore;
+	protected get store(): AsyncStore {
+		if (!this._store) {
+			throw new ReferenceError('AsyncStoreFS not attached to a store');
+		}
+		return this._store;
+	}
 	protected _cache?: LRUCache<string, Ino>;
 	private _initialized: boolean = false;
-	_sync: FileSystem;
+	_sync: FileSystem = InMemory.create({ name: 'test' });
 
 	public async ready(): Promise<this> {
 		if (this._initialized) {
 			return this;
 		}
 		this._initialized = true;
-		if (this._options.lruCacheSize > 0) {
+		if (this._options.lruCacheSize) {
 			this._cache = new LRUCache(this._options.lruCacheSize);
 		}
-		this.store = await this._options.store;
-		this._sync = this._options.sync || InMemory.create({ name: 'test' });
+		this._store = await this._options.store;
+		this._sync = this._options.sync || this._sync;
 		await this.makeRootDirectory();
 		await super.ready();
 		return this;
@@ -182,8 +188,8 @@ export class AsyncStoreFS extends Async(FileSystem) {
 		const c = this._cache;
 		if (this._cache) {
 			// Clear and disable cache during renaming process.
-			this._cache = null;
-			c.reset();
+			delete this._cache;
+			c?.reset();
 		}
 
 		try {

package/src/backends/Index.ts

@@ -86,7 +86,10 @@ export class FileIndex<TData> {
 		for (const dir of this._index.values()) {
 			for (const file of dir.listing) {
 				const item = dir.get(file);
-				if (!item?.isFile()) {
+				if (!item) {
+					continue;
+				}
+				if (!item.isFile()) {
 					continue;
 				}
 
@@ -123,11 +126,12 @@ export class FileIndex<TData> {
 
 		const dirpath = dirname(path);
 
+		const hasParent = this._index.has(dirpath);
+
+		const parent = hasParent ? this._index.get(dirpath)! : new IndexDirInode<TData>();
+
 		// Try to add to its parent directory first.
-		let parent = this._index.get(dirpath);
-		if (!parent && path != '/') {
-			// Create parent.
-			parent = new IndexDirInode<TData>();
+		if (!hasParent && path != '/') {
 			if (!this.add(dirpath, parent)) {
 				return false;
 			}
@@ -184,7 +188,7 @@ export class FileIndex<TData> {
 	 * @return The removed item,
 	 *   or null if it did not exist.
 	 */
-	public remove(path: string): IndexInode<TData> | null {
+	public remove(path: string): IndexInode<TData> | void {
 		const dirpath = dirname(path);
 
 		// Try to remove it from its parent directory first.
@@ -217,7 +221,7 @@ export class FileIndex<TData> {
 	 * Retrieves the directory listing of the given path.
 	 * @return An array of files in the given path, or 'null' if it does not exist.
 	 */
-	public ls(path: string): string[] | null {
+	public ls(path: string): string[] | void {
 		return this._index.get(path)?.listing;
 	}
 
@@ -225,7 +229,7 @@ export class FileIndex<TData> {
 	 * Returns the inode of the given item.
 	 * @return Returns null if the item does not exist.
 	 */
-	public get(path: string): IndexInode<TData> | null {
+	public get(path: string): IndexInode<TData> | void | null {
 		const dirpath = dirname(path);
 
 		// Retrieve from its parent directory.
@@ -316,7 +320,7 @@ export class IndexDirInode<TData> extends IndexInode<TData> {
 	 * Returns the inode for the indicated item, or null if it does not exist.
 	 * @param path Name of item in this directory.
 	 */
-	public get(path: string): IndexInode<TData> | null {
+	public get(path: string): IndexInode<TData> | void {
 		return this._listing.get(path);
 	}
 	/**
@@ -340,7 +344,7 @@ export class IndexDirInode<TData> extends IndexInode<TData> {
 	 * @return Returns the item
 	 *   removed, or null if the item did not exist.
 	 */
-	public remove(p: string): IndexInode<TData> | null {
+	public remove(p: string): IndexInode<TData> | void {
 		const item = this._listing.get(p);
 		if (!item) {
 			return;

package/src/backends/Overlay.ts

@@ -109,7 +109,7 @@ export class UnlockedOverlayFS extends FileSystem {
 			const { buffer } = await file.read(new Uint8Array(size));
 			this._deleteLog = decode(buffer);
 		} catch (err) {
-			if (err.errno !== ErrorCode.ENOENT) {
+			if ((err as ApiError).errno !== ErrorCode.ENOENT) {
 				throw err;
 			}
 		}
@@ -394,7 +394,7 @@ export class UnlockedOverlayFS extends FileSystem {
 				this.updateLog('', cred);
 			}
 		} catch (e) {
-			this._deleteLogError = e;
+			this._deleteLogError = e as ApiError;
 		} finally {
 			this._deleteLogUpdatePending = false;
 		}
@@ -423,7 +423,7 @@ export class UnlockedOverlayFS extends FileSystem {
 		}
 
 		const error = this._deleteLogError;
-		this._deleteLogError = null;
+		delete this._deleteLogError;
 		throw error;
 	}
 

package/src/backends/SyncStore.ts

@@ -37,7 +37,7 @@ export interface SyncTransaction {
 	 * @param ino The key to look under for data.
 	 * @return The data stored under the key, or undefined if not present.
 	 */
-	get(ino: Ino): Uint8Array | undefined;
+	get(ino: Ino): Uint8Array | void;
 
 	/**
 	 * Adds the data to the store under the given key.
@@ -81,7 +81,7 @@ export class SimpleSyncTransaction implements SyncTransaction {
 	 * Stores data in the keys we modify prior to modifying them.
 	 * Allows us to roll back commits.
 	 */
-	protected originalData: Map<Ino, Uint8Array> = new Map();
+	protected originalData: Map<Ino, Uint8Array | void> = new Map();
 	/**
 	 * List of keys modified in this transaction, if any.
 	 */
@@ -89,7 +89,7 @@ export class SimpleSyncTransaction implements SyncTransaction {
 
 	constructor(protected store: SimpleSyncStore) {}
 
-	public get(ino: Ino): Uint8Array | undefined {
+	public get(ino: Ino): Uint8Array | void {
 		const val = this.store.get(ino);
 		this.stashOldValue(ino, val);
 		return val;
@@ -129,7 +129,7 @@ export class SimpleSyncTransaction implements SyncTransaction {
 	 * prevent needless `get` requests if the program modifies the data later
 	 * on during the transaction.
 	 */
-	protected stashOldValue(ino: Ino, value: Uint8Array | undefined) {
+	protected stashOldValue(ino: Ino, value?: Uint8Array) {
 		// Keep only the earliest value in the transaction.
 		if (!this.originalData.has(ino)) {
 			this.originalData.set(ino, value);
@@ -280,7 +280,7 @@ export class SyncStoreFS extends Sync(FileSystem) {
 		if (!node.toStats().hasAccess(flagToMode(flag), cred)) {
 			throw ApiError.With('EACCES', p, 'openFile');
 		}
-		if (data === null) {
+		if (!data) {
 			throw ApiError.With('ENOENT', p, 'openFile');
 		}
 		return new PreloadFile(this, p, flag, node.toStats(), data);
@@ -439,13 +439,13 @@ export class SyncStoreFS extends Sync(FileSystem) {
 	/**
 	 * Given the ID of a node, retrieves the corresponding Inode.
 	 * @param tx The transaction to use.
-	 * @param p The corresponding path to the file (used for error messages).
+	 * @param path The corresponding path to the file (used for error messages).
 	 * @param id The ID to look up.
 	 */
-	protected getINode(tx: SyncTransaction, id: Ino, p?: string): Inode {
+	protected getINode(tx: SyncTransaction, id: Ino, path?: string): Inode {
 		const data = tx.get(id);
 		if (!data) {
-			throw ApiError.With('ENOENT', p, 'getINode');
+			throw ApiError.With('ENOENT', path, 'getINode');
 		}
 		const inode = new Inode(data.buffer);
 		return inode;

package/src/backends/backend.ts

@@ -66,6 +66,8 @@ export interface Backend<FS extends FileSystem = FileSystem, TOptions extends ob
 	isAvailable(): boolean | Promise<boolean>;
 }
 
+type OptionsOf<T extends Backend> = T extends Backend<FileSystem, infer TOptions> ? TOptions : never;
+
 /**
  * @internal
  */
@@ -77,7 +79,7 @@ export function isBackend(arg: unknown): arg is Backend {
  * Checks that the given options object is valid for the file system options.
  * @internal
  */
-export async function checkOptions<T extends Backend>(backend: T, opts: object): Promise<void> {
+export async function checkOptions<T extends Backend>(backend: T, opts: Partial<OptionsOf<T>> & Record<string, unknown>): Promise<void> {
 	if (typeof opts != 'object' || opts === null) {
 		throw new ApiError(ErrorCode.EINVAL, 'Invalid options');
 	}
@@ -126,8 +128,8 @@ export async function checkOptions<T extends Backend>(backend: T, opts: object):
 	}
 }
 
-export function createBackend<B extends Backend>(backend: B, options?: object): Promise<ReturnType<B['create']>> {
-	checkOptions(backend, options);
+export async function createBackend<B extends Backend>(backend: B, options: Partial<OptionsOf<B>> = {}): Promise<ReturnType<B['create']>> {
+	await checkOptions(backend, options);
 	const fs = <ReturnType<B['create']>>backend.create(options);
 	return fs.ready();
 }
@@ -140,8 +142,8 @@ export function createBackend<B extends Backend>(backend: B, options?: object):
  *
  * The option object for each file system corresponds to that file system's option object passed to its `Create()` method.
  */
-export type BackendConfiguration<FS extends FileSystem = FileSystem, TOptions extends object = object> = TOptions & {
-	backend: Backend<FS, TOptions>;
+export type BackendConfiguration<T extends Backend = Backend> = OptionsOf<T> & {
+	backend: T;
 };
 
 /**

package/src/config.ts

@@ -8,7 +8,7 @@ import { FileSystem } from './filesystem.js';
 /**
  * Configuration for a specific mount point
  */
-export type MountConfiguration<FS extends FileSystem = FileSystem, TOptions extends object = object> = FS | BackendConfiguration<FS, TOptions> | Backend<FS, TOptions>;
+export type MountConfiguration<FS extends FileSystem = FileSystem, TOptions extends object = object> = FS | BackendConfiguration<Backend<FS, TOptions>> | Backend<FS, TOptions>;
 
 function isMountConfig(arg: unknown): arg is MountConfiguration {
 	return isBackendConfig(arg) || isBackend(arg) || arg instanceof FileSystem;
@@ -32,7 +32,7 @@ export async function resolveMountConfig<FS extends FileSystem, TOptions extends
 	}
 
 	if (isBackend(config)) {
-		config = <BackendConfiguration<FS, TOptions>>{ backend: config };
+		config = <BackendConfiguration<Backend<FS, TOptions>>>{ backend: config };
 	}
 
 	for (const [key, value] of Object.entries(config)) {
@@ -48,7 +48,7 @@ export async function resolveMountConfig<FS extends FileSystem, TOptions extends
 			throw new ApiError(ErrorCode.EINVAL, 'Invalid configuration, too deep and possibly infinite');
 		}
 
-		config[key] = await resolveMountConfig(value, ++_depth);
+		(<Record<string, FileSystem>>config)[key] = await resolveMountConfig(value, ++_depth);
 	}
 
 	const { backend } = config;
@@ -81,8 +81,8 @@ export type Configuration = MountConfiguration | MappingConfiguration;
  * @see Configuration for more info on the configuration object.
  */
 export async function configure(config: Configuration): Promise<void> {
-	const uid = 'uid' in config ? +config.uid || 0 : 0;
-	const gid = 'gid' in config ? +config.gid || 0 : 0;
+	const uid = 'uid' in config ? config.uid || 0 : 0;
+	const gid = 'gid' in config ? config.gid || 0 : 0;
 
 	if (isMountConfig(config)) {
 		// single FS