@uipath/solutionpackager-tool-core 1.197.0 → 1.198.0-preview.80

package/dist/index.js

@@ -1152,6 +1152,29 @@ class ToolResult {
     return new ToolResult(errorCode, message);
   }
 }
+// src/models/workflow-compiler-cleanup-info.ts
+function toProjectCleanupInfo(raw) {
+  return createProjectCleanupInfo(raw.unusedDependencies ?? [], raw.cleanedWorkflows ?? []);
+}
+function toProjectCleanupInfoFromRemote(raw) {
+  const cleanedWorkflows = (raw.CleanedWorkflows ?? []).map((w) => ({
+    workflow: w.Workflow,
+    removedNamespaces: w.RemovedNamespaces ?? []
+  }));
+  return createProjectCleanupInfo(raw.UnusedDependencies ?? [], cleanedWorkflows);
+}
+function createProjectCleanupInfo(unusedItems, cleanedWorkflows) {
+  const info = {
+    unusedItems,
+    cleanedFiles: cleanedWorkflows.map((w) => w.workflow)
+  };
+  if (cleanedWorkflows.length > 0) {
+    info.toolDetails = {
+      cleanedWorkflows
+    };
+  }
+  return info;
+}
 // src/package-descriptor/project-bindings-file-model.ts
 function createDefaultBindingsVersion() {
   return { major: 2, minor: 0 };
@@ -1436,6 +1459,10 @@ class ProjectTool {
     this.logger.info("Pack operation is a noop");
     return ToolResult.success();
   }
+  async cleanupAsync(_options, _cancellationToken) {
+    this.logger.info("Cleanup operation is a noop");
+    return ToolResult.success();
+  }
   async getUiProjectAsync(projectPath) {
     const filePath = Path.join(projectPath, ProjectTool.ProjectFileName);
     if (!await this.fileSystem.exists(filePath)) {
@@ -1528,6 +1555,8 @@ export {
   translate,
   toolsFactoryRepository,
   toRelativeUrl,
+  toProjectCleanupInfoFromRemote,
+  toProjectCleanupInfo,
   ensureProjectIdInOperateFile,
   ensureProjectId,
   ensureContentOperateFile,
@@ -1551,4 +1580,4 @@ export {
   BuildConfiguration
 };
 
-//# debugId=E5FDBA39F2E268FE64756E2164756E21
+//# debugId=FE11526B2B389B0464756E2164756E21

package/dist/models/index.d.ts

@@ -6,7 +6,8 @@ export { NugetConstants } from "./nuget-constants.js";
 export type { NugetFeedModel } from "./nuget-feed-model.js";
 export type { NugetDependency, NugetPackageInfo, } from "./nuget-package-info.js";
 export type { PackageInfo } from "./package-info.js";
-export type { IProjectBuildOptions, IProjectOptions, IProjectPackOptions, IProjectRestoreOptions, IProjectValidateOptions, } from "./project-options.js";
+export type { ProjectCleanupInfo } from "./project-cleanup-info.js";
+export type { IProjectBuildOptions, IProjectCleanupOptions, IProjectOptions, IProjectPackOptions, IProjectRestoreOptions, IProjectValidateOptions, } from "./project-options.js";
 export type { ProjectType } from "./project-type.js";
 export { ProjectTypes } from "./project-type.js";
 export type { ISolutionBuildOptions, ISolutionOptions, ISolutionPackOptions, ISolutionRestoreOptions, ISolutionValidateOptions, } from "./solution-options.js";
@@ -17,3 +18,5 @@ export { ToolResult } from "./tool-result.js";
 export type { UiProject } from "./ui-project.js";
 export type { UiPathProject } from "./uipath-project.js";
 export type { UiPathSolution } from "./uipath-solution.js";
+export type { CleanedWorkflowDetail, RemoteCleanedWorkflow, RemoteWorkflowCompilerCleanupPayload, WorkflowCleanupDetails, WorkflowCompilerCleanupPayload, } from "./workflow-compiler-cleanup-info.js";
+export { toProjectCleanupInfo, toProjectCleanupInfoFromRemote, } from "./workflow-compiler-cleanup-info.js";

package/dist/models/project-cleanup-info.d.ts

@@ -0,0 +1,21 @@
+/**
+ * General result of a project cleanup operation: the items detected as unused
+ * and the files the cleanup modified. Any tool that implements cleanup produces
+ * this shape; general consumers (solution-packager, CLI output) read only these
+ * fields and never need to know which tool ran.
+ */
+export interface ProjectCleanupInfo {
+    /**
+     * Ids of the items detected as unused. On a real run these were removed from
+     * the project; on a detection-only run they are only reported. An empty list
+     * means nothing was unused.
+     */
+    unusedItems: string[];
+    /** Paths, relative to the project root, of the files the cleanup modified. */
+    cleanedFiles: string[];
+    /**
+     * Optional, tool-specific cleanup detail. The producing tool defines and
+     * owns this type; general consumers treat it as opaque and pass it through.
+     */
+    toolDetails?: unknown;
+}

package/dist/models/project-options.d.ts

@@ -66,6 +66,19 @@ export interface IProjectValidateOptions extends IProjectOptions {
      */
     policyFileType?: RulesConfigFileType;
 }
+/**
+ * Project cleanup options
+ */
+export interface IProjectCleanupOptions extends IProjectOptions {
+    /**
+     * Detect unused items without modifying the project.
+     */
+    dryRun: boolean;
+    /**
+     * Do not clean up now-unused references to removed items in the project's files.
+     */
+    skipImports: boolean;
+}
 /**
  * Project build options
  */

package/dist/models/workflow-compiler-cleanup-info.d.ts

@@ -0,0 +1,39 @@
+import type { ProjectCleanupInfo } from "./project-cleanup-info.js";
+/**
+ * WorkflowCompiler-specific cleanup detail, surfaced via
+ * `ProjectCleanupInfo.toolDetails`. The generic cleanup pipeline treats this as
+ * opaque; WorkflowCompiler-aware consumers can opt into this type.
+ */
+export interface WorkflowCleanupDetails {
+    /** Workflows whose imports were rewritten, with the namespaces removed from each. */
+    cleanedWorkflows: CleanedWorkflowDetail[];
+}
+/** A single workflow whose imports the WorkflowCompiler rewrote during cleanup. */
+export interface CleanedWorkflowDetail {
+    /** Path of the workflow, relative to the project root. */
+    workflow: string;
+    /** Namespaces removed from this workflow's imports. */
+    removedNamespaces: string[];
+}
+/**
+ * Raw cleanup payload after the local WorkflowCompiler executor normalizes
+ * output casing.
+ */
+export interface WorkflowCompilerCleanupPayload {
+    unusedDependencies?: string[];
+    cleanedWorkflows?: CleanedWorkflowDetail[];
+}
+/**
+ * Raw per-project cleanup payload returned by the remote agent. SignalR JSON is
+ * parsed as-is, so the payload keeps the PascalCase wire shape.
+ */
+export interface RemoteWorkflowCompilerCleanupPayload {
+    UnusedDependencies?: string[];
+    CleanedWorkflows?: RemoteCleanedWorkflow[];
+}
+export interface RemoteCleanedWorkflow {
+    Workflow: string;
+    RemovedNamespaces?: string[];
+}
+export declare function toProjectCleanupInfo(raw: WorkflowCompilerCleanupPayload): ProjectCleanupInfo;
+export declare function toProjectCleanupInfoFromRemote(raw: RemoteWorkflowCompilerCleanupPayload): ProjectCleanupInfo;

package/dist/services/project-operation-context.d.ts

@@ -18,6 +18,14 @@ export interface ProjectOperationContext {
      * URL to download the snapshot for remote packing
      */
     downloadUrl?: string;
+    /**
+     * StudioWeb solution identifier for downloaded solution workspaces.
+     */
+    solutionId?: string;
+    /**
+     * StudioWeb project identifier for downloaded standalone project workspaces.
+     */
+    projectId?: string;
     /**
      * Build configuration (e.g. "Debug", "Release").
      * Only used for pack operations; required when packing a solution.
@@ -39,4 +47,8 @@ export interface ProjectOperationContext {
      * Version of the workflow compiler to use for remote packing
      */
     workflowCompilerVersion?: string;
+    /**
+     * Lock key of the editing session that triggered the operation.
+     */
+    lockKey?: string;
 }

package/dist/services/project-tool.d.ts

@@ -1,5 +1,5 @@
 import type { IFileSystem } from "../filesystem/file-system.js";
-import type { IProjectBuildOptions, IProjectPackOptions, IProjectRestoreOptions, IProjectValidateOptions } from "../models/project-options.js";
+import type { IProjectBuildOptions, IProjectCleanupOptions, IProjectPackOptions, IProjectRestoreOptions, IProjectValidateOptions } from "../models/project-options.js";
 import { ToolResult } from "../models/tool-result.js";
 import type { UiProject } from "../models/ui-project.js";
 import type { IToolLogger } from "./tool-logger.js";
@@ -27,6 +27,11 @@ export declare abstract class ProjectTool {
      * Pack project
      */
     packAsync(_options: IProjectPackOptions, _cancellationToken?: AbortSignal): Promise<ToolResult>;
+    /**
+     * Clean up the project (e.g. remove unused items). Default is a noop;
+     * tools that support cleanup (e.g. the WorkflowCompiler tool) override this.
+     */
+    cleanupAsync(_options: IProjectCleanupOptions, _cancellationToken?: AbortSignal): Promise<ToolResult>;
     /**
      * Read and parse `project.uiproj` from the project folder.
      * Returns `undefined` for project types that do not have a `project.uiproj`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uipath/solutionpackager-tool-core",
-  "version": "1.197.0",
+  "version": "1.198.0-preview.80",
   "description": "UiPath contracts for solution packager tools",
   "type": "module",
   "exports": {
@@ -24,8 +24,8 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@uipath/filesystem": "1.197.0",
+    "@uipath/filesystem": "1.198.0",
     "fflate": "^0.8.2"
   },
-  "gitHead": "56f68b263cec4ea1f2a39d738bd99ecf52f88fea"
+  "gitHead": "9b2c3c0f21a256d2f38dd28bc97e72e6f7b10a9c"
 }