@serve.zone/dcrouter 2.12.4

package/test/suite/smtpclient_email-composition/test.cep-10.receipts-dsn.ts

@@ -0,0 +1,411 @@
+import { tap, expect } from '@git.zone/tstest/tapbundle';
+import { startTestServer, stopTestServer, type ITestServer } from '../../helpers/server.loader.js';
+import { createSmtpClient } from '../../../ts/mail/delivery/smtpclient/index.js';
+import { Email } from '../../../ts/mail/core/classes.email.js';
+
+let testServer: ITestServer;
+
+tap.test('setup test SMTP server', async () => {
+  testServer = await startTestServer({
+    port: 2570,
+    tlsEnabled: false,
+    authRequired: false
+  });
+  expect(testServer).toBeTruthy();
+  expect(testServer.port).toEqual(2570);
+});
+
+tap.test('CEP-10: Read receipt headers', async () => {
+  const smtpClient = await createSmtpClient({
+    host: testServer.hostname,
+    port: testServer.port,
+    secure: false,
+    connectionTimeout: 5000
+  });
+
+  // Create email requesting read receipt
+  const email = new Email({
+    from: 'sender@example.com',
+    to: 'recipient@example.com',
+    subject: 'Important: Please confirm receipt',
+    text: 'Please confirm you have read this message',
+    headers: {
+      'Disposition-Notification-To': 'sender@example.com',
+      'Return-Receipt-To': 'sender@example.com',
+      'X-Confirm-Reading-To': 'sender@example.com',
+      'X-MS-Receipt-Request': 'sender@example.com'
+    }
+  });
+
+  const result = await smtpClient.sendMail(email);
+  expect(result.success).toBeTruthy();
+  console.log('Read receipt headers test sent successfully');
+});
+
+tap.test('CEP-10: DSN (Delivery Status Notification) requests', async () => {
+  const smtpClient = await createSmtpClient({
+    host: testServer.hostname,
+    port: testServer.port,
+    secure: false,
+    connectionTimeout: 5000
+  });
+
+  // Create email with DSN options
+  const email = new Email({
+    from: 'sender@example.com',
+    to: 'recipient@example.com',
+    subject: 'DSN Test Email',
+    text: 'Testing delivery status notifications',
+    headers: {
+      'X-DSN-Options': 'notify=SUCCESS,FAILURE,DELAY;return=HEADERS',
+      'X-Envelope-ID': `msg-${Date.now()}`
+    }
+  });
+
+  const result = await smtpClient.sendMail(email);
+  expect(result.success).toBeTruthy();
+  console.log('DSN requests test sent successfully');
+});
+
+tap.test('CEP-10: DSN notify options', async () => {
+  const smtpClient = await createSmtpClient({
+    host: testServer.hostname,
+    port: testServer.port,
+    secure: false,
+    connectionTimeout: 5000
+  });
+
+  // Test different DSN notify combinations
+  const notifyOptions = [
+    { notify: ['SUCCESS'], description: 'Notify on successful delivery only' },
+    { notify: ['FAILURE'], description: 'Notify on failure only' },
+    { notify: ['DELAY'], description: 'Notify on delays only' },
+    { notify: ['SUCCESS', 'FAILURE'], description: 'Notify on success and failure' },
+    { notify: ['NEVER'], description: 'Never send notifications' }
+  ];
+
+  for (const option of notifyOptions) {
+    console.log(`Testing DSN: ${option.description}`);
+    
+    const email = new Email({
+      from: 'sender@example.com',
+      to: 'recipient@example.com',
+      subject: `DSN Test: ${option.description}`,
+      text: 'Testing DSN notify options',
+      headers: {
+        'X-DSN-Notify': option.notify.join(','),
+        'X-DSN-Return': 'HEADERS'
+      }
+    });
+
+    const result = await smtpClient.sendMail(email);
+    expect(result.success).toBeTruthy();
+  }
+  
+  console.log('DSN notify options test completed successfully');
+});
+
+tap.test('CEP-10: DSN return types', async () => {
+  const smtpClient = await createSmtpClient({
+    host: testServer.hostname,
+    port: testServer.port,
+    secure: false,
+    connectionTimeout: 5000
+  });
+
+  // Test different return types
+  const returnTypes = [
+    { type: 'FULL', description: 'Return full message on failure' },
+    { type: 'HEADERS', description: 'Return headers only' }
+  ];
+
+  for (const returnType of returnTypes) {
+    console.log(`Testing DSN return type: ${returnType.description}`);
+    
+    const email = new Email({
+      from: 'sender@example.com',
+      to: 'recipient@example.com',
+      subject: `DSN Return Type: ${returnType.type}`,
+      text: 'Testing DSN return types',
+      headers: {
+        'X-DSN-Notify': 'FAILURE',
+        'X-DSN-Return': returnType.type
+      }
+    });
+
+    const result = await smtpClient.sendMail(email);
+    expect(result.success).toBeTruthy();
+  }
+  
+  console.log('DSN return types test completed successfully');
+});
+
+tap.test('CEP-10: MDN (Message Disposition Notification)', async () => {
+  const smtpClient = await createSmtpClient({
+    host: testServer.hostname,
+    port: testServer.port,
+    secure: false,
+    connectionTimeout: 5000
+  });
+
+  // Create MDN request email
+  const email = new Email({
+    from: 'sender@example.com',
+    to: 'recipient@example.com',
+    subject: 'Please confirm reading',
+    text: 'This message requests a read receipt',
+    headers: {
+      'Disposition-Notification-To': 'sender@example.com',
+      'Disposition-Notification-Options': 'signed-receipt-protocol=optional,pkcs7-signature',
+      'Original-Message-ID': `<${Date.now()}@example.com>`
+    }
+  });
+
+  const result = await smtpClient.sendMail(email);
+  expect(result.success).toBeTruthy();
+
+  // Simulate MDN response
+  const mdnResponse = new Email({
+    from: 'recipient@example.com',
+    to: 'sender@example.com',
+    subject: 'Read: Please confirm reading',
+    headers: {
+      'Content-Type': 'multipart/report; report-type=disposition-notification',
+      'In-Reply-To': `<${Date.now()}@example.com>`,
+      'References': `<${Date.now()}@example.com>`,
+      'Auto-Submitted': 'auto-replied'
+    },
+    text: 'The message was displayed to the recipient',
+    attachments: [{
+      filename: 'disposition-notification.txt',
+      content: Buffer.from(`Reporting-UA: mail.example.com; MailClient/1.0
+Original-Recipient: rfc822;recipient@example.com
+Final-Recipient: rfc822;recipient@example.com
+Original-Message-ID: <${Date.now()}@example.com>
+Disposition: automatic-action/MDN-sent-automatically; displayed`),
+      contentType: 'message/disposition-notification'
+    }]
+  });
+
+  const mdnResult = await smtpClient.sendMail(mdnResponse);
+  expect(mdnResult.success).toBeTruthy();
+  console.log('MDN test completed successfully');
+});
+
+tap.test('CEP-10: Multiple recipients with different DSN', async () => {
+  const smtpClient = await createSmtpClient({
+    host: testServer.hostname,
+    port: testServer.port,
+    secure: false,
+    connectionTimeout: 5000
+  });
+
+  // Email with multiple recipients
+  const emails = [
+    {
+      to: 'important@example.com',
+      dsn: 'SUCCESS,FAILURE,DELAY'
+    },
+    {
+      to: 'normal@example.com', 
+      dsn: 'FAILURE'
+    },
+    {
+      to: 'optional@example.com',
+      dsn: 'NEVER'
+    }
+  ];
+
+  for (const emailData of emails) {
+    const email = new Email({
+      from: 'sender@example.com',
+      to: emailData.to,
+      subject: 'Multi-recipient DSN Test',
+      text: 'Testing per-recipient DSN options',
+      headers: {
+        'X-DSN-Notify': emailData.dsn,
+        'X-DSN-Return': 'HEADERS'
+      }
+    });
+
+    const result = await smtpClient.sendMail(email);
+    expect(result.success).toBeTruthy();
+  }
+  
+  console.log('Multiple recipients DSN test completed successfully');
+});
+
+tap.test('CEP-10: DSN with ORCPT', async () => {
+  const smtpClient = await createSmtpClient({
+    host: testServer.hostname,
+    port: testServer.port,
+    secure: false,
+    connectionTimeout: 5000
+  });
+
+  // Test ORCPT (Original Recipient) parameter
+  const email = new Email({
+    from: 'sender@example.com',
+    to: 'forwarded@example.com',
+    subject: 'DSN with ORCPT Test',
+    text: 'Testing original recipient tracking',
+    headers: {
+      'X-DSN-Notify': 'SUCCESS,FAILURE',
+      'X-DSN-Return': 'HEADERS',
+      'X-Original-Recipient': 'rfc822;original@example.com'
+    }
+  });
+
+  const result = await smtpClient.sendMail(email);
+  expect(result.success).toBeTruthy();
+  console.log('DSN with ORCPT test sent successfully');
+});
+
+tap.test('CEP-10: Receipt request formats', async () => {
+  const smtpClient = await createSmtpClient({
+    host: testServer.hostname,
+    port: testServer.port,
+    secure: false,
+    connectionTimeout: 5000
+  });
+
+  // Test various receipt request formats
+  const receiptFormats = [
+    {
+      name: 'Simple email',
+      value: 'receipts@example.com'
+    },
+    {
+      name: 'With display name',
+      value: '"Receipt Handler" <receipts@example.com>'
+    },
+    {
+      name: 'Multiple addresses',
+      value: 'receipts@example.com, backup@example.com'
+    },
+    {
+      name: 'With comment',
+      value: 'receipts@example.com (Automated System)'
+    }
+  ];
+
+  for (const format of receiptFormats) {
+    console.log(`Testing receipt format: ${format.name}`);
+    
+    const email = new Email({
+      from: 'sender@example.com',
+      to: 'recipient@example.com',
+      subject: `Receipt Format: ${format.name}`,
+      text: 'Testing receipt address formats',
+      headers: {
+        'Disposition-Notification-To': format.value
+      }
+    });
+
+    const result = await smtpClient.sendMail(email);
+    expect(result.success).toBeTruthy();
+  }
+  
+  console.log('Receipt request formats test completed successfully');
+});
+
+tap.test('CEP-10: Non-delivery reports', async () => {
+  const smtpClient = await createSmtpClient({
+    host: testServer.hostname,
+    port: testServer.port,
+    secure: false,
+    connectionTimeout: 5000
+  });
+
+  // Simulate bounce/NDR structure
+  const ndrEmail = new Email({
+    from: 'MAILER-DAEMON@example.com',
+    to: 'original-sender@example.com',
+    subject: 'Undelivered Mail Returned to Sender',
+    headers: {
+      'Auto-Submitted': 'auto-replied',
+      'Content-Type': 'multipart/report; report-type=delivery-status',
+      'X-Failed-Recipients': 'nonexistent@example.com'
+    },
+    text: 'This is the mail delivery agent at example.com.\n\n' +
+          'I was unable to deliver your message to the following addresses:\n\n' +
+          '<nonexistent@example.com>: User unknown',
+    attachments: [
+      {
+        filename: 'delivery-status.txt',
+        content: Buffer.from(`Reporting-MTA: dns; mail.example.com
+X-Queue-ID: 123456789
+Arrival-Date: ${new Date().toUTCString()}
+
+Final-Recipient: rfc822;nonexistent@example.com
+Original-Recipient: rfc822;nonexistent@example.com
+Action: failed
+Status: 5.1.1
+Diagnostic-Code: smtp; 550 5.1.1 User unknown`),
+        contentType: 'message/delivery-status'
+      },
+      {
+        filename: 'original-message.eml',
+        content: Buffer.from('From: original-sender@example.com\r\n' +
+                           'To: nonexistent@example.com\r\n' +
+                           'Subject: Original Subject\r\n\r\n' +
+                           'Original message content'),
+        contentType: 'message/rfc822'
+      }
+    ]
+  });
+
+  const result = await smtpClient.sendMail(ndrEmail);
+  expect(result.success).toBeTruthy();
+  console.log('Non-delivery report test sent successfully');
+});
+
+tap.test('CEP-10: Delivery delay notifications', async () => {
+  const smtpClient = await createSmtpClient({
+    host: testServer.hostname,
+    port: testServer.port,
+    secure: false,
+    connectionTimeout: 5000
+  });
+
+  // Simulate delayed delivery notification
+  const delayNotification = new Email({
+    from: 'postmaster@example.com',
+    to: 'sender@example.com',
+    subject: 'Delivery Status: Delayed',
+    headers: {
+      'Auto-Submitted': 'auto-replied',
+      'Content-Type': 'multipart/report; report-type=delivery-status',
+      'X-Delay-Reason': 'Remote server temporarily unavailable'
+    },
+    text: 'This is an automatically generated Delivery Delay Notification.\n\n' +
+          'Your message has not been delivered to the following recipients yet:\n\n' +
+          '  recipient@remote-server.com\n\n' +
+          'The server will continue trying to deliver your message for 48 hours.',
+    attachments: [{
+      filename: 'delay-status.txt',
+      content: Buffer.from(`Reporting-MTA: dns; mail.example.com
+Arrival-Date: ${new Date(Date.now() - 3600000).toUTCString()}
+Last-Attempt-Date: ${new Date().toUTCString()}
+
+Final-Recipient: rfc822;recipient@remote-server.com
+Action: delayed
+Status: 4.4.1
+Will-Retry-Until: ${new Date(Date.now() + 172800000).toUTCString()}
+Diagnostic-Code: smtp; 421 4.4.1 Remote server temporarily unavailable`),
+      contentType: 'message/delivery-status'
+    }]
+  });
+
+  const result = await smtpClient.sendMail(delayNotification);
+  expect(result.success).toBeTruthy();
+  console.log('Delivery delay notification test sent successfully');
+});
+
+tap.test('cleanup test SMTP server', async () => {
+  if (testServer) {
+    await stopTestServer(testServer);
+  }
+});
+
+export default tap.start();

package/test/suite/smtpclient_error-handling/test.cerr-01.4xx-errors.ts

@@ -0,0 +1,232 @@
+import { tap, expect } from '@git.zone/tstest/tapbundle';
+import { startTestServer, stopTestServer, type ITestServer } from '../../helpers/server.loader.js';
+import { createSmtpClient } from '../../../ts/mail/delivery/smtpclient/index.js';
+import type { SmtpClient } from '../../../ts/mail/delivery/smtpclient/smtp-client.js';
+import { Email } from '../../../ts/mail/core/classes.email.js';
+
+let testServer: ITestServer;
+let smtpClient: SmtpClient;
+
+tap.test('setup - start SMTP server for error handling tests', async () => {
+  testServer = await startTestServer({
+    port: 2550,
+    tlsEnabled: false,
+    authRequired: false,
+    maxRecipients: 5 // Low limit to trigger errors
+  });
+  
+  expect(testServer.port).toEqual(2550);
+});
+
+tap.test('CERR-01: 4xx Errors - should handle invalid recipient (450)', async () => {
+  smtpClient = await createSmtpClient({
+    host: testServer.hostname,
+    port: testServer.port,
+    secure: false,
+    connectionTimeout: 5000
+  });
+  
+  // Create email with syntactically valid but nonexistent recipient
+  const email = new Email({
+    from: 'test@example.com',
+    to: 'nonexistent-user@nonexistent-domain-12345.invalid',
+    subject: 'Testing 4xx Error',
+    text: 'This should trigger a 4xx error'
+  });
+  
+  const result = await smtpClient.sendMail(email);
+  
+  // Test server may accept or reject - both are valid test outcomes
+  if (!result.success) {
+    console.log('✅ Invalid recipient handled:', result.error?.message);
+  } else {
+    console.log('ℹ️ Test server accepted recipient (common in test environments)');
+  }
+  
+  expect(result).toBeTruthy();
+});
+
+tap.test('CERR-01: 4xx Errors - should handle mailbox unavailable (450)', async () => {
+  const email = new Email({
+    from: 'test@example.com',
+    to: 'mailbox-full@example.com', // Valid format but might be unavailable
+    subject: 'Mailbox Unavailable Test',
+    text: 'Testing mailbox unavailable error'
+  });
+  
+  const result = await smtpClient.sendMail(email);
+  
+  // Depending on server configuration, this might be accepted or rejected
+  if (!result.success) {
+    console.log('✅ Mailbox unavailable handled:', result.error?.message);
+  } else {
+    // Some test servers accept all recipients
+    console.log('ℹ️ Test server accepted recipient (common in test environments)');
+  }
+  
+  expect(result).toBeTruthy();
+});
+
+tap.test('CERR-01: 4xx Errors - should handle quota exceeded (452)', async () => {
+  // Send multiple emails to trigger quota/limit errors
+  const emails = [];
+  for (let i = 0; i < 10; i++) {
+    emails.push(new Email({
+      from: 'test@example.com',
+      to: `recipient${i}@example.com`,
+      subject: `Quota Test ${i}`,
+      text: 'Testing quota limits'
+    }));
+  }
+  
+  let quotaErrorCount = 0;
+  const results = await Promise.allSettled(
+    emails.map(email => smtpClient.sendMail(email))
+  );
+  
+  results.forEach((result, index) => {
+    if (result.status === 'rejected') {
+      quotaErrorCount++;
+      console.log(`Email ${index} rejected:`, result.reason);
+    }
+  });
+  
+  console.log(`✅ Handled ${quotaErrorCount} quota-related errors`);
+});
+
+tap.test('CERR-01: 4xx Errors - should handle too many recipients (452)', async () => {
+  // Create email with many recipients to exceed limit
+  const recipients = [];
+  for (let i = 0; i < 10; i++) {
+    recipients.push(`recipient${i}@example.com`);
+  }
+  
+  const email = new Email({
+    from: 'test@example.com',
+    to: recipients, // Many recipients
+    subject: 'Too Many Recipients Test',
+    text: 'Testing recipient limit'
+  });
+  
+  const result = await smtpClient.sendMail(email);
+  
+  // Check if some recipients were rejected due to limits
+  if (result.rejectedRecipients.length > 0) {
+    console.log(`✅ Rejected ${result.rejectedRecipients.length} recipients due to limits`);
+    expect(result.rejectedRecipients).toBeArray();
+  } else {
+    // Server might accept all
+    expect(result.acceptedRecipients.length).toEqual(recipients.length);
+    console.log('ℹ️ Server accepted all recipients');
+  }
+});
+
+tap.test('CERR-01: 4xx Errors - should handle authentication required (450)', async () => {
+  // Create new server requiring auth
+  const authServer = await startTestServer({
+    port: 2551,
+    authRequired: true // This will reject unauthenticated commands
+  });
+  
+  const unauthClient = await createSmtpClient({
+    host: authServer.hostname,
+    port: authServer.port,
+    secure: false,
+    // No auth credentials provided
+    connectionTimeout: 5000
+  });
+  
+  const email = new Email({
+    from: 'test@example.com',
+    to: 'recipient@example.com',
+    subject: 'Auth Required Test',
+    text: 'Should fail without auth'
+  });
+  
+  let authError = false;
+  try {
+    const result = await unauthClient.sendMail(email);
+    if (!result.success) {
+      authError = true;
+      console.log('✅ Authentication required error handled:', result.error?.message);
+    }
+  } catch (error) {
+    authError = true;
+    console.log('✅ Authentication required error caught:', error.message);
+  }
+  
+  expect(authError).toBeTrue();
+  
+  await stopTestServer(authServer);
+});
+
+tap.test('CERR-01: 4xx Errors - should parse enhanced status codes', async () => {
+  // 4xx errors often include enhanced status codes (e.g., 4.7.1)
+  const email = new Email({
+    from: 'test@blocked-domain.com', // Might trigger policy rejection
+    to: 'recipient@example.com',
+    subject: 'Enhanced Status Code Test',
+    text: 'Testing enhanced status codes'
+  });
+  
+  try {
+    const result = await smtpClient.sendMail(email);
+    
+    if (!result.success && result.error) {
+      console.log('✅ Error details:', {
+        message: result.error.message,
+        response: result.response
+      });
+    }
+  } catch (error: any) {
+    // Check if error includes status information
+    expect(error.message).toBeTypeofString();
+    console.log('✅ Error with potential enhanced status:', error.message);
+  }
+});
+
+tap.test('CERR-01: 4xx Errors - should not retry permanent 4xx errors', async () => {
+  // Track retry attempts
+  let attemptCount = 0;
+  
+  const trackingClient = await createSmtpClient({
+    host: testServer.hostname,
+    port: testServer.port,
+    secure: false,
+    connectionTimeout: 5000
+  });
+  
+  const email = new Email({
+    from: 'blocked-sender@blacklisted-domain.invalid', // Might trigger policy rejection
+    to: 'recipient@example.com',
+    subject: 'Permanent Error Test',
+    text: 'Should not retry'
+  });
+  
+  const result = await trackingClient.sendMail(email);
+  
+  // Test completed - whether success or failure, no retries should occur
+  if (!result.success) {
+    console.log('✅ Permanent error handled without retry:', result.error?.message);
+  } else {
+    console.log('ℹ️ Email accepted (no policy rejection in test server)');
+  }
+  
+  expect(result).toBeTruthy();
+});
+
+tap.test('cleanup - close SMTP client', async () => {
+  if (smtpClient) {
+    try {
+      await smtpClient.close();
+    } catch (error) {
+      console.log('Client already closed or error during close');
+    }
+  }
+});
+
+tap.test('cleanup - stop SMTP server', async () => {
+  await stopTestServer(testServer);
+});
+
+export default tap.start();