[CLI] Extract Blueprints v1-specific parts into BlueprintsV1Handler

packages/php-wasm/universal/src/lib/php-worker.ts

@@ -254,6 +254,17 @@ export class PHPWorker implements LimitedPHPApi, AsyncDisposable {
 		_private.get(this)!.php!.removeEventListener(eventType, listener);
 	}
 
+	/**
+	 * @internal
+	 * @deprecated
+	 * Do not use this method directly in the code consuming
+	 * the web API. It will change or even be removed without
+	 * a warning.
+	 */
+	protected __internal_getRequestHandler(): PHPRequestHandler {
+		return _private.get(this)!.requestHandler!;
+	}
+
 	async [Symbol.asyncDispose]() {
 		await _private.get(this)!.requestHandler?.[Symbol.asyncDispose]();
 	}

packages/playground/cli/src/cli.ts

@@ -1,8 +1,13 @@
 import { parseOptionsAndRunCLI } from './run-cli';
 
 // Do not await this as top-level await is not supported in all environments.
-parseOptionsAndRunCLI().catch(() => {
-	// process.exit(1); is here and not in parseOptionsAndRunCLI()
-	// so that we can unit test the failure modes with try/catch.
-	process.exit(1);
-});
+parseOptionsAndRunCLI().then(
+	() => {
+		process.exit(0);
+	},
+	(e) => {
+		// eslint-disable-next-line no-console
+		console.error(e);
+		process.exit(1);
+	}
+);

packages/playground/cli/src/load-balancer.ts

@@ -1,13 +1,13 @@
 import type { PHPRequest, PHPResponse, RemoteAPI } from '@php-wasm/universal';
-import type { PlaygroundCliWorker } from './worker-thread';
+import type { PlaygroundCliBlueprintV1Worker } from './worker-thread';
 
 // TODO: Let's merge worker management into PHPProcessManager
 // when we can have multiple workers in both CLI and web.
 // ¡ATTENTION!:Please don't expand upon this as an independent abstraction.
 
 // TODO: Could we just spawn a worker using the factory function to PHPProcessManager?
 type WorkerLoad = {
-	worker: RemoteAPI<PlaygroundCliWorker>;
+	worker: RemoteAPI<PlaygroundCliBlueprintV1Worker>;
 	activeRequests: Set<Promise<PHPResponse>>;
 };
 export class LoadBalancer {
@@ -19,12 +19,12 @@ export class LoadBalancer {
 		// Playground CLI initialization, as of 2025-06-11, requires that
 		// an initial worker is booted alone and initialized via Blueprint
 		// before additional workers are created based on the initialized worker.
-		initialWorker: RemoteAPI<PlaygroundCliWorker>
+		initialWorker: RemoteAPI<PlaygroundCliBlueprintV1Worker>
 	) {
 		this.addWorker(initialWorker);
 	}
 
-	addWorker(worker: RemoteAPI<PlaygroundCliWorker>) {
+	addWorker(worker: RemoteAPI<PlaygroundCliBlueprintV1Worker>) {
 		this.workerLoads.push({
 			worker,
 			activeRequests: new Set(),

packages/playground/cli/src/mounts.ts

@@ -179,7 +179,7 @@ export function expandAutoMounts(args: RunCLIArgs): RunCLIArgs {
 		// newArgs.mode = 'mount-only';
 	}
 
-	return newArgs as RunCLIArgs;
+	return newArgs;
 }
 
 export function containsFullWordPressInstallation(path: string): boolean {