@bernierllc/sender-identity-verification 1.3.0 → 1.4.0

package/src/config.ts

@@ -7,6 +7,7 @@ Redistribution or use in other products or commercial offerings is not permitted
 */
 
 import { IEmailDomainVerification } from './types.js';
+import type { EmailSenderManager, SenderProviderPlugin } from '@bernierllc/email-sender-manager';
 
 /**
  * Configuration for sender identity verification service
@@ -23,6 +24,12 @@ export interface SenderIdentityConfig {
     instance?: IEmailDomainVerification;
   };
 
+  // Core sender manager for persistence (optional for backward compat)
+  senderManager?: EmailSenderManager;
+
+  // Provider plugins for API-driven sender operations (optional for backward compat)
+  providerPlugins?: SenderProviderPlugin[];
+
   // Retry configuration
   retryConfig?: {
     maxRetries?: number;
@@ -35,7 +42,7 @@ export interface SenderIdentityConfig {
   verificationFromEmail: string;
   verificationFromName: string;
 
-  // Provider API keys
+  // Provider API keys (legacy — prefer providerPlugins)
   sendgridApiKey?: string;
   mailgunApiKey?: string;
   sesAccessKey?: string;
@@ -65,6 +72,8 @@ export function loadConfigFromEnv(overrides: Partial<SenderIdentityConfig> = {})
 
     emailSenderConfig: overrides.emailSenderConfig || {},
     domainVerificationConfig: overrides.domainVerificationConfig || {},
+    senderManager: overrides.senderManager,
+    providerPlugins: overrides.providerPlugins,
     retryConfig: overrides.retryConfig
   };
 

package/src/index.ts

@@ -22,3 +22,5 @@ export {
   DomainVerificationStatus,
   IEmailDomainVerification
 } from './types.js';
+export { getManualInstructions, isManualVerificationProvider } from './manual-instructions.js';
+export type { ManualVerificationInstruction } from './manual-instructions.js';

package/src/manual-instructions.ts

@@ -0,0 +1,61 @@
+/*
+Copyright (c) 2025 Bernier LLC
+
+This file is licensed to the client under a limited-use license.
+The client may use and modify this code *only within the scope of the project it was delivered for*.
+Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
+*/
+
+import { EmailProvider } from './types.js';
+
+export interface ManualVerificationInstruction {
+  provider: EmailProvider;
+  title: string;
+  steps: string[];
+  dashboardUrl?: string;
+}
+
+const MANUAL_INSTRUCTIONS: Record<string, ManualVerificationInstruction> = {
+  [EmailProvider.SMTP]: {
+    provider: EmailProvider.SMTP,
+    title: 'SMTP Sender Verification',
+    steps: [
+      'Configure your SMTP server to allow sending from this address.',
+      'Ensure SPF records include your SMTP server IP.',
+      'Configure DKIM signing for the domain.',
+      'Mark the sender as verified once DNS records are propagated.',
+    ],
+  },
+  [EmailProvider.SMTP2GO]: {
+    provider: EmailProvider.SMTP2GO,
+    title: 'SMTP2GO Sender Verification',
+    steps: [
+      'Log in to your SMTP2GO dashboard.',
+      'Navigate to Settings → Sender Domains.',
+      'Add and verify the sender domain.',
+      'Mark the sender as verified once domain is confirmed.',
+    ],
+    dashboardUrl: 'https://app.smtp2go.com/settings/sender_domains/',
+  },
+  [EmailProvider.MANDRILL]: {
+    provider: EmailProvider.MANDRILL,
+    title: 'Mandrill Sender Verification',
+    steps: [
+      'Log in to your Mandrill dashboard.',
+      'Navigate to Settings → Sending Domains.',
+      'Add and verify the sender domain.',
+      'Mark the sender as verified once domain is confirmed.',
+    ],
+    dashboardUrl: 'https://mandrillapp.com/settings/sending-domains',
+  },
+};
+
+export function getManualInstructions(provider: EmailProvider): ManualVerificationInstruction | null {
+  return MANUAL_INSTRUCTIONS[provider] || null;
+}
+
+export function isManualVerificationProvider(provider: EmailProvider): boolean {
+  return provider === EmailProvider.SMTP
+    || provider === EmailProvider.SMTP2GO
+    || provider === EmailProvider.MANDRILL;
+}

package/src/types.ts

@@ -81,6 +81,9 @@ export interface CreateSenderInput {
   provider: EmailProvider;
   isDefault?: boolean;
   skipVerification?: boolean; // For testing/dev
+  createdBy?: string;
+  /** Provider-specific fields (e.g., address/city/state for SendGrid) */
+  providerFields?: Record<string, unknown>;
 }
 
 /**
@@ -92,6 +95,8 @@ export interface UpdateSenderInput {
   replyToName?: string;
   isDefault?: boolean;
   isActive?: boolean;
+  lastModifiedBy?: string;
+  providerFields?: Record<string, unknown>;
 }
 
 /**