just-git 1.2.12 → 1.3.0

package/README.md

@@ -64,31 +64,33 @@ Both `fs` and `cwd` can be set once in `createGit` and overridden per-call. `cwd
 Stand up a git server with built-in storage (SQLite or PostgreSQL), branch protection, auth, and push hooks:
 
 ```ts
-import { createGitServer, createStandardHooks, BunSqliteStorage } from "just-git/server";
+import { createServer, BunSqliteStorage } from "just-git/server";
 import { getChangedFiles } from "just-git/repo";
 import { Database } from "bun:sqlite";
 
-const storage = new BunSqliteStorage(new Database("repos.sqlite"));
-
-const server = createGitServer({
-  resolveRepo: (path) => storage.repo(path),
-  hooks: createStandardHooks({
-    protectedBranches: ["main"],
-    authorizePush: (request) => request.headers.has("Authorization"),
-    onPush: async ({ repo, repoPath, updates }) => {
+const server = createServer({
+  storage: new BunSqliteStorage(new Database("repos.sqlite")),
+  autoCreate: true,
+  policy: { protectedBranches: ["main"] },
+  hooks: {
+    preReceive: ({ session }) => {
+      if (!session?.request?.headers.has("Authorization"))
+        return { reject: true, message: "unauthorized" };
+    },
+    postReceive: async ({ repo, repoPath, updates }) => {
       for (const u of updates) {
         const files = await getChangedFiles(repo, u.oldHash, u.newHash);
         console.log(`${repoPath}: ${u.ref} — ${files.length} files changed`);
       }
     },
-  }),
+  },
 });
 
 Bun.serve({ fetch: server.fetch });
 // git clone http://localhost:3000/my-repo ← works with real git
 ```
 
-Uses web-standard `Request`/`Response`. Works with Bun, Hono, Cloudflare Workers, or any fetch-compatible runtime. For Node.js, use `toNodeHandler(server)` with `http.createServer` and `BetterSqlite3Storage` for `better-sqlite3`. Use `withAuth` to gate clone and fetch access as well. See [SERVER.md](docs/SERVER.md) for the full API.
+Uses web-standard `Request`/`Response`. Works with Bun, Hono, Cloudflare Workers, or any fetch-compatible runtime. For Node.js, use `server.nodeHandler` with `http.createServer` and `BetterSqlite3Storage` for `better-sqlite3`. SSH is supported via `server.handleSession`. See [SERVER.md](docs/SERVER.md) for the full API.
 
 ## Repo module
 
@@ -115,6 +117,7 @@ See [REPO.md](docs/REPO.md) for the full API, the `GitRepo` interface, and the h
 - **Local paths**: direct filesystem transfer between repositories.
 - **Cross-VFS**: clone, fetch, and push between isolated in-memory filesystems via `resolveRemote`. See [CLIENT.md](docs/CLIENT.md#multi-agent-collaboration).
 - **Smart HTTP**: clone, fetch, and push against real Git servers (e.g. GitHub) via Git Smart HTTP protocol. Auth via `credentials` option or `GIT_HTTP_BEARER_TOKEN` / `GIT_HTTP_USER` + `GIT_HTTP_PASSWORD` env vars.
+- **In-process server**: connect a git client to a `GitServer` without any network stack via `server.asNetwork()`. All server hooks, sessions, and policy enforcement work identically to real HTTP. See [CLIENT.md](docs/CLIENT.md#in-process-server).
 
 ### Internals
 

package/dist/{hooks-4DvkF2xT.d.ts → hooks-BtbyLyYE.d.ts}

@@ -89,6 +89,13 @@ interface FileSystem {
     symlink?(target: string, path: string): Promise<void>;
 }
 
+/** A fully resolved (non-delta) object from a packfile. */
+interface PackObject {
+    type: ObjectType;
+    content: Uint8Array;
+    hash: ObjectId;
+}
+
 /** 40-character lowercase hex SHA-1 hash. */
 type ObjectId = string;
 /** The four Git object types. */
@@ -196,6 +203,12 @@ interface ObjectStore {
     write(type: ObjectType, content: Uint8Array): Promise<ObjectId>;
     exists(hash: ObjectId): Promise<boolean>;
     ingestPack(packData: Uint8Array): Promise<number>;
+    /**
+     * Ingest pre-resolved objects from a streaming source.
+     * Accepts the output of `readPackStreaming` — each yielded
+     * `PackObject` has type, content, and hash already computed.
+     */
+    ingestPackStream(entries: AsyncIterable<PackObject>): Promise<number>;
     /** Return all object hashes matching a hex prefix (for short hash resolution). */
     findByPrefix(prefix: string): Promise<ObjectId[]>;
     /**
@@ -634,4 +647,4 @@ interface GitHooks {
  */
 declare function composeGitHooks(...hookSets: (GitHooks | undefined)[]): GitHooks;
 
-export { type Identity as $, type AfterCommandEvent as A, type BeforeCommandEvent as B, type CredentialProvider as C, type PrePullEvent as D, type ExecResult as E, type FileSystem as F, type GitHooks as G, type HttpAuth as H, type IdentityOverride as I, type PrePushEvent as J, type PreRebaseEvent as K, type PreResetEvent as L, type MergeMsgEvent as M, type NetworkPolicy as N, type ObjectStore as O, type PostCheckoutEvent as P, type PreRevertEvent as Q, type RemoteResolver as R, type PreRmEvent as S, type PreStashEvent as T, type RefDeleteEvent as U, type RefEntry as V, type RefUpdateEvent as W, type Rejection as X, composeGitHooks as Y, isRejection as Z, type ObjectId as _, type RefStore as a, type TreeDiffEntry as a0, type Commit as a1, type ObjectType as a2, type RawObject as a3, type Ref as a4, type ConfigOverrides as b, type FileStat as c, type GitContext as d, type CommitMsgEvent as e, type GitRepo as f, type ObjectWriteEvent as g, type PostCherryPickEvent as h, type PostCleanEvent as i, type PostCloneEvent as j, type PostCommitEvent as k, type PostFetchEvent as l, type PostMergeEvent as m, type PostPullEvent as n, type PostPushEvent as o, type PostResetEvent as p, type PostRevertEvent as q, type PostRmEvent as r, type PostStashEvent as s, type PreCheckoutEvent as t, type PreCherryPickEvent as u, type PreCleanEvent as v, type PreCloneEvent as w, type PreCommitEvent as x, type PreFetchEvent as y, type PreMergeCommitEvent as z };
+export { type Identity as $, type AfterCommandEvent as A, type BeforeCommandEvent as B, type CredentialProvider as C, type PrePullEvent as D, type ExecResult as E, type FileSystem as F, type GitHooks as G, type HttpAuth as H, type IdentityOverride as I, type PrePushEvent as J, type PreRebaseEvent as K, type PreResetEvent as L, type MergeMsgEvent as M, type NetworkPolicy as N, type ObjectStore as O, type PostCheckoutEvent as P, type PreRevertEvent as Q, type RemoteResolver as R, type PreRmEvent as S, type PreStashEvent as T, type RefDeleteEvent as U, type RefEntry as V, type RefUpdateEvent as W, type Rejection as X, composeGitHooks as Y, isRejection as Z, type ObjectId as _, type RefStore as a, type TreeDiffEntry as a0, type Commit as a1, type ObjectType as a2, type RawObject as a3, type PackObject as a4, type Ref as a5, type ConfigOverrides as b, type FileStat as c, type GitContext as d, type CommitMsgEvent as e, type GitRepo as f, type ObjectWriteEvent as g, type PostCherryPickEvent as h, type PostCleanEvent as i, type PostCloneEvent as j, type PostCommitEvent as k, type PostFetchEvent as l, type PostMergeEvent as m, type PostPullEvent as n, type PostPushEvent as o, type PostResetEvent as p, type PostRevertEvent as q, type PostRmEvent as r, type PostStashEvent as s, type PreCheckoutEvent as t, type PreCherryPickEvent as u, type PreCleanEvent as v, type PreCloneEvent as w, type PreCommitEvent as x, type PreFetchEvent as y, type PreMergeCommitEvent as z };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { F as FileSystem, G as GitHooks, C as CredentialProvider, I as IdentityOverride, N as NetworkPolicy, R as RemoteResolver, O as ObjectStore, a as RefStore, b as ConfigOverrides, E as ExecResult, c as FileStat, d as GitContext } from './hooks-4DvkF2xT.js';
-export { A as AfterCommandEvent, B as BeforeCommandEvent, e as CommitMsgEvent, f as GitRepo, H as HttpAuth, M as MergeMsgEvent, g as ObjectWriteEvent, P as PostCheckoutEvent, h as PostCherryPickEvent, i as PostCleanEvent, j as PostCloneEvent, k as PostCommitEvent, l as PostFetchEvent, m as PostMergeEvent, n as PostPullEvent, o as PostPushEvent, p as PostResetEvent, q as PostRevertEvent, r as PostRmEvent, s as PostStashEvent, t as PreCheckoutEvent, u as PreCherryPickEvent, v as PreCleanEvent, w as PreCloneEvent, x as PreCommitEvent, y as PreFetchEvent, z as PreMergeCommitEvent, D as PrePullEvent, J as PrePushEvent, K as PreRebaseEvent, L as PreResetEvent, Q as PreRevertEvent, S as PreRmEvent, T as PreStashEvent, U as RefDeleteEvent, V as RefEntry, W as RefUpdateEvent, X as Rejection, Y as composeGitHooks, Z as isRejection } from './hooks-4DvkF2xT.js';
+import { F as FileSystem, G as GitHooks, C as CredentialProvider, I as IdentityOverride, N as NetworkPolicy, R as RemoteResolver, O as ObjectStore, a as RefStore, b as ConfigOverrides, E as ExecResult, c as FileStat, d as GitContext } from './hooks-BtbyLyYE.js';
+export { A as AfterCommandEvent, B as BeforeCommandEvent, e as CommitMsgEvent, f as GitRepo, H as HttpAuth, M as MergeMsgEvent, g as ObjectWriteEvent, P as PostCheckoutEvent, h as PostCherryPickEvent, i as PostCleanEvent, j as PostCloneEvent, k as PostCommitEvent, l as PostFetchEvent, m as PostMergeEvent, n as PostPullEvent, o as PostPushEvent, p as PostResetEvent, q as PostRevertEvent, r as PostRmEvent, s as PostStashEvent, t as PreCheckoutEvent, u as PreCherryPickEvent, v as PreCleanEvent, w as PreCloneEvent, x as PreCommitEvent, y as PreFetchEvent, z as PreMergeCommitEvent, D as PrePullEvent, J as PrePushEvent, K as PreRebaseEvent, L as PreResetEvent, Q as PreRevertEvent, S as PreRmEvent, T as PreStashEvent, U as RefDeleteEvent, V as RefEntry, W as RefUpdateEvent, X as Rejection, Y as composeGitHooks, Z as isRejection } from './hooks-BtbyLyYE.js';
 
 /** Options for subcommand execution (mirrors just-bash's CommandExecOptions). */
 interface CommandExecOptions {
@@ -23,7 +23,7 @@ interface CommandContext {
     signal?: AbortSignal;
 }
 /** Git subcommand name. Used with {@link GitOptions.disabled} to block specific commands. */
-type GitCommandName = "init" | "clone" | "fetch" | "pull" | "push" | "add" | "blame" | "commit" | "status" | "log" | "branch" | "tag" | "checkout" | "diff" | "reset" | "merge" | "cherry-pick" | "revert" | "rebase" | "mv" | "rm" | "remote" | "config" | "show" | "stash" | "rev-parse" | "ls-files" | "clean" | "switch" | "restore" | "reflog" | "repack" | "gc" | "bisect" | "grep";
+type GitCommandName = "init" | "clone" | "fetch" | "pull" | "push" | "add" | "blame" | "commit" | "status" | "log" | "branch" | "tag" | "checkout" | "describe" | "diff" | "reset" | "merge" | "cherry-pick" | "revert" | "rebase" | "mv" | "rm" | "remote" | "config" | "show" | "stash" | "rev-parse" | "ls-files" | "clean" | "switch" | "restore" | "reflog" | "repack" | "gc" | "bisect" | "grep";
 /**
  * Configuration for a {@link Git} instance.
  *
@@ -57,17 +57,24 @@ interface GitOptions {
      */
     resolveRemote?: RemoteResolver;
     /**
-     * Override the object store discovered by `findRepo`.
-     * When set, all object reads/writes bypass the VFS `.git/objects/`
-     * and go through this store instead (e.g. SQLite-backed).
+     * Object store to use instead of filesystem-backed `.git/objects/`.
+     * When both `objectStore` and `refStore` are set, `findRepo` is
+     * skipped entirely — no `.git` directory needs to exist on the VFS.
      */
     objectStore?: ObjectStore;
     /**
-     * Override the ref store discovered by `findRepo`.
-     * When set, all ref reads/writes bypass the VFS `.git/refs/`
-     * and go through this store instead (e.g. SQLite-backed).
+     * Ref store to use instead of filesystem-backed `.git/refs/`.
+     * When both `objectStore` and `refStore` are set, `findRepo` is
+     * skipped entirely — no `.git` directory needs to exist on the VFS.
      */
     refStore?: RefStore;
+    /**
+     * Explicit `.git` directory path. When set together with
+     * `objectStore` and `refStore`, `findRepo` is skipped entirely —
+     * no `.git` directory needs to exist on the VFS. Index, config,
+     * reflog, and operation state files are stored under this path.
+     */
+    gitDir?: string;
     /**
      * Config overrides. `locked` values always win over `.git/config`;
      * `defaults` supply fallbacks when a key is absent from config.