@uipath/solution-packager 0.0.30 → 1.196.0

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"
       }
@@ -344,11 +389,11 @@ import {
 } from "@uipath/solutionpackager-tool-core";
 
 class SolutionPackOptions extends PackagerParameters {
-  downloadUrl;
   destinationPath;
-  projectsToBuild;
+  projectDesignIds;
   validateOptions = {
     skipAnalyze: false,
+    skipValidate: false,
     governanceFileType: RulesConfigFileType.Default
   };
   package;
@@ -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";
@@ -376,15 +422,15 @@ import {
   Path as Path4,
   TargetFramework,
   TemporaryStorageService,
-  ToolErrorCodes as ToolErrorCodes2,
-  ToolResult as ToolResult2,
+  ToolErrorCodes as ToolErrorCodes3,
+  ToolResult as ToolResult3,
   toolsFactoryRepository,
+  translate as translate3,
   ZipService
 } from "@uipath/solutionpackager-tool-core";
 
 // src/services/options-builder.ts
 import {
-  BuildConfiguration as BuildConfiguration2,
   Path,
   translate
 } from "@uipath/solutionpackager-tool-core";
@@ -404,7 +450,6 @@ class OptionsBuilder {
       throw new Error(translate.t("solutionpackager.optionsBuilder.errors.outputPathRequired"));
     }
     await this.createOutputFilesDirectoryAsync(parameters.outputPath);
-    const projectsToBuild = this.getProjectIdsToBuild(parameters, solution);
     if (!parameters.package.id || parameters.package.id.trim() === "") {
       parameters.package.id = solution.Name;
     }
@@ -415,7 +460,7 @@ class OptionsBuilder {
       configuration: parameters.configuration,
       package: parameters.package,
       publishId: parameters.publishInfo?.id,
-      projectsToBuild
+      projectsToBuild: solution.Projects.map((p) => p.Id)
     };
   }
   async createOutputFilesDirectoryAsync(outputPath) {
@@ -423,9 +468,7 @@ class OptionsBuilder {
     await this.fileSystem.mkdir(filesDir);
   }
   async buildProjectPackOptions(solutionOptions, project) {
-    const solutionFolderPath = solutionOptions.inputPath;
-    const projectRelativePath = Path.dirname(project.ProjectRelativePath);
-    const projectPath = Path.join(solutionFolderPath, projectRelativePath);
+    const projectPath = this.resolveProjectPath(solutionOptions, project);
     const solutionName = solutionOptions.package.id || undefined;
     const packageInfo = {
       ...solutionOptions.package,
@@ -442,7 +485,7 @@ class OptionsBuilder {
       nuGetSourcesConfigPath: solutionOptions.nuGetSourcesConfigPath,
       logLevel: solutionOptions.logLevel,
       skipAnalyze: solutionOptions.validateOptions.skipAnalyze,
-      skipValidate: false,
+      skipValidate: solutionOptions.validateOptions.skipValidate,
       projectStorageId: project.StorageId,
       detailedLogPath: solutionOptions.detailedLogPath,
       policyFilePath: solutionOptions.validateOptions.governanceFilePath,
@@ -456,26 +499,29 @@ class OptionsBuilder {
       splitPackages: solutionOptions.packOptions?.splitPackages ?? false
     };
   }
+  buildProjectValidateOptions(solutionOptions, project) {
+    return {
+      projectPath: this.resolveProjectPath(solutionOptions, project),
+      excludeConfiguredSources: solutionOptions.excludeConfiguredSources ?? false,
+      nuGetSourcesConfigPath: solutionOptions.nuGetSourcesConfigPath,
+      logLevel: solutionOptions.logLevel,
+      skipAnalyze: solutionOptions.validateOptions.skipAnalyze,
+      skipValidate: solutionOptions.validateOptions.skipValidate,
+      defaultSeverity: solutionOptions.validateOptions.defaultSeverity,
+      detailedLogPath: solutionOptions.detailedLogPath,
+      policyFilePath: solutionOptions.validateOptions.governanceFilePath,
+      policyFileType: solutionOptions.validateOptions.governanceFileType
+    };
+  }
+  resolveProjectPath(solutionOptions, project) {
+    return Path.join(solutionOptions.inputPath, Path.dirname(project.ProjectRelativePath));
+  }
   async buildProjectOutputPath(solutionOutputPath, project) {
     const filesDir = Path.join(solutionOutputPath, OptionsBuilder.FILES_DIRECTORY_NAME);
     const projectOutputPath = Path.join(filesDir, project.Id);
     await this.fileSystem.mkdir(projectOutputPath);
     return projectOutputPath;
   }
-  getProjectIdsToBuild(parameters, solution) {
-    const solutionProjectIds = solution.Projects.map((p) => p.Id);
-    if (parameters.projectsToBuild === null || parameters.projectsToBuild === undefined || parameters.projectsToBuild.length === 0) {
-      return parameters.configuration === BuildConfiguration2.Release ? solutionProjectIds : [];
-    }
-    const invalidProjectIds = parameters.projectsToBuild.filter((id) => !solutionProjectIds.includes(id));
-    if (invalidProjectIds.length > 0) {
-      console.warn(translate.t("solutionpackager.optionsBuilder.errors.invalidProjectIds", {
-        ids: invalidProjectIds.join(",")
-      }));
-      return solutionProjectIds.filter((id) => parameters.projectsToBuild?.includes(id));
-    }
-    return parameters.projectsToBuild;
-  }
 }
 
 // src/services/package-id-reader.ts
@@ -491,7 +537,8 @@ class PackageIdReader {
     agent: "agent",
     api: "api",
     webapp: "webApp",
-    process: "process"
+    process: "process",
+    flow: "flow"
   };
   static projectTypeMap = {
     process: "Rpa",
@@ -501,7 +548,8 @@ class PackageIdReader {
     processorchestration: "Agentic",
     casemanagement: "Case",
     api: "Api",
-    agent: "Agent"
+    agent: "Agent",
+    flow: "Flow"
   };
   constructor(fileSystem, packService) {
     this.fileSystem = fileSystem;
@@ -639,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;
   }
@@ -655,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(),
@@ -712,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 {
@@ -806,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);
@@ -813,6 +890,68 @@ 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
+import {
+  PackagerParametersValidator as PackagerParametersValidator2
+} from "@uipath/project-packager";
+
+class SolutionValidateOptionsValidator extends PackagerParametersValidator2 {
+  async validateAsync(options, _cancellationToken) {
+    return await this.validateGovernanceOptions(options.validateOptions);
+  }
+}
+
+// src/services/solution-validate-service.ts
+import {
+  ToolErrorCodes as ToolErrorCodes2,
+  ToolResult as ToolResult2
+} from "@uipath/solutionpackager-tool-core";
+class SolutionValidateService {
+  optionsBuilder;
+  projectExecutor;
+  telemetry;
+  constructor(optionsBuilder, projectExecutor, telemetry) {
+    this.optionsBuilder = optionsBuilder;
+    this.projectExecutor = projectExecutor;
+    this.telemetry = telemetry;
+  }
+  async validateAsync(parameters, solution, context, cancellationToken) {
+    return await this.telemetry.trackDependencyOperation("SolutionPackager.Solution.Validate" /* SolutionValidate */, "validate", async () => {
+      const projectResults = await Promise.all(solution.Projects.map((project) => {
+        if (project.ProjectPath == null) {
+          return Promise.resolve(ToolResult2.error(ToolErrorCodes2.InternalError, `Project '${project.Id}' has no ProjectPath; the solution loader must populate it before validation.`));
+        }
+        return this.projectExecutor.validateAsync(this.optionsBuilder.buildProjectValidateOptions(parameters, project), project, context, cancellationToken);
+      }));
+      const failed = projectResults.find((r) => !r.isSuccess);
+      return failed ?? ToolResult2.success();
+    }, { solutionId: solution.SolutionId });
+  }
 }
 
 // src/services/solution-packager.ts
@@ -829,7 +968,9 @@ class SolutionPackager {
   projectExecutor;
   solutionLoader;
   solutionPackService;
-  optionsValidator;
+  solutionValidateService;
+  packOptionsValidator;
+  validateOptionsValidator;
   governancePolicyService;
   constructor(fileSystem, telemetryService, packageSignService) {
     this.fileSystem = fileSystem;
@@ -839,7 +980,8 @@ class SolutionPackager {
     this.temporaryStorage = new TemporaryStorageService(this.fileSystem);
     this.zipService = new ZipService(this.fileSystem);
     this.logger = new ToolLogger("SolutionPackager", "PackSolution");
-    this.optionsValidator = new SolutionPackOptionsValidator(this.logger, this.fileSystem);
+    this.packOptionsValidator = new SolutionPackOptionsValidator(this.logger, this.fileSystem);
+    this.validateOptionsValidator = new SolutionValidateOptionsValidator(this.logger, this.fileSystem);
     const packService = new PackService;
     const packageIdReader = new PackageIdReader(this.fileSystem, packService);
     this.optionsBuilder = new OptionsBuilder(packageIdReader, packService, this.fileSystem);
@@ -848,19 +990,7 @@ class SolutionPackager {
     this.solutionLoader = new SolutionLoader(this.fileSystem);
     this.governancePolicyService = new GovernancePolicyService(this.fileSystem, this.temporaryStorage);
     this.solutionPackService = new SolutionPackService(this.optionsBuilder, this.toolsFactory, this.projectExecutor, this.zipService, this.fileSystem, 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;
+    this.solutionValidateService = new SolutionValidateService(this.optionsBuilder, this.projectExecutor, this.telemetryService);
   }
   async setupAsync(input, operationId) {
     this.telemetryService.setOperationId(operationId);
@@ -897,14 +1027,15 @@ class SolutionPackager {
     return await this.telemetryService.trackRequest("SolutionPackager.PackSolution" /* SolutionPackagerPackSolution */, async () => {
       try {
         await this.governancePolicyService.resolveGovernancePolicyAsync(options.validateOptions, options.connection, cancellationToken);
-        let result = await this.optionsValidator.validateAsync(options, cancellationToken);
+        let result = await this.packOptionsValidator.validateAsync(options, cancellationToken);
         if (!result.isSuccess) {
           return result;
         }
         if (!options.outputPath) {
           options.outputPath = await this.temporaryStorage.getTempSubfolderPathAsync("output");
         }
-        const solution = await this.solutionLoader.loadSolution(options.inputPath);
+        const loadedSolution = await this.solutionLoader.loadSolution(options.inputPath);
+        const solution = this.filterSolutionProjects(loadedSolution, options.projectDesignIds);
         const context = this.createOperationContext(options, solution);
         result = await this.solutionPackService.packAsync(options, solution, context, cancellationToken);
         if (result.isSuccess) {
@@ -916,16 +1047,57 @@ class SolutionPackager {
       } catch (error) {
         const errorMessage = error instanceof Error ? error.message : String(error);
         this.logger.error(`Processing error: ${errorMessage}`);
-        return ToolResult2.error(ToolErrorCodes2.InternalError, `Solution pack failed: ${errorMessage}`);
+        return ToolResult3.error(ToolErrorCodes3.InternalError, `Solution pack failed: ${errorMessage}`);
+      } finally {
+        await this.temporaryStorage.cleanup();
+      }
+    });
+  }
+  async validateSolutionAsync(options, cancellationToken) {
+    return await this.telemetryService.trackRequest("SolutionPackager.ValidateSolution" /* SolutionPackagerValidateSolution */, async () => {
+      try {
+        await this.governancePolicyService.resolveGovernancePolicyAsync(options.validateOptions, options.connection, cancellationToken);
+        const validationResult = await this.validateOptionsValidator.validateAsync(options, cancellationToken);
+        if (!validationResult.isSuccess) {
+          return validationResult;
+        }
+        const loadedSolution = await this.solutionLoader.loadSolution(options.inputPath);
+        const solution = this.filterSolutionProjects(loadedSolution, options.projectDesignIds);
+        const context = this.createOperationContext(options, solution);
+        const result = await this.solutionValidateService.validateAsync(options, solution, context, cancellationToken);
+        if (result.isSuccess) {
+          this.logger.info("Solution validate completed successfully.");
+        } else {
+          this.logger.error(`Solution validate failed with error code ${result.errorCode}: ${result.message}`);
+        }
+        return result;
+      } catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        this.logger.error(`Processing error: ${errorMessage}`);
+        return ToolResult3.error(ToolErrorCodes3.InternalError, `Solution validate failed: ${errorMessage}`);
       } finally {
         await this.temporaryStorage.cleanup();
       }
     });
   }
+  filterSolutionProjects(solution, projectDesignIds) {
+    if (!projectDesignIds?.length)
+      return solution;
+    const solutionProjectIds = new Set(solution.Projects.map((p) => p.Id));
+    const unknownIds = projectDesignIds.filter((id) => !solutionProjectIds.has(id));
+    if (unknownIds.length > 0) {
+      this.logger.warn(translate3.t("solutionpackager.optionsBuilder.errors.invalidProjectIds", { ids: unknownIds.join(",") }));
+    }
+    const requested = new Set(projectDesignIds);
+    return {
+      ...solution,
+      Projects: solution.Projects.filter((p) => requested.has(p.Id))
+    };
+  }
   createOperationContext(options, solution) {
     return {
       id: crypto.randomUUID(),
-      solution,
+      projects: solution.Projects,
       downloadUrl: options.downloadUrl,
       configuration: options.configuration,
       targetFramework: options.targetFramework ?? TargetFramework.Portable,
@@ -963,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/models/solution-pack-options.d.ts

@@ -5,18 +5,16 @@ import { BuildConfiguration, type NugetPackageInfo } from "@uipath/solutionpacka
  * Solution-specific parameters extending base packager parameters
  */
 export declare class SolutionPackOptions extends PackagerParameters {
-    /**
-     * URL to download the solution snapshot for remote packing
-     */
-    downloadUrl?: string;
     /**
      * Path to the folder where the packed output will be stored.
      */
     destinationPath: string;
     /**
-     * Array of project names/paths to build
+     * Subset of solution project design IDs (the `Id` field of each
+     * `UiPathProject` in the solution model) to process. Empty or undefined
+     * means "all projects". Unknown IDs are logged and silently dropped.
      */
-    projectsToBuild?: string[];
+    projectDesignIds?: string[];
     /**
      * Validate options
      */

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/options-builder.d.ts

@@ -1,5 +1,5 @@
 import type { IPackService, UiPathProject } from "@uipath/project-packager";
-import { type IFileSystem, type IProjectPackOptions, type ISolutionPackOptions } from "@uipath/solutionpackager-tool-core";
+import { type IFileSystem, type IProjectPackOptions, type IProjectValidateOptions, type ISolutionPackOptions } 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 { IPackageIdReader } from "./package-id-reader.js";
@@ -15,6 +15,10 @@ export interface IOptionsBuilder {
      * Build project pack options from solution parameters, for a specific project
      */
     buildProjectPackOptions(options: SolutionPackOptions, project: UiPathProject): Promise<IProjectPackOptions>;
+    /**
+     * Build project validate options from solution parameters, for a specific project
+     */
+    buildProjectValidateOptions(options: SolutionPackOptions, project: UiPathProject): IProjectValidateOptions;
 }
 export declare class OptionsBuilder implements IOptionsBuilder {
     private readonly packageIdReader;
@@ -28,6 +32,8 @@ export declare class OptionsBuilder implements IOptionsBuilder {
      * Build project pack options from solution parameters for a specific project
      */
     buildProjectPackOptions(solutionOptions: SolutionPackOptions, project: UiPathProject): Promise<IProjectPackOptions>;
+    buildProjectValidateOptions(solutionOptions: SolutionPackOptions, project: UiPathProject): IProjectValidateOptions;
+    private resolveProjectPath;
     /**
      * Build the output path for a project
      * Path structure: {solutionOutputFolder}/files/{projectId}
@@ -35,8 +41,4 @@ export declare class OptionsBuilder implements IOptionsBuilder {
      * @returns The output path for the project
      */
     private buildProjectOutputPath;
-    /**
-     * Get the list of project IDs to build based on parameters and solution
-     */
-    private getProjectIdsToBuild;
 }

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;
 }