@uipath/project-packager 1.1.10 → 1.196.0

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,5 +1,6 @@
 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.
  */
@@ -15,8 +16,8 @@ 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;
 }

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

@@ -0,0 +1,24 @@
+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 parallel and returns the first
+ *   failure, or success if all signed.
+ *
+ * @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,5 +1,5 @@
+import type { ITelemetryService } from "@uipath/common/telemetry";
 import { type IFileSystem, ToolResult } from "@uipath/solutionpackager-tool-core";
-import type { ITelemetryService } from "@uipath/telemetry";
 import type { ProjectBuildOptions } from "../models/project-build-options.js";
 import type { ProjectPackOptions } from "../models/project-pack-options.js";
 import type { ProjectRestoreOptions } from "../models/project-restore-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)
@@ -134,6 +122,24 @@ export declare class ProjectPackager implements IProjectPackager {
      * validates options, loads the project, executes the operation, and handles errors.
      */
     private executeProjectOperationAsync;
+    /**
+     * Build a single-project ProjectOperationContext so tools that coordinate
+     * a remote-agent run (e.g. workflow-compiler-browser) receive the same
+     * 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

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

@@ -1,5 +1,5 @@
+import type { ITelemetryService } from "@uipath/common/telemetry";
 import { type IProjectBuildOptions, type IProjectPackOptions, type IProjectRestoreOptions, type IProjectValidateOptions, type ProjectOperationContext, ToolResult } from "@uipath/solutionpackager-tool-core";
-import type { ITelemetryService } from "@uipath/telemetry";
 import type { PackageSigningInfo } from "../models/packager-parameters.js";
 import type { UiPathProject } from "../models/project-models.js";
 import type { IPackageSignService } from "./package-sign-service.js";

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

@@ -3,5 +3,6 @@ import "@uipath/packager-tool-workflowcompiler";
 import "@uipath/packager-tool-apiworkflow";
 import "@uipath/packager-tool-flow";
 import "@uipath/tool-agent";
+import "@uipath/packager-tool-functions";
 import "@uipath/packager-tool-webapp";
 import "@uipath/resource-builder-tool";

package/dist/tests/project-packager.spec.d.ts

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

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

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

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,6 +1,7 @@
 {
     "name": "@uipath/project-packager",
-    "version": "1.1.10",
+    "license": "MIT",
+    "version": "1.196.0",
     "description": "UiPath Project Packager - core library for packing individual UiPath projects",
     "type": "module",
     "main": "./dist/index.js",
@@ -12,6 +13,10 @@
         "./node": {
             "types": "./dist/src/node.d.ts",
             "default": "./dist/node.js"
+        },
+        "./browser": {
+            "types": "./dist/src/browser.d.ts",
+            "default": "./dist/browser.js"
         }
     },
     "types": "./dist/src/index.d.ts",
@@ -27,41 +32,29 @@
         "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/telemetry/*' --external @uipath/telemetry --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.1.7",
-        "@uipath/solutionpackager-tool-core": "0.0.31",
-        "@uipath/telemetry": "0.0.6"
+        "@uipath/filesystem": "1.196.0",
+        "@uipath/solutionpackager-tool-core": "1.196.0",
+        "@uipath/common": "1.196.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.17",
-        "@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",
-        "@vitest/coverage-v8": "^4.0.14",
+        "@types/node": "^25.5.2",
+        "@uipath/resource-builder-tool": "2025.11.0-alpha2928-3101",
+        "@uipath/tool-agent": "^1.2.6",
+        "@uipath/packager-tool-apiworkflow": "1.196.0",
+        "@uipath/packager-tool-connector": "1.196.0",
+        "@uipath/packager-tool-flow": "1.196.0",
+        "@uipath/packager-tool-functions": "1.196.0",
+        "@uipath/packager-tool-webapp": "1.196.0",
+        "@uipath/packager-tool-workflowcompiler": "1.196.0",
+        "@vitest/coverage-v8": "^4.1.6",
         "jsdom": "^29.0.0",
-        "typescript": "^5.9.3",
+        "typescript": "^6.0.2",
         "vite-tsconfig-paths": "^6.1.1",
-        "vitest": "^4.0.14"
-    }
+        "vitest": "^4.1.6"
+    },
+    "gitHead": "bed2b46f1ec33a47a7dcae2e6d4b7ab99bd06981"
 }