@mx-cartographer/experiences 9.4.64 → 9.4.65

package/dist/insights-v2/ctaActions/ctaHandlers.es.js

@@ -0,0 +1,107 @@
+var d = (t, e) => t.params[e], n = (t, e) => {
+  const r = d(t, e);
+  if (r == null || r === "") throw new Error(`CTA handler requires params.${e}`);
+  return r;
+}, c = (t) => {
+  const e = d(t, "fields");
+  if (!e || Object.keys(e).length === 0) throw new Error("CTA handler requires params.fields");
+  const r = Object.keys(e).filter((a) => e[a] === void 0);
+  if (r.length > 0) throw new Error(`CTA handler could not resolve field(s): ${r.join(", ")}`);
+  return e;
+}, i = (t, e, r) => {
+  const a = t.find(e);
+  if (!a) throw new Error(`${r} not found in store`);
+  return a;
+}, g = {
+  updateUserInsightProfile: async (t) => {
+    await t.stores.userStore.updateUserInsightProfile(c(t));
+  },
+  markOfferClicked: async ({ beat: t, stores: e }) => {
+    await e.beatStore.updateOffer({
+      ...t,
+      has_been_clicked: !0
+    });
+  },
+  updateRepeatingTransactionResponse: async (t) => {
+    const { beat: e, stores: r } = t, a = n(t, "userResponse"), o = d(t, "repeatingTransactionGuid") ?? e.primary_transaction?.repeating_transaction_guid;
+    if (!o) throw new Error("No repeating transaction guid for beat");
+    const s = i(r.recurringTransactionsStore.repeatingTransactions, (u) => u.guid === o, `Repeating transaction ${o}`);
+    if (!await r.recurringTransactionsStore.updateRepeatingTransaction({
+      ...s,
+      user_response: a
+    })) throw new Error("Failed to update repeating transaction");
+  },
+  updateAccountField: async (t) => {
+    const { beat: e, stores: r } = t, a = d(t, "accountGuid") ?? e.primary_account_guid;
+    if (!a) throw new Error("No account guid for beat");
+    const o = i(r.accountStore.accounts, (s) => s.guid === a, `Account ${a}`);
+    if (!await r.accountStore.updateAccount({
+      ...o,
+      ...c(t)
+    })) throw new Error("Failed to update account");
+  },
+  updateNotificationProfileThreshold: async (t) => {
+    const e = n(t, "profileGuid"), r = n(t, "threshold"), a = i(t.stores.settingsStore.notificationProfiles, (o) => o.guid === e, `Notification profile ${e}`);
+    if (!await t.stores.settingsStore.updateNotificationProfile({
+      ...a,
+      threshold: r
+    })) throw new Error("Failed to update notification profile");
+  },
+  createBudget: async (t) => {
+    const e = n(t, "categoryGuid"), r = n(t, "amount"), a = i(t.stores.categoryStore.categories, (o) => o.guid === e, `Category ${e}`);
+    if (!await t.stores.budgetsStore.addBudget(a, r, d(t, "parentGuid") ?? null)) throw new Error("Failed to create budget");
+  },
+  updateBudget: async (t) => {
+    const e = n(t, "budgetGuid"), r = n(t, "amount"), a = i(t.stores.budgetsStore.budgets, (o) => o.guid === e, `Budget ${e}`);
+    if (!await t.stores.budgetsStore.updateBudget({
+      ...a,
+      amount: r
+    })) throw new Error("Failed to update budget");
+  },
+  deleteBudget: async (t) => {
+    if (!await t.stores.budgetsStore.deleteBudget(n(t, "budgetGuid"))) throw new Error("Failed to delete budget");
+  },
+  createMerchantBudget: async (t) => {
+    if (!(await t.stores.budgetsStore.addMerchantBudget(n(t, "merchantGuid"), n(t, "amount")))?.isSuccess) throw new Error("Failed to create merchant budget");
+  },
+  updateMerchantBudget: async (t) => {
+    const e = n(t, "merchantBudgetGuid"), r = n(t, "amount"), a = i(t.stores.budgetsStore.merchantBudgets, (o) => o.guid === e, `Merchant budget ${e}`);
+    if (!(await t.stores.budgetsStore.updateMerchantBudget({
+      ...a,
+      amount: r
+    }))?.isSuccess) throw new Error("Failed to update merchant budget");
+  },
+  deleteMerchantBudget: async (t) => {
+    if (!(await t.stores.budgetsStore.deleteMerchantBudget(n(t, "merchantBudgetGuid")))?.isSuccess) throw new Error("Failed to delete merchant budget");
+  },
+  updateTransactionField: async (t) => {
+    const { beat: e, stores: r } = t, a = d(t, "transactionGuid") ?? e.primary_transaction_guid;
+    if (!a) throw new Error("No transaction guid for beat");
+    const o = i(r.transactionStore.transactions, (s) => s.guid === a, `Transaction ${a}`);
+    if (!await r.transactionStore.updateTransaction({
+      ...o,
+      ...c(t)
+    })) throw new Error("Failed to update transaction");
+  },
+  applyTransactionRule: async (t) => {
+    const { beat: e, stores: r } = t, a = n(t, "categoryGuid"), o = d(t, "transactionGuid") ?? e.primary_transaction_guid;
+    if (!o) throw new Error("No transaction guid for beat");
+    const s = i(r.transactionStore.transactions, (u) => u.guid === o, `Transaction ${o}`);
+    if (!await r.transactionStore.addOrUpdateTransactionRule(a, s)) throw new Error("Failed to save transaction rule");
+  },
+  delegateToHost: async (t) => {
+    const { hostAction: e, ...r } = t.params, a = typeof e == "string" ? e : "";
+    if (!a) throw new Error("delegateToHost requires params.hostAction");
+    if (!t.hostActions.onCtaAction) throw new Error(`Host does not implement onCtaAction (needed for "${a}")`);
+    await t.hostActions.onCtaAction({
+      beatGuid: t.beat.guid,
+      name: a,
+      params: r
+    });
+  }
+};
+export {
+  g as ctaHandlers
+};
+
+//# sourceMappingURL=ctaHandlers.es.js.map

package/dist/insights-v2/ctaActions/ctaHandlers.es.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ctaHandlers.es.js","names":[],"sources":["../../../src/insights-v2/ctaActions/ctaHandlers.ts"],"sourcesContent":["import type { Account, Budget, MerchantBudget, Transaction, UserInsightProfile } from '../../core'\nimport type { CtaContext, CtaHandler } from './types'\n\n/**\n * Side effects a step can `run`. Call stores (never APIs directly), throw on failure (stores\n * resolve a success flag; translate `false` into a throw), read inputs from `ctx.params` (control\n * values at the top level, the write set under `fields`) and the beat. Beat endpoints and spending plan items are host-owned: use `delegateToHost`.\n */\n\nconst param = <T>(ctx: CtaContext, key: string): T | undefined => ctx.params[key] as T | undefined\n\nconst requireParam = <T>(ctx: CtaContext, key: string): T => {\n  const value = param<T>(ctx, key)\n\n  if (value === undefined || value === null || value === '') {\n    throw new Error(`CTA handler requires params.${key}`)\n  }\n\n  return value\n}\n\n/**\n * The write set a step put under `params.fields`. A value that is still `undefined` (a pick not\n * made yet) throws here: serialised it would just vanish and the PUT would \"succeed\".\n */\nconst requireFields = (ctx: CtaContext): Record<string, unknown> => {\n  const fields = param<Record<string, unknown>>(ctx, 'fields')\n\n  if (!fields || Object.keys(fields).length === 0) {\n    throw new Error('CTA handler requires params.fields')\n  }\n\n  const missing = Object.keys(fields).filter((field) => fields[field] === undefined)\n\n  if (missing.length > 0) {\n    throw new Error(`CTA handler could not resolve field(s): ${missing.join(', ')}`)\n  }\n\n  return fields\n}\n\nconst findOrThrow = <T>(items: T[], predicate: (item: T) => boolean, what: string): T => {\n  const found = items.find(predicate)\n\n  if (!found) throw new Error(`${what} not found in store`)\n\n  return found\n}\n\nexport const ctaHandlers = {\n  /** `PUT user_insight_profile` (designate emergency savings, thresholds, safety net). */\n  updateUserInsightProfile: async (ctx) => {\n    await ctx.stores.userStore.updateUserInsightProfile(\n      requireFields(ctx) as Partial<UserInsightProfile>,\n    )\n  },\n\n  /** `PUT offers/:guid` flagging a marketing offer as clicked. */\n  markOfferClicked: async ({ beat, stores }) => {\n    await stores.beatStore.updateOffer({ ...beat, has_been_clicked: true } as typeof beat)\n  },\n\n  /**\n   * `PUT repeating_transactions/:guid` writing `user_response`. Resolves the repeating\n   * transaction from `params.repeatingTransactionGuid`, else the beat's primary transaction.\n   */\n  updateRepeatingTransactionResponse: async (ctx) => {\n    const { beat, stores } = ctx\n    const userResponse = requireParam<string>(ctx, 'userResponse')\n    const guid =\n      param<string>(ctx, 'repeatingTransactionGuid') ??\n      beat.primary_transaction?.repeating_transaction_guid\n\n    if (!guid) throw new Error('No repeating transaction guid for beat')\n\n    const repeating = findOrThrow(\n      stores.recurringTransactionsStore.repeatingTransactions,\n      (rt) => rt.guid === guid,\n      `Repeating transaction ${guid}`,\n    )\n    const ok = await stores.recurringTransactionsStore.updateRepeatingTransaction({\n      ...repeating,\n      user_response: userResponse,\n    })\n\n    if (!ok) throw new Error('Failed to update repeating transaction')\n  },\n\n  /** `PUT accounts/:guid` merging `params.fields`; `params.accountGuid` picks the account, else the beat's primary. */\n  updateAccountField: async (ctx) => {\n    const { beat, stores } = ctx\n    const guid = param<string>(ctx, 'accountGuid') ?? beat.primary_account_guid\n\n    if (!guid) throw new Error('No account guid for beat')\n\n    const account = findOrThrow(\n      stores.accountStore.accounts,\n      (a) => a.guid === guid,\n      `Account ${guid}`,\n    )\n\n    const ok = await stores.accountStore.updateAccount({\n      ...account,\n      ...requireFields(ctx),\n    } as Account)\n\n    if (!ok) throw new Error('Failed to update account')\n  },\n\n  /** `PUT notification_profiles/:guid` setting `threshold` on the named profile. */\n  updateNotificationProfileThreshold: async (ctx) => {\n    const profileGuid = requireParam<string>(ctx, 'profileGuid')\n    const threshold = requireParam<number>(ctx, 'threshold')\n    const profile = findOrThrow(\n      ctx.stores.settingsStore.notificationProfiles,\n      (p) => p.guid === profileGuid,\n      `Notification profile ${profileGuid}`,\n    )\n\n    const ok = await ctx.stores.settingsStore.updateNotificationProfile({ ...profile, threshold })\n\n    if (!ok) throw new Error('Failed to update notification profile')\n  },\n\n  /** `POST budgets` for `params.categoryGuid` with `params.amount` (+ optional parentGuid). */\n  createBudget: async (ctx) => {\n    const categoryGuid = requireParam<string>(ctx, 'categoryGuid')\n    const amount = requireParam<number>(ctx, 'amount')\n    const category = findOrThrow(\n      ctx.stores.categoryStore.categories,\n      (c) => c.guid === categoryGuid,\n      `Category ${categoryGuid}`,\n    )\n\n    const ok = await ctx.stores.budgetsStore.addBudget(\n      category,\n      amount,\n      param<string | null>(ctx, 'parentGuid') ?? null,\n    )\n\n    if (!ok) throw new Error('Failed to create budget')\n  },\n\n  /** `PUT budgets/:guid` setting `amount`. */\n  updateBudget: async (ctx) => {\n    const budgetGuid = requireParam<string>(ctx, 'budgetGuid')\n    const amount = requireParam<number>(ctx, 'amount')\n    const budget = findOrThrow(\n      ctx.stores.budgetsStore.budgets,\n      (b) => b.guid === budgetGuid,\n      `Budget ${budgetGuid}`,\n    )\n    const ok = await ctx.stores.budgetsStore.updateBudget({ ...budget, amount } as Budget)\n\n    if (!ok) throw new Error('Failed to update budget')\n  },\n\n  /** `DELETE budgets/:guid`. */\n  deleteBudget: async (ctx) => {\n    const ok = await ctx.stores.budgetsStore.deleteBudget(requireParam<string>(ctx, 'budgetGuid'))\n\n    if (!ok) throw new Error('Failed to delete budget')\n  },\n\n  /** `POST merchant_budgets`. */\n  createMerchantBudget: async (ctx) => {\n    const result = await ctx.stores.budgetsStore.addMerchantBudget(\n      requireParam<string>(ctx, 'merchantGuid'),\n      requireParam<number>(ctx, 'amount'),\n    )\n\n    if (!result?.isSuccess) throw new Error('Failed to create merchant budget')\n  },\n\n  /** `PUT merchant_budgets/:guid` setting `amount`. */\n  updateMerchantBudget: async (ctx) => {\n    const guid = requireParam<string>(ctx, 'merchantBudgetGuid')\n    const amount = requireParam<number>(ctx, 'amount')\n    const merchantBudget = findOrThrow(\n      ctx.stores.budgetsStore.merchantBudgets,\n      (mb) => mb.guid === guid,\n      `Merchant budget ${guid}`,\n    )\n    const result = await ctx.stores.budgetsStore.updateMerchantBudget({\n      ...merchantBudget,\n      amount,\n    } as MerchantBudget)\n\n    if (!result?.isSuccess) throw new Error('Failed to update merchant budget')\n  },\n\n  /** `DELETE merchant_budgets/:guid`. */\n  deleteMerchantBudget: async (ctx) => {\n    const result = await ctx.stores.budgetsStore.deleteMerchantBudget(\n      requireParam<string>(ctx, 'merchantBudgetGuid'),\n    )\n\n    if (!result?.isSuccess) throw new Error('Failed to delete merchant budget')\n  },\n\n  /**\n   * `PUT transactions/:guid` merging `params.fields` (category_guid, date, memo,\n   * description, is_hidden...). Resolves the transaction from `params.transactionGuid`,\n   * else the beat's primary transaction guid.\n   */\n  updateTransactionField: async (ctx) => {\n    const { beat, stores } = ctx\n    const guid = param<string>(ctx, 'transactionGuid') ?? beat.primary_transaction_guid\n\n    if (!guid) throw new Error('No transaction guid for beat')\n\n    const transaction = findOrThrow(\n      stores.transactionStore.transactions,\n      (t) => t.guid === guid,\n      `Transaction ${guid}`,\n    )\n\n    const ok = await stores.transactionStore.updateTransaction({\n      ...transaction,\n      ...requireFields(ctx),\n    } as Transaction)\n\n    if (!ok) throw new Error('Failed to update transaction')\n  },\n\n  /** `POST`/`PUT transaction_rules` so `params.categoryGuid` applies to future matches. */\n  applyTransactionRule: async (ctx) => {\n    const { beat, stores } = ctx\n    const categoryGuid = requireParam<string>(ctx, 'categoryGuid')\n    const guid = param<string>(ctx, 'transactionGuid') ?? beat.primary_transaction_guid\n\n    if (!guid) throw new Error('No transaction guid for beat')\n\n    const transaction = findOrThrow(\n      stores.transactionStore.transactions,\n      (t) => t.guid === guid,\n      `Transaction ${guid}`,\n    )\n\n    const ok = await stores.transactionStore.addOrUpdateTransactionRule(categoryGuid, transaction)\n\n    if (!ok) throw new Error('Failed to save transaction rule')\n  },\n\n  /**\n   * Hands a host-owned effect to the embedding app through `beatActions.onCtaAction`.\n   * `params.hostAction` names the effect; remaining params are forwarded untouched.\n   * Host action names are documented in README.md.\n   */\n  delegateToHost: async (ctx) => {\n    const { hostAction, ...rest } = ctx.params\n    const name = typeof hostAction === 'string' ? hostAction : ''\n\n    if (!name) throw new Error('delegateToHost requires params.hostAction')\n    if (!ctx.hostActions.onCtaAction) {\n      throw new Error(`Host does not implement onCtaAction (needed for \"${name}\")`)\n    }\n\n    await ctx.hostActions.onCtaAction({ beatGuid: ctx.beat.guid, name, params: rest })\n  },\n} satisfies Record<string, CtaHandler>\n\n/** A registered handler name. `CtaStep.run` and `useCtaHandler` accept only these, so a typo fails typecheck. */\nexport type CtaHandlerName = keyof typeof ctaHandlers\n"],"mappings":"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"}

package/dist/insights-v2/ctaActions/hostActions.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Host-owned effects requested via `beatActions.onCtaAction`. Contract with pulse
+ * (`HOST_CTA_ACTIONS` in `src/hooks/useBeatActions.js`): add names on both sides together.
+ */
+export declare const HOST_ACTIONS: {
+    /** First primary click (`cta_clicked_at`); fired by the runner, not by steps. */
+    readonly markCtaClicked: "markCtaClicked";
+    readonly dismissBeat: "dismissBeat";
+    readonly updateBeat: "updateBeat";
+    readonly readBeatSummary: "readBeatSummary";
+    readonly sendBeatFeedback: "sendBeatFeedback";
+    readonly disableBeatTemplate: "disableBeatTemplate";
+    readonly spendingPlanItemCreate: "spendingPlanItem.create";
+    readonly spendingPlanItemEdit: "spendingPlanItem.edit";
+    readonly spendingPlanItemDelete: "spendingPlanItem.delete";
+};
+export type HostActionName = (typeof HOST_ACTIONS)[keyof typeof HOST_ACTIONS];

package/dist/insights-v2/ctaActions/hostActions.es.js

@@ -0,0 +1,16 @@
+var e = {
+  markCtaClicked: "markCtaClicked",
+  dismissBeat: "dismissBeat",
+  updateBeat: "updateBeat",
+  readBeatSummary: "readBeatSummary",
+  sendBeatFeedback: "sendBeatFeedback",
+  disableBeatTemplate: "disableBeatTemplate",
+  spendingPlanItemCreate: "spendingPlanItem.create",
+  spendingPlanItemEdit: "spendingPlanItem.edit",
+  spendingPlanItemDelete: "spendingPlanItem.delete"
+};
+export {
+  e as HOST_ACTIONS
+};
+
+//# sourceMappingURL=hostActions.es.js.map

package/dist/insights-v2/ctaActions/hostActions.es.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hostActions.es.js","names":[],"sources":["../../../src/insights-v2/ctaActions/hostActions.ts"],"sourcesContent":["/**\n * Host-owned effects requested via `beatActions.onCtaAction`. Contract with pulse\n * (`HOST_CTA_ACTIONS` in `src/hooks/useBeatActions.js`): add names on both sides together.\n */\nexport const HOST_ACTIONS = {\n  /** First primary click (`cta_clicked_at`); fired by the runner, not by steps. */\n  markCtaClicked: 'markCtaClicked',\n  dismissBeat: 'dismissBeat',\n  updateBeat: 'updateBeat',\n  readBeatSummary: 'readBeatSummary',\n  sendBeatFeedback: 'sendBeatFeedback',\n  disableBeatTemplate: 'disableBeatTemplate',\n  spendingPlanItemCreate: 'spendingPlanItem.create',\n  spendingPlanItemEdit: 'spendingPlanItem.edit',\n  spendingPlanItemDelete: 'spendingPlanItem.delete',\n} as const\n\nexport type HostActionName = (typeof HOST_ACTIONS)[keyof typeof HOST_ACTIONS]\n"],"mappings":"AAIA,IAAa,IAAe;AAAA,EAE1B,gBAAgB;AAAA,EAChB,aAAa;AAAA,EACb,YAAY;AAAA,EACZ,iBAAiB;AAAA,EACjB,kBAAkB;AAAA,EAClB,qBAAqB;AAAA,EACrB,wBAAwB;AAAA,EACxB,sBAAsB;AAAA,EACtB,wBAAwB;AAC1B"}

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

@@ -0,0 +1,6 @@
+export { ctaActions } from './ctaConfig';
+export { ctaHandlers, type CtaHandlerName } from './ctaHandlers';
+export { HOST_ACTIONS, type HostActionName } from './hostActions';
+export { beatContextOf, resolveCtaState, resolveStep, runCtaAction, runCtaHandler, } from './runCtaAction';
+export { useBeatCtaActions, useCtaHandler, type BeatCtaActions } from './useCtaAction';
+export type { CtaContext, CtaEffect, CtaHandler, CtaHandlerContext, CtaParams, CtaSlot, CtaState, CtaStateContext, CtaStep, RunHandlerOptions, } from './types';

package/dist/insights-v2/ctaActions/runCtaAction.d.ts

@@ -0,0 +1,12 @@
+import { CtaHandlerName } from './ctaHandlers';
+import { CtaContext, CtaHandlerContext, CtaState, CtaStateContext, CtaStep, RunHandlerOptions } from './types';
+/** The beat's own context (input a block collected for it), `{}` until something is written. */
+export declare const beatContextOf: ({ beat, stores }: Pick<CtaStateContext, "beat" | "stores">) => Record<string, unknown>;
+/** The step named by the CTA's `action_key`, or the empty default (no key / unknown key). */
+export declare const resolveStep: ({ cta }: Pick<CtaStateContext, "cta">) => CtaStep;
+/** Pending always disables; the step's `disabledWhen` may add to that. */
+export declare const resolveCtaState: (ctx: CtaStateContext) => CtaState;
+/** Runs the CTA's step: `run` handler, `onSuccess` effects, then the `next` target. */
+export declare const runCtaAction: (ctx: CtaContext) => Promise<void>;
+/** Runs a handler directly (drawer Save buttons): same bookkeeping as a card CTA. True on success. */
+export declare const runCtaHandler: (ctx: CtaHandlerContext, handlerName: CtaHandlerName, { onSuccess }?: RunHandlerOptions) => Promise<boolean>;

package/dist/insights-v2/ctaActions/runCtaAction.es.js

@@ -0,0 +1,79 @@
+import { sendBeatCta as l } from "../../common/utils/PostMessage.es.js";
+import { hasDrawerBlock as p } from "../mappings/blocks.es.js";
+import { HOST_ACTIONS as d } from "./hostActions.es.js";
+import { ctaActions as f } from "./ctaConfig.es.js";
+import { ctaHandlers as m } from "./ctaHandlers.es.js";
+var C = {}, n = ({ cta: t }) => t.action_key && f[t.action_key] || C, A = (t) => {
+  const e = n(t);
+  return { disabled: t.stores.insightsV2Store.ctaStatus[t.beat.guid] === "pending" || (e.disabledWhen?.(t) ?? !1) };
+}, o = ({ beat: t, slot: e, stores: a }) => {
+  a.insightsV2Store.openCtaDrawer(t.guid, e === "primary" ? "primaryCta" : "secondaryCta");
+}, g = (t) => {
+  const { beat: e, cta: a, stores: r } = t;
+  if (p(a.block)) {
+    o(t);
+    return;
+  }
+  const { is_mobile_webview: s, clientConfig: i } = r.appDataStore.appConfig;
+  l(e, {
+    isMobileWebview: s,
+    webviewScheme: i?.master?.ui_message_webview_url_scheme,
+    userGuid: e.insights_payload?.user_guid ?? e.user_guid
+  });
+}, w = (t, { beat: e, stores: a }) => {
+  t === "refreshBeat" && a.emitUpdate({ staleBeatGuid: e.guid });
+}, v = ({ beat: t, slot: e, hostActions: a }) => {
+  e !== "primary" || t.cta_clicked_at || Promise.resolve().then(() => a.onCtaAction?.({
+    beatGuid: t.guid,
+    name: d.markCtaClicked
+  })).catch(() => {
+  });
+}, c = async (t, e, a) => {
+  const r = m[e];
+  if (!r) throw new Error(`Unknown CTA handler "${e}"`);
+  await r(t);
+  for (const s of a) w(s, t);
+}, u = async ({ beat: t, stores: e }, a, r = {}) => {
+  const { insightsV2Store: s } = e;
+  s.setCtaStatus(t.guid, "pending");
+  try {
+    return await a(), s.setCtaStatus(t.guid, "done"), !0;
+  } catch (i) {
+    return s.setCtaStatus(t.guid, "error"), e.captureException(i, {
+      store: "ctaActions",
+      template: t.template,
+      ...r
+    }), !1;
+  }
+}, T = async (t) => {
+  const e = n(t), a = typeof e.params == "function" ? e.params(t) : e.params, r = {
+    ...t,
+    params: {
+      ...a,
+      ...t.params
+    }
+  };
+  e.skipCtaClicked || v(r), await u(r, async () => {
+    e.run && await c(r, e.run, e.onSuccess ?? []);
+    const s = e.next ?? (e.run ? "none" : "default");
+    s === "default" ? g(r) : s === "drawer" && o(r);
+  });
+}, h = {
+  label: "",
+  block: ""
+}, D = (t, e, { onSuccess: a = [] } = {}) => {
+  const r = {
+    ...t,
+    cta: h,
+    slot: "primary"
+  };
+  return u(r, () => c(r, e, a), { handler: e });
+};
+export {
+  A as resolveCtaState,
+  n as resolveStep,
+  T as runCtaAction,
+  D as runCtaHandler
+};
+
+//# sourceMappingURL=runCtaAction.es.js.map

package/dist/insights-v2/ctaActions/runCtaAction.es.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runCtaAction.es.js","names":[],"sources":["../../../src/insights-v2/ctaActions/runCtaAction.ts"],"sourcesContent":["import { sendBeatCta } from '../../common/utils/PostMessage'\nimport { hasDrawerBlock } from '../mappings/blocks'\nimport { ctaActions } from './ctaConfig'\nimport { ctaHandlers, type CtaHandlerName } from './ctaHandlers'\nimport { HOST_ACTIONS } from './hostActions'\nimport type {\n  CtaContext,\n  CtaEffect,\n  CtaHandler,\n  CtaHandlerContext,\n  CtaState,\n  CtaStateContext,\n  CtaStep,\n  RunHandlerOptions,\n} from './types'\n\nconst DEFAULT_STEP: CtaStep = {}\n\n// ─── Resolution ─────────────────────────────────────────────────────────────\n\n/** The beat's own context (input a block collected for it), `{}` until something is written. */\nexport const beatContextOf = ({ beat, stores }: Pick<CtaStateContext, 'beat' | 'stores'>) =>\n  stores.insightsV2Store.beatContext[beat.guid] ?? {}\n\n/** The step named by the CTA's `action_key`, or the empty default (no key / unknown key). */\nexport const resolveStep = ({ cta }: Pick<CtaStateContext, 'cta'>): CtaStep =>\n  (cta.action_key && ctaActions[cta.action_key]) || DEFAULT_STEP\n\n/** Pending always disables; the step's `disabledWhen` may add to that. */\nexport const resolveCtaState = (ctx: CtaStateContext): CtaState => {\n  const step = resolveStep(ctx)\n  const pending = ctx.stores.insightsV2Store.ctaStatus[ctx.beat.guid] === 'pending'\n\n  return { disabled: pending || (step.disabledWhen?.(ctx) ?? false) }\n}\n\n// ─── Targets and effects ────────────────────────────────────────────────────\n\n/** Opens the beat's drawer for whichever slot triggered the current step. */\nconst openDrawerForSlot = ({\n  beat,\n  slot,\n  stores,\n}: Pick<CtaContext, 'beat' | 'slot' | 'stores'>) => {\n  stores.insightsV2Store.openCtaDrawer(\n    beat.guid,\n    slot === 'primary' ? 'primaryCta' : 'secondaryCta',\n  )\n}\n\n/** Pre-existing BaseLayout behaviour: drawer for a real block, otherwise beat/cta message. */\nconst runDefaultTarget = (ctx: CtaContext) => {\n  const { beat, cta, stores } = ctx\n\n  if (hasDrawerBlock(cta.block)) {\n    openDrawerForSlot(ctx)\n    return\n  }\n\n  const { is_mobile_webview, clientConfig } = stores.appDataStore.appConfig\n\n  sendBeatCta(beat, {\n    isMobileWebview: is_mobile_webview,\n    webviewScheme: clientConfig?.master?.ui_message_webview_url_scheme,\n    userGuid: beat.insights_payload?.user_guid ?? beat.user_guid,\n  })\n}\n\nconst runEffect = (effect: CtaEffect, { beat, stores }: CtaContext) => {\n  switch (effect) {\n    case 'refreshBeat':\n      stores.emitUpdate({ staleBeatGuid: beat.guid })\n      break\n  }\n}\n\n/**\n * First primary click records `cta_clicked_at` through the host. Fire-and-forget: whatever the\n * host does (reject, throw, return nothing) must never fail the user's action.\n */\nconst markCtaClicked = ({ beat, slot, hostActions }: CtaContext) => {\n  if (slot !== 'primary' || beat.cta_clicked_at) return\n\n  // Wrapping the call in `.then` turns a synchronous throw into a rejection, and the `.catch`\n  // swallows both: a failed cta_clicked_at write is not the user's action.\n  Promise.resolve()\n    .then(() =>\n      hostActions.onCtaAction?.({ beatGuid: beat.guid, name: HOST_ACTIONS.markCtaClicked }),\n    )\n    .catch(() => {})\n}\n\n// ─── Shared bookkeeping ─────────────────────────────────────────────────────\n\n/** Runs a named handler, then its `onSuccess` effects. Shared by card CTAs and drawer saves. */\nconst runHandlerWithEffects = async (\n  ctx: CtaContext,\n  handlerName: CtaHandlerName,\n  onSuccess: CtaEffect[],\n): Promise<void> => {\n  // Names are typed, but the map is still indexed defensively: config can come from anywhere.\n  const handler = (ctaHandlers as Record<string, CtaHandler>)[handlerName]\n\n  if (!handler) throw new Error(`Unknown CTA handler \"${handlerName}\"`)\n\n  await handler(ctx)\n\n  for (const effect of onSuccess) runEffect(effect, ctx)\n}\n\n/** Per-beat status around `work`: `pending` -> `done` | `error` (+ captureException). */\nconst withCtaStatus = async (\n  { beat, stores }: Pick<CtaContext, 'beat' | 'stores'>,\n  work: () => Promise<void>,\n  captureContext: Record<string, string> = {},\n): Promise<boolean> => {\n  const { insightsV2Store } = stores\n\n  insightsV2Store.setCtaStatus(beat.guid, 'pending')\n\n  try {\n    await work()\n    insightsV2Store.setCtaStatus(beat.guid, 'done')\n\n    return true\n  } catch (error) {\n    insightsV2Store.setCtaStatus(beat.guid, 'error')\n    stores.captureException(error, {\n      store: 'ctaActions',\n      template: beat.template,\n      ...captureContext,\n    })\n\n    return false\n  }\n}\n\n// ─── Entry points ───────────────────────────────────────────────────────────\n\n/** Runs the CTA's step: `run` handler, `onSuccess` effects, then the `next` target. */\nexport const runCtaAction = async (ctx: CtaContext): Promise<void> => {\n  const step = resolveStep(ctx)\n  const stepParams = typeof step.params === 'function' ? step.params(ctx) : step.params\n  const stepCtx: CtaContext = { ...ctx, params: { ...stepParams, ...ctx.params } }\n\n  if (!step.skipCtaClicked) markCtaClicked(stepCtx)\n\n  await withCtaStatus(stepCtx, async () => {\n    if (step.run) await runHandlerWithEffects(stepCtx, step.run, step.onSuccess ?? [])\n\n    const target = step.next ?? (step.run ? 'none' : 'default')\n\n    if (target === 'default') runDefaultTarget(stepCtx)\n    else if (target === 'drawer') openDrawerForSlot(stepCtx)\n  })\n}\n\n/** Placeholder CTA for handlers run from inside a drawer, where no card slot is involved. */\nconst DIRECT_CTA = { label: '', block: '' }\n\n/** Runs a handler directly (drawer Save buttons): same bookkeeping as a card CTA. True on success. */\nexport const runCtaHandler = (\n  ctx: CtaHandlerContext,\n  handlerName: CtaHandlerName,\n  { onSuccess = [] }: RunHandlerOptions = {},\n): Promise<boolean> => {\n  const fullCtx: CtaContext = { ...ctx, cta: DIRECT_CTA, slot: 'primary' }\n\n  return withCtaStatus(fullCtx, () => runHandlerWithEffects(fullCtx, handlerName, onSuccess), {\n    handler: handlerName,\n  })\n}\n"],"mappings":"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"}

package/dist/insights-v2/ctaActions/types.d.ts

@@ -0,0 +1,57 @@
+import { Beat, PrimaryCTA, SecondaryCTA } from '../../core';
+import { GlobalStore } from '../../core/stores/GlobalStore';
+import { BeatActions } from '../beatActions';
+import { CtaHandlerName } from './ctaHandlers';
+export type CtaSlot = 'primary' | 'secondary';
+/** Handler inputs: control values at the top level, the write set under `fields`. */
+export type CtaParams = Record<string, unknown>;
+/** Read-only view for state predicates evaluated during render. */
+export type CtaStateContext = Pick<CtaContext, 'beat' | 'cta' | 'slot' | 'stores'>;
+export interface CtaState {
+    disabled: boolean;
+}
+/** Everything a step guard or handler can read while running. */
+export interface CtaContext {
+    beat: Beat;
+    cta: PrimaryCTA | SecondaryCTA;
+    slot: CtaSlot;
+    stores: GlobalStore;
+    hostActions: BeatActions;
+    /** Free-form data declared on the step (or passed by an in-drawer caller). */
+    params: Record<string, unknown>;
+}
+/** Runner-owned after-effects. `refreshBeat`: tell the host the beat is stale (it refetches). */
+export type CtaEffect = 'refreshBeat';
+/** What a CTA does when its `action_key` names this step. The backend picks the key per state. */
+export interface CtaStep {
+    /** Handler to await first (typed: a misspelt name fails typecheck). */
+    run?: CtaHandlerName;
+    /**
+     * Forwarded to the handler as `ctx.params`. A function computes them at press time from the
+     * beat and stores (e.g. a user pick from `beatContextOf(ctx)`); keep it to reading values, the
+     * backend picks behaviour per state via `action_key`.
+     */
+    params?: CtaParams | ((ctx: CtaStateContext) => CtaParams);
+    /** Effects executed after `run` resolves successfully. */
+    onSuccess?: CtaEffect[];
+    /**
+     * After `run`: `default` = drawer if the CTA has a block, else post; `drawer` forces the
+     * drawer; `none` stops. Omitted = `none` with `run`, `default` without.
+     */
+    next?: 'default' | 'drawer' | 'none';
+    /** Skip the first-click `markCtaClicked` host effect. */
+    skipCtaClicked?: boolean;
+    /**
+     * Disable while true. Only for client-only state (a pick not yet made, a store loading);
+     * data-derived rules belong to the backend, which omits the label instead.
+     */
+    disabledWhen?: (ctx: CtaStateContext) => boolean;
+}
+/** Context for a handler run directly from a drawer (no card CTA / slot involved). */
+export type CtaHandlerContext = Omit<CtaContext, 'cta' | 'slot'>;
+export interface RunHandlerOptions {
+    /** Runner-owned effects executed after the handler resolves. */
+    onSuccess?: CtaEffect[];
+}
+/** A named side effect. Must throw (or reject) on failure so the runner can report it. */
+export type CtaHandler = (ctx: CtaContext) => Promise<void> | void;

package/dist/insights-v2/ctaActions/useCtaAction.d.ts

@@ -0,0 +1,19 @@
+import { Beat, PrimaryCTA, SecondaryCTA } from '../../core';
+import { BeatActions } from '../beatActions';
+import { CtaHandlerName } from './ctaHandlers';
+import { CtaSlot, CtaState, RunHandlerOptions } from './types';
+export interface BeatCtaActions {
+    runCta: (slot: CtaSlot, cta: PrimaryCTA | SecondaryCTA, params?: Record<string, unknown>) => Promise<void>;
+    primary: CtaState;
+    secondary: CtaState;
+}
+/**
+ * The card's click runner plus per-slot enabled state. Call from an `observer` so `disabledWhen`
+ * store reads re-render. `beatActions` is a parameter: BaseLayout mounts its provider below this.
+ */
+export declare const useBeatCtaActions: (beat: Beat, beatActions?: BeatActions, primaryCta?: PrimaryCTA | SecondaryCTA, secondaryCta?: PrimaryCTA | SecondaryCTA) => BeatCtaActions;
+/**
+ * Runs a handler from inside a drawer, e.g. `runHandler('createBudget', { categoryGuid, amount },
+ * { onSuccess: ['refreshBeat'] })`. Inside a block, pass `useBeatActions()` as `beatActions`.
+ */
+export declare const useCtaHandler: (beat: Beat, beatActions?: BeatActions) => (handlerName: CtaHandlerName, params?: Record<string, unknown>, options?: RunHandlerOptions) => Promise<boolean>;

package/dist/insights-v2/ctaActions/useCtaAction.es.js

@@ -0,0 +1,44 @@
+import { useGlobalStore as l } from "../../common/context/hooks.es.js";
+import { resolveCtaState as n, runCtaAction as C, runCtaHandler as m } from "./runCtaAction.es.js";
+var c = {
+  label: "",
+  block: ""
+}, d = (r, o = {}, a = c, s = c) => {
+  const t = l();
+  return {
+    runCta: (e, i, u = {}) => C({
+      beat: r,
+      cta: i,
+      slot: e,
+      stores: t,
+      hostActions: o,
+      params: u
+    }),
+    primary: n({
+      beat: r,
+      cta: a,
+      slot: "primary",
+      stores: t
+    }),
+    secondary: n({
+      beat: r,
+      cta: s,
+      slot: "secondary",
+      stores: t
+    })
+  };
+}, v = (r, o = {}) => {
+  const a = l();
+  return (s, t = {}, e) => m({
+    beat: r,
+    stores: a,
+    hostActions: o,
+    params: t
+  }, s, e);
+};
+export {
+  d as useBeatCtaActions,
+  v as useCtaHandler
+};
+
+//# sourceMappingURL=useCtaAction.es.js.map

package/dist/insights-v2/ctaActions/useCtaAction.es.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCtaAction.es.js","names":[],"sources":["../../../src/insights-v2/ctaActions/useCtaAction.ts"],"sourcesContent":["import type { Beat, PrimaryCTA, SecondaryCTA } from '../../core'\nimport { useGlobalStore } from '../../common'\nimport type { BeatActions } from '../beatActions'\nimport type { CtaHandlerName } from './ctaHandlers'\nimport { resolveCtaState, runCtaAction, runCtaHandler } from './runCtaAction'\nimport type { CtaSlot, CtaState, RunHandlerOptions } from './types'\n\nconst EMPTY_CTA: PrimaryCTA = { label: '', block: '' }\n\nexport interface BeatCtaActions {\n  runCta: (\n    slot: CtaSlot,\n    cta: PrimaryCTA | SecondaryCTA,\n    params?: Record<string, unknown>,\n  ) => Promise<void>\n  primary: CtaState\n  secondary: CtaState\n}\n\n/**\n * The card's click runner plus per-slot enabled state. Call from an `observer` so `disabledWhen`\n * store reads re-render. `beatActions` is a parameter: BaseLayout mounts its provider below this.\n */\nexport const useBeatCtaActions = (\n  beat: Beat,\n  beatActions: BeatActions = {},\n  primaryCta: PrimaryCTA | SecondaryCTA = EMPTY_CTA,\n  secondaryCta: PrimaryCTA | SecondaryCTA = EMPTY_CTA,\n): BeatCtaActions => {\n  const stores = useGlobalStore()\n\n  return {\n    runCta: (slot, cta, params = {}) =>\n      runCtaAction({ beat, cta, slot, stores, hostActions: beatActions, params }),\n    primary: resolveCtaState({ beat, cta: primaryCta, slot: 'primary', stores }),\n    secondary: resolveCtaState({ beat, cta: secondaryCta, slot: 'secondary', stores }),\n  }\n}\n\n/**\n * Runs a handler from inside a drawer, e.g. `runHandler('createBudget', { categoryGuid, amount },\n * { onSuccess: ['refreshBeat'] })`. Inside a block, pass `useBeatActions()` as `beatActions`.\n */\nexport const useCtaHandler = (beat: Beat, beatActions: BeatActions = {}) => {\n  const stores = useGlobalStore()\n\n  return (\n    handlerName: CtaHandlerName,\n    params: Record<string, unknown> = {},\n    options?: RunHandlerOptions,\n  ) => runCtaHandler({ beat, stores, hostActions: beatActions, params }, handlerName, options)\n}\n"],"mappings":";;AAOA,IAAM,IAAwB;AAAA,EAAE,OAAO;AAAA,EAAI,OAAO;AAAG,GAgBxC,IAAA,CACX,GACA,IAA2B,CAAC,GAC5B,IAAwC,GACxC,IAA0C,MACvB;AACnB,QAAM,IAAS,EAAe;AAE9B,SAAO;AAAA,IACL,QAAA,CAAS,GAAM,GAAK,IAAS,CAAC,MAC5B,EAAa;AAAA,MAAE,MAAA;AAAA,MAAM,KAAA;AAAA,MAAK,MAAA;AAAA,MAAM,QAAA;AAAA,MAAQ,aAAa;AAAA,MAAa,QAAA;AAAA,IAAO,CAAC;AAAA,IAC5E,SAAS,EAAgB;AAAA,MAAE,MAAA;AAAA,MAAM,KAAK;AAAA,MAAY,MAAM;AAAA,MAAW,QAAA;AAAA,IAAO,CAAC;AAAA,IAC3E,WAAW,EAAgB;AAAA,MAAE,MAAA;AAAA,MAAM,KAAK;AAAA,MAAc,MAAM;AAAA,MAAa,QAAA;AAAA,IAAO,CAAC;AAAA,EACnF;AACF,GAMa,IAAA,CAAiB,GAAY,IAA2B,CAAC,MAAM;AAC1E,QAAM,IAAS,EAAe;AAE9B,SAAA,CACE,GACA,IAAkC,CAAC,GACnC,MACG,EAAc;AAAA,IAAE,MAAA;AAAA,IAAM,QAAA;AAAA,IAAQ,aAAa;AAAA,IAAa,QAAA;AAAA,EAAO,GAAG,GAAa,CAAO;AAC7F"}

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

@@ -22,7 +22,9 @@ export { default as HiddenConfirmationCard, type HiddenConfirmationCardProps, }
 export { default as FeedbackDialog, type FeedbackDialogCloseReason, type FeedbackDialogProps, } from './components/FeedbackDialog';
 export { default as FeedbackBar, type FeedbackBarProps } from './components/FeedbackBar';
 export { ObsolesceBanner, type ObsolesceBannerProps, type ObsolesceBannerState, type ObsolesceBannerCopy, } from './components/ObsolesceBanner';
-export { useBeatActions, type BeatActions, type MenuActionHandlers, type UpdateParams, type FeedbackParams, type DismissParams, type InsightMenuAction, type InsightRating, } from './beatActions';
+export { HOST_ACTIONS, useBeatCtaActions, useCtaHandler } from './ctaActions';
+export type { BeatCtaActions, CtaContext, CtaEffect, CtaHandlerName, CtaParams, CtaStateContext, CtaStep, HostActionName, RunHandlerOptions, } from './ctaActions';
+export { useBeatActions, type BeatActions, type CtaActionParams, type MenuActionHandlers, type UpdateParams, type FeedbackParams, type DismissParams, type InsightMenuAction, type InsightRating, } from './beatActions';
 export { default as LogoTile } from './components/LogoTile';
 export { default as MerchantHighlightCard } from './components/MerchantHighlightCard';
 export { default as P2PLogoStack } from './components/P2PLogoStack';

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

@@ -1,101 +1,106 @@
 import o from "./components/StatusPill.es.js";
-import { resolveInsightRender as t } from "./resolveInsightRender.es.js";
+import { resolveInsightRender as m } 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 d, { isLogoGuid as C } 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 E } from "./blocks/ChartBlocks/DoubleBarChartBlock/DoubleBarChartBlock.es.js";
-import P from "./blocks/ChartBlocks/StepChartBlock/StepChartBlock.es.js";
-import M from "./blocks/ChartBlocks/DonutChartBlock/DonutChartBlock.es.js";
+import { BAR_CHART_VARIANTS as T, barChartVariant as b, buildChartData as D, buildDataSeries as I } from "./blocks/ChartBlocks/BarchartBlock/utils.es.js";
+import { BarchartBlock as H } from "./blocks/ChartBlocks/BarchartBlock/BarchartBlock.es.js";
+import { DoubleBarChartBlock as O } from "./blocks/ChartBlocks/DoubleBarChartBlock/DoubleBarChartBlock.es.js";
+import E from "./blocks/ChartBlocks/StepChartBlock/StepChartBlock.es.js";
+import R from "./blocks/ChartBlocks/DonutChartBlock/DonutChartBlock.es.js";
 import V from "./blocks/ChartBlocks/DoubleProgressBarBlock/DoubleProgressBarBlock.es.js";
 import y from "./blocks/ComponentBlocks/AccountBlock/AccountBlock.es.js";
 import G from "./components/TransferLogoCard.es.js";
-import _ from "./blocks/ComponentBlocks/AccountSwitchBlock/AccountSwitchBlock.es.js";
+import N from "./blocks/ComponentBlocks/AccountSwitchBlock/AccountSwitchBlock.es.js";
 import { BudgetBlock as U } from "./blocks/ComponentBlocks/BudgetBlock/BudgetBlock.es.js";
 import q from "./components/SaveAnExtraCard.es.js";
 import J from "./blocks/ComponentBlocks/SaveExtraBlock/SaveExtraBlock.es.js";
 import Q 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 mr from "./components/WithdrawalCard.es.js";
+import tr from "./components/WithdrawalCard.es.js";
 import ir from "./blocks/ComponentBlocks/WithdrawalBlock/WithdrawalBlock.es.js";
 import { SVGImageBlock as pr } from "./blocks/ImageBlocks/SVGImageBlock/SVGImageBlock.es.js";
 import er from "./components/AccountHeroCard.es.js";
 import sr from "./components/AmountPill.es.js";
 import lr from "./components/DesignateEmergencySavingsCard.es.js";
-import { FeedbackBar as gr } from "./components/FeedbackBar.es.js";
+import { FeedbackBar as Cr } from "./components/FeedbackBar.es.js";
 import Br from "./components/FeedbackDialog.es.js";
 import { DismissInsightDialog as hr } from "./components/DismissInsightDialog.es.js";
 import { HiddenConfirmationCard as Sr } from "./components/HiddenConfirmationCard.es.js";
-import { ErrorCard as br } from "./components/ErrorCard.es.js";
-import { LoadingCard as Lr } from "./components/LoadingCard.es.js";
-import { ObsolesceBanner as Ir } from "./components/ObsolesceBanner.es.js";
-import wr from "./components/BaseLayout.es.js";
-import Hr from "./components/StatusMessageCard.es.js";
-import Rr from "./components/LogoTile.es.js";
-import Or from "./components/LogoClusterCard.es.js";
-import xr from "./components/MerchantHighlightCard.es.js";
-import Fr from "./components/P2PLogoStack.es.js";
-import Wr from "./components/SavingsOpportunityCard.es.js";
-import Nr from "./components/SubscriptionHeroCard.es.js";
-import jr from "./components/UpcomingBillCard.es.js";
+import { ErrorCard as Tr } from "./components/ErrorCard.es.js";
+import { LoadingCard as Dr } from "./components/LoadingCard.es.js";
+import { ObsolesceBanner as Lr } from "./components/ObsolesceBanner.es.js";
+import { HOST_ACTIONS as vr } from "./ctaActions/hostActions.es.js";
+import { useBeatCtaActions as wr, useCtaHandler as Er } from "./ctaActions/useCtaAction.es.js";
+import Rr from "./components/BaseLayout.es.js";
+import Vr from "./components/StatusMessageCard.es.js";
+import yr from "./components/LogoTile.es.js";
+import Gr from "./components/LogoClusterCard.es.js";
+import Nr from "./components/MerchantHighlightCard.es.js";
+import Ur from "./components/P2PLogoStack.es.js";
+import qr from "./components/SavingsOpportunityCard.es.js";
+import Jr from "./components/SubscriptionHeroCard.es.js";
+import Qr from "./components/UpcomingBillCard.es.js";
 export {
   y as AccountBlock,
   er as AccountHeroCard,
-  _ as AccountSwitchBlock,
+  N as AccountSwitchBlock,
   sr as AmountPill,
-  b as BAR_CHART_VARIANTS,
+  T as BAR_CHART_VARIANTS,
   f as BadgedTile,
-  v as BarchartBlock,
-  wr as BaseLayout,
+  H as BarchartBlock,
+  Rr as BaseLayout,
   U as BudgetBlock,
   h as CompactInsightCard,
   lr as DesignateEmergencySavingsCard,
   hr as DismissInsightDialog,
-  M as DonutChartBlock,
-  E as DoubleBarChartBlock,
+  R as DonutChartBlock,
+  O as DoubleBarChartBlock,
   V as DoubleProgressBarBlock,
-  br as ErrorCard,
-  gr as FeedbackBar,
+  Tr as ErrorCard,
+  Cr as FeedbackBar,
   Br as FeedbackDialog,
+  vr as HOST_ACTIONS,
   Sr as HiddenConfirmationCard,
   S as InsightErrorCard,
   c as InsightOptionsMenu,
   Q as InsightTransactionRow,
-  Lr as LoadingCard,
-  Or as LogoClusterCard,
+  Dr as LoadingCard,
+  Gr as LogoClusterCard,
   d as LogoFromGuid,
-  Rr as LogoTile,
-  xr as MerchantHighlightCard,
-  Ir as ObsolesceBanner,
+  yr as LogoTile,
+  Nr as MerchantHighlightCard,
+  Lr as ObsolesceBanner,
   n as OverflowMenu,
-  Fr as P2PLogoStack,
+  Ur as P2PLogoStack,
   pr as SVGImageBlock,
   q as SaveAnExtraCard,
   J as SaveExtraBlock,
-  Wr as SavingsOpportunityCard,
+  qr as SavingsOpportunityCard,
   B as StatusBadge,
-  Hr as StatusMessageCard,
+  Vr as StatusMessageCard,
   o as StatusPill,
-  P as StepChartBlock,
-  Nr as SubscriptionHeroCard,
+  E as StepChartBlock,
+  Jr as SubscriptionHeroCard,
   $ as TransactionBlock,
   rr as TransactionBlockVariant,
   Y as TransactionListCard,
   G as TransferLogoCard,
-  jr as UpcomingBillCard,
+  Qr as UpcomingBillCard,
   ir as WithdrawalBlock,
-  mr as WithdrawalCard,
-  D as barChartVariant,
-  L as buildChartData,
-  T as buildDataSeries,
-  g as isLogoGuid,
-  t as resolveInsightRender,
-  a as useBeatActions
+  tr as WithdrawalCard,
+  b as barChartVariant,
+  D as buildChartData,
+  I as buildDataSeries,
+  C as isLogoGuid,
+  m as resolveInsightRender,
+  a as useBeatActions,
+  wr as useBeatCtaActions,
+  Er as useCtaHandler
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mx-cartographer/experiences",
-  "version": "9.4.64",
+  "version": "9.4.65",
   "description": "Library containing experience widgets",
   "author": "MX",
   "license": "MIT",