Files
OmniRoute/tests/unit/radar-links.test.ts
Diego Rodrigues de Sa e Souza 02534f4e8e feat(radar): contributor + supporter claim buttons on the activation screen (#9710)
* feat(radar): add F4/T7 contributor-claim / supporter-plans link config

Pure, DB-free src/lib/radar/links.ts resolves the two outbound "get a
supporter key" URLs (contributor GitHub-OAuth claim + supporter plans
page), same env-override pattern as RADAR_FEED_URL. No pricing/value is
ever resolved here (D14) — only the link.

* feat(radar): relay F4/T7 claim/plans links via GET /api/radar/settings

Smallest-surface option per spec: no dedicated route. The existing
settings snapshot now also returns contributorClaimUrl/supporterPlansUrl
so the dashboard client never reads process.env itself. Both are plain
public URLs, gated by the same flag/auth checks as the rest of the
response.

* feat(radar): add contributor/supporter claim buttons to activation screen

F4/T7 — "I'm a contributor" opens the GitHub OAuth claim flow;
"Support the project" opens the plans/payment page. Both links come
from the settings fetch (never a hardcoded URL in this client
component) and open in a new tab. No price/value anywhere in the
copy — the destination page is the only place pricing lives (D14).

i18n: 5 new radarPage keys (claimSectionTitle, contributorButton,
contributorHint, supporterButton, supporterHint) added to all 43
locale files with the English copy as fallback value.

* docs(radar): document F4/T7 supporter-key acquisition paths

RADAR.md: new "Getting a supporter key" section covering both claim
flows, the two env-var overrides, and the current gap (no dedicated
key-paste input in the dashboard yet — POST /api/radar/settings is the
only way to set one today). ENVIRONMENT.md + .env.example: register
RADAR_CONTRIBUTOR_CLAIM_URL / RADAR_SUPPORTER_PLANS_URL for
check:env-doc-sync.

---------

Co-authored-by: diegosouzapw <diegosouzapw@users.noreply.github.com>
2026-08-07 16:41:00 -03:00

57 lines
2.5 KiB
TypeScript

/**
* tests/unit/radar-links.test.ts
*
* TDD guard for src/lib/radar/links.ts — the two outbound "get a supporter
* key" links (F4/T7): contributor-claim (GitHub OAuth) and supporter-plans
* (payment page). Pure, DB-free module: defaults + env override only.
*
* No price/monetary value assertion lives here on purpose — this module
* never resolves one (D14: pricing only lives on the private plans page the
* URL points at, never in the OSS repo).
*/
import test from "node:test";
import assert from "node:assert/strict";
test.beforeEach(() => {
delete process.env.RADAR_CONTRIBUTOR_CLAIM_URL;
delete process.env.RADAR_SUPPORTER_PLANS_URL;
});
test.after(() => {
delete process.env.RADAR_CONTRIBUTOR_CLAIM_URL;
delete process.env.RADAR_SUPPORTER_PLANS_URL;
});
test("getContributorClaimUrl: defaults to the radar.omniroute.online GitHub OAuth entry point", async () => {
const { getContributorClaimUrl } = await import("../../src/lib/radar/links.ts");
assert.equal(getContributorClaimUrl(), "https://radar.omniroute.online/auth/github");
});
test("getContributorClaimUrl: honors RADAR_CONTRIBUTOR_CLAIM_URL override", async () => {
process.env.RADAR_CONTRIBUTOR_CLAIM_URL = "https://fork.example.com/auth/github";
const { getContributorClaimUrl } = await import("../../src/lib/radar/links.ts");
assert.equal(getContributorClaimUrl(), "https://fork.example.com/auth/github");
});
test("getSupporterPlansUrl: defaults to the radar.omniroute.online plans page", async () => {
const { getSupporterPlansUrl } = await import("../../src/lib/radar/links.ts");
assert.equal(getSupporterPlansUrl(), "https://radar.omniroute.online/planos");
});
test("getSupporterPlansUrl: honors RADAR_SUPPORTER_PLANS_URL override", async () => {
process.env.RADAR_SUPPORTER_PLANS_URL = "https://fork.example.com/plans";
const { getSupporterPlansUrl } = await import("../../src/lib/radar/links.ts");
assert.equal(getSupporterPlansUrl(), "https://fork.example.com/plans");
});
test("getContributorClaimUrl / getSupporterPlansUrl: empty-string env falls back to default (not a blank link)", async () => {
process.env.RADAR_CONTRIBUTOR_CLAIM_URL = "";
process.env.RADAR_SUPPORTER_PLANS_URL = "";
const { getContributorClaimUrl, getSupporterPlansUrl } = await import(
"../../src/lib/radar/links.ts"
);
assert.equal(getContributorClaimUrl(), "https://radar.omniroute.online/auth/github");
assert.equal(getSupporterPlansUrl(), "https://radar.omniroute.online/planos");
});