@adsuploader/cli 0.1.6 → 0.1.7

package/SKILL.md

@@ -366,7 +366,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 +374,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 +389,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 +433,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

@@ -5002,6 +5002,7 @@ async function stageFiles(paths, opts) {
       uploadedFiles.push({
         name: file.name,
         type: file.type,
+        size: file.size,
         fileKey: r2Info.fileKey
       });
     } catch (err) {
@@ -5030,6 +5031,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 +5333,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`);
@@ -5808,14 +5810,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 +5940,7 @@ function statusLabel(status) {
 }
 
 // src/cli.js
-var VERSION = true ? "0.1.6" : "0.0.0";
+var VERSION = true ? "0.1.7" : "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.6",
+  "version": "0.1.7",
   "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",