@koda-sl/baker-cli 0.510.0 → 0.511.0-dev.2d26314a2

package/dist/draft-WOKX5ZAC.js

@@ -0,0 +1,308 @@
+import {
+  loadPatchArg,
+  requireTarget
+} from "./chunk-BJVXXJ4H.js";
+import {
+  handleLinkedinError
+} from "./chunk-LOQYUZ5H.js";
+import "./chunk-SCAGMX2I.js";
+import "./chunk-4NZ47VXO.js";
+import {
+  hintLines
+} from "./chunk-D5FY4FAK.js";
+import "./chunk-QPESDKZC.js";
+import {
+  writeJsonEnvelope
+} from "./chunk-ZRP7Y2DM.js";
+import "./chunk-E44NXCTL.js";
+import "./chunk-EJGAJHLB.js";
+import "./chunk-LNNTHEL7.js";
+import "./chunk-FOMFU2RX.js";
+import "./chunk-PSGIHSNC.js";
+import "./chunk-PONLPYD7.js";
+import {
+  CHAT_READ_ARG
+} from "./chunk-PFBQERWX.js";
+import "./chunk-4CNR3MNJ.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-HNNCAJNF.js";
+import {
+  apiPost
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import {
+  requireChatId,
+  resolveChatId
+} from "./chunk-LGK7UWBN.js";
+import "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/linkedin/draft.ts
+import { defineCommand } from "citty";
+
+// src/commands/ads/linkedin/draft-status.ts
+var OPERATION_LABELS = {
+  create: "Creating",
+  update: "Updating",
+  pause: "Pausing",
+  resume: "Resuming",
+  archive: "Archiving",
+  delete: "Deleting"
+};
+function badge(node) {
+  const label = node.operation ? OPERATION_LABELS[node.operation] : void 0;
+  if (label) {
+    return label;
+  }
+  return node.existing ? "on LinkedIn" : "staged";
+}
+function collectionLine(collection) {
+  const parts = [];
+  if (collection.added > 0) {
+    parts.push(`+${collection.added}`);
+  }
+  if (collection.existing > 0) {
+    parts.push(`${collection.existing} existing`);
+  }
+  if (collection.removed > 0) {
+    parts.push(`-${collection.removed}`);
+  }
+  return parts.length > 0 ? `${collection.label}: ${parts.join(", ")}` : void 0;
+}
+function accountsInTree(nodes) {
+  const accounts = /* @__PURE__ */ new Set();
+  const walk = (node) => {
+    accounts.add(node.accountId);
+    for (const child of node.children) {
+      walk(child);
+    }
+  };
+  for (const node of nodes) {
+    walk(node);
+  }
+  return accounts;
+}
+function renderNode(node, depth, lines, showAccount) {
+  const indent = "  ".repeat(depth);
+  const account = showAccount ? ` \xB7 account ${node.accountId}` : "";
+  lines.push(`${indent}\u2022 ${node.name} \xB7 ${badge(node)}${account}`);
+  for (const warning of node.warnings ?? []) {
+    lines.push(`${indent}    \u26A0 ${warning}`);
+  }
+  for (const collection of node.collections) {
+    const line = collectionLine(collection);
+    if (line) {
+      lines.push(`${indent}    ${line}`);
+    }
+  }
+  for (const child of node.children) {
+    renderNode(child, depth + 1, lines, showAccount);
+  }
+}
+function renderSection(title, nodes, lines, showAccount) {
+  if (nodes.length === 0) {
+    return;
+  }
+  lines.push("");
+  lines.push(title);
+  for (const node of nodes) {
+    renderNode(node, 1, lines, showAccount);
+  }
+}
+var CAMPAIGN_TREE_ENTITIES = /* @__PURE__ */ new Set(["campaignGroup", "campaign", "creative"]);
+function renderOutcome(data, lines) {
+  const counts = /* @__PURE__ */ new Map();
+  for (const op of data.ops ?? []) {
+    const status = op.result?.status ?? "pending";
+    counts.set(status, (counts.get(status) ?? 0) + 1);
+  }
+  const summary = [...counts].map(([status, count]) => `${count} ${status}`).join(", ");
+  lines.push(`LinkedIn Ads \u2014 published \xB7 ${summary || `${data.count} op(s)`} \xB7 ${data.mode}`);
+  for (const op of data.ops ?? []) {
+    const status = op.result?.status;
+    if (status === "applied" && op.result?.error) {
+      lines.push(`  \u26A0 ${op.summary} \u2014 applied in part: ${op.result.error}`);
+      continue;
+    }
+    if (status !== "failed" && status !== "skipped") {
+      continue;
+    }
+    const reason = op.result?.error ?? op.result?.skippedBecause ?? "no reason recorded";
+    lines.push(`  \u2717 ${op.summary} \u2014 ${status}: ${reason}`);
+  }
+}
+function renderDraftStatus(data) {
+  if (data.status === "none" || data.count === 0) {
+    return "No staged LinkedIn changes on this chat.";
+  }
+  const modeNote = data.mode === "live" ? "Live \u2014 publishing writes directly to LinkedIn." : "Simulated \u2014 publishing completes the whole draft without calling LinkedIn.";
+  const lines = [];
+  if (data.status === "applied") {
+    renderOutcome(data, lines);
+  } else if (data.status === "publishing") {
+    lines.push(`LinkedIn Ads \u2014 publishing ${data.count} change${data.count === 1 ? "" : "s"} \xB7 ${data.mode}`);
+  } else {
+    lines.push(`LinkedIn Ads \u2014 ${data.count} staged change${data.count === 1 ? "" : "s"} \xB7 ${data.mode}`);
+  }
+  lines.push(modeNote);
+  const tree = data.tree ?? [];
+  const showAccount = accountsInTree(tree).size > 1;
+  renderSection(
+    "Campaigns",
+    tree.filter((node) => CAMPAIGN_TREE_ENTITIES.has(node.entity)),
+    lines,
+    showAccount
+  );
+  const rest = tree.filter((node) => !CAMPAIGN_TREE_ENTITIES.has(node.entity));
+  renderSection("Other", rest, lines, showAccount);
+  return lines.join("\n");
+}
+
+// src/commands/ads/linkedin/draft.ts
+async function listDraft(json, chat) {
+  try {
+    const chatId = resolveChatId(chat);
+    const response = await apiPost("/api/ads/linkedin/draft", {
+      chatId
+    });
+    if (json || !response.ok || !response.data) {
+      writeJsonEnvelope(response);
+      return;
+    }
+    process.stdout.write(`${renderDraftStatus(response.data)}${hintLines(response)}
+`);
+  } catch (err) {
+    handleLinkedinError(err);
+  }
+}
+var listCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "Review everything staged as a Campaign group \u25B8 Campaign \u25B8 Creative tree (--json for the raw envelope). Example: baker ads linkedin draft"
+  },
+  args: {
+    json: { type: "boolean", description: "Print the raw JSON envelope instead of the readable tree" },
+    chat: CHAT_READ_ARG
+  },
+  run: async ({ args }) => {
+    await listDraft(args.json === true, args.chat);
+  }
+});
+var removeCommand = defineCommand({
+  meta: {
+    name: "remove",
+    description: "Drop one staged LinkedIn op. Removing a create cascades to everything that depends on it \u2014 except a company exclusion, which only loses the removed audience and keeps its companies (listed under `updated`). Example: baker ads linkedin draft remove li_temp_abc123"
+  },
+  args: {
+    ref: {
+      type: "positional",
+      description: "Op ref (li_temp_* for creates, target id/URN for updates)",
+      required: true
+    }
+  },
+  run: async ({ args }) => {
+    try {
+      const chatId = requireChatId();
+      const response = await apiPost(
+        "/api/ads/linkedin/draft/remove",
+        { chatId, ref: args.ref }
+      );
+      writeJsonEnvelope(response);
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+var clearCommand = defineCommand({
+  meta: {
+    name: "clear",
+    description: "Discard ALL staged LinkedIn ops in this chat's draft \u2014 nothing will apply on publish. Example: baker ads linkedin draft clear"
+  },
+  run: async () => {
+    try {
+      const chatId = requireChatId();
+      const response = await apiPost("/api/ads/linkedin/draft/clear", {
+        chatId
+      });
+      writeJsonEnvelope(response);
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+var amendCommand = defineCommand({
+  meta: {
+    name: "amend",
+    description: "Update a staged op in place \u2014 merges a JSON patch into its payload (RFC-7386: objects deep-merge, null deletes a key, arrays/scalars replace) and re-validates. Use this instead of remove + re-create."
+  },
+  args: {
+    ref: { type: "positional", description: "Staged op ref (li_temp_*) or target id/URN", required: true },
+    file: { type: "string", description: "JSON file with the patch object" },
+    patch: { type: "string", description: "Inline JSON patch object" }
+  },
+  run: async ({ args }) => {
+    const ref = requireTarget(args, "op");
+    const patch = loadPatchArg(args);
+    try {
+      const chatId = requireChatId();
+      const body = { chatId, ref, patch };
+      const response = await apiPost(
+        "/api/ads/linkedin/draft/amend",
+        body
+      );
+      writeJsonEnvelope(response);
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+var showCommand = defineCommand({
+  meta: {
+    name: "show",
+    description: "Print the full staged payload for one op \u2014 the receipt to verify a change looks right before publish (never truncated)."
+  },
+  args: {
+    ref: { type: "positional", description: "Staged op ref (li_temp_*) or target id/URN", required: true },
+    chat: CHAT_READ_ARG
+  },
+  run: async ({ args }) => {
+    const ref = requireTarget(args, "op");
+    try {
+      const chatId = resolveChatId(args.chat);
+      const body = { chatId, ref };
+      const response = await apiPost(
+        "/api/ads/linkedin/draft/show",
+        body
+      );
+      writeJsonEnvelope(response);
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+var linkedinDraftCommand = defineCommand({
+  meta: {
+    name: "draft",
+    description: "Review and edit the LinkedIn write ops staged in this chat BEFORE publish. Subcommands: list (default), remove, clear, amend, show. Ops never hit LinkedIn until the chat is published. `list` and `show` take --chat <id> to read an earlier chat's changes instead."
+  },
+  // Declared on the parent too: `default: "list"` dispatches the bare `draft --chat <id>` form, and
+  // citty prints help for a flag the parent does not know instead of forwarding it.
+  args: { chat: CHAT_READ_ARG },
+  subCommands: {
+    list: listCommand,
+    remove: removeCommand,
+    clear: clearCommand,
+    amend: amendCommand,
+    show: showCommand
+  },
+  // A parent must never declare `run`: citty falls through to it *after* running
+  // the matched subcommand, so `draft show <ref>` would also re-list the draft.
+  default: "list"
+});
+export {
+  linkedinDraftCommand
+};
+//# sourceMappingURL=draft-WOKX5ZAC.js.map

package/dist/engine/index.js

@@ -8,14 +8,14 @@ import {
   defaultRegistry,
   generateCatalog,
   validateCanvasDeep
-} from "../chunk-6KWEF6HF.js";
-import "../chunk-TX7CQTD4.js";
-import "../chunk-F4YQ5PVR.js";
+} from "../chunk-KPCHWDJM.js";
+import "../chunk-AULSX5ZA.js";
+import "../chunk-UMIX2BMM.js";
 import "../chunk-DGCUPJZD.js";
-import "../chunk-MVD7QIXI.js";
-import "../chunk-LRV6M2WB.js";
-import "../chunk-7HZSORAB.js";
-import "../chunk-MCJ5I5LR.js";
+import "../chunk-AVYUFJQQ.js";
+import "../chunk-QHZE62GP.js";
+import "../chunk-FJZYOVSW.js";
+import "../chunk-F3CZFUXZ.js";
 import "../chunk-2WZI36D3.js";
 import "../chunk-65Y3RCWP.js";
 import "../chunk-LNNTHEL7.js";

package/dist/experiments-I466EYXE.js

@@ -0,0 +1,234 @@
+import {
+  bareAccountId,
+  failWriteValidation,
+  parseDateFlag,
+  requireTarget,
+  stageOp
+} from "./chunk-BJVXXJ4H.js";
+import {
+  handleLinkedinError
+} from "./chunk-LOQYUZ5H.js";
+import "./chunk-SCAGMX2I.js";
+import "./chunk-4NZ47VXO.js";
+import "./chunk-D5FY4FAK.js";
+import "./chunk-QPESDKZC.js";
+import {
+  writeJsonEnvelope
+} from "./chunk-ZRP7Y2DM.js";
+import "./chunk-E44NXCTL.js";
+import "./chunk-EJGAJHLB.js";
+import "./chunk-LNNTHEL7.js";
+import "./chunk-FOMFU2RX.js";
+import "./chunk-PSGIHSNC.js";
+import "./chunk-PONLPYD7.js";
+import "./chunk-4CNR3MNJ.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-HNNCAJNF.js";
+import {
+  apiGet
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/linkedin/experiments.ts
+import { defineCommand } from "citty";
+var STAGED_NOTE = "Staged until publish \u2014 review with `baker ads linkedin draft`.";
+var accountArgs = {
+  "account-id": { type: "string", description: "Numeric account ID or urn:li:sponsoredAccount:N" },
+  "account-urn": { type: "string", description: "Alias for --account-id" }
+};
+var STOP_AT = {
+  "end-date": "AUTO_STOP_AT_END_DATE",
+  winner: "AUTO_STOP_AT_WINNER",
+  never: "AUTO_STOP_DISABLED"
+};
+function stopAtArg(value) {
+  if (value === void 0) {
+    return void 0;
+  }
+  const mapped = STOP_AT[String(value)];
+  if (!mapped) {
+    failWriteValidation(`--stop-at must be one of ${Object.keys(STOP_AT).join("|")}`);
+  }
+  return mapped;
+}
+function numberArg(value, flag) {
+  if (value === void 0) {
+    return void 0;
+  }
+  const parsed = Number(value);
+  if (!Number.isInteger(parsed)) {
+    failWriteValidation(`${flag} must be a whole number`);
+  }
+  return parsed;
+}
+var experimentsListCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "List the ad account's A/B tests, newest first: name, state (what was asked), running (what LinkedIn is doing: PENDING|RUNNING|ON_HOLD|STOPPED|ENDED), metric, dates and the two versions (ad sets + traffic split). Runs by default."
+  },
+  args: { ...accountArgs },
+  run: async ({ args }) => {
+    try {
+      const data = await apiGet("/api/ads/linkedin/experiments", {
+        "account-id": bareAccountId(args)
+      });
+      writeJsonEnvelope({ ok: true, data });
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+var experimentsGetCommand = defineCommand({
+  meta: {
+    name: "get",
+    description: "One A/B test with LinkedIn's setup checks (an ERROR keeps it from running \u2014 e.g. NO_ACTIVE_CREATIVES; a WARNING may skew it) and its latest result: the winning version, p-value, and each version's confidence interval for the metric. `result: null` until LinkedIn computes the first one (daily)."
+  },
+  args: {
+    id: { type: "positional", description: "A/B test id from `experiments`", required: true },
+    ...accountArgs
+  },
+  run: async ({ args }) => {
+    try {
+      const data = await apiGet("/api/ads/linkedin/experiments", {
+        "account-id": bareAccountId(args),
+        id: requireTarget(args, "A/B test")
+      });
+      writeJsonEnvelope({ ok: true, data });
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+var experimentsCreateCommand = defineCommand({
+  meta: {
+    name: "create",
+    description: `Stage an A/B test between two ad sets of the SAME campaign: LinkedIn splits the audience so each member sees only one version, and calls a winner on the metric. ${STAGED_NOTE}
+Rules LinkedIn enforces: exactly 2 ad sets, same campaign, that campaign must NOT share its budget across ad sets, at most 90 days, confidence 51\u201399 (90+ recommended), each ad set needs an active ad. Best practice: two new ad sets identical but for the one thing tested, equal budgets, 3+ weeks.
+Examples:
+  baker ads linkedin experiments create --name "Image vs video" --version-a li_temp_x1 --version-b li_temp_x2 --metric CPC --start 2026-11-01 --end 2026-11-28
+  baker ads linkedin experiments create --name "Headline test" --version-a 896802423 --name-a "Pain" --version-b 896812053 --name-b "Gain" --metric CPM --start 2026-11-01 --end 2026-12-01 --stop-at winner --confidence 95`
+  },
+  args: {
+    ...accountArgs,
+    name: { type: "string", description: "Test name (\u2264100)", required: true },
+    description: { type: "string", description: "What is being tested" },
+    "version-a": { type: "string", description: "Ad set id/URN or li_temp_* ref for version A", required: true },
+    "version-b": { type: "string", description: "Ad set id/URN or li_temp_* ref for version B", required: true },
+    "name-a": { type: "string", description: "Version A label (default A)" },
+    "name-b": { type: "string", description: "Version B label (default B)" },
+    "weight-a": { type: "string", description: "Version A share of the audience, 1\u201399 (default 50; B gets the rest)" },
+    metric: { type: "string", description: "CPC|CPM|CPV (video ad sets)|CPMS (message ads)", required: true },
+    confidence: { type: "string", description: "51\u201399 (default 90)" },
+    start: { type: "string", description: "Start date (ISO or epoch ms)", required: true },
+    end: { type: "string", description: "End date (\u226490 days after start)", required: true },
+    "stop-at": {
+      type: "string",
+      description: "end-date (default, pauses both) | winner | never (ad sets keep running)"
+    },
+    draft: { type: "boolean", description: "Create it set up but not running" }
+  },
+  run: async ({ args }) => {
+    const weightA = numberArg(args["weight-a"], "--weight-a") ?? 50;
+    await stageOp({
+      kind: "experiment.create",
+      accountId: bareAccountId(args),
+      payload: {
+        name: args.name,
+        description: args.description,
+        keyMetric: args.metric ? String(args.metric).toUpperCase() : void 0,
+        confidence: numberArg(args.confidence, "--confidence"),
+        start: parseDateFlag(args.start, "--start"),
+        end: parseDateFlag(args.end, "--end"),
+        autoStop: stopAtArg(args["stop-at"]),
+        state: args.draft ? "DRAFT" : void 0,
+        cells: [
+          { name: args["name-a"] ?? "A", campaign: args["version-a"], trafficWeight: weightA },
+          { name: args["name-b"] ?? "B", campaign: args["version-b"], trafficWeight: 100 - weightA }
+        ]
+      }
+    });
+  }
+});
+var experimentsUpdateCommand = defineCommand({
+  meta: {
+    name: "update",
+    description: `Stage changes to an A/B test. Once it has started only the name, description, end date (still \u226490 days from start), confidence and when it stops can change \u2014 the versions are fixed. ${STAGED_NOTE}
+Example: baker ads linkedin experiments update 5633011 --end 2026-12-15 --stop-at winner`
+  },
+  args: {
+    id: { type: "positional", description: "A/B test id", required: true },
+    ...accountArgs,
+    name: { type: "string", description: "New name" },
+    description: { type: "string", description: "New description" },
+    end: { type: "string", description: "New end date" },
+    confidence: { type: "string", description: "51\u201399" },
+    "stop-at": { type: "string", description: "end-date|winner|never" }
+  },
+  run: async ({ args }) => {
+    await stageOp({
+      kind: "experiment.update",
+      accountId: bareAccountId(args),
+      target: requireTarget(args, "A/B test"),
+      payload: {
+        name: args.name,
+        description: args.description,
+        end: parseDateFlag(args.end, "--end"),
+        confidence: numberArg(args.confidence, "--confidence"),
+        autoStop: stopAtArg(args["stop-at"])
+      }
+    });
+  }
+});
+function experimentStateCommand(name, state, what) {
+  return defineCommand({
+    meta: {
+      name,
+      description: `Stage ${what}. ${STAGED_NOTE}
+Example: baker ads linkedin experiments ${name} 5633011`
+    },
+    args: {
+      id: { type: "positional", description: "A/B test id", required: true },
+      ...accountArgs
+    },
+    run: async ({ args }) => {
+      await stageOp({
+        kind: "experiment.update",
+        accountId: bareAccountId(args),
+        target: requireTarget(args, "A/B test"),
+        payload: { state }
+      });
+    }
+  });
+}
+var experimentsCommand = defineCommand({
+  meta: {
+    name: "experiments",
+    description: `LinkedIn A/B tests: two ad sets of one campaign shown to separate halves of the audience, with a winner called on CPC/CPM/CPV/CPMS.
+Examples:
+  baker ads linkedin experiments                       # list
+  baker ads linkedin experiments get 5633011           # setup checks + result
+  baker ads linkedin experiments create --name "Image vs video" --version-a <ad set> --version-b <ad set> --metric CPC --start 2026-11-01 --end 2026-11-28
+  baker ads linkedin experiments pause|start|end 5633011`
+  },
+  subCommands: {
+    list: experimentsListCommand,
+    get: experimentsGetCommand,
+    create: experimentsCreateCommand,
+    update: experimentsUpdateCommand,
+    start: experimentStateCommand("start", "ACTIVE", "starting (or resuming) an A/B test"),
+    pause: experimentStateCommand("pause", "PAUSED", "pausing an A/B test \u2014 both ad sets pause, the end date stays"),
+    end: experimentStateCommand("end", "CANCELED", "ending an A/B test for good")
+  },
+  args: { ...accountArgs },
+  default: "list"
+});
+export {
+  experimentsCommand
+};
+//# sourceMappingURL=experiments-I466EYXE.js.map

package/dist/facets-SFZM5X2R.js

@@ -0,0 +1,115 @@
+import {
+  csvOrJson,
+  handleLinkedinError
+} from "./chunk-LOQYUZ5H.js";
+import {
+  writeAdsJson,
+  writeAdsOutput
+} from "./chunk-ZRP7Y2DM.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-AGBBTTKA.js";
+import "./chunk-4CNR3MNJ.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-HNNCAJNF.js";
+import {
+  apiGet
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/linkedin/facets.ts
+import { defineCommand } from "citty";
+var listCmd = defineCommand({
+  meta: {
+    name: "list",
+    description: `List every targeting facet LinkedIn supports.
+
+Cached 7 days. Use this to discover what dimensions you can target on (industries,
+seniorities, titles, employers, growthRate, companyCategory, skills, etc.).`
+  },
+  args: {
+    "no-cache": NO_CACHE_ARG,
+    output: { type: "string", description: "json|csv|jsonl|md", default: "json" }
+  },
+  run: async ({ args }) => {
+    try {
+      const params = {};
+      if (args["no-cache"]) params["skip-cache"] = "true";
+      const data = await apiGet("/api/ads/linkedin/facets", params);
+      const fmt = csvOrJson(args);
+      if (fmt !== "json") {
+        writeAdsOutput(data, fmt);
+        return;
+      }
+      writeAdsJson({ ok: true, data });
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+var valuesCmd = defineCommand({
+  meta: {
+    name: "values",
+    description: `Look up entity values for a single facet \u2014 full list or typeahead search.
+
+Examples:
+  baker ads linkedin facets values --facet seniorities                          \u2014 all seniority URNs
+  baker ads linkedin facets values --facet titles --query "marketing director"  \u2014 typeahead
+  baker ads linkedin facets values --facet industries --output csv
+
+The --facet flag accepts the bare name (industries, seniorities, titles, etc.)
+or the full URN (urn:li:adTargetingFacet:industries).`
+  },
+  args: {
+    facet: { type: "string", description: "Facet name (e.g. industries) or URN", required: true },
+    query: { type: "string", description: "Typeahead query (auto-switches finder to typeahead)" },
+    finder: { type: "string", description: "adTargetingFacet | typeahead | similarEntities (default: auto)" },
+    locale: { type: "string", description: "Locale (default: en_US)" },
+    "no-cache": NO_CACHE_ARG,
+    output: { type: "string", description: "json|csv|jsonl|md", default: "json" }
+  },
+  run: async ({ args }) => {
+    try {
+      const params = { facet: String(args.facet) };
+      const finder = args.finder ?? (args.query ? "typeahead" : "adTargetingFacet");
+      params.finder = finder;
+      if (args.query) params.query = String(args.query);
+      if (args.locale) params.locale = String(args.locale);
+      if (args["no-cache"]) params["skip-cache"] = "true";
+      const data = await apiGet("/api/ads/linkedin/facets/entities", params);
+      const fmt = csvOrJson(args);
+      if (fmt !== "json") {
+        writeAdsOutput(data, fmt);
+        return;
+      }
+      writeAdsJson({ ok: true, data });
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+var facetsCommand = defineCommand({
+  meta: {
+    name: "facets",
+    description: `LinkedIn targeting facets and entity lookup.
+
+Subcommands:
+  list                          \u2014 every facet (industries, seniorities, titles, employers, \u2026)
+  values --facet titles         \u2014 entity URNs for one facet
+  values --facet titles --query "marketing director"  \u2014 typeahead`
+  },
+  subCommands: {
+    list: listCmd,
+    values: valuesCmd
+  }
+});
+export {
+  facetsCommand
+};
+//# sourceMappingURL=facets-SFZM5X2R.js.map