@mhalle/vost 0.8.1

package/dist/refdict.d.ts

@@ -0,0 +1,117 @@
+/**
+ * RefDict: Map-like access to git branches or tags.
+ */
+import { type ReflogEntry } from './types.js';
+import { FS } from './fs.js';
+import type { GitStore } from './gitstore.js';
+/**
+ * Map-like access to branches or tags.
+ *
+ * `store.branches` and `store.tags` are both `RefDict` instances.
+ * Supports `get`, `set`, `delete`, `has`, `list`, and async iteration.
+ */
+export declare class RefDict {
+    private _store;
+    private _prefix;
+    constructor(store: GitStore, prefix: string);
+    private get _isTags();
+    private get _fsModule();
+    private get _gitdir();
+    private _refName;
+    toString(): string;
+    /**
+     * Get a branch or tag as an FS snapshot.
+     *
+     * Branches return a writable FS; tags return a read-only FS.
+     *
+     * @param name - Branch or tag name.
+     * @returns FS snapshot for the ref.
+     * @throws {Error} If the branch or tag does not exist.
+     */
+    get(name: string): Promise<FS>;
+    /**
+     * Set or create a branch pointing to an FS snapshot's commit.
+     *
+     * The FS must belong to the same repository. Tags cannot be overwritten;
+     * an error is thrown if the tag already exists.
+     *
+     * @param name - Branch or tag name.
+     * @param fs - FS snapshot whose commit to point the ref at.
+     * @throws {TypeError} If fs is not an FS instance.
+     * @throws {Error} If the FS belongs to a different repository.
+     * @throws {Error} If the tag already exists (tags only).
+     */
+    set(name: string, fs: FS): Promise<void>;
+    /**
+     * Set branch to an FS snapshot and return a writable FS bound to it.
+     *
+     * Convenience method that combines `set()` and `get()`.
+     *
+     * @param name - Branch name.
+     * @param fs - FS snapshot to set (can be read-only).
+     * @returns New writable FS bound to the branch.
+     */
+    setAndGet(name: string, fs: FS): Promise<FS>;
+    /**
+     * Delete a branch or tag.
+     *
+     * @param name - Branch or tag name.
+     * @throws {Error} If the branch or tag does not exist.
+     */
+    delete(name: string): Promise<void>;
+    /**
+     * Check if a branch or tag exists.
+     *
+     * @param name - Branch or tag name.
+     * @returns True if the ref exists.
+     */
+    has(name: string): Promise<boolean>;
+    /**
+     * List all branch or tag names.
+     *
+     * @returns Array of ref names (without the refs/heads/ or refs/tags/ prefix).
+     */
+    list(): Promise<string[]>;
+    /**
+     * Async iteration over branch/tag names.
+     */
+    [Symbol.asyncIterator](): AsyncGenerator<string>;
+    /**
+     * Get the current (HEAD) branch name, or null if HEAD is dangling.
+     *
+     * Only valid for branches; throws for tags. Cheap -- does not
+     * construct an FS object.
+     *
+     * @returns Branch name string, or null.
+     * @throws {Error} If called on tags.
+     */
+    getCurrentName(): Promise<string | null>;
+    /**
+     * Get the FS for the current (HEAD) branch, or null if HEAD is dangling.
+     *
+     * Only valid for branches; throws for tags.
+     *
+     * @returns Writable FS snapshot, or null.
+     * @throws {Error} If called on tags.
+     */
+    getCurrent(): Promise<FS | null>;
+    /**
+     * Set the current branch (HEAD symbolic ref target).
+     *
+     * Only valid for branches; throws for tags.
+     *
+     * @param name - Branch name to set as current.
+     * @throws {Error} If called on tags.
+     * @throws {Error} If the branch does not exist.
+     */
+    setCurrent(name: string): Promise<void>;
+    /**
+     * Read reflog entries for a branch.
+     *
+     * @param name - Branch name (e.g. 'main').
+     * @returns List of ReflogEntry objects, newest first.
+     * @throws {Error} If called on tags.
+     * @throws {Error} If the branch does not exist.
+     */
+    reflog(name: string): Promise<ReflogEntry[]>;
+}

package/dist/refdict.js

@@ -0,0 +1,267 @@
+/**
+ * RefDict: Map-like access to git branches or tags.
+ */
+import git from 'isomorphic-git';
+import { KeyNotFoundError, KeyExistsError } from './types.js';
+import { validateRefName } from './paths.js';
+import { withRepoLock } from './lock.js';
+import { readReflog, writeReflogEntry, ZERO_SHA } from './reflog.js';
+import { FS } from './fs.js';
+/**
+ * Map-like access to branches or tags.
+ *
+ * `store.branches` and `store.tags` are both `RefDict` instances.
+ * Supports `get`, `set`, `delete`, `has`, `list`, and async iteration.
+ */
+export class RefDict {
+    _store;
+    _prefix; // "refs/heads/" or "refs/tags/"
+    constructor(store, prefix) {
+        this._store = store;
+        this._prefix = prefix;
+    }
+    get _isTags() {
+        return this._prefix === 'refs/tags/';
+    }
+    get _fsModule() {
+        return this._store._fsModule;
+    }
+    get _gitdir() {
+        return this._store._gitdir;
+    }
+    _refName(name) {
+        return `${this._prefix}${name}`;
+    }
+    toString() {
+        const kind = this._isTags ? 'tags' : 'branches';
+        return `RefDict('${kind}')`;
+    }
+    /**
+     * Get a branch or tag as an FS snapshot.
+     *
+     * Branches return a writable FS; tags return a read-only FS.
+     *
+     * @param name - Branch or tag name.
+     * @returns FS snapshot for the ref.
+     * @throws {Error} If the branch or tag does not exist.
+     */
+    async get(name) {
+        const refName = this._refName(name);
+        let oid;
+        try {
+            oid = await git.resolveRef({ fs: this._fsModule, gitdir: this._gitdir, ref: refName });
+        }
+        catch {
+            throw new KeyNotFoundError(`Key not found: ${name}`);
+        }
+        if (this._isTags) {
+            // Tags may point to annotated tag objects — peel to commit
+            const { commit } = await git.readCommit({
+                fs: this._fsModule,
+                gitdir: this._gitdir,
+                oid,
+            });
+            // oid is already the commit oid after resolveRef for lightweight tags.
+            // For annotated tags, readCommit may fail — try reading as tag first.
+            return FS._fromCommit(this._store, oid, name, false);
+        }
+        return FS._fromCommit(this._store, oid, name, true);
+    }
+    /**
+     * Set or create a branch pointing to an FS snapshot's commit.
+     *
+     * The FS must belong to the same repository. Tags cannot be overwritten;
+     * an error is thrown if the tag already exists.
+     *
+     * @param name - Branch or tag name.
+     * @param fs - FS snapshot whose commit to point the ref at.
+     * @throws {TypeError} If fs is not an FS instance.
+     * @throws {Error} If the FS belongs to a different repository.
+     * @throws {Error} If the tag already exists (tags only).
+     */
+    async set(name, fs) {
+        validateRefName(name);
+        if (!(fs instanceof FS))
+            throw new TypeError(`Expected FS, got ${typeof fs}`);
+        const selfPath = this._fsModule.realpathSync(this._gitdir);
+        const fsPath = this._fsModule.realpathSync(fs._gitdir);
+        if (selfPath !== fsPath) {
+            throw new Error('FS belongs to a different repository');
+        }
+        const refName = this._refName(name);
+        const sig = this._store._signature;
+        const committerStr = `${sig.name} <${sig.email}>`;
+        await withRepoLock(this._fsModule, this._gitdir, async () => {
+            let exists = false;
+            try {
+                await git.resolveRef({ fs: this._fsModule, gitdir: this._gitdir, ref: refName });
+                exists = true;
+            }
+            catch { /* not found */ }
+            if (exists && this._isTags) {
+                throw new KeyExistsError(`Tag '${name}' already exists`);
+            }
+            const oldSha = exists
+                ? await git.resolveRef({ fs: this._fsModule, gitdir: this._gitdir, ref: refName }).catch(() => ZERO_SHA)
+                : ZERO_SHA;
+            await git.writeRef({
+                fs: this._fsModule,
+                gitdir: this._gitdir,
+                ref: refName,
+                value: fs._commitOid,
+                force: true,
+            });
+            // Write reflog
+            const msg = exists
+                ? `branch: set to ${(await fs.getMessage()).split('\n')[0]}`
+                : `branch: Created from ${(await fs.getMessage()).split('\n')[0]}`;
+            await writeReflogEntry(this._fsModule, this._gitdir, refName, typeof oldSha === 'string' ? oldSha : ZERO_SHA, fs._commitOid, committerStr, msg);
+        });
+    }
+    /**
+     * Set branch to an FS snapshot and return a writable FS bound to it.
+     *
+     * Convenience method that combines `set()` and `get()`.
+     *
+     * @param name - Branch name.
+     * @param fs - FS snapshot to set (can be read-only).
+     * @returns New writable FS bound to the branch.
+     */
+    async setAndGet(name, fs) {
+        await this.set(name, fs);
+        return this.get(name);
+    }
+    /**
+     * Delete a branch or tag.
+     *
+     * @param name - Branch or tag name.
+     * @throws {Error} If the branch or tag does not exist.
+     */
+    async delete(name) {
+        const refName = this._refName(name);
+        await withRepoLock(this._fsModule, this._gitdir, async () => {
+            try {
+                await git.resolveRef({ fs: this._fsModule, gitdir: this._gitdir, ref: refName });
+            }
+            catch {
+                throw new KeyNotFoundError(`Key not found: ${name}`);
+            }
+            await git.deleteRef({ fs: this._fsModule, gitdir: this._gitdir, ref: refName });
+        });
+    }
+    /**
+     * Check if a branch or tag exists.
+     *
+     * @param name - Branch or tag name.
+     * @returns True if the ref exists.
+     */
+    async has(name) {
+        const refName = this._refName(name);
+        try {
+            await git.resolveRef({ fs: this._fsModule, gitdir: this._gitdir, ref: refName });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * List all branch or tag names.
+     *
+     * @returns Array of ref names (without the refs/heads/ or refs/tags/ prefix).
+     */
+    async list() {
+        if (this._isTags) {
+            return git.listTags({ fs: this._fsModule, gitdir: this._gitdir });
+        }
+        return git.listBranches({ fs: this._fsModule, gitdir: this._gitdir });
+    }
+    /**
+     * Async iteration over branch/tag names.
+     */
+    async *[Symbol.asyncIterator]() {
+        const names = await this.list();
+        for (const name of names) {
+            yield name;
+        }
+    }
+    /**
+     * Get the current (HEAD) branch name, or null if HEAD is dangling.
+     *
+     * Only valid for branches; throws for tags. Cheap -- does not
+     * construct an FS object.
+     *
+     * @returns Branch name string, or null.
+     * @throws {Error} If called on tags.
+     */
+    async getCurrentName() {
+        if (this._isTags)
+            throw new Error('Tags do not have a current branch');
+        const branch = await git.currentBranch({
+            fs: this._fsModule,
+            gitdir: this._gitdir,
+            fullname: false,
+        });
+        return branch ?? null;
+    }
+    /**
+     * Get the FS for the current (HEAD) branch, or null if HEAD is dangling.
+     *
+     * Only valid for branches; throws for tags.
+     *
+     * @returns Writable FS snapshot, or null.
+     * @throws {Error} If called on tags.
+     */
+    async getCurrent() {
+        if (this._isTags)
+            throw new Error('Tags do not have a current branch');
+        const name = await this.getCurrentName();
+        if (!name)
+            return null;
+        try {
+            return await this.get(name);
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Set the current branch (HEAD symbolic ref target).
+     *
+     * Only valid for branches; throws for tags.
+     *
+     * @param name - Branch name to set as current.
+     * @throws {Error} If called on tags.
+     * @throws {Error} If the branch does not exist.
+     */
+    async setCurrent(name) {
+        if (this._isTags)
+            throw new Error('Tags do not have a current branch');
+        if (!(await this.has(name)))
+            throw new Error(`Branch not found: '${name}'`);
+        await git.writeRef({
+            fs: this._fsModule,
+            gitdir: this._gitdir,
+            ref: 'HEAD',
+            value: `refs/heads/${name}`,
+            symbolic: true,
+            force: true,
+        });
+    }
+    /**
+     * Read reflog entries for a branch.
+     *
+     * @param name - Branch name (e.g. 'main').
+     * @returns List of ReflogEntry objects, newest first.
+     * @throws {Error} If called on tags.
+     * @throws {Error} If the branch does not exist.
+     */
+    async reflog(name) {
+        if (this._isTags)
+            throw new Error('Tags do not have reflog');
+        if (!(await this.has(name)))
+            throw new KeyNotFoundError(`Key not found: ${name}`);
+        return readReflog(this._fsModule, this._gitdir, name);
+    }
+}
+//# sourceMappingURL=refdict.js.map

package/dist/refdict.js.map

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

package/dist/reflog.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Reflog read/write using direct filesystem access.
+ *
+ * Git reflog format (one line per entry):
+ *   <old-sha> <new-sha> <committer> <timestamp> <tz>\t<message>\n
+ */
+import type { FsModule, ReflogEntry } from './types.js';
+/** The all-zeros SHA used for newly-created refs in reflog entries. */
+declare const ZERO_SHA = "0000000000000000000000000000000000000000";
+/**
+ * Read reflog entries for a branch.
+ * Returns entries in chronological order (oldest first).
+ *
+ * @param fsModule   - Node.js-compatible fs module.
+ * @param gitdir     - Path to the bare git repository.
+ * @param branchName - Branch name (e.g. "main").
+ * @returns Array of {@link ReflogEntry} objects.
+ * @throws Error if no reflog file exists for the branch.
+ */
+export declare function readReflog(fsModule: FsModule, gitdir: string, branchName: string): Promise<ReflogEntry[]>;
+/**
+ * Append a reflog entry for a ref update.
+ *
+ * @param fsModule  - Node.js-compatible fs module.
+ * @param gitdir    - Path to the bare git repository.
+ * @param refName   - Full ref name (e.g. "refs/heads/main").
+ * @param oldSha    - Previous 40-char hex commit SHA (ZERO_SHA for new refs).
+ * @param newSha    - New 40-char hex commit SHA.
+ * @param committer - Identity string (e.g. "vost \<vost@localhost\>").
+ * @param message   - Reflog message (e.g. "commit: + file.txt").
+ */
+export declare function writeReflogEntry(fsModule: FsModule, gitdir: string, refName: string, oldSha: string, newSha: string, committer: string, message: string): Promise<void>;
+export { ZERO_SHA };

package/dist/reflog.js

@@ -0,0 +1,83 @@
+/**
+ * Reflog read/write using direct filesystem access.
+ *
+ * Git reflog format (one line per entry):
+ *   <old-sha> <new-sha> <committer> <timestamp> <tz>\t<message>\n
+ */
+/** The all-zeros SHA used for newly-created refs in reflog entries. */
+const ZERO_SHA = '0000000000000000000000000000000000000000';
+/**
+ * Read reflog entries for a branch.
+ * Returns entries in chronological order (oldest first).
+ *
+ * @param fsModule   - Node.js-compatible fs module.
+ * @param gitdir     - Path to the bare git repository.
+ * @param branchName - Branch name (e.g. "main").
+ * @returns Array of {@link ReflogEntry} objects.
+ * @throws Error if no reflog file exists for the branch.
+ */
+export async function readReflog(fsModule, gitdir, branchName) {
+    const reflogPath = `${gitdir}/logs/refs/heads/${branchName}`;
+    let data;
+    try {
+        const raw = await fsModule.promises.readFile(reflogPath, { encoding: 'utf8' });
+        data = typeof raw === 'string' ? raw : new TextDecoder().decode(raw);
+    }
+    catch (err) {
+        if (err?.code === 'ENOENT') {
+            throw new Error(`No reflog found for branch '${branchName}'`);
+        }
+        throw err;
+    }
+    const entries = [];
+    for (const line of data.split('\n')) {
+        if (!line.trim())
+            continue;
+        // Format: <old> <new> <committer> <timestamp> <tz>\t<message>
+        const tabIdx = line.indexOf('\t');
+        const message = tabIdx >= 0 ? line.slice(tabIdx + 1) : '';
+        const header = tabIdx >= 0 ? line.slice(0, tabIdx) : line;
+        // Parse header: old_sha new_sha committer_name <email> timestamp tz
+        const oldSha = header.slice(0, 40);
+        const newSha = header.slice(41, 81);
+        const rest = header.slice(82); // "Name <email> timestamp tz"
+        // Extract timestamp: find the last two space-separated tokens
+        const parts = rest.split(' ');
+        const tz = parts.pop() ?? '+0000';
+        const timestampStr = parts.pop() ?? '0';
+        const committer = parts.join(' ');
+        entries.push({
+            oldSha,
+            newSha,
+            committer,
+            timestamp: parseInt(timestampStr, 10),
+            message,
+        });
+    }
+    return entries;
+}
+/**
+ * Append a reflog entry for a ref update.
+ *
+ * @param fsModule  - Node.js-compatible fs module.
+ * @param gitdir    - Path to the bare git repository.
+ * @param refName   - Full ref name (e.g. "refs/heads/main").
+ * @param oldSha    - Previous 40-char hex commit SHA (ZERO_SHA for new refs).
+ * @param newSha    - New 40-char hex commit SHA.
+ * @param committer - Identity string (e.g. "vost \<vost@localhost\>").
+ * @param message   - Reflog message (e.g. "commit: + file.txt").
+ */
+export async function writeReflogEntry(fsModule, gitdir, refName, oldSha, newSha, committer, message) {
+    // Construct reflog path: refs/heads/main → logs/refs/heads/main
+    const reflogPath = `${gitdir}/logs/${refName}`;
+    // Create parent directories
+    const parentDir = reflogPath.slice(0, reflogPath.lastIndexOf('/'));
+    await fsModule.promises.mkdir(parentDir, { recursive: true });
+    // Format entry
+    const timestamp = Math.floor(Date.now() / 1000);
+    const line = `${oldSha} ${newSha} ${committer} ${timestamp} +0000\t${message}\n`;
+    // Append
+    await fsModule.promises.appendFile(reflogPath, line);
+}
+export { ZERO_SHA };
+//# sourceMappingURL=reflog.js.map

package/dist/reflog.js.map

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

package/dist/tree.d.ts

@@ -0,0 +1,79 @@
+/**
+ * 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 { type FsModule, type WalkEntry } from './types.js';
+export interface TreeWrite {
+    /** Raw blob data (will create blob). Mutually exclusive with oid. */
+    data?: Uint8Array;
+    /** Existing blob OID (skip blob creation). Mutually exclusive with data. */
+    oid?: string;
+    /** Git mode string (default: '100644'). */
+    mode: string;
+}
+/**
+ * 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 declare function modeFromDisk(fsModule: FsModule, localPath: string): Promise<string>;
+interface TreeEntryResult {
+    oid: string;
+    mode: string;
+    type: string;
+    path: string;
+}
+/**
+ * Walk through tree to the object at the given path.
+ * Returns the final tree entry.
+ */
+export declare function walkTo(fsModule: FsModule, gitdir: string, treeOid: string, path: string): Promise<TreeEntryResult>;
+/**
+ * Return { oid, mode } of the entry at path, or null if missing.
+ */
+export declare function entryAtPath(fsModule: FsModule, gitdir: string, treeOid: string, path: string): Promise<{
+    oid: string;
+    mode: string;
+} | null>;
+/**
+ * Read a blob at the given path in the tree.
+ */
+export declare function readBlobAtPath(fsModule: FsModule, gitdir: string, treeOid: string, path: string): Promise<Uint8Array>;
+/**
+ * List entry names at the given path (or root if path is null/empty).
+ */
+export declare function listTreeAtPath(fsModule: FsModule, gitdir: string, treeOid: string, path?: string | null): Promise<string[]>;
+/**
+ * List full entries at the given path (or root if path is null/empty).
+ */
+export declare function listEntriesAtPath(fsModule: FsModule, gitdir: string, treeOid: string, path?: string | null): Promise<WalkEntry[]>;
+/**
+ * Walk the tree recursively, yielding (dirpath, dirnames, fileEntries).
+ */
+export declare function walkTree(fsModule: FsModule, gitdir: string, treeOid: string, prefix?: string): AsyncGenerator<[string, string[], WalkEntry[]]>;
+/**
+ * Check if a path exists in the tree.
+ */
+export declare function existsAtPath(fsModule: FsModule, gitdir: string, treeOid: string, path: string): Promise<boolean>;
+/**
+ * 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 declare function countSubdirs(fsModule: FsModule, gitdir: string, treeOid: string): Promise<number>;
+/**
+ * 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 declare function rebuildTree(fsModule: FsModule, gitdir: string, baseTreeOid: string | null, writes: Map<string, TreeWrite>, removes: Set<string>): Promise<string>;
+export {};