@striderlabs/mcp-hm 0.1.0

package/src/browser.ts

@@ -0,0 +1,820 @@
+import { chromium, type Browser, type BrowserContext, type Page } from "patchright";
+import { saveCookies, loadCookies, saveSessionInfo, loadSessionInfo, clearAuthData } from "./auth.js";
+
+const HM_BASE = "https://www2.hm.com/en_us";
+const HM_SEARCH = `${HM_BASE}/search-results.html`;
+const HM_SALE = `${HM_BASE}/sale`;
+const HM_CART = `${HM_BASE}/cart`;
+const HM_WISHLIST = `${HM_BASE}/wishlist.html`;
+const HM_ORDERS = `${HM_BASE}/profile/order-history.html`;
+const HM_STORES = `${HM_BASE}/store-finder.html`;
+const HM_MEMBER = `${HM_BASE}/member`;
+const HM_SIZE_GUIDE = `${HM_BASE}/customer-service/size-guide.html`;
+
+export interface ProductResult {
+  name: string;
+  price: string;
+  originalPrice?: string;
+  discount?: string;
+  color?: string;
+  imageUrl?: string;
+  productUrl?: string;
+  productId?: string;
+  category?: string;
+  isOnSale: boolean;
+}
+
+export interface ProductDetails {
+  name: string;
+  price: string;
+  originalPrice?: string;
+  description?: string;
+  materials?: string;
+  colors: string[];
+  sizes: string[];
+  availableSizes: string[];
+  images: string[];
+  productId?: string;
+  category?: string;
+  careInstructions?: string;
+  fit?: string;
+}
+
+export interface CartItem {
+  name: string;
+  price: string;
+  color?: string;
+  size?: string;
+  quantity: number;
+  imageUrl?: string;
+}
+
+export interface CartSummary {
+  items: CartItem[];
+  subtotal: string;
+  total: string;
+  itemCount: number;
+  estimatedShipping?: string;
+}
+
+export interface StoreResult {
+  name: string;
+  address: string;
+  city: string;
+  distance?: string;
+  phone?: string;
+  hours?: string;
+  hasStock?: boolean;
+}
+
+export interface MemberInfo {
+  name?: string;
+  email?: string;
+  points?: string;
+  tier?: string;
+  rewards?: string[];
+  nextReward?: string;
+}
+
+export interface OrderInfo {
+  orderId: string;
+  date: string;
+  status: string;
+  total: string;
+  items?: string[];
+  estimatedDelivery?: string;
+  trackingNumber?: string;
+}
+
+export interface WishlistItem {
+  name: string;
+  price: string;
+  color?: string;
+  imageUrl?: string;
+  productUrl?: string;
+  inStock: boolean;
+}
+
+export interface SizeGuideEntry {
+  garmentType: string;
+  measurements: Record<string, string>;
+  tips?: string;
+}
+
+let browser: Browser | null = null;
+let context: BrowserContext | null = null;
+let page: Page | null = null;
+
+async function getPage(): Promise<Page> {
+  if (!browser) {
+    browser = await chromium.launch({
+      headless: true,
+      channel: "chrome",
+      args: [
+        "--no-sandbox",
+        "--disable-blink-features=AutomationControlled",
+        "--disable-infobars",
+        "--disable-dev-shm-usage",
+      ],
+    });
+  }
+
+  if (!context) {
+    context = await browser.newContext({
+      userAgent:
+        "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36",
+      viewport: { width: 1280, height: 900 },
+      locale: "en-US",
+    });
+    await loadCookies(context);
+  }
+
+  if (!page || page.isClosed()) {
+    page = await context.newPage();
+    await page.setExtraHTTPHeaders({
+      "Accept-Language": "en-US,en;q=0.9",
+    });
+  }
+
+  return page;
+}
+
+async function dismissPopups(p: Page): Promise<void> {
+  try {
+    // Cookie consent
+    const cookieBtn = p.locator('[id*="onetrust-accept"], [class*="cookie-accept"], button:has-text("Accept All"), button:has-text("Accept all cookies")');
+    if (await cookieBtn.first().isVisible({ timeout: 3000 })) {
+      await cookieBtn.first().click();
+      await p.waitForTimeout(500);
+    }
+  } catch {
+    // no popup
+  }
+  try {
+    // Newsletter/modal
+    const closeBtn = p.locator('[aria-label="Close"], [class*="modal-close"], [class*="dialog-close"]');
+    if (await closeBtn.first().isVisible({ timeout: 2000 })) {
+      await closeBtn.first().click();
+      await p.waitForTimeout(300);
+    }
+  } catch {
+    // no modal
+  }
+}
+
+export async function checkLoginStatus(): Promise<{ isLoggedIn: boolean; userEmail?: string; userName?: string }> {
+  try {
+    const p = await getPage();
+    await p.goto(HM_BASE, { waitUntil: "domcontentloaded", timeout: 30000 });
+    await dismissPopups(p);
+
+    // Check for logged-in indicators
+    const accountName = await p.locator('[data-testid="header-member-name"], [class*="member-name"], [class*="account-name"]').first().textContent({ timeout: 3000 }).catch(() => null);
+    const isLoggedIn = accountName !== null && accountName.trim().length > 0;
+
+    const session = loadSessionInfo();
+    if (isLoggedIn) {
+      const info = { isLoggedIn: true, userName: accountName?.trim(), userEmail: session.userEmail, lastUpdated: new Date().toISOString() };
+      saveSessionInfo(info);
+      return { isLoggedIn: true, userName: accountName?.trim(), userEmail: session.userEmail };
+    }
+
+    // Check profile icon state
+    const loginLink = await p.locator('a[href*="/login"], a[href*="sign-in"], [data-testid*="login"]').first().isVisible({ timeout: 2000 }).catch(() => false);
+    return { isLoggedIn: !loginLink };
+  } catch {
+    return { isLoggedIn: false };
+  }
+}
+
+export async function initiateLogin(): Promise<{ url: string; instructions: string }> {
+  const p = await getPage();
+  await p.goto(`${HM_BASE}/login`, { waitUntil: "domcontentloaded", timeout: 30000 });
+  await dismissPopups(p);
+  return {
+    url: p.url(),
+    instructions:
+      "Please complete login in the browser window. Once logged in, call hm_status to confirm and save your session.",
+  };
+}
+
+export async function logout(): Promise<void> {
+  try {
+    const p = await getPage();
+    await p.goto(`${HM_BASE}/logout`, { waitUntil: "domcontentloaded", timeout: 15000 });
+  } catch {
+    // ignore
+  }
+  clearAuthData();
+  if (context) {
+    await context.clearCookies();
+  }
+  saveSessionInfo({ isLoggedIn: false, lastUpdated: new Date().toISOString() });
+}
+
+export async function searchProducts(
+  query: string,
+  options: { maxResults?: number; category?: string; sortBy?: string; onSaleOnly?: boolean } = {}
+): Promise<ProductResult[]> {
+  const { maxResults = 10, category, sortBy, onSaleOnly = false } = options;
+  const p = await getPage();
+
+  let url = `${HM_SEARCH}?q=${encodeURIComponent(query)}`;
+  if (category) url += `&department=${encodeURIComponent(category)}`;
+  if (sortBy) url += `&sort=${encodeURIComponent(sortBy)}`;
+  if (onSaleOnly) url += `&sale=true`;
+
+  await p.goto(url, { waitUntil: "domcontentloaded", timeout: 30000 });
+  await dismissPopups(p);
+  await p.waitForTimeout(2000);
+
+  const results = await p.evaluate((max: number) => {
+    const items: {
+      name: string;
+      price: string;
+      originalPrice?: string;
+      discount?: string;
+      color?: string;
+      imageUrl?: string;
+      productUrl?: string;
+      productId?: string;
+      isOnSale: boolean;
+    }[] = [];
+
+    // H&M product cards
+    const cards = document.querySelectorAll(
+      "article.product-item, [class*='product-item'], li[class*='product'], [data-productid]"
+    );
+
+    cards.forEach((card, idx) => {
+      if (idx >= max) return;
+
+      const nameEl = card.querySelector("h2, h3, [class*='item-heading'], [class*='product-name']");
+      const name = nameEl?.textContent?.trim() || "";
+      if (!name) return;
+
+      const priceEl = card.querySelector("[class*='price']:not([class*='original']):not([class*='regular-price'])");
+      const originalPriceEl = card.querySelector("[class*='original-price'], [class*='regular-price']");
+      const price = priceEl?.textContent?.trim() || "";
+      const originalPrice = originalPriceEl?.textContent?.trim();
+      const isOnSale = !!originalPrice && originalPrice !== price;
+
+      const colorEl = card.querySelector("[class*='color'], [class*='swatch']");
+      const color = colorEl?.getAttribute("title") || colorEl?.textContent?.trim();
+
+      const imgEl = card.querySelector("img");
+      const imageUrl = imgEl?.src || imgEl?.getAttribute("data-src") || "";
+
+      const linkEl = card.querySelector("a[href]");
+      const productUrl = linkEl ? "https://www2.hm.com" + (linkEl.getAttribute("href") || "") : "";
+      const productId = card.getAttribute("data-productid") || card.getAttribute("data-article-code") || "";
+
+      items.push({ name, price, originalPrice, isOnSale, color, imageUrl, productUrl, productId });
+    });
+
+    // Fallback: try alternative selectors
+    if (items.length === 0) {
+      const altCards = document.querySelectorAll("[class*='ProductCard'], [class*='product-card']");
+      altCards.forEach((card, idx) => {
+        if (idx >= max) return;
+        const nameEl = card.querySelector("[class*='heading'], [class*='name'], h3, h4");
+        const name = nameEl?.textContent?.trim() || "";
+        if (!name) return;
+        const priceEl = card.querySelector("[class*='price']");
+        const price = priceEl?.textContent?.trim() || "";
+        const linkEl = card.querySelector("a");
+        const productUrl = linkEl ? "https://www2.hm.com" + (linkEl.getAttribute("href") || "") : "";
+        items.push({ name, price, isOnSale: false, productUrl });
+      });
+    }
+
+    return items;
+  }, maxResults);
+
+  return results;
+}
+
+export async function getProductDetails(productUrl: string): Promise<ProductDetails> {
+  const p = await getPage();
+
+  // Ensure full URL
+  const fullUrl = productUrl.startsWith("http") ? productUrl : `https://www2.hm.com${productUrl}`;
+  await p.goto(fullUrl, { waitUntil: "domcontentloaded", timeout: 30000 });
+  await dismissPopups(p);
+  await p.waitForTimeout(1500);
+
+  return await p.evaluate(() => {
+    const name = document.querySelector("h1, [class*='product-name'], [class*='heading-xlarge']")?.textContent?.trim() || "";
+    const priceEl = document.querySelector("[class*='price-value']:not([class*='original']), [class*='current-price']");
+    const price = priceEl?.textContent?.trim() || "";
+    const originalPriceEl = document.querySelector("[class*='original-price'], [class*='was-price']");
+    const originalPrice = originalPriceEl?.textContent?.trim();
+
+    const descEl = document.querySelector("[class*='description'], [class*='product-description'], [id*='section-descriptionAccordion']");
+    const description = descEl?.textContent?.trim();
+
+    const materialsEl = document.querySelector("[class*='composition'], [class*='material'], [id*='section-materialAndSuppliersAccordion']");
+    const materials = materialsEl?.textContent?.trim();
+
+    const careEl = document.querySelector("[class*='care'], [id*='section-careGuideAccordion']");
+    const careInstructions = careEl?.textContent?.trim();
+
+    // Colors
+    const colors: string[] = [];
+    document.querySelectorAll("[class*='color-option'], [class*='swatch'] [title], [aria-label*='color']").forEach((el) => {
+      const c = el.getAttribute("title") || el.getAttribute("aria-label") || el.textContent?.trim();
+      if (c && !colors.includes(c)) colors.push(c);
+    });
+
+    // Sizes
+    const sizes: string[] = [];
+    const availableSizes: string[] = [];
+    document.querySelectorAll("[class*='size-option'], [class*='size-button'], [data-size]").forEach((el) => {
+      const s = el.getAttribute("data-size") || el.textContent?.trim() || "";
+      if (!s) return;
+      if (!sizes.includes(s)) sizes.push(s);
+      const disabled = el.hasAttribute("disabled") || el.classList.contains("disabled") || el.getAttribute("aria-disabled") === "true";
+      if (!disabled && !availableSizes.includes(s)) availableSizes.push(s);
+    });
+
+    // Images
+    const images: string[] = [];
+    document.querySelectorAll("[class*='product-image'] img, [class*='gallery'] img").forEach((img) => {
+      const src = (img as HTMLImageElement).src;
+      if (src && !images.includes(src)) images.push(src);
+    });
+
+    const fitEl = document.querySelector("[class*='fit'], [class*='cut']");
+    const fit = fitEl?.textContent?.trim();
+
+    const productId = (document.querySelector("[data-articlecode], [data-productid]") as HTMLElement)?.dataset?.articlecode ||
+      (document.querySelector("[data-productid]") as HTMLElement)?.dataset?.productid ||
+      window.location.pathname.split(".").slice(-2)[0];
+
+    const breadcrumb = document.querySelector("[class*='breadcrumb'], nav[aria-label*='breadcrumb']");
+    const category = breadcrumb ? breadcrumb.textContent?.trim()?.split(/\s*\/\s*/).pop() : undefined;
+
+    return { name, price, originalPrice, description, materials, colors, sizes, availableSizes, images, productId, category, careInstructions, fit };
+  });
+}
+
+export async function getSizeGuide(category: string): Promise<SizeGuideEntry[]> {
+  const p = await getPage();
+  await p.goto(`${HM_SIZE_GUIDE}#${encodeURIComponent(category.toLowerCase())}`, {
+    waitUntil: "domcontentloaded",
+    timeout: 30000,
+  });
+  await dismissPopups(p);
+  await p.waitForTimeout(1000);
+
+  return await p.evaluate((cat: string) => {
+    const entries: { garmentType: string; measurements: Record<string, string>; tips?: string }[] = [];
+
+    const tables = document.querySelectorAll("table, [class*='size-table']");
+    tables.forEach((table) => {
+      const heading = table.previousElementSibling?.textContent?.trim() || cat;
+      const measurements: Record<string, string> = {};
+
+      const headers: string[] = [];
+      table.querySelectorAll("th").forEach((th) => headers.push(th.textContent?.trim() || ""));
+
+      table.querySelectorAll("tr").forEach((row) => {
+        const cells = row.querySelectorAll("td");
+        if (cells.length >= 2) {
+          const key = cells[0].textContent?.trim() || "";
+          const value = cells[1].textContent?.trim() || "";
+          if (key) measurements[key] = value;
+        }
+      });
+
+      if (Object.keys(measurements).length > 0) {
+        entries.push({ garmentType: heading, measurements });
+      }
+    });
+
+    if (entries.length === 0) {
+      // Fallback: extract any size content
+      const content = document.querySelector("[class*='size-guide'], [class*='sizing']");
+      if (content) {
+        entries.push({
+          garmentType: cat,
+          measurements: { info: content.textContent?.trim() || "See hm.com/en_us/customer-service/size-guide.html for full size guide" },
+        });
+      }
+    }
+
+    return entries;
+  }, category);
+}
+
+export async function addToCart(
+  productUrl: string,
+  options: { size?: string; color?: string; quantity?: number } = {}
+): Promise<{ success: boolean; message: string }> {
+  const { size, color, quantity = 1 } = options;
+  const p = await getPage();
+
+  const fullUrl = productUrl.startsWith("http") ? productUrl : `https://www2.hm.com${productUrl}`;
+  await p.goto(fullUrl, { waitUntil: "domcontentloaded", timeout: 30000 });
+  await dismissPopups(p);
+  await p.waitForTimeout(1500);
+
+  // Select color if provided
+  if (color) {
+    try {
+      const colorBtn = p.locator(`[title="${color}"], [aria-label*="${color}"]`).first();
+      if (await colorBtn.isVisible({ timeout: 2000 })) {
+        await colorBtn.click();
+        await p.waitForTimeout(500);
+      }
+    } catch {
+      // color selection optional
+    }
+  }
+
+  // Select size if provided
+  if (size) {
+    try {
+      const sizeBtn = p.locator(`[data-size="${size}"], button:has-text("${size}")`).first();
+      if (await sizeBtn.isVisible({ timeout: 2000 })) {
+        await sizeBtn.click();
+        await p.waitForTimeout(500);
+      }
+    } catch {
+      // try alternative size selector
+      try {
+        await p.selectOption("select[name*='size'], select[id*='size']", size);
+        await p.waitForTimeout(500);
+      } catch {
+        // no size selector found
+      }
+    }
+  }
+
+  // Click Add to Cart
+  try {
+    const addBtn = p.locator(
+      "button[data-testid='add-to-bag'], button:has-text('Add to Bag'), button:has-text('Add to Cart'), [class*='add-to-cart']"
+    ).first();
+    await addBtn.waitFor({ state: "visible", timeout: 5000 });
+    await addBtn.click();
+    await p.waitForTimeout(1500);
+
+    // Handle quantity
+    if (quantity > 1) {
+      for (let i = 1; i < quantity; i++) {
+        await addBtn.click().catch(() => {});
+        await p.waitForTimeout(500);
+      }
+    }
+
+    // Check for success indicator
+    const successMsg = await p.locator("[class*='added-to-bag'], [class*='success'], [data-testid='mini-cart-count']").first().isVisible({ timeout: 3000 }).catch(() => false);
+    return { success: true, message: successMsg ? "Item added to bag successfully" : "Add to bag clicked - check your cart" };
+  } catch (e) {
+    return { success: false, message: `Could not add to cart: ${e instanceof Error ? e.message : String(e)}` };
+  }
+}
+
+export async function viewCart(): Promise<CartSummary> {
+  const p = await getPage();
+  await p.goto(HM_CART, { waitUntil: "domcontentloaded", timeout: 30000 });
+  await dismissPopups(p);
+  await p.waitForTimeout(2000);
+
+  return await p.evaluate(() => {
+    const items: {
+      name: string;
+      price: string;
+      color?: string;
+      size?: string;
+      quantity: number;
+      imageUrl?: string;
+    }[] = [];
+
+    const cartItems = document.querySelectorAll(
+      "[class*='cart-item'], [class*='bag-item'], [data-testid*='cart-item']"
+    );
+
+    cartItems.forEach((item) => {
+      const name = item.querySelector("[class*='product-name'], [class*='item-name'], h3")?.textContent?.trim() || "";
+      const price = item.querySelector("[class*='price']")?.textContent?.trim() || "";
+      const color = item.querySelector("[class*='color'], [class*='variant']")?.textContent?.trim();
+      const size = item.querySelector("[class*='size']")?.textContent?.trim();
+      const qtyEl = item.querySelector("[class*='quantity'], input[type='number']") as HTMLInputElement | null;
+      const quantity = qtyEl ? parseInt(qtyEl.value || qtyEl.textContent || "1") || 1 : 1;
+      const imgEl = item.querySelector("img");
+      const imageUrl = imgEl?.src || undefined;
+
+      if (name) items.push({ name, price, color, size, quantity, imageUrl });
+    });
+
+    const subtotalEl = document.querySelector("[class*='subtotal'], [class*='order-total']:not([class*='grand'])");
+    const totalEl = document.querySelector("[class*='grand-total'], [class*='total-price'], [data-testid='total']");
+    const shippingEl = document.querySelector("[class*='shipping'], [class*='delivery-cost']");
+
+    return {
+      items,
+      subtotal: subtotalEl?.textContent?.trim() || "",
+      total: totalEl?.textContent?.trim() || "",
+      itemCount: items.length,
+      estimatedShipping: shippingEl?.textContent?.trim(),
+    };
+  });
+}
+
+export async function initiateCheckout(): Promise<{ url: string; message: string }> {
+  const p = await getPage();
+  await p.goto(HM_CART, { waitUntil: "domcontentloaded", timeout: 30000 });
+  await dismissPopups(p);
+  await p.waitForTimeout(1500);
+
+  try {
+    const checkoutBtn = p.locator(
+      "button:has-text('Checkout'), a:has-text('Checkout'), [data-testid*='checkout'], [class*='checkout-button']"
+    ).first();
+    await checkoutBtn.waitFor({ state: "visible", timeout: 5000 });
+    await checkoutBtn.click();
+    await p.waitForTimeout(2000);
+
+    return {
+      url: p.url(),
+      message: "Checkout initiated. Complete your order in the browser or provide payment/address details.",
+    };
+  } catch {
+    return {
+      url: HM_CART,
+      message: "Please visit your cart to proceed to checkout: " + HM_CART,
+    };
+  }
+}
+
+export async function findStores(
+  location: string,
+  options: { productId?: string; radius?: number } = {}
+): Promise<StoreResult[]> {
+  const p = await getPage();
+  await p.goto(HM_STORES, { waitUntil: "domcontentloaded", timeout: 30000 });
+  await dismissPopups(p);
+  await p.waitForTimeout(1500);
+
+  // Enter location
+  try {
+    const searchInput = p.locator("input[type='search'], input[name*='location'], input[placeholder*='location'], input[placeholder*='city'], input[placeholder*='zip']").first();
+    await searchInput.waitFor({ state: "visible", timeout: 5000 });
+    await searchInput.fill(location);
+    await p.keyboard.press("Enter");
+    await p.waitForTimeout(3000);
+  } catch {
+    // might auto-detect location
+  }
+
+  return await p.evaluate(() => {
+    const stores: {
+      name: string;
+      address: string;
+      city: string;
+      distance?: string;
+      phone?: string;
+      hours?: string;
+    }[] = [];
+
+    const storeCards = document.querySelectorAll("[class*='store-item'], [class*='store-result'], [data-testid*='store']");
+
+    storeCards.forEach((card) => {
+      const name = card.querySelector("[class*='store-name'], h3, h4")?.textContent?.trim() || "";
+      const address = card.querySelector("[class*='address'], address")?.textContent?.trim() || "";
+      const city = card.querySelector("[class*='city']")?.textContent?.trim() || "";
+      const distance = card.querySelector("[class*='distance']")?.textContent?.trim();
+      const phone = card.querySelector("a[href^='tel:']")?.textContent?.trim() || card.querySelector("[class*='phone']")?.textContent?.trim();
+      const hours = card.querySelector("[class*='hours'], [class*='opening']")?.textContent?.trim();
+
+      if (name || address) {
+        stores.push({ name, address, city, distance, phone, hours });
+      }
+    });
+
+    return stores;
+  });
+}
+
+export async function getMemberRewards(): Promise<MemberInfo> {
+  const p = await getPage();
+  await p.goto(HM_MEMBER, { waitUntil: "domcontentloaded", timeout: 30000 });
+  await dismissPopups(p);
+  await p.waitForTimeout(1500);
+
+  return await p.evaluate(() => {
+    const name = document.querySelector("[class*='member-name'], [class*='greeting'] strong")?.textContent?.trim();
+    const email = document.querySelector("[class*='member-email']")?.textContent?.trim();
+    const points = document.querySelector("[class*='points'], [data-testid*='points']")?.textContent?.trim();
+    const tier = document.querySelector("[class*='tier'], [class*='level'], [class*='status']")?.textContent?.trim();
+
+    const rewards: string[] = [];
+    document.querySelectorAll("[class*='reward-item'], [class*='voucher']").forEach((r) => {
+      const text = r.textContent?.trim();
+      if (text) rewards.push(text);
+    });
+
+    const nextReward = document.querySelector("[class*='next-reward'], [class*='progress-label']")?.textContent?.trim();
+
+    return { name, email, points, tier, rewards, nextReward };
+  });
+}
+
+export async function trackOrder(orderId?: string): Promise<OrderInfo[]> {
+  const p = await getPage();
+  await p.goto(HM_ORDERS, { waitUntil: "domcontentloaded", timeout: 30000 });
+  await dismissPopups(p);
+  await p.waitForTimeout(1500);
+
+  const orders = await p.evaluate(() => {
+    const results: {
+      orderId: string;
+      date: string;
+      status: string;
+      total: string;
+      items?: string[];
+      estimatedDelivery?: string;
+      trackingNumber?: string;
+    }[] = [];
+
+    const orderCards = document.querySelectorAll("[class*='order-item'], [class*='order-row'], [data-testid*='order']");
+
+    orderCards.forEach((card) => {
+      const orderId = card.querySelector("[class*='order-number'], [class*='order-id']")?.textContent?.trim() ||
+        card.getAttribute("data-orderid") || "";
+      const date = card.querySelector("[class*='order-date'], time")?.textContent?.trim() || "";
+      const status = card.querySelector("[class*='status'], [class*='delivery-status']")?.textContent?.trim() || "";
+      const total = card.querySelector("[class*='total'], [class*='price']")?.textContent?.trim() || "";
+      const tracking = card.querySelector("[class*='tracking']")?.textContent?.trim();
+      const eta = card.querySelector("[class*='estimated'], [class*='delivery-date']")?.textContent?.trim();
+
+      const items: string[] = [];
+      card.querySelectorAll("[class*='item-name'], [class*='product-name']").forEach((item) => {
+        const text = item.textContent?.trim();
+        if (text) items.push(text);
+      });
+
+      if (orderId || status) {
+        results.push({ orderId, date, status, total, items, estimatedDelivery: eta, trackingNumber: tracking });
+      }
+    });
+
+    return results;
+  });
+
+  if (orderId) {
+    return orders.filter((o) => o.orderId.includes(orderId));
+  }
+  return orders;
+}
+
+export async function getWishlist(): Promise<WishlistItem[]> {
+  const p = await getPage();
+  await p.goto(HM_WISHLIST, { waitUntil: "domcontentloaded", timeout: 30000 });
+  await dismissPopups(p);
+  await p.waitForTimeout(1500);
+
+  return await p.evaluate(() => {
+    const items: {
+      name: string;
+      price: string;
+      color?: string;
+      imageUrl?: string;
+      productUrl?: string;
+      inStock: boolean;
+    }[] = [];
+
+    document.querySelectorAll(
+      "[class*='wishlist-item'], [class*='favorite-item'], article[class*='product']"
+    ).forEach((item) => {
+      const name = item.querySelector("[class*='product-name'], [class*='item-heading'], h3")?.textContent?.trim() || "";
+      const price = item.querySelector("[class*='price']")?.textContent?.trim() || "";
+      const color = item.querySelector("[class*='color']")?.textContent?.trim();
+      const imgEl = item.querySelector("img");
+      const imageUrl = imgEl?.src || undefined;
+      const linkEl = item.querySelector("a[href]");
+      const productUrl = linkEl ? "https://www2.hm.com" + linkEl.getAttribute("href") : undefined;
+      const outOfStock = item.querySelector("[class*='out-of-stock'], [class*='sold-out']") !== null;
+
+      if (name) {
+        items.push({ name, price, color, imageUrl, productUrl, inStock: !outOfStock });
+      }
+    });
+
+    return items;
+  });
+}
+
+export async function addToWishlist(productUrl: string): Promise<{ success: boolean; message: string }> {
+  const p = await getPage();
+  const fullUrl = productUrl.startsWith("http") ? productUrl : `https://www2.hm.com${productUrl}`;
+  await p.goto(fullUrl, { waitUntil: "domcontentloaded", timeout: 30000 });
+  await dismissPopups(p);
+  await p.waitForTimeout(1000);
+
+  try {
+    const wishlistBtn = p.locator(
+      "button[aria-label*='wishlist'], button[aria-label*='favorite'], [data-testid*='wishlist'], [class*='favorite-btn']"
+    ).first();
+    await wishlistBtn.waitFor({ state: "visible", timeout: 5000 });
+    await wishlistBtn.click();
+    await p.waitForTimeout(1000);
+    return { success: true, message: "Added to wishlist" };
+  } catch (e) {
+    return { success: false, message: `Could not add to wishlist: ${e instanceof Error ? e.message : String(e)}` };
+  }
+}
+
+export async function browseSale(
+  options: { category?: string; maxResults?: number; sortBy?: string } = {}
+): Promise<ProductResult[]> {
+  const { category, maxResults = 20, sortBy } = options;
+  const p = await getPage();
+
+  let url = category ? `${HM_SALE}/${encodeURIComponent(category.toLowerCase())}` : HM_SALE;
+  if (sortBy) url += `?sort=${encodeURIComponent(sortBy)}`;
+
+  await p.goto(url, { waitUntil: "domcontentloaded", timeout: 30000 });
+  await dismissPopups(p);
+  await p.waitForTimeout(2000);
+
+  return await p.evaluate((max: number) => {
+    const items: {
+      name: string;
+      price: string;
+      originalPrice?: string;
+      discount?: string;
+      color?: string;
+      imageUrl?: string;
+      productUrl?: string;
+      productId?: string;
+      isOnSale: boolean;
+    }[] = [];
+
+    const cards = document.querySelectorAll(
+      "article.product-item, [class*='product-item'], li[class*='product'], [data-productid]"
+    );
+
+    cards.forEach((card, idx) => {
+      if (idx >= max) return;
+      const nameEl = card.querySelector("h2, h3, [class*='item-heading'], [class*='product-name']");
+      const name = nameEl?.textContent?.trim() || "";
+      if (!name) return;
+
+      const priceEl = card.querySelector("[class*='price-value'], [class*='sale-price'], [class*='current-price']");
+      const originalPriceEl = card.querySelector("[class*='original-price'], [class*='was-price'], [class*='regular-price']");
+      const price = priceEl?.textContent?.trim() || "";
+      const originalPrice = originalPriceEl?.textContent?.trim();
+
+      // Extract discount percentage
+      const discountEl = card.querySelector("[class*='discount'], [class*='percent-off'], [class*='saving']");
+      const discount = discountEl?.textContent?.trim();
+
+      const imgEl = card.querySelector("img");
+      const imageUrl = imgEl?.src || imgEl?.getAttribute("data-src") || "";
+
+      const linkEl = card.querySelector("a[href]");
+      const productUrl = linkEl ? "https://www2.hm.com" + (linkEl.getAttribute("href") || "") : "";
+      const productId = card.getAttribute("data-productid") || card.getAttribute("data-article-code") || "";
+
+      items.push({ name, price, originalPrice, discount, isOnSale: true, imageUrl, productUrl, productId });
+    });
+
+    return items;
+  }, maxResults);
+}
+
+export async function closeBrowser(): Promise<void> {
+  if (context) {
+    await saveCookies(context);
+  }
+  if (page && !page.isClosed()) {
+    await page.close().catch(() => {});
+  }
+  if (context) {
+    await context.close().catch(() => {});
+    context = null;
+  }
+  if (browser) {
+    await browser.close().catch(() => {});
+    browser = null;
+  }
+  page = null;
+}
+
+// Graceful shutdown
+process.on("exit", () => {
+  if (context) {
+    saveCookies(context).catch(() => {});
+  }
+});
+process.on("SIGINT", async () => {
+  await closeBrowser();
+  process.exit(0);
+});
+process.on("SIGTERM", async () => {
+  await closeBrowser();
+  process.exit(0);
+});