git-chopstick-core 0.1.0 → 0.1.2

package/dist/git/environment.d.ts

@@ -0,0 +1,51 @@
+import { Repository } from '../models/repository.js';
+import { IRemote } from '../models/remote.js';
+/**
+ * For many remote operations it's well known what the primary remote
+ * url is (clone, push, fetch etc). But in some cases it's not as easy.
+ *
+ * Two examples are checkout, and revert where neither would need to
+ * hit the network in vanilla Git usage but do need to when LFS gets
+ * involved.
+ *
+ * What's the primary url when using LFS then? Most likely it's gonna
+ * be on the same as the default remote but it could theoretically
+ * be on a different server as well. That's too advanced for our usage
+ * at the moment though so we'll just need to figure out some reasonable
+ * url to fall back on.
+ *
+ * @param branchName If the operation we're about to undertake is related to a
+ *                   local ref (i.e branch) then we can use that to resolve its
+ *                   upstream tracking branch (and thereby its remote) and use
+ *                   that as the probable url to resolve a proxy for.
+ */
+export declare function getFallbackUrlForProxyResolve(_repository: Repository, currentRemote: IRemote | null): string;
+/**
+ * Create a set of environment variables to use when invoking a Git
+ * subcommand that needs to communicate with a remote (i.e. fetch, clone,
+ * push, pull, ls-remote, etc etc).
+ *
+ * The environment variables deal with setting up sane defaults, configuring
+ * authentication, and resolving proxy urls if necessary.
+ *
+ * @param account   The authentication information (if available) to provide
+ *                  to Git for use when connecting to the remote
+ * @param remoteUrl The primary remote URL for this operation. Note that Git
+ *                  might connect to other remotes in order to fulfill the
+ *                  operation. As an example, a clone of
+ *                  https://github.com/desktop/desktop could contain a submodule
+ *                  pointing to another host entirely. Used to resolve which
+ *                  proxy (if any) should be used for the operation.
+ */
+export declare function envForRemoteOperation(remoteUrl: string | null): Promise<Record<string, string | undefined>>;
+/**
+ * Not intended to be used directly. Exported only in order to
+ * allow for testing.
+ *
+ * @param remoteUrl The remote url to resolve a proxy for.
+ * @param env       The current environment variables, defaults
+ *                  to `process.env`
+ * @param resolve   The method to use when resolving the proxy url,
+ *                  defaults to `resolveGitProxy`
+ */
+export declare function envForProxy(remoteUrl: string, env?: NodeJS.ProcessEnv, resolve?: (url: string) => Promise<string | undefined>): Promise<Record<string, string | undefined> | undefined>;

package/dist/git/environment.js

@@ -0,0 +1,97 @@
+import { envForAuthentication } from './authentication.js';
+import { resolveGitProxy as resolveGitProxyFn } from '../lib/resolve-git-proxy.js';
+/**
+ * For many remote operations it's well known what the primary remote
+ * url is (clone, push, fetch etc). But in some cases it's not as easy.
+ *
+ * Two examples are checkout, and revert where neither would need to
+ * hit the network in vanilla Git usage but do need to when LFS gets
+ * involved.
+ *
+ * What's the primary url when using LFS then? Most likely it's gonna
+ * be on the same as the default remote but it could theoretically
+ * be on a different server as well. That's too advanced for our usage
+ * at the moment though so we'll just need to figure out some reasonable
+ * url to fall back on.
+ *
+ * @param branchName If the operation we're about to undertake is related to a
+ *                   local ref (i.e branch) then we can use that to resolve its
+ *                   upstream tracking branch (and thereby its remote) and use
+ *                   that as the probable url to resolve a proxy for.
+ */
+export function getFallbackUrlForProxyResolve(_repository, currentRemote) {
+    if (currentRemote) {
+        return currentRemote.url;
+    }
+    return 'https://github.com';
+}
+/**
+ * Create a set of environment variables to use when invoking a Git
+ * subcommand that needs to communicate with a remote (i.e. fetch, clone,
+ * push, pull, ls-remote, etc etc).
+ *
+ * The environment variables deal with setting up sane defaults, configuring
+ * authentication, and resolving proxy urls if necessary.
+ *
+ * @param account   The authentication information (if available) to provide
+ *                  to Git for use when connecting to the remote
+ * @param remoteUrl The primary remote URL for this operation. Note that Git
+ *                  might connect to other remotes in order to fulfill the
+ *                  operation. As an example, a clone of
+ *                  https://github.com/desktop/desktop could contain a submodule
+ *                  pointing to another host entirely. Used to resolve which
+ *                  proxy (if any) should be used for the operation.
+ */
+export async function envForRemoteOperation(remoteUrl) {
+    return {
+        ...envForAuthentication(),
+        ...(await envForProxy(remoteUrl ?? 'https://github.com')),
+    };
+}
+/**
+ * Not intended to be used directly. Exported only in order to
+ * allow for testing.
+ *
+ * @param remoteUrl The remote url to resolve a proxy for.
+ * @param env       The current environment variables, defaults
+ *                  to `process.env`
+ * @param resolve   The method to use when resolving the proxy url,
+ *                  defaults to `resolveGitProxy`
+ */
+export async function envForProxy(remoteUrl, env = process.env, resolve = async (url) => resolveGitProxyFn() ?? undefined) {
+    const protocolMatch = /^(https?):\/\//i.exec(remoteUrl);
+    // We can only resolve and use a proxy for the protocols where cURL
+    // would be involved (i.e http and https). git:// relies on ssh.
+    if (protocolMatch === null) {
+        return;
+    }
+    // Note that HTTPS here doesn't mean that the proxy is HTTPS, only
+    // that all requests to HTTPS protocols should be proxied. The
+    // proxy protocol is defined by the url returned by `this.resolve()`
+    const proto = protocolMatch[1].toLowerCase(); // http or https
+    // We'll play it safe and say that if the user has configured
+    // the ALL_PROXY environment variable they probably know what
+    // they're doing and wouldn't want us to override it with a
+    // protocol-specific proxy. cURL supports both lower and upper
+    // case, see:
+    // https://github.com/curl/curl/blob/14916a82e/lib/url.c#L2180-L2185
+    if ('ALL_PROXY' in env || 'all_proxy' in env) {
+        console.info(`proxy url not resolved, ALL_PROXY already set`);
+        return;
+    }
+    // Lower case environment variables due to
+    // https://ec.haxx.se/usingcurl/usingcurl-proxies#http_proxy-in-lower-case-only
+    const envKey = `${proto}_proxy`; // http_proxy or https_proxy
+    // If the user has already configured a proxy in the environment
+    // for the protocol we're not gonna override it.
+    if (envKey in env || (proto === 'https' && 'HTTPS_PROXY' in env)) {
+        console.info(`proxy url not resolved, ${envKey} already set`);
+        return;
+    }
+    const proxyUrl = await resolve(remoteUrl).catch(err => {
+        console.error('Failed resolving Git proxy', err);
+        return undefined;
+    });
+    return proxyUrl === undefined ? undefined : { [envKey]: proxyUrl };
+}
+//# sourceMappingURL=environment.js.map

package/dist/git/environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.js","sourceRoot":"","sources":["../../src/git/environment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAC1D,OAAO,EAAE,eAAe,IAAI,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAKlF;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,6BAA6B,CAC3C,WAAuB,EACvB,aAA6B;IAE7B,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,aAAa,CAAC,GAAG,CAAA;IAC1B,CAAC;IACD,OAAO,oBAAoB,CAAA;AAC7B,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,SAAwB;IAClE,OAAO;QACL,GAAG,oBAAoB,EAAE;QACzB,GAAG,CAAC,MAAM,WAAW,CAAC,SAAS,IAAI,oBAAoB,CAAC,CAAC;KAC1D,CAAA;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,SAAiB,EACjB,MAAyB,OAAO,CAAC,GAAG,EACpC,UAAwD,KAAK,EAAE,GAAW,EAAE,EAAE,CAAC,iBAAiB,EAAE,IAAI,SAAS;IAE/G,MAAM,aAAa,GAAG,iBAAiB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IAEvD,mEAAmE;IACnE,gEAAgE;IAChE,IAAI,aAAa,KAAK,IAAI,EAAE,CAAC;QAC3B,OAAM;IACR,CAAC;IAED,kEAAkE;IAClE,8DAA8D;IAC9D,oEAAoE;IACpE,MAAM,KAAK,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAA,CAAC,gBAAgB;IAE7D,6DAA6D;IAC7D,6DAA6D;IAC7D,2DAA2D;IAC3D,8DAA8D;IAC9D,aAAa;IACb,oEAAoE;IACpE,IAAI,WAAW,IAAI,GAAG,IAAI,WAAW,IAAI,GAAG,EAAE,CAAC;QAC7C,OAAO,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAA;QAC7D,OAAM;IACR,CAAC;IAED,0CAA0C;IAC1C,+EAA+E;IAC/E,MAAM,MAAM,GAAG,GAAG,KAAK,QAAQ,CAAA,CAAC,4BAA4B;IAE5D,gEAAgE;IAChE,gDAAgD;IAChD,IAAI,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,KAAK,OAAO,IAAI,aAAa,IAAI,GAAG,CAAC,EAAE,CAAC;QACjE,OAAO,CAAC,IAAI,CAAC,2BAA2B,MAAM,cAAc,CAAC,CAAA;QAC7D,OAAM;IACR,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE;QACpD,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,GAAG,CAAC,CAAA;QAChD,OAAO,SAAS,CAAA;IAClB,CAAC,CAAC,CAAA;IAEF,OAAO,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAA;AACpE,CAAC"}

package/dist/git/exec.d.ts

@@ -0,0 +1,109 @@
+import { SpawnOptions } from 'child_process';
+/**
+ * Git error types parsed from stderr output.
+ * This is a simplified version of dugite's GitError enum.
+ */
+export declare enum GitError {
+    SSHAuthenticationFailed = "SSHAuthenticationFailed",
+    SSHPermissionDenied = "SSHPermissionDenied",
+    HTTPSAuthenticationFailed = "HTTPSAuthenticationFailed",
+    SSHKeyAuditUnverified = "SSHKeyAuditUnverified",
+    RemoteDisconnection = "RemoteDisconnection",
+    HostDown = "HostDown",
+    HTTPSRepositoryNotFound = "HTTPSRepositoryNotFound",
+    SSHRepositoryNotFound = "SSHRepositoryNotFound",
+    PushNotFastForward = "PushNotFastForward",
+    PushWithFileSizeExceedingLimit = "PushWithFileSizeExceedingLimit",
+    PushWithPrivateEmail = "PushWithPrivateEmail",
+    PushWithSecretDetected = "PushWithSecretDetected",
+    ForcePushRejected = "ForcePushRejected",
+    ProtectedBranchForcePush = "ProtectedBranchForcePush",
+    ProtectedBranchRequiresReview = "ProtectedBranchRequiresReview",
+    ProtectedBranchDeleteRejected = "ProtectedBranchDeleteRejected",
+    ProtectedBranchRequiredStatus = "ProtectedBranchRequiredStatus",
+    BranchDeletionFailed = "BranchDeletionFailed",
+    DefaultBranchDeletionFailed = "DefaultBranchDeletionFailed",
+    BranchAlreadyExists = "BranchAlreadyExists",
+    BranchRenameFailed = "BranchRenameFailed",
+    HexBranchNameRejected = "HexBranchNameRejected",
+    InvalidRefLength = "InvalidRefLength",
+    MergeConflicts = "MergeConflicts",
+    RebaseConflicts = "RebaseConflicts",
+    MergeWithLocalChanges = "MergeWithLocalChanges",
+    RebaseWithLocalChanges = "RebaseWithLocalChanges",
+    InvalidMerge = "InvalidMerge",
+    InvalidRebase = "InvalidRebase",
+    NonFastForwardMergeIntoEmptyHead = "NonFastForwardMergeIntoEmptyHead",
+    CannotMergeUnrelatedHistories = "CannotMergeUnrelatedHistories",
+    NoMergeToAbort = "NoMergeToAbort",
+    RevertConflicts = "RevertConflicts",
+    EmptyRebasePatch = "EmptyRebasePatch",
+    NothingToCommit = "NothingToCommit",
+    GPGFailedToSignData = "GPGFailedToSignData",
+    BadConfigValue = "BadConfigValue",
+    ConfigLockFileAlreadyExists = "ConfigLockFileAlreadyExists",
+    NotAGitRepository = "NotAGitRepository",
+    BadRevision = "BadRevision",
+    LocalPermissionDenied = "LocalPermissionDenied",
+    NoMatchingRemoteBranch = "NoMatchingRemoteBranch",
+    NoExistingRemoteBranch = "NoExistingRemoteBranch",
+    PatchDoesNotApply = "PatchDoesNotApply",
+    NoSubmoduleMapping = "NoSubmoduleMapping",
+    SubmoduleRepositoryDoesNotExist = "SubmoduleRepositoryDoesNotExist",
+    InvalidSubmoduleSHA = "InvalidSubmoduleSHA",
+    LockFileAlreadyExists = "LockFileAlreadyExists",
+    UnresolvedConflicts = "UnresolvedConflicts",
+    LocalChangesOverwritten = "LocalChangesOverwritten",
+    RemoteAlreadyExists = "RemoteAlreadyExists",
+    TagAlreadyExists = "TagAlreadyExists",
+    PathDoesNotExist = "PathDoesNotExist",
+    InvalidObjectName = "InvalidObjectName",
+    OutsideRepository = "OutsideRepository",
+    ConflictModifyDeletedInBranch = "ConflictModifyDeletedInBranch",
+    MergeCommitNoMainlineOption = "MergeCommitNoMainlineOption",
+    UnsafeDirectory = "UnsafeDirectory",
+    PathExistsButNotInRef = "PathExistsButNotInRef",
+    LFSAttributeDoesNotMatch = "LFSAttributeDoesNotMatch"
+}
+export declare class ExecError extends Error {
+    readonly code: string;
+    readonly stdout: string | Buffer;
+    readonly stderr: string | Buffer;
+    readonly cause?: Error;
+    constructor(message: string, stdout: string | Buffer, stderr: string | Buffer, cause?: Error);
+}
+export interface IGitResult {
+    readonly stdout: string | Buffer;
+    readonly stderr: string | Buffer;
+    readonly exitCode: number;
+}
+export interface IGitExecutionOptions {
+    readonly env?: Record<string, string | undefined>;
+    readonly cwd?: string;
+    readonly stdin?: string;
+    readonly maxBuffer?: number;
+    readonly processCallback?: (process: any) => void;
+    readonly encoding?: BufferEncoding;
+}
+export interface IGitSpawnOptions extends SpawnOptions {
+    readonly stdin?: string;
+}
+/**
+ * Execute a git command and return the result.
+ */
+export declare function exec(args: string[], path: string, options?: IGitExecutionOptions): Promise<IGitResult>;
+/**
+ * Spawn a git process, returning the ChildProcess for streaming access.
+ */
+export declare function spawnGit(args: string[], path: string, options?: IGitSpawnOptions): import("child_process").ChildProcess;
+/**
+ * Parse git stderr output into a GitError enum value.
+ */
+export declare function parseError(stderr: string): GitError | null;
+/**
+ * Parse information about a bad config value error.
+ */
+export declare function parseBadConfigValueErrorInfo(stderr: string): {
+    key: string;
+    value: string;
+} | null;

package/dist/git/exec.js

@@ -0,0 +1,224 @@
+import { spawn } from 'child_process';
+/**
+ * Git error types parsed from stderr output.
+ * This is a simplified version of dugite's GitError enum.
+ */
+export var GitError;
+(function (GitError) {
+    // Authentication
+    GitError["SSHAuthenticationFailed"] = "SSHAuthenticationFailed";
+    GitError["SSHPermissionDenied"] = "SSHPermissionDenied";
+    GitError["HTTPSAuthenticationFailed"] = "HTTPSAuthenticationFailed";
+    GitError["SSHKeyAuditUnverified"] = "SSHKeyAuditUnverified";
+    // Remote
+    GitError["RemoteDisconnection"] = "RemoteDisconnection";
+    GitError["HostDown"] = "HostDown";
+    GitError["HTTPSRepositoryNotFound"] = "HTTPSRepositoryNotFound";
+    GitError["SSHRepositoryNotFound"] = "SSHRepositoryNotFound";
+    // Push / Pull
+    GitError["PushNotFastForward"] = "PushNotFastForward";
+    GitError["PushWithFileSizeExceedingLimit"] = "PushWithFileSizeExceedingLimit";
+    GitError["PushWithPrivateEmail"] = "PushWithPrivateEmail";
+    GitError["PushWithSecretDetected"] = "PushWithSecretDetected";
+    GitError["ForcePushRejected"] = "ForcePushRejected";
+    GitError["ProtectedBranchForcePush"] = "ProtectedBranchForcePush";
+    GitError["ProtectedBranchRequiresReview"] = "ProtectedBranchRequiresReview";
+    GitError["ProtectedBranchDeleteRejected"] = "ProtectedBranchDeleteRejected";
+    GitError["ProtectedBranchRequiredStatus"] = "ProtectedBranchRequiredStatus";
+    // Branch
+    GitError["BranchDeletionFailed"] = "BranchDeletionFailed";
+    GitError["DefaultBranchDeletionFailed"] = "DefaultBranchDeletionFailed";
+    GitError["BranchAlreadyExists"] = "BranchAlreadyExists";
+    GitError["BranchRenameFailed"] = "BranchRenameFailed";
+    GitError["HexBranchNameRejected"] = "HexBranchNameRejected";
+    GitError["InvalidRefLength"] = "InvalidRefLength";
+    // Merge / Rebase
+    GitError["MergeConflicts"] = "MergeConflicts";
+    GitError["RebaseConflicts"] = "RebaseConflicts";
+    GitError["MergeWithLocalChanges"] = "MergeWithLocalChanges";
+    GitError["RebaseWithLocalChanges"] = "RebaseWithLocalChanges";
+    GitError["InvalidMerge"] = "InvalidMerge";
+    GitError["InvalidRebase"] = "InvalidRebase";
+    GitError["NonFastForwardMergeIntoEmptyHead"] = "NonFastForwardMergeIntoEmptyHead";
+    GitError["CannotMergeUnrelatedHistories"] = "CannotMergeUnrelatedHistories";
+    GitError["NoMergeToAbort"] = "NoMergeToAbort";
+    GitError["RevertConflicts"] = "RevertConflicts";
+    // Rebase
+    GitError["EmptyRebasePatch"] = "EmptyRebasePatch";
+    // Commit
+    GitError["NothingToCommit"] = "NothingToCommit";
+    GitError["GPGFailedToSignData"] = "GPGFailedToSignData";
+    // Bad config
+    GitError["BadConfigValue"] = "BadConfigValue";
+    GitError["ConfigLockFileAlreadyExists"] = "ConfigLockFileAlreadyExists";
+    // Misc
+    GitError["NotAGitRepository"] = "NotAGitRepository";
+    GitError["BadRevision"] = "BadRevision";
+    GitError["LocalPermissionDenied"] = "LocalPermissionDenied";
+    GitError["NoMatchingRemoteBranch"] = "NoMatchingRemoteBranch";
+    GitError["NoExistingRemoteBranch"] = "NoExistingRemoteBranch";
+    GitError["PatchDoesNotApply"] = "PatchDoesNotApply";
+    GitError["NoSubmoduleMapping"] = "NoSubmoduleMapping";
+    GitError["SubmoduleRepositoryDoesNotExist"] = "SubmoduleRepositoryDoesNotExist";
+    GitError["InvalidSubmoduleSHA"] = "InvalidSubmoduleSHA";
+    GitError["LockFileAlreadyExists"] = "LockFileAlreadyExists";
+    GitError["UnresolvedConflicts"] = "UnresolvedConflicts";
+    GitError["LocalChangesOverwritten"] = "LocalChangesOverwritten";
+    GitError["RemoteAlreadyExists"] = "RemoteAlreadyExists";
+    GitError["TagAlreadyExists"] = "TagAlreadyExists";
+    GitError["PathDoesNotExist"] = "PathDoesNotExist";
+    GitError["InvalidObjectName"] = "InvalidObjectName";
+    GitError["OutsideRepository"] = "OutsideRepository";
+    GitError["ConflictModifyDeletedInBranch"] = "ConflictModifyDeletedInBranch";
+    GitError["MergeCommitNoMainlineOption"] = "MergeCommitNoMainlineOption";
+    GitError["UnsafeDirectory"] = "UnsafeDirectory";
+    GitError["PathExistsButNotInRef"] = "PathExistsButNotInRef";
+    GitError["LFSAttributeDoesNotMatch"] = "LFSAttributeDoesNotMatch";
+})(GitError || (GitError = {}));
+export class ExecError extends Error {
+    code;
+    stdout;
+    stderr;
+    cause;
+    constructor(message, stdout, stderr, cause) {
+        super(message);
+        this.name = 'ExecError';
+        this.code = 'ERR_CHILD_PROCESS_STDIO_MAXBUFFER';
+        this.stdout = stdout;
+        this.stderr = stderr;
+        this.cause = cause;
+    }
+}
+/**
+ * Execute a git command and return the result.
+ */
+export async function exec(args, path, options) {
+    return new Promise((resolve, reject) => {
+        const child = spawn('git', args, {
+            cwd: path,
+            env: {
+                ...process.env,
+                TERM: 'dumb',
+                ...options?.env,
+            },
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        const stdoutChunks = [];
+        const stderrChunks = [];
+        child.stdout?.on('data', (chunk) => stdoutChunks.push(chunk));
+        child.stderr?.on('data', (chunk) => stderrChunks.push(chunk));
+        if (options?.processCallback) {
+            options.processCallback(child);
+        }
+        if (options?.stdin) {
+            child.stdin?.write(options.stdin);
+            child.stdin?.end();
+        }
+        child.on('close', (exitCode) => {
+            const stdoutBuf = Buffer.concat(stdoutChunks);
+            const stderrBuf = Buffer.concat(stderrChunks);
+            const enc = options?.encoding;
+            const isBuffer = enc === 'buffer';
+            resolve({
+                stdout: isBuffer ? stdoutBuf : stdoutBuf.toString(options?.encoding || 'utf-8'),
+                stderr: isBuffer ? stderrBuf : stderrBuf.toString(options?.encoding || 'utf-8'),
+                exitCode: exitCode ?? -1,
+            });
+        });
+        child.on('error', (err) => {
+            reject(err);
+        });
+    });
+}
+/**
+ * Spawn a git process, returning the ChildProcess for streaming access.
+ */
+export function spawnGit(args, path, options) {
+    return spawn('git', args, {
+        ...options,
+        cwd: path,
+        env: {
+            ...process.env,
+            TERM: 'dumb',
+            ...options?.env,
+        },
+    });
+}
+/**
+ * Parse git stderr output into a GitError enum value.
+ */
+export function parseError(stderr) {
+    if (!stderr)
+        return null;
+    // Authentication errors
+    if (stderr.includes('Permission denied (publickey)'))
+        return GitError.SSHPermissionDenied;
+    if (stderr.includes('fatal: Could not read from remote repository'))
+        return GitError.SSHAuthenticationFailed;
+    if (stderr.includes('Authentication failed'))
+        return GitError.HTTPSAuthenticationFailed;
+    // Merge conflicts
+    if (stderr.includes('Automatic merge failed'))
+        return GitError.MergeConflicts;
+    if (stderr.includes('merge failed'))
+        return GitError.MergeConflicts;
+    if (stderr.includes('conflict'))
+        return GitError.MergeConflicts;
+    // Rebase
+    if (stderr.includes('could not apply'))
+        return GitError.RebaseConflicts;
+    if (stderr.includes('interactive rebase already started'))
+        return GitError.RebaseConflicts;
+    // Push
+    if (stderr.includes('push is not fast forward') || stderr.includes('[rejected]'))
+        return GitError.PushNotFastForward;
+    if (stderr.includes('failed to push'))
+        return GitError.PushNotFastForward;
+    // Remote
+    if (stderr.includes('Could not resolve host'))
+        return GitError.RemoteDisconnection;
+    if (stderr.includes('host down'))
+        return GitError.HostDown;
+    if (stderr.includes('Repository not found'))
+        return GitError.HTTPSRepositoryNotFound;
+    if (stderr.includes('not found'))
+        return GitError.HTTPSRepositoryNotFound;
+    // Branch
+    if (stderr.includes('branch .* already exists'))
+        return GitError.BranchAlreadyExists;
+    if (stderr.includes('not a valid branch'))
+        return GitError.BranchDeletionFailed;
+    if (stderr.includes('could not delete'))
+        return GitError.BranchDeletionFailed;
+    // Config
+    if (stderr.includes('bad config value'))
+        return GitError.BadConfigValue;
+    if (stderr.includes('bad numeric config value'))
+        return GitError.BadConfigValue;
+    if (stderr.includes('config file lock'))
+        return GitError.ConfigLockFileAlreadyExists;
+    // Misc
+    if (stderr.includes('fatal: not a git repository'))
+        return GitError.NotAGitRepository;
+    if (stderr.includes('bad revision'))
+        return GitError.BadRevision;
+    if (stderr.includes('nothing to commit'))
+        return GitError.NothingToCommit;
+    if (stderr.includes('Permission denied'))
+        return GitError.LocalPermissionDenied;
+    if (stderr.includes('pathspec .* did not match'))
+        return GitError.PathDoesNotExist;
+    if (stderr.includes('did not match any files'))
+        return GitError.PathDoesNotExist;
+    return null;
+}
+/**
+ * Parse information about a bad config value error.
+ */
+export function parseBadConfigValueErrorInfo(stderr) {
+    const match = stderr.match(/bad config value for '([^']+)' in ([^:]+):?\s*(.*)/);
+    if (!match)
+        return null;
+    return { key: match[1], value: match[3]?.trim() || '' };
+}
+//# sourceMappingURL=exec.js.map

package/dist/git/exec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.js","sourceRoot":"","sources":["../../src/git/exec.ts"],"names":[],"mappings":"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"}

package/dist/git/fetch.d.ts

@@ -0,0 +1,25 @@
+import { Repository } from '../models/repository.js';
+import { IFetchProgress } from '../models/progress.js';
+import { IRemote } from '../models/remote.js';
+import { ITrackingBranch } from '../models/branch.js';
+/**
+ * Fetch from the given remote.
+ *
+ * @param repository - The repository to fetch into
+ *
+ * @param account    - The account to use when authenticating with the remote
+ *
+ * @param remote     - The remote to fetch from
+ *
+ * @param progressCallback - An optional function which will be invoked
+ *                           with information about the current progress
+ *                           of the fetch operation. When provided this enables
+ *                           the '--progress' command line flag for
+ *                           'git fetch'.
+ * @param isBackgroundTask  - Whether the fetch is being performed as a
+ *                            background task as opposed to being user initiated
+ */
+export declare function fetch(repository: Repository, remote: IRemote, progressCallback?: (progress: IFetchProgress) => void, isBackgroundTask?: boolean): Promise<void>;
+/** Fetch a given refspec from the given remote. */
+export declare function fetchRefspec(repository: Repository, remote: IRemote, refspec: string): Promise<void>;
+export declare function fastForwardBranches(repository: Repository, branches: ReadonlyArray<ITrackingBranch>): Promise<void>;

package/dist/git/fetch.js

@@ -0,0 +1,100 @@
+import { git } from './core.js';
+import { FetchProgressParser, executionOptionsWithProgress } from '../lib/progress/index.js';
+import { envForRemoteOperation } from './environment.js';
+async function getFetchArgs(remote, progressCallback) {
+    return [
+        'fetch',
+        ...(progressCallback ? ['--progress'] : []),
+        '--prune',
+        '--recurse-submodules=on-demand',
+        remote,
+    ];
+}
+/**
+ * Fetch from the given remote.
+ *
+ * @param repository - The repository to fetch into
+ *
+ * @param account    - The account to use when authenticating with the remote
+ *
+ * @param remote     - The remote to fetch from
+ *
+ * @param progressCallback - An optional function which will be invoked
+ *                           with information about the current progress
+ *                           of the fetch operation. When provided this enables
+ *                           the '--progress' command line flag for
+ *                           'git fetch'.
+ * @param isBackgroundTask  - Whether the fetch is being performed as a
+ *                            background task as opposed to being user initiated
+ */
+export async function fetch(repository, remote, progressCallback, isBackgroundTask = false) {
+    let opts = {
+        successExitCodes: new Set([0]),
+        env: await envForRemoteOperation(remote.url),
+    };
+    if (progressCallback) {
+        const title = `Fetching ${remote.name}`;
+        const kind = 'fetch';
+        opts = await executionOptionsWithProgress({ ...opts, trackLFSProgress: true, isBackgroundTask }, new FetchProgressParser(), progress => {
+            // In addition to progress output from the remote end and from
+            // git itself, the stderr output from pull contains information
+            // about ref updates. We don't need to bring those into the progress
+            // stream so we'll just punt on anything we don't know about for now.
+            if (progress.kind === 'context') {
+                if (!progress.text.startsWith('remote: Counting objects')) {
+                    return;
+                }
+            }
+            const description = progress.kind === 'progress' ? progress.details.text : progress.text;
+            const value = progress.percent;
+            progressCallback({
+                kind,
+                title,
+                description,
+                value,
+                remote: remote.name,
+            });
+        });
+        // Initial progress
+        progressCallback({ kind, title, value: 0, remote: remote.name });
+    }
+    const args = await getFetchArgs(remote.name, progressCallback);
+    await git(args, repository.path, 'fetch', opts);
+}
+/** Fetch a given refspec from the given remote. */
+export async function fetchRefspec(repository, remote, refspec) {
+    await git(['fetch', remote.name, refspec], repository.path, 'fetchRefspec', {
+        successExitCodes: new Set([0, 128]),
+        env: await envForRemoteOperation(remote.url),
+    });
+}
+export async function fastForwardBranches(repository, branches) {
+    if (branches.length === 0) {
+        return;
+    }
+    const refPairs = branches.map(branch => `${branch.upstreamRef}:${branch.ref}`);
+    await git([
+        'fetch',
+        '.',
+        // Make sure we don't try to update branches that can't be fast-forwarded
+        // even if the user disabled this via the git config option
+        // `fetch.showForcedUpdates`
+        '--show-forced-updates',
+        // Prevent `git fetch` from touching the `FETCH_HEAD`
+        '--no-write-fetch-head',
+        // Take branch refs from stdin to circumvent shell max line length
+        // limitations (mainly on Windows)
+        '--stdin',
+    ], repository.path, 'fastForwardBranches', {
+        // Fetch exits with an exit code of 1 if one or more refs failed to update
+        // which is what we expect will happen
+        successExitCodes: new Set([0, 1]),
+        env: {
+            // This will make sure the reflog entries are correct after
+            // fast-forwarding the branches.
+            GIT_REFLOG_ACTION: 'pull',
+        },
+        stdin: refPairs.join('\n'),
+    });
+}
+//# sourceMappingURL=fetch.js.map

package/dist/git/fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.js","sourceRoot":"","sources":["../../src/git/fetch.ts"],"names":[],"mappings":"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"}

package/dist/git/for-each-ref.d.ts

@@ -0,0 +1,13 @@
+import { Repository } from '../models/repository.js';
+import { Branch, ITrackingBranch } from '../models/branch.js';
+/** Get all the branches. */
+export declare function getBranches(repository: Repository, ...prefixes: string[]): Promise<ReadonlyArray<Branch>>;
+/**
+ * Gets all branches that differ from their upstream (i.e. they're ahead,
+ * behind or both), excluding the current branch.
+ * Useful to narrow down a list of branches that could potentially be fast
+ * forwarded.
+ *
+ * @param repository Repository to get the branches from.
+ */
+export declare function getBranchesDifferingFromUpstream(repository: Repository): Promise<ReadonlyArray<ITrackingBranch>>;