@fnndsc/fond 0.1.2 → 0.2.0

package/README.md

@@ -21,6 +21,9 @@ fond's one rule: **it depends on nothing in `@fnndsc`**. CI holds it to that (`n
 | `Result<T>`, `Ok`, `Err`, `result_isOk`, `result_isErr` | An explicit success-or-failure value. A function returns `Result<T>` rather than `T \| null`, and TypeScript will not let a caller read `.value` until it has checked `.ok`. |
 | `errorStack` | The process-wide message stack that failures are reported on, with context-isolated scopes and checkpoints. |
 | `errorStack_configure`, `errorStack_getAllOfType`, `StackMessage` | Configuration, a convenience reader, and the message type. |
+| `VFSProvider`, `VFSItem`, `CpOptions` | The virtual filesystem's contracts: a mount that claims a path prefix and lists, copies and (optionally) reads, writes, makes, removes and renames under it; the items it lists. |
+| `VFSDispatcher` | Routes each filesystem request to the mount that owns the path, or to a fallback. It knows no backend: a backend registers its mounts and names its fallback. |
+| `vfsItems_sort` | Sorts a listing's items by name, size, date or owner without changing the array given. |
 
 ## Using `Result`
 
@@ -79,6 +82,23 @@ const reasons: StackMessage[] = errorStack.checkpoint_drain(mark);
 
 `errorStack_configure({ functionNamePadWidth })` sets how wide the function-name stamp is padded.
 
+## The virtual filesystem
+
+A session's filesystem is a tree of mounts. Each mount (a `VFSProvider`) claims a path prefix and answers for everything at or under it; the longest prefix that matches at a segment boundary wins, so `/proc/jobs` takes precedence over `/proc`, and `/procs` is not under `/proc`. A path no mount claims goes to the fallback.
+
+```typescript
+import { VFSDispatcher, type VFSProvider } from '@fnndsc/fond';
+
+const dispatcher: VFSDispatcher = new VFSDispatcher(filesFallback);   // what no mount claims
+dispatcher.provider_register(notesMount);                             // prefix '/notes'
+dispatcher.provider_register(jobsMount);                              // prefix '/proc/jobs'
+
+await dispatcher.list('/proc');        // the mounts beneath it ('jobs'), beside what the fallback holds there
+await dispatcher.read('/notes/today'); // notesMount.read('/notes/today')
+```
+
+Every operation a mount does not offer is refused by name (`mkdir: cannot create directory '/x': Read-only file system`), never silently ignored. A dispatcher built without a fallback refuses any path no mount claims, rather than answering with an empty folder. `pathResolver_register` adds a hook that maps a path to the fallback's own form before the fallback sees it; a copy whose path cannot be resolved fails rather than guessing.
+
 ## One instance, whoever loads it
 
 The error stack only works if the whole process shares one. fond is built as CommonJS, so packages that `require` it (cumin) and packages that `import` it (salsa, brasa, calypso) load the same module and so the same stack. `@fnndsc/cumin` re-exports fond's `Result` and `errorStack` rather than keeping copies, so code that imports them from cumin shares that stack too. If you bundle code that uses fond, keep it to one copy.

package/dist/index.d.ts

@@ -10,3 +10,6 @@
  */
 export * from './result.js';
 export * from './errorStack.js';
+export * from './vfs/provider.js';
+export * from './vfs/sort.js';
+export * from './vfs/dispatcher.js';

package/dist/index.js

@@ -26,4 +26,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
  */
 __exportStar(require("./result.js"), exports);
 __exportStar(require("./errorStack.js"), exports);
+__exportStar(require("./vfs/provider.js"), exports);
+__exportStar(require("./vfs/sort.js"), exports);
+__exportStar(require("./vfs/dispatcher.js"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;;;;;;;GASG;AACH,8CAA4B;AAC5B,kDAAgC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;;;;;;;GASG;AACH,8CAA4B;AAC5B,kDAAgC;AAChC,oDAAkC;AAClC,gDAA8B;AAC9B,sDAAoC"}

package/dist/vfs/dispatcher.d.ts

@@ -0,0 +1,150 @@
+/**
+ * @file The virtual filesystem's dispatcher: routes each request to the
+ * mount that owns the path.
+ *
+ * Mounts (providers) are registered with a path prefix; the longest prefix
+ * that matches at a segment boundary wins, so `/proc/jobs` takes precedence
+ * over `/proc`, and `/procs` is not under `/proc`. A path no mount claims
+ * goes to the fallback, the provider given to the constructor. The
+ * dispatcher itself knows no backend: a backend registers its mounts and
+ * names its fallback.
+ *
+ * @module
+ */
+import { Result } from "../result.js";
+import { VFSProvider, VFSItem, CpOptions } from "./provider.js";
+/**
+ * Routes filesystem requests to the mount that owns each path, or to the
+ * fallback.
+ */
+export declare class VFSDispatcher {
+    private providers;
+    private defaultProvider;
+    private pathResolver?;
+    /**
+     * @param fallback - The provider for paths no mount claims; one that holds
+     *   nothing, and says so, when none is given.
+     */
+    constructor(fallback?: VFSProvider);
+    /**
+     * Registers a path resolution hook that maps logical paths to physical paths.
+     *
+     * @param resolver - The resolver function mapping a logical path to a physical path.
+     */
+    pathResolver_register(resolver: (path: string) => Promise<string>): void;
+    /**
+     * Registers a new VFS Provider.
+     *
+     * @param provider - The provider instance to register.
+     */
+    provider_register(provider: VFSProvider): void;
+    /**
+     * Returns every registered mount (not the fallback). Used by callers that
+     * need to detect parent-of-prefix paths.
+     */
+    providers_get(): VFSProvider[];
+    /**
+     * Resolves the matching provider for a given virtual path.
+     *
+     * @param pathStr - The absolute virtual path.
+     * @returns The matching mount, or the fallback.
+     */
+    provider_get(pathStr: string): VFSProvider;
+    /**
+     * Whether a path belongs to a mount rather than to the fallback.
+     *
+     * Two shapes count: a path a mount owns (at or under its prefix), and a
+     * path that is a strict ancestor of a mount's prefix (`/proc` above
+     * `/proc/jobs`), whose only children are the mounts beneath it. The root
+     * `/` never counts: it is the fallback's own root.
+     *
+     * It keeps the fallback from being asked to answer for a path it has no
+     * folder behind, which cannot succeed and only fills the error stack once
+     * per ancestor a path walk visits.
+     *
+     * @param pathStr - The absolute (or root-relative) path to classify.
+     * @returns True when a mount owns, or is owned by, the path.
+     */
+    path_isVirtual(pathStr: string): boolean;
+    /**
+     * Dispatches directory listing to matched provider.
+     * Supports dynamic intermediate parent path synthesis for virtual prefixes.
+     *
+     * @param pathStr - The absolute virtual path to list.
+     * @param options - Sort controls.
+     * @returns Promise resolving to Result<VFSItem[]>.
+     */
+    list(pathStr: string, options?: {
+        sort?: "name" | "size" | "date" | "owner";
+        reverse?: boolean;
+    }): Promise<Result<VFSItem[]>>;
+    /**
+     * Dispatches copy operation to matched provider.
+     *
+     * @param src - Source path.
+     * @param dest - Destination path.
+     * @param options - Copy options.
+     * @returns Promise resolving to success boolean.
+     */
+    cp(src: string, dest: string, options: CpOptions): Promise<boolean>;
+    /**
+     * Dispatches file read operation to the matched provider.
+     *
+     * @param pathStr - The absolute virtual path of the file to read.
+     * @returns A Promise resolving to a Result containing the file contents as a string.
+     */
+    read(pathStr: string): Promise<Result<string>>;
+    /**
+     * Dispatches a whole-file write to the matched provider: a mount
+     * that holds writable files (a feed's note) takes the content; any other
+     * path is refused by name rather than written somewhere it does not live.
+     *
+     * @param pathStr - The absolute virtual path of the file.
+     * @param content - The file's new content, whole.
+     * @returns True when the provider took it.
+     */
+    /**
+     * Dispatches a folder's making to the matched provider; a mount that
+     * makes no folders refuses by name.
+     *
+     * @param pathStr - The absolute virtual path of the new folder.
+     * @returns True when the provider made it.
+     */
+    mkdir(pathStr: string): Promise<boolean>;
+    /**
+     * Dispatches an empty folder's removal to the matched provider; a
+     * mount that removes no folders refuses by name.
+     *
+     * @param pathStr - The absolute virtual path of the folder.
+     * @returns True when the provider removed it.
+     */
+    rmdir(pathStr: string): Promise<boolean>;
+    /**
+     * Dispatches a rename within one mount; a rename across mounts, or in a
+     * mount that renames nothing, is refused by name.
+     *
+     * @param src - The absolute virtual path now.
+     * @param dest - The absolute virtual path it takes.
+     * @returns True when the provider renamed it.
+     */
+    rename(src: string, dest: string): Promise<boolean>;
+    write(pathStr: string, content: string): Promise<boolean>;
+    /**
+     * Dispatches binary file read operation to the matched provider.
+     *
+     * @param pathStr - The absolute virtual path of the file to read.
+     * @returns A Promise resolving to a Result containing the file contents as a Buffer.
+     */
+    readBinary(pathStr: string): Promise<Result<Buffer>>;
+    /**
+     * Resolves a lazy link through the provider that owns it.
+     *
+     * This is deliberately distinct from {@link list}: a structural traversal
+     * can display an unresolved link without causing its provider to fetch the
+     * target from a remote service.
+     *
+     * @param pathStr - Absolute path of the provider-defined link.
+     * @returns The resolved target path, or an error if unsupported or absent.
+     */
+    linkTarget_resolve(pathStr: string): Promise<Result<string>>;
+}

package/dist/vfs/dispatcher.js

@@ -0,0 +1,322 @@
+"use strict";
+/**
+ * @file The virtual filesystem's dispatcher: routes each request to the
+ * mount that owns the path.
+ *
+ * Mounts (providers) are registered with a path prefix; the longest prefix
+ * that matches at a segment boundary wins, so `/proc/jobs` takes precedence
+ * over `/proc`, and `/procs` is not under `/proc`. A path no mount claims
+ * goes to the fallback, the provider given to the constructor. The
+ * dispatcher itself knows no backend: a backend registers its mounts and
+ * names its fallback.
+ *
+ * @module
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VFSDispatcher = void 0;
+const result_js_1 = require("../result.js");
+const errorStack_js_1 = require("../errorStack.js");
+/**
+ * The fallback when none is given: it holds nothing, and says so by name
+ * rather than answering with an empty folder.
+ */
+const VFS_FALLBACK_NONE = {
+    prefix: "",
+    async list(path) {
+        errorStack_js_1.errorStack.stack_push("error", `No mount serves ${path}.`);
+        return (0, result_js_1.Err)();
+    },
+    async cp(src) {
+        errorStack_js_1.errorStack.stack_push("error", `cp: no mount serves ${src}`);
+        return false;
+    },
+};
+/**
+ * Routes filesystem requests to the mount that owns each path, or to the
+ * fallback.
+ */
+class VFSDispatcher {
+    /**
+     * @param fallback - The provider for paths no mount claims; one that holds
+     *   nothing, and says so, when none is given.
+     */
+    constructor(fallback = VFS_FALLBACK_NONE) {
+        this.providers = [];
+        this.defaultProvider = fallback;
+    }
+    /**
+     * Registers a path resolution hook that maps logical paths to physical paths.
+     *
+     * @param resolver - The resolver function mapping a logical path to a physical path.
+     */
+    pathResolver_register(resolver) {
+        this.pathResolver = resolver;
+    }
+    /**
+     * Registers a new VFS Provider.
+     *
+     * @param provider - The provider instance to register.
+     */
+    provider_register(provider) {
+        this.providers.push(provider);
+        // Sort by prefix length descending to match most specific prefix first
+        this.providers.sort((a, b) => b.prefix.length - a.prefix.length);
+    }
+    /**
+     * Returns every registered mount (not the fallback). Used by callers that
+     * need to detect parent-of-prefix paths.
+     */
+    providers_get() {
+        return [...this.providers];
+    }
+    /**
+     * Resolves the matching provider for a given virtual path.
+     *
+     * @param pathStr - The absolute virtual path.
+     * @returns The matching mount, or the fallback.
+     */
+    provider_get(pathStr) {
+        const absolutePath = pathStr.startsWith("/") ? pathStr : "/" + pathStr;
+        const match = this.providers.find((p) => absolutePath === p.prefix || absolutePath.startsWith(p.prefix + "/"));
+        return match || this.defaultProvider;
+    }
+    /**
+     * Whether a path belongs to a mount rather than to the fallback.
+     *
+     * Two shapes count: a path a mount owns (at or under its prefix), and a
+     * path that is a strict ancestor of a mount's prefix (`/proc` above
+     * `/proc/jobs`), whose only children are the mounts beneath it. The root
+     * `/` never counts: it is the fallback's own root.
+     *
+     * It keeps the fallback from being asked to answer for a path it has no
+     * folder behind, which cannot succeed and only fills the error stack once
+     * per ancestor a path walk visits.
+     *
+     * @param pathStr - The absolute (or root-relative) path to classify.
+     * @returns True when a mount owns, or is owned by, the path.
+     */
+    path_isVirtual(pathStr) {
+        const absolutePath = pathStr.startsWith("/") ? pathStr : "/" + pathStr;
+        const clean = absolutePath.length > 1 && absolutePath.endsWith("/") ? absolutePath.slice(0, -1) : absolutePath;
+        if (clean === "/")
+            return false;
+        return this.providers.some((p) => p.prefix.length > 0 &&
+            (clean === p.prefix || clean.startsWith(p.prefix + "/") || p.prefix.startsWith(clean + "/")));
+    }
+    /**
+     * Dispatches directory listing to matched provider.
+     * Supports dynamic intermediate parent path synthesis for virtual prefixes.
+     *
+     * @param pathStr - The absolute virtual path to list.
+     * @param options - Sort controls.
+     * @returns Promise resolving to Result<VFSItem[]>.
+     */
+    async list(pathStr, options) {
+        const absolutePath = pathStr.startsWith("/") ? pathStr : "/" + pathStr;
+        const cleanPath = absolutePath.endsWith("/") && absolutePath.length > 1 ? absolutePath.slice(0, -1) : absolutePath;
+        // Check if cleanPath is a parent of any registered provider's prefix
+        const prefixParent = cleanPath === "/" ? "/" : cleanPath + "/";
+        const children = this.providers.filter((p) => p.prefix.startsWith(prefixParent));
+        if (children.length > 0) {
+            const segmentIndex = cleanPath === "/" ? 1 : cleanPath.split("/").length;
+            const virtualSubdirs = new Set();
+            for (const p of children) {
+                const segments = p.prefix.split("/");
+                const nextSegment = segments[segmentIndex];
+                if (nextSegment) {
+                    virtualSubdirs.add(nextSegment);
+                }
+            }
+            if (virtualSubdirs.size > 0) {
+                const vfsItems = Array.from(virtualSubdirs).map((name) => ({
+                    name,
+                    type: "vfs",
+                    size: 0,
+                    owner: "root",
+                    date: new Date().toISOString(),
+                }));
+                // The fallback may hold real items in this folder too: list them beside the mounts
+                let resolvedPathStr = pathStr;
+                if (this.pathResolver) {
+                    try {
+                        resolvedPathStr = await this.pathResolver(pathStr);
+                    }
+                    catch (e) {
+                        // Deliberate absorption: for a read-only listing, the logical
+                        // path is a valid fallback (the provider lists what it can);
+                        // contrast cp(), where a guessed path could write wrongly.
+                    }
+                }
+                const fallbackResult = await this.defaultProvider.list(resolvedPathStr, options);
+                if (fallbackResult.ok && fallbackResult.value) {
+                    const fallbackItems = fallbackResult.value;
+                    for (const item of fallbackItems) {
+                        if (!virtualSubdirs.has(item.name)) {
+                            vfsItems.push(item);
+                        }
+                    }
+                }
+                return (0, result_js_1.Ok)(vfsItems);
+            }
+        }
+        const provider = this.provider_get(pathStr);
+        if (provider === this.defaultProvider && this.pathResolver) {
+            try {
+                const resolvedPath = await this.pathResolver(pathStr);
+                return provider.list(resolvedPath, options);
+            }
+            catch (e) {
+                // Deliberate absorption: same read-only-listing rationale as above.
+            }
+        }
+        return provider.list(pathStr, options);
+    }
+    /**
+     * Dispatches copy operation to matched provider.
+     *
+     * @param src - Source path.
+     * @param dest - Destination path.
+     * @param options - Copy options.
+     * @returns Promise resolving to success boolean.
+     */
+    async cp(src, dest, options) {
+        const provider = this.provider_get(src);
+        if (provider === this.defaultProvider && this.pathResolver) {
+            // A copy must never proceed on a guessed path: an unresolved source
+            // copies the wrong thing, an unresolved destination writes to the wrong
+            // place. Resolution failure fails the copy.
+            let resolvedSrc;
+            let resolvedDest;
+            try {
+                resolvedSrc = await this.pathResolver(src);
+            }
+            catch (e) {
+                const msg = e instanceof Error ? e.message : String(e);
+                errorStack_js_1.errorStack.stack_push("error", `cp: cannot resolve source path ${src}: ${msg}`);
+                return false;
+            }
+            try {
+                resolvedDest = await this.pathResolver(dest);
+            }
+            catch (e) {
+                const msg = e instanceof Error ? e.message : String(e);
+                errorStack_js_1.errorStack.stack_push("error", `cp: cannot resolve destination path ${dest}: ${msg}`);
+                return false;
+            }
+            return provider.cp(resolvedSrc, resolvedDest, options);
+        }
+        return provider.cp(src, dest, options);
+    }
+    /**
+     * Dispatches file read operation to the matched provider.
+     *
+     * @param pathStr - The absolute virtual path of the file to read.
+     * @returns A Promise resolving to a Result containing the file contents as a string.
+     */
+    async read(pathStr) {
+        const provider = this.provider_get(pathStr);
+        if (provider !== this.defaultProvider && provider.read) {
+            return provider.read(pathStr);
+        }
+        errorStack_js_1.errorStack.stack_push("error", `File read not supported for path: ${pathStr}`);
+        return (0, result_js_1.Err)();
+    }
+    /**
+     * Dispatches a whole-file write to the matched provider: a mount
+     * that holds writable files (a feed's note) takes the content; any other
+     * path is refused by name rather than written somewhere it does not live.
+     *
+     * @param pathStr - The absolute virtual path of the file.
+     * @param content - The file's new content, whole.
+     * @returns True when the provider took it.
+     */
+    /**
+     * Dispatches a folder's making to the matched provider; a mount that
+     * makes no folders refuses by name.
+     *
+     * @param pathStr - The absolute virtual path of the new folder.
+     * @returns True when the provider made it.
+     */
+    async mkdir(pathStr) {
+        const provider = this.provider_get(pathStr);
+        if (provider !== this.defaultProvider && provider.mkdir)
+            return provider.mkdir(pathStr);
+        errorStack_js_1.errorStack.stack_push("error", `mkdir: cannot create directory '${pathStr}': Read-only file system`);
+        return false;
+    }
+    /**
+     * Dispatches an empty folder's removal to the matched provider; a
+     * mount that removes no folders refuses by name.
+     *
+     * @param pathStr - The absolute virtual path of the folder.
+     * @returns True when the provider removed it.
+     */
+    async rmdir(pathStr) {
+        const provider = this.provider_get(pathStr);
+        if (provider !== this.defaultProvider && provider.rmdir)
+            return provider.rmdir(pathStr);
+        errorStack_js_1.errorStack.stack_push("error", `rmdir: failed to remove '${pathStr}': Read-only file system`);
+        return false;
+    }
+    /**
+     * Dispatches a rename within one mount; a rename across mounts, or in a
+     * mount that renames nothing, is refused by name.
+     *
+     * @param src - The absolute virtual path now.
+     * @param dest - The absolute virtual path it takes.
+     * @returns True when the provider renamed it.
+     */
+    async rename(src, dest) {
+        const provider = this.provider_get(src);
+        if (provider !== this.provider_get(dest)) {
+            errorStack_js_1.errorStack.stack_push("error", `mv: cannot move '${src}' to '${dest}': Invalid cross-device link`);
+            return false;
+        }
+        if (provider !== this.defaultProvider && provider.rename)
+            return provider.rename(src, dest);
+        errorStack_js_1.errorStack.stack_push("error", `mv: cannot move '${src}': Read-only file system`);
+        return false;
+    }
+    async write(pathStr, content) {
+        const provider = this.provider_get(pathStr);
+        if (provider !== this.defaultProvider && provider.write) {
+            return provider.write(pathStr, content);
+        }
+        errorStack_js_1.errorStack.stack_push("error", `File write not supported for path: ${pathStr}`);
+        return false;
+    }
+    /**
+     * Dispatches binary file read operation to the matched provider.
+     *
+     * @param pathStr - The absolute virtual path of the file to read.
+     * @returns A Promise resolving to a Result containing the file contents as a Buffer.
+     */
+    async readBinary(pathStr) {
+        const provider = this.provider_get(pathStr);
+        if (provider !== this.defaultProvider && provider.readBinary) {
+            return provider.readBinary(pathStr);
+        }
+        errorStack_js_1.errorStack.stack_push("error", `Binary file read not supported for path: ${pathStr}`);
+        return (0, result_js_1.Err)();
+    }
+    /**
+     * Resolves a lazy link through the provider that owns it.
+     *
+     * This is deliberately distinct from {@link list}: a structural traversal
+     * can display an unresolved link without causing its provider to fetch the
+     * target from a remote service.
+     *
+     * @param pathStr - Absolute path of the provider-defined link.
+     * @returns The resolved target path, or an error if unsupported or absent.
+     */
+    async linkTarget_resolve(pathStr) {
+        const provider = this.provider_get(pathStr);
+        if (provider.linkTarget_resolve) {
+            return provider.linkTarget_resolve(pathStr);
+        }
+        errorStack_js_1.errorStack.stack_push('error', `Link resolution not supported for path: ${pathStr}`);
+        return (0, result_js_1.Err)();
+    }
+}
+exports.VFSDispatcher = VFSDispatcher;
+//# sourceMappingURL=dispatcher.js.map

package/dist/vfs/dispatcher.js.map

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

package/dist/vfs/provider.d.ts

@@ -0,0 +1,128 @@
+/**
+ * @file The virtual filesystem's contracts: a mount (provider), the items it
+ * lists, and the options a copy takes.
+ *
+ * A session's filesystem is a tree of mounts. Each provider claims a path
+ * prefix and answers for everything at or under it; whatever no provider
+ * claims goes to the dispatcher's fallback (see `dispatcher.ts`).
+ *
+ * @module
+ */
+import { Result } from "../result.js";
+/**
+ * Standard interface representing a virtual file system item.
+ */
+export interface VFSItem {
+    /** The display name of the item. */
+    name: string;
+    /**
+     * What the item is: `dir`, `file`, `link` or `vfs` (a mount), or a kind a
+     * backend lists beside them. An open string: a consumer handles the kinds it
+     * knows and treats any other as a plain entry.
+     */
+    type: string;
+    /** Size in bytes. */
+    size: number;
+    /** Username of the owner. */
+    owner: string;
+    /** Creation date (ISO string). */
+    date: string;
+    /** Target path (for links). */
+    target?: string;
+    /** Version string (for plugins). */
+    version?: string;
+    /** Title or description, when the item has one. */
+    title?: string;
+    /** Backing resource ID, when the virtual entry represents one. */
+    id?: number;
+    /** Execution status (for job type items). */
+    status?: string;
+}
+/**
+ * Options for VFS copy operations.
+ */
+export interface CpOptions {
+    /** Recursively copy subdirectories. */
+    recursive?: boolean;
+}
+/**
+ * Base contract that every Virtual File System Provider must implement.
+ */
+export interface VFSProvider {
+    /** The path prefix this provider matches (e.g. '/net/pacs', '/bin'); empty for a fallback. */
+    prefix: string;
+    /**
+     * Lists the contents of a directory matching this provider.
+     *
+     * @param path - The absolute virtual directory path.
+     * @param options - Optional sorting controls.
+     * @returns A Promise resolving to a Result containing VFSItems.
+     */
+    list(path: string, options?: {
+        sort?: "name" | "size" | "date" | "owner";
+        reverse?: boolean;
+    }): Promise<Result<VFSItem[]>>;
+    /**
+     * Copies files or folders from/to paths under this provider.
+     *
+     * @param src - The absolute source path.
+     * @param dest - The absolute destination path.
+     * @param options - Copy flags like recursive.
+     * @returns A Promise resolving to true on successful copy execution.
+     */
+    cp(src: string, dest: string, options: CpOptions): Promise<boolean>;
+    /**
+     * Reads the content of a virtual file under this provider as a string.
+     *
+     * @param path - The absolute virtual path of the file to read.
+     * @returns A Promise resolving to a Result containing the file contents as a string.
+     */
+    read?(path: string): Promise<Result<string>>;
+    /**
+     * Reads the content of a virtual file under this provider as a binary Buffer.
+     *
+     * @param path - The absolute virtual path of the file to read.
+     * @returns A Promise resolving to a Result containing the file contents as a Buffer.
+     */
+    readBinary?(path: string): Promise<Result<Buffer>>;
+    /**
+     * Writes a file whole, when the provider holds writable files (a note).
+     * Absent or false, the path is read-only.
+     *
+     * @param path - The absolute path of the file.
+     * @param content - The new content, whole.
+     * @returns True when it was written.
+     */
+    write?(path: string, content: string): Promise<boolean>;
+    /**
+     * Makes a folder, when the provider's folders are things a user makes (a
+     * tag). Absent, the provider is read-only for mkdir.
+     * @param path - The absolute path of the new folder.
+     * @returns True when made; false with the reason stacked.
+     */
+    mkdir?(path: string): Promise<boolean>;
+    /**
+     * Removes an empty folder (`rmdir`).
+     * @param path - The absolute path of the folder.
+     * @returns True when removed; false with the reason stacked.
+     */
+    rmdir?(path: string): Promise<boolean>;
+    /**
+     * Renames an entry within this provider (`mv`).
+     * @param src - The absolute path now.
+     * @param dest - The absolute path it takes.
+     * @returns True when renamed; false with the reason stacked.
+     */
+    rename?(src: string, dest: string): Promise<boolean>;
+    /**
+     * Resolves the target of a provider-defined lazy link when an operation
+     * actually follows it.
+     *
+     * Listings must not use this hook: providers may expose an unresolved link
+     * as structural metadata without paying for its target until navigation.
+     *
+     * @param path - Absolute virtual path naming the link.
+     * @returns The target path, or an error when the provider cannot resolve it.
+     */
+    linkTarget_resolve?(path: string): Promise<Result<string>>;
+}

package/dist/vfs/provider.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * @file The virtual filesystem's contracts: a mount (provider), the items it
+ * lists, and the options a copy takes.
+ *
+ * A session's filesystem is a tree of mounts. Each provider claims a path
+ * prefix and answers for everything at or under it; whatever no provider
+ * claims goes to the dispatcher's fallback (see `dispatcher.ts`).
+ *
+ * @module
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=provider.js.map

package/dist/vfs/provider.js.map

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

package/dist/vfs/sort.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @file Sorting a listing's items by a field, without changing the array given.
+ *
+ * @module
+ */
+import { VFSItem } from './provider.js';
+/**
+ * Sorts VFS items by a field (name/size/date/owner), non-destructively.
+ *
+ * Strings are compared with localeCompare, numbers numerically; mismatched or
+ * unsupported types are left in their original relative order.
+ *
+ * @param items - Items to sort.
+ * @param sortField - Field to sort by (default 'name').
+ * @param reverse - Whether to reverse the resulting order.
+ * @returns A new sorted array.
+ */
+export declare function vfsItems_sort(items: VFSItem[], sortField?: 'name' | 'size' | 'date' | 'owner', reverse?: boolean): VFSItem[];

package/dist/vfs/sort.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.vfsItems_sort = vfsItems_sort;
+/**
+ * Sorts VFS items by a field (name/size/date/owner), non-destructively.
+ *
+ * Strings are compared with localeCompare, numbers numerically; mismatched or
+ * unsupported types are left in their original relative order.
+ *
+ * @param items - Items to sort.
+ * @param sortField - Field to sort by (default 'name').
+ * @param reverse - Whether to reverse the resulting order.
+ * @returns A new sorted array.
+ */
+function vfsItems_sort(items, sortField, reverse) {
+    const field = sortField || 'name';
+    const sorted = [...items].sort((a, b) => {
+        const valA = a[field];
+        const valB = b[field];
+        if (typeof valA === 'string' && typeof valB === 'string') {
+            return valA.localeCompare(valB);
+        }
+        if (typeof valA === 'number' && typeof valB === 'number') {
+            return valA - valB;
+        }
+        return 0;
+    });
+    if (reverse) {
+        sorted.reverse();
+    }
+    return sorted;
+}
+//# sourceMappingURL=sort.js.map

package/dist/vfs/sort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sort.js","sourceRoot":"","sources":["../../src/vfs/sort.ts"],"names":[],"mappings":";;AAkBA,sCAqBC;AAhCD;;;;;;;;;;GAUG;AACH,SAAgB,aAAa,CAC3B,KAAgB,EAChB,SAA8C,EAC9C,OAAiB;IAEjB,MAAM,KAAK,GAAkB,SAAS,IAAI,MAAM,CAAC;IACjD,MAAM,MAAM,GAAc,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAU,EAAE,CAAU,EAAE,EAAE;QACnE,MAAM,IAAI,GAA2B,CAAC,CAAC,KAAK,CAAC,CAAC;QAC9C,MAAM,IAAI,GAA2B,CAAC,CAAC,KAAK,CAAC,CAAC;QAC9C,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YACzD,OAAO,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QAClC,CAAC;QACD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YACzD,OAAO,IAAI,GAAG,IAAI,CAAC;QACrB,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC,CAAC,CAAC;IACH,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,CAAC,OAAO,EAAE,CAAC;IACnB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fnndsc/fond",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "The pieces every layer of mise needs, whatever the backend. Depends on nothing in @fnndsc.",
   "repository": {
     "type": "git",