@bernierllc/email-domain-verification 1.0.0

package/coverage/lcov.info

@@ -0,0 +1,485 @@
+TN:
+SF:src/EmailDomainVerificationService.ts
+FN:42,(anonymous_1)
+FN:63,(anonymous_2)
+FN:80,(anonymous_3)
+FN:153,(anonymous_4)
+FN:201,(anonymous_5)
+FN:206,(anonymous_6)
+FN:220,(anonymous_7)
+FN:281,(anonymous_8)
+FN:302,(anonymous_9)
+FN:314,(anonymous_10)
+FN:323,(anonymous_11)
+FN:353,(anonymous_12)
+FN:370,(anonymous_13)
+FN:389,(anonymous_14)
+FN:412,(anonymous_15)
+FN:429,(anonymous_16)
+FN:433,(anonymous_17)
+FN:437,(anonymous_18)
+FN:457,(anonymous_19)
+FN:488,(anonymous_20)
+FN:504,(anonymous_21)
+FN:525,(anonymous_22)
+FN:545,(anonymous_23)
+FN:565,(anonymous_24)
+FN:613,(anonymous_25)
+FN:632,(anonymous_26)
+FN:670,(anonymous_27)
+FN:706,(anonymous_28)
+FN:724,(anonymous_29)
+FN:744,(anonymous_30)
+FN:759,(anonymous_31)
+FN:790,(anonymous_32)
+FN:820,(anonymous_33)
+FN:836,(anonymous_34)
+FN:848,(anonymous_35)
+FN:849,(anonymous_36)
+FN:862,(anonymous_37)
+FN:867,(anonymous_38)
+FN:879,(anonymous_39)
+FN:879,(anonymous_40)
+FN:886,(anonymous_41)
+FN:891,(anonymous_42)
+FN:892,(anonymous_43)
+FN:909,(anonymous_44)
+FN:920,(anonymous_45)
+FN:940,(anonymous_46)
+FN:961,(anonymous_47)
+FN:982,(anonymous_48)
+FNF:48
+FNH:38
+FNDA:29,(anonymous_1)
+FNDA:0,(anonymous_2)
+FNDA:23,(anonymous_3)
+FNDA:3,(anonymous_4)
+FNDA:4,(anonymous_5)
+FNDA:4,(anonymous_6)
+FNDA:8,(anonymous_7)
+FNDA:1,(anonymous_8)
+FNDA:3,(anonymous_9)
+FNDA:7,(anonymous_10)
+FNDA:0,(anonymous_11)
+FNDA:8,(anonymous_12)
+FNDA:0,(anonymous_13)
+FNDA:22,(anonymous_14)
+FNDA:17,(anonymous_15)
+FNDA:18,(anonymous_16)
+FNDA:1,(anonymous_17)
+FNDA:1,(anonymous_18)
+FNDA:1,(anonymous_19)
+FNDA:22,(anonymous_20)
+FNDA:20,(anonymous_21)
+FNDA:1,(anonymous_22)
+FNDA:1,(anonymous_23)
+FNDA:1,(anonymous_24)
+FNDA:22,(anonymous_25)
+FNDA:20,(anonymous_26)
+FNDA:1,(anonymous_27)
+FNDA:1,(anonymous_28)
+FNDA:0,(anonymous_29)
+FNDA:0,(anonymous_30)
+FNDA:0,(anonymous_31)
+FNDA:0,(anonymous_32)
+FNDA:0,(anonymous_33)
+FNDA:4,(anonymous_34)
+FNDA:8,(anonymous_35)
+FNDA:4,(anonymous_36)
+FNDA:4,(anonymous_37)
+FNDA:4,(anonymous_38)
+FNDA:4,(anonymous_39)
+FNDA:0,(anonymous_40)
+FNDA:4,(anonymous_41)
+FNDA:8,(anonymous_42)
+FNDA:4,(anonymous_43)
+FNDA:23,(anonymous_44)
+FNDA:30,(anonymous_45)
+FNDA:0,(anonymous_46)
+FNDA:33,(anonymous_47)
+FNDA:28,(anonymous_48)
+DA:9,1
+DA:10,1
+DA:11,1
+DA:12,1
+DA:13,1
+DA:14,1
+DA:15,1
+DA:27,1
+DA:35,1
+DA:47,29
+DA:51,29
+DA:52,29
+DA:56,29
+DA:57,29
+DA:64,0
+DA:65,0
+DA:66,0
+DA:69,0
+DA:81,23
+DA:86,23
+DA:88,23
+DA:91,22
+DA:95,22
+DA:96,1
+DA:97,1
+DA:101,22
+DA:104,22
+DA:111,22
+DA:117,22
+DA:133,1
+DA:134,1
+DA:136,1
+DA:157,3
+DA:162,3
+DA:164,3
+DA:165,4
+DA:166,4
+DA:167,4
+DA:169,4
+DA:170,2
+DA:176,2
+DA:184,0
+DA:185,0
+DA:187,0
+DA:201,4
+DA:202,3
+DA:206,4
+DA:209,3
+DA:225,8
+DA:227,8
+DA:228,8
+DA:230,8
+DA:231,8
+DA:233,8
+DA:240,8
+DA:248,8
+DA:249,7
+DA:252,8
+DA:253,8
+DA:262,0
+DA:263,0
+DA:265,0
+DA:282,1
+DA:286,1
+DA:303,3
+DA:304,3
+DA:320,7
+DA:323,7
+DA:324,0
+DA:325,0
+DA:327,0
+DA:328,0
+DA:330,0
+DA:337,0
+DA:338,0
+DA:342,7
+DA:343,7
+DA:345,7
+DA:354,8
+DA:355,8
+DA:356,1
+DA:357,1
+DA:358,1
+DA:377,0
+DA:390,22
+DA:393,22
+DA:394,17
+DA:398,22
+DA:399,1
+DA:403,22
+DA:404,22
+DA:406,22
+DA:413,17
+DA:414,17
+DA:415,17
+DA:416,17
+DA:418,17
+DA:421,17
+DA:422,17
+DA:423,0
+DA:424,0
+DA:425,0
+DA:426,0
+DA:429,17
+DA:430,18
+DA:433,17
+DA:434,1
+DA:437,17
+DA:438,1
+DA:441,17
+DA:443,17
+DA:458,1
+DA:459,1
+DA:460,1
+DA:461,1
+DA:462,1
+DA:464,1
+DA:466,1
+DA:467,1
+DA:470,1
+DA:471,0
+DA:474,1
+DA:489,22
+DA:491,20
+DA:493,1
+DA:495,1
+DA:497,0
+DA:505,20
+DA:509,20
+DA:519,20
+DA:526,1
+DA:529,1
+DA:539,1
+DA:546,1
+DA:549,1
+DA:559,1
+DA:566,1
+DA:567,1
+DA:570,1
+DA:583,1
+DA:589,1
+DA:591,1
+DA:601,1
+DA:617,22
+DA:619,20
+DA:621,1
+DA:623,1
+DA:625,0
+DA:635,20
+DA:636,20
+DA:654,20
+DA:661,0
+DA:662,0
+DA:663,0
+DA:673,1
+DA:674,1
+DA:690,1
+DA:697,0
+DA:698,0
+DA:699,0
+DA:711,1
+DA:715,1
+DA:729,0
+DA:731,0
+DA:733,0
+DA:735,0
+DA:737,0
+DA:748,0
+DA:750,0
+DA:759,0
+DA:760,0
+DA:761,0
+DA:765,0
+DA:775,0
+DA:781,0
+DA:782,0
+DA:783,0
+DA:794,0
+DA:795,0
+DA:805,0
+DA:811,0
+DA:812,0
+DA:813,0
+DA:825,0
+DA:827,0
+DA:840,4
+DA:841,4
+DA:843,4
+DA:844,4
+DA:845,4
+DA:846,4
+DA:847,4
+DA:848,8
+DA:849,4
+DA:852,4
+DA:854,0
+DA:861,4
+DA:862,4
+DA:865,4
+DA:866,4
+DA:867,4
+DA:868,4
+DA:870,4
+DA:879,4
+DA:887,4
+DA:888,4
+DA:889,4
+DA:890,4
+DA:891,8
+DA:892,4
+DA:894,0
+DA:895,0
+DA:898,0
+DA:910,23
+DA:912,23
+DA:913,1
+DA:924,30
+DA:926,30
+DA:927,30
+DA:934,30
+DA:941,0
+DA:943,0
+DA:955,0
+DA:962,33
+DA:964,2
+DA:965,2
+DA:972,0
+DA:984,28
+DA:985,6
+DA:986,6
+DA:989,28
+DA:990,28
+LF:232
+LH:170
+BRDA:47,0,0,29
+BRDA:47,0,1,0
+BRDA:64,1,0,0
+BRDA:95,2,0,1
+BRDA:133,3,0,1
+BRDA:133,3,1,0
+BRDA:141,4,0,1
+BRDA:141,4,1,0
+BRDA:169,5,0,2
+BRDA:169,5,1,2
+BRDA:169,6,0,4
+BRDA:169,6,1,2
+BRDA:184,7,0,0
+BRDA:184,7,1,0
+BRDA:195,8,0,0
+BRDA:195,8,1,0
+BRDA:230,9,0,7
+BRDA:230,9,1,1
+BRDA:231,10,0,8
+BRDA:231,10,1,0
+BRDA:234,11,0,7
+BRDA:234,11,1,1
+BRDA:248,12,0,7
+BRDA:252,13,0,8
+BRDA:252,13,1,0
+BRDA:259,14,0,1
+BRDA:259,14,1,7
+BRDA:262,15,0,0
+BRDA:262,15,1,0
+BRDA:270,16,0,0
+BRDA:270,16,1,0
+BRDA:302,17,0,2
+BRDA:303,18,0,3
+BRDA:303,18,1,1
+BRDA:327,19,0,0
+BRDA:337,20,0,0
+BRDA:337,20,1,0
+BRDA:355,21,0,1
+BRDA:393,22,0,17
+BRDA:398,23,0,1
+BRDA:413,24,0,17
+BRDA:413,24,1,16
+BRDA:414,25,0,17
+BRDA:414,25,1,16
+BRDA:415,26,0,17
+BRDA:415,26,1,16
+BRDA:421,27,0,17
+BRDA:421,27,1,0
+BRDA:423,28,0,0
+BRDA:423,28,1,0
+BRDA:425,29,0,0
+BRDA:441,30,0,16
+BRDA:441,30,1,1
+BRDA:458,31,0,1
+BRDA:458,31,1,0
+BRDA:459,32,0,1
+BRDA:459,32,1,0
+BRDA:462,33,0,1
+BRDA:462,33,1,1
+BRDA:466,34,0,1
+BRDA:470,35,0,0
+BRDA:489,36,0,20
+BRDA:489,36,1,1
+BRDA:489,36,2,1
+BRDA:489,36,3,0
+BRDA:566,37,0,1
+BRDA:566,37,1,0
+BRDA:567,38,0,1
+BRDA:567,38,1,0
+BRDA:617,39,0,20
+BRDA:617,39,1,1
+BRDA:617,39,2,1
+BRDA:617,39,3,0
+BRDA:661,40,0,0
+BRDA:661,40,1,0
+BRDA:678,41,0,1
+BRDA:678,41,1,1
+BRDA:697,42,0,0
+BRDA:697,42,1,0
+BRDA:729,43,0,0
+BRDA:729,43,1,0
+BRDA:729,43,2,0
+BRDA:729,43,3,0
+BRDA:760,44,0,0
+BRDA:778,45,0,0
+BRDA:778,45,1,0
+BRDA:781,46,0,0
+BRDA:781,46,1,0
+BRDA:808,47,0,0
+BRDA:808,47,1,0
+BRDA:811,48,0,0
+BRDA:811,48,1,0
+BRDA:856,49,0,0
+BRDA:856,49,1,0
+BRDA:862,50,0,4
+BRDA:862,50,1,4
+BRDA:868,51,0,4
+BRDA:868,51,1,2
+BRDA:894,52,0,0
+BRDA:894,52,1,0
+BRDA:912,53,0,1
+BRDA:924,54,0,30
+BRDA:924,54,1,21
+BRDA:941,55,0,0
+BRDA:962,56,0,31
+BRDA:974,57,0,0
+BRDA:974,57,1,0
+BRF:107
+BRH:55
+end_of_record
+TN:
+SF:src/errors.ts
+FN:13,(anonymous_0)
+FN:25,(anonymous_1)
+FN:32,(anonymous_2)
+FN:39,(anonymous_3)
+FN:62,successResult
+FN:69,errorResult
+FNF:6
+FNH:2
+FNDA:1,(anonymous_0)
+FNDA:0,(anonymous_1)
+FNDA:0,(anonymous_2)
+FNDA:1,(anonymous_3)
+FNDA:0,successResult
+FNDA:0,errorResult
+DA:12,1
+DA:15,1
+DA:16,1
+DA:17,1
+DA:19,1
+DA:20,1
+DA:24,1
+DA:26,0
+DA:27,0
+DA:31,1
+DA:33,0
+DA:34,0
+DA:38,1
+DA:40,1
+DA:41,1
+DA:62,1
+DA:63,0
+DA:69,1
+DA:70,0
+LF:19
+LH:13
+BRDA:16,0,0,0
+BRF:1
+BRH:0
+end_of_record

package/dist/EmailDomainVerificationService.d.ts

@@ -0,0 +1,179 @@
+import { Logger } from '@bernierllc/logger';
+import { NeverHubAdapter } from '@bernierllc/neverhub-adapter';
+import { DomainConfig, DomainVerificationResult, DNSPropagationResult, DomainHealthStatus, VerificationHistoryEntry, DNSRecord, EmailProvider } from './types';
+/**
+ * Email Domain Verification Service
+ *
+ * Manages domain verification for email service providers including
+ * DNS record generation, propagation monitoring, and health checks.
+ */
+export declare class EmailDomainVerificationService {
+    private logger;
+    private neverhub?;
+    private httpClient;
+    private healthCheckJobs;
+    private verificationHistory;
+    constructor(config?: {
+        logger?: Logger;
+        neverhub?: NeverHubAdapter;
+        healthCheckInterval?: string;
+    });
+    /**
+     * Initialize service with NeverHub registration
+     */
+    initialize(): Promise<void>;
+    /**
+     * Setup domain verification for a provider
+     *
+     * @param config - Domain configuration
+     * @returns Verification result with DNS records to configure
+     */
+    setupDomain(config: DomainConfig): Promise<DomainVerificationResult>;
+    /**
+     * Check DNS propagation status for domain records
+     *
+     * @param domain - Domain name
+     * @param records - DNS records to check
+     * @returns Propagation results for each record
+     */
+    checkPropagation(domain: string, records: DNSRecord[]): Promise<DNSPropagationResult[]>;
+    /**
+     * Verify domain with email provider
+     *
+     * @param domain - Domain name
+     * @param provider - Email provider
+     * @param providerCredentials - Provider API credentials
+     * @returns Verification result
+     */
+    verifyDomain(domain: string, provider: EmailProvider, providerCredentials: Record<string, unknown>): Promise<DomainVerificationResult>;
+    /**
+     * Get domain health status
+     *
+     * @param domain - Domain name
+     * @returns Health status
+     */
+    getDomainHealth(domain: string): Promise<DomainHealthStatus>;
+    /**
+     * Get verification history for domain
+     *
+     * @param domain - Domain name
+     * @param limit - Maximum number of entries to return
+     * @returns History entries
+     */
+    getVerificationHistory(domain: string, limit?: number): VerificationHistoryEntry[];
+    /**
+     * Start automated health monitoring for domain
+     *
+     * @param domain - Domain name
+     * @param provider - Email provider
+     * @param credentials - Provider credentials
+     */
+    private startHealthMonitoring;
+    /**
+     * Stop health monitoring for domain
+     *
+     * @param domain - Domain name
+     */
+    stopHealthMonitoring(domain: string): void;
+    /**
+     * Perform health check for domain
+     *
+     * @param domain - Domain name
+     * @param provider - Email provider
+     * @param credentials - Provider credentials
+     * @returns Health status
+     */
+    private performHealthCheck;
+    /**
+     * Generate DNS records for domain configuration
+     */
+    private generateDNSRecords;
+    /**
+     * Generate SPF DNS record
+     */
+    private generateSPFRecord;
+    /**
+     * Generate DMARC DNS record
+     */
+    private generateDMARCRecord;
+    /**
+     * Generate provider-specific DNS records
+     */
+    private generateProviderRecords;
+    /**
+     * Generate SendGrid-specific DNS records
+     */
+    private generateSendGridRecords;
+    /**
+     * Generate Mailgun-specific DNS records
+     */
+    private generateMailgunRecords;
+    /**
+     * Generate AWS SES-specific DNS records
+     */
+    private generateSESRecords;
+    /**
+     * Generate DKIM configuration with keypair
+     */
+    private generateDKIMConfig;
+    /**
+     * Register domain with email provider
+     */
+    private registerWithProvider;
+    /**
+     * Register domain with SendGrid
+     */
+    private registerWithSendGrid;
+    /**
+     * Register domain with Mailgun
+     */
+    private registerWithMailgun;
+    /**
+     * Register domain with AWS SES
+     */
+    private registerWithSES;
+    /**
+     * Verify domain with email provider
+     */
+    private verifyWithProvider;
+    /**
+     * Verify domain with SendGrid
+     */
+    private verifyWithSendGrid;
+    /**
+     * Verify domain with Mailgun
+     */
+    private verifyWithMailgun;
+    /**
+     * Verify domain with AWS SES
+     */
+    private verifyWithSES;
+    /**
+     * Check propagation for single DNS record
+     */
+    private checkRecordPropagation;
+    /**
+     * Get nameservers for domain
+     */
+    private getNameservers;
+    /**
+     * Validate domain name format
+     */
+    private validateDomain;
+    /**
+     * Add entry to verification history
+     */
+    private addHistoryEntry;
+    /**
+     * Register with NeverHub
+     */
+    private registerWithNeverHub;
+    /**
+     * Publish event to NeverHub
+     */
+    private publishEvent;
+    /**
+     * Cleanup resources
+     */
+    shutdown(): Promise<void>;
+}