@koda-sl/baker-cli 0.392.0-dev.9666ad9b3 → 0.394.0-dev.d28cef496

package/README.md

@@ -876,7 +876,7 @@ Read the company's ChatGPT Ads account (OpenAI's ads inside ChatGPT conversation
 | `conversions` | Pixels (with the pixel id a landing page installs) and conversions, with the campaigns using each |
 | `insights` | Impressions, clicks, spend, CTR, CPC, CPM, conversions, CPA, ROAS — per `--level account\|campaign\|ad_group\|ad`, over `--days N` or `--since/--until`, `--granularity`, `--segment country\|device\|platform\|product` |
 | `campaigns create\|update\|pause\|resume\|archive` | Stage a campaign change: objective, daily or lifetime budget (currency units), schedule, countries and regions included and excluded, audiences, platforms, tracking template, status, the conversions it measures (`--conversion-event-ids`), a catalog (`--catalog-id`) |
-| `ad-groups create\|update\|pause\|resume\|archive` | Stage an ad group change: context hints, bid strategy, max bid, tracking template, product filters, status |
+| `ad-groups create\|update\|pause\|resume\|archive` | Stage an ad group change: context hints, bid strategy, max bid, audience bid adjustments, tracking template, product filters, status |
 | `ads create\|update\|pause\|resume\|archive` | Stage a chat card: title, body, landing page, image and its crop, tracking template, status |
 | `ads create-product` | Stage a catalog ad group's product ad: a title template the catalog's products fill in |
 | `pixels create` | Stage a new website pixel |

package/dist/cli.js

@@ -33300,7 +33300,13 @@ var imageCropSchema = z31.strictObject({
 var budgetMicrosSchema = z31.number().int("budgets are integer micros \u2014 \u20AC20.00 is 20000000").min(CHATGPT_LIMITS.budgetMinMicros, "a budget is at least one unit of the account currency");
 var bidMicrosSchema = z31.number().int("bids are integer micros \u2014 \u20AC2.50 is 2500000").min(1);
 var httpsUrlSchema3 = z31.string().trim().max(CHATGPT_LIMITS.urlMax).url("expected a full URL").refine((value) => value.startsWith("https://"), "ChatGPT Ads needs an https:// address");
-var isoTimeSchema2 = z31.string().refine((value) => !Number.isNaN(Date.parse(value)), "expected an ISO 8601 date or timestamp").transform((value) => new Date(value).toISOString());
+var DATE_ONLY = /^\d{4}-\d{2}-\d{2}$/;
+var LOCAL_TIME = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(:\d{2}(\.\d+)?)?$/;
+var ZONED_TIME = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(:\d{2}(\.\d+)?)?(Z|[+-]\d{2}:\d{2})$/;
+var isoTimeSchema2 = z31.string().trim().refine(
+  (value) => DATE_ONLY.test(value) || LOCAL_TIME.test(value) || ZONED_TIME.test(value),
+  "a date is YYYY-MM-DD, or YYYY-MM-DDTHH:MM in the account's time zone \u2014 e.g. 2026-10-12"
+).refine((value) => !Number.isNaN(Date.parse(value)), "that date does not exist").transform((value) => ZONED_TIME.test(value) ? new Date(value).toISOString() : value);
 var LAST_SCHEDULABLE_MS = Date.parse("2100-01-01T00:00:00Z");
 function notPast(what) {
   return isoTimeSchema2.refine((value) => Date.parse(value) > Date.now() - 6e4, `the ${what} is in the past`).refine(
@@ -33308,7 +33314,7 @@ function notPast(what) {
     `the ${what} is after 2099, which ChatGPT Ads cannot store`
   );
 }
-var startTimeSchema = notPast("start \u2014 leave it out to start when the chat is published");
+var startTimeSchema = notPast("start");
 var endTimeSchema = notPast("end");
 var countrySchema = z31.string().trim().regex(/^[A-Za-z]{2}$/, "countries are two-letter codes, e.g. ES").transform((value) => value.toUpperCase()).refine((value) => import_i18n_iso_countries.default.isValid(value), "that is not a country code (ISO 3166-1, e.g. ES)");
 var locationIdSchema = z31.string().trim().regex(/^\d+$/, "a region id is the number `baker ads chatgpt locations <place>` returns");
@@ -33382,6 +33388,13 @@ var conversionEventCreateSchema = z31.strictObject({
       message: "a custom conversion needs the event name the site sends"
     });
   }
+  if (p.eventType === "app_installed" || p.eventType === "app_opened") {
+    ctx.addIssue({
+      code: "custom",
+      path: ["eventType"],
+      message: "an app event reaches ChatGPT Ads only through the Conversions API, never a website pixel \u2014 and a conversion cannot be deleted, so it is not staged"
+    });
+  }
   if (p.eventType !== "custom" && p.customEventName !== void 0) {
     ctx.addIssue({
       code: "custom",
@@ -33422,17 +33435,21 @@ var COUNTRY_NAMES = new Map(
   CHATGPT_GEOTARGETS.filter(([, , , type]) => type === "country").map(([, name, countryCode2]) => [countryCode2, name])
 );
 var MAX_PLACES = 2500;
+function uniqueList(item, min, max) {
+  const list = z31.array(item).min(min);
+  return (max === void 0 ? list : list.max(max)).transform((values) => [...new Set(values)]);
+}
 function targetingFields(min) {
   return {
-    countries: z31.array(countrySchema).min(min).max(MAX_PLACES).optional(),
+    countries: uniqueList(countrySchema, min, MAX_PLACES).optional(),
     /** Region, market and postal-code ids from ChatGPT Ads' location lookup. */
-    locationIds: z31.array(locationIdSchema).min(min).max(MAX_PLACES).optional(),
+    locationIds: uniqueList(locationIdSchema, min, MAX_PLACES).optional(),
     /** Countries and places the campaign never serves in, even inside an included one. */
-    excludedCountries: z31.array(countrySchema).min(min).max(MAX_PLACES).optional(),
-    excludedLocationIds: z31.array(locationIdSchema).min(min).max(MAX_PLACES).optional(),
+    excludedCountries: uniqueList(countrySchema, min, MAX_PLACES).optional(),
+    excludedLocationIds: uniqueList(locationIdSchema, min, MAX_PLACES).optional(),
     /** Custom audiences the campaign serves only to, and ones it never serves. */
-    audienceIds: z31.array(audienceIdSchema).min(min).optional(),
-    excludedAudienceIds: z31.array(audienceIdSchema).min(min).optional(),
+    audienceIds: uniqueList(audienceIdSchema, min).optional(),
+    excludedAudienceIds: uniqueList(audienceIdSchema, min).optional(),
     platforms: z31.array(z31.enum(CHATGPT_PLATFORMS)).min(1).optional()
   };
 }
@@ -33514,6 +33531,21 @@ var campaignUpdateSchema4 = z31.strictObject({
   checkRunWindow2(p.startTime, p.endTime, ctx);
   checkTargeting(p, ctx);
 });
+var audienceBidMultipliersSchema = z31.array(
+  z31.strictObject({
+    audienceId: audienceIdSchema,
+    multiplierMicros: z31.number().int().min(1e5, "a bid adjustment is 0.1\xD7 to 10\xD7 \u2014 100000 to 10000000 micros").max(1e7, "a bid adjustment is 0.1\xD7 to 10\xD7 \u2014 100000 to 10000000 micros")
+  })
+).max(100);
+function checkMultipliers(strategy, multipliers, ctx) {
+  if (strategy !== void 0 && strategy !== "fixed_bid" && (multipliers?.length ?? 0) > 0) {
+    ctx.addIssue({
+      code: "custom",
+      path: ["audienceBidMultipliers"],
+      message: "an audience bid adjustment changes a fixed bid \u2014 Maximize Results sets the bid itself"
+    });
+  }
+}
 function checkBidPair2(strategy, maxBid, ctx) {
   if (strategy === "fixed_bid" && maxBid === void 0) {
     ctx.addIssue({ code: "custom", path: ["maxBidMicros"], message: "a fixed bid needs its amount" });
@@ -33541,8 +33573,12 @@ var adGroupCreateSchema2 = z31.strictObject({
   /** Only under a catalog campaign; which of its products this ad group may show. */
   productSet: productSetSchema.optional(),
   /** The campaign's catalog, filled in at stage time — the product set must name it. */
-  productFeedId: z31.string().trim().min(1).optional()
-}).superRefine((p, ctx) => checkBidPair2(p.bidStrategy, p.maxBidMicros, ctx));
+  productFeedId: z31.string().trim().min(1).optional(),
+  audienceBidMultipliers: audienceBidMultipliersSchema.optional()
+}).superRefine((p, ctx) => {
+  checkBidPair2(p.bidStrategy, p.maxBidMicros, ctx);
+  checkMultipliers(p.bidStrategy, p.audienceBidMultipliers, ctx);
+});
 var adGroupUpdateSchema2 = z31.strictObject({
   name: nameSchema3.optional(),
   description: z31.string().trim().max(CHATGPT_LIMITS.nameMax).optional(),
@@ -33554,9 +33590,12 @@ var adGroupUpdateSchema2 = z31.strictObject({
   billingEvent: z31.enum(CHATGPT_BILLING_EVENTS).optional(),
   /** Replaces the whole product set; `{ filters: [] }` shows the whole catalog. */
   productSet: productSetSchema.optional(),
-  productFeedId: z31.string().trim().min(1).optional()
+  productFeedId: z31.string().trim().min(1).optional(),
+  /** Replaces the ad group's adjustments; an empty list clears them. */
+  audienceBidMultipliers: audienceBidMultipliersSchema.optional()
 }).superRefine((p, ctx) => {
   noEmptyUpdate(p, ctx);
+  checkMultipliers(p.bidStrategy, p.audienceBidMultipliers, ctx);
   checkBidPair2(p.bidStrategy, p.maxBidMicros, ctx);
 });
 var titleSchema = z31.string().trim().refine(
@@ -34346,7 +34385,7 @@ var SHARED_ARGS = {
   description: { type: "string", description: "Internal description" },
   "context-hints": {
     type: "string",
-    description: "When the ad would be useful, comma-separated short phrases \u2014 ChatGPT's counterpart to keywords. On update it replaces the whole list"
+    description: "When the ad would be useful, short phrases separated by commas \u2014 or by | when a phrase has a comma. ChatGPT's counterpart to keywords, written in the language of the campaign's countries, as people ask ChatGPT. On update it replaces the whole list; none clears it"
   },
   "bid-strategy": {
     type: "string",
@@ -34357,6 +34396,10 @@ var SHARED_ARGS = {
     type: "string",
     description: "Query string added to this ad group's landing pages, e.g. utm_content={ad_group_id} \u2014 none clears"
   },
+  "audience-bids": {
+    type: "string",
+    description: "Raise or lower the fixed bid for people in an audience: audience=multiplier pairs, 0.1 to 10, e.g. caud_123=1.5,caud_456=0.8. Audiences of ~25,000 people only; not in the EEA or Switzerland. On update it replaces them; none clears"
+  },
   "product-filters": {
     type: "string",
     description: "Catalog campaigns only: which products it shows \u2014 e.g. brand in Acme; price lte 5000 (preview with `catalogs products`). On update it replaces the set; none shows the whole catalog"
@@ -34372,6 +34415,32 @@ var UPDATE_ARGS2 = {
   id: { type: "positional", description: "Ad group id (adgrp_\u2026) or a staged chatgpt_temp_ ref", required: true },
   ...SHARED_ARGS
 };
+function contextHintsArg(value) {
+  if (typeof value !== "string" || value.trim() === "") {
+    return void 0;
+  }
+  if (value.trim().toLowerCase() === "none") {
+    return [];
+  }
+  const separator = value.includes("|") ? "|" : ",";
+  return value.split(separator).map((hint) => hint.trim()).filter(Boolean);
+}
+function audienceBidsArg(value) {
+  if (typeof value !== "string" || value.trim() === "") {
+    return void 0;
+  }
+  if (value.trim().toLowerCase() === "none") {
+    return [];
+  }
+  return value.split(",").map((pair) => pair.trim()).filter(Boolean).map((pair) => {
+    const [audienceId = "", multiplier = ""] = pair.split("=").map((part) => part.trim());
+    const times = Number(multiplier.replace(",", "."));
+    if (!audienceId || !Number.isFinite(times)) {
+      failWriteValidation(`"${pair}" is not an audience bid \u2014 write audience=multiplier, e.g. caud_123=1.5`);
+    }
+    return { audienceId, multiplierMicros: Math.round(times * 1e6) };
+  });
+}
 function productSetArg(value) {
   const filters = productFiltersArg(value);
   return filters === void 0 ? void 0 : { filters };
@@ -34380,11 +34449,12 @@ function sharedPayload(args8) {
   return {
     name: args8.name,
     description: args8.description,
-    contextHints: csvArg(args8["context-hints"]),
+    contextHints: contextHintsArg(args8["context-hints"]),
     bidStrategy: lowerArg(args8["bid-strategy"]),
     maxBidMicros: microsFromArg(args8["max-bid"], "--max-bid"),
     trackingTemplate: clearableArg(args8["tracking-template"]),
     productSet: productSetArg(args8["product-filters"]),
+    audienceBidMultipliers: audienceBidsArg(args8["audience-bids"]),
     status: lowerArg(args8.status)
   };
 }
@@ -34408,7 +34478,7 @@ Examples:
   args: CREATE_ARGS,
   run: async ({ args: args8 }) => {
     await stageChatgptOp(adGroupCreateOp(args8), REFERENCE2, (staged) => [
-      `Next, give it a card: baker ads chatgpt ads create --ad-group-id ${staged.ref} --name "\u2026" --title "\u2026" --body "\u2026" --target-url https://\u2026 --image-url https://\u2026`
+      adGroupNextHint(staged.ref, args8["product-filters"] !== void 0)
     ]);
   }
 });
@@ -34437,6 +34507,10 @@ Examples:
 var adGroupsPauseCommand = statusCommand2("adGroup", "pause", REFERENCE2);
 var adGroupsResumeCommand = statusCommand2("adGroup", "resume", REFERENCE2);
 var adGroupsArchiveCommand = statusCommand2("adGroup", "archive", REFERENCE2);
+function adGroupNextHint(ref, productFilters) {
+  const productAd = `baker ads chatgpt ads create-product --ad-group-id ${ref} --name "\u2026"`;
+  return productFilters ? `Next, give it its product ad: ${productAd}` : `Next, give it a card: baker ads chatgpt ads create --ad-group-id ${ref} --name "\u2026" --title "\u2026" --body "\u2026" --target-url https://\u2026 --image-url https://\u2026 \u2014 under a catalog campaign, its product ad instead: ${productAd}`;
+}
 
 // src/commands/ads/chatgpt/ad-groups.ts
 var args = {
@@ -34707,7 +34781,7 @@ function sha256(value) {
 }
 function normalizedEmail(value) {
   const email = value.trim().toLowerCase();
-  return /^[^@\s]+@[^@\s]+$/.test(email) ? email : void 0;
+  return /^[^@\s;,|]+@[^@\s;,|]+\.[^@\s;,|]+$/.test(email) ? email : void 0;
 }
 function normalizedPhone(value, defaultCountry) {
   const country = defaultCountry && isSupportedCountry(defaultCountry) ? defaultCountry : void 0;
@@ -34728,13 +34802,22 @@ function hashedMembers(input) {
   }
   return { emailHashes: [...emailHashes], phoneHashes: [...phoneHashes], rejected };
 }
-var EMAIL_COLUMNS = ["email", "e-mail", "correo", "mail"];
-var PHONE_COLUMNS = ["phone", "phone_number", "telefono", "tel\xE9fono", "mobile", "movil", "m\xF3vil"];
+function headerWords(cell3) {
+  return cell3.normalize("NFD").replace(new RegExp("\\p{Diacritic}", "gu"), "").toLowerCase().replace(/[^a-z0-9]+/g, " ").trim();
+}
+var EMAIL_HEADER = /\b(e ?mail|correo|mail)\b/;
+var PHONE_HEADER = /\b(phone|telefono|movil|mobile|tel|celular)\b/;
 function membersFromFile(content) {
-  const rows = parse(content, { bom: true, skip_empty_lines: true, relax_column_count: true, trim: true });
-  const header = (rows[0] ?? []).map((cell3) => cell3.toLowerCase());
-  const emailColumn = header.findIndex((cell3) => EMAIL_COLUMNS.includes(cell3));
-  const phoneColumn = header.findIndex((cell3) => PHONE_COLUMNS.includes(cell3));
+  const rows = parse(content, {
+    bom: true,
+    skip_empty_lines: true,
+    relax_column_count: true,
+    trim: true,
+    delimiter: [",", ";", "	"]
+  });
+  const header = (rows[0] ?? []).map(headerWords);
+  const emailColumn = header.findIndex((cell3) => EMAIL_HEADER.test(cell3));
+  const phoneColumn = header.findIndex((cell3) => !EMAIL_HEADER.test(cell3) && PHONE_HEADER.test(cell3));
   if (emailColumn >= 0 || phoneColumn >= 0) {
     const cells = (column) => column < 0 ? [] : rows.slice(1).flatMap((row) => row[column] ? [row[column]] : []);
     return { emails: cells(emailColumn), phones: cells(phoneColumn) };
@@ -34756,21 +34839,23 @@ var MEMBER_ARGS = {
 };
 function membersFromArgs(args8, readFile34 = (path48) => readFileSync2(path48, "utf8")) {
   const fromFile = typeof args8.file === "string" && args8.file ? membersFromFile(readFile34(args8.file)) : { emails: [], phones: [] };
+  const given = [...csvArg(args8.emails) ?? [], ...fromFile.emails];
+  const givenPhones = [...csvArg(args8.phones) ?? [], ...fromFile.phones];
   const members = hashedMembers({
-    emails: [...csvArg(args8.emails) ?? [], ...fromFile.emails],
-    phones: [...csvArg(args8.phones) ?? [], ...fromFile.phones],
+    emails: given,
+    phones: givenPhones,
     defaultCountry: typeof args8.country === "string" ? args8.country.toUpperCase() : void 0
   });
   const count2 = members.emailHashes.length + members.phoneHashes.length;
-  if (count2 > CHATGPT_MAX_STAGED_MEMBERS) {
-    failWriteValidation(`${count2} members \u2014 at most ${CHATGPT_MAX_STAGED_MEMBERS} per change; split the file`);
-  }
+  const offered = given.length + givenPhones.length + (typeof args8.file === "string" && args8.file ? 1 : 0);
+  const refusal = count2 > CHATGPT_MAX_STAGED_MEMBERS ? `${count2} members \u2014 at most ${CHATGPT_MAX_STAGED_MEMBERS} per change; split the file` : count2 === 0 && offered > 0 ? "none of the values was an email or a valid phone \u2014 name the columns email and phone, and give phones a +country code or --country" : void 0;
   return {
     payload: {
       ...members.emailHashes.length > 0 ? { emailHashes: members.emailHashes } : {},
       ...members.phoneHashes.length > 0 ? { phoneHashes: members.phoneHashes } : {}
     },
-    rejected: members.rejected.length
+    rejected: members.rejected.length,
+    ...refusal ? { refusal } : {}
   };
 }
 function rejectedHint(rejected) {
@@ -34825,7 +34910,10 @@ Examples:
   },
   args: CREATE_ARGS3,
   run: async ({ args: args8 }) => {
-    const { payload, rejected } = membersFromArgs(args8);
+    const { payload, rejected, refusal } = membersFromArgs(args8);
+    if (refusal) {
+      failWriteValidation(refusal);
+    }
     await stageChatgptOp(
       {
         kind: "audience.create",
@@ -34859,7 +34947,10 @@ Example:
     },
     args: args8,
     run: async ({ args: parsed }) => {
-      const { payload, rejected } = membersFromArgs(parsed);
+      const { payload, rejected, refusal } = membersFromArgs(parsed);
+      if (refusal) {
+        failWriteValidation(refusal);
+      }
       if (!payload.emailHashes && !payload.phoneHashes) {
         failWriteValidation("name at least one email or phone with --emails, --phones or --file");
       }
@@ -35025,7 +35116,8 @@ Examples:
   args: CREATE_ARGS4,
   run: async ({ args: args8 }) => {
     await stageChatgptOp(campaignCreateOp(args8), REFERENCE5, (staged) => [
-      `Next, give it an ad group: baker ads chatgpt ad-groups create --campaign-id ${staged.ref} --name "\u2026" --context-hints "\u2026" --max-bid 2.50`
+      `Next, give it an ad group: baker ads chatgpt ad-groups create --campaign-id ${staged.ref} --name "\u2026" --context-hints "\u2026" --max-bid 2.50`,
+      "Check this summary against everything the user asked for \u2014 countries, places to leave out, budget, dates \u2014 and stage what is missing before saying it is ready."
     ]);
   }
 });