npm - @dropthis/cli - Versions diffs - 0.20.0 → 0.22.0 - Mend

@dropthis/cli 0.20.0 → 0.22.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (20) hide show

package/README.md +55 -0
package/dist/cli.cjs +211 -51
package/dist/cli.cjs.map +1 -1
package/node_modules/@dropthis/node/README.md +20 -2
package/node_modules/@dropthis/node/dist/{drops-C92Gkuqx.d.cts → drops-DNwOp7g_.d.cts} +89 -5
package/node_modules/@dropthis/node/dist/{drops-C92Gkuqx.d.ts → drops-DNwOp7g_.d.ts} +89 -5
package/node_modules/@dropthis/node/dist/edge.cjs +88 -21
package/node_modules/@dropthis/node/dist/edge.cjs.map +1 -1
package/node_modules/@dropthis/node/dist/edge.d.cts +1 -1
package/node_modules/@dropthis/node/dist/edge.d.ts +1 -1
package/node_modules/@dropthis/node/dist/edge.mjs +88 -21
package/node_modules/@dropthis/node/dist/edge.mjs.map +1 -1
package/node_modules/@dropthis/node/dist/index.cjs +88 -21
package/node_modules/@dropthis/node/dist/index.cjs.map +1 -1
package/node_modules/@dropthis/node/dist/index.d.cts +2 -2
package/node_modules/@dropthis/node/dist/index.d.ts +2 -2
package/node_modules/@dropthis/node/dist/index.mjs +88 -21
package/node_modules/@dropthis/node/dist/index.mjs.map +1 -1
package/node_modules/@dropthis/node/package.json +1 -1
package/package.json +49 -49

package/README.md CHANGED Viewed

@@ -94,6 +94,57 @@ dropthis publish ./dist \
 `publish` always creates a NEW drop with a new URL. To change a drop you already published, use `update-content` or `update-settings` with its `drop_…` id — never publish again.
+### Canonical vs raw URLs
+Every drop has a canonical `url` — an always-branded human view (badge guaranteed). For a single non-HTML file (`.pdf`, `.png`, `.json`, a URL you asked the server to fetch, etc.), publish also prints a `Raw:` line: the file's exact bytes at a natural path, no wrapper. Hand the canonical `url` to people; hand the raw URL to agents or downstream tooling that needs the real bytes.
+### Publishing a bundle with remote assets (`--manifest`)
+When an AI agent generates an HTML page that references external images or other files, use `--manifest` to publish everything as one drop without base64-encoding the assets. The server fetches remote files during publish so bytes never pass through your process.
+```bash
+dropthis publish --manifest bundle.json
+```
+`bundle.json` shape:
+```json
+{
+  "files": [
+    {
+      "path": "index.html",
+      "content": "<html>...</html>"
+    },
+    {
+      "path": "hero.jpg",
+      "source_url": "https://cdn.example.com/hero.jpg"
+    },
+    {
+      "path": "data.json",
+      "content_base64": "eyJrZXkiOiJ2YWx1ZSJ9"
+    }
+  ]
+}
+```
+Each file entry must have a `path` and exactly one content key:
+| Key | Description |
+|-----|-------------|
+| `content` | UTF-8 text content (HTML, CSS, JSON, markdown, …) |
+| `source_url` | Public `https://` URL — the server fetches the bytes server-side. Use this for images and other binary assets instead of base64-encoding them. |
+| `content_base64` | Base64-encoded bytes (for binary files you already have in memory) |
+Optional per-file keys: `content_type` (MIME type override).
+The `--manifest` flag also works on `update-content`:
+```bash
+dropthis update-content drop_abc123 --manifest bundle-v2.json
+```
+Cannot be combined with a positional file/folder/URL argument.
 All publish flags:
 | Flag | Description |
@@ -105,6 +156,7 @@ All publish flags:
 | `--entry <path>` | Entry file for directories |
 | `--content-type <mime>` | MIME type (required for stdin) |
 | `--path <path>` | Filename (required for stdin) |
+| `--manifest <file>` | Multi-file bundle JSON (see above) |
 | `--expires-at <datetime>` | Expiration datetime |
 | `--metadata <json>` | Metadata as JSON string |
 | `--metadata-file <path>` | Metadata from a JSON file |
@@ -133,6 +185,9 @@ Change an existing drop without creating a new URL. Content and settings are **s
 # Replace the content at the same URL (ships a new deployment)
 dropthis update-content drop_abc123 ./dist-v2
+# Update from a manifest bundle (same --manifest format as publish)
+dropthis update-content drop_abc123 --manifest bundle-v2.json
 # Change settings only — title, visibility, password, expiry, metadata
 dropthis update-settings drop_abc123 --title "New title"

package/dist/cli.cjs CHANGED Viewed

@@ -916,13 +916,13 @@ async function runDoctor(_input, deps) {
   const authSource = credential?.source ?? "missing";
   const storageBackend = stored?.storage ?? "none";
   const pairs = [
-    ["Version", "0.20.0"],
+    ["Version", "0.22.0"],
     ["Auth", authSource],
     ["Storage", storageBackend]
   ];
   writeKv(deps, pairs, {
     ok: true,
-    version: "0.20.0",
+    version: "0.22.0",
     auth: { source: authSource },
     storage: { backend: storageBackend }
   });
@@ -1615,6 +1615,7 @@ async function runLogout(input, deps) {
 // src/drop-operations.ts
 var import_node_crypto = require("crypto");
+var import_promises = require("fs/promises");
 var MAX_BUNDLE_FILE_COUNT = 200;
 function isFileSystemError(error2) {
   if (!(error2 instanceof Error)) return false;
@@ -1634,6 +1635,70 @@ function validateManifestFileCount(count) {
     );
   }
 }
+async function loadManifestFile(manifestPath) {
+  let raw;
+  try {
+    raw = JSON.parse(await (0, import_promises.readFile)(manifestPath, "utf8"));
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : "Could not read manifest file.";
+    throw new Error(`Failed to read manifest file: ${msg}`);
+  }
+  if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
+    throw new Error("Manifest must be a JSON object with a 'files' array.");
+  }
+  const obj = raw;
+  if (!Array.isArray(obj.files)) {
+    throw new Error("Manifest must have a 'files' array.");
+  }
+  const files = obj.files.map(
+    (entry, i) => {
+      if (!entry || typeof entry !== "object") {
+        throw new Error(`Manifest files[${i}] must be an object.`);
+      }
+      const {
+        path,
+        content,
+        content_base64,
+        source_url,
+        content_type,
+        size_bytes,
+        checksum_sha256
+      } = entry;
+      if (!path || typeof path !== "string") {
+        throw new Error(`Manifest files[${i}] must have a 'path' string.`);
+      }
+      const contentKeys = [content, content_base64, source_url].filter(
+        (v) => v !== void 0
+      );
+      if (contentKeys.length === 0) {
+        throw new Error(
+          `Manifest files[${i}] (path: "${path}") must have exactly one of: content, content_base64, source_url.`
+        );
+      }
+      if (contentKeys.length > 1) {
+        throw new Error(
+          `Manifest files[${i}] (path: "${path}") must have only one of: content, content_base64, source_url.`
+        );
+      }
+      if (source_url !== void 0 && !source_url.startsWith("http://") && !source_url.startsWith("https://")) {
+        throw new Error(
+          `Manifest files[${i}] (path: "${path}") has an invalid source_url "${source_url}": source_url must be an http(s) URL.`
+        );
+      }
+      const file = { path };
+      if (content !== void 0) file.content = content;
+      if (content_base64 !== void 0) file.contentBase64 = content_base64;
+      if (source_url !== void 0) file.sourceUrl = source_url;
+      if (content_type !== void 0) file.contentType = content_type;
+      if (size_bytes !== void 0)
+        file.sizeBytes = size_bytes;
+      if (checksum_sha256 !== void 0)
+        file.checksumSha256 = checksum_sha256;
+      return file;
+    }
+  );
+  return { kind: "files", files };
+}
 function formatDryRunManifest(prepared, extra) {
   if (prepared.kind === "source") {
     return {
@@ -1646,8 +1711,11 @@ function formatDryRunManifest(prepared, extra) {
       ...prepared.metadata ? { metadata: prepared.metadata } : {}
     };
   }
+  const remoteFileCount = prepared.manifest.files.filter(
+    (f) => typeof f.sizeBytes !== "number"
+  ).length;
   const totalBytes = prepared.manifest.files.reduce(
-    (sum, f) => sum + f.sizeBytes,
+    (sum, f) => sum + (typeof f.sizeBytes === "number" ? f.sizeBytes : 0),
     0
   );
   return {
@@ -1661,12 +1729,15 @@ function formatDryRunManifest(prepared, extra) {
     },
     options: prepared.options,
     ...prepared.metadata ? { metadata: prepared.metadata } : {},
-    totalBytes
+    totalBytes,
+    // Only include remoteFileCount when there are remote files, to preserve
+    // the existing output shape for all-inline bundles.
+    ...remoteFileCount > 0 ? { remoteFileCount } : {}
   };
 }
 // src/options.ts
-var import_promises = require("fs/promises");
+var import_promises2 = require("fs/promises");
 var import_node = require("@dropthis/node");
 async function parseDropOptions(raw) {
   if (raw.metadata && raw.metadataFile) {
@@ -1695,7 +1766,7 @@ async function parseDropOptions(raw) {
     }
   }
   const metadata = raw.metadata ? parseJsonObject(raw.metadata, "--metadata") : raw.metadataFile ? parseJsonObject(
-    await (0, import_promises.readFile)(raw.metadataFile, "utf8"),
+    await (0, import_promises2.readFile)(raw.metadataFile, "utf8"),
     "--metadata-file"
   ) : void 0;
   return {
@@ -1777,6 +1848,25 @@ async function runPublish(input, raw, deps) {
   if (didInlineAuth && deps.createClient) {
     client = deps.createClient(credential.apiKey);
   }
+  if (raw.manifest) {
+    const hasInput2 = Array.isArray(input) ? input.length > 0 : input !== void 0;
+    if (hasInput2) {
+      return writeError(
+        deps,
+        "invalid_usage",
+        "--manifest cannot be combined with a positional input.",
+        "Remove the positional argument, or omit --manifest and pass your files directly."
+      );
+    }
+    let manifestInput;
+    try {
+      manifestInput = await loadManifestFile(raw.manifest);
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : "Invalid manifest.";
+      return writeError(deps, "invalid_usage", msg);
+    }
+    input = manifestInput;
+  }
   if (raw.dryRun) {
     return handlePublishDryRun(input, raw, deps, client);
   }
@@ -1845,7 +1935,8 @@ async function handlePublishDryRun(input, raw, deps, client) {
     );
   }
   try {
-    if (!input || Array.isArray(input) && input.length === 0) {
+    const hasInput = Array.isArray(input) ? input.length > 0 : input !== void 0;
+    if (!hasInput) {
       throw new Error("Publish requires <input>.");
     }
     const options = await parseDropOptions(raw);
@@ -1868,7 +1959,7 @@ async function handlePublishDryRun(input, raw, deps, client) {
 }
 // src/commands/pull.ts
-var import_promises2 = require("fs/promises");
+var import_promises3 = require("fs/promises");
 var import_node_path = require("path");
 async function runPull(target, input, deps) {
   try {
@@ -1908,7 +1999,7 @@ async function runPull(target, input, deps) {
     return writeError(deps, "local_input_error", message);
   }
   try {
-    await (0, import_promises2.mkdir)(outDir, { recursive: true });
+    await (0, import_promises3.mkdir)(outDir, { recursive: true });
     for (const { path, dest } of destinations) {
       const fileResult = await deps.client.drops.getContent(dropId, { path });
       if (fileResult.error) {
@@ -1919,8 +2010,8 @@ async function runPull(target, input, deps) {
         });
       }
       const file = fileResult.data;
-      await (0, import_promises2.mkdir)((0, import_node_path.dirname)(dest), { recursive: true });
-      await (0, import_promises2.writeFile)(dest, file.bytes);
+      await (0, import_promises3.mkdir)((0, import_node_path.dirname)(dest), { recursive: true });
+      await (0, import_promises3.writeFile)(dest, file.bytes);
     }
   } catch (error2) {
     spin?.fail();
@@ -1968,6 +2059,15 @@ function contentOptions(options) {
   if (options.path !== void 0) out.path = options.path;
   return out;
 }
+function partialOptions(raw) {
+  const out = {};
+  if (raw.replace) out.mode = "replace";
+  else if (raw.mode !== void 0) out.mode = raw.mode;
+  if (raw.deletePaths !== void 0 && raw.deletePaths.length > 0) {
+    out.deletePaths = raw.deletePaths;
+  }
+  return out;
+}
 async function runUpdateContent(target, input, raw, deps) {
   const apiKey = raw.apiKey ?? deps.apiKey;
   try {
@@ -1986,6 +2086,23 @@ async function runUpdateContent(target, input, raw, deps) {
   const resolved = await resolveDropTarget(target, resolveDeps);
   if (!resolved.ok) return { exitCode: resolved.exitCode };
   const dropId = resolved.dropId;
+  if (raw.manifest) {
+    const hasInput = Array.isArray(input) ? input.length > 0 : input !== void 0;
+    if (hasInput) {
+      return writeError(
+        deps,
+        "invalid_usage",
+        "--manifest cannot be combined with a positional input.",
+        "Remove the positional argument, or omit --manifest and pass your files directly."
+      );
+    }
+    try {
+      input = await loadManifestFile(raw.manifest);
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : "Invalid manifest.";
+      return writeError(deps, "invalid_usage", msg);
+    }
+  }
   if (raw.dryRun) {
     return handleDryRun(dropId, input, raw, deps);
   }
@@ -2008,7 +2125,11 @@ async function runUpdateContent(target, input, raw, deps) {
       dropId,
       input,
       withIdempotencyKey(
-        { ...contentOptions(parsed), ...revisionOptions },
+        {
+          ...contentOptions(parsed),
+          ...partialOptions(raw),
+          ...revisionOptions
+        },
         "upd"
       )
     );
@@ -2478,7 +2599,7 @@ function createContext(input) {
 }
 // src/storage.ts
-var import_promises3 = require("fs/promises");
+var import_promises4 = require("fs/promises");
 var import_node_os = require("os");
 var import_node_path2 = require("path");
 var import_keyring = require("@napi-rs/keyring");
@@ -2512,7 +2633,7 @@ var InsecureFileCredentialStore = class {
     });
   }
   async clear() {
-    await (0, import_promises3.rm)(this.filePath, { force: true });
+    await (0, import_promises4.rm)(this.filePath, { force: true });
   }
 };
 var KeyringCredentialStore = class {
@@ -2539,7 +2660,7 @@ var KeyringCredentialStore = class {
   }
   async clear() {
     await this.keyring.deletePassword();
-    await (0, import_promises3.rm)(this.filePath, { force: true });
+    await (0, import_promises4.rm)(this.filePath, { force: true });
   }
 };
 function createCredentialStore(options = {}) {
@@ -2564,7 +2685,7 @@ function credentialPath(configDir) {
 }
 async function readJsonFile(path) {
   try {
-    return JSON.parse(await (0, import_promises3.readFile)(path, "utf8"));
+    return JSON.parse(await (0, import_promises4.readFile)(path, "utf8"));
   } catch (error2) {
     if (error2 && typeof error2 === "object" && "code" in error2 && error2.code === "ENOENT") {
       return null;
@@ -2573,18 +2694,18 @@ async function readJsonFile(path) {
   }
 }
 async function writeCredentialFile(path, credential) {
-  await (0, import_promises3.mkdir)((0, import_node_path2.dirname)(path), { recursive: true });
+  await (0, import_promises4.mkdir)((0, import_node_path2.dirname)(path), { recursive: true });
   const tmpPath = `${path}.${process.pid}.tmp`;
-  await (0, import_promises3.writeFile)(tmpPath, `${JSON.stringify(credential, null, 2)}
+  await (0, import_promises4.writeFile)(tmpPath, `${JSON.stringify(credential, null, 2)}
 `, {
     mode: 384
   });
-  await (0, import_promises3.chmod)(tmpPath, 384);
-  await (0, import_promises3.rename)(tmpPath, path);
+  await (0, import_promises4.chmod)(tmpPath, 384);
+  await (0, import_promises4.rename)(tmpPath, path);
 }
 // src/typo-guard.ts
-var import_promises4 = require("fs/promises");
+var import_promises5 = require("fs/promises");
 function levenshtein(a, b) {
   if (a === b) return 0;
   if (a.length === 0) return b.length;
@@ -2625,7 +2746,7 @@ function isBareWordToken(token) {
 }
 async function pathExists(path) {
   try {
-    await (0, import_promises4.stat)(path);
+    await (0, import_promises5.stat)(path);
     return true;
   } catch {
     return false;
@@ -2659,7 +2780,7 @@ function buildProgram(options = {}) {
       `  ${import_picocolors6.default.cyan("dropthis login")}`,
       `  ${import_picocolors6.default.cyan("dropthis publish ./dist")}`
     ].join("\n")
-  ).version("0.20.0").configureHelp({
+  ).version("0.22.0").configureHelp({
     subcommandTerm(cmd) {
       const args = cmd.registeredArguments.map((a) => {
         const name = a.name();
@@ -2710,6 +2831,9 @@ ${lines.map((l) => `  ${l}`).join("\n")}
   ).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(
+    "--manifest <file>",
+    "Publish a multi-file bundle defined in a JSON file (path, content/source_url/content_base64 per file). Cannot combine with a positional input."
   ).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)"
@@ -2740,7 +2864,7 @@ ${import_picocolors6.default.bold("Canonical vs raw URLs:")}`,
     ].join("\n")
   ).action(async (inputs, commandOptions) => {
     const stdinIsTTY = options.stdinIsTTY ?? process.stdin.isTTY ?? false;
-    if (inputs.length === 0 && stdinIsTTY) {
+    if (inputs.length === 0 && stdinIsTTY && !commandOptions.manifest) {
       program.outputHelp();
       return;
     }
@@ -2752,16 +2876,22 @@ ${import_picocolors6.default.bold("Canonical vs raw URLs:")}`,
       stdinIsTTY
     );
     let publishInput;
-    try {
-      publishInput = await resolvePublishInputs(
-        inputs,
-        options.stdin,
-        stdinIsTTY
-      );
-    } catch (err) {
-      const msg = err instanceof Error ? err.message : "Invalid input.";
-      process.exitCode = writeError(deps, "local_input_error", msg).exitCode;
-      return;
+    if (inputs.length > 0 || !commandOptions.manifest) {
+      try {
+        publishInput = await resolvePublishInputs(
+          inputs,
+          options.stdin,
+          stdinIsTTY
+        );
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : "Invalid input.";
+        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(
@@ -2806,6 +2936,18 @@ ${import_picocolors6.default.bold("Canonical vs raw URLs:")}`,
     "--content-type <mime>",
     "Override MIME type (auto-detected from extension)"
   ).option("--path <name>", "Set filename for stdin content").option(
+    "--manifest <file>",
+    "Update content from a multi-file bundle defined in a JSON file (path, content/source_url/content_base64 per file). Cannot combine with a positional input."
+  ).option(
+    "--mode <mode>",
+    "patch (default: provided files upsert, the rest carry forward) or replace (provided files become the whole content set)",
+    parseMode
+  ).option("--replace", "Shortcut for --mode replace (full content swap)").option(
+    "--delete-path <path>",
+    "Remove a file by path (patch-mode only; repeatable). Invalid with --replace.",
+    collect,
+    []
+  ).option(
     "--if-revision <n>",
     "Fail if current revision doesn't match (optimistic lock)",
     parseInteger
@@ -2820,20 +2962,22 @@ ${import_picocolors6.default.bold("Canonical vs raw URLs:")}`,
       const deps = await commandDeps(program, options, store, commandOptions);
       const stdinIsTTY = options.stdinIsTTY ?? process.stdin.isTTY ?? false;
       let updateInput;
-      try {
-        updateInput = await resolvePublishInputs(
-          inputs,
-          options.stdin,
-          stdinIsTTY
-        );
-      } catch (err) {
-        const msg = err instanceof Error ? err.message : "Invalid input.";
-        process.exitCode = writeError(
-          deps,
-          "local_input_error",
-          msg
-        ).exitCode;
-        return;
+      if (inputs.length > 0 || !commandOptions.manifest) {
+        try {
+          updateInput = await resolvePublishInputs(
+            inputs,
+            options.stdin,
+            stdinIsTTY
+          );
+        } catch (err) {
+          const msg = err instanceof Error ? err.message : "Invalid input.";
+          process.exitCode = writeError(
+            deps,
+            "local_input_error",
+            msg
+          ).exitCode;
+          return;
+        }
       }
       let dropOpts;
       try {
@@ -2843,10 +2987,16 @@ ${import_picocolors6.default.bold("Canonical vs raw URLs:")}`,
         process.exitCode = writeError(deps, "invalid_usage", msg).exitCode;
         return;
       }
+      const deletePaths = commandOptions.deletePath ?? [];
+      const updateOpts = {
+        ...dropOpts,
+        ...commandOptions.replace ? { mode: "replace" } : commandOptions.mode !== void 0 ? { mode: commandOptions.mode } : {},
+        ...deletePaths.length > 0 ? { deletePaths } : {}
+      };
       const result = await runUpdateContent(
         dropId,
         updateInput,
-        dropOpts,
+        updateOpts,
         deps
       );
       process.exitCode = result.exitCode;
@@ -3232,7 +3382,7 @@ ${import_picocolors6.default.bold("Canonical vs raw URLs:")}`,
     );
     const result = await runUpgrade(commandOptions, {
       ...deps,
-      currentVersion: "0.20.0"
+      currentVersion: "0.22.0"
     });
     process.exitCode = result.exitCode;
   });
@@ -3342,6 +3492,7 @@ function toDropOptions(options) {
     ...options.domain ? { domain: options.domain } : {},
     ...options.shared ? { shared: true } : {},
     ...options.slug ? { slug: options.slug } : {},
+    ...options.manifest ? { manifest: options.manifest } : {},
     ...options.json !== void 0 ? { json: options.json } : {},
     ...options.quiet !== void 0 ? { quiet: options.quiet } : {},
     ...options.url !== void 0 ? { url: options.url } : {},
@@ -3354,6 +3505,15 @@ function parseInteger(value) {
   if (Number.isNaN(n)) throw new import_commander.InvalidArgumentError("Expected an integer.");
   return n;
 }
+function parseMode(value) {
+  if (value !== "patch" && value !== "replace") {
+    throw new import_commander.InvalidArgumentError('Use "patch" or "replace".');
+  }
+  return value;
+}
+function collect(value, previous) {
+  return [...previous, value];
+}
 async function resolvePublishInputs(inputs, stdin, stdinIsTTY) {
   if (inputs.length === 0) {
     if (stdinIsTTY) return void 0;
@@ -3476,7 +3636,7 @@ var showNotice = shouldShowNotice({
 if (showNotice) {
   const notice = noticeFromCache({
     cache: updateCache,
-    currentVersion: "0.20.0"
+    currentVersion: "0.22.0"
   });
   if (notice) {
     process.stderr.write(`