@mhalle/vost 0.8.1

package/dist/tree.js

@@ -0,0 +1,283 @@
+/**
+ * Low-level tree manipulation for vost.
+ *
+ * Provides recursive tree rebuild and path-based read helpers
+ * on top of isomorphic-git's readTree/writeTree/writeBlob.
+ */
+import git from 'isomorphic-git';
+import { MODE_TREE, MODE_BLOB, MODE_BLOB_EXEC, typeForMode, FileNotFoundError, IsADirectoryError, NotADirectoryError, } from './types.js';
+import { normalizePath, isRootPath } from './paths.js';
+// ---------------------------------------------------------------------------
+// Detect executable bit from filesystem
+// ---------------------------------------------------------------------------
+/**
+ * Detect the git filemode for a local file by checking its executable bit.
+ *
+ * @param fsModule - Node.js-compatible fs module.
+ * @param localPath - Path to the local file.
+ * @returns MODE_BLOB_EXEC if executable, MODE_BLOB otherwise.
+ * @throws IsADirectoryError if the path is a directory.
+ */
+export async function modeFromDisk(fsModule, localPath) {
+    const stat = await fsModule.promises.stat(localPath);
+    if (stat.isDirectory())
+        throw new IsADirectoryError(localPath);
+    // Check executable bit (any of owner/group/other)
+    if ((stat.mode & 0o111) !== 0)
+        return MODE_BLOB_EXEC;
+    return MODE_BLOB;
+}
+/**
+ * Walk through tree to the object at the given path.
+ * Returns the final tree entry.
+ */
+export async function walkTo(fsModule, gitdir, treeOid, path) {
+    const segments = path.split('/');
+    let currentOid = treeOid;
+    for (let i = 0; i < segments.length; i++) {
+        const { tree } = await git.readTree({ fs: fsModule, gitdir, oid: currentOid });
+        const entry = tree.find((e) => e.path === segments[i]);
+        if (!entry)
+            throw new FileNotFoundError(path);
+        if (i < segments.length - 1) {
+            if (entry.mode !== MODE_TREE) {
+                throw new NotADirectoryError(segments.slice(0, i + 1).join('/'));
+            }
+            currentOid = entry.oid;
+        }
+        else {
+            return entry;
+        }
+    }
+    throw new FileNotFoundError(path);
+}
+/**
+ * Return { oid, mode } of the entry at path, or null if missing.
+ */
+export async function entryAtPath(fsModule, gitdir, treeOid, path) {
+    const segments = path.split('/');
+    let currentOid = treeOid;
+    for (let i = 0; i < segments.length; i++) {
+        let tree;
+        try {
+            const result = await git.readTree({ fs: fsModule, gitdir, oid: currentOid });
+            tree = result.tree;
+        }
+        catch {
+            return null;
+        }
+        const entry = tree.find((e) => e.path === segments[i]);
+        if (!entry)
+            return null;
+        if (i < segments.length - 1) {
+            if (entry.mode !== MODE_TREE)
+                return null;
+            currentOid = entry.oid;
+        }
+        else {
+            return { oid: entry.oid, mode: entry.mode };
+        }
+    }
+    return null;
+}
+/**
+ * Read a blob at the given path in the tree.
+ */
+export async function readBlobAtPath(fsModule, gitdir, treeOid, path) {
+    const normalized = normalizePath(path);
+    const entry = await walkTo(fsModule, gitdir, treeOid, normalized);
+    if (entry.mode === MODE_TREE)
+        throw new IsADirectoryError(normalized);
+    const { blob } = await git.readBlob({ fs: fsModule, gitdir, oid: entry.oid });
+    return blob;
+}
+/**
+ * List entry names at the given path (or root if path is null/empty).
+ */
+export async function listTreeAtPath(fsModule, gitdir, treeOid, path) {
+    const entries = await listEntriesAtPath(fsModule, gitdir, treeOid, path);
+    return entries.map((e) => e.name);
+}
+/**
+ * List full entries at the given path (or root if path is null/empty).
+ */
+export async function listEntriesAtPath(fsModule, gitdir, treeOid, path) {
+    let targetOid = treeOid;
+    if (path != null && !isRootPath(path)) {
+        const normalized = normalizePath(path);
+        const entry = await walkTo(fsModule, gitdir, treeOid, normalized);
+        if (entry.mode !== MODE_TREE)
+            throw new NotADirectoryError(normalized);
+        targetOid = entry.oid;
+    }
+    const { tree } = await git.readTree({ fs: fsModule, gitdir, oid: targetOid });
+    return tree.map((e) => ({ name: e.path, oid: e.oid, mode: e.mode }));
+}
+/**
+ * Walk the tree recursively, yielding (dirpath, dirnames, fileEntries).
+ */
+export async function* walkTree(fsModule, gitdir, treeOid, prefix = '') {
+    const { tree } = await git.readTree({ fs: fsModule, gitdir, oid: treeOid });
+    const dirs = [];
+    const files = [];
+    const dirOids = [];
+    for (const entry of tree) {
+        if (entry.mode === MODE_TREE) {
+            dirs.push(entry.path);
+            dirOids.push([entry.path, entry.oid]);
+        }
+        else {
+            files.push({ name: entry.path, oid: entry.oid, mode: entry.mode });
+        }
+    }
+    yield [prefix, dirs, files];
+    for (const [name, oid] of dirOids) {
+        const childPrefix = prefix ? `${prefix}/${name}` : name;
+        yield* walkTree(fsModule, gitdir, oid, childPrefix);
+    }
+}
+/**
+ * Check if a path exists in the tree.
+ */
+export async function existsAtPath(fsModule, gitdir, treeOid, path) {
+    const normalized = normalizePath(path);
+    const entry = await entryAtPath(fsModule, gitdir, treeOid, normalized);
+    return entry !== null;
+}
+// ---------------------------------------------------------------------------
+// Count subdirectories (for stat nlink)
+// ---------------------------------------------------------------------------
+/**
+ * Count the number of immediate subdirectories in a tree (for stat nlink).
+ *
+ * @param fsModule - Node.js-compatible fs module.
+ * @param gitdir   - Path to the bare git repository.
+ * @param treeOid  - 40-char hex SHA of the tree object.
+ * @returns Number of subdirectory entries in the tree.
+ */
+export async function countSubdirs(fsModule, gitdir, treeOid) {
+    const { tree } = await git.readTree({ fs: fsModule, gitdir, oid: treeOid });
+    return tree.filter(e => e.mode === MODE_TREE).length;
+}
+// ---------------------------------------------------------------------------
+// Recursive tree rebuild
+// ---------------------------------------------------------------------------
+/**
+ * Rebuild a tree with writes and removes applied.
+ *
+ * Only the ancestor chain from changed leaves to root is rebuilt.
+ * Sibling subtrees are shared by hash reference.
+ */
+export async function rebuildTree(fsModule, gitdir, baseTreeOid, writes, removes) {
+    // Group changes by first path segment
+    const subWrites = new Map();
+    const leafWrites = new Map();
+    const subRemoves = new Map();
+    const leafRemoves = new Set();
+    for (const [path, write] of writes) {
+        const slashIdx = path.indexOf('/');
+        if (slashIdx < 0) {
+            leafWrites.set(path, write);
+        }
+        else {
+            const first = path.slice(0, slashIdx);
+            const rest = path.slice(slashIdx + 1);
+            if (!subWrites.has(first))
+                subWrites.set(first, new Map());
+            subWrites.get(first).set(rest, write);
+        }
+    }
+    for (const path of removes) {
+        const slashIdx = path.indexOf('/');
+        if (slashIdx < 0) {
+            leafRemoves.add(path);
+        }
+        else {
+            const first = path.slice(0, slashIdx);
+            const rest = path.slice(slashIdx + 1);
+            if (!subRemoves.has(first))
+                subRemoves.set(first, new Set());
+            subRemoves.get(first).add(rest);
+        }
+    }
+    // Read existing tree entries
+    let entries = [];
+    if (baseTreeOid) {
+        const { tree } = await git.readTree({ fs: fsModule, gitdir, oid: baseTreeOid });
+        entries = tree.map((e) => ({ ...e }));
+    }
+    // Build lookup: name → existing entry
+    const entryMap = new Map();
+    for (const e of entries) {
+        entryMap.set(e.path, e);
+    }
+    // Apply leaf writes (may overwrite existing entries)
+    for (const [name, write] of leafWrites) {
+        let blobOid;
+        if (write.oid) {
+            blobOid = write.oid;
+        }
+        else if (write.data) {
+            blobOid = await git.writeBlob({ fs: fsModule, gitdir, blob: write.data });
+        }
+        else {
+            throw new Error(`Write for '${name}' has neither data nor oid`);
+        }
+        entryMap.set(name, {
+            mode: write.mode,
+            path: name,
+            oid: blobOid,
+            type: typeForMode(write.mode),
+        });
+    }
+    // Apply leaf removes
+    for (const name of leafRemoves) {
+        entryMap.delete(name);
+    }
+    // Collect existing subtree OIDs
+    const existingSubtrees = new Map();
+    for (const [name, entry] of entryMap) {
+        if (entry.mode === MODE_TREE) {
+            existingSubtrees.set(name, entry.oid);
+        }
+    }
+    // Recurse into subdirectories
+    const allSubdirs = new Set([...subWrites.keys(), ...subRemoves.keys()]);
+    for (const subdir of allSubdirs) {
+        let existingOid = existingSubtrees.get(subdir) ?? null;
+        // If there's a non-tree entry at this name, remove it to make way for a tree
+        if (existingOid === null) {
+            const existing = entryMap.get(subdir);
+            if (existing && existing.mode !== MODE_TREE) {
+                entryMap.delete(subdir);
+            }
+        }
+        const newSubtreeOid = await rebuildTree(fsModule, gitdir, existingOid, subWrites.get(subdir) ?? new Map(), subRemoves.get(subdir) ?? new Set());
+        // Check if subtree is empty (prune empty directories)
+        const { tree: subtreeEntries } = await git.readTree({
+            fs: fsModule,
+            gitdir,
+            oid: newSubtreeOid,
+        });
+        if (subtreeEntries.length === 0) {
+            entryMap.delete(subdir);
+        }
+        else {
+            entryMap.set(subdir, {
+                mode: MODE_TREE,
+                path: subdir,
+                oid: newSubtreeOid,
+                type: 'tree',
+            });
+        }
+    }
+    // Write new tree from modified entries
+    const treeEntries = Array.from(entryMap.values()).map((e) => ({
+        mode: e.mode,
+        path: e.path,
+        oid: e.oid,
+        type: typeForMode(e.mode),
+    }));
+    return await git.writeTree({ fs: fsModule, gitdir, tree: treeEntries });
+}
+//# sourceMappingURL=tree.js.map

package/dist/tree.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,354 @@
+/**
+ * Shared types, constants, enums, and error classes for vost.
+ */
+/** Git filemode for tree (directory) entries. */
+export declare const MODE_TREE = "040000";
+/** Git filemode for regular blob (file) entries. */
+export declare const MODE_BLOB = "100644";
+/** Git filemode for executable blob entries. */
+export declare const MODE_BLOB_EXEC = "100755";
+/** Git filemode for symbolic link entries. */
+export declare const MODE_LINK = "120000";
+/** Convert an octal mode string (e.g. '100644') to an integer. */
+export declare function modeToInt(mode: string): number;
+/** Convert an integer filemode to a zero-padded octal string. */
+export declare function modeFromInt(mode: number): string;
+/** Return the isomorphic-git object type for a given mode string. */
+export declare function typeForMode(mode: string): 'blob' | 'tree' | 'commit';
+/**
+ * File type classification for git tree entries.
+ *
+ * - `BLOB` - Regular file (mode 100644).
+ * - `EXECUTABLE` - Executable file (mode 100755).
+ * - `LINK` - Symbolic link (mode 120000).
+ * - `TREE` - Directory (mode 040000).
+ */
+export declare const FileType: {
+    /** Regular file (mode 100644). */
+    readonly BLOB: "blob";
+    /** Executable file (mode 100755). */
+    readonly EXECUTABLE: "executable";
+    /** Symbolic link (mode 120000). */
+    readonly LINK: "link";
+    /** Directory (mode 040000). */
+    readonly TREE: "tree";
+};
+/** Union type of all FileType values. */
+export type FileType = (typeof FileType)[keyof typeof FileType];
+/**
+ * Convert a git filemode string to a FileType enum value.
+ *
+ * @param mode - Octal mode string (e.g. '100644').
+ * @returns The corresponding FileType.
+ * @throws {Error} If the mode is not recognized.
+ */
+export declare function fileTypeFromMode(mode: string): FileType;
+/**
+ * Convert a FileType enum value to a git filemode string.
+ *
+ * @param ft - FileType value.
+ * @returns The corresponding octal mode string.
+ */
+export declare function fileModeFromType(ft: FileType): string;
+/** Base error class for all vost errors. */
+export declare class GitStoreError extends Error {
+    constructor(message: string);
+}
+/**
+ * Raised when a branch has advanced since the FS snapshot was taken,
+ * causing a compare-and-swap (CAS) failure on commit.
+ */
+export declare class StaleSnapshotError extends GitStoreError {
+    constructor(message: string);
+}
+/** Raised when a path does not exist in the repository tree. */
+export declare class FileNotFoundError extends GitStoreError {
+    code: string;
+    constructor(path: string);
+}
+/** Raised when an operation expected a file but found a directory. */
+export declare class IsADirectoryError extends GitStoreError {
+    code: string;
+    constructor(path: string);
+}
+/** Raised when an operation expected a directory but found a file. */
+export declare class NotADirectoryError extends GitStoreError {
+    code: string;
+    constructor(path: string);
+}
+/** Raised when a write is attempted on a read-only snapshot (e.g. a tag). */
+export declare class PermissionError extends GitStoreError {
+    code: string;
+    constructor(message: string);
+}
+/** Raised when a branch, tag, or note key is not found. */
+export declare class KeyNotFoundError extends GitStoreError {
+    constructor(message: string);
+}
+/** Raised when a tag already exists and cannot be overwritten. */
+export declare class KeyExistsError extends GitStoreError {
+    constructor(message: string);
+}
+/** Raised when a ref name contains invalid characters. */
+export declare class InvalidRefNameError extends GitStoreError {
+    constructor(message: string);
+}
+/** Raised when a path is empty or contains invalid segments. */
+export declare class InvalidPathError extends GitStoreError {
+    constructor(message: string);
+}
+/** Raised when a batch is used after it has been committed or closed. */
+export declare class BatchClosedError extends GitStoreError {
+    constructor(message: string);
+}
+/**
+ * A file or directory entry yielded by `FS.walk()` and `FS.listdir()`.
+ */
+export interface WalkEntry {
+    /** Entry name (file or directory basename). */
+    name: string;
+    /** 40-char hex object ID (SHA). */
+    oid: string;
+    /** Git filemode string (e.g. '100644', '040000'). */
+    mode: string;
+}
+/**
+ * POSIX-like stat result for a vost path.
+ *
+ * Combines file type, size, OID, nlink, and mtime in a single structure,
+ * optimized for the FUSE `getattr` hot path.
+ */
+export interface StatResult {
+    /** Raw git filemode as integer (e.g. 0o100644, 0o040000). */
+    mode: number;
+    /** File type classification. */
+    fileType: FileType;
+    /** Object size in bytes (0 for directories). */
+    size: number;
+    /** 40-char hex SHA of the object (inode proxy). */
+    hash: string;
+    /** 1 for files/symlinks, 2 + subdirectory count for directories. */
+    nlink: number;
+    /** Commit timestamp as POSIX epoch seconds. */
+    mtime: number;
+}
+/**
+ * Return the FileType for a WalkEntry.
+ *
+ * @param entry - A walk entry from `FS.walk()` or `FS.listdir()`.
+ * @returns The FileType corresponding to the entry's mode.
+ */
+export declare function walkEntryFileType(entry: WalkEntry): FileType;
+/**
+ * Describes a single file write for `FS.apply()`.
+ *
+ * Exactly one of `data` or `target` must be provided.
+ * `target` creates a symbolic link entry; `mode` is not allowed with it.
+ */
+export interface WriteEntry {
+    /** Raw data (bytes) or text (string). Mutually exclusive with `target`. */
+    data?: Uint8Array | string;
+    /** Git filemode override (e.g. FileType.EXECUTABLE). */
+    mode?: FileType | string;
+    /** Symlink target string. Mutually exclusive with `data`. */
+    target?: string;
+}
+/**
+ * Validate a WriteEntry, throwing if both `data` and `target` are set,
+ * neither is set, or `mode` is combined with `target`.
+ */
+export declare function validateWriteEntry(entry: WriteEntry): void;
+/**
+ * A file entry in a change report, with path and type information.
+ */
+export interface FileEntry {
+    /** Repo-relative path. */
+    path: string;
+    /** File type (blob, executable, link, or tree). */
+    type: FileType;
+    /** Optional source path (for copy operations). */
+    src?: string;
+}
+/**
+ * Create a FileEntry from a path and git filemode string.
+ *
+ * @param path - Repo-relative path.
+ * @param mode - Git filemode string.
+ * @param src - Optional source path.
+ */
+export declare function fileEntryFromMode(path: string, mode: string, src?: string): FileEntry;
+/** A single action entry (add, update, or delete) for a path. */
+export interface ChangeAction {
+    /** Repo-relative path. */
+    path: string;
+    /** The kind of change. */
+    action: 'add' | 'update' | 'delete';
+}
+/** An error or warning associated with a path during a copy/sync operation. */
+export interface ChangeError {
+    /** Repo-relative path that caused the error. */
+    path: string;
+    /** Human-readable error description. */
+    error: string;
+}
+/**
+ * Report of changes from a write, copy, sync, remove, or move operation.
+ *
+ * Available on the resulting FS via `fs.changes`.
+ */
+export interface ChangeReport {
+    /** Files that were added. */
+    add: FileEntry[];
+    /** Files that were updated. */
+    update: FileEntry[];
+    /** Files that were deleted. */
+    delete: FileEntry[];
+    /** Errors encountered during the operation. */
+    errors: ChangeError[];
+    /** Warnings encountered during the operation. */
+    warnings: ChangeError[];
+}
+/** Create an empty ChangeReport with no actions or errors. */
+export declare function emptyChangeReport(): ChangeReport;
+/** Return true if the report contains no adds, updates, or deletes. */
+export declare function changeReportInSync(cr: ChangeReport): boolean;
+/** Return the total number of adds, updates, and deletes. */
+export declare function changeReportTotal(cr: ChangeReport): number;
+/** Flatten a ChangeReport into a sorted list of ChangeAction entries. */
+export declare function changeReportActions(cr: ChangeReport): ChangeAction[];
+/** Return null if the report is completely empty, otherwise return it as-is. */
+export declare function finalizeChanges(cr: ChangeReport): ChangeReport | null;
+/**
+ * Generate a commit message from a ChangeReport.
+ *
+ * If `customMessage` is provided and contains `{` placeholders, they are
+ * expanded (e.g. `{add_count}`, `{total_count}`, `{default}`).
+ * Otherwise, an auto-generated summary is used.
+ *
+ * @param changes - The change report to summarize.
+ * @param customMessage - Optional user-provided message template.
+ * @param operation - Optional operation name for auto messages (e.g. 'cp').
+ */
+export declare function formatCommitMessage(changes: ChangeReport, customMessage?: string | null, operation?: string | null): string;
+/** A single ref change in a mirror operation (backup or restore). */
+export interface RefChange {
+    /** Full ref name (e.g. 'refs/heads/main'). */
+    ref: string;
+    /** Previous target SHA, or undefined for newly created refs. */
+    oldTarget?: string;
+    /** New target SHA, or undefined for deleted refs. */
+    newTarget?: string;
+}
+/**
+ * Report of ref changes from a `backup()` or `restore()` mirror operation.
+ */
+export interface MirrorDiff {
+    /** Refs that were created. */
+    add: RefChange[];
+    /** Refs whose target changed. */
+    update: RefChange[];
+    /** Refs that were deleted. */
+    delete: RefChange[];
+}
+/** Return true if the mirror diff contains no changes. */
+export declare function mirrorDiffInSync(md: MirrorDiff): boolean;
+/** Return the total number of ref changes. */
+export declare function mirrorDiffTotal(md: MirrorDiff): number;
+/**
+ * A single reflog entry recording a branch movement.
+ */
+export interface ReflogEntry {
+    /** Previous 40-char hex commit SHA. */
+    oldSha: string;
+    /** New 40-char hex commit SHA. */
+    newSha: string;
+    /** Identity string of the committer. */
+    committer: string;
+    /** POSIX epoch seconds of the entry. */
+    timestamp: number;
+    /** Reflog message (e.g. 'commit: + file.txt'). */
+    message: string;
+}
+/**
+ * The filesystem interface expected by vost.
+ * Compatible with Node.js `fs` module and isomorphic-git's FsClient.
+ */
+export interface FsModule {
+    promises: {
+        readFile(path: string, options?: {
+            encoding?: string;
+        }): Promise<Uint8Array | string>;
+        writeFile(path: string, data: Uint8Array | string, options?: {
+            mode?: number;
+        }): Promise<void>;
+        unlink(path: string): Promise<void>;
+        readdir(path: string): Promise<string[]>;
+        mkdir(path: string, options?: {
+            recursive?: boolean;
+        }): Promise<string | undefined>;
+        rmdir(path: string): Promise<void>;
+        stat(path: string): Promise<{
+            mode: number;
+            size: number;
+            isDirectory(): boolean;
+            isFile(): boolean;
+            isSymbolicLink(): boolean;
+            mtimeMs: number;
+        }>;
+        lstat(path: string): Promise<{
+            mode: number;
+            size: number;
+            isDirectory(): boolean;
+            isFile(): boolean;
+            isSymbolicLink(): boolean;
+            mtimeMs: number;
+        }>;
+        readlink(path: string): Promise<string>;
+        symlink(target: string, path: string): Promise<void>;
+        chmod(path: string, mode: number): Promise<void>;
+        access(path: string, mode?: number): Promise<void>;
+        appendFile(path: string, data: Uint8Array | string): Promise<void>;
+        rename(path: string, newPath: string): Promise<void>;
+        open(path: string, flags: string | number, mode?: number): Promise<{
+            close(): Promise<void>;
+        }>;
+        rm?(path: string, options?: {
+            recursive?: boolean;
+            force?: boolean;
+        }): Promise<void>;
+    };
+    realpathSync(path: string): string;
+    readFile: Function;
+    writeFile: Function;
+    unlink: Function;
+    readdir: Function;
+    mkdir: Function;
+    rmdir: Function;
+    stat: Function;
+    lstat: Function;
+    readlink: Function;
+    symlink: Function;
+    chmod: Function;
+}
+/** HTTP client interface for mirror operations (compatible with isomorphic-git). */
+export interface HttpClient {
+    request: Function;
+}
+/** Author/committer identity used for commits. */
+export interface Signature {
+    /** Author name (e.g. 'vost'). */
+    name: string;
+    /** Author email (e.g. 'vost@localhost'). */
+    email: string;
+}
+/** Metadata extracted from a git commit object. */
+export interface CommitInfo {
+    /** Commit message (trailing newline stripped). */
+    message: string;
+    /** Timezone-aware commit timestamp. */
+    time: Date;
+    /** Commit author's name. */
+    authorName: string;
+    /** Commit author's email address. */
+    authorEmail: string;
+}