email-doc-sender 1.0.1 → 1.0.2

package/dist/config/email.config.d.ts

@@ -0,0 +1,14 @@
+import type { EmailConfig, ValidationResult } from '../types/index.js';
+export declare class ConfigManager {
+    private configPath;
+    private config;
+    constructor(configPath?: string);
+    load(): Promise<EmailConfig>;
+    validate(config: Partial<EmailConfig>): ValidationResult;
+    getConfig(): EmailConfig;
+    private isValidEmail;
+    static maskPassword(password: string): string;
+    logConfig(): void;
+}
+export declare function getConfigManager(configPath?: string): ConfigManager;
+//# sourceMappingURL=email.config.d.ts.map

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,3 +1,4 @@
+#!/usr/bin/env node
 import { createServer, startServer } from './server.js';
 import { getConfigManager } from './config/email.config.js';
 /**

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/server.d.ts

@@ -0,0 +1,10 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+/**
+ * Create and configure MCP server
+ */
+export declare function createServer(): Promise<Server>;
+/**
+ * Start the MCP server with stdio transport
+ */
+export declare function startServer(server: Server): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/services/converter.service.d.ts

@@ -0,0 +1,53 @@
+import type { ConvertedDoc, DocFormat } from '../types/index.js';
+/**
+ * Document converter service
+ * Handles conversion between different document formats for email sending
+ */
+export declare class DocumentConverter {
+    constructor();
+    /**
+     * Convert document content to email-ready format
+     * @param content - The document content to convert
+     * @param format - The format of the input content
+     * @param filename - Required when format is 'attachment'
+     * @returns ConvertedDoc with HTML, text, and optional attachment
+     */
+    convert(content: string, format: DocFormat, filename?: string): Promise<ConvertedDoc>;
+    /**
+     * Convert Markdown to HTML
+     */
+    private convertMarkdown;
+    /**
+     * Validate and wrap HTML content
+     */
+    private convertHtml;
+    /**
+     * Handle plain text content
+     */
+    private convertText;
+    /**
+     * Handle attachment format
+     */
+    private convertAttachment;
+    /**
+     * Wrap HTML content in email-friendly container
+     */
+    private wrapEmailHtml;
+    /**
+     * Basic HTML validation
+     */
+    private validateHtml;
+    /**
+     * Convert HTML to plain text (fallback)
+     */
+    private htmlToPlainText;
+    /**
+     * Escape HTML special characters
+     */
+    private escapeHtml;
+}
+/**
+ * Get or create the singleton DocumentConverter instance
+ */
+export declare function getDocumentConverter(): DocumentConverter;
+//# sourceMappingURL=converter.service.d.ts.map

package/dist/services/email.service.d.ts

@@ -0,0 +1,59 @@
+import type { EmailConfig, EmailOptions, EmailResult, ConvertedDoc } from '../types/index.js';
+/**
+ * Email sending service
+ * Handles SMTP connection and email sending with retry logic
+ */
+export declare class EmailService {
+    private transporter;
+    private config;
+    constructor(config: EmailConfig);
+    /**
+     * Create nodemailer transporter with SMTP config
+     */
+    private createTransporter;
+    /**
+     * Send email with retry logic (exponential backoff)
+     * @param options - Email sending options
+     * @param maxRetries - Maximum number of retry attempts (default: 3)
+     * @returns EmailResult with success status and message ID
+     */
+    send(options: EmailOptions, maxRetries?: number): Promise<EmailResult>;
+    /**
+     * Send converted document
+     * @param to - Recipient email address
+     * @param subject - Email subject
+     * @param doc - Converted document
+     * @returns EmailResult
+     */
+    sendDocument(to: string, subject: string, doc: ConvertedDoc): Promise<EmailResult>;
+    /**
+     * Verify SMTP connection
+     * @returns true if connection successful
+     */
+    verifyConnection(): Promise<boolean>;
+    /**
+     * Check if error is authentication related
+     */
+    private isAuthError;
+    /**
+     * Get safe error message (don't expose sensitive info)
+     */
+    private getSafeErrorMessage;
+    /**
+     * Sleep for specified milliseconds
+     */
+    private sleep;
+    /**
+     * Recreate transporter (e.g., after config change)
+     */
+    recreateTransporter(config: EmailConfig): void;
+}
+/**
+ * Get or create the singleton EmailService instance
+ */
+export declare function getEmailService(): Promise<EmailService>;
+/**
+ * Reset the singleton instance (for testing)
+ */
+export declare function resetEmailService(): void;
+//# sourceMappingURL=email.service.d.ts.map

package/dist/tools/send-email.d.ts

@@ -0,0 +1,10 @@
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+export declare const sendEmailTool: Tool;
+export declare function handleSendEmail(params: Record<string, unknown>): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+//# sourceMappingURL=send-email.d.ts.map

package/dist/types/index.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Document format types supported by the email service
+ */
+export type DocFormat = 'markdown' | 'html' | 'text' | 'attachment';
+/**
+ * Email server configuration for SMTP connection
+ */
+export interface EmailConfig {
+    /** SMTP server hostname (e.g., smtp.gmail.com) */
+    host: string;
+    /** SMTP server port (usually 465 for SSL, 587 for TLS) */
+    port: number;
+    /** Whether to use SSL/TLS for secure connection */
+    secure: boolean;
+    /** SMTP authentication credentials */
+    auth: {
+        /** Email account username */
+        user: string;
+        /** Email password or app-specific password */
+        pass: string;
+    };
+    /** Default sender email address */
+    from: string;
+}
+/**
+ * Parameters for sending an email with document content
+ */
+export interface SendEmailParams {
+    /** Recipient email address (required) */
+    to: string;
+    /** Email subject line (required) */
+    subject: string;
+    /** Document content to send (required) */
+    content: string;
+    /** Format of the document content (required) */
+    format: DocFormat;
+    /** Attachment filename (required when format='attachment') */
+    filename?: string;
+}
+/**
+ * Result of an email send operation
+ */
+export interface EmailResult {
+    /** Whether the email was sent successfully */
+    success: boolean;
+    /** SMTP message ID if successful */
+    messageId?: string;
+    /** Error message if failed */
+    error?: string;
+}
+/**
+ * Converted document ready for email sending
+ */
+export interface ConvertedDoc {
+    /** HTML content for email body */
+    html: string;
+    /** Plain text fallback content */
+    text: string;
+    /** Attachment data if format='attachment' */
+    attachment?: {
+        /** Attachment filename */
+        filename: string;
+        /** Attachment content as buffer */
+        content: Buffer;
+    };
+}
+/**
+ * Email sending options (internal)
+ */
+export interface EmailOptions {
+    /** Recipient address */
+    to: string;
+    /** Email subject */
+    subject: string;
+    /** HTML body content */
+    html?: string;
+    /** Plain text body content */
+    text?: string;
+    /** Attachments */
+    attachments?: Array<{
+        filename: string;
+        content: Buffer;
+    }>;
+}
+/**
+ * Configuration validation result
+ */
+export interface ValidationResult {
+    /** Whether configuration is valid */
+    valid: boolean;
+    /** Validation errors if invalid */
+    errors: string[];
+}
+//# sourceMappingURL=index.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "email-doc-sender",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "MCP server for sending generated documents to email",
   "type": "module",
   "main": "dist/index.js",
@@ -36,5 +36,10 @@
   },
   "engines": {
     "node": ">=18.0.0"
-  }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ]
 }