refactor(utils): rename content helper and unify imports ♻️

- Rename ContentId module file to Content and update barrel exports
- Switch utils and root index imports to namespace based style
- Use type-only re-export in root index for public Types

Author: NeaByteLab

src/index.ts

@@ -1,19 +1,19 @@
-import type { EmailMessage, EmailSender, EmailService, SmtpConnectionConfig } from '@app/Types.ts'
-import { SmtpClient } from '@smtp/index.ts'
-import { isValidConfig } from '@utils/index.ts'
+import type * as Types from '@app/Types.ts'
+import * as SMTP from '@smtp/index.ts'
+import * as Utils from '@utils/index.ts'
 
 /**
  * Main email service for sending messages via SMTP.
  */
-export const mailer: EmailService = {
+export const mailer: Types.EmailService = {
   /**
    * Creates an email transporter with SMTP configuration.
    * @param config - SMTP connection configuration
    * @returns Email sender instance
    * @throws {Error} When configuration is invalid
    */
-  transporter(config: SmtpConnectionConfig): EmailSender {
-    isValidConfig(config)
+  transporter(config: Types.SmtpConnectionConfig): Types.EmailSender {
+    Utils.isValidConfig(config)
     return createTransporter(config)
   }
 }
@@ -23,10 +23,10 @@ export const mailer: EmailService = {
  * @param config - SMTP connection configuration
  * @returns Email sender implementation
  */
-function createTransporter(config: SmtpConnectionConfig): EmailSender {
+function createTransporter(config: Types.SmtpConnectionConfig): Types.EmailSender {
   return {
-    async send(message: EmailMessage): Promise<void> {
-      const client = new SmtpClient(config)
+    async send(message: Types.EmailMessage): Promise<void> {
+      const client = new SMTP.SmtpClient(config)
       try {
         await client.connect()
         await client.sendMessage(message)
@@ -47,4 +47,4 @@ export default mailer
  * Re-exports all type definitions.
  * @description Provides access to all TypeScript interfaces and types.
  */
-export * from '@app/Types.ts'
+export type * from '@app/Types.ts'

src/utils/Attachment.ts

@@ -1,11 +1,11 @@
-import type { EmailAttachment, EmbeddedImage } from '@app/Types.ts'
+import type * as Types from '@app/Types.ts'
 
 /**
  * Validates email attachment data.
  * @param attachment - Attachment to validate
  * @throws {Error} When attachment validation fails
  */
-export function isValidAttachment(attachment: EmailAttachment): void {
+export function isValidAttachment(attachment: Types.EmailAttachment): void {
   if (!attachment) {
     throw new Error('Attachment is required')
   }
@@ -43,7 +43,7 @@ export function isValidAttachment(attachment: EmailAttachment): void {
  * @param attachment - Embedded attachment to validate
  * @throws {Error} When embedded attachment validation fails
  */
-export function isValidEmbedded(attachment: EmbeddedImage): void {
+export function isValidEmbedded(attachment: Types.EmbeddedImage): void {
   isValidAttachment(attachment)
   if (!attachment.cid) {
     throw new Error('Embedded attachment Content-ID is required')

src/utils/Config.ts

@@ -1,11 +1,11 @@
-import type { SmtpAuthCredential, SmtpConnectionConfig } from '@app/Types.ts'
+import type * as Types from '@app/Types.ts'
 
 /**
  * Validates SMTP connection configuration.
  * @param config - SMTP configuration to validate
  * @throws {Error} When configuration validation fails
  */
-export function isValidConfig(config: SmtpConnectionConfig): void {
+export function isValidConfig(config: Types.SmtpConnectionConfig): void {
   if (!config) {
     throw new Error('Configuration is required')
   }
@@ -20,7 +20,7 @@ export function isValidConfig(config: SmtpConnectionConfig): void {
  * @param auth - Authentication credentials to validate
  * @throws {Error} When authentication validation fails
  */
-function validateAuth(auth: SmtpAuthCredential | undefined): void {
+function validateAuth(auth: Types.SmtpAuthCredential | undefined): void {
   if (auth) {
     if (!auth.user || auth.user.length === 0) {
       throw new Error('SMTP auth user is required')

src/utils/ContentId.ts src/utils/Content.tssrc/utils/ContentId.ts renamed to src/utils/Content.ts

@@ -1,4 +1,4 @@
 export * from '@utils/Attachment.ts'
 export * from '@utils/Config.ts'
-export * from '@utils/ContentId.ts'
+export * from '@utils/Content.ts'
 export * from '@utils/Email.ts'