@trackunit/iris-app-build-utilities 2.0.44 → 2.0.47

package/CHANGELOG.md

@@ -1,3 +1,21 @@
+## 2.0.47 (2026-07-01)
+
+### 🧱 Updated Dependencies
+
+- Updated iris-app-api to 2.0.44
+- Updated shared-utils to 1.15.52
+
+## 2.0.46 (2026-07-01)
+
+### 🧱 Updated Dependencies
+
+- Updated iris-app-api to 2.0.43
+- Updated shared-utils to 1.15.51
+
+## 2.0.45 (2026-07-01)
+
+This was a version bump only for iris-app-build-utilities to align it with other projects, there were no code changes.
+
 ## 2.0.44 (2026-06-30)
 
 ### 🧱 Updated Dependencies

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trackunit/iris-app-build-utilities",
-  "version": "2.0.44",
+  "version": "2.0.47",
   "license": "SEE LICENSE IN LICENSE.txt",
   "repository": "https://github.com/Trackunit/manager",
   "engines": {
@@ -15,9 +15,9 @@
     "tslib": "^2.6.2",
     "csp-header": "^6.3.1",
     "@rspack/core": "1.6.7",
-    "@trackunit/iris-app-api": "2.0.42",
+    "@trackunit/iris-app-api": "2.0.44",
     "@nx/devkit": "22.7.5",
-    "@trackunit/shared-utils": "1.15.50",
+    "@trackunit/shared-utils": "1.15.52",
     "http-proxy-middleware": "3.0.5",
     "marked": "14.1.2",
     "pacote": "^21.0.4",

package/src/checkPackageVersion.js

@@ -42,7 +42,7 @@ const getLatestRemoteVersion = async (pkg, throwError = true) => {
         const manifest = await pacote.manifest(pkg);
         return manifest.version;
     }
-    catch (error) {
+    catch {
         if (throwError) {
             throw new Error(`Error fetching manifest for package ${pkg}. This package might need to be published, or it has been included as a dependency by mistake.`);
         }

package/src/plugin-shared/extensionUtil.js

@@ -2,7 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.updateConditions = exports.updateExtensions = void 0;
 const iris_app_api_1 = require("@trackunit/iris-app-api");
+const consoleUtils_1 = require("./consoleUtils");
 const irisAppTranslationUtils_1 = require("./irisAppTranslationUtils");
+const validateMenuIcon_1 = require("./validateMenuIcon");
 const fixUrl = (image, extensionId) => {
     if ((0, iris_app_api_1.isIconByPath)(image) || (0, iris_app_api_1.isImageByPath)(image)) {
         if (image.path.toString().startsWith("/")) {
@@ -53,6 +55,13 @@ const updateExtensions = (extensions) => {
             (0, exports.updateConditions)(extension);
         }
         if (extension.type === "FLEET_EXTENSION") {
+            const iconValidation = (0, validateMenuIcon_1.validateMenuIcon)(extension.menuItem, extension.id);
+            if (iconValidation.status === "warning") {
+                (0, consoleUtils_1.logWarning)(iconValidation.message);
+            }
+            else if (iconValidation.status === "error") {
+                throw new Error(iconValidation.message);
+            }
             if ((0, iris_app_api_1.isIconByPath)(extension.menuItem.image) && !extension.menuItem.image.path.startsWith(extension.id)) {
                 fixUrl(extension.menuItem.image, extension.id);
             }

package/src/plugin-shared/validateMenuIcon.d.ts

@@ -0,0 +1,34 @@
+import { IconByName, IconByPath } from "@trackunit/iris-app-api";
+export type MenuIconValidation = {
+    status: "ok";
+} | {
+    status: "warning";
+    message: string;
+} | {
+    status: "error";
+    message: string;
+};
+/**
+ * Validates a fleet extension's menu icon configuration without side effects.
+ *
+ * Priority order:
+ *  1. `image` present (it supersedes the deprecated `icon`):
+ *     - path-based image is a file reference and is not name-validated; a present
+ *       `icon` is then redundant (warning).
+ *     - name-based image is validated; an invalid name is an error, otherwise a
+ *       present `icon` is redundant (warning).
+ *     - any other (malformed) image shape, e.g. a non-`.svg` path, is an error.
+ *  2. No `image`, deprecated `icon` present (including `""`): invalid name errors,
+ *     valid name warns about the deprecation.
+ *  3. Neither present: ok.
+ *
+ * @param menuItem - The fleet extension menu item (icon and/or image)
+ * @param menuItem.icon - The deprecated icon name
+ * @param menuItem.image - The image (icon name or file path)
+ * @param extensionId - The extension id, used in messages
+ * @returns {MenuIconValidation} The validation result
+ */
+export declare const validateMenuIcon: (menuItem: {
+    icon?: string;
+    image?: IconByName | IconByPath;
+}, extensionId: string) => MenuIconValidation;

package/src/plugin-shared/validateMenuIcon.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateMenuIcon = void 0;
+const iris_app_api_1 = require("@trackunit/iris-app-api");
+/**
+ * Exact-match check of an icon name against the supported icon names from
+ * `@trackunit/iris-app-api`. There is intentionally no fuzzy matching or
+ * "...Icon" suffix stripping: names must match exactly.
+ */
+const isValidIconName = (name) => Object.prototype.hasOwnProperty.call(iris_app_api_1.iconNames, name);
+const redundantIconWarning = (extensionId) => `Fleet extension "${extensionId}": menuItem.icon is redundant because menuItem.image takes precedence. ` +
+    `Remove the deprecated menuItem.icon.`;
+const invalidImageNameError = (name, extensionId) => `Fleet extension "${extensionId}": menuItem.image name "${name}" is not a valid icon name. ` +
+    `Use one of the supported icon names exported as iconNames from @trackunit/iris-app-api (names must match exactly).`;
+const invalidIconError = (icon, extensionId) => `Fleet extension "${extensionId}": deprecated menuItem.icon "${icon}" is not a valid icon name. ` +
+    `Migrate to menuItem.image: { name: "<icon name>" } using a supported icon name from @trackunit/iris-app-api ` +
+    `(names must match exactly).`;
+const invalidImageError = (extensionId) => `Fleet extension "${extensionId}": menuItem.image is not a valid icon. ` +
+    `Provide { name: "<icon name>" } using a supported icon name from @trackunit/iris-app-api, ` +
+    `or { path: "<file>.svg" } pointing to an SVG asset.`;
+const deprecatedIconWarning = (icon, extensionId) => `Fleet extension "${extensionId}": menuItem.icon is deprecated. ` +
+    `Migrate menuItem.icon "${icon}" to menuItem.image: { name: "${icon}" }.`;
+/**
+ * Validates a fleet extension's menu icon configuration without side effects.
+ *
+ * Priority order:
+ *  1. `image` present (it supersedes the deprecated `icon`):
+ *     - path-based image is a file reference and is not name-validated; a present
+ *       `icon` is then redundant (warning).
+ *     - name-based image is validated; an invalid name is an error, otherwise a
+ *       present `icon` is redundant (warning).
+ *     - any other (malformed) image shape, e.g. a non-`.svg` path, is an error.
+ *  2. No `image`, deprecated `icon` present (including `""`): invalid name errors,
+ *     valid name warns about the deprecation.
+ *  3. Neither present: ok.
+ *
+ * @param menuItem - The fleet extension menu item (icon and/or image)
+ * @param menuItem.icon - The deprecated icon name
+ * @param menuItem.image - The image (icon name or file path)
+ * @param extensionId - The extension id, used in messages
+ * @returns {MenuIconValidation} The validation result
+ */
+const validateMenuIcon = (menuItem, extensionId) => {
+    const { icon, image } = menuItem;
+    if (image !== undefined) {
+        if ((0, iris_app_api_1.isIconByPath)(image)) {
+            return icon !== undefined ? { status: "warning", message: redundantIconWarning(extensionId) } : { status: "ok" };
+        }
+        if ((0, iris_app_api_1.isIconByName)(image)) {
+            if (!isValidIconName(image.name)) {
+                return { status: "error", message: invalidImageNameError(image.name, extensionId) };
+            }
+            return icon !== undefined ? { status: "warning", message: redundantIconWarning(extensionId) } : { status: "ok" };
+        }
+        // image is present but is neither a name-based icon nor an SVG path (e.g. a
+        // non-.svg path or a malformed shape). Fail the build instead of silently
+        // rendering a broken menu image at runtime.
+        return { status: "error", message: invalidImageError(extensionId) };
+    }
+    if (icon !== undefined) {
+        if (!isValidIconName(icon)) {
+            return { status: "error", message: invalidIconError(icon, extensionId) };
+        }
+        return { status: "warning", message: deprecatedIconWarning(icon, extensionId) };
+    }
+    return { status: "ok" };
+};
+exports.validateMenuIcon = validateMenuIcon;
+//# sourceMappingURL=validateMenuIcon.js.map