@dropthis/cli 0.16.0 → 0.18.0

package/dist/cli.cjs

@@ -322,6 +322,11 @@ function writeResult(deps, link, verb, data) {
     const details = formatDropDetails(data);
     if (details) deps.stdout(`${details}
 `);
+    const rawUrl = data.rawUrl;
+    if (typeof rawUrl === "string" && rawUrl.length > 0) {
+      deps.stdout(`${hint(`Raw:  ${url(rawUrl)}`)}
+`);
+    }
     const warnings = data.warnings;
     if (Array.isArray(warnings)) {
       for (const w of warnings) {
@@ -697,6 +702,13 @@ var COMMAND_ANNOTATIONS = {
     auth: "required",
     examples: ["dropthis get drop_abc --json"]
   },
+  resolve: {
+    auth: "required",
+    examples: [
+      "dropthis resolve https://abc123.dropthis.app/",
+      "dropthis resolve abc123 --json"
+    ]
+  },
   list: {
     auth: "required",
     examples: [
@@ -904,13 +916,13 @@ async function runDoctor(_input, deps) {
   const authSource = credential?.source ?? "missing";
   const storageBackend = stored?.storage ?? "none";
   const pairs = [
-    ["Version", "0.16.0"],
+    ["Version", "0.18.0"],
     ["Auth", authSource],
     ["Storage", storageBackend]
   ];
   writeKv(deps, pairs, {
     ok: true,
-    version: "0.16.0",
+    version: "0.18.0",
     auth: { source: authSource },
     storage: { backend: storageBackend }
   });
@@ -1281,9 +1293,19 @@ async function resolveDropTarget(target, deps) {
   return {
     ok: true,
     dropId: resolved.data.id,
-    ...resolved.data.slug ? { slug: resolved.data.slug } : {}
+    resolvedFrom: target,
+    ...resolved.data.slug ? { slug: resolved.data.slug } : {},
+    ...typeof resolved.data.title === "string" ? { title: resolved.data.title } : {}
   };
 }
+function writeResolvedLine(deps, resolved) {
+  if (!resolved.resolvedFrom || deps.outputMode !== "human") return;
+  const title = resolved.title ? ` (${resolved.title})` : "";
+  deps.stdout(
+    `${hint(`resolved ${resolved.resolvedFrom} \u2192 ${resolved.dropId}${title}`)}
+`
+  );
+}
 async function runDropsList(input, deps) {
   try {
     await requireCredential({
@@ -1347,6 +1369,7 @@ async function runDropsGet(target, _input, deps) {
   }
   const resolved = await resolveDropTarget(target, deps);
   if (!resolved.ok) return { exitCode: resolved.exitCode };
+  writeResolvedLine(deps, resolved);
   const result = await deps.client.drops.get(resolved.dropId);
   if (result.error) return writeApiError(deps, result.error);
   const data = result.data;
@@ -1369,6 +1392,34 @@ async function runDropsGet(target, _input, deps) {
   writeKv(deps, pairs, { ok: true, drop: result.data });
   return { exitCode: 0 };
 }
+async function runDropsResolve(target, _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.drops.resolve(target);
+  if (result.error) return writeApiError(deps, result.error);
+  if (result.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."
+    });
+  }
+  const drop = result.data;
+  const pairs = [];
+  if (drop.id) pairs.push(["ID", String(drop.id)]);
+  if (drop.url) pairs.push(["URL", url(String(drop.url))]);
+  if (drop.title) pairs.push(["Title", String(drop.title)]);
+  if (drop.slug) pairs.push(["Slug", String(drop.slug)]);
+  writeKv(deps, pairs, { ok: true, drop });
+  return { exitCode: 0 };
+}
 async function runDropsDelete(target, input, deps) {
   if (!input.yes && input.interactive === false) {
     return writeError(
@@ -1388,6 +1439,7 @@ async function runDropsDelete(target, input, deps) {
   }
   const resolved = await resolveDropTarget(target, deps);
   if (!resolved.ok) return { exitCode: resolved.exitCode };
+  writeResolvedLine(deps, resolved);
   const dropId = resolved.dropId;
   if (!input.yes && input.interactive !== false) {
     const confirmed = await prompts3.confirm({
@@ -1815,6 +1867,7 @@ async function runPull(target, input, deps) {
   }
   const resolved = await resolveDropTarget(target, deps);
   if (!resolved.ok) return { exitCode: resolved.exitCode };
+  writeResolvedLine(deps, resolved);
   const dropId = resolved.dropId;
   const defaultDirName = resolved.slug || resolved.dropId;
   const spin = shouldSpin(deps.outputMode) ? createSpinner("Pulling content\u2026", deps.stderr) : void 0;
@@ -1900,22 +1953,30 @@ function contentOptions(options) {
   if (options.path !== void 0) out.path = options.path;
   return out;
 }
-async function runUpdateContent(dropId, input, raw, deps) {
+async function runUpdateContent(target, input, raw, deps) {
+  const apiKey = raw.apiKey ?? deps.apiKey;
   try {
     await requireCredential({
-      ...raw.apiKey ?? deps.apiKey ? { apiKey: raw.apiKey ?? deps.apiKey } : {},
+      ...apiKey ? { apiKey } : {},
       env: deps.env,
       store: deps.store
     });
   } catch {
     return writeAuthError(deps);
   }
+  const resolveDeps = {
+    ...deps,
+    ...apiKey ? { apiKey } : {}
+  };
+  const resolved = await resolveDropTarget(target, resolveDeps);
+  if (!resolved.ok) return { exitCode: resolved.exitCode };
+  const dropId = resolved.dropId;
   if (raw.dryRun) {
     return handleDryRun(dropId, input, raw, deps);
   }
+  writeResolvedLine(deps, resolved);
   let spin;
   try {
-    assertDropId(dropId);
     const hasInput = Array.isArray(input) ? input.length > 0 : input !== void 0;
     if (!hasInput) {
       return writeError(
@@ -1962,7 +2023,6 @@ async function handleDryRun(dropId, input, raw, deps) {
     );
   }
   try {
-    assertDropId(dropId);
     const hasInput = Array.isArray(input) ? input.length > 0 : input !== void 0;
     if (!hasInput) {
       return writeError(
@@ -1990,34 +2050,35 @@ async function handleDryRun(dropId, input, raw, deps) {
     return writeError(deps, code, message);
   }
 }
-function assertDropId(target) {
-  if (!target.startsWith("drop_")) {
-    throw new Error(
-      "update-content needs the full drop_\u2026 id from the publish response, not the URL slug, for example drop_..."
-    );
-  }
-}
 
 // src/commands/update-settings.ts
 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) {
+async function runUpdateSettings(target, raw, deps) {
+  const apiKey = raw.apiKey ?? deps.apiKey;
   try {
     await requireCredential({
-      ...raw.apiKey ?? deps.apiKey ? { apiKey: raw.apiKey ?? deps.apiKey } : {},
+      ...apiKey ? { apiKey } : {},
       env: deps.env,
       store: deps.store
     });
   } catch {
     return writeAuthError(deps);
   }
+  const resolveDeps = {
+    ...deps,
+    ...apiKey ? { apiKey } : {}
+  };
+  const resolved = await resolveDropTarget(target, resolveDeps);
+  if (!resolved.ok) return { exitCode: resolved.exitCode };
+  const dropId = resolved.dropId;
   if (raw.dryRun) {
     return handleDryRun2(dropId, raw, deps);
   }
+  writeResolvedLine(deps, resolved);
   let spin;
   try {
-    assertDropId2(dropId);
     let parsed = await parseDropOptions(raw);
     if (!hasSettingsFields(parsed)) {
       if (shouldPrompt(deps)) {
@@ -2206,7 +2267,6 @@ async function handleDryRun2(dropId, raw, deps) {
     );
   }
   try {
-    assertDropId2(dropId);
     const options = await parseDropOptions(raw);
     const fields = {};
     if (options.title) fields.title = options.title;
@@ -2225,13 +2285,6 @@ async function handleDryRun2(dropId, raw, deps) {
     return writeError(deps, "invalid_usage", message);
   }
 }
-function assertDropId2(target) {
-  if (!target.startsWith("drop_")) {
-    throw new Error(
-      "update-settings needs the full drop_\u2026 id from the publish response, not the URL slug, for example drop_..."
-    );
-  }
-}
 
 // src/commands/upgrade.ts
 var import_node_child_process = require("child_process");
@@ -2591,7 +2644,7 @@ function buildProgram(options = {}) {
       `  ${import_picocolors6.default.cyan("dropthis login")}`,
       `  ${import_picocolors6.default.cyan("dropthis publish ./dist")}`
     ].join("\n")
-  ).version("0.16.0").configureHelp({
+  ).version("0.18.0").configureHelp({
     subcommandTerm(cmd) {
       const args = cmd.registeredArguments.map((a) => {
         const name = a.name();
@@ -2655,6 +2708,18 @@ ${lines.map((l) => `  ${l}`).join("\n")}
       "dropthis publish ./report.html --domain shared   # bypass the account default domain",
       "URL=$(dropthis publish ./dist --url)"
     ])
+  ).addHelpText(
+    "after",
+    [
+      `
+${import_picocolors6.default.bold("Canonical vs raw URLs:")}`,
+      "  The canonical URL (the one printed) is always a branded human view, so the",
+      "  badge is guaranteed \u2014 hand it to people. For a single non-HTML file (e.g. a",
+      "  .md or .json), publish also prints a 'Raw:' line: the raw bytes at their",
+      "  natural path, with no wrapper \u2014 hand this to other agents. HTML drops and",
+      "  multi-file collections have no raw URL (the page IS the artifact / per-file",
+      "  paths come from the manifest)."
+    ].join("\n")
   ).action(async (inputs, commandOptions) => {
     const stdinIsTTY = options.stdinIsTTY ?? process.stdin.isTTY ?? false;
     if (inputs.length === 0 && stdinIsTTY) {
@@ -2832,6 +2897,19 @@ ${lines.map((l) => `  ${l}`).join("\n")}
     const result = await runDropsGet(dropId, commandOptions, deps);
     process.exitCode = result.exitCode;
   });
+  program.command("resolve <target>").description(
+    "Resolve a public drop URL or slug back to its drop_\u2026 id (accepts the id too).\nWrites are id-only \u2014 use this to recover the id from a URL, then update-content/update-settings/delete by that id."
+  ).option("--json", "Force JSON output").addHelpText(
+    "after",
+    examplesBlock([
+      "dropthis resolve https://abc123.dropthis.app/   # \u2192 drop_\u2026 id + url",
+      "dropthis resolve abc123 --json | jq -r .drop.id"
+    ])
+  ).action(async (target, commandOptions) => {
+    const deps = await commandDeps(program, options, store, commandOptions);
+    const result = await runDropsResolve(target, 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("--domain <hostname>", "Only drops mounted on this custom domain").option("--json", "Force JSON output").addHelpText(
     "after",
     examplesBlock([
@@ -3136,7 +3214,7 @@ ${lines.map((l) => `  ${l}`).join("\n")}
     );
     const result = await runUpgrade(commandOptions, {
       ...deps,
-      currentVersion: "0.16.0"
+      currentVersion: "0.18.0"
     });
     process.exitCode = result.exitCode;
   });
@@ -3379,7 +3457,7 @@ var showNotice = shouldShowNotice({
 if (showNotice) {
   const notice = noticeFromCache({
     cache: updateCache,
-    currentVersion: "0.16.0"
+    currentVersion: "0.18.0"
   });
   if (notice) {
     process.stderr.write(`