@serve.zone/dcrouter 2.12.4

package/test/suite/smtpclient_email-composition/test.cep-04.bcc-handling.ts

@@ -0,0 +1,187 @@
+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: 2577,
+    tlsEnabled: false,
+    authRequired: false
+  });
+  expect(testServer).toBeTruthy();
+  expect(testServer.port).toEqual(2577);
+});
+
+tap.test('CEP-04: Basic BCC handling', async () => {
+  console.log('Testing basic BCC handling');
+  
+  const smtpClient = createSmtpClient({
+    host: testServer.hostname,
+    port: testServer.port,
+    secure: false,
+    connectionTimeout: 5000,
+    debug: true
+  });
+
+  // Create email with BCC recipients
+  const email = new Email({
+    from: 'sender@example.com',
+    to: ['visible@example.com'],
+    bcc: ['hidden1@example.com', 'hidden2@example.com'],
+    subject: 'BCC Test Email',
+    text: 'This email tests BCC functionality'
+  });
+
+  const result = await smtpClient.sendMail(email);
+  expect(result).toBeDefined();
+  expect(result.messageId).toBeDefined();
+  
+  console.log('Successfully sent email with BCC recipients');
+
+  await smtpClient.close();
+});
+
+tap.test('CEP-04: Multiple BCC recipients', async () => {
+  console.log('Testing multiple BCC recipients');
+  
+  const smtpClient = createSmtpClient({
+    host: testServer.hostname,
+    port: testServer.port,
+    secure: false,
+    connectionTimeout: 5000,
+    debug: true
+  });
+
+  // Create email with many BCC recipients
+  const bccRecipients = Array.from({ length: 10 }, 
+    (_, i) => `bcc${i + 1}@example.com`
+  );
+  
+  const email = new Email({
+    from: 'sender@example.com',
+    to: ['primary@example.com'],
+    bcc: bccRecipients,
+    subject: 'Multiple BCC Test',
+    text: 'Testing with multiple BCC recipients'
+  });
+
+  console.log(`Sending email with ${bccRecipients.length} BCC recipients...`);
+  
+  const startTime = Date.now();
+  const result = await smtpClient.sendMail(email);
+  const elapsed = Date.now() - startTime;
+
+  expect(result).toBeDefined();
+  expect(result.messageId).toBeDefined();
+  
+  console.log(`Processed ${bccRecipients.length} BCC recipients in ${elapsed}ms`);
+
+  await smtpClient.close();
+});
+
+tap.test('CEP-04: BCC-only email', async () => {
+  console.log('Testing BCC-only email');
+  
+  const smtpClient = createSmtpClient({
+    host: testServer.hostname,
+    port: testServer.port,
+    secure: false,
+    connectionTimeout: 5000,
+    debug: true
+  });
+
+  // Create email with only BCC recipients (no TO or CC)
+  const email = new Email({
+    from: 'sender@example.com',
+    bcc: ['hidden1@example.com', 'hidden2@example.com', 'hidden3@example.com'],
+    subject: 'BCC-Only Email',
+    text: 'This email has only BCC recipients'
+  });
+
+  const result = await smtpClient.sendMail(email);
+  expect(result).toBeDefined();
+  expect(result.messageId).toBeDefined();
+
+  console.log('Successfully sent BCC-only email');
+
+  await smtpClient.close();
+});
+
+tap.test('CEP-04: Mixed recipient types', async () => {
+  console.log('Testing mixed recipient types');
+  
+  const smtpClient = createSmtpClient({
+    host: testServer.hostname,
+    port: testServer.port,
+    secure: false,
+    connectionTimeout: 5000,
+    debug: true
+  });
+
+  // Create email with all recipient types
+  const email = new Email({
+    from: 'sender@example.com',
+    to: ['to1@example.com', 'to2@example.com'],
+    cc: ['cc1@example.com', 'cc2@example.com'],
+    bcc: ['bcc1@example.com', 'bcc2@example.com'],
+    subject: 'Mixed Recipients Test',
+    text: 'Testing all recipient types together'
+  });
+
+  const result = await smtpClient.sendMail(email);
+  expect(result).toBeDefined();
+  expect(result.messageId).toBeDefined();
+  
+  console.log('Recipient breakdown:');
+  console.log(`  TO: ${email.to?.length || 0} recipients`);
+  console.log(`  CC: ${email.cc?.length || 0} recipients`);
+  console.log(`  BCC: ${email.bcc?.length || 0} recipients`);
+
+  await smtpClient.close();
+});
+
+tap.test('CEP-04: BCC with special characters in addresses', async () => {
+  console.log('Testing BCC with special characters');
+  
+  const smtpClient = createSmtpClient({
+    host: testServer.hostname,
+    port: testServer.port,
+    secure: false,
+    connectionTimeout: 5000,
+    debug: true
+  });
+
+  // BCC addresses with special characters
+  const specialBccAddresses = [
+    'user+tag@example.com',
+    'first.last@example.com',
+    'user_name@example.com'
+  ];
+
+  const email = new Email({
+    from: 'sender@example.com',
+    to: ['visible@example.com'],
+    bcc: specialBccAddresses,
+    subject: 'BCC Special Characters Test',
+    text: 'Testing BCC with special character addresses'
+  });
+
+  const result = await smtpClient.sendMail(email);
+  expect(result).toBeDefined();
+  expect(result.messageId).toBeDefined();
+  
+  console.log('Successfully processed BCC addresses with special characters');
+
+  await smtpClient.close();
+});
+
+tap.test('cleanup test SMTP server', async () => {
+  if (testServer) {
+    await stopTestServer(testServer);
+  }
+});
+
+export default tap.start();

package/test/suite/smtpclient_email-composition/test.cep-05.reply-to-return-path.ts

@@ -0,0 +1,277 @@
+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: 2578,
+    tlsEnabled: false,
+    authRequired: false
+  });
+  expect(testServer).toBeTruthy();
+  expect(testServer.port).toEqual(2578);
+});
+
+tap.test('CEP-05: Basic Reply-To header', async () => {
+  console.log('Testing basic Reply-To header');
+  
+  const smtpClient = createSmtpClient({
+    host: testServer.hostname,
+    port: testServer.port,
+    secure: false,
+    connectionTimeout: 5000,
+    debug: true
+  });
+
+  // Create email with Reply-To header
+  const email = new Email({
+    from: 'sender@example.com',
+    to: ['recipient@example.com'],
+    replyTo: 'replies@example.com',
+    subject: 'Reply-To Test',
+    text: 'This email tests Reply-To header functionality'
+  });
+
+  const result = await smtpClient.sendMail(email);
+  expect(result).toBeDefined();
+  expect(result.messageId).toBeDefined();
+  
+  console.log('Successfully sent email with Reply-To header');
+
+  await smtpClient.close();
+});
+
+tap.test('CEP-05: Multiple Reply-To addresses', async () => {
+  console.log('Testing multiple Reply-To addresses');
+  
+  const smtpClient = createSmtpClient({
+    host: testServer.hostname,
+    port: testServer.port,
+    secure: false,
+    connectionTimeout: 5000,
+    debug: true
+  });
+
+  // Create email with multiple Reply-To addresses
+  const email = new Email({
+    from: 'sender@example.com',
+    to: ['recipient@example.com'],
+    replyTo: ['reply1@example.com', 'reply2@example.com'],
+    subject: 'Multiple Reply-To Test',
+    text: 'This email tests multiple Reply-To addresses'
+  });
+
+  const result = await smtpClient.sendMail(email);
+  expect(result).toBeDefined();
+  expect(result.messageId).toBeDefined();
+  
+  console.log('Successfully sent email with multiple Reply-To addresses');
+
+  await smtpClient.close();
+});
+
+tap.test('CEP-05: Reply-To with display names', async () => {
+  console.log('Testing Reply-To with display names');
+  
+  const smtpClient = createSmtpClient({
+    host: testServer.hostname,
+    port: testServer.port,
+    secure: false,
+    connectionTimeout: 5000,
+    debug: true
+  });
+
+  // Create email with Reply-To containing display names
+  const email = new Email({
+    from: 'sender@example.com',
+    to: ['recipient@example.com'],
+    replyTo: 'Support Team <support@example.com>',
+    subject: 'Reply-To Display Name Test',
+    text: 'This email tests Reply-To with display names'
+  });
+
+  const result = await smtpClient.sendMail(email);
+  expect(result).toBeDefined();
+  expect(result.messageId).toBeDefined();
+  
+  console.log('Successfully sent email with Reply-To display name');
+
+  await smtpClient.close();
+});
+
+tap.test('CEP-05: Return-Path header', async () => {
+  console.log('Testing Return-Path header');
+  
+  const smtpClient = createSmtpClient({
+    host: testServer.hostname,
+    port: testServer.port,
+    secure: false,
+    connectionTimeout: 5000,
+    debug: true
+  });
+
+  // Create email with custom Return-Path
+  const email = new Email({
+    from: 'sender@example.com',
+    to: ['recipient@example.com'],
+    subject: 'Return-Path Test',
+    text: 'This email tests Return-Path functionality',
+    headers: {
+      'Return-Path': '<bounces@example.com>'
+    }
+  });
+
+  const result = await smtpClient.sendMail(email);
+  expect(result).toBeDefined();
+  expect(result.messageId).toBeDefined();
+  
+  console.log('Successfully sent email with Return-Path header');
+
+  await smtpClient.close();
+});
+
+tap.test('CEP-05: Different From and Return-Path', async () => {
+  console.log('Testing different From and Return-Path addresses');
+  
+  const smtpClient = createSmtpClient({
+    host: testServer.hostname,
+    port: testServer.port,
+    secure: false,
+    connectionTimeout: 5000,
+    debug: true
+  });
+
+  // Create email with different From and Return-Path
+  const email = new Email({
+    from: 'noreply@example.com',
+    to: ['recipient@example.com'],
+    subject: 'Different Return-Path Test',
+    text: 'This email has different From and Return-Path addresses',
+    headers: {
+      'Return-Path': '<bounces+tracking@example.com>'
+    }
+  });
+
+  const result = await smtpClient.sendMail(email);
+  expect(result).toBeDefined();
+  expect(result.messageId).toBeDefined();
+  
+  console.log('Successfully sent email with different From and Return-Path');
+
+  await smtpClient.close();
+});
+
+tap.test('CEP-05: Reply-To and Return-Path together', async () => {
+  console.log('Testing Reply-To and Return-Path together');
+  
+  const smtpClient = createSmtpClient({
+    host: testServer.hostname,
+    port: testServer.port,
+    secure: false,
+    connectionTimeout: 5000,
+    debug: true
+  });
+
+  // Create email with both Reply-To and Return-Path
+  const email = new Email({
+    from: 'notifications@example.com',
+    to: ['user@example.com'],
+    replyTo: 'support@example.com',
+    subject: 'Reply-To and Return-Path Test',
+    text: 'This email tests both Reply-To and Return-Path headers',
+    headers: {
+      'Return-Path': '<bounces@example.com>'
+    }
+  });
+
+  const result = await smtpClient.sendMail(email);
+  expect(result).toBeDefined();
+  expect(result.messageId).toBeDefined();
+  
+  console.log('Successfully sent email with both Reply-To and Return-Path');
+
+  await smtpClient.close();
+});
+
+tap.test('CEP-05: International characters in Reply-To', async () => {
+  console.log('Testing international characters in Reply-To');
+  
+  const smtpClient = createSmtpClient({
+    host: testServer.hostname,
+    port: testServer.port,
+    secure: false,
+    connectionTimeout: 5000,
+    debug: true
+  });
+
+  // Create email with international characters in Reply-To
+  const email = new Email({
+    from: 'sender@example.com',
+    to: ['recipient@example.com'],
+    replyTo: 'Suppört Téam <support@example.com>',
+    subject: 'International Reply-To Test',
+    text: 'This email tests international characters in Reply-To'
+  });
+
+  const result = await smtpClient.sendMail(email);
+  expect(result).toBeDefined();
+  expect(result.messageId).toBeDefined();
+  
+  console.log('Successfully sent email with international Reply-To');
+
+  await smtpClient.close();
+});
+
+tap.test('CEP-05: Empty and invalid Reply-To handling', async () => {
+  console.log('Testing empty and invalid Reply-To handling');
+  
+  const smtpClient = createSmtpClient({
+    host: testServer.hostname,
+    port: testServer.port,
+    secure: false,
+    connectionTimeout: 5000,
+    debug: true
+  });
+
+  // Test with empty Reply-To (should work)
+  const email1 = new Email({
+    from: 'sender@example.com',
+    to: ['recipient@example.com'],
+    subject: 'No Reply-To Test',
+    text: 'This email has no Reply-To header'
+  });
+
+  const result1 = await smtpClient.sendMail(email1);
+  expect(result1).toBeDefined();
+  expect(result1.messageId).toBeDefined();
+  
+  console.log('Successfully sent email without Reply-To');
+
+  // Test with empty string Reply-To
+  const email2 = new Email({
+    from: 'sender@example.com',
+    to: ['recipient@example.com'],
+    replyTo: '',
+    subject: 'Empty Reply-To Test',
+    text: 'This email has empty Reply-To'
+  });
+
+  const result2 = await smtpClient.sendMail(email2);
+  expect(result2).toBeDefined();
+  expect(result2.messageId).toBeDefined();
+  
+  console.log('Successfully sent email with empty Reply-To');
+
+  await smtpClient.close();
+});
+
+tap.test('cleanup test SMTP server', async () => {
+  if (testServer) {
+    await stopTestServer(testServer);
+  }
+});
+
+export default tap.start();

package/test/suite/smtpclient_email-composition/test.cep-06.utf8-international.ts

@@ -0,0 +1,235 @@
+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: 2579,
+    tlsEnabled: false,
+    authRequired: false
+  });
+  expect(testServer).toBeTruthy();
+  expect(testServer.port).toEqual(2579);
+});
+
+tap.test('CEP-06: Basic UTF-8 characters', async () => {
+  console.log('Testing basic UTF-8 characters');
+  
+  const smtpClient = createSmtpClient({
+    host: testServer.hostname,
+    port: testServer.port,
+    secure: false,
+    connectionTimeout: 5000,
+    debug: true
+  });
+
+  // Email with basic UTF-8 characters
+  const email = new Email({
+    from: 'sender@example.com',
+    to: ['recipient@example.com'],
+    subject: 'UTF-8 Test: café, naïve, résumé',
+    text: 'This email contains UTF-8 characters: café, naïve, résumé, piñata',
+    html: '<p>HTML with UTF-8: <strong>café</strong>, <em>naïve</em>, résumé, piñata</p>'
+  });
+
+  const result = await smtpClient.sendMail(email);
+  expect(result).toBeDefined();
+  expect(result.messageId).toBeDefined();
+  
+  console.log('Successfully sent email with basic UTF-8 characters');
+
+  await smtpClient.close();
+});
+
+tap.test('CEP-06: European characters', async () => {
+  console.log('Testing European characters');
+  
+  const smtpClient = createSmtpClient({
+    host: testServer.hostname,
+    port: testServer.port,
+    secure: false,
+    connectionTimeout: 5000,
+    debug: true
+  });
+
+  // Email with European characters
+  const email = new Email({
+    from: 'sender@example.com',
+    to: ['recipient@example.com'],
+    subject: 'European: ñ, ü, ø, å, ß, æ',
+    text: [
+      'German: Müller, Größe, Weiß',
+      'Spanish: niño, señor, España',
+      'French: français, crème, être',
+      'Nordic: København, Göteborg, Ålesund',
+      'Polish: Kraków, Gdańsk, Wrocław'
+    ].join('\n'),
+    html: `
+      <h1>European Characters Test</h1>
+      <ul>
+        <li>German: Müller, Größe, Weiß</li>
+        <li>Spanish: niño, señor, España</li>
+        <li>French: français, crème, être</li>
+        <li>Nordic: København, Göteborg, Ålesund</li>
+        <li>Polish: Kraków, Gdańsk, Wrocław</li>
+      </ul>
+    `
+  });
+
+  const result = await smtpClient.sendMail(email);
+  expect(result).toBeDefined();
+  expect(result.messageId).toBeDefined();
+  
+  console.log('Successfully sent email with European characters');
+
+  await smtpClient.close();
+});
+
+tap.test('CEP-06: Asian characters', async () => {
+  console.log('Testing Asian characters');
+  
+  const smtpClient = createSmtpClient({
+    host: testServer.hostname,
+    port: testServer.port,
+    secure: false,
+    connectionTimeout: 5000,
+    debug: true
+  });
+
+  // Email with Asian characters
+  const email = new Email({
+    from: 'sender@example.com',
+    to: ['recipient@example.com'],
+    subject: 'Asian: 你好, こんにちは, 안녕하세요',
+    text: [
+      'Chinese (Simplified): 你好世界',
+      'Chinese (Traditional): 你好世界',
+      'Japanese: こんにちは世界',
+      'Korean: 안녕하세요 세계',
+      'Thai: สวัสดีโลก',
+      'Hindi: नमस्ते संसार'
+    ].join('\n'),
+    html: `
+      <h1>Asian Characters Test</h1>
+      <table>
+        <tr><td>Chinese (Simplified):</td><td>你好世界</td></tr>
+        <tr><td>Chinese (Traditional):</td><td>你好世界</td></tr>
+        <tr><td>Japanese:</td><td>こんにちは世界</td></tr>
+        <tr><td>Korean:</td><td>안녕하세요 세계</td></tr>
+        <tr><td>Thai:</td><td>สวัสดีโลก</td></tr>
+        <tr><td>Hindi:</td><td>नमस्ते संसार</td></tr>
+      </table>
+    `
+  });
+
+  const result = await smtpClient.sendMail(email);
+  expect(result).toBeDefined();
+  expect(result.messageId).toBeDefined();
+  
+  console.log('Successfully sent email with Asian characters');
+
+  await smtpClient.close();
+});
+
+tap.test('CEP-06: Emojis and symbols', async () => {
+  console.log('Testing emojis and symbols');
+  
+  const smtpClient = createSmtpClient({
+    host: testServer.hostname,
+    port: testServer.port,
+    secure: false,
+    connectionTimeout: 5000,
+    debug: true
+  });
+
+  // Email with emojis and symbols
+  const email = new Email({
+    from: 'sender@example.com',
+    to: ['recipient@example.com'],
+    subject: 'Emojis: 🎉 🚀 ✨ 🌈',
+    text: [
+      'Faces: 😀 😃 😄 😁 😆 😅 😂',
+      'Objects: 🎉 🚀 ✨ 🌈 ⭐ 🔥 💎',
+      'Animals: 🐶 🐱 🐭 🐹 🐰 🦊 🐻',
+      'Food: 🍎 🍌 🍇 🍓 🥝 🍅 🥑',
+      'Symbols: ✓ ✗ ⚠ ♠ ♣ ♥ ♦',
+      'Math: ∑ ∏ ∫ ∞ ± × ÷ ≠ ≤ ≥'
+    ].join('\n'),
+    html: `
+      <h1>Emojis and Symbols Test 🎉</h1>
+      <p>Faces: 😀 😃 😄 😁 😆 😅 😂</p>
+      <p>Objects: 🎉 🚀 ✨ 🌈 ⭐ 🔥 💎</p>
+      <p>Animals: 🐶 🐱 🐭 🐹 🐰 🦊 🐻</p>
+      <p>Food: 🍎 🍌 🍇 🍓 🥝 🍅 🥑</p>
+      <p>Symbols: ✓ ✗ ⚠ ♠ ♣ ♥ ♦</p>
+      <p>Math: ∑ ∏ ∫ ∞ ± × ÷ ≠ ≤ ≥</p>
+    `
+  });
+
+  const result = await smtpClient.sendMail(email);
+  expect(result).toBeDefined();
+  expect(result.messageId).toBeDefined();
+  
+  console.log('Successfully sent email with emojis and symbols');
+
+  await smtpClient.close();
+});
+
+tap.test('CEP-06: Mixed international content', async () => {
+  console.log('Testing mixed international content');
+  
+  const smtpClient = createSmtpClient({
+    host: testServer.hostname,
+    port: testServer.port,
+    secure: false,
+    connectionTimeout: 5000,
+    debug: true
+  });
+
+  // Email with mixed international content
+  const email = new Email({
+    from: 'sender@example.com',
+    to: ['recipient@example.com'],
+    subject: 'Mixed: Hello 你好 مرحبا こんにちは 🌍',
+    text: [
+      'English: Hello World!',
+      'Chinese: 你好世界！',
+      'Arabic: مرحبا بالعالم!',
+      'Japanese: こんにちは世界！',
+      'Russian: Привет мир!',
+      'Greek: Γεια σας κόσμε!',
+      'Mixed: Hello 世界 🌍 مرحبا こんにちは!'
+    ].join('\n'),
+    html: `
+      <h1>International Mix 🌍</h1>
+      <div style="font-family: Arial, sans-serif;">
+        <p><strong>English:</strong> Hello World!</p>
+        <p><strong>Chinese:</strong> 你好世界！</p>
+        <p><strong>Arabic:</strong> مرحبا بالعالم!</p>
+        <p><strong>Japanese:</strong> こんにちは世界！</p>
+        <p><strong>Russian:</strong> Привет мир!</p>
+        <p><strong>Greek:</strong> Γεια σας κόσμε!</p>
+        <p><strong>Mixed:</strong> Hello 世界 🌍 مرحبا こんにちは!</p>
+      </div>
+    `
+  });
+
+  const result = await smtpClient.sendMail(email);
+  expect(result).toBeDefined();
+  expect(result.messageId).toBeDefined();
+  
+  console.log('Successfully sent email with mixed international content');
+
+  await smtpClient.close();
+});
+
+tap.test('cleanup test SMTP server', async () => {
+  if (testServer) {
+    await stopTestServer(testServer);
+  }
+});
+
+export default tap.start();