8bitsapps-gcp-utils 1.0.4 → 1.0.6

package/GCPUtilities/Storage.js

@@ -180,6 +180,53 @@ class Storage {
       resumable: false
     });
   }
+  //
+  /**
+   * Creates a folder (empty placeholder object) in the bucket.
+   * @param {string} bucketName - Name of the bucket.
+   * @param {string} folderPath - Path of the folder (must end with /).
+   * @returns {Promise<void>}
+   */
+  async createFolder(bucketName, folderPath) {
+    await this.loadConfiguration();
+    //
+    const bucket = this.storage.bucket(bucketName);
+    const normalizedPath = folderPath.endsWith("/") ? folderPath : folderPath + "/";
+    const file = bucket.file(normalizedPath);
+    await file.save("", { contentType: "application/x-directory" });
+  }
+  //
+  /**
+   * Deletes a file from the bucket.
+   * @param {string} bucketName - Name of the bucket.
+   * @param {string} filePath - Path of the file to delete.
+   * @returns {Promise<void>}
+   */
+  async deleteFile(bucketName, filePath) {
+    await this.loadConfiguration();
+    //
+    const bucket = this.storage.bucket(bucketName);
+    const file = bucket.file(filePath);
+    await file.delete();
+  }
+  //
+  /**
+   * Deletes a folder and all its contents from the bucket.
+   * @param {string} bucketName - Name of the bucket.
+   * @param {string} folderPath - Path of the folder to delete.
+   * @returns {Promise<number>} Number of deleted files.
+   */
+  async deleteFolder(bucketName, folderPath) {
+    await this.loadConfiguration();
+    //
+    const bucket = this.storage.bucket(bucketName);
+    const [files] = await bucket.getFiles({ prefix: folderPath });
+    //
+    for (const file of files) {
+      await file.delete();
+    }
+    return files.length;
+  }
 }
 
 module.exports = Storage;

package/README.md

@@ -20,6 +20,9 @@ Interactive navigator for Google Cloud Storage:
 - View files with size information.
 - Download files to current directory.
 - Upload local files to GCS.
+- Create folders in GCS.
+- Delete files from GCS.
+- Delete folders from GCS (recursive).
 - Support for multiple buckets per configuration.
 
 ### Initialize configuration

package/commands/storageNavigator.js

@@ -108,20 +108,25 @@ async function showNavigationMenu(bucketName, currentPath, contents, options) {
     choices.push(new inquirer.Separator(chalk.yellow(`(showing first ${maxItems} items)`)));
   }
   choices.push({
-    name: chalk.green("Upload file here"),
+    name: chalk.green("↑ Upload file here"),
     value: { action: "upload", value: currentPath }
   });
+  choices.push({
+    name: chalk.green("+ Create folder here"),
+    value: { action: "createFolder", value: currentPath }
+  });
   //
   const message = backEnabled
-    ? `${bucketName}:${displayPath} (← back, ESC exit)`
-    : `${bucketName}:${displayPath} (ESC exit)`;
+    ? `${bucketName}:${displayPath} (← back, DEL delete, ESC exit)`
+    : `${bucketName}:${displayPath} (DEL delete, ESC exit)`;
   //
   const { selected } = await inquirer.prompt([{
     type: "listWithEscape",
     name: "selected",
     message,
     choices,
-    enableBack: backEnabled
+    enableBack: backEnabled,
+    deleteFilter: (value) => value?.action === "file" || value?.action === "folder"
   }]);
   //
   return selected;
@@ -141,6 +146,41 @@ async function promptUploadPath() {
   return filePath || null;
 }
 //
+/**
+ * Prompts for folder name to create.
+ * @returns {Promise<string|null>} Folder name or null if cancelled.
+ */
+async function promptFolderName() {
+  const { folderName } = await inquirer.prompt([{
+    type: "input",
+    name: "folderName",
+    message: "Enter folder name (or leave empty to cancel):",
+    validate: (input) => {
+      if (!input.trim()) return true;
+      if (input.includes("/")) return "Folder name cannot contain /";
+      return true;
+    }
+  }]);
+  //
+  return folderName.trim() || null;
+}
+//
+/**
+ * Prompts for delete confirmation.
+ * @param {string} itemName - Name of the item to delete.
+ * @param {string} itemType - Type of item ("file" or "folder").
+ * @returns {Promise<boolean>} True if confirmed.
+ */
+async function confirmDelete(itemName, itemType) {
+  const { confirmed } = await inquirer.prompt([{
+    type: "confirm",
+    name: "confirmed",
+    message: `Delete ${itemType} "${itemName}"?`,
+    default: false
+  }]);
+  return confirmed;
+}
+//
 /**
  * Shows the operation log section.
  * @param {Array<{type: string, message: string}>} logs - Array of log entries.
@@ -183,6 +223,9 @@ const command = {
     if (bucketName === null || bucketName?.action === "back") {
       return; // ESC or back arrow pressed.
     }
+    // Position cursor at end of bucket selection line.
+    process.stdout.write("\x1b[1A\x1b[2K\x1b[G");
+    process.stdout.write(`? Select bucket (ESC exit): ${bucketName}`);
     //
     // Navigation loop.
     const pathHistory = [""];
@@ -213,7 +256,7 @@ const command = {
       if (result === null) {
         // ESC pressed - exit storage navigator completely.
         const exitDisplayPath = currentPath || "/";
-        const exitHint = backEnabled ? "(← back, ESC exit)" : "(ESC exit)";
+        const exitHint = backEnabled ? "(← back, DEL delete, ESC exit)" : "(DEL delete, ESC exit)";
         process.stdout.write(`\x1b[1A\x1b[2K\x1b[G? ${bucketName}:${exitDisplayPath} ${exitHint} ${chalk.red("<- exit")}`);
         console.log();
         return;
@@ -222,18 +265,51 @@ const command = {
       if (result.action === "back") {
         // Left arrow pressed - go back one level (only possible when backEnabled is true).
         const backDisplayPath = currentPath || "/";
-        process.stdout.write(`\x1b[1A\x1b[2K\x1b[G? ${bucketName}:${backDisplayPath} (← back, ESC exit) ${chalk.cyan("<- back")}`);
+        process.stdout.write(`\x1b[1A\x1b[2K\x1b[G? ${bucketName}:${backDisplayPath} (← back, DEL delete, ESC exit) ${chalk.cyan("<- back")}`);
         pathHistory.pop();
         continue;
       }
       //
+      if (result.action === "delete") {
+        const selectedValue = result.value;
+        // Skip if not a file or folder (e.g., upload/createFolder option).
+        if (!selectedValue?.action || (selectedValue.action !== "file" && selectedValue.action !== "folder")) {
+          continue;
+        }
+        //
+        const isFolder = selectedValue.action === "folder";
+        const itemPath = selectedValue.value;
+        const itemName = getDisplayName(itemPath, currentPath);
+        //
+        const confirmed = await confirmDelete(itemName, isFolder ? "folder" : "file");
+        if (confirmed) {
+          const itemType = isFolder ? "folder" : "file";
+          process.stdout.write(chalk.yellow(`\n⏳ Deleting ${itemType} ${itemName}...`));
+          try {
+            if (isFolder) {
+              const count = await storage.deleteFolder(bucketName, itemPath);
+              process.stdout.write("\x1b[2K\x1b[G");
+              operationLogs.push({ type: "success", message: `Deleted folder "${itemName}" (${count} files)` });
+            } else {
+              await storage.deleteFile(bucketName, itemPath);
+              process.stdout.write("\x1b[2K\x1b[G");
+              operationLogs.push({ type: "success", message: `Deleted file "${itemName}"` });
+            }
+          } catch (err) {
+            process.stdout.write("\x1b[2K\x1b[G");
+            operationLogs.push({ type: "error", message: `Delete failed: ${itemName} - ${err.message}` });
+          }
+        }
+        continue;
+      }
+      //
       switch (result.action) {
       case "folder": {
         // Force newline, then go back up and overwrite inquirer's colored line.
         const folderDisplayName = getDisplayName(result.value, currentPath);
         const folderDisplayPath = currentPath || "/";
         process.stdout.write("\x1b[1A\x1b[2K\x1b[G");
-        process.stdout.write(`? ${bucketName}:${folderDisplayPath} (← back, ESC exit) ${chalk.cyan(`[D] ${folderDisplayName}`)}`);
+        process.stdout.write(`? ${bucketName}:${folderDisplayPath} (← back, DEL delete, ESC exit) ${chalk.cyan(`[D] ${folderDisplayName}`)}`);
         // Enter folder.
         pathHistory.push(result.value);
         break;
@@ -279,6 +355,27 @@ const command = {
         }
         break;
       }
+      //
+      case "createFolder": {
+        // Create folder.
+        const folderName = await promptFolderName();
+        if (folderName) {
+          const remotePath = currentPath + folderName + "/";
+          //
+          process.stdout.write(chalk.yellow(`\n⏳ Creating folder ${folderName}...`));
+          try {
+            await storage.createFolder(bucketName, remotePath);
+            // Clear the "Creating..." line.
+            process.stdout.write("\x1b[2K\x1b[G");
+            operationLogs.push({ type: "success", message: `Folder created: ${folderName} at ${bucketName}:${currentPath || "/"}` });
+          } catch (err) {
+            // Clear the "Creating..." line.
+            process.stdout.write("\x1b[2K\x1b[G");
+            operationLogs.push({ type: "error", message: `Create folder failed: ${folderName} - ${err.message}` });
+          }
+        }
+        break;
+      }
       }
     }
   }

package/gcpUtils.js

@@ -6,8 +6,10 @@ const { isLocalMode, getConfigurationsDir } = require("./utils/paths.js");
 const { listConfigurations } = require("./utils/configLoader.js");
 const commands = require("./commands/index.js");
 const ListWithEscapePrompt = require("./utils/prompts/listWithEscape.js");
+const { checkForUpdates } = require("./utils/updateChecker.js");
 //
 const packageJson = require("./package.json");
+const boxWidth = 55;
 //
 // Register custom prompt with ESC support.
 inquirer.registerPrompt("listWithEscape", ListWithEscapePrompt);
@@ -109,18 +111,36 @@ async function waitForKeypress() {
 function showBanner() {
   const mode = isLocalMode() ? "local" : "global";
   console.log(
-    `=================================================
-${chalk.hex("#FFFFFF")("   █     █    ")} |
-${chalk.hex("#ffff00")("    █   █     ")} |
-${chalk.hex("#fffF00")("   ███████    ")} |    ${chalk.hex("#F77B00").bold("GCP Utils")} ${chalk.gray(`v${packageJson.version}`)}
-${chalk.hex("#FFCE00")(" ███  █  ███  ")} |    by ${chalk.whiteBright.bold("8BitsApps")}
-${chalk.hex("#FFCE00")("█████████████ ")} |
-${chalk.hex("#F77B00")("█  ███████  █ ")} |    ${chalk.bgHex("#FFCE00").hex("#000000")("We made app for fun! (ツ)")}
-${chalk.hex("#F77B00")("█  ███████  █ ")} |    ${chalk.hex("#FFCE00")("https://8bitsapps.com")}
-${chalk.hex("#E73100")("    █   █     ")} |
-${chalk.hex("#E73100")("   ██   ██    ")} |    ${chalk.gray(`Mode:${mode}`)}
-_________________________________________________
-`);
+    `${chalk.hex("#F77B00")("=".repeat(boxWidth))}
+${chalk.hex("#FFFFFF")("       █     █    ")}   |
+${chalk.hex("#ffff00")("        █   █     ")}   |
+${chalk.hex("#fffF00")("       ███████    ")}   |    ${chalk.hex("#F77B00").bold("GCP Utils")} ${chalk.gray(`v${packageJson.version}`)}
+${chalk.hex("#FFCE00")("     ███  █  ███  ")}   |    by ${chalk.whiteBright.bold("8BitsApps")}
+${chalk.hex("#FFCE00")("    █████████████ ")}   |
+${chalk.hex("#F77B00")("    █  ███████  █ ")}   |    ${chalk.bgHex("#FFCE00").hex("#000000")("We make app for fun! (ツ)")}
+${chalk.hex("#F77B00")("    █  ███████  █ ")}   |    ${chalk.hex("#FFCE00")("https://8bitsapps.com")}
+${chalk.hex("#E73100")("        █   █     ")}   |
+${chalk.hex("#E73100")("       ██   ██    ")}   |    ${chalk.gray(`Mode:${mode}`)}
+${chalk.hex("#F77B00")("_".repeat(boxWidth))}\n`);
+}
+//
+/**
+ * Shows update notification if a new version is available.
+ * @param {{available: boolean, current: string, latest: string}|null} updateInfo
+ */
+function showUpdateNotification(updateInfo) {
+  if (!updateInfo || !updateInfo.available) {
+    return;
+  }
+  //
+  const msg = `Update available: ${updateInfo.current} → ${updateInfo.latest}`;
+  const cmd = `npm install -g ${packageJson.name}`;
+  const sudoWrn = "(sudo might be required)";
+  //
+  console.log(chalk.white(`  ${msg}`));
+  console.log(chalk.gray(`  Run: ${chalk.cyan(cmd)}`));
+  console.log(chalk.gray(`       ${chalk.cyan(sudoWrn)}`));
+  console.log(chalk.hex("#FFCE00")("_".repeat(boxWidth) + "\n"));
 }
 //
 /**
@@ -128,6 +148,10 @@ _________________________________________________
  */
 async function main() {
   console.clear();
+  //
+  // Start update check in background (non-blocking).
+  const updateCheckPromise = checkForUpdates();
+  //
   // Check if initialized.
   if (!(await isInitialized())) {
     console.log(chalk.yellow("Configuration not found."));
@@ -147,9 +171,27 @@ async function main() {
     return;
   }
   //
+  // Wait for update check with timeout (max 2s).
+  let updateInfo = null;
+  try {
+    updateInfo = await Promise.race([
+      updateCheckPromise,
+      new Promise(resolve => setTimeout(() => resolve(null), 2000))
+    ]);
+  } catch {
+    // Ignore errors.
+  }
+  //
   while (true) {
     console.clear();
     showBanner();
+    //
+    // Show update notification only on first iteration.
+    if (updateInfo) {
+      showUpdateNotification(updateInfo);
+      updateInfo = null;
+    }
+    //
     const cmdName = await showMainMenu();
     //
     // ESC pressed in main menu - exit.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "8bitsapps-gcp-utils",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "description": "GCP Utility CLI for firewall and storage operations",
   "main": "gcpUtils.js",
   "bin": {

package/utils/prompts/listWithEscape.js

@@ -39,6 +39,24 @@ class ListWithEscapePrompt extends ListPrompt {
         });
     }
     //
+    // Handle delete key - delete selected item (only if deleteFilter allows).
+    events.keypress
+      .pipe(
+        takeUntil(events.line),
+        filter(({ key }) => key && key.name === "delete")
+      )
+      .forEach(() => {
+        const selectedValue = this.opt.choices.getChoice(this.selected).value;
+        // Check if delete is allowed for this item.
+        const deleteFilter = this.opt.deleteFilter;
+        if (deleteFilter && !deleteFilter(selectedValue)) {
+          return; // Ignore delete key for this item.
+        }
+        process.stdout.write(`\x1b[${(this.screen.height || 1) - 1}A\x1b[J\x1b[G`);
+        this.screen.done();
+        this.done({ action: "delete", value: selectedValue });
+      });
+    //
     return super._run(cb);
   }
 }

package/utils/updateChecker.js

@@ -0,0 +1,66 @@
+const axios = require("axios");
+const packageJson = require("../package.json");
+//
+const NPM_REGISTRY_URL = "https://registry.npmjs.org";
+const PACKAGE_NAME = packageJson.name;
+const CURRENT_VERSION = packageJson.version;
+//
+/**
+ * Compares two semver versions.
+ * @param {string} current - Current version.
+ * @param {string} latest - Latest version from registry.
+ * @returns {boolean} True if latest is newer than current.
+ */
+function isNewerVersion(current, latest) {
+  const currentParts = current.split(".").map(Number);
+  const latestParts = latest.split(".").map(Number);
+  //
+  for (let i = 0; i < 3; i++) {
+    if (latestParts[i] > currentParts[i]) return true;
+    if (latestParts[i] < currentParts[i]) return false;
+  }
+  return false;
+}
+//
+/**
+ * Fetches the latest version from npm registry.
+ * @returns {Promise<string|null>} Latest version or null on error.
+ */
+async function fetchLatestVersion() {
+  try {
+    const url = `${NPM_REGISTRY_URL}/${PACKAGE_NAME}/latest`;
+    const response = await axios.get(url, { timeout: 3000 });
+    return response.data.version || null;
+  } catch {
+    // Silently fail - network issues should not block the CLI.
+    return null;
+  }
+}
+//
+/**
+ * Checks for updates and returns update info.
+ * @returns {Promise<{available: boolean, current: string, latest: string}|null>}
+ */
+async function checkForUpdates() {
+  const latestVersion = await fetchLatestVersion();
+  //
+  if (!latestVersion) {
+    return null;
+  }
+  //
+  const updateAvailable = isNewerVersion(CURRENT_VERSION, latestVersion);
+  //
+  return {
+    available: updateAvailable,
+    current: CURRENT_VERSION,
+    latest: latestVersion
+  };
+}
+//
+module.exports = {
+  checkForUpdates,
+  isNewerVersion,
+  fetchLatestVersion,
+  CURRENT_VERSION,
+  PACKAGE_NAME
+};