@koda-sl/baker-cli 0.442.0 → 0.443.0-dev.043c1d4ac

package/dist/chunk-5HYSKH77.js

@@ -0,0 +1,315 @@
+import {
+  asRecord
+} from "./chunk-KIGGMKAE.js";
+
+// src/viewer-profile.ts
+var VIEWER_TEMPERATURE_VALUES = ["cold", "warm", "hot"];
+var VIEWER_KNOWS_VALUES = ["brand", "offer", "product"];
+var VIEWER_SOURCE_VALUES = ["targeting", "knowledge"];
+var MARKETS = {
+  ES: {
+    name: "Spain",
+    names: /(?<![\p{L}\d])(spain|españa|espana)(?![\p{L}\d])/iu,
+    language: "es-ES",
+    languageName: "Spanish from Spain",
+    currency: "EUR",
+    address: "t\xFA"
+  },
+  MX: {
+    name: "Mexico",
+    names: /(?<![\p{L}\d])(mexico|méxico)(?![\p{L}\d])/iu,
+    language: "es-MX",
+    languageName: "Mexican Spanish",
+    currency: "MXN",
+    address: "t\xFA"
+  },
+  AR: {
+    name: "Argentina",
+    names: /(?<![\p{L}\d])(argentina)(?![\p{L}\d])/iu,
+    language: "es-AR",
+    languageName: "Argentinian Spanish",
+    currency: "ARS",
+    address: "vos"
+  },
+  CO: {
+    name: "Colombia",
+    names: /(?<![\p{L}\d])(colombia)(?![\p{L}\d])/iu,
+    language: "es-CO",
+    languageName: "Colombian Spanish",
+    currency: "COP",
+    address: "t\xFA"
+  },
+  CL: {
+    name: "Chile",
+    names: /(?<![\p{L}\d])(chile)(?![\p{L}\d])/iu,
+    language: "es-CL",
+    languageName: "Chilean Spanish",
+    currency: "CLP",
+    address: "t\xFA"
+  },
+  PE: {
+    name: "Peru",
+    names: /(?<![\p{L}\d])(peru|perú)(?![\p{L}\d])/iu,
+    language: "es-PE",
+    languageName: "Peruvian Spanish",
+    currency: "PEN",
+    address: "t\xFA"
+  },
+  BR: {
+    name: "Brazil",
+    names: /(?<![\p{L}\d])(brazil|brasil)(?![\p{L}\d])/iu,
+    language: "pt-BR",
+    languageName: "Brazilian Portuguese",
+    currency: "BRL",
+    address: "voc\xEA"
+  },
+  PT: {
+    name: "Portugal",
+    names: /(?<![\p{L}\d])(portugal)(?![\p{L}\d])/iu,
+    language: "pt-PT",
+    languageName: "European Portuguese",
+    currency: "EUR",
+    address: "tu"
+  },
+  GB: {
+    name: "the United Kingdom",
+    names: /(?<![\p{L}\d])(united kingdom|uk|britain|england)(?![\p{L}\d])/iu,
+    language: "en-GB",
+    languageName: "British English",
+    currency: "GBP",
+    address: "you"
+  },
+  IE: {
+    name: "Ireland",
+    names: /(?<![\p{L}\d])(ireland)(?![\p{L}\d])/iu,
+    language: "en-IE",
+    languageName: "Irish English",
+    currency: "EUR",
+    address: "you"
+  },
+  US: {
+    name: "the United States",
+    names: /(?<![\p{L}\d])(united states|usa|u\.s\.)(?![\p{L}\d])/iu,
+    language: "en-US",
+    languageName: "American English",
+    currency: "USD",
+    address: "you"
+  },
+  DE: {
+    name: "Germany",
+    names: /(?<![\p{L}\d])(germany|deutschland)(?![\p{L}\d])/iu,
+    language: "de-DE",
+    languageName: "German",
+    currency: "EUR",
+    address: "du"
+  },
+  FR: {
+    name: "France",
+    names: /(?<![\p{L}\d])(france)(?![\p{L}\d])/iu,
+    language: "fr-FR",
+    languageName: "French",
+    currency: "EUR",
+    address: "vous"
+  },
+  IT: {
+    name: "Italy",
+    names: /(?<![\p{L}\d])(italy|italia)(?![\p{L}\d])/iu,
+    language: "it-IT",
+    languageName: "Italian",
+    currency: "EUR",
+    address: "tu"
+  }
+};
+function marketOfCountries(countries) {
+  const codes = [...new Set(countries.map((c) => c.trim().toUpperCase()).filter(Boolean))];
+  if (codes.length === 0) return void 0;
+  if (codes.length > 1) return { country: "global" };
+  const code = codes[0];
+  const facts = MARKETS[code];
+  return facts ? { country: code, language: facts.language, currency: facts.currency, address: facts.address } : { country: code };
+}
+function marketFromCompanyDoc(doc) {
+  const line = (doc ?? "").split("\n").find(
+    (l) => /(?<![\p{L}\d])(markets?|geo|geograph\w*|country|countries|país|paises|países|mercados?)(?![\p{L}\d])/iu.test(l)
+  );
+  if (!line) return void 0;
+  const found = Object.entries(MARKETS).filter(([, facts]) => facts.names.test(line)).map(([code]) => code);
+  return marketOfCountries(found);
+}
+function describeMarket(market) {
+  if (market.country === "global") return "a person in any of the countries the ad runs in";
+  const facts = MARKETS[market.country];
+  const where = facts?.name ?? market.country;
+  const language = facts && market.language === facts.language ? facts.languageName : market.language;
+  return [
+    `a person living in ${where}`,
+    language ? ` who reads ${language} natively` : "",
+    market.currency ? `, pays in ${market.currency}` : "",
+    market.address ? ` and is spoken to as ${market.address}` : ""
+  ].join("");
+}
+function marketCountryName(market) {
+  return market.country === "global" ? null : MARKETS[market.country]?.name ?? market.country;
+}
+function text(value) {
+  return typeof value === "string" ? value : "";
+}
+function audienceRefs(value) {
+  if (!Array.isArray(value)) return [];
+  return value.flatMap((entry) => {
+    const ref = asRecord(entry);
+    const id = text(ref?.id);
+    return id ? [{ id, name: text(ref?.name) }] : [];
+  });
+}
+var COLD = { temperature: "cold", knows: [] };
+function tierOf(audience, ref, readName) {
+  const subtype = text(audience?.subtype).toUpperCase();
+  const name = text(audience?.name) || ref.name;
+  const read = readName?.(name);
+  if (subtype === "LOOKALIKE" || !subtype && read?.lookalike) {
+    return { ...COLD, who: "a lookalike: strangers who resemble the seed" };
+  }
+  if (read?.buyers) return { temperature: "hot", knows: ["brand", "offer", "product"], who: "buyers" };
+  if (subtype === "WEBSITE") return { temperature: "warm", knows: ["brand", "offer"], who: "site visitors" };
+  if (subtype === "CUSTOM") {
+    return { temperature: "hot", knows: ["brand", "offer", "product"], who: "an uploaded customer list" };
+  }
+  return { temperature: "warm", knows: ["brand"], who: "people who engaged with the brand" };
+}
+function classifyAudience(adSet, audiences, campaign, readName) {
+  const targeting = asRecord(adSet.targeting) ?? {};
+  const byId = new Map(audiences.map((audience) => [text(audience.id), audience]));
+  const includedRefs = audienceRefs(targeting.custom_audiences);
+  const included = includedRefs.map((ref) => tierOf(byId.get(ref.id), ref, readName));
+  const reasons = [
+    includedRefs.length === 0 ? "No custom audience: Meta finds new people from age, place and interests, so every viewer is a stranger." : `Reaches ${includedRefs.map((ref, i) => `"${ref.name || ref.id}" (${included[i]?.who})`).join(", ")}.`
+  ];
+  const unlisted = includedRefs.filter((ref) => !byId.has(ref.id));
+  if (unlisted.length > 0) {
+    reasons.push(`${quoteNames(unlisted)} is not in this account's audience list, so it was read from its name alone.`);
+  }
+  let reached = coldestOf(included);
+  if (asRecord(targeting.targeting_automation)?.advantage_audience === 1 && included.length > 0) {
+    reached = belowHot(reached);
+    reasons.push(
+      "Advantage+ audience treats the chosen audiences as suggestions and reaches past them, so part of the delivery goes to people who have never bought."
+    );
+  }
+  const excludedRefs = audienceRefs(targeting.excluded_custom_audiences);
+  if (excludedRefs.length > 0) reasons.push(`Keeps out ${quoteNames(excludedRefs)}.`);
+  if (excludedRefs.some((ref) => tierOf(byId.get(ref.id), ref, readName).temperature === "hot")) {
+    reached = belowHot(reached);
+    reasons.push("Buyers are excluded, so nobody reached has used the product.");
+  }
+  const objective = text(campaign?.objective);
+  if (reached.temperature === "cold" && ASKS_TO_ACT.test(objective)) {
+    reasons.push(
+      `Campaign objective ${objective} asks a stranger to act on first contact, so the ad alone must say what is offered and to whom.`
+    );
+  }
+  const countries = strings(asRecord(targeting.geo_locations)?.countries);
+  const market = marketOfCountries(countries);
+  if (market?.country === "global") {
+    reasons.push(
+      `Runs in ${countries.join(", ")}: one version for every market, with no country's places, money or faces.`
+    );
+  }
+  const placements = placementsOf(targeting);
+  if (placements.length === 0) {
+    reasons.push(
+      "Advantage+ placements: Meta picks the surface, so the ad must also work full-screen in Stories and Reels, not only in the feed."
+    );
+  }
+  return {
+    temperature: reached.temperature,
+    knows: reached.knows,
+    placements: placements.length > 0 ? placements : ["automatic"],
+    source: "targeting",
+    reasons,
+    ...market ? { market } : {}
+  };
+}
+var ASKS_TO_ACT = /^(OUTCOME_SALES|OUTCOME_LEADS|OUTCOME_APP_PROMOTION|CONVERSIONS|LEAD_GENERATION|PRODUCT_CATALOG_SALES)$/;
+function strings(value) {
+  return Array.isArray(value) ? value.filter((entry) => typeof entry === "string") : [];
+}
+function placementsOf(targeting) {
+  return strings(targeting.publisher_platforms).flatMap((platform) => {
+    const positions = strings(targeting[`${platform}_positions`]);
+    if (positions.length === 0) return [platform];
+    return positions.map((position) => {
+      const surface = platform === "instagram" && position === "stream" ? "feed" : position;
+      return surface.startsWith(`${platform}_`) ? surface : `${platform}_${surface}`;
+    });
+  });
+}
+function quoteNames(refs) {
+  return refs.map((ref) => `"${ref.name || ref.id}"`).join(", ");
+}
+function belowHot(tier) {
+  if (tier.temperature !== "hot") return tier;
+  return { temperature: "warm", knows: tier.knows.filter((known) => known !== "product") };
+}
+var WARMTH = { cold: 0, warm: 1, hot: 2 };
+function coldestOf(tiers) {
+  const [first, ...rest] = tiers;
+  if (!first) return COLD;
+  return rest.reduce(
+    (acc, tier) => ({
+      temperature: WARMTH[tier.temperature] < WARMTH[acc.temperature] ? tier.temperature : acc.temperature,
+      knows: acc.knows.filter((known) => tier.knows.includes(known))
+    }),
+    first
+  );
+}
+var AWARENESS_VALUES = ["unaware", "problem_aware", "solution_aware", "product_aware", "most_aware"];
+var BY_AWARENESS = {
+  unaware: COLD,
+  problem_aware: COLD,
+  solution_aware: COLD,
+  product_aware: { temperature: "warm", knows: ["brand", "offer"] },
+  most_aware: { temperature: "hot", knows: ["brand", "offer", "product"] }
+};
+var CUSTOMER_SEGMENT = /\b(existing|current|past|former|returning|repeat)\s+(customers?|clients?|buyers?|members?|subscribers?|users?)\b|\bclientes\s+(actuales|existentes)\b|\bantiguos\s+clientes\b/i;
+var CONTACT_SEGMENT = /\b(leads?|prospects?)\s+(who|that)\b|\b(site|website|web)\s+visitors\b|\babandon(ed|s)?\s+(carts?|checkouts?|forms?)\b|\btrial\s+users\b|\bvisitantes\b/i;
+function tierOfSegment(segment) {
+  if (CUSTOMER_SEGMENT.test(segment)) return { temperature: "hot", knows: ["brand", "offer", "product"] };
+  if (CONTACT_SEGMENT.test(segment)) return { temperature: "warm", knows: ["brand", "offer"] };
+  return void 0;
+}
+function viewerFromKnowledge(input) {
+  const reasons = ["No ad set to read, so this viewer comes from the Knowledge and the brief, not from targeting."];
+  let tier = COLD;
+  if (input.awareness) {
+    tier = BY_AWARENESS[input.awareness];
+    reasons.push(`The concept is written for a ${input.awareness.replace("_", "-")} viewer.`);
+  } else {
+    const warmed = input.personas.flatMap((segment) => {
+      const read = tierOfSegment(segment);
+      return read ? [{ segment, read }] : [];
+    });
+    if (warmed.length > 0 && warmed.length === input.personas.length) {
+      tier = coldestOf(warmed.map((entry) => entry.read));
+      reasons.push(
+        `The persona is defined by what they already did with the brand: ${warmed.map((entry) => `"${entry.segment}"`).join(", ")}.`
+      );
+    } else {
+      reasons.push("Nothing on file says the viewer knows the brand: design for a stranger.");
+    }
+  }
+  return { temperature: tier.temperature, knows: tier.knows, placements: ["automatic"], source: "knowledge", reasons };
+}
+
+export {
+  VIEWER_TEMPERATURE_VALUES,
+  VIEWER_KNOWS_VALUES,
+  VIEWER_SOURCE_VALUES,
+  marketFromCompanyDoc,
+  describeMarket,
+  marketCountryName,
+  classifyAudience,
+  AWARENESS_VALUES,
+  viewerFromKnowledge
+};
+//# sourceMappingURL=chunk-5HYSKH77.js.map

package/dist/chunk-5HYSKH77.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/viewer-profile.ts"],"sourcesContent":["import { asRecord } from \"./commands/ads/list-rows.ts\";\n\n/**\n * Who will see an ad, read off what the ad set actually targets rather than what\n * anyone hopes it targets — or, with no ad set, off the Knowledge and the brief.\n * `baker ads meta adsets --audience` prints it; a creative records it in its\n * `_definition.md` (`viewer`), and the viewer check plays it.\n */\n\nexport const VIEWER_TEMPERATURE_VALUES = [\"cold\", \"warm\", \"hot\"] as const;\nexport const VIEWER_KNOWS_VALUES = [\"brand\", \"offer\", \"product\"] as const;\nexport const VIEWER_SOURCE_VALUES = [\"targeting\", \"knowledge\"] as const;\n\nexport type ViewerTemperature = (typeof VIEWER_TEMPERATURE_VALUES)[number];\nexport type ViewerKnows = (typeof VIEWER_KNOWS_VALUES)[number];\n\n/**\n * Where the viewer lives and how they are spoken to (D1): the country (`global` for a version\n * that runs in several), the language variant, the currency and the form of address.\n */\nexport interface ViewerMarket {\n  country: string;\n  language?: string;\n  currency?: string;\n  address?: string;\n}\n\nexport interface ViewerProfile {\n  temperature: ViewerTemperature;\n  knows: ViewerKnows[];\n  placements: string[];\n  source: (typeof VIEWER_SOURCE_VALUES)[number];\n  reasons: string[];\n  /** Where they live: read off the ad set's countries, else COMPANY.md. */\n  market?: ViewerMarket;\n}\n\ntype MarketFacts = {\n  name: string;\n  names: RegExp;\n  language: string;\n  languageName: string;\n  currency: string;\n  address: string;\n};\n\n/** The markets our ads run in, with how an ad speaks there. A country not listed keeps its code alone. */\nconst MARKETS: Readonly<Record<string, MarketFacts>> = {\n  ES: {\n    name: \"Spain\",\n    names: /(?<![\\p{L}\\d])(spain|españa|espana)(?![\\p{L}\\d])/iu,\n    language: \"es-ES\",\n    languageName: \"Spanish from Spain\",\n    currency: \"EUR\",\n    address: \"tú\",\n  },\n  MX: {\n    name: \"Mexico\",\n    names: /(?<![\\p{L}\\d])(mexico|méxico)(?![\\p{L}\\d])/iu,\n    language: \"es-MX\",\n    languageName: \"Mexican Spanish\",\n    currency: \"MXN\",\n    address: \"tú\",\n  },\n  AR: {\n    name: \"Argentina\",\n    names: /(?<![\\p{L}\\d])(argentina)(?![\\p{L}\\d])/iu,\n    language: \"es-AR\",\n    languageName: \"Argentinian Spanish\",\n    currency: \"ARS\",\n    address: \"vos\",\n  },\n  CO: {\n    name: \"Colombia\",\n    names: /(?<![\\p{L}\\d])(colombia)(?![\\p{L}\\d])/iu,\n    language: \"es-CO\",\n    languageName: \"Colombian Spanish\",\n    currency: \"COP\",\n    address: \"tú\",\n  },\n  CL: {\n    name: \"Chile\",\n    names: /(?<![\\p{L}\\d])(chile)(?![\\p{L}\\d])/iu,\n    language: \"es-CL\",\n    languageName: \"Chilean Spanish\",\n    currency: \"CLP\",\n    address: \"tú\",\n  },\n  PE: {\n    name: \"Peru\",\n    names: /(?<![\\p{L}\\d])(peru|perú)(?![\\p{L}\\d])/iu,\n    language: \"es-PE\",\n    languageName: \"Peruvian Spanish\",\n    currency: \"PEN\",\n    address: \"tú\",\n  },\n  BR: {\n    name: \"Brazil\",\n    names: /(?<![\\p{L}\\d])(brazil|brasil)(?![\\p{L}\\d])/iu,\n    language: \"pt-BR\",\n    languageName: \"Brazilian Portuguese\",\n    currency: \"BRL\",\n    address: \"você\",\n  },\n  PT: {\n    name: \"Portugal\",\n    names: /(?<![\\p{L}\\d])(portugal)(?![\\p{L}\\d])/iu,\n    language: \"pt-PT\",\n    languageName: \"European Portuguese\",\n    currency: \"EUR\",\n    address: \"tu\",\n  },\n  GB: {\n    name: \"the United Kingdom\",\n    names: /(?<![\\p{L}\\d])(united kingdom|uk|britain|england)(?![\\p{L}\\d])/iu,\n    language: \"en-GB\",\n    languageName: \"British English\",\n    currency: \"GBP\",\n    address: \"you\",\n  },\n  IE: {\n    name: \"Ireland\",\n    names: /(?<![\\p{L}\\d])(ireland)(?![\\p{L}\\d])/iu,\n    language: \"en-IE\",\n    languageName: \"Irish English\",\n    currency: \"EUR\",\n    address: \"you\",\n  },\n  US: {\n    name: \"the United States\",\n    names: /(?<![\\p{L}\\d])(united states|usa|u\\.s\\.)(?![\\p{L}\\d])/iu,\n    language: \"en-US\",\n    languageName: \"American English\",\n    currency: \"USD\",\n    address: \"you\",\n  },\n  DE: {\n    name: \"Germany\",\n    names: /(?<![\\p{L}\\d])(germany|deutschland)(?![\\p{L}\\d])/iu,\n    language: \"de-DE\",\n    languageName: \"German\",\n    currency: \"EUR\",\n    address: \"du\",\n  },\n  FR: {\n    name: \"France\",\n    names: /(?<![\\p{L}\\d])(france)(?![\\p{L}\\d])/iu,\n    language: \"fr-FR\",\n    languageName: \"French\",\n    currency: \"EUR\",\n    address: \"vous\",\n  },\n  IT: {\n    name: \"Italy\",\n    names: /(?<![\\p{L}\\d])(italy|italia)(?![\\p{L}\\d])/iu,\n    language: \"it-IT\",\n    languageName: \"Italian\",\n    currency: \"EUR\",\n    address: \"tu\",\n  },\n};\n\n/**\n * The market an ad set's countries make: one country is its own market; several are one global\n * version in the campaign's language, with market-neutral people, places and money. Pure.\n */\nexport function marketOfCountries(countries: readonly string[]): ViewerMarket | undefined {\n  const codes = [...new Set(countries.map((c) => c.trim().toUpperCase()).filter(Boolean))];\n  if (codes.length === 0) return undefined;\n  if (codes.length > 1) return { country: \"global\" };\n  const code = codes[0] as string;\n  const facts = MARKETS[code];\n  return facts\n    ? { country: code, language: facts.language, currency: facts.currency, address: facts.address }\n    : { country: code };\n}\n\n/** The market COMPANY.md names on its market or geography line, when it names one. Pure. */\nexport function marketFromCompanyDoc(doc: string | null | undefined): ViewerMarket | undefined {\n  const line = (doc ?? \"\")\n    .split(\"\\n\")\n    .find((l) =>\n      /(?<![\\p{L}\\d])(markets?|geo|geograph\\w*|country|countries|país|paises|países|mercados?)(?![\\p{L}\\d])/iu.test(l),\n    );\n  if (!line) return undefined;\n  const found = Object.entries(MARKETS)\n    .filter(([, facts]) => facts.names.test(line))\n    .map(([code]) => code);\n  return marketOfCountries(found);\n}\n\n/** The market in the viewer's own terms, for a model that plays them. Pure. */\nexport function describeMarket(market: ViewerMarket): string {\n  if (market.country === \"global\") return \"a person in any of the countries the ad runs in\";\n  const facts = MARKETS[market.country];\n  const where = facts?.name ?? market.country;\n  const language = facts && market.language === facts.language ? facts.languageName : market.language;\n  return [\n    `a person living in ${where}`,\n    language ? ` who reads ${language} natively` : \"\",\n    market.currency ? `, pays in ${market.currency}` : \"\",\n    market.address ? ` and is spoken to as ${market.address}` : \"\",\n  ].join(\"\");\n}\n\n/** The country a market names, in words (\"Mexico\"); null for a global version. */\nexport function marketCountryName(market: ViewerMarket): string | null {\n  return market.country === \"global\" ? null : (MARKETS[market.country]?.name ?? market.country);\n}\n\nexport interface AdSetTargetingInput {\n  targeting?: unknown;\n}\n\nexport interface CustomAudienceInput {\n  id?: unknown;\n  name?: unknown;\n  subtype?: unknown;\n}\n\nexport interface CampaignInput {\n  objective?: unknown;\n}\n\nfunction text(value: unknown): string {\n  return typeof value === \"string\" ? value : \"\";\n}\n\n/** The `{ id, name }` entries of a targeting list such as `custom_audiences`. */\nfunction audienceRefs(value: unknown): Array<{ id: string; name: string }> {\n  if (!Array.isArray(value)) return [];\n  return value.flatMap((entry) => {\n    const ref = asRecord(entry);\n    const id = text(ref?.id);\n    return id ? [{ id, name: text(ref?.name) }] : [];\n  });\n}\n\n/** What one custom audience's members have already been through with the brand. */\ninterface AudienceTier {\n  temperature: ViewerTemperature;\n  knows: ViewerKnows[];\n}\n\ninterface AudienceRead extends AudienceTier {\n  /** Who its members are, in the words a reason prints. */\n  who: string;\n}\n\n/**\n * What an audience's NAME says its members are, as the decision model read it in the advertiser's\n * own language (`audience-names.ts`). A pixel or event audience's subtype says where its members\n * came from, not what they did: \"Purchasers 180d\" and \"All visitors 30d\" are both WEBSITE, and\n * the name is the one place an account records the event. Undefined when the name was not read.\n */\nexport type AudienceNameReading = (name: string) => { buyers: boolean; lookalike: boolean } | undefined;\n\nconst COLD: AudienceTier = { temperature: \"cold\", knows: [] };\n\nfunction tierOf(\n  audience: CustomAudienceInput | undefined,\n  ref: { name: string },\n  readName: AudienceNameReading | undefined,\n): AudienceRead {\n  const subtype = text(audience?.subtype).toUpperCase();\n  const name = text(audience?.name) || ref.name;\n  const read = readName?.(name);\n  // Meta names a lookalike after its seed (\"Lookalike (GB, 1%) - Purchasers\"), so it is ruled out before the name is read.\n  if (subtype === \"LOOKALIKE\" || (!subtype && read?.lookalike)) {\n    return { ...COLD, who: \"a lookalike: strangers who resemble the seed\" };\n  }\n  if (read?.buyers) return { temperature: \"hot\", knows: [\"brand\", \"offer\", \"product\"], who: \"buyers\" };\n  if (subtype === \"WEBSITE\") return { temperature: \"warm\", knows: [\"brand\", \"offer\"], who: \"site visitors\" };\n  if (subtype === \"CUSTOM\") {\n    return { temperature: \"hot\", knows: [\"brand\", \"offer\", \"product\"], who: \"an uploaded customer list\" };\n  }\n  // Every other custom audience is people who met the brand somewhere: a Page, a profile, a video, the app.\n  return { temperature: \"warm\", knows: [\"brand\"], who: \"people who engaged with the brand\" };\n}\n\nexport function classifyAudience(\n  adSet: AdSetTargetingInput,\n  audiences: readonly CustomAudienceInput[],\n  campaign: CampaignInput | undefined,\n  readName?: AudienceNameReading,\n): ViewerProfile {\n  const targeting = asRecord(adSet.targeting) ?? {};\n  const byId = new Map(audiences.map((audience) => [text(audience.id), audience]));\n  const includedRefs = audienceRefs(targeting.custom_audiences);\n  const included = includedRefs.map((ref) => tierOf(byId.get(ref.id), ref, readName));\n  const reasons: string[] = [\n    includedRefs.length === 0\n      ? \"No custom audience: Meta finds new people from age, place and interests, so every viewer is a stranger.\"\n      : `Reaches ${includedRefs.map((ref, i) => `\"${ref.name || ref.id}\" (${included[i]?.who})`).join(\", \")}.`,\n  ];\n  const unlisted = includedRefs.filter((ref) => !byId.has(ref.id));\n  if (unlisted.length > 0) {\n    reasons.push(`${quoteNames(unlisted)} is not in this account's audience list, so it was read from its name alone.`);\n  }\n  let reached = coldestOf(included);\n  if (asRecord(targeting.targeting_automation)?.advantage_audience === 1 && included.length > 0) {\n    reached = belowHot(reached);\n    reasons.push(\n      \"Advantage+ audience treats the chosen audiences as suggestions and reaches past them, so part of the delivery goes to people who have never bought.\",\n    );\n  }\n  const excludedRefs = audienceRefs(targeting.excluded_custom_audiences);\n  if (excludedRefs.length > 0) reasons.push(`Keeps out ${quoteNames(excludedRefs)}.`);\n  if (excludedRefs.some((ref) => tierOf(byId.get(ref.id), ref, readName).temperature === \"hot\")) {\n    reached = belowHot(reached);\n    reasons.push(\"Buyers are excluded, so nobody reached has used the product.\");\n  }\n  const objective = text(campaign?.objective);\n  if (reached.temperature === \"cold\" && ASKS_TO_ACT.test(objective)) {\n    reasons.push(\n      `Campaign objective ${objective} asks a stranger to act on first contact, so the ad alone must say what is offered and to whom.`,\n    );\n  }\n  const countries = strings(asRecord(targeting.geo_locations)?.countries);\n  const market = marketOfCountries(countries);\n  if (market?.country === \"global\") {\n    reasons.push(\n      `Runs in ${countries.join(\", \")}: one version for every market, with no country's places, money or faces.`,\n    );\n  }\n  const placements = placementsOf(targeting);\n  if (placements.length === 0) {\n    reasons.push(\n      \"Advantage+ placements: Meta picks the surface, so the ad must also work full-screen in Stories and Reels, not only in the feed.\",\n    );\n  }\n  return {\n    temperature: reached.temperature,\n    knows: reached.knows,\n    placements: placements.length > 0 ? placements : [\"automatic\"],\n    source: \"targeting\",\n    reasons,\n    ...(market ? { market } : {}),\n  };\n}\n\n/**\n * The objective says what the campaign wants from a viewer, never who the viewer is:\n * a conversion campaign on broad targeting still meets strangers. So it adds a reason\n * and never moves the temperature.\n */\nconst ASKS_TO_ACT =\n  /^(OUTCOME_SALES|OUTCOME_LEADS|OUTCOME_APP_PROMOTION|CONVERSIONS|LEAD_GENERATION|PRODUCT_CATALOG_SALES)$/;\n\nfunction strings(value: unknown): string[] {\n  return Array.isArray(value) ? value.filter((entry): entry is string => typeof entry === \"string\") : [];\n}\n\n/**\n * `instagram_positions` calls the feed `stream` and Facebook's Reels are already\n * `facebook_reels`; one `<platform>_<surface>` spelling reads the same for both.\n */\nfunction placementsOf(targeting: Record<string, unknown>): string[] {\n  return strings(targeting.publisher_platforms).flatMap((platform) => {\n    const positions = strings(targeting[`${platform}_positions`]);\n    // A platform with no positions of its own is every surface on it.\n    if (positions.length === 0) return [platform];\n    return positions.map((position) => {\n      const surface = platform === \"instagram\" && position === \"stream\" ? \"feed\" : position;\n      return surface.startsWith(`${platform}_`) ? surface : `${platform}_${surface}`;\n    });\n  });\n}\n\nfunction quoteNames(refs: ReadonlyArray<{ id: string; name: string }>): string {\n  return refs.map((ref) => `\"${ref.name || ref.id}\"`).join(\", \");\n}\n\n/** Only buyers know the product itself; anyone short of that knows at most the brand and its offer. */\nfunction belowHot(tier: AudienceTier): AudienceTier {\n  if (tier.temperature !== \"hot\") return tier;\n  return { temperature: \"warm\", knows: tier.knows.filter((known) => known !== \"product\") };\n}\n\nconst WARMTH: Record<ViewerTemperature, number> = { cold: 0, warm: 1, hot: 2 };\n\n/**\n * Meta delivers to anyone in ANY included audience, so the ad has to work on the\n * coldest of them, and it can only lean on what every one of them already knows.\n */\nfunction coldestOf(tiers: readonly AudienceTier[]): AudienceTier {\n  const [first, ...rest] = tiers;\n  if (!first) return COLD;\n  return rest.reduce<AudienceTier>(\n    (acc, tier) => ({\n      temperature: WARMTH[tier.temperature] < WARMTH[acc.temperature] ? tier.temperature : acc.temperature,\n      knows: acc.knows.filter((known) => tier.knows.includes(known)),\n    }),\n    first,\n  );\n}\n\n/** The awareness stages a creative's `awareness` field takes (the scaffold `creatives` collection). */\nexport const AWARENESS_VALUES = [\"unaware\", \"problem_aware\", \"solution_aware\", \"product_aware\", \"most_aware\"] as const;\n\nexport type Awareness = (typeof AWARENESS_VALUES)[number];\n\n/** Until a viewer is aware of the product, they know nothing of the brand behind it either. */\nconst BY_AWARENESS: Record<Awareness, AudienceTier> = {\n  unaware: COLD,\n  problem_aware: COLD,\n  solution_aware: COLD,\n  product_aware: { temperature: \"warm\", knows: [\"brand\", \"offer\"] },\n  most_aware: { temperature: \"hot\", knows: [\"brand\", \"offer\", \"product\"] },\n};\n\n/**\n * A persona segment says what the viewer already did with the brand only when it is\n * defined by it (\"Existing customers up for renewal\", \"Leads who went quiet\"). Phrases,\n * not words: \"Marketing leads at SaaS firms\" are job titles, not leads.\n */\nconst CUSTOMER_SEGMENT =\n  /\\b(existing|current|past|former|returning|repeat)\\s+(customers?|clients?|buyers?|members?|subscribers?|users?)\\b|\\bclientes\\s+(actuales|existentes)\\b|\\bantiguos\\s+clientes\\b/i;\nconst CONTACT_SEGMENT =\n  /\\b(leads?|prospects?)\\s+(who|that)\\b|\\b(site|website|web)\\s+visitors\\b|\\babandon(ed|s)?\\s+(carts?|checkouts?|forms?)\\b|\\btrial\\s+users\\b|\\bvisitantes\\b/i;\n\nfunction tierOfSegment(segment: string): AudienceTier | undefined {\n  if (CUSTOMER_SEGMENT.test(segment)) return { temperature: \"hot\", knows: [\"brand\", \"offer\", \"product\"] };\n  if (CONTACT_SEGMENT.test(segment)) return { temperature: \"warm\", knows: [\"brand\", \"offer\"] };\n  return undefined;\n}\n\nexport interface KnowledgeViewerInput {\n  /** The segment line (frontmatter `segment`, else the title) of each persona the ad is for. */\n  personas: readonly string[];\n  /** The awareness stage the concept was written for, when the brief set one. */\n  awareness?: Awareness;\n}\n\n/**\n * The viewer when there is no ad set to read. The Knowledge describes who a persona\n * is, almost never what they already know about the brand, so the stranger is the\n * default and only an explicit signal warms it.\n */\nexport function viewerFromKnowledge(input: KnowledgeViewerInput): ViewerProfile {\n  const reasons = [\"No ad set to read, so this viewer comes from the Knowledge and the brief, not from targeting.\"];\n  let tier = COLD;\n  if (input.awareness) {\n    tier = BY_AWARENESS[input.awareness];\n    reasons.push(`The concept is written for a ${input.awareness.replace(\"_\", \"-\")} viewer.`);\n  } else {\n    const warmed = input.personas.flatMap((segment) => {\n      const read = tierOfSegment(segment);\n      return read ? [{ segment, read }] : [];\n    });\n    if (warmed.length > 0 && warmed.length === input.personas.length) {\n      tier = coldestOf(warmed.map((entry) => entry.read));\n      reasons.push(\n        `The persona is defined by what they already did with the brand: ${warmed.map((entry) => `\"${entry.segment}\"`).join(\", \")}.`,\n      );\n    } else {\n      reasons.push(\"Nothing on file says the viewer knows the brand: design for a stranger.\");\n    }\n  }\n  return { temperature: tier.temperature, knows: tier.knows, placements: [\"automatic\"], source: \"knowledge\", reasons };\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-5Z2KSVIV.js

@@ -0,0 +1,67 @@
+import {
+  parseXApiError
+} from "./chunk-M6UNISGO.js";
+import {
+  cacheGet,
+  cacheSet,
+  writeAdsJson,
+  writeAdsOutput
+} from "./chunk-VFIOJD5M.js";
+import {
+  ApiError,
+  apiGet
+} from "./chunk-XBOK23HI.js";
+
+// src/commands/ads/x/run-list.ts
+function buildCleanParams(opts) {
+  const out = {};
+  for (const [k, v] of Object.entries(opts.params)) {
+    if (v !== void 0 && v !== "") {
+      out[k] = v;
+    }
+  }
+  if (!opts.useCache) {
+    out["skip-cache"] = "true";
+  }
+  return out;
+}
+function emitFromCache(opts) {
+  if (!opts.useCache || opts.cacheTtlMs === void 0) return false;
+  const cached = cacheGet(opts.cacheCategory, opts.cacheKey);
+  if (!cached) return false;
+  writeAdsJson({ ok: true, data: cached.data, cached: true });
+  return true;
+}
+function emitData(opts, data) {
+  if (opts.format !== "json") {
+    writeAdsOutput(data, opts.format);
+    return;
+  }
+  writeAdsJson({ ok: true, data });
+}
+function emitError(opts, err) {
+  if (err instanceof ApiError) {
+    writeAdsJson(parseXApiError(err.message, opts.accountId ?? "\u2014"));
+    process.exit(1);
+  }
+  writeAdsJson({ ok: false, error: { code: "NETWORK_ERROR", message: "Unexpected error" } });
+  process.exit(1);
+}
+async function runListCommand(opts) {
+  if (emitFromCache(opts)) return;
+  const params = buildCleanParams(opts);
+  try {
+    const data = await apiGet(opts.path, params);
+    if (opts.useCache && opts.cacheTtlMs !== void 0) {
+      cacheSet(opts.cacheCategory, opts.cacheKey, data, opts.cacheTtlMs);
+    }
+    emitData(opts, data);
+  } catch (err) {
+    emitError(opts, err);
+  }
+}
+
+export {
+  runListCommand
+};
+//# sourceMappingURL=chunk-5Z2KSVIV.js.map