Update deps and Scalar docs API

README.md

@@ -47,7 +47,7 @@ Each service documents its own endpoints and behaviour:
 | Extensions     | `/extensions/v1`, `/extensions/v2` | [`src/services/extensions/v2/README.md`](src/services/extensions/v2/README.md)         |
 | Previews       | `/previews/v1`                     | [`src/services/previews/v1/README.md`](src/services/previews/v1/README.md)             |
 
-Extensions v2 and Previews v1 also publish a live OpenAPI document (`/extensions/v2/openapi.json`, `/previews/v1/openapi.json`) and a reference UI (`/extensions/v2/docs`, `/previews/v1/docs`).
+Extensions v2 and Previews v1 also publish a live OpenAPI document (`/extensions/v2/docs/openapi.json`, `/previews/v1/docs/openapi.json`) and a reference UI (`/extensions/v2/docs`, `/previews/v1/docs`).
 
 ## Configuration
 

src/services/extensions/v2/README.md

@@ -10,7 +10,7 @@ This service owns the complete Extensions domain and its `DB_EXTENSIONS` schema:
 
 Endpoints are not listed here. The service publishes its own contract:
 
-- **OpenAPI document:** `GET /extensions/v2/openapi.json`
+- **OpenAPI document:** `GET /extensions/v2/docs/openapi.json`
 - **Reference UI:** `GET /extensions/v2/docs`
 
 ## The Extension Lifecycle

src/services/extensions/v2/index.ts

@@ -57,21 +57,20 @@ registerModerationRoutes(extensionsV2);
 // are covered by the same migration 0020 check.
 registerDeveloperProfileRoutes(extensionsV2);
 
-extensionsV2.doc31("/openapi.json", {
-  openapi: "3.1.0",
-  info: {
-    title: "FOSSBilling Extensions API (v2)",
-    version: "2.0.0",
-    description:
-      "Self-service extension publishing, ownership, moderation, and public browsing. v1 (/extensions/v1) remains available for existing integrations."
-  },
-  servers: [{ url: "/extensions/v2" }]
-});
-
-extensionsV2.get(
+extensionsV2.route(
   "/docs",
-  Scalar({
-    url: "/extensions/v2/openapi.json",
+  Scalar.serve({
+    document: () => 
+      extensionsV2.getOpenAPI31Document({
+        openapi: "3.1.0",
+        info: {
+          title: "FOSSBilling Extensions API (v2)",
+          version: "2.0.0",
+          description:
+            "Self-service extension publishing, ownership, moderation, and public browsing. v1 (/extensions/v1) remains available for existing integrations."
+        },
+        servers: [{ url: "/extensions/v2" }],
+      }),
     pageTitle: "FOSSBilling Extensions API (v2)",
     agent: { disabled: true },
     documentDownloadType: "none",
@@ -86,6 +85,7 @@ extensionsV2.get(
       go: true,
       java: true,
       js: ["axios", "jquery", "ofetch"],
+      julia: true,
       kotlin: true,
       node: ["axios", "ofetch", "undici"],
       objc: true,

src/services/previews/v1/README.md

@@ -26,7 +26,7 @@ it only resolves and redirects.
 
 Endpoints are not listed here. The service publishes its own contract:
 
-- **OpenAPI document:** `GET /previews/v1/openapi.json`
+- **OpenAPI document:** `GET /previews/v1/docs/openapi.json`
 - **Reference UI:** `GET /previews/v1/docs`
 
 ## Resource Model

src/services/previews/v1/index.ts

@@ -30,26 +30,48 @@ registerMainRoutes(previewsV1);
 registerPrRoutes(previewsV1);
 registerCommitRoutes(previewsV1);
 
-previewsV1.doc31("/openapi.json", {
-  openapi: "3.1.0",
-  info: {
-    title: "FOSSBilling Previews API (v1)",
-    version: "1.0.0",
-    description:
-      "Read-only lookup of FOSSBilling preview builds - the current main preview and per-PR/per-commit builds produced by FOSSBilling/FOSSBilling's GitHub Actions workflows."
-  },
-  servers: [{ url: "/previews/v1" }]
-});
-
-previewsV1.get(
+previewsV1.route(
   "/docs",
-  Scalar({
-    url: "/previews/v1/openapi.json",
+  Scalar.serve({
+    document: () => 
+      previewsV1.getOpenAPI31Document({
+        openapi: "3.1.0",
+        info: {
+          title: "FOSSBilling Previews API (v1)",
+          version: "1.0.0",
+          description:
+            "Read-only lookup of FOSSBilling preview builds - the current main preview and per-PR/per-commit builds produced by FOSSBilling/FOSSBilling's GitHub Actions workflows."
+        },
+        servers: [{ url: "/previews/v1" }]
+      }),
     pageTitle: "FOSSBilling Previews API (v1)",
     agent: { disabled: true },
     documentDownloadType: "none",
     hideClientButton: true,
     hideModels: true,
+      hiddenClients: {
+      c: true,
+      clojure: true,
+      csharp: true,
+      dart: true,
+      fsharp: true,
+      go: true,
+      java: true,
+      js: ["axios", "jquery", "ofetch"],
+      julia: true,
+      kotlin: true,
+      node: ["axios", "ofetch", "undici"],
+      objc: true,
+      ocaml: true,
+      php: ["guzzle", "laravel"],
+      powershell: true,
+      python: true,
+      r: true,
+      ruby: true,
+      rust: true,
+      shell: ["httpie"],
+      swift: true
+    },
     telemetry: false
   })
 );

test/services/extensions/v2/index.test.ts

@@ -12,7 +12,7 @@ setupExtensionsV2Tests();
 describe("Extensions API v2", () => {
   describe("OpenAPI docs", () => {
     it("serves a generated OpenAPI document", async () => {
-      const res = await get("/extensions/v2/openapi.json", {});
+      const res = await get("/extensions/v2/docs/openapi.json", {});
       expect(res.status).toBe(200);
       const spec = (await res.json()) as {
         openapi: string;