@koda-sl/baker-cli 0.567.0 → 0.569.0

package/dist/config-GIETKZGS.js

@@ -0,0 +1,88 @@
+import {
+  handleError
+} from "./chunk-RIRSFFWA.js";
+import "./chunk-D5FY4FAK.js";
+import {
+  writeJsonEnvelope
+} from "./chunk-MK4HCMEA.js";
+import {
+  apiPost
+} from "./chunk-QEREDRZO.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import {
+  registerSchema
+} from "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ga4/config.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "ga4.config",
+  description: "Read how a Google Analytics property is configured to measure: key events (conversions), custom dimensions and metrics, custom events, audiences, linked Google Ads accounts, data streams and the data retention window. Start here before staging any change \u2014 every id an update or removal targets comes from this, and `canWrite` says whether this connection may change anything at all. Compact by default; pass --full for the raw Analytics objects AND each website stream's enhanced measurement settings (the automatic events), which are the only way to see what is on before changing a toggle.",
+  args: {
+    "property-id": { type: "string", description: "GA4 property id (optional when one is connected)", required: false },
+    full: {
+      type: "boolean",
+      description: "Include the raw Analytics object for each entity, plus each website stream's enhanced measurement settings",
+      required: false
+    }
+  }
+});
+function configHints(config) {
+  const hints = [];
+  if (!config.canWrite) {
+    hints.push(
+      "This connection can READ this property but not change it. Do not promise to configure anything \u2014 ask the user to reconnect Google Analytics in the dashboard first, and carry on with the reporting side of the job."
+    );
+  }
+  if (config.keyEvents.length === 0) {
+    hints.push(
+      "This property has no key events, so nothing is being counted as a conversion and Google Ads has nothing to import. Ask what counts as a lead or sale before proposing anything else."
+    );
+  }
+  if (config.dataRetention.eventDataRetention === "TWO_MONTHS") {
+    hints.push(
+      "Event data is only kept for 2 months, which makes any long-window analysis impossible. `baker ga4 data-retention set --event-data 14` stages the fix."
+    );
+  }
+  if (config.dataStreams.filter((stream) => stream.type === "WEB_DATA_STREAM").length > 1) {
+    hints.push("This property has more than one website data stream \u2014 pass --data-stream when staging a custom event.");
+  }
+  return hints;
+}
+var configCommand = defineCommand({
+  meta: {
+    name: "config",
+    description: `Read how the property is configured to measure \u2014 key events, custom definitions, custom events, retention
+
+Examples:
+  baker ga4 config
+  baker ga4 config --property-id 123456789
+  baker ga4 config --full          # + the automatic events each website stream collects today`
+  },
+  args: {
+    "property-id": { type: "string", description: "GA4 property id", required: false },
+    full: {
+      type: "boolean",
+      description: "Include raw Analytics objects and enhanced measurement settings",
+      required: false
+    }
+  },
+  run: async ({ args }) => {
+    try {
+      const data = await apiPost("/api/ga4/config", {
+        ...typeof args["property-id"] === "string" ? { propertyId: args["property-id"] } : {},
+        ...args.full === true ? { full: true } : {}
+      });
+      writeJsonEnvelope({ ok: true, data, hints: configHints(data) });
+    } catch (err) {
+      handleError(err);
+    }
+  }
+});
+export {
+  configCommand,
+  configHints
+};
+//# sourceMappingURL=config-GIETKZGS.js.map

package/dist/connect-O5NRDY4Y.js

@@ -0,0 +1,45 @@
+import {
+  attachDestination,
+  attachSettings,
+  attachStep,
+  connectCommand,
+  copyDestination,
+  destinationRefusal,
+  restatableTargets,
+  sealRequestFor,
+  targetsFor,
+  unpickedSteps,
+  unwiredHubspotForms,
+  unwiredSideEffects
+} from "./chunk-JWV7LUFM.js";
+import "./chunk-6E4KJMXO.js";
+import "./chunk-AIK2HPDZ.js";
+import "./chunk-UJTIMPEE.js";
+import "./chunk-2Q7K4F4H.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-R7XDGNZD.js";
+import "./chunk-XHWHBGKX.js";
+import "./chunk-QEREDRZO.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+export {
+  attachDestination,
+  attachSettings,
+  attachStep,
+  connectCommand,
+  copyDestination,
+  destinationRefusal,
+  restatableTargets,
+  sealRequestFor,
+  targetsFor,
+  unpickedSteps,
+  unwiredHubspotForms,
+  unwiredSideEffects
+};
+//# sourceMappingURL=connect-O5NRDY4Y.js.map

package/dist/conversation-YHKIB3CU.js

@@ -0,0 +1,96 @@
+import {
+  csvOrJson,
+  daysAgoIso,
+  handleLinkedinError,
+  todayIso
+} from "./chunk-W743FIEY.js";
+import {
+  writeAdsJson,
+  writeAdsOutput
+} from "./chunk-MK4HCMEA.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-GO6ISZUZ.js";
+import "./chunk-2Q7K4F4H.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-R7XDGNZD.js";
+import "./chunk-XHWHBGKX.js";
+import {
+  apiPost
+} from "./chunk-QEREDRZO.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/linkedin/conversation.ts
+import { defineCommand } from "citty";
+var conversationCommand = defineCommand({
+  meta: {
+    name: "conversation",
+    description: `Per-button click rates inside Sponsored Messaging / Conversation Ads.
+
+Returns one row per CONVERSATION_NODE_BUTTON pivot, sorted by clicks desc.
+Use this to A/B test button copy and the cascade tree.
+
+Examples:
+  baker ads linkedin conversation --campaign-id 1234
+  baker ads linkedin conversation --campaign-id 1234 --last-days 30 --output csv`
+  },
+  args: {
+    "campaign-id": {
+      type: "string",
+      description: "Comma-separated campaign IDs (Conversation Ad campaigns)",
+      required: true
+    },
+    start: { type: "string", description: "Start date YYYY-MM-DD" },
+    end: { type: "string", description: "End date YYYY-MM-DD" },
+    "last-days": { type: "string", description: "Window relative to today (default: 30)" },
+    "no-cache": NO_CACHE_ARG,
+    output: { type: "string", description: "json|csv|jsonl|md", default: "json" }
+  },
+  run: async ({ args }) => {
+    const campaignIdsRaw = args["campaign-id"];
+    if (!campaignIdsRaw) {
+      handleLinkedinError(new Error("--campaign-id is required"));
+    }
+    const ids = campaignIdsRaw.split(",").map((s) => s.trim()).filter(Boolean);
+    const start = args.start ?? daysAgoIso(args["last-days"] ? Number(args["last-days"]) : 30);
+    const end = args.end ?? todayIso();
+    try {
+      const data = await apiPost("/api/ads/linkedin/analytics", {
+        request: {
+          level: "campaign",
+          ids,
+          intent: "inmail",
+          pivot: "conversation-node-button",
+          start,
+          end,
+          granularity: "ALL",
+          limit: 500
+        },
+        skipCache: Boolean(args["no-cache"])
+      });
+      const sorted = [...data.rows].sort((a, b) => Number(b.clicks ?? 0) - Number(a.clicks ?? 0));
+      const fmt = csvOrJson(args);
+      if (fmt !== "json") {
+        writeAdsOutput(sorted, fmt, data.fields);
+        return;
+      }
+      writeAdsJson({
+        ok: true,
+        data: { query: { campaigns: ids, start, end }, rows: sorted, warnings: data.warnings }
+      });
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+export {
+  conversationCommand
+};
+//# sourceMappingURL=conversation-YHKIB3CU.js.map

package/dist/conversion-report-JV6WZLB3.js

@@ -0,0 +1,127 @@
+import {
+  CHATGPT_ADS_REFERENCE,
+  CHATGPT_CONVERSION_REPORT_LEVELS,
+  chatgptAdsConversionReportRequestSchema,
+  numberArg,
+  reportCsvArg,
+  runChatgptRead,
+  stringArg
+} from "./chunk-QZSNT67Z.js";
+import {
+  writeJsonEnvelope
+} from "./chunk-MK4HCMEA.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import {
+  apiPost
+} from "./chunk-QEREDRZO.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import {
+  registerSchema
+} from "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/chatgpt/conversion-report.ts
+import { defineCommand } from "citty";
+var ARGS = {
+  level: {
+    type: "string",
+    description: `What one row is: ${CHATGPT_CONVERSION_REPORT_LEVELS.join("|")} (default campaign)`
+  },
+  ids: {
+    type: "string",
+    description: "Campaign, ad group or ad ids, comma-separated \u2014 one row each. Left out: one total for the account"
+  },
+  days: { type: "string", description: "Last N complete days, ending the account's yesterday (default 7, max 365)" },
+  since: { type: "string", description: "First day, YYYY-MM-DD, account timezone (instead of --days)" },
+  until: { type: "string", description: "Last day, inclusive, YYYY-MM-DD" },
+  granularity: { type: "string", description: "none (default: one total) | daily" },
+  segment: { type: "string", description: "Break rows down by device or country" },
+  "click-window": { type: "string", description: "Days after a click that count: 7, 14 or 30 (default 30)" },
+  "view-window": { type: "string", description: "Days after a view that count: 1 (default) or 0 to leave views out" },
+  events: {
+    type: "string",
+    description: "Event names to detail, comma-separated, as the site sends them \u2014 goal or not (implies --with-events)"
+  },
+  "with-events": { type: "boolean", description: "Detail every attributed event, not just goal conversions" }
+};
+function conversionReportRequestFromArgs(args) {
+  return {
+    level: stringArg(args, "level"),
+    ids: reportCsvArg(args, "ids"),
+    since: stringArg(args, "since"),
+    until: stringArg(args, "until"),
+    days: numberArg(args, "days"),
+    granularity: stringArg(args, "granularity"),
+    segment: stringArg(args, "segment"),
+    clickWindowDays: numberArg(args, "click-window"),
+    viewWindowDays: numberArg(args, "view-window"),
+    events: reportCsvArg(args, "events"),
+    withEvents: args["with-events"] === true ? true : void 0
+  };
+}
+function reportHints(report) {
+  const nothing = report.rows.every((row) => row.conversions === 0 && (row.events ?? []).length === 0);
+  return nothing ? [
+    "No attributed conversions in this window. Before concluding the ads do not convert: `conversions events` shows whether the site's events arrive at all, and `campaigns` whether anything served."
+  ] : [
+    `Counted with a ${report.clickWindowDays}-day click and ${report.viewWindowDays}-day view window; a conversion eligible for both counts once, as a click. The latest days are still filling in.`
+  ];
+}
+registerSchema({
+  command: "ads.chatgpt.conversions.report",
+  description: "Conversions ChatGPT Ads attributes to campaigns, ad groups or ads: goal conversions split into click-through and view-through, purchase value, and optionally every attributed event (goal or not), per day and by device or country, with the click (7/14/30) and view (0/1) windows chosen. At most 365 days.",
+  args: {
+    level: { type: "string", description: ARGS.level.description, required: false },
+    ids: { type: "string", description: ARGS.ids.description, required: false },
+    days: { type: "string", description: ARGS.days.description, required: false },
+    since: { type: "string", description: ARGS.since.description, required: false },
+    until: { type: "string", description: ARGS.until.description, required: false },
+    granularity: { type: "string", description: ARGS.granularity.description, required: false },
+    segment: { type: "string", description: ARGS.segment.description, required: false },
+    "click-window": { type: "string", description: ARGS["click-window"].description, required: false },
+    "view-window": { type: "string", description: ARGS["view-window"].description, required: false },
+    events: { type: "string", description: ARGS.events.description, required: false },
+    "with-events": { type: "boolean", description: ARGS["with-events"].description, required: false }
+  }
+});
+var conversionsReportCommand = defineCommand({
+  meta: {
+    name: "report",
+    description: `Conversions ChatGPT Ads attributes, click-through beside view-through.
+
+Examples:
+  baker ads chatgpt conversions report                                   # account total, last 7 days
+  baker ads chatgpt conversions report --ids cmpn_1,cmpn_2 --days 30 --segment device
+  baker ads chatgpt conversions report --view-window 0 --click-window 7   # clicks only, 7-day window
+  baker ads chatgpt conversions report --events quote_requested --granularity daily`
+  },
+  args: ARGS,
+  run: async ({ args }) => {
+    const parsed = chatgptAdsConversionReportRequestSchema.safeParse(conversionReportRequestFromArgs(args));
+    if (!parsed.success) {
+      const message = parsed.error.issues[0]?.message ?? "Invalid conversion report request";
+      writeJsonEnvelope({
+        ok: false,
+        error: {
+          code: "VALIDATION_ERROR",
+          message,
+          fix: { action: "retry_with_modified_query", explanation: message },
+          retryable: false
+        }
+      });
+      process.exit(1);
+    }
+    await runChatgptRead(
+      CHATGPT_ADS_REFERENCE.conversions,
+      () => apiPost("/api/ads/chatgpt/conversions/report", parsed.data),
+      reportHints
+    );
+  }
+});
+export {
+  conversionReportRequestFromArgs,
+  conversionsReportCommand
+};
+//# sourceMappingURL=conversion-report-JV6WZLB3.js.map