chore(e2e): update start-nextcloud-server.mjs to mirror nextcloud/text pattern

- Import and call `waitOnNextcloud` to ensure NC is ready before tests start
- Import and call `configureNextcloud(['viewer', 'files_pdfviewer'])` in startup script
- Use `git ls-remote --refs` to check if `stable${maxVersion}` branch exists;
  fall back to `master` if not (with error handling for offline environments)
- Add SIGTERM/SIGINT handlers for clean container shutdown
- Remove debug.spec.ts (investigation-only file from previous session)

Co-authored-by: szaimen <42591237+szaimen@users.noreply.github.com>
Agent-Logs-Url: https://github.com/nextcloud/files_pdfviewer/sessions/511d0124-9021-405e-9a82-4ef2221ffb66

Author: Copilot

playwright/e2e/debug.spec.ts

@@ -3,35 +3,51 @@
  * SPDX-License-Identifier: AGPL-3.0-or-later
  */
 
-import { startNextcloud, stopNextcloud } from '@nextcloud/e2e-test-server/docker'
+import {
+	configureNextcloud,
+	startNextcloud,
+	stopNextcloud,
+	waitOnNextcloud,
+} from '@nextcloud/e2e-test-server/docker'
 import { readFileSync } from 'fs'
+import { execSync } from 'node:child_process'
 
-const start = async () => {
-	return await startNextcloud(getBranch(), true, {
+async function start() {
+	const appinfo = readFileSync('appinfo/info.xml').toString()
+	const maxVersion = appinfo.match(
+		/<nextcloud min-version="\d+" max-version="(\d\d+)" \/>/,
+	)?.[1]
+
+	let branch = 'master'
+	if (maxVersion) {
+		try {
+			const refs = execSync('git ls-remote --refs').toString('utf-8')
+			branch = refs.includes(`refs/heads/stable${maxVersion}`)
+				? `stable${maxVersion}`
+				: branch
+		} catch {
+			// If we cannot check remote refs (e.g., no network), fall back to master
+		}
+	}
+
+	return await startNextcloud(branch, true, {
 		exposePort: 8089,
 	})
 }
 
-const getBranch = () => {
-	try {
-		const appinfo = readFileSync('appinfo/info.xml').toString()
-		const maxVersion = appinfo.match(
-			/<nextcloud min-version="\d+" max-version="(\d\d+)" \/>/,
-		)?.[1]
-		return maxVersion ? `stable${maxVersion}` : undefined
-	} catch (error) {
-		if (error.code === 'ENOENT') {
-			console.warn('No appinfo/info.xml found. Using default server branch.')
-		}
-	}
+async function stop() {
+	process.stderr.write('Stopping Nextcloud server…\n')
+	await stopNextcloud()
+	process.exit(0)
 }
 
+process.on('SIGTERM', stop)
+process.on('SIGINT', stop)
+
 // Start the Nextcloud docker container
-await start()
-// Listen for process to exit (tests done) and shut down the docker container
-process.on('beforeExit', () => {
-	stopNextcloud()
-})
+const ip = await start()
+await waitOnNextcloud(ip)
+await configureNextcloud(['viewer', 'files_pdfviewer'])
 
 // Idle to wait for shutdown
 while (true) {