npm - mailpop - Versions diffs - 1.0.3 → 1.0.5 - Mend

mailpop 1.0.3 → 1.0.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (4) hide show

package/README.md CHANGED Viewed

@@ -91,9 +91,9 @@ RETRY_MAX_DELAY_MS=10000
 ## Installation & Setup
-1. **Clone or Navigate to the project directory**:
+1. **Navigate to the project directory**:
    ```bash
-   cd email-hunter-pro # (Or the directory name mailpop was installed to)
+   cd mailpop
    ```
 2. **Install Node dependencies**:

package/dist/index.js CHANGED Viewed

@@ -5,8 +5,13 @@ import { Crawler } from './crawler.js';
 import { Logger } from './logger.js';
 import pLimit from 'p-limit';
 import fs from 'fs/promises';
+import { readFileSync } from 'fs';
 import path from 'path';
+import { fileURLToPath } from 'url';
 import { normalizeDomain, findWebsiteInRow } from './utils/normalize.js';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(readFileSync(path.resolve(__dirname, '../package.json'), 'utf-8'));
+const version = pkg.version || 'unknown';
 let highestContiguousIndex = -1;
 const completedIndices = new Set();
 let completedUrls = [];
@@ -90,6 +95,10 @@ async function main() {
             config.excludePrefixes = Array.from(new Set([...config.excludePrefixes, ...list]));
             i++;
         }
+        else if (args[i] === '-v' || args[i] === '--version') {
+            process.stdout.write(`mailpop v${version}\n`);
+            process.exit(0);
+        }
         else if (args[i] === '-h' || args[i] === '--help') {
             process.stdout.write(`
 mailpop - CLI Guide
@@ -99,6 +108,7 @@ Options:
   -i, --input <path>     Path to the input CSV file
   -o, --output <path>    Path to the output CSV file
   -e, --exclude <list>   Comma-separated list of email local-parts to exclude
+  -v, --version          Display the version number
   -h, --help             Display this help message
 \n`);
             process.exit(0);
@@ -114,7 +124,7 @@ Options:
     if (positionals.length >= 2) {
         outputPath = path.resolve(positionals[1]);
     }
-    await Logger.info('app-initialize', undefined, undefined, 'Running', `Initializing mailpop (Input: ${path.basename(inputPath)}, Output: ${path.basename(outputPath)})...`);
+    await Logger.intro(version, inputPath, outputPath, config.concurrency, config.excludePrefixes, config.checkpointFile);
     // 1. Extract dynamic headers from the input CSV
     let inputHeaders = [];
     try {
@@ -239,7 +249,7 @@ Options:
         if (!isShuttingDown) {
             await clearCheckpoint(config.checkpointFile);
             const totalDuration = Date.now() - startRunTime;
-            await Logger.info('runner-complete', undefined, totalDuration, 'Success', `Crawl completed successfully. Processed ${processedCount} targets in ${Math.round(totalDuration / 1000)}s.`);
+            await Logger.outro(processedCount, totalDuration, outputPath);
         }
     }
     catch (err) {

package/dist/logger.js CHANGED Viewed

@@ -1,6 +1,20 @@
 import fs from 'fs/promises';
 import path from 'path';
 const LOGS_DIR = path.resolve('logs');
+// ANSI escape codes for styling
+const RESET = '\x1b[0m';
+const BOLD = '\x1b[1m';
+const FG_CYAN = '\x1b[36m';
+const FG_GREEN = '\x1b[32m';
+const FG_RED = '\x1b[31m';
+const FG_YELLOW = '\x1b[33m';
+const FG_MAGENTA = '\x1b[35m';
+const FG_GRAY = '\x1b[90m';
+const FG_WHITE = '\x1b[37m';
+const TEXT_BLACK = '\x1b[30m';
+const BG_CYAN = '\x1b[46m';
+const BG_RED = '\x1b[41m';
+const BG_MAGENTA = '\x1b[45m';
 /**
  * Ensures that the logs directory exists on disk.
  */
@@ -28,6 +42,52 @@ async function writeLog(filename, data) {
     }
 }
 export class Logger {
+    /**
+     * Logs a beautiful intro banner with all configuration settings.
+     */
+    static async intro(version, inputPath, outputPath, concurrency, excludePrefixes, checkpointFile) {
+        const border = `${BOLD}${FG_CYAN}┌────────────────────────────────────────────────────────┐${RESET}`;
+        const title = `${BOLD}${FG_CYAN}│${RESET}   ${BOLD}${FG_MAGENTA}⚡ MAILPOP${RESET} ${FG_GRAY}v${version}${RESET}                                    ${BOLD}${FG_CYAN}│${RESET}`;
+        const desc = `${BOLD}${FG_CYAN}│${RESET}   ${FG_WHITE}Production-Ready Contact Email Scraper${RESET}               ${BOLD}${FG_CYAN}│${RESET}`;
+        const bottom = `${BOLD}${FG_CYAN}└────────────────────────────────────────────────────────┘${RESET}`;
+        const infoLines = [
+            `  ${BOLD}📂 Input CSV:${RESET}     ${FG_GREEN}${inputPath}${RESET}`,
+            `  ${BOLD}📂 Output CSV:${RESET}    ${FG_GREEN}${outputPath}${RESET}`,
+            `  ${BOLD}⚙️ Concurrency:${RESET}   ${FG_CYAN}${concurrency} targets${RESET}`,
+            `  ${BOLD}🚫 Exclusions:${RESET}   ${FG_YELLOW}${excludePrefixes.join(', ') || 'None'}${RESET}`,
+            `  ${BOLD}🔄 Checkpoint:${RESET}   ${FG_GRAY}${checkpointFile}${RESET}`,
+        ];
+        const fullConsoleMsg = `\n${border}\n${title}\n${desc}\n${bottom}\n\n${infoLines.join('\n')}\n\n`;
+        process.stdout.write(fullConsoleMsg);
+        await writeLog('app.log', {
+            timestamp: new Date().toISOString(),
+            level: 'INFO',
+            action: 'app-initialize',
+            message: `Mailpop v${version} initialized. Input: ${inputPath}, Output: ${outputPath}, Concurrency: ${concurrency}, Exclusions: ${excludePrefixes.join(',')}`,
+        });
+    }
+    /**
+     * Logs a beautiful outro banner with summary metrics.
+     */
+    static async outro(processedCount, totalDurationMs, outputPath) {
+        const border = `${BOLD}${FG_GREEN}┌────────────────────────────────────────────────────────┐${RESET}`;
+        const title = `${BOLD}${FG_GREEN}│${RESET}   ${BOLD}${FG_GREEN}🎉 CRAWL COMPLETED SUCCESSFULLY!${RESET}                       ${BOLD}${FG_GREEN}│${RESET}`;
+        const bottom = `${BOLD}${FG_GREEN}└────────────────────────────────────────────────────────┘${RESET}`;
+        const infoLines = [
+            `  ${BOLD}✨ Total Targets:${RESET}  ${FG_CYAN}${processedCount}${RESET}`,
+            `  ${BOLD}⏱️ Time Elapsed:${RESET}   ${FG_CYAN}${(totalDurationMs / 1000).toFixed(1)}s${RESET}`,
+            `  ${BOLD}💾 Output File:${RESET}    ${FG_GREEN}${outputPath}${RESET}`,
+        ];
+        const fullConsoleMsg = `\n${border}\n${title}\n${bottom}\n\n${infoLines.join('\n')}\n\n`;
+        process.stdout.write(fullConsoleMsg);
+        await writeLog('app.log', {
+            timestamp: new Date().toISOString(),
+            level: 'INFO',
+            action: 'runner-complete',
+            duration: totalDurationMs,
+            message: `Crawl completed successfully. Processed ${processedCount} targets in ${(totalDurationMs / 1000).toFixed(1)}s. Output: ${outputPath}`,
+        });
+    }
     /**
      * Logs general information events.
      */
@@ -41,7 +101,12 @@ export class Logger {
             result,
             message,
         };
-        const consoleMsg = `[INFO] ${domain ? `[${domain}] ` : ''}${action}${result ? ` -> ${result}` : ''}${message ? ` | ${message}` : ''}`;
+        const levelTag = `${BOLD}${BG_CYAN}${TEXT_BLACK} INFO ${RESET}`;
+        const domainStr = domain ? ` ${FG_GRAY}[${FG_CYAN}${domain}${FG_GRAY}]${RESET}` : '';
+        const actionStr = ` ${BOLD}${action}${RESET}`;
+        const resultStr = result ? ` -> ${FG_GREEN}${result}${RESET}` : '';
+        const msgStr = message ? ` | ${FG_GRAY}${message}${RESET}` : '';
+        const consoleMsg = `${levelTag}${domainStr}${actionStr}${resultStr}${msgStr}`;
         process.stdout.write(consoleMsg + '\n');
         await writeLog('app.log', entry);
     }
@@ -58,7 +123,11 @@ export class Logger {
             error: errorMsg,
             stack,
         };
-        const consoleMsg = `[ERROR] ${domain ? `[${domain}] ` : ''}${action}${errorMsg ? `: ${errorMsg}` : ''}`;
+        const levelTag = `${BOLD}${BG_RED}${FG_WHITE} ERROR ${RESET}`;
+        const domainStr = domain ? ` ${FG_GRAY}[${FG_RED}${domain}${FG_GRAY}]${RESET}` : '';
+        const actionStr = ` ${BOLD}${action}${RESET}`;
+        const errorStr = errorMsg ? `: ${FG_RED}${errorMsg}${RESET}` : '';
+        const consoleMsg = `${levelTag}${domainStr}${actionStr}${errorStr}`;
         process.stderr.write(consoleMsg + '\n');
         await writeLog('app.log', entry);
         await writeLog('errors.log', entry);
@@ -75,7 +144,11 @@ export class Logger {
             confidenceScore: confidence,
             discoveryMethod: method,
         };
-        const consoleMsg = `[EMAIL] [${domain}] Found ${email} (${method}, confidence: ${confidence}) at ${source}`;
+        const levelTag = `${BOLD}${BG_MAGENTA}${TEXT_BLACK} EMAIL ${RESET}`;
+        const domainStr = ` ${FG_GRAY}[${FG_CYAN}${domain}${FG_GRAY}]${RESET}`;
+        const emailStr = ` Found ${BOLD}${FG_GREEN}${email}${RESET}`;
+        const detailsStr = ` (${FG_YELLOW}${method}${RESET}, confidence: ${BOLD}${confidence}${RESET}) at ${FG_GRAY}${source}${RESET}`;
+        const consoleMsg = `${levelTag}${domainStr}${emailStr}${detailsStr}`;
         process.stdout.write(consoleMsg + '\n');
         await writeLog('discovered-emails.log', entry);
     }

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "mailpop",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "Production-ready public contact email discovery tool from company websites.",
   "type": "module",
   "main": "dist/index.js",