@scolladon/tsgit 2.0.1 → 3.1.0

package/dist/types/chunks/{context-CCL0_F8R.d.ts → context-sIhhtk2u.d.ts}

@@ -1,9 +1,11 @@
-import { H as HttpTransport } from './http-transport--_NdQOiw.js';
+import { b as HttpTransport } from './http-transport-DirKfK2S.js';
 
 interface HashConfig {
     readonly digestLength: 20 | 32;
     readonly hexLength: 40 | 64;
 }
+declare const SHA1_CONFIG: HashConfig;
+declare const SHA256_CONFIG: HashConfig;
 
 type ObjectId = string & {
     readonly __brand: unique symbol;
@@ -12,6 +14,13 @@ declare const ObjectId: {
     readonly from: (hex: string) => ObjectId;
     readonly fromRaw: (bytes: Uint8Array) => ObjectId;
 };
+declare const ZERO_OID: ObjectId;
+/**
+ * SHA-1 of the canonical empty tree object. Used by `merge` for unrelated-history
+ * three-way merges where the merge base is undefined — substituted as the
+ * "empty base" so mergeTrees produces the union of both sides.
+ */
+declare const EMPTY_TREE_OID: ObjectId;
 type RefName = string & {
     readonly __brand: unique symbol;
 };
@@ -36,6 +45,55 @@ interface LruCache<V> {
     readonly entryCount: number;
 }
 
+/**
+ * A single shell-command invocation. The port is stateless — every fact the
+ * adapter needs to run the command travels in this request.
+ */
+interface CommandRequest {
+    /** Shell command line, executed through the platform shell (`sh -c` / `cmd /c`). */
+    readonly command: string;
+    /** Working directory for the spawned process. */
+    readonly cwd: string;
+    /** Environment additions merged onto the parent environment by the adapter. */
+    readonly env: Readonly<Record<string, string>>;
+    /** Cancels a running command — the adapter kills the child when it aborts. */
+    readonly signal?: AbortSignal;
+    /** Bytes fed to the child's stdin (clean/smudge input). When absent, stdin is not written. */
+    readonly stdin?: Uint8Array;
+}
+/**
+ * Outcome of a command. Two output conventions are carried by one port:
+ * - A merge driver communicates its result by overwriting its output file `%A`
+ *   — only the exit code matters (`0` ⇒ success); `stdout` is ignored.
+ * - A textconv or clean/smudge filter driver communicates its result via stdout
+ *   — the caller reads `result.stdout` for the transformed bytes.
+ */
+interface CommandResult {
+    readonly exitCode: number;
+    /** Bytes captured from the child's stdout (textconv/filter output). Absent when not captured. */
+    readonly stdout?: Uint8Array;
+}
+/**
+ * Runs an arbitrary shell command line — the custom merge-driver / textconv /
+ * clean-smudge filter command. Optional on `Context`: when absent (browser /
+ * memory adapters cannot spawn a process), a configured external driver falls
+ * back to the built-in behaviour.
+ *
+ * NEVER rejects for a non-zero exit — interpreting the exit code is the
+ * caller's policy.
+ *
+ * Two output conventions coexist on this single port:
+ * - **Merge driver**: communicates via its `%A` output file; the caller
+ *   ignores `result.stdout`. Pass no `stdin`; `stdout` will be absent.
+ * - **Textconv / filter driver**: communicates via stdout; the caller reads
+ *   `result.stdout`. Pass `stdin` bytes when the driver reads from stdin
+ *   (clean/smudge); omit `stdin` when the driver reads from a file argument
+ *   (textconv).
+ */
+interface CommandRunner {
+    readonly run: (request: CommandRequest) => Promise<CommandResult>;
+}
+
 interface InflateStreamResult {
     /** The fully-inflated output bytes. */
     readonly output: Uint8Array;
@@ -43,8 +101,18 @@ interface InflateStreamResult {
     readonly bytesConsumed: number;
 }
 interface Compressor {
-    /** Deflate (compress) data using zlib deflate format (RFC 1950). */
-    readonly deflate: (data: Uint8Array) => Promise<Uint8Array>;
+    /**
+     * Deflate (compress) data using zlib deflate format (RFC 1950).
+     * `level` (when given and in zlib's -1..9 domain) tunes the compression
+     * level; adapters that cannot set a level accept and ignore it.
+     */
+    readonly deflate: (data: Uint8Array, level?: number) => Promise<Uint8Array>;
+    /**
+     * Raw DEFLATE (compress) using bare RFC 1951 bitstream — no zlib (RFC 1950)
+     * 2-byte header and no adler32 trailer. `level` semantics match `deflate`.
+     * Used by zip archive serializer (method 8). Additive — `deflate` unchanged.
+     */
+    readonly deflateRaw: (data: Uint8Array, level?: number) => Promise<Uint8Array>;
     /** Inflate (decompress) zlib-compressed data. */
     readonly inflate: (data: Uint8Array) => Promise<Uint8Array>;
     /**
@@ -66,6 +134,11 @@ interface Compressor {
     readonly createInflateStream: () => TransformStream<Uint8Array, Uint8Array>;
 }
 
+interface EnvReader {
+    /** A single named environment variable's value, or `undefined` when unset. */
+    readonly get: (name: string) => string | undefined;
+}
+
 /** Metadata returned by stat operations. */
 interface FileStat {
     readonly ctimeMs: number;
@@ -116,6 +189,8 @@ interface FileSystem {
     readonly readUtf8: (path: string) => Promise<string>;
     /** Write bytes to file, creating parent directories as needed. Overwrites if exists. */
     readonly write: (path: string, data: Uint8Array) => Promise<void>;
+    /** Stream bytes to file from an async source, creating parent directories as needed. Overwrites if exists. Writes bytes verbatim. */
+    readonly writeStream: (path: string, source: AsyncIterable<Uint8Array>) => Promise<void>;
     /**
      * Write bytes to file. Fails with FILE_EXISTS if the file already exists (exclusive create).
      *
@@ -244,7 +319,7 @@ interface HashService {
  * `HOOK_FAILED` command error reference it — a port may import domain, but
  * domain may never import a port.
  */
-type HookName = 'pre-commit' | 'commit-msg' | 'pre-push';
+type HookName = 'pre-commit' | 'prepare-commit-msg' | 'commit-msg' | 'post-commit' | 'post-merge' | 'post-checkout' | 'pre-push' | 'pre-rebase' | 'post-rewrite';
 
 /**
  * A single hook invocation. The port is stateless — every fact the adapter
@@ -373,6 +448,43 @@ interface PromisorRemote {
     fetch(oids: ReadonlyArray<ObjectId>): Promise<PromisorFetchOutcome>;
 }
 
+/**
+ * Request to open one SSH duplex channel. `command`/`args` are the fully
+ * resolved ssh program and argv (host token, `-p` flag, sq-quoted remote
+ * command) — the adapter performs no faithfulness logic of its own.
+ */
+interface SshSpawnRequest {
+    /** Resolved ssh program (e.g. `ssh`, or a `GIT_SSH`/`core.sshCommand` override). */
+    readonly command: string;
+    /** Full argv, incl. host token and remote-command token. */
+    readonly args: ReadonlyArray<string>;
+    /** Additions merged OVER the parent process environment by the adapter. */
+    readonly env: Readonly<Record<string, string>>;
+    readonly signal?: AbortSignal;
+}
+/**
+ * One live SSH duplex channel — a thin process bridge. Stream shapes mirror
+ * `HttpTransport`: web streams in, web streams out.
+ */
+interface SshChannel {
+    /** Request bytes written to the server. */
+    readonly stdin: WritableStream<Uint8Array>;
+    /** Advertisement + response bytes read from the server. */
+    readonly stdout: ReadableStream<Uint8Array>;
+    /** Resolves with the ssh process's exit code. */
+    readonly exit: Promise<number>;
+    /** Idempotent teardown — kills the child process. */
+    readonly close: () => Promise<void>;
+}
+/**
+ * Thin duplex process spawner. Knows nothing about git — argv building,
+ * quoting, and command resolution are pure application-tier concerns tested
+ * independently of this port.
+ */
+interface SshTransport {
+    readonly open: (req: SshSpawnRequest) => Promise<SshChannel>;
+}
+
 /**
  * Repository physical layout — where the working tree and.git directory live.
  * Renamed in from the previous `RepositoryConfig` (port-tier) to free that
@@ -383,6 +495,14 @@ interface RepositoryLayout {
     readonly workDir: string;
     /** Absolute path to the.git directory (usually `${workDir}/.git`, but may differ for bare repos or worktrees). */
     readonly gitDir: string;
+    /**
+     * Absolute path to the shared **common** git dir — objects, `packed-refs`,
+     * `config`, and shared refs/reflogs. Absent for a normal repo or the main
+     * worktree (it equals `gitDir`); set only for a linked worktree, whose
+     * `gitDir` is its own admin dir while shared state lives here. Resolve via
+     * `commonGitDir(ctx)` rather than reading this field directly.
+     */
+    readonly commonDir?: string;
     /** Whether this is a bare repository. */
     readonly bare: boolean;
     /**
@@ -438,6 +558,14 @@ interface RepositoryConfig {
      */
     readonly maxObjectsPerPack?: number;
     readonly detectRenames?: boolean;
+    /**
+     * Programmatic facade defaults for whitespace-diff modes. These are NOT git's
+     * `.git/config` settings and NOT `core.whitespace` — they are library-tier
+     * defaults applied by the `diff` command when no per-call option overrides them.
+     */
+    readonly ignoreWhitespace?: 'all' | 'change' | 'at-eol';
+    readonly ignoreCrAtEol?: boolean;
+    readonly ignoreBlankLines?: boolean;
     readonly breakStaleLockMs?: number;
     readonly dnsResolver?: (host: string) => Promise<ReadonlyArray<string>>;
     /** Hard cap on `dnsResolver` return-array length to bound resolver-amplification DoS. Default 64. */
@@ -453,6 +581,8 @@ interface Context {
     readonly layout: RepositoryLayout;
     /** User-supplied working directory (may be a sub-path of layout.workDir). Defaults to layout.workDir when not set by the facade. */
     readonly cwd: string;
+    /** The runtime this context was built for — names the adapter set in refusal messages. */
+    readonly runtime: 'node' | 'browser' | 'memory';
     /** Object serialization parameters (sha1 vs sha256 digest+hex sizes). */
     readonly hashConfig: HashConfig;
     /** Shared delta-base LRU cache; consumed by primitives' iterative delta walker. */
@@ -465,11 +595,36 @@ interface Context {
     readonly signal?: AbortSignal;
     /** Optional hook runner. Absent ⇒ hooks are inert (browser, or opted out). */
     readonly hooks?: HookRunner;
+    /**
+     * Optional shell-command runner. Absent ⇒ a configured external merge driver
+     * falls back to the built-in merge (browser / memory adapters cannot spawn a
+     * process).
+     */
+    readonly command?: CommandRunner;
+    /**
+     * Optional environment-variable reader. Absent ⇒ every variable is unset (browser /
+     * memory, where there is no process env). Notes-ref selection reads GIT_NOTES_REF through it.
+     */
+    readonly env?: EnvReader;
+    /**
+     * Optional SSH transport. Absent ⇒ ssh/scp remotes refuse — browser/memory
+     * cannot spawn a process.
+     */
+    readonly ssh?: SshTransport;
     /**
      * Optional promisor-remote capability. Populated by `openRepository`;
      * `readObject` consults it to lazy-fetch an object a partial clone omitted.
      */
     readonly promisor?: PromisorRemote;
+    /**
+     * Optional facade capability returning a `FileSystem` confined to one or more
+     * linked worktree paths AND the common dir (ADR-298). The worktree commands
+     * route worktree-directory I/O through it so worktrees outside `workDir` stay
+     * faithful without dropping containment (`move` passes both endpoints). Absent
+     * on sandboxed adapters (memory/browser), where worktrees are confined under
+     * the adapter root.
+     */
+    readonly worktreeFs?: (worktreePath: string | ReadonlyArray<string>) => FileSystem;
 }
 interface CreateContextParts {
     readonly fs: FileSystem;
@@ -479,15 +634,19 @@ interface CreateContextParts {
     readonly progress: ProgressReporter;
     readonly layout: RepositoryLayout;
     readonly cwd?: string;
+    readonly runtime: 'node' | 'browser' | 'memory';
     readonly hashConfig: HashConfig;
     readonly deltaCache: LruCache<Uint8Array>;
     readonly config?: RepositoryConfig;
     readonly logger?: Logger;
     readonly signal?: AbortSignal;
     readonly hooks?: HookRunner;
+    readonly command?: CommandRunner;
+    readonly env?: EnvReader;
+    readonly ssh?: SshTransport;
 }
 /** Assemble a frozen Context from its constituent ports + layout. */
 declare function createContext(parts: CreateContextParts): Context;
 
-export { ObjectId as O, FilePath as c, RefName as j, createContext as p, noopLogger as q, wrapLoggerSanitizer as w };
-export type { AuthStrategy as A, Compressor as C, DirEntry as D, FileSystem as F, HashService as H, InflateStreamResult as I, Logger as L, ProgressReporter as P, RepositoryConfig as R, HookRunner as a, Context as b, FileStat as d, FileHandle as e, Hasher as f, HookName as g, HookResult as h, HookRequest as i, AuthorIdentity as k, CreateContextParts as l, PromisorFetchOutcome as m, PromisorRemote as n, RepositoryLayout as o };
+export { EMPTY_TREE_OID as E, FilePath as F, ObjectId as O, RefName as R, SHA1_CONFIG as S, ZERO_OID as Z, SHA256_CONFIG as r, createContext as v, noopLogger as w, wrapLoggerSanitizer as x };
+export type { AuthStrategy as A, CommandResult as B, CommandRunner as C, DirEntry as D, HashConfig as H, InflateStreamResult as I, Logger as L, ProgressReporter as P, Compressor as a, AuthorIdentity as b, Context as c, CreateContextParts as d, EnvReader as e, FileStat as f, FileSystem as g, HashService as h, Hasher as i, HookName as j, HookRequest as k, HookResult as l, HookRunner as m, PromisorFetchOutcome as n, PromisorRemote as o, RepositoryConfig as p, RepositoryLayout as q, SshChannel as s, SshSpawnRequest as t, SshTransport as u, FileHandle as y, CommandRequest as z };

package/dist/types/chunks/{http-transport--_NdQOiw.d.cts → http-transport-DirKfK2S.d.cts}

@@ -17,4 +17,4 @@ interface HttpTransport {
     readonly request: (req: HttpRequest) => Promise<HttpResponse>;
 }
 
-export type { HttpTransport as H, HttpRequest as a, HttpResponse as b };
+export type { HttpRequest as H, HttpResponse as a, HttpTransport as b };

package/dist/types/chunks/{http-transport--_NdQOiw.d.ts → http-transport-DirKfK2S.d.ts}

@@ -17,4 +17,4 @@ interface HttpTransport {
     readonly request: (req: HttpRequest) => Promise<HttpResponse>;
 }
 
-export type { HttpTransport as H, HttpRequest as a, HttpResponse as b };
+export type { HttpRequest as H, HttpResponse as a, HttpTransport as b };