valid-email-checker 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+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,129 @@
+# Valid Email Checker
+
+A comprehensive Node.js library for email validation and verification. Validates email format, detects temporary/disposable email addresses, and identifies spam patterns.
+
+## Installation
+
+```bash
+npm install valid-email-checker
+```
+
+## Features
+
+- ✅ **Email Format Validation** - RFC 5322 compliant email format checking
+- 🚫 **Temporary Email Detection** - Detects 1000+ disposable email domains
+- 🛡️ **Spam Pattern Detection** - Identifies common spam email patterns
+- 🔍 **MX Record Verification** - Optional DNS verification for domain validity
+- ⚡ **Fast & Lightweight** - No external dependencies for core features
+
+## Usage
+
+### Basic Usage
+
+```javascript
+const { 
+  validateEmail, 
+  isTemporaryEmail, 
+  isSpamEmail, 
+  fullValidation 
+} = require('valid-email-checker');
+
+// Validate email format
+const result = validateEmail('user@example.com');
+console.log(result); // { valid: true, email: 'user@example.com' }
+
+// Check for temporary/disposable email
+const isTemp = isTemporaryEmail('user@tempmail.com');
+console.log(isTemp); // { isTemporary: true, domain: 'tempmail.com', reason: 'Known disposable email domain' }
+
+// Check for spam patterns
+const isSpam = isSpamEmail('xxx123@example.com');
+console.log(isSpam); // { isSpam: true, reasons: ['Contains suspicious patterns'] }
+
+// Full validation (combines all checks)
+const fullResult = fullValidation('user@example.com');
+console.log(fullResult);
+// {
+//   valid: true,
+//   email: 'user@example.com',
+//   isTemporary: false,
+//   isSpam: false,
+//   score: 100,
+//   details: { ... }
+// }
+```
+
+### Async Validation with MX Record Check
+
+```javascript
+const { validateEmailAsync } = require('valid-email-checker');
+
+// Validates email and checks if domain has valid MX records
+const result = await validateEmailAsync('user@example.com');
+console.log(result);
+// {
+//   valid: true,
+//   email: 'user@example.com',
+//   hasMxRecords: true,
+//   mxRecords: ['mx1.example.com', 'mx2.example.com']
+// }
+```
+
+### Custom Configuration
+
+```javascript
+const { EmailValidator } = require('valid-email-checker');
+
+const validator = new EmailValidator({
+  allowPlusAddressing: false,  // Reject emails with + addressing
+  checkMxRecords: true,        // Enable MX record checking
+  customTempDomains: ['mytempdomain.com'], // Add custom temp domains
+  customSpamPatterns: [/^test\d+@/i],      // Add custom spam patterns
+});
+
+const result = await validator.validate('user@example.com');
+```
+
+## API Reference
+
+### `validateEmail(email)`
+Validates email format.
+- **Returns:** `{ valid: boolean, email: string, error?: string }`
+
+### `isTemporaryEmail(email)`
+Checks if email is from a disposable/temporary email service.
+- **Returns:** `{ isTemporary: boolean, domain: string, reason?: string }`
+
+### `isSpamEmail(email)`
+Checks if email matches spam patterns.
+- **Returns:** `{ isSpam: boolean, reasons: string[] }`
+
+### `fullValidation(email)`
+Performs complete validation combining all checks.
+- **Returns:** `{ valid: boolean, email: string, isTemporary: boolean, isSpam: boolean, score: number, details: object }`
+
+### `validateEmailAsync(email)`
+Validates email with MX record verification.
+- **Returns:** `Promise<{ valid: boolean, email: string, hasMxRecords: boolean, mxRecords?: string[] }>`
+
+### `EmailValidator` Class
+Create custom validator with specific configuration.
+
+## Score System
+
+The `fullValidation` function returns a score from 0-100:
+- **100**: Perfect - Valid format, not temporary, no spam patterns
+- **70-99**: Good - Valid but has minor concerns
+- **40-69**: Suspicious - May be temporary or has spam patterns
+- **0-39**: Bad - Invalid or highly suspicious
+
+## Documentation
+
+- [API Reference](docs/API.md) - Complete API documentation
+- [Examples](docs/EXAMPLES.md) - Usage examples and recipes
+- [Contributing](CONTRIBUTING.md) - How to contribute
+- [Changelog](CHANGELOG.md) - Version history
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "valid-email-checker",
+  "version": "1.0.0",
+  "description": "Comprehensive email validation library - validates format, detects temporary/disposable emails, and identifies spam patterns",
+  "main": "src/index.js",
+  "types": "src/index.d.ts",
+  "scripts": {
+    "test": "node test/test.js",
+    "lint": "eslint src/"
+  },
+  "keywords": [
+    "email",
+    "validation",
+    "verify",
+    "temporary-email",
+    "disposable-email",
+    "spam",
+    "email-checker",
+    "temp-mail"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": ""
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "files": [
+    "src/"
+  ]
+}