@koda-sl/baker-cli 0.574.0 → 0.575.0-dev.85f21462e

package/dist/chunk-LQRPFL2N.js

@@ -0,0 +1,218 @@
+import {
+  handleConnectionError,
+  needsConnectionFix,
+  writeAdsJson
+} from "./chunk-VJUVTMHY.js";
+import {
+  LINKEDIN_SEARCH_STATUSES,
+  unsupportedLinkedinSearchStatuses
+} from "./chunk-BTOGDXA4.js";
+import {
+  ApiError
+} from "./chunk-JCFZ7ECN.js";
+import {
+  MissingChatIdError,
+  getEnv
+} from "./chunk-OMLZ35HJ.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 };
+}
+function normalizeLinkedinAccountId(raw) {
+  const match = raw.trim().match(/^(?:(?:urn:li:)?sponsoredAccount:)?(\d+)$/);
+  return match?.[1] ?? null;
+}
+function optionalAccountIdArg(args) {
+  const fromArgs = args["account-id"] ?? args["account-urn"];
+  const id = fromArgs || getEnv().BAKER_LINKEDIN_AD_ACCOUNT_ID;
+  if (!id) return void 0;
+  const bare = normalizeLinkedinAccountId(id);
+  if (bare === null) {
+    writeAdsJson({
+      ok: false,
+      error: {
+        code: "INVALID_ACCOUNT_ID",
+        message: `Invalid LinkedIn account ID "${id}". Expected numeric or urn:li:sponsoredAccount:N. Run \`baker ads linkedin accounts\` to list them.`
+      }
+    });
+    process.exit(1);
+  }
+  return bare;
+}
+function resolveAccountIdArg(args) {
+  const id = optionalAccountIdArg(args);
+  if (id === void 0) {
+    writeAdsJson({
+      ok: false,
+      error: {
+        code: "MISSING_ACCOUNT_ID",
+        message: "This company has several LinkedIn ad accounts selected, so the command needs one: pass --account-id. Run `baker ads linkedin accounts` to list them."
+      }
+    });
+    process.exit(1);
+  }
+  return 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,
+  normalizeLinkedinAccountId,
+  optionalAccountIdArg,
+  resolveAccountIdArg,
+  todayIso,
+  daysAgoIso,
+  csvOrJson,
+  statusesArgDescription,
+  resolveStatusFilter,
+  loadTargetingArg,
+  exitOnInvalidArgs
+};
+//# sourceMappingURL=chunk-LQRPFL2N.js.map

package/dist/chunk-LY7PDE76.js

@@ -0,0 +1,285 @@
+import {
+  IDEA_VIDEO_FORMATS,
+  figuresIn,
+  unsourcedClaims
+} from "./chunk-NOCBNING.js";
+import {
+  AD_SPEC_SCHEMA,
+  unfitReasons
+} from "./chunk-5WOZ7OGU.js";
+import {
+  proofStrength
+} from "./chunk-NXNOXZGB.js";
+
+// src/commands/creatives/make-model.ts
+import { parse, parseDocument, Scalar, visit } from "yaml";
+var REFERENCE_CANDIDATES = 6;
+function isVideoIdea(idea) {
+  return IDEA_VIDEO_FORMATS.includes(idea.format ?? "");
+}
+var BY_TEMPERATURE = {
+  cold: { audienceTemperature: "0_cold", excludeBrandReliant: true },
+  warm: { audienceTemperature: "1_warm_engaged,2_hot_visited", excludeBrandReliant: true },
+  hot: { audienceTemperature: "3_customer" }
+};
+function referenceSearchFor(idea, temperature, where = {}) {
+  return {
+    query: where.category || idea.message,
+    scope: "followed-first",
+    platform: "meta",
+    format: "static",
+    formatPattern: idea.format,
+    awareness: idea.awareness,
+    ...BY_TEMPERATURE[temperature],
+    ...where.country ? { country: where.country } : {},
+    maxPerAdvertiser: 1,
+    limit: REFERENCE_CANDIDATES,
+    diverse: true
+  };
+}
+function referenceSearchesFor(idea, temperature, where = {}) {
+  const strict = referenceSearchFor(idea, temperature, where);
+  const { awareness: _awareness, ...anyStage } = strict;
+  const { audienceTemperature: _temperature, excludeBrandReliant: _reliant, ...viewerAny } = anyStage;
+  const anyViewer = { ...viewerAny, scope: "all" };
+  const { formatPattern: _pattern, ...anyContainer } = anyViewer;
+  const { country: _country, ...anywhere } = anyViewer;
+  const { country: _anyCountry, ...anyContainerAnywhere } = anyContainer;
+  const { query: _query, ...winners } = anyStage;
+  const { query: _anyQuery, country: _winnersCountry, ...winnersAnywhere } = anyViewer;
+  const inMarket = (steps) => where.country ? steps : [];
+  const shows = idea.shows?.trim();
+  const { formatPattern: _shownPattern, ...anyCategory } = { ...anyStage, scope: "all" };
+  const { country: _shownCountry, ...anyCategoryAnywhere } = anyCategory;
+  const { country: _viewerCountry, ...anyViewerAnywhere } = anyViewer;
+  const { formatPattern: _anyPattern, ...shownAnyViewer } = anyViewerAnywhere;
+  const kinds = (where.shows ?? []).flatMap((q) => q.trim() ? [{ ...anyCategoryAnywhere, query: q.trim() }] : []);
+  const shown = shows ? [
+    ...inMarket([{ ...anyCategory, query: shows }]),
+    ...kinds,
+    { ...anyCategoryAnywhere, query: shows },
+    { ...shownAnyViewer, query: shows },
+    ...idea.format ? [{ ...anyViewerAnywhere, query: shows }] : []
+  ] : [];
+  const anyAd = (query) => query?.trim() ? [...inMarket([{ ...anyContainer, query: query.trim() }]), { ...anyContainerAnywhere, query: query.trim() }] : [];
+  if (shows) {
+    return [
+      ...shown,
+      ...where.category ? [anyContainerAnywhere] : [],
+      ...where.audience?.trim() ? [{ ...anyContainerAnywhere, query: where.audience.trim() }] : [],
+      { ...winnersAnywhere, sort: "winner" }
+    ];
+  }
+  return [
+    ...where.country ? [strict, anyStage, anyContainer] : [strict, anyStage],
+    anywhere,
+    anyContainerAnywhere,
+    ...anyAd(where.audience),
+    ...(where.wider ?? []).flatMap((q) => q.trim() ? [{ ...anyContainerAnywhere, query: q.trim() }] : []),
+    ...anyAd(where.industry),
+    ...where.category ? [{ ...anyContainerAnywhere, query: idea.message }] : [],
+    ...inMarket([{ ...winners, sort: "winner" }]),
+    { ...winnersAnywhere, sort: "winner" }
+  ];
+}
+function referenceWhereOf(brief, fallback) {
+  if (!brief) return fallback;
+  const country = brief.country === null ? void 0 : brief.country ?? fallback.country;
+  const audience = brief.audience ?? fallback.audience;
+  return {
+    ...country ? { country } : {},
+    category: brief.category,
+    ...brief.industry ? { industry: brief.industry } : {},
+    ...audience ? { audience } : {},
+    ...brief.wider.length ? { wider: brief.wider } : {},
+    ...brief.shows?.length ? { shows: brief.shows } : {}
+  };
+}
+function rankedForOf(brief, where, bet) {
+  return {
+    category: brief?.category ?? where.category ?? bet.message,
+    ...brief?.industry ? { industry: brief.industry } : {},
+    ...brief?.buyer ? { buyer: brief.buyer } : {},
+    ...brief?.humour ? { humour: brief.humour } : {},
+    ...brief?.memes ? { memes: brief.memes } : {},
+    ...brief?.memesWhy ? { memesWhy: brief.memesWhy } : {},
+    ...brief?.avoid.length ? { avoid: brief.avoid } : {},
+    message: bet.message,
+    who: bet.who,
+    ...bet.shows ? { shows: bet.shows } : {}
+  };
+}
+var brandKey = (name) => name.normalize("NFD").replace(new RegExp("\\p{M}", "gu"), "").toLowerCase().replace(/[^\p{L}\p{N}]/gu, "");
+function isOwnBrand(advertiser, brands) {
+  const page = brandKey(advertiser ?? "");
+  return page !== "" && brands.some((b) => brandKey(b).length >= 3 && page.includes(brandKey(b)));
+}
+function pooledCandidates(searches, limit) {
+  const seen = /* @__PURE__ */ new Set();
+  const pooled = [];
+  for (const candidate of searches.flat()) {
+    const brand = candidate.advertiser_id ? `brand:${candidate.advertiser_id}` : null;
+    if (!candidate.ad_id || seen.has(candidate.ad_id) || brand && seen.has(brand)) continue;
+    seen.add(candidate.ad_id);
+    if (brand) seen.add(brand);
+    pooled.push(candidate);
+  }
+  const proven = (c) => proofStrength(c.winner_score) !== "little";
+  return [...pooled.filter(proven), ...pooled.filter((c) => !proven(c))].slice(0, limit);
+}
+function freshReferencesFirst(candidates, taken) {
+  return [
+    ...candidates.filter((c) => !isTakenReference(c, taken)),
+    ...candidates.filter((c) => isTakenReference(c, taken))
+  ];
+}
+function isTakenReference(c, taken) {
+  return c.ad_id != null && taken.adIds.has(c.ad_id) || c.advertiser_id != null && taken.advertiserIds.has(c.advertiser_id);
+}
+function fitsIdea(fit) {
+  return fit.verdict !== "reject" && missingElements(fit).length === 0 && fit.our_viewer?.stops !== "no";
+}
+function missingElements(fit) {
+  return fit.load_bearing.filter((l) => l.have === "missing" && !l.ours?.trim()).map((l) => l.element);
+}
+function whyUnfit(fit) {
+  const reasons = unfitReasons(fit);
+  if (reasons.length > 0) return reasons.join("; ");
+  if (fit.our_viewer?.stops === "no") {
+    return `our viewer would not stop for it${fit.our_viewer.why ? `: ${fit.our_viewer.why}` : ""}`;
+  }
+  return fit.transfer_note?.trim() || "the check found it does not carry this ad";
+}
+function definitionFieldsOf(idea, evidence) {
+  return {
+    idea: idea.id,
+    message: idea.message,
+    ...evidence !== "explore" ? { evidence } : {},
+    angle: idea.angle,
+    persona: idea.who,
+    awareness: idea.awareness,
+    hypothesis: idea.why
+  };
+}
+var FRONTMATTER = /^---\r?\n([\s\S]*?\r?\n)?---/;
+function readsAsText11(text) {
+  try {
+    return parse(text, { version: "1.1" }) === text;
+  } catch {
+    return false;
+  }
+}
+function setDefinitionFields(raw, fields) {
+  const match = raw.match(FRONTMATTER);
+  if (!match) return raw;
+  const doc = parseDocument(match[1] ?? "");
+  if (doc.errors.length > 0) return raw;
+  for (const [key, value] of Object.entries(fields)) {
+    if (value === void 0) continue;
+    const node = doc.createNode(value);
+    visit(node, {
+      Scalar(_, scalar) {
+        if (typeof scalar.value === "string" && !readsAsText11(scalar.value)) {
+          scalar.type = Scalar.QUOTE_DOUBLE;
+        }
+      }
+    });
+    doc.set(key, node);
+  }
+  return `---
+${doc.toString()}---${raw.slice(match[0].length)}`;
+}
+function setSpecMessage(specJson, message) {
+  const spec = JSON.parse(specJson);
+  return `${JSON.stringify({ ...spec, message }, null, 2)}
+`;
+}
+function setSpecViewer(specJson, idea, personas) {
+  const spec = JSON.parse(specJson);
+  const viewer = spec.viewer ?? {};
+  return `${JSON.stringify({ ...spec, viewer: { ...viewer, who: personaWho(idea, personas) } }, null, 2)}
+`;
+}
+function personaWho(idea, personas) {
+  const persona = personas.find((p) => p.slug === idea.who);
+  if (persona?.title) return `${persona.title}${persona.segment ? ` (${persona.segment})` : ""}`;
+  return persona?.segment ?? idea.who.replace(/[-_]/g, " ");
+}
+var AUDIENCE_QUERY_WORDS = 9;
+function audienceQuery(idea, personas) {
+  return personaWho(idea, personas).replace(/\(/g, " ").replace(/\)/g, "").split(/\s+/).filter(Boolean).slice(0, AUDIENCE_QUERY_WORDS).join(" ").replace(/[\s,;:.–—-]+$/, "");
+}
+function fitBetOf(idea, personas, insights, market) {
+  const quotes = insights.filter((i) => idea.evidence.includes(i.id)).map((i) => i.quote);
+  return {
+    who: personaWho(idea, personas),
+    message: idea.message,
+    awareness: idea.awareness,
+    angle: idea.angle,
+    ...idea.shows ? { shows: idea.shows } : {},
+    ...quotes.length > 0 ? { quotes } : {},
+    ...market ? { market } : {}
+  };
+}
+function withFitConcept(specJson, seeded) {
+  const spec = JSON.parse(specJson);
+  const held = spec.concept;
+  if (held?.reference_ad_id) return specJson;
+  return `${JSON.stringify({ ...spec, ...seeded }, null, 2)}
+`;
+}
+function unsourcedCopyLines(specJson, corpus) {
+  const spec = JSON.parse(specJson);
+  const figures = figuresIn(corpus);
+  const lines = Array.isArray(spec.copy) ? spec.copy : [];
+  return lines.flatMap((line) => {
+    const text = typeof line === "object" && line !== null ? line.text : void 0;
+    return typeof text === "string" && unsourcedClaims(text, figures).length > 0 ? [text] : [];
+  });
+}
+var PHOTO_FORMATS = /photo|lifestyle|before_after|ugc|product|selfie|street/;
+function ideaSpec(idea, who) {
+  const container = idea.format ? `, as a ${idea.format.replace(/_/g, " ")}` : "";
+  const shows = idea.shows ? ` (${idea.shows})` : "";
+  return {
+    schema: AD_SPEC_SCHEMA,
+    viewer: { who },
+    message: idea.message,
+    copy: [{ text: "[TODO: the headline, in the customer's words]", lettering: "designed", role: "headline" }],
+    scene: {
+      description: `[TODO: what the viewer sees first${shows}${container}, that shows: ${idea.message}]`,
+      look: PHOTO_FORMATS.test(idea.format ?? idea.shows ?? "") ? "photo" : "designed"
+    },
+    colors: [],
+    references: [],
+    logo: true,
+    third_party_brands: [],
+    scene_text: [],
+    mechanism: []
+  };
+}
+
+export {
+  isVideoIdea,
+  referenceSearchesFor,
+  referenceWhereOf,
+  rankedForOf,
+  isOwnBrand,
+  pooledCandidates,
+  freshReferencesFirst,
+  isTakenReference,
+  fitsIdea,
+  missingElements,
+  whyUnfit,
+  definitionFieldsOf,
+  setDefinitionFields,
+  setSpecMessage,
+  setSpecViewer,
+  personaWho,
+  audienceQuery,
+  fitBetOf,
+  withFitConcept,
+  unsourcedCopyLines,
+  ideaSpec
+};
+//# sourceMappingURL=chunk-LY7PDE76.js.map