[fatihemres]

Summary

This draft pull request introduces SteamAPI Desktop v0.1.0, an interactive desktop client built with .NET 10 and Avalonia UI 11.2 that exposes the existing SteamAPI service through a graphical user interface, packaged with a professional Windows installer.

Distribution Formats

• PRIMARY Installer: SteamAPI-Desktop-Setup-v0.1.0-win-x64.exe (Inno Setup 6)
  • Non-administrative per-user installation (%LOCALAPPDATA%\Programs\SteamAPI Desktop).
  • Persistent installer AppId GUID ({B42B8D30-80E5-46D9-8E92-E23B86BC7B62}) supporting clean in-place upgrades.
  • Automatic Start Menu shortcut and optional Desktop shortcut.
  • Full registration in Windows Installed Apps (Add or Remove Programs) with working uninstaller.
  • Safe lifecycle management: detects running application instances before upgrade/uninstall.
  • Strict preservation of user settings (%APPDATA%\SteamAPI.Desktop\settings.json).
• OPTIONAL Portable Archive: SteamAPI-Desktop-v0.1.0-win-x64.zip for advanced users and portable/restricted environments.
• Both distributions include matching SHA-256 sidecars (.sha256).

Actual Implemented Features

1. Game Explorer

• Search: Query games by title keyword with language/culture selection targeting exactly the three supported SteamAPI v0.2.0 storefront cultures:
  • Turkey / Turkish (Culture ID: 1, Country Code: TR)
  • United States / English (Culture ID: 2, Country Code: US)
  • Spain / Spanish (Culture ID: 3, Country Code: ES)
• Results Listing: Displays search results containing game name, Steam App ID, sale type badge (PAID, FREE TO PLAY, NOT AVAILABLE), and price display.
• Contract Conformance: Conforms strictly to the backend API's verified six-field contract (name, storeLink, imageLink, price, saleType, appId). Does not display or fabricate unverified metadata such as developers, publishers, release dates, Metacritic scores, genre tags, discount percentages, or currency symbols.
• Price Presentation: Formats numeric price values invariant to two decimals, or displays state text (Free to Play, Not Available) derived from saleType.
• Launchers & Clipboard Actions: Direct launcher buttons to open the game in the Steam desktop client (steam://store/{appId}) or web browser (storeLink), with buttons to copy App ID and store URL to clipboard.

2. API Inspector

• Request Diagnostics: Captures request URL, HTTP method, culture parameter, game query, HTTP status code, latency (ms), and timestamp for each API call.
• Response Inspection: Scrollable, read-only viewer displaying the raw JSON payload returned by the backend.
• Clipboard Utility: One-click buttons to copy the full JSON response or request URL.

3. Settings & Process Management

• API Connectivity: Configurable API Base URL (defaults to http://localhost:5271) and HTTP request timeout with an interactive "Test Connection" diagnostic button.
• Bundled Loopback Server: Controls the local companion ASP.NET Core SteamAPI backend process:
  • Live process status indicator (Stopped, Starting, Running, Failed).
  • Manual "Start Server" and "Stop Server" buttons.
  • Checkbox to automatically launch the companion backend on desktop application startup.
  • Error banner displaying actionable troubleshooting details on failure.
• Offline Demo Mode: Toggle switch activating offline simulation. When active, queries are served from an embedded curated dataset without issuing network or API calls.
• Persistence: User settings saved to %APPDATA%\SteamAPI.Desktop\settings.json with a "Reset Defaults" action. (Note: Theme switcher UI is not present in this release; the application uses the Steam-inspired dark palette).

4. Creator Attribution & About View

• Creator Recognition: Prominently acknowledges creator Fatih Emre Sarman (@fatihemres) with clickable links to the GitHub repository and profile.
• Supported Market Information: Clearly presents the three supported regional storefront markets (Turkey, United States, Spain) without fabricating unverified currency codes or symbols.
• Persistent Footer: Subtle attribution in the main window status footer alongside the companion API connection indicator.
• Technical Metadata: Displays assembly version, runtime environment, and open-source license information.

Architecture & Lifecycle Design

• MVVM Architecture: Built with Avalonia UI 11.2 and CommunityToolkit.Mvvm, abstracting platform dependencies behind interfaces (IClipboardService, ILauncherService, IDemoDataService, ISettingsService, IApiProcessManager).
• Win32 Job Object Ownership: On Windows, the companion backend process is registered in a Win32 Job Object configured with JOB_OBJECT_LIMIT_KILL_ON_JOB_CLOSE. Child processes are reliably terminated by the operating system if the host application exits or terminates unexpectedly.
• Safe Port Conflict Handling: Port 127.0.0.1:5271 is checked via standard socket connection before starting the child process. If occupied by another application, startup halts immediately with a clear error message. No POST /steam or HTTP search requests are sent to unknown listeners, avoiding unexpected upstream network traffic or service disruption.
• Graceful Shutdown: Window close detaches UI event listeners prior to stopping child processes, avoiding compositor shutdown deadlocks. Normal window close completes cleanly and releases all file locks.

Verification Evidence

GitHub Actions CI

• Automated Workflow: Validates solution compilation, test suite execution in both Debug and Release configurations across ubuntu-latest and windows-latest, Windows packaging, and artifact upload.
• CI Test Suite: 222/222 tests passing across both Ubuntu and Windows runners (157 backend + 65 desktop, 0 failures, 0 skipped).
• Downloadable Package Artifact: steamapi-desktop-v0.1.0-win-x64 generated and retained by GitHub Actions (includes SteamAPI-Desktop-Setup-v0.1.0-win-x64.exe installer, SteamAPI-Desktop-v0.1.0-win-x64.zip portable archive, and both .sha256 sidecars).

Local Windows Acceptance Evidence

• Installer Lifecycle Audit:
  • Silent installation into isolated test directory: Succeeded (Exit code 0).
  • Main executable and companion api\SteamAPI.exe verified present.
  • Windows Installed Apps registry key (HKCU:\...\Uninstall\{B42B8D30-80E5-46D9-8E92-E23B86BC7B62}_is1) verified created with complete publisher and version metadata.
  • Same-version reinstallation: Verified no duplicate registry entries created.
  • Silent uninstallation: Succeeded (Exit code 0), removed application binaries and registry keys cleanly.
  • User settings %APPDATA%\SteamAPI.Desktop\settings.json preserved intact across install and uninstall.
• Normal-Close Shutdown Audit: Extracted portable release verified to shut down with exit code 0 in ~140 ms, with zero lingering background processes and immediate folder deletion.
• Backend v0.2.0 Baseline: git diff --stat 04ee2b1b2a1f1dae96d62ac5b5219955f346b197 -- Infrastructer/ SteamAPI/ SteamAPI.Tests/ confirms 0 files modified; existing backend API implementation remains untouched.

Known Limitations

• Unsigned Windows Executable: Both the installer and portable executable are unsigned (open-source / zero mandatory recurring cost). Windows SmartScreen will display an "Unknown Publisher" warning on initial execution. Users click More info -> Run anyway.
• Port 5271 Dependency: The bundled loopback backend requires port 5271. If another application uses this port, companion startup fails safely; users must free port 5271 or configure an alternate external API URL in Settings.
• Platform Packaging Scope: Automated packaging produces self-contained distributions specifically for Windows x64.

Rollback Strategy

All desktop code, installer scripts, and tests reside strictly in desktop/ and solution references in SteamAPI.sln. Reverting the desktop commits cleanly restores the stable v0.2.0 baseline.

Product Owner Next Steps

This PR is in DRAFT state for Product Owner acceptance testing. It must not be merged until final UAT is approved.