feat(docs): use parameterized OpenAPI server URL

Replace the static `https://sofa.example.com/api/v1` server entry with a variable-based URL (`{protocol}://{host}:{port}/api/v1`) so the spec works against any instance out of the box. Also move the output path from `docs/openapi.json` to `docs/public/openapi.json` so the file is served as a static asset by the docs site.
This commit is contained in:
2026-03-15 14:40:33 -04:00
parent d885fc524b
commit 4ce285f721
58 changed files with 95 additions and 60 deletions
+5 -2
View File
@@ -1,4 +1,7 @@
import { OpenAPIGenerator } from "@orpc/openapi";
import {
OpenAPIGenerator,
type OpenAPIGeneratorGenerateOptions,
} from "@orpc/openapi";
import { ZodToJsonSchemaConverter } from "@orpc/zod/zod4";
import {
BackupSchema,
@@ -214,7 +217,7 @@ export function normalizeOpenApiSpec<T extends OpenApiSpec>(spec: T): T {
export async function generateOpenApiSpec(options: {
title: string;
version: string;
servers: Array<{ url: string }>;
servers: OpenAPIGeneratorGenerateOptions["servers"];
sessionCookieName: string;
tags?: Array<{ name: string; description?: string }>;
}): Promise<OpenApiSpec> {