@dropthis/cli 0.12.0 → 0.14.0

package/README.md

@@ -180,6 +180,7 @@ dropthis update-settings <drop-id>           # Change title/visibility/password/
 dropthis pull <id|url|slug> [-o <dir>]       # Download a drop's files to a local directory
 dropthis get <id|url|slug>                   # Show drop details
 dropthis list                                # List your drops
+dropthis list --domain reports.example.com   # Only drops on a custom domain
 dropthis delete <id|url|slug>                # Delete a drop (--yes to confirm)
 
 dropthis deployments                         # View deployment history
@@ -197,6 +198,7 @@ dropthis api-keys create                     # Create an API key
 dropthis api-keys list                       # List API keys
 dropthis api-keys delete <key-id>            # Delete an API key (--yes to confirm)
 
+dropthis upgrade                             # Update the CLI to the latest version
 dropthis doctor                              # CLI diagnostics
 dropthis commands                            # Machine-readable command metadata
 ```
@@ -211,6 +213,7 @@ The CLI is designed for non-interactive use. In non-TTY environments (pipes, CI,
 export DROPTHIS_API_KEY=sk_live_...    # API key (same as --api-key)
 export DROPTHIS_API_URL=https://...    # Override API base URL (same as --api-url)
 export DROPTHIS_NON_INTERACTIVE=1      # Disable interactive prompts (same as --no-interactive)
+export DROPTHIS_NO_UPDATE_NOTIFIER=1   # Disable the startup update notice (also auto-disabled in CI, non-TTY, --json/--quiet)
 ```
 
 ```bash

package/dist/cli.cjs

@@ -224,6 +224,9 @@ function cliNextAction(error2) {
   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.";
   }
+  if (error2.code === "publish_conflict") {
+    return "The drop changed state mid-publish (likely deleted). Run dropthis publish again to create a fresh drop.";
+  }
   if (error2.statusCode === 404 || error2.code === "not_found") {
     return "Check the drop id or slug and retry; list your drops with dropthis list.";
   }
@@ -672,7 +675,10 @@ var COMMAND_ANNOTATIONS = {
   },
   list: {
     auth: "required",
-    examples: ["dropthis list --json"]
+    examples: [
+      "dropthis list --json",
+      "dropthis list --domain reports.example.com --json"
+    ]
   },
   delete: {
     auth: "required",
@@ -742,6 +748,7 @@ var COMMAND_ANNOTATIONS = {
     examples: ["dropthis account delete --yes --json"]
   },
   doctor: { examples: ["dropthis doctor --json"] },
+  upgrade: { examples: ["dropthis upgrade", "dropthis upgrade --json"] },
   commands: { examples: ["dropthis commands --json"] }
 };
 function describeArgs(cmd) {
@@ -873,13 +880,13 @@ async function runDoctor(_input, deps) {
   const authSource = credential?.source ?? "missing";
   const storageBackend = stored?.storage ?? "none";
   const pairs = [
-    ["Version", "0.12.0"],
+    ["Version", "0.14.0"],
     ["Auth", authSource],
     ["Storage", storageBackend]
   ];
   writeKv(deps, pairs, {
     ok: true,
-    version: "0.12.0",
+    version: "0.14.0",
     auth: { source: authSource },
     storage: { backend: storageBackend }
   });
@@ -1265,7 +1272,8 @@ async function runDropsList(input, deps) {
   }
   const params = {
     ...input.limit !== void 0 ? { limit: input.limit } : {},
-    ...input.cursor ? { cursor: input.cursor } : {}
+    ...input.cursor ? { cursor: input.cursor } : {},
+    ...input.domain ? { domain: input.domain } : {}
   };
   const result = await deps.client.drops.list(params);
   if (result.error) return writeApiError(deps, result.error);
@@ -1327,6 +1335,7 @@ async function runDropsGet(target, _input, deps) {
     pairs.push(["Revision", String(data.revision)]);
   if (data.createdAt)
     pairs.push(["Created", formatDate(String(data.createdAt))]);
+  if (data.domain) pairs.push(["Domain", String(data.domain)]);
   if (data.accessible !== void 0)
     pairs.push(["Accessible", String(data.accessible)]);
   if (data.persistent !== void 0)
@@ -2200,6 +2209,109 @@ function assertDropId2(target) {
   }
 }
 
+// src/commands/upgrade.ts
+var import_node_child_process = require("child_process");
+var import_node_fs = require("fs");
+var import_node_util = require("util");
+
+// src/semver.ts
+function compareSemver(a, b) {
+  const parse = (v) => (v.split("-")[0] ?? v).split(".").map(Number);
+  const pa = parse(a);
+  const pb = parse(b);
+  for (let i = 0; i < 3; i++) {
+    const d = (pa[i] ?? 0) - (pb[i] ?? 0);
+    if (d !== 0) return d < 0 ? -1 : 1;
+  }
+  return 0;
+}
+
+// src/commands/upgrade.ts
+var execFileAsync = (0, import_node_util.promisify)(import_node_child_process.execFile);
+var REGISTRY_LATEST = "https://registry.npmjs.org/@dropthis%2fcli/latest";
+async function fetchLatestFromRegistry() {
+  try {
+    const res = await fetch(REGISTRY_LATEST, {
+      signal: AbortSignal.timeout(1e4)
+    });
+    if (!res.ok) return null;
+    const body = await res.json();
+    return typeof body.version === "string" ? body.version : null;
+  } catch {
+    return null;
+  }
+}
+async function detectNpmGlobalInstall() {
+  try {
+    const argv1 = process.argv[1];
+    if (!argv1) return false;
+    const entry = (0, import_node_fs.realpathSync)(argv1);
+    const { stdout } = await execFileAsync("npm", ["root", "-g"]);
+    const root = (0, import_node_fs.realpathSync)(stdout.trim());
+    return entry.startsWith(root);
+  } catch {
+    return false;
+  }
+}
+async function npmInstallLatest() {
+  try {
+    await execFileAsync("npm", ["install", "-g", "@dropthis/cli@latest"]);
+    return { ok: true };
+  } catch (err) {
+    return {
+      ok: false,
+      message: err instanceof Error ? err.message : String(err)
+    };
+  }
+}
+async function runUpgrade(_input, deps) {
+  const fetchLatest = deps.fetchLatest ?? fetchLatestFromRegistry;
+  const isNpmGlobal = deps.isNpmGlobalInstall ?? detectNpmGlobalInstall;
+  const install = deps.runNpmInstall ?? npmInstallLatest;
+  const latest = await fetchLatest();
+  if (!latest) {
+    return writeError(
+      deps,
+      "upgrade_check_failed",
+      "Could not reach the npm registry to check for updates. Try again, or run: npm install -g @dropthis/cli@latest"
+    );
+  }
+  if (compareSemver(latest, deps.currentVersion) <= 0) {
+    writeHumanOrJson(
+      deps,
+      `Already on latest version (${deps.currentVersion})`,
+      { ok: true, status: "already-latest", version: deps.currentVersion }
+    );
+    return { exitCode: 0 };
+  }
+  if (!await isNpmGlobal()) {
+    return writeError(
+      deps,
+      "unsupported_install",
+      `Update available (${deps.currentVersion} \u2192 ${latest}), but this install was not made with \`npm install -g\`. Upgrade with the installer you used, e.g.: npm install -g @dropthis/cli@latest`
+    );
+  }
+  if (deps.outputMode === "human") {
+    deps.stdout(`Updating ${deps.currentVersion} \u2192 ${latest}...
+`);
+  }
+  const result = await install();
+  if (!result.ok) {
+    return writeError(
+      deps,
+      "upgrade_failed",
+      `npm install failed${result.message ? `: ${result.message}` : ""}. Try: npm install -g @dropthis/cli@latest`
+    );
+  }
+  writeHumanOrJson(deps, `Updated ${deps.currentVersion} \u2192 ${latest}`, {
+    ok: true,
+    status: "upgraded",
+    from: deps.currentVersion,
+    to: latest
+  });
+  return { exitCode: 0 };
+}
+
 // src/commands/whoami.ts
 async function runWhoami(_input, deps) {
   const credential = await resolveCredential({
@@ -2455,7 +2567,7 @@ function buildProgram(options = {}) {
       `  ${import_picocolors6.default.cyan("dropthis login")}`,
       `  ${import_picocolors6.default.cyan("dropthis publish ./dist")}`
     ].join("\n")
-  ).version("0.12.0").configureHelp({
+  ).version("0.14.0").configureHelp({
     subcommandTerm(cmd) {
       const args = cmd.registeredArguments.map((a) => {
         const name = a.name();
@@ -2695,11 +2807,12 @@ ${lines.map((l) => `  ${l}`).join("\n")}
     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").addHelpText(
+  program.command("list").description("List your drops").option("--limit <n>", "Page size", parseInteger).option("--cursor <cursor>", "Pagination cursor").option("--domain <hostname>", "Only drops mounted on this custom domain").option("--json", "Force JSON output").addHelpText(
     "after",
     examplesBlock([
       "dropthis list",
-      "dropthis list --json | jq -r '.drops[] | [.id, .url] | @tsv'   # recover drop ids"
+      "dropthis list --json | jq -r '.drops[] | [.id, .url] | @tsv'   # recover drop ids",
+      "dropthis list --domain reports.example.com --json   # drops on a custom domain"
     ])
   ).action(
     async (commandOptions) => {
@@ -2986,6 +3099,19 @@ ${lines.map((l) => `  ${l}`).join("\n")}
     const result = await runDoctor(commandOptions, deps);
     process.exitCode = result.exitCode;
   });
+  program.command("upgrade").description("Update the CLI to the latest version from npm").option("--json", "Force JSON output").action(async (commandOptions) => {
+    const deps = await commandDeps(
+      program,
+      options,
+      store,
+      commandOptions
+    );
+    const result = await runUpgrade(commandOptions, {
+      ...deps,
+      currentVersion: "0.14.0"
+    });
+    process.exitCode = result.exitCode;
+  });
   program.command("commands").description("Print machine-readable command metadata").option("--json", "Force JSON output").action(async (commandOptions) => {
     const deps = await commandDeps(
       program,
@@ -3134,6 +3260,72 @@ async function readStdinBytes(stdin) {
   return Buffer.concat(chunks);
 }
 
+// src/update-check.ts
+var import_node_child_process2 = require("child_process");
+var import_node_fs2 = require("fs");
+var import_node_os3 = require("os");
+var import_node_path3 = require("path");
+var CHECK_INTERVAL_MS = 24 * 60 * 60 * 1e3;
+var REGISTRY_LATEST2 = "https://registry.npmjs.org/@dropthis%2fcli/latest";
+function updateCachePath(configDir) {
+  return (0, import_node_path3.join)(
+    configDir ?? (0, import_node_path3.join)((0, import_node_os3.homedir)(), ".config", "dropthis"),
+    "update-check.json"
+  );
+}
+function readCache(path) {
+  try {
+    const value = JSON.parse((0, import_node_fs2.readFileSync)(path, "utf8"));
+    if (typeof value.lastCheckedAt !== "string" || typeof value.latestVersion !== "string")
+      return null;
+    return {
+      lastCheckedAt: value.lastCheckedAt,
+      latestVersion: value.latestVersion
+    };
+  } catch {
+    return null;
+  }
+}
+function shouldShowNotice(input) {
+  if (input.env.CI) return false;
+  if (input.env.DROPTHIS_NO_UPDATE_NOTIFIER) return false;
+  if (!input.stderrIsTTY) return false;
+  if (input.argv.includes("--json") || input.argv.includes("--quiet") || input.argv.includes("-q"))
+    return false;
+  return true;
+}
+function noticeFromCache(input) {
+  if (!input.cache) return null;
+  if (compareSemver(input.cache.latestVersion, input.currentVersion) <= 0)
+    return null;
+  return `Update available ${input.currentVersion} \u2192 ${input.cache.latestVersion} \xB7 run \`dropthis upgrade\``;
+}
+function shouldRefresh(cache, now) {
+  if (!cache) return true;
+  const last = Date.parse(cache.lastCheckedAt);
+  if (Number.isNaN(last)) return true;
+  return now.getTime() - last >= CHECK_INTERVAL_MS;
+}
+function scheduleBackgroundRefresh(cachePath, spawnFn = import_node_child_process2.spawn) {
+  const script = `
+const [, cachePath] = process.argv;
+fetch(${JSON.stringify(REGISTRY_LATEST2)}, { signal: AbortSignal.timeout(5000) })
+	.then((r) => (r.ok ? r.json() : Promise.reject(new Error(String(r.status)))))
+	.then((d) => {
+		const fs = require("node:fs");
+		const path = require("node:path");
+		fs.mkdirSync(path.dirname(cachePath), { recursive: true });
+		fs.writeFileSync(cachePath, JSON.stringify({ lastCheckedAt: new Date().toISOString(), latestVersion: String(d.version) }));
+	})
+	.catch(() => {});
+`;
+  const child = spawnFn(process.execPath, ["-e", script, cachePath], {
+    detached: true,
+    stdio: "ignore"
+  });
+  child.unref();
+}
+
 // src/cli.ts
 function writeUsageErrorEnvelope(input) {
   if (input.json) {
@@ -3150,7 +3342,29 @@ function isCommanderError(err) {
 function wantsJson(argv) {
   return argv.includes("--json") || argv.includes("--quiet") || argv.includes("-q") || process.env.CI === "true" || process.stdout.isTTY !== true;
 }
-buildProgram({ store: createCredentialStore() }).parseAsync(process.argv).catch((error2) => {
+var updateCache = readCache(updateCachePath());
+var showNotice = shouldShowNotice({
+  env: process.env,
+  stderrIsTTY: process.stderr.isTTY === true,
+  argv: process.argv.slice(2)
+});
+if (showNotice) {
+  const notice = noticeFromCache({
+    cache: updateCache,
+    currentVersion: "0.14.0"
+  });
+  if (notice) {
+    process.stderr.write(`
+${hint(notice)}
+
+`);
+  }
+}
+buildProgram({ store: createCredentialStore() }).parseAsync(process.argv).finally(() => {
+  if (showNotice && shouldRefresh(updateCache, /* @__PURE__ */ new Date())) {
+    scheduleBackgroundRefresh(updateCachePath());
+  }
+}).catch((error2) => {
   if (isCommanderError(error2)) {
     if (error2.code === "commander.help" || error2.code === "commander.helpDisplayed" || error2.code === "commander.version") {
       process.exitCode = 0;