just-git 1.4.2 → 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}. */
@@ -474,8 +488,24 @@ interface GitServer<A = Auth> {
     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.
      *
@@ -967,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;
@@ -986,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;
@@ -1037,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`. */
@@ -1084,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. */
@@ -1134,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 };