@uipath/solution-packager 0.0.30 → 0.0.34

package/dist/index.js

@@ -337,22 +337,22 @@ I18nManager.registerTranslations("zu", zu_default);
 // src/index.ts
 import { RulesConfigFileType as RulesConfigFileType2 } from "@uipath/project-packager";
 import {
-  BuildConfiguration as BuildConfiguration3,
+  BuildConfiguration as BuildConfiguration2,
   LogLevel
 } 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 translate3 } from "@uipath/solutionpackager-tool-core";
-import {
-  BrowserContextStorage,
-  ConsoleTelemetryProvider,
-  TelemetryService
-} from "@uipath/telemetry";
+import { translate as translate4 } from "@uipath/solutionpackager-tool-core";
 
 // src/services/solution-packager.ts
 import {
@@ -366,15 +366,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,
   Path,
   translate
 } from "@uipath/solutionpackager-tool-core";
@@ -394,7 +394,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;
     }
@@ -405,7 +404,7 @@ class OptionsBuilder {
       configuration: parameters.configuration,
       package: parameters.package,
       publishId: parameters.publishInfo?.id,
-      projectsToBuild
+      projectsToBuild: solution.Projects.map((p) => p.Id)
     };
   }
   async createOutputFilesDirectoryAsync(outputPath) {
@@ -413,9 +412,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,
@@ -432,7 +429,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,
@@ -446,26 +443,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 === BuildConfiguration.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
@@ -481,7 +481,8 @@ class PackageIdReader {
     agent: "agent",
     api: "api",
     webapp: "webApp",
-    process: "process"
+    process: "process",
+    flow: "flow"
   };
   static projectTypeMap = {
     process: "Rpa",
@@ -491,7 +492,8 @@ class PackageIdReader {
     processorchestration: "Agentic",
     casemanagement: "Case",
     api: "Api",
-    agent: "Agent"
+    agent: "Agent",
+    flow: "Flow"
   };
   constructor(fileSystem, packService) {
     this.fileSystem = fileSystem;
@@ -805,6 +807,45 @@ class SolutionPackService {
   }
 }
 
+// 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
 class SolutionPackager {
   fileSystem;
@@ -819,7 +860,9 @@ class SolutionPackager {
   projectExecutor;
   solutionLoader;
   solutionPackService;
-  optionsValidator;
+  solutionValidateService;
+  packOptionsValidator;
+  validateOptionsValidator;
   governancePolicyService;
   constructor(fileSystem, telemetryService, packageSignService) {
     this.fileSystem = fileSystem;
@@ -829,7 +872,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);
@@ -838,6 +882,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);
+    this.solutionValidateService = new SolutionValidateService(this.optionsBuilder, this.projectExecutor, this.telemetryService);
   }
   async canPackSolutionAsync(solutionPath) {
     const solution = await this.solutionLoader.loadSolution(solutionPath);
@@ -887,14 +932,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) {
@@ -906,16 +952,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,
@@ -998,7 +1085,7 @@ class BrowserSolutionPackagerFactory {
   }
   configureLanguage(config) {
     const language = config?.language ?? "en";
-    translate3.setLocale(language);
+    translate4.setLocale(language);
   }
 }
 async function createBrowserSolutionPackager(options) {
@@ -1011,19 +1098,19 @@ import {
   RulesConfigFileType
 } from "@uipath/project-packager";
 import {
-  BuildConfiguration as BuildConfiguration2
+  BuildConfiguration
 } from "@uipath/solutionpackager-tool-core";
 
 class SolutionPackOptions extends PackagerParameters {
-  downloadUrl;
   destinationPath;
-  projectsToBuild;
+  projectDesignIds;
   validateOptions = {
     skipAnalyze: false,
+    skipValidate: false,
     governanceFileType: RulesConfigFileType.Default
   };
   package;
-  configuration = BuildConfiguration2.Release;
+  configuration = BuildConfiguration.Release;
   signingInfo;
   packOptions;
   publishInfo;
@@ -1034,5 +1121,5 @@ export {
   SolutionPackOptions,
   RulesConfigFileType2 as RulesConfigFileType,
   LogLevel,
-  BuildConfiguration3 as BuildConfiguration
+  BuildConfiguration2 as BuildConfiguration
 };

package/dist/node.js

@@ -344,11 +344,11 @@ import {
 } from "@uipath/solutionpackager-tool-core";
 
 class SolutionPackOptions extends PackagerParameters {
-  downloadUrl;
   destinationPath;
-  projectsToBuild;
+  projectDesignIds;
   validateOptions = {
     skipAnalyze: false,
+    skipValidate: false,
     governanceFileType: RulesConfigFileType.Default
   };
   package;
@@ -376,15 +376,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 +404,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 +414,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 +422,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 +439,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 +453,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 +491,8 @@ class PackageIdReader {
     agent: "agent",
     api: "api",
     webapp: "webApp",
-    process: "process"
+    process: "process",
+    flow: "flow"
   };
   static projectTypeMap = {
     process: "Rpa",
@@ -501,7 +502,8 @@ class PackageIdReader {
     processorchestration: "Agentic",
     casemanagement: "Case",
     api: "Api",
-    agent: "Agent"
+    agent: "Agent",
+    flow: "Flow"
   };
   constructor(fileSystem, packService) {
     this.fileSystem = fileSystem;
@@ -815,6 +817,45 @@ class SolutionPackService {
   }
 }
 
+// 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
 class SolutionPackager {
   fileSystem;
@@ -829,7 +870,9 @@ class SolutionPackager {
   projectExecutor;
   solutionLoader;
   solutionPackService;
-  optionsValidator;
+  solutionValidateService;
+  packOptionsValidator;
+  validateOptionsValidator;
   governancePolicyService;
   constructor(fileSystem, telemetryService, packageSignService) {
     this.fileSystem = fileSystem;
@@ -839,7 +882,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,6 +892,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);
+    this.solutionValidateService = new SolutionValidateService(this.optionsBuilder, this.projectExecutor, this.telemetryService);
   }
   async canPackSolutionAsync(solutionPath) {
     const solution = await this.solutionLoader.loadSolution(solutionPath);
@@ -897,14 +942,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 +962,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,

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

@@ -38,6 +38,13 @@ export interface ISolutionPackager {
      * @returns ToolResult with the path to the created solution package
      */
     packSolutionAsync(options: SolutionPackOptions, cancellationToken?: AbortSignal): Promise<ToolResult>;
+    /**
+     * Validate all projects in a solution using the provided options.
+     * @param options Solution pack options containing all parameters
+     * @param cancellationToken Optional cancellation token
+     * @returns ToolResult indicating success if every project passed validation
+     */
+    validateSolutionAsync(options: SolutionPackOptions, cancellationToken?: AbortSignal): Promise<ToolResult>;
     /**
      * Convert a successful ToolResult to a list of package streams.
      * @param result The ToolResult to convert
@@ -59,7 +66,9 @@ export declare class SolutionPackager implements ISolutionPackager {
     private readonly projectExecutor;
     private readonly solutionLoader;
     private readonly solutionPackService;
-    private readonly optionsValidator;
+    private readonly solutionValidateService;
+    private readonly packOptionsValidator;
+    private readonly validateOptionsValidator;
     private readonly governancePolicyService;
     constructor(fileSystem: IFileSystem, telemetryService: ITelemetryService, packageSignService?: IPackageSignService | undefined);
     /**
@@ -90,6 +99,21 @@ export declare class SolutionPackager implements ISolutionPackager {
      * @returns ToolResult with the path to the created solution package
      */
     packSolutionAsync(options: SolutionPackOptions, cancellationToken?: AbortSignal): Promise<ToolResult>;
+    /**
+     * Validate all projects in a solution using the provided options.
+     */
+    validateSolutionAsync(options: SolutionPackOptions, cancellationToken?: AbortSignal): Promise<ToolResult>;
+    /**
+     * Narrow the solution's project list to the subset the caller asked for.
+     * An empty or absent `projectDesignIds` is a no-op (the whole solution is
+     * processed). Unknown IDs are warned about and silently dropped.
+     *
+     * The filter must be applied before `createOperationContext` so that
+     * `ProjectOperationContext.projects` — which the remote-agent bundle
+     * executor uses to count compatible projects up front — stays in sync
+     * with what the pack/validate fan-out actually enqueues.
+     */
+    private filterSolutionProjects;
     private createOperationContext;
     /**
      * Convert a successful ToolResult to a list of package streams.

package/dist/src/services/solution-validate-options-validator.d.ts

@@ -0,0 +1,7 @@
+import { type IPackagerParametersValidator, PackagerParametersValidator } from "@uipath/project-packager";
+import type { ToolResult } from "@uipath/solutionpackager-tool-core";
+import type { SolutionPackOptions } from "../models/solution-pack-options.js";
+export type ISolutionValidateOptionsValidator = IPackagerParametersValidator<SolutionPackOptions>;
+export declare class SolutionValidateOptionsValidator extends PackagerParametersValidator<SolutionPackOptions> implements ISolutionValidateOptionsValidator {
+    validateAsync(options: SolutionPackOptions, _cancellationToken?: AbortSignal): Promise<ToolResult>;
+}

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

@@ -0,0 +1,15 @@
+import type { IProjectToolExecutor, ITelemetryService } 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";
+export interface ISolutionValidateService {
+    validateAsync(parameters: SolutionPackOptions, solution: LoadedUiPathSolution, context: ProjectOperationContext, cancellationToken?: AbortSignal): Promise<ToolResult>;
+}
+export declare class SolutionValidateService implements ISolutionValidateService {
+    private readonly optionsBuilder;
+    private readonly projectExecutor;
+    private readonly telemetry;
+    constructor(optionsBuilder: IOptionsBuilder, projectExecutor: IProjectToolExecutor, telemetry: ITelemetryService);
+    validateAsync(parameters: SolutionPackOptions, solution: LoadedUiPathSolution, context: ProjectOperationContext, cancellationToken?: AbortSignal): Promise<ToolResult>;
+}

package/dist/src/telemetry-names.d.ts

@@ -1,5 +1,7 @@
 export declare enum TelemetryNames {
     SolutionPackagerPackSolution = "SolutionPackager.PackSolution",
+    SolutionPackagerValidateSolution = "SolutionPackager.ValidateSolution",
     SolutionPack = "SolutionPackager.Solution.Pack",
+    SolutionValidate = "SolutionPackager.Solution.Validate",
     SolutionCompress = "SolutionPackager.Solution.Compress"
 }

package/dist/tests/solution-packager.test.d.ts

@@ -1 +1 @@
-export {};
+import "../src/i18n/index.js";

package/dist/tests/solution-validate-options-validator.test.d.ts

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

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@uipath/solution-packager",
-    "version": "0.0.30",
+    "version": "0.0.34",
     "description": "UiPath Solution Packager - core library for packing UiPath solutions",
     "type": "module",
     "main": "./dist/index.js",
@@ -28,7 +28,7 @@
         "!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/telemetry/*' --external @uipath/telemetry && 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/telemetry/*' --external @uipath/telemetry --external '@uipath/filesystem/*' --external @uipath/filesystem && tsc --emitDeclarationOnly --outDir dist",
+        "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",
@@ -46,10 +46,10 @@
         "lint": "biome check ."
     },
     "dependencies": {
-        "@uipath/project-packager": "1.1.10",
-        "@uipath/telemetry": "0.0.6",
-        "@uipath/filesystem": "0.1.7",
-        "@uipath/solutionpackager-tool-core": "0.0.31"
+        "@uipath/project-packager": "1.1.15",
+        "@uipath/common": "0.9.0",
+        "@uipath/filesystem": "0.9.0",
+        "@uipath/solutionpackager-tool-core": "0.0.33"
     },
     "peerDependencies": {
         "fflate": "^0.8.2"
@@ -58,13 +58,13 @@
         "@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.17",
-        "@uipath/packager-tool-bpmn": "0.0.7",
-        "@uipath/packager-tool-case": "0.0.7",
-        "@uipath/packager-tool-connector": "0.0.17",
-        "@uipath/packager-tool-flow": "0.0.17",
-        "@uipath/packager-tool-webapp": "1.0.4",
-        "@uipath/packager-tool-workflowcompiler": "0.0.14",
+        "@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",
@@ -72,5 +72,6 @@
         "typescript": "^5.9.3",
         "vite-tsconfig-paths": "^6.1.1",
         "vitest": "^4.0.14"
-    }
+    },
+    "gitHead": "3f1b4d8e9f910be81e4cab956537f21dbd5d63ac"
 }