@emailverifier/sdk 0.1.1

package/dist/cjs/role-addresses.js

@@ -0,0 +1,292 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.roleLocalParts = void 0;
+exports.roleLocalParts = new Set([
+    'abuse',
+    'access',
+    'account',
+    'accounting',
+    'accounts',
+    'ap',
+    'accountspayable',
+    'accountsreceivable',
+    'ar',
+    'affiliate',
+    'affiliates',
+    'ambassador',
+    'ambassadors',
+    'admin',
+    'adminteam',
+    'administration',
+    'ads',
+    'advertising',
+    'academy',
+    'alerts',
+    'all',
+    'api',
+    'appointments',
+    'autoreply',
+    'autoresponder',
+    'automated',
+    'automation',
+    'audit',
+    'benefits',
+    'beta',
+    'betatest',
+    'betatesters',
+    'billing',
+    'bursar',
+    'bizdev',
+    'bookings',
+    'businessdevelopment',
+    'campaigns',
+    'bounce',
+    'bounces',
+    'brand',
+    'branding',
+    'careers',
+    'channel',
+    'clients',
+    'clientcare',
+    'clientrelations',
+    'clientservice',
+    'clientservices',
+    'clientsuccess',
+    'chargebacks',
+    'claims',
+    'collections',
+    'compliance',
+    'complianceteam',
+    'contact',
+    'contactus',
+    'contract',
+    'contracting',
+    'contracts',
+    'community',
+    'communications',
+    'comms',
+    'content',
+    'concierge',
+    'controller',
+    'counsel',
+    'ceo',
+    'cfo',
+    'coo',
+    'creator',
+    'creators',
+    'cto',
+    'customercare',
+    'customerengagement',
+    'customerhelp',
+    'customersupport',
+    'customerservice',
+    'customersuccess',
+    'customerexperience',
+    'customerrelations',
+    'cx',
+    'data',
+    'dataprotection',
+    'deliverability',
+    'delivery',
+    'dispatch',
+    'disputes',
+    'admissions',
+    'alumni',
+    'developers',
+    'devops',
+    'dns',
+    'donations',
+    'donotreply',
+    'donotrespond',
+    'dpo',
+    'editor',
+    'editorial',
+    'email',
+    'enablement',
+    'engineering',
+    'enquiries',
+    'enquiry',
+    'ecommerce',
+    'escalation',
+    'escalations',
+    'events',
+    'everyone',
+    'facilities',
+    'financialaid',
+    'fulfillment',
+    'finance',
+    'founder',
+    'founders',
+    'feedback',
+    'fundraising',
+    'giving',
+    'grant',
+    'grants',
+    'fraud',
+    'frontdesk',
+    'gdpr',
+    'growth',
+    'hello',
+    'help',
+    'helpcenter',
+    'helpdesk',
+    'hostmaster',
+    'hr',
+    'identity',
+    'info',
+    'invoices',
+    'insurance',
+    'infosec',
+    'incident',
+    'incidentresponse',
+    'incidents',
+    'inventory',
+    'investorrelations',
+    'investors',
+    'it',
+    'jobs',
+    'legal',
+    'legalteam',
+    'leasing',
+    'leadership',
+    'learning',
+    'leads',
+    'licensing',
+    'list',
+    'mailinglist',
+    'login',
+    'logistics',
+    'mail',
+    'mailerdaemon',
+    'management',
+    'marketing',
+    'media',
+    'medicalrecords',
+    'memberservices',
+    'messages',
+    'network',
+    'newsletter',
+    'noc',
+    'noreply',
+    'no-reply',
+    'noresponse',
+    'notifications',
+    'office',
+    'officeadmin',
+    'onboarding',
+    'onboardingteam',
+    'operations',
+    'ops',
+    'orders',
+    'owner',
+    'partners',
+    'partnerships',
+    'payments',
+    'payables',
+    'patients',
+    'people',
+    'peopleops',
+    'payroll',
+    'paralegal',
+    'preferencecenter',
+    'preferences',
+    'podcast',
+    'postmaster',
+    'press',
+    'product',
+    'productfeedback',
+    'privacy',
+    'privacyteam',
+    'procurement',
+    'promotions',
+    'purchasing',
+    'propertymanagement',
+    'pr',
+    'quotes',
+    'qa',
+    'quality',
+    'qualityassurance',
+    'r&d',
+    'recruiting',
+    'registrar',
+    'research',
+    'researchteam',
+    'reply',
+    'replyto',
+    'referrals',
+    'repairs',
+    'reservations',
+    'receipts',
+    'records',
+    'reception',
+    'receptiondesk',
+    'receivables',
+    'refunds',
+    'resellers',
+    'reliability',
+    'renewal',
+    'renewals',
+    'retail',
+    'risk',
+    'returns',
+    'rentals',
+    'sales',
+    'salesteam',
+    'salesops',
+    'scheduling',
+    'scholarship',
+    'scholarships',
+    'security',
+    'securityalerts',
+    'securityteam',
+    'service',
+    'servicedesk',
+    'shipping',
+    'social',
+    'socialmedia',
+    'sponsorship',
+    'sponsorships',
+    'staff',
+    'status',
+    'store',
+    'subscriptions',
+    'success',
+    'support',
+    'supportdesk',
+    'supportteam',
+    'supplychain',
+    'sysadmin',
+    'system',
+    'soc2',
+    'talent',
+    'team',
+    'test',
+    'testing',
+    'technicalsupport',
+    'techsupport',
+    'trust',
+    'trustandsafety',
+    'trustsafety',
+    'transactional',
+    'training',
+    'trials',
+    'updates',
+    'uptime',
+    'unsubscribe',
+    'userresearch',
+    'vendor',
+    'vendors',
+    'vip',
+    'vipsupport',
+    'warehouse',
+    'uxresearch',
+    'verification',
+    'verify',
+    'volunteer',
+    'volunteers',
+    'webinar',
+    'webinars',
+    'workshops',
+    'webmaster',
+    'workplace'
+]);

package/dist/esm/cli.js

@@ -0,0 +1,67 @@
+#!/usr/bin/env node
+import { EmailVerifier } from './client.js';
+import { analyzeEmail } from './offline.js';
+const help = `emailverifier
+
+Usage:
+  emailverifier check <email> [--json]
+  emailverifier verify <email> [--json]
+  emailverifier domain <domain> [--json]
+  emailverifier usage [--json]
+
+check runs locally without network access. verify, domain, and usage require
+EMAILVERIFIER_API_KEY. They never read an API key from a command-line argument.`;
+function fail(message) {
+    console.error(message);
+    process.exit(1);
+}
+function print(value, compact) {
+    console.log(JSON.stringify(value, null, compact ? 0 : 2));
+}
+async function run() {
+    const args = process.argv.slice(2);
+    const json = args.includes('--json');
+    const positional = args.filter(arg => arg !== '--json');
+    const [command, value, ...extra] = positional;
+    if (!command || command === '--help' || command === '-h') {
+        console.log(help);
+        return;
+    }
+    if (extra.length)
+        fail('Too many arguments. Run emailverifier --help for usage.');
+    if (command === 'check') {
+        if (!value)
+            fail('An email address is required.');
+        print(analyzeEmail(value), json);
+        return;
+    }
+    const apiKey = process.env.EMAILVERIFIER_API_KEY;
+    if (!apiKey)
+        fail('EMAILVERIFIER_API_KEY is required for remote commands.');
+    const client = new EmailVerifier({
+        apiKey,
+        baseUrl: process.env.EMAILVERIFIER_BASE_URL
+    });
+    if (command === 'verify') {
+        if (!value)
+            fail('An email address is required.');
+        print(await client.verify(value), json);
+        return;
+    }
+    if (command === 'domain') {
+        if (!value)
+            fail('A domain is required.');
+        print(await client.checkDomain(value), json);
+        return;
+    }
+    if (command === 'usage') {
+        if (value)
+            fail('The usage command does not accept an argument.');
+        print(await client.getUsage(), json);
+        return;
+    }
+    fail(`Unknown command: ${command}`);
+}
+run().catch((error) => {
+    fail(error instanceof Error ? error.message : 'The command failed.');
+});

package/dist/esm/client.js

@@ -0,0 +1,71 @@
+export class EmailVerifierError extends Error {
+    status;
+    response;
+    constructor(message, status, response) {
+        super(message);
+        this.name = 'EmailVerifierError';
+        this.status = status;
+        this.response = response;
+    }
+}
+export class EmailVerifier {
+    #apiKey;
+    #baseUrl;
+    constructor(options) {
+        if (!options?.apiKey?.trim())
+            throw new TypeError('EmailVerifier requires an API key.');
+        this.#apiKey = options.apiKey.trim();
+        this.#baseUrl = (options.baseUrl ?? 'https://emailverifier.dev').replace(/\/+$/, '');
+        const url = new URL(this.#baseUrl);
+        if (url.protocol !== 'https:' && url.hostname !== 'localhost' && url.hostname !== '127.0.0.1') {
+            throw new TypeError('EmailVerifier baseUrl must use HTTPS unless it points to localhost.');
+        }
+    }
+    verify(email, options) {
+        return this.#request('/api/v1/verify', {
+            method: 'POST',
+            body: JSON.stringify({ email }),
+            signal: options?.signal
+        });
+    }
+    checkDomain(domain, options) {
+        return this.#request(`/api/v1/domains/${encodeURIComponent(domain)}`, {
+            method: 'GET',
+            signal: options?.signal
+        });
+    }
+    getUsage(options) {
+        return this.#request('/api/v1/usage', {
+            method: 'GET',
+            signal: options?.signal
+        });
+    }
+    async #request(path, init) {
+        const response = await fetch(`${this.#baseUrl}${path}`, {
+            ...init,
+            headers: {
+                accept: 'application/json',
+                'content-type': 'application/json',
+                'x-api-key': this.#apiKey
+            }
+        });
+        const text = await response.text();
+        let body = null;
+        if (text) {
+            try {
+                body = JSON.parse(text);
+            }
+            catch {
+                body = text;
+            }
+        }
+        if (!response.ok) {
+            const message = body && typeof body === 'object' && 'statusMessage' in body
+                && typeof body.statusMessage === 'string'
+                ? body.statusMessage
+                : `emailverifier.dev returned HTTP ${response.status}.`;
+            throw new EmailVerifierError(message, response.status, body);
+        }
+        return body;
+    }
+}