@mx-cartographer/experiences 9.4.58 → 9.4.60

package/dist/insights-v2/components/shared/EntityLogo.d.ts

@@ -0,0 +1,26 @@
+import { Logo, LogoRef } from '../../../core';
+/**
+ * The V2 beat envelope (LargeTransactionV2 onward) sends an entity logo as an opaque guid instead
+ * of V1's named `institution_guid` / `merchant_guid` / `category_guid` fields. The entity is
+ * carried only by the guid's prefix, so this maps a guid back onto the named `Logo` shape the
+ * existing renderers (`SubHeader`, mxui logo components) already understand.
+ *
+ * An unrecognized prefix returns `undefined` rather than guessing: rendering a merchant logo for
+ * an institution guid would silently show the wrong image.
+ */
+export declare const logoFromEntityGuid: (guid?: string, alt?: string) => Logo | undefined;
+/**
+ * Resolves a V2 `LogoRef` (header or row) onto the named `Logo` shape. The one mapping both the
+ * header and the rows go through, so the two can never disagree about precedence:
+ *
+ * - `icon` becomes V1's `logo_name` / `logo_color` and wins over `guid`, as `logo_name` does in
+ *   `SubHeader`.
+ * - Otherwise `guid` resolves by prefix (`logoFromEntityGuid`). For an `MCH-` guid, a `CAT-`
+ *   `fallback_guid` becomes the merchant's `category_guid`: `MerchantLogo` draws that category as a
+ *   tile when the merchant image fails to load, and without it the tile is the Uncategorized icon.
+ *   Only a category fallback is applied, because a category tile is the only fallback
+ *   `MerchantLogo` has.
+ *
+ * `fallbackAlt` names the logo when the ref carries no `alt` (rows pass their `primary_text`).
+ */
+export declare const logoFromRef: (ref?: LogoRef, fallbackAlt?: string) => Logo | undefined;

package/dist/insights-v2/components/shared/EntityLogo.es.js

@@ -0,0 +1,33 @@
+var i = (t, o) => {
+  if (t) {
+    if (t.startsWith("INS-")) return {
+      institution_guid: t,
+      institution_name: o
+    };
+    if (t.startsWith("MCH-")) return {
+      merchant_guid: t,
+      merchant_name: o
+    };
+    if (t.startsWith("CAT-")) return {
+      category_guid: t,
+      category_name: o
+    };
+  }
+}, n = (t, o) => {
+  if (!t) return;
+  if (t.icon) return {
+    logo_color: t.color,
+    logo_name: t.icon
+  };
+  const r = i(t.guid, t.alt ?? o);
+  return r?.merchant_guid && t.fallback_guid?.startsWith("CAT-") ? {
+    ...r,
+    category_guid: t.fallback_guid
+  } : r;
+};
+export {
+  i as logoFromEntityGuid,
+  n as logoFromRef
+};
+
+//# sourceMappingURL=EntityLogo.es.js.map

package/dist/insights-v2/components/shared/EntityLogo.es.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EntityLogo.es.js","names":[],"sources":["../../../../src/insights-v2/components/shared/EntityLogo.tsx"],"sourcesContent":["import type { Logo, LogoRef } from '../../../core'\n\n/**\n * The V2 beat envelope (LargeTransactionV2 onward) sends an entity logo as an opaque guid instead\n * of V1's named `institution_guid` / `merchant_guid` / `category_guid` fields. The entity is\n * carried only by the guid's prefix, so this maps a guid back onto the named `Logo` shape the\n * existing renderers (`SubHeader`, mxui logo components) already understand.\n *\n * An unrecognized prefix returns `undefined` rather than guessing: rendering a merchant logo for\n * an institution guid would silently show the wrong image.\n */\nexport const logoFromEntityGuid = (guid?: string, alt?: string): Logo | undefined => {\n  if (!guid) return undefined\n\n  if (guid.startsWith('INS-')) {\n    return { institution_guid: guid, institution_name: alt }\n  }\n\n  if (guid.startsWith('MCH-')) {\n    return { merchant_guid: guid, merchant_name: alt }\n  }\n\n  if (guid.startsWith('CAT-')) {\n    return { category_guid: guid, category_name: alt }\n  }\n\n  return undefined\n}\n\n/**\n * Resolves a V2 `LogoRef` (header or row) onto the named `Logo` shape. The one mapping both the\n * header and the rows go through, so the two can never disagree about precedence:\n *\n * - `icon` becomes V1's `logo_name` / `logo_color` and wins over `guid`, as `logo_name` does in\n *   `SubHeader`.\n * - Otherwise `guid` resolves by prefix (`logoFromEntityGuid`). For an `MCH-` guid, a `CAT-`\n *   `fallback_guid` becomes the merchant's `category_guid`: `MerchantLogo` draws that category as a\n *   tile when the merchant image fails to load, and without it the tile is the Uncategorized icon.\n *   Only a category fallback is applied, because a category tile is the only fallback\n *   `MerchantLogo` has.\n *\n * `fallbackAlt` names the logo when the ref carries no `alt` (rows pass their `primary_text`).\n */\nexport const logoFromRef = (ref?: LogoRef, fallbackAlt?: string): Logo | undefined => {\n  if (!ref) return undefined\n\n  if (ref.icon) {\n    return { logo_color: ref.color, logo_name: ref.icon }\n  }\n\n  const logo = logoFromEntityGuid(ref.guid, ref.alt ?? fallbackAlt)\n\n  if (logo?.merchant_guid && ref.fallback_guid?.startsWith('CAT-')) {\n    return { ...logo, category_guid: ref.fallback_guid }\n  }\n\n  return logo\n}\n"],"mappings":"AAWA,IAAa,IAAA,CAAsB,GAAe,MAAmC;AACnF,MAAK,GAEL;AAAA,QAAI,EAAK,WAAW,MAAM,EACxB,QAAO;AAAA,MAAE,kBAAkB;AAAA,MAAM,kBAAkB;AAAA,IAAI;AAGzD,QAAI,EAAK,WAAW,MAAM,EACxB,QAAO;AAAA,MAAE,eAAe;AAAA,MAAM,eAAe;AAAA,IAAI;AAGnD,QAAI,EAAK,WAAW,MAAM,EACxB,QAAO;AAAA,MAAE,eAAe;AAAA,MAAM,eAAe;AAAA,IAAI;AAAA;AAIrD,GAgBa,IAAA,CAAe,GAAe,MAA2C;AACpF,MAAI,CAAC,EAAK;AAEV,MAAI,EAAI,KACN,QAAO;AAAA,IAAE,YAAY,EAAI;AAAA,IAAO,WAAW,EAAI;AAAA,EAAK;AAGtD,QAAM,IAAO,EAAmB,EAAI,MAAM,EAAI,OAAO,CAAW;AAEhE,SAAI,GAAM,iBAAiB,EAAI,eAAe,WAAW,MAAM,IACtD;AAAA,IAAE,GAAG;AAAA,IAAM,eAAe,EAAI;AAAA,EAAc,IAG9C;AACT"}

package/dist/insights-v2/index.d.ts

@@ -1,8 +1,14 @@
 export * from './blocks';
 export { default as AccountHeroCard } from './components/AccountHeroCard';
 export { default as AmountPill } from './components/AmountPill';
+export { default as BadgedTile } from './components/BadgedTile';
+export { default as StatusBadge, type StatusTone } from './components/StatusBadge';
 export { default as DesignateEmergencySavingsCard, type DesignateEmergencySavingsOption, } from './components/DesignateEmergencySavingsCard';
 export { default as BaseLayout } from './components/BaseLayout';
+export { default as CompactInsightCard, type CompactInsightCardProps, } from './components/CompactInsightCard';
+export { default as InsightErrorCard, type InsightErrorCardProps, } from './components/InsightErrorCard';
+export { default as LogoFromGuid, isLogoGuid, type LogoFromGuidProps, } from './components/LogoFromGuid';
+export { resolveInsightRender, type InsightRender } from './resolveInsightRender';
 export { default as ErrorCard, type ErrorCardProps } from './components/ErrorCard';
 export { default as LoadingCard } from './components/LoadingCard';
 export { default as StatusMessageCard } from './components/StatusMessageCard';

package/dist/insights-v2/index.es.js

@@ -1,83 +1,97 @@
-import { BAR_CHART_VARIANTS as o, barChartVariant as m, buildChartData as t, buildDataSeries as i } from "./blocks/ChartBlocks/BarchartBlock/utils.es.js";
-import { BarchartBlock as p } from "./blocks/ChartBlocks/BarchartBlock/BarchartBlock.es.js";
-import { DoubleBarChartBlock as e } from "./blocks/ChartBlocks/DoubleBarChartBlock/DoubleBarChartBlock.es.js";
-import c from "./blocks/ChartBlocks/StepChartBlock/StepChartBlock.es.js";
-import l from "./blocks/ChartBlocks/DonutChartBlock/DonutChartBlock.es.js";
-import d from "./blocks/ChartBlocks/DoubleProgressBarBlock/DoubleProgressBarBlock.es.js";
-import B from "./blocks/ComponentBlocks/AccountBlock/AccountBlock.es.js";
-import k from "./components/TransferLogoCard.es.js";
-import S from "./blocks/ComponentBlocks/AccountSwitchBlock/AccountSwitchBlock.es.js";
-import { BudgetBlock as b } from "./blocks/ComponentBlocks/BudgetBlock/BudgetBlock.es.js";
-import L from "./components/SaveAnExtraCard.es.js";
-import v from "./blocks/ComponentBlocks/SaveExtraBlock/SaveExtraBlock.es.js";
-import I from "./components/InsightTransactionRow.es.js";
-import y from "./components/TransactionListCard.es.js";
-import { CategoryTransactionsBlock as M } from "./blocks/ComponentBlocks/TransactionBlock/TransactionBlock.es.js";
-import { SVGImageBlock as R } from "./blocks/ImageBlocks/SVGImageBlock/SVGImageBlock.es.js";
-import x from "./components/AccountHeroCard.es.js";
-import F from "./components/AmountPill.es.js";
-import G from "./components/DesignateEmergencySavingsCard.es.js";
-import { useBeatActions as U } from "./beatActions.es.js";
-import { OverflowMenu as q } from "./components/OverflowMenu.es.js";
-import { InsightOptionsMenu as J } from "./components/InsightOptionsMenu.es.js";
-import { FeedbackBar as Q } from "./components/FeedbackBar.es.js";
-import X from "./components/FeedbackDialog.es.js";
-import { DismissInsightDialog as Z } from "./components/DismissInsightDialog.es.js";
-import { HiddenConfirmationCard as rr } from "./components/HiddenConfirmationCard.es.js";
-import { ErrorCard as mr } from "./components/ErrorCard.es.js";
-import { LoadingCard as ir } from "./components/LoadingCard.es.js";
-import { ObsolesceBanner as pr } from "./components/ObsolesceBanner.es.js";
-import er from "./components/BaseLayout.es.js";
-import cr from "./components/StatusMessageCard.es.js";
-import lr from "./components/LogoTile.es.js";
-import dr from "./components/LogoClusterCard.es.js";
-import Br from "./components/MerchantHighlightCard.es.js";
-import kr from "./components/P2PLogoStack.es.js";
-import Sr from "./components/SavingsOpportunityCard.es.js";
-import br from "./components/StatusPill.es.js";
-import Lr from "./components/SubscriptionHeroCard.es.js";
-import vr from "./components/UpcomingBillCard.es.js";
+import o from "./components/StatusPill.es.js";
+import { resolveInsightRender as t } from "./resolveInsightRender.es.js";
+import { useBeatActions as a } from "./beatActions.es.js";
+import f from "./components/BadgedTile.es.js";
+import { OverflowMenu as n } from "./components/OverflowMenu.es.js";
+import { InsightOptionsMenu as c } from "./components/InsightOptionsMenu.es.js";
+import d, { isLogoGuid as g } from "./components/LogoFromGuid.es.js";
+import B from "./components/StatusBadge.es.js";
+import h from "./components/CompactInsightCard.es.js";
+import S from "./components/InsightErrorCard.es.js";
+import { BAR_CHART_VARIANTS as b, barChartVariant as D, buildChartData as L, buildDataSeries as T } from "./blocks/ChartBlocks/BarchartBlock/utils.es.js";
+import { BarchartBlock as v } from "./blocks/ChartBlocks/BarchartBlock/BarchartBlock.es.js";
+import { DoubleBarChartBlock as H } from "./blocks/ChartBlocks/DoubleBarChartBlock/DoubleBarChartBlock.es.js";
+import R from "./blocks/ChartBlocks/StepChartBlock/StepChartBlock.es.js";
+import O from "./blocks/ChartBlocks/DonutChartBlock/DonutChartBlock.es.js";
+import w from "./blocks/ChartBlocks/DoubleProgressBarBlock/DoubleProgressBarBlock.es.js";
+import y from "./blocks/ComponentBlocks/AccountBlock/AccountBlock.es.js";
+import G from "./components/TransferLogoCard.es.js";
+import N from "./blocks/ComponentBlocks/AccountSwitchBlock/AccountSwitchBlock.es.js";
+import { BudgetBlock as j } from "./blocks/ComponentBlocks/BudgetBlock/BudgetBlock.es.js";
+import z from "./components/SaveAnExtraCard.es.js";
+import K from "./blocks/ComponentBlocks/SaveExtraBlock/SaveExtraBlock.es.js";
+import W from "./components/InsightTransactionRow.es.js";
+import Y from "./components/TransactionListCard.es.js";
+import { TransactionBlock as $, TransactionBlockVariant as rr } from "./blocks/ComponentBlocks/TransactionBlock/TransactionBlock.es.js";
+import { SVGImageBlock as mr } from "./blocks/ImageBlocks/SVGImageBlock/SVGImageBlock.es.js";
+import ir from "./components/AccountHeroCard.es.js";
+import pr from "./components/AmountPill.es.js";
+import er from "./components/DesignateEmergencySavingsCard.es.js";
+import { FeedbackBar as sr } from "./components/FeedbackBar.es.js";
+import lr from "./components/FeedbackDialog.es.js";
+import { DismissInsightDialog as gr } from "./components/DismissInsightDialog.es.js";
+import { HiddenConfirmationCard as Br } from "./components/HiddenConfirmationCard.es.js";
+import { ErrorCard as hr } from "./components/ErrorCard.es.js";
+import { LoadingCard as Sr } from "./components/LoadingCard.es.js";
+import { ObsolesceBanner as br } from "./components/ObsolesceBanner.es.js";
+import Lr from "./components/BaseLayout.es.js";
+import Ir from "./components/StatusMessageCard.es.js";
+import Er from "./components/LogoTile.es.js";
+import Pr from "./components/LogoClusterCard.es.js";
+import Mr from "./components/MerchantHighlightCard.es.js";
+import Vr from "./components/P2PLogoStack.es.js";
+import xr from "./components/SavingsOpportunityCard.es.js";
+import Fr from "./components/SubscriptionHeroCard.es.js";
+import _r from "./components/UpcomingBillCard.es.js";
 export {
-  B as AccountBlock,
-  x as AccountHeroCard,
-  S as AccountSwitchBlock,
-  F as AmountPill,
-  o as BAR_CHART_VARIANTS,
-  p as BarchartBlock,
-  er as BaseLayout,
-  b as BudgetBlock,
-  M as CategoryTransactionsBlock,
-  G as DesignateEmergencySavingsCard,
-  Z as DismissInsightDialog,
-  l as DonutChartBlock,
-  e as DoubleBarChartBlock,
-  d as DoubleProgressBarBlock,
-  mr as ErrorCard,
-  Q as FeedbackBar,
-  X as FeedbackDialog,
-  rr as HiddenConfirmationCard,
-  J as InsightOptionsMenu,
-  I as InsightTransactionRow,
-  ir as LoadingCard,
-  dr as LogoClusterCard,
-  lr as LogoTile,
-  Br as MerchantHighlightCard,
-  pr as ObsolesceBanner,
-  q as OverflowMenu,
-  kr as P2PLogoStack,
-  R as SVGImageBlock,
-  L as SaveAnExtraCard,
-  v as SaveExtraBlock,
-  Sr as SavingsOpportunityCard,
-  cr as StatusMessageCard,
-  br as StatusPill,
-  c as StepChartBlock,
-  Lr as SubscriptionHeroCard,
-  y as TransactionListCard,
-  k as TransferLogoCard,
-  vr as UpcomingBillCard,
-  m as barChartVariant,
-  t as buildChartData,
-  i as buildDataSeries,
-  U as useBeatActions
+  y as AccountBlock,
+  ir as AccountHeroCard,
+  N as AccountSwitchBlock,
+  pr as AmountPill,
+  b as BAR_CHART_VARIANTS,
+  f as BadgedTile,
+  v as BarchartBlock,
+  Lr as BaseLayout,
+  j as BudgetBlock,
+  h as CompactInsightCard,
+  er as DesignateEmergencySavingsCard,
+  gr as DismissInsightDialog,
+  O as DonutChartBlock,
+  H as DoubleBarChartBlock,
+  w as DoubleProgressBarBlock,
+  hr as ErrorCard,
+  sr as FeedbackBar,
+  lr as FeedbackDialog,
+  Br as HiddenConfirmationCard,
+  S as InsightErrorCard,
+  c as InsightOptionsMenu,
+  W as InsightTransactionRow,
+  Sr as LoadingCard,
+  Pr as LogoClusterCard,
+  d as LogoFromGuid,
+  Er as LogoTile,
+  Mr as MerchantHighlightCard,
+  br as ObsolesceBanner,
+  n as OverflowMenu,
+  Vr as P2PLogoStack,
+  mr as SVGImageBlock,
+  z as SaveAnExtraCard,
+  K as SaveExtraBlock,
+  xr as SavingsOpportunityCard,
+  B as StatusBadge,
+  Ir as StatusMessageCard,
+  o as StatusPill,
+  R as StepChartBlock,
+  Fr as SubscriptionHeroCard,
+  $ as TransactionBlock,
+  rr as TransactionBlockVariant,
+  Y as TransactionListCard,
+  G as TransferLogoCard,
+  _r as UpcomingBillCard,
+  D as barChartVariant,
+  L as buildChartData,
+  T as buildDataSeries,
+  g as isLogoGuid,
+  t as resolveInsightRender,
+  a as useBeatActions
 };

package/dist/insights-v2/mappings/actionBlocksKey.d.ts

@@ -3,4 +3,5 @@ export declare const actionBlocksKey: {
     MAKE_TRANSFER_ACTION_BLOCK: string;
     TRANSCATION_HISTORY_ACTION_BLOCK: string;
     TRANSACTION_DETAILS_ACTION_BLOCK: string;
+    CONTACT_SUPPORT_ACTION_BLOCK: string;
 };

package/dist/insights-v2/mappings/actionBlocksKey.es.js

@@ -2,7 +2,8 @@ var _ = {
   PLACEHOLDER_ACTION_BLOCK: "PlaceholderActionBlock",
   MAKE_TRANSFER_ACTION_BLOCK: "make_transfer",
   TRANSCATION_HISTORY_ACTION_BLOCK: "transaction_history_block",
-  TRANSACTION_DETAILS_ACTION_BLOCK: "transaction_details"
+  TRANSACTION_DETAILS_ACTION_BLOCK: "transaction_details_block",
+  CONTACT_SUPPORT_ACTION_BLOCK: "contact_support_block"
 };
 export {
   _ as actionBlocksKey

package/dist/insights-v2/mappings/actionBlocksKey.es.js.map

@@ -1 +1 @@
-{"version":3,"file":"actionBlocksKey.es.js","names":[],"sources":["../../../src/insights-v2/mappings/actionBlocksKey.ts"],"sourcesContent":["// Keys for the drawer drilldown registry in `blocks.ts`, extracted into their own module.\n//\n// Why: chart blocks (e.g. BarchartBlock, DoubleBarChartBlock) need\n// `TRANSCATION_HISTORY_ACTION_BLOCK` to tag a chart bar's drilldown context, but they are\n// themselves re-exported through `../blocks` -> `mappings/blocks.ts` imports from that same\n// barrel to build its `blocks` registry. Importing the key straight from `mappings/blocks.ts`\n// closed that loop into a circular import: evaluating `mappings/blocks.ts` pulled in the\n// `blocks` barrel, which (before it got to `ComponentBlocks`/`AccountBlock`) loaded\n// `BarchartBlock`, which imported back into the still-initializing `mappings/blocks.ts` —\n// tripping a \"Cannot access 'AccountBlock' before initialization\" TDZ error in Storybook/Vite.\n//\n// Keeping the keys here (no dependency on `mappings/blocks.ts`) lets chart blocks reference\n// them without re-entering that module.\nexport const actionBlocksKey = {\n  PLACEHOLDER_ACTION_BLOCK: 'PlaceholderActionBlock',\n  MAKE_TRANSFER_ACTION_BLOCK: 'make_transfer',\n  TRANSCATION_HISTORY_ACTION_BLOCK: 'transaction_history_block',\n  TRANSACTION_DETAILS_ACTION_BLOCK: 'transaction_details',\n}\n"],"mappings":"AAaA,IAAa,IAAkB;AAAA,EAC7B,0BAA0B;AAAA,EAC1B,4BAA4B;AAAA,EAC5B,kCAAkC;AAAA,EAClC,kCAAkC;AACpC"}
+{"version":3,"file":"actionBlocksKey.es.js","names":[],"sources":["../../../src/insights-v2/mappings/actionBlocksKey.ts"],"sourcesContent":["// Keys for the drawer drilldown registry in `blocks.ts`, extracted into their own module.\n//\n// Why: chart blocks (e.g. BarchartBlock, DoubleBarChartBlock) need\n// `TRANSCATION_HISTORY_ACTION_BLOCK` to tag a chart bar's drilldown context, but they are\n// themselves re-exported through `../blocks` -> `mappings/blocks.ts` imports from that same\n// barrel to build its `blocks` registry. Importing the key straight from `mappings/blocks.ts`\n// closed that loop into a circular import: evaluating `mappings/blocks.ts` pulled in the\n// `blocks` barrel, which (before it got to `ComponentBlocks`/`AccountBlock`) loaded\n// `BarchartBlock`, which imported back into the still-initializing `mappings/blocks.ts` —\n// tripping a \"Cannot access 'AccountBlock' before initialization\" TDZ error in Storybook/Vite.\n//\n// Keeping the keys here (no dependency on `mappings/blocks.ts`) lets chart blocks reference\n// them without re-entering that module.\n//\n// Names follow ditto: its registry ends every CTA block in `_block` and the V2 envelope copies those\n// names verbatim (`transaction_details_block`, `contact_support_block`). `make_transfer` is a legacy\n// name that stays as an alias until the last legacy payload is gone.\nexport const actionBlocksKey = {\n  PLACEHOLDER_ACTION_BLOCK: 'PlaceholderActionBlock',\n  MAKE_TRANSFER_ACTION_BLOCK: 'make_transfer',\n  TRANSCATION_HISTORY_ACTION_BLOCK: 'transaction_history_block',\n  TRANSACTION_DETAILS_ACTION_BLOCK: 'transaction_details_block',\n  CONTACT_SUPPORT_ACTION_BLOCK: 'contact_support_block',\n}\n"],"mappings":"AAiBA,IAAa,IAAkB;AAAA,EAC7B,0BAA0B;AAAA,EAC1B,4BAA4B;AAAA,EAC5B,kCAAkC;AAAA,EAClC,kCAAkC;AAAA,EAClC,8BAA8B;AAChC"}

package/dist/insights-v2/mappings/blocks.es.js

@@ -1,70 +1,76 @@
+import { ContactSupportActionBlock as a } from "../actionBlocks/ContactSupportActionBlock.es.js";
 import { actionBlocksKey as o } from "./actionBlocksKey.es.js";
-import { BarchartBlock as a } from "../blocks/ChartBlocks/BarchartBlock/BarchartBlock.es.js";
-import { DoubleBarChartBlock as c } from "../blocks/ChartBlocks/DoubleBarChartBlock/DoubleBarChartBlock.es.js";
-import l from "../blocks/ChartBlocks/StepChartBlock/StepChartBlock.es.js";
+import { BarchartBlock as c } from "../blocks/ChartBlocks/BarchartBlock/BarchartBlock.es.js";
+import { DoubleBarChartBlock as l } from "../blocks/ChartBlocks/DoubleBarChartBlock/DoubleBarChartBlock.es.js";
+import i from "../blocks/ChartBlocks/StepChartBlock/StepChartBlock.es.js";
 import m from "../blocks/ChartBlocks/DonutChartBlock/DonutChartBlock.es.js";
-import i from "../blocks/ChartBlocks/DoubleProgressBarBlock/DoubleProgressBarBlock.es.js";
-import n from "../blocks/ComponentBlocks/AccountBlock/AccountBlock.es.js";
+import n from "../blocks/ChartBlocks/DoubleProgressBarBlock/DoubleProgressBarBlock.es.js";
+import p from "../blocks/ComponentBlocks/AccountBlock/AccountBlock.es.js";
 import _ from "../blocks/ComponentBlocks/AccountSwitchBlock/AccountSwitchBlock.es.js";
 import { BudgetBlock as k } from "../blocks/ComponentBlocks/BudgetBlock/BudgetBlock.es.js";
-import p from "../blocks/ComponentBlocks/SaveExtraBlock/SaveExtraBlock.es.js";
-import { CategoryTransactionsBlock as s } from "../blocks/ComponentBlocks/TransactionBlock/TransactionBlock.es.js";
-import B from "../blocks/ImageBlocks/ImageBlock.es.js";
+import s from "../blocks/ComponentBlocks/SaveExtraBlock/SaveExtraBlock.es.js";
+import { TransactionBlock as B } from "../blocks/ComponentBlocks/TransactionBlock/TransactionBlock.es.js";
+import C from "../blocks/ImageBlocks/ImageBlock.es.js";
 import { SVGImageBlock as f } from "../blocks/ImageBlocks/SVGImageBlock/SVGImageBlock.es.js";
-import { PlaceholderActionBlock as b } from "../actionBlocks/PlaceholderActionBlock.es.js";
-import { getMakeTransferDrawerTitle as C } from "../actionBlocks/MakeTransferActionBlock/layout.es.js";
-import { MakeTransferActionBlockLayer as u } from "../actionBlocks/MakeTransferActionBlock/MakeTransferActionBlockLayer.es.js";
-import { getDrawerHeaderTitle as T } from "../actionBlocks/TransactionHistoryBlock/utils.es.js";
-import { TransactionDetailsBlock as A } from "../actionBlocks/TransactionDetailsBlock/TransactionDetailsBlock.es.js";
-import { useTransactionDetailsPrepare as O } from "../actionBlocks/TransactionDetailsBlock/useTransactionDetailsPrepare.es.js";
-import { TransactionHistoryBlock as g } from "../actionBlocks/TransactionHistoryBlock/TransactionHistoryBlock.es.js";
-var r = (t) => {
-}, h = /* @__PURE__ */ new Set([
+import { PlaceholderActionBlock as u } from "../actionBlocks/PlaceholderActionBlock.es.js";
+import { getMakeTransferDrawerTitle as T } from "../actionBlocks/MakeTransferActionBlock/layout.es.js";
+import { MakeTransferActionBlockLayer as b } from "../actionBlocks/MakeTransferActionBlock/MakeTransferActionBlockLayer.es.js";
+import { getDrawerHeaderTitle as A } from "../actionBlocks/TransactionHistoryBlock/utils.es.js";
+import { TransactionDetailsBlock as O } from "../actionBlocks/TransactionDetailsBlock/TransactionDetailsBlock.es.js";
+import { useTransactionDetailsPrepare as h } from "../actionBlocks/TransactionDetailsBlock/useTransactionDetailsPrepare.es.js";
+import { TransactionHistoryBlock as L } from "../actionBlocks/TransactionHistoryBlock/TransactionHistoryBlock.es.js";
+var t = (e) => {
+}, N = /* @__PURE__ */ new Set([
   "",
   "null",
   "undefined"
-]), U = (t) => {
-  const e = t?.trim().toLowerCase();
-  return !!e && !h.has(e);
-}, Y = {
+]), Y = (e) => {
+  const r = e?.trim().toLowerCase();
+  return !!r && !N.has(r);
+}, j = {
   [o.PLACEHOLDER_ACTION_BLOCK]: {
-    Component: b,
-    usePrepare: r,
+    Component: u,
+    usePrepare: t,
     title: () => "Action Block Layer Drilldown"
   },
   [o.MAKE_TRANSFER_ACTION_BLOCK]: {
-    Component: u,
-    usePrepare: r,
-    title: C
+    Component: b,
+    usePrepare: t,
+    title: T
   },
   [o.TRANSCATION_HISTORY_ACTION_BLOCK]: {
-    Component: g,
-    usePrepare: r,
-    title: T
+    Component: L,
+    usePrepare: t,
+    title: A
   },
   [o.TRANSACTION_DETAILS_ACTION_BLOCK]: {
-    Component: A,
-    usePrepare: O,
+    Component: O,
+    usePrepare: h,
     title: () => "Transaction Details"
+  },
+  [o.CONTACT_SUPPORT_ACTION_BLOCK]: {
+    Component: a,
+    usePrepare: t,
+    title: (e, r) => r.help?.request_support ?? ""
   }
-}, j = {
-  account_block: n,
+}, J = {
+  account_block: p,
   account_switch_block: _,
-  bar_chart_block: a,
+  bar_chart_block: c,
   budget_block: k,
-  category_transactions_block: s,
   donut_chart_block: m,
-  double_bar_chart_block: c,
-  double_progress_bar_block: i,
-  image_block: B,
-  save_extra_block: p,
-  step_chart_block: l,
-  svg_image_block: f
+  double_bar_chart_block: l,
+  double_progress_bar_block: n,
+  image_block: C,
+  save_extra_block: s,
+  step_chart_block: i,
+  svg_image_block: f,
+  transaction_block: B
 };
 export {
-  Y as actionBlocks,
-  j as blocks,
-  U as hasDrawerBlock
+  j as actionBlocks,
+  J as blocks,
+  Y as hasDrawerBlock
 };
 
 //# sourceMappingURL=blocks.es.js.map

package/dist/insights-v2/mappings/blocks.es.js.map

@@ -1 +1 @@
-{"version":3,"file":"blocks.es.js","names":[],"sources":["../../../src/insights-v2/mappings/blocks.ts"],"sourcesContent":["import {\n  AccountBlock,\n  AccountSwitchBlock,\n  BarchartBlock,\n  BudgetBlock,\n  CategoryTransactionsBlock,\n  DonutChartBlock,\n  DoubleBarChartBlock,\n  DoubleProgressBarBlock,\n  SaveExtraBlock,\n  SVGImageBlock,\n} from '../blocks'\nimport StepChartBlock from '../blocks/ChartBlocks/StepChartBlock'\nimport ImageBlock from '../blocks/ImageBlocks/ImageBlock'\n\nimport type { Beat, GlobalCopy, InsightsPayload } from '../../core'\nimport { PlaceholderActionBlock } from '../actionBlocks/PlaceholderActionBlock'\nimport { MakeTransferActionBlockLayer } from '../actionBlocks/MakeTransferActionBlock/MakeTransferActionBlockLayer'\nimport { getMakeTransferDrawerTitle } from '../actionBlocks/MakeTransferActionBlock/layout'\nimport { TransactionHistoryBlock } from '../actionBlocks/TransactionHistoryBlock/TransactionHistoryBlock'\nimport { getDrawerHeaderTitle } from '../actionBlocks/TransactionHistoryBlock/utils'\nimport {\n  TransactionDetailsBlock,\n  useTransactionDetailsPrepare,\n} from '../actionBlocks/TransactionDetailsBlock'\n// Keys live in ./actionBlocksKey (imported directly by chart blocks/tests too) to avoid a\n// circular import between this module and the chart blocks — see that file for details.\nimport { actionBlocksKey } from './actionBlocksKey'\n\n// Drilldown indexes are not passed down: action blocks read them from\n// InsightsV2Store (useInsightsV2Store().actionDrawer).\nexport interface ActionBlockProps {\n  beat: Beat\n}\n\nconst noop = (_: ActionBlockProps) => {}\n\n// A CTA opens a drawer only when it carries a real `block`. The backend may send\n// an empty/absent block (or the literal strings \"null\"/\"undefined\") for CTAs\n// that trigger something else (e.g. a postMessage) instead of a drilldown.\nconst NON_BLOCK_VALUES = new Set(['', 'null', 'undefined'])\nexport const hasDrawerBlock = (block?: string | null): boolean => {\n  const normalized = block?.trim().toLowerCase()\n  return !!normalized && !NON_BLOCK_VALUES.has(normalized)\n}\n\nexport interface ActionBlockEntry {\n  Component: React.ComponentType<ActionBlockProps>\n  usePrepare: (props: ActionBlockProps) => void // required; default to noop in each entry\n  // Resolves the drawer title from the clicked CTA's variant + copy (e.g.\n  // MakeTransfer reads its variant title from layout.ts). Falls back to the CTA label.\n  title?: (variant: string | null | undefined, copy: GlobalCopy) => string\n}\n\n// Registry of drawer drilldowns, keyed by the `block` name the backend sends\n// on a beat's CTA. To add one: create a component taking ActionBlockProps,\n// read the clicked indexes from useInsightsV2Store().actionDrawer, and\n// register it here. Add\n// `usePrepare` when the block needs to load data before rendering.\n\nexport const actionBlocks = {\n  [actionBlocksKey.PLACEHOLDER_ACTION_BLOCK]: {\n    Component: PlaceholderActionBlock,\n    usePrepare: noop,\n    title: () => 'Action Block Layer Drilldown',\n  },\n  [actionBlocksKey.MAKE_TRANSFER_ACTION_BLOCK]: {\n    Component: MakeTransferActionBlockLayer,\n    usePrepare: noop,\n    title: getMakeTransferDrawerTitle,\n  },\n  [actionBlocksKey.TRANSCATION_HISTORY_ACTION_BLOCK]: {\n    Component: TransactionHistoryBlock,\n    usePrepare: noop,\n    title: getDrawerHeaderTitle,\n  },\n  [actionBlocksKey.TRANSACTION_DETAILS_ACTION_BLOCK]: {\n    Component: TransactionDetailsBlock,\n    usePrepare: useTransactionDetailsPrepare,\n    title: () => 'Transaction Details',\n  },\n} as Record<string, ActionBlockEntry>\n\nexport const blocks = {\n  account_block: AccountBlock,\n  account_switch_block: AccountSwitchBlock,\n  bar_chart_block: BarchartBlock,\n  budget_block: BudgetBlock,\n  category_transactions_block: CategoryTransactionsBlock,\n  donut_chart_block: DonutChartBlock,\n  double_bar_chart_block: DoubleBarChartBlock,\n  double_progress_bar_block: DoubleProgressBarBlock,\n  image_block: ImageBlock,\n  save_extra_block: SaveExtraBlock,\n  step_chart_block: StepChartBlock,\n  svg_image_block: SVGImageBlock,\n} as Record<string, React.ComponentType<{ payload: InsightsPayload; beatGuid?: string }>>\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAmCA,IAAM,IAAA,CAAQ,MAAwB;AAAC,GAKjC,IAAmB,oBAAI,IAAI;AAAA,EAAC;AAAA,EAAI;AAAA,EAAQ;AAAW,CAAC,GAC7C,IAAA,CAAkB,MAAmC;AAChE,QAAM,IAAa,GAAO,KAAK,EAAE,YAAY;AAC7C,SAAO,CAAC,CAAC,KAAc,CAAC,EAAiB,IAAI,CAAU;AACzD,GAgBa,IAAe;AAAA,EACzB,CAAA,EAAgB,wBAAA,GAA2B;AAAA,IAC1C,WAAW;AAAA,IACX,YAAY;AAAA,IACZ,OAAA,MAAa;AAAA,EACf;AAAA,EACC,CAAA,EAAgB,0BAAA,GAA6B;AAAA,IAC5C,WAAW;AAAA,IACX,YAAY;AAAA,IACZ,OAAO;AAAA,EACT;AAAA,EACC,CAAA,EAAgB,gCAAA,GAAmC;AAAA,IAClD,WAAW;AAAA,IACX,YAAY;AAAA,IACZ,OAAO;AAAA,EACT;AAAA,EACC,CAAA,EAAgB,gCAAA,GAAmC;AAAA,IAClD,WAAW;AAAA,IACX,YAAY;AAAA,IACZ,OAAA,MAAa;AAAA,EACf;AACF,GAEa,IAAS;AAAA,EACpB,eAAe;AAAA,EACf,sBAAsB;AAAA,EACtB,iBAAiB;AAAA,EACjB,cAAc;AAAA,EACd,6BAA6B;AAAA,EAC7B,mBAAmB;AAAA,EACnB,wBAAwB;AAAA,EACxB,2BAA2B;AAAA,EAC3B,aAAa;AAAA,EACb,kBAAkB;AAAA,EAClB,kBAAkB;AAAA,EAClB,iBAAiB;AACnB"}
+{"version":3,"file":"blocks.es.js","names":[],"sources":["../../../src/insights-v2/mappings/blocks.ts"],"sourcesContent":["import {\n  AccountBlock,\n  AccountSwitchBlock,\n  BarchartBlock,\n  BudgetBlock,\n  DonutChartBlock,\n  DoubleBarChartBlock,\n  DoubleProgressBarBlock,\n  SaveExtraBlock,\n  SVGImageBlock,\n  TransactionBlock,\n} from '../blocks'\nimport StepChartBlock from '../blocks/ChartBlocks/StepChartBlock'\nimport ImageBlock from '../blocks/ImageBlocks/ImageBlock'\n\nimport type { Beat, GlobalCopy, InsightsPayload } from '../../core'\nimport { ContactSupportActionBlock } from '../actionBlocks/ContactSupportActionBlock'\nimport { PlaceholderActionBlock } from '../actionBlocks/PlaceholderActionBlock'\nimport { MakeTransferActionBlockLayer } from '../actionBlocks/MakeTransferActionBlock/MakeTransferActionBlockLayer'\nimport { getMakeTransferDrawerTitle } from '../actionBlocks/MakeTransferActionBlock/layout'\nimport { TransactionHistoryBlock } from '../actionBlocks/TransactionHistoryBlock/TransactionHistoryBlock'\nimport { getDrawerHeaderTitle } from '../actionBlocks/TransactionHistoryBlock/utils'\nimport {\n  TransactionDetailsBlock,\n  useTransactionDetailsPrepare,\n} from '../actionBlocks/TransactionDetailsBlock'\n// Keys live in ./actionBlocksKey (imported directly by chart blocks/tests too) to avoid a\n// circular import between this module and the chart blocks — see that file for details.\nimport { actionBlocksKey } from './actionBlocksKey'\n\n// Drilldown indexes are not passed down: action blocks read them from\n// InsightsV2Store (useInsightsV2Store().actionDrawer).\nexport interface ActionBlockProps {\n  beat: Beat\n}\n\nconst noop = (_: ActionBlockProps) => {}\n\n// A CTA opens a drawer only when it carries a real `block`. The backend may send\n// an empty/absent block (or the literal strings \"null\"/\"undefined\") for CTAs\n// that trigger something else (e.g. a postMessage) instead of a drilldown.\nconst NON_BLOCK_VALUES = new Set(['', 'null', 'undefined'])\nexport const hasDrawerBlock = (block?: string | null): boolean => {\n  const normalized = block?.trim().toLowerCase()\n  return !!normalized && !NON_BLOCK_VALUES.has(normalized)\n}\n\nexport interface ActionBlockEntry {\n  Component: React.ComponentType<ActionBlockProps>\n  usePrepare: (props: ActionBlockProps) => void // required; default to noop in each entry\n  // Resolves the drawer title from the clicked CTA's variant + copy (e.g.\n  // MakeTransfer reads its variant title from layout.ts). Falls back to the CTA label.\n  title?: (variant: string | null | undefined, copy: GlobalCopy) => string\n}\n\n// Registry of drawer drilldowns, keyed by the `block` name the backend sends\n// on a beat's CTA. To add one: create a component taking ActionBlockProps,\n// read the clicked indexes from useInsightsV2Store().actionDrawer, and\n// register it here. Add\n// `usePrepare` when the block needs to load data before rendering.\n\nexport const actionBlocks = {\n  [actionBlocksKey.PLACEHOLDER_ACTION_BLOCK]: {\n    Component: PlaceholderActionBlock,\n    usePrepare: noop,\n    title: () => 'Action Block Layer Drilldown',\n  },\n  [actionBlocksKey.MAKE_TRANSFER_ACTION_BLOCK]: {\n    Component: MakeTransferActionBlockLayer,\n    usePrepare: noop,\n    title: getMakeTransferDrawerTitle,\n  },\n  [actionBlocksKey.TRANSCATION_HISTORY_ACTION_BLOCK]: {\n    Component: TransactionHistoryBlock,\n    usePrepare: noop,\n    title: getDrawerHeaderTitle,\n  },\n  [actionBlocksKey.TRANSACTION_DETAILS_ACTION_BLOCK]: {\n    Component: TransactionDetailsBlock,\n    usePrepare: useTransactionDetailsPrepare,\n    title: () => 'Transaction Details',\n  },\n  // The block renders its own drawer (the help module's RequestSupport) on top of the action\n  // drawer, so the action drawer's title is the CTA label.\n  [actionBlocksKey.CONTACT_SUPPORT_ACTION_BLOCK]: {\n    Component: ContactSupportActionBlock,\n    usePrepare: noop,\n    title: (_variant, copy) => copy.help?.request_support ?? '',\n  },\n} as Record<string, ActionBlockEntry>\n\nexport const blocks = {\n  account_block: AccountBlock,\n  account_switch_block: AccountSwitchBlock,\n  bar_chart_block: BarchartBlock,\n  budget_block: BudgetBlock,\n  donut_chart_block: DonutChartBlock,\n  double_bar_chart_block: DoubleBarChartBlock,\n  double_progress_bar_block: DoubleProgressBarBlock,\n  image_block: ImageBlock,\n  save_extra_block: SaveExtraBlock,\n  step_chart_block: StepChartBlock,\n  svg_image_block: SVGImageBlock,\n  transaction_block: TransactionBlock,\n} as Record<string, React.ComponentType<{ payload: InsightsPayload; beatGuid?: string }>>\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAoCA,IAAM,IAAA,CAAQ,MAAwB;AAAC,GAKjC,IAAmB,oBAAI,IAAI;AAAA,EAAC;AAAA,EAAI;AAAA,EAAQ;AAAW,CAAC,GAC7C,IAAA,CAAkB,MAAmC;AAChE,QAAM,IAAa,GAAO,KAAK,EAAE,YAAY;AAC7C,SAAO,CAAC,CAAC,KAAc,CAAC,EAAiB,IAAI,CAAU;AACzD,GAgBa,IAAe;AAAA,EACzB,CAAA,EAAgB,wBAAA,GAA2B;AAAA,IAC1C,WAAW;AAAA,IACX,YAAY;AAAA,IACZ,OAAA,MAAa;AAAA,EACf;AAAA,EACC,CAAA,EAAgB,0BAAA,GAA6B;AAAA,IAC5C,WAAW;AAAA,IACX,YAAY;AAAA,IACZ,OAAO;AAAA,EACT;AAAA,EACC,CAAA,EAAgB,gCAAA,GAAmC;AAAA,IAClD,WAAW;AAAA,IACX,YAAY;AAAA,IACZ,OAAO;AAAA,EACT;AAAA,EACC,CAAA,EAAgB,gCAAA,GAAmC;AAAA,IAClD,WAAW;AAAA,IACX,YAAY;AAAA,IACZ,OAAA,MAAa;AAAA,EACf;AAAA,EAGC,CAAA,EAAgB,4BAAA,GAA+B;AAAA,IAC9C,WAAW;AAAA,IACX,YAAY;AAAA,IACZ,OAAA,CAAQ,GAAU,MAAS,EAAK,MAAM,mBAAmB;AAAA,EAC3D;AACF,GAEa,IAAS;AAAA,EACpB,eAAe;AAAA,EACf,sBAAsB;AAAA,EACtB,iBAAiB;AAAA,EACjB,cAAc;AAAA,EACd,mBAAmB;AAAA,EACnB,wBAAwB;AAAA,EACxB,2BAA2B;AAAA,EAC3B,aAAa;AAAA,EACb,kBAAkB;AAAA,EAClB,kBAAkB;AAAA,EAClB,iBAAiB;AAAA,EACjB,mBAAmB;AACrB"}

package/dist/insights-v2/resolveInsightRender.d.ts

@@ -0,0 +1,30 @@
+import { Beat } from '../core';
+/**
+ * Which renderer draws a beat:
+ * - `legacy` — the per-template legacy component (feed, mini, micro) or the legacy caption / embedded
+ *   `switch` (transaction row, details drawer).
+ * - `v2`     — `BaseLayout` (full, mini) or `CompactInsightCard` (micro, embedded) from `insights_payload`.
+ * - `error`  — `InsightErrorCard`: the beat is flagged but its envelope is missing.
+ */
+export type InsightRender = 'legacy' | 'v2' | 'error';
+/**
+ * The single gate every surface calls. Two facts decide: `beat.is_insights_v2` (written by firefly
+ * when the insight's Insights 2.0 flag is on) and whether the envelope is present.
+ *
+ * | `is_insights_v2` | envelope  | result   |
+ * | false / absent   | any       | `legacy` |
+ * | true             | non-empty | `v2`     |
+ * | true             | empty     | `error`  |
+ *
+ * `error` is never downgraded to `legacy`: a flagged insight's legacy copy fields are filled from the
+ * same V2 copy block, so a failed envelope would otherwise render a plausible legacy-looking card with
+ * no block, no logo and no footer, and the failure would never surface. An absent flag (older firefly,
+ * cortex) renders the legacy path unchanged.
+ *
+ * An envelope counts as present only when it carries both an `instance_slot` and a `description`: a
+ * bare `{}` is a half-built envelope, every V2 renderer reads `instance_slot.block` first, and all
+ * three — `BaseLayout`, `CompactInsightCard` and the micro `InsightCard` — paint
+ * `description.html_text` unguarded, so a half-built envelope has to resolve to `error` rather than
+ * throw inside the renderer.
+ */
+export declare const resolveInsightRender: (beat?: Beat | null) => InsightRender;

package/dist/insights-v2/resolveInsightRender.es.js

@@ -0,0 +1,10 @@
+var e = (r) => {
+  if (!r?.is_insights_v2) return "legacy";
+  const s = r.insights_payload;
+  return s?.instance_slot && s.description ? "v2" : "error";
+};
+export {
+  e as resolveInsightRender
+};
+
+//# sourceMappingURL=resolveInsightRender.es.js.map

package/dist/insights-v2/resolveInsightRender.es.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveInsightRender.es.js","names":[],"sources":["../../src/insights-v2/resolveInsightRender.ts"],"sourcesContent":["import type { Beat } from '../core'\n\n/**\n * Which renderer draws a beat:\n * - `legacy` — the per-template legacy component (feed, mini, micro) or the legacy caption / embedded\n *   `switch` (transaction row, details drawer).\n * - `v2`     — `BaseLayout` (full, mini) or `CompactInsightCard` (micro, embedded) from `insights_payload`.\n * - `error`  — `InsightErrorCard`: the beat is flagged but its envelope is missing.\n */\nexport type InsightRender = 'legacy' | 'v2' | 'error'\n\n/**\n * The single gate every surface calls. Two facts decide: `beat.is_insights_v2` (written by firefly\n * when the insight's Insights 2.0 flag is on) and whether the envelope is present.\n *\n * | `is_insights_v2` | envelope  | result   |\n * | false / absent   | any       | `legacy` |\n * | true             | non-empty | `v2`     |\n * | true             | empty     | `error`  |\n *\n * `error` is never downgraded to `legacy`: a flagged insight's legacy copy fields are filled from the\n * same V2 copy block, so a failed envelope would otherwise render a plausible legacy-looking card with\n * no block, no logo and no footer, and the failure would never surface. An absent flag (older firefly,\n * cortex) renders the legacy path unchanged.\n *\n * An envelope counts as present only when it carries both an `instance_slot` and a `description`: a\n * bare `{}` is a half-built envelope, every V2 renderer reads `instance_slot.block` first, and all\n * three — `BaseLayout`, `CompactInsightCard` and the micro `InsightCard` — paint\n * `description.html_text` unguarded, so a half-built envelope has to resolve to `error` rather than\n * throw inside the renderer.\n */\nexport const resolveInsightRender = (beat?: Beat | null): InsightRender => {\n  if (!beat?.is_insights_v2) return 'legacy'\n\n  const payload = beat.insights_payload\n\n  return payload?.instance_slot && payload.description ? 'v2' : 'error'\n}\n"],"mappings":"AA+BA,IAAa,IAAA,CAAwB,MAAsC;AACzE,MAAI,CAAC,GAAM,eAAgB,QAAO;AAElC,QAAM,IAAU,EAAK;AAErB,SAAO,GAAS,iBAAiB,EAAQ,cAAc,OAAO;AAChE"}