feat!: release v2 (#6545)

Co-authored-by: Artur <145776561+arturict@users.noreply.github.com> Co-authored-by: arturict <arturict@users.noreply.github.com> Co-authored-by: Thomas <thomas@ajnart.fr> Co-authored-by: Afonso Jorge Ramos <afonsojorgeramos@gmail.com> Co-authored-by: Danura30082 <danura30082+github@gmail.com> Co-authored-by: Kushie <122986913+kushiemoon-dev@users.noreply.github.com> Co-authored-by: ajnart <thomas@ajnart.fr> Co-authored-by: ajnart <thomas@ajnart.dev> Co-authored-by: chenjun <chenjun@foxmail.com> Co-authored-by: Wikibear <wikibear@users.noreply.github.com> Co-authored-by: Bergasha <bergasha@gmail.com> Co-authored-by: leafyelin <43306196+leafyelin@users.noreply.github.com> Co-authored-by: Lucas Araujo <lucas.lra@gmail.com> Co-authored-by: GreenMonito <86085570+GreenMonito@users.noreply.github.com> Co-authored-by: Nerdy-Technician <roffo@nerdy-technician.social> Co-authored-by: Jun <34545896+jcstrong@users.noreply.github.com> Co-authored-by: Edmond Abraham <54119952+gitedmond@users.noreply.github.com> Co-authored-by: thrawnx <tight.bulb9384@fastmail.com> Co-authored-by: Chris <58918656+nordada@users.noreply.github.com> Co-authored-by: yi111 <153097222+Yi-111-a@users.noreply.github.com> Co-authored-by: Yanis <naamaneyanis@gmail.com> Co-authored-by: Wikibear <me@sej.de> Co-authored-by: alessiottavo <93441886+alessiottavo@users.noreply.github.com>
2026-10-02 21:00:14 +02:00
1 parent 3a53bb77aa
commit fcd7c979df
@@ -0,0 +1,43 @@
+import assert from "node:assert/strict";
+import { readFile, writeFile } from "node:fs/promises";
+
+import { openApiDocument } from "../packages/api/src/open-api";
+
+const baseUrl = "http://localhost:3000";
+const schemaPath = "apps/docs/public/api/open-api-schema.json";
+const writeMode = process.argv.slice(2).includes("--write");
+const serialized = `${JSON.stringify(openApiDocument(baseUrl), null, 2)}\n`;
+const generated = JSON.parse(serialized) as unknown;
+
+function assertOpenApiDocument(value: unknown): asserts value is { openapi: string; paths: Record<string, unknown> } {
+  assert.ok(typeof value === "object" && value !== null && !Array.isArray(value), "OpenAPI document must be an object");
+  assert.equal(typeof Reflect.get(value, "openapi"), "string", "OpenAPI document must declare its version");
+
+  const paths = Reflect.get(value, "paths");
+  assert.ok(
+    typeof paths === "object" && paths !== null && !Array.isArray(paths),
+    "OpenAPI document must contain paths",
+  );
+}
+
+assertOpenApiDocument(generated);
+
+if (writeMode) {
+  await writeFile(schemaPath, serialized, "utf8");
+  console.log(`OpenAPI schema updated (${Object.keys(generated.paths).length} paths)`);
+}
+
+const checkedIn = JSON.parse(await readFile(schemaPath, "utf8")) as unknown;
+assertOpenApiDocument(checkedIn);
+
+try {
+  assert.deepStrictEqual(checkedIn, generated);
+} catch {
+  console.error(
+    "The checked-in OpenAPI schema is stale. Regenerate it from openApiDocument and update apps/docs/public/api/open-api-schema.json.",
+  );
+  process.exit(1);
+}
+
+// The API import graph owns background handles that are irrelevant to this one-shot script.
+process.exit(0);