just-git 1.3.7 → 1.4.0

package/README.md

@@ -61,7 +61,17 @@ Both `fs` and `cwd` can be set once in `createGit` and overridden per-call. `cwd
 
 ### Server
 
-Stand up a git server with built-in storage (SQLite or PostgreSQL), branch protection, auth, and push hooks:
+Stand up a git server in two lines. Storage defaults to in-memory; swap in SQLite, PostgreSQL, or your own backend for persistence:
+
+```ts
+import { createServer } from "just-git/server";
+
+const server = createServer({ autoCreate: true });
+Bun.serve({ fetch: server.fetch });
+// git push http://localhost:3000/my-repo main ← repo created on first push
+```
+
+Add branch protection, auth, and push hooks as needed:
 
 ```ts
 import { createServer, BunSqliteStorage } from "just-git/server";
@@ -73,24 +83,23 @@ const server = createServer({
   autoCreate: true,
   policy: { protectedBranches: ["main"] },
   hooks: {
-    preReceive: ({ session }) => {
-      if (!session?.request?.headers.has("Authorization"))
+    preReceive: ({ auth }) => {
+      if (!auth.request?.headers.has("Authorization"))
         return { reject: true, message: "unauthorized" };
     },
-    postReceive: async ({ repo, repoPath, updates }) => {
+    postReceive: async ({ repo, repoId, updates }) => {
       for (const u of updates) {
         const files = await getChangedFiles(repo, u.oldHash, u.newHash);
-        console.log(`${repoPath}: ${u.ref} — ${files.length} files changed`);
+        console.log(`${repoId}: ${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 `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.
+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`. The [`Storage` interface](docs/SERVER.md#custom-storage) is small enough to plug in any datastore. See [SERVER.md](docs/SERVER.md) for the full API.
 
 ## Repo module
 
@@ -125,7 +134,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).
+- **In-process server**: connect a git client to a `GitServer` without any network stack via `server.asNetwork()`. All server hooks, auth, and policy enforcement work identically to real HTTP. See [CLIENT.md](docs/CLIENT.md#in-process-server).
 
 ### Internals
 

package/dist/{hooks-DNBNCTgb.d.ts → hooks-C7c_BLqp.d.ts}

@@ -389,7 +389,7 @@ interface PostCommitEvent {
 /** Fired before a three-way merge commit is written. Return a {@link Rejection} to block. */
 interface PreMergeCommitEvent {
     readonly repo: GitRepo;
-    readonly mergeMessage: string;
+    readonly message: string;
     readonly treeHash: ObjectId;
     readonly headHash: ObjectId;
     readonly theirsHash: ObjectId;
@@ -435,7 +435,7 @@ interface PreRebaseEvent {
 interface PreCheckoutEvent {
     readonly repo: GitRepo;
     readonly target: string;
-    readonly mode: "switch" | "detach" | "create-branch" | "paths";
+    readonly mode: "switch" | "detach" | "create-branch";
 }
 /** Fired before a fetch begins. Return a {@link Rejection} to block. */
 interface PreFetchEvent {
@@ -451,7 +451,7 @@ interface PostFetchEvent {
     readonly repo: GitRepo;
     readonly remote: string;
     readonly url: string;
-    readonly refsUpdated: number;
+    readonly updatedRefCount: number;
 }
 /** Fired before a clone begins. Return a {@link Rejection} to block. */
 interface PreCloneEvent {
@@ -487,7 +487,7 @@ interface PostPullEvent {
 interface PreResetEvent {
     readonly repo: GitRepo;
     readonly mode: "soft" | "mixed" | "hard" | "paths";
-    readonly target: string | null;
+    readonly targetRef: string | null;
 }
 /** Fired after a reset completes. */
 interface PostResetEvent {
@@ -495,72 +495,34 @@ interface PostResetEvent {
     readonly mode: "soft" | "mixed" | "hard" | "paths";
     readonly targetHash: ObjectId | null;
 }
-/** Fired before `git clean`. Return a {@link Rejection} to block. */
-interface PreCleanEvent {
-    readonly repo: GitRepo;
-    readonly dryRun: boolean;
-    readonly force: boolean;
-    readonly removeDirs: boolean;
-    readonly removeIgnored: boolean;
-    readonly onlyIgnored: boolean;
-}
-/** Fired after `git clean` completes. */
-interface PostCleanEvent {
+/** Base type for pre-hooks that apply a commit (cherry-pick, revert). */
+interface PreApplyEvent {
     readonly repo: GitRepo;
-    readonly removed: readonly string[];
-    readonly dryRun: boolean;
+    readonly mode: string;
+    readonly commitRef: string | null;
 }
-/** Fired before `git rm`. Return a {@link Rejection} to block. */
-interface PreRmEvent {
+/** Base type for post-hooks that apply a commit (cherry-pick, revert). */
+interface PostApplyEvent {
     readonly repo: GitRepo;
-    readonly paths: readonly string[];
-    readonly cached: boolean;
-    readonly recursive: boolean;
-    readonly force: boolean;
-}
-/** Fired after `git rm` completes. */
-interface PostRmEvent {
-    readonly repo: GitRepo;
-    readonly removedPaths: readonly string[];
-    readonly cached: boolean;
+    readonly mode: string;
+    readonly commitHash: ObjectId | null;
+    readonly hadConflicts: boolean;
 }
 /** Fired before a cherry-pick. Return a {@link Rejection} to block. */
-interface PreCherryPickEvent {
-    readonly repo: GitRepo;
+interface PreCherryPickEvent extends PreApplyEvent {
     readonly mode: "pick" | "continue" | "abort";
-    readonly commit: string | null;
 }
 /** Fired after a cherry-pick completes. */
-interface PostCherryPickEvent {
-    readonly repo: GitRepo;
+interface PostCherryPickEvent extends PostApplyEvent {
     readonly mode: "pick" | "continue" | "abort";
-    readonly commitHash: ObjectId | null;
-    readonly hadConflicts: boolean;
 }
 /** Fired before a revert. Return a {@link Rejection} to block. */
-interface PreRevertEvent {
-    readonly repo: GitRepo;
+interface PreRevertEvent extends PreApplyEvent {
     readonly mode: "revert" | "continue" | "abort";
-    readonly commit: string | null;
 }
 /** Fired after a revert completes. */
-interface PostRevertEvent {
-    readonly repo: GitRepo;
+interface PostRevertEvent extends PostApplyEvent {
     readonly mode: "revert" | "continue" | "abort";
-    readonly commitHash: ObjectId | null;
-    readonly hadConflicts: boolean;
-}
-/** Fired before a stash operation. Return a {@link Rejection} to block. */
-interface PreStashEvent {
-    readonly repo: GitRepo;
-    readonly action: "push" | "pop" | "apply" | "list" | "drop" | "show" | "clear";
-    readonly ref: string | null;
-}
-/** Fired after a stash operation completes. */
-interface PostStashEvent {
-    readonly repo: GitRepo;
-    readonly action: "push" | "pop" | "apply" | "list" | "drop" | "show" | "clear";
-    readonly ok: boolean;
 }
 /** Fired whenever a ref is created or updated. */
 interface RefUpdateEvent {
@@ -620,11 +582,8 @@ interface GitHooks {
     prePull?: (event: PrePullEvent) => PreHookReturn;
     preRebase?: (event: PreRebaseEvent) => PreHookReturn;
     preReset?: (event: PreResetEvent) => PreHookReturn;
-    preClean?: (event: PreCleanEvent) => PreHookReturn;
-    preRm?: (event: PreRmEvent) => PreHookReturn;
     preCherryPick?: (event: PreCherryPickEvent) => PreHookReturn;
     preRevert?: (event: PreRevertEvent) => PreHookReturn;
-    preStash?: (event: PreStashEvent) => PreHookReturn;
     postCommit?: (event: PostCommitEvent) => PostHookReturn;
     postMerge?: (event: PostMergeEvent) => PostHookReturn;
     postCheckout?: (event: PostCheckoutEvent) => PostHookReturn;
@@ -633,11 +592,8 @@ interface GitHooks {
     postClone?: (event: PostCloneEvent) => PostHookReturn;
     postPull?: (event: PostPullEvent) => PostHookReturn;
     postReset?: (event: PostResetEvent) => PostHookReturn;
-    postClean?: (event: PostCleanEvent) => PostHookReturn;
-    postRm?: (event: PostRmEvent) => PostHookReturn;
     postCherryPick?: (event: PostCherryPickEvent) => PostHookReturn;
     postRevert?: (event: PostRevertEvent) => PostHookReturn;
-    postStash?: (event: PostStashEvent) => PostHookReturn;
     onRefUpdate?: (event: RefUpdateEvent) => void;
     onRefDelete?: (event: RefDeleteEvent) => void;
     onObjectWrite?: (event: ObjectWriteEvent) => void;
@@ -653,4 +609,4 @@ interface GitHooks {
  */
 declare function composeGitHooks(...hookSets: (GitHooks | undefined)[]): GitHooks;
 
-export { type Ref as $, type AfterCommandEvent as A, type BeforeCommandEvent as B, type CredentialProvider as C, type DirectRef as D, type ExecResult as E, type FileSystem as F, type GitHooks as G, type HttpAuth as H, type IdentityOverride as I, type PreCleanEvent as J, type PreCloneEvent as K, type PreCommitEvent as L, type MergeMsgEvent as M, type NetworkPolicy as N, type ObjectStore as O, type PackObject as P, type PreFetchEvent as Q, type RemoteResolver as R, type PreMergeCommitEvent as S, type PrePullEvent as T, type PrePushEvent as U, type PreRebaseEvent as V, type PreResetEvent as W, type PreRevertEvent as X, type PreRmEvent as Y, type PreStashEvent as Z, type RawObject as _, type RefStore as a, type RefDeleteEvent as a0, type RefEntry as a1, type RefUpdateEvent as a2, type Rejection as a3, type SymbolicRef as a4, composeGitHooks as a5, isRejection as a6, type TreeEntry as a7, type TreeDiffEntry as a8, type ConfigOverrides as b, type FileStat as c, type GitContext as d, type Commit as e, type CommitMsgEvent as f, type GitRepo as g, type Identity as h, type ObjectId as i, type ObjectType as j, type ObjectWriteEvent as k, type PostCheckoutEvent as l, type PostCherryPickEvent as m, type PostCleanEvent as n, type PostCloneEvent as o, type PostCommitEvent as p, type PostFetchEvent as q, type PostMergeEvent as r, type PostPullEvent as s, type PostPushEvent as t, type PostResetEvent as u, type PostRevertEvent as v, type PostRmEvent as w, type PostStashEvent as x, type PreCheckoutEvent as y, type PreCherryPickEvent as z };
+export { type Rejection as $, type AfterCommandEvent as A, type BeforeCommandEvent as B, type CredentialProvider as C, type DirectRef as D, type ExecResult as E, type FileSystem as F, type GitHooks as G, type HttpAuth as H, type IdentityOverride as I, type PreCommitEvent as J, type PreFetchEvent as K, type PreMergeCommitEvent as L, type MergeMsgEvent as M, type NetworkPolicy as N, type ObjectStore as O, type PackObject as P, type PrePullEvent as Q, type RemoteResolver as R, type PrePushEvent as S, type PreRebaseEvent as T, type PreResetEvent as U, type PreRevertEvent as V, type RawObject as W, type Ref as X, type RefDeleteEvent as Y, type RefEntry as Z, type RefUpdateEvent as _, type RefStore as a, type SymbolicRef as a0, composeGitHooks as a1, isRejection as a2, type TreeEntry as a3, type TreeDiffEntry as a4, type ConfigOverrides as b, type FileStat as c, type GitContext as d, type Commit as e, type CommitMsgEvent as f, type GitRepo as g, type Identity as h, type ObjectId as i, type ObjectType as j, type ObjectWriteEvent as k, type PostApplyEvent as l, type PostCheckoutEvent as m, type PostCherryPickEvent as n, type PostCloneEvent as o, type PostCommitEvent as p, type PostFetchEvent as q, type PostMergeEvent as r, type PostPullEvent as s, type PostPushEvent as t, type PostResetEvent as u, type PostRevertEvent as v, type PreApplyEvent as w, type PreCheckoutEvent as x, type PreCherryPickEvent as y, type PreCloneEvent 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-DNBNCTgb.js';
-export { A as AfterCommandEvent, B as BeforeCommandEvent, e as Commit, f as CommitMsgEvent, D as DirectRef, g as GitRepo, H as HttpAuth, h as Identity, M as MergeMsgEvent, i as ObjectId, j as ObjectType, k as ObjectWriteEvent, P as PackObject, l as PostCheckoutEvent, m as PostCherryPickEvent, n as PostCleanEvent, o as PostCloneEvent, p as PostCommitEvent, q as PostFetchEvent, r as PostMergeEvent, s as PostPullEvent, t as PostPushEvent, u as PostResetEvent, v as PostRevertEvent, w as PostRmEvent, x as PostStashEvent, y as PreCheckoutEvent, z as PreCherryPickEvent, J as PreCleanEvent, K as PreCloneEvent, L as PreCommitEvent, Q as PreFetchEvent, S as PreMergeCommitEvent, T as PrePullEvent, U as PrePushEvent, V as PreRebaseEvent, W as PreResetEvent, X as PreRevertEvent, Y as PreRmEvent, Z as PreStashEvent, _ as RawObject, $ as Ref, a0 as RefDeleteEvent, a1 as RefEntry, a2 as RefUpdateEvent, a3 as Rejection, a4 as SymbolicRef, a5 as composeGitHooks, a6 as isRejection } from './hooks-DNBNCTgb.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-C7c_BLqp.js';
+export { A as AfterCommandEvent, B as BeforeCommandEvent, e as Commit, f as CommitMsgEvent, D as DirectRef, g as GitRepo, H as HttpAuth, h as Identity, M as MergeMsgEvent, i as ObjectId, j as ObjectType, k as ObjectWriteEvent, P as PackObject, l as PostApplyEvent, m as PostCheckoutEvent, n as PostCherryPickEvent, o as PostCloneEvent, p as PostCommitEvent, q as PostFetchEvent, r as PostMergeEvent, s as PostPullEvent, t as PostPushEvent, u as PostResetEvent, v as PostRevertEvent, w as PreApplyEvent, x as PreCheckoutEvent, y as PreCherryPickEvent, z as PreCloneEvent, J as PreCommitEvent, K as PreFetchEvent, L as PreMergeCommitEvent, Q as PrePullEvent, S as PrePushEvent, T as PreRebaseEvent, U as PreResetEvent, V as PreRevertEvent, W as RawObject, X as Ref, Y as RefDeleteEvent, Z as RefEntry, _ as RefUpdateEvent, $ as Rejection, a0 as SymbolicRef, a1 as composeGitHooks, a2 as isRejection } from './hooks-C7c_BLqp.js';
 
 /** Options for subcommand execution (mirrors just-bash's CommandExecOptions). */
 interface CommandExecOptions {