@volter/browser-toolbelt 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Volter Browser Substrate contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,9 @@
+# `@volter/browser-toolbelt`
+
+Optional developer commands for Browser Substrate: an AST shell, Git,
+GitHub-device authentication, and project sharing. `installBrowserToolbelt`
+registers them with an existing `BrowserRuntime`.
+
+The package is deliberately separate from the kernel and execution engines. A
+consumer can replace or omit these commands without changing workspace,
+process, port, or preview behavior.

package/dist/browser-git-filesystem.d.ts

@@ -0,0 +1,18 @@
+import type { BrowserFileSystem } from "@volter/browser-runtime/browser-filesystem.js";
+import type { FsClient } from "isomorphic-git";
+/** Promise-style Node fs subset backed directly by the shared browser VFS. */
+export declare class BrowserGitFileSystem {
+    private readonly filesystem;
+    readonly client: FsClient;
+    constructor(filesystem: BrowserFileSystem);
+    private readFile;
+    private writeFile;
+    private unlink;
+    private readdir;
+    private mkdir;
+    private rmdir;
+    private stat;
+    private chmod;
+    private unsupportedLink;
+}
+//# sourceMappingURL=browser-git-filesystem.d.ts.map

package/dist/browser-git-filesystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-git-filesystem.d.ts","sourceRoot":"","sources":["../src/browser-git-filesystem.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;AACvF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAK/C,8EAA8E;AAC9E,qBAAa,oBAAoB;IAGnB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAFvC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;gBAEG,UAAU,EAAE,iBAAiB;YAkB5C,QAAQ;YAcR,SAAS;YAUT,MAAM;YACN,OAAO;YACP,KAAK;YACL,KAAK;YAEL,IAAI;YAIJ,KAAK;YAKL,eAAe;CAG9B"}

package/dist/browser-git-filesystem.js

@@ -0,0 +1,84 @@
+/** Promise-style Node fs subset backed directly by the shared browser VFS. */
+export class BrowserGitFileSystem {
+    filesystem;
+    client;
+    constructor(filesystem) {
+        this.filesystem = filesystem;
+        this.client = {
+            promises: {
+                readFile: (path, options) => this.readFile(path, options),
+                writeFile: (path, data) => this.writeFile(path, data),
+                unlink: (path) => this.unlink(path),
+                readdir: (path) => this.readdir(path),
+                mkdir: (path) => this.mkdir(path),
+                rmdir: (path) => this.rmdir(path),
+                stat: (path) => this.stat(path),
+                lstat: (path) => this.stat(path),
+                readlink: (path) => this.unsupportedLink("readlink", path),
+                symlink: (_target, path) => this.unsupportedLink("symlink", path),
+                chmod: (path, mode) => this.chmod(path, mode),
+            },
+        };
+    }
+    async readFile(path, options) {
+        const bytes = this.filesystem.readFileSync(path);
+        const encoding = typeof options === "string" ? options : options?.encoding;
+        if (!encoding || encoding === "buffer")
+            return bytes;
+        if (encoding === "latin1" || encoding === "binary") {
+            let value = "";
+            for (let offset = 0; offset < bytes.byteLength; offset += 0x8000) {
+                value += String.fromCharCode(...bytes.subarray(offset, offset + 0x8000));
+            }
+            return value;
+        }
+        return new TextDecoder().decode(bytes);
+    }
+    async writeFile(path, data) {
+        const parent = dirname(path);
+        this.filesystem.mkdirSync(parent, { recursive: true });
+        if (typeof data === "string" || data instanceof Uint8Array) {
+            this.filesystem.writeFileSync(path, data);
+            return;
+        }
+        this.filesystem.writeFileSync(path, new Uint8Array(data.buffer, data.byteOffset, data.byteLength));
+    }
+    async unlink(path) { this.filesystem.unlinkSync(path); }
+    async readdir(path) { return this.filesystem.readdirSync(path); }
+    async mkdir(path) { this.filesystem.mkdirSync(path, { recursive: true }); }
+    async rmdir(path) { this.filesystem.rmdirSync(path); }
+    async stat(path) {
+        return gitStat(this.filesystem.statSync(path));
+    }
+    async chmod(path, mode) {
+        this.filesystem.statSync(path);
+        this.filesystem.chmodSync(path, mode);
+    }
+    async unsupportedLink(operation, path) {
+        throw Object.assign(new Error(`ENOSYS: ${operation} '${path}'`), { code: "ENOSYS", path });
+    }
+}
+function dirname(path) {
+    const normalized = path.replace(/\/+$/u, "");
+    const index = normalized.lastIndexOf("/");
+    return index <= 0 ? "/" : normalized.slice(0, index);
+}
+function gitStat(value) {
+    const mtimeMs = value.mtimeMs ?? Date.now();
+    return {
+        isFile: () => value.isFile(),
+        isDirectory: () => value.isDirectory(),
+        isSymbolicLink: () => false,
+        mode: value.mode ?? (value.isDirectory() ? 0o755 : 0o644),
+        size: value.size,
+        mtime: new Date(mtimeMs),
+        mtimeMs,
+        ctime: new Date(mtimeMs),
+        ctimeMs: mtimeMs,
+        uid: 1000,
+        gid: 1000,
+        ino: 0,
+        dev: 0,
+    };
+}
+//# sourceMappingURL=browser-git-filesystem.js.map

package/dist/browser-git-filesystem.js.map

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

package/dist/browser-git-http.d.ts

@@ -0,0 +1,32 @@
+import type { HttpClient } from "isomorphic-git";
+export type GitAuthorizationProvider = () => Promise<string | undefined> | string | undefined;
+export interface BrowserGitHttpOptions {
+    /**
+     * Git proxy endpoint accepting one encoded `url` query parameter: an
+     * absolute URL on the relay service, or a same-origin absolute path when the
+     * embedding page proxies the route itself. Defaults to `/api/git`.
+     */
+    proxyUrl?: string;
+    /** Exact HTTPS Git hosts the browser may ask that proxy to reach. */
+    allowedHosts?: readonly string[];
+    /**
+     * Supplies the `Authorization` header value for each request (for GitHub, a
+     * Basic credential built from a device-flow token). The proxy forwards it
+     * upstream unchanged and never holds it.
+     */
+    authorization?: GitAuthorizationProvider;
+    fetch?: typeof globalThis.fetch;
+}
+/** Smart-HTTP client over the relay service's Git proxy; the proxy owns the vendor allowlist. */
+export declare class BrowserGitHttp {
+    readonly client: HttpClient;
+    private readonly allowedHosts;
+    private readonly proxyUrl;
+    private readonly authorization;
+    private readonly fetch;
+    constructor(options?: BrowserGitHttpOptions);
+    private request;
+}
+/** An absolute http(s) URL or a same-origin absolute path, without query or fragment. */
+export declare function normalizeProxyUrl(value: string): string;
+//# sourceMappingURL=browser-git-http.d.ts.map

package/dist/browser-git-http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-git-http.d.ts","sourceRoot":"","sources":["../src/browser-git-http.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmC,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAKlF,MAAM,MAAM,wBAAwB,GAAG,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,GAAG,MAAM,GAAG,SAAS,CAAC;AAE9F,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC;;;;OAIG;IACH,aAAa,CAAC,EAAE,wBAAwB,CAAC;IACzC,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACjC;AAED,iGAAiG;AACjG,qBAAa,cAAc;IACzB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAmD;IAC9E,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAsB;IACnD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAuC;IACrE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA0B;gBAEpC,OAAO,GAAE,qBAA0B;YAUjC,OAAO;CAuCtB;AAED,yFAAyF;AACzF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAavD"}

package/dist/browser-git-http.js

@@ -0,0 +1,127 @@
+const MAXIMUM_BODY_BYTES = 32 * 1024 * 1024;
+const FORWARDED_HEADERS = ["Accept", "Content-Type", "Git-Protocol"];
+/** Smart-HTTP client over the relay service's Git proxy; the proxy owns the vendor allowlist. */
+export class BrowserGitHttp {
+    client = { request: (request) => this.request(request) };
+    allowedHosts;
+    proxyUrl;
+    authorization;
+    fetch;
+    constructor(options = {}) {
+        this.allowedHosts = new Set(options.allowedHosts ?? ["github.com"]);
+        if (this.allowedHosts.size === 0 || [...this.allowedHosts].some((host) => !validHostname(host))) {
+            throw new Error("Browser Git requires at least one exact valid HTTPS hostname.");
+        }
+        this.proxyUrl = normalizeProxyUrl(options.proxyUrl ?? "/api/git");
+        this.authorization = options.authorization;
+        this.fetch = options.fetch ?? globalThis.fetch.bind(globalThis);
+    }
+    async request(request) {
+        const target = new URL(request.url);
+        if (target.protocol !== "https:" || !this.allowedHosts.has(target.hostname) || target.port) {
+            throw new Error("Browser Git target is not on the embedding's exact HTTPS host allowlist.");
+        }
+        const method = request.method ?? "GET";
+        const body = request.body ? await collect(request.body, MAXIMUM_BODY_BYTES) : undefined;
+        const proxied = `${this.proxyUrl}?url=${encodeURIComponent(target.href)}`;
+        const headers = {};
+        for (const name of FORWARDED_HEADERS) {
+            const value = request.headers?.[name] ?? request.headers?.[name.toLowerCase()];
+            if (value)
+                headers[name] = value;
+        }
+        const authorization = await this.authorization?.();
+        if (authorization)
+            headers.Authorization = authorization;
+        const response = await this.fetch(proxied, {
+            method,
+            headers,
+            body: body ? new Blob([Uint8Array.from(body)]) : null,
+            mode: "cors",
+            credentials: "omit",
+            redirect: "error",
+        });
+        const length = Number(response.headers.get("Content-Length"));
+        if (Number.isFinite(length) && length > MAXIMUM_BODY_BYTES) {
+            await response.body?.cancel();
+            throw new Error("Git smart-HTTP response exceeded the browser byte limit.");
+        }
+        const responseHeaders = {};
+        response.headers.forEach((value, key) => { responseHeaders[key] = value; });
+        return {
+            url: target.href,
+            method,
+            statusCode: response.status,
+            statusMessage: response.statusText,
+            headers: responseHeaders,
+            ...(response.body ? { body: boundedIterator(response.body, MAXIMUM_BODY_BYTES) } : {}),
+        };
+    }
+}
+/** An absolute http(s) URL or a same-origin absolute path, without query or fragment. */
+export function normalizeProxyUrl(value) {
+    if (/[?#]/u.test(value))
+        throw new Error("Git proxyUrl must not carry a query or fragment.");
+    if (value.startsWith("/")) {
+        if (value.startsWith("//"))
+            throw new Error("Git proxyUrl path must be same-origin.");
+        return value;
+    }
+    let url;
+    try {
+        url = new URL(value);
+    }
+    catch {
+        throw new Error("Git proxyUrl must be an absolute URL or a same-origin absolute path.");
+    }
+    if ((url.protocol !== "https:" && url.protocol !== "http:") || url.username || url.password) {
+        throw new Error("Git proxyUrl must be an HTTP(S) URL without credentials.");
+    }
+    return url.href;
+}
+function validHostname(hostname) {
+    return hostname === hostname.toLowerCase()
+        && hostname.length <= 253
+        && !hostname.endsWith(".")
+        && hostname.split(".").every((label) => /^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$/u.test(label));
+}
+async function collect(body, maximum) {
+    const chunks = [];
+    let total = 0;
+    for await (const chunk of body) {
+        total += chunk.byteLength;
+        if (total > maximum)
+            throw new Error("Git smart-HTTP request exceeded the browser byte limit.");
+        chunks.push(chunk);
+    }
+    const output = new Uint8Array(total);
+    let offset = 0;
+    for (const chunk of chunks) {
+        output.set(chunk, offset);
+        offset += chunk.byteLength;
+    }
+    return output;
+}
+function boundedIterator(stream, maximum) {
+    const reader = stream.getReader();
+    let total = 0;
+    return {
+        async next() {
+            const result = await reader.read();
+            if (result.done)
+                return { done: true, value: undefined };
+            total += result.value.byteLength;
+            if (total > maximum) {
+                await reader.cancel("Git smart-HTTP response exceeded the browser byte limit.");
+                throw new Error("Git smart-HTTP response exceeded the browser byte limit.");
+            }
+            return { done: false, value: result.value };
+        },
+        async return() {
+            await reader.cancel();
+            return { done: true, value: undefined };
+        },
+        [Symbol.asyncIterator]() { return this; },
+    };
+}
+//# sourceMappingURL=browser-git-http.js.map

package/dist/browser-git-http.js.map

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

package/dist/browser-git.d.ts

@@ -0,0 +1,38 @@
+import type { BrowserFileSystem } from "@volter/browser-runtime/browser-filesystem.js";
+import type { HttpClient } from "isomorphic-git";
+import type { BrowserShellProgramRunner } from "./browser-shell.js";
+export interface BrowserGitOptions {
+    /** Supply an embedding-owned smart-HTTP transport instead of the default edge client. */
+    http?: HttpClient;
+}
+/** Local Git CLI surface operating entirely on the shared browser VFS. */
+export declare class BrowserGit {
+    private readonly filesystem;
+    readonly run: BrowserShellProgramRunner;
+    private readonly fs;
+    private readonly http;
+    constructor(filesystem: BrowserFileSystem, options?: BrowserGitOptions);
+    private execute;
+    private initialize;
+    private clone;
+    private status;
+    private add;
+    private remove;
+    private commit;
+    private config;
+    private log;
+    private branch;
+    private checkout;
+    private diff;
+    private entryContent;
+    private revParse;
+    private lsFiles;
+    private remote;
+    private fetch;
+    private pull;
+    private push;
+    private remoteUrl;
+    private repositoryRoot;
+    private removeTree;
+}
+//# sourceMappingURL=browser-git.d.ts.map

package/dist/browser-git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-git.d.ts","sourceRoot":"","sources":["../src/browser-git.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;AACvF,OAAO,KAAK,EAAE,UAAU,EAAe,MAAM,gBAAgB,CAAC;AAG9D,OAAO,KAAK,EACV,yBAAyB,EAG1B,MAAM,oBAAoB,CAAC;AAW5B,MAAM,WAAW,iBAAiB;IAChC,yFAAyF;IACzF,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAED,0EAA0E;AAC1E,qBAAa,UAAU;IAKT,OAAO,CAAC,QAAQ,CAAC,UAAU;IAJvC,QAAQ,CAAC,GAAG,EAAE,yBAAyB,CAAC;IACxC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;IACpB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;gBAEL,UAAU,EAAE,iBAAiB,EAAE,OAAO,GAAE,iBAAsB;YAM7E,OAAO;YAsCP,UAAU;YAeV,KAAK;YA0BL,MAAM;YAaN,GAAG;YAeH,MAAM;YAYN,MAAM;YAwBN,MAAM;YAYN,GAAG;YAeH,MAAM;YAeN,QAAQ;YASR,IAAI;YA8CJ,YAAY;YAQZ,QAAQ;YASR,OAAO;YAKP,MAAM;YA8BN,KAAK;YAkBL,IAAI;YAkBJ,IAAI;YA2BJ,SAAS;IAIvB,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,UAAU;CAMnB"}