@koda-sl/baker-cli 0.481.0-dev.2d33e194f → 0.482.0-dev.a5555ab55

package/dist/chunk-KPYDTIAI.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 first market or geography line that names a country. Pure. */\nexport function marketFromCompanyDoc(doc: string | null | undefined): ViewerMarket | undefined {\n  const marketLine =\n    /(?<![\\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;\n  for (const line of (doc ?? \"\").split(\"\\n\")) {\n    if (!marketLine.test(line)) continue;\n    const found = Object.entries(MARKETS)\n      .filter(([, facts]) => facts.names.test(line))\n      .map(([code]) => code);\n    const market = marketOfCountries(found);\n    if (market) return market;\n  }\n  return undefined;\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-KXSXZAC2.js

@@ -0,0 +1,225 @@
+import {
+  BRAND_DIR,
+  inkLuma,
+  logoArtwork
+} from "./chunk-QTLZXIF3.js";
+import {
+  fetchExternalBytes
+} from "./chunk-BLAHHMPF.js";
+import {
+  apiGet,
+  apiPost
+} from "./chunk-XDZVBX6L.js";
+
+// src/commands/canvas/clientLogo.ts
+import { mkdir, readFile, writeFile } from "fs/promises";
+import * as cheerio from "cheerio";
+import path from "path";
+function decideClientLogo(domain, lookup) {
+  if (!domain) return { use: false, reason: "no_domain" };
+  const verdict = lookup?.brandMatch?.verdict;
+  if (verdict === "mismatch") {
+    return { use: false, reason: "mismatch", ...lookup?.brandMatch?.name ? { wrongBrand: lookup.brandMatch.name } : {} };
+  }
+  if (verdict !== "confirmed") return { use: false, reason: "unverified" };
+  const url = lookup?.hits?.map((hit) => hit.imageUrl ?? hit.sourceUrl).find((candidate) => Boolean(candidate));
+  return url ? { use: true, url } : { use: false, reason: "no_hits" };
+}
+function clientLogoMissNote(decision, domain) {
+  switch (decision.reason) {
+    case "no_domain":
+      return "Baker has no website on record for this company, so their mark could not be looked up.";
+    case "mismatch":
+      return `The mark found for \`${domain}\` belongs to ${decision.wrongBrand ?? "a different company"}, not to this client, so it was not used.`;
+    default:
+      return `No brand mark could be confirmed for \`${domain}\`, so nothing was placed.`;
+  }
+}
+function hostOf(site) {
+  try {
+    return new URL(/^https?:\/\//i.test(site) ? site : `https://${site}`).hostname.replace(/^www\./i, "").toLowerCase();
+  } catch {
+    return null;
+  }
+}
+var NOT_THE_LOGO = /favicon|apple-touch|sprite|(?:^|[/_.-])icons?(?:[/_.-]|$)|client|customer|partner|testimonial|trust|badge|award/i;
+function sayings(hit, url) {
+  const meta = hit.providerMeta ?? {};
+  const given = ["alt", "class", "id", "title"].map((key) => typeof meta[key] === "string" ? meta[key] : "");
+  return [new URL(url).pathname, hit.name ?? "", hit.description ?? "", ...given].join(" ");
+}
+function logoFromExtract(hits, domain) {
+  const own = hostOf(domain);
+  if (!own) return null;
+  const candidates = hits.flatMap((hit) => {
+    const url = hit.url ?? hit.imageUrl ?? hit.sourceUrl;
+    const host = url ? hostOf(url) : null;
+    if (!url || !host || host !== own && !host.endsWith(`.${own}`)) return [];
+    const said = sayings(hit, url);
+    if (!/logo/i.test(said) || NOT_THE_LOGO.test(said)) return [];
+    return [{ url, score: (/\.svg(?:\?|$)/i.test(url) ? 2 : 0) + (/logo/i.test(new URL(url).pathname) ? 1 : 0) }];
+  });
+  candidates.sort((a, b) => b.score - a.score || a.url.length - b.url.length);
+  return candidates[0]?.url ?? null;
+}
+var MAX_INLINE_SVG = 3e5;
+var BRAND_PLACES = "header, nav, [role=banner]";
+var IMAGE_ADDRESS = ["src", "data-src", "data-lazy-src", "data-original"];
+function logoFromPage(html, pageUrl, domain) {
+  const own = hostOf(domain);
+  if (!own) return null;
+  const $ = cheerio.load(html);
+  for (const el of $(`${BRAND_PLACES}`).find("img, svg").toArray()) {
+    const node = $(el);
+    const said = [node, node.closest("a")].flatMap((n) => ["class", "id", "alt", "aria-label", "title"].map((k) => n.attr(k) ?? "")).join(" ");
+    if (!/logo/i.test(said) || NOT_THE_LOGO.test(said)) continue;
+    if (el.tagName === "svg") {
+      const svg = standaloneSvg($, node);
+      if (svg) return { kind: "svg", svg };
+      continue;
+    }
+    const url = IMAGE_ADDRESS.map((k) => node.attr(k)?.trim() ?? "").filter((a) => a !== "" && !a.startsWith("data:")).map((a) => absolute(a, pageUrl)).find((a) => a !== null);
+    const host = url ? hostOf(url) : null;
+    if (url && host && (host === own || host.endsWith(`.${own}`))) return { kind: "url", url };
+  }
+  return null;
+}
+function absolute(address, base) {
+  try {
+    const url = new URL(address, base);
+    return /^https?:$/.test(url.protocol) ? url.href : null;
+  } catch {
+    return null;
+  }
+}
+function standaloneSvg($, node) {
+  const draws = node.find("path, circle, rect, polygon, polyline, ellipse, line, text").length > 0;
+  if (!draws || node.find("use").length > 0) return null;
+  const copy = node.clone();
+  if (!copy.attr("xmlns")) copy.attr("xmlns", "http://www.w3.org/2000/svg");
+  const svg = $.html(copy);
+  return svg.length <= MAX_INLINE_SVG ? svg : null;
+}
+function logoTone(inkLuma2) {
+  return inkLuma2 !== null && inkLuma2 > 170 ? "dark" : "light";
+}
+function withLogoRegistered(tokensJson, logo) {
+  if (tokensJson === null) return null;
+  let tokens;
+  try {
+    tokens = JSON.parse(tokensJson);
+  } catch {
+    return null;
+  }
+  if (!tokens || typeof tokens !== "object" || Array.isArray(tokens)) return null;
+  const doc = tokens;
+  const logos = Array.isArray(doc.logos) ? doc.logos : [];
+  if (logos.some((l) => l?.path === logo.path)) return null;
+  const next = { ...doc, logos: [...logos, { variant: "logo", background: logo.background, path: logo.path }] };
+  return `${JSON.stringify(next, null, 2)}
+`;
+}
+function logoMissingHint(company, domain) {
+  return `No logo on file for ${company}: add it on the Brand page${domain ? ` (we could not find it on ${domain})` : ""}.`;
+}
+function extensionOf(url) {
+  return /\.(svg|png|jpg|jpeg|webp)(?:\?|$)/i.exec(url)?.[1]?.toLowerCase() ?? "svg";
+}
+var MAX_LOGO_BYTES = 3e6;
+async function downloaded(url) {
+  try {
+    const { buffer } = await fetchExternalBytes(url, { maxBytes: MAX_LOGO_BYTES });
+    return buffer.byteLength > 0 ? { bytes: buffer, extension: extensionOf(url) } : null;
+  } catch {
+    return null;
+  }
+}
+async function logoOnSite(domain) {
+  const host = hostOf(domain);
+  if (!host) return null;
+  const page = `https://${host}/`;
+  try {
+    const { buffer } = await fetchExternalBytes(page, { maxBytes: MAX_LOGO_BYTES });
+    const found = logoFromPage(buffer.toString("utf8"), page, domain);
+    if (found?.kind === "svg") return { bytes: Buffer.from(found.svg, "utf8"), extension: "svg" };
+    const file = found ? await downloaded(found.url) : null;
+    if (file) return file;
+  } catch {
+  }
+  try {
+    const listed = await apiPost("/api/images/extract", { url: page, limit: 50 });
+    const url = logoFromExtract(listed.hits ?? [], domain);
+    return url ? await downloaded(url) : null;
+  } catch {
+    return null;
+  }
+}
+async function logoSource(domain) {
+  let lookup = null;
+  if (domain) {
+    try {
+      lookup = await apiPost("/api/images/logo", { domain, variant: "logo", autoIngest: 1 });
+    } catch {
+      lookup = null;
+    }
+  }
+  const decision = decideClientLogo(domain, lookup);
+  if (decision.use) {
+    const file = await downloaded(decision.url);
+    if (file) return file;
+  }
+  if (domain && !(decision.use === false && decision.reason === "mismatch")) {
+    const file = await logoOnSite(domain);
+    if (file) return file;
+  }
+  return { note: clientLogoMissNote(decision.use ? { use: false, reason: "no_hits" } : decision, domain) };
+}
+async function inkOf(bytes) {
+  try {
+    return inkLuma((await logoArtwork(bytes)).data);
+  } catch {
+    return null;
+  }
+}
+async function fetchClientLogo(root = ".") {
+  let domain;
+  let company;
+  try {
+    const found = await apiGet("/api/company");
+    domain = found.data.domain?.trim() || void 0;
+    company = found.data.name;
+  } catch {
+    domain = void 0;
+  }
+  const named = { ...domain ? { domain } : {}, ...company ? { company } : {} };
+  const source = await logoSource(domain);
+  if ("note" in source) return { ok: false, reason: source.note, ...named };
+  try {
+    const tone = logoTone(await inkOf(source.bytes));
+    const dir = path.join(root, BRAND_DIR, "logos");
+    await mkdir(dir, { recursive: true });
+    const file = path.join(dir, `logo-${tone}.${source.extension}`);
+    await writeFile(file, source.bytes);
+    await registerLogo(root, path.join(BRAND_DIR, "logos", path.basename(file)), tone);
+    return { ok: true, path: file, ...named };
+  } catch {
+    return { ok: false, reason: clientLogoMissNote({ use: false, reason: "no_hits" }, domain), ...named };
+  }
+}
+async function registerLogo(root, relative, background) {
+  const tokensPath = path.join(root, BRAND_DIR, "tokens.json");
+  const next = withLogoRegistered(await readFile(tokensPath, "utf8").catch(() => null), { path: relative, background });
+  if (next !== null) await writeFile(tokensPath, next, "utf8").catch(() => void 0);
+}
+async function withClientLogo(root, kit, reread, fetch = fetchClientLogo) {
+  if (kit.logo) return { kit };
+  const fetched = await fetch(root).catch(() => null);
+  if (fetched?.ok) return { kit: await reread() };
+  return { kit, hint: logoMissingHint(fetched?.company ?? "your company", fetched?.domain) };
+}
+
+export {
+  fetchClientLogo,
+  withClientLogo
+};
+//# sourceMappingURL=chunk-KXSXZAC2.js.map

package/dist/chunk-KXSXZAC2.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/canvas/clientLogo.ts"],"sourcesContent":["/**\n * Fetching the client's OWN brand mark when the workspace has none yet.\n *\n * An ad with a person in it and no logo used to stop dead, and the remedy on offer — \"put\n * the client's real mark in src/brand/logos/\" — is not something the agent can do: it has\n * no access to the client's design files. Measured on a real run, that refusal cost nine\n * tool calls and produced nothing: it tried `baker images logo withbaker.com` (OUR domain,\n * not the client's), then an icon library, then `curl`ed an SVG off iconify, then offered\n * to ship the ad unbranded. An earlier run drew a mark by hand; another ran `strings` over\n * the CLI looking for a switch.\n *\n * The mark is fetchable — Brandfetch holds it, keyed by the company's own domain, which\n * Baker has on record and the Runtime could not read until now. So the path from \"no logo\"\n * to \"the client's logo\" is one lookup, not a conversation. It is tried before an ad is\n * built without a mark, which is what happens now when the lookup finds none.\n */\n\nimport { mkdir, readFile, writeFile } from \"node:fs/promises\";\nimport * as cheerio from \"cheerio\";\nimport path from \"node:path\";\nimport type { CompanyGetResponse, ImagesExtractResponse, ImagesLogoResponse } from \"@baker/api\";\nimport { apiGet, apiPost } from \"../../client.ts\";\nimport { fetchExternalBytes } from \"../../lib/externalFetch.ts\";\nimport { logoArtwork } from \"../../engine/nodes/local/lib/logo-raster.ts\";\nimport { BRAND_DIR, inkLuma } from \"../../engine/scaffold/ad-brand-source.ts\";\n\n/** Brandfetch's verdict plus the variants it returned, as `baker images logo` reports them. */\nexport type LogoLookup = {\n  brandMatch?: { verdict: \"confirmed\" | \"mismatch\" | \"unverified\"; name?: string };\n  hits?: ReadonlyArray<{ imageUrl?: string; sourceUrl?: string }>;\n};\n\nexport type LogoDecision =\n  | { use: true; url: string }\n  | { use: false; reason: \"no_domain\" | \"mismatch\" | \"unverified\" | \"no_hits\"; wrongBrand?: string };\n\n/**\n * Whether a lookup may be placed on the client's ad, unattended.\n *\n * Only `confirmed`. A logo hit carries no content signal — `/domain/<anything>/logo`\n * returns 200 and somebody's wordmark — and `brandMatch` is the only field that separates\n * \"this is their mark\" from \"this is a mark\". On anything else the ad is worth stopping\n * for, because a stand-in ships an ad wearing another company's brand, which is worse than\n * an ad that is late.\n *\n * `confirmed` is a floor and not a ceiling: it says the RECORD matches, not the artwork.\n * That residual risk is why this only ever runs when the alternative is no ad at all.\n */\nexport function decideClientLogo(domain: string | undefined, lookup: LogoLookup | null): LogoDecision {\n  if (!domain) return { use: false, reason: \"no_domain\" };\n  const verdict = lookup?.brandMatch?.verdict;\n  if (verdict === \"mismatch\") {\n    return { use: false, reason: \"mismatch\", ...(lookup?.brandMatch?.name ? { wrongBrand: lookup.brandMatch.name } : {}) };\n  }\n  if (verdict !== \"confirmed\") return { use: false, reason: \"unverified\" };\n  const url = lookup?.hits?.map((hit) => hit.imageUrl ?? hit.sourceUrl).find((candidate) => Boolean(candidate));\n  return url ? { use: true, url } : { use: false, reason: \"no_hits\" };\n}\n\n/**\n * What the lookup found, for the hint on an ad built without a mark. Never just \"it\n * failed\": a mark that belongs to another company is worth naming, so nobody retries into it.\n */\nexport function clientLogoMissNote(decision: Extract<LogoDecision, { use: false }>, domain?: string): string {\n  switch (decision.reason) {\n    case \"no_domain\":\n      return \"Baker has no website on record for this company, so their mark could not be looked up.\";\n    case \"mismatch\":\n      return (\n        `The mark found for \\`${domain}\\` belongs to ${decision.wrongBrand ?? \"a different company\"}, not to this ` +\n        \"client, so it was not used.\"\n      );\n    default:\n      return `No brand mark could be confirmed for \\`${domain}\\`, so nothing was placed.`;\n  }\n}\n\n/** An image the company's own site holds, as `baker images extract` reports it. */\ntype ExtractHit = {\n  url?: string;\n  imageUrl?: string;\n  sourceUrl?: string;\n  name?: string;\n  description?: string;\n  providerMeta?: Record<string, unknown>;\n};\n\n/** The host of a website as the company records it (`cubicup.com`, `https://www.cubicup.com/`), without `www.`. */\nfunction hostOf(site: string): string | null {\n  try {\n    return new URL(/^https?:\\/\\//i.test(site) ? site : `https://${site}`).hostname.replace(/^www\\./i, \"\").toLowerCase();\n  } catch {\n    return null;\n  }\n}\n\n/** Files that hold a favicon, an icon sheet or another company's mark, never the company's logo. */\nconst NOT_THE_LOGO = /favicon|apple-touch|sprite|(?:^|[/_.-])icons?(?:[/_.-]|$)|client|customer|partner|testimonial|trust|badge|award/i;\n\n/** What an image says about itself: its address, name, description, and the alt, class or id the page gave it. */\nfunction sayings(hit: ExtractHit, url: string): string {\n  const meta = hit.providerMeta ?? {};\n  const given = [\"alt\", \"class\", \"id\", \"title\"].map((key) => (typeof meta[key] === \"string\" ? meta[key] : \"\"));\n  return [new URL(url).pathname, hit.name ?? \"\", hit.description ?? \"\", ...given].join(\" \");\n}\n\n/**\n * The company's own logo among the images its website holds (`baker images extract https://<domain>`):\n * an image served from its own domain that says it is a logo, in its address, name or the alt, class\n * or id the page gave it, a vector first and the shortest address among equals. Another company's\n * mark, a favicon or a logo hosted elsewhere is never taken: a wrong mark is worse than a late ad. Pure.\n */\nexport function logoFromExtract(hits: readonly ExtractHit[], domain: string): string | null {\n  const own = hostOf(domain);\n  if (!own) return null;\n  const candidates = hits.flatMap((hit) => {\n    const url = hit.url ?? hit.imageUrl ?? hit.sourceUrl;\n    const host = url ? hostOf(url) : null;\n    if (!url || !host || (host !== own && !host.endsWith(`.${own}`))) return [];\n    const said = sayings(hit, url);\n    if (!/logo/i.test(said) || NOT_THE_LOGO.test(said)) return [];\n    return [{ url, score: (/\\.svg(?:\\?|$)/i.test(url) ? 2 : 0) + (/logo/i.test(new URL(url).pathname) ? 1 : 0) }];\n  });\n  candidates.sort((a, b) => b.score - a.score || a.url.length - b.url.length);\n  return candidates[0]?.url ?? null;\n}\n\n\n/** The logo a company's own page holds: an address its image is served from, or the inline SVG it draws. */\ntype PageLogo = { kind: \"url\"; url: string } | { kind: \"svg\"; svg: string };\n\n/** The largest inline SVG taken as a logo; a page's whole illustration is not one. */\nconst MAX_INLINE_SVG = 300_000;\n/** Where a page keeps its brand: its header, its navigation, its banner. */\nconst BRAND_PLACES = \"header, nav, [role=banner]\";\n/** The attributes a lazy-loaded image keeps its address in, the plain one first. */\nconst IMAGE_ADDRESS = [\"src\", \"data-src\", \"data-lazy-src\", \"data-original\"];\n\n/**\n * The company's own logo as its page shows it (`html`, fetched from `pageUrl`): an <img> or an inline\n * <svg> in the header, navigation or banner that says it is the logo in its own or its link's class,\n * id, alt or title. A header's logo is authoritative: nothing outside it counts, an image from another\n * domain never does (a press logo, a partner's mark, a CDN's rewrite), nor a sprite reference. Pure.\n */\nexport function logoFromPage(html: string, pageUrl: string, domain: string): PageLogo | null {\n  const own = hostOf(domain);\n  if (!own) return null;\n  const $ = cheerio.load(html);\n  for (const el of $(`${BRAND_PLACES}`).find(\"img, svg\").toArray()) {\n    const node = $(el);\n    const said = [node, node.closest(\"a\")]\n      .flatMap((n) => [\"class\", \"id\", \"alt\", \"aria-label\", \"title\"].map((k) => n.attr(k) ?? \"\"))\n      .join(\" \");\n    if (!/logo/i.test(said) || NOT_THE_LOGO.test(said)) continue;\n    if (el.tagName === \"svg\") {\n      const svg = standaloneSvg($, node);\n      if (svg) return { kind: \"svg\", svg };\n      continue;\n    }\n    const url = IMAGE_ADDRESS.map((k) => node.attr(k)?.trim() ?? \"\")\n      .filter((a) => a !== \"\" && !a.startsWith(\"data:\"))\n      .map((a) => absolute(a, pageUrl))\n      .find((a): a is string => a !== null);\n    const host = url ? hostOf(url) : null;\n    if (url && host && (host === own || host.endsWith(`.${own}`))) return { kind: \"url\", url };\n  }\n  return null;\n}\n\nfunction absolute(address: string, base: string): string | null {\n  try {\n    const url = new URL(address, base);\n    return /^https?:$/.test(url.protocol) ? url.href : null;\n  } catch {\n    return null;\n  }\n}\n\n/** An inline <svg> as a file of its own (its namespace stated); null when it draws nothing itself or is too large. */\nfunction standaloneSvg($: cheerio.CheerioAPI, node: ReturnType<cheerio.CheerioAPI>): string | null {\n  const draws = node.find(\"path, circle, rect, polygon, polyline, ellipse, line, text\").length > 0;\n  if (!draws || node.find(\"use\").length > 0) return null;\n  const copy = node.clone();\n  if (!copy.attr(\"xmlns\")) copy.attr(\"xmlns\", \"http://www.w3.org/2000/svg\");\n  const svg = $.html(copy);\n  return svg.length <= MAX_INLINE_SVG ? svg : null;\n}\n/**\n * The ground a logo file is meant for, from how light its ink is (0-255): the convention tokens.json\n * and the file names share, `logo-light` for a dark-inked mark that reads on a light ground. Pure.\n */\nexport function logoTone(inkLuma: number | null): \"light\" | \"dark\" {\n  return inkLuma !== null && inkLuma > 170 ? \"dark\" : \"light\";\n}\n\n/**\n * `tokens.json` (its text) with the logo file registered under `logos`; null when there is no\n * tokens.json to add it to, it does not parse, or the file is already there (nothing to write). Pure.\n */\nexport function withLogoRegistered(\n  tokensJson: string | null,\n  logo: { path: string; background: \"light\" | \"dark\" },\n): string | null {\n  if (tokensJson === null) return null;\n  let tokens: unknown;\n  try {\n    tokens = JSON.parse(tokensJson);\n  } catch {\n    return null;\n  }\n  if (!tokens || typeof tokens !== \"object\" || Array.isArray(tokens)) return null;\n  const doc = tokens as { logos?: unknown };\n  const logos = Array.isArray(doc.logos) ? doc.logos : [];\n  if (logos.some((l) => (l as { path?: unknown } | null)?.path === logo.path)) return null;\n  const next = { ...doc, logos: [...logos, { variant: \"logo\", background: logo.background, path: logo.path }] };\n  return `${JSON.stringify(next, null, 2)}\\n`;\n}\n\n/** The hint when no logo could be found for the company: where the person adds it. Pure. */\nexport function logoMissingHint(company: string, domain: string | undefined): string {\n  return `No logo on file for ${company}: add it on the Brand page${domain ? ` (we could not find it on ${domain})` : \"\"}.`;\n}\n\n/** The file extension a logo address ends in, svg when it names none (a mark saved under the wrong extension renders as nothing). */\nfunction extensionOf(url: string): string {\n  return /\\.(svg|png|jpg|jpeg|webp)(?:\\?|$)/i.exec(url)?.[1]?.toLowerCase() ?? \"svg\";\n}\n\n/** The largest logo file taken from a server; the page is read at a few times that. */\nconst MAX_LOGO_BYTES = 3_000_000;\n\ntype LogoSource = { bytes: Buffer; extension: string };\n\n/** The logo file at an address, or null when the server will not give it. */\nasync function downloaded(url: string): Promise<LogoSource | null> {\n  try {\n    const { buffer } = await fetchExternalBytes(url, { maxBytes: MAX_LOGO_BYTES });\n    return buffer.byteLength > 0 ? { bytes: buffer, extension: extensionOf(url) } : null;\n  } catch {\n    return null;\n  }\n}\n\n/** The logo the company's own website holds: the header's, which is authoritative, else a logo among the images the site lists. */\nasync function logoOnSite(domain: string): Promise<LogoSource | null> {\n  const host = hostOf(domain);\n  if (!host) return null;\n  const page = `https://${host}/`;\n  try {\n    const { buffer } = await fetchExternalBytes(page, { maxBytes: MAX_LOGO_BYTES });\n    const found = logoFromPage(buffer.toString(\"utf8\"), page, domain);\n    if (found?.kind === \"svg\") return { bytes: Buffer.from(found.svg, \"utf8\"), extension: \"svg\" };\n    const file = found ? await downloaded(found.url) : null;\n    if (file) return file;\n  } catch {\n    // The page did not load: the images it lists may still say which one is the logo.\n  }\n  try {\n    const listed = await apiPost<ImagesExtractResponse>(\"/api/images/extract\", { url: page, limit: 50 });\n    const url = logoFromExtract(listed.hits ?? [], domain);\n    return url ? await downloaded(url) : null;\n  } catch {\n    return null;\n  }\n}\n\n/** The client's logo file: Brandfetch's when it confirms the brand, else the company's own website's; else why none. */\nasync function logoSource(domain: string | undefined): Promise<LogoSource | { note: string }> {\n  let lookup: LogoLookup | null = null;\n  if (domain) {\n    try {\n      lookup = await apiPost<ImagesLogoResponse>(\"/api/images/logo\", { domain, variant: \"logo\", autoIngest: 1 });\n    } catch {\n      lookup = null;\n    }\n  }\n  const decision = decideClientLogo(domain, lookup);\n  if (decision.use) {\n    const file = await downloaded(decision.url);\n    if (file) return file;\n  }\n  // Brandfetch holds none (or a doubtful one): the company's own website is authoritative about its logo.\n  if (domain && !(decision.use === false && decision.reason === \"mismatch\")) {\n    const file = await logoOnSite(domain);\n    if (file) return file;\n  }\n  return { note: clientLogoMissNote(decision.use ? { use: false, reason: \"no_hits\" } : decision, domain) };\n}\n\n/** The mean ink of a logo file, 0-255; null when it cannot be read. */\nasync function inkOf(bytes: Buffer): Promise<number | null> {\n  try {\n    return inkLuma((await logoArtwork(bytes)).data);\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Fetch the client's own brand mark and write it into the workspace (`root`):\n * `src/brand/logos/logo-<light|dark>.<ext>`, registered in tokens.json so every ad finds it.\n *\n * Only ever called when the workspace has no mark. Their domain is on record with Baker; Brandfetch\n * holds the mark against it when it has one, else the company's own website does.\n *\n * Never places an unconfirmed one (see `decideClientLogo`): a wrong mark is a worse\n * outcome than a late ad. On any failure this returns the sentence the agent should act\n * on, rather than a stack trace.\n */\nexport async function fetchClientLogo(\n  root = \".\",\n): Promise<{ ok: true; path: string; domain?: string } | { ok: false; reason: string; domain?: string; company?: string }> {\n  let domain: string | undefined;\n  let company: string | undefined;\n  try {\n    const found = await apiGet<CompanyGetResponse>(\"/api/company\");\n    domain = found.data.domain?.trim() || undefined;\n    company = found.data.name;\n  } catch {\n    // A company read that fails is not the agent's problem to debug mid-ad; it lands on\n    // the same path as \"no domain on record\" and offers the same two ways out.\n    domain = undefined;\n  }\n  const named = { ...(domain ? { domain } : {}), ...(company ? { company } : {}) };\n  const source = await logoSource(domain);\n  if (\"note\" in source) return { ok: false, reason: source.note, ...named };\n  try {\n    const tone = logoTone(await inkOf(source.bytes));\n    const dir = path.join(root, BRAND_DIR, \"logos\");\n    await mkdir(dir, { recursive: true });\n    const file = path.join(dir, `logo-${tone}.${source.extension}`);\n    await writeFile(file, source.bytes);\n    await registerLogo(root, path.join(BRAND_DIR, \"logos\", path.basename(file)), tone);\n    return { ok: true, path: file, ...named };\n  } catch {\n    return { ok: false, reason: clientLogoMissNote({ use: false, reason: \"no_hits\" }, domain), ...named };\n  }\n}\n\n/** Register the file in the workspace's tokens.json, when it has one; a failure to is not the logo's. */\nasync function registerLogo(root: string, relative: string, background: \"light\" | \"dark\"): Promise<void> {\n  const tokensPath = path.join(root, BRAND_DIR, \"tokens.json\");\n  const next = withLogoRegistered(await readFile(tokensPath, \"utf8\").catch(() => null), { path: relative, background });\n  if (next !== null) await writeFile(tokensPath, next, \"utf8\").catch(() => undefined);\n}\n\n/**\n * The brand kit with the company's logo in it: as it is when it has one, else the logo fetched from\n * Brandfetch or the company's own website and the kit read again (`reread`). With none found the kit\n * is as it was and `hint` says where the person adds it. `fetch` is the lookup. Never throws.\n */\nexport async function withClientLogo<Kit extends { logo?: string }>(\n  root: string,\n  kit: Kit,\n  reread: () => Promise<Kit>,\n  fetch: typeof fetchClientLogo = fetchClientLogo,\n): Promise<{ kit: Kit; hint?: string }> {\n  if (kit.logo) return { kit };\n  const fetched = await fetch(root).catch(() => null);\n  if (fetched?.ok) return { kit: await reread() };\n  return { kit, hint: logoMissingHint(fetched?.company ?? \"your company\", fetched?.domain) };\n}\n"],"mappings":"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","names":["inkLuma"]}

package/dist/chunk-LCW3U4EA.js

@@ -0,0 +1,25 @@
+import {
+  ApiError,
+  apiGet,
+  apiPost
+} from "./chunk-XDZVBX6L.js";
+
+// src/commands/avatars/transport.ts
+function unwrap(response) {
+  if (response.ok === false || response.data === void 0) {
+    throw new ApiError("INTERNAL_ERROR", response.error?.message ?? "The avatars service returned an unusable answer");
+  }
+  return response.data;
+}
+async function readAvatars(path, params) {
+  return unwrap(await apiGet(path, params));
+}
+async function writeAvatars(path, body, opts) {
+  return unwrap(await apiPost(path, body, opts));
+}
+
+export {
+  readAvatars,
+  writeAvatars
+};
+//# sourceMappingURL=chunk-LCW3U4EA.js.map

package/dist/chunk-LFXE2G6R.js

@@ -0,0 +1,61 @@
+import {
+  COST_TYPES,
+  OBJECTIVE_TYPES,
+  calendarDaySchema,
+  targetingCriteriaSchema
+} from "./chunk-2QSPPWOU.js";
+
+// ../api/src/ads-linkedin/planning.ts
+import { z } from "zod";
+var moneySchema = z.object({
+  amount: z.string().regex(/^\d+(\.\d+)?$/, "use a plain amount such as 250 or 5.57"),
+  currencyCode: z.string().regex(/^[A-Z]{3}$/).optional()
+});
+var accountIdSchema = z.string().min(1);
+var linkedinBidPricingRequestSchema = z.object({
+  accountId: accountIdSchema,
+  objectiveType: z.enum(OBJECTIVE_TYPES),
+  costType: z.enum(COST_TYPES).default("CPC"),
+  campaignType: z.enum(["SPONSORED_UPDATES", "TEXT_AD", "SPONSORED_INMAILS"]).default("SPONSORED_UPDATES"),
+  /** EXACT = audience expansion off, the playbook default. */
+  matchType: z.enum(["EXACT", "AUDIENCE_EXPANDED"]).default("EXACT"),
+  targetingCriteria: targetingCriteriaSchema,
+  skipCache: z.boolean().optional()
+});
+var LINKEDIN_FORECAST_DEFAULT_DAYS = 30;
+var linkedinForecastRequestSchema = z.object({
+  accountId: accountIdSchema,
+  objectiveType: z.enum(OBJECTIVE_TYPES).optional(),
+  costType: z.enum(COST_TYPES).default("CPC"),
+  campaignType: z.enum(["SPONSORED_UPDATES", "SPONSORED_INMAILS", "DYNAMIC"]).default("SPONSORED_UPDATES"),
+  /** First forecast day (UTC); defaults to tomorrow — LinkedIn forecasts only the future. */
+  startDate: calendarDaySchema.optional(),
+  days: z.number().int().min(1).max(365).default(LINKEDIN_FORECAST_DEFAULT_DAYS),
+  dailyBudget: moneySchema.optional(),
+  totalBudget: moneySchema.optional(),
+  /** A manual bid; without one LinkedIn forecasts its automated bidding. */
+  bid: moneySchema.optional(),
+  optimizationTarget: z.string().regex(/^[A-Z_]+$/).optional(),
+  targetingCriteria: targetingCriteriaSchema,
+  /** Add LinkedIn's raw series (daily, 7-day, 30-day) to the summary. */
+  full: z.boolean().default(false),
+  skipCache: z.boolean().optional()
+}).superRefine((req, ctx) => {
+  if (!req.dailyBudget && !req.totalBudget) {
+    ctx.addIssue({
+      code: "custom",
+      path: ["totalBudget"],
+      message: "a budget is required (daily or total) \u2014 LinkedIn forecasts what a budget buys"
+    });
+  }
+  if (req.dailyBudget && req.totalBudget) {
+    ctx.addIssue({ code: "custom", path: ["totalBudget"], message: "pass a daily or a total budget, not both" });
+  }
+});
+
+export {
+  linkedinBidPricingRequestSchema,
+  LINKEDIN_FORECAST_DEFAULT_DAYS,
+  linkedinForecastRequestSchema
+};
+//# sourceMappingURL=chunk-LFXE2G6R.js.map

package/dist/chunk-LFXE2G6R.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../api/src/ads-linkedin/planning.ts"],"sourcesContent":["/**\n * Wire contracts for `POST /api/ads/linkedin/bid-pricing` and\n * `POST /api/ads/linkedin/forecast` — LinkedIn's suggested bid and delivery\n * forecast for a campaign that doesn't exist yet. Money without a currency\n * takes the ad account's.\n */\nimport { z } from \"zod\";\nimport { calendarDaySchema } from \"../calendarDays\";\nimport { COST_TYPES, OBJECTIVE_TYPES } from \"./limits\";\nimport { targetingCriteriaSchema } from \"./ops\";\n\nconst moneySchema = z.object({\n  amount: z.string().regex(/^\\d+(\\.\\d+)?$/, \"use a plain amount such as 250 or 5.57\"),\n  currencyCode: z\n    .string()\n    .regex(/^[A-Z]{3}$/)\n    .optional(),\n});\nexport type LinkedinPlanningMoney = z.infer<typeof moneySchema>;\n\nconst accountIdSchema = z.string().min(1);\n\nexport const linkedinBidPricingRequestSchema = z.object({\n  accountId: accountIdSchema,\n  objectiveType: z.enum(OBJECTIVE_TYPES),\n  costType: z.enum(COST_TYPES).default(\"CPC\"),\n  campaignType: z.enum([\"SPONSORED_UPDATES\", \"TEXT_AD\", \"SPONSORED_INMAILS\"]).default(\"SPONSORED_UPDATES\"),\n  /** EXACT = audience expansion off, the playbook default. */\n  matchType: z.enum([\"EXACT\", \"AUDIENCE_EXPANDED\"]).default(\"EXACT\"),\n  targetingCriteria: targetingCriteriaSchema,\n  skipCache: z.boolean().optional(),\n});\nexport type LinkedinBidPricingRequestInput = z.input<typeof linkedinBidPricingRequestSchema>;\n\nexport const LINKEDIN_FORECAST_DEFAULT_DAYS = 30;\n\nexport const linkedinForecastRequestSchema = z\n  .object({\n    accountId: accountIdSchema,\n    objectiveType: z.enum(OBJECTIVE_TYPES).optional(),\n    costType: z.enum(COST_TYPES).default(\"CPC\"),\n    campaignType: z.enum([\"SPONSORED_UPDATES\", \"SPONSORED_INMAILS\", \"DYNAMIC\"]).default(\"SPONSORED_UPDATES\"),\n    /** First forecast day (UTC); defaults to tomorrow — LinkedIn forecasts only the future. */\n    startDate: calendarDaySchema.optional(),\n    days: z.number().int().min(1).max(365).default(LINKEDIN_FORECAST_DEFAULT_DAYS),\n    dailyBudget: moneySchema.optional(),\n    totalBudget: moneySchema.optional(),\n    /** A manual bid; without one LinkedIn forecasts its automated bidding. */\n    bid: moneySchema.optional(),\n    optimizationTarget: z\n      .string()\n      .regex(/^[A-Z_]+$/)\n      .optional(),\n    targetingCriteria: targetingCriteriaSchema,\n    /** Add LinkedIn's raw series (daily, 7-day, 30-day) to the summary. */\n    full: z.boolean().default(false),\n    skipCache: z.boolean().optional(),\n  })\n  .superRefine((req, ctx) => {\n    if (!req.dailyBudget && !req.totalBudget) {\n      ctx.addIssue({\n        code: \"custom\",\n        path: [\"totalBudget\"],\n        message: \"a budget is required (daily or total) — LinkedIn forecasts what a budget buys\",\n      });\n    }\n    if (req.dailyBudget && req.totalBudget) {\n      ctx.addIssue({ code: \"custom\", path: [\"totalBudget\"], message: \"pass a daily or a total budget, not both\" });\n    }\n  });\nexport type LinkedinForecastRequestInput = z.input<typeof linkedinForecastRequestSchema>;\n"],"mappings":";;;;;;;;AAMA,SAAS,SAAS;AAKlB,IAAM,cAAc,EAAE,OAAO;AAAA,EAC3B,QAAQ,EAAE,OAAO,EAAE,MAAM,iBAAiB,wCAAwC;AAAA,EAClF,cAAc,EACX,OAAO,EACP,MAAM,YAAY,EAClB,SAAS;AACd,CAAC;AAGD,IAAM,kBAAkB,EAAE,OAAO,EAAE,IAAI,CAAC;AAEjC,IAAM,kCAAkC,EAAE,OAAO;AAAA,EACtD,WAAW;AAAA,EACX,eAAe,EAAE,KAAK,eAAe;AAAA,EACrC,UAAU,EAAE,KAAK,UAAU,EAAE,QAAQ,KAAK;AAAA,EAC1C,cAAc,EAAE,KAAK,CAAC,qBAAqB,WAAW,mBAAmB,CAAC,EAAE,QAAQ,mBAAmB;AAAA;AAAA,EAEvG,WAAW,EAAE,KAAK,CAAC,SAAS,mBAAmB,CAAC,EAAE,QAAQ,OAAO;AAAA,EACjE,mBAAmB;AAAA,EACnB,WAAW,EAAE,QAAQ,EAAE,SAAS;AAClC,CAAC;AAGM,IAAM,iCAAiC;AAEvC,IAAM,gCAAgC,EAC1C,OAAO;AAAA,EACN,WAAW;AAAA,EACX,eAAe,EAAE,KAAK,eAAe,EAAE,SAAS;AAAA,EAChD,UAAU,EAAE,KAAK,UAAU,EAAE,QAAQ,KAAK;AAAA,EAC1C,cAAc,EAAE,KAAK,CAAC,qBAAqB,qBAAqB,SAAS,CAAC,EAAE,QAAQ,mBAAmB;AAAA;AAAA,EAEvG,WAAW,kBAAkB,SAAS;AAAA,EACtC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,QAAQ,8BAA8B;AAAA,EAC7E,aAAa,YAAY,SAAS;AAAA,EAClC,aAAa,YAAY,SAAS;AAAA;AAAA,EAElC,KAAK,YAAY,SAAS;AAAA,EAC1B,oBAAoB,EACjB,OAAO,EACP,MAAM,WAAW,EACjB,SAAS;AAAA,EACZ,mBAAmB;AAAA;AAAA,EAEnB,MAAM,EAAE,QAAQ,EAAE,QAAQ,KAAK;AAAA,EAC/B,WAAW,EAAE,QAAQ,EAAE,SAAS;AAClC,CAAC,EACA,YAAY,CAAC,KAAK,QAAQ;AACzB,MAAI,CAAC,IAAI,eAAe,CAAC,IAAI,aAAa;AACxC,QAAI,SAAS;AAAA,MACX,MAAM;AAAA,MACN,MAAM,CAAC,aAAa;AAAA,MACpB,SAAS;AAAA,IACX,CAAC;AAAA,EACH;AACA,MAAI,IAAI,eAAe,IAAI,aAAa;AACtC,QAAI,SAAS,EAAE,MAAM,UAAU,MAAM,CAAC,aAAa,GAAG,SAAS,2CAA2C,CAAC;AAAA,EAC7G;AACF,CAAC;","names":[]}