@koda-sl/baker-cli 0.383.0 → 0.384.0-dev.557795bef

package/dist/query-CNWQ6STR.js

@@ -0,0 +1,61 @@
+import {
+  buildFileSummary,
+  buildQueryEnvelope,
+  completenessWarnings,
+  effectiveRowLimit,
+  keywordServingOptions,
+  missingFieldWarnings,
+  missingFieldWarningsFor,
+  outputResults,
+  pageCacheKey,
+  parseQueryLimit,
+  parseSelectedFields,
+  queryCommand,
+  queryPageSize,
+  resolveGaqlInput,
+  resultColumns,
+  runQuery,
+  servingScopeWarnings,
+  shouldReadCache,
+  summariseWarnings,
+  unobservedFields,
+  unobservedSelectedFields,
+  unwrittenColumnWarnings,
+  warningLines
+} from "./chunk-CWXADUKL.js";
+import "./chunk-JPK34QPS.js";
+import "./chunk-R7QV5N2S.js";
+import "./chunk-SEPPFM5S.js";
+import "./chunk-EIGXX6KI.js";
+import "./chunk-I2DNBEV6.js";
+import "./chunk-CUL3VB4L.js";
+import "./chunk-6YYSUISH.js";
+import "./chunk-I4FTS5EE.js";
+import "./chunk-MYTDK3AL.js";
+import "./chunk-YQSBHWOI.js";
+export {
+  buildFileSummary,
+  buildQueryEnvelope,
+  completenessWarnings,
+  effectiveRowLimit,
+  keywordServingOptions,
+  missingFieldWarnings,
+  missingFieldWarningsFor,
+  outputResults,
+  pageCacheKey,
+  parseQueryLimit,
+  parseSelectedFields,
+  queryCommand,
+  queryPageSize,
+  resolveGaqlInput,
+  resultColumns,
+  runQuery,
+  servingScopeWarnings,
+  shouldReadCache,
+  summariseWarnings,
+  unobservedFields,
+  unobservedSelectedFields,
+  unwrittenColumnWarnings,
+  warningLines
+};
+//# sourceMappingURL=query-CNWQ6STR.js.map

package/dist/query-CNWQ6STR.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/query-DBSBZ73C.js

@@ -0,0 +1,247 @@
+import {
+  resolveSiteUrl
+} from "./chunk-IELPT4K2.js";
+import {
+  buildQueryCacheKey,
+  cacheGet,
+  cacheSet,
+  getQueryTtl,
+  handleConnectionError,
+  isNotConnectedError,
+  toCsvRow,
+  writeAdsOutput,
+  writeJsonEnvelope
+} from "./chunk-EIGXX6KI.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-CUL3VB4L.js";
+import "./chunk-6YYSUISH.js";
+import "./chunk-I4FTS5EE.js";
+import {
+  registerSchema
+} from "./chunk-MYTDK3AL.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/gsc/query.ts
+import { appendFileSync, existsSync, readFileSync, writeFileSync } from "fs";
+import { resolve } from "path";
+import { defineCommand } from "citty";
+
+// src/commands/gsc/presets.ts
+var GSC_PRESETS = [
+  {
+    name: "cannibalization",
+    description: "PPC-SEO arbitrage \u2014 find queries ranking #1-2 organically where you also pay for ads",
+    playbook: "[05] PPC-SEO Arbitrage"
+  },
+  {
+    name: "missed-revenue",
+    description: "High-impression queries with no PPC coverage (position > 10)",
+    playbook: "[05] Opportunity Finder"
+  },
+  {
+    name: "brand-halo",
+    description: "Brand search volume trends \u2014 proves upper-funnel awareness lift",
+    playbook: "[21] YouTube/DG ROI",
+    requiresBrand: true
+  },
+  {
+    name: "negative-keywords",
+    description: "Discover negative keyword candidates (login, support, cancel queries)",
+    playbook: "Negative Keyword Discovery"
+  },
+  {
+    name: "top-pages",
+    description: "Top performing pages by clicks",
+    playbook: "General"
+  },
+  {
+    name: "top-queries",
+    description: "Top search queries by clicks",
+    playbook: "General"
+  }
+];
+
+// src/commands/gsc/query.ts
+registerSchema({
+  command: "gsc.query",
+  description: "Run GSC Search Analytics queries. Use --preset for playbook-aligned queries (primary usage) or --dimensions for free-form queries.",
+  args: {
+    "site-url": { type: "string", description: "Site URL (auto-resolved if not provided)", required: false },
+    preset: {
+      type: "string",
+      description: "Named preset (cannibalization, missed-revenue, brand-halo, negative-keywords, top-pages, top-queries)",
+      required: false
+    },
+    brand: { type: "string", description: "Brand name (required for brand-halo preset)", required: false },
+    dimensions: {
+      type: "string",
+      description: "Comma-separated dimensions (escape hatch: query, page, country, device, date)",
+      required: false
+    },
+    days: { type: "string", description: "Lookback window in days (default: 28)", required: false },
+    "start-date": { type: "string", description: "Explicit start date (YYYY-MM-DD)", required: false },
+    "end-date": { type: "string", description: "Explicit end date (YYYY-MM-DD)", required: false },
+    "row-limit": { type: "string", description: "Max rows (default: 1000, max: 25000)", required: false },
+    type: { type: "string", description: "Search type: web|image|video|news|discover (default: web)", required: false },
+    filter: { type: "string", description: "Dimension filter groups as JSON string", required: false },
+    "list-presets": { type: "boolean", description: "List available presets", required: false },
+    out: { type: "string", description: "Write data to file (.csv, .jsonl, .json)", required: false },
+    append: { type: "boolean", description: "Append to existing file", required: false },
+    output: { type: "string", description: "Format: json|csv|jsonl|md", required: false, default: "json" },
+    "no-cache": { type: "boolean", description: "Skip cache", required: false }
+  }
+});
+function extractFields(rows) {
+  const first = rows[0];
+  return first ? Object.keys(first) : [];
+}
+function writeRowsToFile(filePath, rows, append) {
+  const fields = extractFields(rows);
+  const ext = filePath.split(".").pop()?.toLowerCase();
+  if (ext === "csv") {
+    if (!append || !existsSync(filePath)) {
+      writeFileSync(filePath, `${toCsvRow(fields)}
+`, "utf-8");
+    }
+    const csvRows = rows.map((row) => toCsvRow(fields.map((f) => String(row[f] ?? ""))));
+    appendFileSync(filePath, `${csvRows.join("\n")}
+`, "utf-8");
+  } else if (ext === "jsonl") {
+    const content = `${rows.map((row) => JSON.stringify(row)).join("\n")}
+`;
+    if (append && existsSync(filePath)) {
+      appendFileSync(filePath, content, "utf-8");
+    } else {
+      writeFileSync(filePath, content, "utf-8");
+    }
+  } else if (append && existsSync(filePath)) {
+    const existing = JSON.parse(readFileSync(filePath, "utf-8"));
+    writeFileSync(filePath, JSON.stringify([...existing, ...rows], null, 2), "utf-8");
+  } else {
+    writeFileSync(filePath, JSON.stringify(rows, null, 2), "utf-8");
+  }
+}
+function outputRows(rows, args, response, cached) {
+  if (args.out) {
+    const filePath = resolve(args.out);
+    writeRowsToFile(filePath, rows, !!args.append);
+    writeJsonEnvelope({ ok: true, file: filePath, rows: rows.length, ...cached && { cached: true } });
+    return;
+  }
+  const format = args.output || "json";
+  if (format !== "json") {
+    writeAdsOutput(rows, format);
+    return;
+  }
+  writeJsonEnvelope({ ...response, ...cached && { cached: true } });
+}
+function buildRequestBody(args, siteUrl, useCache) {
+  const body = { siteUrl };
+  if (args.preset) body.preset = args.preset;
+  if (args.brand) body.brand = args.brand;
+  if (args.dimensions) body.dimensions = args.dimensions.split(",").map((d) => d.trim());
+  if (args.days) body.days = Number(args.days);
+  if (args["start-date"]) body.startDate = args["start-date"];
+  if (args["end-date"]) body.endDate = args["end-date"];
+  if (args["row-limit"]) body.rowLimit = Number(args["row-limit"]);
+  if (args.type) body.type = args.type;
+  if (args.filter) body.filter = args.filter;
+  if (!useCache) body.skipCache = true;
+  return body;
+}
+function handleError(err) {
+  if (err instanceof ApiError) {
+    if (isNotConnectedError(err.code, err.message)) {
+      handleConnectionError("gsc", err.message);
+    }
+    writeJsonEnvelope({ ok: false, error: { code: err.code, message: err.message } });
+    process.exit(1);
+  }
+  writeJsonEnvelope({
+    ok: false,
+    error: { code: "NETWORK_ERROR", message: err instanceof Error ? err.message : "Unexpected error" }
+  });
+  process.exit(1);
+}
+var queryCommand = defineCommand({
+  meta: {
+    name: "query",
+    description: `Run GSC Search Analytics queries. Preset-first with free-form escape hatch.
+
+Presets (primary usage):
+  baker gsc query --preset cannibalization
+  baker gsc query --preset brand-halo --brand "Acme" --days 90
+  baker gsc query --list-presets
+
+Free-form (escape hatch):
+  baker gsc query --dimensions "query,page" --days 28
+  baker gsc query --dimensions "query" --row-limit 25000 --out keywords.csv`
+  },
+  args: {
+    "site-url": { type: "string", description: "Site URL", required: false },
+    preset: { type: "string", description: "Named preset", required: false },
+    brand: { type: "string", description: "Brand name for brand-halo preset", required: false },
+    dimensions: { type: "string", description: "Comma-separated dimensions", required: false },
+    days: { type: "string", description: "Lookback days (default: 28)", required: false },
+    "start-date": { type: "string", description: "Start date override", required: false },
+    "end-date": { type: "string", description: "End date override", required: false },
+    "row-limit": { type: "string", description: "Max rows (default: 1000)", required: false },
+    type: { type: "string", description: "Search type (default: web)", required: false },
+    filter: { type: "string", description: "Filter JSON", required: false },
+    "list-presets": { type: "boolean", description: "List presets", required: false },
+    out: { type: "string", description: "Output file path", required: false },
+    append: { type: "boolean", description: "Append to file", required: false },
+    output: { type: "string", description: "Format: json|csv|jsonl|md", required: false, default: "json" },
+    "no-cache": { type: "boolean", description: "Skip cache", required: false }
+  },
+  run: async ({ args }) => {
+    if (args["list-presets"]) {
+      writeJsonEnvelope({
+        ok: true,
+        data: GSC_PRESETS.map((p) => ({
+          name: p.name,
+          description: p.description,
+          playbook: p.playbook,
+          ...p.requiresBrand && { requiresBrand: true }
+        }))
+      });
+      return;
+    }
+    if (!args.preset && !args.dimensions) {
+      writeJsonEnvelope({
+        ok: false,
+        error: {
+          code: "VALIDATION_ERROR",
+          message: "Provide --preset or --dimensions. Run --list-presets to see options."
+        }
+      });
+      process.exit(1);
+    }
+    const siteUrl = await resolveSiteUrl(args);
+    const useCache = !args["no-cache"];
+    const body = buildRequestBody(args, siteUrl, useCache);
+    const cacheKey = buildQueryCacheKey(siteUrl, JSON.stringify(body));
+    if (useCache) {
+      const cached = cacheGet("gsc-queries", cacheKey);
+      if (cached) {
+        outputRows(cached.data.data ?? [], args, cached.data, true);
+        return;
+      }
+    }
+    try {
+      const response = await apiPost("/api/gsc/query", body);
+      if (useCache) {
+        cacheSet("gsc-queries", cacheKey, response, getQueryTtl(JSON.stringify(body)));
+      }
+      outputRows(response.data ?? [], args, response, false);
+    } catch (err) {
+      handleError(err);
+    }
+  }
+});
+export {
+  queryCommand
+};
+//# sourceMappingURL=query-DBSBZ73C.js.map

package/dist/query-DBSBZ73C.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/gsc/query.ts","../src/commands/gsc/presets.ts"],"sourcesContent":["import { appendFileSync, existsSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\nimport { defineCommand } from \"citty\";\nimport { ApiError, apiPost } from \"../../client.ts\";\nimport { handleConnectionError, isNotConnectedError } from \"../../error-handler.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { buildQueryCacheKey, cacheGet, cacheSet, getQueryTtl } from \"../ads/cache.ts\";\nimport { toCsvRow, writeAdsOutput, writeJsonEnvelope } from \"../ads/output.ts\";\nimport { GSC_PRESETS } from \"./presets.ts\";\nimport { resolveSiteUrl } from \"./resolve.ts\";\n\nregisterSchema({\n  command: \"gsc.query\",\n  description:\n    \"Run GSC Search Analytics queries. Use --preset for playbook-aligned queries (primary usage) or --dimensions for free-form queries.\",\n  args: {\n    \"site-url\": { type: \"string\", description: \"Site URL (auto-resolved if not provided)\", required: false },\n    preset: {\n      type: \"string\",\n      description:\n        \"Named preset (cannibalization, missed-revenue, brand-halo, negative-keywords, top-pages, top-queries)\",\n      required: false,\n    },\n    brand: { type: \"string\", description: \"Brand name (required for brand-halo preset)\", required: false },\n    dimensions: {\n      type: \"string\",\n      description: \"Comma-separated dimensions (escape hatch: query, page, country, device, date)\",\n      required: false,\n    },\n    days: { type: \"string\", description: \"Lookback window in days (default: 28)\", required: false },\n    \"start-date\": { type: \"string\", description: \"Explicit start date (YYYY-MM-DD)\", required: false },\n    \"end-date\": { type: \"string\", description: \"Explicit end date (YYYY-MM-DD)\", required: false },\n    \"row-limit\": { type: \"string\", description: \"Max rows (default: 1000, max: 25000)\", required: false },\n    type: { type: \"string\", description: \"Search type: web|image|video|news|discover (default: web)\", required: false },\n    filter: { type: \"string\", description: \"Dimension filter groups as JSON string\", required: false },\n    \"list-presets\": { type: \"boolean\", description: \"List available presets\", required: false },\n    out: { type: \"string\", description: \"Write data to file (.csv, .jsonl, .json)\", required: false },\n    append: { type: \"boolean\", description: \"Append to existing file\", required: false },\n    output: { type: \"string\", description: \"Format: json|csv|jsonl|md\", required: false, default: \"json\" },\n    \"no-cache\": { type: \"boolean\", description: \"Skip cache\", required: false },\n  },\n});\n\ninterface QueryApiResponse {\n  ok: boolean;\n  data?: Array<Record<string, unknown>>;\n  preset?: string;\n  error?: { code: string; message: string };\n}\n\nfunction extractFields(rows: Array<Record<string, unknown>>): string[] {\n  const first = rows[0];\n  return first ? Object.keys(first) : [];\n}\n\nfunction writeRowsToFile(filePath: string, rows: Array<Record<string, unknown>>, append: boolean): void {\n  const fields = extractFields(rows);\n  const ext = filePath.split(\".\").pop()?.toLowerCase();\n  if (ext === \"csv\") {\n    if (!append || !existsSync(filePath)) {\n      writeFileSync(filePath, `${toCsvRow(fields)}\\n`, \"utf-8\");\n    }\n    const csvRows = rows.map((row) => toCsvRow(fields.map((f) => String(row[f] ?? \"\"))));\n    appendFileSync(filePath, `${csvRows.join(\"\\n\")}\\n`, \"utf-8\");\n  } else if (ext === \"jsonl\") {\n    const content = `${rows.map((row) => JSON.stringify(row)).join(\"\\n\")}\\n`;\n    if (append && existsSync(filePath)) {\n      appendFileSync(filePath, content, \"utf-8\");\n    } else {\n      writeFileSync(filePath, content, \"utf-8\");\n    }\n  } else if (append && existsSync(filePath)) {\n    const existing = JSON.parse(readFileSync(filePath, \"utf-8\")) as unknown[];\n    writeFileSync(filePath, JSON.stringify([...existing, ...rows], null, 2), \"utf-8\");\n  } else {\n    writeFileSync(filePath, JSON.stringify(rows, null, 2), \"utf-8\");\n  }\n}\n\nfunction outputRows(\n  rows: Array<Record<string, unknown>>,\n  args: Record<string, unknown>,\n  response: QueryApiResponse,\n  cached: boolean,\n): void {\n  if (args.out) {\n    const filePath = resolve(args.out as string);\n    writeRowsToFile(filePath, rows, !!args.append);\n    writeJsonEnvelope({ ok: true, file: filePath, rows: rows.length, ...(cached && { cached: true }) });\n    return;\n  }\n  const format = (args.output as string) || \"json\";\n  if (format !== \"json\") {\n    writeAdsOutput(rows, format);\n    return;\n  }\n  writeJsonEnvelope({ ...response, ...(cached && { cached: true }) });\n}\n\nfunction buildRequestBody(args: Record<string, unknown>, siteUrl: string, useCache: boolean): Record<string, unknown> {\n  const body: Record<string, unknown> = { siteUrl };\n  if (args.preset) body.preset = args.preset;\n  if (args.brand) body.brand = args.brand;\n  if (args.dimensions) body.dimensions = (args.dimensions as string).split(\",\").map((d) => d.trim());\n  if (args.days) body.days = Number(args.days);\n  if (args[\"start-date\"]) body.startDate = args[\"start-date\"];\n  if (args[\"end-date\"]) body.endDate = args[\"end-date\"];\n  if (args[\"row-limit\"]) body.rowLimit = Number(args[\"row-limit\"]);\n  if (args.type) body.type = args.type;\n  if (args.filter) body.filter = args.filter;\n  if (!useCache) body.skipCache = true;\n  return body;\n}\n\nfunction handleError(err: unknown): never {\n  if (err instanceof ApiError) {\n    if (isNotConnectedError(err.code, err.message)) {\n      handleConnectionError(\"gsc\", err.message);\n    }\n    writeJsonEnvelope({ ok: false, error: { code: err.code, message: err.message } });\n    process.exit(1);\n  }\n  writeJsonEnvelope({\n    ok: false,\n    error: { code: \"NETWORK_ERROR\", message: err instanceof Error ? err.message : \"Unexpected error\" },\n  });\n  process.exit(1);\n}\n\nexport const queryCommand = defineCommand({\n  meta: {\n    name: \"query\",\n    description: `Run GSC Search Analytics queries. Preset-first with free-form escape hatch.\n\nPresets (primary usage):\n  baker gsc query --preset cannibalization\n  baker gsc query --preset brand-halo --brand \"Acme\" --days 90\n  baker gsc query --list-presets\n\nFree-form (escape hatch):\n  baker gsc query --dimensions \"query,page\" --days 28\n  baker gsc query --dimensions \"query\" --row-limit 25000 --out keywords.csv`,\n  },\n  args: {\n    \"site-url\": { type: \"string\", description: \"Site URL\", required: false },\n    preset: { type: \"string\", description: \"Named preset\", required: false },\n    brand: { type: \"string\", description: \"Brand name for brand-halo preset\", required: false },\n    dimensions: { type: \"string\", description: \"Comma-separated dimensions\", required: false },\n    days: { type: \"string\", description: \"Lookback days (default: 28)\", required: false },\n    \"start-date\": { type: \"string\", description: \"Start date override\", required: false },\n    \"end-date\": { type: \"string\", description: \"End date override\", required: false },\n    \"row-limit\": { type: \"string\", description: \"Max rows (default: 1000)\", required: false },\n    type: { type: \"string\", description: \"Search type (default: web)\", required: false },\n    filter: { type: \"string\", description: \"Filter JSON\", required: false },\n    \"list-presets\": { type: \"boolean\", description: \"List presets\", required: false },\n    out: { type: \"string\", description: \"Output file path\", required: false },\n    append: { type: \"boolean\", description: \"Append to file\", required: false },\n    output: { type: \"string\", description: \"Format: json|csv|jsonl|md\", required: false, default: \"json\" },\n    \"no-cache\": { type: \"boolean\", description: \"Skip cache\", required: false },\n  },\n  run: async ({ args }) => {\n    if (args[\"list-presets\"]) {\n      writeJsonEnvelope({\n        ok: true,\n        data: GSC_PRESETS.map((p) => ({\n          name: p.name,\n          description: p.description,\n          playbook: p.playbook,\n          ...(p.requiresBrand && { requiresBrand: true }),\n        })),\n      });\n      return;\n    }\n\n    if (!args.preset && !args.dimensions) {\n      writeJsonEnvelope({\n        ok: false,\n        error: {\n          code: \"VALIDATION_ERROR\",\n          message: \"Provide --preset or --dimensions. Run --list-presets to see options.\",\n        },\n      });\n      process.exit(1);\n    }\n\n    const siteUrl = await resolveSiteUrl(args);\n    const useCache = !args[\"no-cache\"];\n    const body = buildRequestBody(args, siteUrl, useCache);\n    const cacheKey = buildQueryCacheKey(siteUrl, JSON.stringify(body));\n\n    if (useCache) {\n      const cached = cacheGet<QueryApiResponse>(\"gsc-queries\", cacheKey);\n      if (cached) {\n        outputRows(cached.data.data ?? [], args, cached.data, true);\n        return;\n      }\n    }\n\n    try {\n      const response = await apiPost<QueryApiResponse>(\"/api/gsc/query\", body);\n      if (useCache) {\n        cacheSet(\"gsc-queries\", cacheKey, response, getQueryTtl(JSON.stringify(body)));\n      }\n      outputRows(response.data ?? [], args, response, false);\n    } catch (err) {\n      handleError(err);\n    }\n  },\n});\n","interface GscPreset {\n  name: string;\n  description: string;\n  playbook: string;\n  requiresBrand?: boolean;\n}\n\nexport const GSC_PRESETS: GscPreset[] = [\n  {\n    name: \"cannibalization\",\n    description: \"PPC-SEO arbitrage — find queries ranking #1-2 organically where you also pay for ads\",\n    playbook: \"[05] PPC-SEO Arbitrage\",\n  },\n  {\n    name: \"missed-revenue\",\n    description: \"High-impression queries with no PPC coverage (position > 10)\",\n    playbook: \"[05] Opportunity Finder\",\n  },\n  {\n    name: \"brand-halo\",\n    description: \"Brand search volume trends — proves upper-funnel awareness lift\",\n    playbook: \"[21] YouTube/DG ROI\",\n    requiresBrand: true,\n  },\n  {\n    name: \"negative-keywords\",\n    description: \"Discover negative keyword candidates (login, support, cancel queries)\",\n    playbook: \"Negative Keyword Discovery\",\n  },\n  {\n    name: \"top-pages\",\n    description: \"Top performing pages by clicks\",\n    playbook: \"General\",\n  },\n  {\n    name: \"top-queries\",\n    description: \"Top search queries by clicks\",\n    playbook: \"General\",\n  },\n];\n"],"mappings":"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","names":[]}

package/dist/query-QK4U4TEL.js

@@ -0,0 +1,236 @@
+import {
+  resolvePropertyId
+} from "./chunk-LKPJADL2.js";
+import {
+  buildQueryCacheKey,
+  cacheGet,
+  cacheSet,
+  getQueryTtl,
+  handleConnectionError,
+  isNotConnectedError,
+  toCsvRow,
+  writeAdsOutput,
+  writeJsonEnvelope
+} from "./chunk-EIGXX6KI.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-CUL3VB4L.js";
+import "./chunk-6YYSUISH.js";
+import "./chunk-I4FTS5EE.js";
+import {
+  registerSchema
+} from "./chunk-MYTDK3AL.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ga4/query.ts
+import { appendFileSync, existsSync, readFileSync, writeFileSync } from "fs";
+import { resolve } from "path";
+import { defineCommand } from "citty";
+
+// src/commands/ga4/presets.ts
+var GA4_PRESETS = [
+  {
+    name: "tracking-health",
+    description: "Compare GA4 sessions to GAds clicks \u2014 flag >20% discrepancy",
+    playbook: "[07] Discrepancy Check"
+  },
+  {
+    name: "lp-performance",
+    description: "Landing page UX diagnostic \u2014 flag duration <10s as message mismatch",
+    playbook: "[06] LP Diagnostic"
+  },
+  {
+    name: "traffic-quality",
+    description: "Warm traffic trap \u2014 flag >40% returning user conversions",
+    playbook: "[06] Warm Traffic Trap"
+  },
+  {
+    name: "funnel-leakage",
+    description: "Funnel drop-off analysis between form events",
+    playbook: "[06] Funnel Analysis"
+  },
+  {
+    name: "first-touch",
+    description: "First-touch attribution \u2014 true acquisition value of channels",
+    playbook: "First-Touch Attribution"
+  },
+  {
+    name: "traffic-overview",
+    description: "General traffic trends by date and source",
+    playbook: "General"
+  }
+];
+
+// src/commands/ga4/query.ts
+registerSchema({
+  command: "ga4.query",
+  description: "Run GA4 Data API reports. Use --preset for playbook-aligned queries (primary usage) or --dimensions/--metrics for free-form queries.",
+  args: {
+    "property-id": { type: "string", description: "GA4 property ID (auto-resolved if not provided)", required: false },
+    preset: {
+      type: "string",
+      description: "Named preset (tracking-health, lp-performance, traffic-quality, funnel-leakage, first-touch, traffic-overview)",
+      required: false
+    },
+    dimensions: { type: "string", description: "Comma-separated dimension names (escape hatch)", required: false },
+    metrics: { type: "string", description: "Comma-separated metric names (escape hatch)", required: false },
+    days: { type: "string", description: "Lookback window in days (default: 30)", required: false },
+    "start-date": {
+      type: "string",
+      description: "Explicit start date (YYYY-MM-DD or GA4 relative like '30daysAgo')",
+      required: false
+    },
+    "end-date": { type: "string", description: "Explicit end date (YYYY-MM-DD or 'yesterday')", required: false },
+    limit: { type: "string", description: "Max rows (default: 1000)", required: false },
+    "list-presets": { type: "boolean", description: "List available presets", required: false },
+    out: { type: "string", description: "Write data to file (.csv, .jsonl, .json)", required: false },
+    append: { type: "boolean", description: "Append to existing file", required: false },
+    output: { type: "string", description: "Format: json|csv|jsonl|md", required: false, default: "json" },
+    "no-cache": { type: "boolean", description: "Skip cache", required: false }
+  }
+});
+function extractFields(rows) {
+  const first = rows[0];
+  return first ? Object.keys(first) : [];
+}
+function writeRowsToFile(filePath, rows, append) {
+  const fields = extractFields(rows);
+  const ext = filePath.split(".").pop()?.toLowerCase();
+  if (ext === "csv") {
+    if (!append || !existsSync(filePath)) {
+      writeFileSync(filePath, `${toCsvRow(fields)}
+`, "utf-8");
+    }
+    const csvRows = rows.map((row) => toCsvRow(fields.map((f) => String(row[f] ?? ""))));
+    appendFileSync(filePath, `${csvRows.join("\n")}
+`, "utf-8");
+  } else if (ext === "jsonl") {
+    const lines = rows.map((row) => JSON.stringify(row));
+    const content = `${lines.join("\n")}
+`;
+    if (append && existsSync(filePath)) {
+      appendFileSync(filePath, content, "utf-8");
+    } else {
+      writeFileSync(filePath, content, "utf-8");
+    }
+  } else if (append && existsSync(filePath)) {
+    const existing = JSON.parse(readFileSync(filePath, "utf-8"));
+    writeFileSync(filePath, JSON.stringify([...existing, ...rows], null, 2), "utf-8");
+  } else {
+    writeFileSync(filePath, JSON.stringify(rows, null, 2), "utf-8");
+  }
+}
+function outputRows(rows, args, response, cached) {
+  if (args.out) {
+    const filePath = resolve(args.out);
+    writeRowsToFile(filePath, rows, !!args.append);
+    writeJsonEnvelope({ ok: true, file: filePath, rows: rows.length, ...cached && { cached: true } });
+    return;
+  }
+  const format = args.output || "json";
+  if (format !== "json") {
+    writeAdsOutput(rows, format);
+    return;
+  }
+  writeJsonEnvelope({ ...response, ...cached && { cached: true } });
+}
+function buildRequestBody(args, propertyId, useCache) {
+  const body = { propertyId };
+  if (args.preset) body.preset = args.preset;
+  if (args.dimensions) body.dimensions = args.dimensions.split(",").map((d) => d.trim());
+  if (args.metrics) body.metrics = args.metrics.split(",").map((m) => m.trim());
+  if (args.days) body.days = Number(args.days);
+  if (args["start-date"]) body.startDate = args["start-date"];
+  if (args["end-date"]) body.endDate = args["end-date"];
+  if (args.limit) body.limit = Number(args.limit);
+  if (!useCache) body.skipCache = true;
+  return body;
+}
+function handleError(err) {
+  if (err instanceof ApiError) {
+    if (isNotConnectedError(err.code, err.message)) {
+      handleConnectionError("ga4", err.message);
+    }
+    writeJsonEnvelope({ ok: false, error: { code: err.code, message: err.message } });
+    process.exit(1);
+  }
+  writeJsonEnvelope({
+    ok: false,
+    error: { code: "NETWORK_ERROR", message: err instanceof Error ? err.message : "Unexpected error" }
+  });
+  process.exit(1);
+}
+var queryCommand = defineCommand({
+  meta: {
+    name: "query",
+    description: `Run GA4 Data API reports. Preset-first with free-form escape hatch.
+
+Presets (primary usage):
+  baker ga4 query --preset tracking-health
+  baker ga4 query --preset lp-performance --days 14
+  baker ga4 query --list-presets
+
+Free-form (escape hatch):
+  baker ga4 query --dimensions "date,sessionSourceMedium" --metrics "sessions,conversions"
+  baker ga4 query --metrics "eventCount" --dimensions "eventName" --days 7`
+  },
+  args: {
+    "property-id": { type: "string", description: "GA4 property ID", required: false },
+    preset: { type: "string", description: "Named preset", required: false },
+    dimensions: { type: "string", description: "Comma-separated dimensions", required: false },
+    metrics: { type: "string", description: "Comma-separated metrics", required: false },
+    days: { type: "string", description: "Lookback days (default: 30)", required: false },
+    "start-date": { type: "string", description: "Start date override", required: false },
+    "end-date": { type: "string", description: "End date override", required: false },
+    limit: { type: "string", description: "Max rows (default: 1000)", required: false },
+    "list-presets": { type: "boolean", description: "List presets", required: false },
+    out: { type: "string", description: "Output file path", required: false },
+    append: { type: "boolean", description: "Append to file", required: false },
+    output: { type: "string", description: "Format: json|csv|jsonl|md", required: false, default: "json" },
+    "no-cache": { type: "boolean", description: "Skip cache", required: false }
+  },
+  run: async ({ args }) => {
+    if (args["list-presets"]) {
+      writeJsonEnvelope({
+        ok: true,
+        data: GA4_PRESETS.map((p) => ({ name: p.name, description: p.description, playbook: p.playbook }))
+      });
+      return;
+    }
+    if (!args.preset && !args.metrics) {
+      writeJsonEnvelope({
+        ok: false,
+        error: {
+          code: "VALIDATION_ERROR",
+          message: "Provide --preset or --metrics. Run --list-presets to see options."
+        }
+      });
+      process.exit(1);
+    }
+    const propertyId = await resolvePropertyId(args);
+    const useCache = !args["no-cache"];
+    const body = buildRequestBody(args, propertyId, useCache);
+    const cacheKey = buildQueryCacheKey(propertyId, JSON.stringify(body));
+    if (useCache) {
+      const cached = cacheGet("ga4-queries", cacheKey);
+      if (cached) {
+        outputRows(cached.data.data ?? [], args, cached.data, true);
+        return;
+      }
+    }
+    try {
+      const response = await apiPost("/api/ga4/query", body);
+      if (useCache) {
+        cacheSet("ga4-queries", cacheKey, response, getQueryTtl(JSON.stringify(body)));
+      }
+      outputRows(response.data ?? [], args, response, false);
+    } catch (err) {
+      handleError(err);
+    }
+  }
+});
+export {
+  queryCommand
+};
+//# sourceMappingURL=query-QK4U4TEL.js.map

package/dist/query-QK4U4TEL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ga4/query.ts","../src/commands/ga4/presets.ts"],"sourcesContent":["import { appendFileSync, existsSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\nimport { defineCommand } from \"citty\";\nimport { ApiError, apiPost } from \"../../client.ts\";\nimport { handleConnectionError, isNotConnectedError } from \"../../error-handler.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { buildQueryCacheKey, cacheGet, cacheSet, getQueryTtl } from \"../ads/cache.ts\";\nimport { toCsvRow, writeAdsOutput, writeJsonEnvelope } from \"../ads/output.ts\";\nimport { GA4_PRESETS } from \"./presets.ts\";\nimport { resolvePropertyId } from \"./resolve.ts\";\n\nregisterSchema({\n  command: \"ga4.query\",\n  description:\n    \"Run GA4 Data API reports. Use --preset for playbook-aligned queries (primary usage) or --dimensions/--metrics for free-form queries.\",\n  args: {\n    \"property-id\": { type: \"string\", description: \"GA4 property ID (auto-resolved if not provided)\", required: false },\n    preset: {\n      type: \"string\",\n      description:\n        \"Named preset (tracking-health, lp-performance, traffic-quality, funnel-leakage, first-touch, traffic-overview)\",\n      required: false,\n    },\n    dimensions: { type: \"string\", description: \"Comma-separated dimension names (escape hatch)\", required: false },\n    metrics: { type: \"string\", description: \"Comma-separated metric names (escape hatch)\", required: false },\n    days: { type: \"string\", description: \"Lookback window in days (default: 30)\", required: false },\n    \"start-date\": {\n      type: \"string\",\n      description: \"Explicit start date (YYYY-MM-DD or GA4 relative like '30daysAgo')\",\n      required: false,\n    },\n    \"end-date\": { type: \"string\", description: \"Explicit end date (YYYY-MM-DD or 'yesterday')\", required: false },\n    limit: { type: \"string\", description: \"Max rows (default: 1000)\", required: false },\n    \"list-presets\": { type: \"boolean\", description: \"List available presets\", required: false },\n    out: { type: \"string\", description: \"Write data to file (.csv, .jsonl, .json)\", required: false },\n    append: { type: \"boolean\", description: \"Append to existing file\", required: false },\n    output: { type: \"string\", description: \"Format: json|csv|jsonl|md\", required: false, default: \"json\" },\n    \"no-cache\": { type: \"boolean\", description: \"Skip cache\", required: false },\n  },\n});\n\ninterface QueryApiResponse {\n  ok: boolean;\n  data?: Array<Record<string, unknown>>;\n  rowCount?: number;\n  warnings?: Array<{ code: string; message: string }>;\n  preset?: string;\n  error?: { code: string; message: string };\n}\n\nfunction extractFields(rows: Array<Record<string, unknown>>): string[] {\n  const first = rows[0];\n  return first ? Object.keys(first) : [];\n}\n\nfunction writeRowsToFile(filePath: string, rows: Array<Record<string, unknown>>, append: boolean): void {\n  const fields = extractFields(rows);\n  const ext = filePath.split(\".\").pop()?.toLowerCase();\n  if (ext === \"csv\") {\n    if (!append || !existsSync(filePath)) {\n      writeFileSync(filePath, `${toCsvRow(fields)}\\n`, \"utf-8\");\n    }\n    const csvRows = rows.map((row) => toCsvRow(fields.map((f) => String(row[f] ?? \"\"))));\n    appendFileSync(filePath, `${csvRows.join(\"\\n\")}\\n`, \"utf-8\");\n  } else if (ext === \"jsonl\") {\n    const lines = rows.map((row) => JSON.stringify(row));\n    const content = `${lines.join(\"\\n\")}\\n`;\n    if (append && existsSync(filePath)) {\n      appendFileSync(filePath, content, \"utf-8\");\n    } else {\n      writeFileSync(filePath, content, \"utf-8\");\n    }\n  } else if (append && existsSync(filePath)) {\n    const existing = JSON.parse(readFileSync(filePath, \"utf-8\")) as unknown[];\n    writeFileSync(filePath, JSON.stringify([...existing, ...rows], null, 2), \"utf-8\");\n  } else {\n    writeFileSync(filePath, JSON.stringify(rows, null, 2), \"utf-8\");\n  }\n}\n\nfunction outputRows(\n  rows: Array<Record<string, unknown>>,\n  args: Record<string, unknown>,\n  response: QueryApiResponse,\n  cached: boolean,\n): void {\n  if (args.out) {\n    const filePath = resolve(args.out as string);\n    writeRowsToFile(filePath, rows, !!args.append);\n    writeJsonEnvelope({ ok: true, file: filePath, rows: rows.length, ...(cached && { cached: true }) });\n    return;\n  }\n  const format = (args.output as string) || \"json\";\n  if (format !== \"json\") {\n    writeAdsOutput(rows, format);\n    return;\n  }\n  writeJsonEnvelope({ ...response, ...(cached && { cached: true }) });\n}\n\nfunction buildRequestBody(\n  args: Record<string, unknown>,\n  propertyId: string,\n  useCache: boolean,\n): Record<string, unknown> {\n  const body: Record<string, unknown> = { propertyId };\n  if (args.preset) body.preset = args.preset;\n  if (args.dimensions) body.dimensions = (args.dimensions as string).split(\",\").map((d) => d.trim());\n  if (args.metrics) body.metrics = (args.metrics as string).split(\",\").map((m) => m.trim());\n  if (args.days) body.days = Number(args.days);\n  if (args[\"start-date\"]) body.startDate = args[\"start-date\"];\n  if (args[\"end-date\"]) body.endDate = args[\"end-date\"];\n  if (args.limit) body.limit = Number(args.limit);\n  if (!useCache) body.skipCache = true;\n  return body;\n}\n\nfunction handleError(err: unknown): never {\n  if (err instanceof ApiError) {\n    if (isNotConnectedError(err.code, err.message)) {\n      handleConnectionError(\"ga4\", err.message);\n    }\n    writeJsonEnvelope({ ok: false, error: { code: err.code, message: err.message } });\n    process.exit(1);\n  }\n  writeJsonEnvelope({\n    ok: false,\n    error: { code: \"NETWORK_ERROR\", message: err instanceof Error ? err.message : \"Unexpected error\" },\n  });\n  process.exit(1);\n}\n\nexport const queryCommand = defineCommand({\n  meta: {\n    name: \"query\",\n    description: `Run GA4 Data API reports. Preset-first with free-form escape hatch.\n\nPresets (primary usage):\n  baker ga4 query --preset tracking-health\n  baker ga4 query --preset lp-performance --days 14\n  baker ga4 query --list-presets\n\nFree-form (escape hatch):\n  baker ga4 query --dimensions \"date,sessionSourceMedium\" --metrics \"sessions,conversions\"\n  baker ga4 query --metrics \"eventCount\" --dimensions \"eventName\" --days 7`,\n  },\n  args: {\n    \"property-id\": { type: \"string\", description: \"GA4 property ID\", required: false },\n    preset: { type: \"string\", description: \"Named preset\", required: false },\n    dimensions: { type: \"string\", description: \"Comma-separated dimensions\", required: false },\n    metrics: { type: \"string\", description: \"Comma-separated metrics\", required: false },\n    days: { type: \"string\", description: \"Lookback days (default: 30)\", required: false },\n    \"start-date\": { type: \"string\", description: \"Start date override\", required: false },\n    \"end-date\": { type: \"string\", description: \"End date override\", required: false },\n    limit: { type: \"string\", description: \"Max rows (default: 1000)\", required: false },\n    \"list-presets\": { type: \"boolean\", description: \"List presets\", required: false },\n    out: { type: \"string\", description: \"Output file path\", required: false },\n    append: { type: \"boolean\", description: \"Append to file\", required: false },\n    output: { type: \"string\", description: \"Format: json|csv|jsonl|md\", required: false, default: \"json\" },\n    \"no-cache\": { type: \"boolean\", description: \"Skip cache\", required: false },\n  },\n  run: async ({ args }) => {\n    if (args[\"list-presets\"]) {\n      writeJsonEnvelope({\n        ok: true,\n        data: GA4_PRESETS.map((p) => ({ name: p.name, description: p.description, playbook: p.playbook })),\n      });\n      return;\n    }\n\n    if (!args.preset && !args.metrics) {\n      writeJsonEnvelope({\n        ok: false,\n        error: {\n          code: \"VALIDATION_ERROR\",\n          message: \"Provide --preset or --metrics. Run --list-presets to see options.\",\n        },\n      });\n      process.exit(1);\n    }\n\n    const propertyId = await resolvePropertyId(args);\n    const useCache = !args[\"no-cache\"];\n    const body = buildRequestBody(args, propertyId, useCache);\n    const cacheKey = buildQueryCacheKey(propertyId, JSON.stringify(body));\n\n    if (useCache) {\n      const cached = cacheGet<QueryApiResponse>(\"ga4-queries\", cacheKey);\n      if (cached) {\n        outputRows(cached.data.data ?? [], args, cached.data, true);\n        return;\n      }\n    }\n\n    try {\n      const response = await apiPost<QueryApiResponse>(\"/api/ga4/query\", body);\n      if (useCache) {\n        cacheSet(\"ga4-queries\", cacheKey, response, getQueryTtl(JSON.stringify(body)));\n      }\n      outputRows(response.data ?? [], args, response, false);\n    } catch (err) {\n      handleError(err);\n    }\n  },\n});\n","interface Ga4Preset {\n  name: string;\n  description: string;\n  playbook: string;\n}\n\nexport const GA4_PRESETS: Ga4Preset[] = [\n  {\n    name: \"tracking-health\",\n    description: \"Compare GA4 sessions to GAds clicks — flag >20% discrepancy\",\n    playbook: \"[07] Discrepancy Check\",\n  },\n  {\n    name: \"lp-performance\",\n    description: \"Landing page UX diagnostic — flag duration <10s as message mismatch\",\n    playbook: \"[06] LP Diagnostic\",\n  },\n  {\n    name: \"traffic-quality\",\n    description: \"Warm traffic trap — flag >40% returning user conversions\",\n    playbook: \"[06] Warm Traffic Trap\",\n  },\n  {\n    name: \"funnel-leakage\",\n    description: \"Funnel drop-off analysis between form events\",\n    playbook: \"[06] Funnel Analysis\",\n  },\n  {\n    name: \"first-touch\",\n    description: \"First-touch attribution — true acquisition value of channels\",\n    playbook: \"First-Touch Attribution\",\n  },\n  {\n    name: \"traffic-overview\",\n    description: \"General traffic trends by date and source\",\n    playbook: \"General\",\n  },\n];\n"],"mappings":"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","names":[]}