@mohamed1_1ibrahim/dcli 1.0.0 → 1.1.1

package/README.md

@@ -11,11 +11,18 @@
 - **add** — Register a database URI in the auto-ping list (with optional name)
 - **remove** — Remove a database by URI or friendly name
 - **auto-ping** — Schedule `dcli ping` to run automatically on Windows logon
+- **view** — Browse collections and documents in a styled table
+- **show** — Display the auto-ping or auto-clone database list
+- **clone-add** — Register a database URI in the auto-clone list
+- **clone-remove** — Remove a database from the auto-clone list
+- **clone** — Clone a single database by friendly name to JSON
+- **auto-clone** — Clone all databases in the clone list to JSON files
+- **gui** — Launch the web GUI in your browser
 
 ## Installation
 
 ```bash
-npm install -g dcli
+npm install -g @mohamed1_1ibrahim/dcli
 ```
 
 ```bash
@@ -103,17 +110,93 @@ dcli remove dbName                          # remove by friendly name
 
 ### auto-ping
 
-Schedule `dcli ping` to run automatically 5 minutes after Windows logon.
-Requires administrator privileges to create the task.
+Schedule `dcli ping` to run automatically. Requires administrator privileges.
 
 ```bash
-dcli auto-ping           # create the task (run terminal as Admin)
-dcli auto-ping --remove  # remove the task (run terminal as Admin)
+dcli auto-ping                       # ONLOGON, 5 min delay (default)
+dcli auto-ping --remove              # remove the task
+dcli auto-ping --schedule DAILY --at 09:00
+dcli auto-ping --schedule HOURLY --every 2
+dcli auto-ping --schedule ONCE --at 18:00
+dcli auto-ping --schedule ONLOGON --delay 10
 ```
 
-## Config File
+| Option | Description |
+|--------|-------------|
+| `--remove` | Remove the scheduled task |
+| `--schedule <type>` | `ONLOGON`, `DAILY`, `HOURLY`, or `ONCE` (default: `ONLOGON`) |
+| `--at <time>` | Time for `DAILY`/`ONCE` schedules (24h, e.g. `09:00`) |
+| `--every <n>` | Interval in hours for `HOURLY` (default: 1) |
+| `--delay <n>` | Delay in minutes for `ONLOGON` (default: 5) |
+
+### view
+
+Browse collections and documents in a styled table.
+
+```bash
+dcli view "mongodb://localhost:27017/mydb"              # list collections
+dcli view "mongodb://localhost:27017/mydb" users         # browse documents
+dcli view "mongodb://..." users --limit 5
+dcli view "mongodb://..." users --fields name,email --sort name
+dcli view "mongodb://..." users --all --json
+```
+
+| Option | Description |
+|--------|-------------|
+| `--limit <n>` | Maximum documents (default: 10) |
+| `--fields <fields>` | Comma-separated fields to display |
+| `--sort <field>` | Sort ascending by field |
+| `--all` | Show all documents (no limit) |
+| `--json` | Output raw JSON instead of a table |
 
-`~/.dcli/refresh.json`:
+### show
+
+Display the auto-ping or auto-clone database list.
+
+```bash
+dcli show              # show ping list (~/.dcli/refresh.json)
+dcli show --clone      # show clone list (~/.dcli/auto-clone.json)
+```
+
+### clone-add / clone-remove
+
+Manage the auto-clone list (`~/.dcli/auto-clone.json`).
+
+```bash
+dcli clone-add "mongodb://..." -n dbName
+dcli clone-remove dbName
+```
+
+### clone
+
+Clone a single database from the clone list to a JSON file.
+
+```bash
+dcli clone dbName
+dcli clone dbName -o ./backups
+```
+
+### auto-clone
+
+Clone all databases in the clone list to JSON files.
+
+```bash
+dcli auto-clone
+dcli auto-clone -o ./backups
+```
+
+### gui
+
+Launch the web GUI in your browser (port defaults to 3456).
+
+```bash
+dcli gui
+dcli gui -p 8080
+```
+
+## Config Files
+
+**Ping list** — `~/.dcli/refresh.json`:
 
 ```json
 {
@@ -124,7 +207,9 @@ dcli auto-ping --remove  # remove the task (run terminal as Admin)
 }
 ```
 
-Entries can be objects with `uri` and optional `name`, or plain strings (backward compatible).
+**Clone list** — `~/.dcli/auto-clone.json` (same format as above).
+
+Entries can be objects with `uri` and optional `name`, or plain strings (backward compatible). Many commands also accept a **friendly name** in place of a URI (e.g. `dcli ping dbName`).
 
 ## Export Format
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mohamed1_1ibrahim/dcli",
-  "version": "1.0.0",
+  "version": "1.1.1",
   "description": "Database CLI - MongoDB data management tool (export, import, ping, info)",
   "main": "src/main.js",
   "bin": {

package/src/commands/autoClone.js

@@ -0,0 +1,56 @@
+import { writeFile, mkdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { connect, exportDatabase, extractDbName } from '../utils/mongodb.js';
+import { readCloneConfig } from '../utils/cloneConfig.js';
+import { success, error, info, highlight } from '../utils/logger.js';
+
+export async function autoCloneCommand(options) {
+  try {
+    const config = await readCloneConfig();
+    const databases = config.databases;
+
+    if (databases.length === 0) {
+      info('No databases in the clone list. Add some with "dcli clone-add <uri>".');
+      process.exit(0);
+    }
+
+    const outputDir = options.output || process.cwd();
+    await mkdir(outputDir, { recursive: true });
+
+    highlight(`── Auto Clone: ${databases.length} database(s) ──`);
+
+    let cloned = 0;
+    let failed = 0;
+
+    for (const entry of databases) {
+      const label = entry.name || entry.uri;
+      try {
+        info(`Cloning: ${label}`);
+        const client = await connect(entry.uri);
+        const dbName = extractDbName(entry.uri);
+        const data = await exportDatabase(client);
+        await client.close();
+
+        const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+        const fileName = `clone-${timestamp}-${dbName}.json`;
+        const filePath = join(outputDir, fileName);
+        const exportData = {
+          database: dbName,
+          clonedAt: new Date().toISOString(),
+          data,
+        };
+        await writeFile(filePath, JSON.stringify(exportData, null, 2), 'utf-8');
+        success(`Cloned ${label} → ${fileName} (${Object.keys(data).length} collections)`);
+        cloned++;
+      } catch (err) {
+        error(`Failed to clone ${label}: ${err.message}`);
+        failed++;
+      }
+    }
+
+    highlight(`── Done: ${cloned} cloned, ${failed} failed ──`);
+  } catch (err) {
+    error(`Auto-clone failed: ${err.message}`);
+    process.exit(1);
+  }
+}

package/src/commands/autoPing.js

@@ -15,20 +15,52 @@ export async function autoPingCommand(options) {
   }
 
   try {
-    const createCmd = [
-      `schtasks /create`,
-      `/tn "${taskName}"`,
-      `/sc ONLOGON`,
-      `/delay 0000:05`,
-      `/tr "cmd /c dcli ping"`,
-      `/f`,
-    ].join(' ');
+    const schedule = (options.schedule || 'ONLOGON').toUpperCase();
+    const at = options.at;
+    const every = options.every;
+    const delay = options.delay || '5';
+
+    let parts = [`schtasks /create`, `/tn "${taskName}"`, `/f`];
+
+    switch (schedule) {
+      case 'DAILY': {
+        const time = at || '09:00';
+        parts.push(`/sc DAILY`, `/st ${time}`);
+        break;
+      }
+      case 'HOURLY': {
+        const interval = every || '1';
+        parts.push(`/sc HOURLY`, `/mo ${interval}`);
+        break;
+      }
+      case 'ONCE': {
+        const time = at || '09:00';
+        parts.push(`/sc ONCE`, `/st ${time}`);
+        break;
+      }
+      default: {
+        const delayMinutes = Math.max(1, parseInt(delay, 10) || 5);
+        parts.push(`/sc ONLOGON`, `/delay ${String(delayMinutes).padStart(4, '0')}:00`);
+        break;
+      }
+    }
+
+    parts.push(`/tr "cmd /c dcli ping"`);
+    const createCmd = parts.join(' ');
 
     execSync(createCmd, { stdio: 'pipe' });
+
+    const messages = {
+      DAILY: `It will run "dcli ping" daily at ${at || '09:00'}.`,
+      HOURLY: `It will run "dcli ping" every ${every || '1'} hour(s).`,
+      ONCE: `It will run "dcli ping" once at ${at || '09:00'}.`,
+      ONLOGON: `It will run "dcli ping" ${delay ? `${delay} minute(s) after` : ''} you log on.`,
+    };
+
     success(`Task "${taskName}" created successfully.`);
-    info(`It will run "dcli ping" 5 minutes after you log on.`);
+    info(messages[schedule] || messages.ONLOGON);
   } catch (err) {
-    error(`Failed to create task: ${err.message.includes('Access is denied') ? 'Please run as Administrator (right-click terminal → Run as administrator).' : err.message}`);
+    error(`Failed to create task: ${err.message.includes('Access is denied') ? 'Please run as Administrator (right-click terminal \u2192 Run as administrator).' : err.message}`);
     process.exit(1);
   }
 }

package/src/commands/clone.js

@@ -0,0 +1,45 @@
+import { writeFile, mkdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { connect, exportDatabase, extractDbName } from '../utils/mongodb.js';
+import { readCloneConfig } from '../utils/cloneConfig.js';
+import { readConfig } from '../utils/config.js';
+import { success, error, info, highlight } from '../utils/logger.js';
+
+export async function cloneCommand(name, options) {
+  try {
+    const config = await readCloneConfig();
+    const entry = config.databases.find(e => (e.name && e.name === name) || e.uri === name);
+
+    if (!entry) {
+      error(`Database "${name}" not found in clone list.`);
+      info('Use "dcli clone-add <uri> -n <name>" to add it first.');
+      process.exit(1);
+    }
+
+    const uri = typeof entry === 'string' ? entry : entry.uri;
+    const label = entry.name || uri;
+
+    const outputDir = options.output || process.cwd();
+    await mkdir(outputDir, { recursive: true });
+
+    highlight(`Cloning: ${label}`);
+    const client = await connect(uri);
+    const dbName = extractDbName(uri);
+    const data = await exportDatabase(client);
+    await client.close();
+
+    const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+    const fileName = `clone-${timestamp}-${dbName}.json`;
+    const filePath = join(outputDir, fileName);
+    const exportData = {
+      database: dbName,
+      clonedAt: new Date().toISOString(),
+      data,
+    };
+    await writeFile(filePath, JSON.stringify(exportData, null, 2), 'utf-8');
+    success(`Cloned ${label} → ${fileName} (${Object.keys(data).length} collections)`);
+  } catch (err) {
+    error(`Clone failed: ${err.message}`);
+    process.exit(1);
+  }
+}

package/src/commands/cloneAdd.js

@@ -0,0 +1,20 @@
+import { addCloneDatabase } from '../utils/cloneConfig.js';
+import { success, warn, error } from '../utils/logger.js';
+
+export async function cloneAddCommand(uri, options) {
+  try {
+    const name = options.name;
+    const result = await addCloneDatabase(uri, name);
+    const label = name ? `${name} (${uri})` : uri;
+    if (result === 'added') {
+      success(`Database added to clone list: ${label}`);
+    } else if (result === 'updated') {
+      success(`Name updated to "${name}" for ${uri}`);
+    } else {
+      warn(`Database is already in the clone list.`);
+    }
+  } catch (err) {
+    error(`Failed to add database: ${err.message}`);
+    process.exit(1);
+  }
+}

package/src/commands/cloneRemove.js

@@ -0,0 +1,16 @@
+import { removeCloneDatabase } from '../utils/cloneConfig.js';
+import { success, warn, error } from '../utils/logger.js';
+
+export async function cloneRemoveCommand(target) {
+  try {
+    const removed = await removeCloneDatabase(target);
+    if (removed) {
+      success(`Database removed from clone list.`);
+    } else {
+      warn(`No database found matching "${target}" in the clone list.`);
+    }
+  } catch (err) {
+    error(`Failed to remove database: ${err.message}`);
+    process.exit(1);
+  }
+}

package/src/commands/exportCmd.js

@@ -2,6 +2,7 @@ import { writeFile, mkdir, access } from 'node:fs/promises';
 import { join, extname, dirname, basename } from 'node:path';
 import { constants } from 'node:fs';
 import { connect, exportDatabase, extractDbName } from '../utils/mongodb.js';
+import { resolveName } from '../utils/resolve.js';
 import { success, error, info, highlight } from '../utils/logger.js';
 
 function ensureJsonExt(name) {
@@ -50,6 +51,7 @@ async function getUniquePath(filePath) {
 }
 
 export async function exportCommand(uri, options) {
+  uri = await resolveName(uri);
   const dbName = extractDbName(uri);
   const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
   const outputName = options.output || `data-${timestamp}-${dbName}`;