feat: option to disable overwrite

.github/README.md

@@ -51,6 +51,7 @@ APKMirrorDownloader.download({ org: "google-inc", repo: "youtube" });
 - dpi: Optional. The screen density of the application. For example, 240dpi, 320dpi, 480dpi, etc.
 - minAndroidVersion: Optional. The minimum Android version that the application is compatible with.
 - outDir: Optional. The output directory where the application files will be stored.
+- overwrite: Optional. Whether to overwrite the output file if it already exists.
 
 🟣 **AppOptions Interface**
 
@@ -61,6 +62,7 @@ APKMirrorDownloader.download({ org: "google-inc", repo: "youtube" });
 - minAndroidVersion: Optional. The minimum Android version that the application is compatible with.
 - outFile: Optional. The name of the output file where the application will be saved.
 - outDir: Optional. The output directory where the application files will be stored.
+- overwrite: Optional. Whether to overwrite the output file if it already exists.
 
 `AppOptions` will be merged automatically with `APKMDOptions` when download function is called.
 

src/cli.ts

@@ -45,8 +45,13 @@ yargs(process.argv.slice(2))
         await apkmd
           .download({ org, repo }, options)
           .then(
-            ({ dest }) => {
-              console.log(`Downloaded to ${dest}`);
+            ({ dest, skipped }) => {
+              if (skipped) {
+                console.log(`Skipped ${org}/${repo}`);
+                console.log(`Already exists at ${dest}`);
+              } else {
+                console.log(`Downloaded to ${dest}`);
+              }
             },
             e => {
               console.log(`Unable to download ${org}/${repo}`);
@@ -106,6 +111,11 @@ yargs(process.argv.slice(2))
         .option("outdir", {
           type: "string",
           describe: "Output directory",
+        })
+        .option("overwrite", {
+          type: "boolean",
+          describe: "Overwrite existing files",
+          default: true,
         });
     },
     async argv => {
@@ -121,11 +131,17 @@ yargs(process.argv.slice(2))
         minAndroidVersion: argv.minandroidversion,
         outFile: argv.outfile,
         outDir: argv.outdir,
+        overwrite: argv.overwrite,
       };
 
       await APKMirrorDownloader.download(app, options).then(
-        ({ dest }) => {
-          console.log(`Downloaded to ${dest}`);
+        ({ dest, skipped }) => {
+          if (skipped) {
+            console.log(`Skipped ${app.org}/${app.repo}`);
+            console.log(`Already exists at ${dest}`);
+          } else {
+            console.log(`Downloaded to ${dest}`);
+          }
         },
         err => {
           console.error(err);

src/lib/index.ts

@@ -1,3 +1,5 @@
+import { existsSync } from "fs";
+
 import { match } from "ts-pattern";
 
 import { cleanObject } from "../utils/object";
@@ -30,6 +32,7 @@ const DEFAULT_APP_OPTIONS = {
   version: "stable",
   arch: "universal",
   dpi: "nodpi",
+  overwrite: true,
 } satisfies AppOptions;
 
 export type APKMDOptionsWithSuggestions = APKMDOptions & {
@@ -154,8 +157,12 @@ export class APKMirrorDownloader {
       const outFile = ensureExtension(o.outFile ?? filename, extension);
       const dest = `${outDir}/${outFile}`;
 
+      if (!o.overwrite && existsSync(dest)) {
+        return { dest, skipped: true as const };
+      }
+
       await Bun.write(dest, res);
-      return { dest };
+      return { dest, skipped: false as const };
     });
   }
 }

src/lib/types.ts

@@ -37,4 +37,5 @@ export type AppOptions = {
   minAndroidVersion?: string;
   outFile?: string;
   outDir?: string;
+  overwrite?: boolean;
 };