domain-search-mcp 1.0.0

package/dist/registrars/namecheap.js

@@ -0,0 +1,307 @@
+"use strict";
+/**
+ * Namecheap Registrar Adapter.
+ *
+ * Namecheap uses an XML-based API.
+ * API Docs: https://www.namecheap.com/support/api/intro/
+ *
+ * Note: Namecheap requires IP whitelisting for API access.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.namecheapAdapter = exports.NamecheapAdapter = void 0;
+const axios_1 = __importDefault(require("axios"));
+const zod_1 = require("zod");
+const base_js_1 = require("./base.js");
+const config_js_1 = require("../config.js");
+const logger_js_1 = require("../utils/logger.js");
+const errors_js_1 = require("../utils/errors.js");
+const NAMECHEAP_API_BASE = 'https://api.namecheap.com/xml.response';
+const NAMECHEAP_SANDBOX_BASE = 'https://api.sandbox.namecheap.com/xml.response';
+// ═══════════════════════════════════════════════════════════════════════════
+// Zod Schemas for Parsed XML Validation
+// SECURITY: Validate parsed XML data to ensure expected structure
+// ═══════════════════════════════════════════════════════════════════════════
+/**
+ * Schema for parsed domain check result.
+ */
+const NamecheapCheckResultSchema = zod_1.z.object({
+    available: zod_1.z.boolean(),
+    premium: zod_1.z.boolean(),
+    price: zod_1.z.number().optional(),
+    renewalPrice: zod_1.z.number().optional(),
+});
+// ═══════════════════════════════════════════════════════════════════════════
+// XML Parsing Utilities (Internal - hardcoded tags only)
+// ═══════════════════════════════════════════════════════════════════════════
+/**
+ * Allowed XML tags for parsing.
+ * SECURITY: Only these hardcoded tags can be parsed to prevent injection.
+ */
+const ALLOWED_XML_TAGS = new Set([
+    'Error',
+    'Errors',
+    'DomainCheckResult',
+]);
+const ALLOWED_XML_ATTRS = new Set([
+    'Count',
+    'Available',
+    'IsPremiumName',
+    'PremiumRegistrationPrice',
+    'PremiumRenewalPrice',
+]);
+/**
+ * Parse XML response to extract domain info.
+ * Simple regex-based parsing since we don't want xml2js dependency.
+ *
+ * SECURITY: Only parses allowed tags defined in ALLOWED_XML_TAGS.
+ */
+function parseXmlValue(xml, tag) {
+    if (!ALLOWED_XML_TAGS.has(tag)) {
+        logger_js_1.logger.warn('Attempted to parse disallowed XML tag', { tag });
+        return undefined;
+    }
+    // Escape special regex chars in tag name for safety
+    const escapedTag = tag.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    // Reason: tag parameter is validated against ALLOWED_XML_TAGS whitelist above, not user input
+    const regex = new RegExp(`<${escapedTag}>([^<]*)</${escapedTag}>`, 'i'); // nosemgrep: detect-non-literal-regexp
+    const match = xml.match(regex);
+    return match?.[1];
+}
+function parseXmlAttribute(xml, tag, attr) {
+    if (!ALLOWED_XML_TAGS.has(tag)) {
+        logger_js_1.logger.warn('Attempted to parse disallowed XML tag', { tag });
+        return undefined;
+    }
+    if (!ALLOWED_XML_ATTRS.has(attr)) {
+        logger_js_1.logger.warn('Attempted to parse disallowed XML attribute', { attr });
+        return undefined;
+    }
+    // Escape special regex chars for safety
+    const escapedTag = tag.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    const escapedAttr = attr.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    // Reason: tag/attr parameters are validated against ALLOWED_XML_TAGS/ATTRS whitelists above, not user input
+    const regex = new RegExp(`<${escapedTag}[^>]*${escapedAttr}="([^"]*)"`, 'i'); // nosemgrep: detect-non-literal-regexp
+    const match = xml.match(regex);
+    return match?.[1];
+}
+function parseXmlBool(value) {
+    return value?.toLowerCase() === 'true';
+}
+/**
+ * Namecheap adapter implementation.
+ */
+class NamecheapAdapter extends base_js_1.RegistrarAdapter {
+    name = 'Namecheap';
+    id = 'namecheap';
+    client;
+    apiKey;
+    apiUser;
+    useSandbox;
+    constructor() {
+        // Namecheap has stricter rate limits, ~20/min is safe
+        super(20);
+        this.apiKey = config_js_1.config.namecheap.apiKey;
+        this.apiUser = config_js_1.config.namecheap.apiUser;
+        this.useSandbox = false; // Set to true for testing
+        const baseURL = this.useSandbox ? NAMECHEAP_SANDBOX_BASE : NAMECHEAP_API_BASE;
+        this.client = axios_1.default.create({
+            baseURL,
+            timeout: this.timeoutMs,
+        });
+    }
+    /**
+     * Check if Namecheap API is enabled.
+     */
+    isEnabled() {
+        return config_js_1.config.namecheap.enabled;
+    }
+    /**
+     * Search for domain availability.
+     */
+    async search(domain, tld) {
+        if (!this.isEnabled()) {
+            throw new errors_js_1.AuthenticationError('namecheap', 'API credentials not configured');
+        }
+        const fullDomain = `${domain}.${tld}`;
+        logger_js_1.logger.debug('Namecheap search', { domain: fullDomain });
+        try {
+            const result = await this.retryWithBackoff(async () => {
+                const response = await this.client.get('', {
+                    params: {
+                        ApiUser: this.apiUser,
+                        ApiKey: this.apiKey,
+                        UserName: this.apiUser,
+                        ClientIp: this.getClientIp(),
+                        Command: 'namecheap.domains.check',
+                        DomainList: fullDomain,
+                    },
+                });
+                return this.parseCheckResponse(response.data, fullDomain);
+            }, `check ${fullDomain}`);
+            return this.createResult(domain, tld, {
+                available: result.available,
+                premium: result.premium,
+                price_first_year: result.price,
+                price_renewal: result.renewalPrice,
+                privacy_included: false, // Namecheap charges for privacy
+                source: 'namecheap_api',
+                premium_reason: result.premium ? 'Premium domain' : undefined,
+            });
+        }
+        catch (error) {
+            this.handleApiError(error, fullDomain);
+            throw error;
+        }
+    }
+    /**
+     * Parse the check response XML.
+     * SECURITY: Validates parsed result with Zod schema.
+     */
+    parseCheckResponse(xml, domain) {
+        // Check for API errors
+        const errorCount = parseXmlAttribute(xml, 'Errors', 'Count');
+        if (errorCount && parseInt(errorCount, 10) > 0) {
+            const errorMsg = parseXmlValue(xml, 'Error') || 'Unknown API error';
+            if (errorMsg.includes('IP not whitelisted')) {
+                throw new errors_js_1.AuthenticationError('namecheap', 'IP not whitelisted. Add your IP in Namecheap dashboard.');
+            }
+            throw new errors_js_1.RegistrarApiError(this.name, errorMsg);
+        }
+        // Parse domain result
+        const available = parseXmlAttribute(xml, 'DomainCheckResult', 'Available');
+        const isPremium = parseXmlAttribute(xml, 'DomainCheckResult', 'IsPremiumName');
+        const premiumPrice = parseXmlAttribute(xml, 'DomainCheckResult', 'PremiumRegistrationPrice');
+        const premiumRenewal = parseXmlAttribute(xml, 'DomainCheckResult', 'PremiumRenewalPrice');
+        const rawResult = {
+            available: parseXmlBool(available),
+            premium: parseXmlBool(isPremium),
+            price: premiumPrice ? parseFloat(premiumPrice) : undefined,
+            renewalPrice: premiumRenewal ? parseFloat(premiumRenewal) : undefined,
+        };
+        // Validate parsed result with Zod
+        const parseResult = NamecheapCheckResultSchema.safeParse(rawResult);
+        if (!parseResult.success) {
+            logger_js_1.logger.warn('Namecheap API response validation failed', {
+                domain,
+                errors: parseResult.error.errors,
+            });
+            throw new errors_js_1.RegistrarApiError(this.name, 'Invalid API response format');
+        }
+        return parseResult.data;
+    }
+    /**
+     * Get TLD information.
+     */
+    async getTldInfo(tld) {
+        // Namecheap doesn't have a great TLD info endpoint
+        // Return basic info based on known data
+        return {
+            tld,
+            description: `${tld.toUpperCase()} domain`,
+            typical_use: this.getTldUseCase(tld),
+            price_range: {
+                min: 8.88,
+                max: 15.98,
+                currency: 'USD',
+            },
+            renewal_price_typical: 12.98,
+            restrictions: [],
+            popularity: this.getTldPopularity(tld),
+            category: this.getTldCategory(tld),
+        };
+    }
+    /**
+     * Get client IP for API requests.
+     * Namecheap requires this for all API calls.
+     *
+     * SECURITY: We no longer call external services (ipify.org) to get IP.
+     * The IP must be configured via NAMECHEAP_CLIENT_IP environment variable.
+     * This prevents unintended IP disclosure to third parties.
+     */
+    getClientIp() {
+        const clientIp = config_js_1.config.namecheap.clientIp;
+        if (!clientIp) {
+            throw new errors_js_1.AuthenticationError('namecheap', 'NAMECHEAP_CLIENT_IP not configured. Add your whitelisted IP to .env file.');
+        }
+        // Basic IP format validation (IPv4 or IPv6)
+        const ipv4Pattern = /^(\d{1,3}\.){3}\d{1,3}$/;
+        const ipv6Pattern = /^([0-9a-fA-F]{1,4}:){7}[0-9a-fA-F]{1,4}$/;
+        if (!ipv4Pattern.test(clientIp) && !ipv6Pattern.test(clientIp)) {
+            throw new errors_js_1.AuthenticationError('namecheap', `Invalid NAMECHEAP_CLIENT_IP format: "${clientIp}". Must be a valid IPv4 or IPv6 address.`);
+        }
+        return clientIp;
+    }
+    /**
+     * Handle API errors with user-friendly messages.
+     */
+    handleApiError(error, domain) {
+        if (axios_1.default.isAxiosError(error)) {
+            const axiosError = error;
+            if (axiosError.response) {
+                const status = axiosError.response.status;
+                if (status === 401 || status === 403) {
+                    throw new errors_js_1.AuthenticationError('namecheap', 'Invalid API credentials');
+                }
+                if (status === 429) {
+                    throw new errors_js_1.RateLimitError('namecheap');
+                }
+                throw new errors_js_1.RegistrarApiError(this.name, `HTTP ${status}: ${axiosError.message}`, status, error);
+            }
+            if (axiosError.code === 'ECONNABORTED') {
+                throw new errors_js_1.RegistrarApiError(this.name, `Request timed out for ${domain}`, undefined, error);
+            }
+        }
+        throw new errors_js_1.RegistrarApiError(this.name, error instanceof Error ? error.message : 'Unknown error', undefined, error instanceof Error ? error : undefined);
+    }
+    /**
+     * Get typical use case for a TLD.
+     */
+    getTldUseCase(tld) {
+        const useCases = {
+            com: 'General commercial websites',
+            io: 'Tech startups and SaaS products',
+            dev: 'Developer tools and portfolios',
+            app: 'Mobile and web applications',
+            co: 'Companies and startups',
+            net: 'Network services and utilities',
+            org: 'Non-profit organizations',
+        };
+        return useCases[tld] || 'General purpose';
+    }
+    /**
+     * Get TLD popularity rating.
+     */
+    getTldPopularity(tld) {
+        const highPopularity = ['com', 'net', 'org', 'io', 'co'];
+        const mediumPopularity = ['dev', 'app', 'ai', 'me'];
+        if (highPopularity.includes(tld))
+            return 'high';
+        if (mediumPopularity.includes(tld))
+            return 'medium';
+        return 'low';
+    }
+    /**
+     * Get TLD category.
+     */
+    getTldCategory(tld) {
+        const countryTlds = ['uk', 'de', 'fr', 'jp', 'cn', 'au', 'ca', 'us'];
+        const sponsoredTlds = ['edu', 'gov', 'mil'];
+        const newTlds = ['io', 'dev', 'app', 'ai', 'xyz', 'tech', 'cloud'];
+        if (countryTlds.includes(tld))
+            return 'country';
+        if (sponsoredTlds.includes(tld))
+            return 'sponsored';
+        if (newTlds.includes(tld))
+            return 'new';
+        return 'generic';
+    }
+}
+exports.NamecheapAdapter = NamecheapAdapter;
+/**
+ * Singleton instance.
+ */
+exports.namecheapAdapter = new NamecheapAdapter();
+//# sourceMappingURL=namecheap.js.map

package/dist/registrars/namecheap.js.map

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

package/dist/registrars/porkbun.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Porkbun Registrar Adapter.
+ *
+ * Porkbun offers competitive pricing and a JSON API.
+ * API Docs: https://porkbun.com/api/json/v3/documentation
+ */
+import { RegistrarAdapter } from './base.js';
+import type { DomainResult, TLDInfo } from '../types.js';
+/**
+ * Porkbun adapter implementation.
+ */
+export declare class PorkbunAdapter extends RegistrarAdapter {
+    readonly name = "Porkbun";
+    readonly id = "porkbun";
+    private readonly client;
+    private readonly apiKey?;
+    private readonly apiSecret?;
+    private pricingCache;
+    constructor();
+    /**
+     * Check if Porkbun API is enabled.
+     */
+    isEnabled(): boolean;
+    /**
+     * Search for domain availability.
+     */
+    search(domain: string, tld: string): Promise<DomainResult>;
+    /**
+     * Check domain availability.
+     * SECURITY: Validates API response with Zod schema.
+     */
+    private checkAvailability;
+    /**
+     * Get pricing for a TLD.
+     * SECURITY: Validates API response with Zod schema.
+     */
+    private getPricing;
+    /**
+     * Get TLD information.
+     */
+    getTldInfo(tld: string): Promise<TLDInfo | null>;
+    /**
+     * Handle API errors with user-friendly messages.
+     */
+    private handleApiError;
+    /**
+     * Get typical use case for a TLD.
+     */
+    private getTldUseCase;
+    /**
+     * Get TLD popularity rating.
+     */
+    private getTldPopularity;
+    /**
+     * Get TLD category.
+     */
+    private getTldCategory;
+}
+/**
+ * Singleton instance.
+ */
+export declare const porkbunAdapter: PorkbunAdapter;
+//# sourceMappingURL=porkbun.d.ts.map

package/dist/registrars/porkbun.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"porkbun.d.ts","sourceRoot":"","sources":["../../src/registrars/porkbun.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAgEzD;;GAEG;AACH,qBAAa,cAAe,SAAQ,gBAAgB;IAClD,QAAQ,CAAC,IAAI,aAAa;IAC1B,QAAQ,CAAC,EAAE,aAAa;IAExB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAS;IACpC,OAAO,CAAC,YAAY,CAAmF;;IAkBvG;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAkChE;;;OAGG;YACW,iBAAiB;IA8C/B;;;OAGG;YACW,UAAU;IA+DxB;;OAEG;IACG,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAoBtD;;OAEG;IACH,OAAO,CAAC,cAAc;IA0CtB;;OAEG;IACH,OAAO,CAAC,aAAa;IAerB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IASxB;;OAEG;IACH,OAAO,CAAC,cAAc;CAUvB;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,gBAAuB,CAAC"}