@koda-sl/baker-cli 0.344.0 → 0.345.0-dev.9f4314fa9

package/dist/cli.js

@@ -67,7 +67,7 @@ import {
   validateCanvasDeep,
   withoutCastName,
   ytDlpBlockSignal
-} from "./chunk-FFOURYP5.js";
+} from "./chunk-D5P4COPD.js";
 import {
   csvOrJson,
   daysAgoIso,
@@ -31032,6 +31032,278 @@ function mergeStoredWithCounts(stored, reported) {
   }).sort((a, b) => a.name.localeCompare(b.name));
 }
 
+// src/commands/analytics/render.ts
+var SPARKLINE_POINTS = 30;
+var DASHBOARD_ONLY_FIELDS = /* @__PURE__ */ new Set([
+  // The Convex row id. It exists so a dashboard can link to the row; an agent
+  // addresses a landing by `landingId`, which is the id in its `_definition.md`.
+  "landingRef"
+]);
+function isAbsent(value) {
+  if (value === "") return true;
+  if (Array.isArray(value)) return value.length === 0;
+  if (typeof value === "object" && value !== null) return Object.keys(value).length === 0;
+  return false;
+}
+function resample(series, points) {
+  if (series.length <= points || points < 1) return [...series];
+  const out = [];
+  for (let i = 0; i < points; i += 1) {
+    const from = Math.floor(i * series.length / points);
+    const to = Math.floor((i + 1) * series.length / points);
+    let sum = 0;
+    for (let j = from; j < to; j += 1) sum += series[j] ?? 0;
+    out.push(sum);
+  }
+  return out;
+}
+function pruneValue(value, full) {
+  if (Array.isArray(value)) return value.map((entry) => pruneValue(entry, full));
+  if (typeof value === "object" && value !== null) {
+    return pruneRow(value, full);
+  }
+  return value;
+}
+function pruneRow(row, full) {
+  const out = {};
+  for (const [key, value] of Object.entries(row)) {
+    if (DASHBOARD_ONLY_FIELDS.has(key)) continue;
+    if (key === "sparkline" && Array.isArray(value)) {
+      if (!full) continue;
+      out[key] = resample(value, SPARKLINE_POINTS);
+      continue;
+    }
+    if (isAbsent(value)) continue;
+    out[key] = pruneValue(value, full);
+  }
+  return out;
+}
+function pruneForAgent(data, full) {
+  return pruneRow(data, full);
+}
+function isTabular(rows) {
+  return rows.every(
+    (row) => typeof row === "object" && row !== null && !Array.isArray(row) && Object.values(row).every(
+      (value) => value === null || typeof value !== "object" || Array.isArray(value) && value.every((e) => typeof e !== "object")
+    )
+  );
+}
+function cell2(value, key) {
+  if (value === null || value === void 0) return "";
+  if (Array.isArray(value)) return value.join(" ");
+  if (typeof value === "number" && !Number.isInteger(value)) {
+    if (key?.endsWith("Ms")) return String(Math.round(value));
+    return value.toFixed(4).replace(/0+$/, "").replace(/\.$/, "");
+  }
+  return String(value);
+}
+var IDENTITY_COLUMNS = [
+  "landingId",
+  "name",
+  "slug",
+  "path",
+  "flowSlug",
+  "stepId",
+  "value",
+  "key",
+  "bucket",
+  "tag",
+  "eventName",
+  "release",
+  "place",
+  "bot",
+  "source",
+  "medium",
+  "campaign",
+  "platform",
+  "sessionId",
+  "eventId"
+];
+function byIdentityFirst(a, b) {
+  const ia = IDENTITY_COLUMNS.indexOf(a);
+  const ib = IDENTITY_COLUMNS.indexOf(b);
+  if (ia !== -1 || ib !== -1)
+    return (ia === -1 ? Number.MAX_SAFE_INTEGER : ia) - (ib === -1 ? Number.MAX_SAFE_INTEGER : ib);
+  return 0;
+}
+var BLOCK_ORDER = ["window", "totals", "previous", "pageInfo"];
+function byBlockOrder(a, b) {
+  const rank = (key) => {
+    const at = BLOCK_ORDER.indexOf(key);
+    if (at !== -1) return at;
+    return key === "preset" ? BLOCK_ORDER.length + 1 : BLOCK_ORDER.length;
+  };
+  return rank(a) - rank(b);
+}
+function columnsOf(rows) {
+  const seen = [];
+  for (const row of rows) {
+    for (const key of Object.keys(row)) {
+      if (!seen.includes(key)) seen.push(key);
+    }
+  }
+  return seen.filter((key) => rows.some((row) => !isAbsent(row[key]) && row[key] !== null && row[key] !== void 0)).sort(byIdentityFirst);
+}
+function table2(rows) {
+  const cols = columnsOf(rows);
+  if (cols.length === 0) return "";
+  const head = `| ${cols.join(" | ")} |`;
+  const rule = `| ${cols.map(() => "---").join(" | ")} |`;
+  const body = rows.map((row) => `| ${cols.map((col) => cell2(row[col], col)).join(" | ")} |`);
+  return [head, rule, ...body].join("\n");
+}
+function isRowList(value) {
+  return Array.isArray(value) && value.length > 0 && value.every((entry) => typeof entry === "object" && entry !== null && !Array.isArray(entry));
+}
+function labelOf(row, index) {
+  for (const key of IDENTITY_COLUMNS) {
+    const value = row[key];
+    if (typeof value === "string" && value !== "") return value;
+  }
+  return `#${index + 1}`;
+}
+function nestedBlock(name, rows) {
+  const parents = rows.map(
+    (row) => Object.fromEntries(Object.entries(row).filter(([, value]) => !isRowList(value) && !isPlainRow(value)))
+  );
+  const parts = [`### ${name}`, table2(parents)];
+  rows.forEach((row, index) => {
+    for (const [key, value] of Object.entries(row)) {
+      if (isRowList(value)) parts.push(`#### ${name}[${labelOf(row, index)}].${key}`, table2(value));
+      else if (isPlainRow(value)) parts.push(`#### ${name}[${labelOf(row, index)}].${key}`, table2([value]));
+    }
+  });
+  return parts.filter((part) => part !== "").join("\n");
+}
+function isPlainRow(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function block(name, value) {
+  if (Array.isArray(value)) {
+    if (value.length === 0) return "";
+    if (isTabular(value)) return `### ${name}
+${table2(value)}`;
+    if (isRowList(value)) return nestedBlock(name, value);
+    return `### ${name}
+${JSON.stringify(value)}`;
+  }
+  if (typeof value === "object" && value !== null) {
+    const entries = Object.entries(value);
+    if (entries.length === 0) return "";
+    if (entries.every(([, v]) => v === null || typeof v !== "object")) {
+      return `### ${name}
+${entries.map(([k, v]) => `- ${k}: ${v === null ? "null" : cell2(v, k)}`).join("\n")}`;
+    }
+    return `### ${name}
+${JSON.stringify(value)}`;
+  }
+  return `### ${name}
+${cell2(value)}`;
+}
+function renderMarkdown3(envelope) {
+  const parts = [];
+  for (const warning of envelope.warnings ?? []) parts.push(`> **${warning.code}** \u2014 ${warning.message}`);
+  for (const hint of envelope.hints ?? []) parts.push(`> ${hint}`);
+  for (const [name, value] of Object.entries(envelope.data).sort(([a], [b]) => byBlockOrder(a, b))) {
+    const rendered = block(name, value);
+    if (rendered !== "") parts.push(rendered);
+  }
+  return `${parts.join("\n\n")}
+`;
+}
+function missingBreakdownHint(data, asked) {
+  if (asked.eventName === void 0) return [];
+  const breakdown = data.eventBreakdown;
+  if (Array.isArray(breakdown) && breakdown.length > 0) return [];
+  const known = Array.isArray(data.customEvents) ? data.customEvents.flatMap((row) => isPlainRow(row) && typeof row.eventName === "string" ? [row.eventName] : []) : [];
+  return [
+    `No rows came back for --event ${asked.eventName}${asked.property ? ` --property ${asked.property}` : ""}. That event or property does not exist on these pages${known.length > 0 ? `; the ones that do are: ${known.slice(0, 12).join(", ")}${known.length > 12 ? ", \u2026" : ""}` : ""}.`
+  ];
+}
+var ANALYTICS_OUTPUT_FORMATS = ["json", "md"];
+function isAnalyticsOutputFormat(value) {
+  return ANALYTICS_OUTPUT_FORMATS.includes(value);
+}
+function writeAnalyticsReport(envelope, format) {
+  if (format === "md") {
+    process.stdout.write(renderMarkdown3(envelope));
+    return;
+  }
+  process.stdout.write(`${JSON.stringify(envelope)}
+`);
+}
+var ROWS_BEFORE_FORMAT_HINT = 25;
+function rowCount(data) {
+  let total = 0;
+  for (const value of Object.values(data)) {
+    if (Array.isArray(value)) total += value.length;
+  }
+  return total;
+}
+function formatHint(data, format) {
+  if (format === "md") return [];
+  const rows = rowCount(data);
+  if (rows < ROWS_BEFORE_FORMAT_HINT) return [];
+  return [
+    `This report is ${rows} rows. If you are going to read the numbers rather than pick one field out of them, --output md returns the same answer as tables, typically a third to a half smaller.`
+  ];
+}
+
+// src/commands/analytics/conversionsMarkdown.ts
+function doorsCell(doors) {
+  return doors.map((door) => `${door.door}=${door.events}/${door.sessions}`).join(" ");
+}
+function eventKeysCell(eventKeys) {
+  const formKeys = eventKeys.filter((key) => key.startsWith("form:")).length;
+  const others = eventKeys.filter((key) => !key.startsWith("form:"));
+  return [...others, ...formKeys > 0 ? [`${formKeys} Form ending(s)`] : []].join(" + ");
+}
+function trafficByForm(candidates) {
+  const byForm = /* @__PURE__ */ new Map();
+  for (const row of candidates) {
+    const form = byForm.get(row.flowSlug) ?? { "endings seen": 0, "endings counted": 0, events: 0, lastSeen: "" };
+    form["endings seen"] += 1;
+    if (row.isCounted) form["endings counted"] += 1;
+    form.events += row.events;
+    if (row.lastSeen && row.lastSeen.slice(0, 10) > form.lastSeen) form.lastSeen = row.lastSeen.slice(0, 10);
+    byForm.set(row.flowSlug, form);
+  }
+  return byForm;
+}
+var NO_TRAFFIC = { "endings seen": 0, "endings counted": 0, events: 0, lastSeen: "" };
+var FORM_KEYS_HINT = "A Form's candidates are one row per Form: `baker analytics conversions --flow <slug>` lists that Form's event keys, and `--candidates --output json` lists every key.";
+function renderConversionsMarkdown(envelope) {
+  const { definitions, flow, flows, candidates } = envelope.data;
+  const data = {
+    definitions: definitions.map(({ name, eventKeys, ...row }) => ({ name, eventKeys: eventKeysCell(eventKeys), ...row }))
+  };
+  if (flow) {
+    data.flow = { slug: flow.slug, noConversionReason: flow.noConversionReason };
+    data.flowEndings = flow.endings;
+  }
+  const traffic = candidates ? trafficByForm(candidates.filter((row) => row.flowSlug !== "")) : /* @__PURE__ */ new Map();
+  if (flows) {
+    data.flows = flows.map((row) => ({
+      slug: row.slug,
+      counted: row.counted.map((entry) => `${entry.name} @ ${entry.step}`).join("; "),
+      noConversion: row.noConversion,
+      ...candidates ? traffic.get(row.slug) ?? NO_TRAFFIC : {}
+    }));
+  }
+  const hints2 = [...envelope.hints ?? []];
+  if (candidates) {
+    const listed2 = new Set(flows?.map((row) => row.slug));
+    const unlisted = [...traffic].filter(([slug]) => !listed2.has(slug));
+    if (unlisted.length > 0) data.formCandidates = unlisted.map(([form, row]) => ({ form, ...row }));
+    data.candidates = candidates.filter((row) => row.flowSlug === "").map(({ doors, flowSlug: _flowSlug, nodeType: _nodeType, ...row }) => ({
+      ...row,
+      "doors (events/sessions)": doorsCell(doors)
+    }));
+    if (traffic.size > 0) hints2.push(FORM_KEYS_HINT);
+  }
+  return renderMarkdown3({ data, ...hints2.length > 0 ? { hints: hints2 } : {} });
+}
+
 // src/commands/analytics/errorEnvelope.ts
 function analyticsErrorEnvelope(err) {
   if (err instanceof ApiError) {
@@ -31523,223 +31795,6 @@ var ANALYTICS_PRESET_INFO = [
   }
 ];
 
-// src/commands/analytics/render.ts
-var SPARKLINE_POINTS = 30;
-var DASHBOARD_ONLY_FIELDS = /* @__PURE__ */ new Set([
-  // The Convex row id. It exists so a dashboard can link to the row; an agent
-  // addresses a landing by `landingId`, which is the id in its `_definition.md`.
-  "landingRef"
-]);
-function isAbsent(value) {
-  if (value === "") return true;
-  if (Array.isArray(value)) return value.length === 0;
-  if (typeof value === "object" && value !== null) return Object.keys(value).length === 0;
-  return false;
-}
-function resample(series, points) {
-  if (series.length <= points || points < 1) return [...series];
-  const out = [];
-  for (let i = 0; i < points; i += 1) {
-    const from = Math.floor(i * series.length / points);
-    const to = Math.floor((i + 1) * series.length / points);
-    let sum = 0;
-    for (let j = from; j < to; j += 1) sum += series[j] ?? 0;
-    out.push(sum);
-  }
-  return out;
-}
-function pruneValue(value, full) {
-  if (Array.isArray(value)) return value.map((entry) => pruneValue(entry, full));
-  if (typeof value === "object" && value !== null) {
-    return pruneRow(value, full);
-  }
-  return value;
-}
-function pruneRow(row, full) {
-  const out = {};
-  for (const [key, value] of Object.entries(row)) {
-    if (DASHBOARD_ONLY_FIELDS.has(key)) continue;
-    if (key === "sparkline" && Array.isArray(value)) {
-      if (!full) continue;
-      out[key] = resample(value, SPARKLINE_POINTS);
-      continue;
-    }
-    if (isAbsent(value)) continue;
-    out[key] = pruneValue(value, full);
-  }
-  return out;
-}
-function pruneForAgent(data, full) {
-  return pruneRow(data, full);
-}
-function isTabular(rows) {
-  return rows.every(
-    (row) => typeof row === "object" && row !== null && !Array.isArray(row) && Object.values(row).every(
-      (value) => value === null || typeof value !== "object" || Array.isArray(value) && value.every((e) => typeof e !== "object")
-    )
-  );
-}
-function cell2(value, key) {
-  if (value === null || value === void 0) return "";
-  if (Array.isArray(value)) return value.join(" ");
-  if (typeof value === "number" && !Number.isInteger(value)) {
-    if (key?.endsWith("Ms")) return String(Math.round(value));
-    return value.toFixed(4).replace(/0+$/, "").replace(/\.$/, "");
-  }
-  return String(value);
-}
-var IDENTITY_COLUMNS = [
-  "landingId",
-  "name",
-  "slug",
-  "path",
-  "flowSlug",
-  "stepId",
-  "value",
-  "key",
-  "bucket",
-  "tag",
-  "eventName",
-  "release",
-  "place",
-  "bot",
-  "source",
-  "medium",
-  "campaign",
-  "platform",
-  "sessionId",
-  "eventId"
-];
-function byIdentityFirst(a, b) {
-  const ia = IDENTITY_COLUMNS.indexOf(a);
-  const ib = IDENTITY_COLUMNS.indexOf(b);
-  if (ia !== -1 || ib !== -1)
-    return (ia === -1 ? Number.MAX_SAFE_INTEGER : ia) - (ib === -1 ? Number.MAX_SAFE_INTEGER : ib);
-  return 0;
-}
-var BLOCK_ORDER = ["window", "totals", "previous", "pageInfo"];
-function byBlockOrder(a, b) {
-  const rank = (key) => {
-    const at = BLOCK_ORDER.indexOf(key);
-    if (at !== -1) return at;
-    return key === "preset" ? BLOCK_ORDER.length + 1 : BLOCK_ORDER.length;
-  };
-  return rank(a) - rank(b);
-}
-function columnsOf(rows) {
-  const seen = [];
-  for (const row of rows) {
-    for (const key of Object.keys(row)) {
-      if (!seen.includes(key)) seen.push(key);
-    }
-  }
-  return seen.filter((key) => rows.some((row) => !isAbsent(row[key]) && row[key] !== null && row[key] !== void 0)).sort(byIdentityFirst);
-}
-function table2(rows) {
-  const cols = columnsOf(rows);
-  if (cols.length === 0) return "";
-  const head = `| ${cols.join(" | ")} |`;
-  const rule = `| ${cols.map(() => "---").join(" | ")} |`;
-  const body = rows.map((row) => `| ${cols.map((col) => cell2(row[col], col)).join(" | ")} |`);
-  return [head, rule, ...body].join("\n");
-}
-function isRowList(value) {
-  return Array.isArray(value) && value.length > 0 && value.every((entry) => typeof entry === "object" && entry !== null && !Array.isArray(entry));
-}
-function labelOf(row, index) {
-  for (const key of IDENTITY_COLUMNS) {
-    const value = row[key];
-    if (typeof value === "string" && value !== "") return value;
-  }
-  return `#${index + 1}`;
-}
-function nestedBlock(name, rows) {
-  const parents = rows.map(
-    (row) => Object.fromEntries(Object.entries(row).filter(([, value]) => !isRowList(value) && !isPlainRow(value)))
-  );
-  const parts = [`### ${name}`, table2(parents)];
-  rows.forEach((row, index) => {
-    for (const [key, value] of Object.entries(row)) {
-      if (isRowList(value)) parts.push(`#### ${name}[${labelOf(row, index)}].${key}`, table2(value));
-      else if (isPlainRow(value)) parts.push(`#### ${name}[${labelOf(row, index)}].${key}`, table2([value]));
-    }
-  });
-  return parts.filter((part) => part !== "").join("\n");
-}
-function isPlainRow(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function block(name, value) {
-  if (Array.isArray(value)) {
-    if (value.length === 0) return "";
-    if (isTabular(value)) return `### ${name}
-${table2(value)}`;
-    if (isRowList(value)) return nestedBlock(name, value);
-    return `### ${name}
-${JSON.stringify(value)}`;
-  }
-  if (typeof value === "object" && value !== null) {
-    const entries = Object.entries(value);
-    if (entries.length === 0) return "";
-    if (entries.every(([, v]) => v === null || typeof v !== "object")) {
-      return `### ${name}
-${entries.map(([k, v]) => `- ${k}: ${v === null ? "null" : cell2(v, k)}`).join("\n")}`;
-    }
-    return `### ${name}
-${JSON.stringify(value)}`;
-  }
-  return `### ${name}
-${cell2(value)}`;
-}
-function renderMarkdown3(envelope) {
-  const parts = [];
-  for (const warning of envelope.warnings ?? []) parts.push(`> **${warning.code}** \u2014 ${warning.message}`);
-  for (const hint of envelope.hints ?? []) parts.push(`> ${hint}`);
-  for (const [name, value] of Object.entries(envelope.data).sort(([a], [b]) => byBlockOrder(a, b))) {
-    const rendered = block(name, value);
-    if (rendered !== "") parts.push(rendered);
-  }
-  return `${parts.join("\n\n")}
-`;
-}
-function missingBreakdownHint(data, asked) {
-  if (asked.eventName === void 0) return [];
-  const breakdown = data.eventBreakdown;
-  if (Array.isArray(breakdown) && breakdown.length > 0) return [];
-  const known = Array.isArray(data.customEvents) ? data.customEvents.flatMap((row) => isPlainRow(row) && typeof row.eventName === "string" ? [row.eventName] : []) : [];
-  return [
-    `No rows came back for --event ${asked.eventName}${asked.property ? ` --property ${asked.property}` : ""}. That event or property does not exist on these pages${known.length > 0 ? `; the ones that do are: ${known.slice(0, 12).join(", ")}${known.length > 12 ? ", \u2026" : ""}` : ""}.`
-  ];
-}
-var ANALYTICS_OUTPUT_FORMATS = ["json", "md"];
-function isAnalyticsOutputFormat(value) {
-  return ANALYTICS_OUTPUT_FORMATS.includes(value);
-}
-function writeAnalyticsReport(envelope, format) {
-  if (format === "md") {
-    process.stdout.write(renderMarkdown3(envelope));
-    return;
-  }
-  process.stdout.write(`${JSON.stringify(envelope)}
-`);
-}
-var ROWS_BEFORE_FORMAT_HINT = 25;
-function rowCount(data) {
-  let total = 0;
-  for (const value of Object.values(data)) {
-    if (Array.isArray(value)) total += value.length;
-  }
-  return total;
-}
-function formatHint(data, format) {
-  if (format === "md") return [];
-  const rows = rowCount(data);
-  if (rows < ROWS_BEFORE_FORMAT_HINT) return [];
-  return [
-    `This report is ${rows} rows. If you are going to read the numbers rather than pick one field out of them, --output md returns the same answer as tables, typically a third to a half smaller.`
-  ];
-}
-
 // src/commands/analytics/sends.ts
 import { defineCommand as defineCommand97 } from "citty";
 var SET_FLAGS = ["--source-event", "--platform", "--tag", "--event"];
@@ -32914,17 +32969,7 @@ async function runPreset(args5, options) {
     const response = await apiPost("/api/analytics/query", requestBody(args5, options));
     const requestedPlatform = args5.platform === void 0 ? "" : String(args5.platform);
     const adPlatformScope = isAdPlatform(requestedPlatform) ? requestedPlatform : void 0;
-    const format = args5.output === void 0 ? "json" : String(args5.output);
-    if (!isAnalyticsOutputFormat(format)) {
-      writeJsonEnvelope({
-        ok: false,
-        error: {
-          code: "VALIDATION_ERROR",
-          message: `Unknown --output "${format}". Use one of: ${ANALYTICS_OUTPUT_FORMATS.join(", ")}.`
-        }
-      });
-      process.exit(1);
-    }
+    const format = outputFormatOrExit(args5.output);
     const data = pruneForAgent(response.data, args5.full === true);
     const feed = "stream" in data ? shapeFeed(data.stream, args5.everything === true) : void 0;
     if (feed !== void 0) data.stream = feed.rows;
@@ -32954,6 +32999,20 @@ async function runPreset(args5, options) {
     handleError3(err);
   }
 }
+function outputFormatOrExit(raw) {
+  const format = raw === void 0 ? "json" : String(raw);
+  if (!isAnalyticsOutputFormat(format)) {
+    writeJsonEnvelope({
+      ok: false,
+      error: {
+        code: "VALIDATION_ERROR",
+        message: `Unknown --output "${format}". Use one of: ${ANALYTICS_OUTPUT_FORMATS.join(", ")}.`
+      }
+    });
+    process.exit(1);
+  }
+  return format;
+}
 function presetCommand(options) {
   registerSchema({
     command: `analytics.${options.name}`,
@@ -33455,7 +33514,8 @@ var conversionsCommand3 = (() => {
       type: "string",
       description: "Lookback for the counts and for --candidates. Default 30",
       required: false
-    }
+    },
+    output: SHARED_ARGS.output
   };
   registerSchema({
     command: "analytics.conversions",
@@ -33470,6 +33530,7 @@ var conversionsCommand3 = (() => {
     args: args5,
     run: async ({ args: raw }) => {
       try {
+        const format = outputFormatOrExit(raw.output);
         const args6 = parseConversionsArgs(raw, process.argv);
         for (const eventKey of args6.eventKeys) refuseUnmatchableKey(eventKey);
         const before = await apiPost("/api/analytics/conversions", {});
@@ -33479,13 +33540,13 @@ var conversionsCommand3 = (() => {
           preset: "conversions",
           days: args6.days
         });
-        writeJsonEnvelope(
-          conversionsEnvelope(
-            args6,
-            mergeStoredWithCounts(stored, report.data.conversions ?? []),
-            report.data.eventCatalog ?? []
-          )
+        const envelope = conversionsEnvelope(
+          args6,
+          mergeStoredWithCounts(stored, report.data.conversions ?? []),
+          report.data.eventCatalog ?? []
         );
+        if (format === "md") process.stdout.write(renderConversionsMarkdown(envelope));
+        else writeJsonEnvelope(envelope);
       } catch (err) {
         if (err instanceof ConversionArgsError) {
           handleError3(new ApiError("VALIDATION_ERROR", err.message));