@koda-sl/baker-cli 0.573.0 → 0.574.0-dev.19539e5a8

package/dist/top-companies-SCKUWYFG.js

@@ -0,0 +1,111 @@
+import {
+  csvOrJson,
+  daysAgoIso,
+  handleLinkedinError,
+  todayIso
+} from "./chunk-6TNRSWNA.js";
+import {
+  TABLE_OUTPUT_FORMATS,
+  outputFormatRefusal,
+  writeAdsJson,
+  writeAdsOutput,
+  writeJsonEnvelope
+} from "./chunk-MPTNN35I.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-HPF3USL2.js";
+import "./chunk-5N77IAOT.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-IMS53EQU.js";
+import {
+  apiPost
+} from "./chunk-LJEJCIHR.js";
+import "./chunk-SIRRBWQ2.js";
+import "./chunk-B64KJW5C.js";
+import "./chunk-NXNOXZGB.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-SCKUWYFG.js.map

package/dist/transcript-H7VSMOMV.js

@@ -0,0 +1,165 @@
+import {
+  transcriptHints
+} from "./chunk-6RWLCOAH.js";
+import {
+  handleResearchError,
+  writeResearchJson
+} from "./chunk-MTW2NDDD.js";
+import "./chunk-5N77IAOT.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-IMS53EQU.js";
+import {
+  apiPost
+} from "./chunk-LJEJCIHR.js";
+import "./chunk-SIRRBWQ2.js";
+import "./chunk-B64KJW5C.js";
+import {
+  registerSchema
+} from "./chunk-NXNOXZGB.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-H7VSMOMV.js.map