@koda-sl/baker-cli 0.573.0 → 0.574.0

package/dist/top-companies-5SZO3NVE.js

@@ -0,0 +1,246 @@
+import {
+  companyNameKey
+} from "./chunk-AYKV2B6X.js";
+import {
+  knowledgeTargetsHint,
+  targetsArg
+} from "./chunk-SSFQNMPS.js";
+import {
+  targetsHints
+} from "./chunk-UYOUNHUQ.js";
+import "./chunk-MNJT2F7H.js";
+import "./chunk-VASOAJDL.js";
+import "./chunk-IPEQHZ5H.js";
+import "./chunk-GRQ2AXDX.js";
+import {
+  csvOrJson,
+  daysAgoIso,
+  handleLinkedinError,
+  optionalAccountIdArg,
+  todayIso
+} from "./chunk-SLTZC32B.js";
+import {
+  TABLE_OUTPUT_FORMATS,
+  outputFormatRefusal,
+  writeAdsJson,
+  writeAdsOutput,
+  writeJsonEnvelope
+} from "./chunk-VJUVTMHY.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-HPF3USL2.js";
+import {
+  organizationUrnOf,
+  targetsSummary
+} from "./chunk-AJ4OO3CV.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-3WOFZTGC.js";
+import "./chunk-XHWHBGKX.js";
+import {
+  apiPost
+} from "./chunk-JCFZ7ECN.js";
+import "./chunk-OFSUVUXT.js";
+import "./chunk-OMLZ35HJ.js";
+import "./chunk-NXNOXZGB.js";
+import "./chunk-YQSBHWOI.js";
+
+// ../api/src/accounts/targetMatch.ts
+function indexTargets(targets) {
+  const index = { byOrg: /* @__PURE__ */ new Map(), byDomain: /* @__PURE__ */ new Map(), byName: /* @__PURE__ */ new Map() };
+  const claim = (map, key, target) => {
+    if (key && !map.has(key)) map.set(key, target);
+  };
+  for (const target of targets) {
+    claim(index.byOrg, target.organizationUrn ? organizationUrnOf(target.organizationUrn) : void 0, target);
+    claim(index.byDomain, target.domain, target);
+    claim(index.byName, target.name ? companyNameKey(target.name) : void 0, target);
+  }
+  return index;
+}
+function targetOf(company, index) {
+  const byOrg = index.byOrg.get(company.org);
+  if (byOrg) return { target: byOrg, by: "organization" };
+  const byDomain = company.domain ? index.byDomain.get(company.domain) : void 0;
+  if (byDomain) return { target: byDomain, by: "domain" };
+  const key = company.name ? companyNameKey(company.name) : "";
+  const byName = key !== "" ? index.byName.get(key) : void 0;
+  return byName ? { target: byName, by: "name" } : null;
+}
+function matchTargets(companies, targets) {
+  const index = indexTargets(targets);
+  const matched = companies.flatMap((company) => {
+    const found = targetOf(company, index);
+    return found ? [{ company, ...found }] : [];
+  });
+  const reached = new Set(matched.map(({ target }) => target.domain));
+  return { matched, notMatched: targets.filter((target) => !reached.has(target.domain)) };
+}
+
+// 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`.";
+function topTargetCompanies(rows, targets) {
+  const companies = rows.flatMap((row) => {
+    const org = row.pivot.find((entry) => entry.urn.startsWith("urn:li:organization:"));
+    return org ? [{ row, org: org.urn, ...org.name ? { name: org.name } : {} }] : [];
+  });
+  const { matched } = matchTargets(companies, targets);
+  const kept = matched.map(({ company, target, by }) => ({ ...company.row, target: { ...target, matchedBy: by } }));
+  const reached = kept.map((row) => ({ domain: row.target.domain, engagements: Number(row.totalEngagements ?? 0) }));
+  return { rows: kept, targets: targetsSummary(targets, reached) };
+}
+var ENGAGEMENT_INTENTS = /* @__PURE__ */ new Set(["engagement"]);
+function topCompaniesIntent(intent, withTargets) {
+  if (!withTargets) return { intent: intent ?? "baseline" };
+  if (intent === void 0 || ENGAGEMENT_INTENTS.has(intent)) return { intent: intent ?? "engagement" };
+  return {
+    invalid: `--targets counts which target accounts engaged, and --intent ${intent} reads no engagements. Drop --intent, or pass --intent engagement.`
+  };
+}
+var TOP_COMPANIES_ROWS = 500;
+function topTargetsHint(summary, rowsRead) {
+  const nameless = summary.notReached.filter((target) => !target.name && !target.organizationUrn).length;
+  const full = rowsRead >= TOP_COMPANIES_ROWS;
+  if (summary.notReached.length === 0 || nameless === 0 && !full) return null;
+  const reasons = [
+    ...nameless > 0 ? [
+      `${nameless === 1 ? "1 target account has" : `${nameless} target accounts have`} neither a name nor a LinkedIn page, and this read matches on nothing else`
+    ] : [],
+    ...full ? [`this read covers only the ${TOP_COMPANIES_ROWS} companies with the most impressions`] : []
+  ];
+  return `Some targets never reached may have been: ${reasons.join("; ")}. \`baker ads linkedin companies --targets\` matches websites too, across every company reached.`;
+}
+function topCompaniesRead(args) {
+  const formatRefusal = outputFormatRefusal(csvOrJson(args), TABLE_OUTPUT_FORMATS);
+  if (formatRefusal !== null) return { invalid: formatRefusal };
+  let targets;
+  try {
+    targets = targetsArg(args.targets, args.tier);
+  } catch (err) {
+    return { invalid: `--targets: ${err instanceof Error ? err.message : String(err)}` };
+  }
+  const ids = String(args["campaign-id"] ?? "").split(",").map((id) => id.trim()).filter(Boolean);
+  if (ids.length > 0) return { level: "campaign", scope: ids, targets };
+  const accountId = optionalAccountIdArg(args);
+  if (accountId === void 0) {
+    return {
+      invalid: "This company has several LinkedIn ad accounts selected: pass --account-id for a whole-account read, or --campaign-id. Run `baker ads linkedin accounts` to list them."
+    };
+  }
+  return { level: "account", scope: [accountId], targets };
+}
+function topCompaniesAnswer(rows, targets, topN) {
+  const sorted = [...rows].sort((a, b) => Number(b.impressions ?? 0) - Number(a.impressions ?? 0));
+  const narrowed = targets ? topTargetCompanies(sorted, targets.targets) : null;
+  const top = narrowed ? narrowed.rows : sorted.slice(0, topN);
+  const missedHint = narrowed ? topTargetsHint(narrowed.targets, rows.length) : null;
+  const hints = [
+    ...targets ? targetsHints(narrowed?.targets, targets.unreadable) : knowledgeTargetsHint(),
+    ...missedHint ? [missedHint] : [],
+    COMPANIES_HINT
+  ];
+  return { top, narrowed, hints };
+}
+var topCompaniesCommand = defineCommand({
+  meta: {
+    name: "top-companies",
+    description: `Top companies whose employees saw / clicked / converted on some campaigns, or the whole ad account.
+
+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.
+Scoring a target-account list? Pass --targets (one call; every target's row, plus the ones never reached) \u2014
+never --top-n 500 joined by hand. For months of whole-account reach, use \`baker ads linkedin companies\`.
+
+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
+  baker ads linkedin top-companies --targets targets.csv --tier 1 --intent engagement --last-days 60   # whole account`
+  },
+  args: {
+    "campaign-id": { type: "string", description: "Comma-separated campaign IDs (default: the whole ad account)" },
+    "account-id": {
+      type: "string",
+      description: "Ad account (numeric or urn:li:sponsoredAccount:N) for a whole-account read. Default: the only selected one"
+    },
+    targets: {
+      type: "string",
+      description: "Only these target accounts: the file `node __tooling__/scripts/target-accounts.mjs --out targets.csv` writes (or any .csv/.json `baker accounts --targets` takes). Matched on LinkedIn page, then name; --top-n does not apply"
+    },
+    tier: { type: "string", description: "With --targets: only this tier's accounts" },
+    intent: {
+      type: "string",
+      description: "baseline | revenue | funnel | engagement | lead-gen (default: baseline; engagement with --targets)"
+    },
+    "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 read = topCompaniesRead(args);
+    if ("invalid" in read) {
+      writeAdsJson({ ok: false, error: { code: "INVALID_ARGS", message: read.invalid } });
+      process.exit(1);
+    }
+    const { level, scope, targets } = read;
+    const chosen = topCompaniesIntent(args.intent, targets !== null);
+    if ("invalid" in chosen) {
+      writeAdsJson({ ok: false, error: { code: "INVALID_ARGS", message: chosen.invalid } });
+      process.exit(1);
+    }
+    const { intent } = chosen;
+    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,
+          ids: scope,
+          intent,
+          pivot: "company",
+          start,
+          end,
+          granularity: "ALL",
+          limit: TOP_COMPANIES_ROWS
+        },
+        skipCache: Boolean(args["no-cache"])
+      });
+      const { top, narrowed, hints } = topCompaniesAnswer(data.rows, targets, topN);
+      const fmt = csvOrJson(args);
+      if (fmt !== "json") {
+        writeAdsOutput(top, fmt, targets ? [...data.fields, "target"] : data.fields, hints);
+        return;
+      }
+      writeJsonEnvelope({
+        ok: true,
+        data: {
+          query: { level, ids: scope, start, end, intent, ...targets ? {} : { topN } },
+          rows: top,
+          ...narrowed ? { targets: narrowed.targets } : {},
+          warnings: data.warnings
+        },
+        hints
+      });
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+export {
+  TOP_COMPANIES_ROWS,
+  topCompaniesCommand,
+  topCompaniesIntent,
+  topTargetCompanies,
+  topTargetsHint
+};
+//# sourceMappingURL=top-companies-5SZO3NVE.js.map

package/dist/top-companies-5SZO3NVE.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../api/src/accounts/targetMatch.ts","../src/commands/ads/linkedin/top-companies.ts"],"sourcesContent":["/**\n * Which companies a LinkedIn read returned are target accounts. A company is\n * matched on its LinkedIn page first, then its website, then its name\n * (`companyNameKey` equality, never a fuzzy score: a wrong match puts the\n * wrong company in front of sales). One target can own several LinkedIn pages\n * — a company's regional pages share its website — but a page belongs to one\n * target only.\n */\n\nimport { companyNameKey } from \"./companyName\";\nimport { organizationUrnOf } from \"./organizationUrn\";\nimport type { TargetAccount } from \"./targets\";\n\nexport type TargetMatchBy = \"organization\" | \"domain\" | \"name\";\n\nexport interface TargetMatch<T> {\n  company: T;\n  target: TargetAccount;\n  by: TargetMatchBy;\n}\n\ninterface CompanyIdentity {\n  /** `urn:li:organization:N`. */\n  org: string;\n  name?: string;\n  domain?: string;\n}\n\ninterface TargetIndex {\n  byOrg: Map<string, TargetAccount>;\n  byDomain: Map<string, TargetAccount>;\n  byName: Map<string, TargetAccount>;\n}\n\n/** Each target under its LinkedIn page, website and name; the first target to claim a key keeps it. */\nfunction indexTargets(targets: readonly TargetAccount[]): TargetIndex {\n  const index: TargetIndex = { byOrg: new Map(), byDomain: new Map(), byName: new Map() };\n  const claim = (map: Map<string, TargetAccount>, key: string | undefined, target: TargetAccount) => {\n    if (key && !map.has(key)) map.set(key, target);\n  };\n  for (const target of targets) {\n    claim(index.byOrg, target.organizationUrn ? organizationUrnOf(target.organizationUrn) : undefined, target);\n    claim(index.byDomain, target.domain, target);\n    claim(index.byName, target.name ? companyNameKey(target.name) : undefined, target);\n  }\n  return index;\n}\n\n/** The target a company is, and how it was recognised: LinkedIn page, then website, then name. */\nfunction targetOf(company: CompanyIdentity, index: TargetIndex): { target: TargetAccount; by: TargetMatchBy } | null {\n  const byOrg = index.byOrg.get(company.org);\n  if (byOrg) return { target: byOrg, by: \"organization\" };\n  const byDomain = company.domain ? index.byDomain.get(company.domain) : undefined;\n  if (byDomain) return { target: byDomain, by: \"domain\" };\n  const key = company.name ? companyNameKey(company.name) : \"\";\n  const byName = key !== \"\" ? index.byName.get(key) : undefined;\n  return byName ? { target: byName, by: \"name\" } : null;\n}\n\n/** Matches in the companies' order, and the targets no company matched, in the list's order. */\nexport function matchTargets<T extends CompanyIdentity>(\n  companies: readonly T[],\n  targets: readonly TargetAccount[],\n): { matched: TargetMatch<T>[]; notMatched: TargetAccount[] } {\n  const index = indexTargets(targets);\n  const matched = companies.flatMap((company) => {\n    const found = targetOf(company, index);\n    return found ? [{ company, ...found }] : [];\n  });\n  const reached = new Set(matched.map(({ target }) => target.domain));\n  return { matched, notMatched: targets.filter((target) => !reached.has(target.domain)) };\n}\n\n/** A company as the Account insights reports list it: a bare LinkedIn id, its website, and its LinkedIn or CRM name. */\ninterface AccountRowIdentity {\n  orgId: string;\n  name: string;\n  domain: string;\n  crmCompanyName?: string | null;\n}\n\n/**\n * The target each listed company is, by its LinkedIn id — the one matcher\n * `baker accounts … --targets`, the Accounts screen and the warm-account\n * trigger share with the LinkedIn reads, so \"is this a target\" has one answer.\n */\nexport function accountRowTargets(\n  rows: readonly AccountRowIdentity[],\n  targets: readonly TargetAccount[],\n): Map<string, TargetAccount> {\n  if (targets.length === 0) return new Map();\n  const { matched } = matchTargets(\n    rows.map((row) => ({\n      orgId: row.orgId,\n      org: `urn:li:organization:${row.orgId}`,\n      name: row.name || row.crmCompanyName || \"\",\n      domain: row.domain,\n    })),\n    targets,\n  );\n  return new Map(matched.map(({ company, target }) => [company.orgId, target] as const));\n}\n","import { matchTargets } from \"@baker/api/accounts/targetMatch\";\nimport { type TargetAccount, type TargetsSummary, targetsSummary } from \"@baker/api/accounts/targets\";\nimport { defineCommand } from \"citty\";\nimport { NO_CACHE_ARG } from \"../../../cache-flag.ts\";\nimport { apiPost } from \"../../../client.ts\";\nimport { targetsHints } from \"../../accounts/report.ts\";\nimport type { TargetsFile } from \"../../accounts/targets.ts\";\nimport {\n  outputFormatRefusal,\n  TABLE_OUTPUT_FORMATS,\n  writeAdsJson,\n  writeAdsOutput,\n  writeJsonEnvelope,\n} from \"../output.ts\";\nimport { knowledgeTargetsHint, targetsArg } from \"./companies.ts\";\nimport { csvOrJson, daysAgoIso, handleLinkedinError, optionalAccountIdArg, todayIso } from \"./shared.ts\";\n\nconst COMPANIES_HINT =\n  \"For whole-account reach over months (one row per company, --by month|campaign, --with-domains), use `baker ads linkedin companies`.\";\n\ninterface PivotRow {\n  pivot: Array<{ urn: string; id?: string; name?: string }>;\n  [field: string]: unknown;\n}\n\n/**\n * The target accounts among a company-pivot read's rows, in its order, each\n * with the target it is and how it was recognised (`matchTargets` — LinkedIn\n * page, then name: this read carries no websites), and how far the ads got\n * with the list.\n */\nexport function topTargetCompanies<T extends PivotRow>(\n  rows: readonly T[],\n  targets: readonly TargetAccount[],\n): { rows: Array<T & { target: TargetAccount & { matchedBy: string } }>; targets: TargetsSummary } {\n  const companies = rows.flatMap((row) => {\n    const org = row.pivot.find((entry) => entry.urn.startsWith(\"urn:li:organization:\"));\n    return org ? [{ row, org: org.urn, ...(org.name ? { name: org.name } : {}) }] : [];\n  });\n  const { matched } = matchTargets(companies, targets);\n  const kept = matched.map(({ company, target, by }) => ({ ...company.row, target: { ...target, matchedBy: by } }));\n  const reached = kept.map((row) => ({ domain: row.target.domain, engagements: Number(row.totalEngagements ?? 0) }));\n  return { rows: kept, targets: targetsSummary(targets, reached) };\n}\n\n/** Intents whose read carries `totalEngagements`, which `--targets` needs to say which targets engaged. */\nconst ENGAGEMENT_INTENTS = new Set([\"engagement\"]);\n\n/**\n * The intent a top-companies read asks for: `--targets` counts which reached\n * targets engaged, so it reads engagements, and refuses an intent that has none\n * rather than calling every target unengaged.\n */\nexport function topCompaniesIntent(\n  intent: string | undefined,\n  withTargets: boolean,\n): { intent: string } | { invalid: string } {\n  if (!withTargets) return { intent: intent ?? \"baseline\" };\n  if (intent === undefined || ENGAGEMENT_INTENTS.has(intent)) return { intent: intent ?? \"engagement\" };\n  return {\n    invalid: `--targets counts which target accounts engaged, and --intent ${intent} reads no engagements. Drop --intent, or pass --intent engagement.`,\n  };\n}\n\n/** Companies one top-companies read returns at most. */\nexport const TOP_COMPANIES_ROWS = 500;\n\n/**\n * Why a target this read missed may still have been reached: it matches on the\n * page and the name only, within the companies with the most impressions. Null\n * when neither applies.\n */\nexport function topTargetsHint(summary: TargetsSummary, rowsRead: number): string | null {\n  const nameless = summary.notReached.filter((target) => !target.name && !target.organizationUrn).length;\n  const full = rowsRead >= TOP_COMPANIES_ROWS;\n  if (summary.notReached.length === 0 || (nameless === 0 && !full)) return null;\n  const reasons = [\n    ...(nameless > 0\n      ? [\n          `${nameless === 1 ? \"1 target account has\" : `${nameless} target accounts have`} neither a name nor a LinkedIn page, and this read matches on nothing else`,\n        ]\n      : []),\n    ...(full ? [`this read covers only the ${TOP_COMPANIES_ROWS} companies with the most impressions`] : []),\n  ];\n  return `Some targets never reached may have been: ${reasons.join(\"; \")}. \\`baker ads linkedin companies --targets\\` matches websites too, across every company reached.`;\n}\n\ninterface AnalyticsResponse {\n  rows: PivotRow[];\n  fields: string[];\n  warnings: Array<{ code: string; message: string }>;\n}\n\n/** What a top-companies call reads — the named campaigns, else the (only) ad account — or why it cannot. */\nfunction topCompaniesRead(\n  args: Record<string, unknown>,\n): { level: \"campaign\" | \"account\"; scope: string[]; targets: TargetsFile | null } | { invalid: string } {\n  const formatRefusal = outputFormatRefusal(csvOrJson(args), TABLE_OUTPUT_FORMATS);\n  if (formatRefusal !== null) return { invalid: formatRefusal };\n  let targets: TargetsFile | null;\n  try {\n    targets = targetsArg(args.targets as string | undefined, args.tier as string | undefined);\n  } catch (err) {\n    return { invalid: `--targets: ${err instanceof Error ? err.message : String(err)}` };\n  }\n  const ids = String(args[\"campaign-id\"] ?? \"\")\n    .split(\",\")\n    .map((id) => id.trim())\n    .filter(Boolean);\n  if (ids.length > 0) return { level: \"campaign\", scope: ids, targets };\n  const accountId = optionalAccountIdArg(args);\n  if (accountId === undefined) {\n    return {\n      invalid:\n        \"This company has several LinkedIn ad accounts selected: pass --account-id for a whole-account read, or --campaign-id. Run `baker ads linkedin accounts` to list them.\",\n    };\n  }\n  return { level: \"account\", scope: [accountId], targets };\n}\n\n/** The rows the read answers with — the target accounts it reached, or the top N by impressions — and its hints. */\nfunction topCompaniesAnswer(rows: PivotRow[], targets: TargetsFile | null, topN: number) {\n  const sorted = [...rows].sort((a, b) => Number(b.impressions ?? 0) - Number(a.impressions ?? 0));\n  const narrowed = targets ? topTargetCompanies(sorted, targets.targets) : null;\n  const top = narrowed ? narrowed.rows : sorted.slice(0, topN);\n  const missedHint = narrowed ? topTargetsHint(narrowed.targets, rows.length) : null;\n  const hints = [\n    ...(targets ? targetsHints(narrowed?.targets, targets.unreadable) : knowledgeTargetsHint()),\n    ...(missedHint ? [missedHint] : []),\n    COMPANIES_HINT,\n  ];\n  return { top, narrowed, hints };\n}\n\n/**\n * Top-companies — pivot=MEMBER_COMPANY shortcut. The single highest-leverage\n * LinkedIn-native query for ABM.\n *\n * pivotValues come back as [\"urn:li:organization:1234567\"]. The backend resolves\n * these org URNs to company names automatically (one batched, cached call), so\n * each row's pivot[] carries a `name`. URNs LinkedIn can't resolve stay unnamed —\n * use `baker ads linkedin resolve` to probe them individually.\n */\nexport const topCompaniesCommand = defineCommand({\n  meta: {\n    name: \"top-companies\",\n    description: `Top companies whose employees saw / clicked / converted on some campaigns, or the whole ad account.\n\nWrapper for: analytics --pivot company. Returns rows sorted by impressions desc.\nEach row's pivot[] contains { urn, id, name } — org names are resolved automatically.\nScoring a target-account list? Pass --targets (one call; every target's row, plus the ones never reached) —\nnever --top-n 500 joined by hand. For months of whole-account reach, use \\`baker ads linkedin companies\\`.\n\nDemographic data is delayed 12-24h with a ≥3-event privacy floor.\n\nExamples:\n  baker ads linkedin top-companies --campaign-id 1234 --last-days 30\n  baker ads linkedin top-companies --campaign-id 1,2,3 --intent revenue --last-days 90 --top-n 50\n  baker ads linkedin top-companies --campaign-id 1234 --output csv\n  baker ads linkedin top-companies --targets targets.csv --tier 1 --intent engagement --last-days 60   # whole account`,\n  },\n  args: {\n    \"campaign-id\": { type: \"string\", description: \"Comma-separated campaign IDs (default: the whole ad account)\" },\n    \"account-id\": {\n      type: \"string\",\n      description:\n        \"Ad account (numeric or urn:li:sponsoredAccount:N) for a whole-account read. Default: the only selected one\",\n    },\n    targets: {\n      type: \"string\",\n      description:\n        \"Only these target accounts: the file `node __tooling__/scripts/target-accounts.mjs --out targets.csv` writes (or any .csv/.json `baker accounts --targets` takes). Matched on LinkedIn page, then name; --top-n does not apply\",\n    },\n    tier: { type: \"string\", description: \"With --targets: only this tier's accounts\" },\n    intent: {\n      type: \"string\",\n      description: \"baseline | revenue | funnel | engagement | lead-gen (default: baseline; engagement with --targets)\",\n    },\n    \"top-n\": { type: \"string\", description: \"Top rows by impressions (default: 25)\" },\n    start: { type: \"string\", description: \"Start date YYYY-MM-DD\" },\n    end: { type: \"string\", description: \"End date YYYY-MM-DD\" },\n    \"last-days\": { type: \"string\", description: \"Window relative to today (default: 30)\" },\n    \"no-cache\": NO_CACHE_ARG,\n    output: { type: \"string\", description: \"json|csv|jsonl|md\", default: \"json\" },\n  },\n  run: async ({ args }) => {\n    const read = topCompaniesRead(args);\n    if (\"invalid\" in read) {\n      writeAdsJson({ ok: false, error: { code: \"INVALID_ARGS\", message: read.invalid } });\n      process.exit(1);\n    }\n    const { level, scope, targets } = read;\n    const chosen = topCompaniesIntent(args.intent as string | undefined, targets !== null);\n    if (\"invalid\" in chosen) {\n      writeAdsJson({ ok: false, error: { code: \"INVALID_ARGS\", message: chosen.invalid } });\n      process.exit(1);\n    }\n    const { intent } = chosen;\n    const topN = args[\"top-n\"] ? Number(args[\"top-n\"]) : 25;\n\n    const start = (args.start as string | undefined) ?? daysAgoIso(args[\"last-days\"] ? Number(args[\"last-days\"]) : 30);\n    const end = (args.end as string | undefined) ?? todayIso();\n\n    try {\n      const data = await apiPost<AnalyticsResponse>(\"/api/ads/linkedin/analytics\", {\n        request: {\n          level,\n          ids: scope,\n          intent,\n          pivot: \"company\",\n          start,\n          end,\n          granularity: \"ALL\",\n          limit: TOP_COMPANIES_ROWS,\n        },\n        skipCache: Boolean(args[\"no-cache\"]),\n      });\n\n      const { top, narrowed, hints } = topCompaniesAnswer(data.rows, targets, topN);\n\n      const fmt = csvOrJson(args);\n      if (fmt !== \"json\") {\n        writeAdsOutput(top, fmt, targets ? [...data.fields, \"target\"] : data.fields, hints);\n        return;\n      }\n      writeJsonEnvelope({\n        ok: true,\n        data: {\n          query: { level, ids: scope, start, end, intent, ...(targets ? {} : { topN }) },\n          rows: top,\n          ...(narrowed ? { targets: narrowed.targets } : {}),\n          warnings: data.warnings,\n        },\n        hints,\n      });\n    } catch (err) {\n      handleLinkedinError(err);\n    }\n  },\n});\n"],"mappings":"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","names":[]}

package/dist/transcript-JHGN7KW7.js

@@ -0,0 +1,165 @@
+import {
+  transcriptHints
+} from "./chunk-P3CYWSTO.js";
+import {
+  handleResearchError,
+  writeResearchJson
+} from "./chunk-7PKEBTVP.js";
+import "./chunk-AJ4OO3CV.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-3WOFZTGC.js";
+import "./chunk-XHWHBGKX.js";
+import {
+  apiPost
+} from "./chunk-JCFZ7ECN.js";
+import "./chunk-OFSUVUXT.js";
+import "./chunk-OMLZ35HJ.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-JHGN7KW7.js.map