workspace-tools 0.40.4 → 0.41.1

package/lib/git/git.js.map

@@ -1 +1 @@
-{"version":3,"file":"git.js","sourceRoot":"","sources":["../../src/git/git.ts"],"names":[],"mappings":"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"}
+{"version":3,"sources":["../../src/git/git.ts"],"sourcesContent":["//\n// Basic git wrappers\n//\n\nimport { spawnSync, type SpawnSyncOptions, type SpawnSyncReturns } from \"child_process\";\nimport { type GitCommonOptions } from \"./types.js\";\n\nexport type GitOptions = Omit<SpawnSyncOptions, \"cwd\"> &\n  GitCommonOptions & {\n    /** Operation description to be used in error message (formatted as start of sentence) */\n    description?: string;\n    debug?: boolean;\n  };\n\nexport class GitError extends Error {\n  public readonly originalError: unknown;\n  public readonly gitOutput?: GitProcessOutput;\n\n  constructor(message: string, originalError?: unknown, gitOutput?: GitProcessOutput) {\n    if (originalError instanceof Error) {\n      super(`${message}: ${originalError.message}`);\n    } else if (gitOutput?.stderr) {\n      super(`${message} -- stderr:\\n${gitOutput.stderr}`);\n    } else {\n      super(message);\n    }\n    this.originalError = originalError;\n    this.gitOutput = gitOutput;\n  }\n}\n\n/**\n * A global maxBuffer override for all git operations.\n * Bumps up the default to 500MB instead of 1MB.\n * Override this value with the `GIT_MAX_BUFFER` environment variable.\n */\nconst defaultMaxBuffer = process.env.GIT_MAX_BUFFER ? parseInt(process.env.GIT_MAX_BUFFER) : 500 * 1024 * 1024;\n\nconst isDebug = !!process.env.GIT_DEBUG;\n\nexport type GitProcessOutput = {\n  stderr: string;\n  stdout: string;\n  success: boolean;\n} & Omit<SpawnSyncReturns<string | Buffer>, \"stdout\" | \"stderr\">;\n\n/** Observes the git operations called from `git()` or `gitFailFast()` */\nexport type GitObserver = (args: string[], output: GitProcessOutput) => void;\nconst observers: GitObserver[] = [];\nlet observing: boolean;\n\n/**\n * Adds an observer for the git operations, e.g. for testing\n * @returns a function to remove the observer\n */\nexport function addGitObserver(observer: GitObserver): () => void {\n  observers.push(observer);\n  return () => removeGitObserver(observer);\n}\n\n/** Clear all git observers */\nexport function clearGitObservers(): void {\n  observers.splice(0, observers.length);\n}\n\n/** Remove a git observer */\nfunction removeGitObserver(observer: GitObserver): void {\n  const index = observers.indexOf(observer);\n  if (index > -1) {\n    observers.splice(index, 1);\n  }\n}\n\n/**\n * Runs git command - use this for read-only commands, or if you'd like to explicitly check the\n * result and implement custom error handling.\n *\n * The caller is responsible for validating the input.\n * `shell` will always be set to false.\n */\nexport function git(args: string[], options?: GitOptions): GitProcessOutput {\n  if (args.some((arg) => arg.startsWith(\"--upload-pack\"))) {\n    // This is a security issue and not needed for any expected usage of this library.\n    throw new GitError(\"git command contains --upload-pack, which is not allowed: \" + args.join(\" \"));\n  }\n\n  const gitDescription = `git ${args.join(\" \")}`;\n  const { throwOnError, description = gitDescription, debug = isDebug, ...spawnOptions } = options || {};\n\n  debug && console.log(gitDescription);\n\n  let results: SpawnSyncReturns<string | Buffer>;\n  try {\n    // this only throws if git isn't found or other rare cases\n    results = spawnSync(\"git\", args, { maxBuffer: defaultMaxBuffer, ...spawnOptions });\n  } catch (e) {\n    throw new GitError(`${description} failed (while spawning process)`, e);\n  }\n\n  const output: GitProcessOutput = {\n    ...results,\n    // these may be undefined if stdio: inherit is set\n    stderr: (results.stderr || \"\").toString().trimEnd(),\n    stdout: (results.stdout || \"\").toString().trimEnd(),\n    success: results.status === 0,\n  };\n\n  if (debug) {\n    console.log(\"exited with code \" + results.status);\n    output.stdout && console.log(\"git stdout:\\n\", output.stdout);\n    output.stderr && console.warn(\"git stderr:\\n\", output.stderr);\n  }\n\n  // notify observers, flipping the observing bit to prevent infinite loops\n  if (!observing) {\n    observing = true;\n    for (const observer of observers) {\n      observer(args, output);\n    }\n    observing = false;\n  }\n\n  if (!output.success && throwOnError) {\n    throw new GitError(`${description} failed${output.stderr ? `\\n${output.stderr}` : \"\"}`, undefined, output);\n  }\n\n  return output;\n}\n\n/**\n * Run a git command. Use this for commands that make critical changes to the filesystem.\n * If it fails, throw an error and set `process.exitCode = 1` (unless `options.noExitCode` is set).\n *\n * The caller is responsible for validating the input.\n * `shell` will always be set to false.\n */\nexport function gitFailFast(args: string[], options?: GitCommonOptions & { noExitCode?: boolean }): void {\n  const gitResult = git(args, options);\n  if (!gitResult.success) {\n    if (!options?.noExitCode) {\n      process.exitCode = 1;\n    }\n\n    throw new GitError(`CRITICAL ERROR: running git command: git ${args.join(\" \")}!\n    ${gitResult.stdout?.toString().trimEnd()}\n    ${gitResult.stderr?.toString().trimEnd()}`);\n  }\n}\n\n/**\n * Processes git command output by splitting it into lines and filtering out empty lines.\n * Also filters out `node_modules` lines if specified in options.\n *\n * If the command failed with stderr output, an error is thrown.\n *\n * @param output - The git command output to process\n * @returns An array of lines (presumably file paths), or an empty array if the command failed\n * without stderr output.\n * @internal\n */\nexport function processGitOutput(output: GitProcessOutput, options?: { excludeNodeModules?: boolean }): string[] {\n  if (!output.success) {\n    // If the intent was to throw on failure, `throwOnError` should have been set for the git command.\n    return [];\n  }\n\n  return output.stdout\n    .split(/\\n/)\n    .map((line) => line.trim())\n    .filter((line) => !!line && (!options?.excludeNodeModules || !line.includes(\"node_modules\")));\n}\n"],"names":["GitError","addGitObserver","clearGitObservers","git","gitFailFast","processGitOutput","Error","message","originalError","gitOutput","stderr","defaultMaxBuffer","process","env","GIT_MAX_BUFFER","parseInt","isDebug","GIT_DEBUG","observers","observing","observer","push","removeGitObserver","splice","length","index","indexOf","args","options","some","arg","startsWith","join","gitDescription","throwOnError","description","debug","spawnOptions","console","log","results","spawnSync","maxBuffer","e","output","toString","trimEnd","stdout","success","status","warn","undefined","gitResult","noExitCode","exitCode","split","map","line","trim","filter","excludeNodeModules","includes"],"mappings":"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"}

package/lib/git/gitUtilities.d.ts

@@ -1,4 +1,4 @@
-import type { GetChangesBetweenRefsOptions, GitBranchOptions, GitCommitOptions, GitCommonOptions, GitFetchOptions, GitInitOptions, GitStageOptions, ParsedRemoteBranch, ParseRemoteBranchOptions } from "./types";
+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.
@@ -86,9 +86,9 @@ export declare function getUserEmail(cwd: string): string | null;
  *
  * @returns The branch name if successful, null otherwise
  */
-export declare function getBranchName(options: GitCommonOptions): string;
+export declare function getBranchName(options: GitCommonOptions): string | null;
 /** @deprecated Use object params version */
-export declare function getBranchName(cwd: string): string;
+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`.