@koda-sl/baker-cli 0.343.0 → 0.344.0-dev.9890d9fcc

package/dist/cli.js

@@ -67,7 +67,7 @@ import {
   validateCanvasDeep,
   withoutCastName,
   ytDlpBlockSignal
-} from "./chunk-FFOURYP5.js";
+} from "./chunk-D5P4COPD.js";
 import {
   csvOrJson,
   daysAgoIso,
@@ -2362,6 +2362,7 @@ var GOOGLE_ADS_LIMITS = {
     businessNameMax: 25
   }
 };
+var GOOGLE_ADS_QUERY_MAX_PAGE_SIZE = 1e4;
 var KEYWORD_MATCH_TYPES = ["EXACT", "PHRASE", "BROAD"];
 var ADVERTISING_CHANNEL_TYPES = [
   "SEARCH",
@@ -10079,7 +10080,72 @@ function urlOptionsHints(report) {
   return hints2;
 }
 
+// src/commands/ads/google/during-literals.ts
+var GAQL_DURING_LITERALS = [
+  "TODAY",
+  "YESTERDAY",
+  "LAST_7_DAYS",
+  "LAST_14_DAYS",
+  "LAST_30_DAYS",
+  "LAST_BUSINESS_WEEK",
+  "THIS_MONTH",
+  "LAST_MONTH",
+  "THIS_WEEK_SUN_TODAY",
+  "THIS_WEEK_MON_TODAY",
+  "LAST_WEEK_SUN_SAT",
+  "LAST_WEEK_MON_SUN"
+];
+function isDuringLiteral(value) {
+  return GAQL_DURING_LITERALS.includes(value.toUpperCase());
+}
+function isoDay(date) {
+  return date.toISOString().slice(0, 10);
+}
+function utcDate(year, month, day) {
+  return new Date(Date.UTC(year, month, day));
+}
+function equivalentBetween(literal, now) {
+  const upper2 = literal.toUpperCase();
+  const today = utcDate(now.getUTCFullYear(), now.getUTCMonth(), now.getUTCDate());
+  const yesterday = utcDate(today.getUTCFullYear(), today.getUTCMonth(), today.getUTCDate() - 1);
+  const range = (from, to) => `BETWEEN '${isoDay(from)}' AND '${isoDay(to)}'`;
+  const year = today.getUTCFullYear();
+  const quarterStart = Math.floor(today.getUTCMonth() / 3) * 3;
+  const rolling = upper2.match(/^LAST_(\d+)_(DAYS|WEEKS|MONTHS|YEARS)$/);
+  if (rolling) {
+    const n = Number(rolling[1]);
+    const unit = rolling[2];
+    if (n < 1) return null;
+    if (unit === "DAYS" || unit === "WEEKS") {
+      const days = unit === "DAYS" ? n : n * 7;
+      return range(utcDate(year, today.getUTCMonth(), today.getUTCDate() - days), yesterday);
+    }
+    const months = unit === "MONTHS" ? n : n * 12;
+    return range(utcDate(year, today.getUTCMonth() - months, today.getUTCDate()), yesterday);
+  }
+  switch (upper2) {
+    case "THIS_YEAR":
+      return range(utcDate(year, 0, 1), today);
+    case "LAST_YEAR":
+      return range(utcDate(year - 1, 0, 1), utcDate(year - 1, 11, 31));
+    case "THIS_QUARTER":
+      return range(utcDate(year, quarterStart, 1), today);
+    case "LAST_QUARTER":
+      return range(utcDate(year, quarterStart - 3, 1), utcDate(year, quarterStart, 0));
+    default:
+      return null;
+  }
+}
+function duringLiteralExplanation(literal, between) {
+  const accepted = GAQL_DURING_LITERALS.join(", ");
+  const lead = between ? `Google does not accept ${literal} after DURING. The same window as explicit dates is ${between}.` : `Google does not accept ${literal} after DURING, and it names no fixed window \u2014 use BETWEEN 'YYYY-MM-DD' AND 'YYYY-MM-DD', or drop the date filter.`;
+  return `${lead} DURING accepts only: ${accepted}. Any other window needs BETWEEN.`;
+}
+
 // src/commands/ads/google/changes-window.ts
+function monthlySpendTrendQuery(now = /* @__PURE__ */ new Date()) {
+  return `SELECT campaign.name, segments.month, metrics.cost_micros, metrics.conversions FROM campaign WHERE segments.date ${equivalentBetween("LAST_12_MONTHS", now)}`;
+}
 function isChangeScope(value) {
   return CHANGE_SCOPES.includes(value);
 }
@@ -10133,7 +10199,7 @@ function lookbackTooLong(scope, days, max) {
     message: `Google's account history API reaches back ${CHANGE_SCOPE_MAX_DAYS.summary} days at most; ${days} days is outside that window.`,
     fix: {
       action: "use_different_resource",
-      explanation: "Do not abort \u2014 infer the change from performance instead. Query monthly metrics per campaign (SELECT campaign.name, segments.month, metrics.cost_micros, metrics.conversions FROM campaign WHERE segments.date DURING LAST_12_MONTHS) to see which campaigns stopped or started spending. That shows what changed and when, though not who changed it. Older history exists only in the Google Ads web UI, which has no API \u2014 ask the user to check it if the 'who' matters."
+      explanation: `Do not abort \u2014 infer the change from performance instead. Query monthly metrics per campaign (${monthlySpendTrendQuery()}) to see which campaigns stopped or started spending. That shows what changed and when, though not who changed it. Older history exists only in the Google Ads web UI, which has no API \u2014 ask the user to check it if the 'who' matters.`
     }
   };
 }
@@ -10492,7 +10558,7 @@ var CORRECTION_RULES = [
     matchApiError: /changeStatusError\W{0,4}START_DATE_TOO_OLD/i,
     fix: () => ({
       action: "use_different_resource",
-      explanation: "Google's account history reaches back 90 days at most, and this query asks for more. Do not abort \u2014 infer the change from performance: SELECT campaign.name, segments.month, metrics.cost_micros, metrics.conversions FROM campaign WHERE segments.date DURING LAST_12_MONTHS shows which campaigns started or stopped spending and when, though not who changed them. Anything older with attribution exists only in the Google Ads web UI, which has no API."
+      explanation: `Google's account history reaches back 90 days at most, and this query asks for more. Do not abort \u2014 infer the change from performance: ${monthlySpendTrendQuery()} shows which campaigns started or stopped spending and when, though not who changed them. Anything older with attribution exists only in the Google Ads web UI, which has no API.`
     })
   },
   // 18c. change_status rejects a date range it cannot bound. Google raises this both for
@@ -12319,9 +12385,16 @@ import { resolve } from "path";
 import { defineCommand as defineCommand28 } from "citty";
 
 // src/commands/ads/google/presets.ts
-var GAQL_DATE_RANGE_RE = /^(?:TODAY|YESTERDAY|LAST_7_DAYS|LAST_14_DAYS|LAST_30_DAYS|LAST_90_DAYS|THIS_MONTH|LAST_MONTH|THIS_QUARTER|LAST_QUARTER|THIS_YEAR|LAST_YEAR|ALL_TIME|BETWEEN\s+'[0-9]{4}-[0-9]{2}-[0-9]{2}'\s+AND\s+'[0-9]{4}-[0-9]{2}-[0-9]{2}')$/i;
+var BETWEEN_RE = /^BETWEEN\s+'[0-9]{4}-[0-9]{2}-[0-9]{2}'\s+AND\s+'[0-9]{4}-[0-9]{2}-[0-9]{2}'$/i;
 function isValidDateRange(value) {
-  return GAQL_DATE_RANGE_RE.test(value.trim());
+  const trimmed = value.trim();
+  return isDuringLiteral(trimmed) || BETWEEN_RE.test(trimmed);
+}
+function dateRangeError(dateRange, now) {
+  if (/^[A-Za-z0-9_]+$/.test(dateRange.trim())) {
+    return `Invalid date range: "${dateRange}". ${duringLiteralExplanation(dateRange, equivalentBetween(dateRange, now))} Pass it as --date-range "BETWEEN 'YYYY-MM-DD' AND 'YYYY-MM-DD'".`;
+  }
+  return `Invalid date range: "${dateRange}". Use a GAQL date literal (e.g. LAST_30_DAYS, TODAY) or BETWEEN 'YYYY-MM-DD' AND 'YYYY-MM-DD'.`;
 }
 var SERVING_CHAINS = {
   keyword_view: ["campaign.status", "ad_group.status", "ad_group_criterion.status"],
@@ -12457,17 +12530,15 @@ function buildStatusScope(statusFields, includePaused) {
   const predicate = includePaused ? "!= 'REMOVED'" : "= 'ENABLED'";
   return statusFields.map((field) => ` AND ${field} ${predicate}`).join("");
 }
-function expandPreset(preset, params) {
+function expandPreset(preset, params, now = /* @__PURE__ */ new Date()) {
   const dateRange = params.dateRange ?? preset.defaultDateRange;
   const limit = params.limit ?? preset.defaultLimit;
-  if (!isValidDateRange(dateRange)) {
-    return {
-      query: "",
-      dateRangeError: `Invalid date range: "${dateRange}". Use a GAQL date literal (e.g. LAST_30_DAYS, TODAY) or BETWEEN 'YYYY-MM-DD' AND 'YYYY-MM-DD'.`
-    };
+  if (preset.gaqlTemplate.includes("{dateRange}") && !isValidDateRange(dateRange)) {
+    return { query: "", dateRangeError: dateRangeError(dateRange, now) };
   }
   const statusScope = buildStatusScope(preset.statusFields, params.includePaused ?? false);
-  const query = preset.gaqlTemplate.replace(/\{dateRange\}/g, dateRange).replace(/\{limit\}/g, String(limit)).replace(/\{statusScope\}/g, statusScope);
+  const range = dateRange.trim();
+  const query = preset.gaqlTemplate.replace(/DURING\s+\{dateRange\}/g, BETWEEN_RE.test(range) ? range : `DURING ${range}`).replace(/\{dateRange\}/g, range).replace(/\{limit\}/g, String(limit)).replace(/\{statusScope\}/g, statusScope);
   return { query };
 }
 
@@ -12626,6 +12697,28 @@ function applyAutoFixes(query, limit) {
   }
   return { query: corrected, warnings };
 }
+function rejectUnsupportedDuring(query, customerId) {
+  for (const match of query.matchAll(/(?<=[a-z_]\.[a-z_.]+\s+)DURING\s+([A-Za-z0-9_]+)/gi)) {
+    const literal = match[1] ?? "";
+    if (isDuringLiteral(literal)) continue;
+    const between = equivalentBetween(literal, /* @__PURE__ */ new Date());
+    const fixed = between ? query.replace(match[0], between) : void 0;
+    return {
+      ok: false,
+      error: {
+        code: "INVALID_DATE_RANGE",
+        message: `DURING ${literal} is not a Google Ads date range, so Google would refuse this query.`,
+        fix: {
+          action: "narrow_date_range",
+          ...fixed ? { correctedCommand: buildCommand2(fixed, customerId) } : {},
+          explanation: duringLiteralExplanation(literal, between)
+        },
+        retryable: false
+      }
+    };
+  }
+  return null;
+}
 function validatePreflight(query, customerId, limit) {
   const warnings = [];
   const corrected = query;
@@ -12697,6 +12790,8 @@ function validatePreflight(query, customerId, limit) {
       }
     };
   }
+  const duringRejection = rejectUnsupportedDuring(corrected, customerId);
+  if (duringRejection) return { valid: false, warnings: [], error: duringRejection };
   if (/\bsegments\.conversion_action_name\b/i.test(corrected) && /\bmetrics\.cost_micros\b/i.test(corrected)) {
     return {
       valid: false,
@@ -12905,7 +13000,7 @@ registerSchema({
     },
     "date-range": {
       type: "string",
-      description: "Date range for presets (LAST_7_DAYS, LAST_30_DAYS, LAST_90_DAYS, or BETWEEN 'X' AND 'Y')",
+      description: "Date range for presets: a Google date literal (TODAY, YESTERDAY, LAST_7_DAYS, LAST_14_DAYS, LAST_30_DAYS, THIS_MONTH, LAST_MONTH \u2026) or BETWEEN 'YYYY-MM-DD' AND 'YYYY-MM-DD'. Google has no LAST_90_DAYS \u2014 use BETWEEN for any other window.",
       required: false
     },
     "include-paused": {
@@ -13344,9 +13439,35 @@ async function executeQuery(finalQuery, args5, customerId, limit, warnings, useC
 function shouldReadCache(args5) {
   return !args5["no-cache"] && !args5.out;
 }
+var DEFAULT_QUERY_LIMIT = 200;
+function parseQueryLimit(raw) {
+  if (raw === void 0 || raw === null || raw === "") return { ok: true, limit: DEFAULT_QUERY_LIMIT };
+  const limit = Number(raw);
+  if (Number.isInteger(limit) && limit >= 1 && limit <= GOOGLE_ADS_QUERY_MAX_PAGE_SIZE) return { ok: true, limit };
+  return {
+    ok: false,
+    error: {
+      ok: false,
+      error: {
+        code: "VALIDATION_ERROR",
+        message: `--limit must be a whole number from 1 to ${GOOGLE_ADS_QUERY_MAX_PAGE_SIZE}, got '${String(raw)}'.`,
+        fix: {
+          action: "retry_with_flag",
+          explanation: `--limit is the size of one page, capped at ${GOOGLE_ADS_QUERY_MAX_PAGE_SIZE}. To read more rows, pass --limit ${GOOGLE_ADS_QUERY_MAX_PAGE_SIZE} with --all --out <file> and put your own LIMIT in the statement above the row count you expect.`
+        },
+        retryable: false
+      }
+    }
+  };
+}
 async function validateArgs(args5) {
+  const parsedLimit = parseQueryLimit(args5.limit);
+  if (!parsedLimit.ok) {
+    writeAdsJson(parsedLimit.error);
+    process.exit(1);
+  }
+  const { limit } = parsedLimit;
   const customerId = await resolveCustomerId(args5);
-  const limit = args5.limit ? Number(args5.limit) : 200;
   const gaql = resolveGaql(args5, limit);
   if (!gaql) {
     process.exit(1);