Treat missing release assets as user error

Author: cezaraugusto

src/add-progress-bar.ts

@@ -1,4 +1,5 @@
 import ProgressBar from 'progress';
+import { isGoGitItSilentError } from './utils/errors.js';
 
 export default async function addProgressBar(
   text: string | undefined,
@@ -44,7 +45,9 @@ export default async function addProgressBar(
         // Ensure the interval is cleared in case of error
         clearInterval(timer);
 
-        console.error('[go-git-it] An error occurred:', error);
+        if (!isGoGitItSilentError(error)) {
+          console.error('[go-git-it] An error occurred:', error);
+        }
         reject(error);
       });
   });

src/utils/download-strategies.ts

@@ -9,6 +9,7 @@ import {
   pathExists,
   moveFileOrDirectory,
 } from './cross-platform.js';
+import { GoGitItSilentError } from './errors.js';
 import { GitHubUrlData } from './url-parser.js';
 
 export async function downloadFullRepository(
@@ -153,11 +154,20 @@ export async function downloadReleaseAsset(
                 https
                   .get(redirectUrl, (redirectResponse) => {
                     if (redirectResponse.statusCode !== 200) {
-                      reject(
-                        new Error(
-                          `Failed to download release asset: HTTP ${redirectResponse.statusCode}`,
-                        ),
-                      );
+                      const statusCode = redirectResponse.statusCode;
+                      if (statusCode === 404) {
+                        reject(
+                          new GoGitItSilentError(
+                            'Release asset not found (HTTP 404). Check the release tag and asset name.',
+                          ),
+                        );
+                      } else {
+                        reject(
+                          new Error(
+                            `Failed to download release asset: HTTP ${statusCode}`,
+                          ),
+                        );
+                      }
                       return;
                     }
 
@@ -177,11 +187,20 @@ export async function downloadReleaseAsset(
             if (response.statusCode !== 200) {
               writeStream.destroy();
               fileHandle.close();
-              reject(
-                new Error(
-                  `Failed to download release asset: HTTP ${response.statusCode}`,
-                ),
-              );
+              const statusCode = response.statusCode;
+              if (statusCode === 404) {
+                reject(
+                  new GoGitItSilentError(
+                    'Release asset not found (HTTP 404). Check the release tag and asset name.',
+                  ),
+                );
+              } else {
+                reject(
+                  new Error(
+                    `Failed to download release asset: HTTP ${statusCode}`,
+                  ),
+                );
+              }
               return;
             }
 

src/utils/errors.ts

@@ -0,0 +1,17 @@
+export class GoGitItSilentError extends Error {
+  public readonly silent = true;
+
+  constructor(message: string) {
+    super(message);
+    this.name = 'GoGitItSilentError';
+  }
+}
+
+export function isGoGitItSilentError(error: unknown): boolean {
+  return (
+    error instanceof GoGitItSilentError ||
+    (typeof error === 'object' &&
+      error !== null &&
+      (error as { silent?: boolean }).silent === true)
+  );
+}