@huozi-ai/git-kit 0.1.0-alpha.0

package/dist/git.d.ts

@@ -0,0 +1,50 @@
+export interface GitRunOptions {
+    cwd: string;
+    input?: string | Buffer;
+    /** Extra environment, on top of the current one. */
+    env?: NodeJS.ProcessEnv;
+    /** Exit codes that are not errors. */
+    okCodes?: number[];
+}
+export interface GitResult {
+    code: number;
+    stdout: Buffer;
+    stderr: string;
+}
+export type GitKitErrorCode = 
+/** The folder is not a git repository, or has no remote. */
+"not_a_repo"
+/** HEAD is not on a branch. */
+ | "detached"
+/** The remote refused the push because of the token's ref rules (for example the production branch). */
+ | "push_denied"
+/** The remote has changes we do not have yet: sync first. */
+ | "push_rejected"
+/** Both sides changed the same lines; `paths` lists the files. Nothing was changed locally. */
+ | "conflict"
+/** Local changes would be overwritten. */
+ | "local_changes" | "not_found" | "invalid"
+/** An LFS object is missing, could not be uploaded or downloaded. */
+ | "lfs" | "auth" | "git";
+export declare class GitKitError extends Error {
+    readonly code: GitKitErrorCode;
+    readonly paths: string[];
+    constructor(code: GitKitErrorCode, message: string, options?: {
+        paths?: string[];
+        cause?: unknown;
+    });
+}
+export declare class GitCommandError extends GitKitError {
+    readonly exitCode: number;
+    readonly stderr: string;
+    constructor(args: string[], exitCode: number, stderr: string);
+}
+/** The environment for git: the user's, without terminal prompts. */
+export declare function gitEnv(extra?: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
+export declare function runGit(args: string[], options: GitRunOptions): Promise<GitResult>;
+export declare function gitText(args: string[], options: GitRunOptions): Promise<string>;
+/** A git config value, or `undefined` when it is not set. */
+export declare function gitConfig(cwd: string, key: string): Promise<string | undefined>;
+/** Quotes one word for the POSIX shell git uses to run filters, hooks and helpers. */
+export declare function shellQuote(word: string): string;
+//# sourceMappingURL=git.d.ts.map

package/dist/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../src/git.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,oDAAoD;IACpD,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,eAAe;AACzB,4DAA4D;AAC1D,YAAY;AACd,+BAA+B;GAC7B,UAAU;AACZ,wGAAwG;GACtG,aAAa;AACf,6DAA6D;GAC3D,eAAe;AACjB,+FAA+F;GAC7F,UAAU;AACZ,0CAA0C;GACxC,eAAe,GACf,WAAW,GACX,SAAS;AACX,qEAAqE;GACnE,KAAK,GACL,MAAM,GACN,KAAK,CAAC;AAEV,qBAAa,WAAY,SAAQ,KAAK;IACpC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;gBAEvB,IAAI,EAAE,eAAe,EACrB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO;CAOtD;AAED,qBAAa,eAAgB,SAAQ,WAAW;IAC9C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBACZ,IAAI,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAQ7D;AAED,qEAAqE;AACrE,wBAAgB,MAAM,CAAC,KAAK,GAAE,MAAM,CAAC,UAAe,GAAG,MAAM,CAAC,UAAU,CAEvE;AAED,wBAAgB,MAAM,CACpB,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,SAAS,CAAC,CA2BpB;AAED,wBAAsB,OAAO,CAC3B,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,MAAM,CAAC,CAEjB;AAED,6DAA6D;AAC7D,wBAAsB,SAAS,CAC7B,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAM7B;AAED,sFAAsF;AACtF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG/C"}

package/dist/git.js

@@ -0,0 +1,71 @@
+import { spawn } from "node:child_process";
+export class GitKitError extends Error {
+    code;
+    paths;
+    constructor(code, message, options = {}) {
+        super(message, { cause: options.cause });
+        this.name = "GitKitError";
+        this.code = code;
+        this.paths = options.paths ?? [];
+    }
+}
+export class GitCommandError extends GitKitError {
+    exitCode;
+    stderr;
+    constructor(args, exitCode, stderr) {
+        super("git", `git ${args.join(" ")} failed (${String(exitCode)}): ${stderr.trim()}`);
+        this.exitCode = exitCode;
+        this.stderr = stderr;
+    }
+}
+/** The environment for git: the user's, without terminal prompts. */
+export function gitEnv(extra = {}) {
+    return { ...process.env, GIT_TERMINAL_PROMPT: "0", ...extra };
+}
+export function runGit(args, options) {
+    return new Promise((resolve, reject) => {
+        const child = spawn("git", args, {
+            cwd: options.cwd,
+            env: gitEnv(options.env),
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        const out = [];
+        const err = [];
+        child.stdout.on("data", (chunk) => out.push(chunk));
+        child.stderr.on("data", (chunk) => err.push(chunk));
+        child.on("error", reject);
+        child.on("close", (code) => {
+            const result = {
+                code: code ?? -1,
+                stdout: Buffer.concat(out),
+                stderr: Buffer.concat(err).toString("utf8"),
+            };
+            if (result.code === 0 || options.okCodes?.includes(result.code))
+                resolve(result);
+            else
+                reject(new GitCommandError(args, result.code, result.stderr));
+        });
+        child.stdin.on("error", () => {
+            // git may exit before reading its input; the exit code says why.
+        });
+        child.stdin.end(options.input);
+    });
+}
+export async function gitText(args, options) {
+    return (await runGit(args, options)).stdout.toString("utf8").trim();
+}
+/** A git config value, or `undefined` when it is not set. */
+export async function gitConfig(cwd, key) {
+    const { code, stdout } = await runGit(["config", "--get", key], {
+        cwd,
+        okCodes: [1],
+    });
+    return code === 0 ? stdout.toString("utf8").trim() : undefined;
+}
+/** Quotes one word for the POSIX shell git uses to run filters, hooks and helpers. */
+export function shellQuote(word) {
+    if (/^[A-Za-z0-9_./:@%+=,-]+$/.test(word))
+        return word;
+    return `'${word.replace(/'/g, `'\\''`)}'`;
+}
+//# sourceMappingURL=git.js.map

package/dist/git.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+export { gitConfig, GitCommandError, GitKitError, runGit, shellQuote, } from "./git.js";
+export type { GitResult, GitRunOptions } from "./git.js";
+export type { GitKitErrorCode } from "./git.js";
+export { credentialHelper, formatCredential, parseCredentialInput, repoFromPath, } from "./credential.js";
+export type { Credential, CredentialProvider, CredentialRequest, } from "./credential.js";
+export { formatPointer, MAX_POINTER_SIZE, parsePointer, POINTER_VERSION, } from "./lfs/pointer.js";
+export type { LfsPointer } from "./lfs/pointer.js";
+export { LocalObjects } from "./lfs/store.js";
+export { endpointFromRemote, LfsClient, lfsEndpoint } from "./lfs/client.js";
+export { cleanFile, filterProcess, LfsFilter, smudgeFile, } from "./lfs/filter.js";
+export { parsePrePushInput, pointersBetween, prePush } from "./lfs/push.js";
+export { commandLine, configureRepo, ensureGitattributes, MEDIA_EXTENSIONS, mediaAttributes, } from "./configure.js";
+export type { ConfigureOptions, ConfigureResult, GitKitCommand, } from "./configure.js";
+export { processIO, runCredentialCommand, runLfsCommand } from "./commands.js";
+export type { CommandIO } from "./commands.js";
+export { clone, currentBranch, save, uploadMedia } from "./ops.js";
+export type { Identity, SaveResult } from "./ops.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,eAAe,EACf,WAAW,EACX,MAAM,EACN,UAAU,GACX,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzD,YAAY,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,YAAY,GACb,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,UAAU,EACV,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC7E,OAAO,EACL,SAAS,EACT,aAAa,EACb,SAAS,EACT,UAAU,GACX,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,EACL,WAAW,EACX,aAAa,EACb,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,GAChB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,aAAa,GACd,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC/E,YAAY,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACnE,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+export { gitConfig, GitCommandError, GitKitError, runGit, shellQuote, } from "./git.js";
+export { credentialHelper, formatCredential, parseCredentialInput, repoFromPath, } from "./credential.js";
+export { formatPointer, MAX_POINTER_SIZE, parsePointer, POINTER_VERSION, } from "./lfs/pointer.js";
+export { LocalObjects } from "./lfs/store.js";
+export { endpointFromRemote, LfsClient, lfsEndpoint } from "./lfs/client.js";
+export { cleanFile, filterProcess, LfsFilter, smudgeFile, } from "./lfs/filter.js";
+export { parsePrePushInput, pointersBetween, prePush } from "./lfs/push.js";
+export { commandLine, configureRepo, ensureGitattributes, MEDIA_EXTENSIONS, mediaAttributes, } from "./configure.js";
+export { processIO, runCredentialCommand, runLfsCommand } from "./commands.js";
+export { clone, currentBranch, save, uploadMedia } from "./ops.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,eAAe,EACf,WAAW,EACX,MAAM,EACN,UAAU,GACX,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,YAAY,GACb,MAAM,iBAAiB,CAAC;AAMzB,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC7E,OAAO,EACL,SAAS,EACT,aAAa,EACb,SAAS,EACT,UAAU,GACX,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,EACL,WAAW,EACX,aAAa,EACb,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,GAChB,MAAM,gBAAgB,CAAC;AAMxB,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE/E,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC"}

package/dist/lfs/client.d.ts

@@ -0,0 +1,47 @@
+import type { LfsPointer } from "./pointer.js";
+import type { LocalObjects } from "./store.js";
+/** `https://host/ws_1.git` → `https://host/ws_1.git/info/lfs` (the git-lfs default for a remote). */
+export declare function endpointFromRemote(remoteUrl: string): string;
+/** The LFS endpoint: `lfs.url`, else derived from the remote's URL. */
+export declare function lfsEndpoint(cwd: string, remote?: string): Promise<string>;
+interface Action {
+    href: string;
+    header?: Record<string, string>;
+}
+interface BatchObject {
+    oid: string;
+    size: number;
+    error?: {
+        code: number;
+        message?: string;
+    };
+    actions?: {
+        download?: Action;
+        upload?: Action;
+        verify?: Action;
+    };
+}
+/**
+ * A Git LFS batch API client (https://github.com/git-lfs/git-lfs/blob/main/docs/api/batch.md),
+ * basic transfers only. Credentials come from `git credential fill`, so the same helper that
+ * serves git (our CLI) serves LFS, and the token never appears in config or URLs.
+ */
+export declare class LfsClient {
+    private readonly cwd;
+    private readonly endpoint;
+    private readonly objects;
+    private credential;
+    constructor(cwd: string, endpoint: string, objects: LocalObjects);
+    private credentialInput;
+    private authorization;
+    /** Tells git whether the credential worked, so helpers can cache or forget it. */
+    private report;
+    batch(operation: "download" | "upload", objects: LfsPointer[]): Promise<BatchObject[]>;
+    /** Downloads objects into the local store, checking each sha256. */
+    download(pointers: LfsPointer[]): Promise<void>;
+    private fetchInto;
+    /** Uploads the objects the server does not have yet. Returns how many were sent. */
+    upload(pointers: LfsPointer[]): Promise<number>;
+}
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/lfs/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/lfs/client.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAM/C,qGAAqG;AACrG,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAG5D;AAED,uEAAuE;AACvE,wBAAsB,WAAW,CAC/B,GAAG,EAAE,MAAM,EACX,MAAM,SAAW,GAChB,OAAO,CAAC,MAAM,CAAC,CAYjB;AAED,UAAU,MAAM;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED,UAAU,WAAW;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACnE;AAiBD;;;;GAIG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,UAAU,CAAqC;gBAE3C,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY;IAMhE,OAAO,CAAC,eAAe;YAQT,aAAa;IAuB3B,kFAAkF;YACpE,MAAM;IAWd,KAAK,CACT,SAAS,EAAE,UAAU,GAAG,QAAQ,EAChC,OAAO,EAAE,UAAU,EAAE,GACpB,OAAO,CAAC,WAAW,EAAE,CAAC;IAqCzB,oEAAoE;IAC9D,QAAQ,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;YAmBvC,SAAS;IAuCvB,oFAAoF;IAC9E,MAAM,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;CA2DtD"}

package/dist/lfs/client.js

@@ -0,0 +1,216 @@
+import { createHash } from "node:crypto";
+import { openAsBlob } from "node:fs";
+import { mkdir, open, rename, rm } from "node:fs/promises";
+import { dirname } from "node:path";
+import { Readable } from "node:stream";
+import { gitConfig, GitKitError, runGit } from "../git.js";
+const LFS_TYPE = "application/vnd.git-lfs+json";
+/** Transfers at the same time. */
+const CONCURRENCY = 4;
+/** `https://host/ws_1.git` → `https://host/ws_1.git/info/lfs` (the git-lfs default for a remote). */
+export function endpointFromRemote(remoteUrl) {
+    const url = remoteUrl.replace(/\/+$/, "");
+    return url.endsWith(".git") ? `${url}/info/lfs` : `${url}.git/info/lfs`;
+}
+/** The LFS endpoint: `lfs.url`, else derived from the remote's URL. */
+export async function lfsEndpoint(cwd, remote = "origin") {
+    const configured = await gitConfig(cwd, "lfs.url");
+    if (configured)
+        return configured.replace(/\/+$/, "");
+    const remoteUrl = /^[a-z][a-z0-9+.-]*:\/\//i.test(remote)
+        ? remote
+        : await gitConfig(cwd, `remote.${remote}.url`);
+    if (!remoteUrl)
+        throw new GitKitError("not_a_repo", `No URL for remote ${remote}; set lfs.url`);
+    return endpointFromRemote(remoteUrl);
+}
+async function inBatches(items, run) {
+    const queue = [...items];
+    const workers = Array.from({ length: Math.min(CONCURRENCY, queue.length) }, async () => {
+        for (let item = queue.shift(); item !== undefined; item = queue.shift())
+            await run(item);
+    });
+    await Promise.all(workers);
+}
+/**
+ * A Git LFS batch API client (https://github.com/git-lfs/git-lfs/blob/main/docs/api/batch.md),
+ * basic transfers only. Credentials come from `git credential fill`, so the same helper that
+ * serves git (our CLI) serves LFS, and the token never appears in config or URLs.
+ */
+export class LfsClient {
+    cwd;
+    endpoint;
+    objects;
+    credential;
+    constructor(cwd, endpoint, objects) {
+        this.cwd = cwd;
+        this.endpoint = endpoint;
+        this.objects = objects;
+    }
+    credentialInput(extra = {}) {
+        const lines = [
+            `url=${this.endpoint}`,
+            ...Object.entries(extra).map(([k, v]) => `${k}=${v}`),
+        ];
+        return `${lines.join("\n")}\n\n`;
+    }
+    async authorization() {
+        if (!this.credential) {
+            const { code, stdout, stderr } = await runGit(["credential", "fill"], {
+                cwd: this.cwd,
+                input: this.credentialInput(),
+                okCodes: [128],
+            });
+            if (code !== 0)
+                throw new GitKitError("auth", `No credentials for ${this.endpoint}: ${stderr.trim()}`);
+            const values = {};
+            for (const line of stdout.toString("utf8").split("\n")) {
+                const eq = line.indexOf("=");
+                if (eq > 0)
+                    values[line.slice(0, eq)] = line.slice(eq + 1);
+            }
+            this.credential = values;
+        }
+        const { username = "", password = "" } = this.credential;
+        return `Basic ${Buffer.from(`${username}:${password}`).toString("base64")}`;
+    }
+    /** Tells git whether the credential worked, so helpers can cache or forget it. */
+    async report(ok) {
+        if (!this.credential)
+            return;
+        const { username = "", password = "" } = this.credential;
+        await runGit(["credential", ok ? "approve" : "reject"], {
+            cwd: this.cwd,
+            input: this.credentialInput({ username, password }),
+            okCodes: [128],
+        });
+        if (!ok)
+            this.credential = undefined;
+    }
+    async batch(operation, objects) {
+        if (objects.length === 0)
+            return [];
+        const body = JSON.stringify({
+            operation,
+            transfers: ["basic"],
+            objects: objects.map(({ oid, size }) => ({ oid, size })),
+            hash_algo: "sha256",
+        });
+        for (let attempt = 0;; attempt++) {
+            const res = await fetch(`${this.endpoint}/objects/batch`, {
+                method: "POST",
+                headers: {
+                    Accept: LFS_TYPE,
+                    "Content-Type": LFS_TYPE,
+                    Authorization: await this.authorization(),
+                },
+                body,
+            });
+            if (res.status === 401 && attempt === 0) {
+                await res.arrayBuffer();
+                await this.report(false);
+                continue;
+            }
+            if (!res.ok) {
+                const text = await res.text();
+                await this.report(false);
+                throw new GitKitError(res.status === 401 || res.status === 403 ? "auth" : "lfs", `LFS ${operation} refused (${String(res.status)}): ${text}`);
+            }
+            await this.report(true);
+            const data = (await res.json());
+            return data.objects ?? [];
+        }
+    }
+    /** Downloads objects into the local store, checking each sha256. */
+    async download(pointers) {
+        const wanted = [];
+        for (const p of pointers)
+            if (!(await this.objects.has(p.oid, p.size)))
+                wanted.push(p);
+        const answers = await this.batch("download", wanted);
+        await inBatches(answers, async (object) => {
+            if (object.error) {
+                throw new GitKitError("lfs", `LFS object ${object.oid} is not on the server: ${object.error.message ?? String(object.error.code)}`);
+            }
+            const link = object.actions?.download;
+            if (!link)
+                throw new GitKitError("lfs", `No download link for ${object.oid}`);
+            await this.fetchInto(link, object.oid, object.size);
+        });
+    }
+    async fetchInto(link, oid, size) {
+        const res = await fetch(link.href, { headers: link.header ?? {} });
+        if (!res.ok || !res.body)
+            throw new GitKitError("lfs", `Downloading ${oid} failed (${String(res.status)})`);
+        const tmp = await this.objects.tempFile();
+        const hash = createHash("sha256");
+        let seen = 0;
+        const handle = await open(tmp, "w");
+        try {
+            for await (const chunk of Readable.fromWeb(res.body)) {
+                hash.update(chunk);
+                seen += chunk.length;
+                await handle.write(chunk);
+            }
+        }
+        finally {
+            await handle.close();
+        }
+        const digest = hash.digest("hex");
+        if (digest !== oid || seen !== size) {
+            await rm(tmp, { force: true });
+            throw new GitKitError("lfs", `Downloaded ${oid} but got ${digest} (${String(seen)} bytes)`);
+        }
+        const target = this.objects.path(oid);
+        await mkdir(dirname(target), { recursive: true });
+        await rename(tmp, target);
+    }
+    /** Uploads the objects the server does not have yet. Returns how many were sent. */
+    async upload(pointers) {
+        const answers = await this.batch("upload", pointers);
+        for (const object of answers) {
+            if (object.actions?.upload &&
+                !(await this.objects.has(object.oid, object.size))) {
+                throw new GitKitError("lfs", `LFS object ${object.oid} is missing here and on the server`);
+            }
+        }
+        let sent = 0;
+        await inBatches(answers, async (object) => {
+            if (object.error)
+                throw new GitKitError("lfs", `Server refused ${object.oid}: ${object.error.message ?? String(object.error.code)}`);
+            const upload = object.actions?.upload;
+            if (!upload)
+                return;
+            const blob = await openAsBlob(this.objects.path(object.oid));
+            const put = await fetch(upload.href, {
+                method: "PUT",
+                headers: {
+                    "Content-Type": "application/octet-stream",
+                    ...(upload.header ?? {}),
+                },
+                body: blob,
+            });
+            await put.arrayBuffer();
+            if (!put.ok)
+                throw new GitKitError("lfs", `Uploading ${object.oid} failed (${String(put.status)})`);
+            const verify = object.actions?.verify;
+            if (verify) {
+                const res = await fetch(verify.href, {
+                    method: "POST",
+                    headers: {
+                        Accept: LFS_TYPE,
+                        "Content-Type": LFS_TYPE,
+                        ...(verify.header ?? {}),
+                    },
+                    body: JSON.stringify({ oid: object.oid, size: object.size }),
+                });
+                await res.arrayBuffer();
+                if (!res.ok)
+                    throw new GitKitError("lfs", `The server could not verify ${object.oid} (${String(res.status)})`);
+            }
+            sent++;
+        });
+        return sent;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/lfs/client.js.map

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

package/dist/lfs/filter.d.ts

@@ -0,0 +1,39 @@
+import type { Writable } from "node:stream";
+import { LfsClient } from "./client.js";
+import { LocalObjects } from "./store.js";
+/** Where content goes: one call per chunk, awaited for backpressure. */
+export type Sink = (chunk: Buffer) => Promise<void>;
+export declare function sinkFor(out: Writable): Sink;
+/** A filter's answer, ready to be written once we know the filter succeeded. */
+export interface Answer {
+    write(sink: Sink): Promise<void>;
+}
+/** State shared by the files of one filter run: the store and a lazily created LFS client. */
+export declare class LfsFilter {
+    private readonly cwd;
+    private objectsPromise;
+    private clientPromise;
+    constructor(cwd: string);
+    objects(): Promise<LocalObjects>;
+    client(): Promise<LfsClient>;
+    /**
+     * clean: working-tree content → pointer. The bytes go into the local store; content that is
+     * already a pointer passes through unchanged (as git-lfs does).
+     */
+    clean(input: AsyncIterable<Buffer | Uint8Array>): Promise<Answer>;
+    /**
+     * smudge: pointer → content, from the local store or downloaded through the batch API. Content
+     * that is not a pointer passes through. With `GIT_LFS_SKIP_SMUDGE=1` the pointer stays.
+     */
+    smudge(input: AsyncIterable<Buffer | Uint8Array>): Promise<Answer>;
+}
+/** Single-file `clean` (`filter.lfs.clean`): stdin → stdout. */
+export declare function cleanFile(cwd: string, input: AsyncIterable<Buffer | Uint8Array>, output: Writable): Promise<void>;
+/** Single-file `smudge` (`filter.lfs.smudge`): stdin → stdout. */
+export declare function smudgeFile(cwd: string, input: AsyncIterable<Buffer | Uint8Array>, output: Writable): Promise<void>;
+/**
+ * git's long-running filter protocol (`filter.lfs.process`, see gitattributes(5)): one process per
+ * git command handles every file, which is much faster than one process per file.
+ */
+export declare function filterProcess(cwd: string, input: AsyncIterable<Buffer | Uint8Array>, output: Writable, log?: (message: string) => void): Promise<void>;
+//# sourceMappingURL=filter.d.ts.map

package/dist/lfs/filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../../src/lfs/filter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAe,MAAM,aAAa,CAAC;AAGrD,OAAO,EAAE,YAAY,EAAgB,MAAM,YAAY,CAAC;AAExD,wEAAwE;AACxE,MAAM,MAAM,IAAI,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAEpD,wBAAgB,OAAO,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI,CAW3C;AAED,gFAAgF;AAChF,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClC;AAwBD,8FAA8F;AAC9F,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,cAAc,CAAoC;IAC1D,OAAO,CAAC,aAAa,CAAiC;gBAE1C,GAAG,EAAE,MAAM;IAIvB,OAAO,IAAI,OAAO,CAAC,YAAY,CAAC;IAKhC,MAAM,IAAI,OAAO,CAAC,SAAS,CAAC;IAU5B;;;OAGG;IACG,KAAK,CAAC,KAAK,EAAE,aAAa,CAAC,MAAM,GAAG,UAAU,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAavE;;;OAGG;IACG,MAAM,CAAC,KAAK,EAAE,aAAa,CAAC,MAAM,GAAG,UAAU,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;CAUzE;AAED,gEAAgE;AAChE,wBAAsB,SAAS,CAC7B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,aAAa,CAAC,MAAM,GAAG,UAAU,CAAC,EACzC,MAAM,EAAE,QAAQ,GACf,OAAO,CAAC,IAAI,CAAC,CAEf;AAED,kEAAkE;AAClE,wBAAsB,UAAU,CAC9B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,aAAa,CAAC,MAAM,GAAG,UAAU,CAAC,EACzC,MAAM,EAAE,QAAQ,GACf,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,aAAa,CAAC,MAAM,GAAG,UAAU,CAAC,EACzC,MAAM,EAAE,QAAQ,EAChB,GAAG,GAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAA4C,GACrE,OAAO,CAAC,IAAI,CAAC,CAwDf"}

package/dist/lfs/filter.js

@@ -0,0 +1,148 @@
+import { createReadStream } from "node:fs";
+import { LfsClient, lfsEndpoint } from "./client.js";
+import { PktReader, PktWriter } from "./pktline.js";
+import { formatPointer, parsePointer } from "./pointer.js";
+import { LocalObjects } from "./store.js";
+export function sinkFor(out) {
+    return (chunk) => new Promise((resolve, reject) => {
+        if (out.write(chunk, (error) => {
+            if (error)
+                reject(error);
+        }))
+            resolve();
+        else
+            out.once("drain", resolve);
+    });
+}
+function bytes(data) {
+    return { write: (sink) => sink(data) };
+}
+function file(path, after) {
+    return {
+        async write(sink) {
+            try {
+                for await (const chunk of createReadStream(path))
+                    await sink(chunk);
+            }
+            finally {
+                await after?.();
+            }
+        },
+    };
+}
+function spooledAnswer(objects, spooled) {
+    if (spooled.file)
+        return file(spooled.file, () => objects.discard(spooled));
+    return bytes(spooled.small ?? Buffer.alloc(0));
+}
+/** State shared by the files of one filter run: the store and a lazily created LFS client. */
+export class LfsFilter {
+    cwd;
+    objectsPromise;
+    clientPromise;
+    constructor(cwd) {
+        this.cwd = cwd;
+    }
+    objects() {
+        this.objectsPromise ??= LocalObjects.open(this.cwd);
+        return this.objectsPromise;
+    }
+    client() {
+        this.clientPromise ??= (async () => new LfsClient(this.cwd, await lfsEndpoint(this.cwd), await this.objects()))();
+        return this.clientPromise;
+    }
+    /**
+     * clean: working-tree content → pointer. The bytes go into the local store; content that is
+     * already a pointer passes through unchanged (as git-lfs does).
+     */
+    async clean(input) {
+        const objects = await this.objects();
+        const spooled = await objects.spool(input);
+        if (spooled.small && parsePointer(spooled.small))
+            return bytes(spooled.small);
+        if (await objects.has(spooled.oid, spooled.size))
+            await objects.discard(spooled);
+        else
+            await objects.adopt(spooled);
+        return bytes(Buffer.from(formatPointer({ oid: spooled.oid, size: spooled.size })));
+    }
+    /**
+     * smudge: pointer → content, from the local store or downloaded through the batch API. Content
+     * that is not a pointer passes through. With `GIT_LFS_SKIP_SMUDGE=1` the pointer stays.
+     */
+    async smudge(input) {
+        const objects = await this.objects();
+        const spooled = await objects.spool(input);
+        const pointer = spooled.small ? parsePointer(spooled.small) : null;
+        if (!pointer || process.env["GIT_LFS_SKIP_SMUDGE"] === "1")
+            return spooledAnswer(objects, spooled);
+        if (!(await objects.has(pointer.oid, pointer.size)))
+            await (await this.client()).download([pointer]);
+        return file(objects.path(pointer.oid));
+    }
+}
+/** Single-file `clean` (`filter.lfs.clean`): stdin → stdout. */
+export async function cleanFile(cwd, input, output) {
+    await (await new LfsFilter(cwd).clean(input)).write(sinkFor(output));
+}
+/** Single-file `smudge` (`filter.lfs.smudge`): stdin → stdout. */
+export async function smudgeFile(cwd, input, output) {
+    await (await new LfsFilter(cwd).smudge(input)).write(sinkFor(output));
+}
+/**
+ * git's long-running filter protocol (`filter.lfs.process`, see gitattributes(5)): one process per
+ * git command handles every file, which is much faster than one process per file.
+ */
+export async function filterProcess(cwd, input, output, log = (m) => process.stderr.write(`${m}\n`)) {
+    const reader = new PktReader(input);
+    const writer = new PktWriter(output);
+    const hello = await reader.readList();
+    if (!hello?.includes("git-filter-client") || !hello.includes("version=2")) {
+        throw new Error("Expected git-filter-client version 2");
+    }
+    await writer.list(["git-filter-server", "version=2"]);
+    const offered = (await reader.readList()) ?? [];
+    await writer.list(["capability=clean", "capability=smudge"].filter((c) => offered.includes(c)));
+    const filter = new LfsFilter(cwd);
+    for (;;) {
+        const headers = await reader.readList();
+        if (headers === undefined)
+            return;
+        const fields = new Map(headers.map((h) => [
+            h.slice(0, h.indexOf("=")),
+            h.slice(h.indexOf("=") + 1),
+        ]));
+        const command = fields.get("command") ?? "";
+        const pathname = fields.get("pathname") ?? "";
+        const content = reader.readContent();
+        let answer;
+        try {
+            if (command === "clean")
+                answer = await filter.clean(content);
+            else if (command === "smudge")
+                answer = await filter.smudge(content);
+            else
+                throw new Error(`Unknown filter command: ${command}`);
+        }
+        catch (error) {
+            for await (const _ of content) {
+                // Skip what is left of this file before answering.
+            }
+            log(`huozi lfs ${command} ${pathname}: ${error instanceof Error ? error.message : String(error)}`);
+            await writer.list(["status=error"]);
+            continue;
+        }
+        await writer.list(["status=success"]);
+        try {
+            await answer.write((chunk) => writer.packet(chunk));
+            await writer.flush();
+            await writer.flush(); // Status unchanged: success.
+        }
+        catch (error) {
+            log(`huozi lfs ${command} ${pathname}: ${error instanceof Error ? error.message : String(error)}`);
+            await writer.flush();
+            await writer.list(["status=error"]);
+        }
+    }
+}
+//# sourceMappingURL=filter.js.map