@ui5/mcp-server 0.1.6 → 0.2.1

package/CHANGELOG.md

@@ -1,5 +1,45 @@
 # Changelog
 
+## [0.2.1](https://github.com/UI5/mcp-server/compare/v0.2.0...v0.2.1) (2026-01-02)
+
+
+### Features
+
+* Add manifest validation tool ([#93](https://github.com/UI5/mcp-server/issues/93)) ([01fc0b4](https://github.com/UI5/mcp-server/commit/01fc0b4dcad81accf991b190eba99cdefdabc149))
+
+
+### Dependencies
+
+* Bump @modelcontextprotocol/sdk from 1.24.3 to 1.25.0 ([10250cf](https://github.com/UI5/mcp-server/commit/10250cf2c43e1e93cc3f1afeec6c3a7de7873cb7))
+* Bump @modelcontextprotocol/sdk from 1.25.0 to 1.25.1 ([d7f8fea](https://github.com/UI5/mcp-server/commit/d7f8fea9c3ede27d2379222c3b5cea87766d2aaf))
+* Bump @ui5/linter from 1.20.5 to 1.20.6 ([24de07d](https://github.com/UI5/mcp-server/commit/24de07d4eb4d27669fcc74213dd667269b2a3ab3))
+* Bump @ui5/linter from 1.20.6 to 1.20.7 ([ed52e26](https://github.com/UI5/mcp-server/commit/ed52e2636c2d69e0900e3c5e6041d5b5978759e9))
+* Bump fast-xml-parser from 5.3.2 to 5.3.3 ([709b96b](https://github.com/UI5/mcp-server/commit/709b96bee4a2f6b8bc70c9fd7967f6720d44dea6))
+* Bump globby from 16.0.0 to 16.1.0 ([af274e0](https://github.com/UI5/mcp-server/commit/af274e05c4d6c1ac47950e3abb4b445f835db404))
+* Bump qs from 6.14.0 to 6.14.1 ([cb2871f](https://github.com/UI5/mcp-server/commit/cb2871f985d4086a825cefdf80f596656b5bb43d))
+* Bump zod from 4.1.13 to 4.2.0 ([5888a2b](https://github.com/UI5/mcp-server/commit/5888a2b57efa38da01adea45c51615d8c7114da5))
+* Bump zod from 4.2.0 to 4.2.1 ([d2e746a](https://github.com/UI5/mcp-server/commit/d2e746a1f60c58fe2e74ee08832bc7f578a2980d))
+* Bump zod from 4.2.1 to 4.3.2 ([d34c2ef](https://github.com/UI5/mcp-server/commit/d34c2efa743064f99041eda5943efb9444516e66))
+* Bump zod from 4.3.2 to 4.3.4 ([2e61f66](https://github.com/UI5/mcp-server/commit/2e61f666a2b86369678c984e8a5524ad919aecb4))
+
+## [0.2.0](https://github.com/UI5/mcp-server/compare/v0.1.6...v0.2.0) (2025-12-12)
+
+
+### ⚠ BREAKING CHANGES
+
+* Update node engines version range: ^20.17.0 || >=22.9.0 ([#156](https://github.com/UI5/mcp-server/issues/156))
+
+### Features
+
+* Add tool with JavaScript to TypeScript conversion guidelines ([#137](https://github.com/UI5/mcp-server/issues/137)) ([52d7169](https://github.com/UI5/mcp-server/commit/52d7169b6d4dccaddf52ff32ea5f8056a221be06))
+
+
+### Dependencies
+
+* Bump @modelcontextprotocol/sdk from 1.24.2 to 1.24.3 ([ae346e4](https://github.com/UI5/mcp-server/commit/ae346e4910da4bfc1692ac09efb09ad2dd95b802))
+* Bump make-fetch-happen from 14.0.3 to 15.0.3 ([#116](https://github.com/UI5/mcp-server/issues/116)) ([a9aa08a](https://github.com/UI5/mcp-server/commit/a9aa08aac55d2af7c03a02e632b6dfab29738b09))
+* Update node engines version range: ^20.17.0 || >=22.9.0 ([#156](https://github.com/UI5/mcp-server/issues/156)) ([6a84d44](https://github.com/UI5/mcp-server/commit/6a84d443963525e5f0cc24292a50aa90c843c87c))
+
 ## [0.1.6](https://github.com/UI5/mcp-server/compare/v0.1.5...v0.1.6) (2025-12-03)
 
 

package/README.md

@@ -29,12 +29,14 @@ The UI5 [Model Context Protocol](https://modelcontextprotocol.io/) server offers
 - `get_project_info`: Extracts metadata and configuration from a UI5 project.
 - `get_version_info`: Retrieves version information for the UI5 framework.
 - `run_ui5_linter`: Integrates with [`@ui5/linter`](https://github.com/UI5/linter) to analyze and report issues in UI5 code.
+- `get_typescript_conversion_guidelines`: Provides guidelines for converting UI5 applications and controls from JavaScript to TypeScript.
 - `get_integration_cards_guidelines`: Provides access to UI Integration Cards development best practices.
 - `create_integration_card`: Scaffolds a new UI Integration Card.
+- `run_manifest_validation`: Validates the manifest against the UI5 Manifest schema.
 
 ## Requirements
 
-- [Node.js](https://nodejs.org/) Version v20.11.x, v22.0.0, or higher
+- [Node.js](https://nodejs.org/) Version v20.17.0, v22.9.0 or higher
 - [npm](https://www.npmjs.com/) Version v8.0.0 or higher
 - An MCP client such as VS Code, Cline, or any other MCP-compatible client
 

package/lib/registerTools.d.ts

@@ -64,6 +64,7 @@ export declare function _processResponse({ content, structuredContent }: CallToo
             src: string;
             mimeType?: string | undefined;
             sizes?: string[] | undefined;
+            theme?: "light" | "dark" | undefined;
         }[] | undefined;
         title?: string | undefined;
     } | {
@@ -146,6 +147,7 @@ export declare function _processResponse({ content, structuredContent }: CallToo
             src: string;
             mimeType?: string | undefined;
             sizes?: string[] | undefined;
+            theme?: "light" | "dark" | undefined;
         }[] | undefined;
         title?: string | undefined;
     } | {

package/lib/registerTools.js

@@ -7,6 +7,8 @@ import registerGetGuidelinesTool from "./tools/get_guidelines/index.js";
 import registerGetVersionInfoTool from "./tools/get_version_info/index.js";
 import registerGetIntegrationCardsGuidelinesTool from "./tools/get_integration_cards_guidelines/index.js";
 import registerCreateIntegrationCardTool from "./tools/create_integration_card/index.js";
+import registerRunManifestValidationTool from "./tools/run_manifest_validation/index.js";
+import registerGetTypescriptConversionGuidelinesTool from "./tools/get_typescript_conversion_guidelines/index.js";
 export default function (server, context, options) {
     const registerTool = (name, config, callback) => {
         if (!options.useStructuredContentInResponse) {
@@ -36,6 +38,8 @@ export default function (server, context, options) {
     registerGetVersionInfoTool(registerTool, context);
     registerGetIntegrationCardsGuidelinesTool(registerTool, context);
     registerCreateIntegrationCardTool(registerTool, context);
+    registerRunManifestValidationTool(registerTool, context);
+    registerGetTypescriptConversionGuidelinesTool(registerTool, context);
 }
 export function _processResponse({ content, structuredContent }, options) {
     if (!options.useResourcesInResponse) {

package/lib/registerTools.js.map

@@ -1 +1 @@
-{"version":3,"file":"registerTools.js","sourceRoot":"","sources":["../src/registerTools.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"registerTools.js","sourceRoot":"","sources":["../src/registerTools.ts"],"names":[],"mappings":"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"}

package/lib/tools/get_typescript_conversion_guidelines/index.d.ts

@@ -0,0 +1,3 @@
+import Context from "../../Context.js";
+import { RegisterTool } from "../../registerTools.js";
+export default function registerTool(registerTool: RegisterTool, _context: Context): void;

package/lib/tools/get_typescript_conversion_guidelines/index.js

@@ -0,0 +1,29 @@
+import { getTypescriptConversionGuidelines } from "./typescriptConversionGuidelines.js";
+import { getLogger } from "@ui5/logger";
+const log = getLogger("tools:get_typescript_conversion_guidelines");
+export default function registerTool(registerTool, _context) {
+    registerTool("get_typescript_conversion_guidelines", {
+        description: "This tool MUST be called once before converting a " +
+            "UI5 (SAPUI5/OpenUI5) project from JavaScript to TypeScript. " +
+            "The instructions provided by this tool MUST be followed to ensure " +
+            "that the project setup and code is correctly converted.",
+        annotations: {
+            title: "Get TypeScript Conversion Guidelines",
+            readOnlyHint: true,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async () => {
+        log.info("Retrieving TypeScript conversion guidelines...");
+        const guidelines = await getTypescriptConversionGuidelines();
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: guidelines,
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=index.js.map

package/lib/tools/get_typescript_conversion_guidelines/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/get_typescript_conversion_guidelines/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,iCAAiC,EAAC,MAAM,qCAAqC,CAAC;AACtF,OAAO,EAAC,SAAS,EAAC,MAAM,aAAa,CAAC;AAItC,MAAM,GAAG,GAAG,SAAS,CAAC,4CAA4C,CAAC,CAAC;AAEpE,MAAM,CAAC,OAAO,UAAU,YAAY,CAAC,YAA0B,EAAE,QAAiB;IACjF,YAAY,CAAC,sCAAsC,EAAE;QACpD,WAAW,EAAE,oDAAoD;YAChE,8DAA8D;YAC9D,oEAAoE;YACpE,yDAAyD;QAC1D,WAAW,EAAE;YACZ,KAAK,EAAE,sCAAsC;YAC7C,YAAY,EAAE,IAAI;YAClB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACpB;KACD,EAAE,KAAK,IAAI,EAAE;QACb,GAAG,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;QAC3D,MAAM,UAAU,GAAG,MAAM,iCAAiC,EAAE,CAAC;QAC7D,OAAO;YACN,OAAO,EAAE;gBACR;oBACC,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,UAAU;iBAChB;aACD;SACD,CAAC;IACH,CAAC,CAAC,CAAC;AACJ,CAAC"}

package/lib/tools/get_typescript_conversion_guidelines/typescriptConversionGuidelines.d.ts

@@ -0,0 +1 @@
+export declare function getTypescriptConversionGuidelines(): Promise<string>;

package/lib/tools/get_typescript_conversion_guidelines/typescriptConversionGuidelines.js

@@ -0,0 +1,66 @@
+import { readFile } from "node:fs/promises";
+import https from "https";
+const typescriptConversionGuidelinesFileUrl = new URL("../../../resources/typescript_conversion_guidelines.md", import.meta.url);
+async function getLatestVersion(packageName) {
+    return new Promise((resolve, reject) => {
+        https
+            .get(`https://registry.npmjs.org/${packageName}`, (res) => {
+            let data = "";
+            res.on("data", (chunk) => {
+                data += chunk;
+            });
+            res.on("end", () => {
+                try {
+                    const json = JSON.parse(data);
+                    resolve(json["dist-tags"].latest);
+                }
+                catch (_err) {
+                    reject(new Error(`Failed to parse response for package ${packageName}`));
+                }
+            });
+        })
+            .on("error", (err) => {
+            reject(err);
+        });
+    });
+}
+async function getLatestVersions(dependencies) {
+    const packageNames = Object.keys(dependencies);
+    const versionPromises = packageNames.map((packageName) => {
+        return getLatestVersion(packageName).catch((_error) => {
+            return dependencies[packageName];
+        });
+    });
+    const versions = await Promise.all(versionPromises);
+    const latestVersions = {};
+    packageNames.forEach((packageName, index) => {
+        latestVersions[packageName] = versions[index];
+    });
+    return latestVersions;
+}
+const getLatestDevDependencies = async () => {
+    const packages = await getLatestVersions({
+        "@ui5/cli": "^4",
+        "typescript": "^5",
+        "typescript-eslint": "^8",
+        "ui5-middleware-livereload": "^3",
+        "ui5-tooling-transpile": "^3",
+    });
+    return {
+        devDependencies: packages,
+    };
+};
+const getLatestTsInterfaceGeneratorVersion = async () => {
+    const version = await getLatestVersion("@ui5/ts-interface-generator").catch(() => {
+        return "^0";
+    });
+    return version;
+};
+export async function getTypescriptConversionGuidelines() {
+    let guidelines = await readFile(typescriptConversionGuidelinesFileUrl, { encoding: "utf-8" });
+    guidelines = guidelines
+        .replace("{{dependencies}}", JSON.stringify(await getLatestDevDependencies(), null, 3))
+        .replace("{{ts-interface-generator-version}}", await getLatestTsInterfaceGeneratorVersion());
+    return guidelines;
+}
+//# sourceMappingURL=typescriptConversionGuidelines.js.map

package/lib/tools/get_typescript_conversion_guidelines/typescriptConversionGuidelines.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typescriptConversionGuidelines.js","sourceRoot":"","sources":["../../../src/tools/get_typescript_conversion_guidelines/typescriptConversionGuidelines.ts"],"names":[],"mappings":"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"}

package/lib/tools/run_manifest_validation/index.d.ts

@@ -0,0 +1,3 @@
+import Context from "../../Context.js";
+import { RegisterTool } from "../../registerTools.js";
+export default function registerTool(registerTool: RegisterTool, context: Context): void;

package/lib/tools/run_manifest_validation/index.js

@@ -0,0 +1,30 @@
+import runValidation from "./runValidation.js";
+import { inputSchema, outputSchema } from "./schema.js";
+import { getLogger } from "@ui5/logger";
+const log = getLogger("tools:run_manifest_validation");
+export default function registerTool(registerTool, context) {
+    registerTool("run_manifest_validation", {
+        title: "Manifest Validation",
+        description: "Validates UI5 manifest file. " +
+            "After making changes, you should always run the validation again " +
+            "to verify that no new problems have been introduced.",
+        annotations: {
+            title: "Manifest Validation",
+            readOnlyHint: true,
+        },
+        inputSchema,
+        outputSchema,
+    }, async ({ manifestPath }) => {
+        log.info(`Running manifest validation on ${manifestPath}...`);
+        const normalizedManifestPath = await context.normalizePath(manifestPath);
+        const result = await runValidation(normalizedManifestPath);
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify(result),
+                }],
+            structuredContent: result,
+        };
+    });
+}
+//# sourceMappingURL=index.js.map

package/lib/tools/run_manifest_validation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/run_manifest_validation/index.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAC,WAAW,EAAE,YAAY,EAAC,MAAM,aAAa,CAAC;AACtD,OAAO,EAAC,SAAS,EAAC,MAAM,aAAa,CAAC;AAItC,MAAM,GAAG,GAAG,SAAS,CAAC,+BAA+B,CAAC,CAAC;AAEvD,MAAM,CAAC,OAAO,UAAU,YAAY,CAAC,YAA0B,EAAE,OAAgB;IAChF,YAAY,CAAC,yBAAyB,EAAE;QACvC,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EACV,+BAA+B;YAC/B,mEAAmE;YACnE,sDAAsD;QACvD,WAAW,EAAE;YACZ,KAAK,EAAE,qBAAqB;YAC5B,YAAY,EAAE,IAAI;SAClB;QACD,WAAW;QACX,YAAY;KACZ,EAAE,KAAK,EAAE,EAAC,YAAY,EAAC,EAAE,EAAE;QAC3B,GAAG,CAAC,IAAI,CAAC,kCAAkC,YAAY,KAAK,CAAC,CAAC;QAE9D,MAAM,sBAAsB,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;QACzE,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,sBAAsB,CAAC,CAAC;QAE3D,OAAO;YACN,OAAO,EAAE,CAAC;oBACT,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;iBAC5B,CAAC;YACF,iBAAiB,EAAE,MAAM;SACzB,CAAC;IACH,CAAC,CAAC,CAAC;AACJ,CAAC"}

package/lib/tools/run_manifest_validation/runValidation.d.ts

@@ -0,0 +1,2 @@
+import { RunSchemaValidationResult } from "./schema.js";
+export default function runValidation(manifestPath: string): Promise<RunSchemaValidationResult>;

package/lib/tools/run_manifest_validation/runValidation.js

@@ -0,0 +1,130 @@
+import { fetchCdn } from "../../utils/cdnHelper.js";
+import Ajv2020 from "ajv/dist/2020.js";
+import addFormats from "ajv-formats";
+import { readFile } from "fs/promises";
+import { getLogger } from "@ui5/logger";
+import { InvalidInputError } from "../../utils.js";
+import { getManifestSchema, getManifestVersion } from "../../utils/ui5Manifest.js";
+import { Mutex } from "async-mutex";
+import { fileURLToPath } from "url";
+import { isAbsolute } from "path";
+const log = getLogger("tools:run_manifest_validation:runValidation");
+const schemaCache = new Map();
+const fetchSchemaMutex = new Mutex();
+const AJV_SCHEMA_PATHS = {
+    draft06: fileURLToPath(import.meta.resolve("ajv/dist/refs/json-schema-draft-06.json")),
+    draft07: fileURLToPath(import.meta.resolve("ajv/dist/refs/json-schema-draft-07.json")),
+};
+async function createUI5ManifestValidateFunction(ui5Schema) {
+    try {
+        const ajv = new Ajv2020.default({
+            // Collect all errors, not just the first one
+            allErrors: true,
+            // Allow additional properties that are not in schema such as "i18n",
+            // otherwise compilation fails
+            strict: false,
+            // Don't use Unicode-aware regular expressions,
+            // otherwise compilation fails with "Invalid escape" errors
+            unicodeRegExp: false,
+            loadSchema: async (uri) => {
+                const release = await fetchSchemaMutex.acquire();
+                try {
+                    if (schemaCache.has(uri)) {
+                        log.info(`Loading cached schema: ${uri}`);
+                        return schemaCache.get(uri);
+                    }
+                    log.info(`Loading external schema: ${uri}`);
+                    const schema = await fetchCdn(uri);
+                    // Special handling for Adaptive Card schema to fix unsupported "id" property
+                    // According to the JSON Schema spec Draft 06 (used by Adaptive Card schema),
+                    // "$id" should be used instead of "id"
+                    // See https://github.com/microsoft/AdaptiveCards/issues/9274
+                    if (uri.includes("adaptive-card.json") && typeof schema.id === "string") {
+                        schema.$id = schema.id;
+                        delete schema.id;
+                    }
+                    schemaCache.set(uri, schema);
+                    return schema;
+                }
+                catch (error) {
+                    log.warn(`Failed to load external schema ${uri}:` +
+                        `${error instanceof Error ? error.message : String(error)}`);
+                    throw error;
+                }
+                finally {
+                    release();
+                }
+            },
+        });
+        addFormats.default(ajv);
+        const draft06MetaSchema = JSON.parse(await readFile(AJV_SCHEMA_PATHS.draft06, "utf-8"));
+        const draft07MetaSchema = JSON.parse(await readFile(AJV_SCHEMA_PATHS.draft07, "utf-8"));
+        // Add meta-schemas for draft-06 and draft-07.
+        // These are required to support schemas that reference these drafts,
+        // for example the Adaptive Card schema and some sap.bpa.task properties.
+        ajv.addMetaSchema(draft06MetaSchema, "http://json-schema.org/draft-06/schema#");
+        ajv.addMetaSchema(draft07MetaSchema, "http://json-schema.org/draft-07/schema#");
+        const validate = await ajv.compileAsync(ui5Schema);
+        return validate;
+    }
+    catch (error) {
+        throw new Error(`Failed to create UI5 manifest validate function: ` +
+            `${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+async function readManifest(path) {
+    let content;
+    let json;
+    if (!isAbsolute(path)) {
+        throw new InvalidInputError(`The manifest path must be absolute: '${path}'`);
+    }
+    try {
+        content = await readFile(path, "utf-8");
+    }
+    catch (error) {
+        throw new InvalidInputError(`Failed to read manifest file at ${path}: ` +
+            `${error instanceof Error ? error.message : String(error)}`);
+    }
+    try {
+        json = JSON.parse(content);
+    }
+    catch (error) {
+        throw new InvalidInputError(`Failed to parse manifest file at ${path} as JSON: ` +
+            `${error instanceof Error ? error.message : String(error)}`);
+    }
+    return json;
+}
+export default async function runValidation(manifestPath) {
+    log.info(`Starting manifest validation for file: ${manifestPath}`);
+    const manifest = await readManifest(manifestPath);
+    const manifestVersion = await getManifestVersion(manifest);
+    log.info(`Using manifest version: ${manifestVersion}`);
+    const ui5ManifestSchema = await getManifestSchema(manifestVersion);
+    const validate = await createUI5ManifestValidateFunction(ui5ManifestSchema);
+    const isValid = validate(manifest);
+    if (isValid) {
+        log.info("Manifest validation successful");
+        return {
+            isValid: true,
+            errors: [],
+        };
+    }
+    // Map AJV errors to our schema format
+    const validationErrors = validate.errors ?? [];
+    const errors = validationErrors.map((error) => {
+        return {
+            keyword: error.keyword ?? "",
+            instancePath: error.instancePath ?? "",
+            schemaPath: error.schemaPath ?? "",
+            params: error.params ?? {},
+            propertyName: error.propertyName,
+            message: error.message,
+        };
+    });
+    log.info(`Manifest validation failed with ${errors.length} error(s)`);
+    return {
+        isValid: false,
+        errors: errors,
+    };
+}
+//# sourceMappingURL=runValidation.js.map

package/lib/tools/run_manifest_validation/runValidation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runValidation.js","sourceRoot":"","sources":["../../../src/tools/run_manifest_validation/runValidation.ts"],"names":[],"mappings":"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"}

package/lib/tools/run_manifest_validation/schema.d.ts

@@ -0,0 +1,28 @@
+import { z } from "zod";
+export declare const inputSchema: {
+    manifestPath: z.ZodString;
+};
+export declare const outputSchema: {
+    isValid: z.ZodBoolean;
+    errors: z.ZodArray<z.ZodObject<{
+        keyword: z.ZodString;
+        instancePath: z.ZodString;
+        schemaPath: z.ZodString;
+        params: z.ZodRecord<z.ZodAny, z.ZodAny>;
+        propertyName: z.ZodOptional<z.ZodString>;
+        message: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+};
+declare const _outputSchemaObject: z.ZodObject<{
+    isValid: z.ZodBoolean;
+    errors: z.ZodArray<z.ZodObject<{
+        keyword: z.ZodString;
+        instancePath: z.ZodString;
+        schemaPath: z.ZodString;
+        params: z.ZodRecord<z.ZodAny, z.ZodAny>;
+        propertyName: z.ZodOptional<z.ZodString>;
+        message: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type RunSchemaValidationResult = z.infer<typeof _outputSchemaObject>;
+export {};

package/lib/tools/run_manifest_validation/schema.js

@@ -0,0 +1,27 @@
+import { z } from "zod";
+export const inputSchema = {
+    manifestPath: z.string()
+        .describe("Absolute path to the manifest file to validate."),
+};
+export const outputSchema = {
+    isValid: z.boolean()
+        .describe("Whether the manifest is valid according to the UI5 Manifest schema."),
+    errors: z.array(z.object({
+        keyword: z.string()
+            .describe("Validation keyword."),
+        instancePath: z.string()
+            .describe("JSON Pointer to the location in the data instance (e.g., `/prop/1/subProp`)."),
+        schemaPath: z.string()
+            .describe("JSON Pointer to the location of the failing keyword in the schema."),
+        params: z.record(z.any(), z.any())
+            .describe("An object with additional information about the error."),
+        propertyName: z.string()
+            .optional()
+            .describe("Set for errors in `propertyNames` keyword schema."),
+        message: z.string()
+            .optional()
+            .describe("The error message."),
+    })).describe("Array of validation error objects as returned by Ajv."),
+};
+const _outputSchemaObject = z.object(outputSchema);
+//# sourceMappingURL=schema.js.map

package/lib/tools/run_manifest_validation/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/tools/run_manifest_validation/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAEtB,MAAM,CAAC,MAAM,WAAW,GAAG;IAC1B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;SACtB,QAAQ,CAAC,iDAAiD,CAAC;CAC7D,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAG;IAC3B,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;SAClB,QAAQ,CAAC,qEAAqE,CAAC;IACjF,MAAM,EAAE,CAAC,CAAC,KAAK,CACd,CAAC,CAAC,MAAM,CAAC;QACR,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;aACjB,QAAQ,CAAC,qBAAqB,CAAC;QACjC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;aACtB,QAAQ,CAAC,8EAA8E,CAAC;QAC1F,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;aACpB,QAAQ,CAAC,oEAAoE,CAAC;QAChF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC;aAChC,QAAQ,CAAC,wDAAwD,CAAC;QACpE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;aACtB,QAAQ,EAAE;aACV,QAAQ,CAAC,mDAAmD,CAAC;QAC/D,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;aACjB,QAAQ,EAAE;aACV,QAAQ,CAAC,oBAAoB,CAAC;KAChC,CAAC,CACF,CAAC,QAAQ,CAAC,uDAAuD,CAAC;CACnE,CAAC;AACF,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC"}

package/lib/utils/ui5Manifest.d.ts

@@ -1 +1,18 @@
+/**
+ * Get the manifest schema for a specific manifest version.
+ * @param manifestVersion The manifest version
+ * @returns The manifest schema
+ * @throws Error if the manifest version is unsupported
+ */
+export declare function getManifestSchema(manifestVersion: string): Promise<object>;
+/**
+ * Get the manifest version from the manifest object.
+ * @param manifest The manifest object
+ * @returns The manifest version
+ * @throws Error if the manifest version is missing or invalid
+ */
+export declare function getManifestVersion(manifest: object): Promise<string>;
+/**
+ * @returns The latest manifest version
+ */
 export declare function getLatestManifestVersion(): Promise<string>;

package/lib/utils/ui5Manifest.js

@@ -1,11 +1,111 @@
+import { getLogger } from "@ui5/logger";
 import { fetchCdn } from "./cdnHelper.js";
-const MAPPING_URL = "https://raw.githubusercontent.com/SAP/ui5-manifest/main/mapping.json";
-async function getUI5toManifestVersionMap() {
-    const mapping = await fetchCdn(MAPPING_URL);
-    return mapping;
+import { Mutex } from "async-mutex";
+import semver from "semver";
+const log = getLogger("utils:ui5Manifest");
+const schemaCache = new Map();
+const fetchSchemaMutex = new Mutex();
+let UI5ToManifestVersionMapping = null;
+const MAPPING_URL = "https://raw.githubusercontent.com/UI5/manifest/main/mapping.json";
+const ui5ToManifestVersionMappingMutex = new Mutex();
+// Manifests prior to 1.68.0 use older meta-schema, which is not supported by the current implementation
+const LOWEST_SUPPORTED_MANIFEST_VERSION = "1.68.0";
+function getSchemaURL(manifestVersion) {
+    return `https://raw.githubusercontent.com/UI5/manifest/v${manifestVersion}/schema.json`;
 }
+async function getUI5toManifestVersionMapping() {
+    const release = await ui5ToManifestVersionMappingMutex.acquire();
+    try {
+        if (UI5ToManifestVersionMapping) {
+            log.info("Loading cached UI5 to manifest version mapping");
+            return UI5ToManifestVersionMapping;
+        }
+        log.info("Fetching UI5 to manifest version mapping");
+        const mapping = await fetchCdn(MAPPING_URL);
+        log.info(`Fetched UI5 to manifest version mapping from ${MAPPING_URL}`);
+        UI5ToManifestVersionMapping = mapping;
+        return UI5ToManifestVersionMapping;
+    }
+    finally {
+        release();
+    }
+}
+async function fetchSchema(manifestVersion) {
+    const release = await fetchSchemaMutex.acquire();
+    try {
+        if (schemaCache.has(manifestVersion)) {
+            log.info(`Loading cached schema for manifest version: ${manifestVersion}`);
+            return schemaCache.get(manifestVersion);
+        }
+        log.info(`Fetching schema for manifest version: ${manifestVersion}`);
+        const schemaURL = getSchemaURL(manifestVersion);
+        const schema = await fetchCdn(schemaURL);
+        log.info(`Fetched UI5 manifest schema from ${schemaURL}`);
+        schemaCache.set(manifestVersion, schema);
+        return schema;
+    }
+    finally {
+        release();
+    }
+}
+async function failWithSupportedVersionsHint(errorMessage) {
+    let supportedVersions;
+    try {
+        const versionMap = await getUI5toManifestVersionMapping();
+        supportedVersions = [
+            ...new Set(Object.values(versionMap).filter((version) => semver.gte(version, LOWEST_SUPPORTED_MANIFEST_VERSION))),
+        ];
+    }
+    catch (_) {
+        supportedVersions = null;
+    }
+    ;
+    throw new Error(errorMessage +
+        (supportedVersions ?
+            `\nSupported versions are: ${supportedVersions.join(", ")}.` :
+            ""));
+}
+/**
+ * Get the manifest schema for a specific manifest version.
+ * @param manifestVersion The manifest version
+ * @returns The manifest schema
+ * @throws Error if the manifest version is unsupported
+ */
+export async function getManifestSchema(manifestVersion) {
+    if (semver.lt(manifestVersion, LOWEST_SUPPORTED_MANIFEST_VERSION)) {
+        return failWithSupportedVersionsHint(`Manifest version '${manifestVersion}' is not supported. Please upgrade to a newer one.`);
+    }
+    try {
+        return await fetchSchema(manifestVersion);
+    }
+    catch (error) {
+        return failWithSupportedVersionsHint(`Failed to fetch schema for manifest version '${manifestVersion}': ` +
+            `${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * Get the manifest version from the manifest object.
+ * @param manifest The manifest object
+ * @returns The manifest version
+ * @throws Error if the manifest version is missing or invalid
+ */
+export async function getManifestVersion(manifest) {
+    if (!("_version" in manifest)) {
+        return failWithSupportedVersionsHint("Manifest does not contain a '_version' property.");
+    }
+    if (typeof manifest._version !== "string") {
+        return failWithSupportedVersionsHint("Manifest '_version' property is not a string.");
+    }
+    if (!semver.valid(manifest._version)) {
+        return failWithSupportedVersionsHint("Manifest '_version' property is not a valid semantic version.");
+    }
+    return manifest._version;
+}
+/**
+ * @returns The latest manifest version
+ */
 export async function getLatestManifestVersion() {
-    const versionMap = await getUI5toManifestVersionMap();
+    const versionMap = await getUI5toManifestVersionMapping();
     if (!versionMap.latest) {
         throw new Error("Could not determine latest manifest version.");
     }

package/lib/utils/ui5Manifest.js.map

@@ -1 +1 @@
-{"version":3,"file":"ui5Manifest.js","sourceRoot":"","sources":["../../src/utils/ui5Manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,QAAQ,EAAC,MAAM,gBAAgB,CAAC;AAExC,MAAM,WAAW,GAAG,sEAAsE,CAAC;AAE3F,KAAK,UAAU,0BAA0B;IACxC,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,WAAW,CAAC,CAAC;IAE5C,OAAO,OAAiC,CAAC;AAC1C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB;IAC7C,MAAM,UAAU,GAAG,MAAM,0BAA0B,EAAE,CAAC;IAEtD,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IACjE,CAAC;IAED,OAAO,UAAU,CAAC,MAAM,CAAC;AAC1B,CAAC"}
+{"version":3,"file":"ui5Manifest.js","sourceRoot":"","sources":["../../src/utils/ui5Manifest.ts"],"names":[],"mappings":"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"}