@adsuploader/cli 0.1.8 → 0.2.1

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 |
@@ -44,6 +45,7 @@ This package includes a `SKILL.md` file that describes every command and option
 | `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 upload --retry-failed [batchId]` | Retry failed files into the same upload batch |
 | `ads uploads` | List recent upload batches |
 | `ads create spec.json` | Create ads from spec |
 | `ads create:preview spec.json` | Dry run |

package/SKILL.md

@@ -41,10 +41,21 @@ Every ad creation follows three steps:
 ```bash
 ads upload hero.jpg banner.mp4
 ads upload ./my-creatives/          # entire directory
+ads upload --retry-failed           # retry latest failed batch
+ads upload --retry-failed batch_abc123
 ```
 
 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) |
+| `--retry-failed [batchId]` | Retry failed files into the same batch; defaults to the latest saved failed batch |
+
 ### 2. Preview (dry run)
 
 ```bash
@@ -78,6 +89,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 +127,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 +180,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.