workspace-tools 0.41.5 → 0.41.7

package/lib/git/getRemotes.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/git/getRemotes.ts"],"sourcesContent":["import { git, GitError, type GitProcessOutput } from \"./git.js\";\nimport type { GitCommonOptions } from \"./types.js\";\n\n/**\n * Get a mapping from remote names to fetch URLs.\n *\n * Note this returns the URLs directly from `git config --local --get-regexp 'remote\\..*\\.url'`,\n * which doesn't respect any `url.<base>.insteadOf` remappings (such as for ssh). This should be\n * fine for current usage: `parseRemoteBranch` only needs the names, and `getDefaultRemote`\n * compares parsed URLs from `package.json` `repository` and should be flexible about formats.\n *\n * If `options.throwOnError` is true, throws if no remotes are found or `cwd` isn't in a git repo.\n *\n * @returns An object mapping remote names to URLs.\n */\nexport function getRemotes(options: GitCommonOptions): Record<string, string> {\n  let remotesResult: GitProcessOutput;\n  try {\n    // Get remote names and URLs, similar to `git remote -v` but without localization concerns.\n    // --local ensures it errors if cwd is not in a git repo.\n    remotesResult = git([\"config\", \"--local\", \"--get-regexp\", \"remote\\\\..*\\\\.url\"], {\n      ...options,\n      description: \"Getting git remotes\",\n    });\n  } catch (e) {\n    if (e instanceof GitError) {\n      if (e.gitOutput?.status === 1) {\n        // Per git config docs, 1 means the key wasn't found, so fail with a clearer message\n        // (this case will only be hit with throwOnError: true)\n        throw new GitError(`No remotes defined in git repo at ${options.cwd}`, undefined, e.gitOutput);\n      }\n      if (e.gitOutput?.status === 128) {\n        // 128 most commonly means not a git repository\n        throw new GitError(`${options.cwd} is not in a git repository`, undefined, e.gitOutput);\n      }\n    }\n    throw e;\n  }\n\n  if (!remotesResult.success) {\n    // throwOnError was false/unset but no remotes were found\n    return {};\n  }\n\n  const remotes: Record<string, string> = {};\n  const remoteLines = remotesResult.stdout.trim().split(\"\\n\");\n  for (const line of remoteLines) {\n    const remoteMatch = line.match(/^remote\\.(.+?)\\.url\\s+(.*)$/);\n    if (!remoteMatch) continue;\n    const [, remoteName, remoteUrl] = remoteMatch;\n    remotes[remoteName] = remoteUrl;\n  }\n\n  return remotes;\n}\n"],"names":["getRemotes","options","remotesResult","git","description","e","GitError","gitOutput","status","cwd","undefined","success","remotes","remoteLines","stdout","trim","split","line","remoteMatch","match","remoteName","remoteUrl"],"mappings":";;;;+BAegBA;;;eAAAA;;;qBAfqC;AAe9C,SAASA,WAAWC,OAAyB;IAClD,IAAIC;IACJ,IAAI;QACF,2FAA2F;QAC3F,yDAAyD;QACzDA,gBAAgBC,IAAAA,QAAG,EAAC;YAAC;YAAU;YAAW;YAAgB;SAAoB,EAAE;YAC9E,GAAGF,OAAO;YACVG,aAAa;QACf;IACF,EAAE,OAAOC,GAAG;QACV,IAAIA,aAAaC,aAAQ,EAAE;YACzB,IAAID,EAAEE,SAAS,EAAEC,WAAW,GAAG;gBAC7B,oFAAoF;gBACpF,uDAAuD;gBACvD,MAAM,IAAIF,aAAQ,CAAC,CAAC,kCAAkC,EAAEL,QAAQQ,GAAG,EAAE,EAAEC,WAAWL,EAAEE,SAAS;YAC/F;YACA,IAAIF,EAAEE,SAAS,EAAEC,WAAW,KAAK;gBAC/B,+CAA+C;gBAC/C,MAAM,IAAIF,aAAQ,CAAC,GAAGL,QAAQQ,GAAG,CAAC,2BAA2B,CAAC,EAAEC,WAAWL,EAAEE,SAAS;YACxF;QACF;QACA,MAAMF;IACR;IAEA,IAAI,CAACH,cAAcS,OAAO,EAAE;QAC1B,yDAAyD;QACzD,OAAO,CAAC;IACV;IAEA,MAAMC,UAAkC,CAAC;IACzC,MAAMC,cAAcX,cAAcY,MAAM,CAACC,IAAI,GAAGC,KAAK,CAAC;IACtD,KAAK,MAAMC,QAAQJ,YAAa;QAC9B,MAAMK,cAAcD,KAAKE,KAAK,CAAC;QAC/B,IAAI,CAACD,aAAa;QAClB,MAAM,GAAGE,YAAYC,UAAU,GAAGH;QAClCN,OAAO,CAACQ,WAAW,GAAGC;IACxB;IAEA,OAAOT;AACT"}

package/lib/git/gitUtilities.d.ts

@@ -1,218 +1,18 @@
-import type { GetChangesBetweenRefsOptions, GitBranchOptions, GitCommitOptions, GitCommonOptions, GitFetchOptions, GitInitOptions, GitStageOptions, ParsedRemoteBranch, ParseRemoteBranchOptions } from "./types.js";
-/**
- * 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[];
-/**
- * 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;
-/**
- * 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 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[];
-/**
- * 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 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[];
-/**
- * Gets recent commit messages between the specified parent branch and HEAD.
- * By default, returns an empty array if the operation fails.
- *
- * @returns An array of commit message strings
- */
-export declare function getRecentCommitMessages(options: GitBranchOptions): string[];
-/** @deprecated Use object params version */
-export declare function getRecentCommitMessages(branch: string, cwd: string): string[];
-/**
- * Gets the user email from the git config.
- * @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 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 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;
-/**
- * Get the commit hash in which the file was first added.
- * @returns The commit hash if found, undefined otherwise
- */
-export declare function getFileAddedHash(options: {
-    filename: string;
-} & GitCommonOptions): string | undefined;
-/** @deprecated Use object params version */
-export declare function getFileAddedHash(filename: string, cwd: string): string | undefined;
-/**
- * Run `git init` and verify that the `user.name` and `user.email` configs are set (at any level).
- * Throws an error if `git init` fails.
- *
- * If `user.email` and `user.name` aren't already set globally, and the missing value is provided
- * in params, set it at the repo level. Otherwise, throw an error.
- */
-export declare function init(options: GitInitOptions): void;
-/** @deprecated Use object params version */
-export declare function init(cwd: string, email?: string, username?: string): void;
-/**
- * Stages files matching the given patterns.
- */
-export declare function stage(options: GitStageOptions): void;
-/** @deprecated Use object params version */
-export declare function stage(patterns: string[], cwd: string): void;
-/**
- * Commit changes. Throws an error on failure by default.
- */
-export declare function commit(options: GitCommitOptions): void;
-/** @deprecated Use object params version */
-export declare function commit(message: string, cwd: string, options?: string[]): void;
-/**
- * Stages files matching the given patterns and creates a commit with the specified message.
- * Convenience function that combines `stage()` and `commit()`.
- * Throws an error on commit failure by default.
- */
-export declare function stageAndCommit(options: GitStageOptions & GitCommitOptions): void;
-/** @deprecated Use object params version */
-export declare function stageAndCommit(patterns: string[], message: string, cwd: string, commitOptions?: string[]): void;
-/**
- * Reverts all local changes (both staged and unstaged) by stashing them and then dropping the stash.
- * @returns True if the revert was successful, false otherwise. It will also be false if there were
- * no changes to revert. (To distinguish between this case and errors, use the `throwOnError` option.)
- */
-export declare function revertLocalChanges(options: GitCommonOptions): boolean;
-/** @deprecated Use object params version */
-export declare function revertLocalChanges(cwd: string): boolean;
+export { getBranchName, getFullBranchRef, getRemoteBranch, getShortBranchName } from "./branchRefs.js";
+export { getDefaultBranch, getUserEmail } from "./config.js";
+export { fetchRemote, fetchRemoteBranch } from "./fetchRemote.js";
+export { getBranchChanges, getChanges, getChangesBetweenRefs, getStagedChanges, getUnstagedChanges, getUntrackedChanges, } from "./getChanges.js";
+export { getCurrentHash } from "./getCurrentHash.js";
+export { getFileAddedHash } from "./getFileAddedHash.js";
+export { getRecentCommitMessages } from "./getRecentCommitMessages.js";
+export { init } from "./init.js";
+export { listAllTrackedFiles } from "./listAllTrackedFiles.js";
+export { parseRemoteBranch } from "./parseRemoteBranch.js";
+export { revertLocalChanges } from "./revertLocalChanges.js";
+export { commit, stage, stageAndCommit } from "./stageAndCommit.js";
 /**
  * Attempts to determine the parent branch of the current branch using `git show-branch`.
  * @returns The parent branch name if found, null otherwise
  * @deprecated Does not appear to be used
  */
 export declare function getParentBranch(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;
-/**
- * Get the remote and branch name from a full branch name that may include a remote prefix.
- * If the path doesn't start with one of `options.knownRemotes` (but has multiple segments),
- * the actual list of remotes will be fetched to see if one of those matches.
- *
- * NOTE: The additional verification is new in the object params version; the original version
- * incorrectly assumes the first segment before a slash is always a remote.
- */
-export declare function parseRemoteBranch(options: ParseRemoteBranchOptions): ParsedRemoteBranch;
-/**
- * @deprecated Use object params version, which does more verification. This version inaccurately
- * assumes the first segment before a slash is always a remote, which could lead to tricky bugs.
- */
-export declare function parseRemoteBranch(branch: string): ParsedRemoteBranch;
-/**
- * Gets the default branch based on `git config init.defaultBranch`, falling back to `master`.
- */
-export declare function getDefaultBranch(options: GitCommonOptions): string;
-/** @deprecated Use object params version */
-export declare function getDefaultBranch(cwd: string): string;
-/**
- * Lists all tracked files matching the given patterns.
- * Throws on error by default.
- * @returns An array of file paths, or an empty array if no files are found
- */
-export declare function listAllTrackedFiles(options: {
-    /** File patterns to match (passed to git ls-files) */
-    patterns: string[];
-} & GitCommonOptions): string[];
-/** @deprecated Use object params version */
-export declare function listAllTrackedFiles(patterns: string[], cwd: string): string[];
-/**
- * Get the content of a file at a specific git ref (commit, branch, tag, etc).
- * Returns undefined if the file doesn't exist at that ref or the command fails.
- */
-export declare function getFileFromVersion(params: {
-    /** Repo-relative path to the file with *forward* slashes */
-    filePath: string;
-    /** git ref (branch, tag, commit SHA, etc) to get the file content from */
-    ref: string;
-} & GitCommonOptions): string | undefined;