@dropthis/cli 0.10.0 → 0.12.0

package/dist/cli.cjs

@@ -202,10 +202,25 @@ function normalizeApiErrorCode(error2) {
   if (error2.statusCode === 404) return "not_found";
   return "api_error";
 }
-function nextActionForApiError(error2) {
+function nextActionForApiError(error2, mode = "json") {
+  const cliHint = cliNextAction(error2);
+  if (mode === "human" && cliHint) return cliHint;
   if (error2.suggestion) return error2.suggestion;
+  if (cliHint) return cliHint;
+  if (error2.statusCode === 422) {
+    return "Fix the input shown in the error detail and retry.";
+  }
+  if (error2.statusCode !== void 0 && error2.statusCode !== null && error2.statusCode >= 500) {
+    return "Retry the request with the same idempotency key, or contact support with the request id.";
+  }
+  return "Fix the request or retry after checking the drop state.";
+}
+function cliNextAction(error2) {
   const uploadNextAction = error2.code ? UPLOAD_NEXT_ACTIONS[error2.code] : void 0;
   if (uploadNextAction) return uploadNextAction;
+  if (error2.code === "network_error") {
+    return "Could not reach the dropthis API \u2014 check your network or DROPTHIS_API_URL.";
+  }
   if (error2.code === "revision_conflict") {
     return "Re-read the drop with dropthis get <drop-id>, merge your changes, and retry with --if-revision set to the current revision.";
   }
@@ -218,13 +233,7 @@ function nextActionForApiError(error2) {
   if (error2.statusCode === 413 || error2.code === "quota_exceeded") {
     return "Reduce the upload size or upgrade the account limit.";
   }
-  if (error2.statusCode === 422) {
-    return "Fix the input shown in the error detail and retry.";
-  }
-  if (error2.statusCode !== void 0 && error2.statusCode !== null && error2.statusCode >= 500) {
-    return "Retry the request with the same idempotency key, or contact support with the request id.";
-  }
-  return "Fix the request or retry after checking the drop state.";
+  return void 0;
 }
 function exitCodeFor(code) {
   if (code === "usage_error") return 2;
@@ -232,12 +241,14 @@ function exitCodeFor(code) {
   if (code === "auth_error") return 3;
   if (code === "local_input_error") return 4;
   if (code === "network_error") return 5;
+  if (code === "verify_pending") return 6;
+  if (code === "verify_timeout") return 7;
   return 1;
 }
 
 // src/program.ts
 var import_commander = require("commander");
-var import_picocolors4 = __toESM(require("picocolors"), 1);
+var import_picocolors6 = __toESM(require("picocolors"), 1);
 
 // src/auth.ts
 async function resolveCredential(input) {
@@ -285,6 +296,9 @@ function success(msg) {
 function error(msg) {
   return `${import_picocolors.default.red(symbols.error)} ${msg}`;
 }
+function warn(msg) {
+  return `${import_picocolors.default.yellow(symbols.warning)} ${msg}`;
+}
 function hint(msg) {
   return `  ${import_picocolors.default.dim(msg)}`;
 }
@@ -305,6 +319,21 @@ function writeResult(deps, link, verb, data) {
     const details = formatDropDetails(data);
     if (details) deps.stdout(`${details}
 `);
+    const warnings = data.warnings;
+    if (Array.isArray(warnings)) {
+      for (const w of warnings) {
+        if (w.code === "slug_suffixed") {
+          deps.stderr(
+            `${hint(`Vanity slug was taken \u2014 served at: ${w.detail ?? "see URL"}`)}
+`
+          );
+        } else {
+          const text2 = typeof w.detail === "string" ? w.detail : typeof w.message === "string" ? w.message : typeof w.code === "string" ? w.code : void 0;
+          if (text2) deps.stderr(`${hint(text2)}
+`);
+        }
+      }
+    }
   } else {
     deps.stdout(`${JSON.stringify({ ok: true, drop: data })}
 `);
@@ -323,6 +352,13 @@ function formatDropDetails(data) {
   if (parts.length === 0) return "";
   return `  ${import_picocolors2.default.dim(parts.join(" \xB7 "))}`;
 }
+function formatDate(iso) {
+  return iso.split("T")[0] ?? iso;
+}
+function formatDateTime(iso) {
+  const match = iso.match(/^(\d{4}-\d{2}-\d{2})T(\d{2}:\d{2})/);
+  return match ? `${match[1]} ${match[2]}` : iso;
+}
 function formatBytes(bytes) {
   if (bytes < 1024) return `${bytes} B`;
   if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;
@@ -368,7 +404,7 @@ function writeApiError(deps, details) {
   if (deps.outputMode === "human") {
     deps.stderr(`${error(details.message)}
 `);
-    const nextAction = nextActionForApiError(details);
+    const nextAction = nextActionForApiError(details, "human");
     if (nextAction) deps.stderr(`${hint(nextAction)}
 `);
     if (details.currentRevision !== void 0)
@@ -383,7 +419,12 @@ function writeApiError(deps, details) {
     deps.stderr(`${JSON.stringify(apiErrorEnvelope(details))}
 `);
   }
-  return { exitCode: exitCodeFor("api_error") };
+  return { exitCode: exitCodeFor(cliErrorCodeFor(details)) };
+}
+function cliErrorCodeFor(details) {
+  if (details.code === "network_error") return "network_error";
+  if (details.code === "file_not_found") return "local_input_error";
+  return "api_error";
 }
 function writeApiErrorSimple(deps, message) {
   if (deps.outputMode === "human") {
@@ -491,6 +532,14 @@ async function runAccountDelete(input, deps) {
 var prompts = __toESM(require("@clack/prompts"), 1);
 
 // src/types.ts
+function extractPagination(data) {
+  if (!data || typeof data !== "object") return void 0;
+  const rec = data;
+  if (!("nextCursor" in rec) && !("hasMore" in rec)) return void 0;
+  const nextCursor = typeof rec.nextCursor === "string" ? rec.nextCursor : null;
+  const hasMore = typeof rec.hasMore === "boolean" ? rec.hasMore : nextCursor !== null;
+  return { nextCursor, hasMore };
+}
 function unwrapListData(data, ...fallbackKeys) {
   if (data && typeof data === "object") {
     if ("data" in data) {
@@ -631,7 +680,7 @@ var COMMAND_ANNOTATIONS = {
   },
   deployments: {
     auth: "required",
-    examples: ["dropthis deployments drop_abc --json"]
+    examples: ["dropthis deployments list drop_abc --json"]
   },
   "deployments list": {
     auth: "required",
@@ -641,6 +690,36 @@ var COMMAND_ANNOTATIONS = {
     auth: "required",
     examples: ["dropthis deployments get drop_abc dep_abc --json"]
   },
+  domains: {
+    auth: "required",
+    examples: ["dropthis domains list --json"]
+  },
+  "domains connect": {
+    auth: "required",
+    examples: [
+      "dropthis domains connect reports.example.com --mode path --json"
+    ]
+  },
+  "domains list": {
+    auth: "required",
+    examples: ["dropthis domains list --json"]
+  },
+  "domains status": {
+    auth: "required",
+    examples: ["dropthis domains status reports.example.com --json"]
+  },
+  "domains verify": {
+    auth: "required",
+    examples: ["dropthis domains verify reports.example.com --wait --json"]
+  },
+  "domains update": {
+    auth: "required",
+    examples: ["dropthis domains update reports.example.com --default --json"]
+  },
+  "domains remove": {
+    auth: "required",
+    examples: ["dropthis domains remove reports.example.com --yes --json"]
+  },
   "api-keys": {
     auth: "required",
     examples: ["dropthis api-keys create --label CI --json"]
@@ -722,6 +801,7 @@ async function runDeploymentsList(dropId, input, deps) {
     return writeApiError(deps, result.error);
   }
   const spread = spreadData(result.data);
+  const page = extractPagination(result.data);
   const items = spread.deployments ?? spread.data ?? result.data;
   if (deps.outputMode === "human") {
     if (!items || Array.isArray(items) && items.length === 0) {
@@ -731,8 +811,15 @@ async function runDeploymentsList(dropId, input, deps) {
       });
     } else if (Array.isArray(items)) {
       for (const item of items) {
+        const created = typeof item.createdAt === "string" ? formatDateTime(item.createdAt) : "";
+        deps.stdout(
+          `${item.id ?? ""}  rev ${item.revision ?? "?"}  ${created}
+`
+        );
+      }
+      if (page?.hasMore && page.nextCursor) {
         deps.stdout(
-          `${item.id ?? ""}  rev ${item.revision ?? "?"}  ${item.createdAt ?? ""}
+          `${hint(`More deployments: dropthis deployments list ${dropId} --cursor ${page.nextCursor}`)}
 `
         );
       }
@@ -740,7 +827,11 @@ async function runDeploymentsList(dropId, input, deps) {
       writeJson(deps, { ok: true, ...spread });
     }
   } else {
-    writeJson(deps, { ok: true, ...spread });
+    writeJson(deps, {
+      ok: true,
+      ...spread,
+      ...page ? { next_cursor: page.nextCursor, has_more: page.hasMore } : {}
+    });
   }
   return { exitCode: 0 };
 }
@@ -763,7 +854,8 @@ async function runDeploymentsGet(dropId, deploymentId, _input, deps) {
   if (data.id) pairs.push(["ID", String(data.id)]);
   if (data.revision !== void 0)
     pairs.push(["Revision", String(data.revision)]);
-  if (data.createdAt) pairs.push(["Created", String(data.createdAt)]);
+  if (data.createdAt)
+    pairs.push(["Created", formatDateTime(String(data.createdAt))]);
   writeKv(deps, pairs, { ok: true, deployment: result.data });
   return { exitCode: 0 };
 }
@@ -781,21 +873,386 @@ async function runDoctor(_input, deps) {
   const authSource = credential?.source ?? "missing";
   const storageBackend = stored?.storage ?? "none";
   const pairs = [
-    ["Version", "0.10.0"],
+    ["Version", "0.12.0"],
     ["Auth", authSource],
     ["Storage", storageBackend]
   ];
   writeKv(deps, pairs, {
     ok: true,
-    version: "0.10.0",
+    version: "0.12.0",
     auth: { source: authSource },
     storage: { backend: storageBackend }
   });
   return { exitCode: 0 };
 }
 
-// src/commands/drops.ts
+// src/commands/domains.ts
 var prompts2 = __toESM(require("@clack/prompts"), 1);
+var import_picocolors3 = __toESM(require("picocolors"), 1);
+function formatDnsTable(records) {
+  if (records.length === 0) return "";
+  const rows = [];
+  const colWidths = {
+    type: Math.max(4, ...records.map((r) => r.type.length)),
+    name: Math.max(4, ...records.map((r) => r.name.length)),
+    value: Math.max(5, ...records.map((r) => r.value.length)),
+    status: Math.max(6, ...records.map((r) => r.status.length))
+  };
+  const header = [
+    "Type".padEnd(colWidths.type),
+    "Name".padEnd(colWidths.name),
+    "Value".padEnd(colWidths.value),
+    "Status".padEnd(colWidths.status)
+  ].join("  ");
+  rows.push(import_picocolors3.default.dim(header));
+  rows.push(import_picocolors3.default.dim("\u2500".repeat(header.length)));
+  for (const rec of records) {
+    const statusColor = rec.status === "ok" ? import_picocolors3.default.green(rec.status.padEnd(colWidths.status)) : rec.status === "mismatch" ? import_picocolors3.default.yellow(rec.status.padEnd(colWidths.status)) : import_picocolors3.default.red(rec.status.padEnd(colWidths.status));
+    rows.push(
+      [
+        rec.type.padEnd(colWidths.type),
+        rec.name.padEnd(colWidths.name),
+        rec.value.padEnd(colWidths.value),
+        statusColor
+      ].join("  ")
+    );
+    if (rec.hint) {
+      rows.push(`  ${import_picocolors3.default.dim(rec.hint)}`);
+    }
+    if (rec.observed) {
+      rows.push(`  ${import_picocolors3.default.dim(`Observed: ${rec.observed}`)}`);
+    }
+  }
+  return rows.join("\n");
+}
+function renderNextHint(h, hostname, maxRetryAfter) {
+  if (h.action === "verify") {
+    const recheck = maxRetryAfter > 0 ? ` (re-checks every ${maxRetryAfter}s)` : "";
+    return `Run: dropthis domains verify ${hostname} --wait${recheck}`;
+  }
+  if (h.action === "publish") {
+    return `Run: dropthis publish <file> --domain ${hostname}`;
+  }
+  return h.message;
+}
+function duplicatesRecordHint(h, dns) {
+  if (h.action !== "dns") return false;
+  return dns.some(
+    (r) => r.hint && h.message.includes(r.name) && h.message.includes(r.value)
+  );
+}
+function printNextHints(deps, hints, hostname, dns) {
+  const lines = hints.filter((h) => !duplicatesRecordHint(h, dns));
+  if (lines.length === 0) return;
+  const maxRetryAfter = dns.reduce(
+    (max, r) => Math.max(max, r.retryAfter ?? 0),
+    0
+  );
+  deps.stdout("\n");
+  for (const h of lines) {
+    deps.stdout(`${hint(renderNextHint(h, hostname, maxRetryAfter))}
+`);
+  }
+}
+function computeSleepMs(records, elapsedMs, timeoutMs) {
+  const maxRetryAfter = records.reduce(
+    (max, r) => Math.max(max, r.retryAfter ?? 0),
+    0
+  );
+  const defaultSeconds = maxRetryAfter > 0 ? maxRetryAfter : 15;
+  const desiredMs = defaultSeconds * 1e3;
+  const remainingMs = timeoutMs - elapsedMs;
+  return Math.min(desiredMs, Math.max(0, remainingMs));
+}
+async function runDomainsConnect(input, deps) {
+  try {
+    await requireCredential({
+      ...deps.apiKey ? { apiKey: deps.apiKey } : {},
+      env: deps.env,
+      store: deps.store
+    });
+  } catch {
+    return writeAuthError(deps);
+  }
+  const result = await deps.client.domains.connect(input);
+  if (result.error) return writeApiError(deps, result.error);
+  const domain = result.data;
+  if (deps.outputMode === "human") {
+    deps.stdout(
+      `${success(`Connected ${domain.hostname} (${domain.mode} mode)`)}
+`
+    );
+    if (domain.dns.length > 0) {
+      deps.stdout("\nDNS records to create at your provider:\n\n");
+      deps.stdout(`${formatDnsTable(domain.dns)}
+`);
+    }
+    printNextHints(deps, domain.next, domain.hostname, domain.dns);
+  } else {
+    writeJson(deps, { ok: true, domain });
+  }
+  return { exitCode: 0 };
+}
+async function runDomainsList(_input, deps) {
+  try {
+    await requireCredential({
+      ...deps.apiKey ? { apiKey: deps.apiKey } : {},
+      env: deps.env,
+      store: deps.store
+    });
+  } catch {
+    return writeAuthError(deps);
+  }
+  const result = await deps.client.domains.list();
+  if (result.error) return writeApiError(deps, result.error);
+  const domains = result.data?.domains ?? [];
+  if (deps.outputMode === "human") {
+    if (domains.length === 0) {
+      writeEmpty(deps, "No domains connected yet.", { ok: true, domains: [] });
+    } else {
+      for (const d of domains) {
+        const defaultMark = d.default ? import_picocolors3.default.green(" (default)") : "";
+        const drop = d.dropId ? import_picocolors3.default.dim(` \u2192 ${d.dropId}`) : "";
+        deps.stdout(
+          `  ${d.hostname}${defaultMark}  ${import_picocolors3.default.dim(d.mode)}  ${import_picocolors3.default.dim(d.status)}${drop}
+`
+        );
+      }
+    }
+  } else {
+    writeJson(deps, { ok: true, domains });
+  }
+  return { exitCode: 0 };
+}
+async function runDomainsStatus(idOrHostname, _input, deps) {
+  try {
+    await requireCredential({
+      ...deps.apiKey ? { apiKey: deps.apiKey } : {},
+      env: deps.env,
+      store: deps.store
+    });
+  } catch {
+    return writeAuthError(deps);
+  }
+  const result = await deps.client.domains.get(idOrHostname);
+  if (result.error) return writeApiError(deps, result.error);
+  const domain = result.data;
+  if (deps.outputMode === "human") {
+    deps.stdout(`  ${import_picocolors3.default.dim("Hostname:")}  ${domain.hostname}
+`);
+    deps.stdout(`  ${import_picocolors3.default.dim("Mode:    ")}  ${domain.mode}
+`);
+    deps.stdout(`  ${import_picocolors3.default.dim("Status:  ")}  ${domain.status}
+`);
+    if (domain.failureReason) {
+      deps.stdout(
+        `  ${import_picocolors3.default.dim("Reason:  ")}  ${import_picocolors3.default.red(domain.failureReason)}
+`
+      );
+    }
+    if (domain.dropId) {
+      deps.stdout(`  ${import_picocolors3.default.dim("Drop:    ")}  ${domain.dropId}
+`);
+    }
+    if (domain.verifiedAt) {
+      deps.stdout(
+        `  ${import_picocolors3.default.dim("Verified:")}  ${formatDate(domain.verifiedAt)}
+`
+      );
+    }
+    deps.stdout(`  ${import_picocolors3.default.dim("Created: ")}  ${formatDate(domain.createdAt)}
+`);
+    if (domain.dns.length > 0) {
+      deps.stdout("\nDNS records:\n\n");
+      deps.stdout(`${formatDnsTable(domain.dns)}
+`);
+    }
+    printNextHints(deps, domain.next, domain.hostname, domain.dns);
+  } else {
+    writeJson(deps, { ok: true, domain });
+  }
+  return { exitCode: 0 };
+}
+var defaultSleep = (ms) => new Promise((resolve2) => setTimeout(resolve2, ms));
+async function runDomainsVerify(idOrHostname, input, deps, sleep = defaultSleep) {
+  try {
+    await requireCredential({
+      ...deps.apiKey ? { apiKey: deps.apiKey } : {},
+      env: deps.env,
+      store: deps.store
+    });
+  } catch {
+    return writeAuthError(deps);
+  }
+  const timeoutMs = (input.timeout ?? 300) * 1e3;
+  const doVerify = async (elapsedMs) => {
+    const result = await deps.client.domains.verify(idOrHostname);
+    if (result.error) return writeApiError(deps, result.error);
+    const domain = result.data;
+    if (!input.wait) {
+      if (deps.outputMode === "human") {
+        deps.stdout(
+          `${domain.status === "live" ? success(`${idOrHostname} is live`) : warn(`${idOrHostname}: ${domain.status}`)}
+`
+        );
+        if (domain.dns.length > 0) {
+          deps.stdout("\n");
+          deps.stdout(`${formatDnsTable(domain.dns)}
+`);
+        }
+        printNextHints(deps, domain.next, domain.hostname, domain.dns);
+      } else {
+        writeJson(deps, { ok: true, domain });
+      }
+      return {
+        exitCode: domain.status === "live" ? 0 : domain.status === "failed" ? 1 : 6
+      };
+    }
+    if (domain.status === "live" || domain.status === "failed") {
+      if (deps.outputMode === "human") {
+        deps.stdout(
+          `${domain.status === "live" ? success(`${idOrHostname} is live`) : warn(`${idOrHostname}: ${domain.status}`)}
+`
+        );
+        if (domain.dns.length > 0) {
+          deps.stdout("\n");
+          deps.stdout(`${formatDnsTable(domain.dns)}
+`);
+        }
+      } else {
+        writeJson(deps, { ok: true, domain });
+      }
+      return { exitCode: domain.status === "live" ? 0 : 1 };
+    }
+    const sleepMs = computeSleepMs(domain.dns, elapsedMs, timeoutMs);
+    const newElapsed = elapsedMs + sleepMs;
+    if (newElapsed >= timeoutMs) {
+      const timeoutSecs = input.timeout ?? 300;
+      const message = `Timed out waiting for ${idOrHostname} to go live after ${timeoutSecs}s`;
+      if (deps.outputMode === "human") {
+        deps.stderr(
+          `  ${import_picocolors3.default.red("Timed out waiting for")} ${idOrHostname} ${import_picocolors3.default.red("to go live")}
+`
+        );
+      } else {
+        deps.stderr(
+          `${JSON.stringify(errorEnvelope("verify_timeout", message))}
+`
+        );
+      }
+      return { exitCode: 7 };
+    }
+    if (deps.outputMode === "human" && domain.dns.length > 0) {
+      deps.stdout(`${formatDnsTable(domain.dns)}
+`);
+    }
+    await sleep(sleepMs);
+    return doVerify(newElapsed);
+  };
+  return doVerify(0);
+}
+async function runDomainsUpdate(idOrHostname, input, deps) {
+  if (input.drop === void 0 && input.setDefault === void 0) {
+    return writeError(
+      deps,
+      "invalid_usage",
+      "Provide at least one option: --drop <dropId> or --default"
+    );
+  }
+  try {
+    await requireCredential({
+      ...deps.apiKey ? { apiKey: deps.apiKey } : {},
+      env: deps.env,
+      store: deps.store
+    });
+  } catch {
+    return writeAuthError(deps);
+  }
+  const updateInput = {};
+  if (input.drop !== void 0) updateInput.dropId = input.drop;
+  if (input.setDefault !== void 0) updateInput.default = input.setDefault;
+  const result = await deps.client.domains.update(idOrHostname, updateInput);
+  if (result.error) return writeApiError(deps, result.error);
+  const domain = result.data;
+  writeHumanOrJson(deps, `${success(`Updated ${domain.hostname}`)}
+`, {
+    ok: true,
+    domain
+  });
+  return { exitCode: 0 };
+}
+async function runDomainsRemove(idOrHostname, input, deps) {
+  if (!input.yes && input.interactive === false) {
+    return writeError(
+      deps,
+      "invalid_usage",
+      "Pass --yes to remove the domain in non-interactive mode."
+    );
+  }
+  if (!input.yes && input.interactive !== false) {
+    const confirmed = await prompts2.confirm({
+      message: `Remove ${idOrHostname}? This removes the domain and unmounts its drops.`
+    });
+    if (prompts2.isCancel(confirmed) || !confirmed) {
+      return { exitCode: 0 };
+    }
+  }
+  try {
+    await requireCredential({
+      ...deps.apiKey ? { apiKey: deps.apiKey } : {},
+      env: deps.env,
+      store: deps.store
+    });
+  } catch {
+    return writeAuthError(deps);
+  }
+  const result = await deps.client.domains.delete(idOrHostname);
+  if (result.error) return writeApiError(deps, result.error);
+  const deleted = result.data;
+  if (deps.outputMode === "human") {
+    deps.stdout(`${success(`Removed ${deleted.hostname}`)}
+`);
+    if (deleted.warning) {
+      deps.stderr(`${warn(deleted.warning)}
+`);
+    }
+  } else {
+    writeJson(deps, {
+      ok: true,
+      deleted: true,
+      id: deleted.id,
+      hostname: deleted.hostname,
+      warning: deleted.warning
+    });
+  }
+  return { exitCode: 0 };
+}
+
+// src/commands/drops.ts
+var prompts3 = __toESM(require("@clack/prompts"), 1);
+var import_picocolors4 = __toESM(require("picocolors"), 1);
+async function resolveDropTarget(target, deps) {
+  if (target.startsWith("drop_")) return { ok: true, dropId: target };
+  const resolved = await deps.client.drops.resolve(target);
+  if (resolved.error) {
+    return { ok: false, ...writeApiError(deps, resolved.error) };
+  }
+  if (resolved.data === null) {
+    return {
+      ok: false,
+      ...writeApiError(deps, {
+        code: "not_found",
+        message: `No drop matching "${target}" found in your account.`,
+        suggestion: "It may belong to another account or have been deleted. Run dropthis list to see your drops, or pass the full drop_\u2026 id."
+      })
+    };
+  }
+  return {
+    ok: true,
+    dropId: resolved.data.id,
+    ...resolved.data.slug ? { slug: resolved.data.slug } : {}
+  };
+}
 async function runDropsList(input, deps) {
   try {
     await requireCredential({
@@ -813,24 +1270,40 @@ async function runDropsList(input, deps) {
   const result = await deps.client.drops.list(params);
   if (result.error) return writeApiError(deps, result.error);
   const raw = unwrapListData(result.data, "drops");
+  const page = extractPagination(result.data);
   const items = Array.isArray(raw) ? raw : void 0;
   if (deps.outputMode === "human") {
     if (!items || items.length === 0) {
       writeEmpty(deps, "No drops found.", { ok: true, drops: [] });
     } else {
       for (const item of items) {
+        const created = typeof item.createdAt === "string" ? import_picocolors4.default.dim(formatDate(item.createdAt)) : "";
         deps.stdout(
-          `${item.id ?? ""}  ${item.title ?? ""}  ${item.url ? url(String(item.url)) : ""}
+          `${item.id ?? ""}  ${created}  ${item.title ?? ""}  ${item.url ? url(String(item.url)) : ""}
+`
+        );
+      }
+      deps.stdout(
+        `${import_picocolors4.default.dim(`${items.length} ${items.length === 1 ? "drop" : "drops"}`)}
+`
+      );
+      if (page?.hasMore && page.nextCursor) {
+        deps.stdout(
+          `${hint(`More drops: dropthis list --cursor ${page.nextCursor}`)}
 `
         );
       }
     }
   } else {
-    writeJson(deps, { ok: true, drops: items ?? raw });
+    writeJson(deps, {
+      ok: true,
+      drops: items ?? raw,
+      ...page ? { next_cursor: page.nextCursor, has_more: page.hasMore } : {}
+    });
   }
   return { exitCode: 0 };
 }
-async function runDropsGet(dropId, _input, deps) {
+async function runDropsGet(target, _input, deps) {
   try {
     await requireCredential({
       ...deps.apiKey ? { apiKey: deps.apiKey } : {},
@@ -840,7 +1313,9 @@ async function runDropsGet(dropId, _input, deps) {
   } catch {
     return writeAuthError(deps);
   }
-  const result = await deps.client.drops.get(dropId);
+  const resolved = await resolveDropTarget(target, deps);
+  if (!resolved.ok) return { exitCode: resolved.exitCode };
+  const result = await deps.client.drops.get(resolved.dropId);
   if (result.error) return writeApiError(deps, result.error);
   const data = result.data;
   const pairs = [];
@@ -850,7 +1325,8 @@ async function runDropsGet(dropId, _input, deps) {
   if (data.visibility) pairs.push(["Visibility", String(data.visibility)]);
   if (data.revision !== void 0)
     pairs.push(["Revision", String(data.revision)]);
-  if (data.createdAt) pairs.push(["Created", String(data.createdAt)]);
+  if (data.createdAt)
+    pairs.push(["Created", formatDate(String(data.createdAt))]);
   if (data.accessible !== void 0)
     pairs.push(["Accessible", String(data.accessible)]);
   if (data.persistent !== void 0)
@@ -860,7 +1336,7 @@ async function runDropsGet(dropId, _input, deps) {
   writeKv(deps, pairs, { ok: true, drop: result.data });
   return { exitCode: 0 };
 }
-async function runDropsDelete(dropId, input, deps) {
+async function runDropsDelete(target, input, deps) {
   if (!input.yes && input.interactive === false) {
     return writeError(
       deps,
@@ -868,14 +1344,6 @@ async function runDropsDelete(dropId, input, deps) {
       "Pass --yes to delete in non-interactive mode."
     );
   }
-  if (!input.yes && input.interactive !== false) {
-    const confirmed = await prompts2.confirm({
-      message: `Delete ${dropId}?`
-    });
-    if (prompts2.isCancel(confirmed) || !confirmed) {
-      return { exitCode: 0 };
-    }
-  }
   try {
     await requireCredential({
       ...deps.apiKey ? { apiKey: deps.apiKey } : {},
@@ -885,6 +1353,17 @@ async function runDropsDelete(dropId, input, deps) {
   } catch {
     return writeAuthError(deps);
   }
+  const resolved = await resolveDropTarget(target, deps);
+  if (!resolved.ok) return { exitCode: resolved.exitCode };
+  const dropId = resolved.dropId;
+  if (!input.yes && input.interactive !== false) {
+    const confirmed = await prompts3.confirm({
+      message: `Delete ${dropId}${dropId === target ? "" : ` (${target})`}?`
+    });
+    if (prompts3.isCancel(confirmed) || !confirmed) {
+      return { exitCode: 0 };
+    }
+  }
   const result = await deps.client.drops.delete(dropId);
   if (result?.error) return writeApiError(deps, result.error);
   writeHumanOrJson(deps, success(`Deleted ${dropId}`), {
@@ -896,31 +1375,31 @@ async function runDropsDelete(dropId, input, deps) {
 }
 
 // src/commands/login.ts
-var prompts3 = __toESM(require("@clack/prompts"), 1);
+var prompts4 = __toESM(require("@clack/prompts"), 1);
 async function runLoginInteractive(deps) {
-  prompts3.intro("dropthis login");
-  const email = await prompts3.text({
+  prompts4.intro("dropthis login");
+  const email = await prompts4.text({
     message: "Email address",
     validate: (v) => v?.includes("@") ? void 0 : "Enter a valid email"
   });
-  if (prompts3.isCancel(email)) {
-    prompts3.cancel("Login cancelled.");
+  if (prompts4.isCancel(email)) {
+    prompts4.cancel("Login cancelled.");
     return { exitCode: 0 };
   }
   const requestResult = await deps.client.auth.requestEmailOtp({ email });
   if (requestResult.error) {
-    prompts3.cancel(requestResult.error.message);
+    prompts4.cancel(requestResult.error.message);
     return { exitCode: exitCodeFor("api_error") };
   }
   const maxAttempts = 3;
   let session;
   for (let attempt = 1; attempt <= maxAttempts; attempt++) {
-    const otp = await prompts3.text({
+    const otp = await prompts4.text({
       message: attempt === 1 ? "Paste the code from your email" : "Try again \u2014 paste the code from your email",
       validate: (v) => v && v.length >= 4 && v.length <= 8 ? void 0 : "Code must be 4\u20138 characters."
     });
-    if (prompts3.isCancel(otp)) {
-      prompts3.cancel("Login cancelled.");
+    if (prompts4.isCancel(otp)) {
+      prompts4.cancel("Login cancelled.");
       return { exitCode: 0 };
     }
     const result = await deps.client.auth.verifyEmailOtp({
@@ -932,20 +1411,20 @@ async function runLoginInteractive(deps) {
       break;
     }
     if (attempt < maxAttempts) {
-      prompts3.log.warning(result.error.message);
+      prompts4.log.warning(result.error.message);
     } else {
-      prompts3.cancel(result.error.message);
+      prompts4.cancel(result.error.message);
       return { exitCode: exitCodeFor("api_error") };
     }
   }
   if (!session) {
-    prompts3.cancel("Login failed.");
+    prompts4.cancel("Login failed.");
     return { exitCode: exitCodeFor("api_error") };
   }
   const authedClient = deps.createClient(session.data.token);
   const apiKey = await authedClient.apiKeys.create({ label: "CLI" });
   if (apiKey.error) {
-    prompts3.cancel(apiKey.error.message);
+    prompts4.cancel(apiKey.error.message);
     return { exitCode: exitCodeFor("api_error") };
   }
   await deps.store.save({
@@ -956,7 +1435,7 @@ async function runLoginInteractive(deps) {
     email,
     storage: "secure"
   });
-  prompts3.outro("Logged in successfully.");
+  prompts4.outro("Logged in successfully.");
   return { exitCode: 0 };
 }
 async function runLoginRequest(input, deps) {
@@ -1131,7 +1610,9 @@ async function parseDropOptions(raw) {
     ...raw.entry ? { entry: raw.entry } : {},
     ...raw.contentType ? { contentType: raw.contentType } : {},
     ...raw.path ? { path: raw.path } : {},
-    ...raw.idempotencyKey ? { idempotencyKey: raw.idempotencyKey } : {}
+    ...raw.idempotencyKey ? { idempotencyKey: raw.idempotencyKey } : {},
+    ...raw.domain ? { domain: raw.domain } : {},
+    ...raw.slug ? { slug: raw.slug } : {}
   };
 }
 function parseJsonObject(value, label) {
@@ -1143,12 +1624,12 @@ function parseJsonObject(value, label) {
 }
 
 // src/spinner.ts
-var import_picocolors3 = __toESM(require("picocolors"), 1);
+var import_picocolors5 = __toESM(require("picocolors"), 1);
 var frames = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
 function createSpinner(message, stderr) {
   let i = 0;
   const timer = setInterval(() => {
-    stderr(`\r\x1B[2K${import_picocolors3.default.cyan(frames[i % frames.length])} ${message}`);
+    stderr(`\r\x1B[2K${import_picocolors5.default.cyan(frames[i % frames.length])} ${message}`);
     i++;
   }, 80);
   return {
@@ -1299,24 +1780,10 @@ async function runPull(target, input, deps) {
   } catch {
     return writeAuthError(deps);
   }
-  let dropId;
-  let defaultDirName;
-  if (target.startsWith("drop_")) {
-    dropId = target;
-    defaultDirName = target;
-  } else {
-    const resolved = await deps.client.drops.resolve(target);
-    if (resolved.error) return writeApiError(deps, resolved.error);
-    if (resolved.data === null) {
-      return writeApiError(deps, {
-        code: "not_found",
-        message: `No drop matching "${target}" found in your account.`,
-        suggestion: "It may belong to another account or have been deleted. Run dropthis list to see your drops, or pass the full drop_\u2026 id."
-      });
-    }
-    dropId = resolved.data.id;
-    defaultDirName = resolved.data.slug || resolved.data.id;
-  }
+  const resolved = await resolveDropTarget(target, deps);
+  if (!resolved.ok) return { exitCode: resolved.exitCode };
+  const dropId = resolved.dropId;
+  const defaultDirName = resolved.slug || resolved.dropId;
   const spin = shouldSpin(deps.outputMode) ? createSpinner("Pulling content\u2026", deps.stderr) : void 0;
   const manifestResult = await deps.client.drops.getContent(dropId);
   if (manifestResult.error) {
@@ -1499,7 +1966,7 @@ function assertDropId(target) {
 }
 
 // src/commands/update-settings.ts
-var prompts4 = __toESM(require("@clack/prompts"), 1);
+var prompts5 = __toESM(require("@clack/prompts"), 1);
 var NO_SETTINGS_MESSAGE = "Nothing to update. Provide at least one settings option.";
 var NO_SETTINGS_NEXT_ACTION = "Run dropthis update-settings --help, or retry with one of: --title, --visibility, --password, --no-password, --noindex, --index, --expires-at, --metadata, or --metadata-file. To replace the content at the URL instead, use dropthis update-content <dropId> ./dist.";
 async function runUpdateSettings(dropId, raw, deps) {
@@ -1523,7 +1990,7 @@ async function runUpdateSettings(dropId, raw, deps) {
       if (shouldPrompt(deps)) {
         const prompted = await promptForSettings(
           dropId,
-          deps.prompts ?? prompts4
+          deps.prompts ?? prompts5
         );
         if (!prompted) return { exitCode: 0 };
         parsed = { ...parsed, ...prompted };
@@ -1912,6 +2379,55 @@ async function writeCredentialFile(path, credential) {
   await (0, import_promises3.rename)(tmpPath, path);
 }
 
+// src/typo-guard.ts
+var import_promises4 = require("fs/promises");
+function levenshtein(a, b) {
+  if (a === b) return 0;
+  if (a.length === 0) return b.length;
+  if (b.length === 0) return a.length;
+  let prev = Array.from({ length: b.length + 1 }, (_, j) => j);
+  for (let i = 1; i <= a.length; i++) {
+    const curr = [i];
+    for (let j = 1; j <= b.length; j++) {
+      const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+      const deletion = (prev[j] ?? 0) + 1;
+      const insertion = (curr[j - 1] ?? 0) + 1;
+      const substitution = (prev[j - 1] ?? 0) + cost;
+      curr[j] = Math.min(deletion, insertion, substitution);
+    }
+    prev = curr;
+  }
+  return prev[b.length] ?? 0;
+}
+function suggestCommand(token, names) {
+  const lower = token.toLowerCase();
+  let best = null;
+  for (const name of names) {
+    if (lower.length >= 2 && name.startsWith(lower)) return name;
+    const dist = levenshtein(lower, name);
+    if (best === null || dist < best.dist) best = { name, dist };
+  }
+  if (best !== null && best.dist <= 2 && best.dist < lower.length) {
+    return best.name;
+  }
+  return null;
+}
+function isBareWordToken(token) {
+  if (token === "" || token === "-") return false;
+  if (/\s/.test(token)) return false;
+  if (token.includes("/") || token.includes("\\")) return false;
+  if (token.includes(".")) return false;
+  return true;
+}
+async function pathExists(path) {
+  try {
+    await (0, import_promises4.stat)(path);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
 // src/program.ts
 function buildProgram(options = {}) {
   const program = new import_commander.Command();
@@ -1922,6 +2438,7 @@ function buildProgram(options = {}) {
     return argv.includes("--json") || argv.includes("--quiet") || argv.includes("-q") || options.env?.CI === "true" || options.env === void 0 && process.env.CI === "true" || options.stdoutIsTTY === false || options.stdoutIsTTY === void 0 && process.stdout.isTTY !== true;
   };
   program.exitOverride();
+  program.showSuggestionAfterError();
   program.configureOutput({
     writeErr,
     // In JSON mode, suppress commander's default plain-text error so the
@@ -1932,13 +2449,13 @@ function buildProgram(options = {}) {
   });
   program.name("dropthis").description(
     [
-      import_picocolors4.default.dim("Publish anything online and get a URL back."),
+      import_picocolors6.default.dim("Publish anything online and get a URL back."),
       "",
-      `${import_picocolors4.default.bold("Quick start:")}`,
-      `  ${import_picocolors4.default.cyan("dropthis login")}`,
-      `  ${import_picocolors4.default.cyan("dropthis publish ./dist")}`
+      `${import_picocolors6.default.bold("Quick start:")}`,
+      `  ${import_picocolors6.default.cyan("dropthis login")}`,
+      `  ${import_picocolors6.default.cyan("dropthis publish ./dist")}`
     ].join("\n")
-  ).version("0.10.0").configureHelp({
+  ).version("0.12.0").configureHelp({
     subcommandTerm(cmd) {
       const args = cmd.registeredArguments.map((a) => {
         const name = a.name();
@@ -1947,16 +2464,28 @@ function buildProgram(options = {}) {
       }).join(" ");
       return args ? `${cmd.name()} ${args}` : cmd.name();
     },
-    styleTitle: (title) => import_picocolors4.default.bold(title),
-    styleCommandText: (str) => import_picocolors4.default.cyan(str),
-    styleSubcommandText: (str) => import_picocolors4.default.cyan(str),
-    styleOptionText: (str) => import_picocolors4.default.yellow(str)
+    styleTitle: (title) => import_picocolors6.default.bold(title),
+    styleCommandText: (str) => import_picocolors6.default.cyan(str),
+    styleSubcommandText: (str) => import_picocolors6.default.cyan(str),
+    styleOptionText: (str) => import_picocolors6.default.yellow(str)
   });
   program.option("--api-key <key>", "Override API key for this invocation");
   program.option("--api-url <url>", "Override API base URL");
   program.option("--json", "Force JSON output");
   program.option("-q, --quiet", "Suppress status output and imply JSON");
   program.option("--no-interactive", "Disable interactive prompts");
+  program.addHelpText(
+    "after",
+    [
+      "",
+      "Output is JSON when piped/CI/--json; human tables in a terminal.",
+      "Docs: https://dropthis.app"
+    ].join("\n")
+  );
+  const examplesBlock = (lines) => `
+${import_picocolors6.default.bold("Examples:")}
+${lines.map((l) => `  ${l}`).join("\n")}
+`;
   program.command("publish [input...]", { isDefault: true }).description(
     "Publish content to a permanent public URL (also: share, post, put online, make public, get a link).\nFiles, folders, URLs, strings, or stdin; multiple files bundle into one drop. Use - for stdin, or pipe without args.\nCreates a NEW drop each run \u2014 to change one you already published, use update-content (the files) or update-settings (title/visibility/password/expiry/metadata) with its drop_\u2026 id, not publish again."
   ).option("--title <title>", "Drop title").option("--visibility <v>", "public or unlisted (default: public)").option("--password <password>", "Require password to view").option("--noindex", "Prevent search-engine indexing").option("--expires-at <datetime>", "Auto-delete after this ISO 8601 date").option(
@@ -1968,12 +2497,27 @@ function buildProgram(options = {}) {
   ).option(
     "--metadata <json>",
     `Attach JSON key-value pairs, e.g. '{"source":"ci"}'`
-  ).option("--metadata-file <path>", "Read metadata JSON from a file").option("--path <name>", "Set filename when publishing from stdin").option("--url", "Print only the published URL (no JSON envelope)").option(
+  ).option("--metadata-file <path>", "Read metadata JSON from a file").option("--path <name>", "Set filename when publishing from stdin").option(
+    "--domain <hostname>",
+    "Serve this drop under a connected custom domain (must be live \u2014 see: dropthis domains list). Path-mode: drop lives at https://domain/{slug}/. Dedicated: drop is at the root (409 if occupied). Omit to use the account's default path domain."
+  ).option(
+    "--slug <vanity-slug>",
+    "Vanity slug for path-mode custom domains (1\u201363 lowercase letters/digits/hyphens). Auto-suffixed if taken. Only valid with --domain on a path-mode domain."
+  ).option("--url", "Print only the published URL (no JSON envelope)").option(
     "--dry-run",
     "Show what would be published without publishing (JSON; cannot combine with --url)"
   ).option("--json", "Force JSON output").option(
     "--idempotency-key <key>",
     "Prevent duplicate publishes on retry (auto-generated)"
+  ).addHelpText(
+    "after",
+    examplesBlock([
+      "dropthis publish ./report.html",
+      "dropthis publish ./dist --title 'Launch page'",
+      "cat report.md | dropthis publish - --content-type text/markdown --path report.md",
+      "dropthis publish ./dist --domain reports.example.com --slug launch",
+      "URL=$(dropthis publish ./dist --url)"
+    ])
   ).action(async (inputs, commandOptions) => {
     const stdinIsTTY = options.stdinIsTTY ?? process.stdin.isTTY ?? false;
     if (inputs.length === 0 && stdinIsTTY) {
@@ -1999,6 +2543,29 @@ function buildProgram(options = {}) {
       process.exitCode = writeError(deps, "local_input_error", msg).exitCode;
       return;
     }
+    if (deps.outputMode === "human" && deps.interactive && inputs.length === 1 && typeof publishInput === "string" && isBareWordToken(publishInput) && !await pathExists(publishInput)) {
+      const suggestion = suggestCommand(
+        publishInput,
+        program.commands.map((c) => c.name())
+      );
+      if (suggestion) {
+        process.exitCode = writeError(
+          deps,
+          "invalid_usage",
+          `Unknown command '${publishInput}' \u2014 did you mean '${suggestion}'?`,
+          `To publish the literal text, pipe it: echo '${publishInput}' | dropthis publish`
+        ).exitCode;
+        return;
+      }
+      const prompts6 = await import("@clack/prompts");
+      const confirmed = await prompts6.confirm({
+        message: `Publish '${publishInput}' as inline text?`,
+        initialValue: false
+      });
+      if (prompts6.isCancel(confirmed) || !confirmed) {
+        return;
+      }
+    }
     let dropOpts;
     try {
       dropOpts = toDropOptions(commandOptions);
@@ -2102,7 +2669,14 @@ function buildProgram(options = {}) {
   );
   program.command("pull <target>").description(
     "Download a drop's files into a local directory (accepts the drop_\u2026 id, the drop URL, or its slug).\nFetches the current deployment's file manifest and writes every file. Pull, edit, then update-content to ship the changes back to the same URL \u2014 also the rollback path."
-  ).option("-o, --output <dir>", "Output directory (default: ./<slug-or-id>)").option("--json", "Force JSON output").action(
+  ).option("-o, --output <dir>", "Output directory (default: ./<slug-or-id>)").option("--json", "Force JSON output").addHelpText(
+    "after",
+    examplesBlock([
+      "dropthis pull drop_abc123 -o ./site        # download the drop's files",
+      "$EDITOR ./site/index.html                  # edit locally",
+      "dropthis update-content drop_abc123 ./site # ship back to the same URL"
+    ])
+  ).action(
     async (target, commandOptions) => {
       const deps = await commandDeps(
         program,
@@ -2114,19 +2688,29 @@ function buildProgram(options = {}) {
       process.exitCode = result.exitCode;
     }
   );
-  program.command("get <dropId>").description("Show drop details (pass the full drop_\u2026 id)").option("--json", "Force JSON output").action(async (dropId, commandOptions) => {
+  program.command("get <dropId>").description(
+    "Show drop details (accepts the drop_\u2026 id, the drop URL, or its slug)"
+  ).option("--json", "Force JSON output").action(async (dropId, commandOptions) => {
     const deps = await commandDeps(program, options, store, commandOptions);
     const result = await runDropsGet(dropId, commandOptions, deps);
     process.exitCode = result.exitCode;
   });
-  program.command("list").description("List your drops").option("--limit <n>", "Page size", parseInteger).option("--cursor <cursor>", "Pagination cursor").option("--json", "Force JSON output").action(
+  program.command("list").description("List your drops").option("--limit <n>", "Page size", parseInteger).option("--cursor <cursor>", "Pagination cursor").option("--json", "Force JSON output").addHelpText(
+    "after",
+    examplesBlock([
+      "dropthis list",
+      "dropthis list --json | jq -r '.drops[] | [.id, .url] | @tsv'   # recover drop ids"
+    ])
+  ).action(
     async (commandOptions) => {
       const deps = await commandDeps(program, options, store, commandOptions);
       const result = await runDropsList(commandOptions, deps);
       process.exitCode = result.exitCode;
     }
   );
-  program.command("delete <dropId>").description("Delete a drop (pass the full drop_\u2026 id)").option("--yes", "Confirm deletion").option("--json", "Force JSON output").action(
+  program.command("delete <dropId>").description(
+    "Delete a drop (accepts the drop_\u2026 id, the drop URL, or its slug)"
+  ).option("--yes", "Confirm deletion").option("--json", "Force JSON output").action(
     async (dropId, commandOptions) => {
       const stdinIsTTY = options.stdinIsTTY ?? process.stdin.isTTY ?? false;
       const global = globalOptions(program, commandOptions);
@@ -2162,6 +2746,101 @@ function buildProgram(options = {}) {
       process.exitCode = result.exitCode;
     }
   );
+  const domains = program.command("domains").description(
+    "Manage custom domains. Loop: connect \u2192 create the CNAME at your DNS provider \u2192 verify --wait \u2192 publish --domain"
+  );
+  domains.command("connect <hostname>").description(
+    "Connect a custom domain. Returns DNS records to create at your provider.\nAfter adding them: dropthis domains verify <hostname> --wait"
+  ).requiredOption(
+    "--mode <mode>",
+    "Mount mode: path (many drops at hostname/{slug}/) or dedicated (one drop at root)"
+  ).option("--json", "Force JSON output").addHelpText(
+    "after",
+    examplesBlock([
+      "dropthis domains connect reports.example.com --mode path",
+      "# add the CNAME shown above at your DNS provider, then:",
+      "dropthis domains verify reports.example.com --wait",
+      "dropthis publish ./report.html --domain reports.example.com"
+    ])
+  ).action(
+    async (hostname, commandOptions) => {
+      if (commandOptions.mode !== "path" && commandOptions.mode !== "dedicated") {
+        process.stderr.write(`error: --mode must be "path" or "dedicated"
+`);
+        process.exitCode = 2;
+        return;
+      }
+      const deps = await commandDeps(program, options, store, commandOptions);
+      const result = await runDomainsConnect(
+        { hostname, mode: commandOptions.mode },
+        deps
+      );
+      process.exitCode = result.exitCode;
+    }
+  );
+  domains.command("list").description("List connected custom domains").option("--json", "Force JSON output").action(async (commandOptions) => {
+    const deps = await commandDeps(program, options, store, commandOptions);
+    const result = await runDomainsList(commandOptions, deps);
+    process.exitCode = result.exitCode;
+  });
+  domains.command("status <hostname>").description("Show domain details and DNS record status").option("--json", "Force JSON output").action(async (hostname, commandOptions) => {
+    const deps = await commandDeps(program, options, store, commandOptions);
+    const result = await runDomainsStatus(hostname, commandOptions, deps);
+    process.exitCode = result.exitCode;
+  });
+  domains.command("verify <hostname>").description(
+    "Trigger a DNS verification check. With --wait, polls until live or failed.\nUse after adding the DNS records from: dropthis domains connect"
+  ).option("--wait", "Poll until live (or failed/timeout)").option(
+    "--timeout <secs>",
+    "Max seconds to wait (default: 300)",
+    parseInteger
+  ).option("--json", "Force JSON output").addHelpText(
+    "after",
+    examplesBlock([
+      "dropthis domains verify reports.example.com --wait",
+      "dropthis domains verify reports.example.com --wait --timeout 600"
+    ])
+  ).action(
+    async (hostname, commandOptions) => {
+      const deps = await commandDeps(program, options, store, commandOptions);
+      const result = await runDomainsVerify(hostname, commandOptions, deps);
+      process.exitCode = result.exitCode;
+    }
+  );
+  domains.command("update <hostname>").description(
+    "Update a domain \u2014 repoint to a different drop (dedicated mode) or set/clear as account default (path mode). At least one option required."
+  ).option("--drop <dropId>", "Repoint to a different drop (dedicated mode)").option("--default", "Set as account default publish domain (path mode)").option("--json", "Force JSON output").action(
+    async (hostname, commandOptions) => {
+      const deps = await commandDeps(program, options, store, commandOptions);
+      const result = await runDomainsUpdate(
+        hostname,
+        {
+          ...commandOptions.drop !== void 0 ? { drop: commandOptions.drop } : {},
+          ...commandOptions.default !== void 0 ? { setDefault: commandOptions.default } : {}
+        },
+        deps
+      );
+      process.exitCode = result.exitCode;
+    }
+  );
+  domains.command("remove <hostname>").description(
+    "Remove a custom domain (unmounts its drops). IMPORTANT: also delete the DNS CNAME at your provider to prevent DNS hijacking."
+  ).option("--yes", "Confirm removal").option("--json", "Force JSON output").action(
+    async (hostname, commandOptions) => {
+      const stdinIsTTY = options.stdinIsTTY ?? process.stdin.isTTY ?? false;
+      const global = globalOptions(program, commandOptions);
+      const deps = await commandDeps(program, options, store, commandOptions);
+      const result = await runDomainsRemove(
+        hostname,
+        {
+          ...commandOptions,
+          interactive: isInteractive(stdinIsTTY, deps.env, global)
+        },
+        deps
+      );
+      process.exitCode = result.exitCode;
+    }
+  );
   const apiKeys = program.command("api-keys").description("Manage API keys");
   apiKeys.command("create").description("Create an API key").option("--label <label>", "API key label", "CLI").option("--json", "Force JSON output").action(async (commandOptions) => {
     const deps = await commandDeps(program, options, store, commandOptions);
@@ -2194,6 +2873,16 @@ function buildProgram(options = {}) {
       if (!commandOptions.email || !commandOptions.otp) {
         const deps2 = await commandDeps(program, options, store, commandOptions);
         const global2 = globalOptions(program, commandOptions);
+        const stdinIsTTY = options.stdinIsTTY ?? process.stdin.isTTY ?? false;
+        if (!isInteractive(stdinIsTTY, deps2.env, global2)) {
+          process.exitCode = writeError(
+            deps2,
+            "invalid_usage",
+            "dropthis login is interactive and needs a terminal.",
+            "Set DROPTHIS_API_KEY, or run: dropthis login request --email <email>, then dropthis login verify --email <email> --otp <code>."
+          ).exitCode;
+          return;
+        }
         const context = createContext({ global: global2 });
         const result2 = await runLoginInteractive({
           ...deps2,
@@ -2400,6 +3089,8 @@ function toDropOptions(options) {
     ...options.contentType ? { contentType: options.contentType } : {},
     ...options.path ? { path: options.path } : {},
     ...options.idempotencyKey ? { idempotencyKey: options.idempotencyKey } : {},
+    ...options.domain ? { domain: options.domain } : {},
+    ...options.slug ? { slug: options.slug } : {},
     ...options.json !== void 0 ? { json: options.json } : {},
     ...options.quiet !== void 0 ? { quiet: options.quiet } : {},
     ...options.url !== void 0 ? { url: options.url } : {},
@@ -2450,9 +3141,6 @@ function writeUsageErrorEnvelope(input) {
       `${JSON.stringify(errorEnvelope("usage_error", input.message))}
 `
     );
-  } else {
-    input.stderr(`${input.message}
-`);
   }
   return 2;
 }