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

package/dist/check-ZSQ4EIFB.js

@@ -0,0 +1,154 @@
+import {
+  landingCopy,
+  readLandingSources
+} from "./chunk-TXJOYQE2.js";
+import {
+  readAdWords,
+  ruleRefusal
+} from "./chunk-HDMD6LXS.js";
+import "./chunk-QMQSI4WA.js";
+import "./chunk-OFMFBRSL.js";
+import {
+  readAllRules
+} from "./chunk-IKADYUXK.js";
+import {
+  ruleTells
+} from "./chunk-46DHUWMV.js";
+import "./chunk-Z3ENMCFE.js";
+import "./chunk-ESSA3AWR.js";
+import "./chunk-TQJLEVLA.js";
+import "./chunk-MX5NQAK6.js";
+import "./chunk-Y5PNLB24.js";
+import {
+  findWorkspaceRoot
+} from "./chunk-N3PASNUA.js";
+import "./chunk-KJ3J2DYM.js";
+import {
+  landingRules,
+  selectRules
+} from "./chunk-MTFAG6E3.js";
+import "./chunk-F3CZFUXZ.js";
+import {
+  marketFromCompanyDoc
+} from "./chunk-2WZI36D3.js";
+import "./chunk-65Y3RCWP.js";
+import "./chunk-E56V3RFO.js";
+import "./chunk-EL3TDR5S.js";
+import "./chunk-G6U45QD3.js";
+import "./chunk-X6U3B6YK.js";
+import "./chunk-YOHGEF2N.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 "./chunk-QEREDRZO.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/creatives/check.ts
+import { readdir, readFile } from "fs/promises";
+import path from "path";
+import { defineCommand } from "citty";
+var DESCRIPTION = `Read every creative already made, or every landing, against the company's rules as they stand now: which ads or pages say words a rule bans, or leave out words a rule requires. Run it after adding a rule (\`baker creatives rules add\`); nothing is re-rendered or marked stale, so ask the person which to correct.
+Start here: baker creatives check
+  baker creatives check --slug mba-ia-online   # one creative
+  baker creatives check --for landings         # every page in src/pages/, against the rules for landings`;
+var ARGS = {
+  for: {
+    type: "string",
+    description: "ads | landings: what to read (default ads)",
+    required: false
+  },
+  slug: {
+    type: "string",
+    description: "One creative (src/creatives/<slug>/), or with --for landings one page; left out, every one",
+    required: false
+  }
+};
+registerSchema({ command: "creatives.check", description: DESCRIPTION, args: ARGS });
+function checkCreatives(ads, rules, companyLanguage) {
+  const breaking = ads.flatMap(({ slug, ad }) => {
+    const held = selectRules(
+      rules,
+      {
+        kind: ad.kind,
+        ...ad.product ? { product: ad.product } : {},
+        ...ad.platform ? { platform: ad.platform } : {},
+        ...ad.platforms ? { platforms: ad.platforms } : {}
+      },
+      ad.waived
+    );
+    const refusal = ruleRefusal(ruleTells(ad.lines, held, ad.language ?? companyLanguage));
+    return refusal ? [{ creative: slug, broken: refusal.problems }] : [];
+  });
+  return { checked: ads.length, breaking };
+}
+function checkLandings(pages, rules, language) {
+  const held = landingRules(rules);
+  const breaking = pages.flatMap(({ slug, lines }) => {
+    const refusal = ruleRefusal(ruleTells(lines, held, language));
+    return refusal ? [{ landing: slug, broken: refusal.problems }] : [];
+  });
+  return { checked: pages.length, breaking };
+}
+async function readLandings(root, slug) {
+  const slugs = slug ? [slug] : (await readdir(path.join(root, "src", "pages"), { withFileTypes: true }).catch(() => [])).filter((e) => e.isDirectory() && !e.name.startsWith("_") && !e.name.startsWith(".")).map((e) => e.name).sort();
+  return Promise.all(
+    slugs.map(async (s) => {
+      const sources = await readLandingSources(root, s).catch(() => []);
+      return { slug: s, lines: landingCopy(sources).sentences.map((c) => c.text) };
+    })
+  );
+}
+async function readAds(root, slug) {
+  const dir = path.join(root, "src", "creatives");
+  const slugs = slug ? [slug] : (await readdir(dir, { withFileTypes: true }).catch(() => [])).filter((e) => e.isDirectory() && !e.name.startsWith("_")).map((e) => e.name).sort();
+  const ads = await Promise.all(slugs.map(async (s) => ({ slug: s, ad: await readAdWords(path.join(dir, s)) })));
+  return ads.flatMap(({ slug: s, ad }) => ad ? [{ slug: s, ad }] : []);
+}
+var checkCommand = defineCommand({
+  meta: { name: "check", description: DESCRIPTION },
+  args: ARGS,
+  async run({ args }) {
+    const root = findWorkspaceRoot(process.cwd()) ?? process.cwd();
+    const slug = typeof args.slug === "string" && args.slug ? args.slug : void 0;
+    const [rules, companyDoc] = await Promise.all([
+      readAllRules(root),
+      readFile(path.join(root, "COMPANY.md"), "utf8").catch(() => null)
+    ]);
+    const language = marketFromCompanyDoc(companyDoc)?.language;
+    if (args.for === "landings") {
+      const landings = checkLandings(await readLandings(root, slug), rules, language);
+      writeJson({
+        ok: true,
+        data: landings,
+        hints: landings.breaking.length > 0 ? [
+          `${landings.breaking.length} of ${landings.checked} landings break a rule now in force. Tell the person which, and correct only the ones they want, in that page's own files.`
+        ] : [`None of the ${landings.checked} landings breaks a wording rule now in force.`]
+      });
+      return;
+    }
+    const report = checkCreatives(await readAds(root, slug), rules, language);
+    writeJson({
+      ok: true,
+      data: report,
+      hints: report.breaking.length > 0 ? [
+        `${report.breaking.length} of ${report.checked} ads break a rule now in force. Tell the person which, and correct only the ones they want: edit the words in that ad's prompt.json and run it again, or waive the rule there if the person asked for those words.`
+      ] : [`None of the ${report.checked} ads breaks a wording rule now in force.`]
+    });
+  }
+});
+export {
+  checkCommand,
+  checkCreatives,
+  checkLandings
+};
+//# sourceMappingURL=check-ZSQ4EIFB.js.map

package/dist/check-ZSQ4EIFB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/creatives/check.ts"],"sourcesContent":["/**\n * `baker creatives check`: the ads already made, or the landings (`--for landings`), read against\n * the company's rules as they stand now. After a rule is added it says which existing ads or pages\n * break it, deterministically (the words a rule bans or requires), so nothing is marked stale and\n * nothing re-renders: the person decides which to correct.\n */\nimport { readdir, readFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { defineCommand } from \"citty\";\nimport { ruleTells } from \"../../engine/copy-tells/rule-tells.ts\";\nimport { type AdWords, readAdWords } from \"../../engine/creative-context/ad-words.ts\";\nimport { readAllRules } from \"../../engine/creative-context/index.ts\";\nimport type { CreativeRule } from \"../../engine/creative-rules/schema.ts\";\nimport { landingRules, selectRules } from \"../../engine/creative-rules/select.ts\";\nimport { landingCopy } from \"../../engine/landing/lib/rules.ts\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { marketFromCompanyDoc } from \"../../viewer-profile.ts\";\nimport { findWorkspaceRoot } from \"../canvas/normalize-paths.ts\";\nimport { ruleRefusal } from \"../canvas/rule-gate.ts\";\nimport { readLandingSources } from \"../landing/source-version.ts\";\n\nconst DESCRIPTION = `Read every creative already made, or every landing, against the company's rules as they stand now: which ads or pages say words a rule bans, or leave out words a rule requires. Run it after adding a rule (\\`baker creatives rules add\\`); nothing is re-rendered or marked stale, so ask the person which to correct.\nStart here: baker creatives check\n  baker creatives check --slug mba-ia-online   # one creative\n  baker creatives check --for landings         # every page in src/pages/, against the rules for landings`;\n\nconst ARGS = {\n  for: {\n    type: \"string\",\n    description: \"ads | landings: what to read (default ads)\",\n    required: false,\n  },\n  slug: {\n    type: \"string\",\n    description: \"One creative (src/creatives/<slug>/), or with --for landings one page; left out, every one\",\n    required: false,\n  },\n} as const;\n\nregisterSchema({ command: \"creatives.check\", description: DESCRIPTION, args: ARGS });\n\nexport type CheckReport = { checked: number; breaking: Array<{ creative: string; broken: string[] }> };\n\n/** Each ad that breaks a rule holding for it, with what it breaks. Pure. */\nexport function checkCreatives(\n  ads: ReadonlyArray<{ slug: string; ad: AdWords }>,\n  rules: readonly CreativeRule[],\n  companyLanguage: string | undefined,\n): CheckReport {\n  const breaking = ads.flatMap(({ slug, ad }) => {\n    const held = selectRules(\n      rules,\n      {\n        kind: ad.kind,\n        ...(ad.product ? { product: ad.product } : {}),\n        ...(ad.platform ? { platform: ad.platform } : {}),\n        ...(ad.platforms ? { platforms: ad.platforms } : {}),\n      },\n      ad.waived,\n    );\n    const refusal = ruleRefusal(ruleTells(ad.lines, held, ad.language ?? companyLanguage));\n    return refusal ? [{ creative: slug, broken: refusal.problems }] : [];\n  });\n  return { checked: ads.length, breaking };\n}\n\nexport type LandingCheckReport = { checked: number; breaking: Array<{ landing: string; broken: string[] }> };\n\n/** Each landing whose words break a rule for landings, with what it breaks. Pure. */\nexport function checkLandings(\n  pages: ReadonlyArray<{ slug: string; lines: readonly string[] }>,\n  rules: readonly CreativeRule[],\n  language: string | undefined,\n): LandingCheckReport {\n  const held = landingRules(rules);\n  const breaking = pages.flatMap(({ slug, lines }) => {\n    const refusal = ruleRefusal(ruleTells(lines, held, language));\n    return refusal ? [{ landing: slug, broken: refusal.problems }] : [];\n  });\n  return { checked: pages.length, breaking };\n}\n\n/** Every landing's visible words (`src/pages/<slug>/` and what it renders), or the one named. */\nasync function readLandings(root: string, slug?: string): Promise<Array<{ slug: string; lines: string[] }>> {\n  const slugs = slug\n    ? [slug]\n    : (await readdir(path.join(root, \"src\", \"pages\"), { withFileTypes: true }).catch(() => []))\n        .filter((e) => e.isDirectory() && !e.name.startsWith(\"_\") && !e.name.startsWith(\".\"))\n        .map((e) => e.name)\n        .sort();\n  return Promise.all(\n    slugs.map(async (s) => {\n      const sources = await readLandingSources(root, s).catch(() => []);\n      return { slug: s, lines: landingCopy(sources).sentences.map((c) => c.text) };\n    }),\n  );\n}\n\n/** Every creative folder's words, or the one named. */\nasync function readAds(root: string, slug?: string): Promise<Array<{ slug: string; ad: AdWords }>> {\n  const dir = path.join(root, \"src\", \"creatives\");\n  const slugs = slug\n    ? [slug]\n    : (await readdir(dir, { withFileTypes: true }).catch(() => []))\n        .filter((e) => e.isDirectory() && !e.name.startsWith(\"_\"))\n        .map((e) => e.name)\n        .sort();\n  const ads = await Promise.all(slugs.map(async (s) => ({ slug: s, ad: await readAdWords(path.join(dir, s)) })));\n  return ads.flatMap(({ slug: s, ad }) => (ad ? [{ slug: s, ad }] : []));\n}\n\nexport const checkCommand = defineCommand({\n  meta: { name: \"check\", description: DESCRIPTION },\n  args: ARGS,\n  async run({ args }) {\n    const root = findWorkspaceRoot(process.cwd()) ?? process.cwd();\n    const slug = typeof args.slug === \"string\" && args.slug ? args.slug : undefined;\n    const [rules, companyDoc] = await Promise.all([\n      readAllRules(root),\n      readFile(path.join(root, \"COMPANY.md\"), \"utf8\").catch(() => null),\n    ]);\n    const language = marketFromCompanyDoc(companyDoc)?.language;\n    if (args.for === \"landings\") {\n      const landings = checkLandings(await readLandings(root, slug), rules, language);\n      writeJson({\n        ok: true,\n        data: landings,\n        hints:\n          landings.breaking.length > 0\n            ? [\n                `${landings.breaking.length} of ${landings.checked} landings break a rule now in force. Tell the person which, and correct only the ones they want, in that page's own files.`,\n              ]\n            : [`None of the ${landings.checked} landings breaks a wording rule now in force.`],\n      });\n      return;\n    }\n    const report = checkCreatives(await readAds(root, slug), rules, language);\n    writeJson({\n      ok: true,\n      data: report,\n      hints:\n        report.breaking.length > 0\n          ? [\n              `${report.breaking.length} of ${report.checked} ads break a rule now in force. Tell the person which, and correct only the ones they want: edit the words in that ad's prompt.json and run it again, or waive the rule there if the person asked for those words.`,\n            ]\n          : [`None of the ${report.checked} ads breaks a wording rule now in force.`],\n    });\n  },\n});\n"],"mappings":"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","names":[]}

package/dist/chunk-34ARMQNL.js

@@ -0,0 +1,197 @@
+import {
+  mediaTagsCreateRequestSchema,
+  mediaTagsDeleteRequestSchema,
+  mediaTagsUpdateRequestSchema
+} from "./chunk-YOHGEF2N.js";
+import {
+  ApiError,
+  apiGet,
+  apiPost
+} from "./chunk-QEREDRZO.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-CCYZJMZ7.js";
+
+// src/lib/tags-command.ts
+import { defineCommand } from "citty";
+var OUTPUT_ARG = {
+  output: { type: "string", description: "Output format: md|json", required: false, default: "md" }
+};
+var SHARED_POOL_HINT = "Custom tags are one pool shared by images, videos and testimonials \u2014 this change shows up in all three. Already applied: publishing or discarding this chat does not undo it.";
+function fail(err) {
+  const code = err instanceof ApiError ? err.code : "INTERNAL_ERROR";
+  const message = err instanceof ApiError ? err.message : "Unexpected error";
+  writeJson({ ok: false, error: { code, message } });
+  process.exit(1);
+}
+function failInvalid(issue) {
+  writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: issue?.message ?? "Invalid request" } });
+  process.exit(1);
+}
+function makeTagsCommand(command, label, endpoint) {
+  registerSchema({
+    command: `${command}.tags.list`,
+    description: `List the available ${label} tag taxonomy (built-in defaults + this company's custom tags).`,
+    args: OUTPUT_ARG
+  });
+  const listCommand = defineCommand({
+    meta: {
+      name: "list",
+      description: `List the available ${label} tag names (defaults + company custom tags). Use before filtering with --tags. Example: baker ${command} tags`
+    },
+    args: OUTPUT_ARG,
+    run: async ({ args }) => {
+      try {
+        const { markdown } = await apiGet(endpoint);
+        if (args.output === "json") {
+          writeJson({ ok: true, data: { markdown } });
+          return;
+        }
+        process.stdout.write(`${markdown.trimEnd()}
+`);
+      } catch (err) {
+        const code = err instanceof ApiError ? err.code : "INTERNAL_ERROR";
+        const message = err instanceof ApiError ? err.message : "Unexpected error";
+        if (args.output === "json") {
+          writeJson({ ok: false, error: { code, message } });
+        } else {
+          process.stderr.write(`Error: ${message}
+`);
+        }
+        process.exit(1);
+      }
+    }
+  });
+  const createArgs = {
+    name: { type: "positional", description: "Tag name (stored lowercased, spaces \u2192 hyphens)", required: true },
+    description: {
+      type: "string",
+      description: "What the tag means, so it gets applied consistently",
+      required: false
+    }
+  };
+  registerSchema({
+    command: `${command}.tags.create`,
+    description: "Create a custom media tag in the company's shared pool (images, videos and testimonials). Applies immediately. Use when no built-in or custom tag fits.",
+    args: {
+      name: { type: "string", description: "Tag name (stored lowercased, spaces \u2192 hyphens)", required: true },
+      description: createArgs.description
+    }
+  });
+  const createCommand = defineCommand({
+    meta: {
+      name: "create",
+      description: `Create a custom tag (shared by images, videos and testimonials). Applies immediately.
+
+Example: baker ${command} tags create "summer sale" --description "Assets for the summer sale campaign"`
+    },
+    args: createArgs,
+    run: async ({ args }) => {
+      const parsed = mediaTagsCreateRequestSchema.safeParse({
+        name: String(args.name ?? ""),
+        ...args.description ? { description: String(args.description) } : {}
+      });
+      if (!parsed.success) failInvalid(parsed.error.issues[0]);
+      try {
+        const data = await apiPost("/api/media-tags/create", parsed.data);
+        writeJson({
+          ok: true,
+          data,
+          hints: [
+            SHARED_POOL_HINT,
+            `Use it as \`--tags ${data.name}\`.`,
+            ...data.description ? [] : ["MISSING --description: add one with `tags update` so the tag is applied consistently."]
+          ]
+        });
+      } catch (err) {
+        fail(err);
+      }
+    }
+  });
+  registerSchema({
+    command: `${command}.tags.update`,
+    description: "Change what a custom tag means (its description). Built-in tags cannot be changed. Applies immediately.",
+    args: {
+      slug: { type: "string", description: "Custom tag name, as `tags` lists it", required: true },
+      description: { type: "string", description: "New description", required: true }
+    }
+  });
+  const updateCommand = defineCommand({
+    meta: {
+      name: "update",
+      description: `Change a custom tag's description. Built-in tags cannot be changed. Applies immediately.
+
+Example: baker ${command} tags update summer-sale --description "Assets for the 2026 summer sale"`
+    },
+    args: {
+      slug: { type: "positional", description: "Custom tag name, as `tags` lists it", required: true },
+      description: { type: "string", description: "New description", required: true }
+    },
+    run: async ({ args }) => {
+      const parsed = mediaTagsUpdateRequestSchema.safeParse({
+        slug: String(args.slug ?? ""),
+        description: String(args.description ?? "")
+      });
+      if (!parsed.success) failInvalid(parsed.error.issues[0]);
+      try {
+        const data = await apiPost("/api/media-tags/update", parsed.data);
+        writeJson({ ok: true, data, hints: [SHARED_POOL_HINT] });
+      } catch (err) {
+        fail(err);
+      }
+    }
+  });
+  registerSchema({
+    command: `${command}.tags.delete`,
+    description: "Delete a custom tag from the company's shared pool. Built-in tags cannot be deleted. Applies immediately. Confirm with the user first.",
+    args: { slug: { type: "string", description: "Custom tag name, as `tags` lists it", required: true } }
+  });
+  const deleteCommand = defineCommand({
+    meta: {
+      name: "delete",
+      description: `Delete a custom tag (shared by images, videos and testimonials). Built-in tags cannot be deleted. Applies immediately \u2014 confirm with the user first.
+
+Example: baker ${command} tags delete summer-sale`
+    },
+    args: { slug: { type: "positional", description: "Custom tag name, as `tags` lists it", required: true } },
+    run: async ({ args }) => {
+      const parsed = mediaTagsDeleteRequestSchema.safeParse({ slug: String(args.slug ?? "") });
+      if (!parsed.success) failInvalid(parsed.error.issues[0]);
+      try {
+        const data = await apiPost("/api/media-tags/delete", parsed.data);
+        writeJson({ ok: true, data, hints: [SHARED_POOL_HINT] });
+      } catch (err) {
+        fail(err);
+      }
+    }
+  });
+  return defineCommand({
+    meta: {
+      name: "tags",
+      description: `The ${label} tag taxonomy: built-in defaults plus the company's custom tags (one pool shared by images, videos and testimonials). Subcommands: list (default), create, update, delete.
+
+Examples:
+  baker ${command} tags                                   # list available tags
+  baker ${command} tags create "summer sale" --description "\u2026"
+  baker ${command} tags update summer-sale --description "\u2026"
+  baker ${command} tags delete summer-sale`
+    },
+    // Declared on the parent too: `default: "list"` dispatches the bare `tags --output json`
+    // form, and citty reads an undeclared flag's value as a subcommand name.
+    args: OUTPUT_ARG,
+    subCommands: {
+      list: listCommand,
+      create: createCommand,
+      update: updateCommand,
+      delete: deleteCommand
+    },
+    // `default`, never `run`: citty falls through to the parent's `run` after a subcommand.
+    default: "list"
+  });
+}
+
+export {
+  makeTagsCommand
+};
+//# sourceMappingURL=chunk-34ARMQNL.js.map

package/dist/chunk-34MZGC2Y.js

@@ -0,0 +1,207 @@
+import {
+  handleConnectionError,
+  needsConnectionFix,
+  writeAdsJson
+} from "./chunk-MK4HCMEA.js";
+import {
+  LINKEDIN_SEARCH_STATUSES,
+  unsupportedLinkedinSearchStatuses
+} from "./chunk-YOHGEF2N.js";
+import {
+  ApiError
+} from "./chunk-QEREDRZO.js";
+import {
+  MissingChatIdError,
+  getEnv
+} from "./chunk-45D6WRCJ.js";
+
+// src/commands/ads/linkedin/shared.ts
+import { readFileSync } from "fs";
+var DAY_MS = 864e5;
+function handleLinkedinError(err) {
+  if (err instanceof ApiError) {
+    if (needsConnectionFix(err.code, err.message)) {
+      handleConnectionError("linkedin_ads", err.message);
+    }
+    if (isNoAccountsSelectedError(err.code, err.message)) {
+      handleConnectionError("linkedin_ads", err.message);
+    }
+    const explanation = explainLinkedinError(err);
+    const envelope = {
+      ok: false,
+      error: {
+        code: err.code,
+        message: err.message,
+        fix: {
+          action: explanation.action,
+          explanation: explanation.message,
+          correctedCommand: explanation.correctedCommand
+        },
+        retryable: err.code === "RATE_LIMITED" || err.code === "UNAVAILABLE" || err.code === "INTERNAL_ERROR"
+      }
+    };
+    writeAdsJson(envelope);
+    process.exit(1);
+  }
+  writeAdsJson(unexpectedErrorEnvelope(err));
+  process.exit(1);
+}
+function unexpectedErrorEnvelope(err) {
+  if (err instanceof MissingChatIdError) {
+    return {
+      ok: false,
+      error: {
+        code: err.code,
+        message: err.message,
+        fix: {
+          action: "reject",
+          explanation: "LinkedIn changes are staged in a chat and this run has none. Don't retry: carry on with the rest of the job and tell the user this change couldn't be staged from here."
+        },
+        retryable: false
+      }
+    };
+  }
+  const message = err instanceof Error ? err.message : "Unexpected error";
+  return { ok: false, error: { code: "NETWORK_ERROR", message } };
+}
+function isNoAccountsSelectedError(code, message) {
+  return code === "VALIDATION_ERROR" && /no linkedin ad accounts selected/i.test(message);
+}
+function explainLinkedinError(err) {
+  const lower = err.message.toLowerCase();
+  if (err.code === "VALIDATION_ERROR" && lower.includes("granularity") && lower.includes("daily")) {
+    return {
+      action: "retry_with_flag",
+      message: "LinkedIn rejects DAILY granularity when pivoting on demographic dims (job-title, company, etc.). Re-run with --granularity ALL or MONTHLY.",
+      correctedCommand: void 0
+    };
+  }
+  if (err.code === "RATE_LIMITED") {
+    return {
+      action: "wait_and_retry",
+      message: "LinkedIn asked Baker to wait. A short wait is already sat out for you, so this one is long \u2014 up to LinkedIn's daily limit, which resets at midnight UTC. Don't retry in a loop: carry on with the rest of the job without this LinkedIn data, and tell the user it can be read again later."
+    };
+  }
+  if (err.code === "INTERNAL_ERROR" && lower.includes("deprecat")) {
+    return {
+      action: "reject",
+      message: "LinkedIn-Version header is deprecated. The backend constant LINKEDIN_API_VERSION needs to be bumped \u2014 file an issue or update the constant."
+    };
+  }
+  return { action: "reject", message: err.message };
+}
+var LI_ACCOUNT_ID_RE = /^(urn:li:sponsoredAccount:)?\d+$/;
+function resolveAccountIdArg(args) {
+  const fromArgs = args["account-id"] ?? args["account-urn"];
+  const id = fromArgs || getEnv().BAKER_LINKEDIN_AD_ACCOUNT_ID;
+  if (!id) {
+    writeAdsJson({
+      ok: false,
+      error: {
+        code: "MISSING_ACCOUNT_ID",
+        message: "Pass --account-id (numeric) or --account-urn (urn:li:sponsoredAccount:N), or set BAKER_LINKEDIN_AD_ACCOUNT_ID. Run `baker ads linkedin accounts` to find IDs."
+      }
+    });
+    process.exit(1);
+  }
+  if (!LI_ACCOUNT_ID_RE.test(id)) {
+    writeAdsJson({
+      ok: false,
+      error: {
+        code: "INVALID_ACCOUNT_ID",
+        message: `Invalid LinkedIn account ID "${id}". Expected numeric or urn:li:sponsoredAccount:N.`
+      }
+    });
+    process.exit(1);
+  }
+  return id.startsWith("urn:") ? id.split(":").pop() ?? id : id;
+}
+function todayIso() {
+  return (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+}
+function daysAgoIso(days) {
+  return new Date(Date.now() - days * DAY_MS).toISOString().slice(0, 10);
+}
+function csvOrJson(args) {
+  return args.output ?? "json";
+}
+function statusesArgDescription(level) {
+  return `CSV of statuses (${LINKEDIN_SEARCH_STATUSES[level].join(",")})`;
+}
+function statusFilterError(level, statuses) {
+  const unsupported = unsupportedLinkedinSearchStatuses(level, statuses);
+  if (unsupported.length === 0) {
+    return null;
+  }
+  const accepted = LINKEDIN_SEARCH_STATUSES[level].join(",");
+  return {
+    ok: false,
+    error: {
+      code: "INVALID_STATUS",
+      message: `LinkedIn does not accept status ${unsupported.join(", ")} for this listing.`,
+      fix: {
+        action: "retry_with_flag",
+        explanation: `Re-run with --statuses from ${accepted}, or --all-statuses to drop the filter.`
+      },
+      retryable: false
+    }
+  };
+}
+function resolveStatusFilter(args, level) {
+  if (args["all-statuses"]) {
+    return void 0;
+  }
+  const explicit = args.statuses;
+  if (!explicit) {
+    return ["ACTIVE"];
+  }
+  const statuses = explicit.split(",").map((s) => s.trim().toUpperCase()).filter(Boolean);
+  const error = statusFilterError(level, statuses);
+  if (error) {
+    writeAdsJson(error);
+    process.exit(1);
+  }
+  return statuses;
+}
+function loadTargetingArg(args) {
+  const inline = args.targeting;
+  if (inline) {
+    try {
+      return JSON.parse(inline);
+    } catch {
+      handleLinkedinError(new Error("--targeting must be valid JSON. See LinkedIn 'targetingCriteria' shape."));
+    }
+  }
+  const file = args["targeting-file"];
+  if (file) {
+    try {
+      return JSON.parse(readFileSync(file, "utf-8"));
+    } catch (e) {
+      handleLinkedinError(
+        new Error(`Failed to read --targeting-file: ${e instanceof Error ? e.message : "I/O error"}`)
+      );
+    }
+  }
+  handleLinkedinError(new Error("Pass --targeting-file <path> or --targeting '{...JSON...}'"));
+}
+function exitOnInvalidArgs(issues, flagByField) {
+  const messages = issues.map((issue) => {
+    const field = String(issue.path[0] ?? "");
+    return `${flagByField[field] ?? (field || "args")}: ${issue.message}`;
+  });
+  writeAdsJson({ ok: false, error: { code: "INVALID_ARGS", message: messages.join("; ") } });
+  process.exit(1);
+}
+
+export {
+  handleLinkedinError,
+  resolveAccountIdArg,
+  todayIso,
+  daysAgoIso,
+  csvOrJson,
+  statusesArgDescription,
+  resolveStatusFilter,
+  loadTargetingArg,
+  exitOnInvalidArgs
+};
+//# sourceMappingURL=chunk-34MZGC2Y.js.map