@uipath/solution-packager 0.0.34 → 1.197.0-preview.64

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

@@ -1,4 +1,4 @@
-import type { IProjectToolExecutor, ITelemetryService, IToolsFactory } from "@uipath/project-packager";
+import { type IPackageSignService, type IProjectToolExecutor, type ITelemetryService, type IToolsFactory } from "@uipath/project-packager";
 import { type IFileSystem, type IZipService, 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";
@@ -19,7 +19,8 @@ export declare class SolutionPackService implements ISolutionPackService {
     private readonly zipService;
     private readonly fileSystem;
     private readonly telemetry;
-    constructor(optionsBuilder: IOptionsBuilder, toolsFactory: IToolsFactory, projectExecutor: IProjectToolExecutor, zipService: IZipService, fileSystem: IFileSystem, telemetry: ITelemetryService);
+    private readonly packageSignService?;
+    constructor(optionsBuilder: IOptionsBuilder, toolsFactory: IToolsFactory, projectExecutor: IProjectToolExecutor, zipService: IZipService, fileSystem: IFileSystem, telemetry: ITelemetryService, packageSignService?: IPackageSignService | undefined);
     packAsync(parameters: SolutionPackOptions, solution: LoadedUiPathSolution, context: ProjectOperationContext, cancellationToken?: AbortSignal): Promise<ToolResult>;
     /**
      * Pack all projects in parallel
@@ -39,17 +40,21 @@ export declare class SolutionPackService implements ISolutionPackService {
      */
     private packSingleProjectAsync;
     /**
-     * Check if any results in the array have failed
-     * @param results Array of tool results
-     * @returns True if any result has failed, false otherwise
+     * Sign the project .nupkg(s) produced for the solution, before zipping.
+     *
+     * Project tools write their package into the solution output tree; the
+     * workflow compiler reports a content *folder* rather than the .nupkg, so
+     * each produced path is resolved to the real .nupkg first. Unlike the
+     * single-project packager there's no copy/pack-from-content step here, so a
+     * path that resolves to nothing means the package is genuinely missing —
+     * fail loudly rather than zip an unsigned (or absent) package.
+     *
+     * A no-op when signing isn't requested (no signing info or no certificate).
+     * @param projectResults The per-project pack results, holding produced paths
+     * @param signingInfo Signing configuration, if signing was requested
+     * @returns Success, or the first signing/resolution failure
      */
-    private hasFailedResults;
-    /**
-     * Get a combined error message from all failed results
-     * @param results Array of tool results
-     * @returns Combined error message
-     */
-    private getFailedResultsMessage;
+    private signProjectPackagesAsync;
     /**
      * Compress the solution output folder into a zip archive
      * @param parameters Solution pack parameters
@@ -57,4 +62,11 @@ export declare class SolutionPackService implements ISolutionPackService {
      * @returns Path to the created archive file
      */
     private compressSolutionAsync;
+    /**
+     * Write a `package.metadata.json` file into the solution output folder
+     * (it lands at the root of the produced .zip). Only fields the caller
+     * actually supplied are emitted, so a metadata-free pack still gets a
+     * minimal file carrying the package name and version.
+     */
+    private writePackageMetadataAsync;
 }

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

@@ -10,12 +10,6 @@ export interface ISolutionPackager {
      * File system instance
      */
     readonly fileSystem: IFileSystem;
-    /**
-     * Check if the solution can be packed by verifying all project types have registered tools.
-     * @param solutionPath Path to the solution folder
-     * @returns True if all project types in the solution have registered tool factories
-     */
-    canPackSolutionAsync(solutionPath: string): Promise<boolean>;
     /**
      * Setup the temporary storage.
      * @param input The solution folder as a zip Uint8Array (extracts to temp folder) or a path string (uses as-is)
@@ -45,6 +39,15 @@ export interface ISolutionPackager {
      * @returns ToolResult indicating success if every project passed validation
      */
     validateSolutionAsync(options: SolutionPackOptions, cancellationToken?: AbortSignal): Promise<ToolResult>;
+    /**
+     * Restore dependencies for every project in a solution, without packing
+     * or building. Resolves NuGet dependencies (including authenticated feeds
+     * carried by `options.connection`) so a later pack can compile offline.
+     * @param options Solution pack options containing all parameters
+     * @param cancellationToken Optional cancellation token
+     * @returns ToolResult indicating success if every project restored
+     */
+    restoreSolutionAsync(options: SolutionPackOptions, cancellationToken?: AbortSignal): Promise<ToolResult>;
     /**
      * Convert a successful ToolResult to a list of package streams.
      * @param result The ToolResult to convert
@@ -66,17 +69,12 @@ export declare class SolutionPackager implements ISolutionPackager {
     private readonly projectExecutor;
     private readonly solutionLoader;
     private readonly solutionPackService;
+    private readonly solutionRestoreService;
     private readonly solutionValidateService;
     private readonly packOptionsValidator;
     private readonly validateOptionsValidator;
     private readonly governancePolicyService;
     constructor(fileSystem: IFileSystem, telemetryService: ITelemetryService, packageSignService?: IPackageSignService | undefined);
-    /**
-     * Check if the solution can be packed by verifying all project types have registered tools.
-     * @param solutionPath Path to the solution folder
-     * @returns True if all project types in the solution have registered tool factories
-     */
-    canPackSolutionAsync(solutionPath: string): Promise<boolean>;
     /**
      * Setup the temporary storage.
      * @param input The solution folder as a zip Uint8Array (extracts to temp folder) or a path string (uses as-is)
@@ -103,6 +101,11 @@ export declare class SolutionPackager implements ISolutionPackager {
      * Validate all projects in a solution using the provided options.
      */
     validateSolutionAsync(options: SolutionPackOptions, cancellationToken?: AbortSignal): Promise<ToolResult>;
+    /**
+     * Restore dependencies for every project in a solution, without packing
+     * or building.
+     */
+    restoreSolutionAsync(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

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

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

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

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

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

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

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

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

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

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

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

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

package/package.json

@@ -1,77 +1,38 @@
 {
-    "name": "@uipath/solution-packager",
-    "version": "0.0.34",
-    "description": "UiPath Solution Packager - core library for packing UiPath solutions",
-    "type": "module",
-    "main": "./dist/index.js",
-    "exports": {
-        ".": {
-            "types": "./dist/src/index.d.ts",
-            "default": "./dist/index.js"
-        },
-        "./node": {
-            "types": "./dist/src/node.d.ts",
-            "default": "./dist/node.js"
-        }
+  "name": "@uipath/solution-packager",
+  "license": "MIT",
+  "version": "1.197.0-preview.64",
+  "description": "UiPath Solution Packager - core library for packing UiPath solutions",
+  "type": "module",
+  "main": "./dist/index.js",
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "default": "./dist/index.js"
     },
-    "types": "./dist/src/index.d.ts",
-    "repository": {
-        "type": "git",
-        "url": "https://github.com/UiPath/cli.git",
-        "directory": "packages/packager/solution-packager"
-    },
-    "publishConfig": {
-        "registry": "https://registry.npmjs.org/"
-    },
-    "files": [
-        "dist",
-        "!dist/**/*.map"
-    ],
-    "scripts": {
-        "build": "bun build ./src/index.ts --outdir dist --format esm --target browser --external @uipath/solutionpackager-tool-core --external '@uipath/project-packager/*' --external @uipath/project-packager --external '@uipath/filesystem/*' --external @uipath/filesystem --external '@uipath/common/*' --external @uipath/common && bun build ./src/node.ts --outdir dist --format esm --target node --external @uipath/solutionpackager-tool-core --external '@uipath/project-packager/*' --external @uipath/project-packager --external '@uipath/common/*' --external @uipath/common --external '@uipath/filesystem/*' --external @uipath/filesystem && tsc --emitDeclarationOnly --outDir dist",
-        "clean": "rimraf dist",
-        "test": "vitest run",
-        "e2e": "vitest run --config vitest.e2e.config.ts",
-        "test:browser": "vitest run --config=vitest.browser.config.ts",
-        "test:coverage": "vitest run --coverage",
-        "test:browser:coverage": "vitest run --config=vitest.browser.config.ts --coverage",
-        "test:all": "bun run test && bun run test:browser",
-        "test:all:coverage": "bun run test:coverage && bun run test:browser:coverage",
-        "prepack": "bun run build",
-        "publish:dry": "bun publish --dry-run",
-        "publish:gh": "bun publish",
-        "version:patch": "bun version patch --no-git-tag-version",
-        "version:minor": "bun version minor --no-git-tag-version",
-        "version:major": "bun version major --no-git-tag-version",
-        "lint": "biome check ."
-    },
-    "dependencies": {
-        "@uipath/project-packager": "1.1.15",
-        "@uipath/common": "0.9.0",
-        "@uipath/filesystem": "0.9.0",
-        "@uipath/solutionpackager-tool-core": "0.0.33"
-    },
-    "peerDependencies": {
-        "fflate": "^0.8.2"
-    },
-    "devDependencies": {
-        "@types/node": "^25.5.0",
-        "@uipath/resource-builder-tool": "^2025.11.0-alpha2430-2948",
-        "@uipath/tool-agent": "^1.0.1",
-        "@uipath/packager-tool-apiworkflow": "0.0.18",
-        "@uipath/packager-tool-bpmn": "0.0.8",
-        "@uipath/packager-tool-case": "0.0.8",
-        "@uipath/packager-tool-connector": "0.0.18",
-        "@uipath/packager-tool-flow": "0.0.18",
-        "@uipath/packager-tool-webapp": "1.0.5",
-        "@uipath/packager-tool-workflowcompiler": "0.0.15",
-        "@vitest/browser": "^4.0.14",
-        "@vitest/browser-playwright": "^4.0.14",
-        "@vitest/coverage-v8": "^4.0.14",
-        "playwright": "^1.57.0",
-        "typescript": "^5.9.3",
-        "vite-tsconfig-paths": "^6.1.1",
-        "vitest": "^4.0.14"
-    },
-    "gitHead": "3f1b4d8e9f910be81e4cab956537f21dbd5d63ac"
+    "./node": {
+      "types": "./dist/src/node.d.ts",
+      "default": "./dist/node.js"
+    }
+  },
+  "types": "./dist/src/index.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/UiPath/cli.git",
+    "directory": "packages/packager/solution-packager"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@uipath/project-packager": "1.197.0",
+    "@uipath/solutionpackager-tool-core": "1.197.0"
+  },
+  "peerDependencies": {
+    "fflate": "^0.8.2"
+  },
+  "gitHead": "3977b977945bf519336258da69fd271433eaaef4"
 }

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

@@ -1,9 +0,0 @@
-import "@uipath/packager-tool-connector";
-import "@uipath/packager-tool-workflowcompiler";
-import "@uipath/packager-tool-apiworkflow";
-import "@uipath/packager-tool-bpmn";
-import "@uipath/packager-tool-case";
-import "@uipath/packager-tool-flow";
-import "@uipath/tool-agent";
-import "@uipath/packager-tool-webapp";
-import "@uipath/resource-builder-tool";