@uipath/project-packager 1.1.15 → 1.197.0-preview.64

package/dist/src/publish/services/orchestrator-publisher.d.ts

@@ -0,0 +1,78 @@
+import type { IFileSystem } from "@uipath/solutionpackager-tool-core";
+import { ToolResult } from "@uipath/solutionpackager-tool-core";
+import { type OrchestratorDestination } from "../models/publish-options.js";
+import { type IOrchestratorFeedsService } from "./orchestrator-feeds-service.js";
+export declare const ORCHESTRATOR_RELATIVE_URL = "/orchestrator_";
+export declare const PROCESSES_UPLOAD_PATH = "/odata/Processes/UiPath.Server.Configuration.OData.UploadPackage";
+export declare const LIBRARIES_UPLOAD_PATH = "/odata/Libraries/UiPath.Server.Configuration.OData.UploadPackage";
+/**
+ * Publishes .nupkg files to UiPath Orchestrator.
+ *
+ * For the PersonalWorkspace, TenantProcesses, and SharedLibraries kinds
+ * the publisher resolves the matching feed via
+ * `/api/PackageFeeds/GetFeeds`. Files are POSTed as
+ * `multipart/form-data` under the `file` field; the upload path
+ * (`Processes` vs `Libraries`) and `?feedId=` come from the resolved
+ * feed. The folder header (`X-UIPATH-OrganizationUnitId`) comes from
+ * the resolved feed for PersonalWorkspace and from the caller-supplied
+ * `folderId` for SharedLibraries.
+ *
+ * For the `OrchestratorCustom` kind the caller supplies the full upload
+ * URL — no feed resolution is performed and the URL is POSTed to
+ * verbatim. `connectionInfo` still drives the auth headers and the
+ * caller-supplied `folderId` (if any) is sent as
+ * `X-UIPATH-OrganizationUnitId`.
+ */
+export interface IOrchestratorPublisher {
+    publishAsync(packagePaths: string[], destination: OrchestratorDestination): Promise<ToolResult>;
+}
+export declare class OrchestratorPublisher implements IOrchestratorPublisher {
+    private readonly fileSystem;
+    private readonly logger;
+    private readonly feedsService;
+    constructor(fileSystem: IFileSystem, feedsService?: IOrchestratorFeedsService);
+    publishAsync(packagePaths: string[], destination: OrchestratorDestination): Promise<ToolResult>;
+    private postPackages;
+    /**
+     * Resolve the target feed for the destination kind.
+     *
+     * - Tenant Processes / Shared Libraries: tenant-scoped feed —
+     *   pick the feed with the matching `purpose` and no `folderId`.
+     * - Personal Workspace: every folder feed comes back with
+     *   `purpose: "Processes"`, so we can't tell PW from a regular
+     *   folder feed by the feeds list alone. Studio resolves this via
+     *   `/api/FoldersNavigation/GetAllFoldersForCurrentUser`, where the
+     *   PW folder has `feedType: "PersonalWorkspace"`. We do the same:
+     *   look up that folder, then match the feed by `folderId`.
+     */
+    private resolveFeed;
+    private throwFeedNotFound;
+    /**
+     * Pick the publish URL for a resolved feed.
+     *
+     * The orchestrator's feed response carries a `publishUrl` — for OData
+     * feeds it points at the same `UploadPackage` endpoint we'd construct
+     * ourselves, for ApiKey-authed feeds it points at the NuGet v3 push
+     * endpoint that bypasses `CanPublishLibrariesAsync`. Prefer it when
+     * set; fall back to the constructed OData URL otherwise. `feedId` is
+     * always pinned via the query string (matches Studio Web's
+     * `PublishApiService.publishProjectFromSolution`).
+     *
+     * URLs are kept absolute so `fetch` works in Node — relative URLs
+     * throw `TypeError: Failed to parse URL` outside a browser. Same-origin
+     * absolute URLs are fine in browser callers (no CORS preflight).
+     */
+    private buildPublishUrl;
+    /**
+     * Derive the orchestrator base URL from `connectionInfo.cloudUrl`.
+     *
+     * Keeps the URL absolute — Node's `fetch` rejects relative URLs with
+     * `TypeError: Failed to parse URL`, and absolute same-origin URLs
+     * still work fine in browser callers (no CORS preflight added).
+     */
+    private deriveOrchestratorUrl;
+    private buildHeaders;
+    private buildCustomHeaders;
+    private buildAuthHeaders;
+    private safeReadBody;
+}

package/dist/src/publish/services/project-publisher.d.ts

@@ -0,0 +1,29 @@
+import type { IFileSystem } from "@uipath/solutionpackager-tool-core";
+import { ToolResult } from "@uipath/solutionpackager-tool-core";
+import { type ProjectPublishOptions } from "../models/publish-options.js";
+import { type ILocalFolderPublisher } from "./local-folder-publisher.js";
+import { type INugetFeedPublisher } from "./nuget-feed-publisher.js";
+import { type IOrchestratorPublisher } from "./orchestrator-publisher.js";
+/**
+ * Public API of the ProjectPublisher component.
+ */
+export interface IProjectPublisher {
+    /**
+     * Publish one or more .nupkg files to the destination configured in
+     * `options.destination`.
+     */
+    publishAsync(options: ProjectPublishOptions): Promise<ToolResult>;
+}
+export declare class ProjectPublisher implements IProjectPublisher {
+    private readonly fileSystem;
+    private readonly logger;
+    private readonly localFolderPublisher;
+    private readonly nugetFeedPublisher;
+    private readonly orchestratorPublisher;
+    constructor(fileSystem: IFileSystem, publishers?: {
+        localFolder?: ILocalFolderPublisher;
+        nugetFeed?: INugetFeedPublisher;
+        orchestrator?: IOrchestratorPublisher;
+    });
+    publishAsync(options: ProjectPublishOptions): Promise<ToolResult>;
+}

package/dist/src/services/dotnet-discovery-service.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Service for discovering the installed `dotnet` CLI on the host.
+ */
+export interface IDotnetDiscoveryService {
+    /** True when `dotnet --version` succeeds on the host. */
+    isDotnetAvailable(): boolean;
+    /** Trimmed `dotnet --version` output, or undefined if dotnet is not on PATH. */
+    getDotnetVersion(): string | undefined;
+}
+export declare class DotnetDiscoveryService implements IDotnetDiscoveryService {
+    /**
+     * Per-instance cache of a successful `dotnet --version` lookup. Negative
+     * results are not cached so a one-off failure does not pin the service.
+     */
+    private cachedVersion;
+    isDotnetAvailable(): boolean;
+    getDotnetVersion(): string | undefined;
+}

package/dist/src/services/nupkg-resolver.d.ts

@@ -0,0 +1,20 @@
+import type { IFileSystem } from "@uipath/solutionpackager-tool-core";
+/**
+ * Resolve a package path produced by a project tool to the actual `.nupkg`
+ * file(s) it represents.
+ *
+ * Most tools return a `.nupkg` path directly, but the workflow compiler (both
+ * the in-repo tool and the bundled copy shipped inside `@uipath/rpa-tool`)
+ * reports the package *content folder* instead — the produced `.nupkg` sits
+ * inside that folder or beside it in the build output dir. The copy path uses
+ * this to turn that folder into the real `.nupkg` before copying it to the
+ * destination (where signing later runs on the finalized file).
+ *
+ * Resolution:
+ * - a path already ending in `.nupkg` is returned as-is;
+ * - a directory is searched for `.nupkg` files, first inside it, then in its
+ *   parent (the build output dir);
+ * - anything else (including a directory with no `.nupkg` anywhere) yields an
+ *   empty array, leaving the caller to decide how to handle a missing package.
+ */
+export declare function resolveProducedNupkgsAsync(fileSystem: IFileSystem, packagePath: string): Promise<string[]>;

package/dist/src/services/package-sign-service.d.ts

@@ -1,9 +1,19 @@
 import type { IToolLogger } from "@uipath/solutionpackager-tool-core";
 import { ToolResult } from "@uipath/solutionpackager-tool-core";
+import type { IDotnetDiscoveryService } from "./dotnet-discovery-service.js";
 /**
  * Provides package signing operations with availability checks.
  */
 export interface IPackageSignService {
+    /**
+     * Sign NuGet packages using one dotnet nuget sign invocation.
+     * @param packagePaths - Paths to the .nupkg files to sign
+     * @param certificatePath - Path to the PFX certificate file
+     * @param certificatePassword - Optional password for the certificate
+     * @param timestampServer - Optional RFC 3161 timestamp server URL
+     * @returns ToolResult indicating success or failure
+     */
+    signPackagesAsync?(packagePaths: string[], certificatePath: string, certificatePassword?: string, timestampServer?: string): Promise<ToolResult>;
     /**
      * Sign a NuGet package using dotnet nuget sign.
      * @param packagePath - Path to the .nupkg file to sign
@@ -15,8 +25,9 @@ export interface IPackageSignService {
     signPackageAsync(packagePath: string, certificatePath: string, certificatePassword?: string, timestampServer?: string): Promise<ToolResult>;
 }
 export declare class NodePackageSignService implements IPackageSignService {
+    private readonly dotnetDiscovery;
     private readonly logger;
-    constructor(logger: IToolLogger);
+    constructor(dotnetDiscovery: IDotnetDiscoveryService, logger: IToolLogger);
     signPackageAsync(packagePath: string, certificatePath: string, certificatePassword?: string, timestampServer?: string): Promise<ToolResult>;
-    private checkAvailable;
+    signPackagesAsync(packagePaths: string[], certificatePath: string, certificatePassword?: string, timestampServer?: string): Promise<ToolResult>;
 }

package/dist/src/services/package-signer.d.ts

@@ -0,0 +1,25 @@
+import { ToolResult } from "@uipath/solutionpackager-tool-core";
+import type { PackageSigningInfo } from "../models/packager-parameters.js";
+import type { IPackageSignService } from "./package-sign-service.js";
+/**
+ * Sign a set of finalized `.nupkg` files.
+ *
+ * This is the one place the signing loop lives, shared by the project and
+ * solution packagers. It signs files only — callers resolve their own paths to
+ * real `.nupkg`s first (the project packager signs files it already copied to
+ * the destination; the solution packager resolves the workflow-compiler content
+ * folders via `resolveProducedNupkgsAsync` before calling here).
+ *
+ * - A no-op returning success when signing isn't requested (no signing info or
+ *   no certificate path).
+ * - An error when signing is requested but no sign service is wired (the host
+ *   couldn't provide one, e.g. dotnet CLI missing).
+ * - Otherwise signs each distinct path in one `dotnet nuget sign` invocation
+ *   when the sign service supports batching. This avoids concurrent dotnet
+ *   sign processes loading the same PFX.
+ *
+ * @param signService The sign service, or undefined if none is available.
+ * @param nupkgPaths Finalized `.nupkg` file paths to sign.
+ * @param signingInfo Signing configuration, if signing was requested.
+ */
+export declare function signNupkgsAsync(signService: IPackageSignService | undefined, nupkgPaths: string[], signingInfo?: PackageSigningInfo): Promise<ToolResult>;

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

@@ -15,7 +15,6 @@ export interface IProjectLoader {
 }
 export declare class ProjectLoader implements IProjectLoader {
     private readonly fileSystem;
-    static readonly ProjectFileName = "project.uiproj";
     static readonly WebAppManifestFileName = "webAppManifest.json";
     constructor(fileSystem: IFileSystem);
     loadProject(projectPath: string): Promise<LoadedUiProject>;

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

@@ -1,4 +1,4 @@
-import type { ITelemetryService } from "@uipath/common/telemetry";
+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 { ProjectPackOptions } from "../models/project-pack-options.js";
@@ -23,12 +23,6 @@ export interface IProjectPackager {
      * File system instance
      */
     readonly fileSystem: IFileSystem;
-    /**
-     * Check if the project can be packed by verifying the project type has a registered tool.
-     * @param projectPath Path to the project folder
-     * @returns True if the project type has a registered tool factory
-     */
-    canPackProjectAsync(projectPath: string): Promise<boolean>;
     /**
      * Setup the temporary storage.
      * @param input The project folder as a zip Uint8Array (extracts to temp folder) or a path string (uses as-is)
@@ -90,12 +84,6 @@ export declare class ProjectPackager implements IProjectPackager {
     private readonly nugetPackager;
     private readonly governancePolicyService;
     constructor(fileSystem: IFileSystem, telemetryService: ITelemetryService, packageSignService?: IPackageSignService | undefined);
-    /**
-     * Check if the project can be packed by verifying the project type has a registered tool.
-     * @param projectPath Path to the project folder
-     * @returns True if the project type has a registered tool factory
-     */
-    canPackProjectAsync(projectPath: string): Promise<boolean>;
     /**
      * Setup the temporary storage.
      * @param input The project folder as a zip Uint8Array (extracts to temp folder) or a path string (uses as-is)
@@ -140,25 +128,20 @@ export declare class ProjectPackager implements IProjectPackager {
      * shape they get from SolutionPackager — just with one project.
      */
     private createOperationContext;
-    /**
-     * Find .nupkg files produced by the tool in the parent directory.
-     * Tools like WorkflowCompiler create the .nupkg in the output root
-     * while reporting the content subdirectory in OutputPackages[].Path.
-     * Only returns .nupkg files whose name starts with the subdirectory
-     * name (the package id) to avoid picking up unrelated packages.
-     */
-    private findNupkgInParentDir;
     /**
      * Copy a single file to the destination, throwing if the read fails.
      */
     private copyFileToDestination;
     /**
-     * Copy packages from the output path to the destination path.
-     * Handles file paths, directories with .nupkg files, and directories with
-     * unpacked NuGet content (e.g., content/, lib/ folders from WorkflowCompiler).
-     * @param packagePaths Paths to the package files or directories
+     * Copy produced packages to the destination path.
+     *
+     * Most tools return a .nupkg file path (copied directly), but the workflow
+     * compiler reports the package content *folder*. For a folder, resolve it
+     * to the produced .nupkg(s) via the shared resolver and copy those. If the
+     * folder holds no .nupkg anywhere, pack it from content as a last resort.
+     * @param packagePaths Paths to the produced packages (files or folders)
      * @param destinationPath Destination directory
-     * @param packageInfo NuGet package info for creating .nupkg from unpacked content
+     * @param packageInfo NuGet package info for packing unpacked content
      * @returns Paths to the copied package files
      */
     private copyPackagesToDestination;

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

@@ -1,8 +1,6 @@
-import type { ITelemetryService } from "@uipath/common/telemetry";
+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 { PackageSigningInfo } from "../models/packager-parameters.js";
 import type { UiPathProject } from "../models/project-models.js";
-import type { IPackageSignService } from "./package-sign-service.js";
 import type { IToolsFactory } from "./tools-factory.js";
 /**
  * Interface for executing project tool operations
@@ -11,26 +9,18 @@ export interface IProjectToolExecutor {
     restoreAsync(options: IProjectRestoreOptions, project: UiPathProject, context?: ProjectOperationContext, cancellationToken?: AbortSignal): Promise<ToolResult>;
     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, signingInfo?: PackageSigningInfo, cancellationToken?: AbortSignal): Promise<ToolResult>;
+    packAsync(options: IProjectPackOptions, project: UiPathProject, context?: ProjectOperationContext, cancellationToken?: AbortSignal): Promise<ToolResult>;
 }
 export declare class ProjectToolExecutor implements IProjectToolExecutor {
     private readonly toolsFactory;
     private readonly telemetry;
-    private readonly packageSignService?;
-    constructor(toolsFactory: IToolsFactory, telemetry: ITelemetryService, packageSignService?: IPackageSignService | undefined);
+    constructor(toolsFactory: IToolsFactory, telemetry: ITelemetryService);
     restoreAsync(options: IProjectRestoreOptions, project: UiPathProject, context?: ProjectOperationContext, cancellationToken?: AbortSignal): Promise<ToolResult>;
     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, signingInfo?: PackageSigningInfo, cancellationToken?: AbortSignal): Promise<ToolResult>;
+    packAsync(options: IProjectPackOptions, project: UiPathProject, context?: ProjectOperationContext, cancellationToken?: AbortSignal): Promise<ToolResult>;
     /**
      * Execute an operation on a project tool with proper creation and disposal.
      */
     private executeToolOperationAsync;
-    /**
-     * Sign all packages using the package sign service.
-     * @param packages - Array of package paths to sign
-     * @param signingInfo - Signing configuration
-     * @returns ToolResult indicating success or failure
-     */
-    private signPackagesAsync;
 }

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

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

package/dist/tests/project-tool-executor.spec.d.ts

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

package/dist/tests/publish/local-folder-publisher.spec.d.ts

@@ -0,0 +1 @@
+import "../../src/i18n/index.js";

package/dist/tests/publish/node-project-publisher-factory.spec.d.ts

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

package/dist/tests/publish/nuget-feed-publisher.spec.d.ts

@@ -0,0 +1 @@
+import "../../src/i18n/index.js";

package/dist/tests/publish/orchestrator-feeds-service.spec.d.ts

@@ -0,0 +1 @@
+import "../../src/i18n/index.js";

package/dist/tests/publish/orchestrator-publisher.spec.d.ts

@@ -0,0 +1 @@
+import "../../src/i18n/index.js";

package/dist/tests/publish/project-publisher.spec.d.ts

@@ -0,0 +1 @@
+import "../../src/i18n/index.js";

package/dist/tests/tools-factory-repository.spec.d.ts

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

package/package.json

@@ -1,68 +1,43 @@
 {
-    "name": "@uipath/project-packager",
-    "version": "1.1.15",
-    "description": "UiPath Project Packager - core library for packing individual UiPath projects",
-    "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/project-packager",
+  "license": "MIT",
+  "version": "1.197.0-preview.64",
+  "description": "UiPath Project Packager - core library for packing individual UiPath projects",
+  "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/project-packager"
+    "./node": {
+      "types": "./dist/src/node.d.ts",
+      "default": "./dist/node.js"
     },
-    "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 && bun build ./src/node.ts --outdir dist --format esm --target node --external @uipath/solutionpackager-tool-core --external '@uipath/common/*' --external @uipath/common --external @uipath/filesystem && tsc --emitDeclarationOnly --outDir dist",
-        "clean": "rimraf dist",
-        "test": "vitest run",
-        "e2e": "vitest run --config vitest.e2e.config.ts",
-        "test:coverage": "vitest run --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/filesystem": "0.9.0",
-        "@uipath/solutionpackager-tool-core": "0.0.33",
-        "@uipath/common": "0.9.0"
-    },
-    "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-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/coverage-v8": "^4.0.14",
-        "jsdom": "^29.0.0",
-        "typescript": "^5.9.3",
-        "vite-tsconfig-paths": "^6.1.1",
-        "vitest": "^4.0.14"
-    },
-    "gitHead": "3f1b4d8e9f910be81e4cab956537f21dbd5d63ac"
+    "./browser": {
+      "types": "./dist/src/browser.d.ts",
+      "default": "./dist/browser.js"
+    }
+  },
+  "types": "./dist/src/index.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/UiPath/cli.git",
+    "directory": "packages/packager/project-packager"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@uipath/filesystem": "1.197.0",
+    "@uipath/solutionpackager-tool-core": "1.197.0",
+    "@uipath/common": "1.197.0"
+  },
+  "peerDependencies": {
+    "fflate": "^0.8.2"
+  },
+  "gitHead": "3977b977945bf519336258da69fd271433eaaef4"
 }

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

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