@uipath/project-packager 1.197.0 → 1.198.0-preview.101

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

@@ -7,7 +7,7 @@ export declare const en: {
         readonly projectLoader: {
             readonly errors: {
                 readonly pathRequired: "Project directory path is required";
-                readonly noProjectFile: "No {projectFile} or {manifestFile} found in directory: {path}";
+                readonly noProjectFile: "No {projectFile}, {projectJsonFile}, or {manifestFile} found in directory: {path}";
                 readonly readFailed: "Failed to read project file: {path}";
                 readonly invalidProject: "Invalid project file: {path}. Missing ProjectType field.";
             };

package/dist/src/index.d.ts

@@ -5,6 +5,7 @@ export type { PackagerConfig } from "./models/packager-config.js";
 export type { PackageSigningInfo, PackOptions, PublishInfo, ValidateOptions, } from "./models/packager-parameters.js";
 export { PackagerParameters, RulesConfigFileType, } from "./models/packager-parameters.js";
 export { ProjectBuildOptions } from "./models/project-build-options.js";
+export { ProjectCleanupOptions } from "./models/project-cleanup-options.js";
 export type { UiPathProject } from "./models/project-models.js";
 export { ProjectPackOptions } from "./models/project-pack-options.js";
 export { ProjectRestoreOptions } from "./models/project-restore-options.js";

package/dist/src/models/packager-parameters.d.ts

@@ -95,6 +95,10 @@ export declare abstract class PackagerParameters {
      * URL to download the project/solution snapshot for remote packing.
      */
     downloadUrl?: string;
+    /**
+     * StudioWeb project identifier for downloaded standalone project workspaces.
+     */
+    projectId?: string;
     /**
      * Log level for the packager
      */

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

@@ -0,0 +1,14 @@
+import { PackagerParameters } from "./packager-parameters.js";
+/**
+ * Project-specific parameters for cleanup operations.
+ */
+export declare class ProjectCleanupOptions extends PackagerParameters {
+    /**
+     * 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;
+}

package/dist/src/node.d.ts

@@ -12,6 +12,7 @@ export type { PackagerConfig } from "./models/packager-config.js";
 export type { PackageSigningInfo, PackOptions, PublishInfo, ValidateOptions, } from "./models/packager-parameters.js";
 export { PackagerParameters, RulesConfigFileType, } from "./models/packager-parameters.js";
 export { ProjectBuildOptions } from "./models/project-build-options.js";
+export { ProjectCleanupOptions } from "./models/project-cleanup-options.js";
 export type { UiPathProject } from "./models/project-models.js";
 export { ProjectPackOptions } from "./models/project-pack-options.js";
 export { ProjectRestoreOptions } from "./models/project-restore-options.js";

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

@@ -6,16 +6,18 @@ import type { LoadedUiProject } from "../models/project-models.js";
 export interface IProjectLoader {
     /**
      * Load project information from a directory path.
-     * Searches for project.uiproj first, falls back to webAppManifest.json.
+     * Searches for project.uiproj first, then project.json, then falls back to
+     * webAppManifest.json.
      * @param projectPath Path to the project directory
      * @returns Loaded project information
-     * @throws Error if neither project.uiproj nor webAppManifest.json is found
+     * @throws Error if none of project.uiproj, project.json, or webAppManifest.json is found
      */
     loadProject(projectPath: string): Promise<LoadedUiProject>;
 }
 export declare class ProjectLoader implements IProjectLoader {
     private readonly fileSystem;
     static readonly WebAppManifestFileName = "webAppManifest.json";
+    static readonly ProjectJsonFileName = "project.json";
     constructor(fileSystem: IFileSystem);
     loadProject(projectPath: string): Promise<LoadedUiProject>;
     private loadFromProjectFile;

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

@@ -1,6 +1,7 @@
 import type { ITelemetryService } from "@uipath/common";
 import { type IFileSystem, ToolResult } from "@uipath/solutionpackager-tool-core";
 import type { ProjectBuildOptions } from "../models/project-build-options.js";
+import type { ProjectCleanupOptions } from "../models/project-cleanup-options.js";
 import type { ProjectPackOptions } from "../models/project-pack-options.js";
 import type { ProjectRestoreOptions } from "../models/project-restore-options.js";
 import type { ProjectValidateOptions } from "../models/project-validate-options.js";
@@ -58,6 +59,15 @@ export interface IProjectPackager {
      * @returns ToolResult with the paths to the created packages
      */
     packProjectAsync(options: ProjectPackOptions, cancellationToken?: AbortSignal): Promise<ToolResult>;
+    /**
+     * Clean up a standalone project by removing unused items. Modifies the
+     * project sources in place. Pass `dryRun` to only detect what would be
+     * removed without writing any changes.
+     * @param options Project cleanup options containing the input path and flags
+     * @param cancellationToken Optional cancellation token
+     * @returns ToolResult; `details.projectCleanup` carries the ProjectCleanupInfo
+     */
+    cleanupProjectAsync(options: ProjectCleanupOptions, cancellationToken?: AbortSignal): Promise<ToolResult>;
     /**
      * Convert a successful ToolResult to a list of package streams.
      * @param result The ToolResult to convert
@@ -110,6 +120,10 @@ export declare class ProjectPackager implements IProjectPackager {
      * @returns ToolResult with the paths to the created packages
      */
     packProjectAsync(options: ProjectPackOptions, cancellationToken?: AbortSignal): Promise<ToolResult>;
+    /**
+     * Clean up a standalone project by removing unused items.
+     */
+    cleanupProjectAsync(options: ProjectCleanupOptions, cancellationToken?: AbortSignal): Promise<ToolResult>;
     /**
      * Convert a successful ToolResult to a list of package streams.
      * @param result The ToolResult to convert

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

@@ -1,5 +1,5 @@
 import type { ITelemetryService } from "@uipath/common";
-import { type IProjectBuildOptions, type IProjectPackOptions, type IProjectRestoreOptions, type IProjectValidateOptions, type ProjectOperationContext, ToolResult } from "@uipath/solutionpackager-tool-core";
+import { type IProjectBuildOptions, type IProjectCleanupOptions, type IProjectPackOptions, type IProjectRestoreOptions, type IProjectValidateOptions, type ProjectOperationContext, ToolResult } from "@uipath/solutionpackager-tool-core";
 import type { UiPathProject } from "../models/project-models.js";
 import type { IToolsFactory } from "./tools-factory.js";
 /**
@@ -10,6 +10,7 @@ export interface IProjectToolExecutor {
     validateAsync(options: IProjectValidateOptions, project: UiPathProject, context?: ProjectOperationContext, cancellationToken?: AbortSignal): Promise<ToolResult>;
     buildAsync(options: IProjectBuildOptions, project: UiPathProject, context?: ProjectOperationContext, cancellationToken?: AbortSignal): Promise<ToolResult>;
     packAsync(options: IProjectPackOptions, project: UiPathProject, context?: ProjectOperationContext, cancellationToken?: AbortSignal): Promise<ToolResult>;
+    cleanupAsync(options: IProjectCleanupOptions, project: UiPathProject, context?: ProjectOperationContext, cancellationToken?: AbortSignal): Promise<ToolResult>;
 }
 export declare class ProjectToolExecutor implements IProjectToolExecutor {
     private readonly toolsFactory;
@@ -19,6 +20,7 @@ export declare class ProjectToolExecutor implements IProjectToolExecutor {
     validateAsync(options: IProjectValidateOptions, project: UiPathProject, context?: ProjectOperationContext, cancellationToken?: AbortSignal): Promise<ToolResult>;
     buildAsync(options: IProjectBuildOptions, project: UiPathProject, context?: ProjectOperationContext, cancellationToken?: AbortSignal): Promise<ToolResult>;
     packAsync(options: IProjectPackOptions, project: UiPathProject, context?: ProjectOperationContext, cancellationToken?: AbortSignal): Promise<ToolResult>;
+    cleanupAsync(options: IProjectCleanupOptions, project: UiPathProject, context?: ProjectOperationContext, cancellationToken?: AbortSignal): Promise<ToolResult>;
     /**
      * Execute an operation on a project tool with proper creation and disposal.
      */

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

@@ -3,9 +3,11 @@ export declare enum TelemetryNames {
     ProjectToolRestore = "ProjectPackager.Tool.Restore",
     ProjectToolValidate = "ProjectPackager.Tool.Validate",
     ProjectToolBuild = "ProjectPackager.Tool.Build",
+    ProjectToolCleanup = "ProjectPackager.Tool.Cleanup",
     ProjectPackagerPack = "ProjectPackager.Pack",
     ProjectPackagerRestore = "ProjectPackager.Restore",
     ProjectPackagerValidate = "ProjectPackager.Validate",
     ProjectPackagerBuild = "ProjectPackager.Build",
+    ProjectPackagerCleanup = "ProjectPackager.Cleanup",
     ProjectPackagerProjectLoaded = "ProjectPackager.ProjectLoaded"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@uipath/project-packager",
   "license": "MIT",
-  "version": "1.197.0",
+  "version": "1.198.0-preview.101",
   "description": "UiPath Project Packager - core library for packing individual UiPath projects",
   "type": "module",
   "main": "./dist/index.js",
@@ -32,12 +32,12 @@
     "dist"
   ],
   "dependencies": {
-    "@uipath/filesystem": "1.197.0",
-    "@uipath/solutionpackager-tool-core": "1.197.0",
-    "@uipath/common": "1.197.0"
+    "@uipath/filesystem": "1.198.0",
+    "@uipath/solutionpackager-tool-core": "1.198.0",
+    "@uipath/common": "1.198.0"
   },
   "peerDependencies": {
     "fflate": "^0.8.2"
   },
-  "gitHead": "56f68b263cec4ea1f2a39d738bd99ecf52f88fea"
+  "gitHead": "07ef94915524cc0105bfe5cbee232efbb7f8f92c"
 }