@mx-cartographer/experiences 9.4.64 → 9.4.66

package/CHANGELOG.md

@@ -1,3 +1,16 @@
+## [9.4.66] - 10-08-2026
+
+- **ADDED** - `recurring_transaction_block` (Recurring Transaction) action block: opens the Expense Details drawer for one recurring subscription, shared by the Upcoming Subscription and Subscription Price Increase beats. The drawer content is the recurring module's `RecurringTransactionDetails` (merchant, amount, next due date, schedule, account/category, past activity, mark as paid/unpaid, delete), so the block only resolves *which* subscription and hands off, as `TransactionDetailsBlock` does. The subscription is `primary_repeating_transaction_guid` (V2 payload, then the legacy beat envelope), else the beat's primary transaction is walked to the repeating transaction it is linked to. `usePrepare` loads recurring data on open through `loadRepeatingTransactionData`; when nothing resolves the drawer shows `recurring.no_activities`, never the generic error; when the open-time load fails it shows the feed's `ErrorCard` with a Try Again retry instead of an endless loader. The shared transaction filter is restored on close only if the details view actually narrowed it. (WEC-1428)
+- **ADDED** - `InsightsPayload.primary_repeating_transaction_guid` and `Beat.primary_repeating_transaction_guid` (legacy pulse envelope). (WEC-1428)
+- **ADDED** - Mock subscription beats (`mock/BlockBeatsData/RecurringTransactionBeats.ts`, pointing at the mock Netflix subscription), `InsightsV2/ActionBlock/RecurringTransactionBlock` stories, and `docs/action-blocks/` (index + block doc). (WEC-1428)
+
+## [9.4.65] - 10-08-2026
+
+- **ADDED** - Insights V2 CTA action layer (`src/insights-v2/ctaActions`): a card CTA whose backend-named `action_key` (ditto `*_cta_action`, passed through by tupac on `primary_cta` / `secondary_cta`) has a registered step runs that step first: a typed store handler, `onSuccess` effects (`refreshBeat`), a client-only disable (`disabledWhen`), then its drawer or message. No key, or an unknown key, keeps the default (drawer if the CTA has a block, else post). First key: `dismiss_beat` (ConnectDiscoveredAccounts). Per-beat `ctaStatus` and `beatContext` on `InsightsV2Store`; `useBeatCtaActions` for the card and `useCtaHandler` for saves inside a drawer (WEC-1852)
+- **ADDED** - `BeatActions.onCtaAction` so host-owned effects (`HOST_ACTIONS`: `markCtaClicked`, `dismissBeat`, `updateBeat`, `readBeatSummary`, `sendBeatFeedback`, `disableBeatTemplate`, spending plan items) are delegated to the embedding app (WEC-1852)
+- **CHANGED** - `BaseLayout` delegates CTA clicks to the runner, disables CTAs while a handler is pending, and records the first primary click (`cta_clicked_at`) through the host (WEC-1852)
+- **CHANGED** - `BlockType` gains `account_switch_block` and `save_extra_block`, which were already registered blocks (WEC-1852)
+
 ## [9.4.64] - 10-08-2026
 
 - **ADDED** - `SupportPrompt` help component: a "Need more assistance?" text button that reveals an "Open a Case" button on click, used on every clickable Request Support category card and at the end of every help article. Only the reveal callers supply the prompt copy, so the prompt never renders empty. Clicking "Open a Case" opens the contact form with the category or article title as the ticket title. `RequestSupport` accepts a `caseTopic` prop; from an article the panel is not rendered at all and the contact form is the whole surface (WEC-1783)

package/dist/core/stores/InsightsV2Store.d.ts

@@ -26,6 +26,8 @@ interface OpenActionDrawerArgs {
     trigger: ActionDrawerTrigger;
     context?: unknown;
 }
+/** Lifecycle of a beat's CTA action (see insights-v2/ctaActions), keyed by beat guid. */
+export type CtaStatus = 'pending' | 'done' | 'error';
 /**
  * UI state shared across the insights-v2 widget tree. Owns the action drawer so
  * cards, charts, and action blocks coordinate through the store instead of prop
@@ -35,7 +37,24 @@ interface OpenActionDrawerArgs {
 export declare class InsightsV2Store {
     globalStore: GlobalStore;
     actionDrawer: ActionDrawerState;
+    /**
+     * CTA action status per beat guid. Keyed by guid (not block) so a block shared by many
+     * insights never reflects another card's pending or error state.
+     */
+    ctaStatus: Record<string, CtaStatus>;
+    /**
+     * Per-beat scratch input collected on the card or in its blocks (e.g. the account a user
+     * picked before pressing Save), keyed by beat guid. Unlike `actionDrawer.context`, which is
+     * replaced whenever any drawer session starts, this survives other cards' drawers opening.
+     * CTA steps read it via `disabledWhen` and their `params` callback (`beatContextOf`). Ships
+     * ahead of its first block writer (Designate's account picker) on purpose: it is the layer's
+     * only way to keep a pick alive across other cards' drawer sessions.
+     */
+    beatContext: Record<string, Record<string, unknown>>;
     constructor(globalStore: GlobalStore);
+    setCtaStatus: (guid: string, status: CtaStatus) => void;
+    /** Merges `values` into the beat's scratch input. */
+    setBeatContext: (guid: string, values: Record<string, unknown>) => void;
     /**
      * Merges keys into the current drawer session's context bag — it does NOT
      * replace it. A nested drawer (e.g. a row click inside TransactionHistoryBlock

package/dist/core/stores/InsightsV2Store.es.js

@@ -1,36 +1,53 @@
-import { makeAutoObservable as a } from "mobx";
+import { makeAutoObservable as r } from "mobx";
 var o = {
   isDrawerOpen: !1,
   trigger: "primaryCta",
   guid: "",
   context: void 0
-}, n = class {
+}, s = class {
   globalStore;
   actionDrawer = o;
-  constructor(r) {
-    this.globalStore = r, a(this);
+  ctaStatus = {};
+  beatContext = {};
+  constructor(t) {
+    this.globalStore = t, r(this);
   }
-  setActionContext = (r) => {
+  setCtaStatus = (t, e) => {
+    this.ctaStatus = {
+      ...this.ctaStatus,
+      [t]: e
+    };
+  };
+  setBeatContext = (t, e) => {
+    this.beatContext = {
+      ...this.beatContext,
+      [t]: {
+        ...this.beatContext[t],
+        ...e
+      }
+    };
+  };
+  setActionContext = (t) => {
     this.actionDrawer = {
       ...this.actionDrawer,
       context: {
         ...this.actionDrawer.context,
-        ...r
+        ...t
       }
     };
   };
-  openActionDrawer = ({ guid: r, trigger: t, context: e }) => {
+  openActionDrawer = ({ guid: t, trigger: e, context: a }) => {
     this.actionDrawer = {
       isDrawerOpen: !0,
-      trigger: t,
-      guid: r,
-      context: e
+      trigger: e,
+      guid: t,
+      context: a
     };
   };
-  openCtaDrawer = (r, t) => {
+  openCtaDrawer = (t, e) => {
     this.openActionDrawer({
-      guid: r,
-      trigger: t
+      guid: t,
+      trigger: e
     });
   };
   closeActionDrawer = () => {
@@ -43,7 +60,7 @@ var o = {
 };
 export {
   o as CLOSED_ACTION_DRAWER,
-  n as InsightsV2Store
+  s as InsightsV2Store
 };
 
 //# sourceMappingURL=InsightsV2Store.es.js.map

package/dist/core/stores/InsightsV2Store.es.js.map

@@ -1 +1 @@
-{"version":3,"file":"InsightsV2Store.es.js","names":[],"sources":["../../../src/core/stores/InsightsV2Store.ts"],"sourcesContent":["import { makeAutoObservable } from 'mobx'\n\nimport type { GlobalStore } from './GlobalStore'\n\nexport type ActionDrawerTrigger = 'primaryCta' | 'secondaryCta' | 'chartBar'\n\nexport interface ActionDrawerState {\n  isDrawerOpen: boolean\n  trigger: ActionDrawerTrigger\n  guid: string\n  /**\n   * Block-specific drilldown data for the current drawer SESSION, opaque to the\n   * store. Each action block defines and reads its own shape (via\n   * useActionContext<T>()). Chart drilldowns put `{ chartBarIndex, tabIndex }`\n   * here; CTAs carry none.\n   *\n   * This is an accumulating bag, not a single owner's value: a nested drawer\n   * (e.g. TransactionDetailsBlock opened from a row inside TransactionHistory\n   * Block) adds its own key via `setActionContext` ON TOP of whatever the outer\n   * drawer already put here, so the outer block's own context survives while the\n   * nested block is open. It resets to a clean slate only when a NEW drawer\n   * session starts (`openActionDrawer`/`openCtaDrawer`, which fully replace the\n   * envelope) — not on every `setActionContext` call.\n   */\n  context: unknown\n}\n\nexport const CLOSED_ACTION_DRAWER: ActionDrawerState = {\n  isDrawerOpen: false,\n  trigger: 'primaryCta',\n  guid: '',\n  context: undefined,\n}\n\ninterface OpenActionDrawerArgs {\n  guid: string\n  trigger: ActionDrawerTrigger\n  context?: unknown\n}\n\n/**\n * UI state shared across the insights-v2 widget tree. Owns the action drawer so\n * cards, charts, and action blocks coordinate through the store instead of prop\n * drilling. The drawer state is a fixed envelope (isDrawerOpen/guid/trigger) plus\n * an opaque `context` bag, so per-block drilldown data never leaks into this shape.\n */\nexport class InsightsV2Store {\n  globalStore: GlobalStore\n\n  actionDrawer: ActionDrawerState = CLOSED_ACTION_DRAWER\n\n  constructor(globalStore: GlobalStore) {\n    this.globalStore = globalStore\n\n    makeAutoObservable(this)\n  }\n\n  /**\n   * Merges keys into the current drawer session's context bag — it does NOT\n   * replace it. A nested drawer (e.g. a row click inside TransactionHistoryBlock\n   * opening TransactionDetailsBlock) calls this to layer its own key (e.g.\n   * `transaction_guid`) on top of whatever context the outer drawer already set\n   * (e.g. `chartBarIndex`), so the outer block keeps reading its own keys via\n   * useActionContext while the nested block is open. The bag only returns to a\n   * clean slate when a new drawer session starts via `openActionDrawer`/\n   * `openCtaDrawer`, which fully replace the envelope.\n   */\n  setActionContext = (context: Record<string, unknown>) => {\n    this.actionDrawer = {\n      ...this.actionDrawer,\n      context: {\n        ...(this.actionDrawer.context as Record<string, unknown> | undefined),\n        ...context,\n      },\n    }\n  }\n\n  /**\n   * Generic drawer opener — the only opener a new action block needs. Pass the\n   * beat guid, the CTA/source that triggered it, and (optionally) a block-specific\n   * context object the block reads back via useActionContext.\n   */\n  openActionDrawer = ({ guid, trigger, context }: OpenActionDrawerArgs) => {\n    this.actionDrawer = { isDrawerOpen: true, trigger, guid, context }\n  }\n\n  /** Convenience opener for CTA drawers (no drilldown context). */\n  openCtaDrawer = (guid: string, trigger: 'primaryCta' | 'secondaryCta') => {\n    this.openActionDrawer({ guid, trigger })\n  }\n\n  closeActionDrawer = () => {\n    // Preserve `trigger` + `context` so the drawer keeps its variant-specific\n    // title/content through the slide-out animation (ActionBlockLayer stays\n    // mounted while closing). Only flip isDrawerOpen off and clear the beat guid.\n    this.actionDrawer = { ...this.actionDrawer, isDrawerOpen: false, guid: '' }\n  }\n}\n"],"mappings":";AA2BA,IAAa,IAA0C;AAAA,EACrD,cAAc;AAAA,EACd,SAAS;AAAA,EACT,MAAM;AAAA,EACN,SAAS;AACX,GAca,IAAb,MAA6B;AAAA,EAC3B;AAAA,EAEA,eAAkC;AAAA,EAElC,YAAY,GAA0B;AACpC,SAAK,cAAc,GAEnB,EAAmB,IAAI;AAAA,EACzB;AAAA,EAYA,mBAAA,CAAoB,MAAqC;AACvD,SAAK,eAAe;AAAA,MAClB,GAAG,KAAK;AAAA,MACR,SAAS;AAAA,QACP,GAAI,KAAK,aAAa;AAAA,QACtB,GAAG;AAAA,MACL;AAAA,IACF;AAAA,EACF;AAAA,EAOA,mBAAA,CAAoB,EAAE,MAAA,GAAM,SAAA,GAAS,SAAA,EAAA,MAAoC;AACvE,SAAK,eAAe;AAAA,MAAE,cAAc;AAAA,MAAM,SAAA;AAAA,MAAS,MAAA;AAAA,MAAM,SAAA;AAAA,IAAQ;AAAA,EACnE;AAAA,EAGA,gBAAA,CAAiB,GAAc,MAA2C;AACxE,SAAK,iBAAiB;AAAA,MAAE,MAAA;AAAA,MAAM,SAAA;AAAA,IAAQ,CAAC;AAAA,EACzC;AAAA,EAEA,oBAAA,MAA0B;AAIxB,SAAK,eAAe;AAAA,MAAE,GAAG,KAAK;AAAA,MAAc,cAAc;AAAA,MAAO,MAAM;AAAA,IAAG;AAAA,EAC5E;AACF"}
+{"version":3,"file":"InsightsV2Store.es.js","names":[],"sources":["../../../src/core/stores/InsightsV2Store.ts"],"sourcesContent":["import { makeAutoObservable } from 'mobx'\n\nimport type { GlobalStore } from './GlobalStore'\n\nexport type ActionDrawerTrigger = 'primaryCta' | 'secondaryCta' | 'chartBar'\n\nexport interface ActionDrawerState {\n  isDrawerOpen: boolean\n  trigger: ActionDrawerTrigger\n  guid: string\n  /**\n   * Block-specific drilldown data for the current drawer SESSION, opaque to the\n   * store. Each action block defines and reads its own shape (via\n   * useActionContext<T>()). Chart drilldowns put `{ chartBarIndex, tabIndex }`\n   * here; CTAs carry none.\n   *\n   * This is an accumulating bag, not a single owner's value: a nested drawer\n   * (e.g. TransactionDetailsBlock opened from a row inside TransactionHistory\n   * Block) adds its own key via `setActionContext` ON TOP of whatever the outer\n   * drawer already put here, so the outer block's own context survives while the\n   * nested block is open. It resets to a clean slate only when a NEW drawer\n   * session starts (`openActionDrawer`/`openCtaDrawer`, which fully replace the\n   * envelope) — not on every `setActionContext` call.\n   */\n  context: unknown\n}\n\nexport const CLOSED_ACTION_DRAWER: ActionDrawerState = {\n  isDrawerOpen: false,\n  trigger: 'primaryCta',\n  guid: '',\n  context: undefined,\n}\n\ninterface OpenActionDrawerArgs {\n  guid: string\n  trigger: ActionDrawerTrigger\n  context?: unknown\n}\n\n/** Lifecycle of a beat's CTA action (see insights-v2/ctaActions), keyed by beat guid. */\nexport type CtaStatus = 'pending' | 'done' | 'error'\n\n/**\n * UI state shared across the insights-v2 widget tree. Owns the action drawer so\n * cards, charts, and action blocks coordinate through the store instead of prop\n * drilling. The drawer state is a fixed envelope (isDrawerOpen/guid/trigger) plus\n * an opaque `context` bag, so per-block drilldown data never leaks into this shape.\n */\nexport class InsightsV2Store {\n  globalStore: GlobalStore\n\n  actionDrawer: ActionDrawerState = CLOSED_ACTION_DRAWER\n\n  /**\n   * CTA action status per beat guid. Keyed by guid (not block) so a block shared by many\n   * insights never reflects another card's pending or error state.\n   */\n  ctaStatus: Record<string, CtaStatus> = {}\n\n  /**\n   * Per-beat scratch input collected on the card or in its blocks (e.g. the account a user\n   * picked before pressing Save), keyed by beat guid. Unlike `actionDrawer.context`, which is\n   * replaced whenever any drawer session starts, this survives other cards' drawers opening.\n   * CTA steps read it via `disabledWhen` and their `params` callback (`beatContextOf`). Ships\n   * ahead of its first block writer (Designate's account picker) on purpose: it is the layer's\n   * only way to keep a pick alive across other cards' drawer sessions.\n   */\n  beatContext: Record<string, Record<string, unknown>> = {}\n\n  constructor(globalStore: GlobalStore) {\n    this.globalStore = globalStore\n\n    makeAutoObservable(this)\n  }\n\n  setCtaStatus = (guid: string, status: CtaStatus) => {\n    this.ctaStatus = { ...this.ctaStatus, [guid]: status }\n  }\n\n  /** Merges `values` into the beat's scratch input. */\n  setBeatContext = (guid: string, values: Record<string, unknown>) => {\n    this.beatContext = { ...this.beatContext, [guid]: { ...this.beatContext[guid], ...values } }\n  }\n\n  /**\n   * Merges keys into the current drawer session's context bag — it does NOT\n   * replace it. A nested drawer (e.g. a row click inside TransactionHistoryBlock\n   * opening TransactionDetailsBlock) calls this to layer its own key (e.g.\n   * `transaction_guid`) on top of whatever context the outer drawer already set\n   * (e.g. `chartBarIndex`), so the outer block keeps reading its own keys via\n   * useActionContext while the nested block is open. The bag only returns to a\n   * clean slate when a new drawer session starts via `openActionDrawer`/\n   * `openCtaDrawer`, which fully replace the envelope.\n   */\n  setActionContext = (context: Record<string, unknown>) => {\n    this.actionDrawer = {\n      ...this.actionDrawer,\n      context: {\n        ...(this.actionDrawer.context as Record<string, unknown> | undefined),\n        ...context,\n      },\n    }\n  }\n\n  /**\n   * Generic drawer opener — the only opener a new action block needs. Pass the\n   * beat guid, the CTA/source that triggered it, and (optionally) a block-specific\n   * context object the block reads back via useActionContext.\n   */\n  openActionDrawer = ({ guid, trigger, context }: OpenActionDrawerArgs) => {\n    this.actionDrawer = { isDrawerOpen: true, trigger, guid, context }\n  }\n\n  /** Convenience opener for CTA drawers (no drilldown context). */\n  openCtaDrawer = (guid: string, trigger: 'primaryCta' | 'secondaryCta') => {\n    this.openActionDrawer({ guid, trigger })\n  }\n\n  closeActionDrawer = () => {\n    // Preserve `trigger` + `context` so the drawer keeps its variant-specific\n    // title/content through the slide-out animation (ActionBlockLayer stays\n    // mounted while closing). Only flip isDrawerOpen off and clear the beat guid.\n    this.actionDrawer = { ...this.actionDrawer, isDrawerOpen: false, guid: '' }\n  }\n}\n"],"mappings":";AA2BA,IAAa,IAA0C;AAAA,EACrD,cAAc;AAAA,EACd,SAAS;AAAA,EACT,MAAM;AAAA,EACN,SAAS;AACX,GAiBa,IAAb,MAA6B;AAAA,EAC3B;AAAA,EAEA,eAAkC;AAAA,EAMlC,YAAuC,CAAC;AAAA,EAUxC,cAAuD,CAAC;AAAA,EAExD,YAAY,GAA0B;AACpC,SAAK,cAAc,GAEnB,EAAmB,IAAI;AAAA,EACzB;AAAA,EAEA,eAAA,CAAgB,GAAc,MAAsB;AAClD,SAAK,YAAY;AAAA,MAAE,GAAG,KAAK;AAAA,MAAY,CAAA,CAAA,GAAO;AAAA,IAAO;AAAA,EACvD;AAAA,EAGA,iBAAA,CAAkB,GAAc,MAAoC;AAClE,SAAK,cAAc;AAAA,MAAE,GAAG,KAAK;AAAA,MAAc,CAAA,CAAA,GAAO;AAAA,QAAE,GAAG,KAAK,YAAY,CAAA;AAAA,QAAO,GAAG;AAAA,MAAO;AAAA,IAAE;AAAA,EAC7F;AAAA,EAYA,mBAAA,CAAoB,MAAqC;AACvD,SAAK,eAAe;AAAA,MAClB,GAAG,KAAK;AAAA,MACR,SAAS;AAAA,QACP,GAAI,KAAK,aAAa;AAAA,QACtB,GAAG;AAAA,MACL;AAAA,IACF;AAAA,EACF;AAAA,EAOA,mBAAA,CAAoB,EAAE,MAAA,GAAM,SAAA,GAAS,SAAA,EAAA,MAAoC;AACvE,SAAK,eAAe;AAAA,MAAE,cAAc;AAAA,MAAM,SAAA;AAAA,MAAS,MAAA;AAAA,MAAM,SAAA;AAAA,IAAQ;AAAA,EACnE;AAAA,EAGA,gBAAA,CAAiB,GAAc,MAA2C;AACxE,SAAK,iBAAiB;AAAA,MAAE,MAAA;AAAA,MAAM,SAAA;AAAA,IAAQ,CAAC;AAAA,EACzC;AAAA,EAEA,oBAAA,MAA0B;AAIxB,SAAK,eAAe;AAAA,MAAE,GAAG,KAAK;AAAA,MAAc,cAAc;AAAA,MAAO,MAAM;AAAA,IAAG;AAAA,EAC5E;AACF"}

package/dist/core/types/Beat.d.ts

@@ -42,6 +42,8 @@ export interface Beat {
     primary_category_guid?: string | null;
     primary_goal_guid?: string | null;
     primary_merchant_guid?: string | null;
+    /** Legacy pulse envelope: the subscription an Upcoming Subscription beat is about. */
+    primary_repeating_transaction_guid?: string | null;
     primary_scheduled_payment_guid?: string | null;
     primary_transaction?: Transaction;
     primary_transaction_guid?: string | null;

package/dist/core/types/Beat.es.js.map

@@ -1 +1 @@
-{"version":3,"file":"Beat.es.js","names":[],"sources":["../../../src/core/types/Beat.ts"],"sourcesContent":["import { Account } from './Account'\nimport { InsightsPayload } from './Insights'\nimport { Transaction } from './Transaction'\n\nexport interface Beat {\n  account_guids: string[] | []\n  active_at?: string | number\n  associated_transaction_guid?: string | null\n  call_to_action?: string | null\n  category_guids?: string[] | []\n  created_at?: string | number\n  cta_clicked_at?: number | null\n  data_series: DataSeries\n  description?: string\n  digest?: string\n  dismissed_at?: number | null\n  displayed_at?: string | null\n  errors?: any\n  guid: string\n  has_been_displayed: boolean\n  html_description?: string\n  html_in_description_cta?: string\n  html_micro_call_to_action?: string\n  html_micro_description?: string\n  html_micro_title?: string\n  html_short_title?: string\n  html_title: string\n  icon_color?: string | null\n  icon_type?: number | null\n  in_description_cta?: string | null\n  is_dismissed: boolean\n  is_obsolete: boolean\n  is_refreshable: boolean\n  is_sampled: boolean\n  merchant_guids: string[] | []\n  metadata?: string | null\n  micro_call_to_action?: string | null\n  micro_description?: string | null\n  micro_title?: string | null\n  payload: any\n  primary_account?: Account\n  primary_account_guid?: string | null\n  primary_category_guid?: string | null\n  primary_goal_guid?: string | null\n  primary_merchant_guid?: string | null\n  primary_scheduled_payment_guid?: string | null\n  primary_transaction?: Transaction\n  primary_transaction_guid?: string | null\n  power_action_completed_at?: string | null\n  power_action_has_been_completed?: boolean\n  scheduled_payment_guids: string[] | []\n  short_title?: string | null\n  supporting_action?: string | null\n  template: string\n  title: string\n  transaction_guids: string[] | []\n  transactions?: Transaction[]\n  user_guid: string\n  user_verification: UserVerification\n\n  // Added for UI: optional institution info for displaying logos\n  institutionGuid?: string | null\n  institutionName?: string | null\n\n  insights_payload?: InsightsPayload\n  /**\n   * Written by firefly, never by a template: true when the insight's Insights 2.0 flag is on (or\n   * the envelope is present). It gates which renderer draws the beat — see `resolveInsightRender`.\n   * Absent on an older firefly or on cortex, which renders the legacy path unchanged.\n   */\n  is_insights_v2?: boolean\n}\n\nexport interface DataSeries {\n  names?: string[]\n  types?: string[]\n  data?: any[]\n}\n\nexport enum UserVerification {\n  UNKNOWN = 0,\n  CORRECT = 1,\n  INCORRECT = 2,\n}\n"],"mappings":"AA+EA,IAAY,IAAL,0BAAA,GAAA;AACL,SAAA,EAAA,EAAA,UAAA,CAAA,IAAA,WACA,EAAA,EAAA,UAAA,CAAA,IAAA,WACA,EAAA,EAAA,YAAA,CAAA,IAAA;AACF,GAAA,CAAA,CAAA"}
+{"version":3,"file":"Beat.es.js","names":[],"sources":["../../../src/core/types/Beat.ts"],"sourcesContent":["import { Account } from './Account'\nimport { InsightsPayload } from './Insights'\nimport { Transaction } from './Transaction'\n\nexport interface Beat {\n  account_guids: string[] | []\n  active_at?: string | number\n  associated_transaction_guid?: string | null\n  call_to_action?: string | null\n  category_guids?: string[] | []\n  created_at?: string | number\n  cta_clicked_at?: number | null\n  data_series: DataSeries\n  description?: string\n  digest?: string\n  dismissed_at?: number | null\n  displayed_at?: string | null\n  errors?: any\n  guid: string\n  has_been_displayed: boolean\n  html_description?: string\n  html_in_description_cta?: string\n  html_micro_call_to_action?: string\n  html_micro_description?: string\n  html_micro_title?: string\n  html_short_title?: string\n  html_title: string\n  icon_color?: string | null\n  icon_type?: number | null\n  in_description_cta?: string | null\n  is_dismissed: boolean\n  is_obsolete: boolean\n  is_refreshable: boolean\n  is_sampled: boolean\n  merchant_guids: string[] | []\n  metadata?: string | null\n  micro_call_to_action?: string | null\n  micro_description?: string | null\n  micro_title?: string | null\n  payload: any\n  primary_account?: Account\n  primary_account_guid?: string | null\n  primary_category_guid?: string | null\n  primary_goal_guid?: string | null\n  primary_merchant_guid?: string | null\n  /** Legacy pulse envelope: the subscription an Upcoming Subscription beat is about. */\n  primary_repeating_transaction_guid?: string | null\n  primary_scheduled_payment_guid?: string | null\n  primary_transaction?: Transaction\n  primary_transaction_guid?: string | null\n  power_action_completed_at?: string | null\n  power_action_has_been_completed?: boolean\n  scheduled_payment_guids: string[] | []\n  short_title?: string | null\n  supporting_action?: string | null\n  template: string\n  title: string\n  transaction_guids: string[] | []\n  transactions?: Transaction[]\n  user_guid: string\n  user_verification: UserVerification\n\n  // Added for UI: optional institution info for displaying logos\n  institutionGuid?: string | null\n  institutionName?: string | null\n\n  insights_payload?: InsightsPayload\n  /**\n   * Written by firefly, never by a template: true when the insight's Insights 2.0 flag is on (or\n   * the envelope is present). It gates which renderer draws the beat — see `resolveInsightRender`.\n   * Absent on an older firefly or on cortex, which renders the legacy path unchanged.\n   */\n  is_insights_v2?: boolean\n}\n\nexport interface DataSeries {\n  names?: string[]\n  types?: string[]\n  data?: any[]\n}\n\nexport enum UserVerification {\n  UNKNOWN = 0,\n  CORRECT = 1,\n  INCORRECT = 2,\n}\n"],"mappings":"AAiFA,IAAY,IAAL,0BAAA,GAAA;AACL,SAAA,EAAA,EAAA,UAAA,CAAA,IAAA,WACA,EAAA,EAAA,UAAA,CAAA,IAAA,WACA,EAAA,EAAA,YAAA,CAAA,IAAA;AACF,GAAA,CAAA,CAAA"}

package/dist/core/types/Insights.d.ts

@@ -95,6 +95,12 @@ export interface InsightsPayload {
     primary_transaction_guid?: string | null;
     primary_category_guid?: string | null;
     primary_merchant_guid?: string | null;
+    /**
+     * V2: the repeating transaction a subscription beat is about (Upcoming Subscription, Subscription
+     * Price Increase). Read by `recurring_transaction_block`, see
+     * `actionBlocks/RecurringTransactionBlock/subscriptionBeats.ts`.
+     */
+    primary_repeating_transaction_guid?: string | null;
 }
 export interface Legends {
     label: string;
@@ -159,11 +165,19 @@ export interface PrimaryCTA {
     label: string;
     block: string;
     variant?: string | null;
+    /**
+     * What pressing the CTA does beyond opening its block, named by the backend (ditto
+     * `primary_cta_action`, passed through by tupac). Looked up in `insights-v2/ctaActions`;
+     * null / absent / unknown means the CTA only opens its block or posts its message.
+     */
+    action_key?: string | null;
 }
 export interface SecondaryCTA {
     label: string;
     block: string;
     variant?: string | null;
+    /** See `PrimaryCTA.action_key` (ditto `secondary_cta_action`). */
+    action_key?: string | null;
 }
 export interface Footer {
     /** V1: a pre-formatted date string. */
@@ -182,6 +196,7 @@ export interface Footer {
 }
 export declare const BlockType: {
     readonly AccountBlock: "account_block";
+    readonly AccountSwitchBlock: "account_switch_block";
     readonly BarChartBlock: "bar_chart_block";
     readonly BudgetBlock: "budget_block";
     readonly ImageBlock: "image_block";
@@ -189,6 +204,7 @@ export declare const BlockType: {
     readonly DonutChartBlock: "donut_chart_block";
     readonly DoubleBarChartBlock: "double_bar_chart_block";
     readonly DoubleProgressBarBlock: "double_progress_bar_block";
+    readonly SaveExtraBlock: "save_extra_block";
     readonly StepChartBlock: "step_chart_block";
     readonly SVGImageBlock: "svg_image_block";
     readonly WithdrawalBlock: "withdrawal_block";

package/dist/insights-v2/actionBlocks/RecurringTransactionBlock/RecurringTransactionBlock.d.ts

@@ -0,0 +1,17 @@
+import { ActionBlockProps } from '../../mappings/blocks';
+/**
+ * Expense Details drawer content for one recurring subscription (WEC-1428), shared by the Upcoming
+ * Subscription (WEC-1469) and Subscription Price Increase (WEC-1470) beats.
+ *
+ * The detail rendering (merchant header, next-due card, account/category/schedule rows, past
+ * activity, mark-as-paid/unpaid, delete) all lives in the recurring module's
+ * `RecurringTransactionDetails`, the same component behind the recurring widget's Expense Details
+ * drawer. This block's job is only to resolve *which* subscription (`subscriptionBeats.ts`) and hand
+ * off, exactly as `TransactionDetailsBlock` does with `TransactionDetails`.
+ *
+ * `observer` is required: the resolved subscription comes from RecurringTransactionsStore, and
+ * `usePrepare` may still be loading it when this first renders.
+ */
+export declare const RecurringTransactionBlock: (({ beat, }: ActionBlockProps) => import("react/jsx-runtime").JSX.Element) & {
+    displayName: string;
+};

package/dist/insights-v2/actionBlocks/RecurringTransactionBlock/RecurringTransactionBlock.es.js

@@ -0,0 +1,39 @@
+import { useGlobalCopyStore as R, useInsightsV2Store as g, useTransactionStore as T } from "../../../common/context/hooks.es.js";
+import v from "../../../common/components/Loader.es.js";
+import { RecurringTransactionDetails as x } from "../../../recurringtransactions/components/RecurringTransactionDetails.es.js";
+import { ErrorCard as y } from "../../components/ErrorCard.es.js";
+import { useRecurringTransactionBlock as D } from "./useRecurringTransactionBlock.es.js";
+import { useRecurringTransactionLoad as L } from "./useRecurringTransactionPrepare.es.js";
+import r from "react";
+import { observer as B } from "mobx-react-lite";
+import { Text as E } from "@mxenabled/mxui";
+import { jsx as t } from "react/jsx-runtime";
+var O = B(function({ beat: f }) {
+  const { closeActionDrawer: l } = g(), { recurring: m } = R(), { filter: d, setFilter: n } = T(), { hasLoadError: i, isLoading: c, repeatingTransaction: o } = D(f), p = L(), e = r.useRef(null);
+  e.current === null && (e.current = { ...d });
+  const s = r.useRef(n), a = r.useRef(!1), u = !c && !i && o !== void 0;
+  return s.current = n, r.useEffect(() => {
+    u && (a.current = !0);
+  }, [u]), r.useEffect(() => () => {
+    a.current && e.current && s.current(e.current);
+  }, []), c ? /* @__PURE__ */ t(v, {}) : i ? /* @__PURE__ */ t(y, { onRetry: () => {
+    p();
+  } }) : o ? /* @__PURE__ */ t(x, {
+    onDeleted: l,
+    recurringTransaction: o,
+    selectedRecurrence: null
+  }) : /* @__PURE__ */ t(E, {
+    color: "text.secondary",
+    sx: {
+      m: 24,
+      textAlign: "center"
+    },
+    variant: "body1",
+    children: m.no_activities
+  });
+});
+export {
+  O as RecurringTransactionBlock
+};
+
+//# sourceMappingURL=RecurringTransactionBlock.es.js.map

package/dist/insights-v2/actionBlocks/RecurringTransactionBlock/RecurringTransactionBlock.es.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RecurringTransactionBlock.es.js","names":[],"sources":["../../../../src/insights-v2/actionBlocks/RecurringTransactionBlock/RecurringTransactionBlock.tsx"],"sourcesContent":["import React from 'react'\n\nimport { Text } from '@mxenabled/mxui'\nimport { observer } from 'mobx-react-lite'\n\nimport {\n  Loader,\n  useGlobalCopyStore,\n  useInsightsV2Store,\n  useTransactionStore,\n} from '../../../common'\nimport type { TransactionFilter } from '../../../core/stores/TransactionStore'\nimport { RecurringTransactionDetails } from '../../../recurringtransactions/components/RecurringTransactionDetails'\nimport { ErrorCard } from '../../components/ErrorCard'\nimport type { ActionBlockProps } from '../../mappings/blocks'\n\nimport { useRecurringTransactionBlock } from './useRecurringTransactionBlock'\nimport { useRecurringTransactionLoad } from './useRecurringTransactionPrepare'\n\n/**\n * Expense Details drawer content for one recurring subscription (WEC-1428), shared by the Upcoming\n * Subscription (WEC-1469) and Subscription Price Increase (WEC-1470) beats.\n *\n * The detail rendering (merchant header, next-due card, account/category/schedule rows, past\n * activity, mark-as-paid/unpaid, delete) all lives in the recurring module's\n * `RecurringTransactionDetails`, the same component behind the recurring widget's Expense Details\n * drawer. This block's job is only to resolve *which* subscription (`subscriptionBeats.ts`) and hand\n * off, exactly as `TransactionDetailsBlock` does with `TransactionDetails`.\n *\n * `observer` is required: the resolved subscription comes from RecurringTransactionsStore, and\n * `usePrepare` may still be loading it when this first renders.\n */\nexport const RecurringTransactionBlock = observer(function RecurringTransactionBlock({\n  beat,\n}: ActionBlockProps) {\n  const { closeActionDrawer } = useInsightsV2Store()\n  const { recurring: copy } = useGlobalCopyStore()\n  const { filter, setFilter } = useTransactionStore()\n  const { hasLoadError, isLoading, repeatingTransaction } = useRecurringTransactionBlock(beat)\n  const retryLoad = useRecurringTransactionLoad()\n\n  // `RecurringTransactionDetails` narrows the shared `TransactionStore.filter` to this one\n  // subscription (90-day window + guid predicate) and never restores it. Inside the recurring widget\n  // that is fine, but a Transactions widget on the same page would be left showing only this\n  // subscription's charges after the drawer closes. The runner mounts this block on open and\n  // unmounts it on close, so the filter is put back on unmount, with two guards:\n  //  - the snapshot is taken BY VALUE on the first render (the store's `filter` is a live observable\n  //    object, so holding the reference would hold whatever it was later changed to);\n  //  - the restore only runs if the details view actually mounted. While loading, on a failed load\n  //    or when nothing resolved, this block changed nothing and must not overwrite a filter some\n  //    other widget may have set in the meantime.\n  const filterBeforeOpen = React.useRef<TransactionFilter | null>(null)\n\n  if (filterBeforeOpen.current === null) filterBeforeOpen.current = { ...filter }\n\n  const setFilterRef = React.useRef(setFilter)\n  const didRenderDetails = React.useRef(false)\n  const isDetailsRendered = !isLoading && !hasLoadError && repeatingTransaction !== undefined\n\n  setFilterRef.current = setFilter\n\n  React.useEffect(() => {\n    if (isDetailsRendered) didRenderDetails.current = true\n  }, [isDetailsRendered])\n\n  React.useEffect(\n    () => () => {\n      if (didRenderDetails.current && filterBeforeOpen.current) {\n        setFilterRef.current(filterBeforeOpen.current)\n      }\n    },\n    [],\n  )\n\n  if (isLoading) return <Loader />\n\n  // The open-time load finished without data (API failure, reported through the store). Offer the\n  // feed's standard error card with a retry rather than leaving the loader up forever.\n  if (hasLoadError) return <ErrorCard onRetry={() => void retryLoad()} />\n\n  // Loading finished and the beat still resolves to nothing (deleted, never detected, or a beat that\n  // names none). Say so in the recurring module's own words rather than the generic error drawer.\n  if (!repeatingTransaction) {\n    return (\n      <Text color=\"text.secondary\" sx={{ m: 24, textAlign: 'center' }} variant=\"body1\">\n        {copy.no_activities}\n      </Text>\n    )\n  }\n\n  return (\n    <RecurringTransactionDetails\n      // Deleting the subscription from inside the drawer leaves nothing to show; close it, as the\n      // recurring widget's own drawer does.\n      onDeleted={closeActionDrawer}\n      recurringTransaction={repeatingTransaction}\n      // No specific occurrence was tapped (the CTA opens the subscription itself), so the next-due\n      // card falls back to the subscription's next upcoming date.\n      selectedRecurrence={null}\n    />\n  )\n})\n"],"mappings":";;;;;;;;;;AAgCA,IAAa,IAA4B,EAAS,SAAmC,EACnF,MAAA,EAAA,GACmB;AACnB,QAAM,EAAE,mBAAA,EAAA,IAAsB,EAAmB,GAC3C,EAAE,WAAW,EAAA,IAAS,EAAmB,GACzC,EAAE,QAAA,GAAQ,WAAA,EAAA,IAAc,EAAoB,GAC5C,EAAE,cAAA,GAAc,WAAA,GAAW,sBAAA,EAAA,IAAyB,EAA6B,CAAI,GACrF,IAAY,EAA4B,GAYxC,IAAmB,EAAM,OAAiC,IAAI;AAEpE,EAAI,EAAiB,YAAY,SAAM,EAAiB,UAAU,EAAE,GAAG,EAAO;AAE9E,QAAM,IAAe,EAAM,OAAO,CAAS,GACrC,IAAmB,EAAM,OAAO,EAAK,GACrC,IAAoB,CAAC,KAAa,CAAC,KAAgB,MAAyB;AAiBlF,SAfA,EAAa,UAAU,GAEvB,EAAM,UAAA,MAAgB;AACpB,IAAI,MAAmB,EAAiB,UAAU;AAAA,EACpD,GAAG,CAAC,CAAiB,CAAC,GAEtB,EAAM,UAAA,MAAA,MACQ;AACV,IAAI,EAAiB,WAAW,EAAiB,WAC/C,EAAa,QAAQ,EAAiB,OAAO;AAAA,EAEjD,GACA,CAAC,CACH,GAEI,IAAkB,gBAAA,EAAC,GAAD,CAAS,CAAA,IAI3B,IAAqB,gBAAA,EAAC,GAAD,EAAW,SAAA,MAAA;AAAe,IAAK,EAAU;AAAA,IAAI,CAAA,IAIjE,IASH,gBAAA,EAAC,GAAD;AAAA,IAGE,WAAW;AAAA,IACX,sBAAsB;AAAA,IAGtB,oBAAoB;AAAA,EACrB,CAAA,IAfC,gBAAA,EAAC,GAAD;AAAA,IAAM,OAAM;AAAA,IAAiB,IAAI;AAAA,MAAE,GAAG;AAAA,MAAI,WAAW;AAAA,IAAS;AAAA,IAAG,SAAQ;AAAA,IACtE,UAAA,EAAK;AAAA,EACF,CAAA;AAeZ,CAAC"}

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

@@ -0,0 +1,2 @@
+export { RecurringTransactionBlock } from './RecurringTransactionBlock';
+export { useRecurringTransactionPrepare } from './useRecurringTransactionPrepare';

package/dist/insights-v2/actionBlocks/RecurringTransactionBlock/subscriptionBeats.d.ts

@@ -0,0 +1,19 @@
+import { Beat, RepeatingTransaction, Transaction } from '../../../core';
+interface SubscriptionContext {
+    /** `recurringTransactionsStore.repeatingTransactions`, with linked transactions when augmented. */
+    repeatingTransactions: RepeatingTransaction[];
+    /** `transactionStore.transactions`, consulted to walk a transaction to its repeating transaction. */
+    transactions: Transaction[];
+}
+/**
+ * Which repeating transaction the beat is about, or `undefined` if it cannot tell.
+ *
+ * The direct pointer wins: V2 carries `primary_repeating_transaction_guid` on the payload beside the
+ * other `primary_*` guids, and the legacy pulse envelope carries it on the beat (Upcoming
+ * Subscription, WEC-1469). Failing that, the beat's primary transaction is walked to the repeating
+ * transaction it is linked to (Subscription Price Increase, WEC-1470, whose pulse fixture names only
+ * `primary_transaction`): the hydrated `beat.primary_transaction` first, then the transaction store,
+ * then each repeating transaction's own linked `transactions`.
+ */
+export declare const resolveSubscriptionGuid: (beat: Beat, { repeatingTransactions, transactions }: SubscriptionContext) => string | undefined;
+export {};

package/dist/insights-v2/actionBlocks/RecurringTransactionBlock/subscriptionBeats.es.js

@@ -0,0 +1,12 @@
+var s = (i, { repeatingTransactions: t, transactions: o }) => {
+  const a = i.insights_payload?.primary_repeating_transaction_guid || i.primary_repeating_transaction_guid;
+  if (a) return a;
+  const r = i.insights_payload?.primary_transaction_guid || i.primary_transaction?.guid || i.primary_transaction_guid;
+  if (r)
+    return (i.primary_transaction?.guid === r ? i.primary_transaction : void 0)?.repeating_transaction_guid || o.find((n) => n.guid === r)?.repeating_transaction_guid || t.find((n) => n.transactions?.some((d) => d.guid === r))?.guid || void 0;
+};
+export {
+  s as resolveSubscriptionGuid
+};
+
+//# sourceMappingURL=subscriptionBeats.es.js.map

package/dist/insights-v2/actionBlocks/RecurringTransactionBlock/subscriptionBeats.es.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscriptionBeats.es.js","names":[],"sources":["../../../../src/insights-v2/actionBlocks/RecurringTransactionBlock/subscriptionBeats.ts"],"sourcesContent":["import type { Beat, RepeatingTransaction, Transaction } from '../../../core'\n\ninterface SubscriptionContext {\n  /** `recurringTransactionsStore.repeatingTransactions`, with linked transactions when augmented. */\n  repeatingTransactions: RepeatingTransaction[]\n  /** `transactionStore.transactions`, consulted to walk a transaction to its repeating transaction. */\n  transactions: Transaction[]\n}\n\n/**\n * Which repeating transaction the beat is about, or `undefined` if it cannot tell.\n *\n * The direct pointer wins: V2 carries `primary_repeating_transaction_guid` on the payload beside the\n * other `primary_*` guids, and the legacy pulse envelope carries it on the beat (Upcoming\n * Subscription, WEC-1469). Failing that, the beat's primary transaction is walked to the repeating\n * transaction it is linked to (Subscription Price Increase, WEC-1470, whose pulse fixture names only\n * `primary_transaction`): the hydrated `beat.primary_transaction` first, then the transaction store,\n * then each repeating transaction's own linked `transactions`.\n */\nexport const resolveSubscriptionGuid = (\n  beat: Beat,\n  { repeatingTransactions, transactions }: SubscriptionContext,\n): string | undefined => {\n  const direct =\n    beat.insights_payload?.primary_repeating_transaction_guid ||\n    beat.primary_repeating_transaction_guid\n\n  if (direct) return direct\n\n  const transactionGuid =\n    beat.insights_payload?.primary_transaction_guid ||\n    beat.primary_transaction?.guid ||\n    beat.primary_transaction_guid\n\n  if (!transactionGuid) return undefined\n\n  const snapshot =\n    beat.primary_transaction?.guid === transactionGuid ? beat.primary_transaction : undefined\n\n  return (\n    snapshot?.repeating_transaction_guid ||\n    transactions.find((transaction) => transaction.guid === transactionGuid)\n      ?.repeating_transaction_guid ||\n    repeatingTransactions.find((repeating) =>\n      repeating.transactions?.some((transaction) => transaction.guid === transactionGuid),\n    )?.guid ||\n    undefined\n  )\n}\n"],"mappings":"AAmBA,IAAa,IAAA,CACX,GACA,EAAE,uBAAA,GAAuB,cAAA,EAAA,MACF;AACvB,QAAM,IACJ,EAAK,kBAAkB,sCACvB,EAAK;AAEP,MAAI,EAAQ,QAAO;AAEnB,QAAM,IACJ,EAAK,kBAAkB,4BACvB,EAAK,qBAAqB,QAC1B,EAAK;AAEP,MAAK;AAKL,YAFE,EAAK,qBAAqB,SAAS,IAAkB,EAAK,sBAAsB,SAGtE,8BACV,EAAa,KAAA,CAAM,MAAgB,EAAY,SAAS,CAAe,GACnE,8BACJ,EAAsB,KAAA,CAAM,MAC1B,EAAU,cAAc,KAAA,CAAM,MAAgB,EAAY,SAAS,CAAe,CACpF,GAAG,QACH;AAEJ"}

package/dist/insights-v2/actionBlocks/RecurringTransactionBlock/useRecurringTransactionBlock.d.ts

@@ -0,0 +1,23 @@
+import { Beat, RepeatingTransaction } from '../../../core';
+export interface RecurringTransactionBlockState {
+    /** True when the open-time load finished without leaving the store loaded; the block offers a retry. */
+    hasLoadError: boolean;
+    /** True until the recurring store has loaded; the block shows a loader instead of an empty state. */
+    isLoading: boolean;
+    /** `undefined` once loading finishes means the subscription could not be resolved. */
+    repeatingTransaction?: RepeatingTransaction;
+}
+/**
+ * Resolves which repeating transaction this drawer is about.
+ *
+ * The guid comes from the beat (`resolveSubscriptionGuid`), then is looked up in
+ * `RecurringTransactionsStore` rather than rebuilt from the beat, because the Expense Details view
+ * edits (payment schedule, mark as paid, delete) must write through to the same store object the
+ * recurring widget renders.
+ *
+ * `detailedRepeatingTransactions` joins the account and linked transactions in, but it is empty until
+ * the transaction store has loaded (see `augmentRepeatingTransactions`). The raw record is the
+ * fallback so a subscription the store has is never reported missing just because transactions are
+ * still on their way.
+ */
+export declare const useRecurringTransactionBlock: (beat: Beat) => RecurringTransactionBlockState;

package/dist/insights-v2/actionBlocks/RecurringTransactionBlock/useRecurringTransactionBlock.es.js

@@ -0,0 +1,21 @@
+import { useActionContext as p, useRecurringTransactionsStore as T, useTransactionStore as f } from "../../../common/context/hooks.es.js";
+import { resolveSubscriptionGuid as l } from "./subscriptionBeats.es.js";
+var L = (s) => {
+  const { detailedRepeatingTransactions: e, isDataLoaded: o, repeatingTransactions: r } = T(), { transactions: c } = f(), t = p()?.recurringLoadFailed === !0 && !o, i = l(s, {
+    repeatingTransactions: r,
+    transactions: c
+  }), a = (u) => u.find((g) => g.guid === i), n = i ? a(r) : void 0, d = n ? a(e) ?? {
+    ...n,
+    transactions: n.transactions ?? []
+  } : void 0;
+  return {
+    hasLoadError: t,
+    isLoading: !o && !t,
+    repeatingTransaction: d
+  };
+};
+export {
+  L as useRecurringTransactionBlock
+};
+
+//# sourceMappingURL=useRecurringTransactionBlock.es.js.map

package/dist/insights-v2/actionBlocks/RecurringTransactionBlock/useRecurringTransactionBlock.es.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRecurringTransactionBlock.es.js","names":[],"sources":["../../../../src/insights-v2/actionBlocks/RecurringTransactionBlock/useRecurringTransactionBlock.ts"],"sourcesContent":["import {\n  useActionContext,\n  useRecurringTransactionsStore,\n  useTransactionStore,\n} from '../../../common'\nimport type { Beat, RepeatingTransaction } from '../../../core'\n\nimport { resolveSubscriptionGuid } from './subscriptionBeats'\nimport type { RecurringTransactionActionContext } from './useRecurringTransactionPrepare'\n\nexport interface RecurringTransactionBlockState {\n  /** True when the open-time load finished without leaving the store loaded; the block offers a retry. */\n  hasLoadError: boolean\n  /** True until the recurring store has loaded; the block shows a loader instead of an empty state. */\n  isLoading: boolean\n  /** `undefined` once loading finishes means the subscription could not be resolved. */\n  repeatingTransaction?: RepeatingTransaction\n}\n\n/**\n * Resolves which repeating transaction this drawer is about.\n *\n * The guid comes from the beat (`resolveSubscriptionGuid`), then is looked up in\n * `RecurringTransactionsStore` rather than rebuilt from the beat, because the Expense Details view\n * edits (payment schedule, mark as paid, delete) must write through to the same store object the\n * recurring widget renders.\n *\n * `detailedRepeatingTransactions` joins the account and linked transactions in, but it is empty until\n * the transaction store has loaded (see `augmentRepeatingTransactions`). The raw record is the\n * fallback so a subscription the store has is never reported missing just because transactions are\n * still on their way.\n */\nexport const useRecurringTransactionBlock = (beat: Beat): RecurringTransactionBlockState => {\n  const { detailedRepeatingTransactions, isDataLoaded, repeatingTransactions } =\n    useRecurringTransactionsStore()\n  const { transactions } = useTransactionStore()\n  // The failure flag is per drawer session and only cleared by an explicit retry, but the store is\n  // shared: another widget on the page (e.g. Recurring Transactions on a dashboard) may load it\n  // successfully while this drawer is still open. Data that has since arrived wins over the flag.\n  const loadFailed =\n    useActionContext<RecurringTransactionActionContext>()?.recurringLoadFailed === true\n  const hasLoadError = loadFailed && !isDataLoaded\n\n  const guid = resolveSubscriptionGuid(beat, { repeatingTransactions, transactions })\n\n  const findByGuid = (list: RepeatingTransaction[]) =>\n    list.find((repeating) => repeating.guid === guid)\n\n  const raw = guid ? findByGuid(repeatingTransactions) : undefined\n  const repeatingTransaction = raw\n    ? (findByGuid(detailedRepeatingTransactions) ?? {\n        ...raw,\n        transactions: raw.transactions ?? [],\n      })\n    : undefined\n\n  return { hasLoadError, isLoading: !isDataLoaded && !hasLoadError, repeatingTransaction }\n}\n"],"mappings":";;AAgCA,IAAa,IAAA,CAAgC,MAA+C;AAC1F,QAAM,EAAE,+BAAA,GAA+B,cAAA,GAAc,uBAAA,EAAA,IACnD,EAA8B,GAC1B,EAAE,cAAA,EAAA,IAAiB,EAAoB,GAMvC,IADJ,EAAoD,GAAG,wBAAwB,MAC9C,CAAC,GAE9B,IAAO,EAAwB,GAAM;AAAA,IAAE,uBAAA;AAAA,IAAuB,cAAA;AAAA,EAAa,CAAC,GAE5E,IAAA,CAAc,MAClB,EAAK,KAAA,CAAM,MAAc,EAAU,SAAS,CAAI,GAE5C,IAAM,IAAO,EAAW,CAAqB,IAAI,QACjD,IAAuB,IACxB,EAAW,CAA6B,KAAK;AAAA,IAC5C,GAAG;AAAA,IACH,cAAc,EAAI,gBAAgB,CAAC;AAAA,EACrC,IACA;AAEJ,SAAO;AAAA,IAAE,cAAA;AAAA,IAAc,WAAW,CAAC,KAAgB,CAAC;AAAA,IAAc,sBAAA;AAAA,EAAqB;AACzF"}

package/dist/insights-v2/actionBlocks/RecurringTransactionBlock/useRecurringTransactionPrepare.d.ts

@@ -0,0 +1,25 @@
+import { ActionBlockProps } from '../../mappings/blocks';
+/** The key this block layers onto the drawer's action context when its open-time load fails. */
+export interface RecurringTransactionActionContext {
+    recurringLoadFailed?: boolean;
+}
+/**
+ * Runs the recurring widget's loader and records whether it left the store loaded.
+ *
+ * `RecurringTransactionsStore` swallows API failures into `captureError`, so on a failed request
+ * `isDataLoaded` simply stays false and nothing else changes. Left alone, that would keep the block
+ * on its loader forever. This is the one place that turns the outcome into a flag the block can
+ * render an error state (with retry) from. The flag lives on the drawer's action context, which is
+ * per drawer session: a new open starts clean.
+ */
+export declare const useRecurringTransactionLoad: () => () => Promise<void>;
+/**
+ * Open-time data guarantee for the Expense Details drawer. Wired as the block's `usePrepare`, so
+ * `ActionBlockLayer` runs it once each time a CTA opens the drawer.
+ *
+ * A beat is rendered in the feed long before the recurring module has loaded, so the store is
+ * usually cold at open time. The loader is the recurring widget's own (accounts, categories and
+ * transactions first, then repeating transactions). Guarded on `isDataLoaded` so re-opening does
+ * not refetch, and on a ref so a failed load does not refire on every render (retry is explicit).
+ */
+export declare const useRecurringTransactionPrepare: (_props: ActionBlockProps) => void;

package/dist/insights-v2/actionBlocks/RecurringTransactionBlock/useRecurringTransactionPrepare.es.js

@@ -0,0 +1,24 @@
+import { useInsightsV2Store as o, useRecurringTransactionsStore as s } from "../../../common/context/hooks.es.js";
+import e from "react";
+var c = () => {
+  const a = s(), { setActionContext: r } = o();
+  return e.useCallback(async () => {
+    r({ recurringLoadFailed: !1 });
+    try {
+      await a.loadRepeatingTransactionData();
+    } catch {
+    }
+    a.isDataLoaded || r({ recurringLoadFailed: !0 });
+  }, [a, r]);
+}, d = (a) => {
+  const { isDataLoaded: r } = s(), t = c(), n = e.useRef(!1);
+  e.useEffect(() => {
+    n.current || r || (n.current = !0, t());
+  }, [r, t]);
+};
+export {
+  c as useRecurringTransactionLoad,
+  d as useRecurringTransactionPrepare
+};
+
+//# sourceMappingURL=useRecurringTransactionPrepare.es.js.map

package/dist/insights-v2/actionBlocks/RecurringTransactionBlock/useRecurringTransactionPrepare.es.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRecurringTransactionPrepare.es.js","names":[],"sources":["../../../../src/insights-v2/actionBlocks/RecurringTransactionBlock/useRecurringTransactionPrepare.ts"],"sourcesContent":["import React from 'react'\n\nimport { useInsightsV2Store, useRecurringTransactionsStore } from '../../../common'\nimport type { ActionBlockProps } from '../../mappings/blocks'\n\n/** The key this block layers onto the drawer's action context when its open-time load fails. */\nexport interface RecurringTransactionActionContext {\n  recurringLoadFailed?: boolean\n}\n\n/**\n * Runs the recurring widget's loader and records whether it left the store loaded.\n *\n * `RecurringTransactionsStore` swallows API failures into `captureError`, so on a failed request\n * `isDataLoaded` simply stays false and nothing else changes. Left alone, that would keep the block\n * on its loader forever. This is the one place that turns the outcome into a flag the block can\n * render an error state (with retry) from. The flag lives on the drawer's action context, which is\n * per drawer session: a new open starts clean.\n */\nexport const useRecurringTransactionLoad = () => {\n  const recurringTransactionsStore = useRecurringTransactionsStore()\n  const { setActionContext } = useInsightsV2Store()\n\n  return React.useCallback(async () => {\n    setActionContext({ recurringLoadFailed: false })\n\n    try {\n      await recurringTransactionsStore.loadRepeatingTransactionData()\n    } catch {\n      // Already reported through the store's captureError; the flag below is the UI signal.\n    }\n\n    if (!recurringTransactionsStore.isDataLoaded) setActionContext({ recurringLoadFailed: true })\n  }, [recurringTransactionsStore, setActionContext])\n}\n\n/**\n * Open-time data guarantee for the Expense Details drawer. Wired as the block's `usePrepare`, so\n * `ActionBlockLayer` runs it once each time a CTA opens the drawer.\n *\n * A beat is rendered in the feed long before the recurring module has loaded, so the store is\n * usually cold at open time. The loader is the recurring widget's own (accounts, categories and\n * transactions first, then repeating transactions). Guarded on `isDataLoaded` so re-opening does\n * not refetch, and on a ref so a failed load does not refire on every render (retry is explicit).\n */\nexport const useRecurringTransactionPrepare = (_props: ActionBlockProps) => {\n  const { isDataLoaded } = useRecurringTransactionsStore()\n  const load = useRecurringTransactionLoad()\n  const hasStarted = React.useRef(false)\n\n  React.useEffect(() => {\n    if (hasStarted.current || isDataLoaded) return\n\n    hasStarted.current = true\n    void load()\n  }, [isDataLoaded, load])\n}\n"],"mappings":";;AAmBA,IAAa,IAAA,MAAoC;AAC/C,QAAM,IAA6B,EAA8B,GAC3D,EAAE,kBAAA,EAAA,IAAqB,EAAmB;AAEhD,SAAO,EAAM,YAAY,YAAY;AACnC,IAAA,EAAiB,EAAE,qBAAqB,GAAM,CAAC;AAE/C,QAAI;AACF,YAAM,EAA2B,6BAA6B;AAAA,IAChE,QAAQ;AAAA,IAER;AAEA,IAAK,EAA2B,gBAAc,EAAiB,EAAE,qBAAqB,GAAK,CAAC;AAAA,EAC9F,GAAG,CAAC,GAA4B,CAAgB,CAAC;AACnD,GAWa,IAAA,CAAkC,MAA6B;AAC1E,QAAM,EAAE,cAAA,EAAA,IAAiB,EAA8B,GACjD,IAAO,EAA4B,GACnC,IAAa,EAAM,OAAO,EAAK;AAErC,EAAA,EAAM,UAAA,MAAgB;AACpB,IAAI,EAAW,WAAW,MAE1B,EAAW,UAAU,IACrB,EAAU;AAAA,EACZ,GAAG,CAAC,GAAc,CAAI,CAAC;AACzB"}

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

@@ -21,6 +21,16 @@ export interface DismissParams {
     beatGuid: string;
     type: DismissType;
 }
+/**
+ * A CTA side effect the host must perform because experiences cannot (beat-owned endpoints,
+ * spending plan items, third-party SDKs). `name` is agreed between the ctaActions table and
+ * the host; see insights-v2/ctaActions/README.md for the list.
+ */
+export interface CtaActionParams {
+    beatGuid: string;
+    name: string;
+    params?: Record<string, unknown>;
+}
 /** Host callbacks for a beat card. */
 export interface BeatActions {
     onMenuAction?: MenuActionHandlers;
@@ -40,6 +50,7 @@ export interface BeatActions {
      * renders disabled (see `isContactSupportCtaDisabled`).
      */
     onContactSupport?: () => void;
+    onCtaAction?: (params: CtaActionParams) => Promise<void> | void;
 }
 export declare const BeatActionsProvider: ({ value, children, }: {
     value: BeatActions;

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

@@ -1 +1 @@
-{"version":3,"file":"beatActions.es.js","names":[],"sources":["../../src/insights-v2/beatActions.tsx"],"sourcesContent":["import { createContext, useContext, type ReactNode } from 'react'\n\nimport type { DismissType } from './components/DismissInsightDialog'\nimport type { FeedbackDialogCloseReason } from './components/FeedbackDialog'\n\nexport type InsightMenuAction = 'helpful' | 'not_helpful' | 'hide'\nexport type InsightRating = 'helpful' | 'not_helpful'\n\nexport interface MenuActionHandlers {\n  onAction: (action: InsightMenuAction) => void\n  onOpen?: () => void\n  disabled?: boolean\n}\n\nexport interface UpdateParams {\n  beatGuid: string\n}\n\nexport interface FeedbackParams {\n  beatGuid: string\n  source: InsightRating | 'hide'\n  option: string\n  detail?: string\n}\n\nexport interface DismissParams {\n  beatGuid: string\n  type: DismissType\n}\n\n/** Host callbacks for a beat card. */\nexport interface BeatActions {\n  onMenuAction?: MenuActionHandlers\n  onUpdate?: (params: UpdateParams) => void\n  onSubmitFeedback?: (params: FeedbackParams) => void\n  onDismissInsight?: (params: DismissParams) => void\n  onUndoDismiss?: (params: { beatGuid: string }) => void\n  onFeedbackDialogClose?: (reason: FeedbackDialogCloseReason) => void\n  onFeedbackDialogBack?: () => void\n  onFeedbackTextFocus?: () => void\n  /**\n   * Opens the host's contact-support flow for a `contact_support_block` CTA. insights-v2 cannot\n   * import the help module (hosts that don't ship it stub the import), so the host supplies it:\n   * the experiences Help widget wires `RequestSupport`; pulse wires its own. When absent, the CTA\n   * renders disabled (see `isContactSupportCtaDisabled`).\n   */\n  onContactSupport?: () => void\n}\n\nconst BeatActionsContext = createContext<BeatActions>({})\n\nexport const BeatActionsProvider = ({\n  value,\n  children,\n}: {\n  value: BeatActions\n  children: ReactNode\n}) => <BeatActionsContext.Provider value={value}>{children}</BeatActionsContext.Provider>\n\nexport const useBeatActions = () => useContext(BeatActionsContext)\n"],"mappings":";;AAiDA,IAAM,IAAqB,EAA2B,CAAC,CAAC,GAE3C,IAAA,CAAuB,EAClC,OAAA,GACA,UAAA,EAAA,MAII,gBAAA,EAAC,EAAmB,UAApB;AAAA,EAAoC,OAAA;AAAA,EAAQ,UAAA;AAAsC,CAAA,GAE3E,IAAA,MAAuB,EAAW,CAAkB"}
+{"version":3,"file":"beatActions.es.js","names":[],"sources":["../../src/insights-v2/beatActions.tsx"],"sourcesContent":["import { createContext, useContext, type ReactNode } from 'react'\n\nimport type { DismissType } from './components/DismissInsightDialog'\nimport type { FeedbackDialogCloseReason } from './components/FeedbackDialog'\n\nexport type InsightMenuAction = 'helpful' | 'not_helpful' | 'hide'\nexport type InsightRating = 'helpful' | 'not_helpful'\n\nexport interface MenuActionHandlers {\n  onAction: (action: InsightMenuAction) => void\n  onOpen?: () => void\n  disabled?: boolean\n}\n\nexport interface UpdateParams {\n  beatGuid: string\n}\n\nexport interface FeedbackParams {\n  beatGuid: string\n  source: InsightRating | 'hide'\n  option: string\n  detail?: string\n}\n\nexport interface DismissParams {\n  beatGuid: string\n  type: DismissType\n}\n\n/**\n * A CTA side effect the host must perform because experiences cannot (beat-owned endpoints,\n * spending plan items, third-party SDKs). `name` is agreed between the ctaActions table and\n * the host; see insights-v2/ctaActions/README.md for the list.\n */\nexport interface CtaActionParams {\n  beatGuid: string\n  name: string\n  params?: Record<string, unknown>\n}\n\n/** Host callbacks for a beat card. */\nexport interface BeatActions {\n  onMenuAction?: MenuActionHandlers\n  onUpdate?: (params: UpdateParams) => void\n  onSubmitFeedback?: (params: FeedbackParams) => void\n  onDismissInsight?: (params: DismissParams) => void\n  onUndoDismiss?: (params: { beatGuid: string }) => void\n  onFeedbackDialogClose?: (reason: FeedbackDialogCloseReason) => void\n  onFeedbackDialogBack?: () => void\n  onFeedbackTextFocus?: () => void\n  /**\n   * Opens the host's contact-support flow for a `contact_support_block` CTA. insights-v2 cannot\n   * import the help module (hosts that don't ship it stub the import), so the host supplies it:\n   * the experiences Help widget wires `RequestSupport`; pulse wires its own. When absent, the CTA\n   * renders disabled (see `isContactSupportCtaDisabled`).\n   */\n  onContactSupport?: () => void\n  onCtaAction?: (params: CtaActionParams) => Promise<void> | void\n}\n\nconst BeatActionsContext = createContext<BeatActions>({})\n\nexport const BeatActionsProvider = ({\n  value,\n  children,\n}: {\n  value: BeatActions\n  children: ReactNode\n}) => <BeatActionsContext.Provider value={value}>{children}</BeatActionsContext.Provider>\n\nexport const useBeatActions = () => useContext(BeatActionsContext)\n"],"mappings":";;AA6DA,IAAM,IAAqB,EAA2B,CAAC,CAAC,GAE3C,IAAA,CAAuB,EAClC,OAAA,GACA,UAAA,EAAA,MAII,gBAAA,EAAC,EAAmB,UAApB;AAAA,EAAoC,OAAA;AAAA,EAAQ,UAAA;AAAsC,CAAA,GAE3E,IAAA,MAAuB,EAAW,CAAkB"}