@adsuploader/cli 0.1.7 → 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 |

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);
@@ -5341,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;
@@ -5380,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);
@@ -5387,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;
@@ -5473,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) {
@@ -5526,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);
   });
 }
@@ -5549,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 });
   });
 }
@@ -5557,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 });
   });
 }
@@ -5622,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`)",
@@ -5735,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)"
@@ -5746,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)"
@@ -5940,7 +6003,7 @@ function statusLabel(status) {
 }
 
 // src/cli.js
-var VERSION = true ? "0.1.7" : "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.7",
+  "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",