@metamask/name-controller 4.2.0 → 6.0.0

package/CHANGELOG.md

@@ -1,4 +1,5 @@
 # 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/),
@@ -6,38 +7,74 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [6.0.0]
+
+### Added
+
+- **BREAKING**: Add ESM build ([#3998](https://github.com/MetaMask/core/pull/3998))
+  - It's no longer possible to import files from `./dist` directly.
+- Add support for Linea Sepolia (chain ID `0xe705`) ([#3995](https://github.com/MetaMask/core/pull/3995))
+
+### Changed
+
+- **BREAKING:** Bump `@metamask/base-controller` to `^5.0.0` ([#4039](https://github.com/MetaMask/core/pull/4039))
+  - This version has a number of breaking changes. See the changelog for more.
+- **BREAKING:** Remove support for Optimism Goerli (chain ID `0x1a4`); replace with support for Optimism Sepolia (chain ID `0xaa37dc`) ([#3999](https://github.com/MetaMask/core/pull/3999))
+
+## [5.0.0]
+
+### Changed
+
+- **BREAKING:** Add expire limit for proposed names ([#3748](https://github.com/MetaMask/core/pull/3748))
+  - Expired names now get removed on every call to `updateProposedNames`
+- Bump `@metamask/base-controller` to `^4.1.1` ([#3821](https://github.com/MetaMask/core/pull/3821))
+
 ## [4.2.0]
+
 ### Added
+
 - Add `origin` property to `NameEntry` and `SetNameRequest` ([#3751](https://github.com/MetaMask/core/pull/3751))
 
 ## [4.1.0]
+
 ### Added
+
 - Add fallback variation for petnames ([#3705](https://github.com/MetaMask/core/pull/3705))
 
 ## [4.0.1]
+
 ### Changed
+
 - Bump `@metamask/base-controller` to `^4.0.1` ([#3695](https://github.com/MetaMask/core/pull/3695))
 
 ## [4.0.0]
+
 ### Changed
+
 - **BREAKING:** Bump `@metamask/base-controller` to ^4.0.0 ([#2063](https://github.com/MetaMask/core/pull/2063))
   - This is breaking because the type of the `messenger` has backward-incompatible changes. See the changelog for this package for more.
 - Bump `@metamask/utils` to ^8.2.0 ([#1957](https://github.com/MetaMask/core/pull/1957))
 
 ## [3.0.1]
+
 ### Changed
+
 - Bump dependency on `@metamask/utils` to ^8.1.0 ([#1639](https://github.com/MetaMask/core/pull/1639))
 - Bump dependency on `@metamask/base-controller` to ^3.2.3
 
 ## [3.0.0]
+
 ### Changed
+
 - **BREAKING**: Normalize addresses and chain IDs ([#1732](https://github.com/MetaMask/core/pull/1732))
   - Save addresses and chain IDs as lowercase in state
   - Remove `getChainId` constructor callback
   - Require a `variation` property when calling `setName` or `updateProposedNames` with the `ethereumAddress` type
 
 ## [2.0.0]
+
 ### Changed
+
 - **BREAKING**: Support rate limiting in name providers ([#1715](https://github.com/MetaMask/core/pull/1715))
   - Breaking changes:
     - Change `proposedNames` property in `NameEntry` type from string array to new `ProposedNamesEntry` type
@@ -52,10 +89,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Update TypeScript to v4.8.x ([#1718](https://github.com/MetaMask/core/pull/1718))
 
 ## [1.0.0]
+
 ### Added
+
 - Initial Release ([#1647](https://github.com/MetaMask/core/pull/1647))
 
-[Unreleased]: https://github.com/MetaMask/core/compare/@metamask/name-controller@4.2.0...HEAD
+[Unreleased]: https://github.com/MetaMask/core/compare/@metamask/name-controller@6.0.0...HEAD
+[6.0.0]: https://github.com/MetaMask/core/compare/@metamask/name-controller@5.0.0...@metamask/name-controller@6.0.0
+[5.0.0]: https://github.com/MetaMask/core/compare/@metamask/name-controller@4.2.0...@metamask/name-controller@5.0.0
 [4.2.0]: https://github.com/MetaMask/core/compare/@metamask/name-controller@4.1.0...@metamask/name-controller@4.2.0
 [4.1.0]: https://github.com/MetaMask/core/compare/@metamask/name-controller@4.0.1...@metamask/name-controller@4.1.0
 [4.0.1]: https://github.com/MetaMask/core/compare/@metamask/name-controller@4.0.0...@metamask/name-controller@4.0.1

package/dist/NameController.js

@@ -1,392 +1,15 @@
-"use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-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 _NameController_instances, _NameController_providers, _NameController_updateDelay, _NameController_updateProposedNameState, _NameController_updateSourceState, _NameController_getUpdateProposedNamesResult, _NameController_getProviderResponse, _NameController_normalizeProviderResult, _NameController_normalizeProviderSourceResult, _NameController_normalizeValue, _NameController_normalizeVariation, _NameController_updateEntry, _NameController_getCurrentTimeSeconds, _NameController_validateSetNameRequest, _NameController_validateUpdateProposedNamesRequest, _NameController_validateValue, _NameController_validateType, _NameController_validateName, _NameController_validateSourceIds, _NameController_validateSourceId, _NameController_validateDuplicateSourceIds, _NameController_validateVariation, _NameController_validateOrigin, _NameController_getAllSourceIds, _NameController_getSourceIds, _NameController_removeDormantProposedNames;
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.NameController = exports.NameOrigin = exports.FALLBACK_VARIATION = void 0;
-const base_controller_1 = require("@metamask/base-controller");
-const types_1 = require("./types");
-exports.FALLBACK_VARIATION = '*';
-/**
- * Enumerates the possible origins responsible for setting a petname.
- */
-var NameOrigin;
-(function (NameOrigin) {
-    // Originated from an account identity.
-    NameOrigin["ACCOUNT_IDENTITY"] = "account-identity";
-    // Originated from an address book entry.
-    NameOrigin["ADDRESS_BOOK"] = "address-book";
-    // Originated from the API (NameController.setName). This is the default.
-    NameOrigin["API"] = "api";
-    // Originated from the user taking action in the UI.
-    NameOrigin["UI"] = "ui";
-})(NameOrigin = exports.NameOrigin || (exports.NameOrigin = {}));
-const DEFAULT_UPDATE_DELAY = 60 * 2; // 2 Minutes
-const DEFAULT_VARIATION = '';
-const controllerName = 'NameController';
-const stateMetadata = {
-    names: { persist: true, anonymous: false },
-    nameSources: { persist: true, anonymous: false },
-};
-const getDefaultState = () => ({
-    names: {
-        [types_1.NameType.ETHEREUM_ADDRESS]: {},
-    },
-    nameSources: {},
-});
-/**
- * Controller for storing and deriving names for values such as Ethereum addresses.
- */
-class NameController extends base_controller_1.BaseController {
-    /**
-     * Construct a Name controller.
-     *
-     * @param options - Controller options.
-     * @param options.messenger - Restricted controller messenger for the name controller.
-     * @param options.providers - Array of name provider instances to propose names.
-     * @param options.state - Initial state to set on the controller.
-     * @param options.updateDelay - The delay in seconds before a new request to a source should be made.
-     */
-    constructor({ messenger, providers, state, updateDelay, }) {
-        super({
-            name: controllerName,
-            metadata: stateMetadata,
-            messenger,
-            state: Object.assign(Object.assign({}, getDefaultState()), state),
-        });
-        _NameController_instances.add(this);
-        _NameController_providers.set(this, void 0);
-        _NameController_updateDelay.set(this, void 0);
-        __classPrivateFieldSet(this, _NameController_providers, providers, "f");
-        __classPrivateFieldSet(this, _NameController_updateDelay, updateDelay !== null && updateDelay !== void 0 ? updateDelay : DEFAULT_UPDATE_DELAY, "f");
-    }
-    /**
-     * Set the user specified name for a value.
-     *
-     * @param request - Request object.
-     * @param request.name - Name to set.
-     * @param request.sourceId - Optional ID of the source of the proposed name.
-     * @param request.type - Type of value to set the name for.
-     * @param request.value - Value to set the name for.
-     * @param request.variation - Variation of the raw value to set the name for. The chain ID if the type is Ethereum address.
-     */
-    setName(request) {
-        __classPrivateFieldGet(this, _NameController_instances, "m", _NameController_validateSetNameRequest).call(this, request);
-        const { value, type, name, sourceId: requestSourceId, origin: requestOrigin, variation, } = request;
-        const sourceId = requestSourceId !== null && requestSourceId !== void 0 ? requestSourceId : null;
-        // If the name is being cleared, the fallback origin should be cleared as well.
-        const fallbackOrigin = name === null ? null : NameOrigin.API;
-        const origin = requestOrigin !== null && requestOrigin !== void 0 ? requestOrigin : fallbackOrigin;
-        __classPrivateFieldGet(this, _NameController_instances, "m", _NameController_updateEntry).call(this, value, type, variation, (entry) => {
-            entry.name = name;
-            entry.sourceId = sourceId;
-            entry.origin = origin;
-        });
-    }
-    /**
-     * Generate the proposed names for a value using the name providers and store them in the state.
-     *
-     * @param request - Request object.
-     * @param request.value - Value to update the proposed names for.
-     * @param request.type - Type of value to update the proposed names for.
-     * @param request.sourceIds - Optional array of source IDs to limit which sources are used by the providers. If not provided, all sources in all providers will be used.
-     * @param request.variation - Variation of the raw value to update proposed names for. The chain ID if the type is Ethereum address.
-     * @returns The updated proposed names for the value.
-     */
-    updateProposedNames(request) {
-        return __awaiter(this, void 0, void 0, function* () {
-            __classPrivateFieldGet(this, _NameController_instances, "m", _NameController_validateUpdateProposedNamesRequest).call(this, request);
-            const providerResponses = (yield Promise.all(__classPrivateFieldGet(this, _NameController_providers, "f").map((provider) => __classPrivateFieldGet(this, _NameController_instances, "m", _NameController_getProviderResponse).call(this, request, provider)))).filter((response) => Boolean(response));
-            __classPrivateFieldGet(this, _NameController_instances, "m", _NameController_updateProposedNameState).call(this, request, providerResponses);
-            __classPrivateFieldGet(this, _NameController_instances, "m", _NameController_updateSourceState).call(this, __classPrivateFieldGet(this, _NameController_providers, "f"));
-            return __classPrivateFieldGet(this, _NameController_instances, "m", _NameController_getUpdateProposedNamesResult).call(this, providerResponses);
-        });
-    }
-}
-exports.NameController = NameController;
-_NameController_providers = new WeakMap(), _NameController_updateDelay = new WeakMap(), _NameController_instances = new WeakSet(), _NameController_updateProposedNameState = function _NameController_updateProposedNameState(request, providerResponses) {
-    const { value, type, variation } = request;
-    const currentTime = __classPrivateFieldGet(this, _NameController_instances, "m", _NameController_getCurrentTimeSeconds).call(this);
-    __classPrivateFieldGet(this, _NameController_instances, "m", _NameController_updateEntry).call(this, value, type, variation, (entry) => {
-        var _a;
-        __classPrivateFieldGet(this, _NameController_instances, "m", _NameController_removeDormantProposedNames).call(this, entry.proposedNames, type);
-        for (const providerResponse of providerResponses) {
-            const { results } = providerResponse;
-            for (const sourceId of Object.keys(providerResponse.results)) {
-                const result = results[sourceId];
-                const { proposedNames, updateDelay } = result;
-                const proposedNameEntry = (_a = entry.proposedNames[sourceId]) !== null && _a !== void 0 ? _a : {
-                    proposedNames: [],
-                    lastRequestTime: null,
-                    updateDelay: null,
-                };
-                entry.proposedNames[sourceId] = proposedNameEntry;
-                if (proposedNames) {
-                    proposedNameEntry.proposedNames = proposedNames;
-                }
-                proposedNameEntry.lastRequestTime = currentTime;
-                proposedNameEntry.updateDelay = updateDelay !== null && updateDelay !== void 0 ? updateDelay : null;
-            }
-        }
-    });
-}, _NameController_updateSourceState = function _NameController_updateSourceState(providers) {
-    const newNameSources = Object.assign({}, this.state.nameSources);
-    for (const provider of providers) {
-        const { sourceLabels } = provider.getMetadata();
-        for (const sourceId of Object.keys(sourceLabels)) {
-            newNameSources[sourceId] = {
-                label: sourceLabels[sourceId],
-            };
-        }
-    }
-    this.update((state) => {
-        state.nameSources = newNameSources;
-    });
-}, _NameController_getUpdateProposedNamesResult = function _NameController_getUpdateProposedNamesResult(providerResponses) {
-    return providerResponses.reduce((acc, providerResponse) => {
-        const { results } = providerResponse;
-        for (const sourceId of Object.keys(results)) {
-            const { proposedNames, error } = results[sourceId];
-            acc.results[sourceId] = {
-                proposedNames,
-                error,
-            };
-        }
-        return acc;
-    }, { results: {} });
-}, _NameController_getProviderResponse = function _NameController_getProviderResponse(request, provider) {
-    return __awaiter(this, void 0, void 0, function* () {
-        const { value, type, sourceIds: requestedSourceIds, onlyUpdateAfterDelay, variation, } = request;
-        /* istanbul ignore next */
-        const variationKey = variation !== null && variation !== void 0 ? variation : DEFAULT_VARIATION;
-        const supportedSourceIds = __classPrivateFieldGet(this, _NameController_instances, "m", _NameController_getSourceIds).call(this, provider, type);
-        const currentTime = __classPrivateFieldGet(this, _NameController_instances, "m", _NameController_getCurrentTimeSeconds).call(this);
-        const normalizedValue = __classPrivateFieldGet(this, _NameController_instances, "m", _NameController_normalizeValue).call(this, value, type);
-        const matchingSourceIds = supportedSourceIds.filter((sourceId) => {
-            var _a, _b, _c, _d, _e, _f, _g;
-            if (requestedSourceIds && !requestedSourceIds.includes(sourceId)) {
-                return false;
-            }
-            if (onlyUpdateAfterDelay) {
-                const entry = (_c = (_b = (_a = this.state.names[type]) === null || _a === void 0 ? void 0 : _a[normalizedValue]) === null || _b === void 0 ? void 0 : _b[variationKey]) !== null && _c !== void 0 ? _c : {};
-                const proposedNamesEntry = (_e = (_d = entry.proposedNames) === null || _d === void 0 ? void 0 : _d[sourceId]) !== null && _e !== void 0 ? _e : {};
-                const lastRequestTime = (_f = proposedNamesEntry.lastRequestTime) !== null && _f !== void 0 ? _f : 0;
-                const updateDelay = (_g = proposedNamesEntry.updateDelay) !== null && _g !== void 0 ? _g : __classPrivateFieldGet(this, _NameController_updateDelay, "f");
-                if (currentTime - lastRequestTime < updateDelay) {
-                    return false;
-                }
-            }
-            return true;
-        });
-        if (!matchingSourceIds.length) {
-            return undefined;
-        }
-        const providerRequest = {
-            value: __classPrivateFieldGet(this, _NameController_instances, "m", _NameController_normalizeValue).call(this, value, type),
-            type,
-            sourceIds: requestedSourceIds ? matchingSourceIds : undefined,
-            variation: __classPrivateFieldGet(this, _NameController_instances, "m", _NameController_normalizeVariation).call(this, variationKey, type),
-        };
-        let responseError;
-        let response;
-        try {
-            response = yield provider.getProposedNames(providerRequest);
-            responseError = response.error;
-        }
-        catch (error) {
-            responseError = error;
-        }
-        return __classPrivateFieldGet(this, _NameController_instances, "m", _NameController_normalizeProviderResult).call(this, response, responseError, matchingSourceIds);
-    });
-}, _NameController_normalizeProviderResult = function _NameController_normalizeProviderResult(result, responseError, matchingSourceIds) {
-    const error = responseError !== null && responseError !== void 0 ? responseError : undefined;
-    const results = matchingSourceIds.reduce((acc, sourceId) => {
-        var _a;
-        const sourceResult = (_a = result === null || result === void 0 ? void 0 : result.results) === null || _a === void 0 ? void 0 : _a[sourceId];
-        const normalizedSourceResult = __classPrivateFieldGet(this, _NameController_instances, "m", _NameController_normalizeProviderSourceResult).call(this, sourceResult, responseError);
-        return Object.assign(Object.assign({}, acc), { [sourceId]: normalizedSourceResult });
-    }, {});
-    return { results, error };
-}, _NameController_normalizeProviderSourceResult = function _NameController_normalizeProviderSourceResult(result, responseError) {
-    var _a, _b, _c, _d;
-    const error = (_b = (_a = result === null || result === void 0 ? void 0 : result.error) !== null && _a !== void 0 ? _a : responseError) !== null && _b !== void 0 ? _b : undefined;
-    const updateDelay = (_c = result === null || result === void 0 ? void 0 : result.updateDelay) !== null && _c !== void 0 ? _c : undefined;
-    let proposedNames = error ? undefined : (_d = result === null || result === void 0 ? void 0 : result.proposedNames) !== null && _d !== void 0 ? _d : undefined;
-    if (proposedNames) {
-        proposedNames = proposedNames.filter((proposedName) => proposedName === null || proposedName === void 0 ? void 0 : proposedName.length);
-    }
-    return {
-        proposedNames,
-        error,
-        updateDelay,
-    };
-}, _NameController_normalizeValue = function _NameController_normalizeValue(value, type) {
-    /* istanbul ignore next */
-    switch (type) {
-        case types_1.NameType.ETHEREUM_ADDRESS:
-            return value.toLowerCase();
-        default:
-            return value;
-    }
-}, _NameController_normalizeVariation = function _NameController_normalizeVariation(variation, type) {
-    /* istanbul ignore next */
-    switch (type) {
-        case types_1.NameType.ETHEREUM_ADDRESS:
-            return variation.toLowerCase();
-        default:
-            return variation;
-    }
-}, _NameController_updateEntry = function _NameController_updateEntry(value, type, variation, callback) {
-    /* istanbul ignore next */
-    const variationKey = variation !== null && variation !== void 0 ? variation : DEFAULT_VARIATION;
-    const normalizedValue = __classPrivateFieldGet(this, _NameController_instances, "m", _NameController_normalizeValue).call(this, value, type);
-    const normalizedVariation = __classPrivateFieldGet(this, _NameController_instances, "m", _NameController_normalizeVariation).call(this, variationKey, type);
-    this.update((state) => {
-        var _a;
-        const typeEntries = state.names[type] || {};
-        state.names[type] = typeEntries;
-        const variationEntries = typeEntries[normalizedValue] || {};
-        typeEntries[normalizedValue] = variationEntries;
-        const entry = (_a = variationEntries[normalizedVariation]) !== null && _a !== void 0 ? _a : {
-            proposedNames: {},
-            name: null,
-            sourceId: null,
-            origin: null,
-        };
-        variationEntries[normalizedVariation] = entry;
-        callback(entry);
-    });
-}, _NameController_getCurrentTimeSeconds = function _NameController_getCurrentTimeSeconds() {
-    return Math.round(Date.now() / 1000);
-}, _NameController_validateSetNameRequest = function _NameController_validateSetNameRequest(request) {
-    const { name, value, type, sourceId, variation, origin } = request;
-    const errorMessages = [];
-    __classPrivateFieldGet(this, _NameController_instances, "m", _NameController_validateValue).call(this, value, errorMessages);
-    __classPrivateFieldGet(this, _NameController_instances, "m", _NameController_validateType).call(this, type, errorMessages);
-    __classPrivateFieldGet(this, _NameController_instances, "m", _NameController_validateName).call(this, name, errorMessages);
-    __classPrivateFieldGet(this, _NameController_instances, "m", _NameController_validateSourceId).call(this, sourceId, type, name, errorMessages);
-    __classPrivateFieldGet(this, _NameController_instances, "m", _NameController_validateVariation).call(this, variation, type, errorMessages);
-    __classPrivateFieldGet(this, _NameController_instances, "m", _NameController_validateOrigin).call(this, origin, name, errorMessages);
-    if (errorMessages.length) {
-        throw new Error(errorMessages.join(' '));
-    }
-}, _NameController_validateUpdateProposedNamesRequest = function _NameController_validateUpdateProposedNamesRequest(request) {
-    const { value, type, sourceIds, variation } = request;
-    const errorMessages = [];
-    __classPrivateFieldGet(this, _NameController_instances, "m", _NameController_validateValue).call(this, value, errorMessages);
-    __classPrivateFieldGet(this, _NameController_instances, "m", _NameController_validateType).call(this, type, errorMessages);
-    __classPrivateFieldGet(this, _NameController_instances, "m", _NameController_validateSourceIds).call(this, sourceIds, type, errorMessages);
-    __classPrivateFieldGet(this, _NameController_instances, "m", _NameController_validateDuplicateSourceIds).call(this, type, errorMessages);
-    __classPrivateFieldGet(this, _NameController_instances, "m", _NameController_validateVariation).call(this, variation, type, errorMessages);
-    if (errorMessages.length) {
-        throw new Error(errorMessages.join(' '));
-    }
-}, _NameController_validateValue = function _NameController_validateValue(value, errorMessages) {
-    if (!(value === null || value === void 0 ? void 0 : value.length) || typeof value !== 'string') {
-        errorMessages.push('Must specify a non-empty string for value.');
-    }
-}, _NameController_validateType = function _NameController_validateType(type, errorMessages) {
-    if (!Object.values(types_1.NameType).includes(type)) {
-        errorMessages.push(`Must specify one of the following types: ${Object.values(types_1.NameType).join(', ')}`);
-    }
-}, _NameController_validateName = function _NameController_validateName(name, errorMessages) {
-    if (name === null) {
-        return;
-    }
-    if (!(name === null || name === void 0 ? void 0 : name.length) || typeof name !== 'string') {
-        errorMessages.push('Must specify a non-empty string or null for name.');
-    }
-}, _NameController_validateSourceIds = function _NameController_validateSourceIds(sourceIds, type, errorMessages) {
-    if (!sourceIds) {
-        return;
-    }
-    const allSourceIds = __classPrivateFieldGet(this, _NameController_instances, "m", _NameController_getAllSourceIds).call(this, type);
-    const missingSourceIds = [];
-    for (const sourceId of sourceIds) {
-        if (!allSourceIds.includes(sourceId)) {
-            missingSourceIds.push(sourceId);
-            continue;
-        }
-    }
-    if (missingSourceIds.length) {
-        errorMessages.push(`Unknown source IDs for type '${type}': ${missingSourceIds.join(', ')}`);
-    }
-}, _NameController_validateSourceId = function _NameController_validateSourceId(sourceId, type, name, errorMessages) {
-    if (sourceId === null || sourceId === undefined) {
-        return;
-    }
-    if (name === null) {
-        errorMessages.push(`Cannot specify a source ID when clearing the saved name: ${sourceId}`);
-        return;
-    }
-    const allSourceIds = __classPrivateFieldGet(this, _NameController_instances, "m", _NameController_getAllSourceIds).call(this, type);
-    if (!sourceId.length || typeof sourceId !== 'string') {
-        errorMessages.push('Must specify a non-empty string for sourceId.');
-        return;
-    }
-    if (!allSourceIds.includes(sourceId)) {
-        errorMessages.push(`Unknown source ID for type '${type}': ${sourceId}`);
-    }
-}, _NameController_validateDuplicateSourceIds = function _NameController_validateDuplicateSourceIds(type, errorMessages) {
-    const allSourceIds = __classPrivateFieldGet(this, _NameController_instances, "m", _NameController_getAllSourceIds).call(this, type);
-    const duplicateSourceIds = allSourceIds.filter((sourceId, index) => allSourceIds.indexOf(sourceId) !== index);
-    if (duplicateSourceIds.length) {
-        errorMessages.push(`Duplicate source IDs found for type '${type}': ${duplicateSourceIds.join(', ')}`);
-    }
-}, _NameController_validateVariation = function _NameController_validateVariation(variation, type, errorMessages) {
-    if (type !== types_1.NameType.ETHEREUM_ADDRESS) {
-        return;
-    }
-    if (!(variation === null || variation === void 0 ? void 0 : variation.length) ||
-        typeof variation !== 'string' ||
-        (!variation.match(/^0x[0-9A-Fa-f]+$/u) &&
-            variation !== exports.FALLBACK_VARIATION)) {
-        errorMessages.push(`Must specify a chain ID in hexidecimal format or the fallback, "${exports.FALLBACK_VARIATION}", for variation when using '${type}' type.`);
-    }
-}, _NameController_validateOrigin = function _NameController_validateOrigin(origin, name, errorMessages) {
-    if (!origin) {
-        return;
-    }
-    if (name === null) {
-        errorMessages.push(`Cannot specify an origin when clearing the saved name: ${origin}`);
-        return;
-    }
-    if (!Object.values(NameOrigin).includes(origin)) {
-        errorMessages.push(`Must specify one of the following origins: ${Object.values(NameOrigin).join(', ')}`);
-    }
-}, _NameController_getAllSourceIds = function _NameController_getAllSourceIds(type) {
-    return (__classPrivateFieldGet(this, _NameController_providers, "f")
-        /* istanbul ignore next */
-        .map((provider) => __classPrivateFieldGet(this, _NameController_instances, "m", _NameController_getSourceIds).call(this, provider, type))
-        .flat());
-}, _NameController_getSourceIds = function _NameController_getSourceIds(provider, type) {
-    return provider.getMetadata().sourceIds[type];
-}, _NameController_removeDormantProposedNames = function _NameController_removeDormantProposedNames(proposedNames, type) {
-    if (Object.keys(proposedNames).length === 0) {
-        return;
-    }
-    const typeSourceIds = __classPrivateFieldGet(this, _NameController_instances, "m", _NameController_getAllSourceIds).call(this, type);
-    const dormantSourceIds = Object.keys(proposedNames).filter((sourceId) => !typeSourceIds.includes(sourceId));
-    for (const dormantSourceId of dormantSourceIds) {
-        delete proposedNames[dormantSourceId];
-    }
-};
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+
+var _chunkB2WJNTJSjs = require('./chunk-B2WJNTJS.js');
+require('./chunk-PL7IXD33.js');
+require('./chunk-Z4BLTVTB.js');
+
+
+
+
+
+exports.FALLBACK_VARIATION = _chunkB2WJNTJSjs.FALLBACK_VARIATION; exports.NameController = _chunkB2WJNTJSjs.NameController; exports.NameOrigin = _chunkB2WJNTJSjs.NameOrigin; exports.PROPOSED_NAME_EXPIRE_DURATION = _chunkB2WJNTJSjs.PROPOSED_NAME_EXPIRE_DURATION;
 //# sourceMappingURL=NameController.js.map

package/dist/NameController.js.map

@@ -1 +1 @@
-{"version":3,"file":"NameController.js","sourceRoot":"","sources":["../src/NameController.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  ControllerGetStateAction,\n  ControllerStateChangeEvent,\n  RestrictedControllerMessenger,\n} from '@metamask/base-controller';\nimport { BaseController } from '@metamask/base-controller';\n\nimport type {\n  NameProvider,\n  NameProviderRequest,\n  NameProviderResult,\n  NameProviderSourceResult,\n} from './types';\nimport { NameType } from './types';\n\nexport const FALLBACK_VARIATION = '*';\n\n/**\n * Enumerates the possible origins responsible for setting a petname.\n */\nexport enum NameOrigin {\n  // Originated from an account identity.\n  ACCOUNT_IDENTITY = 'account-identity',\n  // Originated from an address book entry.\n  ADDRESS_BOOK = 'address-book',\n  // Originated from the API (NameController.setName). This is the default.\n  API = 'api',\n  // Originated from the user taking action in the UI.\n  UI = 'ui',\n}\n\nconst DEFAULT_UPDATE_DELAY = 60 * 2; // 2 Minutes\nconst DEFAULT_VARIATION = '';\n\nconst controllerName = 'NameController';\n\nconst stateMetadata = {\n  names: { persist: true, anonymous: false },\n  nameSources: { persist: true, anonymous: false },\n};\n\nconst getDefaultState = () => ({\n  names: {\n    [NameType.ETHEREUM_ADDRESS]: {},\n  },\n  nameSources: {},\n});\n\nexport type ProposedNamesEntry = {\n  proposedNames: string[];\n  lastRequestTime: number | null;\n  updateDelay: number | null;\n};\n\nexport type NameEntry = {\n  name: string | null;\n  sourceId: string | null;\n  origin: NameOrigin | null;\n  proposedNames: Record<string, ProposedNamesEntry>;\n};\n\nexport type SourceEntry = {\n  label: string;\n};\n\nexport type NameControllerState = {\n  // Type > Value > Variation > Entry\n  names: Record<NameType, Record<string, Record<string, NameEntry>>>;\n  nameSources: Record<string, SourceEntry>;\n};\n\nexport type GetNameState = ControllerGetStateAction<\n  typeof controllerName,\n  NameControllerState\n>;\n\nexport type NameStateChange = ControllerStateChangeEvent<\n  typeof controllerName,\n  NameControllerState\n>;\n\nexport type NameControllerActions = GetNameState;\n\nexport type NameControllerEvents = NameStateChange;\n\nexport type NameControllerMessenger = RestrictedControllerMessenger<\n  typeof controllerName,\n  NameControllerActions,\n  NameControllerEvents,\n  never,\n  never\n>;\n\nexport type NameControllerOptions = {\n  messenger: NameControllerMessenger;\n  providers: NameProvider[];\n  state?: Partial<NameControllerState>;\n  updateDelay?: number;\n};\n\nexport type UpdateProposedNamesRequest = {\n  value: string;\n  type: NameType;\n  sourceIds?: string[];\n  onlyUpdateAfterDelay?: boolean;\n  variation?: string;\n};\n\nexport type UpdateProposedNamesResult = {\n  results: Record<string, { proposedNames?: string[]; error?: unknown }>;\n};\n\nexport type SetNameRequest = {\n  value: string;\n  type: NameType;\n  name: string | null;\n  sourceId?: string;\n  variation?: string;\n  origin?: NameOrigin;\n};\n\n/**\n * Controller for storing and deriving names for values such as Ethereum addresses.\n */\nexport class NameController extends BaseController<\n  typeof controllerName,\n  NameControllerState,\n  NameControllerMessenger\n> {\n  #providers: NameProvider[];\n\n  #updateDelay: number;\n\n  /**\n   * Construct a Name controller.\n   *\n   * @param options - Controller options.\n   * @param options.messenger - Restricted controller messenger for the name controller.\n   * @param options.providers - Array of name provider instances to propose names.\n   * @param options.state - Initial state to set on the controller.\n   * @param options.updateDelay - The delay in seconds before a new request to a source should be made.\n   */\n  constructor({\n    messenger,\n    providers,\n    state,\n    updateDelay,\n  }: NameControllerOptions) {\n    super({\n      name: controllerName,\n      metadata: stateMetadata,\n      messenger,\n      state: { ...getDefaultState(), ...state },\n    });\n\n    this.#providers = providers;\n    this.#updateDelay = updateDelay ?? DEFAULT_UPDATE_DELAY;\n  }\n\n  /**\n   * Set the user specified name for a value.\n   *\n   * @param request - Request object.\n   * @param request.name - Name to set.\n   * @param request.sourceId - Optional ID of the source of the proposed name.\n   * @param request.type - Type of value to set the name for.\n   * @param request.value - Value to set the name for.\n   * @param request.variation - Variation of the raw value to set the name for. The chain ID if the type is Ethereum address.\n   */\n  setName(request: SetNameRequest) {\n    this.#validateSetNameRequest(request);\n\n    const {\n      value,\n      type,\n      name,\n      sourceId: requestSourceId,\n      origin: requestOrigin,\n      variation,\n    } = request;\n    const sourceId = requestSourceId ?? null;\n    // If the name is being cleared, the fallback origin should be cleared as well.\n    const fallbackOrigin = name === null ? null : NameOrigin.API;\n    const origin = requestOrigin ?? fallbackOrigin;\n\n    this.#updateEntry(value, type, variation, (entry: NameEntry) => {\n      entry.name = name;\n      entry.sourceId = sourceId;\n      entry.origin = origin;\n    });\n  }\n\n  /**\n   * Generate the proposed names for a value using the name providers and store them in the state.\n   *\n   * @param request - Request object.\n   * @param request.value - Value to update the proposed names for.\n   * @param request.type - Type of value to update the proposed names for.\n   * @param request.sourceIds - Optional array of source IDs to limit which sources are used by the providers. If not provided, all sources in all providers will be used.\n   * @param request.variation - Variation of the raw value to update proposed names for. The chain ID if the type is Ethereum address.\n   * @returns The updated proposed names for the value.\n   */\n  async updateProposedNames(\n    request: UpdateProposedNamesRequest,\n  ): Promise<UpdateProposedNamesResult> {\n    this.#validateUpdateProposedNamesRequest(request);\n\n    const providerResponses = (\n      await Promise.all(\n        this.#providers.map((provider) =>\n          this.#getProviderResponse(request, provider),\n        ),\n      )\n    ).filter((response) => Boolean(response)) as NameProviderResult[];\n\n    this.#updateProposedNameState(request, providerResponses);\n    this.#updateSourceState(this.#providers);\n\n    return this.#getUpdateProposedNamesResult(providerResponses);\n  }\n\n  #updateProposedNameState(\n    request: UpdateProposedNamesRequest,\n    providerResponses: NameProviderResult[],\n  ) {\n    const { value, type, variation } = request;\n    const currentTime = this.#getCurrentTimeSeconds();\n\n    this.#updateEntry(value, type, variation, (entry: NameEntry) => {\n      this.#removeDormantProposedNames(entry.proposedNames, type);\n\n      for (const providerResponse of providerResponses) {\n        const { results } = providerResponse;\n\n        for (const sourceId of Object.keys(providerResponse.results)) {\n          const result = results[sourceId];\n          const { proposedNames, updateDelay } = result;\n\n          const proposedNameEntry = entry.proposedNames[sourceId] ?? {\n            proposedNames: [],\n            lastRequestTime: null,\n            updateDelay: null,\n          };\n\n          entry.proposedNames[sourceId] = proposedNameEntry;\n\n          if (proposedNames) {\n            proposedNameEntry.proposedNames = proposedNames;\n          }\n\n          proposedNameEntry.lastRequestTime = currentTime;\n          proposedNameEntry.updateDelay = updateDelay ?? null;\n        }\n      }\n    });\n  }\n\n  #updateSourceState(providers: NameProvider[]) {\n    const newNameSources = { ...this.state.nameSources };\n\n    for (const provider of providers) {\n      const { sourceLabels } = provider.getMetadata();\n\n      for (const sourceId of Object.keys(sourceLabels)) {\n        newNameSources[sourceId] = {\n          label: sourceLabels[sourceId],\n        };\n      }\n    }\n\n    this.update((state) => {\n      state.nameSources = newNameSources;\n    });\n  }\n\n  #getUpdateProposedNamesResult(\n    providerResponses: NameProviderResult[],\n  ): UpdateProposedNamesResult {\n    return providerResponses.reduce(\n      (acc: UpdateProposedNamesResult, providerResponse) => {\n        const { results } = providerResponse;\n\n        for (const sourceId of Object.keys(results)) {\n          const { proposedNames, error } = results[sourceId];\n\n          acc.results[sourceId] = {\n            proposedNames,\n            error,\n          };\n        }\n\n        return acc;\n      },\n      { results: {} },\n    );\n  }\n\n  async #getProviderResponse(\n    request: UpdateProposedNamesRequest,\n    provider: NameProvider,\n  ): Promise<NameProviderResult | undefined> {\n    const {\n      value,\n      type,\n      sourceIds: requestedSourceIds,\n      onlyUpdateAfterDelay,\n      variation,\n    } = request;\n\n    /* istanbul ignore next */\n    const variationKey = variation ?? DEFAULT_VARIATION;\n    const supportedSourceIds = this.#getSourceIds(provider, type);\n    const currentTime = this.#getCurrentTimeSeconds();\n    const normalizedValue = this.#normalizeValue(value, type);\n\n    const matchingSourceIds = supportedSourceIds.filter((sourceId) => {\n      if (requestedSourceIds && !requestedSourceIds.includes(sourceId)) {\n        return false;\n      }\n\n      if (onlyUpdateAfterDelay) {\n        const entry =\n          this.state.names[type]?.[normalizedValue]?.[variationKey] ?? {};\n        const proposedNamesEntry = entry.proposedNames?.[sourceId] ?? {};\n        const lastRequestTime = proposedNamesEntry.lastRequestTime ?? 0;\n        const updateDelay = proposedNamesEntry.updateDelay ?? this.#updateDelay;\n\n        if (currentTime - lastRequestTime < updateDelay) {\n          return false;\n        }\n      }\n\n      return true;\n    });\n\n    if (!matchingSourceIds.length) {\n      return undefined;\n    }\n\n    const providerRequest: NameProviderRequest = {\n      value: this.#normalizeValue(value, type),\n      type,\n      sourceIds: requestedSourceIds ? matchingSourceIds : undefined,\n      variation: this.#normalizeVariation(variationKey, type),\n    };\n\n    let responseError: unknown | undefined;\n    let response: NameProviderResult | undefined;\n\n    try {\n      response = await provider.getProposedNames(providerRequest);\n      responseError = response.error;\n    } catch (error) {\n      responseError = error;\n    }\n\n    return this.#normalizeProviderResult(\n      response,\n      responseError,\n      matchingSourceIds,\n    );\n  }\n\n  #normalizeProviderResult(\n    result: NameProviderResult | undefined,\n    responseError: unknown,\n    matchingSourceIds: string[],\n  ): NameProviderResult {\n    const error = responseError ?? undefined;\n\n    const results = matchingSourceIds.reduce((acc, sourceId) => {\n      const sourceResult = result?.results?.[sourceId];\n\n      const normalizedSourceResult = this.#normalizeProviderSourceResult(\n        sourceResult,\n        responseError,\n      );\n\n      return {\n        ...acc,\n        [sourceId]: normalizedSourceResult,\n      };\n    }, {});\n\n    return { results, error };\n  }\n\n  #normalizeProviderSourceResult(\n    result: NameProviderSourceResult | undefined,\n    responseError: unknown,\n  ): NameProviderSourceResult | undefined {\n    const error = result?.error ?? responseError ?? undefined;\n    const updateDelay = result?.updateDelay ?? undefined;\n    let proposedNames = error ? undefined : result?.proposedNames ?? undefined;\n\n    if (proposedNames) {\n      proposedNames = proposedNames.filter(\n        (proposedName) => proposedName?.length,\n      );\n    }\n\n    return {\n      proposedNames,\n      error,\n      updateDelay,\n    };\n  }\n\n  #normalizeValue(value: string, type: NameType): string {\n    /* istanbul ignore next */\n    switch (type) {\n      case NameType.ETHEREUM_ADDRESS:\n        return value.toLowerCase();\n\n      default:\n        return value;\n    }\n  }\n\n  #normalizeVariation(variation: string, type: NameType): string {\n    /* istanbul ignore next */\n    switch (type) {\n      case NameType.ETHEREUM_ADDRESS:\n        return variation.toLowerCase();\n\n      default:\n        return variation;\n    }\n  }\n\n  #updateEntry(\n    value: string,\n    type: NameType,\n    variation: string | undefined,\n    callback: (entry: NameEntry) => void,\n  ) {\n    /* istanbul ignore next */\n    const variationKey = variation ?? DEFAULT_VARIATION;\n    const normalizedValue = this.#normalizeValue(value, type);\n    const normalizedVariation = this.#normalizeVariation(variationKey, type);\n\n    this.update((state) => {\n      const typeEntries = state.names[type] || {};\n      state.names[type] = typeEntries;\n\n      const variationEntries = typeEntries[normalizedValue] || {};\n      typeEntries[normalizedValue] = variationEntries;\n\n      const entry = variationEntries[normalizedVariation] ?? {\n        proposedNames: {},\n        name: null,\n        sourceId: null,\n        origin: null,\n      };\n      variationEntries[normalizedVariation] = entry;\n\n      callback(entry);\n    });\n  }\n\n  #getCurrentTimeSeconds(): number {\n    return Math.round(Date.now() / 1000);\n  }\n\n  #validateSetNameRequest(request: SetNameRequest) {\n    const { name, value, type, sourceId, variation, origin } = request;\n    const errorMessages: string[] = [];\n\n    this.#validateValue(value, errorMessages);\n    this.#validateType(type, errorMessages);\n    this.#validateName(name, errorMessages);\n    this.#validateSourceId(sourceId, type, name, errorMessages);\n    this.#validateVariation(variation, type, errorMessages);\n    this.#validateOrigin(origin, name, errorMessages);\n\n    if (errorMessages.length) {\n      throw new Error(errorMessages.join(' '));\n    }\n  }\n\n  #validateUpdateProposedNamesRequest(request: UpdateProposedNamesRequest) {\n    const { value, type, sourceIds, variation } = request;\n    const errorMessages: string[] = [];\n\n    this.#validateValue(value, errorMessages);\n    this.#validateType(type, errorMessages);\n    this.#validateSourceIds(sourceIds, type, errorMessages);\n    this.#validateDuplicateSourceIds(type, errorMessages);\n    this.#validateVariation(variation, type, errorMessages);\n\n    if (errorMessages.length) {\n      throw new Error(errorMessages.join(' '));\n    }\n  }\n\n  #validateValue(value: string, errorMessages: string[]) {\n    if (!value?.length || typeof value !== 'string') {\n      errorMessages.push('Must specify a non-empty string for value.');\n    }\n  }\n\n  #validateType(type: NameType, errorMessages: string[]) {\n    if (!Object.values(NameType).includes(type)) {\n      errorMessages.push(\n        `Must specify one of the following types: ${Object.values(\n          NameType,\n        ).join(', ')}`,\n      );\n    }\n  }\n\n  #validateName(name: string | null, errorMessages: string[]) {\n    if (name === null) {\n      return;\n    }\n\n    if (!name?.length || typeof name !== 'string') {\n      errorMessages.push('Must specify a non-empty string or null for name.');\n    }\n  }\n\n  #validateSourceIds(\n    sourceIds: string[] | undefined,\n    type: NameType,\n    errorMessages: string[],\n  ) {\n    if (!sourceIds) {\n      return;\n    }\n\n    const allSourceIds = this.#getAllSourceIds(type);\n    const missingSourceIds = [];\n\n    for (const sourceId of sourceIds) {\n      if (!allSourceIds.includes(sourceId)) {\n        missingSourceIds.push(sourceId);\n        continue;\n      }\n    }\n\n    if (missingSourceIds.length) {\n      errorMessages.push(\n        `Unknown source IDs for type '${type}': ${missingSourceIds.join(', ')}`,\n      );\n    }\n  }\n\n  #validateSourceId(\n    sourceId: string | undefined,\n    type: NameType,\n    name: string | null,\n    errorMessages: string[],\n  ) {\n    if (sourceId === null || sourceId === undefined) {\n      return;\n    }\n\n    if (name === null) {\n      errorMessages.push(\n        `Cannot specify a source ID when clearing the saved name: ${sourceId}`,\n      );\n      return;\n    }\n\n    const allSourceIds = this.#getAllSourceIds(type);\n\n    if (!sourceId.length || typeof sourceId !== 'string') {\n      errorMessages.push('Must specify a non-empty string for sourceId.');\n      return;\n    }\n\n    if (!allSourceIds.includes(sourceId)) {\n      errorMessages.push(`Unknown source ID for type '${type}': ${sourceId}`);\n    }\n  }\n\n  #validateDuplicateSourceIds(type: NameType, errorMessages: string[]) {\n    const allSourceIds = this.#getAllSourceIds(type);\n\n    const duplicateSourceIds = allSourceIds.filter(\n      (sourceId, index) => allSourceIds.indexOf(sourceId) !== index,\n    );\n\n    if (duplicateSourceIds.length) {\n      errorMessages.push(\n        `Duplicate source IDs found for type '${type}': ${duplicateSourceIds.join(\n          ', ',\n        )}`,\n      );\n    }\n  }\n\n  #validateVariation(\n    variation: string | undefined,\n    type: string,\n    errorMessages: string[],\n  ) {\n    if (type !== NameType.ETHEREUM_ADDRESS) {\n      return;\n    }\n\n    if (\n      !variation?.length ||\n      typeof variation !== 'string' ||\n      (!variation.match(/^0x[0-9A-Fa-f]+$/u) &&\n        variation !== FALLBACK_VARIATION)\n    ) {\n      errorMessages.push(\n        `Must specify a chain ID in hexidecimal format or the fallback, \"${FALLBACK_VARIATION}\", for variation when using '${type}' type.`,\n      );\n    }\n  }\n\n  #validateOrigin(\n    origin: NameOrigin | null | undefined,\n    name: string | null,\n    errorMessages: string[],\n  ) {\n    if (!origin) {\n      return;\n    }\n\n    if (name === null) {\n      errorMessages.push(\n        `Cannot specify an origin when clearing the saved name: ${origin}`,\n      );\n      return;\n    }\n\n    if (!Object.values(NameOrigin).includes(origin)) {\n      errorMessages.push(\n        `Must specify one of the following origins: ${Object.values(\n          NameOrigin,\n        ).join(', ')}`,\n      );\n    }\n  }\n\n  #getAllSourceIds(type: NameType): string[] {\n    return (\n      this.#providers\n        /* istanbul ignore next */\n        .map((provider) => this.#getSourceIds(provider, type))\n        .flat()\n    );\n  }\n\n  #getSourceIds(provider: NameProvider, type: NameType): string[] {\n    return provider.getMetadata().sourceIds[type];\n  }\n\n  #removeDormantProposedNames(\n    proposedNames: Record<string, ProposedNamesEntry>,\n    type: NameType,\n  ) {\n    if (Object.keys(proposedNames).length === 0) {\n      return;\n    }\n\n    const typeSourceIds = this.#getAllSourceIds(type);\n\n    const dormantSourceIds = Object.keys(proposedNames).filter(\n      (sourceId) => !typeSourceIds.includes(sourceId),\n    );\n\n    for (const dormantSourceId of dormantSourceIds) {\n      delete proposedNames[dormantSourceId];\n    }\n  }\n}\n"]}
+{"version":3,"sources":[],"names":[],"mappings":""}

package/dist/NameController.mjs

@@ -0,0 +1,15 @@
+import {
+  FALLBACK_VARIATION,
+  NameController,
+  NameOrigin,
+  PROPOSED_NAME_EXPIRE_DURATION
+} from "./chunk-GJYKWMRC.mjs";
+import "./chunk-6W3DEAGA.mjs";
+import "./chunk-XUI43LEZ.mjs";
+export {
+  FALLBACK_VARIATION,
+  NameController,
+  NameOrigin,
+  PROPOSED_NAME_EXPIRE_DURATION
+};
+//# sourceMappingURL=NameController.mjs.map

package/dist/NameController.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/chunk-6W3DEAGA.mjs

@@ -0,0 +1,10 @@
+// src/types.ts
+var NameType = /* @__PURE__ */ ((NameType2) => {
+  NameType2["ETHEREUM_ADDRESS"] = "ethereumAddress";
+  return NameType2;
+})(NameType || {});
+
+export {
+  NameType
+};
+//# sourceMappingURL=chunk-6W3DEAGA.mjs.map

package/dist/chunk-6W3DEAGA.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts"],"sourcesContent":["/** The name types supported by the NameController. */\nexport enum NameType {\n  /** The address of an Ethereum account. */\n  ETHEREUM_ADDRESS = 'ethereumAddress',\n}\n\n/** The metadata for a name provider. */\nexport type NameProviderMetadata = {\n  /**\n   * IDs for each alternate source of proposed names.\n   * Keyed by the name type.\n   */\n  sourceIds: Record<NameType, string[]>;\n\n  /**\n   * Friendly labels to describe each source of proposed names.\n   * Keyed by the source ID.\n   */\n  sourceLabels: Record<string, string>;\n};\n\n/** The request data to get proposed names from a name provider. */\nexport type NameProviderRequest = {\n  /** The optional list of source IDs to get proposed names from. */\n  sourceIds?: string[];\n\n  /** The type of name being requested. */\n  type: NameType;\n\n  /** The raw value to get proposed names for. */\n  value: string;\n\n  /**\n   * The variation of the raw value to get proposed names for.\n   * For example, the chain ID if the raw value is an Ethereum address.\n   */\n  variation: string;\n};\n\n/** The resulting data after requesting proposed names from a name provider, for a single source. */\nexport type NameProviderSourceResult = {\n  /**\n   * The array of proposed names from the source.\n   * Undefined if there is an error.\n   */\n  proposedNames?: string[];\n\n  /**\n   * The delay in seconds before the next request to the source should be made.\n   * Can be used to avoid rate limiting for example.\n   */\n  updateDelay?: number;\n\n  /**\n   * An error that occurred while fetching the proposed names from the source.\n   * Undefined if there was no error.\n   */\n  error?: unknown;\n};\n\n/** The resulting data after requesting proposed names from a name provider. */\nexport type NameProviderResult = {\n  /**\n   * The resulting data from each alternate source of proposed names supported by the name provider.\n   * Keyed by the source ID.\n   */\n  results: Record<string, NameProviderSourceResult>;\n\n  /**\n   * An error that occurred while fetching the proposed names that was not specific to a single source.\n   * Undefined if there was no error.\n   */\n  error?: unknown;\n};\n\n/** An object capable of proposing friendly names for a raw value of a given type. */\nexport type NameProvider = {\n  /**\n   * Returns metadata about the name provider.\n   */\n  getMetadata(): NameProviderMetadata;\n\n  /**\n   * Returns proposed names for the given value and request data.\n   *\n   * @param request - The request data including the value to propose names for.\n   */\n  getProposedNames(request: NameProviderRequest): Promise<NameProviderResult>;\n};\n"],"mappings":";AACO,IAAK,WAAL,kBAAKA,cAAL;AAEL,EAAAA,UAAA,sBAAmB;AAFT,SAAAA;AAAA,GAAA;","names":["NameType"]}