@koda-sl/baker-cli 0.275.0 → 0.276.0-dev.fc47c292d

package/README.md

@@ -741,7 +741,7 @@ All errors include a `fix` object with `action`, `correctedCommand` (when applic
 
 ### X (Twitter) Ads (`baker ads x`)
 
-Read X Ads campaigns, line items, promoted tweets, creatives, audiences, and analytics. Powered by the X Ads API v12.
+Read X Ads campaigns, line items, promoted tweets, creatives, audiences, and analytics — and stage changes that apply when the chat is published. Powered by the X Ads API v12.
 
 **Environment:**
 - `BAKER_X_ADS_ACCOUNT_ID` — default account ID (base36). Used when `--account-id` is not passed. If neither is set and exactly one X Ads account is connected, it's auto-selected.
@@ -759,12 +759,17 @@ Read X Ads campaigns, line items, promoted tweets, creatives, audiences, and ana
 | `media` | Media library (images / GIFs / videos) — `--media-type IMAGE\|GIF\|VIDEO` |
 | `audiences` | Custom audiences (size, targetable status) |
 | `targeting-criteria` | Targeting attached to line items |
-| `targeting-constants` | Lookup locations / interests / events / devices etc. — `--constant <name> --q "Madrid"` |
+| `targeting-constants` | Lookup locations / interests / events / devices etc. — `--constant <name> --q "Madrid"`. `--location-type` is plural (`COUNTRIES`, `REGIONS`, `CITIES`, `METROS`, `POSTAL_CODES`); `tv_shows` needs `--locale` (take one from `tv_markets`) |
 | `active-entities` | Entities with metric activity in a time range |
-| `stats sync` | Synchronous analytics (≤7 days, no segmentation) |
+| `stats sync` | Synchronous analytics (≤7 days, no segmentation). A preset asking for a longer window is shortened to 7 days and says so in `hints` |
 | `stats job` | Async stats end-to-end (creates + polls + downloads + decompresses). Must run in the background (the harness enforces this). Use for ranges >7 days, segmented stats, or when sync limits are hit. |
 | `stats job-create` | Low-level: create async stats job, return ID immediately |
 | `stats job-status` | Low-level: poll job status / get download URL |
+| `campaigns create\|update\|pause\|resume` | **Staged write** — a new or changed campaign |
+| `line-items create\|update\|pause\|resume` | **Staged write** — a new or changed ad group |
+| `promoted-tweets create\|remove` | **Staged write** — promote posts, or stop promoting them |
+| `targeting-criteria create\|remove` | **Staged write** — targeting on an ad group |
+| `draft` | Review the staged Campaign ▸ Ad group ▸ Ad tree; `show`, `amend`, `remove`, `clear` |
 
 **Examples:**
 
@@ -777,9 +782,10 @@ baker ads x promoted-tweets --account-id 18ce53xyz
 # Sync analytics with a preset (saves tokens)
 baker ads x stats sync --preset campaign-engagement-7d --entity-ids abc,def
 
-# Free-form sync stats
+# Free-form sync stats. At DAY granularity X requires both times to be midnight in the ad
+# account's own timezone (`baker ads x accounts` reports it) — below, midnight in a UTC-7 account.
 baker ads x stats sync --account-id 18ce53xyz --entity LINE_ITEM \
-  --entity-ids abc,def --start-time 2026-05-01T00:00:00Z --end-time 2026-05-07T00:00:00Z \
+  --entity-ids abc,def --start-time 2026-05-01T07:00:00Z --end-time 2026-05-07T07:00:00Z \
   --metric-groups ENGAGEMENT,BILLING --granularity DAY
 
 # Async job, sync from the CLI's perspective (creates → polls → downloads → returns).
@@ -794,14 +800,25 @@ baker ads x stats job-create --account-id 18ce53xyz --entity CAMPAIGN \
   --metric-groups ENGAGEMENT,BILLING --segmentation-type LOCATIONS
 baker ads x stats job-status --account-id 18ce53xyz --job-id <jobId>
 
+# Staged writes — nothing reaches X until the chat is published
+baker ads x campaigns create --name "Spring" --funding-instrument-id vtbot --daily-budget 5
+baker ads x line-items create --campaign-id x_temp_abc --name "Spain" --objective WEBSITE_CLICKS
+baker ads x targeting-criteria create --line-item-id x_temp_def --type LOCATION --value ecdce75d48b13b64
+baker ads x promoted-tweets create --line-item-id x_temp_def --tweet-ids 2042198488033661285
+baker ads x draft                       # review; after publishing, the authoritative record
+baker ads x campaigns pause oilf0,omyq3 # every id in one call
+
 # List sync presets
 baker ads x stats sync --list-presets
 
-# Targeting lookups
-baker ads x targeting-constants --constant locations --q "Madrid" --country-code ES
+# Targeting lookups (--location-type is plural; tv_shows needs a --locale from tv_markets)
+baker ads x targeting-constants --constant locations --q "Madrid" --country-code ES --location-type CITIES
 baker ads x targeting-constants --constant interests
+baker ads x targeting-constants --constant tv_shows --locale en-US
 ```
 
+**Writes are staged.** Every `create`/`update`/`pause`/`resume`/`remove` appends an op to the current chat's draft (`BAKER_CHAT_ID`); X is not called. The draft applies when the chat is published and discarding the chat reverses it. Creates default to `PAUSED`. Budgets and bids are given in account currency (`--daily-budget 12.50`). Chain creates with the `x_temp_*` ref a create returns.
+
 **Caching:** account list 1h · campaigns/line items/promoted tweets 1h (date-keyed) · cards/media/audiences 6h · stats sync 1h · targeting constants 7 days. Pass `--no-cache` to bypass.
 
 **Rate limits:** server-side buckets (`xAds:read`, `xAds:write`, `xAds:analyticsSync`, `xAds:analyticsAsync`, `xAds:audiences`) sit well under X's published quotas; 429s honor `x-account-rate-limit-reset` / `x-rate-limit-reset` headers.

package/dist/{chunk-36KVUYVL.js → chunk-RQRP3SAY.js}

@@ -16,9 +16,9 @@ import {
   shouldEscalate
 } from "./chunk-DZUVUGEP.js";
 
-// ../../node_modules/.pnpm/safe-stable-stringify@2.5.0/node_modules/safe-stable-stringify/index.js
+// ../../.pnpm-store/v10/links/@/safe-stable-stringify/2.5.0/509a695c9237c6e3727f1f1f99169917f329e3ff3f7877be290b684e24bf153d/node_modules/safe-stable-stringify/index.js
 var require_safe_stable_stringify = __commonJS({
-  "../../node_modules/.pnpm/safe-stable-stringify@2.5.0/node_modules/safe-stable-stringify/index.js"(exports, module) {
+  "../../.pnpm-store/v10/links/@/safe-stable-stringify/2.5.0/509a695c9237c6e3727f1f1f99169917f329e3ff3f7877be290b684e24bf153d/node_modules/safe-stable-stringify/index.js"(exports, module) {
     "use strict";
     var { hasOwnProperty } = Object.prototype;
     var stringify = configure2();
@@ -1092,7 +1092,7 @@ function resolveAdaptFormats(params) {
   return params.formats ?? [];
 }
 
-// ../../node_modules/.pnpm/safe-stable-stringify@2.5.0/node_modules/safe-stable-stringify/esm/wrapper.js
+// ../../.pnpm-store/v10/links/@/safe-stable-stringify/2.5.0/509a695c9237c6e3727f1f1f99169917f329e3ff3f7877be290b684e24bf153d/node_modules/safe-stable-stringify/esm/wrapper.js
 var import__ = __toESM(require_safe_stable_stringify(), 1);
 var configure = import__.default.configure;
 var wrapper_default = import__.default;
@@ -9154,4 +9154,4 @@ export {
   defaultRegistry,
   createEngineFromEnv
 };
-//# sourceMappingURL=chunk-36KVUYVL.js.map
+//# sourceMappingURL=chunk-RQRP3SAY.js.map