@metamask-previews/ai-controllers 0.8.0-preview-3866c0ff1 → 0.8.0-preview-e3275932a

package/CHANGELOG.md

@@ -9,9 +9,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Changed
 
-- **BREAKING:** Bump minimum Node.js version to 22 ([#9168](https://github.com/MetaMask/core/pull/9168))
+- **BREAKING:** `AiDigestController` no longer caches `fetchMarketInsights` or `fetchMarketOverview` results (no TTL, eviction, or persisted `marketInsights` / `marketOverview` state). Each call is a passthrough to `AiDigestService`. Clients must own freshness.
+  - `AiDigestControllerState` is now an empty object (`Record<string, never>`).
+  - The constructor no longer accepts a `state` option.
 - Bump `@metamask/superstruct` from `^3.1.0` to `^3.4.1` ([#9754](https://github.com/MetaMask/core/pull/9754))
 
+### Removed
+
+- **BREAKING:** Remove `MarketInsightsEntry`, `MarketOverviewEntry`, `CACHE_DURATION_MS`, and `MAX_CACHE_ENTRIES`. Cache policy belongs to clients.
+
 ## [0.8.0]
 
 ### Added

package/dist/AiDigestController-method-action-types.cjs

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * This file is auto generated.
+ * Do not edit manually.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=AiDigestController-method-action-types.cjs.map

package/dist/AiDigestController-method-action-types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"AiDigestController-method-action-types.cjs","sourceRoot":"","sources":["../src/AiDigestController-method-action-types.ts"],"names":[],"mappings":";AAAA;;;GAGG","sourcesContent":["/**\n * This file is auto generated.\n * Do not edit manually.\n */\n\nimport type { AiDigestController } from './AiDigestController.js';\n\n/**\n * Fetches market insights for a given asset identifier.\n *\n * Accepts either a CAIP-19 asset type (e.g. `eip155:1/slip44:60`) or a perps\n * market symbol (e.g. `ETH`). The service handles choosing the correct API\n * query parameter automatically. Clients own freshness/caching.\n *\n * @param assetIdentifier - The asset identifier (CAIP-19 ID or perps market symbol).\n * @returns The market insights report, or `null` if none exists.\n */\nexport type AiDigestControllerFetchMarketInsightsAction = {\n  type: `AiDigestController:fetchMarketInsights`;\n  handler: AiDigestController['fetchMarketInsights'];\n};\n\n/**\n * Fetches the market overview report.\n *\n * Clients own freshness/caching.\n *\n * @returns The market overview report, or `null` if none exists.\n */\nexport type AiDigestControllerFetchMarketOverviewAction = {\n  type: `AiDigestController:fetchMarketOverview`;\n  handler: AiDigestController['fetchMarketOverview'];\n};\n\n/**\n * Fetches a single market overview front page by id.\n *\n * Unlike the market overview report (which only returns the latest items),\n * this resolves an older item that has since dropped out of the report, so\n * clients can render it directly (e.g. from a deep link).\n *\n * @param id - The front-page identifier (UUID).\n * @returns The market overview front page, or `null` if none exists.\n */\nexport type AiDigestControllerFetchFrontPageItemAction = {\n  type: `AiDigestController:fetchFrontPageItem`;\n  handler: AiDigestController['fetchFrontPageItem'];\n};\n\n/**\n * Union of all AiDigestController action types.\n */\nexport type AiDigestControllerMethodActions =\n  | AiDigestControllerFetchMarketInsightsAction\n  | AiDigestControllerFetchMarketOverviewAction\n  | AiDigestControllerFetchFrontPageItemAction;\n"]}

package/dist/{AiDigestController-method-action-types.d.ts → AiDigestController-method-action-types.d.cts}

@@ -2,14 +2,13 @@
  * This file is auto generated.
  * Do not edit manually.
  */
-import type { AiDigestController } from './AiDigestController.js';
+import type { AiDigestController } from "./AiDigestController.cjs";
 /**
  * Fetches market insights for a given asset identifier.
- * Returns cached data if still fresh, otherwise calls the service.
  *
  * Accepts either a CAIP-19 asset type (e.g. `eip155:1/slip44:60`) or a perps
  * market symbol (e.g. `ETH`). The service handles choosing the correct API
- * query parameter automatically.
+ * query parameter automatically. Clients own freshness/caching.
  *
  * @param assetIdentifier - The asset identifier (CAIP-19 ID or perps market symbol).
  * @returns The market insights report, or `null` if none exists.
@@ -20,7 +19,8 @@ export type AiDigestControllerFetchMarketInsightsAction = {
 };
 /**
  * Fetches the market overview report.
- * Returns cached data if still fresh, otherwise calls the service.
+ *
+ * Clients own freshness/caching.
  *
  * @returns The market overview report, or `null` if none exists.
  */
@@ -46,4 +46,4 @@ export type AiDigestControllerFetchFrontPageItemAction = {
  * Union of all AiDigestController action types.
  */
 export type AiDigestControllerMethodActions = AiDigestControllerFetchMarketInsightsAction | AiDigestControllerFetchMarketOverviewAction | AiDigestControllerFetchFrontPageItemAction;
-//# sourceMappingURL=AiDigestController-method-action-types.d.ts.map
+//# sourceMappingURL=AiDigestController-method-action-types.d.cts.map

package/dist/AiDigestController-method-action-types.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AiDigestController-method-action-types.d.cts","sourceRoot":"","sources":["../src/AiDigestController-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,iCAAgC;AAElE;;;;;;;;;GASG;AACH,MAAM,MAAM,2CAA2C,GAAG;IACxD,IAAI,EAAE,wCAAwC,CAAC;IAC/C,OAAO,EAAE,kBAAkB,CAAC,qBAAqB,CAAC,CAAC;CACpD,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,2CAA2C,GAAG;IACxD,IAAI,EAAE,wCAAwC,CAAC;IAC/C,OAAO,EAAE,kBAAkB,CAAC,qBAAqB,CAAC,CAAC;CACpD,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,MAAM,0CAA0C,GAAG;IACvD,IAAI,EAAE,uCAAuC,CAAC;IAC9C,OAAO,EAAE,kBAAkB,CAAC,oBAAoB,CAAC,CAAC;CACnD,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,+BAA+B,GACvC,2CAA2C,GAC3C,2CAA2C,GAC3C,0CAA0C,CAAC"}

package/dist/AiDigestController-method-action-types.d.mts

@@ -0,0 +1,49 @@
+/**
+ * This file is auto generated.
+ * Do not edit manually.
+ */
+import type { AiDigestController } from "./AiDigestController.mjs";
+/**
+ * Fetches market insights for a given asset identifier.
+ *
+ * Accepts either a CAIP-19 asset type (e.g. `eip155:1/slip44:60`) or a perps
+ * market symbol (e.g. `ETH`). The service handles choosing the correct API
+ * query parameter automatically. Clients own freshness/caching.
+ *
+ * @param assetIdentifier - The asset identifier (CAIP-19 ID or perps market symbol).
+ * @returns The market insights report, or `null` if none exists.
+ */
+export type AiDigestControllerFetchMarketInsightsAction = {
+    type: `AiDigestController:fetchMarketInsights`;
+    handler: AiDigestController['fetchMarketInsights'];
+};
+/**
+ * Fetches the market overview report.
+ *
+ * Clients own freshness/caching.
+ *
+ * @returns The market overview report, or `null` if none exists.
+ */
+export type AiDigestControllerFetchMarketOverviewAction = {
+    type: `AiDigestController:fetchMarketOverview`;
+    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 | AiDigestControllerFetchFrontPageItemAction;
+//# sourceMappingURL=AiDigestController-method-action-types.d.mts.map

package/dist/AiDigestController-method-action-types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AiDigestController-method-action-types.d.mts","sourceRoot":"","sources":["../src/AiDigestController-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,iCAAgC;AAElE;;;;;;;;;GASG;AACH,MAAM,MAAM,2CAA2C,GAAG;IACxD,IAAI,EAAE,wCAAwC,CAAC;IAC/C,OAAO,EAAE,kBAAkB,CAAC,qBAAqB,CAAC,CAAC;CACpD,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,2CAA2C,GAAG;IACxD,IAAI,EAAE,wCAAwC,CAAC;IAC/C,OAAO,EAAE,kBAAkB,CAAC,qBAAqB,CAAC,CAAC;CACpD,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,MAAM,0CAA0C,GAAG;IACvD,IAAI,EAAE,uCAAuC,CAAC;IAC9C,OAAO,EAAE,kBAAkB,CAAC,oBAAoB,CAAC,CAAC;CACnD,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,+BAA+B,GACvC,2CAA2C,GAC3C,2CAA2C,GAC3C,0CAA0C,CAAC"}

package/dist/{AiDigestController-method-action-types.js → AiDigestController-method-action-types.mjs}

@@ -3,4 +3,4 @@
  * Do not edit manually.
  */
 export {};
-//# sourceMappingURL=AiDigestController-method-action-types.js.map
+//# sourceMappingURL=AiDigestController-method-action-types.mjs.map

package/dist/AiDigestController-method-action-types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"AiDigestController-method-action-types.mjs","sourceRoot":"","sources":["../src/AiDigestController-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/**\n * This file is auto generated.\n * Do not edit manually.\n */\n\nimport type { AiDigestController } from './AiDigestController.js';\n\n/**\n * Fetches market insights for a given asset identifier.\n *\n * Accepts either a CAIP-19 asset type (e.g. `eip155:1/slip44:60`) or a perps\n * market symbol (e.g. `ETH`). The service handles choosing the correct API\n * query parameter automatically. Clients own freshness/caching.\n *\n * @param assetIdentifier - The asset identifier (CAIP-19 ID or perps market symbol).\n * @returns The market insights report, or `null` if none exists.\n */\nexport type AiDigestControllerFetchMarketInsightsAction = {\n  type: `AiDigestController:fetchMarketInsights`;\n  handler: AiDigestController['fetchMarketInsights'];\n};\n\n/**\n * Fetches the market overview report.\n *\n * Clients own freshness/caching.\n *\n * @returns The market overview report, or `null` if none exists.\n */\nexport type AiDigestControllerFetchMarketOverviewAction = {\n  type: `AiDigestController:fetchMarketOverview`;\n  handler: AiDigestController['fetchMarketOverview'];\n};\n\n/**\n * Fetches a single market overview front page by id.\n *\n * Unlike the market overview report (which only returns the latest items),\n * this resolves an older item that has since dropped out of the report, so\n * clients can render it directly (e.g. from a deep link).\n *\n * @param id - The front-page identifier (UUID).\n * @returns The market overview front page, or `null` if none exists.\n */\nexport type AiDigestControllerFetchFrontPageItemAction = {\n  type: `AiDigestController:fetchFrontPageItem`;\n  handler: AiDigestController['fetchFrontPageItem'];\n};\n\n/**\n * Union of all AiDigestController action types.\n */\nexport type AiDigestControllerMethodActions =\n  | AiDigestControllerFetchMarketInsightsAction\n  | AiDigestControllerFetchMarketOverviewAction\n  | AiDigestControllerFetchFrontPageItemAction;\n"]}

package/dist/AiDigestController.cjs

@@ -0,0 +1,85 @@
+"use strict";
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _AiDigestController_digestService;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AiDigestController = exports.getDefaultAiDigestControllerState = void 0;
+const base_controller_1 = require("@metamask/base-controller");
+const ai_digest_constants_js_1 = require("./ai-digest-constants.cjs");
+function getDefaultAiDigestControllerState() {
+    return {};
+}
+exports.getDefaultAiDigestControllerState = getDefaultAiDigestControllerState;
+const aiDigestControllerMetadata = {};
+const MESSENGER_EXPOSED_METHODS = [
+    'fetchMarketInsights',
+    'fetchMarketOverview',
+    'fetchFrontPageItem',
+];
+class AiDigestController extends base_controller_1.BaseController {
+    constructor({ messenger, digestService }) {
+        super({
+            name: ai_digest_constants_js_1.controllerName,
+            metadata: aiDigestControllerMetadata,
+            state: getDefaultAiDigestControllerState(),
+            messenger,
+        });
+        _AiDigestController_digestService.set(this, void 0);
+        __classPrivateFieldSet(this, _AiDigestController_digestService, digestService, "f");
+        this.messenger.registerMethodActionHandlers(this, MESSENGER_EXPOSED_METHODS);
+    }
+    /**
+     * Fetches market insights for a given asset identifier.
+     *
+     * Accepts either a CAIP-19 asset type (e.g. `eip155:1/slip44:60`) or a perps
+     * market symbol (e.g. `ETH`). The service handles choosing the correct API
+     * query parameter automatically. Clients own freshness/caching.
+     *
+     * @param assetIdentifier - The asset identifier (CAIP-19 ID or perps market symbol).
+     * @returns The market insights report, or `null` if none exists.
+     */
+    async fetchMarketInsights(assetIdentifier) {
+        if (!assetIdentifier) {
+            throw new Error(ai_digest_constants_js_1.AiDigestControllerErrorMessage.INVALID_ASSET_IDENTIFIER);
+        }
+        return __classPrivateFieldGet(this, _AiDigestController_digestService, "f").searchDigest(assetIdentifier);
+    }
+    /**
+     * Fetches the market overview report.
+     *
+     * Clients own freshness/caching.
+     *
+     * @returns The market overview report, or `null` if none exists.
+     */
+    async fetchMarketOverview() {
+        return __classPrivateFieldGet(this, _AiDigestController_digestService, "f").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.
+     */
+    async fetchFrontPageItem(id) {
+        if (!id) {
+            throw new Error(ai_digest_constants_js_1.AiDigestControllerErrorMessage.INVALID_FRONT_PAGE_ID);
+        }
+        return __classPrivateFieldGet(this, _AiDigestController_digestService, "f").fetchFrontPageItem(id);
+    }
+}
+exports.AiDigestController = AiDigestController;
+_AiDigestController_digestService = new WeakMap();
+//# sourceMappingURL=AiDigestController.cjs.map

package/dist/AiDigestController.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"AiDigestController.cjs","sourceRoot":"","sources":["../src/AiDigestController.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAKA,+DAA2D;AAG3D,sEAGkC;AAqClC,SAAgB,iCAAiC;IAC/C,OAAO,EAAE,CAAC;AACZ,CAAC;AAFD,8EAEC;AAED,MAAM,0BAA0B,GAA2C,EAAE,CAAC;AAE9E,MAAM,yBAAyB,GAAG;IAChC,qBAAqB;IACrB,qBAAqB;IACrB,oBAAoB;CACZ,CAAC;AAEX,MAAa,kBAAmB,SAAQ,gCAIvC;IAGC,YAAY,EAAE,SAAS,EAAE,aAAa,EAA6B;QACjE,KAAK,CAAC;YACJ,IAAI,EAAE,uCAAc;YACpB,QAAQ,EAAE,0BAA0B;YACpC,KAAK,EAAE,iCAAiC,EAAE;YAC1C,SAAS;SACV,CAAC,CAAC;QARI,oDAA8B;QAUrC,uBAAA,IAAI,qCAAkB,aAAa,MAAA,CAAC;QACpC,IAAI,CAAC,SAAS,CAAC,4BAA4B,CACzC,IAAI,EACJ,yBAAyB,CAC1B,CAAC;IACJ,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,mBAAmB,CACvB,eAAuB;QAEvB,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,uDAA8B,CAAC,wBAAwB,CAAC,CAAC;QAC3E,CAAC;QAED,OAAO,uBAAA,IAAI,yCAAe,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC;IAC3D,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,mBAAmB;QACvB,OAAO,uBAAA,IAAI,yCAAe,CAAC,mBAAmB,EAAE,CAAC;IACnD,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,kBAAkB,CACtB,EAAU;QAEV,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,MAAM,IAAI,KAAK,CAAC,uDAA8B,CAAC,qBAAqB,CAAC,CAAC;QACxE,CAAC;QAED,OAAO,uBAAA,IAAI,yCAAe,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC;IACpD,CAAC;CACF;AAxED,gDAwEC","sourcesContent":["import type {\n  StateMetadata,\n  ControllerStateChangeEvent,\n  ControllerGetStateAction,\n} from '@metamask/base-controller';\nimport { BaseController } from '@metamask/base-controller';\nimport type { Messenger } from '@metamask/messenger';\n\nimport {\n  AiDigestControllerErrorMessage,\n  controllerName,\n} from './ai-digest-constants.js';\nimport type {\n  AiDigestControllerState,\n  DigestService,\n  MarketInsightsReport,\n  MarketOverview,\n  MarketOverviewFrontPage,\n} from './ai-digest-types.js';\nimport type { AiDigestControllerMethodActions } from './AiDigestController-method-action-types.js';\n\nexport type AiDigestControllerGetStateAction = ControllerGetStateAction<\n  typeof controllerName,\n  AiDigestControllerState\n>;\n\nexport type AiDigestControllerActions =\n  | AiDigestControllerGetStateAction\n  | AiDigestControllerMethodActions;\n\nexport type AiDigestControllerStateChangeEvent = ControllerStateChangeEvent<\n  typeof controllerName,\n  AiDigestControllerState\n>;\n\nexport type AiDigestControllerEvents = AiDigestControllerStateChangeEvent;\n\nexport type AiDigestControllerMessenger = Messenger<\n  typeof controllerName,\n  AiDigestControllerActions,\n  AiDigestControllerEvents\n>;\n\nexport type AiDigestControllerOptions = {\n  messenger: AiDigestControllerMessenger;\n  digestService: DigestService;\n};\n\nexport function getDefaultAiDigestControllerState(): AiDigestControllerState {\n  return {};\n}\n\nconst aiDigestControllerMetadata: StateMetadata<AiDigestControllerState> = {};\n\nconst MESSENGER_EXPOSED_METHODS = [\n  'fetchMarketInsights',\n  'fetchMarketOverview',\n  'fetchFrontPageItem',\n] as const;\n\nexport class AiDigestController extends BaseController<\n  typeof controllerName,\n  AiDigestControllerState,\n  AiDigestControllerMessenger\n> {\n  readonly #digestService: DigestService;\n\n  constructor({ messenger, digestService }: AiDigestControllerOptions) {\n    super({\n      name: controllerName,\n      metadata: aiDigestControllerMetadata,\n      state: getDefaultAiDigestControllerState(),\n      messenger,\n    });\n\n    this.#digestService = digestService;\n    this.messenger.registerMethodActionHandlers(\n      this,\n      MESSENGER_EXPOSED_METHODS,\n    );\n  }\n\n  /**\n   * Fetches market insights for a given asset identifier.\n   *\n   * Accepts either a CAIP-19 asset type (e.g. `eip155:1/slip44:60`) or a perps\n   * market symbol (e.g. `ETH`). The service handles choosing the correct API\n   * query parameter automatically. Clients own freshness/caching.\n   *\n   * @param assetIdentifier - The asset identifier (CAIP-19 ID or perps market symbol).\n   * @returns The market insights report, or `null` if none exists.\n   */\n  async fetchMarketInsights(\n    assetIdentifier: string,\n  ): Promise<MarketInsightsReport | null> {\n    if (!assetIdentifier) {\n      throw new Error(AiDigestControllerErrorMessage.INVALID_ASSET_IDENTIFIER);\n    }\n\n    return this.#digestService.searchDigest(assetIdentifier);\n  }\n\n  /**\n   * Fetches the market overview report.\n   *\n   * Clients own freshness/caching.\n   *\n   * @returns The market overview report, or `null` if none exists.\n   */\n  async fetchMarketOverview(): Promise<MarketOverview | null> {\n    return this.#digestService.fetchMarketOverview();\n  }\n\n  /**\n   * Fetches a single market overview front page by id.\n   *\n   * Unlike the market overview report (which only returns the latest items),\n   * this resolves an older item that has since dropped out of the report, so\n   * clients can render it directly (e.g. from a deep link).\n   *\n   * @param id - The front-page identifier (UUID).\n   * @returns The market overview front page, or `null` if none exists.\n   */\n  async fetchFrontPageItem(\n    id: string,\n  ): Promise<MarketOverviewFrontPage | null> {\n    if (!id) {\n      throw new Error(AiDigestControllerErrorMessage.INVALID_FRONT_PAGE_ID);\n    }\n\n    return this.#digestService.fetchFrontPageItem(id);\n  }\n}\n"]}

package/dist/{AiDigestController.d.ts → AiDigestController.d.cts}

@@ -1,9 +1,9 @@
-import type { ControllerStateChangeEvent, ControllerGetStateAction } from '@metamask/base-controller';
-import { BaseController } from '@metamask/base-controller';
-import type { Messenger } from '@metamask/messenger';
-import { controllerName } from './ai-digest-constants.js';
-import type { AiDigestControllerState, DigestService, MarketInsightsReport, MarketOverview, MarketOverviewFrontPage } from './ai-digest-types.js';
-import type { AiDigestControllerMethodActions } from './AiDigestController-method-action-types.js';
+import type { ControllerStateChangeEvent, ControllerGetStateAction } from "@metamask/base-controller";
+import { BaseController } from "@metamask/base-controller";
+import type { Messenger } from "@metamask/messenger";
+import { controllerName } from "./ai-digest-constants.cjs";
+import type { AiDigestControllerState, DigestService, MarketInsightsReport, MarketOverview, MarketOverviewFrontPage } from "./ai-digest-types.cjs";
+import type { AiDigestControllerMethodActions } from "./AiDigestController-method-action-types.cjs";
 export type AiDigestControllerGetStateAction = ControllerGetStateAction<typeof controllerName, AiDigestControllerState>;
 export type AiDigestControllerActions = AiDigestControllerGetStateAction | AiDigestControllerMethodActions;
 export type AiDigestControllerStateChangeEvent = ControllerStateChangeEvent<typeof controllerName, AiDigestControllerState>;
@@ -11,20 +11,18 @@ export type AiDigestControllerEvents = AiDigestControllerStateChangeEvent;
 export type AiDigestControllerMessenger = Messenger<typeof controllerName, AiDigestControllerActions, AiDigestControllerEvents>;
 export type AiDigestControllerOptions = {
     messenger: AiDigestControllerMessenger;
-    state?: Partial<AiDigestControllerState>;
     digestService: DigestService;
 };
 export declare function getDefaultAiDigestControllerState(): AiDigestControllerState;
 export declare class AiDigestController extends BaseController<typeof controllerName, AiDigestControllerState, AiDigestControllerMessenger> {
     #private;
-    constructor({ messenger, state, digestService }: AiDigestControllerOptions);
+    constructor({ messenger, digestService }: AiDigestControllerOptions);
     /**
      * Fetches market insights for a given asset identifier.
-     * Returns cached data if still fresh, otherwise calls the service.
      *
      * Accepts either a CAIP-19 asset type (e.g. `eip155:1/slip44:60`) or a perps
      * market symbol (e.g. `ETH`). The service handles choosing the correct API
-     * query parameter automatically.
+     * query parameter automatically. Clients own freshness/caching.
      *
      * @param assetIdentifier - The asset identifier (CAIP-19 ID or perps market symbol).
      * @returns The market insights report, or `null` if none exists.
@@ -32,7 +30,8 @@ export declare class AiDigestController extends BaseController<typeof controller
     fetchMarketInsights(assetIdentifier: string): Promise<MarketInsightsReport | null>;
     /**
      * Fetches the market overview report.
-     * Returns cached data if still fresh, otherwise calls the service.
+     *
+     * Clients own freshness/caching.
      *
      * @returns The market overview report, or `null` if none exists.
      */
@@ -49,4 +48,4 @@ export declare class AiDigestController extends BaseController<typeof controller
      */
     fetchFrontPageItem(id: string): Promise<MarketOverviewFrontPage | null>;
 }
-//# sourceMappingURL=AiDigestController.d.ts.map
+//# sourceMappingURL=AiDigestController.d.cts.map

package/dist/AiDigestController.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AiDigestController.d.cts","sourceRoot":"","sources":["../src/AiDigestController.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,0BAA0B,EAC1B,wBAAwB,EACzB,kCAAkC;AACnC,OAAO,EAAE,cAAc,EAAE,kCAAkC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,4BAA4B;AAErD,OAAO,EAEL,cAAc,EACf,kCAAiC;AAClC,OAAO,KAAK,EACV,uBAAuB,EACvB,aAAa,EACb,oBAAoB,EACpB,cAAc,EACd,uBAAuB,EACxB,8BAA6B;AAC9B,OAAO,KAAK,EAAE,+BAA+B,EAAE,qDAAoD;AAEnG,MAAM,MAAM,gCAAgC,GAAG,wBAAwB,CACrE,OAAO,cAAc,EACrB,uBAAuB,CACxB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GACjC,gCAAgC,GAChC,+BAA+B,CAAC;AAEpC,MAAM,MAAM,kCAAkC,GAAG,0BAA0B,CACzE,OAAO,cAAc,EACrB,uBAAuB,CACxB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG,kCAAkC,CAAC;AAE1E,MAAM,MAAM,2BAA2B,GAAG,SAAS,CACjD,OAAO,cAAc,EACrB,yBAAyB,EACzB,wBAAwB,CACzB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,SAAS,EAAE,2BAA2B,CAAC;IACvC,aAAa,EAAE,aAAa,CAAC;CAC9B,CAAC;AAEF,wBAAgB,iCAAiC,IAAI,uBAAuB,CAE3E;AAUD,qBAAa,kBAAmB,SAAQ,cAAc,CACpD,OAAO,cAAc,EACrB,uBAAuB,EACvB,2BAA2B,CAC5B;;gBAGa,EAAE,SAAS,EAAE,aAAa,EAAE,EAAE,yBAAyB;IAenE;;;;;;;;;OASG;IACG,mBAAmB,CACvB,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IAQvC;;;;;;OAMG;IACG,mBAAmB,IAAI,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAI3D;;;;;;;;;OASG;IACG,kBAAkB,CACtB,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC;CAO3C"}

package/dist/AiDigestController.d.mts

@@ -0,0 +1,51 @@
+import type { ControllerStateChangeEvent, ControllerGetStateAction } from "@metamask/base-controller";
+import { BaseController } from "@metamask/base-controller";
+import type { Messenger } from "@metamask/messenger";
+import { controllerName } from "./ai-digest-constants.mjs";
+import type { AiDigestControllerState, DigestService, MarketInsightsReport, MarketOverview, MarketOverviewFrontPage } from "./ai-digest-types.mjs";
+import type { AiDigestControllerMethodActions } from "./AiDigestController-method-action-types.mjs";
+export type AiDigestControllerGetStateAction = ControllerGetStateAction<typeof controllerName, AiDigestControllerState>;
+export type AiDigestControllerActions = AiDigestControllerGetStateAction | AiDigestControllerMethodActions;
+export type AiDigestControllerStateChangeEvent = ControllerStateChangeEvent<typeof controllerName, AiDigestControllerState>;
+export type AiDigestControllerEvents = AiDigestControllerStateChangeEvent;
+export type AiDigestControllerMessenger = Messenger<typeof controllerName, AiDigestControllerActions, AiDigestControllerEvents>;
+export type AiDigestControllerOptions = {
+    messenger: AiDigestControllerMessenger;
+    digestService: DigestService;
+};
+export declare function getDefaultAiDigestControllerState(): AiDigestControllerState;
+export declare class AiDigestController extends BaseController<typeof controllerName, AiDigestControllerState, AiDigestControllerMessenger> {
+    #private;
+    constructor({ messenger, digestService }: AiDigestControllerOptions);
+    /**
+     * Fetches market insights for a given asset identifier.
+     *
+     * Accepts either a CAIP-19 asset type (e.g. `eip155:1/slip44:60`) or a perps
+     * market symbol (e.g. `ETH`). The service handles choosing the correct API
+     * query parameter automatically. Clients own freshness/caching.
+     *
+     * @param assetIdentifier - The asset identifier (CAIP-19 ID or perps market symbol).
+     * @returns The market insights report, or `null` if none exists.
+     */
+    fetchMarketInsights(assetIdentifier: string): Promise<MarketInsightsReport | null>;
+    /**
+     * Fetches the market overview report.
+     *
+     * Clients own freshness/caching.
+     *
+     * @returns The market overview report, or `null` if none exists.
+     */
+    fetchMarketOverview(): Promise<MarketOverview | null>;
+    /**
+     * 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.
+     */
+    fetchFrontPageItem(id: string): Promise<MarketOverviewFrontPage | null>;
+}
+//# sourceMappingURL=AiDigestController.d.mts.map

package/dist/AiDigestController.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AiDigestController.d.mts","sourceRoot":"","sources":["../src/AiDigestController.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,0BAA0B,EAC1B,wBAAwB,EACzB,kCAAkC;AACnC,OAAO,EAAE,cAAc,EAAE,kCAAkC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,4BAA4B;AAErD,OAAO,EAEL,cAAc,EACf,kCAAiC;AAClC,OAAO,KAAK,EACV,uBAAuB,EACvB,aAAa,EACb,oBAAoB,EACpB,cAAc,EACd,uBAAuB,EACxB,8BAA6B;AAC9B,OAAO,KAAK,EAAE,+BAA+B,EAAE,qDAAoD;AAEnG,MAAM,MAAM,gCAAgC,GAAG,wBAAwB,CACrE,OAAO,cAAc,EACrB,uBAAuB,CACxB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GACjC,gCAAgC,GAChC,+BAA+B,CAAC;AAEpC,MAAM,MAAM,kCAAkC,GAAG,0BAA0B,CACzE,OAAO,cAAc,EACrB,uBAAuB,CACxB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG,kCAAkC,CAAC;AAE1E,MAAM,MAAM,2BAA2B,GAAG,SAAS,CACjD,OAAO,cAAc,EACrB,yBAAyB,EACzB,wBAAwB,CACzB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,SAAS,EAAE,2BAA2B,CAAC;IACvC,aAAa,EAAE,aAAa,CAAC;CAC9B,CAAC;AAEF,wBAAgB,iCAAiC,IAAI,uBAAuB,CAE3E;AAUD,qBAAa,kBAAmB,SAAQ,cAAc,CACpD,OAAO,cAAc,EACrB,uBAAuB,EACvB,2BAA2B,CAC5B;;gBAGa,EAAE,SAAS,EAAE,aAAa,EAAE,EAAE,yBAAyB;IAenE;;;;;;;;;OASG;IACG,mBAAmB,CACvB,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IAQvC;;;;;;OAMG;IACG,mBAAmB,IAAI,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAI3D;;;;;;;;;OASG;IACG,kBAAkB,CACtB,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC;CAO3C"}

package/dist/AiDigestController.mjs

@@ -0,0 +1,80 @@
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _AiDigestController_digestService;
+import { BaseController } from "@metamask/base-controller";
+import { AiDigestControllerErrorMessage, controllerName } from "./ai-digest-constants.mjs";
+export function getDefaultAiDigestControllerState() {
+    return {};
+}
+const aiDigestControllerMetadata = {};
+const MESSENGER_EXPOSED_METHODS = [
+    'fetchMarketInsights',
+    'fetchMarketOverview',
+    'fetchFrontPageItem',
+];
+export class AiDigestController extends BaseController {
+    constructor({ messenger, digestService }) {
+        super({
+            name: controllerName,
+            metadata: aiDigestControllerMetadata,
+            state: getDefaultAiDigestControllerState(),
+            messenger,
+        });
+        _AiDigestController_digestService.set(this, void 0);
+        __classPrivateFieldSet(this, _AiDigestController_digestService, digestService, "f");
+        this.messenger.registerMethodActionHandlers(this, MESSENGER_EXPOSED_METHODS);
+    }
+    /**
+     * Fetches market insights for a given asset identifier.
+     *
+     * Accepts either a CAIP-19 asset type (e.g. `eip155:1/slip44:60`) or a perps
+     * market symbol (e.g. `ETH`). The service handles choosing the correct API
+     * query parameter automatically. Clients own freshness/caching.
+     *
+     * @param assetIdentifier - The asset identifier (CAIP-19 ID or perps market symbol).
+     * @returns The market insights report, or `null` if none exists.
+     */
+    async fetchMarketInsights(assetIdentifier) {
+        if (!assetIdentifier) {
+            throw new Error(AiDigestControllerErrorMessage.INVALID_ASSET_IDENTIFIER);
+        }
+        return __classPrivateFieldGet(this, _AiDigestController_digestService, "f").searchDigest(assetIdentifier);
+    }
+    /**
+     * Fetches the market overview report.
+     *
+     * Clients own freshness/caching.
+     *
+     * @returns The market overview report, or `null` if none exists.
+     */
+    async fetchMarketOverview() {
+        return __classPrivateFieldGet(this, _AiDigestController_digestService, "f").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.
+     */
+    async fetchFrontPageItem(id) {
+        if (!id) {
+            throw new Error(AiDigestControllerErrorMessage.INVALID_FRONT_PAGE_ID);
+        }
+        return __classPrivateFieldGet(this, _AiDigestController_digestService, "f").fetchFrontPageItem(id);
+    }
+}
+_AiDigestController_digestService = new WeakMap();
+//# sourceMappingURL=AiDigestController.mjs.map

package/dist/AiDigestController.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"AiDigestController.mjs","sourceRoot":"","sources":["../src/AiDigestController.ts"],"names":[],"mappings":";;;;;;;;;;;;AAKA,OAAO,EAAE,cAAc,EAAE,kCAAkC;AAG3D,OAAO,EACL,8BAA8B,EAC9B,cAAc,EACf,kCAAiC;AAqClC,MAAM,UAAU,iCAAiC;IAC/C,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,0BAA0B,GAA2C,EAAE,CAAC;AAE9E,MAAM,yBAAyB,GAAG;IAChC,qBAAqB;IACrB,qBAAqB;IACrB,oBAAoB;CACZ,CAAC;AAEX,MAAM,OAAO,kBAAmB,SAAQ,cAIvC;IAGC,YAAY,EAAE,SAAS,EAAE,aAAa,EAA6B;QACjE,KAAK,CAAC;YACJ,IAAI,EAAE,cAAc;YACpB,QAAQ,EAAE,0BAA0B;YACpC,KAAK,EAAE,iCAAiC,EAAE;YAC1C,SAAS;SACV,CAAC,CAAC;QARI,oDAA8B;QAUrC,uBAAA,IAAI,qCAAkB,aAAa,MAAA,CAAC;QACpC,IAAI,CAAC,SAAS,CAAC,4BAA4B,CACzC,IAAI,EACJ,yBAAyB,CAC1B,CAAC;IACJ,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,mBAAmB,CACvB,eAAuB;QAEvB,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,wBAAwB,CAAC,CAAC;QAC3E,CAAC;QAED,OAAO,uBAAA,IAAI,yCAAe,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC;IAC3D,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,mBAAmB;QACvB,OAAO,uBAAA,IAAI,yCAAe,CAAC,mBAAmB,EAAE,CAAC;IACnD,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,kBAAkB,CACtB,EAAU;QAEV,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,qBAAqB,CAAC,CAAC;QACxE,CAAC;QAED,OAAO,uBAAA,IAAI,yCAAe,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC;IACpD,CAAC;CACF","sourcesContent":["import type {\n  StateMetadata,\n  ControllerStateChangeEvent,\n  ControllerGetStateAction,\n} from '@metamask/base-controller';\nimport { BaseController } from '@metamask/base-controller';\nimport type { Messenger } from '@metamask/messenger';\n\nimport {\n  AiDigestControllerErrorMessage,\n  controllerName,\n} from './ai-digest-constants.js';\nimport type {\n  AiDigestControllerState,\n  DigestService,\n  MarketInsightsReport,\n  MarketOverview,\n  MarketOverviewFrontPage,\n} from './ai-digest-types.js';\nimport type { AiDigestControllerMethodActions } from './AiDigestController-method-action-types.js';\n\nexport type AiDigestControllerGetStateAction = ControllerGetStateAction<\n  typeof controllerName,\n  AiDigestControllerState\n>;\n\nexport type AiDigestControllerActions =\n  | AiDigestControllerGetStateAction\n  | AiDigestControllerMethodActions;\n\nexport type AiDigestControllerStateChangeEvent = ControllerStateChangeEvent<\n  typeof controllerName,\n  AiDigestControllerState\n>;\n\nexport type AiDigestControllerEvents = AiDigestControllerStateChangeEvent;\n\nexport type AiDigestControllerMessenger = Messenger<\n  typeof controllerName,\n  AiDigestControllerActions,\n  AiDigestControllerEvents\n>;\n\nexport type AiDigestControllerOptions = {\n  messenger: AiDigestControllerMessenger;\n  digestService: DigestService;\n};\n\nexport function getDefaultAiDigestControllerState(): AiDigestControllerState {\n  return {};\n}\n\nconst aiDigestControllerMetadata: StateMetadata<AiDigestControllerState> = {};\n\nconst MESSENGER_EXPOSED_METHODS = [\n  'fetchMarketInsights',\n  'fetchMarketOverview',\n  'fetchFrontPageItem',\n] as const;\n\nexport class AiDigestController extends BaseController<\n  typeof controllerName,\n  AiDigestControllerState,\n  AiDigestControllerMessenger\n> {\n  readonly #digestService: DigestService;\n\n  constructor({ messenger, digestService }: AiDigestControllerOptions) {\n    super({\n      name: controllerName,\n      metadata: aiDigestControllerMetadata,\n      state: getDefaultAiDigestControllerState(),\n      messenger,\n    });\n\n    this.#digestService = digestService;\n    this.messenger.registerMethodActionHandlers(\n      this,\n      MESSENGER_EXPOSED_METHODS,\n    );\n  }\n\n  /**\n   * Fetches market insights for a given asset identifier.\n   *\n   * Accepts either a CAIP-19 asset type (e.g. `eip155:1/slip44:60`) or a perps\n   * market symbol (e.g. `ETH`). The service handles choosing the correct API\n   * query parameter automatically. Clients own freshness/caching.\n   *\n   * @param assetIdentifier - The asset identifier (CAIP-19 ID or perps market symbol).\n   * @returns The market insights report, or `null` if none exists.\n   */\n  async fetchMarketInsights(\n    assetIdentifier: string,\n  ): Promise<MarketInsightsReport | null> {\n    if (!assetIdentifier) {\n      throw new Error(AiDigestControllerErrorMessage.INVALID_ASSET_IDENTIFIER);\n    }\n\n    return this.#digestService.searchDigest(assetIdentifier);\n  }\n\n  /**\n   * Fetches the market overview report.\n   *\n   * Clients own freshness/caching.\n   *\n   * @returns The market overview report, or `null` if none exists.\n   */\n  async fetchMarketOverview(): Promise<MarketOverview | null> {\n    return this.#digestService.fetchMarketOverview();\n  }\n\n  /**\n   * Fetches a single market overview front page by id.\n   *\n   * Unlike the market overview report (which only returns the latest items),\n   * this resolves an older item that has since dropped out of the report, so\n   * clients can render it directly (e.g. from a deep link).\n   *\n   * @param id - The front-page identifier (UUID).\n   * @returns The market overview front page, or `null` if none exists.\n   */\n  async fetchFrontPageItem(\n    id: string,\n  ): Promise<MarketOverviewFrontPage | null> {\n    if (!id) {\n      throw new Error(AiDigestControllerErrorMessage.INVALID_FRONT_PAGE_ID);\n    }\n\n    return this.#digestService.fetchFrontPageItem(id);\n  }\n}\n"]}