@koda-sl/baker-cli 0.187.0 → 0.188.0

package/README.md

@@ -594,7 +594,9 @@ baker tag-manager draft show --chat <chat-id> gtm_temp_ab12
 baker actions draft --chat <chat-id>
 ```
 
-Command groups: `budgets`, `campaigns`, `ad-groups`, `keywords` (add/update/remove), `negative-keywords`, `keyword-lists`, `ads`, `assets` (create/update/attach/detach), `asset-groups` (create/update/attach/detach — Performance Max), `audiences`, `conversions` (create/update/goal), `bidding-strategies`, `labels`, `campaign-criteria`, and `draft`. Amounts are in major currency units (converted to micros). Money/bids: `--amount`, `--cpc-bid`, `--target-cpa`, `--max-cpc` take major units; `--target-roas` a ratio. `--max-cpc` sets the max CPC bid ceiling for `TARGET_IMPRESSION_SHARE` / `TARGET_SPEND` / `PERCENT_CPC` and must be paired with `--bidding-strategy`. Less-common ops accept a `--file <payload.json>` (flags override file keys). Updates target a resource name or bare id as the positional argument; a target that names an op staged earlier **amends it in place**.
+Command groups: `budgets`, `campaigns`, `ad-groups`, `keywords` (add/update/remove), `negative-keywords`, `keyword-lists`, `ads`, `assets` (create/update/attach/detach), `asset-groups` (create/update/attach/detach — Performance Max), `audiences`, `conversions` (create/update/goal), `bidding-strategies`, `labels`, `campaign-criteria` (add/update/remove), and `draft`. Amounts are in major currency units (converted to micros). Money/bids: `--amount`, `--cpc-bid`, `--target-cpa`, `--max-cpc` take major units; `--target-roas` a ratio. `--max-cpc` sets the max CPC bid ceiling for `TARGET_IMPRESSION_SHARE` / `TARGET_SPEND` / `PERCENT_CPC` and must be paired with `--bidding-strategy`. Less-common ops accept a `--file <payload.json>` (flags override file keys). Updates target a resource name or bare id as the positional argument; a target that names an op staged earlier **amends it in place**.
+
+**A device criterion can be added, but never removed** — `campaign-criteria add` with a device criterion works, but Google then rejects `campaign-criteria remove` on it forever, including on a criterion you added yourself (and Baker refuses the removal before publish). Adjust it instead with `campaign-criteria update customers/<cid>/campaignCriteria/<campaignId>~<criterionId> --bid-modifier <n>`: `1` for no adjustment, `1.25` to bid 25% more, `0.9` to bid 10% less, `0` to stop serving on that device. Locations, languages and ad schedules remove normally.
 
 **Primary vs secondary conversion actions** — `conversions update <id> --primary` makes an action a primary action (automated bidding optimizes toward it); `--no-primary` (or `--primary=false`) demotes it to secondary (reported only) — the spaced form `--primary false` is rejected, since a boolean flag written with a space is set to true and the word dropped. `conversions create` stages a new action as **secondary** unless its `--file` payload sets `"primaryForGoal": true`, so a new action never silently joins the bidding target of a Maximize Conversions or Target CPA campaign. The staged card shows an "Action optimization" row with the before/after role.
 

package/dist/cli.js

@@ -6700,14 +6700,13 @@ var adScheduleCriterionSchema = z17.object({
   endHour: z17.number().int().min(0).max(24),
   endMinute: z17.enum(["ZERO", "FIFTEEN", "THIRTY", "FORTY_FIVE"]).default("ZERO")
 });
+var bidModifierSchema = z17.number().min(0).max(10).refine((v) => v === 0 || v >= 0.1, {
+  message: "bid modifier must be 0 (exclude the device) or between 0.1 and 10.0"
+});
 var deviceCriterionSchema = z17.object({
   criterionType: z17.literal("device"),
   device: z17.enum(DEVICE_TYPES),
-  // Google's `CampaignCriterion.bid_modifier`: "The modifier must be in the range 0.1 - 10.0. Use 0
-  // to opt out of a Device type." So 0 (exclude the device) and 0.1–10.0 are valid; the (0, 0.1) gap is not.
-  bidModifier: z17.number().min(0).max(10).optional().refine((v) => v === void 0 || v === 0 || v >= 0.1, {
-    message: "bid modifier must be 0 (exclude the device) or between 0.1 and 10.0"
-  })
+  bidModifier: bidModifierSchema.optional()
 });
 var campaignCriterionAddSchema = z17.object({
   campaign: refSchema,
@@ -6728,6 +6727,9 @@ var campaignCriterionAddSchema = z17.object({
     });
   }
 });
+var campaignCriterionUpdateSchema = z17.object({
+  bidModifier: bidModifierSchema
+});
 var GOOGLE_DRAFT_OP_KINDS = [
   "google.budget.create",
   "google.budget.update",
@@ -6775,6 +6777,7 @@ var GOOGLE_DRAFT_OP_KINDS = [
   "google.label.create",
   "google.label.attach",
   "google.campaignCriterion.add",
+  "google.campaignCriterion.update",
   "google.campaignCriterion.remove"
 ];
 var googleDraftOpKindSchema = z17.enum(GOOGLE_DRAFT_OP_KINDS);
@@ -6834,6 +6837,7 @@ var googleDraftOpInputSchema = z17.discriminatedUnion("kind", [
   createOp2("google.label.create", labelCreateSchema),
   createOp2("google.label.attach", labelAttachSchema),
   createOp2("google.campaignCriterion.add", campaignCriterionAddSchema),
+  updateOp2("google.campaignCriterion.update", campaignCriterionUpdateSchema),
   targetOp("google.campaignCriterion.remove")
 ]);
 
@@ -7021,6 +7025,9 @@ var googleDraftStatusCollectionSchema = z19.object({
   label: z19.string(),
   added: z19.number(),
   removed: z19.number(),
+  /** Members that stay in the set with a changed value — a device's bid adjustment. Optional: a
+   *  status tree built by an older backend carries no such count. */
+  updated: z19.number().optional(),
   existing: z19.number()
 });
 var googleDraftChangeOperationSchema = z19.enum(["create", "update", "pause", "resume", "remove"]);
@@ -8348,6 +8355,9 @@ function collectionLine(collection) {
   if (collection.removed > 0) {
     parts.push(`-${collection.removed}`);
   }
+  if ((collection.updated ?? 0) > 0) {
+    parts.push(`~${collection.updated}`);
+  }
   return parts.length > 0 ? `${collection.label}: ${parts.join(", ")}` : void 0;
 }
 function renderNode(node, depth, lines) {
@@ -11142,14 +11152,64 @@ var labelsCommand = defineCommand30({
     attach: fileCreateCommand("attach", "google.label.attach", "Attach a label to a campaign/adGroup/ad")
   }
 });
+function bidModifierFlag(value) {
+  if (value === void 0 || value === null || value === "") {
+    failWriteValidation(
+      "--bid-modifier is required: 1 for no adjustment, 1.25 to bid 25% more, 0.9 to bid 10% less, 0 to stop serving on it"
+    );
+  }
+  const num3 = Number(value);
+  if (Number.isNaN(num3) || num3 < 0 || num3 > 10 || num3 > 0 && num3 < 0.1) {
+    failWriteValidation("--bid-modifier must be 0 (stop serving on it) or between 0.1 and 10.0");
+  }
+  return num3;
+}
 var campaignCriteriaCommand = defineCommand30({
   meta: {
     name: "campaign-criteria",
-    description: "Stage campaign criteria (location/language/adSchedule/device) add/remove (via --file)"
+    description: "Stage campaign criteria (location/language/adSchedule/device): add/remove a targeting criterion, or update a device bid adjustment"
   },
   subCommands: {
     add: fileCreateCommand("add", "google.campaignCriterion.add", "Add a campaign criterion"),
-    remove: statusCommand2("google.campaignCriterion.remove", "campaign criterion")
+    update: defineCommand30({
+      meta: {
+        name: "update",
+        description: "Change a criterion's bid adjustment \u2014 the only way to change a device setting the campaign already has, since Google never lets one be removed. Start here: `campaign-criteria update customers/<cid>/campaignCriteria/<campaignId>~<criterionId> --bid-modifier 1` resets a boost to neutral; --bid-modifier 0 stops ads serving on that device. Use `campaign-criteria add` instead when the campaign has no criterion for that device yet. Read the current ones with: baker ads google query \"SELECT campaign_criterion.resource_name, campaign_criterion.device.type, campaign_criterion.bid_modifier FROM campaign_criterion WHERE campaign_criterion.type = 'DEVICE'\""
+      },
+      args: {
+        ...customerIdArg,
+        id: {
+          type: "positional",
+          description: "Criterion resource name (customers/\u2026/campaignCriteria/{campaignId}~{criterionId})",
+          required: false
+        },
+        "bid-modifier": {
+          type: "string",
+          description: "1 = no adjustment, 1.25 = bid 25% more, 0.9 = bid 10% less, 0 = don't serve on it"
+        }
+      },
+      run: async ({ args }) => {
+        const customerId = requireCustomerId(args);
+        const target = requireTarget(args, "campaign criterion");
+        await stageUpdate("google.campaignCriterion.update", customerId, target, {
+          bidModifier: bidModifierFlag(args["bid-modifier"])
+        });
+      }
+    }),
+    remove: defineCommand30({
+      meta: {
+        name: "remove",
+        description: "Stage a campaign criterion remove. Works for what you added \u2014 locations, languages, ad schedules. A device setting CANNOT be removed once the campaign has one: use `campaign-criteria update --bid-modifier` to change or neutralise it instead."
+      },
+      args: {
+        ...customerIdArg,
+        id: { type: "positional", description: "Criterion resource name or id", required: false }
+      },
+      run: async ({ args }) => {
+        const customerId = requireCustomerId(args);
+        await stageTarget("google.campaignCriterion.remove", customerId, requireTarget(args, "campaign criterion"));
+      }
+    })
   }
 });
 var googleWriteCommands = {