feat(forges): support Codeberg

Codeberg is a public instance of Forgejo.

Ref #10

Author: Linkid

DOCUMENTATION.md

@@ -108,10 +108,12 @@ For GitHub, create a [personal access token][gh-token] (classic or
 fine-grained) — no scope is required for public repositories; grant repository
 read access for private ones. For Bitbucket Cloud, create a
 [repository, project or workspace access token][bb-token] (or an API token)
-with pull-request read access.
+with pull-request read access. For Codeberg, create an [access token][cb-token]
+in your account settings with repository read scope.
 
 [gh-token]: https://github.com/settings/tokens
 [bb-token]: https://support.atlassian.com/bitbucket-cloud/docs/access-tokens/
+[cb-token]: https://docs.codeberg.org/advanced/access-token/
 
 ## Forges
 
@@ -149,7 +151,8 @@ So, to add a new forge:
 
 Supported forges:
 - **GitHub**: https://docs.github.com/en/rest/pulls
-- **Bitbucket** (Cloud): https://developer.atlassian.com/cloud/bitbucket/rest/api-group-pullrequests/.
+- **Bitbucket** (Cloud): https://developer.atlassian.com/cloud/bitbucket/rest/api-group-pullrequests/
+- **Codeberg** (Forgejo, Gitea-compatible API): https://forgejo.org/docs/latest/user/api-usage/.
 
 ## Internationalization
 

README.md

@@ -23,3 +23,4 @@ API rate limit and list pull requests from private repositories.
 
 - GitHub
 - Bitbucket
+- Codeberg

forges.js

@@ -130,8 +130,60 @@ export const bitbucket = {
     },
 }
 
+// Codeberg is a public instance of Forgejo (a Gitea fork), so it speaks the
+// Gitea-compatible REST API served at https://codeberg.org/api/v1.
+// API docs: https://forgejo.org/docs/latest/user/api-usage/
+export const codeberg = {
+    label: "Codeberg",
+    hostnames: ["codeberg.org"],
+    base_url: "https://codeberg.org/api/v1",
+
+    parseUrl(url) {
+        // file view: /{owner}/{repo}/src/{branch|commit|tag}/{ref}/{filepath}
+        const m = url.pathname.match(
+            "^/(?<projectKey>[^/]+)/(?<repoSlug>[^/]+)/src/[^/]+/[^/]+/(?<filepath>.+)$")
+        if (!m) return null
+        return { ...m.groups, origin: url.origin }
+    },
+
+    listPRsUrl(info) {
+        return `${this.base_url}/repos/${info.projectKey}/${info.repoSlug}/pulls`
+    },
+
+    // the list endpoint returns a JSON array of PRs
+    pullRequests(data) {
+        return data
+    },
+
+    filesUrl(info, pr) {
+        return `${this.base_url}/repos/${info.projectKey}/${info.repoSlug}/pulls/${this.prNumber(pr)}/files`
+    },
+
+    filenames(files) {
+        return files.map(file => file.filename)
+    },
+
+    prNumber(pr) {
+        return pr.number
+    },
+
+    prWebUrl(info, prNumber) {
+        return `${info.origin}/${info.projectKey}/${info.repoSlug}/pulls/${prNumber}`
+    },
+
+    // Codeberg exposes no simple rate-limit endpoint.
+    rateLimit: null,
+
+    // Codeberg accepts a personal access token via the Gitea `token` scheme.
+    tokenStorageKey: "codebergToken",
+
+    authHeader(token) {
+        return { Authorization: `token ${token}` }
+    },
+}
+
 // registry of forges matched by a static hostname
-const staticForges = [github, bitbucket]
+const staticForges = [github, bitbucket, codeberg]
 
 // pick a forge adapter for a page hostname (null if none matches).
 export function forgeForHostname(hostname) {

manifest.json

@@ -53,6 +53,7 @@
   ],
   "host_permissions": [
     "*://api.github.com/*",
-    "*://api.bitbucket.org/*"
+    "*://api.bitbucket.org/*",
+    "*://codeberg.org/*"
   ]
 }

tests/forges.test.js

@@ -1,7 +1,7 @@
 import { test } from "node:test"
 import assert from "node:assert/strict"
 
-import { github, bitbucket, forgeForHostname } from "../forges.js"
+import { github, bitbucket, codeberg, forgeForHostname } from "../forges.js"
 
 //
 // forgeForHostname
@@ -14,6 +14,10 @@ test("forgeForHostname matches bitbucket.org", () => {
     assert.equal(forgeForHostname("bitbucket.org"), bitbucket)
 })
 
+test("forgeForHostname matches codeberg.org", () => {
+    assert.equal(forgeForHostname("codeberg.org"), codeberg)
+})
+
 test("forgeForHostname matches a subdomain containing the hostname", () => {
     // hostnames are matched as substrings of the page hostname
     assert.equal(forgeForHostname("www.github.com"), github)
@@ -189,3 +193,70 @@ test("bitbucket.authHeader builds a Bearer Authorization header", () => {
         Authorization: "Bearer bb_secret",
     })
 })
+
+//
+// codeberg adapter (Forgejo / Gitea-compatible API)
+//
+test("codeberg.parseUrl extracts owner, repo and filepath from a src URL", () => {
+    const url = new URL("https://codeberg.org/forgejo/forgejo/src/branch/forgejo/README.md")
+    assert.deepEqual(codeberg.parseUrl(url), {
+        projectKey: "forgejo",
+        repoSlug: "forgejo",
+        filepath: "README.md",
+        origin: "https://codeberg.org",
+    })
+})
+
+test("codeberg.parseUrl keeps nested file paths intact", () => {
+    const url = new URL("https://codeberg.org/acme/widget/src/commit/deadbeef/dir/app.js")
+    assert.equal(codeberg.parseUrl(url).filepath, "dir/app.js")
+})
+
+test("codeberg.parseUrl returns null for a non-file URL", () => {
+    assert.equal(codeberg.parseUrl(new URL("https://codeberg.org/acme/widget")), null)
+})
+
+test("codeberg.listPRsUrl builds the pulls endpoint", () => {
+    const info = { projectKey: "acme", repoSlug: "widget" }
+    assert.equal(
+        codeberg.listPRsUrl(info),
+        "https://codeberg.org/api/v1/repos/acme/widget/pulls")
+})
+
+test("codeberg.filesUrl builds the files endpoint for a PR", () => {
+    const info = { projectKey: "acme", repoSlug: "widget" }
+    assert.equal(
+        codeberg.filesUrl(info, { number: 42 }),
+        "https://codeberg.org/api/v1/repos/acme/widget/pulls/42/files")
+})
+
+test("codeberg.prWebUrl builds the web URL of a PR", () => {
+    const info = { projectKey: "acme", repoSlug: "widget", origin: "https://codeberg.org" }
+    assert.equal(
+        codeberg.prWebUrl(info, 42),
+        "https://codeberg.org/acme/widget/pulls/42")
+})
+
+test("codeberg.prNumber reads the number off a PR object", () => {
+    assert.equal(codeberg.prNumber({ number: 7, title: "ignored" }), 7)
+})
+
+test("codeberg.pullRequests returns the list response as-is", () => {
+    const prs = [{ number: 1 }, { number: 2 }]
+    assert.equal(codeberg.pullRequests(prs), prs)
+})
+
+test("codeberg.filenames maps files to their filename", () => {
+    const files = [{ filename: "a.js" }, { filename: "dir/b.js" }]
+    assert.deepEqual(codeberg.filenames(files), ["a.js", "dir/b.js"])
+})
+
+test("codeberg exposes no rate-limit endpoint", () => {
+    assert.equal(codeberg.rateLimit, null)
+})
+
+test("codeberg.authHeader builds a token Authorization header", () => {
+    assert.deepEqual(codeberg.authHeader("cb_secret"), {
+        Authorization: "token cb_secret",
+    })
+})