mailpop 1.0.4 → 1.0.6

package/README.md

@@ -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/config.js

@@ -1,7 +1,15 @@
 import dotenv from 'dotenv';
 import path from 'path';
-// Load environment variables from .env
+import { existsSync } from 'fs';
+import { fileURLToPath } from 'url';
+// 1. Load environment variables from CWD .env (if present)
 dotenv.config();
+// 2. Load from package directory .env as a fallback for defaults
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const packageEnv = path.resolve(__dirname, '../.env');
+if (existsSync(packageEnv)) {
+    dotenv.config({ path: packageEnv });
+}
 const getEnvNumber = (key, defaultValue) => {
     const val = process.env[key];
     if (val === undefined)

package/dist/index.js

@@ -124,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 {
@@ -249,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

@@ -8,12 +8,13 @@ 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_GREEN = '\x1b[42m';
 const BG_RED = '\x1b[41m';
+const BG_MAGENTA = '\x1b[45m';
 /**
  * Ensures that the logs directory exists on disk.
  */
@@ -41,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.
      */
@@ -97,7 +144,7 @@ export class Logger {
             confidenceScore: confidence,
             discoveryMethod: method,
         };
-        const levelTag = `${BOLD}${BG_GREEN}${TEXT_BLACK} EMAIL ${RESET}`;
+        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}`;

package/dist/utils/validators.js

@@ -46,8 +46,13 @@ export function isValidEmail(email) {
     if (REJECTED_PREFIXES.includes(localPart)) {
         return false;
     }
-    // Reject user-configured excluded prefixes
-    if (config.excludePrefixes.includes(localPart)) {
+    // Reject user-configured excluded prefixes (matches exact, or delimited by -, ., _, +)
+    const isExcluded = config.excludePrefixes.some((prefix) => {
+        const escaped = prefix.replace(/[-\\^$*+?.()|[\]{}]/g, '\\$&');
+        const regex = new RegExp(`(^|[-._+])` + escaped + `($|[-._+])`, 'i');
+        return regex.test(localPart);
+    });
+    if (isExcluded) {
         return false;
     }
     // Reject blacklisted domains

package/package.json

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