@ohos-ports/unlighthouse-server 0.0.0-stage → 0.18.0-beta.0

package/LICENSE.md

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016-present - Harlan Wilton
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,23 @@
-# Temporary Holding Version
+# @unlighthouse/server
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The server package for [Unlighthouse](https://github.com/harlan-zw/unlighthouse) that provides the web server and API endpoints for the scanning interface.
+
+## Usage
+
+```ts
+import { createServer } from '@unlighthouse/server'
+
+const { server, app } = await createServer()
+// server is an instance of listhen, app is an instance of h3
+await unlighthouse.setServerContext({ url: server.url, server: server.server, app })
+await unlighthouse.start()
+```
+
+## Documentation
+
+- [API Reference](https://unlighthouse.dev/api/index.html)
+- [Configuration Guide](https://unlighthouse.dev/guide/config.html)
+
+## License
+
+MIT License © 2021-PRESENT [Harlan Wilton](https://github.com/harlan-zw)

package/dist/index.d.mts

@@ -0,0 +1,10 @@
+/**
+ * Create a web server and web app to host the unlighthouse client and API on.
+ *
+ * Some providers, such as Nuxt, do not need this, so this can be safely tree-shaken.
+ */
+declare function createServer(): Promise<{
+  app: any;
+  server: any;
+}>;
+export { createServer };

package/dist/index.mjs

@@ -0,0 +1,15 @@
+import { useUnlighthouse } from "@unlighthouse/core";
+import { createApp, toNodeListener } from "h3";
+import { listen } from "listhen";
+async function createServer() {
+	const { resolvedConfig } = useUnlighthouse();
+	const app = createApp();
+	return {
+		app,
+		server: await listen(toNodeListener(app), {
+			...resolvedConfig.server,
+			open: false
+		})
+	};
+}
+export { createServer };

package/package.json

@@ -1,6 +1,53 @@
 {
   "name": "@ohos-ports/unlighthouse-server",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "type": "module",
+  "version": "0.18.0-beta.0",
+  "description": "Server for Unlighthouse",
+  "license": "MIT",
+  "homepage": "https://github.com/harlan-zw/unlighthouse#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ohos-ports/ohos-ports.git",
+    "directory": "ports/@unlighthouse/server/0.18.0"
+  },
+  "bugs": {
+    "url": "https://github.com/ohos-ports/ohos-ports/issues"
+  },
+  "keywords": [
+    "lighthouse",
+    "audit",
+    "seo",
+    "performance",
+    "server",
+    "unlighthouse"
+  ],
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs"
+    }
+  },
+  "main": "dist/index.mjs",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "files": [
+    "*.d.ts",
+    "dist",
+    "patches",
+    "postinstall.js"
+  ],
+  "engines": {
+    "node": ">=22.18.0"
+  },
+  "dependencies": {
+    "h3": "^1.15.11",
+    "listhen": "^1.10.0",
+    "@unlighthouse/core": "0.18.0"
+  },
+  "scripts": {
+    "build": "obuild",
+    "stub": "obuild --stub",
+    "postinstall": "node postinstall.js"
+  }
+}

package/patches/r1-src-chrome-launcher.patch

@@ -0,0 +1,13 @@
+--- a/node_modules/chrome-launcher/dist/utils.js	2026-09-30 12:19:33.476433594 +0800
++++ b/node_modules/chrome-launcher/dist/utils.js	2026-09-30 12:14:21.944432813 +0800
+@@ -52,7 +52,9 @@
+     }
+ }
+ export function getPlatform() {
+-    return isWsl ? 'wsl' : process.platform;
++    const platform = isWsl ? 'wsl' : process.platform;
++    // HarmonyOS (openharmony) uses Linux-compatible Chromium builds
++    if (platform === 'openharmony') return 'linux';
+     return platform;
+ }
+ export function makeTmpDir() {

package/patches/r1-src-core.patch

@@ -0,0 +1,72 @@
+--- a/node_modules/@unlighthouse/core/dist/index.mjs	2026-09-30 12:19:51.944434688 +0800
++++ b/node_modules/@unlighthouse/core/dist/index.mjs	2026-09-30 12:16:04.708432657 +0800
+@@ -1651,7 +1651,7 @@
+ 	config.scanner.exclude.push("/cdn-cgi/*");
+ 	config.chrome = defu(config.chrome || {}, {
+ 		useSystem: true,
+-		useDownloadFallback: true,
++		useDownloadFallback: process.platform === "openharmony" ? false : true,
+ 		downloadFallbackCacheDir: join(homedir(), ".unlighthouse")
+ 	});
+ 	if (config.auth) {
+@@ -1697,11 +1697,18 @@
+ 		ignoreHTTPSErrors: true
+ 	});
+ 	config.puppeteerOptions.defaultViewport = config.lighthouseOptions.screenEmulation;
+-	if (process.getuid?.() === 0) {
++	if (process.getuid?.() === 0 || process.platform === "openharmony") {
+ 		config.puppeteerOptions.args = config.puppeteerOptions.args || [];
+ 		if (!config.puppeteerOptions.args.includes("--no-sandbox")) config.puppeteerOptions.args.push("--no-sandbox");
+ 		if (!config.puppeteerOptions.args.includes("--disable-setuid-sandbox")) config.puppeteerOptions.args.push("--disable-setuid-sandbox");
+ 	}
++	if (process.platform === "openharmony") {
++		config.puppeteerOptions.args = config.puppeteerOptions.args || [];
++		if (!config.puppeteerOptions.args.includes("--no-zygote")) config.puppeteerOptions.args.push("--no-zygote");
++		if (!config.puppeteerOptions.args.includes("--single-process")) config.puppeteerOptions.args.push("--single-process");
++		if (!config.puppeteerOptions.args.includes("--disable-dev-shm-usage")) config.puppeteerOptions.args.push("--disable-dev-shm-usage");
++		if (!config.puppeteerOptions.args.includes("--disable-gpu")) config.puppeteerOptions.args.push("--disable-gpu");
++	}
+ 	let foundChrome = !!config.puppeteerOptions?.executablePath;
+ 	if (config.chrome.useSystem && !foundChrome) {
+ 		let chromePath = false;
+@@ -1721,7 +1728,7 @@
+ 		logger.debug("Testing system Chrome installation.");
+ 		const instance = await launch$1(config.puppeteerOptions).catch((e) => {
+ 			logger.warn(`Failed to launch puppeteer instance using \`${config.puppeteerOptions?.executablePath}\`.`, e);
+-
++			if (process.platform !== "openharmony") foundChrome = false;
+ 		});
+ 		if (instance) await instance.close();
+ 	}
+@@ -1732,8 +1739,14 @@
+ 			buildId: config.chrome.downloadFallbackVersion || PUPPETEER_REVISIONS.chrome,
+ 			browser: "chrome"
+ 		};
+-		const chromePath = computeExecutablePath(browserOptions);
+-		if (!existsSync(chromePath)) {
++		let chromePath;
++		try {
++			chromePath = computeExecutablePath(browserOptions);
++		} catch (e) {
++			logger.warn(`Cannot compute executable path for platform ${process.platform}. Skipping download fallback.`);
++			chromePath = null;
++		}
++		if (chromePath && !existsSync(chromePath)) {
+ 			logger.info(`Missing ${browserOptions.browser} binary, downloading v${browserOptions.buildId}...`);
+ 			let lastPercent = 0;
+ 			await install({
+@@ -1747,9 +1760,11 @@
+ 				}
+ 			});
+ 		}
+-		logger.info(`Using downloaded ${browserOptions.browser} v${browserOptions.buildId} located at: ${chromePath}`);
+-		config.puppeteerOptions.executablePath = chromePath;
+-		foundChrome = true;
++		if (chromePath) {
++			logger.info(`Using downloaded ${browserOptions.browser} v${browserOptions.buildId} located at: ${chromePath}`);
++			config.puppeteerOptions.executablePath = chromePath;
++			foundChrome = true;
++		}
+ 	}
+ 	if (!foundChrome) throw new Error("Failed to find chrome. Please ensure you have a valid chrome installed.");
+ 	const instance = await launch$1(config.puppeteerOptions).catch((e) => {

package/postinstall.js

@@ -0,0 +1,36 @@
+'use strict';
+const { execSync } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+// Find project node_modules by walking up from package dir
+function findNodeModules(startDir) {
+  let dir = startDir;
+  for (let i = 0; i < 10; i++) {
+    const candidate = path.join(dir, 'node_modules');
+    if (fs.existsSync(candidate)) return dir;
+    const parent = path.dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return null;
+}
+
+const pkgDir = __dirname;
+const projectRoot = findNodeModules(pkgDir) || path.dirname(pkgDir);
+
+const patches = [
+  { patch: path.join(pkgDir, 'patches', 'r1-src-chrome-launcher.patch'), target: 'chrome-launcher/dist/utils.js' },
+  { patch: path.join(pkgDir, 'patches', 'r1-src-core.patch'), target: '@unlighthouse/core/dist/index.mjs' }
+];
+
+for (const { patch, target } of patches) {
+  if (!fs.existsSync(patch)) continue;
+  const targetFile = path.join(projectRoot, 'node_modules', target);
+  if (!fs.existsSync(targetFile)) continue;
+  try {
+    execSync(`patch -p1 < "${patch}"`, { cwd: path.join(projectRoot, 'node_modules'), stdio: 'inherit' });
+  } catch (e) {
+    // Already patched or patch failed - continue silently
+  }
+}