Merge branch 'main' into cc/feat/snap-account-service-snap-rpc-methods

Author: ccharly

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metamask/core-monorepo",
-  "version": "1097.0.0",
+  "version": "1101.0.0",
   "private": true,
   "description": "Monorepo for packages shared between MetaMask clients",
   "repository": {

packages/ai-controllers/CHANGELOG.md

@@ -7,6 +7,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.8.0]
+
+### Added
+
+- Add `AiDigestController.fetchFrontPageItem(id)` (and the underlying `AiDigestService.fetchFrontPageItem`) which fetches a single market overview "front page" by id from `GET /market-overview/front-page/:id`, exposed via the `AiDigestController:fetchFrontPageItem` messenger action ([#9394](https://github.com/MetaMask/core/pull/9394))
+- Add `MarketOverviewFrontPage` and `MarketOverviewItem` types ([#9394](https://github.com/MetaMask/core/pull/9394))
+
 ### Changed
 
 - Bump `@metamask/utils` from `^11.9.0` to `^11.11.0` ([#9074](https://github.com/MetaMask/core/pull/9074))
@@ -112,7 +119,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Removes `fetchDigest`, `clearDigest`, and `clearAllDigests` actions from the controller action surface.
   - Removes `DigestData`/`DigestEntry` types and the `digests` state branch.
 
-[Unreleased]: https://github.com/MetaMask/core/compare/@metamask/ai-controllers@0.7.0...HEAD
+[Unreleased]: https://github.com/MetaMask/core/compare/@metamask/ai-controllers@0.8.0...HEAD
+[0.8.0]: https://github.com/MetaMask/core/compare/@metamask/ai-controllers@0.7.0...@metamask/ai-controllers@0.8.0
 [0.7.0]: https://github.com/MetaMask/core/compare/@metamask/ai-controllers@0.6.3...@metamask/ai-controllers@0.7.0
 [0.6.3]: https://github.com/MetaMask/core/compare/@metamask/ai-controllers@0.6.2...@metamask/ai-controllers@0.6.3
 [0.6.2]: https://github.com/MetaMask/core/compare/@metamask/ai-controllers@0.6.1...@metamask/ai-controllers@0.6.2

packages/ai-controllers/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metamask/ai-controllers",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "A collection of AI-related controllers",
   "keywords": [
     "Ethereum",

packages/ai-controllers/src/AiDigestController-method-action-types.ts

@@ -32,9 +32,25 @@ export type AiDigestControllerFetchMarketOverviewAction = {
   handler: AiDigestController['fetchMarketOverview'];
 };
 
+/**
+ * Fetches a single market overview front page by id.
+ *
+ * Unlike the market overview report (which only returns the latest items),
+ * this resolves an older item that has since dropped out of the report, so
+ * clients can render it directly (e.g. from a deep link).
+ *
+ * @param id - The front-page identifier (UUID).
+ * @returns The market overview front page, or `null` if none exists.
+ */
+export type AiDigestControllerFetchFrontPageItemAction = {
+  type: `AiDigestController:fetchFrontPageItem`;
+  handler: AiDigestController['fetchFrontPageItem'];
+};
+
 /**
  * Union of all AiDigestController action types.
  */
 export type AiDigestControllerMethodActions =
   | AiDigestControllerFetchMarketInsightsAction
-  | AiDigestControllerFetchMarketOverviewAction;
+  | AiDigestControllerFetchMarketOverviewAction
+  | AiDigestControllerFetchFrontPageItemAction;

packages/ai-controllers/src/AiDigestController.test.ts

@@ -12,6 +12,7 @@ import type {
   DigestService,
   MarketInsightsReport,
   MarketOverview,
+  MarketOverviewFrontPage,
 } from '.';
 
 const mockReport: MarketInsightsReport = {
@@ -30,6 +31,21 @@ const mockOverview: MarketOverview = {
   trends: [],
 };
 
+const mockFrontPage: MarketOverviewFrontPage = {
+  id: 'a3f1c2d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d',
+  item: {
+    title: 'Institutional adoption',
+    description: 'Institutional players continue accumulating.',
+    category: 'macro',
+    impact: 'positive',
+    articles: [],
+    relatedAssets: [],
+  },
+  ctaTitle: 'Majors steady as volatility cools',
+  ctaDescription: 'Bitcoin and Ethereum held firm as funding rates normalized.',
+  createdAt: '2026-02-11T10:32:52.403Z',
+};
+
 const createMessenger = (): AiDigestControllerMessenger =>
   new Messenger({
     namespace: 'AiDigestController',
@@ -38,6 +54,7 @@ const createMessenger = (): AiDigestControllerMessenger =>
 const createService = (overrides?: Partial<DigestService>): DigestService => ({
   searchDigest: jest.fn().mockResolvedValue(mockReport),
   fetchMarketOverview: jest.fn().mockResolvedValue(mockOverview),
+  fetchFrontPageItem: jest.fn().mockResolvedValue(mockFrontPage),
   ...overrides,
 });
 
@@ -262,3 +279,65 @@ describe('AiDigestController (market overview)', () => {
     expect(controller.state.marketOverview).toBeNull();
   });
 });
+
+describe('AiDigestController (front page)', () => {
+  it('registers fetchFrontPageItem action on messenger', async () => {
+    const digestService = createService();
+    const messenger = createMessenger();
+    const controller = new AiDigestController({ messenger, digestService });
+
+    const result = await messenger.call(
+      'AiDigestController:fetchFrontPageItem',
+      mockFrontPage.id,
+    );
+
+    expect(result).toStrictEqual(mockFrontPage);
+    expect(digestService.fetchFrontPageItem).toHaveBeenCalledWith(
+      mockFrontPage.id,
+    );
+    // The front page is not cached, so controller state is left untouched.
+    expect(controller.state).toStrictEqual({
+      marketInsights: {},
+      marketOverview: null,
+    });
+  });
+
+  it('delegates to the service and returns the front page', async () => {
+    const digestService = createService();
+    const controller = new AiDigestController({
+      messenger: createMessenger(),
+      digestService,
+    });
+
+    const result = await controller.fetchFrontPageItem(mockFrontPage.id);
+
+    expect(result).toStrictEqual(mockFrontPage);
+  });
+
+  it('returns null when the service returns null', async () => {
+    const digestService = createService({
+      fetchFrontPageItem: jest.fn().mockResolvedValue(null),
+    });
+    const controller = new AiDigestController({
+      messenger: createMessenger(),
+      digestService,
+    });
+
+    const result = await controller.fetchFrontPageItem(mockFrontPage.id);
+
+    expect(result).toBeNull();
+  });
+
+  it('throws for an empty id without calling the service', async () => {
+    const digestService = createService();
+    const controller = new AiDigestController({
+      messenger: createMessenger(),
+      digestService,
+    });
+
+    await expect(controller.fetchFrontPageItem('')).rejects.toThrow(
+      AiDigestControllerErrorMessage.INVALID_FRONT_PAGE_ID,
+    );
+    expect(digestService.fetchFrontPageItem).not.toHaveBeenCalled();
+  });
+});

packages/ai-controllers/src/AiDigestController.ts

@@ -19,6 +19,7 @@ import type {
   MarketInsightsEntry,
   MarketOverview,
   MarketOverviewEntry,
+  MarketOverviewFrontPage,
 } from './ai-digest-types';
 import type { AiDigestControllerMethodActions } from './AiDigestController-method-action-types';
 
@@ -75,6 +76,7 @@ const aiDigestControllerMetadata: StateMetadata<AiDigestControllerState> = {
 const MESSENGER_EXPOSED_METHODS = [
   'fetchMarketInsights',
   'fetchMarketOverview',
+  'fetchFrontPageItem',
 ] as const;
 
 export class AiDigestController extends BaseController<
@@ -188,6 +190,26 @@ export class AiDigestController extends BaseController<
     return data;
   }
 
+  /**
+   * Fetches a single market overview front page by id.
+   *
+   * Unlike the market overview report (which only returns the latest items),
+   * this resolves an older item that has since dropped out of the report, so
+   * clients can render it directly (e.g. from a deep link).
+   *
+   * @param id - The front-page identifier (UUID).
+   * @returns The market overview front page, or `null` if none exists.
+   */
+  async fetchFrontPageItem(
+    id: string,
+  ): Promise<MarketOverviewFrontPage | null> {
+    if (!id) {
+      throw new Error(AiDigestControllerErrorMessage.INVALID_FRONT_PAGE_ID);
+    }
+
+    return this.#digestService.fetchFrontPageItem(id);
+  }
+
   /**
    * Evicts stale (TTL expired) and oldest entries (FIFO) if cache exceeds max size.
    *

packages/ai-controllers/src/AiDigestService.test.ts

@@ -895,4 +895,156 @@ describe('AiDigestService', () => {
       expect(result).toStrictEqual(withExtras);
     });
   });
+
+  describe('fetchFrontPageItem', () => {
+    const mockRelatedAsset = {
+      name: 'Bitcoin',
+      symbol: 'BTC',
+      caip19: ['bip122:000000000019d6689c085ae165831e93/slip44:0'],
+      sourceAssetId: 'bitcoin',
+      hlPerpsMarket: ['BTC'],
+    };
+
+    const mockFrontPage = {
+      id: 'a3f1c2d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d',
+      item: {
+        title: 'Institutional adoption',
+        description: 'Institutional players continue accumulating.',
+        category: 'macro',
+        impact: 'positive',
+        articles: [
+          {
+            title: 'Crypto adoption rises',
+            url: 'https://example.com/crypto-adoption',
+            source: 'example.com',
+            date: '2026-02-16',
+          },
+        ],
+        relatedAssets: [mockRelatedAsset],
+      },
+      ctaTitle: 'Majors steady as volatility cools',
+      ctaDescription:
+        'Bitcoin and Ethereum held firm as funding rates normalized.',
+      createdAt: '2026-02-16T10:00:00.000Z',
+    };
+
+    it('fetches a front page item from the correct endpoint', async () => {
+      mockFetch.mockResolvedValue({
+        ok: true,
+        status: 200,
+        json: () => Promise.resolve(mockFrontPage),
+      });
+
+      const service = new AiDigestService({
+        baseUrl: 'http://test.com/api/v1',
+      });
+      const result = await service.fetchFrontPageItem(mockFrontPage.id);
+
+      expect(result).toStrictEqual(mockFrontPage);
+      expect(mockFetch).toHaveBeenCalledWith(
+        `http://test.com/api/v1/market-overview/front-page/${mockFrontPage.id}`,
+      );
+    });
+
+    it('url-encodes the id in the request path', async () => {
+      mockFetch.mockResolvedValue({
+        ok: true,
+        status: 200,
+        json: () => Promise.resolve(mockFrontPage),
+      });
+
+      const service = new AiDigestService({
+        baseUrl: 'http://test.com/api/v1',
+      });
+      await service.fetchFrontPageItem('a b/c');
+
+      expect(mockFetch).toHaveBeenCalledWith(
+        'http://test.com/api/v1/market-overview/front-page/a%20b%2Fc',
+      );
+    });
+
+    it('returns null when API returns 404', async () => {
+      mockFetch.mockResolvedValue({ ok: false, status: 404 });
+
+      const service = new AiDigestService({
+        baseUrl: 'http://test.com/api/v1',
+      });
+      const result = await service.fetchFrontPageItem(mockFrontPage.id);
+
+      expect(result).toBeNull();
+    });
+
+    it('throws on non-404 non-ok response', async () => {
+      mockFetch.mockResolvedValue({ ok: false, status: 500 });
+
+      const service = new AiDigestService({
+        baseUrl: 'http://test.com/api/v1',
+      });
+
+      await expect(
+        service.fetchFrontPageItem(mockFrontPage.id),
+      ).rejects.toThrow('API request failed: 500');
+    });
+
+    it('throws when the item schema is invalid', async () => {
+      mockFetch.mockResolvedValue({
+        ok: true,
+        status: 200,
+        json: () =>
+          Promise.resolve({ ...mockFrontPage, item: 'not-an-object' }),
+      });
+
+      const service = new AiDigestService({
+        baseUrl: 'http://test.com/api/v1',
+      });
+
+      await expect(
+        service.fetchFrontPageItem(mockFrontPage.id),
+      ).rejects.toThrow(AiDigestControllerErrorMessage.API_INVALID_RESPONSE);
+    });
+
+    it('throws when ctaTitle is missing', async () => {
+      const { ctaTitle: _ctaTitle, ...withoutCtaTitle } = mockFrontPage;
+
+      mockFetch.mockResolvedValue({
+        ok: true,
+        status: 200,
+        json: () => Promise.resolve(withoutCtaTitle),
+      });
+
+      const service = new AiDigestService({
+        baseUrl: 'http://test.com/api/v1',
+      });
+
+      await expect(
+        service.fetchFrontPageItem(mockFrontPage.id),
+      ).rejects.toThrow(AiDigestControllerErrorMessage.API_INVALID_RESPONSE);
+    });
+
+    it('normalises missing caip19 on the item to []', async () => {
+      const perpsOnlyAsset = {
+        name: 'ETHFI',
+        symbol: 'ETHFI',
+        sourceAssetId: '',
+        hlPerpsMarket: ['ETHFI'],
+      };
+
+      mockFetch.mockResolvedValue({
+        ok: true,
+        status: 200,
+        json: () =>
+          Promise.resolve({
+            ...mockFrontPage,
+            item: { ...mockFrontPage.item, relatedAssets: [perpsOnlyAsset] },
+          }),
+      });
+
+      const service = new AiDigestService({
+        baseUrl: 'http://test.com/api/v1',
+      });
+      const result = await service.fetchFrontPageItem(mockFrontPage.id);
+
+      expect(result?.item.relatedAssets[0].caip19).toStrictEqual([]);
+    });
+  });
 });