es-git 0.2.0 → 0.3.0-next.123

package/index.d.ts

@@ -3,6 +3,112 @@
 
 /* auto-generated by NAPI-RS */
 
+/**
+ * Represents a hunk of a blame operation, which is a range of lines
+ * and information about who last modified them.
+ */
+export interface BlameHunk {
+  /** The oid of the commit where this line was last changed. */
+  finalCommitId: string
+  /** The 1-based line number in the final file where this hunk starts. */
+  finalStartLineNumber: number
+  /** The number of lines in this hunk. */
+  linesInHunk: number
+  /** The signature of the commit where this line was last changed. */
+  finalSignature?: Signature
+  /** The path to the file where this line was originally written. */
+  path?: string
+  /** The 1-based line number in the original file where this hunk starts. */
+  origStartLineNumber: number
+  /** The oid of the commit where this line was originally written. */
+  origCommitId: string
+  /** The signature of the commit where this line was originally written. */
+  origSignature?: Signature
+  /**
+   * True if the hunk has been determined to be a boundary commit (the commit
+   * when the file was first introduced to the repository).
+   */
+  isBoundary: boolean
+}
+/** Options for controlling blame behavior */
+export interface BlameOptions {
+  /** The minimum line number to blame (1-based index) */
+  minLine?: number
+  /** The maximum line number to blame (1-based index) */
+  maxLine?: number
+  /**
+   * The oid of the newest commit to consider. The blame algorithm will stop
+   * when this commit is reached.
+   */
+  newestCommit?: string
+  /**
+   * The oid of the oldest commit to consider. The blame algorithm will
+   * stop when this commit is reached.
+   */
+  oldestCommit?: string
+  /**
+   * The path to the file being worked on. Path has to be relative to the
+   * repo root.
+   */
+  path?: string
+  /**
+   * Track lines that have moved within a file. This is the git-blame -M
+   * option.
+   */
+  trackLinesMovement?: boolean
+  /** Restrict search to commits reachable following only first parents. */
+  firstParent?: boolean
+  /** Ignore whitespace differences. */
+  ignoreWhitespace?: boolean
+  /** Track lines that have been copied from another file that exists in any commit. */
+  trackCopiesAnyCommitCopies?: boolean
+  /** Track lines that have been copied from another file that exists in the same commit. */
+  trackCopiesSameCommitCopies?: boolean
+  /** Track lines that have moved across files in the same commit. */
+  trackCopiesSameCommitMoves?: boolean
+  /** Use mailmap file to map author and committer names and email addresses to canonical real names and email addresses. */
+  useMailmap?: boolean
+}
+/**
+ * Ensure the branch name is well-formed.
+ *
+ * @category Branch
+ * @signature
+ * ```ts
+ * function isValidBranchName(name: string): boolean;
+ * ```
+ *
+ * @param {string} name - Branch name to check is valid.
+ * @returns Returns `true` if the given branch name is well-formed.
+ */
+export declare function isValidBranchName(name: string): boolean
+export interface BranchesItem {
+  type: BranchType
+  name: string
+}
+/**
+ * - `Local` : A local branch not on a remote.
+ * - `Remote` : A branch for a remote.
+ */
+export type BranchType = 'Local' | 'Remote';
+export interface BranchRenameOptions {
+  /**
+   * If the force flag is not enabled, and there's already a branch with
+   * the given name, the renaming will fail.
+   */
+  force?: boolean
+}
+export interface CreateBranchOptions {
+  /**
+   * If `force` is true and a reference already exists with the given name,
+   * it'll be replaced.
+   */
+  force?: boolean
+}
+export interface BranchesFilter {
+  /** Branch type to filter. */
+  type?: BranchType
+}
 export interface CommitOptions {
   updateRef?: string
   /**
@@ -20,6 +126,18 @@ export interface CommitOptions {
    */
   committer?: SignaturePayload
   parents?: Array<string>
+  /**
+   * GPG signature string for signed commits.
+   *
+   * If provided, this will create a signed commit.
+   */
+  signature?: string
+  /**
+   * Custom signature field name.
+   *
+   * If not provided, the default signature field (gpgsig) will be used.
+   */
+  signatureField?: string
 }
 /**
  * - `ProgramData` : System-wide on Windows, for compatibility with portable git.
@@ -538,6 +656,33 @@ export interface IndexUpdateAllOptions {
    */
   onMatch?: (args: IndexOnMatchCallbackArgs) => number
 }
+export interface AddMailmapEntryData {
+  realName?: string
+  realEmail?: string
+  replaceName?: string
+  replaceEmail: string
+}
+/**
+ * Create a mailmap from the contents of a string.
+ *
+ * The format of the string should follow the rules of the mailmap file:
+ * ```
+ * # Comment line (ignored)
+ * Seokju Me <seokju.me@toss.im> Seokju Na <seokju.me@gmail.com>
+ * ```
+ *
+ * @param {string} content - Content of the mailmap file
+ * @returns A new mailmap object
+ * @throws An error if operation failed
+ *
+ * @category Mailmap
+ *
+ * @signature
+ * ```ts
+ * function createMailmapFromBuffer(content: string): Mailmap;
+ * ```
+ */
+export declare function createMailmapFromBuffer(content: string): Mailmap
 /**
  * - `Any` : Any kind of git object
  * - `Commit` : An object which corresponds to a git commit
@@ -1048,6 +1193,12 @@ export interface RepositoryCloneOptions {
   /** Options which can be specified to various fetch operations. */
   fetch?: FetchOptions
 }
+export interface ExtractedSignature {
+  /** GPG signature of the commit, or null if the commit is not signed. */
+  signature: string
+  /** Signed data of the commit. */
+  signedData: string
+}
 /**
  * Creates a new repository in the specified folder.
  *
@@ -1318,6 +1469,66 @@ export interface SignaturePayload {
   email: string
   timeOptions?: SignatureTimeOptions
 }
+export interface Status {
+  current: boolean
+  indexNew: boolean
+  indexModified: boolean
+  indexDeleted: boolean
+  indexRenamed: boolean
+  indexTypechange: boolean
+  wtNew: boolean
+  wtModified: boolean
+  wtDeleted: boolean
+  wtTypechange: boolean
+  wtRenamed: boolean
+  ignored: boolean
+  conflicted: boolean
+}
+/**
+ * - `Index` : Only gives status based on HEAD to index comparison, not looking at
+ * working directory changes.
+ * - `Workdir` : Only gives status based on index to working directory comparison, not
+ * comparing the index to the HEAD.
+ * - `IndexAndWorkdi` : The default, this roughly matches `git status --porcelain` regarding
+ * which files are included and in what order.
+ */
+export type StatusShow = 'Index' | 'Workdir' | 'IndexAndWorkdir';
+export interface StatusOptions {
+  /**
+   * Select the files on which to report status.
+   * The default, if unspecified, is to show the index and the working directory.
+   */
+  show?: StatusShow
+  /**
+   * Path patterns to match (using fnmatch-style matching).
+   * If the `disablePathspecMatch` option is given, then this is a literal
+   * path to match. If this is not called, then there will be no patterns to
+   * match and the entire directory will be used.
+   */
+  pathspecs?: Array<string>
+  /**
+   * Flag whether untracked files will be included.
+   * Untracked files will only be included if the workdir files are included
+   * in the status "show" option.
+   */
+  includeUntracked?: boolean
+  includeIgnored?: boolean
+  includeUnmodified?: boolean
+  excludeSubmodules?: boolean
+  recurseUntrackedDirs?: boolean
+  disablePathspecMatch?: boolean
+  recurseIgnoredDirs?: boolean
+  renamesHeadToIndex?: boolean
+  renamesIndexToWorkdir?: boolean
+  sortCaseSensitively?: boolean
+  sortCaseInsensitively?: boolean
+  renamesFromRewrites?: boolean
+  noRefresh?: boolean
+  updateIndex?: boolean
+  includeUnreadable?: boolean
+  includeUnreadableAsUntracked?: boolean
+  renameThreshold?: number
+}
 /**
  * Determine whether a tag name is valid, meaning that (when prefixed with refs/tags/) that
  * it is a valid reference name, and that any additional tag name restrictions are imposed
@@ -1362,6 +1573,146 @@ export interface CreateLightweightTagOptions {
  * - `PostOrder` : Runs the traversal in post-order.
  */
 export type TreeWalkMode = 'PreOrder' | 'PostOrder';
+/** A wrapper around git2::Blame providing Node.js bindings */
+export declare class Blame {
+  /**
+   * Gets the number of hunks in the blame result
+   *
+   * @category Blame/Methods
+   * @signature
+   * ```ts
+   * class Blame {
+   *   getHunkCount(): number;
+   * }
+   * ```
+   *
+   * @returns The number of hunks in the blame result
+   */
+  getHunkCount(): number
+  /**
+   * Checks if the blame result is empty
+   *
+   * @category Blame/Methods
+   * @signature
+   * ```ts
+   * class Blame {
+   *   isEmpty(): boolean;
+   * }
+   * ```
+   *
+   * @returns True if the blame result contains no hunks
+   */
+  isEmpty(): boolean
+  /**
+   * Gets blame information for the specified index
+   *
+   * @category Blame/Methods
+   * @signature
+   * ```ts
+   * class Blame {
+   *   getHunkByIndex(index: number): BlameHunk;
+   * }
+   * ```
+   *
+   * @param {number} index - Index of the hunk to get (0-based)
+   * @returns Blame information for the specified index
+   * @throws If no hunk is found at the index
+   */
+  getHunkByIndex(index: number): BlameHunk
+  /**
+   * Gets blame information for the specified line
+   *
+   * @category Blame/Methods
+   * @signature
+   * ```ts
+   * class Blame {
+   *   getHunkByLine(line: number): BlameHunk;
+   * }
+   * ```
+   *
+   * @param {number} line - Line number to get blame information for (1-based)
+   * @returns Blame information for the specified line
+   * @throws If no hunk is found for the line
+   */
+  getHunkByLine(line: number): BlameHunk
+  /**
+   * Gets all blame hunks as an iterator
+   *
+   * @category Blame/Methods
+   * @signature
+   * ```ts
+   * class Blame {
+   *   iter(): Generator<BlameHunk>;
+   * }
+   * ```
+   *
+   * @returns Iterator of all blame hunks
+   * @example
+   * ```ts
+   * // Using for...of loop
+   * for (const hunk of blame.iter()) {
+   *   console.log(hunk.finalCommitId);
+   * }
+   *
+   * // Using spread operator to collect all hunks
+   * const hunks = [...blame.iter()];
+   * ```
+   */
+  iter(): BlameHunks
+  /**
+   * Collects blame hunks by scanning file lines as an iterator
+   *
+   * @category Blame/Methods
+   * @signature
+   * ```ts
+   * class Blame {
+   *   iterByLine(): Generator<BlameHunk>;
+   * }
+   * ```
+   *
+   * @returns Iterator of blame hunks collected by line scanning
+   * @example
+   * ```ts
+   * // Using for...of loop
+   * for (const hunk of blame.iterByLine()) {
+   *   console.log(hunk.finalCommitId);
+   * }
+   *
+   * // Using spread operator to collect all hunks
+   * const hunks = [...blame.iterByLine()];
+   * ```
+   */
+  iterByLine(): BlameHunksByLine
+  /**
+   * Generates blame information from an in-memory buffer
+   *
+   * @category Blame/Methods
+   * @signature
+   * ```ts
+   * class Blame {
+   *   buffer(buffer: Buffer): Blame;
+   * }
+   * ```
+   *
+   * @example
+   * ```ts
+   * const buffer = Buffer.from('modified content');
+   * const bufferBlame = blame.buffer(buffer);
+   * ```
+   *
+   * @param {Buffer} buffer - Buffer containing file content to blame
+   * @returns A new Blame object for the buffer content
+   */
+  buffer(buffer: Buffer): Blame
+}
+/** An iterator over blame hunks. */
+export declare class BlameHunks {
+  [Symbol.iterator](): Iterator<BlameHunk, void, void>
+}
+/** Iterator over blame hunks collected line by line. */
+export declare class BlameHunksByLine {
+  [Symbol.iterator](): Iterator<BlameHunk, void, void>
+}
 /**
  * A class to represent a git [blob][1].
  * [1]: https://git-scm.com/book/en/Git-Internals-Git-Objects
@@ -1428,6 +1779,148 @@ export declare class Blob {
    */
   size(): bigint
 }
+/**
+ * A structure to represent a git [branch][1]
+ *
+ * A branch is currently just a wrapper to an underlying `Reference`. The
+ * reference can be accessed through the `get` and `into_reference` methods.
+ *
+ * [1]: http://git-scm.com/book/en/Git-Branching-What-a-Branch-Is
+ */
+export declare class Branch {
+  /**
+   * Get the OID pointed to by a reference which is this branch.
+   *
+   * @category Branch/Methods
+   * @signature
+   * ```ts
+   * class Branch {
+   *   referenceTarget(): string | null;
+   * }
+   * ```
+   *
+   * @returns The OID pointed to by a reference which is this branch.
+   */
+  referenceTarget(): string | null
+  /**
+   * Delete an existing branch reference.
+   *
+   * @category Branch/Methods
+   * @signature
+   * ```ts
+   * class Branch {
+   *   delete(): void;
+   * }
+   * ```
+   */
+  delete(): void
+  /**
+   * Determine if the current local branch is pointed at by `HEAD`.
+   *
+   * @category Branch/Methods
+   * @signature
+   * ```ts
+   * class Branch {
+   *   isHead(): boolean;
+   * }
+   * ```
+   *
+   * @returns Returns `true` if the current local branch is pointed at by `HEAD`.
+   */
+  isHead(): boolean
+  /**
+   * Move/rename an existing local branch reference.
+   *
+   * @category Branch/Methods
+   * @signature
+   * ```ts
+   * class Branch {
+   *   rename(newBranchName: string, options?: BranchRenameOptions | null | undefined): Branch;
+   * }
+   * ```
+   *
+   * @param {string} newBranchName - Branch name to move/rename.
+   * @param {BranchRenameOptions} [options] - Options for move/rename branch.
+   * @returns Move/renamed branch.
+   */
+  rename(newBranchName: string, options?: BranchRenameOptions | undefined | null): Branch
+  /**
+   * Return the name of the given local or remote branch.
+   *
+   * @category Branch/Methods
+   * @signature
+   * ```ts
+   * class Branch {
+   *   name(): string;
+   * }
+   * ```
+   *
+   * @returns The name of the given local or remote branch.
+   * @throws If the name is not valid utf-8.
+   */
+  name(): string
+  /**
+   * Return the reference supporting the remote tracking branch, given a
+   * local branch reference.
+   *
+   * @category Branch/Methods
+   * @signature
+   * ```ts
+   * class Branch {
+   *   findUpstream(): Branch | null;
+   * }
+   * ```
+   *
+   * @returns The reference supporting the remote tacking branch.
+   */
+  findUpstream(): Branch | null
+  /**
+   * Return the reference supporting the remote tracking branch, given a
+   * local branch reference.
+   *
+   * @category Branch/Methods
+   * @signature
+   * ```ts
+   * class Branch {
+   *   getUpstream(): Branch;
+   * }
+   * ```
+   *
+   * @returns The reference supporting the remote tacking branch.
+   * @throws Throws error if upstream does not exist.
+   */
+  getUpstream(): Branch
+  /**
+   * Set the upstream configuration for a given local branch.
+   *
+   * @category Branch/Methods
+   * @signature
+   * ```ts
+   * class Branch {
+   *   setUpstream(upstreamName: string): void;
+   * }
+   * ```
+   *
+   * @param {string} upstreamName - Branch name to set as upstream.
+   */
+  setUpstream(upstreamName: string): void
+  /**
+   * Unset the upstream configuration for a given local branch.
+   *
+   * @category Branch/Methods
+   * @signature
+   * ```ts
+   * class Branch {
+   *   unsetUpstream(): void;
+   * }
+   * ```
+   */
+  unsetUpstream(): void
+}
+/** An iterator over the branches inside of a repository. */
+export declare class Branches {
+  [Symbol.iterator](): Iterator<BranchesItem, void, void>
+}
 /** A class to represent a git commit. */
 export declare class Commit {
   /**
@@ -1584,6 +2077,40 @@ export declare class Commit {
    * @returns `GitObject` that casted from this commit.
    */
   asObject(): GitObject
+  /**
+   * Get the author of this commit, using the mailmap to map it to the canonical name and email.
+   *
+   * @category Commit/Methods
+   *
+   * @signature
+   * ```ts
+   * class Commit {
+   *   authorWithMailmap(mailmap: Mailmap): Signature;
+   * }
+   * ```
+   *
+   * @param {Mailmap} mailmap - The mailmap to use for mapping
+   * @returns Author signature of this commit with mapping applied
+   * @throws An error if the operation failed.
+   */
+  authorWithMailmap(mailmap: Mailmap): Signature
+  /**
+   * Get the committer of this commit, using the mailmap to map it to the canonical name and email.
+   *
+   * @category Commit/Methods
+   *
+   * @signature
+   * ```ts
+   * class Commit {
+   *   committerWithMailmap(mailmap: Mailmap): Signature;
+   * }
+   * ```
+   *
+   * @param {Mailmap} mailmap - The mailmap to use for mapping
+   * @returns Committer signature of this commit with mapping applied
+   * @throws An error if the operation failed.
+   */
+  committerWithMailmap(mailmap: Mailmap): Signature
 }
 /** An iterator over the `ConfigEntry` values of a config. */
 export declare class ConfigEntries {
@@ -2672,10 +3199,59 @@ export declare class Index {
 export declare class IndexEntries {
   [Symbol.iterator](): Iterator<IndexEntry, void, void>
 }
-/**
- * A class to represent a git [object][1].
- *
- * [1]: https://git-scm.com/book/en/Git-Internals-Git-Objects
+/** A wrapper around git2::Mailmap providing Node.js bindings */
+export declare class Mailmap {
+  /**
+   * Add a new Mailmap entry.
+   *
+   * Maps an author/committer (specified by `replace_name` and `replace_email`)
+   * to the specified real name and email. The `replace_email` is required but
+   * the other parameters can be null.
+   *
+   * If both `replace_name` and `replace_email` are provided, then the entry will
+   * apply to those who match both. If only `replace_name` is provided,
+   * it will apply to anyone with that name, regardless of email. If only
+   * `replace_email` is provided, it will apply to anyone with that email,
+   * regardless of name.
+   *
+   * @param {AddMailmapEntryData} entry - The mailmap entry data.
+   * @returns {void}
+   * @throws An error if the operation failed.
+   *
+   * @category Mailmap/Methods
+   *
+   * @signature
+   * ```ts
+   * class Mailmap {
+   *   addEntry(entry: AddMailmapEntryData): void;
+   * }
+   * ```
+   */
+  addEntry(entry: AddMailmapEntryData): void
+  /**
+   * Resolve a signature to its canonical form using a mailmap.
+   *
+   * Returns a new signature with the canonical name and email.
+   *
+   * @param {SignaturePayload} signature - Signature to resolve
+   * @returns The resolved signature with canonical name and email
+   * @throws An error if the operation failed.
+   *
+   * @category Mailmap/Methods
+   *
+   * @signature
+   * ```ts
+   * class Mailmap {
+   *   resolveSignature(signature: SignaturePayload): Signature;
+   * }
+   * ```
+   */
+  resolveSignature(signature: SignaturePayload): Signature
+}
+/**
+ * A class to represent a git [object][1].
+ *
+ * [1]: https://git-scm.com/book/en/Git-Internals-Git-Objects
  */
 export declare class GitObject {
   /**
@@ -3213,6 +3789,117 @@ export declare class Remote {
  * This class corresponds to a git repository in libgit2.
  */
 export declare class Repository {
+  /**
+   * Creates a blame object for the file at the given path
+   *
+   * @category Repository/Methods
+   * @signature
+   * ```ts
+   * class Repository {
+   *   blameFile(path: string, options?: BlameOptions): Blame;
+   * }
+   * ```
+   *
+   * @example
+   * ```ts
+   * // Blame the entire file
+   * const blame = repo.blameFile('path/to/file.js');
+   *
+   * // Blame a single line
+   * const lineBlame = repo.blameFile('path/to/file.js', { minLine: 10, maxLine: 10 });
+   *
+   * // Blame a range of lines
+   * const rangeBlame = repo.blameFile('path/to/file.js', { minLine: 5, maxLine: 15 });
+   * ```
+   *
+   * @param {string} path - Path to the file to blame
+   * @param {BlameOptions} [options] - Options to control blame behavior
+   * @returns Blame object for the specified file
+   * @throws If the file doesn't exist or can't be opened
+   */
+  blameFile(path: string, options?: BlameOptions | undefined | null): Blame
+  /**
+   * Create a new branch pointing at a target commit
+   *
+   * A new direct reference will be created pointing to this target commit.
+   *
+   * @category Repository/Methods
+   * @signature
+   * ```ts
+   * class Repository {
+   *   createBranch(
+   *     branchName: string,
+   *     target: Commit,
+   *     options?: CreateBranchOptions | null | undefined,
+   *   ): Branch;
+   * }
+   * ```
+   *
+   * @param {string} branchName - Name for the new branch.
+   * @param {Commit} target - Target commit which will be pointed by this branch.
+   * @param {CreateBranchOptions} [options] - Options for create branch.
+   * @returns {Branch} Newly created branch.
+   */
+  createBranch(branchName: string, target: Commit, options?: CreateBranchOptions | undefined | null): Branch
+  /**
+   * Lookup a branch by its name in a repository.
+   *
+   * @category Repository/Methods
+   * @signature
+   * ```ts
+   * class Repository {
+   *   findBranch(name: string, branchType: BranchType): Branch | null;
+   * }
+   * ```
+   *
+   * @param {string} name - A branch name.
+   * @param {BranchType} branchType - Branch type to lookup.
+   * @returns A found branch.
+   */
+  findBranch(name: string, branchType: BranchType): Branch | null
+  /**
+   * Lookup a branch by its name in a repository.
+   *
+   * @category Repository/Methods
+   * @signature
+   * ```ts
+   * class Repository {
+   *   getBranch(name: string, branchType: BranchType): Branch;
+   * }
+   * ```
+   *
+   * @param {string} name - A branch name.
+   * @param {BranchType} branchType - Branch type to lookup.
+   * @returns A found branch.
+   * @throws Throws error if branch does not exist.
+   */
+  getBranch(name: string, branchType: BranchType): Branch
+  /**
+   * Create an iterator which loops over the requested branches.
+   *
+   * @category Repository/Methods
+   * @signature
+   * ```ts
+   * class Repository {
+   *   branches(filter?: BranchesFilter | null | undefined): Branches;
+   * }
+   * ```
+   *
+   * @param {BranchesFilter} [filter] - Filter for the branches iterator.
+   * @returns An iterator which loops over the requested branches.
+   * @example
+   * ```ts
+   * import { openRepository } from 'es-git';
+   *
+   * const repo = await openRepository('/path/to/repo');
+   *
+   * for (const branch of repo.branches()) {
+   *   console.log(branch.type); // "Local"
+   *   console.log(branch.name); // "main"
+   * }
+   * ```
+   */
+  branches(filter?: BranchesFilter | undefined | null): Branches
   /**
    * Lookup a reference to one of the commits in a repository.
    *
@@ -3420,6 +4107,84 @@ export declare class Repository {
    * staged deletes, tracked files, etc.
    */
   diffTreeToWorkdirWithIndex(oldTree?: Tree | undefined | null, options?: DiffOptions | undefined | null): Diff
+  /**
+   * Add ignore rules for a repository.
+   *
+   * This adds ignore rules to the repository. The rules will be used
+   * in addition to any existing ignore rules (such as .gitignore files).
+   *
+   * @category Repository/Methods
+   * @signature
+   * ```ts
+   * class Repository {
+   *   addIgnoreRule(rules: string): void;
+   * }
+   * ```
+   *
+   * @param {string} rules - Rules to add, separated by newlines.
+   *
+   * @example
+   * ```ts
+   * import { openRepository } from 'es-git';
+   *
+   * const repo = await openRepository('./path/to/repo');
+   * repo.addIgnoreRule("node_modules/");
+   * ```
+   */
+  addIgnoreRule(rules: string): void
+  /**
+   * Clear ignore rules that were explicitly added.
+   *
+   * Resets to the default internal ignore rules.
+   * This will not turn off rules in .gitignore files that actually exist in the filesystem.
+   * The default internal ignores ignore ".", ".." and ".git" entries.
+   *
+   * @category Repository/Methods
+   * @signature
+   * ```ts
+   * class Repository {
+   *   clearIgnoreRules(): void;
+   * }
+   * ```
+   *
+   * @example
+   * ```ts
+   * import { openRepository } from 'es-git';
+   *
+   * const repo = await openRepository('./path/to/repo');
+   * repo.addIgnoreRule("*.log");
+   * // Later, clear all added rules
+   * repo.clearIgnoreRules();
+   * ```
+   */
+  clearIgnoreRules(): void
+  /**
+   * Test if the ignore rules apply to a given path.
+   *
+   * This function checks the ignore rules to see if they would apply to the given file.
+   * This indicates if the file would be ignored regardless of whether the file is already in the index or committed to the repository.
+   *
+   * @category Repository/Methods
+   * @signature
+   * ```ts
+   * class Repository {
+   *   isPathIgnored(path: string): boolean;
+   * }
+   * ```
+   *
+   * @param {string} path - The path to check.
+   * @returns {boolean} - True if the path is ignored, false otherwise.
+   *
+   * @example
+   * ```ts
+   * import { openRepository } from 'es-git';
+   *
+   * const repo = await openRepository('./path/to/repo');
+   * const isIgnored = repo.isPathIgnored("node_modules/some-package");
+   * console.log(`Path is ${isIgnored ? "ignored" : "not ignored"}`);
+   * ```
+   */
+  isPathIgnored(path: string): boolean
   /**
    * Get the Index file for this repository.
    *
@@ -3437,6 +4202,21 @@ export declare class Repository {
    * @returns The index file for this repository.
    */
   index(): Index
+  /**
+   * Gets this repository's mailmap.
+   *
+   * @category Repository/Methods
+   *
+   * @signature
+   * ```ts
+   * class Repository {
+   *   mailmap(): Mailmap | null;
+   * }
+   * ```
+   *
+   * @returns The mailmap object if it exists, null otherwise
+   */
+  mailmap(): Mailmap | null
   /**
    * Lookup a reference to one of the objects in a repository.
    *
@@ -3730,6 +4510,25 @@ export declare class Repository {
    * @param {string} refname - Specified reference to point into `HEAD`.
    */
   setHead(refname: string): void
+  /**
+   * Extract a signature from an object identified by its ID.
+   *
+   * This method can be used for any object that may be signed, such as commits or tags.
+   *
+   * @category Repository/Methods
+   *
+   * @signature
+   * ```ts
+   * class Repository {
+   *   extractSignature(oid: string): ExtractedSignature | null;
+   * }
+   * ```
+   *
+   * @param {string} oid - Object ID (SHA1) of the signed object to extract the signature from.
+   * @returns An ExtractedSignature object containing the signature and signed data if the object is signed,
+   *          or null if the object is not signed.
+   */
+  extractSignature(oid: string): ExtractedSignature | null
   /**
    * Execute a rev-parse operation against the `spec` listed.
    *
@@ -3778,6 +4577,108 @@ export declare class Repository {
    * @returns Revwalk to traverse the commit graph in this repository.
    */
   revwalk(): Revwalk
+  /**
+   * Test if the ignore rules apply to a given file.
+   *
+   * This function checks the ignore rules to see if they would apply to the
+   * given file. This indicates if the file would be ignored regardless of
+   * whether the file is already in the index or committed to the repository.
+   *
+   * One way to think of this is if you were to do "git add ." on the
+   * directory containing the file, would it be added or not?
+   *
+   * @category Repository/Methods
+   * @signature
+   * ```ts
+   * class Repository {
+   *   statusShouldIgnore(path: string): boolean;
+   * }
+   * ```
+   *
+   * @param {string} path - A given file path.
+   * @returns Returns `true` if the ignore rules apply to a given file.
+   */
+  statusShouldIgnore(path: string): boolean
+  /**
+   * Get file status for a single file.
+   *
+   * This tries to get status for the filename that you give. If no files
+   * match that name (in either the HEAD, index, or working directory), this
+   * returns NotFound.
+   *
+   * If the name matches multiple files (for example, if the path names a
+   * directory or if running on a case- insensitive filesystem and yet the
+   * HEAD has two entries that both match the path), then this returns
+   * Ambiguous because it cannot give correct results.
+   *
+   * This does not do any sort of rename detection. Renames require a set of
+   * targets and because of the path filtering, there is not enough
+   * information to check renames correctly. To check file status with rename
+   * detection, there is no choice but to do a full `statuses` and scan
+   * through looking for the path that you are interested in.
+   *
+   * @category Repository/Methods
+   * @signature
+   * ```ts
+   * class Repository {
+   *   getStatusFile(path: string): Status;
+   * }
+   * ```
+   *
+   * @param {string} path - A single file path.
+   * @returns The `Status` of this single file.
+   * @throws Throws error if the status file does not exist.
+   */
+  getStatusFile(path: string): Status
+  /**
+   * Get file status for a single file.
+   *
+   * This tries to get status for the filename that you give. If no files
+   * match that name (in either the HEAD, index, or working directory), this
+   * returns NotFound.
+   *
+   * If the name matches multiple files (for example, if the path names a
+   * directory or if running on a case- insensitive filesystem and yet the
+   * HEAD has two entries that both match the path), then this returns
+   * Ambiguous because it cannot give correct results.
+   *
+   * This does not do any sort of rename detection. Renames require a set of
+   * targets and because of the path filtering, there is not enough
+   * information to check renames correctly. To check file status with rename
+   * detection, there is no choice but to do a full `statuses` and scan
+   * through looking for the path that you are interested in.
+   *
+   * @category Repository/Methods
+   * @signature
+   * ```ts
+   * class Repository {
+   *   findStatusFile(path: string): Status | null;
+   * }
+   * ```
+   *
+   * @param {string} path - A single file path.
+   * @returns The `Status` of this single file. If the status file does not exists, returns `null`.
+   */
+  findStatusFile(path: string): Status | null
+  /**
+   * Gather file status information and populate the returned structure.
+   *
+   * Note that if a pathspec is given in the options to filter the
+   * status, then the results from rename detection (if you enable it) may
+   * not be accurate. To do rename detection properly, this must be called
+   * with no pathspec so that all files can be considered.
+   *
+   * @category Repository/Methods
+   * @signature
+   * ```ts
+   * class Repository {
+   *   statuses(): Statuses;
+   * }
+   * ```
+   *
+   * @returns A container for a list of status information about a repository.
+   */
+  statuses(): Statuses
   /**
    * Lookup a tag object by prefix hash from the repository.
    *
@@ -4223,6 +5124,123 @@ export declare class Revwalk {
    */
   hideRef(reference: string): this
 }
+/**
+ * A container for a list of status information about a repository.
+ *
+ * Each instance appears as if it were a collection, having a length and
+ * allowing indexing, as well as providing an iterator.
+ */
+export declare class Statuses {
+  /**
+   * Gets a status entry from this list at the specified index.
+   *
+   * @category Status/Statuses
+   * @signature
+   * ```ts
+   * class Statuses {
+   *   get(index: number): StatusEntry | null;
+   * }
+   * ```
+   *
+   * @param {number} index - Index of the status entry to get.
+   * @returns A status entry from this list at the specified index. Returns `null` if the status
+   * entry does not exist.
+   */
+  get(index: number): StatusEntry | null
+  /**
+   * Gets the count of status entries in this list.
+   *
+   * @category Status/Statuses
+   * @signature
+   * ```ts
+   * class Statuses {
+   *   len(): number;
+   * }
+   * ```
+   *
+   * @returns If there are no changes in status (according to the options given
+   * when the status list was created), this should return 0.
+   */
+  len(): bigint
+  /**
+   * @category Status/Statuses
+   * @signature
+   * ```ts
+   * class Statuses {
+   *   isEmpty(): boolean;
+   * }
+   * ```
+   *
+   * @returns Return `true` if there is no status entry in this list.
+   */
+  isEmpty(): boolean
+  /** Returns an iterator over the statuses in this list. */
+  iter(): StatusesIter
+}
+export declare class StatusesIter {
+  [Symbol.iterator](): Iterator<StatusEntry, void, void>
+}
+/** A structure representing an entry in the `Statuses` structure. */
+export declare class StatusEntry {
+  /**
+   * Access this entry's path name as a string.
+   *
+   * @category Status/StatusEntry
+   * @signature
+   * ```ts
+   * class StatusEntry {
+   *   path(): string;
+   * }
+   * ```
+   *
+   * @returns The path of this entry.
+   */
+  path(): string
+  /**
+   * Access the status for this file.
+   *
+   * @category Status/StatusEntry
+   * @signature
+   * ```ts
+   * class StatusEntry {
+   *   status(): Status;
+   * }
+   * ```
+   *
+   * @returns Status data for this entry.
+   */
+  status(): Status
+  /**
+   * Access detailed information about the differences between the file in
+   * `HEAD` and the file in the index.
+   *
+   * @category Status/StatusEntry
+   * @signature
+   * ```ts
+   * class StatusEntry {
+   *   headToIndex(): DiffDelta | null;
+   * }
+   * ```
+   *
+   * @returns The differences between the file in `HEAD` and the file in the index.
+   */
+  headToIndex(): DiffDelta | null
+  /**
+   * Access detailed information about the differences between the file in
+   * the index and the file in the working directory.
+   *
+   * @category Status/StatusEntry
+   * @signature
+   * ```ts
+   * class StatusEntry {
+   *   indexToWorkdir(): DiffDelta | null;
+   * }
+   * ```
+   *
+   * @returns Differences between the file in the index and the file in the working directory.
+   */
+  indexToWorkdir(): DiffDelta | null
+}
 /**
  * A class to represent a git [tag][1].
  *

package/index.js

@@ -310,9 +310,16 @@ if (!nativeBinding) {
   throw new Error(`Failed to load native binding`)
 }
 
-const { Blob, Commit, ConfigLevel, ConfigEntries, Config, openConfig, openDefaultConfig, findGlobalConfigPath, findSystemConfigPath, findXdgConfigPath, parseConfigBool, parseConfigI32, parseConfigI64, DiffFlags, diffFlagsContains, DeltaType, DiffFormat, Diff, DiffStats, Deltas, DiffDelta, FileMode, DiffFile, IndexStage, Index, IndexEntries, ObjectType, GitObject, isValidOid, isZeroOid, zeroOid, hashObjectOid, hashFileOid, ReferenceType, Reference, isValidReferenceName, ReferenceFormat, normalizeReferenceName, Direction, CredentialType, FetchPrune, AutotagOption, RemoteRedirect, Remote, RepositoryState, RepositoryInitMode, Repository, initRepository, openRepository, discoverRepository, cloneRepository, RevparseMode, revparseModeContains, RevwalkSort, Revwalk, createSignature, isValidTagName, Tag, TreeWalkMode, Tree, TreeIter, TreeEntry } = nativeBinding
+const { Blame, BlameHunks, BlameHunksByLine, Blob, isValidBranchName, Branch, Branches, BranchType, Commit, ConfigLevel, ConfigEntries, Config, openConfig, openDefaultConfig, findGlobalConfigPath, findSystemConfigPath, findXdgConfigPath, parseConfigBool, parseConfigI32, parseConfigI64, DiffFlags, diffFlagsContains, DeltaType, DiffFormat, Diff, DiffStats, Deltas, DiffDelta, FileMode, DiffFile, IndexStage, Index, IndexEntries, Mailmap, createMailmapFromBuffer, ObjectType, GitObject, isValidOid, isZeroOid, zeroOid, hashObjectOid, hashFileOid, ReferenceType, Reference, isValidReferenceName, ReferenceFormat, normalizeReferenceName, Direction, CredentialType, FetchPrune, AutotagOption, RemoteRedirect, Remote, RepositoryState, RepositoryInitMode, Repository, initRepository, openRepository, discoverRepository, cloneRepository, RevparseMode, revparseModeContains, RevwalkSort, Revwalk, createSignature, StatusShow, Statuses, StatusesIter, StatusEntry, isValidTagName, Tag, TreeWalkMode, Tree, TreeIter, TreeEntry } = nativeBinding
 
+module.exports.Blame = Blame
+module.exports.BlameHunks = BlameHunks
+module.exports.BlameHunksByLine = BlameHunksByLine
 module.exports.Blob = Blob
+module.exports.isValidBranchName = isValidBranchName
+module.exports.Branch = Branch
+module.exports.Branches = Branches
+module.exports.BranchType = BranchType
 module.exports.Commit = Commit
 module.exports.ConfigLevel = ConfigLevel
 module.exports.ConfigEntries = ConfigEntries
@@ -338,6 +345,8 @@ module.exports.DiffFile = DiffFile
 module.exports.IndexStage = IndexStage
 module.exports.Index = Index
 module.exports.IndexEntries = IndexEntries
+module.exports.Mailmap = Mailmap
+module.exports.createMailmapFromBuffer = createMailmapFromBuffer
 module.exports.ObjectType = ObjectType
 module.exports.GitObject = GitObject
 module.exports.isValidOid = isValidOid
@@ -368,6 +377,10 @@ module.exports.revparseModeContains = revparseModeContains
 module.exports.RevwalkSort = RevwalkSort
 module.exports.Revwalk = Revwalk
 module.exports.createSignature = createSignature
+module.exports.StatusShow = StatusShow
+module.exports.Statuses = Statuses
+module.exports.StatusesIter = StatusesIter
+module.exports.StatusEntry = StatusEntry
 module.exports.isValidTagName = isValidTagName
 module.exports.Tag = Tag
 module.exports.TreeWalkMode = TreeWalkMode

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "es-git",
-  "version": "0.2.0",
+  "version": "0.3.0-next.123+6428cec",
   "main": "index.js",
   "types": "index.d.ts",
   "files": [
@@ -57,15 +57,15 @@
     "vitest": "^3.0.5"
   },
   "optionalDependencies": {
-    "es-git-darwin-x64": "0.2.0",
-    "es-git-darwin-arm64": "0.2.0",
-    "es-git-win32-x64-msvc": "0.2.0",
-    "es-git-win32-arm64-msvc": "0.2.0",
-    "es-git-linux-x64-gnu": "0.2.0",
-    "es-git-linux-x64-musl": "0.2.0",
-    "es-git-android-arm64": "0.2.0",
-    "es-git-linux-arm64-gnu": "0.2.0",
-    "es-git-linux-arm64-musl": "0.2.0",
-    "es-git-android-arm-eabi": "0.2.0"
+    "es-git-darwin-x64": "0.3.0-next.123+6428cec",
+    "es-git-darwin-arm64": "0.3.0-next.123+6428cec",
+    "es-git-win32-x64-msvc": "0.3.0-next.123+6428cec",
+    "es-git-win32-arm64-msvc": "0.3.0-next.123+6428cec",
+    "es-git-linux-x64-gnu": "0.3.0-next.123+6428cec",
+    "es-git-linux-x64-musl": "0.3.0-next.123+6428cec",
+    "es-git-android-arm64": "0.3.0-next.123+6428cec",
+    "es-git-linux-arm64-gnu": "0.3.0-next.123+6428cec",
+    "es-git-linux-arm64-musl": "0.3.0-next.123+6428cec",
+    "es-git-android-arm-eabi": "0.3.0-next.123+6428cec"
   }
 }