@adsuploader/cli 0.1.3 → 0.1.6

package/SKILL.md

@@ -308,6 +308,34 @@ Top-level CTA applies to all ads (overridden by per-ad CTA):
 }
 ```
 
+### URL Split-Test (LP A/B)
+
+Provide 2–5 destination URLs under `texts.urlVariants` and every generated ad set is duplicated once per URL so Meta optimizes each ad+LP combination independently (Barry Hott's method — don't split traffic inside one ad).
+
+```json
+{
+  "texts": {
+    "common": { "headlines": ["Hero"], "bodies": ["Copy"] },
+    "urlVariants": [
+      { "link": "https://example.com/homepage", "label": "homepage" },
+      { "link": "https://example.com/quiz", "label": "quiz-v2" }
+    ]
+  }
+}
+```
+
+- `label` is optional; when omitted, the last URL path slug is used (`/quiz-v2` → `quiz-v2`), falling back to hostname for root URLs.
+- Naming depends on ad set mode:
+  - `single`: each variant's label becomes the full ad set name.
+  - `perUpload` / `autoGroup`: each duplicated ad set name is `{base}-{label}`, or substitutes a `{destination}` token if present in the pattern.
+  - Explicit `adSet.groups[]`: use `{group}` (aliases: `{name}`, `{base}`, `{adset}`) in `adSet.namePattern` to reference `groups[i].name`.
+  - Variation grouping: use `{variation}` in `adSet.namePattern` to reference the filename prefix before `variationIdentifier`.
+- The `{date}` token resolves to today's date in labels (`launch-{date}` → `launch-2026-04-27`).
+- Each destination URL must be distinct. Trailing-slash and case variants of the same URL collapse to one — supply at least 2 truly different destinations.
+- Your ad set budget is multiplied by the number of variants.
+- Not compatible with per-ad `link` overrides — the variant URL wins when both are set.
+- Rejected with a 400 ConfigError if the source ad (preset or `copyFromAd`) targets a special destination (lead form, Messenger, WhatsApp, Instagram DM, Call) — those formats don't route via `cta.link`.
+
 **Standard CTA types:** `LEARN_MORE`, `SHOP_NOW`, `SIGN_UP`, `SUBSCRIBE`, `GET_OFFER`, `CONTACT_US`, `DOWNLOAD`, `ORDER_NOW`, `BUY_NOW`, `BOOK_NOW`, `APPLY_NOW`, `GET_QUOTE`, `GET_IN_TOUCH`, `WATCH_MORE`
 
 **Objective-specific CTAs** (inherited from template ad — do not set manually):
@@ -380,7 +408,7 @@ Minimum 2 assets per group. Files claimed by a flexible group are removed from t
 { "adNamePattern": "{filename} - {date}" }
 ```
 
-Placeholders: `{filename}`, `{index:01}`, `{variation}`, `{campaign}`, `{date}`, `{date:short}`, `{timestamp}`
+Placeholders: `{filename}`, `{index:01}`, `{variation}`, `{group}`, `{adset}`, `{campaign}`, `{date}`, `{date:short}`, `{timestamp}`
 
 ### Options
 

package/dist/cli.cjs

@@ -5386,18 +5386,29 @@ async function executeCreate(body, opts, { preview = false, test = false } = {})
         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;
+        let lastDetailAdSet = null;
+        const distinctAdSets = new Set(result.ads.map((a) => a.adSetName).filter(Boolean));
+        const showAdSetHeaders = distinctAdSets.size > 1;
         for (const ad of result.ads) {
+          if (showAdSetHeaders && ad.adSetName && ad.adSetName !== lastDetailAdSet) {
+            if (lastDetailAdSet !== null) console.log("");
+            console.log(`  ${import_picocolors11.default.dim("\u25B8 Ad Set:")} ${import_picocolors11.default.bold(ad.adSetName)}`);
+            lastDetailAdSet = ad.adSetName;
+          }
           const typeLabel = ad.mediaType ? import_picocolors11.default.dim(` [${ad.mediaType}]`) : "";
-          console.log(`  ${import_picocolors11.default.bold(import_picocolors11.default.blue(ad.name))}${typeLabel}`);
+          const indent = showAdSetHeaders ? "    " : "  ";
+          const fieldIndent = showAdSetHeaders ? "      " : "    ";
+          const fieldIndentLen = fieldIndent.length;
+          console.log(`${indent}${import_picocolors11.default.bold(import_picocolors11.default.blue(ad.name))}${typeLabel}`);
           const headline = (ad.headline || []).join(" | ");
           const primary = (ad.primaryText || []).join(" | ");
           const desc = (ad.description || []).join(" | ");
-          if (headline) console.log(`    ${import_picocolors11.default.dim("Headline:")}      ${trunc(headline)}`);
-          if (primary) console.log(`    ${import_picocolors11.default.dim("Primary Text:")}  ${trunc(primary)}`);
-          if (desc) console.log(`    ${import_picocolors11.default.dim("Description:")}   ${trunc(desc)}`);
-          if (ad.cta && !sharedCta) console.log(`    ${import_picocolors11.default.dim("CTA:")}           ${ad.cta}`);
-          if (ad.link && !sharedLink) console.log(`    ${import_picocolors11.default.dim("Link:")}          ${wrapLine(ad.link, 4)}`);
-          if (ad.urlTags && !sharedUrlTags) console.log(`    ${import_picocolors11.default.dim("URL Tags:")}     ${wrapLine(ad.urlTags, 4)}`);
+          if (headline) console.log(`${fieldIndent}${import_picocolors11.default.dim("Headline:")}      ${trunc(headline)}`);
+          if (primary) console.log(`${fieldIndent}${import_picocolors11.default.dim("Primary Text:")}  ${trunc(primary)}`);
+          if (desc) console.log(`${fieldIndent}${import_picocolors11.default.dim("Description:")}   ${trunc(desc)}`);
+          if (ad.cta && !sharedCta) console.log(`${fieldIndent}${import_picocolors11.default.dim("CTA:")}           ${ad.cta}`);
+          if (ad.link && !sharedLink) console.log(`${fieldIndent}${import_picocolors11.default.dim("Link:")}          ${wrapLine(ad.link, fieldIndentLen)}`);
+          if (ad.urlTags && !sharedUrlTags) console.log(`${fieldIndent}${import_picocolors11.default.dim("URL Tags:")}     ${wrapLine(ad.urlTags, fieldIndentLen)}`);
           console.log("");
         }
         const valCol = 18;
@@ -5929,7 +5940,7 @@ function statusLabel(status) {
 }
 
 // src/cli.js
-var VERSION = true ? "0.1.2" : "0.0.0";
+var VERSION = true ? "0.1.6" : "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.3",
+  "version": "0.1.6",
   "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",
@@ -32,7 +32,9 @@
   "scripts": {
     "build": "node build.cjs",
     "dev": "node src/cli.js",
-    "link": "npm link"
+    "link": "npm link",
+    "prepublishOnly": "npm run build",
+    "version": "npm run build"
   },
   "dependencies": {
     "commander": "^13.0.0",