domain-search-mcp 1.0.0

package/dist/tools/tld_info.js

@@ -0,0 +1,273 @@
+"use strict";
+/**
+ * tld_info Tool - TLD Information.
+ *
+ * Get information about a Top Level Domain (TLD).
+ * Includes pricing, restrictions, and recommendations.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tldInfoTool = exports.tldInfoSchema = void 0;
+exports.executeTldInfo = executeTldInfo;
+const zod_1 = require("zod");
+const validators_js_1 = require("../utils/validators.js");
+const errors_js_1 = require("../utils/errors.js");
+const cache_js_1 = require("../utils/cache.js");
+/**
+ * Input schema for tld_info.
+ */
+exports.tldInfoSchema = zod_1.z.object({
+    tld: zod_1.z
+        .string()
+        .min(2)
+        .max(63)
+        .describe("The TLD to get information about (e.g., 'com', 'io', 'dev')."),
+    detailed: zod_1.z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe("Whether to include detailed information. Defaults to false."),
+});
+/**
+ * Tool definition for MCP.
+ */
+exports.tldInfoTool = {
+    name: 'tld_info',
+    description: `Get information about a Top Level Domain (TLD).
+
+Returns:
+- Description and typical use case
+- Price range
+- Any special restrictions
+- Popularity and recommendations
+
+Example:
+- tld_info("io") → info about .io domains`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            tld: {
+                type: 'string',
+                description: "The TLD to get info about (e.g., 'com', 'io', 'dev').",
+            },
+            detailed: {
+                type: 'boolean',
+                description: "Include detailed information. Defaults to false.",
+            },
+        },
+        required: ['tld'],
+    },
+};
+/**
+ * Static TLD database.
+ */
+const TLD_DATABASE = {
+    com: {
+        tld: 'com',
+        description: 'Commercial - the most recognized TLD worldwide',
+        typical_use: 'Businesses, commercial websites, general purpose',
+        price_range: { min: 8.88, max: 15.99, currency: 'USD' },
+        renewal_price_typical: 12.99,
+        restrictions: [],
+        popularity: 'high',
+        category: 'generic',
+    },
+    io: {
+        tld: 'io',
+        description: 'British Indian Ocean Territory - popular with tech startups',
+        typical_use: 'Tech startups, SaaS products, developer tools',
+        price_range: { min: 29.88, max: 59.99, currency: 'USD' },
+        renewal_price_typical: 44.99,
+        restrictions: [],
+        popularity: 'high',
+        category: 'country',
+    },
+    dev: {
+        tld: 'dev',
+        description: 'Developer - for software developers and their projects',
+        typical_use: 'Developer portfolios, tools, documentation sites',
+        price_range: { min: 10.18, max: 19.99, currency: 'USD' },
+        renewal_price_typical: 14.99,
+        restrictions: ['Requires HTTPS (HSTS preloaded)'],
+        popularity: 'medium',
+        category: 'new',
+    },
+    app: {
+        tld: 'app',
+        description: 'Application - for mobile and web applications',
+        typical_use: 'Mobile apps, web applications, software products',
+        price_range: { min: 11.18, max: 19.99, currency: 'USD' },
+        renewal_price_typical: 14.99,
+        restrictions: ['Requires HTTPS (HSTS preloaded)'],
+        popularity: 'medium',
+        category: 'new',
+    },
+    co: {
+        tld: 'co',
+        description: 'Colombia / Company - popular alternative to .com',
+        typical_use: 'Companies, startups, short URLs',
+        price_range: { min: 9.48, max: 29.99, currency: 'USD' },
+        renewal_price_typical: 24.99,
+        restrictions: [],
+        popularity: 'high',
+        category: 'country',
+    },
+    net: {
+        tld: 'net',
+        description: 'Network - originally for network providers',
+        typical_use: 'Technology companies, network services, ISPs',
+        price_range: { min: 9.88, max: 14.99, currency: 'USD' },
+        renewal_price_typical: 12.99,
+        restrictions: [],
+        popularity: 'high',
+        category: 'generic',
+    },
+    org: {
+        tld: 'org',
+        description: 'Organization - for non-profits and communities',
+        typical_use: 'Non-profit organizations, open source projects, communities',
+        price_range: { min: 9.88, max: 14.99, currency: 'USD' },
+        renewal_price_typical: 12.99,
+        restrictions: [],
+        popularity: 'high',
+        category: 'generic',
+    },
+    ai: {
+        tld: 'ai',
+        description: 'Anguilla / Artificial Intelligence - trending for AI projects',
+        typical_use: 'AI/ML projects, tech startups, research',
+        price_range: { min: 49.88, max: 99.99, currency: 'USD' },
+        renewal_price_typical: 79.99,
+        restrictions: [],
+        popularity: 'medium',
+        category: 'country',
+    },
+    xyz: {
+        tld: 'xyz',
+        description: 'XYZ - for the next generation of internet users',
+        typical_use: 'Creative projects, personal sites, unconventional brands',
+        price_range: { min: 1.99, max: 12.99, currency: 'USD' },
+        renewal_price_typical: 12.99,
+        restrictions: [],
+        popularity: 'medium',
+        category: 'new',
+    },
+    me: {
+        tld: 'me',
+        description: 'Montenegro - popular for personal brands',
+        typical_use: 'Personal websites, portfolios, URL shorteners',
+        price_range: { min: 9.88, max: 19.99, currency: 'USD' },
+        renewal_price_typical: 17.99,
+        restrictions: [],
+        popularity: 'medium',
+        category: 'country',
+    },
+    sh: {
+        tld: 'sh',
+        description: 'Saint Helena - popular with developers (shell scripts)',
+        typical_use: 'Developer tools, CLI applications, tech projects',
+        price_range: { min: 29.88, max: 49.99, currency: 'USD' },
+        renewal_price_typical: 44.99,
+        restrictions: [],
+        popularity: 'low',
+        category: 'country',
+    },
+    cc: {
+        tld: 'cc',
+        description: 'Cocos Islands - often used as "Creative Commons"',
+        typical_use: 'Creative projects, alternative to .com',
+        price_range: { min: 9.88, max: 24.99, currency: 'USD' },
+        renewal_price_typical: 19.99,
+        restrictions: [],
+        popularity: 'low',
+        category: 'country',
+    },
+};
+/**
+ * Execute the tld_info tool.
+ */
+async function executeTldInfo(input) {
+    try {
+        const { tld, detailed } = exports.tldInfoSchema.parse(input);
+        const normalizedTld = (0, validators_js_1.validateTld)(tld);
+        // Check cache
+        const cacheKey = (0, cache_js_1.tldCacheKey)(normalizedTld);
+        const cached = cache_js_1.tldCache.get(cacheKey);
+        if (cached) {
+            return formatResponse(cached, detailed);
+        }
+        // Look up in database
+        const info = TLD_DATABASE[normalizedTld];
+        if (!info) {
+            // Return generic info for unknown TLDs
+            const genericInfo = {
+                tld: normalizedTld,
+                description: `${normalizedTld.toUpperCase()} domain extension`,
+                typical_use: 'General purpose',
+                price_range: { min: 10, max: 50, currency: 'USD' },
+                renewal_price_typical: 20,
+                restrictions: ['Check registrar for specific restrictions'],
+                popularity: 'low',
+                category: 'generic',
+            };
+            return formatResponse(genericInfo, detailed);
+        }
+        // Cache the result
+        cache_js_1.tldCache.set(cacheKey, info);
+        return formatResponse(info, detailed);
+    }
+    catch (error) {
+        throw (0, errors_js_1.wrapError)(error);
+    }
+}
+/**
+ * Format the response with insights.
+ */
+function formatResponse(info, detailed) {
+    const insights = [];
+    let recommendation = '';
+    // Generate insights
+    if (info.popularity === 'high') {
+        insights.push(`✅ .${info.tld} is highly recognized and trusted`);
+    }
+    else if (info.popularity === 'medium') {
+        insights.push(`💡 .${info.tld} is gaining popularity in specific niches`);
+    }
+    else {
+        insights.push(`⚠️ .${info.tld} is less common - may need more brand building`);
+    }
+    if (info.restrictions.length > 0) {
+        insights.push(`⚠️ Special requirements: ${info.restrictions.join(', ')}`);
+    }
+    if (info.price_range.min <= 10) {
+        insights.push(`💰 Budget-friendly starting at $${info.price_range.min}/year`);
+    }
+    else if (info.price_range.min >= 40) {
+        insights.push(`💸 Premium pricing starting at $${info.price_range.min}/year`);
+    }
+    // Generate recommendation
+    switch (info.tld) {
+        case 'com':
+            recommendation = 'Best for mainstream businesses and maximum recognition';
+            break;
+        case 'io':
+            recommendation = 'Perfect for tech startups and SaaS products';
+            break;
+        case 'dev':
+            recommendation = 'Ideal for developers and tech portfolios (requires HTTPS)';
+            break;
+        case 'app':
+            recommendation = 'Great for mobile/web applications (requires HTTPS)';
+            break;
+        case 'ai':
+            recommendation = 'Trending choice for AI/ML projects, but pricey';
+            break;
+        default:
+            recommendation = `Good choice for ${info.typical_use.toLowerCase()}`;
+    }
+    return {
+        ...info,
+        insights,
+        recommendation,
+    };
+}
+//# sourceMappingURL=tld_info.js.map

package/dist/tools/tld_info.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,193 @@
+/**
+ * Domain Search MCP - Core Type Definitions
+ *
+ * These types define the data structures used throughout the MCP server.
+ * They're designed for clarity and self-documentation.
+ */
+/**
+ * Complete information about a domain's availability and pricing.
+ * This is the primary output type for domain searches.
+ */
+export interface DomainResult {
+    /** Full domain name including TLD (e.g., "vibecoding.com") */
+    domain: string;
+    /** Whether the domain is available for registration */
+    available: boolean;
+    /** Is this a premium/reserved domain with special pricing? */
+    premium: boolean;
+    /** First year registration price in the specified currency */
+    price_first_year: number | null;
+    /** Annual renewal price after first year */
+    price_renewal: number | null;
+    /** Currency code (e.g., "USD", "EUR") */
+    currency: string;
+    /** Is WHOIS privacy protection included for free? */
+    privacy_included: boolean;
+    /** Cost to transfer domain to this registrar */
+    transfer_price: number | null;
+    /** Registrar name (e.g., "porkbun", "namecheap") */
+    registrar: string;
+    /** Data source used for this result */
+    source: DataSource;
+    /** ISO 8601 timestamp of when this was checked */
+    checked_at: string;
+    /** If premium, explains why (e.g., "Popular keyword") */
+    premium_reason?: string;
+    /** Any restrictions on this TLD (e.g., "Requires ID verification") */
+    tld_restrictions?: string[];
+    /** Quality score 0-10 (factors: price, privacy, renewal) */
+    score?: number;
+    /** Domain registration date (ISO 8601) - for taken domains */
+    registered_at?: string;
+    /** Domain expiration date (ISO 8601) - for taken domains */
+    expires_at?: string;
+    /** Days until expiration (calculated) */
+    days_until_expiration?: number;
+}
+/**
+ * Where the domain data came from.
+ * Order matters: earlier sources are preferred.
+ */
+export type DataSource = 'porkbun_api' | 'namecheap_api' | 'godaddy_api' | 'rdap' | 'whois' | 'cache';
+/**
+ * Complete response from a domain search operation.
+ * Includes results plus human-readable insights.
+ */
+export interface SearchResponse {
+    /** Array of domain results */
+    results: DomainResult[];
+    /** Human-readable insights about the results */
+    insights: string[];
+    /** Suggested next actions */
+    next_steps: string[];
+    /** Was this served from cache? */
+    from_cache: boolean;
+    /** Total time taken in milliseconds */
+    duration_ms: number;
+}
+/**
+ * Information about a Top Level Domain (TLD).
+ */
+export interface TLDInfo {
+    /** The TLD extension without dot (e.g., "com", "io") */
+    tld: string;
+    /** Human-readable description */
+    description: string;
+    /** Typical use case */
+    typical_use: string;
+    /** Price range for first year registration */
+    price_range: {
+        min: number;
+        max: number;
+        currency: string;
+    };
+    /** Typical renewal price */
+    renewal_price_typical: number;
+    /** Are there special restrictions? */
+    restrictions: string[];
+    /** Is this TLD popular/recommended? */
+    popularity: 'high' | 'medium' | 'low';
+    /** Category of the TLD */
+    category: 'generic' | 'country' | 'sponsored' | 'new';
+}
+/**
+ * Platforms supported for social handle checking.
+ */
+export type SocialPlatform = 'github' | 'twitter' | 'instagram' | 'linkedin' | 'tiktok' | 'reddit' | 'youtube' | 'npm' | 'pypi' | 'producthunt';
+/**
+ * Result of checking a social handle.
+ */
+export interface SocialHandleResult {
+    platform: SocialPlatform;
+    handle: string;
+    available: boolean;
+    url: string;
+    checked_at: string;
+    /** Some platforms can't be reliably checked */
+    confidence: 'high' | 'medium' | 'low';
+}
+/**
+ * Comparison result across multiple registrars.
+ */
+export interface RegistrarComparison {
+    domain: string;
+    comparisons: DomainResult[];
+    best_first_year: {
+        registrar: string;
+        price: number;
+        currency: string;
+    } | null;
+    best_renewal: {
+        registrar: string;
+        price: number;
+        currency: string;
+    } | null;
+    recommendation: string;
+    checked_at: string;
+}
+/**
+ * Server configuration loaded from environment variables.
+ */
+export interface Config {
+    porkbun: {
+        apiKey?: string;
+        apiSecret?: string;
+        enabled: boolean;
+    };
+    namecheap: {
+        apiKey?: string;
+        apiUser?: string;
+        clientIp?: string;
+        enabled: boolean;
+    };
+    logLevel: 'debug' | 'info' | 'warn' | 'error';
+    cache: {
+        availabilityTtl: number;
+        pricingTtl: number;
+    };
+    rateLimitPerMinute: number;
+    allowedTlds: string[];
+    denyTlds: string[];
+    dryRun: boolean;
+}
+/**
+ * Structured error with user-friendly message.
+ */
+export interface DomainError {
+    code: string;
+    message: string;
+    userMessage: string;
+    details?: Record<string, unknown>;
+    retryable: boolean;
+    suggestedAction?: string;
+}
+export interface SearchDomainInput {
+    domain_name: string;
+    tlds?: string[];
+    registrars?: string[];
+}
+export interface BulkSearchInput {
+    domains: string[];
+    tld: string;
+    registrar?: string;
+}
+export interface CompareRegistrarsInput {
+    domain: string;
+    tld: string;
+    registrars?: string[];
+}
+export interface SuggestDomainsInput {
+    base_name: string;
+    tld?: string;
+    variants?: ('hyphen' | 'numbers' | 'abbreviations' | 'synonyms')[];
+    max_suggestions?: number;
+}
+export interface TldInfoInput {
+    tld: string;
+    detailed?: boolean;
+}
+export interface CheckSocialsInput {
+    name: string;
+    platforms?: SocialPlatform[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,8DAA8D;IAC9D,MAAM,EAAE,MAAM,CAAC;IAEf,uDAAuD;IACvD,SAAS,EAAE,OAAO,CAAC;IAEnB,8DAA8D;IAC9D,OAAO,EAAE,OAAO,CAAC;IAEjB,8DAA8D;IAC9D,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAEhC,4CAA4C;IAC5C,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7B,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IAEjB,qDAAqD;IACrD,gBAAgB,EAAE,OAAO,CAAC;IAE1B,gDAAgD;IAChD,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAE9B,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAC;IAElB,uCAAuC;IACvC,MAAM,EAAE,UAAU,CAAC;IAEnB,kDAAkD;IAClD,UAAU,EAAE,MAAM,CAAC;IAEnB,yDAAyD;IACzD,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,sEAAsE;IACtE,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAE5B,4DAA4D;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,8DAA8D;IAC9D,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,yCAAyC;IACzC,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED;;;GAGG;AACH,MAAM,MAAM,UAAU,GAClB,aAAa,GACb,eAAe,GACf,aAAa,GACb,MAAM,GACN,OAAO,GACP,OAAO,CAAC;AAEZ;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,8BAA8B;IAC9B,OAAO,EAAE,YAAY,EAAE,CAAC;IAExB,gDAAgD;IAChD,QAAQ,EAAE,MAAM,EAAE,CAAC;IAEnB,6BAA6B;IAC7B,UAAU,EAAE,MAAM,EAAE,CAAC;IAErB,kCAAkC;IAClC,UAAU,EAAE,OAAO,CAAC;IAEpB,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;CACrB;AAMD;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,wDAAwD;IACxD,GAAG,EAAE,MAAM,CAAC;IAEZ,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IAEpB,uBAAuB;IACvB,WAAW,EAAE,MAAM,CAAC;IAEpB,8CAA8C;IAC9C,WAAW,EAAE;QACX,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC;QACZ,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IAEF,4BAA4B;IAC5B,qBAAqB,EAAE,MAAM,CAAC;IAE9B,sCAAsC;IACtC,YAAY,EAAE,MAAM,EAAE,CAAC;IAEvB,uCAAuC;IACvC,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IAEtC,0BAA0B;IAC1B,QAAQ,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,KAAK,CAAC;CACvD;AAMD;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB,QAAQ,GACR,SAAS,GACT,WAAW,GACX,UAAU,GACV,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,KAAK,GACL,MAAM,GACN,aAAa,CAAC;AAElB;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,cAAc,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;CACvC;AAMD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,YAAY,EAAE,CAAC;IAC5B,eAAe,EAAE;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;KAClB,GAAG,IAAI,CAAC;IACT,YAAY,EAAE;QACZ,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;KAClB,GAAG,IAAI,CAAC;IACT,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB;AAMD;;GAEG;AACH,MAAM,WAAW,MAAM;IAErB,OAAO,EAAE;QACP,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,OAAO,CAAC;KAClB,CAAC;IACF,SAAS,EAAE;QACT,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,OAAO,CAAC;KAClB,CAAC;IAGF,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAG9C,KAAK,EAAE;QACL,eAAe,EAAE,MAAM,CAAC;QACxB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IAGF,kBAAkB,EAAE,MAAM,CAAC;IAG3B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,EAAE,MAAM,EAAE,CAAC;IAGnB,MAAM,EAAE,OAAO,CAAC;CACjB;AAMD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,SAAS,EAAE,OAAO,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAMD,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,CAAC,QAAQ,GAAG,SAAS,GAAG,eAAe,GAAG,UAAU,CAAC,EAAE,CAAC;IACnE,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,cAAc,EAAE,CAAC;CAC9B"}

package/dist/types.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Domain Search MCP - Core Type Definitions
+ *
+ * These types define the data structures used throughout the MCP server.
+ * They're designed for clarity and self-documentation.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;;;;GAKG"}

package/dist/utils/cache.d.ts

@@ -0,0 +1,81 @@
+/**
+ * TTL-based In-Memory Cache.
+ *
+ * Simple but effective caching for domain availability and pricing.
+ * Reduces API calls and improves response times.
+ */
+/**
+ * Generic TTL cache with automatic expiration and size limits.
+ *
+ * SECURITY: Implements max size to prevent memory DoS attacks.
+ * When at capacity, evicts least-recently-used (LRU) entries.
+ */
+export declare class TtlCache<T> {
+    private cache;
+    private readonly defaultTtlMs;
+    private readonly maxSize;
+    private cleanupInterval;
+    constructor(defaultTtlSeconds?: number, maxSize?: number);
+    /**
+     * Get a value from cache if it exists and hasn't expired.
+     * Updates lastAccessedAt for LRU tracking.
+     */
+    get(key: string): T | undefined;
+    /**
+     * Set a value in cache with optional custom TTL.
+     * Implements LRU eviction when cache is at capacity.
+     */
+    set(key: string, value: T, ttlMs?: number): void;
+    /**
+     * Evict least recently used entry.
+     * Called when cache is at capacity.
+     */
+    private evictLRU;
+    /**
+     * Check if a key exists and is not expired.
+     */
+    has(key: string): boolean;
+    /**
+     * Delete a specific key.
+     */
+    delete(key: string): boolean;
+    /**
+     * Clear all cache entries.
+     */
+    clear(): void;
+    /**
+     * Get the number of entries in cache.
+     */
+    get size(): number;
+    /**
+     * Remove expired entries.
+     */
+    private cleanup;
+    /**
+     * Stop the cleanup interval (for testing/shutdown).
+     */
+    destroy(): void;
+}
+import type { DomainResult, TLDInfo } from '../types.js';
+/**
+ * Generate a cache key for domain availability.
+ */
+export declare function domainCacheKey(domain: string, source: string): string;
+/**
+ * Generate a cache key for TLD info.
+ */
+export declare function tldCacheKey(tld: string): string;
+/**
+ * Global cache instances.
+ */
+export declare const domainCache: TtlCache<DomainResult>;
+export declare const pricingCache: TtlCache<DomainResult[]>;
+export declare const tldCache: TtlCache<TLDInfo>;
+/**
+ * Get or compute a domain result.
+ */
+export declare function getOrCompute<T>(cache: TtlCache<T>, key: string, compute: () => Promise<T>, ttlMs?: number): Promise<{
+    value: T;
+    fromCache: boolean;
+}>;
+//# sourceMappingURL=cache.d.ts.map

package/dist/utils/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/utils/cache.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkBH;;;;;GAKG;AACH,qBAAa,QAAQ,CAAC,CAAC;IACrB,OAAO,CAAC,KAAK,CAAoC;IACjD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,eAAe,CAA+C;gBAE1D,iBAAiB,GAAE,MAAY,EAAE,OAAO,GAAE,MAA+B;IAQrF;;;OAGG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAsB/B;;;OAGG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAkChD;;;OAGG;IACH,OAAO,CAAC,QAAQ;IAiBhB;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAKzB;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5B;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,OAAO,CAAC,OAAO;IAgBf;;OAEG;IACH,OAAO,IAAI,IAAI;CAOhB;AAMD,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEzD;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAErE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;GAEG;AACH,eAAO,MAAM,WAAW,wBAEvB,CAAC;AAEF,eAAO,MAAM,YAAY,0BAAwD,CAAC;AAElF,eAAO,MAAM,QAAQ,mBAA+B,CAAC;AAErD;;GAEG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAClC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,EAClB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACzB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC;IAAE,KAAK,EAAE,CAAC,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAAC,CAS3C"}