@adsuploader/cli 0.1.1 → 0.1.3

package/SKILL.md

@@ -228,14 +228,18 @@ When using `copyFromAd`, provide the upload batch and optionally campaign/ad set
 
 ### Budget / Bid Override
 
-Values in account currency units (e.g. `50` = $50). Only one at a time.
+Values in account currency units (e.g. `50` = $50). `dailyBudget` and `bidAmount` are independent Meta fields.
+
+- **ABO** (budget on the ad set): set `dailyBudget`, `bidAmount`, or both. Bid-cap strategies (`COST_CAP`, `LOWEST_COST_WITH_BID_CAP`, `TARGET_COST`) need `bidAmount` alongside the budget.
+- **CBO** (budget on the campaign): don't set `dailyBudget` on the ad set — Meta rejects that since budget comes from the campaign. For bid-cap strategies, set only `bidAmount`.
 
 ```json
 { "adSet": { "dailyBudget": 50 } }
 { "adSet": { "bidAmount": 5 } }
+{ "adSet": { "dailyBudget": 50, "bidAmount": 5 } }
 ```
 
-Also available as CLI flags: `--daily-budget 50` or `--bid-amount 5`.
+Also available as CLI flags: `--daily-budget 50`, `--bid-amount 5`, or both.
 
 ### Text Configuration
 
@@ -502,6 +506,15 @@ ads create spec.json
 ads jobs JOB_ID --follow
 ```
 
+`ads create` and `ads jobs --follow` watch for up to 30 minutes. On very large batches (hundreds of creatives), the command may exit before the job finishes with:
+
+```
+−  Still running after 30 min — job continues on the server.
+   Resume with: ads jobs JOB_ID --follow
+```
+
+This is **not** a failure. The backend job keeps creating ads. Re-run the suggested command to resume watching. Exit code is `2` for this case (vs `0` for success, `1` for real errors) — shell scripts and agents should branch on the exit code to distinguish.
+
 ---
 
 ## Critical Gotchas
@@ -515,3 +528,5 @@ ads jobs JOB_ID --follow
 7. **`textPresetId` and `texts` are mutually exclusive** — use one or the other
 8. **Objective-specific CTAs** (`MESSAGE_PAGE`, `WHATSAPP_MESSAGE`, etc.) are inherited from the template — don't set them manually
 9. **Do not use `--json`** — it's for shell scripts, not interactive use. The human-readable output has everything you need
+10. **Never wrap CLI commands in polling loops** (`watch`, `while true; do ads adset X; sleep 5; done`, or equivalent). If you need to follow a job, use `ads jobs JOB_ID --follow`. If you need to verify ads landed after a create, run `ads adset <id>` **once** after the create returns — the job engine only marks complete when every ad is created on Facebook. Polling loops trigger rate limits (per-user-per-operation; list/read endpoints cap at 20/min) and return `429 Rate Limit Exceeded` with a `Retry-After` header.
+11. **`ads create` exit code 2 means "still running," not "failed."** On very large batches the CLI stops watching after 30 minutes while the backend job continues. Resume with `ads jobs JOB_ID --follow`. Treat exit code 2 as "come back later," exit code 1 as a real error.

package/dist/cli.cjs

@@ -4726,21 +4726,20 @@ function adCommand() {
     console.log(`  ${import_picocolors7.default.bold("Campaign:")}  ${ad.campaignId}`);
     console.log(`  ${import_picocolors7.default.bold("Ad Set:")}    ${ad.adSetId}`);
     if (ad.creative) {
+      const label = (name) => import_picocolors7.default.bold(name.padEnd(15));
       console.log("");
       console.log(`  ${import_picocolors7.default.bold("Creative")}`);
-      if (ad.creative.headline) console.log(`    ${import_picocolors7.default.bold("Headline:")}      ${truncate(ad.creative.headline)}`);
-      if (ad.creative.headlines) console.log(`    ${import_picocolors7.default.bold("Headlines:")}     ${ad.creative.headlines.map((h2) => truncate(h2, 60)).join(" | ")}`);
-      if (ad.creative.primaryText) console.log(`    ${import_picocolors7.default.bold("Primary Text:")}  ${truncate(ad.creative.primaryText)}`);
-      if (ad.creative.primaryTexts) console.log(`    ${import_picocolors7.default.bold("Primary Texts:")} ${ad.creative.primaryTexts.map((t) => truncate(t, 60)).join(" | ")}`);
-      if (ad.creative.description) console.log(`    ${import_picocolors7.default.bold("Description:")}   ${truncate(ad.creative.description)}`);
-      if (ad.creative.descriptions) console.log(`    ${import_picocolors7.default.bold("Descriptions:")}  ${ad.creative.descriptions.map((d3) => truncate(d3, 60)).join(" | ")}`);
-      if (ad.creative.cta) console.log(`    ${import_picocolors7.default.bold("CTA:")}            ${ad.creative.cta}`);
-      if (ad.creative.link) console.log(`    ${import_picocolors7.default.bold("Link:")}           ${ad.creative.link}`);
-      if (ad.creative.displayUrl) console.log(`    ${import_picocolors7.default.bold("Display URL:")}   ${ad.creative.displayUrl}`);
-      if (ad.creative.urlTags) console.log(`    ${import_picocolors7.default.bold("URL Tags:")}      ${ad.creative.urlTags}`);
-      if (ad.creative.enhancements) {
-        console.log(`    ${import_picocolors7.default.bold("Enhancements:")}   ${ad.creative.enhancements.join(", ")}`);
-      }
+      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.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}`);
+      if (ad.creative.urlTags) console.log(`    ${label("URL Tags:")}${ad.creative.urlTags}`);
+      if (ad.creative.enhancements) console.log(`    ${label("Enhancements:")}${ad.creative.enhancements.join(", ")}`);
     }
     console.log(`
   ${import_picocolors7.default.dim("Use this ad as a template:")} ads create --copy-from ${ad.id}
@@ -5183,7 +5182,8 @@ var import_picocolors11 = __toESM(require_picocolors(), 1);
 // src/lib/poll.js
 var import_picocolors10 = __toESM(require_picocolors(), 1);
 var POLL_INTERVAL = 500;
-var TIMEOUT_MS = 5 * 60 * 1e3;
+var TIMEOUT_MS = 30 * 60 * 1e3;
+var TIMEOUT_MINUTES = TIMEOUT_MS / 6e4;
 async function pollJob(client, jobId, opts = {}) {
   const jsonMode = opts.json;
   const tty = process.stdout.isTTY && !jsonMode;
@@ -5213,6 +5213,11 @@ async function pollJob(client, jobId, opts = {}) {
     if (jsonMode) {
       console.log(JSON.stringify(data));
       if (data.complete) return data;
+      if (Date.now() - startMs > TIMEOUT_MS) {
+        console.log(JSON.stringify({ event: "still_running", jobId }));
+        process.exitCode = 2;
+        return { status: "still_running", jobId };
+      }
       await sleep(POLL_INTERVAL);
       continue;
     }
@@ -5256,10 +5261,16 @@ async function pollJob(client, jobId, opts = {}) {
       return data;
     }
     if (Date.now() - startMs > TIMEOUT_MS) {
-      console.log("");
-      printError(`Timed out after 5 minutes. Check: ads jobs ${jobId}`);
-      console.log("");
-      return data;
+      if (jsonMode) {
+        console.log(JSON.stringify({ event: "still_running", jobId }));
+      } else {
+        console.log("");
+        console.log(`  ${import_picocolors10.default.yellow("\u2212")}  ${import_picocolors10.default.yellow(`Still running after ${TIMEOUT_MINUTES} min \u2014 job continues on the server.`)}`);
+        console.log(`     Resume with: ${import_picocolors10.default.bold(`ads jobs ${jobId} --follow`)}`);
+        console.log("");
+      }
+      process.exitCode = 2;
+      return { status: "still_running", jobId };
     }
     await sleep(POLL_INTERVAL);
   }
@@ -5401,10 +5412,13 @@ async function executeCreate(body, opts, { preview = false, test = false } = {})
         else if (Array.isArray(enh)) enhDetail = enh.join(", ");
         if (enhDetail) console.log(`  ${import_picocolors11.default.bold("Enhancements:")}   ${wrapLine(enhDetail, valCol)}`);
         if (result.budget) {
-          const label = result.budget.type === "dailyBudget" ? "Daily Budget" : "Bid Amount";
-          const pad = " ".repeat(Math.max(1, 16 - label.length - 1));
           const curr = result.budget.currency ? ` ${result.budget.currency}` : "";
-          console.log(`  ${import_picocolors11.default.bold(`${label}:`)}${pad}${result.budget.amount}${curr}`);
+          const renderLine = (label, amount) => {
+            const pad = " ".repeat(Math.max(1, 16 - label.length - 1));
+            console.log(`  ${import_picocolors11.default.bold(`${label}:`)}${pad}${amount}${curr}`);
+          };
+          if (result.budget.dailyBudget != null) renderLine("Daily Budget", result.budget.dailyBudget);
+          if (result.budget.bidAmount != null) renderLine("Bid Amount", result.budget.bidAmount);
         }
         console.log("");
       } else if (result.plan?.totals) {
@@ -5471,10 +5485,6 @@ function buildBodyFromOpts(specFile, opts) {
       }
     }
   }
-  if (opts.dailyBudget != null && opts.bidAmount != null) {
-    printError("Cannot set both --daily-budget and --bid-amount. Use one or the other.");
-    process.exit(1);
-  }
   if (opts.dailyBudget != null) {
     const budget = parseFloat(opts.dailyBudget);
     if (isNaN(budget) || budget <= 0) {
@@ -5919,7 +5929,7 @@ function statusLabel(status) {
 }
 
 // src/cli.js
-var VERSION = true ? "0.1.1" : "0.0.0";
+var VERSION = true ? "0.1.2" : "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";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adsuploader/cli",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "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",