@koda-sl/baker-cli 0.507.0 → 0.509.0

package/dist/{performance-WPFGEJTE.js → performance-WPK4ZDES.js}

@@ -14,7 +14,7 @@ import {
 import "./chunk-CAZGM2NX.js";
 import "./chunk-NZS3KEQ2.js";
 import "./chunk-GIWHHCD6.js";
-import "./chunk-UI6BKYQD.js";
+import "./chunk-NSBNIPIW.js";
 import "./chunk-2TOIY2WN.js";
 import {
   ApiError,
@@ -1469,15 +1469,119 @@ import { defineCommand as defineCommand2 } from "citty";
 
 // src/commands/ads/performance/reportCommand.ts
 import { defineCommand } from "citty";
+
+// src/commands/ads/performance/syncCoverage.ts
+var HOUR_MS = 36e5;
+var DAY_MS = 24 * HOUR_MS;
+var BEHIND_AFTER_MS = 26 * HOUR_MS;
+var LIVE_READ = {
+  google: (from, to) => `baker ads google query --preset campaign-performance --date-range "BETWEEN '${from}' AND '${to}'"`,
+  meta: (from, to) => `baker ads meta insights --level campaign --since ${from} --until ${to}`,
+  linkedin: (from, to) => `baker ads linkedin analytics --level campaign --start ${from} --end ${to}`,
+  x: () => "baker ads x stats",
+  chatgpt: () => "baker ads chatgpt insights"
+};
+function ago(ms) {
+  const hours = Math.max(0, Math.floor(ms / HOUR_MS));
+  if (hours < 1) return "under an hour";
+  if (hours < 48) return `${hours}h`;
+  return `${Math.floor(hours / 24)} days`;
+}
+function utc(at) {
+  return `${new Date(at).toISOString().slice(0, 16).replace("T", " ")} UTC`;
+}
+function dayOf(at) {
+  return new Date(at).toISOString().slice(0, 10);
+}
+function dayAfter(day, days = 1) {
+  return dayOf(Date.parse(`${day}T00:00:00Z`) + days * DAY_MS);
+}
+function earliest(dates) {
+  const known = dates.filter((date) => date !== null);
+  return known.length === 0 ? null : known.reduce((a, b) => b < a ? b : a);
+}
+function liveRead(platform, from, to, why) {
+  const command = LIVE_READ[platform]?.(from, to);
+  return command ? `: read live with \`${command}\` (live reads spend the platform's rate limit \u2014 ${why})` : "";
+}
+function headline(platform, accounts, now) {
+  const updatedAt = platform.lastSuccessAt;
+  const from = earliest(accounts.map((account) => account.historyFrom));
+  const through = earliest(accounts.map((account) => account.newestDate));
+  const updated = updatedAt === null ? "never updated yet" : `last updated ${ago(now - updatedAt)} ago (${utc(updatedAt)})`;
+  const holds = from !== null && through !== null ? `; holds ${from} \u2192 ${through}` : "";
+  return `${platformLabel(platform.platform)} synced copy: ${updated}${holds}.`;
+}
+function loadingSentences(platform, accounts) {
+  return accounts.filter((account) => !account.backfillComplete && account.historyFrom !== null).map((account) => {
+    const before = account.historyFrom ?? "";
+    const live = LIVE_READ[platform.platform]?.("<from>", dayAfter(before, -1));
+    return `History is still loading for ${account.name || account.adAccountId}: days before ${before} are not in the copy yet${live ? `; for an older window read live with \`${live}\`` : ""}.`;
+  });
+}
+function emptySentences(accounts) {
+  if (accounts.every((account) => account.newestDate === null)) return [];
+  return accounts.filter((account) => account.newestDate === null).map((account) => `Nothing is stored yet for ${account.name || account.adAccountId}; read it live.`);
+}
+function failureSentences(platform, accounts) {
+  const byError = /* @__PURE__ */ new Map();
+  for (const account of accounts) {
+    if (account.error === null) continue;
+    byError.set(account.error, [...byError.get(account.error) ?? [], account.name || account.adAccountId]);
+  }
+  const sentences = [...byError].map(([error, names]) => `Last update failed for ${names.join(", ")}: ${error}`);
+  if (sentences.length === 0 && platform.error) sentences.push(`Last update failed: ${platform.error}`);
+  return sentences;
+}
+function behindSentences(platform, accounts, now) {
+  const sentences = failureSentences(platform, accounts);
+  const updatedAt = platform.lastSuccessAt;
+  const overdue = updatedAt === null || now - updatedAt > BEHIND_AFTER_MS;
+  if (!overdue && sentences.length === 0) return sentences;
+  const through = earliest(accounts.map((account) => account.newestDate));
+  const today = dayOf(now);
+  if (through === null) {
+    const live = liveRead(platform.platform, dayOf(now - 29 * DAY_MS), today, "read only what the question needs");
+    sentences.push(`Nothing is in the copy yet${live}.`);
+  } else if (through < today) {
+    const live = liveRead(platform.platform, dayAfter(through), today, "read only the missing days");
+    sentences.push(
+      `Days after ${through} are not in the copy${live}, or tell the person the numbers stop at ${through}.`
+    );
+  }
+  return sentences;
+}
+var GOOGLE_ONLY_READS = /* @__PURE__ */ new Set(["brand-split", "impression-share", "keyword-quality", "google-report", "segments"]);
+function platformsOfRead(path, body) {
+  const named = typeof body === "object" && body !== null ? body : {};
+  if (Array.isArray(named.platforms) && named.platforms.length > 0) return named.platforms.map(String);
+  if (typeof named.platform === "string") return [named.platform];
+  return GOOGLE_ONLY_READS.has(path) ? ["google"] : void 0;
+}
+function syncCoverageHints(status, now, platforms) {
+  return status.platforms.filter((platform) => platform.connected && (platforms === void 0 || platforms.includes(platform.platform))).map((platform) => {
+    const accounts = platform.accounts.filter((account) => account.selected);
+    return [
+      headline(platform, accounts, now),
+      ...loadingSentences(platform, accounts),
+      ...emptySentences(accounts),
+      ...behindSentences(platform, accounts, now)
+    ].join(" ");
+  });
+}
+
+// src/commands/ads/performance/reportCommand.ts
 function failInvalid(issues, args) {
   writeJson({ ok: false, error: { code: "INVALID_ARGS", message: invalidArgsMessage(issues, args) } });
   process.exit(1);
 }
-function postRead(path, body) {
-  return retryOnceIfBusy(
+async function postRead(path, body) {
+  const response = await retryOnceIfBusy(
     () => apiPost(`/api/ads/performance/${path}`, body),
     (caught) => caught instanceof Error ? caught.message : ""
   );
+  const coverage = response.dataStatus ? syncCoverageHints(response.dataStatus, Date.now(), platformsOfRead(path, body)) : [];
+  return { ok: true, data: response.data, coverage };
 }
 function failRead(err) {
   const refusal = err instanceof ApiError ? adPerformanceRefusal(err.code, err.message) : null;
@@ -1507,7 +1611,7 @@ function report(spec) {
       if (!parsed.success) failInvalid(parsed.error.issues, spec.args);
       try {
         const response = await postRead(spec.path, parsed.data);
-        const hints = spec.hints?.(response.data, parsed.data, args) ?? [];
+        const hints = [...response.coverage, ...spec.hints?.(response.data, parsed.data, args) ?? []];
         const data = args.full === true ? response.data : (spec.compact ?? roundDeep)(response.data);
         writeJson({ ok: true, data, ...hints.length > 0 ? { hints } : {} });
       } catch (err) {
@@ -1901,8 +2005,8 @@ function evidenceWords(evidence) {
     evidence.format === "different" ? "different format" : null
   ].filter((part) => part !== null).join(", ");
 }
-var titleOf = (concept, headline) => {
-  const words = (concept ?? headline).trim();
+var titleOf = (concept, headline2) => {
+  const words = (concept ?? headline2).trim();
   return words.length <= 120 ? words : `${words.slice(0, 119).trimEnd()}\u2026`;
 };
 function whyWords(choice) {
@@ -2410,16 +2514,6 @@ var PLATFORM_LABEL = {
 function platformLabel(platform) {
   return PLATFORM_LABEL[platform] ?? platform;
 }
-function historyLoadingHint(status) {
-  if (!status.historyLoading) return null;
-  const loading = status.platforms.flatMap(
-    (platform) => platform.accounts.filter((account) => account.selected && !account.backfillComplete).map(
-      (account) => `${account.name || account.adAccountId} (${platformLabel(platform.platform)}${account.historyFrom ? `, stored from ${account.historyFrom}` : ""})`
-    )
-  );
-  const which = loading.length > 0 ? loading.join(", ") : "some ad accounts";
-  return `History is still loading for ${which}; older periods are incomplete. Say so before comparing them, or read a recent window.`;
-}
 var NO_GOALS_HINT = "No result goals are set, so results are each platform's headline conversions. Run `baker ads performance goals` to see every conversion action each platform reported.";
 function resultNounHint(noun) {
   if (noun.source === "company")
@@ -2430,8 +2524,6 @@ function resultNounHint(noun) {
 }
 function overviewHints(data) {
   const hints = [];
-  const loading = historyLoadingHint(data.dataStatus);
-  if (loading !== null) hints.push(loading);
   if (data.goals.length === 0 && data.platforms.length > 0) hints.push(NO_GOALS_HINT);
   const noun = resultNounHint(data.resultNoun);
   if (noun !== null) hints.push(noun);
@@ -2569,7 +2661,7 @@ var TRACKING_FIX = {
   google: '`baker ads google campaigns update <campaign-id> --customer-id <id> --final-url-suffix "\u2026"` (read `baker ads google url-options` first)',
   linkedin: '`baker ads linkedin account url-params --param "\u2026"`',
   x: null,
-  chatgpt: null
+  chatgpt: '`baker ads chatgpt campaigns update <cmpn_id> --tracking-template "\u2026"` (read `baker ads chatgpt campaigns --full` first)'
 };
 var LOW_CAMPAIGN_ID_SHARE = 0.8;
 var MIN_PAID_SESSIONS = 20;
@@ -2616,15 +2708,7 @@ function splitAdsHints(status) {
   );
 }
 function statusHints(status) {
-  const hints = [];
-  const loading = historyLoadingHint(status);
-  if (loading !== null) hints.push(loading);
-  for (const platform of status.platforms) {
-    if (platform.connected && platform.error)
-      hints.push(`${platformLabel(platform.platform)} last sync failed: ${platform.error}`);
-  }
-  hints.push(...splitAdsHints(status));
-  return hints;
+  return splitAdsHints(status);
 }
 
 // src/commands/ads/performance/accounts.ts
@@ -2966,7 +3050,7 @@ function targetCommand(spec) {
       if (!parsed.success) failInvalid(parsed.error.issues, spec.args);
       try {
         const response = await postRead(spec.name, parsed.data);
-        const hints = spec.hints(response.data);
+        const hints = [...response.coverage, ...spec.hints(response.data)];
         const data = args.full === true ? response.data : spec.compact(response.data);
         writeJson({ ok: true, data, ...hints.length > 0 ? { hints } : {} });
       } catch (err) {
@@ -3324,7 +3408,7 @@ var creativeAssetsCommand = defineCommand4({
     if (!parsed.success) failInvalid(parsed.error.issues, CREATIVE_ASSETS_ARGS);
     try {
       const response = await postRead("creative-assets", parsed.data);
-      const hints = creativeAssetsHints(response.data, parsed.data);
+      const hints = [...response.coverage, ...creativeAssetsHints(response.data, parsed.data)];
       const data = args.full === true ? response.data : compactCreativeAssets(response.data);
       writeJson({ ok: true, data, ...hints.length > 0 ? { hints } : {} });
     } catch (err) {
@@ -3544,7 +3628,7 @@ var creativeHealthCommand = defineCommand5({
     }
     try {
       const response = await postRead("creative-health", parsed.data);
-      const hints = creativeHealthHints(response.data, choice);
+      const hints = [...response.coverage, ...creativeHealthHints(response.data, choice)];
       const data = args.full === true ? response.data : compactCreativeHealth(response.data, choice);
       writeJson({ ok: true, data, ...hints.length > 0 ? { hints } : {} });
     } catch (err) {
@@ -3776,7 +3860,7 @@ function diagnosticCommand(spec) {
       if (!parsed.success) failInvalid(parsed.error.issues, spec.args);
       try {
         const response = await postRead(spec.path, parsed.data);
-        const hints = spec.hints(response.data);
+        const hints = [...response.coverage, ...spec.hints(response.data)];
         const data = args.full === true ? response.data : spec.compact(response.data);
         writeJson({ ok: true, data, ...hints.length > 0 ? { hints } : {} });
       } catch (err) {
@@ -3957,7 +4041,7 @@ var healthCommand = defineCommand7({
     if (!parsed.success) failInvalid(parsed.error.issues, HEALTH_ARGS);
     try {
       const response = await postRead("health", parsed.data);
-      const hints = healthHints(response.data);
+      const hints = [...response.coverage, ...healthHints(response.data)];
       const data = args.full === true ? response.data : compactHealth(response.data);
       writeJson({ ok: true, data, ...hints.length > 0 ? { hints } : {} });
     } catch (err) {
@@ -4231,7 +4315,7 @@ function peopleCommand(spec) {
       if (!parsed.success) failInvalid(parsed.error.issues, spec.args);
       try {
         const response = await postRead(spec.path, parsed.data);
-        const hints = spec.hints(response.data);
+        const hints = [...response.coverage, ...spec.hints(response.data)];
         const data = args.full === true ? response.data : spec.compact(response.data);
         writeJson({ ok: true, data, ...hints.length > 0 ? { hints } : {} });
       } catch (err) {
@@ -5452,4 +5536,4 @@ Full guide: __tooling__/docs/tools/baker/ads-performance.md`
 export {
   performanceCommand
 };
-//# sourceMappingURL=performance-WPFGEJTE.js.map
+//# sourceMappingURL=performance-WPK4ZDES.js.map