mcp-resend 1.0.0-1

package/dist/config/environment.d.ts

@@ -0,0 +1,152 @@
+/**
+ * Environment Configuration
+ *
+ * Validates and provides access to environment variables with Zod schemas.
+ * Supports API key validation, scopes, tiers, and debug settings.
+ *
+ * @module config/environment
+ */
+import { z } from "zod";
+/**
+ * Tool tiers for dynamic loading.
+ */
+export type ToolTier = "core" | "secondary" | "tertiary" | "all";
+/**
+ * Tool scopes for permission-based access.
+ */
+export type ToolScope = "read" | "write" | "admin";
+/**
+ * Environment configuration schema.
+ *
+ * Validates:
+ * - RESEND_API_KEY: Optional, must start with "re_" if provided
+ * - RESEND_MCP_SCOPES: Optional comma-separated list of scopes
+ * - RESEND_MCP_DEFAULT_TIER: Optional tier setting (core|secondary|tertiary|all)
+ * - RESEND_RATE_LIMIT_MS: Optional rate limit interval
+ * - RESEND_DEBUG: Optional debug flag
+ *
+ * NOTE: If RESEND_API_KEY is not provided, only documentation search is available.
+ */
+declare const envSchema: z.ZodObject<{
+    /**
+     * Resend API key. Optional, but required for API operations.
+     * If not provided, only documentation search tool is available.
+     * Get your key from: https://resend.com/api-keys
+     */
+    RESEND_API_KEY: z.ZodEffects<z.ZodOptional<z.ZodString>, string | undefined, string | undefined>;
+    /**
+     * Comma-separated list of enabled scopes.
+     * Valid values: read, write, admin
+     * Example: "read,write"
+     */
+    RESEND_MCP_SCOPES: z.ZodPipeline<z.ZodEffects<z.ZodOptional<z.ZodString>, string[] | undefined, string | undefined>, z.ZodOptional<z.ZodArray<z.ZodEnum<["read", "write", "admin"]>, "many">>>;
+    /**
+     * Default tool tier to load on startup.
+     * - core: Essential tools only (send_email, list_domains)
+     * - secondary: Core + additional tools (templates, contacts)
+     * - tertiary: All available tools
+     * - all: Alias for tertiary
+     */
+    RESEND_MCP_DEFAULT_TIER: z.ZodEffects<z.ZodDefault<z.ZodEnum<["core", "secondary", "tertiary", "all"]>>, "core" | "secondary" | "tertiary", "core" | "secondary" | "tertiary" | "all" | undefined>;
+    /**
+     * Rate limit interval in milliseconds.
+     * Default: 500ms (2 requests/second)
+     */
+    RESEND_RATE_LIMIT_MS: z.ZodEffects<z.ZodOptional<z.ZodString>, number, string | undefined>;
+    /**
+     * Enable debug logging.
+     * Set to "true", "1", or "yes" to enable.
+     */
+    RESEND_DEBUG: z.ZodEffects<z.ZodOptional<z.ZodString>, boolean, string | undefined>;
+}, "strip", z.ZodTypeAny, {
+    RESEND_MCP_DEFAULT_TIER: "core" | "secondary" | "tertiary";
+    RESEND_RATE_LIMIT_MS: number;
+    RESEND_DEBUG: boolean;
+    RESEND_API_KEY?: string | undefined;
+    RESEND_MCP_SCOPES?: ("read" | "write" | "admin")[] | undefined;
+}, {
+    RESEND_API_KEY?: string | undefined;
+    RESEND_MCP_SCOPES?: string | undefined;
+    RESEND_MCP_DEFAULT_TIER?: "core" | "secondary" | "tertiary" | "all" | undefined;
+    RESEND_RATE_LIMIT_MS?: string | undefined;
+    RESEND_DEBUG?: string | undefined;
+}>;
+/**
+ * Inferred type from the environment schema.
+ */
+export type EnvConfig = z.infer<typeof envSchema>;
+/**
+ * Parsed configuration object.
+ * Provides typed access to validated environment variables.
+ */
+export interface Config {
+    /** Resend API key (undefined if not provided - docs search only mode) */
+    apiKey: string | undefined;
+    /** Enabled scopes (undefined means all scopes) */
+    scopes: ToolScope[] | undefined;
+    /** Default tool tier */
+    defaultTier: Exclude<ToolTier, "all">;
+    /** Rate limit interval in milliseconds */
+    rateLimitMs: number;
+    /** Debug mode enabled */
+    debug: boolean;
+    /** Whether API operations are available (API key is set) */
+    hasApiKey: boolean;
+}
+/**
+ * Load and validate configuration from environment variables.
+ * Caches the result for subsequent calls.
+ *
+ * @throws Error if required environment variables are missing or invalid
+ * @returns Validated configuration object
+ *
+ * @example
+ * ```typescript
+ * const config = loadConfig();
+ * console.error(`Using API key: ${config.apiKey.slice(0, 6)}...`);
+ * ```
+ */
+export declare function loadConfig(): Config;
+/**
+ * Get the current configuration.
+ * Returns cached config or loads it if not yet loaded.
+ *
+ * @throws Error if configuration is invalid
+ * @returns Validated configuration object
+ *
+ * @example
+ * ```typescript
+ * const config = getConfig();
+ * if (config.debug) {
+ *   console.error("Debug mode enabled");
+ * }
+ * ```
+ */
+export declare function getConfig(): Config;
+/**
+ * Check if configuration has been loaded.
+ *
+ * @returns True if configuration is loaded
+ */
+export declare function isConfigLoaded(): boolean;
+/**
+ * Reset the configuration cache.
+ * Forces reload on next getConfig() or loadConfig() call.
+ * Useful for testing or reconfiguration.
+ */
+export declare function resetConfig(): void;
+/**
+ * Validate that a specific scope is enabled.
+ *
+ * @param scope - Scope to check
+ * @returns True if scope is enabled (or if no scopes are configured)
+ */
+export declare function isScopeEnabled(scope: ToolScope): boolean;
+/**
+ * Get enabled scopes, or all scopes if none configured.
+ *
+ * @returns Array of enabled scopes
+ */
+export declare function getEnabledScopes(): ToolScope[];
+export {};
+//# sourceMappingURL=environment.d.ts.map

package/dist/config/environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../../src/config/environment.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,KAAK,CAAC;AAEjE;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAEnD;;;;;;;;;;;GAWG;AACH,QAAA,MAAM,SAAS;IACb;;;;OAIG;;IAQH;;;;OAIG;;IAkBH;;;;;;OAMG;;IAMH;;;OAGG;;IAUH;;;OAGG;;;;;;;;;;;;;;EAQH,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAElD;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB,yEAAyE;IACzE,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,kDAAkD;IAClD,MAAM,EAAE,SAAS,EAAE,GAAG,SAAS,CAAC;IAChC,wBAAwB;IACxB,WAAW,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACtC,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,yBAAyB;IACzB,KAAK,EAAE,OAAO,CAAC;IACf,4DAA4D;IAC5D,SAAS,EAAE,OAAO,CAAC;CACpB;AAOD;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAwDnC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAKlC;AAED;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAED;;;;GAIG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAGlC;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAOxD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,SAAS,EAAE,CAG9C"}

package/dist/config/environment.js

@@ -0,0 +1,217 @@
+/**
+ * Environment Configuration
+ *
+ * Validates and provides access to environment variables with Zod schemas.
+ * Supports API key validation, scopes, tiers, and debug settings.
+ *
+ * @module config/environment
+ */
+import { z } from "zod";
+// NOTE: Use console.error for logging - stdout is reserved for MCP protocol
+const log = (message) => console.error(`[config] ${message}`);
+/**
+ * Environment configuration schema.
+ *
+ * Validates:
+ * - RESEND_API_KEY: Optional, must start with "re_" if provided
+ * - RESEND_MCP_SCOPES: Optional comma-separated list of scopes
+ * - RESEND_MCP_DEFAULT_TIER: Optional tier setting (core|secondary|tertiary|all)
+ * - RESEND_RATE_LIMIT_MS: Optional rate limit interval
+ * - RESEND_DEBUG: Optional debug flag
+ *
+ * NOTE: If RESEND_API_KEY is not provided, only documentation search is available.
+ */
+const envSchema = z.object({
+    /**
+     * Resend API key. Optional, but required for API operations.
+     * If not provided, only documentation search tool is available.
+     * Get your key from: https://resend.com/api-keys
+     */
+    RESEND_API_KEY: z
+        .string()
+        .optional()
+        .refine((key) => !key || key.startsWith("re_"), {
+        message: "RESEND_API_KEY must start with 're_'",
+    }),
+    /**
+     * Comma-separated list of enabled scopes.
+     * Valid values: read, write, admin
+     * Example: "read,write"
+     */
+    RESEND_MCP_SCOPES: z
+        .string()
+        .optional()
+        .transform((val) => {
+        if (!val)
+            return undefined;
+        const scopes = val
+            .split(",")
+            .map((s) => s.trim().toLowerCase())
+            .filter((s) => s.length > 0);
+        return scopes.length > 0 ? scopes : undefined;
+    })
+        .pipe(z
+        .array(z.enum(["read", "write", "admin"]))
+        .optional()),
+    /**
+     * Default tool tier to load on startup.
+     * - core: Essential tools only (send_email, list_domains)
+     * - secondary: Core + additional tools (templates, contacts)
+     * - tertiary: All available tools
+     * - all: Alias for tertiary
+     */
+    RESEND_MCP_DEFAULT_TIER: z
+        .enum(["core", "secondary", "tertiary", "all"])
+        .default("core")
+        .transform((tier) => (tier === "all" ? "tertiary" : tier)),
+    /**
+     * Rate limit interval in milliseconds.
+     * Default: 500ms (2 requests/second)
+     */
+    RESEND_RATE_LIMIT_MS: z
+        .string()
+        .optional()
+        .transform((val) => {
+        if (!val)
+            return 500;
+        const parsed = parseInt(val, 10);
+        return isNaN(parsed) ? 500 : Math.max(0, parsed);
+    }),
+    /**
+     * Enable debug logging.
+     * Set to "true", "1", or "yes" to enable.
+     */
+    RESEND_DEBUG: z
+        .string()
+        .optional()
+        .transform((val) => {
+        if (!val)
+            return false;
+        return ["true", "1", "yes"].includes(val.toLowerCase());
+    }),
+});
+/**
+ * Module-level configuration cache.
+ */
+let cachedConfig = null;
+/**
+ * Load and validate configuration from environment variables.
+ * Caches the result for subsequent calls.
+ *
+ * @throws Error if required environment variables are missing or invalid
+ * @returns Validated configuration object
+ *
+ * @example
+ * ```typescript
+ * const config = loadConfig();
+ * console.error(`Using API key: ${config.apiKey.slice(0, 6)}...`);
+ * ```
+ */
+export function loadConfig() {
+    if (cachedConfig) {
+        return cachedConfig;
+    }
+    const result = envSchema.safeParse(process.env);
+    if (!result.success) {
+        const errors = result.error.errors
+            .map((e) => `  - ${e.path.join(".")}: ${e.message}`)
+            .join("\n");
+        log("Configuration validation failed:");
+        log(errors);
+        // Provide helpful hints for common issues
+        if (result.error.errors.some((e) => e.path.includes("RESEND_API_KEY"))) {
+            log("");
+            log("Hint: Set your Resend API key:");
+            log('  export RESEND_API_KEY="re_your_api_key_here"');
+            log("  Get your key from: https://resend.com/api-keys");
+        }
+        throw new Error(`Environment configuration invalid:\n${errors}`);
+    }
+    const env = result.data;
+    const hasApiKey = Boolean(env.RESEND_API_KEY);
+    const config = {
+        apiKey: env.RESEND_API_KEY,
+        scopes: env.RESEND_MCP_SCOPES,
+        defaultTier: env.RESEND_MCP_DEFAULT_TIER,
+        rateLimitMs: env.RESEND_RATE_LIMIT_MS,
+        debug: env.RESEND_DEBUG,
+        hasApiKey,
+    };
+    cachedConfig = config;
+    if (config.debug) {
+        log("Configuration loaded:");
+        log(`  API Key: ${hasApiKey ? config.apiKey.slice(0, 6) + "..." : "(not set - docs only mode)"}`);
+        log(`  Scopes: ${config.scopes?.join(", ") || "all"}`);
+        log(`  Default Tier: ${config.defaultTier}`);
+        log(`  Rate Limit: ${config.rateLimitMs}ms`);
+        log(`  Debug: ${config.debug}`);
+    }
+    if (!hasApiKey) {
+        log("Running in documentation-only mode (no API key provided)");
+        log("Only search_resend_documentation tool is available");
+        log("Set RESEND_API_KEY to enable all tools");
+    }
+    return config;
+}
+/**
+ * Get the current configuration.
+ * Returns cached config or loads it if not yet loaded.
+ *
+ * @throws Error if configuration is invalid
+ * @returns Validated configuration object
+ *
+ * @example
+ * ```typescript
+ * const config = getConfig();
+ * if (config.debug) {
+ *   console.error("Debug mode enabled");
+ * }
+ * ```
+ */
+export function getConfig() {
+    if (!cachedConfig) {
+        return loadConfig();
+    }
+    return cachedConfig;
+}
+/**
+ * Check if configuration has been loaded.
+ *
+ * @returns True if configuration is loaded
+ */
+export function isConfigLoaded() {
+    return cachedConfig !== null;
+}
+/**
+ * Reset the configuration cache.
+ * Forces reload on next getConfig() or loadConfig() call.
+ * Useful for testing or reconfiguration.
+ */
+export function resetConfig() {
+    cachedConfig = null;
+    log("Configuration cache cleared");
+}
+/**
+ * Validate that a specific scope is enabled.
+ *
+ * @param scope - Scope to check
+ * @returns True if scope is enabled (or if no scopes are configured)
+ */
+export function isScopeEnabled(scope) {
+    const config = getConfig();
+    // If no scopes configured, all scopes are enabled
+    if (!config.scopes) {
+        return true;
+    }
+    return config.scopes.includes(scope);
+}
+/**
+ * Get enabled scopes, or all scopes if none configured.
+ *
+ * @returns Array of enabled scopes
+ */
+export function getEnabledScopes() {
+    const config = getConfig();
+    return config.scopes || ["read", "write", "admin"];
+}
+//# sourceMappingURL=environment.js.map

package/dist/config/environment.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+/**
+ * Resend MCP Server
+ *
+ * MCP server for the Resend email API. Enables AI assistants to send emails,
+ * manage domains, contacts, and templates via the Model Context Protocol.
+ *
+ * @module resend-mcp-server
+ * @version 1.0.0
+ * @license Apache-2.0
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;GASG"}

package/dist/index.js

@@ -0,0 +1,119 @@
+#!/usr/bin/env node
+/**
+ * Resend MCP Server
+ *
+ * MCP server for the Resend email API. Enables AI assistants to send emails,
+ * manage domains, contacts, and templates via the Model Context Protocol.
+ *
+ * @module resend-mcp-server
+ * @version 1.0.0
+ * @license Apache-2.0
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { Resend } from "resend";
+import { loadConfig } from "./config/environment.js";
+import { configureRateLimiter } from "./services/rate-limiter.js";
+import { initializeRegistry, loadTier, getEnabledTools, getToolExecutor, getRegistryStats, } from "./services/tool-registry.js";
+import { createToolDefinitions } from "./tools/index.js";
+import { createToolResponse, createValidationError } from "./utils/mcp-errors.js";
+// NOTE: Use console.error for logging - stdout is reserved for MCP protocol
+const log = (message) => console.error(`[resend-mcp] ${message}`);
+// ============================================================================
+// Server Setup
+// ============================================================================
+/**
+ * Create and configure the MCP server
+ */
+function createServer(config) {
+    // Initialize Resend client only if API key is provided
+    const resend = config.hasApiKey ? new Resend(config.apiKey) : null;
+    // Configure rate limiter
+    configureRateLimiter({
+        intervalMs: config.rateLimitMs,
+        debug: config.debug,
+    });
+    const server = new Server({
+        name: "resend-mcp-server",
+        version: "1.0.0",
+    }, {
+        capabilities: {
+            tools: {
+                listChanged: true,
+            },
+        },
+    });
+    // Create tool definitions - pass resend client or null for docs-only mode
+    const allTools = createToolDefinitions(resend);
+    // Initialize the tool registry
+    initializeRegistry(server, allTools);
+    // Register tools/list handler - returns only enabled tools
+    server.setRequestHandler(ListToolsRequestSchema, async () => {
+        const tools = getEnabledTools();
+        log(`Returning ${tools.length} enabled tools`);
+        return { tools };
+    });
+    // Register tools/call handler - executes enabled tools
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        log(`Tool called: ${name}`);
+        // Get executor for enabled tool
+        const executor = getToolExecutor(name);
+        if (!executor) {
+            // Check if tool exists but is disabled
+            const stats = getRegistryStats();
+            const isRegistered = stats.totalRegistered > 0;
+            if (isRegistered && !stats.enabledTools.includes(name)) {
+                return createToolResponse(createValidationError(`Tool '${name}' is not enabled in the current tier`, {
+                    enabledTools: stats.enabledTools,
+                    hint: "Use a higher tier to enable more tools",
+                }));
+            }
+            return createToolResponse(createValidationError(`Unknown tool: ${name}`, {
+                availableTools: stats.enabledTools,
+            }));
+        }
+        // Execute the tool
+        return executor(args);
+    });
+    return server;
+}
+// ============================================================================
+// Main Entry Point
+// ============================================================================
+/**
+ * Main entry point
+ */
+async function main() {
+    log("Starting Resend MCP Server v1.0.0");
+    // Load and validate configuration
+    let config;
+    try {
+        config = loadConfig();
+        log(`Configuration loaded (tier: ${config.defaultTier}, rate limit: ${config.rateLimitMs}ms)`);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        log(`Configuration error: ${message}`);
+        process.exit(1);
+    }
+    // Create server
+    const server = createServer(config);
+    // Load tools for the configured tier
+    await loadTier(config.defaultTier);
+    // Log registry stats
+    const stats = getRegistryStats();
+    log(`Tools loaded: ${stats.totalEnabled}/${stats.totalRegistered} (tier: ${config.defaultTier})`);
+    log(`Enabled tools: ${stats.enabledTools.join(", ")}`);
+    // Connect via stdio transport
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    log("Server connected and ready");
+}
+// Run the server
+main().catch((error) => {
+    log(`Fatal error: ${error.message}`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/services/rate-limiter.d.ts

@@ -0,0 +1,90 @@
+/**
+ * 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
+ */
+/**
+ * Default minimum interval between API calls in milliseconds.
+ * Resend free tier allows 2 requests/second, so 500ms provides safety margin.
+ */
+export declare const RATE_LIMIT_INTERVAL_MS = 500;
+/**
+ * Default maximum number of retries for rate-limited requests.
+ */
+export declare const DEFAULT_MAX_RETRIES = 3;
+/**
+ * Configure the rate limiter settings.
+ *
+ * @param options - Configuration options
+ */
+export declare function configureRateLimiter(options: {
+    intervalMs?: number;
+    debug?: boolean;
+}): void;
+/**
+ * Get the current rate limiter configuration.
+ *
+ * @returns Current configuration
+ */
+export declare function getRateLimiterConfig(): {
+    intervalMs: number;
+    queueLength: number;
+    isProcessing: boolean;
+};
+/**
+ * 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 declare function withRateLimit<T>(fn: () => Promise<T>): Promise<T>;
+/**
+ * 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 declare function withRetry<T>(fn: () => Promise<T>, maxRetries?: number): Promise<T>;
+/**
+ * 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 declare function withRateLimitAndRetry<T>(fn: () => Promise<T>, maxRetries?: number): Promise<T>;
+/**
+ * Reset the rate limiter state.
+ * Useful for testing or reconfiguration.
+ */
+export declare function resetRateLimiter(): void;
+//# sourceMappingURL=rate-limiter.d.ts.map

package/dist/services/rate-limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../src/services/rate-limiter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH;;;GAGG;AACH,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAE1C;;GAEG;AACH,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAkCrC;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,GAAG,IAAI,CAQP;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,OAAO,CAAC;CACvB,CAMA;AAkDD;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAQjE;AAiFD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,UAAU,GAAE,MAA4B,GACvC,OAAO,CAAC,CAAC,CAAC,CAiCZ;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,qBAAqB,CAAC,CAAC,EAC3C,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,UAAU,GAAE,MAA4B,GACvC,OAAO,CAAC,CAAC,CAAC,CAEZ;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAOvC"}