uplink-cli 0.2.3 → 0.2.6

package/cli/src/tui/DomainSearch.tsx

@@ -1,15 +1,37 @@
 import { Box, Text, useApp, useInput, render } from "ink";
 import { Wordmark } from "./brand";
 import TextInput from "ink-text-input";
-import { useEffect, useRef, useState } from "react";
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import type { PublicAvailability } from "../utils/domain-availability";
 import { expandDomainQuery } from "../utils/domain-search";
 import { checkDomainAvailability } from "../utils/domain-availability";
 import { prepareStdinForPrompt } from "../subcommands/menu/io";
+import { readRegistrarStore } from "../registrars/store";
+import { getAdapter } from "../registrars";
+import type { DomainQuote } from "../registrars/types";
+import {
+  createNamecheapAddFundsRequest,
+  getNamecheapBalance,
+  namecheapCartUrl,
+  registerNamecheapDomain,
+  fetchNamecheapDomainContact,
+  type NamecheapBalance,
+} from "../registrars/namecheap-purchase";
+import {
+  contactMissingFields,
+  readRegistrantContact,
+  writeRegistrantContact,
+  type RegistrantContact,
+} from "../utils/registrant-contact";
+import { openInBrowser } from "../utils/open-browser";
+import { useTerminalMouse } from "./use-terminal-mouse";
 
 type Row = PublicAvailability | { domain: string; status: "checking" };
+type Focus = "search" | "list" | "detail";
 
 const DEBOUNCE_MS = 400;
+/** Approx terminal row where the result list starts (1-based, after wordmark/title/search). */
+const LIST_TOP_ROW = 8;
 
 function useLiveChecks(raw: string): Row[] {
   const [rows, setRows] = useState<Row[]>([]);
@@ -37,28 +59,396 @@ function useLiveChecks(raw: string): Row[] {
   return rows;
 }
 
+function statusGlyph(status: Row["status"]): string {
+  if (status === "checking") return "·";
+  if (status === "available") return "✓";
+  if (status === "taken") return "×";
+  return "?";
+}
+
 function statusColor(status: Row["status"]): string | undefined {
   if (status === "available") return "green";
-  if (status === "taken") return undefined;
   if (status === "unknown") return "yellow";
   return undefined;
 }
 
+function formatMoney(n: number | undefined, currency = "USD"): string {
+  if (n == null || !Number.isFinite(n)) return "—";
+  return `$${n.toFixed(2)} ${currency}`;
+}
+
+async function ensureRegistrantContact(): Promise<RegistrantContact | null> {
+  const existing = readRegistrantContact();
+  if (existing && contactMissingFields(existing).length === 0) return existing;
+  const store = readRegistrarStore();
+  const creds = store.namecheap;
+  if (!creds) return existing;
+  try {
+    const owned = await getAdapter("namecheap").listDomains(creds);
+    for (const item of owned.slice(0, 5)) {
+      const contact = await fetchNamecheapDomainContact(creds, item.domain);
+      if (contact && contactMissingFields(contact).length === 0) {
+        writeRegistrantContact(contact);
+        return contact;
+      }
+    }
+  } catch {
+    /* ignore seed failures */
+  }
+  return existing;
+}
+
+type DetailState = {
+  domain: string;
+  publicStatus: Row["status"];
+  loading: boolean;
+  quote?: DomainQuote;
+  balance?: NamecheapBalance;
+  contact?: RegistrantContact | null;
+  namecheapConnected: boolean;
+  message?: string;
+  error?: string;
+};
+
+function DomainDetail({
+  state,
+  actionHint,
+}: {
+  state: DetailState;
+  actionHint: string;
+}) {
+  const quote = state.quote;
+  const price = quote?.priceUsd;
+  const balance = state.balance?.available;
+  const shortfall =
+    price != null && balance != null && balance + 0.001 < price ? price - balance : 0;
+  const canBuy =
+    state.namecheapConnected &&
+    quote?.buyable &&
+    quote.status === "available" &&
+    shortfall <= 0 &&
+    contactMissingFields(state.contact).length === 0;
+
+  return (
+    <Box flexDirection="column" paddingX={1} paddingY={1}>
+      <Wordmark />
+      <Box marginTop={1}>
+        <Text bold>{state.domain}</Text>
+      </Box>
+      {state.loading ? (
+        <Box marginTop={1}>
+          <Text dimColor>Looking up Namecheap price & balance…</Text>
+        </Box>
+      ) : (
+        <Box flexDirection="column" marginTop={1}>
+          <Text>
+            Public: {state.publicStatus}
+            {quote ? ` · Namecheap: ${quote.status}` : ""}
+            {quote?.premium ? " (premium)" : ""}
+          </Text>
+          <Text>
+            Price: {formatMoney(price)}
+            {state.balance ? ` · Balance: ${formatMoney(state.balance.available, state.balance.currency)}` : ""}
+          </Text>
+          {shortfall > 0 && (
+            <Text color="yellow">Need ~{formatMoney(shortfall)} more in Namecheap balance to buy via API.</Text>
+          )}
+          {!state.namecheapConnected && (
+            <Text dimColor>Connect Namecheap to buy: uplink domains providers connect namecheap</Text>
+          )}
+          {state.namecheapConnected && contactMissingFields(state.contact).length > 0 && (
+            <Text color="yellow">
+              Missing registrant profile ({contactMissingFields(state.contact).join(", ")}). Run: uplink
+              domains contact set
+            </Text>
+          )}
+          {state.error && <Text color="red">{state.error}</Text>}
+          {state.message && <Text color="green">{state.message}</Text>}
+        </Box>
+      )}
+      <Box marginTop={1} flexDirection="column">
+        <Text dimColor>{actionHint}</Text>
+        <Text dimColor>
+          {canBuy ? "b buy · " : ""}
+          {state.namecheapConnected ? "f add funds · " : ""}
+          o open Namecheap cart · esc back
+        </Text>
+      </Box>
+    </Box>
+  );
+}
+
 function DomainSearchApp() {
   const { exit } = useApp();
   const [query, setQuery] = useState("");
   const [showTaken, setShowTaken] = useState(false);
+  const [focus, setFocus] = useState<Focus>("search");
+  const [selected, setSelected] = useState(0);
+  const [detail, setDetail] = useState<DetailState | null>(null);
+  const [busy, setBusy] = useState(false);
+  const [awaitConfirm, setAwaitConfirm] = useState(false);
   const rows = useLiveChecks(query);
-  const pending = rows.some((row) => row.status === "checking");
+
   const available = rows.filter((row) => row.status === "available");
   const taken = rows.filter((row) => row.status === "taken");
   const rest = rows.filter((row) => row.status !== "taken");
+  const visible = useMemo(() => {
+    const base = showTaken ? [...rest, ...taken] : rest;
+    return base;
+  }, [rest, taken, showTaken]);
+
+  useEffect(() => {
+    setSelected((i) => (visible.length === 0 ? 0 : Math.min(i, visible.length - 1)));
+  }, [visible.length]);
 
-  useInput((_input, key) => {
-    if (key.escape) exit();
-    if (key.tab) setShowTaken((prev) => !prev);
+  const openDetail = useCallback(async (row: Row) => {
+    const store = readRegistrarStore();
+    const creds = store.namecheap;
+    setFocus("detail");
+    setAwaitConfirm(false);
+    setDetail({
+      domain: row.domain,
+      publicStatus: row.status,
+      loading: Boolean(creds),
+      namecheapConnected: Boolean(creds),
+    });
+    if (!creds) return;
+    try {
+      const [quote, balance, contact] = await Promise.all([
+        getAdapter("namecheap").check(creds, row.domain),
+        getNamecheapBalance(creds),
+        ensureRegistrantContact(),
+      ]);
+      setDetail({
+        domain: row.domain,
+        publicStatus: row.status,
+        loading: false,
+        quote,
+        balance,
+        contact,
+        namecheapConnected: true,
+      });
+    } catch (error) {
+      setDetail({
+        domain: row.domain,
+        publicStatus: row.status,
+        loading: false,
+        namecheapConnected: true,
+        error: error instanceof Error ? error.message : String(error),
+      });
+    }
+  }, []);
+
+  const moveSelection = useCallback(
+    (delta: number) => {
+      if (visible.length === 0) return;
+      setFocus("list");
+      setSelected((i) => (i + delta + visible.length) % visible.length);
+    },
+    [visible.length]
+  );
+
+  const onMouse = useCallback(
+    (event: { type: string; direction?: string; y?: number }) => {
+      if (focus === "detail" || busy) return;
+      if (event.type === "wheel") {
+        moveSelection(event.direction === "up" ? -1 : 1);
+        return;
+      }
+      if (event.type === "click" && typeof event.y === "number") {
+        if (visible.length === 0) return;
+        const index = event.y - LIST_TOP_ROW;
+        if (index >= 0 && index < visible.length) {
+          setSelected(index);
+          setFocus("list");
+          void openDetail(visible[index]);
+        } else if (focus === "list" && visible[selected]) {
+          void openDetail(visible[selected]);
+        }
+      }
+    },
+    [busy, focus, moveSelection, openDetail, selected, visible]
+  );
+
+  useTerminalMouse(onMouse, focus !== "detail");
+
+  const runBuy = useCallback(async () => {
+    if (!detail || busy) return;
+    const store = readRegistrarStore();
+    const creds = store.namecheap;
+    if (!creds || !detail.quote?.buyable || !detail.contact) return;
+    setBusy(true);
+    try {
+      const result = await registerNamecheapDomain(creds, {
+        domain: detail.domain,
+        years: 1,
+        contact: detail.contact,
+        premium: detail.quote.premium,
+        premiumPrice: detail.quote.premium ? detail.quote.priceUsd : undefined,
+      });
+      setDetail((prev) =>
+        prev
+          ? {
+              ...prev,
+              message: result.registered
+                ? `Registered ${result.domain}${result.chargedAmount != null ? ` · charged $${result.chargedAmount.toFixed(2)}` : ""}`
+                : `Create returned registered=false for ${result.domain}`,
+              error: undefined,
+            }
+          : prev
+      );
+      setAwaitConfirm(false);
+    } catch (error) {
+      setDetail((prev) =>
+        prev
+          ? { ...prev, error: error instanceof Error ? error.message : String(error), message: undefined }
+          : prev
+      );
+    } finally {
+      setBusy(false);
+    }
+  }, [busy, detail]);
+
+  const runFund = useCallback(async () => {
+    if (!detail || busy) return;
+    const store = readRegistrarStore();
+    const creds = store.namecheap;
+    if (!creds) return;
+    const price = detail.quote?.priceUsd ?? 10;
+    const balance = detail.balance?.available ?? 0;
+    const need = Math.max(10, Math.ceil(Math.max(price - balance, price) + 1));
+    setBusy(true);
+    try {
+      const funds = await createNamecheapAddFundsRequest(creds, need);
+      openInBrowser(funds.redirectUrl);
+      setDetail((prev) =>
+        prev
+          ? {
+              ...prev,
+              message: `Opened Namecheap payment page for $${funds.amount.toFixed(2)}. After funding, press b to buy.`,
+              error: undefined,
+            }
+          : prev
+      );
+    } catch (error) {
+      setDetail((prev) =>
+        prev
+          ? { ...prev, error: error instanceof Error ? error.message : String(error), message: undefined }
+          : prev
+      );
+    } finally {
+      setBusy(false);
+    }
+  }, [busy, detail]);
+
+  useInput((input, key) => {
+    if (busy) return;
+
+    if (focus === "detail" && detail) {
+      if (key.escape || key.leftArrow) {
+        setDetail(null);
+        setFocus(visible.length ? "list" : "search");
+        setAwaitConfirm(false);
+        return;
+      }
+      if (awaitConfirm) {
+        if (input === "y" || input === "Y") {
+          void runBuy();
+          return;
+        }
+        if (input === "n" || input === "N" || key.escape) {
+          setAwaitConfirm(false);
+          return;
+        }
+        return;
+      }
+      if (input === "b") {
+        const missing = contactMissingFields(detail.contact);
+        if (!detail.namecheapConnected) {
+          setDetail({ ...detail, error: "Connect Namecheap first." });
+          return;
+        }
+        if (!detail.quote?.buyable) {
+          setDetail({ ...detail, error: "Domain is not buyable on Namecheap." });
+          return;
+        }
+        if (missing.length) {
+          setDetail({ ...detail, error: `Set registrant contact first: uplink domains contact set` });
+          return;
+        }
+        const price = detail.quote.priceUsd ?? 0;
+        const balance = detail.balance?.available ?? 0;
+        if (balance + 0.001 < price) {
+          setDetail({
+            ...detail,
+            error: `Insufficient balance (need ~$${price.toFixed(2)}, have $${balance.toFixed(2)}). Press f to add funds.`,
+          });
+          return;
+        }
+        setAwaitConfirm(true);
+        return;
+      }
+      if (input === "f") {
+        void runFund();
+        return;
+      }
+      if (input === "o") {
+        const url = namecheapCartUrl(detail.domain, 1);
+        openInBrowser(url);
+        setDetail({ ...detail, message: `Opened cart: ${url}` });
+        return;
+      }
+      return;
+    }
+
+    if (key.escape) {
+      if (focus === "list") {
+        setFocus("search");
+        return;
+      }
+      exit();
+      return;
+    }
+    if (key.tab) {
+      setShowTaken((prev) => !prev);
+      return;
+    }
+    if (key.downArrow) {
+      if (visible.length) moveSelection(1);
+      return;
+    }
+    if (key.upArrow) {
+      if (visible.length) moveSelection(-1);
+      return;
+    }
+    if (key.return && focus === "list" && visible[selected]) {
+      void openDetail(visible[selected]);
+      return;
+    }
+    if (focus === "list" && input && !key.ctrl && !key.meta) {
+      // Typing returns to search
+      setFocus("search");
+      setQuery((q) => q + input);
+    }
   });
 
+  if (detail) {
+    return (
+      <DomainDetail
+        state={detail}
+        actionHint={
+          busy
+            ? "Working…"
+            : awaitConfirm
+              ? `Buy ${detail.domain} for ${formatMoney(detail.quote?.priceUsd)}? [y/n]`
+              : "Select an action"
+        }
+      />
+    );
+  }
+
+  const pending = rows.some((row) => row.status === "checking");
+
   return (
     <Box flexDirection="column" paddingX={1} paddingY={1}>
       <Wordmark />
@@ -67,36 +457,46 @@ function DomainSearchApp() {
       </Box>
       <Box marginTop={1}>
         <Text dimColor>search › </Text>
-        <TextInput value={query} onChange={setQuery} placeholder="acme   or   acme.io" />
+        <TextInput
+          focus={focus === "search"}
+          value={query}
+          onChange={(value) => {
+            setQuery(value);
+            setFocus("search");
+          }}
+          placeholder="acme   or   acme.io"
+        />
       </Box>
-      {rest.length > 0 && (
+      {visible.length > 0 && (
         <Box flexDirection="column" marginTop={1}>
-          {rest.map((row) => (
-            <Text key={row.domain} color={statusColor(row.status)} dimColor={row.status === "checking"}>
-              {row.status === "checking" ? "·" : row.status === "available" ? "✓" : "?"} {row.domain}
-            </Text>
-          ))}
+          {visible.map((row, index) => {
+            const active = focus === "list" && index === selected;
+            return (
+              <Text
+                key={row.domain}
+                color={active ? "cyan" : statusColor(row.status)}
+                bold={active}
+                dimColor={!active && (row.status === "checking" || row.status === "taken")}
+              >
+                {active ? "› " : "  "}
+                {statusGlyph(row.status)} {row.domain}
+                {row.status === "taken" ? "  taken" : ""}
+              </Text>
+            );
+          })}
         </Box>
       )}
-      {taken.length > 0 && (
-        <Box flexDirection="column" marginTop={1}>
-          {showTaken ? (
-            taken.map((row) => (
-              <Text key={row.domain} dimColor>
-                × {row.domain}
-              </Text>
-            ))
-          ) : (
-            <Text dimColor>
-              {taken.length} taken · tab to show
-            </Text>
-          )}
+      {!showTaken && taken.length > 0 && (
+        <Box marginTop={1}>
+          <Text dimColor>
+            {taken.length} taken · tab to show
+          </Text>
         </Box>
       )}
       <Box marginTop={1}>
         <Text dimColor>
           {rows.length > 0 && !pending ? `${available.length} of ${rows.length} free · ` : ""}
-          tab taken · esc back · DNS + RDAP, no registrar required
+          ↑↓ / wheel select · enter / click details · tab taken · esc back
         </Text>
       </Box>
     </Box>

package/cli/src/tui/use-terminal-mouse.ts

@@ -0,0 +1,60 @@
+import { useEffect } from "react";
+
+export type TerminalMouseEvent =
+  | { type: "wheel"; direction: "up" | "down" }
+  | { type: "click"; x: number; y: number; button: "left" };
+
+const ENABLE = "\x1b[?1000h\x1b[?1003h\x1b[?1006h";
+const DISABLE = "\x1b[?1006l\x1b[?1003l\x1b[?1000l";
+
+/** SGR mouse: ESC [ < btn ; x ; y M/m  (1-based x/y) */
+const SGR = /\x1b\[<(\d+);(\d+);(\d+)([Mm])/g;
+
+function parseEvents(chunk: string): TerminalMouseEvent[] {
+  const events: TerminalMouseEvent[] = [];
+  for (const match of chunk.matchAll(SGR)) {
+    const btn = Number(match[1]);
+    const x = Number(match[2]);
+    const y = Number(match[3]);
+    const release = match[4] === "m";
+    // Wheel buttons (SGR): 64 up, 65 down (sometimes +32 for motion)
+    if (btn === 64 || btn === 96) {
+      events.push({ type: "wheel", direction: "up" });
+      continue;
+    }
+    if (btn === 65 || btn === 97) {
+      events.push({ type: "wheel", direction: "down" });
+      continue;
+    }
+    // Left button release = click
+    if (release && (btn === 0 || btn === 32)) {
+      events.push({ type: "click", x, y, button: "left" });
+    }
+  }
+  return events;
+}
+
+/**
+ * Best-effort terminal mouse tracking (wheel + left click).
+ * Callers should keep a useInput handler active so escape sequences are consumed.
+ */
+export function useTerminalMouse(onEvent: (event: TerminalMouseEvent) => void, active = true): void {
+  useEffect(() => {
+    if (!active || !process.stdin.isTTY || !process.stdout.isTTY) return;
+    const stdin = process.stdin;
+    process.stdout.write(ENABLE);
+    const onData = (buf: Buffer | string) => {
+      const text = typeof buf === "string" ? buf : buf.toString("utf8");
+      for (const event of parseEvents(text)) onEvent(event);
+    };
+    stdin.on("data", onData);
+    return () => {
+      stdin.off("data", onData);
+      try {
+        process.stdout.write(DISABLE);
+      } catch {
+        /* ignore */
+      }
+    };
+  }, [onEvent, active]);
+}

package/cli/src/utils/open-browser.ts

@@ -0,0 +1,16 @@
+import { spawn } from "child_process";
+
+/** Open a URL in the default browser (best-effort). */
+export function openInBrowser(url: string): void {
+  const [cmd, args] =
+    process.platform === "darwin"
+      ? ["open", [url]]
+      : process.platform === "win32"
+        ? ["cmd", ["/c", "start", "", url]]
+        : ["xdg-open", [url]];
+  try {
+    spawn(cmd, args, { detached: true, stdio: "ignore" }).unref();
+  } catch {
+    /* Non-fatal — callers still print the URL. */
+  }
+}

package/cli/src/utils/registrant-contact.ts

@@ -0,0 +1,64 @@
+import { chmodSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+
+/** WHOIS / registrant contact used for Namecheap domains.create */
+export type RegistrantContact = {
+  firstName: string;
+  lastName: string;
+  address1: string;
+  city: string;
+  stateProvince: string;
+  postalCode: string;
+  country: string;
+  phone: string;
+  email: string;
+  organizationName?: string;
+};
+
+function contactPath(): string {
+  return join(homedir(), ".uplink", "registrant.json");
+}
+
+export function readRegistrantContact(): RegistrantContact | null {
+  const path = contactPath();
+  if (!existsSync(path)) return null;
+  try {
+    const parsed = JSON.parse(readFileSync(path, "utf8")) as RegistrantContact;
+    if (!parsed?.firstName || !parsed?.lastName || !parsed?.email || !parsed?.phone) return null;
+    if (!parsed.address1 || !parsed.city || !parsed.stateProvince || !parsed.postalCode || !parsed.country) {
+      return null;
+    }
+    return parsed;
+  } catch {
+    return null;
+  }
+}
+
+export function writeRegistrantContact(contact: RegistrantContact): void {
+  const dir = join(homedir(), ".uplink");
+  mkdirSync(dir, { recursive: true });
+  const path = contactPath();
+  writeFileSync(path, JSON.stringify(contact, null, 2), { encoding: "utf8", mode: 0o600 });
+  try {
+    chmodSync(path, 0o600);
+  } catch {
+    /* ignore */
+  }
+}
+
+export function contactMissingFields(contact: Partial<RegistrantContact> | null | undefined): string[] {
+  const required: (keyof RegistrantContact)[] = [
+    "firstName",
+    "lastName",
+    "address1",
+    "city",
+    "stateProvince",
+    "postalCode",
+    "country",
+    "phone",
+    "email",
+  ];
+  if (!contact) return required;
+  return required.filter((key) => !String(contact[key] || "").trim());
+}