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

package/dist/ops.js

@@ -0,0 +1,130 @@
+import { mkdir } from "node:fs/promises";
+import { commandLine, configureRepo, } from "./configure.js";
+import { gitConfig, GitCommandError, GitKitError, runGit } from "./git.js";
+import { LfsClient, lfsEndpoint } from "./lfs/client.js";
+import { pointersBetween } from "./lfs/push.js";
+import { LocalObjects } from "./lfs/store.js";
+const REMOTE = "origin";
+function identityArgs(author) {
+    return author
+        ? ["-c", `user.name=${author.name}`, "-c", `user.email=${author.email}`]
+        : [];
+}
+async function hasRemote(dir) {
+    return (await gitConfig(dir, `remote.${REMOTE}.url`)) !== undefined;
+}
+async function resolve(dir, ref) {
+    if (ref.startsWith("-"))
+        throw new GitKitError("invalid", `Invalid ref: ${ref}`);
+    const { code, stdout } = await runGit(["rev-parse", "--verify", "--quiet", `${ref}^{commit}`], {
+        cwd: dir,
+        okCodes: [1, 128],
+    });
+    return code === 0 ? stdout.toString("utf8").trim() : null;
+}
+/** The current branch. Throws `detached` when HEAD is not on a branch. */
+export async function currentBranch(dir) {
+    const { code, stdout } = await runGit(["symbolic-ref", "--quiet", "--short", "HEAD"], { cwd: dir, okCodes: [1, 128] });
+    if (code !== 0)
+        throw new GitKitError("detached", "Not on a revision branch");
+    return stdout.toString("utf8").trim();
+}
+/** Uploads the LFS objects of commits the remote does not have yet. Returns how many were sent. */
+export async function uploadMedia(dir, refs = ["HEAD"]) {
+    const pointers = await pointersBetween(dir, refs, [], REMOTE);
+    if (pointers.length === 0)
+        return 0;
+    const client = new LfsClient(dir, await lfsEndpoint(dir, REMOTE), await LocalObjects.open(dir));
+    return client.upload(pointers);
+}
+function pushError(branch, error) {
+    const stderr = error instanceof GitCommandError ? error.stderr : String(error);
+    if (/pre-receive hook declined|may not update|protected branch/i.test(stderr)) {
+        return new GitKitError("push_denied", `You cannot save to ${branch} directly; start a revision first`, { cause: error });
+    }
+    if (/non-fast-forward|fetch first|\[rejected\]|failed to push some refs/i.test(stderr)) {
+        return new GitKitError("push_rejected", `Someone else saved ${branch} first; sync, then save again`, { cause: error });
+    }
+    if (/Authentication failed|403|401/i.test(stderr)) {
+        return new GitKitError("auth", `Not allowed to save: ${stderr.trim()}`, {
+            cause: error,
+        });
+    }
+    return error instanceof GitKitError
+        ? error
+        : new GitKitError("git", stderr, { cause: error });
+}
+/** Stages everything, commits, uploads new media and pushes the current branch. */
+export async function save({ dir, message, author, }) {
+    const branch = await currentBranch(dir);
+    await runGit(["add", "--all"], { cwd: dir });
+    const { code: clean } = await runGit(["diff", "--cached", "--quiet"], {
+        cwd: dir,
+        okCodes: [1],
+    });
+    const committed = clean === 1;
+    if (committed)
+        await runGit([...identityArgs(author), "commit", "--quiet", "-F", "-"], {
+            cwd: dir,
+            input: message,
+        });
+    const sha = await resolve(dir, "HEAD");
+    if (!sha)
+        return { committed, branch, sha: "", pushed: false, uploaded: 0 };
+    if (!(await hasRemote(dir)))
+        return { committed, branch, sha, pushed: false, uploaded: 0 };
+    // Upload media first, so saving works even where the pre-push hook is not installed.
+    const uploaded = await uploadMedia(dir);
+    try {
+        await runGit([
+            "push",
+            "--quiet",
+            "--set-upstream",
+            REMOTE,
+            `HEAD:refs/heads/${branch}`,
+        ], { cwd: dir });
+    }
+    catch (error) {
+        throw pushError(branch, error);
+    }
+    return { committed, branch, sha, pushed: true, uploaded };
+}
+/**
+ * Clones a repository with our credential helper and LFS client from the start: clone without
+ * checkout, configure, then check out (media downloads through the smudge filter).
+ */
+export async function clone({ url, dir, branch, ...options }) {
+    await mkdir(dir, { recursive: true });
+    let host;
+    try {
+        host = new URL(url).origin;
+    }
+    catch {
+        host = undefined;
+    }
+    const helper = host && options.credentials !== false
+        ? [
+            "-c",
+            `credential.${host}.helper=`,
+            "-c",
+            `credential.${host}.helper=!${commandLine(options, "git-credential")}`,
+            "-c",
+            `credential.${host}.useHttpPath=true`,
+        ]
+        : [];
+    await runGit([
+        ...helper,
+        "clone",
+        "--quiet",
+        "--no-checkout",
+        ...(branch ? ["--branch", branch] : []),
+        "--",
+        url,
+        ".",
+    ], { cwd: dir });
+    await configureRepo(dir, { ...options, attributes: false });
+    // An empty remote has no HEAD yet: nothing to check out.
+    if (await resolve(dir, "HEAD"))
+        await runGit(["reset", "--quiet", "--hard", "HEAD"], { cwd: dir });
+}
+//# sourceMappingURL=ops.js.map

package/dist/ops.js.map

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

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@huozi-ai/git-kit",
+  "version": "0.1.0-alpha.0",
+  "license": "Apache-2.0",
+  "description": "Client-side git for people who never touch git: a credential helper that fetches short-lived tokens, a Git LFS client (clean, smudge, pre-push), and clone and save on top of the git binary.",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "NOTICE",
+    "dist"
+  ],
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "eslint": "^9.39.4",
+    "rimraf": "^6.1.3",
+    "tsx": "^4.23.15",
+    "typescript": "~5.9.3",
+    "@huozi-ai/eslint-config": "0.0.0",
+    "@huozi-ai/typescript-config": "0.0.0",
+    "@huozi-ai/repo-host": "0.1.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=22.19"
+  },
+  "scripts": {
+    "build": "rimraf dist && tsc -b",
+    "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p test/tsconfig.json",
+    "lint": "eslint . --max-warnings 0",
+    "test": "node --import tsx --test \"test/**/*.test.ts\""
+  }
+}