@koda-sl/baker-cli 0.489.0 → 0.491.0

package/dist/chunk-2C7AHPM4.js

@@ -0,0 +1,191 @@
+import {
+  writeAdsOutput
+} from "./chunk-SWL4AAPP.js";
+import {
+  asRecord,
+  shapeListRows
+} from "./chunk-65Y3RCWP.js";
+import {
+  registerSchema
+} from "./chunk-WNSE7N75.js";
+
+// src/commands/ads/meta/list-rows.ts
+function pick(row, keys) {
+  const picked = {};
+  for (const key of keys) {
+    if (row[key] !== void 0) picked[key] = row[key];
+  }
+  return picked;
+}
+var CAMPAIGN_COLUMNS = ["id", "name", "effective_status", "daily_budget", "lifetime_budget", "created_date"];
+var DIAGNOSTIC_COLUMNS = ["issues", "suggestions"];
+function compactCampaign(row) {
+  const created = row.created_time;
+  return {
+    ...pick(row, ["id", "name", "effective_status", "daily_budget", "lifetime_budget"]),
+    ...typeof created === "string" ? { created_date: created.slice(0, 10) } : {},
+    ...diagnostics(row)
+  };
+}
+var ADSET_KEYS = [
+  "id",
+  "name",
+  "campaign_id",
+  "effective_status",
+  "optimization_goal",
+  "billing_event",
+  "bid_strategy",
+  "daily_budget",
+  "lifetime_budget",
+  "destination_type",
+  // A Dynamic Creative ad set refuses every new ad, which changes the plan before anything is staged.
+  "is_dynamic_creative"
+];
+var ADSET_COLUMNS = [...ADSET_KEYS, "learning_stage", "end_time", "created_time"];
+function compactAdSet(row) {
+  const learning = asRecord(row.learning_stage_info)?.status;
+  return {
+    ...pick(row, ADSET_KEYS),
+    ...typeof learning === "string" ? { learning_stage: learning } : {},
+    ...pick(row, ["end_time", "created_time"]),
+    ...diagnostics(row)
+  };
+}
+var AD_COLUMNS = [
+  "id",
+  "name",
+  "adset_id",
+  "campaign_id",
+  "effective_status",
+  "creative_id",
+  "issues",
+  "created_time"
+];
+function adIssues(value) {
+  if (!Array.isArray(value)) return [];
+  return value.flatMap((entry) => {
+    const issue = asRecord(entry);
+    const text = issue?.error_summary ?? issue?.error_message;
+    return typeof text === "string" && text ? [text] : [];
+  });
+}
+function suggestions(value) {
+  if (!Array.isArray(value)) return [];
+  return value.flatMap((entry) => {
+    const recommendation = asRecord(entry);
+    const text = recommendation?.title ?? recommendation?.message;
+    return typeof text === "string" && text ? [text] : [];
+  });
+}
+function diagnostics(row) {
+  const issues = adIssues(row.issues_info);
+  const suggested = suggestions(row.recommendations);
+  return {
+    ...issues.length > 0 ? { issues } : {},
+    ...suggested.length > 0 ? { suggestions: suggested } : {}
+  };
+}
+function compactAd(row) {
+  const creativeId = asRecord(row.creative)?.id;
+  const issues = adIssues(row.issues_info);
+  return {
+    ...pick(row, ["id", "name", "adset_id", "campaign_id", "effective_status"]),
+    ...creativeId !== void 0 ? { creative_id: creativeId } : {},
+    ...issues.length > 0 ? { issues } : {},
+    ...pick(row, ["created_time"])
+  };
+}
+var ACTIVITY_COLUMNS = [
+  "event_time",
+  "event_type",
+  "actor_name",
+  "object_type",
+  "object_name",
+  "object_id",
+  "change"
+];
+function isScalar(value) {
+  return value === null || typeof value === "string" || typeof value === "number";
+}
+function activityChange(extraData) {
+  if (typeof extraData !== "string") return void 0;
+  let parsed;
+  try {
+    parsed = JSON.parse(extraData);
+  } catch {
+    return void 0;
+  }
+  const data = asRecord(parsed);
+  if (!data || !("new_value" in data) || !("old_value" in data)) return void 0;
+  const { old_value: before, new_value: after } = data;
+  if (!isScalar(before) || !isScalar(after)) return void 0;
+  const show = (value) => value === null ? "(none)" : String(value);
+  return `${show(before)} \u2192 ${show(after)}`;
+}
+function compactActivity(row) {
+  const change = activityChange(row.extra_data);
+  return {
+    ...pick(row, ["event_time", "event_type", "actor_name", "object_type", "object_name", "object_id"]),
+    ...change !== void 0 ? { change } : {}
+  };
+}
+var PROJECTIONS = {
+  campaigns: { row: compactCampaign, columns: CAMPAIGN_COLUMNS, whenPresent: DIAGNOSTIC_COLUMNS },
+  adsets: { row: compactAdSet, columns: ADSET_COLUMNS, whenPresent: DIAGNOSTIC_COLUMNS },
+  ads: { row: compactAd, columns: AD_COLUMNS },
+  activities: { row: compactActivity, columns: ACTIVITY_COLUMNS }
+};
+function shapeMetaListRows(kind, rows, args) {
+  return shapeListRows(rows, args, PROJECTIONS[kind]);
+}
+var NOUNS = {
+  campaigns: "campaigns",
+  adsets: "ad sets",
+  ads: "ads",
+  activities: "activities"
+};
+function writeMetaListRows(kind, shaped, format, hints = []) {
+  if (format === "md" && shaped.rows.length === 0) {
+    process.stdout.write(`${hints.length > 0 ? hints.join("\n") : `No ${NOUNS[kind]} matched.`}
+`);
+    return;
+  }
+  writeAdsOutput(shaped.rows, format, shaped.fields, [...hints, ...shaped.hints ?? []]);
+}
+var META_LIST_SHAPE_ARGS = {
+  fields: {
+    type: "string",
+    description: "CSV of dotted paths to return instead of the compact row, e.g. id,name,targeting.geo_locations"
+  },
+  full: { type: "boolean", description: "Return every field Meta sent (targeting, tracking specs, raw extra_data)" },
+  output: {
+    type: "string",
+    description: "md|json|csv|jsonl \u2014 md (default) prints a table; json returns the rows in the { ok, data } envelope",
+    default: "md"
+  }
+};
+function registerMetaListSchema(kind, description, args) {
+  registerSchema({
+    command: `ads.meta.${kind}`,
+    description,
+    args: Object.fromEntries(
+      Object.entries(args).map(([name, def]) => [
+        name,
+        {
+          type: def.type,
+          description: def.description ?? "",
+          required: false,
+          ...def.default !== void 0 ? { default: def.default } : {}
+        }
+      ])
+    )
+  });
+}
+
+export {
+  shapeMetaListRows,
+  writeMetaListRows,
+  META_LIST_SHAPE_ARGS,
+  registerMetaListSchema
+};
+//# sourceMappingURL=chunk-2C7AHPM4.js.map

package/dist/chunk-2C7AHPM4.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/meta/list-rows.ts"],"sourcesContent":["import { registerSchema } from \"../../../schemas.ts\";\nimport { asRecord, type CompactProjection, type ShapedRows, shapeListRows } from \"../list-rows.ts\";\nimport { writeAdsOutput } from \"../output.ts\";\n\n/**\n * The compact row of each Meta listing. The backend asks Graph for every field a\n * write or an audit might need (targeting, tracking specs, three status fields),\n * and 100 campaigns or two days of activity passed through whole ran to 55–78 KB.\n * A compact row carries what an agent decides with; `--fields` reaches any other\n * path and `--full` returns the record Graph sent.\n *\n * `effective_status` is the one status kept: it is what Ads Manager shows, and\n * `status`/`configured_status` only restate the toggle it already folds in.\n *\n * Listings print a table by default: keyed JSON repeats every column name on\n * every row, and 100 campaigns stayed near 30 KB even compact. `--output json`\n * returns the same rows in the envelope.\n */\n\ntype MetaRow = Record<string, unknown>;\n\nexport type MetaListKind = \"campaigns\" | \"adsets\" | \"ads\" | \"activities\";\n\nfunction pick(row: MetaRow, keys: readonly string[]): MetaRow {\n  const picked: MetaRow = {};\n  for (const key of keys) {\n    if (row[key] !== undefined) picked[key] = row[key];\n  }\n  return picked;\n}\n\n/**\n * An account's campaign list is the widest listing an agent reads (100+ rows), so\n * its row is the narrowest: what a campaign is called, whether it runs and what\n * it spends. Objective, bid strategy and Special Ad Category are one `--fields`\n * away; the creation day is enough to order by, and `--fields created_time` has\n * the timestamp.\n */\nconst CAMPAIGN_COLUMNS = [\"id\", \"name\", \"effective_status\", \"daily_budget\", \"lifetime_budget\", \"created_date\"] as const;\n\n/** Why delivery stops and what Meta suggests: columns only when a row has one. */\nconst DIAGNOSTIC_COLUMNS = [\"issues\", \"suggestions\"] as const;\n\nfunction compactCampaign(row: MetaRow): MetaRow {\n  const created = row.created_time;\n  return {\n    ...pick(row, [\"id\", \"name\", \"effective_status\", \"daily_budget\", \"lifetime_budget\"]),\n    ...(typeof created === \"string\" ? { created_date: created.slice(0, 10) } : {}),\n    ...diagnostics(row),\n  };\n}\n\nconst ADSET_KEYS = [\n  \"id\",\n  \"name\",\n  \"campaign_id\",\n  \"effective_status\",\n  \"optimization_goal\",\n  \"billing_event\",\n  \"bid_strategy\",\n  \"daily_budget\",\n  \"lifetime_budget\",\n  \"destination_type\",\n  // A Dynamic Creative ad set refuses every new ad, which changes the plan before anything is staged.\n  \"is_dynamic_creative\",\n] as const;\n\nconst ADSET_COLUMNS = [...ADSET_KEYS, \"learning_stage\", \"end_time\", \"created_time\"] as const;\n\nfunction compactAdSet(row: MetaRow): MetaRow {\n  const learning = asRecord(row.learning_stage_info)?.status;\n  return {\n    ...pick(row, ADSET_KEYS),\n    ...(typeof learning === \"string\" ? { learning_stage: learning } : {}),\n    ...pick(row, [\"end_time\", \"created_time\"]),\n    ...diagnostics(row),\n  };\n}\n\nconst AD_COLUMNS = [\n  \"id\",\n  \"name\",\n  \"adset_id\",\n  \"campaign_id\",\n  \"effective_status\",\n  \"creative_id\",\n  \"issues\",\n  \"created_time\",\n] as const;\n\n/** Why an ad is WITH_ISSUES — the one reason to open `issues_info`, in its own words. */\nfunction adIssues(value: unknown): string[] {\n  if (!Array.isArray(value)) return [];\n  return value.flatMap((entry) => {\n    const issue = asRecord(entry);\n    const text = issue?.error_summary ?? issue?.error_message;\n    return typeof text === \"string\" && text ? [text] : [];\n  });\n}\n\n/** Meta's suggestions for a campaign or ad set (`recommendations`), by their titles. */\nfunction suggestions(value: unknown): string[] {\n  if (!Array.isArray(value)) return [];\n  return value.flatMap((entry) => {\n    const recommendation = asRecord(entry);\n    const text = recommendation?.title ?? recommendation?.message;\n    return typeof text === \"string\" && text ? [text] : [];\n  });\n}\n\n/** Why a campaign or ad set cannot deliver, and what Meta suggests — only when Meta says something. */\nfunction diagnostics(row: MetaRow): MetaRow {\n  const issues = adIssues(row.issues_info);\n  const suggested = suggestions(row.recommendations);\n  return {\n    ...(issues.length > 0 ? { issues } : {}),\n    ...(suggested.length > 0 ? { suggestions: suggested } : {}),\n  };\n}\n\nfunction compactAd(row: MetaRow): MetaRow {\n  const creativeId = asRecord(row.creative)?.id;\n  const issues = adIssues(row.issues_info);\n  return {\n    ...pick(row, [\"id\", \"name\", \"adset_id\", \"campaign_id\", \"effective_status\"]),\n    ...(creativeId !== undefined ? { creative_id: creativeId } : {}),\n    ...(issues.length > 0 ? { issues } : {}),\n    ...pick(row, [\"created_time\"]),\n  };\n}\n\nconst ACTIVITY_COLUMNS = [\n  \"event_time\",\n  \"event_type\",\n  \"actor_name\",\n  \"object_type\",\n  \"object_name\",\n  \"object_id\",\n  \"change\",\n] as const;\n\nfunction isScalar(value: unknown): value is string | number | null {\n  return value === null || typeof value === \"string\" || typeof value === \"number\";\n}\n\n/**\n * `extra_data` is a JSON string whose shape varies by event type and carries most\n * of an activity's bytes (image URLs, whole targeting specs). A status, name,\n * budget or goal change stores its before and after as two plain values — those\n * read as one line; any richer change stays behind `--fields extra_data`.\n */\nexport function activityChange(extraData: unknown): string | undefined {\n  if (typeof extraData !== \"string\") return undefined;\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(extraData);\n  } catch {\n    return undefined;\n  }\n  const data = asRecord(parsed);\n  // An absent old_value is one this read did not observe, not an unset one — only `null` means \"none\".\n  if (!data || !(\"new_value\" in data) || !(\"old_value\" in data)) return undefined;\n  const { old_value: before, new_value: after } = data;\n  if (!isScalar(before) || !isScalar(after)) return undefined;\n  const show = (value: string | number | null) => (value === null ? \"(none)\" : String(value));\n  return `${show(before)} → ${show(after)}`;\n}\n\nfunction compactActivity(row: MetaRow): MetaRow {\n  const change = activityChange(row.extra_data);\n  return {\n    ...pick(row, [\"event_time\", \"event_type\", \"actor_name\", \"object_type\", \"object_name\", \"object_id\"]),\n    ...(change !== undefined ? { change } : {}),\n  };\n}\n\nconst PROJECTIONS: Record<MetaListKind, CompactProjection<MetaRow>> = {\n  campaigns: { row: compactCampaign, columns: CAMPAIGN_COLUMNS, whenPresent: DIAGNOSTIC_COLUMNS },\n  adsets: { row: compactAdSet, columns: ADSET_COLUMNS, whenPresent: DIAGNOSTIC_COLUMNS },\n  ads: { row: compactAd, columns: AD_COLUMNS },\n  activities: { row: compactActivity, columns: ACTIVITY_COLUMNS },\n};\n\nexport function shapeMetaListRows(kind: MetaListKind, rows: MetaRow[], args: Record<string, unknown>): ShapedRows {\n  return shapeListRows(rows, args, PROJECTIONS[kind]);\n}\n\nconst NOUNS: Record<MetaListKind, string> = {\n  campaigns: \"campaigns\",\n  adsets: \"ad sets\",\n  ads: \"ads\",\n  activities: \"activities\",\n};\n\n/**\n * A table of no rows prints nothing at all, which reads as a failed call — so an empty\n * listing says so, and says why when a status filter may be hiding rows.\n */\nexport function writeMetaListRows(kind: MetaListKind, shaped: ShapedRows, format: string, hints: string[] = []): void {\n  if (format === \"md\" && shaped.rows.length === 0) {\n    process.stdout.write(`${hints.length > 0 ? hints.join(\"\\n\") : `No ${NOUNS[kind]} matched.`}\\n`);\n    return;\n  }\n  writeAdsOutput(shaped.rows, format, shaped.fields, [...hints, ...(shaped.hints ?? [])]);\n}\n\n/** The projection flags every Meta listing shares, worded once for help and `baker schema`. */\nexport const META_LIST_SHAPE_ARGS = {\n  fields: {\n    type: \"string\",\n    description: \"CSV of dotted paths to return instead of the compact row, e.g. id,name,targeting.geo_locations\",\n  },\n  full: { type: \"boolean\", description: \"Return every field Meta sent (targeting, tracking specs, raw extra_data)\" },\n  output: {\n    type: \"string\",\n    description: \"md|json|csv|jsonl — md (default) prints a table; json returns the rows in the { ok, data } envelope\",\n    default: \"md\",\n  },\n} as const;\n\ninterface ListArgDef {\n  type: string;\n  description?: string;\n  default?: unknown;\n}\n\n/**\n * `baker schema ads.meta.<list>`, read off the same arg defs the command parses,\n * so the introspection an agent checks before a call cannot promise a flag the\n * command refuses — `--full` on `adsets` was guessed three times in one Session.\n */\nexport function registerMetaListSchema(\n  kind: MetaListKind,\n  description: string,\n  args: Record<string, ListArgDef>,\n): void {\n  registerSchema({\n    command: `ads.meta.${kind}`,\n    description,\n    args: Object.fromEntries(\n      Object.entries(args).map(([name, def]) => [\n        name,\n        {\n          type: def.type,\n          description: def.description ?? \"\",\n          required: false,\n          ...(def.default !== undefined ? { default: def.default } : {}),\n        },\n      ]),\n    ),\n  });\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-2WZI36D3.js

@@ -0,0 +1,317 @@
+import {
+  asRecord
+} from "./chunk-65Y3RCWP.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 marketLine = /(?<![\p{L}\d])(markets?|geo|geograph\w*|country|countries|país|paises|países|mercados?|marchés?|pays|\w*markt|mercato|mercati|paese)(?![\p{L}\d])/iu;
+  for (const line of (doc ?? "").split("\n")) {
+    if (!marketLine.test(line)) continue;
+    const found = Object.entries(MARKETS).filter(([, facts]) => facts.names.test(line)).map(([code]) => code);
+    const market = marketOfCountries(found);
+    if (market) return market;
+  }
+  return void 0;
+}
+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-2WZI36D3.js.map