@uipath/solution-packager 0.0.34 → 1.196.0

package/dist/index.js

@@ -8,6 +8,9 @@ var de_default = {
         pathRequired: "Solution directory path is required",
         fileNotFound: "Solution file not found: {path}",
         invalidSolution: "Invalid solution file: {path}",
+        projectMustBeObject: "Invalid solution file: {path}. Projects[{index}] must be an object.",
+        projectMissingProjectRelativePath: `Invalid solution file: {path}. Projects[{index}] is missing ProjectRelativePath.{pathHint} Use 'uip solution project add' to add projects, or set ProjectRelativePath to the project file path, for example "Foo/project.uiproj".`,
+        projectRelativePathPathHint: " Found Path, but .uipx uses ProjectRelativePath.",
         noSolutionFile: "No .uipx solution file found in directory: {path}",
         invalidStorageFile: "Invalid {fileName} file"
       }
@@ -30,6 +33,9 @@ var en = {
         pathRequired: "Solution directory path is required",
         fileNotFound: "Solution file not found: {path}",
         invalidSolution: "Invalid solution file: {path}",
+        projectMustBeObject: "Invalid solution file: {path}. Projects[{index}] must be an object.",
+        projectMissingProjectRelativePath: `Invalid solution file: {path}. Projects[{index}] is missing ProjectRelativePath.{pathHint} Use 'uip solution project add' to add projects, or set ProjectRelativePath to the project file path, for example "Foo/project.uiproj".`,
+        projectRelativePathPathHint: " Found Path, but .uipx uses ProjectRelativePath.",
         noSolutionFile: "No .uipx solution file found in directory: {path}",
         invalidStorageFile: "Invalid {fileName} file"
       }
@@ -51,6 +57,9 @@ var es_default = {
         pathRequired: "Solution directory path is required",
         fileNotFound: "Solution file not found: {path}",
         invalidSolution: "Invalid solution file: {path}",
+        projectMustBeObject: "Invalid solution file: {path}. Projects[{index}] must be an object.",
+        projectMissingProjectRelativePath: `Invalid solution file: {path}. Projects[{index}] is missing ProjectRelativePath.{pathHint} Use 'uip solution project add' to add projects, or set ProjectRelativePath to the project file path, for example "Foo/project.uiproj".`,
+        projectRelativePathPathHint: " Found Path, but .uipx uses ProjectRelativePath.",
         noSolutionFile: "No .uipx solution file found in directory: {path}",
         invalidStorageFile: "Invalid {fileName} file"
       }
@@ -72,6 +81,9 @@ var es_MX_default = {
         pathRequired: "Solution directory path is required",
         fileNotFound: "Solution file not found: {path}",
         invalidSolution: "Invalid solution file: {path}",
+        projectMustBeObject: "Invalid solution file: {path}. Projects[{index}] must be an object.",
+        projectMissingProjectRelativePath: `Invalid solution file: {path}. Projects[{index}] is missing ProjectRelativePath.{pathHint} Use 'uip solution project add' to add projects, or set ProjectRelativePath to the project file path, for example "Foo/project.uiproj".`,
+        projectRelativePathPathHint: " Found Path, but .uipx uses ProjectRelativePath.",
         noSolutionFile: "No .uipx solution file found in directory: {path}",
         invalidStorageFile: "Invalid {fileName} file"
       }
@@ -93,6 +105,9 @@ var fr_default = {
         pathRequired: "Solution directory path is required",
         fileNotFound: "Solution file not found: {path}",
         invalidSolution: "Invalid solution file: {path}",
+        projectMustBeObject: "Invalid solution file: {path}. Projects[{index}] must be an object.",
+        projectMissingProjectRelativePath: `Invalid solution file: {path}. Projects[{index}] is missing ProjectRelativePath.{pathHint} Use 'uip solution project add' to add projects, or set ProjectRelativePath to the project file path, for example "Foo/project.uiproj".`,
+        projectRelativePathPathHint: " Found Path, but .uipx uses ProjectRelativePath.",
         noSolutionFile: "No .uipx solution file found in directory: {path}",
         invalidStorageFile: "Invalid {fileName} file"
       }
@@ -114,6 +129,9 @@ var ja_default = {
         pathRequired: "Solution directory path is required",
         fileNotFound: "Solution file not found: {path}",
         invalidSolution: "Invalid solution file: {path}",
+        projectMustBeObject: "Invalid solution file: {path}. Projects[{index}] must be an object.",
+        projectMissingProjectRelativePath: `Invalid solution file: {path}. Projects[{index}] is missing ProjectRelativePath.{pathHint} Use 'uip solution project add' to add projects, or set ProjectRelativePath to the project file path, for example "Foo/project.uiproj".`,
+        projectRelativePathPathHint: " Found Path, but .uipx uses ProjectRelativePath.",
         noSolutionFile: "No .uipx solution file found in directory: {path}",
         invalidStorageFile: "Invalid {fileName} file"
       }
@@ -135,6 +153,9 @@ var ko_default = {
         pathRequired: "Solution directory path is required",
         fileNotFound: "Solution file not found: {path}",
         invalidSolution: "Invalid solution file: {path}",
+        projectMustBeObject: "Invalid solution file: {path}. Projects[{index}] must be an object.",
+        projectMissingProjectRelativePath: `Invalid solution file: {path}. Projects[{index}] is missing ProjectRelativePath.{pathHint} Use 'uip solution project add' to add projects, or set ProjectRelativePath to the project file path, for example "Foo/project.uiproj".`,
+        projectRelativePathPathHint: " Found Path, but .uipx uses ProjectRelativePath.",
         noSolutionFile: "No .uipx solution file found in directory: {path}",
         invalidStorageFile: "Invalid {fileName} file"
       }
@@ -156,6 +177,9 @@ var pt_default = {
         pathRequired: "Solution directory path is required",
         fileNotFound: "Solution file not found: {path}",
         invalidSolution: "Invalid solution file: {path}",
+        projectMustBeObject: "Invalid solution file: {path}. Projects[{index}] must be an object.",
+        projectMissingProjectRelativePath: `Invalid solution file: {path}. Projects[{index}] is missing ProjectRelativePath.{pathHint} Use 'uip solution project add' to add projects, or set ProjectRelativePath to the project file path, for example "Foo/project.uiproj".`,
+        projectRelativePathPathHint: " Found Path, but .uipx uses ProjectRelativePath.",
         noSolutionFile: "No .uipx solution file found in directory: {path}",
         invalidStorageFile: "Invalid {fileName} file"
       }
@@ -177,6 +201,9 @@ var pt_BR_default = {
         pathRequired: "Solution directory path is required",
         fileNotFound: "Solution file not found: {path}",
         invalidSolution: "Invalid solution file: {path}",
+        projectMustBeObject: "Invalid solution file: {path}. Projects[{index}] must be an object.",
+        projectMissingProjectRelativePath: `Invalid solution file: {path}. Projects[{index}] is missing ProjectRelativePath.{pathHint} Use 'uip solution project add' to add projects, or set ProjectRelativePath to the project file path, for example "Foo/project.uiproj".`,
+        projectRelativePathPathHint: " Found Path, but .uipx uses ProjectRelativePath.",
         noSolutionFile: "No .uipx solution file found in directory: {path}",
         invalidStorageFile: "Invalid {fileName} file"
       }
@@ -198,6 +225,9 @@ var ro_default = {
         pathRequired: "Solution directory path is required",
         fileNotFound: "Solution file not found: {path}",
         invalidSolution: "Invalid solution file: {path}",
+        projectMustBeObject: "Invalid solution file: {path}. Projects[{index}] must be an object.",
+        projectMissingProjectRelativePath: `Invalid solution file: {path}. Projects[{index}] is missing ProjectRelativePath.{pathHint} Use 'uip solution project add' to add projects, or set ProjectRelativePath to the project file path, for example "Foo/project.uiproj".`,
+        projectRelativePathPathHint: " Found Path, but .uipx uses ProjectRelativePath.",
         noSolutionFile: "No .uipx solution file found in directory: {path}",
         invalidStorageFile: "Invalid {fileName} file"
       }
@@ -219,6 +249,9 @@ var ru_default = {
         pathRequired: "Solution directory path is required",
         fileNotFound: "Solution file not found: {path}",
         invalidSolution: "Invalid solution file: {path}",
+        projectMustBeObject: "Invalid solution file: {path}. Projects[{index}] must be an object.",
+        projectMissingProjectRelativePath: `Invalid solution file: {path}. Projects[{index}] is missing ProjectRelativePath.{pathHint} Use 'uip solution project add' to add projects, or set ProjectRelativePath to the project file path, for example "Foo/project.uiproj".`,
+        projectRelativePathPathHint: " Found Path, but .uipx uses ProjectRelativePath.",
         noSolutionFile: "No .uipx solution file found in directory: {path}",
         invalidStorageFile: "Invalid {fileName} file"
       }
@@ -240,6 +273,9 @@ var tr_default = {
         pathRequired: "Solution directory path is required",
         fileNotFound: "Solution file not found: {path}",
         invalidSolution: "Invalid solution file: {path}",
+        projectMustBeObject: "Invalid solution file: {path}. Projects[{index}] must be an object.",
+        projectMissingProjectRelativePath: `Invalid solution file: {path}. Projects[{index}] is missing ProjectRelativePath.{pathHint} Use 'uip solution project add' to add projects, or set ProjectRelativePath to the project file path, for example "Foo/project.uiproj".`,
+        projectRelativePathPathHint: " Found Path, but .uipx uses ProjectRelativePath.",
         noSolutionFile: "No .uipx solution file found in directory: {path}",
         invalidStorageFile: "Invalid {fileName} file"
       }
@@ -261,6 +297,9 @@ var zh_CN_default = {
         pathRequired: "Solution directory path is required",
         fileNotFound: "Solution file not found: {path}",
         invalidSolution: "Invalid solution file: {path}",
+        projectMustBeObject: "Invalid solution file: {path}. Projects[{index}] must be an object.",
+        projectMissingProjectRelativePath: `Invalid solution file: {path}. Projects[{index}] is missing ProjectRelativePath.{pathHint} Use 'uip solution project add' to add projects, or set ProjectRelativePath to the project file path, for example "Foo/project.uiproj".`,
+        projectRelativePathPathHint: " Found Path, but .uipx uses ProjectRelativePath.",
         noSolutionFile: "No .uipx solution file found in directory: {path}",
         invalidStorageFile: "Invalid {fileName} file"
       }
@@ -282,6 +321,9 @@ var zh_TW_default = {
         pathRequired: "Solution directory path is required",
         fileNotFound: "Solution file not found: {path}",
         invalidSolution: "Invalid solution file: {path}",
+        projectMustBeObject: "Invalid solution file: {path}. Projects[{index}] must be an object.",
+        projectMissingProjectRelativePath: `Invalid solution file: {path}. Projects[{index}] is missing ProjectRelativePath.{pathHint} Use 'uip solution project add' to add projects, or set ProjectRelativePath to the project file path, for example "Foo/project.uiproj".`,
+        projectRelativePathPathHint: " Found Path, but .uipx uses ProjectRelativePath.",
         noSolutionFile: "No .uipx solution file found in directory: {path}",
         invalidStorageFile: "Invalid {fileName} file"
       }
@@ -303,6 +345,9 @@ var zu_default = {
         pathRequired: "Solution directory path is required",
         fileNotFound: "Solution file not found: {path}",
         invalidSolution: "Invalid solution file: {path}",
+        projectMustBeObject: "Invalid solution file: {path}. Projects[{index}] must be an object.",
+        projectMissingProjectRelativePath: `Invalid solution file: {path}. Projects[{index}] is missing ProjectRelativePath.{pathHint} Use 'uip solution project add' to add projects, or set ProjectRelativePath to the project file path, for example "Foo/project.uiproj".`,
+        projectRelativePathPathHint: " Found Path, but .uipx uses ProjectRelativePath.",
         noSolutionFile: "No .uipx solution file found in directory: {path}",
         invalidStorageFile: "Invalid {fileName} file"
       }
@@ -342,17 +387,8 @@ import {
 } from "@uipath/solutionpackager-tool-core";
 
 // src/browser-solution-packager-factory.ts
-import {
-  BrowserContextStorage,
-  ConsoleTelemetryProvider,
-  TelemetryService
-} from "@uipath/common/telemetry";
-import { BrowserFileSystem } from "@uipath/filesystem/browser";
-import {
-  setGlobalLogHandler,
-  ToolLogger as ToolLogger2
-} from "@uipath/project-packager";
-import { translate as translate4 } from "@uipath/solutionpackager-tool-core";
+import { ToolLogger as ToolLogger2 } from "@uipath/project-packager";
+import { BaseBrowserPackagerFactory } from "@uipath/project-packager/browser";
 
 // src/services/solution-packager.ts
 import {
@@ -631,7 +667,7 @@ import { Path as Path3, translate as translate2 } from "@uipath/solutionpackager
 
 class SolutionLoader {
   fileSystem;
-  static SolutionStorageFileName = ".storage";
+  static SolutionStorageFileName = "SolutionStorage.json";
   constructor(fileSystem) {
     this.fileSystem = fileSystem;
   }
@@ -647,12 +683,8 @@ class SolutionLoader {
       }));
     }
     const json = typeof fileContent === "string" ? fileContent : new TextDecoder("utf-8").decode(fileContent);
-    const solution = JSON.parse(json);
-    if (!solution?.Projects) {
-      throw new Error(translate2.t("solutionpackager.solutionLoader.errors.invalidSolution", {
-        path: solutionFilePath
-      }));
-    }
+    const parsed = JSON.parse(json);
+    const solution = validateSolutionFile(parsed, solutionFilePath);
     const loadedSolution = {
       ...solution,
       Name: GetSolutionName(),
@@ -704,6 +736,38 @@ class SolutionLoader {
     }
   }
 }
+function validateSolutionFile(parsed, solutionFilePath) {
+  if (!isRecord(parsed)) {
+    throw new Error(translate2.t("solutionpackager.solutionLoader.errors.invalidSolution", {
+      path: solutionFilePath
+    }));
+  }
+  if (!Array.isArray(parsed.Projects)) {
+    throw new Error(translate2.t("solutionpackager.solutionLoader.errors.invalidSolution", {
+      path: solutionFilePath
+    }));
+  }
+  for (const [index, project] of parsed.Projects.entries()) {
+    if (!isRecord(project)) {
+      throw new Error(translate2.t("solutionpackager.solutionLoader.errors.projectMustBeObject", {
+        path: solutionFilePath,
+        index
+      }));
+    }
+    if (typeof project.ProjectRelativePath !== "string" || !project.ProjectRelativePath.trim()) {
+      const pathHint = typeof project.Path === "string" ? translate2.t("solutionpackager.solutionLoader.errors.projectRelativePathPathHint") : "";
+      throw new Error(translate2.t("solutionpackager.solutionLoader.errors.projectMissingProjectRelativePath", {
+        path: solutionFilePath,
+        index,
+        pathHint
+      }));
+    }
+  }
+  return parsed;
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
 
 // src/services/solution-pack-options-validator.ts
 import {
@@ -798,6 +862,7 @@ class SolutionPackService {
     return await this.telemetry.trackDependencyOperation("SolutionPackager.Solution.Compress" /* SolutionCompress */, "compress", async () => {
       const packageName = parameters.package.id || "solution";
       const version = parameters.package.version || "1.0.0";
+      await this.writePackageMetadataAsync(parameters, outputPath);
       const archiveFileName = `${packageName}_${version}.zip`;
       const archivePath = `${parameters.destinationPath}/${archiveFileName}`;
       const zipData = await this.zipService.compressAsync(outputPath);
@@ -805,6 +870,29 @@ class SolutionPackService {
       return archivePath;
     });
   }
+  async writePackageMetadataAsync(parameters, outputPath) {
+    const pkg = parameters.package;
+    const metadata = {
+      name: pkg.id || "solution",
+      version: pkg.version || "1.0.0"
+    };
+    const optional = {
+      releaseNotes: pkg.releaseNotes,
+      projectUrl: pkg.projectUrl,
+      repositoryType: pkg.repositoryType,
+      repositoryUrl: pkg.repositoryUrl,
+      repositoryBranch: pkg.repositoryBranch,
+      repositoryCommit: pkg.repositoryCommit
+    };
+    for (const [key, value] of Object.entries(optional)) {
+      if (value !== undefined && value !== "") {
+        metadata[key] = value;
+      }
+    }
+    const metadataPath = `${outputPath}/package.metadata.json`;
+    await this.fileSystem.writeFile(metadataPath, `${JSON.stringify(metadata, null, 2)}
+`);
+  }
 }
 
 // src/services/solution-validate-options-validator.ts
@@ -884,19 +972,6 @@ class SolutionPackager {
     this.solutionPackService = new SolutionPackService(this.optionsBuilder, this.toolsFactory, this.projectExecutor, this.zipService, this.fileSystem, this.telemetryService);
     this.solutionValidateService = new SolutionValidateService(this.optionsBuilder, this.projectExecutor, this.telemetryService);
   }
-  async canPackSolutionAsync(solutionPath) {
-    const solution = await this.solutionLoader.loadSolution(solutionPath);
-    for (const project of solution.Projects) {
-      if (!project.ProjectPath) {
-        return false;
-      }
-      const canHandle = this.repository.canHandleProject(project.Type);
-      if (!canHandle) {
-        return false;
-      }
-    }
-    return true;
-  }
   async setupAsync(input, operationId) {
     this.telemetryService.setOperationId(operationId);
     await this.temporaryStorage.cleanup();
@@ -1032,10 +1107,7 @@ class SolutionPackager {
 }
 
 // src/browser-solution-packager-factory.ts
-var sharedFileSystem = null;
-var GLOBAL_FS_KEY = "__uipath_sharedFileSystem";
-
-class BrowserSolutionPackagerFactory {
+class BrowserSolutionPackagerFactory extends BaseBrowserPackagerFactory {
   async createAsync(config) {
     const logger = new ToolLogger2("SolutionPackagerFactory", "Create");
     this.configureLanguage(config);
@@ -1047,46 +1119,6 @@ class BrowserSolutionPackagerFactory {
     logger.info("SolutionPackager created successfully.");
     return solutionPackager;
   }
-  async getOrCreateFileSystem(config) {
-    if (config?.fileSystem) {
-      return config.fileSystem;
-    }
-    if (!sharedFileSystem) {
-      sharedFileSystem = globalThis[GLOBAL_FS_KEY] ?? null;
-    }
-    if (!sharedFileSystem) {
-      const fs = new BrowserFileSystem;
-      try {
-        await fs.init();
-      } catch (error) {
-        if (error instanceof Error && error.message.includes("Mount point is already in use")) {
-          fs.initialized = true;
-        } else {
-          throw error;
-        }
-      }
-      sharedFileSystem = fs;
-      globalThis[GLOBAL_FS_KEY] = fs;
-    }
-    return sharedFileSystem;
-  }
-  getOrCreateTelemetryService(config) {
-    if (config?.telemetryService) {
-      return config.telemetryService;
-    }
-    const provider = new ConsoleTelemetryProvider;
-    const contextStorage = new BrowserContextStorage;
-    return new TelemetryService(provider, contextStorage);
-  }
-  configureLogHandler(config) {
-    if (config?.logHandler) {
-      setGlobalLogHandler(config.logHandler);
-    }
-  }
-  configureLanguage(config) {
-    const language = config?.language ?? "en";
-    translate4.setLocale(language);
-  }
 }
 async function createBrowserSolutionPackager(options) {
   const factory = new BrowserSolutionPackagerFactory;

package/dist/node.js

@@ -8,6 +8,9 @@ var de_default = {
         pathRequired: "Solution directory path is required",
         fileNotFound: "Solution file not found: {path}",
         invalidSolution: "Invalid solution file: {path}",
+        projectMustBeObject: "Invalid solution file: {path}. Projects[{index}] must be an object.",
+        projectMissingProjectRelativePath: `Invalid solution file: {path}. Projects[{index}] is missing ProjectRelativePath.{pathHint} Use 'uip solution project add' to add projects, or set ProjectRelativePath to the project file path, for example "Foo/project.uiproj".`,
+        projectRelativePathPathHint: " Found Path, but .uipx uses ProjectRelativePath.",
         noSolutionFile: "No .uipx solution file found in directory: {path}",
         invalidStorageFile: "Invalid {fileName} file"
       }
@@ -30,6 +33,9 @@ var en = {
         pathRequired: "Solution directory path is required",
         fileNotFound: "Solution file not found: {path}",
         invalidSolution: "Invalid solution file: {path}",
+        projectMustBeObject: "Invalid solution file: {path}. Projects[{index}] must be an object.",
+        projectMissingProjectRelativePath: `Invalid solution file: {path}. Projects[{index}] is missing ProjectRelativePath.{pathHint} Use 'uip solution project add' to add projects, or set ProjectRelativePath to the project file path, for example "Foo/project.uiproj".`,
+        projectRelativePathPathHint: " Found Path, but .uipx uses ProjectRelativePath.",
         noSolutionFile: "No .uipx solution file found in directory: {path}",
         invalidStorageFile: "Invalid {fileName} file"
       }
@@ -51,6 +57,9 @@ var es_default = {
         pathRequired: "Solution directory path is required",
         fileNotFound: "Solution file not found: {path}",
         invalidSolution: "Invalid solution file: {path}",
+        projectMustBeObject: "Invalid solution file: {path}. Projects[{index}] must be an object.",
+        projectMissingProjectRelativePath: `Invalid solution file: {path}. Projects[{index}] is missing ProjectRelativePath.{pathHint} Use 'uip solution project add' to add projects, or set ProjectRelativePath to the project file path, for example "Foo/project.uiproj".`,
+        projectRelativePathPathHint: " Found Path, but .uipx uses ProjectRelativePath.",
         noSolutionFile: "No .uipx solution file found in directory: {path}",
         invalidStorageFile: "Invalid {fileName} file"
       }
@@ -72,6 +81,9 @@ var es_MX_default = {
         pathRequired: "Solution directory path is required",
         fileNotFound: "Solution file not found: {path}",
         invalidSolution: "Invalid solution file: {path}",
+        projectMustBeObject: "Invalid solution file: {path}. Projects[{index}] must be an object.",
+        projectMissingProjectRelativePath: `Invalid solution file: {path}. Projects[{index}] is missing ProjectRelativePath.{pathHint} Use 'uip solution project add' to add projects, or set ProjectRelativePath to the project file path, for example "Foo/project.uiproj".`,
+        projectRelativePathPathHint: " Found Path, but .uipx uses ProjectRelativePath.",
         noSolutionFile: "No .uipx solution file found in directory: {path}",
         invalidStorageFile: "Invalid {fileName} file"
       }
@@ -93,6 +105,9 @@ var fr_default = {
         pathRequired: "Solution directory path is required",
         fileNotFound: "Solution file not found: {path}",
         invalidSolution: "Invalid solution file: {path}",
+        projectMustBeObject: "Invalid solution file: {path}. Projects[{index}] must be an object.",
+        projectMissingProjectRelativePath: `Invalid solution file: {path}. Projects[{index}] is missing ProjectRelativePath.{pathHint} Use 'uip solution project add' to add projects, or set ProjectRelativePath to the project file path, for example "Foo/project.uiproj".`,
+        projectRelativePathPathHint: " Found Path, but .uipx uses ProjectRelativePath.",
         noSolutionFile: "No .uipx solution file found in directory: {path}",
         invalidStorageFile: "Invalid {fileName} file"
       }
@@ -114,6 +129,9 @@ var ja_default = {
         pathRequired: "Solution directory path is required",
         fileNotFound: "Solution file not found: {path}",
         invalidSolution: "Invalid solution file: {path}",
+        projectMustBeObject: "Invalid solution file: {path}. Projects[{index}] must be an object.",
+        projectMissingProjectRelativePath: `Invalid solution file: {path}. Projects[{index}] is missing ProjectRelativePath.{pathHint} Use 'uip solution project add' to add projects, or set ProjectRelativePath to the project file path, for example "Foo/project.uiproj".`,
+        projectRelativePathPathHint: " Found Path, but .uipx uses ProjectRelativePath.",
         noSolutionFile: "No .uipx solution file found in directory: {path}",
         invalidStorageFile: "Invalid {fileName} file"
       }
@@ -135,6 +153,9 @@ var ko_default = {
         pathRequired: "Solution directory path is required",
         fileNotFound: "Solution file not found: {path}",
         invalidSolution: "Invalid solution file: {path}",
+        projectMustBeObject: "Invalid solution file: {path}. Projects[{index}] must be an object.",
+        projectMissingProjectRelativePath: `Invalid solution file: {path}. Projects[{index}] is missing ProjectRelativePath.{pathHint} Use 'uip solution project add' to add projects, or set ProjectRelativePath to the project file path, for example "Foo/project.uiproj".`,
+        projectRelativePathPathHint: " Found Path, but .uipx uses ProjectRelativePath.",
         noSolutionFile: "No .uipx solution file found in directory: {path}",
         invalidStorageFile: "Invalid {fileName} file"
       }
@@ -156,6 +177,9 @@ var pt_default = {
         pathRequired: "Solution directory path is required",
         fileNotFound: "Solution file not found: {path}",
         invalidSolution: "Invalid solution file: {path}",
+        projectMustBeObject: "Invalid solution file: {path}. Projects[{index}] must be an object.",
+        projectMissingProjectRelativePath: `Invalid solution file: {path}. Projects[{index}] is missing ProjectRelativePath.{pathHint} Use 'uip solution project add' to add projects, or set ProjectRelativePath to the project file path, for example "Foo/project.uiproj".`,
+        projectRelativePathPathHint: " Found Path, but .uipx uses ProjectRelativePath.",
         noSolutionFile: "No .uipx solution file found in directory: {path}",
         invalidStorageFile: "Invalid {fileName} file"
       }
@@ -177,6 +201,9 @@ var pt_BR_default = {
         pathRequired: "Solution directory path is required",
         fileNotFound: "Solution file not found: {path}",
         invalidSolution: "Invalid solution file: {path}",
+        projectMustBeObject: "Invalid solution file: {path}. Projects[{index}] must be an object.",
+        projectMissingProjectRelativePath: `Invalid solution file: {path}. Projects[{index}] is missing ProjectRelativePath.{pathHint} Use 'uip solution project add' to add projects, or set ProjectRelativePath to the project file path, for example "Foo/project.uiproj".`,
+        projectRelativePathPathHint: " Found Path, but .uipx uses ProjectRelativePath.",
         noSolutionFile: "No .uipx solution file found in directory: {path}",
         invalidStorageFile: "Invalid {fileName} file"
       }
@@ -198,6 +225,9 @@ var ro_default = {
         pathRequired: "Solution directory path is required",
         fileNotFound: "Solution file not found: {path}",
         invalidSolution: "Invalid solution file: {path}",
+        projectMustBeObject: "Invalid solution file: {path}. Projects[{index}] must be an object.",
+        projectMissingProjectRelativePath: `Invalid solution file: {path}. Projects[{index}] is missing ProjectRelativePath.{pathHint} Use 'uip solution project add' to add projects, or set ProjectRelativePath to the project file path, for example "Foo/project.uiproj".`,
+        projectRelativePathPathHint: " Found Path, but .uipx uses ProjectRelativePath.",
         noSolutionFile: "No .uipx solution file found in directory: {path}",
         invalidStorageFile: "Invalid {fileName} file"
       }
@@ -219,6 +249,9 @@ var ru_default = {
         pathRequired: "Solution directory path is required",
         fileNotFound: "Solution file not found: {path}",
         invalidSolution: "Invalid solution file: {path}",
+        projectMustBeObject: "Invalid solution file: {path}. Projects[{index}] must be an object.",
+        projectMissingProjectRelativePath: `Invalid solution file: {path}. Projects[{index}] is missing ProjectRelativePath.{pathHint} Use 'uip solution project add' to add projects, or set ProjectRelativePath to the project file path, for example "Foo/project.uiproj".`,
+        projectRelativePathPathHint: " Found Path, but .uipx uses ProjectRelativePath.",
         noSolutionFile: "No .uipx solution file found in directory: {path}",
         invalidStorageFile: "Invalid {fileName} file"
       }
@@ -240,6 +273,9 @@ var tr_default = {
         pathRequired: "Solution directory path is required",
         fileNotFound: "Solution file not found: {path}",
         invalidSolution: "Invalid solution file: {path}",
+        projectMustBeObject: "Invalid solution file: {path}. Projects[{index}] must be an object.",
+        projectMissingProjectRelativePath: `Invalid solution file: {path}. Projects[{index}] is missing ProjectRelativePath.{pathHint} Use 'uip solution project add' to add projects, or set ProjectRelativePath to the project file path, for example "Foo/project.uiproj".`,
+        projectRelativePathPathHint: " Found Path, but .uipx uses ProjectRelativePath.",
         noSolutionFile: "No .uipx solution file found in directory: {path}",
         invalidStorageFile: "Invalid {fileName} file"
       }
@@ -261,6 +297,9 @@ var zh_CN_default = {
         pathRequired: "Solution directory path is required",
         fileNotFound: "Solution file not found: {path}",
         invalidSolution: "Invalid solution file: {path}",
+        projectMustBeObject: "Invalid solution file: {path}. Projects[{index}] must be an object.",
+        projectMissingProjectRelativePath: `Invalid solution file: {path}. Projects[{index}] is missing ProjectRelativePath.{pathHint} Use 'uip solution project add' to add projects, or set ProjectRelativePath to the project file path, for example "Foo/project.uiproj".`,
+        projectRelativePathPathHint: " Found Path, but .uipx uses ProjectRelativePath.",
         noSolutionFile: "No .uipx solution file found in directory: {path}",
         invalidStorageFile: "Invalid {fileName} file"
       }
@@ -282,6 +321,9 @@ var zh_TW_default = {
         pathRequired: "Solution directory path is required",
         fileNotFound: "Solution file not found: {path}",
         invalidSolution: "Invalid solution file: {path}",
+        projectMustBeObject: "Invalid solution file: {path}. Projects[{index}] must be an object.",
+        projectMissingProjectRelativePath: `Invalid solution file: {path}. Projects[{index}] is missing ProjectRelativePath.{pathHint} Use 'uip solution project add' to add projects, or set ProjectRelativePath to the project file path, for example "Foo/project.uiproj".`,
+        projectRelativePathPathHint: " Found Path, but .uipx uses ProjectRelativePath.",
         noSolutionFile: "No .uipx solution file found in directory: {path}",
         invalidStorageFile: "Invalid {fileName} file"
       }
@@ -303,6 +345,9 @@ var zu_default = {
         pathRequired: "Solution directory path is required",
         fileNotFound: "Solution file not found: {path}",
         invalidSolution: "Invalid solution file: {path}",
+        projectMustBeObject: "Invalid solution file: {path}. Projects[{index}] must be an object.",
+        projectMissingProjectRelativePath: `Invalid solution file: {path}. Projects[{index}] is missing ProjectRelativePath.{pathHint} Use 'uip solution project add' to add projects, or set ProjectRelativePath to the project file path, for example "Foo/project.uiproj".`,
+        projectRelativePathPathHint: " Found Path, but .uipx uses ProjectRelativePath.",
         noSolutionFile: "No .uipx solution file found in directory: {path}",
         invalidStorageFile: "Invalid {fileName} file"
       }
@@ -360,6 +405,7 @@ class SolutionPackOptions extends PackagerParameters {
 // src/node-solution-packager-factory.ts
 import {
   BaseNodePackagerFactory,
+  DotnetDiscoveryService,
   NodePackageSignService,
   ToolLogger as ToolLogger2
 } from "@uipath/project-packager/node";
@@ -641,7 +687,7 @@ import { Path as Path3, translate as translate2 } from "@uipath/solutionpackager
 
 class SolutionLoader {
   fileSystem;
-  static SolutionStorageFileName = ".storage";
+  static SolutionStorageFileName = "SolutionStorage.json";
   constructor(fileSystem) {
     this.fileSystem = fileSystem;
   }
@@ -657,12 +703,8 @@ class SolutionLoader {
       }));
     }
     const json = typeof fileContent === "string" ? fileContent : new TextDecoder("utf-8").decode(fileContent);
-    const solution = JSON.parse(json);
-    if (!solution?.Projects) {
-      throw new Error(translate2.t("solutionpackager.solutionLoader.errors.invalidSolution", {
-        path: solutionFilePath
-      }));
-    }
+    const parsed = JSON.parse(json);
+    const solution = validateSolutionFile(parsed, solutionFilePath);
     const loadedSolution = {
       ...solution,
       Name: GetSolutionName(),
@@ -714,6 +756,38 @@ class SolutionLoader {
     }
   }
 }
+function validateSolutionFile(parsed, solutionFilePath) {
+  if (!isRecord(parsed)) {
+    throw new Error(translate2.t("solutionpackager.solutionLoader.errors.invalidSolution", {
+      path: solutionFilePath
+    }));
+  }
+  if (!Array.isArray(parsed.Projects)) {
+    throw new Error(translate2.t("solutionpackager.solutionLoader.errors.invalidSolution", {
+      path: solutionFilePath
+    }));
+  }
+  for (const [index, project] of parsed.Projects.entries()) {
+    if (!isRecord(project)) {
+      throw new Error(translate2.t("solutionpackager.solutionLoader.errors.projectMustBeObject", {
+        path: solutionFilePath,
+        index
+      }));
+    }
+    if (typeof project.ProjectRelativePath !== "string" || !project.ProjectRelativePath.trim()) {
+      const pathHint = typeof project.Path === "string" ? translate2.t("solutionpackager.solutionLoader.errors.projectRelativePathPathHint") : "";
+      throw new Error(translate2.t("solutionpackager.solutionLoader.errors.projectMissingProjectRelativePath", {
+        path: solutionFilePath,
+        index,
+        pathHint
+      }));
+    }
+  }
+  return parsed;
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
 
 // src/services/solution-pack-options-validator.ts
 import {
@@ -808,6 +882,7 @@ class SolutionPackService {
     return await this.telemetry.trackDependencyOperation("SolutionPackager.Solution.Compress" /* SolutionCompress */, "compress", async () => {
       const packageName = parameters.package.id || "solution";
       const version = parameters.package.version || "1.0.0";
+      await this.writePackageMetadataAsync(parameters, outputPath);
       const archiveFileName = `${packageName}_${version}.zip`;
       const archivePath = `${parameters.destinationPath}/${archiveFileName}`;
       const zipData = await this.zipService.compressAsync(outputPath);
@@ -815,6 +890,29 @@ class SolutionPackService {
       return archivePath;
     });
   }
+  async writePackageMetadataAsync(parameters, outputPath) {
+    const pkg = parameters.package;
+    const metadata = {
+      name: pkg.id || "solution",
+      version: pkg.version || "1.0.0"
+    };
+    const optional = {
+      releaseNotes: pkg.releaseNotes,
+      projectUrl: pkg.projectUrl,
+      repositoryType: pkg.repositoryType,
+      repositoryUrl: pkg.repositoryUrl,
+      repositoryBranch: pkg.repositoryBranch,
+      repositoryCommit: pkg.repositoryCommit
+    };
+    for (const [key, value] of Object.entries(optional)) {
+      if (value !== undefined && value !== "") {
+        metadata[key] = value;
+      }
+    }
+    const metadataPath = `${outputPath}/package.metadata.json`;
+    await this.fileSystem.writeFile(metadataPath, `${JSON.stringify(metadata, null, 2)}
+`);
+  }
 }
 
 // src/services/solution-validate-options-validator.ts
@@ -894,19 +992,6 @@ class SolutionPackager {
     this.solutionPackService = new SolutionPackService(this.optionsBuilder, this.toolsFactory, this.projectExecutor, this.zipService, this.fileSystem, this.telemetryService);
     this.solutionValidateService = new SolutionValidateService(this.optionsBuilder, this.projectExecutor, this.telemetryService);
   }
-  async canPackSolutionAsync(solutionPath) {
-    const solution = await this.solutionLoader.loadSolution(solutionPath);
-    for (const project of solution.Projects) {
-      if (!project.ProjectPath) {
-        return false;
-      }
-      const canHandle = this.repository.canHandleProject(project.Type);
-      if (!canHandle) {
-        return false;
-      }
-    }
-    return true;
-  }
   async setupAsync(input, operationId) {
     this.telemetryService.setOperationId(operationId);
     await this.temporaryStorage.cleanup();
@@ -1050,7 +1135,8 @@ class NodeSolutionPackagerFactory extends BaseNodePackagerFactory {
     logger.info("Creating SolutionPackager instance...");
     const fileSystem = this.getOrCreateFileSystem(config);
     const telemetryService = this.getOrCreateTelemetryService(config);
-    const packageSignService = new NodePackageSignService(logger);
+    this.dotnetDiscovery = new DotnetDiscoveryService;
+    const packageSignService = new NodePackageSignService(this.dotnetDiscovery, logger);
     const solutionPackager = new SolutionPackager(fileSystem, telemetryService, packageSignService);
     this.checkDotnetAvailability(logger);
     logger.info("SolutionPackager created successfully.");

package/dist/src/browser-solution-packager-factory.d.ts

@@ -4,7 +4,6 @@ import { type ISolutionPackager } from "./services/solution-packager.js";
  * Creates a SolutionPackager instance configured for browser usage.
  *
  * This is a convenience function that creates a BrowserSolutionPackagerFactory and calls createAsync.
- * For more control, use the BrowserSolutionPackagerFactory class directly.
  *
  * @param options - Configuration options for the SolutionPackager
  * @returns Promise<ISolutionPackager> - A fully configured SolutionPackager instance ready for use in the browser.

package/dist/src/i18n/locales/en.d.ts

@@ -9,6 +9,9 @@ export declare const en: {
                 readonly pathRequired: "Solution directory path is required";
                 readonly fileNotFound: "Solution file not found: {path}";
                 readonly invalidSolution: "Invalid solution file: {path}";
+                readonly projectMustBeObject: "Invalid solution file: {path}. Projects[{index}] must be an object.";
+                readonly projectMissingProjectRelativePath: "Invalid solution file: {path}. Projects[{index}] is missing ProjectRelativePath.{pathHint} Use 'uip solution project add' to add projects, or set ProjectRelativePath to the project file path, for example \"Foo/project.uiproj\".";
+                readonly projectRelativePathPathHint: " Found Path, but .uipx uses ProjectRelativePath.";
                 readonly noSolutionFile: "No .uipx solution file found in directory: {path}";
                 readonly invalidStorageFile: "Invalid {fileName} file";
             };

package/dist/src/node-solution-packager-factory.d.ts

@@ -4,7 +4,6 @@ import { type ISolutionPackager } from "./services/solution-packager.js";
  * Creates a SolutionPackager instance configured for Node.js usage.
  *
  * This is a convenience function that creates a NodeSolutionPackagerFactory and calls createAsync.
- * For more control, use the NodeSolutionPackagerFactory class directly.
  *
  * @param options - Configuration options for the SolutionPackager
  * @returns Promise<ISolutionPackager> - A fully configured SolutionPackager instance ready for use in Node.js.

package/dist/src/services/solution-loader.d.ts

@@ -11,7 +11,7 @@ export interface ISolutionLoader {
 }
 export declare class SolutionLoader implements ISolutionLoader {
     private readonly fileSystem;
-    static readonly SolutionStorageFileName = ".storage";
+    static readonly SolutionStorageFileName = "SolutionStorage.json";
     constructor(fileSystem: IFileSystem);
     loadSolution(solutionPath: string): Promise<LoadedUiPathSolution>;
     private getSolutionFilePathAsync;

package/dist/src/services/solution-pack-service.d.ts

@@ -57,4 +57,11 @@ export declare class SolutionPackService implements ISolutionPackService {
      * @returns Path to the created archive file
      */
     private compressSolutionAsync;
+    /**
+     * Write a `package.metadata.json` file into the solution output folder
+     * (it lands at the root of the produced .zip). Only fields the caller
+     * actually supplied are emitted, so a metadata-free pack still gets a
+     * minimal file carrying the package name and version.
+     */
+    private writePackageMetadataAsync;
 }

package/dist/src/services/solution-packager.d.ts

@@ -10,12 +10,6 @@ export interface ISolutionPackager {
      * File system instance
      */
     readonly fileSystem: IFileSystem;
-    /**
-     * Check if the solution can be packed by verifying all project types have registered tools.
-     * @param solutionPath Path to the solution folder
-     * @returns True if all project types in the solution have registered tool factories
-     */
-    canPackSolutionAsync(solutionPath: string): Promise<boolean>;
     /**
      * Setup the temporary storage.
      * @param input The solution folder as a zip Uint8Array (extracts to temp folder) or a path string (uses as-is)
@@ -71,12 +65,6 @@ export declare class SolutionPackager implements ISolutionPackager {
     private readonly validateOptionsValidator;
     private readonly governancePolicyService;
     constructor(fileSystem: IFileSystem, telemetryService: ITelemetryService, packageSignService?: IPackageSignService | undefined);
-    /**
-     * Check if the solution can be packed by verifying all project types have registered tools.
-     * @param solutionPath Path to the solution folder
-     * @returns True if all project types in the solution have registered tool factories
-     */
-    canPackSolutionAsync(solutionPath: string): Promise<boolean>;
     /**
      * Setup the temporary storage.
      * @param input The solution folder as a zip Uint8Array (extracts to temp folder) or a path string (uses as-is)

package/dist/src/services/solution-restore-service.d.ts

@@ -0,0 +1,23 @@
+import type { IProjectToolExecutor, ITelemetryService, IToolsFactory } from "@uipath/project-packager";
+import { type ProjectOperationContext, ToolResult } from "@uipath/solutionpackager-tool-core";
+import type { LoadedUiPathSolution } from "../models/loaded-uipath-solution.js";
+import type { SolutionPackOptions } from "../models/solution-pack-options.js";
+import type { IOptionsBuilder } from "./options-builder.js";
+/**
+ * Interface for the service responsible for restoring a solution's
+ * dependencies, without packing, building, or compressing.
+ */
+export interface ISolutionRestoreService {
+    /**
+     * Restore dependencies for a solution and all its projects.
+     */
+    restoreAsync(parameters: SolutionPackOptions, solution: LoadedUiPathSolution, context: ProjectOperationContext, cancellationToken?: AbortSignal): Promise<ToolResult>;
+}
+export declare class SolutionRestoreService implements ISolutionRestoreService {
+    private readonly optionsBuilder;
+    private readonly toolsFactory;
+    private readonly projectExecutor;
+    private readonly telemetry;
+    constructor(optionsBuilder: IOptionsBuilder, toolsFactory: IToolsFactory, projectExecutor: IProjectToolExecutor, telemetry: ITelemetryService);
+    restoreAsync(parameters: SolutionPackOptions, solution: LoadedUiPathSolution, context: ProjectOperationContext, cancellationToken?: AbortSignal): Promise<ToolResult>;
+}

package/dist/src/services/tool-result-helpers.d.ts

@@ -0,0 +1,10 @@
+import type { ToolResult } from "@uipath/solutionpackager-tool-core";
+/**
+ * Result-aggregation helpers shared by the solution pack and restore services,
+ * which both fan a batch of tool operations out in parallel and need to report
+ * the combined failure state.
+ */
+/** True when any result in the batch failed. */
+export declare function hasFailedResults(results: ToolResult[]): boolean;
+/** Combined, comma-separated message of every failed result in the batch. */
+export declare function getFailedResultsMessage(results: ToolResult[]): string;

package/dist/tests/{solution-packager-e2e.test.d.ts → solution-packager.e2e.test.d.ts}

@@ -5,5 +5,6 @@ import "@uipath/packager-tool-bpmn";
 import "@uipath/packager-tool-case";
 import "@uipath/packager-tool-flow";
 import "@uipath/tool-agent";
+import "@uipath/packager-tool-functions";
 import "@uipath/packager-tool-webapp";
 import "@uipath/resource-builder-tool";

package/dist/tests/solution-validate-service.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/zip-temp-storage.integration.test.d.ts

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,7 @@
 {
     "name": "@uipath/solution-packager",
-    "version": "0.0.34",
+    "license": "MIT",
+    "version": "1.196.0",
     "description": "UiPath Solution Packager - core library for packing UiPath solutions",
     "type": "module",
     "main": "./dist/index.js",
@@ -27,51 +28,34 @@
         "dist",
         "!dist/**/*.map"
     ],
-    "scripts": {
-        "build": "bun build ./src/index.ts --outdir dist --format esm --target browser --external @uipath/solutionpackager-tool-core --external '@uipath/project-packager/*' --external @uipath/project-packager --external '@uipath/filesystem/*' --external @uipath/filesystem --external '@uipath/common/*' --external @uipath/common && bun build ./src/node.ts --outdir dist --format esm --target node --external @uipath/solutionpackager-tool-core --external '@uipath/project-packager/*' --external @uipath/project-packager --external '@uipath/common/*' --external @uipath/common --external '@uipath/filesystem/*' --external @uipath/filesystem && tsc --emitDeclarationOnly --outDir dist",
-        "clean": "rimraf dist",
-        "test": "vitest run",
-        "e2e": "vitest run --config vitest.e2e.config.ts",
-        "test:browser": "vitest run --config=vitest.browser.config.ts",
-        "test:coverage": "vitest run --coverage",
-        "test:browser:coverage": "vitest run --config=vitest.browser.config.ts --coverage",
-        "test:all": "bun run test && bun run test:browser",
-        "test:all:coverage": "bun run test:coverage && bun run test:browser:coverage",
-        "prepack": "bun run build",
-        "publish:dry": "bun publish --dry-run",
-        "publish:gh": "bun publish",
-        "version:patch": "bun version patch --no-git-tag-version",
-        "version:minor": "bun version minor --no-git-tag-version",
-        "version:major": "bun version major --no-git-tag-version",
-        "lint": "biome check ."
-    },
     "dependencies": {
-        "@uipath/project-packager": "1.1.15",
-        "@uipath/common": "0.9.0",
-        "@uipath/filesystem": "0.9.0",
-        "@uipath/solutionpackager-tool-core": "0.0.33"
+        "@uipath/project-packager": "1.196.0",
+        "@uipath/solutionpackager-tool-core": "1.196.0"
     },
     "peerDependencies": {
         "fflate": "^0.8.2"
     },
     "devDependencies": {
-        "@types/node": "^25.5.0",
-        "@uipath/resource-builder-tool": "^2025.11.0-alpha2430-2948",
-        "@uipath/tool-agent": "^1.0.1",
-        "@uipath/packager-tool-apiworkflow": "0.0.18",
-        "@uipath/packager-tool-bpmn": "0.0.8",
-        "@uipath/packager-tool-case": "0.0.8",
-        "@uipath/packager-tool-connector": "0.0.18",
-        "@uipath/packager-tool-flow": "0.0.18",
-        "@uipath/packager-tool-webapp": "1.0.5",
-        "@uipath/packager-tool-workflowcompiler": "0.0.15",
-        "@vitest/browser": "^4.0.14",
-        "@vitest/browser-playwright": "^4.0.14",
-        "@vitest/coverage-v8": "^4.0.14",
+        "@types/node": "^25.5.2",
+        "@uipath/common": "1.196.0",
+        "@uipath/filesystem": "1.196.0",
+        "@uipath/resource-builder-tool": "2025.11.0-alpha2928-3101",
+        "@uipath/tool-agent": "^1.2.6",
+        "@uipath/packager-tool-apiworkflow": "1.196.0",
+        "@uipath/packager-tool-bpmn": "1.196.0",
+        "@uipath/packager-tool-case": "1.196.0",
+        "@uipath/packager-tool-connector": "1.196.0",
+        "@uipath/packager-tool-flow": "1.196.0",
+        "@uipath/packager-tool-functions": "1.196.0",
+        "@uipath/packager-tool-webapp": "1.196.0",
+        "@uipath/packager-tool-workflowcompiler": "1.196.0",
+        "@vitest/browser": "^4.1.6",
+        "@vitest/browser-playwright": "^4.1.6",
+        "@vitest/coverage-v8": "^4.1.6",
         "playwright": "^1.57.0",
-        "typescript": "^5.9.3",
+        "typescript": "^6.0.2",
         "vite-tsconfig-paths": "^6.1.1",
-        "vitest": "^4.0.14"
+        "vitest": "^4.1.6"
     },
-    "gitHead": "3f1b4d8e9f910be81e4cab956537f21dbd5d63ac"
+    "gitHead": "bed2b46f1ec33a47a7dcae2e6d4b7ab99bd06981"
 }