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

package/dist/chunk-IR2NRXHA.js

@@ -0,0 +1,309 @@
+import {
+  ACCOUNTS_NO_SETTINGS_MESSAGE,
+  accountDealStatus,
+  influenceParams
+} from "./chunk-X7NRAGJ5.js";
+import {
+  toCsvRow
+} from "./chunk-VJUVTMHY.js";
+
+// src/commands/accounts/report.ts
+function accountsRefusal(code, message) {
+  if (code === "CONFLICT" && message.includes(ACCOUNTS_NO_SETTINGS_MESSAGE)) {
+    return {
+      code: "ACCOUNTS_NOT_SET_UP",
+      fix: {
+        action: "ask_user",
+        explanation: "The user sets up where the deals are in Measure \u2192 Accounts first: HubSpot (then its pipelines and won/lost stages), or Another CRM, whose deals they send by spreadsheet or from their system (`baker accounts crm status`). Only the user can say which stages mean won and lost; do not guess them. Until then `baker accounts engagement` and `baker accounts warm` still work \u2014 they need no deals."
+      }
+    };
+  }
+  return null;
+}
+var FLAG_OF_FIELD = {
+  lastMonths: "--last-months",
+  start: "--start",
+  end: "--end",
+  campaignId: "--campaign-id",
+  limit: "--limit",
+  basis: "--basis",
+  model: "--model",
+  threshold: "--threshold",
+  orgId: "company",
+  domain: "company",
+  targets: "--targets",
+  since: "--since"
+};
+function invalidArgsMessage(issues) {
+  return issues.map((issue) => {
+    const field = issue.path.map(String).join(".");
+    return `${FLAG_OF_FIELD[field] ?? (field || "args")}: ${issue.message}`;
+  }).join("; ");
+}
+function money(value) {
+  const parts = Object.entries(value).map(
+    ([currency, amount]) => `${Math.round(amount).toLocaleString("en")} ${currency}`
+  );
+  return parts.length > 0 ? parts.join(" + ") : "no amount";
+}
+var SETUP_FIX = {
+  pipelines_not_chosen: "choose the HubSpot pipelines (customers and open deals are not left out yet)",
+  deals_not_received: "send the deals from the company's CRM (none has arrived, so warm-account alerts are paused and no deal counts as influenced)",
+  sync_failing: "reconnect the platform the last nightly sync failed on",
+  source_disconnected: "reconnect LinkedIn Ads or HubSpot in Integrations",
+  stale: "check why the numbers have not updated for two days"
+};
+function setupHint(issues) {
+  if (!issues || issues.length === 0) return [];
+  const fixes = issues.map((issue) => SETUP_FIX[issue]).join("; ");
+  return [
+    `Account insights setup needs an admin: ${fixes}. Until then warm and influenced are less accurate \u2014 say so once when you report them, and never try to fix the setup yourself.`
+  ];
+}
+function influencedHints(data) {
+  const hints = [];
+  const { summary } = data;
+  if (summary.lowConfidenceDeals > 0) {
+    const deals = summary.lowConfidenceDeals === 1 ? "deal" : "deals";
+    const look = summary.lowConfidenceDeals === 1 ? "looks" : "look";
+    hints.push(
+      `${summary.lowConfidenceDeals} more ${deals} (${money(summary.lowConfidenceValue)}) ${look} influenced through a company match that is only a guess (a subdomain or a name). They are not counted in the numbers until someone confirms the match in Measure \u2192 Accounts; they are listed under lowConfidence.`
+    );
+  }
+  const valued = Object.keys(summary.influencedValue).length > 0;
+  const spent = Object.values(summary.spend).some((amount) => amount > 0);
+  if (summary.valuePerSpend === null && valued && spent) {
+    hints.push(
+      `valuePerSpend is null because the influenced value (${money(summary.influencedValue)}) and the LinkedIn spend (${money(summary.spend)}) are not in one single currency \u2014 amounts in different currencies are never converted or added. Report them side by side.`
+    );
+  }
+  return hints;
+}
+function influencedTableRows(data, full) {
+  return full ? data.deals : [...data.deals, ...data.lowConfidence];
+}
+function engagementHints(data, request) {
+  if (data.companies.length === 0) {
+    return [
+      `No company the LinkedIn ads reached shows up for ${data.window.start} to ${data.window.end}. The nightly sync may not have run since the campaigns started delivering, or LinkedIn left the companies out (fewer than 3 events in a month). Try a longer period (--last-months 12), or read the ad account live with \`baker ads linkedin companies\`.`
+    ];
+  }
+  const page = data.pageInfo;
+  if (page?.hasMore) {
+    const first = (page.page - 1) * page.pageSize + 1;
+    const last = first + data.companies.length - 1;
+    return [
+      `Companies ${first}-${last} of ${page.total.toLocaleString("en")} shown. Read the next ones with --page ${page.page + 1} --limit ${page.pageSize}.`
+    ];
+  }
+  return data.truncated ? [`More companies were reached than --limit ${request.limit}; raise it to see the tail.`] : [];
+}
+var ENGAGEMENT_TABLE_FIELDS = [
+  "orgId",
+  "name",
+  "domain",
+  "impressions",
+  "clicks",
+  "engagements",
+  "videoViews",
+  "estimatedSpend",
+  "spendCurrency",
+  "costLocal",
+  "currency",
+  "monthsActive",
+  "lastMonth",
+  "previousImpressions",
+  "previousClicks",
+  "previousEngagements",
+  "flag",
+  "crmCompanyId",
+  "matchConfidence",
+  "dealStatus",
+  "hasOpenDeal",
+  "hasWonDeal",
+  "hasLostDeal",
+  "lastLostAt",
+  "websitePeople",
+  "websiteLeads",
+  "websiteVisits",
+  "websitePagesRead",
+  "websiteLastVisit",
+  "isTarget",
+  "tier",
+  "alertedAt"
+];
+function engagementTableRows(rows) {
+  return withDealStatus(rows).map(({ previous, website, visitorCompany, estimatedSpend, ...row }) => ({
+    ...row,
+    estimatedSpend: estimatedSpend?.amount ?? 0,
+    spendCurrency: estimatedSpend?.currency ?? "",
+    previousImpressions: previous.impressions,
+    previousClicks: previous.clicks,
+    previousEngagements: previous.engagements,
+    websitePeople: website?.people ?? 0,
+    websiteLeads: website?.leads ?? 0,
+    websiteVisits: visitorCompany?.visits ?? 0,
+    websitePagesRead: visitorCompany?.pages ?? 0,
+    websiteLastVisit: visitorCompany?.lastSeen ?? null
+  }));
+}
+var MODEL_OF_METRIC = {
+  engagements: "engagement",
+  impressions: "awareness",
+  clicks: "intent"
+};
+function warmMinimum(rule, override) {
+  const saved = { model: { kind: rule ? MODEL_OF_METRIC[rule.metric] : "engagement", threshold: rule?.threshold } };
+  const read = influenceParams(saved, { model: override.model, threshold: override.threshold });
+  const value = override.min ?? read.threshold;
+  return value > 0 ? { metric: read.metric, value } : void 0;
+}
+function warmHints(read, warm, minimum) {
+  const hints = [];
+  if (read.truncated) {
+    hints.push(
+      `The ads reached more companies than one read returns (${read.companies.length.toLocaleString("en")}, the most engaged first), so warm companies with little engagement may be missing. Read a shorter period with --last-months 1 to see them.`
+    );
+  }
+  if (warm.length === 0 && read.companies.length > 0 && minimum !== void 0) {
+    hints.push(
+      `No company both warmed up and reached ${minimum.value}+ ${minimum.metric} in the period. Try a longer period with --last-months, or a lower bar with --min (--min 0 drops it).`
+    );
+  }
+  if (warm.some((row) => row.name === "")) {
+    hints.push("Some companies have no name yet \u2014 the nightly sync looks them up; the organizationUrn still matches.");
+  }
+  if (warm.length > 0) {
+    hints.push(
+      'To advertise to them: `baker accounts warm --output csv > warm.csv`, then `baker ads linkedin audiences create --name "Warm accounts" --type company-list --list-file warm.csv` (staged until publish).'
+    );
+  }
+  return hints;
+}
+var WARM_CSV_COLUMNS = ["companyName", "domain", "organizationUrn"];
+function warmAccountsCsv(rows) {
+  const lines = [toCsvRow(WARM_CSV_COLUMNS)];
+  for (const row of rows) {
+    const name = row.name.replace(/\s*[\r\n]+\s*/g, " ");
+    lines.push(toCsvRow([name, row.domain, `urn:li:organization:${row.orgId}`]));
+  }
+  return `${lines.join("\n")}
+`;
+}
+var plural = (count, one, many) => `${count} ${count === 1 ? one : many}`;
+function reachText(counts2) {
+  return `${counts2.reached} of ${counts2.total} reached, ${counts2.engaged} engaged`;
+}
+function targetsHints(summary, unreadable) {
+  if (summary === void 0) {
+    return [
+      "This Baker server does not narrow reports to target accounts yet: the rows cover every company the ads reached."
+    ];
+  }
+  const tiers = Object.entries(summary.byTier ?? {}).sort(([a], [b]) => a.localeCompare(b, "en", { numeric: true })).map(([tier, counts2]) => `tier ${tier}: ${reachText(counts2)}`);
+  const hints = [
+    `Target accounts: ${reachText(summary)}${tiers.length > 0 ? ` (${tiers.join("; ")})` : ""}. Rows and numbers cover the target accounts only.`
+  ];
+  const missed = summary.notReached.length;
+  if (missed > 0) {
+    hints.push(
+      `${plural(missed, "target account was", "target accounts were")} never reached in the period (targets.notReached). Check ${missed === 1 ? "its domain is the website on its LinkedIn page" : "their domains are the websites on their LinkedIn pages"}, or advertise to ${missed === 1 ? "it" : "them"} with a company list.`
+    );
+  }
+  if (unreadable.length > 0) {
+    const listed = unreadable.map((entry) => `"${entry}"`).join(", ");
+    hints.push(
+      `Skipped ${plural(unreadable.length, "entry", "entries")} of the targets file that ${unreadable.length === 1 ? "is" : "are"} not a website: ${listed}.`
+    );
+  }
+  return hints;
+}
+var percent = (part, whole) => `${whole > 0 ? Math.round(part / whole * 100) : 0}%`;
+var perCompany = (total, companies) => companies > 0 ? String(Math.round(total / companies * 10) / 10) : "0";
+function comparisonHints(comparison) {
+  if (comparison === void 0) return [];
+  if ("companies" in comparison.targets && "companies" in comparison.others) {
+    const { targets: targets2, others: others2 } = comparison;
+    return [
+      `Targets vs everyone else: ${targets2.engaged} of ${targets2.companies} target accounts engaged (${percent(targets2.engaged, targets2.companies)}) against ${others2.engaged} of ${others2.companies} other companies (${percent(others2.engaged, others2.companies)}); ${perCompany(targets2.engagements, targets2.companies)} engagements per target, ${perCompany(others2.engagements, others2.companies)} per other company (\`comparison\`).`
+    ];
+  }
+  const { targets, others } = comparison;
+  return [
+    `Targets vs everyone else: ${targets.influencedDeals} of ${targets.deals} target-account deals influenced (${money(targets.influencedValue)}) against ${others.influencedDeals} of ${others.deals} other deals (${money(others.influencedValue)}) (\`comparison\`).`
+  ];
+}
+function withDealStatus(rows) {
+  return rows.map((row) => ({ ...row, dealStatus: accountDealStatus(row) }));
+}
+var counts = (row) => ({
+  month: row.month,
+  impressions: row.impressions,
+  clicks: row.clicks,
+  engagements: row.engagements
+});
+function unreachedHint(unreached, deals) {
+  if (unreached.length > 0) {
+    return `The LinkedIn ads have not reached LinkedIn company ${unreached.map((org) => org.orgId).join(", ")} in the months the nightly sync keeps (up to 24), so there is nothing to show. Check the id against \`baker accounts engagement\`, or try the company's website domain.`;
+  }
+  if (deals > 0) {
+    return `That company is in the CRM with ${deals === 1 ? "1 deal" : `${deals} deals`}, but the LinkedIn ads have not reached it in the months the nightly sync keeps, so none of its deals can count as influenced.`;
+  }
+  return "The ads have not reached that company, or it is named differently: try its LinkedIn id from `baker accounts engagement`.";
+}
+function companyView(data) {
+  const reachedOrgs = new Set(data.months.map((row) => row.orgId));
+  const orgs = data.orgs.filter((org) => reachedOrgs.has(org.orgId) || org.name !== "" || org.crmCompanyId !== null);
+  const months = data.months.filter((row) => row.campaignId === "").map((row) => ({ orgId: row.orgId, ...counts(row) }));
+  const byCampaign = [];
+  for (const row of data.months) {
+    if (row.campaignId === "") continue;
+    let entry = byCampaign.find((item) => item.orgId === row.orgId && item.campaignId === row.campaignId);
+    if (entry === void 0) {
+      entry = { orgId: row.orgId, campaignId: row.campaignId, campaignName: row.campaignName, months: [] };
+      byCampaign.push(entry);
+    }
+    entry.months.push(counts(row));
+  }
+  const hints = [];
+  const unreached = unreachedHint(
+    data.orgs.filter((org) => !orgs.includes(org)),
+    data.deals.length
+  );
+  if (orgs.length === 0) hints.push(unreached);
+  if (byCampaign.length > 0) {
+    hints.push(
+      "`months` are the company's totals. `byCampaign` splits the same numbers by campaign, and a company several campaigns reached shows up under each \u2014 never add byCampaign to the totals or to each other."
+    );
+  }
+  if (orgs.some((org) => org.matchConfidence === "low")) {
+    hints.push(
+      "The CRM match is only a guess (a subdomain or a name) until someone confirms it in Measure \u2192 Accounts."
+    );
+  }
+  if (data.rule !== void 0 && data.deals.length > 0) {
+    hints.push(
+      `\`influenced\` on each deal: ${data.rule.threshold}+ ${data.rule.metric} (\`touchValue\`) in the ${data.rule.lookbackMonths} months up to the month the deal was created (closed, for a won deal), counted from this company's months above.`
+    );
+  }
+  return { data: { orgs, months, byCampaign, deals: data.deals, ...data.rule ? { rule: data.rule } : {} }, hints };
+}
+
+export {
+  accountsRefusal,
+  invalidArgsMessage,
+  setupHint,
+  influencedHints,
+  influencedTableRows,
+  engagementHints,
+  ENGAGEMENT_TABLE_FIELDS,
+  engagementTableRows,
+  warmMinimum,
+  warmHints,
+  warmAccountsCsv,
+  targetsHints,
+  comparisonHints,
+  withDealStatus,
+  companyView
+};
+//# sourceMappingURL=chunk-IR2NRXHA.js.map