@koda-sl/baker-cli 0.489.0 → 0.491.0

package/dist/rerun-4GDNBFNM.js

@@ -0,0 +1,90 @@
+import {
+  executeCanvasRun
+} from "./chunk-OM2BRYXJ.js";
+import "./chunk-4O6T76A3.js";
+import "./chunk-C7NWUCLQ.js";
+import "./chunk-WN4KX7GE.js";
+import "./chunk-DCBZ5CHZ.js";
+import "./chunk-IVIJJXXT.js";
+import "./chunk-MJQBXFW6.js";
+import "./chunk-KKJ4KJCW.js";
+import "./chunk-Q6ULQMWG.js";
+import "./chunk-3ACMDRSE.js";
+import "./chunk-LTPTJWZC.js";
+import "./chunk-ZJSGGJ5R.js";
+import "./chunk-ZEPUDYPL.js";
+import "./chunk-YLYXSJ6O.js";
+import "./chunk-D4HKJBEW.js";
+import "./chunk-PL7J3DPQ.js";
+import "./chunk-TG4NCHFS.js";
+import "./chunk-PUSBUMYM.js";
+import "./chunk-LCW3U4EA.js";
+import "./chunk-EOY6BK4C.js";
+import "./chunk-SGEPZB3D.js";
+import "./chunk-G2LGMWNG.js";
+import "./chunk-J33P2JNS.js";
+import "./chunk-BRLY6XD6.js";
+import "./chunk-JYALBYN7.js";
+import "./chunk-G6XKD7QE.js";
+import "./chunk-FNA277HP.js";
+import "./chunk-5WMTPYKT.js";
+import "./chunk-23H4ZJRP.js";
+import "./chunk-JVH5A3XC.js";
+import "./chunk-JQH5VG6F.js";
+import "./chunk-E2RFM6R2.js";
+import "./chunk-DGCUPJZD.js";
+import "./chunk-BTY4LZBG.js";
+import "./chunk-4AMIHNNP.js";
+import "./chunk-IKCP5NCE.js";
+import "./chunk-MCJ5I5LR.js";
+import "./chunk-2WZI36D3.js";
+import "./chunk-65Y3RCWP.js";
+import "./chunk-DWX44QL6.js";
+import "./chunk-2FSEESJU.js";
+import "./chunk-CVBKW75S.js";
+import "./chunk-BLAHHMPF.js";
+import "./chunk-DAO63OOP.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-WTJSMYY2.js";
+import "./chunk-XDZVBX6L.js";
+import "./chunk-N5O67GK5.js";
+import "./chunk-EE72SSB2.js";
+import "./chunk-WNSE7N75.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/canvas/rerun.ts
+import { defineCommand } from "citty";
+var rerunCommand = defineCommand({
+  meta: {
+    name: "rerun",
+    hidden: true,
+    description: "Deprecated: use `baker canvas run --slug <slug>`, which does the same."
+  },
+  args: {
+    slug: { type: "positional", required: true, description: "Creative slug (src/creatives/<slug>)" },
+    "force-remote": {
+      type: "boolean",
+      default: false,
+      description: "Overwrite local files whose content differs from the recorded snapshot"
+    },
+    fresh: { type: "boolean", default: false, description: "Start a new run id instead of resuming an interrupted one" },
+    regenerate: { type: "string", description: "Comma-separated node ids to force fresh this run" },
+    concurrency: { type: "string", description: "Max nodes running at once" }
+  },
+  async run({ args }) {
+    process.stderr.write("[deprecated] `baker canvas rerun <slug>` is now `baker canvas run --slug <slug>`.\n");
+    await executeCanvasRun({
+      slug: String(args.slug),
+      forceRemote: args["force-remote"] === true,
+      fresh: args.fresh === true,
+      regenerate: args.regenerate !== void 0 ? String(args.regenerate) : void 0,
+      concurrency: args.concurrency !== void 0 ? String(args.concurrency) : void 0
+    });
+  }
+});
+export {
+  rerunCommand
+};
+//# sourceMappingURL=rerun-4GDNBFNM.js.map

package/dist/research-4YTFPGH7.js

@@ -0,0 +1,262 @@
+import {
+  chatIdFromEnv,
+  failAvatarApi,
+  failValidation
+} from "./chunk-ULPO72IQ.js";
+import {
+  writeAvatars
+} from "./chunk-LCW3U4EA.js";
+import {
+  AVATAR_HANDLE_PATTERN
+} from "./chunk-DAO63OOP.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-WTJSMYY2.js";
+import "./chunk-XDZVBX6L.js";
+import "./chunk-N5O67GK5.js";
+import "./chunk-EE72SSB2.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-WNSE7N75.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/avatars/research.ts
+import { defineCommand } from "citty";
+
+// src/commands/avatars/researchHints.ts
+function described(call) {
+  return call.who ?? [call.name, call.role, call.company].filter(Boolean).join(", ");
+}
+function rerunOf(call) {
+  return [
+    "baker avatars research",
+    call.who ? quoted(call.who) : void 0,
+    call.name ? `--name ${quoted(call.name)}` : void 0,
+    call.role ? `--role ${quoted(call.role)}` : void 0,
+    call.company ? `--company ${quoted(call.company)}` : void 0,
+    call.context ? `--context ${quoted(call.context)}` : void 0,
+    call.site ? `--site ${call.site}` : void 0,
+    call.handle ? `--handle ${call.handle}` : void 0,
+    call.profile ? `--profile ${call.profile}` : void 0
+  ].filter(Boolean).join(" ");
+}
+function quoted(text) {
+  return `"${text.replaceAll('"', '\\"')}"`;
+}
+function possibleHints(data, rerun, create) {
+  const lines = (data.candidates ?? []).map(
+    (candidate) => [candidate.name, candidate.headline, candidate.profile].filter(Boolean).join(" \u2014 ")
+  );
+  const example = data.candidates?.[0]?.profile ?? "<profile url>";
+  return [
+    `Not sure it is them: these profiles matched only in part, so no photo was taken.
+${lines.map((line) => `  - ${line}`).join("\n")}`,
+    `If the copy makes clear which one is the person (same company, same role, what else you know of them), take it: \`${rerun} --profile ${example}${create}\`. If none of them clearly is, treat this as not found \u2014 never put a face in an ad on a guess.`
+  ];
+}
+function notFoundHints(data, rerun, create) {
+  const searched = data.searched.map((query) => `"${query}"`).join(", ");
+  const company = data.query.company;
+  const sites = (data.possibleSites ?? []).map(
+    (site) => `${site} may be ${company ?? "the company"}'s own website (its domain spells part of the name). If it is \u2014 you know it, or a quick look confirms it \u2014 run again on it: \`${rerun} --site ${site}${create}\`. Never name a site that is not theirs.`
+  );
+  return [
+    `No public profile could be tied to this person${searched ? ` (searched ${searched})` : ""}, so no photo was taken. Carry on with an invented one-off person drawn from the description, exactly as for anyone unnamed \u2014 never a photo of somebody else, and never stall the job over it.`,
+    ...sites,
+    'If you know more than was searched, run it again with it: their exact name or company (`--name`, `--company`), the company\'s own website (`--site <domain>`), what else is known of them (`--context "Spanish, banking"`: where they are from or based, their field), or their LinkedIn profile once you have checked it is them (`--profile <url>`).'
+  ];
+}
+function avatarHints(avatar, name) {
+  const where = avatar.reused ? `@${avatar.handle} is already ${name}'s avatar \u2014 reused, not built again.` : `@${avatar.handle} is ${name}'s avatar, built from their real photos. Its sheet settles in about 30s: if the next thing you do needs it, \`baker avatars get ${avatar.handle} --wait\`.`;
+  return [
+    where,
+    `Use it everywhere ${name} appears: \`--avatar ${avatar.handle}\` on static ads, video and Studio renders; on a landing, their photo is the avatar's \`coverUrl\` from \`baker avatars get ${avatar.handle}\` (upscale it when it is shown large). Never invent another face for them.`
+  ];
+}
+function foundHints(data, call, rerun) {
+  const name = data.person?.name ?? described(call);
+  if (data.avatar) return avatarHints(data.avatar, name);
+  const photoIds = (data.photos ?? []).map((photo) => photo.imageId).join(",");
+  if (!photoIds) {
+    return [
+      `Found ${name}, but no usable photo of them was public${call.create ? ", so no avatar was built" : ""}. Carry on with an invented one-off person drawn from the description.`
+    ];
+  }
+  if (call.create) {
+    return [
+      `Found ${name}, but their avatar could not be built automatically. Build it from the photos yourself: \`baker avatars create --name ${quoted(name)} --subject "<one person, plainly: age, build, hair, skin, face>" --source-image ${photoIds} --likeness-confirmed\`.`
+    ];
+  }
+  return [
+    `Found ${name}; their photos are in the image library (${photoIds}). Build their avatar from them: \`${rerun} --create\`.`
+  ];
+}
+function researchHints(data, call) {
+  const rerun = rerunOf(call);
+  if (data.status === "possible") {
+    return possibleHints(data, rerunOf({ ...call, profile: void 0 }), call.create ? " --create" : "");
+  }
+  if (data.status === "not_found") return notFoundHints(data, rerun, call.create ? " --create" : "");
+  return foundHints(data, call, rerun);
+}
+
+// src/commands/avatars/research.ts
+var RESEARCH_TIMEOUT_MS = 18e4;
+registerSchema({
+  command: "avatars.research",
+  description: 'Find a REAL, named person from a description and gather their public photos \u2014 and, with --create, build their avatar from them. Start here: `baker avatars research "Lautaro Suarez, CTO at Vibiz" --create`. Use it whenever copy shows a real person by name: a testimonial author with their role and company, the company\'s founder or CEO, a named team member. Describe them: "<name>, <role> at <company>", or "the CEO of <company>" when the copy names a role, and add what else you know: --site <the company\'s own website> when its domain is not its name spelled out (santander.com for Banco Santander), --context "<where they are from or based, their field>" for someone with no company. Identity is checked in code (the name AND the company \u2014 or, with no company, the role and the context \u2014 must match a public profile): `found` returns their photos (now in the image library) and a subject description; `possible` returns the half-matches to pick from with --profile <their link> (or a LinkedIn you found and checked yourself); `not_found` lists any site that may be the company\'s (possibleSites) and means fall back to an invented one-off person. The company naming them in its copy is the go-ahead to use their likeness \u2014 no confirmation question. A person who already has an avatar comes back with it (`reused: true`) \u2014 nothing searched, nothing billed \u2014 so run it every time copy names someone.',
+  args: {
+    who: {
+      type: "string",
+      description: 'How the copy names them, e.g. "Lautaro Suarez, CTO at Vibiz" or "the CEO of Vibiz"',
+      required: true
+    },
+    name: {
+      type: "string",
+      description: "Their full name, when the description leaves it out or reads it wrong",
+      required: false
+    },
+    role: { type: "string", description: 'Their role, e.g. "CTO", "Founder"', required: false },
+    company: { type: "string", description: "The company they are at", required: false },
+    context: {
+      type: "string",
+      description: 'What else you know of them, in a few words: where they are from or based, their field, e.g. "Spanish, banking". Narrows the search; with no company, name + role + context on one profile is enough to find them',
+      required: false
+    },
+    site: {
+      type: "string",
+      description: "The company's own website, e.g. \"santander.com\" for Banco Santander: its pages are searched for them however the domain spells the name. Use it when the domain is not the company's name spelled out, or when a `not_found` lists it in possibleSites and it is theirs",
+      required: false
+    },
+    profile: {
+      type: "string",
+      description: "The profile to take, by its link: one of the candidates a `possible` answer listed (a LinkedIn, or a public record), or a LinkedIn you found and checked is them (same person, role and company). The name on it must match",
+      required: false
+    },
+    linkedin: { type: "string", description: "Same as --profile", required: false },
+    create: {
+      type: "boolean",
+      description: "Build their avatar from the photos right away (likeness `licensed`, no face picker)",
+      required: false
+    },
+    handle: {
+      type: "string",
+      description: "Mention handle for the avatar --create builds (derived from the name when omitted)",
+      required: false
+    },
+    full: {
+      type: "boolean",
+      description: "Include their about text, location and every search that was run",
+      required: false
+    }
+  }
+});
+function compact(data, full) {
+  if (full) return data;
+  const { searched, person, ...rest } = data;
+  const { about: _about, location: _location, ...who } = person ?? { socials: {} };
+  return {
+    ...rest,
+    ...person ? { person: who } : {},
+    // A `not_found` is only useful with what was tried.
+    ...data.status === "not_found" ? { searched } : {}
+  };
+}
+var researchCommand = defineCommand({
+  meta: {
+    name: "research",
+    description: 'Find a real, named person from a description and build their avatar from their public photos. Example: baker avatars research "Lautaro Suarez, CTO at Vibiz" --create'
+  },
+  args: {
+    who: {
+      type: "positional",
+      description: 'Who: "<name>, <role> at <company>" or "the CEO of <company>"',
+      required: false
+    },
+    name: { type: "string", description: "Their full name (overrides the description)", required: false },
+    role: { type: "string", description: "Their role (overrides the description)", required: false },
+    company: { type: "string", description: "Their company (overrides the description)", required: false },
+    context: {
+      type: "string",
+      description: 'What else you know of them: "Spanish, banking" (where they are from or based, their field)',
+      required: false
+    },
+    site: { type: "string", description: `The company's own website, e.g. "santander.com"`, required: false },
+    profile: {
+      type: "string",
+      description: "The profile to take: a candidate's link from a `possible` answer, or a LinkedIn you checked is them",
+      required: false
+    },
+    linkedin: { type: "string", description: "Same as --profile", required: false },
+    create: { type: "boolean", description: "Build their avatar from the photos", required: false, default: false },
+    handle: { type: "string", description: "Mention handle for the new avatar", required: false },
+    full: {
+      type: "boolean",
+      description: "Include about, location and the searches run",
+      required: false,
+      default: false
+    }
+  },
+  run: async ({ args }) => {
+    const text = (key) => {
+      const value = args[key];
+      return typeof value === "string" && value.trim() ? value.trim() : void 0;
+    };
+    const call = callOf(text, Boolean(args.create));
+    const { who, name, company, handle } = call;
+    if (!who && !name && !company) {
+      failValidation(
+        'Say who to research, e.g. `baker avatars research "Lautaro Suarez, CTO at Vibiz"` or `baker avatars research "the CEO of Vibiz"`.'
+      );
+    }
+    if (handle && !AVATAR_HANDLE_PATTERN.test(handle)) {
+      failValidation(
+        `--handle "${handle}" is not usable. Use lowercase letters, numbers and dashes, starting with a letter \u2014 "lautaro-suarez". Leave it off to have one derived from the name.`
+      );
+    }
+    const chatId = chatIdFromEnv();
+    const { profile: profileUrl, ...asked } = call;
+    const body = {
+      ...asked,
+      ...profileUrl ? { profileUrl } : {},
+      // A backend from before --profile reads a picked LinkedIn only here.
+      ...profileUrl && /linkedin\.com\//i.test(profileUrl) ? { linkedinUrl: profileUrl } : {},
+      ...chatId ? { chatId } : {}
+    };
+    try {
+      const data = await writeAvatars("/api/avatars/research", body, {
+        timeoutMs: RESEARCH_TIMEOUT_MS
+      });
+      writeJson({ ok: true, data: compact(data, Boolean(args.full)), hints: researchHints(data, call) });
+    } catch (err) {
+      failAvatarApi(err, handle);
+    }
+  }
+});
+function callOf(text, create) {
+  const who = text("who");
+  const name = text("name");
+  const role = text("role");
+  const company = text("company");
+  const context = text("context");
+  const site = text("site");
+  const handle = text("handle")?.toLowerCase();
+  const profile = text("profile") ?? text("linkedin");
+  return {
+    ...who ? { who } : {},
+    ...name ? { name } : {},
+    ...role ? { role } : {},
+    ...company ? { company } : {},
+    ...context ? { context } : {},
+    ...site ? { site } : {},
+    ...handle ? { handle } : {},
+    ...profile ? { profile } : {},
+    create
+  };
+}
+export {
+  researchCommand
+};
+//# sourceMappingURL=research-4YTFPGH7.js.map

package/dist/research-LOQRIBO6.js

@@ -0,0 +1,62 @@
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/research/index.ts
+import { defineCommand } from "citty";
+var researchCommand = defineCommand({
+  meta: {
+    name: "research",
+    description: `Competitive intelligence and AI-powered research commands.
+
+Commands:
+  web                \u2014 Search the web with AI (ask any question)
+  fetch              \u2014 Read a page an ordinary web fetch could not
+  reddit             \u2014 Read Reddit verbatim: search posts/comments, read a thread
+  customers          \u2014 Gather real customer words into Knowledge (src/content/insights), verbatim only
+  google-ads         \u2014 A competitor's Google ads and their copy (Ads Transparency Center)
+  advertisers        \u2014 Who's bidding on a keyword?
+  autocomplete       \u2014 Google Autocomplete suggestions
+  intent             \u2014 Google Search intent classification
+  keyword-metrics    \u2014 Volume/CPC/competition for keywords you name (no domain)
+  keywords-for-site  \u2014 Keywords a domain bids on
+  keyword-gap        \u2014 Keywords they have that we don't
+  relevant-pages     \u2014 Top pages of a competitor domain
+  lighthouse         \u2014 Landing page performance audit
+  countries          \u2014 List supported country codes
+  languages          \u2014 List supported language codes
+
+Examples:
+  baker research web "Who are the main competitors of HubSpot?"
+  baker research web "What is the ICP for CRM buyers?" --depth high
+  baker research fetch "https://competitor.com/pricing"
+  baker research reddit search "agency never paid" --subreddit AmazonFlexUK --kind comments
+  baker research customers --focus "payroll app for restaurants"
+  baker research google-ads competitor.com --location es --copy
+  baker research advertisers "running shoes"
+  baker research intent "buy running shoes,best running shoes 2026"
+  baker research keyword-metrics "chatbot whatsapp,crm whatsapp" --location mx --language es
+  baker research keywords-for-site "competitor.com"
+  baker research keyword-gap "them.com" "us.com"
+Full guide: __tooling__/docs/tools/baker/research.md`
+  },
+  subCommands: {
+    web: () => import("./web-FZYOCCYN.js").then((m) => m.webCommand),
+    fetch: () => import("./fetch-O46XBA7S.js").then((m) => m.fetchCommand),
+    "google-ads": () => import("./google-ads-DZMOTUY5.js").then((m) => m.googleAdsCommand),
+    reddit: () => import("./reddit-WJ6KHYBC.js").then((m) => m.redditCommand),
+    customers: () => import("./customers-AOFJJCGD.js").then((m) => m.customersCommand),
+    advertisers: () => import("./advertisers-UDSEFMP7.js").then((m) => m.advertisersCommand),
+    autocomplete: () => import("./autocomplete-AAGTJHVL.js").then((m) => m.autocompleteCommand),
+    countries: () => import("./countries-XGMZWUGP.js").then((m) => m.countriesCommand),
+    intent: () => import("./intent-4KJGYYHL.js").then((m) => m.intentCommand),
+    "keyword-metrics": () => import("./keyword-metrics-26CCKFZK.js").then((m) => m.keywordMetricsCommand),
+    "keywords-for-site": () => import("./keywords-for-site-JWWECF63.js").then((m) => m.keywordsForSiteCommand),
+    "keyword-gap": () => import("./keyword-gap-U64KXDR4.js").then((m) => m.keywordGapCommand),
+    languages: () => import("./languages-3IJVDS5Z.js").then((m) => m.languagesCommand),
+    lighthouse: () => import("./lighthouse-FALRSVQH.js").then((m) => m.lighthouseCommand),
+    "relevant-pages": () => import("./relevant-pages-VXSHEOU2.js").then((m) => m.relevantPagesCommand)
+  }
+});
+export {
+  researchCommand
+};
+//# sourceMappingURL=research-LOQRIBO6.js.map

package/dist/reset-55CCQGXB.js

@@ -0,0 +1,54 @@
+import {
+  reportError,
+  reportInvalid
+} from "./chunk-GDLQ6SGW.js";
+import {
+  testimonialSourcesResetRequestSchema
+} from "./chunk-DAO63OOP.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-WTJSMYY2.js";
+import {
+  apiPost
+} from "./chunk-XDZVBX6L.js";
+import "./chunk-N5O67GK5.js";
+import "./chunk-EE72SSB2.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-WNSE7N75.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/testimonials/sources/reset.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "testimonials.sources.reset",
+  description: "Unstick a review source whose import failed or has not moved for an hour, so it can be imported again. Refused while an import is still running. Keeps its reviews.",
+  args: { id: { type: "string", description: "Source id from `testimonials sources list`", required: true } }
+});
+var resetCommand = defineCommand({
+  meta: {
+    name: "reset",
+    description: "Unstick a review source whose import failed or has not moved for an hour, so it can be imported again. Refused while an import is still running. Keeps its reviews.\n\nExample: baker testimonials sources reset <source-id>"
+  },
+  args: { id: { type: "positional", description: "Source id from `testimonials sources list`", required: true } },
+  run: async ({ args }) => {
+    const parsed = testimonialSourcesResetRequestSchema.safeParse({ id: String(args.id ?? "") });
+    if (!parsed.success) reportInvalid(parsed.error.issues[0]);
+    try {
+      const data = await apiPost("/api/testimonials/sources/reset", parsed.data);
+      writeJson({
+        ok: true,
+        data,
+        hints: [`Run \`baker testimonials sources sync ${data.id}\` to import its reviews again.`]
+      });
+    } catch (err) {
+      reportError(err);
+    }
+  }
+});
+export {
+  resetCommand
+};
+//# sourceMappingURL=reset-55CCQGXB.js.map

package/dist/reset-AVTQEJPZ.js

@@ -0,0 +1,54 @@
+import {
+  reportError
+} from "./chunk-XGOEX2VJ.js";
+import {
+  mediaSourcesResetRequestSchema
+} from "./chunk-DAO63OOP.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-WTJSMYY2.js";
+import {
+  apiPost
+} from "./chunk-XDZVBX6L.js";
+import "./chunk-N5O67GK5.js";
+import "./chunk-EE72SSB2.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-WNSE7N75.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/media-sources/reset.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "media-sources.reset",
+  description: "Unstick a connected source whose import failed, or has not moved for an hour, so it can import again. Keeps what it already imported. Refused while an import is still moving.",
+  args: {
+    key: { type: "string", description: "Source key from `media-sources list`, e.g. tiktok:acme", required: true }
+  }
+});
+var resetCommand = defineCommand({
+  meta: {
+    name: "reset",
+    description: "Unstick a source whose import failed or has not moved for an hour, so it can import again. Keeps what it already imported; refused while an import is still moving.\n\nExample: baker media-sources reset tiktok:acme"
+  },
+  args: { key: { type: "positional", description: "Source key, e.g. tiktok:acme", required: true } },
+  run: async ({ args }) => {
+    const parsed = mediaSourcesResetRequestSchema.safeParse({ key: String(args.key ?? "") });
+    if (!parsed.success) {
+      writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: parsed.error.issues[0]?.message ?? "" } });
+      process.exit(1);
+    }
+    try {
+      const data = await apiPost("/api/media-sources/reset", parsed.data);
+      writeJson({ ok: true, data, hints: [`Run \`baker media-sources sync ${data.key}\` to import its new posts.`] });
+    } catch (err) {
+      reportError(err);
+    }
+  }
+});
+export {
+  resetCommand
+};
+//# sourceMappingURL=reset-AVTQEJPZ.js.map

package/dist/resolve-E6FNMFE3.js

@@ -0,0 +1,121 @@
+import {
+  csvOrJson,
+  handleLinkedinError
+} from "./chunk-TTHM66TA.js";
+import {
+  writeAdsJson,
+  writeAdsOutput,
+  writeJsonEnvelope
+} from "./chunk-SWL4AAPP.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-K3TNTBZJ.js";
+import "./chunk-DAO63OOP.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-WTJSMYY2.js";
+import {
+  apiPost
+} from "./chunk-XDZVBX6L.js";
+import "./chunk-N5O67GK5.js";
+import "./chunk-EE72SSB2.js";
+import "./chunk-WNSE7N75.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/linkedin/resolve.ts
+import { defineCommand } from "citty";
+function domainHints(resolution) {
+  const hints = [];
+  if (resolution.errors.length > 0) {
+    hints.push(
+      `LinkedIn has no organization for ${resolution.errors.map((e) => e.id).join(", ")} \u2014 skip them or check the ids.`
+    );
+  }
+  if (resolution.orgs.some((o) => o.domainSource === "subdomain")) {
+    hints.push("domainSource=subdomain (e.g. news.microsoft.com \u2192 microsoft.com) is a weaker match \u2014 confirm it.");
+  }
+  if (resolution.orgs.some((o) => o.domainSource === "none")) {
+    hints.push("domainSource=none: no usable website (shortlink or missing) \u2014 match those by vanityName or name.");
+  }
+  return hints;
+}
+function toOrgUrn(raw) {
+  const trimmed = raw.trim();
+  if (trimmed.length === 0) {
+    return null;
+  }
+  if (trimmed.startsWith("urn:li:")) {
+    return trimmed;
+  }
+  return /^\d+$/.test(trimmed) ? `urn:li:organization:${trimmed}` : null;
+}
+var resolveCommand = defineCommand({
+  meta: {
+    name: "resolve",
+    description: `Resolve organization URNs to company names.
+
+Examples:
+  baker ads linkedin resolve --urns urn:li:organization:17719,urn:li:organization:19022
+  baker ads linkedin resolve --ids 17719,19022 --output csv
+  baker ads linkedin resolve --ids 1035,1337 --with-domains   # + website domain per org, for CRM matching
+
+Accepts --urns (full URNs) and/or --ids (bare numeric ids). Rows with no name
+couldn't be resolved \u2014 typically an org outside LinkedIn's targetable set.
+
+--with-domains returns {orgs, errors}: per org name, vanityName (LinkedIn page),
+website and domain (registrable, e.g. microsoft.com) with domainSource
+website | subdomain (weaker) | none (shortlink / no website). Ids LinkedIn
+doesn't know land in errors; the rest still resolve. Cached 7 days.`
+  },
+  args: {
+    urns: { type: "string", description: "Comma-separated org URNs (urn:li:organization:NNN)" },
+    ids: { type: "string", description: "Comma-separated bare org ids (17719,19022)" },
+    "with-domains": {
+      type: "boolean",
+      description: "Return vanityName, website, domain and domainSource per org (+ errors for unknown ids)"
+    },
+    "no-cache": NO_CACHE_ARG,
+    output: { type: "string", description: "json|csv|jsonl|md", default: "json" }
+  },
+  run: async ({ args }) => {
+    const raw = [args.urns, args.ids].filter(Boolean).join(",").split(",");
+    const urns = [...new Set(raw.map(toOrgUrn).filter((u) => u !== null))];
+    if (urns.length === 0) {
+      handleLinkedinError(new Error("Provide --urns or --ids (org URNs or bare numeric ids)."));
+    }
+    try {
+      if (args["with-domains"]) {
+        const resolution = await apiPost("/api/ads/linkedin/resolve-orgs", {
+          urns,
+          withDomains: true,
+          skipCache: Boolean(args["no-cache"])
+        });
+        const hints = domainHints(resolution);
+        const fmt2 = csvOrJson(args);
+        if (fmt2 !== "json") {
+          writeAdsOutput(resolution.orgs, fmt2, void 0, hints);
+          return;
+        }
+        writeJsonEnvelope(hints.length > 0 ? { ok: true, data: resolution, hints } : { ok: true, data: resolution });
+        return;
+      }
+      const data = await apiPost("/api/ads/linkedin/resolve-orgs", {
+        urns,
+        skipCache: Boolean(args["no-cache"])
+      });
+      const fmt = csvOrJson(args);
+      if (fmt !== "json") {
+        writeAdsOutput(data, fmt);
+        return;
+      }
+      writeAdsJson({ ok: true, data });
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+export {
+  resolveCommand
+};
+//# sourceMappingURL=resolve-E6FNMFE3.js.map