just-git 1.4.1 → 1.5.0

package/dist/server/index.d.ts

@@ -126,6 +126,20 @@ interface Storage {
      * The adapter uses this for compare-and-swap with symref resolution.
      */
     atomicRefUpdate<T>(repoId: string, fn: (ops: RefOps) => MaybeAsync<T>): MaybeAsync<T>;
+    /**
+     * Record a fork relationship. `targetId` becomes a fork of `sourceId`.
+     * The adapter layer handles ref copying and root resolution.
+     */
+    forkRepo?(sourceId: string, targetId: string): MaybeAsync<void>;
+    /**
+     * Get the parent (root) repo ID for a fork, or `null` if the repo
+     * is not a fork.
+     */
+    getForkParent?(repoId: string): MaybeAsync<string | null>;
+    /**
+     * List all direct fork IDs of a repo.
+     */
+    listForks?(repoId: string): MaybeAsync<string[]>;
 }
 
 /** Options for {@link gcRepo}. */
@@ -367,7 +381,7 @@ interface RefUpdateRequest {
      */
     oldHash?: string | null;
 }
-interface GitServer {
+interface GitServer<A = Auth> {
     /** Standard fetch-API handler for HTTP: (Request) => Response */
     fetch(request: Request): Promise<Response>;
     /**
@@ -474,8 +488,24 @@ interface GitServer {
     repo(id: string): Promise<GitRepo | null>;
     /** Get a repo by ID, or throw if it doesn't exist. */
     requireRepo(id: string): Promise<GitRepo>;
-    /** Delete a repo and all its data. */
+    /** Delete a repo and all its data. Throws if the repo has active forks. */
     deleteRepo(id: string): Promise<void>;
+    /**
+     * Fork an existing repo. Copies refs from the source repo to the
+     * target. The fork shares the source's object pool — object reads
+     * fall through to the root repo's partition, while writes go to
+     * the fork's own partition.
+     *
+     * Forking a fork resolves to the root: `forkRepo("fork-of-A", "B")`
+     * records B as a fork of A's root, not of the intermediate fork.
+     *
+     * Requires a storage backend that implements fork methods.
+     *
+     * @throws If the source doesn't exist, the target already exists,
+     *   the storage backend doesn't support forks, or the server is
+     *   shutting down.
+     */
+    forkRepo(sourceId: string, targetId: string, options?: CreateRepoOptions): Promise<GitRepo>;
     /**
      * Remove unreachable objects from a repo's storage.
      *
@@ -514,12 +544,29 @@ interface GitServer {
      * await git.exec("clone http://git/my-repo /work");
      * ```
      *
+     * When `auth` is provided, in-process requests bypass the server's
+     * `auth.http` callback entirely — hooks receive the supplied auth
+     * context directly. This is the recommended approach for operator-
+     * controlled agents where identity is known at wiring time:
+     *
+     * ```ts
+     * const network = server.asNetwork("http://git", {
+     *   userId: "agent-1",
+     *   roles: ["push"],
+     * });
+     * const git = createGit({ network });
+     * ```
+     *
+     * When `auth` is omitted, `auth.http` runs on every request as usual.
+     *
      * @param baseUrl - Base URL used in clone/push/fetch commands.
      *   Only the hostname matters (for the `allowed` list). The URL
      *   never hits the network — it's resolved by the server's
      *   `resolve` function. Defaults to `"http://git"`.
+     * @param auth - Pre-resolved auth context injected into server hooks,
+     *   bypassing `auth.http`. Must match the server's `A` type.
      */
-    asNetwork(baseUrl?: string): NetworkPolicy;
+    asNetwork(baseUrl?: string, auth?: A): NetworkPolicy;
 }
 interface ServerHooks<A = Auth> {
     /**
@@ -649,7 +696,7 @@ interface RefUpdateResult {
  * server.handleSession(command, channel, { username });
  * ```
  */
-declare function createServer<A = Auth>(config?: GitServerConfig<A>): GitServer;
+declare function createServer<A = Auth>(config?: GitServerConfig<A>): GitServer<A>;
 /**
  * Compose multiple hook sets into a single `ServerHooks` object.
  *
@@ -950,6 +997,7 @@ declare class MemoryStorage implements Storage {
     private repos;
     private objects;
     private refs;
+    private forks;
     hasRepo(repoId: string): boolean;
     insertRepo(repoId: string): void;
     deleteRepo(repoId: string): void;
@@ -969,6 +1017,9 @@ declare class MemoryStorage implements Storage {
     removeRef(repoId: string, name: string): void;
     listRefs(repoId: string, prefix?: string): RawRefEntry[];
     atomicRefUpdate<T>(repoId: string, fn: (ops: RefOps) => T): T;
+    forkRepo(sourceId: string, targetId: string): void;
+    getForkParent(repoId: string): string | null;
+    listForks(repoId: string): string[];
     /** List all created repo IDs. Convenience for tests and debugging. */
     repoIds(): string[];
     private getObjMap;
@@ -1020,6 +1071,9 @@ declare class BunSqliteStorage implements Storage {
     removeRef(repoId: string, name: string): void;
     listRefs(repoId: string, prefix?: string): RawRefEntry[];
     atomicRefUpdate<T>(repoId: string, fn: (ops: RefOps) => T): T;
+    forkRepo(sourceId: string, targetId: string): void;
+    getForkParent(repoId: string): string | null;
+    listForks(repoId: string): string[];
 }
 
 /** Minimal prepared statement interface matching `better-sqlite3`. */
@@ -1067,6 +1121,9 @@ declare class BetterSqlite3Storage implements Storage {
     removeRef(repoId: string, name: string): void;
     listRefs(repoId: string, prefix?: string): RawRefEntry[];
     atomicRefUpdate<T>(repoId: string, fn: (ops: RefOps) => T): T;
+    forkRepo(sourceId: string, targetId: string): void;
+    getForkParent(repoId: string): string | null;
+    listForks(repoId: string): string[];
 }
 
 /** Minimal pool interface matching the `pg` package's `Pool` class. */
@@ -1117,6 +1174,9 @@ declare class PgStorage implements Storage {
     removeRef(repoId: string, name: string): Promise<void>;
     listRefs(repoId: string, prefix?: string): Promise<RawRefEntry[]>;
     atomicRefUpdate<T>(repoId: string, fn: (ops: RefOps) => Promise<T> | T): Promise<T>;
+    forkRepo(sourceId: string, targetId: string): Promise<void>;
+    getForkParent(repoId: string): Promise<string | null>;
+    listForks(repoId: string): Promise<string[]>;
 }
 
 export { type AdvertiseRefsEvent, type AdvertiseResult, type ApplyReceivePackOptions, type Auth, type AuthProvider, type BetterSqlite3Database, BetterSqlite3Storage, type BunSqliteDatabase, BunSqliteStorage, type CreateRepoOptions, type GcOptions, type GcResult, GitRepo, type GitServer, type GitServerConfig, type MaybeAsync, MemoryStorage, type NodeHttpRequest, type NodeHttpResponse, type PgPool, PgStorage, type PostReceiveEvent, type PreReceiveEvent, type PushCommand, RawObject, type RawRefEntry, type ReceivePackResult, Ref, type RefAdvertisement, type RefOps, type RefResult, type RefUpdate, type RefUpdateRequest, type RefUpdateResult, Rejection, type ServerHooks, type ServerPolicy, type SshChannel, type SshSessionInfo, type Storage, type UpdateEvent, type V2CommandRequest, type V2FetchRequest, type V2FetchResponseOptions, type V2LsRefsRef, advertiseRefsWithHooks, applyCasRefUpdates, applyReceivePack, buildRefAdvertisementBytes, buildRefListBytes, buildRefListPktLines, buildV2CapabilityAdvertisement, buildV2CapabilityAdvertisementBytes, buildV2FetchResponse, buildV2LsRefsResponse, collectRefs, composeHooks, createServer, handleLsRefs, handleUploadPack, handleV2Fetch, ingestReceivePack, ingestReceivePackFromStream, parseV2CommandRequest, parseV2FetchArgs, resolveRefUpdates };