@trackunit/iris-app-build-utilities 1.12.0 → 1.12.7

package/CHANGELOG.md

@@ -1,3 +1,48 @@
+## 1.12.7 (2026-01-27)
+
+### 🧱 Updated Dependencies
+
+- Updated iris-app-api to 1.14.7
+- Updated shared-utils to 1.13.7
+
+## 1.12.6 (2026-01-27)
+
+### 🧱 Updated Dependencies
+
+- Updated iris-app-api to 1.14.6
+- Updated shared-utils to 1.13.6
+
+## 1.12.5 (2026-01-27)
+
+### 🧱 Updated Dependencies
+
+- Updated iris-app-api to 1.14.5
+- Updated shared-utils to 1.13.5
+
+## 1.12.4 (2026-01-26)
+
+### 🧱 Updated Dependencies
+
+- Updated iris-app-api to 1.14.4
+
+## 1.12.3 (2026-01-26)
+
+### 🧱 Updated Dependencies
+
+- Updated iris-app-api to 1.14.3
+
+## 1.12.2 (2026-01-26)
+
+### 🧱 Updated Dependencies
+
+- Updated iris-app-api to 1.14.2
+
+## 1.12.1 (2026-01-26)
+
+### 🧱 Updated Dependencies
+
+- Updated iris-app-api to 1.14.1
+
 ## 1.12.0 (2026-01-26)
 
 ### 🚀 Features

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trackunit/iris-app-build-utilities",
-  "version": "1.12.0",
+  "version": "1.12.7",
   "license": "SEE LICENSE IN LICENSE.txt",
   "repository": "https://github.com/Trackunit/manager",
   "engines": {
@@ -17,7 +17,11 @@
     "tslib": "^2.6.2",
     "csp-header": "^5.2.1",
     "@rspack/core": "1.6.7",
-    "@trackunit/iris-app-api": "1.14.0"
+    "@trackunit/iris-app-api": "1.14.7",
+    "@nx/devkit": "22.0.4",
+    "@trackunit/shared-utils": "1.13.7",
+    "pacote": "^21.0.4",
+    "semver": "7.5.4"
   },
   "types": "./src/index.d.ts",
   "main": "./src/index.js",

package/src/checkPackageVersion.d.ts

@@ -0,0 +1,30 @@
+/**
+ *
+ * @param pkg package to look for.
+ * @param localRange local version of the package.
+ * @param range range
+ * @returns { boolean } true if its a valid version
+ */
+export declare const versionCheck: (pkg: string, localRange: string, range: string, throwError?: boolean) => boolean;
+/**
+ * Get the latest version of the package from the registry.
+ *
+ * @param pkg package to look for.
+ * @returns { Promise<string> } returns version
+ */
+export declare const getLatestRemoteVersion: (pkg: string) => Promise<string>;
+/**
+ * Check if the current version of the package is the same as the one in the manager.
+ *
+ * @param {string} managerNxVersion version of nx in the manager
+ * @returns { boolean} true if its a valid version
+ */
+export declare function checkNxVersion(managerNxVersion: string, throwError?: boolean): Promise<boolean>;
+/**
+ *
+ */
+export declare function checkTrackunitPackages(dependencies: Record<string, string>, throwError?: boolean): Promise<boolean>;
+/**
+ *
+ */
+export declare function checkPackageVersion(throwError?: boolean): Promise<boolean>;

package/src/checkPackageVersion.js

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getLatestRemoteVersion = exports.versionCheck = void 0;
+exports.checkNxVersion = checkNxVersion;
+exports.checkTrackunitPackages = checkTrackunitPackages;
+exports.checkPackageVersion = checkPackageVersion;
+const tslib_1 = require("tslib");
+const devkit_1 = require("@nx/devkit");
+const shared_utils_1 = require("@trackunit/shared-utils");
+const child_process_1 = require("child_process");
+const pacote = tslib_1.__importStar(require("pacote"));
+const semver = tslib_1.__importStar(require("semver"));
+/**
+ *
+ * @param pkg package to look for.
+ * @param localRange local version of the package.
+ * @param range range
+ * @returns { boolean } true if its a valid version
+ */
+const versionCheck = (pkg, localRange, range, throwError = true) => {
+    const localVersion = semver.minVersion(localRange) ?? localRange; // ('^1.0.0') => '1.0.0'
+    const remoteVersion = semver.minVersion(range) ?? range; // Assume range is in a format that semver.minVersion can handle
+    if (!semver.satisfies(localVersion, range)) {
+        const msg = `Package "${pkg}" outdated. Remote Version: ${range} Local version: ${localRange}. 👈\n Update package using command: \n  npm i ${pkg}@${range}\n  ...or to update all trackunit dependencies: \n  npx npm-check-updates "/@trackunit/" -u`;
+        if (semver.major(localVersion) < semver.major(remoteVersion) && throwError) {
+            throw new Error(msg);
+        }
+        else {
+            // eslint-disable-next-line no-console
+            console.warn("⚠️ " + msg + "\n");
+            return true;
+        }
+    }
+    return true;
+};
+exports.versionCheck = versionCheck;
+/**
+ * Get the latest version of the package from the registry.
+ *
+ * @param pkg package to look for.
+ * @returns { Promise<string> } returns version
+ */
+const getLatestRemoteVersion = async (pkg) => {
+    try {
+        const manifest = await pacote.manifest(pkg);
+        return manifest.version;
+    }
+    catch (error) {
+        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.`);
+    }
+};
+exports.getLatestRemoteVersion = getLatestRemoteVersion;
+/**
+ * Check if the current version of the package is the same as the one in the manager.
+ *
+ * @param {string} managerNxVersion version of nx in the manager
+ * @returns { boolean} true if its a valid version
+ */
+async function checkNxVersion(managerNxVersion, throwError = true) {
+    const currentNxVersion = (0, child_process_1.execSync)("nx --version")
+        .toString("utf-8")
+        .replace(/\r?\n|\r/, ""); // regex removes any line breaks
+    return (0, exports.versionCheck)("nx", currentNxVersion, managerNxVersion, throwError);
+}
+/**
+ *
+ */
+async function checkTrackunitPackages(dependencies, throwError = true) {
+    for (const key in dependencies) {
+        const remoteVersion = await (0, exports.getLatestRemoteVersion)(key);
+        if (remoteVersion) {
+            const localDependencyVersion = dependencies[key];
+            // If @trackunit dependencies are linked/added locally using "file:", skip the version check, used for E2E tests.
+            if (localDependencyVersion && !localDependencyVersion.includes("file:")) {
+                (0, exports.versionCheck)(key, localDependencyVersion, remoteVersion, throwError);
+            }
+        }
+    }
+    return true;
+}
+function getLibraries() {
+    const packageJsonLocal = (0, devkit_1.readJsonFile)("package.json");
+    const trackunitDependencies = (0, shared_utils_1.objectFromEntries)(Object.entries(packageJsonLocal.dependencies || {}).filter(([key]) => key.startsWith("@trackunit/")));
+    const trackunitDevDependencies = (0, shared_utils_1.objectFromEntries)(Object.entries(packageJsonLocal.devDependencies || {}).filter(([key]) => key.startsWith("@trackunit/")));
+    return { trackunitDependencies, trackunitDevDependencies };
+}
+/**
+ *
+ */
+async function checkPackageVersion(throwError = true) {
+    const { trackunitDependencies, trackunitDevDependencies } = getLibraries();
+    // const managerNxVersion = version.managerNxVersion;
+    // await checkNxVersion(managerNxVersion, throwError);
+    await checkTrackunitPackages(trackunitDependencies, throwError);
+    await checkTrackunitPackages(trackunitDevDependencies, throwError);
+    return true;
+}
+//# sourceMappingURL=checkPackageVersion.js.map

package/src/checkPackageVersion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkPackageVersion.js","sourceRoot":"","sources":["../../../../../libs/iris-app-sdk/iris-app-build-utilities/src/checkPackageVersion.ts"],"names":[],"mappings":";;;AAqDA,wCAKC;AAKD,wDAYC;AAgBD,kDAOC;;AAlGD,uCAA0C;AAC1C,0DAA4D;AAC5D,iDAAyC;AACzC,uDAAiC;AACjC,uDAAiC;AAEjC;;;;;;GAMG;AACI,MAAM,YAAY,GAAG,CAAC,GAAW,EAAE,UAAkB,EAAE,KAAa,EAAE,UAAU,GAAG,IAAI,EAAE,EAAE;IAChG,MAAM,YAAY,GAAG,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC,CAAC,wBAAwB;IAC1F,MAAM,aAAa,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC,gEAAgE;IAEzH,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC;QAC3C,MAAM,GAAG,GAAG,YAAY,GAAG,+BAA+B,KAAK,mBAAmB,UAAU,kDAAkD,GAAG,IAAI,KAAK,6FAA6F,CAAC;QACxP,IAAI,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,UAAU,EAAE,CAAC;YAC3E,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;aAAM,CAAC;YACN,sCAAsC;YACtC,OAAO,CAAC,IAAI,CAAC,KAAK,GAAG,GAAG,GAAG,IAAI,CAAC,CAAC;YACjC,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAfW,QAAA,YAAY,gBAevB;AAEF;;;;;GAKG;AACI,MAAM,sBAAsB,GAAG,KAAK,EAAE,GAAW,EAAE,EAAE;IAC1D,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC5C,OAAO,QAAQ,CAAC,OAAO,CAAC;IAC1B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,uCAAuC,GAAG,gGAAgG,CAC3I,CAAC;IACJ,CAAC;AACH,CAAC,CAAC;AATW,QAAA,sBAAsB,0BASjC;AAEF;;;;;GAKG;AACI,KAAK,UAAU,cAAc,CAAC,gBAAwB,EAAE,UAAU,GAAG,IAAI;IAC9E,MAAM,gBAAgB,GAAG,IAAA,wBAAQ,EAAC,cAAc,CAAC;SAC9C,QAAQ,CAAC,OAAO,CAAC;SACjB,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC,gCAAgC;IAC5D,OAAO,IAAA,oBAAY,EAAC,IAAI,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,UAAU,CAAC,CAAC;AAC5E,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,sBAAsB,CAAC,YAAoC,EAAE,UAAU,GAAG,IAAI;IAClG,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;QAC/B,MAAM,aAAa,GAAuB,MAAM,IAAA,8BAAsB,EAAC,GAAG,CAAC,CAAC;QAC5E,IAAI,aAAa,EAAE,CAAC;YAClB,MAAM,sBAAsB,GAAuB,YAAY,CAAC,GAAG,CAAC,CAAC;YACrE,iHAAiH;YACjH,IAAI,sBAAsB,IAAI,CAAC,sBAAsB,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBACxE,IAAA,oBAAY,EAAC,GAAG,EAAE,sBAAsB,EAAE,aAAa,EAAE,UAAU,CAAC,CAAC;YACvE,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,YAAY;IACnB,MAAM,gBAAgB,GAAoD,IAAA,qBAAY,EAAC,cAAc,CAAC,CAAC;IACvG,MAAM,qBAAqB,GAAG,IAAA,gCAAiB,EAC7C,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CACrG,CAAC;IACF,MAAM,wBAAwB,GAAG,IAAA,gCAAiB,EAChD,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CACxG,CAAC;IACF,OAAO,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,CAAC;AAC7D,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,mBAAmB,CAAC,UAAU,GAAG,IAAI;IACzD,MAAM,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,GAAG,YAAY,EAAE,CAAC;IAC3E,qDAAqD;IACrD,sDAAsD;IACtD,MAAM,sBAAsB,CAAC,qBAAqB,EAAE,UAAU,CAAC,CAAC;IAChE,MAAM,sBAAsB,CAAC,wBAAwB,EAAE,UAAU,CAAC,CAAC;IACnE,OAAO,IAAI,CAAC;AACd,CAAC","sourcesContent":["import { readJsonFile } from \"@nx/devkit\";\nimport { objectFromEntries } from \"@trackunit/shared-utils\";\nimport { execSync } from \"child_process\";\nimport * as pacote from \"pacote\";\nimport * as semver from \"semver\";\n\n/**\n *\n * @param pkg package to look for.\n * @param localRange local version of the package.\n * @param range range\n * @returns { boolean } true if its a valid version\n */\nexport const versionCheck = (pkg: string, localRange: string, range: string, throwError = true) => {\n  const localVersion = semver.minVersion(localRange) ?? localRange; // ('^1.0.0') => '1.0.0'\n  const remoteVersion = semver.minVersion(range) ?? range; // Assume range is in a format that semver.minVersion can handle\n\n  if (!semver.satisfies(localVersion, range)) {\n    const msg = `Package \"${pkg}\" outdated. Remote Version: ${range} Local version: ${localRange}. 👈\\n Update package using command: \\n  npm i ${pkg}@${range}\\n  ...or to update all trackunit dependencies: \\n  npx npm-check-updates \"/@trackunit/\" -u`;\n    if (semver.major(localVersion) < semver.major(remoteVersion) && throwError) {\n      throw new Error(msg);\n    } else {\n      // eslint-disable-next-line no-console\n      console.warn(\"⚠️ \" + msg + \"\\n\");\n      return true;\n    }\n  }\n  return true;\n};\n\n/**\n * Get the latest version of the package from the registry.\n *\n * @param pkg package to look for.\n * @returns { Promise<string> } returns version\n */\nexport const getLatestRemoteVersion = async (pkg: string) => {\n  try {\n    const manifest = await pacote.manifest(pkg);\n    return manifest.version;\n  } catch (error) {\n    throw new Error(\n      `Error fetching manifest for package ${pkg}. This package might need to be published, or it has been included as a dependency by mistake.`\n    );\n  }\n};\n\n/**\n * Check if the current version of the package is the same as the one in the manager.\n *\n * @param {string} managerNxVersion version of nx in the manager\n * @returns { boolean} true if its a valid version\n */\nexport async function checkNxVersion(managerNxVersion: string, throwError = true) {\n  const currentNxVersion = execSync(\"nx --version\")\n    .toString(\"utf-8\")\n    .replace(/\\r?\\n|\\r/, \"\"); // regex removes any line breaks\n  return versionCheck(\"nx\", currentNxVersion, managerNxVersion, throwError);\n}\n\n/**\n *\n */\nexport async function checkTrackunitPackages(dependencies: Record<string, string>, throwError = true) {\n  for (const key in dependencies) {\n    const remoteVersion: string | undefined = await getLatestRemoteVersion(key);\n    if (remoteVersion) {\n      const localDependencyVersion: string | undefined = dependencies[key];\n      // If @trackunit dependencies are linked/added locally using \"file:\", skip the version check, used for E2E tests.\n      if (localDependencyVersion && !localDependencyVersion.includes(\"file:\")) {\n        versionCheck(key, localDependencyVersion, remoteVersion, throwError);\n      }\n    }\n  }\n  return true;\n}\n\nfunction getLibraries() {\n  const packageJsonLocal: Record<string, string | Record<string, string>> = readJsonFile(\"package.json\");\n  const trackunitDependencies = objectFromEntries(\n    Object.entries(packageJsonLocal.dependencies || {}).filter(([key]) => key.startsWith(\"@trackunit/\"))\n  );\n  const trackunitDevDependencies = objectFromEntries(\n    Object.entries(packageJsonLocal.devDependencies || {}).filter(([key]) => key.startsWith(\"@trackunit/\"))\n  );\n  return { trackunitDependencies, trackunitDevDependencies };\n}\n\n/**\n *\n */\nexport async function checkPackageVersion(throwError = true) {\n  const { trackunitDependencies, trackunitDevDependencies } = getLibraries();\n  // const managerNxVersion = version.managerNxVersion;\n  // await checkNxVersion(managerNxVersion, throwError);\n  await checkTrackunitPackages(trackunitDependencies, throwError);\n  await checkTrackunitPackages(trackunitDevDependencies, throwError);\n  return true;\n}\n"]}

package/src/getAvailablePort.d.ts

@@ -1,8 +1,8 @@
 /**
  * Gets the first available port in the specified range.
  *
- * @param minPort min port number inclusive
- * @param maxPort max port number inclusive
+ * @param minPort min port number inclusive (1024 to avoid reserved ports)
+ * @param maxPort max port number inclusive (65535 to avoid reserved ports)
  * @returns {number} the first available port in the range
  */
 export declare const getAvailablePort: (minPort: number, maxPort: number) => Promise<number>;

package/src/getAvailablePort.js

@@ -3,39 +3,44 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getAvailablePort = void 0;
 const tslib_1 = require("tslib");
 const net = tslib_1.__importStar(require("net"));
-const findPort = async (port) => {
+/**
+ * Attempts to bind to a port on the specified host.
+ * Returns true if successful, false if the port is in use.
+ */
+const canBindToPort = (port, host) => {
     return new Promise(resolve => {
         const server = net.createServer();
-        server.once("error", (err) => {
-            if (err.code === "EADDRINUSE") {
-                resolve(false);
-            }
-            else {
-                resolve(true);
-            }
-        });
-        server.once("listening", () => {
-            server.close(() => {
-                resolve(true);
-            });
-        });
-        server.listen(port);
+        server.once("error", () => resolve(false));
+        server.once("listening", () => server.close(() => resolve(true)));
+        server.listen(port, host);
     });
 };
+/**
+ * Checks if a port is available on both localhost and all interfaces (0.0.0.0).
+ * Both must be available for the port to be considered free.
+ */
+const isPortAvailable = async (port) => {
+    const availableOnLocalhost = await canBindToPort(port, "localhost");
+    if (!availableOnLocalhost) {
+        return false;
+    }
+    const availableOnAllInterfaces = await canBindToPort(port, "0.0.0.0");
+    return availableOnAllInterfaces;
+};
 /**
  * Gets the first available port in the specified range.
  *
- * @param minPort min port number inclusive
- * @param maxPort max port number inclusive
+ * @param minPort min port number inclusive (1024 to avoid reserved ports)
+ * @param maxPort max port number inclusive (65535 to avoid reserved ports)
  * @returns {number} the first available port in the range
  */
 const getAvailablePort = async (minPort, maxPort) => {
-    if (minPort < 1 || maxPort > 65535 || minPort > maxPort) {
+    if (minPort < 1023 || maxPort > 65535 || minPort > maxPort) {
         throw new Error("Invalid port range.");
     }
     for (let port = minPort; port <= maxPort; port++) {
-        const isAvailable = await findPort(port);
-        if (isAvailable) {
+        const available = await isPortAvailable(port);
+        if (available) {
             return port;
         }
     }

package/src/getAvailablePort.js.map

@@ -1 +1 @@
-{"version":3,"file":"getAvailablePort.js","sourceRoot":"","sources":["../../../../../libs/iris-app-sdk/iris-app-build-utilities/src/getAvailablePort.ts"],"names":[],"mappings":";;;;AAAA,iDAA2B;AAE3B,MAAM,QAAQ,GAAG,KAAK,EAAE,IAAY,EAAoB,EAAE;IACxD,OAAO,IAAI,OAAO,CAAU,OAAO,CAAC,EAAE;QACpC,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,EAAE,CAAC;QAClC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,GAAqB,EAAE,EAAE;YAC7C,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBAC9B,OAAO,CAAC,KAAK,CAAC,CAAC;YACjB,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,IAAI,CAAC,CAAC;YAChB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE;YAC5B,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE;gBAChB,OAAO,CAAC,IAAI,CAAC,CAAC;YAChB,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF;;;;;;GAMG;AACI,MAAM,gBAAgB,GAAG,KAAK,EAAE,OAAe,EAAE,OAAe,EAAmB,EAAE;IAC1F,IAAI,OAAO,GAAG,CAAC,IAAI,OAAO,GAAG,KAAK,IAAI,OAAO,GAAG,OAAO,EAAE,CAAC;QACxD,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,IAAI,IAAI,GAAG,OAAO,EAAE,IAAI,IAAI,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC;QACjD,MAAM,WAAW,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;AAChE,CAAC,CAAC;AAbW,QAAA,gBAAgB,oBAa3B","sourcesContent":["import * as net from \"net\";\n\nconst findPort = async (port: number): Promise<boolean> => {\n  return new Promise<boolean>(resolve => {\n    const server = net.createServer();\n    server.once(\"error\", (err: { code: string }) => {\n      if (err.code === \"EADDRINUSE\") {\n        resolve(false);\n      } else {\n        resolve(true);\n      }\n    });\n\n    server.once(\"listening\", () => {\n      server.close(() => {\n        resolve(true);\n      });\n    });\n\n    server.listen(port);\n  });\n};\n\n/**\n * Gets the first available port in the specified range.\n *\n * @param minPort min port number inclusive\n * @param maxPort max port number inclusive\n * @returns {number} the first available port in the range\n */\nexport const getAvailablePort = async (minPort: number, maxPort: number): Promise<number> => {\n  if (minPort < 1 || maxPort > 65535 || minPort > maxPort) {\n    throw new Error(\"Invalid port range.\");\n  }\n\n  for (let port = minPort; port <= maxPort; port++) {\n    const isAvailable = await findPort(port);\n    if (isAvailable) {\n      return port;\n    }\n  }\n\n  throw new Error(\"No available ports in the specified range.\");\n};\n"]}
+{"version":3,"file":"getAvailablePort.js","sourceRoot":"","sources":["../../../../../libs/iris-app-sdk/iris-app-build-utilities/src/getAvailablePort.ts"],"names":[],"mappings":";;;;AAAA,iDAA2B;AAE3B;;;GAGG;AACH,MAAM,aAAa,GAAG,CAAC,IAAY,EAAE,IAAY,EAAoB,EAAE;IACrE,OAAO,IAAI,OAAO,CAAU,OAAO,CAAC,EAAE;QACpC,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,EAAE,CAAC;QAElC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QAC3C,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAElE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,eAAe,GAAG,KAAK,EAAE,IAAY,EAAoB,EAAE;IAC/D,MAAM,oBAAoB,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IACpE,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,wBAAwB,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACtE,OAAO,wBAAwB,CAAC;AAClC,CAAC,CAAC;AAEF;;;;;;GAMG;AACI,MAAM,gBAAgB,GAAG,KAAK,EAAE,OAAe,EAAE,OAAe,EAAmB,EAAE;IAC1F,IAAI,OAAO,GAAG,IAAI,IAAI,OAAO,GAAG,KAAK,IAAI,OAAO,GAAG,OAAO,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,IAAI,IAAI,GAAG,OAAO,EAAE,IAAI,IAAI,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC;QACjD,MAAM,SAAS,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;AAChE,CAAC,CAAC;AAbW,QAAA,gBAAgB,oBAa3B","sourcesContent":["import * as net from \"net\";\n\n/**\n * Attempts to bind to a port on the specified host.\n * Returns true if successful, false if the port is in use.\n */\nconst canBindToPort = (port: number, host: string): Promise<boolean> => {\n  return new Promise<boolean>(resolve => {\n    const server = net.createServer();\n\n    server.once(\"error\", () => resolve(false));\n    server.once(\"listening\", () => server.close(() => resolve(true)));\n\n    server.listen(port, host);\n  });\n};\n\n/**\n * Checks if a port is available on both localhost and all interfaces (0.0.0.0).\n * Both must be available for the port to be considered free.\n */\nconst isPortAvailable = async (port: number): Promise<boolean> => {\n  const availableOnLocalhost = await canBindToPort(port, \"localhost\");\n  if (!availableOnLocalhost) {\n    return false;\n  }\n\n  const availableOnAllInterfaces = await canBindToPort(port, \"0.0.0.0\");\n  return availableOnAllInterfaces;\n};\n\n/**\n * Gets the first available port in the specified range.\n *\n * @param minPort min port number inclusive (1024 to avoid reserved ports)\n * @param maxPort max port number inclusive (65535 to avoid reserved ports)\n * @returns {number} the first available port in the range\n */\nexport const getAvailablePort = async (minPort: number, maxPort: number): Promise<number> => {\n  if (minPort < 1023 || maxPort > 65535 || minPort > maxPort) {\n    throw new Error(\"Invalid port range.\");\n  }\n\n  for (let port = minPort; port <= maxPort; port++) {\n    const available = await isPortAvailable(port);\n    if (available) {\n      return port;\n    }\n  }\n\n  throw new Error(\"No available ports in the specified range.\");\n};\n"]}

package/src/getCopyPatterns.js

@@ -75,10 +75,12 @@ const getServersideExtensionPatterns = (options) => {
         ];
         // Check if extension has dependencyDefinitionFile and add it to patterns if it exists
         if ("dependencyDefinitionFile" in extension && extension.dependencyDefinitionFile) {
+            const dependencyFileName = path.basename(extension.dependencyDefinitionFile);
             patterns.push({
                 // globs must use / in path to be valid
                 from: path.resolve(nxRootDir, extension.dependencyDefinitionFile.replace(/\\/g, "/")),
-                to: path.join(nxRootDir, "dist", relativeAppDir, "serverside", extension.id),
+                // Must specify full file path (not just directory) for copyFileSync
+                to: path.join(nxRootDir, "dist", relativeAppDir, "serverside", extension.id, dependencyFileName),
             });
         }
         return patterns;
@@ -96,6 +98,20 @@ const getAssetsPattern = (options) => {
         to: path.join(nxRootDir, "dist", relativeAppDir, "assets"),
     };
 };
+/**
+ * Strips the extensionId prefix from a path if present.
+ * The updateExtensions function in extensionUtil.ts modifies image.path to include
+ * the extensionId prefix for runtime loading, but we need the original path for copying.
+ */
+const stripExtensionIdPrefix = (iconPath, extensionId) => {
+    if (iconPath.startsWith(extensionId + "/")) {
+        return iconPath.substring(extensionId.length + 1);
+    }
+    if (iconPath.startsWith(extensionId)) {
+        return iconPath.substring(extensionId.length);
+    }
+    return iconPath;
+};
 /**
  * Generates copy patterns for extension icons (fleet menu icons and widget icons).
  */
@@ -105,11 +121,18 @@ const getIconPatterns = (options) => {
     const fleetIconPaths = getFleetExtensionIconPaths(manifest);
     const widgetIconPaths = getWidgetExtensionIconPaths(manifest);
     const allIconPaths = [...fleetIconPaths, ...widgetIconPaths];
-    return allIconPaths.map(iconPath => ({
-        // globs must use / in path to be valid
-        from: path.join(nxRootDir, iconPath.sourceRoot, iconPath.path).replace(/\\/g, "/"),
-        to: path.join(nxRootDir, "dist", relativeAppDir, iconPath.extensionId, iconPath.path),
-    }));
+    return allIconPaths.map(iconPath => {
+        // The path may have been modified to include extensionId prefix by updateExtensions.
+        // We need the original path (without prefix) for the source file location.
+        const originalPath = stripExtensionIdPrefix(iconPath.path, iconPath.extensionId);
+        return {
+            // Source file is at sourceRoot/originalPath (without extensionId prefix)
+            // globs must use / in path to be valid
+            from: path.join(nxRootDir, iconPath.sourceRoot, originalPath).replace(/\\/g, "/"),
+            // Destination is at dist/appDir/extensionId/originalPath
+            to: path.join(nxRootDir, "dist", relativeAppDir, iconPath.extensionId, originalPath),
+        };
+    });
 };
 /**
  * Gets all copy patterns for an Iris app build.

package/src/getCopyPatterns.js.map

@@ -1 +1 @@
-{"version":3,"file":"getCopyPatterns.js","sourceRoot":"","sources":["../../../../../libs/iris-app-sdk/iris-app-build-utilities/src/getCopyPatterns.ts"],"names":[],"mappings":"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","sourcesContent":["import { IrisAppManifest, isIconByPath, isImageByPath, serverSideExtensionTypes } from \"@trackunit/iris-app-api\";\nimport * as path from \"path\";\n\n/**\n * Represents a copy pattern for CopyWebpackPlugin/CopyRspackPlugin/vite-plugin-static-copy\n */\nexport interface CopyPattern {\n  /** Source path (with forward slashes for glob compatibility) */\n  from: string;\n  /** Destination path */\n  to: string;\n}\n\n/**\n * Represents an icon path extracted from the manifest\n */\ninterface IconPath {\n  extensionId: string;\n  path: string;\n  sourceRoot: string;\n}\n\ninterface GetCopyPatternsOptions {\n  /** The root of the nx workspace */\n  nxRootDir: string;\n  /** The app directory */\n  appDir: string;\n  /** The Iris app manifest */\n  manifest: IrisAppManifest;\n  /** Build mode - serverside extensions are only copied in production */\n  mode: \"production\" | \"development\";\n}\n\n/**\n * Extracts icon paths from FLEET_EXTENSION menu items.\n * These are SVG icons that need to be copied to the output directory.\n */\nconst getFleetExtensionIconPaths = (manifest: IrisAppManifest): Array<IconPath> => {\n  return manifest.extensions\n    .filter(extension => {\n      return extension.type === \"FLEET_EXTENSION\" && extension.menuItem.image && isIconByPath(extension.menuItem.image);\n    })\n    .map(extension => {\n      if (\n        extension.type !== \"FLEET_EXTENSION\" ||\n        !extension.menuItem.image ||\n        !isIconByPath(extension.menuItem.image)\n      ) {\n        throw new Error(\"Unexpected extension type after filter\");\n      }\n      return {\n        extensionId: extension.id,\n        path: extension.menuItem.image.path,\n        sourceRoot: extension.sourceRoot,\n      };\n    });\n};\n\n/**\n * Extracts icon paths from WIDGET_EXTENSION headers and footers.\n * Widgets can have both a header image and a footer poweredByImage.\n */\nconst getWidgetExtensionIconPaths = (manifest: IrisAppManifest): Array<IconPath> => {\n  return manifest.extensions.flatMap(extension => {\n    const paths: Array<IconPath> = [];\n\n    if (\n      extension.type === \"WIDGET_EXTENSION\" &&\n      extension.footer?.poweredByImage &&\n      isImageByPath(extension.footer.poweredByImage)\n    ) {\n      paths.push({\n        extensionId: extension.id,\n        path: extension.footer.poweredByImage.path,\n        sourceRoot: extension.sourceRoot,\n      });\n    }\n\n    if (extension.type === \"WIDGET_EXTENSION\" && extension.header.image && isIconByPath(extension.header.image)) {\n      paths.push({\n        extensionId: extension.id,\n        path: extension.header.image.path,\n        sourceRoot: extension.sourceRoot,\n      });\n    }\n\n    return paths;\n  });\n};\n\n/**\n * Generates copy patterns for serverside extensions (LIFECYCLE_EXTENSION, SERVERLESS_FUNCTION_EXTENSION, AI_AGENT_EXTENSION).\n * These are only copied in production mode.\n */\nconst getServersideExtensionPatterns = (options: GetCopyPatternsOptions): Array<CopyPattern> => {\n  const { nxRootDir, appDir, manifest, mode } = options;\n  const relativeAppDir = appDir.split(nxRootDir)[1] || \"<unknown appdir>\";\n\n  // Only copy serverside extensions in production\n  if (mode !== \"production\") {\n    return [];\n  }\n\n  return manifest.extensions\n    .filter(extension => serverSideExtensionTypes.includes(extension.type))\n    .flatMap(extension => {\n      const patterns: Array<CopyPattern> = [\n        {\n          // globs must use / in path to be valid\n          from: path.resolve(nxRootDir, extension.sourceRoot.replace(/\\\\/g, \"/\")),\n          to: path.join(nxRootDir, \"dist\", relativeAppDir, \"serverside\", extension.id),\n        },\n      ];\n\n      // Check if extension has dependencyDefinitionFile and add it to patterns if it exists\n      if (\"dependencyDefinitionFile\" in extension && extension.dependencyDefinitionFile) {\n        patterns.push({\n          // globs must use / in path to be valid\n          from: path.resolve(nxRootDir, extension.dependencyDefinitionFile.replace(/\\\\/g, \"/\")),\n          to: path.join(nxRootDir, \"dist\", relativeAppDir, \"serverside\", extension.id),\n        });\n      }\n\n      return patterns;\n    });\n};\n\n/**\n * Generates the copy pattern for the assets folder.\n */\nconst getAssetsPattern = (options: GetCopyPatternsOptions): CopyPattern => {\n  const { nxRootDir, appDir } = options;\n  const relativeAppDir = appDir.split(nxRootDir)[1] || \"<unknown appdir>\";\n\n  return {\n    // globs must use / in path to be valid\n    from: path.join(appDir, \"assets/\").replace(/\\\\/g, \"/\"),\n    to: path.join(nxRootDir, \"dist\", relativeAppDir, \"assets\"),\n  };\n};\n\n/**\n * Generates copy patterns for extension icons (fleet menu icons and widget icons).\n */\nconst getIconPatterns = (options: GetCopyPatternsOptions): Array<CopyPattern> => {\n  const { nxRootDir, appDir, manifest } = options;\n  const relativeAppDir = appDir.split(nxRootDir)[1] || \"<unknown appdir>\";\n\n  const fleetIconPaths = getFleetExtensionIconPaths(manifest);\n  const widgetIconPaths = getWidgetExtensionIconPaths(manifest);\n  const allIconPaths = [...fleetIconPaths, ...widgetIconPaths];\n\n  return allIconPaths.map(iconPath => ({\n    // globs must use / in path to be valid\n    from: path.join(nxRootDir, iconPath.sourceRoot, iconPath.path).replace(/\\\\/g, \"/\"),\n    to: path.join(nxRootDir, \"dist\", relativeAppDir, iconPath.extensionId, iconPath.path),\n  }));\n};\n\n/**\n * Gets all copy patterns for an Iris app build.\n *\n * This utility consolidates the copy patterns logic used by webpack, rspack, and vite builds.\n * It generates patterns for:\n * - Serverside extensions (only in production mode)\n * - Assets folder\n * - Extension icons (fleet menu icons and widget icons)\n *\n * @param options - Configuration options for generating copy patterns\n * @returns {Array<CopyPattern>} Array of copy patterns with `from` and `to` paths\n * @example\n * ```ts\n * const patterns = getCopyPatterns({\n *   nxRootDir: '/path/to/workspace',\n *   appDir: '/path/to/workspace/apps/my-app',\n *   manifest: irisAppManifest,\n *   mode: 'production',\n * });\n *\n * // Use with CopyWebpackPlugin\n * new CopyWebpackPlugin({ patterns });\n *\n * // Use with CopyRspackPlugin\n * new CopyRspackPlugin({ patterns });\n * ```\n */\nexport const getCopyPatterns = (options: GetCopyPatternsOptions): Array<CopyPattern> => {\n  return [...getServersideExtensionPatterns(options), getAssetsPattern(options), ...getIconPatterns(options)];\n};\n"]}
+{"version":3,"file":"getCopyPatterns.js","sourceRoot":"","sources":["../../../../../libs/iris-app-sdk/iris-app-build-utilities/src/getCopyPatterns.ts"],"names":[],"mappings":"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","sourcesContent":["import { IrisAppManifest, isIconByPath, isImageByPath, serverSideExtensionTypes } from \"@trackunit/iris-app-api\";\nimport * as path from \"path\";\n\n/**\n * Represents a copy pattern for CopyWebpackPlugin/CopyRspackPlugin/vite-plugin-static-copy\n */\nexport interface CopyPattern {\n  /** Source path (with forward slashes for glob compatibility) */\n  from: string;\n  /** Destination path */\n  to: string;\n}\n\n/**\n * Represents an icon path extracted from the manifest\n */\ninterface IconPath {\n  extensionId: string;\n  path: string;\n  sourceRoot: string;\n}\n\ninterface GetCopyPatternsOptions {\n  /** The root of the nx workspace */\n  nxRootDir: string;\n  /** The app directory */\n  appDir: string;\n  /** The Iris app manifest */\n  manifest: IrisAppManifest;\n  /** Build mode - serverside extensions are only copied in production */\n  mode: \"production\" | \"development\";\n}\n\n/**\n * Extracts icon paths from FLEET_EXTENSION menu items.\n * These are SVG icons that need to be copied to the output directory.\n */\nconst getFleetExtensionIconPaths = (manifest: IrisAppManifest): Array<IconPath> => {\n  return manifest.extensions\n    .filter(extension => {\n      return extension.type === \"FLEET_EXTENSION\" && extension.menuItem.image && isIconByPath(extension.menuItem.image);\n    })\n    .map(extension => {\n      if (\n        extension.type !== \"FLEET_EXTENSION\" ||\n        !extension.menuItem.image ||\n        !isIconByPath(extension.menuItem.image)\n      ) {\n        throw new Error(\"Unexpected extension type after filter\");\n      }\n      return {\n        extensionId: extension.id,\n        path: extension.menuItem.image.path,\n        sourceRoot: extension.sourceRoot,\n      };\n    });\n};\n\n/**\n * Extracts icon paths from WIDGET_EXTENSION headers and footers.\n * Widgets can have both a header image and a footer poweredByImage.\n */\nconst getWidgetExtensionIconPaths = (manifest: IrisAppManifest): Array<IconPath> => {\n  return manifest.extensions.flatMap(extension => {\n    const paths: Array<IconPath> = [];\n\n    if (\n      extension.type === \"WIDGET_EXTENSION\" &&\n      extension.footer?.poweredByImage &&\n      isImageByPath(extension.footer.poweredByImage)\n    ) {\n      paths.push({\n        extensionId: extension.id,\n        path: extension.footer.poweredByImage.path,\n        sourceRoot: extension.sourceRoot,\n      });\n    }\n\n    if (extension.type === \"WIDGET_EXTENSION\" && extension.header.image && isIconByPath(extension.header.image)) {\n      paths.push({\n        extensionId: extension.id,\n        path: extension.header.image.path,\n        sourceRoot: extension.sourceRoot,\n      });\n    }\n\n    return paths;\n  });\n};\n\n/**\n * Generates copy patterns for serverside extensions (LIFECYCLE_EXTENSION, SERVERLESS_FUNCTION_EXTENSION, AI_AGENT_EXTENSION).\n * These are only copied in production mode.\n */\nconst getServersideExtensionPatterns = (options: GetCopyPatternsOptions): Array<CopyPattern> => {\n  const { nxRootDir, appDir, manifest, mode } = options;\n  const relativeAppDir = appDir.split(nxRootDir)[1] || \"<unknown appdir>\";\n\n  // Only copy serverside extensions in production\n  if (mode !== \"production\") {\n    return [];\n  }\n\n  return manifest.extensions\n    .filter(extension => serverSideExtensionTypes.includes(extension.type))\n    .flatMap(extension => {\n      const patterns: Array<CopyPattern> = [\n        {\n          // globs must use / in path to be valid\n          from: path.resolve(nxRootDir, extension.sourceRoot.replace(/\\\\/g, \"/\")),\n          to: path.join(nxRootDir, \"dist\", relativeAppDir, \"serverside\", extension.id),\n        },\n      ];\n\n      // Check if extension has dependencyDefinitionFile and add it to patterns if it exists\n      if (\"dependencyDefinitionFile\" in extension && extension.dependencyDefinitionFile) {\n        const dependencyFileName = path.basename(extension.dependencyDefinitionFile);\n        patterns.push({\n          // globs must use / in path to be valid\n          from: path.resolve(nxRootDir, extension.dependencyDefinitionFile.replace(/\\\\/g, \"/\")),\n          // Must specify full file path (not just directory) for copyFileSync\n          to: path.join(nxRootDir, \"dist\", relativeAppDir, \"serverside\", extension.id, dependencyFileName),\n        });\n      }\n\n      return patterns;\n    });\n};\n\n/**\n * Generates the copy pattern for the assets folder.\n */\nconst getAssetsPattern = (options: GetCopyPatternsOptions): CopyPattern => {\n  const { nxRootDir, appDir } = options;\n  const relativeAppDir = appDir.split(nxRootDir)[1] || \"<unknown appdir>\";\n\n  return {\n    // globs must use / in path to be valid\n    from: path.join(appDir, \"assets/\").replace(/\\\\/g, \"/\"),\n    to: path.join(nxRootDir, \"dist\", relativeAppDir, \"assets\"),\n  };\n};\n\n/**\n * Strips the extensionId prefix from a path if present.\n * The updateExtensions function in extensionUtil.ts modifies image.path to include\n * the extensionId prefix for runtime loading, but we need the original path for copying.\n */\nconst stripExtensionIdPrefix = (iconPath: string, extensionId: string): string => {\n  if (iconPath.startsWith(extensionId + \"/\")) {\n    return iconPath.substring(extensionId.length + 1);\n  }\n  if (iconPath.startsWith(extensionId)) {\n    return iconPath.substring(extensionId.length);\n  }\n  return iconPath;\n};\n\n/**\n * Generates copy patterns for extension icons (fleet menu icons and widget icons).\n */\nconst getIconPatterns = (options: GetCopyPatternsOptions): Array<CopyPattern> => {\n  const { nxRootDir, appDir, manifest } = options;\n  const relativeAppDir = appDir.split(nxRootDir)[1] || \"<unknown appdir>\";\n\n  const fleetIconPaths = getFleetExtensionIconPaths(manifest);\n  const widgetIconPaths = getWidgetExtensionIconPaths(manifest);\n  const allIconPaths = [...fleetIconPaths, ...widgetIconPaths];\n\n  return allIconPaths.map(iconPath => {\n    // The path may have been modified to include extensionId prefix by updateExtensions.\n    // We need the original path (without prefix) for the source file location.\n    const originalPath = stripExtensionIdPrefix(iconPath.path, iconPath.extensionId);\n\n    return {\n      // Source file is at sourceRoot/originalPath (without extensionId prefix)\n      // globs must use / in path to be valid\n      from: path.join(nxRootDir, iconPath.sourceRoot, originalPath).replace(/\\\\/g, \"/\"),\n      // Destination is at dist/appDir/extensionId/originalPath\n      to: path.join(nxRootDir, \"dist\", relativeAppDir, iconPath.extensionId, originalPath),\n    };\n  });\n};\n\n/**\n * Gets all copy patterns for an Iris app build.\n *\n * This utility consolidates the copy patterns logic used by webpack, rspack, and vite builds.\n * It generates patterns for:\n * - Serverside extensions (only in production mode)\n * - Assets folder\n * - Extension icons (fleet menu icons and widget icons)\n *\n * @param options - Configuration options for generating copy patterns\n * @returns {Array<CopyPattern>} Array of copy patterns with `from` and `to` paths\n * @example\n * ```ts\n * const patterns = getCopyPatterns({\n *   nxRootDir: '/path/to/workspace',\n *   appDir: '/path/to/workspace/apps/my-app',\n *   manifest: irisAppManifest,\n *   mode: 'production',\n * });\n *\n * // Use with CopyWebpackPlugin\n * new CopyWebpackPlugin({ patterns });\n *\n * // Use with CopyRspackPlugin\n * new CopyRspackPlugin({ patterns });\n * ```\n */\nexport const getCopyPatterns = (options: GetCopyPatternsOptions): Array<CopyPattern> => {\n  return [...getServersideExtensionPatterns(options), getAssetsPattern(options), ...getIconPatterns(options)];\n};\n"]}

package/src/index.d.ts

@@ -1,3 +1,4 @@
+export * from "./checkPackageVersion";
 export * from "./enableTsConfigPath";
 export * from "./getAliasesFromTsConfig";
 export * from "./getAvailablePort";

package/src/index.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./checkPackageVersion"), exports);
 tslib_1.__exportStar(require("./enableTsConfigPath"), exports);
 tslib_1.__exportStar(require("./getAliasesFromTsConfig"), exports);
 tslib_1.__exportStar(require("./getAvailablePort"), exports);

package/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../libs/iris-app-sdk/iris-app-build-utilities/src/index.ts"],"names":[],"mappings":";;;AAAA,+DAAqC;AACrC,mEAAyC;AACzC,6DAAmC;AACnC,4DAAkC;AAClC,iEAAuC;AACvC,oEAA0C;AAC1C,gEAAsC;AACtC,kEAAwC;AACxC,qEAA2C;AAC3C,uEAA6C;AAC7C,0EAAgD;AAChD,wEAA8C;AAC9C,wEAA8C","sourcesContent":["export * from \"./enableTsConfigPath\";\nexport * from \"./getAliasesFromTsConfig\";\nexport * from \"./getAvailablePort\";\nexport * from \"./getCopyPatterns\";\nexport * from \"./getExposedExtensions\";\nexport * from \"./getGraphqlCodeGenConfig\";\nexport * from \"./getIrisAppDevServer\";\nexport * from \"./getSharedDependencies\";\nexport * from \"./getTailwindContentForApp\";\nexport * from \"./plugin-shared/consoleUtils\";\nexport * from \"./plugin-shared/customFieldUtil\";\nexport * from \"./plugin-shared/extensionUtil\";\nexport * from \"./plugin-shared/indexHtmlUtil\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../libs/iris-app-sdk/iris-app-build-utilities/src/index.ts"],"names":[],"mappings":";;;AAAA,gEAAsC;AACtC,+DAAqC;AACrC,mEAAyC;AACzC,6DAAmC;AACnC,4DAAkC;AAClC,iEAAuC;AACvC,oEAA0C;AAC1C,gEAAsC;AACtC,kEAAwC;AACxC,qEAA2C;AAC3C,uEAA6C;AAC7C,0EAAgD;AAChD,wEAA8C;AAC9C,wEAA8C","sourcesContent":["export * from \"./checkPackageVersion\";\nexport * from \"./enableTsConfigPath\";\nexport * from \"./getAliasesFromTsConfig\";\nexport * from \"./getAvailablePort\";\nexport * from \"./getCopyPatterns\";\nexport * from \"./getExposedExtensions\";\nexport * from \"./getGraphqlCodeGenConfig\";\nexport * from \"./getIrisAppDevServer\";\nexport * from \"./getSharedDependencies\";\nexport * from \"./getTailwindContentForApp\";\nexport * from \"./plugin-shared/consoleUtils\";\nexport * from \"./plugin-shared/customFieldUtil\";\nexport * from \"./plugin-shared/extensionUtil\";\nexport * from \"./plugin-shared/indexHtmlUtil\";\n"]}

package/src/version.d.ts

@@ -0,0 +1,4 @@
+export declare const version: {
+    managerNxVersion: string;
+    managerNodeVersion: string;
+};

package/src/version.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.version = void 0;
+// The major version of NX and Node specified here will be matched with corresponding versions in the iris app.
+exports.version = {
+    managerNxVersion: "^19.8.3",
+    managerNodeVersion: "^22.14.0",
+};
+//# sourceMappingURL=version.js.map

package/src/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../../../../libs/iris-app-sdk/iris-app-build-utilities/src/version.ts"],"names":[],"mappings":";;;AAAA,+GAA+G;AAClG,QAAA,OAAO,GAAG;IACrB,gBAAgB,EAAE,SAAS;IAC3B,kBAAkB,EAAE,UAAU;CAC/B,CAAC","sourcesContent":["// The major version of NX and Node specified here will be matched with corresponding versions in the iris app.\nexport const version = {\n  managerNxVersion: \"^19.8.3\",\n  managerNodeVersion: \"^22.14.0\",\n};\n\n"]}