workspace-tools 0.41.5 → 0.41.7

package/lib/git/branchRefs.d.ts

@@ -0,0 +1,36 @@
+import type { GitBranchOptions, GitCommonOptions } from "./types.js";
+/**
+ * Gets the current branch name.
+ * In detached HEAD state, returns "HEAD".
+ *
+ * @returns The branch name if successful, null otherwise
+ */
+export declare function getBranchName(options: GitCommonOptions): string | null;
+/** @deprecated Use object params version */
+export declare function getBranchName(cwd: string): string | null;
+/**
+ * Gets the full reference path for a given branch.
+ * `branch` here is the short branch name, e.g. `branch-name`.
+ * @returns The full branch reference (e.g., `refs/heads/branch-name`) if found, null otherwise
+ */
+export declare function getFullBranchRef(options: GitBranchOptions): string | null;
+/** @deprecated Use object params version */
+export declare function getFullBranchRef(branch: string, cwd: string): string | null;
+/**
+ * Gets the short branch name from a full branch reference.
+ * @returns The short branch name if successful, null otherwise
+ */
+export declare function getShortBranchName(options: {
+    /** The full branch reference (e.g., `refs/heads/branch-name`) */
+    fullBranchRef: string;
+} & GitCommonOptions): string | null;
+/** @deprecated Use object params version */
+export declare function getShortBranchName(fullBranchRef: string, cwd: string): string | null;
+/**
+ * Gets the remote tracking branch for the specified branch.
+ *
+ * @returns The remote branch name (e.g., `origin/main`) if found, null otherwise
+ */
+export declare function getRemoteBranch(options: GitBranchOptions): string | null;
+/** @deprecated Use object params version */
+export declare function getRemoteBranch(branch: string, cwd: string): string | null;

package/lib/git/branchRefs.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+0 && (module.exports = {
+    getBranchName: null,
+    getFullBranchRef: null,
+    getRemoteBranch: null,
+    getShortBranchName: null
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: Object.getOwnPropertyDescriptor(all, name).get
+    });
+}
+_export(exports, {
+    get getBranchName () {
+        return getBranchName;
+    },
+    get getFullBranchRef () {
+        return getFullBranchRef;
+    },
+    get getRemoteBranch () {
+        return getRemoteBranch;
+    },
+    get getShortBranchName () {
+        return getShortBranchName;
+    }
+});
+const _git = require("./git.js");
+function getBranchName(cwdOrOptions) {
+    const options = typeof cwdOrOptions === "string" ? {
+        cwd: cwdOrOptions
+    } : cwdOrOptions;
+    const results = (0, _git.git)([
+        "rev-parse",
+        "--abbrev-ref",
+        "HEAD"
+    ], {
+        description: "Getting current branch name",
+        ...options
+    });
+    return results.success ? results.stdout : null;
+}
+function getFullBranchRef(branchOrOptions, cwd) {
+    const { branch, ...options } = typeof branchOrOptions === "string" ? {
+        branch: branchOrOptions,
+        cwd: cwd
+    } : branchOrOptions;
+    const showRefResults = (0, _git.git)([
+        "show-ref",
+        "--heads",
+        branch
+    ], options);
+    return showRefResults.success ? showRefResults.stdout.split(" ")[1] : null;
+}
+function getShortBranchName(refOrOptions, cwd) {
+    const { fullBranchRef, ...options } = typeof refOrOptions === "string" ? {
+        fullBranchRef: refOrOptions,
+        cwd: cwd
+    } : refOrOptions;
+    // The original command `git name-rev --name-only` returned unreliable results if multiple
+    // named refs point to the same commit as the branch.
+    const showRefResults = (0, _git.git)([
+        "rev-parse",
+        "--abbrev-ref",
+        fullBranchRef
+    ], options);
+    return showRefResults.success ? showRefResults.stdout || null : null;
+}
+function getRemoteBranch(branchOrOptions, cwd) {
+    const options = typeof branchOrOptions === "string" ? {
+        branch: branchOrOptions,
+        cwd: cwd
+    } : branchOrOptions;
+    const results = (0, _git.git)([
+        "rev-parse",
+        "--abbrev-ref",
+        "--symbolic-full-name",
+        `${options.branch}@{u}`
+    ], options);
+    return results.success ? results.stdout.trim() : null;
+}

package/lib/git/branchRefs.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/git/branchRefs.ts"],"sourcesContent":["import { git } from \"./git.js\";\nimport type { GitBranchOptions, GitCommonOptions } from \"./types.js\";\n\n/**\n * Gets the current branch name.\n * In detached HEAD state, returns \"HEAD\".\n *\n * @returns The branch name if successful, null otherwise\n */\nexport function getBranchName(options: GitCommonOptions): string | null;\n/** @deprecated Use object params version */\nexport function getBranchName(cwd: string): string | null;\nexport function getBranchName(cwdOrOptions: string | GitCommonOptions): string | null {\n  const options: GitCommonOptions = typeof cwdOrOptions === \"string\" ? { cwd: cwdOrOptions } : cwdOrOptions;\n\n  const results = git([\"rev-parse\", \"--abbrev-ref\", \"HEAD\"], {\n    description: \"Getting current branch name\",\n    ...options,\n  });\n  return results.success ? results.stdout : null;\n}\n\n/**\n * Gets the full reference path for a given branch.\n * `branch` here is the short branch name, e.g. `branch-name`.\n * @returns The full branch reference (e.g., `refs/heads/branch-name`) if found, null otherwise\n */\nexport function getFullBranchRef(options: GitBranchOptions): string | null;\n/** @deprecated Use object params version */\nexport function getFullBranchRef(branch: string, cwd: string): string | null;\nexport function getFullBranchRef(branchOrOptions: string | GitBranchOptions, cwd?: string): string | null {\n  const { branch, ...options } =\n    typeof branchOrOptions === \"string\" ? { branch: branchOrOptions, cwd: cwd! } : branchOrOptions;\n\n  const showRefResults = git([\"show-ref\", \"--heads\", branch], options);\n\n  return showRefResults.success ? showRefResults.stdout.split(\" \")[1] : null;\n}\n\n/**\n * Gets the short branch name from a full branch reference.\n * @returns The short branch name if successful, null otherwise\n */\nexport function getShortBranchName(\n  options: {\n    /** The full branch reference (e.g., `refs/heads/branch-name`) */\n    fullBranchRef: string;\n  } & GitCommonOptions\n): string | null;\n/** @deprecated Use object params version */\nexport function getShortBranchName(fullBranchRef: string, cwd: string): string | null;\nexport function getShortBranchName(\n  refOrOptions: string | ({ fullBranchRef: string } & GitCommonOptions),\n  cwd?: string\n): string | null {\n  const { fullBranchRef, ...options } =\n    typeof refOrOptions === \"string\" ? { fullBranchRef: refOrOptions, cwd: cwd! } : refOrOptions;\n\n  // The original command `git name-rev --name-only` returned unreliable results if multiple\n  // named refs point to the same commit as the branch.\n  const showRefResults = git([\"rev-parse\", \"--abbrev-ref\", fullBranchRef], options);\n\n  return showRefResults.success ? showRefResults.stdout || null : null;\n}\n\n/**\n * Gets the remote tracking branch for the specified branch.\n *\n * @returns The remote branch name (e.g., `origin/main`) if found, null otherwise\n */\nexport function getRemoteBranch(options: GitBranchOptions): string | null;\n/** @deprecated Use object params version */\nexport function getRemoteBranch(branch: string, cwd: string): string | null;\nexport function getRemoteBranch(branchOrOptions: string | GitBranchOptions, cwd?: string): string | null {\n  const options: GitBranchOptions =\n    typeof branchOrOptions === \"string\" ? { branch: branchOrOptions, cwd: cwd! } : branchOrOptions;\n\n  const results = git([\"rev-parse\", \"--abbrev-ref\", \"--symbolic-full-name\", `${options.branch}@{u}`], options);\n\n  return results.success ? results.stdout.trim() : null;\n}\n"],"names":["getBranchName","getFullBranchRef","getRemoteBranch","getShortBranchName","cwdOrOptions","options","cwd","results","git","description","success","stdout","branchOrOptions","branch","showRefResults","split","refOrOptions","fullBranchRef","trim"],"mappings":";;;;;;;;;;;;;;;;;QAYgBA;eAAAA;;QAkBAC;eAAAA;;QA2CAC;eAAAA;;QAtBAC;eAAAA;;;qBAnDI;AAYb,SAASH,cAAcI,YAAuC;IACnE,MAAMC,UAA4B,OAAOD,iBAAiB,WAAW;QAAEE,KAAKF;IAAa,IAAIA;IAE7F,MAAMG,UAAUC,IAAAA,QAAG,EAAC;QAAC;QAAa;QAAgB;KAAO,EAAE;QACzDC,aAAa;QACb,GAAGJ,OAAO;IACZ;IACA,OAAOE,QAAQG,OAAO,GAAGH,QAAQI,MAAM,GAAG;AAC5C;AAUO,SAASV,iBAAiBW,eAA0C,EAAEN,GAAY;IACvF,MAAM,EAAEO,MAAM,EAAE,GAAGR,SAAS,GAC1B,OAAOO,oBAAoB,WAAW;QAAEC,QAAQD;QAAiBN,KAAKA;IAAK,IAAIM;IAEjF,MAAME,iBAAiBN,IAAAA,QAAG,EAAC;QAAC;QAAY;QAAWK;KAAO,EAAER;IAE5D,OAAOS,eAAeJ,OAAO,GAAGI,eAAeH,MAAM,CAACI,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG;AACxE;AAcO,SAASZ,mBACda,YAAqE,EACrEV,GAAY;IAEZ,MAAM,EAAEW,aAAa,EAAE,GAAGZ,SAAS,GACjC,OAAOW,iBAAiB,WAAW;QAAEC,eAAeD;QAAcV,KAAKA;IAAK,IAAIU;IAElF,0FAA0F;IAC1F,qDAAqD;IACrD,MAAMF,iBAAiBN,IAAAA,QAAG,EAAC;QAAC;QAAa;QAAgBS;KAAc,EAAEZ;IAEzE,OAAOS,eAAeJ,OAAO,GAAGI,eAAeH,MAAM,IAAI,OAAO;AAClE;AAUO,SAAST,gBAAgBU,eAA0C,EAAEN,GAAY;IACtF,MAAMD,UACJ,OAAOO,oBAAoB,WAAW;QAAEC,QAAQD;QAAiBN,KAAKA;IAAK,IAAIM;IAEjF,MAAML,UAAUC,IAAAA,QAAG,EAAC;QAAC;QAAa;QAAgB;QAAwB,GAAGH,QAAQQ,MAAM,CAAC,IAAI,CAAC;KAAC,EAAER;IAEpG,OAAOE,QAAQG,OAAO,GAAGH,QAAQI,MAAM,CAACO,IAAI,KAAK;AACnD"}

package/lib/git/config.d.ts

@@ -6,3 +6,19 @@ import { type GitCommonOptions } from "./types.js";
 export declare function getConfigValue(options: {
     key: string;
 } & GitCommonOptions): string | null;
+/**
+ * Gets the user email from the git config.
+ * (Note: setting `throwOnError: true` will cause it to fail if the key is unset.)
+ *
+ * @returns The email string if found, null otherwise
+ */
+export declare function getUserEmail(options: GitCommonOptions): string | null;
+/** @deprecated Use object params version */
+export declare function getUserEmail(cwd: string): string | null;
+/**
+ * Gets the default branch based on `git config init.defaultBranch`, falling back to `master`.
+ * (Note: setting `throwOnError: true` will cause it to fail if the key is unset.)
+ */
+export declare function getDefaultBranch(options: GitCommonOptions): string;
+/** @deprecated Use object params version */
+export declare function getDefaultBranch(cwd: string): string;

package/lib/git/config.js

@@ -2,10 +2,26 @@
 Object.defineProperty(exports, "__esModule", {
     value: true
 });
-Object.defineProperty(exports, "getConfigValue", {
-    enumerable: true,
-    get: function() {
+0 && (module.exports = {
+    getConfigValue: null,
+    getDefaultBranch: null,
+    getUserEmail: null
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: Object.getOwnPropertyDescriptor(all, name).get
+    });
+}
+_export(exports, {
+    get getConfigValue () {
         return getConfigValue;
+    },
+    get getDefaultBranch () {
+        return getDefaultBranch;
+    },
+    get getUserEmail () {
+        return getUserEmail;
     }
 });
 const _git = require("./git.js");
@@ -17,4 +33,23 @@ function getConfigValue(options) {
     ], gitOptions);
     // command failure here just means it's not set
     return results.success ? results.stdout.trim() : null;
-} // Other config helpers can move here in the future
+}
+function getUserEmail(cwdOrOptions) {
+    const options = typeof cwdOrOptions === "string" ? {
+        cwd: cwdOrOptions
+    } : cwdOrOptions;
+    return getConfigValue({
+        key: "user.email",
+        ...options
+    });
+}
+function getDefaultBranch(cwdOrOptions) {
+    const options = typeof cwdOrOptions === "string" ? {
+        cwd: cwdOrOptions
+    } : cwdOrOptions;
+    // Default to the legacy 'master' for backwards compat and old git clients
+    return getConfigValue({
+        key: "init.defaultBranch",
+        ...options
+    }) || "master";
+}

package/lib/git/config.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/git/config.ts"],"sourcesContent":["import { git } from \"./git.js\";\nimport { type GitCommonOptions } from \"./types.js\";\n\n/**\n * Get the value of a git config key. Returns null if it's not set.\n * (Note: setting `throwOnError: true` will cause it to fail if the key is unset.)\n */\nexport function getConfigValue(options: { key: string } & GitCommonOptions): string | null {\n  const { key, ...gitOptions } = options;\n  const results = git([\"config\", key], gitOptions);\n  // command failure here just means it's not set\n  return results.success ? results.stdout.trim() : null;\n}\n\n// Other config helpers can move here in the future\n"],"names":["getConfigValue","options","key","gitOptions","results","git","success","stdout","trim"],"mappings":";;;;+BAOgBA;;;eAAAA;;;qBAPI;AAOb,SAASA,eAAeC,OAA2C;IACxE,MAAM,EAAEC,GAAG,EAAE,GAAGC,YAAY,GAAGF;IAC/B,MAAMG,UAAUC,IAAAA,QAAG,EAAC;QAAC;QAAUH;KAAI,EAAEC;IACrC,+CAA+C;IAC/C,OAAOC,QAAQE,OAAO,GAAGF,QAAQG,MAAM,CAACC,IAAI,KAAK;AACnD,EAEA,mDAAmD"}
+{"version":3,"sources":["../../src/git/config.ts"],"sourcesContent":["import { git } from \"./git.js\";\nimport { type GitCommonOptions } from \"./types.js\";\n\n/**\n * Get the value of a git config key. Returns null if it's not set.\n * (Note: setting `throwOnError: true` will cause it to fail if the key is unset.)\n */\nexport function getConfigValue(options: { key: string } & GitCommonOptions): string | null {\n  const { key, ...gitOptions } = options;\n  const results = git([\"config\", key], gitOptions);\n  // command failure here just means it's not set\n  return results.success ? results.stdout.trim() : null;\n}\n\n/**\n * Gets the user email from the git config.\n * (Note: setting `throwOnError: true` will cause it to fail if the key is unset.)\n *\n * @returns The email string if found, null otherwise\n */\nexport function getUserEmail(options: GitCommonOptions): string | null;\n/** @deprecated Use object params version */\nexport function getUserEmail(cwd: string): string | null;\nexport function getUserEmail(cwdOrOptions: string | GitCommonOptions): string | null {\n  const options: GitCommonOptions = typeof cwdOrOptions === \"string\" ? { cwd: cwdOrOptions } : cwdOrOptions;\n  return getConfigValue({ key: \"user.email\", ...options });\n}\n\n/**\n * Gets the default branch based on `git config init.defaultBranch`, falling back to `master`.\n * (Note: setting `throwOnError: true` will cause it to fail if the key is unset.)\n */\nexport function getDefaultBranch(options: GitCommonOptions): string;\n/** @deprecated Use object params version */\nexport function getDefaultBranch(cwd: string): string;\nexport function getDefaultBranch(cwdOrOptions: string | GitCommonOptions): string {\n  const options = typeof cwdOrOptions === \"string\" ? { cwd: cwdOrOptions } : cwdOrOptions;\n\n  // Default to the legacy 'master' for backwards compat and old git clients\n  return getConfigValue({ key: \"init.defaultBranch\", ...options }) || \"master\";\n}\n"],"names":["getConfigValue","getDefaultBranch","getUserEmail","options","key","gitOptions","results","git","success","stdout","trim","cwdOrOptions","cwd"],"mappings":";;;;;;;;;;;;;;;;QAOgBA;eAAAA;;QA4BAC;eAAAA;;QAZAC;eAAAA;;;qBAvBI;AAOb,SAASF,eAAeG,OAA2C;IACxE,MAAM,EAAEC,GAAG,EAAE,GAAGC,YAAY,GAAGF;IAC/B,MAAMG,UAAUC,IAAAA,QAAG,EAAC;QAAC;QAAUH;KAAI,EAAEC;IACrC,+CAA+C;IAC/C,OAAOC,QAAQE,OAAO,GAAGF,QAAQG,MAAM,CAACC,IAAI,KAAK;AACnD;AAWO,SAASR,aAAaS,YAAuC;IAClE,MAAMR,UAA4B,OAAOQ,iBAAiB,WAAW;QAAEC,KAAKD;IAAa,IAAIA;IAC7F,OAAOX,eAAe;QAAEI,KAAK;QAAc,GAAGD,OAAO;IAAC;AACxD;AASO,SAASF,iBAAiBU,YAAuC;IACtE,MAAMR,UAAU,OAAOQ,iBAAiB,WAAW;QAAEC,KAAKD;IAAa,IAAIA;IAE3E,0EAA0E;IAC1E,OAAOX,eAAe;QAAEI,KAAK;QAAsB,GAAGD,OAAO;IAAC,MAAM;AACtE"}

package/lib/git/fetchRemote.d.ts

@@ -0,0 +1,13 @@
+import type { GitFetchOptions } from "./types.js";
+/**
+ * Fetch from the given remote (and optionally branch) or all remotes.
+ * Throws an error on failure by default.
+ */
+export declare function fetchRemote(options: GitFetchOptions): void;
+/** @deprecated Use object params version */
+export declare function fetchRemote(remote: string, cwd: string): void;
+/**
+ * Fetch from the given remote and branch. Throws an error on failure.
+ * @deprecated Use `fetchRemote({ remote, remoteBranch, cwd })`
+ */
+export declare function fetchRemoteBranch(remote: string, remoteBranch: string, cwd: string): void;

package/lib/git/fetchRemote.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+0 && (module.exports = {
+    fetchRemote: null,
+    fetchRemoteBranch: null
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: Object.getOwnPropertyDescriptor(all, name).get
+    });
+}
+_export(exports, {
+    get fetchRemote () {
+        return fetchRemote;
+    },
+    get fetchRemoteBranch () {
+        return fetchRemoteBranch;
+    }
+});
+const _git = require("./git.js");
+function fetchRemote(remoteOrOptions, cwd) {
+    const { remote, remoteBranch, options, ...gitOptions } = typeof remoteOrOptions === "string" ? {
+        remote: remoteOrOptions,
+        cwd: cwd
+    } : remoteOrOptions;
+    if (remoteBranch && !remote) {
+        throw new Error('Must provide "remote" when using "remoteBranch" option');
+    }
+    const fetchArgs = [
+        "fetch",
+        "--",
+        ...remote ? [
+            remote
+        ] : [],
+        ...remoteBranch ? [
+            remoteBranch
+        ] : [],
+        ...options || []
+    ];
+    (0, _git.git)(fetchArgs, {
+        description: remote ? `Fetching ${remoteBranch ? `branch "${remoteBranch}" from ` : ""}remote "${remote}"` : "Fetching all remotes",
+        throwOnError: true,
+        ...gitOptions
+    });
+}
+function fetchRemoteBranch(remote, remoteBranch, cwd) {
+    fetchRemote({
+        remote,
+        remoteBranch,
+        cwd,
+        throwOnError: true
+    });
+}

package/lib/git/fetchRemote.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/git/fetchRemote.ts"],"sourcesContent":["import { git } from \"./git.js\";\nimport type { GitFetchOptions } from \"./types.js\";\n\n/**\n * Fetch from the given remote (and optionally branch) or all remotes.\n * Throws an error on failure by default.\n */\nexport function fetchRemote(options: GitFetchOptions): void;\n/** @deprecated Use object params version */\nexport function fetchRemote(remote: string, cwd: string): void;\nexport function fetchRemote(remoteOrOptions: string | GitFetchOptions, cwd?: string): void {\n  const { remote, remoteBranch, options, ...gitOptions } =\n    typeof remoteOrOptions === \"string\"\n      ? ({ remote: remoteOrOptions, cwd: cwd! } satisfies GitFetchOptions)\n      : remoteOrOptions;\n\n  if (remoteBranch && !remote) {\n    throw new Error('Must provide \"remote\" when using \"remoteBranch\" option');\n  }\n\n  const fetchArgs = [\n    \"fetch\",\n    \"--\",\n    ...(remote ? [remote] : []),\n    ...(remoteBranch ? [remoteBranch] : []),\n    ...(options || []),\n  ];\n\n  git(fetchArgs, {\n    description: remote\n      ? `Fetching ${remoteBranch ? `branch \"${remoteBranch}\" from ` : \"\"}remote \"${remote}\"`\n      : \"Fetching all remotes\",\n    throwOnError: true,\n    ...gitOptions,\n  });\n}\n\n/**\n * Fetch from the given remote and branch. Throws an error on failure.\n * @deprecated Use `fetchRemote({ remote, remoteBranch, cwd })`\n */\nexport function fetchRemoteBranch(remote: string, remoteBranch: string, cwd: string): void {\n  fetchRemote({ remote, remoteBranch, cwd, throwOnError: true });\n}\n"],"names":["fetchRemote","fetchRemoteBranch","remoteOrOptions","cwd","remote","remoteBranch","options","gitOptions","Error","fetchArgs","git","description","throwOnError"],"mappings":";;;;;;;;;;;;;;;QAUgBA;eAAAA;;QA+BAC;eAAAA;;;qBAzCI;AAUb,SAASD,YAAYE,eAAyC,EAAEC,GAAY;IACjF,MAAM,EAAEC,MAAM,EAAEC,YAAY,EAAEC,OAAO,EAAE,GAAGC,YAAY,GACpD,OAAOL,oBAAoB,WACtB;QAAEE,QAAQF;QAAiBC,KAAKA;IAAK,IACtCD;IAEN,IAAIG,gBAAgB,CAACD,QAAQ;QAC3B,MAAM,IAAII,MAAM;IAClB;IAEA,MAAMC,YAAY;QAChB;QACA;WACIL,SAAS;YAACA;SAAO,GAAG,EAAE;WACtBC,eAAe;YAACA;SAAa,GAAG,EAAE;WAClCC,WAAW,EAAE;KAClB;IAEDI,IAAAA,QAAG,EAACD,WAAW;QACbE,aAAaP,SACT,CAAC,SAAS,EAAEC,eAAe,CAAC,QAAQ,EAAEA,aAAa,OAAO,CAAC,GAAG,GAAG,QAAQ,EAAED,OAAO,CAAC,CAAC,GACpF;QACJQ,cAAc;QACd,GAAGL,UAAU;IACf;AACF;AAMO,SAASN,kBAAkBG,MAAc,EAAEC,YAAoB,EAAEF,GAAW;IACjFH,YAAY;QAAEI;QAAQC;QAAcF;QAAKS,cAAc;IAAK;AAC9D"}

package/lib/git/getChanges.d.ts

@@ -0,0 +1,54 @@
+import type { GetChangesBetweenRefsOptions, GitBranchOptions, GitCommonOptions } from "./types.js";
+/**
+ * Gets file paths with changes between two git references (commits, branches, tags).
+ * Throws an error on failure by default.
+ *
+ * @returns An array of file paths that have changed
+ */
+export declare function getChangesBetweenRefs(options: GetChangesBetweenRefsOptions): string[];
+/** @deprecated Use object param version */
+export declare function getChangesBetweenRefs(fromRef: string, toRef: string, options: string[], pattern: string, cwd: string): string[];
+/**
+ * Gets file paths with changes between the current branch and the given branch.
+ * Throws an error on failure.
+ *
+ * @returns An array of relative file paths that have changed
+ * @deprecated Use `getBranchChanges({ branch, cwd })`
+ */
+export declare function getChanges(branch: string, cwd: string): string[];
+/**
+ * Gets file paths with changes between the branch and the merge-base.
+ * Throws an error on failure by default.
+ *
+ * @returns An array of relative file paths that have changed
+ */
+export declare function getBranchChanges(options: GitBranchOptions): string[];
+/** @deprecated Use object params version */
+export declare function getBranchChanges(branch: string, cwd: string): string[];
+/**
+ * Get a list of files with untracked changes.
+ * Throws an error on failure by default.
+ *
+ * @returns An array of file paths with untracked changes
+ */
+export declare function getUntrackedChanges(options: GitCommonOptions): string[];
+/** @deprecated Use object params version */
+export declare function getUntrackedChanges(cwd: string): string[];
+/**
+ * Gets file paths with changes that have not been staged yet.
+ * Throws an error on failure by default.
+ *
+ * @returns An array of relative file paths with unstaged changes
+ */
+export declare function getUnstagedChanges(options: GitCommonOptions): string[];
+/** @deprecated Use object params version */
+export declare function getUnstagedChanges(cwd: string): string[];
+/**
+ * Gets all files with staged changes (files added to the index).
+ * Throws an error on failure by default.
+ *
+ * @returns An array of relative file paths that have been staged
+ */
+export declare function getStagedChanges(options: GitCommonOptions): string[];
+/** @deprecated Use object params version */
+export declare function getStagedChanges(cwd: string): string[];

package/lib/git/getChanges.js

@@ -0,0 +1,138 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+0 && (module.exports = {
+    getBranchChanges: null,
+    getChanges: null,
+    getChangesBetweenRefs: null,
+    getStagedChanges: null,
+    getUnstagedChanges: null,
+    getUntrackedChanges: null
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: Object.getOwnPropertyDescriptor(all, name).get
+    });
+}
+_export(exports, {
+    get getBranchChanges () {
+        return getBranchChanges;
+    },
+    get getChanges () {
+        return getChanges;
+    },
+    get getChangesBetweenRefs () {
+        return getChangesBetweenRefs;
+    },
+    get getStagedChanges () {
+        return getStagedChanges;
+    },
+    get getUnstagedChanges () {
+        return getUnstagedChanges;
+    },
+    get getUntrackedChanges () {
+        return getUntrackedChanges;
+    }
+});
+const _git = require("./git.js");
+const diffArgs = [
+    "--no-pager",
+    "diff",
+    "--name-only",
+    "--relative"
+];
+function getChangesBetweenRefs(fromRef, toRef, options, pattern, cwd) {
+    let gitOptions;
+    if (typeof fromRef === "string") {
+        gitOptions = {
+            cwd: cwd
+        };
+    } else {
+        ({ fromRef, toRef, options, pattern, ...gitOptions } = fromRef);
+    }
+    const range = `${fromRef}...${toRef || ""}`;
+    const results = (0, _git.git)([
+        ...diffArgs,
+        ...options || [],
+        range,
+        ...pattern ? [
+            "--",
+            pattern
+        ] : []
+    ], {
+        description: `Gathering information about changes between refs (${range})`,
+        throwOnError: true,
+        ...gitOptions
+    });
+    return (0, _git.processGitOutput)(results, {
+        excludeNodeModules: true
+    });
+}
+function getChanges(branch, cwd) {
+    return getChangesBetweenRefs({
+        fromRef: branch,
+        cwd,
+        throwOnError: true
+    });
+}
+function getBranchChanges(branchOrOptions, cwd) {
+    const { branch, ...options } = typeof branchOrOptions === "string" ? {
+        branch: branchOrOptions,
+        cwd: cwd
+    } : branchOrOptions;
+    return getChangesBetweenRefs({
+        fromRef: branch,
+        throwOnError: true,
+        ...options
+    });
+}
+function getUntrackedChanges(cwdOrOptions) {
+    const options = typeof cwdOrOptions === "string" ? {
+        cwd: cwdOrOptions
+    } : cwdOrOptions;
+    const results = (0, _git.git)([
+        "ls-files",
+        "--others",
+        "--exclude-standard"
+    ], {
+        description: "Gathering information about untracked changes",
+        throwOnError: true,
+        ...options
+    });
+    return (0, _git.processGitOutput)(results, {
+        excludeNodeModules: true
+    });
+}
+function getUnstagedChanges(cwdOrOptions) {
+    const options = typeof cwdOrOptions === "string" ? {
+        cwd: cwdOrOptions
+    } : cwdOrOptions;
+    const results = (0, _git.git)([
+        ...diffArgs
+    ], {
+        description: "Gathering information about unstaged changes",
+        throwOnError: true,
+        ...options
+    });
+    return (0, _git.processGitOutput)(results, {
+        excludeNodeModules: true
+    });
+}
+function getStagedChanges(cwdOrOptions) {
+    const options = typeof cwdOrOptions === "string" ? {
+        cwd: cwdOrOptions
+    } : cwdOrOptions;
+    const results = (0, _git.git)([
+        ...diffArgs,
+        "--staged"
+    ], {
+        description: "Gathering information about staged changes",
+        throwOnError: true,
+        ...options
+    });
+    return (0, _git.processGitOutput)(results, {
+        excludeNodeModules: true
+    });
+}

package/lib/git/getChanges.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/git/getChanges.ts"],"sourcesContent":["import { git, processGitOutput } from \"./git.js\";\nimport type { GetChangesBetweenRefsOptions, GitBranchOptions, GitCommonOptions } from \"./types.js\";\n\nconst diffArgs = [\"--no-pager\", \"diff\", \"--name-only\", \"--relative\"] as const;\n\n/**\n * Gets file paths with changes between two git references (commits, branches, tags).\n * Throws an error on failure by default.\n *\n * @returns An array of file paths that have changed\n */\nexport function getChangesBetweenRefs(options: GetChangesBetweenRefsOptions): string[];\n/** @deprecated Use object param version */\nexport function getChangesBetweenRefs(\n  fromRef: string,\n  toRef: string,\n  options: string[],\n  pattern: string,\n  cwd: string\n): string[];\nexport function getChangesBetweenRefs(\n  fromRef: string | GetChangesBetweenRefsOptions,\n  toRef?: string,\n  options?: string[],\n  pattern?: string,\n  cwd?: string\n): string[] {\n  let gitOptions: GitCommonOptions;\n  if (typeof fromRef === \"string\") {\n    gitOptions = { cwd: cwd! };\n  } else {\n    ({ fromRef, toRef, options, pattern, ...gitOptions } = fromRef);\n  }\n\n  const range = `${fromRef}...${toRef || \"\"}`;\n  const results = git([...diffArgs, ...(options || []), range, ...(pattern ? [\"--\", pattern] : [])], {\n    description: `Gathering information about changes between refs (${range})`,\n    throwOnError: true,\n    ...gitOptions,\n  });\n  return processGitOutput(results, { excludeNodeModules: true });\n}\n\n/**\n * Gets file paths with changes between the current branch and the given branch.\n * Throws an error on failure.\n *\n * @returns An array of relative file paths that have changed\n * @deprecated Use `getBranchChanges({ branch, cwd })`\n */\nexport function getChanges(branch: string, cwd: string): string[] {\n  return getChangesBetweenRefs({ fromRef: branch, cwd, throwOnError: true });\n}\n\n/**\n * Gets file paths with changes between the branch and the merge-base.\n * Throws an error on failure by default.\n *\n * @returns An array of relative file paths that have changed\n */\nexport function getBranchChanges(options: GitBranchOptions): string[];\n/** @deprecated Use object params version */\nexport function getBranchChanges(branch: string, cwd: string): string[];\nexport function getBranchChanges(branchOrOptions: string | GitBranchOptions, cwd?: string): string[] {\n  const { branch, ...options } =\n    typeof branchOrOptions === \"string\" ? { branch: branchOrOptions, cwd: cwd! } : branchOrOptions;\n\n  return getChangesBetweenRefs({ fromRef: branch, throwOnError: true, ...options });\n}\n\n/**\n * Get a list of files with untracked changes.\n * Throws an error on failure by default.\n *\n * @returns An array of file paths with untracked changes\n */\nexport function getUntrackedChanges(options: GitCommonOptions): string[];\n/** @deprecated Use object params version */\nexport function getUntrackedChanges(cwd: string): string[];\nexport function getUntrackedChanges(cwdOrOptions: string | GitCommonOptions): string[] {\n  const options: GitCommonOptions = typeof cwdOrOptions === \"string\" ? { cwd: cwdOrOptions } : cwdOrOptions;\n\n  const results = git([\"ls-files\", \"--others\", \"--exclude-standard\"], {\n    description: \"Gathering information about untracked changes\",\n    throwOnError: true,\n    ...options,\n  });\n  return processGitOutput(results, { excludeNodeModules: true });\n}\n\n/**\n * Gets file paths with changes that have not been staged yet.\n * Throws an error on failure by default.\n *\n * @returns An array of relative file paths with unstaged changes\n */\nexport function getUnstagedChanges(options: GitCommonOptions): string[];\n/** @deprecated Use object params version */\nexport function getUnstagedChanges(cwd: string): string[];\nexport function getUnstagedChanges(cwdOrOptions: string | GitCommonOptions): string[] {\n  const options: GitCommonOptions = typeof cwdOrOptions === \"string\" ? { cwd: cwdOrOptions } : cwdOrOptions;\n\n  const results = git([...diffArgs], {\n    description: \"Gathering information about unstaged changes\",\n    throwOnError: true,\n    ...options,\n  });\n  return processGitOutput(results, { excludeNodeModules: true });\n}\n\n/**\n * Gets all files with staged changes (files added to the index).\n * Throws an error on failure by default.\n *\n * @returns An array of relative file paths that have been staged\n */\nexport function getStagedChanges(options: GitCommonOptions): string[];\n/** @deprecated Use object params version */\nexport function getStagedChanges(cwd: string): string[];\nexport function getStagedChanges(cwdOrOptions: string | GitCommonOptions): string[] {\n  const options: GitCommonOptions = typeof cwdOrOptions === \"string\" ? { cwd: cwdOrOptions } : cwdOrOptions;\n\n  const results = git([...diffArgs, \"--staged\"], {\n    description: \"Gathering information about staged changes\",\n    throwOnError: true,\n    ...options,\n  });\n  return processGitOutput(results, { excludeNodeModules: true });\n}\n"],"names":["getBranchChanges","getChanges","getChangesBetweenRefs","getStagedChanges","getUnstagedChanges","getUntrackedChanges","diffArgs","fromRef","toRef","options","pattern","cwd","gitOptions","range","results","git","description","throwOnError","processGitOutput","excludeNodeModules","branch","branchOrOptions","cwdOrOptions"],"mappings":";;;;;;;;;;;;;;;;;;;QA+DgBA;eAAAA;;QAbAC;eAAAA;;QA9BAC;eAAAA;;QAmGAC;eAAAA;;QApBAC;eAAAA;;QApBAC;eAAAA;;;qBA/EsB;AAGtC,MAAMC,WAAW;IAAC;IAAc;IAAQ;IAAe;CAAa;AAiB7D,SAASJ,sBACdK,OAA8C,EAC9CC,KAAc,EACdC,OAAkB,EAClBC,OAAgB,EAChBC,GAAY;IAEZ,IAAIC;IACJ,IAAI,OAAOL,YAAY,UAAU;QAC/BK,aAAa;YAAED,KAAKA;QAAK;IAC3B,OAAO;QACJ,CAAA,EAAEJ,OAAO,EAAEC,KAAK,EAAEC,OAAO,EAAEC,OAAO,EAAE,GAAGE,YAAY,GAAGL,OAAM;IAC/D;IAEA,MAAMM,QAAQ,GAAGN,QAAQ,GAAG,EAAEC,SAAS,IAAI;IAC3C,MAAMM,UAAUC,IAAAA,QAAG,EAAC;WAAIT;WAAcG,WAAW,EAAE;QAAGI;WAAWH,UAAU;YAAC;YAAMA;SAAQ,GAAG,EAAE;KAAE,EAAE;QACjGM,aAAa,CAAC,kDAAkD,EAAEH,MAAM,CAAC,CAAC;QAC1EI,cAAc;QACd,GAAGL,UAAU;IACf;IACA,OAAOM,IAAAA,qBAAgB,EAACJ,SAAS;QAAEK,oBAAoB;IAAK;AAC9D;AASO,SAASlB,WAAWmB,MAAc,EAAET,GAAW;IACpD,OAAOT,sBAAsB;QAAEK,SAASa;QAAQT;QAAKM,cAAc;IAAK;AAC1E;AAWO,SAASjB,iBAAiBqB,eAA0C,EAAEV,GAAY;IACvF,MAAM,EAAES,MAAM,EAAE,GAAGX,SAAS,GAC1B,OAAOY,oBAAoB,WAAW;QAAED,QAAQC;QAAiBV,KAAKA;IAAK,IAAIU;IAEjF,OAAOnB,sBAAsB;QAAEK,SAASa;QAAQH,cAAc;QAAM,GAAGR,OAAO;IAAC;AACjF;AAWO,SAASJ,oBAAoBiB,YAAuC;IACzE,MAAMb,UAA4B,OAAOa,iBAAiB,WAAW;QAAEX,KAAKW;IAAa,IAAIA;IAE7F,MAAMR,UAAUC,IAAAA,QAAG,EAAC;QAAC;QAAY;QAAY;KAAqB,EAAE;QAClEC,aAAa;QACbC,cAAc;QACd,GAAGR,OAAO;IACZ;IACA,OAAOS,IAAAA,qBAAgB,EAACJ,SAAS;QAAEK,oBAAoB;IAAK;AAC9D;AAWO,SAASf,mBAAmBkB,YAAuC;IACxE,MAAMb,UAA4B,OAAOa,iBAAiB,WAAW;QAAEX,KAAKW;IAAa,IAAIA;IAE7F,MAAMR,UAAUC,IAAAA,QAAG,EAAC;WAAIT;KAAS,EAAE;QACjCU,aAAa;QACbC,cAAc;QACd,GAAGR,OAAO;IACZ;IACA,OAAOS,IAAAA,qBAAgB,EAACJ,SAAS;QAAEK,oBAAoB;IAAK;AAC9D;AAWO,SAAShB,iBAAiBmB,YAAuC;IACtE,MAAMb,UAA4B,OAAOa,iBAAiB,WAAW;QAAEX,KAAKW;IAAa,IAAIA;IAE7F,MAAMR,UAAUC,IAAAA,QAAG,EAAC;WAAIT;QAAU;KAAW,EAAE;QAC7CU,aAAa;QACbC,cAAc;QACd,GAAGR,OAAO;IACZ;IACA,OAAOS,IAAAA,qBAAgB,EAACJ,SAAS;QAAEK,oBAAoB;IAAK;AAC9D"}

package/lib/git/getCurrentHash.d.ts

@@ -0,0 +1,8 @@
+import type { GitCommonOptions } from "./types.js";
+/**
+ * Gets the current commit hash (SHA).
+ * @returns The hash if successful, null otherwise
+ */
+export declare function getCurrentHash(options: GitCommonOptions): string | null;
+/** @deprecated Use object params version */
+export declare function getCurrentHash(cwd: string): string | null;

package/lib/git/getCurrentHash.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "getCurrentHash", {
+    enumerable: true,
+    get: function() {
+        return getCurrentHash;
+    }
+});
+const _git = require("./git.js");
+function getCurrentHash(cwdOrOptions) {
+    const options = typeof cwdOrOptions === "string" ? {
+        cwd: cwdOrOptions
+    } : cwdOrOptions;
+    const results = (0, _git.git)([
+        "rev-parse",
+        "HEAD"
+    ], {
+        description: "Getting current git hash",
+        ...options
+    });
+    return results.success ? results.stdout : null;
+}

package/lib/git/getCurrentHash.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/git/getCurrentHash.ts"],"sourcesContent":["import { git } from \"./git.js\";\nimport type { GitCommonOptions } from \"./types.js\";\n\n/**\n * Gets the current commit hash (SHA).\n * @returns The hash if successful, null otherwise\n */\nexport function getCurrentHash(options: GitCommonOptions): string | null;\n/** @deprecated Use object params version */\nexport function getCurrentHash(cwd: string): string | null;\nexport function getCurrentHash(cwdOrOptions: string | GitCommonOptions): string | null {\n  const options: GitCommonOptions = typeof cwdOrOptions === \"string\" ? { cwd: cwdOrOptions } : cwdOrOptions;\n\n  const results = git([\"rev-parse\", \"HEAD\"], {\n    description: \"Getting current git hash\",\n    ...options,\n  });\n\n  return results.success ? results.stdout : null;\n}\n"],"names":["getCurrentHash","cwdOrOptions","options","cwd","results","git","description","success","stdout"],"mappings":";;;;+BAUgBA;;;eAAAA;;;qBAVI;AAUb,SAASA,eAAeC,YAAuC;IACpE,MAAMC,UAA4B,OAAOD,iBAAiB,WAAW;QAAEE,KAAKF;IAAa,IAAIA;IAE7F,MAAMG,UAAUC,IAAAA,QAAG,EAAC;QAAC;QAAa;KAAO,EAAE;QACzCC,aAAa;QACb,GAAGJ,OAAO;IACZ;IAEA,OAAOE,QAAQG,OAAO,GAAGH,QAAQI,MAAM,GAAG;AAC5C"}

package/lib/git/getDefaultRemote.d.ts

@@ -2,16 +2,21 @@ export type GetDefaultRemoteOptions = {
     /** Get repository info relative to this directory. */
     cwd: string;
     /**
-     * If true, throw an error if remote info can't be found, or if a `repository` is not specified
-     * in package.json and no matching remote is found.
+     * If true, throw an error if remote info can't be found, if no `package.json` is found, or if
+     * a `repository` is specified in package.json but no matching remote exists.
      */
     strict?: boolean;
     /** If true, log debug messages about how the remote was chosen */
     verbose?: boolean;
+    /** Optional pre-fetched mapping from remote name to remote URL */
+    remotes?: Record<string, string>;
 };
 /**
  * Get the name of the default remote: the one matching the `repository` field in package.json.
- * Throws if `options.cwd` is not in a git repo or there's no package.json at the repo root.
+ * Throws if `options.cwd` is not in a git repo.
+ *
+ * It's recommended to set `strict: true` to also throw if no remotes are defined, no package.json
+ * is found, or package.json has a `repository` field but no matching remote exists.
  *
  * The order of preference for returned remotes is:
  * 1. If `repository` is defined in package.json, the remote with a matching URL (if `options.strict`
@@ -26,3 +31,9 @@ export type GetDefaultRemoteOptions = {
 export declare function getDefaultRemote(options: GetDefaultRemoteOptions): string;
 /** @deprecated Use the object param version */
 export declare function getDefaultRemote(cwd: string): string;
+/** Match repository URL from package.json to a git remote. Exported for testing. */
+export declare function _matchRepositoryUrlToRemote(
+/** repository.url from package.json */
+repositoryUrl: string, 
+/** Mapping from remote name to remote URL */
+remotes: Record<string, string>, logOrThrow?: (message: string) => void): string | undefined;