@hasna/microservices 0.0.5 → 0.0.7

package/microservices/microservice-domains/src/lib/namecheap.ts

@@ -0,0 +1,262 @@
+/**
+ * Namecheap API integration for domain management
+ *
+ * Uses the Connector SDK pattern from connect-namecheap.
+ * When @hasna/connect-namecheap is published to npm, replace the
+ * relative connector import with the package import.
+ *
+ * Requires environment variables:
+ *   NAMECHEAP_API_KEY    — API key from Namecheap
+ *   NAMECHEAP_USERNAME   — Namecheap account username
+ *   NAMECHEAP_CLIENT_IP  — Whitelisted client IP address
+ */
+
+// Re-export types used by consumers (CLI, MCP, registrar)
+export type {
+  ConnectorConfig as NamecheapConfig,
+  Domain as NamecheapDomain,
+  DomainInfo as NamecheapDomainInfo,
+  DnsRecord as NamecheapDnsRecord,
+  AvailabilityResult as NamecheapAvailability,
+  RenewResult as NamecheapRenewResult,
+} from "../../../../../open-connectors/connectors/connect-namecheap/src/index.js";
+
+import {
+  Connector,
+  type ConnectorConfig,
+  type Domain as NamecheapDomain,
+  type DomainInfo as NamecheapDomainInfo,
+  type DnsRecord as NamecheapDnsRecord,
+} from "../../../../../open-connectors/connectors/connect-namecheap/src/index.js";
+
+// ============================================================
+// Sync Result Type (microservice-specific, not in connector)
+// ============================================================
+
+export interface NamecheapSyncResult {
+  synced: number;
+  errors: string[];
+  domains: string[];
+}
+
+// ============================================================
+// Connector Instance Management
+// ============================================================
+
+/**
+ * Create a Namecheap connector from environment variables.
+ * Wraps Connector.fromEnv() with the same env var validation.
+ */
+export function getConfig(): ConnectorConfig {
+  const apiKey = process.env["NAMECHEAP_API_KEY"];
+  const username = process.env["NAMECHEAP_USERNAME"];
+  const clientIp = process.env["NAMECHEAP_CLIENT_IP"];
+
+  if (!apiKey) throw new Error("NAMECHEAP_API_KEY environment variable is not set");
+  if (!username) throw new Error("NAMECHEAP_USERNAME environment variable is not set");
+  if (!clientIp) throw new Error("NAMECHEAP_CLIENT_IP environment variable is not set");
+
+  return {
+    apiKey,
+    username,
+    clientIp,
+    sandbox: process.env["NAMECHEAP_SANDBOX"] === "true",
+  };
+}
+
+function createConnector(config?: ConnectorConfig): Connector {
+  return new Connector(config || getConfig());
+}
+
+// ============================================================
+// API Functions (thin wrappers around connector)
+// ============================================================
+
+/**
+ * List all domains in the Namecheap account
+ */
+export async function listNamecheapDomains(config?: ConnectorConfig): Promise<NamecheapDomain[]> {
+  const connector = createConnector(config);
+  return connector.domains.list();
+}
+
+/**
+ * Get detailed info for a specific domain
+ */
+export async function getDomainInfo(domain: string, config?: ConnectorConfig): Promise<NamecheapDomainInfo> {
+  const connector = createConnector(config);
+  return connector.domains.getInfo(domain);
+}
+
+/**
+ * Renew a domain
+ */
+export async function renewDomain(domain: string, years: number = 1, config?: ConnectorConfig) {
+  const connector = createConnector(config);
+  return connector.domains.renew(domain, years);
+}
+
+/**
+ * Get DNS host records for a domain
+ */
+export async function getDnsRecords(domain: string, sld: string, tld: string, config?: ConnectorConfig): Promise<NamecheapDnsRecord[]> {
+  const connector = createConnector(config);
+  return connector.dns.getHosts(sld, tld);
+}
+
+/**
+ * Set DNS host records for a domain
+ */
+export async function setDnsRecords(
+  domain: string,
+  sld: string,
+  tld: string,
+  records: NamecheapDnsRecord[],
+  config?: ConnectorConfig
+): Promise<boolean> {
+  const connector = createConnector(config);
+  return connector.dns.setHosts(sld, tld, records);
+}
+
+/**
+ * Check domain availability
+ */
+export async function checkAvailability(domain: string, config?: ConnectorConfig) {
+  const connector = createConnector(config);
+  return connector.domains.check(domain);
+}
+
+// ============================================================
+// Domain Helpers (microservice-specific)
+// ============================================================
+
+/**
+ * Split a domain name into SLD (second-level domain) and TLD (top-level domain)
+ */
+export function splitDomain(domain: string): { sld: string; tld: string } {
+  const parts = domain.split(".");
+  if (parts.length < 2) {
+    throw new Error(`Invalid domain: ${domain}`);
+  }
+  // Handle multi-part TLDs like .co.uk
+  if (parts.length >= 3 && ["co", "com", "org", "net", "ac", "gov"].includes(parts[parts.length - 2])) {
+    return {
+      sld: parts.slice(0, -2).join("."),
+      tld: parts.slice(-2).join("."),
+    };
+  }
+  return {
+    sld: parts.slice(0, -1).join("."),
+    tld: parts[parts.length - 1],
+  };
+}
+
+// ============================================================
+// Sync to Local DB (microservice business logic)
+// ============================================================
+
+/**
+ * Sync domains from Namecheap to local database
+ * Calls listDomains + getDomainInfo for each, upserts into local domains table
+ */
+export async function syncToLocalDb(dbFunctions: {
+  getDomainByName: (name: string) => { id: string } | null;
+  createDomain: (input: {
+    name: string;
+    registrar?: string;
+    status?: string;
+    registered_at?: string;
+    expires_at?: string;
+    auto_renew?: boolean;
+    nameservers?: string[];
+  }) => { id: string; name: string };
+  updateDomain: (
+    id: string,
+    input: {
+      registrar?: string;
+      status?: string;
+      registered_at?: string;
+      expires_at?: string;
+      auto_renew?: boolean;
+      nameservers?: string[];
+    }
+  ) => unknown;
+}, config?: ConnectorConfig): Promise<NamecheapSyncResult> {
+  const connector = createConnector(config);
+  const result: NamecheapSyncResult = { synced: 0, errors: [], domains: [] };
+
+  let ncDomains: NamecheapDomain[];
+  try {
+    ncDomains = await connector.domains.list();
+  } catch (error) {
+    throw new Error(`Failed to list Namecheap domains: ${error instanceof Error ? error.message : String(error)}`);
+  }
+
+  for (const ncDomain of ncDomains) {
+    try {
+      // Get detailed info via connector
+      let info: NamecheapDomainInfo;
+      try {
+        info = await connector.domains.getInfo(ncDomain.domain);
+      } catch {
+        // Fall back to basic info if getInfo fails
+        info = {
+          domain: ncDomain.domain,
+          registrar: "Namecheap",
+          created: "",
+          expires: ncDomain.expiry,
+          nameservers: [],
+        };
+      }
+
+      // Normalize dates to ISO format
+      const expiresAt = normalizeDate(info.expires || ncDomain.expiry);
+      const createdAt = normalizeDate(info.created);
+
+      // Upsert into local DB
+      const existing = dbFunctions.getDomainByName(ncDomain.domain);
+      if (existing) {
+        dbFunctions.updateDomain(existing.id, {
+          registrar: "Namecheap",
+          status: "active",
+          registered_at: createdAt || undefined,
+          expires_at: expiresAt || undefined,
+          auto_renew: ncDomain.autoRenew,
+          nameservers: info.nameservers.length > 0 ? info.nameservers : undefined,
+        });
+      } else {
+        dbFunctions.createDomain({
+          name: ncDomain.domain,
+          registrar: "Namecheap",
+          status: "active",
+          registered_at: createdAt || undefined,
+          expires_at: expiresAt || undefined,
+          auto_renew: ncDomain.autoRenew,
+          nameservers: info.nameservers,
+        });
+      }
+
+      result.synced++;
+      result.domains.push(ncDomain.domain);
+    } catch (error) {
+      result.errors.push(`${ncDomain.domain}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+  }
+
+  return result;
+}
+
+// ============================================================
+// Helpers
+// ============================================================
+
+function normalizeDate(dateStr: string): string | null {
+  if (!dateStr) return null;
+  try {
+    const d = new Date(dateStr);
+    if (isNaN(d.getTime())) return null;
+    return d.toISOString();
+  } catch {
+    return null;
+  }
+}

package/microservices/microservice-domains/src/lib/registrar.ts

@@ -0,0 +1,355 @@
+/**
+ * Unified registrar provider system
+ *
+ * Wraps Namecheap, GoDaddy, and Brandsight into a common RegistrarProvider interface.
+ */
+
+import type { Domain, CreateDomainInput, UpdateDomainInput } from "../db/domains.js";
+import * as namecheap from "./namecheap.js";
+import * as godaddy from "./godaddy.js";
+
+// ============================================================
+// Types
+// ============================================================
+
+export interface ProviderDnsRecord {
+  type: string;
+  name: string;
+  value: string;
+  ttl: number;
+  priority?: number;
+}
+
+export interface ProviderDomainInfo {
+  domain: string;
+  registrar: string;
+  created: string;
+  expires: string;
+  nameservers: string[];
+  status: string;
+  auto_renew: boolean;
+}
+
+export interface ProviderRenewResult {
+  domain: string;
+  success: boolean;
+  orderId?: string;
+  chargedAmount?: string;
+}
+
+export interface ProviderSyncResult {
+  synced: number;
+  created: number;
+  updated: number;
+  errors: string[];
+}
+
+export interface ProviderAvailability {
+  domain: string;
+  available: boolean;
+}
+
+export type DbFunctions = {
+  getDomainByName: (name: string) => Domain | null;
+  createDomain: (input: CreateDomainInput) => Domain;
+  updateDomain: (id: string, input: UpdateDomainInput) => Domain | null;
+};
+
+export interface RegistrarProvider {
+  name: string;
+  listDomains(): Promise<ProviderDomainInfo[]>;
+  getDomainInfo(domain: string): Promise<ProviderDomainInfo>;
+  renewDomain(domain: string): Promise<ProviderRenewResult>;
+  getDnsRecords(domain: string): Promise<ProviderDnsRecord[]>;
+  setDnsRecords(domain: string, records: ProviderDnsRecord[]): Promise<boolean>;
+  checkAvailability(domain: string): Promise<ProviderAvailability>;
+  syncToLocalDb(dbFns: DbFunctions): Promise<ProviderSyncResult>;
+}
+
+export interface ProviderInfo {
+  name: string;
+  configured: boolean;
+  envVars: string[];
+}
+
+export interface SyncAllResult {
+  providers: { name: string; result: ProviderSyncResult }[];
+  totalSynced: number;
+  totalErrors: string[];
+}
+
+// ============================================================
+// Namecheap Provider Adapter
+// ============================================================
+
+function createNamecheapProvider(): RegistrarProvider {
+  return {
+    name: "namecheap",
+
+    async listDomains(): Promise<ProviderDomainInfo[]> {
+      const config = namecheap.getConfig();
+      const domains = await namecheap.listNamecheapDomains(config);
+      return domains.map((d) => ({
+        domain: d.domain,
+        registrar: "Namecheap",
+        created: "",
+        expires: d.expiry,
+        nameservers: [],
+        status: "active",
+        auto_renew: d.autoRenew,
+      }));
+    },
+
+    async getDomainInfo(domain: string): Promise<ProviderDomainInfo> {
+      const config = namecheap.getConfig();
+      const info = await namecheap.getDomainInfo(domain, config);
+      return {
+        domain: info.domain,
+        registrar: info.registrar,
+        created: info.created,
+        expires: info.expires,
+        nameservers: info.nameservers,
+        status: "active",
+        auto_renew: true,
+      };
+    },
+
+    async renewDomain(domain: string): Promise<ProviderRenewResult> {
+      const config = namecheap.getConfig();
+      const result = await namecheap.renewDomain(domain, 1, config);
+      return {
+        domain: result.domain,
+        success: result.success,
+        orderId: result.orderId,
+        chargedAmount: result.chargedAmount,
+      };
+    },
+
+    async getDnsRecords(domain: string): Promise<ProviderDnsRecord[]> {
+      const config = namecheap.getConfig();
+      const { sld, tld } = namecheap.splitDomain(domain);
+      const records = await namecheap.getDnsRecords(domain, sld, tld, config);
+      return records.map((r) => ({
+        type: r.type,
+        name: r.name,
+        value: r.address,
+        ttl: r.ttl,
+        priority: r.mxPref,
+      }));
+    },
+
+    async setDnsRecords(domain: string, records: ProviderDnsRecord[]): Promise<boolean> {
+      const config = namecheap.getConfig();
+      const { sld, tld } = namecheap.splitDomain(domain);
+      const ncRecords = records.map((r) => ({
+        type: r.type,
+        name: r.name,
+        address: r.value,
+        ttl: r.ttl,
+        mxPref: r.priority,
+      }));
+      return namecheap.setDnsRecords(domain, sld, tld, ncRecords, config);
+    },
+
+    async checkAvailability(domain: string): Promise<ProviderAvailability> {
+      const config = namecheap.getConfig();
+      const result = await namecheap.checkAvailability(domain, config);
+      return { domain: result.domain, available: result.available };
+    },
+
+    async syncToLocalDb(dbFns: DbFunctions): Promise<ProviderSyncResult> {
+      const result = await namecheap.syncToLocalDb(dbFns);
+      return {
+        synced: result.synced,
+        created: 0,
+        updated: 0,
+        errors: result.errors,
+      };
+    },
+  };
+}
+
+// ============================================================
+// GoDaddy Provider Adapter
+// ============================================================
+
+function createGoDaddyProvider(): RegistrarProvider {
+  return {
+    name: "godaddy",
+
+    async listDomains(): Promise<ProviderDomainInfo[]> {
+      const domains = await godaddy.listGoDaddyDomains();
+      return domains.map((d) => ({
+        domain: d.domain,
+        registrar: "GoDaddy",
+        created: "",
+        expires: d.expires,
+        nameservers: d.nameServers || [],
+        status: d.status.toLowerCase(),
+        auto_renew: d.renewAuto,
+      }));
+    },
+
+    async getDomainInfo(domain: string): Promise<ProviderDomainInfo> {
+      const detail = await godaddy.getDomainInfo(domain);
+      return {
+        domain: detail.domain,
+        registrar: "GoDaddy",
+        created: detail.createdAt || "",
+        expires: detail.expires,
+        nameservers: detail.nameServers || [],
+        status: detail.status.toLowerCase(),
+        auto_renew: detail.renewAuto,
+      };
+    },
+
+    async renewDomain(domain: string): Promise<ProviderRenewResult> {
+      const result = await godaddy.renewDomain(domain);
+      return {
+        domain,
+        success: true,
+        orderId: String(result.orderId),
+        chargedAmount: String(result.total),
+      };
+    },
+
+    async getDnsRecords(domain: string): Promise<ProviderDnsRecord[]> {
+      const records = await godaddy.getDnsRecords(domain);
+      return records.map((r) => ({
+        type: r.type,
+        name: r.name,
+        value: r.data,
+        ttl: r.ttl,
+        priority: r.priority,
+      }));
+    },
+
+    async setDnsRecords(domain: string, records: ProviderDnsRecord[]): Promise<boolean> {
+      const gdRecords = records.map((r) => ({
+        type: r.type,
+        name: r.name,
+        data: r.value,
+        ttl: r.ttl,
+        priority: r.priority,
+      }));
+      await godaddy.setDnsRecords(domain, gdRecords);
+      return true;
+    },
+
+    async checkAvailability(domain: string): Promise<ProviderAvailability> {
+      const result = await godaddy.checkAvailability(domain);
+      return { domain: result.domain, available: result.available };
+    },
+
+    async syncToLocalDb(dbFns: DbFunctions): Promise<ProviderSyncResult> {
+      const result = await godaddy.syncToLocalDb(dbFns);
+      return {
+        synced: result.synced,
+        created: result.created,
+        updated: result.updated,
+        errors: result.errors,
+      };
+    },
+  };
+}
+
+// ============================================================
+// Provider Factory
+// ============================================================
+
+/**
+ * Get a unified RegistrarProvider by name.
+ */
+export function getProvider(name: "namecheap" | "godaddy"): RegistrarProvider {
+  switch (name) {
+    case "namecheap":
+      return createNamecheapProvider();
+    case "godaddy":
+      return createGoDaddyProvider();
+    default:
+      throw new Error(`Unknown registrar provider: ${name}`);
+  }
+}
+
+/**
+ * Check which providers have their API keys configured.
+ */
+export function getAvailableProviders(): ProviderInfo[] {
+  const providers: ProviderInfo[] = [
+    {
+      name: "namecheap",
+      configured: !!(
+        process.env["NAMECHEAP_API_KEY"] &&
+        process.env["NAMECHEAP_USERNAME"] &&
+        process.env["NAMECHEAP_CLIENT_IP"]
+      ),
+      envVars: ["NAMECHEAP_API_KEY", "NAMECHEAP_USERNAME", "NAMECHEAP_CLIENT_IP"],
+    },
+    {
+      name: "godaddy",
+      configured: !!(
+        process.env["GODADDY_API_KEY"] &&
+        process.env["GODADDY_API_SECRET"]
+      ),
+      envVars: ["GODADDY_API_KEY", "GODADDY_API_SECRET"],
+    },
+    {
+      name: "brandsight",
+      configured: !!process.env["BRANDSIGHT_API_KEY"],
+      envVars: ["BRANDSIGHT_API_KEY"],
+    },
+  ];
+
+  return providers;
+}
+
+/**
+ * Sync domains from ALL configured registrar providers sequentially.
+ */
+export async function syncAll(dbFns: DbFunctions): Promise<SyncAllResult> {
+  const available = getAvailableProviders().filter(
+    (p) => p.configured && (p.name === "namecheap" || p.name === "godaddy")
+  );
+
+  const result: SyncAllResult = {
+    providers: [],
+    totalSynced: 0,
+    totalErrors: [],
+  };
+
+  for (const info of available) {
+    try {
+      const provider = getProvider(info.name as "namecheap" | "godaddy");
+      const syncResult = await provider.syncToLocalDb(dbFns);
+      result.providers.push({ name: info.name, result: syncResult });
+      result.totalSynced += syncResult.synced;
+      result.totalErrors.push(...syncResult.errors.map((e) => `[${info.name}] ${e}`));
+    } catch (error) {
+      const msg = `[${info.name}] Sync failed: ${error instanceof Error ? error.message : String(error)}`;
+      result.totalErrors.push(msg);
+      result.providers.push({
+        name: info.name,
+        result: { synced: 0, created: 0, updated: 0, errors: [msg] },
+      });
+    }
+  }
+
+  return result;
+}
+
+/**
+ * Auto-detect which registrar provider a domain uses based on its DB record.
+ * Returns the provider name or null if not determinable.
+ */
+export function autoDetectRegistrar(
+  domain: string,
+  getDomainByName: (name: string) => Domain | null
+): "namecheap" | "godaddy" | null {
+  const dbDomain = getDomainByName(domain);
+  if (!dbDomain || !dbDomain.registrar) return null;
+
+  const registrar = dbDomain.registrar.toLowerCase();
+  if (registrar.includes("namecheap")) return "namecheap";
+  if (registrar.includes("godaddy")) return "godaddy";
+  return null;
+}