@koda-sl/baker-cli 0.449.0 → 0.451.0-dev.b2a4eba2b

package/dist/search-VFRTUYFX.js

@@ -0,0 +1,174 @@
+import {
+  measureEmptyCorpus
+} from "./chunk-QCPZVAKJ.js";
+import {
+  activeFilterFlags
+} from "./chunk-Q6ULQMWG.js";
+import {
+  testimonialSourceTypeSchema
+} from "./chunk-BAUSWB7O.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-TEINLN64.js";
+import "./chunk-ZJWUBJYQ.js";
+import "./chunk-NE4F3FHN.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-PCKVSSVT.js";
+import "./chunk-MCM3HMNZ.js";
+import "./chunk-UW36KPPH.js";
+import {
+  registerSchema,
+  testimonialNormalizer,
+  writeJson,
+  writeOutput
+} from "./chunk-NU7JSWVA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/testimonials/search.ts
+import { defineCommand } from "citty";
+var FILTER_FLAGS = ["source", "rating-min", "rating-max", "status", "sentiment", "language", "tags"];
+function languageBiasHint(results, requestedLanguage) {
+  if (requestedLanguage) {
+    return null;
+  }
+  const withLang = results.filter((r) => typeof r.language === "string" && r.language.length > 0);
+  if (withLang.length < 3) {
+    return null;
+  }
+  const counts = /* @__PURE__ */ new Map();
+  for (const r of withLang) {
+    const lang = r.language;
+    counts.set(lang, (counts.get(lang) ?? 0) + 1);
+  }
+  const [topLang, topCount] = [...counts.entries()].sort((a, b) => b[1] - a[1])[0] ?? ["", 0];
+  if (topLang && topCount / withLang.length >= 0.8) {
+    return `Results skew ${topLang} (${topCount}/${withLang.length}). If you're sourcing quotes for a specific market, pass --language <code> (e.g. --language en) so the ad's language matches its audience.`;
+  }
+  return null;
+}
+registerSchema({
+  command: "testimonials.search",
+  description: "Search testimonials by text query. Uses hybrid BM25 + vector + reranking.",
+  args: {
+    query: { type: "string", description: "Search query text", required: true },
+    limit: { type: "number", description: "Maximum results to return", required: false, default: 10 },
+    source: {
+      type: "string",
+      description: `Filter by source: ${testimonialSourceTypeSchema.options.join("|")}`,
+      required: false,
+      enum: [...testimonialSourceTypeSchema.options]
+    },
+    "rating-min": { type: "number", description: "Minimum star rating (1-5)", required: false },
+    "rating-max": { type: "number", description: "Maximum star rating (1-5)", required: false },
+    status: {
+      type: "string",
+      description: "Filter by status: pending|processing|ready|error",
+      required: false,
+      enum: ["pending", "processing", "ready", "error"]
+    },
+    sentiment: {
+      type: "string",
+      description: "Filter: positive|neutral|negative",
+      required: false,
+      enum: ["positive", "neutral", "negative"]
+    },
+    language: { type: "string", description: "Filter by language code (e.g. en, es)", required: false },
+    tags: { type: "string", description: "Comma-separated tags to filter by", required: false }
+  }
+});
+function buildSearchRequest(query, args) {
+  const body = { query };
+  if (args.limit !== void 0) {
+    body.limit = Number(args.limit);
+  }
+  if (args.source) {
+    body.source = args.source;
+  }
+  if (args["rating-min"] !== void 0) {
+    body.rating_min = Number(args["rating-min"]);
+  }
+  if (args["rating-max"] !== void 0) {
+    body.rating_max = Number(args["rating-max"]);
+  }
+  if (args.status) {
+    body.status = args.status;
+  }
+  if (args.sentiment) {
+    body.sentiment = args.sentiment;
+  }
+  if (args.language) {
+    body.language = args.language;
+  }
+  if (args.tags) {
+    body.tags = args.tags.split(",").filter(Boolean);
+  }
+  return body;
+}
+var searchCommand = defineCommand({
+  meta: {
+    name: "search",
+    description: "Semantic search testimonials by text query. Uses hybrid BM25 + vector + reranking. Example: baker testimonials search 'great service' --rating-min 4"
+  },
+  args: {
+    query: { type: "positional", description: "Search query text", required: false },
+    limit: { type: "string", description: "Max results (default 10)", required: false },
+    source: {
+      type: "string",
+      description: `Filter by source: ${testimonialSourceTypeSchema.options.join("|")}`,
+      required: false
+    },
+    "rating-min": { type: "string", description: "Minimum star rating (1-5)", required: false },
+    "rating-max": { type: "string", description: "Maximum star rating (1-5)", required: false },
+    status: { type: "string", description: "Filter by status: pending|processing|ready|error", required: false },
+    sentiment: { type: "string", description: "Filter: positive|neutral|negative", required: false },
+    language: { type: "string", description: "Filter by language code (e.g. en, es)", required: false },
+    tags: { type: "string", description: "Comma-separated tags to filter by", required: false },
+    output: { type: "string", description: "Output format: json|files|md", required: false, default: "json" },
+    fields: { type: "string", description: "Comma-separated field names to include", required: false },
+    full: { type: "boolean", description: "Include full metadata", required: false, default: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const query = args.query;
+      if (!query) {
+        writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "Search query is required" } });
+        process.exit(1);
+      }
+      const body = buildSearchRequest(query, args);
+      const data = await apiPost("/api/testimonials/search", body);
+      const languageHint = languageBiasHint(data, body.language);
+      const { hints: emptyHints, empty } = await measureEmptyCorpus({
+        command: "search",
+        resultCount: data.length,
+        activeFilters: activeFilterFlags(args, FILTER_FLAGS)
+      });
+      const hints = [...emptyHints, ...languageHint ? [languageHint] : []];
+      const outputFormat = args.output || "json";
+      writeOutput(
+        { ok: true, data, ...empty ? { meta: { empty } } : {}, ...hints.length > 0 ? { hints } : {} },
+        outputFormat,
+        args.fields ? args.fields.split(",") : void 0,
+        args.full,
+        testimonialNormalizer
+      );
+      if (outputFormat !== "json") {
+        for (const hint of hints) {
+          process.stderr.write(`${hint}
+`);
+        }
+      }
+    } catch (err) {
+      if (err instanceof ApiError) {
+        writeJson({ ok: false, error: { code: err.code, message: err.message } });
+        process.exit(1);
+      }
+      writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
+});
+export {
+  searchCommand
+};
+//# sourceMappingURL=search-VFRTUYFX.js.map

package/dist/seeds-OXKHZSF7.js

@@ -0,0 +1,101 @@
+import {
+  reportError
+} from "./chunk-5EEWYHOR.js";
+import {
+  apiGet
+} from "./chunk-PCKVSSVT.js";
+import "./chunk-MCM3HMNZ.js";
+import "./chunk-UW36KPPH.js";
+import {
+  registerSchema,
+  writeJson,
+  writeOutput
+} from "./chunk-NU7JSWVA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/winning-ads/seeds.ts
+import { defineCommand } from "citty";
+function leanSeedRow(r) {
+  return {
+    key: r.key,
+    lift: r.lift,
+    brands_for: r.brands_for,
+    brands_against: r.brands_against,
+    count: r.count,
+    mean_winner_score: r.mean_winner_score,
+    winner_share: r.winner_share
+  };
+}
+function buildSeedParams(field, args) {
+  const params = { field };
+  if (args.platform) params.platform = String(args.platform);
+  if (args.awareness) params.awareness_stage = String(args.awareness);
+  if (args.industry) params.industry = String(args.industry);
+  if (args.limit) params.limit = String(args.limit);
+  return params;
+}
+function makeSeedCommand(opts) {
+  registerSchema({
+    command: `winning-ads.${opts.name}`,
+    description: opts.description,
+    args: {
+      platform: { type: "string", description: "Single platform (meta,linkedin,tiktok)", required: false },
+      awareness: { type: "string", description: "Single awareness stage", required: false },
+      industry: { type: "string", description: "Single industry seed", required: false },
+      limit: { type: "number", description: "Max keys 1-100 (default 20)", required: false, default: 20 }
+    }
+  });
+  return defineCommand({
+    meta: { name: opts.name, description: opts.description },
+    args: {
+      platform: { type: "string", description: "Single platform to segment on", required: false },
+      awareness: { type: "string", description: "Single awareness stage to segment on", required: false },
+      industry: { type: "string", description: "Single industry seed to segment on", required: false },
+      limit: { type: "string", description: "Max keys 1-100 (default 20)", required: false, default: "20" },
+      output: { type: "string", description: "Output format: json|files|md", required: false, default: "json" },
+      full: { type: "boolean", description: "Include the segment breakdown per key", required: false, default: false }
+    },
+    run: async ({ args }) => {
+      try {
+        const params = buildSeedParams(opts.field, args);
+        const data = await apiGet("/api/ad-library/seed-catalog", params);
+        const rows = Array.isArray(data?.patterns) ? data.patterns : [];
+        const full = args.full;
+        const projected = rows.map((r) => full ? r : leanSeedRow(r));
+        const output = args.output || "json";
+        if (output === "json") {
+          writeJson({
+            ok: true,
+            data: { field: data?.field ?? opts.field, segment: data?.segment ?? null, patterns: projected }
+          });
+          return;
+        }
+        writeOutput({ ok: true, data: projected }, output);
+      } catch (err) {
+        reportError(err);
+      }
+    }
+  });
+}
+var hooksCommand = makeSeedCommand({
+  name: "hooks",
+  field: "hook_archetype",
+  description: "Top winner-weighted HOOK seeds for a segment (from the ad-dna pattern rollup). Ground a creative in a proven hook for the exact platform+awareness+industry, then feed the chosen seed to `search --hook-archetype`."
+});
+var mechanismsCommand = makeSeedCommand({
+  name: "mechanisms",
+  field: "mechanism_type",
+  description: "Top winner-weighted PRODUCT mechanism seeds for a segment: how the advertised product claims to work (proprietary formula, AI automated, done-for-you\u2026). Not the ad's persuasion device: for that use `hooks` and `formats`."
+});
+var formatsCommand = makeSeedCommand({
+  name: "formats",
+  field: "static_format_pattern",
+  description: "Top winner-weighted static ad FORMAT patterns for a segment (from the ad-dna pattern rollup)."
+});
+export {
+  formatsCommand,
+  hooksCommand,
+  leanSeedRow,
+  mechanismsCommand
+};
+//# sourceMappingURL=seeds-OXKHZSF7.js.map

package/dist/select-YQQT5ANU.js

@@ -0,0 +1,94 @@
+import {
+  versionOf
+} from "./chunk-ZBSSVAST.js";
+import "./chunk-NCCGOJ4I.js";
+import "./chunk-PLOQNCL6.js";
+import "./chunk-PQ7YMQ2U.js";
+import "./chunk-KC7HNN2Z.js";
+import "./chunk-NBM3EHRA.js";
+import "./chunk-SGFJ4VXB.js";
+import "./chunk-Z6JUXGJ3.js";
+import "./chunk-IFD5LJWU.js";
+import "./chunk-ERVDEVLC.js";
+import "./chunk-BW4ZFBYI.js";
+import "./chunk-DGCUPJZD.js";
+import "./chunk-XR7TMGYY.js";
+import "./chunk-CAMX6OHF.js";
+import "./chunk-FMMXUEDL.js";
+import "./chunk-5HYSKH77.js";
+import "./chunk-KIGGMKAE.js";
+import "./chunk-B6KFPCGF.js";
+import "./chunk-DIJBHIII.js";
+import "./chunk-CRX5XO4W.js";
+import "./chunk-VVS5TLDG.js";
+import {
+  creativesSelectRequestSchema
+} from "./chunk-BAUSWB7O.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-TEINLN64.js";
+import "./chunk-ZJWUBJYQ.js";
+import "./chunk-NE4F3FHN.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-PCKVSSVT.js";
+import "./chunk-MCM3HMNZ.js";
+import "./chunk-UW36KPPH.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-NU7JSWVA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/creatives/select.ts
+import { defineCommand } from "citty";
+var DESCRIPTION = `Choose the version of a creative to keep, and optionally which of its options, only when the user says to keep this version in this chat. The creative shows that version as the chosen one, and the choice counts as the user's approval. A version you render after it replaces it when the chat is published (the user saw that one last). It does not save the image to their library (that is baker creatives publish) and puts nothing into an ad.
+Start here: baker creatives select --slug spring-offer
+Only some options of a version that made several: --options "ugc,2" (labels or numbers). Naming options again replaces the earlier pick.`;
+var ARGS = {
+  slug: { type: "string", description: "The creative: its folder name under src/creatives/.", required: true },
+  run: {
+    type: "string",
+    description: "The version to keep: its canvas run id (r_\u2026) Left out, the version the creative shows now (its last render).",
+    required: false
+  },
+  options: {
+    type: "string",
+    description: 'Keep only these options of the version, comma-separated: labels ("ugc"), numbers ("2") or slots. Left out, the whole version.',
+    required: false
+  }
+};
+registerSchema({ command: "creatives.select", description: DESCRIPTION, args: ARGS });
+function fail(code, message) {
+  writeJson({ ok: false, error: { code, message } });
+  process.exit(1);
+}
+var selectCommand = defineCommand({
+  meta: { name: "select", description: DESCRIPTION },
+  args: ARGS,
+  run: async ({ args }) => {
+    const options = typeof args.options === "string" ? args.options.split(",").map((option) => option.trim()).filter((option) => option.length > 0) : [];
+    const parsed = creativesSelectRequestSchema.safeParse({
+      slug: args.slug,
+      runId: await versionOf(String(args.slug), args.run).then(
+        (run) => run ?? fail("VALIDATION_ERROR", "--run: this creative has no rendered version here; name one (r_\u2026).")
+      ),
+      ...options.length > 0 ? { options } : {}
+    });
+    if (!parsed.success) {
+      const issue = parsed.error.issues[0];
+      fail("VALIDATION_ERROR", `--${String(issue?.path[0] ?? "args")}: ${issue?.message ?? "invalid"}`);
+    }
+    try {
+      const response = await apiPost("/api/creatives/select", parsed.data);
+      writeJson(response);
+    } catch (err) {
+      if (err instanceof ApiError) fail(err.code, err.message);
+      fail("INTERNAL_ERROR", "Unexpected error");
+    }
+  }
+});
+export {
+  selectCommand
+};
+//# sourceMappingURL=select-YQQT5ANU.js.map

package/dist/sends-DBJJS6CF.js

@@ -0,0 +1,309 @@
+import {
+  ConversionArgsError,
+  onlyOnce
+} from "./chunk-RPUSTYHL.js";
+import {
+  SEND_PLATFORMS,
+  isSendPlatform,
+  sendEventProblem,
+  sendsRequestSchema
+} from "./chunk-SSJK7FEV.js";
+import "./chunk-EDLZGTGN.js";
+import {
+  writeJsonEnvelope
+} from "./chunk-XNMSJP2X.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-PCKVSSVT.js";
+import "./chunk-MCM3HMNZ.js";
+import "./chunk-UW36KPPH.js";
+import {
+  registerSchema
+} from "./chunk-NU7JSWVA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/analytics/sends.ts
+import { defineCommand } from "citty";
+var SET_FLAGS = ["--source-event", "--platform", "--tag", "--event"];
+function parseSendsArgs(raw, argv, now = Date.now()) {
+  const set = parseSetFlags(raw, argv, now);
+  const remove = onlyOnce(raw.remove, "--remove", argv);
+  const days = raw.days === void 0 ? void 0 : Number(raw.days);
+  if (days !== void 0 && (!Number.isInteger(days) || days <= 0 || days > 400)) {
+    throw new ConversionArgsError("--days must be a whole number of days, from 1 to 400.");
+  }
+  const uploads = onlyOnce(raw.uploads, "--uploads", argv);
+  if (raw.failed === true && uploads === void 0) {
+    throw new ConversionArgsError("--failed narrows --uploads <sendId> to the refused ones; name the send.");
+  }
+  if (raw.skipped === true && uploads === void 0) {
+    throw new ConversionArgsError(
+      "--skipped narrows --uploads <sendId> to the events it never uploaded; name the send."
+    );
+  }
+  return {
+    ...set === void 0 ? {} : { set },
+    ...remove === void 0 ? {} : { remove },
+    ...days === void 0 ? {} : { days },
+    ...uploads === void 0 ? {} : { uploads },
+    ...raw.failed === true ? { failedOnly: true } : {},
+    ...raw.skipped === true ? { skippedOnly: true } : {},
+    full: raw.full === true
+  };
+}
+function flagValueAt(argv, flag, index) {
+  const arg = argv[index] ?? "";
+  if (arg === flag) return argv[index + 1];
+  return arg.startsWith(`${flag}=`) ? arg.slice(flag.length + 1) : void 0;
+}
+function parseParameterArgs(argv) {
+  const parameters = {};
+  for (let index = 0; index < argv.length; index += 1) {
+    const pair = flagValueAt(argv, "--parameter", index);
+    if (pair === void 0) continue;
+    const eq = pair.indexOf("=");
+    const name = (eq === -1 ? pair : pair.slice(0, eq)).trim();
+    const template = eq === -1 ? "" : pair.slice(eq + 1).trim();
+    if (name === "" || template === "") {
+      throw new ConversionArgsError(
+        `--parameter needs <name>=<template>, like --parameter content_name={{properties.plan}}; got "${pair}".`
+      );
+    }
+    parameters[name] = template;
+  }
+  return Object.keys(parameters).length === 0 ? void 0 : parameters;
+}
+function parseSetFlags(raw, argv, now) {
+  if (raw.conversion !== void 0) {
+    throw new ConversionArgsError(
+      "--conversion is gone: a send is on a system's EVENT, not a conversion. Pass --source-event <key> \u2014 one of events[].eventKey from a plain `baker analytics sends` (page:<name>)."
+    );
+  }
+  const values = {
+    "--source-event": onlyOnce(raw["source-event"] ?? raw.sourceEvent, "--source-event", argv),
+    "--platform": onlyOnce(raw.platform, "--platform", argv),
+    "--tag": onlyOnce(raw.tag, "--tag", argv),
+    "--event": onlyOnce(raw.event, "--event", argv)
+  };
+  const given = SET_FLAGS.filter((flag) => values[flag] !== void 0);
+  const set = raw.set === true;
+  if (!set) {
+    if (given.length > 0) {
+      throw new ConversionArgsError(
+        `${given.join(", ")} describe a send, so add --set to stage it. Without --set the command only reads.`
+      );
+    }
+    return void 0;
+  }
+  const missing = SET_FLAGS.filter((flag) => values[flag] === void 0);
+  if (missing.length > 0) {
+    throw new ConversionArgsError(
+      `--set needs ${SET_FLAGS.join(", ")}; missing ${missing.join(", ")}. Copy --tag from platforms[].tags of a plain \`baker analytics sends\`, never from memory.`
+    );
+  }
+  const platform = values["--platform"] ?? "";
+  if (!isSendPlatform(platform)) {
+    throw new ConversionArgsError(
+      `"${platform}" is not somewhere a conversion can be sent \u2014 --platform is one of ${SEND_PLATFORMS.join(", ")}.`
+    );
+  }
+  const event = values["--event"] ?? "";
+  const templated = sendEventProblem(platform, event);
+  if (templated !== null) {
+    throw new ConversionArgsError(`--event ${event} cannot be sent to ${platform}. ${templated}`);
+  }
+  const account = onlyOnce(raw.account, "--account", argv);
+  const parameters = parseParameterArgs(argv);
+  return {
+    id: onlyOnce(raw.id, "--id", argv) ?? sendIdFor(now),
+    eventKey: values["--source-event"] ?? "",
+    ...originFlag(raw, argv),
+    platform,
+    tagId: values["--tag"] ?? "",
+    event,
+    ...account === void 0 ? {} : { account },
+    ...parameters === void 0 ? {} : { parameters }
+  };
+}
+function originFlag(raw, argv) {
+  const from = onlyOnce(raw.from, "--from", argv) ?? "any";
+  if (from === "any") return { origin: "any" };
+  if (from === "api") return {};
+  if (from === "pixel") return { origin: "website" };
+  throw new ConversionArgsError(
+    `--from is any, pixel or api; got "${from}". any \u2014 the default \u2014 uploads the event whichever door it arrives by, once when the pixel and the API both report it with the same event id; pixel only what Baker's pixel sent from the client's website; api only what the API or an integration sent.`
+  );
+}
+function sendIdFor(now) {
+  return `s${now.toString(36).slice(-5)}`;
+}
+function sendsWrite(args2) {
+  const body = {
+    ...args2.set === void 0 ? {} : { set: [args2.set] },
+    ...args2.remove === void 0 ? {} : { remove: [args2.remove] },
+    ...args2.days === void 0 ? {} : { days: args2.days },
+    ...args2.uploads === void 0 ? {} : { uploads: args2.uploads },
+    ...args2.failedOnly === void 0 ? {} : { failedOnly: args2.failedOnly },
+    ...args2.skippedOnly === void 0 ? {} : { skippedOnly: args2.skippedOnly }
+  };
+  const parsed = sendsRequestSchema.safeParse(body);
+  if (!parsed.success) {
+    const issue = parsed.error.issues[0];
+    throw new ConversionArgsError(
+      `That send cannot be staged \u2014 ${issue?.path.join(".") || "set"}: ${issue?.message ?? "invalid"}. Run \`baker schema analytics.sends\` for the exact shape.`
+    );
+  }
+  return parsed.data;
+}
+function sendsView(response, full) {
+  const { carries, templateFields, ...rest } = response.data;
+  return {
+    ok: true,
+    data: { ...rest, ...full ? { carries, templateFields } : {} },
+    ...response.hints && response.hints.length > 0 ? { hints: response.hints } : {}
+  };
+}
+var args = {
+  set: {
+    type: "boolean",
+    description: "Stage a send, described by --source-event, --platform, --tag and --event. It applies when this chat is published, and from then on every event arriving under that key is uploaded to the platform and spends ad budget \u2014 say so to the client, never that it is a preview",
+    required: false
+  },
+  "source-event": {
+    type: "string",
+    description: "The event to send, by key \u2014 one of `events[].eventKey` from a plain `baker analytics sends`: a Source's own event (page:<source name>), or a named event the client's server posts. A Form's or a page's event is refused: the page's own pixels and the Form's side effects already send those",
+    required: false
+  },
+  from: {
+    type: "string",
+    description: "Which door's events the send uploads: `any` (default) \u2014 the event whichever door it arrives by, uploaded once when the pixel and the API both report it with the same event id; `pixel` \u2014 only what Baker's pixel sent from the client's own website (an `events[]` row with origin `website`); `api` \u2014 only what the client's server posted or an integration like HubSpot sent",
+    required: false
+  },
+  platform: {
+    type: "string",
+    description: `Where it goes: one of ${SEND_PLATFORMS.join(", ")}`,
+    required: false
+  },
+  tag: {
+    type: "string",
+    description: "The tag on Tracking that sends it. COPY the id from `platforms[].tags[].tagId` in the response \u2014 it is only listed there when the tag holds its server credential, and one typed from memory is refused",
+    required: false
+  },
+  event: {
+    type: "string",
+    description: 'What the platform calls it \u2014 `platforms[].eventMeans` says what each one takes: a Meta or Google Analytics event name (Purchase, Lead, generate_lead), a Google Ads conversion action id copied from `platforms[].conversionActions`, or the conversion label the person gives you (staged as its id; never type an id: one the account does not hold is refused), a LinkedIn conversion rule id, an X event tag id. On Meta and Google Analytics it may be WRITTEN FROM THE EVENT with the same {{path}} mentions --parameter takes: --event {{properties.plan}} sends each event under the plan it carries, --event "Purchase {{properties.tier}}" mixes text and a field. An event carrying nothing there is not uploaded. Google Ads, LinkedIn and X take an id THEY issued, so a template is refused there \u2014 pass what varies as a --parameter instead. For a GOOGLE ADS id, list the account\'s conversion actions first and pick by name \u2014 `baker ads google query "SELECT conversion_action.id, conversion_action.name, conversion_action.primary_for_goal FROM conversion_action WHERE conversion_action.status = \'ENABLED\'"` \u2014 never guess: Google accepts an upload against an id the account does not hold and files it against nothing',
+    required: false
+  },
+  account: {
+    type: "string",
+    description: "LinkedIn only: the ad account the conversion rule belongs to",
+    required: false
+  },
+  parameter: {
+    type: "string",
+    description: "<name>=<template>, repeatable, with --set: an EXTRA parameter the platform receives with every upload, beyond who, the click and the amount \u2014 Meta's custom_data (content_name, content_category, or your own), a GA4 event parameter, a Google Ads custom variable (must exist in the account), X's contents (content_name, num_items\u2026); LinkedIn takes none. The template is text with {{path}} mentions over the event: its own properties as {{properties.<key>}} (a HubSpot event's --field properties.<key> rows, a server event's `properties`), and the fields `templateFields` lists (--full): value, value_currency, event_name, page_path, city, country, gclid\u2026 Example: --parameter content_name={{properties.plan}} --parameter content_category=hubspot. `parameters[]` in the response says what each platform takes",
+    required: false
+  },
+  uploads: {
+    type: "string",
+    description: "The id of a send (`sends[].id`) whose uploads to list, newest first over --days: which event went, when, `outcome` (success | failed | pending | skipped) and in `error` the platform's refusal in its own words or what a skipped event was missing \u2014 the rows behind `sends[].outcome`. With --failed, only the refused ones; with --skipped, only the skipped ones",
+    required: false
+  },
+  failed: {
+    type: "boolean",
+    description: "With --uploads: only the uploads the platform refused",
+    required: false
+  },
+  skipped: {
+    type: "boolean",
+    description: "With --uploads: only the events the send never uploaded because they carried nothing the platform matches a person by \u2014 each `error` names what was missing (a Meta click id or cookie, an email, a gclid\u2026)",
+    required: false
+  },
+  id: {
+    type: "string",
+    description: "The send's id, when changing one that exists (`sends[].id` for a live one, `staged.set[].id` for one staged in this chat, like s1). Left out, a new id is minted and a NEW send is staged \u2014 so re-running a --set you already ran is refused, naming the send it would duplicate",
+    required: false
+  },
+  remove: {
+    type: "string",
+    description: "The id of a send to stop, from `sends[].id`. Staged like a set: it stops when the chat is published",
+    required: false
+  },
+  days: {
+    type: "string",
+    description: "How many days the outcome beside each send covers (default 30, up to 400)",
+    required: false
+  },
+  full: {
+    type: "boolean",
+    description: "Also return `carries`: every field a send forwards, the same for every send",
+    required: false
+  }
+};
+registerSchema({
+  command: "analytics.sends",
+  description: "Read where this company's system events are sent, or stage a change",
+  args
+});
+var sendsCommand = defineCommand({
+  meta: {
+    name: "sends",
+    description: `Where this company's SYSTEM EVENTS are sent \u2014 Meta, Google Ads, LinkedIn, X, Google Analytics \u2014 and what happened to each upload. A send belongs to an event one of the client's own systems raises, by key: page:deal_won from HubSpot \u2192 Meta Purchase means every "deal_won" HubSpot reports is uploaded to Meta with who the person is, the click that brought them and the amount forwarded automatically. There is nothing to map. What happens on a page or in a Form is never sent from here \u2014 the page's pixels and the Form's own side effects do that \u2014 and a send is never set on a funnel step: the step reads the sends of the events behind its ways in.
+
+Start here:
+  baker analytics sends                                   \u2014 the sends in effect, each with its outcome; the platforms and the tags that can send; the system events (events[]) that can be sent
+  baker analytics sends --set --source-event page:deal_won --platform meta --tag <tagId> --event Purchase
+  baker analytics sends --set --source-event page:deal_won --platform googleAds --tag <tagId> --event 987654321
+  baker analytics sends --set --source-event page:deal_won --platform meta --tag <tagId> --event Purchase --parameter content_name={{properties.plan}}
+  baker analytics sends --set --source-event page:lead_completed_step_2 --platform meta --tag <tagId> --event Lead   \u2014 an event the pixel and/or the API send; uploaded once per event id
+  baker analytics sends --set --source-event page:deal_won --platform meta --tag <tagId> --event {{properties.plan}}   \u2014 a Meta event named after what each one carries
+  baker analytics sends --remove s1                       \u2014 stop one
+  baker analytics sends --days 7                          \u2014 outcomes over the last week
+  baker analytics sends --uploads s1 --failed             \u2014 the uploads Meta refused, each with the event and Meta's own words
+  baker analytics sends --uploads s1 --skipped            \u2014 the events never uploaded, each with what the platform needed and they lacked
+
+Three things to hold on to:
+  it is STAGED   \u2014 a set or a remove lands when this chat is published, and from then on it SPENDS AD BUDGET on every "<event>" that arrives. Tell the client that plainly; never call a published send a preview.
+  the tagId is COPIED \u2014 from \`platforms[].tags\` in the response, which lists only the tags on Tracking that hold their server credential. One typed from memory is refused; a platform with no tag listed says what to add on Tracking (\`platforms[].setupHint\`).
+  the outcome is what happened \u2014 \`sends[].outcome\` counts what was sent, what failed and why (\`lastError\`, in the platform's words), and what was SKIPPED: an event carrying nothing the platform matches a person by is never uploaded (Meta: a Meta click id or cookie, an email or your own customer id; Google Ads: gclid, wbraid, gbraid, an email or a phone; LinkedIn: li_fat_id or an email; X: twclid or an email; Google Analytics: nothing), counted in \`skipped\` with \`lastSkipReason\`.
+  check the MATCH before staging \u2014 \`events[].match\` says, for the last 30 days of each event, how many arrived and how many each platform could match. A send to a platform matching 0 of 14 skips all 14: say so to the client, and ask for the click id or the email to be sent with the event instead. "Nothing sent yet" means no event under that name has fired since the send was set. \`--uploads <id>\` lists the rows behind the count, \`--failed\` only the refused ones \u2014 read it before telling a client a send "failed".
+  a Meta or GA4 event name can be WRITTEN FROM THE EVENT \u2014 \`--event {{properties.plan}}\` sends each event under its own plan, so one Source covers every value instead of one Source, one send and one conversion action per value. Only where the platform takes a name of your own: Google Ads, LinkedIn and X take an id they issued and refuse a template.
+  extra parameters are optional \u2014 \`--parameter <name>=<template>\` adds what the platform receives beyond who, the click and the amount: \`{{properties.<key>}}\` reads a property the event carries (a HubSpot event's \`--field properties.<key>\` rows), \`{{value}}\`, \`{{page_path}}\`, \`{{city}}\`\u2026 read the event's fields. \`parameters[]\` in the response says what each platform takes and the names it knows; LinkedIn takes none.
+
+An empty \`events[]\` means none of the client's systems sends an event yet and there is nothing to send: make a Source with \`baker analytics sources\` (a HubSpot event, or the server's address), then send its event.`
+  },
+  args,
+  run: async ({ args: raw }) => {
+    try {
+      const parsed = parseSendsArgs(raw, process.argv);
+      const response = await apiPost("/api/analytics/sends", sendsWrite(parsed));
+      writeJsonEnvelope(sendsView(response, parsed.full));
+    } catch (err) {
+      handleError(err);
+    }
+  }
+});
+function handleError(err) {
+  if (err instanceof ConversionArgsError) {
+    writeJsonEnvelope({ ok: false, error: { code: "VALIDATION_ERROR", message: err.message } });
+    process.exit(1);
+  }
+  if (err instanceof ApiError) {
+    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);
+}
+export {
+  parseParameterArgs,
+  parseSendsArgs,
+  sendsCommand,
+  sendsView,
+  sendsWrite
+};
+//# sourceMappingURL=sends-DBJJS6CF.js.map