@koda-sl/baker-cli 0.572.0 → 0.574.0

package/dist/chunk-UYOUNHUQ.js

@@ -0,0 +1,309 @@
+import {
+  ACCOUNTS_NO_SETTINGS_MESSAGE,
+  accountDealStatus,
+  influenceParams
+} from "./chunk-MNJT2F7H.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-UYOUNHUQ.js.map

package/dist/chunk-UYOUNHUQ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/accounts/report.ts"],"sourcesContent":["/**\n * The pure half of `baker accounts`: the warm-account list file, and what the\n * agent should take from a report that the rows alone don't say.\n */\n\nimport {\n  ACCOUNTS_NO_SETTINGS_MESSAGE,\n  type AccountCompanyMonth,\n  type AccountDealRow,\n  type AccountDealStatus,\n  type AccountEngagementRow,\n  type AccountsCompanyResponse,\n  type AccountsEngagementResponse,\n  type AccountsInfluencedResponse,\n  type AccountsSetupIssue,\n  accountDealStatus,\n  type DealsComparison,\n  type InfluenceMetric,\n  type InfluenceModelKind,\n  type InfluenceParams,\n  type InfluenceRuleOverride,\n  influenceParams,\n  type MoneyByCurrency,\n  type WarmAccountsOptions,\n} from \"@baker/api/accounts\";\nimport type { EngagementComparison, TargetsSummary } from \"@baker/api/accounts/targets\";\nimport { toCsvRow } from \"../ads/output.ts\";\n\nexport type AccountsRefusal = { code: \"ACCOUNTS_NOT_SET_UP\"; fix: { action: \"ask_user\"; explanation: string } };\n\n/**\n * The refusal the agent cannot clear, as the fix it acts on: not set up (only\n * the user can say which stages mean won). Matched on the backend's own\n * sentence (shared from `@baker/api/accounts`), because it is a CONFLICT.\n * Null for every other refusal.\n */\nexport function accountsRefusal(code: string, message: string): AccountsRefusal | null {\n  if (code === \"CONFLICT\" && message.includes(ACCOUNTS_NO_SETTINGS_MESSAGE)) {\n    return {\n      code: \"ACCOUNTS_NOT_SET_UP\",\n      fix: {\n        action: \"ask_user\",\n        explanation:\n          \"The user sets up where the deals are in Measure → 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 — they need no deals.\",\n      },\n    };\n  }\n  return null;\n}\n\n/** Request fields as the flags that set them. */\nconst FLAG_OF_FIELD: Record<string, string> = {\n  lastMonths: \"--last-months\",\n  start: \"--start\",\n  end: \"--end\",\n  campaignId: \"--campaign-id\",\n  limit: \"--limit\",\n  basis: \"--basis\",\n  model: \"--model\",\n  threshold: \"--threshold\",\n  orgId: \"company\",\n  domain: \"company\",\n  targets: \"--targets\",\n  since: \"--since\",\n};\n\n/** A refused request in the agent's own words: which flag, and why. */\nexport function invalidArgsMessage(issues: ReadonlyArray<{ path: PropertyKey[]; message: string }>): string {\n  return issues\n    .map((issue) => {\n      const field = issue.path.map(String).join(\".\");\n      return `${FLAG_OF_FIELD[field] ?? (field || \"args\")}: ${issue.message}`;\n    })\n    .join(\"; \");\n}\n\nfunction money(value: MoneyByCurrency): string {\n  const parts = Object.entries(value).map(\n    ([currency, amount]) => `${Math.round(amount).toLocaleString(\"en\")} ${currency}`,\n  );\n  return parts.length > 0 ? parts.join(\" + \") : \"no amount\";\n}\n\n/** Each setup problem as the fix an admin makes in Measure → Accounts or Integrations. */\nconst SETUP_FIX: Record<AccountsSetupIssue, string> = {\n  pipelines_not_chosen: \"choose the HubSpot pipelines (customers and open deals are not left out yet)\",\n  deals_not_received:\n    \"send the deals from the company's CRM (none has arrived, so warm-account alerts are paused and no deal counts as influenced)\",\n  sync_failing: \"reconnect the platform the last nightly sync failed on\",\n  source_disconnected: \"reconnect LinkedIn Ads or HubSpot in Integrations\",\n  stale: \"check why the numbers have not updated for two days\",\n};\n\n/**\n * One hint when Account insights is not set up soundly: the admins already\n * got an email, so the agent says it once to the user and hedges the numbers.\n */\nexport function setupHint(issues: readonly AccountsSetupIssue[] | undefined): string[] {\n  if (!issues || issues.length === 0) return [];\n  const fixes = issues.map((issue) => SETUP_FIX[issue]).join(\"; \");\n  return [\n    `Account insights setup needs an admin: ${fixes}. Until then warm and influenced are less accurate — say so once when you report them, and never try to fix the setup yourself.`,\n  ];\n}\n\n/** What the agent should take from an influenced report that the rows alone don't say. */\nexport function influencedHints(data: AccountsInfluencedResponse[\"data\"]): string[] {\n  const hints: string[] = [];\n  const { summary } = data;\n  if (summary.lowConfidenceDeals > 0) {\n    const deals = summary.lowConfidenceDeals === 1 ? \"deal\" : \"deals\";\n    const look = summary.lowConfidenceDeals === 1 ? \"looks\" : \"look\";\n    hints.push(\n      `${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 → Accounts; they are listed under lowConfidence.`,\n    );\n  }\n  const valued = Object.keys(summary.influencedValue).length > 0;\n  const spent = Object.values(summary.spend).some((amount) => amount > 0);\n  if (summary.valuePerSpend === null && valued && spent) {\n    hints.push(\n      `valuePerSpend is null because the influenced value (${money(summary.influencedValue)}) and the LinkedIn spend (${money(summary.spend)}) are not in one single currency — amounts in different currencies are never converted or added. Report them side by side.`,\n    );\n  }\n  return hints;\n}\n\n/**\n * The deals a table output prints: the counted ones, then the unconfirmed. With\n * `--full` the backend already lists the unconfirmed among `deals`, so they are\n * not added twice — a total taken from the table would count them double.\n */\nexport function influencedTableRows(data: AccountsInfluencedResponse[\"data\"], full: boolean): AccountDealRow[] {\n  return full ? data.deals : [...data.deals, ...data.lowConfidence];\n}\n\n/** What the agent should take from an engagement read that the rows alone don't say. */\nexport function engagementHints(data: AccountsEngagementResponse[\"data\"], request: { limit: number }): string[] {\n  if (data.companies.length === 0) {\n    return [\n      `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\\`.`,\n    ];\n  }\n  const page = data.pageInfo;\n  if (page?.hasMore) {\n    const first = (page.page - 1) * page.pageSize + 1;\n    const last = first + data.companies.length - 1;\n    return [\n      `Companies ${first}-${last} of ${page.total.toLocaleString(\"en\")} shown. Read the next ones with --page ${page.page + 1} --limit ${page.pageSize}.`,\n    ];\n  }\n  return data.truncated ? [`More companies were reached than --limit ${request.limit}; raise it to see the tail.`] : [];\n}\n\n/** The columns `baker accounts engagement --output csv|md` prints, in order. */\nexport const ENGAGEMENT_TABLE_FIELDS = [\n  \"orgId\",\n  \"name\",\n  \"domain\",\n  \"impressions\",\n  \"clicks\",\n  \"engagements\",\n  \"videoViews\",\n  \"estimatedSpend\",\n  \"spendCurrency\",\n  \"costLocal\",\n  \"currency\",\n  \"monthsActive\",\n  \"lastMonth\",\n  \"previousImpressions\",\n  \"previousClicks\",\n  \"previousEngagements\",\n  \"flag\",\n  \"crmCompanyId\",\n  \"matchConfidence\",\n  \"dealStatus\",\n  \"hasOpenDeal\",\n  \"hasWonDeal\",\n  \"hasLostDeal\",\n  \"lastLostAt\",\n  \"websitePeople\",\n  \"websiteLeads\",\n  \"websiteVisits\",\n  \"websitePagesRead\",\n  \"websiteLastVisit\",\n  \"isTarget\",\n  \"tier\",\n  \"alertedAt\",\n];\n\n/** Engagement rows flat for a table: the estimated spend as two columns, the period before as three, the website people as two and the company's own-network visits as three, not JSON cells. */\nexport function engagementTableRows(rows: readonly AccountEngagementRow[]): Array<Record<string, unknown>> {\n  return withDealStatus(rows).map(({ previous, website, visitorCompany, estimatedSpend, ...row }) => ({\n    ...row,\n    estimatedSpend: estimatedSpend?.amount ?? 0,\n    spendCurrency: estimatedSpend?.currency ?? \"\",\n    previousImpressions: previous.impressions,\n    previousClicks: previous.clicks,\n    previousEngagements: previous.engagements,\n    websitePeople: website?.people ?? 0,\n    websiteLeads: website?.leads ?? 0,\n    websiteVisits: visitorCompany?.visits ?? 0,\n    websitePagesRead: visitorCompany?.pages ?? 0,\n    websiteLastVisit: visitorCompany?.lastSeen ?? null,\n  }));\n}\n\nconst MODEL_OF_METRIC: Record<InfluenceMetric, InfluenceModelKind> = {\n  engagements: \"engagement\",\n  impressions: \"awareness\",\n  clicks: \"intent\",\n};\n\n/**\n * The least a warm company must have done this period: the company's\n * influence rule (the default one when the backend sent none), read for this\n * call with `--model`/`--threshold`, or `--min` on the rule's metric. `--min 0`\n * drops it, so one engagement after none reads as warm again.\n */\nexport function warmMinimum(\n  rule: InfluenceParams | undefined,\n  override: InfluenceRuleOverride & { min?: number },\n): WarmAccountsOptions[\"minimum\"] {\n  const saved = { model: { kind: rule ? MODEL_OF_METRIC[rule.metric] : \"engagement\", threshold: rule?.threshold } };\n  const read = influenceParams(saved, { model: override.model, threshold: override.threshold });\n  const value = override.min ?? read.threshold;\n  return value > 0 ? { metric: read.metric, value } : undefined;\n}\n\n/** What the agent should take from a warm list that the rows alone don't say. */\nexport function warmHints(\n  read: Pick<AccountsEngagementResponse[\"data\"], \"companies\" | \"truncated\">,\n  warm: readonly AccountEngagementRow[],\n  minimum: WarmAccountsOptions[\"minimum\"],\n): string[] {\n  const hints: string[] = [];\n  if (read.truncated) {\n    hints.push(\n      `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.`,\n    );\n  }\n  if (warm.length === 0 && read.companies.length > 0 && minimum !== undefined) {\n    hints.push(\n      `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).`,\n    );\n  }\n  if (warm.some((row) => row.name === \"\")) {\n    hints.push(\"Some companies have no name yet — the nightly sync looks them up; the organizationUrn still matches.\");\n  }\n  if (warm.length > 0) {\n    hints.push(\n      '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).',\n    );\n  }\n  return hints;\n}\n\n/** The header `baker ads linkedin audiences create --type company-list --list-file` reads. */\nconst WARM_CSV_COLUMNS = [\"companyName\", \"domain\", \"organizationUrn\"];\n\n/**\n * Warm accounts as a company-list file, one company a line. The list reader\n * splits on line breaks, so a name carrying one is flattened.\n */\nexport function warmAccountsCsv(rows: readonly AccountEngagementRow[]): string {\n  const lines = [toCsvRow(WARM_CSV_COLUMNS)];\n  for (const row of rows) {\n    const name = row.name.replace(/\\s*[\\r\\n]+\\s*/g, \" \");\n    lines.push(toCsvRow([name, row.domain, `urn:li:organization:${row.orgId}`]));\n  }\n  return `${lines.join(\"\\n\")}\\n`;\n}\n\nconst plural = (count: number, one: string, many: string) => `${count} ${count === 1 ? one : many}`;\n\nfunction reachText(counts: { total: number; reached: number; engaged: number }): string {\n  return `${counts.reached} of ${counts.total} reached, ${counts.engaged} engaged`;\n}\n\n/**\n * What a `--targets` read means beyond its rows: how far the ads got with the\n * list, the targets never reached, and the file entries that were skipped.\n * No summary back means a server that ignored the list.\n */\nexport function targetsHints(summary: TargetsSummary | undefined, unreadable: readonly string[]): string[] {\n  if (summary === undefined) {\n    return [\n      \"This Baker server does not narrow reports to target accounts yet: the rows cover every company the ads reached.\",\n    ];\n  }\n  const tiers = Object.entries(summary.byTier ?? {})\n    .sort(([a], [b]) => a.localeCompare(b, \"en\", { numeric: true }))\n    .map(([tier, counts]) => `tier ${tier}: ${reachText(counts)}`);\n  const hints = [\n    `Target accounts: ${reachText(summary)}${tiers.length > 0 ? ` (${tiers.join(\"; \")})` : \"\"}. Rows and numbers cover the target accounts only.`,\n  ];\n  const missed = summary.notReached.length;\n  if (missed > 0) {\n    hints.push(\n      `${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.`,\n    );\n  }\n  if (unreadable.length > 0) {\n    const listed = unreadable.map((entry) => `\"${entry}\"`).join(\", \");\n    hints.push(\n      `Skipped ${plural(unreadable.length, \"entry\", \"entries\")} of the targets file that ${unreadable.length === 1 ? \"is\" : \"are\"} not a website: ${listed}.`,\n    );\n  }\n  return hints;\n}\n\nconst percent = (part: number, whole: number) => `${whole > 0 ? Math.round((part / whole) * 100) : 0}%`;\nconst perCompany = (total: number, companies: number) =>\n  companies > 0 ? String(Math.round((total / companies) * 10) / 10) : \"0\";\n\n/**\n * \"Did the ABM work\" in one line: the target accounts beside every other\n * company in the same read — engagement for the companies reached, influenced\n * deals for a deal read. Nothing without a `--targets` read.\n */\nexport function comparisonHints(comparison: EngagementComparison | DealsComparison | undefined): string[] {\n  if (comparison === undefined) return [];\n  if (\"companies\" in comparison.targets && \"companies\" in comparison.others) {\n    const { targets, others } = comparison as EngagementComparison;\n    return [\n      `Targets vs everyone else: ${targets.engaged} of ${targets.companies} target accounts engaged (${percent(targets.engaged, targets.companies)}) against ${others.engaged} of ${others.companies} other companies (${percent(others.engaged, others.companies)}); ${perCompany(targets.engagements, targets.companies)} engagements per target, ${perCompany(others.engagements, others.companies)} per other company (\\`comparison\\`).`,\n    ];\n  }\n  const { targets, others } = comparison as DealsComparison;\n  return [\n    `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\\`).`,\n  ];\n}\n\n/** Each company with where it stands in the CRM spelled out, so the agent never has to combine the flags. */\nexport function withDealStatus(\n  rows: readonly AccountEngagementRow[],\n): Array<AccountEngagementRow & { dealStatus: AccountDealStatus }> {\n  return rows.map((row) => ({ ...row, dealStatus: accountDealStatus(row) }));\n}\n\ntype CompanyData = AccountsCompanyResponse[\"data\"];\ntype MonthCounts = Pick<AccountCompanyMonth, \"month\" | \"impressions\" | \"clicks\" | \"engagements\">;\n\nexport interface CompanyView {\n  orgs: CompanyData[\"orgs\"];\n  /** The company's own totals, month by month: the account-wide rows. */\n  months: Array<MonthCounts & { orgId: string }>;\n  /** The same numbers split by campaign. Overlapping: never add them to `months` or to each other. */\n  byCampaign: Array<{ orgId: string; campaignId: string; campaignName: string | null; months: MonthCounts[] }>;\n  deals: CompanyData[\"deals\"];\n  rule?: CompanyData[\"rule\"];\n}\n\nconst counts = (row: AccountCompanyMonth): MonthCounts => ({\n  month: row.month,\n  impressions: row.impressions,\n  clicks: row.clicks,\n  engagements: row.engagements,\n});\n\n/**\n * One company as the agent should read it. The store answers the account-wide\n * row and every campaign's row for the same month side by side, which reads\n * as double the activity; here the account-wide months are the totals and\n * the campaign split sits apart, labelled. A company the ads never reached\n * comes back from the store as an unnamed echo of the id asked for — dropped,\n * and said in words.\n */\n/** Why a company lookup shows no LinkedIn company: an id the ads never reached, a CRM-only company, or no match at all. */\nfunction unreachedHint(unreached: ReadonlyArray<{ orgId: string }>, deals: number): string {\n  if (unreached.length > 0) {\n    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.`;\n  }\n  if (deals > 0) {\n    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.`;\n  }\n  return \"The ads have not reached that company, or it is named differently: try its LinkedIn id from `baker accounts engagement`.\";\n}\n\nexport function companyView(data: CompanyData): { data: CompanyView; hints: string[] } {\n  const reachedOrgs = new Set(data.months.map((row) => row.orgId));\n  const orgs = data.orgs.filter((org) => reachedOrgs.has(org.orgId) || org.name !== \"\" || org.crmCompanyId !== null);\n  const months = data.months\n    .filter((row) => row.campaignId === \"\")\n    .map((row) => ({ orgId: row.orgId, ...counts(row) }));\n  const byCampaign: CompanyView[\"byCampaign\"] = [];\n  for (const row of data.months) {\n    if (row.campaignId === \"\") continue;\n    let entry = byCampaign.find((item) => item.orgId === row.orgId && item.campaignId === row.campaignId);\n    if (entry === undefined) {\n      entry = { orgId: row.orgId, campaignId: row.campaignId, campaignName: row.campaignName, months: [] };\n      byCampaign.push(entry);\n    }\n    entry.months.push(counts(row));\n  }\n\n  const hints: string[] = [];\n  const unreached = unreachedHint(\n    data.orgs.filter((org) => !orgs.includes(org)),\n    data.deals.length,\n  );\n  if (orgs.length === 0) hints.push(unreached);\n  if (byCampaign.length > 0) {\n    hints.push(\n      \"`months` are the company's totals. `byCampaign` splits the same numbers by campaign, and a company several campaigns reached shows up under each — never add byCampaign to the totals or to each other.\",\n    );\n  }\n  if (orgs.some((org) => org.matchConfidence === \"low\")) {\n    hints.push(\n      \"The CRM match is only a guess (a subdomain or a name) until someone confirms it in Measure → Accounts.\",\n    );\n  }\n  if (data.rule !== undefined && data.deals.length > 0) {\n    hints.push(\n      `\\`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.`,\n    );\n  }\n  return { data: { orgs, months, byCampaign, deals: data.deals, ...(data.rule ? { rule: data.rule } : {}) }, hints };\n}\n"],"mappings":"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","names":["counts","targets","others"]}

package/dist/chunk-UYVMINV2.js

@@ -0,0 +1,139 @@
+import {
+  brandVerificationHints
+} from "./chunk-IVIJJXXT.js";
+import {
+  AUTO_INGEST_MAX,
+  parseAutoIngest
+} from "./chunk-KKJ4KJCW.js";
+import {
+  emptyResultHints
+} from "./chunk-Q6ULQMWG.js";
+import {
+  OUTPUT_ARGS,
+  writeProviderHits
+} from "./chunk-6AMN346B.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-JCFZ7ECN.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-NXNOXZGB.js";
+
+// src/commands/images/logo.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "images.logo",
+  description: "Brand logo lookup via Brandfetch. Auto-ingests by default. Returns `brandMatch` \u2014 Brandfetch's own verdict on whose brand the domain is (confirmed | mismatch | unverified). Branch on it: `mismatch` means the mark is another company's, so do not place it. `confirmed` verifies the record, not the artwork \u2014 read the ingested row back to check the mark itself.",
+  args: {
+    domain: { type: "string", description: "Brand domain (e.g. stripe.com)", required: true },
+    variant: { type: "string", description: "icon | logo | symbol", required: false },
+    "auto-ingest": {
+      type: "number",
+      description: `Ingest top N hits (0-${AUTO_INGEST_MAX.logo}). Defaults to 1 (the first variant). Brandfetch resolves at most ${AUTO_INGEST_MAX.logo} variants, so ${AUTO_INGEST_MAX.logo} ingests every one. Keep it at 1+ \u2014 the ingested row is the only way to check the mark is the brand you asked for.`,
+      required: false
+    },
+    "no-auto-ingest": {
+      type: "boolean",
+      description: "Skip auto-ingest (equivalent to --auto-ingest 0). Leaves the returned mark unverifiable.",
+      required: false,
+      default: false
+    },
+    context: {
+      type: "string",
+      description: "Free-text hint applied to ingested logo variants (e.g. 'Stripe \u2014 payments integration partner', 'Acme competitor brand mark')",
+      required: false
+    },
+    output: { type: "string", description: "Output format: json|files|md", required: false, default: "json" },
+    fields: { type: "string", description: "Comma-separated field names to include", required: false },
+    full: { type: "boolean", description: "Include full metadata", required: false, default: false }
+  }
+});
+var logoCommand = defineCommand({
+  meta: {
+    name: "logo",
+    description: "Brand logo via Brandfetch. Returns up to 5 variants (icon, light/dark logo, light/dark symbol) plus `brandMatch`. Auto-ingests the first variant.\n\nStart here: check `brandMatch.verdict`.\n  mismatch   \u2192 the mark belongs to `brandMatch.name`, a different company. Do not place it.\n  unverified \u2192 nothing confirmed whose logo this is. Treat as unchecked.\n  confirmed  \u2192 Brandfetch has this brand's record. That verifies the record, NOT the artwork \u2014 a confirmed domain has served another company's logo before.\n\n\u26A0 Whatever the verdict, read the ingested row back with `baker images get <imageId>` and check `textInImage`/`subject` before placing it. That is the only check that looks at the mark.\n\nExample: baker images logo stripe.com --variant logo"
+  },
+  args: {
+    domain: { type: "positional", description: "Brand domain", required: false },
+    variant: { type: "string", description: "icon|logo|symbol", required: false },
+    "auto-ingest": {
+      type: "string",
+      description: `Ingest top N (0-${AUTO_INGEST_MAX.logo}, default 1)`,
+      required: false
+    },
+    "no-auto-ingest": { type: "boolean", description: "Skip auto-ingest", required: false },
+    context: { type: "string", description: "Description context hint applied to ingested logos", required: false },
+    ...OUTPUT_ARGS
+  },
+  run: async ({ args }) => {
+    try {
+      const domain = args.domain;
+      if (!domain) {
+        writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "Domain is required" } });
+        process.exit(1);
+      }
+      const body = { domain };
+      if (args.variant) body.variant = args.variant;
+      if (args["auto-ingest"] !== void 0) {
+        const parsed = parseAutoIngest(args["auto-ingest"], AUTO_INGEST_MAX.logo);
+        if (!parsed.ok) {
+          writeJson({
+            ok: false,
+            error: {
+              code: "VALIDATION_ERROR",
+              message: parsed.message,
+              fix: {
+                action: "retry_with_changes",
+                explanation: `Brandfetch resolves at most ${AUTO_INGEST_MAX.logo} variants for a domain, so --auto-ingest ${AUTO_INGEST_MAX.logo} already ingests every one. Re-run with a value in 0-${AUTO_INGEST_MAX.logo}.`
+              }
+            }
+          });
+          process.exit(1);
+        }
+        body.autoIngest = parsed.value;
+      } else if (args["no-auto-ingest"]) {
+        body.autoIngest = 0;
+      }
+      if (args.context) body.descriptionContext = args.context;
+      const data = await apiPost("/api/images/logo", body);
+      const hints = [
+        // `brandMatch` is Brandfetch's own answer to whose brand this domain is,
+        // so the warning can now be graded instead of fired blind: loud on a
+        // mismatch, honest about what a confirmation does and does not cover.
+        ...brandVerificationHints({
+          domain,
+          ingested: data.ingested,
+          hitCount: data.hits.length,
+          brandMatch: data.brandMatch
+        }),
+        ...emptyResultHints({ provider: "logo", hitCount: data.hits.length, activeFilters: [], subject: domain })
+      ];
+      writeProviderHits(data, data.hits, args, hints);
+    } catch (err) {
+      if (err instanceof ApiError) {
+        writeJson({ ok: false, error: { code: err.code, message: err.message } });
+        process.exit(1);
+      }
+      writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
+});
+async function fetchBrandLogo(domain) {
+  try {
+    const body = { domain, variant: "logo" };
+    const data = await apiPost("/api/images/logo", body);
+    if (data?.brandMatch?.verdict === "mismatch") return null;
+    return data?.ingested?.[0]?.imageUrl ?? data?.hits?.find((h) => h.imageUrl)?.imageUrl ?? null;
+  } catch {
+    return null;
+  }
+}
+
+export {
+  logoCommand,
+  fetchBrandLogo
+};
+//# sourceMappingURL=chunk-UYVMINV2.js.map

package/dist/chunk-VASOAJDL.js

@@ -0,0 +1,78 @@
+import {
+  sheetDelimiter
+} from "./chunk-IPEQHZ5H.js";
+import {
+  targetAccountsFrom
+} from "./chunk-AJ4OO3CV.js";
+
+// src/commands/accounts/targets.ts
+import { parse } from "csv-parse/sync";
+var COLUMN_OF_HEADER = {
+  domain: "domain",
+  website: "domain",
+  url: "domain",
+  companydomain: "domain",
+  companywebsite: "domain",
+  name: "name",
+  company: "name",
+  companyname: "name",
+  account: "name",
+  accountname: "name",
+  tier: "tier",
+  organizationurn: "organizationUrn",
+  linkedinurn: "organizationUrn",
+  linkedinid: "organizationUrn"
+};
+var headerKey = (header) => header.toLowerCase().replace(/[\s_-]+/g, "");
+function csvEntries(text) {
+  const rows = parse(text, {
+    bom: true,
+    columns: true,
+    delimiter: sheetDelimiter(text),
+    skip_empty_lines: true,
+    relax_column_count: true,
+    trim: true
+  });
+  const columns = Object.keys(rows[0] ?? {}).flatMap((header) => {
+    const field = COLUMN_OF_HEADER[headerKey(header)];
+    return field ? [[header, field]] : [];
+  });
+  if (!columns.some(([, field]) => field === "domain")) {
+    throw new Error(
+      `The file has no domain column (found: ${Object.keys(rows[0] ?? {}).join(", ") || "nothing"}). Name one "domain" or "website".`
+    );
+  }
+  return rows.map((row) => {
+    const entry = {};
+    for (const [header, field] of columns) entry[field] ??= row[header] ?? "";
+    return entry;
+  });
+}
+function jsonEntries(text) {
+  const parsed = JSON.parse(text);
+  if (!Array.isArray(parsed)) {
+    throw new Error('The JSON file must be an array: ["acme.com", \u2026] or [{"domain": "acme.com", "tier": 1}, \u2026].');
+  }
+  return parsed.map(
+    (item) => typeof item === "string" ? { domain: item } : typeof item === "object" && item !== null ? item : {}
+  );
+}
+function readTargetsFile(path, text) {
+  const entries = path.toLowerCase().endsWith(".json") ? jsonEntries(text) : csvEntries(text);
+  return targetAccountsFrom(entries);
+}
+function targetsOfTier(read, tier) {
+  if (tier === void 0) return read;
+  const targets = read.targets.filter((target) => target.tier === tier);
+  if (targets.length > 0) return { ...read, targets };
+  const tiers = [...new Set(read.targets.flatMap((target) => target.tier ? [target.tier] : []))].sort();
+  throw new Error(
+    `No target is tier ${tier} (${tiers.length > 0 ? `the list names tiers ${tiers.join(", ")}` : "the list names no tiers \u2014 add a tier column"}).`
+  );
+}
+
+export {
+  readTargetsFile,
+  targetsOfTier
+};
+//# sourceMappingURL=chunk-VASOAJDL.js.map

package/dist/chunk-VASOAJDL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/accounts/targets.ts"],"sourcesContent":["/**\n * `baker accounts … --targets <file>`: the target-account list a report\n * narrows to, read from a spreadsheet or a JSON file and reduced to the\n * registrable domains the reports join on (`@baker/api/accounts/targets`).\n */\n\nimport { sheetDelimiter } from \"@baker/api/accounts/crm\";\nimport { type TargetAccount, targetAccountsFrom } from \"@baker/api/accounts/targets\";\nimport { parse } from \"csv-parse/sync\";\n\nexport interface TargetsFile {\n  targets: TargetAccount[];\n  /** Entries whose domain is not a website, as the file wrote them. */\n  unreadable: string[];\n}\n\n/** Spreadsheet headers, lower-cased with spaces, dashes and underscores gone, as the field they fill. */\nconst COLUMN_OF_HEADER: Record<string, \"domain\" | \"name\" | \"tier\" | \"organizationUrn\"> = {\n  domain: \"domain\",\n  website: \"domain\",\n  url: \"domain\",\n  companydomain: \"domain\",\n  companywebsite: \"domain\",\n  name: \"name\",\n  company: \"name\",\n  companyname: \"name\",\n  account: \"name\",\n  accountname: \"name\",\n  tier: \"tier\",\n  organizationurn: \"organizationUrn\",\n  linkedinurn: \"organizationUrn\",\n  linkedinid: \"organizationUrn\",\n};\n\nconst headerKey = (header: string) => header.toLowerCase().replace(/[\\s_-]+/g, \"\");\n\nfunction csvEntries(text: string): Array<Record<string, string>> {\n  const rows = parse(text, {\n    bom: true,\n    columns: true,\n    delimiter: sheetDelimiter(text),\n    skip_empty_lines: true,\n    relax_column_count: true,\n    trim: true,\n  }) as Array<Record<string, string>>;\n  const columns = Object.keys(rows[0] ?? {}).flatMap((header) => {\n    const field = COLUMN_OF_HEADER[headerKey(header)];\n    return field ? [[header, field] as const] : [];\n  });\n  if (!columns.some(([, field]) => field === \"domain\")) {\n    throw new Error(\n      `The file has no domain column (found: ${Object.keys(rows[0] ?? {}).join(\", \") || \"nothing\"}). Name one \"domain\" or \"website\".`,\n    );\n  }\n  return rows.map((row) => {\n    const entry: Record<string, string> = {};\n    for (const [header, field] of columns) entry[field] ??= row[header] ?? \"\";\n    return entry;\n  });\n}\n\nfunction jsonEntries(\n  text: string,\n): Array<{ domain?: unknown; name?: unknown; tier?: unknown; organizationUrn?: unknown }> {\n  const parsed: unknown = JSON.parse(text);\n  if (!Array.isArray(parsed)) {\n    throw new Error('The JSON file must be an array: [\"acme.com\", …] or [{\"domain\": \"acme.com\", \"tier\": 1}, …].');\n  }\n  return parsed.map((item: unknown) =>\n    typeof item === \"string\" ? { domain: item } : typeof item === \"object\" && item !== null ? item : {},\n  );\n}\n\n/** The targets a `.json` or spreadsheet file names. Throws, in the agent's words, on a file it cannot read. */\nexport function readTargetsFile(path: string, text: string): TargetsFile {\n  const entries = path.toLowerCase().endsWith(\".json\") ? jsonEntries(text) : csvEntries(text);\n  return targetAccountsFrom(entries);\n}\n\n/** One tier's targets (`--tier`); the whole list without one. Throws, in the agent's words, on a tier nobody is in. */\nexport function targetsOfTier(read: TargetsFile, tier: string | undefined): TargetsFile {\n  if (tier === undefined) return read;\n  const targets = read.targets.filter((target) => target.tier === tier);\n  if (targets.length > 0) return { ...read, targets };\n  const tiers = [...new Set(read.targets.flatMap((target) => (target.tier ? [target.tier] : [])))].sort();\n  throw new Error(\n    `No target is tier ${tier} (${tiers.length > 0 ? `the list names tiers ${tiers.join(\", \")}` : \"the list names no tiers — add a tier column\"}).`,\n  );\n}\n"],"mappings":";;;;;;;;AAQA,SAAS,aAAa;AAStB,IAAM,mBAAmF;AAAA,EACvF,QAAQ;AAAA,EACR,SAAS;AAAA,EACT,KAAK;AAAA,EACL,eAAe;AAAA,EACf,gBAAgB;AAAA,EAChB,MAAM;AAAA,EACN,SAAS;AAAA,EACT,aAAa;AAAA,EACb,SAAS;AAAA,EACT,aAAa;AAAA,EACb,MAAM;AAAA,EACN,iBAAiB;AAAA,EACjB,aAAa;AAAA,EACb,YAAY;AACd;AAEA,IAAM,YAAY,CAAC,WAAmB,OAAO,YAAY,EAAE,QAAQ,YAAY,EAAE;AAEjF,SAAS,WAAW,MAA6C;AAC/D,QAAM,OAAO,MAAM,MAAM;AAAA,IACvB,KAAK;AAAA,IACL,SAAS;AAAA,IACT,WAAW,eAAe,IAAI;AAAA,IAC9B,kBAAkB;AAAA,IAClB,oBAAoB;AAAA,IACpB,MAAM;AAAA,EACR,CAAC;AACD,QAAM,UAAU,OAAO,KAAK,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,WAAW;AAC7D,UAAM,QAAQ,iBAAiB,UAAU,MAAM,CAAC;AAChD,WAAO,QAAQ,CAAC,CAAC,QAAQ,KAAK,CAAU,IAAI,CAAC;AAAA,EAC/C,CAAC;AACD,MAAI,CAAC,QAAQ,KAAK,CAAC,CAAC,EAAE,KAAK,MAAM,UAAU,QAAQ,GAAG;AACpD,UAAM,IAAI;AAAA,MACR,yCAAyC,OAAO,KAAK,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,IAAI,KAAK,SAAS;AAAA,IAC7F;AAAA,EACF;AACA,SAAO,KAAK,IAAI,CAAC,QAAQ;AACvB,UAAM,QAAgC,CAAC;AACvC,eAAW,CAAC,QAAQ,KAAK,KAAK,QAAS,OAAM,KAAK,MAAM,IAAI,MAAM,KAAK;AACvE,WAAO;AAAA,EACT,CAAC;AACH;AAEA,SAAS,YACP,MACwF;AACxF,QAAM,SAAkB,KAAK,MAAM,IAAI;AACvC,MAAI,CAAC,MAAM,QAAQ,MAAM,GAAG;AAC1B,UAAM,IAAI,MAAM,sGAA4F;AAAA,EAC9G;AACA,SAAO,OAAO;AAAA,IAAI,CAAC,SACjB,OAAO,SAAS,WAAW,EAAE,QAAQ,KAAK,IAAI,OAAO,SAAS,YAAY,SAAS,OAAO,OAAO,CAAC;AAAA,EACpG;AACF;AAGO,SAAS,gBAAgB,MAAc,MAA2B;AACvE,QAAM,UAAU,KAAK,YAAY,EAAE,SAAS,OAAO,IAAI,YAAY,IAAI,IAAI,WAAW,IAAI;AAC1F,SAAO,mBAAmB,OAAO;AACnC;AAGO,SAAS,cAAc,MAAmB,MAAuC;AACtF,MAAI,SAAS,OAAW,QAAO;AAC/B,QAAM,UAAU,KAAK,QAAQ,OAAO,CAAC,WAAW,OAAO,SAAS,IAAI;AACpE,MAAI,QAAQ,SAAS,EAAG,QAAO,EAAE,GAAG,MAAM,QAAQ;AAClD,QAAM,QAAQ,CAAC,GAAG,IAAI,IAAI,KAAK,QAAQ,QAAQ,CAAC,WAAY,OAAO,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC,CAAE,CAAC,CAAC,EAAE,KAAK;AACtG,QAAM,IAAI;AAAA,IACR,qBAAqB,IAAI,KAAK,MAAM,SAAS,IAAI,wBAAwB,MAAM,KAAK,IAAI,CAAC,KAAK,kDAA6C;AAAA,EAC7I;AACF;","names":[]}