@hasna/skills 0.1.27 → 0.1.30

package/skills/skill-domainpurchase/bin/cli.ts

@@ -0,0 +1,683 @@
+#!/usr/bin/env bun
+
+import { Command } from "commander";
+import {
+  loadConfig,
+  saveConfig,
+  CONFIG_FILE,
+  getApiKey,
+  getApiSecret,
+  getCustomerId,
+} from "../src/lib/config";
+import { purchaseApi, domainApi, formatPrice, type Contact, type DomainPurchaseRequestV2 } from "../src/lib/api-client";
+import { ensureInstalled } from "../src/lib/installer";
+
+// Ensure service directory exists on startup
+ensureInstalled();
+
+const program = new Command();
+
+program
+  .name("service-domainpurchase")
+  .description("CLI tool for purchasing and managing domains via Brandsight/GoDaddy API")
+  .version("1.0.0");
+
+// ============ CONFIG COMMANDS ============
+
+program
+  .command("config")
+  .description("Show or set configuration")
+  .option("--api-key <key>", "Set GoDaddy API key (direct mode)")
+  .option("--api-secret <secret>", "Set GoDaddy API secret (direct mode)")
+  .option("--customer-id <id>", "Set GoDaddy customer ID (direct mode)")
+  .option("--api-url <url>", "Set GoDaddy API URL (direct mode)")
+  .option("--use-remote <bool>", "Use remote server instead of direct API (true/false)")
+  .option("--remote-url <url>", "Set remote server URL")
+  .option("--remote-api-key <key>", "Set remote server API key")
+  .option("--show", "Show current configuration")
+  .action(async (options) => {
+    const config = loadConfig();
+
+    if (options.apiKey) {
+      saveConfig({ apiKey: options.apiKey });
+      console.log("API key saved");
+    }
+
+    if (options.apiSecret) {
+      saveConfig({ apiSecret: options.apiSecret });
+      console.log("API secret saved");
+    }
+
+    if (options.customerId) {
+      saveConfig({ customerId: options.customerId });
+      console.log("Customer ID saved");
+    }
+
+    if (options.apiUrl) {
+      saveConfig({ apiUrl: options.apiUrl });
+      console.log(`API URL set to: ${options.apiUrl}`);
+    }
+
+    if (options.useRemote !== undefined) {
+      const useRemote = options.useRemote === "true";
+      saveConfig({ useRemoteServer: useRemote });
+      console.log(`Remote server mode: ${useRemote ? "ENABLED" : "DISABLED"}`);
+    }
+
+    if (options.remoteUrl) {
+      saveConfig({ remoteServerUrl: options.remoteUrl });
+      console.log(`Remote server URL set to: ${options.remoteUrl}`);
+    }
+
+    if (options.remoteApiKey) {
+      saveConfig({ remoteApiKey: options.remoteApiKey });
+      console.log("Remote API key saved");
+    }
+
+    const hasOptions = options.apiKey || options.apiSecret || options.customerId ||
+                       options.apiUrl || options.useRemote !== undefined ||
+                       options.remoteUrl || options.remoteApiKey;
+
+    if (options.show || !hasOptions) {
+      const currentConfig = loadConfig();
+      console.log("\nConfiguration:");
+      console.log(`  Config file: ${CONFIG_FILE}`);
+      console.log("");
+      console.log("  Mode: " + (currentConfig.useRemoteServer ? "REMOTE SERVER" : "DIRECT API"));
+      console.log("");
+
+      if (currentConfig.useRemoteServer) {
+        console.log("  Remote Server Settings:");
+        console.log(`    URL: ${currentConfig.remoteServerUrl}`);
+        console.log(`    API Key: ${currentConfig.remoteApiKey ? "***" + currentConfig.remoteApiKey.slice(-4) : "(auto from AWS)"}`);
+      } else {
+        console.log("  Direct API Settings:");
+        console.log(`    API URL: ${currentConfig.apiUrl}`);
+        console.log(`    API Key: ${currentConfig.apiKey ? "***" + currentConfig.apiKey.slice(-4) : "(not set)"}`);
+        console.log(`    API Secret: ${currentConfig.apiSecret ? "***" + currentConfig.apiSecret.slice(-4) : "(not set)"}`);
+        console.log(`    Customer ID: ${currentConfig.customerId || "(not set)"}`);
+      }
+
+      console.log("\n  Tip: Use --use-remote true to switch to remote server mode");
+    }
+  });
+
+// ============ CHECK COMMAND ============
+
+program
+  .command("check <domain>")
+  .description("Check domain availability and pricing")
+  .option("--transfer", "Check for transfer instead of registration")
+  .option("--json", "Output as JSON")
+  .action(async (domain, options) => {
+    try {
+      const result = await domainApi.checkAvailability(domain, options.transfer);
+
+      if (options.json) {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+      }
+
+      const status = result.available ? "AVAILABLE" : "TAKEN";
+      const price = result.price
+        ? formatPrice(result.price, result.currency)
+        : "N/A";
+      const premium = result.registryPremiumPricing ? " [PREMIUM]" : "";
+
+      console.log(`\nDomain: ${domain}`);
+      console.log(`Status: ${status}`);
+      if (result.available) {
+        console.log(`Price: ${price}${premium}`);
+        console.log(`Period: ${result.period || 1} year(s)`);
+      }
+    } catch (error) {
+      console.error("Error:", error instanceof Error ? error.message : error);
+      process.exit(1);
+    }
+  });
+
+// ============ AGREEMENTS COMMAND ============
+
+program
+  .command("agreements <tlds...>")
+  .description("Get legal agreements for TLDs (required before purchase)")
+  .option("--privacy", "Include privacy agreements")
+  .option("--json", "Output as JSON")
+  .action(async (tlds, options) => {
+    try {
+      const agreements = await domainApi.getAgreements(tlds, options.privacy);
+
+      if (options.json) {
+        console.log(JSON.stringify(agreements, null, 2));
+        return;
+      }
+
+      console.log(`\nAgreements for: ${tlds.join(", ")}\n`);
+
+      for (const a of agreements) {
+        console.log(`  [${a.agreementKey}] ${a.title}`);
+        console.log(`    URL: ${a.url}\n`);
+      }
+
+      console.log(`\nTotal: ${agreements.length} agreement(s)`);
+      console.log(`\nUse these agreement keys when purchasing domains.`);
+    } catch (error) {
+      console.error("Error:", error instanceof Error ? error.message : error);
+      process.exit(1);
+    }
+  });
+
+// ============ VALIDATE COMMAND ============
+
+program
+  .command("validate <domain>")
+  .description("Validate a domain purchase request (dry run)")
+  .option("--contact-json <path>", "Path to JSON file with contact info")
+  .option("--period <years>", "Registration period in years", "1")
+  .option("--privacy", "Enable WHOIS privacy")
+  .option("--auto-renew", "Enable auto renewal")
+  .option("--json", "Output as JSON")
+  .action(async (domain, options) => {
+    try {
+      // Check availability first to get price
+      console.log(`Checking availability for ${domain}...`);
+      const availability = await domainApi.checkAvailability(domain);
+
+      if (!availability.available) {
+        console.error(`\nError: ${domain} is not available for registration.`);
+        process.exit(1);
+      }
+
+      const price = availability.price || 0;
+      const currency = availability.currency || "USD";
+      console.log(`Domain available! Price: ${formatPrice(price, currency)}\n`);
+
+      // Get TLD from domain
+      const tld = domain.split(".").slice(1).join(".");
+
+      // Get agreements
+      console.log(`Fetching agreements for .${tld}...`);
+      const agreements = await domainApi.getAgreements([tld], options.privacy);
+      const agreementKeys = agreements.map((a) => a.agreementKey);
+
+      // Load contact info
+      let contact: Contact;
+      if (options.contactJson) {
+        const file = await Bun.file(options.contactJson);
+        contact = await file.json();
+      } else {
+        // Use placeholder contact for validation
+        contact = {
+          nameFirst: "Test",
+          nameLast: "User",
+          email: "test@example.com",
+          phone: "+1.5555555555",
+          addressMailing: {
+            address1: "123 Test St",
+            city: "Test City",
+            state: "CA",
+            postalCode: "90210",
+            country: "US",
+          },
+          encoding: "ASCII",
+        };
+        console.log("\nUsing placeholder contact info for validation.");
+        console.log("For actual purchase, provide --contact-json <path>\n");
+      }
+
+      // Ensure contact has encoding
+      if (!contact.encoding) {
+        contact.encoding = "ASCII";
+      }
+
+      // Get public IP for consent
+      const ipResponse = await fetch("https://api.ipify.org?format=json");
+      const ipData = await ipResponse.json() as { ip: string };
+
+      // Build V2 API request format with all contacts
+      const request: DomainPurchaseRequestV2 = {
+        domain,
+        consent: {
+          agreedAt: new Date().toISOString(),
+          agreedBy: ipData.ip,
+          agreementKeys,
+          price,
+          currency,
+        },
+        contacts: {
+          registrant: contact,
+          admin: contact,
+          billing: contact,
+          tech: contact,
+        },
+        period: parseInt(options.period),
+        privacy: options.privacy || false,
+        renewAuto: options.autoRenew || false,
+      };
+
+      console.log("Validating purchase request...\n");
+      const result = await domainApi.validatePurchase(request);
+
+      if (options.json) {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+      }
+
+      if (result.valid) {
+        console.log("Validation: PASSED");
+        console.log("\nThe domain purchase request is valid.");
+        console.log("Use the 'purchase' command to complete the purchase.");
+      } else {
+        console.log("Validation: FAILED");
+        console.log(`Status: ${result.status}`);
+        console.log(`Response: ${JSON.stringify(result.data, null, 2)}`);
+      }
+    } catch (error) {
+      console.error("Error:", error instanceof Error ? error.message : error);
+      process.exit(1);
+    }
+  });
+
+// ============ PURCHASE COMMAND ============
+
+program
+  .command("purchase <domain>")
+  .description("Purchase a domain")
+  .requiredOption("--contact-json <path>", "Path to JSON file with contact info")
+  .option("--period <years>", "Registration period in years", "1")
+  .option("--privacy", "Enable WHOIS privacy")
+  .option("--auto-renew", "Enable auto renewal")
+  .option("--nameservers <ns>", "Comma-separated nameservers (max 2)")
+  .option("--dry-run", "Validate only, don't actually purchase")
+  .option("--json", "Output as JSON")
+  .action(async (domain, options) => {
+    try {
+      // Check availability first
+      console.log(`Checking availability for ${domain}...`);
+      const availability = await domainApi.checkAvailability(domain);
+
+      if (!availability.available) {
+        console.error(`\nError: ${domain} is not available for registration.`);
+        process.exit(1);
+      }
+
+      const price = availability.price || 0;
+      const currency = availability.currency || "USD";
+      console.log(`Domain available! Price: ${formatPrice(price, currency)}\n`);
+
+      // Get TLD from domain
+      const tld = domain.split(".").slice(1).join(".");
+
+      // Get agreements
+      console.log(`Fetching agreements for .${tld}...`);
+      const agreements = await domainApi.getAgreements([tld], options.privacy);
+      const agreementKeys = agreements.map((a) => a.agreementKey);
+      console.log(`Found ${agreements.length} agreement(s)\n`);
+
+      // Load contact info
+      const contactFile = await Bun.file(options.contactJson);
+      const contact: Contact = await contactFile.json();
+
+      // Ensure contact has encoding
+      if (!contact.encoding) {
+        contact.encoding = "ASCII";
+      }
+
+      // Get public IP for consent
+      const ipResponse = await fetch("https://api.ipify.org?format=json");
+      const ipData = await ipResponse.json() as { ip: string };
+
+      // Build V2 API request format with all contacts
+      const request: DomainPurchaseRequestV2 = {
+        domain,
+        consent: {
+          agreedAt: new Date().toISOString(),
+          agreedBy: ipData.ip,
+          agreementKeys,
+          price,
+          currency,
+        },
+        contacts: {
+          registrant: contact,
+          admin: contact,
+          billing: contact,
+          tech: contact,
+        },
+        period: parseInt(options.period),
+        privacy: options.privacy || false,
+        renewAuto: options.autoRenew || false,
+        ...(options.nameservers && {
+          nameServers: options.nameservers.split(",").map((ns: string) => ns.trim()).slice(0, 2),
+        }),
+      };
+
+      if (options.dryRun) {
+        console.log("Validating purchase request (dry run)...\n");
+        const result = await domainApi.validatePurchase(request);
+
+        if (options.json) {
+          console.log(JSON.stringify(result, null, 2));
+          return;
+        }
+
+        if (result.valid) {
+          console.log("Validation: PASSED");
+          console.log("\nRemove --dry-run to complete the purchase.");
+        } else {
+          console.log("Validation: FAILED");
+          console.log(`Response: ${JSON.stringify(result.data, null, 2)}`);
+        }
+        return;
+      }
+
+      // Actual purchase
+      console.log("Processing purchase...\n");
+      const result = await domainApi.purchaseDomain(request);
+
+      if (options.json) {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+      }
+
+      console.log("Purchase completed!");
+      console.log(`Domain: ${domain}`);
+      console.log(`Order ID: ${result.orderId || "N/A"}`);
+      console.log(`\nUse 'service-domainpurchase info ${domain}' to view details.`);
+    } catch (error) {
+      console.error("Error:", error instanceof Error ? error.message : error);
+      process.exit(1);
+    }
+  });
+
+// ============ LIST COMMAND ============
+
+program
+  .command("list")
+  .description("List domains owned by your account")
+  .option("-l, --limit <count>", "Maximum domains to list", "100")
+  .option("--json", "Output as JSON")
+  .action(async (options) => {
+    try {
+      const domains = await domainApi.listOwnedDomains(parseInt(options.limit));
+
+      if (options.json) {
+        console.log(JSON.stringify(domains, null, 2));
+        return;
+      }
+
+      console.log(`\nOwned Domains (${domains.length}):\n`);
+
+      for (const d of domains) {
+        const expires = d.expires
+          ? new Date(d.expires).toLocaleDateString()
+          : "N/A";
+        const autoRenew = d.renewAuto ? "[AUTO]" : "";
+        const privacy = d.privacy ? "[PRIVATE]" : "";
+        console.log(
+          `  ${d.domain.padEnd(35)} expires: ${expires} ${autoRenew} ${privacy}`
+        );
+      }
+    } catch (error) {
+      console.error("Error:", error instanceof Error ? error.message : error);
+      process.exit(1);
+    }
+  });
+
+// ============ INFO COMMAND ============
+
+program
+  .command("info <domain>")
+  .description("Get detailed information about an owned domain")
+  .option("--json", "Output as JSON")
+  .action(async (domain, options) => {
+    try {
+      const details = await domainApi.getDomainDetails(domain);
+
+      if (options.json) {
+        console.log(JSON.stringify(details, null, 2));
+        return;
+      }
+
+      console.log(`\nDomain: ${details.domain}`);
+      console.log(`Status: ${details.status}`);
+      console.log(`Created: ${details.createdAt}`);
+      console.log(`Expires: ${details.expires}`);
+      console.log(`Auto Renew: ${details.renewAuto ? "Yes" : "No"}`);
+      console.log(`Privacy: ${details.privacy ? "Yes" : "No"}`);
+
+      if (details.nameServers?.length) {
+        console.log(`\nNameservers:`);
+        for (const ns of details.nameServers) {
+          console.log(`  - ${ns}`);
+        }
+      }
+
+      if (details.contactRegistrant) {
+        console.log(`\nRegistrant:`);
+        console.log(
+          `  ${details.contactRegistrant.nameFirst} ${details.contactRegistrant.nameLast}`
+        );
+        console.log(`  ${details.contactRegistrant.email}`);
+      }
+    } catch (error) {
+      console.error("Error:", error instanceof Error ? error.message : error);
+      process.exit(1);
+    }
+  });
+
+// ============ UPDATE COMMAND ============
+
+program
+  .command("update <domain>")
+  .description("Update domain settings")
+  .option("--auto-renew <bool>", "Enable/disable auto renewal (true/false)")
+  .option("--privacy <bool>", "Enable/disable WHOIS privacy (true/false)")
+  .option("--nameservers <ns>", "Comma-separated nameservers")
+  .option("--json", "Output as JSON")
+  .action(async (domain, options) => {
+    try {
+      const updates: any = {};
+
+      if (options.autoRenew !== undefined) {
+        updates.renewAuto = options.autoRenew === "true";
+      }
+
+      if (options.privacy !== undefined) {
+        updates.privacy = options.privacy === "true";
+      }
+
+      if (options.nameservers) {
+        updates.nameServers = options.nameservers
+          .split(",")
+          .map((ns: string) => ns.trim());
+      }
+
+      if (Object.keys(updates).length === 0) {
+        console.error("Error: No updates specified.");
+        console.log("\nOptions:");
+        console.log("  --auto-renew <true|false>");
+        console.log("  --privacy <true|false>");
+        console.log("  --nameservers <ns1,ns2,...>");
+        process.exit(1);
+      }
+
+      console.log(`Updating ${domain}...`);
+      const result = await domainApi.updateDomain(domain, updates);
+
+      if (options.json) {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+      }
+
+      console.log("\nDomain updated successfully!");
+      console.log(`Applied changes: ${JSON.stringify(updates)}`);
+    } catch (error) {
+      console.error("Error:", error instanceof Error ? error.message : error);
+      process.exit(1);
+    }
+  });
+
+// ============ RENEW COMMAND ============
+
+program
+  .command("renew <domain>")
+  .description("Renew a domain registration")
+  .option("-p, --period <years>", "Renewal period in years", "1")
+  .option("--json", "Output as JSON")
+  .action(async (domain, options) => {
+    try {
+      console.log(`Renewing ${domain} for ${options.period} year(s)...`);
+      const result = await domainApi.renewDomain(domain, parseInt(options.period));
+
+      if (options.json) {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+      }
+
+      console.log("\nRenewal completed!");
+      console.log(`Domain: ${domain}`);
+      console.log(`Period: ${options.period} year(s)`);
+    } catch (error) {
+      console.error("Error:", error instanceof Error ? error.message : error);
+      process.exit(1);
+    }
+  });
+
+// ============ TRANSFER COMMAND ============
+
+program
+  .command("transfer <domain>")
+  .description("Transfer a domain to your account")
+  .requiredOption("--auth-code <code>", "Authorization/EPP code from current registrar")
+  .requiredOption("--contact-json <path>", "Path to JSON file with contact info")
+  .option("--json", "Output as JSON")
+  .action(async (domain, options) => {
+    try {
+      // Get TLD from domain
+      const tld = domain.split(".").slice(1).join(".");
+
+      // Get agreements
+      console.log(`Fetching transfer agreements for .${tld}...`);
+      const agreements = await purchaseApi.getAgreements([tld], false);
+      const agreementKeys = agreements.map((a) => a.agreementKey);
+
+      // Load contact info
+      const contactFile = await Bun.file(options.contactJson);
+      const contact: Contact = await contactFile.json();
+
+      // Get public IP for consent
+      const ipResponse = await fetch("https://api.ipify.org?format=json");
+      const ipData = await ipResponse.json() as { ip: string };
+
+      const consent = {
+        agreedAt: new Date().toISOString(),
+        agreedBy: ipData.ip,
+        agreementKeys,
+      };
+
+      console.log(`Initiating transfer of ${domain}...`);
+      const result = await purchaseApi.initiateTransfer(
+        domain,
+        options.authCode,
+        consent,
+        contact
+      );
+
+      if (options.json) {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+      }
+
+      console.log("\nTransfer initiated!");
+      console.log(`Domain: ${domain}`);
+      console.log(
+        "\nNote: The transfer may take several days to complete."
+      );
+      console.log("Check your email for any required confirmations.");
+    } catch (error) {
+      console.error("Error:", error instanceof Error ? error.message : error);
+      process.exit(1);
+    }
+  });
+
+// ============ CONTACT-TEMPLATE COMMAND ============
+
+program
+  .command("contact-template")
+  .description("Generate a contact info JSON template")
+  .option("-o, --output <path>", "Output file path")
+  .action(async (options) => {
+    const template = {
+      nameFirst: "John",
+      nameLast: "Doe",
+      email: "john.doe@example.com",
+      phone: "+1.5551234567",
+      organization: "Example Corp",
+      addressMailing: {
+        address1: "123 Main Street",
+        address2: "Suite 100",
+        city: "San Francisco",
+        state: "CA",
+        postalCode: "94102",
+        country: "US",
+      },
+      encoding: "UTF-8",
+    };
+
+    const json = JSON.stringify(template, null, 2);
+
+    if (options.output) {
+      await Bun.write(options.output, json);
+      console.log(`Contact template saved to: ${options.output}`);
+    } else {
+      console.log("\nContact Info Template:\n");
+      console.log(json);
+      console.log("\nSave this to a file and use with --contact-json <path>");
+    }
+  });
+
+// ============ SETUP COMMAND ============
+
+program
+  .command("setup")
+  .description("Interactive setup for service-domainpurchase")
+  .action(async () => {
+    console.log("\nservice-domainpurchase Setup\n");
+    console.log("This will configure your Brandsight/GoDaddy API credentials.\n");
+
+    const config = loadConfig();
+
+    if (!config.apiKey || !config.apiSecret) {
+      console.log("API credentials not configured.\n");
+      console.log("Get your API key and secret from:");
+      console.log("  https://developer.godaddy.com/keys\n");
+      console.log("Then run:");
+      console.log("  service-domainpurchase config --api-key <key> --api-secret <secret>");
+      console.log("  service-domainpurchase config --customer-id <id>\n");
+    } else {
+      console.log(`API Key: ***${config.apiKey.slice(-4)}`);
+      console.log(`API Secret: ***${config.apiSecret.slice(-4)}`);
+      console.log(`Customer ID: ${config.customerId || "(not set)"}`);
+      console.log(`API URL: ${config.apiUrl}\n`);
+
+      // Test connection
+      console.log("Testing connection...");
+      try {
+        const domains = await domainApi.listOwnedDomains(5);
+        console.log(`  Connected! Found ${domains.length} domains in your account.\n`);
+
+        console.log("Quick commands:");
+        console.log("  service-domainpurchase check example.com");
+        console.log("  service-domainpurchase list");
+        console.log("  service-domainpurchase contact-template -o contact.json");
+        console.log("  service-domainpurchase purchase example.com --contact-json contact.json --dry-run");
+      } catch (error) {
+        console.error(
+          "  Connection failed:",
+          error instanceof Error ? error.message : error
+        );
+      }
+    }
+  });
+
+program.parse();