Release v0.2.0

- bump extension version to 0.2.0
- add changelog / release notes for v0.2.0
- treat empty Free to Keep results as a successful check without warnings
- update badge behavior: hide badge when there are no active promotions
- update popup empty/status text for no new free promotions

Author: Grim1313

CHANGELOG.md

@@ -0,0 +1,11 @@
+# Changelog
+
+## 0.2.0
+
+### What's new
+
+- Empty `Free to Keep` results are now treated as a normal successful check instead of a source warning.
+- The popup now clearly shows `No new free promotions found` when the check succeeds but there are no active giveaways.
+- The popup list now keeps only active promotions visible, which removes stale non-active entries from the main view.
+- The toolbar badge is now hidden when there are no active `Free to Keep` promotions.
+- When active promotions exist, the badge still shows the active count: red for unread items, green when everything is already seen.

README.md

@@ -5,6 +5,8 @@ Steam Promo Watch is a lightweight Chrome / Edge extension that watches Steam fo
 > Early alpha: the extension is still in active development.
 > Behavior may change, some features may be incomplete, and bugs are still expected.
 
+Release notes are tracked in [CHANGELOG.md](CHANGELOG.md).
+
 ## What it is
 
 Steam Promo Watch helps you catch Steam games that become free to keep for a limited time.

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.1.0",
+  "version": "0.2.0",
   "minimum_chrome_version": "120",
   "permissions": [
     "alarms",

src/lib/badge.js

@@ -15,6 +15,10 @@ export async function updateBadge(runtimeState, settings) {
 
   const unreadCount = Number(runtimeState?.unreadCount) || 0;
   const activeFreeToKeepCount = Number(runtimeState?.activeFreeToKeepCount) || 0;
+  if (activeFreeToKeepCount <= 0) {
+    await chrome.action.setBadgeText({ text: "" });
+    return;
+  }
 
   await chrome.action.setBadgeBackgroundColor({
     color: unreadCount > 0 ? BADGE_COLORS.unread : BADGE_COLORS.read

src/lib/providers/fallbackProvider.js

@@ -27,7 +27,7 @@ export const fallbackProvider = {
 
     return {
       promotions,
-      warnings: promotions.length === 0 ? ["Featured categories did not contain free giveaways."] : [],
+      warnings: [],
       success: true
     };
   }

src/lib/providers/index.js

@@ -9,6 +9,8 @@ export async function fetchPromotionsFromProviders(settings) {
   let hadSuccess = false;
 
   if (settings.trackFreeToKeep) {
+    let primaryFailedMessage = "";
+
     try {
       const primary = await steamStoreSearchProvider.fetchPromotions();
       providerIds.push(steamStoreSearchProvider.id);
@@ -24,14 +26,17 @@ export async function fetchPromotionsFromProviders(settings) {
         hadSuccess = hadSuccess || fallback.success;
       }
     } catch (error) {
-      warnings.push(`Free to Keep provider failed: ${error instanceof Error ? error.message : String(error)}`);
+      primaryFailedMessage = `Free to Keep provider failed: ${error instanceof Error ? error.message : String(error)}`;
       try {
         const fallback = await fallbackProvider.fetchPromotions();
         providerIds.push(fallbackProvider.id);
         warnings.push(...(fallback.warnings || []));
         promotions.push(...(fallback.promotions || []));
         hadSuccess = hadSuccess || fallback.success;
       } catch (fallbackError) {
+        if (primaryFailedMessage) {
+          warnings.push(primaryFailedMessage);
+        }
         warnings.push(`Fallback provider failed: ${fallbackError instanceof Error ? fallbackError.message : String(fallbackError)}`);
       }
     }

src/lib/providers/steamStoreSearchProvider.js

@@ -69,7 +69,7 @@ export const steamStoreSearchProvider = {
 
     return {
       promotions,
-      warnings: promotions.length === 0 ? ["Steam search returned no free special rows."] : [],
+      warnings: [],
       success: true
     };
   }

src/ui/popup-state.js

@@ -0,0 +1,20 @@
+export function getVisiblePromotions(entries, maxItems = 10) {
+  return (Array.isArray(entries) ? entries : [])
+    .filter((entry) => entry?.status === "active")
+    .slice(0, maxItems);
+}
+
+export function getPopupStatusText(runtimeState = {}) {
+  if (runtimeState.checkInProgress) {
+    return "Checking now...";
+  }
+  if (runtimeState.lastCheckOutcome === "error") {
+    return "Source error";
+  }
+  if (runtimeState.lastCheckOutcome === "success") {
+    return runtimeState.lastResultCount > 0
+      ? `${runtimeState.lastResultCount} promotion(s) tracked`
+      : "No new free promotions found";
+  }
+  return "Idle";
+}

src/ui/popup.html

@@ -38,7 +38,7 @@ <h1>Free to Keep</h1>
           <h2 id="promotions-heading">Latest promotions</h2>
           <span id="unread-pill" class="pill hidden"></span>
         </div>
-        <div id="empty-state" class="empty-state hidden">No promotions found yet.</div>
+        <div id="empty-state" class="empty-state hidden">No new free promotions found.</div>
         <ul id="promotion-list" class="promotion-list"></ul>
       </section>
 

src/ui/popup.js

@@ -1,5 +1,6 @@
 import { getContentTypeLabel, getPromotionTypeLabel } from "../lib/filters.js";
 import { formatDateTime, formatRelativeTime, getPromotionImageUrl } from "../lib/utils.js";
+import { getPopupStatusText, getVisiblePromotions } from "./popup-state.js";
 
 const checkNowButton = document.querySelector("#check-now");
 const statusText = document.querySelector("#status-text");
@@ -26,7 +27,7 @@ function renderWarning(text) {
 }
 
 function renderPromotions(entries) {
-  const visibleEntries = entries.slice(0, 10);
+  const visibleEntries = getVisiblePromotions(entries);
 
   promotionList.textContent = "";
   emptyState.classList.toggle("hidden", visibleEntries.length > 0);
@@ -113,16 +114,7 @@ function renderPromotions(entries) {
 }
 
 function renderStatus(runtimeState) {
-  if (runtimeState.checkInProgress) {
-    statusText.textContent = "Checking now...";
-  } else if (runtimeState.lastCheckOutcome === "error") {
-    statusText.textContent = "Source error";
-  } else if (runtimeState.lastCheckOutcome === "success") {
-    statusText.textContent = runtimeState.lastResultCount > 0 ? `${runtimeState.lastResultCount} promotion(s) tracked` : "No active promotions";
-  } else {
-    statusText.textContent = "Idle";
-  }
-
+  statusText.textContent = getPopupStatusText(runtimeState);
   lastSuccess.textContent = formatDateTime(runtimeState.lastSuccessAt);
   nextCheck.textContent = runtimeState.nextCheckAt ? `${formatDateTime(runtimeState.nextCheckAt)} (${formatRelativeTime(runtimeState.nextCheckAt)})` : "Not scheduled";
   checkNowButton.disabled = runtimeState.checkInProgress;