@scolladon/tsgit 2.0.1 → 3.1.0

package/dist/types/chunks/reflog-entry-BbNnXCTC.d.cts

@@ -1,368 +0,0 @@
-import { O as ObjectId, c as FilePath, j as RefName, d as FileStat } from './context-YDw6qicq.cjs';
-
-interface AuthorIdentity {
-    readonly name: string;
-    readonly email: string;
-    readonly timestamp: number;
-    readonly timezoneOffset: string;
-}
-
-interface Blob {
-    readonly type: 'blob';
-    readonly id: ObjectId;
-    readonly content: Uint8Array;
-}
-
-/**
- * Commit serializer. Produces the canonical Git commit-object payload
- * (`tree <sha>\nparent <sha>*\nauthor …\ncommitter …\n\n<message>`) that
- * sits inside a loose commit object. SHA equality is the contract;
- * disk-bytes vary by zlib compression level (loose object caveat).
- *
- * @writes
- *   surface: commit
- *   kind:    equivalent-under-readback
- *   format:  git-commit-object
- */
-
-interface ExtraHeader {
-    readonly key: string;
-    readonly value: string;
-}
-interface CommitData {
-    readonly tree: ObjectId;
-    readonly parents: ReadonlyArray<ObjectId>;
-    readonly author: AuthorIdentity;
-    readonly committer: AuthorIdentity;
-    readonly message: string;
-    readonly gpgSignature?: string;
-    readonly extraHeaders: ReadonlyArray<ExtraHeader>;
-}
-interface Commit {
-    readonly type: 'commit';
-    readonly id: ObjectId;
-    readonly data: CommitData;
-}
-
-/**
- * A validated git-config key. Branded to prevent string-typed callers from
- * passing a raw, unvalidated string into config primitives. Construct via
- * `parseConfigKey` only.
- */
-type ConfigKey = string & {
-    readonly __brand: 'ConfigKey';
-};
-/**
- * The four canonical git-config scopes. Order in the union is also the read
- * precedence (lowest precedence first): system → global → local → worktree.
- */
-type ConfigScope = 'system' | 'global' | 'local' | 'worktree';
-
-declare const FILE_MODE: {
-    readonly REGULAR: "100644";
-    readonly EXECUTABLE: "100755";
-    readonly SYMLINK: "120000";
-    readonly DIRECTORY: "40000";
-    readonly GITLINK: "160000";
-};
-type FileMode = (typeof FILE_MODE)[keyof typeof FILE_MODE];
-
-type ObjectType = 'blob' | 'tree' | 'commit' | 'tag';
-
-/**
- * Tag serializer. Produces the canonical annotated-tag payload
- * (`object <sha>\ntype <type>\ntag <name>\ntagger …\n\n<message>`) inside a
- * loose tag object.
- *
- * @writes
- *   surface: tag
- *   kind:    equivalent-under-readback
- *   format:  git-tag-object
- */
-
-interface TagData {
-    readonly object: ObjectId;
-    readonly objectType: ObjectType;
-    readonly tagName: string;
-    readonly tagger?: AuthorIdentity;
-    readonly message: string;
-    readonly gpgSignature?: string;
-    readonly extraHeaders: ReadonlyArray<ExtraHeader>;
-}
-interface Tag {
-    readonly type: 'tag';
-    readonly id: ObjectId;
-    readonly data: TagData;
-}
-
-interface TreeEntry {
-    readonly mode: FileMode;
-    readonly name: string;
-    readonly id: ObjectId;
-}
-interface Tree {
-    readonly type: 'tree';
-    readonly id: ObjectId;
-    readonly entries: ReadonlyArray<TreeEntry>;
-}
-
-type GitObject = Blob | Tree | Commit | Tag;
-
-interface AddChange {
-    readonly type: 'add';
-    readonly newPath: FilePath;
-    readonly newId: ObjectId;
-    readonly newMode: FileMode;
-}
-interface DeleteChange {
-    readonly type: 'delete';
-    readonly oldPath: FilePath;
-    readonly oldId: ObjectId;
-    readonly oldMode: FileMode;
-}
-interface ModifyChange {
-    readonly type: 'modify';
-    readonly path: FilePath;
-    readonly oldId: ObjectId;
-    readonly newId: ObjectId;
-    readonly oldMode: FileMode;
-    readonly newMode: FileMode;
-}
-interface RenameChange {
-    readonly type: 'rename';
-    readonly oldPath: FilePath;
-    readonly newPath: FilePath;
-    readonly id: ObjectId;
-    readonly mode: FileMode;
-}
-interface TypeChangeChange {
-    readonly type: 'type-change';
-    readonly path: FilePath;
-    readonly oldId: ObjectId;
-    readonly newId: ObjectId;
-    readonly oldMode: FileMode;
-    readonly newMode: FileMode;
-}
-type DiffChange = AddChange | DeleteChange | ModifyChange | RenameChange | TypeChangeChange;
-interface TreeDiff {
-    readonly changes: ReadonlyArray<DiffChange>;
-}
-
-interface RenameDetectOptions {
-    readonly limit?: number;
-    readonly maxSameIdDeletes?: number;
-}
-
-/**
- * Primitive option shapes, walker value types, and shared constants.
- * Defined in one location to avoid circular imports between primitive modules.
- */
-
-/** Max symbolic-ref dereferences resolveRef will follow. */
-declare const MAX_SYMBOLIC_REF_DEPTH = 5;
-/** Max tag-peel hops resolveRef / readTree will follow when peeling. */
-declare const MAX_PEEL_DEPTH = 5;
-/** Max seeds walkCommits.from can contain. */
-declare const MAX_WALK_SEEDS = 1024;
-/** Hard cap on walkCommits' pending queue size to prevent unbounded heap growth. */
-declare const MAX_WALK_QUEUE_SIZE: number;
-/** Max.git/index file size readIndex will accept. */
-declare const MAX_INDEX_BYTES: number;
-/** Max commit message byte length createCommit will accept. */
-declare const MAX_COMMIT_MESSAGE_BYTES: number;
-/**
- * Per-file size cap enforced by `add --all` before reading working-tree
- * bytes into memory. Mirrors `MAX_CONFLICT_OUTPUT_BYTES` (256 MiB) so the
- * write-side memory ceiling matches the read-side ceiling.
- * See `docs/adr/032-add-all-large-file-guard.md`.
- */
-declare const MAX_WORKING_TREE_BLOB_BYTES: number;
-/**
- * Per-file cap on `.gitignore`, `.git/info/exclude`, and the global
- * excludesFile. 1 MiB leaves a 20× margin over real-world max-size
- * gitignore corpora. See `docs/adr/036-gitignore-bounded-read.md`.
- */
-declare const MAX_GITIGNORE_BYTES: number;
-/**
- * Per-file cap on a single `.git/logs/<ref>` reflog file. 16 MiB is generous
- * — `reflog expire` is the size-management story; this guard only stops an
- * adversarial or corrupt log from being buffered unbounded into memory.
- */
-declare const MAX_REFLOG_BYTES: number;
-interface ReadObjectOptions {
-    readonly verifyHash?: boolean;
-    /**
-     * Reject objects whose serialised payload exceeds this byte count, before
-     * inflating the full content into memory. Counts the raw object content
-     * (post-inflate, pre-loose-header). When unset, no cap applies.
-     *
-     * Used by `merge`'s content merger to bound peak memory when an adversarial
-     * remote ships pathologically large blobs. See `docs/design/phase-13-8-
-     * bounded-object-reads.md`.
-     */
-    readonly maxBytes?: number;
-}
-interface ResolveRefOptions {
-    readonly peel?: boolean;
-    readonly maxSymbolicDepth?: number;
-    readonly maxPeelDepth?: number;
-}
-/**
- * `updateRef` option shapes. A write requires a `reflogMessage` — git's
- * builtins always supply a reason string; the type checker forces every
- * present and future ref write to state why the ref moved. A delete drops the
- * reflog file, so it carries no message.
- */
-type UpdateRefOptions = {
-    readonly delete?: false;
-    readonly expected?: ObjectId | 'absent';
-    readonly reflogMessage: string;
-} | {
-    readonly delete: true;
-    readonly expected?: ObjectId | 'absent';
-};
-interface WalkCommitsOptions {
-    readonly from: ReadonlyArray<ObjectId>;
-    readonly until?: ReadonlyArray<ObjectId>;
-    readonly order?: 'topo' | 'first-parent';
-    readonly ignoreMissing?: boolean;
-    readonly verifyHash?: boolean;
-    /**
-     * Commits whose parents must NOT be enqueued. Used for shallow boundaries
-     * . The commit itself is still yielded — only its parents are
-     * skipped. Callers that want to also skip the boundary commit pass it in
-     * `until`.
-     */
-    readonly shallow?: ReadonlySet<ObjectId>;
-}
-/** Maximum `have` lines a single-round fetch will send. */
-declare const MAX_HAVES = 256;
-/** Hard cap on objects enumerated for a single push. design */
-declare const MAX_PUSH_OBJECTS = 1000000;
-interface WalkTreeEntry {
-    readonly path: FilePath;
-    readonly id: ObjectId;
-    readonly mode: FileMode;
-}
-interface WalkTreeOptions {
-    readonly recursive?: boolean;
-    readonly maxDepth?: number;
-    readonly maxEntries?: number;
-}
-interface WalkWorkingTreeEntry {
-    readonly path: FilePath;
-    readonly stat: FileStat;
-}
-type WalkIgnorePredicate = (path: FilePath, isDirectory: boolean) => boolean | Promise<boolean>;
-interface WalkWorkingTreeOptions {
-    readonly maxDepth?: number;
-    readonly maxEntries?: number;
-    /**
-     * predicate. Invoked on every directory BEFORE descent
-     * (returning `true` prunes the entire subtree, skipping its `lstat`
-     * cost) and on every leaf BEFORE yielding (returning `true` drops
-     * the leaf). May be sync or async.
-     */
-    readonly ignore?: WalkIgnorePredicate;
-}
-interface CreateCommitInput {
-    readonly tree: ObjectId;
-    readonly parents: ReadonlyArray<ObjectId>;
-    readonly author: AuthorIdentity;
-    readonly committer: AuthorIdentity;
-    readonly message: string;
-    readonly gpgSignature?: string;
-    readonly extraHeaders?: ReadonlyArray<ExtraHeader>;
-}
-type DiffTreesInput = Tree | ObjectId | undefined;
-interface DiffTreesOptions {
-    readonly detectRenames?: boolean;
-    readonly renameOptions?: RenameDetectOptions;
-}
-/**
- * Per-file cap on a single `.gitmodules` blob. 1 MiB matches the
- * `MAX_GITIGNORE_BYTES` budget: real `.gitmodules` files are KB-scale even in
- * very large superprojects, so a 1 MiB ceiling is a generous DoS guard
- * applied before inflate.
- */
-declare const MAX_GITMODULES_BYTES: number;
-/**
- * Recursion backstop for `walkSubmodules` — the cycle guard (visited gitdir
- * set) handles the genuine-cycle case; this cap stops a pathologically deep
- * but acyclic nest from running away.
- */
-declare const MAX_SUBMODULE_DEPTH = 100;
-/** One submodule surfaced by `walkSubmodules`: a gitlink joined with its `.gitmodules` row. */
-interface SubmoduleEntry {
-    /**
-     * The `[submodule "<name>"]` subsection name in the `.gitmodules` of the
-     * tree that contains this gitlink. Falls back to `path` when no row matches
-     * the gitlink (a gitlink committed without a corresponding config entry).
-     */
-    readonly name: string;
-    /** Slash-joined path from the *superproject* root to the gitlink. */
-    readonly path: FilePath;
-    /** `submodule.<name>.url` — absent when no `.gitmodules` row matched. */
-    readonly url?: string;
-    /** `submodule.<name>.branch` — absent when the key is unset. */
-    readonly branch?: string;
-    /** The commit object id the gitlink pins (the tree entry's id). */
-    readonly commit: ObjectId;
-    /** Recursion depth; 0 for a direct submodule of the superproject. */
-    readonly depth: number;
-    /** Path of the containing submodule; absent for `depth === 0` entries. */
-    readonly parent?: FilePath;
-}
-/**
- * One entry yielded by `catFileBatch` — a discriminated union so that a
- * single bad id never aborts the stream. `ok: true` carries the parsed
- * object plus its canonical payload size (matches the `<size>` field of
- * `git cat-file --batch`'s header). `ok: false` is shaped to extend later:
- * `reason` is a literal union so a future variant is an additive change.
- */
-/**
- * Optional knobs for the `catFileBatch` primitive — currently a single
- * `maxBytes` cap forwarded to each per-id `readObject` call so a long
- * batch over untrusted ids cannot exhaust the heap. Defaults to no cap.
- */
-interface CatFileBatchOptions {
-    /**
-     * Per-object byte cap. Rejected pre-inflate; same semantics as
-     * `ReadObjectOptions.maxBytes`. When unset, no cap applies (parity
-     * with `readObject`).
-     */
-    readonly maxBytes?: number;
-}
-type CatFileBatchEntry = {
-    readonly ok: true;
-    readonly id: ObjectId;
-    readonly type: GitObject['type'];
-    readonly size: number;
-    readonly object: GitObject;
-} | {
-    readonly ok: false;
-    readonly id: ObjectId;
-    readonly reason: 'missing';
-};
-interface WalkSubmodulesOptions {
-    /** Tree-ish to walk. Default: `HEAD`. */
-    readonly ref?: RefName | ObjectId;
-    /** Descend into nested submodules' own `.gitmodules`. Default: `false`. */
-    readonly recursive?: boolean;
-    /**
-     * Cap on recursion depth. Default: `MAX_SUBMODULE_DEPTH`. Entries at exactly
-     * this depth are yielded but not recursed into.
-     */
-    readonly maxDepth?: number;
-}
-
-/** One line of a reflog file: a single ref movement from `oldId` to `newId`. */
-interface ReflogEntry {
-    readonly oldId: ObjectId;
-    readonly newId: ObjectId;
-    readonly identity: AuthorIdentity;
-    readonly message: string;
-}
-
-export { MAX_COMMIT_MESSAGE_BYTES as M, MAX_GITIGNORE_BYTES as g, MAX_GITMODULES_BYTES as h, MAX_HAVES as i, MAX_INDEX_BYTES as j, MAX_PEEL_DEPTH as k, MAX_PUSH_OBJECTS as l, MAX_REFLOG_BYTES as m, MAX_SUBMODULE_DEPTH as n, MAX_SYMBOLIC_REF_DEPTH as o, MAX_WALK_QUEUE_SIZE as p, MAX_WALK_SEEDS as q, MAX_WORKING_TREE_BLOB_BYTES as r };
-export type { AuthorIdentity as A, Blob as B, CatFileBatchEntry as C, DiffTreesInput as D, Commit as E, FileMode as F, GitObject as G, TreeEntry as H, ReflogEntry as R, SubmoduleEntry as S, TreeDiff as T, UpdateRefOptions as U, WalkCommitsOptions as W, Tree as a, ConfigScope as b, ConfigKey as c, CatFileBatchOptions as d, CreateCommitInput as e, DiffTreesOptions as f, ReadObjectOptions as s, ResolveRefOptions as t, WalkIgnorePredicate as u, WalkSubmodulesOptions as v, WalkTreeEntry as w, WalkTreeOptions as x, WalkWorkingTreeEntry as y, WalkWorkingTreeOptions as z };