@hibanacloud/cli 0.3.15

package/dist/src/utils/errors.test.js

@@ -0,0 +1,340 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { vi } from 'vitest';
+import { OutputFormat, FatalInputError } from '@hibanacloud/core';
+import { getErrorMessage, handleError, handleToolError, handleCancellationError, handleMaxTurnsExceededError, } from './errors.js';
+// Mock the core modules
+vi.mock('@hibanacloud/core', async (importOriginal) => {
+    const original = await importOriginal();
+    return {
+        ...original,
+        parseAndFormatApiError: vi.fn((error) => {
+            if (error instanceof Error) {
+                return `API Error: ${error.message}`;
+            }
+            return `API Error: ${String(error)}`;
+        }),
+        JsonFormatter: vi.fn().mockImplementation(() => ({
+            formatError: vi.fn((error, code) => JSON.stringify({
+                error: {
+                    type: error.constructor.name,
+                    message: error.message,
+                    ...(code && { code }),
+                },
+            }, null, 2)),
+        })),
+        FatalToolExecutionError: class extends Error {
+            constructor(message) {
+                super(message);
+                this.name = 'FatalToolExecutionError';
+                this.exitCode = 54;
+            }
+            exitCode;
+        },
+        FatalCancellationError: class extends Error {
+            constructor(message) {
+                super(message);
+                this.name = 'FatalCancellationError';
+                this.exitCode = 130;
+            }
+            exitCode;
+        },
+    };
+});
+describe('errors', () => {
+    let mockConfig;
+    let processExitSpy;
+    let consoleErrorSpy;
+    beforeEach(() => {
+        // Reset mocks
+        vi.clearAllMocks();
+        // Mock console.error
+        consoleErrorSpy = vi.spyOn(console, 'error').mockImplementation(() => { });
+        // Mock process.exit to throw instead of actually exiting
+        processExitSpy = vi.spyOn(process, 'exit').mockImplementation((code) => {
+            throw new Error(`process.exit called with code: ${code}`);
+        });
+        // Create mock config
+        mockConfig = {
+            getOutputFormat: vi.fn().mockReturnValue(OutputFormat.TEXT),
+            getContentGeneratorConfig: vi.fn().mockReturnValue({ authType: 'test' }),
+            getDebugMode: vi.fn().mockReturnValue(true),
+        };
+    });
+    afterEach(() => {
+        consoleErrorSpy.mockRestore();
+        processExitSpy.mockRestore();
+    });
+    describe('getErrorMessage', () => {
+        it('should return error message for Error instances', () => {
+            const error = new Error('Test error message');
+            expect(getErrorMessage(error)).toBe('Test error message');
+        });
+        it('should convert non-Error values to strings', () => {
+            expect(getErrorMessage('string error')).toBe('string error');
+            expect(getErrorMessage(123)).toBe('123');
+            expect(getErrorMessage(null)).toBe('null');
+            expect(getErrorMessage(undefined)).toBe('undefined');
+        });
+        it('should handle objects', () => {
+            const obj = { message: 'test' };
+            expect(getErrorMessage(obj)).toBe('[object Object]');
+        });
+    });
+    describe('handleError', () => {
+        describe('in text mode', () => {
+            beforeEach(() => {
+                mockConfig.getOutputFormat.mockReturnValue(OutputFormat.TEXT);
+            });
+            it('should log error message and re-throw', () => {
+                const testError = new Error('Test error');
+                expect(() => {
+                    handleError(testError, mockConfig);
+                }).toThrow(testError);
+                expect(consoleErrorSpy).toHaveBeenCalledWith('API Error: Test error');
+            });
+            it('should handle non-Error objects', () => {
+                const testError = 'String error';
+                expect(() => {
+                    handleError(testError, mockConfig);
+                }).toThrow(testError);
+                expect(consoleErrorSpy).toHaveBeenCalledWith('API Error: String error');
+            });
+        });
+        describe('in JSON mode', () => {
+            beforeEach(() => {
+                mockConfig.getOutputFormat.mockReturnValue(OutputFormat.JSON);
+            });
+            it('should format error as JSON and exit with default code', () => {
+                const testError = new Error('Test error');
+                expect(() => {
+                    handleError(testError, mockConfig);
+                }).toThrow('process.exit called with code: 1');
+                expect(consoleErrorSpy).toHaveBeenCalledWith(JSON.stringify({
+                    error: {
+                        type: 'Error',
+                        message: 'Test error',
+                        code: 1,
+                    },
+                }, null, 2));
+            });
+            it('should use custom error code when provided', () => {
+                const testError = new Error('Test error');
+                expect(() => {
+                    handleError(testError, mockConfig, 42);
+                }).toThrow('process.exit called with code: 42');
+                expect(consoleErrorSpy).toHaveBeenCalledWith(JSON.stringify({
+                    error: {
+                        type: 'Error',
+                        message: 'Test error',
+                        code: 42,
+                    },
+                }, null, 2));
+            });
+            it('should extract exitCode from FatalError instances', () => {
+                const fatalError = new FatalInputError('Fatal error');
+                expect(() => {
+                    handleError(fatalError, mockConfig);
+                }).toThrow('process.exit called with code: 42');
+                expect(consoleErrorSpy).toHaveBeenCalledWith(JSON.stringify({
+                    error: {
+                        type: 'FatalInputError',
+                        message: 'Fatal error',
+                        code: 42,
+                    },
+                }, null, 2));
+            });
+            it('should handle error with code property', () => {
+                const errorWithCode = new Error('Error with code');
+                errorWithCode.code = 404;
+                expect(() => {
+                    handleError(errorWithCode, mockConfig);
+                }).toThrow('process.exit called with code: 404');
+            });
+            it('should handle error with status property', () => {
+                const errorWithStatus = new Error('Error with status');
+                errorWithStatus.status = 'TIMEOUT';
+                expect(() => {
+                    handleError(errorWithStatus, mockConfig);
+                }).toThrow('process.exit called with code: 1'); // string codes become 1
+                expect(consoleErrorSpy).toHaveBeenCalledWith(JSON.stringify({
+                    error: {
+                        type: 'Error',
+                        message: 'Error with status',
+                        code: 'TIMEOUT',
+                    },
+                }, null, 2));
+            });
+        });
+    });
+    describe('handleToolError', () => {
+        const toolName = 'test-tool';
+        const toolError = new Error('Tool failed');
+        describe('when debug mode is enabled', () => {
+            beforeEach(() => {
+                mockConfig.getDebugMode.mockReturnValue(true);
+            });
+            describe('in text mode', () => {
+                beforeEach(() => {
+                    mockConfig.getOutputFormat.mockReturnValue(OutputFormat.TEXT);
+                });
+                it('should log error message to stderr and not exit', () => {
+                    handleToolError(toolName, toolError, mockConfig);
+                    expect(consoleErrorSpy).toHaveBeenCalledWith('Error executing tool test-tool: Tool failed');
+                    expect(processExitSpy).not.toHaveBeenCalled();
+                });
+                it('should use resultDisplay when provided and not exit', () => {
+                    handleToolError(toolName, toolError, mockConfig, 'CUSTOM_ERROR', 'Custom display message');
+                    expect(consoleErrorSpy).toHaveBeenCalledWith('Error executing tool test-tool: Custom display message');
+                    expect(processExitSpy).not.toHaveBeenCalled();
+                });
+            });
+            describe('in JSON mode', () => {
+                beforeEach(() => {
+                    mockConfig.getOutputFormat.mockReturnValue(OutputFormat.JSON);
+                });
+                it('should log error message to stderr and not exit', () => {
+                    handleToolError(toolName, toolError, mockConfig);
+                    // In JSON mode, should not exit (just log to stderr when debug mode is on)
+                    expect(consoleErrorSpy).toHaveBeenCalledWith('Error executing tool test-tool: Tool failed');
+                    expect(processExitSpy).not.toHaveBeenCalled();
+                });
+                it('should log error with custom error code and not exit', () => {
+                    handleToolError(toolName, toolError, mockConfig, 'CUSTOM_TOOL_ERROR');
+                    // In JSON mode, should not exit (just log to stderr when debug mode is on)
+                    expect(consoleErrorSpy).toHaveBeenCalledWith('Error executing tool test-tool: Tool failed');
+                    expect(processExitSpy).not.toHaveBeenCalled();
+                });
+                it('should log error with numeric error code and not exit', () => {
+                    handleToolError(toolName, toolError, mockConfig, 500);
+                    // In JSON mode, should not exit (just log to stderr when debug mode is on)
+                    expect(consoleErrorSpy).toHaveBeenCalledWith('Error executing tool test-tool: Tool failed');
+                    expect(processExitSpy).not.toHaveBeenCalled();
+                });
+                it('should prefer resultDisplay over error message and not exit', () => {
+                    handleToolError(toolName, toolError, mockConfig, 'DISPLAY_ERROR', 'Display message');
+                    // In JSON mode, should not exit (just log to stderr when debug mode is on)
+                    expect(consoleErrorSpy).toHaveBeenCalledWith('Error executing tool test-tool: Display message');
+                    expect(processExitSpy).not.toHaveBeenCalled();
+                });
+            });
+            describe('in STREAM_JSON mode', () => {
+                beforeEach(() => {
+                    mockConfig.getOutputFormat.mockReturnValue(OutputFormat.STREAM_JSON);
+                });
+                it('should log error message to stderr and not exit', () => {
+                    handleToolError(toolName, toolError, mockConfig);
+                    // Should not exit in STREAM_JSON mode (just log to stderr when debug mode is on)
+                    expect(consoleErrorSpy).toHaveBeenCalledWith('Error executing tool test-tool: Tool failed');
+                    expect(processExitSpy).not.toHaveBeenCalled();
+                });
+            });
+        });
+        describe('when debug mode is disabled', () => {
+            beforeEach(() => {
+                mockConfig.getDebugMode.mockReturnValue(false);
+            });
+            it('should not log and not exit in text mode', () => {
+                mockConfig.getOutputFormat.mockReturnValue(OutputFormat.TEXT);
+                handleToolError(toolName, toolError, mockConfig);
+                expect(consoleErrorSpy).not.toHaveBeenCalled();
+                expect(processExitSpy).not.toHaveBeenCalled();
+            });
+            it('should not log and not exit in JSON mode', () => {
+                mockConfig.getOutputFormat.mockReturnValue(OutputFormat.JSON);
+                handleToolError(toolName, toolError, mockConfig);
+                expect(consoleErrorSpy).not.toHaveBeenCalled();
+                expect(processExitSpy).not.toHaveBeenCalled();
+            });
+            it('should not log and not exit in STREAM_JSON mode', () => {
+                mockConfig.getOutputFormat.mockReturnValue(OutputFormat.STREAM_JSON);
+                handleToolError(toolName, toolError, mockConfig);
+                expect(consoleErrorSpy).not.toHaveBeenCalled();
+                expect(processExitSpy).not.toHaveBeenCalled();
+            });
+        });
+        describe('process exit behavior', () => {
+            beforeEach(() => {
+                mockConfig.getDebugMode.mockReturnValue(true);
+            });
+            it('should never exit regardless of output format', () => {
+                // Test in TEXT mode
+                mockConfig.getOutputFormat.mockReturnValue(OutputFormat.TEXT);
+                handleToolError(toolName, toolError, mockConfig);
+                expect(processExitSpy).not.toHaveBeenCalled();
+                // Test in JSON mode
+                mockConfig.getOutputFormat.mockReturnValue(OutputFormat.JSON);
+                handleToolError(toolName, toolError, mockConfig);
+                expect(processExitSpy).not.toHaveBeenCalled();
+                // Test in STREAM_JSON mode
+                mockConfig.getOutputFormat.mockReturnValue(OutputFormat.STREAM_JSON);
+                handleToolError(toolName, toolError, mockConfig);
+                expect(processExitSpy).not.toHaveBeenCalled();
+            });
+        });
+    });
+    describe('handleCancellationError', () => {
+        describe('in text mode', () => {
+            beforeEach(() => {
+                mockConfig.getOutputFormat.mockReturnValue(OutputFormat.TEXT);
+            });
+            it('should log cancellation message and exit with 130', () => {
+                expect(() => {
+                    handleCancellationError(mockConfig);
+                }).toThrow('process.exit called with code: 130');
+                expect(consoleErrorSpy).toHaveBeenCalledWith('Operation cancelled.');
+            });
+        });
+        describe('in JSON mode', () => {
+            beforeEach(() => {
+                mockConfig.getOutputFormat.mockReturnValue(OutputFormat.JSON);
+            });
+            it('should format cancellation as JSON and exit with 130', () => {
+                expect(() => {
+                    handleCancellationError(mockConfig);
+                }).toThrow('process.exit called with code: 130');
+                expect(consoleErrorSpy).toHaveBeenCalledWith(JSON.stringify({
+                    error: {
+                        type: 'FatalCancellationError',
+                        message: 'Operation cancelled.',
+                        code: 130,
+                    },
+                }, null, 2));
+            });
+        });
+    });
+    describe('handleMaxTurnsExceededError', () => {
+        describe('in text mode', () => {
+            beforeEach(() => {
+                mockConfig.getOutputFormat.mockReturnValue(OutputFormat.TEXT);
+            });
+            it('should log max turns message and exit with 53', () => {
+                expect(() => {
+                    handleMaxTurnsExceededError(mockConfig);
+                }).toThrow('process.exit called with code: 53');
+                expect(consoleErrorSpy).toHaveBeenCalledWith('Reached max session turns for this session. Increase the number of turns by specifying maxSessionTurns in settings.json.');
+            });
+        });
+        describe('in JSON mode', () => {
+            beforeEach(() => {
+                mockConfig.getOutputFormat.mockReturnValue(OutputFormat.JSON);
+            });
+            it('should format max turns error as JSON and exit with 53', () => {
+                expect(() => {
+                    handleMaxTurnsExceededError(mockConfig);
+                }).toThrow('process.exit called with code: 53');
+                expect(consoleErrorSpy).toHaveBeenCalledWith(JSON.stringify({
+                    error: {
+                        type: 'FatalTurnLimitedError',
+                        message: 'Reached max session turns for this session. Increase the number of turns by specifying maxSessionTurns in settings.json.',
+                        code: 53,
+                    },
+                }, null, 2));
+            });
+        });
+    });
+});
+//# sourceMappingURL=errors.test.js.map

package/dist/src/utils/errors.test.js.map

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

package/dist/src/utils/events.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { EventEmitter } from 'node:events';
+export declare enum AppEvent {
+    OpenDebugConsole = "open-debug-console",
+    LogError = "log-error",
+    OauthDisplayMessage = "oauth-display-message"
+}
+export declare const appEvents: EventEmitter<[never]>;

package/dist/src/utils/events.js

@@ -0,0 +1,14 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { EventEmitter } from 'node:events';
+export var AppEvent;
+(function (AppEvent) {
+    AppEvent["OpenDebugConsole"] = "open-debug-console";
+    AppEvent["LogError"] = "log-error";
+    AppEvent["OauthDisplayMessage"] = "oauth-display-message";
+})(AppEvent || (AppEvent = {}));
+export const appEvents = new EventEmitter();
+//# sourceMappingURL=events.js.map

package/dist/src/utils/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../src/utils/events.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,CAAN,IAAY,QAIX;AAJD,WAAY,QAAQ;IAClB,mDAAuC,CAAA;IACvC,kCAAsB,CAAA;IACtB,yDAA6C,CAAA;AAC/C,CAAC,EAJW,QAAQ,KAAR,QAAQ,QAInB;AAED,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,YAAY,EAAE,CAAC"}

package/dist/src/utils/gitUtils.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Checks if a directory is within a git repository hosted on GitHub.
+ * @returns true if the directory is in a git repository with a github.com remote, false otherwise
+ */
+export declare const isGitHubRepository: () => boolean;
+/**
+ * getGitRepoRoot returns the root directory of the git repository.
+ * @returns the path to the root of the git repo.
+ * @throws error if the exec command fails.
+ */
+export declare const getGitRepoRoot: () => string;
+/**
+ * getLatestGitHubRelease returns the release tag as a string.
+ * @returns string of the release tag (e.g. "v1.2.3").
+ */
+export declare const getLatestGitHubRelease: (proxy?: string) => Promise<string>;
+/**
+ * getGitHubRepoInfo returns the owner and repository for a GitHub repo.
+ * @returns the owner and repository of the github repo.
+ * @throws error if the exec command fails.
+ */
+export declare function getGitHubRepoInfo(): {
+    owner: string;
+    repo: string;
+};

package/dist/src/utils/gitUtils.js

@@ -0,0 +1,89 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { execSync } from 'node:child_process';
+import { ProxyAgent } from 'undici';
+/**
+ * Checks if a directory is within a git repository hosted on GitHub.
+ * @returns true if the directory is in a git repository with a github.com remote, false otherwise
+ */
+export const isGitHubRepository = () => {
+    try {
+        const remotes = (execSync('git remote -v', {
+            encoding: 'utf-8',
+        }) || '').trim();
+        const pattern = /github\.com/;
+        return pattern.test(remotes);
+    }
+    catch (_error) {
+        // If any filesystem error occurs, assume not a git repo
+        console.debug(`Failed to get git remote:`, _error);
+        return false;
+    }
+};
+/**
+ * getGitRepoRoot returns the root directory of the git repository.
+ * @returns the path to the root of the git repo.
+ * @throws error if the exec command fails.
+ */
+export const getGitRepoRoot = () => {
+    const gitRepoRoot = (execSync('git rev-parse --show-toplevel', {
+        encoding: 'utf-8',
+    }) || '').trim();
+    if (!gitRepoRoot) {
+        throw new Error(`Git repo returned empty value`);
+    }
+    return gitRepoRoot;
+};
+/**
+ * getLatestGitHubRelease returns the release tag as a string.
+ * @returns string of the release tag (e.g. "v1.2.3").
+ */
+export const getLatestGitHubRelease = async (proxy) => {
+    try {
+        const controller = new AbortController();
+        const endpoint = `https://api.github.com/repos/google-github-actions/run-gemini-cli/releases/latest`;
+        const response = await fetch(endpoint, {
+            method: 'GET',
+            headers: {
+                Accept: 'application/vnd.github+json',
+                'Content-Type': 'application/json',
+                'X-GitHub-Api-Version': '2022-11-28',
+            },
+            dispatcher: proxy ? new ProxyAgent(proxy) : undefined,
+            signal: AbortSignal.any([AbortSignal.timeout(30_000), controller.signal]),
+        });
+        if (!response.ok) {
+            throw new Error(`Invalid response code: ${response.status} - ${response.statusText}`);
+        }
+        const releaseTag = (await response.json()).tag_name;
+        if (!releaseTag) {
+            throw new Error(`Response did not include tag_name field`);
+        }
+        return releaseTag;
+    }
+    catch (_error) {
+        console.debug(`Failed to determine latest run-gemini-cli release:`, _error);
+        throw new Error(`Unable to determine the latest run-gemini-cli release on GitHub.`);
+    }
+};
+/**
+ * getGitHubRepoInfo returns the owner and repository for a GitHub repo.
+ * @returns the owner and repository of the github repo.
+ * @throws error if the exec command fails.
+ */
+export function getGitHubRepoInfo() {
+    const remoteUrl = execSync('git remote get-url origin', {
+        encoding: 'utf-8',
+    }).trim();
+    // Matches either https://github.com/owner/repo.git or git@github.com:owner/repo.git
+    const match = remoteUrl.match(/(?:https?:\/\/|git@)github\.com(?::|\/)([^/]+)\/([^/]+?)(?:\.git)?$/);
+    // If the regex fails match, throw an error.
+    if (!match || !match[1] || !match[2]) {
+        throw new Error(`Owner & repo could not be extracted from remote URL: ${remoteUrl}`);
+    }
+    return { owner: match[1], repo: match[2] };
+}
+//# sourceMappingURL=gitUtils.js.map

package/dist/src/utils/gitUtils.js.map

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

package/dist/src/utils/gitUtils.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};

package/dist/src/utils/gitUtils.test.js

@@ -0,0 +1,113 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { vi, describe, expect, it, afterEach, beforeEach } from 'vitest';
+import * as child_process from 'node:child_process';
+import { isGitHubRepository, getGitRepoRoot, getLatestGitHubRelease, getGitHubRepoInfo, } from './gitUtils.js';
+vi.mock('child_process');
+describe('isGitHubRepository', async () => {
+    beforeEach(() => {
+        vi.resetAllMocks();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it('returns false if the git command fails', async () => {
+        vi.mocked(child_process.execSync).mockImplementation(() => {
+            throw new Error('oops');
+        });
+        expect(isGitHubRepository()).toBe(false);
+    });
+    it('returns false if the remote is not github.com', async () => {
+        vi.mocked(child_process.execSync).mockReturnValueOnce('https://gitlab.com');
+        expect(isGitHubRepository()).toBe(false);
+    });
+    it('returns true if the remote is github.com', async () => {
+        vi.mocked(child_process.execSync).mockReturnValueOnce(`
+      origin  https://github.com/sethvargo/gemini-cli (fetch)
+      origin  https://github.com/sethvargo/gemini-cli (push)
+    `);
+        expect(isGitHubRepository()).toBe(true);
+    });
+});
+describe('getGitHubRepoInfo', async () => {
+    beforeEach(() => {
+        vi.resetAllMocks();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it('throws an error if github repo info cannot be determined', async () => {
+        vi.mocked(child_process.execSync).mockImplementation(() => {
+            throw new Error('oops');
+        });
+        expect(() => {
+            getGitHubRepoInfo();
+        }).toThrowError(/oops/);
+    });
+    it('throws an error if owner/repo could not be determined', async () => {
+        vi.mocked(child_process.execSync).mockReturnValueOnce('');
+        expect(() => {
+            getGitHubRepoInfo();
+        }).toThrowError(/Owner & repo could not be extracted from remote URL/);
+    });
+    it('returns the owner and repo', async () => {
+        vi.mocked(child_process.execSync).mockReturnValueOnce('https://github.com/owner/repo.git ');
+        expect(getGitHubRepoInfo()).toEqual({ owner: 'owner', repo: 'repo' });
+    });
+});
+describe('getGitRepoRoot', async () => {
+    beforeEach(() => {
+        vi.resetAllMocks();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it('throws an error if git root cannot be determined', async () => {
+        vi.mocked(child_process.execSync).mockImplementation(() => {
+            throw new Error('oops');
+        });
+        expect(() => {
+            getGitRepoRoot();
+        }).toThrowError(/oops/);
+    });
+    it('throws an error if git root is empty', async () => {
+        vi.mocked(child_process.execSync).mockReturnValueOnce('');
+        expect(() => {
+            getGitRepoRoot();
+        }).toThrowError(/Git repo returned empty value/);
+    });
+    it('returns the root', async () => {
+        vi.mocked(child_process.execSync).mockReturnValueOnce('/path/to/git/repo');
+        expect(getGitRepoRoot()).toBe('/path/to/git/repo');
+    });
+});
+describe('getLatestRelease', async () => {
+    beforeEach(() => {
+        vi.resetAllMocks();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it('throws an error if the fetch fails', async () => {
+        global.fetch = vi.fn(() => Promise.reject('nope'));
+        await expect(getLatestGitHubRelease()).rejects.toThrowError(/Unable to determine the latest/);
+    });
+    it('throws an error if the fetch does not return a json body', async () => {
+        global.fetch = vi.fn(() => Promise.resolve({
+            ok: true,
+            json: () => Promise.resolve({ foo: 'bar' }),
+        }));
+        await expect(getLatestGitHubRelease()).rejects.toThrowError(/Unable to determine the latest/);
+    });
+    it('returns the release version', async () => {
+        global.fetch = vi.fn(() => Promise.resolve({
+            ok: true,
+            json: () => Promise.resolve({ tag_name: 'v1.2.3' }),
+        }));
+        await expect(getLatestGitHubRelease()).resolves.toBe('v1.2.3');
+    });
+});
+//# sourceMappingURL=gitUtils.test.js.map

package/dist/src/utils/gitUtils.test.js.map

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