@adsuploader/cli 0.1.6 → 0.1.8

package/README.md

@@ -42,6 +42,7 @@ This package includes a `SKILL.md` file that describes every command and option
 | `ads adset <id>` | Show ads in an ad set |
 | `ads ad <id>` | Ad details and creative |
 | `ads presets` | List saved presets |
+| `ads presets:save --from-ad <id> --name <name>` | Save an existing ad as an API preset |
 | `ads upload <files...>` | Upload images and videos |
 | `ads uploads` | List recent upload batches |
 | `ads create spec.json` | Create ads from spec |

package/SKILL.md

@@ -84,6 +84,7 @@ Ads are created **ACTIVE** by default. Use `--status PAUSED` to create them paus
 | `adset <adSetId>` | Show ads in an ad set |
 | `ad <adId>` | Ad details + creative config |
 | `presets` | List saved API presets (or `presets <id>` for details) |
+| `presets:save --from-ad <adId> --name <name>` | Save an existing ad as an API preset |
 | `text-presets` | List saved text presets (or `text-presets <id>` for details) |
 | `uploads` | List recent upload batches (or `uploads <batchId>` for details) |
 
@@ -115,6 +116,12 @@ Ads are created **ACTIVE** by default. Use `--status PAUSED` to create them paus
 | `--daily-budget <amount>` | Override daily budget (currency units) |
 | `--bid-amount <amount>` | Override bid/cost cap (currency units) |
 | `--text-file <path>` | Load text config from a JSON file |
+| `--expanded` | Show full headline, primary text, and description values in previews |
+
+### Detail Flags
+| Flag | Description |
+|------|-------------|
+| `ad --expanded` | Show full headline, primary text, and description values |
 
 ### Common Flags
 | Flag | Description |
@@ -366,7 +373,7 @@ When cherry-picking features, only list ones relevant to the media type. `video_
 
 ### Carousel Ads
 
-Group uploaded files into carousel ads with per-card text:
+Group uploaded files into carousel ads with per-card text and optional overall carousel text. `cardTexts` controls individual cards. Overall carousel text can be colocated on the carousel object or set in `texts.perAd` using the carousel `name`; colocated fields win when both are present.
 
 ```json
 {
@@ -374,6 +381,12 @@ Group uploaded files into carousel ads with per-card text:
     {
       "name": "My Carousel",
       "cards": ["slide1.jpg", "slide2.jpg", "slide3.jpg"],
+      "headlines": ["Overall Carousel Headline"],
+      "bodies": ["Overall primary text"],
+      "descriptions": ["Overall description"],
+      "cta": "SHOP_NOW",
+      "link": "https://example.com/carousel",
+      "urlTags": "utm_content=my_carousel",
       "cardTexts": [
         { "headline": "Slide 1", "description": "First card", "link": "https://example.com/1" },
         { "headline": "Slide 2", "description": "Second card", "link": "https://example.com/2" }
@@ -383,6 +396,31 @@ Group uploaded files into carousel ads with per-card text:
 }
 ```
 
+Alternative overall-text shape:
+
+```json
+{
+  "texts": {
+    "perAd": {
+      "My Carousel": {
+        "headlines": ["Overall Carousel Headline"],
+        "bodies": ["Overall primary text"],
+        "descriptions": ["Overall description"],
+        "cta": "SHOP_NOW",
+        "link": "https://example.com/carousel",
+        "urlTags": "utm_content=my_carousel"
+      }
+    }
+  },
+  "carousel": [
+    {
+      "name": "My Carousel",
+      "cards": ["slide1.jpg", "slide2.jpg", "slide3.jpg"]
+    }
+  ]
+}
+```
+
 Cards must reference filenames from the upload batch. Minimum 2 cards per carousel. Files claimed by a carousel are removed from the standard ad list.
 
 ### Flexible Ads
@@ -402,6 +440,32 @@ Group multiple assets into a single flexible ad (Meta picks the best asset per p
 
 Minimum 2 assets per group. Files claimed by a flexible group are removed from the standard ad list.
 
+### Multi Media Ads
+
+Group 2-10 uploaded images or videos into a Meta Multi Media ad:
+
+```json
+{
+  "multimedia": [
+    {
+      "name": "Mixed Media Ad",
+      "assets": ["hero.jpg", "promo.mp4", "banner.jpg"],
+      "assetTexts": [
+        {
+          "headline": "Hero headline",
+          "primaryText": "Hero primary text",
+          "description": "Hero description",
+          "link": "https://example.com/hero",
+          "displayUrl": "example.com/hero"
+        }
+      ]
+    }
+  ]
+}
+```
+
+Assets must reference filenames from the upload batch. `assetTexts` is optional and lines up with `assets` by index; each field is a single override for that asset and blank fields fall back to the ad's main text and URLs. The primary rendered asset uses the ad's main text and URL, and any primary asset text override becomes the first main text option. Videos need a cached public thumbnail URL from upload processing. Files claimed by a Multi Media group are removed from the standard ad list.
+
 ### Ad Naming
 
 ```json

package/dist/cli.cjs

@@ -4210,7 +4210,8 @@ function createClient(opts = {}) {
     },
     presets: {
       list: (query) => request("GET", "/presets", { query }),
-      get: (id) => request("GET", `/presets/${id}`)
+      get: (id) => request("GET", `/presets/${id}`),
+      create: (body) => request("POST", "/presets", { body })
     },
     uploads: {
       list: (query) => request("GET", "/uploads", { query }),
@@ -4706,12 +4707,12 @@ function adsetCommand() {
 
 // src/commands/ad.js
 var import_picocolors7 = __toESM(require_picocolors(), 1);
-function truncate(str, max = 120) {
-  if (!str || str.length <= max) return str;
+function truncate(str, max = 120, expanded = false) {
+  if (!str || expanded || str.length <= max) return str;
   return str.slice(0, max) + "...";
 }
 function adCommand() {
-  return new Command("ad").description("View ad details and creative").argument("<id>", "Ad ID").option("--account <id>", "Ad account ID").option("--json", "Output as JSON").action(async (id, opts) => {
+  return new Command("ad").description("View ad details and creative").argument("<id>", "Ad ID").option("--account <id>", "Ad account ID").option("--expanded", "Show full headline / primary text / description without truncation").option("--json", "Output as JSON").action(async (id, opts) => {
     const client = createClient({ accountId: opts.account });
     const { ad } = await client.ads.get(id);
     if (shouldOutputJson(opts)) {
@@ -4727,14 +4728,15 @@ function adCommand() {
     console.log(`  ${import_picocolors7.default.bold("Ad Set:")}    ${ad.adSetId}`);
     if (ad.creative) {
       const label = (name) => import_picocolors7.default.bold(name.padEnd(15));
+      const exp = !!opts.expanded;
       console.log("");
       console.log(`  ${import_picocolors7.default.bold("Creative")}`);
-      if (ad.creative.headline) console.log(`    ${label("Headline:")}${truncate(ad.creative.headline)}`);
-      if (ad.creative.headlines) console.log(`    ${label("Headlines:")}${ad.creative.headlines.map((h2) => truncate(h2, 60)).join(" | ")}`);
-      if (ad.creative.primaryText) console.log(`    ${label("Primary Text:")}${truncate(ad.creative.primaryText)}`);
-      if (ad.creative.primaryTexts) console.log(`    ${label("Primary Texts:")}${ad.creative.primaryTexts.map((t) => truncate(t, 60)).join(" | ")}`);
-      if (ad.creative.description) console.log(`    ${label("Description:")}${truncate(ad.creative.description)}`);
-      if (ad.creative.descriptions) console.log(`    ${label("Descriptions:")}${ad.creative.descriptions.map((d3) => truncate(d3, 60)).join(" | ")}`);
+      if (ad.creative.headline) console.log(`    ${label("Headline:")}${truncate(ad.creative.headline, 120, exp)}`);
+      if (ad.creative.headlines) console.log(`    ${label("Headlines:")}${ad.creative.headlines.map((h2) => truncate(h2, 60, exp)).join(" | ")}`);
+      if (ad.creative.primaryText) console.log(`    ${label("Primary Text:")}${truncate(ad.creative.primaryText, 120, exp)}`);
+      if (ad.creative.primaryTexts) console.log(`    ${label("Primary Texts:")}${ad.creative.primaryTexts.map((t) => truncate(t, 60, exp)).join(" | ")}`);
+      if (ad.creative.description) console.log(`    ${label("Description:")}${truncate(ad.creative.description, 120, exp)}`);
+      if (ad.creative.descriptions) console.log(`    ${label("Descriptions:")}${ad.creative.descriptions.map((d3) => truncate(d3, 60, exp)).join(" | ")}`);
       if (ad.creative.cta) console.log(`    ${label("CTA:")}${ad.creative.cta}`);
       if (ad.creative.link) console.log(`    ${label("Link:")}${ad.creative.link}`);
       if (ad.creative.displayUrl) console.log(`    ${label("Display URL:")}${ad.creative.displayUrl}`);
@@ -4833,6 +4835,50 @@ function textPresetsCommand() {
     console.log("");
   });
 }
+function presetsSaveCommand() {
+  return new Command("presets:save").description("Save an existing ad as a reusable API preset").option("--account <id>", "Ad account ID").option("--from-ad <adId>", "Ad ID to save settings from (required)").option("--name <name>", "Preset name (prompted if omitted)").option("--share", "Share with team (if you are on a team plan)").option("--json", "Output as JSON").action(async (opts) => {
+    const client = createClient({ accountId: opts.account });
+    if (!opts.fromAd) {
+      printError("--from-ad <adId> is required.");
+      process.exit(1);
+    }
+    let name = opts.name;
+    if (!name && isInteractive()) {
+      name = await he({
+        message: "Preset name",
+        placeholder: "e.g. Spring 2026 - Standard Purchase",
+        validate: (v2) => v2?.trim() ? void 0 : "Name is required"
+      });
+      if (pD(name)) process.exit(0);
+    }
+    if (!name?.trim()) {
+      printError("--name <name> is required (or run in an interactive TTY to be prompted).");
+      process.exit(1);
+    }
+    try {
+      const { preset } = await client.presets.create({
+        type: "api",
+        fromAdId: opts.fromAd,
+        name: name.trim(),
+        shareWithTeam: !!opts.share
+      });
+      if (shouldOutputJson(opts)) {
+        printJson(preset);
+        return;
+      }
+      printSuccess(`Saved preset "${preset.name}"`);
+      console.log(`  ${import_picocolors8.default.bold("ID:")}     ${preset.id}`);
+      console.log(`  ${import_picocolors8.default.bold("Type:")}   ${preset.type}`);
+      if (preset.shared) console.log(`  ${import_picocolors8.default.bold("Shared:")} ${import_picocolors8.default.cyan("team")}`);
+      console.log(`
+  ${import_picocolors8.default.dim("Use it:")} ads create --preset ${preset.id} ...
+`);
+    } catch (err) {
+      printError(err.message || "Failed to save preset");
+      process.exit(1);
+    }
+  });
+}
 
 // src/commands/upload.js
 var import_fs2 = __toESM(require("fs"), 1);
@@ -5002,6 +5048,7 @@ async function stageFiles(paths, opts) {
       uploadedFiles.push({
         name: file.name,
         type: file.type,
+        size: file.size,
         fileKey: r2Info.fileKey
       });
     } catch (err) {
@@ -5030,6 +5077,7 @@ async function processAndPrint(client, batchId, uploadedFiles, jsonMode) {
       const result = await client.uploads.process(batchId, {
         name: file.name,
         type: file.type,
+        size: file.size,
         fileKey: file.fileKey
       });
       results.push(result);
@@ -5331,7 +5379,7 @@ async function executeCreate(body, opts, { preview = false, test = false } = {})
         statusStr += import_picocolors11.default.dim(` (${levelLabel})`);
       }
       let enhLabel = "";
-      if (result.enhancements === "metaDefaults") enhLabel = import_picocolors11.default.dim("Meta Defaults");
+      if (result.enhancements === "metaDefaults") enhLabel = import_picocolors11.default.dim("All Off");
       else if (result.enhancements === "all") enhLabel = import_picocolors11.default.dim("All On");
       else if (result.enhancements === "none") enhLabel = import_picocolors11.default.dim("All Off");
       else if (Array.isArray(result.enhancements)) enhLabel = import_picocolors11.default.dim(`${result.enhancements.length} custom`);
@@ -5339,24 +5387,6 @@ async function executeCreate(body, opts, { preview = false, test = false } = {})
       console.log(`  ${parts.join(", ")} ${import_picocolors11.default.dim("\xB7")} ${statusStr}${enhPart}
 `);
       if (result.ads?.length) {
-        let wrapLine = function(text, startCol) {
-          const width = Math.max(termWidth - startCol, 20);
-          if (text.length <= width) return text;
-          const pad = " ".repeat(startCol);
-          const lines = [];
-          let remaining = text;
-          while (remaining.length > 0) {
-            if (remaining.length <= width) {
-              lines.push(remaining);
-              break;
-            }
-            let breakAt = remaining.lastIndexOf(" ", width);
-            if (breakAt <= 0) breakAt = width;
-            lines.push(remaining.slice(0, breakAt));
-            remaining = remaining.slice(breakAt + 1);
-          }
-          return lines.join("\n" + pad);
-        };
         const tableRows = [];
         let lastCampaign = null;
         let lastAdSet = null;
@@ -5378,6 +5408,24 @@ async function executeCreate(body, opts, { preview = false, test = false } = {})
         ]);
         console.log("");
         const termWidth = process.stdout.columns || 80;
+        const wrapLine = (text, startCol) => {
+          const width = Math.max(termWidth - startCol, 20);
+          if (text.length <= width) return text;
+          const pad = " ".repeat(startCol);
+          const lines = [];
+          let remaining = text;
+          while (remaining.length > 0) {
+            if (remaining.length <= width) {
+              lines.push(remaining);
+              break;
+            }
+            let breakAt = remaining.lastIndexOf(" ", width);
+            if (breakAt <= 0) breakAt = width;
+            lines.push(remaining.slice(0, breakAt));
+            remaining = remaining.slice(breakAt + 1);
+          }
+          return lines.join("\n" + pad);
+        };
         const allLinks = result.ads.map((a) => a.link).filter(Boolean);
         const allUrlTags = result.ads.map((a) => a.urlTags).filter(Boolean);
         const allCtas = result.ads.map((a) => a.cta).filter(Boolean);
@@ -5385,7 +5433,7 @@ async function executeCreate(body, opts, { preview = false, test = false } = {})
         const sharedUrlTags = allUrlTags.length > 0 && allUrlTags.every((t) => t === allUrlTags[0]) ? allUrlTags[0] : null;
         const sharedCta = allCtas.length > 0 && allCtas.every((c) => c === allCtas[0]) ? allCtas[0] : null;
         const maxText = 80;
-        const trunc = (s) => s.length > maxText ? s.slice(0, maxText - 1) + "\u2026" : s;
+        const trunc = (s) => opts.expanded || s.length <= maxText ? s : s.slice(0, maxText - 1) + "\u2026";
         let lastDetailAdSet = null;
         const distinctAdSets = new Set(result.ads.map((a) => a.adSetName).filter(Boolean));
         const showAdSetHeaders = distinctAdSets.size > 1;
@@ -5471,6 +5519,19 @@ async function executeCreate(body, opts, { preview = false, test = false } = {})
     process.exit(1);
   }
 }
+async function assertCopyFromAdIsUsable(client, adId) {
+  let ad;
+  try {
+    ({ ad } = await client.ads.get(adId));
+  } catch (err) {
+    printError(`Could not fetch ad ${adId}: ${err.message}`);
+    process.exit(1);
+  }
+  if (ad?.creative && ad.creative.canCopySettingsFrom === false) {
+    printError(ad.creative.cannotCopyReason || "This ad cannot be used as a template.");
+    process.exit(1);
+  }
+}
 function buildBodyFromOpts(specFile, opts) {
   let body;
   if (specFile) {
@@ -5524,12 +5585,13 @@ function buildBodyFromOpts(specFile, opts) {
   }
   return body;
 }
-var sharedOpts = (cmd) => cmd.option("--account <id>", "Ad account ID").option("--preset <id>", "API preset ID").option("--text-preset <id>", "Text preset ID").option("--copy-from <adId>", "Ad ID to copy settings from").option("--upload <batchId>", "Upload batch ID").option("--status <status>", "PAUSED or ACTIVE (default: ACTIVE)").option("--daily-budget <amount>", "Override daily budget per ad set (in currency units, e.g. 50 for $50)").option("--bid-amount <amount>", "Override bid/cost cap per ad set (in currency units, e.g. 5 for $5)").option("--pause-at <level>", "Pause level: ad (default), adSet, or campaign").option("--text-file <path>", "Load text configuration from JSON file").option("--json", "Output as JSON");
+var sharedOpts = (cmd) => cmd.option("--account <id>", "Ad account ID").option("--preset <id>", "API preset ID").option("--text-preset <id>", "Text preset ID").option("--copy-from <adId>", "Ad ID to copy settings from").option("--upload <batchId>", "Upload batch ID").option("--status <status>", "PAUSED or ACTIVE (default: ACTIVE)").option("--daily-budget <amount>", "Override daily budget per ad set (in currency units, e.g. 50 for $50)").option("--bid-amount <amount>", "Override bid/cost cap per ad set (in currency units, e.g. 5 for $5)").option("--pause-at <level>", "Pause level: ad (default), adSet, or campaign").option("--text-file <path>", "Load text configuration from JSON file").option("--expanded", "Show full headline / primary text / description without truncation").option("--json", "Output as JSON");
 function createCommand2() {
   const cmd = new Command("create").description("Create ads from spec file or flags").argument("[specFile]", "JSON spec file with ad configuration");
   sharedOpts(cmd);
   return cmd.action(async (specFile, opts) => {
     const body = buildBodyFromOpts(specFile, opts);
+    if (body.copyFromAd) await assertCopyFromAdIsUsable(createClient({ accountId: opts.account }), body.copyFromAd);
     await executeCreate(body, opts);
   });
 }
@@ -5547,6 +5609,7 @@ function createPreviewCommand() {
   sharedOpts(cmd);
   return cmd.action(async (specFile, opts) => {
     const body = buildBodyFromOpts(specFile, opts);
+    if (body.copyFromAd) await assertCopyFromAdIsUsable(createClient({ accountId: opts.account }), body.copyFromAd);
     await executeCreate(body, opts, { preview: true });
   });
 }
@@ -5555,6 +5618,7 @@ function createTestCommand() {
   sharedOpts(cmd);
   return cmd.action(async (specFile, opts) => {
     const body = buildBodyFromOpts(specFile, opts);
+    if (body.copyFromAd) await assertCopyFromAdIsUsable(createClient({ accountId: opts.account }), body.copyFromAd);
     await executeCreate(body, opts, { test: true });
   });
 }
@@ -5620,6 +5684,7 @@ async function interactiveCreate(client) {
     });
     if (pD(adChoice)) process.exit(0);
     body.copyFromAd = adChoice;
+    await assertCopyFromAdIsUsable(client, adChoice);
   }
   const uploadId = await he({
     message: "Upload batch ID (from `ads upload`)",
@@ -5733,7 +5798,7 @@ async function interactiveCreate(client) {
     if (pD(textStrategy)) process.exit(0);
     M2.info(import_picocolors11.default.dim("Enter headlines (one per line). Leave blank and press enter to finish."));
     const headlines = [];
-    while (true) {
+    for (; ; ) {
       const h2 = await he({
         message: `Headline ${headlines.length + 1}`,
         placeholder: headlines.length === 0 ? "Your headline..." : "(blank to finish)"
@@ -5744,7 +5809,7 @@ async function interactiveCreate(client) {
     }
     M2.info(import_picocolors11.default.dim("Enter primary text (one per line). Leave blank to finish."));
     const bodies = [];
-    while (true) {
+    for (; ; ) {
       const b4 = await he({
         message: `Primary text ${bodies.length + 1}`,
         placeholder: bodies.length === 0 ? "Your ad copy..." : "(blank to finish)"
@@ -5808,14 +5873,12 @@ async function interactiveCreate(client) {
   const enhancementsChoice = await ve({
     message: "Creative enhancements",
     options: [
-      { value: "meta", label: "Use Meta Defaults (recommended)" },
-      { value: "none", label: "No enhancements" }
+      { value: "none", label: "No enhancements (recommended)" },
+      { value: "all", label: "All enhancements" }
     ]
   });
   if (pD(enhancementsChoice)) process.exit(0);
-  if (enhancementsChoice !== "meta") {
-    body.creativeEnhancements = "none";
-  }
+  body.creativeEnhancements = enhancementsChoice;
   const status = await ve({
     message: "Launch status",
     options: [
@@ -5940,7 +6003,7 @@ function statusLabel(status) {
 }
 
 // src/cli.js
-var VERSION = true ? "0.1.6" : "0.0.0";
+var VERSION = true ? "0.1.8" : "0.0.0";
 var apiUrl = process.env.ADS_API_URL || getBaseUrl();
 if (apiUrl && (apiUrl.includes("localhost") || apiUrl.includes("127.0.0.1"))) {
   process.env.NODE_TLS_REJECT_UNAUTHORIZED = "0";
@@ -5970,6 +6033,7 @@ program2.addCommand(adsetsCommand());
 program2.addCommand(adsetCommand());
 program2.addCommand(adCommand());
 program2.addCommand(presetsCommand());
+program2.addCommand(presetsSaveCommand());
 program2.addCommand(textPresetsCommand());
 program2.addCommand(uploadsCommand());
 program2.addCommand(uploadCommand());

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adsuploader/cli",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "Create Facebook ads from the command line — bulk upload media, preview configurations, and launch ads at scale",
   "author": "Ads Uploader <support@adsuploader.com> (https://adsuploader.com)",
   "license": "UNLICENSED",