@adsuploader/cli 0.1.8 → 0.2.0

package/README.md

@@ -37,6 +37,7 @@ This package includes a `SKILL.md` file that describes every command and option
 | `ads login` | Authenticate via browser |
 | `ads accounts` | List ad accounts |
 | `ads account <id>` | Set default account |
+| `ads pages` | List Facebook Pages available for profile overrides |
 | `ads campaigns` | List campaigns |
 | `ads campaign <id>` | Show ad sets in a campaign |
 | `ads adset <id>` | Show ads in an ad set |

package/SKILL.md

@@ -45,6 +45,14 @@ ads upload ./my-creatives/          # entire directory
 
 Returns a **batch ID** (e.g. `batch_abc123`) — you'll need this for the spec file. Files are uploaded directly to the selected ad account's Facebook media library, so the batch ID is tied to that account.
 
+Files are staged in parallel and transient network failures are retried automatically. Tune the defaults if needed:
+
+| Upload option | Description |
+|---------------|-------------|
+| `--concurrency <n>` | Parallel staging uploads, 1-6 (default: 4) |
+| `--upload-timeout <ms>` | Per-file R2 upload timeout (default: 120000) |
+| `--api-timeout <ms>` | API request timeout (default: 60000) |
+
 ### 2. Preview (dry run)
 
 ```bash
@@ -78,6 +86,7 @@ Ads are created **ACTIVE** by default. Use `--status PAUSED` to create them paus
 |---------|-------------|
 | `accounts` | List ad accounts |
 | `account <id>` | Set default account |
+| `pages` | List Facebook Pages available for `--page` / `profile.pageId` |
 | `campaigns` | List active campaigns (`--status all` for all, `--search <text>` to filter) |
 | `campaign <id>` | Show ad sets in a campaign |
 | `adsets --campaign <id>` | List ad sets (supports `--search`, `--status`) |
@@ -115,6 +124,9 @@ Ads are created **ACTIVE** by default. Use `--status PAUSED` to create them paus
 | `--pause-at <level>` | Pause level: `ad` (default), `adSet`, or `campaign` |
 | `--daily-budget <amount>` | Override daily budget (currency units) |
 | `--bid-amount <amount>` | Override bid/cost cap (currency units) |
+| `--page <id>` | Override the Facebook Page ID used by created ads |
+| `--instagram <id>` | Override the Instagram account ID used by created ads |
+| `--threads <id>` | Override the Threads profile ID used by created ads |
 | `--text-file <path>` | Load text config from a JSON file |
 | `--expanded` | Show full headline, primary text, and description values in previews |
 
@@ -165,6 +177,30 @@ When using `copyFromAd`, provide the upload batch and optionally campaign/ad set
 }
 ```
 
+### Profile Options
+
+By default, created ads inherit the Facebook Page, Instagram account, and Threads profile from the template ad or preset. Override them with `profile`:
+
+```json
+{
+  "copyFromAd": "120233848667930472",
+  "uploadId": "batch_abc123",
+  "profile": {
+    "pageId": "123456789012345",
+    "instagramId": "17841400000000000",
+    "threadsId": "987654321098765"
+  }
+}
+```
+
+You can also use flags:
+
+```bash
+ads create:preview spec.json --page 123456789012345 --instagram 17841400000000000 --threads 987654321098765
+```
+
+If you override only `pageId`, the CLI/API does not carry over the template ad's Instagram or Threads IDs, because they may belong to the old page. Add `instagramId` and `threadsId` explicitly when you want them attached. Run `ads pages` to list available Facebook Page IDs for `--page`; use the web app's Profile Options selector or Meta Business settings for Instagram/Threads IDs when needed. Multi-campaign per-campaign profile overrides are not supported in CLI specs yet.
+
 ### Campaign Structure
 
 **Single campaign** (default): ads go into the template ad's campaign, or a new campaign if `campaign.name` is provided.

package/dist/cli.cjs

@@ -3464,7 +3464,7 @@ var {
 } = import_index.default;
 
 // src/cli.js
-var import_picocolors13 = __toESM(require_picocolors(), 1);
+var import_picocolors14 = __toESM(require_picocolors(), 1);
 
 // src/lib/config.js
 var import_fs = __toESM(require("fs"), 1);
@@ -4131,10 +4131,51 @@ var import_crypto = __toESM(require("crypto"), 1);
 
 // src/lib/client.js
 var USER_AGENT = "adsuploader-cli/0.1.0";
+var DEFAULT_API_TIMEOUT_MS = 6e4;
+var DEFAULT_MAX_ATTEMPTS = 4;
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function parsePositiveInt(value, fallback) {
+  const parsed = Number.parseInt(value, 10);
+  return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;
+}
+function isRetryableNetworkError(err) {
+  const message = String(err?.message || "").toLowerCase();
+  return err?.name === "AbortError" || err?.code === "ECONNRESET" || err?.code === "ETIMEDOUT" || message.includes("fetch failed") || message.includes("network") || message.includes("timeout");
+}
+function isRetryableStatus(status) {
+  return status === 429 || status >= 500;
+}
+function shouldRetryResponse(method, status) {
+  if (status === 429) return true;
+  return method === "GET" && status >= 500;
+}
+function timeoutError(timeoutMs) {
+  return new Error(`API request timed out after ${Math.ceil(timeoutMs / 1e3)}s`);
+}
+function getRetryDelayMs(attempt, retryAfter, { baseDelayMs = 500, maxDelayMs = 8e3, jitterMs = 250 } = {}) {
+  if (retryAfter != null && Number.isFinite(retryAfter) && retryAfter > 0) {
+    return retryAfter * 1e3;
+  }
+  const exponential = Math.min(maxDelayMs, baseDelayMs * 2 ** Math.max(0, attempt - 1));
+  return exponential + Math.floor(Math.random() * jitterMs);
+}
+function formatApiError(resp, data) {
+  const message = data?.error || data?.message || `API error ${resp.status}`;
+  if (resp.status === 403 && /different IP address|created from a different IP|ads login/i.test(message)) {
+    return "Your network IP changed since this CLI token was created. Run `ads login` again to refresh your session.";
+  }
+  return message;
+}
 function createClient(opts = {}) {
   const token = opts.token || getToken();
   const baseUrl = opts.baseUrl || getBaseUrl();
   const accountId = opts.accountId || getDefaultAccount();
+  const fetchImpl = opts.fetchImpl || fetch;
+  const delay = opts.sleep || sleep;
+  const maxAttempts = opts.maxAttempts || DEFAULT_MAX_ATTEMPTS;
+  const timeoutMs = opts.timeoutMs || parsePositiveInt(process.env.ADS_API_TIMEOUT_MS, DEFAULT_API_TIMEOUT_MS);
   if (!token) {
     throw new Error("Not authenticated. Run `ads login` first.");
   }
@@ -4162,32 +4203,51 @@ function createClient(opts = {}) {
     if (body) {
       headers["Content-Type"] = "application/json";
     }
-    const resp = await fetch(url.toString(), {
-      method,
-      headers,
-      body: body ? JSON.stringify(body) : void 0,
-      redirect: "manual"
-      // Never follow redirects — prevents token leakage to redirect targets
-    });
-    if (resp.status >= 300 && resp.status < 400) {
-      throw new Error(`Unexpected redirect (${resp.status}). This may indicate a configuration issue.`);
-    }
-    if (resp.status === 429) {
-      const retryAfter = resp.headers.get("retry-after");
-      const err = new Error(`Rate limited. Retry after ${retryAfter || "60"}s`);
-      err.retryAfter = parseInt(retryAfter || "60");
-      throw err;
-    }
-    if (raw) return resp;
-    const data = await resp.json();
-    if (!resp.ok) {
-      const err = new Error(data.error || data.message || `API error ${resp.status}`);
-      err.code = data.errorCode;
-      err.status = resp.status;
-      err.details = data.details;
-      throw err;
+    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+      const controller = new AbortController();
+      const timeout = setTimeout(() => controller.abort(), timeoutMs);
+      try {
+        const resp = await fetchImpl(url.toString(), {
+          method,
+          headers,
+          body: body ? JSON.stringify(body) : void 0,
+          redirect: "manual",
+          // Never follow redirects — prevents token leakage to redirect targets
+          signal: controller.signal
+        });
+        clearTimeout(timeout);
+        if (resp.status >= 300 && resp.status < 400) {
+          throw new Error(`Unexpected redirect (${resp.status}). This may indicate a configuration issue.`);
+        }
+        if (shouldRetryResponse(method, resp.status) && attempt < maxAttempts) {
+          const retryAfter = resp.status === 429 ? parsePositiveInt(resp.headers.get("retry-after"), null) : null;
+          await delay(getRetryDelayMs(attempt, retryAfter));
+          continue;
+        }
+        if (raw) return resp;
+        const data = await resp.json();
+        if (!resp.ok) {
+          const err = new Error(formatApiError(resp, data));
+          err.code = data.errorCode;
+          err.status = resp.status;
+          err.details = data.details;
+          throw err;
+        }
+        return data;
+      } catch (err) {
+        clearTimeout(timeout);
+        if (err.status) {
+          throw err;
+        }
+        const normalizedError = err?.name === "AbortError" ? timeoutError(timeoutMs) : err;
+        if (method === "GET" && attempt < maxAttempts && isRetryableNetworkError(normalizedError)) {
+          await delay(getRetryDelayMs(attempt));
+          continue;
+        }
+        throw normalizedError;
+      }
     }
-    return data;
+    throw new Error(`API request failed after ${maxAttempts} attempt(s)`);
   }
   return {
     get: (path3, opts2) => request("GET", path3, { ...opts2, requiresAccount: opts2?.requiresAccount ?? true }),
@@ -4199,6 +4259,9 @@ function createClient(opts = {}) {
     campaigns: {
       list: (query) => request("GET", "/campaigns", { query })
     },
+    pages: {
+      list: (query) => request("GET", "/pages", { query })
+    },
     adsets: {
       list: (campaignId, query) => request("GET", `/campaigns/${campaignId}/adsets`, { query })
     },
@@ -4705,8 +4768,39 @@ function adsetCommand() {
   });
 }
 
-// src/commands/ad.js
+// src/commands/pages.js
 var import_picocolors7 = __toESM(require_picocolors(), 1);
+function formatInstagram(page) {
+  if (!page.instagramId && !page.instagramUsername) return "";
+  if (page.instagramUsername && page.instagramId) return `${page.instagramUsername} (${page.instagramId})`;
+  return page.instagramUsername || page.instagramId;
+}
+function pagesCommand() {
+  return new Command("pages").description("List Facebook Pages available for profile overrides").option("--account <id>", "Ad account ID").option("--json", "Output as JSON").action(async (opts) => {
+    const client = createClient({ accountId: opts.account });
+    const { pages } = await client.pages.list();
+    if (shouldOutputJson(opts)) {
+      printJson(pages);
+      return;
+    }
+    const rows = pages.map((page) => ({
+      ...page,
+      instagram: formatInstagram(page)
+    }));
+    console.log(`
+  ${import_picocolors7.default.bold("Pages")} (${pages.length})
+`);
+    printTable(rows, [
+      { key: "id", label: "ID", maxWidth: 25 },
+      { key: "name", label: "Name", maxWidth: 40 },
+      { key: "instagram", label: "Instagram", maxWidth: 36 }
+    ]);
+    console.log("");
+  });
+}
+
+// src/commands/ad.js
+var import_picocolors8 = __toESM(require_picocolors(), 1);
 function truncate(str, max = 120, expanded = false) {
   if (!str || expanded || str.length <= max) return str;
   return str.slice(0, max) + "...";
@@ -4720,17 +4814,17 @@ function adCommand() {
       return;
     }
     console.log(`
-  ${import_picocolors7.default.bold(ad.name)}
+  ${import_picocolors8.default.bold(ad.name)}
 `);
-    console.log(`  ${import_picocolors7.default.bold("ID:")}        ${ad.id}`);
-    console.log(`  ${import_picocolors7.default.bold("Status:")}    ${statusColor(ad.status)}`);
-    console.log(`  ${import_picocolors7.default.bold("Campaign:")}  ${ad.campaignId}`);
-    console.log(`  ${import_picocolors7.default.bold("Ad Set:")}    ${ad.adSetId}`);
+    console.log(`  ${import_picocolors8.default.bold("ID:")}        ${ad.id}`);
+    console.log(`  ${import_picocolors8.default.bold("Status:")}    ${statusColor(ad.status)}`);
+    console.log(`  ${import_picocolors8.default.bold("Campaign:")}  ${ad.campaignId}`);
+    console.log(`  ${import_picocolors8.default.bold("Ad Set:")}    ${ad.adSetId}`);
     if (ad.creative) {
-      const label = (name) => import_picocolors7.default.bold(name.padEnd(15));
+      const label = (name) => import_picocolors8.default.bold(name.padEnd(15));
       const exp = !!opts.expanded;
       console.log("");
-      console.log(`  ${import_picocolors7.default.bold("Creative")}`);
+      console.log(`  ${import_picocolors8.default.bold("Creative")}`);
       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)}`);
@@ -4744,13 +4838,13 @@ function adCommand() {
       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}
+  ${import_picocolors8.default.dim("Use this ad as a template:")} ads create --copy-from ${ad.id}
 `);
   });
 }
 
 // src/commands/presets.js
-var import_picocolors8 = __toESM(require_picocolors(), 1);
+var import_picocolors9 = __toESM(require_picocolors(), 1);
 function presetsCommand() {
   return new Command("presets").description("List saved ad template presets").option("--account <id>", "Ad account ID").option("--json", "Output as JSON").argument("[id]", "Preset ID to show details").action(async (id, opts) => {
     const client = createClient({ accountId: opts.account });
@@ -4761,12 +4855,12 @@ function presetsCommand() {
         return;
       }
       console.log(`
-  ${import_picocolors8.default.bold(preset.name)}
+  ${import_picocolors9.default.bold(preset.name)}
 `);
       if (preset.config) {
-        console.log(`  ${import_picocolors8.default.bold("Campaign:")}  ${preset.config.campaign?.name || import_picocolors8.default.dim("\u2014")} ${import_picocolors8.default.dim(preset.config.campaign?.id || "")}`);
-        console.log(`  ${import_picocolors8.default.bold("Ad Set:")}    ${preset.config.adSet?.name || import_picocolors8.default.dim("\u2014")} ${import_picocolors8.default.dim(preset.config.adSet?.id || "")}`);
-        console.log(`  ${import_picocolors8.default.bold("Ad:")}        ${preset.config.ad?.name || import_picocolors8.default.dim("\u2014")} ${import_picocolors8.default.dim(preset.config.ad?.id || "")}`);
+        console.log(`  ${import_picocolors9.default.bold("Campaign:")}  ${preset.config.campaign?.name || import_picocolors9.default.dim("\u2014")} ${import_picocolors9.default.dim(preset.config.campaign?.id || "")}`);
+        console.log(`  ${import_picocolors9.default.bold("Ad Set:")}    ${preset.config.adSet?.name || import_picocolors9.default.dim("\u2014")} ${import_picocolors9.default.dim(preset.config.adSet?.id || "")}`);
+        console.log(`  ${import_picocolors9.default.bold("Ad:")}        ${preset.config.ad?.name || import_picocolors9.default.dim("\u2014")} ${import_picocolors9.default.dim(preset.config.ad?.id || "")}`);
       }
       console.log("");
       return;
@@ -4778,15 +4872,15 @@ function presetsCommand() {
       return;
     }
     console.log(`
-  ${import_picocolors8.default.bold("Ad Template Presets")} (${all.length})
+  ${import_picocolors9.default.bold("Ad Template Presets")} (${all.length})
 `);
     if (all.length === 0) {
-      console.log(import_picocolors8.default.dim("  No presets. Create one in the web app by saving an ad configuration."));
+      console.log(import_picocolors9.default.dim("  No presets. Create one in the web app by saving an ad configuration."));
     } else {
       printTable(all, [
         { key: "id", label: "ID", maxWidth: 28 },
         { key: "name", label: "Name", maxWidth: 40 },
-        { key: "shared", label: "Shared", color: (v2) => v2 ? import_picocolors8.default.cyan("team") : import_picocolors8.default.dim("\u2014") }
+        { key: "shared", label: "Shared", color: (v2) => v2 ? import_picocolors9.default.cyan("team") : import_picocolors9.default.dim("\u2014") }
       ]);
     }
     console.log("");
@@ -4802,13 +4896,13 @@ function textPresetsCommand() {
         return;
       }
       console.log(`
-  ${import_picocolors8.default.bold(preset.name)}
+  ${import_picocolors9.default.bold(preset.name)}
 `);
-      console.log(`  ${import_picocolors8.default.bold("Includes:")}  ${preset.includedFields?.join(", ") || "all fields"}`);
+      console.log(`  ${import_picocolors9.default.bold("Includes:")}  ${preset.includedFields?.join(", ") || "all fields"}`);
       if (preset.text) {
-        if (preset.text.titles?.length) console.log(`  ${import_picocolors8.default.bold("Headlines:")} ${preset.text.titles.join(" | ")}`);
-        if (preset.text.bodies?.length) console.log(`  ${import_picocolors8.default.bold("Bodies:")}    ${preset.text.bodies.join(" | ")}`);
-        if (preset.text.descriptions?.length) console.log(`  ${import_picocolors8.default.bold("Desc:")}      ${preset.text.descriptions.join(" | ")}`);
+        if (preset.text.titles?.length) console.log(`  ${import_picocolors9.default.bold("Headlines:")} ${preset.text.titles.join(" | ")}`);
+        if (preset.text.bodies?.length) console.log(`  ${import_picocolors9.default.bold("Bodies:")}    ${preset.text.bodies.join(" | ")}`);
+        if (preset.text.descriptions?.length) console.log(`  ${import_picocolors9.default.bold("Desc:")}      ${preset.text.descriptions.join(" | ")}`);
       }
       console.log("");
       return;
@@ -4820,16 +4914,16 @@ function textPresetsCommand() {
       return;
     }
     console.log(`
-  ${import_picocolors8.default.bold("Text Presets")} (${all.length})
+  ${import_picocolors9.default.bold("Text Presets")} (${all.length})
 `);
     if (all.length === 0) {
-      console.log(import_picocolors8.default.dim("  No text presets. Create one in the web app."));
+      console.log(import_picocolors9.default.dim("  No text presets. Create one in the web app."));
     } else {
       printTable(all, [
         { key: "id", label: "ID", maxWidth: 28 },
         { key: "name", label: "Name", maxWidth: 30 },
-        { key: "scope", label: "Scope", color: (v2) => v2 === "global" ? import_picocolors8.default.cyan("global") : import_picocolors8.default.dim("account") },
-        { key: "shared", label: "Shared", color: (v2) => v2 ? import_picocolors8.default.cyan("team") : import_picocolors8.default.dim("\u2014") }
+        { key: "scope", label: "Scope", color: (v2) => v2 === "global" ? import_picocolors9.default.cyan("global") : import_picocolors9.default.dim("account") },
+        { key: "shared", label: "Shared", color: (v2) => v2 ? import_picocolors9.default.cyan("team") : import_picocolors9.default.dim("\u2014") }
       ]);
     }
     console.log("");
@@ -4867,11 +4961,11 @@ function presetsSaveCommand() {
         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_picocolors9.default.bold("ID:")}     ${preset.id}`);
+      console.log(`  ${import_picocolors9.default.bold("Type:")}   ${preset.type}`);
+      if (preset.shared) console.log(`  ${import_picocolors9.default.bold("Shared:")} ${import_picocolors9.default.cyan("team")}`);
       console.log(`
-  ${import_picocolors8.default.dim("Use it:")} ads create --preset ${preset.id} ...
+  ${import_picocolors9.default.dim("Use it:")} ads create --preset ${preset.id} ...
 `);
     } catch (err) {
       printError(err.message || "Failed to save preset");
@@ -4883,10 +4977,15 @@ function presetsSaveCommand() {
 // src/commands/upload.js
 var import_fs2 = __toESM(require("fs"), 1);
 var import_path2 = __toESM(require("path"), 1);
-var import_picocolors9 = __toESM(require_picocolors(), 1);
+var import_picocolors10 = __toESM(require_picocolors(), 1);
 var IMAGE_EXTS = /* @__PURE__ */ new Set([".jpg", ".jpeg", ".png", ".gif", ".bmp", ".webp"]);
 var VIDEO_EXTS = /* @__PURE__ */ new Set([".mp4", ".mov", ".avi", ".mkv", ".webm", ".m4v"]);
 var MAX_FILE_SIZE = 4 * 1024 * 1024 * 1024;
+var DEFAULT_UPLOAD_CONCURRENCY = 4;
+var MAX_UPLOAD_CONCURRENCY = 6;
+var DEFAULT_UPLOAD_TIMEOUT_MS = 12e4;
+var DEFAULT_R2_MAX_ATTEMPTS = 4;
+var DEFAULT_MAX_IN_FLIGHT_BYTES = 512 * 1024 * 1024;
 var MAGIC_BYTES = {
   "image/jpeg": [[255, 216, 255]],
   "image/png": [[137, 80, 78, 71]],
@@ -4950,6 +5049,75 @@ var CONTENT_TYPES = {
   ".webm": "video/webm",
   ".m4v": "video/x-m4v"
 };
+function parsePositiveInt2(value, fallback) {
+  const parsed = Number.parseInt(value, 10);
+  return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;
+}
+function normalizeConcurrency(value) {
+  return Math.min(MAX_UPLOAD_CONCURRENCY, parsePositiveInt2(value, DEFAULT_UPLOAD_CONCURRENCY));
+}
+function calculateUploadConcurrency(files, requestedConcurrency, maxInFlightBytes = DEFAULT_MAX_IN_FLIGHT_BYTES) {
+  const requested = normalizeConcurrency(requestedConcurrency);
+  const largestFileSize = Math.max(0, ...files.map((file) => Number(file.size) || 0));
+  if (largestFileSize <= 0) return requested;
+  const memoryLimited = Math.max(1, Math.floor(maxInFlightBytes / largestFileSize));
+  return Math.min(requested, memoryLimited);
+}
+function sleep2(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function runBoundedConcurrency(items, concurrency, worker) {
+  const limit = Math.max(1, Math.min(items.length || 1, concurrency));
+  const results = new Array(items.length);
+  let nextIndex = 0;
+  async function runNext() {
+    while (nextIndex < items.length) {
+      const index = nextIndex++;
+      results[index] = await worker(items[index], index);
+    }
+  }
+  await Promise.all(Array.from({ length: limit }, runNext));
+  return results;
+}
+async function putR2WithRetry(uploadUrl, fileBuffer, contentType, {
+  fetchImpl = fetch,
+  timeoutMs = DEFAULT_UPLOAD_TIMEOUT_MS,
+  maxAttempts = DEFAULT_R2_MAX_ATTEMPTS,
+  delay = sleep2
+} = {}) {
+  for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+      const resp = await fetchImpl(uploadUrl, {
+        method: "PUT",
+        headers: {
+          "Content-Type": contentType,
+          "Content-Length": String(fileBuffer.length)
+        },
+        body: fileBuffer,
+        signal: controller.signal
+      });
+      clearTimeout(timeout);
+      if (resp.ok) return resp;
+      if (isRetryableStatus(resp.status) && attempt < maxAttempts) {
+        const retryAfter = resp.status === 429 ? parsePositiveInt2(resp.headers.get("retry-after"), null) : null;
+        await delay(getRetryDelayMs(attempt, retryAfter));
+        continue;
+      }
+      throw new Error(`R2 upload failed: ${resp.status}`);
+    } catch (err) {
+      clearTimeout(timeout);
+      const normalizedError = err?.name === "AbortError" ? new Error(`R2 upload timed out after ${Math.ceil(timeoutMs / 1e3)}s`) : err;
+      if (attempt < maxAttempts && isRetryableNetworkError(normalizedError)) {
+        await delay(getRetryDelayMs(attempt));
+        continue;
+      }
+      throw normalizedError;
+    }
+  }
+  throw new Error(`R2 upload failed after ${maxAttempts} attempt(s)`);
+}
 function getFileType(filePath) {
   const ext = import_path2.default.extname(filePath).toLowerCase();
   if (IMAGE_EXTS.has(ext)) return "image";
@@ -4994,13 +5162,17 @@ function resolveFiles(inputs) {
     }
   }
   if (skipped.length > 0) {
-    console.error(import_picocolors9.default.yellow(`  Skipped ${skipped.length} file(s): ${skipped.join(", ")}`));
+    console.error(import_picocolors10.default.yellow(`  Skipped ${skipped.length} file(s): ${skipped.join(", ")}`));
   }
   return files;
 }
 async function stageFiles(paths, opts) {
-  const client = createClient({ accountId: opts.account });
+  const client = createClient({
+    accountId: opts.account,
+    timeoutMs: parsePositiveInt2(opts.apiTimeout, void 0)
+  });
   const jsonMode = shouldOutputJson(opts);
+  const uploadTimeoutMs = parsePositiveInt2(opts.uploadTimeout, DEFAULT_UPLOAD_TIMEOUT_MS);
   let files;
   try {
     files = resolveFiles(paths);
@@ -5014,7 +5186,7 @@ async function stageFiles(paths, opts) {
   }
   if (!jsonMode) {
     console.log(`
-  ${import_picocolors9.default.bold("Uploading")} ${files.length} file(s)
+  ${import_picocolors10.default.bold("Uploading")} ${files.length} file(s)
 `);
   }
   const filesMeta = files.map((f) => ({
@@ -5025,39 +5197,33 @@ async function stageFiles(paths, opts) {
   }));
   const initResult = await client.uploads.init(filesMeta);
   const { batchId } = initResult;
-  const uploadedFiles = [];
-  for (let i = 0; i < files.length; i++) {
-    const file = files[i];
+  const concurrency = calculateUploadConcurrency(files, opts.concurrency);
+  const uploadedFiles = await runBoundedConcurrency(files, concurrency, async (file, i) => {
     const r2Info = initResult.files[i];
     if (!jsonMode) {
-      console.log(`  ${import_picocolors9.default.dim("\u2192")}  ${import_picocolors9.default.dim(`Uploading ${file.name}...  ${formatSize(file.size)}`)}`);
+      console.log(`  ${import_picocolors10.default.dim("\u2192")}  ${import_picocolors10.default.dim(`Uploading ${file.name}...  ${formatSize(file.size)}`)}`);
     }
     try {
       const fileBuffer = import_fs2.default.readFileSync(file.path);
-      const resp = await fetch(r2Info.uploadUrl, {
-        method: "PUT",
-        headers: {
-          "Content-Type": file.contentType || (file.type === "video" ? "video/mp4" : "image/jpeg"),
-          "Content-Length": String(fileBuffer.length)
-        },
-        body: fileBuffer
-      });
-      if (!resp.ok) {
-        throw new Error(`R2 upload failed: ${resp.status}`);
-      }
-      uploadedFiles.push({
+      await putR2WithRetry(
+        r2Info.uploadUrl,
+        fileBuffer,
+        file.contentType || (file.type === "video" ? "video/mp4" : "image/jpeg"),
+        { timeoutMs: uploadTimeoutMs }
+      );
+      return {
         name: file.name,
         type: file.type,
         size: file.size,
         fileKey: r2Info.fileKey
-      });
+      };
     } catch (err) {
       if (!jsonMode) {
-        console.log(`  ${import_picocolors9.default.red("\u2717")}  ${file.name}: ${err.message}`);
+        console.log(`  ${import_picocolors10.default.red("\u2717")}  ${file.name}: ${err.message}`);
       }
-      uploadedFiles.push({ name: file.name, type: file.type, fileKey: null, error: err.message });
+      return { name: file.name, type: file.type, fileKey: null, error: err.message };
     }
-  }
+  });
   return { client, batchId, uploadedFiles, jsonMode };
 }
 async function processAndPrint(client, batchId, uploadedFiles, jsonMode) {
@@ -5067,7 +5233,7 @@ async function processAndPrint(client, batchId, uploadedFiles, jsonMode) {
     process.exit(1);
   }
   if (!jsonMode) {
-    console.log(`  ${import_picocolors9.default.dim("\u2192")}  ${import_picocolors9.default.dim("Finalizing uploads to Facebook...")}`);
+    console.log(`  ${import_picocolors10.default.dim("\u2192")}  ${import_picocolors10.default.dim("Finalizing uploads to Facebook...")}`);
   }
   const results = [];
   let completed = 0;
@@ -5085,19 +5251,19 @@ async function processAndPrint(client, batchId, uploadedFiles, jsonMode) {
         completed++;
         if (!jsonMode) {
           const id = result.videoId || result.mediaHash || "";
-          console.log(`  ${import_picocolors9.default.green("\u2713")}  ${file.name} uploaded successfully  ${import_picocolors9.default.dim(id)}`);
+          console.log(`  ${import_picocolors10.default.green("\u2713")}  ${file.name} uploaded successfully  ${import_picocolors10.default.dim(id)}`);
         }
       } else {
         failed++;
         if (!jsonMode) {
-          console.log(`  ${import_picocolors9.default.red("\u2717")}  ${file.name}: ${result.error}`);
+          console.log(`  ${import_picocolors10.default.red("\u2717")}  ${file.name}: ${result.error}`);
         }
       }
     } catch (err) {
       failed++;
       results.push({ name: file.name, type: file.type, status: "error", error: err.message });
       if (!jsonMode) {
-        console.log(`  ${import_picocolors9.default.red("\u2717")}  ${file.name}: ${err.message}`);
+        console.log(`  ${import_picocolors10.default.red("\u2717")}  ${file.name}: ${err.message}`);
       }
     }
   }
@@ -5115,30 +5281,30 @@ async function processAndPrint(client, batchId, uploadedFiles, jsonMode) {
   }
   if (groups.length > 0) {
     console.log(`
-  ${import_picocolors9.default.bold("Variant Groups")} (${groups.length})
+  ${import_picocolors10.default.bold("Variant Groups")} (${groups.length})
 `);
     for (const group of groups) {
       const assets = group.assets.map((a) => {
-        const placement = a.placementType === "default" ? "" : import_picocolors9.default.cyan(` [${a.placementType}]`);
+        const placement = a.placementType === "default" ? "" : import_picocolors10.default.cyan(` [${a.placementType}]`);
         return `${a.name}${placement}`;
       });
-      console.log(`  ${import_picocolors9.default.bold(group.baseName || group.groupId)}`);
+      console.log(`  ${import_picocolors10.default.bold(group.baseName || group.groupId)}`);
       for (const asset of assets) {
         console.log(`    ${asset}`);
       }
     }
   }
   console.log(`
-  ${import_picocolors9.default.bold("Batch:")} ${batchId}`);
+  ${import_picocolors10.default.bold("Batch:")} ${batchId}`);
   const countStr = `${completed} complete, ${failed} failed`;
   console.log(`  ${countStr}`);
   if (groups.length > 0) {
-    console.log(`  ${import_picocolors9.default.bold("Groups:")} ${groups.length} variant group(s) detected`);
+    console.log(`  ${import_picocolors10.default.bold("Groups:")} ${groups.length} variant group(s) detected`);
   }
   console.log("");
 }
 function uploadCommand() {
-  return new Command("upload").description("Upload media files and process to Meta").argument("<paths...>", "Files or directories to upload").option("--account <id>", "Ad account ID").option("--json", "Output as JSON").action(async (paths, opts) => {
+  return new Command("upload").description("Upload media files and process to Meta").argument("<paths...>", "Files or directories to upload").option("--account <id>", "Ad account ID").option("--json", "Output as JSON").option("--concurrency <n>", "Concurrent R2 staging uploads (1-6)", String(DEFAULT_UPLOAD_CONCURRENCY)).option("--upload-timeout <ms>", "R2 PUT timeout in milliseconds", String(DEFAULT_UPLOAD_TIMEOUT_MS)).option("--api-timeout <ms>", "API request timeout in milliseconds").action(async (paths, opts) => {
     const { client, batchId, uploadedFiles, jsonMode } = await stageFiles(paths, opts);
     await processAndPrint(client, batchId, uploadedFiles, jsonMode);
   });
@@ -5155,10 +5321,10 @@ function uploadsCommand() {
       }
       const accountLabel = batch.accountName ? `${batch.accountName} (${batch.accountId})` : batch.accountId;
       console.log(`
-  ${import_picocolors9.default.bold("Batch")} ${batch.batchId}
+  ${import_picocolors10.default.bold("Batch")} ${batch.batchId}
 `);
-      console.log(`  ${import_picocolors9.default.bold("Account:")} ${accountLabel}`);
-      console.log(`  ${import_picocolors9.default.bold("Files:")}   ${batch.total}
+      console.log(`  ${import_picocolors10.default.bold("Account:")} ${accountLabel}`);
+      console.log(`  ${import_picocolors10.default.bold("Files:")}   ${batch.total}
 `);
       const rows = batch.files.map((f) => ({
         ...f,
@@ -5167,19 +5333,19 @@ function uploadsCommand() {
       printTable(rows, [
         { key: "name", label: "Name", maxWidth: 35 },
         { key: "type", label: "Type", maxWidth: 6 },
-        { key: "id", label: "Hash / Video ID", maxWidth: 35, color: (v2) => v2 || import_picocolors9.default.dim("\u2014") }
+        { key: "id", label: "Hash / Video ID", maxWidth: 35, color: (v2) => v2 || import_picocolors10.default.dim("\u2014") }
       ]);
       if (batch.groups?.length > 0) {
         console.log(`
-  ${import_picocolors9.default.bold("Variant Groups")} (${batch.groups.length})
+  ${import_picocolors10.default.bold("Variant Groups")} (${batch.groups.length})
 `);
         for (const group of batch.groups) {
           const primaryAsset = group.assets.find((a) => a.isPrimary);
           const groupLabel = group.baseName || primaryAsset?.name || group.groupId;
-          console.log(`  ${import_picocolors9.default.bold(groupLabel)}`);
+          console.log(`  ${import_picocolors10.default.bold(groupLabel)}`);
           for (const asset of group.assets) {
-            const placement = asset.placementType === "default" ? "" : import_picocolors9.default.cyan(` [${asset.placementType}]`);
-            const primary = asset.isPrimary ? import_picocolors9.default.dim(" (primary)") : "";
+            const placement = asset.placementType === "default" ? "" : import_picocolors10.default.cyan(` [${asset.placementType}]`);
+            const primary = asset.isPrimary ? import_picocolors10.default.dim(" (primary)") : "";
             console.log(`    ${asset.name}${placement}${primary}`);
           }
         }
@@ -5193,10 +5359,10 @@ function uploadsCommand() {
       return;
     }
     console.log(`
-  ${import_picocolors9.default.bold("Recent Uploads")} (${batches.length})
+  ${import_picocolors10.default.bold("Recent Uploads")} (${batches.length})
 `);
     if (batches.length === 0) {
-      console.log(import_picocolors9.default.dim("  No uploads found for this account.\n"));
+      console.log(import_picocolors10.default.dim("  No uploads found for this account.\n"));
       return;
     }
     const formatDate = (d3) => {
@@ -5225,10 +5391,10 @@ function uploadsCommand() {
 
 // src/commands/create.js
 var import_fs3 = __toESM(require("fs"), 1);
-var import_picocolors11 = __toESM(require_picocolors(), 1);
+var import_picocolors12 = __toESM(require_picocolors(), 1);
 
 // src/lib/poll.js
-var import_picocolors10 = __toESM(require_picocolors(), 1);
+var import_picocolors11 = __toESM(require_picocolors(), 1);
 var POLL_INTERVAL = 500;
 var TIMEOUT_MS = 30 * 60 * 1e3;
 var TIMEOUT_MINUTES = TIMEOUT_MS / 6e4;
@@ -5240,7 +5406,7 @@ async function pollJob(client, jobId, opts = {}) {
   if (!jsonMode) {
     if (tty) {
       console.log(`
-  ${import_picocolors10.default.bold("Creating ads")}
+  ${import_picocolors11.default.bold("Creating ads")}
 `);
     } else {
       console.log(`[start] Creating ads \u2014 ${jobId}`);
@@ -5266,7 +5432,7 @@ async function pollJob(client, jobId, opts = {}) {
         process.exitCode = 2;
         return { status: "still_running", jobId };
       }
-      await sleep(POLL_INTERVAL);
+      await sleep3(POLL_INTERVAL);
       continue;
     }
     const ops = data.progress?.operations || [];
@@ -5277,7 +5443,7 @@ async function pollJob(client, jobId, opts = {}) {
         const time = formatTimestamp(op.timestamp);
         const { icon, color } = opStyle(op.type);
         if (tty) {
-          console.log(`  ${import_picocolors10.default.dim(time)}  ${color(icon)}  ${color(op.message)}`);
+          console.log(`  ${import_picocolors11.default.dim(time)}  ${color(icon)}  ${color(op.message)}`);
         } else {
           const tag = op.type === "error" ? "[err]" : op.type === "retry" ? "[..]" : op.type === "completion" || (op.type || "").endsWith("_complete") ? "[ok ]" : "[..]";
           console.log(`${time}  ${tag} ${op.message}`);
@@ -5298,7 +5464,7 @@ async function pollJob(client, jobId, opts = {}) {
         const failed = data.result?.created?.failedAds?.length || 0;
         console.log("");
         if (failed > 0 && adCount > 0) {
-          console.log(`  ${import_picocolors10.default.yellow("\u2212")} ${adCount} ads created, ${failed} failed in ${elapsed}`);
+          console.log(`  ${import_picocolors11.default.yellow("\u2212")} ${adCount} ads created, ${failed} failed in ${elapsed}`);
         } else if (adCount > 0) {
           printSuccess(`Created ${adCount} ads in ${elapsed}`);
         } else {
@@ -5313,14 +5479,14 @@ async function pollJob(client, jobId, opts = {}) {
         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(`  ${import_picocolors11.default.yellow("\u2212")}  ${import_picocolors11.default.yellow(`Still running after ${TIMEOUT_MINUTES} min \u2014 job continues on the server.`)}`);
+        console.log(`     Resume with: ${import_picocolors11.default.bold(`ads jobs ${jobId} --follow`)}`);
         console.log("");
       }
       process.exitCode = 2;
       return { status: "still_running", jobId };
     }
-    await sleep(POLL_INTERVAL);
+    await sleep3(POLL_INTERVAL);
   }
 }
 function opStyle(type) {
@@ -5328,13 +5494,13 @@ function opStyle(type) {
     case "completion":
     case "campaign_complete":
     case "adset_complete":
-      return { icon: "\u2713", color: import_picocolors10.default.green };
+      return { icon: "\u2713", color: import_picocolors11.default.green };
     case "error":
-      return { icon: "\u2717", color: import_picocolors10.default.red };
+      return { icon: "\u2717", color: import_picocolors11.default.red };
     case "retry":
-      return { icon: "\u2212", color: import_picocolors10.default.yellow };
+      return { icon: "\u2212", color: import_picocolors11.default.yellow };
     default:
-      return { icon: "\u2192", color: import_picocolors10.default.dim };
+      return { icon: "\u2192", color: import_picocolors11.default.dim };
   }
 }
 function formatTimestamp(iso) {
@@ -5346,7 +5512,7 @@ function formatTimestamp(iso) {
     return "        ";
   }
 }
-function sleep(ms) {
+function sleep3(ms) {
   return new Promise((r) => setTimeout(r, ms));
 }
 
@@ -5370,29 +5536,29 @@ async function executeCreate(body, opts, { preview = false, test = false } = {})
       const ts = result.totalAdSets || 1;
       const ta = result.totalAds || result.ads?.length || 0;
       const parts = [];
-      if (tc > 1) parts.push(`${import_picocolors11.default.blue(tc)} campaigns`);
-      parts.push(`${import_picocolors11.default.blue(ts)} ad set${ts !== 1 ? "s" : ""}`);
-      parts.push(`${import_picocolors11.default.blue(ta)} ad${ta !== 1 ? "s" : ""}`);
+      if (tc > 1) parts.push(`${import_picocolors12.default.blue(tc)} campaigns`);
+      parts.push(`${import_picocolors12.default.blue(ts)} ad set${ts !== 1 ? "s" : ""}`);
+      parts.push(`${import_picocolors12.default.blue(ta)} ad${ta !== 1 ? "s" : ""}`);
       let statusStr = statusColor(result.status || "PAUSED");
       if (result.status === "PAUSED" && result.pauseAt && result.pauseAt !== "ad") {
         const levelLabel = result.pauseAt === "campaign" ? "campaign level" : "ad set level";
-        statusStr += import_picocolors11.default.dim(` (${levelLabel})`);
+        statusStr += import_picocolors12.default.dim(` (${levelLabel})`);
       }
       let enhLabel = "";
-      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`);
-      const enhPart = enhLabel ? ` ${import_picocolors11.default.dim("\xB7")} ${enhLabel}` : "";
-      console.log(`  ${parts.join(", ")} ${import_picocolors11.default.dim("\xB7")} ${statusStr}${enhPart}
+      if (result.enhancements === "metaDefaults") enhLabel = import_picocolors12.default.dim("All Off");
+      else if (result.enhancements === "all") enhLabel = import_picocolors12.default.dim("All On");
+      else if (result.enhancements === "none") enhLabel = import_picocolors12.default.dim("All Off");
+      else if (Array.isArray(result.enhancements)) enhLabel = import_picocolors12.default.dim(`${result.enhancements.length} custom`);
+      const enhPart = enhLabel ? ` ${import_picocolors12.default.dim("\xB7")} ${enhLabel}` : "";
+      console.log(`  ${parts.join(", ")} ${import_picocolors12.default.dim("\xB7")} ${statusStr}${enhPart}
 `);
       if (result.ads?.length) {
         const tableRows = [];
         let lastCampaign = null;
         let lastAdSet = null;
         for (const ad of result.ads) {
-          const campaignName = ad.campaignName || import_picocolors11.default.dim("\u2014");
-          const adSetName = ad.adSetName || import_picocolors11.default.dim("\u2014");
+          const campaignName = ad.campaignName || import_picocolors12.default.dim("\u2014");
+          const adSetName = ad.adSetName || import_picocolors12.default.dim("\u2014");
           tableRows.push({
             campaign: campaignName === lastCampaign ? "" : campaignName,
             adSet: campaignName === lastCampaign && adSetName === lastAdSet ? "" : adSetName,
@@ -5440,54 +5606,54 @@ async function executeCreate(body, opts, { preview = false, test = false } = {})
         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)}`);
+            console.log(`  ${import_picocolors12.default.dim("\u25B8 Ad Set:")} ${import_picocolors12.default.bold(ad.adSetName)}`);
             lastDetailAdSet = ad.adSetName;
           }
-          const typeLabel = ad.mediaType ? import_picocolors11.default.dim(` [${ad.mediaType}]`) : "";
+          const typeLabel = ad.mediaType ? import_picocolors12.default.dim(` [${ad.mediaType}]`) : "";
           const indent = showAdSetHeaders ? "    " : "  ";
           const fieldIndent = showAdSetHeaders ? "      " : "    ";
           const fieldIndentLen = fieldIndent.length;
-          console.log(`${indent}${import_picocolors11.default.bold(import_picocolors11.default.blue(ad.name))}${typeLabel}`);
+          console.log(`${indent}${import_picocolors12.default.bold(import_picocolors12.default.blue(ad.name))}${typeLabel}`);
           const headline = (ad.headline || []).join(" | ");
           const primary = (ad.primaryText || []).join(" | ");
           const desc = (ad.description || []).join(" | ");
-          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)}`);
+          if (headline) console.log(`${fieldIndent}${import_picocolors12.default.dim("Headline:")}      ${trunc(headline)}`);
+          if (primary) console.log(`${fieldIndent}${import_picocolors12.default.dim("Primary Text:")}  ${trunc(primary)}`);
+          if (desc) console.log(`${fieldIndent}${import_picocolors12.default.dim("Description:")}   ${trunc(desc)}`);
+          if (ad.cta && !sharedCta) console.log(`${fieldIndent}${import_picocolors12.default.dim("CTA:")}           ${ad.cta}`);
+          if (ad.link && !sharedLink) console.log(`${fieldIndent}${import_picocolors12.default.dim("Link:")}          ${wrapLine(ad.link, fieldIndentLen)}`);
+          if (ad.urlTags && !sharedUrlTags) console.log(`${fieldIndent}${import_picocolors12.default.dim("URL Tags:")}     ${wrapLine(ad.urlTags, fieldIndentLen)}`);
           console.log("");
         }
         const valCol = 18;
-        if (sharedCta) console.log(`  ${import_picocolors11.default.bold("CTA:")}            ${sharedCta}`);
-        if (sharedLink) console.log(`  ${import_picocolors11.default.bold("Link:")}           ${wrapLine(sharedLink, valCol)}`);
-        if (sharedUrlTags) console.log(`  ${import_picocolors11.default.bold("URL Tags:")}       ${wrapLine(sharedUrlTags, valCol)}`);
+        if (sharedCta) console.log(`  ${import_picocolors12.default.bold("CTA:")}            ${sharedCta}`);
+        if (sharedLink) console.log(`  ${import_picocolors12.default.bold("Link:")}           ${wrapLine(sharedLink, valCol)}`);
+        if (sharedUrlTags) console.log(`  ${import_picocolors12.default.bold("URL Tags:")}       ${wrapLine(sharedUrlTags, valCol)}`);
         const enh = result.enhancements;
         let enhDetail;
         if (enh === "metaDefaults") enhDetail = "Meta Defaults";
         else if (enh === "all") enhDetail = "All On";
         else if (enh === "none") enhDetail = "All Off";
         else if (Array.isArray(enh)) enhDetail = enh.join(", ");
-        if (enhDetail) console.log(`  ${import_picocolors11.default.bold("Enhancements:")}   ${wrapLine(enhDetail, valCol)}`);
+        if (enhDetail) console.log(`  ${import_picocolors12.default.bold("Enhancements:")}   ${wrapLine(enhDetail, valCol)}`);
         if (result.budget) {
           const curr = result.budget.currency ? ` ${result.budget.currency}` : "";
           const renderLine = (label, amount) => {
             const pad = " ".repeat(Math.max(1, 16 - label.length - 1));
-            console.log(`  ${import_picocolors11.default.bold(`${label}:`)}${pad}${amount}${curr}`);
+            console.log(`  ${import_picocolors12.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) {
-        console.log(`  ${import_picocolors11.default.bold("Plan:")}`);
+        console.log(`  ${import_picocolors12.default.bold("Plan:")}`);
         console.log(`    Campaigns: ${result.plan.totals.campaigns}`);
         console.log(`    Ad Sets:   ${result.plan.totals.adSets}`);
         console.log(`    Ads:       ${result.plan.totals.ads}`);
       }
       console.log(`
-  ${import_picocolors11.default.dim("This is a preview. No ads were created.")}
+  ${import_picocolors12.default.dim("This is a preview. No ads were created.")}
 `);
       return;
     }
@@ -5508,13 +5674,13 @@ async function executeCreate(body, opts, { preview = false, test = false } = {})
     printSuccess(`${result.status || "Complete"}`);
     if (result.result?.created?.ads?.length) {
       console.log(`
-  ${import_picocolors11.default.bold("Created:")} ${result.result.created.ads.length} ad(s)`);
+  ${import_picocolors12.default.bold("Created:")} ${result.result.created.ads.length} ad(s)`);
     }
     console.log("");
   } catch (err) {
     printError(err.message);
     if (err.details) {
-      console.error(import_picocolors11.default.dim(`  Details: ${JSON.stringify(err.details)}`));
+      console.error(import_picocolors12.default.dim(`  Details: ${JSON.stringify(err.details)}`));
     }
     process.exit(1);
   }
@@ -5575,6 +5741,14 @@ function buildBodyFromOpts(specFile, opts) {
     body.adSet = body.adSet || {};
     body.adSet.bidAmount = bid;
   }
+  if (opts.page || opts.instagram || opts.threads) {
+    body.profile = {
+      ...body.profile || {},
+      ...opts.page ? { pageId: opts.page } : {},
+      ...opts.instagram ? { instagramId: opts.instagram } : {},
+      ...opts.threads ? { threadsId: opts.threads } : {}
+    };
+  }
   if (opts.pauseAt) {
     if (!["ad", "adSet", "campaign"].includes(opts.pauseAt)) {
       printError('--pause-at must be "ad", "adSet", or "campaign"');
@@ -5585,7 +5759,7 @@ 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("--expanded", "Show full headline / primary text / description without truncation").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("--page <id>", "Override Facebook Page ID for created ads").option("--instagram <id>", "Override Instagram account ID for created ads").option("--threads <id>", "Override Threads profile ID for created ads").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);
@@ -5627,7 +5801,7 @@ async function interactiveCreate(client) {
     printError("Interactive mode requires a TTY. Use a spec file or flags instead.");
     process.exit(1);
   }
-  Ie(import_picocolors11.default.bold("Ads Uploader \u2014 Create Ads"));
+  Ie(import_picocolors12.default.bold("Ads Uploader \u2014 Create Ads"));
   if (!client.accountId) {
     const { accounts } = await client.accounts.list();
     const accountChoice = await ve({
@@ -5764,7 +5938,7 @@ async function interactiveCreate(client) {
     });
     if (pD(namePattern)) process.exit(0);
     body.adNamePattern = namePattern;
-    M2.info(import_picocolors11.default.dim("Variables: {filename}, {index:01}, {variation}, {campaign}, {date}, {timestamp}"));
+    M2.info(import_picocolors12.default.dim("Variables: {filename}, {index:01}, {variation}, {campaign}, {date}, {timestamp}"));
   }
   const textMethod = await ve({
     message: "Ad text",
@@ -5796,7 +5970,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."));
+    M2.info(import_picocolors12.default.dim("Enter headlines (one per line). Leave blank and press enter to finish."));
     const headlines = [];
     for (; ; ) {
       const h2 = await he({
@@ -5807,7 +5981,7 @@ async function interactiveCreate(client) {
       if (!h2) break;
       headlines.push(h2);
     }
-    M2.info(import_picocolors11.default.dim("Enter primary text (one per line). Leave blank to finish."));
+    M2.info(import_picocolors12.default.dim("Enter primary text (one per line). Leave blank to finish."));
     const bodies = [];
     for (; ; ) {
       const b4 = await he({
@@ -5916,7 +6090,7 @@ async function interactiveCreate(client) {
     }
   }
   console.log("");
-  M2.info(import_picocolors11.default.bold("Summary"));
+  M2.info(import_picocolors12.default.bold("Summary"));
   if (body.adPresetId) M2.info(`  Preset: ${body.adPresetId}`);
   if (body.copyFromAd) M2.info(`  Copy from: ${body.copyFromAd}`);
   M2.info(`  Upload: ${body.uploadId}`);
@@ -5938,13 +6112,13 @@ async function interactiveCreate(client) {
 }
 
 // src/commands/jobs.js
-var import_picocolors12 = __toESM(require_picocolors(), 1);
+var import_picocolors13 = __toESM(require_picocolors(), 1);
 function jobsCommand() {
   const cmd = new Command("jobs").description("Manage ad creation jobs").option("--json", "Output as JSON").option("--follow", "Follow job progress in real-time").argument("[jobId]", "Job ID to check status").action(async (jobId, opts) => {
     if (!jobId) {
-      console.log(import_picocolors12.default.dim("  Usage: ads jobs <jobId>"));
-      console.log(import_picocolors12.default.dim("         ads jobs <jobId> --follow"));
-      console.log(import_picocolors12.default.dim("         ads jobs cancel <jobId>"));
+      console.log(import_picocolors13.default.dim("  Usage: ads jobs <jobId>"));
+      console.log(import_picocolors13.default.dim("         ads jobs <jobId> --follow"));
+      console.log(import_picocolors13.default.dim("         ads jobs cancel <jobId>"));
       return;
     }
     const client = createClient({});
@@ -5958,16 +6132,16 @@ function jobsCommand() {
       return;
     }
     console.log(`
-  ${import_picocolors12.default.bold("Job")} ${jobId}
+  ${import_picocolors13.default.bold("Job")} ${jobId}
 `);
-    console.log(`  ${import_picocolors12.default.bold("Status:")}    ${statusLabel(result.status)}`);
-    console.log(`  ${import_picocolors12.default.bold("Complete:")}  ${result.complete ? import_picocolors12.default.green("yes") : import_picocolors12.default.yellow("no")}`);
+    console.log(`  ${import_picocolors13.default.bold("Status:")}    ${statusLabel(result.status)}`);
+    console.log(`  ${import_picocolors13.default.bold("Complete:")}  ${result.complete ? import_picocolors13.default.green("yes") : import_picocolors13.default.yellow("no")}`);
     if (result.progress) {
       const prog = result.progress;
-      console.log(`  ${import_picocolors12.default.bold("Progress:")}  ${prog.completed || 0}/${prog.total || "?"}`);
+      console.log(`  ${import_picocolors13.default.bold("Progress:")}  ${prog.completed || 0}/${prog.total || "?"}`);
     }
     if (result.error) {
-      console.log(`  ${import_picocolors12.default.bold("Error:")}     ${import_picocolors12.default.red(result.error.message || result.error)}`);
+      console.log(`  ${import_picocolors13.default.bold("Error:")}     ${import_picocolors13.default.red(result.error.message || result.error)}`);
     }
     console.log("");
   });
@@ -5988,27 +6162,27 @@ function jobsCommand() {
 function statusLabel(status) {
   switch (status) {
     case "complete":
-      return import_picocolors12.default.green("Complete");
+      return import_picocolors13.default.green("Complete");
     case "running":
     case "in_progress":
-      return import_picocolors12.default.cyan("Running");
+      return import_picocolors13.default.cyan("Running");
     case "cancelled":
-      return import_picocolors12.default.yellow("Cancelled");
+      return import_picocolors13.default.yellow("Cancelled");
     case "error":
     case "failed":
-      return import_picocolors12.default.red("Failed");
+      return import_picocolors13.default.red("Failed");
     default:
-      return import_picocolors12.default.dim(status || "unknown");
+      return import_picocolors13.default.dim(status || "unknown");
   }
 }
 
 // src/cli.js
-var VERSION = true ? "0.1.8" : "0.0.0";
+var VERSION = true ? "0.2.0" : "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";
 }
-var b3 = (s) => import_picocolors13.default.bold(import_picocolors13.default.blue(s));
+var b3 = (s) => import_picocolors14.default.bold(import_picocolors14.default.blue(s));
 var BANNER = [
   "",
   "  " + b3("   ___     __      __  __     __             __"),
@@ -6017,7 +6191,7 @@ var BANNER = [
   "  " + b3("/_/ |_\\_,_/___/  \\____/ .__/_/\\___/\\_,_/\\_,_/\\__/_/"),
   "  " + b3("                     /_/"),
   "",
-  "  " + import_picocolors13.default.dim("Create Meta ads from the command line"),
+  "  " + import_picocolors14.default.dim("Create Meta ads from the command line"),
   ""
 ].join("\n");
 var program2 = new Command().name("ads").description("Ads Uploader CLI").version(VERSION).addHelpText("before", BANNER);
@@ -6027,6 +6201,7 @@ program2.addCommand(whoamiCommand());
 program2.addCommand(configCommand());
 program2.addCommand(accountsCommand());
 program2.addCommand(accountCommand());
+program2.addCommand(pagesCommand());
 program2.addCommand(campaignsCommand());
 program2.addCommand(campaignCommand());
 program2.addCommand(adsetsCommand());
@@ -6064,8 +6239,8 @@ async function checkForUpdates() {
     }
     if (latest !== VERSION) {
       console.error(`
-  ${import_picocolors13.default.yellow("Update available:")} ${import_picocolors13.default.dim(VERSION)} \u2192 ${import_picocolors13.default.green(latest)}`);
-      console.error(`  Run ${import_picocolors13.default.cyan("npm update -g @adsuploader/cli")} to update
+  ${import_picocolors14.default.yellow("Update available:")} ${import_picocolors14.default.dim(VERSION)} \u2192 ${import_picocolors14.default.green(latest)}`);
+      console.error(`  Run ${import_picocolors14.default.cyan("npm update -g @adsuploader/cli")} to update
 `);
     }
   } catch {
@@ -6089,7 +6264,7 @@ if (process.argv.length <= 2) {
     }
     if (err.code !== "commander.executeSubCommandAsync") {
       console.error(`
-  ${import_picocolors13.default.red("Error:")} ${err.message}
+  ${import_picocolors14.default.red("Error:")} ${err.message}
 `);
       process.exit(1);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adsuploader/cli",
-  "version": "0.1.8",
+  "version": "0.2.0",
   "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,6 +32,7 @@
   "scripts": {
     "build": "node build.cjs",
     "dev": "node src/cli.js",
+    "test": "node --test test/*.test.mjs",
     "link": "npm link",
     "prepublishOnly": "npm run build",
     "version": "npm run build"