Add environment setup script and update README: replace password setup with comprehensive environment setup instructions

Signed-off-by: Shahm Najeeb <Shahm_Najeeb@outlook.com>

Author: DefinetlyNotAI

.gitignore

@@ -18,6 +18,7 @@ yarn-error.log*
 
 # env files
 .env
+scripts/temp.json
 
 # vercel
 .vercel

package.json

@@ -6,7 +6,7 @@
     "build": "next build",
     "dev": "next dev",
     "start": "next start",
-    "setup-password": "node scripts/setup-password.js"
+    "setup-env": "node scripts/setup-env.js"
   },
   "dependencies": {
     "@hookform/resolvers": "^5.2.2",

scripts/README.md

@@ -1,8 +1,30 @@
-# Password Setup Script
+# Environment Setup Scripts
 
 ## Quick Start
 
-Run the interactive password setup:
+### Complete Environment Setup (Recommended)
+
+Run the interactive environment setup that handles everything:
+
+```bash
+npm run setup-env
+```
+
+Or directly:
+
+```bash
+node scripts/setup-env.js
+```
+
+This will set up:
+
+- SESSION_SECRET (auto-generated)
+- MASTER_PASSWORD_BCRYPT_HASH (interactive)
+- IMAP_CONFIG (optional, interactive)
+
+### Password-Only Setup
+
+If you only need to update the password:
 
 ```bash
 npm run setup-password
@@ -14,7 +36,58 @@ Or directly:
 node scripts/setup-password.js
 ```
 
-## What It Does
+## setup-env.js - Complete Environment Setup
+
+### What It Does
+
+The script will:
+
+1. ✅ Generate a SESSION_SECRET using `openssl rand -base64 32`
+2. ✅ Ask you to enter your desired master password
+3. ✅ Ask you to confirm the password
+4. ✅ Generate a secure bcrypt hash (using 10 salt rounds) and base64 encode it
+5. ✅ Ask if you want to update the IMAP configuration
+6. ✅ If yes, open the current IMAP config in Notepad for editing
+7. ✅ Wait for you to save and close Notepad
+8. ✅ Convert the edited JSON to base64-encoded single line
+9. ✅ Automatically update the `.env` file with all new values
+10. ✅ Run comprehensive tests to ensure everything works
+
+### IMAP Configuration Editing
+
+When you choose to update the IMAP config:
+
+1. The script decodes the current `IMAP_CONFIG` from base64
+2. Formats it as readable JSON with proper line breaks
+3. Saves it to a temporary `temp.json` file
+4. Opens it in Notepad for you to edit
+5. **You edit, save (Ctrl+S), and close Notepad**
+6. The script validates the JSON
+7. Converts it back to base64 in a single line
+8. Updates the `.env` file
+9. Cleans up the temporary file
+
+### Example IMAP Config Format
+
+```json
+{
+   "accounts": [
+      {
+         "id": "account1",
+         "label": "Account 1",
+         "imap": {
+            "host": "imap.example.com",
+            "port": 993,
+            "secure": true,
+            "user": "user@example.com",
+            "password": "your-password"
+         }
+      }
+   ]
+}
+```
+
+## setup-password.js - Password-Only Setup
 
 The script will:
 
@@ -57,7 +130,7 @@ Step 4: Updating .env file...
 ✓ .env file updated successfully!
 
 Step 5: Testing password verification...
-  ✓ Password verification successful!
+  ✓ Password verification successful!e
   ✓ .env file contains correct hash!
   ✓ Password matches hash from .env!
 
@@ -98,6 +171,8 @@ Step 5: Testing password verification...
 
 ## Related Scripts
 
-- `password_gen.js` - Simple password hash generator (non-interactive)
+- `setup-env.js` - **Recommended**: Complete environment setup (SESSION_SECRET + password + IMAP config)
+- `setup-password.js` - Password-only setup (legacy)
+- `test-password.js` - Test password verification
 - `setup-password.js` - This interactive setup script (recommended)