@koda-sl/baker-cli 0.515.0-dev.957976bb7 → 0.516.0

package/dist/chunk-HGUYC5K6.js

@@ -1,76 +0,0 @@
-import {
-  handleConnectionError,
-  isNotConnectedError,
-  writeAdsJson
-} from "./chunk-ZRP7Y2DM.js";
-import {
-  ApiError
-} from "./chunk-X7VQFLHI.js";
-
-// src/commands/ads/google/service-read-errors.ts
-var KNOWN_REFUSALS = [
-  {
-    match: /BILLING_SETUP_NOT_ON_MONTHLY_INVOICING/,
-    code: "NOT_INVOICED",
-    message: "This account is not billed by monthly invoicing, so Google issues no invoices through the API.",
-    explanation: "Degrade, don't abort: the account pays automatically (card or bank), and its receipts are in Google Ads \u2192 Billing \u2192 Documents for the user to download. Spend itself is readable with `query --preset account-summary`. Carry on with the rest of the job."
-  },
-  {
-    match: /no approved billing setup/i,
-    code: "NO_BILLING_SETUP",
-    message: "This account has no approved billing setup, so it has no invoices.",
-    explanation: "Degrade, don't abort: nothing is billed to this account yet (or a manager account pays). Carry on with the rest of the job."
-  },
-  {
-    match: /BILLING_NOT_ON_MONTHLY_INVOICING|verification is only open to customers with billing setup for monthly invoicing/,
-    code: "VERIFICATION_NOT_READABLE",
-    message: "Google only reports advertiser verification through the API for accounts on monthly invoicing.",
-    explanation: "Degrade, don't abort: the status is in Google Ads \u2192 Billing \u2192 Advertiser verification, where the user can read it. Say that, and carry on with the rest of the job."
-  },
-  {
-    match: /UNSUPPORTED_AD_TYPE/,
-    code: "NO_PREVIEW_FOR_AD_TYPE",
-    message: "Google has no shareable preview for this ad type: --ads previews only video ads of Video campaigns, live on YouTube (search, display and Demand Gen ads answer unsupported).",
-    explanation: "Degrade, don't abort: preview a Performance Max campaign with --asset-groups, and describe any other ad from its copy (`ads list`, `query --preset ad-copy-performance`). Carry on with the rest of the job."
-  }
-];
-function serviceReadRefusal(message) {
-  const known = KNOWN_REFUSALS.find((refusal) => refusal.match.test(message));
-  if (!known) return null;
-  return {
-    ok: false,
-    error: {
-      code: known.code,
-      message: known.message,
-      fix: { action: "reject", explanation: known.explanation },
-      retryable: false
-    }
-  };
-}
-function exitWithServiceReadError(err) {
-  if (err instanceof ApiError) {
-    if (isNotConnectedError(err.code, err.message)) handleConnectionError("google_ads", err.message);
-    writeAdsJson(
-      serviceReadRefusal(err.message) ?? {
-        ok: false,
-        error: {
-          code: err.code,
-          message: err.message,
-          fix: { action: "reject", explanation: err.message },
-          retryable: err.code === "RATE_LIMITED" || err.code === "UNAVAILABLE"
-        }
-      }
-    );
-    process.exit(1);
-  }
-  writeAdsJson({
-    ok: false,
-    error: { code: "NETWORK_ERROR", message: err instanceof Error ? err.message : "Unexpected error" }
-  });
-  process.exit(1);
-}
-
-export {
-  exitWithServiceReadError
-};
-//# sourceMappingURL=chunk-HGUYC5K6.js.map

package/dist/chunk-HMIROUFV.js

@@ -1,74 +0,0 @@
-import {
-  cacheGet,
-  cacheSet,
-  handleConnectionError,
-  needsConnectionFix,
-  writeJsonEnvelope
-} from "./chunk-ZRP7Y2DM.js";
-import {
-  ApiError,
-  apiGet
-} from "./chunk-X7VQFLHI.js";
-import {
-  getEnv
-} from "./chunk-LGK7UWBN.js";
-
-// src/commands/gsc/resolve.ts
-async function fetchSites(useCache = true) {
-  if (useCache) {
-    const cached = cacheGet("gsc-sites", "list");
-    if (cached) return cached.data;
-  }
-  const params = !useCache ? { "skip-cache": "true" } : void 0;
-  const data = await apiGet("/api/gsc/sites", params);
-  if (useCache) {
-    cacheSet("gsc-sites", "list", data, 60 * 60 * 1e3);
-  }
-  return data;
-}
-async function resolveSiteUrl(args) {
-  const fromArgs = args["site-url"];
-  const fromEnv = getEnv().BAKER_GSC_SITE_URL;
-  const siteUrl = fromArgs || fromEnv;
-  if (siteUrl) return siteUrl;
-  const useCache = !args["no-cache"];
-  try {
-    const sites = await fetchSites(useCache);
-    const [single] = sites;
-    if (sites.length === 1 && single) {
-      process.stderr.write(`Using site "${single.siteUrl}"
-`);
-      return single.siteUrl;
-    }
-    if (sites.length === 0) {
-      handleConnectionError("gsc");
-    }
-    const list = sites.map((s) => `  ${s.siteUrl}  (${s.permissionLevel})`).join("\n");
-    writeJsonEnvelope({
-      ok: false,
-      error: {
-        code: "MULTIPLE_SITES",
-        message: `Multiple sites found. Pass --site-url or set BAKER_GSC_SITE_URL:
-${list}`
-      }
-    });
-    process.exit(1);
-  } catch (err) {
-    if (err instanceof ApiError && needsConnectionFix(err.code, err.message)) {
-      handleConnectionError("gsc", err.message);
-    }
-    writeJsonEnvelope({
-      ok: false,
-      error: {
-        code: "RESOLUTION_ERROR",
-        message: "Could not auto-detect site. Pass --site-url or set BAKER_GSC_SITE_URL."
-      }
-    });
-    process.exit(1);
-  }
-}
-
-export {
-  resolveSiteUrl
-};
-//# sourceMappingURL=chunk-HMIROUFV.js.map

package/dist/chunk-I43ZEWJQ.js

@@ -1,285 +0,0 @@
-import {
-  IDEA_VIDEO_FORMATS,
-  figuresIn,
-  unsourcedClaims
-} from "./chunk-MKUA54QE.js";
-import {
-  AD_SPEC_SCHEMA,
-  unfitReasons
-} from "./chunk-QHZE62GP.js";
-import {
-  proofStrength
-} from "./chunk-Q7US4OOA.js";
-
-// src/commands/creatives/make-model.ts
-import { parse, parseDocument, Scalar, visit } from "yaml";
-var REFERENCE_CANDIDATES = 6;
-function isVideoIdea(idea) {
-  return IDEA_VIDEO_FORMATS.includes(idea.format ?? "");
-}
-var BY_TEMPERATURE = {
-  cold: { audienceTemperature: "0_cold", excludeBrandReliant: true },
-  warm: { audienceTemperature: "1_warm_engaged,2_hot_visited", excludeBrandReliant: true },
-  hot: { audienceTemperature: "3_customer" }
-};
-function referenceSearchFor(idea, temperature, where = {}) {
-  return {
-    query: where.category || idea.message,
-    scope: "followed-first",
-    platform: "meta",
-    format: "static",
-    formatPattern: idea.format,
-    awareness: idea.awareness,
-    ...BY_TEMPERATURE[temperature],
-    ...where.country ? { country: where.country } : {},
-    maxPerAdvertiser: 1,
-    limit: REFERENCE_CANDIDATES,
-    diverse: true
-  };
-}
-function referenceSearchesFor(idea, temperature, where = {}) {
-  const strict = referenceSearchFor(idea, temperature, where);
-  const { awareness: _awareness, ...anyStage } = strict;
-  const { audienceTemperature: _temperature, excludeBrandReliant: _reliant, ...viewerAny } = anyStage;
-  const anyViewer = { ...viewerAny, scope: "all" };
-  const { formatPattern: _pattern, ...anyContainer } = anyViewer;
-  const { country: _country, ...anywhere } = anyViewer;
-  const { country: _anyCountry, ...anyContainerAnywhere } = anyContainer;
-  const { query: _query, ...winners } = anyStage;
-  const { query: _anyQuery, country: _winnersCountry, ...winnersAnywhere } = anyViewer;
-  const inMarket = (steps) => where.country ? steps : [];
-  const shows = idea.shows?.trim();
-  const { formatPattern: _shownPattern, ...anyCategory } = { ...anyStage, scope: "all" };
-  const { country: _shownCountry, ...anyCategoryAnywhere } = anyCategory;
-  const { country: _viewerCountry, ...anyViewerAnywhere } = anyViewer;
-  const { formatPattern: _anyPattern, ...shownAnyViewer } = anyViewerAnywhere;
-  const kinds = (where.shows ?? []).flatMap((q) => q.trim() ? [{ ...anyCategoryAnywhere, query: q.trim() }] : []);
-  const shown = shows ? [
-    ...inMarket([{ ...anyCategory, query: shows }]),
-    ...kinds,
-    { ...anyCategoryAnywhere, query: shows },
-    { ...shownAnyViewer, query: shows },
-    ...idea.format ? [{ ...anyViewerAnywhere, query: shows }] : []
-  ] : [];
-  const anyAd = (query) => query?.trim() ? [...inMarket([{ ...anyContainer, query: query.trim() }]), { ...anyContainerAnywhere, query: query.trim() }] : [];
-  if (shows) {
-    return [
-      ...shown,
-      ...where.category ? [anyContainerAnywhere] : [],
-      ...where.audience?.trim() ? [{ ...anyContainerAnywhere, query: where.audience.trim() }] : [],
-      { ...winnersAnywhere, sort: "winner" }
-    ];
-  }
-  return [
-    ...where.country ? [strict, anyStage, anyContainer] : [strict, anyStage],
-    anywhere,
-    anyContainerAnywhere,
-    ...anyAd(where.audience),
-    ...(where.wider ?? []).flatMap((q) => q.trim() ? [{ ...anyContainerAnywhere, query: q.trim() }] : []),
-    ...anyAd(where.industry),
-    ...where.category ? [{ ...anyContainerAnywhere, query: idea.message }] : [],
-    ...inMarket([{ ...winners, sort: "winner" }]),
-    { ...winnersAnywhere, sort: "winner" }
-  ];
-}
-function referenceWhereOf(brief, fallback) {
-  if (!brief) return fallback;
-  const country = brief.country === null ? void 0 : brief.country ?? fallback.country;
-  const audience = brief.audience ?? fallback.audience;
-  return {
-    ...country ? { country } : {},
-    category: brief.category,
-    ...brief.industry ? { industry: brief.industry } : {},
-    ...audience ? { audience } : {},
-    ...brief.wider.length ? { wider: brief.wider } : {},
-    ...brief.shows?.length ? { shows: brief.shows } : {}
-  };
-}
-function rankedForOf(brief, where, bet) {
-  return {
-    category: brief?.category ?? where.category ?? bet.message,
-    ...brief?.industry ? { industry: brief.industry } : {},
-    ...brief?.buyer ? { buyer: brief.buyer } : {},
-    ...brief?.humour ? { humour: brief.humour } : {},
-    ...brief?.memes ? { memes: brief.memes } : {},
-    ...brief?.memesWhy ? { memesWhy: brief.memesWhy } : {},
-    ...brief?.avoid.length ? { avoid: brief.avoid } : {},
-    message: bet.message,
-    who: bet.who,
-    ...bet.shows ? { shows: bet.shows } : {}
-  };
-}
-var brandKey = (name) => name.normalize("NFD").replace(new RegExp("\\p{M}", "gu"), "").toLowerCase().replace(/[^\p{L}\p{N}]/gu, "");
-function isOwnBrand(advertiser, brands) {
-  const page = brandKey(advertiser ?? "");
-  return page !== "" && brands.some((b) => brandKey(b).length >= 3 && page.includes(brandKey(b)));
-}
-function pooledCandidates(searches, limit) {
-  const seen = /* @__PURE__ */ new Set();
-  const pooled = [];
-  for (const candidate of searches.flat()) {
-    const brand = candidate.advertiser_id ? `brand:${candidate.advertiser_id}` : null;
-    if (!candidate.ad_id || seen.has(candidate.ad_id) || brand && seen.has(brand)) continue;
-    seen.add(candidate.ad_id);
-    if (brand) seen.add(brand);
-    pooled.push(candidate);
-  }
-  const proven = (c) => proofStrength(c.winner_score) !== "little";
-  return [...pooled.filter(proven), ...pooled.filter((c) => !proven(c))].slice(0, limit);
-}
-function freshReferencesFirst(candidates, taken) {
-  return [
-    ...candidates.filter((c) => !isTakenReference(c, taken)),
-    ...candidates.filter((c) => isTakenReference(c, taken))
-  ];
-}
-function isTakenReference(c, taken) {
-  return c.ad_id != null && taken.adIds.has(c.ad_id) || c.advertiser_id != null && taken.advertiserIds.has(c.advertiser_id);
-}
-function fitsIdea(fit) {
-  return fit.verdict !== "reject" && missingElements(fit).length === 0 && fit.our_viewer?.stops !== "no";
-}
-function missingElements(fit) {
-  return fit.load_bearing.filter((l) => l.have === "missing" && !l.ours?.trim()).map((l) => l.element);
-}
-function whyUnfit(fit) {
-  const reasons = unfitReasons(fit);
-  if (reasons.length > 0) return reasons.join("; ");
-  if (fit.our_viewer?.stops === "no") {
-    return `our viewer would not stop for it${fit.our_viewer.why ? `: ${fit.our_viewer.why}` : ""}`;
-  }
-  return fit.transfer_note?.trim() || "the check found it does not carry this ad";
-}
-function definitionFieldsOf(idea, evidence) {
-  return {
-    idea: idea.id,
-    message: idea.message,
-    ...evidence !== "explore" ? { evidence } : {},
-    angle: idea.angle,
-    persona: idea.who,
-    awareness: idea.awareness,
-    hypothesis: idea.why
-  };
-}
-var FRONTMATTER = /^---\r?\n([\s\S]*?\r?\n)?---/;
-function readsAsText11(text) {
-  try {
-    return parse(text, { version: "1.1" }) === text;
-  } catch {
-    return false;
-  }
-}
-function setDefinitionFields(raw, fields) {
-  const match = raw.match(FRONTMATTER);
-  if (!match) return raw;
-  const doc = parseDocument(match[1] ?? "");
-  if (doc.errors.length > 0) return raw;
-  for (const [key, value] of Object.entries(fields)) {
-    if (value === void 0) continue;
-    const node = doc.createNode(value);
-    visit(node, {
-      Scalar(_, scalar) {
-        if (typeof scalar.value === "string" && !readsAsText11(scalar.value)) {
-          scalar.type = Scalar.QUOTE_DOUBLE;
-        }
-      }
-    });
-    doc.set(key, node);
-  }
-  return `---
-${doc.toString()}---${raw.slice(match[0].length)}`;
-}
-function setSpecMessage(specJson, message) {
-  const spec = JSON.parse(specJson);
-  return `${JSON.stringify({ ...spec, message }, null, 2)}
-`;
-}
-function setSpecViewer(specJson, idea, personas) {
-  const spec = JSON.parse(specJson);
-  const viewer = spec.viewer ?? {};
-  return `${JSON.stringify({ ...spec, viewer: { ...viewer, who: personaWho(idea, personas) } }, null, 2)}
-`;
-}
-function personaWho(idea, personas) {
-  const persona = personas.find((p) => p.slug === idea.who);
-  if (persona?.title) return `${persona.title}${persona.segment ? ` (${persona.segment})` : ""}`;
-  return persona?.segment ?? idea.who.replace(/[-_]/g, " ");
-}
-var AUDIENCE_QUERY_WORDS = 9;
-function audienceQuery(idea, personas) {
-  return personaWho(idea, personas).replace(/\(/g, " ").replace(/\)/g, "").split(/\s+/).filter(Boolean).slice(0, AUDIENCE_QUERY_WORDS).join(" ").replace(/[\s,;:.–—-]+$/, "");
-}
-function fitBetOf(idea, personas, insights, market) {
-  const quotes = insights.filter((i) => idea.evidence.includes(i.id)).map((i) => i.quote);
-  return {
-    who: personaWho(idea, personas),
-    message: idea.message,
-    awareness: idea.awareness,
-    angle: idea.angle,
-    ...idea.shows ? { shows: idea.shows } : {},
-    ...quotes.length > 0 ? { quotes } : {},
-    ...market ? { market } : {}
-  };
-}
-function withFitConcept(specJson, seeded) {
-  const spec = JSON.parse(specJson);
-  const held = spec.concept;
-  if (held?.reference_ad_id) return specJson;
-  return `${JSON.stringify({ ...spec, ...seeded }, null, 2)}
-`;
-}
-function unsourcedCopyLines(specJson, corpus) {
-  const spec = JSON.parse(specJson);
-  const figures = figuresIn(corpus);
-  const lines = Array.isArray(spec.copy) ? spec.copy : [];
-  return lines.flatMap((line) => {
-    const text = typeof line === "object" && line !== null ? line.text : void 0;
-    return typeof text === "string" && unsourcedClaims(text, figures).length > 0 ? [text] : [];
-  });
-}
-var PHOTO_FORMATS = /photo|lifestyle|before_after|ugc|product|selfie|street/;
-function ideaSpec(idea, who) {
-  const container = idea.format ? `, as a ${idea.format.replace(/_/g, " ")}` : "";
-  const shows = idea.shows ? ` (${idea.shows})` : "";
-  return {
-    schema: AD_SPEC_SCHEMA,
-    viewer: { who },
-    message: idea.message,
-    copy: [{ text: "[TODO: the headline, in the customer's words]", lettering: "designed", role: "headline" }],
-    scene: {
-      description: `[TODO: what the viewer sees first${shows}${container}, that shows: ${idea.message}]`,
-      look: PHOTO_FORMATS.test(idea.format ?? idea.shows ?? "") ? "photo" : "designed"
-    },
-    colors: [],
-    references: [],
-    logo: true,
-    third_party_brands: [],
-    scene_text: [],
-    mechanism: []
-  };
-}
-
-export {
-  isVideoIdea,
-  referenceSearchesFor,
-  referenceWhereOf,
-  rankedForOf,
-  isOwnBrand,
-  pooledCandidates,
-  freshReferencesFirst,
-  isTakenReference,
-  fitsIdea,
-  missingElements,
-  whyUnfit,
-  definitionFieldsOf,
-  setDefinitionFields,
-  setSpecMessage,
-  setSpecViewer,
-  personaWho,
-  audienceQuery,
-  fitBetOf,
-  withFitConcept,
-  unsourcedCopyLines,
-  ideaSpec
-};
-//# sourceMappingURL=chunk-I43ZEWJQ.js.map

package/dist/chunk-IZABTTW5.js

@@ -1,228 +0,0 @@
-import {
-  NUMERIC_ID_REGEX
-} from "./chunk-MUS2UTWU.js";
-
-// ../api/src/ads-google/change-history.ts
-var CHANGE_SCOPES = ["detail", "summary"];
-var CHANGE_SCOPE_MAX_DAYS = {
-  detail: 30,
-  summary: 90
-};
-var DEFAULT_CHANGE_DAYS = 7;
-var MAX_CHANGE_DAYS = CHANGE_SCOPE_MAX_DAYS.summary;
-function isChangeLookbackWithinReach(days, scope) {
-  return days <= CHANGE_SCOPE_MAX_DAYS[scope];
-}
-
-// ../api/src/ads-google/keyword-planning.ts
-import { z } from "zod";
-var ISO_DATE = /^\d{4}-\d{2}-\d{2}$/;
-var micros = z.number().int().positive();
-var FORECAST_MATCH_TYPES = ["EXACT", "PHRASE", "BROAD"];
-var googleForecastBiddingSchema = z.discriminatedUnion("strategy", [
-  z.object({ strategy: z.literal("MANUAL_CPC"), maxCpcBidMicros: micros, dailyBudgetMicros: micros.optional() }),
-  z.object({
-    strategy: z.literal("MAXIMIZE_CLICKS"),
-    dailyTargetSpendMicros: micros,
-    maxCpcBidCeilingMicros: micros.optional()
-  }),
-  z.object({ strategy: z.literal("MAXIMIZE_CONVERSIONS"), dailyTargetSpendMicros: micros })
-]);
-var googleKeywordForecastRequestSchema = z.object({
-  customerId: z.string().regex(NUMERIC_ID_REGEX, "customerId must be the bare numeric customer id"),
-  managerId: z.string().optional(),
-  /** One forecast ad group per entry; most forecasts are a single group. */
-  adGroups: z.array(
-    z.object({
-      keywords: z.array(z.object({ text: z.string().trim().min(1).max(80), matchType: z.enum(FORECAST_MATCH_TYPES) })).min(1)
-    })
-  ).min(1),
-  locationIds: z.array(z.string().regex(NUMERIC_ID_REGEX)).optional(),
-  languageId: z.string().regex(NUMERIC_ID_REGEX).optional(),
-  bidding: googleForecastBiddingSchema,
-  /** Must start in the future and end within a year. Without them Baker forecasts the 30 days from tomorrow. */
-  startDate: z.string().regex(ISO_DATE).optional(),
-  endDate: z.string().regex(ISO_DATE).optional(),
-  currencyCode: z.string().length(3).optional()
-}).refine((body) => body.startDate === void 0 === (body.endDate === void 0), {
-  message: "Give both --start and --end, or neither (the forecast then covers the 30 days from tomorrow)",
-  path: ["endDate"]
-});
-var KEYWORD_FORECAST_SOURCE = "keyword_planner_forecast";
-var googleKeywordForecastResponseSchema = z.object({
-  source: z.literal(KEYWORD_FORECAST_SOURCE),
-  period: z.object({ startDate: z.string(), endDate: z.string() }),
-  forecast_clicks: z.number().nullable(),
-  forecast_cost_micros: z.number().nullable(),
-  forecast_conversions: z.number().nullable(),
-  forecast_average_cpc_micros: z.number().nullable(),
-  forecast_average_cpa_micros: z.number().nullable()
-});
-var googleAdGroupThemesRequestSchema = z.object({
-  customerId: z.string().regex(NUMERIC_ID_REGEX, "customerId must be the bare numeric customer id"),
-  managerId: z.string().optional(),
-  keywords: z.array(z.string().trim().min(1)).min(1),
-  /** Existing ad groups to sort the keywords into: numeric ids or `customers/{cid}/adGroups/{id}`. */
-  adGroups: z.array(z.string().min(1)).min(1)
-});
-var googleAdGroupThemesResponseSchema = z.object({
-  suggestions: z.array(
-    z.object({
-      keyword: z.string(),
-      suggested_keyword: z.string(),
-      match_type: z.string(),
-      ad_group: z.string(),
-      campaign: z.string()
-    })
-  ),
-  unusable_ad_groups: z.array(z.object({ ad_group: z.string(), campaign: z.string() }))
-});
-
-// ../api/src/ads-google/url-options.ts
-import { z as z2 } from "zod";
-var URL_OPTION_LEVELS = ["account", "campaign", "ad_group", "ad"];
-var googleUrlOptionValueSchema = z2.discriminatedUnion("state", [
-  z2.object({ state: z2.literal("set"), value: z2.string() }),
-  z2.object({ state: z2.literal("not_set") }),
-  z2.object({ state: z2.literal("not_read"), reason: z2.string() })
-]);
-var googleUrlOptionsRequestSchema = z2.object({
-  customerId: z2.string().regex(NUMERIC_ID_REGEX, "customerId must be the bare numeric customer id"),
-  managerId: z2.string().optional(),
-  /** Compact by default: only campaigns that actually override the account. `full` lists every campaign. */
-  full: z2.boolean().optional(),
-  skipCache: z2.boolean().optional()
-});
-var googleUrlOptionsCampaignSchema = z2.object({
-  id: z2.string(),
-  name: z2.string(),
-  status: z2.string(),
-  final_url_suffix: googleUrlOptionValueSchema,
-  tracking_url_template: googleUrlOptionValueSchema
-});
-var googleUrlOptionsAdGroupSchema = z2.object({
-  id: z2.string(),
-  name: z2.string(),
-  status: z2.string(),
-  campaign_id: z2.string(),
-  final_url_suffix: googleUrlOptionValueSchema,
-  tracking_url_template: googleUrlOptionValueSchema
-});
-var googleUrlOptionsAdSchema = z2.object({
-  id: z2.string(),
-  status: z2.string(),
-  ad_group_id: z2.string(),
-  campaign_id: z2.string(),
-  final_url_suffix: googleUrlOptionValueSchema,
-  tracking_url_template: googleUrlOptionValueSchema
-});
-var googleUrlOptionsResponseSchema = z2.object({
-  customer_id: z2.string(),
-  account: z2.object({
-    level: z2.literal("account"),
-    read: z2.boolean(),
-    final_url_suffix: googleUrlOptionValueSchema,
-    tracking_url_template: googleUrlOptionValueSchema
-  }),
-  campaigns: z2.object({
-    level: z2.literal("campaign"),
-    read: z2.boolean(),
-    /** Campaigns actually observed. 0 with `read: true` means the account has no non-removed campaigns. */
-    campaigns_read: z2.number().int().nonnegative(),
-    /** Campaigns observed to carry no override of their own — an explicit finding, not an omission. */
-    campaigns_without_override: z2.number().int().nonnegative(),
-    overrides: z2.array(googleUrlOptionsCampaignSchema),
-    /** Compact mode only: campaigns read but not listed because they carry no override. */
-    omitted: z2.number().int().nonnegative()
-  }),
-  /**
-   * Ad groups and ads that carry an override of their own — read by asking Google only for the
-   * entities whose suffix or template IS NOT NULL, so an account of thousands of ads costs one page.
-   * `read: true` with no overrides is a finding: nothing at this level overrides the levels above.
-   * `truncated` means more overriding entities exist than one page listed.
-   */
-  ad_groups: z2.object({
-    level: z2.literal("ad_group"),
-    read: z2.boolean(),
-    overrides: z2.array(googleUrlOptionsAdGroupSchema),
-    truncated: z2.boolean()
-  }),
-  ads: z2.object({
-    level: z2.literal("ad"),
-    read: z2.boolean(),
-    overrides: z2.array(googleUrlOptionsAdSchema),
-    truncated: z2.boolean()
-  }),
-  /** Levels this command could not read. Nothing here may be reported as "not configured". */
-  levels_not_read: z2.array(z2.object({ level: z2.enum(URL_OPTION_LEVELS), reason: z2.string() }))
-});
-var ACCOUNT_URL_OPTIONS_LOCATION = "Google Ads UI \u2192 Admin \u2192 Account settings \u2192 Tracking (account-level tracking template and final URL suffix)";
-var ACCOUNT_URL_OPTIONS_STAGE_COMMAND = 'baker ads google account update --customer-id <id> --final-url-suffix "utm_agency=baker"';
-function isSet(value) {
-  return value.state === "set";
-}
-function entityOverrideHints(label, plural, field, level) {
-  if (!level.read) return [];
-  const hints = [];
-  const overriding = level.overrides.filter((entity) => isSet(entity.final_url_suffix));
-  if (overriding.length > 0) {
-    const named = overriding.slice(0, 5).map((entity) => entity.name || entity.id).join(", ");
-    hints.push(
-      `${overriding.length} ${label}(s) set their own final URL suffix (${named}${overriding.length > 5 ? ", \u2026" : ""}). It REPLACES the campaign and account suffix for every click through it, so an account-wide parameter must be added to theirs too.`
-    );
-  }
-  if (level.truncated) {
-    hints.push(
-      `More ${plural} override the URL options than one page lists \u2014 read them all with \`baker ads google query\` on ${field}.final_url_suffix IS NOT NULL --all before saying which ones do.`
-    );
-  }
-  return hints;
-}
-function urlOptionsHints(report) {
-  const hints = [];
-  const { account, campaigns } = report;
-  if (!account.read) {
-    hints.push(
-      "The account level did NOT read \u2014 its URL options are unknown, not empty. Re-run before telling the user anything about account-wide tagging."
-    );
-  } else if (account.final_url_suffix.state === "not_set") {
-    hints.push(
-      `No account-level final URL suffix is set. An account-wide parameter (agency/partner tagging such as utm_agency=\u2026) belongs at the account level so it reaches every ad \u2014 stage it with \`${ACCOUNT_URL_OPTIONS_STAGE_COMMAND}\` (applies at Publish; the user sees it under ${ACCOUNT_URL_OPTIONS_LOCATION}).`
-    );
-  }
-  if (!campaigns.read) {
-    hints.push(
-      "Campaign-level URL options did NOT read \u2014 do not report that no campaign overrides exist. Re-run before concluding."
-    );
-  } else {
-    const overriding = campaigns.overrides.filter((c) => isSet(c.final_url_suffix));
-    if (overriding.length > 0) {
-      const named = overriding.slice(0, 5).map((c) => c.name || c.id).join(", ");
-      hints.push(
-        `A campaign's final URL suffix REPLACES the account-level one for that campaign \u2014 it does not merge. ${overriding.length} campaign(s) set their own (${named}${overriding.length > 5 ? ", \u2026" : ""}) and will not pick up an account-wide parameter until their own suffix carries it too. Every other campaign read here inherits the account level normally.`
-      );
-    }
-  }
-  hints.push(...entityOverrideHints("ad group", "ad groups", "ad_group", report.ad_groups));
-  hints.push(...entityOverrideHints("ad", "ads", "ad_group_ad.ad", report.ads));
-  const overridingLevelsNotRead = report.levels_not_read.filter((level) => level.level !== "account");
-  if (overridingLevelsNotRead.length > 0) {
-    hints.push(
-      `Not read at this level: ${overridingLevelsNotRead.map((l) => l.level).join(", ")}. A suffix set there still wins over the levels above it.`
-    );
-  }
-  if (campaigns.omitted > 0) {
-    hints.push(`${campaigns.omitted} campaign(s) read with no override of their own are not listed \u2014 pass --full.`);
-  }
-  return hints;
-}
-
-export {
-  CHANGE_SCOPES,
-  CHANGE_SCOPE_MAX_DAYS,
-  DEFAULT_CHANGE_DAYS,
-  isChangeLookbackWithinReach,
-  googleKeywordForecastRequestSchema,
-  urlOptionsHints
-};
-//# sourceMappingURL=chunk-IZABTTW5.js.map