@metamask-previews/perps-controller 8.2.0-preview-9de9aa4 → 8.2.0-preview-153490ebd

package/dist/services/TerminalMarketService.mjs

@@ -1,181 +0,0 @@
-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 _TerminalMarketService_instances, _TerminalMarketService_deps, _TerminalMarketService_cache, _TerminalMarketService_validateItems, _TerminalMarketService_mapToMarketInfo, _TerminalMarketService_extractMetadata;
-import { array, boolean, is, nullable, number, optional, string, type } from "@metamask/superstruct";
-import { PERPS_CONSTANTS, TERMINAL_API_CONFIG } from "../constants/perpsConfig.mjs";
-import { MarketCategory } from "../types/index.mjs";
-import { ensureError } from "../utils/errorUtils.mjs";
-const VALID_MARKET_TYPES = new Set(Object.values(MarketCategory));
-/**
- * Runtime validation schema for a single market item returned by
- * `GET {terminalApiUrl}`.
- *
- * Uses `type()` (loose object matching) so that extra fields the API sends
- * (e.g. `price`, `iconUrl`, `trend`) are silently accepted.
- * Each item is individually validated; items that fail validation are
- * filtered out and logged rather than rejecting the entire response.
- */
-const TerminalPerpetualItemStruct = type({
-    symbol: string(),
-    name: optional(nullable(string())),
-    szDecimals: optional(number()),
-    maxLeverage: optional(number()),
-    marginTableId: optional(number()),
-    onlyIsolated: optional(boolean()),
-    isDelisted: optional(boolean()),
-    minimumOrderSize: optional(number()),
-    keywords: optional(nullable(array(string()))),
-    tags: optional(nullable(array(string()))),
-    categories: optional(nullable(array(string()))),
-    marketType: optional(nullable(string())),
-});
-/**
- * TerminalMarketService
- *
- * Fetches structured market metadata from the MetaMask Terminal API.
- * Caches responses for {@link TERMINAL_API_CONFIG.CacheTtlMs} to avoid
- * redundant network calls across polling cycles.
- *
- * Instance-based service with constructor injection of platform dependencies.
- */
-export class TerminalMarketService {
-    constructor(deps) {
-        _TerminalMarketService_instances.add(this);
-        _TerminalMarketService_deps.set(this, void 0);
-        _TerminalMarketService_cache.set(this, null);
-        __classPrivateFieldSet(this, _TerminalMarketService_deps, deps, "f");
-    }
-    /**
-     * Fetch markets from the Terminal API.
-     * Returns cached data when available and within TTL.
-     *
-     * @returns Object with mapped MarketInfo array and per-symbol metadata.
-     */
-    async fetchMarkets() {
-        if (__classPrivateFieldGet(this, _TerminalMarketService_cache, "f") &&
-            Date.now() - __classPrivateFieldGet(this, _TerminalMarketService_cache, "f").timestamp < TERMINAL_API_CONFIG.CacheTtlMs) {
-            return {
-                markets: __classPrivateFieldGet(this, _TerminalMarketService_cache, "f").markets,
-                metadata: __classPrivateFieldGet(this, _TerminalMarketService_cache, "f").metadata,
-            };
-        }
-        if (!__classPrivateFieldGet(this, _TerminalMarketService_deps, "f").terminalApiUrl) {
-            throw new Error('Terminal API URL not configured (terminalApiUrl is required)');
-        }
-        const url = __classPrivateFieldGet(this, _TerminalMarketService_deps, "f").terminalApiUrl;
-        const response = await fetch(url, {
-            method: 'GET',
-            headers: { 'Content-Type': 'application/json' },
-        });
-        if (!response.ok) {
-            throw new Error(`Terminal API returned ${String(response.status)}: ${response.statusText}`);
-        }
-        const body = await response.json();
-        if (!Array.isArray(body)) {
-            throw new Error(`Terminal API returned non-array body: ${typeof body}`);
-        }
-        const items = __classPrivateFieldGet(this, _TerminalMarketService_instances, "m", _TerminalMarketService_validateItems).call(this, body);
-        const markets = __classPrivateFieldGet(this, _TerminalMarketService_instances, "m", _TerminalMarketService_mapToMarketInfo).call(this, items);
-        const metadata = __classPrivateFieldGet(this, _TerminalMarketService_instances, "m", _TerminalMarketService_extractMetadata).call(this, items);
-        __classPrivateFieldSet(this, _TerminalMarketService_cache, { markets, metadata, timestamp: Date.now() }, "f");
-        return { markets, metadata };
-    }
-    /**
-     * Invalidate the internal cache so the next fetch hits the network.
-     */
-    clearCache() {
-        __classPrivateFieldSet(this, _TerminalMarketService_cache, null, "f");
-    }
-    /**
-     * Log a Terminal API error to Sentry without surfacing it to the user.
-     *
-     * @param error - The caught error.
-     * @param method - The calling method name for context.
-     */
-    logError(error, method) {
-        __classPrivateFieldGet(this, _TerminalMarketService_deps, "f").logger.error(ensureError(error, `TerminalMarketService.${method}`), {
-            tags: { feature: PERPS_CONSTANTS.FeatureName, source: 'terminal-api' },
-            context: {
-                name: `TerminalMarketService.${method}`,
-                data: { url: __classPrivateFieldGet(this, _TerminalMarketService_deps, "f").terminalApiUrl },
-            },
-        });
-    }
-}
-_TerminalMarketService_deps = new WeakMap(), _TerminalMarketService_cache = new WeakMap(), _TerminalMarketService_instances = new WeakSet(), _TerminalMarketService_validateItems = function _TerminalMarketService_validateItems(raw) {
-    const valid = [];
-    for (const item of raw) {
-        if (is(item, TerminalPerpetualItemStruct)) {
-            valid.push(item);
-        }
-        else {
-            __classPrivateFieldGet(this, _TerminalMarketService_deps, "f").logger.error(ensureError(new Error('Terminal API item failed schema validation'), 'TerminalMarketService.validateItems'), {
-                tags: {
-                    feature: PERPS_CONSTANTS.FeatureName,
-                    source: 'terminal-api',
-                },
-                context: {
-                    name: 'TerminalMarketService.validateItems',
-                    data: {
-                        symbol: typeof item === 'object' &&
-                            item !== null &&
-                            Object.prototype.hasOwnProperty.call(item, 'symbol')
-                            ? item.symbol
-                            : undefined,
-                    },
-                },
-            });
-        }
-    }
-    return valid;
-}, _TerminalMarketService_mapToMarketInfo = function _TerminalMarketService_mapToMarketInfo(items) {
-    return items
-        .filter((item) => typeof item.symbol === 'string' && item.symbol.length > 0)
-        .map((item) => ({
-        name: item.symbol,
-        szDecimals: item.szDecimals ?? 0,
-        maxLeverage: item.maxLeverage ?? 1,
-        marginTableId: item.marginTableId ?? 0,
-        ...(item.onlyIsolated === true && { onlyIsolated: true }),
-        ...(item.isDelisted === true && { isDelisted: true }),
-        ...(item.minimumOrderSize !== undefined && {
-            minimumOrderSize: item.minimumOrderSize,
-        }),
-    }));
-}, _TerminalMarketService_extractMetadata = function _TerminalMarketService_extractMetadata(items) {
-    const map = new Map();
-    for (const item of items) {
-        if (typeof item.symbol !== 'string' || item.symbol.length === 0) {
-            continue;
-        }
-        const entry = {
-            name: item.name ?? item.symbol,
-        };
-        if (Array.isArray(item.keywords) && item.keywords.length > 0) {
-            entry.keywords = item.keywords;
-        }
-        if (Array.isArray(item.tags) && item.tags.length > 0) {
-            entry.tags = item.tags;
-        }
-        if (Array.isArray(item.categories) && item.categories.length > 0) {
-            entry.categories = item.categories;
-        }
-        if (typeof item.marketType === 'string' &&
-            VALID_MARKET_TYPES.has(item.marketType)) {
-            entry.marketType =
-                item.marketType;
-        }
-        map.set(item.symbol, entry);
-    }
-    return map;
-};
-//# sourceMappingURL=TerminalMarketService.mjs.map

package/dist/services/TerminalMarketService.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"TerminalMarketService.mjs","sourceRoot":"","sources":["../../src/services/TerminalMarketService.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Infer } from '@metamask/superstruct';\nimport {\n  array,\n  boolean,\n  is,\n  nullable,\n  number,\n  optional,\n  string,\n  type,\n} from '@metamask/superstruct';\n\nimport { PERPS_CONSTANTS, TERMINAL_API_CONFIG } from '../constants/perpsConfig';\nimport type {\n  MarketInfo,\n  PerpsPlatformDependencies,\n  TerminalAssetMetadata,\n} from '../types';\nimport { MarketCategory } from '../types';\nimport { ensureError } from '../utils/errorUtils';\n\nconst VALID_MARKET_TYPES = new Set<string>(Object.values(MarketCategory));\n\n/**\n * Runtime validation schema for a single market item returned by\n * `GET {terminalApiUrl}`.\n *\n * Uses `type()` (loose object matching) so that extra fields the API sends\n * (e.g. `price`, `iconUrl`, `trend`) are silently accepted.\n * Each item is individually validated; items that fail validation are\n * filtered out and logged rather than rejecting the entire response.\n */\nconst TerminalPerpetualItemStruct = type({\n  symbol: string(),\n  name: optional(nullable(string())),\n  szDecimals: optional(number()),\n  maxLeverage: optional(number()),\n  marginTableId: optional(number()),\n  onlyIsolated: optional(boolean()),\n  isDelisted: optional(boolean()),\n  minimumOrderSize: optional(number()),\n  keywords: optional(nullable(array(string()))),\n  tags: optional(nullable(array(string()))),\n  categories: optional(nullable(array(string()))),\n  marketType: optional(nullable(string())),\n});\n\ntype TerminalPerpetualItem = Infer<typeof TerminalPerpetualItemStruct>;\n\ntype CacheEntry = {\n  markets: MarketInfo[];\n  metadata: Map<string, TerminalAssetMetadata>;\n  timestamp: number;\n};\n\n/**\n * TerminalMarketService\n *\n * Fetches structured market metadata from the MetaMask Terminal API.\n * Caches responses for {@link TERMINAL_API_CONFIG.CacheTtlMs} to avoid\n * redundant network calls across polling cycles.\n *\n * Instance-based service with constructor injection of platform dependencies.\n */\nexport class TerminalMarketService {\n  readonly #deps: PerpsPlatformDependencies;\n\n  #cache: CacheEntry | null = null;\n\n  constructor(deps: PerpsPlatformDependencies) {\n    this.#deps = deps;\n  }\n\n  /**\n   * Fetch markets from the Terminal API.\n   * Returns cached data when available and within TTL.\n   *\n   * @returns Object with mapped MarketInfo array and per-symbol metadata.\n   */\n  async fetchMarkets(): Promise<{\n    markets: MarketInfo[];\n    metadata: Map<string, TerminalAssetMetadata>;\n  }> {\n    if (\n      this.#cache &&\n      Date.now() - this.#cache.timestamp < TERMINAL_API_CONFIG.CacheTtlMs\n    ) {\n      return {\n        markets: this.#cache.markets,\n        metadata: this.#cache.metadata,\n      };\n    }\n\n    if (!this.#deps.terminalApiUrl) {\n      throw new Error(\n        'Terminal API URL not configured (terminalApiUrl is required)',\n      );\n    }\n\n    const url = this.#deps.terminalApiUrl;\n    const response = await fetch(url, {\n      method: 'GET',\n      headers: { 'Content-Type': 'application/json' },\n    });\n\n    if (!response.ok) {\n      throw new Error(\n        `Terminal API returned ${String(response.status)}: ${response.statusText}`,\n      );\n    }\n\n    const body: unknown = await response.json();\n\n    if (!Array.isArray(body)) {\n      throw new Error(`Terminal API returned non-array body: ${typeof body}`);\n    }\n\n    const items = this.#validateItems(body);\n    const markets = this.#mapToMarketInfo(items);\n    const metadata = this.#extractMetadata(items);\n\n    this.#cache = { markets, metadata, timestamp: Date.now() };\n    return { markets, metadata };\n  }\n\n  /**\n   * Invalidate the internal cache so the next fetch hits the network.\n   */\n  clearCache(): void {\n    this.#cache = null;\n  }\n\n  /**\n   * Validate raw API response items against the expected schema.\n   * Items that fail validation are filtered out and logged rather than\n   * rejecting the entire response.\n   *\n   * @param raw - The raw array from the API response body.\n   * @returns Array of validated items.\n   */\n  #validateItems(raw: unknown[]): TerminalPerpetualItem[] {\n    const valid: TerminalPerpetualItem[] = [];\n    for (const item of raw) {\n      if (is(item, TerminalPerpetualItemStruct)) {\n        valid.push(item);\n      } else {\n        this.#deps.logger.error(\n          ensureError(\n            new Error('Terminal API item failed schema validation'),\n            'TerminalMarketService.validateItems',\n          ),\n          {\n            tags: {\n              feature: PERPS_CONSTANTS.FeatureName,\n              source: 'terminal-api',\n            },\n            context: {\n              name: 'TerminalMarketService.validateItems',\n              data: {\n                symbol:\n                  typeof item === 'object' &&\n                  item !== null &&\n                  Object.prototype.hasOwnProperty.call(item, 'symbol')\n                    ? (item as Record<string, unknown>).symbol\n                    : undefined,\n              },\n            },\n          },\n        );\n      }\n    }\n    return valid;\n  }\n\n  /**\n   * Map Terminal API items to the protocol-agnostic MarketInfo shape.\n   *\n   * @param items - Raw items from the API response.\n   * @returns Array of MarketInfo objects.\n   */\n  #mapToMarketInfo(items: TerminalPerpetualItem[]): MarketInfo[] {\n    return items\n      .filter(\n        (item) => typeof item.symbol === 'string' && item.symbol.length > 0,\n      )\n      .map((item) => ({\n        name: item.symbol,\n        szDecimals: item.szDecimals ?? 0,\n        maxLeverage: item.maxLeverage ?? 1,\n        marginTableId: item.marginTableId ?? 0,\n        ...(item.onlyIsolated === true && { onlyIsolated: true as const }),\n        ...(item.isDelisted === true && { isDelisted: true as const }),\n        ...(item.minimumOrderSize !== undefined && {\n          minimumOrderSize: item.minimumOrderSize,\n        }),\n      }));\n  }\n\n  /**\n   * Extract per-symbol metadata for downstream merge into PerpsMarketData.\n   *\n   * @param items - Raw items from the API response.\n   * @returns Map keyed by symbol with enrichment metadata.\n   */\n  #extractMetadata(\n    items: TerminalPerpetualItem[],\n  ): Map<string, TerminalAssetMetadata> {\n    const map = new Map<string, TerminalAssetMetadata>();\n\n    for (const item of items) {\n      if (typeof item.symbol !== 'string' || item.symbol.length === 0) {\n        continue;\n      }\n\n      const entry: TerminalAssetMetadata = {\n        name: item.name ?? item.symbol,\n      };\n\n      if (Array.isArray(item.keywords) && item.keywords.length > 0) {\n        entry.keywords = item.keywords;\n      }\n      if (Array.isArray(item.tags) && item.tags.length > 0) {\n        entry.tags = item.tags;\n      }\n      if (Array.isArray(item.categories) && item.categories.length > 0) {\n        entry.categories = item.categories;\n      }\n      if (\n        typeof item.marketType === 'string' &&\n        VALID_MARKET_TYPES.has(item.marketType)\n      ) {\n        entry.marketType =\n          item.marketType as TerminalAssetMetadata['marketType'];\n      }\n\n      map.set(item.symbol, entry);\n    }\n\n    return map;\n  }\n\n  /**\n   * Log a Terminal API error to Sentry without surfacing it to the user.\n   *\n   * @param error - The caught error.\n   * @param method - The calling method name for context.\n   */\n  logError(error: unknown, method: string): void {\n    this.#deps.logger.error(\n      ensureError(error, `TerminalMarketService.${method}`),\n      {\n        tags: { feature: PERPS_CONSTANTS.FeatureName, source: 'terminal-api' },\n        context: {\n          name: `TerminalMarketService.${method}`,\n          data: { url: this.#deps.terminalApiUrl },\n        },\n      },\n    );\n  }\n}\n"]}