@metamask-previews/token-search-discovery-controller 1.0.0-preview-2ba45577

package/CHANGELOG.md

@@ -0,0 +1,21 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [1.0.0]
+
+### Added
+
+- Introduce the TokenSearchDiscoveryController ([#5142](https://github.com/MetaMask/core/pull/5142/))
+  - This controller manages token search and discovery through the Portfolio API
+- Introduce the TokenSearchApiService ([#5142](https://github.com/MetaMask/core/pull/5142/))
+  - This service is responsible for making requests to the Portfolio API
+  - Specifically, it handles the `tokens-search` endpoint which returns a list of tokens based on the provided query parameters
+
+[Unreleased]: https://github.com/MetaMask/core/compare/@metamask/token-search-discovery-controller@1.0.0...HEAD
+[1.0.0]: https://github.com/MetaMask/core/releases/tag/@metamask/token-search-discovery-controller@1.0.0

package/LICENSE

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright (c) 2025 MetaMask
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE

package/README.md

@@ -0,0 +1,15 @@
+# `@metamask/token-search-discovery-controller`
+
+Manages token search and discovery through the Portfolio API.
+
+## Installation
+
+`yarn add @metamask/token-search-discovery-controller`
+
+or
+
+`npm install @metamask/token-search-discovery-controller`
+
+## Contributing
+
+This package is part of a monorepo. Instructions for contributing can be found in the [monorepo README](https://github.com/MetaMask/core#readme).

package/dist/index.cjs

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TokenSearchApiService = exports.AbstractTokenSearchApiService = exports.TokenSearchDiscoveryController = void 0;
+var token_search_discovery_controller_1 = require("./token-search-discovery-controller.cjs");
+Object.defineProperty(exports, "TokenSearchDiscoveryController", { enumerable: true, get: function () { return token_search_discovery_controller_1.TokenSearchDiscoveryController; } });
+var abstract_token_search_api_service_1 = require("./token-search-api-service/abstract-token-search-api-service.cjs");
+Object.defineProperty(exports, "AbstractTokenSearchApiService", { enumerable: true, get: function () { return abstract_token_search_api_service_1.AbstractTokenSearchApiService; } });
+var token_search_api_service_1 = require("./token-search-api-service/token-search-api-service.cjs");
+Object.defineProperty(exports, "TokenSearchApiService", { enumerable: true, get: function () { return token_search_api_service_1.TokenSearchApiService; } });
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,6FAAqF;AAA5E,mJAAA,8BAA8B,OAAA;AAIvC,sHAA6G;AAApG,kJAAA,6BAA6B,OAAA;AACtC,oGAA4F;AAAnF,iIAAA,qBAAqB,OAAA","sourcesContent":["export { TokenSearchDiscoveryController } from './token-search-discovery-controller';\nexport type { TokenSearchDiscoveryControllerState } from './token-search-discovery-controller';\nexport type { TokenSearchResponseItem } from './types';\n\nexport { AbstractTokenSearchApiService } from './token-search-api-service/abstract-token-search-api-service';\nexport { TokenSearchApiService } from './token-search-api-service/token-search-api-service';\n"]}

package/dist/index.d.cts

@@ -0,0 +1,6 @@
+export { TokenSearchDiscoveryController } from "./token-search-discovery-controller.cjs";
+export type { TokenSearchDiscoveryControllerState } from "./token-search-discovery-controller.cjs";
+export type { TokenSearchResponseItem } from "./types.cjs";
+export { AbstractTokenSearchApiService } from "./token-search-api-service/abstract-token-search-api-service.cjs";
+export { TokenSearchApiService } from "./token-search-api-service/token-search-api-service.cjs";
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,gDAA4C;AACrF,YAAY,EAAE,mCAAmC,EAAE,gDAA4C;AAC/F,YAAY,EAAE,uBAAuB,EAAE,oBAAgB;AAEvD,OAAO,EAAE,6BAA6B,EAAE,yEAAqE;AAC7G,OAAO,EAAE,qBAAqB,EAAE,gEAA4D"}

package/dist/index.d.mts

@@ -0,0 +1,6 @@
+export { TokenSearchDiscoveryController } from "./token-search-discovery-controller.mjs";
+export type { TokenSearchDiscoveryControllerState } from "./token-search-discovery-controller.mjs";
+export type { TokenSearchResponseItem } from "./types.mjs";
+export { AbstractTokenSearchApiService } from "./token-search-api-service/abstract-token-search-api-service.mjs";
+export { TokenSearchApiService } from "./token-search-api-service/token-search-api-service.mjs";
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,gDAA4C;AACrF,YAAY,EAAE,mCAAmC,EAAE,gDAA4C;AAC/F,YAAY,EAAE,uBAAuB,EAAE,oBAAgB;AAEvD,OAAO,EAAE,6BAA6B,EAAE,yEAAqE;AAC7G,OAAO,EAAE,qBAAqB,EAAE,gEAA4D"}

package/dist/index.mjs

@@ -0,0 +1,4 @@
+export { TokenSearchDiscoveryController } from "./token-search-discovery-controller.mjs";
+export { AbstractTokenSearchApiService } from "./token-search-api-service/abstract-token-search-api-service.mjs";
+export { TokenSearchApiService } from "./token-search-api-service/token-search-api-service.mjs";
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,gDAA4C;AAIrF,OAAO,EAAE,6BAA6B,EAAE,yEAAqE;AAC7G,OAAO,EAAE,qBAAqB,EAAE,gEAA4D","sourcesContent":["export { TokenSearchDiscoveryController } from './token-search-discovery-controller';\nexport type { TokenSearchDiscoveryControllerState } from './token-search-discovery-controller';\nexport type { TokenSearchResponseItem } from './types';\n\nexport { AbstractTokenSearchApiService } from './token-search-api-service/abstract-token-search-api-service';\nexport { TokenSearchApiService } from './token-search-api-service/token-search-api-service';\n"]}

package/dist/token-search-api-service/abstract-token-search-api-service.cjs

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AbstractTokenSearchApiService = void 0;
+/**
+ * Abstract class for fetching token search results.
+ */
+class AbstractTokenSearchApiService {
+}
+exports.AbstractTokenSearchApiService = AbstractTokenSearchApiService;
+//# sourceMappingURL=abstract-token-search-api-service.cjs.map

package/dist/token-search-api-service/abstract-token-search-api-service.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract-token-search-api-service.cjs","sourceRoot":"","sources":["../../src/token-search-api-service/abstract-token-search-api-service.ts"],"names":[],"mappings":";;;AAEA;;GAEG;AACH,MAAsB,6BAA6B;CAUlD;AAVD,sEAUC","sourcesContent":["import type { TokenSearchParams, TokenSearchResponseItem } from '../types';\n\n/**\n * Abstract class for fetching token search results.\n */\nexport abstract class AbstractTokenSearchApiService {\n  /**\n   * Fetches token search results from the portfolio API.\n   *\n   * @param tokenSearchParams - Optional search parameters including chains, name, and limit {@link TokenSearchParams}\n   * @returns A promise resolving to an array of {@link TokenSearchResponseItem}\n   */\n  abstract searchTokens(\n    tokenSearchParams?: TokenSearchParams,\n  ): Promise<TokenSearchResponseItem[]>;\n}\n"]}

package/dist/token-search-api-service/abstract-token-search-api-service.d.cts

@@ -0,0 +1,14 @@
+import type { TokenSearchParams, TokenSearchResponseItem } from "../types.cjs";
+/**
+ * Abstract class for fetching token search results.
+ */
+export declare abstract class AbstractTokenSearchApiService {
+    /**
+     * Fetches token search results from the portfolio API.
+     *
+     * @param tokenSearchParams - Optional search parameters including chains, name, and limit {@link TokenSearchParams}
+     * @returns A promise resolving to an array of {@link TokenSearchResponseItem}
+     */
+    abstract searchTokens(tokenSearchParams?: TokenSearchParams): Promise<TokenSearchResponseItem[]>;
+}
+//# sourceMappingURL=abstract-token-search-api-service.d.cts.map

package/dist/token-search-api-service/abstract-token-search-api-service.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract-token-search-api-service.d.cts","sourceRoot":"","sources":["../../src/token-search-api-service/abstract-token-search-api-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,qBAAiB;AAE3E;;GAEG;AACH,8BAAsB,6BAA6B;IACjD;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,CACnB,iBAAiB,CAAC,EAAE,iBAAiB,GACpC,OAAO,CAAC,uBAAuB,EAAE,CAAC;CACtC"}

package/dist/token-search-api-service/abstract-token-search-api-service.d.mts

@@ -0,0 +1,14 @@
+import type { TokenSearchParams, TokenSearchResponseItem } from "../types.mjs";
+/**
+ * Abstract class for fetching token search results.
+ */
+export declare abstract class AbstractTokenSearchApiService {
+    /**
+     * Fetches token search results from the portfolio API.
+     *
+     * @param tokenSearchParams - Optional search parameters including chains, name, and limit {@link TokenSearchParams}
+     * @returns A promise resolving to an array of {@link TokenSearchResponseItem}
+     */
+    abstract searchTokens(tokenSearchParams?: TokenSearchParams): Promise<TokenSearchResponseItem[]>;
+}
+//# sourceMappingURL=abstract-token-search-api-service.d.mts.map

package/dist/token-search-api-service/abstract-token-search-api-service.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract-token-search-api-service.d.mts","sourceRoot":"","sources":["../../src/token-search-api-service/abstract-token-search-api-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,qBAAiB;AAE3E;;GAEG;AACH,8BAAsB,6BAA6B;IACjD;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,CACnB,iBAAiB,CAAC,EAAE,iBAAiB,GACpC,OAAO,CAAC,uBAAuB,EAAE,CAAC;CACtC"}

package/dist/token-search-api-service/abstract-token-search-api-service.mjs

@@ -0,0 +1,6 @@
+/**
+ * Abstract class for fetching token search results.
+ */
+export class AbstractTokenSearchApiService {
+}
+//# sourceMappingURL=abstract-token-search-api-service.mjs.map

package/dist/token-search-api-service/abstract-token-search-api-service.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract-token-search-api-service.mjs","sourceRoot":"","sources":["../../src/token-search-api-service/abstract-token-search-api-service.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,OAAgB,6BAA6B;CAUlD","sourcesContent":["import type { TokenSearchParams, TokenSearchResponseItem } from '../types';\n\n/**\n * Abstract class for fetching token search results.\n */\nexport abstract class AbstractTokenSearchApiService {\n  /**\n   * Fetches token search results from the portfolio API.\n   *\n   * @param tokenSearchParams - Optional search parameters including chains, name, and limit {@link TokenSearchParams}\n   * @returns A promise resolving to an array of {@link TokenSearchResponseItem}\n   */\n  abstract searchTokens(\n    tokenSearchParams?: TokenSearchParams,\n  ): Promise<TokenSearchResponseItem[]>;\n}\n"]}

package/dist/token-search-api-service/token-search-api-service.cjs

@@ -0,0 +1,51 @@
+"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 _TokenSearchApiService_baseUrl;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TokenSearchApiService = void 0;
+const abstract_token_search_api_service_1 = require("./abstract-token-search-api-service.cjs");
+class TokenSearchApiService extends abstract_token_search_api_service_1.AbstractTokenSearchApiService {
+    constructor(baseUrl) {
+        super();
+        _TokenSearchApiService_baseUrl.set(this, void 0);
+        if (!baseUrl) {
+            throw new Error('Portfolio API URL is not set');
+        }
+        __classPrivateFieldSet(this, _TokenSearchApiService_baseUrl, baseUrl, "f");
+    }
+    async searchTokens(tokenSearchParams) {
+        const url = new URL('/tokens-search/name', __classPrivateFieldGet(this, _TokenSearchApiService_baseUrl, "f"));
+        if (tokenSearchParams?.chains && tokenSearchParams.chains.length > 0) {
+            url.searchParams.append('chains', tokenSearchParams.chains.join());
+        }
+        if (tokenSearchParams?.name) {
+            url.searchParams.append('name', tokenSearchParams.name);
+        }
+        if (tokenSearchParams?.limit) {
+            url.searchParams.append('limit', tokenSearchParams.limit);
+        }
+        const response = await fetch(url, {
+            method: 'GET',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+        });
+        if (!response.ok) {
+            throw new Error(`Portfolio API request failed with status: ${response.status}`);
+        }
+        return response.json();
+    }
+}
+exports.TokenSearchApiService = TokenSearchApiService;
+_TokenSearchApiService_baseUrl = new WeakMap();
+//# sourceMappingURL=token-search-api-service.cjs.map

package/dist/token-search-api-service/token-search-api-service.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-search-api-service.cjs","sourceRoot":"","sources":["../../src/token-search-api-service/token-search-api-service.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,+FAAoF;AAGpF,MAAa,qBAAsB,SAAQ,iEAA6B;IAGtE,YAAY,OAAe;QACzB,KAAK,EAAE,CAAC;QAHD,iDAAiB;QAIxB,IAAI,CAAC,OAAO,EAAE;YACZ,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;SACjD;QACD,uBAAA,IAAI,kCAAY,OAAO,MAAA,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,YAAY,CAChB,iBAAqC;QAErC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,qBAAqB,EAAE,uBAAA,IAAI,sCAAS,CAAC,CAAC;QAE1D,IAAI,iBAAiB,EAAE,MAAM,IAAI,iBAAiB,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE;YACpE,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,QAAQ,EAAE,iBAAiB,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;SACpE;QACD,IAAI,iBAAiB,EAAE,IAAI,EAAE;YAC3B,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,IAAI,CAAC,CAAC;SACzD;QACD,IAAI,iBAAiB,EAAE,KAAK,EAAE;YAC5B,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,OAAO,EAAE,iBAAiB,CAAC,KAAK,CAAC,CAAC;SAC3D;QAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,MAAM,EAAE,KAAK;YACb,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;aACnC;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE;YAChB,MAAM,IAAI,KAAK,CACb,6CAA6C,QAAQ,CAAC,MAAM,EAAE,CAC/D,CAAC;SACH;QAED,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;IACzB,CAAC;CACF;AAzCD,sDAyCC","sourcesContent":["import { AbstractTokenSearchApiService } from './abstract-token-search-api-service';\nimport type { TokenSearchParams, TokenSearchResponseItem } from '../types';\n\nexport class TokenSearchApiService extends AbstractTokenSearchApiService {\n  readonly #baseUrl: string;\n\n  constructor(baseUrl: string) {\n    super();\n    if (!baseUrl) {\n      throw new Error('Portfolio API URL is not set');\n    }\n    this.#baseUrl = baseUrl;\n  }\n\n  async searchTokens(\n    tokenSearchParams?: TokenSearchParams,\n  ): Promise<TokenSearchResponseItem[]> {\n    const url = new URL('/tokens-search/name', this.#baseUrl);\n\n    if (tokenSearchParams?.chains && tokenSearchParams.chains.length > 0) {\n      url.searchParams.append('chains', tokenSearchParams.chains.join());\n    }\n    if (tokenSearchParams?.name) {\n      url.searchParams.append('name', tokenSearchParams.name);\n    }\n    if (tokenSearchParams?.limit) {\n      url.searchParams.append('limit', tokenSearchParams.limit);\n    }\n\n    const response = await fetch(url, {\n      method: 'GET',\n      headers: {\n        'Content-Type': 'application/json',\n      },\n    });\n\n    if (!response.ok) {\n      throw new Error(\n        `Portfolio API request failed with status: ${response.status}`,\n      );\n    }\n\n    return response.json();\n  }\n}\n"]}

package/dist/token-search-api-service/token-search-api-service.d.cts

@@ -0,0 +1,8 @@
+import { AbstractTokenSearchApiService } from "./abstract-token-search-api-service.cjs";
+import type { TokenSearchParams, TokenSearchResponseItem } from "../types.cjs";
+export declare class TokenSearchApiService extends AbstractTokenSearchApiService {
+    #private;
+    constructor(baseUrl: string);
+    searchTokens(tokenSearchParams?: TokenSearchParams): Promise<TokenSearchResponseItem[]>;
+}
+//# sourceMappingURL=token-search-api-service.d.cts.map

package/dist/token-search-api-service/token-search-api-service.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-search-api-service.d.cts","sourceRoot":"","sources":["../../src/token-search-api-service/token-search-api-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,gDAA4C;AACpF,OAAO,KAAK,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,qBAAiB;AAE3E,qBAAa,qBAAsB,SAAQ,6BAA6B;;gBAG1D,OAAO,EAAE,MAAM;IAQrB,YAAY,CAChB,iBAAiB,CAAC,EAAE,iBAAiB,GACpC,OAAO,CAAC,uBAAuB,EAAE,CAAC;CA4BtC"}

package/dist/token-search-api-service/token-search-api-service.d.mts

@@ -0,0 +1,8 @@
+import { AbstractTokenSearchApiService } from "./abstract-token-search-api-service.mjs";
+import type { TokenSearchParams, TokenSearchResponseItem } from "../types.mjs";
+export declare class TokenSearchApiService extends AbstractTokenSearchApiService {
+    #private;
+    constructor(baseUrl: string);
+    searchTokens(tokenSearchParams?: TokenSearchParams): Promise<TokenSearchResponseItem[]>;
+}
+//# sourceMappingURL=token-search-api-service.d.mts.map

package/dist/token-search-api-service/token-search-api-service.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-search-api-service.d.mts","sourceRoot":"","sources":["../../src/token-search-api-service/token-search-api-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,gDAA4C;AACpF,OAAO,KAAK,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,qBAAiB;AAE3E,qBAAa,qBAAsB,SAAQ,6BAA6B;;gBAG1D,OAAO,EAAE,MAAM;IAQrB,YAAY,CAChB,iBAAiB,CAAC,EAAE,iBAAiB,GACpC,OAAO,CAAC,uBAAuB,EAAE,CAAC;CA4BtC"}

package/dist/token-search-api-service/token-search-api-service.mjs

@@ -0,0 +1,47 @@
+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 _TokenSearchApiService_baseUrl;
+import { AbstractTokenSearchApiService } from "./abstract-token-search-api-service.mjs";
+export class TokenSearchApiService extends AbstractTokenSearchApiService {
+    constructor(baseUrl) {
+        super();
+        _TokenSearchApiService_baseUrl.set(this, void 0);
+        if (!baseUrl) {
+            throw new Error('Portfolio API URL is not set');
+        }
+        __classPrivateFieldSet(this, _TokenSearchApiService_baseUrl, baseUrl, "f");
+    }
+    async searchTokens(tokenSearchParams) {
+        const url = new URL('/tokens-search/name', __classPrivateFieldGet(this, _TokenSearchApiService_baseUrl, "f"));
+        if (tokenSearchParams?.chains && tokenSearchParams.chains.length > 0) {
+            url.searchParams.append('chains', tokenSearchParams.chains.join());
+        }
+        if (tokenSearchParams?.name) {
+            url.searchParams.append('name', tokenSearchParams.name);
+        }
+        if (tokenSearchParams?.limit) {
+            url.searchParams.append('limit', tokenSearchParams.limit);
+        }
+        const response = await fetch(url, {
+            method: 'GET',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+        });
+        if (!response.ok) {
+            throw new Error(`Portfolio API request failed with status: ${response.status}`);
+        }
+        return response.json();
+    }
+}
+_TokenSearchApiService_baseUrl = new WeakMap();
+//# sourceMappingURL=token-search-api-service.mjs.map

package/dist/token-search-api-service/token-search-api-service.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-search-api-service.mjs","sourceRoot":"","sources":["../../src/token-search-api-service/token-search-api-service.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,OAAO,EAAE,6BAA6B,EAAE,gDAA4C;AAGpF,MAAM,OAAO,qBAAsB,SAAQ,6BAA6B;IAGtE,YAAY,OAAe;QACzB,KAAK,EAAE,CAAC;QAHD,iDAAiB;QAIxB,IAAI,CAAC,OAAO,EAAE;YACZ,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;SACjD;QACD,uBAAA,IAAI,kCAAY,OAAO,MAAA,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,YAAY,CAChB,iBAAqC;QAErC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,qBAAqB,EAAE,uBAAA,IAAI,sCAAS,CAAC,CAAC;QAE1D,IAAI,iBAAiB,EAAE,MAAM,IAAI,iBAAiB,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE;YACpE,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,QAAQ,EAAE,iBAAiB,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;SACpE;QACD,IAAI,iBAAiB,EAAE,IAAI,EAAE;YAC3B,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,IAAI,CAAC,CAAC;SACzD;QACD,IAAI,iBAAiB,EAAE,KAAK,EAAE;YAC5B,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,OAAO,EAAE,iBAAiB,CAAC,KAAK,CAAC,CAAC;SAC3D;QAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,MAAM,EAAE,KAAK;YACb,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;aACnC;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE;YAChB,MAAM,IAAI,KAAK,CACb,6CAA6C,QAAQ,CAAC,MAAM,EAAE,CAC/D,CAAC;SACH;QAED,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;IACzB,CAAC;CACF","sourcesContent":["import { AbstractTokenSearchApiService } from './abstract-token-search-api-service';\nimport type { TokenSearchParams, TokenSearchResponseItem } from '../types';\n\nexport class TokenSearchApiService extends AbstractTokenSearchApiService {\n  readonly #baseUrl: string;\n\n  constructor(baseUrl: string) {\n    super();\n    if (!baseUrl) {\n      throw new Error('Portfolio API URL is not set');\n    }\n    this.#baseUrl = baseUrl;\n  }\n\n  async searchTokens(\n    tokenSearchParams?: TokenSearchParams,\n  ): Promise<TokenSearchResponseItem[]> {\n    const url = new URL('/tokens-search/name', this.#baseUrl);\n\n    if (tokenSearchParams?.chains && tokenSearchParams.chains.length > 0) {\n      url.searchParams.append('chains', tokenSearchParams.chains.join());\n    }\n    if (tokenSearchParams?.name) {\n      url.searchParams.append('name', tokenSearchParams.name);\n    }\n    if (tokenSearchParams?.limit) {\n      url.searchParams.append('limit', tokenSearchParams.limit);\n    }\n\n    const response = await fetch(url, {\n      method: 'GET',\n      headers: {\n        'Content-Type': 'application/json',\n      },\n    });\n\n    if (!response.ok) {\n      throw new Error(\n        `Portfolio API request failed with status: ${response.status}`,\n      );\n    }\n\n    return response.json();\n  }\n}\n"]}

package/dist/token-search-discovery-controller.cjs

@@ -0,0 +1,64 @@
+"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 _TokenSearchDiscoveryController_tokenSearchService;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TokenSearchDiscoveryController = exports.getDefaultTokenSearchDiscoveryControllerState = void 0;
+const base_controller_1 = require("@metamask/base-controller");
+// === GENERAL ===
+const controllerName = 'TokenSearchDiscoveryController';
+const tokenSearchDiscoveryControllerMetadata = {
+    recentSearches: { persist: true, anonymous: false },
+    lastSearchTimestamp: { persist: true, anonymous: false },
+};
+/**
+ * Constructs the default {@link TokenSearchDiscoveryController} state. This allows
+ * consumers to provide a partial state object when initializing the controller
+ * and also helps in constructing complete state objects for this controller in
+ * tests.
+ *
+ * @returns The default {@link TokenSearchDiscoveryController} state.
+ */
+function getDefaultTokenSearchDiscoveryControllerState() {
+    return {
+        recentSearches: [],
+        lastSearchTimestamp: null,
+    };
+}
+exports.getDefaultTokenSearchDiscoveryControllerState = getDefaultTokenSearchDiscoveryControllerState;
+/**
+ * The TokenSearchDiscoveryController manages the retrieval of token search results and token discovery.
+ * It fetches token search results from the portfolio API.
+ */
+class TokenSearchDiscoveryController extends base_controller_1.BaseController {
+    constructor({ tokenSearchService, state = {}, messenger, }) {
+        super({
+            name: controllerName,
+            metadata: tokenSearchDiscoveryControllerMetadata,
+            messenger,
+            state: { ...getDefaultTokenSearchDiscoveryControllerState(), ...state },
+        });
+        _TokenSearchDiscoveryController_tokenSearchService.set(this, void 0);
+        __classPrivateFieldSet(this, _TokenSearchDiscoveryController_tokenSearchService, tokenSearchService, "f");
+    }
+    async searchTokens(tokenSearchParams) {
+        const results = await __classPrivateFieldGet(this, _TokenSearchDiscoveryController_tokenSearchService, "f").searchTokens(tokenSearchParams);
+        this.update((state) => {
+            state.recentSearches = results;
+            state.lastSearchTimestamp = Date.now();
+        });
+        return results;
+    }
+}
+exports.TokenSearchDiscoveryController = TokenSearchDiscoveryController;
+_TokenSearchDiscoveryController_tokenSearchService = new WeakMap();
+//# sourceMappingURL=token-search-discovery-controller.cjs.map

package/dist/token-search-discovery-controller.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-search-discovery-controller.cjs","sourceRoot":"","sources":["../src/token-search-discovery-controller.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAKA,+DAA2D;AAK3D,kBAAkB;AAElB,MAAM,cAAc,GAAG,gCAAgC,CAAC;AASxD,MAAM,sCAAsC,GAAG;IAC7C,cAAc,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE;IACnD,mBAAmB,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE;CAChD,CAAC;AA6DX;;;;;;;GAOG;AACH,SAAgB,6CAA6C;IAC3D,OAAO;QACL,cAAc,EAAE,EAAE;QAClB,mBAAmB,EAAE,IAAI;KAC1B,CAAC;AACJ,CAAC;AALD,sGAKC;AAED;;;GAGG;AACH,MAAa,8BAA+B,SAAQ,gCAInD;IAGC,YAAY,EACV,kBAAkB,EAClB,KAAK,GAAG,EAAE,EACV,SAAS,GAKV;QACC,KAAK,CAAC;YACJ,IAAI,EAAE,cAAc;YACpB,QAAQ,EAAE,sCAAsC;YAChD,SAAS;YACT,KAAK,EAAE,EAAE,GAAG,6CAA6C,EAAE,EAAE,GAAG,KAAK,EAAE;SACxE,CAAC,CAAC;QAhBI,qEAAmD;QAkB1D,uBAAA,IAAI,sDAAuB,kBAAkB,MAAA,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,YAAY,CAChB,iBAAoC;QAEpC,MAAM,OAAO,GACX,MAAM,uBAAA,IAAI,0DAAoB,CAAC,YAAY,CAAC,iBAAiB,CAAC,CAAC;QAEjE,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;YACpB,KAAK,CAAC,cAAc,GAAG,OAAO,CAAC;YAC/B,KAAK,CAAC,mBAAmB,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzC,CAAC,CAAC,CAAC;QAEH,OAAO,OAAO,CAAC;IACjB,CAAC;CACF;AAvCD,wEAuCC","sourcesContent":["import type {\n  ControllerGetStateAction,\n  ControllerStateChangeEvent,\n  RestrictedControllerMessenger,\n} from '@metamask/base-controller';\nimport { BaseController } from '@metamask/base-controller';\n\nimport type { AbstractTokenSearchApiService } from './token-search-api-service/abstract-token-search-api-service';\nimport type { TokenSearchParams, TokenSearchResponseItem } from './types';\n\n// === GENERAL ===\n\nconst controllerName = 'TokenSearchDiscoveryController';\n\n// === STATE ===\n\nexport type TokenSearchDiscoveryControllerState = {\n  recentSearches: TokenSearchResponseItem[];\n  lastSearchTimestamp: number | null;\n};\n\nconst tokenSearchDiscoveryControllerMetadata = {\n  recentSearches: { persist: true, anonymous: false },\n  lastSearchTimestamp: { persist: true, anonymous: false },\n} as const;\n\n// === MESSENGER ===\n\n/**\n * The action which can be used to retrieve the state of the\n * {@link TokenSearchDiscoveryController}.\n */\nexport type TokenSearchDiscoveryControllerGetStateAction =\n  ControllerGetStateAction<\n    typeof controllerName,\n    TokenSearchDiscoveryControllerState\n  >;\n\n/**\n * All actions that {@link TokenSearchDiscoveryController} registers, to be\n * called externally.\n */\nexport type TokenSearchDiscoveryControllerActions =\n  TokenSearchDiscoveryControllerGetStateAction;\n\n/**\n * All actions that {@link TokenSearchDiscoveryController} calls internally.\n */\ntype AllowedActions = never;\n\n/**\n * The event that {@link TokenSearchDiscoveryController} publishes when updating\n * state.\n */\nexport type TokenSearchDiscoveryControllerStateChangeEvent =\n  ControllerStateChangeEvent<\n    typeof controllerName,\n    TokenSearchDiscoveryControllerState\n  >;\n\n/**\n * All events that {@link TokenSearchDiscoveryController} publishes, to be\n * subscribed to externally.\n */\nexport type TokenSearchDiscoveryControllerEvents =\n  TokenSearchDiscoveryControllerStateChangeEvent;\n\n/**\n * All events that {@link TokenSearchDiscoveryController} subscribes to internally.\n */\ntype AllowedEvents = never;\n\n/**\n * The messenger which is restricted to actions and events accessed by\n * {@link TokenSearchDiscoveryController}.\n */\nexport type TokenSearchDiscoveryControllerMessenger =\n  RestrictedControllerMessenger<\n    typeof controllerName,\n    TokenSearchDiscoveryControllerActions | AllowedActions,\n    TokenSearchDiscoveryControllerEvents | AllowedEvents,\n    AllowedActions['type'],\n    AllowedEvents['type']\n  >;\n\n/**\n * Constructs the default {@link TokenSearchDiscoveryController} state. This allows\n * consumers to provide a partial state object when initializing the controller\n * and also helps in constructing complete state objects for this controller in\n * tests.\n *\n * @returns The default {@link TokenSearchDiscoveryController} state.\n */\nexport function getDefaultTokenSearchDiscoveryControllerState(): TokenSearchDiscoveryControllerState {\n  return {\n    recentSearches: [],\n    lastSearchTimestamp: null,\n  };\n}\n\n/**\n * The TokenSearchDiscoveryController manages the retrieval of token search results and token discovery.\n * It fetches token search results from the portfolio API.\n */\nexport class TokenSearchDiscoveryController extends BaseController<\n  typeof controllerName,\n  TokenSearchDiscoveryControllerState,\n  TokenSearchDiscoveryControllerMessenger\n> {\n  readonly #tokenSearchService: AbstractTokenSearchApiService;\n\n  constructor({\n    tokenSearchService,\n    state = {},\n    messenger,\n  }: {\n    tokenSearchService: AbstractTokenSearchApiService;\n    state?: Partial<TokenSearchDiscoveryControllerState>;\n    messenger: TokenSearchDiscoveryControllerMessenger;\n  }) {\n    super({\n      name: controllerName,\n      metadata: tokenSearchDiscoveryControllerMetadata,\n      messenger,\n      state: { ...getDefaultTokenSearchDiscoveryControllerState(), ...state },\n    });\n\n    this.#tokenSearchService = tokenSearchService;\n  }\n\n  async searchTokens(\n    tokenSearchParams: TokenSearchParams,\n  ): Promise<TokenSearchResponseItem[]> {\n    const results =\n      await this.#tokenSearchService.searchTokens(tokenSearchParams);\n\n    this.update((state) => {\n      state.recentSearches = results;\n      state.lastSearchTimestamp = Date.now();\n    });\n\n    return results;\n  }\n}\n"]}

package/dist/token-search-discovery-controller.d.cts

@@ -0,0 +1,66 @@
+import type { ControllerGetStateAction, ControllerStateChangeEvent, RestrictedControllerMessenger } from "@metamask/base-controller";
+import { BaseController } from "@metamask/base-controller";
+import type { AbstractTokenSearchApiService } from "./token-search-api-service/abstract-token-search-api-service.cjs";
+import type { TokenSearchParams, TokenSearchResponseItem } from "./types.cjs";
+declare const controllerName = "TokenSearchDiscoveryController";
+export type TokenSearchDiscoveryControllerState = {
+    recentSearches: TokenSearchResponseItem[];
+    lastSearchTimestamp: number | null;
+};
+/**
+ * The action which can be used to retrieve the state of the
+ * {@link TokenSearchDiscoveryController}.
+ */
+export type TokenSearchDiscoveryControllerGetStateAction = ControllerGetStateAction<typeof controllerName, TokenSearchDiscoveryControllerState>;
+/**
+ * All actions that {@link TokenSearchDiscoveryController} registers, to be
+ * called externally.
+ */
+export type TokenSearchDiscoveryControllerActions = TokenSearchDiscoveryControllerGetStateAction;
+/**
+ * All actions that {@link TokenSearchDiscoveryController} calls internally.
+ */
+type AllowedActions = never;
+/**
+ * The event that {@link TokenSearchDiscoveryController} publishes when updating
+ * state.
+ */
+export type TokenSearchDiscoveryControllerStateChangeEvent = ControllerStateChangeEvent<typeof controllerName, TokenSearchDiscoveryControllerState>;
+/**
+ * All events that {@link TokenSearchDiscoveryController} publishes, to be
+ * subscribed to externally.
+ */
+export type TokenSearchDiscoveryControllerEvents = TokenSearchDiscoveryControllerStateChangeEvent;
+/**
+ * All events that {@link TokenSearchDiscoveryController} subscribes to internally.
+ */
+type AllowedEvents = never;
+/**
+ * The messenger which is restricted to actions and events accessed by
+ * {@link TokenSearchDiscoveryController}.
+ */
+export type TokenSearchDiscoveryControllerMessenger = RestrictedControllerMessenger<typeof controllerName, TokenSearchDiscoveryControllerActions | AllowedActions, TokenSearchDiscoveryControllerEvents | AllowedEvents, AllowedActions['type'], AllowedEvents['type']>;
+/**
+ * Constructs the default {@link TokenSearchDiscoveryController} state. This allows
+ * consumers to provide a partial state object when initializing the controller
+ * and also helps in constructing complete state objects for this controller in
+ * tests.
+ *
+ * @returns The default {@link TokenSearchDiscoveryController} state.
+ */
+export declare function getDefaultTokenSearchDiscoveryControllerState(): TokenSearchDiscoveryControllerState;
+/**
+ * The TokenSearchDiscoveryController manages the retrieval of token search results and token discovery.
+ * It fetches token search results from the portfolio API.
+ */
+export declare class TokenSearchDiscoveryController extends BaseController<typeof controllerName, TokenSearchDiscoveryControllerState, TokenSearchDiscoveryControllerMessenger> {
+    #private;
+    constructor({ tokenSearchService, state, messenger, }: {
+        tokenSearchService: AbstractTokenSearchApiService;
+        state?: Partial<TokenSearchDiscoveryControllerState>;
+        messenger: TokenSearchDiscoveryControllerMessenger;
+    });
+    searchTokens(tokenSearchParams: TokenSearchParams): Promise<TokenSearchResponseItem[]>;
+}
+export {};
+//# sourceMappingURL=token-search-discovery-controller.d.cts.map

package/dist/token-search-discovery-controller.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-search-discovery-controller.d.cts","sourceRoot":"","sources":["../src/token-search-discovery-controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,wBAAwB,EACxB,0BAA0B,EAC1B,6BAA6B,EAC9B,kCAAkC;AACnC,OAAO,EAAE,cAAc,EAAE,kCAAkC;AAE3D,OAAO,KAAK,EAAE,6BAA6B,EAAE,yEAAqE;AAClH,OAAO,KAAK,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,oBAAgB;AAI1E,QAAA,MAAM,cAAc,mCAAmC,CAAC;AAIxD,MAAM,MAAM,mCAAmC,GAAG;IAChD,cAAc,EAAE,uBAAuB,EAAE,CAAC;IAC1C,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC,CAAC;AASF;;;GAGG;AACH,MAAM,MAAM,4CAA4C,GACtD,wBAAwB,CACtB,OAAO,cAAc,EACrB,mCAAmC,CACpC,CAAC;AAEJ;;;GAGG;AACH,MAAM,MAAM,qCAAqC,GAC/C,4CAA4C,CAAC;AAE/C;;GAEG;AACH,KAAK,cAAc,GAAG,KAAK,CAAC;AAE5B;;;GAGG;AACH,MAAM,MAAM,8CAA8C,GACxD,0BAA0B,CACxB,OAAO,cAAc,EACrB,mCAAmC,CACpC,CAAC;AAEJ;;;GAGG;AACH,MAAM,MAAM,oCAAoC,GAC9C,8CAA8C,CAAC;AAEjD;;GAEG;AACH,KAAK,aAAa,GAAG,KAAK,CAAC;AAE3B;;;GAGG;AACH,MAAM,MAAM,uCAAuC,GACjD,6BAA6B,CAC3B,OAAO,cAAc,EACrB,qCAAqC,GAAG,cAAc,EACtD,oCAAoC,GAAG,aAAa,EACpD,cAAc,CAAC,MAAM,CAAC,EACtB,aAAa,CAAC,MAAM,CAAC,CACtB,CAAC;AAEJ;;;;;;;GAOG;AACH,wBAAgB,6CAA6C,IAAI,mCAAmC,CAKnG;AAED;;;GAGG;AACH,qBAAa,8BAA+B,SAAQ,cAAc,CAChE,OAAO,cAAc,EACrB,mCAAmC,EACnC,uCAAuC,CACxC;;gBAGa,EACV,kBAAkB,EAClB,KAAU,EACV,SAAS,GACV,EAAE;QACD,kBAAkB,EAAE,6BAA6B,CAAC;QAClD,KAAK,CAAC,EAAE,OAAO,CAAC,mCAAmC,CAAC,CAAC;QACrD,SAAS,EAAE,uCAAuC,CAAC;KACpD;IAWK,YAAY,CAChB,iBAAiB,EAAE,iBAAiB,GACnC,OAAO,CAAC,uBAAuB,EAAE,CAAC;CAWtC"}

package/dist/token-search-discovery-controller.d.mts

@@ -0,0 +1,66 @@
+import type { ControllerGetStateAction, ControllerStateChangeEvent, RestrictedControllerMessenger } from "@metamask/base-controller";
+import { BaseController } from "@metamask/base-controller";
+import type { AbstractTokenSearchApiService } from "./token-search-api-service/abstract-token-search-api-service.mjs";
+import type { TokenSearchParams, TokenSearchResponseItem } from "./types.mjs";
+declare const controllerName = "TokenSearchDiscoveryController";
+export type TokenSearchDiscoveryControllerState = {
+    recentSearches: TokenSearchResponseItem[];
+    lastSearchTimestamp: number | null;
+};
+/**
+ * The action which can be used to retrieve the state of the
+ * {@link TokenSearchDiscoveryController}.
+ */
+export type TokenSearchDiscoveryControllerGetStateAction = ControllerGetStateAction<typeof controllerName, TokenSearchDiscoveryControllerState>;
+/**
+ * All actions that {@link TokenSearchDiscoveryController} registers, to be
+ * called externally.
+ */
+export type TokenSearchDiscoveryControllerActions = TokenSearchDiscoveryControllerGetStateAction;
+/**
+ * All actions that {@link TokenSearchDiscoveryController} calls internally.
+ */
+type AllowedActions = never;
+/**
+ * The event that {@link TokenSearchDiscoveryController} publishes when updating
+ * state.
+ */
+export type TokenSearchDiscoveryControllerStateChangeEvent = ControllerStateChangeEvent<typeof controllerName, TokenSearchDiscoveryControllerState>;
+/**
+ * All events that {@link TokenSearchDiscoveryController} publishes, to be
+ * subscribed to externally.
+ */
+export type TokenSearchDiscoveryControllerEvents = TokenSearchDiscoveryControllerStateChangeEvent;
+/**
+ * All events that {@link TokenSearchDiscoveryController} subscribes to internally.
+ */
+type AllowedEvents = never;
+/**
+ * The messenger which is restricted to actions and events accessed by
+ * {@link TokenSearchDiscoveryController}.
+ */
+export type TokenSearchDiscoveryControllerMessenger = RestrictedControllerMessenger<typeof controllerName, TokenSearchDiscoveryControllerActions | AllowedActions, TokenSearchDiscoveryControllerEvents | AllowedEvents, AllowedActions['type'], AllowedEvents['type']>;
+/**
+ * Constructs the default {@link TokenSearchDiscoveryController} state. This allows
+ * consumers to provide a partial state object when initializing the controller
+ * and also helps in constructing complete state objects for this controller in
+ * tests.
+ *
+ * @returns The default {@link TokenSearchDiscoveryController} state.
+ */
+export declare function getDefaultTokenSearchDiscoveryControllerState(): TokenSearchDiscoveryControllerState;
+/**
+ * The TokenSearchDiscoveryController manages the retrieval of token search results and token discovery.
+ * It fetches token search results from the portfolio API.
+ */
+export declare class TokenSearchDiscoveryController extends BaseController<typeof controllerName, TokenSearchDiscoveryControllerState, TokenSearchDiscoveryControllerMessenger> {
+    #private;
+    constructor({ tokenSearchService, state, messenger, }: {
+        tokenSearchService: AbstractTokenSearchApiService;
+        state?: Partial<TokenSearchDiscoveryControllerState>;
+        messenger: TokenSearchDiscoveryControllerMessenger;
+    });
+    searchTokens(tokenSearchParams: TokenSearchParams): Promise<TokenSearchResponseItem[]>;
+}
+export {};
+//# sourceMappingURL=token-search-discovery-controller.d.mts.map

package/dist/token-search-discovery-controller.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-search-discovery-controller.d.mts","sourceRoot":"","sources":["../src/token-search-discovery-controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,wBAAwB,EACxB,0BAA0B,EAC1B,6BAA6B,EAC9B,kCAAkC;AACnC,OAAO,EAAE,cAAc,EAAE,kCAAkC;AAE3D,OAAO,KAAK,EAAE,6BAA6B,EAAE,yEAAqE;AAClH,OAAO,KAAK,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,oBAAgB;AAI1E,QAAA,MAAM,cAAc,mCAAmC,CAAC;AAIxD,MAAM,MAAM,mCAAmC,GAAG;IAChD,cAAc,EAAE,uBAAuB,EAAE,CAAC;IAC1C,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC,CAAC;AASF;;;GAGG;AACH,MAAM,MAAM,4CAA4C,GACtD,wBAAwB,CACtB,OAAO,cAAc,EACrB,mCAAmC,CACpC,CAAC;AAEJ;;;GAGG;AACH,MAAM,MAAM,qCAAqC,GAC/C,4CAA4C,CAAC;AAE/C;;GAEG;AACH,KAAK,cAAc,GAAG,KAAK,CAAC;AAE5B;;;GAGG;AACH,MAAM,MAAM,8CAA8C,GACxD,0BAA0B,CACxB,OAAO,cAAc,EACrB,mCAAmC,CACpC,CAAC;AAEJ;;;GAGG;AACH,MAAM,MAAM,oCAAoC,GAC9C,8CAA8C,CAAC;AAEjD;;GAEG;AACH,KAAK,aAAa,GAAG,KAAK,CAAC;AAE3B;;;GAGG;AACH,MAAM,MAAM,uCAAuC,GACjD,6BAA6B,CAC3B,OAAO,cAAc,EACrB,qCAAqC,GAAG,cAAc,EACtD,oCAAoC,GAAG,aAAa,EACpD,cAAc,CAAC,MAAM,CAAC,EACtB,aAAa,CAAC,MAAM,CAAC,CACtB,CAAC;AAEJ;;;;;;;GAOG;AACH,wBAAgB,6CAA6C,IAAI,mCAAmC,CAKnG;AAED;;;GAGG;AACH,qBAAa,8BAA+B,SAAQ,cAAc,CAChE,OAAO,cAAc,EACrB,mCAAmC,EACnC,uCAAuC,CACxC;;gBAGa,EACV,kBAAkB,EAClB,KAAU,EACV,SAAS,GACV,EAAE;QACD,kBAAkB,EAAE,6BAA6B,CAAC;QAClD,KAAK,CAAC,EAAE,OAAO,CAAC,mCAAmC,CAAC,CAAC;QACrD,SAAS,EAAE,uCAAuC,CAAC;KACpD;IAWK,YAAY,CAChB,iBAAiB,EAAE,iBAAiB,GACnC,OAAO,CAAC,uBAAuB,EAAE,CAAC;CAWtC"}

package/dist/token-search-discovery-controller.mjs

@@ -0,0 +1,59 @@
+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 _TokenSearchDiscoveryController_tokenSearchService;
+import { BaseController } from "@metamask/base-controller";
+// === GENERAL ===
+const controllerName = 'TokenSearchDiscoveryController';
+const tokenSearchDiscoveryControllerMetadata = {
+    recentSearches: { persist: true, anonymous: false },
+    lastSearchTimestamp: { persist: true, anonymous: false },
+};
+/**
+ * Constructs the default {@link TokenSearchDiscoveryController} state. This allows
+ * consumers to provide a partial state object when initializing the controller
+ * and also helps in constructing complete state objects for this controller in
+ * tests.
+ *
+ * @returns The default {@link TokenSearchDiscoveryController} state.
+ */
+export function getDefaultTokenSearchDiscoveryControllerState() {
+    return {
+        recentSearches: [],
+        lastSearchTimestamp: null,
+    };
+}
+/**
+ * The TokenSearchDiscoveryController manages the retrieval of token search results and token discovery.
+ * It fetches token search results from the portfolio API.
+ */
+export class TokenSearchDiscoveryController extends BaseController {
+    constructor({ tokenSearchService, state = {}, messenger, }) {
+        super({
+            name: controllerName,
+            metadata: tokenSearchDiscoveryControllerMetadata,
+            messenger,
+            state: { ...getDefaultTokenSearchDiscoveryControllerState(), ...state },
+        });
+        _TokenSearchDiscoveryController_tokenSearchService.set(this, void 0);
+        __classPrivateFieldSet(this, _TokenSearchDiscoveryController_tokenSearchService, tokenSearchService, "f");
+    }
+    async searchTokens(tokenSearchParams) {
+        const results = await __classPrivateFieldGet(this, _TokenSearchDiscoveryController_tokenSearchService, "f").searchTokens(tokenSearchParams);
+        this.update((state) => {
+            state.recentSearches = results;
+            state.lastSearchTimestamp = Date.now();
+        });
+        return results;
+    }
+}
+_TokenSearchDiscoveryController_tokenSearchService = new WeakMap();
+//# sourceMappingURL=token-search-discovery-controller.mjs.map

package/dist/token-search-discovery-controller.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-search-discovery-controller.mjs","sourceRoot":"","sources":["../src/token-search-discovery-controller.ts"],"names":[],"mappings":";;;;;;;;;;;;AAKA,OAAO,EAAE,cAAc,EAAE,kCAAkC;AAK3D,kBAAkB;AAElB,MAAM,cAAc,GAAG,gCAAgC,CAAC;AASxD,MAAM,sCAAsC,GAAG;IAC7C,cAAc,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE;IACnD,mBAAmB,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE;CAChD,CAAC;AA6DX;;;;;;;GAOG;AACH,MAAM,UAAU,6CAA6C;IAC3D,OAAO;QACL,cAAc,EAAE,EAAE;QAClB,mBAAmB,EAAE,IAAI;KAC1B,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,8BAA+B,SAAQ,cAInD;IAGC,YAAY,EACV,kBAAkB,EAClB,KAAK,GAAG,EAAE,EACV,SAAS,GAKV;QACC,KAAK,CAAC;YACJ,IAAI,EAAE,cAAc;YACpB,QAAQ,EAAE,sCAAsC;YAChD,SAAS;YACT,KAAK,EAAE,EAAE,GAAG,6CAA6C,EAAE,EAAE,GAAG,KAAK,EAAE;SACxE,CAAC,CAAC;QAhBI,qEAAmD;QAkB1D,uBAAA,IAAI,sDAAuB,kBAAkB,MAAA,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,YAAY,CAChB,iBAAoC;QAEpC,MAAM,OAAO,GACX,MAAM,uBAAA,IAAI,0DAAoB,CAAC,YAAY,CAAC,iBAAiB,CAAC,CAAC;QAEjE,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;YACpB,KAAK,CAAC,cAAc,GAAG,OAAO,CAAC;YAC/B,KAAK,CAAC,mBAAmB,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzC,CAAC,CAAC,CAAC;QAEH,OAAO,OAAO,CAAC;IACjB,CAAC;CACF","sourcesContent":["import type {\n  ControllerGetStateAction,\n  ControllerStateChangeEvent,\n  RestrictedControllerMessenger,\n} from '@metamask/base-controller';\nimport { BaseController } from '@metamask/base-controller';\n\nimport type { AbstractTokenSearchApiService } from './token-search-api-service/abstract-token-search-api-service';\nimport type { TokenSearchParams, TokenSearchResponseItem } from './types';\n\n// === GENERAL ===\n\nconst controllerName = 'TokenSearchDiscoveryController';\n\n// === STATE ===\n\nexport type TokenSearchDiscoveryControllerState = {\n  recentSearches: TokenSearchResponseItem[];\n  lastSearchTimestamp: number | null;\n};\n\nconst tokenSearchDiscoveryControllerMetadata = {\n  recentSearches: { persist: true, anonymous: false },\n  lastSearchTimestamp: { persist: true, anonymous: false },\n} as const;\n\n// === MESSENGER ===\n\n/**\n * The action which can be used to retrieve the state of the\n * {@link TokenSearchDiscoveryController}.\n */\nexport type TokenSearchDiscoveryControllerGetStateAction =\n  ControllerGetStateAction<\n    typeof controllerName,\n    TokenSearchDiscoveryControllerState\n  >;\n\n/**\n * All actions that {@link TokenSearchDiscoveryController} registers, to be\n * called externally.\n */\nexport type TokenSearchDiscoveryControllerActions =\n  TokenSearchDiscoveryControllerGetStateAction;\n\n/**\n * All actions that {@link TokenSearchDiscoveryController} calls internally.\n */\ntype AllowedActions = never;\n\n/**\n * The event that {@link TokenSearchDiscoveryController} publishes when updating\n * state.\n */\nexport type TokenSearchDiscoveryControllerStateChangeEvent =\n  ControllerStateChangeEvent<\n    typeof controllerName,\n    TokenSearchDiscoveryControllerState\n  >;\n\n/**\n * All events that {@link TokenSearchDiscoveryController} publishes, to be\n * subscribed to externally.\n */\nexport type TokenSearchDiscoveryControllerEvents =\n  TokenSearchDiscoveryControllerStateChangeEvent;\n\n/**\n * All events that {@link TokenSearchDiscoveryController} subscribes to internally.\n */\ntype AllowedEvents = never;\n\n/**\n * The messenger which is restricted to actions and events accessed by\n * {@link TokenSearchDiscoveryController}.\n */\nexport type TokenSearchDiscoveryControllerMessenger =\n  RestrictedControllerMessenger<\n    typeof controllerName,\n    TokenSearchDiscoveryControllerActions | AllowedActions,\n    TokenSearchDiscoveryControllerEvents | AllowedEvents,\n    AllowedActions['type'],\n    AllowedEvents['type']\n  >;\n\n/**\n * Constructs the default {@link TokenSearchDiscoveryController} state. This allows\n * consumers to provide a partial state object when initializing the controller\n * and also helps in constructing complete state objects for this controller in\n * tests.\n *\n * @returns The default {@link TokenSearchDiscoveryController} state.\n */\nexport function getDefaultTokenSearchDiscoveryControllerState(): TokenSearchDiscoveryControllerState {\n  return {\n    recentSearches: [],\n    lastSearchTimestamp: null,\n  };\n}\n\n/**\n * The TokenSearchDiscoveryController manages the retrieval of token search results and token discovery.\n * It fetches token search results from the portfolio API.\n */\nexport class TokenSearchDiscoveryController extends BaseController<\n  typeof controllerName,\n  TokenSearchDiscoveryControllerState,\n  TokenSearchDiscoveryControllerMessenger\n> {\n  readonly #tokenSearchService: AbstractTokenSearchApiService;\n\n  constructor({\n    tokenSearchService,\n    state = {},\n    messenger,\n  }: {\n    tokenSearchService: AbstractTokenSearchApiService;\n    state?: Partial<TokenSearchDiscoveryControllerState>;\n    messenger: TokenSearchDiscoveryControllerMessenger;\n  }) {\n    super({\n      name: controllerName,\n      metadata: tokenSearchDiscoveryControllerMetadata,\n      messenger,\n      state: { ...getDefaultTokenSearchDiscoveryControllerState(), ...state },\n    });\n\n    this.#tokenSearchService = tokenSearchService;\n  }\n\n  async searchTokens(\n    tokenSearchParams: TokenSearchParams,\n  ): Promise<TokenSearchResponseItem[]> {\n    const results =\n      await this.#tokenSearchService.searchTokens(tokenSearchParams);\n\n    this.update((state) => {\n      state.recentSearches = results;\n      state.lastSearchTimestamp = Date.now();\n    });\n\n    return results;\n  }\n}\n"]}

package/dist/types.cjs

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.cjs.map

package/dist/types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.cjs","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"","sourcesContent":["export type TokenSearchParams = {\n  chains?: string[];\n  name?: string;\n  limit?: string;\n};\n\nexport type TokenSearchResponseItem = {\n  tokenAddress: string;\n  chainId: string;\n  name: string;\n  symbol: string;\n  usdPrice: number;\n  usdPricePercentChange: {\n    oneDay: number;\n  };\n};\n"]}

package/dist/types.d.cts

@@ -0,0 +1,16 @@
+export type TokenSearchParams = {
+    chains?: string[];
+    name?: string;
+    limit?: string;
+};
+export type TokenSearchResponseItem = {
+    tokenAddress: string;
+    chainId: string;
+    name: string;
+    symbol: string;
+    usdPrice: number;
+    usdPricePercentChange: {
+        oneDay: number;
+    };
+};
+//# sourceMappingURL=types.d.cts.map

package/dist/types.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.cts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,qBAAqB,EAAE;QACrB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH,CAAC"}

package/dist/types.d.mts

@@ -0,0 +1,16 @@
+export type TokenSearchParams = {
+    chains?: string[];
+    name?: string;
+    limit?: string;
+};
+export type TokenSearchResponseItem = {
+    tokenAddress: string;
+    chainId: string;
+    name: string;
+    symbol: string;
+    usdPrice: number;
+    usdPricePercentChange: {
+        oneDay: number;
+    };
+};
+//# sourceMappingURL=types.d.mts.map

package/dist/types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,qBAAqB,EAAE;QACrB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH,CAAC"}

package/dist/types.mjs

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.mjs.map

package/dist/types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.mjs","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"","sourcesContent":["export type TokenSearchParams = {\n  chains?: string[];\n  name?: string;\n  limit?: string;\n};\n\nexport type TokenSearchResponseItem = {\n  tokenAddress: string;\n  chainId: string;\n  name: string;\n  symbol: string;\n  usdPrice: number;\n  usdPricePercentChange: {\n    oneDay: number;\n  };\n};\n"]}

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@metamask-previews/token-search-discovery-controller",
+  "version": "1.0.0-preview-2ba45577",
+  "description": "Manages token search and discovery through the Portfolio API",
+  "keywords": [
+    "MetaMask",
+    "Ethereum"
+  ],
+  "homepage": "https://github.com/MetaMask/core/tree/main/packages/token-search-discovery-controller#readme",
+  "bugs": {
+    "url": "https://github.com/MetaMask/core/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/MetaMask/core.git"
+  },
+  "license": "MIT",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/index.cjs",
+  "types": "./dist/index.d.cts",
+  "files": [
+    "dist/"
+  ],
+  "scripts": {
+    "build": "ts-bridge --project tsconfig.build.json --verbose --clean --no-references",
+    "build:docs": "typedoc",
+    "changelog:update": "../../scripts/update-changelog.sh @metamask/token-search-discovery-controller",
+    "changelog:validate": "../../scripts/validate-changelog.sh @metamask/token-search-discovery-controller",
+    "publish:preview": "yarn npm publish --tag preview",
+    "test": "NODE_OPTIONS=--experimental-vm-modules jest --reporters=jest-silent-reporter",
+    "test:clean": "NODE_OPTIONS=--experimental-vm-modules jest --clearCache",
+    "test:verbose": "NODE_OPTIONS=--experimental-vm-modules jest --verbose",
+    "test:watch": "NODE_OPTIONS=--experimental-vm-modules jest --watch",
+    "since-latest-release": "../../scripts/since-latest-release.sh"
+  },
+  "dependencies": {
+    "@metamask/base-controller": "^7.1.1",
+    "@metamask/utils": "^11.0.1"
+  },
+  "devDependencies": {
+    "@metamask/auto-changelog": "^3.4.4",
+    "@types/jest": "^27.4.1",
+    "deepmerge": "^4.2.2",
+    "jest": "^27.5.1",
+    "ts-jest": "^27.1.4",
+    "typedoc": "^0.24.8",
+    "typedoc-plugin-missing-exports": "^2.0.0",
+    "typescript": "~5.2.2"
+  },
+  "engines": {
+    "node": "^18.18 || >=20"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}