enver-cli 1.0.0

package/README.md

@@ -0,0 +1,114 @@
+# 🔐 Enver
+
+**Enver** is a secure, cloud-native CLI tool for managing environment variables. It seamlessly integrates with **Google Drive** to provide encrypted backups, versioning, and smart restoration for your local `.env` files.
+
+---
+
+## ✨ Key Features
+
+- **🛡️ AES-256-CBC Encryption**: All environment files are encrypted locally with a developer-defined password BEFORE they touch the cloud.
+- **☁️ Google Drive Integration**: Uses your personal or workspace Google Drive as a reliable, zero-cost backup solution.
+- **🚀 Advanced Restoration**:
+  - **Interactive Diff**: Preview line-by-line changes before restoring.
+  - **Smart Selection**: Choose between specific versions or instantly grab the latest backup.
+- **📁 Automated Organization**:
+  - Automatically organizes backups by `project-name` and `version` (from `package.json`).
+  - **Auto-Prunning**: Keeps only the last 5 backups per version to optimize storage.
+- **⚙️ Configurable Security**: Enable/disable encryption or set a global default password for seamless automation.
+
+---
+
+## 🛠️ Getting Started
+
+### 1. Installation
+
+Clone the repository and install dependencies:
+
+```bash
+git clone <your-repo-url>
+cd Enver
+npm install
+npm run build
+```
+
+### 2. Authentication
+
+Link your Google account to authorize Drive access:
+
+```bash
+enver login
+```
+
+_This will open a browser window for Secure OAuth2 authentication._
+
+### 3. (Optional) Configuration
+
+Set a global encryption password so you don't get prompted every time:
+
+```bash
+enver config password
+```
+
+---
+
+## 🚀 Usage
+
+### Backup your Environment
+
+Create an encrypted backup of your current `.env` file:
+
+```bash
+enver push
+```
+
+_The tool automatically detects your project name and version from `package.json`._
+
+### Restore your Environment
+
+Pull a backup back from Google Drive:
+
+```bash
+enver pull
+```
+
+_You can choose a specific backup or use `enver pull --latest` to skip selection._
+
+### Toggle Encryption
+
+If you are working in a safe local environment, you can disable encryption:
+
+```bash
+enver config encryption true/false
+```
+
+---
+
+## 📁 Storage Architecture
+
+Enver creates a structured hierarchy in your Google Drive:
+
+```text
+Google Drive
+└── Enver (Root Namespace)
+    └── [project-name]-[v1.0.0]
+        ├── [project]_.env_2026-02-10_02-46-20.enc
+        └── [project]_.env_2026-02-11_10-00-00.enc
+```
+
+---
+
+## 🔒 Security Principles
+
+1.  **Zero-Knowledge**: Your encryption password is never sent to Google and never stored on our servers.
+2.  **Local Encryption**: The CLI encrypts the payload in-memory before transmission.
+3.  **Secure Config**: Local configurations (including tokens) are stored in your home directory (`~/.enver/`) with restricted permissions.
+
+---
+
+## 🤝 Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## 📄 License
+
+MIT © 2026

package/bin/index.ts

@@ -0,0 +1,155 @@
+#!/usr/bin/env node
+
+import { Command } from 'commander';
+import dotenv from 'dotenv';
+import inquirer from 'inquirer';
+import chalk from 'chalk';
+import { getAuthenticatedClient, logout } from '../src/auth';
+import { uploadEnv, downloadEnv } from '../src/drive';
+import { setPassword, setEncryption, resetConfig } from '../src/config';
+
+dotenv.config();
+
+const program = new Command();
+
+program
+    .name('enver')
+    .description('Backup and restore your local .env files with encryption and versioning')
+    .version('2.2.0', '-v, -V, --version');
+
+async function runSetup() {
+    console.log(chalk.blue('\n--- Initial Setup ---'));
+
+    const { encryption } = await inquirer.prompt([{
+        type: 'confirm',
+        name: 'encryption',
+        message: 'Enable encryption globally by default?',
+        default: false,
+    }]);
+
+    await setEncryption(encryption);
+
+    const { setPass } = await inquirer.prompt([{
+        type: 'confirm',
+        name: 'setPass',
+        message: 'Set a default encryption password now? (saves you from manual prompts)',
+        default: false,
+    }]);
+
+    if (setPass) {
+        const { password } = await inquirer.prompt([{
+            type: 'password',
+            name: 'password',
+            message: 'Enter your default password:',
+            mask: '*',
+        }]);
+        await setPassword(password);
+    }
+
+    console.log(chalk.green('\nSetup complete! You can change these anytime using "enver config".\n'));
+}
+
+program
+    .command('login')
+    .description('Authenticate with your Google account and run setup')
+    .action(async () => {
+        try {
+            await getAuthenticatedClient();
+            console.log(chalk.green('Successfully authenticated!'));
+            await runSetup();
+        } catch (error: any) {
+            console.error(chalk.red('Authentication failed:'), error.message);
+        }
+    });
+
+program
+    .command('logout')
+    .description('Sign out and remove authentication tokens')
+    .action(async () => {
+        await logout();
+        console.log(chalk.yellow('Successfully logged out. Credentials removed locally.'));
+    });
+
+program
+    .command('push')
+    .description('Upload local .env (encrypted) to Google Drive')
+    .option('-f, --file <filename>', 'Local filename to backup (default: .env)')
+    .action(async (options) => {
+        await uploadEnv({ file: options.file });
+    });
+
+program
+    .command('pull')
+    .description('Restore .env from Google Drive with diff preview')
+    .option('-f, --file <filename>', 'Local filename to restore to (default: .env)')
+    .option('-n, --name <project>', 'Specific project folder name')
+    .option('-l, --latest', 'Automatically pick the latest backup')
+    .action(async (options) => {
+        await downloadEnv({
+            file: options.file,
+            name: options.name,
+            latest: options.latest
+        });
+    });
+
+const config = program.command('config').description('Manage CLI configuration');
+
+config
+    .command('password')
+    .description('Set, update, or remove the default encryption password')
+    .action(async () => {
+        const { action } = await inquirer.prompt([{
+            type: 'list',
+            name: 'action',
+            message: 'What would you like to do?',
+            choices: ['Set/Update Password', 'Remove Password', 'Cancel'],
+        }]);
+
+        if (action === 'Set/Update Password') {
+            const { password } = await inquirer.prompt([{
+                type: 'password',
+                name: 'password',
+                message: 'Enter new default password:',
+                mask: '*',
+            }]);
+            await setPassword(password);
+            console.log(chalk.green('Default password updated!'));
+        } else if (action === 'Remove Password') {
+            await setPassword(undefined);
+            console.log(chalk.yellow('Default password removed. You will be prompted manually for future operations.'));
+        }
+    });
+
+config
+    .command('encryption <state>')
+    .description('Enable or disable encryption globally (on|off)')
+    .action(async (state) => {
+        if (state === 'on') {
+            await setEncryption(true);
+            console.log(chalk.green('Encryption enabled! Local files will be encrypted before upload.'));
+        } else if (state === 'off') {
+            await setEncryption(false);
+            console.log(chalk.yellow('Encryption disabled! Backups will be stored as plain text.'));
+        } else {
+            console.error(chalk.red('Invalid state. Use "on" or "off".'));
+        }
+    });
+
+config
+    .command('reset')
+    .description('Reset all global configurations to factory defaults')
+    .action(async () => {
+        const { confirm } = await inquirer.prompt([{
+            type: 'confirm',
+            name: 'confirm',
+            message: chalk.red('Are you sure you want to reset all configurations? This cannot be undone.'),
+            default: false,
+        }]);
+
+        if (confirm) {
+            await resetConfig();
+            console.log(chalk.green('Configuration reset successfully! Settings are back to factory defaults.'));
+        }
+    });
+
+program.parse(process.argv);

package/dist/bin/index.js

@@ -0,0 +1,143 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const dotenv_1 = __importDefault(require("dotenv"));
+const inquirer_1 = __importDefault(require("inquirer"));
+const chalk_1 = __importDefault(require("chalk"));
+const auth_1 = require("../src/auth");
+const drive_1 = require("../src/drive");
+const config_1 = require("../src/config");
+dotenv_1.default.config();
+const program = new commander_1.Command();
+program
+    .name('enver')
+    .description('Backup and restore your local .env files with encryption and versioning')
+    .version('2.2.0', '-v, -V, --version');
+async function runSetup() {
+    console.log(chalk_1.default.blue('\n--- Initial Setup ---'));
+    const { encryption } = await inquirer_1.default.prompt([{
+            type: 'confirm',
+            name: 'encryption',
+            message: 'Enable encryption globally by default?',
+            default: false,
+        }]);
+    await (0, config_1.setEncryption)(encryption);
+    const { setPass } = await inquirer_1.default.prompt([{
+            type: 'confirm',
+            name: 'setPass',
+            message: 'Set a default encryption password now? (saves you from manual prompts)',
+            default: false,
+        }]);
+    if (setPass) {
+        const { password } = await inquirer_1.default.prompt([{
+                type: 'password',
+                name: 'password',
+                message: 'Enter your default password:',
+                mask: '*',
+            }]);
+        await (0, config_1.setPassword)(password);
+    }
+    console.log(chalk_1.default.green('\nSetup complete! You can change these anytime using "enver config".\n'));
+}
+program
+    .command('login')
+    .description('Authenticate with your Google account and run setup')
+    .action(async () => {
+    try {
+        await (0, auth_1.getAuthenticatedClient)();
+        console.log(chalk_1.default.green('Successfully authenticated!'));
+        await runSetup();
+    }
+    catch (error) {
+        console.error(chalk_1.default.red('Authentication failed:'), error.message);
+    }
+});
+program
+    .command('logout')
+    .description('Sign out and remove authentication tokens')
+    .action(async () => {
+    await (0, auth_1.logout)();
+    console.log(chalk_1.default.yellow('Successfully logged out. Credentials removed locally.'));
+});
+program
+    .command('push')
+    .description('Upload local .env (encrypted) to Google Drive')
+    .option('-f, --file <filename>', 'Local filename to backup (default: .env)')
+    .action(async (options) => {
+    await (0, drive_1.uploadEnv)({ file: options.file });
+});
+program
+    .command('pull')
+    .description('Restore .env from Google Drive with diff preview')
+    .option('-f, --file <filename>', 'Local filename to restore to (default: .env)')
+    .option('-n, --name <project>', 'Specific project folder name')
+    .option('-l, --latest', 'Automatically pick the latest backup')
+    .action(async (options) => {
+    await (0, drive_1.downloadEnv)({
+        file: options.file,
+        name: options.name,
+        latest: options.latest
+    });
+});
+const config = program.command('config').description('Manage CLI configuration');
+config
+    .command('password')
+    .description('Set, update, or remove the default encryption password')
+    .action(async () => {
+    const { action } = await inquirer_1.default.prompt([{
+            type: 'list',
+            name: 'action',
+            message: 'What would you like to do?',
+            choices: ['Set/Update Password', 'Remove Password', 'Cancel'],
+        }]);
+    if (action === 'Set/Update Password') {
+        const { password } = await inquirer_1.default.prompt([{
+                type: 'password',
+                name: 'password',
+                message: 'Enter new default password:',
+                mask: '*',
+            }]);
+        await (0, config_1.setPassword)(password);
+        console.log(chalk_1.default.green('Default password updated!'));
+    }
+    else if (action === 'Remove Password') {
+        await (0, config_1.setPassword)(undefined);
+        console.log(chalk_1.default.yellow('Default password removed. You will be prompted manually for future operations.'));
+    }
+});
+config
+    .command('encryption <state>')
+    .description('Enable or disable encryption globally (on|off)')
+    .action(async (state) => {
+    if (state === 'on') {
+        await (0, config_1.setEncryption)(true);
+        console.log(chalk_1.default.green('Encryption enabled! Local files will be encrypted before upload.'));
+    }
+    else if (state === 'off') {
+        await (0, config_1.setEncryption)(false);
+        console.log(chalk_1.default.yellow('Encryption disabled! Backups will be stored as plain text.'));
+    }
+    else {
+        console.error(chalk_1.default.red('Invalid state. Use "on" or "off".'));
+    }
+});
+config
+    .command('reset')
+    .description('Reset all global configurations to factory defaults')
+    .action(async () => {
+    const { confirm } = await inquirer_1.default.prompt([{
+            type: 'confirm',
+            name: 'confirm',
+            message: chalk_1.default.red('Are you sure you want to reset all configurations? This cannot be undone.'),
+            default: false,
+        }]);
+    if (confirm) {
+        await (0, config_1.resetConfig)();
+        console.log(chalk_1.default.green('Configuration reset successfully! Settings are back to factory defaults.'));
+    }
+});
+program.parse(process.argv);

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "enver-cli",
+  "version": "1.0.0",
+  "description": "A CLI tool to backup and restore .env files using Google Drive",
+  "main": "dist/bin/index.js",
+  "bin": {
+    "enver": "./dist/bin/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/bin/index.js",
+    "dev": "ts-node bin/index.ts"
+  },
+  "keywords": [
+    "cli",
+    "env",
+    "google-drive",
+    "backup",
+    "enver",
+    "env-manager",
+    "env-manager-cli",
+    "enver-cli"
+  ],
+  "author": "",
+  "license": "ISC",
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "commander": "^11.1.0",
+    "diff": "^5.2.0",
+    "dotenv": "^16.4.1",
+    "fs-extra": "^11.2.0",
+    "googleapis": "^131.0.0",
+    "inquirer": "^8.2.6",
+    "open": "^8.4.2",
+    "ora": "^5.4.1"
+  },
+  "devDependencies": {
+    "@types/diff": "^5.0.9",
+    "@types/fs-extra": "^11.0.4",
+    "@types/inquirer": "^8.2.10",
+    "@types/node": "^20.11.16",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.3.3"
+  }
+}