diff --git a/README.md b/README.md index e940757c..cb671915 100644 --- a/README.md +++ b/README.md @@ -20,6 +20,22 @@ This repo contains the source files for the [LizardByte](https://app.lizardbyte. The page is built using jekyll and hosted on GitHub Pages. +### Project discovery + +The Projects section reads public repository data from dashboard's `github/repos.json` and the +[organization registry](https://github.com/LizardByte/.github/blob/master/organizations.json). +The registry drives organization filtering and the archived-project search. Project search matches +repository names, organizations, and descriptions; each card shows its organization. + +This consumer requires the multi-org dashboard catalog: banners use `dashboard_paths.banner_small`, +activity and languages use `dashboard_key`, and Read the Docs links match `dashboard_aliases`. +Transfers and renames therefore retain the existing asset URLs. Filtering reuses the rendered cards +without fetching their assets again. + +Project titles and banners link to a repository's HTTP(S) `homepage`, or its GitHub page when no valid +homepage is configured. Set that field to the project's public site, including its new subdomain. +The consumer does not infer a site URL from an organization or repository name. + ### CrowdIn Localization

diff --git a/assets/js/projects.js b/assets/js/projects.js index f1e2dd7e..b5f46a71 100644 --- a/assets/js/projects.js +++ b/assets/js/projects.js @@ -5,6 +5,7 @@ let container let org_name = "LizardByte" let base_url = `https://app.${org_name.toLowerCase()}.dev` let cache_repo = "dashboard" +const organizations_url = "https://raw.githubusercontent.com/LizardByte/.github/master/organizations.json" let shared_web_url = "https://cdn.jsdelivr.net/npm/@lizardbyte/shared-web@2026.1107.31840" @@ -36,28 +37,51 @@ function fetchJson(url) { } function shouldProcessRepo(repo) { + if (repo['private'] === true) return false; if (repo['archived'] === true) return false; if (repo['description'] === null) return false; return !(repo['fork'] === true && !repo['topics'].includes("featured-fork")); } +function projectUrl(repo) { + try { + const homepage = new URL(repo.homepage) + if (["https:", "http:"].includes(homepage.protocol)) return homepage.href + } catch { + // Repositories without a valid homepage link to GitHub. + } + return repo.html_url +} + +function githubIdentity(value) { + try { + const url = new URL(value.replace(/^git@github\.com:/i, "https://github.com/")) + const parts = url.pathname.split("/").filter(Boolean) + if (url.hostname !== "github.com" || parts.length !== 2) return null + return parts.join("/").replace(/\.git$/i, "").toLowerCase() + } catch { + return null + } +} + function createBannerElement(repo) { let banner_div = document.createElement("div") banner_div.className = "hover-zoom" let banner_link = document.createElement("a") banner_link.className = "crowdin-ignore" - banner_link.href = repo['html_url'] + banner_link.href = projectUrl(repo) banner_link.target = "_blank" + banner_link.rel = "noopener noreferrer" banner_div.append(banner_link) let banner = document.createElement("img") banner.className = "card-img-top rounded-0" - banner.src = `${base_url}/${cache_repo}/github/openGraphImages/${repo['name']}_624x312.png` + banner.src = `${base_url}/${cache_repo}/${repo.dashboard_paths.banner_small}` banner.alt = "" banner_link.append(banner) - return { banner_div, banner_link } + return banner_div } function createCardBody(repo) { @@ -66,8 +90,9 @@ function createCardBody(repo) { let card_title_link = document.createElement("a") card_title_link.className = "text-decoration-none project-card-link crowdin-ignore" - card_title_link.href = repo['html_url'] + card_title_link.href = projectUrl(repo) card_title_link.target = "_blank" + card_title_link.rel = "noopener noreferrer" card_body.appendChild(card_title_link) let card_title_text = document.createElement("h5") @@ -83,16 +108,21 @@ function createCardBody(repo) { card_title_link.appendChild(card_title_text) + const organization = document.createElement("p") + organization.className = "project-organization small text-muted crowdin-ignore" + organization.textContent = repo.owner.login + card_body.appendChild(organization) + let card_paragraph = document.createElement("p") card_paragraph.className = "card-text mb-0" card_paragraph.textContent = repo['description'] card_body.appendChild(card_paragraph) - return { card_body, card_title_link } + return card_body } function loadCommitActivity(repo, card_footer) { - fetchJson(`${base_url}/${cache_repo}/github/commitActivity/${repo['name']}.json`) + fetchJson(`${base_url}/${cache_repo}/github/commitActivity/${repo.dashboard_key}.json`) .then(function (commitActivity) { let activity_container = document.createElement("div") activity_container.className = "commit-activity-graph mt-2 mb-2 mx-3" @@ -125,7 +155,7 @@ function loadCommitActivity(repo, card_footer) { }) } -function createRepoDataRow(repo, card_footer, banner_link, card_title_link) { +function createRepoDataRow(repo, card_footer) { let repo_data_row = document.createElement("div") repo_data_row.className = "d-flex align-items-center" card_footer.appendChild(repo_data_row) @@ -140,15 +170,6 @@ function createRepoDataRow(repo, card_footer, banner_link, card_title_link) { github_link_image.className = "fa-fw fa-brands fa-github" github_link.prepend(github_link_image) - fetchWithNoCache(`${base_url}/${repo['name']}/`) - .then(function (response) { - if (!response.ok) return - - banner_link.href = `${base_url}/${repo['name']}/` - card_title_link.href = `${base_url}/${repo['name']}/` - }) - .catch(function () {}) - let star_link = document.createElement("a") star_link.className = "nav-link nav-link-sm project-nav-link ms-3 crowdin-ignore" star_link.href = `https://star-history.com/#${repo['full_name']}` @@ -176,10 +197,8 @@ function createRepoDataRow(repo, card_footer, banner_link, card_title_link) { function addDocsLink(repo, readthedocs, repo_data_row) { for (let docs in readthedocs) { - let docs_repo = readthedocs[docs]['repository']['url'].toLowerCase(); - let project_repo = repo['clone_url'].toLowerCase(); - - if (docs_repo !== project_repo) continue; + const docs_repo = githubIdentity(readthedocs[docs]['repository']['url']); + if (!repo.dashboard_aliases.some(alias => alias.toLowerCase() === docs_repo)) continue; let docs_url = readthedocs[docs]['urls']['documentation'] try { @@ -208,7 +227,7 @@ function addDocsLink(repo, readthedocs, repo_data_row) { } function loadLanguageIcons(repo, card_footer) { - fetchJson(`${base_url}/${cache_repo}/github/languages/${repo['name']}.json`) + fetchJson(`${base_url}/${cache_repo}/github/languages/${repo.dashboard_key}.json`) .then(function (languages) { let language_data_row = document.createElement("div") language_data_row.className = "card-group p-3 align-items-center" @@ -236,11 +255,9 @@ function buildRepoCard(repo, readthedocs) { card.className = "card h-100 shadow border-0 rounded-0" column.appendChild(card) - let { banner_div, banner_link } = createBannerElement(repo) - card.append(banner_div) + card.append(createBannerElement(repo)) - let { card_body, card_title_link } = createCardBody(repo) - card.appendChild(card_body) + card.appendChild(createCardBody(repo)) let card_footer = document.createElement("div") card_footer.className = "card-footer p-2 pt-0 border-0 rounded-0" @@ -248,9 +265,57 @@ function buildRepoCard(repo, readthedocs) { loadCommitActivity(repo, card_footer) - let repo_data_row = createRepoDataRow(repo, card_footer, banner_link, card_title_link) + let repo_data_row = createRepoDataRow(repo, card_footer) addDocsLink(repo, readthedocs, repo_data_row) loadLanguageIcons(repo, card_footer) + return column +} + +function updateProjectFilters(cards, organizations) { + const organization = document.getElementById("project-organization").value + const terms = document.getElementById("project-search").value.toLowerCase().trim().split(/\s+/).filter(Boolean) + let count = 0 + for (const { repo, column } of cards) { + const text = `${repo.full_name} ${repo.description}`.toLowerCase() + const matches = (!organization || repo.owner.login.toLowerCase() === organization.toLowerCase()) + && terms.every(term => text.includes(term)) + column.hidden = !matches + if (matches) count += 1 + } + const noun = count === 1 ? "project" : "projects" + document.getElementById("project-status").textContent = count + ? `${count} ${noun}` : "No projects match your search." + + const scope = organization ? [organization] : organizations + const query = [...scope.map(name => `org:${name}`), "archived:true"].join(" ") + const archive = document.getElementById("archived-projects-link") + archive.href = `https://github.com/search?${new URLSearchParams({ q: query, type: "repositories" })}` + archive.classList.remove("disabled") + archive.removeAttribute("aria-disabled") +} + +function createProjectBrowser(repos, readthedocs, organizations) { + if (!Array.isArray(organizations) || !organizations.length + || organizations.some(name => typeof name !== "string" || !/^[a-z\d][a-z\d-]*$/i.test(name))) { + throw new Error("Invalid organization registry") + } + const organization = document.getElementById("project-organization") + organizations.sort((left, right) => left.localeCompare(right)) + for (const name of organizations) { + organization.add(new Option(name, name)) + } + const registered = new Set(organizations.map(name => name.toLowerCase())) + const sorted = repos.filter(repo => registered.has(repo.owner.login.toLowerCase()) && shouldProcessRepo(repo)) + .sort(globalThis.rankingSorter("stargazers_count", "full_name")) + // Build each card once so filtering does not fetch its assets again. + const cards = sorted.map(repo => ({ repo, column: buildRepoCard(repo, readthedocs) })) + const update = () => updateProjectFilters(cards, organizations) + const search = document.getElementById("project-search") + organization.disabled = false + search.disabled = false + organization.addEventListener("change", update) + search.addEventListener("input", update) + update() } @@ -269,18 +334,14 @@ onDocumentReady(function () { }) let reposRequest = fetchJson(`${base_url}/${cache_repo}/github/repos.json`) + let organizationsRequest = fetchJson(organizations_url) - Promise.all([readthedocsRequest, reposRequest]) - .then(function ([readthedocs, result]) { - let sorted = result.sort(globalThis.rankingSorter("stargazers_count", "name")) - - for (let repo of sorted) { - if (shouldProcessRepo(repo)) { - buildRepoCard(repo, readthedocs) - } - } + Promise.all([readthedocsRequest, reposRequest, organizationsRequest]) + .then(function ([readthedocs, result, organizations]) { + createProjectBrowser(result, readthedocs, organizations) }) .catch(function (error) { + document.getElementById("project-status").textContent = "Projects could not be loaded. Please try again later." console.error("Error loading project data:", error) }) }) diff --git a/eslint.config.mjs b/eslint.config.mjs index 5b26d0f6..b088eebe 100644 --- a/eslint.config.mjs +++ b/eslint.config.mjs @@ -11,7 +11,7 @@ export default [ ], }, { - files: ['assets/js/release-versions.js'], + files: ['assets/js/release-versions.js', 'assets/js/projects.js'], languageOptions: { globals: { ...globals.browser, diff --git a/index.html b/index.html index b60bec27..96583465 100644 --- a/index.html +++ b/index.html @@ -71,11 +71,27 @@

Projects

+
+
+ + +
+
+ + +
+
+ Loading projects…
- + Archived Projects
diff --git a/package.json b/package.json index fd37ed46..132f7cbb 100644 --- a/package.json +++ b/package.json @@ -26,7 +26,7 @@ "scripts": { "build": "echo \"No Node.js build step required\"", "test": "npm-run-all test:unit test:report test:lint", - "test:lint": "eslint assets/js/release-versions.js tests", + "test:lint": "eslint assets/js/release-versions.js assets/js/projects.js tests", "test:report": "jest --reporters=jest-junit", "test:unit": "jest --coverage" }, diff --git a/tests/projects.test.cjs b/tests/projects.test.cjs index 368a9803..1d2c7212 100644 --- a/tests/projects.test.cjs +++ b/tests/projects.test.cjs @@ -1,6 +1,11 @@ /** @jest-environment jsdom */ -const { afterEach, describe, expect, test } = require('@jest/globals'); +const { afterEach, beforeEach, describe, expect, test } = require('@jest/globals'); +const { readFileSync } = require('node:fs'); +const { join } = require('node:path'); + +const registryUrl = 'https://raw.githubusercontent.com/LizardByte/.github/master/organizations.json'; +const dashboardUrl = 'https://app.lizardbyte.dev/dashboard'; function loadScript() { jest.resetModules(); @@ -10,9 +15,7 @@ function loadScript() { function captureDomReady() { let callback; const addEventListener = jest.spyOn(document, 'addEventListener').mockImplementation((type, listener) => { - if (type === 'DOMContentLoaded') { - callback = listener; - } + if (type === 'DOMContentLoaded') callback = listener; }); loadScript(); addEventListener.mockRestore(); @@ -23,20 +26,68 @@ function setReadyState(value) { return jest.spyOn(document, 'readyState', 'get').mockReturnValue(value); } -async function flushPromises(rounds = 8) { - for (let index = 0; index < rounds; index += 1) { - await Promise.resolve(); - } +async function flushPromises(rounds = 12) { + for (let index = 0; index < rounds; index += 1) await Promise.resolve(); } function response(body, ok = true, status = 200) { + return { json: jest.fn().mockResolvedValue(body), ok, status }; +} + +function project(name, { organization = 'LizardByte', ...overrides } = {}) { + const fullName = `${organization}/${name}`; return { - json: jest.fn().mockResolvedValue(body), - ok, - status, + archived: false, + private: false, + clone_url: `https://github.com/${fullName}.git`, + description: 'Project description', + fork: false, + forks: 2, + full_name: fullName, + html_url: `https://github.com/${fullName}`, + homepage: null, + name, + owner: { login: organization }, + stargazers_count: 20, + topics: [], + dashboard_key: fullName, + dashboard_aliases: [fullName], + dashboard_paths: { banner_small: `github/openGraphImages/${fullName}_624x312.png` }, + ...overrides, }; } +function catalogFetch(repos, organizations, docs = []) { + return jest.fn(url => { + if (url === registryUrl) return Promise.resolve(response(organizations)); + if (url.endsWith('/readthedocs/projects.json')) return Promise.resolve(response(docs)); + if (url.endsWith('/github/repos.json')) return Promise.resolve(response(repos)); + if (url.includes('/commitActivity/')) return Promise.resolve(response([{ total: 1 }])); + if (url.includes('/languages/')) return Promise.resolve(response({})); + throw new Error(`Unexpected URL: ${url}`); + }); +} + +function visibleCards() { + return [...document.querySelectorAll('#project-container > div')].filter(card => !card.hidden); +} + +function change(id, value, event) { + const element = document.getElementById(id); + element.value = value; + element.dispatchEvent(new Event(event)); +} + +beforeEach(() => { + setReadyState('complete'); + const index = readFileSync(join(__dirname, '../index.html'), 'utf8'); + document.body.innerHTML = index.slice(index.indexOf('')); + globalThis.formatNumber = jest.fn(value => `#${value}`); + globalThis.rankingSorter = jest.fn(() => (left, right) => right.stargazers_count - left.stargazers_count); + jest.spyOn(console, 'error').mockImplementation(() => {}); + jest.spyOn(console, 'log').mockImplementation(() => {}); +}); + afterEach(() => { document.body.innerHTML = ''; delete globalThis.fetch; @@ -47,86 +98,53 @@ afterEach(() => { describe('project cards', () => { test('waits for DOM readiness and exits when the project container is absent', () => { - const readyState = setReadyState('loading'); + document.body.innerHTML = ''; + setReadyState('loading'); globalThis.fetch = jest.fn(); const onReady = captureDomReady(); expect(globalThis.fetch).not.toHaveBeenCalled(); - onReady(); expect(globalThis.fetch).not.toHaveBeenCalled(); - readyState.mockRestore(); }); - test('filters repositories and builds cards with activity, docs, and language data', async () => { - setReadyState('complete'); - document.body.innerHTML = '
'; - globalThis.formatNumber = jest.fn(value => `#${value}`); - globalThis.rankingSorter = jest.fn(() => (left, right) => right.stargazers_count - left.stargazers_count); - jest.spyOn(console, 'error').mockImplementation(() => {}); - jest.spyOn(console, 'log').mockImplementation(() => {}); - - const normal = { - archived: false, - clone_url: 'https://github.com/LizardByte/normal.git', - description: 'Normal project', - fork: false, - forks: 2, - full_name: 'LizardByte/normal', - html_url: 'https://github.com/LizardByte/normal', - name: 'normal', - stargazers_count: 20, - topics: [], - }; - const featured = { - ...normal, - clone_url: 'https://github.com/LizardByte/featured.git', - description: 'Featured fork', - fork: true, - full_name: 'LizardByte/featured', - name: 'featured', - stargazers_count: 10, - topics: ['featured-fork'], - }; - const zero = { - ...normal, - clone_url: 'https://github.com/LizardByte/zero.git', - description: 'Zero activity', - full_name: 'LizardByte/zero', - name: 'zero', - stargazers_count: 5, - }; + test('filters repositories and uses explicit asset paths, stable keys, and pre-transfer docs aliases', async () => { + const normal = project('normal', { + homepage: 'https://sunshine.lizardbyte.dev/', + dashboard_key: 'former-name', + dashboard_aliases: ['OldOrg/former-name', 'LizardByte/normal'], + dashboard_paths: { banner_small: 'github/openGraphImages/former-banner_624x312.png' }, + }); + const featured = project('featured', { + fork: true, stargazers_count: 10, topics: ['featured-fork'], homepage: 'javascript:alert(1)', + }); + const zero = project('zero', { stargazers_count: 5 }); const skipped = [ - { ...normal, archived: true, name: 'archived' }, - { ...normal, description: null, name: 'undocumented' }, - { ...normal, fork: true, name: 'plain-fork', topics: [] }, + project('archived', { archived: true }), + project('private', { private: true }), + project('undocumented', { description: null }), + project('plain-fork', { fork: true }), + project('unregistered', { organization: 'Unknown' }), ]; const docs = { bad: { repository: { url: featured.clone_url }, urls: { documentation: 'not a URL' } }, external: { repository: { url: featured.clone_url }, urls: { documentation: 'https://example.com/docs' } }, - good: { repository: { url: normal.clone_url.toUpperCase() }, urls: { documentation: 'https://docs.lizardbyte.dev/projects/normal' } }, + good: { repository: { url: 'https://github.com/OldOrg/FORMER-NAME.git/' }, urls: { documentation: 'https://docs.lizardbyte.dev/projects/normal' } }, other: { repository: { url: 'https://github.com/Other/project.git' }, urls: { documentation: 'https://docs.lizardbyte.dev/other' } }, }; - + const baseFetch = catalogFetch([...skipped, zero, featured, normal], ['LizardByte'], docs); globalThis.fetch = jest.fn(url => { - if (url.endsWith('/readthedocs/projects.json')) return Promise.resolve(response(docs)); - if (url.endsWith('/github/repos.json')) return Promise.resolve(response([...skipped, zero, featured, normal])); - if (url.includes('/commitActivity/normal.json')) return Promise.resolve(response([{ total: 0 }, { total: 5 }, { total: 10 }])); - if (url.includes('/commitActivity/featured.json')) return Promise.reject(new Error('no activity')); - if (url.includes('/commitActivity/zero.json')) return Promise.resolve(response([{ total: 0 }])); - if (url.includes('/languages/normal.json')) return Promise.resolve(response({ 'C++': 90, JavaScript: 10 })); - if (url.includes('/languages/featured.json')) return Promise.resolve(response(null, false, 404)); - if (url.includes('/languages/zero.json')) return Promise.reject(new Error('no languages')); - if (url.endsWith('/normal/')) return Promise.resolve(response(null)); - if (url.endsWith('/featured/')) return Promise.resolve(response(null, false, 404)); - if (url.endsWith('/zero/')) return Promise.reject(new Error('site unavailable')); - throw new Error(`Unexpected URL: ${url}`); + if (url.includes('/commitActivity/former-name.json')) return Promise.resolve(response([{ total: 0 }, { total: 5 }, { total: 10 }])); + if (url.includes('/commitActivity/LizardByte/featured.json')) return Promise.reject(new Error('no activity')); + if (url.includes('/commitActivity/LizardByte/zero.json')) return Promise.resolve(response([{ total: 0 }])); + if (url.includes('/languages/former-name.json')) return Promise.resolve(response({ 'C++': 90, JavaScript: 10 })); + if (url.includes('/languages/LizardByte/featured.json')) return Promise.resolve(response(null, false, 404)); + if (url.includes('/languages/LizardByte/zero.json')) return Promise.reject(new Error('no languages')); + return baseFetch(url); }); loadScript(); await flushPromises(20); - - const cards = document.querySelectorAll('#project-container > div'); - expect(cards).toHaveLength(3); + expect(visibleCards()).toHaveLength(3); expect(document.querySelectorAll('.badge.bg-info')).toHaveLength(1); expect(document.querySelector('.readthedocs-icon').closest('a').href).toBe('https://docs.lizardbyte.dev/projects/normal'); expect(document.querySelectorAll('.language-logo')).toHaveLength(2); @@ -135,28 +153,129 @@ describe('project cards', () => { expect(activeBars).toHaveLength(2); expect(Number(activeBars[0].style.getPropertyValue('--commit-bar-opacity'))).toBeCloseTo(0.65); expect(Number(activeBars[1].style.getPropertyValue('--commit-bar-opacity'))).toBe(1); - expect(activeBars[0].style.opacity).toBe(''); expect(document.querySelectorAll('.commit-bar-empty')).toHaveLength(2); - expect(document.querySelector('a[href="https://app.lizardbyte.dev/normal/"]')).not.toBeNull(); - expect(globalThis.formatNumber).toHaveBeenCalled(); + expect(document.querySelector('.card-img-top').src).toBe(`${dashboardUrl}/github/openGraphImages/former-banner_624x312.png`); + expect(document.querySelector('.project-card-link').href).toBe(normal.homepage); + expect(visibleCards()[1].querySelector('.project-card-link').href).toBe(featured.html_url); + expect(visibleCards()[2].querySelector('.project-card-link').href).toBe(zero.html_url); + expect(document.getElementById('project-status').textContent).toBe('3 projects'); + expect(globalThis.rankingSorter).toHaveBeenCalledWith('stargazers_count', 'full_name'); + expect(baseFetch.mock.calls.every(([url]) => url === registryUrl || url.startsWith(dashboardUrl))).toBe(true); + }); + + test('distinguishes same-name repos, searches across orgs, and scopes archived search without refetching cards', async () => { + const first = project('demo', { organization: 'First', dashboard_key: 'original-demo' }); + const second = project('demo', { organization: 'Second' }); + const future = project('audio', { organization: 'FutureOrg', description: 'Movie themes' }); + globalThis.fetch = catalogFetch([first, second, future], ['FutureOrg', 'second', 'First', 'Empty']); + loadScript(); + await flushPromises(); + + const cards = visibleCards(); + expect(cards).toHaveLength(3); + expect(cards.map(card => card.querySelector('.project-organization').textContent)).toEqual(['First', 'Second', 'FutureOrg']); + expect(cards[0].querySelector('.card-img-top').src).toContain('/First/demo_624x312.png'); + expect(cards[1].querySelector('.card-img-top').src).toContain('/Second/demo_624x312.png'); + const urls = globalThis.fetch.mock.calls.map(([url]) => url); + expect(urls).toContain(`${dashboardUrl}/github/commitActivity/original-demo.json`); + expect(urls).toContain(`${dashboardUrl}/github/languages/Second/demo.json`); expect(globalThis.fetch.mock.calls.every(([, options]) => options.cache === 'no-store')).toBe(true); + expect([...document.getElementById('project-organization').options].map(option => option.value)) + .toEqual(['', 'Empty', 'First', 'FutureOrg', 'second']); + const requests = globalThis.fetch.mock.calls.length; + change('project-organization', 'First', 'change'); + expect(visibleCards()).toHaveLength(1); + expect(document.getElementById('project-status').textContent).toBe('1 project'); + change('project-search', 'SECOND DEMO', 'input'); + expect(visibleCards()).toHaveLength(0); + expect(document.getElementById('project-status').textContent).toBe('No projects match your search.'); + change('project-organization', '', 'change'); + expect(visibleCards()).toHaveLength(1); + expect(visibleCards()[0].querySelector('.project-organization').textContent).toBe('Second'); + change('project-search', ' movie THEMES ', 'input'); + expect(visibleCards()).toHaveLength(1); + expect(visibleCards()[0].querySelector('.card-title').textContent).toBe('audio'); + change('project-organization', 'Empty', 'change'); + expect(visibleCards()).toHaveLength(0); + const archive = document.getElementById('archived-projects-link'); + expect(new URL(archive.href).searchParams.get('q')).toBe('org:Empty archived:true'); + change('project-organization', '', 'change'); + change('project-search', '', 'input'); + expect(visibleCards()).toHaveLength(3); + expect(new URL(archive.href).searchParams.get('q')).toBe('org:Empty org:First org:FutureOrg org:second archived:true'); + expect(new URL(archive.href).searchParams.get('type')).toBe('repositories'); + expect(archive.classList.contains('disabled')).toBe(false); + expect(globalThis.fetch).toHaveBeenCalledTimes(requests); + }); + + test('keeps a transferred and renamed project on the supplied cache paths', async () => { + const moved = project('renamed', { + organization: 'SunshineStream', dashboard_key: 'Sunshine', + dashboard_paths: { banner_small: 'github/openGraphImages/Sunshine_624x312.png' }, + }); + globalThis.fetch = catalogFetch([moved], ['SunshineStream']); + loadScript(); + await flushPromises(); + expect(document.querySelector('.card-img-top').src).toBe(`${dashboardUrl}/github/openGraphImages/Sunshine_624x312.png`); + expect(globalThis.fetch).toHaveBeenCalledWith(`${dashboardUrl}/github/commitActivity/Sunshine.json`, expect.any(Object)); + expect(globalThis.fetch).toHaveBeenCalledWith(`${dashboardUrl}/github/languages/Sunshine.json`, expect.any(Object)); + }); + + test('normalizes HTTPS and SSH docs identities without matching another org by basename', async () => { + const moved = project('demo', { organization: 'New', dashboard_aliases: ['Old/demo', 'New/demo'] }); + const other = project('demo', { organization: 'Other' }); + const docs = [ + 'git@github.com:Old/demo.git', 'ssh://git@github.com/Old/demo.git', 'https://github.com/New/demo', + 'not a URL', 'https://example.com/Old/demo', 'https://github.com/Old', + ].map((url, index) => ({ repository: { url }, urls: { documentation: `https://docs.lizardbyte.dev/${index}` } })); + globalThis.fetch = catalogFetch([moved, other], ['New', 'Other'], docs); + loadScript(); + await flushPromises(); + expect(visibleCards()[0].querySelectorAll('.readthedocs-icon')).toHaveLength(3); + expect(visibleCards()[1].querySelectorAll('.readthedocs-icon')).toHaveLength(0); }); - test('continues without documentation data and reports repository failures', async () => { - setReadyState('complete'); - document.body.innerHTML = '
'; - globalThis.formatNumber = value => String(value); - globalThis.rankingSorter = () => () => 0; - const consoleLog = jest.spyOn(console, 'log').mockImplementation(() => {}); - const consoleError = jest.spyOn(console, 'error').mockImplementation(() => {}); + test.each(['http://sunshine.lizardbyte.dev/', 'https://koko.lizardbyte.dev/custom/path/'])( + 'uses the configured project homepage %s without probing the umbrella domain', async homepage => { + globalThis.fetch = catalogFetch([project('demo', { homepage })], ['LizardByte']); + loadScript(); + await flushPromises(); + expect(document.querySelector('.project-card-link').href).toBe(homepage); + expect(globalThis.fetch.mock.calls.some(([url]) => url === homepage)).toBe(false); + }, + ); + test.each([null, [], [''], [42], ['invalid/name']].map(value => [value]))( + 'rejects an invalid registry: %j', async organizations => { + globalThis.fetch = catalogFetch([], organizations); + loadScript(); + await flushPromises(); + expect(document.getElementById('project-status').textContent).toContain('could not be loaded'); + expect(document.getElementById('project-organization').disabled).toBe(true); + expect(document.getElementById('archived-projects-link').hasAttribute('href')).toBe(false); + }, + ); + + test('continues without docs data and reports repository failures', async () => { globalThis.fetch = jest.fn(url => { + if (url === registryUrl) return Promise.resolve(response(['LizardByte'])); if (url.endsWith('/readthedocs/projects.json')) return Promise.resolve(response(null, false, 500)); return Promise.resolve(response(null, false, 503)); }); loadScript(); await flushPromises(); - expect(consoleLog).toHaveBeenCalledWith('No ReadTheDocs project data available', expect.any(Error)); - expect(consoleError).toHaveBeenCalledWith('Error loading project data:', expect.any(Error)); + expect(console.log).toHaveBeenCalledWith('No ReadTheDocs project data available', expect.any(Error)); + expect(console.error).toHaveBeenCalledWith('Error loading project data:', expect.any(Error)); + expect(document.getElementById('project-status').textContent).toContain('could not be loaded'); + }); + + test('a registry outage does not create an unscoped archive link', async () => { + const baseFetch = catalogFetch([], ['LizardByte']); + globalThis.fetch = jest.fn(url => url === registryUrl + ? Promise.resolve(response(null, false, 503)) : baseFetch(url)); + loadScript(); + await flushPromises(); + expect(document.getElementById('project-search').disabled).toBe(true); + expect(document.getElementById('archived-projects-link').hasAttribute('href')).toBe(false); }); });