domain-search-mcp 1.0.0

package/dist/registrars/base.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Base Registrar Adapter.
+ *
+ * Abstract class that all registrar adapters extend.
+ * Provides common functionality:
+ * - Rate limiting (token bucket)
+ * - Retry with exponential backoff
+ * - Error handling and logging
+ */
+import type { DomainResult, TLDInfo } from '../types.js';
+/**
+ * Token bucket rate limiter.
+ */
+export declare class RateLimiter {
+    private tokens;
+    private readonly maxTokens;
+    private readonly refillRate;
+    private lastRefill;
+    constructor(maxPerMinute?: number);
+    /**
+     * Try to consume a token. Returns true if successful.
+     */
+    tryConsume(): boolean;
+    /**
+     * Wait until a token is available.
+     */
+    waitForToken(): Promise<void>;
+    /**
+     * Refill tokens based on elapsed time.
+     */
+    private refill;
+    /**
+     * Get seconds until next token is available.
+     */
+    getWaitSeconds(): number;
+}
+/**
+ * Abstract base class for registrar adapters.
+ */
+export declare abstract class RegistrarAdapter {
+    /** Human-readable name of the registrar */
+    abstract readonly name: string;
+    /** Identifier used in results */
+    abstract readonly id: string;
+    /** Rate limiter for this registrar */
+    protected readonly rateLimiter: RateLimiter;
+    /** Max retry attempts */
+    protected readonly maxRetries: number;
+    /** Base delay for exponential backoff (ms) */
+    protected readonly baseDelayMs: number;
+    /** Request timeout (ms) */
+    protected readonly timeoutMs: number;
+    constructor(requestsPerMinute?: number);
+    /**
+     * Check domain availability and get pricing.
+     * This is the main method each adapter must implement.
+     */
+    abstract search(domain: string, tld: string): Promise<DomainResult>;
+    /**
+     * Get information about a TLD.
+     * Optional - not all registrars provide this.
+     */
+    abstract getTldInfo(tld: string): Promise<TLDInfo | null>;
+    /**
+     * Check if this adapter is enabled (has required credentials).
+     */
+    abstract isEnabled(): boolean;
+    /**
+     * Execute a function with rate limiting.
+     */
+    protected rateLimitedCall<T>(fn: () => Promise<T>): Promise<T>;
+    /**
+     * Execute with retry and exponential backoff.
+     */
+    protected retryWithBackoff<T>(fn: () => Promise<T>, operation: string): Promise<T>;
+    /**
+     * Create a timeout wrapper for a promise.
+     */
+    protected withTimeout<T>(promise: Promise<T>, operation: string, timeoutMs?: number): Promise<T>;
+    /**
+     * Log an error with context.
+     */
+    protected logError(error: Error, context?: Record<string, unknown>): void;
+    /**
+     * Create a standardized DomainResult.
+     */
+    protected createResult(domain: string, tld: string, data: Partial<DomainResult>): DomainResult;
+}
+//# sourceMappingURL=base.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/registrars/base.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAUzD;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,UAAU,CAAS;gBAEf,YAAY,GAAE,MAAW;IAOrC;;OAEG;IACH,UAAU,IAAI,OAAO;IAWrB;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAQnC;;OAEG;IACH,OAAO,CAAC,MAAM;IASd;;OAEG;IACH,cAAc,IAAI,MAAM;CAKzB;AASD;;GAEG;AACH,8BAAsB,gBAAgB;IACpC,2CAA2C;IAC3C,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAE/B,iCAAiC;IACjC,QAAQ,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAE7B,sCAAsC;IACtC,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAE5C,yBAAyB;IACzB,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAK;IAE1C,8CAA8C;IAC9C,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAQ;IAE9C,2BAA2B;IAC3B,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAS;gBAEjC,iBAAiB,GAAE,MAAW;IAI1C;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAEnE;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAEzD;;OAEG;IACH,QAAQ,CAAC,SAAS,IAAI,OAAO;IAE7B;;OAEG;cACa,eAAe,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAgBpE;;OAEG;cACa,gBAAgB,CAAC,CAAC,EAChC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,CAAC,CAAC;IA6Cb;;OAEG;IACH,SAAS,CAAC,WAAW,CAAC,CAAC,EACrB,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,SAAS,EAAE,MAAM,EACjB,SAAS,GAAE,MAAuB,GACjC,OAAO,CAAC,CAAC,CAAC;IAkBb;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAOzE;;OAEG;IACH,SAAS,CAAC,YAAY,CACpB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,OAAO,CAAC,YAAY,CAAC,GAC1B,YAAY;CAkBhB"}

package/dist/registrars/base.js

@@ -0,0 +1,203 @@
+"use strict";
+/**
+ * Base Registrar Adapter.
+ *
+ * Abstract class that all registrar adapters extend.
+ * Provides common functionality:
+ * - Rate limiting (token bucket)
+ * - Retry with exponential backoff
+ * - Error handling and logging
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RegistrarAdapter = exports.RateLimiter = void 0;
+const logger_js_1 = require("../utils/logger.js");
+const errors_js_1 = require("../utils/errors.js");
+const config_js_1 = require("../config.js");
+/**
+ * Token bucket rate limiter.
+ */
+class RateLimiter {
+    tokens;
+    maxTokens;
+    refillRate; // tokens per second
+    lastRefill;
+    constructor(maxPerMinute = 60) {
+        this.maxTokens = maxPerMinute;
+        this.tokens = maxPerMinute;
+        this.refillRate = maxPerMinute / 60; // Convert to per-second
+        this.lastRefill = Date.now();
+    }
+    /**
+     * Try to consume a token. Returns true if successful.
+     */
+    tryConsume() {
+        this.refill();
+        if (this.tokens >= 1) {
+            this.tokens -= 1;
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Wait until a token is available.
+     */
+    async waitForToken() {
+        while (!this.tryConsume()) {
+            // Calculate wait time for next token
+            const waitMs = Math.ceil(1000 / this.refillRate);
+            await sleep(waitMs);
+        }
+    }
+    /**
+     * Refill tokens based on elapsed time.
+     */
+    refill() {
+        const now = Date.now();
+        const elapsed = (now - this.lastRefill) / 1000;
+        const refillAmount = elapsed * this.refillRate;
+        this.tokens = Math.min(this.maxTokens, this.tokens + refillAmount);
+        this.lastRefill = now;
+    }
+    /**
+     * Get seconds until next token is available.
+     */
+    getWaitSeconds() {
+        if (this.tokens >= 1)
+            return 0;
+        const neededTokens = 1 - this.tokens;
+        return Math.ceil(neededTokens / this.refillRate);
+    }
+}
+exports.RateLimiter = RateLimiter;
+/**
+ * Sleep helper.
+ */
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Abstract base class for registrar adapters.
+ */
+class RegistrarAdapter {
+    /** Rate limiter for this registrar */
+    rateLimiter;
+    /** Max retry attempts */
+    maxRetries = 3;
+    /** Base delay for exponential backoff (ms) */
+    baseDelayMs = 2000;
+    /** Request timeout (ms) */
+    timeoutMs = 10000;
+    constructor(requestsPerMinute = 60) {
+        this.rateLimiter = new RateLimiter(requestsPerMinute);
+    }
+    /**
+     * Execute a function with rate limiting.
+     */
+    async rateLimitedCall(fn) {
+        // Check if we should even try (dry run mode)
+        if (config_js_1.config.dryRun) {
+            throw new errors_js_1.RegistrarApiError(this.name, 'Dry run mode - no API calls made');
+        }
+        // Wait for rate limit
+        const waitSeconds = this.rateLimiter.getWaitSeconds();
+        if (waitSeconds > 0) {
+            logger_js_1.logger.debug(`Rate limiting: waiting ${waitSeconds}s for ${this.name}`);
+        }
+        await this.rateLimiter.waitForToken();
+        return fn();
+    }
+    /**
+     * Execute with retry and exponential backoff.
+     */
+    async retryWithBackoff(fn, operation) {
+        let lastError;
+        for (let attempt = 1; attempt <= this.maxRetries; attempt++) {
+            try {
+                return await this.rateLimitedCall(fn);
+            }
+            catch (error) {
+                lastError = error instanceof Error ? error : new Error(String(error));
+                // Check if we should retry
+                const wrapped = (0, errors_js_1.wrapError)(error);
+                if (!wrapped.retryable) {
+                    throw wrapped;
+                }
+                // Check if it's a rate limit error with retry-after
+                if (error instanceof errors_js_1.RateLimitError && error.retryAfter) {
+                    const waitMs = error.retryAfter - Date.now();
+                    if (waitMs > 0 && waitMs < 60000) {
+                        logger_js_1.logger.info(`Rate limited, waiting ${waitMs}ms`, {
+                            registrar: this.name,
+                            attempt,
+                        });
+                        await sleep(waitMs);
+                        continue;
+                    }
+                }
+                // Exponential backoff
+                if (attempt < this.maxRetries) {
+                    const delay = this.baseDelayMs * Math.pow(2, attempt - 1);
+                    logger_js_1.logger.warn(`Retry ${attempt}/${this.maxRetries} for ${operation}`, {
+                        registrar: this.name,
+                        delay_ms: delay,
+                        error: lastError.message,
+                    });
+                    await sleep(delay);
+                }
+            }
+        }
+        // All retries failed
+        throw lastError || new Error(`Failed after ${this.maxRetries} retries`);
+    }
+    /**
+     * Create a timeout wrapper for a promise.
+     */
+    withTimeout(promise, operation, timeoutMs = this.timeoutMs) {
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                reject(new errors_js_1.TimeoutError(operation, timeoutMs));
+            }, timeoutMs);
+            promise
+                .then((result) => {
+                clearTimeout(timer);
+                resolve(result);
+            })
+                .catch((error) => {
+                clearTimeout(timer);
+                reject(error);
+            });
+        });
+    }
+    /**
+     * Log an error with context.
+     */
+    logError(error, context) {
+        logger_js_1.logger.logError(`${this.name} error`, error, {
+            registrar: this.id,
+            ...context,
+        });
+    }
+    /**
+     * Create a standardized DomainResult.
+     */
+    createResult(domain, tld, data) {
+        return {
+            domain: `${domain}.${tld}`,
+            available: data.available ?? false,
+            premium: data.premium ?? false,
+            price_first_year: data.price_first_year ?? null,
+            price_renewal: data.price_renewal ?? null,
+            currency: data.currency ?? 'USD',
+            privacy_included: data.privacy_included ?? false,
+            transfer_price: data.transfer_price ?? null,
+            registrar: this.id,
+            source: data.source ?? `${this.id}_api`,
+            checked_at: new Date().toISOString(),
+            premium_reason: data.premium_reason,
+            tld_restrictions: data.tld_restrictions,
+            score: data.score,
+        };
+    }
+}
+exports.RegistrarAdapter = RegistrarAdapter;
+//# sourceMappingURL=base.js.map

package/dist/registrars/base.js.map

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

package/dist/registrars/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Registrar Exports.
+ */
+export { RegistrarAdapter } from './base.js';
+export { PorkbunAdapter, porkbunAdapter } from './porkbun.js';
+export { NamecheapAdapter, namecheapAdapter } from './namecheap.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/registrars/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/registrars/index.js

@@ -0,0 +1,15 @@
+"use strict";
+/**
+ * Registrar Exports.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.namecheapAdapter = exports.NamecheapAdapter = exports.porkbunAdapter = exports.PorkbunAdapter = exports.RegistrarAdapter = void 0;
+var base_js_1 = require("./base.js");
+Object.defineProperty(exports, "RegistrarAdapter", { enumerable: true, get: function () { return base_js_1.RegistrarAdapter; } });
+var porkbun_js_1 = require("./porkbun.js");
+Object.defineProperty(exports, "PorkbunAdapter", { enumerable: true, get: function () { return porkbun_js_1.PorkbunAdapter; } });
+Object.defineProperty(exports, "porkbunAdapter", { enumerable: true, get: function () { return porkbun_js_1.porkbunAdapter; } });
+var namecheap_js_1 = require("./namecheap.js");
+Object.defineProperty(exports, "NamecheapAdapter", { enumerable: true, get: function () { return namecheap_js_1.NamecheapAdapter; } });
+Object.defineProperty(exports, "namecheapAdapter", { enumerable: true, get: function () { return namecheap_js_1.namecheapAdapter; } });
+//# sourceMappingURL=index.js.map

package/dist/registrars/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/registrars/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,qCAA6C;AAApC,2GAAA,gBAAgB,OAAA;AACzB,2CAA8D;AAArD,4GAAA,cAAc,OAAA;AAAE,4GAAA,cAAc,OAAA;AACvC,+CAAoE;AAA3D,gHAAA,gBAAgB,OAAA;AAAE,gHAAA,gBAAgB,OAAA"}

package/dist/registrars/namecheap.d.ts

@@ -0,0 +1,69 @@
+/**
+ * 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.
+ */
+import { RegistrarAdapter } from './base.js';
+import type { DomainResult, TLDInfo } from '../types.js';
+/**
+ * Namecheap adapter implementation.
+ */
+export declare class NamecheapAdapter extends RegistrarAdapter {
+    readonly name = "Namecheap";
+    readonly id = "namecheap";
+    private readonly client;
+    private readonly apiKey?;
+    private readonly apiUser?;
+    private readonly useSandbox;
+    constructor();
+    /**
+     * Check if Namecheap API is enabled.
+     */
+    isEnabled(): boolean;
+    /**
+     * Search for domain availability.
+     */
+    search(domain: string, tld: string): Promise<DomainResult>;
+    /**
+     * Parse the check response XML.
+     * SECURITY: Validates parsed result with Zod schema.
+     */
+    private parseCheckResponse;
+    /**
+     * Get TLD information.
+     */
+    getTldInfo(tld: string): Promise<TLDInfo | null>;
+    /**
+     * 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.
+     */
+    private getClientIp;
+    /**
+     * 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 namecheapAdapter: NamecheapAdapter;
+//# sourceMappingURL=namecheap.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"namecheap.d.ts","sourceRoot":"","sources":["../../src/registrars/namecheap.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AA4FzD;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,gBAAgB;IACpD,QAAQ,CAAC,IAAI,eAAe;IAC5B,QAAQ,CAAC,EAAE,eAAe;IAE1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;;IAkBrC;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IA0ChE;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IA6C1B;;OAEG;IACG,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAmBtD;;;;;;;OAOG;IACH,OAAO,CAAC,WAAW;IAwBnB;;OAEG;IACH,OAAO,CAAC,cAAc;IAyCtB;;OAEG;IACH,OAAO,CAAC,aAAa;IAarB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IASxB;;OAEG;IACH,OAAO,CAAC,cAAc;CAUvB;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB,kBAAyB,CAAC"}