@dropthis/cli 0.11.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;
@@ -239,7 +248,7 @@ function exitCodeFor(code) {
 
 // src/program.ts
 var import_commander = require("commander");
-var import_picocolors5 = __toESM(require("picocolors"), 1);
+var import_picocolors6 = __toESM(require("picocolors"), 1);
 
 // src/auth.ts
 async function resolveCredential(input) {
@@ -318,6 +327,10 @@ function writeResult(deps, link, verb, data) {
             `${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)}
+`);
         }
       }
     }
@@ -339,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`;
@@ -384,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)
@@ -399,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") {
@@ -507,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) {
@@ -647,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",
@@ -657,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"]
@@ -738,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) {
@@ -747,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 ?? "?"}  ${item.createdAt ?? ""}
+          `${item.id ?? ""}  rev ${item.revision ?? "?"}  ${created}
+`
+        );
+      }
+      if (page?.hasMore && page.nextCursor) {
+        deps.stdout(
+          `${hint(`More deployments: dropthis deployments list ${dropId} --cursor ${page.nextCursor}`)}
 `
         );
       }
@@ -756,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 };
 }
@@ -779,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 };
 }
@@ -797,13 +873,13 @@ async function runDoctor(_input, deps) {
   const authSource = credential?.source ?? "missing";
   const storageBackend = stored?.storage ?? "none";
   const pairs = [
-    ["Version", "0.11.0"],
+    ["Version", "0.12.0"],
     ["Auth", authSource],
     ["Storage", storageBackend]
   ];
   writeKv(deps, pairs, {
     ok: true,
-    version: "0.11.0",
+    version: "0.12.0",
     auth: { source: authSource },
     storage: { backend: storageBackend }
   });
@@ -811,6 +887,7 @@ async function runDoctor(_input, deps) {
 }
 
 // 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 "";
@@ -848,11 +925,32 @@ function formatDnsTable(records) {
   }
   return rows.join("\n");
 }
-function printNextHints(deps, hints) {
-  if (hints.length === 0) return;
+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 hints) {
-    deps.stdout(`${hint(h.message)}
+  for (const h of lines) {
+    deps.stdout(`${hint(renderNextHint(h, hostname, maxRetryAfter))}
 `);
   }
 }
@@ -889,7 +987,7 @@ async function runDomainsConnect(input, deps) {
       deps.stdout(`${formatDnsTable(domain.dns)}
 `);
     }
-    printNextHints(deps, domain.next);
+    printNextHints(deps, domain.next, domain.hostname, domain.dns);
   } else {
     writeJson(deps, { ok: true, domain });
   }
@@ -957,17 +1055,19 @@ async function runDomainsStatus(idOrHostname, _input, deps) {
 `);
     }
     if (domain.verifiedAt) {
-      deps.stdout(`  ${import_picocolors3.default.dim("Verified:")}  ${domain.verifiedAt}
-`);
+      deps.stdout(
+        `  ${import_picocolors3.default.dim("Verified:")}  ${formatDate(domain.verifiedAt)}
+`
+      );
     }
-    deps.stdout(`  ${import_picocolors3.default.dim("Created: ")}  ${domain.createdAt}
+    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);
+    printNextHints(deps, domain.next, domain.hostname, domain.dns);
   } else {
     writeJson(deps, { ok: true, domain });
   }
@@ -1000,7 +1100,7 @@ async function runDomainsVerify(idOrHostname, input, deps, sleep = defaultSleep)
           deps.stdout(`${formatDnsTable(domain.dns)}
 `);
         }
-        printNextHints(deps, domain.next);
+        printNextHints(deps, domain.next, domain.hostname, domain.dns);
       } else {
         writeJson(deps, { ok: true, domain });
       }
@@ -1081,7 +1181,22 @@ async function runDomainsUpdate(idOrHostname, input, deps) {
   });
   return { exitCode: 0 };
 }
-async function runDomainsRemove(idOrHostname, _input, deps) {
+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 } : {},
@@ -1114,7 +1229,30 @@ async function runDomainsRemove(idOrHostname, _input, deps) {
 }
 
 // src/commands/drops.ts
-var prompts2 = __toESM(require("@clack/prompts"), 1);
+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({
@@ -1132,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 } : {},
@@ -1159,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 = [];
@@ -1169,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)
@@ -1179,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,
@@ -1187,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 } : {},
@@ -1204,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}`), {
@@ -1215,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({
@@ -1251,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({
@@ -1275,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) {
@@ -1464,12 +1624,12 @@ function parseJsonObject(value, label) {
 }
 
 // src/spinner.ts
-var import_picocolors4 = __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_picocolors4.default.cyan(frames[i % frames.length])} ${message}`);
+    stderr(`\r\x1B[2K${import_picocolors5.default.cyan(frames[i % frames.length])} ${message}`);
     i++;
   }, 80);
   return {
@@ -1620,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) {
@@ -1820,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) {
@@ -1844,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 };
@@ -2233,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();
@@ -2243,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
@@ -2253,13 +2449,13 @@ function buildProgram(options = {}) {
   });
   program.name("dropthis").description(
     [
-      import_picocolors5.default.dim("Publish anything online and get a URL back."),
+      import_picocolors6.default.dim("Publish anything online and get a URL back."),
       "",
-      `${import_picocolors5.default.bold("Quick start:")}`,
-      `  ${import_picocolors5.default.cyan("dropthis login")}`,
-      `  ${import_picocolors5.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.11.0").configureHelp({
+  ).version("0.12.0").configureHelp({
     subcommandTerm(cmd) {
       const args = cmd.registeredArguments.map((a) => {
         const name = a.name();
@@ -2268,16 +2464,28 @@ function buildProgram(options = {}) {
       }).join(" ");
       return args ? `${cmd.name()} ${args}` : cmd.name();
     },
-    styleTitle: (title) => import_picocolors5.default.bold(title),
-    styleCommandText: (str) => import_picocolors5.default.cyan(str),
-    styleSubcommandText: (str) => import_picocolors5.default.cyan(str),
-    styleOptionText: (str) => import_picocolors5.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(
@@ -2301,6 +2509,15 @@ function buildProgram(options = {}) {
   ).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) {
@@ -2326,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);
@@ -2429,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,
@@ -2441,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);
@@ -2497,7 +2754,15 @@ function buildProgram(options = {}) {
   ).requiredOption(
     "--mode <mode>",
     "Mount mode: path (many drops at hostname/{slug}/) or dedicated (one drop at root)"
-  ).option("--json", "Force JSON output").action(
+  ).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"
@@ -2529,7 +2794,13 @@ function buildProgram(options = {}) {
     "--timeout <secs>",
     "Max seconds to wait (default: 300)",
     parseInteger
-  ).option("--json", "Force JSON output").action(
+  ).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);
@@ -2553,12 +2824,23 @@ function buildProgram(options = {}) {
     }
   );
   domains.command("remove <hostname>").description(
-    "Remove a custom domain. IMPORTANT: also delete the DNS CNAME at your provider to prevent DNS hijacking."
-  ).option("--json", "Force JSON output").action(async (hostname, commandOptions) => {
-    const deps = await commandDeps(program, options, store, commandOptions);
-    const result = await runDomainsRemove(hostname, commandOptions, deps);
-    process.exitCode = result.exitCode;
-  });
+    "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);
@@ -2591,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,
@@ -2849,9 +3141,6 @@ function writeUsageErrorEnvelope(input) {
       `${JSON.stringify(errorEnvelope("usage_error", input.message))}
 `
     );
-  } else {
-    input.stderr(`${input.message}
-`);
   }
   return 2;
 }