Skip to content

Conversation

@archcorsair
Copy link
Owner

@archcorsair archcorsair commented Jan 7, 2026

Summary

  • Add Wago.io as a supported addon source alongside GitHub, TukUI, and WoWInterface
  • Implement full install/update flow with API key authentication (bring your own key)
  • Add Wago API key configuration in Settings with masked input
  • Add [Wago] source badge display in cyan

Changes

  • Core: New src/core/wago.ts module with types, API functions, and helpers
  • Commands: InstallWagoCommand for installing addons by ID or URL
  • Integration: Updated InstallFromUrlCommand and UpdateAddonCommand for Wago support
  • Config: Added wagoApiKey with env var fallback (WAGO_API_KEY)
  • UI: ConfigScreen setting + source badge in RepositoryRow
  • Security: Download URL domain validation, input validation

Test Plan

  • 213 tests pass (211 pass, 2 skip)
  • Typecheck passes
  • Lint passes
  • Manual test: Set WAGO_API_KEY and install addon from Wago URL
  • Manual test: Configure API key via Settings screen
  • Manual test: Verify update detection for Wago addons

Add foundation types and first API function for Wago.io addon source.
This includes WagoGameData, WagoRelease, WagoCategory, WagoAddonSummary
interfaces and the getGameData API function to fetch game metadata.
Add search and addon details API functions for Wago integration:

- searchAddons: query Wago catalog by name with game version filter
- getAddonDetails: fetch addon details by ID with typed result union

Both functions require API key authentication (Bearer token) and
include runtime validation for API responses.
Add utility functions for Wago addon processing:
- getDownloadUrl(): extract download URL from release, handles API field drift
- getVersion(): extract version label from release
- getBestAvailableStability(): find best available channel (stable > beta > alpha)
- getAddonIdFromUrl(): parse addon ID from Wago URLs
Allow users to provide Wago.io API key via environment variable as a
fallback when the stored config value is empty. Stored config takes
precedence over the env var when both are present.
…llback path

The env var fallback was only applied when Zod validation succeeded.
Now it's also applied in the fallback path when Zod validation fails,
ensuring consistent behavior regardless of config validity.
Implements the command pattern for installing addons from Wago.io.
Supports addon ID or full URL input, stability channel selection
(stable/beta/alpha with fallback), multi-folder addon handling with
ownedFolders, and automatic rollback on failure.
- Add empty-string validation for addon ID
- Validate download URL domain is wago.io before downloading
Add a new API Keys section with a Wago API key input field that:
- Uses masked input (mask="*") when editing for security
- Shows masked display when not editing (up to 16 asterisks)
- Shows "Not Configured" when no key is set
- Follows existing patterns for text input fields (like destDir)
Add cyan-colored [Wago] badge for Wago addon source type in the
repository row component, consistent with existing source type badges.
Also update the download status text condition to show "Downloading
Zip..." for Wago addons.
Fixes React warning: "Cannot update a component while rendering a
different component". The checkStartTimes state was being updated
inside the renderItem callback during render. Moved the state tracking
to a useEffect that watches query fetching states.
- Accept recent_release in addition to releases field
- Normalize recent_release to releases structure
- Use owner with fallback to authors array for author field
- Make owner and authors optional in type definition
- Show "From env WAGO_API_KEY" when key is sourced from environment
- Disable editing when key comes from env var
- Show hint about WAGO_API_KEY env var when not configured
- Replace manual type guards with Zod schemas and safeParse
- Make schema fields permissive with .loose() for API compatibility
- Fix download hang by consuming response as arrayBuffer before write
- Add test for updating Wago addon when new version available
- Add test for detecting no update needed when version matches
- Fix download hang in UpdateAddonCommand (same arrayBuffer fix)
@archcorsair archcorsair merged commit ae88d45 into main Jan 7, 2026
1 check passed
@archcorsair archcorsair deleted the feat/wago branch January 7, 2026 23:39
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants