Prepare 0.3.2 release with search and popup sorting fixes

Author: Grim1313

CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 0.3.2
+
+### What's new
+
+- Improved Steam promotion discovery so current free-to-keep offers are found more reliably.
+- The popup now prioritizes full games before other content types, making the main list easier to scan.
+
 ## 0.3.1
 
 ### What's new

manifest.json

@@ -2,7 +2,7 @@
   "manifest_version": 3,
   "name": "Steam Promo Watch",
   "description": "Tracks new Steam free-to-keep promotions and notifies you about new giveaways.",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "minimum_chrome_version": "120",
   "permissions": [
     "alarms",

src/lib/providers/enrichmentProvider.js

@@ -37,6 +37,8 @@ export function sanitizeMetadataCache(raw = {}) {
       screenshotFull: sanitizeSteamAssetUrl(value.screenshotFull),
       priceInitial: safeNumber(value.priceInitial, 0),
       priceFinal: safeNumber(value.priceFinal, 0),
+      priceDiscountPercent: safeNumber(value.priceDiscountPercent, 0),
+      priceFinalFormatted: typeof value.priceFinalFormatted === "string" ? value.priceFinalFormatted : "",
       ...sanitizeSteamReviewSummary(value),
       reviewUpdatedAt: safeNumber(value.reviewUpdatedAt, 0),
       updatedAt: safeNumber(value.updatedAt, 0)
@@ -116,6 +118,10 @@ async function fetchMissingMetadata(cache, appIds) {
         screenshotFull: data ? sanitizeSteamAssetUrl(data.screenshots?.[0]?.path_full) : (existing.screenshotFull || ""),
         priceInitial: data ? safeNumber(data.price_overview?.initial, 0) : safeNumber(existing.priceInitial, 0),
         priceFinal: data ? safeNumber(data.price_overview?.final, 0) : safeNumber(existing.priceFinal, 0),
+        priceDiscountPercent: data ? safeNumber(data.price_overview?.discount_percent, 0) : safeNumber(existing.priceDiscountPercent, 0),
+        priceFinalFormatted: data && typeof data.price_overview?.final_formatted === "string"
+          ? data.price_overview.final_formatted
+          : (existing.priceFinalFormatted || ""),
         reviewScore: reviewSummary.reviewScore || safeNumber(existing.reviewScore, 0),
         reviewScoreDesc: reviewSummary.reviewScoreDesc || existing.reviewScoreDesc || "",
         reviewPositive: reviewSummary.reviewPositive || safeNumber(existing.reviewPositive, 0),
@@ -175,8 +181,11 @@ export async function enrichPromotions(promotions, existingCache) {
     const metadata = metadataCache[promotion.stableId];
     const priceInitial = safeNumber(metadata?.priceInitial, -1);
     const priceFinal = safeNumber(metadata?.priceFinal, -1);
-    // Steam appdetails may report final_formatted="Free" while keeping a non-zero numeric final price.
-    const metadataConfirmedFreeToKeep = priceInitial < 0 ? true : (priceInitial > 0 && priceFinal === 0);
+    const priceDiscountPercent = safeNumber(metadata?.priceDiscountPercent, 0);
+    const priceFinalFormatted = String(metadata?.priceFinalFormatted || "");
+    const metadataConfirmedFreeToKeep = priceInitial < 0
+      ? true
+      : (priceInitial > 0 && (priceFinal === 0 || priceDiscountPercent >= 100 || /\bfree\b/i.test(priceFinalFormatted)));
 
     return {
       ...promotion,

src/lib/providers/steamStoreSearchProvider.js

@@ -2,6 +2,12 @@ import { PROMO_TYPES, SOURCE_IDS } from "../constants.js";
 import { buildSteamUrlFromStableId, createHash, decodeHtmlEntities, fetchJsonWithTimeout, normalizeWhitespace, stripHtml } from "../utils.js";
 
 const SEARCH_RESULTS_URL = "https://store.steampowered.com/search/results/?query&start=0&count=100&dynamic_data=&sort_by=_ASC&specials=1&maxprice=free&supportedlang=english&ndl=1&infinite=1";
+const FREE_PRICE_SEARCH_PAGE_SIZE = 100;
+const FREE_PRICE_SEARCH_PAGE_COUNT = 4;
+
+function buildFreePriceSearchUrl(start) {
+  return `https://store.steampowered.com/search/results/?query&start=${start}&count=${FREE_PRICE_SEARCH_PAGE_SIZE}&dynamic_data=&sort_by=Price_ASC&maxprice=free&category1=998&supportedlang=english&ndl=1&infinite=1`;
+}
 
 function isDiscountedToZero(priceText, row) {
   const finalPriceMatch = /data-price-final="(\d+)"/i.exec(row);
@@ -17,7 +23,9 @@ function isDiscountedToZero(priceText, row) {
   return hasZeroFinalPrice && (hasDiscountedOriginalPrice || hasFullDiscount);
 }
 
-export function parseSearchRows(html) {
+export function parseSearchRows(html, options = {}) {
+  const allowFreeLabel = options.allowFreeLabel !== false;
+  const rawTypeLabel = options.rawTypeLabel || "Store special";
   const rows = String(html || "").match(/<a\b[\s\S]*?class="[^"]*search_result_row[^"]*"[\s\S]*?<\/a>/gi) || [];
   const promotions = [];
 
@@ -29,8 +37,9 @@ export function parseSearchRows(html) {
     const title = titleMatch ? normalizeWhitespace(decodeHtmlEntities(stripHtml(titleMatch[1]))) : "";
     const priceText = normalizeWhitespace(stripHtml(priceMatch ? priceMatch[1] : ""));
     const isFreeLabel = /\bfree\b/i.test(priceText);
+    const discountedToZero = isDiscountedToZero(priceText, row);
 
-    if (!href || !title || (!isFreeLabel && !isDiscountedToZero(priceText, row))) {
+    if (!href || !title || (!discountedToZero && (!allowFreeLabel || !isFreeLabel))) {
       continue;
     }
 
@@ -51,7 +60,7 @@ export function parseSearchRows(html) {
       title,
       url: href || buildSteamUrlFromStableId(stableId),
       promoType: PROMO_TYPES.FREE_TO_KEEP,
-      rawTypeLabel: "Store special",
+      rawTypeLabel,
       sourceId: SOURCE_IDS.STORE_SEARCH,
       sourceFingerprint: createHash(row),
       rowText
@@ -64,8 +73,19 @@ export function parseSearchRows(html) {
 export const steamStoreSearchProvider = {
   id: SOURCE_IDS.STORE_SEARCH,
   async fetchPromotions() {
-    const response = await fetchJsonWithTimeout(SEARCH_RESULTS_URL);
-    const promotions = parseSearchRows(response?.results_html || "");
+    const [specialsResponse, ...freePriceResponses] = await Promise.all([
+      fetchJsonWithTimeout(SEARCH_RESULTS_URL),
+      ...Array.from({ length: FREE_PRICE_SEARCH_PAGE_COUNT }, (_, index) => {
+        return fetchJsonWithTimeout(buildFreePriceSearchUrl(index * FREE_PRICE_SEARCH_PAGE_SIZE)).catch(() => null);
+      })
+    ]);
+    const promotions = [
+      ...parseSearchRows(specialsResponse?.results_html || ""),
+      ...freePriceResponses.flatMap((response) => parseSearchRows(response?.results_html || "", {
+        allowFreeLabel: false,
+        rawTypeLabel: "Store free price"
+      }))
+    ];
 
     return {
       promotions,

src/ui/popup-state.js

@@ -1,6 +1,13 @@
+import { CONTENT_TYPES } from "../lib/constants.js";
+
+function getPopupContentPriority(entry) {
+  return entry?.contentType === CONTENT_TYPES.GAME ? 0 : 1;
+}
+
 export function getVisiblePromotions(entries, maxItems = 10) {
   return (Array.isArray(entries) ? entries : [])
     .filter((entry) => entry?.status === "active")
+    .sort((left, right) => getPopupContentPriority(left) - getPopupContentPriority(right))
     .slice(0, maxItems);
 }
 

tests/enrichmentProvider.test.js

@@ -176,3 +176,77 @@ test("enrichPromotions backfills reviews for fresh cached metadata created befor
   assert.equal(result.promotions[0].reviewPercent, 86);
   assert.ok(result.metadataCache["app:599140"].reviewUpdatedAt > 0);
 });
+
+test("enrichPromotions confirms 100 percent appdetails discounts with non-zero numeric final price", async (t) => {
+  const originalFetch = globalThis.fetch;
+
+  globalThis.fetch = async (url) => {
+    if (url.includes("/api/appdetails?")) {
+      return {
+        ok: true,
+        async json() {
+          return {
+            3550490: {
+              success: true,
+              data: {
+                name: "Overcome Your Fears - Caretaker",
+                type: "game",
+                genres: [{ description: "Adventure" }],
+                categories: [{ description: "Single-player" }],
+                header_image: "https://shared.akamai.steamstatic.com/store_item_assets/steam/apps/3550490/header.jpg",
+                capsule_image: "https://shared.akamai.steamstatic.com/store_item_assets/steam/apps/3550490/capsule.jpg",
+                screenshots: [],
+                price_overview: {
+                  initial: 599,
+                  final: 599,
+                  discount_percent: 100,
+                  final_formatted: "Free"
+                }
+              }
+            }
+          };
+        }
+      };
+    }
+
+    if (url.includes("/appreviews/3550490?")) {
+      return {
+        ok: true,
+        async json() {
+          return {
+            success: 1,
+            query_summary: {
+              review_score: 6,
+              review_score_desc: "Mostly Positive",
+              total_positive: 108,
+              total_negative: 32,
+              total_reviews: 140
+            }
+          };
+        }
+      };
+    }
+
+    throw new Error(`Unexpected URL: ${url}`);
+  };
+
+  t.after(() => {
+    globalThis.fetch = originalFetch;
+  });
+
+  const result = await enrichPromotions([
+    {
+      id: "app:3550490|free-to-keep|metadata-only",
+      stableId: "app:3550490",
+      appId: 3550490,
+      title: "",
+      promoType: "free-to-keep",
+      sourceId: "metadata-only"
+    }
+  ], {});
+
+  assert.equal(result.promotions.length, 1);
+  assert.equal(result.promotions[0].isLikelyFreeToKeep, true);
+  assert.equal(result.metadataCache["app:3550490"].priceDiscountPercent, 100);
+  assert.equal(result.metadataCache["app:3550490"].priceFinalFormatted, "Free");
+});

tests/popup-state.test.js

@@ -17,6 +17,21 @@ test("getVisiblePromotions keeps only active entries for the popup", () => {
   );
 });
 
+test("getVisiblePromotions shows games before other content types", () => {
+  const visible = getVisiblePromotions([
+    { id: "dlc-1", status: "active", contentType: "dlc" },
+    { id: "package-1", status: "active", contentType: "package" },
+    { id: "game-1", status: "active", contentType: "game" },
+    { id: "game-2", status: "active", contentType: "game" },
+    { id: "demo-1", status: "active", contentType: "demo" }
+  ], 3);
+
+  assert.deepEqual(
+    visible.map((entry) => entry.id),
+    ["game-1", "game-2", "dlc-1"]
+  );
+});
+
 test("getPopupStatusText reports when no new free promotions were found", () => {
   assert.equal(
     getPopupStatusText({ lastCheckOutcome: "success", lastResultCount: 0 }),

tests/steamStoreSearchProvider.test.js

@@ -80,6 +80,45 @@ const NON_FREE_SPECIALS_HTML = `
   </a>
 `;
 
+const FREE_PRICE_SEARCH_HTML = `
+  <a href="https://store.steampowered.com/app/730/CounterStrike_2/"
+     class="search_result_row ds_collapse_flag">
+    <div class="responsive_search_name_combined">
+      <div class="search_name ellipsis">
+        <span class="title">Counter-Strike 2</span>
+      </div>
+      <div class="search_price_discount_combined responsive_secondrow" data-price-final="0">
+        <div class="search_price">Free To Play</div>
+      </div>
+    </div>
+  </a>
+  <a href="https://store.steampowered.com/app/3550490/Overcome_Your_Fears__Caretaker/?snr=1_7_7_230_150_3"
+     class="search_result_row ds_collapse_flag"
+     data-ds-appid="3550490">
+    <div class="responsive_search_name_combined">
+      <div class="search_name ellipsis">
+        <span class="title">Overcome Your Fears - Caretaker</span>
+      </div>
+      <div class="search_price_discount_combined responsive_secondrow" data-price-final="0">
+        <div class="search_discount_and_price responsive_secondrow">
+          <div class="discount_block search_discount_block"
+               data-price-final="0"
+               data-bundlediscount="0"
+               data-discount="100"
+               role="link"
+               aria-label="100% off. $5.99 normally, discounted to $0.00">
+            <div class="discount_pct">-100%</div>
+            <div class="discount_prices">
+              <div class="discount_original_price">$5.99</div>
+              <div class="discount_final_price">$0.00</div>
+            </div>
+          </div>
+        </div>
+      </div>
+    </div>
+  </a>
+`;
+
 test("parseSearchRows detects active free-to-keep rows discounted to zero", () => {
   const promotions = parseSearchRows(SEARCH_RESULTS_HTML);
 
@@ -96,3 +135,15 @@ test("parseSearchRows ignores specials that are not actually free", () => {
 
   assert.equal(promotions.length, 0);
 });
+
+test("parseSearchRows can scan free-price pages without accepting permanent free-to-play rows", () => {
+  const promotions = parseSearchRows(FREE_PRICE_SEARCH_HTML, {
+    allowFreeLabel: false,
+    rawTypeLabel: "Store free price"
+  });
+
+  assert.equal(promotions.length, 1);
+  assert.equal(promotions[0].appId, 3550490);
+  assert.equal(promotions[0].title, "Overcome Your Fears - Caretaker");
+  assert.equal(promotions[0].rawTypeLabel, "Store free price");
+});