@koda-sl/baker-cli 0.434.0 → 0.435.0

package/README.md

@@ -621,6 +621,18 @@ baker ads google campaigns create --customer-id 1234567890 --name "Brand — Sea
 # New campaigns are declared as NOT containing EU political advertising (Google requires the
 # declaration on every create); pass --eu-political-ads only when the campaign does contain it.
 # On update, --eu-political-ads / --eu-political-ads=false corrects an existing declaration.
+# Text guidelines (AI Max Search and Performance Max) stage on update only:
+baker ads google campaigns update <campaign-id> --customer-id 1234567890 \
+  --term-exclusion "cheap" --messaging-restriction "Never promise a delivery date"
+# --term-exclusion (repeatable, up to 25 × 30 chars) and --messaging-restriction (repeatable,
+# up to 40 × 300 chars) each REPLACE the campaign's list; --clear-term-exclusions /
+# --clear-messaging-restrictions empty one. A Search campaign needs AI Max with text
+# customization on (in the same update or before), or staging is refused with the reason.
+# AI Max for Search stages on create and update: --ai-max / --ai-max=false (off turns both
+# features off too), --ai-max-text (text customization, needs AI Max) and
+# --ai-max-url-expansion (final URL expansion, needs text customization). An omitted switch
+# keeps the campaign's value; a combination Google refuses is refused at staging.
+baker ads google campaigns update <campaign-id> --customer-id 1234567890 --ai-max --ai-max-text
 baker ads google ad-groups create --customer-id 1234567890 --name "Brand terms" --campaign-ref g_temp_<campaign>
 baker ads google keywords add --customer-id 1234567890 --ad-group-ref g_temp_<adgroup> --text "brand name" --match-type EXACT
 # Shared negative keyword list → attach to the campaign

package/dist/cli.js

@@ -24891,7 +24891,13 @@ var GOOGLE_ADS_LIMITS = {
     /** `campaign.url_custom_parameters` — Google caps a single entity at 8 `{_name}` parameters. */
     urlCustomParametersMax: 8,
     urlCustomParameterKeyMax: 16,
-    urlCustomParameterValueMax: 250
+    urlCustomParameterValueMax: 250,
+    /** `campaign.text_guidelines.term_exclusions` — words AI Max and Performance Max must never write. */
+    termExclusionsMax: 25,
+    termExclusionMax: 30,
+    /** `campaign.text_guidelines.messaging_restrictions` — freeform rules for generated text. */
+    messagingRestrictionsMax: 40,
+    messagingRestrictionMax: 300
   },
   adGroup: {
     nameMax: 255
@@ -25873,6 +25879,49 @@ var geoTargetTypeSettingSchema = z9.strictObject({
   (p) => p.positiveGeoTargetType !== void 0 || p.negativeGeoTargetType !== void 0,
   "geoTargetTypeSetting needs positiveGeoTargetType and/or negativeGeoTargetType"
 );
+var textGuidelinesSchema = z9.strictObject({
+  termExclusions: z9.array(z9.string().trim().min(1).max(GOOGLE_ADS_LIMITS.campaign.termExclusionMax)).max(GOOGLE_ADS_LIMITS.campaign.termExclusionsMax).optional(),
+  messagingRestrictions: z9.array(z9.string().trim().min(1).max(GOOGLE_ADS_LIMITS.campaign.messagingRestrictionMax)).max(GOOGLE_ADS_LIMITS.campaign.messagingRestrictionsMax).refine(
+    (rules) => new Set(rules.map((rule) => rule.toLowerCase())).size === rules.length,
+    "each messaging restriction must be unique"
+  ).optional()
+}).refine(
+  (p) => p.termExclusions !== void 0 || p.messagingRestrictions !== void 0,
+  "textGuidelines needs termExclusions and/or messagingRestrictions"
+);
+var AI_MAX_TEXT_NEEDS_AI_MAX_MESSAGE = "AI Max text customization only works with AI Max on: also turn AI Max on, or leave text customization off.";
+var AI_MAX_URL_NEEDS_TEXT_MESSAGE = "AI Max final URL expansion only works with text customization on: also turn text customization on, or leave URL expansion off.";
+var aiMaxSchema = z9.strictObject({
+  enabled: z9.boolean().optional(),
+  textCustomization: z9.boolean().optional(),
+  finalUrlExpansion: z9.boolean().optional()
+}).superRefine((p, ctx) => {
+  if (p.enabled === void 0 && p.textCustomization === void 0 && p.finalUrlExpansion === void 0) {
+    ctx.addIssue({ code: "custom", message: "aiMax needs enabled, textCustomization and/or finalUrlExpansion" });
+  }
+  if (p.enabled === false && p.textCustomization === true) {
+    ctx.addIssue({ code: "custom", path: ["textCustomization"], message: AI_MAX_TEXT_NEEDS_AI_MAX_MESSAGE });
+  }
+  if (p.textCustomization === false && p.finalUrlExpansion === true) {
+    ctx.addIssue({ code: "custom", path: ["finalUrlExpansion"], message: AI_MAX_URL_NEEDS_TEXT_MESSAGE });
+  }
+});
+var AI_MAX_SEARCH_ONLY_MESSAGE = "AI Max exists only on Search campaigns.";
+function aiMaxCreateRefusal(channelType, aiMax) {
+  if (!aiMax) {
+    return void 0;
+  }
+  if (channelType !== "SEARCH") {
+    return AI_MAX_SEARCH_ONLY_MESSAGE;
+  }
+  if (aiMax.enabled !== true && aiMax.textCustomization === true) {
+    return AI_MAX_TEXT_NEEDS_AI_MAX_MESSAGE;
+  }
+  if (aiMax.textCustomization !== true && aiMax.finalUrlExpansion === true) {
+    return AI_MAX_URL_NEEDS_TEXT_MESSAGE;
+  }
+  return void 0;
+}
 var campaignCreateSchema2 = z9.strictObject({
   name: z9.string().min(1).max(GOOGLE_ADS_LIMITS.campaign.nameMax),
   channelType: z9.enum(ADVERTISING_CHANNEL_TYPES),
@@ -25902,6 +25951,8 @@ var campaignCreateSchema2 = z9.strictObject({
    * every campaign create (FieldError.REQUIRED without it); omitted means it does not.
    */
   euPoliticalAds: z9.boolean().optional(),
+  /** AI Max for Search. A new campaign has it off unless this turns it on. */
+  aiMax: aiMaxSchema.optional(),
   status: stageableStatusSchema2.default("PAUSED")
 }).superRefine((p, ctx) => {
   if (!p.bidding && !p.biddingStrategy) {
@@ -25928,6 +25979,10 @@ var campaignCreateSchema2 = z9.strictObject({
   if (p.startDate && p.endDate && p.endDate <= p.startDate) {
     ctx.addIssue({ code: "custom", path: ["endDate"], message: "endDate must be after startDate" });
   }
+  const aiMaxRefusal = aiMaxCreateRefusal(p.channelType, p.aiMax);
+  if (aiMaxRefusal) {
+    ctx.addIssue({ code: "custom", path: ["aiMax"], message: aiMaxRefusal });
+  }
 });
 var campaignUpdateSchema2 = z9.strictObject({
   name: z9.string().min(1).max(GOOGLE_ADS_LIMITS.campaign.nameMax).optional(),
@@ -25946,6 +26001,10 @@ var campaignUpdateSchema2 = z9.strictObject({
   urlCustomParameters: urlCustomParametersSchema.optional(),
   /** Corrects the campaign's EU political advertising declaration (true = contains, false = does not). */
   euPoliticalAds: z9.boolean().optional(),
+  /** AI Max / Performance Max text guidelines. Google refuses them on a Search campaign without AI Max. */
+  textGuidelines: textGuidelinesSchema.optional(),
+  /** Turns AI Max or its features on or off. Search campaigns only (checked against the live channel). */
+  aiMax: aiMaxSchema.optional(),
   status: z9.enum(["ENABLED", "PAUSED", "REMOVED"]).optional()
 }).refine((p) => Object.values(p).some((v) => v !== void 0), "update needs at least one field");
 var adGroupCreateSchema = z9.strictObject({
@@ -49037,6 +49096,74 @@ function urlCustomParametersFromFlags(args8, rawArgs) {
     return { key: entry.slice(0, split), value: entry.slice(split + 1) };
   });
 }
+var aiMaxArgs = {
+  "ai-max": {
+    type: "boolean",
+    description: "AI Max for Search: --ai-max turns it on (Google then matches searches beyond your keywords), --ai-max=false turns it off along with its text customization and URL expansion. Search campaigns only."
+  },
+  "ai-max-text": {
+    type: "boolean",
+    description: "AI Max text customization: --ai-max-text lets Google write ad text from your landing page and ads (needs AI Max on); --ai-max-text=false stops it. Required before text guidelines."
+  },
+  "ai-max-url-expansion": {
+    type: "boolean",
+    description: "AI Max final URL expansion: --ai-max-url-expansion lets Google send clicks to the most relevant page of your site (needs text customization on); --ai-max-url-expansion=false keeps every click on your final URLs."
+  }
+};
+function aiMaxFromFlags(args8) {
+  const flag2 = (name) => typeof args8[name] === "boolean" ? args8[name] : void 0;
+  const aiMax = {
+    enabled: flag2("ai-max"),
+    textCustomization: flag2("ai-max-text"),
+    finalUrlExpansion: flag2("ai-max-url-expansion")
+  };
+  const stated = Object.entries(aiMax).filter(([, v]) => v !== void 0);
+  return stated.length > 0 ? Object.fromEntries(stated) : void 0;
+}
+var textGuidelinesArgs = {
+  "term-exclusion": {
+    type: "string",
+    description: `Text guidelines (AI Max Search and Performance Max): a word or phrase Google's generated ad text must never use, up to 30 characters (e.g. --term-exclusion "cheap"). Repeat for several; Google allows 25. REPLACES the campaign's whole list.`
+  },
+  "messaging-restriction": {
+    type: "string",
+    description: `Text guidelines (AI Max Search and Performance Max): a plain-language rule for Google's generated ad text, up to 300 characters (e.g. --messaging-restriction "Never promise a delivery date"). Repeat for several; Google allows 40. REPLACES the campaign's whole list.`
+  },
+  "clear-term-exclusions": {
+    type: "boolean",
+    description: "Remove every term exclusion from this campaign's text guidelines."
+  },
+  "clear-messaging-restrictions": {
+    type: "boolean",
+    description: "Remove every messaging restriction from this campaign's text guidelines."
+  }
+};
+function guidelineListFromFlags(args8, rawArgs, flag2, clearFlag) {
+  const values = repeatedValues(rawArgs, flag2, args8[flag2]).filter((v) => v.length > 0);
+  if (values.length === 0) {
+    return args8[clearFlag] === true ? [] : void 0;
+  }
+  if (args8[clearFlag] === true) {
+    failWriteValidation2(`--${clearFlag} removes the whole list \u2014 pass it OR --${flag2}, not both`);
+  }
+  return values;
+}
+function textGuidelinesFromFlags(args8, rawArgs) {
+  const termExclusions = guidelineListFromFlags(args8, rawArgs, "term-exclusion", "clear-term-exclusions");
+  const messagingRestrictions = guidelineListFromFlags(
+    args8,
+    rawArgs,
+    "messaging-restriction",
+    "clear-messaging-restrictions"
+  );
+  if (termExclusions === void 0 && messagingRestrictions === void 0) {
+    return void 0;
+  }
+  return {
+    ...termExclusions !== void 0 ? { termExclusions } : {},
+    ...messagingRestrictions !== void 0 ? { messagingRestrictions } : {}
+  };
+}
 var geoTargetTypeArgs = {
   "geo-target-type": {
     type: "string",
@@ -49188,6 +49315,7 @@ var campaignsCommand3 = defineCommand57({
         ...urlOptionsArgs,
         ...geoTargetTypeArgs,
         ...networksArg,
+        ...aiMaxArgs,
         objective: { type: "string", description: "Advisory UI objective (SALES, LEADS, \u2026)" },
         "start-date": { type: "string", description: "YYYY-MM-DD" },
         "end-date": { type: "string", description: "YYYY-MM-DD" },
@@ -49214,6 +49342,7 @@ var campaignsCommand3 = defineCommand57({
           startDate: args8["start-date"],
           endDate: args8["end-date"],
           euPoliticalAds: args8["eu-political-ads"],
+          aiMax: aiMaxFromFlags(args8),
           status: args8.status
         });
         await stageCreate("google.campaign.create", customerId, payload, [
@@ -49225,7 +49354,7 @@ var campaignsCommand3 = defineCommand57({
     update: defineCommand57({
       meta: {
         name: "update",
-        description: `Stage a change to an existing campaign's name, budget, bidding or settings. ${STAGED_WRITE}`
+        description: `Stage a change to an existing campaign's name, budget, bidding, settings, AI Max switches or text guidelines (what AI Max and Performance Max ad text must avoid). ${STAGED_WRITE}`
       },
       args: {
         ...customerIdArg,
@@ -49253,6 +49382,8 @@ var campaignsCommand3 = defineCommand57({
         ...urlOptionsArgs,
         ...geoTargetTypeArgs,
         ...networksArg,
+        ...textGuidelinesArgs,
+        ...aiMaxArgs,
         "eu-political-ads": {
           type: "boolean",
           description: "Corrects the campaign's EU political advertising declaration: --eu-political-ads if it contains EU political ads, --eu-political-ads=false if it does not. Existing campaigns without a declaration block location-targeting changes until one is set."
@@ -49283,6 +49414,8 @@ var campaignsCommand3 = defineCommand57({
           trackingUrlTemplate: args8["tracking-template"],
           urlCustomParameters: urlCustomParametersFromFlags(args8, rawArgs),
           euPoliticalAds: args8["eu-political-ads"],
+          textGuidelines: textGuidelinesFromFlags(args8, rawArgs),
+          aiMax: aiMaxFromFlags(args8),
           status: args8.status
         });
         await stageUpdate("google.campaign.update", customerId, target2, payload);