@metamask-previews/perps-controller 8.2.0-preview-b2742a2fc → 8.3.0-preview-a8fd340

package/dist/services/TerminalMarketService.cjs

@@ -0,0 +1,195 @@
+"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 _TerminalMarketService_instances, _TerminalMarketService_deps, _TerminalMarketService_cache, _TerminalMarketService_validateItems, _TerminalMarketService_mapToMarketInfo, _TerminalMarketService_extractMetadata;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TerminalMarketService = void 0;
+const superstruct_1 = require("@metamask/superstruct");
+const perpsConfig_1 = require("../constants/perpsConfig.cjs");
+const types_1 = require("../types/index.cjs");
+const errorUtils_1 = require("../utils/errorUtils.cjs");
+const VALID_MARKET_TYPES = new Set(Object.values(types_1.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 = (0, superstruct_1.type)({
+    symbol: (0, superstruct_1.string)(),
+    name: (0, superstruct_1.optional)((0, superstruct_1.nullable)((0, superstruct_1.string)())),
+    szDecimals: (0, superstruct_1.optional)((0, superstruct_1.number)()),
+    maxLeverage: (0, superstruct_1.optional)((0, superstruct_1.number)()),
+    marginTableId: (0, superstruct_1.optional)((0, superstruct_1.number)()),
+    onlyIsolated: (0, superstruct_1.optional)((0, superstruct_1.boolean)()),
+    isDelisted: (0, superstruct_1.optional)((0, superstruct_1.boolean)()),
+    minimumOrderSize: (0, superstruct_1.optional)((0, superstruct_1.number)()),
+    keywords: (0, superstruct_1.optional)((0, superstruct_1.nullable)((0, superstruct_1.array)((0, superstruct_1.string)()))),
+    tags: (0, superstruct_1.optional)((0, superstruct_1.nullable)((0, superstruct_1.array)((0, superstruct_1.string)()))),
+    categories: (0, superstruct_1.optional)((0, superstruct_1.nullable)((0, superstruct_1.array)((0, superstruct_1.string)()))),
+    marketType: (0, superstruct_1.optional)((0, superstruct_1.nullable)((0, superstruct_1.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.
+ */
+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 < perpsConfig_1.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 controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(new Error('Terminal API fetch timed out')), perpsConfig_1.TERMINAL_API_CONFIG.FetchTimeoutMs);
+        let response;
+        try {
+            response = await fetch(url, {
+                method: 'GET',
+                headers: { 'Content-Type': 'application/json' },
+                signal: controller.signal,
+            });
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+        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((0, errorUtils_1.ensureError)(error, `TerminalMarketService.${method}`), {
+            tags: { feature: perpsConfig_1.PERPS_CONSTANTS.FeatureName, source: 'terminal-api' },
+            context: {
+                name: `TerminalMarketService.${method}`,
+                data: { url: __classPrivateFieldGet(this, _TerminalMarketService_deps, "f").terminalApiUrl },
+            },
+        });
+    }
+}
+exports.TerminalMarketService = TerminalMarketService;
+_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 ((0, superstruct_1.is)(item, TerminalPerpetualItemStruct)) {
+            valid.push(item);
+        }
+        else {
+            __classPrivateFieldGet(this, _TerminalMarketService_deps, "f").logger.error((0, errorUtils_1.ensureError)(new Error('Terminal API item failed schema validation'), 'TerminalMarketService.validateItems'), {
+                tags: {
+                    feature: perpsConfig_1.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 = {};
+        if (typeof item.name === 'string' && item.name.length > 0) {
+            entry.name = item.name;
+        }
+        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.cjs.map

package/dist/services/TerminalMarketService.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"TerminalMarketService.cjs","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 controller = new AbortController();\n    const timeoutId = setTimeout(\n      () => controller.abort(new Error('Terminal API fetch timed out')),\n      TERMINAL_API_CONFIG.FetchTimeoutMs,\n    );\n\n    let response: Response;\n    try {\n      response = await fetch(url, {\n        method: 'GET',\n        headers: { 'Content-Type': 'application/json' },\n        signal: controller.signal,\n      });\n    } finally {\n      clearTimeout(timeoutId);\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\n      if (typeof item.name === 'string' && item.name.length > 0) {\n        entry.name = item.name;\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"]}

package/dist/services/TerminalMarketService.d.cts

@@ -0,0 +1,36 @@
+import type { MarketInfo, PerpsPlatformDependencies, TerminalAssetMetadata } from "../types/index.cjs";
+/**
+ * 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 declare class TerminalMarketService {
+    #private;
+    constructor(deps: PerpsPlatformDependencies);
+    /**
+     * Fetch markets from the Terminal API.
+     * Returns cached data when available and within TTL.
+     *
+     * @returns Object with mapped MarketInfo array and per-symbol metadata.
+     */
+    fetchMarkets(): Promise<{
+        markets: MarketInfo[];
+        metadata: Map<string, TerminalAssetMetadata>;
+    }>;
+    /**
+     * Invalidate the internal cache so the next fetch hits the network.
+     */
+    clearCache(): void;
+    /**
+     * 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: unknown, method: string): void;
+}
+//# sourceMappingURL=TerminalMarketService.d.cts.map

package/dist/services/TerminalMarketService.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TerminalMarketService.d.cts","sourceRoot":"","sources":["../../src/services/TerminalMarketService.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EACV,UAAU,EACV,yBAAyB,EACzB,qBAAqB,EACtB,2BAAiB;AAsClB;;;;;;;;GAQG;AACH,qBAAa,qBAAqB;;gBAKpB,IAAI,EAAE,yBAAyB;IAI3C;;;;;OAKG;IACG,YAAY,IAAI,OAAO,CAAC;QAC5B,OAAO,EAAE,UAAU,EAAE,CAAC;QACtB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;KAC9C,CAAC;IAuDF;;OAEG;IACH,UAAU,IAAI,IAAI;IAmHlB;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CAY/C"}

package/dist/services/TerminalMarketService.d.mts

@@ -0,0 +1,36 @@
+import type { MarketInfo, PerpsPlatformDependencies, TerminalAssetMetadata } from "../types/index.mjs";
+/**
+ * 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 declare class TerminalMarketService {
+    #private;
+    constructor(deps: PerpsPlatformDependencies);
+    /**
+     * Fetch markets from the Terminal API.
+     * Returns cached data when available and within TTL.
+     *
+     * @returns Object with mapped MarketInfo array and per-symbol metadata.
+     */
+    fetchMarkets(): Promise<{
+        markets: MarketInfo[];
+        metadata: Map<string, TerminalAssetMetadata>;
+    }>;
+    /**
+     * Invalidate the internal cache so the next fetch hits the network.
+     */
+    clearCache(): void;
+    /**
+     * 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: unknown, method: string): void;
+}
+//# sourceMappingURL=TerminalMarketService.d.mts.map

package/dist/services/TerminalMarketService.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TerminalMarketService.d.mts","sourceRoot":"","sources":["../../src/services/TerminalMarketService.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EACV,UAAU,EACV,yBAAyB,EACzB,qBAAqB,EACtB,2BAAiB;AAsClB;;;;;;;;GAQG;AACH,qBAAa,qBAAqB;;gBAKpB,IAAI,EAAE,yBAAyB;IAI3C;;;;;OAKG;IACG,YAAY,IAAI,OAAO,CAAC;QAC5B,OAAO,EAAE,UAAU,EAAE,CAAC;QACtB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;KAC9C,CAAC;IAuDF;;OAEG;IACH,UAAU,IAAI,IAAI;IAmHlB;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CAY/C"}

package/dist/services/TerminalMarketService.mjs

@@ -0,0 +1,191 @@
+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 controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(new Error('Terminal API fetch timed out')), TERMINAL_API_CONFIG.FetchTimeoutMs);
+        let response;
+        try {
+            response = await fetch(url, {
+                method: 'GET',
+                headers: { 'Content-Type': 'application/json' },
+                signal: controller.signal,
+            });
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+        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 = {};
+        if (typeof item.name === 'string' && item.name.length > 0) {
+            entry.name = item.name;
+        }
+        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

@@ -0,0 +1 @@
+{"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 controller = new AbortController();\n    const timeoutId = setTimeout(\n      () => controller.abort(new Error('Terminal API fetch timed out')),\n      TERMINAL_API_CONFIG.FetchTimeoutMs,\n    );\n\n    let response: Response;\n    try {\n      response = await fetch(url, {\n        method: 'GET',\n        headers: { 'Content-Type': 'application/json' },\n        signal: controller.signal,\n      });\n    } finally {\n      clearTimeout(timeoutId);\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\n      if (typeof item.name === 'string' && item.name.length > 0) {\n        entry.name = item.name;\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"]}