feat(openapi): Generate merged spec for all apps

Signed-off-by: provokateurin <kate@provokateurin.de>

.reuse/dep5

@@ -342,3 +342,7 @@ License: CC0-1.0
 Files: apps/theming/fonts/OpenDyslexic-Bold.otf apps/theming/fonts/OpenDyslexic-Regular.otf
 Copyright: 2012-2019 Abbie Gonzalez <https://abbiecod.es|support@abbiecod.es>, with Reserved Font Name OpenDyslexic.
 License: OFL-1.1-RFN
+
+Files: openapi.json
+Copyright: 2025 Nextcloud GmbH and Nextcloud contributors
+License: AGPL-3.0-or-later

build/files-checker.php

@@ -69,6 +69,7 @@ $expectedFiles = [
 	'occ',
 	'ocs',
 	'ocs-provider',
+	'openapi.json',
 	'package-lock.json',
 	'package.json',
 	'psalm-ncu.xml',

build/openapi-checker.sh

@@ -3,12 +3,25 @@
 # SPDX-FileCopyrightText: 2023 Nextcloud GmbH and Nextcloud contributors
 # SPDX-License-Identifier: AGPL-3.0-or-later
 
+specs=()
 for path in core apps/*; do
 	if [ ! -f "$path/.noopenapi" ] && [[ "$(git check-ignore "$path")" != "$path" ]]; then
 		composer exec generate-spec "$path" "$path/openapi.json" || exit 1
+		if [[ "$(basename "$path")" != "core" ]]; then
+			if [ -f "$path/openapi-full.json" ]; then
+				specs+=("$path/openapi-full.json")
+			else
+				specs+=("$path/openapi.json")
+			fi;
+		fi;
 	fi
 done
 
+composer exec merge-specs -- \
+	--core core/openapi-full.json \
+	--merged openapi.json \
+	"${specs[@]}"
+
 files="$(git ls-files --exclude-standard --modified --others)"
 changed=false
 for file in $files; do