db-data-gd-uploader 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Saud Ahmad
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,276 @@
+# GD Uploader 📦
+
+**Professional Database Backup System with Google Drive Integration**
+
+Export MongoDB/any database to Excel and upload to Google Drive automatically - no manual intervention required!
+
+[![npm version](https://img.shields.io/npm/v/db-data-gd-uploader.svg)](https://npmjs.org/package/db-data-gd-uploader)
+[![Node.js Version](https://img.shields.io/node/v/db-data-gd-uploader.svg)](https://nodejs.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![GitHub](https://img.shields.io/badge/GitHub-Saud--web--dev-blue)](https://github.com/Saud-web-dev/GD-module)
+
+## ✨ Features
+
+- 🗄️ **Multi-Database Support** - Extract from MongoDB, any database with Node drivers
+- 📊 **Excel Export** - Professional formatted Excel files with headers, styling, borders
+- ☁️ **Google Drive Upload** - Automatic upload using Service Account (no OAuth needed)
+- 🔐 **Secure** - Service Account authentication, no personal credentials exposed
+- 🎯 **Zero Config** - Works out of the box with minimal setup
+- ⚡ **Fast** - Streams large datasets efficiently
+- 📅 **Scheduled Backups** - Built-in scheduler for automated backups
+
+## 🚀 Quick Start
+
+### Installation
+
+```bash
+npm install db-data-gd-uploader
+```
+
+### Setup (One-time)
+
+1. **Create Google Cloud Service Account**
+   ```bash
+   # Go to Google Cloud Console
+   # Create service account → Generate JSON key
+   # Save to: config/service-account.json
+   ```
+
+2. **Share Folder with Service Account**
+   - Go to Google Drive
+   - Create folder for backups
+   - Right-click → Share
+   - Add Service Account email: `your-account@project.iam.gserviceaccount.com`
+   - Give Editor permission
+
+3. **Set Environment Variables**
+   ```bash
+   cp .env.example .env
+   ```
+
+   ```env
+   MONGODB_URI=mongodb://localhost:27017/your-db
+   GOOGLE_DRIVE_FOLDER_ID=your-folder-id
+   ```
+
+### Usage
+
+#### Basic Backup
+
+```javascript
+import { createAndUploadCompleteBackup } from 'db-data-gd-uploader'
+
+const result = await createAndUploadCompleteBackup({
+  uploadToDrive: true,
+  workbookName: 'my-backup'
+})
+
+console.log(result)
+// Output:
+// {
+//   uploaded: true,
+//   fileName: 'my-backup.xlsx',
+//   databases: ['stc_db', 'test'],
+//   collections: [...],
+//   totalRecords: 1000,
+//   driveFile: { id: '...', webViewLink: '...' }
+// }
+```
+
+#### Upload Excel to Drive
+
+```javascript
+import { uploadExcelToGoogleDrive } from 'db-data-gd-uploader/drive'
+
+const result = await uploadExcelToGoogleDrive({
+  buffer: excelBuffer,
+  fileName: 'data-export.xlsx',
+  folderId: 'optional-folder-id'
+})
+```
+
+#### Generate Excel
+
+```javascript
+import { createExcelWorkbook } from 'db-data-gd-uploader/excel'
+
+const workbook = await createExcelWorkbook([
+  {
+    modelName: 'users',
+    collectionName: 'users',
+    database: 'mydb',
+    data: [
+      { _id: 1, name: 'John', email: 'john@example.com' },
+      { _id: 2, name: 'Jane', email: 'jane@example.com' }
+    ]
+  }
+], {
+  workbookName: 'users-export'
+})
+```
+
+#### Extract Data from Database
+
+```javascript
+import { extractAllDatabasesCollections } from 'db-data-gd-uploader/extract'
+
+const data = await extractAllDatabasesCollections(
+  'mongodb://localhost:27017/mydb',
+  ['admin', 'config', 'local'] // Excluded databases
+)
+
+console.log(data)
+// [
+//   { database: 'mydb', collectionName: 'users', data: [...] },
+//   { database: 'mydb', collectionName: 'products', data: [...] }
+// ]
+```
+
+## 📋 API Reference
+
+### `createAndUploadCompleteBackup(options)`
+
+Main function - extracts all databases, creates Excel, uploads to Drive.
+
+**Options:**
+- `uploadToDrive` (boolean) - Upload to Google Drive? Default: `true`
+- `workbookName` (string) - Excel file name. Default: `complete-backup-YYYY-MM-DD`
+- `folderId` (string) - Google Drive folder ID. Default: from `.env`
+- `excludedDatabases` (array) - Skip these databases. Default: `['admin', 'config', 'local']`
+
+**Returns:** Promise<Object>
+- `uploaded` (boolean)
+- `fileName` (string)
+- `databases` (array)
+- `collections` (array)
+- `totalRecords` (number)
+- `driveFile` (object) - Google Drive file info
+
+---
+
+### `uploadExcelToGoogleDrive(options)`
+
+Upload Excel file to Google Drive.
+
+**Options:**
+- `buffer` (Buffer) - Excel file buffer **[required]**
+- `fileName` (string) - File name **[required]**
+- `contentType` (string) - MIME type. Default: Excel
+- `folderId` (string) - Google Drive folder ID
+
+**Returns:** Promise<Object>
+- `id` (string) - Google Drive file ID
+- `webViewLink` (string) - Shareable link
+- `status` (string) - 'uploaded' or 'local_only'
+
+---
+
+### `createExcelWorkbook(data, options)`
+
+Create formatted Excel workbook.
+
+**Parameters:**
+- `data` (array) - Collection data with structure: `{ modelName, collectionName, database, data }`
+- `options.workbookName` (string) - Workbook name
+
+**Returns:** Promise<Object>
+- `buffer` (Buffer) - Excel file binary
+- `fileName` (string)
+- `contentType` (string)
+
+---
+
+### `extractAllDatabasesCollections(mongoUri, excludedDatabases)`
+
+Extract all collections from all databases.
+
+**Parameters:**
+- `mongoUri` (string) - MongoDB connection string
+- `excludedDatabases` (array) - Databases to skip
+
+**Returns:** Promise<Array>
+- `[{ database, collectionName, documentCount, data }]`
+
+## 🔧 Environment Variables
+
+```env
+# MongoDB
+MONGODB_URI=mongodb://localhost:27017/mydb
+
+# Google Drive
+GOOGLE_DRIVE_FOLDER_ID=your-folder-id
+
+# Service Account (or use config/service-account.json)
+GOOGLE_SERVICE_ACCOUNT_JSON={"type":"service_account",...}
+
+# Optional: Scheduler settings
+BACKUP_SCHEDULE_TIME=02:00  # 2 AM daily
+```
+
+## 📁 Project Structure
+
+```
+gd-uploader/
+├── src/
+│   ├── index.js                 # Main entry point
+│   ├── services/
+│   │   ├── backupService.js     # Main backup logic
+│   │   ├── googleDrive.js       # Google Drive operations
+│   │   └── googleAuth.js        # Authentication
+│   ├── utils/
+│   │   ├── excelFormatter.js    # Excel generation
+│   │   └── dataExtract.js       # Database extraction
+│   └── scripts/
+│       └── backup.js             # CLI script
+├── config/
+│   └── service-account.json     # Google Service Account
+├── .env.example
+├── package.json
+└── README.md
+```
+
+## 🔐 Security
+
+- ✅ No personal Google credentials stored
+- ✅ Service Account uses read-only for data extraction
+- ✅ All sensitive data in `.env` (not committed)
+- ✅ No hardcoded credentials
+
+## 🐛 Troubleshooting
+
+### "Service Account has no storage quota"
+**Solution:** Use Shared Drive or share personal folder with Service Account email
+
+### "MONGODB_URI is required"
+**Solution:** Set `MONGODB_URI` in `.env` or environment variables
+
+### "Invalid GOOGLE_SERVICE_ACCOUNT_JSON"
+**Solution:** Place valid JSON in `config/service-account.json` or `.env`
+
+## 📦 Publishing to npm
+
+```bash
+# 1. Login to npm
+npm login
+
+# 2. Update version in package.json
+npm version patch  # or minor/major
+
+# 3. Publish
+npm publish
+
+# 4. Check
+npm info gd-uploader
+```
+
+## 📄 License
+
+MIT © [Saud Ahmad]
+
+## 🤝 Contributing
+
+Contributions welcome! Please feel free to submit a Pull Request.
+
+## 📧 Support
+
+For issues and questions: https://github.com/Saud-web-dev/GD-module/issues

package/config/service-account.json

@@ -0,0 +1,13 @@
+{
+  "type": "service_account",
+  "project_id": "gd-uploader-saud",
+  "private_key_id": "f4b306f4f39ddea962be2c18f62754210a881a47",
+  "private_key": "-----BEGIN PRIVATE KEY-----\nMIIEvwIBADANBgkqhkiG9w0BAQEFAASCBKkwggSlAgEAAoIBAQCw6mu1O1DwPkUL\nzgiK/BXB3UbZRqNzERnp5LdeY1TBWknnvm0GnWoNQjFSVKq38KjSG0ekJ4eIYy+N\nqLFd+o460LuYkORBJQSN3OxXQym/aV3e12fcgWyncAKxyF+4KJtMWI7ir2ih9BcS\nkQ+bDX82LGZeG9uCu51FzG5jKFJ/JueTjSG0DZamFvaXZU4P+fYe+m5r4cFMt8yL\nLFbkoh+Pn8yEY2tKKyTdmA4oX74g0cB8JaNo6Y72TgPsX7aVU7MWlB3LCykFRcj3\nkVvsPJZLRiWGPSjM/F4YWE/MltJ4zrvk1rPr8HHpxGwaV3+8ZRj7D1S8f5Mfk6MW\ngSadzunxAgMBAAECggEAA1uGgBpftzqygX57FAZOp4h2O2Mx+UBfzQa6e8L/TSZc\nv2/fCkshoZ4NNeiwtWf1IQ1EFhmvaymU3HzzRD9+CKi37aSbpBdlH/bpSGitmbfd\noqJD1xu2GHr+WhjupS77kalSVBUUd8YcS7hGuGBuXUFV3CWymOMQTBK3csvWipGo\nLsZj3n+FWuasqbHstE7RR8rac+EgMq4PrYfOFlu3on4542HRAiQDUNjbyt6Mt+xZ\ns8B8NoyNlZxD5/26olQrqBQMo5rt87tT+oEE7doxaxqiUyd7eyZEQ7UoQ1Cv+U6/\nxMJVYze7xBJ5qqexJhTl4ANRxT9Qd2dJJcOJzQiKbwKBgQDkfts7Z83krHWld6cV\n9UexJJkqiovE4QRk2mfFq5KrqzBDM+EYlugH2OzNPyrqKyj/Cmjk2hwSxbnkyO38\nZCeylUFVfd/v36nkYUzZ3gR8B9en7OaaEMS4VIgpyPwxrvNlmS0O51Jt0s6k2eib\natCApfXF/eMCdjwF7IchxGx5LwKBgQDGNh6u+WDXx+j+OTFPgANqXGa3ls3BEqsw\nAmGrv2xBIGTkZBbNInV7LaW8cvbSZN+k8Zel30fpHt/JbzjmexqQi8/7qFl7MNun\n45jXjghkJhjvtib/Xt9FCCLXhH7wmGRYzhElJCqF9wjnxBoatdXybV/wnXE+Hxd2\nCHURuBnG3wKBgQDDopmyUz5F/CL+eWPluQyY7uz1L4pcFwzcDOOsqyn5Makw4Mpp\nc0tW7LRTRzJHLIz9ULxetSA0MnbnG+InptkWXhSCTjPd/XJIx8Y1A5JzX4OVk5Ad\neR31dOrgW+UR5Okgo/WgPQ6mWUf0fV5bMykx/OZhju8+vFzH9av9jWASoQKBgQCE\ndR5EJ/sDuGCHo4jEa/PcXCt4fJq7b9JenvjOYXnie9dwmUJzi5ee3X5oVRuEtkyO\nWbTR8EiKDUvXvS/1NkcmWYh/0J0bqibgJ0S4p/4LjzoS11NwTOI/q5Q9GhoKhoxo\nnCzw+R5BsDiPSYl4WBPFkjoO/efzb6uqATTaxoDTWQKBgQC7BMJ4Bq2IQtpZzXp4\nkafOraq47O8xXE5V9jg6wlLEw2zWWK9wRGy+ByC7Cx8H5dGRq8z87lUCAIE4SJnr\n8YUWkWhxcOJ/PIj+qkWZUq3HewjzeZRFFFlIwCYK7qM9yPkrMZWmx6ZIY6ILkgMW\nRux3wxiq+cjEs55QGtxqBgmciA==\n-----END PRIVATE KEY-----\n",
+  "client_email": "gd-uploader@gd-uploader-saud.iam.gserviceaccount.com",
+  "client_id": "111930094607475043849",
+  "auth_uri": "https://accounts.google.com/o/oauth2/auth",
+  "token_uri": "https://oauth2.googleapis.com/token",
+  "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
+  "client_x509_cert_url": "https://www.googleapis.com/robot/v1/metadata/x509/gd-uploader%40gd-uploader-saud.iam.gserviceaccount.com",
+  "universe_domain": "googleapis.com"
+}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "db-data-gd-uploader",
+  "version": "1.0.0",
+  "description": "Professional Database Backup System with Google Drive Integration. Export MongoDB/any database to Excel and upload to Google Drive automatically.",
+  "keywords": [
+    "database",
+    "backup",
+    "google-drive",
+    "mongodb",
+    "excel",
+    "export",
+    "cloud-storage",
+    "db-export",
+    "data-backup"
+  ],
+  "license": "MIT",
+  "author": "Saud Ahmad",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Saud-web-dev/GD-module.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Saud-web-dev/GD-module/issues"
+  },
+  "homepage": "https://github.com/Saud-web-dev/GD-module#readme",
+  "type": "module",
+  "main": "src/index.js",
+  "exports": {
+    ".": "./src/index.js",
+    "./backup": "./src/services/backupService.js",
+    "./drive": "./src/services/googleDrive.js",
+    "./excel": "./src/utils/excelFormatter.js",
+    "./extract": "./src/utils/dataExtract.js"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "scripts": {
+    "start": "node src/server.js",
+    "dev": "nodemon src/server.js",
+    "backup": "node src/scripts/backup.js",
+    "scheduler": "node src/scripts/scheduler.js",
+    "lint": "node --check src/index.js src/services/*.js src/utils/*.js",
+    "test": "node --check src/server.js && node --check src/app.js && node --check src/config/database.js && node --check src/services/backupService.js",
+    "prepublishOnly": "npm run lint && npm run test"
+  },
+  "dependencies": {
+    "cookie-parser": "^1.4.7",
+    "cors": "^2.8.6",
+    "dotenv": "^17.4.2",
+    "exceljs": "^4.4.0",
+    "express": "^5.2.1",
+    "googleapis": "^180.0.0",
+    "jsonwebtoken": "^9.0.3",
+    "mongoose": "^9.10.0"
+  },
+  "devDependencies": {
+    "nodemon": "^3.1.14"
+  },
+  "files": [
+    "src/",
+    "config/",
+    "README.md",
+    "LICENSE"
+  ]
+}

package/src/app.js

@@ -0,0 +1,69 @@
+import cors from 'cors'
+import express from 'express'
+import mongoose from 'mongoose'
+import { join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import config from './config/environment.js'
+import authRoutes from './routes/authRoutes.js'
+import backupRoutes from './routes/backupRoutes.js'
+import { getDatabaseStatus } from './config/database.js'
+
+const __dirname = join(fileURLToPath(import.meta.url), '..')
+
+export function createApp() {
+  const app = express()
+
+  // Middleware
+  app.use(cors({ origin: config.frontendUrl }))
+  app.use(express.json())
+
+  // Health check endpoint
+  app.get('/api/health', (_request, response) => {
+    response.json({
+      ok: true,
+      database: getDatabaseStatus(),
+      environment: config.nodeEnv,
+      timestamp: new Date().toISOString(),
+    })
+  })
+
+  // Routes
+  app.use('/auth', authRoutes)
+  app.use('/api', backupRoutes)
+
+  // Download endpoint
+  app.get('/download/:fileName', (request, response) => {
+    const { fileName } = request.params
+    const filePath = join(__dirname, '..', 'exports', fileName)
+    
+    // Security: prevent path traversal
+    if (!filePath.startsWith(join(__dirname, '..', 'exports'))) {
+      return response.status(400).json({ message: 'Invalid file' })
+    }
+
+    response.download(filePath, fileName, (err) => {
+      if (err) {
+        console.error('Download error:', err)
+        response.status(500).json({ message: 'Download failed' })
+      }
+    })
+  })
+
+  // 404 handler
+  app.use((_request, response) => {
+    response.status(404).json({ message: 'Route not found' })
+  })
+
+  // Error handler
+  app.use((error, _request, response, _next) => {
+    console.error('Server error:', error)
+    response.status(500).json({
+      message: 'Internal server error',
+      error: config.nodeEnv === 'development' ? error.message : undefined,
+    })
+  })
+
+  return app
+}
+
+export default createApp

package/src/config/database.js

@@ -0,0 +1,38 @@
+import mongoose from 'mongoose'
+
+export async function connectDatabase() {
+  if (!process.env.MONGODB_URI) {
+    throw new Error('MONGODB_URI is required')
+  }
+
+  try {
+    await mongoose.connect(process.env.MONGODB_URI, {
+      maxPoolSize: 10,
+      serverSelectionTimeoutMS: 5000,
+    })
+    console.log('✅ MongoDB connected successfully')
+    return mongoose.connection
+  } catch (error) {
+    console.error('❌ MongoDB connection failed:', error.message)
+    throw error
+  }
+}
+
+export async function disconnectDatabase() {
+  try {
+    await mongoose.disconnect()
+    console.log('✅ MongoDB disconnected')
+  } catch (error) {
+    console.error('❌ Disconnect error:', error.message)
+  }
+}
+
+export function getDatabaseStatus() {
+  const states = {
+    0: 'disconnected',
+    1: 'connected',
+    2: 'connecting',
+    3: 'disconnecting',
+  }
+  return states[mongoose.connection.readyState] || 'unknown'
+}

package/src/config/environment.js

@@ -0,0 +1,55 @@
+import dotenv from 'dotenv'
+
+dotenv.config()
+
+export const config = {
+  port: Number(process.env.PORT || 5000),
+  nodeEnv: process.env.NODE_ENV || 'development',
+  mongoUri: process.env.MONGODB_URI,
+  frontendUrl: process.env.FRONTEND_URL || 'http://localhost:5173',
+  
+  // Google OAuth
+  googleOAuth: {
+    clientId: process.env.GOOGLE_OAUTH_CLIENT_ID,
+    clientSecret: process.env.GOOGLE_OAUTH_CLIENT_SECRET,
+    redirectUri: process.env.GOOGLE_OAUTH_REDIRECT_URI,
+  },
+  
+  // Google Drive
+  googleDrive: {
+    folderId: process.env.GOOGLE_DRIVE_FOLDER_ID,
+    tokensPath: process.env.GOOGLE_TOKENS_PATH || './google-tokens.json',
+  },
+  
+  // Backup Configuration
+  backup: {
+    enabled: process.env.ENABLE_AUTO_BACKUP === 'true',
+    intervalMinutes: parseInt(process.env.BACKUP_INTERVAL_MINUTES || '60'),
+    excludedDatabases: ['admin', 'config', 'local'],
+  },
+}
+
+// Validate required configuration
+function validateConfig() {
+  const required = ['mongoUri', 'googleOAuth.clientId', 'googleOAuth.clientSecret']
+  const missing = []
+  
+  for (const key of required) {
+    const keys = key.split('.')
+    let value = config
+    for (const k of keys) {
+      value = value?.[k]
+    }
+    if (!value) {
+      missing.push(key)
+    }
+  }
+  
+  if (missing.length > 0) {
+    console.warn(`⚠️  Missing configuration: ${missing.join(', ')}`)
+  }
+}
+
+validateConfig()
+
+export default config

package/src/index.js

@@ -0,0 +1,14 @@
+/**
+ * GD Uploader - Google Drive Backup & Export Module
+ * Complete database backup, Excel generation, and Google Drive upload
+ */
+
+export { createAndUploadCompleteBackup } from './services/backupService.js'
+export { uploadExcelToGoogleDrive, listDriveFiles, deleteOldBackups } from './services/googleDrive.js'
+export { createExcelWorkbook } from './utils/excelFormatter.js'
+export { extractAllDatabasesCollections, extractSpecificDatabases } from './utils/dataExtract.js'
+export { getAuthStatus } from './services/googleAuth.js'
+
+// Version info
+export const version = '1.0.0'
+export const name = 'gd-uploader'

package/src/routes/authRoutes.js

@@ -0,0 +1,15 @@
+import express from 'express'
+
+const router = express.Router()
+
+/**
+ * Health check endpoint
+ */
+router.get('/status', (_request, response) => {
+  response.json({ 
+    message: 'Service Account authentication enabled',
+    authenticated: true 
+  })
+})
+
+export default router

package/src/routes/backupRoutes.js

@@ -0,0 +1,38 @@
+import express from 'express'
+import mongoose from 'mongoose'
+import { createAndUploadCompleteBackup } from '../services/backupService.js'
+import { getBackupStatus } from '../services/backupScheduler.js'
+
+const router = express.Router()
+
+/**
+ * Complete backup - Extract ALL databases and collections
+ * Direct upload to Google Drive (Service Account)
+ */
+router.post('/exports', async (request, response) => {
+  try {
+    if (mongoose.connection.readyState !== 1) {
+      return response.status(503).json({ message: 'Database is not connected' })
+    }
+
+    const result = await createAndUploadCompleteBackup({
+      uploadToDrive: true,
+      workbookName: request.body?.workbookName,
+      folderId: request.body?.folderId,
+      excludedDatabases: request.body?.excludedDatabases || ['admin', 'config', 'local'],
+    })
+    return response.status(201).json({ message: 'Backup created and uploaded successfully', ...result })
+  } catch (error) {
+    console.error('Backup failed:', error)
+    return response.status(500).json({ message: error.message || 'Backup failed' })
+  }
+})
+
+/**
+ * Get backup status
+ */
+router.get('/backup/status', (_request, response) => {
+  response.json(getBackupStatus())
+})
+
+export default router

package/src/scripts/backup.js

@@ -0,0 +1,44 @@
+import '../config/environment.js'
+import { connectDatabase, disconnectDatabase } from '../config/database.js'
+import { createAndUploadCompleteBackup } from '../services/backupService.js'
+
+async function runBackup() {
+  try {
+    console.log('🚀 Starting manual backup...')
+    console.log(`⏰ ${new Date().toLocaleString()}`)
+    console.log('─'.repeat(50))
+
+    await connectDatabase()
+
+    const result = await createAndUploadCompleteBackup({
+      uploadToDrive: true,
+      excludedDatabases: ['admin', 'config', 'local'],
+    })
+
+    console.log('─'.repeat(50))
+    console.log('\n📊 BACKUP SUMMARY:')
+    console.log(`  Databases: ${result.databases.join(', ')}`)
+    console.log(`  Collections: ${result.collections.length}`)
+    console.log(`  Total Records: ${result.totalRecords}`)
+    console.log(`  File Name: ${result.fileName}`)
+    console.log(`  Upload Status: ${result.uploadStatus}`)
+
+    if (result.uploaded && result.driveFile) {
+      console.log(`\n✅ Successfully uploaded to Google Drive!`)
+      console.log(`  Link: ${result.driveFile.webViewLink}`)
+    } else if (result.driveFile?.localPath) {
+      console.log(`\n⚠️  File saved locally (Drive upload failed)`)
+      console.log(`  Path: ${result.driveFile.localPath}`)
+    }
+
+    console.log('\n✅ Backup completed successfully!')
+  } catch (error) {
+    console.error('\n❌ Backup failed:')
+    console.error(`  Error: ${error.message}`)
+    process.exit(1)
+  } finally {
+    await disconnectDatabase()
+  }
+}
+
+runBackup()

package/src/scripts/scheduler.js

@@ -0,0 +1,15 @@
+import { connectDatabase } from '../config/database.js'
+import config from '../config/environment.js'
+import { startBackupScheduler } from '../services/backupScheduler.js'
+
+async function startScheduler() {
+  try {
+    await connectDatabase()
+    startBackupScheduler(config.backup.intervalMinutes)
+  } catch (error) {
+    console.error('❌ Scheduler startup failed:', error.message)
+    process.exit(1)
+  }
+}
+
+startScheduler()