@hasna/domains/dist/lib/capability.d.ts

Domain portfolio, registrar, marketplace, and DNS management for AI agents — CLI + MCP + HTTP API + SDK, shared account API and PostgreSQL

/**
 * Registrar / DNS provider capability matrix (2026) and auto-selection.
 *
 * Captures what each provider can actually do via API, so callers never attempt
 * a gated path silently. Findings (research, 2026):
 *   - Route53 Domains: full self-serve buy API, not volume-gated → primary buy.
 *   - GoDaddy retail: availability remains threshold-gated; DNS/domain
 *     management is available for qualifying accounts; no direct buy adapter.
 *   - Brandsight / GoDaddy Corporate Domains: enterprise-contract-only, but
 *     official v2 API supports portfolio, registration, renewal, nameserver,
 *     and DNS operations.
 *   - Cloudflare: DNS only (no registration) → common default DNS provider.
 *   - Namecheap: buy + DNS via API (sandbox/whitelist required) → usable.
 */
export interface ProviderCapability {
    canBuy: boolean;
    canDns: boolean;
    /** True when the API path exists but requires special access we may not have. */
    gated: boolean;
    notes: string;
}
export declare const PROVIDER_CAPABILITIES: Record<string, ProviderCapability>;
export declare function getCapability(name: string): ProviderCapability;
export declare function canBuy(name: string): boolean;
/**
 * Choose the registrar to buy through. Defaults to Route53 (the only reliable
 * self-serve API). An explicit preference is honored only if it is non-gated.
 */
export declare function selectBuyRegistrar(preference?: string): string;
/** Choose a DNS provider, defaulting to Cloudflare when no preference is set. */
export declare function selectDnsProvider(preference?: string): string;
//# sourceMappingURL=capability.d.ts.map