@koda-sl/baker-cli 0.392.0-dev.9666ad9b3 → 0.393.0-dev.10b6da011

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()
   };
 }
@@ -34346,7 +34363,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. On update it replaces the whole list; none clears it"
   },
   "bid-strategy": {
     type: "string",
@@ -34372,6 +34389,16 @@ 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 productSetArg(value) {
   const filters = productFiltersArg(value);
   return filters === void 0 ? void 0 : { filters };
@@ -34380,7 +34407,7 @@ 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"]),
@@ -34408,7 +34435,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 +34464,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 +34738,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 +34759,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 +34796,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 +34867,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 +34904,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 +35073,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."
     ]);
   }
 });