feat: expiry countdown, refresh links, CLI tabs, recently viewed #17

Merged

starkSV merged 3 commits from feat/ux-improvements into main

2026-05-22 21:56:08 +05:30

starkSV commented

2026-05-22 21:55:58 +05:30

(Migrated from github.com)

Summary

Expiry countdown — parses se param from signed URL; shows live countdown where available, falls back to static "24 hours" for consumer links (Microsoft doesn't include se in consumer CDN URLs)
Refresh links — ?force=true on /proxy bypasses cache and fetches fresh from Microsoft; Refresh button appears when link expires in <6h
CLI command tabs — wget / curl / aria2 tabs replace the old aria2-only tip on all pages (consumer + eval); selection persists in localStorage
Recently viewed — localStorage-only row on homepage; tracks both consumer and eval product pages; shows expiry countdown or expired state when link expiry is known
chore — .claude/ added to .gitignore; FileSize removed (Microsoft CDN does not return file size in API response)

Test plan

Consumer product page — fetch links, expiry shows "Links expire in 24 hours", CLI tabs switch and persist on refresh
Eval page — CLI tabs work, recently viewed tracked on homepage
Refresh button — tested with forced 5h expiry, fires force fetch, "Links refreshed!" toast, countdown resets
localStorage persistence — CLI tab selection survives hard refresh
Build passes with no TypeScript errors

Summary by CodeRabbit

New Features
- Added link refresh functionality to bypass cache and fetch fresh download links.
- Added CLI command tools (wget, curl, aria2) with clipboard copy functionality.
- Added link expiry countdown display with auto-refresh button when links expire within 6 hours.
- Added recently viewed products tracking with persistent list on the home page.
- Tool selection preference now persists across sessions.

## Summary - **Expiry countdown** — parses `se` param from signed URL; shows live countdown where available, falls back to static "24 hours" for consumer links (Microsoft doesn't include `se` in consumer CDN URLs) - **Refresh links** — `?force=true` on `/proxy` bypasses cache and fetches fresh from Microsoft; Refresh button appears when link expires in <6h - **CLI command tabs** — wget / curl / aria2 tabs replace the old aria2-only tip on all pages (consumer + eval); selection persists in localStorage - **Recently viewed** — localStorage-only row on homepage; tracks both consumer and eval product pages; shows expiry countdown or expired state when link expiry is known - **chore** — `.claude/` added to `.gitignore`; `FileSize` removed (Microsoft CDN does not return file size in API response) ## Test plan - [x] Consumer product page — fetch links, expiry shows "Links expire in 24 hours", CLI tabs switch and persist on refresh - [x] Eval page — CLI tabs work, recently viewed tracked on homepage - [x] Refresh button — tested with forced 5h expiry, fires force fetch, "Links refreshed!" toast, countdown resets - [x] localStorage persistence — CLI tab selection survives hard refresh - [x] Build passes with no TypeScript errors  ## Summary by CodeRabbit * **New Features** * Added link refresh functionality to bypass cache and fetch fresh download links. * Added CLI command tools (wget, curl, aria2) with clipboard copy functionality. * Added link expiry countdown display with auto-refresh button when links expire within 6 hours. * Added recently viewed products tracking with persistent list on the home page. * Tool selection preference now persists across sessions.  [![Review Change Stack](https://storage.googleapis.com/coderabbit_public_assets/review-stack-in-coderabbit-ui.svg)](https://app.coderabbit.ai/change-stack/starkSV/windows-iso-downloader/pull/17?utm_source=github_walkthrough&utm_medium=github&utm_campaign=change_stack)

coderabbitai[bot] commented

2026-05-22 21:56:19 +05:30

(Migrated from github.com)

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: c9218fed-bcfc-4be0-ba36-7b20b2b52d5a

📥 Commits

Reviewing files that changed from the base of the PR and between e3f34016c6 and b2c9e2d874.

📒 Files selected for processing (9)

.gitignore
CLAUDE.md
PROGRESS.md
backend/main.go
frontend/src/components/CliCommand.tsx
frontend/src/components/RecentlyViewed.tsx
frontend/src/pages/EvalDetailPage.tsx
frontend/src/pages/HomePage.tsx
frontend/src/pages/ProductDetailPage.tsx

📝 Walkthrough

Walkthrough

This PR implements frontend UX improvements for link refresh and product tracking. It adds backend support for cache-bypass refresh requests, introduces a CLI command component for multi-tool download commands with localStorage persistence, adds a recently-viewed product tracker, and integrates these across ProductDetailPage, EvalDetailPage, and HomePage. Documentation is updated to reflect in-progress status.

Changes

Frontend UX Improvements: Link Refresh, CLI Commands, and Recently Viewed Items

Layer / File(s)	Summary
Backend force-refresh cache bypass `backend/main.go`	The `/proxy` endpoint now accepts `force=true` parameter to skip cache reads and negative-cache checks. Singleflight key is namespaced with `link:force:` prefix during forced fetches. Logging distinguishes between forced and normal fetches with expiry time.
CLI command generation component `frontend/src/components/CliCommand.tsx`	New component generates wget/curl/aria2 download commands with tool selection persisted in localStorage. Provides collapsible UI with tabs, copy-to-clipboard action, and transient feedback toast.
Recently Viewed product tracking `frontend/src/components/RecentlyViewed.tsx`	New module provides localStorage-backed recently viewed entries with expiry countdown. Includes `RecentEntry` interface, persistence helpers, `useCountdown` hook, `formatRemaining` utility, and UI components for entry cards and grid display.
ProductDetailPage: expiry tracking and refresh flow `frontend/src/pages/ProductDetailPage.tsx`	Parses `se` query parameter to extract expiry timestamp, manages countdown state with interval timer, replaces static expiry warning with dynamic row showing status and conditional refresh button (under 6 hours). New `handleRefreshLinks` fetches with `force=true`, re-parses expiry, updates recent entry, and shows toasts. Swaps Aria2Tip for CliCommand. Records product as recently viewed on load.
EvalDetailPage: CLI command and recent tracking `frontend/src/pages/EvalDetailPage.tsx`	Adds useEffect to record product as recently viewed, imports and renders CliCommand component in place of Aria2Tip.
HomePage: recently viewed section `frontend/src/pages/HomePage.tsx`	Imports and renders RecentlyViewed component immediately after StatsBar.
Progress and conventions documentation `.gitignore`, `CLAUDE.md`, `PROGRESS.md`	.gitignore excludes Claude Code internal directory. CLAUDE.md adds testing reminder and marks UX features in-progress. PROGRESS.md documents expiry countdown, refresh-link UI threshold (6 hours), CLI tabs with localStorage, recently viewed tracking, and marks file-size as not feasible.

Sequence Diagram(s)

sequenceDiagram
  participant User
  participant ProductDetailPage
  participant Backend
  participant RecentlyViewed
  participant localStorage

  User->>ProductDetailPage: Open product
  ProductDetailPage->>Backend: GET /proxy (first load)
  Backend-->>ProductDetailPage: Download links with se param
  ProductDetailPage->>ProductDetailPage: Parse expiry, start countdown
  ProductDetailPage->>RecentlyViewed: addRecentEntry(product)
  RecentlyViewed->>localStorage: Store product + expiry
  ProductDetailPage->>User: Show expiry countdown
  
  alt Expiry under 6 hours
    User->>ProductDetailPage: Click Refresh
    ProductDetailPage->>Backend: GET /proxy?force=true
    Backend-->>ProductDetailPage: Fresh links with new se
    ProductDetailPage->>ProductDetailPage: Re-parse expiry, reset countdown
    ProductDetailPage->>RecentlyViewed: updateRecentExpiry(id, timestamp)
    RecentlyViewed->>localStorage: Update expiry timestamp
    ProductDetailPage->>User: Show success toast
  end

  User->>ProductDetailPage: Click Copy (CliCommand)
  ProductDetailPage->>localStorage: Read tool preference
  ProductDetailPage->>User: Copy command to clipboard + toast

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

starkSV/windows-iso-downloader#7: Modifies the /proxy endpoint cache/worker flow; this PR adds cache-bypass logic to the same endpoint.

Poem

🐰 Fresh links refresh with force applied,
CLI commands switch with pride,
Recently viewed in localStorage hide,
UX blooms brighter on every side!
✨

✨ Finishing Touches

📝 Generate docstrings

Create stacked PR
Commit on current branch

🧪 Generate unit tests (beta)

Create PR with unit tests
Commit unit tests in branch feat/ux-improvements

Warning

There were issues while running some tools. Please review the errors and either fix the tool's configuration or disable the tool if it's a critical failure.

🔧 golangci-lint (2.12.2)

level=error msg="[linters_context] typechecking error: pattern ./...: directory prefix . does not contain main module or its selected dependencies"

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

> [!CAUTION] > ## Review failed > > The pull request is closed.  <details> <summary>ℹ️ Recent review info</summary> <details> <summary>⚙️ Run configuration</summary> **Configuration used**: defaults **Review profile**: CHILL **Plan**: Pro Plus **Run ID**: `c9218fed-bcfc-4be0-ba36-7b20b2b52d5a` </details> <details> <summary>📥 Commits</summary> Reviewing files that changed from the base of the PR and between e3f34016c6a4901253e702d4e0b29d4935a469aa and b2c9e2d874cd30b8c352fe9e1d1792a39e4748f8. </details> <details> <summary>📒 Files selected for processing (9)</summary> * `.gitignore` * `CLAUDE.md` * `PROGRESS.md` * `backend/main.go` * `frontend/src/components/CliCommand.tsx` * `frontend/src/components/RecentlyViewed.tsx` * `frontend/src/pages/EvalDetailPage.tsx` * `frontend/src/pages/HomePage.tsx` * `frontend/src/pages/ProductDetailPage.tsx` </details> </details> ---  <details> <summary>📝 Walkthrough</summary> ## Walkthrough This PR implements frontend UX improvements for link refresh and product tracking. It adds backend support for cache-bypass refresh requests, introduces a CLI command component for multi-tool download commands with localStorage persistence, adds a recently-viewed product tracker, and integrates these across ProductDetailPage, EvalDetailPage, and HomePage. Documentation is updated to reflect in-progress status. ## Changes **Frontend UX Improvements: Link Refresh, CLI Commands, and Recently Viewed Items** | Layer / File(s) | Summary | |---|---| | **Backend force-refresh cache bypass** `backend/main.go` | The `/proxy` endpoint now accepts `force=true` parameter to skip cache reads and negative-cache checks. Singleflight key is namespaced with `link:force:` prefix during forced fetches. Logging distinguishes between forced and normal fetches with expiry time. | | **CLI command generation component** `frontend/src/components/CliCommand.tsx` | New component generates wget/curl/aria2 download commands with tool selection persisted in localStorage. Provides collapsible UI with tabs, copy-to-clipboard action, and transient feedback toast. | | **Recently Viewed product tracking** `frontend/src/components/RecentlyViewed.tsx` | New module provides localStorage-backed recently viewed entries with expiry countdown. Includes `RecentEntry` interface, persistence helpers, `useCountdown` hook, `formatRemaining` utility, and UI components for entry cards and grid display. | | **ProductDetailPage: expiry tracking and refresh flow** `frontend/src/pages/ProductDetailPage.tsx` | Parses `se` query parameter to extract expiry timestamp, manages countdown state with interval timer, replaces static expiry warning with dynamic row showing status and conditional refresh button (under 6 hours). New `handleRefreshLinks` fetches with `force=true`, re-parses expiry, updates recent entry, and shows toasts. Swaps Aria2Tip for CliCommand. Records product as recently viewed on load. | | **EvalDetailPage: CLI command and recent tracking** `frontend/src/pages/EvalDetailPage.tsx` | Adds useEffect to record product as recently viewed, imports and renders CliCommand component in place of Aria2Tip. | | **HomePage: recently viewed section** `frontend/src/pages/HomePage.tsx` | Imports and renders RecentlyViewed component immediately after StatsBar. | | **Progress and conventions documentation** `.gitignore`, `CLAUDE.md`, `PROGRESS.md` | .gitignore excludes Claude Code internal directory. CLAUDE.md adds testing reminder and marks UX features in-progress. PROGRESS.md documents expiry countdown, refresh-link UI threshold (6 hours), CLI tabs with localStorage, recently viewed tracking, and marks file-size as not feasible. | ## Sequence Diagram(s) ```mermaid sequenceDiagram participant User participant ProductDetailPage participant Backend participant RecentlyViewed participant localStorage User->>ProductDetailPage: Open product ProductDetailPage->>Backend: GET /proxy (first load) Backend-->>ProductDetailPage: Download links with se param ProductDetailPage->>ProductDetailPage: Parse expiry, start countdown ProductDetailPage->>RecentlyViewed: addRecentEntry(product) RecentlyViewed->>localStorage: Store product + expiry ProductDetailPage->>User: Show expiry countdown alt Expiry under 6 hours User->>ProductDetailPage: Click Refresh ProductDetailPage->>Backend: GET /proxy?force=true Backend-->>ProductDetailPage: Fresh links with new se ProductDetailPage->>ProductDetailPage: Re-parse expiry, reset countdown ProductDetailPage->>RecentlyViewed: updateRecentExpiry(id, timestamp) RecentlyViewed->>localStorage: Update expiry timestamp ProductDetailPage->>User: Show success toast end User->>ProductDetailPage: Click Copy (CliCommand) ProductDetailPage->>localStorage: Read tool preference ProductDetailPage->>User: Copy command to clipboard + toast ``` ## Estimated code review effort 🎯 3 (Moderate) | ⏱️ ~25 minutes ## Possibly related PRs - [starkSV/windows-iso-downloader#7](https://github.com/starkSV/windows-iso-downloader/pull/7): Modifies the `/proxy` endpoint cache/worker flow; this PR adds cache-bypass logic to the same endpoint. ## Poem > 🐰 Fresh links refresh with force applied, > CLI commands switch with pride, > Recently viewed in localStorage hide, > UX blooms brighter on every side! > ✨ </details>   <details> <summary>✨ Finishing Touches</summary> <details> <summary>📝 Generate docstrings</summary> - [ ]  Create stacked PR - [ ]  Commit on current branch </details> <details> <summary>🧪 Generate unit tests (beta)</summary> - [ ]  Create PR with unit tests - [ ]  Commit unit tests in branch `feat/ux-improvements` </details> </details>   > [!WARNING] > There were issues while running some tools. Please review the errors and either fix the tool's configuration or disable the tool if it's a critical failure. > > <details> > <summary>🔧 golangci-lint (2.12.2)</summary> > > level=error msg="[linters_context] typechecking error: pattern ./...: directory prefix . does not contain main module or its selected dependencies" > > > > > </details>   --- Comment `@coderabbitai help` to get the list of available commands and usage tips.