mcp-resend 1.0.0-1

package/dist/services/rate-limiter.js

@@ -0,0 +1,267 @@
+/**
+ * Rate Limiter for Resend API
+ *
+ * Provides rate limiting with queue-based processing and exponential backoff retry
+ * to ensure compliance with Resend API rate limits.
+ *
+ * @module services/rate-limiter
+ */
+// NOTE: Use console.error for logging - stdout is reserved for MCP protocol
+const log = (message) => console.error(`[rate-limiter] ${message}`);
+/**
+ * Default minimum interval between API calls in milliseconds.
+ * Resend free tier allows 2 requests/second, so 500ms provides safety margin.
+ */
+export const RATE_LIMIT_INTERVAL_MS = 500;
+/**
+ * Default maximum number of retries for rate-limited requests.
+ */
+export const DEFAULT_MAX_RETRIES = 3;
+/**
+ * Base delay for exponential backoff in milliseconds.
+ */
+const BASE_BACKOFF_MS = 1000;
+/**
+ * Maximum delay for exponential backoff in milliseconds.
+ */
+const MAX_BACKOFF_MS = 32000;
+/**
+ * Module-level state for the rate limiter.
+ */
+let lastCallTime = 0;
+let rateLimitIntervalMs = RATE_LIMIT_INTERVAL_MS;
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const queue = [];
+let isProcessing = false;
+let debugMode = false;
+/**
+ * Configure the rate limiter settings.
+ *
+ * @param options - Configuration options
+ */
+export function configureRateLimiter(options) {
+    if (options.intervalMs !== undefined) {
+        rateLimitIntervalMs = Math.max(0, options.intervalMs);
+        log(`Rate limit interval set to ${rateLimitIntervalMs}ms`);
+    }
+    if (options.debug !== undefined) {
+        debugMode = options.debug;
+    }
+}
+/**
+ * Get the current rate limiter configuration.
+ *
+ * @returns Current configuration
+ */
+export function getRateLimiterConfig() {
+    return {
+        intervalMs: rateLimitIntervalMs,
+        queueLength: queue.length,
+        isProcessing,
+    };
+}
+/**
+ * Sleep for a specified number of milliseconds.
+ *
+ * @param ms - Milliseconds to sleep
+ */
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Process the next item in the queue.
+ * Ensures sequential execution with minimum interval between calls.
+ */
+async function processQueue() {
+    if (isProcessing || queue.length === 0) {
+        return;
+    }
+    isProcessing = true;
+    while (queue.length > 0) {
+        const item = queue.shift();
+        // Calculate time to wait before next call
+        const now = Date.now();
+        const timeSinceLastCall = now - lastCallTime;
+        const waitTime = Math.max(0, rateLimitIntervalMs - timeSinceLastCall);
+        if (waitTime > 0) {
+            if (debugMode) {
+                log(`Waiting ${waitTime}ms before next API call`);
+            }
+            await sleep(waitTime);
+        }
+        // Execute the function
+        try {
+            lastCallTime = Date.now();
+            const result = await item.fn();
+            item.resolve(result);
+        }
+        catch (error) {
+            item.reject(error instanceof Error ? error : new Error(String(error)));
+        }
+    }
+    isProcessing = false;
+}
+/**
+ * Execute a function with rate limiting.
+ * Queues the function and processes it when the rate limit allows.
+ *
+ * @param fn - Async function to execute
+ * @returns Promise resolving to the function result
+ *
+ * @example
+ * ```typescript
+ * const result = await withRateLimit(() => resendClient.emails.send(params));
+ * ```
+ */
+export function withRateLimit(fn) {
+    return new Promise((resolve, reject) => {
+        queue.push({ fn, resolve, reject });
+        // Start processing if not already running
+        // NOTE: Using void to explicitly ignore the promise (fire and forget)
+        void processQueue();
+    });
+}
+/**
+ * Check if an error is a rate limit error (HTTP 429).
+ *
+ * @param error - Error to check
+ * @returns True if the error is a rate limit error
+ */
+function isRateLimitError(error) {
+    if (error instanceof Error) {
+        // Check error message for 429 status
+        if (error.message.includes("429") || error.message.includes("rate limit")) {
+            return true;
+        }
+        // Check if error has a status property
+        const errorWithStatus = error;
+        return errorWithStatus.status === 429 || errorWithStatus.statusCode === 429;
+    }
+    return false;
+}
+/**
+ * Extract Retry-After value from error response.
+ * Supports both seconds (integer) and HTTP-date formats.
+ *
+ * @param error - Error that may contain Retry-After header
+ * @returns Delay in milliseconds, or undefined if not present
+ */
+function extractRetryAfter(error) {
+    if (typeof error !== "object" || error === null) {
+        return undefined;
+    }
+    const errorObj = error;
+    // Check for headers object (common in HTTP client errors)
+    const headers = errorObj.headers;
+    const retryAfterValue = headers?.["retry-after"] ||
+        headers?.["Retry-After"] ||
+        errorObj.retryAfter;
+    if (retryAfterValue === undefined) {
+        return undefined;
+    }
+    // If it's a number, treat as seconds
+    if (typeof retryAfterValue === "number") {
+        return retryAfterValue * 1000;
+    }
+    // Try to parse as integer (seconds)
+    const seconds = parseInt(retryAfterValue, 10);
+    if (!isNaN(seconds)) {
+        return seconds * 1000;
+    }
+    // Try to parse as HTTP-date
+    const date = new Date(retryAfterValue);
+    if (!isNaN(date.getTime())) {
+        const delayMs = date.getTime() - Date.now();
+        return delayMs > 0 ? delayMs : undefined;
+    }
+    return undefined;
+}
+/**
+ * Calculate exponential backoff delay.
+ *
+ * @param attempt - Current attempt number (0-indexed)
+ * @returns Delay in milliseconds
+ */
+function calculateBackoff(attempt) {
+    // Exponential backoff: base * 2^attempt with jitter
+    const exponentialDelay = BASE_BACKOFF_MS * Math.pow(2, attempt);
+    // Add random jitter (0-25% of delay)
+    const jitter = Math.random() * 0.25 * exponentialDelay;
+    return Math.min(exponentialDelay + jitter, MAX_BACKOFF_MS);
+}
+/**
+ * Execute a function with automatic retry on rate limit errors.
+ * Uses exponential backoff with jitter.
+ *
+ * @param fn - Async function to execute
+ * @param maxRetries - Maximum number of retry attempts (default: 3)
+ * @returns Promise resolving to the function result
+ * @throws Error if all retries are exhausted
+ *
+ * @example
+ * ```typescript
+ * const result = await withRetry(
+ *   () => resendClient.emails.send(params),
+ *   3
+ * );
+ * ```
+ */
+export async function withRetry(fn, maxRetries = DEFAULT_MAX_RETRIES) {
+    let lastError;
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error instanceof Error ? error : new Error(String(error));
+            // Only retry on rate limit errors
+            if (!isRateLimitError(error)) {
+                throw lastError;
+            }
+            // Check if we have retries left
+            if (attempt < maxRetries) {
+                // Prefer Retry-After header if present, otherwise use exponential backoff
+                const retryAfterDelay = extractRetryAfter(error);
+                const delay = retryAfterDelay ?? calculateBackoff(attempt);
+                const delaySource = retryAfterDelay ? "Retry-After header" : "exponential backoff";
+                log(`Rate limited (attempt ${attempt + 1}/${maxRetries + 1}), ` +
+                    `retrying in ${Math.round(delay)}ms (${delaySource})`);
+                await sleep(delay);
+            }
+        }
+    }
+    // All retries exhausted
+    throw new Error(`Rate limit exceeded after ${maxRetries + 1} attempts: ${lastError?.message || "Unknown error"}`);
+}
+/**
+ * Execute a function with both rate limiting and retry logic.
+ * This is the recommended function for most Resend API calls.
+ *
+ * @param fn - Async function to execute
+ * @param maxRetries - Maximum number of retry attempts (default: 3)
+ * @returns Promise resolving to the function result
+ *
+ * @example
+ * ```typescript
+ * const result = await withRateLimitAndRetry(
+ *   () => resendClient.emails.send(params),
+ *   3
+ * );
+ * ```
+ */
+export async function withRateLimitAndRetry(fn, maxRetries = DEFAULT_MAX_RETRIES) {
+    return withRateLimit(() => withRetry(fn, maxRetries));
+}
+/**
+ * Reset the rate limiter state.
+ * Useful for testing or reconfiguration.
+ */
+export function resetRateLimiter() {
+    lastCallTime = 0;
+    queue.length = 0;
+    isProcessing = false;
+    rateLimitIntervalMs = RATE_LIMIT_INTERVAL_MS;
+    debugMode = false;
+    log("Rate limiter reset");
+}
+//# sourceMappingURL=rate-limiter.js.map

package/dist/services/rate-limiter.js.map

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

package/dist/services/tool-registry.d.ts

@@ -0,0 +1,219 @@
+/**
+ * Tool Registry for Dynamic MCP Tool Discovery
+ *
+ * Manages tool loading/unloading by tier and scope, enabling dynamic tool discovery
+ * and permission-based access control.
+ *
+ * @module services/tool-registry
+ */
+import type { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import type { ToolScope, ToolTier } from "../config/environment.js";
+/**
+ * Re-export tier and scope types for convenience.
+ */
+export type { ToolTier, ToolScope };
+/**
+ * MCP tool input schema (JSON Schema format).
+ */
+export interface ToolInputSchema {
+    type: "object";
+    properties: Record<string, unknown>;
+    required?: string[];
+}
+/**
+ * Tool annotations for MCP clients.
+ */
+export interface ToolAnnotations {
+    title?: string;
+    readOnlyHint?: boolean;
+    destructiveHint?: boolean;
+    idempotentHint?: boolean;
+    openWorldHint?: boolean;
+}
+/**
+ * MCP tool definition returned to clients.
+ */
+export interface MCPToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: ToolInputSchema;
+    annotations?: ToolAnnotations;
+}
+/**
+ * Tool response format from execute function.
+ * Re-exports SDK's CallToolResult for proper type compatibility.
+ */
+export type ToolResponse = CallToolResult;
+/**
+ * Internal tool definition with metadata.
+ */
+export interface ToolDefinition {
+    /** Unique tool name (e.g., "send_email") */
+    name: string;
+    /** Human-readable description */
+    description: string;
+    /** JSON Schema for input validation */
+    inputSchema: ToolInputSchema;
+    /** Optional MCP annotations */
+    annotations?: ToolAnnotations;
+    /** Tool tier for loading priority */
+    tier: Exclude<ToolTier, "all">;
+    /** Required scopes for this tool */
+    scopes: ToolScope[];
+    /** Execute function for the tool */
+    execute: (args: unknown) => Promise<ToolResponse>;
+}
+/**
+ * Registry statistics for debugging.
+ */
+export interface RegistryStats {
+    /** Total registered tools */
+    totalRegistered: number;
+    /** Currently enabled tools */
+    totalEnabled: number;
+    /** Tools by tier */
+    byTier: {
+        core: number;
+        secondary: number;
+        tertiary: number;
+    };
+    /** Enabled tools by tier */
+    enabledByTier: {
+        core: number;
+        secondary: number;
+        tertiary: number;
+    };
+    /** List of enabled tool names */
+    enabledTools: string[];
+}
+/**
+ * Core tools - essential functionality (always available).
+ */
+export declare const CORE_TOOLS: string[];
+/**
+ * Secondary tools - commonly used features.
+ */
+export declare const SECONDARY_TOOLS: string[];
+/**
+ * Tertiary tools - advanced/admin features.
+ * NOTE: API key operations are EXCLUDED for security reasons.
+ */
+export declare const TERTIARY_TOOLS: string[];
+/**
+ * Initialize the tool registry with an MCP server instance.
+ *
+ * @param server - MCP Server instance for notifications
+ * @param tools - Initial tools to register
+ *
+ * @example
+ * ```typescript
+ * const server = new Server({ name: "resend-mcp" }, { capabilities: { tools: {} } });
+ * initializeRegistry(server, [sendEmailTool, listDomainsTool]);
+ * ```
+ */
+export declare function initializeRegistry(server: Server, tools?: ToolDefinition[]): void;
+/**
+ * Register a tool in the registry.
+ *
+ * @param tool - Tool definition to register
+ */
+export declare function registerTool(tool: ToolDefinition): void;
+/**
+ * Unregister a tool from the registry.
+ *
+ * @param name - Tool name to unregister
+ */
+export declare function unregisterTool(name: string): void;
+/**
+ * Load all tools of a specific tier (and lower tiers).
+ *
+ * @param tier - Tier to load (includes all lower tiers)
+ *
+ * @example
+ * ```typescript
+ * loadTier("secondary"); // Loads core + secondary tools
+ * ```
+ */
+export declare function loadTier(tier: Exclude<ToolTier, "all">): Promise<void>;
+/**
+ * Unload all tools of a specific tier (keeps lower tiers).
+ *
+ * @param tier - Tier to unload
+ *
+ * @example
+ * ```typescript
+ * unloadTier("tertiary"); // Removes only tertiary tools
+ * ```
+ */
+export declare function unloadTier(tier: Exclude<ToolTier, "all">): Promise<void>;
+/**
+ * Load tools by scope(s).
+ *
+ * @param scopes - Scopes to enable
+ *
+ * @example
+ * ```typescript
+ * loadByScope(["read", "write"]); // Enable tools with read or write scope
+ * ```
+ */
+export declare function loadByScope(scopes: ToolScope[]): Promise<void>;
+/**
+ * Unload tools by scope(s).
+ *
+ * @param scopes - Scopes to disable
+ */
+export declare function unloadByScope(scopes: ToolScope[]): Promise<void>;
+/**
+ * Get all currently enabled tools as MCP tool definitions.
+ *
+ * @returns Array of MCP tool definitions
+ */
+export declare function getEnabledTools(): MCPToolDefinition[];
+/**
+ * Check if a tool is currently enabled.
+ *
+ * @param name - Tool name to check
+ * @returns True if tool is enabled
+ */
+export declare function isToolEnabled(name: string): boolean;
+/**
+ * Get a tool definition by name.
+ *
+ * @param name - Tool name
+ * @returns Tool definition or undefined
+ */
+export declare function getTool(name: string): ToolDefinition | undefined;
+/**
+ * Get a tool's execute function if the tool is enabled.
+ *
+ * @param name - Tool name
+ * @returns Execute function or undefined
+ */
+export declare function getToolExecutor(name: string): ((args: unknown) => Promise<ToolResponse>) | undefined;
+/**
+ * Get registry statistics for debugging.
+ *
+ * @returns Registry statistics
+ */
+export declare function getRegistryStats(): RegistryStats;
+/**
+ * Reset the registry to initial state.
+ * Useful for testing or reconfiguration.
+ */
+export declare function resetRegistry(): void;
+/**
+ * Enable a specific tool by name.
+ *
+ * @param name - Tool name to enable
+ * @returns True if tool was enabled
+ */
+export declare function enableTool(name: string): Promise<boolean>;
+/**
+ * Disable a specific tool by name.
+ *
+ * @param name - Tool name to disable
+ * @returns True if tool was disabled
+ */
+export declare function disableTool(name: string): Promise<boolean>;
+//# sourceMappingURL=tool-registry.d.ts.map

package/dist/services/tool-registry.d.ts.map

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