@ui5/server 3.0.0-beta.4 → 3.0.0-rc.1

package/.reuse/dep5

@@ -25,7 +25,7 @@ Disclaimer: The code in this project may include calls to APIs (“API Calls”)
  parties the right to use of access any SAP External Product, through API Calls.
 
 Files: *
-Copyright: 2018-2022 SAP SE or an SAP affiliate company and UI5 Tooling contributors
+Copyright: 2018-2023 SAP SE or an SAP affiliate company and UI5 Tooling contributors
 License: Apache-2.0
 
 Files: lib/middleware/serveIndex/*
@@ -36,5 +36,5 @@ Copyright: 2010 Sencha Inc.
 License: MIT
 
 Files: lib/middleware/testRunner/*
-Copyright: 2009-2022 SAP SE or an SAP affiliate company and OpenUI5 contributors
+Copyright: 2009-2023 SAP SE or an SAP affiliate company and OpenUI5 contributors
 License: Apache-2.0

package/CHANGELOG.md

@@ -2,7 +2,29 @@
 All notable changes to this project will be documented in this file.  
 This project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
-A list of unreleased changes can be found [here](https://github.com/SAP/ui5-server/compare/v3.0.0-beta.4...HEAD).
+A list of unreleased changes can be found [here](https://github.com/SAP/ui5-server/compare/v3.0.0-rc.1...HEAD).
+
+<a name="v3.0.0-rc.1"></a>
+## [v3.0.0-rc.1] - 2023-01-23
+
+<a name="v3.0.0-rc.0"></a>
+## [v3.0.0-rc.0] - 2022-12-23
+### Breaking Changes
+- Remove "/proxy" endpoint ([#550](https://github.com/SAP/ui5-server/issues/550)) [`4bdf839`](https://github.com/SAP/ui5-server/commit/4bdf839e96f67ddbc4cb2a18216921d54df4006e)
+
+### BREAKING CHANGE
+
+This removes the "/proxy" endpoint and the corresponding
+"connectUi5Proxy" middleware from the standard ui5-server.
+Internally, this middleware made use of the connect-openui5 proxy
+implementation (https://github.com/SAP/connect-openui5#proxy).
+
+More sophisticated proxy solutions for ui5-server are already available
+in the form of custom middleware extensions from the UI5-community.
+
+The UI5 Team might provide a dedicated custom middleware extension,
+with similar functionality, in the future.
+
 
 <a name="v3.0.0-beta.4"></a>
 ## [v3.0.0-beta.4] - 2022-12-01
@@ -308,6 +330,8 @@ Only Node.js v10 or higher is supported.
 <a name="v0.0.1"></a>
 ## v0.0.1 - 2018-06-06
 
+[v3.0.0-rc.1]: https://github.com/SAP/ui5-server/compare/v3.0.0-rc.0...v3.0.0-rc.1
+[v3.0.0-rc.0]: https://github.com/SAP/ui5-server/compare/v3.0.0-beta.4...v3.0.0-rc.0
 [v3.0.0-beta.4]: https://github.com/SAP/ui5-server/compare/v3.0.0-beta.3...v3.0.0-beta.4
 [v3.0.0-beta.3]: https://github.com/SAP/ui5-server/compare/v3.0.0-beta.2...v3.0.0-beta.3
 [v3.0.0-beta.2]: https://github.com/SAP/ui5-server/compare/v3.0.0-beta.1...v3.0.0-beta.2

package/LICENSE.txt

@@ -186,7 +186,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright 2018-2021 SAP SE or an SAP affiliate company and UI5 Tooling contributors
+   Copyright 2018-2023 SAP SE or an SAP affiliate company and UI5 Tooling contributors
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

package/README.md

@@ -10,7 +10,9 @@
 [![Coverage Status](https://coveralls.io/repos/github/SAP/ui5-server/badge.svg)](https://coveralls.io/github/SAP/ui5-server)
 
 ## Documentation
-Can be found here: [sap.github.io/ui5-tooling](https://sap.github.io/ui5-tooling/pages/Server/)
+UI5 Server documentation can be found here: [sap.github.io/ui5-tooling](https://sap.github.io/ui5-tooling/v3/pages/Server/)
+
+The UI5 Server API Reference can be found here: [`@ui5/server`](https://sap.github.io/ui5-tooling/v3/api/module-@ui5_server.html)
 
 ## Contributing
 Please check our [Contribution Guidelines](https://github.com/SAP/ui5-tooling/blob/main/CONTRIBUTING.md).

package/jsdoc.json

@@ -27,7 +27,7 @@
 	"openGraph": {
 		"title": "UI5 Tooling - API Reference",
 		"type": "website",
-		"image": "https://sap.github.io/ui5-tooling/docs/images/UI5_logo_wide.png",
+		"image": "https://sap.github.io/ui5-tooling/v3/images/UI5_logo_wide.png",
 		"site_name": "UI5 Tooling - API Reference",
 		"url": "https://sap.github.io/ui5-tooling/"
 	},

package/lib/middleware/MiddlewareManager.js

@@ -96,6 +96,14 @@ class MiddlewareManager {
 		if (beforeMiddleware || afterMiddleware) {
 			const refMiddlewareName = beforeMiddleware || afterMiddleware;
 			let refMiddlewareIdx = this.middlewareExecutionOrder.indexOf(refMiddlewareName);
+
+			if (refMiddlewareName === "connectUi5Proxy") {
+				throw new Error(
+					`Standard middleware "connectUi5Proxy", referenced by middleware "${middlewareName}" ` +
+					`in project ${this.middlewareUtil.getProject()}, ` +
+					`has been removed in this version of UI5 Tooling and can't be referenced anymore. ` +
+					`Please see the migration guide at https://sap.github.io/ui5-tooling/updates/migrate-v3/`);
+			}
 			if (refMiddlewareIdx === -1) {
 				throw new Error(`Could not find middleware ${refMiddlewareName}, referenced by custom ` +
 					`middleware ${middlewareName}`);
@@ -223,9 +231,6 @@ class MiddlewareManager {
 				};
 			}
 		});
-		await this.addMiddleware("connectUi5Proxy", {
-			mountPath: "/proxy"
-		});
 		// Handle anything but read operations *before* the serveIndex middleware
 		//	as it will reject them with a 405 (Method not allowed) instead of 404 like our old tooling
 		await this.addMiddleware("nonReadRequests");
@@ -295,7 +300,7 @@ class MiddlewareManager {
 					const specVersion = customMiddleware.getSpecVersion();
 					if (specVersion.gte("3.0")) {
 						params.options.middlewareName = middlewareName;
-						params.log = logger.getGroupLogger(`server:custom-middleware:${middlewareDef.name}`);
+						params.log = logger.getLogger(`server:custom-middleware:${middlewareDef.name}`);
 					}
 					const middlewareUtilInterface = middlewareUtil.getInterface(specVersion);
 					if (middlewareUtilInterface) {

package/lib/middleware/MiddlewareUtil.js

@@ -108,6 +108,7 @@ class MiddlewareUtil {
 	 * @property {Function} getNamespace Get the project namespace
 	 * @property {Function} getRootReader Get the project rootReader
 	 * @property {Function} getReader Get the project reader
+	 * @property {Function} getSourcePath Get the local File System path of the project's source directory
 	 * @property {Function} getCustomConfiguration Get the project Custom Configuration
 	 * @property {Function} isFrameworkProject Check whether the project is a UI5-Framework project
 	 */
@@ -119,15 +120,25 @@ class MiddlewareUtil {
 	 * This method is only available to custom server middleware extensions defining
 	 * <b>Specification Version 3.0 and above</b>.
 	 *
-	 * @param {string} [projectName] Name of the project to retrieve. Defaults to the project currently being built
+	 * @param {string|@ui5/fs/Resource} [projectNameOrResource]
+	 * Name of the project to retrieve or a Resource instance to retrieve the associated project for.
+	 * Defaults to the name of the current root project
 	 * @returns {@ui5/project/build/helpers/MiddlewareUtill~ProjectInterface|undefined}
-	 * project instance or undefined if the project is unknown to the graph
+	 * Specification Version-dependent interface to the Project instance or <code>undefined</code>
+	 * if the project name is unknown or the provided resource is not associated with any project.
 	 * @public
 	 */
-	getProject(projectName) {
-		if (projectName) {
-			return this._graph.getProject(projectName);
+	getProject(projectNameOrResource) {
+		if (projectNameOrResource) {
+			if (typeof projectNameOrResource === "string" || projectNameOrResource instanceof String) {
+				// A project name has been provided
+				return this._graph.getProject(projectNameOrResource);
+			} else {
+				// A Resource instance has been provided
+				return projectNameOrResource.getProject();
+			}
 		}
+		// No parameter has been provided, default to the root project
 		return this._project;
 	}
 
@@ -139,7 +150,8 @@ class MiddlewareUtil {
 	 * This method is only available to custom server middleware extensions defining
 	 * <b>Specification Version 3.0 and above</b>.
 	 *
-	 * @param {string} [projectName] Name of the project to retrieve. Defaults to the project currently being built
+	 * @param {string} [projectName] Name of the project to retrieve.
+	 * Defaults to the name of the current root project
 	 * @returns {string[]} Names of all direct dependencies
 	 * @throws {Error} If the requested project is unknown to the graph
 	 * @public
@@ -214,7 +226,8 @@ class MiddlewareUtil {
 				const baseProjectInterface = {};
 				bindFunctions(project, baseProjectInterface, [
 					"getType", "getName", "getVersion", "getNamespace",
-					"getRootReader", "getReader", "getCustomConfiguration", "isFrameworkProject"
+					"getRootReader", "getReader", "getSourcePath",
+					"getCustomConfiguration", "isFrameworkProject"
 				]);
 				return baseProjectInterface;
 			};

package/lib/middleware/middlewareRepository.js

@@ -6,7 +6,6 @@ const middlewareInfos = {
 	serveIndex: {path: "./serveIndex.js"},
 	discovery: {path: "./discovery.js"},
 	versionInfo: {path: "./versionInfo.js"},
-	connectUi5Proxy: {path: "./connectUi5Proxy.js"},
 	serveThemes: {path: "./serveThemes.js"},
 	testRunner: {path: "./testRunner.js"},
 	nonReadRequests: {path: "./nonReadRequests.js"}

package/lib/middleware/serveIndex.js

@@ -49,7 +49,7 @@ function createResourceInfo(resource) {
 	const isDir = stat.isDirectory();
 	return {
 		path: resource.getPath() + (isDir ? "/" : ""),
-		name: resource._name + (isDir ? "/" : ""),
+		name: resource.getName() + (isDir ? "/" : ""),
 		isDir: isDir,
 		mimetype: isDir ? "" : getMimeType(resource),
 		lastModified: new Date(stat.mtime).toLocaleString(),

package/lib/middleware/serveResources.js

@@ -84,7 +84,7 @@ function createMiddleware({resources, middlewareUtil}) {
 					stream.setEncoding("utf8");
 					stream = stream.pipe(replaceStream("${version}", resource.getProject().getVersion()));
 				} else {
-					log.verbose("Project missing from resource %s", pathname);
+					log.verbose(`Project missing from resource ${pathname}"`);
 				}
 			}
 

package/lib/sslUtil.js

@@ -1,15 +1,9 @@
 import os from "node:os";
-import fs from "node:fs";
-import logger from "@ui5/logger";
-const log = logger.getLogger("server:sslUtil");
-import {promisify} from "node:util";
-
-const stat = promisify(fs.stat);
+import {stat, readFile, writeFile, mkdir} from "node:fs/promises";
 import path from "node:path";
+import logger from "@ui5/logger";
 
-const readFile = promisify(fs.readFile);
-const writeFile = promisify(fs.writeFile);
-
+const log = logger.getLogger("server:sslUtil");
 
 /**
  * @private
@@ -87,13 +81,11 @@ async function createAndInstallCertificate(keyPath, certPath) {
 
 	const {key, cert} = await devCert("UI5Tooling");
 
-	const {default: makeDir} = await import("make-dir");
-
 	await Promise.all([
 		// Write certificates to the ui5 certificate folder
 		// such that they are used by default upon next startup
-		makeDir(path.dirname(keyPath)).then(() => writeFile(keyPath, key)),
-		makeDir(path.dirname(certPath)).then(() => writeFile(certPath, cert))
+		mkdir(path.dirname(keyPath), {recursive: true}).then(() => writeFile(keyPath, key)),
+		mkdir(path.dirname(certPath), {recursive: true}).then(() => writeFile(certPath, cert))
 	]);
 	return {key, cert};
 }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@ui5/server",
-	"version": "3.0.0-beta.4",
+	"version": "3.0.0-rc.1",
 	"description": "UI5 Tooling - Server",
 	"author": {
 		"name": "SAP SE",
@@ -35,7 +35,6 @@
 		"unit": "rimraf test/tmp && ava",
 		"unit-verbose": "rimraf test/tmp && cross-env UI5_LOG_LVL=verbose ava --verbose --serial",
 		"unit-watch": "npm run unit -- --watch",
-		"unit-nyan": "npm run unit -- --tap | tnyan",
 		"unit-xunit": "rimraf test/tmp && ava --node-arguments=\"--experimental-loader=@istanbuljs/esm-loader-hook\" --tap | tap-xunit --dontUseCommentsAsTestNames=true > test-results.xml",
 		"unit-inspect": "cross-env UI5_LOG_LVL=verbose ava debug --break",
 		"coverage": "rimraf test/tmp && nyc ava --node-arguments=\"--experimental-loader=@istanbuljs/esm-loader-hook\"",
@@ -115,12 +114,11 @@
 		"url": "git@github.com:SAP/ui5-server.git"
 	},
 	"dependencies": {
-		"@ui5/builder": "^3.0.0-beta.4",
-		"@ui5/fs": "^3.0.0-beta.4",
-		"@ui5/logger": "^3.0.1-beta.1",
+		"@ui5/builder": "^3.0.0-rc.2",
+		"@ui5/fs": "^3.0.0-rc.3",
+		"@ui5/logger": "^3.0.1-rc.1",
 		"body-parser": "^1.20.1",
 		"compression": "^1.7.4",
-		"connect-openui5": "^0.10.3",
 		"cors": "^2.8.5",
 		"devcert-sanscache": "^0.4.8",
 		"escape-html": "^1.0.3",
@@ -128,35 +126,33 @@
 		"express": "^4.18.2",
 		"fresh": "^0.5.2",
 		"graceful-fs": "^4.2.10",
-		"make-dir": "^3.1.0",
 		"mime-types": "^2.1.35",
 		"parseurl": "^1.3.3",
 		"portscanner": "^2.2.0",
 		"replacestream": "^4.0.3",
 		"router": "^1.3.7",
 		"spdy": "^4.0.2",
-		"yesno": "^0.3.1"
+		"yesno": "^0.4.0"
 	},
 	"devDependencies": {
 		"@istanbuljs/esm-loader-hook": "^0.2.0",
-		"@ui5/project": "^3.0.0-beta.4",
-		"ava": "^5.1.0",
+		"@ui5/project": "^3.0.0-rc.3",
+		"ava": "^5.1.1",
 		"chokidar-cli": "^3.0.0",
 		"cross-env": "^7.0.3",
 		"depcheck": "^1.4.3",
-		"docdash": "^2.0.0",
-		"eslint": "^8.28.0",
+		"docdash": "^2.0.1",
+		"eslint": "^8.32.0",
 		"eslint-config-google": "^0.14.0",
-		"eslint-plugin-ava": "^13.2.0",
-		"eslint-plugin-jsdoc": "^39.6.4",
-		"esmock": "^2.0.9",
+		"eslint-plugin-ava": "^14.0.0",
+		"eslint-plugin-jsdoc": "^39.6.7",
+		"esmock": "^2.1.0",
 		"jsdoc": "^3.6.11",
 		"nyc": "^15.1.0",
 		"open-cli": "^7.1.0",
-		"rimraf": "^3.0.2",
-		"sinon": "^14.0.2",
-		"supertest": "^6.3.1",
-		"tap-nyan": "^1.1.0",
+		"rimraf": "^4.1.1",
+		"sinon": "^15.0.1",
+		"supertest": "^6.3.3",
 		"tap-xunit": "^2.4.1"
 	}
 }

package/lib/middleware/connectUi5Proxy.js

@@ -1,9 +0,0 @@
-import ui5connect from "connect-openui5";
-
-function createMiddleware() {
-	return ui5connect.proxy({
-		secure: false
-	});
-}
-
-export default createMiddleware;