@koda-sl/baker-cli 0.568.0 → 0.569.0-dev.1b455b3fe

package/dist/themes-5HKRO5RR.js

@@ -1,95 +0,0 @@
-import {
-  exitWithServiceReadError
-} from "./chunk-2LBQNTTH.js";
-import {
-  failWriteValidation,
-  listFlag,
-  requireCustomerId
-} from "./chunk-TPGFX47R.js";
-import "./chunk-ERSX3MKH.js";
-import "./chunk-CDTAKCJR.js";
-import "./chunk-4NZ47VXO.js";
-import "./chunk-D5FY4FAK.js";
-import "./chunk-4H6XLX7E.js";
-import "./chunk-QALAJNBG.js";
-import "./chunk-BMMXYR7A.js";
-import {
-  getManagerIdForCustomer,
-  writeJsonEnvelope
-} from "./chunk-RBCO3C3Q.js";
-import "./chunk-Y5PNLB24.js";
-import "./chunk-N3PASNUA.js";
-import "./chunk-E56V3RFO.js";
-import "./chunk-EL3TDR5S.js";
-import "./chunk-G6U45QD3.js";
-import "./chunk-X6U3B6YK.js";
-import "./chunk-R7XDGNZD.js";
-import "./chunk-XHWHBGKX.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/google/keywords/themes.ts
-import { defineCommand } from "citty";
-var ARGS = {
-  "customer-id": { type: "string", description: "Google Ads customer ID (10 digits, no dashes)" },
-  keywords: { type: "string", description: "Comma-separated keywords to place" },
-  "ad-groups": {
-    type: "string",
-    description: "Comma-separated existing ad group ids (or resource names) to sort them into \u2014 read them with `ad-groups list`"
-  }
-};
-registerSchema({
-  command: "ads.google.keywords.themes",
-  description: "Which existing ad group each keyword belongs in, by Google's reading of the ad groups' themes (Keyword Planner GenerateAdGroupThemes). Start here: `baker ads google keywords themes --customer-id 1234567890 --keywords \"solar panels,heat pumps\" --ad-groups 111,222`. Returns suggestions (keyword \u2192 suggested keyword, match type, ad group) and unusable_ad_groups (ones Google could not read a theme from).",
-  args: Object.fromEntries(
-    Object.entries(ARGS).map(([name, arg]) => [
-      name,
-      { type: arg.type, description: arg.description, required: false }
-    ])
-  )
-});
-var themesCommand = defineCommand({
-  meta: {
-    name: "themes",
-    description: `Sort keywords into the existing ad groups whose theme fits them (Keyword Planner).
-
-Example:
-  baker ads google keywords themes --customer-id 1234567890 --keywords "solar panels,heat pumps" --ad-groups 111,222`
-  },
-  args: ARGS,
-  run: async ({ args }) => {
-    const customerId = requireCustomerId(args);
-    const keywords = listFlag(args.keywords);
-    const adGroups = listFlag(args["ad-groups"]);
-    if (!keywords?.length || !adGroups?.length) failWriteValidation("pass --keywords and --ad-groups");
-    const managerId = getManagerIdForCustomer(customerId);
-    try {
-      const { data } = await apiPost(
-        "/api/ads/google/keywords/themes",
-        {
-          customerId,
-          ...managerId ? { managerId } : {},
-          keywords,
-          adGroups
-        }
-      );
-      const hints = data.unusable_ad_groups.length > 0 ? [
-        `${data.unusable_ad_groups.length} ad group(s) gave Google no theme to match against (removed, empty or under a removed campaign) \u2014 they received no keywords.`
-      ] : [];
-      writeJsonEnvelope(hints.length > 0 ? { ok: true, data, hints } : { ok: true, data });
-    } catch (err) {
-      exitWithServiceReadError(err);
-    }
-  }
-});
-export {
-  themesCommand
-};
-//# sourceMappingURL=themes-5HKRO5RR.js.map

package/dist/themes-5HKRO5RR.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/commands/ads/google/keywords/themes.ts"],"sourcesContent":["import type { GoogleAdGroupThemesResponse } from \"@baker/api/ads-google\";\nimport { defineCommand } from \"citty\";\nimport { apiPost } from \"../../../../client.ts\";\nimport { registerSchema } from \"../../../../schemas.ts\";\nimport { getManagerIdForCustomer } from \"../../cache.ts\";\nimport { writeJsonEnvelope } from \"../../output.ts\";\nimport { exitWithServiceReadError } from \"../service-read-errors.ts\";\nimport { failWriteValidation, listFlag, requireCustomerId } from \"../write-shared.ts\";\n\nconst ARGS = {\n  \"customer-id\": { type: \"string\", description: \"Google Ads customer ID (10 digits, no dashes)\" },\n  keywords: { type: \"string\", description: \"Comma-separated keywords to place\" },\n  \"ad-groups\": {\n    type: \"string\",\n    description:\n      \"Comma-separated existing ad group ids (or resource names) to sort them into — read them with `ad-groups list`\",\n  },\n} as const;\n\nregisterSchema({\n  command: \"ads.google.keywords.themes\",\n  description:\n    \"Which existing ad group each keyword belongs in, by Google's reading of the ad groups' themes (Keyword Planner GenerateAdGroupThemes). Start here: `baker ads google keywords themes --customer-id 1234567890 --keywords \\\"solar panels,heat pumps\\\" --ad-groups 111,222`. Returns suggestions (keyword → suggested keyword, match type, ad group) and unusable_ad_groups (ones Google could not read a theme from).\",\n  args: Object.fromEntries(\n    Object.entries(ARGS).map(([name, arg]) => [\n      name,\n      { type: arg.type, description: arg.description, required: false },\n    ]),\n  ),\n});\n\nexport const themesCommand = defineCommand({\n  meta: {\n    name: \"themes\",\n    description: `Sort keywords into the existing ad groups whose theme fits them (Keyword Planner).\n\nExample:\n  baker ads google keywords themes --customer-id 1234567890 --keywords \"solar panels,heat pumps\" --ad-groups 111,222`,\n  },\n  args: ARGS,\n  run: async ({ args }) => {\n    const customerId = requireCustomerId(args);\n    const keywords = listFlag(args.keywords);\n    const adGroups = listFlag(args[\"ad-groups\"]);\n    if (!keywords?.length || !adGroups?.length) failWriteValidation(\"pass --keywords and --ad-groups\");\n    const managerId = getManagerIdForCustomer(customerId);\n    try {\n      const { data } = await apiPost<{ ok: true; data: GoogleAdGroupThemesResponse }>(\n        \"/api/ads/google/keywords/themes\",\n        {\n          customerId,\n          ...(managerId ? { managerId } : {}),\n          keywords,\n          adGroups,\n        },\n      );\n      const hints =\n        data.unusable_ad_groups.length > 0\n          ? [\n              `${data.unusable_ad_groups.length} ad group(s) gave Google no theme to match against (removed, empty or under a removed campaign) — they received no keywords.`,\n            ]\n          : [];\n      writeJsonEnvelope(hints.length > 0 ? { ok: true, data, hints } : { ok: true, data });\n    } catch (err) {\n      exitWithServiceReadError(err);\n    }\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACA,SAAS,qBAAqB;AAQ9B,IAAM,OAAO;AAAA,EACX,eAAe,EAAE,MAAM,UAAU,aAAa,gDAAgD;AAAA,EAC9F,UAAU,EAAE,MAAM,UAAU,aAAa,oCAAoC;AAAA,EAC7E,aAAa;AAAA,IACX,MAAM;AAAA,IACN,aACE;AAAA,EACJ;AACF;AAEA,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aACE;AAAA,EACF,MAAM,OAAO;AAAA,IACX,OAAO,QAAQ,IAAI,EAAE,IAAI,CAAC,CAAC,MAAM,GAAG,MAAM;AAAA,MACxC;AAAA,MACA,EAAE,MAAM,IAAI,MAAM,aAAa,IAAI,aAAa,UAAU,MAAM;AAAA,IAClE,CAAC;AAAA,EACH;AACF,CAAC;AAEM,IAAM,gBAAgB,cAAc;AAAA,EACzC,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA,EAIf;AAAA,EACA,MAAM;AAAA,EACN,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,UAAM,aAAa,kBAAkB,IAAI;AACzC,UAAM,WAAW,SAAS,KAAK,QAAQ;AACvC,UAAM,WAAW,SAAS,KAAK,WAAW,CAAC;AAC3C,QAAI,CAAC,UAAU,UAAU,CAAC,UAAU,OAAQ,qBAAoB,iCAAiC;AACjG,UAAM,YAAY,wBAAwB,UAAU;AACpD,QAAI;AACF,YAAM,EAAE,KAAK,IAAI,MAAM;AAAA,QACrB;AAAA,QACA;AAAA,UACE;AAAA,UACA,GAAI,YAAY,EAAE,UAAU,IAAI,CAAC;AAAA,UACjC;AAAA,UACA;AAAA,QACF;AAAA,MACF;AACA,YAAM,QACJ,KAAK,mBAAmB,SAAS,IAC7B;AAAA,QACE,GAAG,KAAK,mBAAmB,MAAM;AAAA,MACnC,IACA,CAAC;AACP,wBAAkB,MAAM,SAAS,IAAI,EAAE,IAAI,MAAM,MAAM,MAAM,IAAI,EAAE,IAAI,MAAM,KAAK,CAAC;AAAA,IACrF,SAAS,KAAK;AACZ,+BAAyB,GAAG;AAAA,IAC9B;AAAA,EACF;AACF,CAAC;","names":[]}

package/dist/top-companies-PY2NL2GS.js

@@ -1,111 +0,0 @@
-import {
-  csvOrJson,
-  daysAgoIso,
-  handleLinkedinError,
-  todayIso
-} from "./chunk-CI3QSB6G.js";
-import {
-  TABLE_OUTPUT_FORMATS,
-  outputFormatRefusal,
-  writeAdsJson,
-  writeAdsOutput,
-  writeJsonEnvelope
-} from "./chunk-RBCO3C3Q.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/top-companies.ts
-import { defineCommand } from "citty";
-var COMPANIES_HINT = "For whole-account reach over months (one row per company, --by month|campaign, --with-domains), use `baker ads linkedin companies`.";
-var topCompaniesCommand = defineCommand({
-  meta: {
-    name: "top-companies",
-    description: `Top companies whose employees saw / clicked / converted on a campaign.
-
-Wrapper for: analytics --pivot company. Returns rows sorted by impressions desc.
-Each row's pivot[] contains { urn, id, name } \u2014 org names are resolved automatically.
-Cross-reference names against your target account list to spot audience leakage.
-
-Demographic data is delayed 12-24h with a \u22653-event privacy floor.
-
-Examples:
-  baker ads linkedin top-companies --campaign-id 1234 --last-days 30
-  baker ads linkedin top-companies --campaign-id 1,2,3 --intent revenue --last-days 90 --top-n 50
-  baker ads linkedin top-companies --campaign-id 1234 --output csv`
-  },
-  args: {
-    "campaign-id": { type: "string", description: "Comma-separated campaign IDs (required)" },
-    intent: { type: "string", description: "baseline | revenue | funnel | engagement | lead-gen (default: baseline)" },
-    "top-n": { type: "string", description: "Top rows by impressions (default: 25)" },
-    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"];
-    const invalid = !campaignIdsRaw ? "--campaign-id is required: one campaign id, or several comma-separated. For every company the whole ad account reached, use `baker ads linkedin companies`." : outputFormatRefusal(csvOrJson(args), TABLE_OUTPUT_FORMATS);
-    if (invalid !== null || !campaignIdsRaw) {
-      writeAdsJson({ ok: false, error: { code: "INVALID_ARGS", message: invalid ?? "" } });
-      process.exit(1);
-    }
-    const ids = campaignIdsRaw.split(",").map((s) => s.trim()).filter(Boolean);
-    const intent = args.intent ?? "baseline";
-    const topN = args["top-n"] ? Number(args["top-n"]) : 25;
-    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,
-          pivot: "company",
-          start,
-          end,
-          granularity: "ALL",
-          limit: 500
-        },
-        skipCache: Boolean(args["no-cache"])
-      });
-      const top = [...data.rows].sort((a, b) => Number(b.impressions ?? 0) - Number(a.impressions ?? 0)).slice(0, topN);
-      const fmt = csvOrJson(args);
-      if (fmt !== "json") {
-        writeAdsOutput(top, fmt, data.fields, [COMPANIES_HINT]);
-        return;
-      }
-      writeJsonEnvelope({
-        ok: true,
-        data: {
-          query: { campaigns: ids, start, end, intent, topN },
-          rows: top,
-          warnings: data.warnings
-        },
-        hints: [COMPANIES_HINT]
-      });
-    } catch (err) {
-      handleLinkedinError(err);
-    }
-  }
-});
-export {
-  topCompaniesCommand
-};
-//# sourceMappingURL=top-companies-PY2NL2GS.js.map

package/dist/transcript-7WFXVRVW.js

@@ -1,165 +0,0 @@
-import {
-  transcriptHints
-} from "./chunk-LQACNCAV.js";
-import {
-  handleResearchError,
-  writeResearchJson
-} from "./chunk-D3YAFC6K.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 {
-  registerSchema
-} from "./chunk-CCYZJMZ7.js";
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/research/transcript.ts
-import { mkdirSync, writeFileSync } from "fs";
-import { dirname, resolve } from "path";
-import { defineCommand } from "citty";
-var EXCERPT_CHARS = 3e3;
-var TIMEOUT_MS = 54e4;
-registerSchema({
-  command: "research.transcript",
-  description: "The words of one long recording \u2014 a keynote, earnings call, webinar or podcast \u2014 so a leader's own phrasing can feed 1:1 ad and page messaging. A YouTube link is read from its captions; any other link must be the audio or video file itself. Nothing is added to the video library. Start here: `baker research transcript <url> --out transcript.txt`.",
-  args: {
-    url: {
-      type: "string",
-      description: "A YouTube link, or a direct link to an audio/video file (.mp3, .mp4, .m4a, \u2026) (positional)",
-      required: true
-    },
-    full: {
-      type: "boolean",
-      description: `Return the whole text instead of the first ${EXCERPT_CHARS} characters`,
-      required: false,
-      default: false
-    },
-    out: {
-      type: "string",
-      description: "Write the whole text to this file and return its path instead of the text",
-      required: false
-    }
-  }
-});
-var FIELDS = {
-  provider: "youtube \u2014 the video's captions; deepgram \u2014 the recording transcribed",
-  title: "The video's title (YouTube only), or null",
-  duration_sec: "Length of the recording in seconds, or null when unknown",
-  language: "The language spoken, as the provider names it",
-  word_count: "Words in the whole recording",
-  text_chars: "Length of the whole text available on the server",
-  excerpt: "The opening of the text (default output)",
-  text: "The whole text (--full)",
-  file: "Where the whole text was written (--out)",
-  truncated: "The recording was longer than one transcript carries, so the end is missing"
-};
-function transcriptFix(code) {
-  if (code === "VALIDATION_ERROR" || code === "BAD_REQUEST") {
-    return {
-      action: "retry_with_changes",
-      explanation: "Pass a YouTube link, or the direct link to the audio or video file \u2014 for a podcast, the episode's download link (its RSS enclosure), not the episode page."
-    };
-  }
-  if (code === "CONFLICT") {
-    return {
-      action: "continue_without",
-      explanation: "There are no words to read in this recording. Look for another recording of the same person, or write the brief from what you have."
-    };
-  }
-  if (code === "RATE_LIMITED") {
-    return {
-      action: "continue_without",
-      explanation: "The transcriber is busy. Do the rest of the job first and try this recording once more later."
-    };
-  }
-  return {
-    action: "continue_without",
-    explanation: "This recording couldn't be transcribed. Don't loop on it \u2014 finish the brief from your other sources and name this recording as a gap."
-  };
-}
-var transcriptCommand = defineCommand({
-  meta: {
-    name: "transcript",
-    description: `The words of one long recording \u2014 a keynote, earnings call, webinar or podcast \u2014 so a leader's own phrasing can feed 1:1 ad and page messaging.
-
-A YouTube link is read from its captions. Any other link must be the audio or video file itself (.mp3, .mp4, .m4a, \u2026): for a podcast, the episode's download link, not its page. Nothing is added to the video library.
-
-Default output is compact \u2014 title, length, word count and the opening of the text. Use --out to write the whole text to a file and read the parts you need.
-
-Examples:
-  baker research transcript "https://www.youtube.com/watch?v=<id>"
-  baker research transcript "https://www.youtube.com/watch?v=<id>" --out keynote.txt
-  baker research transcript "https://traffic.megaphone.fm/<episode>.mp3" --full`
-  },
-  args: {
-    url: { type: "positional", description: "A YouTube link, or a direct audio/video file link", required: false },
-    full: { type: "boolean", description: "Return the whole text", required: false },
-    out: { type: "string", description: "Write the whole text to this file", required: false }
-  },
-  run: async ({ args }) => {
-    const url = args.url;
-    if (!url) {
-      writeResearchJson({
-        ok: false,
-        error: {
-          code: "VALIDATION_ERROR",
-          message: "A recording link is required",
-          fix: transcriptFix("VALIDATION_ERROR")
-        }
-      });
-      process.exit(1);
-    }
-    const body = { url };
-    try {
-      const transcript = await apiPost("/api/research/transcript", body, {
-        timeoutMs: TIMEOUT_MS
-      });
-      const out = args.out;
-      let delivered;
-      let excerpted = false;
-      if (out) {
-        const file = resolve(out);
-        mkdirSync(dirname(file), { recursive: true });
-        writeFileSync(file, transcript.text, "utf-8");
-        delivered = { file };
-      } else if (args.full) {
-        delivered = { text: transcript.text };
-      } else {
-        excerpted = transcript.text.length > EXCERPT_CHARS;
-        delivered = { excerpt: transcript.text.slice(0, EXCERPT_CHARS) };
-      }
-      writeResearchJson({
-        ok: true,
-        data: {
-          url: transcript.url,
-          provider: transcript.provider,
-          title: transcript.title,
-          duration_sec: transcript.durationSec,
-          language: transcript.language,
-          word_count: transcript.wordCount,
-          text_chars: transcript.textChars,
-          truncated: transcript.truncated,
-          ...delivered
-        },
-        fields: FIELDS,
-        hints: transcriptHints({ excerpted, truncated: transcript.truncated })
-      });
-    } catch (err) {
-      handleResearchError(err, transcriptFix);
-    }
-  }
-});
-export {
-  transcriptCommand
-};
-//# sourceMappingURL=transcript-7WFXVRVW.js.map