es-git 0.2.0-next.119 → 0.2.0-next.121

package/index.d.ts

@@ -656,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
@@ -2050,6 +2077,38 @@ 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
+   */
+  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
+   */
+  committerWithMailmap(mailmap: Mailmap): Signature
 }
 /** An iterator over the `ConfigEntry` values of a config. */
 export declare class ConfigEntries {
@@ -3138,6 +3197,54 @@ export declare class Index {
 export declare class IndexEntries {
   [Symbol.iterator](): Iterator<IndexEntry, void, void>
 }
+/** 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
+   *
+   * @category Mailmap/Methods
+   *
+   * @signature
+   * ```ts
+   * class Mailmap {
+   *   resolveSignature(signature: SignaturePayload): Signature;
+   * }
+   * ```
+   */
+  resolveSignature(signature: SignaturePayload): Signature
+}
 /**
  * A class to represent a git [object][1].
  *
@@ -4007,7 +4114,7 @@ export declare class Repository {
    * @signature
    * ```ts
    * class Repository {
-   *   addIgnoreRule(rules: string): boolean;
+   *   addIgnoreRule(rules: string): void;
    * }
    * ```
    *
@@ -4092,6 +4199,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.
    *

package/index.js

@@ -310,7 +310,7 @@ if (!nativeBinding) {
   throw new Error(`Failed to load native binding`)
 }
 
-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, 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
+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
@@ -345,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

package/package.json

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