@deeeed/metamask-harness 0.36.0 → 0.38.0

package/library/actions/shared/swap-bridge/visible-state.mjs

@@ -0,0 +1,97 @@
+function text(value) {
+  if (typeof value !== 'string') return undefined;
+  const normalized = value.replace(/\s+/gu, ' ').trim();
+  return normalized ? normalized.slice(0, 500) : undefined;
+}
+
+function symbol(value) {
+  if (value == null) return undefined;
+  const normalized = String(value).trim().toUpperCase();
+  if (!normalized) return undefined;
+  return normalized;
+}
+
+export function resolveVisibleSwapBridgeOptions(node = {}) {
+  return {
+    sourceSymbol: symbol(node.source_symbol),
+    destinationSymbol: symbol(node.destination_symbol),
+    requireAmountInputs: node.require_amount_inputs !== false,
+    requireSettings: node.require_settings === true,
+  };
+}
+
+function normalizedItem(source) {
+  const testId = text(source?.testId ?? source?.test_id ?? source?.identifier);
+  if (!testId) return undefined;
+  return {
+    testId,
+    label: text(source?.label ?? source?.text) ?? null,
+    value: text(source?.value) ?? null,
+    enabled: source?.enabled !== false,
+    visible: source?.visible !== false,
+  };
+}
+
+function tokenLabel(item) {
+  return text(item?.label ?? item?.value) ?? null;
+}
+
+function matchesSymbol(value, expected) {
+  if (!expected) return true;
+  return new RegExp(`(^|[^A-Z0-9])${expected.replace(/[.*+?^${}()|[\]\\]/gu, '\\$&')}([^A-Z0-9]|$)`, 'u')
+    .test(String(value ?? '').toUpperCase());
+}
+
+export function normalizeVisibleSwapBridgeState(raw, options, platform) {
+  const items = [...(raw.items ?? []), ...(raw.offscreenItems ?? [])]
+    .map(normalizedItem)
+    .filter(Boolean);
+  const unique = Array.from(new Map(items.map((item) => [item.testId, item])).values());
+  const byId = new Map(unique.map((item) => [item.testId, item]));
+  const sourceAsset = tokenLabel(byId.get(platform === 'extension' ? 'bridge-source-button' : 'source-token-area'));
+  const destinationAsset = tokenLabel(byId.get(platform === 'extension' ? 'bridge-destination-button' : 'dest-token-area'));
+  const sourceInput = byId.get(platform === 'extension' ? 'from-amount' : 'source-token-area-input');
+  const destinationInput = byId.get(platform === 'extension' ? 'to-amount' : 'dest-token-area-input');
+  const settings = byId.get(platform === 'extension' ? 'bridge__header-settings-button' : 'bridge-slippage-settings-button');
+  const noQuotes = byId.get(platform === 'extension' ? 'prepare-swap-page-error' : 'bridge-no-quotes');
+  const missingPrice = byId.get(platform === 'extension' ? 'bridge-missing-price-banner' : 'bridge-missing-price-banner');
+  const state = {
+    source: 'visible-ui',
+    platform,
+    surface: 'swap',
+    ...(text(raw.route) ? { route: text(raw.route) } : {}),
+    ...(text(raw.title) ? { title: text(raw.title) } : {}),
+    sourceAsset,
+    destinationAsset,
+    sourceAmount: text(sourceInput?.value ?? sourceInput?.label) ?? null,
+    destinationAmount: text(destinationInput?.value ?? destinationInput?.label) ?? null,
+    controls: unique.slice(0, 100),
+    features: {
+      'amount-inputs': Boolean(sourceInput && destinationInput),
+      settings: Boolean(settings),
+      'asset-selectors': Boolean(sourceAsset && destinationAsset),
+    },
+    quoteState: noQuotes ? 'unavailable' : missingPrice ? 'missing-price' : 'idle-or-ready',
+    truncated: raw.truncated === true || unique.length > 100,
+  };
+  assertVisibleSwapBridgeState(state, options);
+  return state;
+}
+
+function assertVisibleSwapBridgeState(state, options) {
+  if (!state.features['asset-selectors']) {
+    throw new Error('Visible Swap source and destination token selectors were not both observed.');
+  }
+  if (options.requireAmountInputs && !state.features['amount-inputs']) {
+    throw new Error('Visible Swap source and destination amount inputs were not both observed.');
+  }
+  if (options.requireSettings && !state.features.settings) {
+    throw new Error('Visible Swap settings control was not observed.');
+  }
+  if (!matchesSymbol(state.sourceAsset, options.sourceSymbol)) {
+    throw new Error(`Expected visible Swap source ${options.sourceSymbol}, but observed ${JSON.stringify(state.sourceAsset)}.`);
+  }
+  if (!matchesSymbol(state.destinationAsset, options.destinationSymbol)) {
+    throw new Error(`Expected visible Swap destination ${options.destinationSymbol}, but observed ${JSON.stringify(state.destinationAsset)}.`);
+  }
+}

package/library/actions/shared/ui/locators.mjs

@@ -30,6 +30,7 @@ export function locatorsFromObservation(observation) {
       const leftBest = left.suggestions[0];
       const rightBest = right.suggestions[0];
       return (
+        locatorPriority(left) - locatorPriority(right) ||
         confidenceRank(leftBest?.confidence) - confidenceRank(rightBest?.confidence) ||
         strategyRank(leftBest?.strategy) - strategyRank(rightBest?.strategy)
       );
@@ -44,6 +45,12 @@ export function locatorsFromObservation(observation) {
   };
 }
 
+function locatorPriority(locator) {
+  const role = text(locator.role)?.toLowerCase() ?? '';
+  if (INTERACTIVE_ROLE_PARTS.some((part) => role.includes(part))) return 0;
+  return locator.description.includes('label=') ? 1 : 2;
+}
+
 export function requireVisibleObservation(result) {
   const value = record(result);
   const observations = record(value.observations);