@facelessad/cli 1.1.0 → 1.1.1

package/README.md

@@ -27,6 +27,24 @@ stops on it immediately instead of polling forever. For long-running
 builds a webhook is still the better tool — a stuck shell is a stuck CI
 job. See https://facelessad.com/developers → Webhooks.
 
+## Getting the finished video
+
+`--wait` tells you when the video is done, but it never prints the video URL.
+Three ways to get the file:
+
+```bash
+facelessad download 103 --out ad.mp4        # saves into the CURRENT directory
+facelessad status 103 --json | jq -r .url   # the raw link, valid ~1 hour
+```
+
+The third is the browser: every video made through the CLI also appears in My
+Files at facelessad.com.
+
+Since 1.1.1 `download` prints the full path and the file size, and fails
+loudly on an empty file instead of reporting success. The link is signed and
+expires in about an hour — the video itself does not, so ask for the status
+again to get a fresh one.
+
 ## Custom style (1.1.0)
 
 Most tools accept a look of your own instead of one of the built-in styles.

package/index.js

@@ -382,8 +382,18 @@ const commands = {
     const file = String(flags.out || ('facelessad-' + id + '.mp4'));
     const res = await fetch(d.url);
     if (!res.ok) die('Download failed: HTTP ' + res.status, 'download_failed');
-    fs.writeFileSync(file, Buffer.from(await res.arrayBuffer()));
-    out({ ok: true, file }, 'Saved ' + file);
+    const buf = Buffer.from(await res.arrayBuffer());
+    // 1.1.1: tyhjä tiedosto tulosti ennen saman "Saved" kuin onnistunut lataus.
+    if (!buf.length) die('Download produced an empty file — the link may have expired. Run `facelessad status ' + id + '` and try again.', 'empty_download');
+    fs.writeFileSync(file, buf);
+    // 1.1.1: pelkkä tiedostonimi ei kertonut MIHIN tallennettiin. Tiedosto
+    // menee työhakemistoon, ei Downloadsiin, ja käyttäjä jäi etsimään sitä
+    // (omistajan raportti 12.8.2026). Absoluuttinen polku ja koko ääneen.
+    const full = path.resolve(file);
+    const mb = buf.length / (1024 * 1024);
+    const size = mb >= 1 ? mb.toFixed(1) + ' MB' : Math.max(1, Math.round(buf.length / 1024)) + ' kB';
+    out({ ok: true, file, path: full, bytes: buf.length },
+      'Saved ' + full + dim(' (' + size + ')'));
   },
 
   async help() {
@@ -399,7 +409,7 @@ Commands:
   create --tool <id> ...      Create a video (returns an id immediately)
   status <id> [--wait]        Status; --wait polls until done
   list [--limit --offset]     Your videos, newest first
-  download <id> [--out file]  Save the finished mp4
+  download <id> [--out file]  Save the finished mp4 into the current directory
 
 Create flags:
   --tool --url --text --duration --aspect --language --style --style-hint

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@facelessad/cli",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "Create faceless video ads from your terminal or build scripts — the FacelessAd command line.",
   "license": "MIT",
   "type": "module",