CheapShark PC game deals

cheapshark is a credential-free ECMAScript provider for explicit PC-game title lookups. It is disabled by default. Enable it in Settings → Script packages to include US-dollar game deals. Approval and enablement are separate choices; approving or rediscovering the package does not enable it. Existing explicit enabled/disabled preferences survive migration and restart. USD is a pricing currency, not a claim of US-only availability. There is no geolocation or price conversion. Disabled packages perform no search or reference-list requests.

Search displays ten store/deal records with game/store/deal IDs, sale and regular prices labelled USD, available savings/release/score metadata, and CheapShark attribution. A game may have several store-specific deals. Search only requests lightweight deals and the store reference list. Selecting a result lazily requests the documented deal details and lowest recorded price. No invented publisher/platform/full-content data is advertised.

The official API documentation and its published collection were reviewed for request parameters, data shapes and terms. Prices are always USD and date fields use Unix seconds. Deal IDs are already URL-encoded; KLookup normalizes them once to avoid broken double encoding. All deal links use the required https://www.cheapshark.com/redirect?dealID=... page. The host never fetches that redirect page: it is a user-facing link, not an automation endpoint.

Requests use the documented /api/1.0/deals and /stores endpoints, an explicit HTTPS origin and a descriptive KLookup User-Agent. No API key or secret is required. A small one-minute user-query cache and 24-hour fulfilled store-reference cache avoid repeat calls. Pending store promises are not cached, so cancelling a query cannot poison later searches. HTTP 429 uses Retry-After with no automatic retry loop. No request runs at startup, and there is no catalog synchronization. Store-reference failures can still show grounded store IDs; rate limits are propagated. This focused first page does not advertise pagination.

Synthetic fixtures and offline selfTest cover actual production mapping, empty, partial, invalid and detail data, including an encoded deal ID. Dedicated provider tests cover Unicode query encoding, errors, cooldown, cancellation, lazy details, caching, approval/enablement and MainWindow/SearchTab activation. The protected staged install verifies assets and first activation without seeded approval. Ordinary CI never calls CheapShark or its redirect pages.

Default-policy audit

CheapShark is the only default-off exception: USD-priced PC-game store deals are an opt-in special-purpose source. The other shipped native and scripted sources retain their existing default. No documented geographic restriction was established for those sources; authentication requirements remain separate. All restoration, Settings, diagnostics and missing-package paths use the shared provider-default policy. Only stored _Enabled keys migrate from QSettings; absent values remain absent. Applying unrelated settings does not turn inherited defaults into explicit provider overrides.