iBUYPOWER

bowmark.providers.ibuypower.listSystems(): Promise<IbuypowerSystem[]>
bowmark.providers.ibuypower.listPrebuilts(): Promise<IbuypowerPrebuilt[]>
bowmark.providers.ibuypower.listLaptops(): Promise<IbuypowerLaptop[]>
bowmark.providers.ibuypower.getSystem(slug: string): Promise<IbuypowerCatalog>
bowmark.providers.ibuypower.getBenchmark(cpuBench: string, gpuBench: string): Promise<IbuypowerBenchmark | null>
bowmark.providers.ibuypower.recommendGamingPc(args: IbuypowerRecommendArgs): Promise<{ recommendations: IbuypowerRecommendation[]; warnings: string[] }>

// iBUYPOWER's OWN shapes — not a capability contract.

interface IbuypowerSystem {
  slug: string;                    // e.g. "amd-gaming-pc-configurator-1" — the key every other fn takes
  name: string;
  url: string;
  startingPrice: string | null;    // "$1,509.00"
  startingPriceValue: number | null;
  baselineSpecs: string[];         // stock CPU / GPU / memory / storage, as the site labels them
}

interface IbuypowerOption {
  sku: string;
  label: string;
  subLabel: string | null;
  delta: string;                   // "+$314" / "-$125" / "$0"
  priceDifference: number;         // signed, versus the category default
  isDefault: boolean;
  benchName: string | null;        // the 3DMark name getBenchmark takes; CPU/GPU options only
}

interface IbuypowerCategory { name: string; currentSelection: string | null; options: IbuypowerOption[] }

interface IbuypowerCatalog {
  base: IbuypowerSystem;
  totalPrice: string | null;
  categories: IbuypowerCategory[];
  defaultCpuBench: string | null;  // the stock CPU/GPU, so FPS is reachable with no selection
  defaultGpuBench: string | null;
}

interface IbuypowerTimeSpy { overall: number; gpu: number; cpu: number }

interface IbuypowerPrebuilt {
  slug: string;                    // e.g. "rdy-element-9-pro-r08"
  name: string;
  url: string;
  price: string | null;            // "$2,299.00"
  priceValue: number | null;
  listPrice: string | null;        // the struck-through was-price
  listPriceValue: number | null;
  specSummary: string | null;      // the site's own one-line build summary
  cpuBrand: string | null;         // "AMD" | "Intel"
  inStock: boolean;                // sold-out models ARE returned, flagged false
  stockCount: number;
  discontinued: boolean;           // no longer restocked; buyable while stock lasts
  badge: string | null;            // e.g. "Special Promotion"
  imageUrl: string | null;
  timeSpy: IbuypowerTimeSpy | null;
}

interface IbuypowerLaptopSpecs {
  display: string | null;          // '18" QHD+ 2560x1600 240Hz' — the headline laptop spec
  processor: string | null;
  videoCard: string | null;
  memory: string | null;
  storage: string | null;
  operatingSystem: string | null;
}

interface IbuypowerLaptop {
  slug: string;                    // e.g. "chimera-np9581t-gaming-laptop"
  name: string;
  url: string;
  price: string | null;            // "$3,949.00"
  priceValue: number | null;
  listPrice: string | null;        // the struck-through was-price
  listPriceValue: number | null;
  specs: IbuypowerLaptopSpecs;     // the REAL config, per model
  inStock: boolean;                // sold-out models ARE returned, flagged false
  stockCount: number;
  discontinued: boolean;
  badge: string | null;
  imageUrl: string | null;
  timeSpy: IbuypowerTimeSpy | null;
}

interface IbuypowerGameFps { fullHd: string; quadHd: string; medium4k: string; ultra4k: string }

interface IbuypowerBenchmark {
  timeSpyOverall: number;
  timeSpyGpu: number;
  timeSpyCpu: number;
  games: Record<string, IbuypowerGameFps>;   // keyed by the titles iBUYPOWER benchmarks
}

interface IbuypowerRecommendation {
  source: "prebuilt" | "configurator";
  slug: string;
  name: string;
  url: string;
  price: string | null;
  priceValue: number | null;
  timeSpyOverall: number | null;   // null when the site has not benchmarked this pair
  scorePerDollar: number | null;   // timeSpyOverall / priceValue — highest first
  inStock: boolean;                // a configurator is always buildable to order
}

interface IbuypowerRecommendArgs {
  budget_max: number;              // the hard ceiling; nothing over it is returned
  use_case?: string;                // accepted, does not change the ranking — see recommendGamingPc's summary
}

// What can I actually buy under $2,000, and what does it run Fortnite at?
const systems = await bowmark.providers.ibuypower.listSystems();
const rows = [];
for (const s of systems.filter((x) => (x.startingPriceValue ?? Infinity) <= 2000)) {
  const cat = await bowmark.providers.ibuypower.getSystem(s.slug);
  if (!cat.defaultCpuBench || !cat.defaultGpuBench) continue;
  const bench = await bowmark.providers.ibuypower.getBenchmark(cat.defaultCpuBench, cat.defaultGpuBench);
  rows.push({ name: s.name, price: s.startingPrice, fortnite1440p: bench?.games.Fortnite?.quadHd ?? null });
}
return rows;

// What can I buy TODAY and have it ship as built — best Time Spy per dollar?
const rdy = await bowmark.providers.ibuypower.listPrebuilts();
return rdy
  .filter((p) => p.inStock && (p.priceValue ?? Infinity) <= 2500)
  .map((p) => ({
    name: p.name,
    price: p.price,
    saving: (p.listPriceValue ?? 0) - (p.priceValue ?? 0),
    units: p.stockCount,
    scorePerDollar: Math.round(((p.timeSpy?.overall ?? 0) / (p.priceValue || 1)) * 100) / 100,
  }))
  .sort((a, b) => b.scorePerDollar - a.scorePerDollar);